配置说明
本文档详细介绍 Zotero PDF2zh 插件的配置选项。
插件设置
在 Zotero 中打开「工具 → PDF2zh 首选项」进行配置。
基础配置
Python Server IP
设置 Python 服务的地址。
- 默认值：
http://127.0.0.1:8890 - 说明：如果您修改了服务端口或使用远程部署，需要修改此地址
翻译引擎
选择使用的翻译引擎。
- pdf2zh：基于 PDFMathTranslate 的翻译引擎
- pdf2zh_next：新一代翻译引擎，支持更多功能
切换引擎后，界面将显示对应引擎的配置选项。
QPS 和 Pool Size 配置
请参考您的翻译服务提供商的限制设置。
计算公式
qps = rpm / 60Pool Size 设置规则
| 限制类型 | 计算公式 |
|---|---|
| qps/rpm 限速 | pool size = qps * 10 |
| 并发数限制 | pool size = max(向下取整(0.9*官方并发数限制), 官方并发数限制-20)，qps = pool size |
不确定如何设置？
如果您不知道怎么设置，请直接设置 qps 即可，pool size 设置为默认值 0。
示例
以智谱 AI 为例：
- 查看官方文档：智谱 AI 速率限制
- 假设 RPM = 60，则
qps = 60 / 60 = 1 pool size = 1 * 10 = 10
翻译服务配置
单击「LLM API 配置管理」中的「新增」按钮，配置翻译服务。
配置说明
- 您可以为同一个服务添加多种配置
- 每次只能激活一种配置，翻译时使用激活的配置
- 配置后需要在「翻译服务」处选择要使用的服务
字段说明
| 字段 | 说明 |
|---|---|
| 服务名称 | 自定义配置名称 |
| 服务类型 | 选择翻译服务提供商 |
| URL | API 端点地址（某些服务不需要） |
| API Key | API 密钥 |
| 模型 | 使用的模型名称 |
| 额外配置 | 其他可选参数 |
翻译服务介绍
免费 & 免配置服务
| 服务名称 | 服务介绍 | 注意事项 |
|---|---|---|
| siliconflowfree | 基于硅基流动提供的 GLM4-9B 模型，由硅基流动、pdf2zh_next 和 BabelDOC 联合提供服务 | 1. 仅支持 pdf2zh_next引擎 2. 无需选择 qps，默认为 40 3. 可能存在漏翻译情况 |
| bing/google | bing/google 的官方机器翻译 | 存在限流，翻译失败请将并发数调至 2 及以下 |
具有优惠/赠送的服务
| 服务名称 | 服务介绍 | 注意事项 |
|---|---|---|
| openaliked | 火山引擎协作计划，个人用户每天最多赠送 50w token | 1. 额度按前一天使用量等额计算 2. 支持高并发：500~1000 3. URL： https://ark.cn-beijing.volces.com/api/v3 |
| silicon | 通过邀请好友获得 14 元赠送金额 | 1. URL：https://api.siliconflow.cn/v12. 免费版线程数较低，建议设置为 6 左右 |
| zhipu | 智谱部分模型可支持免费调用 | 免费服务并发数不要设置过高，建议 6 以内 |
高质量服务
| 服务名称 | 服务介绍 | 推荐设置 |
|---|---|---|
| aliyunDashScope | 翻译效果较好，新用户有赠送额度 | 选择 LLM API 配置中的默认模型选项 |
| deepseek | 翻译效果好，有缓存命中机制（推荐） | 使用 deepseek v3 服务 |
OpenAI 兼容服务
openailiked 服务选项可以填写所有兼容 OpenAI 格式的 LLM 服务。
您需要填写：
- URL：LLM 服务供应商提供的 API 地址
- API Key：您的 API 密钥
- Model：模型名称
示例
火山引擎 URL 填写为：https://ark.cn-beijing.volces.com/api/v3
pdf2zh 引擎配置
自定义字体
字体文件路径为本地路径。
远程部署限制
如果采用远端服务器部署，暂时无法使用本配置，需要手动修改 config.json 文件中的 NOTO_FONT_PATH 字段。
pdf2zh_next 引擎配置
双语(Dual)文件显示模式
- Left&Right：左右对照模式
- Up&Down：上下对照模式
提取术语表
开启后会提取文档中的术语表，但会消耗更多 Token。
OCR 临时方案
- pdf2zh 和 pdf2zh_next 不直接提供文档 OCR 功能
- 您需要用其他工具对扫描版文件进行 OCR 处理
- 此选项只是一个对于 OCR 后文件的兼容方案
兼容模式
兼容模式生成的文件大小会更大，非必要情况不需要开启。
额外配置参数
额外配置参数名需要与配置文件中的字段相同。
例如在 pdf2zh_next 中，openai 对应的额外配置：
openai_temperatureopenai_send_temperature
这些与 config.toml 文件中的字段相对应。
详细文档
更多关于额外配置的信息，请参考 额外参数说明。
命令行参数
启动 server.py 时可用的参数：
| 参数 | 默认值 | 说明 |
|---|---|---|
--enable_venv | True | 开启虚拟环境管理 |
--env_tool | uv | 虚拟环境管理工具（uv/conda） |
--port | 8890 | 服务端口号 |
--check_update | True | 自动检查更新 |
--update_source | gitee | 更新源（github/gitee） |
--enable_mirror | True | 启用国内镜像 |
--mirror_source | 中科大镜像 | 镜像源地址 |
--enable_winexe | False | Windows exe 安装模式 |
--winexe_path | - | Windows exe 可执行文件路径 |
使用示例
shell
# 切换端口
python server.py --port=9999
# 关闭虚拟环境管理
python server.py --enable_venv=False
# 使用 conda 虚拟环境
python server.py --env_tool=conda
# 自定义镜像源
python server.py --mirror_source="https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"