AI Workspace

Utilizza Codex, Claude Code o VS Code sul tuo dispositivo locale per eseguire comandi e modificare file di progetto su un dispositivo remoto. FlashDesk gestisce la configurazione della connessione per te.

Contenuto

Panoramica
Utilizzo di base
Cosa puoi fare
Come funziona
Modalità dell'area di lavoro
Custom instructions
Note operative

Panoramica

AI Workspace è uno spazio di lavoro FlashDesk per l'utilizzo di strumenti AI locali su un dispositivo remoto. Lo strumento AI viene eseguito sul dispositivo dell'operatore, mentre i comandi per il dispositivo remoto vengono eseguiti tramite SSH quando necessario.

Importante: AI Workspace deve essere abilitato sul dispositivo remoto. FlashDesk esegue automaticamente lo scambio di chiavi SSH all'avvio di AI Workspace, quindi gli utenti non devono creare o registrare manualmente le chiavi SSH.

Utilizzo di base

Abilita AI Workspace sul dispositivo remoto

Sul dispositivo remoto, abilitare l'autorizzazione alla connessione AI Workspace e SSH nelle impostazioni FlashDesk.

Aprire AI Workspace dal dispositivo operatore

Seleziona il dispositivo di destinazione e apri AI Workspace. FlashDesk crea una cartella dell'area di lavoro locale, genera file di supporto SSH e scambia automaticamente una chiave SSH temporanea con il dispositivo remoto.

Scegli come lavorare

Scegli il comando SSH per attività una tantum dirette o scegli la modifica del progetto quando desideri creare uno Local Mirror e modificare i file localmente.

Apri uno strumento AI

Aprire Codex o Claude Code dalla finestra AI Workspace. FlashDesk scrive il file di istruzioni per l'utensile selezionato nell'area di lavoro.

Esegui comandi o modifica file

Per il funzionamento dei comandi SSH, chiedi allo strumento AI di eseguire comandi remoti tramite l'helper generato. Per la modifica del progetto, modifica i file Local Mirror e poi torna a FlashDesk per rivedere e applicare la differenza.

Cosa puoi fare

Apri Codex, Claude Code, VS Code o la cartella dell'area di lavoro da FlashDesk.
Esegui comandi sul dispositivo remoto tramite SSH.
Crea uno Local Mirror di un progetto remoto selezionato e modificalo localmente.
Esaminare le modifiche Local Mirror prima di applicarle nuovamente al dispositivo remoto.
Lascia Custom instructions per dispositivo remoto che verrà unito automaticamente ai file di istruzioni dello strumento AI.

Come funziona

Articolo	Descrizione
`AI Workspace`	Una directory di lavoro locale creata per una connessione FlashDesk.
`.flashdesk-workspace/ssh_config`	Configurazione SSH e script di supporto generati da FlashDesk per il dispositivo remoto selezionato. Gli strumenti di intelligenza artificiale dovrebbero utilizzare i comandi di supporto invece di modificare direttamente questi file.
`.flashdesk-workspace/identity`	Identità SSH temporanea generata da FlashDesk per l'attuale AI Workspace. FlashDesk lo registra automaticamente sul dispositivo remoto e lo rimuove alla chiusura di AI Workspace.
`AGENTS.md` / `CLAUDE.md`	File di istruzioni generati quando viene aperto lo strumento AI corrispondente. FlashDesk adatta inoltre il proprio contenuto allo Host OS rilevato (Windows vs POSIX) e li rigenera quando Custom instructions vengono aggiornati.
Local Mirror	Una copia locale di un progetto remoto selezionato. L'utente può rivedere le modifiche prima di applicarle nuovamente al dispositivo remoto.

Modalità dell'area di lavoro

Il comando SSH funziona

Utilizzare questa modalità per operazioni dirette e una tantum sul dispositivo remoto, ad esempio controllare i registri, elencare i file, riavviare un servizio o apportare una piccola modifica confermata.

Modifica del progetto con Local Mirror

Utilizza questa modalità quando desideri modificare localmente un progetto remoto. FlashDesk clona il file o la cartella remota selezionata in Local Mirror. Dopo la modifica, rivedere la differenza in FlashDesk e applicare solo le modifiche selezionate al dispositivo remoto.

Custom instructions

Custom instructions ti consente di lasciare note permanenti che lo strumento AI dovrebbe seguire in questo spazio di lavoro: convenzioni di codifica, gestore di pacchetti da utilizzare, rami da evitare di toccare, regole di approvazione, tutto ciò che normalmente ripeteresti all'inizio di ogni sessione.

Apri dal pulsante Custom instructions accanto a Apri cartella nella finestra AI Workspace.
Salvato per dispositivo remoto, quindi ogni progetto può avere le proprie note permanenti.
Uniti in AGENTS.md / CLAUDE.md sotto una sezione Custom instructions (seguire sempre), quindi Codex e Claude Code li raccolgono automaticamente. I file di istruzioni esistenti vengono riscritti ogni volta che si salva.

Note operative

AI Workspace è disattivato per impostazione predefinita e deve essere consentito sul dispositivo remoto.
Il dispositivo remoto deve consentire anche le connessioni SSH.
Chiedere all'utente del dispositivo remoto prima di utilizzare SSH per creare, sovrascrivere, spostare o eliminare file sul dispositivo remoto.
Quando si utilizza Local Mirror, applicare le modifiche al dispositivo remoto solo dopo che l'utente ha confermato la differenza in FlashDesk.
I file di grandi dimensioni possono rallentare la creazione di Local Mirror. FlashDesk potrebbe chiedere se includere o saltare file di grandi dimensioni.