用途:vibium CLI 从命令行自动化 Chrome(可用 --engine firefox 切换 Firefox),适用于浏览器自动化、探索、调试与录制。首次使用会自动启动浏览器,守护进程模式可在命令间保持运行。已知步骤时用显式命令;目标明确但步骤需探索时用 vibium run "<goal>"。需要独立验收结论时使用 check 技能或 vibium check "<claim>"。
主要能力:导航(go/back/forward/reload/url/title);元素发现(map 生成 @e1 等引用、diff map 对比变化、find 支持 text/label/placeholder/testid/xpath/alt/title/role);内容读取(text/html/eval/count/screenshot/a11y-tree);交互(click/dblclick/type/fill/press/focus/hover/scroll/keys/select/set/unset);鼠标原语与拖拽;元素状态查询;等待(元素、URL、加载、文本、JS 条件);截图与 PDF;对话框、视口与窗口、媒体与地理位置模拟、内容替换;iframe、文件上传;录制(record start/stop,可含视频);Cookie 与存储状态导出恢复;下载目录、多页面与会话管理;高亮调试。
使用方式:先解析 vibium 二进制路径(全局安装、./clicker/bin/vibium 或 ./node_modules/.bin/vibium),用 vibium --help 确认。初始设置可运行 vibium ready browser --json 检查安装,缺失时按提示执行 vibium install。直接浏览器命令无需 AI 配置;使用 run 需加载项目 AI 设置并运行 vibium ready ai --json。推荐流程:go → map → 用 @ref 交互 → 重新 map。命令可用 && 串联,但依赖上一步输出的命令应分开执行。
限制:eval 需返回表达式结果,否则得到 null;sleep 最大 30000ms;视频录制需 Firefox 154+ 且为本地浏览器,Chrome 上 --video 会报错;远程连接不录制视频,除非 --video-remote;Run 可能改变应用状态,其启动的浏览器默认结束后关闭,除非 --keep-open。其余细节暂未提供。