HairDeck:一张图生成可动画的风格化头发卡片,直接导出 GLB/VRM
清华、CMU、港中文开源:单张图生成风格化头发卡片与弹簧骨骼,逐卡 UV、支持双色染,导出 GLB/VRM,Apache-2.0,★988。
项目资料
GitHub Ecosystem- 许可证
- Apache-2.0
- 主语言
- Python
- 星标
- 988
- 核查时间
- 2026-11-09
以上快照资料以核查当日为准,可能随版本或运营策略变化。
角色建模里最费工的一环往往是头发:发片要一张张摆,摆完还要绑骨才能动。HairDeck(★988,Apache-2.0,Python,2026-10-29 建库)由清华、CMU 与港中文的研究者开源,做的事是从单张图生成风格化的头发卡片,以及驱动这些卡片的弹簧骨骼链,产出可以直接导出 GLB 或挂到 avatar 上导出 VRM。代码、权重与在线 demo 在 2026-10-30 一并放出,之后两周连续补上了 Windows 支持、Apple silicon 的 MPS 支持和彩色发卡。
核心功能
- 头发卡片当集合生成:card VAE 编码每一张卡片,条件集合扩散一次性生成整套发型,而不是逐片堆叠。
- 保留逐卡结构与 UV:输出保留独立发片并提供每张卡片的 UV 坐标,后续在引擎里改材质不用重新拆 UV。
- 颜色沿卡片预测:颜色模型沿每张卡片预测颜色,双色染与发饰都能带上,GLB 与 VRM 导出都保留颜色信息。
- 弹簧骨骼动画:链式扩散模型生成驱动卡片的骨骼链,含蒙皮与 VRM 导出,省掉手工绑骨。
- 平台覆盖:Linux 与原生 Windows 走 NVIDIA CUDA(Python 3.12、PyTorch 2.8、CUDA 12.8),Apple silicon 走 MPS,同一条管线不需要 CUDA 或 Triton。
典型使用场景
- 游戏与虚拟人资产:从概念图直接出可动画的头发资产,省掉建模与绑骨两道工序。
- VTuber / VRM 形象:生成后直接导出 VRM 挂到 avatar 上,颜色与骨骼一起带走。
- 风格化批量产出:同一管线批量跑参考图,适合需要大量同风格角色的项目。
快速上手
Linux 上 git clone 后 pip install -r requirements.txt,再 pip install --no-deps pyrender==0.1.45 绕开它过时的 PyOpenGL 版本约束;权重在 Hugging Face 的 hyz317/HairDeck,也有在线 Space 可以直接试。Windows 与 macOS 各有独立文档(docs/windows.md、docs/macos.md),本地跑 Gradio demo 即可。训练与评测脚本同样在仓库里,测试集评测有单独的 test-set 说明。
与既有方案的关系
它解决的不是「生成一张好看的头发贴图」,而是「生成能进引擎动的头发资产」:输出带逐卡 UV 与骨骼链,这是纯图像生成模型给不了的。和本站写过的 three-live 正好接成一条链——HairDeck 产资产,three-live 这类运行时负责跨端渲染;与 supersplat 那种以扫描重建为主的路线也不同,它走的是从单图做风格化生成的路线。
小结
HairDeck 适合做风格化角色的美术、技术美术,以及需要批量产出角色资产的小团队。要点与边界:Apache-2.0,商用友好;但它是研究项目,Windows 与 MPS 支持都是 2026-11 才补的,稳定性要按自己平台实测;写实发丝级(strand-level)效果与工业级毛发解算不在它的目标范围内;论文编号 arXiv 2610.40599,方法细节以论文与项目页为准。