%20(1).png)
ComfyUI-MakeFrame 插件完整保姆级教程
1. 插件简介
ComfyUI-MakeFrame 是一个专门处理动画和视频帧的插件，它能够将任何动画文件分解成单独的帧，还能进行场景检测、创建帧网格、以及将网格重新拆分成单独图片。
插件原地址： https://github.com/LonicaMewinsky/ComfyUI-MakeFrame
这个插件就像一个"视频大师工具箱"，可以帮你： - 把动画或视频拆成一张张图片（就像把一本漫画书拆成单页） - 找出视频中最重要的关键帧（就像挑出最精彩的瞬间） - 把多张图片排列成一个大网格（就像制作照片拼贴画） - 再把网格拆回单独的图片（就像把拼贴画重新分开）
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI
- 点击右侧的"Manager"按钮
- 在搜索框输入"MakeFrame"
- 找到插件后点击"Install"
- 重启 ComfyUI
方法二：手动安装
- 下载插件文件到 ComfyUI 的
custom_nodes文件夹 - 重启 ComfyUI
- 在节点菜单中找到 MakeFrame 相关节点
3. 节点详细解析
3.1 MakeFrame 节点 - 视频分解器
这个节点就像一个"视频切片机"，能把完整的动画或视频文件切成一张张静态图片。就像把一部电影变成无数张剧照。
3.1.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 动画文件路径 | animation_path | 文件路径 | 你的视频文件路径 | 告诉软件要处理哪个视频文件 | 输入视频文件的完整路径 | 比如：C:\Videos\my_video.mp4 |
| 输出帧数 | max_frames | 数字 | 100-300 | 最多要提取多少张图片 | 限制输出帧的最大数量 | 如果设置100，最多得到100张图片 |
| 跳帧间隔 | frame_skip | 数字 | 1-10 | 每隔几帧取一张图 | 控制采样间隔 | 设置2表示每2帧取1帧 |
| 图片质量 | image_quality | 0.1-1.0 | 0.8-1.0 | 输出图片的清晰度 | 图像压缩质量 | 1.0最清晰，0.1最模糊 |
3.2 SceneDetection 节点 - 场景检测器
这个节点就像一个"电影剪辑师"，能自动找出视频中的重要场景变化点，挑出最有代表性的关键帧。
3.2.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | input_images | 图片列表 | 从MakeFrame输出 | 要分析的图片堆 | 输入图像序列 | 连接MakeFrame节点的输出 |
| 检测敏感度 | threshold | 0.1-1.0 | 0.3-0.5 | 多敏感地发现场景变化 | 场景变化检测阈值 | 0.3较敏感，0.8不太敏感 |
| 返回帧数 | top_n | 数字 | 5-20 | 要保留多少个最重要的帧 | 返回排名前N的关键帧 | 设置10会给你最重要的10张图 |
| 排序方式 | sort_method | 字符串 | "confidence" | 按什么标准排序 | 排序算法选择 | "confidence"按重要度排序 |
3.3 MakeGrid 节点 - 图片拼接器
这个节点就像一个"照片拼贴机"，能把多张图片整齐地排列成一个大网格，就像制作海报或者图片合集。
3.3.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | input_images | 图片列表 | 任意图片组 | 要拼接的图片们 | 输入图像数组 | 可以是任何图片集合 |
| 行数 | rows | 数字 | 2-8 | 网格有几行 | 网格行数 | 设置3表示3行图片 |
| 列数 | columns | 数字 | 2-8 | 网格有几列 | 网格列数 | 设置4表示4列图片 |
| 图片间距 | spacing | 数字 | 0-20 | 图片之间的空隙大小 | 图像间距离像素 | 10表示图片间隔10像素 |
| 自动调整 | auto_resize | 布尔值 | True | 是否自动调整图片大小 | 自适应尺寸调整 | True会让所有图片大小一致 |
| 填充模式 | padding_mode | 字符串 | "repeat" | 空位置怎么填充 | 空白区域填充方式 | "repeat"用最后一张图重复填充 |
3.4 BreakGrid 节点 - 网格拆分器
这个节点就像一个"拼图拆解器"，能把之前拼接好的大网格重新拆分成单独的图片。
3.4.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入网格 | input_grid | 图片 | 拼接好的网格图 | 要拆分的大图 | 输入的网格图像 | 通常来自MakeGrid节点 |
| 行数 | rows | 数字 | 与MakeGrid一致 | 原网格有几行 | 网格行数信息 | 必须与制作时的行数一致 |
| 列数 | columns | 数字 | 与MakeGrid一致 | 原网格有几列 | 网格列数信息 | 必须与制作时的列数一致 |
| 移除填充 | remove_padding | 布尔值 | True | 是否去掉空白填充 | 移除填充区域 | True会自动去除重复填充的部分 |
4. 使用技巧和建议
4.1 工作流程建议
- 先分解再筛选：用MakeFrame把视频拆成帧，再用SceneDetection找重要帧
- 合理设置参数：frame_skip不要设置太小，否则相邻帧差别不大
- 网格制作技巧：MakeGrid的rows和columns要记住，BreakGrid时要用相同数值
4.2 性能优化建议
- 长视频建议增大frame_skip跳帧间隔
- 大量图片制作网格时，建议先调整图片大小
- 场景检测的threshold从0.3开始测试
4.3 常见用途
- 视频摘要：把长视频变成关键帧合集
- 动画分析：研究动画的关键动作
- 批量处理：把多个视频的关键帧整理成网格
5. 常见问题解答
Q1: 为什么MakeFrame节点无法识别我的视频文件？
A: 确保视频格式被OpenCV支持，常见格式如MP4、AVI、MOV都可以。检查文件路径是否正确。
Q2: SceneDetection总是返回太多或太少的帧？
A: 调整threshold参数。如果返回太多帧，增大threshold值；如果太少，减小threshold值。
Q3: MakeGrid制作的网格图片模糊？
A: 检查auto_resize设置，确保输入图片尺寸不要相差太大。
Q4: BreakGrid拆分出来的图片不对？
A: 确保rows和columns参数与制作网格时完全一致。
Q5: 处理大视频时软件卡死？
A: 增大frame_skip跳帧间隔，或减少max_frames最大帧数。
6. 高级应用场景
6.1 动画制作辅助
可以把参考动画分解成关键帧，用于学习动画制作技巧。
6.2 视频内容分析
快速了解视频主要内容，制作视频预览图。
6.3 批量图片处理
配合其他节点，对提取的帧进行AI处理，如风格转换、超分辨率等。
6.4 数据集制作
从视频中提取高质量图片，用于训练AI模型。
这个插件非常适合需要处理视频和动画素材的创作者。通过合理组合这些节点，你可以轻松实现复杂的视频帧处理任务。记住，多实践多尝试，每个参数都有其独特的作用！