Сочетания клавиш

Все сочетания клавиш можно настроить с помощью ~/.pi/agent/keybindings.json. Каждое действие может быть привязано к одной или нескольким клавишам.

В файле конфигурации используются те же идентификаторы привязки клавиш в пространстве имен, которые pi использует внутри себя и которые авторы расширений используют в менеджерах keyHint() и внедренных keybindings.

Старые конфигурации, использующие идентификаторы с предварительно заданным пространством имен, такие как cursorUp или expandTools, автоматически переносятся в идентификаторы с заданным пространством имен при запуске.

После редактирования 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.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"]
}