Personnalisation du thème de Pi Agent

L'Agent Pi prend en charge la personnalisation des couleurs de l'interface du terminal.

Ce chapitre explique comment utiliser les thèmes intégrés et créer des thèmes personnalisés.


Aperçu des thèmes

Pi Agent utilise des fichiers de thème au format JSON pour définir toutes les couleurs de l'interface TUI.

Chaque thème doit définir51 tokens requis + 4 tokens facultatifs (thinkingMax, scrollbarThumb, searchMatchBg, searchMatchText), couvrant les couleurs de divers éléments d'interface tels que l'interface principale, les arrière-plans des messages, le rendu Markdown, la coloration syntaxique et les bordures de l'éditeur.


Thèmes intégrés

Pi Agent est livré avec deux thèmes intégrés :

Nom du thèmeScénario applicableDescription
darkFond de terminal sombre (par défaut)Adapté aux terminaux sombres utilisés par la plupart des développeurs
lightFond de terminal clairAdapté aux terminaux avec des thèmes clairs

Au premier lancement, Pi Agent détecte automatiquement la couleur d'arrière-plan de votre terminal et sélectionne dark ou light.

En mode interactif, tapez /settings et basculez directement dans les options de thème :

/settings

Vous pouvez également écrire le champ theme dans settings.json et remplacer la valeur de theme par le nom du thème :

Exemple

{
  "theme": "light"
}

Création de thèmes personnalisés

Tout d'abord, créez le répertoire et le fichier du thème :

mkdir -p ~/.pi/agent/themes
vim ~/.pi/agent/themes/my-theme.json

Ensuite, définissez le fichier de thème. Voici un exemple complet de thème personnalisé :

Exemple

{
  "name": "my-theme",
  "vars": {
    "blue": "#0066cc",
    "gray": 242,
    "orange": "#ffaa00",
    "green": "#0055AA"
  },
  "colors": {
    "accent": "blue",
    "border": "blue",
    "borderAccent": "#00ffff",
    "borderMuted": "gray",
    "success": "green",
    "error": "#ff0000",
    "warning": "#ffff00",
    "muted": "gray",
    "dim": 240,
    "text": "",
    "thinkingText": "gray",
    "selectedBg": "#2d2d30",
    "userMessageBg": "#2d2d30",
    "userMessageText": "",
    "customMessageBg": "#2d2d30",
    "customMessageText": "",
    "customMessageLabel": "bleu",
    "toolPendingBg": "#1e1e2e",
    "toolSuccessBg": "#1e2e1e",
    "toolErrorBg": "#2e1e1e",
    "toolTitle": "bleu",
    "toolOutput": "",
    "mdHeading": "orange",
    "mdLink": "bleu",
    "mdLinkUrl": "gris",
    "mdCode": "#00ffff",
    "mdCodeBlock": "",
    "mdCodeBlockBorder": "gray",
    "mdQuote": "gray",
    "mdQuoteBorder": "gray",
    "mdHr": "gray",
    "mdListBullet": "#00ffff",
    "toolDiffAdded": "green",
    "toolDiffRemoved": "#ff0000",
    "toolDiffContext": "gray",
    "syntaxComment": "gray",
    "syntaxKeyword": "blue",
    "syntaxFunction": "#00aaff",
    "syntaxVariable": "orange",
    "syntaxString": "green",
    "syntaxNumber": "#ff00ff",
    "syntaxType": "#00aaff",
    "syntaxOperator": "blue",
    "syntaxPunctuation": "gray",
    "thinkingOff": "gray",
    "thinkingMinimal": "blue",
    "thinkingLow": "#00aaff",
    "thinkingMedium": "#00ffff",
    "thinkingHigh": "#ff00ff",
    "thinkingXhigh": "#ff0000",
    "thinkingMax": "#ff0088",
    "bashMode": "orange"
  }
}

Ensuite, activez votre thème dans settings.json :

Exemple

{
  "theme": "my-theme"
}

Lorsque vous modifiez le fichier de thème personnalisé actuellement utilisé, Pi Agent recharge automatiquement le thème à chaud, ce qui vous permet de voir les modifications immédiatement sans aucune action.


Emplacements de chargement des fichiers de thème

Pi Agent recherche les fichiers de thème dans les emplacements suivants.

Les thèmes placés à différents emplacements ont des portées de visibilité et des conditions de chargement différentes.

EmplacementPortée
Intégrédark, light toujours disponibles
~/.pi/agent/themes/*.jsonThèmes globaux, disponibles pour tous les projets
.pi/themes/*.jsonThèmes du projet, chargés uniquement une fois le projet approuvé
Paquets Pirépertoire themes/ dans le paquet
--theme pathChargés temporairement via la ligne de commande

Formats de valeur de couleur

Pi Agent prend en charge quatre formats de valeur de couleur :

FormatExempleDescription
Couleur hexadécimale"#ff0000"Couleur RVB hexadécimale à 6 chiffres
Palette de 256 couleurs39Index de palette de 256 couleurs xterm (0-255)
Référence de variable"bleu"Référence une variable définie dans vars
Couleur par défaut du terminal""Utilise la couleur de premier plan/arrière-plan par défaut du terminal

La section vars est utilisée pour définir des variables de couleur réutilisables, référencées par leur nom dans colors.

Après avoir extrait les couleurs primaires dans des variables, changer le jeu de couleurs ne nécessite de modifier qu'un seul endroit, ce qui facilite la maintenance du thème.


Catégories de jetons de couleur

Chaque jeton dans colors correspond à la couleur d'une catégorie d'éléments de l'interface.

Ci-dessous, tous les jetons sont divisés en six catégories par usage pour faciliter la consultation.

Interface utilisateur principale (11)

Ce groupe contrôle les couleurs des éléments d'interface de base tels que l'éditeur et la barre d'état.

TokenObjectif
accentCouleur principale (Logo, éléments sélectionnés, curseur)
borderBordure normale
borderAccentBordure de surbrillance
borderMutedBordure douce pour la zone de l’éditeur
succèsStatut de réussite
errorStatut d’erreur
warningStatut d’avertissement
mutedTexte secondaire
dimTexte tertiaire (encore moins mis en avant)
textCouleur du texte par défaut (généralement laissée vide)
thinkingTextTexte du processus de raisonnement de l'IA

Arrière-plan et contenu (11 obligatoires + 3 optionnels)

Ce groupe contrôle l'arrière-plan et le texte des éléments sélectionnés, des bulles de message et des zones de sortie des outils.

TokenObjectif
selectedBgArrière-plan de l'élément sélectionné (entrée actuelle dans la liste)
userMessageBgArrière-plan du message utilisateur
userMessageTextTexte du message utilisateur
customMessageBgArrière-plan du message développé
customMessageTextTexte du message développé
customMessageLabelCouleur de l'étiquette de titre pour les messages développés
toolPendingBgArrière-plan d'exécution de l'outil
toolSuccessBgArrière-plan de réussite d'exécution de l'outil
toolErrorBgArrière-plan d'échec d'exécution de l'outil
toolTitleTexte du titre de la carte d'outil
toolOutputTexte de sortie de l'outil
scrollbarThumbCouleur du pouce de la barre de défilement en plein écran (facultative, revient à selectedBg si non définie)
searchMatchBgArrière-plan des correspondances de recherche (facultatif, revient à selectedBg si non défini)
searchMatchTextTexte des correspondances de recherche (facultatif, revient à text si non défini)

Rendu Markdown (10)

Ce groupe contrôle les couleurs des éléments Markdown dans les réponses de l'IA.

TokenObjectif
mdHeadingTitre
mdLinkTexte du lien
mdLinkUrlAdresse URL du lien
mdCodeCode en ligne
mdCodeBlockContenu du bloc de code
mdCodeBlockBorderBordure du bloc de code
mdQuoteTexte de la citation
mdQuoteBorderBordure de la citation
mdHrSéparateur
mdListBulletMarqueur de liste

Coloration syntaxique (9)

Ce groupe contrôle les couleurs de coloration syntaxique dans les blocs de code.

TokenObjectif
syntaxCommentCommentaire
syntaxKeywordKata kunci
syntaxFunctionNom de la fonction
syntaxVariableNom de la variable
syntaxStringString
syntaxNumberNumber
syntaxTypeType
syntaxOperatorOperator
syntaxPunctuationPonctuation

Bordures du niveau de raisonnement (7)

Ce groupe contrôle la couleur de l'indicateur du niveau de raisonnement actuel sur la bordure de l'éditeur.

TokenNiveau correspondant
thinkingOffRaisonnement désactivé
thinkingMinimalRaisonnement minimal
thinkingLowRaisonnement faible
thinkingMediumRaisonnement moyen
thinkingHighRaisonnement élevé
thinkingXhighRaisonnement très élevé
thinkingMaxRaisonnement maximal (facultatif)

thinkingMax est un token facultatif. S'il n'est pas défini, il revient à la couleur thinkingXhigh.

Couleurs Diff et Bash (4)

Ce groupe contrôle la coloration des diffs et les couleurs d'invite du mode bash — celles que vous voyez le plus souvent lors de l'édition de code.

TokenObjectif
toolDiffAddedlignes ajoutées du diff (généralement en vert)
toolDiffRemovedlignes supprimées du diff (généralement en rouge)
toolDiffContextlignes de contexte du diff (garder discrètes)
bashModeCouleur du prompt en mode bash

Couleurs d'export HTML

Si vous utilisez /export pour exporter une session au format HTML, vous pouvez définir les couleurs de la page exportée dans le thème :

Exemple

{
  "export": {
    "pageBg": "#18181e",
    "cardBg": "#1e1e24",
    "infoBg": "#3c3728"
  }
}

Si la configuration d'export est omise, la page exportée reprend automatiquement les couleurs de userMessageBg.


Conseils pour créer un thème

Les conseils suivants aideront votre thème personnalisé à se comporter de manière cohérente sur différents terminaux.

  • Terminaux sombres: Utilisez des couleurs vives et saturées avec un contraste suffisamment élevé
  • Terminaux clairs: Utilisez des couleurs plus profondes et plus douces ; le contraste peut être réduit de manière appropriée
  • Harmonie des couleurs: Inspirez-vous de palettes de couleurs éprouvées telles que Nord, Gruvbox et Tokyo Night comme base
  • Testez minutieusementAssurez un affichage correct pour différents types de messages, états d’outils, contenus Markdown et retour à la ligne des textes longs
Autres extensions