Skip to content

继续阅读与参考资料

读完本书后,下面这些材料能帮你走得更远。每条都注明了它与本书的关系。

Pi 官方资料

资料说明
Pi 仓库本书的研究对象。注意:main 分支会持续演进,与本书锁定版本(c13ffe18)可能有差异
本书锁定版本的源码树与书中所有引用完全一致的快照
pi.dev官网:演示与在线文档
仓库内 packages/coding-agent/docs/约 30 篇官方使用文档(quickstart、sessions、extensions、skills、rpc、sdk…)。本书的「官方说明」多出自这里,读原文可获得最新细节
仓库根 AGENTS.md / CONTRIBUTING.md面向贡献者(人类与 agent)的项目规则;想给 Pi 提交代码前必读

Pi 周边

资料说明
earendil-works/pi-chat官方的 Slack/聊天自动化项目,独立仓库
agegr/pi-web第三方社区 Web UI(本书未分析其源码,与锁定版本的兼容性未确认)
badlogic/pi-share-hf官方 README 推荐的会话分享工具:把你的 OSS 编码会话发布到 Hugging Face
badlogicgames/pi-mono 数据集作者公开的真实工作会话数据——大量「Agent 实战录像」,是极好的学习材料

语言与运行时

  • TypeScript 官方手册(typescriptlang.org/docs):本书第二部分只覆盖了理解 Pi 所需的子集;系统学习以官方手册为准。
  • Node.js 官方文档(nodejs.org/docs):node:fsnode:pathnode:test 等 API 的权威参考。
  • MDN Web Docs:Promise、迭代协议、AbortController 等标准语言特性的最佳解释。

Agent 方向

  • 各家模型 API 文档(Anthropic / OpenAI / Google):Tool Use、Streaming 章节值得对照 Pi 的统一抽象来读——你会更理解 pi-ai 抹平了多少差异。
  • bojieli/ai-agent-book:一本开源的 Agent 主题网页书。本书在「网页书的信息组织与实验编排」上参考了它的形式(技术栈不同:它用 MkDocs,本书用 VitePress);其内容与 Pi 无关。
  • MCP(Model Context Protocol):Agent 工具生态的开放协议。Pi 锁定版本的内置机制是自有的 Extension/Skill 体系,学习 MCP 有助于理解行业内不同的扩展设计取舍。

接下来做什么

  1. 把 Mini Harness 改成你自己的:加一个新工具、换一种 Session 格式、接一个本书没接过的 Provider——8.6 的 StreamFn 抽象让这些都成为局部改动。
  2. 给 Pi 写一个真正的 Extension:从 7.1 的最小示例出发,解决一个你日常的真实需求。
  3. 读一次新版 Pi 的 diffgit log c13ffe18..origin/main --oneline 看看世界在你学习期间前进了多少——你现在有能力读懂这些提交了。

本书分析的 Pi 版本:earendil-works/pi@c13ffe1(2026-07-30)