Zotero PDF Translate 上手指南：20+翻译引擎，3分钟装好即用

【免费下载链接】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 是一款 Zotero 插件，把阅读器里的 PDF、EPub、网页，连同文献标题、摘要、批注和笔记一起翻译成目标语言，内置 20 多种翻译服务，其中 Google、CNKI、海词、有道、Bing 等免费免密钥，装好即用。经常读外文文献、想边读边译的你，这篇覆盖从安装到日常使用的完整链路，看完就能自己跑通。

一、上路前检查

装之前花 1 分钟确认三件事：版本、网络、文件格式。

提醒：

1. 插件是.xpi安装包，不是浏览器扩展，只在 Zotero 里安装。
2. 用 Firefox 下载时右键文件选"另存为"，避免被浏览器直接打开。
3. 默认走 Google Translate，如果你的网络环境访问不稳，首次使用前先切到 CNKI 或 Bing，后文讲怎么切。

二、装进环境：最短路径安装

按下面 6 步走，1 分钟装完：

1. 从 Releases 下载最新稳定版.xpi文件；
2. 打开 Zotero，点顶部菜单Tools→Plugins；
3. 进入扩展页后，点右上角齿轮图标；
4. 选Install Plugin from file；
5. 找到刚下载的.xpi并确认安装；
6. 按提示重启 Zotero，装完。

验证装好了没有：打开任意 PDF，选中一段英文，译文会立刻出现在选区旁边的弹出面板和右侧项目窗格的 "Translate" 区块里。

三、第一次跑通：免密钥最小配置

默认配置就是最小可用配置，不用填任何密钥：

• 翻译服务：Google Translate（在Edit→Settings→Translate→Service里切换）
• 目标语言：默认跟随 Zotero 界面语言，可在 Service 页单独改
• 自动翻译选区：默认开启，选中即出译文

在阅读器里打开一篇英文文献，鼠标选中一句话，弹出面板和右侧项目窗格会同时给出译文——到这里你已经跑通了。想手动控制节奏，把General页的Automatically Translate Selection取消勾选，之后点面板上的Translate按钮才翻译。

四、按场景使用

下面四个场景对应最常见的读文献动作，按需取用。

场景 1：快速读懂摘要和关键段

打开文献，先在条目上用右键菜单触发标题、摘要翻译，再逐段选中正文。遇到需要完整上下文的段落，按住Ctrl（macOS 为⌘）依次选多段，它们会拼成一次翻译，避免逐句断片。想换引擎对比，去 Service 页切换服务后重新选区即可。

场景 2：高亮批注自动带译文

在 PDF 里用荧光笔或下划线做标注，译文会直接写进批注的注释里，之后回看批注不用重翻。改完批注文字后，在项目窗格点Update Annotation，原文和译文会同步更新。同步来的旧批注要不要自动翻译，由Automatically Translate Annotation from Sync控制，默认关闭。

场景 3：把译文存进笔记

打开笔记编辑器，在网页或文献中选中文本，点弹出面板里的Add to Note，原文加译文一起进笔记。勾上Replace Raw可以只用译文替换原文，笔记更干净。注意这个入口只在有活动笔记编辑器时出现。

场景 4：标题批量翻译 + 独立窗口多引擎对比

文献库里选中若干条目，Ctrl+T（macOS 为⌘+T）即可显示/隐藏标题译文，右键菜单同样可以触发。需要细读对比时，打开独立翻译面板，同一文本用 Google、CNKI、DeepL 等多个引擎并列输出，谁准用谁。

五、卡壳怎么办

按"现象 → 原因 → 办法"排查，高频问题都在这里：

1. 安装时提示与当前 Zotero 不兼容现象：装.xpi时直接报错。 原因：Zotero 低于 7.9.9。 办法：把 Zotero 升级到 7.9.9 或更新的 8.x 再装；确认拿到的确实是.xpi文件而不是网页。

2. 译文没出来，或报服务错误现象：选区后弹出面板空白或提示失败。 原因：当前服务在你的网络下不通，或该服务要求的密钥没填、格式不对。 办法：先换免密钥服务（CNKI、Bing）验证链路；确认是密钥服务时，按各服务格式填写（如 Baidu 为APPID#KEY，DeepL 为secretToken），详见 README 的 Service 一节。

3. 目标语言不对现象：想译成中文，结果译成了别的语言。 原因：默认目标语言跟随 Zotero 界面语言。 办法：Edit→Settings→Translate→Service里手动指定源/目标语言。

4. 想手动翻译，选区却自动翻了现象：刚选完字译文就弹出，节奏被打断。 原因：Automatically Translate Selection默认开启。 办法：Translate→General取消勾选，改点面板里的Translate按钮。

5. 译文太小或面板盖住半个页面现象：弹出面板文字看不清，或比例失调。 原因：字号和面板尺寸没调。 办法：Translate→User Interface改Font Size（默认 12）；项目窗格里的原文/译文分隔线可上下拖动调比例，双击复位。

六、进阶可选

• 快捷键：选区后按Ctrl+T出译文；英文转中文/英文场景翻译完按Shift+P选Translate Sentences逐句翻译。
• 单字查词典：只选中一个单词时，默认走词典服务（海词、Cambridge 等），可带发音播放按钮。
• 面板布局：原文/译文上下顺序、标题与摘要翻译入口，都能在User Interface页开关；Standalone 窗口可设"保持置顶"。
• 隐私：密钥只存在本地设置里，别截图分享；敏感内容可用自部署的 LibreTranslate、MTranServer、NLLB 类服务（需自建并配置地址）。

七、要点回顾与下一步

• 版本门槛：Zotero 7.9.9+，.xpi从文件安装，6 步装完。
• 免密钥起步：默认 Google，不稳就切 CNKI / Bing，零配置看到效果。
• 四个场景：选区即译、批注自动带译文、Add to Note存笔记、Ctrl+T批量翻标题。
• 排错三板斧：换免密钥服务验证网络 → 核对密钥格式 → 手动指定目标语言。
• 进阶看这里：README 有全部 20+ 服务的密钥格式与配置说明。

下一步建议：今天就装好，挑一篇在读的英文文献，把摘要翻成中文存进笔记，跑通"读—译—存"完整闭环。

工具装好了，用起来才算数——打开 Zotero，从第一篇文献开始吧。

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