ComfyUI v0.28.0更新：安全修复、Qwen3-VL崩溃修复、AMD与Turing性能优化、文本叠加与3D高级保存全面升级|amd|vl|工作流|显式标识

前言

ComfyUI v0.28.0 已于 2026 年 7 月 16 日发布。从这一次更新内容来看，这是一个覆盖面非常广、实用性非常强的版本。它不仅带来了多项核心功能增强，还集中修复了多个稳定性问题、安全问题与硬件兼容问题，同时对 Partner Nodes、工作流模板、内嵌文档、前端包与 OpenAPI 合约也做了同步升级。

如果用一句话来概括这次版本更新，那么可以说：ComfyUI v0.28.0 是一次围绕“稳定性、安全性、模型兼容性、硬件性能以及节点能力扩展”展开的综合型大版本升级。

一、版本总览：ComfyUI v0.28.0更新重点看什么

从更新条目可以看出，v0.28.0 的重点主要集中在以下几个方向：

• 文档与规范文件持续完善
• 安全漏洞修复
• Qwen3-VL、llama_template、参考图编码等模型兼容问题修复
• 文本模型采样、小模型量化推理、Turing 显卡性能继续优化
• AMD ROCm、Triton、Flash Attention 相关适配与回滚调整
• 新增文本覆盖、保存文本、保存 3D 高级节点、边界框输入等核心节点能力
• 视频、图像、3D、VAE 等多模块稳定性修复
• 新增多个合作节点能力，同时移除部分旧合作节点
• 工作流模板、内嵌文档、前端包、OpenAPI 合约同步升级

换句话说，这不是一次单纯只加新功能的版本，而是一次非常典型的“功能增强 + 稳定修复 + 性能打磨 + 生态同步”综合更新。

二、文档与规范体系持续强化

本次更新中，一个非常显眼的现象就是AGENTS.md相关内容被多次更新。这说明项目在规范化、协作说明和自动化流程约束方面持续加强。

1. AGENTS.md 多次新增与更新

本次更新中包含了以下几类相关改动：

• 新增 AGENTS.md
• 向 AGENTS.md 补充更多内容
• 多次更新 AGENTS.md
• 尝试让代码审查机器人强制遵守 AGENTS.md

这意味着 ComfyUI 正在逐步把项目协作规范、开发流程约束、机器人行为指引等内容，统一沉淀到 AGENTS.md 中。对于贡献者和自动化工具来说，这种做法有利于减少协作偏差，也让后续开发流程更可控。

2. 添加 CLAUDE.md 软链接到 AGENTS.md

更新中还曾加入了一个CLAUDE.md 指向 AGENTS.md 的软链接。不过随后又有一条更新显示：

• 删除会破坏更新流程的软链接

这说明项目团队在尝试文件兼容方案时，发现符号链接会影响更新机制，因此后续又进行了回退处理。这个细节也反映出本次版本不仅在加内容，也在不断校正方案实现方式。

3. 增加 CLA Assistant 工作流与更新 cla.yml

与协作规范有关的另一类更新包括：

• 添加 CLA Assistant 工作流
• 更新 cla.yml

这进一步说明项目在贡献协议签署、自动化检查和社区治理流程上进行了完善。

三、安全更新：一次性修复四个漏洞

对于生产环境和长期部署用户来说，本次最值得关注的内容之一就是安全修复：

• 修复四个安全漏洞

这一更新明确表明 v0.28.0 不只是功能型升级，也是安全型升级。对于暴露 API、开放远程访问、部署在团队内网或公网环境中的 ComfyUI 用户来说，及时升级具有现实意义。

此外，Partner Nodes 中还有一项与日志安全直接相关的修复：

• 在日志中屏蔽授权请求头

这属于非常典型的安全细节增强。日志如果保留 Authorization 信息，可能带来凭据泄露风险。此次修复能够降低敏感信息被记录到日志中的可能性。

四、模型与编码兼容性修复：Qwen3-VL、llama_template、参考图、PID 1.5、convrot int4全面覆盖

本次版本在模型兼容性方面的修复非常多，而且都是实际使用中比较容易踩坑的问题。

1. 修复 Qwen3-VL 自定义嵌入导致的 tokenizer 崩溃问题

更新中明确提到：

• 修复 Qwen3-VL 在使用自定义 embeddings 时 tokenizer 崩溃的问题

这类问题通常会直接造成工作流中断，因此属于影响实际生产效率的严重兼容性问题。对于正在使用 Qwen3-VL 的用户来说，这一修复价值很高。

2. 修复 llama_template 模型加载 embedding 时的报错

另一条相关修复是：

• 修复在使用 llama_template 的模型中加载 embedding 时出现错误的问题

这与上面的 Qwen3-VL 相关修复共同说明，本次版本对文本编码链路、嵌入加载路径与多模型兼容场景进行了有针对性的补强。

3. 修复 qwen3vl 作为文本编码模型时参考图像的问题

更新还提到：

• 修复 qwen3vl 在作为 text encode 模型使用时参考图像异常的问题

这条修复与多模态输入链路直接相关，说明项目对 Qwen3-VL 的适配不仅停留在崩溃修复层面，也涉及参考图像处理逻辑的正确性。

4. 支持 convrot int4 模型

本次新增：

• 支持 convrot int4 模型

这说明在量化模型兼容上，ComfyUI 继续向更广的模型形态扩展。

5. 支持 PID 1.5 模型

更新中还有：

• 支持 PID 1.5 模型

这同样属于模型生态兼容扩展的一部分。

6. 修复 hidream o1 回归问题

版本中还包含：

• 修复 hidream o1 回归问题

这类“回归修复”说明在此前版本中某些已有能力被新变更影响，本次更新进行了纠正，避免原有功能继续受损。

五、性能优化与推理效率提升：文本采样更快，Turing 的 int8/int4 表现持续增强

v0.28.0 中有不少与性能优化相关的内容，尤其集中在文本模型采样、低比特量化推理以及特定显卡平台表现上。

1. 文本模型采样小幅提速

更新中明确提到：

• 文本模型采样有小幅速度提升

虽然描述为“小幅”，但这类底层采样优化通常会频繁影响推理过程，累积下来依然有较强的体感价值。

2. 更优化的 Turing 平台 int8 和 int4 表现

更新后期还加入了：

• 在 Turing 平台上对 int8 与 int4 进行更多优化

这表明项目对老一代但仍被大量用户使用的显卡平台保持持续照顾，而不是只围绕最新硬件做优化。

3. 修复 16xx 系列 int8 性能回退

除了新增优化，还有一项非常关键的纠偏：

• 修复 16xx 系列的 int8 性能回退

这对使用 GTX 16 系列设备的用户尤为重要，因为性能回退往往意味着更新后实际速度变慢，而此次修复可视为恢复体验的重要补丁。

4. 修复 Turing 上使用 int4 模型出现黑图

更新中还提到：

• 修复在 Turing 上使用 int4 模型时出现黑图的问题

这不是单纯性能问题，而是功能正确性问题。量化推理如果直接输出黑图，会严重影响可用性。因此，这条修复与 int4 支持扩展共同构成了一组很重要的量化模型稳定性增强。

六、AMD 与 ROCm 适配：默认启用、限定启用、临时禁用与 Flash Attention 修复并行推进

如果说本次更新中哪个硬件方向的调整最密集，那么答案很可能是 AMD / ROCm。

1. 默认启用 comfy-kitchen Triton 后端

更新一度引入了：

• 在 ROCm/AMD 上默认启用 comfy-kitchen Triton 后端

这是一个明显的积极推进动作，意味着项目在尝试将 AMD 平台的加速链路更深入地整合到默认行为中。

2. 仅在支持矩阵核心的 GPU 上自动启用

随后又追加了更谨慎的限定：

• 仅在具备 matrix-core 的 GPU 上自动启用 ROCm comfy-kitchen Triton 后端

这个调整说明项目发现并不是所有 AMD 设备都适合统一自动打开该能力，因此增加了硬件条件判断。

3. 临时禁用 AMD 平台默认自动启用 Triton

紧接着又有一条更新表示：

• 临时禁用在 AMD 上默认自动启用 Triton

这说明项目团队在实际验证中可能发现仍存在兼容性或稳定性问题，因此选择先回退默认策略。这种“先推进，再约束，再临时关闭”的变化轨迹，说明 AMD 适配仍处在快速迭代中。

4. 尝试修复 AMD 上与 Flash Attention 相关的问题

除此之外，本次还有：

• 尝试修复 AMD 平台上与 Flash Attention 相关的问题

这进一步表明，AMD 相关更新并不是孤立的一条配置改动，而是一整组围绕底层推理后端与注意力机制兼容性展开的修正。

七、核心节点功能增强：文本叠加、保存文本、保存 3D 高级节点、边界框输入上线

本次更新除了大量修复之外，也加入了多个实际可用的新节点能力。

1. 实现基础文本叠加节点

更新中提到：

• 实现基础文本叠加节点

这是一个非常直观、非常实用的功能增强。它意味着在工作流中可以直接进行基础文字覆盖处理，适用于标注、说明、水印式处理或可视化辅助输出。

2. 新增 Save Text 节点

版本中新增：

• Save Text 节点

这个节点的加入，使文本结果落盘能力更加直接，也让部分依赖外部脚本的文本保存流程可以进一步简化。

3. 为 Create Bounding Boxes 节点增加 bboxes 输入

更新中还包括：

• 为 Create Bounding Boxes 节点增加 bboxes 输入

这显然提升了边界框节点在工作流编排中的灵活性，使其更适合被上游结果直接驱动。

4. 新增 Save 3D Advanced 节点家族

另一项重要增强是：

• 新增 Save 3D Advanced 节点家族

这意味着 3D 输出相关能力得到扩展，尤其是在更高级的保存场景中，用户会有更明确和更丰富的节点支持。

5. 文本节点取消“废弃”状态

此外还有：

• 取消文本节点的废弃状态

这一改动非常值得注意。它表明文本节点重新被明确纳入可持续支持范围，对于依赖文本节点构建流程的用户来说是一种正向信号。

6. 更新预览节点

同时还做了：

• 更新预览节点

这属于界面交互与流程可视化层面的同步改进。

八、视频、图像与色彩处理修复：从音频解码到单通道保存再到 HLG 夹紧修正

图像与视频链路上，这次也有不少细节修复。

1. 修复视频中存在不可解码音频流时的崩溃问题

更新中提到：

• 修复视频节点在遇到无法解码的音频流时崩溃的问题

对于视频工作流而言，这个问题很典型，因为很多来源复杂的视频素材可能携带异常音轨。现在即使音频流不可解码，也不应导致整个流程直接崩溃。

2. 修复颜色选择器设置透明度时的 bug

更新还包括：

• 修复颜色选择器设置透明度时出现的问题

虽然是一个界面层小问题，但它直接关系到实际编辑体验，尤其是处理叠加、透明背景或图层类工作流时。

3. 修复 HLG inverse-OETF 夹紧错误

图像处理部分还有：

• 修复 hlg_to_linear 中 HLG inverse-OETF 的 clamp 错误

这属于更偏底层的图像变换正确性修复，对色彩还原与线性化处理有直接影响。

4. Save Image Advanced 支持单通道图像

另一条实用更新是：

• 在 Save Image Advanced 中支持单通道图像

这提升了高级保存节点对灰度图、mask 图等单通道数据的兼容性。

5. 修复 SaveVideo 描述错误

更新中还特别指出：

• 修复 SaveVideo 的描述文案，原先写成保存 images，实际保存的是 video

这是一个文档和界面描述层的纠正，虽然不影响底层功能，但有助于减少误解。

九、模型加载、动态补丁与 VAE 相关修复

在模型生命周期管理和 VAE 相关稳定性方面，本次版本也给出了多项修复。

1. 当前工作流中跳过卸载动态模型 patcher

更新中有一条很重要：

• 在当前工作流中跳过卸载动态模型 patcher

这说明在特定场景下，模型补丁器的卸载行为可能会影响工作流运行或切换稳定性，因此进行了调整。

2. 尝试修复部分用户遇到的模型重新加载问题

本次还有：

• 尝试修复一些用户遇到的模型重新加载问题

虽然描述带有“尝试”字样，但能列入正式更新说明，说明该问题已经被认真处理。

3. 修复 VAE.is_dynamic() 的 AttributeError

更新中还提到：

• 修复在没有 patcher 的 VAE 对象上调用 VAE.is_dynamic() 时产生的 AttributeError

这是典型的健壮性修复，能够避免某些非常具体但确实会导致流程中断的异常。

4. 尝试修复 seedvr VAE 的一些问题

此外还包括：

• 尝试修复 seedvr VAE 的一些问题

这意味着与 SeedVR2 相关的底层支持不仅有新增功能，也在继续做兼容打磨。

十、注意力机制与后端兼容：GQA全面支持，并放弃 PyTorch 2.4

底层计算图与后端兼容上，本次也有关键动作。

1. 所有 attention backend 支持 GQA

更新中写到：

• 在所有 attention backend 上支持 gqa

这是一项重要的后端一致性增强。它表明不同注意力后端在能力上更加趋于统一，减少了用户在切换后端时的功能差异。

2. 停止支持 PyTorch 2.4

同一条更新还提到：

• 取消对 PyTorch 2.4 的支持

这意味着项目在底层依赖策略上进行了取舍。通常这种变更意味着维护复杂度、兼容性成本或新特性需求之间做了平衡。

3. 修复 UNetSelfAttentionMultiply 崩溃

此外：

• 修复使用 UNetSelfAttentionMultiply 时的崩溃问题

这与注意力模块稳定性直接相关，属于比较关键的运行时修复。

十一、路径、参数与 API 能力增强

除了图像和模型能力外，本次还对启动参数、测试环境、API 输出等做了增强。

1. 增加 models-directory 启动参数

更新中新增：

• 添加 models-directory 启动参数

这使模型目录管理更加灵活，对于多模型目录、定制化部署或容器化环境更有帮助。

2. 允许 comfy-api-base 指向临时测试环境

另一条更新为：

• 允许 --comfy-api-base 目标指向临时测试环境

这显然是为了适应测试、联调或短生命周期环境的接入场景。

3. 在 /experiment/models 暴露有效扩展过滤器

更新中还提到：

• 在 /experiment/models 上暴露有效扩展过滤器

这属于 API 能力补强，有利于客户端根据实际过滤结果进行更准确的模型发现与展示。

4. 同步共享 OpenAPI 合约

同时还有：

• 同步共享 API 合约

这表明接口规范层也跟随本次版本进行了更新。

5. 修复在 prompt 没有 client_id 时作业结果缺少缓存输出的问题

更新中还修复：

• 当 prompt 没有 client_id 时，作业结果中缓存输出缺失的问题

这是非常典型的 API / 任务结果稳定性修复，能让无 client_id 场景的结果返回更加完整。

十二、3D 相关能力继续完善：保存、路径校验、API模式崩溃修复

v0.28.0 在 3D 方向也有多条明确更新。

1. Save 3D Advanced 节点家族上线

前文提到的新功能中已经包含：

• Save 3D Advanced 节点家族

这是 3D 输出能力扩展的核心内容。

2. 修复 Load3D 路径校验因双重解析失败的问题

更新中修复了：

• Load3D 因路径双重解析导致路径校验失败的问题

这属于典型的路径处理 bug，尤其在复杂目录结构或自动化环境里更容易出现。

3. 修复 3D 高级节点在 API 模式下崩溃

另一条重要修复是：

• 修复 3D advanced 节点在 API 模式（无 UI）下崩溃的问题

这说明 3D 节点的使用场景已不局限于图形界面，也覆盖到纯接口调用模式，而本次对此进行了补强。

十三、Partner Nodes 更新：新增、修复、移除并行推进

本次版本中，Partner Nodes 部分更新非常丰富，涉及多个合作方向。

1. ByteDance 方向更新

包括以下内容：

• 新增对 Seed Audio 1.0 的支持
• 调整 ByteDance 类别名称
• 新增对 Seedream 5 Pro 模型的支持
• 在 Seedream 节点中增加禁用 thinking 的控件

2. StabilityAI 节点移除

更新中提到：

• 移除 StabilityAI 节点

3. Ideogram 旧节点移除

包括：

• 移除 IdeogramV1 和 IdeogramV2 节点

这说明部分旧节点正在退出，项目生态在做精简和更新换代。

4. 腾讯相关修复

还有一条 Partner Nodes 修复：

• 恢复 Tencent3DPartNode 的 FBX 输出

这说明该节点此前的输出能力可能受到影响，本次已恢复。

5. Google 方向调整

更新中还有：

• 将 Gemini Image preview 模型重新路由到 release 版本

这属于模型目标版本调整，偏向于提高稳定性与正式可用性。

6. sync.so 支持新模型

本次也新增：

• 支持 sync-3 模型

7. 客户端请求头携带 ComfyUI Core 版本

另有一项 Partner Nodes 更新是：

• 客户端在请求头中发送 ComfyUI Core 版本

这对于服务端兼容判断、调试和版本追踪都很有帮助。

8. 日志认证信息脱敏

前面提到的安全修复同样属于 Partner Nodes：

• 在日志中屏蔽 authorization headers

十四、工作流模板、文档与前端生态同步升级

除了功能和修复，本次还包含多项生态资源同步更新。

1. 工作流模板多次升级

本次更新中，工作流模板先后升级到：

• v0.11.2
• v0.11.6
• v0.11.9

这意味着模板体系在本次发布周期内持续迭代，用户可获得更接近当前版本能力的示例和默认工作流支持。

2. 内嵌文档升级

embedded docs 也完成了两次更新：

• 升级到 v0.5.7
• 升级到 v0.5.8

文档同步通常意味着功能说明、节点说明或使用指引与当前版本更加一致。

3. 前端包升级

最后还有：

• 将 comfyui-frontend-package 升级到 1.45.21

这说明前端侧也随着本次核心版本完成了同步更新。

十五、其他修复与增强汇总

为了确保不遗漏任何一条更新内容，下面再对一些前文未单独展开或需要再次强调的项目进行汇总：

• 修复混合精度算子中，针对大于二维激活时 FP8 activation quantization 的问题
• 新增 SeedVR2 支持
• 修复 cached outputs 在 prompt 无 client_id 场景下不会出现在 job results 中的问题
• 更新共享 API 合约
• 更新预览节点
• 尝试修复模型重载问题
• 尝试修复 seedvr VAE 相关问题
• 修复 SaveVideo 的描述错误
• 取消文本节点的废弃状态

这些更新虽然分散在不同模块，但拼在一起可以看到 v0.28.0 的一个清晰特征：它不是只做某一个方面，而是在整个 ComfyUI 核心链路上进行了一次全面打磨。

十六、ComfyUI v0.28.0完整更新清单梳理

为了便于快速检索，下面按接近原始更新顺序做一次完整整理：

• 新增 AGENTS.md
• 向 AGENTS.md 增加更多内容
• 修复 Qwen3-VL tokenizer 在自定义 embeddings 下崩溃
• 继续更新 AGENTS.md
• 移除 IdeogramV1 与 IdeogramV2 节点
• 再次更新 AGENTS.md
• 修复四个安全漏洞
• 再次更新 AGENTS.md
• 新增 Seed Audio 1.0 支持
• 工作流模板升级到 v0.11.2
• 移除 StabilityAI 节点
• 再次更新 AGENTS.md
• 调整 ByteDance 类别名称
• 添加 CLAUDE.md 指向 AGENTS.md 的软链接
• 修复使用 llama_template 的模型加载 embedding 时的错误
• 尝试让代码审查机器人遵守 AGENTS.md
• 修复颜色选择器透明度设置 bug
• 日志中屏蔽授权头
• 文本模型采样小幅提速
• 内嵌文档升级到 v0.5.7
• 当前工作流中跳过卸载动态模型 patcher
• 添加 CLA Assistant 工作流
• 删除会破坏更新的软链接
• 修复视频遇到不可解码音频流时崩溃
• 实现基础文本叠加节点
• 更新 AGENTS.md
• 所有 attention backend 支持 gqa，并停止支持 PyTorch 2.4
• 修复 UNetSelfAttentionMultiply 崩溃
• 新增 models-directory 启动参数
• 修复没有 patcher 的 VAE 调用 is_dynamic 时出现 AttributeError
• 新增 Seedream 5 Pro 模型支持
• 工作流模板升级到 v0.11.6
• 为 assets 添加 namespaced model_type tags，并对齐 tag 语义
• 修复 qwen3vl 作为 text encode 模型时的参考图像问题
• 允许 comfy-api-base 指向临时测试环境
• 修复 Load3D 路径双重解析导致的校验失败
• 在 /experiment/models 暴露有效 extension filter
• 更新 cla.yml
• 支持 convrot int4 模型
• 尝试修复模型重载问题
• 修复混合精度算子中大于二维激活的 FP8 activation quantization 问题
• 在 ROCm/AMD 上默认启用 comfy-kitchen Triton 后端
• 修复 Turing 上使用 int4 模型出现黑图
• 新增 SeedVR2 支持
• 在 Seedream 节点中增加禁用 thinking 控件
• 恢复 Tencent3DPartNode 的 FBX 输出
• 仅在 matrix-core GPU 上自动启用 ROCm comfy-kitchen Triton 后端
• 新增 Save Text 节点
• 为 Create Bounding Boxes 节点增加 bboxes 输入
• 新增 Save 3D Advanced 节点家族
• 取消文本节点的废弃状态
• 更新预览节点
• 尝试修复 seedvr VAE 的一些问题
• 临时禁用 AMD 上默认自动启用 Triton
• 尝试修复 AMD 平台 Flash Attention 相关问题
• 修复 SaveVideo 描述错误
• 支持 PID 1.5 模型
• 客户端请求头发送 ComfyUI Core 版本
• 修复 hlg_to_linear 中 HLG inverse-OETF 的 clamp 问题
• Save Image Advanced 支持单通道图像
• 将 Gemini Image preview 模型切换到 release 版本
• 内嵌文档升级到 v0.5.8
• 同步共享 API 合约
• 工作流模板升级到 v0.11.9
• 修复 hidream o1 回归问题
• 进一步优化 Turing 上的 int8 与 int4
• 修复 3D advanced 节点在 API 模式下崩溃
• 修复 16xx 系列 int8 性能回退
• 新增 sync-3 模型支持
• 修复 prompt 无 client_id 时作业结果缺少缓存输出
• 前端包升级到 1.45.21

十七、总结：这是一次非常“工程化”的大版本升级

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

综合来看，ComfyUI v0.28.0 的价值主要体现在以下几个方面：

•安全性增强：一次性修复四个漏洞，同时加强日志脱敏。
•稳定性提升：修复 Qwen3-VL、llama_template、UNetSelfAttentionMultiply、VAE、视频音频流、3D API 模式等多个崩溃与异常问题。
•性能继续打磨：文本模型采样提速，Turing 平台 int8/int4 继续优化，并修复黑图与性能回退问题。
•AMD 适配快速推进：围绕 ROCm、Triton、Flash Attention 进行了多轮策略调整。
•核心节点能力扩展：新增文本叠加、保存文本、保存 3D 高级节点、边界框输入等能力。
•生态同步更新：工作流模板、内嵌文档、OpenAPI 合约、前端包与合作节点全面同步。
•项目规范更完善：AGENTS.md 与 CLA 流程持续强化，体现出更成熟的工程协作意识。