Pi Deep Dive
TL;DR：这是一套解读 Pi 的中文教程，对齐 Pi v1.5.0（2026-11-02）。Pi 是一个"极简、可扩展的 Agent Harness"：
pi-ai把不同模型统一成一次流式 LLM 调用，pi-agent-core把多次调用和工具执行组织成 Agent Loop，pi-coding-agent再加上会话、资源、配置、压缩、扩展和多种运行模式，做成可以长期使用的 Coding Agent。教程只讲设计思想、职责边界和核心链路，不逐行读源码，适合用来建立整体理解和准备面试。
怎么读
只有半小时，就读 Pi 总览。它是全书的精简版，每一层都有可以直接在面试中说的版本，三层之间的边界和一次完整请求的链路也在里面。
想真正弄懂，就按依赖顺序从下往上读。先读 pi-ai 的两篇：统一模型调用层讲多 Provider 的统一数据模型和装配方式，流式事件架构讲一次响应如何变成标准化事件流。然后读 pi-agent-core，它讲双层循环、steering/follow-up 和运行时 Hook，是整个系统的控制流中心。最后读 pi-coding-agent 主笔记，再按需要深入它的各个模块。
pi-coding-agent 的模块里，面试中最常被追问的是会话树与上下文压缩、扩展系统和 Skills。它们分别回答三个问题：长对话怎么持久化和瘦身，产品怎么在不改核心的前提下被定制，模型怎么按需获得领域知识。MCP 与 Codemode 是 0.99（1.0 前夕）新加的能力，可以拿来对照 Pi 早期"不做 MCP"的立场。
附录不属于三层主线，但面试中也可能被问到：pi-tui 讲终端 UI 怎么做差分渲染、怎么接住流式事件，沙箱与容器化回答"Pi 没有权限系统，那怎么隔离"，另外两篇讲 monorepo 的构建、检查和发布脚本。
每篇笔记的结构
每篇开头有一段 TL;DR，可以面试前背、面试时直接说。正文先讲它解决什么问题、怎么运行，再沿着一次真实任务的顺序讲核心链路，最后讲设计取舍。部分章节有"一句话"总结和"常见追问"。文末的"源码入口"列出 v1.5 的关键文件，方便想深入的读者对照源码。
参考资料
- Pi 官方文档，尤其是其中的 How Pi Works
- What I learned building an opinionated and minimal coding agent：Pi 作者的设计自述
- pi-book
- 深度解析：pi-ai 与 pi-agent-core
- Pi Agent 原理与实现