节点参考

变量、条件与结果绑定字段

说明 SetVar、IncVar、变量条件、表达式条件、动作状态条件以及视觉结果变量绑定。

当前:变量、条件与结果绑定字段
节点参考

变量、条件与结果绑定字段

说明 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。