变量与蓝图接口¶

变量用于在当前蓝图的一次运行中复用数据；开始与结束节点的槽位用于在自动化步骤之间传值。这两种机制不能用同名代替彼此。

常量与变量的区别¶

通过 Shift+A 添加布尔、整数、数字或字符串等值节点时，它首先是一个普通值节点。只有明确开启公开/变量状态、已有变量 ID，或填写公开名称后，才会建立变量定义并出现在左侧变量条。

当前可以声明为变量的值类型包括布尔、整数、数字、字符串、二维数、三维数、四维数、颜色、数组、图像、视觉媒体、音频媒体和模型；读取文件节点保存的文件路径也可作为字符串变量。节点参考中的其他端口类型不一定都能创建成侧栏变量。

变量保存稳定 ID、类型、名称、是否公开和默认值。同名变量不等于同一变量；节点引用的是变量 ID。

左侧变量条¶

蓝图至少存在一个变量时，左侧变量条才会出现。

• 单击变量：选择变量及对应定义。
• 双击名称：原位重命名。
• 拖动变量条目：调整变量顺序。
• 把变量拖到画布：插入该变量的 Get 节点。
• 右键变量：直接插入 Get、Set、Bind 或 Unbind。

宏时间线内部不会从该变量条拖出普通变量节点。宏片段需要绑定变量时，应使用片段属性中的专用入口。

宏输入片段绑定字符串变量¶

选中宏时间线中的桌面输入或 ADB 输入片段，在文字输入框右侧点击变量按钮。弹出的菜单只列出当前根蓝图的字符串变量，并提供搜索框：

1. 选择变量后，片段执行时读取变量当前值，片段自身文字仍会保留。
2. 再次打开菜单并选择解绑，片段立即恢复使用自身文字。
3. 如果原变量被删除或无法找到，片段属性会显示警告，并安全回退到自身文字。

绑定只改变文字来源，不会把桌面输入片段纳入按键映射转换。桌面输入仍按“瞬间输入”或“逐字输入”执行；ADB 输入当前只使用瞬间输入。

Get、Set、Bind 与 Unbind¶

Set 节点保存自己将要写入的值；修改变量默认值不会覆盖每个 Set 节点的局部写入值。Bind 与 Unbind 的来源和失败条件见对应节点参考。

重命名与删除变量¶

重命名变量会按稳定 ID 同步所有关联节点，不会因为名称变化而断开引用。

删除变量是级联操作：

1. 删除该变量的定义和变量条目。
2. 删除引用它的 Get、Set、Bind、Unbind 及值定义节点。
3. 删除这些节点的相关连线。
4. 清除宏输入文本片段对该变量的绑定。

删除前应确认该变量没有被宏片段或关键执行路线使用。需要保留结构时，可以先改接到新变量。

开始与结束节点¶

开始节点¶

开始节点固定唯一，包含一个执行输出，并可用加减号管理 0～64 个数据输出槽位。它不能由用户新增、复制或删除。

结束节点¶

结束节点包含一个执行输入，并可用加减号管理 0～64 个数据输入槽位。蓝图可以有多个结束节点，但必须至少保留一个。

所有结束节点共享同一组“蓝图输出槽位定义”：数量和编号保持一致。它们不共享实际连线或输入值，每条结束路线仍需分别给同编号槽位连接数据。

在任意结束节点调整槽位数量时，其他结束节点会同步。减少槽位会删除所有结束节点上超出新数量的连线；减少开始节点槽位也会删除对应输出连线。因此减少前应先检查使用位置。

在蓝图之间传值¶

跨蓝图传值按槽位编号完成：

1. 前一个蓝图在结束节点的 ID 1、ID 2 等槽位输入结果。
2. 后一个蓝图从开始节点同编号输出读取这些值。
3. 后续节点再把这些输出写入当前蓝图变量，或直接用于运算和执行。

两个蓝图中创建同名变量不会自动共享数据。

打开位于自动化序列中的蓝图时，开始节点会读取前一个蓝图的结束槽位，辅助显示 ID N · 类型。如果前一个蓝图的多个结束节点在同编号槽位上类型不一致，该位置会显示为通用类型。缺少前序或类型提示读取失败不会阻止编辑。

端口类型兼容¶

• 同类型端口通常可连接。
• 通用数据端口可接收受支持的非执行类型；是否随连接显示具体类型由节点决定。
• 整数可以连接到数字输入。
• 媒体与文本相关类型存在经过定义的兼容关系。
• 节点可以额外限制允许的来源，所以类型兼容不代表任何节点之间都能连。

结束节点的槽位在未连接时是通用输入；连接后以实际输入类型显示。断开后会恢复通用状态。

跨蓝图复制包含变量的节点¶

节点剪贴板会携带所选节点实际引用的变量定义。粘贴到另一蓝图时，编辑器会复用一致定义，或在真实 ID 冲突时分配新 ID 并重写引用。正常情况下不需要手工重建变量；仍应检查粘贴后的业务含义和默认值。

完整剪贴板规则见节点组、画布标注与剪贴板。