应用介绍
< #整书翻译 #AI翻译 #Agent技能 #Claude Code #Codex #EPUB #PDF #开源软件
translate-book 是一个专门翻译整本书的 Agent 技能，装进 Codex、Claude Code 或 OpenClaw 之后，一句「把这本书翻成中文」就能跑完全程。它不把整本书塞进一次对话，而是先切成小块，再派出多个子代理并行翻译，每个子代理拿到的都是干净的上下文，从根上避开了长文翻到后面上下文爆掉、输出被截断的问题。
整条流水线是这样的：Calibre 先把 PDF、DOCX 或 EPUB 转成 Markdown，按约六千字切块并把每块的 SHA-256 记进 manifest；默认每批 8 个子代理并行翻译；译完逐块校验源块与译块一一对应，再合并成书，经 Pandoc 和 Calibre 输出带目录的 HTML、DOCX、EPUB 和 PDF。中途断了可以按块续跑，改了术语表也只重译受影响的那些块，不用整本重来。支持中、英、日、韩、法、德、西七种目标语言，MIT 协议。运行前需要本机装好 Calibre、Pandoc 和 Python 3。
并行子代理翻译：默认每批 8 个子代理同时开工，各自持有独立的上下文窗口，既躲开单次会话的长度上限，也按批次控制在 API 速率限制之内。
切块与哈希校验：每块源文的 SHA-256 记入 manifest.json，合并前核对源块与译块 1:1 对应，过期或损坏的块不会被悄悄合进成品；另有源文件指纹，换了源文件会直接中止而不是复用旧块。
断点续跑：翻译状态按块记录在 run_state.json 里，中断后从没做完的那块接着跑，不必从头再来。
术语一致与选择性重译：术语表全书统一，改动术语后只重新翻译受影响的块，避免同一个专有名词前后各译一套。
邻块上下文：每个子代理可以只读地看到相邻块的少量摘录，用来判断代词指代和人名地名的延续，减少切块处的断裂感。
多格式输入输出：输入支持 PDF、DOCX、EPUB，输出一次生成合并后的 Markdown、带浮动目录的 HTML、DOCX、EPUB 和可直接打印的 PDF，还可以指定 EPUB 封面。
一条命令安装：用 npx skills add deusyu/translate-book 装进 Codex 或 Claude Code，也可以直接克隆到技能目录，Claude Code 里还能用斜杠命令调用。
开源项目：项目源码托管在 GitHub，方便开发者查看实现方式、参与开发，或者根据自己的需求进行二次定制。
translate-book 是一个专门翻译整本书的 Agent 技能，装进 Codex、Claude Code 或 OpenClaw 之后，一句「把这本书翻成中文」就能跑完全程。它不把整本书塞进一次对话，而是先切成小块，再派出多个子代理并行翻译，每个子代理拿到的都是干净的上下文，从根上避开了长文翻到后面上下文爆掉、输出被截断的问题。
整条流水线是这样的：Calibre 先把 PDF、DOCX 或 EPUB 转成 Markdown，按约六千字切块并把每块的 SHA-256 记进 manifest；默认每批 8 个子代理并行翻译；译完逐块校验源块与译块一一对应，再合并成书，经 Pandoc 和 Calibre 输出带目录的 HTML、DOCX、EPUB 和 PDF。中途断了可以按块续跑，改了术语表也只重译受影响的那些块，不用整本重来。支持中、英、日、韩、法、德、西七种目标语言，MIT 协议。运行前需要本机装好 Calibre、Pandoc 和 Python 3。
软件功能
并行子代理翻译：默认每批 8 个子代理同时开工，各自持有独立的上下文窗口，既躲开单次会话的长度上限，也按批次控制在 API 速率限制之内。
切块与哈希校验：每块源文的 SHA-256 记入 manifest.json，合并前核对源块与译块 1:1 对应，过期或损坏的块不会被悄悄合进成品；另有源文件指纹，换了源文件会直接中止而不是复用旧块。
断点续跑：翻译状态按块记录在 run_state.json 里，中断后从没做完的那块接着跑，不必从头再来。
术语一致与选择性重译：术语表全书统一，改动术语后只重新翻译受影响的块，避免同一个专有名词前后各译一套。
邻块上下文：每个子代理可以只读地看到相邻块的少量摘录，用来判断代词指代和人名地名的延续，减少切块处的断裂感。
多格式输入输出：输入支持 PDF、DOCX、EPUB，输出一次生成合并后的 Markdown、带浮动目录的 HTML、DOCX、EPUB 和可直接打印的 PDF，还可以指定 EPUB 封面。
一条命令安装：用 npx skills add deusyu/translate-book 装进 Codex 或 Claude Code，也可以直接克隆到技能目录，Claude Code 里还能用斜杠命令调用。
开源项目：项目源码托管在 GitHub，方便开发者查看实现方式、参与开发，或者根据自己的需求进行二次定制。
