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 /it/docs/desktop.md (or send Accept: text/markdown).

Panoramica desktop

Una shell webview Tauri attorno alla stessa web app — presenza, non un secondo prodotto.

Chiedi informazioni su questa guida

Procedura dettagliata per principianti

Prerequisiti: leggi le due guide per principianti di seguito e completa la configurazione locale del desktop, inclusi i prerequisiti di Rust e del sistema operativo. Il blocco di codice avvia sia l'app Web che Tauri nel monorepo; in un checkout solo su desktop, utilizza il comando filtrato solo dopo aver avviato separatamente un backend Web raggiungibile. Tauri carica quel backend.

Termini rapidi: uno spazio di lavoro è costituito da utenti, dati e impostazioni separati di un team. Il server è il backend affidabile; mantenere le chiavi del provider fuori dal browser e dal codice del telefono. Una migrazione è una modifica del database con versione che crea o aggiorna tabelle. Un modello AI è il motore che risponde; il catalogo dei modelli è l'elenco del server degli ID e dei prezzi dei modelli disponibili. Un fornitore è un servizio esterno come un servizio di intelligenza artificiale, posta elettronica o fatturazione. Un diritto è una concessione che consente a un'area di lavoro di utilizzare una funzionalità. Un webhook è un messaggio che un servizio invia allo URL di un altro servizio.

1. Segui la configurazione locale del desktop, quindi apri l'app nella finestra Tauri e accedi allo stesso account Web che utilizzi in un browser.

2. Visita una pagina dell'area di lavoro, nascondi/mostra la finestra dal vassoio e prova la scorciatoia di convocazione.

3. La schermata deve corrispondere all'app Web perché Tauri carica il backend configurato. Se è vuoto, verificare che SUPASTACK_APP_URL punti a un'app Web in esecuzione raggiungibile.

Per il codice personalizzato, inizia con prompts/README.md in dotazione e copia il prompt più vicino: prompts/new-app-screen.md per la schermata di un'app o prompts/new-landing-page.md per una pagina pubblica. Per il lavoro su server, database o provider, assegna al tuo agente di codifica il compito di questa guida e chiedigli di leggere AGENTS.md, .ai/PROJECT_CONTEXT.md e i mirror .ai/ corrispondenti; controllare gli esatti file sorgente nominati qui; elencare file e controlli prima della modifica; preservare la proprietà dello spazio di lavoro e i segreti solo del server; e mostrarti la differenza. Indicagli il comportamento desiderato, i campi di input e output, i ruoli consentiti, i successi e gli errori previsti e l'account, il fornitore o il dispositivo di prova. Utilizzare valori campione; non incollare mai un vero segreto.

# 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 dev

Un'interfaccia utente del prodotto, una shell nativa

apps/desktop è una visualizzazione web Tauri sulla tua app web. Condivide l'interfaccia utente del prodotto, l'autenticazione e la chat con il web; il comportamento nativo della finestra/vassoio è presente in src-tauri/src/lib.rs. Richiede un backend web raggiungibile e non include un'interfaccia di prodotto indipendente.

Utilizza le funzionalità native della shell

La shell fornisce un menu nel vassoio, chiusura nel vassoio, focus a istanza singola, tasto di scelta rapida di evocazione globale, menu di navigazione/visualizzazione nativi, collegamenti esterni nel browser di sistema, evocazione di collegamento profondo supastack://, stato della finestra ricordato e un overlay di ripetizione offline.

SUPASTACK_APP_URL sceglie il backend: valore runtime valido, poi valore di compilazione, infine localhost. SUPASTACK_DESKTOP_HOTKEY sostituisce CmdOrCtrl+Shift+Space. Le build di rilascio firmate iniettano SUPASTACK_UPDATER_ENDPOINT e SUPASTACK_UPDATER_PUBKEY; quando il percorso dell’endpoint contiene {{channel}}, il menu dell’app abilita Beta Updates (stable vs beta, sovrascrivibile a runtime con SUPASTACK_UPDATE_CHANNEL).

Scegli il percorso del desktop

Esegui insieme Web e desktop per il lavoro locale, quindi crea e verifica la destinazione nativa con i prerequisiti della piattaforma. La firma del negozio, gli installatori e il comportamento del desktop fisico richiedono un'accettazione separata.

Una shell webview, non una seconda app

apps/desktop è una shell Tauri 2.x. Il core Rust in src-tauri possiede finestra, tray di sistema e scorciatoia globale, mentre una webview carica la web app. Interfaccia, autenticazione, billing e AI arrivano dalla stessa codebase Next.js — la superficie desktop aggiunge presenza, non un prodotto parallelo.

La shell include una pagina placeholder in apps/desktop/ui mostrata mentre la web app si carica, così un avvio a freddo non renderizza mai una finestra vuota.

Puntare la shell a un deployment

La destinazione della finestra si risolve in ordine: la variabile d'ambiente SUPASTACK_APP_URL a runtime, poi il valore di SUPASTACK_APP_URL fissato a compile-time, poi http://localhost:3000. Sono accettati solo URL http e https — valori vuoti o non web ricadono sul candidato successivo.

Per lo sviluppo ciò significa che la shell si attacca a qualunque cosa serva corepack pnpm dev. Per la produzione, imposta la variabile in fase di compilazione per inserirla nell'app Web distribuita.

Tenere i secret lato server

La shell non porta credenziali dei provider. La webview parla con la stessa superficie API autenticata di un browser, quindi chiavi dei provider, secret di sessione e configurazione billing restano sul server.

L'identificatore di bundle com.supastack.desktop e l'insieme di capability predefinito (core:default) mantengono la webview in sandbox; amplia i permessi in src-tauri/capabilities solo quando una funzionalità nativa lo richiede.

Per continuare la configurazione, leggi Esecuzione e configurazione della shell.