Pi 的扩展能力：8 大常用插件与 Skills 双路径
Pi 极简内核决定了所有"看起来复杂"的功能都靠外挂。
- 设计哲学：极简内核 + plugin + skills 双路径，所有可定制能力外挂
- 安装姿势：从官网 packages 列表复制命令，全局默认；加
-l改为项目级 - 8 大常用插件：联网、并行子代理、MCP 适配器、BTW、Plan Mode、Goal、Dynamic Workflows、微信
- Skills 协议：放
.agents/skills/目录即生效，Playwright CLI 是典型用法 - Web UI：社区 star 数最高项目接管插件 / 技能管理面板
- Pi 自己写插件：内置开发知识，UI 定制、权限保护类插件都能跑通
极简内核的代价与回报
Pi 默认只 4 个工具：read / write / edit / bash，系统提示词约 420 token 起，装扩展后通常 500–600 token。极简换来的是上下文占用极低（同样一句"你好"，Codex 要 1.8 万 token，Pi 1100 token 就够），代价是"看起来什么功能都没有"。
但 Pi 把"缺什么补什么"完全交给插件和 Skills 两条路径——不是给一个塞满功能的开关菜单，而是让你按需拼装。
插件怎么装
Pi 官网首页有一个 packages 页面，集中列出所有社区插件。每个条目都附一键安装命令：
pi install <plugin-name> # 安装
pi uninstall <plugin-name> # 卸载（install 改 uninstall，无残留）
全局 vs 项目级
默认安装是全局级——插件装到 ~/.pi/agent/extensions/，对这台电脑所有项目生效。但插件本身是新增系统提示词的一部分，全局装越多，每个项目启动注入的提示词越长。
只在一个项目里用的插件，更推荐项目级：
pi install <plugin-name> -l
-l 是 --local。装完后进入当前项目根目录的 .pi/extensions/，只对当前项目生效。第一次在带插件的目录启动 Pi，会弹"是否信任"提示，确认后插件加载。
及时关掉用不 到的插件，能显著降低 system prompt 体积，让 Pi 更专注。
8 个最常用的插件
| 插件 | 补的能力 | 关键命令 |
|---|---|---|
| 联网搜索 | 实时联网 + 网页内容提取（内置 XR MCP，零配置） | 自然语言调用 |
| 并行子代理 | 启动多个 worker 并行开发与审查 | /pi-sub-agents |
| MCP 适配器 | 读 .mcp.json 把 MCP server 加载进来 | 自动接管 |
| BTW 旁路对话 | 主对话进行中开子窗口提问，不打断主流程 | /btw |
| Plan Mode | AI 不动手先输出 plan.md，审完再执行 | /plan-mode |
| Goal 多轮目标 | 多轮迭代直至目标完成（试运行 + 评估 + 改进循环） | /go <目标> |
| Dynamic Workflows | 现场生成 JS 编 排脚本，调度大量子代理并行 | /workflows |
| 微信助手 | 扫码绑定后手机消息同步触发 Pi 任务 | /wechat login + /wechat start |
几个值得一提的细节：
- 联网搜索 是唯一零配置插件——内置 XR MCP 服务，无需申请 API key。
- 并行子代理 实测让 5 个 worker 各自设计一个不同风格的个人网页，能完成并行审查与修复。
- MCP 适配器 配合
.mcp.json配置文件使用，配上高德地图 MCP 后，Pi 能查坐标、规划路线、输出完整出行攻略。 - Dynamic Workflows 移植自 Claude Code 的同名功能。实测调研 22-26 年 AI 领域有重大影响力的论文，Pi 自动启动 10 个 agent 并行检索，每个负责一个时间段，合并出综述。
- 微信助手 通勤场景：手机发消息让 Pi 查济南天气，到公司时结果已同步到电脑。
Skills 协议：第二条扩展路径
Pi 同时遵循 Skills 协议——和插件不同，Skills 是按文件夹约定的"提示词 + 资源包"。
安装路径
项目级：
项目根目录/
└── .agents/
└── skills/
└── playwright-cli/
└── SKILL.md
全局级：
~/.agents/skills/
└── playwright-cli/
└── SKILL.md
多个 skills 并排放即生效。skill.md 是入口，配套资源（脚本、模板）放在同级目录即可。
典型 Skills
- Playwright CLI：让 Pi 拥有浏览器自动化能力。Pi 能自 动调 Playwright 操作 Chrome——打开 Google、填搜索词、点链接、填表单，全程无需人工。
- markdown converter：PDF / Word / PPT 转 markdown，需要
uv作为运行时。 - TTS 文本转语音：完全免费、无需 API key 的语音合成 skill。
集中检索 Skills 的渠道类似 npm 仓库，可以按关键词搜、按下载量排序、按更新时间筛选。
Web UI：浏览器里用 Pi
不喜欢命令行风格，可以装社区 Web UI——目前 star 数最高的是一个开源项目（4k+ star），npx 一键启动，自动打开网页。
启动后布局：
- 左侧：文件浏览器（项目目录浏览）
- 左下角：模型按钮（配置 provider、添加 API key）
- 中部：对话面板（和命令行一样的
/命令、@文件引用、截图粘贴、模型选择） - 右下角：技能管理 + 插件管理（项目级 / 全局分别启用或关闭）
Web UI 的关键价值不只是图形化——它把"插件开 / 关"做成可点击的开关，调试 system prompt 体积比改配置文件直观得多。
Pi 自己给自己写插件
Pi 内置了插件开发文档，所以它能给自己写插件，不需要用户先学一遍 SDK。
实 测三个用例，都是用现役主流模型一次跑通：
- UI 定制：让 Pi 写一个插件，根据 IP 查询地理位置，再查当地天气，把数据展示在对话框顶部。完成后
/reload就能看到效果。 - ENV 保护：写一个插件禁止 Pi 后续读取
.env文件。尝试读取时直接拒绝，并提示这是受保护的文件。 - 删除确认：写一个插件，Pi 准备执行
rm前弹窗询问。点 Yes 才执行，点 No 中止。
项目级插件（.pi/extensions/）复制到 ~/.pi/agent/extensions/ 就升级成全局级。
这种"AI 能扩展自己"的设计哲学跟传统 IDE 插件市场完全不同——传统插件市场是人写给人用的，Pi 的插件市场是 AI 写给 AI 用的。
选插件的几个原则
不是装得越多越好。每次安装一个插件，Pi 启动时都会多读一段系统提示词，多读的部分会挤占上下文窗口。
实际选型时建议这样排序：
先用项目级安装试——只在需要它的项目里开，确认长期依赖后再升级到全局。装完跑一轮真实任务看效果，不要因为"看起来有用"就全局装。用不到就及时关掉或卸载，system prompt 体积直接影响 Pi 的响应速度和专注度。
References
- Pi 大道至简，超越 Codex 和 Claude Code 的极简 Agent，保姆级全攻略，一期视频精通 —— 技术爬爬虾, 哔哩哔哩, 2026-08-20