Pi Coding Agent 插件推荐：10 个实用扩展及安装方法

meta description：Pi Coding Agent 目前值得关注的实用扩展整理，覆盖 MCP、联网搜索、子 Agent、后台任务、代码诊断、任务清单、计划审阅和浏览器自动化，并附安装命令、用途说明与安全注意事项。 slug：pi-coding-agent-extensions　标签：Pi Coding Agent Pi 插件 AI 编程工具 Coding Agent MCP 数据采集：2026 年 9 月 1 日；下载量来自 pi.dev 包目录，会持续变化，仅用于衡量近期关注度，不等同于功能质量。

目录

• 为什么 Pi 需要扩展
• 扩展占位清单
• 重点扩展详解
• 按需选择扩展
• 安装与重启
• 安全注意事项
• 本文没有覆盖的项目
• 参考来源

为什么 Pi 需要扩展

Pi（pi.dev）是一款刻意保持极简的终端编码 agent。内置工具只有四个：read、write、edit、bash；grep、find、ls 等可通过工具选项按需启用。它不内置 MCP、子 Agent、计划模式或任务清单，这些能力都交给扩展生态补齐。

这种极简设计把许多工作流能力交给扩展完成。目前 pi.dev 已有大量社区包，覆盖联网、MCP、子 Agent、代码检查、浏览器自动化等场景。

Pi 的扩展生态通常以 package 的形式分发。一个 package 可以包含 extension、skill、prompt template 或 theme。本文重点介绍能直接改变 Pi 工具、命令或工作流的 extension，同时保留官方包名和安装命令，并在表格中标明类型，避免与 skill 混淆。

扩展占位清单

以下为 pi.dev 包目录 2026-09-01 快照，月下载量会持续变化。

重点扩展详解

pi-mcp-adapter — 接入 MCP 服务

Pi 原生不带 MCP，此扩展通过单个、约 200 token 的代理工具 + 按需惰性加载补齐，而不是一次性灌入大量工具定义、占用过多上下文。可识别常见 MCP 配置路径（如 ~/.config/mcp/mcp.json 与 .mcp.json，具体加载范围以项目 README 为准），也能导入 Cursor、Claude、Codex 的现成配置。node 与 Pi 版本要求以当前发行说明为准。

安装执行：

pi install npm:pi-mcp-adapter

pi-web-access — 联网研究

提供网页搜索、URL 与 PDF 提取、GitHub 克隆、YouTube 与本地视频理解。默认零配置使用 Exa，无 key 时回落 DuckDuckGo。支持的搜索 provider 随版本变化，安装后可在配置中调整与刷新。按 Ctrl+S 可查看哪些搜索结果进入了模型上下文。

安装执行：

pi install npm:pi-web-access

pi-subagents — 子 Agent 与多 Agent 工作流

Pi 不内置子 Agent，此扩展把它装回去：单 Agent 委派 + 脚本化多 Agent 工作流，覆盖 reviewer / oracle / scout / researcher / worker 等常见角色。适合需要并行处理多个独立任务时使用。

安装执行：

pi install npm:pi-subagents

@juicesharp/rpiv-ask-user-question — 结构化澄清

当模型拿不准时，以结构化选项（而非自由文本）向你确认需求。官方页面要求 Node.js 22 或更高版本。

安装执行：

pi install npm:@juicesharp/rpiv-ask-user-question

pi-background-tasks — 后台长期任务

提供持久化的后台 shell 任务、只读委派 Agent 与固定用途的 Fusion 工作流。当前版本要求 Node.js 22.19 或更高。

安装执行：

pi install npm:pi-background-tasks

@juicesharp/rpiv-todo — 任务清单浮层

给模型一个 todo 工具，任务列表会从会话分支重建，因此能够跨 /reload 和上下文压缩保留，适合长任务跟踪。

安装执行：

pi install npm:@juicesharp/rpiv-todo

@plannotator/pi-extension — 计划与代码审阅

为无计划模式的 Pi 补上基于文件的计划模式，并在浏览器界面中审阅计划、代码变更和 PR，可高亮、批注并将结构化反馈回传给模型。计划模式会限制可执行工具与写入范围，具体限制取决于版本、配置与 Pi 的信任机制。当前页面提示需要较新的 Pi 版本。

安装执行：

pi install npm:@plannotator/pi-extension

pi-lens — 代码诊断与变更反馈

在 Pi 修改文件时，按项目配置运行 LSP 诊断、类型检查、lint 与格式化工具（如 Biome、Ruff、ESLint），把结果回注给模型以便自我修正。支持多种语言/文件类型，并提供密钥扫描。注意：它通常按项目与能力配置运行对应工具，并非所有环境都会运行全部检查器；建议先确认项目已存在对应的 LSP、formatter 或 lint 工具。

安装执行：

pi install npm:pi-lens

pi-simplify — 变更审查

通过 git diff 审查最近改动，判断代码是否清晰、一致、可维护，支持 staged、指定文件和指定 ref，适合在任务收尾时清理不必要的复杂度。

安装执行：

pi install npm:pi-simplify

pi-agent-browser-native — 浏览器自动化

提供原生 agent_browser 工具，支持页面操作、截图、持久化 profile 和认证网页，适合执行端到端页面操作、回归测试和需要持久化浏览器会话的流程。需要其上游浏览器运行时与相应系统环境。

安装执行：

pi install npm:pi-agent-browser-native

按需选择扩展

几点条件式判断，供参考：

• 不需要 MCP 的用户无需安装 pi-mcp-adapter。
• 经常进行网页调研的用户可以优先考虑 pi-web-access。
• 需要并行处理多个独立任务时，可安装 pi-subagents。
• 对代码诊断有要求时，可尝试 pi-lens，但应确认项目已有对应的 LSP、formatter 或 lint 工具。

安装与重启

常见的 npm 包安装命令如下：

pi install npm:<package-name>          # 全局安装
pi install npm:<package-name> -l       # 项目级安装（写入 .pi/）
pi install git:github.com/<user>/<repo> # 从 GitHub 安装

pi update --all                        # 更新 Pi 和已装包
pi remove npm:<package-name>           # 移除包

• 全局安装与配置通常位于 ~/.pi/agent/（npm 包常位于 ~/.pi/agent/npm/），项目级位于当前项目的 .pi/；具体位置与资源加载方式以当前版本文档为准。
• 版本要求：pi install 依赖 Node.js；部分扩展（如 @juicesharp/rpiv-ask-user-question、pi-background-tasks、@plannotator/pi-extension、pi-agent-browser-native）对 Node.js 或 Pi 版本有额外要求，安装前查看对应包页。
• 重启：安装或更新扩展后，建议重启 Pi。部分资源也可通过 /reload 重新加载，是否立即生效取决于 Pi 版本和扩展实现。

安全注意事项

Pi package 中的 extension 可以执行任意代码，并默认继承启动 Pi 的用户权限。安装第三方包前，应检查源码、依赖、许可证、最近发布记录和项目维护状态。生产环境建议固定版本，优先使用可审计、持续维护的项目。对不信任的扩展，不要直接在包含密钥、SSH 配置或生产凭据的环境中运行。

由于 package 可能同时包含 skill 或 prompt，运行前也建议确认其内容与你的工作流是否匹配。

本文没有覆盖的项目

本文不是 pi.dev 的官方排名，也不是完整目录。榜单按 pi.dev 当前月下载量和对开发工作流的相关性筛选，未纳入通用 package、商业集成、实验性项目以及仅包含 skill 的项目。真正的“最佳”取决于你的具体需求。

参考来源

1. Pi 官方文档：Pi Packages
2. Pi 官方文档：Using Pi
3. Pi 官方文档：Quickstart
4. Pi 官方包目录
5. pi-mcp-adapter 官方仓库
6. pi-web-access 官方仓库
7. pi-subagents 官方仓库
8. pi-lens 官方仓库
9. Plannotator 官方仓库
10. pi-agent-browser-native 官方包页
11. Composio：Top 10 Pi Agent Extensions（第三方参考文章）
12. narumiruna/pi-extensions（社区扩展 monorepo，截至 2026-09-01 约 490★）