Vai al contenuto principale
Memories è il sistema per condividere e preservare il contesto tra le conversazioni. In Devin Desktop, questo avviene tramite due meccanismi: Memorie, generate automaticamente da Cascade, e Regole, definite manualmente dall’utente a livello globale, di workspace o di sistema.

​
Memorie, Regole, Workflow o Skills?

Devin Desktop offre diversi modi per personalizzare Cascade. Usa questa tabella per scegliere quello più adatto:
Raccomandazione: Per conoscenze che vuoi che Cascade riutilizzi in modo affidabile, scrivile come una Regola o aggiungile a AGENTS.md nel tuo repo, invece di affidarti alle Memorie generate automaticamente. Le Regole sono sottoposte a controllo di versione, condivisibili con il tuo team e ti offrono un controllo esplicito sull’attivazione.

​
Come gestire le memorie

È possibile accedere alle Memorie e alle Regole e configurarle in qualsiasi momento facendo clic sull’icona Customizations nel menu laterale in alto a destra di Cascade, oppure tramite “Devin - Settings” nell’angolo in basso a destra. Per modificare una memoria esistente, è sufficiente farvi clic e poi fare clic sul pulsante Edit.

​
Memorie

Nel corso della conversazione, Cascade può generare e archiviare automaticamente memorie se incontra informazioni contestuali che ritiene utili da ricordare. Inoltre, puoi chiedere a Cascade di creare una memoria in qualsiasi momento. Ti basta chiedere a Cascade di “creare una memoria di …”. Le memorie generate automaticamente da Cascade sono associate al workspace in cui sono state create e vengono archiviate localmente in ~/.codeium/windsurf/memories/. Cascade le richiama quando ritiene che siano pertinenti. Le memorie generate in un workspace non sono disponibili in un altro e non vengono salvate con un commit nel tuo repository.
La creazione e l’uso delle memorie generate automaticamente NON consumano crediti.
Le memorie generate automaticamente risiedono solo sul tuo computer. Se vuoi che Cascade ricordi qualcosa in modo duraturo — e lo condivida con il tuo team — chiedi invece a Cascade di scriverlo in una Regola in .devin/rules/ (o nel legacy .windsurf/rules/) oppure nel file AGENTS.md della tua repo.

​
Regole

Gli utenti possono definire esplicitamente le proprie regole da far seguire a Cascade. Le regole possono essere definite a livello globale, di workspace o di sistema e possono anche essere ricavate dai file AGENTS.md.

​
Individuazione delle regole

Devin Desktop individua automaticamente le regole in più posizioni per offrire un’organizzazione flessibile. La directory .devin/ è la posizione preferita e ha la precedenza, mentre .windsurf/ viene mantenuta come fallback per la retrocompatibilità:
  • Workspace corrente e sottodirectory: tutte le directory .devin/rules (e legacy .windsurf/rules) all’interno del workspace corrente e delle relative sottodirectory
  • Struttura del repository Git: per i repository Git, Devin Desktop risale anche fino alla directory radice del repository per trovare le regole nelle directory padre
  • Supporto per più workspace: quando sono aperte più cartelle nello stesso workspace, le regole vengono deduplicate e visualizzate con il percorso relativo più breve

​
Posizioni di archiviazione delle regole

Le regole possono essere archiviate in una di queste posizioni (.devin/ è preferito e ha la precedenza su .windsurf/):
  • .devin/rules o .windsurf/rules nella directory del workspace corrente
  • .devin/rules o .windsurf/rules in qualsiasi sottodirectory del workspace
  • .devin/rules o .windsurf/rules nelle directory padre fino alla directory radice Git (per i repository Git)
Quando crei una nuova regola, questa verrà salvata nella directory .devin/rules del workspace corrente, non necessariamente nella directory radice Git. Per iniziare a usare Rules, fai clic sull’icona Customizations nel menu a scorrimento in alto a destra in Cascade, quindi apri il pannello Rules. Qui puoi fare clic sul pulsante + Global o + Workspace per creare nuove regole rispettivamente a livello globale o di workspace.
Puoi trovare modelli di regole di esempio curati dal team di Devin Desktop all’indirizzo https://windsurf.com/editor/directory per iniziare più rapidamente.
I file delle regole del workspace sono limitati a 12.000 caratteri ciascuno. Il file delle regole globali è limitato a 6.000 caratteri.

​
Modalità di attivazione

Ogni regola del workspace dichiara una modalità di attivazione nel frontmatter tramite il campo trigger. Questo controlla quando il contenuto della regola viene fornito a Cascade e quanta parte della finestra di contesto occupa:
Il file delle regole globali (global_rules.md) e i file AGENTS.md nella directory root non usano frontmatter — sono sempre attivi.
Esempio di regola del workspace con frontmatter:

​
Buone pratiche

Per aiutare Cascade a seguire efficacemente le tue regole, segui queste buone pratiche:
  • Mantieni le regole semplici, concise e specifiche. Regole troppo lunghe o vaghe potrebbero confondere Cascade.
  • Non è necessario aggiungere regole generiche (ad es. “scrivi buon codice”), perché sono già incorporate nei dati di addestramento di Cascade.
  • Struttura le tue regole con elenchi puntati, elenchi numerati e markdown. Per Cascade sono più facili da seguire rispetto a un lungo paragrafo. Ad esempio:
  • I tag XML possono essere un modo efficace per esprimere e raggruppare regole simili. Ad esempio:

​
Regole di sistema (Enterprise)

Le organizzazioni Enterprise possono implementare regole di sistema che si applicano globalmente a tutti i workspace e non possono essere modificate dagli utenti finali senza autorizzazioni amministrative. Questa soluzione è ideale per imporre standard di codifica validi per tutta l’organizzazione, policy di sicurezza e requisiti di conformità. Le regole di sistema vengono caricate da directory specifiche del sistema operativo. La directory Devin è quella preferita e ha la precedenza, mentre la directory legacy Windsurf viene mantenuta come fallback: macOS:
Linux/WSL:
Windows:
Inserisci i file delle regole (come file .md) nella directory appropriata per il tuo sistema operativo. Il sistema caricherà automaticamente tutti i file .md presenti in queste directory.

​
Come funzionano le regole di sistema

Le regole di sistema vengono integrate con le regole del workspace e quelle globali, fornendo a Cascade ulteriore contesto senza sovrascrivere le regole definite dagli utenti. Questo consente alle organizzazioni di stabilire standard di base, pur permettendo ai team di aggiungere personalizzazioni specifiche per il progetto. Nell’interfaccia utente di Devin Desktop, le regole di sistema vengono visualizzate con l’etichetta “System” e non possono essere eliminate dagli utenti finali.
Importante: le regole di sistema devono essere gestite dal team IT o dal team di sicurezza della tua organizzazione. Assicurati che i tuoi team interni gestiscano la distribuzione, gli aggiornamenti e la conformità in base alle policy della tua organizzazione. A questo scopo, puoi utilizzare strumenti e flussi di lavoro standard come Mobile Device Management (MDM) o Configuration Management.