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égorieValeurExemple
Lettresa-zctrl+b, alt+d
Nombres0-9alt+1
Touches de fonctionf1-f12f2
Touches fléchéesup, down, left, rightalt+left
Touches spécialesescape, enter, tab, space, backspace, delete, home, end, pageUp, pageDownshift+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érationRaccourci par défautDescriptionMode
Déplacer le curseur vers le hautupDé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 basdownDé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 gaucheleft, ctrl+bDéplacer d'un caractère vers la gauche.Zone de l'éditeur
Déplacer le curseur vers la droiteright, ctrl+fDéplacer d'un caractère vers la droite.Zone de l'éditeur
Déplacer d'un mot vers la gauchealt+left, ctrl+left, alt+bDéplacer d'un mot vers la gauche.Zone de l'éditeur
Déplacer d'un mot vers la droitealt+right, ctrl+right, alt+fSe déplacer d'un mot vers la droite.Zone de l'éditeur
Début de lignehome, ctrl+home, ctrl+aAller au début de la ligne.Zone de l'éditeur
Fin de ligneend, ctrl+end, ctrl+eAller à la fin de la ligne.Zone de l'éditeur
Supprimer le caractère précédentretour arrièreSupprimer le caractère avant le curseur.Zone de l'éditeur
Supprimer le caractère suivantdelete, ctrl+dSupprimer le caractère après le curseur (une action d'édition).Zone de l'éditeur
Supprimer le mot précédentctrl+w, alt+backspaceSupprimer le mot avant le curseur.Zone de l'éditeur
Supprimer le mot suivantalt+d, alt+deleteSupprimer le mot après le curseur.Zone de l'éditeur
Supprimer jusqu'au début de la lignectrl+uSupprimer le contenu du curseur jusqu'au début de la ligne.Zone de l'éditeur
Supprimer jusqu'à la fin de la lignectrl+kSupprimer 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érationRaccourci par défautDescriptionMode
Nouvelle ligneshift+enter, ctrl+jInsérer un caractère de saut de ligne.Zone de l'éditeur
EnvoyerenterEnvoyer le contenu saisi.Zone de l'éditeur
Tab / Auto-complétiontabDéclencher l'auto-complétion du chemin.Zone de l'éditeur
Annulerctrl+-Annuler la dernière étape d'édition.Zone de l'éditeur
Coller le texte suppriméctrl+yColler 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érationRaccourci par défautDescriptionMode
Interrompre / AnnuleréchappementAnnuler l'opération d'IA en cours.Global
Effacer la zone de l'éditeurctrl+cEffacer le contenu de l'éditeur ; appuyez à nouveau pour quitter le programme.Zone de l'éditeur
Quitterctrl+dQuitter 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 externectrl+gModifier l'entrée en cours dans un éditeur externe.Zone de l'éditeur
Coller une imagectrl+vColler une image depuis le presse-papiers (Windows : alt+v).Zone de l'éditeur
Copier la réponse de l'IActrl+xCopier le dernier message de l'IA.Zone de l'éditeur
Envoyer un message de suivialt+enterMettre le message dans la file d'attente de suivi.Zone de l'éditeur
Récupérer un message en file d'attentealt+upRamener 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érationRaccourci par défautDescriptionMode
Sélecteur de modèlectrl+lOuvrir le sélecteur de modèle.Global
Passer au modèle suivantctrl+pPasser au modèle suivant.Global
Changer de modèle en arrièreshift+ctrl+pPasser au modèle précédent.Global
Basculer le niveau de raisonnementshift+tabParcourir les niveaux de raisonnement.Zone de l'éditeur
Basculer l'affichage du raisonnementctrl+tDévelopper/réduire le processus de raisonnement de l'IA.Global
Basculer la sortie des outilsctrl+oDé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.

KeysMode normalMode plein écran
home、endÉditeurFaire défiler la transcription
ctrl+home、ctrl+endÉditeurÉditeur
pageUp, pageDownÉditeurFaire défiler la transcription
ctrl+pageUp, ctrl+pageDownÉditeurÉditeur
ctrl+shift+f (ctrl+f sous Windows/WSL)Non actifRechercher dans la transcription
ctrl+up, ctrl+downNon actifAller au message marqué précédent/suivant
Autres extensions