当前位置：首页 > news >正文

在Zotero中配置PDF2zh插件并使用详细教程

news 2025/10/2 12:43:28

一、Python的下载和安装

下载地址：https://www.python.org/downloads/

1.1. （Python版本要求3.10 <= version <=3.12）

这里我选择的是3.12.0，点击下载:https://share.feijipan.com/s/f2XFPq1X

1.2. 安装python

将下载好的exe，右键选择 “以为管理员身份运行” 安装，
注意：下面两个都要勾选上

自行修改路径

等待安装完成

1.3. 检查是否安装完成

Win + R在打开的面板里面输入cmd回车

输入python -V查看python版本号

输入pip -V查看pip版本号(pip是一个包管理工具，后面安装依赖需要这个指令，安装python后就有pip指令了)

二、Python部署

2.1. pip下载安装uv

pip install uvuv --version

2.2. 下载并解压项目文件

# 1. 创建并进入zotero-pdf2zh文件夹
mkdir zotero-pdf2zh && cd zotero-pdf2zh

# 2. 下载并解压server文件夹
# 如果server.zip下载失败, 可以直接访问: https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/main/server.zip 手动下载
curl -L -o server.zip https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/main/server.zip
REM 解压（任选一种；如命令行解压失败，可在资源管理器中右键解压到当前目录）
powershell -Command "Expand-Archive -Path '.\server.zip' -DestinationPath '.' -Force"# 3. 进入server文件夹
cd server

D盘下面有如下内容

三、安装依赖并启动服务

3.1.安装依赖

先做这两件事（降低失败率）
1）确认命令行能访问 Python/uv/conda 之一（python -V / uv --version / conda -V）。
2）若在国内网络，先测试镜像可达性（应返回 pip 的版本清单）：

pip index versions pip -i https://mirrors.ustc.edu.cn/pypi/simple

进入 server 目录后安装依赖：

pip install -r requirements.txt
# 若网络受限，可临时使用镜像（示例为中科大源）：
# pip install -r requirements.txt -i https://mirrors.ustc.edu.cn/pypi/simple

3.2.直接启动

启动服务（默认启用虚拟环境与端口 8890，可按需调整）：

四、设置一键启动脚本

以上方法每次需要终端运行命令启动比较麻烦，可以设置一个一键启动的文件。

4.1.获取 `server.py` 的目录路径

（1）先把终端/命令行打开到 server.py 所在的文件夹

（2）复制下面这一行回车执行（这行用的是 Python 自带的 pathlib 库，不需要 pip 安装）：

python -c "import pathlib; print(pathlib.Path('server.py').resolve().parent)"

4.2.选你的模板并复制

@echo off
chcp 65001 >nul
set PYTHONUTF8=1
rem ← 只需要修改下面这一行
set "PROJECT_PATH=这里替换成你的路径"
python "%PROJECT_PATH%\server.py"
pause

4.3.让 AI 帮你生成脚本

发送给AI的完整示例：

你好，请你根据我提供的路径和这个模板，生成一个可以直接供我使用的自动化脚本，并告诉我怎么用。
我的路径是：D:\zotero-pdf2zh\server
我的模板是：
@echo off
chcp 65001 >nul
set PYTHONUTF8=1
rem ← 只需要修改下面这一行
set "PROJECT_PATH=这里替换成你的路径"
python "%PROJECT_PATH%\server.py"
pause

在桌面新建个txt文件，把上面的内容粘贴进去保存

重命名后点是

双击运行

五、Zotero导入PDF2zh插件

5.1. 下载插件：https://share.feijipan.com/s/gpXF6uyT

5.2. 将下载好的插件导入Zotero

打开zotero，点击工具 -> 插件，右上角 Install Plugin From File…,选择刚刚下载的插件

5.3. 插件配置

打开zotero，点击编辑 -> 设置，配置如下

六、使用Zotero开始翻译

翻译PDF (Translate PDF)：对选中的原文 PDF 生成译文版本（单语/双语取决于插件设置）。
裁剪PDF (Crop PDF)：适用于双语或单语附件。自动裁剪两侧空白，并按页面宽度一分为二后上下拼接，便于小屏阅读。若过裁剪，可在 server/utils/config.py 调整 config.pdf_w_offset。
双语对照 (Compare PDF)：生成“左原右译”的双语 PDF。可在设置中选“Dual 文件翻译页在前”调整顺序。
双语对照（裁剪）(Crop-Compare PDF)：专为双栏论文设计；先沿中缝垂直裁成单栏，再进行左右拼接