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

DeepSeek Spell Checker для NVDA

Мощный плагин для проверки орфографии с использованием искусственного интеллекта

Оглавление

• Общее описание
• Установка и настройка
• Получение API ключа
• Жесты ввода
• Использование
• Настройки плагина
• Устранение неполадок
• Графический интерфейс для подсказок

Общее описание

DeepSeek Spell Checker для NVDA предоставляет мощные возможности проверки орфографии, грамматики и пунктуации с использованием современных AI-моделей от DeepSeek.

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

• ✅ Проверка орфографии — Автоматическое исправление орфографических, грамматических ошибок и пунктуации в выделенном тексте
• 🎯 Высокая точность — Улучшенный системный prompt для максимальной точности проверки на всех языках
• 🤖 DeepSeek AI — Использование передовых моделей DeepSeek для обработки текста
• 📋 Автокопирование — Результат автоматически копируется в буфер обмена
• 😊 Добавление смайлов — Возможность автоматически вставлять смайлы в текст
• ⚙️ Гибкая настройка промптов — Создание и управление собственными системными промптами

Установка и настройка

Требования:

• NVDA 2023.1 или новее
• Активное интернет-соединение
• API ключ DeepSeek

Настройка плагина:

1. Откройте меню NVDA → Настройки → DeepSeek Spell Checker
2. Введите API ключ DeepSeek
3. Настройте жесты ввода через меню NVDA → Настройки → Жесты ввода

💡 Совет: Получите бесплатный API ключ на платформе DeepSeek для начала работы.

Получение API ключа

DeepSeek API

1. Перейдите на DeepSeek Platform
2. Зарегистрируйте аккаунт или войдите
3. Перейдите в раздел API Keys
4. Нажмите "Create API Key"
5. Дайте ключу название и скопируйте его
6. Вставьте ключ в настройках плагина

⚠️ Важно: Никому не передавайте свои API ключи. Храните их в безопасности!

Жесты ввода

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

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

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

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

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

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

Настройки плагина

Основные настройки:

• DeepSeek API ключ — Ввод ключа доступа

Модель по умолчанию:

Плагин использует модель deepseek-chat — универсальную модель для большинства задач проверки орфографии.

Дополнительные функции

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

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

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

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

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

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

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

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

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

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

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

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

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

❌ "Неверный API ключ"

• Проверьте правильность введенного ключа
• Убедитесь, что ключ активен
• Проверьте лимиты использования API

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

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

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

Решение: Перезагрузите роутер, проверьте подключение к api.deepseek.com

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

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

Решение: Дождитесь обновления квоты

❌ "Модель не найдена"

• Модель временно недоступна
• Неправильное название модели

Решение: Используйте модель по умолчанию deepseek-chat

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

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

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

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

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

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

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

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

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

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

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

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

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

Поддержка: Для вопросов и предложений обращайтесь к разработчику плагина.