Encontrar registros y reportar errores

Reúne la versión, los pasos y el fragmento de registro que permitan investigar un problema sin compartir información privada innecesaria.

Guía basada en el código 2.0.1-rc.7. Las capturas muestran la interfaz en inglés de una edición de prelanzamiento; sus valores ilustran ejemplos, no necesariamente los ajustes iniciales. Los paquetes de Descargas pueden ser diferentes: revisa sus notas y las opciones de guardado antes de procesar.

En esta página

Dónde está el registro

Yagua intenta escribir yagua.log en la carpeta de preferencias del usuario:

Sistema	Ruta
Windows	`%APPDATA%\Yagua\yagua.log`
Linux	`~/.config/Yagua/yagua.log`
macOS experimental	`~/Library/Application Support/Yagua/yagua.log`

Windows: pega %APPDATA%\Yagua en la barra de dirección del Explorador de archivos y abre yagua.log con un editor de texto.

Linux: abre ~/.config/Yagua en tu gestor de archivos; puede hacer falta mostrar archivos ocultos. El símbolo ~ representa la carpeta personal. En una terminal también puedes consultar la ruta sin modificar el archivo:

tail -n 100 ~/.config/Yagua/yagua.log

No existe un botón o menú Ajustes → Logs accesible en esta revisión. El registro se consulta desde el sistema de archivos. Si el perfil no tiene permiso de escritura, la aplicación puede continuar sin registro en disco.

Cómo obtener un caso útil

Anota la versión completa del paquete instalado, incluido rc si corresponde. Usa el nombre del instalador, AppImage o archivo portable y sus notas de publicación; la pantalla Actualizaciones mostrada no tiene un campo Versión actual. Si no puedes confirmarla, indícalo en el reporte.
Anota sistema, arquitectura, modalidad de instalación y de dónde descargaste el paquete.
Repite el problema con una copia pequeña y sin datos privados.
Anota la hora y el mensaje exacto que apareció.
Abre el registro y busca las líneas de ese momento, con las anteriores que expliquen qué módulo estaba trabajando.

El archivo agrega entradas con el tiempo. No hace falta enviar todo el historial si el fragmento relevante identifica el fallo. La fecha y hora facilitan ubicar el proceso correcto.

Qué revisar antes de compartir

Los logs pueden contener rutas completas, nombres de archivos, errores de bibliotecas y coordenadas relacionadas con tu tarea. También una captura de pantalla puede mostrar imágenes privadas. Revisa el material, oculta datos sensibles en una copia y conserva la estructura del error que sea necesaria para entenderlo.

No compartas contraseñas, tokens o archivos de configuración ajenos al problema. No publiques imágenes de terceros o documentos personales solo porque el sistema solicite un ejemplo: prepara una muestra que reproduzca el error sin exponerlos.

Plantilla de reporte

Abre una incidencia en Issues del proyecto e incluye, cuando corresponda:

Versión de Yagua:
Sistema y arquitectura:
Paquete: instalador / portable / AppImage / código fuente
Módulo y pestaña:
Idioma, tema y escala de interfaz:
Formato, dimensiones y número de imágenes:
Opciones utilizadas:
Pasos para reproducir:
Resultado esperado:
Resultado real y mensaje exacto:
¿Sucede con una muestra sin datos privados?:
Fragmento de yagua.log y hora del fallo:

Si es un problema de IA, indica si era la primera ejecución, si había conexión y qué idioma OCR seleccionaste. Para errores de exportación, informa si la salida ya existía y si podías escribir en esa carpeta. Para un fallo de inicio sin log, adjunta el error del sistema y cómo intentaste abrir el paquete.

Ejemplo de pasos concretos

“Abrir Convertir; seleccionar una imagen PNG de 800 × 600; elegir WEBP y calidad 85; pulsar Convertir; elegir una carpeta escribible; aparece el mensaje X” permite investigar mejor que “no convierte”.

No asumas que todos los archivos del lote fallaron si hay resultados parciales. Indica cuántos seleccionaste, cuántos se guardaron y qué formatos tenían los fallidos.