From 5698c19c1e9eefe90bc3abe95072d51fc3527d3d Mon Sep 17 00:00:00 2001 From: Kostenkov-2021 <81031453+Kostenkov-2021@users.noreply.github.com> Date: Sat, 9 Mar 2024 22:28:06 +0300 Subject: [PATCH] Russian translation: Documentation and some localization fixes (#70) --- addon/doc/ru/readme.md | 92 +++++++++++++++++++++++++++++ addon/locale/ru/LC_MESSAGES/nvda.po | 29 ++++----- 2 files changed, 107 insertions(+), 14 deletions(-) create mode 100644 addon/doc/ru/readme.md diff --git a/addon/doc/ru/readme.md b/addon/doc/ru/readme.md new file mode 100644 index 0000000..ea4e6f1 --- /dev/null +++ b/addon/doc/ru/readme.md @@ -0,0 +1,92 @@ +# Дополнение NVDA Open AI + +Это дополнение предназначено для плавной интеграции возможностей Open AI API в ваш рабочий процесс. Если вам нужно составить исчерпывающий текст, точно перевести отрывки, кратко изложить суть документов или даже интерпретировать и описать визуальный контент, это дополнение с лёгкостью справится со всеми задачами. + +## Шаги установки + +1. Перейдите на страницу [releases page](https://github.com/aaclause/nvda-OpenAI/releases), чтобы найти последнюю версию дополнения. +2. Загрузите последнюю версию по указанной ссылке. +3. Запустите программу установки, чтобы добавить дополнение в среду NVDA. + +## Необходимые условия использования + +Чтобы полностью раскрыть возможности дополнения NVDA OpenAI, вы должны получить API-ключ от OpenAI. Вот как настроить его для использования: + +1. Получите API-ключ, зарегистрировав учётную запись OpenAI на сайте [https://platform.openai.com/api-keys](https://platform.openai.com/api-keys). +2. Когда API-ключ готов, у вас есть два варианта его настройки: + - Через диалог настроек NVDA: + 1. Войдите в меню NVDA и перейдите в подменю "Параметры". + 2. Откройте диалог "Настройки" и выберите категорию "Open AI". + 3. Введите свой ключ API в соответствующее поле и нажмите "OK" для подтверждения. + - Использование переменных окружения: + 1. Нажмите `Windows+Pause`, чтобы открыть "Свойства системы". + 2. Нажмите на "Дополнительные параметры системы" и выберите "Переменные среды". + 3. Создайте новую переменную в разделе "Пользовательские переменные": + 1. Нажмите "Создать". + 2. Введите `OPENAI_API_KEY` в качестве имени переменной и вставьте свой ключ API в качестве значения. + 4. Нажмите "OK", чтобы сохранить изменения. + +Теперь вы готовы к изучению возможностей дополнения NVDA OpenAI! + +## Как пользоваться дополнением + +### Главный диалог + +Большинство функций дополнения легко доступны через диалоговое окно, которое запускается нажатием `NVDA+G`. +В качестве альтернативы перейдите в подменю "Open AI" в меню NVDA и выберите пункт "Главный диалог...". +В этом диалоге вы сможете: + +- Инициировать интерактивные разговоры с моделями ИИ для получения помощи или информации. +- Получать описания изображений из графических файлов. +- Расшифровывать устную речь из аудиофайлов или через микрофон. +- Использовать функцию преобразования текста в речь для озвучивания написанного в подсказке текста. + +#### Повышение производительности с помощью быстрых клавиш. + +Чтобы ещё больше улучшить взаимодействие с интерфейсом, обратите внимание на следующее: + +- Многострочные поля "Система", "История" и "Подсказка" оснащены контекстными меню, содержащими команды, которые можно быстро выполнить с помощью сочетаний клавиш. + Эти сочетания клавиш активны, когда соответствующее поле находится в фокусе. + Например, клавиши "j" и "k" позволяют переходить к предыдущему и следующему сообщениям соответственно, когда фокус находится в поле "История". + +- Кроме того, в интерфейсе предусмотрены сочетания клавиш, которые действуют во всём окне. Например, `CTRL + R` запускает или останавливает запись. +Все сочетания клавиш отображаются рядом с названиями соответствующих элементов. + +#### О флажке "Режим разговора + +Флажок "Режим разговора" предназначен для улучшения работы с чатом и экономии токенов ввода (далее - токенов). + +Если флажок установлен (настройка по умолчанию) дополнение передает всю историю разговора модели искусственного интеллекта, тем самым улучшая её контекстное понимание и приводя к более последовательным ответам. Однако такой всеобъемлющий режим приводит к увеличению расхода токенов. + +И наоборот, если флажок не установлен, в модель ИИ отправляется только текущая подсказка пользователя. Выберите этот режим, чтобы задать конкретные вопросы или получить дискретные ответы, минуя необходимость контекстного понимания и экономя входные лексемы, когда история диалога не нужна. + +Вы можете переключаться между этими двумя режимами в любое время во время сеанса. + +#### О поле `Система` + +Поле `Система` предназначено для тонкой настройки поведения и личности модели ИИ в соответствии с вашими конкретными ожиданиями. + +- **Подсказка по умолчанию**: При установке дополнение включает в себя системную подсказку, готовую к использованию. +- **Настройка**: У вас есть возможность персонализировать системную подсказку, изменяя текст непосредственно в поле. Дополнение запомнит последнюю использованную вами системную подсказку и автоматически загрузит её при следующем запуске диалога. Это поведение можно отключить в настройках. +- **Возможность сброса**: Хотите вернуться к стандартной конфигурации? Просто воспользуйтесь контекстным меню, чтобы без труда вернуть поле `System` к значению по умолчанию. + +Пожалуйста, помните, что системный запрос включён во входные данные модели ИИ и потребляет токены соответствующим образом. + +### Глобальные команды + +Эти команды могут быть использованы для запуска действий из любой точки компьютера. Их можно переназначить из диалога *Жесты ввода* в категории *Open AI*. + +- `NVDA+e`: Сделать снимок экрана и описать его. +- `NVDA+o`: Захватить текущий объект навигатора и описать его. +- Команды, не назначенные по умолчанию ни на один жест: + - Переключить запись с микрофона и расшифровать аудиозапись из любого места. + +## Включённые зависимости + +Дополнение поставляется со следующими необходимыми зависимостями: + +- [openai](https://pypi.org/project/openai/): Официальная библиотека Python для API openai. +- [markdown2](https://pypi.org/project/markdown2/): Быстрая и полная реализация Markdown на Python. +- [MSS](https://pypi.org/project/mss/): Сверхбыстрый кроссплатформенный модуль множественных скриншотов на чистом python с использованием ctypes. +- [Pillow](https://pypi.org/project/Pillow/): Удобный форк библиотеки Python Imaging Library, используемой для изменения размеров изображений. +- [sounddevice](https://pypi.org/project/sounddevice/): Воспроизведение и запись звука с помощью Python. diff --git a/addon/locale/ru/LC_MESSAGES/nvda.po b/addon/locale/ru/LC_MESSAGES/nvda.po index abe2ba8..0aa028f 100644 --- a/addon/locale/ru/LC_MESSAGES/nvda.po +++ b/addon/locale/ru/LC_MESSAGES/nvda.po @@ -3,7 +3,7 @@ msgstr "" "Project-Id-Version: \n" "Report-Msgid-Bugs-To: nvda-translations@groups.io\n" "POT-Creation-Date: 2024-02-08 00:19+0100\n" -"PO-Revision-Date: 2024-03-09 13:53+0300\n" +"PO-Revision-Date: 2024-03-09 20:56+0300\n" "Last-Translator: Danil Kostenkov \n" "Language-Team: Danil Kostenkov\n" "Language: ru\n" @@ -54,7 +54,7 @@ msgstr "Заблокировать закрытие с помощью клави #: addon\globalPlugins\openai\__init__.py:175 msgid "Remember the content of the S&ystem field between sessions" -msgstr "Запоминать содержимое поля S&ystem между сеансами" +msgstr "Запоминать содержимое поля &Система между сеансами" #: addon\globalPlugins\openai\__init__.py:183 msgid "Enable &advanced settings (including temperature and probability mass)" @@ -134,11 +134,12 @@ msgstr "Воспроизводить звук при получении отве #. Translators: This is a setting to attach braille to the history if the focus is in the prompt field. #: addon\globalPlugins\openai\__init__.py:323 msgid "Attach braille to the history if the focus is in the prompt field" -msgstr "Прикрепить шрифт Брайля к истории, если фокус находится в поле запроса" +msgstr "" +"Прикрепить шрифт Брайля к истории, если фокус находится в поле подсказка" #: addon\globalPlugins\openai\__init__.py:329 msgid "Speak response when the focus is in the prompt field" -msgstr "Произносить ответ, когда фокус находится в поле запроса" +msgstr "Произносить ответ, когда фокус находится в поле подсказка" #. Translators: This is the name of a group of settings #: addon\globalPlugins\openai\__init__.py:339 @@ -452,7 +453,7 @@ msgstr "Режим &разговора" #: addon\globalPlugins\openai\maindialog.py:574 msgid "S&ystem:" -msgstr "S&ystem:" +msgstr "&Система:" #: addon\globalPlugins\openai\maindialog.py:591 msgid "&History:" @@ -460,7 +461,7 @@ msgstr "&История:" #: addon\globalPlugins\openai\maindialog.py:602 msgid "&Prompt:" -msgstr "&Запрос:" +msgstr "&Подсказка:" #. Translators: This is a label for a list of images attached to the prompt. #: addon\globalPlugins\openai\maindialog.py:614 @@ -534,7 +535,7 @@ msgstr "Описать изображение по пути к файлу или #: addon\globalPlugins\openai\maindialog.py:744 msgid "&Vocalize the prompt" -msgstr "&Произнести запрос" +msgstr "&Произнести подсказку" #: addon\globalPlugins\openai\maindialog.py:830 msgid "Describe the images in as much detail as possible." @@ -653,11 +654,11 @@ msgstr "Конец" #: addon\globalPlugins\openai\maindialog.py:1339 #, python-format msgid "Response copied to system: %s" -msgstr "Ответ скопирован в system: %s" +msgstr "Ответ скопирован в поле система: %s" #: addon\globalPlugins\openai\maindialog.py:1348 msgid "Copied to prompt" -msgstr "Скопировано в запрос" +msgstr "Скопировано в поле подсказка" #: addon\globalPlugins\openai\maindialog.py:1352 msgid "Copy" @@ -665,7 +666,7 @@ msgstr "Копировать" #: addon\globalPlugins\openai\maindialog.py:1360 msgid "Copy prompt" -msgstr "Копировать запрос" +msgstr "Копировать подсказку" #: addon\globalPlugins\openai\maindialog.py:1363 msgid "Copy response" @@ -713,11 +714,11 @@ msgstr "Копировать сообщения как форматирован #: addon\globalPlugins\openai\maindialog.py:1469 msgid "Copy response to system" -msgstr "Копировать ответ в system" +msgstr "Копировать ответ в поле система" #: addon\globalPlugins\openai\maindialog.py:1472 msgid "Copy prompt to prompt" -msgstr "Копировать запрос в поле запроса" +msgstr "Копировать подсказку в поле подсказка" #: addon\globalPlugins\openai\maindialog.py:1475 msgid "Delete block" @@ -741,7 +742,7 @@ msgstr "Перейти к следующему сообщению" #: addon\globalPlugins\openai\maindialog.py:1498 msgid "Insert previous prompt" -msgstr "Вставить предыдущий запрос" +msgstr "Вставить предыдущую подсказку" #: addon\globalPlugins\openai\maindialog.py:1508 msgid "Show model details" @@ -848,7 +849,7 @@ msgstr "" #: addon\globalPlugins\openai\maindialog.py:1872 msgid "Please enter some text in the prompt field first." -msgstr "Сначала введите текст в поле запроса." +msgstr "Сначала введите текст в поле подсказка." #: addon\globalPlugins\openai\model.py:41 msgid "preview: not yet suited for production traffic"