SciVolume 里的引用能不能点到正确条目，取决于导入那一刻题录里有没有落下可匹配的字段。把一堆题录直接塞进库就开始写，最常见的后果不是导入报错，而是引用看着像正常链接、点开却停在空页或落到同名条目上。判断方向很清楚：先在导入阶段把每条文献的标题、作者、年份、DOI 和引用键补齐，再用一小节试写验证回填链路，确认无误后再批量写作。字段缺失的条目并非绝对不能写，而是需要提前知道它会在哪里出问题，以及用什么标识作为替代匹配键。

适用场景：手里有几十条以上题录、准备连续写作。操作动作：导入前逐条检查 BibTeX 的 title、author、year、doi 与 citekey；导入后核对条数与空字段；先写一小节做引用回填试验；补齐缺字段后重导同一文件观察去重与标识变化。验证方式：列表条数对比、空字段清单、引用点击落点、导出引用清单与库条目对照表。边界：老书、内部报告常无 DOI，需要用 citekey 或标题加年份作为替代匹配键，不能强求 DOI 非空。

把待用文献整理成可导入的题录文件，先确认每条都有标题、作者、年份、DOI

题录文件的格式通常是 BibTeX、RIS 或从数据库导出的 CSV。SciVolume 的引用回填一般先按 citekey 找条目，找不到再退回 DOI 或标题匹配，所以最小信息集里除了四个内容字段，还要有一个稳定的 citekey。可以先把骨架写出来，再逐条往里填：

@article{zhang2024volume,
  title   = {完整且唯一的文章标题},
  author  = {Zhang, San and Li, Si},
  year    = {2024},
  journal = {期刊名},
  doi     = {10.xxxx/xxxxx}
}

每一个字段缺失，都会在引用环节以某种具体形式暴露出来：

• 缺 title：列表里显示为无标题条目，标题匹配失效，点引用可能停在空页。
• 缺 author：引用格式里出现占位符，同作者多篇时无法消歧。
• 缺 year：按年份排序和同题消歧失效，早期版本与后续版本容易互相指错。
• 缺 doi：只剩模糊匹配，是引用指到错误条目最常见的原因。如果文献本身没有 DOI，需要在 citekey 上保证唯一，并先确认工具允许按 citekey 回填。
• 缺 citekey 或 citekey 重复：正文里的 \cite{key} 无法解析，或解析到另一条。建议 citekey 用姓氏加年份加短标题的形式，全库唯一。

导入前的检查可以先不依赖工具，用文本编辑器或下面的命令粗略统计条目数和含 DOI 的行数，两个数字的差值就是需要人工确认的条目：

grep -c '^@' refs.bib
grep -ci 'doi *=' refs.bib

导入后在文献库列表里核对条数与字段完整度

导入动作完成不等于条目全部落库。建议导入前先记下文件里的条目数，导入后在文献库列表里看总数，再按标题或年份排序，找出显示为空或占位的字段。下面是一次可复用的核对记录，把示例数字换成你自己环境的实际值即可：

• 导入前在源文件上执行 grep -c '^@' refs.bib，得到条目数 A。
• 导入后文献库列表页显示总数 B。A 与 B 相等，说明数量层面没有丢条目；B 小于 A，通常是被去重合并，需要查看导入日志里是否有 skip、duplicate、merged 之类的记录；B 大于 A，说明同一文件此前被导入过，需要清理重复项。
• 再执行 grep -ci 'doi *=' refs.bib，得到含 DOI 的条目数 C。A 减 C 就是缺 DOI 的条目数量，在列表里按 DOI 列筛选空值，把这份清单单独导出来。

列表里字段为空值的条目要单独记下来，它们是后面引用指空的候选来源。这一步只核对有没有，不判断对不对；字段写错属于另一类问题，需要靠后面的对照表发现。

先写一小节做引用回填试验，再决定是否批量写作

选正文里最靠前的一小节，写三五句话，插入三到四处引用，覆盖不同类型：一篇有 DOI 的期刊文章、一篇没有 DOI 的书或报告、一篇容易被同名混淆的条目。写完后逐处点击或悬浮引用，把结果按落点类型记录下来：

• 正常落点：打开对应条目详情页，标题和年份与正文语境一致。
• 停在文献库搜索页或结果列表：说明只做了模糊匹配，需要人工确认是否命中正确条目。
• 显示为纯文本或提示引用不存在：说明 citekey 没有解析成功，回到题录文件确认该键是否存在、是否在导入时被改写。
• 落到同名条目：标题相近、年份不同或作者相同，通常是按标题匹配导致，需要改成 DOI 或 citekey 精确匹配。

记录格式可以很简单：引用键、被引条目标题、落点类型、是否可接受。只有这一小节的落点全部可接受，才把写法扩展到后面章节。试验一小节的成本很低，写完再回头修引用的成本则高出不少，这个顺序值得坚持。

对字段缺失的条目补齐后重新导入同一文件

把上一步清单里的空字段补上，通常是补 DOI、补作者全名、补年份，然后对同一个题录文件重新执行导入。重导前先备份当前文献库文件，重点观察两件事：条目数有没有变化，条目标识有没有被改写。

• 重导前条目数 B，重导后条目数 B'。二者相等，说明按 citekey 或 DOI 完成了去重，存量条目的字段被更新；B' 大于 B，说明工具把新导入的内容当成了新条目，需要在列表里找出重复项手工合并，并确认正文引用指向的是哪一条。
• citekey 是否变化。如果导入时开启了按标题生成键一类的选项，原本写在正文里的 \cite{oldkey} 会失效，因为库里只剩 newkey。重导后建议随机抽两三处引用再点一次，确认仍然解析。
• 补齐 DOI 后被合并的条目。部分工具按 DOI 去重，原本缺 DOI 的条目此前只能按标题独立存在，补上 DOI 后可能与已有条目合并成一条，此时要确认正文引用是否自动更新到合并后的条目。

如果重导会产生大量重复条目，而工具没有合并入口，可以调整顺序：先导出库，人工合并成一份干净题录，清空库后一次性导入。这种做法风险集中在清空这一步，务必备份后再执行。

验证方式：导出该章引用清单，与文献库条目逐条对照

点击验证只能证明点得开，不能证明每条引用都覆盖到了。更稳的做法是把该章的引用键全部导出，与文献库的条目键做一次集合比较，差集就是仍未匹配的条目：

# 从正文中取出引用键并去重
grep -o '\\cite{[^}]*}' chapter.md | tr ',' '\n' | sort -u > cited.txt

# 从题录文件中取出条目键并去重
grep -o '^@[a-z]*{[^,]*,' refs.bib | sed 's/^@[a-z]*{//; s/,$//' | sort -u > library.txt

# 正文引用但库里没有的键
comm -23 cited.txt library.txt

# 库里有但正文未引用的键，可用于清理无用条目
comm -13 cited.txt library.txt

命令里的文件名和路径按实际情况替换；如果正文不是 Markdown，抓取模式需要相应调整。拿到两份清单后，把每个引用键对应的条目标题、年份、DOI 填进对照表，仍未匹配的条目在状态列标出，状态列也用来记录替代匹配方式。

未匹配的条目按三类处理：正文里的键写错，就改引用键；条目确实没导入，就补进题录文件后重导；文献本身缺 DOI，就在状态列写明按标题加年份匹配，并人工确认一次落点。三列对照表配合导出差集使用，比逐条点击更适合在批量写作前做一次整体确认。