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ème | Scénario applicable | Description |
|---|---|---|
| dark | Fond de terminal sombre (par défaut) | Adapté aux terminaux sombres utilisés par la plupart des développeurs |
| light | Fond de terminal clair | Adapté 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.
| Emplacement | Portée |
|---|---|
| Intégré | dark, light toujours disponibles |
| ~/.pi/agent/themes/*.json | Thèmes globaux, disponibles pour tous les projets |
| .pi/themes/*.json | Thèmes du projet, chargés uniquement une fois le projet approuvé |
| Paquets Pi | répertoire themes/ dans le paquet |
| --theme path | Chargés temporairement via la ligne de commande |
Formats de valeur de couleur
Pi Agent prend en charge quatre formats de valeur de couleur :
| Format | Exemple | Description |
|---|---|---|
| Couleur hexadécimale | "#ff0000" | Couleur RVB hexadécimale à 6 chiffres |
| Palette de 256 couleurs | 39 | Index 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.
| Token | Objectif |
|---|---|
| accent | Couleur principale (Logo, éléments sélectionnés, curseur) |
| border | Bordure normale |
| borderAccent | Bordure de surbrillance |
| borderMuted | Bordure douce pour la zone de l’éditeur |
| succès | Statut de réussite |
| error | Statut d’erreur |
| warning | Statut d’avertissement |
| muted | Texte secondaire |
| dim | Texte tertiaire (encore moins mis en avant) |
| text | Couleur du texte par défaut (généralement laissée vide) |
| thinkingText | Texte 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.
| Token | Objectif |
|---|---|
| selectedBg | Arrière-plan de l'élément sélectionné (entrée actuelle dans la liste) |
| userMessageBg | Arrière-plan du message utilisateur |
| userMessageText | Texte du message utilisateur |
| customMessageBg | Arrière-plan du message développé |
| customMessageText | Texte du message développé |
| customMessageLabel | Couleur de l'étiquette de titre pour les messages développés |
| toolPendingBg | Arrière-plan d'exécution de l'outil |
| toolSuccessBg | Arrière-plan de réussite d'exécution de l'outil |
| toolErrorBg | Arrière-plan d'échec d'exécution de l'outil |
| toolTitle | Texte du titre de la carte d'outil |
| toolOutput | Texte de sortie de l'outil |
| scrollbarThumb | Couleur du pouce de la barre de défilement en plein écran (facultative, revient à selectedBg si non définie) |
| searchMatchBg | Arrière-plan des correspondances de recherche (facultatif, revient à selectedBg si non défini) |
| searchMatchText | Texte 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.
| Token | Objectif |
|---|---|
| mdHeading | Titre |
| mdLink | Texte du lien |
| mdLinkUrl | Adresse URL du lien |
| mdCode | Code en ligne |
| mdCodeBlock | Contenu du bloc de code |
| mdCodeBlockBorder | Bordure du bloc de code |
| mdQuote | Texte de la citation |
| mdQuoteBorder | Bordure de la citation |
| mdHr | Séparateur |
| mdListBullet | Marqueur de liste |
Coloration syntaxique (9)
Ce groupe contrôle les couleurs de coloration syntaxique dans les blocs de code.
| Token | Objectif |
|---|---|
| syntaxComment | Commentaire |
| syntaxKeyword | Kata kunci |
| syntaxFunction | Nom de la fonction |
| syntaxVariable | Nom de la variable |
| syntaxString | String |
| syntaxNumber | Number |
| syntaxType | Type |
| syntaxOperator | Operator |
| syntaxPunctuation | Ponctuation |
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.
| Token | Niveau correspondant |
|---|---|
| thinkingOff | Raisonnement désactivé |
| thinkingMinimal | Raisonnement minimal |
| thinkingLow | Raisonnement faible |
| thinkingMedium | Raisonnement moyen |
| thinkingHigh | Raisonnement élevé |
| thinkingXhigh | Raisonnement très élevé |
| thinkingMax | Raisonnement 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.
| Token | Objectif |
|---|---|
| toolDiffAdded | lignes ajoutées du diff (généralement en vert) |
| toolDiffRemoved | lignes supprimées du diff (généralement en rouge) |
| toolDiffContext | lignes de contexte du diff (garder discrètes) |
| bashMode | Couleur 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