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

ComfyUI v0.19.3 已于 2026 年 4 月 17 日发布。本次版本属于Immutable release，也就是说发布后只有release title 和 notes可以修改。

一、版本概览

ComfyUI v0.19.3 的更新内容虽然不是大量结构性重构，但每一项都非常贴近实际使用场景，主要集中在以下几个方面：

1. 文本生成节点 LTX 模板能力增强
2. API 节点价格徽章修正
3. 新增 Arrow SVG 模型
4. 工作流模板更新到 v0.9.57
5. Hunyuan3D 的 obj 输出改为可选
6. 版本号与依赖同步更新

从变更文件来看，本次版本涉及多个模块，包括：

• comfy_api_nodes/nodes_hunyuan3d.py
• comfy_api_nodes/nodes_quiver.py
• comfy_api_nodes/nodes_stability.py
• comfy_extras/nodes_textgen.py
• comfyui_version.py
• pyproject.toml
• requirements.txt

整体上可以看出，v0.19.3 的重点是节点能力增强、输出兼容性优化、价格展示修正以及模板同步。

二、nodes_textgen：为 LTX 实现 use_default_template

本次更新中，一个重要变化来自comfy_extras/nodes_textgen.py，核心是：

为 LTX 实现use_default_template

1. 这次修改做了什么

从代码变化来看，LTX2相关的执行函数签名发生了变化：

• 原来：
  • execute(cls, clip, prompt, max_length, sampling_mode, image=None, thinking=False)
• 现在：
  • execute(cls, clip, prompt, max_length, sampling_mode, image=None, thinking=False, use_default_template=True)

也就是说，这里新增了一个参数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 badges

1. 修改内容

这次一共修正了三处价格表达式：

• 0.25改为0.4
• 0.25改为0.6
• 0.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 models

1. 新增了哪些模型

当前 SVG 相关模型列表已经扩展为：

• arrow-1.1
• arrow-1.1-max
• arrow-preview

文件中定义了：

_ARROW_MODELS=["arrow-1.1","arrow-1.1-max","arrow-preview"]

这意味着原先可选的模型集合已增加两个新模型。

2. 共享采样输入被抽成函数

更新中还增加了一个共享函数：

def_arrow_sampling_inputs():

这个函数统一返回一组采样输入，包括：

• temperature
• top_p
• presence_penalty

这些参数的默认值、范围、步进和提示信息也被统一封装。

例如：

• temperature
  • 默认值：1.0
  • 范围：0.0 到 2.0
  • 步进：0.1
• top_p
  • 默认值：1.0
  • 范围：0.05 到 1.0
  • 步进：0.05
• presence_penalty
  • 默认值：0.0
  • 范围：-2.0 到 2.0
  • 步进：0.1

3. 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 3D

1. 原来的问题

从 diff 可以看出，原先代码直接调用：

get_file_from_response(result.ResultFile3Ds,"obj").Url

这意味着程序默认假设obj文件一定存在。

但现在改成了：

obj_file_response=get_file_from_response(result.ResultFile3Ds,"obj",raise_if_not_found=False)

然后判断：

ifobj_file_response:obj_result=awaitdownload_and_extract_obj_zip(obj_file_response.Url)

也就是说，如果obj文件不存在，不会直接报错，而是允许它为空。

2. 输出返回值也跟着调整

更新后的IO.NodeOutput中：

• obj_result.obj if obj_result else None
• obj_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-templates==0.9.54
• 更新为comfyui-workflow-templates==0.9.57

同时，更新说明也明确写出：

Update workflow templates to v0.9.57

1. 这意味着什么

这表示本次版本在发布时，已经同步采用了更新后的工作流模板版本。虽然这类变化通常不直接体现在核心计算逻辑里，但会影响默认模板、示例模板或相关工作流结构。

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.3"

2.pyproject.toml

项目版本字段由：

• version = "0.19.2"

更新为：

• version = "0.19.3"

3. 说明

这属于典型的版本发布同步操作，确保项目元数据、运行时版本和发布版本一致。

八、本次更新的整体特点

综合来看，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.py
• comfy_api_nodes/nodes_quiver.py
• comfy_api_nodes/nodes_stability.py
• comfy_extras/nodes_textgen.py
• comfyui_version.py
• pyproject.toml
• requirements.txt

从文件分布上看，这次更新覆盖了：

• 文本生成
• SVG 相关节点
• 3D 相关节点
• API 价格展示
• 版本信息与依赖

范围比较分散，但主题非常集中，都是围绕实际功能体验进行优化。

十、结语

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

ComfyUI v0.19.3 是一次偏实用导向的版本更新。它没有追求大范围的架构变化，而是围绕真实使用过程中最容易遇到的问题进行了针对性处理：

• LTX 模板控制更灵活
• API 节点价格展示更准确
• SVG 模型支持更完整
• Hunyuan3D 输出更稳健
• 工作流模板版本同步升级

对于日常使用 ComfyUI 的用户而言，这些变化虽然看起来不算“夸张”，但实际上会明显改善使用体验，尤其是在 API 节点调用、生成结果兼容性以及工作流模板一致性方面。