MuiseDestiny/zotero-reference · 上手攻略
- 仓库：MuiseDestiny/zotero-reference
- 链接：https://github.com/MuiseDestiny/zotero-reference
- 分类：engineering / academic-writing · PDF · reference
- 作者：Tom
- 更新：2026-08-11
它是什么
zotero-reference 是一个 Zotero 的 PDF 参考文献增强插件（Zotero Add-on）。它在 PDF 阅读器界面中新增一个悬浮窗口，自动解析当前 PDF 的参考文献/引用列表，并支持直接导入到 Zotero 文献库。写学术论文时，这个插件能显著减少手动查找、复制参考文献信息的时间。
核心功能：点击一下，获取 PDF 内嵌参考文献的元数据（标题、作者、期刊、DOI），并支持双向关联文献、批量导入。
解决什么问题
学术写作中，向 Zotero 导入参考文献是个体力活：要么手动一条条填表，要么靠 DOI/标题搜索碰运气。很多 PDF（尤其是中文学位论文、会议论文）外部检索不到，必须从 PDF 本身提取参考文献列表。
zotero-reference 解决了这个痛点——直接从 PDF 原文解析参考文献，无需联网搜索；同时支持多个数据源（PDF 本身、readpaper、Crossref、Semantic Scholar、arXiv）互补，极大提升文献导入成功率。
快速安装
前置要求
- Zotero 6.0 或更高版本
- Zotero 对应版本的 Zotero PDF Translate 插件（用于翻译功能，非必需）
安装步骤
方法一：直接下载 .xpi 安装（推荐）
- 前往 Releases 页面
- 下载最新版本的
.xpi文件 - Zotero → 工具 → 附加组件 → 齿轮图标 → "Install Add-on From File"
- 选择下载的 .xpi 文件，重启 Zotero
方法二：从源码构建
git clone https://github.com/MuiseDestiny/zotero-reference.git
cd zotero-reference
# 参照 https://github.com/windingwind/zotero-plugin-template 构建
# 需要 Node.js、npm、zip
npm install
npm run build
# 产物在 build/ 目录
首次配置
安装后建议打开 Zotero → 首选项（插件设置）进行个性化配置： - 自动抓取引参考文献开关 - 优先数据源设置（PDF / API） - 条目类型过滤（排除学位论文等超长 PDF）
核心用法
基础操作
| 操作 | 触发方式 | 说明 |
|---|---|---|
| 解析参考文献 | 单击悬浮窗刷新按钮 | 首次从首选项设置的优先源获取 |
| 刷新（强制重解析） | 长按刷新按钮 | 忽略本地缓存，重新从所有源抓取 |
| 向前解析 | Ctrl + 单击/长按刷新按钮 | 从当前页向前扫描，适用于硕博论文（需提前滚动到最后一条参考文献所在页面） |
| 复制全部参考文献 | 双击悬浮窗参考文献文字区域 | 复制所有条目到剪贴板 |
参考文献条目操作
| 操作 | 效果 |
|---|---|
| 单击蓝色区域 | 复制单条参考文献信息（含 DOI 标识符） |
| 长按蓝色区域 | 编辑参考文献信息（推荐中文文献使用，精简条目可提高导入成功率） |
| Ctrl + 单击蓝色区域 | 用系统浏览器打开文献 URL |
| 单击 + | 添加参考文献到当前 PDF 所在所有文件夹，双向关联 |
| Ctrl + 单击 + | 添加到 Zotero 主面板当前选中的文件夹 |
| 单击 - | 取消双向关联（不删除文献本身） |
数据源说明
浮窗顶部小圆点代表不同数据源，点击切换：
- PDF：从 PDF 原文提取（默认，最可靠）
- readpaper：标题搜索
- Crossref：标题 / DOI 搜索
- Semantic Scholar：DOI 搜索
- arXiv：arXiv ID 搜索
各源互补——硕博论文建议优先 PDF + Crossref；英文期刊优先 Crossref + Semantic Scholar。
辅助功能
- 翻译：需配合 zotero-pdf-translate 插件；Ctrl + 鼠标左键在原文/译文间切换
- 分栏快速跳转：点击 PDF 内跳转链接（Fig 4、Eq 2 等），会在分割窗口中打开目标位置，避免前进后退
- 推荐关联：来自 ReadCube API 的相关文献推荐
典型适用场景
- 写文献综述：批量导入某篇论文的参考文献，几分钟完成平时几小时的工作
- 中文学位论文整理：导师/学生的论文 PDF 无法从 Crossref 搜到，从 PDF 原文解析是唯一路径
- 跨语言文献管理：PDF 原文 + 翻译对照，一边读一边建立文献库
- arXiv 预印本整理：arXiv ID 直接解析，无需手动搜索
坑与注意
⚠️ 首次使用必读首选项：插件不生产数据，只是数据的搬运工——如果数据源没配置，刷新后什么都拿不到。
⚠️ 硕博论文建议 Ctrl + 点击刷新：普通点击从 PDF 末尾向前解析，适合普通论文；Ctrl + 点击从当前页向前扫描，适合论文页数过多、页码不连续的情况。
⚠️ 中文文献编辑建议：长按编辑，精简条目字段（去除冗余中文标点、重复作者信息），可显著提升后续导入成功率。
⚠️ 与 scihub 插件不兼容：自动关联功能与 scihub 插件冲突，二选一。
⚠️ 需要 PDF 滚动到最后：Ctrl + 点击向前解析时，需提前将 PDF 滚动到最后一条参考文献所在页面。
⚠️ 依赖 Zotero 6+：旧版本 Zotero 不支持当前插件 API，请先升级 Zotero。
⚠️ API 源速度：Ctrl + 单击 URL 偶尔需要查询文献地址，略有延迟，属正常现象。
与同类对比
| 插件 | 数据源 | 双向关联 | PDF 内解析 | 支持语言 |
|---|---|---|---|---|
| zotero-reference | PDF / Crossref / Semantic Scholar / arXiv / readpaper | ✅ | ✅ | 中英 |
| Zotero itself | DOI/标题搜索 | ❌ | ❌ | — |
| jasminum（茉莉花） | CNKI/百度学术 | 部分 | ❌ | 中文 |
| chartero | Crossref/DBLP | 部分 | ❌ | 英 |
zotero-reference 的核心优势是PDF 内直接解析，不依赖外部检索——这对中文 PDF 和无法联网检索的场景尤为关键。
一句话推荐结论
写学术论文、整理参考文献，Zotero 里装 zotero-reference 插件——一键解析 PDF 内嵌参考文献，双向关联文献库，中英文通吃。
原始仓库：https://github.com/MuiseDestiny/zotero-reference