前言：定位、阅读路径与版本基线

来源：张汉东《pi 的设计艺术》前言。阅读日期：2026-09-14。本文为阅读笔记，原文观点与整理者推导分开记录；未独立核验 pi-mono 源码或发行记录。

来源要点

本书围绕 Agent 运行时的设计决策展开，关注每个选择解决的问题、收益和代价。目标读者包括有工程经验的开发者、扩展贡献者和需要判断架构适配性的负责人。阅读需要 TypeScript 类型、泛型、异步代码，以及 LLM 提示词、工具调用、流式响应基础；不要求先用过 pi。

前言给出架构路线（1→8→10→30–32）、扩展路线（2–3→8–10→15–16→19→附录 D），也可依目录完整阅读。知识地图从模型调用到循环内核，再展开会话产品、外部能力、工具与宿主 UI，最后讨论设计哲学。源码定位、章末取舍、图示和版本演化是主要阅读线索。

前言自述：核心分析来自 v0.66.0（2026 年 4 月），已对照 v0.82.1（书中标注 2026-07-25）。这是材料自己的版本声明。

目录核对与使用边界

在线目录现在有 33 章；设计哲学位于 31–33，SDK 独立为第 27 章。前言路线仍引用旧编号，阅读时需按主题对照。本次入库按在线章节编号组织，前言与附录各存一条。

工程应用检查（整理者推导）

阅读每章时先写出业务问题，再判断现有实现是否已经解决；只有明确缺口才引入机制。把“书中解释”“当前接口验证”“本项目实际采用”分成三个结论，不因读过设计材料就声称完成实现。开始编码时再核对项目锁定版本的类型与测试。

本条是学习材料，不新增站点主人的个人经历或项目交付事实。