brand-kit

name	brand-kit
description	店铺品牌视觉锁定。一份 brand.yaml 定义模特、色温、构图、留白与文案语气，所有生图技能读它，保证跨 SKU 视觉统一。当用户说「统一风格」「同一个模特」「店铺调性」「品牌规范」「几百个 SKU 看起来像一家店」时使用。

brand-kit — 店铺视觉统一

一套图和一家店的区别，在于第 200 个 SKU 是否还长得像第 1 个。

靠每次重写 prompt 做不到这件事——人会忘、会改词、会换说法。 靠一份可复用的规范文件才做得到。

---

一、它解决什么

没有 brand-kit	有 brand-kit
每个技能各写各的模特描述	一处定义，全部技能读同一份
同店铺 SKU 模特脸不一样	锁定同一张脸参考图
色温忽冷忽暖、背景忽深忽浅	光位、色调、背景写死在规范里
改一次调性要翻 26 个 prompt	改一行 yaml

---

二、快速上手

# 1. 生成模板
node scripts/brand.mjs --init > brand.yaml   # 或直接改随技能分发的 examples/brand.yaml

# 2. 改成自己店铺的（见下方字段说明）

# 3. 看它会给某个技能追加什么
node scripts/brand.mjs --brand examples/brand.yaml --for flat-lay

# 4. 生成时带上，自动追加
node scripts/gen.mjs --task flat-lay --brand examples/brand.yaml \
  --prompt 'On-model photo of the olive cable-knit sweater.' \
  --images garment.jpg pose.jpg --save out/sku001.jpg

--brand 对 gen.mjs / run_loop.mjs / batch.mjs / video.mjs 都有效。 整批出图时加上它，一整批的视觉基调就锁住了。

---

三、字段

brand:
  name: 示例品牌
  tone: quiet minimalist, warm and lived-in, never glossy or commercial

model:
  reference: assets/model/face-a.jpg          # 锁脸
  description: East Asian woman, late twenties, natural makeup
  body: slim, height around 168cm

photography:
  background: seamless off-white studio backdrop, RGB 248 248 246
  lighting: soft large softbox from camera left, gentle fill, no hard shadows
  camera: 85mm equivalent, eye level, shallow depth of field
  grade: neutral white balance around 5200K, low contrast
  crop: full body with headroom, product centered

layout:
  margin: at least 8% empty margin on all sides
  typeface: clean sans-serif, no decorative fonts

forbid:
  - no text or watermark
  - no oversaturated colors

compliance:
  platform: amazon

只有相关的段落会进 prompt：详情页技能读 layout 但不读 model， 去水印技能两个都不读。完整对照表见 references/brand-schema.md。

---

四、写好规范的三条经验

1. 用英文写画面约束，中文写备注。 图像模型对英文画面词的响应更稳定， tone / background / lighting 这些直接写英文；name 这类只给人看的随意。

2. 写物理量，不写形容词。 warm lighting 模型每次理解都不同； neutral white balance around 5200K, soft large softbox from camera left 才可复现。 色值直接写 RGB。

3. forbid 比 tone 更管用。 正面描述容易被稀释，禁止项是硬约束。 「不要什么」往往比「要什么」更能稳住风格。

---

五、锁脸

model.reference 给一张清晰正脸图，它会作为最后一张参考图传给模型， 配合 prompt 里的 Model must stay consistent 一起生效。

要求	说明
正脸、清晰、光线均匀	侧脸和逆光锁不住
只有脸，别带复杂背景	背景会污染生成
分辨率够	至少 512×512
全店固定一张	换图等于换人

找不到文件时只警告不报错，生成照常进行——少一张参考图，脸就由 prompt 描述决定。

---

六、执行流程

1. 用户说「统一风格」时，先问三件事：模特要不要锁死、主色调、有没有必须避免的元素。
2. --init 生成模板，按回答填。
3. 拿 1 个 SKU 跑一次带 --brand 和不带的对比，让用户确认调性对了。
4. 确认后再跑整批——规范是给整批用的，单张看不出价值。
5. 之后每次出图都带 --brand。不带就等于没有规范。

---

七、常见问题

现象	原因	怎么办
加了 brand 反而更不像	描述互相打架（比如 tone 说极简，photography 写戏剧光）	通读一遍，删掉矛盾项
模特脸还是会变	参考图不是正脸，或分辨率太低	换一张标准正脸图
prompt 太长被截断	规范写太细	只保留真正影响视觉的项，删掉无关段落
详情页图带上了模特描述	用了 --for 之外的方式手工拼接	用 --brand，它会自动按技能过滤

---

Tips

• 规范进版本库，和商品数据放一起。它是资产，不是临时文件。
• 一个店铺一份。多店铺别共用一份改来改去，各存各的。
• 换季可以分支：brand-aw25.yaml、brand-ss26.yaml，切换只是换个文件名。