用途:将讲义文件中的引用与参考文献条目交叉核对,并生成审计报告。默认结构模式检查缺失条目(CRITICAL)、未使用条目、拼写候选(编辑距离≤2)以及条目质量(必填字段、作者格式、年份 1900–当前、编码问题、doi 规范化)。扫描 Slides/.tex、Quarto/.qmd、guide/.qmd、master_supporting_docs/**/.tex;默认读取仓库根目录 Bibliography_base.bib,可通过 CLAUDE.md 覆盖;报告写入 quality_reports/bib_audit_structural.md。
--semantic 在结构检查基础上增加:引用漂移检测(重复条目:同 DOI、同标题、同作者+年+期刊、标题 Jaccard>0.85,并推荐规范键);可选 DOI 校验(crossref,比较作者、年份、标题、期刊,限 50 次、每次间隔 0.5 秒,缓存于 quality_reports/.doi_cache.json,可用 --skip-doi 关闭);各文件引用风格一致性;--cite-claim 仅抓取摘要供人工判断,判定引用是否支持论断由 /verify-claims 负责。报告写入 quality_reports/bib_audit_semantic.md。
退出行为:结构模式始终 exit 0;语义模式仅有 LOW 发现时 exit 0,出现 CRITICAL 时 exit 1,可用作投稿前门禁。限制:不自动修改 .bib,只给建议;不检查非 DOI 标识(ISBN、arXiv、SSRN,属路线图);不判断引用是否被用于正确语境。