用途:该模块用于页面实体链接审计与生成,判断页面指向的真实世界实体,并将其与知识图谱关联。依据 references/schema-tier1.md 中的 sameAs/@id/Person+Organization 规则,负责 M5 转交的 sameAs 细节。
主要能力:审计 Organization/Person 实体的 sameAs[] 是否解析到规范身份,Wikidata QID 被视为最强的知识图谱目标;确认每页仅有一个明确主实体(@id 与 mainEntity/mainEntityOfPage);对 LocalBusiness 校验 NAP 在 schema 与可见页面间一致;统计可解析实体(@idd 节点、sameAs 目标、about/mentions),对无实体引用页面标薄。
使用方式:基于调度信封中的 PageSnapshot 工作,读取 <run_dir>/pages/<slug>.json 的 jsonld[]、anchors[],在 pages/<slug>.html 中检索原文证据,站点产物位于 <run_dir>/site/{robots.json,sitemaps.json,discovery.json}。直接以 URL/路径调用且无快照时,先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs",并使用输出的快照路径。审计.mjs 已产出的确定性发现列于 findings.deterministic.json,不重复输出,仅补充模型判断发现。
修复分级:AUTO 仅在用户确认 URL 后注入 sameAs[] 并补充 about/mentions;PROPOSED 为查找得到的候选 Wikidata/LinkedIn 匹配,需逐项人工接受,不自动写入;ADVISORY 在无实体时建议建立 Wikidata 实体或声明档案,仅指导不写入。验证使用 dom_assert 确认 sameAs/@id/mainEntity 存在且格式正确,并解析每个 sameAs URL(Tier 1 Wikidata 查询)确认有效且指向所声明的实体;在线查询层不可用时状态为 needs_api,不能误判通过。
限制:sameAs 不保证进入知识图谱,也不保证排名提升,仅属消歧信号,影响评估保持方向性。绝不编造或猜测身份链接,未确认 URL 应留 TODO。风险等级中 5 保留给站点/模板级灾难性、影响资格的事实;其余为 4 重大、3 中等、2 次要、1 外观、0 信息性。发现按 schema/finding.schema.json 输出,轴 ai。