SuperAPI AI 工具集

qa-browser-automation

编程与开发

查看项目

更新于 10-15 17:28

技能介绍

用途:这是一套浏览器端 QA 自动化技能,通过 Chrome MCP 在真实浏览器中执行测试,并配合 Python 脚本做确定性评分、无障碍审计、视觉回归追踪和报告生成。使用前需先确认四项输入:目标 URL/应用与登录方式、测试档位(Quick/Standard/Deep/Exhaustive)、修复自主度(是否自动修 P3/P4 并提交,或仅报告)、WCAG 目标等级(A/AA/AAA)。若信息不明应先询问;用户说“先起草”时可在产物顶部列明假设。

主要能力:qa_health_scorer.py 按 10 类加权给出 0-100 分与 A-F 等级及趋势;accessibility_auditor.py 按 A/AA/AAA 输出 WCAG 违规项与整改建议,支持读取 HTML 文件或标准输入;visual_regression_tracker.py 基于 SHA-256 哈希与字节级比对做基线/当前截图对比,默认阈值 5%;test_report_generator.py 生成 Markdown 或 JSON 报告与建议。所有工具支持 --json;健康评分器与回归追踪器在失败时返回退出码 1。

使用方式:健康评分示例:python scripts/qa_health_scorer.py findings.json --threshold 85 --baseline .qa-baselines/latest.json --save-baseline --json。无障碍审计示例:python scripts/accessibility_auditor.py page.html --level AA --json,或 curl -s https://example.com | python scripts/accessibility_auditor.py - --level AAA。视觉回归:先 --init 建基线目录并 --register 注册截图,再以 --baseline 与 --current 加 --threshold 比较,用 --update-baseline 接受有意变更。完整扫描分 11 阶段,从预检与认证、探索路由与表单、状态测试、跨设备与安全头检查,到记录评分、分级修复和回归核对;验收点为健康分≥85、无 P0、WCAG AA≥95%。

适用场景:浏览器 QA 全流程扫描、视觉回归测试、无障碍审计,以及与代码评审、DevOps 流水线、安全审查等环节联动。

限制:需要干净的工作树,脏则中止;每会话最多 50 次修复;风险累积达预算 25% 停止;连续 3 次修复验证失败即完全停止。常见问题:评分退出码 1 通常是分数低于阈值;审计报解析错误多因 HTML 不完整或 curl 被重定向;回归显示全部页面 100% 变化通常是基线清单为空,需先 --init 再 --register。资料未提供价格、平台支持范围和具体效果数据。