ComfyUI v0.11.1正式发布：新增开发者专属节点支持、API节点强化、Python 3.14兼容性更新等全方位优化！

2026年1月29日，ComfyUI迎来了全新的v0.11.1版本。本次更新属于不可变版本（immutable release），主要优化了开发者体验、API节点扩展以及稳定性。以下为本次更新的详细技术解读。

版本更新概览

更新内容摘要：

• •新增开发模式专用节点支持（Dev-Only Nodes）

• •更新Python 3.14兼容性说明

• •新增API节点：Grok Imagine节点

• •升级管理器版本至 4.1b1

• •工作流模板更新至 v0.8.27

• •补充缺失的空间下采样比率（spacial downscale ratios）

在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中新增多个spacial_downscale_ratio定义，例如：

class SC_Prior(LatentFormat):
    spacial_downscale_ratio = 42
class SC_B(LatentFormat):
    spacial_downscale_ratio = 4
class LTXV(LatentFormat):
    spacial_downscale_ratio = 32
class Wan22(Wan21):
    spacial_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

在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位贡献者参与

代码地址：github.com/Comfy-Org/ComfyUI

ComfyUI v0.11.1是一次聚焦开发者体验与API能力扩展的重要版本更新。
亮点包括：

• • 支持“开发者专属节点”，助力插件自定义与调试；

• • 改进Python 3.14适配性；

• • 新增GroK Imagine相关API节点，提升跨平台数据交互能力；

• • 完善空间下采样比率定义；

• • 全面升级依赖与版本号，稳定性更高。

本次更新使ComfyUI在可扩展性与开发灵活度上迈出关键一步，也为后续新功能的迭代打下坚实基础。

结语：
ComfyUI v0.11.1，不只是一次版本迭代，更是对创作者与开发者生态的全面优化。
从节点定义到API拓展，从兼容性到架构精炼，让工作流构建更简单、更自由、更可靠。

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。