pi-textbook
从零构建Pi风格Coding Agent的实战教材
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
从零构建Pi风格Coding Agent的实战教材
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
《动手学 Pi》是一份面向开发者的中文技术实战教材，系统性讲解如何从零构建一个 Pi 风格的 AI Coding Agent。不同于纸上谈兵的伪代码演示，本教程沿一条真实的 Git 提交历史展开——每个章节对应一个可 checkout 的 checkpoint，配有完整可运行的代码、聚焦测试用例和故障实验。教程目前已在 GitHub 获得 509 颗星，31 个 Fork，广受中文开发者社区认可。
项目主体为一套基于 Next.js 16 + React 19 + Tailwind CSS 4 构建的交互式 Web 教材网站。底层采用 vinext（Cloudflare Workers 开发框架） 提供 SSR 服务，数据库层使用 Drizzle ORM 对接 Cloudflare D1（SQLite 边缘数据库），文件存储则对接 Cloudflare R2。课程配套代码托管在独立仓库 hahhforest/pi（分支 course/build-your-own-pi），从固定上游 commit 8479bd84 开始，以 course(00) 到 course(14) 标签顺序承载 15 个渐进式 Checkpoint。
Pi-style Agent 的核心架构沿以下链路分层构建：
| 层次 | Checkpoint | 关键技术 |
|---|---|---|
| 模型与协议（I） | 01–05 | TypeScript 协议类型、EventStream 流式事件、Message IR、ScriptedModel、Provider Adapter |
| 工具与循环（II） | 06–08 | 工具 schema、Registry、Executor、Agent Loop（两轮对话） |
| 状态与历史（III） | 09–11 | 有状态 Agent、Session Tree（JSONL）、Context Compaction |
| 扩展与验证（IV） | 12–14 | Skill/模板注册、Runtime 组合、Eval 评测框架 |
项目内置完整的质量保障机制：
本项目不提供 Docker 容器化，但部署流程极为简洁：
git clone https://github.com/hahhforest/pi-textbook.git
cd pi-textbook
npm install
npm run dev
硬件需求：仅需 CPU（推荐 4GB+ 内存），无需 GPU。依赖 Node.js >= 22.13.0。生产部署推荐使用 Cloudflare Pages 或 Workers。
配套课程代码部署：
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