정리와 사전
음성 인식과 삽입 사이에서 전사에 일어나는 일: 사전, 규칙 기반 정리, 앱별 예외, 선택형 로컬 LLM 다듬기.
모든 받아쓰기는 여러분의 Mac에서 같은 짧은 파이프라인을 지나갑니다. 이 과정에서 네트워크는 전혀 쓰이지 않습니다.
파이프라인
선택한 엔진으로 음성을 텍스트로 바꿉니다.
커스텀 사전 치환. 항상 적용됩니다.
정리 — 규칙 기반, 또는 선택했다면 로컬 LLM — 맨 앞에 있는 앱에서 정리가 켜져 있을 때만 실행됩니다.
붙여넣기 또는 타이핑으로 삽입.
규칙 기반 정리
이것이 규칙 전부입니다. 정리는 말을 고쳐 시작한 부분이나 "like"라는 단어를 없애지 않습니다.
- 홀로 쓰인 "um", "uh", "erm"과 두 단어짜리 "you know"를, 토큰 전체가 일치할 때만 없앱니다.
- 바로 이어지는 단어 반복을 하나로 합칩니다. 예를 들어 "the the"는 "the"가 됩니다.
- 여분의 공백을 합칩니다.
- 첫 글자를 대문자로 바꿉니다.
- 텍스트가 글자나 숫자로 끝나면 마침표를 붙입니다.
앱별 예외
설정 › Enhancement › "Clean up transcripts by default"는 켜져 있습니다. 예외는 앱의 번들 ID를 키로 저장됩니다. "Add current app…"은 직전에 쓴 Keebye 이외의 앱을 기본값과 반대로 설정해 추가합니다. 각 항목에는 체크박스와 "Remove" 버튼이 있습니다.
커스텀 사전
설정 › Dictionary: "Replace spoken words with fixed spellings."(말한 단어를 정해진 철자로 바꿉니다.) Keebye가 듣는 말을 "heard as…"에, 원하는 철자를 "write as…"에 입력한 뒤 Add를 누르세요(Enter도 됩니다). Remove는 항목을 지웁니다. 항목이 없으면 "No replacements yet."이 표시됩니다.
- 단어 전체에만 일치하고, 더 긴 단어 안에서는 일치하지 않습니다.
- 일치는 대소문자를 구분하지 않습니다. 바뀐 결과는 입력한 대로의 대소문자를 유지합니다.
- 키는 여러 단어여도 됩니다. 가장 길게 일치한 것이 선택됩니다.
- 그 앱에서 정리가 켜져 있는지와 무관하게 모든 받아쓰기에 적용됩니다.
로컬 LLM 다듬기(선택형)
Keebye는 규칙 기반 정리 대신 전사를 로컬 언어 모델에 넘길 수도 있습니다. 모델은 Qwen3-1.7B(Q4_K_M GGUF, 약 1.28 GB)이며 Metal을 쓰는 llama.cpp에서 실행됩니다. thinking을 끈 그리디 샘플링, 64토큰 상한, 2초 제한으로 동작합니다. 실패하면 규칙 기반 정리로 되돌아갑니다.
충실도 가드가 LLM 출력을 쓰기 전에 확인합니다: 입력에 나온 단어의 절반 이상을 유지해야 하고, 입력 단어 수의 두 배에 넷을 더한 값을 넘지 않아야 하며, 같은 문장이나 네 단어 구절이 세 번 이상 반복되지 않아야 하고, 비어 있지 않아야 합니다. 조건을 채우지 못하면 LLM 출력은 버려집니다.