Salt la conținutul principal
Memories este sistemul pentru partajarea și păstrarea contextului între conversații. Există două mecanisme pentru acest lucru în Windsurf: Memories, care sunt generate automat de Cascade, și Rules, care sunt definite manual de utilizator la nivel global, de workspace sau de sistem.

​
Memories, Rules, Workflows sau Skills?

Windsurf oferă mai multe moduri de a personaliza Cascade. Folosiți acest tabel pentru a alege varianta potrivită:
FuncționalitateCe faceCum este activatăCând să o folosiți
RulesÎi spune lui Cascade cum să se comporte (de ex. „folosește bun, nu npm”)always_on, glob, model_decision sau manual (vedeți mai jos)Convenții de programare, ghiduri de stil, constrângeri ale proiectului
AGENTS.mdRules cu domeniu de aplicare în funcție de locație, fără configurareAutomat — rădăcină = activ permanent, subdirector = globConvenții specifice directoarelor, fără frontmatter
WorkflowsȘabloane de prompt pentru sarcini repetitive, în mai mulți pașiDoar manual, prin comanda slash /[workflow-name]Implementări, review-uri de PR, checklisturi de lansare
SkillsProceduri în mai mulți pași, grupate împreună cu fișiere suport (scripturi, șabloane)Invocate dinamic de model sau prin @mentionSarcini complexe în care Cascade are nevoie de fișiere de referință — merită să investiți aici
MemoriesContext pe care Cascade îl generează automat în timpul conversațiilorPreluare automată când este relevantLăsați Cascade să rețină informații punctuale; pentru cunoștințe durabile, preferați Rules sau AGENTS.md
Recomandare: Pentru informațiile pe care doriți ca Cascade să le refolosească în mod fiabil, formulați-le ca un Rule sau adăugați-le în AGENTS.md din repo-ul dvs., în loc să vă bazați pe Memories generate automat. Rules sunt versionate, pot fi partajate cu echipa dvs. și vă oferă control explicit asupra activării.

​
Cum să gestionezi Memories

Memories și Rules pot fi accesate și configurate oricând făcând clic pe pictograma Customizations din meniul glisant din dreapta sus din Cascade sau prin „Windsurf - Settings” în colțul din dreapta jos. Pentru a edita o memorie existentă, dă clic pe ea și apoi pe butonul Edit.

​
Memories

În timpul conversației, Cascade poate genera și stoca automat Memories dacă întâlnește context pe care îl consideră util de reținut. De asemenea, îi poți cere oricând lui Cascade să creeze o Memory. Doar spune-i lui Cascade să „creeze o Memory despre …”. Memories generate automat de Cascade sunt asociate cu workspace-ul în care au fost create și sunt stocate local în ~/.codeium/windsurf/memories/. Cascade le recuperează atunci când consideră că sunt relevante. Memories generate într-un workspace nu sunt disponibile în altul și nu sunt incluse în commit în repository-ul tău.
Crearea și utilizarea Memories generate automat NU consumă credite.
Memories generate automat există doar pe dispozitivul tău. Dacă vrei ca Cascade să rețină ceva în mod durabil — și să îl partajeze cu echipa ta — cere-i lui Cascade să îl scrie într-un Rule din .windsurf/rules/ sau în AGENTS.md din repository-ul tău.

​
Rules

Utilizatorii își pot defini explicit propriile Rules pe care Cascade să le urmeze. Rules pot fi definite la nivel global, de workspace sau de sistem și pot fi deduse și din fișierele AGENTS.md.
DomeniuLocațieNote
Global~/.codeium/windsurf/memories/global_rules.mdUn singur fișier, aplicat în toate workspace-urile. Mereu activ. Limitat la 6.000 de caractere.
Workspace.windsurf/rules/*.mdCâte un fișier pentru fiecare Rule, fiecare cu propriul mod de activare. Limitat la 12.000 de caractere per fișier.
AGENTS.mdOrice director din workspace-ul dvs.Procesat de același motor de Rules — la nivel de rădăcină = mereu activ, în subdirector = auto-glob pentru directorul respectiv.
System (Enterprise)Specific sistemului de operare (de ex. /etc/windsurf/rules/)Implementat de IT, doar în citire pentru utilizatorii finali.

​
Descoperirea regulilor

Windsurf descoperă automat reguli din mai multe locații pentru a oferi o organizare flexibilă:
  • Workspace-ul curent și subdirectoarele: Toate directoarele .windsurf/rules din workspace-ul tău curent și din subdirectoarele acestuia
  • Structura depozitului Git: Pentru depozitele Git, Windsurf caută și până la directorul rădăcină al repo-ului pentru a găsi reguli în directoarele părinte
  • Suport pentru multiple workspace-uri: Când sunt deschise mai multe foldere în același workspace, regulile sunt deduplicate și afișate cu cea mai scurtă cale relativă

​
Locații de stocare pentru Rules

Rules pot fi stocate în oricare dintre aceste locații:
  • .windsurf/rules în directorul workspace-ului curent
  • .windsurf/rules în orice subdirector al workspace-ului
  • .windsurf/rules în directoarele părinte până la rădăcina git (pentru repo-urile git)
Când creați o regulă nouă, aceasta va fi salvată în directorul .windsurf/rules al workspace-ului curent, nu neapărat la rădăcina git. Pentru a începe cu Rules, faceți clic pe pictograma Customizations din meniul glisant din dreapta sus din Cascade, apoi navigați la panoul Rules. Aici puteți face clic pe butonul + Global sau + Workspace pentru a crea reguli noi la nivel global, respectiv la nivel de workspace.
Puteți găsi șabloane de reguli exemplu, selectate de echipa Windsurf, la https://windsurf.com/editor/directory pentru a vă ajuta să începeți.
Fișierele de reguli pentru workspace sunt limitate la 12.000 de caractere fiecare. Fișierul de reguli globale este limitat la 6.000 de caractere.

​
Moduri de activare

Fiecare regulă de workspace declară un mod de activare în frontmatter, prin câmpul trigger. Acesta controlează când este transmis conținutul regulii către Cascade și cât din fereastra de context consumă:
ModValoare trigger:Cum ajunge la CascadeCost de context
Always Onalways_onÎntregul conținut al regulii este inclus în promptul de sistem pentru fiecare mesaj.La fiecare mesaj
Model Decisionmodel_decisionDoar description este afișat în promptul de sistem. Cascade citește fișierul complet al regulii când decide că descrierea este relevantă.Descrierea este inclusă mereu; conținutul complet, la cerere
GlobglobRegula se aplică atunci când Cascade citește sau editează un fișier care se potrivește cu modelul globs (de ex. *.js, src/**/*.ts).Doar când sunt accesate fișiere potrivite
ManualmanualRegula nu este inclusă în promptul de sistem. O activați tastând @rule-name în caseta de introducere din Cascade.Doar când este menționată cu @
Fișierul cu reguli globale (global_rules.md) și fișierele AGENTS.md de la nivelul rădăcină nu folosesc frontmatter — sunt mereu active.
Exemplu de regulă de workspace cu frontmatter: 
---
trigger: glob
globs: **/*.test.ts
---

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

​
Cele mai bune practici

Pentru a ajuta Cascade să îți urmeze regulile cât mai eficient, respectă aceste bune practici:
  • Păstrează regulile simple, concise și specifice. Regulile prea lungi sau vagi pot deruta Cascade.
  • Nu este nevoie să adaugi reguli generice (de ex. „scrie cod bun”), deoarece acestea sunt deja incluse în datele de antrenare ale lui Cascade.
  • Formatează regulile folosind puncte, liste numerotate și markdown. Acestea sunt mai ușor de urmat de către Cascade decât un paragraf lung. De exemplu:
# Ghiduri de Codificare 
- Limbajul de programare al proiectului meu este Python
- Folosește returnări timpurii când este posibil
- Adaugă întotdeauna documentație când creezi funcții și clase noi
  • Etichetele XML pot fi o modalitate eficientă de a transmite și de a grupa reguli similare. De exemplu:
<coding_guidelines>
- Limbajul de programare al proiectului meu este Python
- Folosește returnări timpurii când este posibil
- Adaugă întotdeauna documentație când creezi funcții și clase noi
</coding_guidelines>

​
Reguli la nivel de sistem (Enterprise)

Organizațiile Enterprise pot implementa reguli la nivel de sistem care se aplică la nivel global în toate workspace-urile și nu pot fi modificate de către utilizatorii finali fără permisiuni de administrator. Acest lucru este ideal pentru aplicarea unitara a standardelor de codare la nivelul întregii organizații, a politicilor de securitate și a cerințelor de conformitate. Regulile la nivel de sistem sunt încărcate din directoare specifice sistemului de operare: macOS: 
/Library/Application Support/Windsurf/rules/*.md
Linux/WSL: 
/etc/windsurf/rules/*.md
Windows: 
C:\ProgramData\Windsurf\rules\*.md
Plasați fișierele de reguli (ca fișiere .md) în directorul corespunzător pentru sistemul de operare pe care îl utilizați. Sistemul va încărca automat toate fișierele .md din aceste directoare.

​
Cum funcționează regulile la nivel de sistem

Regulile la nivel de sistem sunt combinate cu regulile de workspace și regulile globale, oferind context suplimentar pentru Cascade, fără a suprascrie regulile definite de utilizator. Acest lucru permite organizațiilor să stabilească standarde de bază, permițând în același timp echipelor să adauge personalizări specifice proiectului. În interfața Windsurf, regulile la nivel de sistem sunt afișate cu eticheta „System” și nu pot fi șterse de către utilizatorii finali.
Important: Regulile la nivel de sistem ar trebui gestionate de echipa dumneavoastră IT sau de securitate. Asigurați-vă că echipele interne se ocupă de implementare, actualizări și conformitate în acord cu politicile organizației dumneavoastră. Puteți folosi instrumente și fluxuri de lucru standard, precum Mobile Device Management (MDM) sau Configuration Management, pentru a face acest lucru.