Logs y diagnóstico
Cuando algo no funciona como se espera, los logs de Nexo Whisper son la mejor fuente de información. Acá te mostramos cómo acceder a ellos y qué buscar.
Abrir Console.app
- Abrí Spotlight (⌘ Espacio) y buscá Console.
- Abrí la app Console.
- En la barra lateral izquierda, hacé clic en el nombre de tu Mac (bajo "Devices").
- En la barra de búsqueda superior, pegá el filtro:
com.prakashjoshipax.VoiceInk
- Presioná Enter.
Ahora ves solo los mensajes de Nexo Whisper.
Actualizá el filtro si ves demasiado ruido
Podés agregar la categoría al filtro para ser más específico, por ejemplo:
subsystem:com.prakashjoshipax.VoiceInk category:Recorder
Categorías de logs importantes
| Categoría | Qué loguea |
|-----------|------------|
| Recorder | Inicio/fin de grabación, nivel de audio, duración |
| VoiceInkEngine | Pipeline de transcripción, modelo cargado, tiempo de inferencia |
| LocalCLIService | Detección de CLIs, pre-warm, ejecución de comandos |
| AIEnhancementService | Llamadas a la API de mejora, tokens usados, errores de red |
Errores comunes y qué significan
Microphone access denied
El permiso de micrófono no está otorgado. Ver Permisos.
No focused text field found
Nexo Whisper no encontró dónde pegar el texto. La app de destino puede no aceptar pegado programático. El texto igual quedó en el portapapeles — pegá con ⌘V.
Enhancement failed: API error 401
La API key no es válida o expiró. Verificá en el portal del provider.
Model not found at path
El archivo del modelo fue movido o borrado. Volvé a descargarlo desde Ajustes → Transcripción → Modelos.
Timeout after 500ms (AX timeout)
La app de destino no respondió a las queries de accesibilidad a tiempo. Es normal en apps muy ocupadas o bajo carga. Nexo Whisper hace fallback al portapapeles automáticamente.
Exportar logs para soporte
Si necesitás enviar logs a soporte:
- En Console.app con el filtro activo, seleccioná los mensajes relevantes (⌘A para todos).
- Menú → File → Export Selected Messages.
- Guardá como
.log. - Adjuntalos en tu email a soporte@nexostudio.xyz.
Los logs no contienen audio ni texto transcripto
Los logs contienen metadata (duración de grabación, modelo usado, errores) pero no el contenido de tus transcripciones ni el audio grabado.
Próximos pasos
- Problemas frecuentes — soluciones rápidas para los problemas más comunes.
- Reset completo — cuando nada más funciona.