SuperAPI AI 工具集

ui-verification

通用与其它

查看项目

更新于 10-16 06:46

技能介绍

用途:ui-verification 负责接管浏览器会话,把静态审计的推断变成实测结果。其他 UI 技能只读源码推测用户所见,本技能则加载页面并测量,输出按规则 ID 归档、带可复现证据的发现,并在修复后做清除性复跑。

主要能力(探针目录):axe-scan 按路由与主题跑 axe-core 违规(含计算对比度);target-size 测每个可见交互元素的包围盒与有效点击区域;focus-walk 做脚本化 Tab 遍历、焦点环像素差、对话框焦点陷阱与恢复;layout-shift 在数据响应保持打开时记录归因的布局偏移;viewport-stress 在 320px 起及三倍字符串下测横向溢出与文字裁切;failure-injection 测请求返回 500、空数组、畸形或无响应时的渲染;theme-locale-matrix 跨视口、主题、伪语言与方向截图;console-network 收集控制台错误、页面错误、失败请求与水合不匹配警告;web-vitals 测 LCP 及其归因元素、CLS、脚本交互下的 INP。

使用方式:先建立会话(驱动、构建模式、基础 URL、鉴权、解析路由),再按交接的规则 ID 或路由选择探针集,逐个运行并先落盘证据再解读,然后判定每条发现为 reproduced / not-reproduced / unknown,修复后以相同条件复跑并记录 clearedBy,最后按证据输出格式报告,并列出跳过未跑的探针及原因。

适用场景:确认 ui-design 审计产出的发现、对指定路由或运行中应用跑全套探针、验证刚落地的修复、跨主题与宽度截图、核对设计系统声称的数值。

限制:不做分级与发布判定(由 ui-design 负责);不构建或改样式;不编写持久测试套件;不维护应用级 verify CLI;不做像素基线回归;不做真实用户性能监控。跳过或无法运行的探针不算通过;截图是证据而非结论;探针自身故障属工具缺陷,不应报为应用缺陷。性能与布局偏移探针需在生产构建下运行。