使用指南
语言基础 / 集合节点
语言基础 / 集合 节点手册,包含 13 个节点的用途、引脚、使用场景和注意事项。
学习目标
用可视化方式表达字符串、数组、对象、集合、日期、JSON 和基础运算。
覆盖范围
- 节点数量:13
- 分类路径:语言基础 / 集合
典型使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
通用注意事项
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 合并两个集合 | languageBaseSetUnion | 2 / 1 | 立即继续 |
| 获取集合数量 | languageBaseSetSize | 1 / 1 | 立即继续 |
| 集合转数组 | languageBaseSetToArray | 1 / 1 | 立即继续 |
| 加入集合元素 | languageBaseSetAdd | 2 / 1 | 立即继续 |
| 检查集合成员 | languageBaseSetHas | 2 / 1 | 立即继续 |
| 排除右侧元素 | languageBaseSetSubtract | 2 / 1 | 立即继续 |
| 清空集合 | languageBaseSetClear | 1 / 1 | 立即继续 |
| 取共同元素 | languageBaseSetIntersect | 2 / 1 | 立即继续 |
| 删除集合元素 | languageBaseSetDelete | 2 / 2 | 立即继续 |
| 数组去重为集合 | languageBaseArrayToSet | 1 / 1 | 立即继续 |
| 原地加入集合元素 | languageBaseSetAddInPlace | 3 / 2 | 立即继续 |
| 原地清空集合 | languageBaseSetClearInPlace | 2 / 2 | 立即继续 |
| 原地删除集合元素 | languageBaseSetDeleteInPlace | 3 / 3 | 立即继续 |
合并两个集合
合并两个集合:把左边集合和右边集合里的内容合并成一份新的唯一结果。 适合把两个来源的唯一名单、已收集条目或状态标记汇总到一起。 顺序规则:系统会先保留左边原有顺序,再把右边里左边还没有的内容按顺序补上。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetUnion |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
left | 左集合 | 数据 | unknown / set | 左集合 作为这次合并的基础集合。结果会先保留它原有的顺序。 | - | 必填 |
right | 右集合 | 数据 | unknown / set | 右集合 提供要补充进结果中的内容。只有左边还没有的元素才会被追加进去。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果集合 | 数据 | unknown / set | 结果集合 输出合并后的新集合,不会直接改动左右两边的输入集合。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
获取集合数量
获取集合数量:返回当前集合里一共有多少个唯一元素。 适合做判空、数量限制或显示统计信息。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetSize |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
set | 集合 | 数据 | unknown / set | 集合 连接要统计数量的集合。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
size | 数量 | 数据 | number | 数量 返回集合当前包含的唯一元素数量。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
集合转数组
集合转数组:把集合里的唯一元素,按加入先后顺序整理成数组。 适合后续继续交给数组节点、遍历节点或文本拼接节点使用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetToArray |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
set | 集合 | 数据 | unknown / set | 集合 连接要导出为数组的集合。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果数组 | 数据 | unknown / array | 结果数组 输出按加入顺序整理好的数组,方便继续接数组相关节点。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
加入集合元素
加入集合元素:把一个元素加入集合,并返回加入后的新集合。 集合和普通列表不同,它会自动避免重复内容。适合维护唯一名单、已解锁奖励、已访问区域或已触发事件记录。 注意:这个节点不会直接改动输入集合本身。如果加入的是对象,只有指向同一份对象时,系统才会把它认作同一个元素。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetAdd |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
set | 集合 | 数据 | unknown / set | 集合 连接要作为基础的集合。节点会在这份内容之上生成一份新的结果集合。 | - | 必填 |
value | 元素 | 数据 | unknown | 元素 这是你想加入集合的内容。元素类型会跟随集合里的元素类型自动联动。 | 会根据已连接内容自动提供选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果集合 | 数据 | unknown / set | 结果集合 返回加入元素后的新集合。若元素本来就存在,结果仍会保持唯一,不会重复堆叠。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
检查集合成员
检查集合成员:判断指定元素是否已经存在于集合里。 适合在加入前先做保护判断,或者检查某个奖励、区域、角色状态是否已经登记过。 注意:如果元素是对象,只有同一份对象才会被视为同一个成员。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetHas |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
set | 集合 | 数据 | unknown / set | 集合 连接要检查的集合。 | - | 必填 |
value | 元素 | 数据 | unknown | 元素 输入要检查的元素。节点会判断它是否已经在集合中。 | 会根据已连接内容自动提供选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 存在 | 数据 | boolean | 存在 如果集合里已经有这个元素,这里输出真;否则输出假。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
排除右侧元素
排除右侧元素:从左边集合中剔除右边已经拥有的内容,并返回新的结果集合。 适合做“候选名单减去已完成名单”“全部区域减去已访问区域”这类排除场景。 顺序规则:结果顺序仍然以左边集合为准,只是把需要排除的元素去掉。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetSubtract |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
left | 左集合 | 数据 | unknown / set | 左集合 这是需要被保留和裁剪的主集合。 | - | 必填 |
right | 右集合 | 数据 | unknown / set | 右集合 这里的元素会作为排除条件,从左边集合中删掉对应内容。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果集合 | 数据 | unknown / set | 结果集合 输出剔除右侧元素后的新集合。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
清空集合
清空集合:返回一份新的空集合。 适合在保留旧集合的同时,重新开始记录一组新的唯一内容。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetClear |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
set | 集合 | 数据 | unknown / set | 集合 连接要作为清空参考的集合。节点会返回一份新的空集合,而不是直接改它。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果集合 | 数据 | unknown / set | 结果集合 这里始终输出一份新的空集合。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
取共同元素
取共同元素:只保留左边集合和右边集合都同时拥有的内容。 适合筛选“既满足条件 A 又满足条件 B”的唯一名单。 顺序规则:结果顺序以左边集合为准,右边只负责决定哪些元素可以留下。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetIntersect |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
left | 左集合 | 数据 | unknown / set | 左集合 这是筛选的主集合。结果顺序会以它为准。 | - | 必填 |
right | 右集合 | 数据 | unknown / set | 右集合 用来判断哪些元素可以保留下来。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果集合 | 数据 | unknown / set | 结果集合 输出两边都拥有的元素集合。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
删除集合元素
删除集合元素:从集合里移除一个元素,并返回删除后的新集合。 适合从已完成列表、已访问区域或临时黑名单里撤销一项记录。 注意:就算集合里没有找到这个元素,节点也不会报错,而是返回一份内容等价的新集合,并通过“是否删除”告诉你这次有没有真正删掉内容。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetDelete |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
set | 集合 | 数据 | unknown / set | 集合 连接要删除元素的集合。 | - | 必填 |
value | 元素 | 数据 | unknown | 元素 输入你想删除的元素。 | 会根据已连接内容自动提供选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果集合 | 数据 | unknown / set | 结果集合 返回删除后的新集合。原输入集合不会被直接改动。 | - | 可选 |
removed | 是否删除 | 数据 | boolean | 是否删除 如果这次真的删掉了一个元素,这里输出真;如果元素原本就不在集合里,这里输出假。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
数组去重为集合
数组去重为集合:把一组可能重复的列表内容整理成只保留唯一元素的集合。 适合把掉落列表、候选名单、标签列表或临时记录做一次去重。 注意:结果会保留数组里第一次出现该元素时的顺序,后面重复出现的内容会被自动忽略。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseArrayToSet |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
array | 数组 | 数据 | unknown / array | 数组 连接一组可能包含重复内容的列表。节点会把它整理成唯一集合。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果集合 | 数据 | unknown / set | 结果集合 返回去重后的集合。每种内容只会保留一份。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
原地加入集合元素
原地加入集合元素:直接把一个元素加入输入集合本身,并沿执行流继续往后传递这同一份集合。 适合在事件链、游戏运行时缓存或共享状态里持续维护同一份唯一集合。 注意:这是一个副作用节点,会直接改动原集合。如果其他分支也在使用同一份集合,它们会看到相同变化;如果你还要保留旧集合,请改用纯函数版“加入集合元素”。集合仍会自动去重,已存在的元素不会重复加入。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetAddInPlace |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 执行流走到这里时,节点会直接改动原集合,然后再继续往后执行。 | - | 可选 |
set | 集合 | 数据 | unknown / set | 集合 把要直接改动的原集合连到这里。若输入不是集合,系统会先创建一份新的空集合,再把元素加入进去。 | - | 必填 |
value | 元素 | 数据 | unknown | 元素 这里是要加入原集合的内容。元素类型会跟随集合元素类型自动联动。 | 会根据已连接内容自动提供选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 继续执行 当这次原地修改完成后,流程会从这里继续。 | - | 可选 |
set | 集合 | 数据 | unknown / set | 集合 输出已经被原地写入后的同一份集合引用,可继续传给下游副作用节点。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
原地清空集合
原地清空集合:直接移除输入集合本身中的全部元素,并沿执行流继续传递这同一份集合。 适合把共享上下文、游戏运行时记录或临时去重名单原地重置为空。 注意:这是一个副作用节点,会直接改动原集合。如果你还要保留旧集合,请改用纯函数版“清空集合”。若输入不是集合,系统会安全地创建一份新的空集合继续往下传。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetClearInPlace |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 执行流走到这里时,节点会直接改动原集合,然后再继续往后执行。 | - | 可选 |
set | 集合 | 数据 | unknown / set | 集合 把要直接清空的原集合连到这里。若输入不是集合,系统会先创建一份新的空集合。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 继续执行 当这次原地修改完成后,流程会从这里继续。 | - | 可选 |
set | 集合 | 数据 | unknown / set | 集合 输出已经被原地清空后的同一份集合引用。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
原地删除集合元素
原地删除集合元素:直接从输入集合本身移除指定元素,并继续透传这同一份集合。 适合从共享状态、命中缓存或临时黑名单中按执行顺序撤销记录。 注意:这是一个副作用节点,会直接改动原集合。如果元素不存在,节点不会报错,只会保持原集合内容不变,并输出“是否删除 = false”;如果你还要保留旧集合,请改用纯函数版“删除集合元素”。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseSetDeleteInPlace |
| 分类 | 语言基础 |
| 二级分类 | 集合 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 执行流走到这里时,节点会直接改动原集合,然后再继续往后执行。 | - | 可选 |
set | 集合 | 数据 | unknown / set | 集合 把要直接删除元素的原集合连到这里。若输入不是集合,系统会先创建一份新的空集合,再按安全边界继续执行。 | - | 必填 |
value | 元素 | 数据 | unknown | 元素 输入你想从原集合中移除的元素。 | 会根据已连接内容自动提供选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 继续执行 当这次原地修改完成后,流程会从这里继续。 | - | 可选 |
set | 集合 | 数据 | unknown / set | 集合 输出删除处理后的同一份集合引用。即使没有删到元素,也会继续透传这份集合。 | - | 可选 |
removed | 是否删除 | 数据 | boolean | 是否删除 true 表示这次确实从原集合里删掉了一个已有元素;false 表示原集合里没有这个元素。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。