For AI agents: full index at https://keebye.com/llms.txt

Перейти до вмісту документації
Keebye Docs

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

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

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

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

  1. У меню трея позначено пункт "Enable Dictation".
  2. Ви увійшли в обліковий запис і пробний період не закінчився (Settings › Account).
  3. На Mac доступність надано в Системних налаштуваннях › Конфіденційність і безпека › Доступність.
  4. На Mac захищене введення не активне — наприклад, 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>"

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

"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 (Ctrl+V у Windows) або натискань клавіш не вдався. Розшифровка лежить у буфері обміну — вставте її самі.

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

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

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

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

Windows SmartScreen показує "Windows protected your PC"

Інсталятор для Windows поки не має цифрового підпису. Виберіть More info, а потім Run anyway — лише для інсталятора, який ви завантажили з keebye.com.

У Windows диктування нічого не записує

Можливо, Windows блокує доступ до мікрофона для класичних програм. Відкрийте Параметри › Конфіденційність і захист › Мікрофон, дозвольте класичним програмам використовувати мікрофон і перевірте, що вибрано правильний пристрій введення.

Скидання Keebye

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