bilingual_book_maker:把电子书译成双语对照版
用大语言模型把 epub、txt、srt、PDF 译成双语对照版的命令行工具,多家模型可选,会话模式保译名一致。
项目资料
GitHub Ecosystem- 许可证
- MIT
- 主语言
- Python
- 星标
- 9,843
- 核查时间
- 2026-10-06
以上快照资料以核查当日为准,可能随版本或运营策略变化。
整本书翻译费时,逐段丢给聊天机器人又难统一译名。开源命令行工具 bilingual_book_maker 调用 ChatGPT、Claude 等大语言模型,把 epub、txt、srt、pdf 等文件做成双语对照版,能直接导入阅读器。GitHubDaily 在 2025 年 2 月推荐过它,截至 2026-10-06 仓库有 9,843 星,最近一次推送在 9 月 30 日。
核心功能
- 多格式输入:覆盖 epub、txt、md、srt、pdf,输出
_bilingual双语文件。 - PDF 转双语 EPUB:
--to-epub把 PDF 转成带目录、可重排的双语 EPUB,每段原文下接译文,图片和公式保留为图片,需要额外装 PDF 依赖和 Pandoc 3.1.12 以上;没有文字层的扫描件可加--pdf-ocr走 OCR。 - 多模型接入:兼容 OpenAI 和 Anthropic 接口格式,支持 Gemini、Qwen-MT、Groq、xAI、OrcaRouter、Ollama、LiteLLM 等,也能用 Codex 订阅额度,或用 JSON 配置自定义任意 OpenAI/Anthropic 兼容服务商。
- 翻译规划(Plan mode):默认先把 epub 按标签分类,让模型判断诗歌、列表、表格单元格是否要翻,避免漏翻或错翻;
--plan-dry-run可以零 Key 先预览分类结果,--plan-classify agent能交给你或编码智能体复核后再翻译。 - 会话上下文(Session mode):
--use_context session让全书共享一份翻译历史,保证人名和用词前后一致,超过--context-compact-at(默认 8192 token)后自动压缩成交接摘要。 - 续翻并行:中断后可恢复,多 worker 同时处理章节与分段。
典型使用场景
- 把公版电子书改成中英或多语种对照版,放进阅读器阅读。
- 翻译英文论文 PDF:先用
--pages 1-2翻两页检查效果,再翻整篇,生成带目录的双语 EPUB。 - 批量翻译 TXT、Markdown 文档,或给 SRT 字幕做多语言版本。
- 把翻译工作交给编码智能体:克隆仓库后直接对 Claude Code 或 Codex 说”用 bbm-plan 把这本书译成中英对照版”,由它调用仓库自带的技能完成。
- 先试效果可走免费引擎:Google、腾讯 TranSmart 或 DeepL 免费档,无需 API Key。
快速上手
pip install -U bbook_maker
cp bbm_providers.example.json bbm_providers.json # 填密钥
python3 make_book.py --book_name test_books/animal_farm.epub --provider openai --test --use_context session
不想配置环境也可以用官方 Docker 镜像,把书所在文件夹挂载到 /book:
docker pull ghcr.io/yihong0618/bilingual_book_maker:latest
docker run --rm -v "/path/to/books":/book ghcr.io/yihong0618/bilingual_book_maker:latest --book_name "/book/animal_farm.epub" --key "sk-XXX" --language zh-hans
小结
适合想自制双语书、文档或字幕的读者、译者和开发者,也适合想把翻译步骤直接交给编码智能体跑的用户;如果只是想把英文 PDF 论文译成双语对照文档而不是整本电子书,BabelDOC 对论文版式的还原更专。项目 MIT 协议开源,维护活跃;LLM 路线需自备 API Key 和 Python 3.10 以上环境,PDF 转 EPUB 功能需额外安装 Pandoc 和 PDF 依赖包,体积明显更大。README 附免责声明:只翻译有授权或属公版的内容。