Skip to main content
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ă:
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.

​
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ă:
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:

​
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:
  • Etichetele XML pot fi o modalitate eficientă de a transmite și de a grupa reguli similare. De exemplu:

​
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:
Linux/WSL:
Windows:
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.