﻿Ultimate Shift Controller
Руководство пользователя
Version 3.0.9

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 1. Тип распространения и требования
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Бесплатная программа. Требуются 64-разрядная Windows 10/11, .NET 8 Desktop Runtime (x64), клавиатура и мышь. Поведение может зависеть от устройства, приложения или игры. Виртуальный контроллер может потребовать дополнительные драйверы.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 2. Установка
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Установщика нет. Распакуйте ZIP в папку с правом записи, запустите UltimateShiftController.exe, настройте назначения и нажмите [Сохранить]. Не запускайте программу прямо из ZIP.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 3. Удаление
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Отключите автозапуск, закройте USC включая трей и удалите папку. Для удаления настроек удалите [Settings]. Отдельно установленные драйверы удаляются отдельно.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 4. О программе
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Ultimate Shift Controller объединяет клавиатуру и мышь: переназначает клавиши, запускает сочетания с кнопок мыши и меняет назначения при удержании триггера слоя. Подходит для игр, письма, редактирования, стриминга и других приложений. Базовые функции не требуют виртуального контроллера.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 5. Основные возможности
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Переназначение клавиатуры/мыши, сочетания с модификаторами, несколько выходов, F1-F24, слои NORMAL/HYPER/ULTRA/ULTIMATE, Turbo, вкладки, профили, импорт/экспорт, HUD, трей, левая/правая кнопка мыши как вход в верхних слоях и локальный перевод через Chrome.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 6. Базовая настройка
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Запустите программу, выберите слой, зарегистрируйте вход в верхнем поле и выход в нижнем, нажмите [Сохранить] и проверьте. Пример: Q -> CTRL+1.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 7. Четыре слоя
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NORMAL — обычный слой. HYPER и ULTRA действуют, пока удерживаются их триггеры. ULTIMATE действует при удержании обоих. Верхние кнопки выбирают слой для редактирования, триггеры — активный слой.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 8. HYPER / ULTRA / ULTIMATE и внешние мыши
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Логические триггеры HYPER и ULTRA ограничены клавишами F13-F24 и должны различаться.

Пример: HYPER=F13, ULTRA=F14. Физическая кнопка должна отправлять ту же F-клавишу, что настроена в USC.

Выход назначения USC F13-F24 без Turbo также может использоваться как внутренний триггер. Левую и правую кнопки мыши можно назначать как вход в HYPER/ULTRA/ULTIMATE; во входе NORMAL и во всех полях выхода они остаются заблокированными. Выход без Turbo удерживается до отпускания исходного входа.

[Razer Synapse 2]
Synapse 2 сохраняет F13-F24, но не показывает имя. Для F13: во временной настройке NORMAL заставьте физическую F1 отправлять F13; откройте регистрацию кнопки в Synapse 2; нажмите F1; сохраните без отображаемого имени; затем верните F1 в USC и установите HYPER=F13.

[Razer Synapse 3]
Если F13-F24 доступны напрямую, назначьте F13/F14 кнопке и используйте ту же клавишу в USC.

[Logicool/Logitech G-Shift и G HUB]
G HUB позволяет выбирать F1-F24. Назначьте F13/F14 обычной или G-Shift кнопке и используйте тот же ключ в USC.

[Другие устройства]
Подходит любое ПО, которое может сохранить F13-F24. Даже если имя не отображается, всё работает, если клавиша сохраняется и отправляется. По возможности используйте F13-F24.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 9. Вкладки, профили и сохранение
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Вкладки организуют назначения. Профили сохраняют всю конфигурацию. Всегда нажимайте [Сохранить]. Данные находятся в [Settings].

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 10. Turbo, HUD и состояние
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Turbo повторяет выход. US HUD показывает слой. CLEAN пытается снять зависшие состояния. Keyboard Lock временно блокирует клавиатуру и отключается мышью.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 11. Важные настройки
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Kill назначенных входов] не даёт оригинальному входу и выходу работать одновременно. Блокировка неназначенных входов запрещает их прохождение в HYPER/ULTRA/ULTIMATE. Есть настройки трея и автозапуска.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 12. Виртуальный контроллер
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Продвинутая функция, которая может потребовать драйверы, разделение физического/виртуального контроллера и настройки игры. Ошибка может вызвать двойной ввод. Иллюстрированная инструкция:
https://github.com/Lu-ci-el/UltimateShiftController/blob/main/Instructions_en.md

Для клавиатуры, мыши, слоёв и сочетаний не нужна.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 13. Устранение проблем
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Сохраняйте изменения, проверяйте триггеры, Kill при двойном вводе, снимайте Keyboard Lock мышью, используйте CLEAN при зависших состояниях и избегайте Program Files, если запись не работает.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 14. Контакт и ошибки
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

https://github.com/Lu-ci-el/UltimateShiftController/issues

Укажите проблему, шаги, частоту, окружение и логи. Индивидуальный ответ, немедленное исправление и поддержка всех сред не гарантируются. Запросы на злоупотребление и индивидуальную разработку не принимаются.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 15. Примечания
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Делайте резервную копию [Settings], закрывайте USC перед обновлением, проверяйте конфликты и правила игр/сервисов. Не используйте программу для читов, помех или преследования. Автор не отвечает за ущерб от использования.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ USC_TRANSLATION_3_0_4 / Перевод
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- Для перевода требуется 64-разрядный Google Chrome и поддерживаемые локальные модели. Microsoft Edge не используется как резервный вариант.
- Включите перевод и откройте его настройки. Клавиша перевода — логическая F13-F24; она не может совпадать с триггером HYPER или ULTRA.
- Щёлкните левой кнопкой по полю клавиши запуска для записи, правой — для очистки. Можно использовать физическое сочетание клавиатуры/мыши/контроллера либо выход назначения USC без Turbo из текущего слоя. Физические и внутренние части не смешиваются.
- Выделенный иностранный текст переводится на язык, выбранный сейчас в USC. Текст на своём языке переводится на последний успешно использованный язык собеседника либо на цель по умолчанию.
- Результат показывается в простом окне. Для получения выделенного текста USC ровно один раз отправляет Ctrl+C приложению на переднем плане отдельными событиями скан-кода в порядке Left Ctrl DOWN → C DOWN → C UP → Left Ctrl UP, ненадолго удерживая Ctrl перед нажатием C. USC никогда не отправляет C первым и не повторяет C после неудачного копирования. Переводится только подтверждённое обновление буфера обмена; в противном случае перевод не выполняется, а простое окно сообщает, что выделение получить не удалось. Захват экрана и OCR не используются.
- 14 встроенных языков можно подготовить одной операцией. Другие языки готовятся отдельно по тегу BCP-47, если Chrome их поддерживает.
- Открытие настроек, обновление или выбор строки не запускает загрузку. Это делает только явная кнопка DL или пакетная загрузка.
- Явная загрузка открывает в обычном Chrome кратковременную локальную страницу, защищённую токеном. Она работает и при уже запущенном Chrome и начинается только после щелчка в Chrome. Внешние сайты не открываются; модели принадлежат Chrome.
- Обычный перевод использует скрытый одноразовый помощник через стандартный ввод/вывод и не открывает страницу, вкладку, окно Chrome или listener localhost. Недостающие модели автоматически не загружаются.
- USC хранит только настройки и небольшие доказательства в [Settings\Translation]. Профили, TranslateKit, пакеты, модели, компоненты, runtime и кэш Chrome не копируются в USC.
- Markdown, URL, код, цитаты, абзацы и переводы строк защищаются вне модели, делятся с конечными ограничениями и собираются обратно. Для постоянного сохранения нажмите [Сохранить] в главном окне.
