# SkinTokens（本機自動綁定）

> 本機自動綁定：VAST-AI 的 SkinTokens 能為角色或生物網格（GLB、OBJ 或 FBX）加上骨架與蒙皮權重，並輸出保留原始材質與 UV 的已綁定 GLB。可在 Asset Studio 中於你的 NVIDIA GPU 上執行，需 14 GB VRAM。MIT，允許商業使用。

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

## 安裝

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

```bash
gamedev pkg add aigd.model3d-skintokens
```

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

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.3 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 說明

````markdown
# SkinTokens (`aigd.model3d-skintokens`)

SkinTokens 會在你的 NVIDIA GPU（14 GB 以上 VRAM）上，透過 VAST-AI 的 [SkinTokens](https://github.com/VAST-AI-Research/SkinTokens) 為 3D 模型綁定。它會預測角色或生物網格的骨架與蒙皮權重，並寫回你的原始檔案，因此材質與 UV 都會保留。結果是一個已綁定的 GLB。在 AI Game Dev 中，它透過 **Local Python models runtime**（`aigd.python`）在本機執行。它適合需要在為生成的或手工製作的角色製作動畫之前，先取得初步骨架的開發者。

## 你可以製作的內容

- 從 GLB、OBJ 或 FBX 網格製作出已綁定的角色與生物，可直接在你的引擎或 DCC 工具中製作動畫。
- 為本機圖像轉 3D 模型所產生的網格提供初版骨架與蒙皮權重。
- 同一個網格可產生多個綁定候選：每次執行都會取樣新的骨架。

## 如何使用

綁定是在 **Asset Studio** 中執行，而不是透過聊天代理：

1. 開啟 Asset Studio，選擇 **3D → SkinTokens → Rig**。
2. 加入要綁定的網格：GLB、OBJ 或 FBX 檔案，例如 `Assets/Models/goblin.glb`。
3. 檢查綁定後的 GLB。如果骨架不適合該模型，再執行一次：每次執行都會取樣新的骨架。

## 重點特色

|  |  |
|---|---|
| 模型 ID | `aigd.model3d-skintokens.v1` |
| 操作 | 為 3D 模型綁定（單一輸入網格：GLB、OBJ 或 FBX） |
| 輸出 | 含骨架與蒙皮權重的已綁定 GLB；保留原始材質與 UV |
| 執行環境 | NVIDIA GPU（CUDA），需 14 GB 以上 VRAM |
| 下載 | 約 1.6 GB，首次載入時另需執行環境的 Python 環境（包含以 Python 模組形式提供的 Blender） |
| 授權條款 | MIT，允許將模型及其產生的綁定結果用於商業用途 |

要綁定的網格可以來自 [TripoSG](https://ai-game.dev/packages/aigd.model3d-triposg)、[Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape)、[Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry)、[TRELLIS.2](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) 或你自己的工具。

## 運作方式

此套件僅包含資料。它需要 **Local Python models runtime**（`aigd.python`）。首次載入時會建立專用的 Python 3.11 環境，內含 PyTorch 與以 Python 模組形式提供的 Blender（`bpy` 4.5 LTS，約 330 MB）。網格的讀取與寫入由 Blender 負責。不會安裝 FlashAttention：注意力運算使用 PyTorch 內建的 kernel。也不會安裝 Open3D：用於蒙皮權重平滑化的體素網格以 NumPy 建立，數學運算與 Open3D 相同。檢查點只以張量形式載入，絕不會以程式碼形式載入。模型離線執行；其權重僅來自下列檔案，並在你確認後從 Hugging Face 下載。AI Game Dev 並不托管這些檔案。

## 下載內容

約 1.6 GB，以 Hugging Face revision 與 sha256 鎖定：

| 檔案 | 大小 | 授權條款 | 來源 |
|---|---|---|---|
| `skin_vae_2_10_32768-last.ckpt` | 0.49 GB | MIT | [檔案](https://huggingface.co/VAST-AI/SkinTokens/resolve/79736cad0fd84de384d5eede659b4ebd24effe33/experiments/skin_vae_2_10_32768/last.ckpt) |
| `articulation_xl_quantization_256_token_4-grpo_1400.ckpt` | 1.13 GB | MIT | [檔案](https://huggingface.co/VAST-AI/SkinTokens/resolve/79736cad0fd84de384d5eede659b4ebd24effe33/experiments/articulation_xl_quantization_256_token_4/grpo_1400.ckpt) |
| `Qwen3-0.6B-config.json` | 0.00 GB | Apache-2.0 | [檔案](https://huggingface.co/Qwen/Qwen3-0.6B/resolve/c1899de289a04d12100db370d81485cdf75e47ca/config.json) |

模型的 Python 程式碼（`src/`、`configs/skeleton/`）會從 GitHub 於 commit [`273b691`](https://github.com/VAST-AI-Research/SkinTokens/tree/273b691d35989d71cd17ff2895fdc735097b92d1) 下載，每個檔案都會以 sha256 檢查。

## 授權條款

- **權重與程式碼：MIT**，© 2025 VAST-AI-Research（[授權條款](https://github.com/VAST-AI-Research/SkinTokens/blob/273b691d35989d71cd17ff2895fdc735097b92d1/LICENSE)、[模型卡](https://huggingface.co/VAST-AI/SkinTokens/tree/79736cad0fd84de384d5eede659b4ebd24effe33)）。
- **Qwen3-0.6B 設定檔**：Apache-2.0，© Alibaba Cloud（[模型卡](https://huggingface.co/Qwen/Qwen3-0.6B/tree/c1899de289a04d12100db370d81485cdf75e47ca)）。只會下載它的 `config.json`；語言模型的權重屬於 SkinTokens 的一部分。
- **以 Python 模組形式提供的 Blender**（`bpy` 4.5.16）：GPL-3.0-or-later，© Blender Foundation（[PyPI](https://pypi.org/project/bpy/4.5.16/)）。執行環境會從 PyPI 將它安裝到模型的專屬環境中，應用程式的綁定處理程式會在其中匯入它來讀寫網格。AI Game Dev 不會隨附 bpy。
- **綁定處理程式**（應用程式 Python 執行環境中的 `skintokens/handler.py`）：**GPL-3.0-or-later**，因為它會匯入 bpy。它會以獨立程式的方式，在模型自己的 Python 工作行程中執行，應用程式會啟動該行程，並僅透過 stdio 上的 JSON 訊息與它通訊。其原始碼隨應用程式一同提供；請參閱 `THIRD_PARTY_NOTICES.md`。

必要的署名："SkinTokens © 2025 VAST-AI-Research (MIT)"。

**限制：**允許將模型及其製作的綁定結果用於商業用途。重新散布權重時必須附上 MIT 著作權聲明。
````
