# ComfyUI-Mosaic-Mask 插件 - 马赛克检测与处理神器完全指南 ## 1. 插件简介 **插件原地址：** https://github.com/okgo4/ComfyUI-Mosaic-Mask 这个插件就像一个"马赛克侦探"，专门用来自动检测图片中的马赛克区域并进行处理。简单来说，它能够： - 自动找出图片中哪些地方被打了马赛克 - 把找到的马赛克区域用一个特殊的"蒙版"（像遮罩一样）标记出来 - 让你可以进一步处理这些马赛克区域 想象一下，你有一张图片，里面有些地方被打了马赛克，而你想要知道马赛克在哪里，或者想要对这些马赛克区域做特殊处理。这个插件就是你的得力助手，它会像一个细心的助手一样，帮你把所有的马赛克位置都找出来。 ## 2. 如何安装 **方法一：直接下载法（推荐新手）** 1. 打开 ComfyUI 的安装文件夹 2. 找到 `custom_nodes` 文件夹（这就像一个专门放插件的储物柜） 3. 在这个文件夹里右键，选择"在此处打开命令提示符"或"在此处打开终端" 4. 输入以下命令： ```bash git clone https://github.com/okgo4/ComfyUI-Mosaic-Mask.git ``` 5. 重启 ComfyUI **方法二：手动下载法** 1. 访问 https://github.com/okgo4/ComfyUI-Mosaic-Mask 2. 点击绿色的"Code"按钮，选择"Download ZIP" 3. 把下载的文件解压到 ComfyUI 的 `custom_nodes` 文件夹中 4. 重启 ComfyUI ## 3. 节点逐一解析 根据插件的功能描述，这个插件主要包含以下几个核心节点： ### 3.1 MosaicMask 节点 - 马赛克检测器 这个节点就像一个"马赛克探测器"，它的工作就是仔细观察你给它的图片，然后把所有被打马赛克的地方找出来。 #### 3.2 MosaicMask 节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入图片 | image | 图片文件 | - | 就像给检测器一张照片让它去找马赛克 | 输入需要检测马赛克的原始图像 | 连接一个图片加载节点，把你要检测的图片传进来 | | 返回区域数量 | top_n | 数字 | 1-3 | 告诉检测器最多找出几个马赛克区域，就像告诉助手"最多帮我找3个" | 控制返回的非连续马赛克区域数量，按面积大小排序 | 如果图片里有很多小马赛克，设置为3就只返回最大的3个 | | 扩展像素 | kernel_size | 数字 | 3-10 | 就像给找到的马赛克区域"画一个更大的圈"，让边界更清楚 | 控制在检测到的马赛克区域基础上向外扩展多少像素 | 设置为5就是在马赛克边缘向外扩展5个像素点 | ### 3.3 Mask Smooth Region 节点 - 蒙版平滑处理器 这个节点就像一个"美容师"，专门让粗糙的蒙版边缘变得更加smooth（平滑）。插件强烈推荐在MosaicMask节点后面使用这个节点，否则可能会出现黑色图像问题。 #### 3.4 Mask Smooth Region 节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入蒙版 | mask | 蒙版文件 | - | 就像给美容师一张需要"美容"的蒙版 | 输入需要平滑处理的蒙版图像 | 连接MosaicMask节点的输出，把检测到的蒙版传进来 | | 平滑强度 | smooth_radius | 数字 | 2-8 | 控制"美容"的程度，数字越大越平滑 | 控制平滑处理的半径范围 | 设置为5就是用5个像素的范围来平滑边缘 | | 处理方式 | method | 选择项 | gaussian | 选择用什么方式来"美容"，就像选择不同的美容工具 | 选择平滑算法类型 | gaussian像用柔光镜，median像用磨皮工具 | ## 4. 使用技巧和建议 ### 4.1 最佳使用流程 1. **图片输入** → **MosaicMask节点** → **Mask Smooth Region节点** → **后续处理** 2. 这个顺序就像流水线一样，每个环节都很重要，千万不要跳过平滑处理步骤 ### 4.2 参数调节小窍门 - **top_n参数**：如果你的图片马赛克不多，设置为1-2就够了；如果马赛克很多，可以设置为3-5 - **kernel_size参数**：从小到大慢慢调试，先试试3，如果边缘不够清楚再增加到5-10 - **smooth_radius参数**：一般设置为kernel_size的一半左右效果最好 ### 4.3 常见搭配组合 - **基础检测流程**：Load Image → MosaicMask → Mask Smooth Region → Preview Image - **高级处理流程**：Load Image → MosaicMask → Mask Smooth Region → Inpaint → Save Image ## 5. 常见问题解答 ### Q1：为什么我的图片变成黑色了？ **A1：** 这通常是因为你没有使用Mask Smooth Region节点。记住，一定要在MosaicMask节点后面接上这个平滑处理节点。 ### Q2：检测不到马赛克怎么办？ **A2：** - 检查你的图片质量，太模糊的图片可能检测不出来 - 尝试调整top_n参数，增加检测的区域数量 - 确保马赛克足够明显，太淡的马赛克可能检测不到 ### Q3：检测到的区域太小或太大怎么办？ **A3：** 调整kernel_size参数： - 区域太小：增加kernel_size的值 - 区域太大：减小kernel_size的值 ### Q4：边缘不够平滑怎么办？ **A4：** 在Mask Smooth Region节点中： - 增加smooth_radius的值 - 尝试不同的method选项 ## 6. 实际应用场景 ### 6.1 图片清理工作 当你需要处理一些包含马赛克的图片时，这个插件可以帮你自动找出所有需要处理的区域，比人工查找效率高很多。 ### 6.2 批量处理 如果你有很多图片需要处理，这个插件可以帮你自动化整个检测过程，就像有一个不知疲倦的助手在帮你工作。 ### 6.3 质量控制 在处理大量图片时，可以用这个插件来检查是否有遗漏的马赛克区域，确保处理质量。 ## 7. 进阶技巧 ### 7.1 结合其他节点 - 可以把检测到的蒙版输出给修复（Inpaint）节点，实现自动修复马赛克区域 - 可以结合图像增强节点，对马赛克区域进行特殊处理 ### 7.2 工作流优化 - 建议把常用的参数组合保存为工作流模板，这样下次使用时就不用重新设置了 - 可以建立不同类型图片的专用工作流，比如人物图片工作流、风景图片工作流等 这个插件就像一个智能助手，能够大大提高你处理图片的效率。记住关键点：先检测，后平滑，最后处理。多练习几次，你就能熟练掌握它的使用方法了！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
