Doc2X Zotero 插件图文使用指南

在 Zotero 中选择论文 PDF，即可解析、翻译并把结果保存回论文条目。本教程按当前 1.1.12 版入口说明，介绍 Combine 组合翻译与多 PDF 顺序批量处理。

先看完整流程

下载对应插件 → 登录客户端并获取授权 → 配置翻译 → 选择 PDF → 查看笔记和 PDF 结果。

首次使用建议先选一份较短的论文，确认输出符合需要后再批量处理。

1. 下载与安装

按 Zotero 版本选择安装包

打开 官网下载页，找到「Zotero 插件」。

当前 Zotero 版本	下载页选择
Zotero 9 或 10	9 / 10
Zotero 7 或 8	7 / 8
Zotero 6	不支持，请先升级 Zotero

图 1：官网下载页实拍。两个选项对应不同安装包，不要混装。

下载得到 .xpi 文件，不要解压。进入 Zotero「工具 → 插件」，点击齿轮菜单，选择「从文件安装插件」（Install Plugin From File），选中 .xpi，按提示完成安装及重启。也可以把文件拖入插件管理器。

最新版无需额外安装 Better Notes；已经安装 Better Notes 的用户可以保留。Windows 使用 Win10/Win11；Doc2X macOS 客户端目前面向 Apple M 系列芯片。

更新已有插件

在 Zotero 插件管理器中检查更新，或从官网下载对应 .xpi 安装。若升级后菜单缺失或运行异常，再尝试卸载旧插件、完全退出 Zotero、重新打开并安装对应版本。

从 Zotero 7/8 升级到 9/10 时，需要换用 9/10 安装包。本次插件功能无需同步升级 Doc2X 桌面客户端；已有正常运行并登录的客户端可以继续使用。

2. 获取授权并配置翻译

图 2：首次配置操作示意图。

1. 安装并打开 Doc2X 客户端，登录自己的 Doc2X 账户，保持客户端运行。
2. 打开 Zotero 设置中的 Doc2X 页面：Windows 为「编辑 → 设置」，macOS 为「Zotero → 设置」。
3. 点击 获取 Token，确认授权状态和可用额度正常。Token 是账户授权信息，不要复制到公开截图或发给其他人。
4. 选择翻译模型、目标语言、术语表和输出格式。可用模型、权益及消耗以当前设置页为准。
5. 勾选 我已完成解析和翻译配置，再回文献库开始操作。

输出设置决定保存哪些笔记和 PDF。想同时看到两类结果，请检查双语对照与保留排版相关输出均已按需要选择。

3. 一份论文：使用 Combine 组合翻译

组合翻译的菜单名称是「PDF => 双语对照+排版翻译（Pro专属）」。它在一次任务中同时处理双语对照和保留排版翻译，两类结果一起保存。使用前请确认账户具备对应 Pro 权益。

1. 在文献库展开论文的父条目，找到要处理的原始 PDF 附件。
2. 在该 PDF 上点击右键，展开 Doc2X 翻译选项。
3. 选择 双语对照+排版翻译（Pro专属）。若从父条目进入且有多个 PDF，先明确选择目标附件。
4. 等待上传、解析、翻译和结果保存完成，再展开父条目查看。

图 3：依据实际菜单整理的操作示意图。不同 Zotero 版本的布局可能略有不同，以菜单文字为准。

两类结果分别是什么？

• 双语对照结果：将原文和译文组织成便于对照阅读的笔记，文字会被翻译，而不只是保留原文。可按设置同时保存原文、译文及双语笔记。
• 保留排版结果：得到保留原有版式的译文 PDF；按设置还可生成原文与译文并排的双语 PDF。

「同时得到两个结果」指两类阅读结果，不表示固定只生成两个文件。例如开启相关输出时，一篇论文可生成三份笔记和两份 PDF。输出数量取决于配置；忽略选项、识别效果及翻译模型也会影响内容，不代表每个元素都会翻译。

只需要单类结果时，可选择菜单中的双语对照翻译或保留排版翻译；只需提取内容时选择解析，无需组合翻译。

4. 多篇论文：顺序批量翻译

1. 展开论文条目，选择要翻译的 PDF 附件。Windows 按住 Ctrl，macOS 按住 Command 多选；连续项目可以用 Shift。注意不要选中此前生成的译文 PDF。
2. 右键选择 批量双语对照+排版翻译。也可按需要选择批量双语对照翻译或批量保留排版翻译。
3. 如果多选的是论文父条目，插件会弹出 选择本次批量翻译的 PDF，勾选目标文件，点击 确认选择。
4. 核对确认框中的 PDF 数量、文件名和额度说明，再确认开始。
5. 等待插件依次处理文件；完成一份后再开始下一份，结果分别保存到各自的父条目。

每个 PDF 都会创建新任务并消耗相应额度。 批量中首个文件失败后会停止后续处理。选择「停止批量翻译（当前文件完成后）」时，当前文件会继续完成，后续文件不再启动。

5. 在哪里查看结果？

回到原来的论文父条目，点击左侧展开箭头：

• 双击「双语 MD」「译文 MD」「原文 MD」等笔记，查看文字内容。
• 双击「保留排版译文 PDF」「保留排版双语 PDF」等附件，在 Zotero 阅读器中查看。
• 对支持的结果笔记点击右键，可使用 Doc2X：预览 Markdown 或 Doc2X：在网页中查看。组合任务会根据所选结果打开对应的阅读形式。

文件名会包含输出类型、语言或模型等信息。批量任务的结果按论文分别归档，不会都放在第一篇论文下。

费用、失败与重复提交

解析消耗解析页数，翻译按所选模型和账户权益计费；请以页面显示的额度规则为准。组合翻译不是免费翻译，批量处理也不会免除每份文件的消耗。

• 等待时不要反复点击开始。重新从 Zotero 发起同一 PDF 翻译会创建新任务，可能再次消耗解析页数和积分。
• 已解析成功但翻译失败时，先到 Doc2X 客户端找到对应任务，使用可用的「继续翻译」入口；完成后再导出到 Zotero，避免重复解析。
• 批量失败后，先查看已完成哪些文件，排查失败原因，再只选择尚未完成的文件处理。
• 长文档或较慢的模型可能需要较长时间。进度暂时不变不等于失败，可到客户端查看任务；首次测试建议使用短 PDF。

常见问题

看不到组合翻译或批量入口

先确认已安装最新的对应版本插件。组合翻译为 Pro 专属；批量入口需要选择多个可处理的 PDF 或父条目。选中笔记、无 PDF 的条目或单个项目时，菜单不同。也请确认已完成翻译配置。

一个条目里有多份 PDF，怎么避免选错？

直接在目标 PDF 附件上右键操作，或在父条目的附件选择入口明确选中。批量开始前再次核对确认框中的文件名。

获取 Token 失败或客户端连接中断

确认同一台电脑上的 Doc2X 客户端已启动并登录；必要时重启客户端与 Zotero，再获取授权。不要把开放平台 API Key 当作这里的客户端 Token 使用。

翻译完成但没有看到两类结果

检查输出设置、父条目是否已展开、任务是否仍在保存结果；组合翻译与单独的双语翻译不是同一菜单入口。若只有一类结果，先查对应任务状态，不要立即重新提交。

视频里要求安装 Better Notes，仍然需要吗？

不需要。旧版视频教程 中的部分安装步骤和菜单已过时，以本图文指南为准。

问题反馈

仍有问题时，请通过 联系我们 反馈，附上 Zotero 主版本、插件版本、失败阶段和已脱敏的截图。不要公开 Token 或账户敏感信息。