Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
FunzionalitàCosa faCome si attivaQuando usarla
RegoleIndicano a Cascade come comportarsi (ad es. “usa bun, non npm”)always_on, glob, model_decision o manual (vedi sotto)Convenzioni di codice, guide di stile, vincoli di progetto
AGENTS.mdRegole basate sulla posizione, senza configurazioneAutomatico — root = sempre attivo, sottodirectory = globConvenzioni specifiche della directory senza frontmatter
WorkflowTemplate di prompt per attività ripetibili in più passaggiSolo manuale tramite il comando slash /[workflow-name]Distribuzioni, revisione delle PR, checklist di rilascio
SkillsProcedure in più passaggi raggruppate con file di supporto (script, template)Invocate dinamicamente dal modello oppure tramite @mentionAttività complesse in cui Cascade ha bisogno di file di riferimento — vale la pena investire qui
MemorieContesto che Cascade genera automaticamente durante le conversazioniRecupero automatico quando pertinenteLascia che Cascade ricordi informazioni occasionali; per conoscenze durature, preferisci Regole o AGENTS.md
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 “Windsurf - 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 .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.
AmbitoPosizioneNote
Globale~/.codeium/windsurf/memories/global_rules.mdUn unico file, applicato a tutti i workspace. Sempre attivo. Massimo 6.000 caratteri.
Workspace.windsurf/rules/*.mdUn file per ogni regola, ciascuno con la propria modalità di attivazione. Massimo 12.000 caratteri per file.
AGENTS.mdQualsiasi directory nel workspaceElaborato dallo stesso motore delle regole: a livello radice = sempre attivo, sottodirectory = auto-glob per quella directory.
Sistema (Enterprise)Specifico del sistema operativo (ad es. /etc/windsurf/rules/)Distribuito dall’IT, in sola lettura per gli utenti finali.

​
Individuazione delle regole

Devin Desktop individua automaticamente le regole in più posizioni per offrire un’organizzazione flessibile:
  • Workspace corrente e sottodirectory: tutte le directory .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:
  • .windsurf/rules nella directory del workspace corrente
  • .windsurf/rules in qualsiasi sottodirectory del workspace
  • .windsurf/rules nelle directory padre fino alla directory radice Git (per i repository Git)
Quando crei una nuova regola, questa verrà salvata nella directory .windsurf/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:
Modalitàvalore trigger:Come viene passato a CascadeCosto di contesto
Sempre attivaalways_onIl contenuto completo della regola è incluso nel prompt di sistema in ogni messaggio.Ogni messaggio
Decisione del modellomodel_decisionSolo la description viene mostrata nel prompt di sistema. Cascade legge il file completo della regola quando decide che la descrizione è pertinente.Descrizione sempre; contenuto completo su richiesta
GlobglobLa regola viene applicata quando Cascade legge o modifica un file che corrisponde al pattern globs (ad es. *.js, src/**/*.ts).Solo quando vengono toccati file corrispondenti
ManualemanualLa regola non è nel prompt di sistema. La attivi digitando @rule-name nella casella di input di Cascade.Solo quando viene richiamata con @
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: 
---
trigger: glob
globs: **/*.test.ts
---

All test files must use `describe`/`it` blocks and mock external API calls.

​
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:
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
  • I tag XML possono essere un modo efficace per esprimere e raggruppare regole simili. Ad esempio:
<coding_guidelines>
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
</coding_guidelines>

​
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: macOS: 
/Library/Application Support/Windsurf/rules/*.md
Linux/WSL: 
/etc/windsurf/rules/*.md
Windows: 
C:\ProgramData\Windsurf\rules\*.md
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.