新上傳
媒體庫上傳 （含 REST/XML-RPC 程式化上傳） 在生成附件後設資料的同時進桶：主檔案、原圖、各尺寸一個不落。第三方直接放進 uploads 目錄的檔案不會自動進桶——用映象回源，或讓開發者呼叫 wpsss_file_upload() 。
存量補傳佇列
工具 → 日常 → 開始補傳。頂部有進度條：百分比按首輪 「已處理 + 剩餘」 為基線即時推進，文字行同步顯示本輪成功 / 失敗 / 剩餘。
- 一次一個附件：每個請求只上傳一個附件，不會因閘道器超時中斷整批。
- 可暫停：點 「暫停」 立即停；網路中斷自動暫停，再點繼續。
- 關頁繼續：關掉頁面後，後臺任務每分鐘最多補 2 個附件直到清完 （需要站點 cron 正常工作），佇列清空後自動停止。
- 斷點續傳：按附件編號從新到舊處理，中斷後從上次位置繼續。點 「從最新開始」 可清掉續傳位置重新掃 （已進桶的自動跳過） 。
失敗退避
同一個附件連續失敗 3 次後，自動退出補傳佇列 （避免一個壞檔案卡住整隊） 。佇列清空後如果只剩失敗項，工具頁會明確提示剩多少個、到哪裡查原因：到 「工具 → 排障 → 體檢」，修好後點 「重試失敗項」，或命令列：
wp sss offload --source=failed縮圖與主檔案標記
設定裡可以關掉 「同時上傳縮圖」 。此時外掛給附件打上 「主檔案」 標記：主檔案地址照常指向桶，各尺寸地址保持本地——前臺不會因為尺寸檔案不在桶裡而裂圖。 PDF 附件同理：PDF 本體進桶，預覽縮圖留在本地。 0 位元組的損壞檔案也能如實上傳 （物件按 0 位元組儲存） 。
keep_local：本地備份
預設開啟 （推薦）：桶與本地各一份，源站掛了也能從本地恢復。關閉後本地檔案在上傳成功後刪除——此時外掛會接管 get_attached_file（編輯圖片等場景退回桶地址），上傳重名檔案也會先查桶避免覆蓋。關閉本地備份需要管理員在高階設定操作。
媒體庫裡也能直接操作
- 狀態列 「物件儲存」：每個附件標出已進桶 / 未進桶 / 失敗 （附原因），列表頁還有 「全部 / 已進桶 / 未進桶 / 失敗」 篩選。
- 行內動作：未進桶的附件在列表行內點 「補傳到桶」；已進桶的可 「拉回本地」 。
- 批次操作：列表勾選後批次 「補傳到桶」 或 「拉回本地」 。
- 附件編輯頁側欄：顯示物件鍵與對外地址，可直接開啟，也可單附件補傳 / 拉回。
高階設定裡的上傳開關
- 遠端已有則跳過：桶裡已有同名物件時不再重複上傳 （預設關；適合重建桶後避免覆蓋） 。
- 自動重新命名：同名衝突時的處理——關閉 （預設，按原名加 -1 、-2 遞增）/ md5 / 時間戳。
- 不進桶的副檔名：填了就不上傳的副檔名清單；
php、htaccess無論如何都不進桶。