Le moteur d’indexation est le service de compréhension de la base de code de Windsurf qui alimente : Par rapport aux fonctionnalités classiques de Chat et d’Autocomplete sensibles au contexte, le moteur d’indexation peut retrouver du contexte dans l’ensemble de la base de code, et pas seulement dans les fichiers avec lesquels vous avez interagi récemment. Cela améliore considérablement la qualité des réponses d’autocomplétion et de chat.
L’indexation locale est activée par défaut pour tous les utilisateurs du plugin, et toujours activée pour les utilisateurs de Windsurf.

​
Fonctionnement

Le moteur d’indexation fonctionne en partie en générant des embeddings pour votre base de code afin d’en capturer le sens sous-jacent. Ces embeddings peuvent être interrogés en langage naturel ou à l’aide d’extraits de code liés. Windsurf Indexing envoie des extraits de code à un serveur distant pour générer des embeddings. Cependant, ni le code ni les embeddings ne sont stockés à distance — toutes vos données restent sur votre appareil.

​
Comment activer ou désactiver le moteur d’indexation

Pour activer ou désactiver le moteur d’indexation dans VS Code, ouvrez la page « Settings (UI) » et recherchez « Windsurf Search ». Vous devriez voir une option pour activer la recherche et définir la taille maximale du workspace.Redémarrez ensuite votre IDE pour que la modification soit prise en compte.
Vous pouvez vérifier si votre workspace est indexé en consultant le volet « Context » dans le panneau « Chat ». S’il y a un point vert à côté de votre workspace, il est indexé et interrogeable.

​
WindsurfIgnore

Par défaut, l’indexation Windsurf ignore :
  • les chemins spécifiés dans .gitignore
  • les fichiers dans node_modules
  • les chemins masqués (commençant par « . »)
Lorsqu’un fichier est ignoré, il n’est pas indexé et n’est pas comptabilisé non plus dans le nombre de fichiers pris en compte par la limite Indexing Max Workspace Size. Si vous souhaitez affiner la configuration des fichiers ignorés par l’indexation Windsurf, vous pouvez ajouter un fichier .codeiumignore à la racine de votre dépôt, avec la même syntaxe que .gitignore.

​
Fichier .codeiumignore global

Pour les clients Enterprise qui gèrent plusieurs dépôts, vous pouvez appliquer des règles d’exclusion à tous les dépôts en plaçant un fichier .codeiumignore global dans le dossier ~/.codeium/. Cette configuration globale s’appliquera à tous les workspaces Windsurf sur votre système. Le fichier .codeiumignore global utilise la même syntaxe que .gitignore et s’ajoute à tout fichier .codeiumignore propre à un dépôt.

​
Exigences système

Lors de la première activation, Windsurf utilisera une fraction du processeur pendant l’indexation du workspace. Selon la taille de votre workspace, cela devrait prendre 5 à 10 minutes et ne doit se produire qu’une seule fois par workspace. L’utilisation du processeur reviendra automatiquement à la normale. L’indexation Windsurf nécessite également de la RAM (~300 Mo pour un workspace de 5 000 fichiers). Le paramètre « Max Workspace Size (File Count) » détermine la taille maximale du workspace pour laquelle l’indexation Windsurf tentera d’indexer un workspace ou module particulier. Si votre workspace ne semble pas être indexé, essayez d’augmenter cette valeur. Pour les utilisateurs disposant d’environ 10 Go de RAM, nous recommandons de ne pas dépasser 10 000 fichiers.