deusyu/translate-book

Rainman Translate Book – AI 辅助整本书翻译

功能简介 – 将 PDF、EPUB、DOCX 或 Markdown 书籍转换为任何语言的译本。流程如下：

1. 转换 源文件为 Markdown（通过 Calibre 或布局感知解析器）。
2. 分块 将 Markdown 分成约 6 千字符的片段，并为每个片段记录 SHA-256 清单。
3. 翻译 使用 8 个独立的 LLM 子代理（Codex、Claude Code 或 OpenClaw）并行翻译每个片段。每个子代理拥有全新的上下文窗口，以及来自相邻片段的简短只读摘录和关键术语词汇表，以保持术语一致性。
4. 验证 输出是否符合清单，然后 合并 翻译后的片段。
5. 构建 最终成品——带有浮动目录的 HTML、DOCX、EPUB 和 PDF——通过 Pandoc 和 Calibre。

主要功能

• 并行子代理（默认 8 个）避免上下文溢出并加速翻译。
• 片段级可恢复运行；run_state.json 让您无需重新翻译已完成的片段即可重新启动。
• 词汇表系统会从样本片段中提取专有名词/术语，让您编辑 glossary.json，并将术语表注入每个翻译提示中。
• 基于清单的完整性检查（SHA-256）确保过时或损坏的片段不会被合并。
• 支持多种目标语言（中文、日文、韩文、法文、德文、西班牙文等）和多种输出格式。
• 针对公式密集的 PDF 提供可选的前处理，使用 MinerU 或 Marker，保留 LaTeX 数学。

如何使用

1. 为您的代理运行时安装此技能（npx skills add deusyu/translate-book -a codex 或 Claude Code/OpenClaw 的等效命令）。
2. 在代理的 CLI 或聊天中，发出类似 translate /path/to/book.pdf to Chinese 的命令（或使用斜线命令 /translate-book …）。
3. 此技能会创建一个临时工作目录（{book}_temp/），运行完成后，您会找到：
   • output.md – 合并后的翻译 Markdown
   • book.html、book.docx、book.epub、book.pdf – 最终格式

先决条件 – Calibre（ebook-convert）、Pandoc、Python 3 与 pypandoc（可选 beautifulsoup4），以及已安装的 Codex/Claude Code/OpenClaw 运行时。

项目结构 – 此仓库包含技能定义（SKILL.md）以及一组 Python 脚本，负责转换、清单管理、词汇表处理、片段上下文、运行规划、合并和最终构建。测试资源位于 tests/baselines/ 下。

适用对象 – 研究人员、翻译人员，或任何需要翻译整本书同时保持术语一致，且已使用 LLM 代理的人。