如何用Zotero PDF2zh插件一键翻译英文文献？告别复制粘贴的终极指南 🚀

Zotero PDF2zh是一款专为学术研究者打造的Zotero插件，它能将PDF文献翻译功能与Zotero文献管理无缝结合，让你无需离开熟悉的文献库即可完成专业级PDF翻译。无论是英文论文、技术报告还是学术专著，都能通过简单配置实现中英双语对照阅读，极大提升文献处理效率。

📌 为什么选择Zotero PDF2zh？三大核心优势

1️⃣ 深度集成Zotero，无需切换工作流

作为原生Zotero插件，它完美融入文献管理流程。右键点击文献即可触发翻译，译文自动关联原文献存储，实现"管理-翻译-批注"一站式操作。

2️⃣ 多种翻译模式满足不同需求

支持三种输出格式：

• Mono模式：仅保留中文译文
• Dual模式：原文与译文逐段对照
• Compare模式：中英双栏并排对比 图：双栏对照模式让学术阅读更高效

3️⃣ 灵活部署方案适配所有用户

提供Docker一键部署和传统环境配置两种方案，新手也能5分钟上手。支持本地服务器和远程服务两种运行模式，满足不同场景需求。

📥 零基础安装指南：三种方案任选

Docker一键部署（推荐新手） ⚡

第1步：安装Docker环境

• Windows/Mac：下载Docker Desktop并安装
• Linux：执行命令curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh

验证安装：打开终端输入docker --version，显示版本号即成功。

第2步：获取项目文件

git clone https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh
cd zotero-pdf2zh/docker2

第3步：启动服务

docker compose up -d

后台静默运行模式，无需保持终端打开。

传统环境配置（适合开发者） 🔧

第1步：创建虚拟环境

# 使用conda
conda create -n pdf2zh python=3.12
conda activate pdf2zh

# 或使用uv
uv python install 3.12
uv venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate     # Windows

第2步：安装依赖包

# conda用户
pip install pdf2zh==1.9.6 flask pypdf pdfminer.six==20250416

# uv用户
uv pip install pdf2zh==1.9.6 flask pypdf pdfminer.six==20250416 numpy==2.2.0

第3步：启动服务器

cd server
python server.py

⚙️ 插件配置全攻略

安装Zotero插件

1. 下载最新版插件：[zotero-pdf-2-zh.xpi](https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh/blob/b0fb9332b8428ed5ad4895bbc24d9057db727664/2.4.3 version/zotero-pdf-2-zh.xpi?utm_source=gitcode_repo_files)
2. 打开Zotero → 工具 → 插件 → 齿轮图标 → 从文件安装插件
3. 重启Zotero完成安装

核心参数配置

打开Zotero插件设置页面（工具 → PDF2zh设置）： 图：插件设置界面关键参数配置区

参数项	默认值	推荐配置
翻译服务	bing	新手建议保持默认，高级用户可配置GPT等API
服务器地址	http://localhost:8890	Docker用户无需修改
输出模式	dual	学术阅读推荐双栏对照模式
字体配置	./config.json	需确保已安装霞鹜文楷字体

翻译引擎高级配置

在config.json中配置LLM API（位于server/config/目录）：

{
  "translators": {
    "openai": {
      "api_key": "your_api_key",
      "model": "gpt-4o"
    }
  },
  "font": "LXGWWenKai-Regular.ttf"
}

🚀 开始使用：三步完成文献翻译

1️⃣ 准备PDF文献

将需要翻译的英文PDF添加到Zotero库，建议先完成元数据识别（右键 → 检索元数据）。

2️⃣ 启动翻译服务

• Docker用户：服务已在后台运行
• 传统部署：执行python server.py启动服务器

3️⃣ 执行翻译操作

1. 在Zotero中右键点击目标PDF
2. 选择「PDF2zh翻译」→ 选择翻译模式
3. 等待翻译完成（大型PDF建议耐心等待） 图：Zotero右键菜单中的翻译选项

💡 专家技巧：提升翻译体验的5个方法

1. 字体优化确保公式显示

若翻译后公式或特殊符号显示异常，安装霞鹜文楷字体并在配置文件中指定：

"font": "/path/to/LXGWWenKai-Regular.ttf"

2. 节省LLM Token小技巧

在插件设置中设置「跳过最后几页」为3-5，自动忽略参考文献部分： 图：通过设置跳过页数节约翻译资源

3. 自定义快捷键

通过Zotero「编辑 → 快捷键」为翻译功能设置专属热键，推荐设置Ctrl+Shift+T（Windows）或Cmd+Shift+T（Mac）。

4. 批量翻译处理

使用Zotero的批量选择功能（按住Ctrl键多选），右键菜单选择「批量翻译」，适合处理多篇文献。

5. 翻译质量优化

专业领域文献建议：

• 在配置文件中增加专业术语词典
• 使用GPT-4等高级模型提升专业词汇翻译准确性
• 启用「保留原文格式」选项确保图表编号正确

🛠️ 常见问题解决

Q: 翻译后PDF中文显示乱码？

A: 检查是否安装推荐字体，Docker用户需将字体文件挂载到容器内：

volumes:
  - ./fonts:/app/fonts

Q: 服务器启动失败提示端口占用？

A: 修改配置文件中的端口号：

"server": {
  "port": 8891
}

同时在Zotero插件设置中更新服务器地址。

Q: 如何切换不同翻译引擎？

A: 在插件设置的「翻译服务」下拉菜单选择，或直接输入自定义引擎名称（需提前在config.json中配置）。

📚 进阶探索

开发模式体验新功能

通过开发模式获取最新特性：

cd docker2
docker compose -f docker-compose.dev.yaml up

本地server/目录修改会实时生效，适合二次开发。

自动化翻译工作流

配置系统定时任务监控文献库，新添加PDF自动触发翻译：

• Windows：使用任务计划程序导入[automation/win/monitor/register_task.ps1](https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh/blob/b0fb9332b8428ed5ad4895bbc24d9057db727664/2.4.3 version/automation/win/monitor/register_task.ps1?utm_source=gitcode_repo_files)
• Mac/Linux：配置launchd或systemd服务

🎯 总结

Zotero PDF2zh插件通过将专业PDF翻译与文献管理深度整合，彻底解决了学术研究中的语言障碍。无论是初入学术领域的研究生，还是需要大量阅读外文文献的科研人员，都能通过这款工具将文献处理效率提升300%。

立即尝试这款开源工具，让英文文献阅读不再成为科研路上的绊脚石！需要完整配置文档可查阅项目docs/目录下的详细指南。