bilingual_book_maker

环境要求

• Python 3 环境（README 使用 python3 运行脚本）
• 可用的 pip 与网络环境用于安装依赖
• OpenAI 或 Anthropic 格式的 API 端点与密钥（也可使用 --provider 方式提供）
• 待翻译且你有权翻译的 epub/txt/md/srt/pdf 文件
• 可选：已安装 Docker（用于免环境配置运行）

安装与启动步骤

1. 1安装依赖

   在项目目录下安装依赖；也可用 pip 直接安装发布包 bbook_maker，二选一即可。

   pip install -r requirements.txt
   # 或：
   pip install -U bbook_maker

   复制

2. 2生成供应商配置

   从示例文件复制出 bbm_providers.json，用于通过 --provider 传入凭证。

   cp bbm_providers.example.json bbm_providers.json

   复制

3. 3预览翻译计划

   用自带的示例书试跑，--plan-dry-run 只预览编排计划而不真正翻译。

   python3 make_book.py --book_name test_books/animal_farm.epub --plan-dry-run

   复制

4. 4执行段落分类

   --plan-classify all 让模型对 epub 标签做 skip/translate 判定，决定哪些内容需要翻译。

   python3 make_book.py --book_name test_books/animal_farm.epub --plan-classify all

   复制

5. 5指定接口格式

   通过 --api_format 选择 openai 或 anthropic 等请求格式；换其他引擎时同样改这个参数。

   python3 make_book.py --book_name test_books/animal_farm.epub --api_format openai

   复制

6. 6试译前几段

   加 --test 只翻译示例书的前几段，用来快速验证密钥与端点是否可用。

   python3 make_book.py --book_name test_books/animal_farm.epub --test

   复制

7. 7用 Docker 运行

   拉取官方预构建镜像后，把书籍所在文件夹挂载到容器 /book，容器接受全部 make_book.py 参数。

   docker pull ghcr.io/yihong0618/bilingual_book_maker:latest

   复制

关键配置

如何确认成功

翻译完成后会生成 ${book_name}_bilingual.epub（EPUB）或同名 _bilingual.txt/_bilingual.srt；若中途出错或按 CTRL+C 中断，会留下 _bilingual_temp 临时文件供重

常见问题

注意事项

• 仅对你有权翻译的材料使用本工具：自有版权、已获授权或许可、公有领域书籍，或法律允许的用途。
• 使用前请阅读项目的 disclaimer 免责声明。
• --provider 与 --api_format 是两种不同的凭证/接口指定方式，--provider 走 bbm_providers.json 配置文件。
• JSON-schema 端点及可对话端点会自动启用 epub 标签分类，只有纯机器翻译引擎会退化为整段翻译。