Add YOLO as alias for SWITCH key

- Add YOLO alias that maps to SWITCH in keymap command
- Update README and Chinese docs to reflect YOLO/Switch key

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: L-jasmine

README.md

@@ -38,9 +38,9 @@ Configures one key at a time. The device merges it into the existing keymap.
 | `MIC` | Microphone key |
 | `CUSTOM` | Custom key |
 | `ESC` | Escape key |
-| `GUI` | GUI key |
+| `NEXT` | Next key |
 | `BACKSPACE` | Backspace key |
-| `SWITCH` | Switch key |
+| `YOLO` / `Switch` | Yolo key |
 | `ACCEPT` | Accept key |
 | `ROTATE` | Rotate key |
 
@@ -55,12 +55,12 @@ Maps a key to a keyboard shortcut.
 ```bash
 # Single key
 vibekeys keymap ESC A          # Map to A key
-vibekeys keymap GUI 1          # Map to digit 1
+vibekeys keymap NEXT 1         # Map to digit 1
 
 # With modifiers
 vibekeys keymap ESC Ctrl+C     # Map to Ctrl+C
 vibekeys keymap CUSTOM Alt+Tab # Map to Alt+Tab
-vibekeys keymap GUI Shift+A    # Map to Shift+A
+vibekeys keymap NEXT Shift+A    # Map to Shift+A
 
 # Supported modifiers
 # Ctrl, Alt, Shift, Meta, Win, Cmd
@@ -122,8 +122,8 @@ vibekeys keymap MIC '"I am using Claude Code"'
 # ESC key → Ctrl+C interrupt
 vibekeys keymap ESC Ctrl+C
 
-# GUI key → open command palette
-vibekeys keymap GUI Ctrl+Shift+P
+# NEXT key → open command palette
+vibekeys keymap NEXT Ctrl+Shift+P
 
 # CUSTOM key → Alt+Tab switch window
 vibekeys keymap CUSTOM Alt+Tab

docs/README.zh.md

@@ -36,9 +36,9 @@ vibekeys keymap <KEY> <BINDING>
 | `MIC` | 麦克风键 |
 | `CUSTOM` | 自定义键 |
 | `ESC` | Escape 键 |
-| `GUI` | GUI 键 |
+| `NEXT` | Next 键 |
 | `BACKSPACE` | 退格键 |
-| `SWITCH` | 切换键 |
+| `YOLO` / `Switch` | Yolo 键 |
 | `ACCEPT` | 确认键 |
 | `ROTATE` | 旋转键 |
 
@@ -53,12 +53,12 @@ vibekeys keymap <KEY> <BINDING>
 ```bash
 # 单个按键
 vibekeys keymap ESC A          # 映射为 A 键
-vibekeys keymap GUI 1          # 映射为数字 1
+vibekeys keymap NEXT 1         # 映射为数字 1
 
 # 带修饰键的组合
 vibekeys keymap ESC Ctrl+C     # 映射为 Ctrl+C
 vibekeys keymap CUSTOM Alt+Tab # 映射为 Alt+Tab
-vibekeys keymap GUI Shift+A    # 映射为 Shift+A
+vibekeys keymap NEXT Shift+A   # 映射为 Shift+A
 
 # 支持的修饰键
 # Ctrl, Alt, Shift, Meta, Win, Cmd
@@ -120,8 +120,8 @@ vibekeys keymap MIC '"I am using Claude Code"'
 # ESC 键 → Ctrl+C 中断
 vibekeys keymap ESC Ctrl+C
 
-# GUI 键 → 打开命令面板
-vibekeys keymap GUI Ctrl+Shift+P
+# NEXT 键 → 打开命令面板
+vibekeys keymap NEXT Ctrl+Shift+P
 
 # CUSTOM 键 → Alt+Tab 切换窗口
 vibekeys keymap CUSTOM Alt+Tab

src/main.rs

@@ -27,7 +27,7 @@ enum Command {
     },
     /// Configure key mapping (merged, can be done one key at a time)
     Keymap {
-        /// Key name (MIC, CUSTOM, ESC, GUI, BACKSPACE, SWITCH, ACCEPT, ROTATE)
+        /// Key name (MIC, CUSTOM, ESC, NEXT, BACKSPACE, SWITCH, ACCEPT, ROTATE)
         key: String,
         /// Key binding (e.g., "A", "Ctrl+C", Alt+Tab", "\"text\"")
         binding: String,
@@ -180,7 +180,7 @@ fn truncate(s: &str, max_len: usize) -> String {
 async fn send_keymap(key: &str, binding: &str) -> anyhow::Result<()> {
     let key_upper = key.to_uppercase();
 
-    // Validate key name
+    // Validate key name (before alias mapping)
     let valid_keys = [
         "MIC",
         "CUSTOM",
@@ -190,13 +190,21 @@ async fn send_keymap(key: &str, binding: &str) -> anyhow::Result<()> {
         "SWITCH",
         "ACCEPT",
         "ROTATE",
+        "YOLO", // alias for SWITCH
     ];
     if !valid_keys.contains(&key_upper.as_str()) {
         anyhow::bail!("Invalid key name. Valid keys: {}", valid_keys.join(", "));
     }
 
+    // Map aliases to actual key names
+    let key_mapped = match key_upper.as_str() {
+        "YOLO" => "SWITCH".to_string(),
+        _ => key_upper,
+    };
+
+    // Use the mapped key name for the config
     let parsed = parse_key_binding(binding);
-    let config = serde_json::json!({ key_upper: parsed });
+    let config = serde_json::json!({ key_mapped: parsed });
     let json_str = config.to_string();
     info!("Sending keymap: {}", json_str);