// 面向 AI Agent 学习者
PI LEARN
不依赖框架，不背诵 API。从 pi 的真实源码出发， 逐章重建一个 agent harness 的完整机制。
14核心章节
01迷你 harness
03番外主题
— 章节索引 / CHAPTER INDEX
S01
Agent Loop
while 循环、tool_use 往返、原生 fetch 直调 Messages API。
S02
Tools
bash / read / write 三工具 + dispatch 表 + 路径校验。
S03
Edit Queue
edit 工具 + promise 链式 file-mutation-queue。
S04
Interrupt
AbortSignal + steering 消息注入 + max-turns 熔断。
S05
Session
jsonl append-only 持久化 + 断点续跑。
S06
Compaction
token 估算 + 溢出检测 + LLM 摘要压缩。
S07
Skills
文件即 prompt 注入 + diagnostics 优雅降级。
S08
Provider
LlmProvider 接口 + Anthropic/OpenAI 双实现 + 消息边界转换。
S09
TUI 渲染
差分渲染引擎 + 16ms 节流 + synchronized output。
S10
Extensions
生命周期钩子编排 + 三层错误隔离 + 动态加载。
S11
AgentSession
分层架构 + compaction 自动触发 + 模型切换 + 事件订阅。
S12
Streaming
EventStream 双输出模型 + 流式 JSON 容错解析 + 四层降级。
S13
Stateful Agent
steering/followUp 双队列 + idle/running 状态机 + 事件串行派发。
S14
会话分支树
entry 树 + JSONL 持久化 + branch/fork/compaction 截断。