ConsoleLog — Полное руководство пользователя

Версия: 2026.01.06 Автор и разработчик: Héctor J. Benítez Corredera

Содержание

1. Введение
2. Установка и первые шаги
3. Просмотрщик консоли
   • Горячие клавиши
   • Управление файлами и поиск
4. Запускатор консолей
5. Система плагинов (интеллектуальные инструменты)
   • Google AI (Gemini/Gemma)
   • Инструменты анализа данных
   • Полезные инструменты
6. Настройка и персонализация
7. Решение проблем
8. Благодарности и лицензия

1. Введение

consoleLog (ранее известный как VisorConsolasXD) — это дополнение для экранного диктора NVDA, предназначенное для отображения в диалоговом окне содержимого консолей Windows. Оно позволяет пользователям взаимодействовать с командными средами (такими как CMD, PowerShell, Terminal, Bash или Visual Studio developer) через интерфейс с форматированным текстом, который доступен и легко настраивается.

2. Установка и первые шаги

После установки дополнения первым делом рекомендуется назначить команду клавиш для открытия просмотрщика:

1. Откройте меню NVDA (Insert+N).
2. Перейдите в Параметры -> Жесты ввода.
3. Найдите категорию Просмотрщик консоли.
4. Назначьте клавишу для Показать просмотрщик консоли (например: NVDA+Control+V).

3. Просмотрщик консоли

Когда вы нажимаете назначенную команду, находясь в окне консоли, consoleLog захватывает весь текущий текст и отображает его в специальном окне. Это окно не имеет ограничений на чтение, свойственных стандартной консоли, и позволяет полностью свободно перемещаться по строкам.

Горячие клавиши (внутри просмотрщика)

Просмотрщик оптимизирован для скорости и доступности:

• Alt: Активирует верхнюю строку меню.
• Control + F: Открывает диалог поиска текста.
• F3 / Shift + F3: Переход к следующему / предыдущему совпадению при поиске (полный цикл).
• Control + G: Диалог для быстрого перехода на определённую строку.
• Control + S: Сохраняет всю текущую историю в файл .txt.
• Control + P: Открывает диалог параметров/настроек.
• Control + Shift + F: Включает Режим автоматического отслеживания (Auto-Tail).
• Control + C / Control + A: Копировать выделенное / Выделить всё содержимое.
• F1: Сообщает текущую позицию курсора (строка и столбец).
• F2: Справка по горячим клавишам (доступная и удобная для навигации).
• F5: Обновляет содержимое (Примечание: информационное предупреждение для Windows Terminal).
• Escape / Alt + F4: Закрывает просмотрщик консоли.

Управление файлами и поиск

Просмотрщик предназначен не только для чтения. Вы можете сохранять целые сеансы отладки или объёмные журналы для последующего анализа. Поиск работает в режиме «полного цикла»: если вы дошли до конца текста и не нашли больше совпадений, поиск автоматически начнётся с начала.

4. Запускатор консолей

Эта функция позволяет быстро открывать различные консоли в текущей папке Проводника Windows или на Рабочем столе.

1. Нажмите команду запускатора (её нужно назначить в Жестах ввода).
2. Появится список доступных в вашей системе консолей:
   • CMD (командная строка Windows).
   • PowerShell (классическая версия 5.1).
   • PowerShell 7 (версия Core, если установлена).
   • Windows Terminal (поддерживает вкладки и современные профили).
   • Git Bash (среда Git для Windows).
   • WSL (Linux) (подсистема Windows для Linux).
   • Visual Studio developer (командная строка разработчика для 32 и 64 бит).
   • Msys2 / MinGW (дополнительные среды разработки).
3. Выберите нужную консоль, и она откроется в этой точной папке.

5. Система плагинов (интеллектуальные инструменты)

consoleLog имеет модульную архитектуру, позволяющую расширять его функциональность с помощью плагинов.

Google AI (Gemini/Gemma)

Позволяет вести интеллектуальный диалог о содержимом вашей консоли.

• Интерактивный чат: Используйте j и k для циклического перемещения по истории сообщений (со звуковой обратной связью).
• Авто-исправление ошибки: Кнопка, которая анализирует текущую ошибку и предлагает точные исправления кода.
• Генератор отчёта: Новый плагин, создающий структурированный отчёт (Резюме, Ошибки, Решения) в формате Markdown.
• Мульти-ключ настройки: Поддержка нескольких API-ключей с автоматической ротацией при достижении лимитов (429).
• Вложения: Загружайте файлы .txt, чтобы дать ИИ больше контекста.
• Системные инструкции: Настройте личность вашего ассистента.

Инструменты анализа данных

• Извлечение данных: Находит IP-адреса, URL-адреса и пути к файлам.
• JSON Beauty: Форматирует неструктурированные блоки JSON.
• Декодировщик JWT: Находит и декодирует токены безопасности JWT в журналах.
• Форматировщик SQL: Упорядочивает сложные SQL-запросы для удобного чтения.
• Фильтр журналов: Изолирует строки по уровням (Ошибка, Информация и т.д.).

Полезные инструменты

• Монитор ресурсов: Показывает использование диска, ОЗУ и версию NVDA в быстрой панели.
• Анализатор StackTrace: Обнаруживает ошибки программирования Python и позволяет извлекать пути к задействованным файлам для быстрой отладки.
• Экспресс-калькулятор: Вычисляет математические операции, встречающиеся в тексте.
• Конвертер времени: Преобразует временные метки (UNIX timestamp) в читаемые даты.
• Base64: Декодирует строки в формате Base64, часто встречающиеся в журналах.
• Быстрое копирование: Позволяет копировать содержимое активной консоли напрямую, без открытия просмотрщика.

6. Настройка и персонализация

Через меню Файл -> Параметры вы можете настроить поведение просмотрщика:

• Размер шрифта: Настройте размер для вашего визуального комфорта.
• Моноширинный шрифт: Включите его для правильного выравнивания таблиц и кода.
• Запоминать положение: Просмотрщик может запоминать размер и положение окна.
• Запоминать выбор в Запускаторе: Автоматически выбирает последнюю использованную консоль.
• Система оповещений и маркеров: Определите ключевые слова (например: ERROR), которые будут вызывать звуковые сигналы или объявления NVDA в реальном времени.
• Категоризация плагинов: Умная организация по подменю (ИИ, Разработка, Утилиты).
• Интервал отслеживания: Настройте время обновления Режима Tail (1-60 сек).
• Пользовательские звуки: Выберите отключение звуков автоматических обновлений, оставив звуки активации.
• Управление плагинами: Отдельная вкладка для включения/отключения инструментов.

7. Решение проблем

• Просмотрщик пуст: Убедитесь, что в консоли виден текст и она находится в фокусе перед вызовом команды.
• Google AI не отвечает: Проверьте ваши API-ключи и подключение к интернету.
• Alt не открывает меню: Если фокус застрял в тексте, попробуйте нажать Escape один раз, затем Alt.
• F5 не работает в Windows Terminal: Из-за архитектурных особенностей изоляции Windows Terminal, обновление в реальном времени для этой консоли в настоящее время отключено. Рекомендуется закрыть и снова открыть просмотрщик (NVDA+Control+V), чтобы получить обновлённое содержимое.

8. Благодарности и лицензия

Это дополнение является свободным программным обеспечением под лицензией GPL v2. Основной разработчик: Héctor J. Benítez Corredera. Контакты: xebolax@gmail.com Репозиторий: GitHub consoleLog

Спасибо за использование consoleLog. Мы надеемся, что этот инструмент значительно повысит вашу ежедневную продуктивность.