Устранение неполадок
Распространённые проблемы и их решения.
macOS: «Приложение не может быть открыто»
Если macOS блокирует Moraya при первом запуске:
- Перейдите в Системные настройки > Конфиденциальность и безопасность
- Прокрутите вниз, чтобы найти сообщение о блокировке Moraya
- Нажмите «Всё равно открыть»
macOS: Иконка в Dock выглядит стандартной в режиме разработки
При запуске pnpm tauri dev иконка в Dock отображается как стандартная иконка приложения. Это ожидаемое поведение — в режиме разработки нет пакета .app. Запустите pnpm tauri build, чтобы увидеть правильную иконку.
ИИ: API-ключ не работает
- Убедитесь, что API-ключ правильный и срок его действия не истёк
- Проверьте, что вы выбрали правильного провайдера в Настройки > ИИ
- Для Ollama убедитесь, что сервер Ollama запущен локально (
ollama serve)
Редактор: Математика не отображается
Убедитесь, что вы используете правильный синтаксис: одинарный $ для встроенной, двойной $$ для блочной математики. KaTeX может не поддерживать все пакеты LaTeX — проверьте список поддерживаемых функций KaTeX.
Производительность при больших файлах
Для очень больших файлов Markdown (>1 МБ) рекомендуется использовать Исходный режим (Cmd+/) для лучшей производительности, так как WYSIWYG-рендеринг больших документов может быть медленнее.
Сообщение об ошибках
Если вы обнаружили ошибку, пожалуйста, сообщите о ней на GitHub Issues, указав:
- Вашу ОС и версию
- Версию Moraya (из Справка > О программе)
- Шаги для воспроизведения проблемы
- Ожидаемое и фактическое поведение