北京
2026年1月29日，ComfyUI迎來了全新的v0.11.1版本。本次更新屬于不可變版本（immutable release），主要優(yōu)化了開發(fā)者體驗(yàn)、API節(jié)點(diǎn)擴(kuò)展以及穩(wěn)定性。以下為本次更新的詳細(xì)技術(shù)解讀。
版本更新概覽
更新內(nèi)容摘要：
?新增開發(fā)模式專用節(jié)點(diǎn)支持（Dev-Only Nodes）
?更新Python 3.14兼容性說明
?新增API節(jié)點(diǎn)：Grok Imagine節(jié)點(diǎn)
?升級(jí)管理器版本至 4.1b1
?工作流模板更新至 v0.8.27
?補(bǔ)充缺失的空間下采樣比率（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é)點(diǎn)僅在開發(fā)模式中可見與使用，極大提升了插件與自定義節(jié)點(diǎn)的管理靈活度。
同時(shí)在server.py、comfy_api/latest/_io.py等文件中也同步增加了對(duì)應(yīng)的屬性處理邏輯，使得API與UI能正確識(shí)別并過濾“開發(fā)者專屬節(jié)點(diǎn)”。
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可正常運(yùn)行，但部分自定義節(jié)點(diǎn)可能存在依賴兼容問題；“free-threaded”變體仍未完全脫離GIL約束。
推薦版本仍為Python 3.13，其兼容性最佳且支持最全面。
3. API節(jié)點(diǎn)增強(qiáng)：新增 Grok Imagine 節(jié)點(diǎn)
新增文件comfy_api_nodes/apis/grok.py，完整定義了Grok Imagine相關(guān)的輸入輸出數(shù)據(jù)模型。
包括：
?圖片生成接口（ImageGenerationRequest / ImageGenerationResponse）
?圖片編輯接口（ImageEditRequest）
?視頻生成接口（VideoGenerationRequest / VideoGenerationResponse）
?視頻編輯接口（VideoEditRequest）
?視頻狀態(tài)響應(yīng)（VideoStatusResponse）
這些模型使用Pydantic結(jié)構(gòu)定義，為后續(xù)API調(diào)用與遠(yuǎn)程節(jié)點(diǎn)通信提供了強(qiáng)可靠的數(shù)據(jù)校驗(yàn)和結(jié)構(gòu)化支持。
4. 空間下采樣比率補(bǔ)充（Latent Formats優(yōu)化）
在comfy/latent_formats.py中新增多個(gè)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ù)補(bǔ)全了部分潛格式（latent format）的空間縮放比例，對(duì)于圖像生成精度與特征映射有重要意義。
5. 版本號(hào)及依賴包全面更新
版本號(hào)變更：
?
comfyui_version.py→ 從0.11.0更新為0.11.1?
pyproject.toml同步更新版本號(hào)字段
依賴包更新：
?
comfyui_manager更新為4.1b1?
comfyui-workflow-templates升級(jí)為v0.8.27? 其余依賴保持不變，繼續(xù)支持前端包
comfyui-frontend-package==1.37.11
在comfy_api/latest/_io.py中，Schema結(jié)構(gòu)新增以下標(biāo)志位：
is_dev_only: bool=False
is_api_node: bool=False同時(shí)在 V1/V3 信息生成邏輯中已全面支持dev_only與api_node字段。這意味著API端現(xiàn)在可以精確識(shí)別節(jié)點(diǎn)類型（普通節(jié)點(diǎn) / API節(jié)點(diǎn) / 開發(fā)者節(jié)點(diǎn)），接口層數(shù)據(jù)結(jié)構(gòu)更加規(guī)范。
??內(nèi)部改進(jìn)與結(jié)構(gòu)調(diào)整
?Manager版本號(hào)同步升級(jí)至 4.1b1
?Workflow模板版本提升至 v0.8.27
?README兼容性說明調(diào)整
?內(nèi)部類Schema邏輯優(yōu)化，新增對(duì) is_dev_only 的處理
?server.py 增加對(duì) DEV_ONLY 標(biāo)志的識(shí)別處理
這些調(diào)整提升了整體的穩(wěn)定性與開發(fā)擴(kuò)展性，特別對(duì)第三方節(jié)點(diǎn)與遠(yuǎn)程API調(diào)用的兼容度有明顯增強(qiáng)。
文件變更統(tǒng)計(jì)
本次更新包含：
?7次提交（commits）
?11個(gè)文件變更
?513行新增，5行刪除
?共6位貢獻(xiàn)者參與
代碼地址：github.com/Comfy-Org/ComfyUI
ComfyUI v0.11.1是一次聚焦開發(fā)者體驗(yàn)與API能力擴(kuò)展的重要版本更新。
亮點(diǎn)包括：
? 支持“開發(fā)者專屬節(jié)點(diǎn)”，助力插件自定義與調(diào)試；
? 改進(jìn)Python 3.14適配性；
? 新增GroK Imagine相關(guān)API節(jié)點(diǎn)，提升跨平臺(tái)數(shù)據(jù)交互能力；
? 完善空間下采樣比率定義；
? 全面升級(jí)依賴與版本號(hào)，穩(wěn)定性更高。
本次更新使ComfyUI在可擴(kuò)展性與開發(fā)靈活度上邁出關(guān)鍵一步，也為后續(xù)新功能的迭代打下堅(jiān)實(shí)基礎(chǔ)。
結(jié)語：
ComfyUI v0.11.1，不只是一次版本迭代，更是對(duì)創(chuàng)作者與開發(fā)者生態(tài)的全面優(yōu)化。
從節(jié)點(diǎn)定義到API拓展，從兼容性到架構(gòu)精煉，讓工作流構(gòu)建更簡(jiǎn)單、更自由、更可靠。
我們相信人工智能為普通人提供了一種“增強(qiáng)工具”，并致力于分享全方位的AI知識(shí)。在這里，您可以找到最新的AI科普文章、工具評(píng)測(cè)、提升效率的秘籍以及行業(yè)洞察。 歡迎關(guān)注“福大大架構(gòu)師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來發(fā)展。
特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布，本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
