前言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.2v0.11.6v0.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 流程持续强化体现出更成熟的工程协作意识。
