1. 前言
5. 序章
6. 1. 不是又一个 LLM 包装器
8. 第一篇：分层的纪律
9. 2. 七个包不是七个项目
10. 3. 怎样高效阅读这个仓库
12. 第二篇：统一调用面 — pi-ai 的设计
13. 4. Provider 不是 Adapter
14. 5. 消息变换：跨模型交接的隐藏复杂度
15. 6. 统一事件流设计
16. 7. OAuth — 统一认证的隐藏复杂度
18. 第三篇：Agent Runtime — 循环引擎的设计
19. 8. agentLoop — 发动机只管转
20. 9. 工具执行不是插件调用
21. 10. Agent — 循环之上的有状态壳
23. 第四篇：从 Runtime 到产品
24. 11. 会话树：比"聊天记录"更好的数据模型
25. 12. Compaction — 把无限对话装进有限窗口
26. 13. 三级配置覆盖
27. 14. System Prompt 是一套装配流程
29. 第五篇：能力外置
30. 15. Extension 系统 — 让产品长出新器官
31. 16. Skill 机制 — 用文档替代代码
32. 17. Resource Loader — 一切外部资源的统一入口
33. 18. Model Registry — 模型不只是一个 ID
35. 第六篇：工具设计 — 约束即保护
36. 19. 工具设计原则
37. 20. edit 的设计 — 为什么不能直接写文件
38. 21. read 的设计 — 为什么不是简单的 cat
39. 22. bash 与外部世界的边界
40. 23. find 和 grep — 结构化搜索替代万能 bash
42. 第七篇：UI 层 — 同一颗内核的不同宿主
43. 24. pi-tui — 在终端里做应用
44. 25. 编辑器组件 — 交互复杂度的集中地
45. 26. RPC 模式 — pi 作为后端服务
46. 27. pi-web-ui — 浏览器里的复用
48. 第八篇：产品化实证
49. 28. mom — Slack 里的 Coding Agent
50. 29. pods — 为什么这个仓库还要管 GPU
52. 第九篇：设计哲学
53. 30. 极简核心，能力外置
54. 31. 反主流选择背后的判断
55. 32. 这套架构的适用边界
58. 附录