BabelDOC 快速实战PDF 翻译与版式保留【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOCBabelDOC 是一个命令行 PDF 翻译工具它解析原 PDF 的段落、字体和公式结构把文本交给大模型 API 翻译再把译文重新排进原始版式输出翻译后的 PDF。适合需要保留版式的 PDF 翻译场景论文、技术文档、标准规范。译文文字可选、可检索公式和图片位置与原文一致。跑起来只需要 Python 3.10–3.13 和一个任意 OpenAI 兼容服务的 API 密钥。最短命令如下babeldoc --openai --openai-api-key sk-xxx \ --openai-model gpt-4o-mini \ --files doc.pdf --output ./out默认输出带水印的双语 PDF 到./out目录。本文命令基于 0.6.x 版本按「装好 → 翻一份 → 批量 → 调输出 → 排错」的顺序展开。安装 BabelDOC两条命令跑起来推荐用 uv 安装一条命令完成Python 版本自动固定uv tool install --python 3.12 BabelDOC babeldoc --version没有 uv 就先安装它并加入 PATH。第二条命令能打印版本号说明安装成功。如果准备改源码用源码方式git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC cd BabelDOC uv run babeldoc --version会多一个虚拟环境依赖同样自动解析。接入翻译 API完成第一次 PDF 翻译任何 OpenAI 兼容服务都能接只需换模型、地址、密钥三个参数服务模型示例API 基础地址OpenAIgpt-4o-minihttps://api.openai.com/v1智谱 AIglm-4-flashhttps://open.bigmodel.cn/api/paas/v4DeepSeekdeepseek-chathttps://api.deepseek.com/v1babeldoc --openai \ --openai-model gpt-4o-mini \ --openai-base-url https://api.openai.com/v1 \ --openai-api-key $OPENAI_API_KEY \ --files doc.pdf --output ./out密钥用环境变量传避免留在 shell 历史里。--openai启用 OpenAI 兼容服务模型与地址按上表替换。源语言--lang-in默认en目标语言--lang-out默认zh其余语言代码见支持语言列表。BabelDOC 批量翻译配置多文件与页码选择多个文件就是重复--files页码用逗号和区间表达式babeldoc --openai --openai-api-key $OPENAI_API_KEY \ --files a.pdf --files b.pdf \ --pages 1,3,5-10 \ --output ./batch不传--pages时翻译全部页面表达式还支持1-、-3这类写法。API 限流用--qps控制默认 4服务限频时调低。调整翻译输出双单语、水印与分块输出形态由三组参数控制双/单语、水印、分块babeldoc --openai --openai-api-key $OPENAI_API_KEY \ --files doc.pdf --output ./out \ --no-dual \ --watermark-output-mode no_watermark \ --max-pages-per-part 50--no-dual只输出单语译文--no-mono则相反默认两者都出。水印有watermarked默认、no_watermark、both三种模式。大文档用--max-pages-per-part切分处理单元控制内存--pool-max-workers按 CPU 核心数调线程。首次运行需要下载模型与字体资产。离线环境先在联网机器生成资产包babeldoc --generate-offline-assets ./assets babeldoc --restore-offline-assets ./assets/offline_assets.zip目标机器用restore直接恢复资产包也可以先跑--warmup只下载并校验资产。锁定术语一致性术语表与自定义提示术语表是三列 CSV源词、译词、目标语言代码source,target,tgt_lng GPU,图形处理器,zh-CN Machine Learning,机器学习,zh-CNbabeldoc --openai --openai-api-key $OPENAI_API_KEY \ --glossary-files glossary.csv \ --files doc.pdf --output ./out表内术语会被固定翻译避免长文档中自动提取漂移。项目自带示例术语表另可用--custom-system-prompt约束翻译风格。BabelDOC 常见问题处理多数问题出在四件事网络、内存、版式、扫描件。现象处理办法首次下载超时、拉不到模型联网机器--generate-offline-assets生成资产包目标机--restore-offline-assets恢复大文档内存溢出--max-pages-per-part 50分块处理排版错乱、文字重叠--enhance-compatibility启用全部兼容选项扫描件无文本层--ocr-workaround实验性或先 OCR 再翻译其他参数以babeldoc --help和官方文档为准。接下来可以做用--pages试翻几页确认字体与公式排版后再跑全量查支持语言列表确认目标语言是否完整支持API 限频时先降--qps再视情况调高--pool-max-workers【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考