不是再装一个聊天框
Pi 更像可组合的终端 Agent 底座，把模型、工具和上下文策略连接起来。
Pi Agent 中文指南 · 面向 AI 编程工具用户
把终端 AI 编程，组合成自己的 Agent 工作流。
Pi 是一个可定制的终端 AI 编程 Harness，让你把模型、工具、Skills、提示词模板和上下文工程组合起来，补上 Cursor、Claude Code、Codex CLI 之外的自定义空间。
适合 Cursor 用户适合 Claude Code 用户适合 Codex CLI 用户适合 Cline 用户
curl -fsSL https://pi.dev/install.sh | sh命令来源：pi.dev · 核对日期：2026-06-19
定位
终端 AI 编程 Harness
核心
可组合工作流
边界
中文社区指南
如果你已经在用这些工具，Pi Agent 中文指南会帮你判断 Pi 适合放在哪个工作流位置。
Cursor 用户Claude Code 用户Codex CLI 用户Cline 用户
Why Pi
当 AI 编程工具越用越多，你需要一个可组合底座。
Pi 的价值不是替代所有工具，而是让模型、上下文、工具调用和可复用流程能够在终端里被清晰组织。
把工作流沉淀下来
常用提示词、Skills、项目规则可以复用，不必每次从空白对话重新开始。
Provider 更开放
面向多模型和多 provider 使用场景，适合想掌控成本、速度和能力边界的团队。
Building Blocks
理解 Pi，先理解它的六个积木。
这不是只会回答问题的工具，而是一个围绕 Agent 工作流组合能力的生态入口。
Providers
连接 OpenAI、Anthropic、Ollama 等模型来源。
Tools
把文件、命令、搜索和项目操作交给 Agent。
Skills
封装可复用的任务流程，让 Agent 知道如何稳定执行。
Prompt templates
把高频提示词做成模板，减少重复输入。
Themes
调整终端体验，让长时间使用更舒适。
Packages
通过生态包扩展 Pi 的能力边界。
Session Tree
把 Agent 过程保留下来，而不是只看最后一次回答。
官网强调 tree-structured history。中文开发者可以把它理解为：每次尝试、分支和复盘都能成为下一次工作的上下文资产。
分支会话
把一次 Agent 任务拆成多条分支，保留尝试路径，而不是只剩一条聊天记录。
可分享历史
适合把排查过程、重构脉络和上下文决策导出给团队复盘。
上下文回放
让后续任务从已有上下文继续，而不是每次重新解释项目背景。
Context Engineering
Pi 的重点不是提示词更长，而是上下文更可控。
把项目规则、团队习惯、压缩策略和可复用 Skills 组合起来，才是 Pi 与普通聊天式工具的差异。
- AGENTS.md：沉淀项目规则、测试命令和团队约束。
- SYSTEM.md：定义更稳定的系统级行为边界。
- Compaction：把长会话压缩为可继续使用的上下文。
- Skills / Prompt templates：把高频流程变成可复用组件。
- Dynamic context：根据任务动态加载最相关的信息。
Steer
任务运行中直接补充方向，适合纠偏当前 Agent 行为。
Follow-up
把后续问题排队，适合连续处理同一个代码库任务。
Four Modes
不只是在终端里聊天，也能进入自动化和集成场景。
官网把 Pi 描述为四种使用模式：交互式、命令输出、RPC 和 SDK。中文站先用工作流语言解释它们分别适合什么。
Interactive
日常终端交互式编码，适合探索和连续对话。
Print / JSON
把 Pi 作为脚本命令使用，输出可被自动化流程消费。
RPC
让其他进程通过协议调用 Pi，适合集成到工具链。
SDK
在 TypeScript / Node 项目中直接组合 Pi 的能力。
Workflows
从单次提问，升级为可复用的编程流程。
把高频任务拆成清晰步骤，再交给 Pi 结合项目上下文执行。
代码库问答
让 Agent 先读结构、再回答，减少凭空猜测。
重构辅助
把重构目标拆成可验证步骤，逐步落地。
测试生成
围绕变更点补测试，优先覆盖真实风险。
PR 检查
用统一规则审查可读性、边界条件和回归风险。
自动化任务
把重复命令、检查清单和修复策略组合成流程。
工具对比
理解 Pi、Claude Code、Codex CLI 各自适合的任务。
Primitives, not features
有些东西 Pi 刻意不内置。
官网强调 Pi 更关注可组合 primitives。中文站要把这些“不做什么”解释清楚，否则很容易把 Pi 误解成另一个大而全的 agent 产品。
不内置 MCP
Pi 更强调 primitives 和扩展机制，不把所有集成都做成内置功能。
不默认 sub-agents
避免用复杂调度掩盖上下文和执行边界，先保持工作流可理解。
不强制 permission popups
安全边界应通过信任、沙箱和容器化设计，而不是只靠弹窗。
不把 to-dos 当核心
任务规划可以作为 Skill 或流程存在，不一定要成为产品内置模式。
Get involved
中文指南只做解释，事实以官方资源为准。
下面这些入口用于核对官方文档、Packages、News 和安装说明。中文站会在内容旁标注来源与更新时间。