Gemini Spell Checker для NVDA

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

📋 Оглавление

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

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

Плагин Gemini Spell Checker для NVDA предоставляет мощные возможности проверки орфографии и перевода текста с использованием современных AI-моделей от Google Gemini и Groq.

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

✅ Проверка орфографии - Автоматическое исправление орфографических и грамматических ошибок в выделенном тексте

🌐 Перевод текста - Перевод на 50+ языков с сохранением форматирования и смысла

🔄 Два сервиса - Поддержка Google Gemini и Groq API с возможностью переключения

😊 Смайлики - Опциональное добавление релевантных эмодзи в результат

📋 Автокопирование - Результат автоматически копируется в буфер обмена

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

Требования:

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

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

1. Откройте меню NVDA → Настройки → Gemini Spell Checker
2. Выберите сервис (Google Gemini или Groq API)
3. Введите соответствующий API ключ
4. Настройте жесты ввода через меню NVDA → Настройки → Жесты ввода

💡 Совет: Начните с бесплатного сервиса Groq, так как он предоставляет более щедрые лимиты для начала работы.

🔑 Получение API ключей

Google Gemini API

1. Перейдите на Google AI Studio
2. Войдите в свой Google аккаунт
3. Нажмите "Create API Key"
4. Скопируйте сгенерированный ключ
5. Вставьте ключ в настройках плагина

Бесплатно: Gemini API бесплатен для ограниченного количества запросов.

Groq API

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

Бесплатно: Groq предоставляет бесплатные запросы с лимитами.

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

⌨️ Жесты ввода

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

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

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

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

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

Перевод текста:

1. Выделите текст для перевода
2. Нажмите жест для перевода
3. Выберите нужный язык через жесты переключения
4. Переведенный текст будет скопирован в буфер обмена

Переключение языков:

Используйте жесты "Следующий язык перевода" и "Предыдущий язык перевода" для циклического перебора всех доступных языков.

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

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

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

• Сервис для проверки - Выбор между Google Gemini и Groq API
• API ключи - Ввод соответствующих ключей доступа
• Модель - Выбор конкретной AI-модели
• Добавлять смайлики - Включение/выключение добавления эмодзи
• Язык перевода - Выбор целевого языка для переводов

Доступные модели:

Gemini модели:

• gemini-2.0-flash-exp
• gemini-2.0-flash
• gemini-2.5-flash-exp
• gemini-2.5-flash

Groq модели:

• llama-3.1-8b-instant
• llama-3.1-70b-versatile
• llama-3.2-1b-preview
• llama-3.2-3b-preview
• llama-3.3-70b-versatile
• mixtral-8x7b-32768
• gemma2-9b-it

💡 Рекомендация: Для начала используйте gemini-2.0-flash-exp или llama-3.1-8b-instant - они быстрые и надежные.

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

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

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

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

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

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

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

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

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

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

Решение: Дождитесь обновления квоты или переключитесь на другой сервис

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

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

Решение: Выберите другую модель в настройках или используйте резервную

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

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

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

🌍 Поддерживаемые языки

Плагин поддерживает перевод на 50 языков:

• English - Английский
• Russian - Русский
• Spanish - Испанский
• French - Французский
• German - Немецкий
• Italian - Итальянский
• Portuguese - Португальский
• Chinese - Китайский
• Japanese - Японский
• Korean - Корейский
• Arabic - Арабский
• Turkish - Турецкий
• Hindi - Хинди
• Bengali - Бенгальский
• Urdu - Урду
• Indonesian - Индонезийский
• Dutch - Нидерландский
• Polish - Польский
• Ukrainian - Украинский
• Greek - Греческий
• Hebrew - Иврит
• Thai - Тайский
• Vietnamese - Вьетнамский
• Persian - Персидский
• Malay - Малайский
• Romanian - Румынский
• Hungarian - Венгерский
• Czech - Чешский
• Swedish - Шведский
• Danish - Датский
• Finnish - Финский
• Norwegian - Норвежский
• Bulgarian - Болгарский
• Croatian - Хорватский
• Serbian - Сербский
• Slovak - Словацкий
• Slovenian - Словенский
• Lithuanian - Литовский
• Latvian - Латышский
• Estonian - Эстонский
• Maltese - Мальтийский
• Icelandic - Исландский
• Irish - Ирландский
• Welsh - Валлийский
• Basque - Баскский
• Catalan - Каталанский
• Galician - Галисийский

⚠️ Ограничения:

• Максимальная длина текста: 5000 символов
• Только выделенный текст: Не работает с текстом из буфера обмена
• Требуется активное интернет-соединение

💡 Примечание: Плагин использует внешние API сервисы. Ознакомьтесь с политикой конфиденциальности соответствующих сервисов.

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

• GeminiSpellChecker-V.1.3.nvda-addon
• GeminiSpellChecker-V.1.1.nvda-addon
• GeminiSpellChecker-V.1.0.nvda-addon