M01
第1章：开篇 —— 为什么 Pi-Agent 值得你花时间
Pi 是什么、为什么学它。本章打开 Pi-Agent 全貌，建立后续章节的知识地图。
每章都有 TypeScript 与 Python 两个版本；Python 版为转写，方便只熟悉 Python 的读者。
Pi 是什么、为什么学它。本章打开 Pi-Agent 全貌，建立后续章节的知识地图。
Pi-Agent 的三层架构：pi-ai 抽象模型、agent-core 提供运行时、coding-agent 包装交互。
Agent Loop 是 Pi 的引擎。本章看模型如何被循环调用、停止条件如何决定下一轮。
一行代码调 30+ 供应商。本章看 Pi 如何用 Provider 抽象抹平各家 API 差异。
工具系统五步管道：定义、注册、拦截、执行、回收。Agent 的手脚怎么被管住。
Agent 内部用 7 种消息自由表达，调用 LLM 前翻译成 3 种标准 Message。
事件驱动是 Pi 的神经系统。同步屏障 + 发布订阅，让扩展和宿主协同。
LLM 窗口固定、对话无限增长。本章看 Pi 在输入与历史两端布置的上下文工程防线。
上下文压缩：把 50 轮对话压缩成一段结构化摘要，让 Agent 继续记住之前发生了什么。
会话管理：对话的存储、恢复与分叉，Session Tree 如何让 Agent 拥有可回溯的历史。