用途:面向 TYPO3 网站、sitepackage、Fluid 模板、CSS/SCSS、JavaScript 组件、编辑器内容及无障碍声明,检查、修复、监控并记录无障碍问题,目标为 WCAG 2.2 AA 与 EN 301 549 就绪;支持奥地利、德国、瑞士法律框架配置。
主要能力:优先本地文件检索理解仓库,再用 Playwright 加 axe-core 做可复现的浏览器扫描,并对 Fluid、SCSS、JavaScript、RTE、TCA 做静态检查;可选 Deque axe MCP 的 analyze、remediate、igt(igt 需订阅额度)。内置无构建 Chrome 扩展用于人工复核,提供 55 个有效检查点(31 个 A、24 个 AA;4.1.1 Parsing 已移除,仅作遗留检查),支持标题、地标、图片、表单、链接、焦点、小目标等辅助扫描与结构化导出。生成报告与声明草稿。
使用方式:从 bundled project-template 脚手架初始化,复制配置后执行 npm install、npx playwright install --with-deps chromium、npm run a11y:all;标准流程为 npm run a11y:discover、a11y:test:report-only、a11y:report、a11y:statement,CI 需阻断时用 a11y:test。人工复核导出后执行 npm run a11y:manual:merge(单文件用 a11y:manual:merge:file -- 路径)。开发/预发环境可用 data-a11y-component、data-a11y-template 标记组件;生产环境不要泄露内部模板路径。
限制:自动化扫描只是证据,不得据此宣称完整符合 WCAG;替代文本、键盘逻辑、屏幕阅读器清晰度、PDF、视频、地图及法律例外仍需人工复核,发布声明须基于 .a11y/open-issues.yml,不得凭记忆撰写。禁止在仓库存 API 密钥,须用环境变量;登录内容宜用本地/预发 URL,报告需脱敏。DDEV 的本地地址可写入配置。缺失事实:未提供收费、价格与最终法律建议。