# SkinTokens（本地自动绑定）

> 本地自动绑定：VAST-AI 的 SkinTokens 为角色或生物网格（GLB、OBJ 或 FBX）添加骨骼和蒙皮权重，并输出一个保留原始材质和 UV 的已绑定 GLB。在 Asset Studio 中用你的 NVIDIA GPU 运行，需要 14 GB 显存。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-hans/packages/aigd.model3d-skintokens

## 安装

使用 gamedev CLI，在项目文件夹中运行：

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

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.model3d-skintokens`，然后点击 **Add to Project**。更多：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 借助 VAST-AI 的 [SkinTokens](https://github.com/VAST-AI-Research/SkinTokens) 在你的 NVIDIA GPU（14 GB 显存或更多）上为 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 |
| 运行于 | 14 GB 显存或更多的 NVIDIA GPU（CUDA） |
| 下载 | 约 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 内置的核函数。也不安装 Open3D：用于蒙皮权重平滑的体素网格用 NumPy 构建，数学上与 Open3D 的实现相同。检查点仅以张量形式加载，绝不作为代码执行。模型离线运行；其权重只来自下方这些文件，在你确认之后从 Hugging Face 下载。AI Game Dev 不托管这些文件。

## 会下载哪些内容

约 1.6 GB，按 Hugging Face 修订版本和 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 按提交 [`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 版权声明。
````
