Windows 安装
适用于 Windows 10/11 x64。首次安装需要联网下载 Python 和翻译依赖。
安装并启动
- 下载 Windows 安装器,双击打开。
- 选择安装位置,点击 开始安装。默认位置为
%LOCALAPPDATA%\zotero-pdf2zh-pro。 - 完成后点击 完成并启动服务。

看到 翻译服务已就绪,继续安装 Zotero 插件。

日常使用
- 关闭窗口或退出控制中心,已运行的服务仍会继续;需要停止时点击 停止服务。
- 登录自启默认开启,可在 常规设置中关闭。
- 翻译时保持服务运行;安装或更新前先等待当前任务结束。
安装失败或打不开
查看处理方法
| 问题 | 处理 |
|---|---|
| 下载失败 | 检查网络,在控制中心查看“日志与诊断”后重试 |
| 8890 端口被占用 | 检查是否已运行另一份服务,避免重复启动 |
| 旧版提示缺少 DLL | 重新下载上方 EXE 安装器,直接修复或升级,无需先卸载 |
| SmartScreen 提示风险 | 当前 EXE 未签名;核对来源和 Release 中的 SHA-256 |
旧版升级与手动恢复
同版本安装可修复,高版本可升级,不能降级;配置、数据和自启选择会保留。 从 v1.8.2 或更早版本升级时,先等翻译结束,再从旧控制中心停止服务,然后运行新安装器。
界面仍无法打开时,查看 Windows 恢复说明,使用安装目录 bin 下的 install.cmd、start-server.cmd 或 view-log.cmd。