8 快捷键

所有键盘快捷键都可以通过 ~/.pi/agent/keybindings.json 自定义。每个动作可以绑定一个或多个按键。

该配置文件使用与 pi 内部以及扩展作者在 keyHint() 和注入的 keybindings 管理器中相同的带命名空间快捷键 ID。

使用 cursorUp 或 expandTools 等旧版无命名空间 ID 的配置会在启动时自动迁移为带命名空间的 ID。

编辑 keybindings.json 后，在 pi 中运行 /reload 即可应用更改，无需重启会话。

按键格式

格式为 modifier+key，其中修饰键为 ctrl、shift、alt、super（可组合），按键包括：

• 字母： a-z
• 数字： 0-9
• 特殊键： escape、esc、enter、return、tab、space、backspace、delete、insert、clear、home、end、pageUp、pageDown、up、down、left、right
• 功能键： f1-f12
• 符号： `、-、=、[、]、\、;、'、,、.、/、!、@、#、$、%、^、&、*、(、)、_、+、|、~、{、}、:、<、>、?

修饰键组合：ctrl+shift+x、alt+ctrl+x、ctrl+shift+alt+x、super+k、ctrl+super+k、ctrl+1 等。

super 绑定要求终端能够单独上报该修饰键，通常需要 Kitty 键盘协议。在不支持的终端中可能无法工作。

全部动作

TUI 编辑器光标移动

专用的历史动作始终切换历史条目，与多行提示词中的光标位置无关。当主编辑器获得焦点时，显式的历史绑定优先于应用动作，因此将 tui.editor.historyPrevious 绑定到 ctrl+p 只会在该上下文中覆盖模型循环切换，而不会改变选择器中的 Ctrl+P。

TUI 编辑器删除

TUI 输入

TUI 剪切环

TUI 剪贴板与选择

TUI 全屏视口

这些动作在交互模式使用 --tui-mode fullscreen 时生效，作用于主对话记录滚动区域。双指触控板和鼠标滚轮输入会滚动指针所在区域；当指针位于固定的编辑器/状态栏/底部栏停靠区上时，则回退为滚动对话记录。点击 OSC 8 超链接会用默认处理器打开它。按住主鼠标键拖动会选择文本并复制到剪贴板；在对话记录的上、下边缘按住不动时会自动滚动到屏幕外的内容。对话记录向上滚动时，其底部行会显示可点击的 “Jump to latest message” 标签，展示 tui.altScreen.bottom 快捷键。各终端专属的鼠标与触控行为参见终端设置。

全屏对话记录绑定优先于编辑器绑定。因此在全屏模式下，默认的无修饰导航键控制对话记录，而它们的 ctrl 变体继续控制编辑器。在非全屏模式下，两种变体都控制编辑器。

对话记录搜索面板会显示已配置的上一个/下一个快捷键以及可点击的箭头控件。再次按下 tui.altScreen.search，或使用 tui.altScreen.searchClose，即可关闭它。

这一路由仍可通过常规的动作绑定进行配置。例如，"tui.altScreen.pageUp": "ctrl+pageUp" 会让全屏模式下的 pageUp 控制编辑器、ctrl+pageUp 控制对话记录。绑定 tui.altScreen.halfPageUp 和 tui.altScreen.halfPageDown 可以按半页步进，绑定 tui.altScreen.lineUp 和 tui.altScreen.lineDown 可以按单行步进。设置 "tui.altScreen.pageUp": [] 会完全禁用该对话记录快捷键。用户绑定会替换该动作的默认值。

应用

会话

模型与思考

显示与消息队列

树状导航

作用域模型选择器

用于作用域模型选择器内部（通过 /scoped-models 打开）。

自定义配置

创建 ~/.pi/agent/keybindings.json：

{
  "tui.editor.historyPrevious": "ctrl+p",
  "tui.editor.historyNext": "ctrl+n",
  "tui.editor.deleteWordBackward": ["ctrl+w", "alt+backspace"]
}

每个动作可以绑定单个按键或一个按键数组。用户配置会覆盖默认值。

在原生 Windows 上，app.suspend 没有默认绑定，因为 Windows 终端不支持 Unix 作业控制。如果你手动绑定它，pi 会显示一条状态消息而不是挂起进程。在 WSL 中，正常的 Linux ctrl+z/fg 行为仍然适用。

Emacs 示例

{
  "tui.editor.historyPrevious": "ctrl+p",
  "tui.editor.historyNext": "ctrl+n",
  "tui.editor.cursorLeft": ["left", "ctrl+b"],
  "tui.editor.cursorRight": ["right", "ctrl+f"],
  "tui.editor.cursorWordLeft": ["alt+left", "alt+b"],
  "tui.editor.cursorWordRight": ["alt+right", "alt+f"],
  "tui.editor.deleteCharForward": ["delete", "ctrl+d"],
  "tui.editor.deleteCharBackward": ["backspace", "ctrl+h"],
  "tui.input.newLine": ["shift+enter", "ctrl+j"]
}

Vim 示例

{
  "tui.editor.cursorUp": ["up", "alt+k"],
  "tui.editor.cursorDown": ["down", "alt+j"],
  "tui.editor.cursorLeft": ["left", "alt+h"],
  "tui.editor.cursorRight": ["right", "alt+l"],
  "tui.editor.cursorWordLeft": ["alt+left", "alt+b"],
  "tui.editor.cursorWordRight": ["alt+right", "alt+w"]
}