核心用法
Accessibility Engineering Engine 是一套完整的数字无障碍工程系统，覆盖从审计到修复的全流程。核心功能包括：
1. 结构化审计简报：通过 YAML 模板定义产品类型、目标标准（默认 WCAG 2.1 AA）、法律管辖区域及合规截止日期，快速建立项目基线。
2. WCAG 2.1 AA 完整检查清单：按四大原则（可感知、可操作、可理解、健壮性）组织 50+ 条具体准则，每条附带测试方法与常见失败模式。
3. 语义 HTML 与 ARIA 速查：提供 12 种常见组件（模态框、标签页、手风琴等）的完整键盘交互规范与 ARIA 实现模式，强调"优先使用原生 HTML"原则。
4. 四层测试金字塔：自动化扫描（axe-core、Lighthouse）、键盘测试、屏幕阅读器测试（NVDA/VoiceOver/JAWS）及专家人工评审，明确各层覆盖比例与工具链。
5. 代码修复模式库：包含 7 类高频问题（缺失 alt 文本、仅颜色指示、自定义按钮、表单标签、焦点管理、模态陷阱、动态内容）的前后对比代码示例。
6. 设计系统规范：颜色对比度（AA 级 4.5:1/3:1）、触摸目标尺寸（44×44px 推荐）、排版无障碍及减少动画偏好支持。
7. 100 分评分量表：8 个维度加权评分，明确 90+ 分为审计就绪、70-89 分需 30 天内修复、50-69 分需优先处理关键问题的阈值。
8. 组织成熟度模型：从 Ad Hoc 到 Leading 五级成熟度定义，配套角色职责矩阵、无障碍声明模板及 ROI 商业论证。
显著优点
- 法律合规导向：直接映射 ADA Title III、Section 508、EU EAA 2025、EN 301 549 等法规，附处罚金额与诉讼趋势数据（2023 年美国 ADA 诉讼 4,600+ 起）。
- 工程可落地：提供 CI/CD 集成代码（GitHub Actions）、自动化测试命令行工具配置、React Native/Flutter 无障碍属性示例。
- 多平台覆盖：Web、iOS/Android 原生应用、PDF、邮件等数字渠道均有专项检测清单。
- 认知无障碍：纳入 WCAG 2.2 认知与学习能力障碍指南（COGA），如阅读水平控制、错误预防优先、无时间压力设计。
- 商业价值量化：明确无障碍市场规模（13 万亿美元消费能力）、SEO 收益及诉讼防御成本（平均 1-10 万美元）。
潜在局限
- 未内置实时扫描：依赖外部工具（axe-core、Pa11y）执行，本身不提供浏览器插件或 IDE 扩展。
- 屏幕阅读器测试门槛：要求测试者具备 NVDA/VoiceOver 操作经验，新手学习曲线陡峭。
- 设计系统假设：组件规范基于传统 Web 技术栈，对新兴框架（如 SwiftUI、Jetpack Compose）的覆盖有限。
- 法律责任声明：虽提供法律框架，但明确建议咨询专业法律顾问，不构成正式合规担保。
适合人群
- 前端/移动端开发者：需实现键盘导航、ARIA 模式、焦点管理的技术实施者
- UX/UI 设计师：需标注无障碍规范、验证对比度、设计键盘交互流程
- QA 测试工程师：需建立四层测试金字塔、执行屏幕阅读器测试用例
- 产品经理/法务：需评估 EAA 2025 截止日合规风险、制定无障碍路线图及预算
- 设计系统维护者：需为组件库编写无障碍规格文档
常规风险
- 合规≠可用：通过自动化扫描（仅覆盖 ~30% 问题）不代表真实辅助技术用户体验良好，必须配合人工测试。
- SPA 焦点管理：客户端路由后若未重置焦点与标题，导致屏幕阅读器用户迷失上下文。
- 第三方组件黑箱：嵌入的支付、地图、聊天组件若未提供无障碍 API，可能成为合规短板。
- 深色模式对比度陷阱：仅浅色模式通过对比度检测，深色模式下常见失败（纯白文字 #fff 在深色背景产生光晕效应）。
- 动态内容遗漏：实时更新（股票行情、聊天消息）未配置
aria-live区域，信息对屏幕阅读器用户完全静默。