#Keybindings（快捷键）

本页面是 Pi 官方文档 的中文翻译。仅供学习参考。

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

配置文件使用 Pi 内部使用的相同命名空间快捷键 ID，扩展作者在 keyHint() 和注入的 keybindings 管理器中也使用这些 ID。

使用旧的非命名空间 ID（如 cursorUp 或 expandTools）的旧配置在启动时会自动迁移到命名空间 ID。

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

#按键格式

格式：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 编辑器光标移动

专用历史操作始终改变历史条目，无论光标在多行 Prompt 中的位置。主编辑器聚焦时，显式历史绑定优先于应用程序操作，因此将 tui.editor.historyPrevious 绑定到 ctrl+p 会覆盖该上下文中的模型循环，而不改变选择器中的 Ctrl+P。

#TUI 编辑器删除

#TUI 输入

#TUI Kill Ring

#TUI 剪贴板和选择

#TUI 全屏视口

这些操作在交互模式使用 --tui-mode fullscreen 时生效，作用于主转录滚动区域。双指触控板和鼠标滚轮输入可滚动指针所在区域，指针位于固定的编辑器/状态栏/底部停靠栏上方时则滚动转录。点击 OSC 8 超链接会以默认处理器打开。用鼠标主按钮拖拽可选中文本并复制到剪贴板；在转录顶部或底部边缘按住会自动滚动查看屏幕外内容。终端特定的鼠标和触控板行为参见 终端设置。

全屏转录绑定优先于编辑器绑定。因此默认未修改的导航键在全屏模式下控制转录，而其 ctrl 变体继续控制编辑器。在全屏模式之外，两种变体都控制编辑器。

此路由仍可通过常规操作绑定配置。例如，"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 选择器

在 scoped models 选择器（通过 /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"]
}

法律声明：本页面是 pi.dev 官方文档的中文翻译版本，仅供学习参考。本网站与 pi.dev 及 Earendil Inc. 无任何法律关系。