Pi Agent Tastenkürzel-Anpassung

Die Tastenkürzel von Pi Agent sind vollständig anpassbar. Dieses Kapitel stellt die Standard-Tastenkürzelkonfiguration vor und zeigt, wie Sie Ihr eigenes Tastenkürzel-Schema erstellen.


Konfigurationsdatei

Die Tastenkürzel-Konfigurationsdatei befindet sich unter~/.pi/agent/keybindings.json。

Nach der Änderung führen Sie/reloadaus, damit sie ohne Neustart wirksam wird.


Tastenkürzel-Format

Das Tastenkürzel-Format istModifier+KeyZu den Modifier-Tasten gehören ctrl, shift, alt und super, die kombiniert werden können.

Darunter funktioniert super nur, wenn das Terminal diese Modifikatortaste separat melden kann (normalerweise unter Verwendung des Kitty-Tastaturprotokolls); in nicht unterstützten Terminals funktioniert es möglicherweise nicht.

Unterstützte Tasten werden in die folgenden Kategorien unterteilt:

KategorieWertBeispiel
Buchstabena-zctrl+b, alt+d
Zahlen0-9alt+1
Funktionstastenf1-f12f2
Pfeiltastenup, down, left, rightalt+left
Sondertastenescape, enter, tab, space, backspace, delete, home, end, pageUp, pageDownshift+enter
Symbole` - = [ ] ; ' , . / usw.ctrl+]、ctrl+-

In der Konfigurationsdatei werden Modifikatortasten in Kleinbuchstaben geschrieben (z. B. ctrl+shift+p), während Tabellen im Text normalerweise als Shift+Ctrl+P geschrieben werden; beide sind äquivalent.


Schnellreferenz für Standard-Tastenkürzel

Die folgenden vier Tabellen listen die werkseitigen Standardbelegungen nach Funktionsbereich auf und dienen als Ausgangsbasis für Anpassungen.

Dieses Kapitel listet nur gängige Belegungen auf; ctrl+], ctrl+alt+], pageUp/pageDown, alt+y, ctrl+z und Tasten für die Sitzungsauswahl sind nicht enthalten. Die vollständige Liste kann im interaktiven Modus mit /hotkeys angezeigt werden.

Editor-Operationen

Diese Gruppe wirkt nur im Editorbereich und behandelt Cursorbewegung und Textlöschung.

AktionStandard-TastaturkürzelBeschreibungMode
Cursor nach oben bewegenupBewegt den Cursor im Editor nach oben; wenn er sich ganz oben befindet, stattdessen frühere Historie durchsuchen.Editorbereich
Cursor nach unten bewegendownCursor im Editor nach unten bewegen; am unteren Ende stattdessen neuere Historie durchsuchen.Editorbereich
Cursor nach links bewegenleft, ctrl+bUm ein Zeichen nach links bewegen.Editorbereich
Cursor nach rechts bewegenright, ctrl+fUm ein Zeichen nach rechts bewegen.Editorbereich
Wortweise nach links bewegenalt+left, ctrl+left, alt+bUm ein Wort nach links bewegen.Editorbereich
Wortweise nach rechts bewegenalt+right, ctrl+right, alt+fEin Wort nach rechts bewegen.Editorbereich
Zeilenanfanghome, ctrl+home, ctrl+aZum Anfang der Zeile springen.Editorbereich
Zeilenendeend, ctrl+end, ctrl+eZum Ende der Zeile springen.Editorbereich
Vorheriges Zeichen löschenRücktasteDas Zeichen vor dem Cursor löschen.Editorbereich
Nächstes Zeichen löschendelete, ctrl+dDas Zeichen nach dem Cursor löschen (eine Bearbeitungsaktion).Editorbereich
Vorheriges Wort löschenctrl+w, alt+backspaceDas Wort vor dem Cursor löschen.Editorbereich
Nächstes Wort löschenalt+d, alt+deleteDas Wort nach dem Cursor löschen.Editorbereich
Bis zum Zeilenanfang löschenctrl+uInhalt vom Cursor bis zum Zeilenanfang löschen.Editorbereich
Bis zum Zeilenende löschenctrl+kInhalt vom Cursor bis zum Zeilenende löschen.Editorbereich

Eingabe und Absenden

Diese Gruppe steuert, wie Inhalte umgebrochen, vervollständigt und übermittelt werden, und gilt auch für den Editorbereich.

AktionStandard-TastaturkürzelBeschreibungMode
Zeilenumbruchshift+enter, ctrl+jEin Zeilenumbruchzeichen einfügen.Editorbereich
AbsendenenterDen Eingabeinhalt senden.Editorbereich
Tab / AutovervollständigungtabPfad-Autovervollständigung auslösen.Editorbereich
Rückgängigctrl+-Den letzten Bearbeitungsschritt rückgängig machen.Editorbereich
Gelöschten Text einfügenctrl+yDen zuletzt gelöschten Text einfügen.Editorbereich

Anwendung und Meldungen

Diese Gruppe ist für das Unterbrechen der KI, die Verwaltung des Editorinhalts und der Nachrichtenwarteschlange zuständig und hängt größtenteils nicht vom Editorfokus ab.

AktionStandard-TastaturkürzelBeschreibungMode
Unterbrechen / AbbrechenEscapeAktuellen KI-Vorgang abbrechen.Global
Editorbereich leerenctrl+cDen Editorinhalt leeren; erneut drücken, um das Programm zu beenden.Editorbereich
Beendenctrl+dBeendet das Programm, wenn der Editor leer ist (dies gehört zur app.exit-Aktion, getrennt von den Löschaktionen in der vorherigen Tabelle).Editorbereich
Externer Editorctrl+gDie aktuelle Eingabe in einem externen Editor bearbeiten.Editorbereich
Bild einfügenctrl+vEin Bild aus der Zwischenablage einfügen (Windows: alt+v).Editorbereich
KI-Antwort kopierenctrl+xKopiere die letzte KI-Nachricht.Editorbereich
Folgenachricht sendenalt+enterDie Nachricht in die Folgewarteschlange einreihen.Editorbereich
Nachricht aus der Warteschlange abrufenalt+upDie in der Warteschlange befindliche Nachricht zurück in den Editor holen.Editorbereich

Modell und Reasoning

Diese Gruppe dient zum Wechseln von Modellen und zum Anpassen des Reasoning-Verhaltens und ist jederzeit während einer Konversation verfügbar.

AktionStandard-TastaturkürzelBeschreibungMode
Modellauswahlctrl+lÖffne die Modellauswahl.Global
Zum nächsten Modell wechselnctrl+pZum nächsten Modell wechseln.Global
Modell rückwärts wechselnshift+ctrl+pZum vorherigen Modell wechseln.Global
Reasoning-Stufe umschaltenshift+tabDurch die Reasoning-Stufen wechseln.Editorbereich
Reasoning-Anzeige umschaltenctrl+tDen KI-Denkprozess ein-/ausklappen.Global
Tool-Ausgabe umschaltenctrl+oTool-Aufruf-Ausgabe ein-/ausklappen.Global (im /tree-Browser, schaltet den Filtermodus um)

Benutzerdefinierte Tastenkürzel-Konfiguration

Liste einfach die Operationen auf, die du in keybindings.json überschreiben möchtest; nicht aufgeführte Operationen behalten ihre Standardwerte.

Setze den Wert einer Tastenbindung auf ein leeres Array, zum Beispiel"tui.altScreen.pageUp": []um dieses Tastenkürzel vollständig zu deaktivieren.

Emacs-Stil

Wenn du an Emacs-Tastenkürzel gewöhnt bist, kannst du in~/.pi/agent/keybindings.jsondie folgende Konfiguration verwenden:

Beispiel

{
  "tui.editor.historyPrevious": "ctrl+p",
  "tui.editor.historyNext": "ctrl+n",
  "tui.editor.cursorUp": ["up"],
  "tui.editor.cursorDown": ["down"],
  "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"]
}

Die beiden History-Aktionen historyPrevious und historyNext sind standardmäßig nicht gebunden; sie dienen speziell dem Durchsuchen des Einreichungsverlaufs und wechseln außerdem Verlaufseinträge bei mehrzeiliger Eingabe.

Nachdem ctrl+p an das vorherige Verlaufselement gebunden wurde, wird Ctrl+P, wenn der Editorbereich den Fokus erhält, durch diese Verlaufsbindung abgefangen, und das Vorwärtswechseln des Modells wird in diesem Szenario vorübergehend unwirksam.

Ctrl+P in Auswahllisten wie dem Modellselektor ist nicht betroffen und führt weiterhin die eigene Aktion des Selektors aus.

Vim-Stil

Wenn Sie an die Pfeiltasten von Vim gewöhnt sind, können Sie die folgende Konfiguration verwenden:

Beispiel

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

Hier werden alt+h/j/k/l gewählt, um integrierte Tastenbelegungen wie Ctrl+H und Ctrl+D zu vermeiden, daher wird die Alt-Reihe verwendet.

Die Tastenkürzel-Konfiguration von Pi Agent überschreibt die Standardwerte.

Jede Operation kann an ein oder mehrere Tastenkürzel gebunden werden.

Operationen, die nicht in der Konfigurationsdatei aufgeführt sind, behalten ihre Standard-Tastenkürzel.


Alle Tastenkürzel anzeigen

Im interaktiven Modus verwenden Sie den folgenden Befehl, um alle Tastenkürzel und ihre aktuellen Belegungen anzuzeigen:

/hotkeys

Beispielausgabe:

编辑器
  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

Tastenkürzel-Operationen verwenden IDs mit Namensraum im Format "module.action".

IDs ohne Namensraum in älteren Konfigurationsdateien (wie cursorUp, expandTools) werden beim Start automatisch zu IDs mit Namensraum migriert; keine manuelle Änderung erforderlich.

Dieser Befehl listet alle verfügbaren Tastenkürzel-Aktionen, aktuellen Bindungen und die zugehörigen Funktionsbereiche auf und ist damit die beste Möglichkeit, Konflikte bei Tastenbelegungen zu beheben oder das Tastenkürzel für eine bestimmte Funktion zu finden.


Tasten im Vollbildmodus

use--tui-mode fullscreenBeim Start scrollt das Transkript innerhalb des Terminal-Viewports, während der Editor und der untere Statusbereich fest bleiben.

An diesem Punkt werden home, end, pageUp und pageDown ohne Modifikatortasten verwendet, um das Transkript zu scrollen, während ihre ctrl-Varianten weiterhin zum Editor gehören.

Im normalen Modus wirken beide Tastensätze auf den Editor.

Der Vollbildmodus bietet außerdem dedizierte Suche und Navigation: ctrl+shift+f durchsucht das Transkript, und ctrl+up / ctrl+down springen zwischen der vorherigen und der nächsten markierten Nachricht.

Vollbild-Scroll-Bindungen haben Vorrang vor Editor-Bindungen und können weiterhin über normale Aktions-Bindungen angepasst werden.

KeysNormalmodusVollbildmodus
home、endEditorTranskript scrollen
ctrl+home、ctrl+endEditorEditor
pageUp, pageDownEditorTranskript scrollen
ctrl+pageUp, ctrl+pageDownEditorEditor
ctrl+shift+f (ctrl+f unter Windows/WSL)Nicht aktivTranskript durchsuchen
ctrl+up, ctrl+downNicht aktivZur vorherigen/nächsten markierten Nachricht springen
Weitere Erweiterungen