用途:通过 omowright 库从 JS eval 内核驱动真实浏览器,处理用户已登录的站点、表单与点击、JS 渲染页面、截图、Web QA 等任务。
两种引擎:attached(默认)通过 connectBrowserSkill() 连接用户自己的浏览器,携带其登录状态与打开的标签页;owned 通过 connectPipe()/connectCloakProfile() 启动独立浏览器,用于一次性配置、反机器人评分规避、验证码、网络拦截、坐标控制与无头运行。两者不可静默互换;attached 未就绪时应运行引导脚本并告知用户剩余步骤。
使用方式:先加载 omowright 并运行 browser-doctor.mjs --json 检查状态(ready、no-cli/no-daemon/no-extension、choose-browser、no-browser-support)。安装须针对用户实际使用的浏览器,用 --browser=<id> 指定并记入记忆。会话循环:connectBrowserSkill 建立会话,navigate 导航,bskSnapshot 获取树与 refs,click/fill/press 操作,observe 读取 @eN 引用,screenshot 截图,最后在 finally 中 stop()。每次操作前重新读取引用,导航或大 DOM 变化会使引用失效;同一失败重复两次应换方法。借用用户标签页需显式 tabBorrow/tabReturn。需要人工时用 requestHelp 请求登录、验证码、OTP 或支付确认。
限制:不得通过页面读取凭据,不得清除 cookie、缓存或站点数据;默认 focused: false;每个任务一个命名会话并始终停止;被机器人评分或 WAF 拦截的目标应改用 owned 引擎。其余方法、选项与错误码见 references/commands.md,安装见 references/install.md,远程与 owned 引擎见对应文档。