# AX Commander 사용 매뉴얼 (v1.0.3)

> 사내 전용 런처 프로그램 — 키보드 하나로 파일·명령·클립보드·계산까지

---

## 목차

1. [시작하기](#1-시작하기)
2. [기본 사용법](#2-기본-사용법)
3. [명령어 프리픽스 가이드](#3-명령어-프리픽스-가이드)
4. [파일 및 앱 검색](#4-파일-및-앱-검색)
5. [파일 액션 서브메뉴](#5-파일-액션-서브메뉴)
6. [Large Type](#6-large-type)
7. [클립보드 합치기](#7-클립보드-합치기)
8. [설정 변경](#8-설정-변경)
9. [잠금 해제 사용시간 알림](#9-잠금-해제-사용시간-알림)
10. [전체 키보드 단축키 표](#10-전체-키보드-단축키-표)
11. [자주 묻는 질문](#11-자주-묻는-질문)

> **v1.0 정식 릴리스** — 30개+ 명령어, 9개 테마(모양 포함), 클립보드 DPAPI 암호화, 글로벌 캡처 단축키, 잠금 해제 알림, 다국어(ko/en/ja/zh/vi), 텍스트 통계·즐겨찾기·파일 이름변경·시스템 모니터·프로젝트 스캐폴딩, AX Agent AI 대화(프롬프트 카드, 코드 구문 강조, 토큰 사용량, 타이핑 효과, 지연 캡처)

---

## 1. 시작하기

### 설치 방법

| 방법 | 파일 | 설명 |
|------|------|------|
| **오프라인 인스톨러** | `AxCommander_Setup.exe` (~136MB) | 모든 것 내장, 인터넷 불필요. 설치 경로 선택, 바로가기, 프로그램 등록 |
| **온라인 인스톨러 (경량)** | `AxCommander_Setup_Online.exe` (**~1MB**) | .NET 4.8 기반 (Windows 기본). .NET 8 Runtime 없으면 자동 다운로드 설치 |
| **직접 실행** | `AxCommander\` 폴더 | 폴더째 복사 후 `AxCommander.exe` 실행 (설치 과정 없음) |

### 런처 열기

프로그램이 백그라운드에서 실행 중인 상태에서 기본 단축키를 누릅니다.

```
기본 단축키:  Alt + Space
```

화면 중앙 상단에 런처 창이 나타납니다.

### 런처 닫기

- `Esc` 키
- 런처 창 밖을 클릭

### 시스템 트레이

작업 표시줄 우측 트레이 아이콘을 우클릭하면 메뉴가 나타납니다.

| 메뉴 항목 | 아이콘 | 기능 |
|----------|--------|------|
| AX Commander 열기 | ⚡ | 런처 창 표시 |
| 설정 | ⚙ | 설정 창 열기 |
| 사용 통계 | 📊 | 런처 사용 현황 통계 창 열기 |
| 플러그인 재로드 | 🔌 | 외부 플러그인 다시 불러오기 |
| 로그 폴더 열기 | 📁 | 오류 로그 폴더를 탐색기로 열기 |
| 정보 | ℹ | 개발자 정보 및 버전 확인 |
| Windows 시작 시 자동 실행 | 💡 | 전구 아이콘 — 활성화되면 **앰버색으로 빛나는** 전구 표시. 체크 시 Windows 로그인 시 자동 시작 등록/해제 |
| 종료 | ✕ | 프로그램 완전 종료 |

> 트레이 메뉴 디자인은 현재 테마 색상을 자동으로 따릅니다. Dark 테마면 어두운 배경, Light 테마면 밝은 배경으로 표시됩니다.

---

## 2. 기본 사용법

### 검색하고 실행하기

1. `Alt+Space`로 런처를 엽니다
2. 원하는 파일명, 앱 이름, 또는 명령어를 입력합니다
3. `↑` / `↓` 방향키로 결과를 탐색합니다
4. `Enter`를 눌러 실행합니다

```
예시:
  "chrome"  →  Google Chrome 실행
  "보고서"  →  보고서.xlsx 파일 열기
  "다운"    →  다운로드 폴더 열기
```

### 자동완성

결과 목록에서 항목이 선택된 상태에서 `Tab`을 누르면 해당 항목의 이름이 입력창에 채워집니다.

---

## 3. 명령어 프리픽스 가이드

특수 문자를 맨 앞에 입력하면 해당 기능 모드로 전환됩니다.
입력창 좌측에 컬러 배지가 표시되어 현재 모드를 알려줍니다.

| 프리픽스 | 모드 | 예시 |
|---------|------|------|
| `@` | URL 별칭 열기 | `@gh` → GitHub 열기 |
| `~` | 폴더 별칭 열기 | `~dl` → 다운로드 폴더 열기 |
| `>` | 배치/명령 실행 | `>build` → 빌드 스크립트 실행 |
| `$` | 클립보드 텍스트 변환 | `$json` → 클립보드 내용 JSON 정렬 |
| `!` | 워크스페이스 관리 | `!save work` → 현재 창 배치 저장 |
| `#` | 클립보드 히스토리 | `#` → 최근 복사 내역 표시 |
| `;` | 텍스트 스니펫 | `;addr` → 회사 주소 붙여넣기 |
| `=` | 계산기·단위·통화 변환 | `=100 USD to KRW`, `=100km in miles` |
| `?` | 웹 검색 (10개 엔진) | `? 검색어` → 기본 엔진, `?n 검색어` → 네이버, `?g` 구글, `?y` 유튜브, `?nw` 나무위키 등 |
| `/` | 시스템 명령·타이머·알람 | `/timer 5m`, `/alarm 14:30`, `/lock` |
| `emoji` | 이모지 피커 | `emoji 하트` → ❤️ 클립보드 복사 |
| `color` | 색상 변환기 | `color #FF5500` → HEX/RGB/HSL/HSV |
| `recent` | 최근 파일 | `recent 보고서` → 최근 문서 검색 |
| `note` | 빠른 메모 | `note 내일 회의` → 저장 / `note` → 목록 |
| `uninstall` | 앱 제거 | `uninstall chrome` → 제거 실행 |
| `kill` | 프로세스 종료 | `kill chrome` → 크롬 프로세스 강제 종료 |
| `media` | 미디어 제어 | `media pause` → 재생/일시정지 |
| `info` 또는 `*` | 시스템 정보 | `info` → IP·배터리·볼륨 현황 (`*`로도 동일하게 사용 가능) |
| `cap` *(변경 가능)* | 화면 캡처 | `cap region` → 영역 선택, `cap window` → 창 캡처, `cap scroll` → 스크롤, `cap screen` → 전체 화면. Shift+Enter → 지연 캡처 |
| `pick` | 스포이드 색상 추출 | `pick` → 스포이드 모드, 클릭으로 HEX 색상 코드 추출 |
| `date` | 날짜 계산 · D-day | `date +30d`, `date 2026-12-25`, `date unix` |
| `svc` | 서비스 관리 | `svc` → 서비스 목록, `svc restart clipboard` → 클립보드 재시작 |
| `stats` | 텍스트 통계 분석 | `stats` → 클립보드 텍스트 글자·단어·줄 수 분석 |
| `fav` | 즐겨찾기 | `fav` → 목록, `fav add 보고서 C:\work\report.xlsx` → 등록 |
| `rename` | 파일 일괄 이름변경 | `rename C:\work\*.xlsx 보고서_{n}` → 순번 이름변경 |
| `monitor` | 시스템 리소스 모니터 | `monitor` → CPU·메모리·디스크·프로세스 현황 |
| `scaffold` | 프로젝트 스캐폴딩 | `scaffold webapi` → 프로젝트 폴더 구조 생성 |
| `pipe` | 클립보드 파이프라인 | `pipe upper > trim > b64e` → 변환 체이닝 |
| `journal` | 업무 일지 자동 생성 | `journal` → 오늘 사용 앱/명령어 기반 마크다운 보고서 |
| `routine` | 루틴 자동화 | `routine morning` → 등록된 앱/폴더/URL 일괄 실행 |
| `batch` | 텍스트 일괄 처리 | `batch number` → 줄번호, `batch sort` → 정렬 |
| `diff` | 텍스트/파일 비교 | `diff` → 클립보드 2개 비교, 파일 선택 비교 지원 |
| `win` | 윈도우 스위처 | `win chrome` → 열린 창 검색 후 즉시 전환 |
| `help` | 도움말 | `help` → 카테고리별 페이지 전체 기능 목록 창 |

---

## 4. 파일 및 앱 검색

프리픽스 없이 텍스트를 입력하면 인덱싱된 파일과 앱을 검색합니다.

### 검색 범위

- 바탕화면
- Windows 시작 메뉴 (설치된 앱)
- 설정에서 추가한 인덱스 경로

### 한국어 초성 검색 지원

| 입력 | 검색되는 예시 |
|------|-------------|
| `ㅂㄱㅅ` | 보고서.xlsx |
| `ㅅㅈ` | 사진 폴더, 설정 |
| `ㄱㅅ` | 개선안.docx |

### 빠른 실행 별칭

설정 → 빠른 실행 탭에서 자주 쓰는 파일/폴더/URL에 단축 키워드를 등록할 수 있습니다.

```
예시 등록:
  키워드: vscode   →   C:\...\Code.exe
  키워드: gh       →   https://github.com (@ 없이도 사용 가능)
  키워드: work     →   C:\Projects\
```

---

## 5. 파일 액션 서브메뉴

파일이나 앱을 선택한 후 `→` 키를 누르면 해당 항목에 대한 액션 메뉴가 열립니다.

### 진입 방법

1. 런처에서 파일 또는 앱을 검색합니다
2. 원하는 항목을 `↑` / `↓`로 선택합니다
3. **입력 커서가 텍스트 맨 끝에 있는 상태**에서 `→` 키를 누릅니다
4. 상단에 파란색 breadcrumb 바가 나타나며 액션 목록이 표시됩니다

```
← 보고서_최종.xlsx 에 대한 액션 · Esc로 돌아가기
```

### 제공 액션

| 액션 | 설명 |
|------|------|
| 경로 복사 | 파일의 전체 경로를 클립보드에 복사 |
| 파일 탐색기에서 열기 | 탐색기에서 해당 파일을 선택된 상태로 열기 |
| 관리자 권한으로 실행 | UAC 권한 상승 후 실행 (파일에만 표시) |
| 터미널에서 열기 | Windows Terminal 또는 명령 프롬프트로 해당 경로 열기 |

### 돌아가기

- `Esc`: 이전 검색 결과로 복귀 (이전에 입력한 텍스트 자동 복원)
- 액션 선택 후 `Enter`: 액션 실행 후 런처 자동 닫힘

---

## 6. Large Type

선택된 텍스트를 전체 화면으로 크게 표시합니다. 발표, 화면 공유, 빠른 메모 확인에 유용합니다.

### 사용법

1. 결과 목록에서 항목을 선택합니다
2. `Shift+Enter`를 누릅니다
3. 전체 화면 검은 오버레이 위에 텍스트가 크게 표시됩니다

### 표시 내용

| 선택 항목 유형 | Large Type으로 표시되는 내용 |
|--------------|---------------------------|
| 계산기 결과 (`=`) | 계산 결과 숫자 |
| 클립보드 히스토리 (`#`) | 복사된 텍스트 전체 내용 |
| 그 외 모든 항목 | 항목 제목 |

### 닫기

- `Esc` 키
- 화면 아무 곳이나 클릭
- 우상단 `×` 버튼

> **팁**: `=3.14159265`를 계산기로 입력한 뒤 `Shift+Enter`를 누르면 파이 값을 크게 표시할 수 있습니다.

---

## 7. 클립보드 합치기

클립보드 히스토리에서 여러 항목을 골라 한 번에 합쳐서 복사합니다.

### 사용법

1. `#`을 입력해 클립보드 히스토리 모드로 진입합니다
2. `Shift+↓` 또는 `Shift+↑`로 합치고 싶은 항목을 선택합니다
   - 선택할 때마다 하단 힌트 바에 선택 개수가 표시됩니다
   - 같은 키를 다시 누르면 선택이 해제됩니다
3. `Shift+Enter`를 눌러 합치기를 실행합니다
4. 선택한 항목들이 줄바꿈(`\n`)으로 연결되어 클립보드에 복사됩니다

```
예시 결과:
  항목 1: "회의 안건"
  항목 2: "담당자: 홍길동"
  항목 3: "일시: 2026-03-24"

  → 클립보드에 복사되는 내용:
    회의 안건
    담당자: 홍길동
    일시: 2026-03-24
```

### 힌트 바

선택된 항목이 있으면 화면 하단에 보라색 힌트 바가 나타납니다:

```
✓  2개 선택됨  ·  Shift+Enter로 합치기  ·  Esc로 취소
```

### 선택 취소

- `Esc`: 모든 선택을 취소하고 런처 닫기
- 런처를 다시 열면 선택이 초기화됩니다

> **주의**: 클립보드 합치기 선택 항목이 있는 상태에서 `Shift+Enter`를 누르면 Large Type 대신 **합치기**가 실행됩니다.

---

## 8. 설정 변경

`Ctrl+,` 또는 시스템 트레이 → 설정으로 설정 창을 엽니다.

### 일반 탭

#### 글로벌 단축키 변경

현재 등록된 단축키 배지를 클릭하면 녹화 모드로 전환됩니다.

```
[클릭] → 녹화 중... → 원하는 키 조합 입력 → 자동 저장
```

- 최소 하나의 보조 키(`Ctrl`, `Alt`, `Shift`, `Win`)가 포함되어야 합니다
- `Esc`를 누르면 녹화를 취소합니다
- 지원 예시: `Alt+Space`, `Ctrl+Alt+K`, `Win+Space`

#### 기본 검색 엔진

`?` 프리픽스로 검색할 때 사용할 기본 검색 엔진을 선택합니다.

| 옵션 | 검색 엔진 |
|------|---------|
| Google (기본) | www.google.com |
| Naver | search.naver.com |
| DuckDuckGo | duckduckgo.com |
| YouTube | youtube.com |
| Wikipedia | ko.wikipedia.org |

특정 엔진을 직접 지정하려면 `?g 검색어`, `?n 검색어` 형식으로 입력할 수 있습니다.

#### 런처 위치

런처 창이 화면에 나타나는 위치를 선택합니다.

| 옵션 | 위치 |
|------|------|
| 상단 중앙 (기본) | 화면 상단 20% 지점 |
| 정중앙 | 화면 정가운데 |
| 하단 중앙 | 화면 하단 75% 지점 |

#### 최대 결과 수

검색 결과로 표시할 최대 항목 수를 설정합니다 (기본: 7개).

#### 창 투명도

런처 창의 불투명도를 조정합니다 (0.5 ~ 1.0).

### 테마 탭

9가지 내장 테마 중 클릭하면 **즉시 미리보기**가 적용됩니다.
저장하지 않고 닫으면 이전 테마로 자동 복원됩니다.

| 테마 | 특징 |
|------|------|
| System | Windows 다크/라이트 모드 자동 연동 |
| Dark | 기본 다크 모드 — 부드러운 라운딩 |
| Light | 밝은 화이트 테마 |
| OLED | 순수 검정 배경 (OLED 화면 최적화) — 가장 둥근 모양 |
| Nord | 차분한 북유럽 블루 계열 — 약간 각진 느낌 |
| Monokai | 에디터 스타일 컬러 — 직각에 가까운 모양 |
| Catppuccin | 파스텔 톤 — 둥근 모양 |
| Sepia | 따뜻한 베이지 계열 — 클래식한 각진 느낌 |
| Alfred | Alfred 앱 영감 다크 |
| Alfred Light | Alfred 앱 영감 라이트 |
| Custom | 색상 편집 탭에서 직접 지정 |

> 각 테마는 **색상뿐 아니라 창·항목의 모서리 라운딩 비율도 다르게** 설정됩니다. OLED가 가장 둥글고, Monokai·Sepia가 가장 각집니다.

### 스니펫 탭 (`;` 프리픽스)

자주 입력하는 문구를 등록합니다. 런처에서 `;키워드`로 검색 후 `Enter`를 누르면 현재 포커스된 창에 텍스트가 입력됩니다.

#### 글로벌 스니펫 자동 확장

탭 최상단의 토글을 켜면 **런처를 열지 않아도** 모든 앱에서 `;키워드 + Space 또는 Enter`를 입력하는 순간 자동으로 텍스트가 치환됩니다.

```
토글 OFF: 런처에서만 스니펫 사용 가능
토글 ON:  어떤 앱에서든 ;addr + Space → 회사 주소로 자동 치환
```

**동적 변수 사용 가능**:

| 변수 | 치환 내용 |
|------|----------|
| `{date}` | 오늘 날짜 (예: 2026-03-24) |
| `{time}` | 현재 시간 (예: 14:30) |
| `{datetime}` | 날짜+시간 |
| `{year}` / `{month}` / `{day}` | 연/월/일 |

```
예시 스니펫:
  키: sign
  내용: 안녕하세요, {date} 작성한 홍길동입니다.
```

### 클립보드 탭

| 설정 | 설명 |
|------|------|
| 클립보드 히스토리 활성화 | `#` 모드 사용 여부 |
| 최대 보관 개수 | 저장할 히스토리 항목 수 (기본: 50개) |
| 보안 제외 패턴 | 신용카드·주민번호 등 민감 데이터 자동 차단 패턴 |

### 시스템 탭

`/` 프리픽스 시스템 명령의 표시 여부를 항목별로 켜거나 끌 수 있습니다.

### 빠른 실행 탭

키워드 → 파일/URL/폴더 단축키를 추가/삭제합니다.

| 타입 | 예시 |
|------|------|
| 앱 | `vscode` → `C:\...\Code.exe` |
| URL | `gh` → `https://github.com` |
| 폴더 | `dl` → `%USERPROFILE%\Downloads` |

### 배치 명령 탭

`>` 프리픽스 명령 단축키를 관리합니다.

| 항목 | 설명 |
|------|------|
| 키워드 | `>` 이후 입력할 키워드 (예: `build`, `test`) |
| 명령어 | 실행할 PowerShell 또는 cmd 명령어 |
| 창 표시 | 체크 시 터미널 창이 화면에 표시됨 |

```
예시 등록:
  키워드: build   →   dotnet build   (창 표시: ✓)
  키워드: open    →   explorer .     (창 표시: ✗)
```

### 캡처 탭

화면 캡처(`cap`) 기능의 세부 설정을 변경합니다.
캡처 결과는 보안 정책에 따라 **클립보드에만 복사**되며, 파일로 저장하는 기능은 제공하지 않습니다.

| 설정 | 설명 |
|------|------|
| 캡처 프리픽스 | `cap` 대신 사용할 다른 단어를 입력합니다 (예: `sc`, `screenshot`). 변경 후 저장하면 즉시 적용됩니다 |
| 글로벌 캡처 단축키 사용 | 런처를 열지 않고 단축키만으로 바로 캡처합니다 (기본: **비활성화**) |
| 캡처 단축키 | 글로벌 단축키 키 조합 (기본: `PrintScreen`). 클릭 후 원하는 키를 누르면 변경됩니다 |
| 단축키 실행 모드 | 단축키를 눌렀을 때 실행할 캡처 모드 — 전체 화면 / 활성 창 / 영역 선택 |
| 스크롤 캡처 대기 시간 | 스크롤 캡처 시 프레임 간 대기 시간 (80~500ms). 느린 페이지에서 누락이 발생하면 값을 높이세요 |

#### 지연 캡처 (Shift+Enter)

캡처 모드에서 항목을 선택한 상태로 `Shift+Enter`를 누르면 지연 캡처 타이머 선택 화면이 표시됩니다.

1. `cap`을 입력해 캡처 모드로 진입합니다
2. 원하는 캡처 모드(영역 선택, 활성 창, 스크롤, 전체 화면)를 선택합니다
3. `Shift+Enter`를 누르면 타이머 선택 목록(3초/5초/10초)이 표시됩니다
4. 원하는 시간을 선택하고 `Enter`를 누르면 카운트다운 알림 후 캡처가 실행됩니다

> **팁**: 메뉴가 숨겨져야 하는 상황이나 특정 UI 상태를 캡처할 때 유용합니다.

#### 영역 선택 캡처 (cap region) 키보드 미세조정

마우스 드래그로 영역을 선택한 뒤 키보드로 미세 조정할 수 있습니다:

| 키 | 동작 |
|----|------|
| `←` `→` `↑` `↓` | 선택 영역 1px 미세 조정 |
| `Shift+방향키` | 10px 단위 조정 |
| `Enter` | 현재 선택 확정 |
| `Esc` | 취소 |

### 알림 탭

PC 잠금 해제 시 오늘 누적 사용 시간을 알려주는 팝업 기능을 설정합니다.

| 설정 | 설명 |
|------|------|
| 잠금 해제 알림 활성화 | 기능 전체를 켜거나 끕니다 |
| 표시 위치 | 팝업이 나타날 화면 모서리를 선택합니다 (우하단/좌하단/우상단/좌상단) |
| 표시 간격 | 알림을 너무 자주 표시하지 않도록 최소 간격을 설정합니다 (30분/1시간/2시간/4시간) |
| 자동 닫힘 | 팝업이 자동으로 닫히기까지의 시간을 설정합니다 (5~30초) |

### 설정 내보내기 / 불러오기

설정 창 하단 좌측의 **내보내기** / **불러오기** 버튼으로 설정을 공유할 수 있습니다.

| 기능 | 설명 |
|------|------|
| 내보내기 | 현재 settings.json을 `.axsettings` 파일로 저장 |
| 불러오기 | `.axsettings` 파일에서 설정을 덮어쓰기 (앱 재시작 필요) |

> 동료에게 설정 파일을 공유하면 동일한 단축키, 스니펫, 별칭을 즉시 사용할 수 있습니다.

### 예약어 충돌 방지

캡처 프리픽스, 빠른 실행 키워드, 배치 명령 키워드가 시스템 예약어(=, ?, #, $, ;, help, cap 등)와 충돌하면 **저장이 거부되고 알림 팝업**이 표시됩니다.

### Windows 시작 시 자동 실행

트레이 아이콘 우클릭 → **Windows 시작 시 자동 실행** 항목을 체크/해제합니다.

- 체크 시: Windows 로그인할 때마다 AX Commander가 자동으로 시작됩니다
- 해제 시: 수동으로 EXE를 실행해야 합니다
- 설정은 Windows 레지스트리(`HKCU\...\Run`)에 저장되며 관리자 권한이 필요하지 않습니다

### 정보 창

트레이 아이콘 우클릭 → **정보**를 클릭하면 개발자 정보와 버전을 확인할 수 있습니다.

- 상단에 **다이아몬드 픽셀 보석** 앱 아이콘이 표시됩니다 (Blue/Green/Red/Green 4색 보석 컷 디자인)
- 개발자 이름을 클릭하면 마스코트 이미지가 오버레이로 표시됩니다

---

## 9. 잠금 해제 사용시간 알림

PC 잠금을 해제할 때 오늘 하루 누적 사용 시간을 작은 팝업으로 알려주는 기능입니다.

### 팝업 내용

```
┌─────────────────────────────────┐
│  오늘 누적 사용 시간              │
│         3시간 42분              │
│                                 │
│  "삶이란 자전거를 타는 것과 같다.  │
│  계속 움직여야 균형을 잡을 수 있다" │
│                       — 아인슈타인│
└─────────────────────────────────┘
```

- 매번 잠금 해제 시 표시되는 것이 아니라, **설정한 간격 이상** 시간이 지난 경우에만 나타납니다
- 팝업은 런처와 완전히 별개로 동작하며 포커스를 빼앗지 않습니다
- 클릭하거나 설정한 시간이 지나면 자동으로 닫힙니다

### 활성화 방법

`설정(Ctrl+,)` → **알림 탭** → "잠금 해제 알림 활성화" 토글을 켭니다.

### 팝업 위치 설정

| 옵션 | 위치 |
|------|------|
| 우하단 (기본) | 화면 오른쪽 아래 모서리 |
| 좌하단 | 화면 왼쪽 아래 모서리 |
| 우상단 | 화면 오른쪽 위 모서리 |
| 좌상단 | 화면 왼쪽 위 모서리 |

---

## 10. 전체 키보드 단축키 표

### 런처 창

| 단축키 | 동작 |
|--------|------|
| `Alt+Space` | 런처 열기 / 닫기 (기본, 변경 가능) |
| `↑` / `↓` | 결과 목록 위아래 이동 |
| `Enter` | 선택 항목 실행 |
| `Shift+Enter` | Large Type 표시 / 병합 대기 항목 있으면 합치기 실행 / 캡처 모드에서는 지연 캡처(3초/5초/10초) 타이머 선택 |
| `→` | 파일 액션 서브메뉴 진입 (커서가 텍스트 끝에 있을 때) |
| `Shift+↓` | 현재 항목 병합 선택/해제 후 다음 항목으로 이동 |
| `Shift+↑` | 현재 항목 병합 선택/해제 후 이전 항목으로 이동 |
| `Tab` | 선택 항목 제목을 입력창에 자동완성 |
| `Esc` | 액션 서브메뉴 중이면 이전으로 / 아니면 런처 닫기 |
| `Ctrl+,` | 설정 창 열기 |

### Large Type 창

| 단축키 | 동작 |
|--------|------|
| `Esc` | 닫기 |
| 마우스 클릭 | 닫기 |

---

## 11. 자주 묻는 질문

**Q. 단축키를 눌러도 런처가 열리지 않습니다.**

다른 프로그램이 같은 단축키를 사용하고 있을 수 있습니다. 트레이 아이콘에 경고 알림이 표시됩니다. 설정(`Ctrl+,`) → 일반 탭에서 단축키를 변경하세요.

---

**Q. 검색해도 파일이 나오지 않습니다.**

파일이 인덱스 경로에 포함되어 있지 않을 수 있습니다. 설정 → 일반 탭에서 인덱스 경로를 추가하세요 (기본: 바탕화면, 시작 메뉴).

또한 해당 파일의 확장자가 검색 확장자 목록에 포함되어야 합니다. 설정 → 일반 탭 하단의 **검색할 확장자** 섹션에서 확장자를 추가할 수 있습니다. 기본값에는 실행 파일, 문서, 이미지, 텍스트 파일이 포함되어 있습니다. 폴더도 검색 가능하며 Enter로 탐색기에서 열 수 있습니다.

인덱스는 앱 시작 시 자동으로 빌드되며, 이후 파일/폴더 변경을 감지해 자동 갱신됩니다. 설정 저장 시 인덱스가 재빌드되며 프로그레스바가 표시됩니다.

---

**Q. 클립보드 히스토리(`#`)에 내용이 보이지 않습니다.**

설정 → 클립보드 탭에서 "클립보드 히스토리 활성화"가 켜져 있는지 확인하세요. 또한 복사한 내용이 보안 제외 패턴(신용카드 번호 등)에 해당하면 자동으로 저장되지 않습니다.

> **보안 참고**: 클립보드 히스토리는 Windows DPAPI 암호화로 저장됩니다. 현재 Windows 사용자 계정에서만 복호화할 수 있으며, 다른 사용자나 PC에서는 파일을 열어도 내용을 볼 수 없습니다.

---

**Q. 계산기(`=`)에서 어떤 수식을 사용할 수 있나요?**

| 종류 | 예시 |
|------|------|
| 기본 연산 | `=100*12+50` |
| 거듭제곱 | `=2^10` |
| 나머지 | `=17%5` |
| 수학 함수 | `=sqrt(144)`, `=sin(pi/2)` |
| 로그 | `=log(1000)`, `=ln(e)` |
| 상수 | `pi`, `e` |
| 16진수 | `=0xFF+1` |
| 과학적 표기 | `=1.5e3*2` |
| 단위 변환 | `=100km in miles`, `=32f in c`, `=5lb to kg` |
| 통화 변환 | `=100 USD to KRW`, `=50 EUR in JPY` (실시간 환율) |

---

**Q. 타이머는 어떻게 사용하나요?**

`/` 프리픽스를 사용합니다:

| 입력 | 동작 |
|------|------|
| `/timer 5m` | 5분 후 트레이 알림 |
| `/timer 1h30m` | 1시간 30분 후 알림 |
| `/timer 30s 회의 준비` | 30초 후 "회의 준비" 알림 |
| `/alarm 14:30` | 오후 2시 30분에 알림 (지나면 다음날로 자동 설정) |

Enter로 시작하면 백그라운드에서 카운트가 진행되고, 완료 시 트레이 아이콘에서 풍선 알림이 나타납니다.

---

**Q. 이모지를 빠르게 복사하려면?**

`emoji` 를 입력한 뒤 검색어를 입력하세요:

```
emoji 하트   →  ❤️ 빨간 하트, 🧡 주황 하트, 💜 보라 하트 …
emoji 웃음   →  😀 😂 🤣 …
emoji thumbs →  👍 👎
emoji        →  자주 쓰는 이모지 30개 기본 표시
```

Enter를 누르면 해당 이모지가 클립보드에 복사됩니다.

---

**Q. `→` 키를 눌러도 액션 메뉴가 열리지 않습니다.**

두 가지 조건을 모두 충족해야 합니다:
1. 검색 결과 중 파일 또는 앱 항목이 선택되어 있어야 합니다 (URL, 스니펫, 계산기 결과 불가)
2. 입력 커서가 텍스트의 **맨 끝**에 위치해 있어야 합니다 (`End` 키로 이동 후 시도)

---

**Q. 플러그인을 추가하려면 어떻게 하나요?**

DLL 플러그인은 `IActionHandler` 인터페이스를 구현한 후 트레이 → 설정 → (settings.json의 `plugins` 배열)에 경로를 등록합니다. 등록 후 트레이 → 플러그인 재로드를 클릭하면 즉시 적용됩니다.

---

**Q. `cap` 명령어를 다른 이름으로 바꾸려면?**

설정(`Ctrl+,`) → **캡처 탭** → "캡처 프리픽스" 입력란에 원하는 단어를 입력한 뒤 저장합니다. 예) `sc` → `sc screen`, `sc window`.

---

**Q. 잠금 해제 알림이 너무 자주 나타납니다.**

설정(`Ctrl+,`) → **알림 탭** → "표시 간격"을 더 긴 시간(2시간 또는 4시간)으로 변경하세요.

---

**Q. `*` 입력이 `info`와 같은 건가요?**

네, `*` 단독 입력 또는 `* ip`, `* battery`처럼 사용하면 `info`, `info ip`와 완전히 동일하게 동작합니다.

---

**Q. `help`는 어떻게 사용하나요?**

- `help` → 전체 기능 목록 창 열기
- `help 계산` → 계산 관련 명령어만 필터
- `help clip` → 클립보드 관련 명령어만 필터
- 항목 선택 후 `Enter` → 해당 예시를 클립보드에 복사

---

**Q. 설정이나 히스토리 파일은 어디에 저장되나요?**

모든 데이터는 `%APPDATA%\AxCommander\` 폴더에 저장됩니다. EXE 파일 옆에는 아무것도 생성되지 않으므로 USB나 네트워크 드라이브에서 실행해도 깨끗합니다.

| 파일 | 설명 | 자동 삭제 |
|------|------|----------|
| `settings.json` | 전체 설정 | 수동 |
| `clipboard_history.dat` | 클립보드 히스토리 (DPAPI 암호화) | 최대 개수 제한 |
| `logs/app-*.log` | 일별 로그 | **14일** 후 자동 삭제 |
| `stats/*.json` | 일별 사용 통계 | **30일** 후 자동 삭제 |
| `favorites.json` | 즐겨찾기 | 수동 |
| `routines.json` | 루틴 정의 | 수동 |
| `notes.txt` | 빠른 메모 | 수동 (`note clear`로 삭제) |

---

*AX Commander — 사내 전용 프로그램*
