문제 해결

Keebye가 표시하는 각 메시지의 뜻과 해결법, 그리고 초기화하는 방법.

대부분의 문제는 권한, 없는 모델, 또는 받아쓰기가 멈춰 있는 상태로 귀결됩니다. 먼저 간단한 확인부터 하고, 그다음 아래에서 자신이 본 메시지를 찾으세요.

핫키가 반응하지 않나요? 먼저 여기를 확인하세요

트레이 메뉴에서 "Enable Dictation"에 체크가 되어 있습니다.
로그인되어 있고 체험이 끝나지 않았습니다(설정 › Account).
시스템 설정 › 개인 정보 보호 및 보안 › 손쉬운 사용에서 손쉬운 사용이 허용되어 있습니다.
보안 입력이 켜져 있지 않습니다 — 예를 들어 터미널의 Secure Keyboard Entry나 포커스된 비밀번호 필드.

메시지와 그 뜻

"Accessibility permission was revoked — reopen System Settings"

녹음이 시작될 때 손쉬운 사용 신뢰가 없었습니다. 시스템 설정 › 개인 정보 보호 및 보안 › 손쉬운 사용을 열고 Keebye를 켜세요. Keebye는 2초 안에 핫키를 다시 등록합니다.

"Failed to start the global hotkey listener"

macOS가 이벤트 탭을 거부했습니다. 손쉬운 사용 권한을 허용한 뒤 설정에서 키를 다시 고르세요.

"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"

선택한 모델이 디스크에 없거나 아직 로딩이 끝나지 않았습니다. 필이 다운로드 상태를 벗어날 때까지 기다리거나, 설정 › Speech engine에서 "Download model"을 누르세요.

"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를 켜두었습니다(예: 터미널). 일반 텍스트 필드를 클릭하거나 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을 지운 뒤, 서비스 com.keebye.app, 계정 auth의 키체인 항목을 삭제하세요. 다시 실행하면 온보딩이 처음부터 시작됩니다. 진단 정보는 stderr로만 나갑니다.