用途:browser-harness 是一个供 AI 智能体安装的技能,官方描述为“任何网页交互都应使用它”,包括自动化、抓取、测试或站点/应用工作。它通过 CDP(Chrome DevTools 协议)直接控制浏览器。任务相关改动写入 agent-workspace/agent_helpers.py;安装、配置或连接问题需查看官方 install.md。
主要能力:本地流程默认连接到正在运行的 Chrome/Chromium CDP 端点,无需浏览器 id 或本地配置文件选择。提供截图、点击、DOM 检查与提取、导航等待等辅助函数,并可通过 cdp("Domain.method", ...) 调用原始 CDP。支持 Browser Use 云端浏览器,适用于无头服务器、并行子智能体和隔离工作。域技能默认关闭,设置 BH_DOMAIN_SKILLS=1 启用。
使用方式:以 browser-harness 调用,多行命令用 heredoc。辅助函数已预导入,run.py 在 exec 前调用 ensure_daemon()。首次导航用 new_tab(url),不是 goto_url(url)。页面流程建议先截图,点击采用截图→读像素→click_at_xy(x, y)→再次截图,导航后调用 wait_for_load()。本地 Chrome 无法连接时可运行 browser-harness --doctor 诊断;若未启用远程调试,会打开 chrome://inspect/#remote-debugging,需用户勾选并允许。远程浏览器需先 browser-harness auth login 或 browser-harness auth login --api-key-stdin,再用 start_remote_daemon("name") 并设置同名 BU_NAME。
限制:登录墙需停下询问,密码、MFA、同意或账户选择均需用户确认,仅当 Chrome 已登录时可自动使用可用 SSO。本地控制必须启用 chrome://inspect/#remote-debugging。云端浏览器在停止或超时前持续计费,用完需询问并运行 stop_remote_daemon(name)。Omnibox 弹窗不是真实工作标签,CDP 目标顺序不等于 Chrome 可见标签顺序。BU_CDP_URL 是 HTTP DevTools 端点,由守护进程解析为 WebSocket。更多交互技能见官方 interaction-skills 目录(如连接、Cookie、iframe、对话框、下载、拖放、下拉、网络请求、打印为 PDF、滚动、Shadow DOM、标签页、上传、视口等)。文档未提供收费、价格与效果数据。