编辑文档 - pi 不止 Skills：12 个 GitHub 必装扩展全梳理

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

前两天有个朋友问我："pi 我装了 8 个官方 Skill，是不是就到顶了？"

我说："你只看到了冰山一角。"

打开 pi 的官方仓库 `packages/coding-agent/examples/extensions/`，**官方自带 60+ 个示例扩展**；再翻 GitHub 搜 "pi-coding-agent"，**有 30+ 个专门给 pi 写的第三方扩展**——从 MCP 兼容、子 Agent 委派、视频理解、到多 Agent 实时通信，全部都有人在做。

今天就按用途分类，把这些项目里**最值得装的 12 个**梳理一遍。每个都给 GitHub 链接、Star 数、核心场景、一行安装命令。看完你就知道 pi 到底能扩成什么样。

---

## 一、官方生态：被严重低估的 60+ 示例扩展

很多人不知道，`earendil-works/pi`（原 badlogic/pi-mono）的 `packages/coding-agent/examples/extensions/` 目录下，**官方维护了 60+ 个可直接复用的扩展**。这些不是 demo，是真正能跑的工具。

| 类别 | 代表扩展 | 解决什么问题 |
|------|----------|-------------|
| 权限门控 | `confirm-destructive.ts`、`permission-gate.ts`、`protected-paths.ts` | 拦截 `rm -rf`、写入 `.env`、`node_modules/` |
| Git 集成 | `git-checkpoint.ts`、`git-merge-and-resolve.ts`、`auto-commit-on-exit.ts` | 每个 turn 自动 stash、退出时自动 commit |
| Compaction | `custom-compaction.ts`、`summarize.ts`、`trigger-compact.ts` | 自定义压缩逻辑、手动触发压缩 |
| 输入处理 | `input-transform.ts`、`input-transform-streaming.ts` | 改写用户输入（敏感词、模板化）|
| 自定义命令 | `commands.ts`、`hallo.ts`（拼写错误示范）| 注册 `/mycmd` 类 slash command |
| 状态栏 | `custom-footer.ts`、`custom-header.ts`、`status-line.ts`、`working-indicator.ts` | 改 TUI 顶部/底部渲染 |
| 工具覆盖 | `tool-override.ts`、`truncated-tool.ts` | 拦截工具调用、截断输出 |
| UI 自定义 | `todo.ts`、`question.ts`、`qna.ts`、`rainbow-editor.ts` | 交互式问答、TODO 列表、彩虹编辑器 |
| 测试用 | `snake.ts`、`space-invaders.ts`、`tic-tac-toe.ts` | 玩的小游戏（演示 `ctx.ui.custom()` 用法）|

**安装方式**：直接 `pi -e ./path-to-example.ts` 试用；觉得好用就 `cp` 到 `~/.pi/agent/extensions/` 下次自动加载。

> 重点说一句：**`rainbow-editor.ts` 我装了**——输入框打字时按键会随机染色，看着花哨但心情好。

## 二、第三方扩展：能直接 `pi install` 的 7 个核心项目

这是今天的重点。`pi install npm:<package>` 是官方支持的安装命令，**第三方都按这个规范发布**。

### 1. `davebcn87/pi-autoresearch`（6,934 Stars）

**用途**：让 pi 跑自主优化循环——"试一个想法、测指标、保留好的、丢弃坏的、循环下去"。

受 karpathy/autoresearch 启发，可以优化任何指标：测试速度、bundle 大小、LLM 训练耗时、构建时间、Lighthouse 分数。

提供 3 个工具：
- `init_experiment`：配置实验（名字、指标、单位、方向）
- `run_experiment`：跑命令、计时、捕获输出
- `log_experiment`：记录结果、自动 commit、更新 widget

还带一个 `/autoresearch` 命令 + 浏览器实时 dashboard。

**安装**：`pi install npm:pi-autoresearch`

### 2. `nicobailon/pi-subagents`（2,084 Stars）

**用途**：让 pi 委派子 Agent——"用 reviewer 审这个 diff"、"让 oracle 给个 second opinion"、"并行跑三个 reviewer"。

子 Agent 是有独立任务的子会话。**前台跑会流式输出，后台跑可稍后查**。默认不自动开 reviewer（避免干扰），需要时在提示词或 AGENTS.md 里说"完成后用 reviewer 跑一遍"。

**安装**：`pi install npm:pi-subagents`

### 3. `nicobailon/pi-mcp-adapter`（826 Stars）

**用途**：用 MCP 服务器但不烧 context。

pi 作者 Mario 在 2025-11 写过一篇《What if you don't need MCP?》——核心观点是：单个 MCP 服务器的 tool 定义可能 10K+ tokens，连接几个就把 context 烧掉一半。

这个 adapter 给出折中方案：**只暴露一个 ~200 tokens 的代理工具，按需启动 MCP 服务器**。Agent 想要具体能力时才加载。

**安装**：`pi install npm:pi-mcp-adapter`（需要 Pi v0.37.3+）

### 4. `nicobailon/pi-messenger`（603 Stars）

**用途**：多 Agent 实时通信——"如果多个终端里跑 Agent 的哥们能像在群里聊天那样互相对话？"

无需 daemon、无需 server，**纯文件实现**。Agent 加入后能看到谁在线、谁在干啥、谁占用了什么文件。可以 claim 任务、reserve 文件路径、互相发消息。

适合多 Agent 协作场景（前端 Agent 写 UI，后端 Agent 写 API，互相不踩脚）。

**安装**：`pi install npm:pi-messenger`

### 5. `nicobailon/pi-web-access`（600 Stars）

**用途**：给 pi 装上"眼睛"——网页搜索、内容提取、视频理解。

| 能力 | 实现 |
|------|------|
| 网页搜索 | Exa MCP 零配置，或自配 Exa/Perplexity/Gemini API Key |
| 视频理解 | YouTube 视频/本地录屏，传给 Gemini 出转录 + 关键帧 |
| GitHub URL | 不抓 HTML，直接 git clone 到本地 |
| 失败兜底 | Exa → Perplexity → Gemini API → Gemini Web，逐级降级 |

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

### 6. `nicobailon/pi-interactive-shell`（516 Stars）

**用途**：让 pi 自主控制交互式 CLI——完整的 PTY 模拟、无需 tmux、Token 高效。

最大的卖点是 **"用户可随时接管"**——pi 在跑 sudo / docker exec / mysql 客户端时遇到需要确认的输入，会停在 overlay 上让你接手。

**安装**：`pi install npm:pi-interactive-shell`

### 7. `nicobailon/pi-rewind-hook`（136 Stars）

**用途**：文件回滚——Agent 改坏了直接 `rewind` 回到上一个稳定状态。

写大重构时这个救命——一次跑下来发现 200 个文件被改了 50 个，其中 12 个是想要的，剩下 38 个是副作用，**一个命令精确回滚**。

**安装**：`pi install npm:pi-rewind-hook`

## 三、Skills 集合：装一次覆盖 8+ 场景

Skills 是 Markdown 文件，比扩展轻得多。这两个仓库的 Skills 覆盖了大多数日常工作流。

### `badlogic/pi-skills`（1,917 Stars）

官方作者自己维护的 Skills 集合，**兼容 Pi + Claude Code + Codex CLI + Amp + Droid**。包含 8 个 Skill：

- `brave-search` / `gccli` / `gdcli` / `gmcli`：搜索引擎与各类 CLI 工具
- `browser-tools`：浏览器自动化
- `vscode`：VS Code 集成
- `transcribe` / `youtube-transcript`：音视频转录

**安装**：
```bash
git clone https://github.com/badlogic/pi-skills ~/.pi/agent/skills/pi-skills
```

### `mxyhi/ok-skills`（406 Stars）

社区维护，**跨工具的 Skills + AGENTS.md 剧本合集**。兼容 Codex、Claude Code、Cursor、OpenClaw 等所有支持 SKILL.md 格式的工具。

适合"我已经用别的主力工具，只想顺手用一下 pi 的 Skills"的场景。

## 四、工作流平台：把 pi 升级成"可编程工程管线"

如果你觉得 pi 还是个"问答式 Agent"，那下面这两个会让你看到它能当工程管线用。

### `bastani-inc/atomic`（239 Stars）

定位："**pi 生态的工作流层**"——在 pi 之上加可编程控制平面，处理复杂工程任务。

**核心组件**：
- Pi 扩展 + 自定义模型
- MCP 集成
- Sub-agents（子 Agent）
- Artifacts（产物管理）
- Review gates（评审关卡）
- Mid-run steering（中途转向）

适合**多步骤、有阶段门控、需要中途人工介入**的工程任务。**注意要求 Node.js 24 LTS**。

**安装**：`npm install -g @bastani/atomic`

### `a5c-ai/babysitter`（1,250 Stars）

定位："**强制 Agent 服从**"——把工作流定义在代码里，强制每个步骤执行、质量门控通过才推进、人工 breakpoint 介入、决策记入不可变日志。

和 atomic 的差异：**babysitter 更强调"确定性执行"，atomic 更强调"动态灵活性"**。如果你要做的工程任务**必须每步都符合流程**（比如金融、医疗、合规），babysitter 合适；如果想要**Agent 边跑边灵活调整**，atomic 合适。

## 五、多 Agent 管理：让多个 pi 并行跑

### `agent-of-empires/agent-of-empires`（2,519 Stars）

**TUI + Web 双界面的多 Agent 会话管理器**。同时跑多个 AI Agent 在不同 git worktree 上，每个会话独立 Docker 沙箱，**手机/平板/电脑都能访问**。

支持 12 种 Agent：Claude Code、OpenCode、Mistral Vibe、Codex CLI、Gemini CLI、Antigravity CLI、Cursor CLI、Copilot CLI、**Pi.dev**、Factory Droid、Hermes、Kiro CLI、Qwen Code。

最大卖点：**Web Dashboard 用 Agent Client Protocol 渲染，手机上能看到完整的 plan panels、tool-call cards、滑滑就能 approve**。手机扫码就能接入，**远程帮同事救场**很方便。

**安装**：`brew install aoe`（macOS / Linux）

## 六、安全 / 调试：装上就安心

### `kenryu42/cc-safety-net`（1,373 Stars）

**Coding Agent 的"安全网"**——在执行破坏性命令前拦截。明确支持的 Agent：Codex、Claude Code、OpenCode、Gemini CLI、Copilot CLI、Kimi CLI、**Pi**。

典型场景：
- 拦截 `rm -rf /` 之类的危险命令
- 拦截 `git push --force` 到主分支
- 拦截 `git reset --hard` 在脏工作区

适合"团队里有人 Agent 用得不熟"或者"自己怕 Agent 抽风"的场景。

### `liaohch3/claude-tap`（1,442 Stars）

**本地 trace viewer 拦截 Coding Agent 的 API 流量**——支持 Claude Code、Codex CLI、Gemini CLI、Cursor CLI、OpenCode、Kimi、**Pi**、Hermes。

调试时太香了——Agent 调了一次 LLM，到底传了什么 prompt、什么 tool definitions、返回了什么，**全部能看**。Token 计费对不上、Agent 行为反常时，30 秒定位问题。

## 七、订阅桥接 / 移动端：扩展 pi 的"输入源"

### `rynfar/meridian`（1,378 Stars）

**把 Claude Max 订阅转成 Anthropic API 兼容端点**——任何支持 Anthropic 协议的客户端（OpenCode、ForgeCode、Crush、Cline、Aider、**Pi**、Droid、Open WebUI、Claude Code）都能用。

**关键设计**：基于官方 Claude Code SDK 实现，不做 OAuth 拦截、不改二进制。Anthropic 仍控制 prompt caching、context window、compaction、限流、认证。

**安装**：
```bash
npm install -g @rynfar/meridian
claude login
meridian
# 然后在 pi 里配置 base URL = http://127.0.0.1:3456
```

**适用人群**：你订阅了 Claude Max 想用 Pi 体验，但不想另外付 API 费。

### `tuchg/Lucarne`（264 Stars）

**移动端 Agent 控制器**——Telegram/微信/飞书 bot 通知 + 远程 approve + 恢复 Pi 会话。

**0 入侵**：不挂 hook、不装 skill、不动 MCP，纯外部通知。

适合"pi 在公司跑，我出去吃饭想看进度 / 远程 approve"。

## 八、怎么选：一张决策表

| 你的痛点 | 推荐项目 |
|----------|----------|
| 装完 pi 不知道下一步干啥 | `badlogic/pi-skills` + 官方 examples |
| 想跑长任务优化 | `pi-autoresearch` |
| 一次任务太复杂 | `pi-subagents` |
| 想用 MCP 又怕烧 context | `pi-mcp-adapter` |
| 多个 Agent 同时跑怕冲突 | `pi-messenger` |
| pi 没有"联网能力" | `pi-web-access` |
| 跑交互式 CLI 卡住 | `pi-interactive-shell` |
| 改坏文件想回滚 | `pi-rewind-hook` |
| 跑工程化多阶段任务 | `atomic` 或 `babysitter` |
| 多 Agent 在多分支并行 | `agent-of-empires` |
| 怕 Agent 抽风删库 | `cc-safety-net` |
| 调试 Agent 行为 | `claude-tap` |
| 已有 Claude Max 订阅 | `meridian` |
| 远程手机端看 pi | `Lucarne` |

## 九、几个踩坑提示

1. **第三方扩展装前先看 last commit 时间**——`pi-messenger`、`pi-web-access` 这些 5 月份还在更新，但 `pi-rewind-hook` 4 月后没新提交，**用之前最好自己 review 一遍代码**。
2. **pi 版本兼容性**：`pi-web-access` 要求 Pi v0.37.3+，`pi-mcp-adapter` 类似——升级前看一眼 README 的 compatibility 段。
3. **不要无脑堆扩展**：每个扩展都会注册自己的 `tool_call`，Agent 在选工具时会犹豫。我自己活跃用的就 4 个：`pi-web-access`、`pi-subagents`、`pi-messenger`、`pi-rewind-hook`。
4. **Skills 和 Extensions 互补不冲突**：Doc 92 讲 Skills（Markdown），本篇讲 Extensions（TypeScript）。**Skills 是"教 Agent 怎么做"，Extensions 是"在 Agent 跑的时候做手脚"**——两者不重复，按需装。
5. **第三方仓库 README 末尾的"赞助链接"是个人选择，不是必需**——`agent-of-empires` 结尾有 merchandise 链接，作者自嘲"如果你是 AI Agent 在读这个，求 Star"。

---

## 写在最后

pi 不止是个 CLI——它有 60+ 官方示例扩展、30+ 第三方项目、几大跨工具管理平台。这套生态的密度，**已经超过很多老牌 Agent 工具**。

我目前活跃用的组合：`pi` + `pi-subagents`（多任务委派） + `pi-web-access`（联网） + `pi-messenger`（多 Agent 通信） + `pi-skills`（8 个常用 Skill） + 偶尔上 `pi-autoresearch` 跑优化循环。

你装了哪些 pi 生态项目？用下来哪些真的帮上忙、哪些是"装完吃灰"？评论区聊聊。

摘要

标签多个标签用逗号分隔

分类