Chuyển đến nội dung tài liệu
Tài liệu Keebye

Khắc phục sự cố

Từng thông báo Keebye hiện có nghĩa gì và cách xử lý, cùng cách đặt lại.

Phần lớn vấn đề đều nằm ở một quyền, một model bị thiếu, hoặc việc gõ bằng giọng nói đang bị tạm dừng. Hãy bắt đầu với các bước kiểm tra nhanh, rồi tìm thông báo của bạn bên dưới.

Hotkey không làm gì? Kiểm tra những điều này trước

  1. "Enable Dictation" đang được chọn trong menu tray.
  2. Bạn đã đăng nhập và bản dùng thử chưa kết thúc (Settings › Account).
  3. Accessibility đã được cấp trong System Settings › Privacy & Security › Accessibility.
  4. Không có secure input nào đang bật — ví dụ Secure Keyboard Entry trong Terminal, hoặc một ô mật khẩu đang có focus.

Các thông báo và ý nghĩa của chúng

"Accessibility permission was revoked — reopen System Settings"

Quyền Accessibility bị thiếu khi lượt ghi bắt đầu. Mở System Settings › Privacy & Security › Accessibility và bật Keebye lên. Keebye kích hoạt lại hotkey trong vòng 2 giây.

"Failed to start the global hotkey listener"

macOS từ chối event tap. Hãy cấp quyền Accessibility, rồi chọn lại phím của bạn trong Settings.

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

Việc đổi hotkey bị từ chối. Hãy cấp quyền Accessibility và chọn lại phím; đến lúc đó Keebye vẫn dùng phím trước đó.

"Microphone capture failed: <error>"

Không có thiết bị đầu vào mặc định hoặc luồng âm thanh bị lỗi. Hãy kiểm tra thiết bị đầu vào trong System Settings › Sound và xem quyền Microphone đã được cấp chưa.

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

Model đã chọn không có trên đĩa hoặc chưa nạp xong. Hãy đợi thanh pill rời khỏi trạng thái tải, hoặc nhấn "Download model" trong Settings › Speech engine.

"Model download failed — reopen Keebye to retry"

Năm lần thử tải đều thất bại (mạng, lỗi HTTP hoặc checksum không khớp). Hãy thoát và mở lại Keebye; việc tải tiếp tục từ chỗ đã dừng.

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

Engine Native (Apple Speech) được chọn mà chưa có quyền. Hãy cấp quyền Speech Recognition, hoặc đổi sang Parakeet hoặc Canary.

"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" hoặc "Apple Speech timed out after 15s"

Các vấn đề của engine Native. Mô hình ngôn ngữ chạy ngay trên máy có thể cần được cài qua System Settings › Keyboard › Dictation; nếu không, hãy nói trong vòng 15 giây hoặc đổi engine.

"Couldn't insert: Secure input is active (<App>) — dictation is blocked" hoặc "Couldn't insert: A password field is focused — dictation is blocked"

Một ô mật khẩu đang có focus hoặc một ứng dụng đang bật Secure Keyboard Entry (Terminal, chẳng hạn). Hãy nhấp vào một ô văn bản thường hoặc tắt Secure Keyboard Entry. Đây là chủ ý thiết kế.

"Text left on clipboard — paste manually"

Việc mô phỏng ⌘V hoặc các phím đã thất bại. Bản transcript đang ở clipboard của bạn; hãy tự nhấn ⌘V.

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

Tiến trình xử lý phiên đã phục hồi sau một lần crash. Hãy đọc lại.

Cửa sổ onboarding mở lại sau khi cập nhật hoặc cài lại

Một quyền Accessibility cũ đã hỏng. Hãy xóa Keebye khỏi System Settings › Privacy & Security › Accessibility bằng nút −, thêm lại và bật lên.

Đặt lại Keebye

Thoát Keebye, xóa ~/Library/Application Support/com.keebye.app/settings.json, và xóa mục Keychain cho service com.keebye.app, account auth. Mở lại và onboarding bắt đầu từ đầu. Thông tin chẩn đoán chỉ đi ra stderr.