73 lines
3.8 KiB
Markdown
73 lines
3.8 KiB
Markdown
---
|
||
title: "Accessibility Auditor"
|
||
type: source
|
||
tags: [accessibility, testing, agent, the-agency]
|
||
date: 2026-04-21
|
||
---
|
||
|
||
## Source File
|
||
- [[raw/Agent/agency-agents/testing/testing-accessibility-auditor.md]]
|
||
|
||
## 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
|
||
1. **Screen Reader Testing**: VoiceOver (macOS)、NVDA (Windows)、JAWS 各平台完整流程测试
|
||
2. **Keyboard Navigation**: 纯键盘完成所有关键用户旅程
|
||
3. **Visual Testing**: 200%/400% 缩放、高对比度模式、减少动画模式
|
||
4. **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 三级优先级） |