Улучшена система управления фоновой очисткой конфигурации, включая команду для перезапуска NVDA.

GestureDuplicate (Дублирующиеся жесты)

Находите, исправляйте и очищайте запутанные назначения клавиатурных жестов — прежде чем они вызовут конфликты.

автор: chai chaimee

url: https://github.com/chaichaimee/GestureDuplicate

Введение

Gesture Duplicate — это инструмент для наведения порядка в клавиатурных сочетаниях и конфигурации NVDA. Со временем, по мере установки и удаления дополнений, ваша конфигурация NVDA может накапливать два вида беспорядка: клавиатурные жесты, назначенные сразу нескольким командам (так что фактически срабатывает только одна из них), и оставшиеся пользовательские записи жестов или разделы конфигурации, принадлежащие дополнениям, которые вы больше не устанавливали.

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

Сочетания клавиш

Windows+Shift+G
Одно нажатие: Проверить дублирующиеся жесты
Двойное нажатие: Управление пользовательскими жестами
Тройное нажатие (или более): Очистить конфигурацию

Как работает многократное нажатие:
Gesture Duplicate использует одно сочетание клавиш для всех трёх инструментов, различая их по количеству быстрых последовательных нажатий.

Каждый раз, когда вы нажимаете Windows+Shift+G, дополнение проверяет, сколько времени прошло с момента последнего нажатия. Если этот промежуток меньше 0.4 секунды, ваше нажатие добавляется к текущему счётчику для текущей «серии»; если прошло больше времени, счёт начинается заново с 1. После каждого нажатия таймер на 0.4 секунды (пере)запускается. Если вы нажмёте снова до срабатывания таймера, предыдущий таймер отменяется и запускается новый, так что дополнение продолжает ждать, пока вы продолжаете нажимать.

Только когда таймер наконец истечёт без нового нажатия, дополнение действует в соответствии с общим числом зафиксированных нажатий: 1 нажатие открывает «Проверить дублирующиеся жесты», 2 нажатия открывают «Управление пользовательскими жестами», а 3 или более нажатий открывают «Очистить конфигурацию».

Все три инструмента также доступны в любой момент из подменю NVDA «Сервис» → «Gesture Duplicate» в виде отдельных пунктов меню: «Проверить дублирующиеся жесты...», «Управление пользовательскими жестами...» и «Очистить конфигурацию...». Это подменю добавляется автоматически при запуске NVDA и аккуратно удаляется при отключении дополнения или выходе из NVDA.

Возможности

1. Проверить дублирующиеся жесты

Этот инструмент сканирует каждый жест, зарегистрированный в данный момент в NVDA — по всем дополнениям, модулям приложений и собственным командам NVDA — чтобы найти любой клавиатурный (или иной ввод) жест, назначенный более чем одной команде. Когда две команды используют один и тот же жест, фактически может выполниться только одна из них, что обычно является признаком конфликта, который вы захотите разрешить.

Пошагово:

1. Дополнение запрашивает у менеджера ввода NVDA полную карту каждого жеста, зарегистрированного для каждого скрипта, во всех категориях.

2. Каждый жест сначала «нормализуется» — если имя вашей раскладки клавиатуры (например, «desktop») встроено в строку жеста, оно удаляется, так что одна и та же физическая комбинация клавиш распознаётся как идентичная независимо от раскладки.

3. Дополнение подсчитывает, сколько различных команд используют каждый нормализованный жест. Любой жест, используемый более чем одной командой, помечается как дублирующийся.

4. Дубликаты отображаются в диалоге-списке с тремя столбцами: понятный человеку «Жест», «Функция» (команда), которую он запускает, и «Контекст» (к какому дополнению или модулю приложения он относится). Дубликаты сортируются по алфавиту по жесту, чтобы связанные конфликты располагались рядом.

5. Выбор записи и нажатие «Открыть жесты ввода» (или нажатие Enter) закрывает этот диалог и открывает собственный диалог NVDA «Жесты ввода», автоматически отфильтрованный по конфликтующей команде, с раскрытой и сфокусированной нужной ветвью дерева, чтобы вы могли немедленно добавить или удалить жест, не разыскивая его.

2. Управление пользовательскими жестами

Этот инструмент нацелен специально на пользовательские жесты, созданные для дополнений — записи, которые NVDA хранит в своём файле gestures.ini. Его основное назначение — очистка жестов, оставшихся от дополнений, которые вы с тех пор удалили и которые иначе бессрочно остаются в вашей конфигурации.

Пошагово:

1. Дополнение читает ваш файл gestures.ini напрямую и собирает каждый пользовательский жест, принадлежащий разделу дополнения (либо глобальному плагину, либо модулю приложения), игнорируя собственные встроенные разделы NVDA «main»/«run».

2. Для каждой записи оно проверяет, установлено ли ещё дополнение-владелец в вашей системе. Записи, принадлежащие неустановленным дополнениям, отображаются серым текстом, чтобы они выделялись как безопасный для удаления мусор.

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

4. Вы можете отметить отдельные записи и нажать «Удалить отмеченные», чтобы удалить только их, или выбрать конкретное дополнение в фильтре и нажать «Удалить дополнение», чтобы одним махом удалить все пользовательские жесты, принадлежащие ему. «Очистить всё» удаляет каждый пользовательский жест дополнений в файле. Каждое удаление сначала запрашивает подтверждение.

5. Поскольку NVDA кэширует сопоставления жестов в памяти для текущего сеанса, очищенные записи не исчезнут полностью из собственного представления NVDA до перезапуска NVDA. После любой успешной очистки диалог переключается в режим «требуется перезапуск»: кнопка «Закрыть» заменяется кнопкой «Перезапустить NVDA сейчас» (закрытие диалога, в том числе через Escape или кнопку закрытия окна, запускает тот же перезапуск), чтобы изменение гарантированно вступило в силу.

3. Очистить конфигурацию

Этот инструмент позволяет удалять целые разделы верхнего уровня из вашего профиля конфигурации NVDA (nvda.ini) — например, оставшиеся разделы настроек, созданные дополнениями, которые вы больше не используете.

Пошагово:

1. Дополнение выводит список имён всех разделов верхнего уровня, присутствующих в данный момент в вашем активном профиле конфигурации NVDA, отсортированный по алфавиту, в виде списка с флажками.

2. Вы отмечаете разделы, которые хотите удалить (пробел переключает флажок; Delete также запускает удаление) и нажимаете «Удалить выбранные».

3. После подтверждения каждый выбранный раздел удаляется в два приёма: его сохранённые значения удаляются, а его запись в схеме проверки конфигурации также удаляется. Удаления только сохранённых значений недостаточно, так как иначе NVDA при следующей проверке вашего профиля заново создаст пустую заглушку для этого раздела, и он молча появится снова.

4. Конфигурация сохраняется немедленно, и список обновляется, подтверждая, что разделы исчезли.

Примечание: Все три инструмента по своей конструкции защитные — каждая операция сканирования и загрузки обёрнута так, что неожиданная ошибка записывается в журнал, а не приводит к сбою NVDA, а разрушительные действия (удаление жестов, удаление разделов конфигурации) всегда запрашивают подтверждение перед внесением изменений.

Поддержать меня

Если этот инструмент облегчил вам жизнь, подумайте о том, чтобы поддержать следующее обновление небольшим пожертвованием.

Ваша поддержка значит очень много. Давайте вместе создадим что-то великое

© 2026 Chai Chaimee NVDA Add-on Released under GNU GPL