Thèmes

Qwen Code prend en charge une variété de thèmes pour personnaliser sa palette de couleurs et son apparence. Vous pouvez changer de thème selon vos préférences via la commande /theme ou le paramètre de configuration "ui.theme".

Thèmes disponibles

Qwen Code est livré avec une sélection de thèmes prédéfinis, que vous pouvez lister en utilisant la commande /theme dans le CLI :

Thèmes sombres :
- ANSI
- Atom One
- Ayu
- Default
- Dracula
- GitHub
- Qwen Dark
- Shades Of Purple
Thèmes clairs :
- ANSI Light
- Ayu Light
- Default Light
- GitHub Light
- Google Code
- Qwen Light
- Xcode

Changer de thème

Tapez /theme dans Qwen Code.
Une boîte de dialogue ou une invite de sélection apparaît, listant les thèmes disponibles.
Utilisez les touches fléchées pour sélectionner un thème. Certaines interfaces peuvent proposer un aperçu en direct ou une mise en surbrillance lors de la sélection.
Confirmez votre sélection pour appliquer le thème.

Remarque : Si un thème est défini dans votre fichier settings.json (par son nom ou par un chemin de fichier), vous devez supprimer le paramètre "ui.theme" du fichier avant de pouvoir changer de thème via la commande /theme.

Persistance du thème

Les thèmes sélectionnés sont sauvegardés dans la configuration de Qwen Code afin que votre préférence soit conservée entre les sessions.

Détection automatique du thème

Lorsque le thème est réglé sur "auto" (ou laissé non défini), Qwen Code détecte automatiquement si votre terminal utilise un fond sombre ou clair et sélectionne le thème Qwen correspondant (Qwen Dark ou Qwen Light).

Comment activer

Définissez le thème sur "auto" dans settings.json :


{
  "ui": {
    "theme": "auto"
  }
}

Ou sélectionnez Auto dans la boîte de dialogue /theme. C’est le comportement par défaut lorsqu’aucun thème n’est explicitement configuré.

Méthodes de détection

Qwen Code utilise plusieurs méthodes de détection en cascade. Au démarrage (chemin asynchrone), l’ordre est :

Priorité	Méthode	Plateforme	Fonctionnement
1	`COLORFGBG`	Toutes	Lit la variable d’environnement `COLORFGBG` (définie par des terminaux comme iTerm2, rxvt, Konsole)
2	OSC 11	Toutes (TTY)	Envoie une requête `ESC]11;?` au terminal et analyse la couleur d’arrière-plan dans la réponse (~200 ms)
3	Apparence système macOS	macOS uniquement	Exécute `defaults read -g AppleInterfaceStyle` pour vérifier si le mode sombre macOS est actif
4	Défaut	Toutes	Repli sur le thème sombre si aucune méthode ne réussit

La première méthode qui renvoie un résultat gagne. La valeur détectée est mise en cache pour la session, de sorte que les résolutions de thème ultérieures (par exemple, la resélection d’Auto dans la boîte de dialogue /theme) restent cohérentes.

Quand utiliser Auto

La plupart des utilisateurs — Auto fonctionne bien si l’arrière-plan de votre terminal correspond à l’apparence de votre système d’exploitation ou si votre terminal définit COLORFGBG / prend en charge OSC 11.
Utilisateurs de tmux / screen — OSC 11 peut ne pas traverser les multiplexeurs. La détection se rabat sur COLORFGBG ou l’apparence système macOS. Si aucun n’est disponible, le thème sombre par défaut est utilisé. Définissez un thème spécifique si la détection automatique donne un mauvais résultat.
Sessions SSH — la détection dépend de l’environnement distant. Si COLORFGBG n’est pas transféré et que le terminal distant ne répond pas à OSC 11, le thème sombre par défaut est utilisé.

Thèmes de couleurs personnalisés

Qwen Code vous permet de créer vos propres thèmes de couleurs personnalisés en les spécifiant dans votre fichier settings.json. Cela vous donne un contrôle total sur la palette de couleurs utilisée dans le CLI.

Comment définir un thème personnalisé

Ajoutez un bloc customThemes à votre fichier settings.json utilisateur, projet ou système. Chaque thème personnalisé est défini comme un objet avec un nom unique et un ensemble de clés de couleurs. Par exemple :


{
  "ui": {
    "customThemes": {
      "MyCustomTheme": {
        "name": "MyCustomTheme",
        "type": "custom",
        "Background": "#181818",
        ...
      }
    }
  }
}

Clés de couleurs :

Background
Foreground
LightBlue
AccentBlue
AccentPurple
AccentCyan
AccentGreen
AccentYellow
AccentRed
Comment
Gray
DiffAdded (optionnel, pour les lignes ajoutées dans les diffs)
DiffRemoved (optionnel, pour les lignes supprimées dans les diffs)
DiffModified (optionnel, pour les lignes modifiées dans les diffs)

Propriétés requises :

name (doit correspondre à la clé dans l’objet customThemes et être une chaîne de caractères)
type (doit être la chaîne "custom")
Background
Foreground
LightBlue
AccentBlue
AccentPurple
AccentCyan
AccentGreen
AccentYellow
AccentRed
Comment
Gray

Vous pouvez utiliser soit des codes hexadécimaux (par ex. #FF0000) soit des noms de couleurs CSS standard (par ex. coral, teal, blue) pour toute valeur de couleur. Consultez noms de couleurs CSS pour une liste complète des noms pris en charge. Vous pouvez définir plusieurs thèmes personnalisés en ajoutant d’autres entrées à l’objet customThemes.

Chargement des thèmes depuis un fichier

En plus de définir des thèmes personnalisés dans settings.json, vous pouvez également charger un thème directement depuis un fichier JSON en spécifiant le chemin du fichier dans votre settings.json. Cela est utile pour partager des thèmes ou les garder séparés de votre configuration principale.

Pour charger un thème depuis un fichier, définissez la propriété ui.theme dans votre settings.json avec le chemin de votre fichier de thème :


{
  "ui": {
    "theme": "/path/to/your/theme.json"
  }
}

Le fichier de thème doit être un fichier JSON valide qui respecte la même structure qu’un thème personnalisé défini dans settings.json.

Exemple my-theme.json :


{
  "name": "My File Theme",
  "type": "custom",
  "Background": "#282A36",
  "Foreground": "#F8F8F2",
  "LightBlue": "#82AAFF",
  "AccentBlue": "#61AFEF",
  "AccentPurple": "#BD93F9",
  "AccentCyan": "#8BE9FD",
  "AccentGreen": "#50FA7B",
  "AccentYellow": "#F1FA8C",
  "AccentRed": "#FF5555",
  "Comment": "#6272A4",
  "Gray": "#ABB2BF",
  "DiffAdded": "#A6E3A1",
  "DiffRemoved": "#F38BA8",
  "DiffModified": "#89B4FA",
  "GradientColors": ["#4796E4", "#847ACE", "#C3677F"]
}

Note de sécurité : Pour votre sécurité, Qwen Code ne chargera que les fichiers de thème situés dans votre répertoire personnel. Si vous tentez de charger un thème depuis l’extérieur de votre répertoire personnel, un avertissement s’affichera et le thème ne sera pas chargé. Ceci afin d’éviter de charger des fichiers de thème potentiellement malveillants provenant de sources non fiables.

Exemple de thème personnalisé

Utilisation de votre thème personnalisé

Sélectionnez votre thème personnalisé à l’aide de la commande /theme dans Qwen Code. Votre thème personnalisé apparaîtra dans la boîte de dialogue de sélection de thème.
Ou, définissez-le comme thème par défaut en ajoutant "theme": "MyCustomTheme" à l’objet ui dans votre settings.json.
Les thèmes personnalisés peuvent être définis au niveau utilisateur, projet ou système, et suivent la même hiérarchie de configuration que les autres paramètres.

Aperçu des thèmes

Thème sombre	Aperçu	Thème clair	Aperçu
ANSI		ANSI Light
Atom OneDark		Ayu Light
Ayu		Default Light
Default		GitHub Light
Dracula		Google Code
GitHub		Xcode