Zotero PDF翻译插件实操指南：从选中文本到批量翻译文献

Zotero PDF翻译插件实操指南：从选中文本到批量翻译文献

【免费下载链接】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

凌晨赶稿，PDF 阅读器里整页英文，你一边复制选句一边在翻译网页里粘贴、复制回来，来回切了二十次窗口，段落早就断了。Zotero PDF Translate 是个 Zotero 翻译插件：在阅读器里选中 PDF、EPub 或网页文本，译文直接出现在弹窗和右侧面板；高亮标注自动带上译文；条目标题、摘要能批量翻译，还能开独立窗口并排对比 20 多个翻译引擎的结果。

📦 5 步装好插件并看到第一条译文

1. 从项目 Releases 页下载.xpi插件文件。
2. 在 Zotero 顶部菜单工具(Tools)→Plugins打开扩展页，点右上角齿轮图标，选Install Plugin from file，选中刚才下载的.xpi。
3. 装完 Zotero 会自动重启；此时右侧工具栏出现翻译图标即安装成功。
4. 打开任意 PDF，用鼠标选中一句英文，译文立即出现在选区下方的弹窗里。
5. 如需换目标语言，进Edit → Settings → Translate → Service调整。

⚠️ 安装时报版本不兼容 → 原因：Zotero 版本低于 7.9.9 → 动作：先升级 Zotero 再装插件。

选中文本后，右侧面板 Translate 分区与选区弹窗同时显示译文

🔍 场景一：单篇精读，选哪句翻哪句

1. 在 Zotero 阅读器打开 PDF / EPub / 网页，选中要看的句子或段落。
2. 译文默认自动出在弹窗里，右侧 item pane 的 Translate 分区同步显示。
3. 想改成手动触发：进Edit → Settings → Translate → General，取消勾选Automatically Translate Selection，之后点弹窗上的Translate按钮才翻译。

默认服务是 Google Translate，不用填任何密钥；目标语言跟随 Zotero 界面语言，所以 Zotero 是中文时，英文选区自动翻成中文。

⚠️ 选中后没有译文 → 原因：源/目标语言与实际文本不符 → 动作：在Settings → Translate → Service改语言。 ⚠️ 单词选区只显示翻译、没有词典释义 → 原因：词典功能被关 → 动作：在Settings → Translate → General勾回Enable Dictionary（默认开启，单词会走词典服务并可点发音按钮）。 ⚠️ 面板译文字太小 → 原因：Font Size 默认 12 → 动作：在Settings → Translate → User Interface调 Font Size。

选区弹窗给出中文译文，右侧 Translate 分区同步显示原文与结果

选完单篇精读，真正费时间的是整本文献——这时候标题和摘要值得一次翻完。

⚡ 场景二：批量翻译标题和摘要

1. 在左侧库或 Collection 里多选条目（Ctrl/⌘+ 点击，或拖选）。
2. 在任一条目上右键，选Translate Titles批量翻标题，或选Translate Abstract批量翻摘要。
3. 也可以先选中阅读器里的文本，按Ctrl+T，快速显示/隐藏标题翻译。
4. 想清掉之前批量写入的译文：进Settings → Translate → Advanced，点Reset field of selected items in library，选中条目后批量重置标题/摘要翻译字段。

标题、摘要的翻译结果会存进条目字段里，之后不进阅读器也能直接看到，这就是"批量"的意义——一次写入，处处可读。

⚠️ 部分条目翻译报错 → 原因：个别服务密钥无效或服务不支持该语言对 → 动作：换免费服务（如 CNKI、有道）重试。

📌 场景三：标注联动，译文跟着高亮走

1. 在Settings → Translate → General勾选Automatically Translate Annotation：之后每高亮或下划线一段文本，译文自动写进标注注释。
2. 再勾Automatically Translate Annotation from Sync，从其他设备同步过来的标注也会被翻译。
3. 改标注里的原文后，在 item pane 点Update Annotation，可修改标注文本并重新翻译。
4. 如果当前打开着笔记编辑器：选中文本后弹窗里会多出Add to Note，原文加译文一起写进笔记；勾选Replace Raw则用译文替换原文入笔记。

右侧红框为标注注释里的译文；左侧箭头指向 Add to Note 按钮

⚠️ 改完标注重新翻译后译文没更新 → 原因：标注文本被Settings → Translate → Advanced里的Delimiter包裹，原文没改只改了译文 → 动作：直接改标注里的原文再点Update Annotation；不需要安全重翻的话把 Delimiter 设为空。

读一本文献时一种引擎的翻译够用，但对照术语时你可能想看第二个引擎怎么说——这就是独立窗口的活。

🔀 场景四：独立窗口并排对比多个翻译引擎

1. 在右侧 Translate 面板点开独立翻译窗口（Standalone Panel）。
2. 在窗口顶部文本框粘贴或输入要对比的文本，点Translate。
3. 每加一个引擎就多一行结果：底部选服务后点Add Source，同一文本会依次显示 Google、CNKI 等各自的结果。
4. 不想要的行点该行右侧Remove移除。

这个窗口的定位就是"对比台"：一个文本，多列结果，术语定夺一眼定。

独立面板中同一段文本分别由 Google 与 CNKI 引擎翻译并排展示

⚠️ 某一行服务一直转圈不返回 → 原因：该服务密钥错误或格式不符 → 动作：按 README 中该服务的密钥格式（多为#分隔）重填，或点Remove先删掉这行。

❗ 高频问题速查

• 选中文本没翻译 → 源/目标语言选错，默认目标语言跟 Zotero 界面语言 → 去Settings → Translate → Service调整语言。
• 中文 PDF 也被自动翻译 → 没设置语言豁免 → 在Settings → Translate → Advanced的 "Disable Automatic Translation when File Language is" 里填zh,en（逗号分隔）。
• 带密钥的服务报 401/403 → 密钥格式没按服务要求写（多为#分隔）→ 对照项目 README 中该服务的 secret 格式重写。
• 单词不查词典、直接整句翻 → 词典被关 → 在Settings → Translate → General勾回Enable Dictionary。

🚀 老用户加速项

翻译引擎的选择按场景定：中英混排的网页、博客翻得快就选 Google Translate（免费、免密钥）；纯中文学术文献选 CNKI（免密钥）；追求中文精翻选 DeepL（需密钥，免费 50 万字符）；需要 LLM 语境理解选 GPT / Gemini（需 API key）。各服务密钥格式见项目 README，服务实现代码在 src/modules/services/，20+ 引擎按需取用。

先用默认 Google 配置把"选中→出译文→落到标注"跑通，卡在哪一步再回上面对应场景找那条 ⚠️。

【免费下载链接】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