ComfyUI-FramePackWrapper_Plus 插件保姆级教程

1. 插件简介

插件地址： https://github.com/ShmuelRonen/ComfyUI-FramePackWrapper_Plus

ComfyUI-FramePackWrapper_Plus 是一个超级强大的视频生成插件，就像给你的 ComfyUI 装上了一个专业的视频制作工厂。这个插件能做什么呢？

• 图片转视频：给它一张图片，它就能生成一段流畅的视频，就像让静态照片活起来
• 时间轴控制：可以在不同时间点设置不同的描述，就像给视频写剧本一样
• LoRA 支持：可以加载各种风格模型，让视频呈现不同的艺术效果
• F1 采样器：使用最新的 F1 技术，生成的视频更流畅、质量更高
• 长视频生成：不像其他插件只能生成几秒钟，这个可以生成任意长度的视频
• 智能分辨率：自动找到最适合的视频尺寸，避免变形

这个插件基于 FramePack 项目，专门为 HunyuanVideo 模型优化，就像是专门为某种高级相机设计的镜头一样。

2. 如何安装

第一步：下载插件

# 进入你的 ComfyUI 插件目录
cd ComfyUI/custom_nodes

# 下载插件
git clone https://github.com/ShmuelRonen/ComfyUI-FramePackWrapper_Plus.git

第二步：安装依赖包

# 进入插件目录
cd ComfyUI-FramePackWrapper_Plus

# 安装必需的包
pip install -r requirements.txt

第三步：下载模型文件

你需要下载以下模型文件：

主要模型：

• FramePackI2V_HY_fp8_e4m3fn.safetensors - 优化版本（文件较小）
• FramePackI2V_HY_bf16.safetensors - 高质量版本

必需组件：

• CLIP Vision: sigclip_vision_384
• 文本编码器和VAE: HunyuanVideo_repackaged

3. 节点详细解析

3.1 DownloadAndLoadFramePackModel 节点

这个节点就像一个智能下载管家，它会自动从网上下载模型文件并加载到内存中，省去你手动下载的麻烦。

参数详解：

3.2 LoadFramePackModel 节点

这个节点就像一个本地模型管家，负责加载你已经下载好的模型文件，比自动下载节点更灵活。

参数详解：

3.3 FramePackLoraSelect 节点

这个节点就像一个风格选择器，让你可以给视频添加不同的艺术风格，比如动漫风格、写实风格等。

参数详解：

3.4 FramePackFindNearestBucket 节点

这个节点就像一个智能裁缝，会根据你的图片找到最合适的视频尺寸，避免视频变形或拉伸。

参数详解：

3.5 FramePackSampler 节点

这个节点是传统的视频生成器，就像一个经典的电影制作机，按照固定的方式生成视频。

参数详解：

3.6 FramePackSampler_F1 节点

这个节点是新一代的视频生成器，使用 F1 技术，就像从老式胶片机升级到数字摄像机，生成质量更高、更流畅。

参数详解：

3.7 FramePackTimestampedTextEncode 节点

这个节点就像一个智能剧本编辑器，可以让你为视频的不同时间段设置不同的描述，实现动态的视频内容。

参数详解：

3.8 FramePackTorchCompileSettings 节点

这个节点就像一个性能调优师，可以让模型运行得更快，但需要一定的技术基础。

参数详解：

4. 使用技巧和建议

4.1 显存优化技巧

• 显存不够用？ 选择 fp8 量化模式，能节省大量显存
• 还是不够？ 调小 latent_window_size 到 5 或 7
• 模型加载慢？ 使用 load_device 设为 offload_device
• 生成过程卡顿？ 增加 gpu_memory_preservation 的值

4.2 质量提升技巧

• 使用高质量起始图片：输入图片至少要 512x512 像素
• 合理设置步数：30 步是平衡点，50 步质量更高但慢很多
• 启用 TeaCache：可以显著提升速度且几乎不影响质量
• 选择合适的采样器：unipc_bh1 通常效果最好

4.3 时间轴控制技巧

时间戳格式说明：

[0s: 描述内容]           # 从0秒开始，持续到下一个时间戳
[3s-5s: 描述内容]        # 从3秒到5秒的特定时间段
[5s: 新的描述内容]       # 从5秒开始的新内容

实用例子：

一只小猫在阳光下睡觉 [2s: 小猫慢慢睁开眼睛] [4s-6s: 小猫伸懒腰] [6s: 小猫开始玩毛线球]

4.4 LoRA 使用技巧

• 风格强度：从 0.8 开始尝试，根据效果调整
• 多个 LoRA：可以叠加使用，但总强度不要超过 2.0
• 融合设置：fuse_lora 设为 True 可以提升性能

5. 常见问题解答

Q1: 为什么生成的视频很短？

A: 检查 total_second_length 参数，这个控制视频总长度。同时确保你的显存足够支持长视频生成。

Q2: 时间戳不起作用怎么办？

A:

1. 确保使用 FramePackTimestampedTextEncode 节点
2. 检查时间戳格式是否正确（[0s: 内容]）
3. 确保连接到 FramePackSampler_F1 节点而不是普通的 FramePackSampler

Q3: 显存不够怎么办？

A: 按以下顺序尝试：

1. 使用 fp8 量化模式
2. 减小 latent_window_size 到 5
3. 降低 base_resolution 到 512
4. 缩短视频长度

Q4: 生成速度太慢怎么办？

A:

1. 启用 use_teacache
2. 减少生成步数到 20
3. 使用编译优化（FramePackTorchCompileSettings）
4. 选择 fp8_e4m3fn_fast 量化模式

Q5: LoRA 加载失败怎么办？

A:

1. 确保 LoRA 文件是 .safetensors 格式
2. 检查 LoRA 是否兼容 HunyuanVideo
3. 尝试降低 LoRA 强度到 0.5
4. 检查 ComfyUI/models/loras 文件夹路径

Q6: F1 采样器和普通采样器有什么区别？

A:

• F1 采样器：支持时间轴控制，质量更高，适合复杂场景
• 普通采样器：更简单直接，兼容性更好，适合基础使用

6. 工作流程示例

基础图片转视频工作流程：

1. 添加 Load Image 节点加载起始图片
2. 添加 VAE Encode 节点编码图片
3. 添加 CLIP Vision Encode 节点提取图片特征
4. 添加 LoadFramePackModel 节点加载模型
5. 添加 CLIP Text Encode 节点编码描述文字
6. 添加 FramePackSampler 节点生成视频
7. 添加 VAE Decode 节点解码为视频

高级时间轴控制工作流程：

1. 使用 FramePackTimestampedTextEncode 节点替代普通文本编码
2. 使用 FramePackSampler_F1 节点替代普通采样器
3. 在文本中使用时间戳格式：[0s: 开始场景] [3s: 变化场景]
4. 设置合适的 prompt_blend_sections 实现平滑过渡

LoRA 风格化工作流程：

1. 添加 FramePackLoraSelect 节点选择风格
2. 将 LoRA 节点连接到模型加载节点
3. 调整 strength 参数控制风格强度
4. 可以串联多个 LoRA 节点实现风格叠加

7. 总结

ComfyUI-FramePackWrapper_Plus 是一个功能强大的视频生成插件，它就像给你的 ComfyUI 装上了一个专业的视频制作工厂。通过合理使用不同的节点组合，你可以实现从简单的图片转视频到复杂的时间轴控制视频生成。

记住几个关键点：

• 显存不够就用量化和小窗口
• 想要高质量就用 F1 采样器和足够的步数
• 时间轴控制需要专门的节点组合
• LoRA 可以让视频呈现不同的艺术风格
• 耐心调试参数，找到最适合你需求的设置

希望这个教程能帮助你快速掌握这个强大的视频生成插件！