# AX Copilot 단축키 & 예약어 완전 정복

Windows 시맨틱 런처 AX Copilot v1.0.3의 키보드 단축키와 명령 예약어를 한눈에 정리했습니다.
v1.0.3 업데이트: 단축키 9종 구현 완료 · 예약어 변경 (~→워크스페이스, cd→폴더, !→비어있음) · 설정 버전 마이그레이션 프레임워크 추가
3차 구현 완료: 단축키 8종(Ctrl+T/F/P/D/W/K 모달/B토글/Home·End) · 기능 개선 5종(토스트 애니메이션/즐겨찾기 토글/액션 삭제/모달 도움말) · 설정창 기능 탭 추가 · 버전 자동 동기화
4차 구현 완료: 설정 기능 탭 → 런처 실동작 연결 (6종 토글) · Ctrl+K/ShortcutHelpWindow 테마 연동 · 헬프창 글로벌 단축키 동기화 · 사용 통계 즐겨찾기 섹션 추가

## ✅ 1. 현재 사용 중인 단축키

### 🌐 전역 (시스템 전체)

단축키 | 동작 | 비고
--- | --- | ---
Alt + Space | 런처 창 열기 / 닫기 (토글) | 기본값, 설정에서 변경 가능
PrintScreen | 화면 캡처 즉시 실행 | 설정에서 활성화 필요 (기본 OFF)

### 🪟 런처 창 (LauncherWindow)

단축키 | 동작 | 비고
--- | --- | ---
Escape | 창 닫기 / 액션 모드 종료 |
Enter | 선택 항목 실행 |
Shift + Enter | 병합 실행 또는 대형 텍스트 표시 | 결과 선택 상태일 때
↑ / ↓ | 결과 목록 위/아래 이동 |
Shift + ↑ | 병합 모드 ON + 위 항목 선택 |
Shift + ↓ | 병합 모드 ON + 아래 항목 선택 |
→ (오른쪽) | 액션 모드 진입 (컨텍스트 메뉴) |
Tab | 선택 항목 제목으로 자동완성 |
Ctrl + , | 설정 창 열기 |
F1 | 도움말 창 열기 | ✨ v1.0.3 신규
F5 | 인덱스 새로 고침 | ✨ v1.0.3 신규
Delete | 목록에서 항목 제거 (확인 다이얼로그) | ✨ v1.0.3 신규
Ctrl + L | 입력창 초기화 (Clear) | ✨ v1.0.3 신규
Ctrl + C | 선택 항목 이름 복사 (파일 선택 시) | ✨ v1.0.3 신규
Ctrl + Shift + C | 전체 경로 복사 (Copy as path) | ✨ v1.0.3 신규
Ctrl + Shift + E | 파일 탐색기에서 열기 | ✨ v1.0.3 신규
Ctrl + Enter | 관리자 권한으로 실행 (Run as Admin) | ✨ v1.0.3 신규
Alt + Enter | 파일 속성 보기 (Properties) | ✨ v1.0.3 신규
Ctrl + H | 클립보드 히스토리 열기 | ✨ v1.0.3 신규
Ctrl + R | 최근 실행 항목 보기 | ✨ v1.0.3 신규
Ctrl + B | 즐겨찾기 열기 | ✨ v1.0.3 신규
Ctrl + K | 단축키 도움말 팝업 | ✨ v1.0.3 신규
Ctrl + 1~9 | N번째 결과 즉시 실행 | ✨ v1.0.3 신규
F2 | 파일 이름 바꾸기 | ✨ v1.0.3 신규
PageUp / PageDown | 결과 5개씩 페이지 스크롤 | ✨ v1.0.3 신규

### 🗂 기타 창

단축키 | 동작 | 대상 창
--- | --- | ---
Escape | 창 닫기 | 도움말 / 색상 선택기 / 알림 팝업 / 대형 텍스트
← / → | 카테고리 이동 | 도움말 창
↑↓←→ | 선택 영역 1px 미세 조정 | 영역 선택 (캡처)
Shift + 방향키 | 선택 영역 10px 이동 | 영역 선택 (캡처)
Enter | 영역 확정 후 캡처 | 영역 선택 (캡처)

## 🔓 2. 비어있는 단축키 (신기능 배정 가능)

💡 아래 단축키들은 런처 창 내부 기준입니다. 전역 단축키는 설정에서 자유롭게 지정 가능합니다.

### ⌨ 단독 키

단축키 | 추천 기능 | 우선순위
--- | --- | ---
← (왼쪽) | 뒤로 가기 / 상위 폴더 | ★★☆
Home / End | 첫 번째 / 마지막 결과로 이동 | ★☆☆

### ⌃ Ctrl 계열

단축키 | 추천 기능 | 우선순위
--- | --- | ---
Ctrl + P | 결과 상단 고정 (Pin) | ★★☆
Ctrl + T | 창 항상 위 (Always on Top) 토글 | ★★☆
Ctrl + F | 전문 검색 모드 (Full-text) | ★★☆
Ctrl + W | 창 닫기 (브라우저 스타일) | ★☆☆
Ctrl + D | 인덱스에서 제거 | ★☆☆

### ⌥ Alt 계열

단축키 | 추천 기능 | 우선순위
--- | --- | ---
Alt + ↑ | 상위 폴더로 이동 | ★★☆
Alt + 1~5 | 즐겨찾기 슬롯 즉시 실행 | ★★☆

### ⇧ Shift 계열

단축키 | 추천 기능 | 우선순위
--- | --- | ---
Shift + Delete | 휴지통 없이 즉시 삭제 | ★★☆
Shift + Tab | 역방향 자동완성 | ★☆☆

## 🔤 3. 명령 예약어 전체 목록

런처 입력창에서 예약어를 입력하면 해당 기능이 활성화됩니다.

### ⚡ 특수 기호 예약어

예약어 | 기능 | 사용 예시
--- | --- | ---
= | 계산기 (Calculator) | = 1+2*3 → 결과 7
$ | 클립보드 텍스트 변환 | $ upper → 대문자 변환
@ | URL 열기 (Alias) | @ google → 등록된 URL 열기
~ | 워크스페이스 관리 | ~save 개발, ~개발 → 창 배치 복원
> | 터미널 명령 실행 | > ipconfig → CMD 실행
^ | 앱/파일 직접 실행 (Run) | ^ notepad
! | 비어있음 (신기능 배정 가능) | —
? | 웹 검색 | ? WPF binding → 브라우저 검색
# | 클립보드 히스토리 | # → 최근 복사 목록
; | 스니펫 (텍스트 템플릿) | ; email → 이메일 스니펫 붙여넣기
/ | 시스템 명령 | / shutdown, / lock
* | 시스템 정보 (Quick Info) | * ip, * cpu

### 📝 영문 키워드 예약어

예약어 | 기능 | 사용 예시
--- | --- | ---
cd | 폴더 열기 (별칭) | cd dl, cd work, cd desktop
help | 도움말 / 명령어 목록 | help → 전체 도움말 창
cap | 화면 캡처 (설정에서 변경 가능) | cap screen, cap window, cap region
date | 날짜 계산 | date +30 → 30일 후 날짜
color | 색상 코드 변환 | color #FF5733 → RGB/HSL 보기
pick | 색상 선택기 (Eyedropper) | pick → 화면에서 색상 추출
encode | 인코딩 / 디코딩 | encode base64 hello
emoji | 이모지 검색 | emoji 웃음
json | JSON 파싱 / 미리보기 | json {"a":1}
note | 노트 관리 | note 회의 메모 내용
recent | 최근 사용 파일 | recent → 목록 보기
fav | 즐겨찾기 관리 | fav add, fav list
batch | 일괄 텍스트 처리 | batch number, batch sort, batch prefix >>
pipe | 클립보드 파이프라인 | pipe upper | trim
diff | 텍스트 비교 | diff → 두 텍스트 비교
journal | 업무 일지 | journal 오늘 한 일
routine | 루틴 관리 | routine start 출근
rename | 파일 이름 일괄 변경 | rename *.jpg → photo_*.jpg
scaffold | 프로젝트 스캐폴드 | scaffold react
snap | 창 스냅 / 정렬 | snap left, snap grid
win | 창 전환 (Window Switcher) | win chrome
port | 포트 확인 | port 8080 → 사용 중인 프로세스 확인
kill | 프로세스 종료 | kill chrome
svc | Windows 서비스 관리 | svc list, svc stop 이름
env | 환경변수 조회 | env PATH
info | 시스템 정보 상세 | info cpu, info disk
media | 미디어 제어 | media play, media next
monitor | 모니터 관리 | monitor list
uninstall | 프로그램 제거 | uninstall 프로그램명
stats | 텍스트 통계 (글자수/단어수) | stats → 클립보드 텍스트 분석

## ✅ 4. 1차 구현 완료 (v1.0.3)

단축키 | 기능 | 상태
--- | --- | ---
F1 | 도움말 창 열기 | ✅ 구현 완료
F5 | 인덱스 새로 고침 | ✅ 구현 완료
Delete | 항목 제거 (확인 다이얼로그 포함) | ✅ 구현 완료
Ctrl + Enter | 관리자 권한 실행 | ✅ 구현 완료
Ctrl + C | 선택 항목 이름 복사 | ✅ 구현 완료
Ctrl + L | 입력창 초기화 | ✅ 구현 완료
Ctrl + Shift + C | 전체 경로 복사 | ✅ 구현 완료
Ctrl + Shift + E | 탐색기에서 열기 | ✅ 구현 완료
Alt + Enter | 파일 속성 보기 | ✅ 구현 완료

## ✅ 5. 2차 구현 완료 (v1.0.3)

### 🎯 단축키 7종 추가

단축키 | 기능 | 상태
--- | --- | ---
Ctrl + H | 클립보드 히스토리 바로 열기 | ✅ 구현 완료
Ctrl + R | 최근 실행 항목 보기 | ✅ 구현 완료
Ctrl + B | 즐겨찾기 열기 | ✅ 구현 완료
Ctrl + K | 단축키 도움말 팝업 | ✅ 구현 완료
Ctrl + 1~9 | n번째 결과 즉시 실행 | ✅ 구현 완료
F2 | 파일 이름 바꾸기 (rename 전환) | ✅ 구현 완료
PageUp / PageDown | 결과 5개씩 페이지 스크롤 | ✅ 구현 완료

### 🛠 기능 개선 5종

항목 | 설명 | 상태
--- | --- | ---
설정 마이그레이션 알림 | 버전 업데이트 시 변경사항 MessageBox 자동 표시 | ✅ 완료
도움말 검색 | 3탭 메뉴 우측에 검색박스 추가, 실시간 필터링 | ✅ 완료
번호 뱃지 | 결과 항목 1~9 번호 표시, Ctrl+N으로 즉시 실행 | ✅ 완료
액션 모드 확장 | → 진입 시: 경로복사, 전체경로복사, 탐색기, 관리자, 터미널, 속성, 이름변경 | ✅ 완료
토스트 오버레이 | 별도 UI 컴포넌트 (녹색 배경, 체크 아이콘, 2초 자동 숨김) | ✅ 완료

## ✅ 6. 3차 구현 완료 (v1.0.3)

### 🎯 단축키 8종 추가

단축키 | 실제 동작 | 상태
--- | --- | ---
Ctrl + T | 선택된 파일/폴더 경로에서 터미널(wt → cmd 순) 열기. 미선택 시 홈 디렉터리 | ✅ 구현 완료
Ctrl + F | 입력창 초기화 후 포커스 이동 → 파일명 검색 즉시 시작 | ✅ 구현 완료
Ctrl + P | 선택된 파일/폴더를 즐겨찾기에 즉시 추가. 이미 있으면 제거 (토스트 알림) | ✅ 구현 완료
Ctrl + D | 사용자 Downloads 폴더 경로를 입력창에 채워 탐색기로 열 수 있게 함 | ✅ 구현 완료
Ctrl + W | 런처 창 즉시 닫기 (브라우저 탭 닫기 스타일) | ✅ 구현 완료
Home / End | 입력 커서가 맨 앞/끝일 때 결과 목록 첫/마지막 항목으로 점프 | ✅ 구현 완료
Ctrl + B (개선) | fav 입력 상태면 초기화(닫기), 아니면 fav 입력(열기) — 토글 방식 | ✅ 개선 완료
Ctrl + K (개선) | MessageBox → 전용 ShortcutHelpWindow 모달 창 (카테고리별 아이콘 표) | ✅ 개선 완료

### 🛠 기능 개선 5종

항목 | 내용 | 상태
--- | --- | ---
토스트 애니메이션 | 페이드 인(0.18s QuadEaseOut) + 페이드 아웃(0.28s QuadEaseIn) XAML Storyboard 적용 | ✅ 완료
액션 모드 파일 삭제 | → 메뉴에 "휴지통으로 이동" 추가. Shell32 SHFileOperation P/Invoke로 RecycleBin 전송, 확인 다이얼로그 포함 | ✅ 완료
설정창 기능 탭 | 번호배지/프리픽스배지/포커스잃으면닫기/액션모드/최근기록/즐겨찾기/스니펫자동확장 7종 토글 + 단축키 참조표 | ✅ 완료
헬프창 단축키 설명 상세화 | 각 단축키 Description을 "어떤 동작인지" 구체적으로 1~2문장으로 기술. 신규 단축키 10종 추가 | ✅ 완료
버전 자동 동기화 | 설정창 하단 버전 표시를 csproj <Version> 에서 동적으로 읽음. 주석 및 가이드 추가 | ✅ 완료

## ✅ 7. 4차 구현 완료

단축키 후보(Ctrl+G/U/E/M)는 기능 과잉 우려로 미채택. 기능 개선 4종 완료.

항목 | 설명 | 상태
--- | --- | ---
설정창 기능 탭 → 런처 실동작 연결 | ShowNumberBadges(배지 표시/숨김) · ShowPrefixBadge(예약어 배지) · CloseOnFocusLost(자동 닫기) · EnableActionMode(→ 키) · EnableFavorites(fav 차단) · EnableRecent(recent 차단) | ✅ 완료
Ctrl+K ShortcutHelpWindow 테마 연동 | 현재 테마의 LauncherBackground·ItemBackground·PrimaryText·SecondaryText를 DynamicResource로 적용 | ✅ 완료
헬프창 글로벌 단축키 동기화 | 설정에서 변경한 전역 단축키가 헬프 창 단축키 목록(F1)에 즉시 반영 | ✅ 완료
사용 통계 → 즐겨찾기 항목 포함 | stats 화면 하단에 즐겨찾기 최근 6개 항목 섹션 추가 (HasFavorites=false이면 숨김) | ✅ 완료
설정창 단축키 녹화(HotkeyRecorder) 수정 | Window 레벨 PreviewKeyDown으로 포커스 이탈 시에도 키 녹화 안정화, Alt 조합키(Key.System) 정상 처리 | ✅ 완료

## 📋 8. 5차 추천 작업 목록

### 🛠 다음 기능 개선 후보

항목 | 설명 | 우선순위
--- | --- | ---
! 예약어 신기능 배정 | 비어있는 ! 기호에 새 기능 할당 (즉시 알림/메모/북마크 등) | ★★★
런처 테마별 정중앙 미세조정 | 각 테마의 아이콘/텍스트 수직 정렬 픽셀 단위 검수 및 미세 조정 | ★★☆