快速鍵

所有鍵盤快速鍵都可以透過 ~/.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 並定位主transcript滾動區域時，將應用這些操作。兩指觸控板和滑鼠滾輪輸入滾動游標下方的區域，回落到固定編輯器/狀態/頁尾停靠欄上的文字記錄。單擊 OSC 8 超連結將其在預設處理程式中開啟。使用滑鼠主按鈕拖動選擇文字並將其複製到剪貼簿；按住記錄的頂部或底部邊緣會自動滾動到螢幕外的內容。

全螢幕transcript綁定優先於編輯器綁定。因此，預設的未修改導航鍵控制全螢幕模式下的文字記錄，而其 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 開啟）。

建立 ~/.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"]
}