XPart 部件分解 · 可交互预览

EPPUR · 2026-06-18 · Tencent Hunyuan3D-Part / XPart 复现 · 生成式部件分解(P3-SAM bbox → PartFormer DiT 逐 part 生成)
← 返回铰接研究主线
这是什么: XPart 是 Hunyuan3D-Part 的生成式部件分解管线(非原面 relabel):①P3-SAM 从输入 mesh 预测逐部件 AABB;②PartFormer DiT(flow-matching)以"物体表面 latent + 每部件 bbox + Sonata 分割特征"为条件,逐 part 重新生成网格。下面的 mesh 可鼠标拖动旋转 / 滚轮缩放;每个部件一色。=INSTRUCT-PARTICULATE 那条专有图像生成分割前端的可行替代(本地、无限流)。

可交互:23 个部件(demo mesh data/000)

部件分解(原位,23 parts)
爆炸视图(explode)
左=原位分解,右=爆炸开。拖动可绕看;每个部件独立颜色 → 直观看出 P3-SAM+PartFormer 切出的 23 个部件(头/角耳/绿环饰/眼/躯干/四肢/连接关节件等)。GLB 各 ~16.8MB,首次加载需几秒。

静态渲染(pyrender EGL,亲眼核验)

原位分解三视角(多角度证明是真 3D 渲染,非贴图)。
爆炸视图:23 个部件分色摊开,分割语义连贯。

复现要点

说明
权重HF tencent/Hunyuan3D-Part(curl+sha 防 Xet;model.safetensors 6.6G 曾 CDN 截断,--retry -C- 续传)+ Sonata 骨干
环境conda_envs/trellis2 + torchdiffeq(那个 xpart clone 没建完缺 python,弃用)
真 bug + 修复23 part 生成后全在 _export 抛 "Unknown format for load: ply" → 真因是系统缺 libOpenGL.so.0,PyMeshLab 的 ply I/O 插件加载失败(报错伪装成 trimesh,实为 PyMeshLab 抛);apt download libopengl0 放进 pymeshlab lib 目录修好,无需改源码
性质部件是重新生成的几何(非原 mesh 面 relabel);原面 relabel 是另一个 P3-SAM-only 路径
EPPUR · XPart (Hunyuan3D-Part) 复现 · 2026-06-18 · 真实推理 + pyrender EGL 真实渲染 + GLB 可交互 · RESUME: method_repos/Hunyuan3D-Part/XPart/RESUME_XPART_20260618.md