AI 接管浏览器踩坑实录:OpenCLI 报 Detached 怎么排查,以及为什么别直接碰用户 Chrome 的 CDP

TL;DR · 结论先行

操作已登录网页按「OpenCLI 扩展桥 → Ego Browser → Kimi Computer Use 后台操作」三级路由走,不直接抢前台或乱连 CDP;遇到 OpenCLI 报 Detached while handling command 先加 `-v` 看真因(常见是 AUTH_REQUIRED 或残留浏览器会话冲突),别急着重写适配器。

一句话结论(TL;DR)

  1. 接管用户已登录 Chrome:优先走 OpenCLI 浏览器扩展桥,不要在没有提前配好隔离环境时直接去连 CDP,否则既容易遇到端口冲突,又会反复触发权限拦截。
  2. 看到 Detached while handling command 别先判适配器死亡:先加 -v 打出完整报错栈——一半情况是没登录(AUTH_REQUIRED),另一半是上一次会话残留导致预导航冲突,关掉残留标签页重跑就恢复。

AI 操作网页的正确三级路由

优先级 工具 适用场景 绝对红线
1. 首选 OpenCLI(命令行 + 扩展桥) 有现成站点适配器,或复用登录态跑 browser eval 直接拿结构化 JSON 不可跨端混用:比如消费端页面和创作者后台登录态往往是两套 Cookie
2. 备选 Ego Browser(Agent 专用浏览器) 需要完整表单交互、站点反爬重、需要人机协同接力 清理 Cookie/存储前先确认作用域,避免误清整套 Profile
3. 兜底 桌面级后台视觉操作(如 KimiCU) 封闭桌面客户端、验证码、拖拽、画布等浏览器命令行覆盖不到的界面 严禁抢前台把窗口强拉到最前或劫持用户的真实鼠标键盘

踩坑 1:Detached while handling command 的两种真相

用 OpenCLI 跑网页命令时,最容易让人误判的报错就是终端只吐出一行:

UNKNOWN: Detached while handling command

看着像是站点改版、适配器彻底挂了。实测拆开看,其实主要是两种完全不同的原因:

  1. 真实原因被掩盖了:裸跑时外层把细节吞掉了,加上 -v 参数重跑,立刻会吐出底层错误码——例如实测中就出现过 AUTH_REQUIRED + exitCode: 77(只是那个域名没登录,并不是脚本坏了)。
  2. 残留浏览器会话冲突:上一次命令异常退出,留下半吊子连接,导致下一次预导航失败(Pre-navigation ... failed: Detached)。此时关闭残留会话标签页重新执行,或者把首次调用失败后重跑一次,往往立刻恢复正常。

两个顺手避开的小坑

  • 全局超时选项坑:在较新版本里,不要再到处找全局 --timeout 参数了,命令超时是通过环境变量 OPENCLI_BROWSER_COMMAND_TIMEOUT(默认 60 秒)控制的。
  • 两套登录态坑:某些内容平台(如抖音)的创作者后台(creator.)和主站消费页(www.)是两套独立的登录态。不能拿 whoami 查后台成功或失败,去反推消费端评论能不能抓。

踩坑 2:同会话打开相同 URL 不刷新 & 无命令时怎么拿数据

  1. 改完本地 HTML 在同一个 tab 再 open 不生效:如果已经在当前会话打开过同一个 URL,再次 open 不会强制重新加载页面,测试本地改版网页时要用 eval 显式刷新或直接重开新 tab。
  2. 平台没有现成接口命令怎么办:不用立刻退回截图 OCR。在已经登录并打开对应页面的上下文里,直接用 browser eval 在页面上下文内调站内原有接口,往往一条命令就能拿到干净的结构化 JSON(比抓 DOM 文本稳得多)。

失效边界

  • 依赖桌面 Chrome 登录态的路线必须在桌面有图形会话且插件保持连接;无头云服务器场景应切回独立 Cookie 隔离或专用浏览器容器。
  • 平台风控策略和前端接口会随时更新,本文命令参数基于实测版本总结,使用前习惯性先跑一次 --help 核对当前版本选项。

继续读其他踩坑

AI 长对话怎么无损交接:三轮盲评实测 Opus 8.4–8.8 分 vs DeepSeek 6.4–7.7 分,省一半到七成额度 2026-11-16 本地语音转写与口播粗剪踩坑:为什么不能一个模型通吃(SenseVoice vs Whisper Turbo vs 原版实测) 2026-11-16 Claude Code + Pi + Kimi Code 多 Agent 怎么分工:按「要不要看图、要不要判断」派活,实测把 33 秒慢任务压到 0.4 秒 2026-11-16