学习路径
最后更新：2026-10-10
不知道从哪开始？按这条路线走：先把 Pi 跑起来，再理解它的设计，最后自己动手扩展。每个阶段都标注了预计耗时和要达到的目标。
一句话建议：不要试图一次读完所有文档。先完成第一阶段（约 40 分钟），有了体感再往下走，效率最高。
第一阶段 · 入门（约 40 分钟）
目标：本地跑起 Pi，理解"稳定的核心循环"这个核心思想。
🚀
1. 快速上手
克隆、安装、构建、启动编码代理。先让 Pi 在你机器上说话。
🧩
2. 总体架构
三层分工：交互层、运行层、核心循环。建立 Pi 的心智模型。
💡
3. 核心概念
消息、工具调用、会话与上下文压缩。读懂任意一层代码的基础。
✅ 完成标志：你能用一句话说出 Pi 的核心循环在干什么，并能在本地启动交互式编码代理。
第二阶段 · 动手（约 2 小时）
目标：写出自己的第一个 Agent，并给它加上自定义能力。
🤖
4. 写第一个 Agent
跟着教程从零创建一个能调用工具的 Agent，理解最小闭环。
🧰
5. 自定义工具
给 Agent 注册自己的工具：参数定义、执行与结果回写。
🧠
6. Session 管理
会话持久化、分支与断点续跑、上下文压缩策略。
✅ 完成标志：你写出了一个带自定义工具的 Agent，并能解释它的每一次工具调用是怎么发生的。
第三阶段 · 进阶（按需）
目标：按你的实际需求深入，不必全读。
- 要二次开发：读 核心包，了解 pi-ai / pi-agent-core / pi-coding-agent / pi-tui 的职责边界。
- 要接真实模型：读 模型供应商，配置 OpenAI / Anthropic / Google 等 API Key。
- 要部署排错：读 运行与调试，看权限模型与供应链加固。
- 要找灵感：看 用例与示例，再看 Pi vs 其他 理解 Pi 的定位。
- 要跟进上游：看 更新日志，了解 Pi 最近的重要变化。
常见问题
我完全没接触过 Agent，从哪开始？
直接从第一阶段开始。Pi 的设计对新手友好：先跑起来（快速上手），再理解为什么这样设计（架构与概念），不要一上来就读源码。
我有 LangChain / AutoGPT 经验，能跳过吗？
可以跳过第一阶段的前两步，但建议读一下"核心概念"——Pi 的会话树、上下文压缩与"运行时按需加载扩展"的设计，和常见框架不太一样。
学完需要多久？
第一阶段约 40 分钟，第二阶段约 2 小时。第三阶段按需查阅，不必一次读完。
