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/run.md (or send Accept: text/markdown).
Esecuzione e configurazione della shell
Avvia la shell Tauri e collegala all’app Web.
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. Aprire apps/desktop/src-tauri/src/lib.rs; chiedi al tuo agente di modificare solo il comportamento della finestra/vassoio/tasto di scelta rapida denominato e di mantenere l'interfaccia utente del prodotto nell'app Web.
2. Eseguire la shell e testare close-to-tray, Quit e CmdOrCtrl+Shift+Space; provare supastack:///settings/appearance?preview=1#main.
3. Dovrebbe focalizzare la finestra esistente e preservare il percorso/query/frammento. Se apre la pagina sbagliata, confronta l'origine configurata e il percorso esatto.
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.
- Prima di iniziare
- Nozioni di base sui terminali
- Configurazione locale del desktop
- Messaggi dell'agente e memoria del progetto
# 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 devMantieni il comportamento della shell in Rust
src-tauri/src/lib.rs crea la finestra di visualizzazione web principale 1200×800. La chiusura lo nasconde al vassoio; Esci esce. I menu nativi forniscono azioni Home/Indietro/Avanti/Ricarica, zoom/schermo intero e finestra. Il ripristino dello stato della finestra preserva la dimensione/posizione.
Verificare il comportamento specifico della piattaforma
L'overlay offline inserito offre Riprova, si nasconde online e ricarica l'app Web. Testare focus, scorciatoie, zoom del menu, vassoio e invocazione di deep-link su ogni sistema operativo di destinazione; i controlli dell'unità URL da soli non dimostrano tali interazioni native.
Installazione e configurazione
Installa le dipendenze dell'area di lavoro e la toolchain Rust oltre ai prerequisiti per sistema operativo di Tauri (WebView2 viene fornito con Windows; macOS e Linux necessitano dei relativi pacchetti documentati). corepack pnpm --filter @supastack/desktop dev esegue tauri dev: crea il core Rust, mostra l'interfaccia utente segnaposto e carica l'app risolta URL.
SUPASTACK_APP_URL viene letto prima a runtime, poi dalla build; sono accettati solo URL HTTP(S) senza credenziali, altrimenti si prova il valore successivo. SUPASTACK_DESKTOP_HOTKEY sostituisce CmdOrCtrl+Shift+Space; un valore non valido ripristina quello predefinito senza bloccare l’avvio.
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 devFlusso di implementazione
La finestra principale naviga solo nell’origin configurato esatto, schema e porta inclusi. Link HTTP(S) senza credenziali, mailto e tel possono aprirsi nel browser di sistema; gli altri schemi vengono annullati.
I link registrati supastack:// mappano percorso, query e fragment sull’origin configurato. Avvio, evento open-url della piattaforma e callback della seconda istanza applicano la stessa convalida: un deep link non può cambiare host.
Tray e scorciatoia globale mostrano e mettono a fuoco la finestra unica. Se la scorciatoia non viene registrata, prova un altro valore SUPASTACK_DESKTOP_HOTKEY.
Verifica e risoluzione dei problemi
Dopo modifiche a src-tauri, esegui cargo check e cargo test tramite gli script del package. Verifica origin esatto, apertura dei link esterni consentiti, deep link supastack:// sul dominio configurato, tray, scorciatoia e persistenza dell’accesso dopo il riavvio.