ComfyUI-WanVideoWrapper多模型协作：Lynx与LongCat-Video融合教程

2026-02-06 04:05:00作者：裘旻烁

项目地址：https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper

你是否在视频生成中遇到角色面部特征丢失、动作连贯性差的问题？本文将展示如何通过Lynx与LongCat-Video的多模型协作，实现高质量面部保留与流畅视频生成。读完你将掌握：双模型融合工作流搭建、面部特征提取技巧、参数调优方法，以及完整案例的复现步骤。

核心功能与应用场景

Lynx模块专注于高精度面部特征提取与保留，通过ArcFace（Arc面部分类器）技术生成稳定的面部嵌入向量，解决视频生成中常见的面部漂移问题。LongCat-Video则擅长长时序视频生成，通过优化的扩散模型实现流畅的动作过渡。两者结合可应用于：

虚拟主播实时驱动：保留面部特征的同时生成自然肢体动作
影视角色替换：保持演员面部特征的同时替换服装与场景
教育内容创作：生成稳定面部特写的教学视频

关键技术模块路径：

Lynx面部处理：lynx/nodes.py
LongCat模型配置：LongCat/longcat_i2v_testing.json
融合工作流示例：example_workflows/LongCat_TI2V_example_01.json

环境准备与项目结构

项目克隆与依赖安装

git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper
cd ComfyUI-WanVideoWrapper
pip install -r requirements.txt

核心目录结构解析

ComfyUI-WanVideoWrapper/
├── lynx/               # 面部特征提取模块
│   ├── nodes.py        # Lynx节点定义
│   └── face/           # 面部检测与对齐工具
├── LongCat/            # 视频生成模型
│   └── longcat_i2v_testing.json  # 模型配置
├── example_workflows/  # 示例工作流
│   └── LongCat_TI2V_example_01.json  # 融合示例
└── wanvideo/           # 核心视频处理模块
    └── modules/        # 模型融合组件

分步实现：双模型融合工作流

1. 面部特征提取（Lynx模块）

通过Lynx节点链实现面部特征提取与嵌入：

加载参考图像：使用LoadImage节点导入含有人脸的参考图片

面部裁剪与对齐：使用LynxInsightFaceCrop节点提取112x112面部区域

# LynxInsightFaceCrop核心代码 [lynx/nodes.py#L70-L91]
def encode(self, image, image_size=112):
    from .face.face_encoder import get_landmarks_from_image
    from .face.face_utils import align_face
    from insightface.utils import face_align
    
    image_np = (image[0].numpy() * 255).astype(np.uint8)
    landmarks = get_landmarks_from_image(image_np)
    ip_face_aligned = face_align.norm_crop(in_image, landmark=landmark, image_size=112)
    ref_face_aligned = align_face(in_image, landmark, extend_face_crop=True, face_size=256)

生成面部嵌入向量：使用LynxEncodeFaceIP节点将面部图像转换为特征向量

2. LongCat视频生成配置

加载预训练模型并配置生成参数：

模型加载：通过WanVideoModelLoader加载LongCat模型，路径设置为LongCat/LongCat_TI2V_comfy_fp8_e4m3fn_scaled_KJ.safetensors
Lora配置：在WanVideoLoraSelect节点中选择LongCat专用Lora：LongCat_distill_lora_alpha64_bf16.safetensors，权重设为1.0
采样参数设置：
- 步数：16
- 采样器：longcat_distill_euler
- CFG值：12
- 帧率：15fps

3. 双模型融合关键点

通过WanVideoAddLynxEmbeds节点实现特征融合，关键参数：

参数	建议值	作用
ip_scale	1.0	面部特征强度
ref_scale	0.8	参考图像影响度
start_percent	0.0	特征应用起始帧
end_percent	1.0	特征应用结束帧

融合原理示意图：

graph TD
    A[参考图像] -->|LynxInsightFaceCrop| B(对齐面部)
    B -->|LynxEncodeFaceIP| C{面部嵌入向量}
    D[文本提示] -->|WanVideoTextEncode| E(文本嵌入)
    C -->|WanVideoAddLynxEmbeds| F[融合嵌入]
    E -->|WanVideoTextEncode| F
    F -->|LongCat模型| G[视频生成]

完整工作流与示例

工作流节点连接顺序

图像输入 → 2. Lynx面部处理 → 3. 文本编码 → 4. 嵌入融合 → 5. LongCat采样 → 6. 视频合成

关键节点配置参考example_workflows/LongCat_TI2V_example_01.json中的以下参数段：

{
  "id": 71,
  "type": "WanVideoModelLoader",
  "widgets_values": [
    "LongCat/LongCat_TI2V_comfy_fp8_e4m3fn_scaled_KJ.safetensors",
    "bf16",
    "disabled",
    "offload_device",
    "sageattn_compiled",
    "default"
  ]
}