ComfyUI如何进行版本升级

ComfyUI版本升级指南
ComfyUI作为Stable Diffusion的节点式界面工具，其升级流程需兼顾本体代码、界面框架及插件生态的同步更新，以下是具体操作步骤：

一、升级前的准备工作

1. 环境检查：确保系统已安装Python 3.10及以上版本、Git版本控制工具；建议通过Conda创建独立虚拟环境（如conda create -n comfyui_env python=3.12），避免依赖冲突。
2. 数据备份：升级前备份ComfyUI/models（模型文件）、ComfyUI/custom_nodes（自定义节点）目录，防止数据丢失。

二、本体代码更新方法

1. Git命令行更新（推荐，保持代码最新）

进入ComfyUI项目根目录，执行以下命令同步远程仓库（如GitHub）的最新代码：

git fetch --all          # 获取远程所有分支的最新提交
git reset --hard origin/master  # 强制本地分支与远程master分支同步

若遇到“本地分支未跟踪远程分支”的问题，需设置上游分支：

git branch --set-upstream-to=origin/master master

同步完成后，重新安装依赖以确保兼容性：

pip install -r requirements.txt --force-reinstall

2. 便携版更新（针对Windows用户）

若使用ComfyUI官方便携版或秋叶整合包，可直接运行项目根目录下的更新脚本：

• 官方便携版：双击执行update\update_comfyui.bat；
• 秋叶整合包：通过启动器进入“版本管理”，切换至最新版本并点击“更新”。

若脚本运行时出现网络超时，可修改.git/config文件，将远程仓库URL从https改为ssh（需提前配置GitHub SSH密钥）。

三、界面框架升级（可选，提升操作体验）

ComfyUI自2024年起采用模块化前端架构，升级界面需指定最新前端版本：

• 命令行启动：在启动ComfyUI时添加--front-end-version参数，例如：

python main.py --front-end-version Comfy-Org/ComfyUI_frontend@latest

• 修改启动脚本：编辑run_nvidia_gpu.bat（或对应启动文件），在python main.py后添加上述参数。
• 旧版回退：若需恢复经典悬浮菜单，进入Settings > Node Search Box Impl，选择litegraph(legacy)模式并重启。

四、插件生态管理

1. 官方插件管理器（推荐）

通过ComfyUI内置的“Manager”工具管理插件：

• 点击菜单栏Manager图标→切换至Custom Nodes tab；
• 使用搜索框定位目标插件（如ComfyUI-Impact-Pack），点击Install自动安装依赖。

2. 手动安装第三方插件

对于未收录的插件，通过Git克隆至custom_nodes目录：

cd ComfyUI/custom_nodes
git clone https://github.com/author/plugin-name.git

安装后按Ctrl+R刷新节点库，新插件将出现在对应分类下。

五、版本验证与故障排除

1. 版本验证：

• 访问http://127.0.0.1:8188/docs查看API文档版本号；
• 在节点库搜索NEW标签，查看近期更新的节点；
• 检查控制台输出是否包含ComfyUI v0.X.X+标识。

1. 常见问题解决：

• CUDA内存错误：降级PyTorch至兼容版本（如2.3.1）；
• 节点加载失败：删除custom_nodes目录下的__pycache__文件夹；
• 界面显示异常：清除浏览器缓存或切换Chrome/Firefox内核。