guaguastandup/zotero-pdf2zh

Zotero PDF2zh – Zotero 内置 AI PDF 翻译工具

简介

• 一款 Zotero 插件（外加一个轻量级 Python 服务器），让您可以直接从 Zotero 资料库翻译 PDF 论文。
• 它使用开源的 PDFMathTranslate / PDFMathTranslate-next 引擎，调用 LLM API（OpenAI、DeepSeek、SiliconFlow 等）进行中文翻译，同时保留公式、排版以及选用的双语对照视图。

主要功能

功能	说明
两种翻译后端	pdf2zh（较旧、速度快、自定义字体）与 pdf2zh_next（积极维护、支持表格/OCR、术语提取）。
双语 PDF 输出	产生新的 PDF，将原文与译文以左右或上下方式呈现。
裁切对比模式	针对双栏论文，可将页面裁切并拼接，方便在手机上阅读。
批量翻译	在 Zotero 中选中多个项目并一次完成翻译。
进度 UI	网页仪表板 (http://127.0.0.1:8890) 显示任务状态、历史记录并可下载结果。
LLM 服务管理	插件内置 UI 可新增多种供应商的 API 密钥/网址（兼容 OpenAI、DeepSeek-V4、SiliconFlow-free、Bing/Google、智谱、阿里云 DashScope 等）并设定速率限制 (qps, poolsize)。
Docker / Homebrew / Windows-exe	Python 服务器提供多种部署方式，包含预先编译的 Windows 可执行文件与现成的 Docker 镜像。
自动更新	插件会检查新版本；服务器可从 GitHub 或 Gitee 拉取更新，甚至更新自身的 Python 套件。

运作方式

1. 安装插件 (.xpi) 到 Zotero（支持版本 7-10）。
2. 运行配套服务器 – 一个小型 Python 脚本 (server.py)，负责加载翻译引擎并与您配置的 LLM API 通讯。翻译期间服务器需保持运行。
3. 配置 LLM – 在插件的“LLM API 配置”面板中输入网址、API 密钥、模型名称及选用的 *_enable_json_mode。
4. 右键点击 PDF（或 Zotero 项目）→ 选择四种动作之一：
   • Translate PDF – 创建翻译后的 PDF。
   • Crop PDF – 将宽版论文裁切以便手机阅读。
   • Compare PDF – 双语对照视图。
   • Crop-compare PDF – 裁切后对比（适用于双栏论文）。
5. 查看进度 – 通过 Zotero 状态栏或网页仪表板；完成后新的 PDF 会出现在您的资料库中。

安装快速入门

• 安装 Python 3.12 与 Zotero。
• 安装虚拟环境管理器（推荐 uv 或 Conda）。
• 下载 server.zip 发布版本，解压缩至 zotero-pdf2zh/server。
• 启动服务器，例如 uv run --python 3.12 --with-requirements requirements.txt server.py（或使用 Conda 对应指令）。
• 通过 Zotero → 工具 → 附加组件安装 .xpi 插件。
• 开启插件偏好设置，测试“检查连接”按钮，加入您的 LLM API，即可开始翻译。

适用对象

• 需要在 Zotero 中管理论文并进行中文翻译的研究人员与学生。
• 希望保留原始 PDF 排版（公式、表格）同时获得可读双语版本的使用者。

限制与注意事项

• 服务器必须保持运行；关闭终端机会停止翻译。
• 免费服务（如 SiliconFlow-free）可能会遗漏部分段落；若需更高质量，请使用付费 LLM 密钥。
• Windows 用户应避免将项目放置于系统磁盘，且可能需要以管理员身份运行终端机。
• 本项目正在进行重大重构（截至 2026 年 8 月）；目前版本稳定，但在新版本发布前暂停贡献。

---

总结：Zotero PDF2zh 是一款实用的开源 Zotero 插件，搭配轻量级 Python 服务器，利用 LLM API 将 PDF 翻译为中文，保留格式并提供双语 PDF、批量处理与网页进度监控。支持多种部署方式与多样化的 LLM 供应商，让 Zotero 内的 AI 辅助学术阅读变得切实可行。