CORE CURRICULUM · 5 个模块 · 14 课 + 原理篇
蓝皮书主线
这部分负责完整、连续、经过核验的学习过程。想先动手，从30 分钟第一次成功选择平台入口；想系统阅读，再从导论、凡例和序章进入。已经能够安装、登录并正常使用 Pi 的读者，可以从第二模块进入真实任务。
个人推文和使用感悟不会直接当作教程结论。能够进入主线的内容，需要重新检查来源、操作方式、风险边界与成功信号。每个模块同时标出配套实操与延伸阅读，但它们不会打断主线顺序。做完基础案例后，可选内容整理或小型代码修复，练习把同一方法迁移到其他任务。
开篇 · 先知道为什么读
导论说明 Pi 的位置、中文初学者的真实门槛和本版主张；十条判断把个人学习记录中经受住后续实践的部分蒸馏进书；凡例则固定平台路径、核验日期、维护方式和版权边界。
序章 · 先认识做出 Pi 的人
Mario Zechner 的完整职业时间线从 2009 年的 AFX 与 libGDX 写起，经过 RoboVM、独立开发和 Coding Agent 实践，再走到 2026 年的 Pi 与 Earendil。它不是安装前置条件，但能帮助你理解 Pi 为什么保持极简、开放和可扩展。
模块一 · 安装与基础设置
Windows 用户从这里开始
先完成 Windows 中文路径：安装并启动 Pi，通过页面验收后直接接入第 3 课。后续看到“普通终端”时继续使用 Git Bash，并按页面里的对照表替换练习目录和指纹命令。
完成标志： 能在独立练习目录启动 Pi，并获得一次真实回复。
安装完成后不必立即停下来学习维护命令；需要升级、换账号、卸载或处理本地数据时，进入 安装后生命周期管理。
模块二 · 完成真实任务
完成标志： 能独立检查输入材料、输出文件和任务要求，不让 Agent 给自己打分。
配套内容：CASE 01 · 把会议记录整理成行动清单 · 授权译文：无法随身带走的会话
模块三 · 长任务与上下文
完成标志： 任务持续变长时，知道怎样留下关键结果，并理解压缩和缓存不是一回事。
配套实验：CASE 02 · 压缩前后对照
官方授权译文：Pi 中的压缩机制 · Agent 中的提示缓存
模块四 · 扩展自己的 Pi
完成标志： 能从真实需求出发选择扩展方式，并检查新增能力是否真的生效。
配套实操：CASE 03 · 第一个 Skill · CASE 04 · 最小 Extension · CASE 05 · 两路独立审阅
原理串联篇 · 把所有术语接成一次完整运行
Pi 工作原理：从一条 Prompt 到一次完整 Agent Loop把 Session、Context、System Prompt、Tool、Skill、模型调用和 Compaction 放回同一条链路，并沿用会议记录任务走完一次真实工具循环。建议在完成模块二、三和四后阅读；如果前面的术语仍然是散的，也可以先用这张总图建立方向，再回到对应课程练习。
模块五 · 建立稳定工作流
完成标志： 建立检查点、恢复路径和权限边界，让长任务可以继续，也可以安全停下。
配套实操：CASE 06 · 从检查点恢复 · CASE 07 · 任务前安全审阅 · CASE 08 · Pi 蓝皮书毕业项目
需要查找，而不是继续上课时
进入参考手册按主题查询：FAQ回答常见疑问，故障排查手册从已经发生的症状开始定位，热词表解释陌生概念。想比较 Pi 与它的分支，可以读OMP、Selesai Code 路线对照。个人经历、推文原文和认知变化单独保存在小墨同学札记，不会混进课程结论。
选学：Pi Durable
如果你准备开发能在进程中断后恢复任务的 Agent 应用，可继续阅读Pi Durable：让 Agent 在中断后继续工作。它是实验性框架，本书原有的进度文件练习仍可独立完成。