https://github.com/MisterK-Dev/BOA-Better-Office-Accessibility-with-NVDA#changelog

BOA: (Улучшенная доступность Office)

BOA (Better Office Accessibility) — это мощный набор улучшений доступности для Microsoft Office, предназначенный для значительного улучшения работы с экранным диктором NVDA. Он напрямую исправляет недоступные компоненты пользовательского интерфейса и предоставляет инструменты быстрой навигации для Excel и PowerPoint.

Возможности

Возможности Excel:

1. Массовое управление листами

Мгновенно изменяйте порядок и упорядочивайте несколько листов одновременно с помощью полностью доступной таблицы в диалоговом окне.

• Горячая клавиша: NVDA + E, затем X
• Как это работает: Открывает диалоговое окно, где вы можете выбрать лист и назначить ему новую позицию. Запланированные перемещения перечислены в таблице (нажмите Del, чтобы удалить ошибочную запись). Нажмите OK, и ваша книга будет мгновенно переупорядочена.

2. Быстрое перемещение листа

Мгновенно перемещайте активный лист влево, вправо, в самое начало или в самый конец с помощью клавиатуры.

• Горячие клавиши: NVDA + Shift + стрелки влево/вправо, клавиши Page Up, Page Down, а также Home и End. Упомянутые клавиши со стрелками используются для перемещения вверх и вниз; Page Up и Page Down делают то же самое; NVDA + Shift + Home/End перемещает лист в начало или в конец.

3. Улучшенное предотвращение потери фокуса

• Встроенная UI Automation Excel часто теряет фокус при снятии выделения с ячеек. BOA автоматически восстанавливает и озвучивает правильный фокус на ячейке, чтобы NVDA не замолкала.

4. Доступное переименование листа

• При переименовании листа NVDA изначально с трудом озвучивает вводимые символы.
• BOA внедряет пользовательский класс ExcelSheetRenameEdit, который использует механизм SafeRichEdit. Это позволяет вам точно читать текст по символам, словам или строкам во время переименования.

5. Отслеживание скрытых строк и столбцов

• Активно отслеживает ваше перемещение по таблице, чтобы вы не пропустили скрытые или отфильтрованные данные.
• Пересечение фрагментированных ячеек: Если вы перепрыгиваете через сильно фрагментированный или скрытый участок таблицы (например, перемещаясь со строки 3 на строку 10, потому что строки 4–9 скрыты), BOA явно объявляет: «Строки с 4 по 9 скрыты». Это гарантирует, что вы всегда будете знать, когда данные были пропущены в структуре. «Пересечение фрагментированных ячеек» означает обнаружение двух или более различных скрытых блоков, а не одного цельного скрытого блока.

Возможности PowerPoint

1. Доступные палитры цветов

• Открывает диалог пользовательского цвета в PowerPoint.
• Корректно идентифицирует и озвучивает поля ввода «Красный», «Зеленый» и «Синий» (путем переопределения PowerPointRGBEdit).
• Делает доступным ранее невидимое поле ввода Hex, чтобы NVDA могла четко считывать полное значение цвета в Hex.

2. Поддержка стандартной сетки цветов

• Навигация по шестиугольной сетке «Стандартных» цветов в PowerPoint обычно озвучивается как «Графика» или не озвучивается вовсе.
• BOA отслеживает нажатия клавиш со стрелками (Вверх, Вниз, Влево, Вправо) по шестиугольнику и незаметно получает скрытое значение цвета, озвучивая его вам в реальном времени (например, «Цвет #FF0000»).

Префикс команд NVDA+E

Чтобы избежать конфликтов горячих клавиш с другими дополнениями NVDA, BOA использует режим префикса команд:

1. Нажмите NVDA+E для входа в режим команд. Вы услышите высокий звуковой сигнал.
2. Нажмите вторую клавишу для вызова функции.
   • Пример: NVDA+E, затем X = Открыть массовый редактор листов Excel.
   • Пример: NVDA+E, затем Escape = Выход из режима команд.

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

Настройка

Функции BOA полностью модульны и могут быть включены или отключены в любое время. Перейдите в Меню NVDA -> Параметры -> Настройки -> Улучшенная доступность Office, чтобы переключать отдельные функции без перезапуска NVDA.

⚙️ Настройки и конфигурация

Начиная с версии 1.1.0, BOA включает полностью доступную родную панель настроек NVDA. Вы можете найти ее, перейдя в Меню NVDA -> Параметры -> Настройки -> BOA Office Enhancements.

Возможности менеджера конфигурации:

• Все функции включены по умолчанию, но могут быть отключены индивидуально.
• Настройки сгруппированы по приложениям (Excel, PowerPoint, Word).
• Настройки надежно сохраняются в отдельный JSON-файл (boa_settings.json), что гарантирует, что ваша основная конфигурация NVDA никогда не будет повреждена.
• Если Microsoft Office официально исправит ту или иную проблему доступности в будущем, вы сможете безопасно отключить конкретный перехватчик BOA, не теряя при этом остальной функциональности дополнения!

Безопасность

BOA создан со строгими границами безопасности. Фоновые COM-манипуляции выполняются в безопасно инициализированных изолированных средах, а вставки из буфера обмена строго проверяют идентификатор процесса окна на переднем плане, чтобы предотвратить утечку данных в другие приложения.

Требования

• NVDA 2026.1.0 или новее.
• Microsoft Excel и PowerPoint.

Установка

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

Журнал изменений

Версия 1.2.0 — 2026-06-03

Финальный выпуск v1.2.

Новые возможности

• Кэширование при запуске приложений — Крупная архитектурная перестройка. Основные модули теперь загружаются отложенно только тогда, когда вы фокусируетесь на приложениях Office, что устраняет задержки при запуске, полностью решает проблему глючного фокуса на «неизвестном» объекте в диалогах переименования и сохраняет структуру многомодульной кодовой базы. Примечание: эти ошибки могут отсутствовать в стабильной версии 1.1, но присутствовали в разрабатываемых версиях 1.2 из-за реорганизации кода.
• Улучшенный трекер ячеек (1D COM Math) — Переписал логику обнаружения скрытых ячеек для оценки только одномерных сечений (current_col или current_row). Это снижает нагрузку на COM-вычисления более чем на 16 миллионов ячеек, мгновенно устраняя зависания навигации при перепрыгивании скрытых диапазонов.
• Очистка памяти процесса — Реализовано отслеживание дескриптора окна Excel (Hwnd) для обнаружения момента, когда пользователь закрывает и снова открывает Excel. Это активно очищает устаревшие данные глобального состояния и полностью решает проблему ложного объявления «Лист скрыт» при открытии новой книги «Книга1».
• Интеллектуальные комментарии к API кода — Полностью задокументирована кодовая база с использованием автоматических внедрений докстрингов. Теперь каждая функция, метод и взаимодействие NVDA с UIA полностью задокументированы для удобства будущей поддержки.

Исправления ошибок

• Деактивация детектора границ — Детектор границ (Proactive Boundary Detector) был деактивирован для защиты стабильности родной навигации NVDA, полностью полагаясь теперь только на трекер пропуска ячеек.

Версия 1.1.0 — 2026-05-30

Финальный выпуск.

Новые возможности

• Графический интерфейс настроек — Добавлена родная панель BOA Office Enhancements в NVDA -> Настройки -> Параметры для простого включения и отключения функций.
• Перехватчик SafeRichEdit — Предотвращает незаметные сбои NVDA при взаимодействии с элементами управления RichEdit в Office 2024.
• Настраиваемые горячие клавиши — Все горячие клавиши BOA теперь полностью доступны в диалоге «Жесты ввода» NVDA в категории «Better Office Accessibility».
• Excel: Обнаружение пропуска скрытых строк и столбцов — Активно объявляет о навигации мимо скрытых строк или столбцов, гарантируя, что вы никогда не пропустите отфильтрованные данные. Можно отключить в настройках.

Исправления ошибок

• Безопасность потоков — Удалены все блокирующие задержки (time.sleep) и заменены на неблокирующие асинхронные обратные вызовы NVDA, чтобы экранный диктор никогда не заикался во время фоновых операций.
• Excel: Двойное объявление выделения — Исправлена проблема, из-за которой BOA избыточно объявляла выделение диапазона ячеек, которое NVDA обрабатывает самостоятельно (например, при использовании Shift+клавиши со стрелками).

Версия 1.0.0 — 2026-05-24

Первый публичный выпуск.

Новые возможности

• Excel: Массовое управление листами (NVDA+Alt+C) — Мгновенное изменение порядка нескольких листов с помощью полностью доступного диалогового окна.
• Excel: Быстрое перемещение листа (NVDA+Shift+Стрелки) — Перемещение активного листа влево, вправо, в начало или в конец с помощью клавиатуры.
• Excel: Доступное переименование листа — Перехватывает недоступное родное поле переименования и заменяет его надежным доступным диалогом.
• Excel: Умное отслеживание выделения — Точное объявление выделения диапазона ячеек и снятия выделения.
• PowerPoint: Доступные палитры цветов — Позволяет NVDA точно считывать значения RGB и Hex в диалоге пользовательского цвета.
• PowerPoint: Поддержка стандартной сетки цветов — Перехватывает навигацию клавишами со стрелками для считывания скрытых Hex-кодов из недоступной шестиугольной сетки цветов.