Doc2X Zotero 插件使用指南
本文档介绍如何安装和使用 Doc2X 的 Zotero 插件，实现 PDF 文档的智能解析和翻译。
前置准备
1. 安装 Better notes for Zotero
下载地址: Better notes for Zotero
2. 安装 Doc2X 客户端和插件
需要下载以下两个组件：
注意: 部分浏览器不认可 xpi 文件，会提示 xpi 文件损坏，建议使用 Edge 或 Chrome 浏览器解决此问题。
3. 注册 Doc2X 账户
注册地址: doc2x.noedgeai.com
视频教程
详细操作视频: https://www.bilibili.com/video/BV19Yf5YXEDF
使用流程
第一步：安装所需组件
确保安装以下所有组件：
- ✅ Zotero
- ✅ Doc2X 客户端
- ✅ Better notes 插件
- ✅ Doc2X 插件
第二步：配置插件设置
安装完成后，打开插件和桌面版客户端（确保已登录 Doc2X 账户）
Windows 系统设置
- 支持版本: 仅支持 Win10 和 Win11
- 不支持: Zotero6 版本
- 操作路径: Zotero7 → 编辑 → 设置
Mac 系统设置
- 支持版本: 暂时只支持 M 系列芯片
- 操作路径: Zotero → 设置
Zotero 系统设置
- 插件 1.0.18 及以后版本支持 zotero7 与 zotero 8 Beta
重要提醒: 如果需要更新 Zotero 插件，必须先卸载旧版本插件 → 关闭 Zotero → 重新打开 Zotero → 安装新版本插件，否则可能因为 Zotero 的 bug 出现各类问题。
第三步：获取 Token
- 打开 Doc2X 客户端
- 点击插件设置"获取 token"
- Mac: 左上角状态栏 Zotero - 设置 - Doc2X - 点击 获取 token
- Windows:
- 查看 token 状态和解析次数显示
费用说明
- 付费模型: 消耗积分和解析页数
- 免费模型: 只消耗解析页数
第四步：开始使用
在有父条目的 PDF 上右键，即可看到 Doc2X 相关选项。
使用注意事项
大文件处理建议
- 不建议在 Zotero 中对页数特别多的 PDF（>100 页）进行翻译
- 长 PDF 翻译时状态更新可能不明显
- 进度没有更新不代表翻译卡住，请耐心等待
- 可在客户端查看实时翻译进度
DeepSeek 模型特别提醒
DeepSeek 模型在翻译时耗时较长，请耐心等待。
翻译错误处理
如果遇到翻译阶段出错的情况（完成解析扣除解析页数，但翻译过程失败）：
正确做法:
- 在客户端的左侧任务栏选中相关结果
- 点击"继续翻译"
- 此操作只扣除积分，不会再次扣除解析页数
- 客户端内右上角导出选择导出到 zotero
错误做法:
- ❌ 不要在 Zotero 中重新发起翻译
系统兼容性
| 操作系统 | 支持版本 | Zotero 版本 | 状态 |
|---|---|---|---|
| Windows | Win10/Win11 | Zotero7,Zotero8 Beta | ✅ 支持 |
| Windows | Win10/Win11 | Zotero6 | ❌ 不支持 |
| Mac | M 系列芯片 | Zotero7,Zotero8 Beta | ✅ 支持 |
| Mac | Intel 芯片 | - | ❌ 暂不支持 |
问题反馈
如遇到任何 bug 或问题，请通过下面的方式联系我们：
常见问题
Q: xpi 文件提示损坏怎么办？
A: 换用 Edge 或 Chrome 浏览器进行安装。
Q: 翻译进度长时间没有变化是否正常？
A: 正常现象，特别是使用 DeepSeek 模型时，请耐心等待并在客户端查看实时进度。
Q: 如何避免重复扣费？
A: 翻译失败后，请在客户端继续翻译，不要在 Zotero 重新发起。
Q: 支持哪些 Zotero 版本？
A: 目前仅支持 Zotero7，不支持 Zotero6。