%20(1).png)
HD Node 插件完整使用教程
1. 插件简介
HD Node (https://github.com/xiaoxiaodesha/hd_node) 是一个专门为ComfyUI设计的图像处理插件，就像给你的图像编辑工具箱里新增了一套超级实用的工具。这个插件主要能帮你做四件事：
- 智能判断图片方向 - 就像一个聪明的眼睛，能自动识别图片是正面还是背面
- 自动调整图片亮度 - 就像一个智能的灯光师，根据图片的明暗程度自动调节亮度
- 高效放大图片 - 就像一个专业的放大镜，但只放大重要的部分，节省时间
- 智能裁剪人物 - 就像一个专业的摄影师，能自动找到人物并裁剪出最合适的尺寸
2. 如何安装
方法一：ComfyUI Manager 安装（推荐）
- 打开ComfyUI，点击右侧的"Manager"按钮
- 在弹出的窗口中点击"Install Custom Nodes"
- 在搜索框输入"hd_node"
- 找到"hd-nodes-comfyui"，点击"Install"按钮
- 重启ComfyUI
方法二：手动安装
- 找到你的ComfyUI安装目录下的
custom_nodes文件夹 - 在这个文件夹里打开命令行工具
- 输入命令：
git clone https://github.com/xiaoxiaodesha/hd_node.git - 重启ComfyUI
特别注意事项
安装完成后，你需要在当前的Python环境下安装insightface库：
- 先安装Visual Studio并勾选"C++桌面开发"和"通用Win通用平台生成工具"
- 然后在命令行输入：
pip install insightface
3. 节点详细解析
3.1 HD FaceIndex 节点 - 人脸识别定位器
这个节点就像一个专业的人脸识别助手，能够在图片中找到人脸并给每个人脸编号。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | IMAGE类型 | 必填 | 要分析的图片，就像给助手一张照片 | 输入的图像张量数据 | 连接一个Load Image节点的输出 |
| 人脸索引 | face_index | 整数 | 0 | 选择第几个人脸，就像告诉助手"我要第1个人" | 指定要操作的人脸在检测列表中的索引 | 如果图片里有3个人，输入0是第1个人，输入1是第2个人 |
| 检测阈值 | detection_threshold | 浮点数 | 0.5 | 人脸识别的严格程度，就像调节眼镜的清晰度 | 人脸检测的置信度阈值 | 0.3比较宽松，0.7比较严格，0.5是平衡点 |
3.2 HD Image Levels 节点 - 图像亮度调节师
这个节点就像Photoshop里的色阶调整工具，能够自动分析图片的明暗程度并决定是否需要提亮。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | IMAGE类型 | 必填 | 要分析的图片，就像给调光师一张照片 | 输入的图像张量数据 | 连接任何图像输出 |
| 暗部阈值 | shadow_threshold | 浮点数 | 0.1 | 判断多暗算"太暗"，就像设定一个亮度标准线 | 暗部像素判定的阈值 | 0.05很严格，0.2很宽松，0.1是平衡点 |
| 提亮强度 | brighten_strength | 浮点数 | 1.2 | 提亮的力度，就像调节台灯的亮度 | 亮度调整的倍数系数 | 1.0不变，1.5提亮50%，2.0提亮100% |
| 自动检测 | auto_detect | 布尔值 | True | 是否让助手自动判断，就像智能模式开关 | 是否启用自动亮度检测 | True让系统自动判断，False使用手动设置 |
3.3 HD Ultimate SD Upscale 节点 - 智能图像放大器
这个节点就像一个聪明的放大镜，只放大图片的上半部分，特别适合处理人物照片，既能提高质量又能节省时间。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | IMAGE类型 | 必填 | 要放大的图片，就像给放大镜一张照片 | 输入的图像张量数据 | 连接任何图像输出 |
| 模型 | model | MODEL类型 | 必填 | 用来放大的AI模型，就像选择不同的镜头 | SD放大模型 | 连接你的Stable Diffusion模型 |
| 放大倍数 | upscale_by | 浮点数 | 2.0 | 放大多少倍，就像调节望远镜的倍数 | 图像放大的倍率 | 2.0是2倍，4.0是4倍，建议不超过4倍 |
| 只放大上半部 | upscale_top_only | 布尔值 | True | 是否只放大上半部分，就像只擦上半块玻璃 | 是否仅对图像上半部分进行放大 | True节省时间，False放大整张图 |
| 分割高度比例 | split_ratio | 浮点数 | 0.6 | 上半部分占多少比例，就像切蛋糕的位置 | 上半部分的高度比例 | 0.5是一半，0.6是60%，0.7是70% |
3.4 HD SmoothEdge 节点 - 边缘柔化大师
这个节点就像一个专业的修图师，能够让图片边缘变得更加柔和自然，特别适合处理抠图后的边缘。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | IMAGE类型 | 必填 | 要处理的图片，就像给修图师一张照片 | 输入的图像张量数据 | 连接任何图像输出 |
| 输入蒙版 | mask | MASK类型 | 可选 | 指定哪些区域需要柔化，就像给修图师一个模板 | 输入的蒙版数据 | 连接抠图或选区节点的输出 |
| 柔化半径 | smooth_radius | 整数 | 3 | 柔化的范围大小，就像调节画笔的粗细 | 边缘柔化的像素半径 | 1很细致，5很柔和，3是平衡点 |
| 柔化强度 | smooth_strength | 浮点数 | 0.5 | 柔化的强度，就像调节橡皮擦的软硬 | 柔化效果的强度系数 | 0.1很轻微，0.9很强烈，0.5是平衡点 |
3.5 HD GetMaskArea 节点 - 蒙版区域分析师
这个节点就像一个精确的测量工具，能够分析蒙版区域的大小和位置信息。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入蒙版 | mask | MASK类型 | 必填 | 要分析的蒙版，就像给测量师一个模板 | 输入的蒙版张量数据 | 连接任何蒙版输出 |
| 最小面积 | min_area | 整数 | 100 | 最小的有效区域大小，就像设定一个过滤标准 | 有效区域的最小像素面积 | 50捕捉小区域，500只要大区域 |
| 输出格式 | output_format | 字符串 | "bounds" | 输出信息的格式，就像选择报告的样式 | 区域信息的输出格式 | "bounds"输出边界，"center"输出中心点 |
3.6 Combine HDMasks 节点 - 蒙版合并器
这个节点就像一个拼图专家，能够将多个蒙版合并成一个完整的蒙版。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 蒙版1 | mask1 | MASK类型 | 必填 | 第一个蒙版，就像拼图的第一块 | 第一个输入蒙版 | 连接任何蒙版输出 |
| 蒙版2 | mask2 | MASK类型 | 必填 | 第二个蒙版，就像拼图的第二块 | 第二个输入蒙版 | 连接任何蒙版输出 |
| 合并模式 | combine_mode | 字符串 | "add" | 合并的方式，就像选择胶水的类型 | 蒙版合并的算法模式 | "add"相加，"multiply"相乘，"max"取最大值 |
| 羽化边缘 | feather_edge | 整数 | 0 | 边缘羽化的像素数，就像给拼图加个渐变边框 | 边缘羽化的像素范围 | 0无羽化，3轻微羽化，10重度羽化 |
3.7 Cover HDMasks 节点 - 蒙版覆盖器
这个节点就像一个智能的遮挡工具，能够用一个蒙版覆盖另一个蒙版。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 基础蒙版 | base_mask | MASK类型 | 必填 | 底层的蒙版，就像画布的底色 | 作为底层的蒙版数据 | 连接任何蒙版输出 |
| 覆盖蒙版 | cover_mask | MASK类型 | 必填 | 覆盖的蒙版，就像贴在上面的贴纸 | 用于覆盖的蒙版数据 | 连接任何蒙版输出 |
| 覆盖模式 | cover_mode | 字符串 | "replace" | 覆盖的方式，就像选择贴纸的粘贴方式 | 蒙版覆盖的算法模式 | "replace"替换，"blend"混合，"subtract"减去 |
| 透明度 | opacity | 浮点数 | 1.0 | 覆盖的透明度，就像调节贴纸的透明程度 | 覆盖蒙版的不透明度 | 0.0完全透明，1.0完全不透明，0.5半透明 |
4. 使用技巧和建议
4.1 人物照片处理流程
- 先用HD FaceIndex找到人脸位置
- 再用HD Image Levels自动调整亮度
- 最后用HD Ultimate SD Upscale放大图片上半部分（人脸区域）
4.2 蒙版处理技巧
- 用HD GetMaskArea分析蒙版区域大小
- 用Combine HDMasks合并多个选区
- 用HD SmoothEdge让边缘更自然
- 用Cover HDMasks做精细的蒙版调整
4.3 参数调节建议
- 检测阈值：人脸不清晰时降低到0.3，人脸很清晰时提高到0.7
- 提亮强度：白天照片用1.2，夜晚照片用1.5-2.0
- 柔化半径：高分辨率图片用5-10，低分辨率图片用1-3
- 放大倍数：第一次处理用2倍，效果好再考虑4倍
5. 常见问题解答
Q1：为什么HD FaceIndex识别不到人脸？
A1： 可能是检测阈值设置太高了，试试把detection_threshold调低到0.3。或者图片中的人脸太小、太模糊，可以先用其他工具放大图片。
Q2：HD Image Levels处理后图片太亮了怎么办？
A2： 把brighten_strength调小一点，比如从1.2改成1.1。或者把shadow_threshold调高一点，让系统更严格地判断什么是"暗"。
Q3：HD Ultimate SD Upscale处理很慢怎么办？
A3： 这个节点本来就比较耗时，建议把upscale_top_only设置为True，只放大上半部分。如果还是慢，可以先把图片裁剪小一点再处理。
Q4：蒙版合并后边缘很生硬怎么办？
A4： 用HD SmoothEdge节点处理一下，把smooth_radius设置为3-5，smooth_strength设置为0.5。
Q5：插件安装后找不到节点怎么办？
A5： 检查是否正确安装了insightface库，在命令行输入pip show insightface查看是否安装成功。如果没有，按照安装说明重新安装Visual Studio和insightface。
6. 高级应用场景
6.1 批量人像处理
将多个节点串联起来，可以实现批量的人像美化：
- HD FaceIndex → HD Image Levels → HD Ultimate SD Upscale
- 这样就能自动识别人脸、调整亮度、放大人像区域
6.2 精细抠图后处理
使用蒙版相关节点可以做精细的抠图后处理：
- HD GetMaskArea 分析选区大小
- HD SmoothEdge 柔化边缘
- Cover HDMasks 做局部调整
6.3 智能裁剪工作流
结合ComfyUI的其他节点，可以做智能的人像裁剪：
- HD FaceIndex 找到人脸位置
- 根据人脸位置自动计算裁剪区域
- HD Ultimate SD Upscale 对裁剪后的图像进行放大
这个插件特别适合需要处理大量人像照片的场景，比如证件照处理、社交媒体头像优化、电商产品图片美化等。通过合理搭配这些节点，你可以建立一个高效的图像处理流水线。