节点参考
动作通用配置字段
解释 ActionConfig、条件组、结果策略、事件绑定和通用等待/重试/超时字段。
ActionConfig 的作用
ActionConfig 是动作节点的通用运行配置。它不改变动作类型本身,而是控制动作执行前后等待、条件检查、重复、重试、超时以及成功/失败后的处理。AI 生成关键动作时,应同时给出必要的 ActionConfig 建议。
- preDelayMs:动作执行前等待毫秒数,页面切换、弹窗出现前可使用。
- preDelayRandomRangeMs:前置等待随机浮动范围,一般保持 0,除非确实需要轻微随机。
- postDelayMs:动作执行后等待,默认 200ms;点击跳转、输入后校验建议保留。
- repeat:动作重复次数,默认 1;-1 表示无限重复,公开脚本不建议使用。
- timeoutMs:动作整体超时;识别、等待、远程或长耗时动作应设置。
条件与条件不满足策略
动作运行前可以配置条件,条件不满足时可以跳过或判失败。复杂判断优先使用 ConditionGroup,而不是旧的单一视觉条件字段。
- runtimeConditions:统一条件组,支持视觉、时间、变量、表达式、动作运行状态。
- condition / timeCondition:兼容旧版的视觉和时间条件;新脚本优先使用 runtimeConditions。
- conditionRetryTimes:条件轮询次数;-1 表示直到满足,必须谨慎。
- conditionRetryIntervalMs:条件轮询间隔。
- conditionNegated:条件取反,例如“不存在某弹窗时才执行”。
- conditionMissStrategy:SKIP 表示跳过动作,FAIL 表示动作失败并进入失败策略。
失败重试与成功失败策略
动作失败后可以重试、停止或跳转。AI 应根据脚本风险选择保守策略,避免无限重试卡死。
- retryTimes:动作失败重试次数;-1 表示直到成功,不建议在公开脚本中默认使用。
- retryIntervalMs:重试间隔,识别类动作可设置 200 到 800ms。
- onSuccess / onFail:成功或失败后的策略,支持 CONTINUE、STOP、RETRY、GOTO。
- jumpTargetOnSuccess / jumpTargetOnFail:策略为 GOTO 时的目标。
- successTargetType / failTargetType:跳转目标类型,支持 LABEL、SUB_FLOW、ACTION。
事件绑定 ActionEvents
ActionEvents 允许动作在开始、条件命中、成功、失败、超时、重试、结束等时机触发事件绑定。普通用户脚本不必总是使用,但 AI 编写复杂脚本时可用它做日志、提示或兜底。
- onStart:动作开始时触发。
- onConditionSuccess / onConditionNotSuccess:运行条件命中或不命中时触发。
- onSuccess / onFail:动作成功或失败时触发。
- onTimeout / onRetry / onFinish:超时、重试、完成时触发。
- ActionEventBinding 可指向 LABEL、SUB_FLOW、ACTION、INLINE_ACTION 或 VARIABLE。