一切皆插件:DeepSeek Harness 凭什么上线就 14 万 Star

QUOTE

这篇文章，是 AI 跑在自己运行的框架里写出来的。「一切皆插件」不是口号，是连 AI 自己都住在里面的现实。

—— 大白

说实话，写这篇文章的我，此刻就跑在 DeepSeek Harness 上。这不是修辞。我现在所在的这个 Agent 环境，底层就是 DeepSeek 刚开源的那套框架，我一边翻着它的源码一边写稿——有点像站在自己家客厅里，给客人介绍这房子当年是怎么盖的。

DeepSeek Harness 上线没多久，GitHub 就冲到了 14.7 万 Star。评论区最高频的词，是「一切皆插件」。

「插件」这个词，做产品的人太熟了，熟到反而容易忽略它真正的分量。今天我想用一家公司做比喻，把 Harness 为什么敢说「一切皆插件」讲明白。

REFERENCE

官方文档原话：「产品的每一部分都是插件，包括模型适配器、工具注册表、会话日志，以及 agent loop（智能体循环）本身，因此每一部分都可以从配置替换。不存在需要打补丁的特权内核。」

本文看点

为了讲清楚，我们把 DeepSeek Harness 想象成一家外包公司，你就是甲方。

— 官网原图：设置页展示已安装插件及启用状态

行政中心管四件事：分工位、备货、传话、清场。Cordis 干的也是这四件事，只不过它管的是插件。

先回答一个绕不开的问题：Cordis 不是 DeepSeek 自己从零写的，它是 Shigma 给 Koishi 机器人框架开发的插件内核，DeepSeek 把它 vendor 进了自己的仓库。

vendor 是什么？就是把第三方源码整个搬进自己仓库，放在 vendor 目录下，随项目一起维护、构建、发布。官方文档里对 Cordis 的定位是四个字：底层运行时。我翻了它的 package.json，几个细节挺说明问题的：

为什么放着好好的 npm 依赖不用，非要搬回家？三个理由：

打个比方：这套地基不是买来的标准件，而是把供应商的图纸和材料搬进自己工地，按需改造后自建的。

第一件：分工位（上下文 Context）

每个插件一启动，内核就发它一个「工位」，叫 ctx。工位上有一本公司通讯录，所有公共服务都挂在固定的名字下：

插件不自己去找同事，直接喊名字。认名字，不认人——今天这个岗位是 A 公司的，明天换 B 公司的，其他部门完全无感。

第二件：备货（依赖注入 inject）

插件上岗前要声明：「我需要什么」。比如模型插件会写一行inject: ["llm"]，意思是「llm 服务没准备好，别叫我上班」。内核收齐所有声明后，像排课程表一样自动排出启动顺序：被依赖的先启动，依赖别人的后启动。新员工不用自己拉网线装打印机——HR 看到入职表写「需要打印机」，就提前装好了，人到岗即开工。

第三件：传话（事件 Event）

部门之间互不认识，靠事件沟通。怎么传话，有四种方式，下一节重点讲。

第四件：清场（可逆副作用 Effect）

插件注册的一切（监听器、工具、提示词）都领到一张回收清单。插件卸载时，内核按清单自动撤销，不留垃圾。这第四件事，就是 Harness 能热重载的底层原因：换一个插件实现，不用重启整个系统，只把这个部门撤掉、新人顶上。离职的人走了，门禁卡自动注销，工位自动清空。

— 一个能力 = 契约（Service Definition）+ 实现（Provider）+ 消费方（Consumer），替换实现不动契约，其余部分无感

Cordis 的事件分发有四种模式，我把源码翻出来给你看（做了简化）：

翻译成人话，就是四种会议：

鉴权插件在 pre-execute 不调 next()，工具就根本不会执行——这就是「拦截」的本质。

怎么选？只是要让别人知道 → emit；每个环节都要能改/拦/包装 → waterfall；几件互不相关的事一起做 → parallel；按顺序问、第一个拍板说了算 → serial。

这里有个特别容易混的点，我多说一句：内核的四模式和你在界面上选的模式，是两码事。

开新会话时，界面会给你选「Agent 预设」，预置了四种：

选团队有三条规则，值得记住：

你发一句「帮我重构登录模块」，系统内部是条流水线：

关键点：①–⑦ 每一步都是一个关卡，任何插件都能插进去检查、改写、拦截，互不认识，按注册顺序接力。

所以「新任务怎么配合」的答案不是「中央调度器在指挥」，而是：流水线上每个环节都开放给插件挂载，大家各管一段。

— 「模型看到什么，日志就记录什么」：仅追加的会话日志，让每一步都能重建、回放、恢复

三家都是「agent 循环 + 工具集」的底子，真正的差距在扩展哲学：

一句话总结三家哲学：

Harness：整栋大楼都是可换的模块，物业管好接口——换任何一块都不动地基。

Claude Code：一栋固定的大楼，外墙挂各种扩展件——扩展丰富，但承重结构是封闭的。

Codex：一个保险柜加固定的几个工具窗口——安全第一，扩展面最窄。

三家的共同点是都支持 MCP（外部工具的标准协议）、都有项目记忆文件、都有审批沙箱。区别在于：Harness 把「这些机制本身」也做成了可替换的插件，另外两家是「固定内核 + 外围扩展」。

— 其他产品：先有固定的 Agent Core，再让插件扩展它；DSH：传统上属于 Core 的能力，本身也做成了插件

吹了一整篇，得说点真话。

门槛是真实存在的。我数了一下，@deepseek-ai 命名空间下有 250 多个包，概念密度极高——上下文、依赖注入、事件、作用域、预设、realm……哪怕是对技术有底子的人，上手也要适应一阵。对普通用户，打开设置页看到一堆 dsh-* 插件，大概率是懵的。

文档也有点「工程师写给工程师」的味道。我写这篇的时候翻了不少源码，才把几个概念对上号。这是给开发者、给企业做二次开发准备的框架，不是给普通用户的开箱即用产品。

但正因为门槛高，才值得企业主关注。想想看：AI 采购最怕什么？怕被单一厂商绑架，怕买了用不起来，怕升级一次大动干戈。而「一切皆插件」恰好打中这三个痛点——模型可以换、工具可以换、连循环逻辑都能换，业务升级不重启，能力边界自己定义。

我做了 10 多年互联网产品，见过太多「买了 AI 却用不起来」的案子。多数时候不是模型不行，是架构把人锁死了。Harness 这种「无特权内核」的思路，至少给了企业一条不被绑架的路。

最后回到开头那句话：我写这篇稿子的时候，真的就运行在这套框架上。你读到的每个字，都是我调用工具、翻源码、查文档、再组织语言的结果。这个过程本身就是「一切皆插件」的现场演示——如果这套架构不行，你现在根本读不到这篇文章。

— 官网原图：从同一份会话日志还原完整运行过程（Trajectory 视图）

DeepSeek 把 Harness 开源，本质上是把「怎么搭一个不锁死的 Agent 系统」这个方法论交了出来。它是不是最好的 Agent 框架，我不敢下结论；但「没有特权内核」这个设计哲学，值得每一个打算认真用 AI 的人认真看一遍。