进阶:在编辑器中使用 Pi Bot(ACP)

学习通过 ACP 将支持该协议的编辑器(如 Zed)连接到 Pi Bot,选择 Bot 并处理命令审批。了解桌面应用、连接配置与权限要求。

支持 Agent Client Protocol(ACP) 的编辑器(如 Zed)可以直接用 Pi Bot 的 Bot 干活:编辑器里发的话由 Pi Bot 的 Bot 处理,命令执行和审批仍走 Pi Bot 在这台电脑上的权限。

连接

  1. 先打开桌面 Pi Bot(ACP 连接的是正在运行的应用,不会另开一个)。
  2. 在编辑器的 ACP agent 配置里,把命令设为 Pi Bot 本体加 --acp:
    • macOS:"/Applications/Pi Bot.app/Contents/MacOS/Pi Bot" --acp
    • Linux:安装目录里的 pi-bot --acp(已实现,尚未实机验证)
    • Windows:暂不支持连接到运行中的应用,会返回 attach_unsupported_platform。

常见返回:app_not_running(Pi Bot 没开)、acp_busy(已经有另一个编辑器连着)、version_mismatch(编辑器调用的不是正在运行的那个版本)。

选 Bot

编辑器的「模式」列表就是你的 Bot(和群)。新会话默认用 设置 里指定的 ACP 默认 Bot;在编辑器里切换模式就换成另一个 Bot。每个 Bot 用自己的工作文件夹、权限和记忆。

在编辑器里切换模型和思考强度

会话的设置项里有三项(编辑器一般显示在模型选择处):

设置项 作用
Model 这个 Bot 用的模型。和在 Bot 设置里切换一样,Bot 的其他话题也会跟着变。
Thinking 这个 Bot 的思考强度:关 / 低 / 中 / 高,只列出当前模型支持的档位;模型不支持思考时不显示。
Pi Bot default model 全局默认模型(设置 › 模型),没有单独指定模型的 Bot 都用它。换默认模型时,原来的思考强度如果新模型支持就保留,否则换成新模型能用的档位。

下拉里只有已经配置好的厂商的模型。群会话不提供这些设置项(群里每个成员用自己的模型)。

开发模式

在开源仓库里可以用 node apps/cli/bin/pibot.mjs acp 连接同一 checkout 构建出的桌面应用;acp --data <目录> 是独占的开发数据目录,凭据明文保存,只用于开发和脚本检查。详见 apps/cli/README.md。