%20(1).png)
ComfyUI-Lotus 插件保姆级教程
1. 插件简介
插件地址： https://github.com/kijai/ComfyUI-Lotus
ComfyUI-Lotus 是一个神奇的"3D透视眼"插件！想象一下，这个插件就像给你的电脑装上了一双特殊的眼睛，能够看透照片里物体的深度和表面纹理。
这个插件能给我们带来什么效果？
这个插件主要有两个超能力：
-
深度感知能力：就像人眼能判断哪个物体近哪个物体远一样，这个插件能分析照片中每个像素的远近距离，生成一张"深度图"。深度图就像一张黑白照片，白色代表离你很近的东西，黑色代表离你很远的东西。
-
表面纹理感知能力：就像用手摸物体能感受到表面的凹凸不平一样，这个插件能分析照片中物体表面的纹理方向，生成一张"法线图"。法线图用不同的颜色表示表面朝向不同方向。
实际应用场景：
- 3D建模：把2D照片转换成3D模型的基础数据
- 游戏开发：为游戏场景添加真实的深度效果
- AR/VR应用：让虚拟现实更加逼真
- 图片后期处理：添加景深效果、光影效果等
2. 如何安装
安装前准备
在安装插件之前，你需要下载模型文件（就像给这双"特殊眼睛"配上合适的"眼镜"）：
- 下载Lotus模型：
- 去 HuggingFace 下载模型文件
- 把下载的模型文件放到
ComfyUI/models/diffusion_models文件夹里
可用的模型文件：
lotus-depth-g-v1-0-fp16.safetensors：用于生成深度图的模型lotus-normal-g-v1-0-fp16.safetensors：用于生成法线图的模型
插件安装方法
方法一：通过ComfyUI管理器安装（推荐）
- 打开 ComfyUI
- 点击 "Manager"（管理器）
- 选择 "Custom Nodes Manager"（自定义节点管理器）
- 搜索 "Lotus"
- 点击 "Install"（安装）
方法二：通过Git地址安装
- 打开 ComfyUI
- 点击 "Manager"（管理器）
- 选择 "Install via Git URL"（通过Git地址安装）
- 输入：
https://github.com/kijai/ComfyUI-Lotus.git - 点击安装
安装完成后重启 ComfyUI 即可使用。
3. 节点详细解析
3.1 LoadLotusModel 节点 - 模型加载管家
这个节点就像一个"模型管家"，负责把Lotus的"特殊眼睛"装到你的电脑里，让它准备好开始工作。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | 下拉选择框 | 根据需求选择 | 选择要使用的"眼镜"类型，就像近视眼镜和老花镜有不同用途 | 选择要加载的Lotus模型文件 | 选depth模型生成深度图，选normal模型生成法线图 |
| precision | precision | 下拉选择 | fp16 | 计算精度，就像选择计算器是精确到小数点后几位 | 模型运行时的数值精度设置 | fp16速度快占内存少，fp32更精确但更慢 |
可选的模型类型：
- depth模型：专门用来看"远近"的眼镜，生成深度图
- normal模型：专门用来看"表面纹理"的眼镜，生成法线图
可选的精度设置：
fp16：半精度，速度快，内存占用少，适合大多数情况fp32：全精度，更准确但速度慢，内存占用大
输出接口：
lotus_unet：装好的"特殊眼睛"，准备开始分析照片
3.2 LotusSampler 节点 - 图片分析师
这个节点就像一个专业的"图片分析师"，使用装好的"特殊眼睛"来分析照片，生成深度图或法线图。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| lotus_unet | lotus_unet | 连接输入 | 来自LoadLotusModel | 接收装好的"特殊眼睛"，就像分析师戴上眼镜准备工作 | 接收加载好的Lotus模型 | 必须连接LoadLotusModel节点的lotus_unet输出 |
| samples | samples | 连接输入 | 来自VAEEncode | 接收要分析的照片数据，就像给分析师一张要研究的照片 | 接收编码后的图像潜在表示 | 通常连接VAEEncode节点的输出 |
| seed | seed | 整数 | 123 | 随机种子，就像掷骰子的起始数字，相同种子产生相同结果 | 控制随机数生成的种子值，确保结果可重现 | 设为固定值可以得到一致的结果 |
| per_batch | per_batch | 整数 | 4 | 每次处理几张图片，就像分析师一次看几张照片 | 批处理大小，控制每次处理的图像数量 | 数值越大处理越快但占用内存越多 |
| keep_model_loaded | keep_model_loaded | 开关 | False | 是否保持模型在内存中，就像分析师是否一直戴着眼镜 | 控制处理完成后是否保持模型在显存中 | True可以加快后续处理，但会占用显存 |
输出接口：
samples：分析结果，包含深度信息或法线信息的数据
4. 使用技巧和建议
4.1 基础工作流程
深度图生成工作流：
- LoadImage → 加载要分析的照片
- VAEEncode → 把照片转换成电脑能理解的格式
- LoadLotusModel → 加载深度分析模型（选择depth模型）
- LotusSampler → 分析照片生成深度数据
- VAEDecode → 把分析结果转换回图片格式
- ImageInvert → 反转颜色（深度图通常需要反转）
- PreviewImage → 查看最终的深度图
法线图生成工作流：
- LoadImage → 加载要分析的照片
- VAEEncode → 把照片转换成电脑能理解的格式
- LoadLotusModel → 加载法线分析模型（选择normal模型）
- LotusSampler → 分析照片生成法线数据
- VAEDecode → 把分析结果转换回图片格式
- PreviewImage → 查看最终的法线图
4.2 性能优化建议
内存优化：
- precision选择：一般情况下选择
fp16，既快又省内存 - per_batch设置：如果内存不够，把per_batch设为1或2
- keep_model_loaded：如果只处理一张图片，设为False节省内存
速度优化：
- 批量处理：如果要处理多张图片，增大per_batch值
- 模型保持：频繁使用时设置keep_model_loaded为True
- 合适的VAE：使用SD1.5或SD2.0的VAE，兼容性最好
4.3 模型选择指南
| 需求 | 推荐模型 | 用途说明 |
|---|---|---|
| 制作3D效果 | lotus-depth-g | 生成深度图，用于3D建模 |
| 表面纹理分析 | lotus-normal-g | 生成法线图，用于材质制作 |
| 游戏开发 | 两个都需要 | 深度图做景深，法线图做材质 |
| AR/VR应用 | lotus-depth-g | 主要需要深度信息 |
4.4 常见设置组合
快速预览设置：
- precision: fp16
- per_batch: 4
- keep_model_loaded: False
高质量处理设置：
- precision: fp32
- per_batch: 1
- keep_model_loaded: True
批量处理设置：
- precision: fp16
- per_batch: 8（根据显存调整）
- keep_model_loaded: True
5. 常见问题解答
Q1：为什么生成的深度图是反的？
A1： 这是正常现象：
- Lotus生成的深度图中，黑色表示近，白色表示远
- 通常我们习惯白色表示近，黑色表示远
- 解决方法：在VAEDecode后面加一个ImageInvert节点反转颜色
Q2：内存不够用怎么办？
A2： 尝试以下方法：
- 把precision改为fp16
- 把per_batch改为1
- 把keep_model_loaded设为False
- 关闭其他占用内存的程序
- 使用较小尺寸的输入图片
Q3：处理速度很慢？
A3： 优化建议：
- 确保使用GPU而不是CPU
- 增大per_batch值（在内存允许的情况下）
- 设置keep_model_loaded为True（如果要处理多张图片）
- 使用fp16精度而不是fp32
Q4：生成的结果不理想？
A4： 检查以下几点：
- 确保使用了正确的模型（depth用于深度，normal用于法线）
- 输入图片质量要好，清晰度要高
- 尝试不同的seed值
- 确保VAE模型兼容（推荐使用SD1.5/2.0的VAE）
Q5：模型文件下载失败？
A5： 解决方法：
- 检查网络连接
- 尝试使用VPN或代理
- 从其他镜像站点下载
- 确保下载的文件完整，没有损坏
6. 实际应用案例
6.1 制作3D立体效果
原图 → VAEEncode → LoadLotusModel(depth) → LotusSampler → VAEDecode → ImageInvert → 深度图
用生成的深度图可以在后期软件中制作3D立体效果。
6.2 游戏材质制作
原图 → VAEEncode → LoadLotusModel(normal) → LotusSampler → VAEDecode → 法线图
用生成的法线图可以为游戏模型添加真实的表面细节。
6.3 AR应用开发
实时照片 → 深度分析 → 虚拟物体放置
利用深度信息可以让虚拟物体正确地放置在现实场景中。
6.4 照片后期处理
人像照片 → 深度图 → 景深效果 → 专业人像
利用深度图可以制作专业的背景虚化效果。
7. 技术原理简单解释
7.1 深度图原理
想象你闭上一只眼睛看世界，虽然失去了立体感，但大脑仍然能根据物体的大小、遮挡关系、光影等线索判断远近。Lotus的深度模型就是模拟这个过程，通过分析图片中的各种视觉线索来推断每个像素的深度。
7.2 法线图原理
法线图记录的是表面每个点的"朝向"。想象你用手电筒照射一个球，球面上每个点反射光线的方向都不同。法线图就是用颜色来记录这些方向信息：
- 红色通道记录左右方向
- 绿色通道记录上下方向
- 蓝色通道记录前后方向
8. 总结
ComfyUI-Lotus 插件虽然只有2个节点，但功能非常强大：
- LoadLotusModel：模型加载管家，负责准备分析工具
- LotusSampler：图片分析师，负责实际的深度/法线分析
这个插件的核心价值在于：
- 简单易用：只需要2个节点就能完成复杂的3D分析
- 效果出色：基于先进的AI模型，分析结果非常准确
- 应用广泛：可用于3D建模、游戏开发、AR/VR等多个领域
- 性能优化：支持不同精度设置，可以在速度和质量间平衡
对于想要从2D图片中提取3D信息的用户来说，这个插件是一个非常好的选择。记住选择合适的模型（depth或normal）和参数设置，就能获得满意的结果！