ComfyUI-WanVideoWrapper中TeaCache性能优化实践

问题现象分析

近期在使用ComfyUI-WanVideoWrapper进行视频生成时，部分用户观察到TeaCache模块出现性能下降现象。具体表现为：

1. 初始化阶段耗时增加（约20秒）
2. 迭代速度明显变慢（约11秒/iter）
3. 控制台出现"TeaCache skipped"提示
4. 生成结果前几帧存在静态化现象

根本原因定位

经技术分析，该问题源于TeaCache模块的阈值参数设置策略变更。新版本TeaCache对参数敏感度进行了调整：

• 旧版本推荐阈值范围：0.02-0.04
• 新版本要求阈值范围：0.2-0.3
• 起始步数(start step)需要设置为0

优化解决方案

通过以下参数调整可显著改善性能：

1. 将相似度阈值调整为0.2-0.3区间
2. 确保起始步数参数为0
3. 推荐测试值：0.19/0.26/0.30（根据实际效果选择）

效果验证

优化后观察到：

• 推理速度提升30-50%
• 初始化时间恢复正常
• "TeaCache skipped"提示消失
• 注意：过高阈值(如0.3)可能导致运动模糊

高级调优建议

针对生成结果前几帧静态化问题，可配合以下调整：

1. 分辨率参数优化
2. 种子参数组合测试
3. 运动参数微调
4. 分阶段阈值设置（前段低阈值，后段高阈值）

技术原理补充

TeaCache作为视频生成缓存机制，其核心是通过帧间相似度检测来复用计算结果。新版本采用更宽松的相似度判断标准，这要求：

• 提高阈值避免过度计算
• 更早启动缓存机制(start step=0)
• 平衡计算速度与运动连贯性

典型配置示例

{
    "tea_cache_threshold": 0.26,
    "start_step": 0,
    "torch_compile": True,
    "precision": "fp16"
}

该配置在保持良好运动效果的同时，可获得最佳性能表现。建议用户根据硬件条件和生成需求进行微调。