DeepSeek Harness 开源智能体框架 一切皆插件

什么是 DeepSeek Harness

DeepSeek 在 2026 年 8 月 13 日开源了一个叫 DeepSeek Harness（简称 dsh）的东西，跟 V4 Pro 模型同一天放出来，MIT 协议。

一句话讲清楚它是什么。DeepSeek 给智能体下了个公式：模型 + Harness = 智能体。模型是脑子，负责想；Harness 是脑子外面的那层，负责让脑子能打开文件、跑命令、调用工具、记住上下文、把任务一步一步跑完。没有 Harness，模型只会吐文字，打不开任何东西。

dsh 跟 Claude Code、Codex 这类成品 Agent 不一样。后两者是封闭成品，能力写死在核心里。dsh 的设计哲学是「一切皆插件」，底层用了一套叫 Cordis 的插件容器，模型适配、工具注册表、会话日志、甚至驱动任务的 agent 循环，全都是可插拔的插件。官方说法是「没有需要打补丁的特权内核」——你可以随时把不满意的插件拔下来换一个，或者自己写一个插上去。这让它更像搭 Agent 的乐高底板，而不是买来就用的成品。

前面我写过的 美团 CatPaw 猫爪 AI 工作台，还有千问办公，都是开箱即用的成品 AI 助手；dsh 走另一条路，它把拼 Agent 的底层能力交给你自己。

DeepSeek Harness 怎么安装

先说前提，它只认 Node.js 22.19 以上或 24 版本，老版本会直接启动失败。确认一下本机版本：

node -v

装好 Node 之后，启动就一行命令：

npx @deepseek-ai/dsh web

这条命令会下载预览版、在本机起一个网页界面，默认地址是 http://127.0.0.1:3080。第一次打开会让你做三件事。

• 填 API Key：在 Settings → Models 里把 DeepSeek 的 Key 贴进去，保存立即生效，不用重启
• 选工作区：点 Choose workspace 指定一个项目目录，没选的话输入框是灰的没法用
• 发任务：开个会话，来一句「总结一下这个仓库，指出主要模块」，它就能读写文件、跑命令、派子任务

不想用网页界面，也能跑无头模式一次性执行任务：

npx @deepseek-ai/dsh --profile headless "把失败的测试修好"

跑完打印结果就退出，适合写进脚本或 CI。全局安装用 npm install -g @deepseek-ai/dsh，源码构建走 pnpm，还有 Python SDK 可选。

说句实话，它现在还是开发者预览版，官方明着警告会有破坏兼容的变更，旧会话记录升级后可能读不了。当玩具玩没问题，真要上生产得再等等。

这个插件站做什么

dsh 的能力全靠插件堆出来，可去哪找插件？这就是 DSH Plugin Directory 站出来的地方。

这个站把自己定位成「每一个 DeepSeek Harness 插件的目录」。dsh 把智能体拆成了 9 个可替换的能力槽位，比如模型适配、工具、会话、agent 循环各自占一个槽。插件站把这 9 个槽位铺成一个面板，每个槽位下面列着社区已经发布的插件，按星标排序，你挑想换的那一格点进去就行。

站上实时挂着几个数字：3601 个插件、9 个能力槽位、2578 位作者，而且几分钟前还在同步，生态涨得很快。

它给的装插件三步也简单。

• 先起 harness：还是那条 npx @deepseek-ai/dsh web，网页界面跑在 127.0.0.1:3080
• 找槽位：用站点上面的面板，每个槽位都列了社区发布的插件
• 加进 profile：把插件加进你的 profile，profile 会叠着打包你的补丁，下次升级不会覆盖你的配置

说白了，这个站就是 dsh 的插件应用商店兼发现页。等哪天高质量插件沉淀够了，普通用户也能像装模组一样给自己的 Agent 加功能。现阶段更偏极客，但值得先码住。