Obsidian 同期のトラブルシューティング

症状 → 考えられる原因 → 試すこと。

サインインに失敗する

サインインにはデバイスフローが使われます。プラグインが短いユーザーコードを表示し、バックエンドの認証ページをブラウザーで開き、承認されるまで確認を続けます。obsidian:// の URL スキームを通じてトークンが返されることはありません。

認証ページが開かない。 サインインのダイアログに表示されているユーザーコードをコピーし、認証 URL を手動で開いて、コードを貼り付けてください。プラグインの設定で、Engram の URL (Cloud か Self-Host か) が正しいことも確認してください。
ブラウザーで承認したのに、プラグインが確認しない。 プラグインは承認後にトークンを確認しに行くので、数秒待ってください。それでも確認されない場合は、ダイアログを閉じて、プラグインの設定ページからもう一度サインインを始めてください。
サインイン後に「Invalid token」と表示される。 セッションの期限が切れている可能性があります。プラグインの設定ページでサインアウトし、もう一度サインインしてください。

同期が「Pending push: N」のまま止まる

同期センター → Recent activity のログで、直近のエラーを確認してください。
バックエンドに接続できるのに送信が 409 (バージョンの競合) になる場合は、本物の競合の可能性が高いので、競合キューを開いてください。
送信が 413 を返す場合、そのノートはノートごとのサイズ上限を超えています。分割してください。
送信が 429 を返す場合は、レート制限がかかっています。1 分ほど待ってから再試行するか、サブスクリプションのプランを確認してください。

Web アプリに古い内容が表示される

ページを一度再読み込みしてください。Web アプリはライブ更新を購読していますが、最初の読み込みはキャッシュされています。
Obsidian のプラグインで、Last sync の時刻が最後の編集より後になっていることを確認してください。

特定のノートだけ同期されない

パスに使えない文字がないか確認してください (特にモバイルでは。モバイルを参照)。
ノートのサイズを確認してください。ノートごとのサイズ上限があります。
同期センターを開き、Pending push にあるそのノートを見つけて、ホバーしてエラーの理由を確認してください。

更新後にプラグインが読み込まれない

Obsidian の開発者コンソール (Ctrl/Cmd+Shift+I) を開き、engram-vault-sync に関するエラーがないか確認してください。
設定 → コミュニティプラグインで、プラグインを一度オフにしてからオンにしてみてください。
リリースに不具合があった場合は、 engram-app/Engram-obsidian にバグを報告し、プラグインを一時的にアンインストールしてください。コミュニティディレクトリの更新がインストールされると、Obsidian の中から以前のバージョンに戻すことはできません。

バグの報告先

engram-app/Engram-obsidian の issue。次の情報を添えてください。

Obsidian のバージョン、プラットフォーム (デスクトップ/iOS/Android)、OS のバージョン
Engram プラグインのバージョン
同期センター → Recent activity ログのスクリーンショット
再現手順