大家好，我是木泽。

最近 DeepSeek 开源了一个叫 Harness 的 Agent 运行框架，命令名是 dsh，上线一天 GitHub 星标就冲到了十万级别。但它到底是个啥，和我们平时用的 Claude Code、Codex 又有什么不一样？这篇我从后端工程师的视角，把它拆开讲清楚。

⭐️ 核心理念：Agent = 模型 + Harness。模型是大脑，负责"想"；Harness 是模型外面那套系统，负责让大脑能动手、能记事、能被约束。

它到底是什么

DeepSeek Harness 是 DeepSeek 在 2026 年 8 月 13 日开源的 Agent 运行框架，MIT 协议，命令名 dsh。

先破一个常见误解：它不是模型，是"harness 层" ——把模型和工具、文件、终端连起来的那一层。模型再强，也有天生做不到的事：记不住事、不会自评、不知道什么叫"做完了"、上下文会塞满。Harness 就是在外面补这些短板的：外部记忆、工具调用、任务规划、文件读写、终端执行、错误反馈，以及判断任务何时结束。

🌈 拓展：你熟悉的 Claude Code、Codex，其实也都是 Harness。它们必须和具体模型搭配起来，才是一个完整的 Agent。DeepSeek 这次不是再做一个聊天软件，而是把这套"模型外面的系统"开源出来，让你能拆开、替换、自己拼。

最核心的设计：一切皆插件

普通 Agent 工具里，文件读写、Shell、Skills、会话存储、界面……这些能力都是厂商封装好的。你只能"用"，不能"改"，甚至看不到它们长啥样。

DeepSeek Harness 不一样，它把这些能力全部做成插件，内核是一个叫 Cordis 的 TypeScript 插件容器。支撑这句话的，是 DeepSeek 自己的插件清单：models、tools、skills、sessions、sandboxes、storage、loops、scheduling、UI——全是独立插件，靠配置就能替换，不用改框架源码。

⭐️ 重点：插件可以在 Agent 运行过程中热插拔，状态不崩。翻译成大白话——Agent 可以一边干活，一边给自己加能力、换能力。这是它和市面上大多数 Agent 工具最本质的区别：别人是"成品"，它是"可改造的骨架"。

Cordis 的克制体现在两个词上：

• 时间可组合性：插件卸载之后，它之前产生的副作用能不能被干净撤销
• 空间可组合性：插件依赖出现、消失或改变时，能不能动态重新解析自己的依赖

你不用背术语，只需要理解它想解决的问题：Agent 在运行中不断给自己插拔能力，系统不能因此崩掉。

⚠️ 注意：现在是 v0.1 开发者预览（npm 上是 0.1.0-rc.x 候选版本），README 明确写了"会有兼容性破坏的变更"。尝鲜和开发可以，别直接上生产。

四种运行模式（其实是四种插件组合模板）

这里容易绕晕：四种模式不是"功能等级"，而是"插件组合模板"。

标准模式 开箱即用的完整编码 Agent，文件编辑、Shell、检索、Skills、计划、目标、子代理、工作流都配好。第一次上手无脑选它。

PTC（程序化工具调用）模式 标准能力 + Code Mode SDK，让模型写一段 TypeScript 程序来组合多步操作。好处是减少来回对话、更省 Token；代价是要求模型有稳定的代码规划能力，调试门槛高。小白先不碰。

极简模式 只给模型两个工具：一个持久 bash、一个文件编辑器。它的用途是做模型基准测试——事实上，DeepSeek 自己发 V4 系列模型榜单时，用的就是这套极简模式当评测框架。

创造模式 标准能力 + 运行时检查、插件实验、preset 创作。最特别的一个：它让 Agent 能检查自己正在运行的插件环境、现场造新插件。说白了，Agent 能改造自己。

⭐️ 重点：新手别纠结，标准模式先跑通，其他三个以后再说。

可追溯：只追加的会话日志

DeepSeek Harness 把每一次会话都记成一份只追加的事件日志：系统提示词、用户消息、推理过程、工具调用、权限变化、子代理调度，全都作为事件写进日志。下一轮模型看到的历史，是从这份日志重新推出来的。

这件事的价值很实在：任务跑偏了，你能回看它到底在哪一步开始跑偏，而不是只看到"失败"两个字。可观测、可审计、可复现，这才是它能拿来认真干活的地基。

怎么跑起来（实操）

前置三样

• Node.js 22.19+ 或 24+：这是硬门槛，版本很挑，低于这个会卡
• 一个模型 API Key：默认对接 DeepSeek 官方 API，也支持 OpenAI 等兼容接口
• 一个干净的测试目录：第一次跑别拿重要项目试，Agent 真能改文件、跑命令

快速体验（新手推荐）

npx @deepseek-ai/dsh web

首次会下载依赖包，启动本地 Web UI：http://127.0.0.1:3080

源码 安装（深度定制）

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build      # ⚠️ 不少教程漏了这一步
pnpm dsh web

⚠️ 注意：社交平台上流传的 clone → install → run 少了 pnpm run build，UI 起不来。README 本身也给了更简单的 npx 路径，不用克隆。

和 Claude Code / Codex 差在哪

定位

• Claude Code / Codex：厂商封装好的成熟产品
• DeepSeek Harness：一切皆插件的可改造骨架

生态

• 前者：成熟的插件与技能生态
• 后者：刚起步，社区在攒

适用人群

• 前者：要稳定生产力
• 后者：想折腾、想定制、想看懂 Agent 怎么搭

⭐️ 重点：它不是用来立刻替换你手上成熟工具的，而是给你另一种可能——把 Agent 当系统来搭，而不是当软件来用。

🌈 拓展：它模型无关，支持 DeepSeek、Anthropic、OpenAI、Bedrock、Vertex、Azure 以及任意 OpenAI 兼容端点。也就是说，你不被锁死在 DeepSeek 模型上，想接别家模型有这条路。配合 DeepSeek 的低价缓存，社区实测单次真实编程任务成本可以压得很低，但具体数字社区说法不一，建议自己跑一遍再下结论。

写在最后

DeepSeek Harness 把"Agent 到底是怎么跑起来的"这套原本封闭的胶水代码开源了出来，核心就一句话：一切皆插件。对写后端的我们来说，它的价值不在"今天就能替你写业务代码"，而在让你看清一个 Agent 由哪些可替换的零件组成——模型、工具、记忆、循环、调度，每一个都是插件。理解了这个，再看任何 Agent 框架，你都能拆开看它的骨架。

• 官网地址：https://www.deepseek.com/harness/
• 项目地址：https://github.com/deepseek-ai/deepseek-harness

如果这篇对你有点用，给个一键三连吧，点赞、收藏、加关注，每天持续更新。