story-cover:小说封面生成
根据书名和题材生成包含书名、笔名的完整封面,让读者一眼看出题材和氛围。
仅提示词模式:用户只要提示词,或 story-publish 选了仅提示词时,只做 Step 1-3,交付完整提示词,不需要生图工具、API Key 或输出目录;要封面图才继续 Step 4-6。由 story-publish 调用时,它传来的已确认书名、简介、笔名、平台和题材不再重问;结束时返回完整提示词原文,生图成功再附图片路径和质量检查结果,失败就说明原因。
生成通路
- 内置生图(优先):当前会话可调 Codex
$imagegen/image_gen或 Antigravitygenerate_image/image-generator时,直接调用生成并保存,无需OPENAI_API_KEY或GPT_IMAGE_API_KEY,不跑curl。 - API 回退:仅在无内置工具或用户指定 API 时使用,需
GPT_IMAGE_API_KEY;变量和命令见 references/api-fallback.md,走该通路再读。工具缺失不等于订阅不支持生图;内置失败先报错,不静默切到收费 API。
生成流程
Step 1:收集信息
先找当前书:项目根 .active-book 指向项目内现有目录时就是当前书;否则从项目根往下最多 4 层找(跳过 . 开头的目录、node_modules、拆文库/、对标/),含 追踪/、正文/、设定/ 子目录,或含 正文.md,或同时含 设定.md 与 小节大纲.md 的是书目录,找到多本时请作者选择。有 正文/ 或 设定/ 子目录的是长篇,其余为短篇。找到后读:
- 长篇:
设定/题材定位.md「基本信息」的书名、题材类型、目标平台、核心梗; - 短篇:
设定.md「基本信息」的标题、目标平台、目标情绪,以及「一句话梗概」「这篇用的套路」(旧书叫「题材招式」)。
已有或调用方传入的已确认字段不再问;笔名没有明确提供时才问。没有书目录或缺项时,用宿主可用的提问方式一次问齐缺少的书名、笔名、目标平台。
书名和笔名是封面必需信息:缺任一时先请作者补全,不得编造或留空。
选填:参考图 REF_IMAGE(本地路径或 URL)、风格偏好;参考图的用法见 Step 4。
保存位置:有书目录时存到 {书目录}/封面/,不用问;没有书目录时用 ./covers/{书名}/封面/。下文 BOOK_DIR 指 封面/ 的上一层。
按目标平台定比例和上传尺寸:番茄、起点、七猫常用 600×800(3:4),晋江常用 200×280(约 5:7),未说明规格的平台按竖版 3:4 或 2:3 交付;作者给出上传像素时按该尺寸导出,避免二次裁剪切掉书名或笔名。平台画风见 references/cover-styles.md「平台风格」。
Step 2:题材判定
在 references/cover-styles.md 的「风格库」里选一个题材:
仅提示词模式没有题材依据时先问作者,不用下面第 2 条的「都市」兜底。
- 有「题材类型」(长篇)或梗概、套路(短篇)时,按内容选风格库中最接近的一节。
- 没有,或对不上风格库任何一节(如年代、种田、无限流、电竞)时,用书名(必要时简介)对照「题材推断规则」:只命中一个题材就用它;命中多个按该表下方的优先级取一;都没命中先用「都市」。
- 第 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 / 5:7 / 2:3] ratio, keep title and author name inside the central safe area away from edges (inner ~85%), no watermark
仅提示词模式在这里交付 1-3 个完整提示词方案后结束;还没确认的画面细节写成可选方向,不当成小说里的事实。
写法要点:
- 人物描述写清服饰、姿态、发型、表情、道具,不要只写
a man; - 背景分三层:前景人物或道具,中景场景,远景氛围;
- 光效写清光源方向和颜色,如
dramatic golden light from above; - 用
digital painting style,不用photo,避免真人照片感。
Step 4:选方案并生成
先从「构图变体」里挑 2-3 种适合本题材的构图,每种用一句话描述画面(构图、主色、书名字体),连同 Step 2 定的题材一起给作者挑。作者选定后只生成那一张;作者说「都出」时每个方案单独生成一次。
内置生图(Codex / Antigravity,优先)
- 用 Step 3 的完整提示词调用
image_gen(Codex)或generate_image/image-generator(Antigravity)。比例和安全区写进提示词,不传GPT_IMAGE_MODEL、GPT_IMAGE_SIZE、response_format等 API 参数。 - 有
REF_IMAGE时,本地文件先载入会话(或传给image-generator);URL 先下载再载入。说明是编辑目标还是风格参考,并列出须保持的内容。 - 先创建
BOOK_DIR/封面/,把生成的图片复制为封面_vN.png(N自增不覆盖旧版);保留$CODEX_HOME/generated_images/等原文件,并存同名.prompt.txt(有参考图再存.ref.txt)。确认可读后把原图绝对路径交给 Step 5。
API 回退
读 references/api-fallback.md,按其中的环境变量和命令生成;没有参考图走文生图,有参考图走图生图。生成后把原图绝对路径交给 Step 5。
Step 5:导出平台上传尺寸(平台有固定像素时)
平台有固定上传像素(番茄 600×800)时,把原图居中裁剪+缩放到精确尺寸,保持画面比例,原图保留并另存 _上传 版。SRC 填 Step 4 的原图绝对路径,TARGET 填 Step 1 的上传尺寸,不依赖上一段 shell 的临时变量:
SRC='<Step 4 生成的原图绝对路径>'
TARGET='<Step 1 确定的平台上传尺寸;无则留空>'
[ -f "$SRC" ] || { echo "封面原图不存在: $SRC" >&2; exit 1; }
if [ -n "$TARGET" ] && [ -f "$SRC" ]; then
UP="${SRC%.png}_上传.png"; W="${TARGET%x*}"; H="${TARGET#*x}"
if command -v magick >/dev/null 2>&1; then M=magick
elif command -v convert >/dev/null 2>&1; then M=convert; else M=""; fi
if [ -n "$M" ]; then
"$M" "$SRC" -resize "${W}x${H}^" -gravity center -extent "${W}x${H}" "$UP" # 缩放填满后居中裁
elif command -v sips >/dev/null 2>&1; then
cp "$SRC" "$UP"
sw=$(sips -g pixelWidth "$UP" | awk '/pixelWidth/{print $NF}')
sh=$(sips -g pixelHeight "$UP" | awk '/pixelHeight/{print $NF}')
if [ $((sw*H)) -ge $((sh*W)) ]; then sips --resampleHeight "$H" "$UP" >/dev/null
else sips --resampleWidth "$W" "$UP" >/dev/null; fi
sips -c "$H" "$W" "$UP" >/dev/null # sips -c 是 高 宽,居中裁
else
echo "无 magick/convert/sips,跳过;手动把 $SRC 居中裁剪+缩放到 $TARGET 再上传" >&2
fi
[ -f "$UP" ] && file "$UP"
fi
提示词中的中心安全区用于减少裁切风险;导出后仍按 Step 6 检查书名和笔名是否完整。
Step 6:质量检查 + 迭代
| 检查项 | 标准 |
|---|---|
| 文字渲染 | 书名、笔名清晰可辨,字体风格匹配题材 |
| 题材匹配 | 视觉风格与本书题材一致 |
| 构图合理 | 主体突出,文字不遮挡核心画面 |
| 平台适配 | 符合目标平台的封面风格 |
| 平台尺寸 | 比例与平台一致;缩放到上传尺寸后书名、笔名完整可见、未被裁切 |
未达标或作者希望调整时,可更换构图、色调、字体或平台风格重出;生僻字多次渲染仍错笔时,可征询作者改出无字底图再自行加字。
交付时这样告诉作者;命令、环境变量和接口报错不贴给作者,失败时用一句话说原因和办法(如「生图接口没配好,需要先设置 API Key」):
封面做好了:`{封面图路径}`{;{平台}上传版({上传尺寸}):`{上传版路径}`}
这版的思路:{构图 + 色调 + 书名字体,一句话}
想调的话可以说:{2-3 个具体方向,如「换成人物特写」「书名改成毛笔字」}
