DeepSeek Harness 简介 菜鸟教程
AI 模型已经能独立完成复杂的编码任务。真正的挑战不再是让模型更聪明,而是怎么把它的能力稳定、可靠、可观测地组织成一个真正可用的 Agent。
2026 年 8 月,深度求索开源了 DeepSeek Harness(dsh)——一个一切皆插件的 Agent 框架,给出了这个问题的答案:Agent = Model + Harness。模型是 Agent 的灵魂,而 Harness 给予 Agent 理解环境、使用工具、在真实场景中持续工作的能力。

什么是 DeepSeek Harness?
DeepSeek Harness(dsh)是深度求索(DeepSeek AI)开发的开源 Agent Harness(智能体框架),采用 MIT 许可证,以 TypeScript 编写,于 2026 年 8 月正式开源,目前处于开发者预览阶段(官方提示未来将有破坏兼容性的变更)。
它不优化模型本身,而是优化模型运行的环境。核心哲学八个字:一切皆插件(Everything is a Plugin)。
模型、工具、技能、会话、沙箱、存储、循环(agent loop)、调度、UI 等所有 Agent 能力均由插件提供,通过 Cordis 内核的服务(Service)与事件(Event)彼此协作——开发者无需改动任何源码,就能在配置层选择、替换、扩展任一能力。
底层由开源插件系统 Cordis 驱动,其设计思想对应论文《A Programming Paradigm for Spatiotemporal Composability》。运行时不存在需要打补丁的"特权内核":每一项能力注册都是可逆副作用,插件卸载时自动撤销,因此扩展 dsh 的方式就是"把新插件挂载到其他插件旁边"。
“Everything is a Plugin."(一切皆插件)—— DeepSeek Harness 官方标语
模型是 Agent 的灵魂,Harness 给予 Agent 理解环境、使用工具,并在真实场景中持续工作的能力。—— DeepSeek Harness 官网
为什么需要 Harness?
行业的结论已经越来越一致:**瓶颈不在模型智能,而在基础设施。**OpenAI 团队在 100 万行代码实验中,5 个月产出全部由 Agent 完成、工程师一行代码未写。
LangChain 仅优化外部驾驭环境(文档结构、验证回路、追踪系统),就让编码 Agent 在 Terminal Bench 2.0 的得分从 52.8% 飙升至 66.5%,全球排名从第 30 位跃升至第 5 位——底层模型一个参数都没动。
DeepSeek Harness 正是这一共识的产品化落地:不追求更强的模型,而是把模型运行所需的约束、反馈、工具、记忆、可观测性全部做成可组合的插件基础设施,让每个团队都能按自己的方式驾驭 AI。
AI 工程范式的三次跃迁
要理解 Harness 为何重要,需要先看清楚我们是怎么一步步走到这里的:
| 范式 | 核心问题 | 优化对象 | 交互模式 |
|---|---|---|---|
| 提示词工程 | 怎么把话说清楚 | Prompt 的措辞、格式、示例 | 一问一答 |
| 上下文工程 | 怎么给 AI 喂信息 | 文档、代码片段、历史对话 | 信息注入 → 生成 |
| 驾驭工程 | 怎么让 Agent 可靠工作 | 约束、反馈回路、控制系统 | 人类掌舵,Agent 执行 |
DeepSeek Harness 是驾驭工程理念的完整产品化:一个把约束、反馈、可观测、可替换全部落地的开源实现,让驾驭工程不再停留在方法论,而是开箱即用的基础设施。
核心架构:一切皆插件
DeepSeek Harness 的架构可以用一张图说清:Cordis 内核居中,所有能力以插件环绕,通过服务与事件协作。

这套架构落实到运行时的关键机制是 Profile + 组合包(Bundle):运行中的 dsh 是一棵插件树,由启动时按序叠加的各层组合而成——先按 profile 列出的顺序应用每个组合包,然后是 profile 的 cordis.patch.yml、home 级 patch,最后是任意 --patch overlay。用一行命令即可查看机器上实际启动的完整配置树:
dsh --profile web --dump-config # 打印出的任何条目,都可以由你自己的 patch 替换
四种运行模式
DeepSeek Harness 开箱即提供四种运行模式,覆盖从完整编码 Agent 到最小化基准测试的全谱系:

| 模式 | 定位 | 能力构成 |
|---|---|---|
| 标准模式 | 功能完整的编码 Agent | 文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理(subagent)与工作流 |
| PTC 模式 | 代码组合工具调用 | 具备标准模式全部能力,并通过 Code Mode SDK 呈现工具——让模型用一个 TypeScript 程序组合多步操作 |
| 极简模式 | 最小化基准测试 | 仅保留持久 bash 与 str_replace_editor 两个工具,用于最小化环境下的模型评测 |
| 创造模式 | 自定义 Agent preset | 具备标准模式全部能力,并提供运行时检查、插件实验与 preset 创作指导——组合出属于你的新模式 |
核心特性
特性一:每一次运行都有迹可循
模型看到的一切都会写入仅追加(append-only)设计的会话日志:系统提示词、思维链、工具调用与结果、子 Agent 调度、每一次上下文注入,全部落盘。在 Trajectory 视图中可按来源查看;恢复、分叉(fork)、检索与回放共享同一份事件流——Agent 的每一步都可追溯、可复现。
特性二:多形态使用,随处运行
Web UI(默认 http://127.0.0.1:3080)提供完整的图形界面;headless 模式一次性运行任务、打印最终答案并退出,适合脚本与 CI;还有 CLI 与官方 Python SDK(pip install deepseek-harness-sdk,自带运行时、无需系统 Node.js)和 TypeScript SDK,把 Agent 嵌入任何工作流。
特性三:开放可控,无特权内核
MIT 开源,不存在需要打补丁的特权内核:所有能力注册都是可逆副作用,插件卸载即撤销。通过 Profile、组合包与 patch 分层叠加配置,--dump-config 可随时审查整棵配置树——你的 Agent 是什么样,你说了算。
特性四:模型无关,即插即用
填入 DeepSeek API 密钥即可使用,也支持其他提供方与自定义 OpenAI 兼容端点,模型路由无需重启服务器。事件驱动的扩展点体系(会话 / Agent / 能力三级事件)让开发者可以挂载策略与适配器,随时换模型、换工具、换存储。
快速上手
安装 Node.js 后,一行命令启动 Web UI:
<span>npx </span><span>@deepseek</span><span>-</span><span>ai</span><span>/</span><span>dsh web</span>
也可以从源码安装:
<span>git clone https</span><span>:</span><span>//github.com/deepseek-ai/deepseek-harness.git</span><span>
cd deepseek</span><span>-</span><span>harness
pnpm install
pnpm run build
pnpm dsh web</span>
Web UI 使用只需三步:
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 配置模型 | 打开 设置 → 模型,填入 DeepSeek API 密钥并保存,模型路由立即可用、无需重启 |
| 2 | 选择工作区 | 添加启动 dsh 时所在的项目目录并选中(选中前会话输入框不可用) |
| 3 | 运行任务 | 发送如 “Summarize this repository”——agent 读写文件、运行命令、委派子代理;超出权限策略的操作会先征求你的审批 |
Harness 与相关工具的关系
DeepSeek Harness 不是又一个"写几个 agent 的库”,而是位于 SDK 与框架之上、解决"Agent 如何可靠运行"的完整层。与当下热门工具的定位差异:
| 项目 | 定位 | 与 DeepSeek Harness 的关系 |
|---|---|---|
| Claude Code | 闭源商用编码助手 | 功能对标,但 dsh 完全开源、可自托管、能力可替换 |
| Hermes Agent | 自进化个人 Agent(Nous Research) | 侧重跨会话记忆与技能沉淀;dsh 侧重插件化组合与全程可观测,两者理念互补 |
| OpenClaw | 本地优先消息型 Agent | 侧重多渠道接入与数字主权;dsh 提供 Web UI / headless / SDK 多形态 |
| LangGraph / AutoGen / CrewAI | Agent 构建框架(编程库) | 框架解决"如何构建";dsh 是完整 Harness——“如何稳定运行 + 如何替换能力” |
- 原文作者:知识铺
- 原文链接:https://index.zshipu.com/ai002/post/20260818/DeepSeek-Harness-%E7%AE%80%E4%BB%8B-%E8%8F%9C%E9%B8%9F%E6%95%99%E7%A8%8B/
- 版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议进行许可,非商业转载请注明出处(作者,原文链接),商业转载请联系作者获得授权。
- 免责声明:本页面内容均来源于站内编辑发布,部分信息来源互联网,并不意味着本站赞同其观点或者证实其内容的真实性,如涉及版权等问题,请立即联系客服进行更改或删除,保证您的合法权益。转载请注明来源,欢迎对文章中的引用来源进行考证,欢迎指出任何有错误或不够清晰的表达。也可以邮件至 sblig@126.com

