$ ls ~/.pi/agent/extensions --all # 29 个扩展、插件与工具
Pi 扩展与插件精选
这是一份精选清单，不是大仓库：29 个条目按你要干的活分组——想要窗口而不是终端、想让会话经得起重启、想把密钥挡在上下文之外——每条给出真实的安装命令和一句实在的「什么时候别装」。完整的 130 条人工核实条目——主题、技能、模板与教程都在内——就在下一站的资源地图上。
00 官方基座(3) · #
什么情况用这一类 — 每个 pi 环境从这里起步——本体 CLI 与官方技能包。
$ @earendil-works/pi-coding-agent↗
官方 npm 包——一条命令即可安装 Pi 编程 agent CLI。
$ npm install -g --ignore-scripts @earendil-works/pi-coding-agent
什么时候别用 — 已经在用 pi 了？那你已经有它了——这是本体 CLI，不是外挂。
$ pi-skills↗
Pi 官方技能合集，同时兼容 Claude Code 与 Codex CLI。
$ git clone https://github.com/badlogic/pi-skills ~/.pi/agent/skills/pi-skills
什么时候别用 — 想要的是工具和代码而不是提示词技能？官方包里是说明书不是可执行物，往下挑工具类。
01 桌面 / GUI(4) · #
什么情况用这一类 — 不想待在终端里——要窗口、会话列表、多标签。
$ Pi for VS Code↗
把真正的 pi TUI 跑进 VS Code 侧边栏：xterm.js 加真实伪终端，斜杠命令、键位与主题和终端里一模一样。
$ 从 GitHub releases 页面下载 VSIX（pi-for-vscode-<version>.vsix），可选对照同一 release 里的 SHA256SUMS.txt 校验，再运行 code --install-extension pi-for-vscode-*.vsix——没有 Marketplace 上架
什么时候别用 — 不用 VS Code？它只在 VS Code 里驱动 pi——别的编辑器在地图另有分区。
02 会话与历史(4) · #
什么情况用这一类 — 经常回滚、续聊、跨终端或跨机器交接会话——或者丢过一次好对话。
$ pi-rewind-hook↗
记录文件状态回滚点的 pi 扩展——/tree 导航、分支与会话恢复都能在对话之外把文件精确还原到某个时间点。
$ pi install npm:pi-rewind-hook
什么时候别用 — 从不回滚？它每轮都给工作区做快照，纯属为你用不上的功能付账。
$ pi-better-rewind-redo↗
从任意历史消息一并回退文件与会话，支持多级重做与中断恢复。
$ pi install npm:pi-better-rewind-redo
什么时候别用 — 偶尔撤销一次，自带 /rewind 就够——只有频繁回滚还想重做的人才需要它。
$ pi-relay↗
斜杠命令式交接：agent 写出封存的交接记录，后继会话在你选定的模型上核验后继续。
$ 用 pi install git:github.com/jpowersdev/pi-relay@v0.1.0 安装指定 tag 并重启 pi；升级时显式安装新 tag 即可，也可以用 pi -e git:github.com/jpowersdev/pi-relay 临时试用当前代码而不永久安装
什么时候别用 — 单机单终端？Relay 是为跨机交接而生的——真要交接时再装。
$ CCompactor↗
把已结束的 pi、Claude Code、Codex 会话蒸馏成可校验的交接产物，TypeScript 实现。
$ npm i -g ccompactor（或从 GitHub releases 下载 macOS、Linux、Windows 的独立二进制）
什么时候别用 — 会话很短、压缩从没触发过？它的导出/交接流程你一辈子也碰不到。
03 上下文与记忆(5) · #
什么情况用这一类 — 会话一长就忘事、token 烧得太快。
$ Pi MCP Adapter↗
在 Pi 中使用 MCP 服务器，同时避免耗尽上下文窗口。
$ pi install npm:pi-mcp-adapter
什么时候别用 — 没有 MCP 服务器要接？适配器只是管道——没东西可挂载时它什么也不做。
$ Pi Web Access↗
为 Pi agent 提供网页搜索、内容提取和视频理解能力。
$ pi install npm:pi-web-access
什么时候别用 — 干活从来不需要联网查资料？搜索与抓取只会白白多花时间和 token。
$ pi-rolling-compaction↗
在上下文达到窗口的可配置阈值（默认 50%）时即触发 pi 内置压缩，让大上下文模型始终拿到一份持续维护的滚动摘要，避免在接近满载时一次性丢失大量历史。
$ cp rolling-compaction.ts ~/.pi/agent/extensions/
什么时候别用 — 对 pi 自带的压缩没意见？滚动摘要会改变模型中途「记得」什么——原版够用就别折腾。
$ pi-experience↗
经历记忆扩展：原始 Run 写入自有 SQLite 供 TUI 审计，主 Agent 归并出可跨会话的经历。
$ npm ci 后 pi -e ./src/index.ts 一次性加载，或 pi install /absolute/path/to/pi-experience 安装为本地 pi 包；需 Node.js 24+ 与 pi 0.85.1
什么时候别用 — 想要零维护的自动记忆？experience 的 sqlite 记忆库得靠你平时打理才有用。
04 安全与密钥(4) · #
什么情况用这一类 — 手里有真 key、真仓库——把密钥挡在上下文之外，让规则每轮都生效。
$ motus↗
把 API key 挡在 pi 会话之外：替换工具输出中的精确密钥值，封锁会打印密钥的命令与文件，fail closed。
$ pi install npm:@espadat/motus（必须全局，不要 --local），然后把它在 ~/.pi/agent/settings.json 的 packages 里移到首位——pi install 只会追加到末尾，而处理器按加载顺序运行——再创建 ~/.config/motus/config.toml，否则每个会话都以降级状态启动。Claude Code 侧：npm install --global @espadat/motus，并把 motus-cc-hook 注册为 PreToolUse 钩子。
什么时候别用 — 会话里从不碰真 key（全是一次性环境）？那就没有可拦截的东西。
$ pi-jev-sentinel↗
用 Jev 给工具调用、工具输出与回复把关：风险打分、注入检测与密钥脱敏，绝不自动放行。
$ 运行 pi install git:github.com/harshwasan/pi-jev-sentinel，然后在启动 pi 前 export TYPESAFE_API_KEY；免安装试用可运行 pi -e git:github.com/harshwasan/pi-jev-sentinel。
什么时候别用 — 提示词只来自你自己和可信文件？它防的是你根本不会遇到的工具输出注入。
$ pi-edit-guard↗
挂在内置 edit 名下的修复与匹配管线：纠正畸形参数，容错空白差异定位文本。
$ pi install npm:pi-edit-guard
什么时候别用 — 反正每个 diff 都会亲自过目？自动修复改坏的编辑等于重复你自己的流程。
05 多 agent 与编排(5) · #
什么情况用这一类 — 一个 agent 不够用——拆子 agent、分屏跑、还得拴住它们。
$ pi-workflow↗
为 Pi 提供可复用的多步工作流：调研、代码评审、规范检查等。
$ pi install npm:@agwab/pi-workflow
什么时候别用 — 一个 agent 一次一件事？多步编排对单干会话纯属累赘。
$ pi-tmux-orchestrator↗
Pi 扩展 + 无依赖的 Python CLI，把实现者、评审员与可选探针 agent 编排进可监控的 tmux 网格，并提供单次运行的 Unix 域套接字 broker。
$ pi install npm:pi-tmux-orchestrator
什么时候别用 — 永远只开一个终端窗格？它是管理 tmux 舰队的——单窗格用不上。
$ pi-flows↗
把工作委托给隔离的、有预算约束的 pi 子 agent——侦察、评审、任务分解——并提供成本上限、OpenInference 追踪和契约校验。
$ pi install npm:pi-flows
什么时候别用 — 偶尔派个一次性子 agent 就够？flows 是给带追踪、带预算的批量流水线用的。
06 评测与调试(4) · #
什么情况用这一类 — 要对比模型、追首字延迟、查 token 都花在哪了。
$ pi-arena↗
为 pi 编码 agent 办一场可复现的公平比赛：同一任务、隔离工作区、客观评分，外加浏览器回放控制台。
$ 克隆仓库，跑 npm run demo 观看确定性的三选手本地比赛（不耗 API），再打开 arena-demo/index.html 查看回放控制台；按 SKILL_USAGE.md，pi install <本地克隆路径> 可把包装进 pi，会话内用 /skill:arena 加载 skills/arena/SKILL.md 里的比赛协议。
什么时候别用 — 不比模型也不比提示词？没有对手要跑的基准台就是摆设。
$ pi-cache-lens↗
在状态栏显示单次与会话级 KV 缓存命中率，后台取证归因每一次缓存丢失。
$ pi install git:github.com/w31r4/pi-cache-lens，之后随时可用 pi update 更新。状态栏芯片在内置 pi 页脚中自动渲染；pi-powerline-footer 与 pi-cc-extensions 的集成片段在 README 里有文档。
什么时候别用 — 账单正常、也不在意缓存命中？这台显微镜没有打开的理由。
$ pi-tool-timeout↗
前台工具的超时覆盖层：bash、powershell 默认 300 秒，grep、find 以包装时限执行。
$ 运行 pi install git:github.com/GhabiX/pi-tool-timeout（文档同样给出本地路径与项目级安装方式）；面向 pi 0.85.x，需要 Node 22.19.0 或更新版本，装完重启 pi 或运行 /reload
什么时候别用 — 工具向来秒回？超时保护这种“装完就忘”的东西，等真卡死了再装不迟。
## 怎么选
别管分类，从你的处境出发——每一行直指契合的两三个条目。
- 想要窗口，而不是终端先看:Pi Web·pi-gui·Pie
- 总在弄丢好会话（或经常回滚来之不易的进度）先看:pi-rewind-hook·pi-better-rewind-redo·pi-relay
- 手里有真 API key 和私有仓库先看:motus·pi-heed·pi-jev-sentinel
- 一个 agent 不够用——你想带一支舰队先看:pi-workflow·pi-tmux-orchestrator·pi-flows
- 要把会话交给队友，或跨机器交接先看:pi-relay·CCompactor
- 不知道从哪开始——先把基座装好先看:@earendil-works/pi-coding-agent·pi-skills
## 常见问题
Q 第一个该装哪个扩展？
多半一个都不用——pi 本体（agent 循环、内置工具、会话）已经够日常用了，第一个值得装的也不是工具：pi-skills 是官方技能包。如果你真正想要的是用窗口代替终端，那先装 Pi Web。
Q pi 扩展安全吗？
把它们当 npm 包看待，而不是浏览器插件：扩展是以你的完整系统权限运行在 pi 进程里的 TypeScript 模块，没有沙箱。只装你读得懂或信得过的；一旦用上真 key，motus 和 pi-heed 能把密钥挡在上下文之外、让规则每轮生效。
Q 扩展、skill、theme 有什么区别？
扩展是给 agent 循环增加工具、斜杠命令或 UI 的 TypeScript 模块；skill 是提示词层面的说明包，改变的是 pi 的行为方式而不是它能执行什么（pi-skills 是官方那套）；theme 只调终端配色。三类东西并存在 ~/.pi/agent/ 下。
Q 怎么卸载扩展？
凡是 pi install 装的，跑 pi remove npm:@scope/pkg（pi uninstall 是别名）——包会从 settings.json 移除，下个会话起不再加载。文件形态的扩展就是文件本身：把 .ts 从 ~/.pi/agent/extensions/（或项目里的 .pi/extensions/）删掉即可。完整矩阵见《Pi 的安装与更新》。
Q 怎么更新已装的扩展？
pi update --extensions 一次更新全部已装包；pi update npm:@scope/pkg 只更新一个。钉了版本的包（npm:pkg@1.2.3 或 git ref）会被有意跳过——pi update --all 会把它们对齐到钉住的版本而不改动钉。
Q 必须用 npm 才能装扩展吗？
不用。把一个 .ts 文件放进 ~/.pi/agent/extensions/ 就能加载，完全不需要打包。已发布的包默认确实走 npm 解析，但 pi install 也接受 git: URL（pi install git:host/user/repo@ref），没上 registry 的东西也能装。
Q 为什么这里只列了 29 条？
本页是精选——按用途分组、每条带一句实在的「什么时候别装」。完整的 130 条人工核实条目（含主题、模板与教程）就在下一屏的资源地图上；所有已发布的包则在官方包目录。