技能介绍

要解决什么问题

把符合酷家乐规范的 3D 模型 .zip 推到商品库，需要按 OpenAPI 走完 STS 换凭据 → OSS 直传 → 服务端解析 → 状态轮询 → 提交入库 整条链路。步骤多、签名规则固定（md5(appSecret + appKey + timestamp_ms)），在 Agent 或 CI 里手写容易漏步骤；部分 Windows 环境还会因 shell/IDE 注入的代理或 CA 配置导致 TLS 握手失败。

本技能封装 kujiale_upload.py，用 requests 调酷家乐 API、用 oss2 上传 ZIP，并为 HTTP 会话设置 trust_env=False，避免继承环境代理干扰连通性校验。

工作流程

| 步骤 | 动作 |
|------|------|
| 1 | GET /v2/commodity/upload/sts 获取 OSS STS 与 uploadTaskId |
| 2 | PUT 到阿里云 OSS 上传 ZIP |
| 3 | POST /v2/commodity/upload/create 触发解析 |
| 4 | GET /v2/commodity/upload/status 轮询直至 status == 3 |
| 5 | POST /v2/commodity/upload/submit 提交，得到 brandGoodId |

凭据可通过环境变量 KUJIALE_APP_KEY / KUJIALE_APP_SECRET、CLI 或 run_skill({...}) 传入；支持 dry_run 跳过网络返回 mock，便于烟测。步骤 4 中 status=2 表示 ZIP 解析失败，status=3 才可继续提交。

边界与注意

不包含内置真实凭据；自动生成的测试 ZIP 仅用于 API 连通性，不保证生产模型包合规。
需具备有效 appKey/appSecret、商品模型上传租户权限，且能访问 openapi.kujiale.com 与 STS 返回的 OSS 端点；受限沙箱会明确提示外网不可用。
步骤 5 脚本内示例默认 location = 1、brandCats = ["3FO4K6E984C7"]，属业务示例，其他租户提交前需按类目树自行改脚本。
appSecret 仅在内存签名中使用，不打印、不落盘；凭据泄露应在酷家乐开放平台轮换。

截图预览

使用场景

接入酷家乐商品模型 API 时，用 appKey/appSecret 将本地 `.zip` 跑通 STS、OSS 上传、解析轮询与提交，验证能返回 `brandGoodId`。
在 CI 或 Agent 流水线里先 `--dry-run` 烟测，再对真实 ZIP 执行五步上传，确认 `openapi.kujiale.com` 与 STS 返回的 OSS 端点均可达。
供应商交付的模型包需入库酷家乐商品库时，按固定签名规则自动完成上传与 `status` 轮询，避免手写漏调某个端点。
ZIP 在步骤 4 出现 `status=2` 或轮询超时后，调整包体或 `poll_timeout` 后重跑整条链路，对照文档核对解析与提交结果。