用途：对 HTML 文件进行 WCAG 2.1 合规性自动扫描，并按 AA/AAA 标准检查颜色对比度，帮助在开发早期发现无障碍问题。
主要能力：a11y_scanner.py 检查图片 alt 文本缺失或为空、h1-h6 标题层级是否连续、表单输入是否有关联 label、ARIA 用法、链接文本是否过于笼统、html 元素 lang 属性、正 tabindex 值以及语义地标使用。contrast_checker.py 计算相对亮度对比度，按 AA（普通文本 4.5:1、大文本 3:1）和 AAA（普通文本 7:1、大文本 4.5:1）判断，可从 CSS 提取颜色/背景对并推荐最接近的合规颜色。
使用方式：运行前需确认扫描目标与范围、合规级别（A/AA/AAA）以及用途（一次性修复还是 CI 门禁）。常用命令：python scripts/a11y_scanner.py --file index.html；python scripts/a11y_scanner.py --dir ./src/templates；python scripts/contrast_checker.py --foreground "#333333" --background "#ffffff"；python scripts/contrast_checker.py --css styles.css；python scripts/a11y_scanner.py --file index.html --format json。CI 中可用 --level A --strict 对 Level A 违规进行门禁。
适用场景：提交前快速扫描、PR 审查、发布前全面审计、定期监控，以及修复 alt 文本、表单标签、标题层级和对比度等问题。
限制：资料未提供安装方式、依赖要求、支持的文件类型范围、性能数据或收费信息；严重级别映射为 CRITICAL 对应 Level A、WARNING 对应 Level AA、INFO 对应 Level AAA。