DeepSeek Harness · 代码模块地图

基于源码 packages/ 的真实依赖关系 · 静态二维网络

核心主干 能力 seam 数据与状态 应用与协作 基础设施

🧬 核心主干:产品 API 的「脊椎」

这 7 个包是 Harness 的主干,图上以 蓝色标出;开启「核心主干数据流」可看到 session → 提示词 → 工具 → agent → 循环 → llm 的引导连线。

🔌 能力 seam:插座 · 插头 · 电器

一项「可替换能力」由三种角色组成。以「Shell 执行」为例:

Service Definition · 接口dsh-shell
声明「能执行命令」的契约
Service Provider · 实现dsh-bash-local · dsh-bash-sandbox
本地 / 沙箱两种实现
Consumer · 使用方dsh-tool-bash
面向模型的 bash 工具

铁律:扩展插件依赖接口,绝不依赖某家具体实现 —— 换一个 Provider,整个产品就跟着变。

📡 事件:四种「喊法」

emit · 广播

喊完就走,通知所有监听器,不等待、无返回值。

waterfall · 接力

传话接力,喊 next() 才传下家;不喊就是「半路截胡」。

parallel · 并行

同时通知所有监听器并行执行,等全部完成才继续。

serial · 串行

按注册顺序一个个来,前一个完成才轮到下一个。

🗂️ 全部模块分组

点击任意分组,图上会聚焦该分组的模块。