windingwind/zotero-pdf-translate · 上手攻略

  • 仓库：windingwind/zotero-pdf-translate
  • 链接：https://github.com/windingwind/zotero-pdf-translate
  • 分类：academic-writing · productivity
  • 作者：Jay
  • 更新：2026-07-14

这是什么

Zotero PDF Translate（又名 Translate for Zotero）是 Zotero 的插件，实现了在 Zotero 阅读器内直接翻译 PDF、EPub、网页内容、文献标题、摘要、批注和笔记的功能。目前支持 20+ 翻译服务，覆盖 Google Translate、DeepL、ChatGPT（OpenAI GPT）、CNKI、百度、有道、火山引擎、腾讯翻译等国内外主流翻译 API。

作者为 windingwind（杨一川），模板项目 zotero-plugin-template 也出自同一作者，在 Zotero 插件开发社区以高活跃度著称。截至 2026-07-14，GitHub 周增 +21，星标 11287，属于学术工具类增长较快的项目。

解决什么问题

阅读外文文献时，常见痛点：

  • 语言壁垒：非英语母语者读英文 PDF，频繁切换到翻译网页，操作繁琐
  • 批注翻译需求：高亮一段话后，想同时保存原文和译文作为复习材料
  • 多翻译源对比：一个翻译结果不满意，想同时看 Google/DeepL/ChatGPT 三家结果
  • 标题摘要翻译：批量导入外文文献时，中文用户希望标题摘要自动翻译

Zotero PDF Translate 把这些需求全部集成进 Zotero，无需离开阅读器，一个快捷键搞定。

快速安装

前置条件

  • Zotero 6+（建议 Zotero 7 最新版）
  • Zotero Connector 浏览器插件（可选，方便从网页直接抓取文献）

⚠️ 注意：Zotero PDF Translate 是 Zotero 的扩展插件，不是独立软件。必须先安装 Zotero 桌面客户端。

安装步骤

  1. 前往 GitHub Latest Release 页面
  2. 下载 .xpi 文件（如 zotero-pdf-translate.xpi） - Firefox 用户：右键点击 .xpi → 「另存为…」（直接左键点击 Firefox 会尝试将其作为 Firefox 扩展安装，导致失败） - Chrome/Edge 用户：直接点击下载即可
  3. 打开 Zotero → 顶部菜单栏 Tools → Plugins
  4. 点击右上角 ⚙️ 图标 → Install Plugin From File…
  5. 选择下载的 .xpi 文件，点击「安装」
  6. 重启 Zotero

插件安装后会自动检查更新，之后无需手动重装。

核心用法

翻译选中文本（核心功能）

在 Zotero 阅读器中打开任意 PDF/EPub/网页：

选中文本 → 弹出翻译气泡（自动翻译，默认开启）
  • 快捷键：Ctrl+T（Windows/Linux）或 ⌘+T（macOS）：手动触发翻译
  • 合并翻译模式：选中多段文字后，按 Ctrl/⌘ 或勾选 item pane 中的 Concat Mode，可将多段合并后一次性翻译（v2.2.0 新增）

高亮批注翻译

选中文字并添加高亮后，插件自动将译文写入批注注释（annotation comment）：

选中文字 → 高亮 → 译文自动追加到批注中
  • v0.6.6+ 支持在 item pane 中直接修改译文文字，点击「Update Annotation」更新到批注
  • 「Automatically Translate Annotation」开关位于 Edit → Settings → Translate → General

标题翻译

在文献列表选中条目 → 右键 → Translate Title
# 或快捷键 Ctrl+T（在 collection view）

摘要翻译

选中条目 → 右键 → Translate Abstract

独立翻译窗口（v0.7.0+）

菜单 View → Translate Window，可同时显示多个翻译服务的结果，方便对比。

添加到笔记（v0.4.0+）

选中文字后，在弹出的翻译气泡中点击「Add to Note」： - 将原文 + 译文一起写入当前笔记 - 开关：Edit → Settings → Translate → User Interface → Replace Raw（开启后笔记中仅保留译文）

词典模式（v0.7.1+）

选中单词时，自动调用词典服务（而非通用翻译），显示释义和发音按钮。

逐句翻译（v1.1.0+）

翻译完成后按 Shift+P，选择「Translate Sentences」，适合逐句精读。目前仅支持 en↔zh 和 en↔en 方向。

翻译服务配置

打开 Edit → Settings → Translate → Service：

服务 是否需要密钥 免费额度 备注
Google Translate 否（使用 translate.googleapis.com） 免费 ✅ 开箱即用首选
Bing 否 免费 仅 en↔zh
DeepLX 否（使用公共接口） 免费 基于 DeepLX 开源项目
DeepL Translate 是（API Key） 免费 50 万字符/月 翻译质量最佳
OpenAI GPT 是（API Key） $18 免费额度 支持 GPT-4，翻译质量最高
百度翻译 是 免费 QPS=1 / 每月 2M 字符 200+ 语言
有道翻译 是 免费 100+ 语言
火山引擎 Web 否 免费 en, zh 及更多
CNKI 翻译 否 免费 中英互译，学术术语优化
Azure GPT 是 按量计费 企业用户
Llama/OwO-Network 否 免费 自托管 DeepLX 方案

⚠️ 密钥安全提醒：API 密钥属于个人凭证，请勿将密钥写入任何公开文档或分享给不可信方。在 Zotero 设置中填写后，密钥仅存储在本地。

典型适用场景

场景 适合度 说明
读英文 PDF 文献（中英对照） ★★★ 高亮批注自动追加译文，最适合做翻译精读
批量翻译文献标题/摘要 ★★★ 右键菜单一键完成，适合文献管理
论文写作：参考外文资料 ★★★ 词典模式 + 翻译气泡，工具流顺畅
对比多家翻译质量 ★★☆ 独立翻译窗口可多服务并排
翻译 EPub 电子书 ★★☆ 功能完全支持，但 EPub 排版效果因书而异

坑与注意

  1. Firefox 下载 .xpi 失败：这是最多人踩的坑。Firefox 会把 .xpi 当作 Firefox 扩展，用左键点击下载会导致安装失败。解决：右键 → 「另存为…」，或换 Chrome/Edge 下载。

  2. 翻译气泡不出现：检查 Edit → Settings → Translate → General → Enable Reader Selection Pop-up 是否勾选；确认 Zotero 版本 ≥ 6。

  3. 译文语言不对：默认目标语言与 Zotero 界面语言一致。如需翻译为其他语言（例：想译成英文而非中文），在 Edit → Settings → Translate → Service 中修改语言设置。

  4. DeepL/ChatGPT 等需要密钥的服务报错：确认 API Key 填写正确，密钥格式不要含空格；确认账户有剩余额度；确认网络可访问对应 API 端点。

  5. 翻译大段落响应慢：GPT 等 LLM 翻译每次调用有延迟；建议分段翻译（每段不超过 500 字），或切换到 Google Translate（速度更快）。

  6. 批注翻译同步问题：Automatically Translate Annotation from Sync 选项控制是否翻译从其他设备同步过来的批注。开启后可能产生大量 API 调用，注意成本。

  7. v2.2.0 concat 模式：Windows/Linux 下按住 Ctrl、macOS 下按住 ⌘ 即进入合并选择模式，文档明确说明，不要和普通选择混淆。

与同类对比

工具 Stars 特点 与本工具关系
Zotero PDF Translate 11k+ Zotero 内集成，20+ 翻译服务，批注翻译 —
Kaxaml — 论文全文翻译 无直接竞争
CNKI 翻译 — 中文论文英译中 专注单方向
DeepL 桌面客户端 — 划词翻译，但不是 Zotero 内集成 功能类似但无文献管理
Zotero Better BibTeX — 文献引用与 BibTeX 导出 同属 Zotero 插件生态

Zotero PDF Translate 的差异化在于紧贴 Zotero 阅读器场景——不需要复制内容到外部翻译工具，翻译结果直接沉淀在文献批注里。这是其他独立翻译工具无法提供的集成价值。

一句话推荐结论

读外文文献必备的 Zotero 插件：划词翻译、批注双语对照、多翻译源对比，一个插件全搞定，安装五分钟，翻译一辈子。