Linkfox Aigc Imagegen Brand Gene Extract

品牌基因样式提取（Brand Gene Extract）

根据商品图片与用户品牌基因参数，提取统一的品牌视觉语言（Brand DNA），输出结构化 JSON 供下游原子技能消费。

适用场景

不适用

• 已有完整 brandGeneJson 且无需变更时（直接复用，不重复调用本 skill）
• 纯背景替换/抠图/合成等图片编辑操作
• 非视觉类的品牌故事文案

输入参数

brandKey 字段说明

流水线步骤

步骤 1：参数解析与决策路由

• 输入：brandKey、images
• 操作：
  1. 解析 brandKey 中各字段值
  2. 主色决策：brandColor 非空 → 直接采用；为空 → 标记为"自动提取"
  3. 字体决策：fontStyle 非空 → 直接采用；为空 → 标记为"自动提取"
  4. 填充默认值：language 空则默认"英文"；platform 空则默认"亚马逊"；salesRegion 空则默认"美国"
  5. 将 images 转为可访问 URL 列表（imageUrlList），供步骤 3 传入 textgen
• 输出：决策路由表（哪些字段用户给定、哪些需自动提取）+ imageUrlList
• 用途：指导步骤 2 的 prompt 组装

步骤 2：组装品牌视觉基因提取 prompt

• 输入：步骤 1 的决策路由表、brandKey 全部字段

• 操作：将以下品牌视觉基因提取指令与 brandKey 参数拼装为完整 prompt，传入步骤 3：

  角色：你是顶尖品牌视觉专家和创意总监，基于商品图片与参数，构建一套统一的视觉语言，确保品牌在不同场景下的高度一致性。

  A. 统一视觉主题（UNIFIED_VISUAL_THEME）

  1. Brand Color（品牌主色）：

     • 定义一个具有"世界观"的核心色，而不仅仅是色板
     • 唯一性：全案只能定义 1 个核心 HEX 色值
     • 来源：必须考虑商品本身的颜色，具备极高审美
     • ⚠️ 黑白灰协议（CRITICAL）：除非商品本身为黑白灰，否则禁止使用黑白灰作为主色，必须输出具体色值（如 #EAF86C）

  2. 背景策略（Background Strategy）：必须完整输出以下 4 个子字段，缺一不可，每个都给出具体内容（不得留空、不得只写字段名）：

     • 背景策略-风格定义：根据 salesRegion 做文化本土化的整体环境风格。追求 100% 摄影级写实环境，严禁分层背景图层感，侧重生活方式与情感共鸣。 示例："现代北欧极简家居，原木与暖白色调，落地窗自然采光，符合美国中产审美"
     • 背景策略-场景关键词：逗号分隔的具体场景/道具关键词。 示例："原木长桌, 亚麻桌布, 绿植, 陶瓷器皿, 晨光"
     • 背景策略-光影：明确的光线方向、色温与氛围（这是必填字段，最易被漏，务必输出）。 示例："柔和自然侧光，暖色温 4000K，营造清晨慵懒氛围，轻微长投影增强立体感"
     • Brand Injection（品牌植入）：品牌主色 / Logo / 标识元素如何自然融入场景（这是必填字段，最易被漏，务必输出）。 示例："品牌主色作为抱枕/标签点缀色出现，Logo 以低饱和压印形式出现在道具上，不喧宾夺主"

  B. 绝对字体锁定（LOCKED_TYPOGRAPHY）

  1. 字体风格：从以下库中锁定唯一一种风格：

     • 几何无衬线体：Jost, League Spartan, Montserrat, Manrope, Outfit
     • 硬朗无衬线体：Bebas Neue, Oswald, Barlow Condensed, Anton, Fjalla One
     • 经典优雅衬线体：Bodoni Moda, Playfair Display, Prata, Cormorant Garamond, DM Serif Display
     • 圆润童趣字体：Nunito, Quicksand, Varela Round, Fredoka, Baloo 2
     • 俏皮手写风格: Pacifico, Permanent Marker, Amatic SC, Caveat, Luckiest Guy

  2. 颜色策略：

     • 标题色（Heading Color）：必须使用品牌主色或反白色；当标题底部颜色是品牌主色或同色系时，自动触发"灵活反白"；其次考虑使用品牌主色同色系颜色（禁止接近黑色的颜色，颜色不能过深）
     • 正文色（Body Color）：与标题色区分，确保可读性
     • ⚠️ 输出格式注意：颜色策略输出格式为 ["Heading Color"：颜色值] 和 ["Body color"：颜色值]，这是颜色定义而非文本内容

  3. 灵活反白权限：当使用深色背景或纯品牌色色块时，授权切换为哑光白（#FFFFFF）文本

  4. 排版限制：统一为非斜体（Non-italic），行距适中（standard leading）

  输出要求：严格按照下方「输出格式」输出完整 JSON，禁止输出任何解释性文字或代码块标记。

• 输出：完整的 textgen prompt 字符串

• 用途：作为步骤 3 的 prompt 输入

步骤 3：调用 linkfox-aigc-textgen 执行视觉推理

• 输入：步骤 2 的 prompt、步骤 1 的 imageUrlList
• 操作：按 linkfox-aigc-textgen SKILL.md 的调用方式调用 textgen 执行视觉推理。本步骤产出的内容要回读进上下文做字段提取（步骤 4），不链式拼进下游出图，因此用 textgen 的默认模式（不是 --content-only）：把下列字段写成 JSON 参数文件，经 --stdin 传入运行，再解析 stdout。<textgen根目录> 通过 skill:linkfox-aigc-textgen 解析其 SKILL.md 所在目录的绝对路径取得；<本skill根目录> = 本 SKILL.md 所在目录的绝对路径。

  ⚠️ 中间参数文件落到会话 data/ 目录。先取目录：

  DATADIR=$(python <本skill根目录>/scripts/save_brand_gene.py --datadir)
  

  ⚠️ 构造 brand_gene_params.json 必须用 Write 工具写到 $DATADIR/brand_gene_params.json（prompt 含引号、反斜杠等特殊字符，shell heredoc 内嵌 JSON 易解析失败）。若走命令行生成，只用 python -c 配合 json.dumps，不要手拼 JSON 字符串。

  python <textgen根目录>/scripts/aigc_textgen.py --stdin < "$DATADIR/brand_gene_params.json"
  

  JSON 参数文件包含以下字段：
  • prompt：步骤 2 组装的品牌视觉基因提取指令（含「输出格式」要求）
  • imageUrls：步骤 1 输出的 imageUrlList
  • model：GEM_3_1_PRO（需要视觉理解与复杂推理能力）
  • thinkingLevel：high
• 输出：解析 textgen stdout 得到 content（解析方式按 linkfox-aigc-textgen SKILL.md 的「输出契约」）。
• 用途：作为步骤 4 的组装原料

步骤 4：组装 brandGeneJson

• 输入：步骤 3 解析出的 content（换行可能为 ⏎ 占位符，提取前先还原为换行符）
• 操作：从该 content 中提取品牌视觉基因各字段，严格按照下方「输出格式」自行组装为 brandGeneJson
• 缺失字段兜底（强制）：组装后必须逐一核对「输出格式」中的全部字段是否齐全。若模型输出遗漏了某字段（实测最易漏 背景策略-光影 与 Brand Injection（品牌植入）），不得直接交付残缺 JSON，须按以下顺序兜底补齐：
  1. 优先从 content 其余文字中归纳推断该字段的合理值；
  2. 无可推断内容时，结合已确定的主色 / 风格定义生成一句与整体调性一致的兜底描述（如光影按"自然柔和侧光、暖色温、增强立体感"，品牌植入按"主色作点缀、Logo 低调融入道具"）。 最终 brandGeneJson 必须字段齐全，禁止出现缺字段或字段值为空串。
• 输出：brandGeneJson（长度为 1 的 JSON 列表，字段齐全）
• 落盘（强制）：组装完成后必须写入会话目录并保留路径供下游复用：
  1. 用 Write 工具将 brandGeneJson 写到 $DATADIR/brand_gene_assembled.json（DATADIR 同步骤 3）；或
  2. 运行落盘脚本（推荐，自动注册 _meta.json）：

     python <本skill根目录>/scripts/save_brand_gene.py "$DATADIR/brand_gene_assembled.json"
     

     stdout 会打印 Saved full response: <绝对路径> (<N> bytes)——将该绝对路径记入上下文，后续 S3 套图编排通过 --brand-gene-file <绝对路径> 或 manifest 的 brand_gene_json 消费。
• 用途：透传给下游出图链路（linkfox-aigc-imagegen-cloth 的种草图/卖点图/A+图 等类型 / linkfox-aigc-imagegen-product 等）作为 brandGeneJson 参数

产物落盘

路径协议：<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/（<session> 取自 SESSION_ID），与仓库 CLAUDE.md「输出文件位置」一致。

核心规则

A. 主色和字体逻辑

• 如果 brandColor 有值 → 输出 JSON 中 "brandColor (品牌主色)" 直接用该值
• 如果 fontStyle 有值 → 输出 JSON 中 "字体风格" 直接用该值
• 如果哪个值为空 → 该值用核心变量里的规则来自动提取

B. 其他值逻辑

"背景策略-风格定义"、"颜色策略-Heading" 等字段，默认都用核心变量的规则来获取，不受 brandKey 中 brandColor/fontStyle 的透传影响。

输出格式

严格按照以下 JSON 格式输出，输出为长度为 1 的列表：

[
  {
    "brandColor": {
      "brandColor (品牌主色)": "颜色名称与HEX值",
      "背景策略-风格定义": "基于 salesRegion 的风格描述",
      "背景策略-场景关键词": "关键词1, 关键词2, ...",
      "背景策略-光影": "光影氛围描述",
      "Brand Injection（品牌植入）": "品牌元素如何植入场景"
    },
    "fontStyle": {
      "字体策略": "选定的字体家族名称",
      "字体风格": "选定的具体字体名称",
      "颜色策略-Heading": "[\"Heading Color\"：颜色值/反白逻辑]",
      "颜色策略-Body/Sub": "[\"Body color\"：颜色值]",
      "灵活反白": "You are authorized to switch to Matte White (#FFFFFF) text whenever using a dark background or a solid brand-color panel.",
      "排版": "Non-italic, standard leading"
    }
  }
]

错误处理

调用方式

本 skill 由套图编排层在步骤三中调用，调用时机：

1. 首次调用：上下文中没有进行过品牌基因样式提取时
2. 重新调用：用户明确要求修改品牌基因（场景 G）时

复用规则：同一上下文中提取结果可复用，无需重复调用。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

• 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应401或402状态码
• 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

已知局限

• 品牌主色提取基于 GEM_3_1_PRO 对商品图片的视觉理解，可能与专业设计师判断有偏差
• 字体风格限定在预设的 5 类 25 款字体中，无法选择库外字体
• 背景策略的文化本土化依赖 salesRegion 的语义理解，非结构化地域数据库
• 品牌基因 JSON 必须经 save_brand_gene.py 落盘到会话 data/，不可仅存于对话上下文
• 依赖 linkfox-aigc-textgen skill 可用；若 textgen 调用失败，品牌基因提取无法完成