不是再装一个聊天框
Pi 更像终端里的 AI 编程工作台，把模型、工具和项目上下文接到同一条流程里。
如果你已经在用 Cursor、Claude Code 或 Codex CLI，但开始觉得提示词、规则和流程很难沉淀，Pi 值得认真看一下。
Cursor 用户Claude Code 用户Codex CLI 用户Cline 用户
Why Pi
从“问模型写代码”，到“管理一套 Agent 工作流”
当项目变大、工具变多，AI 编程的瓶颈往往不再是模型能力，而是上下文、规则和流程能不能稳定复用。Pi 关注的正是这一层。
把经验沉淀下来
常用提示词、Skills 和项目规则可以复用，不必每次换任务都重新解释一遍。
不要被单一模型锁死
面向多模型和多 Provider 使用场景，适合想自己权衡成本、速度和适用范围的团队。
Building Blocks
理解 Pi，可以从六个可组合能力开始
它的核心不是某个单点功能，而是把模型、工具、规则和复用流程放在同一套终端工作台里。
Providers
不要把工作流锁死在单一模型上，按任务选择 OpenAI、Anthropic、Ollama 等来源。
Tools
让 Agent 能读文件、跑命令、查项目，而不是只停留在聊天回答。
Skills
把每次都要重复交代的流程固化下来，让 Agent 按稳定步骤执行。
Prompt templates
把高频提示词变成可复用模板，减少靠记忆复制粘贴。
Themes
调整终端呈现细节，让长时间使用不那么累。
Packages
通过生态包复用别人沉淀好的能力，而不是所有东西都从零配置。
Session Tree
把 Agent 过程保留下来，而不是只看最后一次回答
一次复杂改动里，失败尝试、替代方案和中间判断往往比最后答案更有价值。Pi 的 tree-structured history 让这些过程可以被回放、分支和复用。
分支会话
复杂任务很少一次成功，分支会话能保留不同尝试路径，而不是只剩最后一条聊天记录。
可分享历史
排查过程、重构脉络和上下文决策都可以沉淀下来，方便团队复盘。
上下文回放
后续任务可以从已有上下文继续，不必每次重新解释项目背景。
Context Engineering
Pi 的重点不是提示词更长，而是上下文更可控
很多 AI 编程失败，不是模型不会写，而是它不知道你的项目约定、历史决策和当前边界。Pi 的价值在于把这些上下文变成可管理的输入，而不是每次从头解释。
- AGENTS.md：把项目规则、测试命令和团队约束写清楚。
- SYSTEM.md：定义 Agent 的稳定行为边界，减少每次临场补充。
- Compaction：把长会话压缩成还能继续使用的上下文资产。
- Skills / Prompt templates：把高频流程变成团队可以复用的组件。
- Dynamic context：根据当前任务加载最相关的信息，避免上下文越堆越乱。
Steer
任务运行中直接补充方向，适合在 Agent 偏航时及时纠偏。
Follow-up
把后续问题排队，适合围绕同一个代码库连续推进。
Four Modes
不只是在终端里聊天，也能进入自动化和集成场景
官网把 Pi 描述为四种使用模式：交互式、命令输出、RPC 和 SDK。中文站先用工作流语言解释它们分别适合什么。
Interactive
日常终端交互式编码，适合读代码、试方案和连续追问。
Print / JSON
把 Pi 当成脚本命令使用，让输出被 CI、脚本或其他自动化流程消费。
RPC
让其他进程通过协议调用 Pi，适合把 Agent 能力接入已有工具链。
SDK
在 TypeScript / Node 项目里直接组合 Pi 的能力，做更深的产品或内部工具集成。
Workflows
把高频开发任务，沉淀成可重复执行的流程
读项目、定计划、改代码、跑测试、复盘结论，这些步骤越固定，越值得交给 Pi 管理。
先读项目结构，再回答问题
让 Agent 先理解目录、依赖和关键文件，减少凭空猜测。
把重构拆成可回滚的小步骤
先明确目标和影响范围，再逐步修改、验证和复盘。
围绕变更点补测试
不要盲目铺覆盖率，优先锁住这次改动最可能回归的地方。
用固定规则检查 PR
把可读性、边界条件和回归风险变成每次都执行的检查清单。
把重复命令串成流程
把检查、修复和验证步骤连起来，减少手工来回切换。
判断该用哪个工具
区分 Pi、Claude Code、Codex CLI 各自适合的任务，不为新工具而新工具。
Primitives, not features
Pi 的克制，反而是它最需要被理解的地方
它没有急着把 MCP、sub-agents、permission popups 和 to-dos 全部塞进核心功能，而是把重点放在更底层的可组合原语上。代价是上手需要理解概念，收益是工作流边界更清楚。
不内置 MCP
不是所有集成都应该进核心，Pi 更倾向把扩展点留给外部组合。
不默认 sub-agents
先让上下文和执行边界可理解，再讨论是否需要更复杂的调度。
不强制 permission popups
安全边界不能只靠弹窗确认，更应该靠信任、沙箱和容器化设计。
不把 to-dos 当核心
任务规划可以沉淀成 Skill 或流程，不一定要变成产品里的固定模式。
Get involved
中文指南负责解释和取舍，事实仍以官方资源为准
Pi 还在快速变化，安装命令、Packages、News 和适用范围都可能更新。遇到事实型信息，请优先核对官方入口。