VideoHelperSuite 参考：读取帧、处理音频、合成视频与保存

用途与适用范围

本页以 VHS_VideoCombine 为入口说明 VideoHelperSuite 的媒体工作流角色。视频生成模型产出内容，媒体节点负责读取、抽帧、合成和输出；不要把两者的错误混为一个模型问题。

已核对的依据

项目 README 介绍 Load Video 与 Video Combine 的帧率、输出格式、音频与保存选项；2026-08 的具体 issue 另报告了某精度设置下的音频问题，该结果仍是报告者测试。 R02 I20

开始前需要分清的事项

1. 读取端：原视频帧率、强制采样率、跳帧、帧数上限影响进入图像处理链的数据。

2. 合成端：最终 frame_rate、音频、编码与像素格式决定文件如何输出。

3. 保存与预览：所核对的节点源码中，save_output=true 选择 ComfyUI 的 output 目录，false 选择 temp 目录。前端预览、文件位置和工作流元数据需分别检查；文件能播放不等于可恢复工作流。VHS 源码

操作与检查步骤

以下步骤是基于所列资料编排的操作建议；具体文件、版本和运行环境仍需按实际项目核对。

第 1 步。 先用短且正常的输入媒体验证读取与合成，不一开始混入大模型生成和多种音效。

第 2 步。 记录实际输入/输出帧数和目标帧率，用保存后的文件核对预期时长。音轨是否存在、时长与电平要分别检查；视频预览不能证明这些结果。

第 3 步。 读完整 traceback 和 FFmpeg stderr，区分找不到可执行文件与编码器或格式参数被拒绝。若声音异常，另查上游 AUDIO 和保存后的音轨；单凭 stderr 不能判定 waveform 是否存在非有限值。

第 4 步。 依赖版本升级后对视频、音频和 API 路径分别回归，保存节点版本及成功样例条件。

完成后的检查

确认实际文件路径及其处于 temp 还是 output 目录，再独立检查容器、帧数、时长和音轨。需要恢复工作流时，另核对嵌入元数据或独立导出的画布文件，不能只凭文件可播放下结论。

注意事项与尚未确认的部分

固定的 Comfy Registry 1.7.9 归档对 VHS_VideoCombine 声明了这些输入：images（IMAGE，也接受 LATENT）、frame_rate（FLOAT/INT；默认 8，最小值 1，步进 1）、loop_count（INT；默认 0，范围 0–100）、filename_prefix（STRING；默认 AnimateDiff）、format、pingpong（false）和 save_output（true）。可选输入：audio（AUDIO）、meta_batch（VHS_BatchManager）和 vae（VAE）。隐藏执行上下文：PROMPT、EXTRA_PNGINFO、UNIQUE_ID。输出声明：VHS_FILENAMES，名称 Filenames；函数 combine_video；输出节点。

format 是动态选项：GIF/WebP 会与从已安装或已注册格式文件中发现的 FFmpeg 格式合并，所以归档无法列出你机器上的实际选项。本证据只对固定源码做 AST 静态解析，不是实时 object_info 或运行测试。范围仅此一个节点；其余 39 个类的接口未采集。可读取的 1.7.9 静态接口记录 列出归档及源码文件哈希；仓库副本为 docs/VHS-1.7.9-STATIC-INTERFACE.json.

资料、静态接口及中文语言审查日期：2026-09-26。本站未运行 VHS、导出视频或进行 GPU 测试。

原始资料

• R02 · VideoHelperSuite README。核对：2026-09-26。
• I20 · VHS audio dtype report under fp16 intermediates。核对：2026-09-26；原始日期：2026-08-26。
• VHS · 当前节点源码。核对：2026-09-26。
• Comfy Registry 1.7.9 源码归档。SHA-256 复核：2026-09-26。

相关排查与操作

• FFmpeg 找不到：终端可用不代表节点进程也能找到
• 视频导出失败、黑屏或时长不对：检查编码与帧率链路
• VHS 合成后近乎静音：检查音频 dtype，而不是先放大音量