任務與記錄

每次上傳都應保留一個任務，而不是只顯示一條臨時 toast。任務至少包含 Provider、應用、套件摘要、目前階段、進度、開始/結束時間和公開錯誤資訊。

先看階段

先找到最後一個成功階段，再看下一個失敗階段。連線失敗、預約失敗、分片上傳失敗、平台處理失敗和審核失敗需要完全不同的恢復動作。

記錄中的內容

記錄可以包含公開 HTTP 狀態、Provider 錯誤程式碼、字段路徑、資源 ID、檔案 checksum 和本地階段資訊。它不應包含 JWT、Authorization、Cookie、.p8、Service Account 私鑰、完整授權 Key 或密碼。

如何分享排障證據

優先匯出任務摘要和脫敏記錄；不要截取只包含最後一行的圖片。保留任務 ID、時間範圍、Provider、應用與套件版本，才能把一次失敗與正確的請求證據對應起來。

恢復原則

如果 Provider 已經建立不可重複的資源，重試前先刷新遠端狀態。相同 Build、相同版本號或仍在處理的上傳不能簡單重複傳送。