Pi 扩展生态与插件推荐
本文分享经高强度使用 Pi + Kimi-K3 组合后整理的一套实用插件：基础类（子代理、MCP、Web 访问）、流程类（todo、问卷、计划模式）、上下文类、界面优化类、备份同步类，以及使用小贴士。
前言
这几天一直在高强度使用 Pi + Kimi-K3 这套组合，越用越觉得十分顺手。被 GPT 画的神必前端界面折磨了太久，这次竟感到了久违的省心……（不过工作日下午 Kimi 还是会遇到 429，希望官方可以尽快扩充算力储备，或许等开源了会好些？）
可能有些朋友还不太了解 Pi，这里先简单介绍一下：
Pi 是一个 Agent，与 Codex、Claude Code 不同的是，它并不是开箱即用的。它的功能很少，可以说是个毛坯房，MCP、子代理、计划模式这些统统没有。
Pi 的理念是非必要的东西一律不加，与此同时，它的扩展性极强，内置官方文档，可以很方便地自己开发想要的功能，官方也有自己的插件市场。
在我的理解里，Pi 负责提供极简的基座 Agent，由用户自定义各项功能，最后组合出自己顺手的 Agent 工具。
回到正题，这几天一边用一边整理插件，目前列表算是比较稳定，没有什么特别想加的了。这里分享出来，权当抛砖引玉。
基础类
@gotgenes/pi-subagents
提供可并行派发的进程内子代理功能。与后面要介绍的权限系统出自同一作者，两者有联动——子代理触发权限规则时，询问弹窗会转发到主界面，体验很丝滑。自带三个子 Agent 角色：
- general-purpose：通用复杂任务
- Explore：快速仓库探索（只读）
- Plan：架构规划（只读）
同时支持自定义新 Agent 角色，轻量实用。
pi-mcp-adapter
提供 MCP 适配，通过懒加载方式接入，按需调用 MCP 工具。如果你需要使用 MCP 生态中的各类工具（数据库操作、API 调用等），这是目前最简洁的接入方式。
pi-web-access
提供联网能力，比如网页搜索、抓取 URL 等。不过有两点需要注意：
- 首次安装后，每次搜索都会打开网页展示总结，如果觉得烦人，可以让 Pi 修改
~/.pi/web-search.json，加入以下配置关闭：
{
"workflow": "none"
}
- 该插件需要配合可用的搜索 API 使用。
流程类
@juicesharp/rpiv-todo
提供结构化、可视化的待办清单工具。与计划模式配合使用效果更佳——确认计划开始执行后，模型一般会自动创建待办清单，一气呵成。
@juicesharp/rpiv-ask-user-question
提供问卷工具，给予 Agent 主动提问的能力。当需求不明确时，Agent 可以通过结构化的问卷向用户确认细节，避免盲目开干。
@narumitw/pi-plan-mode
一个简洁的、Codex 风格的计划模式，且可以很方便地配置在计划模式下的工具白名单。
自带两个必备工具：一个用于计划模式下的提问，一个用于主动结束计划模式，除此之外没有任何多余功能，恰到好处。
使用 /plan 命令进入计划模式后，再次输入 /plan 即可出现菜单，选择相应选项即可快速配置计划模式下的工具白名单。
⚠️ 当时安装的时候允许的工具列表里只有插件自带的两个工具，导致无法读取文件，建议第一次安装优先配置一下工具白名单。
如果同时安装了 rpiv-todo，那么确认计划开始执行之后，模型一般会自动创建待办清单，流程衔接非常自然。
上下文类
@cortexkit/pi-magic-context
站内很多朋友推荐过的插件，用了一下确实不错。给 Pi 补充跨会话记忆和上下文管理的能力，后台会自动压缩对话，项目级记忆持续保留，新开会话也能回忆起之前的决策和约定。还有 Dreamer 机制定期整理记忆。
它有自己的压缩机制和记忆系统，模型可以通过工具写入和查询记忆。使用 K3 时，它会自己调用工具选择性地写入记忆。
⚠️ 建议用官方仓库里的安装命令进行安装，它会自动把 Pi 自带的压缩关掉——两边同时开着会互相干扰。
@mrclrchtr/supi-claude-md
提供两个命令用于维护 AGENTS.md / CLAUDE.md：
/claude-md-improver：对整个仓库里的 AGENTS.md / CLAUDE.md 做一次质量审查和改进。/claude-md-revision：把当前会话中学到的、与项目相关的持久经验写进 AGENTS.md / CLAUDE.md。
对于需要长期维护的项目来说非常实用，可以不断沉淀项目知识。
pi-cache-optimizer
优化缓存命中率的插件，可选安装。如果发现模型频繁读取相同文件导致 token 消耗较大，这个插件能起到一定缓解作用。
界面优化类
pi-tool-display
提供紧凑型的工具渲染，安装后可以使用 /tool-display 进行自定义，且可以通过配置文件兼容非官方内置工具。能让 Pi 的 toolcall block 变得简洁清晰，edit diff 记录更美观，还可以根据终端宽度自动切换 split/unified 显示模式。
⚠️ 它会覆盖注册 Pi 的内置工具，有可能会跟其他调整了 Pi 内置工具的扩展冲突。
@narumitw/pi-statusline
非常好看的 Pi 状态栏美化插件，效果立竿见影。安装后即可在 Pi 界面底部看到美观的状态栏，显示当前状态信息，整体风格与 Pi 契合度很高。
备份同步类
pi-webdav-sync
提供两个斜杠命令，用于快速便捷地将 Pi 的个人配置备份/还原到 WebDAV（比如坚果云），实现跨设备同步。
对于多设备使用 Pi 的用户来说几乎是必备插件——配置一次，所有设备同步，再也不用手动复制配置文件了。
使用小贴士
关于搜索工具
有些扩展可能会激活 Pi 内置的 grep、find、ls 这三个默认隐藏的命令，导致工具列表里同时出现多套搜索工具，这时一些模型会优先使用较慢的内置工具而非增强版。
目前的解决办法：使用 pi --exclude-tools find,grep 排除内置的搜索工具。这个参数从 Pi v0.77.0 开始支持。
关于工具冲突
多个扩展如果都修改了 Pi 的同一组件（如输入框、工具渲染等），可能会出现冲突。具体谁覆盖谁取决于扩展的加载顺序，极端情况下可能报错。建议安装新扩展后先简单测试一下核心功能是否正常。
关于插件选择原则
个人理念是无论使用什么 Agent，先装一些通用的基础插件，之后再根据具体需求增加插件并根据项目选择性开启。
尽量避免一上来就装一大堆重型插件，尤其是那种大而全的包办类型插件质量往往不高。功能复杂往往导致架构和实现复杂，维护困难。很多时候根据不同的项目需求自己写 Skills / 插件 / 工作流效果更好，没必要什么级别的项目都非要用重型框架和重型扩展。
对于 Pi 的 Packages 也是——并不是下载量越高就越好用，得根据自己实际需求来选。
验证与自查
pi list能列出已安装的包，且状态为启用- 各插件的斜杠命令可用：
/plan进入计划模式、/todo创建待办、/tool-display打开渲染配置 pi --exclude-tools find,grep启动后，会话中模型不再调用内置find/grep- 安装新扩展后先在一个小任务上验证核心功能，确认没有工具冲突
结语
应该就这些了，其实还装了别的一些插件，但感觉不是很有必要就没有写上去。目前我使用场景主要是让 Agent 以本地文档为开发依赖，所以暂时并没有配搜索的扩展 / MCP / Skills。
如果你也有什么觉得好用的插件，欢迎分享交流！