CodeBuddy IDE 集成

一、集成方式一：ACP 协议集成

适用于 Zed 等支持 ACP 的编辑器，将 CodeBuddy Code 作为通用 Agent Server 使用。

二、Zed 编辑器

通过 ACP 协议完整集成，支持：

·项目上下文感知

·工具操作代理（文件读写、终端命令）

·权限请求交互

·实时流式响应

配置详见：ACP 协议集成文档

三、集成方式二：IDE 插件集成（–ide / /ide)

适用于 VS Code / Cursor / Windsurf / JetBrains 系列 IDE，通过插件 + 本地 MCP 服务器的方式集成。IDE 侧插件负责：

·创建并维护 MCP 连接（SSE / WebSocket)

·将工作区信息、选区等上下文通过 MCP 协议传给 CodeBuddy

·暴露 openFile / openDiff / getDiagnostics / close_tab 等 IDE 能力给 CodeBuddy 调用

四、–ide 启动参数

当你在终端中直接启动 CodeBuddy 时，可以通过 –ide 参数让 CLI 主动尝试连接当前工作目录对应的 IDE：

codebuddy –ide

行为说明：

·CodeBuddy 会在当前用户目录下扫描由 IDE 插件创建的锁文件，检测可用的 IDE 实例

·仅当 IDE 的工作区包含当前目录时才认为是“有效 IDE”

·仅当恰好一个有效 IDE 匹配当前工作目录时才会自动连接；如果零个或多个匹配，自动连接将静默跳过，你可以使用 /ide 手动选择

·检测前会自动清理已退出的 IDE 进程对应的过期锁文件，避免连到无效端口

·连接成功后，CLI 会通过 IDE MCP 服务器获得：

·文件/差异预览（openFile / openDiff)

·诊断信息（getDiagnostics)

·选区变化通知（selection_changed)

注意：说明：

注意：–ide 只是在“你从 IDE 终端手动启动 CLI”时的一种快捷连接方式，不负责真正启动 IDE 或插件。

五、/ide 斜杠命令

当你在 CodeBuddy 的交互式界面中使用 IDE 插件集成时，可以通过 /ide 命令查看和管理当前 IDE 连接状态：

/ide

典型用途包括：

·查看当前是否已连接 IDE、连接的是哪一个 IDE

·在存在多个可用 IDE 时，选择要连接的实例

·手动断开或重新建立与 IDE 的 MCP 连接

具体交互行为由 IDE 集成 UI 决定，但整体定位是“管理 IDE 集成状态”而不是直接发起聊天。

六、集成方式的选择

·如果你的编辑器原生支持 ACP（例如 Zed），推荐使用 ACP 协议集成：

·使用 codebuddy –acp 启动

·由编辑器负责会话 UI 和工具代理

·如果你使用 VS Code / Cursor / JetBrains 等，通过插件市场安装 CodeBuddy 插件，则推荐使用 –ide / /ide 插件集成：

·插件负责启动 CodeBuddy 进程并建立 MCP 连接

·CLI 侧通过 –ide / /ide 与 IDE 建立和管理连接

两种方式在“集成层级”上是等价的，都是让 CodeBuddy 作为外部 Agent 与 IDE 深度协作，只是接入协议和 UI 承载方不同。

七、未来计划

后续版本将提供更多增强功能：

·更友好的 DIFF 展示与修改确认流程（结合 IDE diff 预览）

·在 IDE 插件中提供更丰富的上下文选择与可视化

·更多编辑器和 IDE 的集成