# Tripo

> 透過 AI Game Dev 訂閱額度使用雲端 3D：從文字、單張圖片或多個視角生成 3D 模型、貼圖、重新拓撲、零件拆分、網格補全、格式轉換、骨架綁定、動畫，以及圖片生成與編輯。代理會為每項工作挑選操作與模型變體。

- ID: `aigd.tripo`
- 來源: 官方 (第一方 `aigd.*`)
- 分類: 3D
- 發佈者: AI Game Dev (`aigd`), 已驗證
- 最新版本: 0.2.20 (發佈於 2026-11-22)
- 授權條款: Apache-2.0
- 需要 AI Game Dev 應用程式: `>=0.25.11`
- 原生程式碼: 否
- 評分: 尚無評分
- HTML 頁面: https://ai-game.dev/zh-hant/packages/aigd.tripo

## 安裝

在專案資料夾中，使用 gamedev CLI：

```bash
gamedev pkg add aigd.tripo
```

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.tripo`，然後點 **加入專案**。更多資訊：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 0.2.20 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.2.19 | 2026-11-19 | `>=0.25.11` | - |
| 0.2.18 | 2026-11-13 | `>=0.25.11` | - |
| 0.2.17 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.16 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.15 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.14 | 2026-11-05 | `>=0.25.11` | - |
| 0.2.13 | 2026-11-01 | `>=0.25.11` | - |
| 0.2.8 | 2026-10-24 | `>=0.25.10` | - |
| 0.2.7 | 2026-10-15 | `>=0.20.0` | - |
| 0.2.6 | 2026-10-13 | `>=0.20.0` | - |
| 0.2.5 | 2026-10-05 | `>=0.20.0` | - |

## 說明

````markdown
# Tripo (`aigd.tripo`)

Tripo 透過 AI Game Dev 伺服器，把 AI Game Dev 代理連接到 Tripo 的雲端 3D 與圖片生成，費用由你的訂閱額度支付。它能從文字、單張圖片或多個視角製作 3D 模型、生成貼圖、處理網格（重新拓撲、拆分成零件、補全缺失的幾何、格式轉換）、為模型綁定骨架並加上動畫，也能製作與編輯圖片。在目前的應用程式版本中，代理會為每項工作挑選操作與模型變體。桌面應用程式會自動安裝它。它適合想要 3D 資產與動畫、但沒有本機 GPU 的開發者。

## 你可以製作的內容

- 從文字提示、單張圖片或多個視角，製作道具、角色、生物與場景的 3D 模型。
- 為現有的 3D 模型生成貼圖。
- 更乾淨的網格：最佳化拓撲、把模型拆分成零件、補全缺失的幾何，或將檔案轉換成其他 3D 格式。
- 完成骨架綁定與動畫的角色：檢查模型是否能綁定骨架、加入骨架、為它加上動畫。
- 2D 圖片：從文字生成、編輯，或做成同一個物件的多個視角（用於多視角轉 3D）。

## 範例請求

- 「用 Tripo 依照文字提示做一個木製寶箱，並存到專案裡。」
- 「把 `Concepts/robot_front.png` 轉成 3D 模型，接著綁定骨架並加入走路動畫。」
- 「為 `Assets/Models/house.glb` 生成新的貼圖。」
- 「把這個載具模型拆分成零件，並最佳化它的拓撲。」
- 「為這張角色圖片建立正面、側面與背面視角，再用這些視角建出 3D 模型。」

## 重點特色

|  |  |
|---|---|
| 類型 | 程式套件（給代理使用的工作階段工具）、雲端生成 |
| 3D | 3D：從文字、從圖片、從多個視角 |
| 貼圖 | 為 3D 模型生成貼圖 |
| 網格 | 最佳化拓撲、拆分成零件、補全缺失的幾何、轉換檔案格式 |
| 骨架綁定與動畫 | 檢查骨架、加入骨架、為已綁定骨架的模型加上動畫 |
| 2D | 從文字生成圖片、編輯圖片、建立與編輯多個視角 |
| 費用 | 以訂閱額度的百分比計算，並依對話的生成預算進行檢查 |
| 安裝方式 | 由桌面應用程式自動安裝 |
| 授權 | Apache-2.0（套件本身） |

## 操作群組

桌面應用程式會自動安裝 `aigd.tripo`。它的五個操作群組（3D、貼圖、網格、骨架綁定與動畫、2D）並不是各自獨立的按鈕：工具中的對話 **3D** 群組會啟用前四項，**圖片** 群組則啟用 2D。代理可以使用其中哪些，只在專案的 Models 畫面決定。

代理會針對每項工作，從目前伺服器目錄中列為已啟用且符合使用者方案資格的每個變體裡，挑選操作與其 `variant_id`；使用者不能自行選擇。每次呼叫都會重新檢查最新的目錄，絕不會替換成其他模型。方案未包含的變體不會出現在工具中；`status` 與 `capability_search` 會說明原因（`PLAN_REQUIRED`：需要更高階的方案，只有使用者能購買）。工具無法變更工作階段設定。這需要會通告 `env.features.agentChoosesVariants` 的主機；在較舊的主機上，套件會維持先前的行為（固定的變體，或在各群組設定中選擇的明確「Agent chooses」允許清單）。較舊的 Kernel 只會公開設定與狀態。

## 作業的付費方式

實際操作會使用公開的 Kernel `paidOperations` API。Kernel 會取得不可變更的伺服器報價，依對話的生成預算檢查（預設情況下，預算內的工作會直接執行、不另行詢問；在「每次操作前詢問」模式下，由使用者逐一核准），然後提交已核准的請求。預算無法負擔的工作會被拒絕。工作階段設定並不代表同意。金鑰與帳號權杖都留在套件之外；只有我們的伺服器會與 Tripo 通訊。

## 等待、復原與重試

一般生成會等到完成，並在同一次工具呼叫中儲存所有產出檔案。等待期間，這次呼叫會擋住應用程式的套件重新載入與其背景服務更新（`aigd.work.hold`），因此兩者都不會在等待途中替換後端。代理可以用 `retrieve_result` 復原中斷的工作，或檢查 `jobs` 與 `recover_jobs` 進行診斷，並撤銷已儲存的權限。下載重試絕不會重新生成資產。不明的提交結果會依其持久化的請求身分復原，而不是建立替代工作。現有檔案會保留。

## 計費

所有客戶端的估算與餘額都以額度百分比表示。伺服器計費會扣除官方供應商成本，不額外加價。實際執行取決於目前的伺服器就緒狀態、訂閱政策與 Kernel 支援。隨附的設定頁面不含任何模擬控制項。

## 驗證

驗證涵蓋最新的政策變更、工作階段擁有權、提交前拒絕、回覆遺失時不重試，以及不重新生成即可取回產出檔案。隔離的開發用測試素材屬於 QA 輔助工具，並不構成供應商驗證。

## 相容性

相容性：啟用時會檢查實際提出的 API，與引擎版本無關。先前的工作階段設定 Kernel 會保留其舊版 webview 控制項；目前的 Kernel 會呈現全部五個宣告的模組，並掌管它們的生命週期。若 Kernel 缺少基準的帳號／工作階段設定 API，就不會註冊任何供應者，並記錄需要更新應用程式。這條相容性路徑絕不會替換變體，也不會授權任何花費。

## 已儲存的資產

每個模組都會在其資訊清單中宣告 `context.assetOperations`。只有在這個工作階段已完成產出檔案時，Kernel 才會在該模組的設定中顯示精簡的資產數量。按「開啟」會顯示有大小上限的彈出視窗，絕不會主動跳出對話卡片。清單不含其他模組與工作階段。已儲存的檔案會在專案檢視器或檔案管理員中開啟；遺失或已變更的檔案可透過既有的持久化交付紀錄復原，不必重複付費生成。
````
