Pi Agent 插件太多?先装这 9 个就够了

Pi Agent是一个运行在终端里的开源 AI 助手。

Pi 的迷人之处在于给扩展留出了很大的自定义空间。技能（Skills）可以提供任务说明；扩展（Extensions）能增加工具、命令和交互界面，还可以在工具调用前后执行自定义逻辑。开发者可以根据自己的工作流程用 TypeScript 编写扩展。

安装方式：

npm install -g --ignore-scripts @earendil-works/pi-coding-agentpi

进入 Pi 后，执行 /login 配置模型。Pi 支持订阅、API Key 和兼容接口。

相比 Claude Code，Pi 差别在哪？

Claude Code将权限控制、计划模式、子代理、MCP 和 Hooks 放进一套现成的工作流。Pi 从少量基础工具起步。想要计划审阅、MCP 支持或子代理，可以选择社区扩展，也可以自己写。

如果你想少花时间配置，Claude Code 更顺手；如果你希望自己决定工具边界、上下文开销和工作流程，Pi 提供了更多调整空间。两者都能处理复杂的编程任务，也都有扩展机制，差别主要在默认提供的工作方式。

图：根据文中九个扩展的项目文档整理；下文逐个说明适用场景。

一、输入增强：联网、定位与代码理解

1. pi-web-access：查新资料与当前文档

升级依赖库或排查新框架的报错时，只靠模型已有的知识不够。pi-web-access为 Pi 增加搜索和网页内容提取能力，也能处理视频与 GitHub 仓库链接。它支持多个搜索服务和回退策略，适合“先查官方迁移指南，再检查本地项目受影响位置”这类任务。具体能用哪些服务、是否需要额度，取决于你的配置。

安装：pi install npm:pi-web-access

2. pi-fff：大仓库里更顺手的搜索

项目一大，准确记住文件名就不容易。pi-fff提供模糊文件搜索、内容搜索和 @ 文件补全，还会结合常访问文件与 Git 修改状态排序。

它默认会新增搜索工具。如果希望替换内置的 find 和 grep，可以切换到 override 模式；小项目先用原生搜索即可。

安装：pi install npm:@ff-labs/pi-fff

3. pi-lsp：跨文件重构前确认符号关系

文本搜索能找到同名代码，却无法确认调用处真正指向哪个定义。pi-lsp让 Pi 使用语言服务器（LSP）获取诊断、定义跳转和代码动作。重构较大的 TypeScript 或 Python 项目时，这些信息有助于确定改动范围。

扩展不会自动安装语言服务器。使用前，需确保相应命令已在系统 PATH 中。

安装：pi install npm:@narumitw/pi-lsp

二、任务管理：计划、目标与分工

4. Plannotator：计划写完，先让人批注

让 AI 先写计划很容易，难的是在执行前指出其中哪一步需要修改。Plannotator 的 Pi 扩展提供浏览器审阅界面：你可以给计划加批注、退回修改，批准后再让 Pi 执行。代码改完，还能用 /plannotator-review 查看 diff 并留下逐行意见。需求模糊或改动范围大时很实用。

安装：pi install npm:@plannotator/pi-extension。之后可用 pi --plan 启动计划模式。它要求 Pi 0.79.1 及以上。

5. pi-codex-goal：写清长任务的完成条件

长会话做到一半，Agent 容易把“已经做了一些”当成“已经完成”。pi-codex-goal增加 /goal 命令，以及创建、查询和更新目标的工具。目标状态随会话保存、恢复和分叉，适合需要多轮推进、最后逐项验收的任务。

安装：pi install npm:pi-codex-goal。项目文档要求 Pi 0.84.0 及以上、Node.js 24。

6. pi-subagent：把调查和实现分开

主会话同时承担排查代码、查资料、编写实现和审查，很快会被细节塞满。pi-subagent可以把聚焦的任务交给子代理，支持并行调用与延续命名会话。比如先让子代理找出鉴权模块涉及哪些文件，主会话再根据结果决定改法。

安装：pi install npm:@mjakl/pi-subagent。它要求 Pi 0.80.6 及以上。子代理会增加模型调用，小任务不必使用。

三、工具管理：接入、开关与检查

7. pi-mcp-adapter：按需接入已有 MCP 服务

如果你在 Cursor 或 Claude Desktop 里已经配置了数据库、浏览器等 MCP 服务，可以用 pi-mcp-adapter将它们接入 Pi。扩展让模型按需查找工具，服务也会在用到时连接，避免启动时就载入所有工具说明。通过 /mcp setup 可以查看并选择导入其他客户端的配置；它不会自动启用这些配置。

安装：pi install npm:pi-mcp-adapter。当前 npm 包信息已声明支持 Pi 0.87 系列；安装时仍应核对所用版本的依赖提示。MCP 服务本身的账号、额度和费用另算。

8. pi-loadout：关掉本轮用不到的工具

扩展装得越多，管理常驻工具就越重要。pi-loadout提供 /loadout 面板，可以在当前会话启用、禁用工具与技能，还能保存常用组合。写文档时关掉暂时不用的工具，做代码任务时再切回来。

安装：pi install npm:pi-loadout。会话中途频繁变更工具列表可能导致下一轮提示词缓存失效；最好在任务开始前选好组合。

9. pi-inspect：看清模型收到的工具和提示词

配置多了，排查“为什么这个工具还在”也会花时间。pi-inspect可以在本地浏览器展示当前会话的工具、命令、技能和系统提示词快照。需要查看更新后的状态时，可以重新捕获快照。

安装：pi install npm:pi-inspect。进入 Pi 后输入 /inspect 即可打开。分享快照链接前先检查内容，其中可能包含系统提示词和本地工作目录。

四、怎么组合

不用一次装完九个。先用原生 Pi 做几个任务；频繁查资料时装 pi-web-access，跨文件修改时再考虑 pi-fff 或 pi-lsp。任务需要人工审阅或长期跟进，就加入 Plannotator 或 pi-codex-goal。确实要并行调查、连接外部服务时，再用子代理和 MCP。扩展多到难以管理，pi-loadout 和 pi-inspect 才能发挥作用。

九原山的清单还有不少选择，但安装前要看当前状态。例如，@cnife/pi-simple-plannotator^[16]的 npm 描述已标记 Deprecated；pi-rtk-optimizer^[17]声明的 Pi 兼容范围停在较早版本。旧清单适合找线索，安装命令和兼容性仍要重新核对。

扩展与 Pi 进程共享系统权限，能够接触文件、环境变量和会话内容。Pi 安全文档提醒：信任项目配置不会给工具调用提供沙箱。弄清每个扩展解决的问题，再决定让它在哪些项目里运行。