阅读地图

阅读契约： 用本页先选择阅读深度。反复追问一个用户请求如何穿过 operations、turns、model streams、tools、durable events 和 client projections。

本书的目标是提供源码支撑的理解。你仍然可以打开固定到 commit 的源码链接，但主阅读路径应该在不需要同时打开仓库的情况下讲清系统。

两条阅读路径

默认路径是第一条。源码链接是证据，不是作业。

30 分钟路径

需要快速建立心智模型时，按这个顺序读：

1. 读首页 thesis 和架构图。
2. 读第 4 章，掌握协议词汇。
3. 读第 5 章，理解 threads、sessions 和持久状态。
4. 读第 6 章，理解 turn loop。
5. 读第 9 章、第 12 章和 第 13 章，理解工具暴露、审批与 containment。
6. 读第 14 章，理解 app-server 作为多客户端边界。
7. 最后读结语，提炼可迁移的设计经验。

读完后，你应该能解释一个用户请求如何变成协议 operation、被调度的 turn、 模型流、一次或多次受监督工具调用、审批或沙箱决策、持久事件，以及客户端可见输出。

2 小时路径

如果你想不打开源码也获得接近源码读者的知识，按这个顺序读：

1. 读前言，然后按顺序读第 1-8 章，建立契约、运行时、模型和可观测性主干。
2. 按顺序读第 9-16 章，理解副作用执行和暴露运行时的客户端 surface。
3. 读第 17-22 章，理解扩展平面、迁移、多 agent 协调、云任务、身份和 memory。
4. 读第 23-25 章和结语，理解构建、发布、打包、CI 与治理如何保持架构不漂移。
5. 用模式索引、源码索引和 实现参考作为参考表。

这条路径的目标是理解稳定实现事实和设计理由，而不是背文件名。

源码审计路径

只有当你想验证本书和源码是否一致时，才需要这条路径：

1. 先读一遍源码索引，掌握仓库词汇。
2. 只打开每章 source map 或 evidence table 中列出的链接。
3. 用这些文件验证章节图和源码地图中的主张。
4. 如果正文无法支撑结论，应当把它视为书的问题，而不是读者少读了源码。

贯穿全书的审计问题

当章节描述一个子系统时，回答四个问题：

如果你能回答主要子系统的这些问题，就已经达到了本书承诺的理解层次。