BabelDOC
funstory-ai/BabelDOC加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
BabelDOC 翻译效果对比:左为原文,右为译文,段落结构完整保留
想象一下这个场景:深夜,你下载了一篇 50 页的 arXiv 论文,准备阅读。然而论文是西班牙语写的,Google 翻译出来的 PDF——段落被打散、公式被截断、图表位置全乱——完全无法使用。
这是所有科研人员共同的痛:传统 PDF 翻译工具几乎无法保留原始排版,尤其是学术论文中的复杂数学公式、多栏布局、表格和图表。
BabelDOC 正是为解决这个痛点而生。它由 funstory-ai 团队 开发(该团队同时运营着拥有 200 万用户的 Immersive Translate 浏览器插件),专注于无损排版的 PDF 学术论文翻译。
BabelDOC 的核心技术是其 文档布局感知(Document Layout Analysis) 能力,通过一个中间表示层(Intermediate Representation, IR) 架构实现:
这种设计让它在 ACL 2026 的 Demo 论文中被专门介绍,论文标题为《BabelDOC: Better Layout-Preserving PDF Translation via Intermediate Representation》,由字节跳动 FUNStory 团队发表。
| 功能 | 说明 |
|---|---|
| 双语对照 | 支持原文/译文双栏对照,也可交替排列或合并为单语 PDF |
| 多语言支持 | 英→中为主,同时支持中→英及其他语言(社区正在扩展) |
| 公式零损失 | 完美保留 LaTeX 公式、数学符号,公式文本自动保护不翻译 |
| 表格/图表保护 | 自动识别并保护表格和图表区域不受翻译干扰 |
| 扫描 PDF 支持 | 支持 OCR 处理扫描版 PDF |
| 术语表 | 支持 CSV 格式术语表,保证专业名词翻译一致性 |
| 批量处理 | 支持多文件批量翻译 |
| 离线资产包 | 支持生成离线安装包,用于无网环境或内网部署 |
| API 编程接口 | 提供 Python API,可集成到其他应用中 |
普通用户:直接访问 Immersive Translate BabelDOC 在线服务,每月 1000 页免费额度,零配置即用。
开发者/高级用户:通过命令行安装:
# 推荐使用 uv 安装
uv tool install --python 3.12 BabelDOC
# 基础用法(需 OpenAI API Key)
babeldoc --openai \
--openai-model "gpt-4o-mini" \
--openai-base-url "https://api.openai.com/v1" \
--openai-api-key "your-key" \
--files paper.pdf
# 使用本地 Ollama 模型
babeldoc --openai \
--openai-model "qwen2.5:7b" \
--openai-base-url "http://localhost:11434/v1" \
--openai-api-key "a" \
--files paper.pdf
# 使用配置文件
babeldoc --config config.toml
配置文件采用 TOML 格式,支持 QPS 限流、分页拆分、水印控制等大量高级选项。
babeldoc/
├── docvision/ # 核心:文档布局分析引擎
│ ├── doclayout.py # 主布局分析逻辑
│ ├── base_doclayout.py
│ └── rpc_doclayout*.py # 多种 RPC 布局服务实现
├── translator/ # 翻译层
│ ├── translator.py # OpenAI 兼容接口调用
│ └── cache.py # 翻译结果缓存
├── pdfminer/ # PDF 解析
├── format/ # 格式处理
├── utils/ # 工具函数
│ ├── priority_thread_pool_executor.py # 优先级线程池
│ └── memory.py # 内存管理
├── tools/ # 辅助工具(字体/斜体识别)
└── main.py # CLI 入口
核心技术栈:Python 3.10+ + pymupdf(PDF 解析)+ OpenAI SDK(LLM 调用)+ scikit-image(图像处理)+ ONNX Runtime(本地模型推理)。
代码质量方面,项目使用 ruff + flake8 代码规范,提交前需过 pre-commit 检查。
BabelDOC 体现了 AI 文档翻译领域的几个重要趋势:
GitHub Stars 已突破 9600,并在 ACL 2026 发表 Demo 论文,是当前学术 PDF 翻译领域最有影响力的开源项目之一。
uv tool install 安装,配合配置文件管理 API Keydocker-compose 部署(需自行配置),或生成离线资产包在隔离环境使用数据来源:GitHub (funstory-ai/BabelDOC, 9,600★)、ACL Anthology (2026.acl-demo.25)、arXiv (2605.10845)