hahhforest/pi-textbook

解决的问题

本项目为开发者提供了一条实践性的、循序渐进的教育路径，从零开始构建一个功能性的Pi风格编码代理。它通过一系列15个可验证的代码检查点，弥合了理论代理概念与实际实现之间的差距。

工作原理

该课程组织为15个基于Git的检查点，将一个简单的离线追踪演变为一个完全可操作的编码代理。每一章由四个集成组件组成：解释性文本、实际的Git提交、重点单元测试以及故障排除实验。学习者通过实现TypeScript协议、流式模型、工具注册表、代理循环、会话管理和评估框架来逐步掌握架构。

适用人群

本课程专为想要了解编码代理内部机制的开发者设计。对于那些更喜欢通过代码历史、测试和实践实验而不是阅读抽象文档来学习的人来说，这是理想的选择。

亮点

• 15个渐进式检查点，涵盖代理的完整生命周期（从协议定义到评估）。
• 真实的、可运行的代码历史，可以通过Git检出并验证。
• 集成的“练习”模式，允许用户在不查看最终实现的情况下进行练习。
• 全面覆盖关键代理主题，包括上下文压缩、会话树和工具使用契约。