ComfyUI-LivePortraitKJ项目开发分支切换指南

ComfyUI-LivePortraitKJ是一个基于ComfyUI框架的AI肖像动画生成工具，近期用户在使用过程中遇到了节点缺失的问题。本文将详细介绍该问题的背景、原因以及解决方案。

问题背景

在使用ComfyUI-LivePortraitKJ的示例工作流时，部分用户报告LivePortrait Cropper和KeypointsToImage节点无法找到的错误。虽然常见的InsightFace下载问题已经解决，但视频到视频(v2v)转换功能仍然无法正常工作。

问题原因

这个问题源于项目开发分支和主分支的差异。最新功能目前仅存在于开发分支(develop)中，尚未合并到主分支(main)。因此，使用主分支版本的用户会缺少部分关键节点。

解决方案

要解决这个问题，用户需要将项目切换到开发分支。以下是具体操作步骤：

1. 打开终端或命令行界面
2. 导航到ComfyUI的自定义节点目录：custom_nodes/ComfyUI-LivePortraitKJ
3. 执行以下命令：

   git fetch --all
   git switch develop
   

如果遇到分支切换错误，可以尝试替代方案：

git switch origin/develop --detach

注意事项

1. 开发分支可能包含未修复的bug，稳定性可能不如主分支
2. 项目维护者表示将在完成必要的bug修复和代码重构后，将开发分支合并到主分支
3. 使用开发分支时，建议定期更新以获取最新修复

技术背景

在Git版本控制系统中，开发分支通常用于存放正在开发中的新功能，而主分支则保持稳定版本。这种分支策略允许开发者在隔离环境中开发新功能，同时不影响主分支的稳定性。

对于AI工作流工具如ComfyUI，节点是构建工作流的基本单元。当核心节点缺失时，整个工作流将无法正常执行。因此，确保使用正确的项目版本至关重要。

结语

目前该问题已在开发分支中得到解决。建议用户根据自身需求选择使用稳定版本还是开发版本。对于需要完整功能的用户，切换到开发分支是最佳选择；而对于稳定性要求较高的用户，可以等待功能合并到主分支后再进行更新。