2026年5月21日，ComfyUI 发布了 v0.22.0 最新版本。
这一版本带来了大量功能增强、节点优化、问题修复以及 OpenAPI 文档调整，覆盖了工作流模板、音频处理、多模态输入、模型支持、VRAM 优化、Batch 处理、量化日志、节点显示信息等多个方向。

本次更新的特点非常鲜明：
一方面，ComfyUI 持续补强核心执行链路和模型能力；
另一方面，围绕实际使用场景，对节点体验、兼容性、资源占用、文档结构进行了系统性改进。
对于正在使用 ComfyUI 进行图像、音频、视频、多模态和工作流开发的用户来说，这一版本值得重点关注。

---

一、版本发布信息

ComfyUI v0.22.0 于 2026年5月21日发布。
该版本为 Immutable release，意味着发布后只允许修改 release 标题和说明内容，版本本身具有更强的稳定性和约束性。

从整体更新规模来看，这一版本包含：

• 19 位贡献者参与
• 41 次提交
• 68 个文件变更

这说明本次更新并不是单点修补，而是一次覆盖面较广的集中迭代。

---

二、核心更新概览

ComfyUI v0.22.0 的更新可以概括为以下几个重点方向：

1. 工作流模板升级

   • 工作流模板更新到 v0.9.77
   • 后续又更新到 v0.9.79

2. 执行与消息机制调整

   • 执行 WebSocket 消息中引入 workflow_id 的尝试
   • 随后又进行回退处理

3. 模型与节点能力增强

   • 新增 MoGe 支持
   • 支持 Stable Audio 3 模型
   • 新增 StringFormat 节点
   • 增加 ByteDance Seed LLM 节点
   • 增加多项 LTXV、HiDream、Hunyuan3D、Qwen3.5 等相关能力

4. 资源与显存优化

   • 降低 LTX2.3 在 guide_mask 场景下的峰值显存
   • 重新说明 lowvram 的作用
   • 改进空音频 latent 复用方式

5. 批处理与索引行为优化

   • ImageFromBatch 和 LatentFromBatch 允许负 batch_index
   • Batch Image/Mask/Latent 节点最小值从 2 降为 1

6. OpenAPI 文档调整

   • /api/upload/mask 废弃，建议使用 /api/upload/image
   • Asset schema 顶层 width/height 字段移除
   • workspace API key schema 增加 description 字段
   • description 字段说明进一步收紧

7. 文档与体验优化

   • README 增加 careers 链接、应用与云链接
   • 启动日志增加 careers 链接
   • 删除烦人的提示信息
   • 改进节点显示名、描述和分类
   • 输出量化相关操作的启用与模拟信息

8. Bug 修复

   • 修复 Qwen3.5 多图输入文本生成问题
   • 修复 HiDream-O1 区域条件能力
   • 修复 FeatherMask 负零索引
   • 修复 BiRefNet 问题
   • 修复 Hunyuan3D 2.1 批量大小崩溃
   • 修复 ops.py 中的拼写问题
   • 以及多个节点输入与推理细节修复

下面对这些更新逐项展开。

---

三、工作流模板持续升级

本次版本中，工作流模板进行了两次升级：

• 更新到 v0.9.77
• 后续再次更新到 v0.9.79

这说明 ComfyUI 在发布周期内持续对默认模板进行维护和同步。
工作流模板的更新通常意味着默认示例、节点组合方式、兼容性结构以及整体工作流组织方式会同步改进，帮助用户更顺畅地使用新版功能。

对于依赖模板启动工作流、参考模板搭建项目的人来说，这类更新非常重要，因为它直接影响新版本中默认工作方式的可用性和一致性。

---

四、执行消息与 workflow_id 相关调整

这次更新里，一个非常值得关注的点是：
在所有执行 WebSocket 消息中加入 workflow_id，这是核心执行链路中的重要变化。

不过随后，该改动又被回退。
从更新记录可以看出，这一功能在实现后又进行了撤销，说明在当前版本中该方向仍处于调整阶段。

这类变更通常涉及执行消息结构、前端订阅逻辑、任务状态追踪以及工作流级别的区分能力。
虽然最终回退，但它体现出 ComfyUI 在执行消息体系上仍在持续打磨。

---

五、模型识别与唯一标识测试增强

本次版本新增了一项测试：
确保每个模型都有唯一标识符。

这是非常基础但非常关键的一步。
模型唯一标识符能够帮助系统在加载、注册、调用和管理模型时更稳定地区分对象，避免出现重复识别、覆盖、冲突等问题。

对大规模模型管理来说，这类测试虽然不直接面向普通使用者，却会显著提升系统可靠性。

---

六、音频处理能力优化

v0.22.0 对音频相关节点做了两项重要调整：

1. 音频处理节点支持 None 输入

这意味着音频处理节点在面对空输入时，具备更好的容错能力，不容易因为输入缺失而直接报错。

2. 使用 temporal downscale 改善空音频 latent 的复用

这一改动的目标是让空音频 latent 节点更容易复用。
也就是说，系统在处理空音频 latent 的时候，能够通过 temporal downscale 的方式优化其可复用性。

这对于涉及音频生成、音频补全、音频 latent 管线的用户来说，是一个非常实用的改进。

---

七、MoGe 支持正式加入

本版本新增了 MoGe 支持。
这是本次更新中标记为核心增强的内容之一。

MoGe 支持的加入，意味着 ComfyUI 在模型适配与节点能力方面进一步扩展了边界。
对需要使用该能力的用户而言，这一版本提供了更直接的工作流接入方式。

---

八、LTXV 与 LTX2.3 相关增强

本次更新中，LTX 系列相关改动很多，主要集中在以下几个方面：

1. LTX2.3 在 guide_mask 使用时降低峰值 VRAM

这一优化直接针对显存峰值问题。
当 guide_mask 被启用时，LTX2.3 的显存占用更友好，有助于降低运行时压力。

2. 为 LTXVAddGuide 增加 downscaled IC-LoRA 支持

这是一项功能扩展，说明该节点在适配指导信息时，支持更灵活的 downscaled IC-LoRA 处理方式。

3. 为 LTXVAddGuide 增加可选 attention_mask 输入

这意味着节点在处理引导信息时，能够接入额外的 attention_mask 作为可选输入，提高控制能力。

4. 为 empty ltxv latent 添加 downscale ratio

这进一步增强了空 latent 的参数表达能力，使其在生成链路中具备更多可调控维度。

5. 为 empty ltxv latent 添加 spatial downscale ratio

这是对上一个方向的继续扩展，进一步加强空 latent 与空间下采样相关的表达。

6. 初步支持 downscale_ratio_temporal

这一项是“初步工作”，说明 temporal 方向的 downscale 能力正在逐步落地。

7. 通过 temporal downscale 改善空音频 latent 的可复用性

这与音频部分联动，体现出时间维度下采样能力正在被逐步整合进多个节点。

---

九、批处理节点与索引逻辑更新

这一版本对 Batch 相关节点做了几项非常实用的修改：

1. ImageFromBatch 和 LatentFromBatch 支持负 batch_index

这意味着用户在从 batch 中取值时，可以使用负索引方式访问末尾元素，这种行为更贴近常见编程习惯，也提高了灵活性。

2. Batch Image/Mask/Latent 节点最小值从 2 降为 1

这项改动非常实用，意味着这些节点现在可以处理更小规模的批量输入。
对于某些只需要单张图像、单个 mask 或单个 latent 的工作流来说，门槛更低，使用更方便。

---

十、Stable Audio 3 模型支持

本次版本明确加入了 Stable Audio 3 模型支持。
这说明 ComfyUI 在音频生成模型生态上进一步扩展，对音频领域的适配能力持续增强。

结合前面音频节点对 None 输入的支持、空音频 latent 的优化，这一版本显然在音频方向做了系统性加强。

---

十一、Qwen3.5 多图输入修复

本版本修复了 Qwen3.5 在多图 prompt 下的文本生成问题。
这是一个很实际的 bug 修复，因为多图输入属于多模态任务中较复杂的场景，一旦生成逻辑出错，会直接影响结果质量和稳定性。

此次修复意味着在多图场景下，Qwen3.5 的文本生成表现将更加可靠。

---

十二、HiDream-O1 区域条件能力修复

本次更新对 HiDream-O1 的 area conditioning 做了支持修复。
这类修复通常涉及条件区域的输入识别和控制流程，有助于提升区域级控制在工作流中的可用性。

---

十三、Hunyuan3D 2.1 批量大小崩溃修复

该版本修复了 Hunyuan3D 2.1 在 attention 和 forward pass 中的批量大小崩溃问题。
这是一项典型的稳定性修复，直接关系到模型运行时的容错能力与批处理能力。

对于使用该模型进行 3D 相关任务的用户来说，这类修复非常关键。

---

十四、BiRefNet 问题修复

本版本还修复了 BiRefNet 的问题。
虽然更新说明中未展开具体细节，但可以确定这是一项针对模型节点运行异常或兼容性问题的修复。

---

十五、FeatherMask 负零索引修复

这次更新修复了 FeatherMask 在右侧和底部 feathering 时的 negative zero indexing 问题。
这类问题虽然细节较小，但属于典型的边界条件错误，修复后会让 feathering 处理更准确。

---

十六、动态 clip 保存功能完善

本版本还完成了 dynamic clip saving 的实现和修复。
这意味着在 clip 保存流程上，系统处理更加完善，动态保存能力得到补强。

---

十七、ByteDance Seed LLM 节点加入

本次更新新增了 ByteDance Seed LLM 节点。
这意味着 ComfyUI 在大语言模型相关节点上继续扩展，进一步增强了与 LLM 生态的连接能力。

---

十八、Opus 4.7 参数兼容修复

在 Partner Nodes 中，修复了 Opus 4.7 发送废弃 temperature 参数 的问题。
这类修复主要是为了保持接口兼容性，避免因使用废弃参数导致调用异常或警告。

---

十九、StringFormat 节点新增

本版本新增了一个 StringFormat 节点。
这一节点的加入意味着字符串处理能力更灵活，在工作流中可以更方便地进行格式化输出、文本拼接和字符串构建。

对于需要处理提示词、标签、路径、说明文本等场景的用户来说，这项新增非常实用。

---

二十、README 与启动日志优化

本次更新对 README 和启动日志做了多项增强：

• 增加 careers 链接
• 增加应用和云链接
• 启动日志中增加 careers 链接

这些改动虽然不影响核心推理能力，但会提升项目入口信息的可见性，也让用户更容易获取相关资源。

---

二十一、烦人提示信息移除

版本中明确移除了一个“烦人的消息”。
这类改动通常会让启动过程或使用过程中更清爽，减少无效干扰。

---

二十二、前端版本警告范围扩大

本次更新将 前端版本警告 泛化到了所有 comfy* requirements.txt 条目。
这说明版本检查逻辑更全面了，能够覆盖更多相关依赖项，有助于减少前后端版本不一致带来的问题。

---

二十三、量化操作日志增强

ComfyUI v0.22.0 还新增了一个很实用的日志能力：
记录哪些 quant ops 被启用或被模拟。

这对于调试量化相关性能、兼容性和运行路径非常有帮助。
在遇到模型表现异常、速度变化或者设备兼容问题时，这类日志信息非常关键。

---

二十四、OOM 内存摘要格式修正

本版本修正了 OOM memory summary 的格式。
这项改动属于诊断信息优化，有利于在内存不足报错时输出更规范、更易读的摘要内容，方便排查问题。

---

二十五、lowvram 说明优化

更新中还提到：
移除了无用选项，并澄清了 lowvram 的作用。

这说明 ComfyUI 在降低用户理解成本方面也做了整理，把一些不必要的选项移除，同时让 lowvram 的行为说明更加清晰。

---

二十六、OpenAPI 文档与接口结构调整

这次版本在 OpenAPI 文档方面变化很明显，主要包括：

1. /api/upload/mask 废弃

官方建议改用 /api/upload/image。

2. Asset schema 顶层 width/height 字段移除

这意味着资产结构更简化，字段定义更统一。

3. workspace API key schema 增加 description 字段

这让 API key 的描述信息更完整。

4. 对 workspace API key description 字段说明进行收紧

进一步明确字段用途和约束范围。

这些调整总体上体现出接口定义朝着更统一、更规范的方向演进。

---

二十七、节点显示信息和分类优化

本版本还进行了多项节点展示层面的质量改进：

• 更新节点显示名称
• 更新节点描述
• 更新节点分类

这些调整的目的非常直接：
让用户在节点列表中更容易识别节点用途，减少理解成本，提升工作流搭建效率。

---

二十八、ops.py 拼写修复

本次更新修复了 ops.py 中的一个拼写问题。
虽然属于较小的代码质量修复，但这类问题的清理有助于维持代码整洁性和后续维护性。

---

二十九、整体体验总结

综合来看，ComfyUI v0.22.0 是一次覆盖范围很广、实用性很强的版本更新。
它既包含以下这些偏底层的改进：

• 模型唯一标识测试
• 执行消息结构调整
• 量化日志输出
• OOM 摘要格式修正
• OpenAPI schema 调整

也包含大量偏使用体验的改动：

• 工作流模板升级
• README 和启动日志增强
• 节点显示信息优化
• lowvram 说明澄清
• 无用提示移除
• Batch 和索引逻辑优化

同时还包含一批面向具体模型的功能增强与修复：

• MoGe 支持
• Stable Audio 3 支持
• ByteDance Seed LLM 节点
• StringFormat 节点
• Qwen3.5 多图问题修复
• HiDream-O1 区域条件修复
• Hunyuan3D 2.1 批量崩溃修复
• BiRefNet 问题修复
• FeatherMask 负零索引修复

可以说，这一版本既有“扩能力”的新增，也有“稳体验”的修复，还兼顾了文档、接口和使用引导的完善。

---

三十、结语

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

ComfyUI v0.22.0 的发布，体现出项目在多个方向上的持续演进：
从工作流模板到节点能力，从音频到多模态，从显存优化到 API 文档，从模型支持到使用体验，都有明确推进。