快捷键

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

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

使用预命名空间 id（例如 cursorUp 或 expandTools）的旧配置会在启动时自动迁移到命名空间 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.editor.historyPrevious 绑定到 ctrl+p 会覆盖该上下文中的模型循环，而不会更改选择器中的Ctrl+P。

当交互模式使用 --tui-mode fullscreen 并定位主转录本滚动区域时，将应用这些操作。两指触控板和鼠标滚轮输入滚动指针下方的区域，回落到固定编辑器/状态/页脚停靠栏上的文字记录。单击 OSC 8 超链接将其在默认处理程序中打开。使用鼠标主按钮拖动选择文本并将其复制到剪贴板；按住记录的顶部或底部边缘会自动滚动到屏幕外的内容。

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

该路由仍然可以通过普通操作绑定进行配置。例如，"tui.altScreen.pageUp": "ctrl+pageUp" 使pageUp 控制编辑器，ctrl+pageUp 控制全屏模式下的文字记录。绑定 tui.altScreen.halfPageUp 和 tui.altScreen.halfPageDown 以实现较小的转录步骤，同时保持全页绑定。设置 "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 行为仍然适用。

{
  "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"]
}

{
  "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"]
}