GetListIsEmpty 列表判空与非空校验节点

节点核心功能 (What is it?)

GetListIsEmpty 节点是一个实用的列表状态校验工具节点，用于检查输入的列表是否为空列表（即列表内是否包含任何有效子元素），并输出标准的布尔值标志位。

典型适用场景 (When would I use it?)

在以下情况下使用 GetListIsEmpty 节点：

• 检查列表内是否至少存在一项有效数据；
• 在执行昂贵的大模型推理或批处理计算之前，对输入列表进行非空前置断言与校验；
• 构建基于列表是否有数据的条件分支与熔断保护工作流；
• 确保上游数据抽取或清洗管线已成功产生实际结果；
• 监视动态循环处理过程中队列是否已经被完全消费清空。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

1. 在工作流画布中添加 GetListIsEmpty 节点。
2. 将待判定的任意列表连接至 items 输入插槽。
3. 节点将自动判定该列表状态，并从 is_empty 引脚输出布尔判定结果。

参数输入插槽 (Parameters)

• items：待执行判空检测的目标列表（list 类型输入端）。

输出引脚 (Outputs)

• is_empty：布尔值输出端（boolean）：若列表为空（长度为 0）则输出 true；若列表包含至少一个元素则输出 false。

典型工作流示例 (Example)

检查任务批处理清单中是否存在待办项：

1. 在工作流画布中添加 GetListIsEmpty 节点。
2. 将任务分配节点的输出列表连入 items 输入插槽。
3. 若此时任务已全部处理完毕，is_empty 引脚将输出 true；若仍有剩余任务，则输出 false。

关键技术特性 (Important Notes)

• 自动响应式重算：当上游列表的元素数量或状态发生变化时，判定结果实时同步刷新；
• 多态列表兼容：适用于容纳任意数据类型的同构或异构列表；
• 未连接安全默认为空：若未接入任何列表，节点默认安全输出 true（视为空）；
• 输出为纯布尔标量：方便直接连入后续的条件门控节点。

常见问题与排查 (Common Issues)

• 未接入输入 (No Input)：未连接输入端时默认返回 true。
• 非法输入类型容错 (Invalid Input)：若传入的对象非列表类型，节点同样会将其视为空处理并安全返回 true。