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 · 第一個技能 · CASE 04 · 最小擴充功能 · CASE 05 · 兩路獨立審閱
原理串聯篇 · 把所有術語接成一次完整執行
Pi 工作原理：從一條 Prompt 到一次完整 Agent Loop把工作階段（Session）、上下文（Context）、System Prompt、Tool、技能、模型呼叫和壓縮（Compaction）放回同一條鏈路，並沿用會議記錄任務走完一次真實工具迴圈。建議在完成模組二、三和四後閱讀；如果前面的術語仍然是散的，也可以先用這張總圖建立方向，再回到對應課程練習。
模組五 · 建立穩定工作流
完成標誌： 建立檢查點、恢復路徑和權限邊界，讓長任務可以繼續，也可以安全停下。
配套實作：CASE 06 · 從檢查點恢復 · CASE 07 · 任務前安全審閱 · CASE 08 · Pi 藍皮書畢業專案
需要查詢，而不是繼續上課時
進入參考手冊按主題查詢：FAQ回答常見疑問，故障排查手冊從已經發生的症狀開始定位，熱詞表解釋陌生概念。想比較 Pi 與它的分支，可以讀OMP、Selesai Code 路線對照。個人經歷、推文原文和認知變化單獨儲存在小墨同學札記，不會混進課程結論。
選學：Pi Durable
如果你準備開發能在程序中斷後恢復任務的 Agent 應用，可繼續閱讀Pi Durable：讓 Agent 在中斷後繼續工作。它是實驗性框架，本書原有的進度檔案練習仍可獨立完成。