AI 简明手册Pi 是什么
先看全局
Pi 是一个面向本地开发工作的终端 Agent Harness。它保持一个较小的内核，把工具、命令、界面和工作流交给 TypeScript Extension、Skill、Prompt Template、Theme 与 Package 扩展。
沿地图找代码
仓库给出的定位
根 README 把项目拆成统一 LLM API、Agent 运行时、编码 Agent CLI、TUI 和遥测几个包；编码 Agent 文档进一步称 Pi 为“最小终端编码 Harness”。
[repo] [docs]
最小不是功能少
默认 CLI 提供会话、工具调用、上下文文件和终端交互，但不把 MCP、子 Agent、权限弹窗、计划模式、Todo 或后台 Bash 固化进内核；这些能力由 Extension 或外部工具补上。
[repo] [docs]
建议阅读顺序
选择 Pi 的主要理由不是预装功能数量，而是能否接受“稳定小内核 + 可替换外围”的维护方式。
评估一个 Pi 工作流时，要同时查看启用的 Extension、Package、项目资源与外部沙箱，不能只看主仓库默认行为。
这张地图没覆盖什么
Pi 的“极简”是产品边界，不等于默认安全、零配置或适合所有团队；需要统一审批、集中策略和托管运行时的场景仍要补上外部治理层。
来源与核验
- [repo] Pi 官方源码（固定 revision）
- [docs] Pi 官方文档
Revision：853a80d26c90a14c1886f0ebb8ffaae133ca2185 · 核验日期：2026-08-31