用途:agent-browser 是 cloudrouter 浏览器自动化能力,用于网页抓取、表单填写、测试、截图和数据提取等任务;当任务涉及网页、URL、登录流程时可使用。它封装 agent-browser,并通过 SSH 在云沙箱内运行命令。
前提:需有运行中的 cloudrouter 沙箱,可用 cloudrouter ls 获取沙箱 ID,或用 cloudrouter start 创建。
核心工作流:打开 -> 快照 -> 交互 -> 重新快照。例如:cloudrouter browser open <id> "https://example.com";cloudrouter browser snapshot -i <id>;cloudrouter browser click <id> @e5;cloudrouter browser fill <id> @e3 "text";交互后重新执行 snapshot -i <id>。
主要能力:导航(open、back、forward、reload、url、title);检查(snapshot -i、snapshot、snapshot -c、screenshot、screenshot --full、eval);交互(click、dblclick、fill、type、press、hover、focus、scroll、scrollintoview、select、check、uncheck、upload、drag、wait);信息获取(get-text、get-value、get-attr、get-html、get-count、is-visible、is-enabled、is-checked);语义定位(find text/label/placeholder/testid);JavaScript 与调试(eval、console、errors);标签与框架、Cookie 与存储、状态保存与恢复、浏览器设置、网络拦截与对话框处理。
必要用法与限制:标志须放在沙箱 ID 之前,如 snapshot -i <id>;导航或点击后必须重新快照;推荐 snapshot -i;不要混用完整快照与 -i,二者引用编号不同;表单字段用 fill 而非 type;引用是临时的,每次快照后重置;scrollintoview 与 highlight 只接受 CSS 选择器,不接受 @e 引用;find 的 role button click 只能点击第一个按钮,无法按名称过滤,没有 --name 参数;文件保存在沙箱内,需用 cloudrouter download 取回。其余收费、价格、平台支持等暂未提供。