Risoluzione dei problemi di sincronizzazione con Obsidian

Sintomi → cause probabili → cose da provare.

L’accesso fallisce

L’accesso usa un flusso da dispositivo: il plugin mostra un breve codice utente, apre nel browser la pagina di verifica del backend e interroga il backend finché non approvi. Nessun token viene restituito tramite lo schema URL obsidian://.

• La pagina di verifica non si apre. Copia il codice utente mostrato nella finestra di accesso, apri manualmente l’URL di verifica e incolla il codice. Controlla che l’URL di Engram (Cloud o Self-Host) sia corretto nelle impostazioni del plugin.
• Hai approvato nel browser ma il plugin non conferma mai. Il plugin interroga il backend per il token dopo la tua approvazione; dagli qualche secondo. Se ancora non conferma, chiudi la finestra e riavvia l’accesso dalla pagina delle impostazioni del plugin.
• “Invalid token” dopo l’accesso. La sessione potrebbe essere scaduta. Esci dalla pagina delle impostazioni del plugin e accedi di nuovo.

La sincronizzazione è bloccata su “Pending push: N”

• Controlla nel registro Centro di sincronizzazione → Recent activity l’errore più recente.
• Se il backend è raggiungibile ma gli invii restituiscono 409 (conflitto di versione), è probabile che sia un vero conflitto; apri la coda dei conflitti.
• Se gli invii restituiscono 413, la nota supera il limite di dimensione per nota. Dividila.
• Se gli invii restituiscono 429, sei soggetto a limitazione della frequenza. Aspetta un minuto e riprova, oppure controlla il tuo piano di abbonamento.

L’app web mostra contenuti obsoleti

• Ricarica la pagina una volta. L’app web si iscrive agli aggiornamenti in tempo reale ma il caricamento iniziale è in cache.
• Verifica che il plugin in Obsidian mostri un’ora di Last sync successiva alla tua ultima modifica.

Una nota specifica non si sincronizza

• Controlla che il percorso non contenga caratteri non validi (soprattutto su mobile, vedi Mobile).
• Controlla la dimensione della nota. Esiste un limite di dimensione per nota.
• Apri il Centro di sincronizzazione, trova la nota in Pending push e passa il puntatore per vedere il motivo dell’errore.

Il plugin non si carica dopo un aggiornamento

• Apri la console per sviluppatori di Obsidian (Ctrl/Cmd+Shift+I) e cerca errori che citano engram-vault-sync.
• Prova a disattivare e riattivare il plugin in Settings → Community plugins.
• Se una release è uscita difettosa, segnala il bug su engram-app/Engram-obsidian e disinstalla temporaneamente il plugin. La versione precedente non è recuperabile da Obsidian una volta che l’aggiornamento della directory della community è stato installato.

Dove segnalare i bug

Issue di engram-app/Engram-obsidian. Includi:

• Versione di Obsidian, piattaforma (computer/iOS/Android) e versione del sistema operativo
• Versione del plugin Engram
• Schermata del registro Centro di sincronizzazione → Recent activity
• Passaggi per riprodurre il problema