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

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


Содержание

  1. Введение
  2. Установка и первые шаги
  3. Просмотрщик консоли
  4. Запускатор консолей
  5. Система плагинов (интеллектуальные инструменты)
  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, чтобы дать ИИ больше контекста. - Системные инструкции: Настройте личность вашего ассистента.

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

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

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

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

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

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

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


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