4步搞定Zotero PDF中文翻译插件:英文文献轻松变中文,双语对照随心读
【免费下载链接】zotero-pdf2zhPDF2zh for Zotero | Zotero PDF中文翻译插件项目地址: https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh
Zotero PDF2zh 是一款专为 Zotero 打造的 PDF 中文翻译插件,它能把文献库里积压的英文 PDF 一键翻译成中文,同时保留原文的公式、表格和排版。这篇指南会从零开始,带你 4 步完成 Zotero PDF 翻译插件配置,并解锁双语对照、批量翻译、手机阅读等实用玩法。
先说说我为什么不想再手动翻译了
你是不是也经历过这样的场景:开组会前一周,导师甩来一篇 40 页的顶会论文,让你"先看看"……
- 复制粘贴到网页翻译,公式全乱、排版稀碎,看到一半就放弃了;
- 用浏览器划词翻译,一段一段点,翻完三页已经过去两小时;
- 花钱买的翻译工具,一遇到数学公式就原形毕露。
说白了,英文文献阅读最大的敌人不是词汇量,而是"翻译完之后根本没法看"。
Zotero PDF2zh 想解决的,正是这个问题:让翻译结果长得跟原版几乎一样,公式还是那个公式,表格还是那个表格,你只需要在 Zotero 里右键一下。
它到底帮你省了什么
一句话总结:它相当于给 Zotero 装了个"同声传译",原文和译文挨在一起,随读随翻。
上图就是它的招牌能力——双语对照。左边英文原文,右边中文译文,逐段对齐。专业术语拿不准?直接看左边原文,一秒对照,不用来回切换窗口。
它能做的还不止这一种:
- 纯中文 PDF(mono):只需要快速了解大意时,直接生成中文版通读;
- 双语对照 PDF(dual):精读文献、学专业术语时,中英并排看;
- 保留格式:公式、图表、参考文献排版基本原样保留,翻译完不用重新排版;
- 批量翻译:多选几篇 PDF,一次右键全部开工。
而且它不只支持一种翻译引擎。旧引擎 pdf2zh速度较快,新引擎 pdf2zh_next持续更新,自带术语表、表格翻译和 OCR 兼容能力,各有各的擅长。
上手前先搞懂 3 件事
很多新手装了半天没成功,往往是卡在没搞懂它的工作方式。其实原理很简单:
- 它由一个插件 + 一个本地小服务组成。翻译要用到开源项目 PDFMathTranslate 的模型,这些重活在本地服务(server.py)里完成,插件只负责把任务送过去、把结果接回来。所以翻译期间那个终端窗口别关。
- 翻译引擎可以切换。在插件设置里选 pdf2zh 还是 pdf2zh_next,界面会自动切换对应的配置项,别被"两套配置"吓到,二选一即可。
- 翻译服务决定效果和成本。有免费的,也有质量更高的付费 API,下面细说。
第一次上手:4 步完成Zotero PDF翻译插件配置
第 1 步:装好 Python 和 Zotero
- 建议安装Python 3.12(官方下载即可);
- Zotero 支持7 和 8两个大版本,装哪个都行。
第 2 步:装一个环境管理工具
推荐uv,一条命令搞定(Windows 在 PowerShell 里执行):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"macOS/Linux 用:
wget -qO- https://astral.sh/uv/install.sh | sh装完跑一下uv --version,能看到版本号就成功了。如果你更熟悉 conda,用它也可以。
第 3 步:下载服务端并启动
克隆仓库后进入 server 目录(Windows 建议放在非系统盘):
git clone https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh cd zotero-pdf2zh/server然后启动服务(uv 用户一行搞定):
uv run --python 3.12 --with-requirements requirements.txt server.py看到服务跑起来、默认监听 8890 端口,这一步就成了。记住:翻译期间这个终端窗口要一直开着。
第 4 步:安装插件并配置翻译服务
把仓库里的zotero-pdf-2-zh.xpi拖进 Zotero 的"工具 → 插件"窗口完成安装,然后打开设置里的PDF2zh 选项卡:
在这里你要做三件事:
- 点 "Python Server IP" 旁边的检查连接按钮,确认服务端通了;
- 在LLM API 配置管理里点击"新增",填入服务商的 URL、API Key 和模型名;
- 回到页面顶部的"翻译服务"下拉菜单,选中所用的服务。
第 3 步特别容易漏——只添加配置不选择服务,翻译是不会生效的。DeepSeek、智谱、硅基流动、火山引擎、阿里云这些主流的服务都支持,只要是 OpenAI 兼容格式基本都能填。
不想花钱?有两条免费路子:选 pdf2zh_next 引擎 + siliconflowfree 服务,完全免配置免 Key;或者用 bing/google 机器翻译,不过它们限流比较厉害,并发数建议调到 2 以下。
右键菜单里的 4 种翻译,分别什么时候用
装好之后,在 Zotero 里对 PDF 右键,就能看到PDF2zh子菜单:
| 菜单选项 | 干什么用的 | 什么时候用 |
|---|---|---|
| 翻译PDF | 按设置生成默认文件(mono 或 dual) | 大多数时候选它 |
| 裁剪PDF | 把页面在宽度 1/2 处裁开再上下拼接,顺带裁掉两侧空白 | 想在手机上看 |
| 双语对照 | 生成左边原文、右边译文的 PDF | 精读时逐句对照 |
| 双语对照(裁剪) | 先把双栏论文竖向裁成单栏,再左右拼接 | 双栏论文的终极阅读形态 |
比如通勤路上想刷文献,用"裁剪PDF"生成单栏文件,字号放大了、不用来回拖动,手机上看体验提升不止一个档次;写论文要精读,就用"双语对照",中英并排,术语表达顺手就学到了。
用起来更顺手的 4 个 Zotero 英文文献翻译技巧
- 用网页端盯进度。服务启动后,浏览器打开
http://127.0.0.1:8890,能看到当前任务进度、历史记录,翻译完的文件还能直接预览下载,比干等终端强多了。
批量翻译很省心。文献库里选中多篇论文,右键一次全丢给插件排队翻译,睡前挂上,第二天起来收结果。
首次翻译卡住别慌。pdf2zh_next 第一次运行要下载字体和模型文件,进度条会卡一会儿,这是正常的;之后就有缓存了。如果一直失败,多半是网络问题,换个网络或代理再试。
心里有本 token 账。一篇 10 页的英文文献大概消耗 7 到 10 万 token,单页 5 千左右。觉得烧得慌,可以在 pdf2zh_next 设置里关掉"提取术语表",能省下一大笔。
新手最常问的 4 个问题
Q:不配 API Key 能翻译吗?能,但只能走免费服务。siliconflowfree 零配置就能用,不过偶尔会漏译,追求质量还是建议自己配个 API。
Q:翻译出来有段落缺失?翻译失败时程序会用原文顶上,保证 PDF 能正常生成。遇到这种情况,先检查 API 是不是超限,或者换个翻译引擎试试。
Q:扫描版 PDF 能翻译吗?扫描件需要先用 OCR 工具(比如 Adobe Acrobat)识别成文字版,再交给插件翻译;pdf2zh_next 也提供 OCR 兼容模式,有需要可以在设置里打开。
Q:提示网络错误(NetworkError)怎么办?优先点设置页的"检查连接"按钮,确认 server.py 在跑、8890 端口没被占用;还不行就换一个端口重试(服务启动参数和插件里的 IP 两处要一起改)。
现在就去试试
说到底,工具选得再好,不如真的上手跑一遍。找个下午,按上面 4 步装好,丢一篇你最头疼的英文论文进去,十分钟后你大概率会感叹:原来翻译还能这么省事。
如果这个插件帮到了你,欢迎去仓库点个 star,让更多人看到它:
git clone https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh无论是准备开题的研究生、追前沿的工程师,还是被英文文献折磨的本科生,Zotero PDF2zh 都值得成为你文献库里的常驻插件。翻译自由,从右键开始。
【免费下载链接】zotero-pdf2zhPDF2zh for Zotero | Zotero PDF中文翻译插件项目地址: https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考