SuperAPI AI 工具集

qe-browser

智能体与模型

查看项目

更新于 10-16 09:51

技能介绍

用途:为 QE 智能体提供浏览器自动化能力,用于导航、读取、交互、截取网页,并做视觉回归、页面状态断言、安全发现可利用性验证与提示注入扫描。底层引擎为 Vibium(约 10MB Go 二进制,基于 WebDriver BiDi,Apache-2.0,首次使用自动下载 Chrome for Testing)。

主要能力:核心流程为 vibium go 导航、vibium map 获取元素引用、click/fill 交互、断言或 diff map 验证。技能自带脚本:assert.js 支持 16 种类型化检查(url_contains、text_visible、no_console_errors、no_failed_requests、response_status、element_count 等);batch.js 多步执行,默认失败即停;visual-diff.js 基于 pixelmatch 与本地基线做像素对比;check-injection.js 扫描提示注入模式;intent-score.js 以启发式方式评分 15 种语义意图(accept_cookies、submit_form、primary_cta、fill_email 等),无需 LLM 往返。

使用方式:需先安装 vibium(npm install -g vibium 或 aqe init),脚本位于 .claude/skills/qe-browser/scripts/。辅助脚本默认注入 --headless,交互调试可设 QE_BROWSER_HEADED=1。Vibium 自带 MCP 服务器,可通过 claude mcp add vibium -- npx -y vibium mcp 接入,核心导航操作建议优先走 MCP,QE 专有原语仍用脚本。输出为结构化 JSON 信封,退出码 0=成功、1=失败、2=跳过(vibium 未安装,不静默回退 Playwright)。

适用场景:CI 中视觉回归、E2E 流程断言、无障碍树审计、认证状态复用、渗透测试利用验证、Cookie 横幅语义关闭。

限制:Windows x64 的 smoke-test.sh 尚未测试;Linux ARM64 需手动安装系统 chromium 与 chromedriver 并做符号链接变通;容器内直连 vibium 需自行传 --headless。资料未提供收费与价格信息。