ComfyUI v0.22.0 更新：工作流模板升级、音频与多模态增强、OpenAPI 文档完善、节点能力大幅扩展

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 的更新可以概括为以下几个重点方向工作流模板升级工作流模板更新到 v0.9.77后续又更新到 v0.9.79执行与消息机制调整执行 WebSocket 消息中引入 workflow_id 的尝试随后又进行回退处理模型与节点能力增强新增 MoGe 支持支持 Stable Audio 3 模型新增 StringFormat 节点增加 ByteDance Seed LLM 节点增加多项 LTXV、HiDream、Hunyuan3D、Qwen3.5 等相关能力资源与显存优化降低 LTX2.3 在 guide_mask 场景下的峰值显存重新说明 lowvram 的作用改进空音频 latent 复用方式批处理与索引行为优化ImageFromBatch 和 LatentFromBatch 允许负 batch_indexBatch Image/Mask/Latent 节点最小值从 2 降为 1OpenAPI 文档调整/api/upload/mask 废弃建议使用 /api/upload/imageAsset schema 顶层 width/height 字段移除workspace API key schema 增加 description 字段description 字段说明进一步收紧文档与体验优化README 增加 careers 链接、应用与云链接启动日志增加 careers 链接删除烦人的提示信息改进节点显示名、描述和分类输出量化相关操作的启用与模拟信息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/ComfyUIComfyUI v0.22.0 的发布体现出项目在多个方向上的持续演进从工作流模板到节点能力从音频到多模态从显存优化到 API 文档从模型支持到使用体验都有明确推进。