feat(edit): 采集插件、编辑页SKU 属性动态展示、颜色展示开发

docs/api/product-editor-and-publishing.md

@@ -126,6 +126,18 @@ Headers：`If-Match: "{product_revision}:{profile_revision}"`、`Idempotency-Key
 
 成功返回新 `product.revision`、`profile.revision`、创建的 SKU ID/`client_key` 映射和 warnings。任一字段、属性或媒体无效时返回 `422` 且不部分保存；版本冲突返回 `409 VERSION_CONFLICT`，客户端应重新读取编辑快照。
 
+### 2.1 独立保存采集商品描述
+
+`PUT /api/products/{product_id}/source-description`
+
+右侧“采集的商品信息 → 商品描述”的“保存描述”按钮使用该接口，不依赖整页草稿可通过校验。Headers：`X-Atlas-Platform-Id`、`If-Match: "{product_revision}:{profile_revision}"` 和 `Idempotency-Key` 均必填。请求体为：
+
+```json
+{ "description": "用户补充后的来源描述", "source_snapshot_revision": 3 }
+```
+
+服务端仅更新 `ai_source_material_overrides.description`，保留其他来源字段已有的覆盖值，并递增 `product.revision`；`profile.revision` 不变。若描述与当前最新采集描述完全相同，则移除该字段覆盖，使它继续跟随后续复采。接口返回最新双版本号及合并后的 `source_material` / `source_material_state`，页面据此立即更新右侧面板；刷新编辑页后仍能读取已保存描述。采集版本或编辑版本不一致时返回 `409`，客户端显示保存失败提示，不得以旧描述覆盖新采集快照。
+
 ## 3. 目标店铺、类目与属性
 
 `PUT /api/product-platform-profiles/{profile_id}/target-store`