Integrate Chinese cover and metadata workflow into EPUB translation skill

This commit is contained in:
Kai Tan
2026-10-09 13:25:21 +08:00
parent 7f1ae23fe2
commit 26da365cb2
4 changed files with 101 additions and 16 deletions
+9 -5
View File
@@ -1,11 +1,11 @@
---
name: epub-translate
description: Translate complete EPUB books and iteratively review terminology, navigation, notes and layout using the epub_bilingual_translator scripts and headless evidence. Use for EPUB translation or translation quality repair; scanned PDF/OCR conversion is a separate workflow.
description: Translate complete EPUB books, repair translation quality, and add Chinese covers and bibliographic metadata to translated editions using epub_bilingual_translator and headless QA. Use for EPUB translation, Chinese cover generation, or library edition metadata updates; scanned PDF/OCR conversion is a separate workflow.
---
# 电子书翻译与验收
把脚本的确定性检查与语言审校结合,交付完整且可追溯的纯中文/双语 EPUB。尊重用户指定模型和输出模式;不得把局部样例或已生成截图称为全书验收通过。
把脚本的确定性检查、语言审校和中文版本整理结合,交付完整、可追溯且能在书库中区分的纯中文/双语 EPUB。尊重用户指定模型和输出模式;不得把局部样例或已生成截图称为全书验收通过。
## 找到项目与选择执行方式
@@ -15,6 +15,8 @@ description: Translate complete EPUB books and iteratively review terminology, n
- 用户要求 Luna 子 agent 测试时,用 agent Manifest 方式;模型由 agent 执行,不把 `luna` 猜成某家 API 的模型 ID。
- 用户指定可用 API 时,用 `main.py --complete-book`,保持其模型、端点和本地凭据选择。不要把密钥或源书上传到额外服务。
只补中文封面/metadata 时,直接读取 [中文版本整理](references/cover-metadata.md),复用已有完整译本,不启动正文翻译。完整译本交付时将中文封面和书库 metadata 纳入版本整理;只修局部问题或用户限定输出范围时按该范围执行。
先固定输入 SHA、全书范围、原书目录层级和注释方式。确认版权、索引、书后文字和非 spine 文档都在清单中;图像内文字不能冒充已翻译,扫描书不属于本 skill。
## 翻译与纠错闭环
@@ -37,10 +39,12 @@ description: Translate complete EPUB books and iteratively review terminology, n
有证据的失败修复后重建两版并重跑受影响检查;连续出现相同失败且没有新证据时保留待审记录,避免重复付费请求;有明确修复线索时继续定位和验证。不把 Chromium 连续 XHTML 排版描述为所有阅读器的分页效果。
交付实际 EPUB 链接、模型/来源记录、工程检查结果、已审截图和语义抽查范围,以及未解决项。只有全部提取单元有效并完整回填时才称“完整译本”;没有全书逐页审校时使用“抽样 QA”。书籍、密钥和 `.work` 数据留在本地,代码及 skill 的推送沿用用户已有授权。
交付实际 EPUB 链接、模型/来源记录、工程检查结果、已审截图和语义抽查范围,以及未解决项。版本整理完成时同时说明书名的权威/项目译名状态、封面生图来源、版本名称和修订号。只有全部提取单元有效并完整回填时才称“完整译本”;没有全书逐页审校时使用“抽样 QA”。书籍、密钥和 `.work` 数据留在本地,代码及 skill 的推送沿用用户已有授权。
## 中文封面与书库版本
需要中文封面/metadata 时按 [执行流程](references/workflow.md) 的版本封装步骤处理。先查出版社/国家图书馆书目,核对原作和作者;没有正式译名则标为项目译名。不得将发布版的 ISBN、译者或出版社冒用到 AI 译本。两版的封面徽标、metadata 模式和修订号必须一致。
按 [中文版本整理](references/cover-metadata.md) 执行书目核对 → 生图与逐字审查 → 封装 → headless 封面和缩略图复验。该参考包含 edition 配置、图片审查记录、已有译本封装命令和自动流水线接入。
优先检查用户指定模型及当前 Codex 生图能力。内置工具可用但不公开模型时,记录提供方与 `model: null`,不能声称已选择 GPT-Image-2.5。图像文字是独立的生图审校范围;先查看原图,再编辑,逐字查看生成图与 headless 书内渲染,并用图片摘要绑定 review。只在确认正确后写 `visual_review: passed`。书库缩略图须能辨认书名和版本,旧封面/正文插图字节继续保留。SVG 参考图若工具不能直接读取,用 headless 浏览器渲染为参考 PNG。
先核对原作和作者,再采用出版社/国家图书馆的正式中文书名;没有可信书目时标为项目译名。AI 译本保留原作来源,不冒用正式译本的 ISBN、译者或出版社。封面徽标、metadata 的模式与修订号须一致;两版用不同徽标颜色及独立 UUID,便于入库区分。
按用户指定顺序核实当时可用的生图模型与接入方式。工具不公开模型 ID 时记录提供方与 `model: null`,不能声称已选择 GPT-Image-2.5。先查看原图,再编辑和逐字查看生成图;确认后用图片 SHA 绑定 review。最终检查实际 EPUB 内的封面和缩略图,旧封面/正文插图字节继续保留。metadata 正确不等于封面文字或全书语义审校通过。