rpi-acp 源码解读：以 Zed 为例，一个 ACP Client 如何启动并驱动 rpi Agent

bigfish — Wed, 14 Oct 2026 00:04:00 +0800

在 rpi-package 的 rpi-acp 中，ACP 指的是 Agent Client Protocol。这个 package 的实际用途很具体：让 Zed 这样的 ACP Client 通过标准输入输出启动 rpi，并把 rpi 当作一个可以发送 prompt、接收流式更新和处理权限请求的外部 Agent。

本文以 Zed 作为具体客户端，因为仓库提供了完整的 Zed 注册、配置和排错路径；但 rpi-acp 并不是 Zed 专用实现。只要其他客户端支持 ACP v1、JSON-RPC 2.0 和 stdio，并能处理本文介绍的会话与更新方法，同样可以通过 rpi-acp-bridge 启动 rpi。

本文对应 rpi-packages 中的 rpi-acp 0.1.3，主要源码如下：

packages/rpi-acp/
├── src/lib.rs       插件生命周期、ownsStdio、启动服务
├── src/main.rs      独立 rpi-acp-bridge 二进制
├── src/protocol.rs  ACP v1 JSON-RPC 服务与请求分发
├── src/session.rs   每个 ACP session 对应的 rpi RPC 子进程
├── src/history.rs   session 历史保存与回放
└── src/zed.rs       Zed settings.json 注册

源码仓库：https://github.com/pi-rust/rpi-package/tree/master/packages/rpi-acp

bigfish的网络博客 - ACP

rpi-acp 源码解读：以 Zed 为例，一个 ACP Client 如何启动并驱动 rpi Agent