browser-cdp

# Browser CDP 操作工具 通过 CDP 协议控制 Chrome，复用已有登录态，执行浏览器自动化操作。 ## 前置条件 - macOS / Linux / Windows（实验性），已安装 Google Chrome - Node.js 20+ - `agent-browser` 已安装：`npm install -g agent-browser` > ⚠️ **首次启动会 kill 用户的常规 Chrome。** 在启动前必须征求用户同意（见下方"启动流程"），否则用户可能丢失未��存的标签页/草稿。 --- ## 启动流程（skill-mode 强制步骤） **第一步：探测当前状态（无副作用）** ```bash node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --detect-only ``` 输出形如： ``` CDP_STATUS=ready # 已就绪，可直接复�� CDP_URL=http://127.0.0.1:9222/json/version BROWSER=Chrome/148.0.7778.168 ``` 或： ``` CDP_STATUS=needs-setup CHROME_RUNNING=yes # 用户有 Chrome 在跑，启动会杀掉 CHROME_PID_COUNT=3 ``` **第二步：根据探测结果分支** - `CDP_STATUS=ready` → 直接使用 `agent-browser --cdp 9222 ...`，**不要运行 setup**。 - `CDP_STATUS=needs-setup` 且 `CHROME_RUNNING=no` → 安全启动： ```bash node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --yes ``` - `CDP_STATUS=needs-setup` 且 `CHROME_RUNNING=yes` → **先用 AskUserQuestion 工具向用户确认**：告知会杀掉 N 个 Chrome 进程、可能丢失未保存工作；用户同意后再带 `--yes` 启动；用户拒绝则放弃这次自动化。 **为什么不能直接 `--yes`：** 脚本在非 TTY（即 skill 模式 / Bash 工具）下，如果检测到 Chrome 在跑而没有 `--yes`，会以退出码 3 报 `NEEDS_CONSENT: ...` 并中止，**不会**静默杀进程。这是有意的兜底——但 skill 流程仍应先问用户，而不是看到 3 就盲传 `--yes`。 --- ## 启动脚本选项 | 选项 | 说明 | |------|------| | `--detect-only` | 只探测，不修改任何状态（skill 用） | | `--yes` | 已征得同意，跳过交互提示 | | `--reset` | 启动前清空 `~/chrome-debug-profile`（登录失效时用） | | `--profile <name>` | 使用非 Default 的 Chrome profile（如 `"Profile 1"`） | | `--dry-run` | 打印将执行的步骤，不执行 | 退出码：`0` 成功 / `1` 通用错误 / `2` ...