Click（点击）
点击——或按住——屏幕上的一个点。
Click 是真正触碰设备的节点。流程里其余一切的存在，都是为了算出这个节点该在哪里、何时触发。
用途
向设备发送一次触摸：普通点击，或按住。用来按按钮、开菜单、或按住拖动手柄。
点击目标可以是你画的矩形、一个固定点，或某个 Find Image 节点刚匹配到的中心——从而精确点在图像被找到的位置，而流程里不写任何坐标。
何时用
- 按屏幕上任何按钮或控件。
- 点击 Find Image 刚定位到的东西。
- 长按拖动手柄或打开上下文菜单。
- 用弹窗的关闭按钮关掉它。
何时不用
- 按 Back、Home、Enter——这些是没有屏幕按钮的系统键。用 Key Press。
- 打字——用 Input Text。
- 在屏幕上滚动或拖动——用 Swipe。
- 等按钮出现——Click 不等待、不搜索。在它前面放 Find Image。
前提
节点在运行时需要一个可解析的目标：Click Region、固定点，或一个活的 Find Image 结果。Find Image 来源只在该节点在此路径上运行过并匹配后才解析。
如何运行
偏移只移动最终点击位置。源坐标——Find Image 结果、区域、点——从不被改。
节点在触摸命令派发出去的瞬间就路由 Success。它不知道有没有发生什么。要对结果动作，接一个 Wait，或更好，接一个检测节点。
设置
| 设置 | 类型 | 范围 | 默认 | 作用 |
|---|---|---|---|---|
| Coordinate source | 选择 | manual、findImageResult | manual | 点击你定义的区域/点，或上游 Find Image 的可点中心 |
| Click Region | 矩形 | 屏幕百分比 | — | 要点击的矩形。运行时每次运行点击其内的一个随机点 |
| Click Offset — Left | integer | 0–5000 px | 0 | 把最终点击左移 |
| Click Offset — Right | integer | 0–5000 px | 0 | 右移 |
| Click Offset — Up | integer | 0–5000 px | 0 | 上移 |
| Click Offset — Down | integer | 0–5000 px | 0 | 下移 |
| Tap Count | integer | 1 或 2 | 1 | 1 = 单击，2 = 双击 |
| Hold Duration | integer | 0–5000 ms | 0 | 0 = 普通点击；大于 0 = 按住 |
| Input mode | 选择 | adb、native | 流程默认 | 触摸如何投递 |
为何区域点随机点
Click Region 不点中心——它每次运行在矩形里取一个新的随机点。重复运行因此永不敲同一个像素。
把矩形贴紧控件。区域大意味着随机点可能落到真正按钮之外。
Tap Count 与 Hold Duration 的相互作用
双击（tapCount: 2）是两次自然的快速点击，忽略 Hold Duration——它不是把按住重复两次。
已停用：Wait After Click
旧流程可能携带 waitAfterMs 值。它被运行时忽略，且不再显示在编辑器里。要点击后延时，接一个 Wait 节点。
端口
| 端口 | 走它的时机 | 必接 |
|---|---|---|
| Success | 触摸命令已派发 | 是 |
| Failure | 目标无法解析——无效/离屏点，或此路径上没有的 Find Image 结果 | 否 |
| Timeout | 输入命令未按时完成 | 否 |
| Cancelled | 点击在途中运行被停 | 否——永不被走 |
| Fatal | 设备断连，或意外错误 | 否——永不被走 |
基础示例
点击一个固定控件：
- Coordinate source：Manual
- Click Region：紧贴 Settings 齿轮绘制
- Hold Duration：
0
实际示例——点击你找到的东西
标准双节点惯用法，也是你用得最多的：
Click 不含任何坐标。按钮移位了，Find Image 仍能定位，点击仍然命中。
高级示例——用偏移点相邻处
你想点已匹配图标下方的标签，但只有图标够独特来做模板。
- Coordinate source：该图标的 Find Image 结果
- Click Offset — Down：
40
点击落在匹配处下方 40 个输入像素。一个模板，两个目标，不需要第二次检测。
把同一节点的 Hold Duration 设为 800 就变成长按。
最佳实践
- 凡目标可能移动，优先 Find Image 来源而非固定区域。 它经得住布局变化。
- Click Region 画紧。 随机点必须永远命中控件。
- 永不假设点击成功。 后接一个确认新屏幕状态的检测节点。
- 当真正目标距离某个独特物固定间隔时，用偏移代替第二个模板。
- 在会触发动画的点击后加 Wait，否则下一次检测读到旧帧。
性能笔记
- Click 属最便宜的节点之一——派发一条输入命令就返回。不抓帧、不分析。
- 真正的成本是你放在它周围的东西：长流程里每次点击后一个 Wait 累加很快。可能时，在检测结果上等待，而不是固定延时。
- Click 上带退避的重试放大它的最坏耗时。把
maxAttempts保持 2–3。
内存笔记
- Click 不持有帧、不缓存。占用可忽略。
- 启用流程级
captureFailureScreenshots时，每次失败的 Click 写一张工件图——长运行里是真实磁盘 I/O。
常见错误
| 错误 | 后果 | 修复 |
|---|---|---|
| Find Image 来源在该节点运行前被用 | 走 Failure——此路径无结果 | 把 Find Image 排在 Click 之前，同一分支 |
| Click Region 太大 | 随机点错过控件 | 收紧矩形 |
| 指望屏幕已稳定 | 节点在点击发出瞬间就返回 | 接 Wait 或检测节点 |
| 用 Click 按 Back | 屏幕上没有可点的东西 | 用带 BACK 的 Key Press |
依赖旧流程的 waitAfterMs | 被运行时忽略 | 加真正的 Wait 节点 |
故障排查
Click 每次都走 Failure。 它的坐标来源是一个未在此路径运行、或未匹配的 Find Image 节点。检查接线——Find Image 必须在同一分支的上游。
点击略偏离按钮。 Click Region 太大，随机点在飘。收紧它，或 改用带偏移的 Find Image 来源。
点击生效但屏幕无反应。 点击多半落在屏幕可交互之前。在 Click 前加一个检测节点，确认目标确实在场。
长按没生效。 查 Tap Count——双击忽略 Hold Duration。把 Tap Count 设为 1。
FAQ
Click Region 点它的中心吗？ 不——其内的随机点，每次运行重取。
能点击存在变量里的坐标吗？ 把 Find Image 结果绑到变量再用，或直接用 Find Image 来源。固定点是旧特性且依赖分辨率。
偏移按屏幕像素还是百分比？ 输入像素。源坐标不变；只有最终点击移动。
按住最长多久？ 5000 ms。
相关节点
- Find Image——定位要点击的东西
- Wait——点击后的停顿
- Swipe——拖动和滚动
- Key Press——系统键
- Input Text——打字