✓已收录于 Add-on Market for Zotero 的 addon-scraper 数据源
在 Zotero 中完成整篇 PDF 翻译
选中文献附件即可提交翻译，译文 PDF、原文译文对照版和 Markdown 结果可自动添加回原条目。默认翻译为简体中文，也可以在插件设置中更改目标语言。
addon-scraper 数据源并搜索插件名称。三步开始第一次翻译
推荐通过 Add-on Market 安装，后续更新更方便；也保留 Releases 手动安装方式。
安装插件市场
下载并安装 Add-on Market for Zotero。已经安装的用户可以直接进入下一步。
搜索 FanyiPaiban
选择 addon-scraper 数据源，搜索 FanyiPaiban PDF Translator 并安装。
配置专用 API Key
在开发者中心创建 Key，粘贴到插件设置并测试连接，然后选择目标语言和输出格式。
从附件到译文，始终留在同一个条目下
插件围绕 Zotero 条目和本地 PDF 附件工作，适合论文、报告、说明书与研究资料的连续阅读。
选中 PDF 或父条目
支持直接选中本地 PDF，也支持选中仅包含一个本地 PDF 的父条目。存在多个 PDF 时会要求明确选择。
自动识别源语言
默认目标语言为简体中文。提交前校验 API Key 和余额，普通用户不需要判断具体翻译引擎。
结果自动添加回条目
译文 PDF 始终生成，可选对照 PDF 和 Markdown，完成后以新附件形式保留在原文献下。
把失败停在清楚的位置
鉴权、余额和任务状态放在同一条流程中。网络中断造成提交结果不确定时，会沿用同一个 Idempotency-Key，降低重复创建和重复扣费风险。
- API Key 保存在 Zotero 本地凭据存储中
- 取得服务端 taskId 后，重启 Zotero 可以继续轮询和下载
- 本地一次只处理一个翻译流程，减少连续点击造成的重复提交
- 只有用户主动发起翻译时，所选 PDF 才会上传
适合放进真实文献库的处理方式
安全信息和 Zotero 文献数据分开保存，文件上传也只发生在用户明确操作之后。
Key 留在当前 Zotero 配置
API Key 不写入文献字段、附件标题、普通偏好设置或待恢复任务记录。
单文件最大 300 MB
上传直接从磁盘读取，避免把整份大 PDF 一次性载入 JavaScript 内存，超限会在提交前阻止。
任务状态可以恢复
服务端接受任务后会保留 taskId，插件可在重启后继续查询、下载并添加附件。
安装前需要知道的几件事
插件免费，翻译任务与工作台、REST API、MCP 共用同一个 credits 账户。
这是 Zotero 官方插件目录吗？
不是。当前插件已收录于第三方 Add-on Market for Zotero 的 addon-scraper 数据源，可以通过该市场搜索、安装和更新。
必须通过插件市场安装吗？
不是。也可以从项目 Releases 下载 XPI，在 Zotero 的“工具 > 插件”中选择从文件安装。
API Key 如何创建和撤销？
前往开发者中心的令牌管理页面创建。建议为 Zotero 单独创建一个 Key，设备停用或 Key 泄露时可以单独撤销。
翻译语言可以修改吗？
可以。默认目标语言是简体中文，也可以在插件设置中选择其他目标语言。
安装或任务遇到问题
反馈时请提供 Zotero 版本、插件版本和脱敏后的错误信息。微信：melevelalk、nj-juhuizhineng；邮箱：124005421@qq.com。