前言¶
把 3D 模型 ZIP 上传到酷家乐 OpenAPI 平台，脚本要自己串起一串步骤：先取临时上传凭据，再把文件推到对象存储，然后触发模型解析，之后反复轮询解析结果，最后把模型提交上去。任何一步失败，排查都要回到原始响应里找原因，而响应里的字段并不直观。
kujiale-3d-model-upload 把这条链路固化成一个 Skill，让 Agent 按固定顺序执行这 5 步，而不是临时拼脚本。
这是什么¶
一个面向 Agent 的 Skill，用来校验并执行完整的酷家乐 OpenAPI 3D 模型上传 5 步流程。
- 名称：
kujiale-3d-model-upload - 坐标：
@user_97275c6e/kujiale-3d-model-upload-cn - 版本：1.0.0
- 来源：community
- 分类：ai-agent
- 发布者：
user_97275c6e - 标签：
requires_api_key=true
它解决的是「上传链路步骤多、顺序固定、失败难定位」的问题：Skill 按既定顺序推进 5 步，把中间状态保持在一次会话内，便于逐步回放和定位。
核心功能¶
官方给出的流程是 5 步，顺序固定：
- 获取 STS 凭据。用酷家乐 OpenAPI 的凭据换取临时上传凭据，后续上传依赖这一步的结果。
- 上传 ZIP 到 OSS。把本地的 3D 模型 ZIP 通过上一步拿到的凭据推送到对象存储。
- 触发模型解析。告诉平台「有一个新文件已上传」，让它开始解析。
- 轮询解析状态。反复查询解析进度，直到结束或失败。
- 提交模型。解析完成后提交，模型才真正进入可用状态。
第 4 步是最容易卡住的地方：轮询间隔和超时处理如果不当，会要么空转要么过早放弃。Skill 把这一步放在流程内，失败时能直接指回前序步骤。
安装与启用¶
这一步无法给出可核对的命令。
抓取到的官方地址 https://api.skillhub.cn/user_97275c6e/kujiale-3d-model-upload-cn 在本次写作时抓取失败，SkillHub 页面 https://www.skillhub.cn/skills/user_97275c6e/kujiale-3d-model-upload-cn 同样抓取失败。抓取资料里没有安装命令、目录约定或配置文件字段，因此这里不写任何具体命令，避免给出无法核实的步骤。
可以确认的是：它属于基于通用 SKILL.md 格式的 Skill，需要先在客户端侧配置 API key（标签 requires_api_key=true），具体加载方式请以官方页面为准。
典型用法¶
官方列出的典型触发语，可以直接当作给 Agent 的指令来用：
- 「上传到酷家乐」
- 「测试酷家乐 API」
- 「酷家乐模型上传」
- 「上传 3D 模型 ZIP」
- 「OpenAPI 完整流程」
例如要端到端验证上传链路时，直接说明「走一遍 OpenAPI 完整流程，上传这个 3D 模型 ZIP」即可，让 Skill 按 5 步顺序执行并返回每一步的结果。
适用场景与注意¶
适合这几类人：
- 要把 3D 模型 ZIP 上传到酷家乐 OpenAPI 平台，不想手写上传脚本。
- 要端到端测试上传链路，确认凭据、上传、解析、提交每一环都通。
- 上传失败需要定位，想看清是哪一步出错。
- 要把模型上传纳入自动化流程，需要固定步骤和固定顺序。
限制与坑：
- 需要自备 API key，未配置时流程第一步就过不去。
- 需要自备符合平台要求的 3D 模型 ZIP，Skill 不做模型内容本身的校验。
- 解析与提交结果依赖平台侧状态，Skill 只能在轮询层面暴露失败，不能保证模型内容一定被平台接受。
- 评测数据来自 SkillHub 页面：评分 100000。页面显示的下载量与安装量在不同抓取结果中不一致（1147 / 1018 下载，安装 0），因此本文不引用具体下载数字。
结尾¶
这个 Skill 的价值在于把固定的 5 步上传流程固化下来，省掉临时拼脚本和手工排查的成本，适合上传、联调、排障和自动化接入四种用途。
官方地址：https://api.skillhub.cn/user_97275c6e/kujiale-3d-model-upload-cn
SkillHub 页面：https://www.skillhub.cn/skills/user_97275c6e/kujiale-3d-model-upload-cn
