Solução de problemas de sincronização do Obsidian

Sintomas → causas prováveis → o que tentar.

O login usa um fluxo de dispositivo (device flow): o plugin mostra um código de usuário curto, abre a página de verificação do backend no seu navegador e consulta o backend até você aprovar. Nenhum token é devolvido pelo esquema de URL obsidian://.

A página de verificação não abre. Copie o código de usuário mostrado na janela de login e abra o endereço de verificação manualmente, depois cole o código. Confira se o endereço do seu Engram (Cloud ou Self-Host) está correto nas configurações do plugin.
Aprovei no navegador, mas o plugin nunca confirma. O plugin consulta o token depois que você aprova; dê alguns segundos. Se ainda assim não confirmar, feche a janela e inicie o login de novo pela página de configurações do plugin.
“Invalid token” depois de entrar. Sua sessão pode ter expirado. Saia da conta pela página de configurações do plugin e entre de novo.

A sincronização trava em “Pending push: N”

Veja o registro Central de sincronização → Recent activity para o erro mais recente.
Se o backend está acessível mas os envios retornam 409 (conflito de versão), provavelmente é um conflito real; abra a fila de conflitos.
Se os envios retornam 413, a nota passou do limite de tamanho por nota. Divida-a.
Se os envios retornam 429, você está sendo limitado por taxa. Espere um minuto e tente de novo, ou confira o seu plano.

O app web mostra conteúdo desatualizado

Recarregue a página uma vez. O app web assina atualizações ao vivo, mas o carregamento inicial é cacheado.
Confirme que o plugin no Obsidian mostra Last sync mais recente do que a sua última edição.

Uma nota específica não sincroniza

Confira se o caminho tem caracteres inválidos (principalmente no celular; veja Celular).
Confira o tamanho da nota. Existe um limite de tamanho por nota.
Abra a Central de sincronização, encontre a nota em Pending push e passe o mouse para ver o motivo do erro.

O plugin não carrega depois de uma atualização

Abra o console de desenvolvedor do Obsidian (Ctrl/Cmd+Shift+I) e procure erros que mencionem engram-vault-sync.
Tente desativar e ativar o plugin em Settings → Community plugins.
Se uma versão foi lançada com defeito, registre o bug em engram-app/Engram-obsidian e desinstale o plugin por enquanto. A versão anterior não pode ser recuperada de dentro do Obsidian depois que a atualização do diretório da comunidade é instalada.

Onde registrar bugs

Issues de engram-app/Engram-obsidian. Inclua:

Versão do Obsidian, plataforma (computador/iOS/Android) e versão do sistema operacional
Versão do plugin Engram
Captura de tela do registro da Central de sincronização → Recent activity
Passos para reproduzir