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

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

先确认使用 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 被自动接受时，检查会话批准方式而非重复安装扩展。