음성 명령

음성 명령은 음성 입력과 별개입니다. 명령 단축키(기본 ⌃⌥C)를 사용합니다. 인식 후 사용자 사전 → 내장 사전 순으로 맞추고, 미일치 시 선택적으로 의도 LLM을 호출한 뒤 단축키 / 셸을 실행합니다.

마스터 스위치

설정 → 음성 명령

음성 명령 사용( voiceCommandsEnabled, 기본 켜짐)
끄면: 명령 단축키, 기록 재실행, 관련 deeplink가 시작되지 않음. 음성 입력 / 번역은 영향 없음. 아래 실행·해석은 미리 설정 가능.

시작 구성

설정 → 음성 명령 → 시작 구성

한 번에 실행 능력과 내장 팩을 적용한 뒤 개별 조정할 수 있습니다.

프리셋	효과
안전	편집 단축키만. 의도 모델 꺼짐. 팩은 「편집」만
Q&A	플로팅 답변만. 체험 / Pro면 의도 모델 켜짐. 내장 팩 전부 끔
전체	단축키 + 입력 + 플로팅 답변 + 다시 쓰기 + 앱 열기 + 단축어. 모든 팩. 셸은 꺼진 채

실행 능력

설정 → 음성 명령 → 실행 능력

카드를 눌러 동작 유형을 추가하거나 제거합니다. 제거한 유형은 사전에서 건너뛰며 의도 모델도 반환하지 않습니다.

카드	의미	예시	기본
단축키 허용	키보드 단축키 주입. 추가 후 「위험한 단축키 확인」을 펼침	“복사” → `⌘C`(내장). “즐겨찾기 막대” → `⌘⇧B`(사용자 사전)	켜짐
텍스트 입력 허용	캐럿에 구문 삽입	“이메일 삽입” → 등록된 주소 삽입(사용자 사전)	켜짐
플로팅 답변 허용	Q&A를 플로팅 창에 표시	“DNS를 한 문장으로 설명” → HUD에 답변(의도 모델)	켜짐
텍스트 선택 시 다시 쓰기	체험 / Pro. 의도 모델 필요	텍스트 선택 후 “격식 있게 바꿔 줘”(의도 모델)	켜짐
앱 / URL 열기 허용	앱 이름 또는 https / mailto. 셸 불필요	“터미널 열기”(내장). “GitHub 열기” → `https://github.com`(사용자 사전)	켜짐
단축어 허용	Shortcuts.app의 기존 단축어 실행	“일일 보고서 실행” → ‘일일 보고서’ 단축어 실행(사용자 사전)	켜짐
셸 명령 허용	체험 / Pro. 추가 후 「셸 실행 전 확인」을 펼침. 셸	“지금 몇 시야” → `date` 실행(실행 전 확인)	꺼짐

내장 사전은 단축키와 앱 열기 두 동작만 포함합니다. 나머지 다섯 유형의 예시는 사용자 사전이나 의도 모델로 보완해야 합니다.

내장 팩

카드로 내장 구문 묶음을 추가하거나 제거합니다. 제거한 팩은 내장 사전에서 더 이상 일치하지 않습니다. 사용자 사전은 그대로입니다. 기본은 네 팩 모두 켜짐.

카드	예시
편집	복사, 붙여넣기, 실행 취소, 저장
창과 탭	닫기, 새로 만들기, 새로 고침, 다음 탭
앱 열기	Safari / Finder / 터미널 (「앱 / URL 열기 허용」 필요. 셸 불필요)
앱 전용	전면 앱의 뒤로, 주소창, 사이드바 등

명령 사전 (해석)

매칭 순서

정확 → 퍼지. 각 패스 내:

사용자 · 전면 앱 한정(사용 중)
사용자 · 전역(사용 중)
내장 · 전면 앱 (CommandRegistry.json의 apps)
내장 · 전역

같은 구문은 사용자 항목 우선.

사용자 사전

설정 → 음성 명령 → 명령 사전에서 편집(로컬 UserDefaults, 네트워크 없음):

구문(쉼표 / 줄바꿈 구분)
동작: 단축키 또는 셸(체험/Pro + 셸 허용)
선택 Bundle ID(비우면 전역)
사용 / 중지, 편집, 삭제

다섯 동작 유형별로 바로 복사해 쓸 수 있는 샘플:

구문	동작	범위	필요한 허용
`이메일 삽입`	텍스트 입력 `you@example.com`	전역	텍스트 입력 허용
`GitHub`	앱 / URL 열기 `https://github.com`	전역	앱 / URL 열기 허용
`화면 OCR`	단축어 `OCR`	전역	단축어 허용
`지금 몇 시야`	셸 `date`	전역	셸 명령 허용(체험 / Pro)
`즐겨찾기 막대`	단축키 `⌘⇧B`	`com.apple.Safari`	단축키 허용

「플로팅 답변」「선택 영역 다시 쓰기」는 사용자 사전 동작 목록에 없습니다——이 둘은 의도 모델만 가능합니다.

내장 사전

번들 CommandRegistry.json. 앱 안에서 이 JSON 파일은 편집 불가. 확장은 사용자 사전 또는 의도 모델.

내장 명령은 총 108개: 전역 41개(대부분 단축키, 앱 실행은 독립 open 동작) + 앱 9개의 전용 구문 67개. 전체 목록은 명령 참조 문서 참고. 개요:

편집·찾기/새로고침·탭·서식 키·Terminal/Finder/Safari 실행 등. 앱 열기는 「앱 / URL 열기 허용」이면 되고 셸은 필요 없음. 사용자 사전의 셸은 Trial/Pro + 셸 허용 필요. Safari / Chrome / Arc / Edge / VS Code / Cursor / Finder / Terminal / Slack 등.

로컬 사전 우선

켜면 사전 히트(사용자 + 내장) 시 의도 모델 건너뜀.

의도 모델

사전 밖 구문을 BYOK LLM으로 해석. 텍스트 후처리와 독립 토글.

음성 입력과의 차이

	음성 입력	음성 명령
기본 단축키	`⌃⌥Space`	`⌃⌥C`
결과	텍스트 삽입	단축키 / 셸
파이프라인	다듬기·치환 등	사용자/내장 사전 → 의도

기록의 해석 출처

명령 기록에 사전 / 의도 모델 / 수동 짧은 배지를 표시할 수 있습니다.