Настройка сочетаний клавиш Pi Agent

Сочетания клавиш Pi Agent полностью настраиваются. В этой главе описывается конфигурация сочетаний клавиш по умолчанию и то, как создать собственную схему сочетаний клавиш.

Файл конфигурации

Файл конфигурации сочетаний клавиш находится в~/.pi/agent/keybindings.json。

После изменения выполните/reload, чтобы изменения вступили в силу без перезапуска.

Формат сочетаний клавиш

Формат сочетания клавиш:Modifier+Key. К модификаторам относятся ctrl, shift, alt и super; их можно комбинировать.

Среди них super работает только если терминал может отдельно сообщать об этой клавише-модификаторе (обычно полагаясь на протокол клавиатуры Kitty); он может не работать в неподдерживаемых терминалах.

Поддерживаемые клавиши делятся на следующие категории:

В файле конфигурации клавиши-модификаторы записываются в нижнем регистре (например, ctrl+shift+p), тогда как в таблицах в тексте обычно используется запись Shift+Ctrl+P; они эквивалентны.

Краткий справочник стандартных сочетаний клавиш

В следующих четырёх таблицах перечислены заводские привязки по умолчанию по функциональным областям; они служат основой для настройки.

В этой главе перечислены только распространённые привязки; ctrl+], ctrl+alt+], pageUp/pageDown, alt+y, ctrl+z и клавиши выбора сеанса не включены. Полный список можно посмотреть с помощью /hotkeys в интерактивном режиме.

Операции в редакторе

Эта группа действует только в области редактора и отвечает за перемещение курсора и удаление текста.

Ввод и отправка

Эта группа управляет переносом, автодополнением и отправкой содержимого, а также применяется к области редактора.

Приложение и сообщения

Эта группа отвечает за прерывание работы ИИ, управление содержимым редактора и очередью сообщений и в основном не зависит от фокуса редактора.

Модель и рассуждения

Эта группа используется для переключения моделей и настройки поведения рассуждений и доступна в любое время во время разговора.

Настройка пользовательских сочетаний клавиш

Просто перечислите операции, которые вы хотите переопределить, в keybindings.json; операции, не указанные в списке, сохраняют свои значения по умолчанию.

Установите значение привязки в пустой массив, например"tui.altScreen.pageUp": []чтобы полностью отключить это сочетание клавиш.

Стиль Emacs

Если вы привыкли к сочетаниям клавиш Emacs, вы можете~/.pi/agent/keybindings.jsonиспользовать следующую конфигурацию в:

Два действия истории historyPrevious и historyNext не привязаны по умолчанию; они предназначены специально для просмотра истории отправок, а также переключают записи истории при многострочном вводе.

После привязки ctrl+p к предыдущему элементу истории, когда область редактора получает фокус, Ctrl+P будет перехвачен этой привязкой истории, и переключение модели вперёд временно перестаёт работать в этом сценарии.

Ctrl+P в списках выбора, таких как селектор модели, не затрагивается и по-прежнему выполняет собственное действие селектора.

Стиль Vim

Если вы привыкли к стрелкам Vim, вы можете использовать следующую конфигурацию:

Здесь alt+h/j/k/l выбраны, чтобы избежать встроенных привязок, таких как Ctrl+H и Ctrl+D, поэтому используется серия Alt.

Конфигурация горячих клавиш Pi Agent переопределяет значения по умолчанию.

Каждую операцию можно привязать к одному или нескольким сочетаниям клавиш.

Операции, не указанные в файле конфигурации, сохраняют свои сочетания клавиш по умолчанию.

Показать все сочетания клавиш

В интерактивном режиме используйте следующую команду, чтобы отобразить все сочетания клавиш и их текущие привязки:

/hotkeys

Пример вывода:

编辑器
  tui.editor.cursorUp            up
  tui.editor.cursorDown          down
  tui.editor.cursorWordLeft      alt+left, ctrl+left, alt+b
  tui.input.submit               enter
模型与推理
  app.model.select               ctrl+l
  app.model.cycleForward         ctrl+p
  app.model.cycleBackward        shift+ctrl+p

Операции сочетаний клавиш используют ID с пространствами имён в формате "module.action".

ID без пространств имён в старых файлах конфигурации (таких как cursorUp, expandTools) будут автоматически перенесены в ID с пространствами имён при запуске; ручное изменение не требуется.

Эта команда выводит список всех доступных действий горячих клавиш, текущих привязок и связанных с ними функциональных областей, что делает её лучшим способом для устранения конфликтов привязок клавиш или поиска горячей клавиши для конкретной функции.

Клавиши в полноэкранном режиме

используйте--tui-mode fullscreenПри запуске транскрипт прокручивается в пределах области просмотра терминала, а редактор и нижняя область состояния остаются фиксированными.

На этом этапе клавиши home, end, pageUp и pageDown без клавиш-модификаторов используются для прокрутки транскрипта, а их варианты с ctrl по-прежнему относятся к редактору.

В обычном режиме оба набора клавиш действуют на редактор.

В полноэкранном режиме также есть специальные средства поиска и навигации: ctrl+shift+f ищет по транскрипту, а ctrl+up / ctrl+down переключаются между предыдущим и следующим помеченными сообщениями.

Привязки прокрутки в полноэкранном режиме имеют приоритет над привязками редактора и по-прежнему могут быть настроены через обычные привязки действий.