// Documentation Singularity
La recherche
Singularity propose trois recherches distinctes : la recherche de texte dans les fichiers du projet, Aperture pour retrouver des commandes et des éléments du workbench, et la recherche propre aux réglages. Choisissez l’outil selon ce que vous cherchez, car leurs résultats et leurs options ne sont pas les mêmes.
Trois recherches, trois usages
Dans les fichiers cherche une chaîne dans le contenu des projets de l’espace de travail. Aperture (⌘/Ctrl K) sert à naviguer rapidement parmi les commandes, fichiers, tickets et projets. La recherche des réglages filtre uniquement le catalogue des préférences. Une requête identique peut donc produire trois listes différentes.
Chercher dans les fichiers
Ouvrez la recherche avec ⌘⇧F sur macOS ou Ctrl⇧F sur Windows et Linux. Elle parcourt récursivement le contenu des projets de l’espace de travail actif. Les pastilles de projet permettent d’inclure ou d’écarter chaque projet ; les champs de filtre acceptent aussi des motifs de fichiers à inclure et des noms de dossiers à exclure, séparés par des virgules.
Les résultats sont groupés par fichier et affichent la ligne correspondante. Dépliez un groupe si nécessaire, puis sélectionnez une occurrence pour fermer la recherche et ouvrir le fichier dans l’éditeur.

Options de correspondance
Trois boutons modifient la correspondance : respecter la casse distingue par exemple Search de search ; mot entier évite les correspondances à l’intérieur d’un mot plus long ; expression régulière interprète la requête comme une expression régulière étendue. Sans cette dernière option, la requête est traitée comme du texte littéral.
Chercher avec Aperture
Ouvrez Aperture avec ⌘K ou Ctrl K, puis saisissez quelques caractères. Aperture rapproche la requête des commandes et vues, des fichiers, des tickets et des projets disponibles dans sa portée. Les sections locales répondent immédiatement ; la recherche du contenu des fichiers arrive après une courte temporisation. Utilisez les flèches et Entrée, ou cliquez sur une ligne, pour l’ouvrir.
Chercher dans les réglages
Ouvrez les réglages avec ⌘, ou Ctrl ,, puis utilisez la barre située en haut. La recherche est insensible à la casse et vérifie tous les mots saisis dans le nom, la description, le groupe, la rubrique et les mots-clés de chaque réglage.
Chaque résultat est une ligne actionnable. Le bouton Ouvrir mène à la rubrique correspondante ; quand une bascule ou une valeur numérique est proposée dans la ligne, vous pouvez modifier le réglage directement sans quitter les résultats.

Limites de la recherche de fichiers
La recherche est un parcours à la demande, pas un index persistant. Sur un projet volumineux, elle peut donc prendre plus de temps ; chaque projet dispose d’environ dix secondes de parcours et l’ensemble des résultats est limité à 500 occurrences. Une réponse partielle peut être affichée si cette limite ou le délai est atteint.
Les fichiers binaires sont ignorés. Par défaut, Singularity ne parcourt pas node_modules, .git, dist, build, .next, .cache et coverage. Les tickets, commandes et réglages ne font pas partie de ce parcours : utilisez Aperture ou la recherche des réglages pour eux.
Questions fréquentes
La recherche de fichiers utilise-t-elle un index ?
Non. Singularity parcourt les projets sélectionnés au moment de la requête ; les changements enregistrés sur disque sont donc recherchables sans reconstruire d’index.
Pourquoi un fichier n’apparaît-il pas ?
Vérifiez que son projet est sélectionné, que les filtres d’inclusion et d’exclusion ne l’écartent pas et qu’il ne s’agit pas d’un fichier binaire ou d’un dossier ignoré par défaut.