%20(1).png)
HivisionIDPhotos-ComfyUI 插件保姆级教程
1. 插件简介
插件地址： https://github.com/AIFSH/HivisionIDPhotos-ComfyUI
这个插件就像是一个专业的证件照制作工厂！它能把你的普通照片变成标准的证件照，就像去照相馆拍证件照一样，但是更方便、更智能。
主要功能：
- 自动识别人脸并抠图（把人像从背景中分离出来）
- 更换证件照背景颜色（红色、蓝色、白色等各种标准颜色）
- 自动调整人像大小和位置，符合证件照标准
- 添加水印保护你的照片
- 制作证件照排版（一张纸上放多张小照片）
- 美颜功能（美白、调亮度、增强对比度等）
能带来什么效果：
- 把任意照片变成标准证件照
- 支持各种证件照尺寸（一寸、二寸、护照照片等）
- 可以批量制作不同背景色的证件照
- 制作专业的证件照排版，方便打印
- 节省去照相馆的时间和费用
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI
- 点击"Manager"按钮
- 搜索"HivisionIDPhotos"
- 点击安装
方法二：手动安装
- 打开你的ComfyUI安装文件夹
- 进入
custom_nodes文件夹 - 在这里打开命令行窗口
- 输入命令：
git clone https://github.com/AIFSH/HivisionIDPhotos-ComfyUI.git
重要：下载必需的模型文件
安装插件后，你还需要下载一些模型文件，就像给机器装上"眼睛"和"大脑"：
抠图模型（必须下载至少一个）：
modnet_photographic_portrait_matting.onnx(24.7MB) - 基础抠图模型hivision_modnet.onnx(24.7MB) - 更适合纯色背景的抠图模型rmbg-1.4.onnx(176.2MB) - 高精度抠图模型birefnet-v1-lite.onnx(224MB) - 最新的抠图模型
人脸检测模型（可选）：
retinaface-resnet50.onnx- 更精确的人脸检测
存放位置：
把下载的模型文件放到：ComfyUI/custom_nodes/HivisionIDPhotos-ComfyUI/hivision/creator/weights/文件夹里
3. 节点详细解析
3.1 HivisionNode 节点 - 证件照制作核心
这个节点就像一个全自动的证件照制作机器，把你的普通照片变成标准证件照。它会自动识别人脸、抠图、调整大小和位置。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| input_img | input_img | IMAGE类型 | 必填 | 你要制作证件照的原始照片 | 输入的原始图像数据 | 连接你上传的人像照片 |
| normal_params | normal_params | PARAMS类型 | 必填 | 证件照的规格参数，就像选择照片尺寸和背景色 | 证件照制作的参数配置 | 连接参数设置节点 |
| face_alignment | face_alignment | true/false | true | 是否自动调正人脸角度，就像自动把歪着的脸摆正 | 是否进行人脸角度校正 | true会自动摆正脸部，false保持原样 |
| change_bg_only | change_bg_only | true/false | false | 是否只换背景不调整人像，就像只换墙纸不动家具 | 是否仅更换背景而不调整人像 | true只换背景，false会调整人像大小位置 |
| crop_only | crop_only | true/false | false | 是否只裁剪不换背景，就像只剪照片不换底色 | 是否仅进行裁剪而不更换背景 | true只裁剪人像，false会换背景 |
| matting_model | matting_model | 模型列表 | modnet_photographic_portrait_matting | 选择抠图模型，就像选择不同的剪刀 | 用于人像分割的AI模型 | 不同模型抠图效果不同，可以试试看哪个好 |
| face_detect_model | face_detect_model | 模型列表 | mtcnn | 选择人脸检测模型，就像选择不同的眼镜 | 用于人脸检测的AI模型 | mtcnn是基础版，retinaface更精确 |
| head_measure_ratio | head_measure_ratio | 0.1-0.5的小数 | 0.2 | 头部在照片中的比例，就像调节人脸大小 | 头部占证件照的比例系数 | 0.2是标准比例，0.3会让脸更大 |
| top_distance | top_distance | 0.02-0.5的小数 | 0.12 | 头顶距离照片上边的距离，就像调节人在照片中的位置 | 头顶到图像上边缘的距离比例 | 0.12是标准位置，数值越小人越靠上 |
| whitening_strength | whitening_strength | 0-15的整数 | 2 | 美白强度，就像美颜相机的美白功能 | 皮肤美白处理强度 | 0不美白，5是自然美白，10是明显美白 |
| brightness_strength | brightness_strength | -5到25的整数 | 0 | 亮度调节，就像调节照片明暗 | 图像亮度调整强度 | 负数变暗，正数变亮，0不变 |
| contrast_strength | contrast_strength | -10到50的整数 | 0 | 对比度调节，就像调节照片清晰度 | 图像对比度调整强度 | 正数增强对比度，负数降低对比度 |
| saturation_strength | saturation_strength | -10到50的整数 | 0 | 饱和度调节，就像调节照片色彩鲜艳程度 | 图像饱和度调整强度 | 正数颜色更鲜艳，负数颜色更淡 |
| sharpen_strength | sharpen_strength | 0-5的整数 | 0 | 锐化强度，就像让照片更清晰 | 图像锐化处理强度 | 0不锐化，3是适中锐化，5是强锐化 |
3.2 ZHHivisionParamsNode 节点 - 中文参数设置器
这个节点就像一个中文的设置面板，让你用中文选择证件照的各种规格，比如尺寸、背景色等。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| size | size | 中文尺寸列表 | 一寸 | 选择证件照尺寸，就像选择照片大小 | 证件照的标准尺寸规格 | 一寸、二寸、护照照片等不同用途 |
| bgcolor | bgcolor | 中文颜色列表 | 蓝色 | 选择背景颜色，就像选择墙纸颜色 | 证件照背景色彩设置 | 蓝色、红色、白色等标准证件照颜色 |
| render | render | 纯色/上下渐变/中心渐变 | 纯色 | 背景渲染方式，就像选择背景样式 | 背景色彩渲染模式 | 纯色是单一颜色，渐变有层次感 |
| kb | kb | 整数 | 300 | 照片文件大小限制，就像控制照片占用空间 | 输出图像的文件大小限制(KB) | 300KB适合网上上传，50KB适合小文件 |
| dpi | dpi | 整数 | 300 | 照片清晰度，就像调节打印质量 | 图像分辨率设置 | 300适合打印，72适合网络显示 |
3.3 ENHivisionParamsNode 节点 - 英文参数设置器
这个节点和中文版功能一样，只是界面是英文的，适合习惯英文界面的用户。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| size | size | 英文尺寸列表 | 1 inch | 选择证件照尺寸，就像选择照片大小 | 证件照的标准尺寸规格 | 1 inch、2 inch、passport等国际标准 |
| bgcolor | bgcolor | 英文颜色列表 | Blue | 选择背景颜色，就像选择墙纸颜色 | 证件照背景色彩设置 | Blue、Red、White等标准证件照颜色 |
| render | render | pure_color/updown_gradient/center_gradient | pure_color | 背景渲染方式，就像选择背景样式 | 背景色彩渲染模式 | pure_color是纯色，gradient是渐变 |
| kb | kb | 整数 | 300 | 照片文件大小限制，就像控制照片占用空间 | 输出图像的文件大小限制(KB) | 300KB适合网上上传，50KB适合小文件 |
| dpi | dpi | 整数 | 300 | 照片清晰度，就像调节打印质量 | 图像分辨率设置 | 300适合打印，72适合网络显示 |
3.4 AddBackgroundNode 节点 - 背景添加器
这个节点就像一个换背景的魔法棒，给已经抠好图的人像添加新的背景色。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| input_img | input_img | IMAGE类型 | 必填 | 已经抠好图的人像照片，就像剪好的贴纸 | 输入的透明背景人像图像 | 连接抠图后的人像图片 |
| normal_params | normal_params | PARAMS类型 | 必填 | 背景设置参数，就像选择贴纸要贴在什么颜色的纸上 | 背景色彩和渲染参数配置 | 连接参数设置节点 |
3.5 AddWaterMarkNode 节点 - 水印添加器
这个节点就像一个印章机，给你的证件照加上水印，防止别人盗用你的照片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| input_img | input_img | IMAGE类型 | 必填 | 要加水印的照片，就像要盖章的文件 | 输入的原始图像 | 连接你要加水印的照片 |
| text | text | 文字 | AIFSH | 水印文字内容，就像印章上的字 | 水印显示的文本内容 | 可以写你的名字或版权信息 |
| text_color | text_color | 颜色代码 | #FFFFFF | 水印文字颜色，就像选择印章颜色 | 水印文本的颜色设置 | #FFFFFF是白色，#000000是黑色 |
| text_size | text_size | 10-100的整数 | 20 | 水印文字大小，就像调节印章大小 | 水印文本的字体大小 | 20是适中大小，50是大字，10是小字 |
| text_opacity | text_opacity | 0-1的小数 | 0.15 | 水印透明度，就像调节印章深浅 | 水印文本的透明度 | 0.15是很淡，0.5是半透明，1是完全不透明 |
| text_angle | text_angle | 0-360的整数 | 30 | 水印文字角度，就像调节印章倾斜度 | 水印文本的旋转角度 | 0是水平，30是轻微倾斜，45是斜角 |
| text_space | text_space | 10-200的整数 | 25 | 水印文字间距，就像调节印章密度 | 水印文本之间的间距 | 25是适中间距，50是稀疏，10是密集 |
3.6 HivisionLayOutNode 节点 - 证件照排版器
这个节点就像一个自动排版机，把单张证件照排列成一张纸上的多张小照片，方便打印。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| input_img | input_img | IMAGE类型 | 必填 | 单张证件照，就像要复印的原件 | 输入的单张证件照图像 | 连接制作好的证件照 |
| normal_params | normal_params | PARAMS类型 | 必填 | 排版参数，就像设置复印份数和排列方式 | 排版布局的参数配置 | 连接参数设置节点 |
3.7 LaterProcessNode 节点 - 后期处理器
这个节点就像一个最终加工机，对证件照进行最后的文件大小和清晰度调整。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| input_img | input_img | IMAGE类型 | 必填 | 要进行最终处理的照片，就像要包装的产品 | 输入的待处理图像 | 连接前面处理好的照片 |
| normal_params | normal_params | PARAMS类型 | 必填 | 处理参数，就像包装规格要求 | 文件大小和分辨率参数 | 连接参数设置节点 |
4. 使用技巧和建议
4.1 基础使用流程
- 准备照片：选择一张清晰的人像照片，最好是正面照
- 设置参数：使用参数节点设置证件照规格
- 制作证件照：使用HivisionNode节点处理照片
- 添加背景：如果需要可以用AddBackgroundNode换背景
- 添加水印：用AddWaterMarkNode保护照片版权
- 制作排版：用HivisionLayOutNode制作打印版
- 最终处理：用LaterProcessNode调整文件大小
4.2 不同用途的参数建议
身份证照片：
- 尺寸：二寸
- 背景：白色或蓝色
- 美白强度：2-5
- 亮度：0-5
护照照片：
- 尺寸：护照照片
- 背景：白色
- 美白强度：1-3
- 对比度：5-10
驾照照片：
- 尺寸：一寸
- 背景：白色
- 美白强度：2-4
- 锐化强度：1-2
求职照片：
- 尺寸：二寸
- 背景：蓝色或红色
- 美白强度：3-6
- 亮度：2-8
- 对比度：5-15
4.3 照片质量优化建议
- 原始照片要求：清晰、正面、光线充足
- 美颜参数：不要调得太高，保持自然
- 背景选择：根据用途选择合适颜色
- 文件大小：网上上传用50-200KB，打印用300-500KB
4.4 批量制作技巧
- 可以连接多个AddBackgroundNode制作不同背景色版本
- 使用相同参数设置可以保证多张照片规格一致
- 建议先用一张照片测试参数，满意后再批量处理
5. 常见问题解答
Q1：为什么抠图效果不好？
A： 可能的原因和解决方案：
- 原始照片背景太复杂：选择背景简单的照片
- 抠图模型不合适：尝试不同的matting_model
- 照片质量不好：使用清晰度高的照片
Q2：人脸位置不合适怎么办？
A： 调节这些参数：
- head_measure_ratio：调节人脸大小比例
- top_distance：调节人脸在照片中的位置
- 如果还不满意，可以关闭face_alignment试试
Q3：美颜效果太假怎么办？
A： 降低美颜参数：
- whitening_strength降到1-3
- brightness_strength降到0-3
- 其他参数也适当降低
Q4：文件太大无法上传怎么办？
A： 调节文件大小：
- 降低kb参数（比如从300改为50）
- 降低dpi参数（比如从300改为150）
- 使用LaterProcessNode进行压缩
Q5：背景色不是我想要的怎么办？
A： 检查这些设置：
- 确认bgcolor参数选择正确
- 检查render参数是否设为"纯色"
- 可能需要重新下载颜色配置文件
Q6：水印太明显或太淡怎么办？
A： 调节水印参数：
- text_opacity调节透明度
- text_size调节大小
- text_color调节颜色
6. 高级使用技巧
6.1 工作流搭建建议
原始照片 → 参数设置 → HivisionNode → AddBackgroundNode → AddWaterMarkNode → HivisionLayOutNode → LaterProcessNode → 最终输出
6.2 多版本制作
- 使用多个AddBackgroundNode制作不同背景色版本
- 使用不同的参数设置制作不同规格版本
- 可以同时输出标准版和高清版
6.3 质量控制技巧
- 先用小图测试参数，满意后再用大图
- 对比standard_img和hd_img选择最佳版本
- 根据最终用途选择合适的dpi和kb设置
6.4 批量处理优化
- 相同类型照片使用相同参数设置
- 建立标准化的工作流模板
- 合理安排节点顺序提高效率
7. 故障排除
7.1 常见错误及解决方案
错误：人脸数量不等于1
- 原因：照片中没有人脸或有多个人脸
- 解决：使用只有一个人脸的照片
错误：模型文件未找到
- 原因：没有下载必需的模型文件
- 解决：下载对应的.onnx模型文件到weights文件夹
错误：内存不足
- 原因：照片太大或模型占用内存过多
- 解决：缩小照片尺寸或重启ComfyUI
错误：抠图效果差
- 原因：模型不适合当前照片类型
- 解决：尝试不同的抠图模型
7.2 性能优化建议
- 首次使用时模型加载较慢，请耐心等待
- 大批量处理时建议分批进行
- 定期清理临时文件释放空间
8. 实际应用案例
8.1 求职简历照片
制作专业的求职照片，背景选择蓝色或红色，适当美颜但保持自然。
8.2 证件照批量制作
一次制作多种背景色和尺寸的证件照，满足不同证件需求。
8.3 学生证照片
制作学校要求的标准证件照，通常是蓝色背景一寸照片。
8.4 护照照片制作
严格按照护照照片标准制作，白色背景，不过度美颜。
9. 总结
HivisionIDPhotos-ComfyUI插件是一个功能全面的证件照制作工具，它能让你在家就制作出专业水准的证件照。虽然有7个不同的节点，但每个都有明确的作用，组合使用可以实现完整的证件照制作流程。
核心要点：
- 下载必需的模型文件是使用前提
- 选择合适的原始照片很重要
- 根据用途调节不同的参数
- 合理使用美颜功能保持自然
- 掌握工作流搭建提高效率
适用场景：
- 各种证件照制作
- 求职简历照片
- 学生证照片
- 护照签证照片
- 批量证件照处理
这个插件让普通用户也能制作出专业级的证件照，是ComfyUI生态中非常实用的工具之一。