资源与学习路线
本教程共 30 篇 · 第 30 篇 · 更新于 2026-08-10 · 约 10 分钟阅读
本节目标：拿到 pi 生态的全景地图——官方资源、社区渠道在哪，从入门到精通的进阶路线怎么走，学完这本书之后下一步可以往哪个方向深入。
这一章不教新东西。它是地图——帮你搞清楚 pi 的世界有多大、你走到了哪、接下来往哪走。
本章基于 pi v0.84.1。
官方资源
第一个要记住的地址：
| 资源 | 地址 | 说明 |
|---|---|---|
| GitHub 主仓库 | github.com/earendil-works/pi | monorepo，包含所有核心包和官方文档 |
| npm 包 | @earendil-works/pi-coding-agent | 发布页，版本历史 |
| 官方文档 | 仓库 docs/ 目录 | usage、settings、sessions、packages 等 |
| 作者博客 | mariozechner.at | pi 的设计哲学和动机 |
| 更新日志 | /changelog 命令或仓库 CHANGELOG.md | 每个版本改了什么 |
| 模型目录 | pi --list-models | 随时刷新：pi update --models |
Tip遇到问题时，优先搜 GitHub Issues。大概率别人也踩过同样的坑——而且解答比搜索引擎靠谱。
社区渠道
pi 的社区目前比较小而活跃：
| 渠道 | 说明 |
|---|---|
| GitHub Issues | Bug 报告、功能请求、使用问题——最直接的沟通方式 |
| GitHub Discussions | 经验分享、最佳实践讨论 |
| 作者 Twitter/X: @badlogic | 版本更新公告和设计思路 |
| 开源贡献 | PR、Issue 讨论、文档改进 |
pi 没有 Discord 或 Slack（设计哲学是保持核心小而精）。社区互动主要发生在 GitHub 上。
本书阅读路径
这 30 章不是非得从第 1 章读到第 30 章。根据你的需求，可以这样跳着读：
路径一：我想快速上手（1-2 天）
第 1 章 → 第 2 章 → 第 3 章 → 第 4 章
初识 pi 安装配置 认证模型 第一次实战对话读完这四章，你就能用 pi 写代码、改 bug、解释代码了。够日常 80% 的需求。
路径二：我想当主力工具用（1 周）
路径一 → 第 5 章 → 第 6 章 → 第 7 章 → 第 8 章 → 第 24 章
交互模式 非交互模式 上下文管理 会话管理 压缩加上交互模式的熟练使用、脚本集成和理解上下文机制。用一周把这些消化了，pi 就是你的日常编码搭档了。
路径三：我想精调 pi 适配自己的项目（2 周）
路径二 → 第 9 章 → 第 10 章 → 第 11 章 → 第 12 章
配置大全 Providers AGENTS.md Skills配置好全局和项目级的 settings、接入多个模型提供商、写好项目的 AGENTS.md 和 skills。让 pi 真正懂你的项目。
路径四：我想深度定制和扩展（1 个月）
路径三 → 第 13-19 章（安全/主题/快捷键/扩展/工具/事件/包管理）
→ 第 20-21 章（RPC/SDK）
→ 第 22-23 章（部署/本地模型）学会写 extension、自定义工具、事件监听，用 RPC 和 SDK 把 pi 嵌入自己的程序，部署到服务器上用本地模型离线跑。
路径五：查资料用（随用随翻）
第 27 章 → 第 28 章 → 第 29 章
命令速查 配置速查 问题排查这三章是参考手册——不需要从头读。遇到命令忘了、配置项不确定、报错不会修的时候翻开对应章节就行。
学习路线图
一张图看清从入门到精通的路径：
graph TD
A[📖 入门基础] --> A1[1. 初识 pi]
A --> A2[2. 安装配置]
A --> A3[3. 认证模型]
A --> A4[4. 第一次对话]
A --> B[🔧 日常使用]
B --> B1[5. 交互模式]
B --> B2[6. 非交互/脚本]
B --> B3[7. 上下文管理]
B --> B4[8. 会话管理]
B --> B5[24. 上下文压缩]
B --> C[⚙️ 配置定制]
C --> C1[9. settings.json]
C --> C2[10. 多 Provider]
C --> C3[11. AGENTS.md]
C --> C4[12. Skills]
C --> D[🚀 进阶扩展]
D --> D1[13. 安全信任]
D --> D2[16. Extensions]
D --> D3[17. 自定义工具]
D --> D4[18. 事件系统]
D --> D5[19. 包管理]
D --> E[🏗️ 架构集成]
E --> E1[20. RPC 模式]
E --> E2[21. SDK 编程]
E --> E3[22. 部署容器化]
E --> E4[23. 本地模型]
E --> F[📚 参考篇]
F --> F1[27. CLI 速查]
F --> F2[28. 配置速查]
F --> F3[29. 问题排查]
style A fill:#4a90d9,color:#fff
style B fill:#50b86c,color:#fff
style C fill:#e6a23c,color:#fff
style D fill:#e05d44,color:#fff
style E fill:#8b5cf6,color:#fff
style F fill:#64748b,color:#fff从蓝到灰——颜色越深，内容越深。你的位置在哪，就从哪开始。
下一步学什么
学完这本书，你已经掌握了 pi 的全部用户向能力。接下来的方向取决于你的兴趣：
方向一：成为 pi 扩展开发者
pi 的精髓在扩展。写 extension 你可以：
- 造一个自动审查代码规范的 tool，每次提交前 pi 自动跑
- 接入内部 API——让 pi 直接查 Jira、读 Confluence
- 定制 pi 的行为——项目启动时自动加载公司规范，不符合的直接拦截
从第 16 章（Extensions 入门）和第 17 章（自定义工具开发）开始动手。pi 的扩展 API 很小但很灵活——学会了写 TypeScript 就能写 extension。
方向二：用 SDK 把 pi 嵌进自己的应用
如果你的产品需要一个 AI 编码助手内核，pi 的 RPC 模式 + SDK 是现成的底座。第 20-21 章讲了怎么用 JSONL 协议驱动 pi 完成复杂任务。
实际场景：
- CI/CD 流水线里自动审查 PR 代码
- 内部开发平台给每个项目配一个 pi 实例
- 把你的 SaaS 产品的”AI 助手”功能基于 pi 构建
方向三：参与 pi 开源贡献
pi 是开源项目（monorepo、TypeScript），代码质量很高但文档和生态还在早期。贡献方向：
- 文档：翻译、教程、示例——中文社区尤其缺
- Bug 修复：GitHub Issues 里找
good first issue标签 - Extension 生态：把常用能力打包成 extension 分享出去
- 模型适配：接入新的 AI 提供商
起步三步：
# 1. clone 仓库
git clone https://github.com/earendil-works/pi
cd pi
# 2. 装依赖并构建
npm install
npm run build
# 3. 从源码运行
./pi-test.sh方向四：搭建本地模型工作流
不想把所有代码发给云端？第 23 章讲了怎么用 llama.cpp 离线跑 pi。方向：
- 用
lmstudio或ollama管理本地模型 - 调优
thinkingBudgets和compaction适配本地模型的小上下文窗口 - 配一个本地知识库 + RAG，让 pi 回答问题时不需联网
最后的建议
pi 是一个很年轻的工具——2025 年底才发布，到 0.84.1 迭代了不到一年。它的设计哲学和很多 AI 编码工具有本质区别：
pi 不试图做一切。 它把核心做小——一个可靠的 Agent Loop、一套干净的 TUI——然后把定制权交给你。MCP、sub-agent、plan mode、todo list 这些它都没有内置，但你可以用 extension 自己加。
这种哲学意味着：pi 的上限取决于你的投入。只装好就用，它是好用的编码助手。花两天写几个 extension 和 AGENTS.md，它就变成你的专属工具。
从这 30 章开始，剩下的路自己走。