%20(1).png)
NSFW图像检测插件 (nsfw-image-check-comfyui) 完整教程
1. 插件简介
GitHub原地址： https://github.com/fallingmeteorite/nsfw-image-check-comfyui
这个插件就像一个"智能保镖"，专门用来检测生成的图片是否包含不适合的内容（比如成人内容）。当它发现有问题的图片时，会自动用一张警告图片或者你指定的替代图片来替换原图。
插件能给我们带来什么效果： - 自动识别图片中的敏感内容，就像有个审查员在帮你检查 - 当发现不合适的图片时，立即用安全的图片替换掉 - 可以设置检测的严格程度，就像调节"敏感度"一样 - 完全离线工作，不需要联网，保护你的隐私
2. 如何安装
方法一：手动安装（推荐新手）
- 打开ComfyUI的安装文件夹
- 找到
custom_nodes文件夹 - 在这个文件夹里右键打开命令行（或者终端）
- 输入以下命令：
git clone https://github.com/fallingmeteorite/nsfw-image-check-comfyui.git
cd nsfw-image-check-comfyui
pip install -r requirements.txt
方法二：使用ComfyUI管理器
如果你安装了ComfyUI管理器，可以直接运行：
comfy node registry-install nsfw-image-check-comfyui
安装完成后
- 重启ComfyUI
- 在节点列表中找到
Nsfw Image Check Node节点 - 插件会自动下载所需的检测模型（第一次使用时）
3. 节点详解
3.1 主要检测节点：Nsfw Image Check Node
这个节点就像一个"图片检查员"，它会仔细检查每张图片，看看是否包含不合适的内容。
3.2 输入输出接口说明
| 接口名称 | 接口类型 | 通俗解释 |
|---|---|---|
| image_requires_in | 图像输入 | 这是要检查的图片进来的地方，就像检查站的入口 |
| image_requires_out | 图像输出 | 检查后的图片出去的地方，要么是原图，要么是替换图 |
| custom_image_out | 自定义图像输出 | 你自己指定的替换图片的出口 |
| corresponding_filter_entries | 文本输出 | 告诉你触发了哪些检测规则的提示信息 |
3.3 参数详解
| 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 默认值 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|---|
| 启用检测 | enabled_check | 布尔值 | True | True | 这个开关决定要不要开启检测功能，就像电器的总开关 | 控制是否启用NSFW内容检测功能 | 设为True时会检测图片，设为False时直接放行所有图片 |
| 过滤阈值 | threshold | 浮点数 | 0.5 | 0.3-0.7 | 这个数字决定检测有多严格，数字越小越严格，就像调节音量大小 | 设置触发NSFW检测的置信度阈值，范围0到1 | 设为0.3时比较严格，轻微问题也会被检测到；设为0.7时比较宽松 |
| 启用此类检测 | enabled | 布尔值 | True | True | 每种检测类型的独立开关，就像房间里每个灯的开关 | 控制特定类型的NSFW检测是否启用 | 可以只开启某些类型的检测，比如只检测裸体不检测其他 |
| 过滤选择模式 | filter_choose | 选择项 | auto | auto | 选择要检测哪些类型的内容，auto就是全自动模式 | 设置检测模式，可选择特定类型或自动检测所有类型 | 选择auto会检测所有类型，选择specific可以只检测特定类型 |
3.4 检测类型说明
插件支持多种检测类型，每种都有对应的参数：
| 检测类型 | 通俗解释 | 建议阈值 | 使用场景 |
|---|---|---|---|
| 一般敏感内容 | 检测一般的成人内容 | 0.5 | 大多数场景适用 |
| 极度敏感内容 | 检测非常明显的不当内容 | 0.3 | 需要严格控制的场景 |
| 暴力内容 | 检测包含暴力的图片 | 0.4 | 面向全年龄的应用 |
| 其他不当内容 | 检测其他类型的问题内容 | 0.6 | 作为补充检测 |
4. 使用技巧和建议
4.1 基础连接方法
- 输入连接：将你的图片生成节点（比如VAE Decode）的输出连接到
image_requires_in - 输出连接：将
image_requires_out连接到你的图片保存节点或显示节点 - 替换图片：如果需要自定义替换图片，将你的替换图片连接到
custom_image_out
4.2 阈值调节建议
- 严格模式：阈值设为0.2-0.3，几乎所有可疑内容都会被替换
- 平衡模式：阈值设为0.4-0.6，在准确性和误判之间取平衡
- 宽松模式：阈值设为0.7-0.8，只有明显的问题内容才会被替换
4.3 自定义替换图片
- 在插件文件夹中找到
img文件夹 - 将你的替换图片放入这个文件夹
- 图片必须是
.jpg格式 - 文件名必须是数字（比如
1.jpg,2.jpg）
4.4 性能优化建议
- 如果你的电脑配置不高，可以适当提高阈值来减少计算量
- 在批量处理时，建议先用小批量测试合适的参数
- 检测功能会增加一些处理时间，根据需要决定是否启用
5. 常见问题解答
Q1：为什么有些明显有问题的图片没有被检测到？
A1： 可能是阈值设置太高了。试试把阈值调低一点，比如从0.5调到0.3。
Q2：为什么正常的图片也被误判了？
A2： 可能是阈值设置太低了。试试把阈值调高一点，比如从0.3调到0.6。
Q3：替换图片不显示怎么办？
A3： 检查以下几点：
- 替换图片是否放在正确的 img 文件夹中
- 图片格式是否为 .jpg
- 文件名是否为纯数字
- 图片是否损坏
Q4：插件影响生图速度吗？
A4： 会有一定影响，因为需要额外的检测时间。如果对速度要求很高，可以考虑只在必要时启用检测功能。
Q5：检测结果不准确怎么办？
A5： 可以尝试：
- 调整不同类型检测的阈值
- 使用 auto 模式让插件自动选择最佳检测策略
- 根据你的具体需求启用或关闭某些检测类型
6. 高级使用技巧
6.1 批量处理优化
当你需要处理大量图片时：
1. 先用单张图片测试最佳参数
2. 可以准备多张不同风格的替换图片
3. 使用 corresponding_filter_entries 输出来记录检测日志
6.2 与其他节点配合
这个插件可以与以下节点完美配合： - 图片保存节点：确保保存的都是安全图片 - 图片预览节点：在预览阶段就过滤问题内容 - 批处理节点：批量处理时自动过滤
6.3 监控和调试
利用 corresponding_filter_entries 输出：
- 可以看到具体触发了哪些检测规则
- 帮助你调整参数设置
- 用于记录和分析检测结果
7. 总结
这个NSFW图像检测插件就像给你的ComfyUI安装了一个"智能保安"，它会自动检查生成的图片，确保内容的安全性。通过合理调节参数，你可以在检测准确性和处理速度之间找到最佳平衡点。
记住最重要的几点： - 根据你的使用场景调整阈值 - 准备好合适的替换图片 - 定期查看检测日志来优化参数 - 在批量处理前先进行小规模测试
这样你就可以安心地让ComfyUI为你生成图片，而不用担心出现不合适的内容了！