> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日志

> 跟踪 ComfyUI 的最新功能、改进和错误修复。详细的发布说明请查看 [Github releases](https://github.com/comfyanonymous/ComfyUI/releases) 页面。

<Update label="v0.20.1" description="2026年4月27日">
  **新增模型支持**

  * **SUPIR：** 新增SUPIR图像超分辨率模型支持
  * **SAM 3.1：** 引入segment anything model 3.1支持，用于高级图像分割
  * **RIFE和FILM：** 新增帧插值模型，用于平滑的视频帧生成
  * **LTXV Audio VAE：** 支持独立的LTXV音频VAE模型，并改进原生集成

  **合作伙伴节点增强**

  * **视频生成：** 为ByteDance 2、Veo模型和Kling节点新增4K分辨率支持
  * **Veo 3 Lite：** 新的轻量级Veo模型版本，用于更快的视频生成
  * **SD2 Real Human：** 新增Stable Diffusion 2真人生成支持
  * **GPT-Image 2：** 新版本选项，支持更多分辨率并修复价格标签
  * **HappyHorse：** 新的模型集成，增强图像生成能力

  **性能优化**

  * 通过针对性优化提升Ernie模型推理速度
  * 采用更原生的实现方式改进LTXV音频VAE处理
  * 增强ModelPatcherDynamic，为ComfyUI层提供更好的权重处理
  * 在执行系统中添加反循环验证，提升工作流稳定性

  **视频处理改进**

  * 支持加载更高位深度的视频，确保色彩准确性
  * 视频加载支持透明度通道，实现透明度工作流
  * 为ByteDance 2节点添加自动缩放功能以优化处理性能

  **技术更新**

  * 修复SQLAlchemy版本锁定（>=2.0），改善数据库兼容性
  * 增强ComfyUI应用文件中的日志功能，便于调试
  * 新增OpenAPI 3.1规范，提供全面的API文档
  * 使用textureSize改进模糊/锐化操作的着色器处理

  **UI和前端**

  * 将ComfyUI前端更新至版本1.42.15，包含多项改进
  * 增强Preview Any节点，显示更多张量值以便更好地调试
  * 新增范围类型支持，改进节点参数处理
</Update>

<Update label="v0.20.0" description="2026年4月27日">
  **新模型支持**

  * **SUPIR模型支持：** 新增增强型超分辨率功能，用于高质量放大工作流
  * **RIFE和FILM帧插值：** 引入先进的帧插值模型，实现流畅的视频过渡效果
  * **SAM 3.1支持：** 更新Segment Anything模型，提升分割精度
  * **LTX音频VAE改进：** 增强原生音频处理功能，支持独立的LTXV音频VAE

  **性能优化**

  * 优化Ernie推理，加快生成速度
  * 新增反循环验证，防止工作流执行陷入循环
  * 改进ModelPatcherDynamic权重处理，提升模型兼容性

  **视频处理增强**

  * 支持加载更高位深度的视频，改善质量保持效果
  * 为视频加载工作流新增alpha通道支持
  * ByteDance 2节点新增自动降尺度功能，处理大型视频文件

  **合作伙伴节点更新**

  * **Veo模型：** 新增4K分辨率支持和Veo 3 Lite模型
  * **Kling节点：** 增强4K分辨率功能
  * **GPTImage：** 新增gpt-image-2版本选项和新分辨率支持
  * **HappyHorse模型：** 新的合作伙伴模型集成
  * **SD2真实人像支持：** 增强逼真人像生成能力

  **用户界面和API改进**

  * 新增OpenAPI 3.1规范，改善API文档
  * 修复模糊/锐化着色器中的纹理尺寸处理，提升效果精度
  * 增强Preview Any节点，显示更多张量值用于调试

  **错误修复**

  * 通过固定版本≥2.0修复SQLAlchemy兼容性问题
  * 解决Stable\_Zero123 cc\_projection权重的参数分配问题
  * 修正LTXV Reference Audio节点功能
  * 修复veo-3.0模型的4K分辨率限制问题
</Update>

<Update label="v0.19.3" description="2026年4月17日">
  **LTX 文本生成**

  * 在文本生成节点中为 LTX 模型实现了 `use_default_template` 功能

  **合作伙伴节点更新**

  * 新增 Quiver 的 **arrow-1.1** 与 **arrow-1.1-max** SVG 模型，增强矢量图形能力
  * 在 Hunyuan3D Text 和 Image to 3D 节点中使 "obj" 输出变为可选，以提高工作流灵活性
  * 修正了 StabilityAI 价格标识，确保 API 节点定价信息的准确性
</Update>

<Update label="v0.19.2" description="2026年4月17日">
  **性能与内存**

  * 修复了量化模型在推理过程中的内存不足（OOM）回归问题，改善了 \_apply() 操作的内存使用

  **文本生成**

  * **LTX：** 在文本生成节点中新增可禁用默认模板的选项，便于更灵活地编写提示词
  * 引入了 JsonExtractString 节点，用于在工作流中进行 JSON 数据操作

  **Bug 修复**

  * **Ernie Image：** 修正错误的类名，应使用 `ErnieTEModel_` 而非 `ErnieTEModel`

  **合作伙伴节点**

  * 为 SeeDance 2.0 模型添加了 1080p 分辨率支持，实现更高质量的视频生成
</Update>

<Update label="v0.19.1" description="2026年4月16日">
  **新模型支持**

  * [Erine Image 文生图](https://blog.comfy.org/p/ernie-image-day-0-support)
  * LLM：Ministral 模型

  **合作伙伴节点**

  * [Sonilo：为你的视频创作音乐](https://blog.comfy.org/p/comfyui-now-supports-sonilo-via-partner)

  **能力**

  * Preview as Text 节点更新：支持将任意值转换为字符串
</Update>

<Update label="v0.19.0" description="2026年4月13日">
  **模型与生成支持**

  * 增加了 LTX2 参考音频（ID-LoRA）功能支持
  * 实现了 Qwen3.5 文本生成模型，增强了 TextGenerate 节点的 8B 模型兼容性
  * 增加了 RT-DETRv4 检测模型支持，提升了目标检测能力
  * 引入了 Ace Step 1.5 XL 模型支持，具备中间数据类型兼容性
  * 增加了小型 flux.2 解码器支持，并启用了不含池化输出的 Flux 条件控制
  * 实现了 Ernie Image 模型，扩展了生成选项

  **新增节点与功能**

  * 新增 CURVE 节点，用于工作流中的高级曲线操作
  * 引入了 Number Convert 节点，改进了大数字的精度处理
  * 新增 Image Histogram 节点，提供图像分析功能
  * 实现了 Color Adjustment 节点，使用零默认值
  * 增强了 GLSL 着色器节点，支持曲线输入并提高了统一变量限制
  * 为具有交互式 UI 元素的节点添加了 has\_intermediate\_output 标志

  **内存与性能**

  * 集成了 RAM 缓存与模型 RAM 管理，提升了效率
  * 增强了固定内存统计和模型内存处理
  * 修复了模糊和锐化节点与 FP16 中间数据的兼容性
  * 改进了 ImageUpscaleWithModel 中间设备操作的内存管理

  **API 与合作伙伴节点**

  * 更新了 xAI Grok 节点，增强了功能
  * 新增 Topaz 模型集成
  * 引入了 WAN2.7 节点，扩展了工作流功能
  * 新增 SeeDance 2.0 节点，增强了视频生成功能
  * 更新了 Tencent3D 节点，改进了功能特性

  **错误修复与稳定性**

  * 修复了 Train LoRA 在 training\_dtype 为 "none" 和 bfloat16 LoRA 权重时的崩溃问题
  * 解决了 LTXAV 模型的文本生成回归问题
  * 修复了 FP8 缩放检查点兼容性问题
  * 改进了不安全浏览器的浏览器安全处理
  * 修复了 SVG 文件 MIME 类型注册，确保正确的文件处理

  **基础设施更新**

  * 将管理器版本升级至 4.1，功能得到改进
  * 将前端更新至版本 1.42.10，增强了稳定性
  * 增加了 Intel XPU 便携版本支持
  * 将工作流模板更新至版本 0.9.47
  * 增强了输出文件的资源注册系统
</Update>

<Update label="v0.18.2" description="2026年3月25日">
  \*\*合作伙伴节点 (API) \*\*

  * Grok 参考生视频
  * Grok 视频扩展
  * [相关博客](https://blog.comfy.org/p/grok-imagine-model-feature-updates)
</Update>

<Update label="v0.18.1" description="2026年3月23日">
  **FP16 支持修复**

  * 修复了 Canny 节点与 FP16 精度的兼容性问题，解决了使用16位浮点运算时的工作流问题
  * 解决了 FP16 中间结果导致生成结果不一致的采样问题
  * 修复了 FP16 中间结果产生与预期不同结果的问题，确保跨运行的一致性输出

  **VAE 改进**

  * 修复了 WAN VAE 处理中的光照和颜色问题，提升了输出质量和色彩准确性
</Update>

<Update label="v0.18.0" description="2026年3月21日">
  **内存与性能优化**

  * 添加了`--fp16-intermediates`标志，在操作间使用FP16处理中间值，减少显存使用量
  * 通过原地输出处理和分块编码器实现，大幅减少LTX和WAN VAE模型的显存占用
  * 改进了分块解码的峰值内存使用，修复了视频VAE分块回退中的显存泄露
  * 通过comfy-aimdo更新(0.2.11-0.2.12)增强了Windows下的内存压力释放策略
  * 添加了`--enable-dynamic-vram`选项来强制启用动态显存管理

  **模型与硬件支持**

  * 添加了对mxfp8精度格式的支持，增强模型兼容性
  * 为AMD gfx1150 (Strix Point) GPU启用了PyTorch注意力机制
  * 通过FP4、8、16原生数据类型支持和量化线性自动求导函数增强训练能力
  * 修复了文本编码器兼容性问题，禁用了Hunyuan3D v2.1 DiT模型的SageAttention

  **节点与API增强**

  * 修复了腾讯TextToModel和ImageToModel API节点
  * 添加了Nano Banana 2的"thought\_image"支持和Quiver SVG节点
  * 将seedream-3-0-t2i和seedance-1-0-lite模型标记为已弃用
  * 添加了slice\_cond和基于模型的上下文窗口条件调整功能
  * 增强了EmptyLatentImage和EmptyImage节点以遵循中间数据类型设置

  **前端与基础设施**

  * 将前端包更新至版本1.41.21，改进了缓存头以防止过期块
  * 添加了CacheProvider API以支持外部分布式缓存
  * 实现了用户数据的原子写入以防止崩溃时的数据丢失
  * 增强了节点和蓝图的基础分类支持
  * 将工作流模板更新至版本0.9.26

  **错误修复与稳定性**

  * 修复了像素空间VAE兼容性问题和退出时的模型终结器执行
  * 改进了加载扩散模型节点中的权重数据类型处理（标记为高级输入）
  * 增强了子类模型的延迟权重初始化
  * 修复了罕见边缘情况下的各种内存泄露和损坏问题
</Update>

<Update label="v0.17.2" description="2026年3月15日">
  此版本专注于稳定性和错误修复。完整的技术详细信息请查看 GitHub 上的[完整更新日志](https://github.com/Comfy-Org/ComfyUI/compare/v0.17.1...v0.17.2)。
</Update>

<Update label="v0.17.1" description="2026年3月13日">
  这是一个补丁版本，包含各种错误修复和稳定性改进。有关此版本中包含的更改的完整详细信息，请查看v0.17.0和v0.17.1之间的完整更新日志对比。
</Update>

<Update label="v0.17.0" description="2026年3月13日">
  **架构与性能改进**

  * 实现了模块化资产架构，采用异步两阶段扫描器和后台播种器以提升加载性能
  * 添加了 Python 故障处理程序，改善调试和稳定性
  * 增强了 KV 缓存模型的内存使用优化
  * 改进了动态 VRAM 处理，提供更好的 AcceleratorError 兼容性错误管理

  **模型支持与增强**

  * 通过 FluxKVCache 节点添加了对 Flux 2 Klein KV 缓存模型的支持
  * 增强了模型补丁系统，为 Flux 模型提供清理函数和预注意力补丁
  * 为 Qwen 图像模型添加了预注意力和后输入补丁
  * 修复了包装模型的文本编码器 LoRA 加载问题
  * 改进了批处理，修复了各种模型在 batch\_size > 1 时的问题

  **新节点与功能**

  * 添加了 Painter 节点，增强图像编辑功能
  * 引入了 Reve Image API 节点，扩展功能范围
  * 将工作流模板更新至版本 0.9.21
  * 增强了渐变停靠点格式化，提升前端兼容性

  **错误修复与稳定性**

  * 修复了音频提取和截断问题
  * 解决了深度克隆预编辑权重的模型检测问题
  * 改进了 ComfyUI Manager 安装指导，更新至版本 4.1b2
  * 增强了包版本报告，便于故障排除

  **前端更新**

  * 前端包更新至版本 1.41.18，包含各种改进和错误修复
  * 将 comfy-kitchen 更新至版本 0.2.8，comfy-aimdo 更新至版本 0.2.10
</Update>

<Update label="v0.16.4" description="2026年3月7日">
  **新增节点和功能**

  * 新增数学表达式节点，支持使用simpleeval评估进行工作流中的数学运算
  * 引入TencentSmartTopology API节点，增强拓扑处理能力
  * 在LLM节点中新增Gemini 3.1 Flash-Lite模型支持，扩展AI语言模型选项

  **错误修复和性能优化**

  * 修复fp16音频编码器模型兼容性问题
  * 解决启用动态显存时文本编码器CPU执行的问题
  * 修复依赖版本冲突问题
  * 通过在释放缓冲区前进行计算流同步，增强内存管理

  **工作流模板**

  * 工作流模板更新至0.9.11版本，包含最新改进
</Update>

<Update label="v0.16.3" description="2026年3月5日">
  **LTX Audio 模型改进**

  * 修复了 LTX2 vocoder conv\_transpose1d 的手动类型转换问题，提高了音频处理稳定性
  * 解决了 LTX audio VAE novram 兼容性问题，改善了音频生成过程中的内存管理
  * 为 add\_keyframe\_index 和 append\_keyframe 函数添加了 causal\_fix 参数，增强了视频工作流中关键帧处理的精度
</Update>

<Update label="v0.16.2" description="2026年3月5日">
  **核心更新**

  * 将 comfy-aimdo 更新到 0.2.7 版本，改进了 AI 模型操作
  * 增强了 VBAR caster 中的 CPU 权重处理，在不同硬件配置下提供更好的性能

  **工作流模板**

  * 将工作流模板更新到 0.9.10 版本，包含最新的改进和优化
  * 代码重构改进，增强了稳定性
</Update>

<Update label="v0.16.1" description="2026年3月5日">
  **API 节点更新**

  * 更新了 xAI 模型和定价，以改进成本管理和模型选择
  * 启用了 Kling 3.0 Motion Control，增强视频生成功能

  **工作流模板**

  * 工作流模板更新至 0.9.8 版本，包含最新改进和优化
</Update>

<Update label="v0.16.0" description="2026年3月5日">
  **新节点和功能**

  * 添加了 ResolutionSelector 节点，支持宽高比预设，便于设置图像尺寸
  * 引入了 CURVE 类型支持，用于高级参数控制
  * 为作业 API 添加了文本预览支持，改善工作流监控
  * 原生 LongCat-Image 实现，增强图像处理能力

  **模型和格式支持**

  * 为 LoKR 兼容性添加了 ACE-Step 1.5 lycoris 键别名映射
  * 支持 SDPose-OOD 模型
  * 添加了 SCAIL WanVideo 模型支持
  * 支持 zeta chroma 权重加载
  * 添加了 LTXAV 2.3 模型支持
  * Z-image 像素空间支持实现

  **内存和性能**

  * 动态 VRAM 模式现已成为默认设置，提高内存效率
  * 为非 QuantizedTensor fp8 实现了 LoRA 重新量化
  * 增强了动态卸载启发式算法，提升性能
  * 更新 comfy-aimdo 至 0.2.6 版本，改进分配器处理
  * 修复了动态 VRAM 与权重钩子的冲突以及 WSL 兼容性问题

  **API 和 UI 改进**

  * 在 NanoBanana2 API 节点中添加了"IMAGE+TEXT"支持
  * 将 Mahiro CFG 重命名为 Similarity-Adaptive Guidance 以提高清晰度
  * 修复了 GLSL 节点输入维度要求
  * 增强了 VAEDecodeAudioTiled，正确使用 tile\_size 输入

  **错误修复**

  * 修复了 WanVAE 编码器/解码器在 feat\_map 处理中的混淆问题
  * 解决了缺少 lm\_metadata 时 ACE-1.5 内存估算问题
  * 修复了子步长 sigma 的上下文窗口步长处理
  * 防止 VideoFromComponents 写入 BytesIO 时崩溃
  * 限制图像瓦片重叠以防止处理问题

  **工作流模板**

  * 工作流模板更新至 0.9.7 版本
</Update>

<Update label="v0.15.1" description="2026年2月26日">
  **错误修复与稳定性**

  * 修复了当提示条目缺少 class\_type 键时的 KeyError，防止工作流崩溃
  * 解决了 GLSL 节点与 pyopengl accelerate numpy 纹理的兼容性问题
  * 修复了 LTXAV 文本编码器最小长度和内存估算问题
  * 在使用 torch 编译器时禁用动态 VRAM 以防止冲突

  **模型与 API 更新**

  * 将 comfy aimdo 更新至 0.2.2 版本，改进了后备处理机制
  * 添加了基于 WanVideo 的分割模型 FlowRVS 支持，用于高级视频处理
  * 添加了 NanoBanana2 API 节点以扩展功能
  * 修复了 Aimdo 后备机制以防止零拷贝 sft 问题

  **UI 与前端**

  * 修补前端至 1.39.19 版本，修复了 API 节点中进度文本序列化问题
  * 将 essentials\_category 移至正确的替换节点以更好地组织

  **新功能**

  * 在自注意力机制中添加了每个引导的注意力强度控制，实现精细的工作流控制
  * 将工作流模板更新至 0.9.4 版本
</Update>

<Update label="v0.15.0" description="2026年2月24日">
  **新节点和功能**

  * 添加了 BBox 小部件，用于在图像工作流中精确选择边界框
  * 引入了 3 段均衡器节点，用于音频处理工作流
  * 添加了基础文本生成支持，支持原生模型，最初支持 Gemma3 和 Qwen 3
  * 新增使用 PyOpenGL 的 GLSL 着色器节点，用于高级视觉效果
  * 添加了 ElevenLabs API 节点，实现文本转语音功能
  * 为 FLOAT 输入新增渐变滑块显示模式，改进了用户界面
  * 添加了 SplitImageToTileList 和 ImageMergeTileList 节点，用于分块处理工作流

  **API 节点**

  * 为 Rodin Gen-2 节点添加了价格标签
  * 添加了用于头像生成的 KlingAvatar 节点
  * 添加了 ByteDance Seedream-5 模型支持
  * 使用通配符匹配修复了 Gemini 图像 MIME 类型处理
  * 强制 Gemini 返回未压缩图像以获得更好的质量

  **性能和错误修复**

  * 通过限制重新量化的返回，修复了 FP8 动态 VRAM 工作流性能问题
  * 解决了视频保存操作中非连续音频波形崩溃问题
  * 修复了 LTXAV 模型加载问题，包括 fp8 检查点支持和嵌入连接器数据类型问题
  * 改进了对 PyOpenGL 版本 \< 3.1.4 的兼容性

  **界面改进**

  * 将 429 个小部件标记为高级，以支持可折叠界面
  * 添加了 essentials\_category，便于节点组织
  * 通过改进分类增强了基本子图蓝图
  * 前端更新至版本 1.39.16

  **模型支持**

  * 通过分词改进和最小长度强制增强了文本生成功能
  * 更新了 LTXAV av 嵌入连接器集成
  * 在迁移期间为 LTX 2.0 工作流提供临时兼容性修复
</Update>

<Update label="v0.14.2" description="2026年2月18日">
  **错误修复**

  * 修复了 Gemini/Nano banana API 节点有时返回空白图像的问题，提高了 AI 驱动图像生成工作流的可靠性。
</Update>

<Update label="v0.14.1" description="2026年2月17日">
  **错误修复**

  * 修复了手动类型转换时anima LLM适配器前向传播的问题

  **新模型支持**

  * 在API节点中添加了"viduq3-turbo"模型支持
  * 添加了Recraft V4节点以增强创意工作流程

  **更新**

  * 将工作流模板更新至v0.8.43
</Update>

<Update label="v0.8.1" description="2026年1月8日">
  **模型支持**

  * 添加了Gemma 12B支持，包含量化权重
  * 增强了LTXAV文本编码器，支持设备选择并降低了显存使用量
  * 改进了LTXAV文本编码器的内存估算

  **性能改进**

  * 修复了FP8MM卸载的性能问题
  * 为过时的PyTorch版本添加了警告提示，建议升级到cu130以提升性能
  * 更新了comfy kitchen版本要求

  **错误修复**

  * 修复了稳定版本工作流，确保正确拉取最新的comfy kitchen更新
  * 从模型补丁器中删除了令人困惑的加载统计信息
  * 将工作流模板更新到v0.7.69
</Update>

<Update label="v0.8.0" description="2026年1月7日">
  **新增模型与节点**

  * 新增 LTXV 2 模型支持
  * 新增 NVFP4 检查点支持（fp4 矩阵乘法）
  * 新增 Sage Attention 3 支持（通过 CLI 参数）

  **API 改进**

  * V3 API：公开 DynamicCombo 和 Autogrow 功能
  * API 节点：Kling Omni 支持 720p 分辨率、WAN2.6 ReferenceToVideo
  * Tripo3D：优化 face\_limit 参数处理
  * 修复 Vidu API 签名 URL 编码保留问题

  **修复**

  * 修复放大模型 CPU 卸载问题
  * 修复 LTXV2 文本编码器 lowvram 兼容性
  * 修复 fp8 处理问题
  * 修复 MPO 格式图像只使用第一帧
  * 根据 PyTorch 版本条件性支持 comfy-kitchen CUDA

  **其他**

  * 新增 OOM 内存摘要用于调试
  * Mahiro CFG 显示名称更新
  * 工作流模板更新至 v0.7.67
  * 代码重构与清理（CLIP 预处理、comfy-kitchen 集成）
</Update>

<Update label="v0.7.0" description="2025年12月31日">
  **新增节点**

  * 新增 ManualSigmas 节点用于采样控制
  * 新增 Kling Motion Control 节点
  * ResizeByLongerSide 支持视频处理

  **系统要求**

  * PyTorch 最低版本要求 2.4+

  **修复与改进**

  * AMD GPU 默认启用异步内存卸载
  * 修复 CPU 推理时祖先采样器噪声问题
  * 改进内存管理错误处理（pin/unpin 操作）
  * 新增上下文窗口中的 VACE 上下文处理

  **版本更新**

  * ComfyUI Frontend 更新至 v1.35.9
  * ComfyUI Manager 更新至 v4.0.4
  * 工作流模板更新至 v0.7.64

  **API 节点**

  * Gemini API：强制启用提示词增强
  * 计费系统从美元改为积分制
  * 弃用 "seededit"，更新 Seedream 节点显示名称

  **技术**

  * 图像处理节点转换为 V3 架构
  * 优化 Lumina/Z 图像模型（移除未使用组件）
</Update>

<Update label="v0.6.0" description="2025年12月24日">
  **新模型支持**

  * Qwen Image Layered
  * NewBie Image Exp0.1

  **新功能**

  * 统一工作流队列 API，提供 /api/jobs 端点进行工作流监控

  **改进**

  * 设置 API 节点默认禁用水印生成
  * 重构训练器，添加分辨率分桶功能提高训练效率
  * 增强 AMD GPU 支持
  * 扩展 Kling O1 StartEndFrame 节点持续时间范围
  * 更新 Topaz 4k 视频超分辨率功能

  **错误修复**

  * 修复在 --gpu-only 模式下 ZImageFunControlNet 的掩码连接问题
</Update>

<Update label="v0.5.1" description="2025年12月18日">
  * 新增 GPT-Image-1.5 API 节点
  * 修复 V3 节点处理回归问题
  * 改进 SA-Solver 准确性
</Update>

<Update label="v0.5.0" description="2025年12月17日">
  **新模型和功能**

  * WanMove 高级运动处理模型
  * Qwen Edit 2511 自动检测支持
  * Z-Image Fun Control Union 2.0 修复功能

  **API 节点**

  * Kling Omni Image, TextToVideoWithAudio, ImageToVideoWithAudio
  * Wan2.6 模型集成
  * Tripo3.0 模型生成

  **性能优化**

  * 改进 Z-Image 和 SD3 模型内存估算
  * 更好的 Qwen-Image VAE GPU 内存管理
  * 前端更新至 v1.34.9
</Update>

<Update label="v0.4.0" description="2025年12月10日">
  **模型支持**

  * Ovis Image 多模态图像模型
  * Kandinsky 5.0 (文本转视频/图像转视频/文本转图像变体)
  * Z-Image Alibaba PAI-Fun ControlNet 支持
  * 改进的 Z-Image FP16 兼容性
  * 为CORS标头添加PATCH方法和chroma-radiance-x0模式

  **工作流与API增强**

  * 上下文窗口修复和增强的时序处理
  * Kling API @image引用格式
  * ComfyUI-Manager pip安装支持

  **前端改进**

  * 显著改善前端加载和启动性能
  * 恢复侧边栏设置按钮
  * GPU加速的蒙版编辑器渲染
  * 改进资源卡片和队列进度面板设计
  * 为队列按钮和面包屑添加缺失节点警告UI
  * 移动端修复和各种错误修复

  **主要显存优化**

  * 时间滚动VAE为视频模型提供大幅显存减少（Hunyuan/Kandinsky）
  * 减少LoRA内存预留，特别有利于Flux2工作流
  * 修复Flux2 OOM错误，改进反量化卸载计算
  * 通过FP16处理增强LoRA计算速度
  * 优化文本编码器GPU使用，防止不必要的CPU回退

  **V3架构迁移**

  * 转换3D、音频、freelunch和mask节点到V3架构
  * 添加MatchType、DynamicCombo和Autogrow支持，提升工作流灵活性

  **错误修复与兼容性**

  * 修复直接在GPU上加载时的文本编码器回归问题
  * 解决Lumina模型中transformer\_options清除问题
  * 修复Qwen Image LoRA训练、HunyuanVideo 1.5 meanflow distil问题
  * 纠正EmptyAudio节点输入类型，确保音频工作流正确集成
  * 增强显存计算准确性，防止不必要的完全卸载
  * 支持Z-Image工作流的"transformer." LoRA前缀
  * 改进scaled FP8格式与混合量化操作的兼容性

  **桌面用户注意事项**

  * 如果您未关闭自动更新，请等待最新的桌面版本发布，它将自动更新到最新版本。
  * 如果您正在使用桌面版本**并且关闭了自动更新**，本次桌面版本可能无法自动更新到最新版本。
  * 请从[这里](https://www.comfy.org/download)下载最新的桌面版本以获取最新功能。
</Update>

<Update label="v0.3.76" description="2025年12月2日">
  **前端界面与用户体验**

  * 新界面：**节点 2.0** 公测版
  * 线性模式测试版（可通过快捷键绑定设置热键启用）
  * 子图改进和错误修复
  * 改进缺失节点体验
  * 新增工作流进度面板
  * 新增资产侧边栏

  **3D 功能**

  * 3D 节点支持全景图像
  * 将 3D 动画节点合并到 3D 节点中

  **LoRA 训练器**

  * ComfyUI 原生 LoRA 训练器支持多分辨率
  * 支持 Z-Image LoRA 训练

  **性能与模型支持**

  * 支持视频微型 VAE
  * 支持 z-image LoRA 格式
  * 默认在 Nvidia 上启用异步卸载

  **合作伙伴节点**

  * Veo3 First-Last-Frame 节点
  * 在 Kling FirstLastFrame 节点中添加 Kling v2.5 turbo
  * Kling O1 模型支持
</Update>

<Update label="v0.3.75" description="2025年11月26日">
  **新模型支持**

  * 添加 Z Image 模型支持，优化图像处理工作流性能

  **错误修复**

  * 修复 LoRA 在混合 FP8 精度模型下的功能问题
  * 增强 Flux2 参考图像内存估算，减少显存错误
</Update>

<Update label="v0.3.73" description="2025年11月26日">
  **错误修复**

  * 修复可能中断工作流执行的关键系统崩溃问题
  * 优化 Flux 2 文本编码器显存使用，提升性能

  **模板更新**

  * 更新工作流模板至 v0.7.20，提供更好的入门示例
</Update>

<Update label="v0.3.72" description="2025年11月25日">
  **新模型支持**

  * 新增 Flux 2 模型全面支持，包括 Flux 2 Pro API 节点
  * 增强 HunyuanVideo 工作流，添加新变体和改进显示名称

  **API 和安全改进**

  * 改进 API 安全性，添加内容安全策略标头
  * 修复公共 API 访问问题和 Gemini 模型支持

  **视频处理**

  * 添加视频处理方法：`get_frame_count` 和 `get_frame_rate`，实现更好的工作流控制

  **性能优化**

  * 优化文本编码器量化，支持硬件感知检测
  * 增强量化支持，改善内存管理

  **开发者工具**

  * 为 Chroma、Qwen-Image 和 HunyuanVideo 模型添加 BlockInfo 支持

  **前端和依赖项**

  * 更新前端至 v1.30.6 并升级 Transformers 库
</Update>

<Update label="v0.3.71" description="2025年11月21日">
  **模型兼容性与增强功能**

  * **HunyuanVideo 1.5 支持**：添加了对最新版本 HunyuanVideo 模型的兼容性，扩展了视频生成能力
  * **LLAMA 文本编码器改进**：在基于 LLAMA 的文本编码器模型中添加了禁用最终归一化的功能，以便更好地自定义工作流
  * **HunyuanV3D 架构迁移**：将 Hunyuan3D 节点更新至 V3 架构，提升性能和兼容性

  **API 节点扩展**

  * **新增 Topaz API 节点**：在 ComfyUI 中直接添加了对 Topaz 视频增强工作流的支持
  * **Nano Banana Pro 集成**：通过 Nano Banana Pro 扩展 API 节点集合，增强处理能力
  * **Kling 唇形同步改进**：修复了 KlingLipSyncAudioToVideoNode 中的音频格式转换问题，确保正确处理 MP3 格式

  **图像处理与工作流改进**

  * **增强图像批处理**：修复了 ImageBatch 节点以处理不同通道数的图像，并在需要时自动添加 alpha 通道
  * **预览节点优化**：将 PreviewAny 节点重命名为"Preview as Text"，使工作流组织更加清晰
  * **工作流模板更新**：增强服务器模板处理程序，支持多包分发，改善工作流管理

  **性能与系统优化**

  * **CUDA 优化**：在较新的 CUDNN 版本中禁用不必要的解决方案，提升 GPU 性能
  * 修复了工作流命名问题，提升了复杂处理管道的整体稳定性
</Update>

<Update label="v0.3.70" description="2025年11月19日">
  **CUDA 12.6支持与分发**

  * 添加了官方CUDA 12.6发布工作流程和便携式下载支持，增强GPU兼容性
  * 更新了README文档，修正了便携式下载链接，简化安装流程

  **模型兼容性与修复**

  * **HunYuan 3D 2.0支持**：修复了兼容性问题，改进了3D模型生成工作流
  * **EasyCache改进**：解决了输入/输出通道不匹配问题，该问题影响了某些模型配置
  * 通过移除可能有害的原生自定义节点实现，增强了block swap功能

  **API节点增强**

  * **新增Gemini模型**：扩展了AI模型选项，支持文本和多模态生成工作流
  * 改进了API节点开发基础设施，更新了PR模板并将Python最低版本要求提升至3.10

  **开发与基础设施**

  * 增强了pylint配置，提高自定义节点开发中的代码质量
  * 改进了发布自动化和分发流程，确保更可靠的更新
</Update>

<Update label="v0.3.69" description="2025年11月18日">
  **内存与性能优化**

  * **默认启用锁页内存**，适用于NVIDIA和AMD GPU
  * **减少VRAM使用量**，优化Flux、Qwen和LTX-Video模型
  * 智能模型卸载，当VRAM使用增加时自动释放内存
  * 改进卸载流上的权重转换性能

  **新功能**

  * **ScaleROPE节点现已支持Flux模型**
  * 为分词器添加左填充支持
  * 在 `/history` 和 `/queue` 端点中添加 `create_time` 字段
  * Rodin3D节点迁移到新的API客户端架构

  **Bug修复**

  * 修复自定义节点导入错误（SingleStreamBlock/DoubleStreamBlock，临时修复）
  * 修复Qwen ControlNet回归问题
  * 增强量化操作，添加offload支持和稳定性改进
  * 统一所有模型的RoPE函数实现
</Update>

<Update label="v0.3.68" description="2025年11月5日">
  **模型支持**

  * 支持 [ChronoEdit 14B](https://research.nvidia.com/labs/toronto-ai/chronoedit/) 模型

  **性能与内存优化**

  * 引入**混合精度量化系统**，优化模型加载
  * 新增**RAM压力缓存模式**，在资源受限条件下智能管理内存
  * 使用固定内存加速模型卸载，支持自动低RAM硬件检测
  * 增强FP8操作：减少内存使用并修复torch.compile性能回归问题
  * 改进异步卸载速度，解决竞争条件问题
  * 修复Windows固定内存分配问题

  **新节点与执行功能**

  * **ScaleROPE节点**：支持WAN和Lumina模型的rope缩放
  * 增强子图执行功能，允许在单个工作流中多次运行
  * 改进缓存系统，正确处理字节数据和None输出

  **API节点增强**

  * 扩展LTXV API节点，支持12秒-20秒时长选项
  * 修复DALL-E 2节点中的img2img操作
  * 增强Rodin3D节点，返回正确的相对路径

  **更新**

  * 更新核心节点文档翻译（繁体中文，阿拉伯语，土耳其语）
  * 工作流模板更新至v0.2.11
</Update>

<Update label="v0.3.67" description="2025年10月28日">
  **API 节点**

  * **LTXV API 集成**：添加了新的 LTXV API 节点，支持 Lightricks LTX 视频生成
  * Network Client V2 升级，支持异步操作和取消功能
  * 将 Tripo 和 Gemini API 节点转换为 V3 架构

  **性能与兼容性**

  * 通过仅在较新的 AMD GPU 上禁用 cudnn 来改进 AMD GPU 支持
  * 修复了 API 节点中 Windows 特定的网络问题，改进重试处理

  **核心改进**

  * 增强了依赖感知缓存系统，修复了 --cache-none 在循环中的行为
  * 添加了对多维 latents 的支持
  * 添加了自定义节点发布子图端点

  **其他更新**

  * 前端升级到版本 1.28.8
  * 模板更新到版本 0.2.4
</Update>

<Update label="v0.3.66" description="October 21, 2025">
  **前端更新**

  * **子图组件编辑**：可通过新的参数面板直接编辑子图组件，无需进入子图内部
  * **模板弹窗重新设计**：重新设计模板浏览器，支持按模型标签和分类高级筛选

  **性能优化**

  * 提升工作流取消速度
  * 修复在 PyTorch 2.9 及 NVIDIA 显卡下 VAE 内存占用高出 3 倍的问题
  * 加快色度辐射处理速度并修正批量大于 1 时的问题

  **API 节点**

  * 新增 Veo 3.1 模型支持
  * 新增 TemporalScoreRescaling 节点，实现视频工作流高级时序控制

  **硬件与兼容性**

  * 禁用 AMD gfx942 GPU 的 FP8 运算
  * 优化 --fast autotune 模式下的 CUDA 内存管理

  **执行与架构**

  * ControlNet 节点迁移至 V3 架构
  * EasyCache 优化，支持正确的 batch\_slice 处理
  * merge\_nested\_dicts 功能改进，保证输入顺序正确
  * 为未使用文件新增废弃提示
</Update>

<Update label="v0.3.65" description="2025年10月14日">
  **节点架构迁移 (V3)**

  * 将核心节点迁移到 V3 架构,包括模型缩放、LoRA 提取、合成、潜在操作、SD3/SLG、Flux、放大模型和 HunyuanVideo 节点

  **音频和模型改进**

  * 新增 MMaudio 16K VAE 支持高保真音频工作流
  * 修复单声道音频错误保存为立体声问题
  * 重构模型采样代码并修复 FP8 缩放 LoRA 问题
  * 修复旧版 Stable Diffusion 检查点在新版 NumPy 上的加载问题

  **AMD GPU 优化**

  * 改进 SD/Flux VAE 操作的内存估算
  * 在 ROCm 7.0+ 上启用 RDNA4 PyTorch 注意力

  **API 节点更新**

  * 新增价格提取器并改进 Kling/Pika API 节点
  * 增强 Gemini Image API 的 aspect\_ratio 支持

  **其他更新**

  * 模板 v0.1.95,节点文档 v0.3.0
  * 修复 WAN2.2 缓存 VRAM 泄漏
</Update>

<Update label="v0.3.64" description="2025年10月8日">
  **API 节点**

  * 新增 Sora2 API 节点,支持 OpenAI 视频生成 API
</Update>

<Update label="v0.3.63" description="2025年10月6日">
  **模型兼容性增强**

  * **HunyuanVAE 支持**：新增对 HunyuanVAE 的支持，扩展了高级图像生成工作流的模型兼容性
  * **Epsilon Scaling 节点**：新增 Epsilon Scaling 节点，通过缩放预测噪声来减少扩散模型的曝光偏差，提升生成质量（基于论文 [Elucidating the Exposure Bias in Diffusion Models](https://arxiv.org/abs/2308.15321)）

  **内存和性能优化**

  * **VAE 内存泄漏修复**：修复了 VAE OOM 异常处理中 Python 调用栈持有张量引用导致的 VRAM 泄漏，显著提升低显存设备上瓦片回退的可靠性
  * **AMD 相关支持**：默认启用 TORCH\_ROCM\_AOTRITON\_ENABLE\_EXPERIMENTAL

  **API 节点更新**

  * **Kling 2.5 Turbo**：在 txt2video 和 img2video 节点中新增对 kling-2-5-turbo 的支持，并修复了模式配置问题
  * **API 节点修复**：改进了 Gemini 节点的 base64 处理，并修复了 Recraft API 节点函数中的缩进问题

  **节点架构迁移（V3）**

  * **大规模 V3 转换**：将众多节点类别迁移到 V3 架构，包括音频编码器、GITS、差分扩散、最优步数、PAG、LT、IP2P、形态学、torch compile、EPS、Pixverse、TomeSD、编辑模型、Rodin 和 Stable3D 节点，提高了工作流兼容性

  **音频系统更新**

  * **依赖清理**：移除了 soundfile 依赖并取消了 torchaudio 加载/保存操作，简化了音频处理管道

  **开发者体验改进**

  * **代码质量**：为 comfy\_api\_nodes 文件夹添加了 pylint 支持，并更新 example\_node.py 使用 V3 架构，使自定义节点开发更加一致
  * **文档更新**：为 Windows 用户增加了 AMD 安装说明，添加了 nightly PyTorch 命令

  **前端更新**

  * **子图发布工功能**： 允许将子图发布到节点库
  * **选择工具箱重设计**：重新设计了节点选择工具箱
</Update>

<Update label="v0.3.62" description="2025年10月1日">
  * **Rodin3D-Gen2 参数修复**
  * **Seedance Pro 模型支持**
</Update>

<Update label="v0.3.61" description="2025年9月30日">
  **API 节点**

  * **Rodin3D Gen-2**：Rodin 最强大的图像转3D工具现已在 ComfyUI 中上线！
  * **WAN 图生图**：Wan2.5 图生图 API 节点，支持图像编辑。

  **增强音频功能**

  * **新增音频节点**：为增强音频驱动的工作流和多模态内容创作添加了新的音频节点

  **模型兼容性修复**

  * **Qwen2.5VL 模板处理**：改进了当提示词中已包含模板时 Qwen2.5VL 模型的模板管理
  * **HuMo 视图操作**：修复了 HuMo 模型中的 .view() 操作问题，提高视频生成的稳定性

  **内存和性能优化**

  * **内存泄漏修复**：通过显式分离模型终结器解决了内存泄漏问题，提高长时间运行工作流的稳定性
  * **采样器 CFG 增强**：在采样器 CFG 函数参数中添加了 'input\_cond' 和 'input\_uncond' 参数，提供更灵活的条件控制
</Update>

<Update label="v0.3.60" description="2025年9月23日">
  **新模型支持**

  * **Wan2.2 Animate**：支持具有角色替换和动作迁移功能的 Wan2.2 Animate 视频生成模型
  * **Qwen Image Edit 2509 支持**：支持更新的 Qwen Image Edit 2509，具有多图像编辑、更高一致性和原生 ControlNet 支持
  * **HuMo 模型**：添加了对 1.7B 和 17B HuMo 模型的支持，使用音频驱动视频生成并保持唇形同步
  * **Chroma Radiance**：一个在像素空间执行图像生成的模型，减少图像生成过程中的损失
  * **Omnigen2 UMO LoRA**：添加了对 Omnigen2 UMO LoRA 模型的支持

  **API 节点新增**

  * **Kling v2.1 支持**：在 KlingStartEndFrame 节点中添加了 kling-v2-1 模型
  * **Seedream4 修复**：修复了在部分成功时忽略错误的标志，使工作流更加稳健

  **节点架构迁移（V3）**

  * **核心节点更新**：将多个节点类别迁移到 V3 架构，包括 Minimax API、Cosmos、条件、CFG 和 Canny 节点

  **性能和技术改进**

  * **FP8 操作**：在 gfx1200 硬件上默认启用 FP8 操作，实现更快的处理速度
  * **LoRA 训练器修复**：解决了 LoRA 训练工作流中 FP8 模型兼容性的错误

  **前端更新**

  * **前端版本更新**：更新到版本 1.26.13
</Update>

<Update label="v0.3.59" description="2025年9月10日">
  **字节跳动 Seedream 4.0 集成**

  * **新增 Seedream 节点**：添加了 ByteDanceSeedream (4.0) 节点。
</Update>

<Update label="v0.3.58" description="2025年9月6日">
  **新模型支持**

  * Hunyuan Image 2.1 常规模型
  * Hunyuan 3D 2.1

  **新增 API 节点**

  * Stable Audio 2.5 API
  * Seedance Video API
</Update>

<Update label="v0.3.57" description="2025年9月4日">
  **ByteDance USO 模型支持**

  * **UXO 主体身份 LoRA 支持**：这是一个基于 FLUX 架构的主体身份 LoRA 模型
  * **相关工作流**：请在模板 `Flux` -> `Flux.1 Dev USO Reference Image Generation` 中查找工作流

  **工作流实用工具**

  * **ImageScaleToMaxDimension 节点**：用于智能图像缩放的新实用工具
  * **SEEDS 噪声系统**：使用改进算法更新噪声分解
  * **增强提示控制**：中断处理器现在接受 prompt\_id 参数

  **性能和架构**

  * **V3 架构迁移**：将一些核心节点转换为 V3 架构
  * **卷积自动调优**：启用自动卷积优化

  **新增 API 集成**

  * **ByteDance 图像节点**：添加了对 ByteDance 图像生成服务的支持
  * **Ideogram 角色参考**：Ideogram v3 API 现在支持角色参考
</Update>

<Update label="v0.3.56" description="2025年8月30日">
  **性能增强**

  * **减少 Windows 上的 RAM 使用量**
</Update>

<Update label="v0.3.55" description="2025年8月29日">
  **模型支持**

  * Wan2.2 S2V
  * Wan2.2 5B Fun control
  * Wan2.2 5B Fun inpaint

  **高级潜在空间处理**

  * **LatentCut节点**：用于在精确点位切割潜在变量的新节点，在复杂生成工作流中实现对潜在空间操作的更精细控制。这对于批处理和时序视频工作流特别有用，比如删除视频中的某些帧。
</Update>

<Update label="v0.3.54" description="2025年8月28日">
  **节点模型补丁改进**

  此次专项更新改进了支撑 ComfyUI 灵活架构的核心节点模型补丁系统：

  **核心基础设施增强**

  * **节点模型补丁更新**：增强了 nodes\_model\_patch.py，改进了底层模型补丁机制，使得 ComfyUI 对 Qwen-Image ControlNet 的扩展更为容易

  **工作流程优势**

  * **增强的稳定性**：核心模型补丁改进有助于在不同工作流程配置中实现更可靠的节点执行和模型处理
</Update>

<Update label="v0.3.53" description="2025年8月28日">
  **音频工作流集成与增强性能优化**

  此版本增加了 ComfyUI 的音频处理能力，并包含性能改进和模型兼容性更新：

  **音频处理更新**

  * **Wav2vec2 音频编码器**：新增原生 wav2vec2 实现作为音频编码器模型，为多模态应用启用音频到嵌入工作流
  * **音频编码器目录**：新增 models/audio\_encoders 目录，此为 Wan2.2 S2V 音频编码器目录
  * **AudioEncoderOutput V3 支持**：使 AudioEncoderOutput 与 V3 节点架构兼容，确保与现代工作流架构的无缝集成

  **Google Gemini API 集成**

  * **Gemini Image API 节点**： 新增全新 Google Gemini Image API 节点，即 “nano-Nano-banana” 图像编辑模型 API，具有高度的一致性

  **视频生成性能与内存优化**

  * **WAN 2.2 S2V 模型支持**：正在开发的 WAN 2.2 声音到视频模型实现，具有优化的内存使用和性能
  * **增强的 S2V 性能**：对超过120帧的视频生成进行性能改进，改善扩展视频工作流
  * **更好的内存估算**：改进 S2V 工作流的内存使用估算，防止长视频生成期间出现内存不足错误
  * **负音频处理**：修复 S2V 工作流中负音频输入处理，使用适当的零值

  **采样与节点增强**

  * **DPM++ 2M SDE Heun (RES) 采样器**：@Balladie 提供的全新高级采样器，为精细调节生成控制提供额外的采样选项
  * **LatentConcat 节点**：用于连接潜在张量的新节点，启用高级潜在空间操作工作流
  * **EasyCache/LazyCache 稳定性**：修复当张量属性（形状/数据类型/设备）在采样期间发生变化时的关键崩溃问题，确保工作流可靠性

  **模型兼容性改进**

  * **ControlNet 类型模型**：增强与 Qwen Edit 和 Kontext 工作流配合使用的 ControlNet 类型模型的兼容性修复
  * **Flux 内存优化**：调整 Flux 模型内存使用因子以获得更好的资源利用

  **基础设施与可靠性**

  * **模板更新**：更新至 0.1.66 和 0.1.68 版本
  * **文档清理**：从自述文件中移除未完全实现的模型，以避免用户混淆
</Update>

<Update label="v0.3.52" description="2025年8月23日">
  **增强模型支持和 Qwen Image ControlNet 集成等**

  此版本显著扩展了 ControlNet 功能并改进了模型兼容性，让 ComfyUI 工作流更加多样化和可靠：

  **Qwen ControlNet 生态系统**

  * **Diffsynth ControlNet 支持**：新增支持 Qwen Diffsynth ControlNet 的 Canny 和深度条件控制，实现精确的边缘和基于深度的图像控制
  * **InstantX Qwen ControlNet**：集成 InstantX Qwen ControlNet，扩展创意控制选项
  * **修复补丁 ControlNet/模型**：通过专用的 Diffsynth 修复 ControlNet 支持增强修复功能

  **节点架构和 API 演进**

  * **V3 架构迁移**：字符串节点、Google Veo API 和 Ideogram API 节点升级到 V3 架构，提供更好的性能和一致性
  * **增强的 API 节点**：OpenAI Chat 节点重命名为"OpenAI ChatGPT" 提高辨识度，Gemini Chat 节点现在包含复制按钮功能
  * **改进的可用性**：API 节点现在通过更清晰的标签和增强的交互功能提供更好的用户体验

  **工作流可靠性和性能**

  * **LTXV 噪声遮罩修复**：解决了存在真实噪声遮罩时关键帧噪声遮罩维度问题，确保视频工作流执行稳定
  * **3D 潜在条件控制**：修复了 3D 潜在空间的条件遮罩，在高级工作流中启用适当的深度感知条件控制
  * **无效文件名处理**：通过正确处理无效文件名改进工作流保存功能，防止保存失败
  * **EasyCache 和 LazyCache**：实现高级缓存系统以改进工作流执行性能

  **平台和开发改进**

  * **Python 3.13 支持**：完全兼容 Python 3.13，保持 ComfyUI 与最新 Python 发展同步
  * **前端更新**：更新到 v1.25.10，改进导航和用户界面增强功能
  * **逐元素融合**：通过逐元素操作融合添加性能优化
  * **导航模式回滚**：回滚导航默认到传统旧版模式，避免默认启用新版标准导航模式导致用户体验问题，用户仍旧可以在设置中启用标准导航模式
</Update>

<Update label="v0.3.51" description="2025年08月20日">
  **模型支持**

  * **Qwen-Image-Edit模型**：原生支持 Qwen-Image-Edit
  * **FluxKontextMultiReferenceLatentMethod 节点**：用于 Flux 工作流的多图参考输入节点
  * **WAN 2.2 Fun Camera模型支持**：支持通过相机控制生成视频
  * **模板更新**：升级到版本 0.1.62，新增了 Wan2.2 Fun Camera 和 Qwen Image Edit 等模板

  **核心功能改进**

  * **Context Windows上下文节点支持**：增强采样代码，支持更长序列的生成任务
  * **SDPA 后端优化**：改进缩放点积注意力后端设置，提升性能

  **多媒体节点支持**

  * **音频录制节点**：新增原生音频录制节点，现在你可以直接在 ComfyUI内录制音频
  * **音频视频集成**：完善音频-视频依赖项集成

  **API节点支持更新**

  * **GPT-5 系列模型**：支持最新的 GPT-5 模型
  * **Kling V2-1 和 V2-1-Master**：更新视频生成模型功能
  * **Minimax Hailuo 视频节点**：新增视频生成节点
  * **Vidu 视频节点**：Vidu API 节点支持
  * **Google 模型更新**：新增 Google Gemini 的新模型
  * **OpenAI API 修复**：修复 OpenAI API 节点输入图像的 MIME 类型导致的错误

  **性能优化**

  * **Intel GPU 兼容性**：修复 Intel 集成 GPU 兼容性问题
  * **PyTorch 兼容性**：增强与旧版 PyTorch 的兼容性
  * **Torch Compile 优化**：改进 torch compile 行为
  * **内存管理**：优化安装大小和内存效率

  **前端变更**

  * **子图支持**：子图功能支持
  * **快捷键面板**： 新增底部快捷键面板
  * **修改 UI 布局**：修改终端入口布局，增加模板，日志面板等多个入口
  * **新增标准画布模式**： 新增标注画布模式，可在 lite-graph(画面) Canvas > 画布导航模式中切换
  * **新增小地图**： 新增工作流迷你地图
  * **新增Tab预览**： 新增工作流 tab 预览
  * **调整顶部 Tab 菜单布局**
</Update>

<Update label="v0.3.50" description="2025年8月13日">
  **模型集成与性能提升**

  本次更新扩展了ComfyUI的模型支持，优化了API功能，并提升了工作流程的稳定性：

  **Qwen模型生态**

  * **Qwen图像模型支持**：改进了LoRA加载和模型合并功能，支持更复杂的视觉工作流程
  * **Qwen模型合并节点**：新增节点，支持合并Qwen图像模型
  * **SimpleTuner Lycoris LoRA支持**：扩展了对Qwen-Image模型的Lycoris LoRA兼容性

  **API与性能**

  * **异步API节点**：引入异步API节点，支持非阻塞工作流程执行
  * **内存处理优化**：RepeatLatentBatch节点改进，能正确处理多维latent
  * **WAN 2.2 Fun Control支持**：新增对WAN 2.2 fun control功能的支持

  **硬件优化**

  * **AMD GPU改进**：提升了AMD Radeon的FP16精度处理和性能
  * **RDNA3架构修复**：解决了gfx1201 GPU使用Flux模型的问题
  * **PyTorch支持更新**：升级了CUDA和ROCM PyTorch版本

  **开发体验**

  * **日志记录优化**：功能标志仅在详细模式下显示
  * **音频处理安全**：增强了torchaudio导入安全检查
  * **Kling API改进**：修复了Kling Image API节点的图像类型参数
</Update>

<Update label="v0.3.49" description="2025年8月5日">
  **界面优化与模型支持**

  此版本改进了用户体验，增加了前沿模型支持：

  **用户界面**

  * **最近项目 API**：新增跟踪最近使用项目的API
  * **工作流导航优化**：改进了常用元素的组织

  **模型集成**

  * **Qwen视觉模型支持**：初步支持Qwen图像模型
  * **图像处理优化**：增强了Qwen模型集成

  **视频生成**

  * **Veo3视频生成**：新增Veo3视频生成节点，支持音频
  * **音视频合成**：在单个节点中结合视频和音频生成

  **性能与稳定**

  * **内存管理优化**：优化了条件VRAM使用
  * **设备一致性**：修复了条件数据和上下文的设备问题
  * **ControlNet稳定性**：解决了ControlNet兼容性问题

  **开发与系统**

  * **错误处理**：添加了条件设备不匹配的警告
  * **模板更新**：更新了多个模板版本
</Update>

<Update label="v0.3.48" description="2025年8月2日">
  **API增强与性能优化**

  此版本引入了后端改进和性能优化：

  **ComfyAPI框架**

  * **ComfyAPI Core v0.0.2**：核心API框架更新，提升了稳定性和可扩展性
  * **部分执行支持**：新增后端支持部分工作流执行

  **视频处理**

  * **WAN Camera内存优化**：改进了基于WAN的相机工作流内存管理
  * **WanFirstLastFrameToVideo修复**：解决了视频生成的关键问题

  **性能与模型**

  * **VAE优化**：在VAE操作中优化了torch.silu
  * **WAN VAE优化**：对WAN VAE操作进行了优化

  **节点架构**

  * **V3节点架构**：实现了下一代节点架构系统
  * **模板更新**：更新了多个模板版本
</Update>

<Update label="v0.3.47" description="2025年7月30日">
  **内存优化与大模型性能**

  本次更新优化了大模型工作流的内存使用：

  **WAN 2.2模型**

  * **内存占用减少**：减少了WAN 2.2 VAE操作的内存使用
  * **5B I2V模型支持**：优化了WAN 2.2 5B图像到视频模型

  **VRAM管理**

  * **Windows大显卡支持**：为Windows高端显卡增加了VRAM分配
  * **内存分配改进**：改进了多大模型用户的内存管理
</Update>

<Update label="v0.3.46" description="2025年7月28日">
  **硬件加速和音频处理**

  此版本扩展了硬件支持并增强了音频处理：

  **音频处理**

  * **PyAV音频后端**：用PyAV替换torchaudio.load
  * **音频集成优化**：增强了多媒体生成工作流的音频处理

  **硬件支持**

  * **Iluvatar CoreX支持**：添加了对Iluvatar CoreX加速器的支持
  * **Intel XPU优化**：改进了XPU支持
  * **AMD ROCm增强**：在Torch 2.8上为gfx1201启用了PyTorch attention
  * **CUDA内存管理**：修复了CUDA malloc激活问题

  **采样算法**

  * **Euler CFG++增强**：分离了去噪和噪声估计过程
  * **WAN模型支持**：添加了对WAN模型的全面支持

  **训练功能**

  * **训练节点增强**：添加了算法支持、梯度累积和可选梯度检查点
  * **训练灵活性**：提供了更好的内存管理和性能优化

  **节点和工作流**

  * **Moonvalley V2V节点**：添加了Moonvalley Marey V2V节点
  * **负面提示词更新**：改进了Moonvalley节点的负面提示词处理
  * **历史API增强**：向get\_history API添加了map\_function参数

  **API和系统**

  * **前端版本跟踪**：在/system\_stats API响应中添加了required\_frontend\_version
  * **设备信息**：增强了XPU设备名称打印
  * **模板更新**：更新了多个模板版本

  **开发体验**

  * **文档更新**：增强了README和模型集成指南
  * **行结束符修复**：标准化了工作流中的行结束符
  * **代码清理**：移除了已弃用的代码
</Update>

<Update label="v0.3.45" description="2025年7月21日">
  **采样与训练功能改进**

  本版本增强了采样算法和训练功能：

  **采样和生成功能**

  * **SA-Solver采样器**：新的重构SA-Solver采样算法
  * **实验性CFGNorm节点**：无分类器引导标准化节点
  * **嵌套双CFG支持**：为DualCFGGuider节点添加嵌套风格配置
  * **SamplingPercentToSigma节点**：用于计算sigma的新实用节点

  **训练功能**

  * **多数据集支持**：LoRA训练节点支持多个图像-描述数据集
  * **训练循环优化**：优化了训练算法
  * **错误检测增强**：为LoRA操作添加了模型检测错误提示

  **平台和性能**

  * **异步节点支持**：完全支持异步节点函数
  * **Chroma灵活性**：取消了Chroma中硬编码的patch\_size参数
  * **LTXV VAE解码器**：切换到改进的默认填充模式
  * **Safetensors内存管理**：为mmap问题添加了解决方案

  **API和集成**

  * **自定义提示ID**：API允许指定提示ID
  * **Kling API优化**：增加了轮询超时时间
  * **历史令牌清理**：从历史项目中删除了敏感令牌
  * **Python 3.9兼容性**：修复了兼容性问题

  **错误修复和稳定性**

  * **MaskComposite修复**：解决了目标蒙版的错误
  * **Fresca输入/输出**：修正了Fresca模型工作流程的处理
  * **引用错误修复**：解决了Gemini节点实现中的引用问题
  * **行结束标准化**：自动检测和删除Windows行结束符

  **开发体验**

  * **警告系统**：添加了torch导入错误警告
  * **模板更新**：更新了多个模板版本
  * **文档**：增强了fast\_fp16\_accumulation的文档
</Update>

<Update label="v0.3.44" description="2025年7月8日">
  **采样和模型控制增强**

  此版本改进了采样算法和模型控制系统：

  **新采样功能**

  * **TCFG节点**：增强的分类器无关引导控制
  * **ER-SDE采样器**：从VE迁移到VP算法
  * **跳层引导（SLG）**：用于推理期间精确层级控制

  **开发工具**

  * **自定义节点管理**：新的`--whitelist-custom-nodes`参数
  * **性能优化**：双CFG节点在CFG为1.0时自动优化
  * **GitHub Actions集成**：自动化发布webhook通知

  **图像处理**

  * **新变换节点**：添加了ImageRotate和ImageFlip节点
  * **ImageColorToMask修复**：修正了掩码值返回
  * **3D模型支持**：上传3D模型到自定义子文件夹

  **引导和条件**

  * **PerpNeg引导器**：更新了前后CFG处理
  * **潜在条件修复**：解决了多步骤工作流中的条件问题
  * **去噪步骤**：为多个采样器添加去噪步骤支持

  **平台稳定性**

  * **PyTorch兼容性**：修复了PyTorch nightly构建的问题
  * **FP8回退**：当FP8操作遇到异常时自动回退
  * **音频处理**：移除了已弃用的torchaudio.save函数依赖

  **模型集成**

  * **Moonvalley节点**：为Moonvalley模型工作流添加原生支持
  * **调度器重新排序**：简单调度器现在默认优先
  * **模板更新**：更新了多个模板版本

  **安全性**

  * **安全加载**：在不安全加载文件时添加警告
  * **文件验证**：增强检查点加载安全措施
</Update>

<Update label="v0.3.43" description="2025年6月30日">
  **模型支持与工作流可靠性**

  本次更新改进了模型兼容性和工作流稳定性：

  **扩展模型文档**：为Flux Kontext和Omnigen 2模型添加了支持文档
  **VAE编码改进**：移除了VAE编码过程中不必要的随机噪声注入
  **内存管理修复**：解决了影响Kontext模型使用的关键内存估算错误
</Update>

<Update label="v0.3.41" description="2025年6月17日">
  **模型支持新增**

  * **Cosmos Predict2支持**：实现文本到图像和图像到视频生成工作流
  * **增强的Flux兼容性**：Chroma Text Encoder能与常规Flux模型协作
  * **LoRA训练集成**：新增原生LoRA训练节点

  **性能和硬件优化**

  * **AMD GPU增强**：在AMD GPU上启用FP8操作和PyTorch注意力机制
  * **Apple Silicon修复**：解决了Apple设备上的FP16注意力问题
  * **Flux模型稳定性**：解决了特定Flux模型生成黑色图像的问题

  **采样改进**

  * **Rectified Flow采样器**：新增支持RF的SEEDS和多步DPM++ SDE采样器
  * **ModelSamplingContinuousEDM**：新增cosmos\_rflow选项
  * **内存优化**：改进了Cosmos模型的内存估算

  **开发和集成功能**

  * **SQLite数据库支持**：增强自定义节点的数据管理功能
  * **PyProject.toml集成**：从pyproject文件自动注册web文件夹
  * **前端灵活性**：支持语义化版本后缀和预发布前端版本
  * **分词器增强**：通过tokenizer\_data配置min\_length设置

  **使用体验改进**

  * **Kontext宽高比修复**：解决了小组件限制
  * **SaveLora一致性**：统一了所有保存节点的文件名格式
  * **Python版本警告**：为过时的Python安装添加警报
  * **WebcamCapture修复**：修正了IS\_CHANGED签名
</Update>

<Update label="v0.3.40" description="2025年6月5日">
  **工作流工具和性能优化**

  本次更新带来了新的工作流工具和性能优化：

  **新工作流工具**

  * **ImageStitch节点**：在工作流中拼接多个图像
  * **GetImageSize节点**：提取图像尺寸并支持批处理
  * **Regex Replace节点**：高级文本处理功能

  **模型兼容性**

  * **张量处理改进**：简化的列表处理使多模型工作流更可靠
  * **BFL API优化**：完善了对Kontext模型的支持
  * **性能提升**：在色度处理中使用融合乘加运算

  **开发体验**

  * **自定义节点支持**：添加pyproject.toml支持
  * **帮助菜单集成**：在节点库侧边栏中新增帮助系统
  * **API文档**：增强API节点文档

  **前端和UI**

  * **前端更新至v1.21.7**：多项稳定性修复和性能改进
  * **自定义API基础支持**：改进了自定义部署配置的子路径处理
  * **安全加固**：修复XSS漏洞

  **错误修复和稳定性**

  * **Pillow兼容性**：更新了已弃用的API调用
  * **ROCm支持**：改进了AMD GPU用户的版本检测
  * **模板更新**：增强了自定义节点开发的项目模板
</Update>
