Solución de problemas de sincronización de Obsidian

Síntomas → causas probables → cosas que probar.

Falla el inicio de sesión

El inicio de sesión usa un flujo de dispositivo: el plugin muestra un código de usuario corto, abre la página de verificación del backend en tu navegador y consulta hasta que apruebas. No se devuelve ningún token mediante el esquema de URL obsidian://.

• La página de verificación no se abre. Copia el código de usuario que aparece en el diálogo de inicio de sesión, abre la URL de verificación manualmente y pega el código. Comprueba que tu URL de Engram (Cloud o Self-Host) es correcta en los ajustes del plugin.
• Aprobaste en el navegador pero el plugin nunca lo confirma. El plugin consulta el token después de que apruebes; dale unos segundos. Si sigue sin confirmar, cierra el diálogo e inicia sesión de nuevo desde la página de ajustes del plugin.
• “Invalid token” tras iniciar sesión. Es posible que tu sesión haya caducado. Cierra sesión desde la página de ajustes del plugin e inicia sesión de nuevo.

La sincronización se queda en “Pending push: N”

• Revisa el registro Centro de sincronización → Recent activity para ver el error más reciente.
• Si el backend es accesible pero los envíos devuelven 409 (conflicto de versión), probablemente es un conflicto real; abre la cola de conflictos.
• Si los envíos devuelven 413, la nota supera el límite de tamaño por nota. Divídela.
• Si los envíos devuelven 429, se te está limitando la tasa de peticiones. Espera un minuto y reintenta, o revisa tu nivel de suscripción.

La aplicación web muestra contenido obsoleto

• Recarga la página una vez. La aplicación web se suscribe a actualizaciones en vivo, pero la carga inicial está en caché.
• Confirma que el plugin en Obsidian muestra una hora de Last sync posterior a tu edición más reciente.

Una nota concreta no se sincroniza

• Revisa la ruta en busca de caracteres no permitidos (sobre todo en el móvil, consulta Móvil).
• Revisa el tamaño de la nota. Hay un límite de tamaño por nota.
• Abre el Centro de sincronización, busca la nota en Pending push y pasa el cursor por encima para ver el motivo del error.

El plugin no carga tras una actualización

• Abre la consola de desarrollo de Obsidian (Ctrl/Cmd+Shift+I) y busca errores que mencionen engram-vault-sync.
• Prueba a desactivar y volver a activar el plugin en Settings → Community plugins.
• Si se publicó una versión rota, registra el error en engram-app/Engram-obsidian y desinstala el plugin temporalmente. La versión anterior no se puede recuperar desde dentro de Obsidian una vez que la actualización del directorio de la comunidad está instalada.

Dónde informar de errores

Incidencias de engram-app/Engram-obsidian. Incluye:

• Versión de Obsidian, plataforma (escritorio/iOS/Android) y versión del sistema operativo
• Versión del plugin de Engram
• Captura de pantalla del registro Centro de sincronización → Recent activity
• Pasos para reproducirlo