按键配置

[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。两种模式下都生效，这一点和其它中文态专属的快捷键不同：切到英文方案之后，还得能按键切回来。

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

按键功能表（key_actions）0.115 新增

上面那批热键是「一个功能一个字段」。key_actions 是通用的「键 → 干什么」表：左边任意键名，右边一个动词。引导键、临时模式入口、方案往返键都统一住在这里。

[keys.key_actions]
backslash = "special:quick_symbols"       # \ 进快符
backtick = "temp_pinyin"                  # ` 进临时拼音
semicolon = "mix:quick_mix"               # ; 进快捷输入
"ctrl+shift+u" = "special:quick_symbols"  # 快符的直达热键
rshift = "toggle_schema:english"          # 轻敲右 Shift 切英文方案，再敲回来

动词值域：

写错的动词会被整条丢弃并在日志里告警，不会静默变成别的功能。

键的形态决定走哪条通路

同一张表里的条目按键的形态自动分流，不由动词决定，也不需要你指定：

方案级覆盖

方案文件（或 schema_overrides\<方案ID>.toml）也能写一份 [key_actions]，只在该方案作当前方案时生效，逐键覆盖全局那份：

# wubi86.schema.toml
[key_actions]
z = "temp_pinyin"       # 五笔里借 z 打拼音
backslash = "none"      # 本方案关掉全局配的 \ 引导键

字母键只能按方案配，不能写进全局表：字母天然是编码键，能不能借用取决于这张码表里它是不是死码。全局表里配字母就成了无条件抢键，那个字母在所有方案里都打不出编码了。

要在某个方案里关掉一个全局绑定，写显式的 "none"。覆盖是深合并，只能新增或改写——从覆盖文件里删掉一行是删不掉全局那条的。

功能快捷键

[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 读写配置项