白皮书 / 报告Agent 设计
Pi Agent 源码教程：从 Agent Loop 到上下文工程的 10 章拆解
Pi Agent source tutorial: ten chapters from the Agent Loop to context engineering
一份以 Pi Agent（OpenClaw 等产品的运行时基础）源码为线索的中文教程，10 章从三层架构、Agent Loop、模型调用、工具系统讲到消息、事件驱动、上下文工程、上下文压缩和会话管理，每章有 TypeScript 与 Python 对照实现。阿蔺在 X 上推荐，作者冬瓜。
要点
- Pi 是"真正能上线"的 Agent 参考实现，读它比读玩具框架更接近生产环境里的取舍。
- Agent Loop 一章有可执行 notebook，先跑最小循环再逐步加工具、会话和压缩，理解顺序对。
- 上下文工程和上下文压缩各占一章：怎么在有限窗口里维持无限对话，是自己做 Agent 最常踩的坑。
- 双语实现方便对照：TS 版贴近 Pi 原码，Python 版适合做实验。
- 网站版有三栏阅读和主题切换，代码 MIT、文档 CC-BY-SA。
