节点参考
动作通用配置字段
解释 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。