DeepSeek Harness
以插件组合为核心的编码 Agent 运行框架，能力可自由替换与重组
工具介绍
DeepSeek Harness 是一个面向开发者的编码 Agent 运行框架。它的核心思路是「一切皆插件」：模型、工具、技能、会话、沙箱、存储、循环、调度与 UI 等全部 Agent 能力都由插件提供，可以替换和重组；Cordis 内核只负责插件的加载、卸载与依赖管理，不承载具体能力。开发者因此可以在配置层选择、替换或扩展任意能力，而无需改动源码。框架提供标准、PTC（Code）、极简与创造四种运行模式，覆盖从完整编码 Agent 到最小工具环境基准测试的不同需求，并通过仅追加的会话日志与 Trajectory 视图让每一次运行都有迹可循。
核心功能
- 插件化 Agent 架构：模型、工具、技能、会话、沙箱、存储、循环、调度与 UI 等全部能力均以插件形式提供，可自由替换与重组。
- Cordis 内核：仅负责插件的加载、卸载与依赖关系管理，不承载具体 Agent 能力，实现内核与能力分离。
- 配置层自由组合：开发者可在配置层选择、替换或扩展任意 Agent 能力，无需修改 DeepSeek Harness 源码。
- 仅追加会话日志：将模型可见的全部内容写入 append-only 日志，涵盖系统提示词、思维链、工具调用与结果、子 Agent 调度及每一次上下文注入。
- 共享事件流：恢复、分叉、检索与回放共享同一份事件流，便于按来源查看运行记录。
- 四种运行模式：标准模式为功能完整的编码 Agent；PTC 模式通过 Code Mode SDK 用 TypeScript 程序组合多步工具调用；极简模式仅保留持久 bash 与 str_replace_editor 两个工具；创造模式支持运行时检查、内存中试验 Cordis 插件并创作新 preset。
使用方法
- 1安装 Node.js 后，通过 npx 命令 `npx @deepseek-ai/dsh web` 启动 DeepSeek Harness 的 Web UI。
- 2根据任务选择运行模式：完整软件开发使用标准模式，需要以代码编排多步工具调用时使用 PTC 模式，最小工具环境基准测试使用极简模式，创建自定义 Agent preset 使用创造模式。
- 3在标准模式下描述开发任务，由 Agent 调用文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理与工作流等能力推进。
- 4在 Trajectory 视图中按来源查看仅追加会话日志记录的运行过程，包括系统提示词、思维链、工具调用与结果、子 Agent 调度及上下文注入。
- 5基于同一份事件流对运行进行恢复、分叉、检索或回放，检查结果并继续后续操作。
常见问题
DeepSeek Harness 的「一切皆插件」具体指什么？
指模型、工具、技能、会话、沙箱、存储、循环、调度与 UI 等全部 Agent 能力都以插件形式提供，可以自由替换和灵活重组；Cordis 内核只负责插件的加载、卸载与依赖关系，不承载具体 Agent 能力。
DeepSeek Harness 提供哪些运行模式？
共四种：标准模式是功能完整的编码 Agent，支持文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理与工作流；PTC（Code）模式具备标准模式全部能力，并通过 Code Mode SDK 暴露工具，让模型用一个 TypeScript 程序组合多步操作；极简模式仅提供持久 bash 与 str_replace_editor 两个工具；创造模式用于创建自定义 Agent preset，提供运行时检查、插件实验与 preset 创作指导。
如何开始使用 DeepSeek Harness？
安装 Node.js 后，通过 npx 命令 `npx @deepseek-ai/dsh web` 启动 Web UI 即可体验；官网也提供了源码安装方式。
DeepSeek Harness 如何记录和追溯运行过程？
模型看到的一切都会写入仅追加（append-only）的会话日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度以及每一次上下文注入；在 Trajectory 视图中可以按来源查看这些信息，恢复、分叉、检索与回放也共享同一份事件流。
开发者能否在不修改源码的情况下调整 Agent 能力？
可以。开发者无需改动 DeepSeek Harness 源码，即可在配置层选择、替换或扩展任一能力。
