Ki Editor 进阶指南：通用键位与 Extend 模式跨模式操作技巧清单

Ki Editor 是一款支持多光标组合操作的模态编辑器（Multi-cursor combinatoric modal editor）。它的通用键位（Universal Keybindings）在任何模式下都有效，而 Extend 模式则让你能像"捏橡皮筋"一样同时调整选区的两端。本文带你快速掌握这两项跨模式操作的进阶技巧。

先懂一个核心理念：最小但通用（MinGen）

Ki 的设计哲学是"少量核心正交能力 + 自由组合"，而不是为每个场景造专用快捷键。这意味着：

• 移动必须搭配选择模式：想按行移动？先进入 Line 选择模式，再按右移。想按词移动？进入 Word 模式再移。
• 键位是位置化的：不靠助记符（比如 Vim 的p代表粘贴），而是靠键盘上的物理位置。无论你用 QWERTY、Dvorak 还是 Colemak，键位布局不变。
• 每个组件都是编辑器：提示框、补全下拉框、文件浏览器……全都遵守同一套操作逻辑。

理解这一点后，你会发现 Ki 的键位几乎不需要"背"，只需要"感受位置"。详见 docs/docs/core-concepts.md。

子模式入口速查表：4 个键覆盖大部分场景

Ki 提供 4 个子模式（Sub-modes），它们镜像普通模式的大部分键位，只有少数绑定不同：

💡 小技巧：子模式是"临时层"，按ESC即可退出并回到普通模式，选区会保留。

通用键位清单：3 个跨模式快捷键

以下键位定义在 src/keymap.rs 的keymap_universal中，在任意模式下都生效，包括普通模式、插入模式和各个子模式：

⇋ Align View：3 种视图对齐一键循环

类似 Vim 的zt/zz/zb，但它对多行选区同样有效。连续按Alt+;会按以下顺序循环切换：

1. 顶部对齐：选区第一行贴到屏幕顶部
2. 居中对齐：选区中间行置于屏幕中央
3. 底部对齐：选区最后一行贴到屏幕底部

处理跨越大半个屏幕的选区时，这个键位比手动滚动高效得多。

⇋ Window：在信息窗口之间穿梭

按Alt+/会把光标切换到屏幕上的下一个窗口，例如Hover Info（悬浮提示）和Completion Info（补全信息）。当你需要滚动另一个窗口的内容、或把里面的文本复制出来时，无需移动鼠标即可完成。配合Close动作（关闭当前窗口，其子窗口会一并卸载），窗口管理完全靠键盘。

详细说明见 docs/docs/universal-keybindings.md。

Extend 模式：像拖拽一样扩选区，但两端都能调

在普通模式下按f进入 Extend 模式。它模拟了 GUI 文本框里"点击并拖拽"选词的手感，但有一个鼠标做不到的优势：两个端点都可以独立微调，选错不用从头再来。

进入后会发生什么（源自 docs/docs/sub-modes/extend-mode.md）：

1. 每个选区由**两个范围（range）**组成，而不是原来的一个
2. 同一时间只有一个可移动的范围
3. 两个范围之间的所有字符（含两端）都处于选中状态
4. 基于选区的动作直接作用于扩展后的范围
5. 按ESC退出扩展状态

Extend 模式实战：3 个高频技巧

技巧 1：连续扩展多词 / 多行想选中"一整段"？在 Word 或 Line 选择模式下反复按右移，选区会自动延伸覆盖多个词或多行，且两端始终可回缩修正。

技巧 2：位置一致性带来的隐藏捷径Ki 遵循"位置一致性"原则——同一物理位置在不同模式下含义相近。例如f这个键位：

也就是说，在 Extend 模式里按f就是 Change Surround（替换成新的包裹符号），这是跨模式键位协同的典型例子。

技巧 3：扩展 + 选择模式动作 = 批量操作Extend 中所有普通模式的动作都可用，且作用于扩展后的完整范围。比如扩展出一大段后直接执行转换（Transform）或注释操作，一次覆盖整段。相关动作键位见 src/keymap.rs 的extend_mode_keymap_legend_config。

进阶组合：跨模式操作的推荐工作流

把通用键位与 Extend 模式串起来，一个典型的高效流程是：

1. 在目标词上进入 Word 选择模式，按f打开 Extend
2. 用方向移动把选区扩到覆盖整个函数/段落
3. 按Alt+/切到补全窗口看一眼类型信息，再按Alt+/切回来
4. 对扩展好的选区执行转换、注释或 Change Surround
5. 需要调整视口时用Alt+;循环对齐，全程不碰鼠标

这套流程体现了 Ki "组合优于专用键"的设计初衷，更多核心概念可查阅 docs/docs/core-concepts.md。

相关资料导航 📚

• 通用键位官方说明：docs/docs/universal-keybindings.md
• Extend 模式官方说明：docs/docs/sub-modes/extend-mode.md
• 子模式总览：docs/docs/sub-modes/index.md
• 键位速查表：docs/docs/cheatsheet.md
• 键位定义源码：src/keymap.rs

掌握通用键位 + Extend 模式后，你已经在 Ki Editor 中获得了"任何位置、任何模式都不迷路"的操作自由——这正是跨模式编辑器最迷人的地方。