VM0 Local Browser
Local Browser 允许本智能体通过 VM0 检查和控制用户已经配对的浏览器。读取操作会被排队到在线的浏览器主机;写入操作需要用户明确批准后,扩展才会执行。
适用场景
当用户要求与其当前浏览器协作、检查已打开的页面、截取屏幕截图、汇总选中的文本,或在用户控制的页面中执行浏览器操作时,可以使用它。
命令形式
npx -y -p @vm0/cli zero local-browser <command>
-y 用于避免 npm 的安装提示。只有在可接受交互式提示时,才使用不带 -y 的 npx -p @vm0/cli ...。
前置条件
当任务依赖浏览器在线,或主机引用不明确时,检查主机:
npx -y -p @vm0/cli zero local-browser hosts list
如果没有在线主机,请让用户从 VM0 连接 Local Browser 连接器,并保持扩展运行。如果有多个主机在线且用户指定了其中一个,请对支持定向的命令传入 --host-id <host-id>。
读取浏览器上下文
尽可能在写入命令之前使用读取命令,以便定位正确的标签页、URL、文本或选择器。
列出标签页:
npx -y -p @vm0/cli zero local-browser tabs list
获取当前标签页:
npx -y -p @vm0/cli zero local-browser tabs current
读取当前页面快照:
npx -y -p @vm0/cli zero local-browser page snapshot
截取屏幕截图:
npx -y -p @vm0/cli zero local-browser page screenshot
读取选中文本或元数据:
npx -y -p @vm0/cli zero local-browser page selection npx -y -p @vm0/cli zero local-browser page metadata
需用户批准的操作
写入命令会创建审批请求。用户必须先批准,扩展才会执行。
导航或打开标签页:
npx -y -p @vm0/cli zero local-browser page navigate "https://example.com" npx -y -p @vm0/cli zero local-browser tabs open "https://example.com"
点击或输入:
npx -y -p @vm0/cli zero local-browser page click --selector "button[type=submit]" npx -y -p @vm0/cli zero local-browser page type --selector "input[name=q]" --text "search terms"
滚动或管理标签页:
npx -y -p @vm0/cli zero local-browser page scroll --direction down --amount 800 npx -y -p @vm0/cli zero local-browser tabs activate --tab-id "<tab-id>" npx -y -p @vm0/cli zero local-browser tabs close --tab-id "<tab-id>"
审计与清理
当用户询问发生了什么,或调试失败的浏览器操作时,检查已批准写入的历史:
npx -y -p @vm0/cli zero local-browser audit list --limit 20 npx -y -p @vm0/cli zero local-browser audit list --run-id "<run-id>"
仅在用户要求断开主机时才撤销它:
npx -y -p @vm0/cli zero local-browser hosts revoke --host-id "<host-id>"
安全
除非用户要求执行操作,否则优先使用只读命令。
除非用户针对该确切任务明确指示,否则不要输入密码、支付详情或敏感个人数据。
将每次写入都视为用户可见的浏览器控制。保持操作范围狭窄,并在请求不明确时,在发出命令前先说明预期操作。
不要依赖任意 JavaScript 或 CDP 访问;请使用受支持的 zero local-browser 命令。