CI/CD 无障碍集成

最廉价的无障碍缺陷是那个永远不会被合并的。CI/CD 无障碍集成将测试左移到您的开发流水线中，使回归在每个拉取请求上被自动捕捉，而不是数月后在审计中——或在投诉中——才浮现。

为什么要将无障碍集成到 CI/CD

大多数团队都是事后测试无障碍：一次周期性审计产出一长串清单，团队加以修复，然后同类问题又随着下一批功能悄然回潮。在流水线中自动化检查打破了这一循环。每次变更在做出时即被评估，开发者在代码还新鲜时就获得反馈，您来之不易的合规也免受悄然回归的侵蚀。

工作原理

QualiBooth 的 Code Analysis 功能与 GitHub Actions 集成。完成设置后，工作流会在每次 push 和拉取请求时自动运行：

1. 安装 QualiBooth GitHub Action 并添加您的 QUALIBOOTH_ORG_UUID 密钥。
2. 提交工作流文件——GitHub 从此刻起自动触发无障碍扫描。
3. 结果显示在 QualiBooth 的 Scan Runs 仪表板中，可按代码库、branch 或 commit 哈希搜索。
4. 每个违规都精确定位到文件路径和行号，并标注 Error 或 Warning 严重级别。
5. 修复合并后，下一次扫描将该问题标记为已修复——进度可逐次运行衡量。

基于 ESLint 的扫描目前支持 React、Vue、JavaScript 和 TypeScript 代码库。其他框架和 CI 平台的支持已列入路线图。

我们搭建什么

1. GitHub Action 集成 — 将 QualiBooth action 接入您的代码库工作流。
2. PR 反馈 — 自动化检查直接在拉取请求上评论发现。
3. 回归检测 — 每次扫描与基线进行比较，新问题与已有积压问题明确分开。
4. 基线 — 现有问题的快照，使您对新问题设关卡，而非一次性卡住整个待办积压。
5. Scan Runs 仪表板 — 每次执行都记录 branch、commit、问题计数及已修复问题追踪。

检查在哪里运行

• 拉取请求 — 对变更文件进行快速扫描，提供迅速的评审者反馈
• Branch 推送 — 持续监控，在 PR 评审之前就捕捉回归
• 合并前检查 — 在新回归到达主分支之前将其捕获
• 定期扫描 — 在整个应用上进行更全面的夜间或发布扫描

一条诚实的边界

自动化测试仅能可靠地检测 30–40% 的 WCAG 成功标准。我们对此直言不讳：CI/CD 集成是让可自动化的问题永不上线、并防范回归的方式——但它不能取代人的判断。我们关于 CI/CD 中自动化无障碍测试的指南详细说明了这条界限在实践中的位置。完整的全貌来自将自动化关卡与由残障人士执行的手动审计和周期性审计相结合。

适合谁

持续发布、并希望让无障碍成为一道标准、自动化质量关卡——就像测试和代码检查一样——的工程和平台团队。它是更广泛的无障碍流程改进计划中的天然组成部分。