语言基础 / 映射节点

学习目标

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

覆盖范围

• 节点数量：15
• 分类路径：语言基础 / 映射

典型使用场景

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

通用注意事项

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

节点索引

节点	节点 ID	输入/输出	执行方式
读取映射值	languageBaseMapGet	2 / 2	立即继续
读取映射值或默认值	languageBaseMapGetWithDefault	3 / 2	立即继续
对象转映射	languageBaseObjectToMap	1 / 1	立即继续
获取全部键名	languageBaseMapKeys	1 / 1	立即继续
获取全部键值记录	languageBaseMapEntries	1 / 1	立即继续
获取全部值	languageBaseMapValues	1 / 1	立即继续
获取映射数量	languageBaseMapSize	1 / 1	立即继续
检查映射键	languageBaseMapHas	2 / 1	立即继续
清空映射	languageBaseMapClear	1 / 1	立即继续
删除映射项	languageBaseMapDelete	2 / 2	立即继续
写入映射值	languageBaseMapSet	3 / 1	立即继续
映射转对象	languageBaseMapToObject	1 / 1	立即继续
原地清空映射	languageBaseMapClearInPlace	2 / 2	立即继续
原地删除映射项	languageBaseMapDeleteInPlace	3 / 3	立即继续
原地写入映射值	languageBaseMapSetInPlace	4 / 2	立即继续

读取映射值

读取映射值：按照键名，从映射里取出对应的一项值。 可以把映射理解成一张“名字对应内容”的表。适合按 ID、名字、状态码等文本键快速查值。 注意：如果键不存在，节点不会报错，而是返回空值，并通过“是否存在”告诉你这次有没有命中。

节点信息

字段	值
节点 ID	languageBaseMapGet
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接一个要读取的映射变量。它适合存放“键名 -> 值”的对应关系。	-	必填
key	键名	数据	string	键名 输入你想查找的键名。首版映射节点只支持文本键。	输入框 默认值：""	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
value	值	数据	unknown	值 命中后输出对应的值。若键不存在，这里会是空值。	-	可选
hasValue	是否存在	数据	boolean	是否存在 告诉你这个键是否真的存在，避免把“键不存在”和“值本来就是空”混在一起。	-	可选

使用场景

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

注意事项

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

---

读取映射值或默认值

读取映射值或默认值：按照键名读取映射中的值；如果键不存在，或命中的值本身是 undefined，就返回你提供的默认值。 适合读取可选配置、角色属性表、掉落表参数等场景。这样后续节点可以直接使用结果，不必额外再接一段“是否存在”的分支。 注意：默认值类型会跟随映射的值类型联动，避免把数字表误接成文本备用值。

节点信息

字段	值
节点 ID	languageBaseMapGetWithDefault
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要读取的映射变量。节点会根据这份映射决定默认值和结果值的类型。	-	必填
key	键名	数据	string	键名 输入要查找的键。首版映射节点只支持文本键。	输入框 默认值：""	必填
defaultValue	默认值	数据	unknown	默认值 当键不存在，或映射中保存的是 undefined 时，会输出这个备用值。可以直接在引脚里填写，也可以连接其它节点。	会根据已连接内容自动提供选择	可选

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
value	值	数据	unknown	读取结果 命中时输出映射里的值；未命中时输出默认值。	-	可选
hasValue	是否命中	数据	boolean	是否命中 true 表示映射里确实有这个键且值不是 undefined；false 表示本次使用了默认值。	-	可选

使用场景

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

注意事项

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

---

对象转映射

对象转映射：把普通对象的每个自有字段转换成映射中的一项。 适合把 JSON 解析结果、配置对象或临时字典接到映射节点链路里继续处理。 注意：如果输入不是普通对象，节点会安全地返回一份空映射。

节点信息

字段	值
节点 ID	languageBaseObjectToMap
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 连接要转换成映射的普通对象。节点只读取对象自己的字段。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	结果映射	数据	unknown / map	结果映射 输出转换后的新映射。对象里的每个字段都会变成一项键值对。	-	可选

使用场景

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

注意事项

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

---

获取全部键名

获取全部键名：把映射中的全部键名按顺序整理成数组。 适合做列表展示、遍历检查或调试输出。

节点信息

字段	值
节点 ID	languageBaseMapKeys
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要导出键名的映射。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
keys	键名列表	数据	string / array	键名列表 输出映射中的全部文本键，并保持原有顺序。	-	可选

使用场景

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

注意事项

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

---

获取全部键值记录

获取全部键值记录：把映射中的每一项整理成一条记录，并输出为数组。 每条记录都包含两个字段：key 和 value。这样你可以直接把结果交给数组遍历节点，再用对象字段节点读取每一项的键和值。

节点信息

字段	值
节点 ID	languageBaseMapEntries
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要导出键值记录的映射。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
entries	键值记录	数据	object / array	键值记录 输出一组包含 key 和 value 的记录，便于继续交给数组和对象节点处理。	-	可选

使用场景

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

注意事项

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

---

获取全部值

获取全部值：把映射中的全部值按顺序整理成数组。 适合把映射内容交给数组节点继续处理，例如遍历、筛选或拼接展示。

节点信息

字段	值
节点 ID	languageBaseMapValues
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要导出值列表的映射。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
values	值列表	数据	unknown / array	值列表 输出映射中的全部值数组，并保持原有顺序。	-	可选

使用场景

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

注意事项

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

---

获取映射数量

获取映射数量：返回当前映射里一共有多少项键值对。 适合做判空、限制数量或显示统计信息。

节点信息

字段	值
节点 ID	languageBaseMapSize
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

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

输出引脚

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

使用场景

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

注意事项

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

---

检查映射键

检查映射键：判断指定键名在映射里是否存在。 适合在读取前先做保护判断，或者在写入前决定是否要覆盖已有内容。

节点信息

字段	值
节点 ID	languageBaseMapHas
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要检查的映射。	-	必填
key	键名	数据	string	键名 输入要检查的键名。	输入框 默认值：""	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	存在	数据	boolean	存在 如果映射里有这个键，这里输出真；否则输出假。	-	可选

使用场景

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

注意事项

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

---

清空映射

清空映射：返回一份新的空映射。 适合在保留旧映射的同时，重新开始构建一份干净的键值表。

节点信息

字段	值
节点 ID	languageBaseMapClear
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

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

输出引脚

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

使用场景

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

注意事项

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

---

删除映射项

删除映射项：按键名删除映射中的一项，并返回删除后的新映射。 适合从缓存表、状态表或临时配置表里移除某个条目。 注意：即使没有找到这个键，节点也不会报错，而是返回一份内容等价的新映射，并通过“是否删除”告诉你这次有没有真正删掉内容。

节点信息

字段	值
节点 ID	languageBaseMapDelete
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要删除条目的映射。	-	必填
key	键名	数据	string	键名 输入要删除的键名。	输入框 默认值：""	必填

输出引脚

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

使用场景

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

注意事项

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

---

写入映射值

写入映射值：把一个键和值写进映射里，并返回写好后的新映射。 适合在不影响原始数据的前提下，逐步拼装新的配置表、缓存表或状态表。 注意：这个节点不会直接改动输入映射本身。如果你还需要保留旧映射继续使用，这种写法更安全。

节点信息

字段	值
节点 ID	languageBaseMapSet
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要作为基础的映射。节点会在这份内容之上生成一份新的结果映射。	-	必填
key	键名	数据	string	键名 输入或连接要写入的键名。首版只支持文本键。	输入框 默认值：""	必填
value	值	数据	unknown	值 这是要写进映射的新值。值的类型会跟随映射里的值类型自动联动。	会根据已连接内容自动提供选择	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	结果映射	数据	unknown / map	结果映射 返回写入后的新映射。原输入映射不会被直接改坏。	-	可选

使用场景

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

注意事项

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

---

映射转对象

映射转对象：把字符串键映射整理成普通对象。 适合在你后面要使用对象字段节点，或者准备做 JSON 序列化时，先把 Map 转成更容易继续处理的对象格式。 注意：首版只承诺处理字符串键 Map，不负责保留非字符串键的语义。

节点信息

字段	值
节点 ID	languageBaseMapToObject
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
map	映射	数据	unknown / map	映射 连接要转换成对象的映射。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	结果对象	数据	object	结果对象 输出转换后的普通对象。若后面要做 JSON 文本转换，建议先使用这个结果。	-	可选

使用场景

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

注意事项

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

---

原地清空映射

原地清空映射：直接移除输入映射本身中的全部键值项，并沿执行流继续传递这同一份映射。 适合把共享状态表、临时缓存或游戏运行时字典原地重置为空。 注意：这是一个副作用节点，会直接改动原映射。如果你还要保留旧映射，请改用纯函数版“清空映射”。若输入不是映射，系统会安全地创建一份新的空映射继续往下传。首版键名仍固定为文本键。

节点信息

字段	值
节点 ID	languageBaseMapClearInPlace
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

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

输出引脚

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

使用场景

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

注意事项

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

---

原地删除映射项

原地删除映射项：直接从输入映射本身删除指定键，并继续透传这同一份映射。 适合从共享状态表、游戏运行时缓存或临时配置表中按执行顺序移除一项内容。 注意：这是一个副作用节点，会直接改动原映射。如果键不存在，节点不会报错，只会保持原映射内容不变，并输出“是否删除 = false”；如果你还要保留旧映射，请改用纯函数版“删除映射项”。首版键名仍固定为文本键。

节点信息

字段	值
节点 ID	languageBaseMapDeleteInPlace
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口 执行流走到这里时，节点会直接改动原映射，然后再继续往后执行。	-	可选
map	映射	数据	unknown / map	映射 把要直接删除条目的原映射连到这里。若输入不是映射，系统会先创建一份新的空映射，再按安全边界继续执行。	-	必填
key	键名	数据	string	键名 输入要从原映射中删除的文本键名。	输入框 默认值：""	必填

输出引脚

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

使用场景

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

注意事项

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

---

原地写入映射值

原地写入映射值：直接把键和值写进输入映射本身，并沿执行流继续传递这同一份映射。 适合在游戏运行时缓存、状态表或共享配置表里持续维护同一份键值映射。 注意：这是一个副作用节点，会直接改动原映射。若同名键已存在，会直接覆盖旧值；如果其他分支也在使用同一份映射，它们会看到相同变化；如果你还要保留旧映射，请改用纯函数版“写入映射值”。首版键名仍固定为文本键。

节点信息

字段	值
节点 ID	languageBaseMapSetInPlace
分类	语言基础
二级分类	映射
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口 执行流走到这里时，节点会直接改动原映射，然后再继续往后执行。	-	可选
map	映射	数据	unknown / map	映射 把要直接改动的原映射连到这里。若输入不是映射，系统会先创建一份新的空映射，再把键和值写进去。	-	必填
key	键名	数据	string	键名 输入要写入或覆盖的文本键名。首版映射节点仍只支持文本键。	输入框 默认值：""	必填
value	值	数据	unknown	值 这里是要直接写进原映射的新值。值类型会跟随映射值类型自动联动。	会根据已连接内容自动提供选择	必填

输出引脚

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

使用场景

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

注意事项

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