变量操作 (Mutator)

📖 节点概述

变量修改器，会根据你选择的目标变量类型自动变换可用的操作和输入控件。无论是给数字递增、给列表追加元素、更新字典键值，还是字符串拼接，一个节点全部搞定。修改成功后会将最新值输出到 最新值 引脚，方便下游直接使用。

💡 使用场景：

• 计数器/累加器：循环中每次将计数器 +1，或累加金额。
• 状态更新：将任务状态从“待处理”覆盖为“已完成”。
• 列表动态维护：往列表尾部追加新元素，或在指定位置插入数据。
• 字典键值更新：修改用户配置字典中的某个键值（如 volume 改为 0.8）。
• 文本拼接：循环中不断追加日志内容，最后输出完整日志。

🎮 实战连线指南：如何正确使用它？

使用前需要先通过【变量设置】节点创建一个变量，然后在【变量操作】节点的下拉框中选择该变量，引擎会自动识别变量类型并切换操作模式。

场景案例：循环给分数累加，同时将最新分数传给下一个节点

1. 创建变量：先用【变量设置】节点创建一个整数变量，名称为 Score，初始值为 0。
2. 搭建循环：使用 For次数循环 节点，循环 10 次。
3. 配置变量操作：在循环体内，拖入【变量操作】节点，在 目标变量 下拉框中选择 Score，操作 选择 递增 (+)。
4. 提供递增值：默认情况下，右侧会自动出现一个 整数 (Integer) 输入端口和控件，将控件值设为 10（也可连线其他节点动态提供）。
5. 使用最新值：将【变量操作】的 最新值 输出连接到【打印控制台】节点，每次循环都会打印出当前总分。
6. 串联执行：将循环体的 Exec 输出接入【变量操作】的 Exec，再将【变量操作】的 Exec 输出接回循环体（或直接结束），形成流水线。

动态端口：当变量类型为列表或字典，且操作需要键名/索引时，节点会自动显示 键名/索引 输入端口和文本框，用于填写插入位置或字典键。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 修改变量前请确保该变量已存在（通过【变量设置】节点创建），否则操作会跳过并打印警告。
• 动态输入端口连线优先级高于控件值，如果既连线又填了控件值，引擎会使用连线传入的数据。
• 字典/列表操作中的 键名/索引 同样支持连线动态传入，方便在循环中处理动态键名。
• 当变量类型被引擎推断为“自动推断”时，会默认为整数类型并提供基本数字操作，通常需要手动在【变量设置】中指定正确类型以获得完整操作列表。