更新日志 | ComfyUI 官方中文文档

更新日志

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

官方中文源 / changelog/index.mdx / 固定提交 e433279d

更新

新型开源模型支持

**SeedVR2**：原生SeedVR2图像与视频放大（#14424）
**PID 1.5**：PixelDiT PID 1.5模型支持
**int4模型**：convrot int4支持，以及Turing int8/int4优化

新增节点

**保存3D（高级）**：保存3D（高级）、保存Splat和保存点云节点
**SaveText**：将文本输出保存为.txt、.md或.json
**文本叠加**：图像与视频的文本叠加
**Text**：已重新启用内置 Text 节点
**创建边界框**：增加了bboxes输入，用于上游连线

合作伙伴节点更新

**sync.so sync-3**：sync.so sync-3 唇形同步与说话图像支持
**Seedream 思考链 COT**：Seedream 节点可禁用思考链 COT
**Gemini图像**：Gemini图像预览模型已移至发布版本

性能与稳定性

**--models-directory**：用于设置默认模型目录的启动参数
**GQA注意力**：所有注意力后端均支持GQA；已放弃PyTorch 2.4
**16xx上的int8**：修复了GTX 16xx上的int8回归问题
**ROCm / AMD Triton**：Triton自动启用仅限于矩阵核心GPU
**前端**：comfyui-frontend-package 更新至1.45.21

错误修复

**缓存的任务输出**：修复了当提示中没有client_id时缓存输出缺失的问题
**3D高级（API模式）**：修复了高级3D节点在无UI情况下崩溃的问题
**int4 Turing**：修复了Turing显卡上int4模型输出黑色图像的问题
**Qwen3-VL**：修复将参考图像用于文本编码模型时的问题
**保存图像（高级）**：支持单通道图像
**HiDream O1**：修复了HiDream O1回归问题

更新

int8 模型支持 此版本新增了对 int8 convrot 模型 的支持，为量化模型带来了显著的性能提升。现在 int8 支持在 Turing 及更新架构的 GPU 上工作，并优化了 LoRA 应用和内存管理。

新节点

**种子节点**：新增种子节点，用于管理工作流中的种子值 (CORE-295)
**高级 Krea 2 模型合并**：用于合并 Krea 2 模型的高级节点
**边界框画布**：边界框画布节点及 Ideogram JSON 提示词支持 (CORE-292)
**ConditioningMultiply**：新的条件节点，用于乘以条件值
**GLSL 更新**：GLSL 节点已更新为使用 ANGLE 库 (CORE-162)

合作伙伴节点更新

**Nano Banana 2 Lite**：新增对 Google 的 Nano Banana 2 Lite 模型的支持
**Gemini Video Omni**：新增 Gemini Video Omni 节点，用于视频生成

性能与稳定性

**int8 模型**：新增对 int8 convrot 模型的支持，推理速度更快
**更快的 int8**：优化了 int8 内核性能
**Turing GPU 支持**：int8 支持扩展到 Turing 架构 GPU
**更好的 int8 LoRA**：改进了 int8 LoRA 的应用，质量和速度更佳
**内存泄漏修复**：修复了 int8 操作相关的内存泄漏
**资产哈希可选**：资产哈希改为通过 --enable-asset-hashing 标志选择加入（默认关闭）

错误修复

**int8 LoRA 重新量化**：修复了在 int8 LoRA 上使用错误设置时导致的低质量重新量化问题
**int8 矩阵乘法卸载**：修复了在卸载的 LoRA 权重上跳过 int8 矩阵乘法的问题
**节点分类**：更新并重新组织了节点分类
**前端**：将 comfyui-frontend-package 升级至 1.45.20

更新

新的开源模型支持

**Krea2**: Krea 的开源图像模型，审美和风格范围广泛 — 开放权重 RAW / Turbo 组合；在 RAW 上训练 LoRA，在 Turbo 上运行 8 步推理
**Boogu-Image**: 文生图模型，使用 Qwen3-VL-8B 文本编码器；**TextEncodeBooguEdit** 节点增加了带负面提示词和可选参考图像的图像编辑功能
**Qwen3-VL 文本生成**: 使用 Qwen3-VL 4B 和 8B 模型进行带图像理解的文本生成
**SCAIL-2 Multireference**: SCAIL-2 角色替换的多参考支持

新节点

**LTX2 上下文窗口**: LTX-2 多模态视频+音频模型的上下文窗口采样，支持 IC-LoRA 引导拼接
**Load3DAdvanced**: 仅网格的 3D 加载器，输出 model_3d、camera_info、model_3d_info、宽度和高度
**保存节点输出接口**: 为保存节点新增输出接口，以便连接下游管线

合作伙伴节点更新

**Luma Rays 3.2**: 为 Luma Ray 3.2 视频生成新增七个节点

性能与稳定性

**Krea 2**: 更准确的内存使用因子
**Dynamic VRAM**: 提示用户尝试原生格式，而不是禁用动态 VRAM
**Anima**: 小幅推理优化
**Jobs API**: 新增取消端点 (POST /api/jobs/{job_id}/cancel, POST /api/jobs/cancel)

问题修复

**资产面板**: 修复了滚动大型作业时出现重复媒体条目的问题
**高级输入**: 修复了折叠高级部分后已连接的高级输入被隐藏的问题
**工作流恢复**: 修复了重新加载后台工作流后缺少子图节点预览的问题

更新

新的开源模型支持

**Depth Anything 3**: 来自 LiheYoung 的单目深度估计模型
**SCAIL-2**: 用于增强视频编辑的角色替换模型
**Bernini-R**: Wan 万相视频模型支持
Ideogram 4: 修复 fp8 dtype 问题以提高稳定性
10 位视频支持: 为核心节点新增 10 位视频输入/输出支持

新节点

**PreviewGaussianSplat + PreviewPointCloud**: 用于高斯泼溅和点云可视化的新 3D 预览节点
**Color Primitive**: 工作流用的颜色类型和实用工具
Improved ResolutionSelector (#14309): 增强的分辨率选择与更好的默认设置

合作伙伴节点更新

Bria Transparent Video Background + Green Background + Replace Background 节点
Gemini Text Node (#14299): 新增的大语言模型合作伙伴节点
Runway Aleph2 (#14306): 新增的视频生成节点
Krea 2 Medium Turbo 模型支持
Tripo3D Import 3D 节点
Flux Erase: 新增种子输入
NanoBanana: 新增 temperature 和 top_p 控制
Flux KV 缓存: 修复拆分批次时的崩溃问题

性能与稳定性

Aimdo 0.4.10 及 --reserve-vram 和 --vram-headroom 选项
Comfy Aimdo 0.4.9 带可靠性改进
媒体加载: 通用化的 --high-ram 选项
资产 API: 基于游标的分页、摄入时提取图像尺寸、WebSocket 消息中的资产 ID
在 CUDA 130+ 上始终启用 CUDA malloc
将 cudnn.benchmark 强制设为 false 以获得确定性结果
修复了非对齐宽度图像/视频解码中的奇数高度崩溃和边缘渗色问题
修复了非对齐宽度视频解码的非确定性问题
Ideogram 4: 修复 cleanup_models_gc() 中不重置 cast 缓冲区的问题
训练器: 修复训练节点中条件变为可训练的问题

更新

新增开源模型支持

**Ideogram 4**：首日支持 Ideogram 开源文生图模型。基于 NextDiT/Lumina2 单流 DiT 架构，使用 Qwen3-VL-8B（13 层隐藏态特征）作为文本编码器。新增 Ideogram4Scheduler、DualModelGuider（条件/无条件分别在不同模型上运行）和 CFGOverride 节点
**PiD 模型**：PiD 条件节点新增 SDXL 和 QwenImage 变体支持
**Radiance**：支持使用非零顺序 txt_ids 的 checkpoint

合作伙伴节点更新

Ideogram V4 API 节点： 新增 Ideogram V4 云服务的 API 节点

性能与稳定性

MultiGPU CFG Split： 修复手动中止时的冻结问题
Ideogram 4： 优化非动态 VRAM 配置下的内存使用因子
DualModelGuider： 标记为实验性功能
comfy-aimdo： 更新至 0.4.8

Bug 修复

修复 BiRefNet 和 DINOv3 模型的 cast/dtype 问题
修复 TripoSplat 在旧版 offloading 模式下的预览问题
DINOv3 推理改为 fp32 运行，提高准确性
修复数学表达式节点对大整数结果的 OverflowError 处理
恢复合作伙伴节点类别更改，保持工作流兼容性
移除过时的 ComfyUI kitchen 回退代码
工作流模板更新至 v0.9.94

更新

新增开源模型支持

**Microsoft Lens**：支持 Microsoft 的 Lens 文生图模型，使用 GPT-OSS-20B MoE 文本编码器（转换为 nvfp4），分词器直接嵌入 safetensors 文件
**NVIDIA PixelDiT & PiD**：支持 NVIDIA PixelDiT 1300M 文生图模型及 PiD 系列模型，支持上下文窗口和内存优化
**TripoSplat**：支持 VAST-AI 的图像转 3D Gaussian Splat 模型——通过 DINOv3 + Flux2 VAE 编码单张图像，经流匹配去噪器和八叉树高斯解码器生成 3D Gaussian Splat
**MediaPipe 人脸检测**：无依赖重新实现 Google MediaPipe 人脸检测和关键点定位，权重以 safetensors 格式分发

新节点

**Save Image Advanced**：高级图像保存节点，提供更多文件输出控制选项
**Gaussian Splat 节点**：新增 GAUSSIAN 类型及工具节点，无需外部依赖即可处理 3D Gaussian Splat（支持导出 .ply、.splat、.spz、.ksplat）
**逻辑节点**：新增 And、Or、Not 工具节点（归入 utils 分类）
**Preview3DAdvanced**：高级 3D 预览节点

性能提升

**多线程模型加载**：多线程磁盘读取显著加速模型加载，同时支持将模型卸载到磁盘，适合内存有限的系统
**MultiGPU 工作单元**：通过跨 GPU 分配条件工作单元加速采样；支持正向+负向条件及掩码条件作为工作单元；XPU MultiGPU CFG Split 现已在 Windows 上启用
随机舍入： 浮点运算改用 comfy-kitchen CUDA 随机舍入内核，提升数值精度
缓存 RAM： 调低阈值，实现更智能的 RAM 缓存淘汰
Anima / ERNIE 加速： 在 NVIDIA 硬件上提升推理速度；ERNIE 使用更高质量的 rope

合作伙伴节点更新

OpenRouter LLM 节点： 新增 OpenRouter 语言模型 API 节点
Rodin 2.5： 新增 Rodin 3D 生成节点
Krea2 Image： 新增 Krea2 图像生成节点
Beeble SwitchX： 新增 Beeble 重光照/背景替换节点
Tripo3D P1： 新增 Tripo3D P1 生成模型节点
Flux Virtual Try-On & Erase： 新增基于 Flux 的虚拟试穿和目标擦除节点
SeeDance 2： 改进视频参考上传；添加运行时输入验证
ByteDance2Reference： 新增自动放大控件
Grok Video： 在 First Frame 模式下添加 grok-imagine-video-1.5 模型；移除 Grok 节点中的 beta 模型版本

Load3D 增强

在 Load3DCamera 信息输出中添加相机内参字段
model_file 现为可选项（新增 "none" 选项）
Load3D 节点新增 model_info 输出
移除 Load3DCamera 的 rotation 字段
新增 File3DPLY、File3DSPLAT、File3DSPZ、File3DKSPLAT IO 类型
SaveImageTextDataSetToFolderNode：新增覆盖/递增模式

Bug 修复

修复安装 xformers 时 --use-flash-attention 被忽略的问题
修复 Lanczos 对单通道张量的维度转置问题
修复 LoRA 重塑应用
修复 LTX AV 交叉注意力 AdaLN 调制中的时间步传递
修复 LTXVCropGuides 当引导共享起始位置时产生的多余潜变量帧
修复背景去除掩码输出形状
禁用 Stable Audio DiT 和 VAE 中的 sage attention
升级 pyav 以修复部分图像加载问题
撤销非动态智能内存的弃用

其他

新增彩色控制台日志，便于调试
更新嵌入式文档至 v0.5.2，工作流模板至 v0.9.92
comfy-kitchen 固定至 0.2.9
多项 OpenAPI 规范修复与节点分类更新

更新

开源模型支持

**Stable Audio 3.0**：支持最新的 Stable Audio 3 模型，具有改进的音频生成能力
MoGe： 新增 MoGe 模型支持，用于增强几何处理功能
HiDream-O1： 新增区域条件化支持，实现更精确的图像生成控制
LTXV 增强： 新增降采样 IC-LoRA 支持和可选的 attention_mask 输入，改善视频控制效果
时序处理： 实现 downscale_ratio_temporal 功能，为视频工作流提供更好的时序控制
LTX2.3 优化： 在使用 guide_mask 时减少峰值显存占用，提高视频生成效率

合作伙伴节点

Seed2.0： 新增节点，提供字节跳动增强的语言模型功能
Opus 4.7： 修复已弃用的 temperature 参数，提高模型兼容性

节点增强

StringFormat Node： 新增节点，用于工作流中的高级字符串操作
音频处理： 改进音频潜在节点的时序降采样支持，提高重用性
批处理节点： 将 Image/Mask/Latent 批处理节点的最小批处理大小从 2 减少到 1，提供更多灵活性
负值支持： 允许特定节点参数使用负值，扩展创意控制范围

其他

模型采样： 在链式 model_sampling 补丁中保持 noise_scale/shift，确保结果一致性
文本生成： 修复 Qwen3.5 多图像提示处理，改善文本生成工作流
动态 CLIP： 实现适当的动态 CLIP 保存功能
BiRefNet： 解决兼容性问题，提高背景移除性能
Hunyuan3D 2.1： 修复 attention 和 forward pass 操作中的批处理大小崩溃问题
更新各种节点显示名称、描述和分类，提升用户体验
改进前端版本警告系统，提供更好的兼容性检查
增强 README，添加应用程序和云端链接，方便访问资源
向项目资源添加安全文档和职业信息
修复 FeatherMask 负零索引问题，确保右侧/底部羽化功能正常
纠正 OOM 内存摘要格式，提供更清晰的错误报告
修复批处理问题并改善模型加载稳定性
解决各种工作流兼容性问题和已弃用参数处理

更新

新的合作伙伴节点

Flux2ImageNode 和 GrokImageEditNodeV2： 新增节点，用于增强图像生成和编辑工作流
ByteDanceSeedreamNodeV2： 新版本，带有 DynamicCombo 和 Autogrow 功能，改善参数处理
OpenAI Image 节点： 新的集成，具备 DynamicCombo 和 Autogrow 能力
Claude LLM 节点： 为文本生成工作流添加了 Claude 语言模型支持

模型支持增强

Anima TE LoRA： 新增对 Kohya 格式的 Anima TE LoRA 支持
HiDream-O1-Image： 完全支持 HiDream-O1-Image 模型，修复了数据类型问题并改善了非动态 VRAM 配置下的内存使用

技术改进

修复了模型补丁器中 fp8 格式的 safetensors 保存问题
修正了 LTXV 视频中段多帧引导对齐，优化视频处理效果
通过修复 RuntimeError 问题，提高了 VOID 模型兼容性
增强了 Save3D 节点，支持顶点颜色和纹理，为全面的 3D 工作流提供支持

界面和文档更新

在基础功能选项卡中添加了"创建视频"，便于访问视频生成工作流
更新嵌入式文档到 v0.5.0，工作流模板到 v0.9.75
修复了 LoadAudio define_schema 中的输入目录创建，改善音频工作流处理

错误修复

撤销了破坏性更改以维持工作流兼容性
修复了 Quiver 节点功能
修正了 API 规范中已弃用的云运行时端点标记

更新

开源模型支持

**BiRefNet**：背景移除
**Gemma4**：LLM 文本生成
**Void**：第 1、2 阶段模型支持

合作伙伴模型支持

**Tripo 3.1**：面向生产的 3D 生成能力
NanoBanana2 节点 v2：DynamicCombo 与 Autogrow 交互更新

节点改进

数学表达式： 增加布尔运算，支持更复杂计算
Flux2 潜在预览： Flux2 模型潜在变量的高质量预览
核心蓝图： 新增内置蓝图模板

错误修复与稳定性

修正 VAEDecodeAudio 与 LTX-2.x 生成音频潜在变量的兼容性
解决 SolidMask 与 MaskComposite 的设备不匹配问题
其他修复与改进（CPU TE 元张量处理、端口占用报错、不带尾随下划线的保存文件名等）

其他模型与媒体

CogVideoX： 视频生成模型支持
Wan-Dancer： 模型支持
媒体加载： 视频加载器统一读取音视频；以 PyAV 替代 Pillow（JPEG 内存、tRNS PNG）；自动方向元数据处理

性能与视频生成

块预取与 LoRA 异步加载（对 LTX 等更明显）
动态 VRAM 调优：--cache-ram 2、降低视频处理峰值显存占用
Triton ComfyUI kitchen CLI，用于进阶优化选项
自回归视频、因果模型的图生视频、causal_window_fix；帧插值内存与开销优化

更多合作伙伴集成

Luma UNI-1、Topaz Astra 2、GPT-5.5 / GPT-5.5-pro

其他节点修复

--gpu-only 下的图像混合；JoinImageWithAlpha 批处理广播；SplitImageToTileList / ImageMergeTileList 瓦片步幅

开发者与 API

--feature-flag 注册表；OpenAPI 云运行时与实验端点；蓝图子图描述；ControlNet 加载顺序确定性

更新

新增模型支持

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节点，显示更多张量值以便更好地调试
新增范围类型支持，改进节点参数处理

更新

新模型支持

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分辨率限制问题

更新

模型与生成支持

增加了 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
增强了输出文件的资源注册系统

更新

内存与性能优化

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

更新

架构与性能改进

实现了模块化资产架构，采用异步两阶段扫描器和后台播种器以提升加载性能
添加了 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

更新

新节点和功能

添加了 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 版本

更新

错误修复与稳定性

修复了当提示条目缺少 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 版本

更新

新节点和功能

添加了 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 工作流提供临时兼容性修复

更新

新增开源模型支持

**Qwen 2512 ControlNet / Fun ControlNet**：支持基于 Qwen 的 ControlNet 模型，以增强图像控制
NAG 实现：应用于所有基于 Flux 模型的 Nesterov 加速梯度

新增节点与 API

**VideoSlice 节点**：用于精确时间控制的视频切片工具
**节点替换 API**：重大架构变更，允许在工作流中替换节点
创建列表节点 (#12173)：列表创建工具节点

性能与技术改进

左填充文本编码器注意力遮罩支持
用于 Flux 模型的 Torch RMSNorm 及混元视频重构
动态显存：训练修复、原始 fp8 LoRA 质量修复
ModelPatcherDynamic：强制加载非叶子权重
修复卸载 + 动态显存模式下的 LoRA 提取
为 Flux 模型使用 torch RMSNorm 并重构混元视频

合作伙伴节点更新

Magnific Upscalers API 节点已启用
腾讯 3D 节点：ModelTo3DUV、3DTextureEdit、3DParts
Bria RMBG API 节点
Kling API 节点：V3、O3 模型

训练器改进

具备适当卸载功能的训练（KohakuBlueleaf）
内建 LoRA 训练现可在 Anima 上运行

更新

新的开源模型支持

**Anima 模型**：对 Anima 模型系列的支持，包含 fp16 优化
**Multi/InfiniteTalk**：针对 LTXV 的大规模多说话人支持
**Flux2 LyCORIS LoKr**：针对 Flux2 的 LoKr（基于 KronA）LoRA 支持
LTX2 Tiny VAE (taeltx_2) 支持
Z-Image Omni 基础模型支持
Flux2 Klein 的 ModelScope LoRA 格式

新节点与功能

Magnific API 节点 (#11986)：通过 Magnific 进行图像放大
Tencent Hunyuan3D API 节点 (#12026)
WaveSpeed API 节点 (#11945)
节点架构中的搜索别名字段，以便更好地发现节点
针对前端任意输入的 kwargs 输入
针对小网格 IC-LoRA 的 RoPE 位置调整

性能

Qwen VAE 和 Wan 的速度/显存优化
LTX2 VAE 显存减少
为提升显存效率而重构的 LTX2 前向传播

模型增强

使用 SaveCheckpoint 保存的 Flux2 Klein 模型现在能正常加载
Qwen 3 0.6B 模型的配置
动态检测色度辐射补丁大小

更新

新特性

**Basic Asset Support**：模型资产管理的基础——模型增删改查操作端点
NVFP4 Model LoRA (#11837)：LoRA 支持现已兼容 NVFP4 量化模型
**SigLIP 2 NAFlex**：支持 SigLIP 2 NAFlex CLIP 视觉模型
**图像对比节点**：直观对比两个图像
**JoinAudioChannels**：音频通道合并工具

模型支持

Z-Image 模型的 ModelScope LoRA (#11805)
修复 Chroma 和文本编码器的 FP4/FP8 问题
VAEEncodeForInpaint 现支持 Wan万相 VAE 的 tuple downscale_ratio
通过高效时间步嵌入处理降低 LTX2 显存占用

API 节点

Vidu2 节点 (#11760)
Topaz Enhance 修复
Gemini 安全拦截处理

技术相关

AMD gfx1200：默认启用 PyTorch 注意力
CI 容器版本自动更新
重构模型加载以降低内存使用
前端补丁更新至 1.36.14

更新

模型支持

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格式与混合量化操作的兼容性

桌面用户注意事项

如果您未关闭自动更新，请等待最新的桌面版本发布，它将自动更新到最新版本。
如果您正在使用桌面版本并且关闭了自动更新，本次桌面版本可能无法自动更新到最新版本。
请从这里下载最新的桌面版本以获取最新功能。

更新

模型兼容性与增强功能

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 性能
修复了工作流命名问题，提升了复杂处理管道的整体稳定性

更新

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配置，提高自定义节点开发中的代码质量
改进了发布自动化和分发流程，确保更可靠的更新

更新

模型支持

支持 ChronoEdit 14B 模型

性能与内存优化

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

新节点与执行功能

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

API节点增强

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

更新

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

更新

前端更新

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

性能优化

提升工作流取消速度
修复在 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 功能改进，保证输入顺序正确
为未使用文件新增废弃提示

更新

模型兼容性增强

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

内存和性能优化

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 命令

前端更新

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

更新

API 节点

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

增强音频功能

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

模型兼容性修复

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

内存和性能优化

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

更新

新模型支持

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

更新

音频工作流集成与增强性能优化

此版本增加了 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 版本
文档清理：从自述文件中移除未完全实现的模型，以避免用户混淆

更新

增强模型支持和 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，改进导航和用户界面增强功能
逐元素融合：通过逐元素操作融合添加性能优化
导航模式回滚：回滚导航默认到传统旧版模式，避免默认启用新版标准导航模式导致用户体验问题，用户仍旧可以在设置中启用标准导航模式

更新

模型支持

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 菜单布局

更新

模型集成与性能提升

本次更新扩展了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节点的图像类型参数

更新

硬件加速和音频处理

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

音频处理

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和模型集成指南
行结束符修复：标准化了工作流中的行结束符
代码清理：移除了已弃用的代码

更新

采样与训练功能改进

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

采样和生成功能

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的文档

更新

采样和模型控制增强

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

新采样功能

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模型工作流添加原生支持
调度器重新排序：简单调度器现在默认优先
模板更新：更新了多个模板版本

安全性

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

更新

模型支持新增

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签名

更新

工作流工具和性能优化

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

新工作流工具

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

模型兼容性

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

开发体验

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

前端和UI

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

错误修复和稳定性

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

官方原文

本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。

内容授权与修改

官方文档采用 GPL-3.0。本站保留许可证、固定提交号和修改说明，不代表 ComfyUI 或 Comfy-Org 对本站背书。

GPL-3.0，来源和修改说明