ACP 代理
ADHDev 提供了一个面向 Agent Client Protocol (ACP) 的广泛内置适配器清单。
WARNING
ACP 清单很广泛，但每个 ACP 提供方在被明确测试并在兼容性文档中提升之前，都应被视为未验证。
什么是 ACP？
ACP 是一种结构化代理协议。用 ADHDev 的术语来说，当某个代理表现得更像协议驱动的聊天进程而非终端会话时，就会使用这条路径。
这通常意味着 ADHDev 可以：
- 启动代理进程
- 把提示作为结构化请求发送
- 把结构化响应流式传输回仪表板
- 在提供方提供时暴露模型、模式或其他配置控件
ACP vs CLI
理解 ACP 会话通常最好与 CLI 会话对比：
| 界面 | ACP | CLI |
|---|---|---|
| 主要渲染 | 聊天风格的结构化会话 | 终端优先的 PTY 会话 |
| 最佳适配 | 协议原生代理与 schema 驱动的控件 | shell 工作流、TUI 和原始终端输出 |
| 典型控件 | 提供方暴露时的模型/模式/配置 | 终端输入、滚动回看和 session-host 恢复 |
| 恢复模型 | 进程/会话生命周期 | 托管运行时与 session-host 生命周期 |
如果你想要原始终端行为，请使用 CLI 路径。如果你想要结构化聊天行为，ACP 往往是更好的选择。
ACP 在仪表板中的样子
ACP 会话在仪表板中以聊天风格的对话呈现，而非终端面板。
取决于提供方，你可能能够：
- 从常规聊天输入发送提示
- 阅读结构化的流式响应
- 从仪表板处理批准
- 切换模型或模式
- 使用通过控件栏暴露的提供方专属配置选项
启动 ACP 会话
ACP 提供方从与其他会话类型相同的机器/工作区启动流程中启动：
- 打开一台机器。
- 选择你想要的工作区。
- 选择 ACP 类别。
- 挑选提供方。
- 把会话启动到仪表板中。
如果没有出现任何 ACP 提供方，这通常意味着所选机器没有安装或配置可用的 ACP 提供方。
内置 ACP 清单
ADHDev 目前提供 35 个内置 ACP 适配器。清单中较为知名的名称包括：
- Gemini CLI
- Codex
- Claude Agent
- Cursor
- Cline
- GitHub Copilot
- Goose
- Kimi CLI
- OpenCode
- Qwen Code
再次强调，内置清单并不意味着全面支持。
认证与注意事项
ACP 工具仍然各自处理自己的认证和上游设置。
常见模式：
- API 密钥仍然属于上游工具
- 缺少认证往往看起来像启动失败
- 一些 ACP 工具依赖上游的实验性标志或不稳定的协议特性
- 控制深度因提供方而差异很大
这正是 ACP 强大但在整个清单中表现不均的原因。
何时优先选择 ACP
当你想要以下内容时，ACP 是一个不错的选择：
- 结构化的聊天风格会话而非终端
- 仪表板中提供方暴露的模型和模式控件
- 为那些已经很好地支持 ACP 的代理提供更整洁的协议界面
如果提供方更偏向终端原生，实际中 CLI 路径可能仍然更可靠。