Befehle

Dieses Dokument beschreibt alle von Qwen Code unterstützten Befehle und hilft Ihnen, Sitzungen effizient zu verwalten, die Oberfläche anzupassen und das Verhalten zu steuern.

Qwen Code-Befehle werden durch bestimmte Präfixe ausgelöst und fallen in drei Kategorien:

1. Slash-Befehle (/)

Slash-Befehle werden verwendet, um Qwen Code-Sitzungen, die Oberfläche und das grundlegende Verhalten zu verwalten.

1.1 Sitzungs- und Projektverwaltung

Diese Befehle helfen Ihnen, Arbeitsfortschritte zu speichern, wiederherzustellen und zusammenzufassen.

1.2 Oberflächen- und Arbeitsbereichssteuerung

Befehle zum Anpassen des Oberflächenerscheinungsbilds und der Arbeitsumgebung.

1.3 Spracheinstellungen

Befehle speziell zur Steuerung der Oberflächen- und Ausgabesprache.

• Verfügbare integrierte UI-Sprachen: zh-CN (Vereinfachtes Chinesisch), en-US (Englisch), ru-RU (Russisch), de-DE (Deutsch), ja-JP (Japanisch), pt-BR (Portugiesisch – Brasilien), fr-FR (Französisch), ca-ES (Katalanisch)
• Beispiele für Ausgabesprachen: Chinesisch, Englisch, Japanisch usw.

1.4 Tool- und Modellverwaltung

Befehle zur Verwaltung von KI-Tools und -Modellen.

1.5 Integrierte Fähigkeiten

Diese Befehle rufen gebündelte Fähigkeiten auf, die spezialisierte Arbeitsabläufe bereitstellen.

Siehe Code Review für die vollständige /review-Dokumentation.

1.6 Seitenfrage (/btw)

Der Befehl /btw ermöglicht es Ihnen, schnelle Nebenfragen zu stellen, ohne den Hauptgesprächsfluss zu unterbrechen oder zu beeinflussen.

So funktioniert es:

• Die Nebenfrage wird als separater API-Aufruf mit dem aktuellen Gesprächskontext (bis zu den letzten 20 Nachrichten) gesendet
• Die Antwort wird oberhalb des Composer angezeigt — Sie können während des Wartens weiter tippen
• Das Hauptgespräch wird nicht blockiert — es läuft unabhängig weiter
• Die Antwort der Nebenfrage wird nicht Teil des Hauptgesprächsverlaufs
• Antworten werden mit vollständiger Markdown-Unterstützung dargestellt (Codeblöcke, Listen, Tabellen etc.)

Tastaturkürzel (Interaktiver Modus):

Beispiel:

(Während das Hauptgespräch über das Refactoring von Code läuft)

> /btw What's the difference between let and var in JavaScript?

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ + Antwort wird...                           │
  │ Drücken Sie Escape, Ctrl+C oder Ctrl+D zum   │
  │ Abbrechen                                      │
  ╰──────────────────────────────────────────╯
  > (Composer bleibt aktiv — weiter tippen)

(Nachdem die Antwort eingetroffen ist)

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ `let` ist blockbezogen, während `var`    │
  │ funktionsbezogen ist. `let` wurde       │
  │ in ES6 eingeführt und hoisted nicht auf │
  │ dieselbe Weise.                         │
  │                                          │
  │ Drücken Sie Space, Enter oder Escape zum │
  │ Schließen                                │
  ╰──────────────────────────────────────────╯
  > (Composer noch aktiv)

Unterstützte Ausführungsmodi:

1.7 Sitzungszusammenfassung (/recap)

Der Befehl /recap erstellt eine kurze Zusammenfassung „Wo Sie aufgehört haben” der aktuellen Sitzung, damit Sie ein altes Gespräch wieder aufnehmen können, ohne durch Seiten voller Verlauf scrollen zu müssen.

So funktioniert es:

• Verwendet das konfigurierte schnelle Modell (fastModel-Einstellung), falls verfügbar, andernfalls das Hauptsitzungsmodell. Ein kleines, günstiges Modell reicht für eine Zusammenfassung aus.
• Der aktuelle Gesprächsverlauf (bis zu 30 Nachrichten, nur Text — Tool-Aufrufe und Tool-Antworten werden herausgefiltert) wird zusammen mit einem knappen System-Prompt an das Modell gesendet.
• Die Zusammenfassung wird in gedämpfter Farbe mit einem ❯-Präfix dargestellt, sodass sie sich von echten Assistentenantworten abhebt.
• Verweigert mit einem Inline-Fehler, wenn eine Modellrunde läuft oder ein anderer Befehl verarbeitet wird. Wenn kein brauchbarer Gesprächsverlauf vorhanden ist oder die zugrundeliegende Generierung fehlschlägt, zeigt /recap stattdessen eine kurze Info-Nachricht an — der manuelle Befehl antwortet immer mit etwas. Automatischer Trigger bei Rückkehr aus Abwesenheit:

Wenn das Terminal für 5+ Minuten in den Hintergrund gerückt ist und wieder fokussiert wird, wird automatisch eine Zusammenfassung erstellt und angezeigt (nur wenn keine Modellantwort läuft; sonst wird gewartet, bis die aktuelle Runde beendet ist, und dann ausgelöst). Anders als der manuelle Befehl ist der automatische Trigger bei Fehlern völlig still: Wenn die Generierung fehlschlägt oder es nichts zusammenzufassen gibt, wird keine Nachricht zum Verlauf hinzugefügt. Gesteuert durch die Einstellung general.showSessionRecap (Standard: false); der manuelle Befehl /recap funktioniert immer unabhängig von dieser Einstellung.

Beispiel:

> /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 Diff Viewer (/diff)

Der Befehl /diff öffnet einen interaktiven Diff-Viewer, der uncommittete Änderungen und Änderungen pro Runde anzeigt. Verwende ←/→ zum Wechseln zwischen dem aktuellen Git-Diff und einzelnen Konversationsrunden, ↑/↓ zum Durchblättern der Dateien und Enter zum Anzeigen von Inline-Diffs.

Funktionsweise:

Im interaktiven Modus öffnet /diff einen Dialog mit einer Quellenauswahl oben:

• Current — Arbeitsbaum vs HEAD (git diff HEAD). Zeigt alle uncommitteten Änderungen an, einschließlich gestagter, ungestagter und nicht verfolgter Dateien.
• T1, T2, T3, … — Änderungen pro Runde, ein Tab pro Modellrunde, die Dateien geändert hat. Die letzten Runden erscheinen zuerst. Jeder Tab zeigt eine Vorschau des ursprünglichen Prompts als Kontext.

Die Dateiliste zeigt dateispezifische Statistiken (hinzugefügte/entfernte Zeilen) mit Tags für besondere Status (new, deleted, untracked, binary, truncated, oversized). Drücke Enter auf einer Datei, um deren Inline-Diff mit syntax-hervorgehobenen Hunks anzuzeigen.

Änderungen pro Runde erfordern, dass Datei-Checkpointing aktiviert ist (standardmäßig im interaktiven Modus eingeschaltet). Wenn Datei-Checkpointing deaktiviert ist, ist nur die Quelle „Current“ verfügbar.

Tastaturkürzel:

Beispiel:

┌ /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                     │
└─────────────────────────────────────────────────────────────────────┘

Nicht-interaktiver Modus:

In headless (--prompt) oder nicht-interaktiven Kontexten gibt /diff eine Klartext-Zusammenfassung des Arbeitsbaums gegenüber HEAD aus. Die Navigation pro Runde ist nicht verfügbar.

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

1.9 Informationen, Einstellungen und Hilfe

Befehle zum Abrufen von Informationen und zur Vornahme von Systemeinstellungen.

1.10 Häufige Tastenkürzel

1.11 Authentifizierungsbefehle

Verwenden Sie /auth in einer Qwen Code-Sitzung, um die Authentifizierung zu konfigurieren. Verwenden Sie /doctor, um den aktuellen Authentifizierungs- und Umgebungsstatus zu überprüfen.

2. @-Befehle (Dateien einfügen)

@-Befehle werden verwendet, um schnell lokale Datei- oder Verzeichnisinhalte in die Konversation einzufügen.

Hinweis: Leerzeichen in Pfaden müssen mit Backslash maskiert werden (z. B. @My\ Documents/file.txt).

3. Ausrufezeichen-Befehle (!) – Shell-Befehlsausführung

Ausrufezeichen-Befehle ermöglichen die direkte Ausführung von Systembefehlen in Qwen Code.

Umgebungsvariablen: Über ! ausgeführte Befehle setzen die Umgebungsvariable QWEN_CODE=1.

4. Benutzerdefinierte Befehle

Speichern Sie häufig verwendete Prompts als Kurzbefehle, um die Arbeitseffizienz zu verbessern und Konsistenz zu gewährleisten.

Kurzer Überblick

Prioritätsregeln: Projektbefehle > Benutzerbefehle (Projektbefehl wird verwendet, wenn Namen gleich sind)

Befehlsbenennungsregeln

Zuordnungstabelle Dateipfad zu Befehlsname

Benennungsregeln: Pfadseparator (/ oder \) wird in Doppelpunkt (:) umgewandelt.

Markdown-Dateiformatspezifikation (empfohlen)

Benutzerdefinierte Befehle verwenden Markdown-Dateien mit optionalem YAML-Frontmatter:

---
description: Optionale Beschreibung (wird in /help angezeigt)
---
 
Ihr Prompt-Inhalt hier.
Verwenden Sie {{args}} für die Parametereinfügung.

TOML-Dateiformat (veraltet)

Parameterverarbeitungsmechanismus

1. Kontextbewusste Injektion ({{args}})

2. Standard-Parameterverarbeitung

🚀 Dynamische Injektion

3. Shell-Befehlsausführung (!{...})

Beispiel: Generierung von Git-Commit-Nachrichten

---
description: Generiere Commit-Nachricht basierend auf gestagten Änderungen
---
 
Bitte generieren Sie eine Commit-Nachricht basierend auf folgendem Diff:
 
```diff
!{git diff --staged}
```

4. Dateiinhaltsinjektion (@{...})

Beispiel: Code-Review-Befehl

---
description: Code-Review basierend auf Best Practices
---
 
Überprüfen Sie {{args}}, Referenzstandards:
 
@{docs/code-standards.md}

Praktisches Erstellungsbeispiel

Schritte zur Erstellung des Befehls “Reine Funktion umgestalten”

---
description: Code zu reiner Funktion umgestalten
---
 
Bitte analysieren Sie den Code im aktuellen Kontext und gestalten Sie ihn zu einer reinen Funktion um.
Anforderungen:
 
1. Refaktorisierten Code bereitstellen
2. Wesentliche Änderungen und Umsetzung der reinen Funktion erklären
3. Funktion unverändert lassen

Zusammenfassung Best Practices für benutzerdefinierte Befehle

Tabelle mit Empfehlungen zum Befehlsdesign

Tabelle zur Erinnerung an Sicherheitsfunktionen

5. CLI-Unterbefehle

Diese Befehle werden in der Shell als qwen <unterbefehl> ausgeführt, bevor eine interaktive Sitzung gestartet wird.

Sitzungsverwaltung

qwen sessions list

Listet Ihre letzten Qwen Code-Sitzungen mit Metadaten auf.

Flags:

Menschenlesbare Ausgabe (Standard):

Eine Tabelle mit den Spalten: SITZUNGS-ID, GESTARTET (UTC-Zeitstempel), TITEL, BRANCH, PROMPT.

JSON-Ausgabe (--json):

Gibt JSON Lines auf stdout aus. Jede Zeile ist ein JSON-Objekt mit den Feldern:

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

Der Hinweis „has more sessions“ wird via stderr ausgegeben, sodass das Piping an jq sicher bleibt.

Beispiele:

# Letzte 20 Sitzungen anzeigen (Standard)
qwen sessions list
 
# Letzte 50 Sitzungen anzeigen
qwen sessions list --limit 50
 
# Ausgabe als JSON für Skripte
qwen sessions list --json | jq .