节点参考

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

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

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

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

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

变量节点

变量用于把用户可调参数、识别结果、计数器和状态传递给后续节点。AI 生成脚本时,应把会变化的值抽成变量。

  • SetVar — 设置变量。字段:keyvaluescopevalue 是 JSON 值,可为文本、数字、布尔等;scope 支持 LOCALGLOBAL
  • IncVar — 递增变量。字段:keydeltascope。变量不存在按 0 处理;非数字会失败。
  • VariableScopeLOCAL 表示脚本内变量,GLOBAL 表示全局变量。
  • 常见变量名:delay_msretry_countsearch_texttarget_pointlast_erroris_logged_in

ConditionGroup 条件组

ConditionGroup 可用于 If、动作运行条件和复杂分支。AI 应优先使用它表达多条件判断。

  • modeALL 表示全部条件满足,ANY 表示任一条件满足。
  • Vision 条件项 — 字段 conditionretryTimesretryIntervalMsnegated
  • Time 条件项 — 字段 conditionnegated
  • Variable 条件项 — 字段 keyopvaluenegatedop 支持 LTLEEQNEGEGT
  • Expression 条件项 — 字段 expressionnegated
  • ActionRunStatus 条件项 — 字段 targetActionIdstatusnegatedstatus 支持 SUCCESSFAILURENOT_RUN

视觉结果与变量引用

视觉结果绑定让视觉识别和后续动作连接起来。AI 应在"识别后点击/滑动/判断"的场景中主动使用结果变量。

  • pointVar / pointsVar — 保存识别点,后续 Tap.pointVarKeySwipe.fromPointVarKeySwipe.toPointVarKey 可引用。
  • boxVar / boxesVar — 保存识别框,用于调试或后续区域识别。
  • textVar / textsVar / allTextVar — 保存 OCR 文字。
  • numberVar / numbersVar — 保存从文字中提取的数字。
  • matchedVarhitCountVarscoreVarmessageVar 可用于 IfPrompt