Obsidian 동기화 문제 해결

증상 → 가능한 원인 → 시도해 볼 것.

로그인 실패

로그인은 기기 인증(device flow) 방식입니다. 플러그인이 짧은 사용자 코드를 보여 주고, 백엔드의 인증 페이지를 브라우저에서 열고, 당신이 승인할 때까지 확인을 반복합니다. obsidian:// URL 스킴으로 토큰이 돌아오는 일은 없습니다.

• 인증 페이지가 열리지 않습니다. 로그인 대화상자에 표시된 사용자 코드를 복사하고 인증 URL을 직접 연 다음 코드를 붙여 넣으세요. 플러그인 설정에서 Engram URL(Cloud 또는 Self-Host)이 맞는지 확인하세요.
• 브라우저에서 승인했는데 플러그인이 확인하지 않습니다. 플러그인은 승인 후 토큰을 계속 확인하므로 몇 초 기다려 보세요. 그래도 확인되지 않으면 대화상자를 닫고 플러그인 설정 페이지에서 로그인을 다시 시작하세요.
• 로그인 후 “Invalid token”이 표시됩니다. 세션이 만료되었을 수 있습니다. 플러그인 설정 페이지에서 로그아웃한 뒤 다시 로그인하세요.

동기화가 “Pending push: N”에서 멈춤

• 동기화 센터 → Recent activity 로그에서 가장 최근 오류를 확인하세요.
• 백엔드에 연결되는데 올릴 때 409(버전 충돌)가 나온다면 실제 충돌일 가능성이 큽니다. 충돌 대기열을 여세요.
• 올릴 때 413이 나온다면 노트가 노트당 크기 제한을 넘은 것입니다. 노트를 나누세요.
• 올릴 때 429가 나온다면 요청 제한에 걸린 것입니다. 1분 기다렸다가 다시 시도하거나 구독 요금제를 확인하세요.

웹 앱에 오래된 내용이 보임

• 페이지를 한 번 새로 고치세요. 웹 앱은 실시간 업데이트를 구독하지만 첫 로드는 캐시됩니다.
• Obsidian의 플러그인에 표시된 Last sync 시각이 마지막 편집보다 나중인지 확인하세요.

특정 노트가 동기화되지 않음

• 경로에 허용되지 않는 문자가 있는지 확인하세요(특히 모바일에서. 모바일 참고).
• 노트 크기를 확인하세요. 노트당 크기 제한이 있습니다.
• 동기화 센터를 열어 Pending push에서 해당 노트를 찾고, 마우스를 올려 오류 사유를 확인하세요.

업데이트 후 플러그인이 로드되지 않음

• Obsidian의 개발자 콘솔(Ctrl/Cmd+Shift+I)을 열어 engram-vault-sync가 언급된 오류가 있는지 확인하세요.
• 설정 → 커뮤니티 플러그인에서 플러그인을 껐다 켜 보세요.
• 릴리스가 잘못 배포되었다면 engram-app/Engram-obsidian에 버그를 등록하고 플러그인을 잠시 제거하세요. 커뮤니티 디렉터리의 업데이트가 설치된 뒤에는 Obsidian 안에서 이전 버전으로 되돌릴 수 없습니다.

버그를 신고할 곳

engram-app/Engram-obsidian 이슈. 다음을 포함해 주세요.

• Obsidian 버전, 플랫폼(데스크톱/iOS/Android), OS 버전
• Engram 플러그인 버전
• 동기화 센터 → Recent activity 로그의 스크린샷
• 재현 단계