前言¶
把 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
