actor_type 用来标注一次操作背后的行为主体,帮助研发区分「谁触发了这次操作」。
human:真人用户操作,典型场景是点击提交、刷新、返回、重试;automation:业务自动化流程,典型场景是定时重试、批处理任务、规则触发任务;system:应用系统流程触发,典型场景是自动恢复、后台刷新、超时重试。
之所以需要显式标注,是因为来自业务自动化流程的操作并不一定会产生 Flutter 可感知的标准指针事件。当业务直接调用方法、触发后台任务或执行规则引擎时,SDK 无法仅通过 tap 识别完整语义;而如果是系统无障碍或坐标模拟点击,则可能仍表现为一次普通 tap,容易与真人操作混淆。
因此建议业务在关键流程中主动上报 Action 或自定义事件,并补充 actor_type 等上下文,避免把自动化重试误判为用户反复点击。




