按键配置

[keys] 域收纳输入法的全部按键绑定：中英切换键、引擎切换与状态切换快捷键、候选选择/翻页/高亮/以词定字键组、功能快捷键，以及全局热键。该域是扁平结构——除无效按键策略下沉到 [keys.overflow] 一层子表外，其余字段都直接挂在 [keys] 下。

字段分两类：

• 热键字符串（如 switch_engine）：单个组合键，格式见下方"热键字符串格式"。
• 键组数组（如 page_keys）：值不是键名而是键组常量（一个常量代表一对物理按键），可多选、以数组给出。每个这类字段下方都附一张"可选值 → 物理按键"对照表。

热键字符串格式

热键字符串由修饰键 + + + 主键组成，大小写不敏感、可含空格。

• 修饰键：ctrl（= control）、shift、alt、win（= super）。
• 主键：字母 a–z；数字 0–9；功能键 f1–f12；space / enter / tab / esc / backspace / delete / home / end / pageup / pagedown / 方向键 up/down/left/right；标点符号可用符号本身或英文名，如 .（= period）、,（= comma）、;（= semicolon）、'（= quote）、/（= slash）、\（= backslash）、[（= lbracket）、]（= rbracket）、-（= minus）、=（= equal）、`（= grave）。
• 空串或 none 表示不绑定该功能。
• 只允许一个主键；写多个主键会被判为无效并忽略。

中英切换

[keys]
toggle_mode_keys = ["lshift", "rshift"]  # 中英切换键（键松开时触发）
commit_on_switch = true                  # 切到英文时是否上屏未完成的组合

toggle_mode_keys 可选值对照：

状态切换快捷键

[keys]
switch_engine = "ctrl+shift+e"    # 循环切换输入方案
toggle_full_width = "shift+space" # 全角/半角切换
toggle_punct = "ctrl+."           # 中文/英文标点切换
toggle_s2t = "ctrl+shift+j"       # 简体/繁体输出切换

方案直达热键

switch_engine 是循环切换，方案多了就要按好几次。schema_hotkeys 给单个方案绑一个键，按下直接切过去：

[keys]
schema_hotkeys = { english = "ctrl+shift+n", wubi86 = "ctrl+shift+w" }

key 是方案 id（与 [schema].available 里的写法一致），value 是热键字符串。设置工具里的位置：方案 → 输入方案 → 选中方案 → 设置 → 进入方式。

行为与 switch_engine 完全一致——同样遵循「切换时是否上屏」，同样把选择持久化到 schema.active。两种模式下都生效，这一点和其它中文态专属的快捷键不同：切到英文方案之后，还得能按键切回来。

指向不存在或未启用方案的条目会被安静忽略，不影响其它绑定；目标方案正在后台预热时提示「准备中…」并保持当前方案不变。

功能快捷键

[keys]
toggle_toolbar = 'ctrl+shift+\'       # 显示/隐藏工具栏
open_settings = "ctrl+shift+]"        # 打开设置工具
add_word = "ctrl+equal"               # 就地加词（从当前组合造词）
open_add_word_dialog = "ctrl+shift+equal" # 打开加词小窗
activate_ime = "ctrl+shift+["         # 切换到本输入法（系统级）

[keys]
take_screenshot = "ctrl+shift+f11"  # 隐藏字段，设置界面无对应项

候选置顶与删除

[keys]
pin_candidate = "ctrl+number"           # 置顶候选（Ctrl+数字）
delete_candidate = "ctrl+shift+number"  # 删除候选（Ctrl+Shift+数字）

候选选择键组

[keys]
select_key_groups = ["semicolon_quote"]  # 次选/三选键组

select_key_groups 可选值对照：

翻页与高亮导航

[keys]
page_keys = ["pageupdown", "minus_equal"]  # 候选翻页键组
highlight_keys = ["arrows", "tab"]         # 候选高亮移动键组

page_keys 可选值对照：

highlight_keys 可选值对照：

以词定字

[keys]
select_char_keys = []  # 以词定字键组，默认禁用

select_char_keys 可选值对照：

全局热键

[keys]
global_hotkeys = []  # 提升为系统级全局热键的动作名列表

global_hotkeys 支持的动作名：

无效按键策略（keys.overflow）

当按下选择/翻页/以词定字类按键，但候选数量或词长不足以命中目标位次时的处理方式。三项共用同一套枚举。

[keys.overflow]
number_key = "ignore"       # 数字键超出当前页候选数量时
select_key = "ignore"       # 次选/三选键候选不足时
select_char_key = "ignore"  # 以词定字键候选词长度不足时

枚举取值行为：

相关阅读

• 配置文件与数据目录 — 三层合并、diff 保存与手工编辑
• 快捷键 — 图形界面下的按键设置
• 命令直通车 — 用 config.set / config.get 读写配置项