For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/desktop/run.md (or send Accept: text/markdown).
Shell starten und konfigurieren
Starte die Tauri-Entwicklungs-Shell und verbinde sie mit deiner Web-App.
Schritt-für-Schritt für Einsteiger
Voraussetzungen: Lesen Sie die beiden folgenden Einsteigerhandbücher und schließen Sie die lokale Desktop-Einrichtung ab, einschließlich Rust und Betriebssystemvoraussetzungen. Der Codeblock startet sowohl die Web-App als auch Tauri im Monorepo; Verwenden Sie in einem reinen Desktop-Checkout den gefilterten Befehl erst, nachdem Sie ein erreichbares Web-Backend separat gestartet haben. Tauri lädt dieses Backend.
Kurze Begriffe: Ein Arbeitsbereich umfasst die einzelnen Benutzer, Daten und Einstellungen eines Teams. Der Server ist das vertrauenswürdige Backend; Halten Sie Anbieterschlüssel aus Browser- und Telefoncodes fern. Eine Migration ist eine versionierte Datenbankänderung, die Tabellen erstellt oder aktualisiert. Ein KI-Modell ist der Motor, der antwortet; Der Modellkatalog ist die Liste der verfügbaren Modell-IDs und Preise des Servers. Ein Anbieter ist ein externer Dienst wie ein KI-, E-Mail- oder Abrechnungsdienst. Eine Berechtigung ist eine Bewilligung, die einem Arbeitsbereich die Nutzung einer Funktion ermöglicht. Ein Webhook ist eine Nachricht, die ein Dienst an den URL eines anderen Dienstes sendet.
1. Öffnen Sie apps/desktop/src-tauri/src/lib.rs; Bitten Sie Ihren Agenten, nur das benannte Fenster-/Tray-/Hotkey-Verhalten zu ändern und die Produkt-Benutzeroberfläche in der Web-App beizubehalten.
2. Führen Sie die Shell aus und testen Sie „Close-to-Tray“, „Beenden“ und „CmdOrCtrl+Shift+Space“. Testen Sie supastack:///settings/appearance?preview=1#main.
3. Es sollte das vorhandene Fenster fokussieren und Pfad/Abfrage/Fragment beibehalten. Wenn die falsche Seite geöffnet wird, vergleichen Sie den konfigurierten Ursprung und die genaue Route.
Beginnen Sie für benutzerdefinierten Code mit dem bereitgestellten prompts/README.md und kopieren Sie die nächstgelegene Eingabeaufforderung: prompts/new-app-screen.md für einen App-Bildschirm oder prompts/new-landing-page.md für eine öffentliche Seite. Geben Sie Ihrem Programmieragenten für Server-, Datenbank- oder Anbieterarbeiten die Aufgabe dieses Handbuchs und bitten Sie ihn, AGENTS.md, .ai/PROJECT_CONTEXT.md und passende .ai/-Spiegel zu lesen; Überprüfen Sie die hier genannten genauen Quelldateien. Listen Sie Dateien auf und prüfen Sie sie vor der Bearbeitung. Bewahren Sie den Arbeitsbereichseigentum und die Nur-Server-Geheimnisse. und zeige dir den Unterschied. Teilen Sie ihm das gewünschte Verhalten, Eingabe- und Ausgabefelder, zulässige Rollen, erwartete Erfolge und Fehler sowie das Testkonto, den Anbieter oder das Gerät mit. Beispielwerte verwenden; Fügen Sie niemals ein echtes Geheimnis ein.
# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop
# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop devShell-Verhalten in Rust beibehalten
src-tauri/src/lib.rs erstellt das Haupt-Webview-Fenster mit 1200 × 800 Pixeln. Schließen blendet es ins Tray aus; Beenden schließt die Anwendung. Native Menüs bieten Home/Zurück/Vorwärts/Neu laden, Zoom/Vollbild und Fensteraktionen. Die Wiederherstellung des Fensterzustands bewahrt Größe und Position.
Plattformspezifisches Verhalten prüfen
Die eingeblendete Offline-Überlagerung bietet Wiederholen, verschwindet bei bestehender Verbindung und lädt die Web-App neu. Prüfe Fokus, Tastenkürzel, Menü-Zoom, Tray und Deep-Link-Aufruf auf jedem Zielbetriebssystem. Reine URL-Unit-Tests belegen diese nativen Interaktionen nicht.
Einrichtung und Konfiguration
Installieren Sie die Arbeitsbereichsabhängigkeiten und die Rust-Toolchain sowie die betriebssystemspezifischen Voraussetzungen von Tauri (WebView2 wird mit Windows geliefert; macOS und Linux benötigen ihre dokumentierten Pakete). corepack pnpm --filter @supastack/desktop dev führt tauri dev aus: Es erstellt den Rust-Kern, zeigt die Platzhalter-Benutzeroberfläche an und lädt die aufgelöste App URL.
SUPASTACK_APP_URL wird zuerst zur Laufzeit und danach als beim Build hinterlegter Wert gelesen. Akzeptiert werden nur HTTP(S)-Adressen ohne Zugangsdaten; andernfalls wird der nächste Kandidat verwendet. SUPASTACK_DESKTOP_HOTKEY überschreibt CmdOrCtrl+Shift+Space. Ein ungültiger Wert fällt auf die Standardkombination zurück, statt den Start zu verhindern.
corepack pnpm --filter @supastack/desktop dev
corepack pnpm --filter @supastack/desktop typecheck
SUPASTACK_APP_URL=https://app.example.com \
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space \
corepack pnpm --filter @supastack/desktop devImplementierungsablauf
Das Hauptfenster bleibt auf der exakt konfigurierten Herkunft, einschließlich Protokoll und Port. HTTP(S)-Adressen ohne Zugangsdaten sowie mailto- und tel-Links dürfen sich im Systembrowser öffnen; nicht erlaubte Protokolle werden abgebrochen.
Registrierte supastack://-Links übertragen Route, Query und Fragment auf die konfigurierte App-Adresse. Start, Plattformereignisse für geöffnete URLs und Rückrufe einer zweiten Instanz verwenden dieselbe Prüfung. Ein Deep Link kann die Shell daher nicht zu einem anderen Host umleiten.
Tray-Symbol und globale Tastenkombination zeigen das einzige Hauptfenster an und fokussieren es. Reagiert die Tastenkombination nicht, verwendet wahrscheinlich eine andere Anwendung dieselbe Kombination. Wähle dann ein anderes SUPASTACK_DESKTOP_HOTKEY.
Überprüfung und Fehlerbehebung
Führe nach Änderungen an src-tauri cargo check und cargo test über die Paket-Skripte aus. Prüfe anschließend die Navigation zur exakten Herkunft, erlaubte externe Links, eine supastack://-Route auf der konfigurierten App-Adresse, Tray und Tastenkürzel sowie die Anmeldung nach einem Neustart.