Extensions Qwen Code

Qwen Code prend en charge les extensions qui peuvent être utilisées pour configurer et étendre ses fonctionnalités.

Fonctionnement

Au démarrage, Qwen Code recherche les extensions dans deux emplacements :

1. <workspace>/.qwen/extensions
2. <home>/.qwen/extensions

Qwen Code charge toutes les extensions depuis ces deux emplacements. Si une extension portant le même nom existe dans les deux emplacements, l’extension du répertoire workspace prend le dessus.

Dans chaque emplacement, les extensions individuelles existent sous forme de répertoire contenant un fichier qwen-extension.json. Par exemple :

<workspace>/.qwen/extensions/my-extension/qwen-extension.json

qwen-extension.json

Le fichier qwen-extension.json contient la configuration de l’extension. Le fichier a la structure suivante :

{
  "name": "my-extension",
  "version": "1.0.0",
  "mcpServers": {
    "my-server": {
      "command": "node my-server.js"
    }
  },
  "contextFileName": "QWEN.md",
  "excludeTools": ["run_shell_command"]
}

• name : Le nom de l’extension. Il est utilisé pour identifier de manière unique l’extension et pour résoudre les conflits lorsque les commandes de l’extension portent le même nom que les commandes utilisateur ou projet.
• version : La version de l’extension.
• mcpServers : Une map des serveurs MCP à configurer. La clé est le nom du serveur, et la valeur est la configuration du serveur. Ces serveurs seront chargés au démarrage, tout comme les serveurs MCP configurés dans un fichier settings.json. Si à la fois une extension et un fichier settings.json configurent un serveur MCP avec le même nom, le serveur défini dans le fichier settings.json prend la priorité.
• contextFileName : Le nom du fichier contenant le contexte de l’extension. Il sera utilisé pour charger le contexte depuis l’espace de travail. Si cette propriété n’est pas utilisée mais qu’un fichier QWEN.md est présent dans le répertoire de votre extension, alors ce fichier sera chargé.
• excludeTools : Un tableau de noms d’outils à exclure du modèle. Vous pouvez également spécifier des restrictions spécifiques aux commandes pour les outils qui le permettent, comme l’outil run_shell_command. Par exemple, "excludeTools": ["run_shell_command(rm -rf)"] bloquera la commande rm -rf.

Lorsque Qwen Code démarre, il charge toutes les extensions et fusionne leurs configurations. En cas de conflit, la configuration de l’espace de travail prend la priorité.

Commandes d’extension

Les extensions peuvent fournir des commandes personnalisées en plaçant des fichiers TOML dans un sous-répertoire commands/ au sein du répertoire de l’extension. Ces commandes suivent le même format que les commandes personnalisées utilisateur et projet, et utilisent les conventions de nommage standard.

Exemple

Une extension nommée gcp avec la structure suivante :

.qwen/extensions/gcp/
├── qwen-extension.json
└── commands/
    ├── deploy.toml
    └── gcs/
        └── sync.toml

Fournirait ces commandes :

• /deploy - Apparaît comme [gcp] Custom command from deploy.toml dans l’aide
• /gcs:sync - Apparaît comme [gcp] Custom command from sync.toml dans l’aide

Résolution des conflits

Les commandes d’extension ont la priorité la plus faible. Lorsqu’un conflit survient avec les commandes utilisateur ou projet :

1. Pas de conflit : La commande d’extension utilise son nom naturel (ex. : /deploy)
2. Avec conflit : La commande d’extension est renommée avec le préfixe de l’extension (ex. : /gcp.deploy)

Par exemple, si à la fois un utilisateur et l’extension gcp définissent une commande deploy :

• /deploy - Exécute la commande deploy de l’utilisateur
• /gcp.deploy - Exécute la commande deploy de l’extension (marquée avec le tag [gcp])

Installation des extensions

Vous pouvez installer des extensions en utilisant la commande install. Cette commande vous permet d’installer des extensions depuis un dépôt Git ou un chemin local.

Utilisation

qwen extensions install <source> | [options]

Options

• source <url> positional argument : L’URL d’un repository Git à partir duquel installer l’extension. Le repository doit contenir un fichier qwen-extension.json à sa racine.
• --path <path> : Le chemin vers un répertoire local à installer comme extension. Le répertoire doit contenir un fichier qwen-extension.json.

Variables

Les extensions Qwen Code permettent la substitution de variables dans le fichier qwen-extension.json. Cela peut être utile si, par exemple, vous avez besoin du répertoire courant pour exécuter un serveur MCP en utilisant "cwd": "${extensionPath}${/}run.ts".

Variables supportées :