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

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

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

一、版本概览

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

1. 1. 文本生成节点 LTX 模板能力增强
2. 2. API 节点价格徽章修正
3. 3. 新增 Arrow SVG 模型
4. 4. 工作流模板更新到 v0.9.57
5. 5. Hunyuan3D 的 obj 输出改为可选
6. 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()) for m in _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)

然后判断：

if obj_file_response:
    obj_result = await download_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 节点调用、生成结果兼容性以及工作流模板一致性方面。

·

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。

·