用途：审计并修复页面的图片与媒体可访问性，让图片对排名系统与 AI 抽取器更可读。alt 文本是图片的主要语义入口。
主要能力：检查内容型 <img> 是否都有 alt 属性，区分装饰性图片（alt="" 加 role="presentation" 属正确）与完全缺失 alt；评估 alt 质量，如是否为空、是否为文件名、是否在不同图片间逐字重复、是否堆砌关键词，要求描述性且贴合上下文，目标长度约 80-140 字符；检查 <img> 是否设置 width/height 或 CSS 预留 aspect-ratio 以防布局偏移；标记仍使用旧式 jpg/png、可用 WebP/AVIF 或响应式 picture/srcset 的情况；检查嵌入视频（video、YouTube/Vimeo iframe）是否缺少 VideoObject JSON-LD。
使用方式：基于 dispatch envelope 中指定的 PageSnapshot，读取 <run_dir>/pages/<slug>.json 的 images[]、iframes、jsonld[]，并在 pages/<slug>.html 中检索原文证据；站点产物位于 <run_dir>/site/。audit.mjs 已产出的确定性发现列在 <run_dir>/findings.deterministic.json，不要重复输出这些 id，只补充模型判断的发现。若直接以 URL 或路径调用且无快照，先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs"，再使用打印出的快照路径。
修复分级：AUTO 类可自动为 <img> 依据源资源固有尺寸补充 width/height，以 diff 形式输出；PROPOSED 类根据图片及周围标题、说明、段落生成上下文 alt 草稿，需逐项人工接受，上下文不足时留 TODO 占位或询问用户，不得编造图片内容；ADVISORY 类仅建议格式升级，工具无法转码二进制，因此从不写入。
验证与限制：采用 dom_assert 重新解析快照并断言条件；若尺寸检查需要远程资源固有尺寸且无 fetch 层，状态为 needs_api，绝不误报通过。发现按 finding.schema.json 输出，严重度 3，M9 不达 4。alt 文本有助于可访问性与图片/AI 理解，排名提升应视为方向性而非保证；关键词堆砌有害，只标记不生成；WebP/AVIF 可减少字节，但格式本身不是已记录的排名因素，保持咨询级低影响。