按键配置

[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"       # 简体/繁体输出切换
toggle_t2s = "none"               # 繁入简出开关，出厂不绑

方案直达热键

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

[keys.key_actions]
"ctrl+shift+w" = "switch_schema:wubi86"   # 单向：切过去就完了
"ctrl+shift+n" = "toggle_schema:english"  # 往返：再按一次回到原来那个方案

设置工具里的位置：方案 → 输入方案 → 选中方案 → 设置 → 进入方式 → 直达热键（写的是 switch_schema:）。

行为与 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 切英文方案，再敲回来

动词值域：

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

键的形态决定走哪条通路

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

组合键能配的功能与单键一样多 0.122 新增

组合键接受本表的全部动词——包括 toggle_mode（中英文切换）、temp_pinyin、mix:、single_char 这些以前只有单键能配的。想把中英文切换配成 Ctrl+Space 这类组合键，现在可以了。

在此之前组合键只认 toggle_schema:、switch_schema:、special:、rare_char、softkeyboard 五类，其余动词配上去会被整条丢弃、只在日志里告警一句。那是历史遗留而非设计限制：组合键这条通路本就不与输入争键、可全局拦截，限制反倒最少才对。

唯二配不了的是 add_word 与 open_add_word_dialog：它们要接管后续的全部按键，请到功能快捷键里设置。

方案级覆盖

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

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

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

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

会话态按键功能表（session_actions） 0.115 新增

key_actions 给一个键指定功能（进模式、切方案、切状态）；session_actions 管的是「正在打字（有编码或候选）时这个键干什么」。两张表，同一个键在两处可以是两个动作——Tab 打字时翻页、没在打字时仍是宿主的制表符。

[keys]
session_actions = {}   # 出厂为空；例：{ tab = "page_next", "shift+tab" = "page_prev" }

• 键名：tab / shift+tab / capslock / pageup / pagedown / up / down / left / right / home / end，以及符号键 minus、equal、lbracket、rbracket、comma、period、semicolon、quote 等；字母只收 z 0.118 新增。只认 shift+ 一种前缀；带 Ctrl / Alt 的组合键请写在上面的 key_actions 里。
• 动词：page_prev / page_next（翻页）、highlight_up / highlight_down（高亮移动）、cancel（放弃当前输入，等同 Esc；别名 clear）、none（在打字态禁用该键）、select_candidate:N（选中当前页第 N 个候选，N 从 1 起，2 即次选键）、select_char:N（以词定字，取高亮候选词的第 N 个字）。两个 N 的取值范围都是 1–9。此外还有 aux_code 0.118 新增（进辅助码筛选）——它同时也是 key_actions 的动词，两处通向同一个功能，差别只在哪些键名解析得出来：本表认得 tab / pagedown / 方向键，key_actions 只认符号键、字母 z 与四个修饰键。
• single_char 0.121 新增：开关单字输入，动词与 key_actions 那份完全一样（single_char:on / :off / :toggle / :follow）。按下即开关并就地重出候选，不会把正在打的码上屏。写在本表意味着「只在打字时管用」——绑在 Tab 上，没打字时 Tab 仍是宿主的制表符。
• 与翻页共用一个键：写 aux_code:page_next 0.118 新增，能进辅助码就进、进不去就翻下一页。于是 tab = "aux_code:page_next" 一键两用：第一次按进筛选，之后按继续翻页；辅助码没开、方案没配码表时它就是个纯翻页键，空闲无候选时仍原样交还给应用。这个形态只有本表有——key_actions 解析不出翻页键。

本表与下面的 page_keys / highlight_keys / select_key_groups / select_char_keys 各自独立保存，运行时才合并（本表写了的键优先）——改一处不会动到另一处。出厂默认留在那四项里，这样把它们清成 [] 就真的能关掉对应功能。撞键时按消费顺序裁决：以词定字 > 翻页 / 高亮 > 二三候选。

方案级覆盖 0.118 新增

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

# 某个特殊语系的方案
[session_actions]
lbracket = "page_prev"    # 本方案改用方括号翻页
rbracket = "page_next"
tab = "none"              # 本方案关掉全局配的 Tab

与 [key_actions] 的覆盖规则完全一致：深合并，只能新增或改写。要在某个方案里关掉一个全局绑定，写显式的 "none"——从覆盖文件里删掉那一行只是回到继承全局，不是禁用。

方案没写的键照常继承全局那份（含 page_keys 等四项折算出来的默认值）。

功能快捷键

[keys]
toggle_toolbar = 'ctrl+shift+\'       # 显示/隐藏工具栏
softkeyboard = "ctrl+shift+k"         # 显示/隐藏软键盘
open_settings = "ctrl+shift+]"        # 打开设置工具
add_word = "ctrl+equal"               # 就地加词（从当前组合造词）
open_add_word_dialog = "ctrl+shift+equal" # 打开加词小窗
activate_ime = "ctrl+shift+["         # 切换到本输入法（系统级）
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 读写配置项