变量与蓝图接口¶

蓝图变量用于在当前蓝图的一次运行中复用数据；自动化共享变量用于在本次任务的蓝图步骤之间传值。需要跨蓝图共享时，在结束蓝图节点写出，并在后续蓝图的开始节点声明读取。

常量与变量的区别¶

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

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

变量保存稳定 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. 清除宏输入文本片段对该变量的绑定。

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

开始与结束节点¶

开始节点¶

开始节点固定唯一，不能新增、复制或删除。它包含执行输出，并可添加共享变量声明；每项设置名称、类型和默认值，输出“值”和“是否找到”。

运行时按名称与类型读取本次任务的自动化共享变量。找不到时输出该项默认值和 false；资源类型的默认值为空且不可编辑。

结束蓝图节点¶

结束蓝图节点包含执行输入和具名数据输入。接入任意非执行数据后自动出现尾部空端口，各结束节点独立维护自己的输入。

双击输入口名称可修改共享变量名，只修改本节点的目标名称，不改变来源变量。实际到达的结束节点按这些名称和输入的实际类型写入共享变量，随后进入下一蓝图。

“结束自动化”则结束整次任务，不再执行后续蓝图，并等待当前资源清理；清理失败仍报错。详见结束蓝图与结束自动化。

“结束并跳转”也能写出具名共享变量，但会按指定的序号或名称选择后续蓝图；序号从 1 开始。目标无效时结束自动化并报错，本次出口不会写入共享变量。详见结束并跳转。

在蓝图之间传值¶

跨蓝图传值按“名称＋类型”完成：

1. 在前一个蓝图的结束蓝图节点连接结果，并把输入口命名为“结果”。
2. 在后续蓝图的开始节点声明名称“结果”和对应类型。
3. 使用该项的值输出继续计算，并用“是否找到”判断共享数据是否存在。

两个蓝图的本地变量同名不会自动共享。同名同类型的后续结束蓝图写入覆盖旧值，不同类型分别保存。共享数据属于本次自动化任务，不依赖相邻蓝图的槽位编号；整次任务结束后清空。

端口类型兼容¶

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

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

图像与三维数、连线与默认值¶

图像使用独立的 image 类型，不等同于三维数。既有允许的图像/三维运算连接仍可使用，但普通三维运算的输出不会因此变成图像类型；要求真实图像资源的识别输入仍会拒绝不适配的纯数值。三维端口保持原色，图像使用同色系更高饱和度，类型名称仍是主要判断依据。

值输入接上连线后，对应的默认值输入控件隐藏，并显示连线来源提示；原默认值继续保存，断线后恢复。类型、算法、操作模式、公开开关不是默认值，不随数据连线隐藏。四维输入拆成 XY/ZW 时，已连接的一半只隐藏相应分量。

表格式枚举¶

枚举是有序的带类型表格，而不是只能保存名称的选项列表。第一列固定为字符串属性“条目名”，不可删除、改类型或左右移动；每个条目名必须非空且唯一。其他列可增加、改名、改类型、调整左右顺序。

属性按“名称 + 值类型”识别，所以“牛奶重量／整数”和“牛奶重量／浮点”可以同时存在。行 ID 是当前从 1 开始的顺序号，重排后随位置变化，不是永久身份。枚举值节点输出整个枚举及当前条目数。

字段类型来自软件实际支持的变量类型，包括嵌套枚举。双击嵌套单元格进入子表，通过“蓝图 → 变量 → 子表”面包屑返回；对取出的子表进行运算得到的是新值，不会自动修改父表。从已有资源面板拖入时，图像格接收静态图片，视觉媒体格接收图片或视频，均保存根蓝图资源引用，不为每个格子复制资源字节或保存临时文件路径。运行时按引用校验并解析，缺失、类型不符或摘要损坏明确报错；视频不因此成为静态识别模板。

修改时找不到条目或属性会跳过并记录诊断；非法值、同名冲突不应被当成“找不到”掩盖。嵌套示例：读“小雨”的路线 → 把第 7 步时间 22.2 改成 15 → 按时间排序 → 将新路线显式写回“小雨”的路线属性。

可导入 .xlsx、.xlsm，多工作表时先选择页；默认不把第一行当表头，第一列为条目名，其余列先作为字符串。不会执行公式或宏。切换字段类型时整列原子转换，任何格子失败都会保留原值和空格；向量文字可用 (1, 2.3, 5.5, 6)。

一次性初始定义提示¶

配套节点的属性名、条目名和类型由用户明确指定。首次连接枚举输入时，可记录一次能确定的初始定义，输入框旁的选择按钮仅用于辅助填写。它不是运行结果预览，也不会跟随上游运算动态更改输出端口。

本蓝图优先读取本地初始定义；来自开始节点时，只在同一自动化中按顺序向前查找最近的同名、同类型导出。找不到、来源有歧义、经过无法静态确定的运算或前序不可读时显示不确定，不偷偷越过最近来源去猜旧值。手动输入始终可用，运行仍以实际输入为准。

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

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

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