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 的引擎。本章看模型如何被循环调用、停止条件如何决定下一轮。
Pi 用统一模型与事件流接口承接 9 种文本 API 方言；本章追踪 Provider 适配层如何翻译请求与流式响应。
从工具查找、参数准备和校验，到调用前拦截、执行与结果编码；本章解释工具边界及并发调度。
Agent 内部用 7 种消息自由表达，调用 LLM 前翻译成 3 种标准 Message。
Agent 生命周期事件形成可等待的观察边界；coding-agent 再叠加产品事件与可影响流程的扩展钩子。
模型窗口有明确上限，而会话历史可能继续增长；本章梳理输入侧与历史侧的上下文控制机制。
上下文压缩把较早历史变成结构化摘要，并保留近期消息；本章解释触发、切点和立即重建流程。
会话管理：对话的存储、恢复与分叉，Session Tree 如何让 Agent 拥有可回溯的历史。