%20(1).png)
ComfyUI-Geowizard 插件保姆级教程
1. 插件简介
插件原地址： https://github.com/kijai/ComfyUI-Geowizard
Geowizard 是一个超级神奇的插件，它能从一张普通的照片中"看出"物体的深度和表面方向！就像给AI装了一双透视眼一样。
这个插件能干什么？
- 从一张平面照片中分析出物体的远近关系（深度图）
- 识别出物体表面的朝向（法线图）
- 支持室内、室外、物体三种不同场景的分析
- 可以批量处理多张图片
能带来什么效果？
- 制作3D效果：把平面照片变成有立体感的图像
- 建筑设计：分析建筑物的结构和深度
- 游戏开发：为2D图片生成深度信息用于3D建模
- 艺术创作：创造独特的深度视觉效果
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI
- 点击"Manager"按钮
- 搜索"Geowizard"
- 点击安装
方法二：手动安装
- 打开终端或命令提示符
- 进入ComfyUI的custom_nodes文件夹
- 运行命令：
git clone https://github.com/kijai/ComfyUI-Geowizard - 安装依赖：
pip install -r requirements.txt
重要提醒：
- 插件会自动下载模型文件（约4.7GB），首次使用需要等待
- 需要一个VAE模型（任何1.5或2.1版本的VAE都可以）
- 建议有8GB以上显存的显卡
3. 节点详细解析
3.1 geowizard_model_loader 节点 - 模型加载器
这个节点就像一个"透视眼镜的配置器"，它负责准备好分析图片深度和表面方向需要的所有工具。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| vae | vae | VAE模型 | - | 图像编码解码器，就像翻译官把图片转换成AI能理解的语言 | 变分自编码器，用于图像的编码和解码处理 | 连接任何SD1.5或SD2.1的VAE节点 |
| dtype | dtype | fp32, fp16 | fp16 | 计算精度选择，就像选择计算器的精确度 | 数据类型精度，影响计算速度和显存占用 | fp16省显存但可能略降精度，fp32更精确但占用更多显存 |
3.2 geowizard_sampler 节点 - 深度法线分析器
这个节点是真正的"透视眼"，它能从一张平面图片中分析出深度和表面方向信息。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| geowizard_model | geowizard_model | GEOWIZMODEL | - | 接收上面加载器准备好的透视工具 | 接收模型加载器输出的模型实例 | 直接连接geowizard_model_loader的输出 |
| image | image | 图片 | - | 你想要分析深度的那张图片 | 输入的原始图像，用于深度和法线估计 | 可以是风景照、室内照、物体照片等 |
| steps | steps | 整数 | 10 | 分析的精细程度，就像用放大镜看东西的倍数 | 扩散模型的推理步数，影响生成质量 | 10步快速分析，20-50步高质量分析 |
| ensemble_size | ensemble_size | 整数 | 3 | 重复分析次数，就像多看几遍确保准确 | 集成学习的样本数量，提高预测稳定性 | 1次快速，3-5次平衡，10次最准确 |
| seed | seed | 整数 | 0 | 随机数种子，相同种子产生相同结果 | 控制随机性的种子值，确保结果可重现 | 固定数值可重复生成相同效果 |
| domain | domain | outdoor, indoor, object | indoor | 场景类型选择，告诉AI这是什么环境 | 指定输入图像的场景域，优化不同环境的处理 | 拍摄室内选indoor，户外风景选outdoor，单个物体选object |
| scheduler | scheduler | 多种调度器 | DDIMScheduler | 分析过程的控制方式，就像选择不同的工作节奏 | 扩散模型的采样调度器，控制去噪过程 | DDIMScheduler平衡速度和质量，EulerDiscreteScheduler更快 |
| keep_model_loaded | keep_model_loaded | 布尔值 | True | 是否保持模型在显存中，就像工具用完是否收起来 | 控制模型是否保持在GPU内存中 | True连续使用时更快，False节省显存 |
4. 使用技巧和建议
4.1 场景选择技巧
- 室内照片：选择"indoor"，适合房间、办公室、商店内部等
- 户外风景：选择"outdoor"，适合街道、公园、建筑外观等
- 单个物体：选择"object"，适合产品照、艺术品、人物特写等
4.2 参数调优建议
- 快速预览：steps=10, ensemble_size=1
- 平衡质量：steps=20, ensemble_size=3
- 最高质量：steps=50, ensemble_size=10
4.3 性能优化
- 显存不够：选择fp16精度，设置keep_model_loaded=False
- 速度太慢：减少steps和ensemble_size
- 质量不好：增加ensemble_size，尝试不同的scheduler
4.4 创意应用
- 3D建模辅助：为2D概念图生成深度信息
- 艺术创作：制作独特的深度视觉效果
- 建筑分析：分析建筑结构的空间关系
- 游戏开发：为游戏场景生成深度贴图
5. 常见问题解答
Q1: 生成的深度图看起来不准确怎么办？
A:
- 检查domain参数是否选择正确
- 增加ensemble_size提高准确性
- 尝试不同的scheduler
- 确保输入图片清晰度足够
Q2: 处理速度太慢怎么办？
A:
- 减少steps到10-15
- 减少ensemble_size到1-2
- 选择EulerDiscreteScheduler
- 使用fp16精度
Q3: 显存不够用怎么办？
A:
- 设置keep_model_loaded=False
- 选择fp16精度
- 减少ensemble_size
- 关闭其他占用显存的程序
Q4: 什么样的图片效果最好？
A:
- 清晰度高的图片
- 对比度适中的图片
- 避免过度曝光或过暗的图片
- 场景结构相对简单的图片
Q5: 深度图和法线图有什么区别？
A:
- 深度图：显示物体的远近关系，黑色表示近，白色表示远
- 法线图：显示表面的朝向，不同颜色代表不同的表面角度
6. 输出结果说明
深度图（Depth）
- 黑色区域：距离相机较近的物体
- 白色区域：距离相机较远的物体
- 灰色区域：中等距离的物体
- 可以用于3D建模、景深效果等
法线图（Normal）
- 红色通道：表面在X轴方向的倾斜
- 绿色通道：表面在Y轴方向的倾斜
- 蓝色通道：表面在Z轴方向的倾斜
- 可以用于光照计算、材质渲染等
7. 工作流程示例
基础深度分析流程：
- 加载图片 → geowizard_model_loader → geowizard_sampler → 输出深度图和法线图
- 推荐设置：domain=indoor, steps=20, ensemble_size=3
高质量分析流程：
- 使用相同连接方式
- 高质量设置：steps=50, ensemble_size=10, scheduler=DDIMScheduler
8. 总结
Geowizard插件是一个功能强大的深度和法线估计工具，通过2个核心节点可以实现：
- 从2D图像估计3D深度信息
- 生成表面法线图
- 支持多种场景类型的优化处理
- 提供多种质量和速度的平衡选项
掌握这些节点的使用方法，你就能为平面图片添加立体信息，为3D创作和视觉效果制作提供强大支持！
小贴士： 第一次使用时需要下载约4.7GB的模型文件，请确保网络连接稳定。不同的场景类型（indoor/outdoor/object）会显著影响分析效果，请根据实际图片内容选择合适的domain参数。