Companion 安装与原生 diff

Gemini CLI Companion 适用于 VS Code、Antigravity 和其他兼容编辑器，给终端 CLI 提供打开文件、光标、选区和原生 diff。它与编辑器通过 ACP 驱动 Agent 是两种集成路径。

安装和启用

在支持的编辑器内运行 CLI 可收到自动连接提示；接受后安装并启用。也可在会话执行 /ide install，或从 VS Code Marketplace/Open VSX 安装 Gemini CLI Companion。

手工从市场安装后还需 /ide enable。禁用连接使用 /ide disable；/ide status 查看当前连接编辑器和收到的文件上下文。

上下文范围

最多包含工作区最近访问的 10 个本地磁盘文件、活动光标与选中文本；选区上限 16KB，更长会截断。未保存的虚拟文件不在同一范围内，不能认为编辑器显示的所有内容都已发送。

审阅修改

CLI 提议改文件时可打开原生 diff，接受前也可手工调整建议。以下操作可接受：点击勾、保存文件、命令面板 Gemini CLI: Accept Diff，或在 CLI 回答 yes。

点击叉、关闭 diff 标签、运行 Gemini CLI: Close Diff Editor，或 CLI 回答 no 可拒绝。保存具有接受含义，不能把它当作仅保存一份未批准草稿。

会话自动接受

在 CLI 选择 Allow for this session 后，修改会自动接受，不再逐次显示 IDE diff。看不到 diff 时先检查批准方式，不应立即认定连接坏了。

命令面板

Gemini CLI: Run 在集成终端启动会话；Accept Diff 与 Close Diff Editor 管理当前修改；View Third-Party Notices 展示扩展的第三方声明。

连接问题见IDE 排障。