执行与结果

返回文档中心 · 动作目录 · 任务协议

1. 当前执行流程 [已实现]

当前 TaskExecutor 按以下方式执行每一步：

计算步骤截止时间。
等待 packageName 和可选 activityName 匹配。
BACK 直接调用全局返回；其他动作查询 selector。
没有目标时继续等待，多个目标立即失败。
执行动作；成功后立即结束本步并进入下一步。
每次尝试结束后判定截止时间：到达超时时 optional 步骤跳过，其他步骤停止任务。

超时判定在每轮尝试之后进行，因此轮询唤醒晚于截止时间不会让失败的步骤被记为成功。多目标（TARGET_AMBIGUOUS）立即停止任务，不受 optional 影响。

当前结果：

{
  "successful": true,
  "code": "OK",
  "message": "任务执行完成",
  "extracted": {
    "status": ["准备完成"]
  }
}

结果码见结果码总表。当前执行器会产生 OK、PACKAGE_MISMATCH、ACTIVITY_MISMATCH、TARGET_NOT_FOUND、TARGET_AMBIGUOUS 和 ACTION_FAILED。

是否成功只看 successful，成功时 code 恒为 OK；message 只用于排障，不参与流程判断。

2. 简单步骤结果 [提案]

为了便于排查，可将每一步记录为简单结构：

{
  "stepId": "click-submit",
  "action": "CLICK",
  "success": false,
  "code": "ACTION_FAILED",
  "message": "点击未成功",
  "output": {},
  "elapsedMs": 1200
}

建议只保留：

stepId、action：定位步骤。
success、code：供程序判断。
message：供排障，不参与流程判断。
output：动作输出，没有输出时为空对象。
elapsedMs：步骤耗时。

暂不引入 phase、effect、transition 和独立结果协议版本。以后确实需要断点恢复或复杂流程审计时再扩展。

结果码的取值与新增规则统一见结果码总表。

3. 动作执行规则

timeoutMs 是整个步骤的总时间，包括等待和验证。
每轮查询都读取当前页面，不长期保存旧节点。
WAIT 和只读提取可以轮询。
CLICK、INPUT、BACK、OPEN 等有副作用动作默认只分发一次。
提供 after 时，动作后重新读取页面并验证。
动作失败不会自动回到初始页面；需要返回或重新打开时由任务显式增加步骤。

4. 并发与幂等

当前 SQLite 以 taskId + revision 防止同一版本重复入库，但自动执行尚未实现，TaskExecutionMutex 也尚未接入。

简单目标：

同一时刻只执行一个任务。
已成功执行的相同 taskId + revision 不自动重复。
更高 revision 是否替代旧版本，等调度需求明确后决定。
暂不实现抢占、租约、断点恢复和自动回滚。

5. 测试

至少覆盖：

每个失败原因得到稳定 code。
optional 只跳过约定的失败。
多目标不会执行动作。
有副作用动作在一个步骤内最多调用一次。
after 使用动作后的新页面状态。
失败结果仍保留此前已经完成的提取输出。

3.2 KiB Raw Permalink Blame History Unescape Escape