$ cat ~/map/pi-acp.md

pi-acp

社区维护的 ACP（Agent Client Protocol）适配器，通过 stdio 上的 RPC 把 Zed 等 ACP 客户端与 Pi 的 JSON-RPC 2.0 通信桥接起来。

extensions✓ 10月16日

事实速查

## 速览

pi 的 Agent Client Protocol 适配器：经 stdio 说 ACP JSON-RPC 2.0 对接 Zed 等编辑器，桥接到 pi --mode rpc，把 pi 会话、带结构化 diff 的工具调用、斜杠命令与技能带进编辑器。

$桥接模型：适配器派生 pi --mode rpc，在 ACP 消息与 pi 事件间双向翻译——助手输出以 agent_message_chunk 流式推送，工具执行映射为 tool_call/tool_call_update。
$对编辑器友好的编辑：edit 工具执行前先快照文件，从唯一的 oldText 匹配推断 1 起始行号，完成后发出 ACP 结构化 diff（oldText/newText）；相对路径按会话 cwd 解析，Zed 可全程跟随。
$会话持久化：pi 保存自己的会话文件，~/.pi/pi-acp/session-map.json 的小映射让 session/load 重新挂接——会话在 pi 与 ACP 客户端里都能续（Zed v0.225.0 起支持历史）。
$加载 pi 约定的文件级斜杠命令，外加少量面向无头/编辑器场景的内建命令；启用后 pi 技能以 /skill:技能名出现。
$要求 PATH 上有 pi v0.80.4+ 与 Node 22+；明确定位为 MVP——部分 ACP 特性未实现，可能有小幅破坏性变更。

Q 在 Zed 里怎么用？

最简单是 ACP 注册表：运行 zed: acp registry 选择 pi ACP 适配器，由 Zed 托管配置。手动方式是在 agent_servers 里配置 npx -y pi-acp（或 npm install -g pi-acp 后直接 pi-acp）。

Q 怎么关掉启动信息块？

在 pi 设置（~/.pi/agent/settings.json 或项目 .pi/settings.json）里设 quietStartup: true；若安装的 pi 版本过旧，仍会出现新版可用提醒。