3. 发现分块

使用 Glob 查找所有源分块，并确定哪些仍需翻译：

Glob: {filename}_temp/chunk*.md
Glob: {filename}_temp/output_chunk*.md

计算存在源文件但没有对应 output_ 文件的分块集合。这些是需要翻译的分块。

如果所有分块都已翻译，则跳转到步骤 5。

4. 使用子代理进行并行翻译

每个分块都有其独立的子代理（1 个分块 = 1 个子代理 = 1 个全新的上下文）。这可以防止上下文累积和输出截断。

分批启动分块以遵守 API 速率限制：

• 每批次：最多 concurrency 个子代理并行运行（默认：8）
• 等待当前批次完成后再启动下一批次

使用以下任务生成每个子代理。 使用你的运行时提供的任何子代理/后台代理机制（例如 Agent 工具、sessions_spawn 或等效功能）。

输出文件是在源文件名前加上 output_ 前缀：chunk0001.md → output_chunk0001.md。

将文件 <temp_dir>/chunk<NNNN>.md 翻译成 {TARGET_LANGUAGE}，并将结果写入 <temp_dir>/output_chunk<NNNN>.md。遵循下面的翻译规则。仅输出翻译后的内容 —— 不要有任何评论。

每个子代理接收：

• 它负责的单个分块文件
• 临时目录路径
• 目标语言
• 翻译提示（见下文）
• 任何自定义说明

每个子代理的任务：

1. 读取源分块文件（例如 chunk0001.md）
2. 遵循下面的翻译规则翻译内容
3. 将翻译后的内容写入 output_chunk0001.md

重要提示：每个子代理只翻译一个分块，并将结果直接写入输出文件。不需要 START/END 标记。

子代理的翻译提示

在每个子代理的说明中包含此翻译提示（将 {TARGET_LANGUAGE} 替换为实际的语言名称，例如“中文”）：

请翻译markdown文件为 {TARGET_LANGUAGE}. IMPORTANT REQUIREMENTS:

1. 严格保持 Markdown 格式不变，包括标题、链接、图片引用等
2. 仅翻译文字内容，保留所有 Markdown 语法和文件名
3. 删除页码、空链接、不必要的字符和如: 行末的''
4. 删除只有数字的行，那可能是页码
5. 保证格式和语义准确翻译内容自然流畅
6. 只输出翻译后的正文内容，不要有任何说明、提示、注释或对话内容。
7. 表达清晰简洁，不要使用复杂的句式。请严格按顺序翻译，不要跳过任何内容。
8. 必须保留所有图片引用，包括：
   • 所有 格式的图片引用必须完整保留
   • 图片文件名和路径不要修改（如 media/image-001.png）
   • 图片alt文本可以翻译，但必须保留图片引用结构
   • 不要删除、过滤或忽略任何图片相关内容
   • 图片引用示例： ->
9. 智能识别和处理多级标题，按照以下规则添加markdown标记：
   • 主标题（书名、章节名等）使用 # 标记
   • 一级标题（大节标题）使用 ## 标记
   • 二级标题（小节标题）使用 ### 标记
   • 三级标题（子标题）使用 #### 标记
   • 四级及以下标题使用 ##### 标记
10. 标题识别规则： * 独立成行的较短文本（通常少于50字符） * 具有总结性或概括性的语句 * 在文档结构中起到分隔和组织作用的文本 * 字体大小明显不同或有特殊格式的文本 * 数字编号开头的章节文本（如 "1.1 概述"、"第三章"等）
11. 标题层级判断： * 根据上下文和内容重要性判断标题层级 * 章节类标题通常为高层级（# 或 ##） * 小节、子节标题依次降级（### #### #####） * 保持同一文档内标题层级的一致性
12. 注意事项： * 不要过度添加标题标记，只对真正的标题文本添加 * 正文段落不要添加标题标记 * 如果原文已有markdown标题标记，保持其层级结构
13. {CUSTOM_INSTRUCTIONS if provided}

markdown文件正文:

5. 验证完整性并重试

所有批次完成后，使用 Glob 检查每个源分块是否都有对应的输出文件。

如果有缺失，则重试它们 —— 每个缺失的分块作为其自己的子代理。每个分块最多尝试 2 次（初始 + 1 次重试）。

同时读取 manifest.json 并验证：

• 每个分块 ID 都有对应的输出文件
• 没有输出文件是空的（0 字节）

报告重试后仍然失败的分块。

6. 翻译书名

从临时目录读取 config.txt 以获取 original_title 字段。

将标题翻译成目标语言。对于中文，用书名号包裹：《translated_title》。

7. 后处理 — 合并与构建

使用翻译后的标题运行构建脚本：

python3 {baseDir}/scripts/merge_and_build.py --temp-dir "<temp_dir>" --title "<translated_title>" --cleanup

--cleanup 标志在完全成功的构建后删除中间文件（分块、input.html 等）。如果用户要求保留中间文件，则省略 --cleanup。

脚本会自动从 config.txt 读取 output_lang。可选覆盖参数：--lang, --author。

这将在临时目录中生成：

• output.md — 合并后的翻译 markdown
• book.html — 带有浮动目录的网页版本
• book_doc.html — 电子书版本
• book.docx, book.epub, book.pdf — 格式转换（需要 Calibre）

8. 报告结果

告知用户：

• 输出文件的位置
• 翻译了多少个分块
• 翻译后的标题
• 列出生成的输出文件及其大小
• 任何格式生成失败的情况

每周安装次数

110

仓库

deusyu/translate-book

GitHub 星标

518

首次出现

9 天前

安全审计

Gen Agent Trust HubPassSocketWarnSnykPass

已安装于

claude-code102

codex25

gemini-cli23

github-copilot23

amp23

cline23