story-cover

story-cover：小说封面生成

根据书名和题材生成包含书名、笔名的完整封面，让读者一眼看出题材和氛围。

---

生成通路

• Codex 内置（优先）：当前 Codex CLI 会话可调用 $imagegen / image_gen 时，直接调用工具生成并保存，无需 OPENAI_API_KEY 或 GPT_IMAGE_API_KEY，不运行 curl。
• API 回退：仅在会话没有内置工具或用户明确指定 API 时使用，需要 GPT_IMAGE_API_KEY；环境变量和命令在 references/api-fallback.md，走这条通路时再读。工具缺失不等于 Codex 订阅不支持生图；内置调用失败时先报告错误，不静默切换到可能收费的 API。

生成流程

Step 1：收集信息

先找当前书：项目根 .active-book 指向项目内现有目录时就是当前书；否则从项目根往下最多 4 层找（跳过 . 开头的目录、node_modules、拆文库/、对标/），含 追踪/、正文/、设定/ 子目录或 正文.md、设定.md 文件的是书目录，找到多本时请作者选择。有 正文/ 或 设定/ 子目录的是长篇，有 正文.md 或 设定.md 的是短篇。找到后读：

• 长篇：设定/题材定位.md「基本信息」的书名、题材类型、目标平台、核心梗；
• 短篇：设定.md「基本信息」的标题、目标平台、目标情绪，以及「一句话梗概」「题材招式」。

已有字段不再问；笔名不在这些文件里，每次都要问。没有书目录或缺项时，用宿主可用的提问方式一次问齐：书名、笔名、目标平台。

书名和笔名是封面必需信息：缺任一时先请作者补全，不得编造或留空。

选填：参考图 REF_IMAGE（本地路径或 URL）、风格偏好；参考图的用法见 Step 4。

保存位置：有书目录时存到 {书目录}/封面/，不用问；没有书目录时用 ./covers/{书名}/封面/。下文 BOOK_DIR 指 封面/ 的上一层。

按目标平台定比例和上传尺寸：番茄上传 600×800，比例 3:4，出图比例不符时平台再次裁剪可能切掉书名或笔名；其他平台按竖版 2:3 交付，作者给出平台上传像素时按该尺寸导出。各平台的画风关键词见 references/cover-styles.md「平台风格」。

Step 2：题材判定

在 references/cover-styles.md 的「风格库」里选一个题材：

1. 有「题材类型」（长篇）或梗概、题材招式（短篇）时，按内容选风格库中最接近的一节。
2. 没有，或对不上风格库任何一节（如年代、种田、无限流、电竞）时，用书名（必要时简介）对照「题材推断规则」：只命中一个题材就用它；命中多个按该表下方的优先级取一；都没命中先用「都市」。
3. 第 2 条推断出的题材，在 Step 4 给作者看方案时一并说出来，作者可以改。

Step 3：构建提示词

提示词 = 文字层 + 风格层 + 画面层。设计指令用英文，书名和笔名保留作者提供的原文。所选题材的字体、标签、色彩、人物、背景、光效都在「风格库」同一节里查。

文字层：GPT-Image-2 可直接渲染中文。书名在上方居中，用该题材的书名字体；笔名在下方居中，用该题材的笔名字体。笔名要和书名风格呼应、清晰可读而不抢焦点：

• 大小用 small；位置 at bottom center，与画面底部留出间距；
• 必须带一种装饰：线条、边框、小图标或光效；
• 颜色与背景形成对比但不刺眼。

风格层：目标平台在「平台风格」表里有对应时，取它的关键词串；没有对应（如黑岩、红果、小程序）时省掉这一层，只靠题材风格。

画面层：题材的风格标签、人物、背景、色彩、光效，加上一种构图（见「构图变体」）。

完整提示词模板（唯一一份，示例和改版都按它拼）：

Chinese web novel cover design, [平台风格].
Title text '{书名}' at top center in [书名字体].
Author name '{笔名}' at bottom center in [笔名字体].
[题材风格标签]. [构图关键词]. [人物描述]. [背景描述].
[色彩指令]. [光效指令].
Professional book cover, high detail digital painting, portrait [平台比例：番茄=3:4，默认=2:3] ratio, keep title and author name inside the central safe area away from edges (inner ~85%), no watermark

写法要点：

• 人物描述写清服饰、姿态、发型、表情、道具，不要只写 a man；
• 背景分三层：前景人物或道具，中景场景，远景氛围；
• 光效写清光源方向和颜色，如 dramatic golden light from above；
• 用 digital painting style，不用 photo，避免真人照片感。

Step 4：选方案并生成