3条命令搞定 PDF 中英对照翻译BabelDOC 新手快速上手指南【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOCBabelDOC 是一个免费的开源 PDF 翻译工具主打 PDF 中英对照翻译输入一份英文 PDF它保留原排版结构把文字翻译成中文最终输出原文页 译文页并排的双语 PDF。装好它再备一个 API key3 条命令就能出结果。它到底做了什么BabelDOC 内部跑的是三步流水线先用自带的 PDF 解析器把页面拆成段落、公式区、表格区然后只把纯文本送去大模型翻译公式、上下标、图表原样保留最后用原文的字体、字号重新排版生成对照页面。对你来说这意味着三件事产出仍是 PDF能直接存档、打印、发给别人原文和译文并排呈现对照阅读不用来回翻翻译走 OpenAI 兼容接口gpt-4o-mini 这类便宜模型就能跑长文档成本可控。跑完之后你拿到什么一次完整运行结束后输出目录里会多出两类文件双语文档原页 译页左右并排适合逐段对照阅读、做精读笔记纯译文文档只有中文版本适合只想看结论、不想被原文干扰的场景。如果只需要其中一种后面会用--no-dual/--no-mono关掉另一种省一半生成时间。5 分钟跑通第一步下面用 uv 安装并直接翻译一份 PDF命令复制到终端即可执行。先用 uv 安装 BabelDOC首次运行会自动下载字体和版面分析模型uv tool install --python 3.12 BabelDOC再确认命令可用babeldoc --help能看到一长串参数列表就说明环境 OK。如果网络环境受限可以先跑babeldoc --warmup预下载资产。最后跑一条最小可执行的翻译命令路径建议用绝对路径babeldoc --files /path/to/paper.pdf \ --openai --openai-model gpt-4o-mini \ --openai-base-url https://api.openai.com/v1 \ --openai-api-key 你的key--openai-base-url换成任意 OpenAI 兼容接口都行官方、DeepSeek、本地 Ollama 都可以。跑的过程中进度条会实时打点结束后当前目录或--output指定目录里出现新的双语文档就算成功。需要跟最新源码的话可以 clone 仓库 后用uv run babeldoc --help代替第二条命令。常用参数速查完整列表用babeldoc --help查看日常高频的就这几个参数作用--pages 1,3,5-8只翻译指定页先试读前几页、控制费用--files a.pdf --files b.pdf一次批量处理多个 PDF--lang-in/--lang-out源/目标语言默认en→zh--no-dual/--no-mono只输出双语或只输出纯译文省生成时间--max-pages-per-part长文档按页拆分、分批翻译后自动合并--glossary-files terms.csv加载术语表统一专有名词译法--qps限制每秒请求数默认 4API 限额紧就调低--output指定输出目录默认当前目录术语表是个容易被忽略的实用功能CSV 文件三列source,target,tgt_lngtgt_lng可选示例见 docs/example/demo_glossary.csv。翻译时如果某段文本命中了表中的词条对应术语表会被强制塞进提示词专名译法就稳定了。排查指南现象扫描件翻出来文字互相叠盖。原因译文压在扫描底图上没垫底色。对策白底黑字文档加--ocr-workaround它会在译文下垫白色底块并强制黑字。现象输出 PDF 在某些阅读器里打不开或偏色。原因个别阅读器对 PDF 结构敏感。对策加--enhance-compatibility等价于--skip-clean --dual-translate-first --disable-rich-text-translate组合代价是文件体积变大。现象长文档中途失败想重跑。原因其实前面的翻译已经进了缓存直接重跑不会重复消耗 API。对策直接重跑即可确需强制重翻才用--ignore-cache别习惯性带上。现象本地模型如 Ollama报鉴权错误。原因没填 API key或 key 不符合接口要求。对策本地服务对 key 没要求--openai-api-key a随便填一个单字符就能过。现象作者区、参考文献被并成一大段。原因官方已知限制这类区域解析会出错另外也不支持横线分隔、首字下沉等排版。对策这是工具本身的已知问题不是你操作错了个别段落粘连不必纠结。现象想翻译成英文以外的语言对效果不稳定。原因项目主要打磨的是英文 → 中文其他方向未经充分测试。对策先用--pages抽几页小范围验证没问题再全量跑。再深入一步Python APIBabelDOC 提供接口供程序化调用适合嵌进 Zotero 工作流或批量文献处理脚本官方 API 视为内部接口随版本演进。离线环境没有外网的实验室可以用--generate-offline-assets在联网机器上打一个离线资产包再用--restore-offline-assets分发到目标机器。Web 界面想要浏览器 UI 或更多翻译服务可以看社区自部署项目 PDFMathTranslate-next。想看懂每一步的实现细节docs/ImplementationDetails/ 按解析、找段落、样式与公式、排版各写了专篇值得一读。下一步现在就可以动手用uv tool install装好 BabelDOC备好你的 API key挑一份英文 PDF 跑第一条命令。半小时后你就会拿到一份可以左右对照阅读的中英双语 PDF。【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考