DeepSeek Harness 的价值不在 Loop,而在运行时组合

摘要:DeepSeek Harness 值得研究的重点,是把 Agent 的组合关系做成运行时系统。Cordis 管当前能力拓扑,Session Log 管已发生事实,Agent Loop 在两者之间执行推理和工具调用。

组合复杂度已经超过 Loop 复杂度

Agent 产品化之后,最难维护的往往已经不是那条 loop。

图:运行时组合把插件拓扑、事实日志和执行循环连接起来

组 prompt、调模型、执行工具、回填结果,这条主循环并不复杂。

复杂的是另一件事:哪些能力在当前会话里生效,依赖谁,何时启动,怎么替换,谁负责清理,UI 和恢复逻辑又该相信哪一份状态。

DeepSeek Harness 值得研究的地方就在这里。它新增的是 Agent 组合关系的运行时系统:Cordis 管“系统现在由什么组成”,Session Log 管“系统刚才做过什么”,Agent Loop 连接这两条事实线。

最小 Agent Loop 只有四步:

  1. 1. 组装 prompt
  2. 2. 调用模型
  3. 3. 执行工具
  4. 4. 把结果送回模型

做 demo 时,这就够了。进入产品形态后,复杂度会转移到其他地方:多模型和凭证、工具审批、会话恢复、上下文压缩、沙箱与远程执行、多宿主、子 Agent、插件生命周期,以及 UI 如何观察同一份运行事实。

这时问题不再是“怎么写一个 loop”。真正的问题是“怎么知道当前 loop 具备哪些能力,以及这些能力从哪里来”。

Cordis 是横向事实面,回答系统当下由哪些 Profile、Bundle、Patch、Preset、Service、Fiber 和 Effect 组成。Session Log 是纵向事实面,保存用户消息、assistant 输出、模型流、tool call、tool result、turn 和 step。Agent Loop 夹在中间,一边读取当前能力,一边把执行过程写回事件流。

Cordis 把配置变成运行中的插件图

DSH 启动时,会把多层配置装配成插件树,而不是把一份静态配置读进内存就结束。

对象
作用
Bundle
分发一组 Cordis 配置和插件代码
Runtime Profile
决定进程堆叠哪些 Bundle,内置 web 和 headless
Patch
按配置行覆盖或插入能力,用于用户和命令行定制
Agent Preset
在会话作用域决定工具、提示词和局部能力组合

Loader 的输出是一棵运行中的插件树。源码 import 图只能说明“可能加载什么”,最终配置树才说明“当前机器和当前会话实际由什么组成”。

这让 Provider 替换从开发期改代码,变成部署期装配能力。前提是系统真的有清晰 seam:Service Definition、Provider、Consumer 三者要分开。

Consumer 依赖能力接口,Provider 提供实现,Definition 固定公共语义。只有做到这一步,替换才不是换个文件名。

Cordis 管生命周期所有权

普通插件表能注册工具,但很难表达作用域、依赖满足、Provider 替换和退出责任。Cordis 把这些关系放进运行时模型。

机制
解决的问题
边界
Context / Realm
决定当前作用域可以解析哪些 Service,支持会话或子树隔离同名能力
这是依赖可见性,不是操作系统级权限
Service
让 Consumer 依赖接口,而不是具体实现
Definition、Provider、Consumer 要齐全
Fiber
记录一次插件挂载的配置、依赖绑定、生命周期和资源所有权
Provider 变化可能触发一串卸载和重载
Effect
把监听器、进程、句柄、注册项和 disposer 归到同一生命周期节点
只能清理登记过的资源,不能回滚外部事务
Event
观察、决策或包裹请求、模型流、工具执行和停止流程
持久 Session Event 要和运行中事件分层

这里要特别注意安全边界。Context 的 inject 约束不是沙箱。

同进程代码仍然可能访问 Node API。不可信插件需要进程、虚拟机、WebAssembly 或容器级隔离。

Session 先追加事实,再投影上下…

— 以上为试看内容(约 40%),开通会员后阅读全文 —