阶段一
准备与全景
建立心智模型与源码地图，先把 Pi 用起来
第 1 讲2~3 h
Agent 零基础：LLM、消息与工具调用
无状态 LLM API、消息角色、工具调用闭环、Agent Loop、上下文窗口——全程 Java 后端类比。
01-agent-basics.html 第 2 讲2 hPi 项目全景：monorepo 结构
11 个 package 的职责、依赖方向与分层理由，建立后续学习的源码地图。
02-repo-panorama.html 第 3 讲2~3 h安装与使用初体验
从 /login 到 steering、会话分支与四种运行接口（interactive / print / JSON / RPC）。
03-install-and-usage.html阶段二
模型层：pi-ai
统一多厂商 LLM API 的抽象与实现
阶段三
Agent 内核：pi-agent-core
整个框架的心脏：循环与工具
阶段四
编码代理：pi-coding-agent
从内核到产品：会话、上下文、扩展生态
第 8 讲4 h
架构：AgentSession 与核心模块
模块地图、启动流程、模型解析链、设置体系与项目信任，跟踪一条消息的完整路径。
08-coding-agent-architecture.html 第 9 讲3~4 h系统提示词、上下文与压缩
提示词装配线、AGENTS.md 发现、技能按需加载、compaction 阈值与摘要条目。
09-system-prompt-context.html 第 10 讲4 h内置工具集与会话持久化
read/write/edit/bash 实现要点、输出截断、写队列；JSONL 会话树与分支 / fork。
10-tools-and-sessions.html 第 11 讲4~5 h扩展系统 Extensions
ExtensionAPI 全貌、tool_call 拦截、自定义工具与命令、UI 集成、状态持久化。
11-extensions.html 第 12 讲3 hSkills、模板、主题与包生态
SKILL.md 规范与按需加载、提示模板、主题、npm/git 打包分发。
12-skills-packages.html阶段五
集成与实战
把 Pi 变成可编程组件，安全落地到工作流
每讲学习方法
- 先读页面讲解，遇到代码块回到本地源码
C:\pi_agent_study\pi-main打开完整上下文。 - 完成「动手实践」：每讲任务都设计为可直接在本地执行验证。
- 回答「自测问答」：折叠答案，先自己作答再展开对照。
- 对照「Java 视角」框：用已有经验锚定新概念，但注意差异点。
- 整站可离线浏览：直接双击任一 HTML 文件即可，无外部依赖。