Pi Agent 架构书

一本中文架构书的在线阅读工作区，对象是 pi 仓库的 packages/agent，即一个 agent 循环如何被做成一个库。

全书从代码出发，讲清楚 @earendil-works/pi-agent-core 承诺什么、拒绝什么、支点在哪里。代码引用写成「文件:行号」格式，每个引用就地附上引文，读者无需打开编辑器也能核对书中任何一处论断。

内容组织为整体→局部→横切三部分。第一部分建立对整个系统的正确认知，不碰实现细节，读完应能凭记忆画出系统架构。第二部分按依赖顺序展开各部件。第三部分处理不属于任何单一部件的问题。

阅读方式：Web 在线版（books.antinomie.org/pi，代码引文高亮可切换中/EN/ES）或下载 Markdown 版配合 AI 阅读。中文原稿为唯一内容源头，英文和西班牙文为译本。