鼠标节点（Mouse 系列）

鼠标节点负责模拟真实的鼠标操作，主要包含 MouseMove（移动）和 MouseClick（点击）两类。它们常与图像识别节点配合：先定位元素，再移动/点击完成操作。

MouseClick 节点（鼠标点击）

MouseClick 用来触发单击、双击、右键等操作。

配置字段

字段	类型	必填	说明
`name`	`string`	✔️	节点名称，如 `click-submit`
`retry`	`number`	✔️	失败后重试次数
`interval`	`number`	✔️	重试间隔（毫秒）
`params`	`MouseClickParams`	✔️	点击动作配置
`conditions`	`Conditions`		执行条件，支持 `exist`/`not_exist`/`condition` 组合
`err_return`	`boolean`		是否失败即终止，默认 `true`

MouseClickParams

字段	类型	必填	说明
`value`	`string`	✔️	点击类型，如 `left`、`right`、`double`

YAML 示例


- action_type: MouseClick
  name: click-submit
  duration: 120
  retry: 2
  interval: 400
  params:
    value: left
  conditions:
    exist: "find-submit.submit.png"
  err_return: true

使用建议

与图像识别或变量条件联动，确保点击前元素已经存在。
duration 可模拟长按或拖拽起点；普通点击可不填。
若要连续双击，建议直接设置 value: double，避免手写两个节点。

MouseMove 节点（鼠标移动）

MouseMove 用来定位光标，支持绝对坐标、变量引用或表达式。

配置字段

字段	类型	必填	说明
`name`	`string`	✔️	节点名称，如 `move-to-login`
`retry`	`number`	✔️	失败后重试次数
`params`	`MouseMoveParams`	✔️	坐标配置
`conditions`	`Conditions`		执行条件，支持 `exist`/`not_exist`/`condition` 组合
`err_return`	`boolean`		失败后是否终止

MouseMoveParams

字段	类型	必填	说明
`x`	`string`	✔️	目标 X 坐标，可使用 `${find-dot.dot.png.x}` 这类变量
`y`	`string`	✔️	目标 Y 坐标，同上

YAML 示例


- action_type: MouseMove
  name: move-to-input
  retry: -1
  params:
    x: 820
    y: 460


- action_type: MouseMove
  name: move-to-dynamic
  retry: 3
  params:
    x: "${find-input.input.png.x}"
    y: "${find-input.input.png.y}"
  conditions:
    exist: "find-input.input.png"

使用建议

在大部分场景下先用图像识别节点输出坐标，再通过变量引用传给 MouseMove。
与 Keyboard 节点组合，达到“移动 → 点击/输入”的自然流程。