ComfyUI v0.19.3 更新详解:节点模板、SVG 模型、价格徽章与 Hunyuan3D 输出优化全面升级

张开发
2026/4/20 11:12:36 15 分钟阅读
ComfyUI v0.19.3 更新详解:节点模板、SVG 模型、价格徽章与 Hunyuan3D 输出优化全面升级
ComfyUI v0.19.3 已于 2026 年 4 月 17 日发布。本次版本属于Immutable release也就是说发布后只有release title 和 notes可以修改。一、版本概览ComfyUI v0.19.3 的更新内容虽然不是大量结构性重构但每一项都非常贴近实际使用场景主要集中在以下几个方面文本生成节点 LTX 模板能力增强API 节点价格徽章修正新增 Arrow SVG 模型工作流模板更新到 v0.9.57Hunyuan3D 的 obj 输出改为可选版本号与依赖同步更新从变更文件来看本次版本涉及多个模块包括comfy_api_nodes/nodes_hunyuan3d.pycomfy_api_nodes/nodes_quiver.pycomfy_api_nodes/nodes_stability.pycomfy_extras/nodes_textgen.pycomfyui_version.pypyproject.tomlrequirements.txt整体上可以看出v0.19.3 的重点是节点能力增强、输出兼容性优化、价格展示修正以及模板同步。二、nodes_textgen为 LTX 实现 use_default_template本次更新中一个重要变化来自comfy_extras/nodes_textgen.py核心是为 LTX 实现use_default_template1. 这次修改做了什么从代码变化来看LTX2相关的执行函数签名发生了变化原来execute(cls, clip, prompt, max_length, sampling_mode, imageNone, thinkingFalse)现在execute(cls, clip, prompt, max_length, sampling_mode, imageNone, thinkingFalse, use_default_templateTrue)也就是说这里新增了一个参数use_default_template并且在调用父类执行方法时将这个参数一并传递下去原来返回super().execute(..., image, thinking)现在返回super().execute(..., image, thinking, use_default_template)2. 这个变化的意义从更新说明本身可知这次是让 LTX 支持use_default_template。这意味着在文本生成流程中LTX 不再只是固定地使用某种模板逻辑而是能够根据默认模板开关进行控制。3. 具体影响更新后的逻辑仍然保留了原有的 prompt 组织方式如果没有image使用LTX2_T2V_SYSTEM_PROMPT拼接User Raw Input Prompt: {prompt}.如果有image使用LTX2_I2V_SYSTEM_PROMPT中间插入image_soft_token也就是说这次改动的重点不在于 prompt 内容本身变化而在于模板使用方式增加了可控性从而让 LTX 的行为更加贴合默认模板机制。三、fix(api-nodes)修正 StabilityAI 价格徽章本次版本对comfy_api_nodes/nodes_stability.py做了价格徽章修正相关更新说明明确指出corrected StabilityAI price badges1. 修改内容这次一共修正了三处价格表达式0.25改为0.40.25改为0.60.01改为0.02对应的文件片段显示原本某些 API 节点的IO.PriceBadge中写入的价格值过低现已更新为新的价格值。2. 涉及的意义price_badge通常用于展示节点调用成本或价格信息。价格徽章不准确会导致用户在选择节点时对成本预期产生偏差。因此这次修正主要带来的好处是价格展示更准确节点成本提示更可信有助于用户在工作流搭建时做出正确选择3. 为什么要单独修正从变更形式可以看到这类修改并没有影响节点功能主体而是针对展示信息进行了修补。也就是说节点本身的执行逻辑未必改变但价格提示层面的信息已经更新。对于经常使用 API 节点的用户来说这类修正非常重要因为它直接影响到调用成本的判断。四、[Partner Nodes] 新增 arrow-1.1 与 arrow-1.1-max SVG 模型本次更新中comfy_api_nodes/nodes_quiver.py是变化较大的文件之一。更新说明中提到add new “arrow-1.1” and “arrow-1.1-max” SVG models1. 新增了哪些模型当前 SVG 相关模型列表已经扩展为arrow-1.1arrow-1.1-maxarrow-preview文件中定义了_ARROW_MODELS[arrow-1.1,arrow-1.1-max,arrow-preview]这意味着原先可选的模型集合已增加两个新模型。2. 共享采样输入被抽成函数更新中还增加了一个共享函数def_arrow_sampling_inputs():这个函数统一返回一组采样输入包括temperaturetop_ppresence_penalty这些参数的默认值、范围、步进和提示信息也被统一封装。例如temperature默认值1.0范围0.0 到 2.0步进0.1top_p默认值1.0范围0.05 到 1.0步进0.05presence_penalty默认值0.0范围-2.0 到 2.0步进0.13. Text to SVG 节点的变化在QuiverTextToSVGNode中模型选项不再只写单一模型而是通过列表推导为_ARROW_MODELS中的每个模型动态生成选项options[IO.DynamicCombo.Option(m,_arrow_sampling_inputs())formin_ARROW_MODELS]这说明模型选项更完整采样输入配置被复用代码结构更整洁同时文本到 SVG 节点的price_badge也不再是固定值而是根据model动态计算。4. 价格徽章改为动态表达式原本价格徽章写的是0.429现在改成一个根据模型类型判断的表达式如果包含max价格为0.3575如果包含preview价格为0.429否则价格为0.286也就是说箭头模型的价格提示已经按模型类别细分不再统一展示单一价格。5. Text to SVG 和 SVG vectorization 两个节点都同步更新文件中可以看到不只是一个节点改动实际上有两个节点相关部分都进行了更新一个是文本生成 SVG一个是SVG 矢量化它们都使用了_ARROW_MODELS和_arrow_sampling_inputs()并且都配置了动态价格徽章。6. 这一变化的价值这次更新的价值主要体现在新增模型可直接选用参数结构统一价格显示与模型对应节点定义更规范减少重复代码对用户而言这意味着在使用 Quiver 相关 API 节点时可选项更加清晰成本提示也更准确。五、[Partner Nodes] Hunyuan3D 的 obj 输出改为可选另一个重要变化在comfy_api_nodes/nodes_hunyuan3d.py更新说明提到make “obj” output optional in Hunyuan3D Text and Image to 3D1. 原来的问题从 diff 可以看出原先代码直接调用get_file_from_response(result.ResultFile3Ds,obj).Url这意味着程序默认假设obj文件一定存在。但现在改成了obj_file_responseget_file_from_response(result.ResultFile3Ds,obj,raise_if_not_foundFalse)然后判断ifobj_file_response:obj_resultawaitdownload_and_extract_obj_zip(obj_file_response.Url)也就是说如果obj文件不存在不会直接报错而是允许它为空。2. 输出返回值也跟着调整更新后的IO.NodeOutput中obj_result.obj if obj_result else Noneobj_result.texture if obj_result else None这说明输出端也增加了空值兼容。3. 两处执行逻辑都做了类似处理从 diff 可见这种处理不仅出现在一处而是在两个执行区域都进行了调整。第二处更新也采用了同样的思路先尝试获取obj文件响应如果存在则下载并解压如果不存在则跳过这一步同时在输出中用None做兼容处理。4. 这次修改的意义这一调整的核心意义在于提高节点对结果文件差异的容错能力避免因obj缺失导致流程失败让 Hunyuan3D 的 Text to 3D 和 Image to 3D 输出更稳定对于实际使用者而言这类改动非常实用因为生成结果并不总是严格包含每一种格式输出可选化可以显著提升工作流的稳定性。六、工作流模板更新到 v0.9.57本次版本还同步更新了工作流模板依赖requirements.txt中的内容显示comfyui-workflow-templates0.9.54更新为comfyui-workflow-templates0.9.57同时更新说明也明确写出Update workflow templates to v0.9.571. 这意味着什么这表示本次版本在发布时已经同步采用了更新后的工作流模板版本。虽然这类变化通常不直接体现在核心计算逻辑里但会影响默认模板、示例模板或相关工作流结构。2. 对用户的影响对用户来说这类更新通常意味着新模板版本已同步相关工作流定义保持一致使用体验更贴近当前版本生态3. 与版本发布的联动关系从本次变更链条看模板更新属于版本同步的一部分与节点修正、模型扩充、输出优化一起构成了 v0.19.3 的整体升级内容。七、版本号同步更新本次版本中comfyui_version.py与pyproject.toml都从0.19.2更新到了0.19.3。1.comfyui_version.py文件中版本号由__version__ 0.19.2更新为__version__ 0.19.32.pyproject.toml项目版本字段由version 0.19.2更新为version 0.19.33. 说明这属于典型的版本发布同步操作确保项目元数据、运行时版本和发布版本一致。八、本次更新的整体特点综合来看ComfyUI v0.19.3 的更新虽然没有大规模改写核心框架但每项都很“实用型”1. 更好的模板支持LTX 增加use_default_template说明文本生成节点的模板控制能力更进一步。2. 更准确的成本提示StabilityAI 价格徽章修正以及 Arrow 模型价格徽章动态化都让价格展示更真实。3. 更丰富的模型可选项新增arrow-1.1与arrow-1.1-max让 Quiver 相关节点具备更多模型选择。4. 更稳定的 3D 输出Hunyuan3D 的obj输出改为可选减少因结果文件缺失导致的报错。5. 版本与依赖同步更新工作流模板升级到 v0.9.57版本号也完成同步。九、涉及文件一览本次更新实际涉及的文件包括comfy_api_nodes/nodes_hunyuan3d.pycomfy_api_nodes/nodes_quiver.pycomfy_api_nodes/nodes_stability.pycomfy_extras/nodes_textgen.pycomfyui_version.pypyproject.tomlrequirements.txt从文件分布上看这次更新覆盖了文本生成SVG 相关节点3D 相关节点API 价格展示版本信息与依赖范围比较分散但主题非常集中都是围绕实际功能体验进行优化。十、结语代码地址github.com/Comfy-Org/ComfyUIComfyUI v0.19.3 是一次偏实用导向的版本更新。它没有追求大范围的架构变化而是围绕真实使用过程中最容易遇到的问题进行了针对性处理LTX 模板控制更灵活API 节点价格展示更准确SVG 模型支持更完整Hunyuan3D 输出更稳健工作流模板版本同步升级对于日常使用 ComfyUI 的用户而言这些变化虽然看起来不算“夸张”但实际上会明显改善使用体验尤其是在 API 节点调用、生成结果兼容性以及工作流模板一致性方面。

更多文章