Cover Title Overlay

封面标题叠加

核心前提：不要用生图模型

生图/以图生图模型无法在原图上加字，它只能整张重画。底图送进去之后，分辨率、景别、光影、雾气浓淡每次都会漂，提示词写得再细也约束不住。

必须用本 skill 的脚本做像素叠加。 脚本只合成一个文字图层，底图其余像素原样保留，并在每次运行后校验这一点。

快速开始

只有两行标题是必填的：

python .cursor/skills/cover-title-overlay/scripts/make_cover.py "自动习惯设计" "系统｜01"

省略时的默认行为：

• --ratio 省略 → 按 16:9
• --base 省略 → 用 skill 自带的对应比例底图（见下表）
• -o 省略 → 写到当前目录的 image-outputs-YYMMDD-HHMMSS.png，例如 image-outputs-260819-135556.png

底图随 skill 一起存放，路径不依赖当前目录，所以在任何目录下跑都能拿到默认底图。

16:9 与 21:9

两种比例都支持，用 --ratio 选：

python .cursor/skills/cover-title-overlay/scripts/make_cover.py "自动习惯设计" "系统｜01" --ratio 21:9

表中路径相对本 skill 目录。--ratio 只决定用哪张底图，不影响排版计算。显式给了 --base 就以它为准，此时 --ratio 仅用于比例校验：底图实际比例与之不符会打印提醒，但不会中断出图。

两种比例共用同一套字号规则（字高 = 画面高度的 14.16%），所以标题占画面的分量一致。21:9 更矮，字的绝对像素会比 16:9 小一些，这是预期行为。

需要固定文件名时再显式给：

python .cursor/skills/cover-title-overlay/scripts/make_cover.py "自动习惯设计" "系统｜01" \
  -o "image-outputs-20260819/ep1.png"

用在别的项目时给绝对路径调用脚本。默认底图照样能用，需要换底图才传 --base：

python /abs/path/to/.cursor/skills/cover-title-overlay/scripts/make_cover.py "其他项目" "封面｜A" \
  --base "assets/mybase.png" -o "out/cover.png"

底图不限尺寸和比例。所有排版量都按底图高度的百分比计算，--ratio 之外的比例（如 4:3、竖版）直接传 --base 也能出图。

输出：

base: .../cover-title-overlay/cover/封面16x9.png
output: image-outputs-260819-135556.png
size: 1672x941 (与底图一致)
title_box: x408-1270 y316-641
background: 标题区域以外 0 像素改动
font: NotoSerifSC-VF.ttf @ 142.5px
ink_h_ratio: 0.1413 (目标 0.1416)

看到 background: 标题区域以外 0 像素改动 才算成功。脚本会自己校验，出问题直接非零退出并说明原因，不会静默产出错图。

标题太长时：超出画面宽度直接报错，占到 92% 以上会打印提醒但仍然出图。两种情况都应该改短标题，不要去缩字号。

锁定的排版参数

这些数值是从一张模型生成的参考封面上实测反推的，已经写死在脚本里。不要为了迁就某个标题去改它们，否则各集封面就不一致了。

两行用同一个字号。字数少的那行会拉开字距去对齐另一行的宽度，而不是把字放大。所以「系统｜01」看起来比「自动习惯设计」松，是设计如此。

一次做多集

分别调用即可，底图和参数相同，各集封面自然统一。多集建议显式给 -o，否则默认名只带时间戳，分不清哪集：

python .cursor/skills/cover-title-overlay/scripts/make_cover.py "自动习惯设计" "系统｜01" -o "out/ep1.png"
python .cursor/skills/cover-title-overlay/scripts/make_cover.py "落地用 Skill" "系统｜02" -o "out/ep2.png"

生成同风格底图时：一次最多 2 张

用生图模型做「风格接近、构图不同」的新底图时，同一轮最多并发生成 2 张。4 张带参考图大约要 7 分钟，工具调用会被标成 interrupted：图其实已经写到 Cursor 的 assets 目录，但后续裁切、拷贝不会跑。

同一轮 2 张生成完，立刻裁到对应底图尺寸并写入 cover/：16:9 为 1672x941，21:9 为 1915x821。用户要 4 张就分两轮。生图工具没有 21:9 选项时，先出 16:9，再居中裁成 21:9。

若仍然 interrupted，不要重做，先导入已生成的文件：

python .cursor/skills/cover-title-overlay/scripts/import_generated.py
python .cursor/skills/cover-title-overlay/scripts/import_generated.py --ratio 21:9

依赖与资源

只需要 Pillow。缺失时装它：

python -m pip install pillow

如果所在环境需要走代理，代理地址在项目根目录 .skill.env 的 SKILL_PROXY（不要打印它的值）。

底图和字体都随 skill 存放，换电脑不需要额外准备：

cover/封面16x9.png         无文字底图，16:9
cover/封面21x9.png         无文字底图，21:9
assets/NotoSerifSC-VF.ttf  字体，约 24MB

任何一个默认文件缺失，脚本都会明确报错而不是静默换用别的图。想临时换字体用 --font，但字形会和既有封面不一致。

字体是 Noto Serif SC 2.02，版权 Adobe，SIL Open Font License 1.1，许可全文见 assets/OFL.txt。原样打包未作修改。