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）

---

🧩主要技术更新详情

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 中新增多个 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

---

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

---

✅总结

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

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

亮点包括：

• 支持"开发者专属节点"，助力插件自定义与调试；
• 改进Python 3.14适配性；
• 新增GroK Imagine相关API节点，提升跨平台数据交互能力；
• 完善空间下采样比率定义；
• 全面升级依赖与版本号，稳定性更高。

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

---

结语：

ComfyUI v0.11.1，不只是一次版本迭代，更是对创作者与开发者生态的全面优化。

从节点定义到API拓展，从兼容性到架构精炼，让工作流构建更简单、更自由、更可靠。