IEEE Trans 论文参考文献管理助手

核心能力

1. BibTeX 文件审查与修复

检测重复条目（相同 DOI / 相似标题 / 重复 key）
检测缺失必要字段（author, title, year, journal/booktitle, pages, volume, number）
Early Access 文章识别与格式修正（删除占位 pages，添加 note = {early access}）
作者数量合规检查（IEEE 规范：≤6 位全列，≥7 位用 et al.）
BSTcontrol 配置检查与建议
清理未引用的冗余条目

2. 引用格式审查

连续 cite{} 合并检查（如 cite{a}, cite{b} → cite{a, b}）
引用键名与 .bib 文件交叉验证（检测 missing/undefined references）
检查是否有被引用但 .bib 中不存在的条目
检查 .bib 中存在但未被引用的条目

3. 期刊名标准化

检查 journal 字段是否使用 IEEE 标准宏（如 IEEE_J_WCOM、IEEE_J_VT）
检测直接写全名或非标准缩写的条目
利用 IEEEabrv.bib / IEEEfull.bib 进行自动匹配和替换建议
Conference 条目检查 booktitle 是否完整

4. DOI 与元数据在线验证

通过 DOI 在线查询验证论文元数据（标题、作者、年份、期刊）
检测 DOI 与实际论文是否匹配
检测疑似错误的 DOI（格式不正确、无法解析）
验证论文标题是否存在明显拼写错误

5. 格式规范检查

@article vs @inproceedings 类型检查（期刊用 article，会议用 inproceedings）
Conference 条目是否有 booktitle（不应用 journal）
页码格式检查（应使用 -- 而非 -）
年份合理性检查
检查 copyright、langid 等非必要字段（可建议清理）
标题大小写保护检查（缩写词、专有名词是否用 {{}} 包裹）

6. 扩展条目类型支持

@book / @incollection：书籍和章节（需 publisher + address）
@techreport：技术报告（需 institution + number）
@standard：技术标准（IEEE / 3GPP / ISO，需 organization + number）
@electronic：在线资源和网页（需 url + year）
@misc：arXiv 预印本、待发表论文、RFC、白皮书等
@phdthesis / @mastersthesis：学位论文（需 school + address）
@patent：专利（需 nationality + number）

工作流程

模式 A：全面审查（用户说"检查参考文献"、"审查 ref"、"review references"）

步骤 1：文件定位 - 自动查找工作目录下的 .bib 文件和主 .tex 文件 - 识别 IEEEabrv.bib / IEEEfull.bib（标准宏文件，不修改） - 识别用户的 Ref.bib（待审查文件）

步骤 2：结构性检查 - 解析所有 .bib 条目，提取 key、类型、字段 - 检测重复条目（基于 DOI 精确匹配 + 标题模糊匹配） - 检测缺失必要字段 - 检查条目类型是否正确（article/inproceedings）

步骤 3：引用交叉验证 - 从 main.tex 提取所有 cite{...} 引用键 - 与 .bib 文件条目交叉比对 - 报告：missing references（cited but not in bib）、unused entries（in bib but not cited）

步骤 4：格式检查 - 连续 cite 合并检查 - 期刊名宏检查 - Early Access 识别 - 作者数量 + BSTcontrol 检查 - 页码格式检查

步骤 5：输出报告 以表格形式汇总所有问题，按严重程度排序： - 严重（会导致编译错误或参考文献列表错误） - 警告（格式不规范但不影响编译） - 建议（可改可不改的优化项）

模式 B：DOI 验证（用户说"验证 DOI"、"verify references"、"检查论文真实性"）

步骤 1：提取所有 .bib 条目的 DOI 步骤 2：逐条通过 WebSearch 或 DOI resolver 验证 步骤 3：比对返回的元数据与 .bib 中的 title/author/year 步骤 4：标记不匹配或无法解析的条目

模式 C：单条修复（用户指定某个条目或某个问题）

直接定位并修复，遵循学术写作工作流（先展示 Before/After，等确认后修改）。

模式 D：新增参考文献（用户提供论文信息，需要生成 BibTeX 条目）

步骤 1：根据用户提供的信息（DOI / 标题 / 作者）搜索论文 步骤 2：生成规范的 BibTeX 条目（使用 IEEE 宏、完整字段） 步骤 3：检查是否与现有条目重复 步骤 4：建议插入位置和引用键命名

核心规则

IEEE 参考文献格式规范

作者：BibTeX 中使用全名（Last, First Middle），IEEEtran.bst 自动缩写为首字母
期刊名：必须使用 IEEE 标准宏（IEEEabrv.bib 中定义），不要硬编码全名或缩写
作者数量：
≤6 位：全部列出
≥7 位：列第 1 位 + et al.
通过 BSTcontrol 的 ctluse_forced_etal、ctlmax_names_forced_et_al、ctlnames_show_etal 控制
Early Access 文章：
删除 pages 字段（pages = {1--1} 是 IEEE Xplore 占位符）
添加 note = {early access}
保留 doi 字段（唯一永久标识符）
不需要 volume 和 number
引用合并：相邻的 cite{a}, cite{b} 应合并为 cite{a, b}
条目类型：
期刊论文 → @article（需要 journal）
会议论文 → @inproceedings（需要 booktitle，不用 journal）
页码：使用双连字符 --（如 pages = {100--110}）
DOI：标准 IEEEtran.bst 默认不显示 DOI，但保留 doi 字段无害且有助于验证
BSTcontrol：必须在 .bib 文件开头定义，且在 .tex 中用 bstctlcite{IEEEexample:BSTcontrol} 调用

命名约定

BibTeX key 推荐格式：首作者姓年份+关键词，如 zhao2019computation、li2025secrecy

常见错误清单

错误类型	示例	修复方法
重复条目	同一论文两个不同 key	删除重复，统一引用
cite 未合并	`cite{a}, cite{b}`	→ `cite{a, b}`
Early Access 保留占位页码	`pages = {1--1}`	删除 pages，加 note
Conference 用了 @article	`@article` + `booktitle`	改为 `@inproceedings`
期刊名硬编码	`journal = {IEEE Trans. Wireless Commun.}`	→ `journal = IEEE_J_WCOM`
标题拼写错误	"Computation Computational"	核实原文实际标题
作者过多未截断	7+ 作者全列	BSTcontrol 启用 et al.
缺失必要字段	无 volume/number/pages	通过 DOI 补全

辅助工具集成

项目中可能存在以下辅助脚本，如存在则优先利用：

analyze_bib.py

功能：解析 .bib 文件，检测重复、分析引用覆盖率
调用：python analyze_bib.py
输出：详细分析报告

nameTranslate.py

功能：将 .bib 中硬编码的期刊名替换为 IEEE 标准宏
调用：python nameTranslate.py
依赖：IEEEfull.bib 用于全名匹配

注意事项

不修改 IEEEabrv.bib 和 IEEEfull.bib——这些是 IEEE 官方标准宏文件
修改前必须展示 Before/After，等用户确认后再执行（遵循全局 CLAUDE.md 规则）
DOI 验证时注意：部分新发表或 Early Access 文章可能尚未被搜索引擎索引
标题中的特殊格式（如 {{...}}）是 BibTeX 的大小写保护，不要随意删除
搜索验证论文时，优先使用 DOI 查询，其次使用标题+作者搜索
不要自动删除未引用条目——用户可能正在写作中，留待确认

ieee-reference-manager

Installation