用途:这是 HVE Core 的规范无障碍参考契约,代理与指令按名称调用该技能,由它负责框架参考解析、阶段指引解析和扫描器 CLI 入口。
主要能力:汇总 WCAG 2.2、ARIA Authoring Practices Guide、认知无障碍指南、Section 508、EN 301 549、Graphics ARIA 与 SVG-AAM 等框架参考,并提供无障碍评估参考(辅助技术播报模型)。Accessibility Planner 工作流含六阶段:Discovery、Framework Selection、Standards Mapping、Plan Risk Assessment、Impact and Evidence、Backlog Handoff。
方法充分性:定义了缺陷五分类(静态可判定结构、交互行为、播报正确性、自适应渲染、伪语义)。静态分析只能判定第一类,其余四类需交互状态探针或辅助技术(AT)验证,静态证据最多给出部分通过。门禁严格度按风险层级 basic/standard/comprehensive 递进,由 CI 的 A11Y_TIER 与 A11Y_RATCHET_SURFACES 控制。
用法:扫描 CLI 为 scripts/scan.py,需 Python 3.11+、uv、Node.js 与 npx,首次运行需联网拉取 @axe-core/cli。示例:uv run scripts/scan.py https://example.com --allow-host example.com;uv run scripts/scan.py ./page.html --output results.json。远程主机需 --allow-host 或 --allow-external。运行时探针脚本位于 scripts/runtime_a11y,需安装技能本地 Node 依赖(PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 npm ci)和系统 Chrome;自动化 NVDA 需 Guidepup 资产。
限制:扫描结果只是指向成功标准的证据,不是合规裁定;校准检查点不进入覆盖率管道;远程授权仅作用于初始扫描目标,不约束重定向与子资源;对伪语义类缺陷规则引擎可能无法识别;缺少足够的配置或宿主环境时相关步骤不可用。