epub_bilingual_translator/archive/v0.07/CHANGELOG.md

更新日志 (CHANGELOG)

[v0.07] - 2026-01-13 (The Refinement)

🛡️ 安全与配置

• 环境隔离: 引入 .env 支持，彻底移除了代码库中的硬编码 API Key。
• 配置升级: utils.py 现自动加载 .env 并注入到配置中，支持任意 Provider 的环境变量覆盖 (如 V3_API_KEY, OPENROUTER_API_KEY)。
• 模板化: 新增 config.example.json 和 .env 模板，提升部署安全性。

🚀 核心改进

• V3 Provider 支持: 验证并修复了对 V3 API (OpenAI 兼容格式) 的支持，全流程跑通。
• EPUB 构建修复: 解决了 ebooklib 在处理 TOC 时因缺少 UID 导致的 Argument must be bytes or unicode 崩溃问题。
• 缓存优化:
  • 缓存目录结构调整为 Hash 前缀 (cache/translations/ab/...)，解决了按日期分目录导致的缓存频繁失效问题。
  • 放宽了缓存验证逻辑，支持部分命中的缓存复用。
• 视觉优化: 引入“盘古之白” (Pangu spacing)，自动在中文与英文/数字之间添加空格，显著提升阅读体验。

⚡ 体验提升

• 断点续传提示: 启动时自动检测并提示未完成的翻译进度。
• 详细统计: 翻译完成后展示详细的成功/失败/跳过统计数据。
• 并发优化: 移除了冗余的信号量控制，完全依赖 RateLimiter，逻辑更清晰高效。

---

[v0.05] - 2026-01-12 (The Arena)

🌟 核心突破

• 书籍画像 (Book Profiler):
  • 自动提取前言和正文采样。
  • 生成 Book Profile，包含领域 (Genre)、文风 (Style)、目标受众 (Audience) 和翻译指令。
  • 生成 Glossary (术语表)，并支持自动注入 Prompt。
  • 状态绑定: Profile 和 Glossary 现在直接存储在每本书的 manifest.json 中，互不干扰。
• 模型竞技场 (Model Arena):
  • 自动选取典型 Chunk，让多个候选模型 (Gemini, Llama, Qwen) 同台竞技。
  • 引入 Judge Agent (基于 Smart 模型)，从准确性、信达雅维度评选最佳模型。
  • 自动锁定获胜模型用于全书翻译。

🏗️ 架构升级

• LLM Client 重构:
  • Syntax Fixes: 彻底修复了正则构造中的语法错误。
  • Quote Safety: 移除了所有 f-string 中的复杂正则，改用安全的字符串拼接。
  • Dual RateLimiters: 引入主/副限流器，防止死锁。
• 配置增强:
  • config.json 支持 arena_models 和 judge_model 配置。

🔧 修复与优化

• 修复了 unhashable type: 'dict' 错误 (移除了错误的 {{}})。
• 修复了多本书连续翻译时 Profile 串用的问题 (Profile 现已绑定至 Manifest)。

---

[v0.03] - 2026-01-12

• 极简 ID 锚点系统: 废弃复杂的 [p_xxxxx] 格式，使用纯净 ID，彻底解决残留问题。
• 智能术语一致性: 引入 GlossaryManager。
• 结构完美保留: 修复了 EPUB Spine 和 Metadata 丢失问题。

[v0.02] - 2026-01-12

• Manifest 驱动架构: 引入 ManifestManager 作为单一真理源。
• 流程解耦: 提取、翻译、构建三阶段分离。

[v0.01] - 2026-01-10

• 初始版本，实现基本的并发翻译和 EPUB 解析。