SuperAPI AI 工具集

bun-browser

智能体与模型

查看项目

更新于 10-15 21:43

技能介绍

用途:browse 是面向 AI 智能体的浏览器自动化命令行工具,把 Playwright 封装在常驻守护进程后(监听 Unix socket),首次冷启动约 3 秒,之后每条命令通常低于 200ms,会话状态(cookies、localStorage、认证令牌)跨命令保留。适合 QA 验证、视觉检查、表单交互、认证测试与自动 healthcheck。

主要能力:导航与内容(goto、text);快照与交互采用 ref 系统(snapshot、click、fill、select);视觉与调试(screenshot、console、network);会话与标签(auth-state save/load、login、tab list/new/switch/close);流程与断言(flow list/flow、assert 多种条件、healthcheck、wipe);可用 benchmark 测延迟,任何命令可用 --timeout 覆盖默认 30 秒。

使用方式:直接运行命令即可,守护进程会自动冷启动。典型顺序:browse goto <url> → browse snapshot → browse screenshot。交互前先 snapshot 获取 @e1、@e2 等 ref,再用 browse fill @e3 "test"、browse click @e4,页面变化后需重新 snapshot。配置位于项目根的 browse.config.json,可定义 environments、flows、permissions、healthcheck、timeout,用 browse flow <name> --var key=value 执行带变量的流程。

限制与错误恢复:ref 是临时的,每次 snapshot 重新生成,导航后失效,出现 Refs are stale 或 Unknown ref 时重新 snapshot;守护进程连接丢失时 CLI 会自动重启并重试一次;超时可调 --timeout。登录失败多因凭据缺失或错误,应检查环境变量并截图确认页面。原文未提供安装命令、版本与收费信息。