ComfyUI v0.11.1 版本更新详解
2026 年 1 月 29 日，ComfyUI 迎来了全新的 v0.11.1 版本。本次更新属于不可变版本（immutable release），主要优化了开发者体验、API 节点扩展以及稳定性。
版本更新概览
更新内容摘要：
- 新增开发模式专用节点支持（Dev-Only Nodes）
- 更新 Python 3.14 兼容性说明
- 新增 API 节点：Grok Imagine 节点
- 升级管理器版本至 4.1b1
- 工作流模板更新至 v0.8.27
- 补充缺失的空间下采样比率（spatial downscale ratios）
主要技术更新详情
1. 新增开发模式专用节点支持（Dev-Only Nodes）
在 comfy/comfy_types/node_typing.py 文件中新增：
DEV_ONLY: bool
"""Flags a node as dev-only, hiding it from search/menus unless dev mode is enabled."""
此功能允许节点仅在开发模式中可见与使用，极大提升了插件与自定义节点的管理灵活度。 同时在 server.py、comfy_api/latest/_io.py 等文件中也同步增加了对应的属性处理逻辑，使得 API 与 UI 能正确识别并过滤'开发者专属节点'。
2. Python 3.14 兼容性说明更新
在 README.md 中更新了说明：
Python 3.14 works but some custom nodes may have issues. The free threaded variant works but some dependencies will enable the GIL so it's not fully supported.
官方在说明中明确指出：Python 3.14 可正常运行，但部分自定义节点可能存在依赖兼容问题；'free-threaded'变体仍未完全脱离 GIL 约束。 推荐版本仍为 Python 3.13，其兼容性最佳且支持最全面。
3. API 节点增强：新增 Grok Imagine 节点
新增文件 comfy_api_nodes/apis/grok.py，完整定义了 Grok Imagine 相关的输入输出数据模型。 包括：
- 图片生成接口（ImageGenerationRequest / ImageGenerationResponse）
- 图片编辑接口（ImageEditRequest）
- 视频生成接口（VideoGenerationRequest / VideoGenerationResponse）
- 视频编辑接口（VideoEditRequest）
- 视频状态响应（VideoStatusResponse）
这些模型使用 Pydantic 结构定义，为后续 API 调用与远程节点通信提供了强可靠的数据校验和结构化支持。
4. 空间下采样比率补充（Latent Formats 优化）
在 comfy/latent_formats.py 中新增多个 spatial_downscale_ratio 定义，例如：
class SC_Prior(LatentFormat):
spatial_downscale_ratio = 42
class SC_B(LatentFormat):
spatial_downscale_ratio = 4
():
spatial_downscale_ratio =
():
spatial_downscale_ratio =
