想自己写一个编码 Agent，原理文章没少看，一动手就卡在第一行。

最近发现《动手学 Pi》这本中文教程，从一段真实的离线 Agent 日志开始，带你把 15 个关卡从头过一遍。

真正从零撸一个完整的编码 Agent，每一步都有可运行的代码，拉下来就能验证。

消息和模型协议 → 工具与 Agent 循环 → 会话树存储 → 上下文压缩 → 组装运行时跑评测。

每章配齐四样：正文、对应提交、聚焦测试、故障实验。

练习目录一行命令生成，不带答案，把说明扔给 AI 当陪练就行。

：https://github.com/hahhforest/pi-textbook…

hahhforest/pi-textbook

Source: https://github.com/hahhforest/pi-textbook

简体中文 · English

动手学 Pi

沿 15 个 checkpoint，从一条离线轨迹开始，亲手实现一个 Pi-style coding agent。

在线阅读 · 课程代码

这是什么

沿 15 个可运行 checkpoint，从一条离线 Agent 轨迹出发，逐步实现：

TypeScript 协议 → 流式模型 → Provider → 工具 → Agent Loop → 会话树 → Context Compaction → 扩展 → Eval

每章由四部分闭环：教材正文 + 真实 commit + 聚焦测试 + 故障实验。课程代码不是伪代码演示，而是一条可以 checkout、运行和验证的 Git 历史。

内容速览（Checkpoint 00–14）

15 个 checkpoint 沿同一条 Agent 执行链逐层推进：先建立消息与模型协议，再接入工具和循环，随后保存状态与历史，最后组合 Runtime 并用独立评测验收。

开始阅读

直接打开在线教材，或在本地运行：

git clone https://github.com/hahhforest/pi-textbook.git
cd pi-textbook
npm install
npm run dev

教材与课程代码

课程分支从固定上游 commit 8479bd84 出发，以 course(00) 到 course(14) 组织完整历史；pi-course-v1 与 course-v1/00 到 course-v1/14 tags 固定第一版课程。

和 Agent 一起练习

git clone --branch course/build-your-own-pi https://github.com/hahhforest/pi.git
cd pi
npm install
npm run checkpoint -w @pi/course -- 05
npm run practice -w @pi/course -- 05 ../pi-practice-05

checkpoint 定位本章的 parent、target 与聚焦测试；practice 创建一个不含答案和 Git 历史的练习目录。把本章网页、命令输出与练习目录中的 LEARNING.md 一起交给陪学 Agent 即可。

项目说明

这是社区原创的非官方课程，不隶属于或代表 Pi / Earendil Works。应用与原创代码采用 MIT License；教材正文与原创媒体采用 CC BY 4.0；Pi 上游代码沿用其原许可证和作者归属。详见 LICENSE 与 LICENSE-CONTENT。

构建、测试和跨仓库历史校验见 CONTRIBUTING.md。

感谢 LINUX DO 提供中文技术交流空间。