Устранение неполадок синхронизации Obsidian

Симптомы → вероятные причины → что попробовать.

Не удаётся войти

Вход использует привязку устройства: плагин показывает короткий код пользователя, открывает в браузере страницу подтверждения на сервере и опрашивает сервер, пока вы не подтвердите. Токен через URL-схему obsidian:// не возвращается.

Страница подтверждения не открывается. Скопируйте код пользователя из окна входа, откройте адрес подтверждения вручную и вставьте код. Проверьте, что адрес Engram (Cloud или Self-Host) в настройках плагина указан верно.
Подтвердили в браузере, но плагин не сообщает о входе. Плагин опрашивает сервер после вашего подтверждения; подождите несколько секунд. Если подтверждения всё равно нет, закройте окно и начните вход заново на странице настроек плагина.
«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. Укажите:

Версию Obsidian, платформу (компьютер/iOS/Android) и версию ОС
Версию плагина Engram
Снимок экрана журнала Центра синхронизации → Recent activity
Шаги воспроизведения