Zotero 最强翻译插件,一键全文翻译保留排版

1 概述

将 PDFMathTranslate和 PDFMathTranslate-next 的全文翻译能力集成到 Zotero 中。核心能力：将英文论文 PDF 完整翻译为中文，保留原文排版——公式、表格、图表位置不变，生成双语对照 PDF。

与 Zotero PDF Translate 的区别

	Zotero PDF2zh	Zotero PDF Translate
翻译方式	全文翻译，产出新 PDF	划词翻译，弹窗显示
排版保留	✅ 公式、表格、图表原位	❌ 不涉及排版
使用场景	精读论文	快速查词、跳读
底层引擎	PDFMathTranslate（学术专用）	Google/DeepL 等通用翻译 API

2 安装

2.1 第零步：安装 Zotero

Zotero 软件的详细安装教程可以看上一篇文章。

2.2 第一步：安装 uv

# Windows（管理员身份打开 PowerShell 执行）
irm https://astral.sh/uv/install.ps1 | iex

安装后执行 uv --version 验证。

2.3 第二步：下载项目文件

以管理员身份打开 PowerShell 命令行窗口，切换到你想存放的目录，执行以下命令：

# 新建 zotero-pdf2zh 文件夹并切换到此目录
mkdir zotero-pdf2zh && cd zotero-pdf2zh

# UseBasicParsing：只下载文件，不解析网页
wget -UseBasicParsing -OutFile server.zip https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/refs/heads/main/server.zip

等待其下载即可。下载完成后的界面如下图所示：

如果 wget 下载失败，可手动访问 https://github.com/guaguastandup/zotero-pdf2zh/blob/main/server.zip 下载。

下载完成后，在当前目录解压 server.zip，解压后打开 server 目录，确认server.py 存在。

2.4 第三步：启动翻译服务

切换到 server 目录，PowerShell 执行以下命令：

uv run --python 3.12 --with-requirements requirements.txt server.py

⚠️ 翻译功能依赖此脚本持续运行，使用时不要关闭终端窗口。默认端口 8890。

2.5 第四步：安装 Zotero 插件

下载 zotero-pdf-2-zh.xpi，打开 Zotero 软件，选择 工具 → 插件，然后点击「⚙️」按钮，选择 Install Plugin From File.. ，从本地选择刚才下载的zotero-pdf-2-zh.xpi 文件，重启 Zotero。

2.6 第五步：配置插件

打开 Zotero 软件，选择 编辑 → 设置 ，选择「PDF2zh」，点击 检查连接 确认与 Python 服务的连接（端口默认 8890）

选择翻译引擎
配置翻译服务的 API Key

翻译引擎对比：


	PDF2ZH（旧版）	PDF2ZH Next（新版）
维护状态	❌ 不再活跃	✅ 持续更新
翻译速度	较快	适中
术语表	❌	✅ 自动提取
表格翻译	❌	✅
OCR 兼容	❌	✅
免费服务	无	siliconflowfree

翻译服务推荐：


服务	费用	说明
deepseek （推荐）	付费	翻译效果好，有缓存命中
siliconflowfree	免费	仅 pdf2zh_next，可能漏翻
bing/google	免费	限流严重，并发数需 ≤2
openaliked（火山引擎）	赠送 50w token/天	参加协作计划即可

⚠️ 仅添加 API 配置不会生效，还需在页面顶部下拉菜单中选择翻译服务。

3 使用

确保 server.py 在终端中运行
在 Zotero 中选中条目或 PDF → 右键 → PDF2zh

3․ 选择翻译方式，等待生成。生成后的中英文对照：

可多选条目进行批量翻译。

四种翻译模式：

模式	效果	适用场景
翻译 PDF	按选定格式生成译文 PDF	日常使用
裁剪 PDF	宽度裁半后上下拼接	手机阅读
双语对照	左译文 + 右原文并排	对照阅读
双语对照（裁剪后拼接）	先裁双栏为单栏再左右拼接	双栏论文对照