Solución de problemas

Problemas comunes y sus soluciones.

macOS: “No se puede abrir la app”

Si macOS bloquea Moraya en el primer inicio:

1. Ve a Ajustes del Sistema > Privacidad y seguridad
2. Desplázate hacia abajo para encontrar el mensaje sobre Moraya siendo bloqueada
3. Haz clic en “Abrir de todos modos”

macOS: El icono del Dock se ve genérico en modo desarrollo

Al ejecutar pnpm tauri dev, el icono del Dock aparece como un icono de app genérico. Esto es esperado — no hay un paquete .app en modo desarrollo. Ejecuta pnpm tauri build para ver el icono correcto.

IA: La clave API no funciona

• Verifica que la clave API sea correcta y no haya expirado
• Comprueba que hayas seleccionado el proveedor correcto en Configuración > IA
• Para Ollama, asegúrate de que el servidor Ollama esté ejecutándose localmente (ollama serve)

Editor: Las matemáticas no se renderizan

Asegúrate de estar usando la sintaxis correcta: un solo $ para en línea, doble $$ para bloque. KaTeX puede no soportar todos los paquetes LaTeX — consulta la lista de funciones soportadas por KaTeX.

Rendimiento con archivos grandes

Para archivos Markdown muy grandes (>1MB), considera usar el modo Código fuente (Cmd+/) para un mejor rendimiento, ya que el renderizado WYSIWYG de documentos grandes puede ser más lento.

Reportar problemas

Si encuentras un error, por favor repórtalo en GitHub Issues incluyendo:

• Tu sistema operativo y versión
• Versión de Moraya (desde Ayuda > Acerca de)
• Pasos para reproducir el problema
• Comportamiento esperado vs. comportamiento real