设计哲学与包架构：Minimal Core
Pi 的核心极简、扩展装配哲学，落在四个 npm 包的具体目录结构上，建立后续章节的坐标系。
Session：JSONL 文件与树形结构
Pi 用 JSONL 树形结构抽象会话，撑起分支、回滚、/tree 导航、压缩摘要等所有能力。
Compaction 与分支摘要
Pi 把上下文压缩做成一等公民——自动 compaction 与 branch summarization 共享同一套文件跟踪与摘要格式。
Extensions：TypeScript 扩展点全景
Pi 的 TypeScript Extension 能注册工具、命令、provider、UI 渲染器，订阅 30+ 种生命周期事件。
Providers、Models 与安全模型
Pi 统一 30+ provider 接口、并把安全隔离责任外推给 OS、容器、虚拟机的设计取舍。
SDK 与编程接口
Pi 的统一入口 createAgentSession()——同一个 runtime 在 CLI、Node.js 嵌入、子进程 RPC、JSONL 流四种场景下的等价用法。