Module 1: 认识 pi 与智能体基础

极简内核是什么、Agent Loop 怎么转、如何装好跑起第一个会话。

Ch01

认识 pi：极简内核智能体

定位、与 Claude Code/Codex 对比、四个扩展维度、哲学

Ch02

智能体工作原理：Agent Loop

LLM+工具+循环、四工具职责、系统提示、为什么内核可以极小

Ch03

安装与第一次对话

npm/curl 安装、/login 认证、API Key vs 订阅、首会话

Ch04

四大运行模式

interactive / print / json / rpc 一次看懂

Module 2: 日常驾驶 pi

把交互界面的效率拉满：输入技巧、命令体系、会话树、上下文压缩、项目配置。

Ch05

交互模式：编辑器与输入技巧

@文件引用、!/!! bash、多行、贴图、外置编辑器、快捷键

Ch06

斜杠命令与消息队列

内置命令、模型切换、thinking 等级、steering/follow-up

Ch07

会话树：分支、恢复与导出

JSONL 树、/tree、/fork、/clone、export/import/share

Ch08

上下文压缩 Compaction

手动/自动、threshold/overflow、有损性与 /tree 找回

Ch09

设置、上下文文件与项目信任

settings.json、AGENTS.md/CLAUDE.md、SYSTEM.md、trust 流程

Module 3: 模型与提示

让模型"更懂你"：提示模板、提供商与思维等级、自定义模型。

Ch10

提示模板 Prompt Templates

/名称展开、{{变量}}、存放位置、模板库设计

Ch11

模型、提供商与思维等级

20+ 提供商、订阅 vs API Key、thinking 七档、llama.cpp

Ch12

自定义模型与提供商

models.json、自定义 provider、扩展实现 OAuth

Module 4: 技能体系 Skills

按需加载的能力包：渐进式披露、SKILL.md、技能生态复用。

Ch13

技能：渐进式能力加载

Agent Skills 标准、SKILL.md 结构、渐进式披露原理

Ch14

编写你的第一个技能

SKILL.md + 脚本 + 参考、测试调试、失败兜底

Ch15

技能生态与跨工具复用

技能仓库、复用 Claude/Codex 目录、分发方式

Module 5: 扩展开发（核心）

TypeScript 扩展全链路：工具、事件、命令、UI、安全，最后拆解生产级开源扩展 pi-agent-hud。

Ch16

扩展入门：第一个 Extension

三种形态、jiti 加载、registerTool+事件起步

Ch17

自定义工具开发

execute 契约、typebox schema、动态工具、setActiveTools

Ch18

事件系统：拦截与改造一切

事件生命周期、tool_call 拦截、tool_result 改写、input 转换

Ch19

自定义命令、快捷键与标志

registerCommand/Shortcut/Flag、waitForIdle/newSession/reload

Ch20

用户交互与自定义 TUI

select/confirm/input、custom 组件、widget/status、编辑器替换

Ch21

安全扩展：权限门与沙箱

危险命令拦截、路径保护、白名单、容器化、git 检查点

Ch22

实战：拆解 pi-agent-hud

⭐ 使用+开发双视角：状态栏/浮层/插件系统、八模块源码解剖

Module 6: 打包与分享

把能力变成可分发产品：Pi 包机制与哲学落地。

Ch23

Pi 包：分发你的扩展

pi install/remove/update、pi 清单、git vs npm 包

Ch24

哲学落地：亲手补齐缺失功能

tmux 子代理、MCP 扩展、plan.md、TODO.md

Module 7: 程序化使用

把 agent 装进你的程序：SDK 嵌入、会话运行时、RPC 与事件流。

Ch25

SDK 入门：嵌入你的应用

createAgentSession、ModelRuntime、subscribe、prompt/steer

Ch26

SDK 进阶：会话、设置与运行时

SessionManager、SettingsManager、AgentSessionRuntime、run modes

Ch27

RPC 模式与 JSON 事件流

--mode rpc 协议、--mode json、CI 自动化、SDK vs RPC 选型

Module 8: 综合实战

毕业之路：子代理编排、专属工作流、发布自己的 Pi 包。

Ch28

实战：构建 Sub-Agent 编排扩展

委派系统、tmux worker、结果文件协议、汇总

Ch29

实战：专属智能体工作流

五层架构：宪法/能力/快捷/逻辑/观察，团队模板化

Ch30

毕业项目：发布你的第一个 Pi 包

打包、本地测试、npm 发布、文档宣传、课程总结

PiAgent 实战

Pi
Agent 实战