comfyui-reactor-node 一文看懂把 AI 换脸做成 ComfyUI 节点的开源指南【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-nodecomfyui-reactor-node 是一个用 Python 写的 ComfyUI 扩展包它把 ReActor 换脸引擎拆成了一组图形化节点让你不用写代码在画布里连线就能完成人脸检测、批量替换、修复和遮罩精修。对做图、做视频的工作流来说它是把换脸嵌进批量生产流程的实用工具。它解决了什么问题先想象一个场景你用 ComfyUI 批量生成了 200 张图或者准备做一段 AI 视频结果发现角色脸不对或者想统一换成某张参考脸。这时候你面临两个选择要么逐张截图、丢到别的换脸工具里手工处理要么离开 ComfyUI把工作流拆成两半。前者慢到无法接受后者让流程变脆——任何一环输出格式变了下游就断。comfyui-reactor-node 走的是第三条路既然 ComfyUI 的哲学是一切皆节点那换脸也应该是一个节点。它把成熟换脸项目 ReActor 的核心能力移植过来做成可以直接拖进工作流的节点出图节点后面接上它换脸后的图继续往下游走。你留在原来的工作流里什么都不用搬。能力全景它能做什么打开它的节点列表共 14 个节点在菜单ReActor里能找到可以归成四类能力。换脸本体主节点ReActorFaceSwap接一张目标图和一张源脸图自动检测双方人脸并一一替换多人脸场景下可以指定替换顺序比如按人脸从大到小匹配。它默认用 Inswapper 模型也支持 ReSwapper 系列模型——后者还在快速演进是社区探索 Inswapper 替代品的主要方向。对开发者来说这意味着换脸质量上限不锁死在单一模型上模型生态扩展时它可以直接受益。人脸资产化一组Save / Load / Build / Make Batch节点可以把人脸变成可复用的.safetensors模型文件一张脸存成一个文件需要时随时加载更特别的是可以把多张人脸图混合blend成一个新的人脸模型。这对同一角色多镜头保持一致的视频工作流几乎是刚需——人脸 embedding 存下来一次后面几百帧都引用它。细节修复与增强RestoreFace节点独立提供人脸修复支持 GFPGAN、CodeFormer、GPEN512/1024/2048等模型可以调修复强度visibility和相似度权重fidelity换脸后脸糊了可以单独补一刀FaceBoost的思路更讲究先把换下来的脸按修复模型支持的分辨率修好、放大再贴回目标图专门改善脸太小、细节丢失的问题MaskHelper结合 YOLO 人脸检测和 Segment Anything 分割输出精细的人脸遮罩让你只改脸、不动发型和背景边缘。工作流配套ImageDublicator把一张图复制成列表喂给 VAE 编码器做活体头像这类视频常用Unload ReActor Models在复杂工作流里手动释放显存ImageRGBA2RGB处理个别节点不接受带透明通道图片的报错。这类小节点看着不起眼却是工作流能真正跑通的润滑剂。它是怎么搭起来的技术栈全是 Python 生态的熟面孔但分工值得看一眼依赖库负责什么为什么值得注意insightface人脸检测、对齐、embedding 提取整个换脸流程的眼睛换谁、换到哪都由它判断onnxruntime模型推理含 GPU 加速支持 CUDA、ROCm、CoreML 等多种执行后端换硬件不用改代码opencv-python / numpy图像读写与数值运算图像处理的底座几乎每个 CV 项目都会用到segment_anything人脸精细分割MaskHelper 节点生成高精度遮罩的来源ultralyticsYOLO 系列检测模型提供人脸框bbox检测能力albumentations图像变换数据增强与预处理代码组织上目录名基本就暴露了职责边界comfyui-reactor-node/ ├── __init__.py # 入口向 ComfyUI 注册节点 ├── nodes.py # 全部 14 个节点的定义核心文件 ├── scripts/ # 换脸、遮罩、FaceBoost 等业务逻辑 ├── r_basicsr/ # 超分与人脸修复算法BSRGAN 系 ├── r_facelib/ # 人脸检测与对齐工具 └── r_chainner/ # 修复模型加载相关r_ 前缀的几个目录其实是把上游项目的代码内嵌进来方便离线使用。给新手的阅读路径建议先看入口文件init.py 里那几行节点注册再打开nodes.py翻到文件底部的NODE_CLASS_MAPPINGS字典——14 个节点和它们的类一一对应等于一张目录索引顺着类名往上找实现即可。扩展空间可以往哪深入如果你想接入新的换脸模型可以照着 ReSwapper 的集成方式动手模型文件放进指定目录、在模型列表里注册、对齐输入输出格式即可。切入点在nodes.py的模型加载逻辑难度中等是贡献 PR 最容易上手的一类。如果你想提升低质量人脸的检出率可以在r_facelib/detection/下已有的 RetinaFace、YOLOv5Face 两套检测实现上做对比实验或调整检测阈值策略。偏算法调参不需要改主流程。如果你想扩展修复模型参考 GPEN 1024/2048 的接入路径把新的 CodeFormer 变体或社区修复模型挂进RestoreFace节点的选项列表。主要是模型文件管理 架构注册难度中等。如果你想榨干显存可以研究ReactorUnload节点的卸载时机或参考入口文件里那套导入后清理 sys.modules的隔离思路让 ReActor 与其他大型扩展共存时不吃满内存。偏工程优化适合已经跑过复杂工作流的人。如果你想做更高清的换脸scripts/r_faceboost/的先修后贴策略是个很好的研究起点可以试着自己实现不同分辨率下的贴回融合算法。有难度但产出效果最直观。小结这个仓库适合两类人想在 ComfyUI 里做角色换脸、AI 视频的普通用户以及想借一个结构清晰的开源扩展学习CV 模型如何封装成节点的开发者。克隆下来跑一次主节点你花不了半小时而顺着那 14 个节点把源码读一遍你会对 ComfyUI 扩展的整个套路有个相当完整的认识。【免费下载链接】comfyui-reactor-nodeFast and Simple Face Swap Extension Node for ComfyUI项目地址: https://gitcode.com/gh_mirrors/co/comfyui-reactor-node创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
