键盘导航
OINK 的交互式页面自带一套单键快捷键：WASD 在侧栏树中移动，J K 在标题间跳转，Q E 翻页，另有几个单键切换主题、语言与命令面板。默认开启，所有绑定都给输入让行，可以按站点或按页面关闭。
键盘导航不维护第二套状态：树的展开折叠复用侧栏原有的箭头按钮，逐节跳转读取右栏目录，切换语言与主题复用命令面板的同一批动作。键盘操作的顺序与鼠标操作的顺序因此一致。
侧栏
| 按键 | 行为 |
|---|---|
| W S ↑ ↓ | 焦点移到上一个 / 下一个可见项 |
| A D ← → | 折叠 / 展开分组；叶子节点上 A 跳到父级，D 无动作 |
| Enter Space G | 打开焦点所在的页面 |
| Esc | 退出树，焦点回到正文 |
四个字母键不需要先进入树：焦点还在正文时按 S，以当前页在侧栏里的那一项为起点下移一格并落焦。焦点行整行加深底色，比「当前页」的底色深一档，用于区分当前页与焦点位置。
窄屏侧栏收进抽屉、或桌面侧栏被折叠时，第一次按这四个键先展开侧栏。页面没有侧栏树时静默。
方向键 只在焦点已经进入侧栏后 才作用于树，正文里保持浏览器原生滚动。RTL 语言下 ← → 随阅读方向对调，A D 恒等于「折叠 / 展开」。
阅读
| 按键 | 行为 |
|---|---|
| J K | 沿页面目录跳到下一节 / 上一节 |
| N | 首页专用：跳到下一个顶层分区（首页 J 的助记别名） |
| Q E | 上一篇 / 下一篇 |
| H | 专注阅读模式：隐藏 / 恢复导航外壳 |
J K 的目标序列与右栏目录同源，落点与点击目录一致。跳转是固定 100 ms 的缓动滑行，与距离无关；连续按键不必等上一段动画结束。已经读到某一节内部一段距离后，K 先回到本节起点，再按一次才跳到上一节。页面没有标题时退化为一小段滑动。
Q E 按 侧栏树的可视顺序 翻页，不按日期。栏目入口页本身也是树里的一项，博客的栏目边界因此表现为「上一专栏最后一篇 → 下一专栏入口页 → 下一专栏第一篇」。折叠起来的分支不在这个顺序里：翻页顺序与焦点移动顺序是同一个。页面没有侧栏树时回退到页尾翻页器，没有翻页器时用 <head> 里的 rel=prev/next。
H 在首页只隐藏顶栏与页脚，在文档页同时隐藏左右栏与浮动按钮。状态记录在当前标签页的会话中，首帧之前恢复，用 Q E 连续翻页不丢状态、不闪烁。外壳隐藏时 WASD 不会把焦点送入不可见的侧栏。
外观、语言与路由
| 按键 | 行为 |
|---|---|
| L Y | 循环切换语言（两个键等价） |
| T | 亮 / 暗模式切换 |
| R | 在首页与顶栏的同源一级入口之间循环 |
这三个键在任何交互式页面上都有效，不限于文档外壳。单语言站点的 L、关闭深浅色菜单后的 T、只有一个一级入口时的 R 都静默。R 只在同源的一级菜单项之间循环，外链与顶栏上的工具控件不参与。
搜索与命令
| 按键 | 行为 |
|---|---|
| F 或 / | 打开命令面板的完整搜索态 |
| C 或反斜杠键 | 打开命令面板的纯命令态 |
| ⌘ 加 K 或 Ctrl 加 K | 打开面板；再按一次关闭 |
/ 和反斜杠属于搜索功能本身，关闭键盘导航后仍然可用；F C 是键盘导航提供的别名，指向同一个面板实例。部分非美式键盘布局上反斜杠不易按到，在面板里输入 > 前缀同样进入纯命令态。面板里有什么见命令面板。
保留不占用的键
? 保留不绑定。速查卡挂在页脚最底层栏的问号按钮上，鼠标悬停、键盘聚焦或触摸都能打开，列出当前页面实际可用的按键：单语言站点看不到切换语言那一行。
G G、Shift 加 G 和数字键同样保留，可能用作将来的跳转序列。
快捷键的让行规则
所有绑定都是裸单键，凡是可能和输入或弹层冲突的场合一律禁用：
- 焦点在 input、textarea、select 或
contenteditable区域里； - 正在用输入法组字（中文站的硬约束）；
- 按住修饰键时：⌘ 加 C 仍是复制，Shift 加 ↓ 仍归浏览器；
- 命令面板或别的对话框开着，键盘归那个弹层。
评论区在 iframe 中，键事件不冒泡到页面，无需额外隔离。
焦点顺序与无障碍
- 跳转链接：进入页面后第一次按 Tab 出现的就是「跳转到主要内容」，一步跳过顶栏和侧栏。
- 真实焦点：树内导航移动的是真正的 DOM 焦点，不是虚拟光标。屏幕阅读器因此读出链接名与「当前页」标记，Enter 是链接的原生行为，Tab 顺序没有被改写。
- 高对比度：焦点行的底色在
forced-colors模式下失效，退化为系统高亮色描边。 - 减弱动效：
prefers-reduced-motion打开时，逐节跳转与翻页滚动改为瞬时定位，不做滑行。 - 速查卡里的键帽与正文里的按键组件是同一套样式。
关闭
全站关闭：
单页关闭（交互密集的演示页常常需要），或者用 cascade 按整节关闭：
这个键只接受布尔值，写成 "false" 或其它值时构建失败，报 params.ui.keyboard_nav must be a boolean。完整定义见配置总览。
关闭后运行时不进入 JavaScript bundle，而不是加载后再判断。/、反斜杠和 ⌘ 加 K 属于搜索，仍然可用；页脚折叠链接栅格的箭头不受影响。
验证
-
构建后确认速查卡按钮在页面里：
关闭键盘导航且没开本地搜索时，这个按钮整个不生成。
-
打开一篇文档，光标停在正文里连按 S：侧栏里应该从当前页那一项开始逐项下移，正文不动。
-
按 E 若干次，核对翻页顺序与侧栏从上到下的顺序一致；折叠一个分组再翻，被折叠的页面应该被跳过。
-
点进搜索框，按 J：页面 不应该 滚动，字符正常输入。使用中文输入法输入时同理。
-
系统里打开「减弱动态效果」，再按 J：应该瞬间定位，没有滑行。
相关
- 命令面板 — F C 打开的对话框
- 全文检索 — 面板里页面结果的来源
- 布局与页面类型 — 哪些页面有侧栏与目录，决定哪些键有效
- 按键 — 在自己的文档里写键帽
- 配置总览 —
ui.keyboard_nav的完整定义