體檢 （doctor）
概覽頁與 wp sss doctor 輸出同一份體檢：配置完整度、匿名讀可達性、簽名配置、上傳地址前綴等，末尾附隊列狀態 （待傳 / 失敗 / 後台任務 / 運行鎖） 。有阻斷項會明確寫出修法。
常用排障入口
- 工具 → 排障 → 掃描：最近一批附件的本地缺失、訪問域名不一致、 http 明文、失敗標記、前綴不符。
- 診斷：貼一個裂圖地址，插件給出判定鏈 （哪個環節改寫了地址、對象是否在桶） 。
- 抽檢遠端：按編號從新到舊抽最新進桶的 10 個附件做 HEAD，確認對象真的在。
- 操作記錄：最近 50 條上傳/失敗/刪除/拉回。
常見問題
前台圖片 404
- 對象真的在桶裏嗎——用抽檢遠端確認
- 地址是桶域名還是本地？本地説明附件未進桶或已解除標記
- 開了簽名訪問？簽名過期會 403/404，頁面緩存要短於簽名有效期
補傳一直失敗
- 看操作記錄裏的失敗原因：密鑰權限、本地文件缺失、文件類型被排除
- 0 字節的損壞文件也能上傳 （0.9.1 起），如果仍失敗看具體報錯
- 連續失敗 3 次會退出隊列，修好後用 「重試失敗項」
點 「開始補傳」 立即結束
0.9.0 的一個缺陷會導致待傳隊列被誤清空 （已在 0.9.1 修復） 。確認你運行的是 0.9.1 或更高版本。
刪除遠端時報 「前綴不符」
插件的對象鍵帶前綴保護：換了前綴後拉回/刪除會拒絕操作舊前綴對象，避免寫錯目錄。把插件前綴改回原值，或用廠商控制枱處理。
邊界與已知限制
- 多站點 （Multisite） 暫不支持，不要在網絡層激活。
- COS / OBS / 七牛的超大文件上傳是單請求 （超時按體積放大）；百兆以上建議用 OSS / S3 兼容廠商。
- 桶內對象沒有版本控制時刪除不可恢復——建議在雲控制枱開啓版本控制。