动手学 Pi：从 15 个 Checkpoints 搭建 Coding Agent 的实践教材（含在线教材与 GitHub）

通过将 Agent 拆解为 15 个可运行的检查点，逐步搭建 Coding Agent 的实践教材，适合从底层理解实现细节的学习者。

概要

《动手学 Pi》是一套实践性教材，专为想自行搭建 Coding Agent 的人设计，帮助你从第一步落地，而不是直接抄最终代码。与大多教程只给伪代码不同，它把整个 Agent 拆解为 15 个可实际运行的 checkpoint，逐步搭建系统。

学习路径

• 从 TypeScript 协议与事件流入手，逐步接上：模型、Provider、工具调用
• 进入 Agent Loop、会话状态、上下文压缩等阶段
• 最后扩展机制与 Eval 的实现

为什么适合你

• 每个阶段都给出真实的 Git commit、测试与故障实验
• 你可以直接 checkout 某一步，运行、改代码，并查看问题原因
• 实践性强，比单纯看架构图更易理解底层跑起来的原理

资源

• 在线教材：
• GitHub：https://github.com/hahhforest/pi-textbook

使用建议

• 以自驱动的方式逐步完成每个 checkpoint
• 结合实际编码练习，理解 Agent Loop 与上下文管理
• 记录每一步的遇到的问题与解决方案，形成个人笔记