ComfyUI视频制作插件VideoHelperSuite使用教程

【版权严正声明】
本文系作者 [编程界的小学生] 原创，并拥有完整、独立的著作权。
未经本人书面授权，任何单位、平台或个人，严禁以任何形式（包括但不限于转载、复制、摘编、修改、链接、转贴、建立镜像等）使用本文的全部或部分内容。
任何无视本声明的侵权行为，本人将依据《中华人民共和国著作权法》等相关法律法规，采取一切必要的法律手段，追究其侵权责任，要求其立即停止侵权、赔礼道歉、消除影响，并赔偿因此造成的一切经济损失及维权成本（包括但不限于律师费、诉讼费、公证费等）。
侵权必究，切勿以身试法！

插件简介

ComfyUI-VideoHelperSuite 是一个专门处理视频和图像序列的强大插件包。

插件地址： https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite

主要功能：

加载和处理视频文件（支持 MP4、WebM、MKV、GIF、MOV 格式）
批量处理图像序列
视频合成和导出
音频处理和同步
高级批处理管理
图像和潜在空间操作

这个插件就像一个专业的视频工作室，能帮你把一堆图片变成视频，或者把视频拆成图片，还能加上音乐，非常适合制作动画和视频内容。

如何安装

方法一：通过 ComfyUI Manager 安装（推荐）

打开 ComfyUI Manager
搜索 "VideoHelperSuite"
点击安装
重启 ComfyUI

方法二：手动安装

进入 ComfyUI 的 custom_nodes 文件夹
运行命令：git clone https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite.git
进入插件文件夹：cd ComfyUI-VideoHelperSuite
安装依赖：pip install -r requirements.txt
重启 ComfyUI

节点详细解析

插件总节点数：40个 本次已分析：40个 剩余未分析：0个

3.1 Video Combine 节点 - 视频合成器

这个节点就像一个视频制作机，把一堆图片打包成视频文件。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像序列	images	IMAGE类型	-	要合成视频的图片们	输入的图像张量序列	连接生成图片的节点输出
帧率	frame_rate	1-60	8	视频播放速度，数字越大越快	每秒显示的帧数	8表示每秒8张图，24是电影标准
循环次数	loop_count	0-100	0	视频重复播放次数，0表示无限循环	GIF循环播放次数设置	设为3表示播放3次后停止
文件名前缀	filename_prefix	字符串	"AnimateDiff"	保存文件的名字开头	输出文件的命名前缀	写"我的动画"会生成"我的动画_00001.mp4"
输出格式	format	多种格式	"image/gif"	要保存成什么格式的文件	输出视频的编码格式	gif适合动图，mp4适合视频
乒乓效果	pingpong	true/false	false	播放到最后一帧后倒着播放回去	正向播放后反向播放形成循环	开启后像钟摆一样来回播放
保存输出	save_output	true/false	true	是否把文件保存到硬盘	控制是否将结果保存到输出目录	关闭只预览不保存文件
音频	audio	AUDIO类型	可选	要添加到视频的声音	音频轨道数据	连接音频加载节点
批处理管理器	meta_batch	VHS_BatchManager	可选	批量处理的控制器	用于大批量处理的管理器	处理大量图片时使用
VAE编码器	vae	VAE类型	可选	图像编码解码器	变分自编码器用于潜在空间转换	连接VAE节点处理潜在空间

3.2 Load Video (Upload) 节点 - 视频上传加载器

这个节点像一个视频播放器，能把你上传的视频文件读取成图片序列。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
视频文件	video	文件列表	-	选择要处理的视频文件	从上传目录选择视频文件	选择你上传的mp4或gif文件
强制帧率	force_rate	0-60	0	重新设定视频播放速度，0表示保持原速	覆盖原视频帧率	设为24会强制改成24fps
自定义宽度	custom_width	0-8192	0	改变视频宽度，0表示保持原尺寸	输出图像的像素宽度	设为512会把宽度改成512像素
自定义高度	custom_height	0-8192	0	改变视频高度，0表示保持原尺寸	输出图像的像素高度	设为512会把高度改成512像素
帧数限制	frame_load_cap	0+	0	最多读取多少帧，0表示全部读取	限制加载的最大帧数	设为100只读取前100帧
跳过开头帧数	skip_first_frames	0+	0	从第几帧开始读取	跳过视频开头的帧数	设为30从第30帧开始
每隔几帧取一帧	select_every_nth	1+	1	抽帧间隔，1表示每帧都要	帧采样间隔	设为2表示每隔一帧取一帧
批处理管理器	meta_batch	VHS_BatchManager	可选	批量处理控制器	大批量处理管理	处理多个视频时使用
VAE编码器	vae	VAE类型	可选	图像编码器	潜在空间编码器	连接VAE进行编码
格式预设	format	预设列表	"AnimateDiff"	针对特定模型的预设参数	预定义的格式配置	选择对应的AI模型预设

3.3 Load Video (Path) 节点 - 视频路径加载器

这个节点像一个文件浏览器，能直接从电脑路径读取视频文件。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
视频路径	video	字符串路径	-	视频文件在电脑上的完整路径	视频文件的绝对路径	输入"C:/videos/my_video.mp4"
强制帧率	force_rate	0-60	0	重新设定播放速度	覆盖原视频帧率	0保持原速，24改成电影帧率
自定义宽度	custom_width	0-8192	0	改变输出图片宽度	输出图像宽度像素	512表示宽度512像素
自定义高度	custom_height	0-8192	0	改变输出图片高度	输出图像高度像素	512表示高度512像素
帧数限制	frame_load_cap	0+	0	最多读几帧图片	限制加载帧数	100表示只要前100帧
跳过开头帧数	skip_first_frames	0+	0	从第几帧开始	跳过开头帧数	30表示从第30帧开始
每隔几帧取一帧	select_every_nth	1+	1	抽帧间隔	帧采样间隔	2表示每隔一帧取一帧
批处理管理器	meta_batch	VHS_BatchManager	可选	批处理控制	批量处理管理器	大量处理时使用
VAE编码器	vae	VAE类型	可选	图像编码器	变分自编码器	连接VAE节点
格式预设	format	预设列表	"AnimateDiff"	模型预设	预定义格式配置	根据AI模型选择

3.4 Load Video FFmpeg (Upload) 节点 - FFmpeg视频上传加载器

这个节点像一个专业的视频解码器，使用FFmpeg技术处理更多格式的视频。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
视频文件	video	文件列表	-	选择上传的视频文件	从上传目录选择视频	选择mp4、webm等格式文件
强制帧率	force_rate	0-60	0	重设播放速度	覆盖原帧率	24设为电影标准帧率
自定义宽度	custom_width	0-8192	0	改变图片宽度	输出宽度像素	1920表示全高清宽度
自定义高度	custom_height	0-8192	0	改变图片高度	输出高度像素	1080表示全高清高度
帧数限制	frame_load_cap	0+	0	最多处理帧数	限制处理帧数	200表示只处理前200帧
开始时间	start_time	0+	0	从视频第几秒开始	视频开始时间点(秒)	10表示从第10秒开始
批处理管理器	meta_batch	VHS_BatchManager	可选	批处理控制	批量处理管理	大批量时使用
VAE编码器	vae	VAE类型	可选	图像编码器	潜在空间编码	连接VAE处理
格式预设	format	预设列表	"AnimateDiff"	模型预设	格式预设配置	选择对应模型

3.5 Load Video FFmpeg (Path) 节点 - FFmpeg视频路径加载器

这个节点结合了路径加载和FFmpeg解码的优势，能处理更多格式和更精确的时间控制。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
视频路径	video	字符串路径	-	视频文件完整路径	视频文件绝对路径	"D:/videos/sample.mkv"
强制帧率	force_rate	0-60	0	重设播放速度	覆盖原帧率	30表示30fps
自定义宽度	custom_width	0-8192	0	输出图片宽度	像素宽度	720表示720p宽度
自定义高度	custom_height	0-8192	0	输出图片高度	像素高度	480表示720p高度
帧数限制	frame_load_cap	0+	0	处理帧数上限	最大处理帧数	500表示最多500帧
开始时间	start_time	0+	0	从第几秒开始处理	视频起始时间(秒)	5.5表示从5.5秒开始
批处理管理器	meta_batch	VHS_BatchManager	可选	批处理管理	批量处理控制器	处理多文件时用
VAE编码器	vae	VAE类型	可选	图像编码器	变分自编码器	连接VAE节点
格式预设	format	预设列表	"AnimateDiff"	模型预设	预定义配置	根据模型选择

3.6 Load Image (Path) 节点 - 图像路径加载器

这个节点像一个图片查看器，能从路径加载单张图片并进行处理。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图片路径	image	字符串路径	-	图片文件在电脑上的位置	图像文件绝对路径	"C:/images/photo.png"
自定义宽度	custom_width	0-8192	0	改变图片宽度	输出图像宽度	512表示宽度512像素
自定义高度	custom_height	0-8192	0	改变图片高度	输出图像高度	512表示高度512像素
VAE编码器	vae	VAE类型	可选	图像编码器	潜在空间编码器	连接VAE进行编码

3.7 Load Images (Upload) 节点 - 图像序列上传加载器

这个节点像一个相册管理器，能批量加载上传文件夹中的所有图片。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
文件夹	directory	文件夹列表	-	选择包含图片的文件夹	图像序列目录	选择上传的图片文件夹
图片数量限制	image_load_cap	0+	0	最多加载多少张图片	限制加载图片数量	100表示最多100张
跳过开头图片	skip_first_images	0+	0	从第几张图片开始	跳过开头图片数量	10表示跳过前10张
每隔几张取一张	select_every_nth	1+	1	抽取图片的间隔	图片采样间隔	2表示每隔一张取一张
批处理管理器	meta_batch	VHS_BatchManager	可选	批处理控制	批量处理管理器	大量图片时使用

3.8 Load Images (Path) 节点 - 图像序列路径加载器

这个节点能从指定路径批量加载图片序列，适合处理本地图片文件夹。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
文件夹路径	directory	字符串路径	-	图片文件夹的完整路径	图像序列目录路径	"D:/my_images/"
图片数量限制	image_load_cap	0+	0	最多处理图片数	限制加载数量	50表示最多50张
跳过开头图片	skip_first_images	0+	0	从第几张开始	跳过开头数量	5表示跳过前5张
每隔几张取一张	select_every_nth	1+	1	取图片间隔	采样间隔	3表示每3张取1张
批处理管理器	meta_batch	VHS_BatchManager	可选	批处理管理	批量处理控制	大批量时使用

3.9 Load Audio (Path) 节点 - 音频路径加载器

这个节点像一个音乐播放器，能从路径加载音频文件。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
音频文件路径	audio_file	字符串路径	-	音频文件在电脑上的位置	音频文件绝对路径	"C:/music/bgm.mp3"
开始时间	seek_seconds	0+	0	从第几秒开始播放	音频起始时间点	30表示从30秒开始
持续时间	duration	0+	0	播放多长时间，0表示到结尾	音频持续时长	60表示播放60秒

3.10 Load Audio (Upload) 节点 - 音频上传加载器

这个节点能加载上传的音频文件，支持多种音频格式。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
音频文件	audio	文件列表	-	选择上传的音频文件	从上传目录选择音频	选择mp3、wav等格式
开始时间	start_time	0+	0	从第几秒开始	音频起始时间	15表示从15秒开始
持续时间	duration	0+	0	使用多长时间的音频	音频使用时长	120表示使用120秒

3.11 Audio to VHS Audio 节点 - 音频格式转换器

这个节点像一个音频格式转换器，把新版音频格式转换成旧版格式，主要用于兼容老版本。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
音频数据	audio	AUDIO类型	-	要转换的音频数据	标准音频格式输入	连接音频加载节点

3.12 VHS Audio to Audio 节点 - 旧版音频转换器

这个节点把旧版VHS音频格式转换成新版标准格式，用于升级兼容。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
VHS音频	vhs_audio	VHS_AUDIO类型	-	旧版音频数据	旧版VHS音频格式	连接旧版音频节点

3.13 Prune Outputs 节点 - 文件清理器

这个节点像一个垃圾清理工具，能删除不需要的中间文件，节省硬盘空间。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
文件名列表	filenames	VHS_FILENAMES类型	-	要处理的文件列表	文件路径列表	连接视频合成节点输出
清理选项	options	选择列表	"Intermediate"	选择要删除的文件类型	清理策略选择	"Intermediate"删除中间文件

3.14 Meta Batch Manager 节点 - 批处理管理器

这个节点像一个工厂流水线管理员，能控制大批量数据的处理流程，避免内存爆炸。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
每批帧数	frames_per_batch	1+	16	每次处理多少帧	批处理大小控制	16表示每次处理16帧

3.15 Video Info 节点 - 视频信息查看器

这个节点像一个视频属性查看器，能显示视频的详细信息，包括原始和加载后的参数。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
视频信息	video_info	VHS_VIDEOINFO类型	-	视频的详细信息数据	视频元数据信息	连接视频加载节点

3.16 Video Info (Source) 节点 - 原始视频信息

这个节点专门显示视频文件的原始信息，不受加载设置影响。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
视频信息	video_info	VHS_VIDEOINFO类型	-	视频信息数据	视频元数据	连接视频加载节点

3.17 Video Info (Loaded) 节点 - 加载后视频信息

这个节点显示经过处理后的视频信息，反映实际加载的参数。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
视频信息	video_info	VHS_VIDEOINFO类型	-	视频信息数据	视频元数据	连接视频加载节点

3.18 Select Filename 节点 - 文件名选择器

这个节点像一个文件挑选器，能从文件列表中选择特定的文件。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
文件名列表	filenames	VHS_FILENAMES类型	-	文件路径列表	文件名数组	连接视频合成节点
索引位置	index	整数	-1	选择第几个文件，-1表示最后一个	数组索引位置	0表示第一个，-1表示最后一个

3.19 VAE Encode Batched 节点 - 批量VAE编码器

这个节点像一个批量图片压缩机，能把大量图片分批编码成潜在空间，避免内存不足。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像像素	pixels	IMAGE类型	-	要编码的图片数据	图像张量数据	连接图片加载节点
VAE编码器	vae	VAE类型	-	图像编码解码器	变分自编码器	连接VAE节点
每批数量	per_batch	1+	16	每次处理多少张图片	批处理大小	16表示每次处理16张

3.20 VAE Decode Batched 节点 - 批量VAE解码器

这个节点像一个批量图片解压机，能把潜在空间数据分批解码成图片。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
潜在样本	samples	LATENT类型	-	要解码的潜在空间数据	潜在空间张量	连接潜在空间节点
VAE解码器	vae	VAE类型	-	图像编码解码器	变分自编码器	连接VAE节点
每批数量	per_batch	1+	16	每次处理多少个样本	批处理大小	16表示每次处理16个

3.21 Split Latents 节点 - 潜在空间分割器

这个节点像一个数据切割机，能把一组潜在空间数据从指定位置切成两部分。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
潜在数据	latents	LATENT类型	-	要分割的潜在空间数据	潜在空间张量	连接潜在空间节点
分割位置	split_index	整数	0	从第几个位置开始分割	分割索引位置	10表示前10个为A组，后面为B组

3.22 Split Images 节点 - 图像分割器

这个节点能把一批图片从指定位置分成两组，方便分别处理。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像数据	images	IMAGE类型	-	要分割的图片组	图像张量数据	连接图片节点
分割位置	split_index	整数	0	从第几张图片开始分割	分割索引位置	5表示前5张为A组，后面为B组

3.23 Split Masks 节点 - 遮罩分割器

这个节点能把一批遮罩从指定位置分成两组。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
遮罩数据	mask	MASK类型	-	要分割的遮罩组	遮罩张量数据	连接遮罩节点
分割位置	split_index	整数	0	从第几个遮罩开始分割	分割索引位置	3表示前3个为A组，后面为B组

3.24 Merge Latents 节点 - 潜在空间合并器

这个节点像一个数据拼接器，能把两组潜在空间数据合并成一组，还能处理尺寸不同的情况。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
潜在数据A	latents_A	LATENT类型	-	第一组潜在空间数据	潜在空间张量A	连接第一个潜在空间节点
潜在数据B	latents_B	LATENT类型	-	第二组潜在空间数据	潜在空间张量B	连接第二个潜在空间节点
合并策略	merge_strategy	选择列表	"match A"	尺寸不同时的处理方式	尺寸匹配策略	"match A"以A的尺寸为准
缩放方法	scale_method	选择列表	"nearest-exact"	改变尺寸时的算法	图像缩放算法	"bilinear"双线性插值
裁剪方式	crop	选择列表	"disabled"	是否裁剪图像	图像裁剪方式	"center"居中裁剪

3.25 Merge Images 节点 - 图像合并器

这个节点能把两组图片合并成一组，自动处理尺寸差异。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像A	images_A	IMAGE类型	-	第一组图片	图像张量A	连接第一个图片节点
图像B	images_B	IMAGE类型	-	第二组图片	图像张量B	连接第二个图片节点
合并策略	merge_strategy	选择列表	"match A"	尺寸不同时的处理方式	尺寸匹配策略	"match smaller"以小尺寸为准
缩放方法	scale_method	选择列表	"nearest-exact"	改变尺寸时的算法	图像缩放算法	"bicubic"三次插值
裁剪方式	crop	选择列表	"disabled"	是否裁剪图像	图像裁剪方式	"center"居中裁剪

3.26 Merge Masks 节点 - 遮罩合并器

这个节点能把两组遮罩合并成一组。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
遮罩A	mask_A	MASK类型	-	第一组遮罩	遮罩张量A	连接第一个遮罩节点
遮罩B	mask_B	MASK类型	-	第二组遮罩	遮罩张量B	连接第二个遮罩节点
合并策略	merge_strategy	选择列表	"match A"	尺寸不同时的处理方式	尺寸匹配策略	"match larger"以大尺寸为准
缩放方法	scale_method	选择列表	"nearest-exact"	改变尺寸时的算法	图像缩放算法	"area"区域插值
裁剪方式	crop	选择列表	"disabled"	是否裁剪图像	图像裁剪方式	"disabled"不裁剪

3.27 Get Latent Count 节点 - 潜在空间计数器

这个节点像一个数量统计器，能告诉你有多少个潜在空间数据。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
潜在数据	latents	LATENT类型	-	要统计的潜在空间数据	潜在空间张量	连接潜在空间节点

3.28 Get Image Count 节点 - 图像计数器

这个节点能统计图片的数量。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像数据	images	IMAGE类型	-	要统计的图片组	图像张量数据	连接图片节点

3.29 Get Mask Count 节点 - 遮罩计数器

这个节点能统计遮罩的数量。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
遮罩数据	mask	MASK类型	-	要统计的遮罩组	遮罩张量数据	连接遮罩节点

3.30 Repeat Latents 节点 - 潜在空间复制器

这个节点像一个复印机，能把潜在空间数据复制多份。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
潜在数据	latents	LATENT类型	-	要复制的潜在空间数据	潜在空间张量	连接潜在空间节点
复制倍数	multiply_by	1+	1	复制多少倍	重复次数	3表示复制3倍，总共4份

3.31 Repeat Images 节点 - 图像复制器

这个节点能把图片复制多份。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像数据	images	IMAGE类型	-	要复制的图片组	图像张量数据	连接图片节点
复制倍数	multiply_by	1+	1	复制多少倍	重复次数	2表示复制2倍，总共3份

3.32 Repeat Masks 节点 - 遮罩复制器

这个节点能把遮罩复制多份。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
遮罩数据	mask	MASK类型	-	要复制的遮罩组	遮罩张量数据	连接遮罩节点
复制倍数	multiply_by	1+	1	复制多少倍	重复次数	4表示复制4倍，总共5份

3.33 Select Every Nth Latent 节点 - 潜在空间抽帧器

这个节点像一个数据筛选器，能按间隔选择潜在空间数据。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
潜在数据	latents	LATENT类型	-	要筛选的潜在空间数据	潜在空间张量	连接潜在空间节点
每隔几个取一个	select_every_nth	1+	1	抽取间隔	采样间隔	2表示每隔一个取一个
跳过开头数量	skip_first_latents	0+	0	从第几个开始	跳过开头数量	5表示跳过前5个

3.34 Select Every Nth Image 节点 - 图像抽帧器

这个节点能按间隔选择图片。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像数据	images	IMAGE类型	-	要筛选的图片组	图像张量数据	连接图片节点
每隔几个取一个	select_every_nth	1+	1	抽取间隔	采样间隔	3表示每隔两个取一个
跳过开头数量	skip_first_images	0+	0	从第几张开始	跳过开头数量	2表示跳过前2张

3.35 Select Every Nth Mask 节点 - 遮罩抽帧器

这个节点能按间隔选择遮罩。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
遮罩数据	mask	MASK类型	-	要筛选的遮罩组	遮罩张量数据	连接遮罩节点
每隔几个取一个	select_every_nth	1+	1	抽取间隔	采样间隔	4表示每隔三个取一个
跳过开头数量	skip_first_masks	0+	0	从第几个开始	跳过开头数量	1表示跳过第1个

3.36 Select Latents 节点 - 潜在空间选择器

这个节点像一个精确挑选器，能用复杂的索引规则选择特定的潜在空间数据。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
潜在数据	latent	LATENT类型	-	要选择的潜在空间数据	潜在空间张量	连接潜在空间节点
索引规则	indexes	字符串	"0"	选择规则，支持复杂语法	索引表达式	"0,2,5"选择第0、2、5个
缺失时报错	err_if_missing	true/false	true	索引不存在时是否报错	错误处理策略	false表示忽略不存在的索引
空结果报错	err_if_empty	true/false	true	没选中任何数据时是否报错	空结果处理	false表示允许空结果

3.37 Select Images 节点 - 图像选择器

这个节点能用复杂规则选择特定的图片。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图像数据	image	IMAGE类型	-	要选择的图片组	图像张量数据	连接图片节点
索引规则	indexes	字符串	"0"	选择规则	索引表达式	"0:5"选择前5张，"::-1"倒序全选
缺失时报错	err_if_missing	true/false	true	索引不存在时是否报错	错误处理策略	true表示严格检查
空结果报错	err_if_empty	true/false	true	没选中任何数据时是否报错	空结果处理	true表示必须有结果

3.38 Select Masks 节点 - 遮罩选择器

这个节点能用复杂规则选择特定的遮罩。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
遮罩数据	mask	MASK类型	-	要选择的遮罩组	遮罩张量数据	连接遮罩节点
索引规则	indexes	字符串	"0"	选择规则	索引表达式	"1,3,5:8"选择第1、3、5到7个
缺失时报错	err_if_missing	true/false	true	索引不存在时是否报错	错误处理策略	false表示容错处理
空结果报错	err_if_empty	true/false	true	没选中任何数据时是否报错	空结果处理	false表示允许空选择

3.39 Unbatch 节点 - 批处理解包器

这个节点像一个包裹拆解器，能把分批的数据重新合并成一个整体。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
批处理数据	batched	任意类型	-	要合并的分批数据	批处理数据输入	连接批处理节点输出

3.40 Select Latest 节点 - 最新文件选择器

这个节点能自动找到最新生成的文件，方便后续处理。

参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
文件名前缀	filename_prefix	字符串	"output/AnimateDiff"	文件名的开头部分	文件路径前缀	"output/my_video"匹配该前缀的文件
文件名后缀	filename_postfix	字符串	".webm"	文件名的结尾部分	文件扩展名	".mp4"匹配mp4格式文件

使用技巧和建议

4.1 视频处理技巧

处理大视频时建议设置帧数限制，避免内存不足
使用自定义尺寸时保持宽高比，避免画面变形
选择合适的帧率，动画用8-12fps，视频用24-30fps

4.2 批处理优化

大量图片处理时使用批处理管理器
合理设置跳帧和抽帧参数，减少处理时间
监控内存使用，避免系统卡顿

4.3 格式选择建议

GIF：适合短动画，文件小但质量有限
MP4：适合长视频，质量好文件相对小
WebM：网页友好，质量和压缩率平衡

4.4 高级功能使用

使用Select系列节点的复杂索引语法，如"0:10:2"表示从0到10每隔2个取一个
利用Merge节点的不同策略处理尺寸不同的数据
结合Repeat节点创建循环动画效果
使用Split和Merge节点实现复杂的数据操作

4.5 性能优化建议

大数据量处理时优先使用Batched版本的节点
合理设置每批处理数量，避免内存溢出
使用Meta Batch Manager统一管理大批量任务
适当使用Prune Outputs清理中间文件，节省硬盘空间

常见问题解答

5.1 视频加载问题

Q：为什么我的视频加载不了？ A：检查视频格式是否支持，确保文件路径正确，尝试使用FFmpeg版本的加载器。

Q：视频太大导致内存不足怎么办？ A：设置帧数限制，或者使用批处理管理器分批处理。

5.2 输出质量问题

Q：生成的视频质量很差？ A：检查输入图片质量，调整输出格式设置，避免过度压缩。

Q：视频播放速度不对？ A：调整帧率设置，确保与原始素材匹配。

5.3 音频同步问题

Q：音频和视频不同步？ A：检查音频长度和视频长度是否匹配，调整音频的开始时间和持续时间。

5.4 数据处理问题

Q：使用Select节点时索引语法错误？ A：检查索引范围是否超出数据范围，注意负数索引的使用方法。

Q：Merge节点合并后尺寸不对？ A：检查merge_strategy设置，选择合适的缩放方法和裁剪方式。

Q：批处理节点处理速度很慢？ A：调整per_batch参数，根据显存大小选择合适的批处理大小。

5.5 兼容性问题

Q：旧版VHS_AUDIO格式不能用？ A：使用VHS Audio to Audio节点转换成新版AUDIO格式，或者直接使用新版音频加载节点。

Q：某些节点显示为实验性功能？ A：实验性节点可能不稳定，建议在正式项目中谨慎使用，可以先在测试环境中尝试。

总结

ComfyUI-VideoHelperSuite 是一个功能强大的视频处理插件，包含40个专业节点，涵盖了视频加载、处理、合成、音频处理等各个方面。通过合理使用这些节点，你可以轻松制作出高质量的动画和视频内容。

记住几个关键点：

根据需求选择合适的加载器（上传 vs 路径，普通 vs FFmpeg）
合理设置参数避免内存问题
选择合适的输出格式
善用批处理管理器处理大量数据
灵活使用分割、合并、选择等节点实现复杂操作
注意数据类型的匹配和转换
合理使用缓存和中间文件管理
充分利用节点的高级参数和选项

实用工作流程示例

7.1 基础视频制作流程

加载图片 → Load Images (Upload/Path)
调整帧数 → Select Every Nth Image (可选)
合成视频 → Video Combine
添加音频 → Load Audio + 连接到Video Combine

7.2 复杂数据处理流程

加载多组数据 → 多个 Load 节点
分组处理 → Split Images/Latents
分别调整 → Select/Repeat 节点
合并结果 → Merge Images/Latents
最终输出 → Video Combine

7.3 大批量处理流程

设置批管理 → Meta Batch Manager
批量加载 → Load 节点 + 连接meta_batch
批量编码 → VAE Encode/Decode Batched
批量输出 → Video Combine + meta_batch
清理文件 → Prune Outputs

7.4 视频编辑流程

加载视频 → Load Video (Upload/Path)
获取信息 → Video Info
选择帧段 → Select Images
编辑处理 → 各种图像处理节点
重新合成 → Video Combine

希望这个教程能帮助你更好地使用这个强大的插件！