用途：把英文 .epub 书籍翻译成简体中文 .epub。模型调用由当前聊天环境中的主代理或子代理完成，本技能不绑定 OpenAI、Claude、Gemini 或任何特定 API。脚本只做确定性的 EPUB 工程处理：解包 EPUB → 提取正文/目录/元数据文本分块 → agent 翻译 JSONL → 写回 EPUB → 重新打包。
主要能力与用法：
- 拆分待翻译分块：python3 scripts/translate_epub.py prepare book.epub -w work/book-zh
- 翻译 work/book-zh/chunks/*.jsonl，把译文写入 work/book-zh/translated/ 下同名 JSONL 文件。
- 检查完整性：python3 scripts/translate_epub.py check -w work/book-zh
- 生成中文 EPUB：python3 scripts/translate_epub.py build -w work/book-zh -o book.zh-Hans.epub
分块格式为每行一个 JSON 对象，如 {"id":"t000001","source":"Chapter 1","translation":""}。翻译时须保留每行一条记录、保留 id 与 source，只填写 translation，不新增解释或字段，不合并拆分重排。source 中的 [t:0]、[t:1] 等占位符代表链接、脚注、斜体、粗体等内联标签，translation 中须按原数量和顺序保留。
工作流：确认输入为 .epub 并确定输出路径（默认建议 <原文件名>.zh-Hans.epub）；运行 prepare 生成 manifest.json、chunks/、translated/ 与解包后的 source/；翻译前先扫描内容建立术语对照表（如 glossary.md）以保证术语一致；小书由主代理逐 chunk 处理，大书可并行分配给子代理，子代理须先读 glossary.md 并写入 translated/chunk-xxxx.jsonl；运行 check 确认无缺失、重复、未知 ID、空白译文或占位符不匹配；运行 build 写回并更新语言代码为 zh-Hans；最后抽查目录页、前言、第一章、含脚注与含图片章节。
常用选项：--source-language（默认 English）、--target-language（默认 Simplified Chinese）、--target-language-code（默认 zh-Hans）、--chunk-chars（默认 8000）、--force、--allow-missing。
限制与注意：脚本仅使用 Python 标准库，无需第三方依赖。翻译须保留原意、语气、段落边界与节奏；人名、品牌名、专有名词可保留英文；不翻译 URL、邮箱、代码、命令、文件名、锚点；不删减内容，不添加原书没有的解释、总结、标题或译者注。常见失败包括工作目录已存在、MISSING 大于 0、duplicate id、unknown id、blank translation、输出 EPUB 打不开、局部章节仍为英文、阅读器目录仍为英文、占位符不匹配、子代理输出破坏 JSONL，需按对应方式修正。