El Motor de indexación es el servicio de conocimiento del código de Windsurf que impulsa:
-
Chat con conocimiento del repositorio
-
Autocomplete con conocimiento del repositorio
En comparación con Autocomplete y Chat regulares con conocimiento del contexto, el Motor de indexación puede recuperar contexto de todo el repositorio, no solo de los archivos con los que has interactuado recientemente. Esto mejora significativamente la calidad de las respuestas de Autocomplete y Chat.
La indexación local está activada de forma predeterminada para todos los usuarios del plugin y siempre activada para los usuarios de Windsurf.
El motor de indexación funciona, en parte, generando embeddings de tu base de código que capturan el significado subyacente. Estos embeddings se pueden consultar tanto con lenguaje natural como con fragmentos de código relacionados.
Windsurf Indexing envía fragmentos de código a un servidor remoto para generar embeddings. Sin embargo, no se almacena ni código ni embeddings de forma remota: todos tus datos se guardan en tu propio dispositivo.
Cómo activar o desactivar el motor de indexación
Para activar o desactivar el motor de indexación en VS Code, ve a la página “Settings (UI)” y busca “Windsurf Search”. Verás una opción para habilitar la búsqueda y establecer el valor de “Max Workspace Size”.Luego reinicia tu IDE para que el cambio se aplique.Puedes comprobar si tu workspace está indexado revisando la pestaña “Context” en el panel de “Chat”. Si hay un punto verde junto a tu workspace, entonces está indexado y es detectable en las búsquedas.
De forma predeterminada, Windsurf Indexing ignorará:
- Rutas especificadas en
gitignore
- Archivos en
node_modules
- Rutas ocultas (que comienzan con ”.”)
Cuando se ignora un archivo, no se indexa y tampoco cuenta para el límite máximo de archivos del tamaño de workspace de Indexing.
Si quieres configurar más archivos que Windsurf Indexing debe ignorar, puedes agregar un archivo .codeiumignore
en la raíz del repositorio, con la misma sintaxis que .gitignore
.
Para clientes Enterprise que gestionan múltiples repositorios, puedes aplicar reglas de exclusión en todos ellos colocando un archivo .codeiumignore
global en la carpeta ~/.codeium/
. Esta configuración global se aplicará a todos los workspaces de Windsurf en tu sistema.
El archivo .codeiumignore
global utiliza la misma sintaxis que .gitignore
y se aplica además de cualquier archivo .codeiumignore
específico de un repositorio.
Cuando se habilita por primera vez, Windsurf consumirá una fracción de CPU mientras indexa el workspace. Según el tamaño de tu workspace, esto debería tardar entre 5 y 10 minutos y solo debe ocurrir una vez por workspace. El uso de CPU volverá a la normalidad automáticamente. La indexación de Windsurf también requiere RAM (~300 MB para un workspace de 5000 archivos).
La configuración “Max Workspace Size (File Count)” determina el workspace más grande para el que la indexación de Windsurf intentará indexar un workspace o módulo en particular. Si tu workspace no parece estar indexado, intenta aumentar este número. Para usuarios con ~10 GB de RAM, recomendamos fijarlo en un máximo de 10,000 archivos.