3.8 KiB
3.8 KiB
title, type, tags, date
| title | type | tags | date | ||||
|---|---|---|---|---|---|---|---|
| Accessibility Auditor | source |
|
2026-04-21 |
Source File
Summary
- 核心主题：The Agency 项目中的无障碍审计专家智能体，基于 WCAG 2.2 标准进行界面审计
- 问题域：无障碍合规测试、辅助技术验证、包容性设计评估
- 方法/机制：WCAG POUR 原则测试、屏幕阅读器测试（VoiceOver/NVDA/JAWS）、键盘导航测试、自动化扫描 + 手动测试结合
- 结论/价值：自动化工具仅能捕获约 30% 的无障碍问题，剩余 70% 需人工辅助技术测试发现
Key Claims
- 自动化工具仅能检测约 30% 的无障碍问题，70% 需人工测试发现
- 绿 Lighthouse 分数不代表真正的无障碍达标
- 自定义组件（tabs、modals、carousels、date pickers）默认有罪直至证明无罪
- "能用鼠标操作"不是测试——每个流程都必须能仅用键盘完成
- 语义 HTML 优先于 ARIA——最好的 ARIA 是不需要用的 ARIA
Key Quotes
"A green Lighthouse score does not mean accessible — say so when it applies" — AccessibilityAuditor 核心原则 "Custom components (tabs, modals, carousels, date pickers) are guilty until proven innocent" — 组件测试原则 "If it's not tested with a screen reader, it's not accessible" — 核心使命宣言
Key Concepts
- WCAG 2.2：Web Content Accessibility Guidelines 2.2，网页内容无障碍指南标准
- POUR Principles：Perceivable、Operable、Understandable、Robust 四大无障碍设计原则
- Screen Reader Testing：使用屏幕阅读器（VoiceOver、NVDA、JAWS）验证内容可访问性
- Keyboard Navigation Audit：纯键盘导航测试，验证所有交互元素可及性
- ARIA Patterns：Accessible Rich Internet Applications 模式，自定义组件的无障碍实现规范
- axe-core：自动化无障碍扫描工具，可集成到 CI/CD 流程
- Lighthouse Accessibility：Chrome 开发者工具内置的无障碍审计功能
Key Entities
- The Agency：开源 AI 智能体集合项目，Accessibility Auditor 是其测试类智能体之一
- WAI-ARIA：Web Accessibility Initiative 制定的 ARIA 规范
- WCAG 2.2：W3C 发布的网页内容无障碍指南 2.2 版本
Connections
- Testing Reality Checker ← collaborates_with ← Accessibility Auditor
- Evidence Collector ← provides_evidence_to ← Accessibility Auditor
- Frontend Developer ← receives_audit_from ← Accessibility Auditor
- UI Designer ← receives_feedback_from ← Accessibility Auditor
Contradictions
- 暂无已知冲突
Testing Methodology
Automated Scanning
- axe-core CLI:
npx @axe-core/cli http://localhost:8000 --tags wcag2a,wcag2aa,wcag22aa - Lighthouse:
npx lighthouse http://localhost:8000 --only-categories=accessibility --output=json
Manual Testing Protocol
- Screen Reader Testing: VoiceOver (macOS)、NVDA (Windows)、JAWS 各平台完整流程测试
- Keyboard Navigation: 纯键盘完成所有关键用户旅程
- Visual Testing: 200%/400% 缩放、高对比度模式、减少动画模式
- Component Deep Dive: 自定义组件 WAI-ARIA Authoring Practices 对标审查
Severity Classification
- Critical: 完全阻断部分用户访问
- Serious: 需要变通方案的主要障碍
- Moderate: 造成困难但有变通方案
- Minor: 降低可用性的烦扰问题
Audit Deliverables
- Accessibility Audit Report（含问题详情、WCAG 条款引用、修复建议）
- Screen Reader Testing Protocol（按组件的 PASS/FAIL 表格）
- Keyboard Navigation Audit（全局导航 + 组件特定模式检查清单）
- Remediation Priority（Immediate/Short-term/Ongoing 三级优先级）