AB
AB
AiBoss站

全部分类

教程

Doc2X

教程

用 Doc2X Zotero 插件翻译整篇论文 PDF 并输出双语笔记

面向需要精读外文论文的研究者，说明如何用 Doc2X 的 Zotero 插件把整篇 PDF 论文翻译成保留公式与图表的译文 PDF，或生成逐段对照的双语 Markdown 笔记，涵盖插件下载与版本匹配、桌面客户端授权、翻译参数配置、单篇与批量处理、已有结果回写等环节。

读一篇外文论文时，逐段复制到翻译工具里既慢又容易丢公式和图表位置。Doc2X 的 Zotero 插件把这件事放回文献管理流程里：在 Zotero 中右键一篇论文的 PDF，插件就会翻译整篇文档，并按你选择的模式产出保留原版式的译文 PDF，或逐段对照的双语笔记；所有结果都保存在原始条目下。它适合需要精读、做笔记或把译文分享给同事的研究者，也适合一次处理多篇文献的场景。插件本身不要求你自备翻译 API 密钥，授权来自同一台电脑上运行的 Doc2X 桌面客户端。本文按安装、授权、配置、单篇翻译、批量处理、结果回写的顺序展开，可配合站内的 Doc2X 工具页一起看。

准备工作

开始之前先确认下面几项，缺一项都会卡在中间步骤。

  • Zotero 版本：需要 Zotero 7、8、9 或 10。插件按 Zotero 主版本分包，装错包会提示不兼容。主版本号可以在 Zotero 的「关于」对话框里看到。
  • Doc2X 桌面客户端：支持 Windows 10/11，以及 Apple 芯片的 Mac。翻译期间客户端必须保持运行并处于登录状态，插件是从它那里读取授权的。
  • Doc2X 账号：免费额度、会员额度与高级点数都显示在授权状态下方，具体额度与计费方式以官网当前信息为准。
  • 一篇较短的论文：先用页数少的文献跑通流程，再处理批量任务。

另外要分清两类 Zotero 翻译插件。一类是划词翻译，翻译选中的文字、标题、摘要或批注，结果出现在翻译侧栏，通常需要自己配置翻译服务，部分服务超出免费额度后收费。另一类是全文翻译，按模式输出保留版式的译文 PDF、左右对照的双语 PDF，或条目下的双语 Markdown 笔记。Doc2X 插件属于后者。两类插件可以同时安装、分别配置，但不要把它们的安装包和授权说明混用——Doc2X 插件授权框里填的不是开放平台 API 密钥。

操作步骤

第一步：按 Zotero 主版本下载对应的插件包

打开 Doc2X 的下载页面，在 Zotero 插件卡片上先选择你的 Zotero 版本，再点下载。插件与桌面客户端配套使用，客户端可以在同一页面的 Windows 与 macOS 卡片下载。

Zotero 版本下载选项插件版本
Zotero 9 或 10（含 9.0.6）9 / 10v1.1.27
Zotero 7 或 87 / 8v1.1.25
Zotero 6无当前匹配包先参考 Zotero 升级与插件兼容性说明

插件的英文名现在是 doc2x-ai-translate，1.1.12 及更早版本叫 doc2x-parse。选包时以 Zotero 主版本为准，不要照着旧教程或文件名猜。版本号与发布日期会变化，以官网当前信息为准。

第二步：在 Zotero 中安装 XPI

下载得到的是 .xpi 文件，文件名类似 doc2x_1.1.27.xpi。不要解压。

  1. 打开 Zotero，选择「工具」→「插件」。
  2. 点插件管理器里的齿轮按钮，选择「从文件安装插件…」，选中下载的 .xpi 并打开。也可以直接把文件拖进插件管理器。
  3. 列表中出现已启用的「Doc2X AI文档翻译解析插件」，工具栏出现 Doc2X 图标，即安装成功。若提示重启，重启 Zotero。

Better Notes 不再是必需依赖，已安装的可以保留。如果安装后提示 doc2x-parse is incompatible with Zotero 9.0.6，基本可以确定是下错了包：7/8 包最高只支持 Zotero 8，不能用于 Zotero 9.0.6。回到下载页确认主版本后重装。若仍然失败，反馈时把 Zotero、插件和操作系统版本连同完整报错一起提供。

升级已有安装有两种方式：在 Zotero 插件管理器里检查更新，或从网站下载匹配的 .xpi 重新安装。升级后如果菜单消失或行为异常，先卸载旧插件，完全退出 Zotero，重新打开后再装正确的包。从 Zotero 7/8 迁移到 9/10 时，要换成 9/10 的包。

第三步：从桌面客户端获取授权

插件从同一台电脑上的 Doc2X 桌面客户端读取授权，所以先装好客户端并登录，翻译全程保持运行。

  1. 打开 Doc2X 桌面客户端，登录，并让它保持运行。
  2. 在 Zotero 中打开「设置」→「Doc2X」。macOS 上「设置」在 Zotero 菜单下，Windows 上在「编辑」菜单下。
  3. 在 Doc2X 授权设置里点「去获取」。状态会从「待授权」变为「已授权」，下方显示免费额度、会员额度和高级点数。

工具栏上的 Doc2X 图标里也有「获取 Token」入口。不要把 Token 放进公开截图。如果授权失败，先单独检查桌面客户端的版本与连接状态。

第四步：配置解析与翻译选项

授权下方是解析与翻译偏好设置，逐项确认：

  • 翻译模型：列表里有一个标注为免费的模型，其他模型标注为需要高级点数。授权后 Pro 账号可能自动选中某个按点数计费的模型，开始前务必检查当前选择。
  • 目标语言、术语表与上下文增强：上下文增强用于提升整篇论文中引用与术语的一致性，仅会员可用。
  • 翻译时忽略：勾选表格、代码、图片和参考文献后，这些内容保持原文语言。
  • 双语输出与版式输出：决定保存哪些笔记和 PDF，默认值通常够用。

最后勾选「我已配置完成解析&翻译设置」，等出现确认提示后再回到文献库。没有这一步，翻译和解析菜单项不会生效。

第五步：翻译单篇论文

在文献库中展开一篇论文，右键它的原始 PDF 附件，打开「Doc2X: 解析选项」子菜单。子菜单顶部显示当前 PDF 的文件名，下面有四个动作：

菜单项结果
PDF => Translate PDF to MD to notes双语翻译，保存为 Markdown 笔记
PDF => Parse PDF to MD to notes仅解析为 Markdown，不翻译
PDF => Preserve position translation保留版式的译文 PDF，可选左右对照双语 PDF
PDF => Bilingual comparison + layout-preserving translation (Pro Only)合并模式：一次任务同时产出上面两类结果

按需要选择：只要双语笔记选第一项，只要保留版式的译文 PDF 选第三项，两类都要选仅限 Pro 的合并项。合并属于会员功能，没有权限时插件会给出会员页面提示，并说明可以分别运行双语笔记和保留版式两个动作。一个条目下有多个 PDF 时，右键你要翻译的那一个。

右下角的 Doc2X 任务进度面板会显示解析、翻译和回写三个阶段。等待期间不要反复点开始。面板提示结果已回写到 Zotero 后，展开原始条目查看生成的笔记与 PDF。

第六步：批量处理多篇论文

在文献库中选中多个条目，右键选择批量选项。开始前先确认文件数量、剩余用量，以及每个条目的父条目是否正确——结果会挂到各自的父条目下。批量任务同样在右下角进度面板中查看，单篇结果互不影响，个别失败不会中断整批。

第七步：把已有结果导出回 Zotero

如果某篇论文已经在 Doc2X 里处理过，不必重新翻译。使用「Export an existing result to Zotero」把已有结果导出，条目会收到桌面客户端导出的内容。适合先在其他入口处理、再统一归档到 Zotero 的流程。

一个完整示例

下面以一篇 9 页的 Mistral 7B 论文为例，走一遍「双语笔记 + 保留版式译文」的合并流程。示例中的模型名与耗时仅用于说明流程，实际时间取决于页数、模型和队列。

  1. 在 Zotero 的「关于」对话框确认主版本为 9 或 10，从下载页选择 9 / 10 包，得到 doc2x_1.1.27.xpi。
  2. 「工具」→「插件」→ 齿轮 →「从文件安装插件…」，选中该 .xpi，出现 Doc2X 图标后重启 Zotero。
  3. 打开 Doc2X 桌面客户端并登录，保持运行。
  4. Zotero「设置」→「Doc2X」→「去获取」，状态变为「已授权」，记下当前免费额度与点数。
  5. 在翻译模型里确认选中的是免费模型或你打算使用的计费模型；目标语言设为中文；按需勾选「翻译时忽略」中的表格、代码、图片、参考文献。
  6. 勾选「我已配置完成解析&翻译设置」，等待确认。
  7. 展开该论文条目，右键原始 PDF →「Doc2X: 解析选项」→「PDF => Bilingual comparison + layout-preserving translation (Pro Only)」。
  8. 观察右下角进度面板依次经过解析、翻译、回写。示例中约半分钟完成，实际时间以任务队列为准。
  9. 面板提示回写完成后，展开原始条目：应能看到双语 Markdown 笔记，以及保留公式与图表位置的译文 PDF。

如果账号没有 Pro 权限，第 7 步改为分别执行「Translate PDF to MD to notes」和「Preserve position translation」，两次任务得到同样的两类结果。

注意事项

  • 客户端必须在线：授权来自同一台电脑上的桌面客户端，翻译期间关闭或退出登录会导致任务失败。
  • 平台限制：Windows 支持 10/11；macOS 客户端目前面向 Apple 芯片。
  • 版本匹配优先：装包前先看 Zotero 主版本，不要依据旧教程或文件名。Zotero 6 没有当前匹配的包。
  • 不要解压 XPI：直接通过插件管理器安装或拖入。
  • 模型选择会被自动改写：Pro 账号授权后可能自动选中按点数计费的模型，开始前检查一次，避免意外消耗。
  • 合并模式是会员功能：没有权限时插件会引导到会员页面，两类结果需要分两次任务完成。
  • 上下文增强仅会员可用：它改善引用与术语一致性，但不是所有账号都能开启。
  • 结果需要对照原文核对：译文 PDF 与双语笔记都可能存在识别或翻译偏差，尤其是公式、表格与参考文献，正式引用前应回看原文。
  • Token 不要外泄：公开截图前遮住授权信息。
  • 额度与价格会变动：免费额度、会员额度、高级点数与模型计费方式以官网当前信息为准。
返回