58 lines
6.7 KiB
Markdown
58 lines
6.7 KiB
Markdown
# 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、实际已看截图和抽样范围。
|
||
|
||
书目核对依据：[原作出版社页面](https://www.simonandschuster.com/books/Protocols/Andrew-D-Huberman/9781668032152)、[作者关于翻译版本的 FAQ](https://www.hubermanlab.com/faq/will-protocols-be-available-in-languages-other-than-english)。前者用于原作核对，后者不构成具体中文书名的权威依据。字体处理依据：[W3C EPUB 3.3 字体混淆规范](https://www.w3.org/TR/epub-33/#sec-font-obfuscation)、[Calibre 字体处理实现](https://github.com/kovidgoyal/calibre/blob/master/src/calibre/ebooks/oeb/polish/container.py)。
|
||
|
||
## 最终验证结果
|
||
|
||
两版均为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`。
|