mcpField
R
reference-manager-interop

reference-manager-interop

github.com/kalarislabs文档处理7355 次安装3 天前更新
代码仓库

关于 reference-manager-interop

reference-manager-interop 是一项帮助在文献管理器和写作工具间交换引文库的研究技能。它可转换 BibTeX/BibLaTeX、RIS 和 CSL-JSON 文件，并提供迁移与引文渲染指导。

主要功能

  1. 01转换 BibTeX、RIS 和 CSL-JSON 文件
  2. 02文献管理器导入与导出指南
  3. 03检查迁移后的条目数和引文字段
  4. 04使用 Pandoc 或 Quarto 渲染 CSL 引文

适用场景

  1. 01将 Mendeley 或 EndNote 文献迁移到其他工具
  2. 02转换 BibTeX 文献库以供 Pandoc 或 Quarto 使用
  3. 03检查格式转换后的文献库
  4. 04按目标 CSL 样式渲染引文

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kalarislabs/research-agent-skills --skill reference-manager-interop

安装后在 Claude Code 中输入/reference-manager-interop确认已加载。

附带文件scripts/convert_refs.py

详细介绍

参考文献管理器互操作性

每款参考文献管理器至少支持三种交换格式之一：

格式最适用于备注
BibTeX / BibLaTeX (.bib)LaTeX、Overleaf、JabRefBibLaTeX 新增了 @online、@dataset、@software，并通过 biber 支持 UTF-8
RIS (.ris)EndNote、Mendeley、Scopus/WoS/PubMed 导出每行一个标签，会丢失部分结构（例如团体作者）
CSL-JSON (.json)Pandoc、Quarto、Zotero、citeproc-js、Word/Docs 插件最丰富的交换格式，也是引文样式的原生格式

格式转换

python scripts/convert_refs.py library.ris references.bib        # EndNote/Mendeley -> LaTeX
python scripts/convert_refs.py references.bib references.json    # LaTeX -> Pandoc/Quarto
python scripts/convert_refs.py export.json out.ris --from csljson --to ris

转换可能会丢失非标准字段。务必比较条目数量（grep -c "^@" refs.bib、 grep -c "^TY -" lib.ris），并抽查带有粒子词（van、de、von）的作者和团体作者。然后对生成的 .bib 运行 bibtex-hygiene 检查工具。

特定工具的操作方法

Zotero（推荐作为中心管理器）

  • 安装 Better BibTeX 插件，然后右键点击一个文库 → 导出 → 保持更新， 即可在文稿旁生成会自动刷新的 .bib 文件，并使用稳定的引文键。
  • 编程访问：使用 pyzotero 技能（Zotero Web API；需要用户 API 密钥）。
  • Word/Google Docs：Zotero 连接器插件可插入实时引文和参考文献。

Mendeley Reference Manager

  • 导出：选择参考文献 → 导出 → BibTeX (.bib)、RIS 或 EndNote XML。
  • 迁移到 Zotero：导入 .ris/.bib 导出文件，或使用 Zotero 内置的 Mendeley 导入器。
  • 不要基于 Mendeley 的 Web API 构建新的自动化流程。请使用导出的文件。

EndNote

  • 导出：选择 File → Export，输出样式选 "RefMan (RIS) Export" (.ris) 或 XML。
  • 使用 "Reference Manager (RIS)" 筛选器重新导入 .ris。请检查编码是否为 UTF-8。

JabRef：原生支持 BibTeX/BibLaTeX。提交前请使用 Quality → Cleanup entries 和 Check integrity。

Overleaf：关联 Zotero/Mendeley 账户或上传 .bib 文件。若使用自动导出的 Better BibTeX 文件，请重新上传或通过 Git 同步。

使用 CSL 样式渲染引文（Pandoc / Quarto）

pandoc paper.md --citeproc --bibliography references.json --csl nature.csl -o paper.docx

Quarto 前置内容：

bibliography: references.json
csl: apa.csl          # fetch from https://github.com/citation-style-language/styles

从 CSL 仓库中为目标期刊选择准确的样式文件（超过 10,000 种样式）。 除非找不到对应样式，否则不要通过修改相似样式来近似期刊样式。

迁移清单

  1. 从源工具以其最丰富的格式导出（CSL-JSON 或原生 XML > RIS > BibTeX）。
  2. 记录迁移前后的参考文献数量。
  3. 如果目标工具无法导入源格式，请使用 scripts/convert_refs.py 转换。
  4. 导入后随机抽查 10 条，检查作者、标题大小写、文献出处、年份和 DOI。
  5. 单独重新附加 PDF。附件不会包含在 RIS/BibTeX/CSL-JSON 中。
  6. 只有在文稿尚未引用旧引文键时，才重新生成引文键。

相关技能

bibtex-hygiene、citation-verification、citation-management、pyzotero。

评论

支持 Markdown