如何用 pdf2zh -i 启动 PDFMathTranslate 图形界面并在浏览器完成一次翻译【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate如果你不想每次都在命令行里敲完一长串参数PDFMathTranslate 提供了一个基于 Gradio 的图形界面执行pdf2zh -i后在浏览器里上传 PDF、选择翻译服务与语言、点击Translate即可得到保留版式的译文 PDF 和中英双语 PDF。这篇文章覆盖从安装到拿到译文文件的完整过程。前提条件文档明确要求已安装 Python版本在 3.11 到 3.12 之间3.11 version 3.12通过 pip 安装了pdf2zh包。安装 pdf2zh在命令行执行pip install pdf2zh也可以用 uv 安装文档给出的可选方式可指定 Python 3.12pip install uv uv tool install --python 3.12 pdf2zh安装完成后pdf2zh命令即可在终端中使用。首次翻译时会加载布局检测模型wybxc/DocLayout-YOLO-DocStructBench-onnxREADME 提示部分地区的用户可能因网络问题无法下载该模型可先设置镜像环境变量再启动set HF_ENDPOINThttps://hf-mirror.comPowerShell 下为$env:HF_ENDPOINT https://hf-mirror.com启动图形界面在终端执行pdf2zh -i-i是--interactive的缩写见 pdf2zh/pdf2zh.py表示以图形界面方式运行。程序启动后会尝试自动打开浏览器如果没有自动打开手动访问http://localhost:7860/7860 是文档中给出的默认端口。两个常用的可选参数来自 README.md 的选项表pdf2zh -i --serverport 8000 # 使用自定义 WebUI 端口 pdf2zh -i --share # 生成公开链接在浏览器中完成一次翻译打开页面后按以下顺序操作界面说明见 docs/README_GUI.md选择 Service翻译服务。下拉框默认第一项是 Google按 docs/ADVANCED.md 的服务表Google 与 Bing 不需要环境变量即可使用。切换到其他服务如 Ollama、OpenAI、DeepL时界面会自动显示该服务对应的环境变量输入框例如 Ollama 的OLLAMA_HOST默认http://127.0.0.1:11434与OLLAMA_MODEL默认gemma2需要先在界面或系统环境中配好才能用。设置语言。Translate from与Translate to两个下拉框决定源语言和目标语言默认是 English → Simplified Chinese。支持的语言为English、Simplified Chinese、Traditional Chinese、French、German、Japanese、Korean、Russian、Spanish、Italian。选择页码范围。Pages选项提供All、First、First 5 pages、Others自定义页码如1-3,5几档见 pdf2zh/gui.py。上传 PDF。把 PDF 文件拖入窗口的文件区界面同时接受.doc、.docx会先转换为 PDF右侧Preview区域会显示文档预览。点击Translate。进度条会依次显示Starting translation...、Translating...完成后显示Translation complete!。中途点Cancel可以中止界面报错Translation cancelled。翻译完成后界面下方出现Translated区域提供两个下载项Download Translation (Mono)纯译文版保存为原文件名-mono.pdfDownload Translation (Dual)双语版保存为原文件名-dual.pdf。两个文件都写入工作目录下的pdf2zh_files/目录见 pdf2zh/gui.py。如果转换结束后界面提示No output说明 mono/dual 文件没有生成翻译实际未成功。界面中Open for More Experimental Options!折叠区里还有一组实验性选项线程数number of threads默认 4、Skip font subsetting跳过字体子集化用于解决兼容性问题但会增大输出文件、Ignore cache忽略翻译缓存强制重新翻译、自定义公式字体正则vfont、Custom Prompt for llm仅对 LLM 类服务显示、以及Translation Modefast或precise其中precise为实验性 v2 内核。这些不展开默认值即可跑通主流程。修改默认语言与翻译服务不想每次在界面里改语言可以在启动前设置环境变量docs/README_GUI.mdexport PDF2ZH_LANG_FROMEnglish # 源语言默认 English export PDF2ZH_LANG_TOSimplified Chinese # 目标语言默认 Simplified ChineseWindows 下用set PDF2ZH_LANG_TOJapanese这类写法即可。也可以改用配置文件pdf2zh -i --config config.json。不指定时程序默认读取~/.config/PDFMathTranslate/config.json启动时先读配置文件再读环境变量同名项以环境变量为准并回写文件docs/ADVANCED.md。配置文件中还可以用ENABLED_SERVICES限制界面中可选的服务列表、用HIDDEN_GRADIO_DETAILS隐藏页面上的真实 API Key避免他人从 Web 端拿到服务器侧的密钥。验证结果与常见卡点界面能否访问终端显示启动成功后浏览器访问http://localhost:7860/能看到标题为 “PDFMathTranslate - PDF Translation with preserved formats” 的页面未自动打开浏览器时手动访问该地址即可。翻译是否成功进度条走到Translation complete!且Translated区域出现 Mono 与 Dual 两个下载项下载后打开确认公式、图表等版式是否保留。No output报错mono/dual 文件缺失时 gui.py 会抛出该错误属于翻译过程失败需要检查所选服务的 API 是否配置正确。首次启动卡在模型下载即前面提到的区域网络问题设置HF_ENDPOINT镜像后重试。端口绑定失败pdf2zh/gui.py 会依次尝试不同地址绑定全部失败时提示 “This may be caused by global mode of proxy software”并回退到 Gradio 的 share 链接方式此时以终端输出的实际访问地址为准。完成一次翻译后译文与双语文档已落在pdf2zh_files/目录中可以直接取用更多命令行参数部分页翻译、异常字体保留等见 docs/ADVANCED.md。【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考