ahang1598 创建变体（商品库）
核心特点
- 写操作：需用户明确确认后再调用
- 团队隔离：变体创建在当前团队商品库中
- 两种模式由
productId是否传值决定
参数概览
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| productId | Long | 否 | 空=新建商品+初始变体；有值=追加变体到已有商品 |
| productName | String | 条件必填 | productId 为空时必须提供 |
| skuName | String | 否 | 变体名称，不传则用 productName |
| brand | String | 否 | 品牌 |
| category | String | 否 | 类目路径 |
| targetPerson | String | 否 | 目标人群 |
| material | String | 否 | 材质描述 |
| sellingPoints | String | 否 | 卖点描述 |
| productType | Integer | 否 | 1=商品(默认)，2=服装 |
| offerSource | Integer | 是 | 来源类型，调用方按自身角色硬编码传入。同时通过 query 与 body 传递：query 用于会话来源绑定，body 写入 sku.offerSource（缺一不可，脚本已自动双写） |
| images | List<String> | 是 | 原图 URL 列表，1-30 张 |
| videos | List<String> | 否 | 视频 URL 列表，最多 5 条 |
offerSource 枚举（调用方按自身角色硬编码传入）
| 值 | 含义 |
|---|---|
| 10 | Listing-Agent |
| 11 | 选品-Agent |
| 12 | 生图-Agent |
| 13 | 市场分析-Agent |
| 14 | 视频-Agent |
| 15 | 通用-Agent |
调用方必须按自身角色传入对应值，不得省略或让用户选择。
返回
| 字段 | 说明 |
|---|---|
| productId | 商品 ID |
| skuId | 新创建的变体 ID |
使用指引
初始变体（新建商品）
不传 productId，必须提供 productName 和 images：
{
"productName": "夏季透气运动鞋",
"brand": "SportX",
"images": ["https://...img1.jpg", "https://...img2.jpg"]
}
追加变体（已有商品）
传入 productId，将新变体挂到已有商品下：
{
"productId": 123456,
"skuName": "黑色款",
"images": ["https://...black1.jpg", "https://...black2.jpg"]
}
调用方式
脚本：scripts/product_center_variant_create.py
错误码
| code | 含义 |
|---|---|
| 200 | 成功 |
| 400 | 参数校验失败（images 为空、productName 缺失等） |
| 403 | 商品不属于当前团队（追加模式） |
| 404 | 商品不存在（追加模式） |
展示规则
- 成功后告知用户 productId 和 skuId
- 提示用户可用 listing-create 为该变体创建上架链接
- 幂等：返回中含
duplicate:true或_directive=DUPLICATE_STOP时，说明该变体已创建过，禁止再次调用本 skill，直接复用返回的 productId/skuId 继续后续步骤
适用与不适用
适用：
- 只建商品入库，暂不上架
- 为已有商品追加新的 SKU 变体（如颜色/尺码款）
不适用：
- 建商品后立即需要 listing → 直接用
linkfox-product-center-listing-create模式二（不传 skuId），一步完成创建商品 + SKU + 挂 listing