用途:通过 CDP 协议控制 Chrome,复用已有登录会话执行浏览器自动化,如打开页面、提取文本或登录凭证、点击与输入元素。
主要能力:探测 CDP 状态;启动或复用调试 Chrome;用 agent-browser 执行 open、wait、eval、snapshot、click、type 等操作;复杂 JS 可用 base64 或 stdin 传入。
使用方式:前置条件为 macOS/Linux,Windows 为实验性,已装 Google Chrome、Node.js 20+,并执行 npm install -g agent-browser。先运行 node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --detect-only 探测;若 CDP_STATUS=ready 直接用 agent-browser --cdp 9222 命令;若 needs-setup 且 CHROME_RUNNING=no,可加 --yes 启动;若已有 Chrome 在运行,启动会杀掉其进程,须先经用户确认再带 --yes 执行。脚本选项含 --detect-only、--yes、--reset、--profile <name>、--dry-run;退出码 0 成功、1 通用错误、2 用户拒绝、3 需同意。清理时仅结束通过 --user-data-dir 核验归属的 debug 实例,不得按 Chrome 可执行名批量结束进程。
限制:首次启动会终止用户常规 Chrome,可能丢失未保存内容;opencode 无后台执行工具,长时操作会阻塞会话,需用 timeout 或 PowerShell Job 包装并设 30s 超时;页面加载、批量抓取、进程僵死、网络波动等场景仍可能卡住,可在 opencode 中按 ESC 手动打断。登录态失效可用 setup-cdp-chrome.js 9222 --reset --yes(同样需先征得同意)。多 profile 时用 --profile 指定。