DeepSeek Harness 简介：一切皆插件的 Agent 框架

DeepSeek Harness 简介

AI 模型已能独立完成复杂编码任务，真正的挑战变成如何把模型能力稳定、可靠、可观测地组织成可用的 Agent。深度求索开源的 DeepSeek Harness（dsh）给出答案：Agent = Model + Harness——模型是灵魂，Harness 赋予 Agent 理解环境、使用工具、在真实场景持续工作的能力。

什么是 DeepSeek Harness

dsh 是深度求索开发的开源 Agent 框架，MIT 许可证、TypeScript 编写，目前处于预览阶段（官方提示未来将有破坏性变更）。它不优化模型本身，而是优化模型运行的环境，一切皆插件：模型、工具、技能、会话、沙箱、存储、agent loop、调度、UI 等能力均由插件提供，通过 Cordis 内核的服务与事件协作。底层 Cordis 的设计思想对应论文《A Programming Paradigm for Spatiotemporal Composability》；运行时不存在特权内核，每项能力注册都是可逆副作用，插件卸载即自动撤销。

为什么需要 Harness

行业共识是瓶颈不在模型智能，而在基础设施：OpenAI 团队的 100 万行代码实验中，5 个月产出全部由 Agent 完成；LangChain 仅优化外部驾驭环境（文档结构、验证回路、追踪系统），就让编码 Agent 在 Terminal Bench 2.0 从 52.8% 升至 66.5%，排名从第 30 跃至第 5——底层模型一个参数未动。dsh 正是这一共识的产品化落地。

AI 工程范式的三次跃迁

核心架构与四种运行模式

架构上 Cordis 内核居中、能力以插件环绕，运行时通过 Profile + 组合包（Bundle） 按序叠加出插件树：先是各组合包，再是 profile 的 cordis.patch.yml、home 级 patch，最后是 --patch overlay。一行命令可查看实际启动的完整配置树：

dsh --profile web --dump-config   # 打印出的任何条目，都可以由你自己的 patch 替换

核心特性速览

• 运行有迹可循：提示词、思维链、工具调用、子 Agent 调度全部写入仅追加会话日志，Trajectory 视图可按来源回放。
• 多形态使用：Web UI（默认 http://127.0.0.1:3080）、桌面版、headless、CLI、Python SDK 与 TypeScript SDK。
• 开放可控：MIT 开源、无特权内核，--dump-config 随时审查配置树。
• 模型无关：填入 DeepSeek API 密钥即可用，支持其他提供方与 OpenAI 兼容端点，模型路由无需重启。

快速上手

安装 Node.js（24.9+）后一行命令启动 Web UI：

npx @deepseek-ai/dsh web

然后三步走：① 设置 → 模型，填入 DeepSeek API 密钥保存；② 添加并选中项目目录作为工作区；③ 发送任务如 "Summarize this repository"，越权操作会先征求审批。