Pengikatan kunci

Semua pintasan keyboard dapat disesuaikan melalui ~/.pi/agent/keybindings.json. Setiap tindakan dapat terikat pada satu atau lebih kunci.

File konfigurasi menggunakan id pengikat kunci dengan spasi nama yang sama yang digunakan pi secara internal dan yang digunakan penulis ekstensi di keyHint() dan menyuntikkan manajer keybindings.

Konfigurasi lama yang menggunakan id dengan spasi nama sebelumnya seperti cursorUp atau expandTools dimigrasikan secara otomatis ke id dengan spasi nama saat startup.

Setelah mengedit keybindings.json, jalankan /reload di pi untuk menerapkan perubahan tanpa memulai ulang sesi.

modifier+key dengan pengubah ctrl, shift, alt, super (dapat digabungkan) dan kuncinya adalah:

• Huruf: a-z
• Digit: 0-9
• Tombol khusus: escape, esc, enter, return, tab, space, backspace, delete, insert, clear, home, end, pageUp, pageDown, up, down, left, right
• Tombol fungsi: f1-f12
• Simbol: `, -, =, [, ], \, ;, ', ,, ., /, !, @, #, $, %, ^, &, *, (, ), _, +, |, ~, {, }, :, <, >, ?

Kombinasi pengubah: ctrl+shift+x, alt+ctrl+x, ctrl+shift+alt+x, super+k, ctrl+super+k, ctrl+1, dll.

Pengikatan super memerlukan terminal yang melaporkan pengubah secara terpisah, biasanya melalui protokol keyboard Kitty. Mereka mungkin tidak dapat bekerja di terminal tanpa dukungan tersebut.

Tindakan riwayat khusus selalu mengubah entri riwayat, terlepas dari posisi kursor dalam perintah multiline. Pengikatan riwayat eksplisit lebih diutamakan daripada tindakan aplikasi saat editor utama fokus, jadi pengikatan tui.editor.historyPrevious ke ctrl+p akan mengesampingkan perputaran model dalam konteks tersebut tanpa mengubah Ctrl+P pada penyeleksi.

Tindakan ini berlaku ketika mode interaktif menggunakan --tui-mode fullscreen dan menargetkan wilayah gulir transkrip utama. Trackpad dua jari dan input roda mouse menggulir wilayah di bawah penunjuk, kembali ke transkrip melalui dok editor/status/footer tetap. Mengklik hyperlink OSC 8 akan membukanya di handler default. Menyeret dengan tombol mouse utama akan memilih teks dan menyalinnya ke clipboard; memegang di tepi atas atau bawah transkrip akan otomatis menggulir ke konten di luar layar.

Pengikatan transkrip layar penuh lebih diutamakan daripada pengikatan editor. Oleh karena itu, tombol navigasi default yang tidak dimodifikasi mengontrol transkrip dalam mode layar penuh, sementara varian ctrl terus mengontrol editor. Di luar mode layar penuh, kedua varian mengontrol editor.

Perutean ini tetap dapat dikonfigurasi melalui pengikatan tindakan biasa. Misalnya, "tui.altScreen.pageUp": "ctrl+pageUp" membuat pageUp mengontrol editor dan ctrl+pageUp mengontrol transkrip dalam mode layar penuh. Ikat tui.altScreen.halfPageUp dan tui.altScreen.halfPageDown untuk langkah transkrip yang lebih kecil sambil mempertahankan penjilidan satu halaman penuh. Pengaturan "tui.altScreen.pageUp": [] menonaktifkan pintasan transkrip itu sepenuhnya. Pengikatan pengguna menggantikan default untuk tindakan itu.

Digunakan di dalam pemilih model tercakup (dibuka melalui /scoped-models).

Buat ~/.pi/agent/keybindings.json:

{
  "tui.editor.historyPrevious": "ctrl+p",
  "tui.editor.historyNext": "ctrl+n",
  "tui.editor.deleteWordBackward": ["ctrl+w", "alt+backspace"]
}

Setiap tindakan dapat memiliki satu kunci atau serangkaian kunci. Konfigurasi pengguna mengesampingkan default.

Pada Windows asli, app.suspend tidak memiliki pengikatan default karena terminal Windows tidak mendukung kontrol pekerjaan Unix. Jika Anda mengikatnya secara manual, pi menampilkan pesan status alih-alih menangguhkan. Di WSL, perilaku normal Linux ctrl+z/fg masih berlaku.

{
  "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"]
}