用途:审计页面被 AI 智能体与智能体浏览器操作的程度。依据 Google 面向生成式 AI 的网站优化指南与 web.dev 的 agent-friendly 最佳实践,智能体通过无障碍树驱动页面,因此无名称、非语义或仅靠脚本的控件对它们不可见。本模块检查可静态检查的子集,并列出其余项。alt 文本属 M9、锚文本质量属 M10、渲染属 M4,只引用不重复输出。
主要能力:检查语义化控件(div/span 上的 onclick、role=button、tabindex 加处理器,而非 button/a href);无名称按钮;可访问名称为空的链接;无标签的表单控件(仅 placeholder 不算);href="javascript:" 及带处理器的 href="#";主内容位于 iframe;WebMCP(navigator.modelContext)仅作信息性报告。cursor: pointer、目标尺寸、幽灵遮罩等无法静态检查,列为 not_checkable_static,由 Tier 1 的 Lighthouse Agentic browsing 覆盖。
使用方式:基于 dispatch envelope 指定的 PageSnapshot,从 <run_dir>/pages/<slug>.json 读取 parsed,render.used 非 none 时优先 parsed_rendered;用 Grep 在 pages/<slug>.html 或 .rendered.html 中取原文证据。audit.mjs 已产出的确定性发现列在 <run_dir>/findings.deterministic.json,不要重复输出。若直接以 URL/路径调用且无快照,先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs"。验证:node "${CLAUDE_PLUGIN_ROOT}/scripts/agent-readiness.mjs" --snapshot <pages/<slug>.json>。Tier 1 需用户同意后运行 npx lighthouse <url> --output=json --output-path <run_dir>/lighthouse.json,读取 agentic-browsing 类别(类别 id 需按已安装 Lighthouse 版本核实);否则该项保持 needs_api。
修复:PROPOSED 类可修复项包括把 div[onclick] 换成 button type="button"、为无名称控件加 aria-label 或可见文本、为表单控件加 label for、把 href="javascript:" 换成真实 URL 或 button;ADVISORY 类包括把主内容移出 iframe、框架组件改动、遮罩与目标尺寸、WebMCP 采用。不得编造内容不支持的标签或链接文本,应留 TODO 占位或询问。
适用场景与限制:适用于检查页面是否便于智能体操作,本质多是无障碍基础(name/role/value)的新消费者,应表述为消除辅助技术与智能体的障碍,而非“AI SEO”。该方向仅为方向性:Google 推荐 agent-friendly 实践,但无厂商记录排名或引用效果,因此永不视为 established,严重度不超过 3,不封顶评分。Lighthouse agentic 类别为实验室工具,绿色分数不证明智能体完成了任务;WebMCP 为原始试验草案,仅报告存在,不作推荐。客户端渲染且未渲染时,控件检查仅针对外壳,需说明该限制并在外壳为空处保留 needs_api。