大家好,我是晚安code。
8 月 13 日晚上,DeepSeek 官方不声不响把 DeepSeek Harness 开源了,GitHub 星数 3 小时破 3 万(据新浪财经报道)。官方口号只有五个字:一切皆插件。(2026 年 8 月 15 日整理,信息以 GitHub 仓库与官方公告为准)
这篇文章我想聊透一件事:插件化这种老掉牙的软件工程思路,被 DeepSeek 用在一款 Agent 框架上,到底带来了哪些好处;最后附上 2 分钟能跑起来的安装命令,想上手的一边看一边就能装。
一、DeepSeek Harness 开发者预览版发布,黑鲸正式出水
DeepSeek Harness 这次发布,最值钱的地方不在模型,而在它的架构理念。
先说事实:8 月 13 日晚间,DeepSeek 官网与 GitHub 同步放出 DeepSeek Harness 开发者预览版 v0.1,以 MIT 协议开源,仓库在 deepseek-ai/deepseek-harness。发布紧跟 V4-Pro 正式上线和 API 涨价公告,被媒体戏称"闪电二连击"。
它不是一个模型,也不是一个 API 客户端,而是一个智能体框架。
Agent Harness(智能体框架):负责把大模型"接"进真实世界的那一层——读写文件、调用工具、执行命令、控制权限、决定重试还是中止,都是它的活。你可以把它理解成 AI 的操作系统外壳。
官方公式一句话说清分工:Model + Harness = Agent,模型负责想,Harness 负责做。这款产品对标的是 OpenAI Codex 和 Anthropic 的 Claude Code / Claude Cowork,干的是写代码、做办公自动化这摊事。网页版的标志性鲸鱼图标,在 Harness 里变成了黑色,社区直接叫它"黑鲸"。

项目负责人崔添翼(Tianyi Cui)8 月初就面向全球公开征集过内测用户,发布时他说得很坦诚:预览版可能很粗糙,欢迎开发者提意见。他还有一句被转疯了的话:"闭源为用户提供现在,开源让用户自己掌握未来。"我盯着这句话看了好一会儿——能把"我们现在还粗糙"和"但未来交给你"讲得这么明白,这个姿态我是服的。

二、"一切皆插件"到底是怎么设计的
"一切皆插件"这句话的真意,是框架里没有特权组件。
注意,这不是营销口号,是架构事实。DeepSeek Harness 底层用的是 Cordis 插件元框架——一个只负责插件加载、卸载和依赖管理的微内核,Koishi 机器人生态已经用它跑了四年。
Cordis 插件元框架:只负责"插进去、拔出来、管依赖"的微内核,本身不承载业务功能。你可以理解成乐高的底座板——它只提供插口,不规定你必须拼出什么。
在 DeepSeek Harness 里,模型、工具、技能、会话、沙箱、存储、Agent 循环、调度,甚至 UI,全部都是插件,谁都不比谁高贵,谁都可以被换掉。插件之间靠服务(service)和事件(event)协作,能力挂在 ctx.tools、ctx.llm、ctx.agentLoop 这类稳定的上下文键上。想换一个能力,不用碰 Harness 源码,改配置就行。
数字更直观:官方默认部署里有一百多个可单独开关的插件,仓库包含 230+ 个 workspace 成员(core、llm、shell、terminal、fs、lsp、web、skill、subagent、workflow 等),发布 24 小时内社区带 dsh-plugin 标签的插件仓库已经攒到 288 个(据 36氪报道)。我第一次看到这串数字时,第一反应是:好家伙,选择困难症要犯了。

三、插件化给 DeepSeek Harness 带来了什么好处
插件化的第一个好处,是把"换能力"的成本从改源码降到改配置。
1)换能力不换源码。想换大模型?不用动框架。想把 Bash、终端、LSP 这些执行工具挪到远程沙箱里跑?替换对应插件、改一行配置,其他组件跟着动都不用动。
2)生态共建,长尾需求外包给社区。官方只管把内核做稳,翻译、文档处理、行业垂直工具这些长尾需求,社区自己会长出来。288 个插件仓库只是 24 小时的成绩。
3)四种模式等于四种插件组合。标准模式带全套工具,日常干活;极简模式只留 shell 和文件编辑,专门跑模型基准测试;PTC(程序化工具调用)模式:让模型先生成一段程序,再用这段程序去编排多轮工具调用,适合一连串按顺序执行的操作;创造模式则允许你直接在内存里试验插件、拼出全新的模式。一套内核,四种装法。
4)全链路有迹可循。它用只追加的会话日志,把模型看到的一切——系统提示词、思维链、工具调用、子 Agent 调度——全部记录下来,配合 Trajectory(轨迹视图)能像 git 分支一样恢复、分叉、回放。调 Agent 的时候这功能简直是救命。
这套打法和 Claude Code 完全是两条路线:
| 对比项 | DeepSeek Harness | Claude Code / OpenAI Codex |
|---|---|---|
| 开源 | MIT 全开源 | 闭源 |
| 架构 | 一切皆插件,无特权核心 | 核心封闭,开放扩展点 |
| 模型支持 | 可换近 40 种主流模型 | 以自家模型为主 |
| 二次开发 | 自由度最高 | 受限 |
| 形象 | 开发者工坊 | 精装成品 |
说白了,Claude Code 是精装房,拎包入住;DeepSeek Harness 是毛坯工坊,工具给齐了,但家具得你自己拼。
可能有人会问:v0.1 预览版,敢拿来当生产工具吗?
官方自己都标了 warning:项目迭代很快,会有不兼容的破坏性改动。尝鲜、学习、做二次开发完全没问题;追求稳定、要上生产,建议等版本收敛。
四、DeepSeek Harness 安装:一行命令跑起来
对一个刚开源的 v0.1 来说,DeepSeek Harness 安装简单得有点不像官方产品。
前置条件只有一个:装好 Node.js(具体版本以官方文档为准)。
方法一,npx 一行命令,尝鲜首选(适用于 dsh v0.1 开发者预览版,2026-08-13 发布):
npx @deepseek-ai/dsh web
跑起来后浏览器打开 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
dsh 命令行支持用 --profile 指定运行模式:标准模式、PTC 模式、极简模式、创造模式,各自默认加载不同的插件组合(具体 profile 名以官方 README 为准)。

如果 npx 卡住别慌,九成是网络问题——换 npm 镜像源,或者直接走方法二;Node 版本太老也可能报错,先确认版本。
可能有人会问:npx 半天装不上,卡在哪?
九成是网络问题。npx 要从 npm 拉包,网络不稳就慢;可以换国内 npm 镜像源,或者干脆用方法二 git clone。Node 版本太老也可能报错,先确认 Node 版本符合官方要求。
五、写在最后
说到底,DeepSeek Harness 的"一切皆插件",本质是把选择权交还给了开发者:换模型、换工具、换执行环境,甚至换 Agent 循环本身,都不再需要等官方发版。
我的判断是:现阶段它更适合爱折腾的开发者去尝鲜——想要什么,自己拼;如果你只想开箱即用地写代码,Claude Code 那类精装产品可能更省心。等 v0.2 或正式版把不兼容改动收敛下来,我会再补一篇深度评测。
对插件化 Agent 框架感兴趣的话,官方仓库(搜:DeepSeek Harness GitHub)和社区维护的 awesome-deepseek-harness 清单都值得逛逛。
我是晚安code,持续分享编程干货。觉得有用的话记得点赞收藏和关注~也欢迎在评论区聊聊:你更看好 DeepSeek Harness 这种"一切皆插件"的开源路线,还是 Claude Code 这种开箱即用的产品?