2026年1月29日，ComfyUI迎來了全新的v0.11.1版本。本次更新屬于不可變版本（immutable release），主要優(yōu)化了開發(fā)者體驗、API節(jié)點擴展以及穩(wěn)定性。以下為本次更新的詳細技術解讀。

版本更新概覽

更新內(nèi)容摘要：

• ?新增開發(fā)模式專用節(jié)點支持（Dev-Only Nodes）

• ?更新Python 3.14兼容性說明

• ?新增API節(jié)點：Grok Imagine節(jié)點

• ?升級管理器版本至 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."""

此功能允許節(jié)點僅在開發(fā)模式中可見與使用，極大提升了插件與自定義節(jié)點的管理靈活度。
同時在server.py、comfy_api/latest/_io.py等文件中也同步增加了對應的屬性處理邏輯，使得API與UI能正確識別并過濾“開發(fā)者專屬節(jié)點”。

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可正常運行，但部分自定義節(jié)點可能存在依賴兼容問題；“free-threaded”變體仍未完全脫離GIL約束。
推薦版本仍為Python 3.13，其兼容性最佳且支持最全面。

3. API節(jié)點增強：新增 Grok Imagine 節(jié)點

新增文件comfy_api_nodes/apis/grok.py，完整定義了Grok Imagine相關的輸入輸出數(shù)據(jù)模型。
包括：

• ?圖片生成接口（ImageGenerationRequest / ImageGenerationResponse）

• ?圖片編輯接口（ImageEditRequest）

• ?視頻生成接口（VideoGenerationRequest / VideoGenerationResponse）

• ?視頻編輯接口（VideoEditRequest）

• ?視頻狀態(tài)響應（VideoStatusResponse）

這些模型使用Pydantic結(jié)構定義，為后續(xù)API調(diào)用與遠程節(jié)點通信提供了強可靠的數(shù)據(jù)校驗和結(jié)構化支持。

4. 空間下采樣比率補充（Latent Formats優(yōu)化）

在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

這些參數(shù)補全了部分潛格式（latent format）的空間縮放比例，對于圖像生成精度與特征映射有重要意義。

5. 版本號及依賴包全面更新

版本號變更：

• ?comfyui_version.py→ 從0.11.0更新為0.11.1

• ?pyproject.toml同步更新版本號字段

依賴包更新：

• ?comfyui_manager更新為4.1b1

• ?comfyui-workflow-templates升級為v0.8.27

• ? 其余依賴保持不變，繼續(xù)支持前端包comfyui-frontend-package==1.37.11

在comfy_api/latest/_io.py中，Schema結(jié)構新增以下標志位：

is_dev_only: bool=False
is_api_node: bool=False

同時在 V1/V3 信息生成邏輯中已全面支持dev_only與api_node字段。這意味著API端現(xiàn)在可以精確識別節(jié)點類型（普通節(jié)點 / API節(jié)點 / 開發(fā)者節(jié)點），接口層數(shù)據(jù)結(jié)構更加規(guī)范。

??內(nèi)部改進與結(jié)構調(diào)整

• ?Manager版本號同步升級至 4.1b1

• ?Workflow模板版本提升至 v0.8.27

• ?README兼容性說明調(diào)整

• ?內(nèi)部類Schema邏輯優(yōu)化，新增對 is_dev_only 的處理

• ?server.py 增加對 DEV_ONLY 標志的識別處理

這些調(diào)整提升了整體的穩(wěn)定性與開發(fā)擴展性，特別對第三方節(jié)點與遠程API調(diào)用的兼容度有明顯增強。

文件變更統(tǒng)計

本次更新包含：

• ?7次提交（commits）

• ?11個文件變更

• ?513行新增，5行刪除

• ?共6位貢獻者參與

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

ComfyUI v0.11.1是一次聚焦開發(fā)者體驗與API能力擴展的重要版本更新。
亮點包括：

• ? 支持“開發(fā)者專屬節(jié)點”，助力插件自定義與調(diào)試；

• ? 改進Python 3.14適配性；

• ? 新增GroK Imagine相關API節(jié)點，提升跨平臺數(shù)據(jù)交互能力；

• ? 完善空間下采樣比率定義；

• ? 全面升級依賴與版本號，穩(wěn)定性更高。

本次更新使ComfyUI在可擴展性與開發(fā)靈活度上邁出關鍵一步，也為后續(xù)新功能的迭代打下堅實基礎。

結(jié)語：
ComfyUI v0.11.1，不只是一次版本迭代，更是對創(chuàng)作者與開發(fā)者生態(tài)的全面優(yōu)化。
從節(jié)點定義到API拓展，從兼容性到架構精煉，讓工作流構建更簡單、更自由、更可靠。

我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業(yè)洞察。 歡迎關注“福大大架構師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來發(fā)展。