Add Chinese covers and source-bound library edition metadata
This commit is contained in:
Kai Tan
@@ -110,3 +110,42 @@ Mac 沙箱中 Calibre 的 Qt 渲染可能需要允许进程运行。QA 使用项
|
||||
无法可靠绑定的目录条目仅翻译标签，不改写猜测的章节正文；具体条目记录在 `book_structure.json` 的 `navigation_titles[].binding_note`。这类条目需要检查章节标题是否一致，不能视为全书标题同步已经通过。索引、版权、注释全文仍遵守原有跳过策略；导航中这些页面的名称可以翻译。
|
||||
|
||||
后续扫描 PDF/OCR 大版本的图文、结构与目录方案见 [路线图](doc/OCR_EPUB_ROADMAP.md)。
|
||||
|
||||
### 中文封面与书库 metadata（v0.14）
|
||||
|
||||
新增可选的版本封装步骤，可给已有完整译本补中文封面，无需再调用正文翻译模型。书库标题采用 `中文书名【中文版 · r1】`／`中文书名【中英对照版 · r1】`；封面也必须显示对应版本与修订号。两版使用不同 UUID，原作标识转存 `dc:source`，避免沿用英文版 ISBN／Calibre UUID。原作标题、作者、出版社、日期与生图来源保存在 OPF 的 edition 记录中。本文件标为 AI 译本，不冒用正式中文出版版的译者、出版社或 ISBN。
|
||||
|
||||
1. 在 edition JSON 固定原作标题／作者（可附标识符）、中文书名、`title_status`、证据网址和 `edition_revision`。正式出版译名优先出版社／国家图书馆记录；找不到时使用 `project`，不得标成权威。`config/editions/gambling-man.json` 采用商周出版译名；`house-of-huawei.json` 暂为项目译名。繁简转换或删改正式译名须另作说明。
|
||||
2. 提取参考封面和生图任务：
|
||||
|
||||
```bash
|
||||
.venv/bin/python scripts/localize_edition.py prepare input/book.epub \
|
||||
--config config/editions/book.json --mode target_only --work .work/book-cover/chinese
|
||||
```
|
||||
|
||||
3. 由 `epub-translate` skill 调用当前可用生图工具，编辑原封面，另存 PNG／JPEG。分别制作中文版与双语版，版本徽标用朱红／深蓝区分。逐字核对书名、作者、版本徽标和修订号，检查全尺寸与书库缩略图。审查记录须包含实际图片 SHA，示例：
|
||||
|
||||
```json
|
||||
{"cover_sha256":"图片文件的SHA256", "mode":"target_only", "title_zh":"中文书名", "edition_revision":"r1", "visual_review":"passed", "provider":"Codex built-in imagegen", "model":null, "review_notes":"已逐字查看书名、作者及版本徽标"}
|
||||
```
|
||||
|
||||
4. 对**已有译本**封装并审计：
|
||||
|
||||
```bash
|
||||
.venv/bin/python scripts/localize_edition.py apply output/translated_book.epub \
|
||||
--config config/editions/book.json --mode target_only \
|
||||
--cover .work/book-cover/chinese/cover.png --review .work/book-cover/chinese/review.json \
|
||||
--output output/editions/translated_book_r1.epub --work .work/book-cover/chinese
|
||||
```
|
||||
|
||||
原始图片／字体字节保留；新增封面更新 EPUB2 `meta name=cover`、EPUB3 `cover-image` 和 XHTML／SVG 引用；外置 SVG 包装器另存副本。没有封面时新增首个 spine 封面页。修正封面 SVG 强制拉伸，保持图片比例。目录和正文插图保持原样。`edition-qa.json` 包含原／新版差异；headless QA 继续检查封面绑定、图片摘要、metadata、目录和正文完整度。
|
||||
|
||||
自动流水线可给 `main.py` 或 `scripts/agent_book.py build` 加 `--edition-config config/editions/book.json`。在 JSON 中另加 `covers`：
|
||||
|
||||
```json
|
||||
{"covers":{"target_only":{"image":"../../.work/book-cover/chinese/cover.png","review":"../../.work/book-cover/chinese/review.json"},"bilingual":{"image":"../../.work/book-cover/bilingual/cover.png","review":"../../.work/book-cover/bilingual/review.json"}}}
|
||||
```
|
||||
|
||||
路径相对于 JSON 文件；常规译本保留，另生成 `edition_*.epub`。缺少已审封面会报错，不自动使用另一个版本的图片。基础封装不新增依赖、无网络请求；生图和书目检索由 skill 编排。
|
||||
|
||||
2026-10-08 接入核实：本机 Codex 使用 ChatGPT 登录，缓存目录没有可选择的 image 模型。官方模型目录提供 `gpt-image-2.5-sunburst`／`gpt-image-2.5-flare`，但[ChatGPT OAuth API 路径暂不支持图片生成](https://developers.openai.com/siwc/token-sharing-open-source/preview-limitations)。本轮实际使用 Codex 内置 imagegen 成功生成两版；该工具不公开模型 ID／选择参数，因此记录 `model: null`，不能宣称使用 GPT-Image-2.5。后续运行先检查当时的官方支持情况和工具能力；不要读取或转用私有 OAuth token 绕过限制，也不自动改用付费 API。
|
||||
|
||||
Reference in New Issue
Block a user