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
@@ -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 的已审书名不是全书语义验收。