SuperAPI AI 工具集

a11y-audit

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:对 Web 项目执行确定性的无障碍审计与回归门禁,尤其适合路由数量多、共享模板的大型站点。工具将自动化发现映射到配置的合规标准,并输出可配置格式的结果,仅作为审计者报告问题与整改建议,不修改源代码。

主要能力:结合 axe-core 扫描,并可运行 Lighthouse 无障碍类别检查;提供环境发现与脚本化流程,包括 bootstrap-context.js 创建项目上下文、scan.js 执行可复用扫描并支持 --summary、report.js 生成 Markdown 报告与 JSON 数据、discover.js 识别模板组并挑选代表页面、select-changed-surfaces.js 按变更收敛扫描范围、run-audit.js 作为面向外部智能体系统与 CI 的进程适配器。支持 markdown、markdown+json、markdown+issues 三种输出模式。回归门禁支持 --fail-on major 与基线比对,示例: node a11y-audit/scripts/scan.js --urls http://127.0.0.1:3000/ --write-baseline .a11y-audit/baseline.json node a11y-audit/scripts/scan.js --urls http://127.0.0.1:3000/ --baseline .a11y-audit/baseline.json --fail-on new

使用方式:需 Node.js 22.12.0 或更高版本,先运行 node --version 确认运行时。scan.js 依赖 axe-core 与 puppeteer,按技能本地 deps/、目标项目 node_modules/、全局模块顺序解析;找不到时自动安装到技能本地 deps/ 目录。项目专属审计状态默认保存于工作区根目录 .a11y-audit/PROJECT_CONTEXT.md。可由用户请求部分运行,如仅执行前两阶段的快速扫描、完整审计或带工单的审计。经显式授权的登录后扫描需先阅读 references/authenticated-scans.md,并保持状态文件不入版本控制。

适用场景:大型多路由站点的代表性抽样审计、CI 中定期无障碍回归门禁、将发现接入看板或问题跟踪器的整改工作流,以及带人工确认的批量工单创建。首次运行若未设置输出模式,会询问用户并写入上下文文件。

限制:内置扫描器仅支持 Puppeteer,不支持 Playwright;Playwright 方案需自写项目本地适配器且处于已验证路径之外。Lighthouse 不可用或失败时应跳过并在报告中说明。自动化通过仅适用于已扫描范围,不代表完整合规;不同 axe-core 版本的规则集差异不得表述为站点回归或修复。无基线时使用 all-or-nothing 门禁可能因既有债务失败,建议接受基线。关于具体收费、价格与更多平台支持,资料暂未提供。