Zotero PDF2zh

Zotero PDF2zh是什么？

Zotero PDF2zh是一款面向Zotero文献管理器的开源PDF自动翻译插件，支持将外文 PDF 文献直接在 Zotero 内一键翻译成中文，并可生成双语对照版，极大提升科研人员、学生和行业分析师阅读外文资料的效率。该插件支持多引擎、批量处理、跨平台部署，并提供 Docker、本地终端等多种运行方式。

核心亮点

• 一键翻译：右键文献直接调用翻译，支持 mono（仅目标语言）与 dual（双语对照）两种文件生成
• 多翻译引擎：内置 Bing、Google，可接入 DeepSeek、智谱 AI、火山引擎等 LLM 模型
• 批量处理：支持多篇文献同时翻译，提升处理效率
• 格式优化：可双栏裁剪、自定义中文字体（如霞鹜文楷）保证可读性
• 自动化守护（macOS）：Zotero 打开即启动翻译服务，关闭自动结束，并在异常时 10 秒内重启
• 跨平台支持：Windows、macOS、Linux 全覆盖，支持 Docker 与本地终端启动
• 安全本地化：翻译过程在本地运行，支持自定义 API Key 与字体文件

适用场景

• 科研人员 / 研究生：快速翻译外文论文并生成双语参考版
• 行业分析师：处理海外市场报告、专利与技术文档
• 学生 / 教师：辅助理解外文教材和学术资料
• 知识管理者：批量构建本地化双语文献库

Zotero PDF2zh官网及使用教程

开源地址：https://github.com/guaguastandup/zotero-pdf2zh

一、安装与启动 

方法一：Docker 部署（推荐，稳定省事）

# 1. 创建文件夹
mkdir docker && cd docker

# 2. 下载官方 Dockerfile 与 docker-compose.yaml
wget https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/refs/heads/main/Dockerfile
wget https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/refs/heads/main/docker-compose.yaml

# 3. 创建插件目录及配置文件
mkdir zotero-pdf2zh && cd zotero-pdf2zh
mkdir translated
echo ‘{}’ > config.json
cd ..

# 4. 构建镜像
docker compose build

# 5. 启动服务
docker compose up # 前台运行（调试）
docker compose up -d # 后台运行

方法二：本地终端运行（适合有 Python 环境的用户）

# 1. 创建插件文件夹
mkdir zotero-pdf2zh && cd zotero-pdf2zh

# 2. 下载核心文件
wget https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/refs/heads/main/server.py
mkdir translated
echo ‘{}’ > config.json

# 3. 创建 Python 虚拟环境并安装依赖
conda create -n zotero-pdf2zh python=3.12
conda activate zotero-pdf2zh
pip install pdf2zh==1.9.6 flask pypdf
pip install pdfminer.six==20250416 numpy==2.2.0

# 4. 测试翻译命令（使用 Bing 免费服务）
pdf2zh document.pdf –service bing

# 5. 启动服务（8888 为端口号，可改）
python server.py 8888

二、配置config.json 

{
“PDF2ZH_LANG_FROM”: “English”,
“PDF2ZH_LANG_TO”: “Simplified Chinese”,
“NOTO_FONT_PATH”: “./LXGWWenKai-Regular.ttf”,
“translators”: [
{
“name”: “deepseek”,
“envs”: {
“DEEPSEEK_API_KEY”: “sk-xxxx”,
“DEEPSEEK_MODEL”: “deepseek-chat”
}
}
]
}

配置说明

• PDF2ZH_LANG_FROM / TO：源语言和目标语言
• NOTO_FONT_PATH：中文字体路径（推荐霞鹜文楷）
• translators：翻译引擎与 API Key（可接入 DeepSeek、智谱 AI、火山引擎等） 

三、Zotero插件设置 

1. 打开 Zotero → PDF2zh 设置

2. 填写：

• Python 服务器 IP：http://localhost:8888（端口与启动时一致）
• 源/目标语言
• 翻译服务（与 config.json 中一致）
• 线程数（建议 4–20，根据 API 限流调整）
• 生成文件类型（mono 单语 / dual 双语）

3. 可选：重命名规则、跳过最后几页、输出路径等

四、翻译 PDF 文件

支持四种处理方式

• 翻译 PDF：生成 mono（单语）+ dual（双语）
• 裁剪 PDF：双栏切单栏，方便手机阅读
• 双语对照（双栏）：左右对照版（需已有 dual 文件）
• 双语对照（单栏）：单栏左右对照（无需裁剪）

批量翻译：可一次选中多篇文献右键翻译