IDE 发现、工作区与沙箱排障

定位 Companion 断连、目录不匹配和宿主网络问题。

This page has not been translated into English yet. The original Chinese version is shown below.

先确认使用 Companion 还是 ACP；两者的安装、发现和通信方式不同。本页处理 Companion，ACP 日志见ACP 模式。

未找到 Companion

确认扩展已安装并启用，然后在 IDE 内开一个新终端，让终端获得连接环境。旧终端缺少变量可能仍显示断连。安装器不支持当前编辑器时，从其市场手工安装，再 /ide enable。

意外断连可先 /ide enable 重连，再考虑新终端或重启 IDE。

CLI 当前目录需位于 IDE 打开的某个工作区根下。没有打开文件夹时先打开工作区；目录错误时切到正确项目后重启 CLI。仅在编辑器里打开一个文件不等于设置了工作区根。

自动发现失败或使用外部终端时，可提供实际 IDE PID：

export GEMINI_CLI_IDE_PID=12345

PowerShell 使用 $env:GEMINI_CLI_IDE_PID=12345。12345 是占位，应替换为目标 IDE 进程。此值让 CLI 跳过自动检测，不会自动启动或安装 Companion。

接口参考使用临时发现文件作为主要发现方式。集成终端 GEMINI_CLI_IDE_SERVER_PORT 用于同工作区多个窗口的选择。旧故障说明偏重环境变量，不能将其解读为当前唯一发现机制；不要随意填一个猜测端口。

Seatbelt 需允许网络才能与本地 Companion 通信。Docker/Podman 中 CLI 会尝试通过 host.docker.internal 连接宿主 IDE，仍要求容器到宿主的网络可达。

IDE 连接与 browser_agent 连接 Chrome 是不同服务，不要把浏览器的固定 9222 端口套用到 Companion。

/ide status 应显示目标编辑器和最近本地文件。文件列表最多 10 个，选区会截断；缺少更多文件不一定是断连。原生 diff 被自动接受时，检查会话批准方式而非重复安装扩展。