음성 입력
기기 내 음성-투-텍스트로 MadoHub에 받아쓰기 — 오디오가 머신을 떠나지 않습니다.
음성 입력을 사용하면 타이핑 대신 받아쓸 수 있습니다. 핫키를 누른 채 말하고, 놓으면 전사가 지정한 곳에 들어갑니다. 전체 파이프라인이 로컬에서 돕니다: 오디오 캡처, 리샘플링, 전사가 모두 당신의 머신에서 일어나며, 그 사이 네트워크 호출이 없습니다.
클라우드 음성 API에 받아쓰면서 그 오디오가 어디로 갔는지 궁금했던 적이 있다면, 이것이 다른 설계입니다. 음성이 캡처되고, 로컬 Whisper 모델이 전사하며, MadoHub에 기록됩니다 — 모두 같은 프로세스 안, 당신의 머신에서. 오디오나 전사의 어떤 부분도 업로드되지 않습니다.
할 수 있는 일
- 누르고 말하기 받아쓰기 — 핫키를 누른 채 말하고, 놓으면 전사.
- 마지막 녹음 다시 시도 — 다시 말하지 않고도 캡처한 같은 오디오로 전사를 다시 실행합니다. 첫 패스가 잘못 들었을 때 유용.
- 전사를 세 곳 중 하나로 라우팅 — MadoAgent 채팅 입력, 제출 없이 포커스된 터미널, 또는 포커스된 터미널에 쓰고 바로 제출.
- 그 자리에서 대상 전환 — 설정을 열지 않고 명령 팔레트에서 받아쓰기가 떨어지는 곳을 바꿉니다.
- 모델 크기 선택 —
tiny(약 75 MB)부터medium(약 1.5 GB)까지; 큰 모델은 더 정확하지만 더 느리고 다운로드가 무겁습니다. - 언어 고정 또는 자동 감지 — 영어, 중국어, 일본어, 한국어, 스페인어, 프랑스어, 독일어, 또는 자동.
사용 방법
- 설정 → 음성에서 음성 입력을 활성화하거나, 명령 팔레트(Cmd+Shift+P)의 Enable Voice Input 항목으로("voice", "dictation", "push-to-talk", 또는 "음성"으로 검색 가능).
- 아직 Whisper 모델을 다운로드하지 않았다면, MadoHub이 설정을 음성 탭으로 열고 무엇을 다운로드해야 하는지 토스트로 알려줍니다 — 침묵에 녹음하지 않습니다.
- Cmd+Shift+V(기본 push-to-talk 핫키)를 누른 채 녹음하고, 놓으면 멈추고 전사합니다.
- 첫 패스가 잘못 들었다면 Cmd+Shift+R로 마지막 녹음을 다시 시도합니다. 다시 시도는 성공적인 전사 후 30초 이내, 그리고 그 이후 새 녹음을 시작하지 않았을 때만 작동합니다.
- 전사가 떨어지는 곳은 설정 → 음성에서 고르거나, 명령 팔레트에서 그 자리로 바꿉니다.
| 대상 | 동작 |
|---|---|
| Agent(기본값) | MadoAgent 채팅 입력에 초안으로 들어가며, 자동으로 열려 도착하는 것을 보여줍니다. 검토, 편집, 그리고 직접 Enter를 누릅니다. |
| Terminal — insert | 현재 포커스된 터미널 타일에 제출 없이 기록. 줄바꿈은 공백으로 합쳐져 셸에서 자동 제출되지 않습니다. |
| Terminal — auto | 포커스된 터미널 타일에 기록하고 바로 제출. |
두 터미널 대상은 녹음을 시작할 때 포커스된 터미널 타일로 잠깁니다 — 녹음 중 포커스가 바뀌어도 전사가 잘못 라우팅되지 않습니다. 포커스된 터미널이 없거나(또는 말하기 전에 타일이 닫혔거나) MadoHub은 Agent 대상으로 폴백하고 이유를 설명하는 토스트를 보여줍니다.
일반적인 사용 사례
- "auth 모듈을 클래스로 리팩터하고, 로그인 흐름의 테스트를 추가해줘." — 머릿속으로 코드를 훑으면서 MadoAgent에 긴 프롬프트를 받아쓰고, 검토하고 보냅니다.
- "타이핑 없이 빠른 셸 명령 실행" — 대상을 Terminal — auto로 하고
git status또는pnpm test를 받아쓰세요. - "CJK 받아쓰기" — 더 정확한 짧은 발화를 위해 언어를 중국어/일본어/한국어로 고정하세요. Whisper의 자동 감지는 조용하거나 매우 짧은 CJK 클립에서 오작동할 수 있습니다.
팁과 모범 사례
- 정확도/크기 트레이드오프가 좋은
small모델(기본값)로 시작하세요. 자주 받아쓰고 더 정확해야 하면medium으로 올리세요. - 말하는 언어를 알 때 고정하세요 — 짧거나 조용한 클립에서 자동 감지 실수를 피할 수 있습니다.
- 이미 쓰는 단축키와 충돌하면 설정에서 push-to-talk와 다시 시도 핫키를 다시 바인딩하세요; 설정이 충돌을 경고합니다.
- 여러 줄 입력을 받아쓸 때는 Terminal — auto 대신 Terminal — insert를 사용해 제출 전에 검토하세요.
관련 기능
- Command Palette — 여기서 음성 입력을 토글하고 대상을 바꿉니다.
- Settings — 모델, 언어, 핫키, 대상을 설정하는 음성 탭.
- MadoAgent — 기본 받아쓰기 대상.
제한 사항
- 음성 입력은 기본적으로 꺼져 있습니다; 처음 사용 전 활성화하세요.
- 다시 시도는 성공적인 전사 후 30초 이내, 그리고 그 이후 새 녹음을 시작하지 않았을 때만 작동합니다.
- 터미널 대상은 녹음을 시작하는 순간 라이브 터미널 타일이 포커스되어 있어야 합니다. 그렇지 않으면 MadoHub이 Agent 대상으로 폴백합니다.
- 녹음 전 모델이 다운로드되어 있어야 합니다; MadoHub은 침묵에 녹음하지 않습니다.