在中文搜索里，Pi Agent 通常指开发者 Mario Zechner 发起的开源项目 Pi。官方名称是 Pi，仓库地址为 github.com/earendil-works/pi，早期仓库名为 badlogic/pi-mono。它运行在终端里，可以读取文件、执行命令、修改内容，也可以作为 Agent 运行时嵌入其他应用。
从安装和使用方式看，Pi Agent 是一款终端 AI 智能体软件；从代码组织看，它又提供了一套可复用的 AI Agent 框架，也可以放进企业级 AI Agent的技术栈里评估。项目采用 MIT 许可证，核心包包括模型接口 pi-ai、运行时 pi-agent-core、编码智能体 pi-coding-agent 和终端界面 pi-tui。
搜索这个词时，结果里还会出现 Inflection AI 的 Pi 聊天助手，以及一些以 Pi Agent 命名的第三方项目。它们和 earendil-works/pi 的关系并不相同，先分清对象，后面的判断才有意义。
Pi Agent 到底指哪个项目？
官方项目名是 Pi。GitHub 仓库现在归在 earendil-works 组织下，命令行工具通过 npm 包 @earendil-works/pi-coding-agent 分发，早期包名是 @mariozechner/pi-coding-agent。中文搜索里的 Pi Agent，多数指这个项目，因为它的核心运行时包叫 pi-agent-core。一些基于 Pi 的第三方项目也会用 Pi Agent 命名，所以看到这个词时，要先看具体指向。
三种常见所指
第一种是 Pi 编码智能体，对应 @earendil-works/pi-coding-agent。它是开箱即用的终端 CLI，适合在项目目录里读代码、改文件、跑命令。
第二种是 Pi Agent 运行时，对应 @earendil-works/pi-agent-core。它负责 Agent 循环、工具调用和状态管理，适合开发者嵌入自己的应用，不直接提供完整的终端交互。
第三种是第三方同名封装。GitHub 上有项目在 Pi 之上增加多通道网关、子代理和技能包，也以 Pi Agent 命名。这类项目能复用 Pi 的能力，维护方、功能范围和更新节奏与官方项目不同。
判断时可以看三个地方，仓库地址、npm 包名和维护方。官方入口是 pi.dev 和 github.com/earendil-works/pi，官方包名以 @earendil-works/ 开头。
和 Inflection AI 的 Pi 怎么区分
Inflection AI 也有一款叫 Pi 的产品，定位是面向个人的 AI 助手，提供对话、情感交流和个人问题解答等功能。它和 earendil-works/pi 没有产品关系，也不是一个供开发者搭建 Agent 的框架。
搜索时看域名更容易区分。pi.ai 通常指向 Inflection AI 的消费级助手，pi.dev 才是本文讨论的开源项目。
| 名称 | 维护方 | 形态 | 主要用途 |
|---|---|---|---|
| Pi | earendil-works | 开源终端智能体与运行时 | 编码、文件处理、可编程 Agent |
| Inflection AI 的 Pi | Inflection AI | 消费级 AI 助手 | 日常对话、情感交流、个人问题解答 |
| 第三方 Pi Agent 项目 | 各项目作者 | 基于 Pi 的封装或编排层 | 多通道接入、子代理、定制工作流 |
Pi Agent 算不算 AI Agent 框架？
算，Pi 同时具备软件产品和框架两层属性。只需要一个能用的终端助手，安装 pi-coding-agent 即可；要把 Agent 能力放进自己的系统，pi-agent-core 和 pi-ai 更合适。把 Pi 当作智能体框架来看，重点在运行时、工具协议和扩展机制，不在某个固定界面。
四层代码结构
| 层次 | 包 | 负责什么 |
|---|---|---|
| 模型接口 | @earendil-works/pi-ai | 统一多家模型服务商的调用接口 |
| Agent 运行时 | @earendil-works/pi-agent-core | Agent 循环、工具调用、状态管理 |
| 编码智能体 | @earendil-works/pi-coding-agent | 终端 CLI、会话、工具和扩展 |
| 终端界面 | @earendil-works/pi-tui | 终端渲染和交互组件 |
这种分层让 Pi 既能作为成品使用，也能被拆开复用。从复用角度看，Pi Agent 框架的核心是 pi-agent-core 和 pi-ai，终端界面只是其中一层。官方把它描述为 minimal agent harness，意思是极简的智能体运行框架，强调用较小的内核加扩展来适配工作流。
框架边界在哪里
Pi 默认不带子代理和计划模式。官方首页写明 Pi 跳过 sub-agents 和 plan mode，需要时可以通过扩展或软件包补上。
默认工具集中在文件和命令。内置 read、write、edit、bash 等工具，覆盖读代码、改文件、跑测试这类动作，也可以按需启用 grep、find、ls 等文件检索工具。
Pi 在本地运行，权限跟随进程。官方文档说明工具和扩展使用 Pi 进程的操作系统权限，项目信任只控制加载哪些项目资源，不构成沙箱。
它提供交互、打印或 JSON、RPC、SDK 四种接入方式，方便脚本或外部程序调用。它的定位更靠近编码智能体内核，工作流编排需要靠扩展补充。
Pi Agent 怎么运行？
Pi 的核心是一个 Agent 循环。它把模型请求、工具执行、上下文组装和会话存储串在一起，让一次任务可以连续跑多轮。
一次任务怎么跑完
- 用户在终端提交消息，消息进入当前会话分支。
- Pi 用系统提示、当前分支、可用工具和模型设置组装请求，发给所选模型服务商。
- 模型返回文本和工具调用，Pi 记录回复，执行每个工具调用，再记录结果。
- 工具结果或排队消息还需要模型处理时，Pi 进入下一轮；否则本次运行结束。
- 用户可以在运行中发送调整消息，也可以等任务结束后追加需求。
这套循环的关键在工具结果会回到模型上下文。模型看到命令输出或文件改动后，再决定下一步，直到任务完成或用户中止。
上下文和会话怎么保存
会话是 JSONL 文件，消息和事件组成树，当前分支提供下一次请求的历史。用户可以从旧节点继续，形成新分支，也可以 fork 或 clone 到新会话。
接近上下文上限时，Pi 插入摘要条目做压缩，原始条目仍留在会话树里。项目指令从 AGENTS.md 或 CLAUDE.md 读取，系统提示可以用 SYSTEM.md 替换或追加。Skills 的完整说明按需加载，减少常驻上下文占用。
这种设计适合需要反复试错的开发任务。走错一步时，回到之前的分支继续，比重新开一个会话更容易保留已有信息。
扩展和模型怎么接
Extensions 是 TypeScript 模块，可以注册工具、命令、快捷键、模型服务商、事件处理器和界面。Skills 提供按需加载的指令和支持文件，Prompt templates 提供可复用提示，Themes 调整终端配色。这些资源可以打包成 Pi package，通过 npm 或 git 安装。
模型侧支持 Anthropic、OpenAI、Google、Azure、Bedrock、Mistral、Groq、Cerebras、xAI、Hugging Face、OpenRouter、Ollama 等服务商，也可以配置兼容 OpenAI、Anthropic 或 Google 接口的自定义端点。具体模型和价格以 pi.dev 的模型目录为准。
Pi Agent 能做什么？
官方给出的使用范围包括软件开发、研究笔记、写作项目、数据文件和兴趣项目。它工作在用户指定的文件夹里，能发现文件、读取内容、执行命令、修改文本，适合需要多步操作的任务。
常见使用场景
- 代码维护：读仓库、定位问题、修改文件、运行测试。
- 资料整理：读取本地笔记、提取要点、生成结构化文档。
- 数据文件处理：查看 CSV、JSON 等文件，写脚本做清洗或转换。
- 内部工具：通过 TypeScript SDK 或 RPC 把 Agent 能力接进自己的应用。
- 个人任务：批量重命名、整理目录、生成脚本等。
四种使用方式
| 方式 | 入口 | 适合谁 |
|---|---|---|
| 交互模式 | 终端 TUI | 需要边看边改的开发者 |
| 打印或 JSON 模式 | pi -p、--mode json | 脚本、CI、事件流消费 |
| RPC 模式 | stdin/stdout JSONL | 非 Node 语言或独立进程集成 |
| TypeScript SDK | 进程内调用 | 把 Agent 嵌入应用 |
这四种方式共用同一套 Agent 和会话机制，差别主要在交互界面和集成方式。
哪些团队适合用 Pi Agent？
我会把它推荐给愿意自己动手改工具的小团队，以及需要把 Agent 运行时嵌进产品的工程团队。它的优势来自内核小、可改造、会话和扩展机制清楚；代价是不少企业能力要自己补。
适合的情况
- 团队以开发者为主，日常在终端里工作。
- 希望 Agent 在本地文件夹里操作，数据不经过额外托管层。
- 需要按自己的流程改工具、加命令、换模型。
- 有工程能力维护扩展、容器和凭据。
- 想把 Agent 能力嵌进内部工具，暂不采购完整平台。
要谨慎的情况
- 需要开箱即用的权限分级、审计、租户管理和统一控制台。
- 使用者以运营、业务人员为主，不熟悉终端和配置文件。
- 需要内置多代理协作和计划模式，且不愿自己装扩展。
- 需要厂商 SLA、等保合规或私有化交付合同。
这些情况可以继续评估 Pi，但要先算清补充成本。权限和审计需要在容器、专用账号或外部治理层解决；多代理和计划模式可以通过扩展补，但要纳入维护范围。
企业使用时要注意什么？
权限和隔离
Pi 没有内置的文件系统、进程、网络或凭据访问限制。工具和扩展按启动它的用户权限运行，也不会在每次工具调用前询问。官方建议用容器、虚拟机或沙箱限制可访问的文件、凭据和网络；项目信任只控制项目资源加载，不能替代隔离。
企业落地时，Agent 安全要从运行环境、凭据和网络边界分开处理。专用账号、短时凭据、只挂载必要目录，这些做法比在提示词里写“不要删文件”可靠。
扩展和供应链
第三方扩展和软件包会在 Pi 进程里执行代码，也能影响 Agent 行为。安装前要读源码，确认维护方和版本来源。企业内部可以固定版本、做镜像或代码审查，把扩展纳入正常的软件供应链管理。
成本和许可证
Pi 的代码采用 MIT 许可证，可以免费获取和修改。实际使用还要承担模型服务费用，费用取决于所选服务商、模型和用量。第三方扩展或软件包也可能有自己的许可和收费方式。
企业级能力怎么补
如果目标是把 Agent 铺到多个业务团队，做统一的 Agent 管理、权限、任务和运行监控，就需要另一类产品。
ThinkingAI 的 Agentic Engine 提供 Agent 创建与管理、多 Agent 协作和私有化部署，已服务全球 1500 多家企业，接入产品超 8000 款。
Pi 能否与这类平台配合，要看具体接口和部署方式，不能默认两者已经集成。选型时可以把 Pi 当作团队级的可改造工具，把企业级平台当作治理和规模化的承接层，两者承担的任务不同。
常见问题
Pi Agent 是免费的吗？
代码免费，模型调用不免费。Pi 采用 MIT 许可证，软件本身可以免费获取和修改；实际使用按所选模型服务商和用量付费。第三方扩展可能另有收费。
Pi Agent 支持哪些模型？
官方支持 Anthropic、OpenAI、Google、Azure、Bedrock、Mistral、Groq、Cerebras、xAI、Hugging Face、OpenRouter、Ollama 等，也可以通过 models.json 接入兼容 OpenAI、Anthropic 或 Google 接口的端点。模型由你选择的服务商提供，Pi 负责调用和编排。完整列表和价格以 pi.dev 的模型目录为准。
Pi Agent 和 Inflection AI 的 Pi 是同一个吗？
两者不是同一个产品。Pi Agent 指 earendil-works 的开源终端智能体和运行时；Inflection AI 的 Pi 是面向个人的 AI 助手应用。维护方、产品形态和使用场景都不同。搜索时看域名更容易区分，pi.dev 是开源项目，pi.ai 是 Inflection AI 的助手。
Pi Agent 需要会写代码吗？
日常使用不要求写代码，能在终端里描述任务、确认文件改动即可。要写扩展、Skills 或把 Pi 嵌入应用，就需要 TypeScript 或相应的编程能力。使用前还要安装 Node.js 22.19 或更高版本，并配置模型服务商的账号或 API Key。
Pi Agent 可以商用吗？
代码采用 MIT 许可证，通常允许商用和修改。模型服务、第三方扩展、依赖包和分发内容有各自条款，商用前要分别核对。涉及数据处理和跨境传输时，还要按企业合规要求评估部署方式。
参考资料
- Pi 官方文档，https://pi.dev/docs/latest
- Pi 工作原理，https://pi.dev/docs/latest/how-pi-works
- Pi 安全说明，https://pi.dev/docs/latest/security
- Pi GitHub 仓库，https://github.com/earendil-works/pi
- Inflection AI 关于 Pi 的官方说明，https://inflection.ai/blog/the-future-of-pi
- 第三方 Pi Agent 项目说明，https://github.com/dwsy/agent/blob/291e371f7dc7a7957f0141d2a5558285231eaa9a/README.zh-CN.md
以上资料核对于 2026 年 11 月 5 日。产品和文档会更新，涉及版本、价格和接口的细节，使用前以官方页面为准。
