# 按键配置
#### 自定义按键映射
```
runtime:
  keyboard_control:
    enabled: true
    keymap:
      "j": go_home         # j → go_home
      "s": state           # s → get_state
      "r": home_ready      # r → 另一个命令实例
```
#### 禁用默认按键
```
keymap:
  "h": ""                 # 禁用默认的 h → go_home
```
**保留键（空格和q）不可禁用或重映射**，配置中尝试操作会报错
```
ValueError: key 'q' is reserved (graceful_stop) and cannot be remapped or disabled.
```
#### Merge语义
自定义keymap**合并**到默认键之上，未提到的键保持默认行为。
例如：
```
keymap:
  "j": go_home
```
空格、h、q仍然有效，只有j被新增。
#### 大小写规则
单字母按键先精确匹配，失败后对调大小写再试：
| 配置                   | 按键         | 结果           |
|:---|:---|:---|
| ``` "j": go_home ``` | j          | 触发           |
| ``` "j": go_home ``` | J（Shift+J） | 触发（fallback） |
| ``` "J": go_home ``` | j          | 触发（fallback） |
| 多字符键                 | ---        | 不适用fallback  |