展开本页目录
开始前准备什么
- 把本题ZIP解压到独立目录，保留原始文件与README中的素材身份。
- 模型步骤需在官方支持的隔离环境、相应权重与硬件中运行；本包不含权重，不承诺Apple本机支持CUDA。
- 本地文件检查使用Python、NumPy/Pillow或Blender；模型运行与素材/格式校验是分开的证据。
- 先选单张输入，不把已知背面偷偷当参考
- 固定2mini模型与2.0代码路径
- 先在Gradio选择形状阶段
- 生成后把真实GLB另存到独立目录
- 在查看器旋转看三个结构检查点
- 检查网格与用途边界
- 同时留存参考与模型输出身份
原创输入、真实参考文件、命令、脚本、运行边界与逐项清单；不含模型权重。
明确哪些材料已运行，哪些目标模型步骤尚未执行。
真实可打开的练习输入或手工参考，均不是目标模型输出。
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，当前可打开网格是手工参考。
commands.md
# 在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.html4. 生成后把真实GLB另存到独立目录
只接受工具本次实际返回的网格文件，记录seed、步数、模型规格、运行设备与时间。下载结果前确认任务状态；不要把reference-colored.glb改名为实际模型成功。
5. 在查看器旋转看三个结构检查点
本包viewer.html可实际加载手工参考GLB/OBJ并切线框；用于练习发现背面电池、非对称天线、脚底。把实际模型结果也导入Blender后，用相同角度比较，而不是只截正面。
6. 检查网格与用途边界
核对网格数量、尺寸、法线、悬空片和不合理封口。单图生成看不到的背面靠先验补全；GLB能打开不等于拓扑可制造，也不等于密闭可打印。
7. 同时留存参考与模型输出身份
下载包里的Blender重载记录证明参考文件可读；runtime.json仍写模型未执行。完成自己的推理后，另放actual-shape.glb和实际运行记录，不覆盖参考与原图。
怎样确认已经完成
- 原始输入、人工参考、官方示例和实际模型输出标识分开。
- 保存真实帧号/坐标/对象ID或几何版本，不只凭文件能打开判断质量。
- 模型未运行时保留not-executed，不把参考文件复制更名为成功结果。
常见问题
混元3D一张图建模能精确还原背面吗？
不能保证。单图没有提供背面证据，需旋转检查不对称结构；有一致多视图时再用专用2mv模型，不往单图入口随意塞图片列表。
2mini GLB可以直接3D打印吗？
本题不作此保证。需要额外检查封闭性、非流形边、厚度、真实比例和制造要求；能在查看器旋转只是基本文件验收。
本页能下载的GLB是谁生成的？
它是实际Blender原创几何的手工参考，已导出重载；未运行Hunyuan3D模型，不能当作其画质或速度样本。