Solução de problemas

Problemas comuns e suas soluções.

macOS: “O app não pode ser aberto”

Se o macOS bloquear o Moraya na primeira execução:

1. Vá em Ajustes do Sistema > Privacidade e Segurança
2. Role para baixo até encontrar a mensagem sobre o Moraya sendo bloqueado
3. Clique em “Abrir Mesmo Assim”

macOS: Ícone do Dock genérico no modo de desenvolvimento

Ao executar pnpm tauri dev, o ícone do Dock aparece como um ícone de aplicativo genérico. Isso é esperado — não há pacote .app no modo de desenvolvimento. Execute pnpm tauri build para ver o ícone correto.

IA: Chave de API não funciona

• Verifique se a chave de API está correta e não expirou
• Confirme que você selecionou o provedor correto em Configurações > AI
• Para o Ollama, certifique-se de que o servidor Ollama está em execução localmente (ollama serve)

Editor: Matemática não renderiza

Certifique-se de que está usando a sintaxe correta: um único $ para em linha, duplo $$ para bloco. O KaTeX pode não suportar todos os pacotes LaTeX — consulte a lista de funções suportadas pelo KaTeX.

Desempenho com arquivos grandes

Para arquivos Markdown muito grandes (>1MB), considere usar o modo Código-fonte (Cmd+/) para melhor desempenho, pois a renderização WYSIWYG de documentos grandes pode ser mais lenta.

Reportando problemas

Se você encontrar um bug, por favor reporte no GitHub Issues com:

• Seu sistema operacional e versão
• Versão do Moraya (em Help > About)
• Passos para reproduzir o problema
• Comportamento esperado vs. comportamento real