Files
epub_bilingual_translator/doc/QA_PROTOCOLS_2026-10-10.md

6.7 KiB
Raw Permalink Blame History

Protocols — AZW3 转 EPUB、Luna 翻译与抽样 QA

本次按更新后的 skills/epub-translate/SKILL.md 完成纯中文与中英对照两版,版本 luna-r1。项目译名为《实践方案:人体操作手册》;没有确认正式中文出版书名。正文由 gpt-6-luna 子 agent 按完整 Manifest 执行,无外部翻译 API。封面使用 Codex 内置 imagegen 编辑原封面,工具未公开精确模型 ID,记录为 model: null。

输入与范围

  • 原始 AZW3 SHA256:70c07109484301970f8ba9df7a503b11a56d768102883a2a6f02fc68c7daba27。
  • Calibre 转换后冻结 EPUB SHA256:5c0f743c8afa9c0a24044c3dfde267d05c0141674aae3c7b4398d7a05be9fefa。
  • AZW3 解包与 EPUB 的正文空白词元计数均为 228,905,计数差为零。这是转换完整度证据,不能替代结构或逐句语义审校。
  • 完整提取 5,009 单元,69 个大段上下文批次;术语表 94 条。范围包含前言、声明、全部正文、致谢、作者介绍、参考文献、索引和版权页。
  • 原书 84 个 XHTML 文档、64 个目录项。书内注释与印刷页码/索引链接分别审计,不能把全部内部链接称为脚注。

此次修复

  1. 章节标题中使用图片表示 Protocols,标题匹配原本忽略图片 alt。现以副本中的 alt 参与目录绑定,原图片和 DOM 保留;实际章节标题译文成为目录共享来源,减少14个重复提取的目录单元。
  2. 通用翻译 margin 覆盖出版方章节标题顶部留白。现仅对正文和双语插入单元增加间距,保留中文替换标题及注释的出版方间距。
  3. 换 AI 版本 UUID 会破坏 EPUB 标准字体混淆。新增 IDPF/Adobe 字体处理:保留原字体字节,克隆并重新绑定活跃字体,改写 manifest、encryption.xml 和本地 CSS/inline/font preload 引用。7个字体的解码结果独立与 AZW3 原始字体逐字节核对;headless 在内存中解码字体再提供给浏览器。
  4. 转换源有两个空 Calibre 页分隔 div 与章节标题重 ID;重建后的最终输出不再出现这些重复 ID,原章节标题锚点和链接目标仍有效。
  5. 视觉抽查及全书开头强调标记位置筛查修正两处短提示粗体移位、两处学习时间段的粗体范围、一处脚注上标延伸到解释句;修正翻译结果中的标记位置,再完整回填。长度比例筛查未发现其他长范围错移,但它不能替代语义检查。
  6. 最终英文残留检查修正索引标题和57个遗漏索引词、6个注释章名;品牌、URL、文献标题及刊名按原作保留。
  7. 图形编号抽查发现个人成长方案3/4的嵌套标记内数字漏掉,恢复原数字;加入校验,禁止数字标记范围被翻译为空,允许非空的本地化数字。

版本整理与验收边界

两版使用不同颜色徽标、独立 UUID、模式及修订号一致的 metadata;作者保留原拼写 Andrew D. Huberman,封面保留 with Jessica Wapner 的原作贡献者署名。原作 ISBN/UUID 记录为 source,不用作 AI 译本出版身份。中文译本日期为生成日期,原出版社/日期留在版本来源记录。

原 AZW3 的15个图片/字体资产全部按 SHA 保留在最终 EPUB;转换 EPUB 的14个原二进制资源原路径原字节不变。额外保留转换时未使用的小封面缩略图和原始解码字体,使用新封面、新字体克隆作为活跃资源。

独立 Luna 语义抽查23个长段(15个运动、营养、压力、光照、学习样本;8个睡眠与引言样本),并由主 agent 核对补充剂剂量、警告、否定与不确定性、列表、标题和书后文字。不是全书逐句人工校对。

最终 headless 对照抽样包含封面、引言、图形章节标题、睡眠补充剂列表、饮酒段落、压力管理、WOOP、表达性写作、参考注释和索引;另查看180×270书库缩略图。浏览器禁用书内脚本和外部请求。原始自动报告中的 visual/semantic 状态保留 pending,实际人工/agent 审核证据另写 review-record.json。Chromium 连续 XHTML 的截图不代表所有阅读器的分页。

原图形章节词 Protocols、整页英文图片扉页、商标图片内文字保留英文;它们不属于文本翻译提取范围。参考文献部分保留可追溯的原文文献标题/刊名。索引保持原作顺序和印刷页码链接,未重排为中文拼音索引。

本地证据

工作目录:.work/luna-protocols/(不提交书籍或译文到仓库)。

  • conversion-source.json、conversion-review.json:AZW3 转换与来源。
  • manifest.json、book_structure.json、agent-run.json、results/:全书范围、源摘要与翻译结果。
  • semantic-review-luna.json、semantic-review-sleep-luna.json:独立语义抽查。
  • edition/edition.json、各模式 review.json:书名来源、封面提供方及图片 SHA。
  • asset-font-verification.json:最终资源 SHA 与字体解码验证。
  • qa-中文版/、qa-中英对照版/:最终结构报告与对照截图。
  • qa-thumb-final-中文版/、qa-thumb-final-中英对照版/:实际 EPUB 缩略图。
  • review-record.json:最终输出 SHA、实际已看截图和抽样范围。

书目核对依据:原作出版社页面、作者关于翻译版本的 FAQ。前者用于原作核对,后者不构成具体中文书名的权威依据。字体处理依据:W3C EPUB 3.3 字体混淆规范、Calibre 字体处理实现。

最终验证结果

两版均为5,009/5,009完整回填、64个目录项、零新增结构问题、零新增自动布局问题。原书406个书内注释引用保留;双语版同时保留原文和译文引用,所以为812个。每版抽样18次内部目标点击(原文9次、译文9次),其中原文/译文各4次分类为书内注释且返回链接成功;其余5次各为非注释目标,不能混称脚注。

每版生成13个文档、48张截图,最终记录明确列出实际已查看图片与SHA;另有前几轮原文/译文对照证据。独立语义抽查23个长段,原自动报告没有改写成全书视觉/语义通过。测试结果:89 passed,2 skipped;实际 Chromium EPUB 复验另行完成。

  • Protocols_中文版_luna-r1.epub:86ce3cf735443bc33d6e92093d275e61d6b568b15ebe8228949a46f9203bfef2。
  • Protocols_中英对照版_luna-r1.epub:7995e864d5044a7637d8a5f14a9e782936f7df22bdb7b0bfbd5e78f0a34a12e0。