SuperAPI AI 工具集

visual-qa

办公与效率

查看项目

更新于 10-16 07:59

技能介绍

用途:替代“智能体自己看一眼就判定通过”的做法,用独立的多层检查验证本地 SPA 的界面是否出现非预期变化。适用于刚改主题/UI/品牌、需要为含 ui_role≠none 的框架做验收门禁、浏览器扩展无法截取 localhost 等场景;触发词包括 visual qa、route-shots、baseline diff、按路由截图、UI 是否有回归、headless 界面测试、/visual-qa。

主要能力:在 localhost 上运行无头浏览器,按真实路由列表和登录账号截图并生成 MANIFEST.json;对 baseline 做像素级 diff(默认阈值 0);在页面内用 computed style 检查不变量(contrast-aa、monochrome-surface、rogue-slab、shadow-clipped、overlap、row-misalign);按评分标准阅读全部截图并输出 FINDINGS.md(每条路由一行);支持 --assert 以退出码作为门禁。

使用方式:应用需先运行,路由与主题列表从应用本身获取,不能猜测。示例命令:node skills/visual-qa/assets/route-shots.mjs --base http://localhost:5230 --out <dir>/qa-shots --baseline <dir>/qa-baseline --user demo --pass demo --assert。依赖声明在 skills/visual-qa/assets/package.json,安装用 npm i --prefix skills/visual-qa/assets;playwright-core 配合系统 Chrome,baseline diff 需要 pixelmatch + pngjs。

限制与边界:不涉及 computer-use 或桌面 AX;登录失败时 --assert 必须立即失败,避免只审计登录页副本;用户报告问题而机器显示干净时,应视为机器有盲区,先复现相同状态再判断,不能预设用户有误;不得为“消除报错”而放宽阈值。部分实现细节(如具体环境依赖版本、完整支持矩阵)暂未提供。