Doc2X Zotero 插件：安装、翻译与文献整理

按 Zotero 版本安装官方 XPI

打开下载页的 Zotero 插件卡片，按当前 Zotero 版本选择相应安装包。在 Zotero 插件管理器中使用“从文件安装插件”，选择下载的 XPI，无需解压。版本适配与更新以当前下载页和图文指南为准，不沿用搜索结果中的旧包。

连接客户端，再完成翻译配置

在同一电脑打开 Doc2X 桌面客户端并登录。在 Zotero 的 Doc2X 设置中获取 Token，检查授权与额度，然后选择目标语言、模型、术语表和输出，确认已完成配置。这里使用的是客户端授权，不要填入开放平台 API Key。

单篇论文从原始 PDF 附件开始

在目标论文的原始 PDF 附件上选择 Doc2X 解析或翻译。需要两类阅读结果时，可按当前权益选择组合翻译，同时生成双语对照与保留排版结果；输出数量由配置决定，不是固定两个文件。

批量前核对文件清单和保存范围

多选 PDF 或论文父条目后，确认要处理的原始附件，避免选中以前生成的译文。任务顺序处理，各自结果归入对应父条目。每份文件会新建任务并使用相应额度，开始前检查文件名与确认信息。

在原条目下找笔记和 PDF

处理完成后展开论文父条目，分别查看原文、译文或双语笔记，以及保留排版译文 PDF 等已启用输出。组合翻译、单独双语翻译和单独保留排版是不同操作，结果应与所选任务和设置对应。

失败后先找原任务，减少重复提交

已解析完成但翻译失败时，先在 Doc2X 客户端找到原任务，查看可用的继续翻译入口；完成后再按指南导出到 Zotero。批量失败时核对已完成文件，只重处理需要的部分。

如何开始

1. 从官方页按 Zotero 版本下载 XPI，在插件管理器中从文件安装。
2. 启动并登录同机 Doc2X 客户端，在 Zotero 的 Doc2X 设置获取 Token。
3. 配置模型、目标语言、术语表与输出，并确认完成配置。
4. 先选择一篇原始 PDF 解析或翻译，检查父条目下的笔记与 PDF 结果。
5. 需要批量时多选目标资料，核对文件清单、权益和额度后开始。

遇到这些情况

获取 Token 失败或连接中断

确认同机 Doc2X 客户端已启动且登录，再检查插件设置中的授权状态；必要时重启客户端与 Zotero 后重新获取。

安装 XPI 后缺少预期菜单

检查包是否匹配 Zotero 版本、翻译配置是否完成，以及选中的是可处理 PDF 还是笔记。组合和批量菜单还取决于权益与当前选择范围。

翻译完成但找不到两类结果

展开原论文父条目，检查输出设置、笔记和 PDF 附件，并查看任务是否仍在保存；不要因为暂未看到结果就立即重复提交。

批量中途停止

首个失败文件会停止后续队列。先检查已完成项与失败原因，再只处理剩余文件；手动停止会等待当前文件完成。

常见问题