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:
| Kategorie | Wert | Beispiel |
|---|---|---|
| Buchstaben | a-z | ctrl+b, alt+d |
| Zahlen | 0-9 | alt+1 |
| Funktionstasten | f1-f12 | f2 |
| Pfeiltasten | up, down, left, right | alt+left |
| Sondertasten | escape, enter, tab, space, backspace, delete, home, end, pageUp, pageDown | shift+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.
| Aktion | Standard-Tastaturkürzel | Beschreibung | Mode |
|---|---|---|---|
| Cursor nach oben bewegen | up | Bewegt den Cursor im Editor nach oben; wenn er sich ganz oben befindet, stattdessen frühere Historie durchsuchen. | Editorbereich |
| Cursor nach unten bewegen | down | Cursor im Editor nach unten bewegen; am unteren Ende stattdessen neuere Historie durchsuchen. | Editorbereich |
| Cursor nach links bewegen | left, ctrl+b | Um ein Zeichen nach links bewegen. | Editorbereich |
| Cursor nach rechts bewegen | right, ctrl+f | Um ein Zeichen nach rechts bewegen. | Editorbereich |
| Wortweise nach links bewegen | alt+left, ctrl+left, alt+b | Um ein Wort nach links bewegen. | Editorbereich |
| Wortweise nach rechts bewegen | alt+right, ctrl+right, alt+f | Ein Wort nach rechts bewegen. | Editorbereich |
| Zeilenanfang | home, ctrl+home, ctrl+a | Zum Anfang der Zeile springen. | Editorbereich |
| Zeilenende | end, ctrl+end, ctrl+e | Zum Ende der Zeile springen. | Editorbereich |
| Vorheriges Zeichen löschen | Rücktaste | Das Zeichen vor dem Cursor löschen. | Editorbereich |
| Nächstes Zeichen löschen | delete, ctrl+d | Das Zeichen nach dem Cursor löschen (eine Bearbeitungsaktion). | Editorbereich |
| Vorheriges Wort löschen | ctrl+w, alt+backspace | Das Wort vor dem Cursor löschen. | Editorbereich |
| Nächstes Wort löschen | alt+d, alt+delete | Das Wort nach dem Cursor löschen. | Editorbereich |
| Bis zum Zeilenanfang löschen | ctrl+u | Inhalt vom Cursor bis zum Zeilenanfang löschen. | Editorbereich |
| Bis zum Zeilenende löschen | ctrl+k | Inhalt 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.
| Aktion | Standard-Tastaturkürzel | Beschreibung | Mode |
|---|---|---|---|
| Zeilenumbruch | shift+enter, ctrl+j | Ein Zeilenumbruchzeichen einfügen. | Editorbereich |
| Absenden | enter | Den Eingabeinhalt senden. | Editorbereich |
| Tab / Autovervollständigung | tab | Pfad-Autovervollständigung auslösen. | Editorbereich |
| Rückgängig | ctrl+- | Den letzten Bearbeitungsschritt rückgängig machen. | Editorbereich |
| Gelöschten Text einfügen | ctrl+y | Den 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.
| Aktion | Standard-Tastaturkürzel | Beschreibung | Mode |
|---|---|---|---|
| Unterbrechen / Abbrechen | Escape | Aktuellen KI-Vorgang abbrechen. | Global |
| Editorbereich leeren | ctrl+c | Den Editorinhalt leeren; erneut drücken, um das Programm zu beenden. | Editorbereich |
| Beenden | ctrl+d | Beendet 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 Editor | ctrl+g | Die aktuelle Eingabe in einem externen Editor bearbeiten. | Editorbereich |
| Bild einfügen | ctrl+v | Ein Bild aus der Zwischenablage einfügen (Windows: alt+v). | Editorbereich |
| KI-Antwort kopieren | ctrl+x | Kopiere die letzte KI-Nachricht. | Editorbereich |
| Folgenachricht senden | alt+enter | Die Nachricht in die Folgewarteschlange einreihen. | Editorbereich |
| Nachricht aus der Warteschlange abrufen | alt+up | Die 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.
| Aktion | Standard-Tastaturkürzel | Beschreibung | Mode |
|---|---|---|---|
| Modellauswahl | ctrl+l | Öffne die Modellauswahl. | Global |
| Zum nächsten Modell wechseln | ctrl+p | Zum nächsten Modell wechseln. | Global |
| Modell rückwärts wechseln | shift+ctrl+p | Zum vorherigen Modell wechseln. | Global |
| Reasoning-Stufe umschalten | shift+tab | Durch die Reasoning-Stufen wechseln. | Editorbereich |
| Reasoning-Anzeige umschalten | ctrl+t | Den KI-Denkprozess ein-/ausklappen. | Global |
| Tool-Ausgabe umschalten | ctrl+o | Tool-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.
| Keys | Normalmodus | Vollbildmodus |
|---|---|---|
| home、end | Editor | Transkript scrollen |
| ctrl+home、ctrl+end | Editor | Editor |
| pageUp, pageDown | Editor | Transkript scrollen |
| ctrl+pageUp, ctrl+pageDown | Editor | Editor |
| ctrl+shift+f (ctrl+f unter Windows/WSL) | Nicht aktiv | Transkript durchsuchen |
| ctrl+up, ctrl+down | Nicht aktiv | Zur vorherigen/nächsten markierten Nachricht springen |