手册/第 03 章
03
运行时架构:14 个零件,16 条连接
前两章讲的是规则,这一章讲零件。下面这张图是 dsh 运行时主干: 从 profile 解析开始,到插件树里的服务互相找到对方为止。
这张图的画布是 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 / adapter | LlmAdapter 抽象 + 具体适配器;换厂商不动循环。 |
| 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