前言¶
在 Agent 裏做 3D Gaussian Splatting（3DGS）的重建或生成，往往要按順序處理多步 OpenAPI：上傳素材、創建異步任務、輪詢狀態、再拉取 PLY / SPZ / SOG 等產物。步驟分散在文檔裏，容易漏掉 worldId 或 poll 時機。下面介紹 SkillHub 上的 Aholo 3DGS重建與生成（@user_a0383623/aholo-3dgs-reconstruction），它把上述流程寫成 Agent 可執行的 Skill，且明確不覆蓋 2D 出圖場景。
這是什麼¶
Aholo 3DGS重建與生成 是面向 Aholo OpenAPI v1 的 3D 任務（reconstruction / generation）編排 Skill：素材上傳 → 創建任務（成功返回 WorldAsyncOperation / worldId）→ status / poll → 獲取 PLY / SPZ / SOG 等結果。
- 座標：
@user_a0383623/aholo-3dgs-reconstruction - 當前版本：1.0.12（SkillHub 頁面標註 v1.0.12）
- 分類：ai-agent；來源：community；頁面標註作者爲 Aholo Studio
- 標籤：
requires_api_key=true（調用需配置 API Key，具體字段以 Skill 包內說明爲準） - 官方入口：SkillHub 技能頁、API 索引
SkillHub 統計（抓取資料）：評分 100000，下載 1240 次。
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面描述，僅覆蓋 3D reconstruction / generation：
- 素材上傳：在創建 3D 任務前完成素材上傳（具體接口與參數由 Skill 內指引 Aholo OpenAPI v1）。
- 創建 3D 任務：發起創建後，成功響應包含 WorldAsyncOperation 與 worldId，用於後續查詢。
- 進度查詢：通過 status / poll 持續查詢任務進度，直到完成或失敗。
- 結果獲取：任務完成後拉取 3D 產物，支持 PLY / SPZ / SOG 等格式。
任務創建策略（Skill 線索與簡介一致）：
- 默認：單筆用戶訴求每輪 一次
create。 - 用戶明確多個視頻需要 各自重建 時，可按視頻數量 多次
create。
不適用範圍：
- 2D 出圖；
- 用戶未明確需要 3D 結果的請求。
安裝與啓用¶
安裝方式以 SkillHub 官方說明爲準：先確保本機有 skillhub CLI，再將技能裝到當前 Agent 實際讀取的 skills 目錄（裝錯目錄 Agent 不會加載）。
1、檢查或安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安裝，可使用官方安裝腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill¶
SkillHub 頁面給出的安裝提示爲：根據 SkillHub 安裝文檔，安裝 @user_a0383623/aholo-3dgs-reconstruction。
命令行示例（--dir 須指向當前環境的 skills 目錄）：
skillhub install user_a0383623/aholo-3dgs-reconstruction --dir <skills 目錄>
常見 Agent 的 skills 路徑（摘自安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝後按你所用客戶端要求重啓或刷新 Agent，使 Skill 生效。因標籤爲 requires_api_key=true，啓用前需在 Aholo / Skill 約定處配置 OpenAPI 訪問密鑰（以技能包內 SKILL.md 爲準）。
典型用法¶
公開頁面未附帶完整對話示例；可復現的使用方式是與 Agent 說明 3D 重建或 3D 生成 需求，並確保已安裝本 Skill 與 API Key。Agent 按 Skill 編排大致會走下面鏈路：
- 根據任務類型（reconstruction 或 generation）準備並 上傳素材。
- 調用創建接口，拿到 worldId（及 WorldAsyncOperation 相關信息）。
- 循環 status / poll，直到任務終態。
- 下載或返回 PLY / SPZ / SOG 等指定格式產物。
若用戶一次提供多個視頻且要求 每個視頻單獨建世界，Agent 應按 Skill 約定對每個視頻分別 create，而不是默認合併爲單次任務。
適用場景與注意¶
適合：
- 已在用或計劃用 Aholo OpenAPI v1 做 3DGS 重建/生成，希望 Cursor、Claude Code、Codex 等 Agent 自動走完上傳、建任務、輪詢、取文件。
- 產物需要 PLY / SPZ / SOG 等 3D 格式，而非平面圖像。
注意：
- 本 Skill 不處理 2D 出圖；純文生圖、修圖類訴求應換其他 Skill。
- 異步任務必須 poll 到完成，避免在未終態時假定已有產物。
- 版本以 SkillHub 爲準（當前 1.0.12）；升級可用
skillhub對同一座標更新到 Agent skills 目錄。 - 涉及素材版權、算力配額與 API 計費，以 Aholo 平臺條款爲準。
結尾¶
Aholo 3DGS重建與生成 把 Aholo 3D 任務的 OpenAPI 步驟收斂成 Agent 可執行的一站式流程，並劃清與 2D 場景的邊界。安裝與詳情見 SkillHub 技能頁 與 API 索引。
