附录 B:图示 — 把运行时结构画出来
出处
来源:原网页 · 状态:已读 · PDF:book1-claude-code.pdf p.81–92(图多,文字少)
一句话
文字能说清楚,但有些东西画成图以后会更快意识到:Claude Code 是一套相当明确的状态机,不只是「一团 prompt 加几个工具」。
核心概念
PDF 里的图(建议对着原 PDF / 在线版看,文字转写丢失布局):
| 图 | 主题 | 对应章节 |
|---|---|---|
| 图 1 | Query Loop Core | 第 3 章 |
| 图 2 | QueryEngine Turn Flow | 第 3 章 |
| 图 3 | QueryEngine State Carry-Over | 第 3 章 |
| 图 4 | Permission Decision Layers | 第 4 章 |
| 图 5 | Tool Execution Lifecycle | 第 4 章 |
| 图 6 | Recovery Decision Paths | 第 6 章 |
| 图 7 | Compact Fallbacks | 第 6 章 |
| 图 8 | Multi-Agent Runtime Lifecycle | 第 7 章 |
| 图 9 | 总体控制面 | 附录 B.1 |
| 图 10 | Query Loop 主循环 | 附录 B.2 |
| 图 11 | Query Loop 恢复分支 | 附录 B.2 |
| 图 12 | Tool Batch Ordering | 附录 B.3 |
| 图 13 | StreamingToolExecutor Lifecycle | 附录 B.3 |
| 图 14 | Context Sources And Budget | 附录 B.4 |
| 图 15 | Compact Rebuild Pipeline | 附录 B.4 |
| 图 16 | Coordinator And Worker Flow | 附录 B.5 |
| 图 17 | Verification Separation | 附录 B.5 |
| 图 18 | 团队治理图 | 附录 B.6 |
六组结构:
- 总体控制面:prompt 装配、query loop、tool/permission、context、recovery、multi-agent、team hooks 围成一张图
- Query Loop 主循环与恢复分支:输入治理 → 流式模型 → 工具 / 恢复 / 停止矩阵
- Tool Batch Ordering 与 StreamingToolExecutor:并发分批、顺序回放、中断与 synthetic result
- Context Sources 与 Compact Rebuild:CLAUDE.md / memory / session memory / compact 重建工作语义
- Coordinator-Worker 与 Verification Separation:research / impl / verify 分容器,synthesis 不可外包
- 团队治理图:CLAUDE.md、approval、skill、hook、基线复盘 vs 高阶审计
关键洞察
图不是装饰。它们把「状态机」从口号变成可指认的边和节点:哪里分叉、哪里熔断、哪里必须补账。读笔记时若某章觉得抽象,对着对应图看一遍会快很多。
个人思考
在线版比 PDF 更适合看这些图。本地 PDF 路径:03-HarnessEngineering/Book1-ClaudeCode/book1-claude-code.pdf。