DeepSeek Harness 开发者预览版发布：MIT 开源，把 Agent 运行时做成可插拔底座

2026 年 8 月 13 日，DeepSeek 面向全球开发者开放 Harness 开发者预览版（v0.1），并同步以 MIT 协议公开源代码。项目命令行名称为 dsh，提供命令行与浏览器 Web UI 两种入口。

Harness 的定位是可自由组合的 Agent 运行时底座，而不是面向终端用户的成品 Agent 应用。官方同时明确提示，当前版本仍在快速迭代，后续会出现破坏兼容性的变更，短期更适合用于试验、评估与插件开发。

Harness 最核心的设计原则是“一切皆插件”。框架基于具备时空可组合性的 Cordis 插件元框架构建，Cordis 只负责插件的加载、卸载与依赖管理。

• 模型适配器：按供应商接入 DeepSeek API、其他服务商或自定义 OpenAI 兼容端点。
• 工具注册表：以插件形式登记 shell、文件编辑、网页读取等能力。
• 技能与会话：Skills 和会话日志独立成插件，可以按项目替换。
• 沙箱、存储与调度：执行环境、持久化与 Agent 循环都可插拔。
• UI：命令行和 Web UI 同样作为插件组合进运行时。

框架内部没有需要打补丁的“特权内核”，开发者无需改动源码，只需在配置层挂载或替换插件，就能重组整套运行时。

v0.1 内置四种运行模式，每种默认加载不同的插件集合：

• 标准模式：提供完整工具组合，适合日常 Agent 应用。
• PTC 模式：程序化工具调用，由模型生成一段代码来组合多轮工具调用。
• 极简模式：只保留 shell 与文件编辑两个工具，用于最小环境下的模型基准测试。
• 创造模式：可检查当前运行时、在内存中试验插件，并把新组合沉淀为新模式。

对开发者来说，模式的意义不在于选择越多越好，而在于把“完整应用”“模型测试”“插件实验”放在同一套架构里，减少切换工具链的成本。

可观测性是这次发布的主线之一。模型看到的一切都会写入仅追加（append-only）的会话日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度以及每一次上下文注入。

开发者可以在 Trajectory 视图中按来源查看完整运行轨迹。会话的恢复、分叉、检索与回放共享同一份事件流，方便复现和排查 Agent 的每一步决策。

这套设计对生产级 Agent 很重要：模型输出很难保证一次正确，可回放的轨迹能让团队在调试时直接定位是哪一轮工具调用引入了错误，而不是靠重新跑一遍碰运气。

已安装 Node.js 工具链的开发者，执行下面命令即可启动 Web UI：

npx @deepseek-ai/dsh web

默认访问地址为 http://127.0.0.1:3080，填入 DeepSeek API Key 后即可使用。官方文档同样覆盖其他供应商与自定义 OpenAI 兼容端点。

希望从源码运行的开发者，可以克隆 GitHub 仓库后依次执行 pnpm install、pnpm run build 与 pnpm dsh web。

框架本身完全免费，以 MIT 协议开源，可自由使用、修改与分发。实际运行成本取决于所接入模型服务商的 API 定价，Harness 不包含模型推理能力。

由于模型适配器本身是可替换插件，团队完全可以在开发时使用 DeepSeek API，在成本敏感场景切换到国内云厂商的 OpenAI 兼容端点，同一套 Harness 配置不需要重写。

Harness 与成品编码 Agent 的关键差异在于控制层。成品 Agent 把模型、工具、沙箱和界面固化为产品体验，Harness 则把这一整层交给开发者改造，可控性与可审计性更强。

代价是 Profile、Bundle、patch 等概念会带来一定的上手门槛。如果只是想要一个开箱即用的编程助手，Harness 不是最合适的选择；如果团队需要自建执行环境、审计链路或私有工具权限，这套框架更值得评估。

v0.1 只是起点。官方明确邀请开发者共建 DSH 插件生态，这意味着 DeepSeek 不只提供模型，也在尝试定义 Agent 运行时的组织方式。

对行业来说，模型选择标准正在从“谁跑分高”转向“谁在长任务里更稳定、工具调用更可靠、轨迹更好审计”。Harness 把插件机制与可观测性做成默认能力，正是为了在 Agent 评估维度上提前占位。

接下来值得关注三点：一是 v0.1 之后的兼容性变更节奏，二是第三方 DSH 插件能否快速出现，三是 Harness 与 V4 Pro 的组合在真实 Coding Agent 工作流中的稳定性。

对团队来说，现在最务实的动作是搭一个隔离的沙箱环境，先用极简模式跑模型基准，再用标准模式测试工具调用与轨迹回放，把评估数据沉淀下来，等插件生态成熟后直接复用。