DeepSeek Harness 学习手册 第 03 / 11 章 总目录 单页全本 架构图 GitHub

手册/第 03 章

03

运行时架构:14 个零件,16 条连接

前两章讲的是规则,这一章讲零件。下面这张图是 dsh 运行时主干: 从 profile 解析开始,到插件树里的服务互相找到对方为止。

dsh 运行时架构 · 14 components / 16 edges / 5 cards 新窗口 ↗

这张图的画布是 1510px 宽,在内嵌栏里 1× 会把最小字号压到约 3.7px,基本无法阅读。 请点 2×(约 7.9px)或直接用「新窗口 ↗」。这是画布密度与阅读栏宽的物理冲突,不是渲染问题。

怎么读这张图

区块它是什么
boot / app-boot不在树里——它是「树的构建者」:解析 profile、叠 patch、按 inject 拓扑挂载、审计启动条目。
插件树(虚线框内)运行中的 dsh 本体。框内每个节点都是插件,都通过 ctx 注册。
core 服务session / tools / system-prompt / agent-loop / agent registry——循环与状态的所在地。
exec(沙箱 · fs · subprocess)一个合并节点:三者共享同一个执行世界,拆开画会误导。
llm / adapterLlmAdapter 抽象 + 具体适配器;换厂商不动循环。
web app浏览器前端(packages/client,17 万行),只是插件树上的一支。

四个画图时做的判断

Ⅰ把 boot 移出插件树
第一版把 app-boot 画进了框里,校验器报「非成员落在 frame 内」。 但这不是排版问题,是语义问题:boot 是把树搭起来的那双手,不是树上的节点。
Ⅱ把 sandbox / fs / subprocess 合成一个节点
它们共享同一执行世界:把 fs 指向远端沙箱,Bash、PTY、LSP 会一起搬走。 画成三个节点会让人以为可以单独替换其中一个。
ⅢMCP 接的是 tools,不是 core
原本画了一条 registry → tools,那条线穿过了 prompt 与 loop, 且与 loop ↔ llm 共用走廊。改成 tools → mcp: MCP 客户端的 inject 就是 ['tools'],语义更准。
Ⅳ只画主干,不画全
363 个包里上图的是 14 个(按能力分层,不按包数量)。goal / schedule / jobs / spill / agent-team 等都没有画——它们的接入方式与图上已有节点同构, 画上去只会让主干难以辨认。
这张图的校验状态 Archify v3.2 产出:validate 0 error / 0 warning, finalize --browser-check 全部 pass,visual-check 带 provenance 校验通过。 每个组件与连接都绑定 path:line,行号逐条核对过。

app-boot/src/index.ts:317 · reconcileProfilePatches agent-loop/src/index.ts:291 · class AgentLoop llm/src/index.ts:208 · abstract class LlmAdapter

本章学习记录

记录仅保存在当前浏览器。