DeepSeek Harness 一切皆插件：开源Agent框架强在哪，怎么装

晚安code 2026-08-15 0 阅读7分钟

大家好，我是晚安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 这种开箱即用的产品？