키바인딩

모든 키보드 단축키는 ~/.pi/agent/keybindings.json를 통해 맞춤설정할 수 있습니다. 각 작업은 하나 이상의 키에 바인딩될 수 있습니다.

구성 파일은 pi가 내부적으로 사용하고 확장 작성자가 keyHint() 및 삽입된 keybindings 관리자에서 사용하는 것과 동일한 네임스페이스 키 바인딩 ID를 사용합니다.

cursorUp 또는 expandTools와 같은 사전 네임스페이스 ID를 사용하는 이전 구성은 시작 시 네임스페이스 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에서는 Windows 터미널이 Unix 작업 제어를 지원하지 않기 때문에 app.suspend에 기본 바인딩이 없습니다. 수동으로 바인딩하면 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"]
}