Устранение неполадок

Что означает каждое сообщение 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.