Commandes

Ce document détaille toutes les commandes prises en charge par Qwen Code, vous aidant à gérer efficacement les sessions, personnaliser l’interface et contrôler son comportement.

Les commandes Qwen Code sont déclenchées via des préfixes spécifiques et se répartissent en trois catégories :

1. Commandes slash (/)

Les commandes slash sont utilisées pour gérer les sessions Qwen Code, l’interface et le comportement de base.

1.1 Gestion des sessions et des projets

Ces commandes vous aident à enregistrer, restaurer et résumer l’avancement du travail.

1.2 Contrôle de l’interface et de l’espace de travail

Commandes pour ajuster l’apparence de l’interface et l’environnement de travail.

1.3 Paramètres de langue

Commandes spécifiques pour contrôler la langue de l’interface et de la sortie.

• Langues d’interface intégrées disponibles : zh-CN (Chinois simplifié), en-US (Anglais), ru-RU (Russe), de-DE (Allemand), ja-JP (Japonais), pt-BR (Portugais – Brésil), fr-FR (Français), ca-ES (Catalan)
• Exemples de langues de sortie : Chinese, English, Japanese, etc.

1.4 Gestion des outils et des modèles

Commandes de gestion des outils et modèles d’IA.

1.5 Compétences intégrées

Ces commandes invoquent des compétences intégrées qui fournissent des workflows spécialisés.

Voir Code Review pour la documentation complète de /review.

1.6 Question annexe (/btw)

La commande /btw vous permet de poser rapidement des questions annexes sans interrompre ni affecter le flux principal de la conversation.

Fonctionnement :

• La question annexe est envoyée via un appel API séparé avec le contexte de la conversation récente (jusqu’aux 20 derniers messages)
• La réponse s’affiche au-dessus du Composer — vous pouvez continuer à taper en attendant
• La conversation principale n’est pas bloquée — elle se poursuit indépendamment
• La réponse à la question annexe ne fait pas partie de l’historique de la conversation principale
• Les réponses sont rendues avec le support complet de Markdown (blocs de code, listes, tableaux, etc.)

Raccourcis clavier (mode interactif) :

Exemple :

(Pendant que la conversation principale porte sur le refactoring de code)

> /btw Quelle est la différence entre let et var en JavaScript ?

  ╭──────────────────────────────────────────╮
  │ /btw Quelle est la différence entre let  │
  │     et var en JavaScript ?               │
  │                                          │
  │ + Réponse en cours...                    │
  │ Appuyez sur Échap, Ctrl+C ou Ctrl+D      │
  │ pour annuler                             │
  ╰──────────────────────────────────────────╯
  > (Le Composer reste actif — continuez de taper)

(Après l'arrivée de la réponse)

  ╭──────────────────────────────────────────╮
  │ /btw Quelle est la différence entre let  │
  │     et var en JavaScript ?               │
  │                                          │
  │ `let` a une portée de bloc, tandis que   │
  │ `var` a une portée de fonction. `let`    │
  │ a été introduit dans ES6 et ne remonte   │
  │ pas de la même manière.                  │
  │                                          │
  │ Appuyez sur Espace, Entrée ou Échap      │
  │ pour fermer                              │
  ╰──────────────────────────────────────────╯
  > (Composer toujours actif)

Modes d’exécution pris en charge :

1.7 Récapitulatif de session (/recap)

La commande /recap génère un court résumé de « là où vous vous êtes arrêté » de la session en cours, afin que vous puissiez reprendre une ancienne conversation sans faire défiler des pages d’historique.

Fonctionnement :

• Utilise le modèle rapide configuré (paramètre fastModel) lorsqu’il est disponible, en revenant au modèle de session principal. Un modèle petit et peu coûteux suffit pour un récapitulatif.
• La conversation récente (jusqu’à 30 messages, texte uniquement — les appels d’outils et les réponses d’outils sont filtrés) est envoyée au modèle avec une invite système concise.
• Le récapitulatif est rendu dans une couleur atténuée avec un préfixe ❯ afin qu’il se distingue des vraies réponses de l’assistant.
• Refuse avec une erreur en ligne si un tour de modèle est en cours ou si une autre commande est en cours de traitement. S’il n’y a pas de conversation utilisable, ou si la génération sous-jacente échoue, /recap affiche un court message d’information au lieu d’un récapitulatif — la commande manuelle répond toujours quelque chose. Déclenchement automatique au retour d’absence :

Si le terminal est flouté pendant 5 minutes ou plus et qu’il est de nouveau actif, un récapitulatif est généré et affiché automatiquement (uniquement lorsqu’aucune réponse du modèle n’est en cours ; sinon, il attend la fin du tour en cours puis se déclenche). Contrairement à la commande manuelle, le déclenchement automatique est totalement silencieux en cas d’échec : si la génération échoue ou s’il n’y a rien à résumer, aucun message n’est ajouté à l’historique. Contrôlé par le paramètre general.showSessionRecap (valeur par défaut : false) ; la commande manuelle /recap fonctionne toujours, quelle que soit la valeur de ce paramètre.

Exemple :

> /recap

❯ Refactoring loopDetectionService.ts to address long-session OOM caused by
  unbounded streamContentHistory and contentStats. The next step is to
  implement option B (LRU sliding window with FNV-1a) pending confirmation.

1.8 Visionneuse de différences (/diff)

La commande /diff ouvre une visionneuse interactive de différences montrant les modifications non validées et les différences par tour. Utilisez ←/→ pour basculer entre le diff git actuel et les tours de conversation individuels, ↑/↓ pour parcourir les fichiers, et Entrée pour voir les différences en ligne.

Fonctionnement :

En mode interactif, /diff ouvre une boîte de dialogue avec un sélecteur de source en haut :

• Actuel — arbre de travail vs HEAD (git diff HEAD). Affiche toutes les modifications non validées, y compris les fichiers indexés, non indexés et non suivis.
• T1, T2, T3, … — différences par tour, un onglet par tour du modèle ayant modifié des fichiers. Les tours les plus récents apparaissent en premier. Chaque onglet affiche un aperçu de la demande initiale pour replacer le contexte.

La liste des fichiers affiche les statistiques par fichier (lignes ajoutées/supprimées) avec des étiquettes pour les états spéciaux (new, deleted, untracked, binary, truncated, oversized). Appuyez sur Entrée sur un fichier pour voir sa différence en ligne avec les blocs surlignés syntaxiquement.

Les différences par tour nécessitent que la création de points de contrôle de fichier soit activée (activée par défaut en mode interactif). Lorsque la création de points de contrôle est désactivée, seule la source « Actuel » est disponible.

Raccourcis clavier :

Exemple :

┌ /diff · Turn 3 "refactor the auth middleware" ──── 3 files +45 -12 ┐
│                                                                     │
│ ◀ Current · T3 · T2 · T1 ▶                                         │
│                                                                     │
│ › src/utils/parser.ts                              +30 -8           │
│   src/utils/parser.test.ts                         +12 -2           │
│   README.md                                        +3 -2            │
│                                                                     │
│ ←/→ source · ↑/↓ file · Enter view · Esc close                     │
└─────────────────────────────────────────────────────────────────────┘

Mode non interactif :

En contexte non interactif ou headless (--prompt), /diff affiche un résumé en texte brut de l’arbre de travail par rapport à HEAD. La navigation par tour n’est pas disponible.

3 files changed, +45 / -12
  +30  -8  src/utils/parser.ts
  +12  -2  src/utils/parser.test.ts
   +3  -2  README.md

1.9 Informations, paramètres et aide

Commandes pour obtenir des informations et effectuer des réglages système.

1.10 Raccourcis courants

1.11 Commandes d’authentification

Utilisez /auth dans une session Qwen Code pour configurer l’authentification. Utilisez /doctor pour inspecter l’état actuel de l’authentification et de l’environnement.

2. Commandes @ (Introduction de fichiers)

Les commandes @ sont utilisées pour ajouter rapidement le contenu d’un fichier ou d’un répertoire local à la conversation.

Remarque : Les espaces dans les chemins doivent être échappés avec une barre oblique inverse (p. ex., @My\ Documents/fichier.txt)

3. Commandes Exclamation (!) - Exécution de commandes Shell

Les commandes Exclamation vous permettent d’exécuter des commandes système directement dans Qwen Code.

Variables d’environnement : Les commandes exécutées via ! définiront la variable d’environnement QWEN_CODE=1.

4. Commandes personnalisées

Enregistrez les invites fréquemment utilisées comme commandes de raccourci pour améliorer l’efficacité du travail et assurer la cohérence.

Aperçu rapide

Règles de priorité : Commandes projet > Commandes utilisateur (la commande projet est utilisée lorsque les noms sont identiques)

Règles de nommage des commandes

Table de correspondance entre chemin de fichier et nom de commande

Règle de nommage : Le séparateur de chemin (/ ou \) est converti en deux-points (:)

Spécification du format de fichier Markdown (recommandé)

Les commandes personnalisées utilisent des fichiers Markdown avec un frontmatter YAML optionnel :

---
description: Description optionnelle (affichée dans /help)
---
 
Votre contenu d'invite ici.
Utilisez {{args}} pour l'injection de paramètres.

Format de fichier TOML (Obsolète)

Mécanisme de traitement des paramètres

1. Injection contextuelle ({{args}})

2. Traitement par défaut des paramètres

🚀 Injection de contenu dynamique

3. Exécution de commande Shell (!{...})

Exemple : Génération de message de commit Git

---
description: Generate Commit message based on staged changes
---
 
Veuillez générer un message de commit basé sur la différence suivante :
 
```diff
!{git diff --staged}
```

4. Injection de contenu de fichier (@{...})

Exemple : Commande de revue de code

---
description: Code review based on best practices
---
 
Examinez {{args}}, référez-vous aux normes :
 
@{docs/code-standards.md}

Exemple pratique de création

Tableau des étapes de création de la commande « Refactorisation de fonction pure »

---
description: Refactor code to pure function
---
 
Veuillez analyser le code dans le contexte actuel, le refactoriser en fonction pure.
Exigences :
 
1. Fournir le code refactorisé
2. Expliquer les changements clés et la mise en œuvre des caractéristiques de la fonction pure
3. Maintenir la fonction inchangée

Résumé des bonnes pratiques pour les commandes personnalisées

Tableau de recommandations pour la conception des commandes

Rappel des fonctionnalités de sécurité

5. Sous-commandes CLI

Ces commandes sont exécutées depuis le shell avec qwen <sous-commande> avant de démarrer une session interactive.

Gestion des sessions

qwen sessions list

Liste vos sessions récentes de Qwen Code avec leurs métadonnées.

Indicateurs :

Sortie lisible par un humain (par défaut) :

Un tableau avec les colonnes : SESSION ID, STARTED (horodatage UTC), TITLE, BRANCH, PROMPT.

Sortie JSON (--json) :

Produit des lignes JSON sur stdout. Chaque ligne est un objet JSON avec les champs :

sessionId, startTime, mtime, prompt, gitBranch, customTitle, titleSource, filePath, cwd

L’indication « has more sessions » est émise via stderr pour que le pipage vers jq reste sûr.

Exemples :

# Afficher les 20 dernières sessions (par défaut)
qwen sessions list
 
# Afficher les 50 dernières sessions
qwen sessions list --limit 50
 
# Sortie au format JSON pour le scripting
qwen sessions list --json | jq .