# Hunyuan3D 2mini 生成GLB教程

选择2mini形状模型，从一张原创玩具图生成GLB，再旋转检查背面电池、天线和悬空片。混元3D一张图建模是形状推断，不承诺精确复刻商品或直接用于3D打印。

## 执行范围

已执行：Blender 5.2.1原创几何、真实相机渲染、UV展开、CPU手工材质烘焙、GLB/OBJ导出重载；本题附带离线检查。未执行：目标项目模型下载/推理、Gradio运行、生成纹理/深度/视频mask。reference、geometry-reference、original命名文件都是原创输入或手工参考，绝非模型结果。官方图片只在网页按来源引用。

## 步骤

### 1. 先选单张输入，不把已知背面偷偷当参考

用front.png作为本次单图输入；left/back仅作为原创物件的已知结构核查。它们来自同一Blender模型，不能把三张都交给单图管线后仍称“只用一张图”。

### 2. 固定2mini模型与2.0代码路径

官方2mini使用tencent/Hunyuan3D-2mini和hunyuan3d-dit-v2-mini子目录；2.1是另一仓库。--low_vram_mode只是节省显存策略，不能当成本机CPU已验证可跑的保证。

### 3. 先在Gradio选择形状阶段

按commands.md启动官方2mini Gradio，在输入区放front.png，优先只跑形状。官方例图标有来源，本包没有启动Gradio或下载checkpoint，当前可打开网格是手工参考。

### 4. 生成后把真实GLB另存到独立目录

只接受工具本次实际返回的网格文件，记录seed、步数、模型规格、运行设备与时间。下载结果前确认任务状态；不要把reference-colored.glb改名为实际模型成功。

### 5. 在查看器旋转看三个结构检查点

本包viewer.html可实际加载手工参考GLB/OBJ并切线框；用于练习发现背面电池、非对称天线、脚底。把实际模型结果也导入Blender后，用相同角度比较，而不是只截正面。

### 6. 检查网格与用途边界

核对网格数量、尺寸、法线、悬空片和不合理封口。单图生成看不到的背面靠先验补全；GLB能打开不等于拓扑可制造，也不等于密闭可打印。

### 7. 同时留存参考与模型输出身份

下载包里的Blender重载记录证明参考文件可读；runtime.json仍写模型未执行。完成自己的推理后，另放actual-shape.glb和实际运行记录，不覆盖参考与原图。

## 命令

```bash
# 在Hunyuan3D-2官方仓库与匹配CUDA环境中
python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
# 本包只查看手工参考，不启动模型
python3 -m http.server 8391 --bind 127.0.0.1
# 浏览器打开 http://127.0.0.1:8391/viewer.html
```

## 参考文件

- 以“本题实际文件”列表为准：original-toy.png或front.png/views为Blender原创输入。
- 若本包含reference-colored.glb：它是手工材质参考。
- 若本包含reference-textured.obj/MTL/PNG：它们是Blender真实UV/烘焙交换文件。
- 若本包含geometry-reference-depth.npy/PLY：它们是原创场景已知几何，非深度模型预测。
- runtime.json：目标模型初始not-executed。
- verification.json / blender-reload.json：文件及重载证据，不是模型生成证据。

## 官方依据

https://github.com/Tencent-Hunyuan/Hunyuan3D-2
https://github.com/Tencent-Hunyuan/Hunyuan3D-2#gradio-app

## 本题实际文件

- `back.png`
- `blender-reload.json`
- `cameras.json`
- `clay-back.png`
- `clay-front.png`
- `commands.md`
- `exchange-reload.json`
- `front.png`
- `helper-checks.json`
- `left.png`
- `original-toy.png`
- `reference-camera-scene.glb`
- `reference-clay.glb`
- `reference-colored.glb`
- `reference-texture.png`
- `reference-textured.glb`
- `reference-textured.mtl`
- `reference-textured.obj`
- `reference-vertexcolor.glb`
- `review.csv`
- `runtime.json`
- `verify.py`
- `viewer.html`
- `viewer.js`
- `views/view-00.png`
- `views/view-01.png`
- `views/view-02.png`
- `views/view-03.png`
- `views/view-04.png`
- `views/view-05.png`

模型命令仅供在你准备好的官方环境执行；from_pretrained类入口首次运行可能拉取大权重，本轮没有执行。