关注 · AI一手 · 每天分享最前沿的AI技术与应用

✍️ 作者: AI一手

继 DeepSeek V4 Pro 正式版上线后，DeepSeek 又甩出来一个大招。

这次不是模型，是一整个 Agent 运行框架，叫 DeepSeek Harness。

GitHub 上线一个半小时，星标冲破 2.4 万。到我写这篇的时候，已经 6.5 万了。

但是我知道，很多朋友一看到这个东西就有点懵，这个 Harness 到底是个啥？跟我们平时用的 Claude Code、Cursor 是一回事吗？我又不是程序员，我能用吗？

没关系，这篇文章就带你把这些事搞清楚。

01先搞懂 Harness 是个什么东西

先说个背景。

DeepSeek 自问世以来，其实一直没有做过自己的 Agent 产品。它一直就是两条线，一个网页聊天，一个 API。

API 大家都熟悉了，我们平时就是把 DeepSeek 的模型接到各种别人家的 Agent 里面去用的。Claude Code 里面可以换成 DeepSeek，Codex 里面可以接 DeepSeek，Cursor 里面也能选 DeepSeek。但这些都是别人的壳子，DeepSeek 只提供脑子。

现在 Harness 出来了，意思就是，DeepSeek 自己也要做壳子了。而且一出手就是开源的。

那这个壳子到底是什么？

简单讲，你平时跟 DeepSeek 聊天，它能告诉你"你应该在终端敲这行命令"，然后你得自己去敲。它说完就完了，动不了手。

Harness 就是给它接上手脚的那套东西。

装了 Harness 之后，模型能自己打开你的文件夹、自己敲终端命令、自己读报错、自己改，不用你在中间来回复制粘贴了。

DeepSeek 官方给了一个公式，我觉得挺好记的，

Agent = Model + Harness

模型是大脑，Harness 是手脚加工具。光有脑子没有手，它只能告诉你该怎么做，但做不了。

所以 DeepSeek Harness 不是一个新模型，也不是一个聊天网页。它是让 DeepSeek 的模型从"只会说"变成"真的能干活"的那套基础设施。

02那它跟 Claude Code、Codex 有什么不一样

这个问题肯定很多人会问。

坦率的讲，区别挺大的。

Claude Code 和 Codex 是封装好的产品，你直接用就行，底下的东西你改不了。用的是谁家模型、Agent 怎么循环运行、界面长什么样，全是定死的。

DeepSeek Harness 的思路完全不同。

它的核心理念就五个字，一切皆插件。

啥意思呢？就是在 Harness 里面，模型是插件、工具是插件、界面是插件，甚至 Agent 自己怎么循环运行这个流程，也是个插件。

也就是说，你全都可以换。

以前用 Codex 或者 Claude Code，这些能力全都被封装好了，你改不了，没事也不会去改。

但在 DeepSeek Harness 里面，所有所有所有的这些东西，全部都被包装成了插件。

打个比方，Claude Code 就是精装房，拎包入住，但是墙不能砸、厨房不能挪。Harness 给你的是毛坯房加一整套建材，你可以自己想怎么装就怎么装。当然它也给你提供了几套样板间方案，不想自己折腾的话，选一套直接住进去也行。

03装好它，一行命令的事

先装 Node.js

Harness 是用 Node.js 写的，你电脑上得有这个运行环境。

打开 https://nodejs.org/ ，你会看到两个下载按钮，选左边那个 LTS（长期支持版），版本号 22 以上就行。

下载完双击安装包，一路点 Next 就行，不需要改任何选项。

装完之后，打开终端验证一下有没有装好。Windows 用户按 Win+R 输入 cmd 回车，Mac 用户打开"终端"应用。

输入下面两行命令，

node -vnpm -v

如果能看到版本号（比如 v22.22.0），说明装好了。

然后装 Harness，两种方式选一个

方式一：全局安装（推荐）

装一次就行，以后每次启动秒开。

npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com

装完之后，每次启动只要敲，

dsh web

方式二：临时运行

不装也行，npx 会帮你临时下载跑一次。

npx @deepseek-ai/dsh web

但这种方式每次启动都要重新下载检查，会慢一些。第一次跑会问你要不要安装，输入 y 回车就行。

国内网络建议带上 --registry=https://registry.npmmirror.com，用 npmmirror 镜像源，npm 官方源会慢一些。

不管哪种方式，等一会儿你会看到终端输出 dsh web: `http://127.0.0.1:3080` ，这就说明启动成功了。浏览器会自动弹出来。

说实话打开这个地址的一瞬间我愣了一下。我写了这么多 Agent 教程，Claude Code 是终端、Cursor 是编辑器、Codex 是桌面应用，结果 DeepSeek 搞了个 Web 端？一个跑在浏览器里的 Agent？

抱着好奇心继续往下看。

04第一次打开，做好这三件事

浏览器打开后第一件事，会弹一个内测声明，大意是 Harness 目前还是 0.1 版本，还在快速迭代。点"继续"就行。

第一件，填 API Key

点完继续，它不会让你直接进主界面，而是先弹一个 API Key 填写框。没有 Key 它就是个空壳，必须先填上才能用。

▸ 去 https://platform.deepseek.com/ 注册登录

▸ 左边菜单找 API 密钥，创建一个

▸ 复制那串 sk- 开头的字符，粘贴到这个输入框里，点"保存并继续"

记得充点钱，API 按用量计费的。

第二件，选模型

目前可以选 V4 Flash 和 V4 Pro。还可以调思考强度。

|
模型
|
一句话
|
建议
|
| — | — | — |
|
V4 Flash
|
快，便宜
|
先用这个跑通流程
|
|
V4 Pro
|
强，贵
|
复杂任务再切
|

这里顺便说一嘴，DeepSeek 这次跟着 Harness 一起涨价了，涨得还不少。V4 Pro 的缓存命中价格直接涨了 12 倍，高峰期输出价格来到了 27 块。

曾经的"价格屠夫"，说实话现在得打个问号了。跟 GLM、Qwen 3.8 Max 已经拉不开太大差距。

但好消息是 Harness 并没有把你锁死在 DeepSeek 上，它支持添加其他模型提供方，也支持自定义 Base URL 和模型列表。你完全可以把 GLM 接进来用。

第三件，选工作区和权限

回到首页，点"选择工作区"，添加一个项目目录。这就是 Agent 能操作的文件范围。

选完目录之后，左下角有个权限选项，点开会看到三个级别，

|
权限
|
说明
|
建议
|
| — | — | — |
|
Read Only
|
只能看你的文件，不能改
|
纯问答场景
|
|
Workspace Write
|
能读写文件，但只限于你选的那个工作区文件夹
|
日常用这个就行
|
|
Full access
|
整台电脑的文件都能动
|
除非你很清楚自己在干什么，否则别选
|

你可能会想，这不就是个网页吗，怎么能动我电脑上的文件？其实 Harness 不是云端应用。dsh web 启动的是一个跑在你本机的 Node.js 服务，浏览器只是它的前端界面。所有文件读写、终端命令都是这个本地进程在执行，跟 VS Code 的原理一样。

所以 Workspace Write 是安全和好用之间的平衡点。它只能动你选的那个文件夹里面的东西，不会乱跑去改你电脑上其他地方的文件。

05先把这几个插件装上

到这步你已经能用了，但是裸装的 Harness 体验其实挺糙的。好几个基础功能居然要靠社区插件来补。

打开设置，切到插件标签页，你会看到 Harness 默认挂了 159 个内置插件。

说实话看到这个页面我第一反应是，这对普通用户也太不友好了。全是英文，include、timer、hmr、llm、session……一个个看过去完全不知道是干嘛的。这就是 Harness 目前最大的问题——它是给开发者造的，不是给普通人用的。

但这些内置插件你也不用动，它们是跑基本功能的底层模块。

你要关注的是社区插件。打开这个地址，

https://github.com/topics/dsh-plugin

已经有 1024 个社区插件仓库了。

挑几个实测下来确实好用的，推荐一下。社区插件都是通过终端命令安装的，格式统一：

npx @deepseek-ai/dsh plugin add --profile web github:作者/插件名

注意：npx @deepseek-ai/dsh web 启动的是 web 这个 profile，所以装插件必须写 --profile web。装到别的 profile 里，网页端是看不见的。每次装完之后，关掉终端重新执行 npx @deepseek-ai/dsh web，浏览器再 Ctrl+F5 强制刷新一下。

dsh-at-file：输入框里 @ 引用文件

这个我觉得应该内置的，结果居然要装插件。装完之后你在输入框里打 @，上方会弹出文件列表，边打边搜，回车就能把文件丢给模型。没有这个插件之前，你只能手动复制粘贴文件路径。

npx @deepseek-ai/dsh plugin add --profile web github:omdsh-dev/dsh-at-file

ModLens：给 DeepSeek 补上读图能力

这个我觉得是刚需。DeepSeek 的模型本身是纯文本，你把截图丢进去它看不见。ModLens 就是给它外挂一条视觉通道：配置好之后，直接往对话里粘贴图片，模型就能读。

npx @deepseek-ai/dsh plugin add --profile web @liustack/modlens@latest

注意这里用的是 npm 包名，不是 github: 地址。因为 GitHub 源码里没有编译好的运行文件，装完会报 Cannot find module dist/main.js。从 npm 装才带构建产物，装上就能用。

装完重启，把右下角模型选择器切到带 (modlens vision) 的那一项，比如 DeepSeek-V4-Pro (modlens vision)。切过去之后，Ctrl+V 把图片贴进输入框，正常提问就行，不用先存成本地文件再丢路径。

视觉通道还要配一个真正能看图的引擎。本机已经登录过 Claude Code 或 Codex 的，ModLens 可以复用。什么都没有的话，去 https://aistudio.google.com 领一个免费 Gemini Key，然后在终端跑：

npx @liustack/modlens doctornpx @liustack/modlens config set gemini-api.apiKey 你的Keynpx @liustack/modlens config set provider gemini-api

doctor 显示 Selected provider 是 [ok]，就可以贴图了。

dsh-usage-cost：实时费用追踪

API 涨价之后，这个插件就很有必要了。装完重启，对话最底下那一行统计旁边会出现 API 成本，分成四段：这场对话、这个工作区、今天、最近 5 小时。你不用点任何按钮，正常聊几句它自己往上加。8 月 17 号之后还会按北京时间自动切峰谷价，高峰是早上 9 到 12 点、下午 2 到 6 点。

npx @deepseek-ai/dsh plugin add --profile web github:Dino6021/dsh-usage-cost[#main](javascript:;) --registry https://registry.npmmirror.com

06四种模式到底怎么选

接下来聊模式。Harness 内置了四种模式，很多人看到这儿就懵了。

其实理解了插件机制之后，这个就很简单了——四种模式就是官方给你预设的四套插件组合，本质上就是模板。

第一次用？直接选标准模式，不用想。

|
模式
|
包含什么
|
适合谁
|
一句话
|
| — | — | — | — |
| 标准模式 |
文件编辑、Shell、网页搜索、Skills、计划、目标、子 Agent、工作流，全配好了
|
所有人
|
直接用，不用想
|
| PTC 模式 |
标准模式全部能力 + Code Mode SDK
|
进阶开发者
|
模型写 TypeScript 串联工具，省 Token 但难调
|
| 极简模式 |
只有一个 Shell + 一个文件编辑器
|
跑基准测试的
|
日常别选
|
| 创造模式 |
标准模式全部能力 + 运行时检查 + 插件实验
|
想自己造插件的人
|
Harness 最特别的地方
|

展开说两个。

PTC 模式。 标准模式下模型发起一次工具调用、拿到结果、再决定下一步，来来回回可能五六个回合。PTC 模式给模型一套 SDK，让它直接写一段 TypeScript 程序，一次性把多步操作串起来跑。效率更高、Token 消耗更少。

但这就需要模型的代码规划能力足够稳定，调试起来也麻烦。新手先不用碰。

创造模式。 这个才是 Harness 最有意思的地方。

你可以告诉它，“帮我做一个只允许读代码、不允许改文件，专门负责安全审计的模式。”

它能现场帮你拼一套出来。

更有意思的是，Agent 在干活的过程中发现自己缺个工具，它能自己现场写一个插件装上去，然后接着干。

想象一下你在组装家具，发现少了个工具，然后你自己现场造了一个出来继续装——大概就是这个意思。

这背后靠的就是 Cordis 内核的能力——运行时可插拔。

07底层设计，了解一下

这块稍微深入一点，不感兴趣的可以跳过。

Cordis 内核

DeepSeek Harness 的底层是一个叫 Cordis 的内核。这个内核的作者加入了 DeepSeek，他们为这个东西发了一篇 88 页的论文。

论文地址在这里，感兴趣的可以去看，

https://github.com/cordiverse/paper/blob/main/paper.pdf

Cordis 干的事情极其克制，只负责插件的加载、卸载和依赖管理，其他什么都不管。

但它有两个关键特性，

时间可组合性。 一个插件卸载之后，它之前产生的所有副作用能完整撤销。不会留下什么残留状态把 Agent 搞崩。

空间可组合性。 一个插件依赖另一个插件。当被依赖的那个消失了、变了、换了，依赖它的插件能自己重新处理好自己的状态。

说人话就是，Agent 跑着跑着，你随时拔个插件换个新的，它不会崩。

这两个特性放在一起，就是为了让 Agent 在运行过程中不断给自己装卸插件、不断调整自己的能力组合。

这也是为什么 DeepSeek 不叫它 Code，不叫它 Build，叫它 Harness。它做的不是一个 Agent 产品，而是一个让所有人都能来做 Agent 的基建。

会话日志

Harness 还有一个对开发者很友好的设计。它把会话做成了一份只追加的事件日志。模型看到的系统提示词、用户消息、推理过程、工具调用和结果、权限变化、上下文压缩、子 Agent 调度，全都成为日志里的事件。

很多 Agent 失败以后，你只能看到任务失败或者无限循环，根本不知道它在哪一步开始跑偏的。

看的地方就在页面顶部，对话旁边有个轨迹页，点进去就是这条时间线。右上角还有个 Session log，可以把整份日志下下来。模型看到的系统提示词、你发的消息、它怎么想的、调了什么工具、工具回了什么，全都按时间排好。可观测、可审计、可复现。

08说句掏心窝的

坦率讲，Harness 现在对普通用户还不太友好。术语多、门槛高、界面功能也在补。很多东西你点进去大概率要懵一下。

而且你仔细想，它也不像是一个面向消费者的产品。一个正经要给普通人用的东西，会做成网页端、打开还是 127.0.0.1？

Claude Code、Cursor、Codex，那些是做好了塞给你直接用的。Harness 不是这个路数。它更像是 DeepSeek 在表态：Agent 这个东西我不打算自己做成品，我把底座开出来，你们自己做。

整个仓库 MIT 开源，github.com/deepseek-ai/deepseek-harness，代码全摊着，你随便看。

说说我自己的想法吧。

你要是程序员，随便装来玩就行。踩坑别慌，它现在就是开发者预览，坑是正常的。

你要是想做 AI 应用、想搞 Agent 开发，我倒觉得这个项目值得花时间认真看看。模型怎么接、工具怎么挂、会话怎么记、插件怎么热插拔，从头到尾都是开源的，你对着源码一步步走，比看十篇架构分析文章管用。就冲这一点，它就是一份很好的学习材料。

能不能成 Agent 领域的标准，我不知道，太早了。但有几个事情我觉得是实打实的：

插件化做到这个细的，目前就这一家。模型是插件、工具是插件、界面也是插件，跑着跑着你还能换。这个设计思路本身就值得看。

GitHub：github.com/deepseek-ai/deepseek-harness官网：deepseek.com/harnessAPI Key 申请：platform.deepseek.com

---

以上，如果觉得不错，随手点个赞、在看、转发三连吧～如果想第一时间收到推送，也可以给我个星标 ⭐谢谢你看我的文章，你的关注是我持续更新的动力～