> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser le lanceur de recherche plein texte

> Une fenêtre de recherche globale toujours à portée de main : recherche hybride, restriction à une bibliothèque, filtre par type, tri temporel, aperçu sur place. Cette page détaille chacune de ses capacités et chacun de ses raccourcis.

Le lanceur est la porte d'entrée la plus utilisée de Linkly AI : une fenêtre globale, dans l'esprit de Spotlight sur macOS ou de Raycast, que l'on appelle à tout moment d'une frappe pour retrouver un document de son ordinateur à partir d'un mot-clé ou d'une phrase en langage naturel.

Sa recherche est **hybride** : les mots-clés (BM25) et la sémantique (vecteurs) tournent de concert, puis les résultats sont fusionnés et reclassés. Vous pouvez donc aussi bien chercher un terme exact que décrire « à peu près ce que je cherche » — y compris décrire en français pour atteindre un document rédigé en anglais.

> [card] Recherche par mots-clés
>
> Saisissez des mots-clés précis : ils sont confrontés au nom de fichier et au texte

> [card] Recherche sémantique
>
> Décrivez en langage naturel : le modèle interprète le sens et retourne les documents pertinents

> [!NOTE]
>
> La moitié sémantique n'entre en jeu qu'une fois le modèle d'embedding téléchargé. Pendant le téléchargement, la recherche **retombe silencieusement en mode mots-clés seuls** — utilisable, mais incapable de faire remonter ce qui est « proche par le sens sans partager les mots ». L'état se consulte dans la page **Gestion de l'index** de la fenêtre principale ; voir [Paramètres d'indexation](https://linkly.ai/docs/fr/indexing.md).

***

## Ouvrir et fermer

| Action | Comment faire |
| - | - |
| **Ouvrir** | Raccourci global `⌘ + L` (macOS) / `Ctrl + L` (Windows/Linux) |
| **Ou bien** | **Clic droit** sur l'icône L de la barre d'état système, puis **Rechercher** dans le menu (entre **Ouvrir Linkly AI** et **Demander à l'IA**) |
| **Fermer** | `Esc`, ou un clic n'importe où en dehors de la fenêtre |

> [!WARNING]
>
> **Un clic gauche sur l'icône de la barre d'état ouvre la fenêtre principale, pas le lanceur.** Le menu de la barre d'état ne se déploie qu'au **clic droit** — c'est là que se trouvent **Rechercher**, **Suspendre l'indexation** et les autres entrées.

> [!TIP]
>
> Le raccourci est modifiable dans **Paramètres → Raccourcis**. Les utilisateurs qui ont mis à jour depuis une ancienne version conservent leur raccourci précédent. `⌘ + /` affiche à tout moment la liste complète des raccourcis.

### Épingler la fenêtre

Par défaut, le lanceur **disparaît dès qu'il perd le focus** — c'est le comportement attendu d'un outil « toujours à portée de main », mais il devient gênant lorsqu'on veut garder les résultats sous les yeux tout en manipulant une autre fenêtre.

Cliquez sur la **punaise** en bas à droite pour activer **Épingler le lanceur** : la fenêtre ne s'efface plus à la perte du focus. `Esc` continue de la fermer. Un second clic sur la punaise la détache.

***

## Rechercher

Tapez directement dans le champ de saisie : **la recherche se lance au fil de la frappe, sans appuyer sur Entrée**.

### Restreindre à une bibliothèque

Saisir `@` bascule en mode sélection de bibliothèque ; l'invite du champ devient **Saisissez un nom de bibliothèque...** et la liste de vos [bibliothèques](https://linkly.ai/docs/fr/use-libraries.md) s'affiche en dessous. Une fois l'une d'elles choisie, son badge apparaît à gauche du champ et les recherches suivantes se limitent à cette bibliothèque.

Pour quitter la restriction : appuyez sur `Backspace` alors que le champ est vide.

### Passer la main à l'IA

Quand les résultats ne suffisent pas — ou quand ce que vous vouliez était en réalité « analyse-moi ça » plutôt que « trouve-moi ça » — appuyez sur `Tab` : la saisie en cours est transmise au [Chatbot](https://linkly.ai/docs/fr/use-chatbot.md), et le lanceur se ferme. Le bouton **Demander à l'IA**, à droite du champ, déclenche la même action.

> [!NOTE]
>
> `Tab` n'est intercepté que dans l'état de recherche ordinaire. En mode sélection de bibliothèque `@`, sous restriction à une bibliothèque ou dans la vue d'aperçu, `Tab` conserve son comportement habituel.

### Continuer la recherche dans la fenêtre principale

Une fois un terme saisi, un bouton « **Ouvrir dans la fenêtre principale** » apparaît à droite du pied de page. Il reprend le terme de recherche dans la page « Rechercher » de la fenêtre principale pour y poursuivre la recherche, et ferme le lanceur. Ce bouton n'apparaît pas en mode sélection de bibliothèque `@`, ni sous restriction à une bibliothèque.

### Historique de recherche

Lorsque le champ est vide, le lanceur affiche la liste **Recherches récentes** : un clic sur l'une d'elles la relance. **Effacer l'historique de recherche**, en haut à droite, vide le tout d'un coup.

***

## Réduire le nombre de résultats

Quand la recherche en ramène trop, deux outils permettent de resserrer — tous deux situés en haut de la liste de résultats.

### Filtrer par type de fichier

Dès que les résultats contiennent **plus d'un** type de fichier, une barre de filtres apparaît en haut, ordonnée du type le plus représenté au moins représenté dans les résultats courants, chaque type étant suivi de son décompte. Un clic n'affiche plus que cette catégorie ; **Tous** revient à l'absence de filtre.

Au clavier également : `⌘ + ↑` / `⌘ + ↓` font défiler **Tous** et les différents types.

> [!NOTE]
>
> La barre de filtres **n'apparaît que si les résultats comportent plusieurs types**. Si la recherche ne remonte que des PDF, il n'y a rien à filtrer et elle n'occupe pas d'espace.

### Trier

Le tri par défaut est celui de la **pertinence**. Le bouton de tri, en haut, propose trois options :

| Option | Comportement |
| - | - |
| **Plus pertinents** | Par défaut. Selon le score de pertinence de la recherche hybride |
| **Plus récents** | Par date de modification décroissante : les fichiers modifiés récemment en tête |
| **Plus anciens** | Par date de modification croissante |

Au clavier : `⌘ + Shift + ↑` / `⌘ + Shift + ↓` font défiler les options. Une fois un tri temporel actif, la date de modification s'affiche sur chaque résultat.

> [!TIP]
>
> « Ce document que j'ai retouché la semaine dernière, dont j'ai oublié le nom » — dans ce cas de figure, lancez une recherche approximative puis basculez sur **Plus récents** : deux gestes suffisent en général.

***

## Aperçu et actions

Appuyez sur `Enter` sur un résultat pour entrer dans la vue d'aperçu.

* **Le texte intégral**, avec les termes recherchés en surbrillance et un défilement automatique jusqu'à la première correspondance
* Bascule **Source / Aperçu** (uniquement pour les documents disposant d'un rendu, comme le Markdown)
* **Panneau d'informations** : `⌘ + I` le déplie et affiche titre, chemin, pertinence, taille, nombre de caractères, nombre de mots, date de modification, date de création et mots-clés
* **Afficher dans le dossier** : `Shift + Enter`, ou le bouton **Afficher dans le dossier** en haut à droite, sélectionne le fichier dans le Finder / l'Explorateur
* **Ouvrir avec l'app par défaut** : le bouton du même nom, en haut à droite, ouvre le fichier d'origine avec l'application associée dans le système
* **Copier le chemin** : `⌘ + Shift + C` copie le chemin absolu du fichier
* **Exporter en Markdown** : pour les documents dont l'analyse produit du Markdown (le texte structuré issu d'un PDF ou d'un DOCX, par exemple), un clic copie l'intégralité du Markdown structuré dans le presse-papiers — directement exploitable en le collant à n'importe quelle IA

`Esc` ou `Backspace` ramène à la liste de résultats.

> [!NOTE]
>
> `Shift + Enter`**affiche le fichier dans son dossier**, il ne l'ouvre pas avec le programme par défaut. Vous pouvez ainsi vérifier son emplacement et ce qui l'entoure avant de décider quoi en faire ; pour l'ouvrir directement, cliquez sur « Ouvrir avec l'app par défaut ».

### Consulter le fichier original

Par défaut, l'aperçu affiche le **Texte extrait** : le texte que Linkly AI a tiré du fichier, c'est-à-dire ce que la recherche et l'IA lisent réellement. Pour les PDF et les images, vous pouvez aussi basculer vers le **Fichier d'origine** pour voir le fichier tel qu'il est, directement dans l'application, et vérifier le résultat de l'extraction :

* Cliquez sur le bouton « **Fichier d'origine** » / « **Texte extrait** » en haut à droite de l'aperçu, ou appuyez sur `⌘ + E` pour basculer de l'un à l'autre
* **PDF d'origine** : vous pouvez tourner les pages, saisir un numéro de page pour y sauter, et ajuster la taille avec « Zoom arrière », « Zoom avant », « Ajuster à la largeur » et « Revenir à 100 % » ; le pincement à deux doigts sur le pavé tactile ou la molette avec `⌘` enfoncée permettent aussi de zoomer
* **Audio et vidéo** : pas de bouton de bascule ; l'aperçu comporte directement un lecteur en haut, avec la transcription en dessous

***

## Les marqueurs d'état sur les résultats

Certains résultats portent un badge gris « Non indexé · … », qui signifie que **ce fichier n'est trouvable que par son nom : son contenu n'a pas été indexé**. Le survol du badge en donne la raison :

| Badge | Raison |
| - | - |
| **Non indexé · espace réservé cloud** | Le service cloud n'a pas encore téléchargé le fichier sur cette machine |
| **Non indexé · signature invalide** | Le contenu réel ne correspond pas à l'extension (souvent un fichier factice) |
| **Non indexé · pas de piste audio** | Ce fichier multimédia ne contient pas de piste audio, rien à transcrire |
| **Non indexé · transcription échouée** | La transcription n'a pas abouti (audio indécodable ou format non pris en charge) |
| **Non indexé · langue non prise en charge** | La langue parlée dans le fichier n'est pas couverte par le modèle de transcription actuel |
| **Non indexé · extraction échouée** | L'extraction du texte a échoué (taille maximale dépassée, protection par mot de passe, fichier illisible ou encodage du texte non reconnu) |
| **Non indexé** | Ignoré pour une autre raison ; le nom du fichier reste trouvable |

Les deux premiers cas relèvent le plus souvent du **téléchargement à la demande** des services cloud : une fois le fichier présent en local, il est réindexé automatiquement. Voir la section correspondante des [questions fréquentes](https://linkly.ai/docs/fr/faq.md).

***

## Raccourcis clavier

### Global

| Raccourci | Fonction |
| - | - |
| `⌘ + L` (macOS) / `Ctrl + L` (Windows/Linux) | Invoquer/fermer le lanceur |

### Vue de recherche

| Raccourci | Fonction |
| - | - |
| `↑` / `↓` | Se déplacer entre les résultats |
| `Enter` | Prévisualiser le document sélectionné |
| `Shift + Enter` | Afficher le fichier dans son dossier |
| `⌘ + Shift + C` | Copier le chemin absolu du fichier |
| `Tab` | Transmettre la saisie en cours au chat IA |
| `⌘ + ↑` / `⌘ + ↓` | Changer de filtre par type de fichier |
| `⌘ + Shift + ↑` / `↓` | Changer de mode de tri |
| `@` | Entrer en mode sélection de bibliothèque |
| `Backspace` | Champ vide : quitter la sélection / lever la restriction |
| `⌘ + /` | Ouvrir la liste des raccourcis |
| `⌘ + ,` | Ouvrir les paramètres |
| `Esc` | Fermer le lanceur |

### Vue de prévisualisation

| Raccourci | Fonction |
| - | - |
| `⌘ + I` | Afficher/masquer le panneau d'informations |
| `⌘ + E` | Basculer fichier d'origine / texte extrait (PDF, images) |
| `Shift + Enter` | Afficher le fichier dans son dossier |
| `⌘ + Shift + C` | Copier le chemin absolu du fichier |
| `⌘ + ,` | Ouvrir les paramètres |
| `Esc` / `Backspace` | Retourner à la liste de résultats |

> [!NOTE]
>
> Dans les tableaux ci-dessus, la touche `⌘` correspond à la touche `Ctrl` sur Windows et Linux.

***

## Questions fréquentes

> [accordion] Les résultats sont très « littéraux », la recherche sémantique ne fonctionne pas ?
>
> La cause la plus courante est un modèle d'embedding pas encore téléchargé, ou dont le téléchargement a échoué — **et l'interface de recherche n'en dit rien** : elle retombe silencieusement sur les seuls mots-clés.
>
> Consultez la ligne **Recherche sémantique** dans la zone « Gestion » de la page **Gestion de l'index**, ainsi que l'état du modèle dans **Paramètres → Modèles IA → Modèle d'embedding**. La marche à suivre complète figure dans [Paramètres d'indexation](https://linkly.ai/docs/fr/indexing.md).

> [accordion] L'icône du pied de page tourne, cela gêne-t-il la recherche ?
>
> Une icône qui tourne signale que l'indexation est en cours. Cela ne gêne pas la recherche, mais les résultats peuvent être encore incomplets. L'indexation procède par couches : d'abord les noms de fichiers, puis les mots-clés du texte, enfin les vecteurs sémantiques. La recherche reste utilisable pendant l'indexation ; la même requête sera simplement plus juste une fois l'indexation terminée.

> [accordion] Pourquoi ne vois-je pas le bouton de tri ou de filtre ?
>
> Les deux **apparaissent à la demande** :
>
> * Bouton de tri : uniquement lorsqu'il y a de vrais résultats (jamais pendant le squelette de chargement, sur une recherche vide ou en mode sélection de bibliothèque)
> * Filtre par type : uniquement lorsque les résultats comportent **au moins deux** types de fichiers

> [accordion] Le lanceur disparaît dès que je clique ailleurs, comment le garder ouvert ?
>
> Cliquez sur la punaise en bas à droite pour activer **Épingler le lanceur**. Une fois épinglé, il ne se masque plus à la perte du focus ; `Esc` le ferme toujours.

> [accordion] Les notes sont-elles trouvables depuis le lanceur ?
>
> Oui. Les [notes](https://linkly.ai/docs/fr/use-notes.md) sont des fichiers Markdown ordinaires du dossier `~/LinklyAI` : elles sont indexées et interrogées comme n'importe quel autre document.

> [accordion] Peut-on y trouver le contenu des bibliothèques cloud ?
>
> Non. Le lanceur interroge **ce qui est indexé sur votre machine**. Les [bibliothèques cloud](https://linkly.ai/docs/fr/use-cloud-library.md) sont destinées aux assistants IA passant par la passerelle cloud : elles n'apparaissent pas dans les résultats du lanceur local.

***

## Pour aller plus loin

* [Paramètres d'indexation](https://linkly.ai/docs/fr/indexing.md) — les réglages qui déterminent ce qui est trouvable
* [Utiliser les bibliothèques](https://linkly.ai/docs/fr/use-libraries.md) — d'où vient ce que `@` propose
* [Utiliser le Chat IA](https://linkly.ai/docs/fr/use-chatbot.md) — là où mène `Tab`
* [Utiliser les notes](https://linkly.ai/docs/fr/use-notes.md) — elles apparaissent aussi dans les résultats
* [Questions fréquentes](https://linkly.ai/docs/fr/faq.md) — durée d'indexation, confidentialité et dépannage


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.