第1章:ACP vs. MCP 架构层级对比图 diagram

ACP 解决编辑器与 Agent 的决策对话问题;MCP 解决 Agent 与外部工具的数据流问题。两者层级分明,互为补充。

第2章:ACP 交互生命周期时序图 diagram

ACP 连接生命周期有着严格的顺序要求。必须先经历 initialize 握手,才能调用 session/new 开启真正的会话决策流。

第3章:OpenCode ACP Stdio 管道拓扑图 diagram

在本地部署模式中,IDE 通过 Stdio 管道管理 OpenCode 子进程。每次通信都作为一个单行的 NDJSON,无状态、低开销且具有天然的操作系统沙箱隔离特性。

第4章:自定义 ACP Agent 服务双重启动模式 diagram

通过 `@agentclientprotocol/sdk`,我们可以编写统一的 CoreAgent 业务逻辑,并只需更改入口封装,即可轻松在 Stdio 本地管道模式与 HTTP/WS 远程服务模式之间任意切换。

第5章:MCP-over-ACP 反向工具调用链 diagram

MCP-over-ACP 打通了双向互操作性。不仅 Client 可以调用 Agent 编排任务,Agent 也能反向利用 Client 侧自带的、受信任的本地工具链,解决了安全与本地执行的痛点。