# ComfyUI Hunyuan3D EX 插件完全使用指南 ## 1. 插件简介 ComfyUI Hunyuan3D EX（地址：https://github.com/BIMer-99/Comfyui_Hunyuan3D_EX）是一个专门为ComfyUI设计的3D模型生成插件。这个插件就像是一个"魔法盒子"，你只需要给它一张图片，它就能帮你生成一个完整的3D模型。 **这个插件能给我们带来什么效果？** - 把平面照片变成立体的3D模型（就像把你的自拍照变成一个3D人偶） - 生成多角度视图（就像围着一个物体转一圈拍照） - 去除图片背景（就像用橡皮擦把背景擦掉） - 预览和保存3D模型（就像用3D打印机预览要打印的东西） 相比原版的混元3D，这个插件做了很多优化： - 安装更简单（不需要安装复杂的3D软件库） - 运行更稳定（去掉了容易出错的代码） - 界面更友好（有专门的3D预览窗口） ## 2. 如何安装 安装这个插件就像往你的工具箱里添加新工具一样简单： ### 方法一：通过ComfyUI管理器安装（推荐） 1. 打开ComfyUI 2. 点击右侧的"Manager"按钮 3. 搜索"Hunyuan3D EX" 4. 点击"Install"按钮 5. 重启ComfyUI ### 方法二：手动安装 1. 打开ComfyUI安装目录下的`custom_nodes`文件夹 2. 在命令行中运行：`git clone https://github.com/BIMer-99/Comfyui_Hunyuan3D_EX.git` 3. 进入插件目录：`cd Comfyui_Hunyuan3D_EX` 4. 安装依赖：`pip install -r requirements.txt` 5. 重启ComfyUI ## 3. 节点详细解析 ### 3.1 EX_Hunyuan3DNode - 3D模型生成器 这个节点就像是一个"3D打印机"，你给它提供材料（图片），它就给你输出一个3D模型。 **这个节点是干嘛的？** 它是整个插件的核心，负责把你的图片转换成3D模型。就像把一张纸上的画变成一个立体的雕塑。 #### 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 六视图图像 | sixImages | 图像输入 | 必填 | 就像给3D打印机提供六个角度的设计图 | 固定尺寸1024×1536的RGB格式六视图图像 | 连接EX_GenerateSixViews节点的输出 | | 原始图像 | originalImages | 图像输入 | 必填 | 就像给工厂提供原始设计稿 | 固定尺寸512×512的RGB格式原始图像 | 连接EX_GenerateSixViews节点的输出 | | 启用简化模型 | use_lite | 布尔值 | false | 就像选择"高质量"还是"快速模式" | 是否使用轻量化模型以提高生成速度 | 如果电脑配置不高，选择true | | 最大面数 | max_faces | 整数 | 50000 | 就像设置3D模型的"精细度" | 限制生成的3D模型的面数上限 | 数值越大模型越精细，但处理越慢 | ### 3.2 EX_GenerateSixViews - 多角度视图生成器 这个节点就像是一个"摄影师"，它会围着你的物体转一圈，从六个不同角度拍照。 **这个节点是干嘛的？** 它负责把你的单张图片扩展成六个不同角度的视图，就像把一张正面照扩展成全方位的照片集。 #### 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 透明背景图像 | rgba | 图像输入 | 必填 | 就像准备一个抠好图的素材 | RGBA格式的透明背景图像，推荐尺寸大于1024像素 | 先用EX_RemoveBackground去背景，再连接这里 | | 图像宽度 | width | 整数 | 1024 | 就像设置照片的宽度 | 生成六视图的宽度尺寸 | 一般保持1024即可 | | 图像高度 | height | 整数 | 1536 | 就像设置照片的高度 | 生成六视图的高度尺寸 | 一般保持1536即可 | | 种子值 | seed | 整数 | 随机 | 就像掷骰子的结果 | 控制生成结果的随机性 | 相同种子值会产生相同结果 | ### 3.3 EX_TriMeshViewer - 3D模型预览器 这个节点就像是一个"3D展示柜"，让你能看到刚刚生成的3D模型长什么样。 **这个节点是干嘛的？** 它负责显示和保存3D模型，就像一个3D模型的"相册"和"保存器"。 #### 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 3D模型 | mesh | 3D模型输入 | 必填 | 就像给展示柜放入要展示的模型 | 接收TriMesh格式的3D模型数据 | 连接EX_Hunyuan3DNode的mesh输出 | | 保存路径 | save_path | 字符串 | "output/" | 就像选择照片保存的相册 | 设置3D模型保存的文件夹路径 | 可以改成"models/my_3d/" | | 文件名前缀 | filename_prefix | 字符串 | "mesh" | 就像给照片起个名字 | 设置保存文件的名称前缀 | 可以改成"my_model" | | 显示模式 | display_mode | 下拉选择 | "solid" | 就像选择看模型的方式 | 设置3D模型的显示风格 | solid(实体), wireframe(线框), points(点云) | ### 3.4 EX_RemoveBackground - 背景去除器 这个节点就像是一个"魔术橡皮擦"，能把图片的背景完全擦掉，只留下主体。 **这个节点是干嘛的？** 它负责去除图片背景，就像用Photoshop的魔术棒工具把背景删掉一样。 #### 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入图像 | image | 图像输入 | 必填 | 就像给橡皮擦提供要处理的图片 | 需要去除背景的原始图像 | 连接任何图像加载节点 | | 去背模型 | model_name | 下拉选择 | "u2net" | 就像选择不同型号的橡皮擦 | 选择用于背景去除的AI模型 | u2net(通用), silueta(人像), isnet-general-use(高质量) | | 输出格式 | output_format | 下拉选择 | "RGBA" | 就像选择图片的保存格式 | 设置输出图像的格式 | RGBA(带透明度), RGB(不带透明度) | ### 3.5 EX_SquareImage - 图片方形化工具 这个节点就像是一个"相框裁剪器"，能把各种尺寸的图片变成正方形。 **这个节点是干嘛的？** 它负责把图片裁剪或调整成正方形，就像把长方形照片放进正方形相框里。 #### 参数详解 | 参数名 (界面显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入图像 | image | 图像输入 | 必填 | 就像给相框提供要处理的照片 | 需要调整为正方形的图像 | 连接任何图像加载节点 | | 目标尺寸 | target_size | 整数 | 512 | 就像设置相框的大小 | 正方形输出图像的边长像素数 | 512适合大多数情况 | | 填充方式 | fill_mode | 下拉选择 | "center" | 就像选择照片在相框里的位置 | 当原图不是正方形时的处理方式 | center(居中), stretch(拉伸), crop(裁剪) | | 背景颜色 | background_color | 颜色选择 | "white" | 就像选择相框的底色 | 当需要填充空白区域时使用的颜色 | white(白色), black(黑色), transparent(透明) | ## 4. 使用技巧和建议 ### 4.1 最佳工作流程 1. **准备图片**：使用高质量、清晰的图片，最好是单个物体，背景简单 2. **去除背景**：先用EX_RemoveBackground节点去除背景 3. **生成多视图**：用EX_GenerateSixViews生成六个角度的视图 4. **生成3D模型**：用EX_Hunyuan3DNode生成3D模型 5. **预览保存**：用EX_TriMeshViewer预览和保存结果 ### 4.2 参数调优技巧 - **电脑配置不高**：启用"简化模型"，降低"最大面数" - **追求高质量**：关闭"简化模型"，提高"最大面数"到100000 - **处理人像**：去背模型选择"silueta" - **处理复杂物体**：去背模型选择"isnet-general-use" ### 4.3 常见组合搭配 - **基础3D生成**：图像加载器 → EX_RemoveBackground → EX_GenerateSixViews → EX_Hunyuan3DNode → EX_TriMeshViewer - **批量处理**：图像批量加载器 → EX_SquareImage → EX_RemoveBackground → 其他节点 - **高质量输出**：在EX_Hunyuan3DNode中设置max_faces为100000，use_lite为false ## 5. 常见问题解答 ### Q1: 为什么生成的3D模型看起来不立体？ **答**：可能是输入图片的角度或光线问题。建议使用正面拍摄、光线均匀的图片。 ### Q2: 去背景效果不好怎么办？ **答**：尝试更换不同的去背模型，或者在拍摄时使用纯色背景。 ### Q3: 生成速度很慢怎么办？ **答**：启用"简化模型"选项，或者降低"最大面数"参数。 ### Q4: 3D模型保存在哪里？ **答**：默认保存在ComfyUI的output文件夹中，可以在EX_TriMeshViewer节点中修改保存路径。 ### Q5: 支持哪些图片格式？ **答**：支持常见的图片格式如JPG、PNG、WEBP等。 ## 6. 进阶使用技巧 ### 6.1 制作高质量3D模型的秘诀 - **拍摄技巧**：使用三脚架固定相机，确保图片清晰 - **光线设置**：使用均匀的环境光，避免强烈阴影 - **背景选择**：使用纯色或渐变背景，便于后期去除 - **物体摆放**：确保物体完整显示在画面中 ### 6.2 批量处理工作流 对于需要处理多张图片的情况，可以结合ComfyUI的批处理节点： 1. 使用"Load Images"节点加载多张图片 2. 连接到EX_SquareImage统一尺寸 3. 依次通过各个处理节点 4. 最后批量保存结果 ### 6.3 与其他插件的联动 这个插件可以与其他ComfyUI插件配合使用： - **图像增强插件**：先增强图片质量再生成3D - **风格转换插件**：对生成的多视图进行风格化 - **动画插件**：为生成的3D模型添加动画效果 ## 7. 总结 ComfyUI Hunyuan3D EX插件是一个功能强大且易于使用的3D生成工具。通过合理的参数设置和工作流程安排，你可以轻松地把平面图片转换成立体的3D模型。记住，好的输入图片是成功的一半，多尝试不同的参数组合，你会发现更多有趣的效果！ 这个插件特别适合： - 3D建模爱好者 - 游戏开发者 - 产品设计师 - 教育工作者 - 任何对3D技术感兴趣的朋友 现在就开始你的3D创作之旅吧！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
