鍵綁定

所有鍵盤快捷鍵都可以透過~/.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"]
}