---
name: install-browser-control
description: 在新 Mac 上为 Codex 和 Claude 全局安装或整理真实 Chrome/Chromium 调试能力时使用；适用于需要 connect-chrome、browse、setup-browser-cookies 三个入口、可见浏览器接管、DOM 操作、network/console 检查与 cookie 导入支持的场景。
---

# Install Browser Control

当用户要求在新机器上把浏览器接管调试能力装完整时，直接执行本 skill。

## 目标

- 自动识别 `CODEX_HOME`，默认回退到 `~/.codex`
- 在 Codex / Claude 两侧全局目录补齐或标准化：
  - `connect-chrome`
  - `browse`
  - `setup-browser-cookies`
- 优先复用现有等价能力；缺失时从公开官方来源安装
- 生成本地说明文件：`$CODEX_HOME/browser-control-setup.md`
- 做真实验证：可见 Chromium 窗口、`https://example.com`、DOM 读取、network/console、cookie 导入入口调用

## 执行

先运行安装脚本：

```bash
SCRIPT_DIR="$(cd -- "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
bash "$SCRIPT_DIR/install-browser-control.sh"
```

## 交付

安装脚本结束后，读取并引用：

```bash
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
sed -n '1,240p' "$CODEX_HOME/browser-control-setup.md"
```

汇报时只保留高信号结果：

- 是否安装完成
- 3 个入口的最终路径
- 本地说明文件路径
- 实际验证结果
- 如果未完成，唯一阻塞点