ComfyUI v0.21.1：最新版本发布，模型、节点、工作流与稳定性全面升级

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

ComfyUI v0.21.1 已于 2026年5月14日发布。本次版本说明中明确标注为 Immutable release，也就是说，发布后只能修改 release title 和 notes。这意味着这次更新内容具有较强的定版性质，适合直接作为版本升级参考。

如果用一句话概括这次更新，那就是：在保持系统稳定性的同时，进一步扩展了图像生成、视频处理、3D 保存、云运行接口、文档模板和伙伴节点能力。从更新条目来看，本次版本既有面向新模型和新节点的能力增强，也有大量针对 dtype、内存、保存格式、对齐、目录创建、静态检查、弃用标记等方面的修复与优化，整体非常扎实。

一、版本概览：v0.21.1 的核心关键词

从这次更新清单来看，v0.21.1 的主要方向可以概括为以下几类：

1. 1. 伙伴节点持续扩展 新增多个图像生成、图像编辑、语言模型相关节点，并对已有伙伴节点进行修复。
2. 2. 新模型支持增强 支持 HiDream-O1-Image，并修复相关 dtype 和内存使用问题。
3. 3. 保存与格式兼容性提升 修复 fp8 safetensors 保存问题，扩展 Save3D 的保存能力，支持 anima TE lora kohya 格式。
4. 4. 视频与 3D 工作流增强 修复 LTXV 多帧引导对齐问题，增强 Create Video 入口，以及 Save3D 的保存内容扩展。
5. 5. 稳定性与兼容性修复 包括回滚部分破坏性变更、修复 LoadAudio 目录问题、修复 VOID 运行错误等。
6. 6. 文档、模板与规范更新 更新 embedded docs、workflow templates，并在 spec 中标记废弃云运行端点。

这说明 ComfyUI 在这个版本中并非只追求“加新功能”，而是兼顾了生态扩展、底层稳定、格式兼容和文档维护。

二、伙伴节点更新：图像、编辑、语言模型能力明显扩展

本次版本里，伙伴节点是一个非常重要的升级方向。

1. 新增 Flux2ImageNode 与 GrokImageEditNodeV2

更新中提到新增了 Flux2ImageNode 和 GrokImageEditNodeV2 两个节点。这表明 ComfyUI 的伙伴节点体系继续扩展到新的图像生成与图像编辑场景。

从命名上看：

• • Flux2ImageNode：面向 Flux2Image 类图像生成流程
• • GrokImageEditNodeV2：面向图像编辑流程的第二代节点

这类节点的加入，意味着用户在工作流搭建时，可以使用更贴近具体模型能力的专用节点，而不必完全依赖通用流程。

2. ByteDanceSeedreamNodeV2 新增 DynamicCombo 与 Autogrow

本次还新增了 ByteDanceSeedreamNodeV2，并特别注明支持 DynamicCombo 和 Autogrow。

这两个特性说明节点界面和交互体验做了进一步优化：

• • DynamicCombo：动态组合选项，使节点参数更灵活
• • Autogrow：输入区域或配置区域自动扩展，提高复杂配置时的可读性和可用性

这类改进的意义在于，随着节点功能越来越复杂，传统固定输入框已经不够用，动态和自适应能力对实际工作流搭建非常重要。

3. 新增 OpenAI Image 节点，同样支持 DynamicCombo 与 Autogrow

这次更新还新增了 OpenAI Image 节点，并且同样带有 DynamicCombo 和 Autogrow。

这表示在图像生成相关的伙伴节点上，ComfyUI 进一步支持更丰富的图像服务接入方式，且在交互层面保持一致的设计风格。对于用户来说，这类节点新增意味着可以更顺畅地将不同图像能力接入统一工作流中。

4. 修复 Quiver 节点

更新中还有一项针对 Quiver 节点的修复。这说明在扩展新节点的同时，团队也在持续修补已有伙伴节点中的问题，保证新增能力不会以牺牲稳定性为代价。

5. 新增 Claude LLM 节点

本次版本还新增了 Claude LLM 节点。这个节点的加入，说明 ComfyUI 的伙伴节点不再局限于图像生成或编辑，也在向语言模型方向继续扩展。

这对于多模态工作流非常重要，因为很多实际场景中，图像、文本、提示词生成、内容理解是彼此联动的。新增语言模型节点后，工作流的组合空间进一步增大。

三、新模型支持：HiDream-O1-Image 正式加入

1. 支持 HiDream-O1-Image

更新中明确写到：支持 HiDream-O1-Image。这是一项重要的模型兼容性增强，意味着 ComfyUI 可以更好地接入这一图像生成模型。

对于使用新模型的用户来说，版本支持往往意味着：

• • 能够在 ComfyUI 中直接使用对应模型能力
• • 工作流与模型的适配更完整
• • 后续调参、内存管理、dtype 处理会更稳定

2. 修复 HiDream O1 的 dtype 问题

紧接着，更新里又有一条：Fix dtype issue with hidream o1。这说明在支持新模型之后，团队迅速修复了与 dtype 相关的问题。

dtype 问题通常会影响：

• • 推理精度
• • 显存占用
• • 计算稳定性
• • 模型加载或保存行为

因此这次修复非常关键，属于“支持之后立刻补稳定性”的典型优化。

3. 改善非 dynamic vram 场景下的内存使用因子

另外还有一条：Better Hidream O1 mem usage factor for non dynamic vram。这说明在非 dynamic vram 场景下，HiDream O1 的内存使用估算或分配策略得到了改进。

这类优化虽然表面上不像新增节点那么显眼，但实际影响很大，尤其对于：

• • 显存较紧张的机器
• • 固定显存分配环境
• • 不支持动态显存调度的部署方式

这样的优化能让模型使用更稳，减少因内存预估不准导致的问题。

四、保存与格式兼容性增强：更稳、更完整

1. 修复 safetensors 保存 fp8 的问题

本次版本中有一项非常重要的底层修复：Fix safetensors saving of fp8。

这说明在保存模型或权重时，fp8 格式在 safetensors 处理上曾存在问题。修复后，意味着：

• • fp8 模型保存更可靠
• • 权重导出更稳定
• • 兼容性更高
• • 训练、微调或部署链路中更不容易出现保存异常

这是典型的底层兼容性修复，对重度用户非常重要。

2. 支持 anima TE lora kohya 格式

更新中还提到：Support anima TE lora kohya format。

这代表 ComfyUI 新增了对 anima TE lora kohya 格式的支持。对于依赖 LoRA 工作流的用户来说，格式兼容性是非常关键的一环，因为不同训练体系和导出规范会直接影响模型能否顺利被加载和使用。

这次支持说明 ComfyUI 在格式层的兼容性继续增强，能更好适应不同来源的模型资源。

3. Extend Save3D to save vertex colors and textures

版本中还有一项 3D 相关增强：Extend Save3D to save vertex colors and textures。

这意味着 Save3D 节点或功能不再只保存基础的 3D 数据，还能保存：

• • 顶点颜色
• • 纹理

这对于 3D 结果导出非常重要，因为模型不只是几何结构，颜色和纹理也是最终效果的关键部分。保存能力增强后，用户导出的 3D 文件会更完整，也更贴近实际应用需求。

五、视频与多帧工作流优化：对齐问题得到修复

1. 修复 LTXV mid-video multi-frame guide alignment

本次更新里有一条与视频相关的重要修复：Fix LTXV mid-video multi-frame guide alignment。

这条内容说明在 LTXV 的视频处理中，尤其是在视频中段使用多帧引导时，存在对齐问题。修复后，视频工作流在帧间引导或中段处理时的表现将更准确。

对于视频生成来说，对齐问题通常会直接影响：

• • 连贯性
• • 画面跳变
• • 引导一致性
• • 中间帧质量

因此这是一个非常实用的修复，尤其适合视频生成类工作流用户。

2. Add Create Video to the essentials tab

版本还将 Create Video 加入了 essentials tab。也就是说，创建视频这一入口被放到了更容易找到的位置。

这类调整虽然不像模型支持那样技术感强，但在日常使用中很有价值：

• • 降低新用户找入口的成本
• • 让常用功能更集中
• • 提高基础工作流构建效率

从产品设计角度看，这是典型的“可发现性优化”。

六、稳定性与兼容性修复：减少破坏性影响

1. Revert some breaking changes

本次更新有一条非常关键的说明：Revert some breaking changes。

这意味着之前某些可能影响兼容性或正常使用的变更，被回退了。对于用户来说，这通常是一个积极信号，说明团队在处理版本演进时，愿意优先保证稳定和兼容，而不是单纯追求新特性推进。

2. Fix create input directory if missing in LoadAudio define_schema

这里修复的是：在 LoadAudio define_schema 中，如果输入目录缺失则自动创建。

这个问题看似小，但实际非常实用。因为如果输入目录不存在，音频相关流程可能直接失败。修复后，系统在处理音频输入时会更加健壮，减少因为目录缺失引发的异常。

3. Fix VOID failing with RuntimeError

更新中还有一项：Fix VOID failing with RuntimeError。

这说明 VOID 在某些情况下会出现运行时错误，导致功能失败。修复后，这一模块的稳定性会提升，用户在实际运行工作流时遇到异常的概率也会降低。

七、规范、文档与模板更新：生态维护持续推进

1. Mark deprecated cloud-runtime endpoints in spec

本次更新在 spec 中对 deprecated cloud-runtime endpoints 做了标记。也就是说，已废弃的云运行端点被明确标注出来。

这种做法的意义在于：

• • 提示开发者和用户不要继续依赖旧接口
• • 减少误用废弃接口造成的问题
• • 为后续接口演进铺路

2. Suppress false-positive Spectral lint on WebSocket endpoint

更新还提到：Suppress false-positive Spectral lint on WebSocket endpoint。

这意味着在 WebSocket 端点上，原本存在误报性质的 Spectral lint 问题，现在被抑制了。这样做可以减少无意义的告警，让规范检查更准确，也更利于维护 API 相关文档和定义。

3. Update embedded docs to v0.5.0

本次版本还将嵌入式文档更新到了 v0.5.0。文档升级通常代表：

• • 功能说明更完善
• • 使用指引更贴近当前版本
• • 新特性和新节点有更好说明
• • 对用户和开发者更友好

4. Update workflow templates to v0.9.75

工作流模板也更新到了 v0.9.75。这意味着默认模板和示例工作流也进行了同步升级，有助于用户在新版本中更快上手，也能降低版本间模板不一致的问题。

八、发布时间线与提交节奏

从更新记录可以看到，这次版本的提交节奏非常集中，主要分布在 2026年5月11日到5月14日之间。

5月11日

主要集中在：

• • Flux2ImageNode 与 GrokImageEditNodeV2
• • ByteDanceSeedreamNodeV2
• • OpenAI Image 节点

5月12日

主要集中在：

• • fp8 safetensors 保存修复
• • anima TE lora kohya 格式支持
• • HiDream-O1-Image 支持
• • HiDream O1 dtype 修复
• • Quiver 节点修复

5月13日

主要集中在：

• • 云运行端点废弃标记
• • WebSocket 端点 lint 修复
• • LTXV 多帧引导对齐修复
• • 回退部分破坏性变更
• • LoadAudio 目录问题修复
• • HiDream O1 内存使用因子优化
• • embedded docs 更新
• • Create Video 加入 essentials tab
• • Save3D 扩展保存顶点颜色和纹理

5月14日

主要集中在：

• • Claude LLM 节点
• • workflow templates 更新
• • VOID 运行错误修复
• • 正式发布 v0.21.1

从节奏上看，这是一次连续推进、快速修补、逐步收口的版本发布过程。

九、这次更新对用户意味着什么

虽然这里只根据发布说明本身进行整理，不额外扩展未给出的内容，但从这些更新项可以清楚看出，v0.21.1 对用户的实际意义主要体现在以下几个方面：

1. 1. 图像相关能力更丰富
   • • 新增多个图像生成、图像编辑节点
   • • 支持更多图像工作流接入方式
2. 2. 语言模型接入更进一步
   • • 新增 Claude LLM 节点
   • • 多模态工作流更容易搭建
3. 3. 新模型兼容性增强
   • • 支持 HiDream-O1-Image
   • • 修复 dtype 和内存相关问题
4. 4. 保存与导出更完整
   • • 修复 fp8 safetensors 保存
   • • Save3D 能保存更多 3D 数据
   • • 支持新的 LoRA 格式
5. 5. 视频工作流更稳定
   • • LTXV 多帧引导对齐修复
   • • Create Video 更容易访问
6. 6. 整体稳定性更强
   • • 回退部分破坏性变更
   • • 修复音频目录问题
   • • 修复 VOID 运行错误
7. 7. 文档和模板更同步
   • • embedded docs 更新
   • • workflow templates 更新
   • • 废弃端点标注更清晰

十、ComfyUI v0.21.1 更新清单完整回顾

下面按原始内容做一次完整回顾，便于核对是否遗漏：

• • 新增 Flux2ImageNode 和 GrokImageEditNodeV2 节点
• • 新增 ByteDanceSeedreamNodeV2 节点，支持 DynamicCombo 和 Autogrow
• • 新增 OpenAI Image 节点，支持 DynamicCombo 和 Autogrow
• • 修复 model_patcher 中 fp8 的 safetensors 保存问题
• • 支持 anima TE lora kohya 格式
• • 支持 HiDream-O1-Image
• • 修复 hidream o1 的 dtype 问题
• • 修复 Quiver 节点
• • 在 spec 中标记已废弃的 cloud-runtime 端点
• • 抑制 WebSocket 端点上的 Spectral lint 误报
• • 修复 LTXV mid-video multi-frame guide alignment
• • 回退部分破坏性变更
• • 修复 LoadAudio define_schema 在输入目录缺失时不创建目录的问题
• • 优化非 dynamic vram 场景下 HiDream O1 的内存使用因子
• • 更新 embedded docs 到 v0.5.0
• • 将 Create Video 加入 essentials tab
• • 扩展 Save3D，使其可保存顶点颜色和纹理
• • 新增 Claude LLM 节点
• • 更新 workflow templates 到 v0.9.75
• • 修复 VOID 运行时错误
• • 发布 ComfyUI v0.21.1

结语

代码地址：github.com/Comfy-Org/ComfyUI

总体来看，ComfyUI v0.21.1 是一次非常典型的“功能扩展 + 稳定性修复 + 生态同步”版本。它没有单纯堆砌新功能，而是围绕图像、视频、3D、语言模型、格式兼容、文档模板、接口规范等多个方向进行了系统化更新。