一、摘要
Hunyuan3D-Part 是腾讯混元开源的部件级 3D 形状生成与分解方案，由 P3-SAM（原生 3D 部件分割）与 X-Part（可控部件生成）组成。其训练不依赖 2D SAM，基于约 370 万形状与干净部件标注，提供自动化 3D 分割与扩散式部件生成。论文报告在多个基准上达到 SOTA，完整功能在 Hunyuan3D Studio 提供，仓库开放 P3-SAM 与 X-Part 轻量版。
二、核心特性
1、原生 3D 分割：P3-SAM 直接在 3D 上进行部件检测与实例分割，支持点提示与全自动流程。
2、可控部件生成：X-Part 以包围盒为约束，融合语义与几何特征，扩散式生成结构一致的部件。
3、纯 3D 数据训练：移除 2D SAM 依赖，依托大规模 3D/部件标注数据提升鲁棒性。
4、端到端流水线：先分割再生成，可编辑、可替换、可重用。
5、轻重版本并行：开源轻量版；完整能力可在 Studio 体验。
三、安装
1、克隆仓库：git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-Part。
2、环境准备：按子目录 P3-SAM/ 与 XPart/ 的要求安装依赖与 PyTorch/CUDA。
3、权重下载：从 Hugging Face 模型页获取对应检查点并放至各子模块指定路径。
4、快速体验：运行 P3-SAM 分割脚本得到部件与包围盒，再调用 X-Part 生成补全部件；或直接使用 Hugging Face Space 轻量演示。
四、典型用例
1、资产重用与编辑：对扫描或生成网格做自动分割、替换单个部件。
2、生产级建模辅助：保持结构一致性，便于拓扑重建与 UV 展开。
3、设计迭代：以包围盒约束快速探索部件造型与装配。
4、打印与制造：输出独立部件以适配材料与工艺。
五、生态与竞品
1、生态：对接 Hunyuan3D 系列与 Studio；提供 Hugging Face 模型与演示。
2、竞品：SAMPart3D、PartField、PartGen 等多依赖 2D/3D蒸馏或多视图方案；Hunyuan3D-Part 的差异在于原生 3D 分割 + 可控扩散生成的一体化管线。具体优劣以公开基准与场景验证为准。
六、局限与注意事项
1、开源为 X-Part 轻量版，完整功能在 Studio；接口与指标可能随版本演进。
2、长尾形类与噪声网格仍需人工复核。
3、训练/推理对显存有要求，建议使用近代 GPU；网格质量会影响分割与生成稳定性。
4、请遵循各自许可与第三方数据集条款。
七、项目地址
https://github.com/Tencent-Hunyuan/Hunyuan3D-Part
八、常见问题
Q: Hunyuan3D-Part 是否依赖 2D SAM？
A: 不依赖。P3-SAM 为原生 3D 分割模型，训练与推理均在 3D 空间完成。
Q: 数据规模与来源如何？
A: 论文称使用约 370 万形状与干净部件标注（具体构成以论文与模型卡为准）。
Q: 输入网格有什么建议？
A: P3-SAM对输入鲁棒，但 X-Part 更适合扫描或高质量生成网格。
Q: 轻量版与 Studio 的差别？
A: 轻量版便于本地复现与研究；Studio 提供更完整、更稳定的生产级功能与算力支持。
Q: 有在线体验吗？
A: 可使用 Hugging Face 轻量演示；需要全功能可前往 Hunyuan3D Studio。
