Към съдържанието на документацията
Документация на Keebye

Отстраняване на проблеми

Какво означава всяко съобщение, което Keebye показва, как да го отстраните и как да върнете всичко към начално състояние.

Повечето проблеми се свеждат до разрешение, липсващ модел или спряна диктовка. Започнете с бързите проверки, после намерете съобщението си по-долу.

Клавишът не прави нищо? Проверете първо това

  1. "Enable Dictation" е с отметка в менюто на иконата.
  2. Влезли сте в профила си и пробният период не е свършил (Settings › Account).
  3. Accessibility е разрешено в System Settings › Privacy & Security › Accessibility.
  4. Няма активно защитено въвеждане — например Secure Keyboard Entry в Terminal или фокусирано поле за парола.

Съобщения и какво означават

"Accessibility permission was revoked — reopen System Settings"

Разрешението за Accessibility е липсвало при започването на записа. Отворете System Settings › Privacy & Security › Accessibility и включете Keebye. Keebye активира отново клавиша в рамките на 2 секунди.

"Failed to start the global hotkey listener"

macOS отказа прихващането на събития. Дайте достъп до Accessibility, после изберете клавиша си отново в Settings.

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

Смяната на клавиша беше отказана. Дайте достъп до Accessibility и изберете клавиша отново; дотогава Keebye продължава да използва предишния клавиш.

"Microphone capture failed: <error>"

Няма входно устройство по подразбиране или звуковият вход се провали. Проверете входното устройство в System Settings › Sound и че достъпът Microphone е даден.

"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) без разрешение. Дайте разрешение Speech Recognition или преминете към Parakeet или Canary.

"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" или "Apple Speech timed out after 15s"

Проблеми с двигателя Native. Може да се наложи да инсталирате езиковия модел на устройството през System Settings › Keyboard › Dictation; иначе говорете в рамките на 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."

Работният процес на сесията се възстанови след срив. Диктувайте отново.

Прозорецът за първоначална настройка се отвори отново след обновление или преинсталиране

Остаряло разрешение за Accessibility. Премахнете Keebye от System Settings › Privacy & Security › Accessibility с бутона −, добавете го отново и го включете.

Нулиране на Keebye

Затворете Keebye, изтрийте ~/Library/Application Support/com.keebye.app/settings.json и премахнете елемента в Keychain за услугата com.keebye.app, профил auth. Стартирайте отново и първоначалната настройка започва наново. Диагностиката отива само в stderr.