同步狀態 7 種 + 待同步項目

同步狀態不只是一顆圓點——這篇講完整的七種狀態、pending items（未同步項目）清單、跟同步錯誤怎麼處理。

七種同步狀態

狀態	意思
✅ 已同步	本機跟雲端一致，沒有待處理的改動
🟡 等待同步	有改動還沒推上雲（pending）
🟡 同步中	正在推送
❌ 同步錯誤	推送失敗（rate limit、server 問題等）
🔒 需要登入	session 過期、要重新登入才能繼續同步
✈️ 本地模式	手動切到離線、或偵測到沒網路
⚠️ 有衝突	多台裝置改了同一個檔案、需要解決

Pending items（未同步項目）數量

如果有改動還沒同步，指示器會顯示還有幾項在等：

3 個待同步

看到還有東西在 pending，切裝置前就能判斷該不該等——等數量歸零再切比較保險。

上次同步時間

指示器旁邊會顯示上次同步是多久前：

• 「剛剛同步」「3 分鐘前」——正常
• 「超過 1 小時前」——這是警示，可能有 pending 一直沒推成功，建議手動同步看看

手動觸發同步

不想等背景自動同步：

• 點同步圖示 → 強制推送所有 pending

同步錯誤怎麼處理

推送失敗時會顯示一個通用的 同步錯誤 狀態，不會列出細分原因——但你大多時候也不需要，因為 Slima 會在背景持續重試：

• 暫時性失敗（請求一下子太多、server 短暫打嗝）——放著就好，會自動重試，狀態會自己清掉。
• session 過期——如果登入階段過期了，狀態會變成 需要登入；重新登入後就會繼續同步。
• 衝突——同一個檔案在兩台裝置都改過，這是獨立的 ⚠️ 狀態，到 衝突解決流程 處理。

相關

• 連線模式
• 離線寫作
• 同步狀態指示器（圓點顏色視角）