AI 简明手册极简核心的工程取舍
它要解决什么
Pi 的核心取舍是拒绝把所有工作流固化成产品功能，以较小、可理解的默认面换取深度扩展；代价是团队必须自己承担选型、组合、升级和安全治理。
源码给出的答案
非目标能力转化为团队选择
“Pi 是什么”已经列出 MCP、子 Agent、权限弹窗、计划模式等非目标能力。本页关注由此产生的取舍：需求没有消失，而是由团队决定使用哪种 Extension、Package 或宿主能力，并承担组合后的升级与验收。
[repo] [docs]
扩展可以深入但同权
工具、命令、输入、上下文、模型 Provider、会话事件和 UI 都有扩展点；这种深度减少 fork，却也意味着扩展兼容性与安全性成为系统的一部分。
[repo]
收益与代价
个人或小团队能用少量 Extension 快速形成贴合自己的 Harness；需要组织级一致性的团队则应维护一套固定 Package、版本锁和验收测试。
比较 Pi 与其他 Agent 时，应比较“默认核心 + 实际启用组合”的总系统，而不是只列功能清单。
别把取舍当成定律
极简架构不会自动降低总体复杂度，它只是把复杂度从核心仓库转移到可选择的扩展、配置和运行环境。
来源与核验
- [repo] Pi 官方源码（固定 revision）
- [docs] Pi 官方文档
Revision：853a80d26c90a14c1886f0ebb8ffaae133ca2185 · 核验日期：2026-08-31