ComfyUI 魔法书 Logo
🏠 首页
👥 加群
😎 大帅比
❤️‍🔥 Monster 社区
登录 →
ComfyUI 魔法书 Logo
🏠 首页 👥 加群 😎 大帅比 ❤️‍🔥 Monster 社区
登录
  1. 首页
  2. 🧩 插件工坊 (Plugin Workshop)
  3. ComfyUI FaceTools插件使用教程 从入门到精通

ComfyUI FaceTools插件使用教程 从入门到精通

0
  • 🧩 插件工坊 (Plugin Workshop)
  • 发布于 2025-07-01
  • 52 次阅读
编程界的小学生
编程界的小学生

ComfyUI FaceTools 插件保姆级教程

1. 插件简介

插件地址: https://github.com/dchatel/comfyui_facetools

ComfyUI FaceTools 是一个专门处理人脸的超级工具箱!想象一下,这个插件就像一个专业的美容师工作台,里面有各种各样的工具来处理人脸:

  • 人脸检测器:就像一个火眼金睛的侦探,能在照片里找到所有的人脸
  • 人脸裁剪器:就像一把精准的剪刀,能把人脸从照片里完美地剪出来
  • 人脸贴回器:就像一个拼图高手,能把处理好的人脸完美地贴回原照片
  • 各种面具制作器:就像化妆师的面具,能精确地标记出脸部的不同区域

这个插件能给我们带来什么效果?

这个插件特别适合做人脸相关的图片处理:

  • 人脸修复:把模糊的脸变清晰
  • 人脸替换:把一个人的脸换成另一个人的脸
  • 人脸美化:只对脸部进行美化处理,不影响背景
  • 性别筛选:从多个人脸中筛选出男性或女性
  • 人脸大小排序:按照脸的大小来排列处理

2. 如何安装

安装前准备

在安装插件之前,你需要下载一些模型文件(就像给工具箱添加专用工具):

  1. 下载人脸对齐模型:

    • 去 HuggingFace 下载 FaceAlignment 模型
    • 放到 ComfyUI/models/landmarks 文件夹里
  2. 下载BiSeNet模型(可选,用于精确面部分割):

    • 去 Google Drive 下载 BiSeNet 模型
    • 放到 ComfyUI/models/bisenet 文件夹里

插件安装方法

方法一:通过ComfyUI管理器安装(推荐)

  1. 打开 ComfyUI
  2. 点击 "Manager"(管理器)
  3. 选择 "Custom Nodes Manager"(自定义节点管理器)
  4. 搜索 "facetools"
  5. 点击 "Install"(安装)

方法二:通过Git地址安装

  1. 打开 ComfyUI
  2. 点击 "Manager"(管理器)
  3. 选择 "Install via Git URL"(通过Git地址安装)
  4. 输入:https://github.com/dchatel/comfyui_facetools.git
  5. 点击安装

安装完成后重启 ComfyUI 即可使用。

3. 节点详细解析

3.1 DetectFaces 节点 - 人脸侦探

这个节点就像一个专业的"人脸侦探",能在照片里找到所有的人脸,不管人脸是大是小、是正是歪。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
imageimage图片输入必须连接输入要检测人脸的照片,就像给侦探一张要搜查的照片输入待检测的图像数据连接LoadImage节点或其他图片源
thresholdthreshold0.0-1.0小数0.5检测敏感度,就像调节侦探的"眼力",数值越高要求越严格人脸检测的置信度阈值,过滤低置信度检测结果0.3检测更多可能的脸,0.7只检测很确定的脸
min_sizemin_size整数64最小人脸尺寸,就像告诉侦探"太小的脸不用管"检测的最小人脸像素尺寸设为32能检测很小的脸,设为128只检测较大的脸
max_sizemax_size整数512最大人脸尺寸,就像告诉侦探"太大的脸也不用管"检测的最大人脸像素尺寸通常设为512够用,特殊情况可以调更大
maskmask遮罩输入可选搜索区域限制,就像给侦探划定搜查范围可选的遮罩,限制检测区域连接遮罩可以只在特定区域检测人脸

输出接口:

  • faces:找到的所有人脸信息,包含位置、大小等数据

3.2 CropFaces 节点 - 人脸剪刀手

这个节点就像一个精准的"剪刀手",能把检测到的人脸从照片里完美地剪出来,还能制作各种类型的面具。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
facesfaces人脸数据来自DetectFaces接收侦探找到的人脸信息,就像接收要剪切的目标清单接收人脸检测结果进行裁剪处理必须连接DetectFaces节点的faces输出
crop_sizecrop_size512-1024整数512剪出来的人脸图片大小,就像选择相框的尺寸裁剪后的人脸图像尺寸(正方形)512适合一般处理,1024用于高质量处理
crop_factorcrop_factor1.0-3.0小数1.5剪切范围扩大倍数,就像决定要不要把脖子和头发也剪进来裁剪时的扩展因子,包含更多面部周围区域1.0只剪脸部,2.0会包含更多头发和背景
mask_typemask_type下拉选择simple_square面具类型,就像选择不同形状的面具来标记脸部区域生成遮罩的方法,用于后续处理simple_square最快,BiSeNet最精确

可选的面具类型:

  • simple_square:简单方框,速度最快
  • convex_hull:凸包形状,比较精确
  • BiSeNet:AI智能分割,最精确但需要额外模型
  • jonathandinu:另一种AI分割,精确度高但占用内存多

输出接口:

  • crops:剪出来的人脸图片
  • masks:对应的面具(标记哪些区域是脸)
  • warps:变形信息(用于后面贴回原图)

3.3 WarpFacesBack 节点 - 人脸拼图师

这个节点就像一个专业的"拼图师",能把处理好的人脸完美地贴回到原来的照片里,就像从来没有动过一样。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
imagesimages图片输入原始图片原始照片,就像拼图的底板原始图像,作为人脸贴回的目标通常连接最开始的原图
faceface人脸数据来自DetectFaces人脸位置信息,就像拼图的位置说明书人脸检测结果,提供位置信息连接DetectFaces的faces输出
cropcrop处理后图片来自处理节点处理好的人脸图片,就像要贴上去的拼图块经过处理的人脸图像连接经过美化或修复的人脸图片
maskmask面具数据来自CropFaces贴合面具,告诉拼图师哪些地方要贴哪些地方不贴遮罩信息,控制融合区域连接CropFaces的masks输出
warpwarp变形数据来自CropFaces变形说明书,告诉拼图师怎么调整角度和大小仿射变换矩阵,用于几何对齐连接CropFaces的warps输出

输出接口:

  • IMAGE:贴好人脸的完整照片

3.4 BiSeNetMask 节点 - 精密面具制作师

这个节点就像一个"精密面具制作师",能为人脸的每个部位制作专门的面具,比如只要眼睛、只要嘴巴等等。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
cropcrop人脸图片来自CropFaces剪出来的人脸图片,就像要制作面具的模特照片裁剪后的人脸图像用于语义分割连接CropFaces的crops输出
skinskin开关True是否包含皮肤区域,就像决定面具要不要覆盖皮肤是否在遮罩中包含面部皮肤区域True包含皮肤,False不包含皮肤
left_browleft_brow开关True是否包含左眉毛,就像决定面具要不要覆盖左眉毛是否在遮罩中包含左眉毛区域True包含左眉毛,False不包含
right_browright_brow开关True是否包含右眉毛,就像决定面具要不要覆盖右眉毛是否在遮罩中包含右眉毛区域True包含右眉毛,False不包含
left_eyeleft_eye开关True是否包含左眼,就像决定面具要不要覆盖左眼是否在遮罩中包含左眼区域True包含左眼,False不包含
right_eyeright_eye开关True是否包含右眼,就像决定面具要不要覆盖右眼是否在遮罩中包含右眼区域True包含右眼,False不包含
eyeglasseseyeglasses开关True是否包含眼镜,就像决定面具要不要覆盖眼镜是否在遮罩中包含眼镜区域True包含眼镜,False不包含
left_earleft_ear开关True是否包含左耳,就像决定面具要不要覆盖左耳是否在遮罩中包含左耳区域True包含左耳,False不包含
right_earright_ear开关True是否包含右耳,就像决定面具要不要覆盖右耳是否在遮罩中包含右耳区域True包含右耳,False不包含
earringearring开关True是否包含耳环,就像决定面具要不要覆盖耳环是否在遮罩中包含耳环区域True包含耳环,False不包含
nosenose开关True是否包含鼻子,就像决定面具要不要覆盖鼻子是否在遮罩中包含鼻子区域True包含鼻子,False不包含
mouthmouth开关True是否包含嘴巴,就像决定面具要不要覆盖嘴巴是否在遮罩中包含嘴部区域True包含嘴巴,False不包含
upper_lipupper_lip开关True是否包含上嘴唇,就像决定面具要不要覆盖上嘴唇是否在遮罩中包含上唇区域True包含上嘴唇,False不包含
lower_liplower_lip开关True是否包含下嘴唇,就像决定面具要不要覆盖下嘴唇是否在遮罩中包含下唇区域True包含下嘴唇,False不包含
neckneck开关False是否包含脖子,就像决定面具要不要覆盖脖子是否在遮罩中包含颈部区域通常False,除非需要处理脖子
necklacenecklace开关False是否包含项链,就像决定面具要不要覆盖项链是否在遮罩中包含项链区域通常False,除非需要处理项链
clothcloth开关False是否包含衣服,就像决定面具要不要覆盖衣服是否在遮罩中包含服装区域通常False,除非需要处理衣服
hairhair开关False是否包含头发,就像决定面具要不要覆盖头发是否在遮罩中包含头发区域需要处理头发时设为True
hathat开关False是否包含帽子,就像决定面具要不要覆盖帽子是否在遮罩中包含帽子区域需要处理帽子时设为True

输出接口:

  • MASK:制作好的精密面具

3.5 JonathandinuMask 节点 - 高精度面具制作师

这个节点就像一个"高精度面具制作师",比BiSeNet更精确,但也更耗费电脑资源,就像用更高级的工具制作更精细的面具。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
cropcrop人脸图片来自CropFaces剪出来的人脸图片,就像要制作高精度面具的模特照片裁剪后的人脸图像用于高精度语义分割连接CropFaces的crops输出
skinskin开关True是否包含皮肤区域,就像决定高精度面具要不要覆盖皮肤是否在遮罩中包含面部皮肤区域True包含皮肤,False不包含皮肤
nosenose开关True是否包含鼻子,就像决定高精度面具要不要覆盖鼻子是否在遮罩中包含鼻子区域True包含鼻子,False不包含
eyeglasseseyeglasses开关False是否包含眼镜,就像决定高精度面具要不要覆盖眼镜是否在遮罩中包含眼镜区域有眼镜时设为True
left_eyeleft_eye开关True是否包含左眼,就像决定高精度面具要不要覆盖左眼是否在遮罩中包含左眼区域True包含左眼,False不包含
right_eyeright_eye开关True是否包含右眼,就像决定高精度面具要不要覆盖右眼是否在遮罩中包含右眼区域True包含右眼,False不包含
left_browleft_brow开关True是否包含左眉毛,就像决定高精度面具要不要覆盖左眉毛是否在遮罩中包含左眉毛区域True包含左眉毛,False不包含
right_browright_brow开关True是否包含右眉毛,就像决定高精度面具要不要覆盖右眉毛是否在遮罩中包含右眉毛区域True包含右眉毛,False不包含
left_earleft_ear开关True是否包含左耳,就像决定高精度面具要不要覆盖左耳是否在遮罩中包含左耳区域True包含左耳,False不包含
right_earright_ear开关True是否包含右耳,就像决定高精度面具要不要覆盖右耳是否在遮罩中包含右耳区域True包含右耳,False不包含
mouthmouth开关True是否包含嘴巴,就像决定高精度面具要不要覆盖嘴巴是否在遮罩中包含嘴部区域True包含嘴巴,False不包含
upper_lipupper_lip开关True是否包含上嘴唇,就像决定高精度面具要不要覆盖上嘴唇是否在遮罩中包含上唇区域True包含上嘴唇,False不包含
lower_liplower_lip开关True是否包含下嘴唇,就像决定高精度面具要不要覆盖下嘴唇是否在遮罩中包含下唇区域True包含下嘴唇,False不包含
hairhair开关False是否包含头发,就像决定高精度面具要不要覆盖头发是否在遮罩中包含头发区域需要处理头发时设为True
hathat开关False是否包含帽子,就像决定高精度面具要不要覆盖帽子是否在遮罩中包含帽子区域需要处理帽子时设为True
earringearring开关False是否包含耳环,就像决定高精度面具要不要覆盖耳环是否在遮罩中包含耳环区域有耳环时设为True
necklacenecklace开关False是否包含项链,就像决定高精度面具要不要覆盖项链是否在遮罩中包含项链区域有项链时设为True
neckneck开关False是否包含脖子,就像决定高精度面具要不要覆盖脖子是否在遮罩中包含颈部区域需要处理脖子时设为True
clothcloth开关False是否包含衣服,就像决定高精度面具要不要覆盖衣服是否在遮罩中包含服装区域需要处理衣服时设为True

输出接口:

  • MASK:制作好的高精度面具

3.6 GenderFaceFilter 节点 - 性别筛选器

这个节点就像一个"性别识别专家",能从多个人脸中筛选出男性或女性的脸,就像在人群中找出特定性别的人。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
facesfaces人脸数据来自DetectFaces要筛选的人脸清单,就像给专家一堆照片让他挑选输入的人脸检测结果连接DetectFaces的faces输出
gendergender下拉选择man要筛选的性别,就像告诉专家你要找男的还是女的目标性别类别选man筛选男性,选woman筛选女性

输出接口:

  • filtered:筛选出来的目标性别人脸
  • rest:剩下的其他人脸

3.7 OrderedFaceFilter 节点 - 人脸排序筛选器

这个节点就像一个"人脸管理员",能按照脸的大小来排序,然后选出你想要的几个,就像从大到小排队然后选前几名。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
facesfaces人脸数据来自DetectFaces要排序的人脸清单,就像给管理员一堆要排队的人输入的人脸检测结果连接DetectFaces的faces输出
criteriacriteria下拉选择area排序标准,就像告诉管理员按什么来排队排序的依据标准目前只支持area(按面积大小排序)
orderorder下拉选择descending排序方向,就像决定是从大到小还是从小到大排队排序的顺序方向descending从大到小,ascending从小到大
take_starttake_start整数0从第几个开始选,就像告诉管理员从队伍的第几个人开始选开始选择的索引位置0从第一个开始,1从第二个开始
take_counttake_count整数1选几个人,就像告诉管理员要选几个人出来选择的人脸数量1选一个,3选三个

输出接口:

  • filtered:选出来的人脸
  • rest:剩下的人脸

3.8 MergeWarps 节点 - 变形数据合并器

这个节点就像一个"数据整理员",能把两组人脸处理数据合并成一组,方便一起处理。

参数详解:

参数名 (UI显示)参数名 (代码里)参数值建议值通俗解释 (能干嘛的)专业解释怎么用/举个例子
crop0crop0人脸图片第一组数据第一组剪出来的人脸图片,就像第一堆要整理的照片第一组裁剪后的人脸图像连接第一个CropFaces的crops输出
mask0mask0面具数据第一组数据第一组面具数据,就像第一堆面具第一组遮罩数据连接第一个CropFaces的masks输出
warp0warp0变形数据第一组数据第一组变形数据,就像第一堆变形说明书第一组仿射变换矩阵连接第一个CropFaces的warps输出
crop1crop1人脸图片第二组数据第二组剪出来的人脸图片,就像第二堆要整理的照片第二组裁剪后的人脸图像连接第二个CropFaces的crops输出
mask1mask1面具数据第二组数据第二组面具数据,就像第二堆面具第二组遮罩数据连接第二个CropFaces的masks输出
warp1warp1变形数据第二组数据第二组变形数据,就像第二堆变形说明书第二组仿射变换矩阵连接第二个CropFaces的warps输出

输出接口:

  • IMAGE:合并后的人脸图片
  • MASK:合并后的面具数据
  • WARP:合并后的变形数据

4. 使用技巧和建议

4.1 基础人脸处理工作流

  1. DetectFaces → 检测照片中的人脸
  2. CropFaces → 剪出人脸并制作面具
  3. 处理节点(如放大、美化等)→ 处理剪出来的人脸
  4. WarpFacesBack → 把处理好的人脸贴回原图

4.2 性能优化建议

  • 面具选择:

    • 速度优先:选择 simple_square
    • 质量优先:选择 BiSeNet 或 jonathandinu
    • 平衡选择:选择 convex_hull
  • 检测参数调整:

    • 照片人脸很清晰:threshold 设为 0.7
    • 照片人脸模糊:threshold 设为 0.3
    • 只要大脸:min_size 设大一点
    • 要检测小脸:min_size 设小一点

4.3 常用组合技巧

  • 只处理最大的脸:DetectFaces → OrderedFaceFilter(设为descending,take_count=1)
  • 只处理女性的脸:DetectFaces → GenderFaceFilter(设为woman)
  • 精确面部美化:使用BiSeNetMask只选择皮肤、眼睛、嘴巴等部位

4.4 内存节省技巧

  • 避免同时使用BiSeNet和Jonathandinu两种精确面具
  • 处理大量人脸时,先用OrderedFaceFilter筛选出需要的人脸
  • crop_size不要设置过大,512通常够用

5. 常见问题解答

Q1:为什么检测不到人脸?

A1: 可能的原因和解决方法:

  • threshold设置太高:降低到0.3-0.5试试
  • 人脸太小:降低min_size参数
  • 人脸角度太偏:这个插件对侧脸检测能力有限
  • 图片质量太差:尝试先提高图片质量

Q2:BiSeNet面具不工作?

A2: 检查以下几点:

  • 确保下载了BiSeNet模型文件
  • 模型文件放在正确的位置:ComfyUI/models/bisenet/79999_iter.pth
  • 确保有足够的显存(GPU内存)

Q3:处理后的人脸贴回去有明显边界?

A3: 尝试以下解决方法:

  • 增加crop_factor参数,包含更多周围区域
  • 使用更精确的面具类型(BiSeNet或jonathandinu)
  • 在处理人脸时添加边缘羽化效果

Q4:性别筛选不准确?

A4: 这是正常现象:

  • 性别识别本身就不是100%准确的
  • 可以手动筛选或使用OrderedFaceFilter按大小筛选
  • 考虑使用其他更专业的性别识别工具

Q5:内存不够用怎么办?

A5: 内存优化建议:

  • 使用simple_square面具而不是BiSeNet
  • 减小crop_size参数
  • 一次处理较少的人脸
  • 关闭其他占用内存的程序

6. 实际应用场景

6.1 人像修复工作流

原图 → DetectFaces → CropFaces → 人脸修复模型 → WarpFacesBack → 修复完成

6.2 批量人脸美化

原图 → DetectFaces → OrderedFaceFilter → CropFaces → 美化处理 → WarpFacesBack → 美化完成

6.3 精确面部化妆

原图 → DetectFaces → CropFaces → BiSeNetMask → 化妆处理 → WarpFacesBack → 化妆完成

6.4 性别特定处理

原图 → DetectFaces → GenderFaceFilter → CropFaces → 特定处理 → WarpFacesBack → 处理完成

7. 总结

ComfyUI FaceTools 插件是一个功能强大的人脸处理工具箱,包含8个专业节点:

  1. DetectFaces:人脸侦探,找出所有人脸
  2. CropFaces:人脸剪刀手,精确剪出人脸
  3. WarpFacesBack:人脸拼图师,完美贴回处理后的人脸
  4. BiSeNetMask:精密面具制作师,制作详细的面部区域面具
  5. JonathandinuMask:高精度面具制作师,更精确但更耗资源
  6. GenderFaceFilter:性别筛选器,按性别筛选人脸
  7. OrderedFaceFilter:人脸排序筛选器,按大小排序并筛选
  8. MergeWarps:变形数据合并器,合并多组处理数据

这个插件特别适合需要精确处理人脸的场景,比如人像修复、美颜处理、人脸替换等。通过合理组合这些节点,你可以创建出非常专业的人脸处理工作流!

记住:选择合适的面具类型和参数设置是成功的关键,多尝试不同的组合,找到最适合你需求的配置。

标签: #插件 2338
相关文章

ComfyUI错误修复插件详解:轻松解决常见问题 2025-07-10 18:25

ComfyUI-CustomMenu插件使用教程:高效自定义工作流指南 2025-07-10 17:50

ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44

ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件,就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址:https://github.com/LingSss9/com

ComfyUI WAN 2.2视频插件教程:万相AI提示词全攻略 2025-07-31 11:47

ComfyUI WAN 2.2视频插件教程:万相AI提示词实战指南 2025-07-29 20:10

ComfyUI HeyGem数字人插件教程:零基础快速精通指南 2025-07-22 14:10

目录

从节点基础到高阶工作流,我们为你绘制最清晰的 ComfyUI 学习路径。告别困惑,让每一次连接都充满创造的魔力,轻松驾驭 AI 艺术的无限可能。

  • 微信
  • B站
  • GitHub
Copyright © 2025 AIX All Rights Reserved. Powered by AIX.
隐私政策
津ICP备2024019312号