Qwen Code Ausführung und Deployment

Dieses Dokument beschreibt, wie du Qwen Code ausführst und erklärt die Deployment-Architektur, die Qwen Code verwendet.

Qwen Code ausführen

Es gibt mehrere Möglichkeiten, Qwen Code auszuführen. Die Option, die du wählst, hängt davon ab, wie du es verwenden willst.

1. Standardinstallation (Empfohlen für typische Benutzer)

Dies ist die empfohlene Methode für Endbenutzer, um Qwen Code zu installieren. Dabei wird das Qwen Code Package aus der NPM Registry heruntergeladen.

Globale Installation:
```
npm install -g @qwen-code/qwen-code
```
Danach kannst du die CLI von überall ausführen:
```
qwen
```

Mit NPX ausführen:


# Führe die neueste Version von NPM aus, ohne eine globale Installation
npx @qwen-code/qwen-code

2. Ausführen in einer Sandbox (Docker/Podman)

Aus Gründen der Sicherheit und Isolation kann Qwen Code innerhalb eines Containers ausgeführt werden. Dies ist die Standardmethode, wie die CLI Tools ausführt, die Nebenwirkungen haben könnten.

Direkt aus der Registry: Du kannst das veröffentlichte Sandbox-Image direkt ausführen. Dies ist nützlich für Umgebungen, in denen du nur Docker zur Verfügung hast und die CLI ausführen möchtest.
```
# Run the published sandbox image
docker run --rm -it ghcr.io/qwenlm/qwen-code:0.0.10
```
Verwendung des --sandbox Flags: Wenn du Qwen Code lokal installiert hast (gemäß der oben beschriebenen Standardinstallation), kannst du es anweisen, innerhalb des Sandbox-Containers ausgeführt zu werden.
```
qwen --sandbox -y -p "your prompt here"
```

3. Ausführen aus dem Quellcode (Empfohlen für Qwen Code Mitwirkende)

Mitwirkende am Projekt möchten die CLI direkt aus dem Quellcode ausführen.

Entwicklungsmodus: Diese Methode bietet Hot-Reloading und ist nützlich für die aktive Entwicklung.
```
# Vom Stammverzeichnis des Repositories
npm run start
```
Produktionsähnlicher Modus (Verknüpftes Paket): Diese Methode simuliert eine globale Installation, indem sie Ihr lokales Paket verknüpft. Sie ist nützlich, um einen lokalen Build in einem Produktions-Workflow zu testen.
```
# Verknüpfen Sie das lokale CLI-Paket mit Ihren globalen node_modules
npm link packages/cli
 
# Jetzt können Sie Ihre lokale Version mit dem Befehl `qwen` ausführen
qwen
```

4. Ausführen des neuesten Qwen Code Commits von GitHub

Sie können die zuletzt committete Version von Qwen Code direkt aus dem GitHub-Repository ausführen. Dies ist nützlich, um Funktionen zu testen, die sich noch in der Entwicklung befinden.


 
# CLI direkt aus dem main branch auf GitHub ausführen
npx https://github.com/QwenLM/qwen-code

Deployment-Architektur

Die oben beschriebenen Ausführungsmethoden werden durch die folgenden Architekturkomponenten und -prozesse ermöglicht:

NPM-Pakete

Das Qwen Code-Projekt ist ein Monorepo, das Kernpakete im NPM-Registry veröffentlicht:

@qwen-code/qwen-code-core: Das Backend, das die Logik und Tool-Ausführung übernimmt.
@qwen-code/qwen-code: Das benutzerseitige Frontend.

Diese Pakete werden sowohl bei der Standardinstallation als auch beim Ausführen von Qwen Code aus dem Quellcode verwendet.

Build- und Packaging-Prozesse

Es gibt zwei verschiedene Build-Prozesse, abhängig vom Verteilungskanal:

NPM-Veröffentlichung: Für die Veröffentlichung im NPM-Registry wird der TypeScript-Quellcode in @qwen-code/qwen-code-core und @qwen-code/qwen-code mithilfe des TypeScript Compilers (tsc) in Standard-JavaScript transpiliert. Das resultierende dist/-Verzeichnis wird dann im NPM-Paket veröffentlicht. Dies ist ein Standardansatz für TypeScript-Bibliotheken.
GitHub npx-Ausführung: Beim direkten Ausführen der neuesten Qwen Code-Version von GitHub wird ein anderer Prozess durch das prepare-Script in der package.json ausgelöst. Dieses Script nutzt esbuild, um die gesamte Anwendung und ihre Abhängigkeiten in eine einzelne, eigenständige JavaScript-Datei zu bündeln. Dieses Bundle wird dynamisch auf dem Rechner des Benutzers erzeugt und ist nicht im Repository enthalten.

Docker-Sandbox-Image

Die Docker-basierte Ausführungsmethode wird vom Container-Image qwen-code-sandbox unterstützt. Dieses Image wird in einer Container-Registry veröffentlicht und enthält eine global vorinstallierte Version von Qwen Code.

Release-Prozess

Der Release-Prozess ist über GitHub Actions automatisiert. Der Release-Workflow führt folgende Aktionen durch:

Build der NPM-Pakete mit tsc.
Veröffentlichen der NPM-Pakete in der Artifact Registry.
Erstellen von GitHub-Releases mit gebündelten Assets.