Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/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 Cascade, questo avviene tramite due meccanismi: le memorie, che possono essere generate automaticamente da Cascade, e le regole, definite manualmente dall’utente sia a livello locale sia globale.

​
Come gestire le memorie

È possibile accedere alle Memorie e alle Regole e configurarle in qualsiasi momento facendo clic sull’icona Customizations nel menu scorrevole in alto a destra di Cascade. Per modificare una memoria esistente, è sufficiente farvi clic sopra e poi fare clic sul pulsante Edit.

​
Memorie

Durante la conversazione, Cascade può generare e archiviare automaticamente memorie se incontra informazioni di contesto 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 Cascade le recupererà quando riterrà che siano pertinenti. Le memorie generate in un workspace non saranno disponibili in un altro.
La creazione e l’uso di memorie generate automaticamente NON consumano crediti

​
Regole

Gli utenti possono definire esplicitamente le proprie regole da far seguire a Cascade. Le regole possono essere definite sia a livello globale sia a livello di workspace. global_rules.md - regole applicate a tutti i workspace .windsurf/rules - directory a livello di workspace che contiene regole associate a glob o a descrizioni in linguaggio naturale.

​
Individuazione delle regole

Windsurf individua automaticamente le regole in più posizioni per offrire un’organizzazione flessibile:
  • Workspace corrente e relative sottodirectory: tutte le directory .windsurf/rules all’interno del workspace corrente e delle relative sottodirectory
  • Struttura del repository Git: per i repository Git, Windsurf risale fino alla directory radice del repository per cercare regole nelle directory padre
  • Supporto per più workspace: quando nella stessa workspace sono aperte più cartelle, le regole vengono deduplicate e visualizzate con il percorso relativo più breve

​
Posizioni di archiviazione delle regole

Le regole possono essere archiviate in una qualsiasi di queste posizioni:
  • .windsurf/rules nella directory del workspace corrente
  • .windsurf/rules in qualsiasi sottodirectory del workspace
  • .windsurf/rules nelle directory padre fino alla radice git (per i repository git)
Quando crei una nuova regola, questa verrà salvata nella directory .windsurf/rules del workspace corrente, non necessariamente nella radice git. Per iniziare a usare le regole, fai clic sull’icona Customizations nel menu a scorrimento in alto a destra in Cascade, quindi vai al 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 selezionati dal team di Windsurf su https://windsurf.com/editor/directory per aiutarti a iniziare.
I file delle regole non possono superare i 12000 caratteri ciascuno.

​
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 possono confondere Cascade.
  • Non è necessario aggiungere regole generiche (ad es. “scrivi buon codice”), perché sono già integrate nei dati di addestramento di Cascade.
  • Struttura le tue regole con elenchi puntati, elenchi numerati e Markdown. Per Cascade è più facile seguirli 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 comunicare e raggruppare insieme 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 configurare regole di sistema che si applicano globalmente a tutti i workspace e che gli utenti non possono modificare senza autorizzazioni di amministratore. Sono ideali 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
Posiziona i file delle regole (in formato .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 combinate con le regole del workspace e quelle globali, fornendo a Cascade contesto aggiuntivo senza sovrascrivere le regole definite dagli utenti. In questo modo, le organizzazioni possono stabilire standard di base, consentendo comunque ai team di aggiungere personalizzazioni specifiche per il progetto. Nella UI di Cascade, le regole di sistema sono contrassegnate dall’etichetta “System” e non possono essere eliminate dagli utenti finali.
Importante: le regole di sistema devono essere gestite dal tuo team IT o di sicurezza. Assicurati che i team interni si occupino della distribuzione, degli aggiornamenti e della conformità in base alle policy della tua organizzazione. A tale scopo, puoi usare strumenti e flussi di lavoro standard come Mobile Device Management (MDM) o Configuration Management.