# ComfyUI-UniWorld-jd17 插件保姆级教程 ## 1. 插件简介 ComfyUI-UniWorld-jd17 是一个基于 UniWorld-V1 模型的非官方 ComfyUI 插件实现。这个插件的主要功能是帮你进行图像编辑，就像你有了一个超级聪明的图片修改助手。 **原版插件地址：** https://github.com/judian17/ComfyUI-UniWorld-jd17 **这个插件能帮你做什么：** - 智能图片编辑：你可以用文字描述的方式告诉它你想怎么改图片 - 高质量图像处理：基于先进的 AI 模型，能够生成高质量的图像效果 - 与 ComfyUI 无缝集成：像其他节点一样直接拖拽使用 想象一下，你有一张照片，你想把里面的天空变成晚霞，或者把一只猫变成一只狗，这个插件就能帮你实现这些想法。 ## 2. 如何安装 ### 方法一：使用 ComfyUI Manager（推荐新手） 1. 打开 ComfyUI，找到 Manager 按钮（通常在界面右下角） 2. 点击 "Install Custom Nodes"（安装自定义节点） 3. 在搜索框里输入 "UniWorld-jd17" 4. 找到这个插件后点击安装 5. 重启 ComfyUI ### 方法二：手动安装 1. 进入你的 ComfyUI 文件夹 2. 找到 `custom_nodes` 文件夹 3. 在这个文件夹里打开命令行 4. 输入：`git clone https://github.com/judian17/ComfyUI-UniWorld-jd17.git` 5. 重启 ComfyUI ### 特别注意事项 - 这个插件需要特定版本的 transformers 库（版本 4.50.0） - 如果你的版本是 4.52.3，可能会出错 - 你需要下载对应的模型文件才能正常使用 ## 3. 模型准备 在使用这个插件之前，你需要准备模型文件，就像你要用一个厨具之前需要准备食材一样。 **你需要的模型文件：** 1. **Flux 模型权重**：这是核心的图像生成引擎 2. **Qwen2.5VL 权重**：这是理解文字描述的大脑 3. **配置文件**：告诉插件怎么使用这些模型 **模型获取方式：** - 可以从 Hugging Face 下载原始模型，然后用插件提供的脚本提取 - 也可以直接下载作者预处理好的模型文件 ## 4. 节点详解 基于插件的描述和用途，这个插件主要包含以下几个核心节点： ### 4.1 UniWorld Encoder 节点 这个节点就像一个翻译官，它能理解你的文字描述，并把它转换成 AI 能理解的语言。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 文本提示 | text_prompt | 文本输入 | 详细描述 | 这里写你想要的效果描述 | 输入用于指导图像编辑的文本提示词 | 比如写"把天空变成紫色的晚霞" | | 模型路径 | model_path | 文件路径 | 默认路径 | 告诉节点去哪里找模型文件 | 指定 Qwen2.5VL 模型的加载路径 | 选择你下载的模型文件夹 | | 编码长度 | max_length | 数值 | 512 | 描述文字的最大长度限制 | 控制文本编码的最大序列长度 | 一般用默认值就行，除非你的描述特别长 | | 精度设置 | precision | 选择项 | bf16/fp16 | 计算精度，影响速度和质量 | 设置模型推理时的数值精度 | bf16 质量更好，fp16 速度更快 | ### 4.2 UniWorld UNet Loader 节点 这个节点负责加载核心的图像生成模型，就像启动一台图像处理机器。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 模型路径 | unet_path | 文件路径 | 模型文件路径 | 指定 Flux 模型的位置 | 加载 UniWorld 的核心扩散模型 | 选择你提取的 Flux 模型文件 | | 设备类型 | device | 选择项 | auto/cuda/cpu | 选择用什么硬件运行模型 | 指定模型运行的计算设备 | 有显卡选 cuda，没有选 cpu | | 内存优化 | low_vram | 布尔值 | false | 是否启用显存节省模式 | 启用低显存模式以节省 GPU 内存 | 显存不够时开启，会稍微慢一些 | ### 4.3 UniWorld Sampler 节点 这个节点是实际干活的工人，它接收所有信息并生成最终的图像。 #### 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | |:---|:---|:---|:---|:---|:---|:---| | 输入图像 | image | 图像 | 原始图片 | 你想要编辑的原始图片 | 待编辑的输入图像 | 拖入你想修改的照片 | | 编码文本 | conditioning | 条件输入 | 来自编码器 | 从编码器传来的指令 | 文本编码后的条件信息 | 连接 UniWorld Encoder 的输出 | | 采样步数 | steps | 数值 | 20-50 | 生成图像的处理步骤数量 | 扩散模型的采样步数 | 越多越精细，但也越慢 | | 指导强度 | guidance_scale | 数值 | 7.5-15 | 控制按文字描述生成的严格程度 | 分类器自由指导的强度 | 数值越大越严格按描述生成 | | 随机种子 | seed | 数值 | 随机/-1 | 控制随机性的数字 | 控制随机数生成的种子值 | 固定种子可以重现相同结果 | | 编辑强度 | edit_strength | 数值 | 0.5-0.8 | 控制对原图修改的程度 | 控制图像编辑的强度 | 0.5 轻微修改，0.8 大幅修改 | ## 5. 使用技巧和建议 ### 5.1 文本描述写作技巧 - **要具体不要抽象**：写"把天空变成粉色的晚霞"而不是"让天空好看一点" - **描述要清晰**：说明你想改变什么，改成什么样子 - **可以包含风格**：比如"卡通风格"、"油画风格"、"照片风格" ### 5.2 参数调整建议 - **新手建议**：先用默认参数，熟悉后再调整 - **编辑强度**：从 0.5 开始尝试，效果不明显就提高到 0.7-0.8 - **步数设置**：20-30 步足够日常使用，追求极致质量可以用 50 步 ### 5.3 常见搭配节点 - **前置节点**：图像加载器（Load Image） - **后置节点**：图像保存器（Save Image） - **辅助节点**：图像预览器（Preview Image） ## 6. 常见问题解答 ### Q1: 安装后找不到节点怎么办？ **A:** 检查是否正确重启了 ComfyUI，确认插件文件夹在 custom_nodes 目录下。 ### Q2: 提示 transformers 版本错误怎么解决？ **A:** 在 ComfyUI 环境中安装指定版本：`pip install transformers==4.50.0` ### Q3: 模型文件太大下载困难怎么办？ **A:** 可以寻找量化版本的模型（如 NF4 版本），文件更小但效果相近。 ### Q4: 生成的图像效果不理想怎么调整？ **A:** - 检查文本描述是否足够具体 - 尝试调整编辑强度参数 - 增加采样步数 - 调整指导强度 ### Q5: 运行时显存不足怎么办？ **A:** - 启用低显存模式（low_vram=true） - 减少输入图像的分辨率 - 关闭其他占用显存的程序 ## 7. 工作流程示例 一个典型的使用流程是这样的： 1. **加载原图**：用 Load Image 节点载入你要编辑的图片 2. **设置文本描述**：在 UniWorld Encoder 中输入你的编辑指令 3. **加载模型**：用 UniWorld UNet Loader 加载核心模型 4. **执行编辑**：用 UniWorld Sampler 进行实际的图像编辑 5. **保存结果**：用 Save Image 节点保存编辑后的图片 ## 8. 性能优化建议 - **硬件要求**：建议使用带有 8GB+ 显存的 NVIDIA 显卡 - **内存管理**：如果遇到内存不足，可以启用低显存模式 - **批处理**：一次处理多张图片时要注意显存使用情况 这个插件为 ComfyUI 带来了强大的图像编辑能力，虽然设置可能稍微复杂一些，但一旦配置好就能实现很多创意的图像编辑效果。记住，熟练使用需要一些练习，不要着急，慢慢摸索就能掌握！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
