HairDeck教程:一张图生成可动画发型卡,GLB/VRM直接导出

📌 项目日期:2026年11月 | 数据来源:GitHub官方仓库 | 星数:596+

📋 项目简介

3D虚拟人的头发一直是老大难:网格建模贵、卡片手摆累。HairDeck 给出一条生成式管线:一张图 → 风格化发型卡 + 弹簧骨骼链。技术亮点有三:每张发卡编码为一个token,集合扩散Transformer把整套发型联合生成(不是一张张拼);输出保留独立卡片与逐卡UV;链式扩散模型生成驱动发卡的骨骼,带蒙皮与VRM导出——生成完直接能吹动。

单图生3D的同门项目:物体高斯化的 Idol SDK、照片转可编辑模型的 Camera to Blender。

🔧 技术要点

模块说明
Card VAE每张发卡编码为一个token
集合扩散条件集合扩散联合生成整套发型(卡片间相互协调)
UV保留输出保留独立发卡+逐卡UV,便于贴图定制
链式扩散骨骼生成弹簧骨骼链驱动发卡,蒙皮+VRM导出
导出GLB网格 / 绑定虚拟人后VRM

📦 安装

# 环境:Linux x86-64 + Python 3.12 + NVIDIA CUDA GPU
git clone https://github.com/hyz317/HairDeck.git
cd HairDeck
pip install -r requirements.txt
# 权重从 HuggingFace 下载(见README模型权重章节)
# 单图推理 → GLB/VRM导出

✅ 使用建议

📚 常见问题

HairDeck是什么?

一个图形学研究项目:从单张图像生成风格化发型卡(hair cards)和驱动它们的弹簧骨骼链——每张卡一个token,集合扩散Transformer联合生成整套发型。

输出能怎么用?

输出保留独立发型卡与每卡UV坐标,可导出GLB网格;或绑到虚拟人身上导出VRM,弹簧骨骼直接可动画。

运行要求?

Linux x86-64、Python 3.12、一块NVIDIA CUDA GPU;模型权重从HuggingFace下载。