用途:管理 LaTeX 论文引用的完整生命周期,覆盖采集、校验、添加与格式化。
主要能力:
- 校验引用:运行 validate_citations.py,检查所有 cite key 是否可解析,并报告缺失引用、未使用的 bib 条目、重复 key、重复章节、重复标签、未定义引用与缺失图片。
- 自动采集缺失引用:harvest_citations.py 扫描 .tex 中未引用的论断,通过 Semantic Scholar 搜索并输出候选 BibTeX 条目,支持 --dry-run、--verbose、--api-key、--max-rounds。
- 自动修复占位:validate_citations.py 加 --fix 会生成 references_fixed.bib,为所有缺失的 cite key 创建占位条目。
- 从论文数据库生成 BibTeX:bibtex_manager.py --jsonl paper_db.jsonl --output references.bib。
- 搜索特定论文:search_semantic_scholar.py --query "..." --max-results 5 --api-key "..."。
- 格式化 .bib:按 key 字母排序、统一缩进(2 空格)、移除空字段、用 {Braces} 保护标题专有名词、确保各条目类型必需字段齐全。
使用方式:输入动作为 harvest、validate、add、format,配合 .tex 或 .bib 文件路径。采集循环每轮读取草稿、找出最重要的缺失引用、搜索 Semantic Scholar、选取最相关论文、提取 BibTeX 并生成形如 firstAuthorLastNameYearFirstContentWord 的 key(如 vaswani2017attention),追加到 .bib 并在合适位置插入 \cite{key},直到无缺口或达到 20 轮。
限制与规则:不添加已存在的引用;只添加 API 找到的引用,绝不编造;引用要广泛而非仅热门论文;不得逐字抄袭已有文献。相关技能上游为 literature-search、deep-research,下游为 paper-compilation、latex-formatting。