节点参考
变量、条件与结果绑定字段
说明 SetVar、IncVar、变量条件、表达式条件、动作状态条件以及视觉结果变量绑定。
变量节点
变量用于把用户可调参数、识别结果、计数器和状态传递给后续节点。AI 生成脚本时,应把会变化的值抽成变量。
SetVar— 设置变量。字段:key、value、scope。value是 JSON 值,可为文本、数字、布尔等;scope支持LOCAL、GLOBAL。IncVar— 递增变量。字段:key、delta、scope。变量不存在按 0 处理;非数字会失败。VariableScope—LOCAL表示脚本内变量,GLOBAL表示全局变量。- 常见变量名:
delay_ms、retry_count、search_text、target_point、last_error、is_logged_in。
ConditionGroup 条件组
ConditionGroup 可用于 If、动作运行条件和复杂分支。AI 应优先使用它表达多条件判断。
mode—ALL表示全部条件满足,ANY表示任一条件满足。Vision条件项 — 字段condition、retryTimes、retryIntervalMs、negated。Time条件项 — 字段condition、negated。Variable条件项 — 字段key、op、value、negated;op支持LT、LE、EQ、NE、GE、GT。Expression条件项 — 字段expression、negated。ActionRunStatus条件项 — 字段targetActionId、status、negated;status支持SUCCESS、FAILURE、NOT_RUN。
视觉结果与变量引用
视觉结果绑定让视觉识别和后续动作连接起来。AI 应在"识别后点击/滑动/判断"的场景中主动使用结果变量。
pointVar/pointsVar— 保存识别点,后续Tap.pointVarKey、Swipe.fromPointVarKey、Swipe.toPointVarKey可引用。boxVar/boxesVar— 保存识别框,用于调试或后续区域识别。textVar/textsVar/allTextVar— 保存 OCR 文字。numberVar/numbersVar— 保存从文字中提取的数字。matchedVar、hitCountVar、scoreVar、messageVar可用于If或Prompt。