用途:检查 .pptx、.docx、.html、.md 文件的无障碍问题,按 Microsoft Accessibility Checker 规则报告失败项,并在用户要求时修复。若用户直接粘贴 HTML 或 Markdown,需先保存为文件。
主要能力:在技能根目录运行自带检查器:python scripts/a11y_check.py <file> --json。.pptx 需 python-pptx,.docx 需 python-docx;HTML 和 Markdown 仅用标准库。无 Python 或导入失败时,HTML/Markdown 可手工按规则检查;.pptx/.docx 无法可靠回退,应说明无法检查并请用户运行 Office 自带检查器(File > Info > Check for Issues > Check Accessibility)后反馈结果。脚本之外还需人工判断:无意义的替代文本、错误标记为装饰性、被误报的阅读顺序、仅靠颜色传达含义、音视频字幕与转录、脚本跳过的对比度(主题色、渐变、图片填充应报告为未检查,不能算通过)。
报告方式:按严重程度分组,最严重在前,每行含 Severity、Rule、Where、Fix。开头给出一行统计(如 3 errors, 5 warnings, 1 tip)。无失败项时说明并列出无法机械检查的内容。
修复:可直接应用缺失幻灯片标题、表头行、改写模糊链接文本、为 <html> 添加 lang、修复标题层级跳跃;对内容不确定的图片替代文本、标记装饰性、更改颜色、重构合并表格需先询问。修复后重新运行检查器并报告剩余问题。
规则:错误包括非文本内容替代文本、表格列标题、幻灯片标题、节名称、文档访问限制;警告包括对比度(WCAG AA:普通文本 4.5:1,18pt+ 或粗体 14pt+ 为 3:1)、表格简单结构、幻灯片阅读顺序、音视频字幕、链接文本;提示包括幻灯片标题唯一、标题样式、文档语言。
限制:不得为未知图片编造替代文本,不得为消除问题而标记装饰性,不得修改可见措辞、布局或品牌,不得将未检查项报告为通过,不得声称符合 WCAG 或 EN 301 549。