Skip to main content

动手学 Pi

从一条离线轨迹开始,亲手实现一个 Pi-style coding agent。 这是社区原创的非官方课程《动手学 Pi》(pi-textbook)的中文教材。课程沿 15 个可运行 checkpoint,从一条离线 Agent 轨迹出发,逐步实现: TypeScript 协议 → 流式模型 → Provider → 工具 → Agent Loop → 会话树 → Context Compaction → 扩展 → Eval 每章由四部分闭环:教材正文 + 真实 commit + 聚焦测试 + 故障实验。课程代码不是伪代码演示,而是一条可以 checkout、运行和验证的 Git 历史。

内容速览(Checkpoint 00–14)

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

开始阅读

直接打开在线教材,或在本地运行:

和 Agent 一起练习

课程代码位于 pi 的课程分支packages/pi-course/,从固定上游 commit 8479bd84 出发,以 course(00)course(14) 组织完整历史。
checkpoint 定位本章的 parent、target 与聚焦测试;practice 创建一个不含答案和 Git 历史的练习目录。把本章网页、命令输出与练习目录中的 LEARNING.md 一起交给陪学 Agent 即可。

教材与课程代码

许可

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