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
class LTXV(LatentFormat):
spatial_downscale_ratio = 32
class Wan22(Wan21):
spatial_downscale_ratio = 16
这些参数补全了部分潜格式（latent format）的空间缩放比例，对于图像生成精度与特征映射有重要意义。
5. 版本号及依赖包全面更新
版本号变更：
- comfyui_version.py → 从 0.11.0 更新为 0.11.1
- pyproject.toml 同步更新版本号字段
依赖包更新：
- comfyui_manager 更新为 4.1b1
- comfyui-workflow-templates 升级为 v0.8.27
- 其余依赖保持不变，继续支持前端包 comfyui-frontend-package==1.37.11
API Schema 新增字段
在 comfy_api/latest/_io.py 中，Schema 结构新增以下标志位：
is_dev_only: bool = False
is_api_node: bool = False
同时在 V1/V3 信息生成逻辑中已全面支持 dev_only 与 api_node 字段。这意味着 API 端现在可以精确识别节点类型（普通节点 / API 节点 / 开发者节点），接口层数据结构更加规范。
内部改进与结构调整
- Manager 版本号同步升级至 4.1b1
- Workflow 模板版本提升至 v0.8.27
- README 兼容性说明调整
- 内部类 Schema 逻辑优化，新增对 is_dev_only 的处理
- server.py 增加对 DEV_ONLY 标志的识别处理
这些调整提升了整体的稳定性与开发扩展性，特别对第三方节点与远程 API 调用的兼容度有明显增强。
文件变更统计
本次更新包含：
- 7 次提交（commits）
- 11 个文件变更
- 513 行新增，5 行删除
- 共 6 位贡献者参与
总结
ComfyUI v0.11.1 是一次聚焦开发者体验与 API 能力扩展的重要版本更新。 亮点包括：
- 支持'开发者专属节点'，助力插件自定义与调试；
- 改进 Python 3.14 适配性；
- 新增 GroK Imagine 相关 API 节点，提升跨平台数据交互能力；
- 完善空间下采样比率定义；
- 全面升级依赖与版本号，稳定性更高。
本次更新使 ComfyUI 在可扩展性与开发灵活度上迈出关键一步，也为后续新功能的迭代打下坚实基础。
