节点参考
触控动作节点字段
说明点击、连点、长按、滑动、拖拽、多点触控等触控动作的作用和字段含义。
延迟与点击类动作
触控动作适合目标位置稳定的场景。AI 应尽量使用百分比坐标或识别结果变量，避免只写固定像素坐标。
- Delay：等待动作。millis 为等待毫秒数；millisVarKey 不为空时从变量读取等待时间。
- Tap：点击。x/y 为像素坐标；xPct/yPct 为百分比坐标；duration 为按下时长；pointVarKey 可引用视觉识别出的点。
- MultiTap：连点/双击。count 为点击次数；intervalMs 为点击间隔；duration 为每次点击时长；也支持百分比坐标和 pointVarKey。
- LongPress：长按。x/y 或 xPct/yPct 定位；duration 为长按时长；pointVarKey 可引用动态目标。
按下、松开与移动触点
这组动作适合需要分段控制手势的场景，例如按住后移动、拖动滑块、模拟长按拖拽。
- TouchDown：按下不松开。pointerId 是触点编号；holdMs 是最长保持时长；支持坐标、百分比坐标和 pointVarKey。
- MovePointer：移动已按下触点。touchDownRefId 可引用按下动作；x/y、xPct/yPct 或 pointVarKey 指定终点；duration 控制移动时间；pathType 支持 POINT、LINE、POLYLINE、RECORD、CURVE。
- TouchUp：松开触点。pointerId 与 TouchDown 配对；releaseMs 是松开模拟时长。
滑动、拖拽与多点触控
滑动和多点触控适合列表滚动、页面切换、缩放、游戏摇杆等场景。AI 必须说明起点、终点、时长和坐标来源。
- Swipe：滑动。fromX/fromY 到 toX/toY；也支持百分比坐标、fromPointVarKey、toPointVarKey；useBezierCurve 可使用曲线；fromSourceType/toSourceType 可为 COORDINATE、IMAGE、TEXT、COLOR。
- DragToTarget：拖拽到目标。起点用 startX/startY 或百分比；targetType 支持 COORDINATE、NODE、VISION；waitTimeoutMs 和 waitIntervalMs 控制等待目标出现。
- SingleTouch：单指轨迹。TouchPointer 包含 points、duration、pathType、targetPointVarKey、targetSourceType、targetCondition、targetSelector。
- MultiTouch：多指轨迹。pointers 是多个 TouchPointer，可用于双指缩放或组合手势。
- AI 建议：能用节点或视觉定位终点时，不要让用户手填难以适配的固定终点坐标。