生日海报（3D 浮雕）

一、工作流（四步）

照片要求：正脸、光线均匀、分辨率 ≥ 600px——这决定面部相似度上限。

• 收材料：主角正脸清晰照 1 张（必填，孩子/成人均可）+ 参数（年龄/名字/标语/服装/配色，缺省见 examples JSON）。

• 出提示词：python scripts/render.py <config.json> --out prompt.txt，检查字段已替换、无残留 {XXX}。

• 生成（ImageGen 图生图，约 5-10 积分/张）：

• image1 = 主角照片，input_fidelity: "high"（保面部是硬要求）

• size: "1024x1536"（模型最大竖幅，2:3）

• quality: "high"

• 生成 2-3 张候选：手部、雕刻文字是主要翻车点，多 roll 挑最好。

• 裁切与净化（一条命令两件事）：

• python scripts/render.py <config.json> --crop 生成的图.png --out poster_3x4.jpg

• 自动：先裁底部 7% AI 水印，再裁 3:4（顺序反了比例会破，实测 0.806≠0.75）；裁高从顶部裁（文字沉底布局）。

• 交付前必查：雕刻文字逐字符正确、手指五指自然、数字内无多余字母、数字顶部未被裁。

二、参数契约

{
  "photo": "",              // 正脸照路径，必填（孩子/成人均可）
  "subject": "",            // 可选：主体描述。缺省="一个快乐的{age}岁孩子"；
                            // 成人版示例："照片中的男士（保持面部特征、发型与眼镜一致），一位沉稳从容的45岁男士"
  "input_fidelity": "high",
  "age": 2,                 // 雕刻的巨型数字
  "name": "MUNONYE",        // 墙面雕刻名，逐字符生效，拼写错误=废稿
  "chapter_line": "第二章",  // 中间行，可用 Chapter Two
  "tagline": "365 天的奇迹", // 底行标语
  "outfit": "穿着乳白色 T 恤和粉色牛仔背带裤",
  "decor": "柔和的粉色"      // 气球花束主色
}

三、人群预设（presets/，按人群一键套）

用法：JSON 缺的字段从预设拷，{AGE}/{DAYS}/{NAME} 按人填。老人版是结构差异（祝寿元素替代气球），不只是换色。

四、踩坑清单（实测沉淀）

• 模型没有原生 3:4：别在提示词里写"3:4 比例"指望生效，size 只有 1024x1024 / 1024x1536 / 1536x1024。走 1024x1536 + 裁切；模板里"上下各预留 8% 安全区"就是为裁切保文字。

• 提示词要口语直给：机翻腔（如"礼服内饰"）会让模型理解跑偏，写"场景内饰布置"这类直白描述。

• 手是主要翻车点：模板里"五指、姿态放松"必须保留；手废了就重 roll，别交付。

• 面部不像：input_fidelity 已是最高，问题在照片——换正脸、光线好的照片，不是调参数。

• 雕刻文字错字：重 roll 2-3 次；仍错就把文字行单独放大描述，或后期 HTML 排版贴字。

• 无标识铁律：成品任何位置不得出现 WorkBuddy / AI 字样（用户长期要求，见 strip 脚本 + 裁水印流程）。

• 生成必须用模板全文，禁止手抄缩写：10 岁实测中手抄漏掉"上下预留 8% 安全区"一句，数字顶端直抵上缘（y=5 即有笔画），裁切必伤。模板已内置双约束：文字沉底（下方 1/4）+ 上下 8% 安全区，缺一不可。

五、变体：里程碑编年版（成人/老人高惊喜版）

墙面文字从 3 行祝福换成人生编年（只有家人知道的坐标，惊喜浓度最高）：

生日快乐
2005 · 第一份工资
2012 · 她说好
2016 · 家里多了个小家伙
2026 · 仍在热爱工作

写法要点（实测 45 岁案例一次通过）：

• 不要塞进模板的 chapter_line——模板写死"三行文字"，5 行内容会挤爆；改用逐行编号描述（"共 N 行金色雕刻文字…第一行：…第二行：…"），参考 examples/prompt-milestone.txt

• 年份事件一行一条，每条 ≤10 字，短句比长句出字准

• 模板的三行约束（沉底/安全区/逐字符准确）全部保留

• 事件内容让用户自己给，AI 编造人生事件是事故

六、边界

• 只做「照片 → 数字 3D 场景」这一种图生图样式；不做人像精修、不做多图拼版（那是 hsf-photo-poster 的活）。

• 成人版已支持（45 岁实测通过）：JSON 加 subject 字段覆盖默认的孩子措辞，配沉稳色调（暖金/深咖啡）比粉色调合适；文案可用「第 N 章 / N×365 天的传奇」。

常见问题