Obsidian 同步疑難排解

症狀 → 可能原因 → 可以嘗試的做法。

登入失敗

登入採用 裝置授權流程：外掛會顯示一組簡短的使用者驗證碼、在瀏覽器中開啟 後端的驗證頁面，並持續輪詢直到你核准。不會透過 obsidian:// URL scheme 傳回 任何權杖。

• 驗證頁面一直沒有開啟。 複製登入對話框中顯示的使用者驗證碼，手動開啟驗證 網址，然後貼上驗證碼。請確認外掛設定中的 Engram 網址（雲端或自行架設）正確。
• 已在瀏覽器中核准，但外掛一直沒有確認。 外掛在你核准後會輪詢權杖，請等 幾秒。如果仍未確認，請關閉對話框，並從外掛的設定頁重新開始登入。
• 登入後出現「Invalid token」。 你的工作階段可能已過期。請從外掛的設定頁 登出再重新登入。

同步卡在「Pending push: N」

• 查看 同步中心 → Recent activity 記錄中最近的錯誤。
• 如果後端可連線，但推送回傳 409（版本衝突），很可能是真的衝突；請開啟衝突 佇列。
• 如果推送回傳 413，表示該筆記超過單則筆記的大小上限。請將它拆分。
• 如果推送回傳 429，表示你被限流了。請等一分鐘後重試，或檢查你的訂閱方案。

網頁版顯示過時的內容

• 重新整理頁面一次。網頁版會訂閱即時更新，但初始載入是有快取的。
• 確認 Obsidian 中的外掛所顯示的 Last sync 時間晚於你最近一次編輯。

特定筆記無法同步

• 檢查路徑是否含有不合法字元（尤其是在行動裝置上，請見 行動裝置）。
• 檢查筆記大小。單則筆記有大小上限。
• 開啟同步中心，在 Pending push 中找到該筆記，將滑鼠停在上面查看錯誤 原因。

更新後外掛無法載入

• 開啟 Obsidian 的開發人員主控台（Ctrl/Cmd+Shift+I），查看是否有提到 engram-vault-sync 的錯誤。
• 試著在 Settings → Community plugins 中把外掛關閉再開啟。
• 如果某個版本發布時就壞了，請到 engram-app/Engram-obsidian 回報錯誤，並暫時解除安裝外掛。社群目錄的更新一旦安裝，就無法從 Obsidian 內部 還原先前的版本。

在哪裡回報錯誤

engram-app/Engram-obsidian issues。 請附上：

• Obsidian 版本、平台（桌面／iOS／Android）與作業系統版本
• Engram 外掛版本
• 同步中心 → Recent activity 記錄的截圖
• 重現步驟