Salt la conținutul principal
Memories este sistemul de partajare și păstrare a contextului între conversații. În Cascade există două mecanisme pentru acest lucru: Memorii, care pot fi generate automat de Cascade, și reguli, care sunt definite manual de utilizator atât la nivel local, cât și global.

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. Pentru a edita un memory existent, dă clic pe acesta, apoi pe butonul Edit.

Memorii

În timpul conversației, Cascade poate genera și stoca automat memorii dacă întâlnește context pe care îl consideră util de reținut. De asemenea, poți cere oricând ca Cascade să creeze o memorie. Pur și simplu solicită-i lui Cascade să „creeze o memorie despre…”. Memoriile generate automat de Cascade sunt asociate cu workspace-ul în care au fost create, iar Cascade le va regăsi atunci când le consideră relevante. Memoriile generate într-un workspace nu vor fi disponibile în altul.
Crearea și utilizarea memoriilor generate automat NU consumă credite

Reguli

Utilizatorii își pot defini explicit propriile reguli pe care Cascade să le respecte. Regulile pot fi definite la nivel global sau la nivel de workspace. global_rules.md - reguli aplicate în toate workspace-urile .windsurf/rules - director la nivel de workspace care conține reguli asociate cu globs sau descrieri în limbaj natural.

Descoperirea regulilor

Windsurf descoperă automat reguli din multiple locații pentru o organizare flexibilă:
  • workspace-ul curent și subdirectoarele: Toate directoarele .windsurf/rules din workspace-ul curent și subdirectoarele acestuia
  • Structura repository-ului Git: Pentru repository-urile Git, Windsurf caută și în sus până la directorul rădăcină al Git 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 repozitoare git)
Când creezi o regulă nouă, aceasta va fi salvată în directorul .windsurf/rules al workspace-ului tău curent, nu neapărat la rădăcina git. Pentru a începe cu Rules, dă clic pe pictograma Customizations din meniul glisant din dreapta sus din Cascade, apoi navighează la panoul Rules. Aici poți face clic pe butonul + Global sau + Workspace pentru a crea reguli noi la nivel global sau la nivelul workspace-ului, respectiv.
Poți găsi șabloane de reguli, selectate de echipa Windsurf, la https://windsurf.com/editor/directory pentru a te ajuta să începi.
Fișierele Rules sunt limitate la 12.000 de caractere fiecare.

Cele mai bune practici

Pentru a ajuta Cascade să-ți urmeze regulile eficient, respectă aceste bune practici:
  • Păstrează regulile simple, concise și specifice. Regulile prea lungi sau vagi îl pot deruta pe Cascade.
  • Nu este nevoie să adaugi reguli generale (de ex. „scrie cod de calitate”), deoarece acestea sunt deja incluse în datele de antrenare ale Cascade.
  • Formatează regulile folosind liste cu puncte, liste numerotate și markdown. Acestea sunt mai ușor de urmărit de către Cascade decât un paragraf lung.
De exemplu:
# Ghiduri de Codare 
- 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 comunica ș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>
I