DeepSeek Harness – 开源的Agent Harness

8 月 13 日晚，DeepSeek 悄悄把这块拼图补上了——DeepSeek Harness（dsh）开发者预览版 v0.1 发布，MIT 协议开源。

官方给的公式很直白：

Model + Harness = Agent

模型是大脑，Harness 是神经和手脚。大脑负责想，Harness 负责看上下文、调工具、跑命令、管状态、做重试、留轨迹。这次发的不是新模型，而是一套能把任意模型接进真实工作流的 Agent 运行时。

它不是“DeepSeek 版 Claude Code”那么简单

很多媒体第一眼把它对标 Codex / Claude Code，没错，但格局小了。

DeepSeek Harness 的定位是Agent Harness（智能体运行框架）：

• 不绑定 DeepSeek 自家模型，模型是插件，换 Key 就能接 OpenAI / Kimi / Gemini 等近 40 家
• 不只有一个 CLI，自带 Web UI（默认 127.0.0.1:3080）、Headless 模式、Python SDK、JSON-RPC
• 核心卖点不是“能写代码”，而是“一切皆插件”——模型、工具、会话、沙箱、存储、Agent Loop、调度、UI，全都是 Cordis 插件，能在配置层热插拔

通俗讲：别人家的 Agent 框架，工具能换、Prompt 能改；DeepSeek Harness 连“Agent 怎么循环”“子 Agent 怎么调度”“会话怎么存”都给你做成可卸载的插件。

专业层面看架构：Cordis 插件树 + Append-only 轨迹

1. 一切皆插件（Everything is a Plugin）

底层是 DeepSeek 与北大联合研究的 Cordis 元框架，只干一件事：管插件的加载、卸载、依赖。

上层所有能力都是插件包（bundle）：

• ctx.llm 模型适配器
• ctx.tools 工具注册（Shell / 文件编辑 / 搜索 / MCP…）
• ctx.sessions 会话与日志
• ctx.agents 子 Agent 编排
• 甚至连 Agent Loop 本身也是插件，可整体替换

插件通过服务注入 + 类型化事件协作，卸载时 ctx.effect() 注册的副作用反向撤销，不留孤儿状态。这意味着你改运行时，不用 fork 源码，写个 bundle 挂上去就行。

2. 四种运行模式，开箱即选

模式	加载内容	适合场景
标准模式	完整工具集（文件/Shell/搜索/Skill/子Agent）	日常编码、项目级任务
PTC 模式	标准工具 + CodeMode，模型生成 TS 编排多轮调用	多步复杂流水线、批量重构
极简模式	仅 bash + str_replace_editor	模型基准测试、最小环境验证
创造模式	运行时检视插件树，内存中试挂 Cordis 插件	自研 Agent 预设、插件开发

3. Append-only Session Log（这才是工程含量）

模型看到的一切——系统提示、CoT、工具调用、返回、子 Agent 调度、上下文注入——全写进仅追加事件流。

• Trajectory 视图按来源追溯
• 支持恢复 / 分叉 / 检索 / 回放
• 模型上下文不是内存数组，是从事件流投影出来的

长任务崩了？fork 一条新分支继续跑。要审计 Agent 为什么乱改文件？回放事件流就行。

4. 安全模型：Fail-closed

工作区写权限默认锁在当前目录，提权操作走 ask-approval；隔离验证不过就拒绝执行，不是“先跑再拦”。

安装方法

环境：Node.js 装好

npx @deepseek-ai/dsh web

浏览器开 http://127.0.0.1:3080 → Settings 填 API Key → Choose workspace 选项目目录 → 开会话发指令。

想从源码玩：

git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install && pnpm run build
pnpm dsh web

Headless 跑 CI 任务、Python SDK 嵌进后端、JSON-RPC 接自有前端，也都给了入口。

可扩展性：为什么说是“Agent 操作系统”而不是“工具箱”

① 替换模型 ≠ 改代码

dsh.profile 里换 model bundle，或 Settings 里填别家 Key，DeepSeek / OpenAI / Kimi 随意切。

② 本地执行 → 远程沙箱，只换实现层

Bash 接口归接口层，本地进程是一种实现，远程容器是另一种。把 filesystem / shell / terminal 三个实现层换成云沙箱 bundle，不动上层逻辑。

③ 自定义 Agent 预设（Preset）

Web UI 里“自定义预设”→ 勾模型插件 + 工具插件 + Skill + 上下文策略 → 存为模板。下次启动一键加载，相当于给不同工种配不同“人体”。

④ 写插件发布到生态

package.json 里声明 dsh.bundle 和 dsh.profile，Creation 模式里内存试跑，稳定了打成 bundle 挂 cordis.patch.yml 或 --patch 启动。官方明摆着在养插件市场，仓库打 dsh-plugin topic 可被检索。

⑤ 配置即运行时

dsh --profile web --dump-config 能把“本次启动到底挂了哪些插件”全打出来。环境差异走 profile/bundle 组合，不复制代码分支——这是它和很多 Agent 脚本最本质的区别。

现在使用需要注意

v0.1，Developer Preview，官方自己说后续会有破坏性变更，别直接塞进生产 CI 扛业务。

但如果你是符合下面任一条的人，今晚就该 clone：

• 做 Agent 产品，受够了改 Claude Code 式框架要 fork 大坨源码
• 想把 DeepSeek V4 系列低价 token 包成内部 Coding/运维 Agent
• 研究 Agent Loop、多 Agent 编排、会话回放这种“Harness 工程”本身
• 需要可控、可审计、可私有化部署的 Agent 底座（MIT 协议，懂的都懂）

模型军备赛差不多到头了，下半年大家拼的是“同一个模型，谁让它干得更稳”。DeepSeek 这次把 Harness 开源，等于把“把聪明变成执行”的那套骨架摊给你看。

项目地址：github.com/deepseek-ai/deepseek-harness

大脑各家都有，DeepSeek 这次把“动手的身子”拆成乐高，开源了。