Widget To String (WidgetToString) - ComfyUI-KJNodes

Widget To String 节点通过三种主要方式定位目标节点：使用节点的唯一ID、通过用户自定义的节点标题，或者连接输入到any_input接口（当未提供ID或标题时使用）。

Widget To String 节点是一个用于提取工作流中其他节点控件值的工具。它能将指定节点上特定控件的当前值捕获并转换为字符串格式输出，方便在其他需要文本输入的节点中使用。

节点功能

此节点通过三种主要方式定位目标节点：使用节点的唯一ID、通过用户自定义的节点标题，或者在未提供ID和标题时使用any_input连接作为回退。它支持从目标节点的单个或多个控件（通过逗号分隔列表指定）中提取值，并能处理整数、浮点数、布尔值等多种数据类型。其内部机制会解析工作流元数据，根据提供的定位信息找到对应节点，再读取指定控件的值，最后根据设置（如浮点数小数位数）将其格式化为字符串。

连接输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`any_input`	IO	否	-	-	一个可选的连接，用于在未设置`id`或`node_title`时标识目标节点。同时确保目标节点存在于工作流中。通常连接到您希望读取值的节点。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`id`	INT	是	0	0 - 100000 (步长: 1)	指定目标节点的唯一数字ID，用于精确查找节点。设置为0时，若已设置则使用`any_input`连接或`node_title`。取值范围为0至100000，步长为1。
`widget_name`	STRING	是	-	-	指定要从目标节点读取的控件名称。可以是单个控件名，或用逗号分隔的多个控件名列表。
`return_all`	BOOLEAN	是	False	-	控制当`widget_name`指定多个控件时的输出行为。为False时输出第一个有效值，为True时将所有值拼接为一个字符串输出。
`node_title`	STRING	否	-	-	通过用户自定义的节点标题来查找目标节点。仅当节点标题被手动修改过时才有效。
`allowed_float_decimals`	INT	否	2	0 - 10	浮点数值显示的小数位数。

输出

参数名称	数据类型	说明
STRING	STRING	将读取到的控件值转换后输出的字符串。

使用场景

在一个图像生成工作流中，您可以使用此节点读取一个KSampler节点的“seed”控件的值，并将其作为文件名的一部分传递给Save Image节点。或者，您也可以用它来捕获一组LoRA节点的权重设置，并将其拼接成一个描述性的提示词文本。

注意事项

请注意，使用节点ID进行定位时，需要在ComfyUI主设置中启用“节点ID标签”以显示ID。节点标题仅当用户手动编辑过节点标题时才存在，否则无法通过此方式查找。
如果将id保留为0且node_title留空，则必须连接输入到any_input以指定目标节点。

Widget To String 节点来自 ComfyUI-KJNodes 节点包。

Widget To String(WidgetToString)

Widget To String