3.1 KiB
3.1 KiB
NEX Design System 0.1.6 — 修订摘要
本次修订目的
0.1.5 已将真实屏幕阅读器列为 E3 证据,但容易被 Agent 理解为常规验收步骤,导致日常开发时启动 VoiceOver。0.1.6 明确:无障碍要求仍是产品质量底线,但 VoiceOver 不是唯一读屏工具,E3 也不是每次开发必做。
核心决策
- 无障碍要求不降级。 Web 产品默认以 WCAG 2.2 AA 作为工程目标;这不是仅凭自动化扫描即可宣称正式合规。
- 日常默认 E0–E2。 源码与语义审阅、自动化检查、浏览器键盘/指针交互作为常规流程。
- E3 按风险触发。 复杂自定义控件、拖拽/排序、复合导航、关键数据表格、重要 Live Region、已发现 AT 缺陷或客户/法规要求时评估真实读屏。
- 跨平台选择 AT。 macOS 使用 VoiceOver;Windows 使用 NVDA(必要时按项目用户群增加 JAWS/Narrator);Linux 使用 Orca。按产品支持范围选择浏览器组合,不能跨平台外推结果。
- 保护用户环境。 Agent 不得在日常 UI 测试中自动启动读屏器。启动、关闭或切换系统 AT 前,必须获得用户对本次 E3 测试的明确授权;不得关闭用户原本开启的读屏器或修改系统级偏好。
- 状态准确。 E3 不适用时记录
E3_NOT_REQUIRED;E3 必要但目标环境不可用时记录MANUAL_QA_REQUIRED;只有实际执行后才能记录E3_PASS/E3_FAIL。
平台建议矩阵
| 操作系统 | 屏幕阅读器 | 建议浏览器 |
|---|---|---|
| macOS | VoiceOver | Safari;按项目支持补充 Chrome |
| Windows | NVDA;按需 JAWS / Narrator | Firefox 或 Chrome/Edge,按目标支持范围 |
| Linux | Orca | 优先 Firefox;按项目支持补充 Chromium |
具体组合可能因版本、发行版、桌面环境和产品支持范围而异,必须在测试记录中写明实际环境。
配置更新
保留 0.1.5 的明确默认技术栈,仅在 quality.accessibility 中增加默认工程目标、常规证据等级、E3 风险策略、跨平台选择和启停授权要求。无需用户额外填写操作系统或读屏器;Agent 根据产品支持范围提出测试矩阵。
新增/更新文件
- 更新
docs/08-accessibility-responsive.md - 更新
docs/09-agent-execution-rules.md - 更新
docs/12-responsive-accessibility-quality.md - 新增
docs/14-accessibility-platform-matrix.md - 更新
config/project-profile.example.yaml - 更新
AGENTS.md、README、START-HERE、审计提示词和验收清单 - 更新
templates/assistive-technology-test-record.md
官方参考
- WCAG 2.2: https://www.w3.org/TR/WCAG22/
- Playwright Accessibility Testing: https://playwright.dev/docs/accessibility-testing
- Apple VoiceOver Guide: https://support.apple.com/guide/voiceover/welcome/mac
- NVDA: https://www.nvaccess.org/download/
- GNOME Orca: https://gnome.pages.gitlab.gnome.org/orca/help/introduction.html
使用边界
本版本定义通用跨平台策略,不宣称任何具体项目、页面、操作系统或屏幕阅读器组合已经通过 E3。实际结果只能由对应项目的真实测试记录支持。