Add Chinese covers and source-bound library edition metadata

2026-10-08 12:58:32 +08:00
parent 8297e6d2c8
commit 5dbd7bd240
14 changed files with 699 additions and 3 deletions
@@ -38,3 +38,9 @@ description: Translate complete EPUB books and iteratively review terminology, n
 有证据的失败修复后重建两版并重跑受影响检查；连续出现相同失败且没有新证据时保留待审记录，避免重复付费请求；有明确修复线索时继续定位和验证。不把 Chromium 连续 XHTML 排版描述为所有阅读器的分页效果。

 交付实际 EPUB 链接、模型／来源记录、工程检查结果、已审截图和语义抽查范围，以及未解决项。只有全部提取单元有效并完整回填时才称“完整译本”；没有全书逐页审校时使用“抽样 QA”。书籍、密钥和 `.work` 数据留在本地，代码及 skill 的推送沿用用户已有授权。
+
+## 中文封面与书库版本
+
+需要中文封面／metadata 时按 [执行流程](references/workflow.md) 的版本封装步骤处理。先查出版社／国家图书馆书目，核对原作和作者；没有正式译名则标为项目译名。不得将发布版的 ISBN、译者或出版社冒用到 AI 译本。两版的封面徽标、metadata 模式和修订号必须一致。
+
+优先检查用户指定模型及当前 Codex 生图能力。内置工具可用但不公开模型时，记录提供方与 `model: null`，不能声称已选择 GPT-Image-2.5。图像文字是独立的生图审校范围；先查看原图，再编辑，逐字查看生成图与 headless 书内渲染，并用图片摘要绑定 review。只在确认正确后写 `visual_review: passed`。书库缩略图须能辨认书名和版本，旧封面／正文插图字节继续保留。SVG 参考图若工具不能直接读取，用 headless 浏览器渲染为参考 PNG。
@@ -75,3 +75,15 @@ Linux 系统运行库仍可能需要官方 `install --with-deps chromium --only-
 退出 1 表示工程检查／完整度／注号点击失败；退出 2 表示所请求的渲染未成功，不以缺依赖降级成通过。`report.json` 保存源／输出 SHA、基线问题、覆盖范围、注释分类、布局提示和真实浏览器点击结果；`review.html` 和 PNG 是视觉证据。

 查看截图后另写 `review-record.json`：已审文档／图片、发现项、修改与复验结果、语义抽查单元、剩余问题。原始自动报告的 visual／semantic 状态保持 pending，防止后续把机器生成证据误当人工验收。源码里不存在的网站尾注不在“完整源 EPUB 翻译”范围内；若用户要求纳入，单独获取、翻译并重建注号目标，不能猜注释内容。
+
+## 版本封装：封面和 metadata
+
+读取 README 的「中文封面与书库 metadata」步骤，使用 `scripts/localize_edition.py prepare/apply`。可在完整译本生成后单独封装，不重译正文。生图是 agent 的显式工具步骤，脚本只提取任务、验证已审图片、封装和审计；普通脚本不能假装拥有 Codex 的内置工具或私有 OAuth 生图权限。
+
+先核实 title/author 的正式中文出版书目；保存网址、查询日期、版次关联和 ISBN（仅作为证据）。输入 title/author/identifier 不匹配时修订配置，不放宽匹配。保留繁体正式书名，用户需要简体时记录转换，不能默默改成另一书名。研究不到的条目写 `title_status: project`。
+
+`prepare` 输出 cover-job.json 与参考封面。先查看参考图，用可用生图模型制作中文版和双语版，再查看输出图。review.json 记录实际 SHA、mode、title_zh、edition_revision、provider、model 和具体审查内容。模型 ID 不可见则为 null。错字、错误徽标、缺失修订号、裁切或缩略图不可读时迭代生图，不以 metadata 正确代替图片审校。不得借用另一部书的封面。
+
+`apply` 仅用于相应完整译本；分别指定 mode／图片／review／输出，保留原译本。`main.py` 和 agent build 的可选 `--edition-config` 通过配置 covers 自动调用同一封装步骤。重新修订使用未封装的译本作为输入，更新修订号和图片审查记录。
+
+运行原书到新版的 headless QA，并显式选择封面 XHTML（如 titlepage.xhtml）。查看全尺寸封面及书库缩略图，检查外置 SVG 或内嵌 SVG 是否拉伸。审计仍要求原图、字体、正文插图不变，并核验新的封面标识、摘要、实际 XHTML／SVG 引用、语言和作者。metadata 的已审书名不是全书语义验收。