宏变量

宏变量让你能定义具名数值，供宏中的步骤引用。只需修改一次数值，所有使用该变量的步骤就会自动更新 — 无需逐一编辑每个步骤。

变量类型

每个变量都有标签（显示名称）、类型和默认值。共支持四种类型：

定义变量

1. 点击步骤树的空白区域（宏根节点）打开宏属性面板。
2. 找到变量区块，点击添加变量。
3. 为变量设置标签 — 这会是在使用该变量时各处显示的名称。
4. 选择与所需数值相符的类型。
5. 设置变量的默认值。

注意： 内部变量名称会根据标签自动生成，必须以英文字母开头，只能包含字母、数字和下划线（A-Za-z0-9_）。

在步骤中使用变量

编辑支持变量的步骤属性时，输入框旁会出现固定 / 变量切换开关：

• 固定模式 — 直接输入固定值（默认）。
• 变量模式 — 切换为下拉菜单，仅列出类型匹配该属性的变量。选择变量即可引用它。

当属性引用了变量，步骤树中会以 ${标签} 格式显示，让你一眼看出哪些步骤使用了变量。

以下步骤属性支持变量：按键输入、延迟、超时、重复次数、鼠标坐标、滚轮格数、图片匹配置信度、网格行列数等。

重命名变量

重命名变量标签时，所有引用该变量的步骤会自动更新。如果新名称与既有变量冲突，会自动加上数字后缀（例如 my_var_2）以保持名称唯一。

删除变量

如果你删除仍被步骤使用的变量，系统会弹出确认对话框警告这些步骤将失效，直到修正引用为止。删除后，任何引用已删除变量的步骤会在执行宏时报错，直到你赋予新的数值。

复制与粘贴

复制含有变量引用的步骤时，这些变量会自动被收集，并在粘贴时合并到目标宏中：

• 若目标宏已有同名且同值的变量，步骤会直接重用。
• 若名称相同但值不同，粘贴的变量会自动重命名。
• 若目标宏中没有该变量，则会自动添加。

这样就能安全地在宏之间共享和重用步骤序列，而不会破坏变量引用。