Update changelog with comfyui v0.3.70

changelog/index.mdx

@@ -4,22 +4,43 @@
 icon: "clock-rotate-left"
 ---
 
+<Update label="v0.3.70" description="November 19, 2025">
+
+**CUDA 12.6 Support & Distribution**
+- Added official CUDA 12.6 release workflow and portable download support for enhanced GPU compatibility
+- Updated README with corrected portable download links for streamlined installation
+
+**Model Compatibility & Fixes**
+- **HunYuan 3D 2.0 Support**: Fixed compatibility issues for improved 3D model generation workflows
+- **EasyCache Improvements**: Resolved input/output channel mismatches that affected certain model configurations
+- Enhanced block swap functionality by removing potentially harmful native custom node implementations
+
+**API Node Enhancements**
+- **New Gemini Models Added**: Expanded AI model options for text and multimodal generation workflows
+- Improved API node development infrastructure with updated PR templates and Python 3.10 minimum version requirements
+
+**Development & Infrastructure**
+- Enhanced pylint configuration for better code quality in custom node development
+- Improved release automation and distribution processes for more reliable updates
+
+</Update>
+
 <Update label="v0.3.69" description="November 18, 2025">
 
 **Memory & Performance Optimizations**
 - **Pinned Memory Enabled by Default** for NVIDIA and AMD GPUs
 - **Reduced VRAM Usage** for Flux, Qwen, and LTX-Video models
 - Smart model unloading that automatically frees memory when VRAM usage increases
 - Improved weight casting performance on offload streams
 
 **New Features**
 - **ScaleROPE Node Now Works with Flux Models**
 - Added left padding support to tokenizers
 - Added `create_time` field to `/history` and `/queue` endpoints
 
 **Bug Fixes**
 - Fixed custom node import errors for SingleStreamBlock/DoubleStreamBlock (temporary fix)
 - Fixed Qwen ControlNet regression
 - Enhanced quantized operations with offload support and stability improvements
 - Unified RoPE function implementation across models
 
@@ -36,11 +57,11 @@
 
 **New Nodes & Execution Features**
 - **ScaleROPE Node**: Rope scaling support for WAN and Lumina models
 - Enhanced subgraph execution allowing multiple runs within single workflows
 - Improved caching system with proper handling of bytes data and None outputs
 
 **API Node Enhancements**
 - Migrated API nodes to V3 client architecture: Luma, Minimax, Pixverse, Ideogram, StabilityAI, Pika, Recraft, Hypernetwork, OpenAI
 - Extended LTXV API nodes with 12s-20s duration options
 - Fixed img2img operations in DALL-E 2 node
 - Enhanced Rodin3D nodes to return proper relative paths
@@ -55,48 +76,47 @@
 <Update label="v0.3.67" description="October 28, 2025">
 
 **API Nodes**
 - **LTXV API Integration**: Added new LTXV API nodes for Lightricks LTX video generation
 - Network Client V2 upgrade with async operations and cancellation support
 - Converted Tripo and Gemini API nodes to V3 schema
 
 **Performance & Compatibility**
 - Improved AMD GPU support by only disabling cudnn on newer AMD GPUs
 - Fixed Windows-specific network issues in API nodes for better retry handling
 
 **Core Improvements**
 - Enhanced dependency-aware caching system that fixes --cache-none behavior with loops
 - Added support for multi-dimensional latents
 - Added custom node published subgraphs endpoint
 
 **Updates**
 - Frontend bumped to version 1.28.8
 - Template updates to version 0.2.4
 
 </Update>
-
 <Update label="v0.3.66" description="October 21, 2025">
 
 **Frontend Updates**
 - **Subgraph Widget Editing**: Edit subgraph parameters directly from new Parameters panel without entering the subgraph
 - **Template Modal Redesign**: New template browser with advanced filtering by model tags and categories
 
 **Performance Optimizations**
 - Iimproved workflow cancellation speed
 - Fixed VAE memory issue consuming 3x more on PyTorch 2.9 with NVIDIA GPUs  
 - Enhanced chroma radiance processing speed and fixed batch size issues above 1
 
 **API Nodes**
 - Added Veo 3.1 model support
 - Added TemporalScoreRescaling node for advanced temporal control in video workflows
 
 **Hardware & Compatibility**
 - Disabled FP8 operations for AMD gfx942 GPUs
 - Improved CUDA memory management in --fast autotune mode
 
 **Execution & Schema**
 - Converted ControlNet nodes to V3 schema
 - Enhanced EasyCache with proper batch_slice handling
 - Improved merge_nested_dicts functionality with proper input ordering
 - Added deprecation warnings for unused files
 </Update>
 <Update label="v0.3.65" description="October 14, 2025">
@@ -105,18 +125,18 @@
 - Migrated core node categories to V3 schema including model downscale, LoRA extraction, compositing, latent ops, SD3/SLG, Flux, upscale models, and HunyuanVideo nodes
 
 **Audio & Model Improvements**
 - Added MMaudio 16K VAE support for high-fidelity audio workflows
 - Fixed mono audio incorrectly saving as stereo
 - Refactored model sampling sigmas code and fixed FP8 scaled LoRA issues
 - Fixed loading of older Stable Diffusion checkpoints on newer NumPy versions
 
 **AMD GPU Optimizations**
 - Better memory estimation for SD/Flux VAE operations
 - Enabled RDNA4 PyTorch attention on ROCm 7.0+
 
 **API Node Updates**
 - Added price extractor and improvements to Kling/Pika API nodes
 - Enhanced Gemini Image API with aspect_ratio support
 
 **Updates**
 - Template v0.1.95, node docs v0.3.0
@@ -140,25 +160,25 @@
 - **AMD Support**: Enabled TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL by default
 
 **API Node Updates**
 - **Kling 2.5 Turbo**: Added support for kling-2-5-turbo in both txt2video and img2video nodes, with proper mode configuration fixes
 - **API Node Fixes**: Improved Gemini node base64 handling and fixed indentation issues in Recraft API node functions
 
 **Node Schema Migration (V3)**
 - **Extensive V3 Conversion**: Migrated numerous node categories to V3 schema including audio encoder, GITS, differential diffusion, optimal steps, PAG, LT, IP2P, morphology, torch compile, EPS, Pixverse, TomeSD, edit model, Rodin, and Stable3D nodes for improved workflow compatibility
 
 **Developer Experience Improvements**
 - **Code Quality**: Added pylint support for comfy_api_nodes folder and updated example_node.py to use V3 schema, making custom node development more consistent
 - **Documentation Updates**: Enhanced AMD installation instructions with nightly PyTorch commands for Windows users
 
 **Frontend Updates**
 - **Subgraph Publish**: Allows publishing subgraphs to the node library
 - **Node Selection Toolbox Redesign**: Redesigned the node selection toolbox
 </Update>
 <Update label="v0.3.62" description="September 30, 2025">
 
 **API Node**
 - **Rodin3D-Gen2 Parameter Fix**
 - **Seedance Pro Model Support**
 </Update>
 
 <Update label="v0.3.61" description="September 30, 2025">
@@ -168,32 +188,32 @@
 - **WAN Image-to-Image**: Wan2.5 Image-to-Image API node, support image editing.
 
 **Enhanced Audio Capabilities**
 - **New Audio Nodes**: Added new audio nodes for enhanced audio-driven workflows and multimodal content creation
 
 **Model Compatibility Fixes**
 - **Qwen2.5VL Template Handling**: Improved template management for Qwen2.5VL models when templates are already present in prompts
 - **HuMo View Operation**: Fixed .view() operation issues in HuMo models for more stable video generation
 
 **Memory and Performance Optimizations**
 - **Memory Leak Fix**: Resolved memory leaks by explicitly detaching model finalizers, improving long-running workflow stability
 - **Sampler CFG Enhancement**: Added 'input_cond' and 'input_uncond' parameters to sampler CFG function arguments for more flexible conditioning control
 </Update>
 
 <Update label="v0.3.60" description="September 23, 2025">
 
 **New Model Support**
 - **Wan2.2 Animate**: Support for Wan2.2 Animate video generation model with character replacement and motion transfer capabilities
 - **Qwen Image Edit 2509 Support**: Support for the updated Qwen Image Edit 2509 with multi-image editing, higher consistency, and native ControlNet support
 - **HuMo Models**: Added support for both 1.7B and 17B HuMo models that use audio to drive video generation while maintaining lip sync
 - **Chroma Radiance**: A model that performs image generation in pixel space, reducing losses during the image generation process
 - **Omnigen2 UMO LoRA**: Added support for Omnigen2 UMO LoRA models
 
 **API Node Additions**
 - **Kling v2.1 Support**: Added kling-v2-1 model to KlingStartEndFrame node
 - **Seedream4 Fixes**: Fixed the flag that ignores errors on partial success, making workflows more robust
 
 **Node Schema Migration (V3)**
 - **Core Node Updates**: Migrated multiple node categories to V3 schema including Minimax API, Cosmos, conditioning, CFG, and Canny nodes
 
 **Performance & Technical Improvements**
 - **FP8 Operations**: Enabled FP8 operations by default on gfx1200 hardware for faster processing
@@ -205,19 +225,19 @@
 </Update>
 <Update label="v0.3.59" description="September 10, 2025">
 
 **ByteDance Seedream 4.0 Integration**
 - **New Seedream Node**: Added ByteDanceSeedream (4.0) node.
 
 </Update>
 <Update label="v0.3.58" description="September 6, 2025">
 
 **New Model Support**
 - Hunyuan Image 2.1 regular model
 - Hunyuan 3D 2.1
 
 **New API Nodes**
 - Stable Audio 2.5 API
 - Seedance Video API
 </Update>
 <Update label="v0.3.57" description="September 4, 2025">
 
@@ -228,7 +248,7 @@
 **Workflow Utilities**
 - **ImageScaleToMaxDimension Node**: New utility for intelligent image scaling
 - **SEEDS Noise System**: Updated noise decomposition with improved algorithms
 - **Enhanced Prompt Control**: Interrupt handler now accepts prompt_id parameters
 
 **Performance & Architecture**
 - **V3 Schema Migration**: Converted some core nodes to V3 schema
@@ -256,11 +276,11 @@
 - **Automatic Audio Trimming**: Video saves now automatically trim audio to match video length, eliminating audio-video sync issues in final output files.
 
 **Advanced Latent Processing**
 - **LatentCut Node**: New node for cutting latents at precise points, enabling more granular control over latent space manipulation in complex generation workflows. This is particularly useful for batch processing and temporal video workflows, such as removing specific frames from videos.
 
 **Wan2.2 5B Model Integration**
 - **Fun Control Model Support**: Added support for Wan2.2 5B fun control model.
 - **Fun Inpaint Model Support**: Integrated Wan2.2 5B fun inpaint model.
 
 </Update>
 <Update label="v0.3.54" description="August 28, 2025">
@@ -283,7 +303,7 @@
 This release adds ComfyUI audio processing capabilities and includes performance improvements and model compatibility updates:
 
 **Audio Processing Updates**
 - **Wav2vec2 Audio Encoder**: Added native wav2vec2 implementation as an audio encoder model, enabling audio-to-embedding workflows for multimodal applications
 - **Audio Encoders Directory**: Added models/audio_encoders directory, which is the audio encoder directory for Wan2.2 S2V
 - **AudioEncoderOutput V3 Support**: Made AudioEncoderOutput compatible with V3 node schema, ensuring seamless integration with modern workflow architectures
 
@@ -297,46 +317,46 @@
 - **Negative Audio Handling**: Fixed negative audio input handling in S2V workflows to use proper zero values
 
 **Sampling & Node Enhancements**
 - **DPM++ 2M SDE Heun (RES) Sampler**: New advanced sampler by @Balladie provides additional sampling options for fine-tuned generation control
 - **LatentConcat Node**: New node for concatenating latent tensors, enabling advanced latent space manipulation workflows
 - **EasyCache/LazyCache Stability**: Fixed critical crashes when tensor properties (shape/dtype/device) change during sampling, ensuring workflow reliability
 
 **Model Compatibility Improvements**
 - **ControlNet Type Models**: Enhanced compatibility fixes for ControlNet-type models working with Qwen Edit and Kontext workflows
 - **Flux Memory Optimization**: Adjusted Flux model memory usage factors for better resource utilization
 
 **Infrastructure & Reliability**
 - **Template Updates**: Updated to versions 0.1.66 and 0.1.68
 - **Documentation Cleanup**: Removed incompletely implemented models from readme to avoid user confusion
 
 
 </Update>
 <Update label="v0.3.52" description="August 23, 2025">
 
 **Enhanced Model Support & Qwen Image ControlNet Integration**
 
 This release significantly expands ControlNet capabilities and improves model compatibility, making ComfyUI workflows more versatile and reliable:
 
 **Qwen ControlNet Ecosystem**
 - **Diffsynth ControlNet Support**: Added support for Qwen Diffsynth ControlNets with Canny and depth conditioning, enabling precise edge and depth-based image control
 - **InstantX Qwen ControlNet**: Integrated InstantX Qwen ControlNet for expanded creative control options
 - **Inpaint ControlNet/Model Patches**: Enhanced inpainting capabilities with dedicated Diffsynth inpaint ControlNet support
 
 **Node Architecture & API Evolution**
 - **V3 Architecture Migration**: String nodes, Google Veo API, and Ideogram API nodes upgraded to V3 architecture for better performance and consistency
 - **Enhanced API Nodes**: OpenAI Chat node renamed to "OpenAI ChatGPT" for clarity, Gemini Chat node now includes copy button functionality
 - **Improved Usability**: API nodes now provide better user experience with clearer labeling and enhanced interaction features
 
 **Workflow Reliability & Performance**
 - **LTXV Noise Mask Fix**: Resolved key frame noise mask dimension issues when real noise masks exist, ensuring stable video workflow execution
 - **3D Latent Conditioning Control**: Fixed conditioning masks on 3D latents, enabling proper depth-aware conditioning control in advanced workflows
 - **Invalid Filename Handling**: Improved workflow save functionality with proper handling of invalid filenames, preventing save failures
 - **EasyCache & LazyCache**: Implemented advanced caching systems for improved workflow execution performance
 
 **Platform & Development Improvements**
 - **Python 3.13 Support**: Full compatibility with Python 3.13, keeping ComfyUI current with latest Python developments
 - **Frontend Update**: Updated to v1.25.10 with improved navigation and user interface enhancements
 - **Elementwise Fusions**: Added performance optimizations through elementwise operations fusion
 - **Navigation Mode Rollback**: Rolled back navigation default to traditional legacy mode, avoiding user experience issues caused by default enabled standard navigation mode. Users can still enable standard navigation mode in settings
 
 </Update>
@@ -347,7 +367,7 @@
 - **Qwen-Image-Edit Model**: Native support for Qwen-Image-Edit
 - **FluxKontextMultiReferenceLatentMethod Node**: Multi-reference input node for Flux workflows
 - **WAN 2.2 Fun Camera Model Support**: Support for video generation through camera control
 - **Template Updates**: Upgraded to version 0.1.62, added Wan2.2 Fun Camera and Qwen Image Edit templates
 
 **Core Function Improvements**
 - **Context Windows Support**: Enhanced sampling code to support longer sequence generation tasks
@@ -359,9 +379,9 @@
 
 **API Node Support Updates**
 - **GPT-5 Series Models**: Support for the latest GPT-5 models
 - **Kling V2-1 and V2-1-Master**: Updated video generation model functionality
 - **Minimax Hailuo Video Node**: New video generation node
 - **Vidu Video Node**: Vidu API node support
 - **Google Model Updates**: Added new Google Gemini models
 - **OpenAI API Fix**: Fixed MIME type errors in OpenAI API node input images
 
@@ -372,7 +392,7 @@
 - **Memory Management**: Optimized installation size and memory efficiency
 
 **Frontend Changes**
 - **Subgraph Support**: Subgraph functionality support
 - **Shortcut Panel**: Added bottom shortcut panel
 - **UI Layout Modifications**: Modified terminal entry layout, added template, log panel and other entries
 - **Standard Canvas Mode**: Added standard canvas mode, can be switched in `Lite Graph` > `Canvas` > `Canvas Navigation Mode`
@@ -386,31 +406,31 @@
 
 **Model Integration & Performance Enhancements**
 
 This release expands ComfyUI's model ecosystem with enhanced Qwen support, async API capabilities, and stability improvements for complex workflows:
 
 **Qwen Model Ecosystem**
 - **Qwen Image Model Support**: Improved integration including proper LoRA loading and model merging capabilities for sophisticated vision workflows
 - **Qwen Model Merging Node**: New dedicated node for merging Qwen image models, allowing creators to combine different model strengths
 - **SimpleTuner Lycoris LoRA Support**: Extended compatibility with SimpleTuner-trained Lycoris LoRAs for Qwen-Image models
 
 **API & Performance Infrastructure**
 - **Async API Nodes**: Introduction of asynchronous API nodes, enabling non-blocking workflow execution for better performance
 - **Memory Handling**: Enhanced RepeatLatentBatch node now properly handles multi-dimensional latents, fixing workflow interruptions
 - **WAN 2.2 Fun Control Support**: Added support for WAN 2.2 fun control features, expanding creative control for video workflows
 
 **Hardware Optimization & Compatibility**
 - **AMD GPU Improvements**: Enhanced AMD Radeon support with improved FP16 accuracy handling and performance optimization
 - **RDNA3 Architecture Fixes**: Resolved issues with gfx1201 GPUs when using Flux models with PyTorch attention
 - **Updated PyTorch Support**: Bumped CUDA and ROCM PyTorch versions with testing on Python 3.13 and CUDA 12.9
 
 **Developer Experience Enhancements**
 - **Cleaner Logging**: Feature flags now only display in verbose mode, reducing console noise
 - **Audio Processing Safety**: Enhanced torchaudio import safety checks prevent crashes when audio dependencies are unavailable
 - **Kling API Improvements**: Fixed image type parameter handling in Kling Image API nodes
 
 **Workflow Benefits**
 - **Async Workflow Execution**: New async API capabilities enable more responsive workflows when integrating external services
 - **Model Flexibility**: Expanded Qwen support allows for more diverse vision-language workflows with improved LoRA compatibility
 - **Hardware Utilization**: AMD GPU optimizations and updated PyTorch support improve performance across hardware configurations
 - **Batch Processing**: Fixed RepeatLatentBatch ensures reliable operation with complex multi-dimensional data structures
 - **Video Control**: WAN 2.2 fun control features provide advanced creative control for video generation workflows
@@ -427,8 +447,8 @@
 - **Workflow Navigation**: Enhanced user experience with better organization of commonly accessed elements
 
 **Model Integration**
 - **Qwen Vision Model Support**: Initial support for Qwen image models with configuration options
 - **Image Processing**: Enhanced Qwen model integration allows for more versatile image analysis and generation workflows
 
 **Video Generation**
 - **Veo3 Video Generation**: Added Veo3 video generation node with integrated audio support
@@ -445,7 +465,7 @@
 
 **Workflow Benefits**
 - **Faster Iteration**: Recently used items API enables quicker workflow assembly and modification
 - **Enhanced Creativity**: Qwen vision models open new possibilities for image understanding and manipulation workflows
 - **Video Production**: Veo3 integration transforms ComfyUI into a comprehensive multimedia creation platform
 - **Reliability**: Memory optimizations and device management fixes ensure stable operation with complex workflows
 - **Performance**: Optimized VRAM usage allows for more ambitious projects on systems with limited resources
@@ -512,26 +532,26 @@
 - **Audio Integration**: Enhanced audio handling for multimedia generation workflows
 
 **Hardware Support**
 - **Iluvatar CoreX Support**: Added native support for Iluvatar CoreX accelerators
 - **Intel XPU Optimization**: XPU support improvements including async offload capabilities
 - **AMD ROCm Enhancements**: Enabled PyTorch attention by default for gfx1201 on Torch 2.8
 - **CUDA Memory Management**: Fixed CUDA malloc to only activate on CUDA-enabled PyTorch installations
 
 **Sampling Algorithm Improvements**
 - **Euler CFG++ Enhancement**: Separated denoised and noise estimation processes in Euler CFG++ sampler
 - **WAN Model Support**: Added support for WAN (Wavelet-based Attention Network) models
 
 **Training Features**
 - **Training Nodes**: Added algorithm support, gradient accumulation, and optional gradient checkpointing
 - **Training Flexibility**: Better memory management and performance optimization for custom model training
 
 **Node & Workflow Enhancements**
 - **Moonvalley V2V Node**: Added Moonvalley Marey V2V node with enhanced input validation
 - **Negative Prompt Updates**: Improved negative prompt handling for Moonvalley nodes
 - **History API Enhancement**: Added map_function parameter to get_history API
 
 **API & System Improvements**
 - **Frontend Version Tracking**: Added required_frontend_version parameter in /system_stats API response
 - **Device Information**: Enhanced XPU device name printing for better hardware identification
 - **Template Updates**: Multiple template updates (0.1.40, 0.1.41) ensuring compatibility
 
@@ -550,7 +570,7 @@
 
 **Sampling & Generation Features**
 - **SA-Solver Sampler**: New reconstructed SA-Solver sampling algorithm providing enhanced numerical stability
 - **Experimental CFGNorm Node**: Classifier-free guidance normalization for improved control over generation quality
 - **Nested Dual CFG Support**: Added nested style configuration to DualCFGGuider node
 - **SamplingPercentToSigma Node**: New utility node for precise sigma calculation from sampling percentages
 
@@ -561,19 +581,19 @@
 
 **Platform & Performance Improvements**
 - **Async Node Support**: Full support for asynchronous node functions with earlier execution optimization
 - **Chroma Flexibility**: Un-hardcoded patch_size parameter in Chroma
 - **LTXV VAE Decoder**: Switched to improved default padding mode for better image quality
 - **Safetensors Memory Management**: Added workaround for mmap issues
 
 **API & Integration Enhancements**
 - **Custom Prompt IDs**: API now allows specifying prompt IDs for better workflow tracking
 - **Kling API Optimization**: Increased polling timeout to prevent user timeouts
 - **History Token Cleanup**: Removed sensitive tokens from history items
 - **Python 3.9 Compatibility**: Fixed compatibility issues ensuring broader platform support
 
 **Bug Fixes & Stability**
 - **MaskComposite Fixes**: Resolved errors when destination masks have 2 dimensions
 - **Fresca Input/Output**: Corrected input and output handling for Fresca model workflows
 - **Reference Bug Fixes**: Resolved incorrect reference bugs in Gemini node implementations
 - **Line Ending Standardization**: Automated detection and removal of Windows line endings
 
@@ -603,12 +623,12 @@
 **Image Processing Improvements**
 - **Transform Nodes**: Added ImageRotate and ImageFlip nodes for enhanced image manipulation
 - **ImageColorToMask Fix**: Corrected mask value returns for more accurate color-based masking
 - **3D Model Support**: Upload 3D models to custom subfolders for better organization
 
 **Guidance & Conditioning Enhancements**
 - **PerpNeg Guider**: Updated with improved pre and post-CFG handling
 - **Latent Conditioning Fix**: Resolved issues with conditioning at index > 0 for multi-step workflows
 - **Denoising Steps**: Added denoising step support to several samplers
 
 **Platform Stability**
 - **PyTorch Compatibility**: Fixed contiguous memory issues with PyTorch nightly builds
@@ -616,7 +636,7 @@
 - **Audio Processing**: Removed deprecated torchaudio.save function dependencies
 
 **Model Integration**
 - **Moonvalley Nodes**: Added native support for Moonvalley model workflows
 - **Scheduler Reordering**: Simple scheduler now defaults first
 - **Template Updates**: Multiple template version updates (0.1.31-0.1.35)
 
@@ -632,9 +652,9 @@
 
 This release brings improvements to model compatibility and workflow stability:
 
 **Expanded Model Documentation**: Added support documentation for Flux Kontext and Omnigen 2 models
 **VAE Encoding Improvements**: Removed unnecessary random noise injection during VAE encoding
 **Memory Management Fix**: Resolved a memory estimation bug affecting Kontext model usage
 
 </Update>
 
@@ -646,23 +666,23 @@
 - **LoRA Training Integration**: New native LoRA training node using weight adapter scheme
 
 **Performance & Hardware Optimizations**
 - **AMD GPU Enhancements**: Enabled FP8 operations and PyTorch attention on AMD GPUs
 - **Apple Silicon Fixes**: Addressed FP16 attention issues on Apple devices
 - **Flux Model Stability**: Resolved black image generation issues with certain Flux models
 
 **Sampling Improvements**
 - **Rectified Flow Samplers**: Added SEEDS and multistep DPM++ SDE samplers with RF support
 - **ModelSamplingContinuousEDM**: New cosmos_rflow option for enhanced sampling control
 - **Memory Optimization**: Improved memory estimation for Cosmos models
 
 **Developer & Integration Features**
 - **SQLite Database Support**: Enhanced data management capabilities for custom nodes
 - **PyProject.toml Integration**: Automatic web folder registration from pyproject files
 - **Frontend Flexibility**: Support for semver suffixes and prerelease frontend versions
 - **Tokenizer Enhancements**: Configurable min_length settings with tokenizer_data
 
 **Quality of Life Improvements**
 - **Kontext Aspect Ratio Fix**: Resolved widget-only limitation
 - **SaveLora Consistency**: Standardized filename format across all save nodes
 - **Python Version Warnings**: Added alerts for outdated Python installations
 - **WebcamCapture Fixes**: Corrected IS_CHANGED signature
@@ -682,7 +702,7 @@
 
 **Model Compatibility**
 - **Tensor Handling**: Streamlined list processing makes multi-model workflows more reliable
 - **BFL API Optimization**: Refined support for Kontext models with cleaner node interfaces
 - **Performance Boost**: Fused multiply-add operations in chroma processing for faster generation
 
 **Developer Experience**
@@ -692,12 +712,12 @@
 
 **Frontend & UI Enhancements**
 - **Frontend Updated to v1.21.7**: Stability fixes and performance improvements
 - **Custom API Base Support**: Better subpath handling for custom deployment configurations
 - **Security Hardening**: XSS vulnerability fixes
 
 **Bug Fixes & Stability**
 - **Pillow Compatibility**: Updated deprecated API calls
 - **ROCm Support**: Improved version detection for AMD GPU users
 - **Template Updates**: Enhanced project templates for custom node development
 
 </Update>

zh-CN/changelog/index.mdx

@@ -4,6 +4,26 @@
 icon: "clock-rotate-left"
 ---
 
+<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日">
 
 **内存与性能优化**
@@ -55,17 +75,17 @@
 <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 的支持
 - 添加了自定义节点发布子图端点
 
 **其他更新**
@@ -85,17 +105,17 @@
 - 加快色度辐射处理速度并修正批量大于 1 时的问题
 
 **API 节点**
 - 新增 Veo 3.1 模型支持
 - 新增 TemporalScoreRescaling 节点，实现视频工作流高级时序控制
 
 **硬件与兼容性**
 - 禁用 AMD gfx942 GPU 的 FP8 运算
 - 优化 --fast autotune 模式下的 CUDA 内存管理
 
 **执行与架构**
 - ControlNet 节点迁移至 V3 架构
 - EasyCache 优化，支持正确的 batch_slice 处理
 - merge_nested_dicts 功能改进，保证输入顺序正确
 - 为未使用文件新增废弃提示
 </Update>
 
@@ -105,18 +125,18 @@
 - 将核心节点迁移到 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
@@ -142,17 +162,17 @@
 - **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 命令
 
 **前端更新**
@@ -180,24 +200,24 @@
 
 **内存和性能优化**
 - **内存泄漏修复**：通过显式分离模型终结器解决了内存泄漏问题，提高长时间运行工作流的稳定性
 - **采样器 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 操作，实现更快的处理速度
@@ -209,20 +229,20 @@
 </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日">
@@ -234,7 +254,7 @@
 **工作流实用工具**
 - **ImageScaleToMaxDimension 节点**：用于智能图像缩放的新实用工具
 - **SEEDS 噪声系统**：使用改进算法更新噪声分解
 - **增强提示控制**：中断处理器现在接受 prompt_id 参数
 
 **性能和架构**
 - **V3 架构迁移**：将一些核心节点转换为 V3 架构
@@ -257,7 +277,7 @@
 **模型支持**
 - Wan2.2 S2V
 - Wan2.2 5B Fun control
 - Wan2.2 5B Fun inpaint
 
 **高级潜在空间处理**
 - **LatentCut节点**：用于在精确点位切割潜在变量的新节点，在复杂生成工作流中实现对潜在空间操作的更精细控制。这对于批处理和时序视频工作流特别有用，比如删除视频中的某些帧。
@@ -299,12 +319,12 @@
 - **负音频处理**：修复 S2V 工作流中负音频输入处理，使用适当的零值
 
 **采样与节点增强**
 - **DPM++ 2M SDE Heun (RES) 采样器**：@Balladie 提供的全新高级采样器，为精细调节生成控制提供额外的采样选项
 - **LatentConcat 节点**：用于连接潜在张量的新节点，启用高级潜在空间操作工作流
 - **EasyCache/LazyCache 稳定性**：修复当张量属性（形状/数据类型/设备）在采样期间发生变化时的关键崩溃问题，确保工作流可靠性
 
 **模型兼容性改进**
 - **ControlNet 类型模型**：增强与 Qwen Edit 和 Kontext 工作流配合使用的 ControlNet 类型模型的兼容性修复
 - **Flux 内存优化**：调整 Flux 模型内存使用因子以获得更好的资源利用
 
 **基础设施与可靠性**
@@ -314,17 +334,17 @@
 </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 节点现在通过更清晰的标签和增强的交互功能提供更好的用户体验
 
@@ -347,7 +367,7 @@
 - **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上下文节点支持**：增强采样代码，支持更长序列的生成任务
@@ -359,9 +379,9 @@
 
 **API节点支持更新**
 - **GPT-5 系列模型**：支持最新的 GPT-5 模型
 - **Kling V2-1 和 V2-1-Master**：更新视频生成模型功能
 - **Minimax Hailuo 视频节点**：新增视频生成节点
 - **Vidu 视频节点**：Vidu API 节点支持
 - **Google 模型更新**：新增 Google Gemini 的新模型
 - **OpenAI API 修复**：修复 OpenAI API 节点输入图像的 MIME 类型导致的错误
 
@@ -391,7 +411,7 @@
 **Qwen模型生态**
 - **Qwen图像模型支持**：改进了LoRA加载和模型合并功能，支持更复杂的视觉工作流程
 - **Qwen模型合并节点**：新增节点，支持合并Qwen图像模型
 - **SimpleTuner Lycoris LoRA支持**：扩展了对Qwen-Image模型的Lycoris LoRA兼容性
 
 **API与性能**
 - **异步API节点**：引入异步API节点，支持非阻塞工作流程执行
@@ -406,7 +426,7 @@
 **开发体验**
 - **日志记录优化**：功能标志仅在详细模式下显示
 - **音频处理安全**：增强了torchaudio导入安全检查
 - **Kling API改进**：修复了Kling Image API节点的图像类型参数
 
 </Update>
 <Update label="v0.3.49" description="2025年8月5日">
@@ -486,7 +506,7 @@
 - **音频集成优化**：增强了多媒体生成工作流的音频处理
 
 **硬件支持**
 - **Iluvatar CoreX支持**：添加了对Iluvatar CoreX加速器的支持
 - **Intel XPU优化**：改进了XPU支持
 - **AMD ROCm增强**：在Torch 2.8上为gfx1201启用了PyTorch attention
 - **CUDA内存管理**：修复了CUDA malloc激活问题
@@ -500,7 +520,7 @@
 - **训练灵活性**：提供了更好的内存管理和性能优化
 
 **节点和工作流**
 - **Moonvalley V2V节点**：添加了Moonvalley Marey V2V节点
 - **负面提示词更新**：改进了Moonvalley节点的负面提示词处理
 - **历史API增强**：向get_history API添加了map_function参数
 
@@ -540,7 +560,7 @@
 
 **API和集成**
 - **自定义提示ID**：API允许指定提示ID
 - **Kling API优化**：增加了轮询超时时间
 - **历史令牌清理**：从历史项目中删除了敏感令牌
 - **Python 3.9兼容性**：修复了兼容性问题