KeystrokeQueuing (Очереди нажатий клавиш)

Краткое описание

Keystroke Queuing — это дополнение для NVDA, которое позволяет определять именованные последовательности нажатий клавиш, действий мыши и ввода текста в простом конфигурационном файле, а затем выполнять любую последовательность всего несколькими нажатиями клавиш.

Требования

• NVDA 2024.1 или новее (протестировано вплоть до NVDA 2026.1, 64-разрядная версия)
• Python 3.12+ (поставляется с NVDA 2026)

Установка

1. Загрузите файл .nvda-addon.
2. Откройте его с помощью NVDA (двойным щелчком или используя Сервис → Менеджер дополнений → Установить).
3. Перезапустите NVDA, когда будет предложено.

При первой установке файл keystrokeQueuing.cfg по умолчанию копируется в каталог пользовательских настроек NVDA, чтобы вы могли его настроить.

Использование

Стандартные сочетания клавиш

| Сочетание | Действие | |---|---| | NVDA+Shift+Q | Открыть диалог выбора очереди команд | | NVDA+Control+Shift+Q | Перезагрузить конфигурационный файл |

Выбор и выполнение очереди

1. Нажмите NVDA+Shift+Q.
2. Появится диалог со списком всех настроенных очередей команд по именам.
3. Выберите очередь и нажмите Enter (или нажмите кнопку ОК).
4. NVDA объявляет имя очереди и выполняет каждый шаг последовательно.
5. По завершении NVDA объявляет «Готово».

Панель настроек

Вы можете редактировать конфигурацию непосредственно из NVDA:

1. Перейдите в NVDA → Параметры → Настройки.
2. Выберите категорию Очереди нажатий клавиш в списке слева.
3. Панель отображает текстовый редактор с предварительно загруженным содержимым вашего текущего keystrokeQueuing.cfg.
4. Отредактируйте команды по мере необходимости (формат описан ниже).
5. Нажмите ОК или Применить для сохранения. Конфигурация записывается в каталог пользовательских настроек NVDA и автоматически перезагружается — перезапуск не требуется.

Конфигурационный файл

Конфигурация находится в файле keystrokeQueuing.cfg. При установке он копируется в каталог пользовательских настроек NVDA (обычно %APPDATA%\nvda\). Если файл там не найден, дополнение использует резервную копию по умолчанию, встроенную в дополнение. Вы можете редактировать этот файл вручную или использовать встроенную панель настроек, описанную выше.

Формат

# Строки, начинающиеся с #, являются комментариями
queueName=step1|delay1||step2|delay2||step3|delay3

Каждая очередь представляет собой одну строку. Имя (до =») отображается в диалоге выбора. **Значение** (после =») представляет собой список шагов, разделённых ||. Каждый шаг имеет вид action|delay, где delay — задержка в секундах.

Поддерживаемые типы шагов

| Синтаксис | Описание | |---|---| | keystroke\|delay | Эмулировать сочетание клавиш, например control+v\|0.2 | | `text`\|delay | Ввести литеральный текст символ за символом | | mouseMoveX*Y\|delay | Переместить мышь в абсолютную позицию (например mouseMove100*200) | | mouseMove+X*-Y\|delay | Переместить мышь относительно текущей позиции | | mouseClick\|delay | Щелкнуть левой кнопкой в текущей позиции мыши | | mouseDoubleClick\|delay | Дважды щелкнуть левой кнопкой в текущей позиции мыши | | tellMe:message\|delay | Показать окно сообщения с заданным текстом |

Пример конфигурации

# Ввести «title of window is», затем нажать Insert+T, чтобы прочитать заголовок окна
title=`title of window is`|0.2||insert+t|0.0

# Открыть Firefox через диалог «Выполнить»
firefox=windows+r|0.2||`firefox`|0.2||enter|2.0||alt+d|0.2

# Открыть Блокнот, вставить текст из буфера обмена, открыть меню «Файл»
notepad=windows+r|0.5||`notepad`|0.2||enter|1.0||ctrl+v|0.2||alt+f|0.2

# Открыть Блокнот, ввести текст, показать сообщение
notepad2=windows+r|0.5||`notepad`|0.2||enter|1.0||`hello world`|0.5||tellMe:how are you today|0.5

# Переместить мышь в точку (25, 25) и щёлкнуть
clickMouseOn25-25=mouseMove25*25|0.5||mouseClick|0.2

# Показать рабочий стол и дважды щёлкнуть в определённой позиции
doubleClickThisPC=windows+m|0.2||mouseMove39*139|0.2||mouseDoubleClick|0.1

Сборка из исходников

Необходимые компоненты

• Python 3.12+
• SCons (pip install scons)
• Инструменты Gettext (для переводов, необязательно)

Сборка

cd keystrokeQueuing
scons

Эта команда создаёт файл keystrokeQueuing-1.0.0.nvda-addon в корне проекта.

Быстрая упаковка (без SCons)

Если вы просто хотите создать файл .nvda-addon вручную:

cd keystrokeQueuing/addon
zip -r ../keystrokeQueuing-1.0.0.nvda-addon . -x "*.pyc" "__pycache__/*"

Или в Windows с помощью PowerShell:

cd keystrokeQueuing\addon
Compress-Archive -Path .\* -DestinationPath ..\keystrokeQueuing-1.0.0.nvda-addon

Переименуйте расширение .zip в `.nvda-addon», если ваш архиватор добавляет его.

Изменения

1.1.0

• Добавлена панель настроек в NVDA → Параметры → Настройки для редактирования конфигурационного файла из графического интерфейса NVDA.
• Сохранение из панели настроек автоматически перезагружает конфигурацию без перезапуска NVDA.

1.0.0

• Первоначальный выпуск для NVDA 2026.
• Совместимость с Python 3.12, поддержка 64-разрядной версии.
• Настраиваемые очереди нажатий клавиш через keystrokeQueuing.cfg.
• Поддержка перемещения мыши, щелчка, двойного щелчка, ввода текста и отображения сообщений.
• Стандартная горячая клавиша: NVDA+Shift+Q.
• Горячая клавиша перезагрузки конфигурации: NVDA+Control+Shift+Q.

Лицензия

Это дополнение распространяется под лицензией GNU General Public License версии 2. Полный текст лицензии см. в файле COPYING.txt.