Исправил сохранение системных подсказок, пользовательских prompts.
Теперь все подсказки сохраняются в папку настроек NVDA в отдельный файл, тем самым убрал удаление этих подсказок при обновлении дополнения поверх существующего.
Вроде ошибок и косяков не осталось, дополнение работает полноценно.

GigaChatSpellChecker

Дополнение для NVDA для проверки орфографии выделенного текста через GigaChat API.

Быстрая настройка

1. Откройте NVDA → Настройки → GigaChatSpellChecker
2. Введите Client ID
3. Введите Client Secret
4. Выберите модель: GigaChat или GigaChat-2
5. Сохраните настройки

Получение Client ID и Client Secret для GigaChat API (для физических лиц)

Шаг 1. Перейдите в Sber Developer Studio

Sber Developer Studio — откройте студию и выполните вход с помощью Сбер ID.

Если у вас еще нет аккаунта, зарегистрируйтесь, следуя подсказкам на экране.

Шаг 2. Создайте рабочее пространство

После первого входа рабочее пространство обычно создается автоматически.

Если необходимо создать новое:

1. Нажмите «Новое пространство».
2. Укажите название пространства.
3. При необходимости выберите его тип.
4. Нажмите «Создать».

Шаг 3. Создайте проект GigaChat API

В рабочем пространстве нажмите «Создать проект».

В каталоге сервисов выберите:

ML → GigaChat API

Нажмите «Создать проект».

Шаг 4. Заполните сведения о проекте

В открывшемся окне:

1. Введите название проекта.
2. При необходимости заполните дополнительные параметры.
3. Нажмите «Создать проект».

После этого откроется страница созданного проекта.

Шаг 5. Перейдите к настройке API

На странице проекта найдите раздел «Доступ к API».

Нажмите кнопку «Получить доступ» или «Настроить API» (название кнопки может отличаться в зависимости от версии интерфейса Studio).

Откроется окно с настройками доступа к API.

Шаг 6. Получите новые учетные данные

В разделе настроек API нажмите кнопку:

«Получить новый ключ»

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

Подтвердите создание нового ключа.

Шаг 7. Просмотрите данные авторизации

После генерации ключа откроется окно с параметрами доступа.

При необходимости разверните раздел с данными авторизации.

В нем будут доступны:

• Authorization Key
• Client ID
• Client Secret

Шаг 8. Сохраните Client ID и Client Secret

Скопируйте значения:

• Client ID
• Client Secret

Сохраните их в надежном месте.

Эти данные понадобятся для получения Access Token и последующей работы с GigaChat API.

Шаг 9. Завершите настройку

После сохранения необходимых данных нажмите кнопку «Готово».

Проект готов к использованию.

Что вы получите

После выполнения всех шагов у вас будут:

• Authorization Key;
• Client ID;
• Client Secret.

Внимание! Важно: client_secret и client_id могут проработать 40 дней, после чего их нужно создавать заново в том же проекте, что и были до этого. При этом, если на счету есть баланс, он не сгорит.

Жесты ввода

Настройте жесты в меню NVDA → Настройки → Жесты ввода в категории "GigaChatSpellChecker" :

Совет: Назначайте жесты, которые не конфликтуют с другими плагинами и стандартными командами NVDA.

Настройки дополнения

В окне настроек GigaChatSpellChecker доступны дополнительные функции, расширяющие возможности проверки текста.

Добавление смайлов в текст

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

• В конце каждого предложения — смайл добавляется после каждой точки, вопросительного или восклицательного знака.
• В конце каждого абзаца — смайл ставится после завершения каждого логического блока текста.
• В любом месте текста — модель сама определяет оптимальные позиции для вставки смайлов.
• В конце текста — один смайл добавляется в самом конце всего текста.

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

Системный промпт

В настройках вы можете добавить собственный системный промпт. Это нужно для того, чтобы гибко регулировать поведение модели.

• Иногда модель не справляется с системной подсказкой по умолчанию — вы можете задать более строгое правило проверки.
• Или наоборот, прописать какой-нибудь интересный стиль обработки текста.
• Можно просто написать «отвечай на вопросы» и после этого, например, написать любой запрос в текстовом редакторе, отправить его на обработку и получить ответ на ваш запрос.

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

Для добавления, редактирования и удаления системной подсказки используется комбинированный список в настройках дополнения. На этом элементе управления работает контекстное меню (правая кнопка мыши или клавиша Applications), которое позволяет:

• Создать новый промпт
• Редактировать выбранный промпт
• Удалить ненужный промпт

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

Графический интерфейс для работы с пользовательскими подсказками

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

Назначение жеста

Чтобы открыть интерфейс, перейдите в меню NVDA → Настройки → Жесты ввода, найдите категорию "GigaChatSpellChecker" и назначьте удобный жест для команды открытия интерфейса управления подсказками.

Возможности интерфейса

• Добавление новой пользовательской подсказки.
• Редактирование существующей подсказки.
• Удаление ненужной подсказки.
• Применение подсказки — для этого просто нажмите Enter на нужной подсказке в списке.

Все действия (добавление, редактирование, удаление) доступны через контекстное меню (правая кнопка мыши или клавиша Applications) на элементе списка подсказок.

Для чего нужны пользовательские подсказки?

• Перевод текста — можно создать подсказку для перевода текста с одного языка на другой.
• Строгая проверка орфографии — задать более жесткие правила для проверки текста.
• Стилизация текста — создать персонажа или стиль, в котором будет переписан ваш текст (например, официальный, ироничный, поэтичный и т.д.).
• Любые другие задачи — вы можете адаптировать поведение модели под свои нужды, просто описав желаемый результат в промпте.

Совет: Экспериментируйте с разными промптами, чтобы найти идеальный вариант для каждой конкретной задачи.

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

Проверка орфографии:

1. Выделите текст в любом приложении.
2. Нажмите назначенный жест для проверки орфографии.
3. Дождитесь обработки (обычно 2–10 секунд).
4. Исправленный текст будет скопирован в буфер обмена.
5. NVDA озвучит превью результата.

Ограничение: Максимальная длина текста — 5000 символов. Работает только с выделенным текстом.

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

Частые проблемы и решения:

❌ "Неверные учетные данные"

• Проверьте правильность введенных Client ID и Client Secret.
• Убедитесь, что ключи активны (срок действия — 40 дней).

Решение: Перегенерируйте ключи в Sber Developer Studio и обновите в настройках.

❌ "Таймаут подключения"

• Проверьте интернет-соединение.
• Попробуйте позже.
• Проверьте настройки firewall.

Решение: Перезагрузите роутер, проверьте доступ к API GigaChat.

❌ "Превышен лимит запросов"

• Слишком много запросов за короткое время.
• Исчерпана дневная квота.

Решение: Дождитесь обновления квоты или увеличьте лимиты в личном кабинете.

Логирование:

Для детальной диагностики включите ведение логов NVDA и проверьте журнал (NVDA+F1) после возникновения ошибки.

Профилактика: Регулярно обновляйте плагин для получения исправлений и новых функций.

Автор: BY Zloi LTD