%20(1).png)
ComfyUI-StableXWrapper 插件保姆级教程
1. 插件简介
GitHub原地址： https://github.com/kijai/ComfyUI-StableXWrapper
ComfyUI-StableXWrapper 是一个专门为 ComfyUI 设计的插件，它就像是一个"翻译官"，帮助我们在 ComfyUI 里面使用 StableX 系列的 AI 模型。
这个插件主要包含两个厉害的功能： - StableNormal：把普通图片变成法线图（就像把平面照片变成有立体感的凹凸贴图） - StableDelight：可以重新给图片打光，让图片的光影效果更好看
简单来说，如果你想让你的图片看起来更有立体感，或者想调整图片的光影效果，这个插件就是你的好帮手！
2. 如何安装
方法一：ComfyUI Manager 安装（推荐）
- 打开 ComfyUI，点击右下角的"Manager"按钮
- 在弹出的窗口中点击"Install Custom Nodes"
- 搜索"StableXWrapper"
- 找到后点击"Install"按钮
- 安装完成后重启 ComfyUI
方法二：手动安装
- 打开 ComfyUI 的安装文件夹
- 进入
custom_nodes文件夹 - 在这里打开命令行/终端
- 输入：
git clone https://github.com/kijai/ComfyUI-StableXWrapper.git - 重启 ComfyUI
3. 节点详细解析
3.1 StableNormal 节点 - 法线图生成器
这个节点就像是一个"立体感制造机"，它能把你的平面图片分析出凹凸信息，生成一张特殊的法线图。
3.1.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | 图片数据 | - | 就像往打印机里放纸一样，这里放你要处理的图片 | 输入的原始图像数据 | 连接一个图片加载节点 |
| 模型路径 | model_path | 文件路径 | 默认路径 | 告诉电脑去哪里找这个AI大脑（模型文件） | StableNormal模型文件的存储位置 | 选择下载好的模型文件 |
| 强度 | strength | 0.1-2.0 | 1.0 | 就像调节立体感的强弱，数值越大立体感越明显 | 控制法线图生成的强度 | 人脸用0.8，建筑用1.2 |
| 降噪步数 | steps | 1-100 | 20 | 就像画画的笔画数，越多越精细但越慢 | 模型推理的迭代步数 | 快速预览用10，最终出图用50 |
| 引导系数 | guidance_scale | 1.0-20.0 | 7.5 | 就像告诉AI"听话程度"，数值越大越按你的要求来 | 控制模型对输入的遵循程度 | 简单图片用5，复杂图片用10 |
3.2 StableDelight 节点 - 重新打光器
这个节点就像是一个"专业灯光师"，能够重新给你的图片安排光影效果。
3.2.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | 图片数据 | - | 就像给灯光师一张照片，让他重新打光 | 需要重新光照的原始图像 | 连接图片加载节点 |
| 光照条件 | lighting_condition | 文本描述 | "soft lighting" | 用大白话描述你想要什么样的光效 | 光照条件的文本描述 | "温暖的夕阳光"、"柔和的室内灯光" |
| 模型路径 | model_path | 文件路径 | 默认路径 | 告诉电脑去哪里找重新打光的AI大脑 | StableDelight模型的存储位置 | 选择对应的模型文件 |
| 光照强度 | lighting_strength | 0.1-2.0 | 1.0 | 就像调节灯泡的亮度，控制光效的强弱 | 控制光照效果的强度 | 自然光用0.8，戏剧光用1.5 |
| 保持原始细节 | preserve_details | 0.0-1.0 | 0.7 | 就像化妆时保留原本的脸部特征，数值越高越保留原图细节 | 控制原始图像细节的保留程度 | 人像用0.8，风景用0.6 |
| 种子值 | seed | 0-999999 | 随机 | 就像抽奖的号码，相同号码会得到相同结果 | 控制随机性的种子值 | 想要固定效果就用固定数字 |
3.3 StableX 模型加载器
这个节点就像是一个"模型管理员"，负责加载和管理不同的StableX模型。
3.3.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型类型 | model_type | 选择列表 | StableNormal | 就像选择不同的工具，每种工具有不同的功能 | 选择要加载的模型类型 | 做法线图选Normal，重新打光选Delight |
| 模型精度 | precision | fp16/fp32 | fp16 | 就像选择画质，fp16省内存但质量稍低 | 模型运行时的数值精度 | 显存小选fp16，显存大选fp32 |
| 设备选择 | device | cpu/cuda | cuda | 就像选择用电脑还是显卡来干活，显卡更快 | 选择运行设备 | 有N卡选cuda，没有选cpu |
| 内存优化 | memory_optimization | 开/关 | 开 | 就像整理房间节省空间，开启后省内存但稍慢 | 是否启用内存优化 | 显存不够就开启 |
3.4 图片预处理器
这个节点就像是一个"图片整理师"，在交给AI处理前先把图片整理好。
3.4.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | 图片数据 | - | 就像给理发师一张照片，准备进行造型 | 需要预处理的原始图像 | 连接图片加载节点 |
| 尺寸调整 | resize_mode | 多种选择 | 保持比例 | 就像调整照片大小，可以拉伸或保持原比例 | 图像尺寸调整的方式 | 一般选择保持比例不变形 |
| 目标尺寸 | target_size | 数值 | 512 | 就像选择照片的最终尺寸，太大会很慢 | 处理后的图像尺寸 | 快速测试用256，最终用1024 |
| 填充模式 | padding_mode | 多种选择 | 反射 | 当图片比例不合适时，选择如何填充空白 | 图像填充的方式 | 反射填充最自然 |
| 归一化 | normalize | 开/关 | 开 | 就像统一照片的曝光度，让AI更容易理解 | 是否对图像进行归一化 | 一般都开启 |
3.5 结果后处理器
这个节点就像是一个"照片修饰师"，对AI生成的结果进行最后的调整。
3.5.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入结果 | input_result | 处理结果 | - | 就像接收AI的作品，准备进行最后修饰 | AI处理后的结果数据 | 连接前面的处理节点 |
| 对比度调整 | contrast | 0.5-2.0 | 1.0 | 就像调节电视的对比度，让图片更清晰 | 调整图像的对比度 | 太灰调到1.2，太刺眼调到0.8 |
| 亮度调整 | brightness | 0.5-2.0 | 1.0 | 就像调节手机亮度，让图片更亮或更暗 | 调整图像的整体亮度 | 太暗调到1.2，太亮调到0.8 |
| 饱和度调整 | saturation | 0.0-2.0 | 1.0 | 就像调节照片的鲜艳程度 | 调整图像的颜色饱和度 | 想要鲜艳调到1.3，想要素雅调到0.7 |
| 输出格式 | output_format | PNG/JPG | PNG | 就像选择照片的保存格式 | 最终输出的图像格式 | 要透明背景选PNG，普通照片选JPG |
| 质量设置 | quality | 1-100 | 95 | 就像选择照片的清晰度，数值越高文件越大 | 输出图像的质量 | 网络分享用80，打印用95 |
4. 使用技巧和建议
4.1 新手入门建议
- 先用小图试试：刚开始用256x256的小图片练手，等熟悉了再用大图
- 保存好的参数：找到满意的效果后，记录下参数数值，下次可以直接用
- 多试几个种子值：同样的设置，不同的种子值会产生不同的效果
4.2 性能优化技巧
- 显存不够时：开启内存优化，使用fp16精度，减小图片尺寸
- 速度优化：减少降噪步数，使用较小的引导系数
- 质量优化：增加降噪步数，使用更大的图片尺寸
4.3 效果调优建议
- 法线图太强：降低强度参数到0.5-0.8
- 光照效果不明显：增加光照强度到1.2-1.5
- 细节丢失：提高保持原始细节的数值到0.8-0.9
5. 常见问题解答
5.1 安装相关问题
Q：安装后找不到节点？ A：重启ComfyUI后，清空浏览器缓存，或者按F5刷新页面。
Q：提示缺少模型文件？ A：需要单独下载StableNormal和StableDelight的模型文件，放到指定文件夹。
5.2 使用相关问题
Q：处理速度很慢？ A：尝试减小图片尺寸，开启内存优化，使用fp16精度。
Q：生成的法线图看起来很奇怪？ A：可能强度设置太高了，试试调低到0.5-0.8。
Q：重新打光后图片变得很模糊？ A：提高保持原始细节的参数，或者降低光照强度。
5.3 技术相关问题
Q：显存不够怎么办？ A：开启内存优化，使用fp16精度，处理更小的图片，或者选择CPU运行。
Q：结果不稳定怎么办？ A：使用固定的种子值，确保参数设置一致。
6. 进阶应用场景
6.1 游戏贴图制作
- 使用StableNormal为游戏模型生成法线贴图
- 结合传统纹理制作流程，提高效率
6.2 产品渲染优化
- 用StableDelight重新为产品照片打光
- 创造不同的光照氛围，提升产品吸引力
6.3 艺术创作
- 将平面艺术作品转换为具有立体感的作品
- 尝试不同的光照效果，创造独特的视觉风格
6.4 批量处理技巧
- 使用相同的参数设置批量处理多张图片
- 建立标准化的处理流程，确保结果一致性
小贴士： 这个插件功能很强大，但也需要一定的学习时间。建议先从简单的图片开始试验，逐步掌握各个参数的效果。记住，没有标准答案，最重要的是找到适合你需求的设置！