一句话结论(TL;DR)
- 接管用户已登录 Chrome:优先走 OpenCLI 浏览器扩展桥,不要在没有提前配好隔离环境时直接去连 CDP,否则既容易遇到端口冲突,又会反复触发权限拦截。
- 看到
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
看着像是站点改版、适配器彻底挂了。实测拆开看,其实主要是两种完全不同的原因:
- 真实原因被掩盖了:裸跑时外层把细节吞掉了,加上
-v参数重跑,立刻会吐出底层错误码——例如实测中就出现过AUTH_REQUIRED+exitCode: 77(只是那个域名没登录,并不是脚本坏了)。 - 残留浏览器会话冲突:上一次命令异常退出,留下半吊子连接,导致下一次预导航失败(
Pre-navigation ... failed: Detached)。此时关闭残留会话标签页重新执行,或者把首次调用失败后重跑一次,往往立刻恢复正常。
两个顺手避开的小坑
- 全局超时选项坑:在较新版本里,不要再到处找全局
--timeout参数了,命令超时是通过环境变量OPENCLI_BROWSER_COMMAND_TIMEOUT(默认 60 秒)控制的。 - 两套登录态坑:某些内容平台(如抖音)的创作者后台(
creator.)和主站消费页(www.)是两套独立的登录态。不能拿whoami查后台成功或失败,去反推消费端评论能不能抓。
踩坑 2:同会话打开相同 URL 不刷新 & 无命令时怎么拿数据
- 改完本地 HTML 在同一个 tab 再 open 不生效:如果已经在当前会话打开过同一个 URL,再次
open不会强制重新加载页面,测试本地改版网页时要用eval显式刷新或直接重开新 tab。 - 平台没有现成接口命令怎么办:不用立刻退回截图 OCR。在已经登录并打开对应页面的上下文里,直接用
browser eval在页面上下文内调站内原有接口,往往一条命令就能拿到干净的结构化 JSON(比抓 DOM 文本稳得多)。
失效边界
- 依赖桌面 Chrome 登录态的路线必须在桌面有图形会话且插件保持连接;无头云服务器场景应切回独立 Cookie 隔离或专用浏览器容器。
- 平台风控策略和前端接口会随时更新,本文命令参数基于实测版本总结,使用前习惯性先跑一次
--help核对当前版本选项。