ahang1598 商品库-更新变体
按 skuId 增量更新 SKU 的业务字段。部分更新（PATCH 语义）——只传想改的字段，没传的保持不变。写操作，调用前需要拿到用户明确指令。
核心特点
- 写操作：会真实落库，调用前必须拿到用户明确"改成 XX"的指令。
- 范围限定：目标 SKU 必须属于当前团队，否则 403。
- PATCH 语义：所有字段可选；只更新传入的字段，其它字段保持原值。
- 字段全面：覆盖 SKU 维度所有业务字段（基础信息 / 卖点 / 服装专属 / 状态机三件套）。
- 追加媒体：支持通过
appendImages/appendVideos追加图片和视频到变体。
参数概览
- 必填字段：
skuId（path）、offerSource（query，来源类型，调用方按自身角色硬编码传入：10=Listing-Agent, 11=选品, 12=生图, 13=市场分析, 14=视频, 15=通用）
完整参数表、响应字段结构与错误码，见 references/api.md。
调用方式
- API 端点：
POST /product-center/v1/skill/product/variant/{skuId}/update（完整参数/响应/错误码见references/api.md） - Python 脚本：
python scripts/product_center_variant_update.py '<JSON 参数>' - HTTP 方法：原接口 POST +
@PathVariable skuId+@RequestBody；脚本把params.skuId替换到 path，剩余字段作为 JSON body。
输出策略（脚本默认行为）：
- 响应一般极小（只回
{code, msg, traceId}，data 为 null）：直接全量打印到 stdout
使用指引
- 确认意图：写操作，必须用户明确说"改 / 更新 / 改成 XX"才调；不确定时 AskUserQuestion 二次确认要改的字段。
- PATCH 语义：只传想改的字段。如果用户只说"把卖点改成 XXX"，body 就只传
sellingPoints，不要把其它字段一起回填。 - 状态码字段慎改：
lifecyclePhase / profileStatus / inventoryStatus是业务流转状态，agent 不应主动改，除非用户明确指令。
示例
1. 改 SKU 名称
{"skuId": 12345, "skuName": "经典款 - 白"}
2. 同时改卖点和场景搭配
{
"skuId": 12345,
"sellingPoints": "纯棉透气、亲肤舒适、可机洗",
"sceneStyling": "夏季出游、办公通勤"
}
3. 改状态（用户明确指令）
{"skuId": 12345, "profileStatus": 2}
4. 追加图片到变体
{
"skuId": 12345,
"appendImages": ["https://img.example.com/new-photo-1.jpg", "https://img.example.com/new-photo-2.jpg"]
}
展示规则
- 更新成功：报喜并列出实际改了哪些字段（与入参一致），便于用户确认。
- update 不返回最新数据：如果用户问"现在的字段值是什么"，配合
linkfox-product-center-variant-detail再查一次。 - 失败：按错误码做友好提示。
- 追加媒体幂等：
appendImages/appendVideos同一批 URL 重复追加会被自动去重、不会重复入库（改字段不受影响，始终生效）；无需重试。
限制
- 单次只改一个 SKU。
- 字段长度 / 枚举校验跟创建一致（见 api.md）。
- 不支持删除字段（传空字符串可能被解释为"清空字段"，按业务字典确认）。
适用与不适用
适用：
- "把这个 SKU 的卖点改成 XX"
- "更新一下材质"
- "把这个款的状态改成 XX"
不适用：
- 想改 listing 文案（标题/五点/关键词）→
linkfox-product-center-listing-update-copy - 想改 listing 图片 →
linkfox-product-center-listing-update-images - 想新建 SKU → 当前 skill 集中没有"新建 SKU 但不创建 SPU"，需走前台或
linkfox-product-center-product-create
反馈
参见 references/api.md。