Timer Node KJ (TimerNodeKJ) - ComfyUI-KJNodes

Timer Node KJ 是一个用于测量工作流中特定环节执行时间的工具节点。它允许用户启动和停止计时器，从而量化处理步骤的耗时，帮助进行性能分析和优化。

节点功能

此节点通过内部调用 Python 的 time.time() 函数来记录时间戳。其核心机制依赖于一个 TIMER 对象，该对象在“start”模式下被创建并初始化，在“stop”模式下计算并返回从启动到停止所经过的毫秒数。节点设计为可以传递任意类型的数据流，确保其能够无缝集成到现有工作流中而不中断数据处理。可选的 timer 输入允许链式连接计时器实例，从而在节点之间传递计时器状态以进行顺序测量。

节点参数说明 - Timer Node KJ

输入 (Inputs)

参数名称	数据类型	必填	默认值	取值范围/选项	描述
`any_input`	IO	是	-	-	any_input（输入参数）：接收任意类型的输入数据。节点会将其原样传递至输出，不影响计时功能。
`timer`	TIMER	否	-	-	timer（输入参数）：可选的输入，用于接收来自另一个 Timer 节点的现有 `TIMER` 对象。使用它可以将多个计时器节点链式连接以实现顺序计时。断开连接则作为独立计时器使用。

控件参数 (Parameters)

参数名称	数据类型	必填	默认值	取值范围/选项	描述
`mode`	COMBO	是	start	"start", "stop"	mode（输入参数）：设置计时器的工作模式。可选值为“start”（启动新计时）或“stop”（停止当前计时并计算结果）。
`name`	STRING	是	Timer	-	name（输入参数）：为当前计时器指定一个名称，便于在多个计时任务中进行区分。默认名称为“Timer”。

输出

参数名称	数据类型	描述
any_output	ANY	any_output（输出参数）：原样输出 `any_input` 接收到的数据，保证工作流数据连续性。
timer	TIMER	timer（输出参数）：输出当前状态下的 `TIMER` 对象，用于在节点间传递计时器实例以实现链式连接。
time	INT	time（输出参数）：在“stop”模式下输出计时结果，单位为毫秒的整数值；在“start”模式下输出0。

使用场景

在构建复杂工作流时，你可以使用此节点来诊断瓶颈。例如，将一个图像生成流程拆解，在“加载模型”和“生成图像”两个步骤前后分别放置此节点，并设置为“start”和“stop”模式，通过连接 TIMER 对象来测量每个子步骤的具体耗时，从而找出最耗时的环节。可选的 timer 输入允许你链式连接后续测量而不丢失计时器状态。

注意事项

使用时需注意，TIMER 对象需要在“start”和“stop”模式的节点间正确连接以传递计时状态。不正确的连接或模式设置可能导致计时功能无法正常工作或返回零值。

Timer Node KJ 节点源码链接

Timer Node KJ 节点来自 ComfyUI-KJNodes 节点包。

Timer Node KJ(TimerNodeKJ)

Timer Node KJ