Leapfusion Hunyuan I2V Patcher (LeapfusionHunyuanI2V) - ComfyUI-KJNodes

Leapfusion Hunyuan I2V Patcher 节点通过“修补”（Patch）传入的模型来实现其功能。

Leapfusion Hunyuan I2V Patcher 是一个用于视频生成和编辑的高级节点。它的核心功能是修改扩散模型在去噪过程中的行为，允许用户用指定的潜在图像（Latent）替换视频序列中的特定帧，从而实现对生成视频内容的精确控制。

节点功能

该节点通过“修补”（Patch）传入的模型来实现其功能。它会在模型执行去噪采样（Sampling）步骤时介入，根据用户设定的起始百分比（start_percent）和结束百分比（end_percent），在特定的去噪阶段，将目标帧（由index指定）的潜在表示替换为用户提供的latent。这种替换的强度可以通过strength参数进行调节，支持负值以实现反向引导。

节点参数说明 - Leapfusion Hunyuan I2V Patcher

连接输入（Inputs）

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`model`	MODEL	是	-	-	model（输入参数）：接收需要进行修补操作的原始扩散模型。此参数定义了后续操作所基于的模型基础。
`latent`	LATENT	是	-	-	latent（输入参数）：提供用于替换视频中某一帧的潜在图像表示。此数据将根据其他参数设置被注入到生成过程中。

控件参数（Parameters）

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`index`	INT	是	0	-1 - 1000（步长：1）	要替换的 latent 的索引。0 表示第一帧，-1 表示最后一帧。
`start_percent`	FLOAT	是	0.0	0.0 - 1.0（步长：0.01）	应用的起始步骤百分比。
`end_percent`	FLOAT	是	1.0	0.0 - 1.0（步长：0.01）	应用的结束步骤百分比。
`strength`	FLOAT	是	1.0	-10.0 - 10.0（步长：0.001）	strength（输入参数）：控制潜在图像替换效果的强度系数，取值范围为 -10.0 至 10.0，步长 0.001。正值增强替换，负值可能产生反向效果。

输出（Output）

参数名称	数据类型	说明
MODEL	MODEL	MODEL（输出参数）：输出经过修补后的新模型，已包含对特定帧的替换逻辑。

使用场景

你可以在图生视频（I2V）或视频插帧工作流中使用此节点。例如，当你生成了一个视频序列但希望修改其中的某一帧（如首帧或尾帧）时，可以加载一个独立的图像潜在表示，通过此节点将其“注入”到原视频生成过程中，从而改变该帧的最终外观，同时保持视频的整体连贯性。

注意事项

该节点属于实验性类别，其行为可能高度依赖于具体的模型架构和采样器设置。使用时需注意index参数的有效范围，以及strength参数设置不当可能导致画面不稳定的情况。

Leapfusion Hunyuan I2V Patcher 节点源码链接

Leapfusion Hunyuan I2V Patcher 节点来自 ComfyUI-KJNodes 节点包。

Leapfusion Hunyuan I2V Patcher(LeapfusionHunyuanI2V)