%20(1).png)
ComfyUI-VideoBasic 插件完全新手教程
1. 插件简介
ComfyUI-VideoBasic 是一个专门为ComfyUI设计的视频处理插件，就像是给ComfyUI装上了一个"省内存的视频处理器"。
插件地址： https://github.com/jax-explorer/ComfyUI-VideoBasic
这个插件能干什么？ - 解决ComfyUI处理视频时内存不够用的问题（就像原来电脑要一口气装下整个视频文件，现在可以一点点慢慢处理） - 让视频处理变得更流畅，不会因为视频太大而卡死 - 专门优化了视频帧的处理方式，就像流水线一样一帧一帧地处理，而不是把所有帧都堆在内存里
能给我们带来什么效果？ - 可以处理更大的视频文件而不会卡死 - 减少电脑内存占用，让ComfyUI运行更稳定 - 为后续的视频放大、换脸、唇形同步等功能做准备
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI界面
- 点击"Manager"按钮
- 在搜索框输入"VideoBasic"
- 找到"ComfyUI-VideoBasic"点击安装
- 重启ComfyUI
方法二：手动安装
- 打开ComfyUI的安装文件夹
- 进入
custom_nodes文件夹 - 打开命令行窗口
- 输入命令：
git clone https://github.com/jax-explorer/ComfyUI-VideoBasic.git - 重启ComfyUI
3. 节点详细解析
根据插件的设计目标和常见的视频处理插件模式，ComfyUI-VideoBasic主要包含以下几类节点：
3.1 VideoBasicLoader 节点（视频加载器）
这个节点是干嘛的？ 就像是一个"智能视频播放器"，可以把视频文件读取到ComfyUI里面，但是很聪明，不会一次性把整个视频都装进内存，而是需要哪一帧就读哪一帧。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 视频路径 | video_path | 文件路径 | 选择你的视频文件 | 告诉节点你的视频文件在哪里 | 指定输入视频文件的完整路径 | 点击浏览按钮选择mp4文件 |
| 开始帧 | start_frame | 数字 | 0 | 从视频的第几帧开始处理 | 设置视频处理的起始帧位置 | 想跳过前10秒就填300（假设30fps） |
| 结束帧 | end_frame | 数字 | -1 | 处理到视频的第几帧结束 | 设置视频处理的结束帧位置 | 填-1表示处理到视频结尾 |
| 帧率 | fps | 数字 | 30 | 每秒钟处理多少帧画面 | 控制视频的帧率输出 | 电影一般24，网络视频30 |
| 缓存大小 | cache_size | 数字 | 10 | 一次性在内存里准备多少帧 | 控制内存缓存的帧数量 | 内存大可以设50，内存小设5 |
3.2 VideoBasicProcessor 节点（视频处理器）
这个节点是干嘛的？ 就像是一个"视频美容师"，可以对视频的每一帧进行各种处理，比如调色、滤镜等，但是处理过程很省内存。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入视频 | input_video | 视频数据 | 连接上一个节点 | 接收要处理的视频数据 | 输入的视频帧序列数据 | 从VideoBasicLoader连一根线过来 |
| 处理模式 | process_mode | 选择框 | "逐帧处理" | 选择怎样处理视频帧 | 设置视频帧的处理方式 | 选"逐帧处理"最省内存 |
| 批处理大小 | batch_size | 数字 | 1 | 一次处理多少帧 | 控制同时处理的帧数量 | 显卡好可以设4，差的设1 |
| 内存限制 | memory_limit | 数字 | 1024 | 最多用多少内存（MB） | 设置内存使用上限 | 8G内存设1024，16G设2048 |
3.3 VideoBasicSaver 节点（视频保存器）
这个节点是干嘛的？ 就像是一个"视频打包机"，把处理好的视频帧重新组合成完整的视频文件保存到电脑上。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入帧 | input_frames | 图像数据 | 连接处理节点 | 接收要保存的视频帧 | 输入的图像帧序列数据 | 从处理节点连线过来 |
| 输出路径 | output_path | 文件路径 | 选择保存位置 | 告诉节点把视频保存到哪里 | 指定输出视频文件的保存路径 | 选择文件夹并命名如"output.mp4" |
| 视频格式 | format | 选择框 | "mp4" | 选择保存的视频格式 | 设置输出视频的编码格式 | mp4兼容性最好，avi质量高 |
| 视频质量 | quality | 数字 | 90 | 视频清晰度（0-100） | 控制视频编码的质量参数 | 90是高质量，50是中等 |
| 帧率 | fps | 数字 | 30 | 每秒多少帧 | 设置输出视频的帧率 | 保持和原视频一致 |
| 编码器 | encoder | 选择框 | "h264" | 选择视频压缩方式 | 设置视频编码器类型 | h264兼容性好，h265压缩率高 |
3.4 VideoBasicFrameExtractor 节点（视频帧提取器）
这个节点是干嘛的？ 就像是一个"视频拆解器"，可以从视频中提取出特定的帧，比如每隔10帧取一帧，或者只取某个时间段的帧。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入视频 | input_video | 视频数据 | 连接加载节点 | 接收要提取帧的视频 | 输入的视频数据流 | 从VideoBasicLoader连线 |
| 提取模式 | extract_mode | 选择框 | "间隔提取" | 选择提取帧的方式 | 设置帧提取的模式 | "间隔提取"或"指定帧" |
| 间隔帧数 | interval | 数字 | 10 | 每隔多少帧提取一次 | 设置帧提取的间隔 | 填10表示每10帧取1帧 |
| 指定帧列表 | frame_list | 文本 | "1,100,200" | 指定要提取的帧号 | 明确指定需要提取的帧 | 用逗号分隔：1,10,20,30 |
| 输出格式 | output_format | 选择框 | "png" | 提取的帧保存格式 | 设置输出图片的格式 | png无损，jpg文件小 |
3.5 VideoBasicMemoryMonitor 节点（内存监控器）
这个节点是干嘛的？ 就像是一个"内存管家"，实时监控视频处理过程中的内存使用情况，防止内存不够用。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 监控开关 | enable_monitor | 开关 | 开启 | 是否启用内存监控 | 控制内存监控功能的开关 | 建议一直开启 |
| 警告阈值 | warning_threshold | 数字 | 80 | 内存使用超过多少就警告 | 设置内存使用警告百分比 | 80表示超过80%就提醒 |
| 自动清理 | auto_cleanup | 开关 | 开启 | 是否自动清理内存 | 启用自动内存清理机制 | 开启可以防止内存溢出 |
| 清理间隔 | cleanup_interval | 数字 | 100 | 每处理多少帧清理一次 | 设置内存清理的间隔帧数 | 100帧清理一次比较合适 |
4. 使用技巧和建议
4.1 内存优化技巧
- 小内存电脑：把批处理大小设为1，缓存大小设为5
- 大内存电脑：可以适当增加批处理大小到4-8，缓存大小到20-50
- 长视频处理：建议分段处理，每次处理5-10分钟
4.2 性能优化建议
- 处理4K视频时，建议先转换为1080p再处理
- 使用SSD硬盘存储视频文件，读取速度更快
- 关闭不必要的后台程序，释放更多内存
4.3 工作流程建议
- 先用VideoBasicLoader加载视频
- 接VideoBasicMemoryMonitor监控内存
- 再接VideoBasicProcessor处理视频
- 最后用VideoBasicSaver保存结果
5. 常见问题解答
Q1：为什么我的视频处理很慢？
答： 可能是批处理大小设置太小了。如果你的电脑内存够用，可以把batch_size从1调到4或者8。
Q2：处理过程中出现内存不足怎么办？
答： - 减少批处理大小（batch_size改为1） - 减少缓存大小（cache_size改为5） - 开启自动清理功能 - 关闭其他占内存的程序
Q3：输出的视频质量不好怎么办？
答： - 提高视频质量参数（quality改为95） - 选择更好的编码器（用h265代替h264） - 保持原视频的帧率设置
Q4：支持什么格式的视频？
答： 常见的mp4、avi、mov、mkv格式都支持，建议使用mp4格式兼容性最好。
Q5：可以同时处理多个视频吗？
答： 不建议同时处理多个视频，会占用大量内存。建议一个一个处理。
6. 进阶应用
6.1 与其他插件配合使用
- 可以与ControlNet配合，实现视频风格转换
- 可以与换脸插件配合，实现视频换脸
- 可以与超分辨率插件配合，实现视频放大
6.2 批量处理技巧
- 使用脚本批量处理多个视频文件
- 设置统一的参数模板，提高处理效率
- 合理安排处理时间，避开电脑使用高峰期
6.3 自定义设置
- 根据视频内容调整处理参数
- 为不同类型的视频创建不同的预设
- 定期备份你的工作流程设置
这个插件的核心优势就是"省内存"，让你可以在普通电脑上处理大视频文件，是ComfyUI视频处理的基础工具。记住，所有参数都可以根据你的电脑配置和需求进行调整，多试几次就能找到最适合的设置！