SuperAPI AI 工具集

ibm-a11y-automation

前端与建站

查看项目

更新于 10-15 23:48

技能介绍

用途:当需要检查 Langflow 前端页面的无障碍(accessibility)问题时,使用该技能运行本地无障碍扫描脚本并对结果进行汇总。

主要能力:通过 uv 运行 scripts/a11y/a11y_scan.py,对指定基础 URL 下的前端路由进行扫描。支持按路由清单文件批量扫描、按单个或多个路由路径扫描、指定问题级别(默认 violation,可加 potentialviolation、recommendation),并输出 JSON 报告,可选生成 Markdown 和 HTML 报告。还支持通过状态文件执行显式的弹窗/状态操作,例如点击、填充、按键、等待元素或文本出现与隐藏。

使用方式:常规命令为 uv run python scripts/a11y/a11y_scan.py --url http://localhost:3000 --routes-file scripts/a11y/a11y_routes.json --route-group static --out /tmp/langflow-a11y-report.json --markdown /tmp/langflow-a11y-report.md --html /tmp/langflow-a11y-report.html --timeout-ms 45000。路由选择以 scripts/a11y/a11y_routes.json 为准,通常扫描静态组;动态路由如 /flow/:id/、/flow/:id/view、/playground/:id/、/assets/knowledge-bases/:sourceId/chunks 需先替换为真实 ID。

报告汇总:可汇报报告路径、生成的 Markdown/HTML 路径、总问题数、每路由问题数、每路由 API 请求数与失败数、以及高频规则 ID;对应字段包括 totalIssues、results[].route、results[].state、results[].phase、results[].apiRequests、results[].requestFailures、results[].diagnostics、results[].issues[].ruleId。

限制:只使用扫描器输出作为结论依据,不虚构路由名,应读取 routes.tsx。不要自动点击任意按钮寻找弹窗,需使用显式状态操作;除非用户明确要求且数据安全,避免破坏性弹窗操作。若某路由 API 请求为零,应说明扫描质量可能受限。除用户明确要求修复外,先询问再修改文件。