%20(1).png)
ComfyUI-CatvtonFluxWrapper 插件完全教程
1. 插件简介
插件地址： https://github.com/lujiazho/ComfyUI-CatvtonFluxWrapper
ComfyUI-CatvtonFluxWrapper 是一个专门用来做虚拟试衣的插件，就像你在网上购物时的"试穿"功能一样。这个插件可以让你把任何衣服"穿"到任何人身上，生成非常逼真的试衣效果。它基于最新的 CatvtonFlux 技术，能够智能地处理衣服的形状、褶皱和光影效果。
这个插件能给我们带来什么效果？
- 👗 虚拟试衣：把任何衣服穿到任何人身上，看看效果如何
- 🎨 服装设计：设计师可以快速预览服装在不同人身上的效果
- 🛍️ 电商应用：网店可以展示衣服在不同模特身上的效果
- 📸 创意摄影：摄影师可以快速更换模特的服装进行创作
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI Manager
- 搜索 "CatvtonFluxWrapper"
- 点击安装即可
方法二：手动安装
- 打开你的 ComfyUI 文件夹，找到
custom_nodes目录 - 在命令行中输入：
cd ComfyUI/custom_nodes
git clone https://github.com/lujiazho/ComfyUI-CatvtonFluxWrapper.git
重要提醒：
- 使用前需要设置 Hugging Face 令牌
- 访问 https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev 接受使用协议
- 在 Hugging Face 设置中获取访问令牌
- 设置环境变量：
HF_TOKEN=你的令牌和HUGGING_FACE_HUB_TOKEN=你的令牌
3. 节点详细解析
3.1 LoadCatvtonFlux 节点 - Catvton模型加载器
这个节点是干嘛的？
这个节点就像一个"虚拟试衣间的开关"，它负责加载专门用于虚拟试衣的 AI 模型。你可以把它想象成启动一个智能试衣镜，只有先开启这个功能，才能进行后续的试衣操作。这个节点会自动下载和加载所有必需的模型文件。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 无参数 | - | - | - | 这个节点不需要任何设置，直接使用即可 | 自动加载预训练的 CatvtonFlux 模型和 LoRA 权重 | 直接连接到工作流中，无需任何调整 |
3.2 CatvtonFluxSampler 节点 - 虚拟试衣采样器
这个节点是干嘛的？
这是整个插件的核心，就像一个"智能试衣师"。它接收人物照片、衣服图片和遮罩信息，然后生成试衣后的效果图。这个过程就像有一个超级厉害的造型师，能够完美地把衣服"穿"到人身上，还能处理各种复杂的细节。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Catvton模型 | CatvtonFluxModel | CatvtonFluxModel | - | 这里要连接上面加载器节点的输出，就像把试衣镜连接到电源 | 从 LoadCatvtonFlux 节点传入的已加载模型 | 用线连接 LoadCatvtonFlux 的输出 |
| 提示词 | prompt | 文本 | "高质量的试衣照片" | 描述你想要的试衣效果，比如"穿着红色连衣裙的优雅女性" | 用于指导图像生成的文本描述 | 输入："woman wearing elegant dress" |
| 人物图片 | image | IMAGE | - | 要试衣的人物照片，最好是正面、清晰的全身照 | 作为试衣基础的人物图像 | 上传一张清晰的人物照片 |
| 遮罩 | mask | MASK | - | 标记要替换衣服的区域，就像用画笔圈出要换衣服的部分 | 指定需要替换服装的区域掩码 | 用画笔工具圈出衣服区域 |
| 服装图片 | garment | IMAGE | - | 要试穿的衣服图片，最好是平铺或模特穿着的清晰照片 | 要应用到人物身上的服装图像 | 上传一张清晰的衣服照片 |
| 步数 | steps | 1-100 | 30 | 生成图片时的计算次数，步数越多效果越好但时间越长 | 扩散模型的推理步数，影响生成质量 | 快速预览用20步，高质量用30-50步 |
| 引导强度 | guidance_scale | 1.0-50.0 | 30.0 | 控制生成结果有多"听话"，数字越大越严格按照提示词生成 | 分类器自由引导的强度，控制生成内容与提示词的匹配度 | 一般用30，想要更精确可以调到35-40 |
| 随机种子 | seed | 0-很大的数字 | 0 | 就像掷骰子的结果，相同的种子会生成相同的图片 | 随机数生成器的种子值，确保结果可重现 | 想要随机效果用0，想重现结果记住数字 |
| 宽度 | width | 像素 | 768 | 生成图片的宽度，单位是像素点 | 输出图像的宽度尺寸 | 一般用768或1024，太小会模糊 |
| 高度 | height | 像素 | 1024 | 生成图片的高度，单位是像素点 | 输出图像的高度尺寸 | 人物照片一般用1024，横向照片用768 |
| 保持在显卡 | keep_in_GPU | True/False | False | 处理完后是否把模型留在显卡内存里，True会更快但占内存 | 是否在推理完成后保持模型在 GPU 内存中 | 显卡内存够用且要连续处理可以选True |
3.3 LoadCatvtonFluxLoRA 节点 - LoRA权重加载器
这个节点是干嘛的？
这个节点就像给原有的模型"加装配件"，LoRA是一种特殊的模型增强技术，可以让模型在特定任务上表现更好。对于虚拟试衣来说，它能让试衣效果更加自然和逼真。这个节点适合那些已经有基础Flux模型，想要添加试衣功能的用户。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 基础模型 | MODEL | MODEL | - | 这里连接你已有的Flux模型，就像给汽车加装新功能 | 需要加载 LoRA 权重的基础 Flux 模型 | 连接现有的Flux模型节点输出 |
3.4 ModelPrinter 节点 - 模型信息打印器
这个节点是干嘛的？
这个节点就像一个"模型检查器"，它可以显示模型的详细信息，比如模型有多少层、每层的大小等等。这主要是给开发者和高级用户用来调试和检查模型是否正确加载的工具，就像医生用的体检设备一样。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型 | MODEL | MODEL | - | 要检查的模型，连接后会在控制台显示模型的详细信息 | 输入要打印信息的模型对象 | 连接任何模型节点，查看控制台输出 |
4. 使用技巧和建议
4.1 图片准备技巧
- 人物照片：选择正面、清晰、光线充足的全身照，避免复杂背景
- 服装图片：最好是平铺的衣服照片或模特穿着的清晰照片
- 遮罩制作：精确圈出要替换的衣服区域，边缘要平滑
4.2 参数调优建议
- 新手设置：steps=20, guidance_scale=30, 使用默认尺寸
- 高质量设置：steps=30-50, guidance_scale=35-40
- 快速预览：steps=15-20, guidance_scale=25-30
4.3 工作流程建议
- 自动分割流程：使用SAM2自动识别衣服区域
- 手动绘制流程：手动精确绘制要替换的区域
- 批量处理：启用"保持在显卡"选项提高连续处理速度
5. 常见问题解答
Q1: 为什么生成的试衣效果不自然？
A: 可能是遮罩不够精确，试试重新绘制遮罩，确保完全覆盖要替换的衣服区域，边缘要平滑。
Q2: 提示需要Hugging Face令牌怎么办？
A: 访问 https://huggingface.co/black-forest-labs/FLUX.1-Fill-dev 接受协议，然后在设置中获取令牌，设置环境变量。
Q3: 生成速度很慢怎么办？
A: 减少步数到20，或者启用"保持在显卡"选项，确保显卡内存充足。
Q4: 衣服的颜色和原图不一样怎么办？
A: 在提示词中明确描述衣服的颜色，比如"red dress"或"blue shirt"。
Q5: 可以处理什么类型的衣服？
A: 大部分常见服装都可以，包括上衣、裙子、裤子等，但复杂的配饰效果可能不够理想。
6. 实用工作流程示例
基础试衣流程：
- LoadCatvtonFlux → 加载试衣模型
- 准备素材 → 人物照片 + 服装图片 + 手绘遮罩
- CatvtonFluxSampler → 生成试衣效果
SAM2自动分割流程：
- LoadCatvtonFlux → 加载试衣模型
- SAM2分割 → 自动识别衣服区域
- CatvtonFluxSampler → 生成试衣效果
LoRA增强流程：
- 加载基础Flux模型 → 使用现有模型
- LoadCatvtonFluxLoRA → 添加试衣功能
- 手动处理 → 配合其他节点使用
7. 注意事项
7.1 硬件要求
- 显卡内存：建议至少8GB，16GB更佳
- 系统内存：建议16GB以上
- 存储空间：模型文件较大，预留10GB以上空间
7.2 使用限制
- 需要网络连接下载模型
- 首次使用需要较长的模型下载时间
- 对图片质量要求较高
7.3 最佳实践
- 使用高质量的输入图片
- 精确制作遮罩
- 合理设置参数平衡质量和速度
- 多尝试不同的提示词
8. 总结
ComfyUI-CatvtonFluxWrapper 插件为我们提供了一个强大的虚拟试衣工具。通过合理使用这 4 个节点，你可以：
- 👗 创建逼真的虚拟试衣效果
- 🎨 快速预览服装设计方案
- 🛍️ 为电商平台制作试衣展示
- 📸 进行创意摄影和时尚创作
记住，好的输入图片和精确的遮罩是成功的关键，多练习不同的参数组合，你会发现这个插件的无限可能！