Befehle, Dateien und Konfiguration

Ein Befehl geht in das Terminal

Ein Terminal ist das Fenster, in dem Sie Anweisungen für Ihren Computer eingeben. Öffnen Sie in Visual Studio Code zunächst Ihren Supastack-Ordner über Datei → Ordner öffnen und wählen Sie dann Terminal → Neues Terminal. Das neue Terminal startet in diesem Ordner. Unter Windows wählen Sie PowerShell über das Menü neben der +-Taste des Terminals. Verwenden Sie macOS/Linux-Blöcke in einem macOS- oder Linux-Terminal.

Fügen Sie jeweils nur den Inhalt eines Befehlsblocks ein und drücken Sie die Eingabetaste. Fügen Sie nicht die umgebenden Markdown-Backticks, eine Eingabeaufforderung wie PS C:\... oder eine Beispielausgabe ein. Zeilen, die mit # beginnen, sind Erläuterungen; Sie führen nichts aus. Warten Sie, bis jeder Installationsbefehl abgeschlossen ist, bevor Sie den nächsten Befehl eingeben. Ein Serverbefehl wird weiter ausgeführt und gibt erst dann eine neue Eingabeaufforderung zurück, wenn Sie ihn stoppen.

Überprüfen Sie, welchen Ordner das Terminal verwendet

Repository-Root bezeichnet den Supastack-Ordner der obersten Ebene, der package.json, pnpm-workspace.yaml, Apps und Pakete enthält. Sofern in einem Schritt nichts anderes angegeben ist, führen Sie die Befehle dort aus. Der folgende Befehl druckt den aktuellen Ordner; In der Dateiliste sollte „package.json“ angezeigt werden. Unter Windows funktionieren PowerShell pwd und ls auch.

Wenn die Auflistung nur den Inhalt von apps/desktop zeigt, geben Sie cd ../.. ein und drücken Sie die Eingabetaste, um zum Stammverzeichnis zurückzukehren. Wenn Ihr Basisordner angezeigt wird, geben Sie cd gefolgt von einem Leerzeichen und dem vollständigen Pfad zu Ihrem Klon ein — in Anführungszeichen, wenn er Leerzeichen enthält. Es ist meist einfacher, den Projektordner im Editor zu öffnen und ein neues Terminal zu erstellen.

pwd
ls

Die Konfiguration erfolgt in einer Datei, nicht im Terminal

Ein Block wie AI_PROVIDER=fake ist Konfigurationstext. Öffnen Sie die benannte .env-Datei im Editor, suchen Sie die Zeile, die mit AI_PROVIDER= beginnt, ersetzen Sie ihren Wert und speichern Sie mit Strg + S (Befehl + S unter macOS). Jede Einstellung belegt eine Zeile im KEY=value-Format. Fügen Sie keine Markdown-Backticks hinzu. Vermeiden Sie doppelte Kopien desselben Schlüssels in einer Datei.

Verwenden Sie die Stamm-.env für Datenbank-Migrationsbefehle und apps/web/.env.local für das Web-Backend — bei einem reinen Desktop-Checkout gehört diese Datei zum separaten Backend-Repository. Die Desktop-Shell liest keine .env-Dateien: SUPASTACK_APP_URL ist eine Terminal-Umgebungseinstellung, die Sie beim Start in der Befehlszeile übergeben, keine in einer Datei gespeicherte Konfiguration. Belassen Sie die Beispieldatei als Referenz unverändert.

Dateien, deren Namen mit einem Punkt beginnen, sind möglicherweise in Ihrem Dateimanager ausgeblendet. Der Explorer des Herausgebers zeigt sie an. Stellen Sie sicher, dass der Dateiname genau .env.local und nicht .env.local.txt lautet. Diese lokalen Dateien können Passwörter enthalten und sind von Git ausgeschlossen; Laden Sie sie nicht hoch und fügen Sie ihren Inhalt nicht in Support-Nachrichten ein.

• Finden Sie die Bedeutung jeder Einstellung

Den Dev-Befehl laufen lassen; ein anderes Terminal für Befehle verwenden

Der Desktop-Entwicklungsbefehl kompiliert die Rust-Shell und öffnet das Fenster, während er läuft. Lassen Sie sein Terminal geöffnet, während Sie das Fenster testen. Ein Serverbefehl läuft weiter und gibt keine neue Eingabeaufforderung zurück, bis Sie ihn stoppen.

Um einen anderen Befehl auszuführen, während der Server aktiv ist, wählen Sie im Editor Terminal → Neues Terminal. Das neue Terminal ist ein separates Fenster im selben Projekt. Um den Server zu stoppen, wählen Sie sein Terminal aus und drücken Sie einmal Strg + C. Wenn Sie unter Windows gefragt werden, ob Sie den Batch-Job beenden möchten, geben Sie „Y“ ein und drücken Sie die Eingabetaste. Warten Sie auf die normale Eingabeaufforderung, bevor Sie den Vorgang erneut starten.

Stoppen Sie den Desktop-Befehl nach dem Ändern von Shell-Einstellungen mit Strg + C und führen Sie ihn erneut aus. Der Rust-Kern wird bei jedem Start neu kompiliert; das Ändern von SUPASTACK_APP_URL bedeutet, den neuen Wert beim nächsten Lauf zu übergeben, nicht eine gespeicherte Datei zu bearbeiten.

corepack pnpm --filter @supastack/desktop dev

Lesen Sie einen Fehler und bitten Sie um nützliche Hilfe

Wenn eine Installation einen roten Fehlertext zurückgibt, stoppen Sie bei diesem Schritt. Lesen Sie den ersten Fehler, anstatt die App weiter zu starten. Befehl nicht gefunden bedeutet normalerweise, dass ein Werkzeug fehlt; Kein package.json bedeutet normalerweise, dass es sich um den falschen Ordner handelt. ECONNREFUSED bedeutet normalerweise, dass ein erforderlicher Server oder eine erforderliche Datenbank nicht ausgeführt wird. EADDRINUSE bedeutet, dass ein anderer Prozess den Port bereits verwendet.

Wenn Sie um Hilfe bitten, geben Sie Ihr Betriebssystem, die Anleitung URL und die Schrittnummer, den genauen Befehl, den Sie eingegeben haben, und die erste Fehlermeldung an. Entfernen Sie Passwörter, API Schlüssel, Token und den Passwortteil jeder Datenbank URL. Senden Sie Ihre .env-Dateien nicht. Ein Screenshot des Fehlers kann hilfreich sein, kopierbarer Text ist jedoch einfacher zu diagnostizieren.

• Beheben Sie einen bestimmten Setup-Fehler