外观
05 鼠标动作
鼠标动作只在识别成功后执行。第一次配置时,先用 无动作验证识别,再切换到真实鼠标动作。
共享参数

图中点击动作使用固定目标区域、零偏移和左键;参数规则以本节表格为准。
| 参数 | 格式 | 默认/空值 | 必填与显示 | 运行影响与示例 |
|---|---|---|---|---|
| 目标区域 | x,y、x1,y1,x2,y2、0,0,0,0、true、self 或引用 | 留空、true、self 均使用当前识别位置 | 可选;点击和滚轮时可添加 | 在区域内选择动作位置,例如320,240;节点引用和 [Anchor]锚点名使用对应结果 |
| 目标偏移 | w1,h1,w2,h2 | 不偏移 | 可选;点击和滚轮时可添加 | 调整目标四边,例如-5,-5,5,5 |
| 鼠标按键 | 下拉选择 | 左键 | 可选;点击和拖拽时可添加 | 可选左键、中键、右键 |
| 取点方式 | 下拉选择 | 随机 | 可选;仅点击时可添加 | 随机在最终目标区域内取点;精准直接使用最终目标区域左上角 (x,y) |
| 点击方式 | 下拉选择 | 单击 | 可选;仅点击时可添加 | 可选 单击或双击;左键、中键、右键均支持配置 |
| 点击模式 | 下拉选择 | 直接点击 | 可选;仅点击时可添加 | 直接点击按目标位置点击;偏移校正先使用当前项目的鼠标偏移校正配置 |
| 不点击 | 开关 | 关闭 | 可选;仅点击时可添加 | 开启后只把鼠标移动到目标位置,不发送鼠标按键 |
点击
选择 点击后,可以从动作区域右上角的可选参数菜单添加目标区域、目标偏移、鼠标按键、取点方式、点击方式、点击模式和不点击。目标区域未添加或留空时,使用当前节点识别结果;因此“找图 + 点击”通常不必手写坐标。固定点、固定范围和全屏特殊值均可使用。
取点方式未添加或选择 随机(Random)时保持原有行为,不会在脚本中增加字段。选择 精准(Exact)时,目标和目标偏移先解析,再直接点击最终目标区域左上角 (x,y)。找图文件名带 @(dx,dy) 且未配置目标时,该文件名偏移已包含在最终目标中,因此点击识别坐标的 (x+dx,y+dy)。PC 和手机点击节点都可以使用该参数。
点击方式未添加或选择 单击时保持原有行为,旧项目无需补字段。选择 双击后,会在同一目标坐标连续点击两次;双击可以与左键、中键或右键组合。当前双击执行支持 Windows 原生、大漠桌面和 Android 通道;VNC 通道会在发送输入前报告不支持。
开启 不点击后,动作仍按目标区域和目标偏移计算位置,但只将鼠标移动到该位置,不发送按键。点击方式的选择会保留,关闭 不点击后恢复原选择。关闭或未添加该参数时正常执行单击或双击,旧项目无需补字段。节点运行日志会将这种动作显示为移动鼠标,并给出最终移动坐标;双击日志会显示双击结果和最终坐标。
点击模式未添加或选择 直接点击(Direct)时,都按原方式直接点击,旧项目无需补字段。选择 偏移校正(Correction)时,正式运行会读取当前项目连接设置中的鼠标偏移校正参数;无需同时打开连接设置里的 偏移校正开关。校正参数缺失、无效或校正执行失败时,本次动作进入现有失败流程,不会回退为直接点击。参数和通道测试步骤见设置、驱动与高级绑定参考:鼠标偏移校正。

图中展开了点击模式选择,可在 直接点击和偏移校正之间切换。
常见错误:使用1,1,2,2这类 1x1 固定范围代替点;固定点应直接写1,1,固定范围必须有实际宽高。
拖拽
| 参数 | 格式 | 默认/空值 | 必填与显示 | 运行影响与示例 |
|---|---|---|---|---|
| 起点 | 点、范围、0,0,0,0、true、self 或引用 | 无;空值校验失败 | 必填;拖拽时可添加 | 鼠标按下位置,例如200,300;true和self使用当前识别位置 |
| 终点 | 点、范围、0,0,0,0、true、self 或引用 | 无;空值校验失败 | 必填;拖拽时可添加 | 鼠标松开位置,例如600,300;0,0,0,0表示完整画面 |
| 拖拽时长 | 非负整数,毫秒 | 200 | 可选 | 起点到终点的移动时间,例如500 |
| 鼠标按键 | 下拉选择 | 左键 | 可选 | 指定拖拽所用按键 |
拖拽的起点和终点各自独立,不使用点击动作的目标区域或目标偏移。起点、终点为空会在运行前报错。
背包遍历
背包遍历从起始坐标开始,按行优先逐格执行:先从左到右走完一行,再按纵向步长进入下一行。每一格都在计算出的点击点直接发送一次左键点击;当前格点击成功后执行节点的成功后续,再继续下一格。成功后续中的普通失败按后续节点原有规则处理,返回后仍继续遍历;只有当前格的点击本身失败时,才停止剩余格子并执行本节点的失败后续。用户停止会穿过后续节点并终止本次遍历和整个任务。
| 参数 | 格式 | 默认值 | 运行影响与示例 |
|---|---|---|---|
| 每行数量 | 正整数 | 5 | 每一行要点击的格子数 |
| 总行数 | 正整数 | 4 | 要遍历的总行数 |
| 起始 X | 整数 | 100 | 第一格实际点击点的横坐标 |
| 起始 Y | 整数 | 200 | 第一格实际点击点的纵坐标 |
| 横向步长 | 整数 | 60 | 相邻列的横向坐标差;可为 0 或负数 |
| 纵向步长 | 整数 | 60 | 相邻行的纵向坐标差;可为 0 或负数 |

图中展示背包遍历动作及六项默认参数 5/4/100/200/60/60。
第 r 行、第 c 列的点击位置为 X = 起始 X + c × 横向步长、Y = 起始 Y + r × 纵向步长,行列都从 0 开始。动作重复每次重复整个网格,而不是只重复单格点击;仅执行动作只执行逐格点击,不执行成功或失败后续。该动作不使用普通点击动作的目标区域、目标偏移、鼠标按键或点击模式。
滚轮
滚轮会先把鼠标移动到目标位置,再按指定方向执行标准垂直滚轮。目标区域留空时使用当前节点识别结果;目标区域和目标偏移的填写规则与点击相同。
| 参数 | 格式 | 默认/空值 | 必填与显示 | 运行影响与示例 |
|---|---|---|---|---|
| 目标区域 | 见共享参数 | 使用识别位置 | 可选 | 指定鼠标移动后执行滚轮的位置;仅执行动作时必须填写固定点或固定范围 |
| 目标偏移 | 见共享参数 | 不偏移 | 可选 | 调整目标区域的左、上、右、下边界 |
| 方向 | 下拉选择 | 向下 | 可选 | 可选 向上或向下 |
| 次数 | 1..100 的整数 | 1 | 可选 | 连续执行标准滚轮的次数,例如3 |
滚轮不支持横向方向、自定义距离或滚动间隔。旧项目中的横向滚动 dx、纵向滚动 dy 不会被自动换算;运行前会提示删除旧参数,并重新添加 方向和次数。
常见错误
- 将范围偏移写成宽高:它调整的是左、上、右、下边界,不是
x,y,w,h。 - 在拖拽中只填写一个端点:起点和终点都必填。
- 将旧版滚轮的横向滚动或纵向滚动当作新参数继续使用:请删除旧参数,重新选择方向和次数。
- 将滚轮次数填写为小数、
0或大于100:次数必须是1..100的整数。 - 在 VNC 设备上执行双击:当前 VNC 通道不支持双击。
- 将每行数量或总行数设为
0:这两个参数必须是正整数。 - 在未验证绑定坐标时执行点击:窗口客户区尺寸变化后,应重新检查识别和动作位置。