SuperAPI AI 工具集

local-browser

办公与效率

查看项目

更新于 10-16 10:05

技能介绍

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 命令。