Посібник ExoKey

Початок роботи

• Завантажте останню версію з GitHub, розпакуйте й перенесіть ExoKey.app у «Програми».
• Перший запуск: якщо macOS пише «Not Opened», натисніть Done, відкрийте Системні параметри → Приватність і безпека й натисніть Усе одно відкрити.
• Надайте два дозволи: Доступність і Моніторинг введення. Без них ExoKey не бачить клавіш і не може переписати слово. Пункт меню Надати дозволи… відкриває потрібні сторінки.
• За бажанням: Запис екрана дає підказкам ШІ читати програми, які не віддають свій текст (деякі месенджери). 0.2
• Значок ExoKey — у рядку меню. Звідти можна призупинити програму, відкрити Словник, Налаштування, статистику й дії, описані нижче.

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

Набрали ghbdsn замість «привіт» або руддщ замість «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