문제 해결

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

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

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

트레이 메뉴에서 "Enable Dictation"에 체크가 되어 있습니다.
로그인되어 있고 체험이 끝나지 않았습니다(설정 › Account).
Mac에서 시스템 설정 › 개인 정보 보호 및 보안 › 손쉬운 사용에서 손쉬운 사용이 허용되어 있습니다.
Mac에서 보안 입력이 켜져 있지 않습니다 — 예를 들어 터미널의 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>"

기본 입력 장치가 없거나 오디오 스트림이 실패했습니다. 사운드 설정(Mac에서는 시스템 설정 › 사운드)에서 입력 장치를 확인하고, 마이크 권한이 허용되어 있는지도 확인하세요.

"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(Windows에서는 Ctrl+V) 또는 키 입력 합성이 실패했습니다. 전사는 클립보드에 있으니 직접 붙여넣으세요.

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

세션 워커가 크래시에서 복구되었습니다. 다시 받아쓰기해 보세요.

업데이트나 재설치 후에 온보딩 창이 다시 열렸습니다(Mac)

손쉬운 사용 허용이 오래되어 무효해진 경우입니다. 시스템 설정 › 개인 정보 보호 및 보안 › 손쉬운 사용에서 − 버튼으로 Keebye를 지우고, 다시 추가한 뒤 켜세요.

Windows SmartScreen에 "Windows의 PC 보호"가 표시됩니다

Windows 설치 파일은 아직 코드 서명이 되어 있지 않습니다. "추가 정보"를 누른 다음 "실행"을 선택하세요 — keebye.com에서 내려받은 설치 파일인 경우에만 그렇게 하세요.

Windows에서 받아쓰기에 아무것도 녹음되지 않습니다

Windows가 데스크톱 앱의 마이크 접근을 막고 있을 수 있습니다. 설정 › 개인 정보 및 보안 › 마이크를 열고 데스크톱 앱이 마이크를 사용하도록 허용한 뒤, 올바른 입력 장치가 선택되어 있는지 확인하세요.

Keebye 초기화

Keebye를 종료하고 settings.json(Mac에서는 ~/Library/Application Support/com.keebye.app/, Windows에서는 %APPDATA%\com.keebye.app\)을 지운 뒤, macOS 키체인 또는 Windows 자격 증명 관리자에서 서비스 com.keebye.app, 계정 auth의 자격 증명을 삭제하세요. 다시 실행하면 온보딩이 처음부터 시작됩니다. 진단 정보는 stderr로만 나갑니다.