用途:管理 LaTeX 论文引用的完整生命周期,包括采集、校验、添加与格式化 BibTeX 条目。
主要能力:
- 校验引用:validate_citations.py 检查所有 cite key 是否能解析,报告缺失引用、未使用的 bib 条目、重复键、重复章节、重复标签、未定义引用与缺失图片。加 --check-figures --figures-dir 可检查图片。
- 生成 BibTeX:bibtex_manager.py 从 JSONL 论文库输出 references.bib。
- 检索特定论文:search_semantic_scholar.py 按查询返回结果,可带 --api-key。
- 自动采集缺失引用:harvest_citations.py 扫描 .tex 中未引用的论断,检索 Semantic Scholar,输出候选 BibTeX 条目;支持 --dry-run、--verbose、--api-key,--max-rounds 控制循环轮数。
- 自动修复缺失占位符:validate_citations.py --fix 生成 references_fixed.bib,为所有缺失的 cite key 建立占位条目。
使用方式:动作参数为 harvest、validate、add、format,配合 .tex 或 .bib 路径调用对应脚本。harvest 为迭代式采集:读取草稿、找出最重要的缺失引用、检索 Semantic Scholar、选中最相关论文、提取 BibTeX 并生成简洁 key(lastNameYearWord)、追加到 .bib 并插入 \cite{key},直到无缺口或达到轮数上限。规则:不重复添加已有引用,只添加 API 检索到的条目,不得编造,广泛引用,不照抄原文。BibTeX key 格式为 firstAuthorLastNameYearFirstContentWord,如 vaswani2017attention。format 动作会按键字母排序、统一两空格缩进、删除空字段、用 {} 保护专有名词、确保各条目类型的必需字段。
适用场景:撰写与投稿 LaTeX 论文时的引用维护,编译前的引用完整性检查。
限制:依赖 Semantic Scholar API,检索可能需要 api-key;采集只添加检索到的真实条目,不保证覆盖所有缺失引用;未提供具体价格或平台支持信息。