#快捷键参考

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

Pi 暴露具名动作，例如 app.session.new，可以为它们分配快捷键。你可以在 Pi 的用户配置中修改默认分配，或为未分配的动作绑定按键。

运行 /hotkeys 可以查看主编辑器和应用当前生效的快捷键。

#分配快捷键

创建 <agent-dir>/keybindings.json。agent 目录默认为 ~/.pi/agent，详见 Agent 目录。

把每个动作标识符映射到一个按键或按键列表：

{
  "app.session.new": "ctrl+shift+n",
  "app.session.tree": ["ctrl+shift+t", "alt+shift+t"]
}

配置的值会替换该动作的默认值。用空列表可以禁用某个动作的快捷键：

{
  "tui.altScreen.pageUp": []
}

编辑文件后，运行 /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 键盘协议。在不支持该协议的终端中它们可能不工作。

#动作

#终端 UI

#光标移动

专用的历史动作无论光标位置都会浏览 Prompt 历史，并优先于使用同一按键的应用动作。

#文本编辑

#输入与选择

#全屏

在全屏模式下，这些动作控制转录，并优先于使用同一按键的编辑器动作。

#应用

在原生 Windows 上，app.suspend 没有默认值，因为 Windows 终端不支持 Unix 作业控制。如果你手动分配它，Pi 会显示状态消息而不是挂起。WSL 使用正常的 ctrl+z 和 fg 行为。

#会话

#模型与 Thinking

#显示与消息队列

#树导航

#范围模型选择器

在范围模型选择器中使用（通过 /scoped-models 打开）。

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