Memories ist das System zum Teilen und dauerhaften Speichern von Kontext über Gespräche hinweg. In Windsurf gibt es dafür zwei Mechanismen: Memories, die automatisch von Cascade erzeugt werden können, und Regeln, die vom Benutzer sowohl lokal als auch global manuell definiert werden.

So verwalten Sie Memories

Auf Memories und Rules können Sie jederzeit zugreifen und sie konfigurieren, indem Sie im Schiebemenü oben rechts in Cascade auf das Symbol Customizations klicken oder über „Windsurf – Settings“ in der rechten unteren Ecke. Um eine bestehende Memory zu bearbeiten, klicken Sie einfach darauf und anschließend auf die Schaltfläche Edit.

Erinnerungen

Während einer Unterhaltung kann Cascade automatisch Erinnerungen erzeugen und speichern, wenn es auf Kontext stößt, den es für sinnvoll hält, sich zu merken. Außerdem kannst du Cascade jederzeit bitten, eine Erinnerung zu erstellen. Bitte Cascade einfach: „Erstelle eine Erinnerung an …“. Die automatisch generierten Erinnerungen von Cascade sind dem Workspace zugeordnet, in dem sie erstellt wurden, und Cascade ruft sie ab, wenn es sie für relevant hält. In einem Workspace erzeugte Erinnerungen sind in einem anderen nicht verfügbar.
Das Erstellen und Verwenden automatisch generierter Erinnerungen verbraucht KEINE Credits

Regeln

Nutzer können eigene Regeln definieren, denen Cascade folgen soll. Regeln können entweder global oder auf Workspace-Ebene festgelegt werden. global_rules.md – Regeln, die in allen Workspaces gelten .windsurf/rules – Verzeichnis auf Workspace-Ebene mit Regeln, die an Globs oder natürliche Sprachbeschreibungen gebunden sind.

Regelermittlung

Windsurf erkennt Regeln automatisch aus mehreren Quellen, um eine flexible Organisation zu ermöglichen:
  • Aktueller Workspace und Unterverzeichnisse: Alle .windsurf/rules-Verzeichnisse innerhalb Ihres aktuellen Workspaces und seiner Unterverzeichnisse
  • Git-Repository-Struktur: Für Git-Repositories durchsucht Windsurf zusätzlich bis zum Git-Root-Verzeichnis, um Regeln in übergeordneten Verzeichnissen zu finden
  • Unterstützung mehrerer Workspaces: Wenn mehrere Ordner im selben Workspace geöffnet sind, werden Regeln dedupliziert und mit dem kürzesten relativen Pfad angezeigt

Speicherorte für Regeln

Regeln können an folgenden Orten gespeichert werden:
  • .windsurf/rules in Ihrem aktuellen Workspace-Verzeichnis
  • .windsurf/rules in jedem Unterverzeichnis Ihres Workspaces
  • .windsurf/rules in übergeordneten Verzeichnissen bis zum Git-Root (für Git-Repositories)
Wenn Sie eine neue Regel erstellen, wird sie im Verzeichnis .windsurf/rules Ihres aktuellen Workspaces gespeichert, nicht unbedingt im Git-Root. Um mit Regeln zu starten, klicken Sie im Schiebemenü oben rechts in Cascade auf das Symbol Customizations und navigieren Sie anschließend zum Panel Rules. Dort können Sie auf die Schaltfläche + Global oder + Workspace klicken, um neue Regeln entweder auf globaler Ebene oder auf Workspace-Ebene zu erstellen.
Beispielvorlagen für Regeln, kuratiert vom Windsurf-Team, finden Sie unter https://windsurf.com/editor/directory, um den Einstieg zu erleichtern.
Regeldateien sind jeweils auf 12.000 Zeichen begrenzt.

Aktivierungsmodi

Auf Regel­ebene kannst du festlegen, wie eine Regel für Cascade aktiviert wird. Es gibt 4 Modi:
  1. Manuell: Diese Regel kann manuell per @mention im Eingabefeld von Cascade aktiviert werden.
  2. Immer aktiv: Diese Regel wird immer angewendet.
  3. Modellentscheidung: Anhand einer natürlichsprachigen Beschreibung der vom Benutzer definierten Regel entscheidet das AI-Modell, ob die Regel angewendet wird.
  4. Glob: Anhand des vom Benutzer definierten Glob-Musters (z. B. .js, src/**/.ts) wird diese Regel auf alle Dateien angewendet, die dem Muster entsprechen.

Best Practices

Damit Cascade Ihren Regeln effektiv folgen kann, beachten Sie diese Best Practices:
  • Halten Sie Regeln einfach, prägnant und konkret. Zu lange oder vage Regeln können Cascade verwirren.
  • Fügen Sie keine generischen Regeln hinzu (z. B. „schreibe guten Code“), da diese bereits in Cascades Trainingsdaten enthalten sind.
  • Formatieren Sie Ihre Regeln mit Aufzählungspunkten, nummerierten Listen und Markdown. Das ist für Cascade einfacher zu befolgen als ein langer Fließtext. Zum Beispiel:
# Coding-Richtlinien 
- Die Programmiersprache meines Projekts ist Python
- Verwende Early Returns, wenn möglich
- Füge immer Dokumentation hinzu, wenn du neue Funktionen und Klassen erstellst
  • XML-Tags können eine effektive Möglichkeit sein, um Informationen zu vermitteln und ähnliche Regeln zu gruppieren. Zum Beispiel:
<coding_guidelines>
- Die Programmiersprache meines Projekts ist Python
- Verwende frühe Rückgaben, wenn möglich
- Füge immer Dokumentation hinzu, wenn du neue Funktionen und Klassen erstellst
</coding_guidelines>