WildDataX/suppr-zotero-plugin · 上手攻略
- 仓库：WildDataX/suppr-zotero-plugin
- 链接：https://github.com/WildDataX/suppr-zotero-plugin
- 分类：学术工具 / Zotero 插件 / AI 翻译
- 作者：Tom
- 更新：2026-08-21
这是什么
suppr-zotero-plugin（超能文献 Zotero 翻译插件）是一款将 AI 文档翻译能力深度集成进 Zotero 文献管理环境的 Zotero 插件。由 WildDataX 团队开发，基于 Zotero Plugin Template（经原作者 @windingwind 授权），使用 TypeScript + React + Webpack 构建。
它解决的是学术场景下最具体的一个痛点：在 Zotero 中直接翻译 PDF、Word、PPT、Excel、HTML 等学术文档，无需离开文献管理环境。 翻译后自动以独立附件形式附加到原文献条目，保留原有文献库结构不变。
核心功能： - 一键翻译：选中 PDF → 右键 → "超能文献翻译"，无需切换窗口 - 格式保持：翻译后保持原文排版、图表、公式位置 - 学术术语优化：专门针对学术文献训练的 AI 模型，术语准确性优于通用翻译工具 - 多格式支持：PDF、Word（.docx）、Excel（.xlsx）、PPT（.pptx）、HTML - Zotero 9 全面兼容：支持 Zotero 7 / 8 / 9 三个大版本 - Zotero 中文社区认证：已正式收录于 Zotero 中文社区插件库
⚠️ 重要限制：该插件并非完全本地离线运行。翻译过程需要将文档上传至 suppr（超能文献）云服务完成，因此需要网络连接和一个 suppr 账户（可免费注册，有免费额度）。
解决什么问题
| 痛点场景 | 本插件解法 |
|---|---|
| 读英文 PDF 时反复复制粘贴到 Google Translate | 选中 Zotero 条目 → 右键翻译，5 秒出结果 |
| Zotero + 翻译工具来回切换打断阅读节奏 | 完全集成在 Zotero 右键菜单，无缝衔接 |
| 翻译后找不到译文，文件散落各处 | 翻译结果自动附加到原条目，同一 Zotero 条目下管理原文+译文 |
| 翻译破坏 PDF 排版（图表错位、公式乱码） | 专用格式保持算法，学术文档结构完整 |
| 不同工具翻译学术术语不准确 | 学术文献专用 AI 模型，术语库和专业词汇优化 |
| Zotero 版本升级后插件不兼容 | 支持 Zotero 7/8/9，社区持续维护 |
快速安装
前置要求
- Zotero 版本：6.0 及以上（Zotero 6 / 7 / 8 / 9 均支持）
- 网络连接：需要能够访问 suppr.wilddata.cn 云服务
- suppr 账户：免费注册 https://suppr.wilddata.cn
安装步骤
方法一：从 GitHub Releases 安装（推荐）
# 1. 访问 releases 页面
# https://github.com/WildDataX/suppr-zotero-plugin/releases
# 2. 下载最新版本的 .xpi 文件
# 文件名形如：suppr-zotero-plugin-x.x.x.xpi
# 3. 打开 Zotero → 工具 → 附加组件（或直接拖拽 .xpi 到 Zotero 窗口）
# Zotero 6：编辑 → 首选项 → 附加组件
# Zotero 7+：工具 → 附加组件
# 4. 点击齿轮图标 → "Install Add-on From File" → 选择下载的 .xpi
# 5. 重启 Zotero
方法二：从超能文献官网安装
# 官网：https://suppr.wilddata.cn
# 下载 .xpi 文件后，拖拽到 Zotero 主窗口即可
方法三：从 Zotero 中文社区插件库安装
# Zotero 中文社区插件库已收录本插件
# 访问：https://zotero-chinese.com/plugins
# 搜索"超能文献"或"suppr"
# 按页面指引安装
验证安装
# 安装完成后打开 Zotero
# 1. 查看工具 → 附加组件，确认插件列表中出现"超能文献"或"suppr"
# 2. 在任意 PDF 条目上右键，菜单中应有"超能文献翻译"选项
# 3. 点击后应弹出翻译进度窗口
核心用法
1. 基本翻译流程（三步）
步骤 1：选择文档
在 Zotero 文库中选中需要翻译的 PDF 文档
步骤 2：启动翻译
右键点击文档 → 选择"超能文献翻译"
步骤 3：等待完成
系统自动上传并处理文档，翻译完成后自动下载并附加到原条目
2. 查看翻译结果
# 翻译完成后，在 Zotero 条目详情面板：
# - 原始 PDF 仍保留在第一个附件位置
# - 翻译后的文档以第二个附件形式出现（命名含"翻译"字样）
# - 两个附件并列在同一条目下，无需跨目录查找
3. 翻译设置（可自定义）
# 在 Zotero 中：
# 编辑 → 首选项（或工具 → 选项）→ 找到"超能文献"相关设置面板
# 可配置：
# - 翻译语言对（例：英文→简体中文 / 日文→简体中文）
# - 翻译质量等级（高质量 / 快速）
# - 进度通知开关
4. 其他文档格式翻译
# 不仅是 PDF，插件还支持：
# - Word 文档（.docx）
# - Excel 表格（.xlsx）
# - PPT 演示文稿（.pptx）
# - HTML 网页
# 用法与 PDF 相同：选中条目 → 右键 → 超能文献翻译
5. 配合超能文献网页端使用
# 超能文献还提供独立网页服务，支持更多功能：
# - PDF翻译：https://suppr.wilddata.cn/translate/landing/pdf
# - Word翻译：https://suppr.wilddata.cn/translate/landing/docx
# - Excel翻译：https://suppr.wilddata.cn/translate/landing/xlsx
# - PPT翻译：https://suppr.wilddata.cn/translate/landing/pptx
# - 网页翻译：https://suppr.wilddata.cn/translate/landing/html
# - 通用上传：https://suppr.wilddata.cn/translate/upload
# Zotero 插件翻译的内容与网页端共用账户体系，额度互通
典型适用场景
1. 快速阅读非英语学术论文 导师/同事分享了一篇日语/德语/法语论文，直接在 Zotero 内翻译成中文阅读，无需另开标签页。
2. 构建双语文献阅读习惯 对每篇重要文献同时保留原文和译文，方便后续引用时对照核验关键术语的英文原词。
3. 跨语言文献调研 在撰写综述时快速翻译一批外文文献摘要，评估是否值得精读。
4. 组会材料准备 将组会要讨论的外文论文提前翻译好，节省组会现场阅读时间。
5. Zotero 作为翻译结果管理器 即便不用 Zotero 读论文，翻译结果可以作为独立附件永久保存，形成自己的翻译语料库。
坑与注意
| 坑点 | 说明 | 解决方案 |
|---|---|---|
| 右键没有翻译选项 | Zotero 版本过低（< 6.0）或插件未正确启用 | 确认 Zotero 6.0+，重启 Zotero，检查附加组件列表 |
| 翻译后译文没有自动下载 | 网络波动导致上传/下载失败 | 检查网络连接，在 Zotero 设置中查看是否有失败记录，重新右键触发 |
| 翻译速度很慢 | 文档过大（> 50MB）或服务器负载高 | 等待或稍后重试；超长文档建议先手动拆分 |
| 格式保持不完美 | 复杂排版（多栏、嵌套表格）可能出现轻微错位 | 这是目前 AI 文档翻译的通用局限，非本插件独占问题 |
| 免费额度用尽 | suppr 免费额度有限，高频使用需付费 | 关注 suppr.wilddata.cn 额度政策，按需购买 |
| 隐私顾虑 | 文档上传云端处理，涉密内容不适用 | 敏感文档请使用本地翻译工具（如 Ollama + 开源模型） |
| Zotero 升级后插件失效 | 插件版本未同步跟进 Zotero 大版本 | 关注 GitHub Releases 是否有新版；也可降级 Zotero 或等待插件更新 |
| 插件与 Zotero 其他插件冲突 | 部分插件组合可能导致 Zotero 崩溃 | 逐一禁用插件排查，常见冲突插件：Zotero GPT、JabRef 同步类插件 |
与同类对比
| 维度 | suppr-zotero-plugin | Zotero GPT | 手动复制到 Google Translate |
|---|---|---|---|
| 集成深度 | ✅ 深度集成右键菜单 | ✅ AI 对话式解读 | ❌ 完全外部操作 |
| 格式保持 | ✅ 专用排版保持 | ❌ 仅文本片段 | ❌ 需手动复制排版丢失 |
| 附件管理 | ✅ 自动附加到原条目 | ❌ 无 | ❌ 无 |
| 离线支持 | ❌ 需网络+账户 | ❌ 需网络 | ✅ 可离线（Google） |
| 学术术语优化 | ✅ 专用模型 | ✅ LLM 通用 | ❌ 无 |
| Zotero 7/8/9 兼容 | ✅ | 部分 | ✅ |
| 成本 | 免费额度+付费 | API 费用 | 免费 |
| 维护状态 | 活跃（2025-10 更新） | 一般 | N/A |
结论：如果你的主要痛点是"在 Zotero 里快速翻译 PDF"，suppr-zotero-plugin 是目前最顺滑的方案；如果你希望对文献有更深度的 AI 解读（提问、摘要、关系图），可以同时安装 Zotero GPT 插件互补使用。
一句话推荐
在 Zotero 里装上超能文献插件，从此翻译 PDF 只需右键，无需切换窗口——学术阅读效率提升显著。
最小可跑命令清单
# 前置条件：
# - Zotero 6.0+ 已安装
# - 网络可访问 suppr.wilddata.cn
# - 已注册 suppr 账户（https://suppr.wilddata.cn）
# ① 下载最新 .xpi
# https://github.com/WildDataX/suppr-zotero-plugin/releases
# ② 安装插件（无需命令行，直接操作 GUI）
# Zotero → 工具 → 附加组件 → 齿轮图标 → Install From File → 选择 .xpi
# ③ 重启 Zotero
# ④ 验证：任意 PDF 条目右键菜单有"超能文献翻译"
# ⑤ 翻译操作
# 在 Zotero 文库选中 PDF 条目 → 右键 → 超能文献翻译 → 等待完成
# ⑥ 查看结果
# 条目下会出现第二个附件（翻译后的文档），命名含"翻译"
来源：suppr-zotero-plugin GitHub · 超能文献官网 · Zotero 中文社区插件库 · 知乎介绍文 · 博客园教程