Skip to content
Merged
6 changes: 6 additions & 0 deletions README.ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,12 @@ $ hanfix dkssudgktpdy

![hanfix demo](assets/demo.gif)

## 동작 과정 한눈에 보기

![한글 자판으로 잘못 입력한 ㅣㄴ -ㅁ 명령을 hf 또는 ㅗㄹ로 ls -a로 복구하고, Enter 실행 또는 Ctrl+C 취소를 선택하는 터미널 모의 그림](assets/keyboard-recovery-ko.svg)

[그림을 크게 보기](assets/keyboard-recovery-ko.svg) · **설명용 모의 화면**이며 실제 실행 화면을 촬영한 것은 아닙니다. `hf`는 키 입력을 감시하지 않고 셸의 직전 명령 기록을 읽습니다.

```console
$ ㅣㄴ -ㅁ
bash: ㅣㄴ: command not found
Expand Down
30 changes: 2 additions & 28 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,35 +92,9 @@ you press Enter. It works on Linux, macOS and Windows, with bash, zsh, fish and

## How the correction works

The following is an **illustrative terminal interaction**, not a screenshot or a recorded run. `hf` reads the previous command from your shell history; it does not monitor your keystrokes.

```text
Korean keyboard layout is still active
┌───────────────────────────────────────┐
│ $ ㅣㄴ -ㅁ │
│ bash: ㅣㄴ: command not found │
└───────────────────────────────────────┘
│
▼
┌───────────────────────────────────────┐
│ $ ㅗㄹ │
│ ls -a [Enter / Ctrl+C] │
└───────────────────────────────────────┘
│ │
Enter Ctrl+C
▼ ▼
Run corrected Cancel without
command running it
```
![Mobile-friendly mock terminal: a mistyped Korean-layout command is recovered as ls -a, then Enter executes or Ctrl+C cancels.](assets/keyboard-recovery-en.svg)

```mermaid
flowchart LR
A["Previous shell command"] --> B["hf / ㅗㄹ"]
B --> C["Map Korean 2-set keys to QWERTY"]
C --> D{"Confirm?"}
D -->|Enter| E["Execute corrected command"]
D -->|Ctrl+C| F["Cancel"]
```
[View the full-size diagram](assets/keyboard-recovery-en.svg). This is a **mock terminal**, not a screenshot or recorded run. `hf` reads the previous command from your shell history; it does not monitor keystrokes.

**Important:** `hf -y` skips confirmation. Use the normal `hf` first when the corrected command could modify files.

Expand Down
1 change: 1 addition & 0 deletions assets/keyboard-recovery-en.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions assets/keyboard-recovery-ko.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading