本页内容
安装插件、连接客户端，再试一篇论文
- 从官方页按 Zotero 版本下载 XPI，在插件管理器中从文件安装。
- 启动并登录同机 Doc2X 客户端，在 Zotero 的 Doc2X 设置获取 Token。
- 配置模型、目标语言、术语表与输出，并确认完成配置。
- 先选择一篇原始 PDF 解析或翻译，检查父条目下的笔记与 PDF 结果。
- 需要批量时多选目标资料，核对文件清单、权益和额度后开始。
先完成同机客户端授权和输出设置；批量前核对一篇论文的保存位置与实际消耗。
切换版本，核对实际下载的两份 XPI
2026-10-10 在同一官方下载页切换 9/10 与 7/8，分别下载 XPI。两包的 SHA-256 与各自官方 GitHub 发布一致，包内 manifest.json 声明的 Zotero 范围分别为 9.0–10.* 和 7.0.0-beta.70–8.*。
- 先在 Zotero 的“关于”中确认主版本，再选择对应卡片。
- 保留 XPI 原文件，在 Zotero 插件管理器中从文件安装；不要解压成文件夹。
- 升级 Zotero 主版本后重新核对安装分支，旧版自动更新不等于跨主版本换包。
兼容范围来自实际安装包声明，未在本次环境中安装或运行 Zotero；它不等于每个版本、系统与任务都已完成实测。截图与记录保留核对日版本，下载时以官方下载页为准。
先了解这几件事
Doc2X Zotero 插件按 Zotero 主版本分别下载：Zotero 9/10 选“9 / 10”，Zotero 7/8 选“7 / 8”。下载 XPI 后在 Zotero 插件管理器中从文件安装，不解压；再启动并登录同机 Doc2X 客户端，在插件设置获取 Token、完成输出配置，用一篇原始 PDF 验证后再批量处理。
- 安装与兼容
- Zotero 9/10 与 7/8 使用不同官方 XPI；按主版本选择，不解压安装包。
- 首次授权
- 同一电脑上的 Doc2X 客户端保持运行并登录，在插件设置中获取 Token。
- 输入与输出
- 处理选定论文 PDF；按设置将双语笔记与保留排版 PDF 等结果归入原父条目。
- 批量方式
- 多份 PDF 顺序处理，每份创建任务并消耗对应额度；不是合并成一个文档翻译。
- 账户与 API
- 插件 Token 是客户端账户授权，不是开放平台 API Key；插件使用不等于开放了完整文献工作流 API。
Zotero 主版本与官方包的对应关系
| Zotero 主版本 | 下载页选项 | 2026-10-10 下载核对 |
|---|---|---|
| 9 或 10（包括 9.0.6） | 9 / 10 | 插件 v1.1.20；包内声明最低 9.0、最高 10.*。 |
| 7 或 8 | 7 / 8 | 插件 v1.1.18；包内声明最低 7.0.0-beta.70、最高 8.*。 |
| 6 | 当前没有对应包 | 先查看 Zotero 的升级与插件兼容说明，不套用上述安装包。 |
按 Zotero 主版本安装官方 XPI
在 Zotero 的“关于”中确认当前版本，再从官方下载页选择 9/10 或 7/8。在 Zotero 插件管理器中使用“从文件安装插件”，选择完整 XPI。升级 Zotero 主版本后也要重新核对分支；同一插件版本号不是 Zotero 自身版本号。
连接客户端，再完成翻译配置
在同一电脑打开 Doc2X 桌面客户端并登录。在 Zotero 的 Doc2X 设置中获取 Token，检查授权与额度，然后选择目标语言、模型、术语表和输出，确认已完成配置。这里使用的是客户端授权，不要填入开放平台 API Key。
单篇论文从原始 PDF 附件开始
在目标论文的原始 PDF 附件上选择 Doc2X 解析或翻译。需要两类阅读结果时，可按当前权益选择组合翻译，同时生成双语对照与保留排版结果；输出数量由配置决定，不是固定两个文件。
批量前核对文件清单和保存范围
多选 PDF 或论文父条目后，确认要处理的原始附件，避免选中以前生成的译文。任务顺序处理，各自结果归入对应父条目。每份文件会新建任务并使用相应额度，开始前检查文件名与确认信息。
在原条目下找笔记和 PDF
处理完成后展开论文父条目，分别查看原文、译文或双语笔记，以及保留排版译文 PDF 等已启用输出。组合翻译、单独双语翻译和单独保留排版是不同操作，结果应与所选任务和设置对应。
失败后先找原任务，减少重复提交
已解析完成但翻译失败时，先在 Doc2X 客户端找到原任务，查看可用的继续翻译入口；完成后再按指南导出到 Zotero。批量失败时核对已完成文件，只重处理需要的部分。
版本、连接与输出先用一篇论文核对
按 Zotero 主版本选择当前插件包，在同一电脑运行并登录 Doc2X 客户端。插件连接 Token 不是 OpenAPI key；当前流程不应沿用旧版对 Better Notes 的固定要求。条目有多个 PDF 时选择原文，按配置检查笔记和保版 PDF 的保存位置。
批量失败后保留已完成任务
批量按顺序执行，遇到首个失败会停止；手动停止时当前任务完成后不再开始下一项。先检查解析、翻译还是回写失败，只处理剩余项；解析成功的文档可以在 Doc2X 继续翻译后导出。
详细操作教程
按当前版本核对安装包、同机客户端连接、批量状态与结果附件。
遇到这些情况
- 安装时提示与 Zotero 9.0.6 或当前版本不兼容
- 先检查 Zotero 主版本与所选 7/8、9/10 分支是否匹配，再从官方入口重新取得对应 XPI。包的版本号、Zotero 版本号和 Doc2X 客户端版本号是三件事。
- 获取 Token 失败或连接中断
- 确认同机 Doc2X 客户端已启动且登录，再检查插件设置中的授权状态；必要时重启客户端与 Zotero 后重新获取。
- 安装 XPI 后缺少预期菜单
- 检查包是否匹配 Zotero 版本、翻译配置是否完成，以及选中的是可处理 PDF 还是笔记。组合和批量菜单还取决于权益与当前选择范围。
- 翻译完成但找不到两类结果
- 展开原论文父条目，检查输出设置、笔记和 PDF 附件，并查看任务是否仍在保存；不要因为暂未看到结果就立即重复提交。
- 批量中途停止
- 首个失败文件会停止后续队列。先检查已完成项与失败原因，再只处理剩余文件；手动停止会等待当前文件完成。
常见问题
提示“doc2x-parse is incompatible with Zotero 9.0.6”怎么办？
先确认下载的是 9/10 分支，不要在 Zotero 9.0.6 中安装只支持 7/8 的旧包。核对日的 9/10 包声明支持 9.0 至 10.*；安装后按提示重启，再检查插件设置。仍失败时记录 Zotero、插件和系统版本及完整错误，通过帮助中心反馈。
doc2x-parse 与 doc2x-ai-translate 是什么关系？
官方发布将 1.1.12 及更早版本的 doc2x-parse 更名为 doc2x-ai-translate。旧教程或旧包可能仍显示旧名；选择时以 Zotero 主版本和官方下载分支为准，不只看文件名。
Zotero 插件需要额外安装 Better Notes 吗？
当前官方图文流程不再要求额外安装 Better Notes。旧视频可能包含过期步骤，请以本页链接的最新指南为准。
插件兼容哪个 Zotero 版本？
当前官方下载分为 Zotero 9/10 和 7/8 两个包，Zotero 6 没有对应包。兼容声明和核对日版本见上表；安装后的实际功能还需在自己的系统里验证。
组合翻译是否免费，是否一定只生成两个文件？
不是。组合翻译需对应权益并消耗任务额度；它指双语对照与保留排版两类阅读结果，具体笔记和 PDF 数量取决于输出设置。
只有网页版账号，为什么还要打开客户端？
Zotero 插件的当前授权流程通过同机已登录的 Doc2X 客户端获取 Token。普通网页处理、插件授权与开放平台 API 是不同入口。
重复点击开始会继续原来的任务吗？
从 Zotero 重新发起同一 PDF 会创建新任务，可能再次消耗额度。先在客户端查看已有任务是否可以继续，再决定是否重新提交。
内容核对：2026-10-10 · 功能条件与配额以当前产品界面为准