ComfyUI-H3-FaceRefine：自定义节点集

核心信息

以下信息由程序从官方接口读取，不经模型改写。

仓库地址: https://github.com/Carasibana/ComfyUI-H3-FaceRefine
许可证: MIT
语言: Python
维护方: Carasibana
核验日期: 2026-11-01

它是什么

ComfyUI-H3-FaceRefine 是一组 ComfyUI 自定义节点，用于优化并提升 MiniMax H3 视频中小脸的质量。项目称，当头部只占画面一小部分时，MiniMax H3 生成的人脸效果较差。项目采用 MIT 许可。

主要能力

H3 Face Track + Crop 逐帧检测人脸，在检测失败处填补空缺，并平滑轨迹。
H3 Load Video + Face Select 在一次处理中加载视频，并找出每张人脸和每个硬切镜头。
H3 Face Stitch Back 把每个优化后的裁剪图扭回其来源的精确浮点框。
H3 Face Mask (SAM) 生成贴合脸形的粘贴蒙版，而不是矩形，并做了时间平滑。
H3 Per-Frame Denoise 通过潜变量的噪声蒙版，沿时间轴改变去噪强度。
在 H3 Face Track + Crop 中，select 可取 largest_face、smallest_face、left_most、right_most、top_most、bottom_most、centre_most、closest_to_xy 和 detector_score。

怎么上手

重启 ComfyUI 后，节点出现在 MiniMax H3/Face Refine 下。
Python 包 ultralytics、scipy、insightface 和 scenedetect 会自动安装。
项目包含两个示例工作流，均在图内带有注释。
H3 Face Refine Auto Select 示例工作流用排序规则选择要优化的脸，出厂设置为 largest_face。
H3 Face Refine Manual Select 示例工作流由用户在每个镜头中选择一张脸。

摘自 README · bash

git clone https://github.com/Carasibana/ComfyUI-H3-FaceRefine.git

适合谁

示例工作流中的口型同步路径依赖 MiniMaxH3NativeAudioLock。MiniMaxH3NativeAudioLock 不随本项目重新分发，因此需要自行安装。H3 Face Mask (SAM) 需要 Impact Pack 提供 SAMLoader。

PySceneDetect 缺失或导入失败时，运行不会停止。环境变量 H3_FACEREFINE_STRICT_PATHS 设为非空值时，只读取 ComfyUI 自身文件夹内的路径，其余路径会被拒绝并给出提示。H3 Face Stitch Back 的 undetected_frames 中，fade_out 在空缺处将合成渐隐至零，skip 硬切回原始像素，composite_anyway 则有 H3 在后脑勺上幻生出人脸的风险。

H3 Face Stitch Back 的 paste_region 中，full_crop 也会粘贴头发、肩部和背景，并有出现可见矩形的风险。H3 Per-Frame Denoise 的 face_px_small 是以源像素计的人脸高度，在此高度或更低时应用完整的 denoise_multiplier_small_face。H3 Per-Frame Denoise 的 face_px_large 是以源像素计的人脸高度，在此高度或更高时应用 denoise_multiplier_large_face。

本站已收录的相关工具。