earendil-works/pi 自带 97 个 markdown 文件、共 32945 行文档，写得比多数开源项目都好。所以本书不复述文档。它的全部价值来自三件文档做不到的事：
path:line，并且有校验器逐条核对该行的实际内容。| 徽章 | 含义 | 判定方式 |
|---|---|---|
| 已发布 | 该章描述的代码在 HEAD 上被 packages/coding-agent 实际执行 | 从生产入口的构造点追调用链 |
| 部分落地 | 类型/接口/测试已存在，但主要操作路径仍抛错或未接线 | 指出抛错点或未接线证据 |
| 仅设计文档 | 只存在于 docs/*.md，代码中无对应实现 | grep 无实现 |
每个徽章在 data/status.json 里有对应条目，含 path:line 证据；校验器会核对页面徽章文案与该文件一致，且每条证据指向的行确实包含预期内容。徽章不是印象，是可核对的判定。
repo: https://github.com/earendil-works/pi
SHA: ac4ac9eaf69f2b01ca3af984a5c48f3b99b84278
date: 2026-08-07
速度: 约 428 commits/月↪ path:line 链接都指向该 SHA 的 blob，点开即是当时的原文。path:line）。| 标签 | 含义 |
|---|---|
| 原文 L582–L584 | 逐字摘自该行区间。可能并置多个不连续区间（会写明） |
| 改写自 L167–L274 | 为讲解压缩过：合并行、省略参数。脚注会说明改了什么 |
这个区分是硬性的。本书的前提是「我们读代码」，把改写过的块标成「节选」是唯一不可犯的错。
| 你是… | 建议路线 |
|---|---|
| 想造自己的 agent harness | 03 → 04 → 05 → 06 → 07 → 20 |
| 在评估要不要依赖 pi | 08（实现状态）→ 15（安全模型）→ 20 §4（未结算的赌注） |
| 关心 agent 时代的 OSS 治理 | 17 → 18 → 19 |
| 只有 20 分钟 | 第 20 章，然后按它的交叉引用回头看 |
每章的 §1 一句话心智模型 都是自足的——只读全书 21 个 §1，也能得到一幅完整但粗颗粒的图。
ac4ac9e（2026-08-07 快照）。