Personnalisation des raccourcis clavier de Pi Agent
Les raccourcis de Pi Agent sont entièrement personnalisables. Ce chapitre présente la configuration par défaut des raccourcis et comment créer votre propre schéma de raccourcis.
Fichier de configuration
Le fichier de configuration des raccourcis se trouve à~/.pi/agent/keybindings.json。
Après modification, exécutez/reloadpour prendre effet sans redémarrer.
Format des raccourcis
Le format des raccourcis estModificateur+ToucheLes touches de modification incluent ctrl, shift, alt et super, qui peuvent être combinées.
Parmi eux, super ne fonctionne que si le terminal peut signaler cette touche modificatrice séparément (en s'appuyant généralement sur le protocole clavier Kitty) ; il peut ne pas fonctionner dans les terminaux non pris en charge.
Les touches prises en charge sont réparties dans les catégories suivantes :
| Catégorie | Valeur | Exemple |
|---|---|---|
| Lettres | a-z | ctrl+b, alt+d |
| Nombres | 0-9 | alt+1 |
| Touches de fonction | f1-f12 | f2 |
| Touches fléchées | up, down, left, right | alt+left |
| Touches spéciales | escape, enter, tab, space, backspace, delete, home, end, pageUp, pageDown | shift+enter |
| Symboles | ` - = [ ] ; ' , . / etc. | ctrl+], ctrl+- |
Dans le fichier de configuration, les touches de modification sont écrites en minuscules (par ex. ctrl+shift+p), tandis que les tableaux du texte sont généralement écrits sous la forme Shift+Ctrl+P ; les deux sont équivalents.
Référence rapide des raccourcis par défaut
Les quatre tableaux suivants répertorient les affectations par défaut d'usine par zone fonctionnelle, servant de base à la personnalisation.
Ce chapitre ne répertorie que les raccourcis courants ; ctrl+], ctrl+alt+], pageUp/pageDown, alt+y, ctrl+z et les touches du sélecteur de session ne sont pas inclus. La liste complète peut être consultée avec /hotkeys en mode interactif.
Opérations de l'éditeur
Ce groupe ne prend effet que dans la zone de l'éditeur, et gère le déplacement du curseur et la suppression de texte.
| Opération | Raccourci par défaut | Description | Mode |
|---|---|---|---|
| Déplacer le curseur vers le haut | up | Déplacer le curseur vers le haut dans l'éditeur ; lorsque le haut est atteint, parcourir l'historique antérieur à la place. | Zone de l'éditeur |
| Déplacer le curseur vers le bas | down | Déplacer le curseur vers le bas dans l'éditeur ; lorsque vous êtes en bas, parcourez l'historique plus récent à la place. | Zone de l'éditeur |
| Déplacer le curseur vers la gauche | left, ctrl+b | Déplacer d'un caractère vers la gauche. | Zone de l'éditeur |
| Déplacer le curseur vers la droite | right, ctrl+f | Déplacer d'un caractère vers la droite. | Zone de l'éditeur |
| Déplacer d'un mot vers la gauche | alt+left, ctrl+left, alt+b | Déplacer d'un mot vers la gauche. | Zone de l'éditeur |
| Déplacer d'un mot vers la droite | alt+right, ctrl+right, alt+f | Se déplacer d'un mot vers la droite. | Zone de l'éditeur |
| Début de ligne | home, ctrl+home, ctrl+a | Aller au début de la ligne. | Zone de l'éditeur |
| Fin de ligne | end, ctrl+end, ctrl+e | Aller à la fin de la ligne. | Zone de l'éditeur |
| Supprimer le caractère précédent | retour arrière | Supprimer le caractère avant le curseur. | Zone de l'éditeur |
| Supprimer le caractère suivant | delete, ctrl+d | Supprimer le caractère après le curseur (une action d'édition). | Zone de l'éditeur |
| Supprimer le mot précédent | ctrl+w, alt+backspace | Supprimer le mot avant le curseur. | Zone de l'éditeur |
| Supprimer le mot suivant | alt+d, alt+delete | Supprimer le mot après le curseur. | Zone de l'éditeur |
| Supprimer jusqu'au début de la ligne | ctrl+u | Supprimer le contenu du curseur jusqu'au début de la ligne. | Zone de l'éditeur |
| Supprimer jusqu'à la fin de la ligne | ctrl+k | Supprimer le contenu du curseur jusqu'à la fin de la ligne. | Zone de l'éditeur |
Saisie et soumission
Ce groupe contrôle la façon dont le contenu est renvoyé à la ligne, complété et soumis, et s'applique également à la zone de l'éditeur.
| Opération | Raccourci par défaut | Description | Mode |
|---|---|---|---|
| Nouvelle ligne | shift+enter, ctrl+j | Insérer un caractère de saut de ligne. | Zone de l'éditeur |
| Envoyer | enter | Envoyer le contenu saisi. | Zone de l'éditeur |
| Tab / Auto-complétion | tab | Déclencher l'auto-complétion du chemin. | Zone de l'éditeur |
| Annuler | ctrl+- | Annuler la dernière étape d'édition. | Zone de l'éditeur |
| Coller le texte supprimé | ctrl+y | Coller le texte supprimé le plus récemment. | Zone de l'éditeur |
Application et Messages
Ce groupe est responsable de l'interruption de l'IA, de la gestion du contenu de l'éditeur et de la file d'attente des messages, et ne dépend généralement pas du focus de l'éditeur.
| Opération | Raccourci par défaut | Description | Mode |
|---|---|---|---|
| Interrompre / Annuler | échappement | Annuler l'opération d'IA en cours. | Global |
| Effacer la zone de l'éditeur | ctrl+c | Effacer le contenu de l'éditeur ; appuyez à nouveau pour quitter le programme. | Zone de l'éditeur |
| Quitter | ctrl+d | Quitter le programme lorsque l'éditeur est vide (cela appartient à l'action app.exit, distinct des actions de suppression dans le tableau précédent). | Zone de l'éditeur |
| Éditeur externe | ctrl+g | Modifier l'entrée en cours dans un éditeur externe. | Zone de l'éditeur |
| Coller une image | ctrl+v | Coller une image depuis le presse-papiers (Windows : alt+v). | Zone de l'éditeur |
| Copier la réponse de l'IA | ctrl+x | Copier le dernier message de l'IA. | Zone de l'éditeur |
| Envoyer un message de suivi | alt+enter | Mettre le message dans la file d'attente de suivi. | Zone de l'éditeur |
| Récupérer un message en file d'attente | alt+up | Ramener le message mis en file d'attente dans l'éditeur. | Zone de l'éditeur |
Modèle et raisonnement
Ce groupe permet de changer de modèle et d'ajuster le comportement de raisonnement, et il est disponible à tout moment pendant une conversation.
| Opération | Raccourci par défaut | Description | Mode |
|---|---|---|---|
| Sélecteur de modèle | ctrl+l | Ouvrir le sélecteur de modèle. | Global |
| Passer au modèle suivant | ctrl+p | Passer au modèle suivant. | Global |
| Changer de modèle en arrière | shift+ctrl+p | Passer au modèle précédent. | Global |
| Basculer le niveau de raisonnement | shift+tab | Parcourir les niveaux de raisonnement. | Zone de l'éditeur |
| Basculer l'affichage du raisonnement | ctrl+t | Développer/réduire le processus de raisonnement de l'IA. | Global |
| Basculer la sortie des outils | ctrl+o | Développer/réduire la sortie d'appel d'outil. | Global (dans le navigateur /tree, bascule le mode filtre) |
Configuration des raccourcis personnalisés
Listez simplement les opérations que vous souhaitez remplacer dans keybindings.json ; les opérations non listées conservent leurs valeurs par défaut.
Définissez la valeur d'une liaison sur un tableau vide, par exemple"tui.altScreen.pageUp": []pour désactiver complètement ce raccourci.
Style Emacs
Si vous êtes habitué aux raccourcis Emacs, vous pouvez~/.pi/agent/keybindings.jsonutiliser la configuration suivante dans :
Exemple
"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"]
}
Les deux actions d'historique historyPrevious et historyNext ne sont pas liées par défaut ; elles sont spécifiquement destinées à parcourir l'historique des soumissions, et elles changent également les entrées d'historique dans la saisie multiligne.
Après avoir lié ctrl+p à l'élément d'historique précédent, lorsque la zone de l'éditeur reçoit le focus, Ctrl+P sera préempté par cette liaison d'historique, et le changement de modèle en avant devient temporairement inefficace dans ce scénario.
Ctrl+P dans les listes de sélection telles que le sélecteur de modèle n'est pas affecté et effectue toujours l'action propre du sélecteur.
Style Vim
Si vous êtes habitué aux touches fléchées de Vim, vous pouvez utiliser la configuration suivante :
Exemple
"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"]
}
Ici, alt+h/j/k/l sont choisis pour éviter les raccourcis intégrés tels que Ctrl+H et Ctrl+D, c'est pourquoi la série Alt est utilisée.
La configuration des raccourcis de Pi Agent remplace les valeurs par défaut.
Chaque opération peut être associée à un ou plusieurs raccourcis.
Les opérations non listées dans le fichier de configuration conservent leurs raccourcis par défaut.
Afficher tous les raccourcis
En mode interactif, utilisez la commande suivante pour afficher tous les raccourcis et leurs associations actuelles :
/hotkeys
Exemple de sortie :
编辑器 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
Les opérations de raccourci utilisent des identifiants avec espace de noms au format "module.action".
Les identifiants sans espace de noms dans les anciens fichiers de configuration (tels que cursorUp, expandTools) seront automatiquement migrés vers des identifiants avec espace de noms au démarrage ; aucune modification manuelle n'est requise.
Cette commande liste toutes les actions de raccourci disponibles, les liaisons actuelles et leurs domaines de fonctionnalité associés, ce qui en fait le meilleur moyen de résoudre les conflits de raccourcis clavier ou de trouver le raccourci d'une fonctionnalité spécifique.
Touches en mode plein écran
utilisez--tui-mode fullscreenAu démarrage, la transcription défile dans la fenêtre du terminal, tandis que l'éditeur et la zone d'état inférieure restent fixes.
À ce stade, les touches home, end, pageUp et pageDown sans touches modificatrices servent à faire défiler la transcription, tandis que leurs variantes avec ctrl appartiennent toujours à l'éditeur.
En mode normal, les deux ensembles de touches agissent sur l'éditeur.
Le mode plein écran dispose également d'une recherche et d'une navigation dédiées : ctrl+shift+f recherche dans la transcription, et ctrl+up / ctrl+down sautent entre le message marqué précédent et le suivant.
Les liaisons de défilement en plein écran ont priorité sur les liaisons de l'éditeur et peuvent toujours être ajustées via les liaisons d'action normales.
| Keys | Mode normal | Mode plein écran |
|---|---|---|
| home、end | Éditeur | Faire défiler la transcription |
| ctrl+home、ctrl+end | Éditeur | Éditeur |
| pageUp, pageDown | Éditeur | Faire défiler la transcription |
| ctrl+pageUp, ctrl+pageDown | Éditeur | Éditeur |
| ctrl+shift+f (ctrl+f sous Windows/WSL) | Non actif | Rechercher dans la transcription |
| ctrl+up, ctrl+down | Non actif | Aller au message marqué précédent/suivant |