Script Graph

使用指南

语言基础 / 集合节点

语言基础 / 集合 节点手册,包含 13 个节点的用途、引脚、使用场景和注意事项。

16

学习目标

用可视化方式表达字符串、数组、对象、集合、日期、JSON 和基础运算。

覆盖范围

  • 节点数量:13
  • 分类路径:语言基础 / 集合

典型使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

通用注意事项

  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

节点索引

节点节点 ID输入/输出执行方式
合并两个集合languageBaseSetUnion2 / 1立即继续
获取集合数量languageBaseSetSize1 / 1立即继续
集合转数组languageBaseSetToArray1 / 1立即继续
加入集合元素languageBaseSetAdd2 / 1立即继续
检查集合成员languageBaseSetHas2 / 1立即继续
排除右侧元素languageBaseSetSubtract2 / 1立即继续
清空集合languageBaseSetClear1 / 1立即继续
取共同元素languageBaseSetIntersect2 / 1立即继续
删除集合元素languageBaseSetDelete2 / 2立即继续
数组去重为集合languageBaseArrayToSet1 / 1立即继续
原地加入集合元素languageBaseSetAddInPlace3 / 2立即继续
原地清空集合languageBaseSetClearInPlace2 / 2立即继续
原地删除集合元素languageBaseSetDeleteInPlace3 / 3立即继续

合并两个集合

合并两个集合:把左边集合和右边集合里的内容合并成一份新的唯一结果。 适合把两个来源的唯一名单、已收集条目或状态标记汇总到一起。 顺序规则:系统会先保留左边原有顺序,再把右边里左边还没有的内容按顺序补上。

节点信息

字段
节点 IDlanguageBaseSetUnion
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
left左集合数据unknown / set左集合
作为这次合并的基础集合。结果会先保留它原有的顺序。
-必填
right右集合数据unknown / set右集合
提供要补充进结果中的内容。只有左边还没有的元素才会被追加进去。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果集合数据unknown / set结果集合
输出合并后的新集合,不会直接改动左右两边的输入集合。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

获取集合数量

获取集合数量:返回当前集合里一共有多少个唯一元素。 适合做判空、数量限制或显示统计信息。

节点信息

字段
节点 IDlanguageBaseSetSize
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
set集合数据unknown / set集合
连接要统计数量的集合。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
size数量数据number数量
返回集合当前包含的唯一元素数量。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

集合转数组

集合转数组:把集合里的唯一元素,按加入先后顺序整理成数组。 适合后续继续交给数组节点、遍历节点或文本拼接节点使用。

节点信息

字段
节点 IDlanguageBaseSetToArray
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
set集合数据unknown / set集合
连接要导出为数组的集合。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果数组数据unknown / array结果数组
输出按加入顺序整理好的数组,方便继续接数组相关节点。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

加入集合元素

加入集合元素:把一个元素加入集合,并返回加入后的新集合。 集合和普通列表不同,它会自动避免重复内容。适合维护唯一名单、已解锁奖励、已访问区域或已触发事件记录。 注意:这个节点不会直接改动输入集合本身。如果加入的是对象,只有指向同一份对象时,系统才会把它认作同一个元素。

节点信息

字段
节点 IDlanguageBaseSetAdd
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
set集合数据unknown / set集合
连接要作为基础的集合。节点会在这份内容之上生成一份新的结果集合。
-必填
value元素数据unknown元素
这是你想加入集合的内容。元素类型会跟随集合里的元素类型自动联动。
会根据已连接内容自动提供选择必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果集合数据unknown / set结果集合
返回加入元素后的新集合。若元素本来就存在,结果仍会保持唯一,不会重复堆叠。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

检查集合成员

检查集合成员:判断指定元素是否已经存在于集合里。 适合在加入前先做保护判断,或者检查某个奖励、区域、角色状态是否已经登记过。 注意:如果元素是对象,只有同一份对象才会被视为同一个成员。

节点信息

字段
节点 IDlanguageBaseSetHas
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
set集合数据unknown / set集合
连接要检查的集合。
-必填
value元素数据unknown元素
输入要检查的元素。节点会判断它是否已经在集合中。
会根据已连接内容自动提供选择必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result存在数据boolean存在
如果集合里已经有这个元素,这里输出真;否则输出假。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

排除右侧元素

排除右侧元素:从左边集合中剔除右边已经拥有的内容,并返回新的结果集合。 适合做“候选名单减去已完成名单”“全部区域减去已访问区域”这类排除场景。 顺序规则:结果顺序仍然以左边集合为准,只是把需要排除的元素去掉。

节点信息

字段
节点 IDlanguageBaseSetSubtract
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
left左集合数据unknown / set左集合
这是需要被保留和裁剪的主集合。
-必填
right右集合数据unknown / set右集合
这里的元素会作为排除条件,从左边集合中删掉对应内容。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果集合数据unknown / set结果集合
输出剔除右侧元素后的新集合。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

清空集合

清空集合:返回一份新的空集合。 适合在保留旧集合的同时,重新开始记录一组新的唯一内容。

节点信息

字段
节点 IDlanguageBaseSetClear
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
set集合数据unknown / set集合
连接要作为清空参考的集合。节点会返回一份新的空集合,而不是直接改它。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果集合数据unknown / set结果集合
这里始终输出一份新的空集合。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

取共同元素

取共同元素:只保留左边集合和右边集合都同时拥有的内容。 适合筛选“既满足条件 A 又满足条件 B”的唯一名单。 顺序规则:结果顺序以左边集合为准,右边只负责决定哪些元素可以留下。

节点信息

字段
节点 IDlanguageBaseSetIntersect
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
left左集合数据unknown / set左集合
这是筛选的主集合。结果顺序会以它为准。
-必填
right右集合数据unknown / set右集合
用来判断哪些元素可以保留下来。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果集合数据unknown / set结果集合
输出两边都拥有的元素集合。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

删除集合元素

删除集合元素:从集合里移除一个元素,并返回删除后的新集合。 适合从已完成列表、已访问区域或临时黑名单里撤销一项记录。 注意:就算集合里没有找到这个元素,节点也不会报错,而是返回一份内容等价的新集合,并通过“是否删除”告诉你这次有没有真正删掉内容。

节点信息

字段
节点 IDlanguageBaseSetDelete
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
set集合数据unknown / set集合
连接要删除元素的集合。
-必填
value元素数据unknown元素
输入你想删除的元素。
会根据已连接内容自动提供选择必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果集合数据unknown / set结果集合
返回删除后的新集合。原输入集合不会被直接改动。
-可选
removed是否删除数据boolean是否删除
如果这次真的删掉了一个元素,这里输出真;如果元素原本就不在集合里,这里输出假。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

数组去重为集合

数组去重为集合:把一组可能重复的列表内容整理成只保留唯一元素的集合。 适合把掉落列表、候选名单、标签列表或临时记录做一次去重。 注意:结果会保留数组里第一次出现该元素时的顺序,后面重复出现的内容会被自动忽略。

节点信息

字段
节点 IDlanguageBaseArrayToSet
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
array数组数据unknown / array数组
连接一组可能包含重复内容的列表。节点会把它整理成唯一集合。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
result结果集合数据unknown / set结果集合
返回去重后的集合。每种内容只会保留一份。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

原地加入集合元素

原地加入集合元素:直接把一个元素加入输入集合本身,并沿执行流继续往后传递这同一份集合。 适合在事件链、游戏运行时缓存或共享状态里持续维护同一份唯一集合。 注意:这是一个副作用节点,会直接改动原集合。如果其他分支也在使用同一份集合,它们会看到相同变化;如果你还要保留旧集合,请改用纯函数版“加入集合元素”。集合仍会自动去重,已存在的元素不会重复加入。

节点信息

字段
节点 IDlanguageBaseSetAddInPlace
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口
执行流走到这里时,节点会直接改动原集合,然后再继续往后执行。
-可选
set集合数据unknown / set集合
把要直接改动的原集合连到这里。若输入不是集合,系统会先创建一份新的空集合,再把元素加入进去。
-必填
value元素数据unknown元素
这里是要加入原集合的内容。元素类型会跟随集合元素类型自动联动。
会根据已连接内容自动提供选择必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流继续执行
当这次原地修改完成后,流程会从这里继续。
-可选
set集合数据unknown / set集合
输出已经被原地写入后的同一份集合引用,可继续传给下游副作用节点。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

原地清空集合

原地清空集合:直接移除输入集合本身中的全部元素,并沿执行流继续传递这同一份集合。 适合把共享上下文、游戏运行时记录或临时去重名单原地重置为空。 注意:这是一个副作用节点,会直接改动原集合。如果你还要保留旧集合,请改用纯函数版“清空集合”。若输入不是集合,系统会安全地创建一份新的空集合继续往下传。

节点信息

字段
节点 IDlanguageBaseSetClearInPlace
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口
执行流走到这里时,节点会直接改动原集合,然后再继续往后执行。
-可选
set集合数据unknown / set集合
把要直接清空的原集合连到这里。若输入不是集合,系统会先创建一份新的空集合。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流继续执行
当这次原地修改完成后,流程会从这里继续。
-可选
set集合数据unknown / set集合
输出已经被原地清空后的同一份集合引用。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。

原地删除集合元素

原地删除集合元素:直接从输入集合本身移除指定元素,并继续透传这同一份集合。 适合从共享状态、命中缓存或临时黑名单中按执行顺序撤销记录。 注意:这是一个副作用节点,会直接改动原集合。如果元素不存在,节点不会报错,只会保持原集合内容不变,并输出“是否删除 = false”;如果你还要保留旧集合,请改用纯函数版“删除集合元素”。

节点信息

字段
节点 IDlanguageBaseSetDeleteInPlace
分类语言基础
二级分类集合
分组-
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口
执行流走到这里时,节点会直接改动原集合,然后再继续往后执行。
-可选
set集合数据unknown / set集合
把要直接删除元素的原集合连到这里。若输入不是集合,系统会先创建一份新的空集合,再按安全边界继续执行。
-必填
value元素数据unknown元素
输入你想从原集合中移除的元素。
会根据已连接内容自动提供选择必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流继续执行
当这次原地修改完成后,流程会从这里继续。
-可选
set集合数据unknown / set集合
输出删除处理后的同一份集合引用。即使没有删到元素,也会继续透传这份集合。
-可选
removed是否删除数据boolean是否删除
true 表示这次确实从原集合里删掉了一个已有元素;false 表示原集合里没有这个元素。
-可选

使用场景

  • 拼接 UI 文本和提示信息
  • 处理数组列表、Map、Set 等集合
  • 构造条件表达式和数据转换逻辑

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 动态类型节点会跟随主输入推导类型,连线后要留意下游类型变化。
  • 集合类节点常区分元素、数组、映射和集合基数。