pi 必装扩展：MCP、子代理与联网搜索
pi 的极简不等于简陋——MCP、子代理、联网搜索这些在 Claude Code 里默认存在的能力，在 pi 里都是扩展包。这节给出必装清单（含下载量与安装命令）、安装管理命令，以及两个实战演示：联网搜索与子代理并行建站。
一、pi 与 MCP 的故事：从"拒绝"到"拥抱"
有个有趣的背景：pi 官方曾公开宣称不支持 MCP（Mario Zechner 本人也在播客里多次表达对 MCP 的保留态度）。但随着生态演进，现在的 pi 已经把 MCP 作为受支持的功能（官方博客 "You Said No MCP!" 记录了这次转变）。这正是 pi 哲学的体现：harness 保持极简，能力靠扩展按需加载。
先掌握扩展的统一管理命令：
pi install npm:<包名> # 从 npm 安装
pi install git:github.com/<owner>/<repo>@<tag> # 从 git 安装
pi install ./local-package # 从本地路径安装
pi list # 查看已装包
pi remove <source> # 移除包
pi update --extensions # 更新扩展
pi -e npm:<包名> # 单次试用，不写入配置
bash
个人安装写入 ~/.pi/agent/settings.json；加 --local（或 -l）则写入项目级 .pi/settings.json（需要授予项目信任后才加载）。
二、必装清单（下载量 2026-11-07 npm 实测复核）
转写讲授时用的必装四件套，对应到官方 Package Catalog（pi.dev/packages）的真实包名与下载量：
| 扩展 | 作用 | 月下载量 | 安装命令 |
|---|---|---|---|
| pi-mcp-adapter | MCP 中间层：连接任意 MCP server（Context7、Playwright、filesystem、数据库等） | 约 156 万 | pi install npm:pi-mcp-adapter |
| pi-web-access | 联网能力：网页搜索、URL 抓取、GitHub 仓库克隆、PDF 提取、YouTube 视频理解；支持 Tavily/Brave/Firecrawl/Crawl4AI/Jina 等后端 | 约 122 万 | pi install npm:pi-web-access |
| pi-subagents | 子代理：单会话内委托多个代理同时干多个任务 | 约 79 万 | pi install npm:pi-subagents |
| pi-background-tasks | 后台任务：持久化后台 shell 任务、只读委托代理 | 约 2 万 | pi install npm:pi-background-tasks |
表内月下载量为 2026-11-07 npm 官方 API 近 30 天实测数据。
安装建议（与讲者一致）：
- pi-mcp-adapter / pi-web-access / pi-subagents 必装——装完这三个，pi 的能力面基本贴近原生 Claude Code 的开发体验
- pi-background-tasks 可装可不装：有子代理之后，很多后台任务可以直接委托子代理去跑；它更适合"需要在子进程里跑长任务"的场景
- 上下文压缩类可选：billion-context（月下载约 310 万）宣称小窗口撑长会话、token 用量降数倍（效果待验证），20-03 的上下文账本思路一致
- pi-memory 可选：基于语义搜索的长期记忆扩展
三、实战演示一：联网搜索
装好 pi-web-access 之后，直接在会话里问：
搜索一下武汉今天的天气
text
pi 会自动调用搜索工具，抓取结果并汇总回答——演示中返回了 5 条搜索结果，天气信息即时可用。整个过程与在 Claude Code 里联网搜索的体验一致，但你的常驻上下文里只为这一条工具描述付了 token。
四、实战演示二：子代理并行建站
更能体现"多代理协作"价值的演示：让 pi 用子代理同时产出多个风格的页面。任务描述：
为 pi.dev 创建 5 个不同风格的首页，创建到当前目录的 5 个不同子目录中，
使用 HTML + JS + CSS，CSS 外置且可以共享。
约束风格：朋克风等 5 种差异化风格。
text
pi 的工作过程（从讲者演示观察）：
- 任务拆解：理解意图，把"5 个风格页"拆成 5 个独立子任务
- 调用前端 design 工具：先生成设计方向
- 创建 5 个子目录，开始写入页面
- 5 个子代理并行开工：每个子代理负责一个风格，同时产出各自的页面代码
这个模式就是 Claude Code 子代理团队工作模式的翻版——区别是你在 pi 里是为每个能力主动付出的 token，而不是时刻背着全套工具清单。
成本与状态观察
- 左下角状态栏实时显示：已发送/接收 token、本轮剩余额度、健康度、本轮花费约 $2 左右（5 个页面并行产出，讲者实测）
- 对照 20-03 的上下文账：这套动作在重型工具里，工具清单本身就先吃掉一大笔
验收结果：AI 风格驾驭的方差
5 个页面的质量并不均匀，这本身就是很好的教学素材：
- GPT-5 驱动的那份：极客风在线，颜值不错
- 有一份贴近 pi 官网风格，但部分层级关系处理得不对
- 有一份完全跑偏：做成了文档站的样子，整体更像管理后台而不是技术产品首页
- workshop 风格眼前一亮，风格驾驭得可以（GPT 驱动）
- 精致黑色风格：简约、质量不错
结论：子代理并行能极大提升产出效率，但验收不能省——同一任务不同子代理（不同模型驱动）的风格驾驭能力方差很大，人要逐个把关。
五、自己写扩展，或让 pi 帮你写
官方 Package Catalog 只是起点。pi 开放了扩展 API，你可以：
- 搜索：到 pi.dev/packages 按名称/描述/作者过滤（支持按 extension/skill/theme/prompt 类型筛选、按下载量排序）
- 自己写：扩展就是一个普通 npm 包（extensions/ skills/ prompts/ themes/ 目录约定 + package.json 的 pi 字段声明）
- 让 pi 写：直接描述你想要的功能，让 pi 生成扩展代码并安装（20-04 的 git 自动提交扩展就是这么来的）
可玩性就和 VS Code 一样：需要什么装什么，不够就自己写，这才是"极客"的完整含义。
本节小结
- pi 曾公开拒绝 MCP，如今 MCP 已是官方支持的功能——极简 harness + 按需扩展的哲学贯穿始终
- 管理命令：
pi install npm:<包名>、pi list、pi remove、pi update --extensions、pi -e试用 - 必装三件套：pi-mcp-adapter（MCP 中间层）、pi-web-access（联网+PDF+YouTube）、pi-subagents（多代理并行）；background-tasks 与 billion-context、pi-memory 按需
- 联网搜索开箱即用；子代理并行建站实测 5 页面约 $2，效率极高但验收不能省——不同子代理的风格驾驭方差很大
- 扩展生态开放：自己写或让 pi 写都行，像 VS Code 装插件一样玩转 pi
↑