Qwen Code Extensions

Qwen Code Extensions packen Prompts, MCP-Server und benutzerdefinierte Befehle in ein vertrautes und benutzerfreundliches Format. Mit Extensions kannst du die Funktionalitäten von Qwen Code erweitern und diese Funktionen mit anderen teilen. Sie sind so konzipiert, dass sie einfach zu installieren und zu teilen sind.

Extension-Verwaltung

Wir bieten eine Suite von Tools zur Verwaltung von Extensions über die qwen extensions Befehle an.

Beachte, dass diese Befehle nicht innerhalb der CLI unterstützt werden, obwohl du installierte Extensions mit dem Subbefehl /extensions list auflisten kannst.

Beachte, dass alle diese Befehle erst in aktiven CLI-Sitzungen nach einem Neustart wirksam werden.

Installation einer Extension

Du kannst eine Extension mit qwen extensions install entweder über eine GitHub-URL oder einen lokalen Pfad installieren.

Beachte, dass wir eine Kopie der installierten Extension erstellen. Wenn du Änderungen aus lokal definierten Extensions oder von GitHub übernehmen möchtest, musst du qwen extensions update ausführen.

qwen extensions install https://github.com/qwen-cli-extensions/security

Damit wird die Qwen Code Security Extension installiert, welche Unterstützung für den Befehl /security:analyze bietet.

Deinstallation einer Extension

Zum Deinstallieren führe qwen extensions uninstall extension-name aus. Im Fall des vorherigen Beispiels wäre das:

qwen extensions uninstall qwen-cli-security

Eine Erweiterung deaktivieren

Erweiterungen sind standardmäßig in allen Workspaces aktiviert. Du kannst eine Erweiterung entweder komplett oder nur für einen bestimmten Workspace deaktivieren.

Beispiel: qwen extensions disable extension-name deaktiviert die Erweiterung auf Benutzerebene, sodass sie überall deaktiviert ist. Mit qwen extensions disable extension-name --scope=workspace wird die Erweiterung nur im aktuellen Workspace deaktiviert.

Eine Erweiterung aktivieren

Du kannst Erweiterungen mit qwen extensions enable extension-name aktivieren. Es ist auch möglich, eine Erweiterung gezielt für einen Workspace zu aktivieren, indem du qwen extensions enable extension-name --scope=workspace innerhalb dieses Workspaces ausführst.

Das ist besonders nützlich, wenn du eine Erweiterung global deaktiviert hast und sie nur an bestimmten Orten aktivieren möchtest.

Aktualisieren einer Erweiterung

Für Erweiterungen, die von einem lokalen Pfad oder einem Git-Repository installiert wurden, kannst du explizit auf die neueste Version aktualisieren (gemäß dem version-Feld in der qwen-extension.json) mit:

qwen extensions update extension-name

Du kannst alle Erweiterungen gleichzeitig aktualisieren mit:

qwen extensions update --all

Erstellung von Erweiterungen

Wir bieten Befehle an, um die Entwicklung von Erweiterungen zu vereinfachen.

Eine Boilerplate-Erweiterung erstellen

Wir stellen mehrere Beispiel-Erweiterungen bereit: context, custom-commands, exclude-tools und mcp-server. Diese Beispiele findest du hier .

Um eines dieser Beispiele in ein Entwicklungsverzeichnis zu kopieren, verwende den Befehl mit dem gewünschten Typ:

qwen extensions new path/to/directory custom-commands

Lokale Extension verknüpfen

Der Befehl qwen extensions link erstellt einen symbolischen Link vom Installationsverzeichnis der Extension zum Entwicklungsverzeichnis.

Das ist nützlich, damit du nicht jedes Mal qwen extensions update ausführen musst, wenn du Änderungen testen möchtest.

qwen extensions link path/to/directory

So funktioniert es

Beim Start sucht Qwen Code nach Extensions im Verzeichnis <home>/.qwen/extensions

Extensions liegen als Verzeichnis vor, das eine qwen-extension.json Datei enthält. Zum Beispiel:

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

qwen-extension.json

Die Datei qwen-extension.json enthält die Konfiguration für die Extension. Die Datei hat folgende Struktur:

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

• name: Der Name der Extension. Dieser wird verwendet, um die Extension eindeutig zu identifizieren und zur Auflösung von Namenskonflikten, wenn Extension-Befehle denselben Namen wie Benutzer- oder Projekt-Befehle haben. Der Name sollte aus Kleinbuchstaben oder Zahlen bestehen und Bindestriche statt Unterstriche oder Leerzeichen verwenden. So werden Benutzer deine Extension in der CLI ansprechen. Beachte, dass wir erwarten, dass dieser Name mit dem Verzeichnisnamen der Extension übereinstimmt.
• version: Die Version der Extension.
• mcpServers: Eine Map von MCP-Servern, die konfiguriert werden sollen. Der Schlüssel ist der Name des Servers, der Wert ist die Server-Konfiguration. Diese Server werden beim Start genauso geladen wie MCP-Server, die in einer settings.json-Datei konfiguriert sind. Wenn sowohl eine Extension als auch eine settings.json-Datei einen MCP-Server mit demselben Namen konfigurieren, hat der in der settings.json-Datei definierte Server Vorrang.
  • Beachte, dass alle MCP-Server-Konfigurationsoptionen unterstützt werden, außer trust.
• contextFileName: Der Name der Datei, die den Kontext für die Extension enthält. Diese wird verwendet, um den Kontext aus dem Extension-Verzeichnis zu laden. Wenn diese Eigenschaft nicht gesetzt ist, aber eine QWEN.md-Datei im Extension-Verzeichnis vorhanden ist, wird diese Datei geladen.
• excludeTools: Ein Array von Tool-Namen, die vom Modell ausgeschlossen werden sollen. Du kannst auch spezifische Einschränkungen für Befehle angeben, bei Tools, die dies unterstützen – wie z. B. das run_shell_command-Tool. Beispiel: "excludeTools": ["run_shell_command(rm -rf)"] blockiert den rm -rf-Befehl. Beachte, dass sich dies vom excludeTools-Feature der MCP-Server unterscheidet, welches direkt in der MCP-Server-Konfiguration aufgeführt werden kann. Wichtig: Tools, die unter excludeTools angegeben sind, werden für den gesamten Gesprächskontext deaktiviert und beeinflussen alle nachfolgenden Abfragen in der aktuellen Sitzung.

Wenn Qwen Code startet, lädt es alle Extensions und führt deren Konfigurationen zusammen. Bei Konflikten hat die Workspace-Konfiguration Vorrang.

Custom Commands

Erweiterungen können Custom Commands bereitstellen, indem sie TOML-Dateien in einem commands/ Unterverzeichnis innerhalb des Erweiterungsverzeichnisses ablegen. Diese Commands folgen dem gleichen Format wie benutzerdefinierte und projektspezifische Custom Commands und verwenden standardisierte Namenskonventionen.

Beispiel

Eine Erweiterung mit dem Namen gcp und folgender Struktur:

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

Stellt diese Commands zur Verfügung:

• /deploy - Wird in der Hilfe als [gcp] Custom command from deploy.toml angezeigt
• /gcs:sync - Wird in der Hilfe als [gcp] Custom command from sync.toml angezeigt

Konfliktlösung

Erweiterungsbefehle haben die niedrigste Priorität. Wenn ein Konflikt mit Benutzer- oder Projektbefehlen auftritt:

1. Kein Konflikt: Der Erweiterungsbefehl verwendet seinen natürlichen Namen (z.B. /deploy)
2. Mit Konflikt: Der Erweiterungsbefehl wird mit dem Erweiterungspräfix umbenannt (z.B. /gcp.deploy)

Wenn zum Beispiel sowohl ein Benutzer als auch die gcp-Erweiterung einen deploy-Befehl definieren:

• /deploy - Führt den Deploy-Befehl des Benutzers aus
• /gcp.deploy - Führt den Deploy-Befehl der Erweiterung aus (markiert mit dem [gcp]-Tag)

Variablen

Qwen Code Erweiterungen erlauben die Verwendung von Variablen in qwen-extension.json. Dies kann nützlich sein, wenn du z. B. das aktuelle Verzeichnis benötigst, um einen MCP-Server mit "cwd": "${extensionPath}${/}run.ts" zu starten.

Unterstützte Variablen: