Усунення неполадок

Що означає кожне повідомлення Keebye і як це виправити, а також як скинути застосунок.

Майже всі проблеми зводяться до дозволу, відсутньої моделі або приостановленого диктування. Почніть із швидких перевірок, потім знайдіть своє повідомлення нижче.

Гаряча клавіша не працює? Перевірте спочатку це

У меню трея позначено пункт "Enable Dictation".
Ви увійшли в обліковий запис і пробний період не закінчився (Settings › Account).
Доступність надано в Системних налаштуваннях › Конфіденційність і безпека › Доступність.
Захищене введення не активне — наприклад, Secure Keyboard Entry у Terminal або встановлений курсор у полі пароля.

Повідомлення і що вони означають

"Accessibility permission was revoked — reopen System Settings"

Коли розпочався запис, дозволу Доступності не було. Відкрийте Системні налаштування › Конфіденційність і безпека › Доступність і увімкніть Keebye. Keebye заново активує гарячу клавішу протягом 2 секунд.

"Failed to start the global hotkey listener"

macOS відмовив у event tap. Надайте Доступність, потім знову виберіть свою клавішу у вікні Settings.

"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." або "Could not switch to <Key>; still using <Key>."

Зміну гарячої клавіші було відхилено. Надайте Доступність і виберіть клавішу заново; до цього Keebye продовжує використовувати попередню.

"Microphone capture failed: <error>"

Немає пристрою введення за замовчуванням або аудіопотік не запустився. Перевірте пристрій введення в Системних налаштуваннях › Звук і те, що доступ до мікрофона надано.

"Speech model still setting up — try again in a moment"

Вибраної моделі немає на диску або вона ще не завантажилася в память. Дочекайтеся, коли плашка вийде зі стану завантаження, або натисніть "Download model" у Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Пять спроб завантаження не вдалися (мережа, помилка HTTP або незбіг контрольної суми). Закрийте і знову відкрийте Keebye; завантаження продовжиться з того місця, де зупинилося.

"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"

Вибрано рушій Native (Apple Speech), але дозволу немає. Надайте «Розпізнавання мовлення» або перемкніться на Parakeet чи Canary.

"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" або "Apple Speech timed out after 15s"

Проблеми рушія Native. Можливо, потрібно встановити мовну модель на пристрої через Системні налаштування › Клавіатура › Диктування; інакше говоріть у межах 15 секунд або змініть рушій.

"Couldn't insert: Secure input is active (<App>) — dictation is blocked" або "Couldn't insert: A password field is focused — dictation is blocked"

Курсор стоїть у полі пароля або в застосунку увімкнено Secure Keyboard Entry (наприклад, у Terminal). Клацніть у звичайне текстове поле або вимкніть Secure Keyboard Entry. Так і задумано.

"Text left on clipboard — paste manually"

Синтез ⌘V або натискань клавіш не вдався. Розшифровка лежить у буфері обміну — натисніть ⌘V самі.

"Dictation hit an internal error and was reset. Please try again."

Робочий процес сесії відновився після збою. Продиктуйте знову.

Вікно початкового налаштування відкрилося знову після оновлення або перевстановлення

Застарілий дозвіл Доступності. Видаліть Keebye із Системних налаштувань › Конфіденційність і безпека › Доступність кнопкою −, додайте знову і увімкніть.

Скидання Keebye

Закрийте Keebye, видаліть ~/Library/Application Support/com.keebye.app/settings.json і елемент Keychain для служби com.keebye.app, акаунт auth. Запустіть застосунок знову — початкове налаштування почнеться заново. Діагностика виводиться лише в stderr.