设置变量节点

设置变量节点用于在循环体内更新父循环定义的中间变量。它适合保存本轮处理结果、累计状态或判断标记；更新后的值可被本轮后续节点和下一轮循环继续使用。

使用位置与前提

设置变量节点只能添加在循环体中，不能放在循环体外。使用前，先完成以下准备：

1. 在父循环节点的“中间变量”区域新增变量，并设置初始值和变量类型；
2. 选中循环体后添加“设置变量”节点；
3. 在节点中选择要更新的中间变量，再设置本轮要写入的值。

循环体不需要开始或结束节点，节点会按连接线顺序运行。若变量名列表为空，说明父循环尚未配置可写的中间变量。

配置说明

配置项	说明
变量名	只能选择当前父循环中的中间变量。变量类型继承自父循环，不能在本节点修改。
变量值	可填写固定值，也可以引用本轮循环项、循环体上游节点输出或其他当前可见变量。
添加中间变量赋值	可在同一个节点中配置多条赋值。一个中间变量在同一节点内只能配置一次，且至少保留一条赋值。
输出	节点会输出本次更新后的中间变量对象和执行状态，供循环体内的后续编排使用。

固定值的编辑类型会跟随目标变量。引用变量时，应选择与目标变量兼容的值；对象和数组会按整个新值替换，不会自动合并字段或追加元素。需要拼接数组、合并对象或进行数值计算时，先用代码、文本处理等节点得到完整结果，再写回中间变量。

常见用法

保存上一轮处理结果

例如，循环逐段生成内容时，可以在父循环中创建字符串类型的 lastParagraph，初始值留空。循环体中的模型或插件得到本轮内容后，使用设置变量节点将结果写入 lastParagraph；下一轮即可引用它作为上下文。

记录处理状态

在父循环中创建布尔类型的 found，初始值设为 false。当本轮满足目标条件时，将它更新为 true，再让后续选择器根据该标记决定继续处理、跳过后续步骤或结束循环。

累计已处理数据

在父循环中创建数组或对象类型的中间变量。每轮先计算出完整的新数组或新对象，再通过设置变量节点整体写回，用于保存已处理项、错误记录或汇总信息。

执行顺序

设置变量节点执行前，排在它之前的节点读取的是旧值；执行成功后，本轮后续节点和下一轮循环会读取新值。若某个选择器分支没有经过该节点，或者先执行了继续循环、终止循环，对应路径不会更新这个中间变量。

“设置变量”和资源库中的“变量赋值”用途不同：前者只更新父循环的中间变量；需要读写应用变量或用户变量时，应使用“变量赋值”节点。

常见问题

为什么变量名列表为空？

设置变量节点只能写入父循环的中间变量。返回父循环节点新增中间变量并保存后，再打开当前节点选择。

为什么下一轮仍然读到旧值？

确认设置变量节点位于本轮实际执行的分支上，并检查选择器、继续循环或终止循环节点是否绕过了该节点。

为什么同一个变量不能重复选择？

同一个设置变量节点内，每个中间变量只能配置一次。需要按先后顺序多次更新同一变量时，拆成多个设置变量节点并按执行顺序连接。

为什么引用上游变量后无法正常运行？

检查引用值是否与目标中间变量类型兼容，并确认被引用的节点位于当前循环体内的上游执行路径。设置变量节点不会自动把字符串、数值、对象或数组转换成其他类型。