图片批量人脸检测与自动模糊工具教程

功能关键词：批量人脸遮罩、高斯模糊、马赛克、人脸区域扩展、图片格式输出。

工具介绍

图片批量人脸检测与自动模糊工具用于检测图片中的人脸，并对检测到的区域应用高斯模糊、马赛克或像素化。适合统一遮罩一组照片中的人脸区域。

页面提供输入源目录和保存目录、子目录遍历、模糊强度、区域扩展、输出格式和质量，以及进度、检测数量、日志。自动检测仅处理检测到的区域，页面没有手动框选或处理效果预览。

工具截图

主要功能

1. 添加单张图片、多张图片或文件夹，或拖动文件或目录进行添加。
2. 根据需要递归遍历子目录，并在输出中保留输入源的相对层级。
3. 自动检测人脸区域，并对一张图片中检测到的多张人脸应用同一组遮罩设置。
4. 提供高斯模糊、马赛克、像素化3种方式，强度为10至100。
5. 以0至100%的区域扩展率扩展人脸检测框的遮罩范围。
6. 保留输入源扩展名，或统一以JPG、PNG或WebP输出，并将质量设置为1至100。
7. 显示图片总数、已处理数、检测到的人脸数、无人脸图片数、失败数及日志，并支持停止剩余任务。

使用前的准备

输入支持JPG/JPEG、PNG、BMP、WebP及TIFF/TIF。保存目录可以选择，也可以拖动文件夹指定；实际开始前请确认写入权限。

软件运行需要可用的人脸检测器。处理时会先尝试InsightFace，加载失败时可回退到Haar级联，具体初始化状态会写入日志。页面没有模型选择、置信度、显卡选项，也没有安装按钮或下载按钮。

开始处理时，会再次验证当前账户的权限。请准备图片和单独的保存目录，然后设置参数；请勿将“保留原格式”理解为原文件的元数据、Alpha通道或多页内容全部保持不变。

详细操作步骤

1. 点击输入的“浏览”选择文件或文件夹

点击“路径设置”中“输入路径”行的“浏览”，在显示的“选择输入类型”窗口中点击“选择文件”添加一张或多张图片，或点击“选择文件夹”添加目录，然后在系统窗口中选择输入源。

如果是多个文件，会显示“已选择n个文件”。再次浏览会替换当前输入源；如果之前选择了多个文件，切换到目录处理时请再次浏览并选择文件夹，避免仅修改输入框文本后仍继续使用旧文件列表。

也可以将输入源拖到输入路径附近的位置。一次拖入多个项目时，仅使用第一项；保存路径和输入路径根据放置位置区分，因此请注意放置的位置。

2. 设置保存目录和子目录范围

点击“保存目录”右侧的“浏览”选择输出文件夹，或将目录拖到保存目录附近的位置。处理实际开始时，会尝试创建尚不存在的输出目录。

要处理输入文件夹所有层级的内容，请勾选“遍历子目录”；要仅处理当前层级，请勿勾选。如果需要保存相同层级，还请勾选“保留原路径结构”；此项仅在启用遍历后可用。

保留结构时以输入目录为基准；选择多个文件时，以包含第一个输入源的目录为基准。对于位于多个不同根目录中的文件，建议分批处理，以避免相对路径超出预期层级。

3. 选择模糊方式并调整强度

展开“参数与控制”中的“模糊类型”，根据需要选择高斯模糊、马赛克或像素化。高斯模糊会模糊区域，马赛克和像素化会先缩小区域再放大，生成块状效果。

拖动“模糊强度”滑块，右侧数值会实时显示10至100，初始值为50。值越大，模糊越强或色块越大，但效果仅应用于检测到的人脸区域，并非统一模糊整张图片。

页面没有预览、显示检测框、手动添加框或排除特定人脸的选项；最终遮罩范围需要结合检测结果评估。

4. 设置区域扩展、输出格式、质量后开始

拖动“区域扩展”滑块；初始值为20%，可设置为0至100%。将检测框周围向外对称扩展：20%表示宽度和高度分别增加约20%，每边增加原宽度或高度的约10%，超出图片边缘的部分会在边界处裁剪。

在“输出格式”中选择“保留原格式”、JPG、PNG或WEBP。质量范围为1至100，初始值为95：JPG和WebP使用对应的有损编码质量；PNG对应无损压缩级别，该值不表示PNG图片的损失；BMP/TIFF不使用此质量值。

确认输入源、保存位置及参数后，点击“开始处理”，软件才会在此时初始化检测器，并逐张处理图片。如需取消剩余图片，请点击“停止”；当前正在处理的图片可能会完成并写出，此前的输出会保留。

5. 使用统计和日志确认完成情况

查看“进度与日志”的进度条和统计行。“总计”是本批次的图片数，“已处理”是到达完成分支的图片数，“检测到的人脸”是多张图片的人脸累计数，“无人脸”是未返回检测框的图片数。

日志会显示检测器初始化、逐张图片处理、读取失败或其他异常。未检测到人脸的图片也会按所选格式重新编码并输出，不会自动跳过。检测器异常也可能返回零人脸数，因此“无人脸”并不意味着已确认图片中不包含人脸。

完成后，使用文件管理器查看保存目录中的输出。页面没有“打开目录”、“另存为”、“下载”、“导出报告”或“预览”按钮，可以选择并复制日志文本。停止或检测器初始化失败等情况下，也可能显示通用的“完成”状态，需要结合日志和失败数评估。

主要参数说明

结果与保存

图片写入所选保存目录；保留结构时，会添加输入源的相对层级。保留原文件名的主体部分，名称冲突时会附加_1、_2等编号。没有原地替换按钮或删除输入源按钮。

“保留原格式”会保留扩展名，但图片会作为OpenCV彩色图片重新读取和编码，Alpha通道不会保留，也不会显式复制EXIF、ICC或多页/多帧内容。如果以所选格式编码失败，会尝试以质量95写出JPG。

编码回退后的JPG文件名不会再次应用完整的文件名冲突规避流程，因此建议使用单独的保存目录。页面的处理数并不是通过重新读取输出进行验证的，通用的完成消息不能证明所有文件和遮罩均满足要求。

软件不生成CSV分类报告，也不保存可进一步编辑的遮罩项目。如果需要查看日志，可以在关闭前选择并复制相应文本。

常见问题与使用建议

1. 为什么“保留结构”显示为灰色？

先勾选“遍历子目录”，“保留原路径结构”便可选择。

2. 为什么拖入多张图片后只显示第一张？

拖放事件仅使用第一项；对于多张图片，请点击“浏览”后点击“选择文件”，选择多个文件。

3. 为什么手动更改路径后仍处理旧文件？

此前选择的多个文件的内部列表具有优先权；切换输入源时，请使用“浏览”重新选择文件或文件夹。

4. 区域扩展的20%是指每边各扩展20%吗？

不是，宽度和高度总量分别增加约20%，左右或上下各边分别增加约10%，并在图片边界处进行裁剪。

5. 无人脸图片会被跳过吗？

不会，它们也会按照输出设置重新编码并保存。

6. 可以只遮罩特定的一个人吗？

页面没有人脸选择、手动框选、排除或预览控件。

7. PNG的质量95会降低画质吗？

在此实现中，PNG的质量值对应无损压缩级别，与JPG的有损质量含义不同。

8. “保留原格式”可以保留透明背景吗？

不能以此为依据作出保证；读取时使用3个颜色通道，透明度信息不会作为原Alpha通道保留。

9. 停止后还会继续保存吗？

当前图片可能会继续到完成，停止主要是不再处理后续图片，并不会删除已经写出的文件。

10. “完成”状态是否意味着所有人脸均已处理？

不是，漏检、初始化错误及其他问题需要结合日志评估，页面没有检测完整性验证。