> ## 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.

# Paramètres d'indexation

> Comprendre chaque réglage de la page Paramètres → Index : ce qu'il fait, sa valeur par défaut, ce qui change quand on l'active ou le désactive, et comment diagnostiquer un index qui ne suit pas.

Si Linkly AI retrouve un document de votre disque en une fraction de seconde, c'est grâce à un travail de fond permanent : l'**indexation**. Cette page passe en revue chaque réglage de **Paramètres → Index** et donne la marche à suivre lorsque l'index ne se comporte pas comme prévu.

Si vous venez d'installer l'application et n'avez pas encore ajouté vos propres documents, commencez par le [Démarrage rapide](/docs/fr/quickstart).

***

## Comment fonctionne l'indexation

L'index de Linkly AI est construit **par couches**. Il ne s'agit pas d'attendre la fin du traitement pour pouvoir chercher : chaque couche terminée débloque une capacité de recherche supplémentaire.

<Steps>
  <Step title="Couche 1 : les noms de fichiers (quelques secondes)">Dès qu'un fichier est repéré, son chemin et son nom entrent dans l'index. Cette couche est quasi instantanée : juste après avoir ajouté un dossier, vous pouvez déjà retrouver son contenu par nom de fichier.</Step>
  <Step title="Couche 2 : le texte intégral (mots-clés)">Le corps du document est extrait puis écrit dans l'index plein texte local, ce qui autorise la correspondance par mots-clés. Une fois cette couche terminée, chercher « tableau budgétaire » remonte les documents où ces mots apparaissent dans le texte.</Step>
  <Step title="Couche 3 : le sémantique (vecteurs)">Un modèle d'embedding local découpe le texte en blocs et les convertit en vecteurs. Une fois cette couche terminée, chercher « combien ai-je dépensé l'an dernier » remonte le rapport financier, même si ces mots ne figurent nulle part dans son titre.</Step>
</Steps>

À ces trois couches s'ajoutent deux **extracteurs de contenu optionnels**, chargés de transformer en texte des fichiers qui n'en contiennent pas, avant de les faire passer par les trois couches ci-dessus :

* **Reconnaissance de texte (OCR)** : lit le texte contenu dans les images et les PDF numérisés
* **Extraction de texte audio et vidéo (ASR)** : transcrit les paroles présentes dans les fichiers audio et vidéo

***

## Visite guidée de Paramètres → Index

La page **Paramètres → Index** se lit de haut en bas en quatre blocs :

| Bloc                  | Contenu                                                              |
| --------------------- | -------------------------------------------------------------------- |
| **Documents indexés** | Un grand nombre : combien de documents contient l'index actuellement |
| **Détail de l'état**  | 6 lignes en lecture seule indiquant où en est chaque couche          |
| **Réglages**          | 7 interrupteurs, le cœur de la page, détaillés un à un ci-dessous    |
| **Maintenance**       | Les deux boutons **Optimiser** et **Reconstruire**                   |

### Lire le détail de l'état

| Ligne                                           | Signification                                                                                                 |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Statut**                                      | L'état global de l'index, 5 valeurs possibles, voir [Les cinq statuts possibles](#les-cinq-statuts-possibles) |
| **Recherche par nom de fichier**                | Couche 1 : affiche **Prêt** en fonctionnement normal                                                          |
| **Recherche en texte intégral**                 | Couche 2 : affiche **Prêt** en fonctionnement normal                                                          |
| **Recherche sémantique**                        | Couche 3 : **Prêt** / **Préparation** / **En file** ; affiche **Désactivé** si l'interrupteur est coupé       |
| **Reconnaissance de texte (OCR)**               | **Prêt** / **Préparation**, ou le fichier en cours de traitement ; **Désactivé** si l'interrupteur est coupé  |
| **Extraire le texte de l'audio et de la vidéo** | **Prêt** / **Traitement en cours** / **En attente**, etc. ; **Non activé** si la fonction n'est pas activée   |
| **Dernière mise à jour**                        | Date de la dernière écriture dans l'index                                                                     |
| **Taille des données**                          | Espace disque occupé par l'index                                                                              |

***

## Les réglages d'indexation

### 1. Mode de performance

**Ce qu'il fait** : détermine la part de ressources de calcul que l'indexation de fond peut consommer.

**Valeur par défaut** : Auto (Recommandé)

| Option                | Comportement                                                                                                                              |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Équilibré**         | Indexation au strict minimum de ressources : impact quasi nul sur votre travail                                                           |
| **Performance**       | L'indexation mobilise autant de ressources que possible pour l'analyse et le calcul, quitte à se faire sentir pendant l'usage             |
| **Auto (Recommandé)** | Bascule en mode Performance après **120 secondes** sans activité clavier ni souris, et revient en Équilibré dès que vous reprenez la main |

### 2. Économie d'énergie

**Ce qu'il fait** : suspend les tâches lourdes lorsqu'un portable fonctionne sur batterie.

**Valeur par défaut** : désactivé

<Warning>Deux conditions doivent être réunies simultanément pour que le réglage agisse : **l'interrupteur est activé** et **l'ordinateur est alimenté par la batterie**.</Warning>

Ce qui est suspendu sur batterie :

* l'OCR des images
* la conversion des PDF numérisés en Markdown structuré
* l'indexation sémantique (génération des vecteurs)
* la transcription audio et vidéo
* la synchronisation automatique des bibliothèques cloud
* les opérations de compactage de la base de données

**Ce qui continue normalement** : l'index des noms de fichiers et l'index plein texte (mots-clés). Même en économie d'énergie, un nouveau fichier reste donc trouvable.

**Quand y toucher** : sur un portable, activez-le une fois pour toutes et oubliez-le. Sur une tour, le réglage ne change rien.

### 3. Mise en veille des modèles IA inactifs

**Ce qu'il fait** : libère la mémoire occupée par les modèles IA locaux après une période d'inactivité, puis les recharge automatiquement en cas de besoin.

**Valeur par défaut** : activé

Les modèles locaux (embedding sémantique, OCR, reconnaissance vocale) sont déchargés après environ **300 secondes (5 minutes)** d'inactivité.
Désactivé, les modèles restent résidents en mémoire : environ **1 Go** au total pour les trois.

**Quand y toucher** : si votre mémoire est limitée (8 Go ou moins), gardez le réglage par défaut, c'est-à-dire activé.

### 4. Reconnaissance de texte dans les images (OCR)

**Ce qu'il fait** : lit le texte des images à l'aide du modèle OCR local, **et convertit les PDF numérisés en Markdown structuré**.

**Valeur par défaut** : activé

### 5. Recherche sémantique

**Ce qu'il fait** : une fois activée, permet de retrouver un document en le décrivant en langage naturel.

**Valeur par défaut** : activée

### 6 et 7. Transcription audio et Transcription vidéo

**Ce qu'elles font** : le modèle local de reconnaissance vocale transcrit les paroles contenues dans les fichiers audio et vidéo, puis le texte obtenu alimente l'index plein texte et l'index sémantique.

**Valeur par défaut : les deux sont désactivées** ⚠️

| Type      | Formats pris en charge                       |
| --------- | -------------------------------------------- |
| **Audio** | mp3, wav, m4a, flac, aac, ogg                |
| **Vidéo** | mp4, mov, mkv, webm (avi non pris en charge) |

<Warning>**Désactivé ne veut pas dire non indexé.** Les fichiers média sont enregistrés dans l'index comme les autres : **ils restent trouvables par leur nom, mais pas par ce qui s'y dit**.</Warning>

**Quand y toucher** : dès que vous avez des enregistrements de réunion, des podcasts ou des vidéos de cours à interroger.

***

## Optimiser ou reconstruire l'index

### Optimisation du stockage de l'index

Reconstruit l'index vectoriel dans un format nettement plus compact. Le gain est **presque gratuit** :

* l'espace disque diminue d'**environ 80 %** (jusqu'à 11,6 fois plus petit en mesure réelle)
* la recherche devient plus rapide

Quitter l'application en cours de route est sans danger : rien n'est endommagé et l'opération reprend au démarrage suivant.

<Note>**Lorsque l'index est déjà au format optimal, le bouton ne fait rien** : il affiche simplement **Votre index est déjà optimisé**. Il est également **impossible de forcer une nouvelle passe**.</Note>

### Reconstruire l'index

**C'est une opération à risque**, d'où le bouton rouge. Elle va :

* **supprimer** : le dossier de l'index plein texte, tous les vecteurs, ainsi que les marqueurs de progression de chaque document
* **conserver** : vos fichiers d'origine, le cache de texte déjà extrait et les modèles déjà téléchargés

C'est précisément parce que le cache de texte et les modèles sont conservés qu'une reconstruction est en général **bien plus rapide** que la toute première indexation : les étapes les plus lentes, l'analyse des documents et l'OCR, sont évitées.

Pendant la reconstruction, les recherches **renvoient des résultats vides** (ce n'est pas une erreur).

<Warning>
  Dans les quatre situations suivantes, l'action est **refusée** et le bouton reste sans effet :

  * des tâches d'OCR ou de transcription audio/vidéo sont encore en cours en arrière-plan
  * l'indexation a été suspendue (depuis le menu de la barre d'état)
  * une analyse ou une indexation est en cours
  * une reconstruction est déjà en cours
</Warning>

***

## Les cinq statuts possibles

Le statut de l'index prend cinq valeurs :

| Statut           | Signification                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------- |
| **Inactif**      | Rien n'a encore démarré, **ou bien l'indexation a été suspendue** (les deux cas partagent cette valeur) |
| **Analyse**      | Parcours des dossiers pour découvrir les fichiers présents                                              |
| **Indexation**   | Analyse et indexation du contenu des fichiers en cours                                                  |
| **Surveillance** | L'état stable : tout est indexé, l'application attend les modifications de fichiers                     |
| **Erreur**       | Un incident est survenu ; la cause précise figure dans les [journaux de l'application](/docs/fr/faq)         |

**Surveillance** est l'état que vous voulez voir en fin de course.

### Comment suspendre l'indexation

**La commande de suspension existe uniquement dans le menu de la barre d'état système.** Faites un **clic droit** sur l'icône L de la barre d'état pour ouvrir le menu : il contient **⏸︎ Suspendre l'indexation** / **▶︎ Démarrer l'indexation** (un clic gauche ouvre la fenêtre de conversation IA, pas le menu).

***

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Pourquoi mes fichiers audio et vidéo sont-ils trouvables par leur nom, mais pas par leur contenu ?">
    Parce que **la transcription audio et la transcription vidéo sont désactivées par défaut**. Les fichiers média sont bien enregistrés dans l'index (d'où la recherche par nom), mais ce qui s'y dit n'a jamais été transcrit.

    Ouvrez **Paramètres → Index** et activez **Transcription audio** et **Transcription vidéo** : l'application télécharge 161 Mo de modèle de reconnaissance vocale, puis rattrape automatiquement tout le stock existant — sans nouvelle analyse ni reconstruction de l'index.

    Une exception : si un sous-titre `.srt` / `.vtt` du même nom se trouve à côté du fichier média, ou si une transcription antérieure est encore en cache, le contenu reste trouvable même interrupteurs coupés.
  </Accordion>

  <Accordion title="Le texte de mes PDF numérisés et de mes images est introuvable ?">
    Vérifiez d'abord dans **Paramètres → Index** si **Reconnaissance de texte dans les images (OCR)** n'est pas désactivé.

    **Attention : cet interrupteur commande à la fois l'OCR des images et l'extraction de texte des PDF numérisés** — bien que son libellé ne mentionne que les images. Une fois coupé, un PDF numérisé se réduit lui aussi à un nom de fichier sans contenu.

    S'il est bien activé, regardez la ligne **Reconnaissance de texte (OCR)** dans le détail de l'état : **Préparation** signifie que le modèle est encore en cours de téléchargement ou de chargement, il suffit de patienter.
  </Accordion>

  <Accordion title="Le statut reste bloqué sur Inactif et rien ne progresse ?">
    La cause la plus fréquente est une **indexation suspendue**. Cette commande n'existe que dans le **menu de la barre d'état système** : faites un **clic droit** sur l'icône de la barre d'état pour déployer le menu, et si vous y lisez **▶︎ Démarrer l'indexation**, c'est que l'indexation est en pause — un clic la relance.

    Repère : le statut affiche **Inactif** et, juste en dessous, une courte ligne en anglais `Indexing paused`. Ce message vient du moteur d'indexation et reste en anglais dans toutes les langues.

    Si l'indexation n'est pas suspendue, vérifiez dans **Paramètres → Dossiers** que vous avez bien ajouté vos propres répertoires : l'assistant de premier lancement n'indexe que les documents d'exemple fournis.
  </Accordion>

  <Accordion title="La recherche sémantique semble sans effet, les résultats restent très littéraux ?">
    Procédez dans cet ordre :

    1. Dans le détail de l'état de **Paramètres → Index**, la ligne **Recherche sémantique** affiche-t-elle **Désactivé** ? Si oui, l'interrupteur a été coupé ; réactivez-le (le rattrapage est automatique, aucune reconstruction n'est nécessaire).
    2. Affiche-t-elle **Préparation** ou **En file** ? Les vecteurs sont encore en construction, laissez le traitement se terminer.
    3. Ni l'un ni l'autre ? Allez dans **Paramètres → IA → Modèle d'embedding** pour voir si le modèle est encore en téléchargement ou si celui-ci a échoué — **rien n'en est signalé dans l'interface de recherche**, qui se rabat silencieusement sur les seuls mots-clés. En cas d'échec, cliquez sur **Réessayer** dans la carte.
  </Accordion>

  <Accordion title="Comment suspendre l'indexation ? Je ne trouve rien dans les paramètres">
    La suspension se trouve **uniquement dans le menu de la barre d'état système**, jamais dans les paramètres. **Clic droit** sur l'icône L de la barre d'état → **⏸︎ Suspendre l'indexation**. La reprise se fait au même endroit : l'entrée de menu devient **▶︎ Démarrer l'indexation**.

    Tant que l'indexation est suspendue, **Reconstruire l'index** est impossible : il faut d'abord la relancer.
  </Accordion>

  <Accordion title="L'index occupe trop d'espace disque, que faire ?">
    Allez dans **Paramètres → Index → Maintenance** et cliquez sur **Optimiser**. L'index vectoriel est reconstruit dans un format plus compact : **environ 80 % d'espace disque en moins**, au prix d'environ 1 % de rappel, et la recherche s'en trouve en plus accélérée.

    Si le bouton affiche **Votre index est déjà optimisé**, c'est que votre index est au nouveau format : il n'y a plus rien à gagner, et l'opération ne peut pas être forcée.
  </Accordion>

  <Accordion title="Mes résultats de recherche sont étranges, faut-il reconstruire l'index ?">
    Pas si vite. La reconstruction est le dernier recours, et la recherche renvoie des résultats vides pendant toute sa durée. Essayez d'abord, dans cet ordre :

    1. Vérifiez que l'interrupteur concerné n'est pas coupé (OCR / recherche sémantique / transcription audio et vidéo)
    2. Vérifiez que l'indexation n'est pas suspendue (menu de la barre d'état)
    3. Vérifiez que le statut est bien passé à **Surveillance**, et non toujours à **Indexation**

    Ce n'est qu'une fois ces trois points écartés qu'il faut envisager **Paramètres → Index → Maintenance → Reconstruire**. La reconstruction ne supprime ni vos fichiers d'origine, ni le cache de texte déjà extrait, ni les modèles téléchargés : elle est donc en général bien plus rapide que la première indexation.
  </Accordion>

  <Accordion title="Le mode de performance permet-il d'arrêter l'indexation ?">
    Non. Le mode de performance **détermine seulement le nombre de threads utilisés et la fréquence à laquelle l'indexation cède la place** ; il ne détermine pas si elle doit tourner ou non. Choisir **Équilibré** la rend simplement plus lente et plus discrète.

    Pour l'arrêter réellement, utilisez **Suspendre l'indexation** dans le menu de la barre d'état.

    À noter également : le mode **Auto (Recommandé)** ne regarde que **l'inactivité du clavier et de la souris** (au-delà de 120 secondes) — ni la batterie, ni la charge processeur. Sur un bureau Linux en Wayland pur, ce signal est inaccessible : **Auto** y équivaut donc en permanence à **Équilibré**.
  </Accordion>

  <Accordion title="J'ai activé l'économie d'énergie mais je ne vois aucune différence ?">
    C'est normal. L'économie d'énergie ne s'applique que si **l'interrupteur est activé** et que **l'ordinateur est alimenté par la batterie**. Branché sur secteur, ou sur une tour dépourvue de batterie, elle n'a strictement aucun effet.

    C'est précisément pour cela qu'**elle peut rester activée en permanence** : inutile de l'activer avant de partir et de la désactiver en rentrant.
  </Accordion>

  <Accordion title="Mon ordinateur rame pendant l'indexation, que faire ?">
    Par ordre d'impact croissant :

    1. Passez le mode de performance sur **Équilibré** (effet immédiat : les tâches en cours se réapprovisionnent selon le nouveau budget)
    2. Désactivez temporairement **Transcription audio** et **Transcription vidéo** — la transcription média est la tâche la plus lourde, et elle se dispute le même créneau unique global que l'OCR
    3. Si cela ne suffit pas, utilisez **Suspendre l'indexation** dans le menu de la barre d'état et reprenez à un moment plus calme
  </Accordion>
</AccordionGroup>

***

## Pour aller plus loin

* [Démarrage rapide](/docs/fr/quickstart) — installer, ajouter vos documents, brancher vos outils IA
* [Utiliser le lanceur de recherche](/docs/fr/use-launcher) — le mode d'emploi complet de l'interface de recherche
* [Utiliser les bibliothèques](/docs/fr/use-libraries) — restreindre la recherche par bibliothèque
* [Questions fréquentes](/docs/fr/faq) — durée d'indexation attendue, récupération des journaux
* [Utiliser le Chat IA](/docs/fr/use-chatbot) — l'état de l'index est également visible au bas de la barre latérale
* [Espace Linkly AI](/docs/fr/linkly-space) — le dossier indexé par défaut