Zotero PDF Translate 实战指南：从零搭好 20+ 引擎的文献翻译环境

【免费下载链接】zotero-pdf-translateTranslate PDF, EPub, webpage, metadata, annotations, notes to the target language. Support 20+ translate services.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-pdf-translate

Zotero PDF Translate（项目内也称 Translate for Zotero）是一款 Zotero 插件，把 PDF、EPUB、网页正文以及文献的标题、摘要、注释、笔记翻译成目标语言，内置 20 余种翻译服务，默认引擎免密钥、装完即可用。兼容 Zotero 7/8。本文按"能翻什么、怎么装、引擎怎么选、结果在哪里看、工作流怎么搭、参数怎么调、失效怎么查、服务怎么扩"的顺序，把这条链路走一遍。

先弄清它翻译什么：五类内容对照

插件的翻译对象不止阅读器里的正文，完整范围如下：

另外两条容易被忽略的能力：单个单词默认走词典服务（带发音按钮）而不是机器翻译；翻译完成后按Shift+P选择Translate Sentences可以逐句对照翻译，目前仅支持 en2zh 与 en2en 方向。

安装插件并完成第一次翻译

1. 从项目的发行版（Releases）页面下载最新稳定版.xpi文件。
2. 在 Zotero 顶部菜单打开Tools→Plugins。
3. 在扩展页右上角点击齿轮图标，选择Install Plugin from file。
4. 选中刚下载的.xpi文件，安装完成后重启 Zotero。

默认翻译服务是 Google Translate，不需要密钥，目标语言默认跟随 Zotero 的界面语言。在 Zotero 阅读器里打开任意 PDF、EPUB 或网页，选中一句话，译文会自动出现在选区浮动面板和右侧项目窗格中：

如果划词后没有反应，先到Edit → Settings → Translate → General确认Automatically Translate Selection（默认开启）是否被关掉；想改为手动模式时，取消该开关，再点面板上的Translate按钮即可。

翻译引擎怎么选：免密钥、需密钥与自建三档

20 余种服务按"是否需要准备材料"分成三档。

免密钥档（装完直接可用）

需密钥档

密钥在Edit → Settings → Translate → Service页填入。各服务的格式不同，插件用#分隔字段，常见几种如下（免费额度以官方说明为准）：

两个细节：有道智云可以在控制台创建术语表，把词表 id 填进VOCABID，插件会优先使用你的术语；百度垂直领域翻译（Baidu Field）格式为MY_APPID#MY_KEY#DOMAIN_CODE，academic、finance、law等领域码仅支持中英方向。

自建服务档

LibreTranslate、MTranServer、NLLB、Pot、DeepLX(API) 需要先自行部署对应服务端，再在设置页填入地址。MTranServer 需 v3.0.0 及以上版本才支持zh-Hans/zh-Hant语言；Pot 比较特殊，翻译结果直接显示在 Pot 应用里。

服务列表页上，需要密钥的服务名带 🗝️ 标记，需要自建配置的带 📍 标记，未通过密钥校验的服务会被标记为"未配置"。全部引擎的实现在服务实现目录下，注册与排序规则（免密钥免费服务排前、custom 开头排后）见src/modules/services/index.ts。

翻译结果的三个展示入口

• 浮动面板：划词后弹出，General页的Enable Reader Selection Pop-up可控制开关；面板里的"加入笔记"按钮只在笔记编辑器激活时可见。
• 项目窗格：原文与译文并排显示，两者之间的分隔条可拖动调整高度，双击复位；User Interface页可控制窗格里显示哪些元素、原文/译文是否调换顺序。
• 独立窗口：在同一窗口内对比多个服务对同一段文字的翻译结果，User Interface页的Standalone: Keep Windows on Top可让该窗口常驻最前。

搭一套日常翻译工作流

按下面的顺序组合使用，能覆盖大多数文献阅读场景：

1. 注释带译文：在General页开启Automatically Translate Annotation，高亮句子的译文会自动写入注释评论（可选写入注释正文）；在项目窗格修改注释文本后点Update Annotation，原文与译文会一起重写。
2. 结果存进笔记：激活笔记编辑器后，一次操作把选中文本和译文加入当前笔记；勾选Replace Raw则用译文直接替换原文。
3. 跨段落连选：选词时按住Ctrl（Windows/Linux）或⌘（macOS），多个段落会拼接成一段整体翻译，也可以在项目窗格勾选Concat Mode。
4. 标题摘要批处理：在文献库多选条目后通过右键菜单批量翻译标题和摘要，Ctrl+T用于切换标题译文的显示。
5. 中文文献免翻：Advanced页的禁用语言列表默认为zh,zh-CN,中文，命中即跳过自动翻译，可按需增删，避免对中文文献做无效处理。

⚙️ 界面与细节参数

Edit → Settings → Translate → User Interface与Advanced两页，几个影响日常体验的项：

• Font Size（默认 12）与Line Height（默认 1.5）：决定译文排版。
• Item Context Menu/Item Pane Info：分别控制右键菜单、条目信息行中是否显示标题/摘要译文。
• Pop-up: Remember Size：不勾选时浮动面板每次自适应内容大小。
• Delimiter：注释译文会包裹在该字符内，重译时可安全识别旧译文；留空则重译直接覆盖注释原文。
• Regex for removing extra text：用正则清理 LLM 服务返回里的冗余内容（需会正则表达式）。
• 批量重置字段：在库或集合里选中条目后，一键清掉这些条目的标题或摘要译文。

🔍 翻译不出结果时按顺序查

1. 查密钥格式：对照上文各服务的#分隔格式逐段核对，插件内置密钥校验，校验不过的服务不会进入候选。
2. 查语言方向：源语言自动识别、目标语言默认跟 Zotero 语言走；结果与原文雷同通常是方向配反，在Service页调整。
3. 查降级链路：任务失败时插件会自动切换到候选服务列表里的下一个服务重试，留意面板上实际生效的是哪个服务名。
4. 查结果清洗：译文夹带空行或"思考"内容时，打开"去除空行与思考内容"开关或配置结果正则。

🧩 扩展一个翻译服务

引擎不在列表里时，可以按贡献者流程自己加一个：

1. 以src/modules/services/_template.ts为模板新建服务文件，填必填项id、type、translate（成功时把结果写入data.result，失败抛错），按需补充secretValidator、config等可选字段。
2. 在同目录index.ts的注册列表里导入新服务对象。
3. 在addon/locale/<lang>/addon.ftl里补上service.<id>等本地化字符串。
4. 构建并测试，确认设置页能选中该服务且密钥校验正常。

把免费引擎当主力、付费引擎按额度轮换、自建服务兜底，是这套插件比较省心的长期用法；引擎选好后，其余配置基本可以一劳永逸。

【免费下载链接】zotero-pdf-translateTranslate PDF, EPub, webpage, metadata, annotations, notes to the target language. Support 20+ translate services.项目地址: https://gitcode.com/gh_mirrors/zo/zotero-pdf-translate