节点参考
变量、条件与结果绑定字段
说明 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。