任务与日志

每次上传都应保留一个任务，而不是只显示一条临时 toast。任务至少包含 Provider、应用、包体摘要、当前阶段、进度、开始/结束时间和公开错误信息。

先看阶段

先找到最后一个成功阶段，再看下一个失败阶段。连接失败、预约失败、分片上传失败、平台处理失败和审核失败需要完全不同的恢复动作。

日志中的内容

日志可以包含公开 HTTP 状态、Provider 错误代码、字段路径、资源 ID、文件 checksum 和本地阶段信息。它不应包含 JWT、Authorization、Cookie、.p8、Service Account 私钥、完整授权 Key 或密码。

如何分享排障证据

优先导出任务摘要和脱敏日志；不要截取只包含最后一行的图片。保留任务 ID、时间范围、Provider、应用与包体版本，才能把一次失败与正确的请求证据对应起来。

恢复原则

如果 Provider 已经创建不可重复的资源，重试前先刷新远端状态。相同 Build、相同版本号或仍在处理的上传不能简单重复发送。