문제 해결
일반적인 문제와 해결책입니다.
macOS: “앱을 열 수 없음”
macOS에서 첫 실행 시 Moraya를 차단하는 경우:
- 시스템 설정 > 개인정보 보호 및 보안으로 이동하세요
- 아래로 스크롤하여 Moraya가 차단되었다는 메시지를 찾으세요
- **“그래도 열기”**를 클릭하세요
macOS: 개발 모드에서 Dock 아이콘이 일반적으로 표시됨
pnpm tauri dev를 실행하면 Dock 아이콘이 일반 앱 아이콘으로 나타납니다. 이는 정상적인 현상입니다 — 개발 모드에서는 .app 번들이 없습니다. 올바른 아이콘을 보려면 pnpm tauri build를 실행하세요.
AI: API 키가 작동하지 않음
- API 키가 정확하고 만료되지 않았는지 확인하세요
- 설정 > AI에서 올바른 제공자를 선택했는지 확인하세요
- Ollama의 경우 로컬에서 Ollama 서버가 실행 중인지 확인하세요 (
ollama serve)
에디터: 수식이 렌더링되지 않음
올바른 구문을 사용하고 있는지 확인하세요: 인라인에는 단일 $, 블록에는 이중 $$. KaTeX가 모든 LaTeX 패키지를 지원하지 않을 수 있습니다 — KaTeX 지원 함수 목록을 확인하세요.
대용량 파일 성능
매우 큰 Markdown 파일(>1MB)의 경우 소스 모드(Cmd+/)를 사용하는 것이 성능 향상에 도움이 됩니다. 큰 문서의 WYSIWYG 렌더링은 더 느릴 수 있습니다.
문제 보고
버그를 발견하면 다음 정보와 함께 GitHub Issues에 보고해 주세요:
- OS 및 버전
- Moraya 버전 (도움말 > 정보에서 확인)
- 문제를 재현하는 단계
- 예상 동작과 실제 동작