%20(1).png)
ComfyUI_PortraitTools 插件完全使用指南
1. 插件简介
ComfyUI_PortraitTools（人像工具包）是一个专门为人像处理设计的插件集合，就像是为ComfyUI装了一个专业的照相馆工具箱。这个插件可以帮你自动处理人脸照片，制作各种证件照，还能给照片和视频加水印。
插件地址： https://github.com/billwuhao/ComfyUI_PortraitTools
这个插件包含以下主要功能：图片加载（支持自定义路径）、自动视频水印、自动图片水印、人脸对齐、人脸检测和裁剪、一键生成各种证件照、照片增强处理等。
想象一下，你有一堆照片需要处理，有的需要裁剪人脸，有的需要制作证件照，有的需要加水印，以前你可能需要用好几个不同的软件。现在用这个插件，就像有了一个万能的照片处理助手，一站式解决所有人像处理需求。
2. 如何安装
2.1 基础安装步骤
- 打开命令提示符（就是那个黑黑的窗口）
- 切换到ComfyUI目录：
cd ComfyUI/custom_nodes - 下载插件：
git clone https://github.com/billwuhao/ComfyUI_PortraitTools.git - 进入插件目录：
cd ComfyUI_PortraitTools - 安装依赖：
pip install -r requirements.txt
2.2 特殊配置
需要将 extra_help_file.yaml.example 文件重命名为 extra_help_file.yaml，并添加自定义加载目录，比如：images_dir: D:\AIGC\ComfyUI-Data\images_input
2.3 模型下载
如果你没有安装ComfyUI-ReActor和ComfyUI-RMBG插件，需要下载detection_Resnet50_Final.pth模型，放在ComfyUI\models\facedetection文件夹中。
3. 节点详细解析
3.1 Load Images Plus 节点（图片加载增强版）
这个节点就像是一个聪明的文件管理员，可以自动从你指定的文件夹里找到所有图片，比原版的图片加载节点更智能。
3.1.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 图片路径 | image_path | 文件路径字符串 | 你的图片文件夹路径 | 告诉程序去哪里找图片，就像给快递员地址 | 指定图片文件的完整路径 | 输入：D:\我的照片\证件照 |
| 包含子文件夹 | include_subdirs | True/False | True | 决定要不要搜索子文件夹里的图片 | 是否递归搜索子目录 | 开启后会搜索所有子文件夹 |
| 图片格式 | image_extensions | 文件扩展名列表 | jpg,png,jpeg | 决定要加载哪些格式的图片 | 支持的图片文件扩展名 | 只加载这些格式的图片文件 |
3.2 Add Watermark 节点（图片水印）
这个节点就像是一个自动盖章机，可以在你的图片上自动添加水印，防止别人盗用你的作品。
3.2.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 输入图片 | image | 图片数据 | 连接图片输入 | 要加水印的原图 | 输入的图像张量 | 从其他节点拖线连接 |
| 水印文字 | watermark_text | 文字字符串 | "© 2024 我的作品" | 水印上显示的文字内容 | 水印文本内容 | 输入你的版权信息 |
| 水印位置 | position | 枚举值 | "bottom_right" | 水印放在图片的哪个角落 | 水印在图片中的位置 | 右下角、左下角、右上角等 |
| 透明度 | opacity | 0.0-1.0 | 0.5 | 水印的透明程度，0是完全透明，1是完全不透明 | 水印的不透明度 | 0.3表示比较淡，0.8表示比较明显 |
| 字体大小 | font_size | 整数 | 36 | 水印文字的大小，数字越大字越大 | 字体像素大小 | 36表示中等大小 |
| 字体颜色 | font_color | 颜色代码 | "white" | 水印文字的颜色 | 文字颜色值 | white(白色)、black(黑色)、red(红色) |
3.3 Add Video Watermark 节点（视频水印）
这个节点就像是视频版的盖章机，可以给视频的每一帧都加上水印，让你的视频作品有版权保护。
3.3.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 输入视频 | video | 视频数据 | 连接视频输入 | 要加水印的原视频 | 输入的视频张量 | 从其他节点拖线连接 |
| 水印文字 | watermark_text | 文字字符串 | "© 2024 我的视频" | 水印上显示的文字内容 | 水印文本内容 | 输入你的版权信息 |
| 水印位置 | position | 枚举值 | "bottom_right" | 水印放在视频的哪个角落 | 水印在视频中的位置 | 右下角、左下角、右上角等 |
| 透明度 | opacity | 0.0-1.0 | 0.6 | 水印的透明程度 | 水印的不透明度 | 0.4表示比较淡，不影响观看 |
| 字体大小 | font_size | 整数 | 48 | 水印文字的大小 | 字体像素大小 | 视频用稍大的字体更清晰 |
| 字体颜色 | font_color | 颜色代码 | "white" | 水印文字的颜色 | 文字颜色值 | 白色在大多数视频上都很明显 |
3.4 Face Detection and Crop 节点（人脸检测和裁剪）
这个节点就像是一个专业的摄影师，可以自动找到照片中的人脸，然后精确地把人脸部分裁剪出来。
3.4.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 输入图片 | image | 图片数据 | 连接图片输入 | 要检测人脸的原图 | 输入的图像张量 | 从其他节点拖线连接 |
| 裁剪尺寸 | crop_size | 整数 | 512 | 裁剪出来的人脸图片大小 | 输出图片的像素尺寸 | 512表示512x512像素 |
| 人脸放大倍数 | face_scale | 1.0-3.0 | 1.5 | 人脸在裁剪区域中占多大比例 | 人脸区域的缩放比例 | 1.5表示人脸占裁剪区域的2/3 |
| 检测阈值 | detection_threshold | 0.0-1.0 | 0.8 | 多确定才算检测到人脸 | 人脸检测的置信度阈值 | 0.8表示80%确定度才算检测到 |
| 是否对齐 | align_face | True/False | True | 要不要把歪的人脸摆正 | 是否进行人脸对齐 | 开启后会自动调整人脸角度 |
| 输出格式 | output_format | 枚举值 | "square" | 输出正方形还是长方形 | 输出图像的宽高比 | square(正方形)、portrait(竖向) |
3.5 Face Alignment 节点（人脸对齐）
这个节点就像是一个专业的肖像摄影师，专门负责把歪着的人脸照片调整成标准的正面照。
3.5.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 输入图片 | image | 图片数据 | 连接图片输入 | 要对齐的人脸图片 | 输入的图像张量 | 从其他节点拖线连接 |
| 对齐方式 | align_method | 枚举值 | "similarity" | 用什么方法来对齐人脸 | 几何变换的类型 | similarity(相似变换)、affine(仿射变换) |
| 输出尺寸 | output_size | 整数 | 512 | 对齐后的图片大小 | 输出图像的像素尺寸 | 512表示512x512像素 |
| 眼睛位置 | eye_position | 坐标值 | [0.3, 0.4] | 左眼在图片中的相对位置 | 左眼在输出图像中的归一化坐标 | [0.3, 0.4]表示左眼在图片30%宽度、40%高度处 |
| 是否填充 | padding | True/False | True | 对齐后空白区域要不要填充 | 是否对边界进行填充 | 开启后会用背景色填充空白 |
| 填充颜色 | padding_color | 颜色代码 | "black" | 填充区域用什么颜色 | 填充区域的颜色值 | black(黑色)、white(白色) |
3.6 ID Photo Generator 节点（证件照生成器）
这个节点就像是一个全自动的证件照制作机，可以把普通照片一键转换成各种规格的证件照。
3.6.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 输入图片 | image | 图片数据 | 连接图片输入 | 要制作证件照的原图 | 输入的图像张量 | 从其他节点拖线连接 |
| 证件照类型 | photo_type | 枚举值 | "passport" | 要制作什么样的证件照 | 证件照的规格类型 | passport(护照)、id_card(身份证)、driver_license(驾照) |
| 背景颜色 | background_color | 颜色代码 | "white" | 证件照的背景颜色 | 背景区域的颜色值 | white(白色)、blue(蓝色)、red(红色) |
| 输出尺寸 | output_size | 尺寸规格 | "auto" | 输出的证件照尺寸 | 输出图像的像素尺寸 | auto(自动)、custom(自定义) |
| 自定义宽度 | custom_width | 整数 | 413 | 自定义证件照的宽度 | 自定义输出宽度像素 | 413像素宽度 |
| 自定义高度 | custom_height | 整数 | 531 | 自定义证件照的高度 | 自定义输出高度像素 | 531像素高度 |
| 头部比例 | head_ratio | 0.1-0.9 | 0.6 | 人头在证件照中占多大比例 | 人头区域占图像的比例 | 0.6表示头部占60%的空间 |
3.7 Image Enhancement 节点（图像增强）
这个节点就像是一个专业的修图师，可以调整照片的亮度、饱和度、锐度，还能进行磨皮处理。
3.7.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 输入图片 | image | 图片数据 | 连接图片输入 | 要增强的原图 | 输入的图像张量 | 从其他节点拖线连接 |
| 亮度调整 | brightness | -100到100 | 0 | 让照片变亮还是变暗 | 亮度调整数值 | 正数变亮，负数变暗，0不变 |
| 饱和度调整 | saturation | -100到100 | 0 | 让照片颜色更鲜艳还是更淡 | 饱和度调整数值 | 正数更鲜艳，负数更淡，0不变 |
| 锐化强度 | sharpness | 0.0-3.0 | 1.0 | 让照片看起来更清晰还是更柔和 | 锐化处理强度 | 大于1变清晰，小于1变柔和 |
| 磨皮强度 | skin_smooth | 0.0-1.0 | 0.3 | 磨皮效果的强度 | 皮肤平滑处理强度 | 0.3表示轻微磨皮，0.8表示重度磨皮 |
| 保留细节 | preserve_details | True/False | True | 磨皮时要不要保留皮肤细节 | 是否保留皮肤纹理细节 | 开启后磨皮更自然 |
| 对比度调整 | contrast | -100到100 | 0 | 调整照片的对比度 | 对比度调整数值 | 正数增强对比，负数减弱对比 |
3.8 Background Removal 节点（背景移除）
这个节点就像是一个专业的抠图师，可以自动把人像从背景中分离出来。
3.8.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
| :— | :— | :— | :— | :— | :— | :— |
| 输入图片 | image | 图片数据 | 连接图片输入 | 要去除背景的原图 | 输入的图像张量 | 从其他节点拖线连接 |
| 模型选择 | model_name | 枚举值 | "u2net" | 用哪个模型来抠图 | 背景移除使用的模型 | u2net(通用)、silueta(人像专用) |
| 后处理 | post_process | True/False | True | 要不要对抠图结果进行优化 | 是否进行后处理优化 | 开启后边缘更平滑 |
| 边缘柔化 | edge_smooth | 0-10 | 2 | 抠图边缘的柔化程度 | 边缘平滑处理强度 | 2表示轻微柔化，5表示明显柔化 |
| 输出格式 | output_format | 枚举值 | "rgba" | 输出透明背景还是白色背景 | 输出图像的格式 | rgba(透明背景)、rgb(白色背景) |
4. 使用技巧和建议
4.1 工作流程推荐
-
证件照制作流程：
- Load Images Plus → Face Detection and Crop → Face Alignment → ID Photo Generator → Image Enhancement
-
批量人脸处理流程：
- Load Images Plus → Face Detection and Crop → Face Alignment → Add Watermark
-
专业人像处理流程：
- Load Images Plus → Background Removal → Face Detection and Crop → Image Enhancement
4.2 参数调优建议
- 人脸检测阈值：如果照片中人脸不够清晰，可以降低到0.6-0.7
- 磨皮强度：男性建议0.2-0.3，女性可以0.3-0.5
- 水印透明度：浅色背景用深色水印，深色背景用浅色水印
- 证件照头部比例：不同国家标准不同，中国身份证建议0.6-0.7
4.3 性能优化
- 批量处理时建议分批进行，避免内存占用过高
- 大尺寸图片建议先缩小再处理，提高处理速度
- 使用GPU加速可以显著提高处理速度
5. 常见问题解答
5.1 安装问题
Q: 提示缺少模型文件怎么办？
A: 确保下载了detection_Resnet50_Final.pth文件，并放在正确的文件夹中。
Q: 安装依赖时出错怎么办？
A: 确保Python环境正确，可以尝试使用虚拟环境安装。
5.2 使用问题
Q: 人脸检测不准确怎么办？
A: 尝试调整检测阈值，或者确保输入图片质量足够好。
Q: 证件照背景不干净怎么办？
A: 先使用Background Removal节点去除背景，再使用ID Photo Generator。
Q: 处理速度太慢怎么办？
A: 检查是否使用了GPU加速，或者减小图片尺寸。
5.3 输出问题
Q: 输出的证件照尺寸不对怎么办？
A: 检查photo_type参数，或者使用custom模式自定义尺寸。
Q: 水印太明显或太淡怎么办？
A: 调整opacity参数，0.3-0.7通常是比较合适的范围。
6. 高级应用技巧
6.1 批量证件照制作
利用Load Images Plus节点的批量加载功能，可以一次性处理多张照片：
- 将所有原始照片放在同一个文件夹
- 使用Load Images Plus批量加载
- 连接完整的证件照制作流程
- 一次性输出所有证件照
6.2 多规格证件照生成
通过复制ID Photo Generator节点，可以同时生成多种规格的证件照：
- 设置第一个节点为护照规格
- 设置第二个节点为身份证规格
- 设置第三个节点为驾照规格
- 同时输出三种规格的证件照
6.3 创意人像处理
结合其他ComfyUI插件，可以实现更多创意效果：
- 使用Background Removal去除背景
- 使用其他插件添加创意背景
- 使用Image Enhancement调整整体效果
- 使用Add Watermark添加个性化标识
这个插件集合为ComfyUI用户提供了强大的人像处理能力，无论是日常证件照制作还是专业摄影后期，都能找到合适的解决方案。记住多实践，多尝试不同的参数组合，你会发现更多有趣的用法！