comfyui_face_parsing 人脸解析插件完全教程

1. 插件简介

插件地址： https://github.com/Ryuukeisyou/comfyui_face_parsing

这个插件就像一个超级智能的美颜相机，但比普通美颜相机厉害多了！它能够：

• 精准识别人脸各个部位：就像给人脸画地图一样，能分出哪里是皮肤、哪里是眼睛、哪里是嘴巴、哪里是头发等等
• 智能抠图：不用手动抠图，自动帮你把人脸从背景中分离出来
• 精细化处理：想只美化皮肤不动眼睛？想只换头发颜色？都能做到
• 批量处理：一次处理多张照片，省时省力

简单来说，这个插件就是把专业摄影师的修图技巧变成了自动化工具，让你轻松做出电影级别的人像效果。

2. 如何安装

方法一：直接下载（推荐新手）

1. 打开你的 ComfyUI 安装文件夹
2. 找到 custom_nodes 文件夹
3. 在这个文件夹里打开命令行（Windows按住Shift右键选择"在此处打开命令窗口"）
4. 输入命令：git clone https://github.com/Ryuukeisyou/comfyui_face_parsing.git
5. 重启 ComfyUI

方法二：手动下载

1. 访问 https://github.com/Ryuukeisyou/comfyui_face_parsing
2. 点击绿色的 "Code" 按钮，选择 "Download ZIP"
3. 解压到 ComfyUI 的 custom_nodes 文件夹中
4. 重启 ComfyUI

注意事项：

• 第一次运行时，插件会自动下载一些必要的模型文件（大约几百MB）
• 如果下载很慢，可以手动下载后放到指定文件夹

3. 节点详细解析

3.1 BBoxDetectorLoader 节点 - 人脸检测器加载器

这个节点就像是给你的电脑装上"眼睛"，让它能够在照片中找到人脸的位置。

参数详解

3.2 BBoxDetect 节点 - 人脸位置检测器

这个节点就像是一个会画框的助手，在照片上把人脸用方框圈出来。

参数详解

3.3 BBoxListItemSelect 节点 - 人脸框选择器

当照片里有多个人脸时，这个节点帮你选择要处理哪一个。

参数详解

3.4 BBoxResize 节点 - 人脸框尺寸调整器

当你改变了照片大小，这个节点帮你同步调整人脸框的位置和大小。

参数详解

3.5 BBoxDecompose 节点 - 人脸框信息分解器

这个节点把人脸框的位置信息拆分成具体的数字，方便其他节点使用。

参数详解

输出说明：

• l：左边界（距离照片左边多少像素）
• t：上边界（距离照片顶部多少像素）
• r：右边界（距离照片左边多少像素）
• b：下边界（距离照片顶部多少像素）

3.6 LatentCropWithBBox 节点 - 潜在空间人脸裁剪器

这个节点专门处理AI生成图片过程中的中间数据，按照人脸框进行裁剪。

参数详解

3.7 LatentInsertWithBBox 节点 - 潜在空间人脸插入器

把处理好的人脸数据重新插入到原图的潜在空间中。

参数详解

3.8 LatentSize 节点 - 潜在空间尺寸获取器

获取AI中间数据的尺寸信息。

参数详解

3.9 ImageCropWithBBox 节点 - 图片人脸裁剪器

这个节点就像剪刀，按照人脸框把人脸部分从整张照片中剪出来。

参数详解

3.10 ImageCropWithBBoxList 节点 - 批量图片人脸裁剪器

一次性裁剪多个人脸，比如合影中的所有人脸。

参数详解

3.11 ImagePadWithBBox 节点 - 图片填充器

把小的人脸图片放到大画布上，周围用空白填充。

参数详解

3.12 ImageInsertWithBBox 节点 - 图片人脸插入器

把处理好的人脸重新放回原图的指定位置。

参数详解

3.13 ImageResizeWithBBox 节点 - 图片尺寸调整器

按照人脸框的大小来调整图片尺寸。

参数详解

3.14 ImageListSelect 节点 - 图片选择器

从多张图片中选择一张来处理。

参数详解

3.15 ImageSize 节点 - 图片尺寸获取器

获取图片的宽度和高度信息。

参数详解

3.16 ImageResizeCalculator 节点 - 智能尺寸计算器

这个节点就像一个聪明的计算器，帮你算出最合适的图片尺寸。

参数详解

3.17 FaceParsingModelLoader 节点 - 人脸解析模型加载器

这是插件的核心，加载专门用来分析人脸各部位的AI模型。

参数详解

3.18 FaceParsingProcessorLoader 节点 - 人脸解析处理器加载器

加载图片预处理工具，为人脸解析做准备。

参数详解

3.19 FaceParse 节点 - 人脸解析器（核心节点）

这是整个插件最重要的节点，能把人脸分解成19个不同部位。

参数详解

3.20 FaceParsingResultsParser 节点 - 人脸解析结果处理器

把人脸解析的结果转换成可以使用的遮罩，这里有19个开关对应人脸的19个部位。

参数详解

3.21 MaskBorderDissolve 节点 - 遮罩边缘溶解器

让遮罩的边缘变得柔和，避免生硬的边界。

参数详解

3.22 MaskBorderDissolveAdvanced 节点 - 高级遮罩边缘溶解器

比普通溶解器更精细，可以分别控制上下左右四个方向的溶解程度。

参数详解

3.23 MaskBlackOut 节点 - 遮罩方向遮挡器

从指定方向开始把遮罩变黑，就像用黑布从一边开始遮挡。

参数详解

3.24 MaskCropWithBBox 节点 - 遮罩裁剪器

按照人脸框裁剪遮罩，只保留人脸区域的遮罩部分。

参数详解

3.25 MaskComposite 节点 - 遮罩合成器

把两个遮罩按照不同方式合并成一个。

参数详解

合并方式说明：

• multiply：相乘（重叠部分保留）
• add：相加（两个遮罩叠加）
• subtract：相减（从底层减去上层）
• and：与运算（只保留重叠部分）
• or：或运算（保留所有部分）
• xor：异或运算（只保留不重叠部分）

3.26 MaskBatchComposite 节点 - 批量遮罩合成器

把多个遮罩一次性合并成一个。

参数详解

3.27 MaskListSelect 节点 - 遮罩选择器

从多个遮罩中选择一个来使用。

参数详解

3.28 MaskToBBoxList 节点 - 遮罩转人脸框列表

把遮罩转换成人脸框，自动找出遮罩中的矩形区域。

参数详解

3.29 MaskInsertWithBBox 节点 - 遮罩插入器

把小的遮罩插入到大图的指定位置。

参数详解

3.30 GuidedFilter 节点 - 引导滤波器（磨皮神器）

这是专业的磨皮工具，能让皮肤变得光滑自然，比普通模糊更智能。

参数详解

3.31 ColorAdjust 节点 - 颜色调整器

专业的颜色调整工具，可以调整亮度、对比度、饱和度等。

参数详解

4. 使用技巧和建议

4.1 基础工作流程

1. 人脸检测 → BBoxDetectorLoader + BBoxDetect
2. 人脸解析 → FaceParsingModelLoader + FaceParsingProcessorLoader + FaceParse
3. 选择部位 → FaceParsingResultsParser（选择要处理的部位）
4. 应用效果 → 使用各种处理节点
5. 合成结果 → 把处理后的结果合并回原图

4.2 常用组合

• 精准磨皮：人脸检测 → 裁剪皮肤区域 → 引导滤波 → 插入回原图
• 换发色：人脸解析 → 选择头发 → 颜色调整 → 合成
• 美白牙齿：解析嘴部 → 选择嘴唇 → 亮度调整 → 合成

4.3 参数调优建议

• 检测阈值：人多的照片用0.5以上，单人照片用0.3即可
• 磨皮强度：亚洲人皮肤用eps=100-150，欧美人用150-200
• 边缘溶解：size=5-15像素比较自然，太大会模糊

5. 常见问题解答

Q1：为什么检测不到人脸？

A：检查threshold参数，可能设置太高了，试试0.2-0.3

Q2：磨皮效果太假怎么办？

A：增大eps参数值，或者减小radius参数

Q3：处理速度很慢怎么办？

A：如果有显卡，在FaceParsingModelLoader中选择cuda

Q4：遮罩边缘太硬怎么办？

A：使用MaskBorderDissolve节点柔化边缘

Q5：多人照片怎么处理？

A：使用BBoxListItemSelect选择要处理的人脸，或用ImageCropWithBBoxList批量处理

6. 总结

这个插件包含了31个节点，本教程已经全部详解完毕。从基础的人脸检测到高级的颜色调整，每个节点都有其独特的作用。掌握这些节点的组合使用，你就能制作出专业级的人像处理效果。

记住：多实践、多尝试不同的参数组合，你会发现更多有趣的用法！