consoleLog - Manual de Usuario Completo

Versión: 2026.01.06 Autor y Desarrollador: Héctor J. Benítez Corredera


Índice

  1. Introducción
  2. Instalación y Primeros Pasos
  3. El Visor de Consola
  4. El Lanzador de Consolas
  5. Sistema de Plugins (Herramientas Inteligentes)
  6. Configuración y Personalización
  7. Solución de Problemas
  8. Créditos y Licencia

1. Introducción

consoleLog (anteriormente conocido como VisorConsolasXD) es un complemento para el lector de pantalla NVDA diseñado para mostrar en un diálogo el contenido de las consolas de Windows. Permite a los usuarios interactuar con entornos de línea de comandos (como CMD, PowerShell, Terminal, Bash o Visual Studio developer) mediante una interfaz de texto enriquecido, accesible y altamente personalizable.

2. Instalación y Primeros Pasos

Una vez instalado el complemento, la primera acción recomendada es asignar un comando de teclado para abrir el visor: 1. Abra el menú de NVDA (Insert+N). 2. Vaya a Preferencias -> Gestos de entrada. 3. Busque la categoría Visor de consola. 4. Asigne una tecla a Muestra el visor de consola (por ejemplo: NVDA+Control+V).

3. El Visor de Consola

Cuando presiona el comando asignado estando sobre una ventana de consola, consoleLog captura todo el texto actual y lo presenta en una ventana dedicada. Esta ventana ignora las limitaciones de lectura de la consola estándar y permite navegar línea a línea con total libertad.

Atajos de Teclado (Dentro del Visor)

El visor está optimizado para la velocidad y accesibilidad: - Alt: Activa la barra de menús superior. - Control + F: Abre el diálogo de búsqueda de texto. - F3 / Shift + F3: Salta a la siguiente / anterior coincidencia de búsqueda (Ciclo completo). - Control + G: Diálogo para saltar rápidamente a una línea específica. - Control + S: Guarda todo el historial actual en un archivo .txt. - Control + P: Abre directamente el diálogo de opciones/ajustes. - Control + Shift + F: Conmuta el Modo de Seguimiento Automático (Auto-Tail). - Control + C / Control + A: Copiar selección / Seleccionar todo el contenido. - F1: Anuncia la posición actual del cursor (línea y columna). - F2: Ayuda de atajos de teclado (Accesible y navegable). - F5: Actualiza el contenido (Nota: Aviso informativo en Windows Terminal). - Escape / Alt + F4: Cierra el visor de consola.

Gestión de Archivos y Búsqueda

El visor no es solo lectura. Puede guardar sesiones completas de depuración o logs extensos para su análisis posterior. La búsqueda es de "ciclo completo", lo que significa que si llega al final del texto y no encuentra más resultados, volverá a empezar por el principio automáticamente.

4. El Lanzador de Consolas

Esta función permite abrir rápidamente diferentes consolas en el directorio actual del Explorador de Windows o el Escritorio. 1. Presione el comando del lanzador (debe asignarlo en Gestos de Entrada). 2. Aparecerá una lista con las consolas instaladas en su sistema: - CMD (Símbolo del sistema de Windows). - PowerShell (Instancia clásica v5.1). - PowerShell 7 (Versión Core, si está instalada). - Windows Terminal (Soporta pestañas y perfiles modernos). - Git Bash (Entorno Git para Windows). - WSL (Linux) (Subsistema de Windows para Linux). - Visual Studio developer (Símbolo del sistema para desarrolladores de 32 y 64 bits). - Msys2 / MinGW (Entornos de desarrollo adicionales). 3. Seleccione una y se abrirá instantáneamente en esa ubicación exacta.

5. Sistema de Plugins (Herramientas Inteligentes)

consoleLog cuenta con una arquitectura modular que permite extender sus funcionalidades mediante plugins.

Google AI (Gemini/Gemma)

Permite mantener una conversación inteligente sobre el contenido de su consola. - Chat Interactivo: Utilice j y k para moverse cíclicamente por el historial de mensajes (con audio-feedback). - Auto-reparar error: Botón que analiza el fallo actual y propone parches de código exactos. - Generador de Informe: Nuevo plugin que genera un reporte estructurado (Resumen, Errores, Soluciones) en Markdown. - Configuración multi-clave: Soporte para múltiples API Keys con rotación automática en caso de límites (429). - Archivos adjuntos: Cargue archivos .txt para dar más contexto a la IA. - Instrucciones de Sistema: Personalice la personalidad de su asistente.

Herramientas de Análisis de Datos

Herramientas de Utilidad

6. Configuración y Personalización

A través del menú Archivo -> Opciones, puede ajustar el comportamiento del visor: - Talla de Fuente: Ajuste el tamaño para su comodidad visual. - Fuente Monoespaciada: Actívela para que las tablas y el código se alineen correctamente. - Recordar Posición: El visor puede recordar el tamaño y posición de la ventana. - Recordar selección en Lanzador: Vuelve a seleccionar la última consola usada automáticamente. - Sistema de Alertas y Marcadores: Defina palabras clave (ej: ERROR) que disparen sonidos o anuncios de NVDA en tiempo real. - Categorizar Plugins: Organización inteligente por submenús (IA, Desarrollo, Utiles). - Intervalo de Seguimiento: Configure el tiempo de refresco del Modo Tail (1-60 seg). - Sonidos Personalizados: Elija silenciar las actualizaciones automáticas manteniendo los sonidos de activación. - Gestión de Plugins: Pestaña dedicada para habilitar/deshabilitar herramientas.

7. Solución de Problemas

8. Créditos y Licencia

Este complemento es software libre bajo la licencia GPL v2. Desarrollador Principal: Héctor J. Benítez Corredera. Contacto: xebolax@gmail.com Repositorio: GitHub consoleLog


Gracias por usar consoleLog. Esperamos que esta herramienta mejore significativamente su productividad día a día.