# ComfyUI-PoseKeypoint-Mask 插件完整教程 ## 1. 插件简介 **插件地址：** https://github.com/muzi12888/ComfyUI-PoseKeypoint-Mask 这个插件就像一个智能的"人体识别器"，专门用来把人体的关键点（比如头部、手臂、腿部等位置）转换成一个个遮罩图像。简单来说，它就像给你一个神奇的工具，能够自动识别照片中人的姿势，然后帮你制作出只覆盖人体特定部位的"模板"。 **主要作用：** - 把人体姿势关键点变成可以使用的遮罩 - 帮助你精确控制图像处理的区域 - 让你能够只对人体的某个部位进行特效处理 想象一下，你有一张人物照片，想要只给人的脸部或手部添加特效，这个插件就能帮你精确地"圈出"这些部位，就像用模板刻字一样方便。 ## 2. 如何安装 ### 方法一：手动安装（推荐新手） 1. 打开你的 ComfyUI 文件夹 2. 找到 `custom_nodes` 文件夹 3. 在这个文件夹里新建一个文件夹，命名为 `ComfyUI-PoseKeypoint-Mask` 4. 把插件的所有文件放进这个新文件夹里 5. 重启 ComfyUI ### 方法二：使用 ComfyUI Manager 1. 在 ComfyUI 界面点击 "Manager" 按钮 2. 选择 "Install Custom Nodes" 3. 搜索 "PoseKeypoint Mask" 4. 点击安装 5. 重启 ComfyUI ## 3. 节点详细解析 ### 3.1 PoseKeypoint To Mask 节点 这个节点就像一个"人体部位识别器"，它能够读取人体关键点的信息，然后制作出对应的遮罩图像。 **节点作用：** 把人体姿势的关键点数据转换成黑白遮罩图像，白色部分表示要处理的区域，黑色部分表示不处理的区域。 #### 参数详解： | 参数名 (界面显示) | 参数名 (代码内部) | 参数值范围 | 建议值 | 通俗解释 | 专业解释 | 使用举例 | |:---|:---|:---|:---|:---|:---|:---| | 关键点数据 | pose_keypoints | 人体关键点数据 | 来自姿势检测 | 就像人体的"定位点"信息，告诉电脑头在哪、手在哪 | 包含人体各个关节和部位坐标的数据结构 | 连接 OpenPose 节点的输出 | | 图像宽度 | width | 64-4096 | 512 | 生成遮罩的宽度，就像画纸的宽度 | 输出遮罩图像的像素宽度 | 一般设置为512或1024 | | 图像高度 | height | 64-4096 | 512 | 生成遮罩的高度，就像画纸的高度 | 输出遮罩图像的像素高度 | 一般设置为512或1024 | | 遮罩半径 | mask_radius | 1-100 | 20 | 每个关键点周围的"涂色范围"，数值越大涂色面积越大 | 以关键点为中心绘制圆形遮罩的半径大小 | 想要粗略遮罩用30-50，精细遮罩用10-20 | | 连接线条 | draw_lines | true/false | true | 是否把关键点之间用线连起来，就像连点成线 | 是否在关键点之间绘制连接线条 | 制作全身遮罩时开启，只要部分区域时关闭 | ### 3.2 Body Parts Mask 节点 这个节点就像一个"人体分区器"，能够只选择人体的特定部位来制作遮罩，比如只要头部，或者只要手部。 **节点作用：** 从完整的人体关键点中选择特定的身体部位，制作专门的遮罩。 #### 参数详解： | 参数名 (界面显示) | 参数名 (代码内部) | 参数值范围 | 建议值 | 通俗解释 | 专业解释 | 使用举例 | |:---|:---|:---|:---|:---|:---|:---| | 关键点数据 | pose_keypoints | 人体关键点数据 | 来自姿势检测 | 输入的人体"定位点"信息 | 完整的人体关键点坐标数据 | 连接 OpenPose 节点的输出 | | 身体部位 | body_part | 下拉选择 | head | 选择要制作遮罩的身体部位，就像选择要涂色的区域 | 指定要提取的身体部位类型 | 选择"head"制作头部遮罩，"hands"制作手部遮罩 | | 图像宽度 | width | 64-4096 | 512 | 生成遮罩的宽度 | 输出遮罩图像的像素宽度 | 根据原图尺寸设置 | | 图像高度 | height | 64-4096 | 512 | 生成遮罩的高度 | 输出遮罩图像的像素高度 | 根据原图尺寸设置 | | 遮罩半径 | mask_radius | 1-100 | 25 | 每个关键点的"涂色范围" | 遮罩点的半径大小 | 头部用30-40，手部用15-25 | | 羽化边缘 | feather | 0-50 | 5 | 让遮罩边缘变得柔和，就像模糊边缘 | 遮罩边缘的柔化程度 | 想要自然过渡用5-10，要硬边缘用0 | ### 3.3 Multiple Poses Mask 节点 这个节点就像一个"多人识别器"，当照片里有多个人时，它能够为每个人都制作遮罩。 **节点作用：** 处理包含多个人的图像，为每个人分别制作遮罩或者制作统一的遮罩。 #### 参数详解： | 参数名 (界面显示) | 参数名 (代码内部) | 参数值范围 | 建议值 | 通俗解释 | 专业解释 | 使用举例 | |:---|:---|:---|:---|:---|:---|:---| | 多人关键点 | multi_pose_keypoints | 多人关键点数据 | 来自姿势检测 | 包含多个人的"定位点"信息 | 包含多个人体关键点的数据数组 | 连接能检测多人的 OpenPose 节点 | | 处理模式 | process_mode | individual/combined | combined | 选择分别处理每个人还是把所有人合并处理 | 多人遮罩的生成模式 | 要分别处理选individual，要整体处理选combined | | 图像宽度 | width | 64-4096 | 512 | 生成遮罩的宽度 | 输出遮罩图像的像素宽度 | 根据原图尺寸设置 | | 图像高度 | height | 64-4096 | 512 | 生成遮罩的高度 | 输出遮罩图像的像素高度 | 根据原图尺寸设置 | | 遮罩半径 | mask_radius | 1-100 | 20 | 每个关键点的"涂色范围" | 遮罩点的半径大小 | 多人场景建议用稍小的值15-25 | | 人物索引 | person_index | 0-10 | 0 | 选择处理第几个人，就像选择第几个目标 | 指定要处理的人物编号 | 0表示第一个人，1表示第二个人 | ### 3.4 Keypoint Filter 节点 这个节点就像一个"关键点筛选器"，能够过滤掉不需要的关键点，只保留你想要的部分。 **节点作用：** 对关键点进行筛选和过滤，去除置信度低的点或者特定的关键点。 #### 参数详解： | 参数名 (界面显示) | 参数名 (代码内部) | 参数值范围 | 建议值 | 通俗解释 | 专业解释 | 使用举例 | |:---|:---|:---|:---|:---|:---|:---| | 关键点数据 | pose_keypoints | 人体关键点数据 | 来自姿势检测 | 输入的人体"定位点"信息 | 待过滤的关键点数据 | 连接 OpenPose 节点的输出 | | 置信度阈值 | confidence_threshold | 0.0-1.0 | 0.5 | 关键点的"可信度"门槛，低于这个值的点会被忽略 | 关键点检测置信度的最低要求 | 图像清晰用0.3，模糊用0.1 | | 排除关键点 | exclude_keypoints | 多选列表 | 空 | 选择不想要的关键点，就像黑名单 | 需要从结果中排除的关键点类型 | 不想要脸部就排除面部关键点 | | 包含关键点 | include_keypoints | 多选列表 | 全部 | 选择只要的关键点，就像白名单 | 需要保留在结果中的关键点类型 | 只想要手部就只选择手部关键点 | | 平滑处理 | smooth_keypoints | true/false | false | 是否让关键点位置更加平滑稳定 | 对关键点坐标进行平滑滤波 | 视频处理时开启，单张图片关闭 | ## 4. 使用技巧和建议 ### 4.1 参数调优建议 **遮罩半径的选择：** - 制作粗略遮罩：30-50 - 制作精细遮罩：10-20 - 处理多人场景：15-25 - 处理特写照片：20-30 **置信度阈值的设置：** - 高质量图像：0.5-0.7 - 普通图像：0.3-0.5 - 模糊图像：0.1-0.3 ### 4.2 常见工作流程 1. **基础人体遮罩制作** - 输入图像 → OpenPose 检测 → PoseKeypoint To Mask → 输出遮罩 2. **特定部位遮罩制作** - 输入图像 → OpenPose 检测 → Body Parts Mask → 输出部位遮罩 3. **多人场景处理** - 输入图像 → OpenPose 检测 → Multiple Poses Mask → 输出多人遮罩 ### 4.3 质量提升技巧 - 使用羽化边缘让遮罩更自然 - 根据图像质量调整置信度阈值 - 多人场景建议先用 individual 模式测试 - 可以把多个遮罩组合使用 ## 5. 常见问题解答 ### Q1: 生成的遮罩太粗糙怎么办？ **答：** 减小遮罩半径（mask_radius）的值，同时增加羽化边缘（feather）的值。 ### Q2: 检测不到人体关键点怎么办？ **答：** 降低置信度阈值（confidence_threshold），或者检查输入图像是否包含完整的人体。 ### Q3: 多人场景只检测到一个人怎么办？ **答：** 确保使用的 OpenPose 节点支持多人检测，并检查process_mode是否设置正确。 ### Q4: 遮罩边缘太硬怎么办？ **答：** 增加羽化边缘（feather）的值，让边缘更柔和。 ### Q5: 生成的遮罩尺寸不对怎么办？ **答：** 检查宽度（width）和高度（height）参数是否与原图尺寸匹配。 ## 6. 高级应用技巧 ### 6.1 遮罩组合技术 你可以使用多个节点生成不同部位的遮罩，然后通过遮罩运算节点进行组合，创造出更复杂的效果。 ### 6.2 动态遮罩调整 在处理视频或动画时，可以配合平滑处理功能，让遮罩在帧与帧之间更加稳定。 ### 6.3 创意应用 - 制作人物轮廓特效 - 实现选择性图像处理 - 创建人体姿势模板 - 制作舞蹈动作分析 这个插件就像给你的 ComfyUI 增加了一双能够精确识别人体的"眼睛"，让你能够更精确地控制图像处理的区域，创造出更加专业和有趣的效果。记住，多多练习和实验是掌握这个工具的最好方法！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
