Изменения минимальные: добавил файлы перевода (русский, английский).
Теперь, если интерфейс на английском, то и дополнение на английском — проверял, работает.
Можно добавить свою локализацию, код позволяет.
Также обновил справку, вроде полностью её доделав.
В интерфейс, где системные подсказки, добавил горячие клавиши:
Delete — для удаления, F2 — для редактирования, Control+S — для сохранения в .txt, если хотим поделиться своей системной подсказкой с кем-то.
На этом вроде всё, больше в это дополнение добавлять, в принципе, ничего не нужно.
Оно полностью выполняет свой функционал.

🧙 SpellGuard для NVDA

BY Zloi LTD — интеллектуальная проверка орфографии и пунктуации с помощью AI

📌 Введение

SpellGuard — это дополнение для экранного диктора NVDA, которое позволяет исправлять орфографические, пунктуационные и грамматические ошибки в выделенном тексте с помощью современных нейросетевых API. Дополнение поддерживает три провайдера: Google Gemini, Sber GigaChat и DeepSeek AI. Вы можете переключаться между ними на лету, настраивать системные промпты, включать автоматическую расстановку эмодзи и получать статистику по тексту.

Важно: Дополнение не использует встроенные словари — весь анализ и исправление выполняются удалёнными AI-моделями. Для работы требуется стабильное интернет-соединение и действующие API-ключи выбранного сервиса.

⚙️ Основные возможности

• Исправление текста — выделите фрагмент текста в любом приложении и нажмите назначенную клавишу. Дополнение отправит текст в AI, получит исправленный вариант и скопирует его в буфер обмена.
• Три AI-провайдера — Gemini, GigaChat, DeepSeek. Переключение без перезагрузки NVDA.
• Гибкие системные промпты — вы можете создавать, редактировать и удалять собственные инструкции для AI (названия и текст промпта).
• Интеграция эмодзи — по желанию AI добавит эмодзи в текст: в конце всего текста, после каждого предложения, после каждого абзаца или «умная» расстановка по смыслу.
• Статистика текста — быстрый подсчёт количества предложений, слов и символов в выделенном фрагменте.
• Тестирование соединения — проверка работоспособности API-ключа без отправки больших текстов.
• Управление промптами — специальный диалог со списком, контекстным меню и возможностью сохранить промпт в .txt.

🤖 Поддерживаемые AI-сервисы

🔐 Чек-лист получения API-ключей

Ниже приведены пошаговые инструкции для получения доступа к каждому из трёх сервисов. Все ссылки ведут на актуальные страницы разработчиков (по состоянию на 2026 год).

1. Google Gemini (AI Studio)

1. Перейдите на Google AI Studio → API Keys.
2. Войдите в свой аккаунт Google (если ещё не вошли).
3. Нажмите кнопку «Create API Key».
4. Выберите проект или создайте новый (например, NVDA SpellGuard).
5. Скопируйте сгенерированный ключ (он будет выглядеть как AIzaSy...).
6. Вставьте этот ключ в поле «Gemini API key» в настройках SpellGuard.
7. Важно API Gemini бесплатен до определённых лимитов (60 запросов в минуту для бесплатного тарифа).

2. Sber GigaChat (разработчикам)

1. Откройте Sber Developers Studio.
2. Авторизуйтесь (потребуется аккаунт Сбер ID).
3. Создайте новое рабочее пространство (workspace) или выберите существующее.
4. В разделе «API-ключи» (или «Доступы») создайте пару Client ID и Client Secret для метода GIGACHAT_API_PERS (персональный доступ).
5. Скопируйте оба значения (Client ID — это строка, Client Secret — пароль).
6. Вставьте их в соответствующие поля в настройках SpellGuard.
7. Выберите модель: GigaChat или GigaChat-2 (рекомендуется вторая).
8. Обратите внимание GigaChat использует OAuth 2.0 с короткоживущими токенами (обновляются автоматически). Убедитесь, что у вас активный доступ к API.

3. DeepSeek AI (платформа)

1. Перейдите на DeepSeek Platform → API Keys.
2. Зарегистрируйтесь или войдите в существующий аккаунт.
3. На странице API Keys нажмите «Create new key».
4. Дайте ключу имя (например, NVDA) и скопируйте его сразу после создания (он показывается только один раз).
5. Пополните баланс (DeepSeek работает по модели «pay-as-you-go», но иногда предоставляет стартовый кредит).
6. Вставьте ключ в поле «DeepSeek API key» в настройках дополнения.
7. Совет Убедитесь, что у вас достаточно средств на счету, иначе запросы будут отклоняться с ошибкой «insufficient balance».

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

🧠 Управление системными промптами

Системный промпт — это инструкция, которую вы даёте AI перед отправкой текста. В SpellGuard можно хранить несколько промптов и переключаться между ними.

Диалог управления промптами (NVDA+Shift+P)

• Список промптов — отображаются все сохранённые промпты. Активный помечен как «[Selected]».
• Добавление — нажмите Применить в контекстном меню (правая кнопка мыши) или выберите пункт «Добавить». Укажите название и текст промпта.
• Редактирование — выделите промпт (кроме защищённого по умолчанию) и нажмите F2 или выберите «Изменить» в контекстном меню.
• Удаление — выделите пользовательский промпт и нажмите Delete или выберите «Удалить» в контекстном меню. Промпт по умолчанию защищён от удаления.
• Сохранение в файл — нажмите Ctrl+S или выберите «Сохранить как .txt» в контекстном меню. Промпт сохранится в текстовый файл с именем, соответствующим его названию.
• Активация промпта — дважды щёлкните по элементу или нажмите Enter, либо кнопку «ОК». Активный промпт будет использоваться при всех последующих проверках.

Промпт по умолчанию имеет фиксированное название и текст, его нельзя изменить или удалить, но вы можете создавать свои варианты поверх него.

😊 Работа с эмодзи

В настройках дополнения есть раздел «Emoji settings». Если включить чекбокс «Добавить эмодзи», AI будет добавлять смайлики в текст согласно выбранному режиму:

• В конце текста — 1–2 подходящих эмодзи добавляются в самый конец всего текста.
• После предложений — по одному эмодзи после каждого предложения (перед точкой или после неё).
• После абзацев — эмодзи добавляются в конце каждого абзаца перед переносом строки.
• Умная расстановка — AI самостоятельно решает, где уместны эмодзи (после ключевых слов или знаков препинания).

Эмодзи добавляются поверх основного системного промпта, поэтому они учитываются при генерации ответа.

⌨️ Доступные жесты (горячие клавиши)

В дополнении зарегистрированы следующие команды. Вы можете переназначить их в диалоге «Жесты ввода» NVDA (меню NVDA → Параметры → Жесты ввода, раздел «SpellGuard»).

Примечание: Вы можете назначить дополнительные жесты для этих же функций через меню жестов ввода NVDA.

🛠️ Окно настроек NVDA

Дополнение интегрируется в стандартный диалог настроек NVDA (меню NVDA → Параметры → Настройки → категория «SpellGuard»). Здесь вы можете:

• Выбрать активного провайдера (Gemini, GigaChat, DeepSeek).
• Ввести API-ключи / учётные данные для выбранного сервиса (поля отображаются динамически).
• Настроить параметры эмодзи (включить/выключить и выбрать режим).
• Увидеть текущий активный промпт и при необходимости сменить его через выпадающий список (это дублирует функционал диалога списка промптов).
• Кнопки быстрого перехода — «Получить ключ Gemini (AI Studio)», «Получить учётные данные GigaChat (Sber API)», «Получить DeepSeek ключ (Platform)» — открывают соответствующие страницы в браузере.

Все изменения сохраняются автоматически при нажатии «ОК» в окне настроек NVDA.

🧪 Примеры использования

1. Быстрое исправление — выделите предложение с ошибками (например, в Word, блокноте или браузере), нажмите NVDA+Shift+C. Через несколько секунд исправленный текст окажется в буфере обмена. Вставьте его (Ctrl+V) в нужное место.
2. Смена провайдера — если один сервис недоступен или вы хотите сравнить качество, нажмите NVDA+Shift+T — NVDA озвучит нового провайдера.
3. Настройка промпта под задачу — например, вы хотите, чтобы AI не только исправлял ошибки, но и делал текст более формальным. Создайте новый промпт с соответствующей инструкцией и активируйте его.
4. Добавление эмодзи в посты — включите эмодзи в режиме «После предложений» — и каждый абзац вашего текста для соцсетей получит живые смайлики.
5. Проверка соединения — перед важной работой нажмите NVDA+Shift+K, чтобы убедиться, что API-ключи активны и баланс не исчерпан.

⚠️ Устранение неполадок

• «API key is not set» — проверьте, что вы ввели ключ в настройках для выбранного провайдера.
• «Authorization error» — неверный ключ или истёк срок действия. Получите новый ключ или проверьте правильность ввода.
• «Insufficient account balance» — для GigaChat или DeepSeek недостаточно средств на аккаунте разработчика. Пополните баланс.
• «Request limit exceeded» — превышен лимит запросов (особенно актуально для бесплатного Gemini). Подождите некоторое время или переключитесь на другого провайдера.
• «Server timeout» — медленное соединение или перегрузка сервера. Попробуйте позже или уменьшите длину текста.
• «No text selected» — перед вызовом проверки убедитесь, что выделен именно текстовый фрагмент, а не, например, изображение или пустое поле.
• «The selected text is too long» — максимальная длина текста ограничена 5000 символами (для предотвращения превышения лимитов API). Разбейте текст на части.

Если проблема не решается, проверьте логи NVDA (меню NVDA → Справка → Просмотреть журнал). Там могут быть дополнительные сообщения об ошибках.

© 2025–2026 Zloi LTD — все права защищены. Дополнение распространяется свободно, но автор не несёт ответственности за использование API-ключей и возможные финансовые затраты.

Версия дополнения: актуальная (см. в менеджере дополнений NVDA). Последнее обновление справки: июль 2026.