ComfyUI v0.38.0发布：Qwen 2.1、MiniMax-H3、Wan 2.1、HDR 色彩、资

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

发布日期：2026 年 10 月 1 日
发布版本：v0.38.0
版本状态：不可变发布，仅允许修改发布标题和发布说明。

ComfyUI v0.38.0 是一次覆盖模型支持、推理优化、图像与视频能力、资产系统、数据库稳定性、色彩空间、硬件兼容性以及合作节点模型的综合更新。

本次版本的更新重点非常集中：一方面持续完善 Qwen Image 2.1、Qwen VL、Qwen 3.5、Qwen 3.8 等 Qwen 相关能力；另一方面强化 MiniMax-H3、Wan 2.1、VACE、Lumina、Flux、Yue2、SeedVR2、Ming Image 等模型的支持与运行表现。同时，资产扫描、SQLite 锁、磁盘检测、模型加载、RGBA 图像处理、HDR 色彩转换等底层能力也获得多项修复和调整。

一、Qwen 系列模型更新：KV Cache、Transformer、Tiny VAE、ControlNet 与长上下文优化

Qwen 系列模型是本次更新中涉及内容最多的方向之一，覆盖缓存位置、模型编译、图像预处理、低精度激活、Tiny VAE、ControlNet 和长文本上下文生成等多个方面。

首先，v0.38.0 改进了 Qwen 2.1 的 KV Cache 位置逻辑。KV Cache 是自回归模型处理上下文时的重要缓存机制，本次更新针对其位置逻辑进行了改进。

在模型执行层面，新增了 Qwen Image 2.1 Transformer Blocks 编译支持。该更新将 Qwen Image 2.1 的 Transformer Block 纳入编译处理范围。

模型文件配置能力也得到扩展。现在，模型文件可以指定每一个 Block 应使用哪一种 Attention。这意味着 Attention 的使用方式可以由模型文件进行描述，并应用到对应的 Block 中。

Qwen Image 2.1 的图像模型支持继续完善：

• • 新增 Qwen-Image 2.1 Tiny VAE 支持。
• • 新增 Qwen-Image 2.1 Union Fun ControlNet 支持。
• • 针对 Qwen Image 2.1 的 FP16 激活值，增加了原地 Clamp 处理。
• • 修复了 Qwen VL 在处理四通道 RGBA 输入图像时的预处理崩溃问题。

其中，RGBA 图像兼具 RGB 颜色信息与 Alpha 透明通道，针对四通道输入的修复使 Qwen VL 的图像预处理流程能够覆盖该类输入场景。

在文本与长上下文生成方向，v0.38.0 还带来了 Qwen 3.5 和 Qwen 3.8 长上下文生成加速。更新说明明确指出，该项调整用于加速这两个模型在长上下文条件下的生成过程。

二、图像、视频与多媒体模型支持扩展：MiniMax-H3、Wan 2.1、Ming Image、SeedVR2 等

本次版本新增或完善了多个图像、视频及多媒体模型相关能力。

在 MiniMax-H3 方向，ComfyUI v0.38.0 新增：

• • MiniMax-H3 对 Fun-ControlNet-Union 2.0 的支持。
• • 修复 MiniMax-H3 VAE 在 qk_norm_scale 被卸载时出现的 rms_rope 崩溃问题。

这两项更新分别覆盖功能支持和稳定性修复，使 MiniMax-H3 的相关节点和模型处理流程得到补充。

在 Wan 2.1 和 VACE 方向，新增了：

• • 基于 Wan 2.1 与 VACE 的 ID-V2V 模型支持。

该项更新直接补充了 ID-V2V Wan 2.1/VACE 模型的支持能力。

在 Ming Image 方向，本次更新包括两项内容：

• • 新增 Ming Image 支持。
• • 修复 保存和加载 Ming Image 模型时会影响模型检测的问题。

这意味着 Ming Image 从支持接入到模型保存、加载和检测流程均获得了对应更新。

在 SeedVR2 方向，v0.38.0 增加了：

• • SeedVR2 优化。

在 Yue 系列方向，更新包括：

• • Yue2 自回归生成加速。
• • 更新 sheetsage2 的 abc 创建逻辑，采用上游 yue 代码的更新内容。

在 Flux 模型家族方向，本次版本：

• • 将部分优化移植到 Flux 模型家族。

在 Lumina 模型家族方向，本次版本：

• • 降低 Lumina 家族模型的内存使用量。
• • 增加 Lumina 家族模型的 .comfy_attention 支持。

此外，v0.38.0 还增加了更广泛的 Attention 相关支持：

• • 为部分模型增加 comfy_attention。
• • 为部分模型增加 AttentionTensorContainer。

这些调整与前述“模型文件可指定每个 Block 使用的 Attention”共同构成了本次版本 Attention 处理能力的重要更新部分。

三、推理、内存、编译与硬件适配更新

ComfyUI v0.38.0 在推理效率、内存处理、模型编译以及硬件适配方向带来了多项调整。

在 Ace Step 1.5 自回归模型方向，新增：

• • CUDA Graphs 支持。
• • Memory Compiler 支持。

更新说明指出，这两项能力应用于 Ace Step 1.5 自回归模型。

在 NPU 支持方向，新增：

• • 异步权重卸载流支持。

该项更新属于 NPU 相关能力扩展，用于支持异步的权重卸载流。

在量化格式支持方向，新增：

• • W6A8 量化格式支持。

在 AMD 硬件架构识别方向，新增：

• • 补充缺失的 RDNA2 架构列表项。

在模型加载和磁盘相关能力方面，v0.38.0 引入：

• • 快速磁盘检测应用到所有模型加载器。

这项更新将快速磁盘检测扩展至全部模型加载器。

此外，版本中还包含一项小型处理优化：

• • 跳过不必要的工作。

同时，还包含一项用于修复此前变更潜在回归的更新：

• • 修复可能由先前更新引入的回归问题。

以及一项针对上一项更新的后续修复：

• • 对上一项更新进行修复。

四、图像处理、RGBA 支持、VAE Tile 混合与 HDR 色彩空间更新

图像处理链路也是 v0.38.0 的重点之一，尤其是 RGBA 图像、VAE Tile、HDR 色彩空间和负值处理。

在 H3 VAE Tile 方向，新增：

• • 将 H3 VAE Tile 与已经合成的相邻区域进行混合。

该项更新涉及 H3 VAE 的 Tile 处理与相邻合成区域之间的混合逻辑。

在图像放大节点方向，修复：

• • ImageUpscaleWithModel 处理 RGBA 图像时崩溃的问题。

这一修复与 Qwen VL 的 RGBA 输入修复共同覆盖了不同流程中的四通道图像处理问题。

在色彩空间转换节点方向，新增：

• • Convert Color Space 节点支持 HDR LogC3。
• • Convert Color Space 节点支持 ACEScct。

同时，修复：

• • Convert Image Color Space 在 HDR 输出时处理负值的问题。

此次更新让 Convert Color Space 节点新增 HDR LogC3 与 ACEScct 两种色彩空间支持，并针对 HDR 输出中负值相关的问题进行了修正。

五、节点、工作流模板与文本生成能力更新

ComfyUI v0.38.0 还带来了节点能力、搜索体验、文本生成接口和工作流模板方面的多项变化。

在 TextGenerate 节点方向，新增：

• • system_prompt 输入项。
• • 独立的 thinking 输出项。

这意味着 TextGenerate 的输入中新增了 system_prompt，并将 thinking 作为独立输出提供。

在 JsonExtractString 节点方向，增强：

• • JsonExtractString 现在可以处理带有前缀和或后缀的 JSON 内容。

在节点搜索体验方面，更新后：

• • 搜索 kitchen 时可以返回 Attention 节点。

在 Comfy Kitchen 相关内容上，更新包括：

• • Comfy Kitchen 软件包版本更新至 0.2.36。

在工作流模板方面，本次版本连续进行了三次模板更新：

• • 工作流模板更新至 v0.11.68。
• • 工作流模板更新至 v0.11.69。
• • 工作流模板更新至 v0.11.70。

这些模板版本更新均包含在 v0.38.0 的发布说明中。

六、资产系统与 SQLite 数据库稳定性更新

资产系统是本次版本优化较为集中的模块之一，涉及资产扫描、写事务、锁竞争、启动行为、失败路径和界面响应性。

首先，在 SQLite 写锁处理方面，v0.38.0 增加：

• • 在资产扫描和输出注册写入操作开始时提前获取 SQLite 写锁。

同时，进一步调整：

• • 将文件读取操作移出剩余的资产写入事务。

这两项变更分别涉及写锁获取时机与资产写事务内部的文件读取处理。

在数据库启动阶段，修复：

• • 启动时短暂等待数据库锁的问题。

在资产目录扫描性能方面，新增：

• • 使用替代 pathlib 前缀检查的方式进行资产扫描性能优化。

在界面响应方面，新增：

• • 资产扫描和输出重新扫描时，通过列出文件夹保持界面响应。

在资产目录失败处理方面，更新包括：

• • 强化资产目录的失败路径处理。
• • 即使缺少资产软件包，也可以启动。
• • 使用 --enable-assets 时，会报告缺失内容，并在资产功能被禁用的状态下运行。

这一组更新覆盖了资产系统在缺少软件包、扫描文件、扫描输出、处理失败路径、启动数据库锁以及写入事务等多个环节。

七、合作节点模型更新：腾讯、Quiver、Anthropic、Recraft、OpenAI、字节跳动与 Sora

v0.38.0 对多个合作节点的模型列表进行了更新，涉及图像生成、图像编辑、推理强度配置、语言模型和视频模型等内容。

腾讯合作节点新增：

• • Hunyuan Image 3.5 文生图节点。
• • Hunyuan Image 3.5 编辑节点。

Quiver 合作节点新增：

• • Arrow 2 模型。
• • reasoning effort 控件。

Anthropic 合作节点新增：

• • Claude Opus 5.5 模型。

Recraft 合作节点新增：

• • Recraft V4.1 Flash 模型。
• • 该模型被添加至 V4 文生图节点。

OpenAI 合作节点新增：

• • GPT-6 Sol 模型。
• • GPT-6 Luna 模型。

字节跳动合作节点新增：

• • Seedream 5.0 Flash。
• • Seedance 2.5 Draft 模式。

Sora 合作节点则进行了清理：

• • 移除已废弃的 Sora 节点。

八、依赖、文档与仓库维护更新

除模型、节点和系统能力外，本次版本还包含依赖精简、文档补充和仓库维护调整。

在依赖方面：

• • 移除 torchaudio 依赖。

在 README 文档方面：

• • 补充部分 ComfyUI 优化细节说明。

在仓库维护方面：

• • 更新代码所有者配置。

九、ComfyUI v0.38.0 更新内容汇总

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

为了便于快速浏览，以下对本次发布内容进行完整归纳：

• • 改进 Qwen 2.1 KV Cache 位置逻辑。
• • 编译 Qwen Image 2.1 Transformer Blocks。
• • 支持模型文件指定每个 Block 所使用的 Attention。
• • JsonExtractString 支持带前缀和或后缀的 JSON。
• • 移除 torchaudio 依赖。
• • 为 Ace Step 1.5 自回归模型加入 CUDA Graphs 与 Memory Compiler。
• • H3 VAE Tile 与已合成相邻区域进行混合。
• • 所有模型加载器加入快速磁盘检测。
• • 新增 Hunyuan Image 3.5 文生图和编辑节点。
• • 工作流模板更新至 v0.11.68。
• • TextGenerate 新增 system_prompt 输入和独立 thinking 输出。
• • MiniMax-H3 支持 Fun-ControlNet-Union 2.0。
• • 修复 MiniMax-H3 VAE 在特定卸载条件下的 rms_rope 崩溃。
• • 将部分优化移植至 Flux 模型家族。
• • 新增 Arrow 2 模型和 reasoning effort 控件。
• • Claude 节点新增 Claude Opus 5.5。
• • V4 文生图节点新增 Recraft V4.1 Flash。
• • 工作流模板更新至 v0.11.69。
• • 修复 ImageUpscaleWithModel 处理 RGBA 图像时崩溃的问题。
• • 资产扫描与输出注册写入时提前获取 SQLite 写锁。
• • 将文件读取移出剩余资产写事务。
• • 新增 Ming Image 支持。
• • 修复 Ming Image 模型保存和加载影响检测的问题。
• • 降低 Lumina 家族模型内存使用，并支持 .comfy_attention。
• • OpenAI 节点新增 GPT-6 Sol 和 GPT-6 Luna。
• • 新增 Seedream 5.0 Flash。
• • 强化资产目录失败路径处理。
• • 补充 RDNA2 架构列表。
• • NPU 支持异步权重卸载流。
• • 跳过不必要的工作。
• • 修复 Qwen VL 处理 RGBA 输入时的预处理崩溃。
• • 新增 Seedance 2.5 Draft 模式。
• • 工作流模板更新至 v0.11.70。
• • Convert Color Space 支持 HDR LogC3 和 ACEScct。
• • 修复 HDR 输出时 Convert Image Color Space 的负值问题。
• • 更新 sheetsage2 abc 创建逻辑。
• • 优化资产扫描中的路径前缀检查。
• • README 补充 ComfyUI 优化细节。
• • 支持 Qwen-Image 2.1 Tiny VAE。
• • 支持基于 Wan 2.1 与 VACE 的 ID-V2V 模型。
• • 修复潜在回归问题。
• • 移除已废弃的 Sora 节点。
• • 对 Qwen Image 2.1 FP16 激活值进行原地 Clamp。
• • 为部分模型增加 comfy_attention 和 AttentionTensorContainer。
• • 加速 Yue2 自回归生成。
• • 搜索 kitchen 时返回 Attention 节点。
• • 支持 Qwen-Image 2.1 Union Fun ControlNet。
• • Comfy Kitchen 软件包更新至 0.2.36。
• • 优化 SeedVR2。
• • 支持 W6A8 量化格式。
• • 修复上一项更新相关问题。
• • 启动时短暂等待数据库锁。
• • 缺少资产软件包时仍可启动，--enable-assets 会报告缺失内容并禁用资产功能运行。
• • 资产扫描与输出重新扫描时保持界面响应。
• • 加速 Qwen 3.5 与 Qwen 3.8 的长上下文生成。
• • 避免不必要的写入。
• • 更新代码所有者配置。

ComfyUI v0.38.0 的更新覆盖面较广，从 Qwen Image 2.1、MiniMax-H3、Wan 2.1、Lumina、Flux、Yue2 到 Ming Image、SeedVR2，再到资产扫描、SQLite、NPU、HDR 色彩空间和合作节点模型，都包含在本次发布内容之中。

·

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。

欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。

·