Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Memories désigne le système qui permet de partager et de conserver le contexte d’une conversation à l’autre. Dans Cascade, il existe deux mécanismes à cet effet : la mémoire, qui peut être générée automatiquement par Cascade, et les règles, définies manuellement par l’utilisateur aux niveaux local et global.

​
Comment gérer les mémoires

Les mémoires et les règles sont accessibles et peuvent être configurées à tout moment en cliquant sur l’icône Customizations dans le menu latéral en haut à droite de Cascade. Pour modifier une mémoire existante, cliquez simplement dessus, puis sur le bouton Edit.

​
Mémoires

Au cours d’une conversation, Cascade peut automatiquement générer et stocker des mémoires s’il rencontre un contexte qu’il estime utile de retenir. De plus, vous pouvez demander à Cascade de créer une mémoire à tout moment. Il suffit de lui demander de « créer une mémoire de … ». Les mémoires générées automatiquement par Cascade sont associées à l’espace de travail dans lequel elles ont été créées, et Cascade les récupérera lorsqu’il estimera qu’elles sont pertinentes. Les mémoires générées dans un espace de travail ne seront pas disponibles dans un autre.
La création et l’utilisation de mémoires générées automatiquement ne consomment PAS de crédits

​
Règles

Les utilisateurs peuvent définir explicitement leurs propres règles que Cascade doit suivre. Les règles peuvent être définies soit au niveau global, soit au niveau de l’espace de travail. global_rules.md - règles appliquées à tous les espaces de travail .windsurf/rules - répertoire au niveau de l’espace de travail contenant des règles associées à des motifs glob ou à des descriptions en langage naturel.

​
Découverte des règles

Windsurf détecte automatiquement les règles à plusieurs emplacements pour offrir une organisation flexible :
  • Espace de travail actuel et sous-répertoires : tous les répertoires .windsurf/rules présents dans l’espace de travail actuel et ses sous-répertoires
  • Structure du dépôt Git : pour les dépôts Git, Windsurf remonte également jusqu’au répertoire racine du dépôt pour trouver des règles dans les répertoires parents
  • Prise en charge de plusieurs espaces de travail : lorsque plusieurs dossiers sont ouverts dans le même espace de travail, les règles sont dédupliquées et affichées avec le chemin relatif le plus court

​
Emplacements de stockage des règles

Les règles peuvent être stockées dans l’un des emplacements suivants :
  • .windsurf/rules dans le répertoire de votre espace de travail actuel
  • .windsurf/rules dans n’importe quel sous-répertoire de votre espace de travail
  • .windsurf/rules dans les répertoires parents jusqu’à la racine Git (pour les dépôts Git)
Lorsque vous créez une nouvelle règle, elle est enregistrée dans le répertoire .windsurf/rules de votre espace de travail actuel, pas nécessairement à la racine Git. Pour commencer à utiliser les règles, cliquez sur l’icône Customizations dans le menu coulissant situé en haut à droite dans Cascade, puis accédez au panneau Rules. Vous pouvez ensuite cliquer sur le bouton + Global ou + Workspace pour créer de nouvelles règles, respectivement au niveau global ou au niveau de l’espace de travail.
Vous trouverez des modèles de règles sélectionnés par l’équipe Windsurf à l’adresse https://windsurf.com/editor/directory pour vous aider à démarrer.
Chaque fichier de règles est limité à 12000 caractères.

​
Bonnes pratiques

Pour aider Cascade à suivre efficacement vos règles, appliquez ces bonnes pratiques :
  • Gardez les règles simples, concises et spécifiques. Des règles trop longues ou trop vagues risquent de dérouter Cascade.
  • Il n’est pas nécessaire d’ajouter des règles génériques (p. ex. “écrire du bon code”), car elles sont déjà intégrées aux données d’entraînement de Cascade.
  • Présentez vos règles sous forme de puces, de listes numérotées et de Markdown. Ces formats sont plus faciles à suivre pour Cascade qu’un long paragraphe.
Par exemple : 
# Coding Guidelines 
- My project's programming language is python
- Use early returns when possible
- Always add documentation when creating new functions and classes
  • Les balises XML peuvent être un moyen efficace de communiquer des règles et de regrouper celles qui se ressemblent. Par exemple :
<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>

​
Règles système (Enterprise)

Les organisations Enterprise peuvent déployer des règles système qui s’appliquent globalement à tous les espaces de travail et que les utilisateurs finaux ne peuvent pas modifier sans disposer des autorisations d’administrateur. C’est idéal pour appliquer des normes de codage, des politiques de sécurité et des exigences de conformité à l’échelle de l’organisation. Les règles système sont chargées à partir de répertoires spécifiques au système d’exploitation : macOS : 
/Library/Application Support/Windsurf/rules/*.md
Linux/WSL : 
/etc/windsurf/rules/*.md
Windows : 
C:\ProgramData\Windsurf\rules\*.md
Placez vos fichiers de règles (au format .md) dans le répertoire correspondant à votre système d’exploitation. Le système chargera automatiquement tous les fichiers .md présents dans ces répertoires.

​
Fonctionnement des règles système

Les règles système sont combinées aux règles de l’espace de travail et aux règles globales afin de fournir un contexte supplémentaire à Cascade, sans écraser les règles définies par l’utilisateur. Les organizations peuvent ainsi définir des standards de base tout en laissant les teams ajouter des personnalisations propres à chaque projet. Dans l’interface de Cascade, les règles système apparaissent avec le libellé “System” et ne peuvent pas être supprimées par les utilisateurs finaux.
Important : les règles système doivent être gérées par votre équipe informatique ou sécurité. Assurez-vous que vos équipes internes prennent en charge le déploiement, les mises à jour et la conformité conformément aux politique de votre organization. Vous pouvez pour cela utiliser des outils standard et des workflows comme le Mobile Device Management (MDM) ou la gestion de configuration.