Руководство ExoKey

Начало работы

• Скачайте последнюю версию с GitHub, распакуйте и перенесите ExoKey.app в «Программы».
• Первый запуск: если macOS пишет «Not Opened», нажмите Done, откройте Системные настройки → Конфиденциальность и безопасность и нажмите Всё равно открыть.
• Дайте два разрешения: Универсальный доступ и Мониторинг ввода. Без них ExoKey не видит клавиш и не может переписать слово. Пункт меню Выдать разрешения… открывает нужные страницы.
• По желанию: Запись экрана позволяет подсказкам ИИ читать программы, которые не отдают свой текст (некоторые мессенджеры). 0.2
• Значок ExoKey — в строке меню. Оттуда можно приостановить программу, открыть Словарь, Настройки, статистику и действия, описанные ниже.

Автоматическое исправление раскладки

Набрали ghbdtn вместо «привет» или руддщ вместо «hello»? ExoKey сравнивает набранное с тем, что те же клавиши дают в других раскладках, выбирает язык, где это настоящее слово, переписывает его и переключает раскладку.

• Решение принимается во время набора, по умолчанию с третьей буквы (Настройки → Начинать анализ после букв), или в конце слова.
• Короткие слова (2 буквы) исправляются, только если вариант — очень частое слово или предыдущее слово на этом языке.
• Работает с любыми установленными раскладками английского, украинского и русского (ABC, U.S., Украинская, Русская — ПК и другие). Языки выбираются в Настройках.
• Никогда не трогаются: пароли и PIN, адреса почты и ссылки, слова с цифрами, CamelCase вроде iPhone, знаки вроде ....; по желанию — слова ЗАГЛАВНЫМИ буквами.
• Если вы сами переключили раскладку посреди слова, ExoKey это слово не трогает. Если раскладка сменилась случайно и одно слово вышло двумя алфавитами, ExoKey вернёт остаток. 0.2
• Если вы стёрли исправленное слово и набрали снова, ExoKey не исправляет его второй раз до следующего пробела.

Отмена и ручное преобразование

• ⌃⌥Z — отменить последнее исправление. ⌘Z сразу после автоматического исправления тоже его отменяет. 0.2
• Стереть исправленное слово Backspace — тоже отмена (можно выключить).
• ⌃⌥X — перевести последнее слово в другую раскладку; повторное нажатие перебирает языки. Если выделен текст — переводит выделенное. 0.2
• Отменили одно и то же слово дважды — оно становится исключением и больше не исправляется.

Опечатки

Пропущенная, лишняя или переставленная буква: после пробела под словом появляется подсказка с исправлением. Tab применяет, Esc скрывает, дальнейший набор — игнорирует.

• Режимы в Настройках: выключено, предлагать (по умолчанию) или исправлять автоматически.
• ⌃⌥C — исправить опечатку в последнем слове прямо сейчас.
• Вернитесь к слову с опечаткой мышью или стрелками — ExoKey предложит исправление и там. 0.2
• Слова из Словаря и имена никогда не считаются опечатками.

Подсказки ИИ

Локальная языковая модель (Alibaba Qwen, работает через llama.cpp на вашем Mac) предлагает окончание слова и следующие слова серым текстом у курсора. Ничего не отправляется в интернет.

• Включите в Настройках → Автодополнение (ИИ) и один раз скачайте модель (2,5 ГБ). Без модели доступен облегчённый словарный режим.
• Tab — принять следующее слово; ⇧Tab — всю подсказку; Esc — скрыть; ⌃⌥⌫ — отменить последнюю вставку; ⌃⌥A — включить или выключить автодополнение.
• Контекст: ExoKey читает переписку или страницу в активном окне (через Универсальный доступ или распознавание текста на экране для программ без доступного текста 0.2), чтобы подсказки подходили к разговору. Только в памяти.
• Ваш стиль: ExoKey запоминает частые фразы и принятые подсказки и предлагает их первыми. Всё можно забыть одной кнопкой.
• Настройки: только слова или слова и фразы, длина подсказки, уверенность, задержка перед показом, языки, программы без подсказок.
• Меню → Без ИИ-подсказок в этой программе выключает подсказки для текущей программы в один клик. 0.2

Имена с заглавной

Имена, города и названия пишутся правильно в подсказках и после пробела: марина → Марина, киев → Киев. Выключается в Настройках.

Калькулятор в любом поле

Наберите пример и =, и ExoKey допишет ответ. Работает в любой программе.

• Действия + - * / × ÷ ^ %, скобки, десятичная точка или запятая.
• Цепочки: пишите дальше после результата — 600*2=1200+200= посчитает новое выражение. 0.2
• Функции sin cos tan asin acos atan sqrt ln log exp abs round floor ceil, константы pi и e. 0.2
• Время: 10:00+2:30= → 12:30, 18:45-9:30= → 9:15, 1:30*3= → 4:30. 0.2

Единицы и валюты 0.2

• Длина, вес, объём, площадь, скорость и температура — по-английски, по-украински или по-русски: in, to, в, у, / или →.
• Валюты USD, EUR, UAH, GBP, PLN, CAD, CNY, JPY, CHF, TRY, CZK, KZT, GEL, AED — кодом, символом или названием. Скачивается только таблица курсов, не чаще раза в 12 часов.
• Нужно больше? ExoCalc — полноценный калькулятор-блокнот, смотрите ниже.

Контакты: @Имя 0.2

Наберите @ и первые буквы имени — появится список контактов. Выберите ↑↓ и Return (или кликом), отметьте нужные поля — имя, телефон, почта, компания, адрес — и они вставятся через запятую. Телефон — в международном формате.

• Включите в Настройках → Дополнительно; macOS один раз попросит доступ к Контактам.
• @ внутри адреса почты список не открывает.

Смена регистра 0.2

Выделите текст и нажмите ⌃⌥R: строчные → ЗАГЛАВНЫЕ → С заглавной, каждое нажатие — следующий вариант. Удобно, если набрали с включённым Caps Lock.

Язык для программ и исключения

• Настройки → Раскладка для программ: Терминал всегда на английском, Telegram — на украинском, раскладка переключается вместе с окном. Только этот язык ещё и выключает там исправления.
• Пункт меню Раскладка для «Программа» задаёт её для текущей программы.
• Настройки → Не работать в программах: ExoKey полностью игнорирует эти программы. Меню → Не работать в этой программе добавляет текущую в один клик. 0.2

Ярлык раскладки у курсора

Небольшой цветной ярлык (EN UK RU) появляется у курсора, когда меняется раскладка, и когда вы ставите курсор мышью или стрелками 0.2 — видно, на каком языке сейчас будете писать.

Обучение и Словарь

• Новые слова, имена и сокращения ExoKey запоминает: сразу, после повторного ввода (по умолчанию) или после подтверждения. Имена и сокращения ЗАГЛАВНЫМИ — быстрее.
• Слова, получившиеся из автоматического исправления, никогда не запоминаются.
• Меню → Словарь…: слова, исключения (никогда не исправлять), правила (всегда заменять это на то), кандидаты на подтверждение, ваши фразы и запрещённые подсказки. Поиск, добавление, изменение, удаление.
• Настройки → Данные: экспорт и импорт, резервная копия и восстановление, сброс обучения, удаление всех данных.

Обновления 0.2

Раз в день ExoKey проверяет на GitHub, есть ли новая версия. Если есть, в меню появляется Установить обновление: ExoKey скачивает её, проверяет контрольную сумму SHA-256, заменяет себя и перезапускается. Можно проверить вручную или выключить проверку в Настройках.

Приватность

• Словари, проверка правописания и модель ИИ работают без интернета. Сеть нужна только для загрузки модели, курсов валют и проверки обновлений.
• Набранный текст и текст окон обрабатываются в памяти и не сохраняются. Сохраняются только ваш Словарь, фразы и статистика — в ~/Library/Application Support/ExoKey.
• Защищённые поля и поля с подписью «пароль», PIN или код полностью пропускаются.
• Код открыт: github.com/jandiradmin/ExoKey, лицензия MIT.

Все горячие клавиши

Каждую можно изменить в Настройках → Горячие клавиши.

Если что-то не так

• Ничего не происходит. Проверьте, что ExoKey включён и в Универсальном доступе, и в Мониторинге ввода, и что он не приостановлен (меню). После обновления выключите и снова включите разрешения.
• Слово постоянно исправляется неправильно. Отмените дважды ⌃⌥Z или добавьте его в исключения в Словаре.
• Нет подсказок ИИ в программе. Некоторые программы не сообщают позицию курсора; включите ExoKey в «Запись экрана» или проверьте, что программа не в исключениях.
• Почему не в App Store? Песочница App Store не позволяет программам видеть нажатия клавиш.
• Это бесплатно? Да. Если ExoKey экономит вам время, можно поддержать проект или поставить звезду на GitHub.

Другие программы семейства Exo