安装 Add-on Market
下载并安装 Add-on Market for Zotero。已经安装的用户可以直接进入下一步。
FanyiPaiban PDF Translator
支持 Zotero 7 至 Zotero 9
已收录于第三方 Add-on Market for Zotero，可搜索 FanyiPaiban PDF Translator 安装。
在 Zotero 里完成整篇 PDF 翻译
选中文献附件即可提交翻译，译文 PDF、原文译文对照版和 Markdown 结果可自动添加回原条目。默认翻译为简体中文，也可以在插件设置中更改目标语言。
插件免费安装
翻译服务按 credits 计费
结果自动归档到原文献
addon-scraper 数据源后搜索插件名称即可安装。
安装与配置
三步开始第一次翻译
推荐通过 Add-on Market 搜索安装，后续更新更方便；也保留 GitHub Releases 的 XPI 手动安装方式。
搜索 FanyiPaiban
在插件市场中选择 addon-scraper 数据源，搜索 FanyiPaiban PDF Translator 并安装。
配置专用 API Key
在开发者中心创建 Key，粘贴到插件设置并测试连接，然后选择目标语言和输出格式。
文献工作流
从附件到译文，始终留在同一个条目下
插件围绕 Zotero 的条目和本地 PDF 附件工作，适合论文、报告、说明书和研究资料的连续阅读。
选中 PDF 或父条目
支持直接选中本地 PDF，也支持选中仅包含一个本地 PDF 的父条目。存在多个 PDF 时会要求明确选择。
自动识别源语言
默认目标语言为简体中文。提交前会校验 API Key 和余额，普通用户不需要判断具体翻译引擎。
结果自动添加回条目
译文 PDF 始终生成，可选对照 PDF 和 Markdown，完成后以新附件形式保留在原文献下。
译文 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 泄露时可以单独撤销。
翻译语言可以修改吗？
可以。默认目标语言是简体中文，也可以在插件设置中选择其他目标语言。