ARTICLE · 993791

Pi Agent 必备插件推荐:装上这几个,编码 Agent 直接满配

发布时间：2026-09-15 19:34:04 最近访问：2026-09-15 19:34:03

这是 Pi Agent 系列的第四篇。前作回顾：《Pi Agent 从 0 到 1 上手指南》《Pi Agent 到底是如何设计的？——极简编码 Harness 架构拆解》《为什么要用 Pi Agent？5 个核心优势与真实场景》。

Pi 的核心哲学是「极简 Harness，把 Agent 适配成你的工作流，而不是反过来」。

它的内核刻意保持小巧——默认甚至不包含子代理、不做计划模式，把这些能力留给插件生态。所以对 Pi 用户来说，装对插件，体验是「轻装上阵」和「满配作战」的区别。

这篇就把 Pi 生态里真实存在、下载量最高、口碑最稳的必备插件一次讲清楚。所有数据来自 npm 官方仓库（2026-08 月度下载量），安装命令均实测可用。

一、先搞懂 Pi 的插件体系

Pi 有五种扩展方式，层层递进：

类型	是什么	放哪里
Extensions	TypeScript 模块，可注册自定义工具、命令、拦截事件、自定义 UI	`~/.pi/agent/extensions/` （全局）或 `.pi/extensions/`（项目）
Skills	按需加载的技能包（`SKILL.md` + 脚本 + 参考文档），符合 Agent Skills 标准	`~/.pi/agent/skills/` 、`.pi/skills/`
Prompt Templates	Markdown 提示词模板，输入 `/名字` 即展开	`~/.pi/agent/prompts/`
Themes	TUI 配色主题（JSON）	`~/.pi/agent/themes/`
Pi Packages	把上面四种打包，通过 npm / git 分发共享	`pi install` 安装

安装与管理命令（核心就这几条）：

pi install npm:pi-mcp-adapter            # 从 npm 安装pi install npm:pi-subagents@0.61.0       # 指定版本pi install git:github.com/user/repo@v1   # 从 git 安装pi install ./local/path                  # 本地目录pi install -l npm:pi-web-access          # -l 安装到项目级（可随项目共享）pi -e npm:pi-subagents                   # 临时试用，不落盘pi list                                  # 查看已安装pi update --all                          # 全部更新pi config                                # TUI 开关各项资源pi remove npm:pi-mcp-adapter             # 卸载

⚠️ 安全提醒：扩展以你的完整系统权限运行、可执行任意代码。只安装可信来源的包；项目级插件要在信任项目后才会加载。

二、必装插件 Top 榜（按下载量）

插件	月下载量	一句话定位
`pi-mcp-adapter`	~76 万	接入 MCP 生态但不烧上下文
`pi-web-access`	~40 万	上网搜索、抓网页、看视频
`pi-subagents`	~36 万	给 Pi 补上子代理能力
`@juicesharp/rpiv-ask-user-question`	~12 万	该问就问，不再瞎猜
`pi-background-tasks`	~11 万	长任务后台跑，不阻塞对话
`@juicesharp/rpiv-todo`	~10 万	实时待办浮层
`pi-lens`	~6 万	写代码实时反馈（LSP/检查）
`@plannotator/pi-extension`	~5 万	计划审查与批注
`pi-simplify`	~4 万	代码简化审查
`pi-memory`	~3.7 万	语义记忆
`pi-dynamic-workflows`	~3.4 万	动态工作流 + 深度研究

三、逐个拆解：8 个真正值得装的插件

1️⃣ pi-mcp-adapter —— MCP 接入不烧上下文（下载量之王）

痛点：MCP 的工具定义极其冗长，一个 server 就能烧掉 1 万+ tokens，连几个 server，对话还没开始上下文就烧了一半。

解法：它用**一个代理工具（约 200 tokens）**替代成百上千个工具定义，模型按需发现要用的工具，server 只在真正使用时才启动。

pi install npm:pi-mcp-adapter

装完重启 Pi。它自动读取你已有的 .mcp.json 或 ~/.config/mcp/mcp.json；如果之前用过 Cursor / Claude Code / Codex，运行 /mcp setup 可以一键把它们的 MCP 配置导入 Pi。

适合：想接数据库、浏览器、各类 API 的 MCP server，又心疼上下文的人。这是整个 Pi 生态下载量第一的插件，没有之一。

2️⃣ pi-web-access —— 给 Agent 装上网线

Pi 默认不能上网。这个插件补齐了搜索、抓取、视频理解全套能力，而且零配置起步：内置 Exa 搜索无需任何 API key；如果你用 Codex 订阅登录，还能复用 OpenAI 的搜索授权。

pi install npm:pi-web-access

能力清单：

🔍 Web 搜索（支持 20+ 提供商：Brave、Tavily、Firecrawl、Jina、Kagi、SearXNG 自托管……）
📄 URL 抓取、GitHub 仓库克隆、PDF 提取
🎬 YouTube 视频理解：扔个链接就能问视频里讲了什么
📹 本地录屏 / 视频分析

适合：写代码要查文档、查报错、调研竞品的人。装上它，Pi 才从「代码编辑器」变成「全能 Agent」。

3️⃣ pi-subagents —— 补上 Pi 默认没有的子代理

Pi 官方默认跳过子代理（为了保持极简）。但复杂任务确实需要分工——这个插件用最自然的方式补上了：不用配置任何东西，直接用大白话调用。

pi install npm:pi-subagents

装完后你可以直接说：

Use reviewer to review this diff.（用 reviewer 审查这个 diff）Ask oracle for a second opinion on my current plan.（让 oracle 对我的计划提第二意见，挑战我的假设）Run parallel reviewers: one for correctness, one for tests, and one for unnecessary complexity.（并行跑三个 reviewer：一个查正确性、一个查测试、一个查过度设计）

子代理是独立的子会话，前台运行实时流式输出，后台运行可稍后查看结果。适合：代码审查、侦察式调研、并行审计、多视角验证。

4️⃣ @juicesharp/rpiv-ask-user-question —— 该问就问，别瞎猜

Agent 最常见的翻车方式之一：需求不明时瞎猜。这个插件让模型在猜测之前，用结构化问卷向你提问——带类型选项（选择、确认、输入），而不是自由文本，回答成本极低。

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

适合：需求含糊的复杂任务。装上之后你会明显感觉 Pi「靠谱」了——它不再自作主张，而是先花 10 秒把关键决策问清楚。

5️⃣ pi-background-tasks —— 长任务不阻塞对话

跑测试、起 dev server、迁移 dry-run……这些长任务以前会占住 Pi 整个会话。这个插件让它们转到后台执行，你继续和 Pi 聊别的，任务完成时收到通知。

pi install npm:pi-background-tasks

/bg 启动后台任务，/jobs/logs/kill 管理
支持只读委托子代理：派一个只读的子 Pi 去调研，结果哈希校验后带回
进阶玩法 Fusion：同时跑三个候选子代理 + 盲评 + 合并，用于推理、调研、验证类任务

适合：长时间构建、监控型任务、多模型交叉验证的重度用户。

6️⃣ @juicesharp/rpiv-todo —— 实时待办浮层

模型维护的待办清单，以实时浮层形式常驻终端，最妙的是：/reload 和上下文压缩之后依然存活——任务进度不丢。

pi install npm:@juicesharp/rpiv-todo

适合：多步骤任务（重构、迁移、写系列文章）。你能实时看到 Agent 干到哪一步、还剩几步，掌控感直接拉满。

7️⃣ pi-lens —— 写代码的实时反馈系统

每次写入/编辑后，自动跑 LSP 诊断、lint、类型检查、格式化，有问题当场反馈，还能 autofix；基于 ast-grep / tree-sitter 的结构性规则能抓正确性和安全隐患。

pi install npm:pi-lens

亮点功能：/lens-map 生成交互式 HTML 依赖图；symbol_search 全局符号检索；诊断结果可标记误报/忽略/延期，跨会话生效。

适合：TypeScript、Python、Go 等强类型项目的日常开发——相当于给 Pi 配了个「实时编译报错 + 代码评审员」。

8️⃣ pi-dynamic-workflows —— 重型玩家的动态工作流

Claude Code 风格的动态工作流：把一个任务扇出到 100+ 子代理并行执行，带真实的模型路由、token/成本核算、断点续跑、git worktree 隔离，还内置了一个正经的 /deep-research 深度研究命令。

pi install npm:@quintinshaw/pi-dynamic-workflows

适合：大型重构、批量代码审查、深度调研等「一个人干不完」的任务。轻量用户可以先跳过它，等前面 7 个用顺手了再上。

四、记忆类：让 Pi 记住你

Pi 的会话是树状结构，但跨会话记忆需要插件补齐。两个选择：

插件	特点	安装
`pi-memory`	语义搜索（qmd），覆盖日志、长期记忆、草稿本	`pi install npm:pi-memory`
`pi-hermes-memory`	持久记忆 + 会话搜索 + 密钥扫描；SQLite FTS5；732 个测试，从 Hermes agent 移植	`pi install npm:pi-hermes-memory`

另外两个小而美：

@ff-labs/pi-fff：FFF 模糊文件/内容搜索，比内置 grep 好用（~3.5 万下载）
pi-powerline-footer：Powerline 风格底部状态栏，终端颜值党必备（~3 万下载）

五、组合方案：按需取用

🟢 新手三件套（5 分钟装完）

pi install npm:pi-web-accesspi install npm:pi-subagentspi install npm:@juicesharp/rpiv-todo

上网 + 子代理 + 任务浮层，日常开发已经够用。

🔵 生产力进阶（+4 个）

pi install npm:pi-mcp-adapterpi install npm:pi-lenspi install npm:@juicesharp/rpiv-ask-user-questionpi install npm:pi-background-tasks

接 MCP 生态、实时代码反馈、少踩「瞎猜」的坑、长任务不阻塞。

🟣 重型满配（再 +3 个）

pi install npm:@quintinshaw/pi-dynamic-workflowspi install npm:pi-hermes-memorypi install npm:pi-powerline-footer

动态工作流 + 长期记忆 + 颜值，接近「满配作战」。

六、总结

Pi 的插件生态一句话概括：核心极简，能力按需装配。它不会像 Claude Code 那样开箱即满配，但正因为如此，你装的每一个插件都是你真正需要的——没有冗余，没有上下文浪费。

记住三条原则：

按需安装：插件越多，上下文和安全隐患越多。先装新手三件套，用顺手再加。
只信可信源：扩展有完整系统权限，装之前扫一眼源码。
善用 pi -e 试用：不确定要不要装？临时跑一次，不落盘，用完即弃。

下篇预告：《Pi Agent 自定义扩展开发：半小时写一个自己的插件》——从零手写一个 TypeScript 扩展，注册自定义工具和命令，把你的工作流固化进 Pi。

参考资料：Pi 官方文档（pi.dev/docs/latest）、npm 官方仓库各包 README（nicobailon/pi-mcp-adapter、nicobailon/pi-web-access、nicobailon/pi-subagents、apmantza/pi-lens、juicesharp/rpiv-mono、ismailsaleekh/pi-background-tasks、quintinshaw/pi-dynamic-workflows 等）。