# ⚡ QuickCmd (초경량 스마트 상용구 자동치환 프로그램)

[![최신 릴리즈 다운로드 (ZIP)](https://img.shields.io/badge/%F0%9F%93%A5_%EC%B5%9C%EC%8B%A0_%EB%A6%B4%EB%A6%AC%EC%A6%88_%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C-QuickCmd__v0.4.zip-2563eb?style=flat-square)](https://git.focskh.duckdns.org/focskh/quick_cmd/releases/download/v0.4/QuickCmd_v0.4.zip)
[![단일 실행 파일 다운로드 (EXE)](https://img.shields.io/badge/%F0%9F%9A%80_%EB%8B%A8%EC%9D%BC_%EC%8B%A4%ED%96%89_%ED%8C%8C%EC%9D%BC-QuickCmd.exe-10b981?style=flat-square)](https://git.focskh.duckdns.org/focskh/quick_cmd/releases/download/v0.4/QuickCmd.exe)
[![Version](https://img.shields.io/badge/Version-v0.4-8b5cf6?style=flat-square)](https://git.focskh.duckdns.org/focskh/quick_cmd/releases/tag/v0.4)

---

## 📌 프로그램 개요

- **프로그램명**: QuickCmd (초경량 스마트 상용구 자동치환 프로그램)
- **현재 버전**: v0.4
- **제작자**: 김기환 (Kim Ki Hwan)
- **실행 환경**: Windows 10 / Windows 11 (64-bit, 별도 런타임 설치 불필요 포터블 단일 `.exe`)

![QuickCmd 메인 화면](assets/screenshot_main.png)

---

## 📥 다운로드 및 설치 방법

별도의 설치 과정이나 외부 런타임(.NET, Python, Visual C++ 재배포 패키지 등)이 전혀 필요하지 않은 **포터블(Portable) 프로그램**입니다.

### 1. 다운로드
- **[📦 QuickCmd_v0.4.zip 다운로드 (실행 파일 + 변경 내역 포함)](https://git.focskh.duckdns.org/focskh/quick_cmd/releases/download/v0.4/QuickCmd_v0.4.zip)**
- **[⚡ QuickCmd.exe 단독 다운로드 (366 KB)](https://git.focskh.duckdns.org/focskh/quick_cmd/releases/download/v0.4/QuickCmd.exe)**
- 또는 우측/상단의 **[릴리즈 (Releases)](https://git.focskh.duckdns.org/focskh/quick_cmd/releases/tag/v0.4)** 탭에서 다운로드하실 수 있습니다.

### 2. 실행 방법
1. 원하는 폴더에 `QuickCmd.exe`를 위치시키고 실행합니다.
2. 상단 입력란에 **`입력할 문구 (A)`**(예: `!회사메일`)와 **`변환될 문구 (B)`**(예: `example@company.co.kr`)를 입력하고 **`[+ 추가]`** 버튼을 클릭합니다.
3. **`[🔒 리스트 암호화 저장]`** 버튼을 눌러 원하는 파일명(`.qvault`)과 비밀번호를 설정해 저장하면 즉시 실시간 치환이 적용됩니다.

---

## ✨ 주요 기능

### 1. 지연 시간 0ms의 즉시 상용구 자동치환 (`A → B`)
- 메모장, 웹 브라우저, 메신저, 오피스, IDE 등 **윈도우의 모든 프로그램**에서 지정한 단축어(`A`)를 타이핑하는 즉시 목표 문구(`B`)로 자동 변환됩니다.
- **한글 두벌식 자소 분해 및 IME 조합 확정 엔진**이 내장되어 있어 한글/영문/특수문자 단축어 모두 오작동이나 글자 깨짐 없이 깔끔하게 치환됩니다.
- v0.4부터 주기적 워킹셋 페이지아웃 타이머와 마우스 훅을 제거하여 **일반 타이핑 시 키 입력 지연 현상이 전혀 발생하지 않습니다 (Zero Keystroke Lag).**

### 2. 군사급 리스트 암호화 저장 및 복원 (`AES-256 + PBKDF2`)
- 상용구 리스트를 일반 텍스트로 노출하지 않고 **PBKDF2-HMAC-SHA256 (600,000회 키 파생) + 256비트 난수 Salt + AES-256-CBC + HMAC-SHA256 무결성 검증**으로 암호화하여 `.qvault` 파일로 저장합니다.
- 프로그램을 껐다 켜도 직전에 사용한 리스트가 자동으로 복원되며, **`[📂 리스트 불러오기]`**를 통해 다른 `.qvault` 파일을 비밀번호로 복호화하여 불러올 수 있습니다.

### 3. 시스템 트레이 상주 및 윈도우 시작프로그램 등록
- 우측 상단 **`[⚙ 설정]`** 버튼(또는 트레이 아이콘 우클릭 → `설정`)에서 **`윈도우 시작프로그램에 등록`**을 체크하면 부팅 시 트레이로 조용히 자동 실행됩니다.
- 창의 `✕` 버튼을 눌러도 종료되지 않고 시스템 트레이에 상주하며, **트레이 아이콘 우클릭 → `[종료 (Exit)]`** 선택 시에만 완전히 종료됩니다.

### 4. 초경량 네이티브 C++17 설계
- 단일 실행 파일 크기 약 **374 KB (`382,976 bytes`)**, 백그라운드 동작 시 CPU 점유율 **0%**, 메모리 점유율 **약 1~2 MB** 수준의 극한 경량화를 달성했습니다.

---

## 📋 버전 히스토리 요약 (v0.4)

- **v0.4 (2026-11-06)**: 간헐적 키 입력 지연(Keystroke Lag) 현상 완벽 제거 (`EmptyWorkingSet` 타이머 제거, `WH_MOUSE_LL` 제거, `GetAsyncKeyState` 커널 콜 제거)
- **v0.3 (2026-11-03)**: 환경 설정 모달 창 및 윈도우 시작프로그램 등록/해제 기능 추가, 상단 타이틀바 1열 정렬 및 파일 표시줄 분리
- **v0.2 (2026-11-02)**: 사용자 지정 경로/파일명(`.qvault`) 암호화 저장 및 불러오기, 프리미엄 블랙 테마 및 프레임리스 커스텀 UI 적용
- **v0.1 (2026-11-02)**: 최초 릴리즈 (한글/영문 즉시 치환 엔진, AES-256 암호화 보관함, 시스템 트레이 상주)

> 전체 상세 변경 내역은 [HISTORY.md](HISTORY.md)에서 확인하실 수 있습니다.