epub_bilingual_translator/archive/v0.08/README.md

EPUB 双语翻译程序 v0.07

一个基于 OpenRouter/OpenAI API 的 EPUB 双语翻译工具，采用全局编号系统和真并发翻译。

✨ 核心特性

🎯 全局编号系统

• 每个段落分配全局唯一ID（格式：p_0001, p_0002...）
• ID贯穿全流程：提取 → 翻译 → 组装
• 精确对应保证：绝不出现中英文错行问题

⚡ 真并发翻译

• asyncio.gather 并发执行：高效利用 API 速率限制
• 智能速率控制：基于 Token 桶的 RateLimiter
• 实时进度显示：Rich 进度条显示翻译状态
• 断点续传：自动记录进度，随时中断随时继续

🛡️ 安全与稳定

• 环境隔离：支持 .env 配置，API Key 不落地
• 鲁棒重试：集成 tenacity 处理网络波动
• 缓存系统：基于 Hash 的持久化缓存，跨天复用

🎨 极致排版

• 盘古之白：自动在中文与西文数字间添加空格
• 样式注入：注入专用 CSS 优化阅读体验

🚀 快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置环境

复制 .env 模板并填入你的 API Key：

# .env 文件
V3_API_KEY=sk-xxxxxx
OPENROUTER_API_KEY=sk-or-xxxxxx

3. 开始翻译

# 默认使用 OpenRouter
python main.py input/book.epub

# 使用 V3 Provider
python main.py input/book.epub -p v3

# 测试模式（只翻译前3个块）
python main.py input/book.epub --test

📂 目录结构

.
├── config/             # 配置文件
│   ├── config.json     # 主配置
│   └── prompts.json    # 提示词模板
├── input/              # 输入 EPUB 目录
├── output/             # 输出 EPUB 目录
├── cache/              # 缓存目录 (Manifest, Translations)
├── logs/               # 运行日志
└── src/                # 源代码

⚙️ 核心配置 (config.json)

{
  "translation": {
    "chunk_size": 5000,
    "temperature": 0.3
  },
  "providers": {
    "v3": {
      "base_url": "https://api.gpt.ge/v1",
      "models": { "fast": "gpt-4o-mini" },
      "rate_limits": { "requests_per_minute": 500 }
    }
  }
}

📄 许可证

MIT License

---

版本: v0.07
更新: 2026-01-13