第 31 章：极简核心，能力外置

来源：《pi 的设计艺术》第 30 章：极简核心，能力外置

阅读日期：2026-09-14。书中版本基线：本章采用 v0.66.0 架构快照；行数及产品比较属于该时期材料。 本条为原创阅读笔记，未独立核验 pi 源码。

编号说明：本条按在线目录第 31 章编号；原文标题仍为第 30 章，文件名沿用旧编号。

设计问题与机制

作者把共同内核划为模型调用、循环和状态，其余策略通过接口、回调和事件组合。内建判断看功能是否依赖产品形态、是否存在多种合理策略，以及是否必须跨组件一致。事件契约适合统一，UI 与执行环境适合由宿主决定。

这种结构利于多入口复用，但装配、调试及文档成本留给产品层。接口稳定时可独立演进；接口改变仍会影响消费者，外置不消除集成工作。

取舍与版本边界

行数比例和竞品表属于历史快照，不能当作当前评测。mom、web-ui 后续移出已在对应章节说明；pods 主要提供模型端点，不宜据本章概括认定它运行同一 Agent 循环。

工程应用检查（独立推导）

个人知识库先明确共同契约：条目标识、版本、草稿状态和来源。网页阅读与本地 MCP 写入可共享仓库规则，但采用不同入口和权限。出现真实第二消费者后再提炼共享服务，只有一种实现时保持直接。边界是否成功，以新增入口是否必须修改其他入口来衡量，而不以目录数或核心代码比例衡量。