linkfox-aigc-imagegen-brand-gene-extract

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

Brand Gene Style Extraction (Brand Gene Extract)

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

Based on product images and user-provided brand gene parameters, extract a unified brand visual language (Brand DNA) and output structured JSON for consumption by downstream atomic skills.

适用场景

Applicable Scenarios

场景	说明
套图编排调用	被 `linkfox-aigc-imagegen-cloth` / `linkfox-aigc-imagegen-product` （套图编排路径）在步骤三中调用，为整套图定义统一视觉基因
品牌基因变更	用户修改主色调/字体/平台/地区后重新提取
首次品牌定义	上下文中尚无品牌基因结果时，首次提取

Scenario	Description
Image Layout Call	Called by `linkfox-aigc-imagegen-cloth` / `linkfox-aigc-imagegen-product` (image layout path) in Step 3 to define a unified visual gene for the entire set of images
Brand Gene Change	Re-extract after users modify main color/font/platform/region
Initial Brand Definition	First extraction when no brand gene results exist in the context

不适用

Inapplicable Scenarios

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

When a complete brandGeneJson already exists and no changes are needed (reuse directly, do not call this skill repeatedly)
Pure background replacement/image matting/synthesis and other image editing operations
Non-visual brand story copywriting

输入参数

Input Parameters

参数	类型	默认	说明
images	list[image]	—	用户上传的商品图片列表（至少 1 张），用于分析商品色彩与气质
brandKey	object	—	用户输入的品牌基因信息（见下方字段说明）

Parameter	Type	Default	Description
images	list[image]	—	List of product images uploaded by the user (at least 1 image), used to analyze product colors and temperament
brandKey	object	—	Brand gene information entered by the user (see field description below)

brandKey 字段说明

brandKey Field Description

字段	类型	默认	说明
brandColor	string	""	品牌主色（HEX 值），非空时直接使用，为空时自动提取
fontStyle	string	""	字体风格，非空时直接使用，为空时自动提取
brandName	string	""	品牌名称，用于品牌植入策略
language	string	"英文"	目标市场语言
platform	string	"亚马逊"	发布平台（Amazon/TikTok/Shopee 等）
salesRegion	string	"美国"	销售地区/国家

Field	Type	Default	Description
brandColor	string	""	Brand main color (HEX value), use directly if non-empty; auto-extract if empty
fontStyle	string	""	Font style, use directly if non-empty; auto-extract if empty
brandName	string	""	Brand name, used for brand implantation strategy
language	string	"English"	Target market language
platform	string	"Amazon"	Publishing platform (Amazon/TikTok/Shopee, etc.)
salesRegion	string	"United States"	Sales region/country

流水线步骤

Pipeline Steps

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

Step 1: Parameter Parsing and Decision Routing

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

Input:
```
brandKey
```
,
```
images
```
Operations:
1. Parse the values of each field in
```
brandKey
```
2. Main Color Decision: If
```
brandColor
```
  is non-empty → use directly; if empty → mark as "auto-extract"
3. Font Decision: If
```
fontStyle
```
  is non-empty → use directly; if empty → mark as "auto-extract"
4. Fill Default Values: If
```
language
```
  is empty, default to "English"; if
```
platform
```
  is empty, default to "Amazon"; if
```
salesRegion
```
  is empty, default to "United States"
5. Convert
```
images
```
  to a list of accessible URLs (
```
imageUrlList
```
  ) for passing to textgen in Step 3
Output: Decision routing table (which fields are provided by the user, which need auto-extraction) +
```
imageUrlList
```
Purpose: Guide prompt assembly in Step 2

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

Step 2: Assemble Brand Visual Gene Extraction 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 输入

Input: Decision routing table from Step 1, all fields of
```
brandKey
```
Operations: Assemble the following brand visual gene extraction instructions with
```
brandKey
```
parameters into a complete prompt, and pass it to Step 3:
Role: You are a top brand visual expert and creative director. Based on product images and parameters, build a set of unified visual language to ensure high brand consistency across different scenarios.

A. UNIFIED_VISUAL_THEME
1. Brand Color:
  - Define a core color with a "worldview", not just a color palette
  - Uniqueness: Only 1 core HEX color value can be defined for the entire project
  - Source: Must consider the product's own color, with extremely high aesthetics
  - ⚠️ Black & White & Gray Protocol (CRITICAL): Unless the product itself is black, white, or gray, it is forbidden to use black, white, or gray as the main color. A specific color value (e.g., #EAF86C) must be output
2. Background Strategy: Must fully output the following 4 sub-fields, no exceptions, each with specific content (no empty fields, no field names only):
  - Background Strategy - Style Definition: Create a culturally localized overall environmental style based on
```
salesRegion
```
    . Pursue 100% photo-realistic environment, strictly prohibit layered background texture, focus on lifestyle and emotional resonance. Example:
```
"Modern Nordic minimalist home, log and warm white tones, natural lighting through floor-to-ceiling windows, in line with American middle-class aesthetic"
```
  - Background Strategy - Scene Keywords: Specific scene/prop keywords separated by commas. Example:
```
"log long table, linen tablecloth, green plants, ceramic utensils, morning light"
```
  - Background Strategy - Light & Shadow: Clear light direction, color temperature and atmosphere (this is a required field, most likely to be missed, must output). Example:
```
"Soft natural side light, warm color temperature 4000K, creates a lazy morning atmosphere, slight long projection enhances three-dimensionality"
```
  - Brand Injection: How brand main color / Logo / logo elements are naturally integrated into the scene (this is a required field, most likely to be missed, must output). Example:
```
"Brand main color appears as an accent color on pillows/tags, Logo appears on props in a low-saturation embossed form, not overwhelming the main subject"
```
B. LOCKED_TYPOGRAPHY
1. Font Style: Lock to only one style from the following library:
  - Geometric Sans-serif: Jost, League Spartan, Montserrat, Manrope, Outfit
  - Bold Sans-serif: Bebas Neue, Oswald, Barlow Condensed, Anton, Fjalla One
  - Classic Elegant Serif: Bodoni Moda, Playfair Display, Prata, Cormorant Garamond, DM Serif Display
  - Rounded Playful Fonts: Nunito, Quicksand, Varela Round, Fredoka, Baloo 2
  - Playful Handwritten Style: Pacifico, Permanent Marker, Amatic SC, Caveat, Luckiest Guy
2. Color Strategy:
  - Heading Color: Must use brand main color or reverse white; automatically trigger "flexible reverse white" when the color at the bottom of the heading is brand main color or same color system; secondly consider using colors in the same color system as brand main color (prohibit colors close to black, colors cannot be too dark)
  - Body Color: Distinguish from heading color to ensure readability
  - ⚠️ Output Format Note: The color strategy output format is
```
["Heading Color": color value]
```
    and
```
["Body color": color value]
```
    , this is color definition rather than text content
3. Flexible Reverse White Authorization: Authorize switching to matte white (#FFFFFF) text when using dark background or solid brand-color panel
4. Typesetting Restrictions: Unified as non-italic, standard leading
Output Requirements: Strictly output complete JSON according to the "Output Format" below, no explanatory text or code block markers are allowed.
Output: Complete textgen prompt string
Purpose: As prompt input for Step 3

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

Step 3: Call linkfox-aigc-textgen to Perform Visual Reasoning

输入：步骤 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/
目录。先取目录：
bash
```
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 字符串。
bash
```
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 的组装原料

Input: Prompt from Step 2,
```
imageUrlList
```
from Step 1
Operations: Call textgen to perform visual reasoning according to the calling method in linkfox-aigc-textgen SKILL.md. The content produced in this step should be read back into the context for field extraction (Step 4), not chained into downstream image generation. Therefore, use textgen's default mode (not
```
--content-only
```
): Write the following fields into a JSON parameter file, pass it in via
```
--stdin
```
to run, then parse stdout.
```
<textgen root directory>
```
is obtained by parsing the absolute path of the directory where SKILL.md is located via
```
skill:linkfox-aigc-textgen
```
;
```
<this skill root directory>
```
= absolute path of the directory where this SKILL.md is located.
⚠️ Intermediate parameter files are stored in the session
data/
directory. First get the directory:
bash
```
DATADIR=$(python <this skill root directory>/scripts/save_brand_gene.py --datadir)
```
⚠️ Construct
brand_gene_params.json
must use the Write tool to write to
```
$DATADIR/brand_gene_params.json
```
(prompt contains special characters such as quotes and backslashes, shell heredoc embedded JSON is prone to parsing failures). If generating via command line, only use
```
python -c
```
with
```
json.dumps
```
, do not manually拼 JSON strings.
bash
```
python <textgen root directory>/scripts/aigc_textgen.py --stdin < "$DATADIR/brand_gene_params.json"
```
The JSON parameter file contains the following fields:
- ```
prompt
```
  : Brand visual gene extraction instructions assembled in Step 2 (including "Output Format" requirements)
- ```
imageUrls
```
  :
```
imageUrlList
```
  output from Step 1
- ```
model
```
  :
```
GEM_3_1_PRO
```
  (requires visual understanding and complex reasoning capabilities)
- ```
thinkingLevel
```
  :
```
high
```
Output: Parse textgen stdout to get
```
content
```
(parsing method follows the "Output Contract" in linkfox-aigc-textgen SKILL.md).
Purpose: As assembly material for Step 4

步骤 4：组装 brandGeneJson

Step 4: Assemble 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
```
  ）：
  bash
```
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
```
参数

Input:
```
content
```
parsed from Step 3 (line breaks may be
```
⏎
```
placeholders, restore to line breaks before extraction)
Operations: Extract each field of brand visual gene from the
```
content
```
, and assemble it into
```
brandGeneJson
```
strictly according to the "Output Format" below
Missing Field Fallback (Mandatory): After assembly, must check one by one whether all fields in the "Output Format" are complete. If the model output misses a certain field (the most likely to miss
```
Background Strategy - Light & Shadow
```
and
```
Brand Injection
```
), do not directly deliver incomplete JSON, and must fallback and fill in according to the following order:
1. Prioritize inferring a reasonable value for the field from other text in
```
content
```
  ;
2. If there is no inferable content, generate a fallback description consistent with the overall tone based on the determined main color / style definition (e.g., light & shadow as "natural soft side light, warm color temperature, enhanced three-dimensionality", brand injection as "main color as accent, Logo integrated into props in a low-key manner"). The final
```
brandGeneJson
```
  must have complete fields, no missing fields or empty field values are allowed.
Output:
```
brandGeneJson
```
(JSON list with length 1, complete fields)
Storage (Mandatory): After assembly, must write to the session directory and retain the path for downstream reuse:
1. Use the Write tool to write
```
brandGeneJson
```
  to
```
$DATADIR/brand_gene_assembled.json
```
  (
```
DATADIR
```
  same as Step 3); or
2. Run the storage script (recommended, automatically registers
```
_meta.json
```
  ):
  bash
```
python <this skill root directory>/scripts/save_brand_gene.py "$DATADIR/brand_gene_assembled.json"
```
  stdout will print
```
Saved full response: <absolute path> (<N> bytes)
```
  ——Record this absolute path into the context, and subsequent S3 image layout consumes it via
```
--brand-gene-file <absolute path>
```
  or manifest's
```
brand_gene_json
```
  .
Purpose: Pass to downstream image generation links (such as种草图/selling point image/A+ image of
```
linkfox-aigc-imagegen-cloth
```
/
```
linkfox-aigc-imagegen-product
```
, etc.) as
```
brandGeneJson
```
parameter

产物落盘

Product Storage

产物	目录	说明
`brand_gene_params.json`	`<session>/data/`	textgen 入参（步骤 3 中间文件）
`brandGeneJson` 最终结果	`<session>/data/linkfox-aigc-imagegen-brand-gene-extract-<ts>.json`	经 `save_brand_gene.py` 落盘，供套图 S3 与单张 `--brand-gene-file` 复用

路径协议：

<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/

（

<session>

取自

SESSION_ID

），与仓库

CLAUDE.md

「输出文件位置」一致。

Product	Directory	Description
`brand_gene_params.json`	`<session>/data/`	textgen input parameters (intermediate file in Step 3)
Final `brandGeneJson` result	`<session>/data/linkfox-aigc-imagegen-brand-gene-extract-<ts>.json`	Stored via `save_brand_gene.py` , reused by S3 image layout and single image `--brand-gene-file`

Path Protocol:

<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/

(

<session>

is obtained from

SESSION_ID

), consistent with "Output File Location" in warehouse

CLAUDE.md

核心规则

Core Rules

A. 主色和字体逻辑

A. Main Color and Font Logic

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

If
```
brandColor
```
has a value → directly use this value for "brandColor (Brand Main Color)" in the output JSON
If
```
fontStyle
```
has a value → directly use this value for "Font Style" in the output JSON
If any value is empty → extract this value automatically using the rules in core variables

B. 其他值逻辑

B. Other Value Logic

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

Fields such as "Background Strategy - Style Definition" and "Color Strategy - Heading" are obtained using the rules in core variables by default, and are not affected by the passing of brandColor/fontStyle in brandKey.

输出格式

Output Format

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

json

[
  {
    "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"
    }
  }
]

Strictly output according to the following JSON format, output as a list with length 1:

json

[
  {
    "brandColor": {
      "brandColor (Brand Main Color)": "Color name and HEX value",
      "Background Strategy - Style Definition": "Style description based on salesRegion",
      "Background Strategy - Scene Keywords": "Keyword1, Keyword2, ...",
      "Background Strategy - Light & Shadow": "Light and shadow atmosphere description",
      "Brand Injection": "How brand elements are implanted into the scene"
    },
    "fontStyle": {
      "Font Strategy": "Selected font family name",
      "Font Style": "Selected specific font name",
      "Color Strategy - Heading": "[\"Heading Color\": color value/reverse white logic]",
      "Color Strategy - Body/Sub": "[\"Body color\": color value]",
      "Flexible Reverse White": "You are authorized to switch to Matte White (#FFFFFF) text whenever using a dark background or a solid brand-color panel.",
      "Typesetting": "Non-italic, standard leading"
    }
  }
]

错误处理

Error Handling

情况	处理
images 为空	停止执行，提示用户上传至少 1 张商品图片
brandKey 完全为空	所有字段按默认值填充（salesRegion=美国、language=英文、platform=亚马逊），主色与字体走自动提取
商品为纯黑白灰且无法提取彩色主色	允许使用黑白灰作为主色（黑白灰协议的唯一豁免条件）

Situation	Handling
images is empty	Stop execution, prompt the user to upload at least 1 product image
brandKey is completely empty	Fill all fields with default values (salesRegion=United States, language=English, platform=Amazon), main color and font are auto-extracted
Product is pure black, white, or gray and no color main color can be extracted	Allow using black, white, or gray as the main color (the only exemption condition for the black & white & gray protocol)

调用方式

Calling Method

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

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

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

This skill is called by the image layout layer in Step 3, calling timing:

First Call: When brand gene style extraction has not been performed in the context
Re-call: When the user explicitly requests to modify the brand gene (Scenario G)

Reuse Rule: Extraction results in the same context can be reused, no need to call repeatedly.

解决认证和积分问题

Resolve Authentication and Points Issues

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

When the following abnormal situations occur, guide users to solve problems using references/onboarding.md:

异常情况

Abnormal Situations

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

API Key Not Configured: Environment variable
```
LINKFOX_AGENT_API_KEY
```
is not configured, nor is
```
LINKFOXAGENT_API_KEY
```
configured.
Response with 401 or 402 Status Code
Response Indicates Insufficient Points or Balance: Message contains "insufficient points balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge", or similar meanings.

已知局限

Known Limitations

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

Brand main color extraction is based on
```
GEM_3_1_PRO
```
's visual understanding of product images, which may deviate from professional designers' judgments
Font styles are limited to 25 fonts in 5 preset categories, cannot select fonts outside the library
Cultural localization of background strategy depends on semantic understanding of salesRegion, no structured regional database
Brand gene JSON must be stored in the session
```
data/
```
via
```
save_brand_gene.py
```
, cannot only be stored in the conversation context
Depends on the availability of
```
linkfox-aigc-textgen
```
skill; if textgen call fails, brand gene extraction cannot be completed