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

# Périmètre de l'index

> Choisissez ce qui entre dans l'index : désactivez des types de fichiers entiers, ou excluez des fichiers et des dossiers avec des règles écrites comme un .gitignore.

Par défaut, Linkly AI indexe tous les fichiers pris en charge de vos dossiers. Deux moyens permettent de garder hors de l'index ce dont vous ne voulez pas :

* **Les types de fichiers** : désactivez un type entier, comme les images ou les vidéos, pour tous les dossiers.
* **Les règles d'exclusion** : écrites comme un `.gitignore`, elles excluent des fichiers et des dossiers par nom ou par chemin.

Les deux se trouvent dans l'onglet **Règles** de la page Gestion de l'index : cliquez sur l'état de l'index en bas de la barre latérale pour ouvrir Gestion de l'index, puis passez à Règles.

Les fichiers exclus sont retirés de l'index : la recherche, la bibliothèque, le Chat IA et les agents connectés ne les voient plus. **Les fichiers sur le disque ne sont pas modifiés.**

***

## Types de fichiers

Il y a 10 types, répartis en deux groupes, Documents et Images, audio et vidéo : PDF, documents Word, Markdown et texte brut, pages web, livres numériques, feuilles de calcul, présentations, images, audio et vidéo. Chaque ligne indique le nombre actuel de fichiers de ce type.

* **Désactiver un type** : ses fichiers ne sont plus analysés, indexés ni comptés ; ceux déjà présents dans l'index en sont retirés au bout d'environ une minute. Une confirmation vous est demandée avant.
* **Le réactiver** : l'analyse suivante ramène les fichiers et les indexe à nouveau. Le texte déjà reconnu dans les images et les transcriptions déjà faites sont réutilisés tant qu'ils sont encore en cache ; sinon, les images repassent par la reconnaissance du texte et l'audio et la vidéo sont transcrits à nouveau, ce qui prend du temps quand ils sont nombreux.

> [!NOTE]
>
> Si vous voulez seulement éviter la reconnaissance du texte des images tout en les retrouvant par leur nom, laissez le type Images activé et désactivez plutôt la reconnaissance de texte (OCR) dans « Améliorations de l'extraction », sur l'onglet Index. À l'inverse, quand le type Images est désactivé, l'OCR ne traite plus que les PDF numérisés et les images des dossiers `Notes`, `Clips` et `Canvas`.

Quand l'audio ou la vidéo est désactivé, l'interrupteur de transcription correspondant dans « Améliorations de l'extraction » est grisé.

## Règles d'exclusion

L'onglet Règles comporte une liste de règles pour Tous les dossiers et une pour chaque dossier. Cliquez sur Modifier ou Ajouter des règles pour ouvrir l'éditeur de règles.

Vous pouvez aussi faire un clic droit sur un fichier ou un dossier dans la **bibliothèque** et choisir « Ajouter une règle d'exclusion… » : l'éditeur s'ouvre avec une règle qui ne vise que cet élément. Si le dossier a déjà des règles, le menu propose aussi « Modifier les règles d'exclusion… ». Dans la bibliothèque, quand une règle désigne directement un dossier, le dossier qui le contient affiche une icône d'entonnoir qui ouvre aussi l'éditeur.

### Écrire les règles

Comme dans un `.gitignore`, une règle par ligne :

| Règle | Exclut |
| - | - |
| `*.csv` | Les fichiers `.csv`, où qu'ils soient |
| `brouillons/` | Les dossiers nommés `brouillons`, à tout niveau |
| `/brouillons/` | Seulement le dossier `brouillons` à la racine du dossier, pas ceux plus bas |
| `projet-a/export/` | Une règle avec un `/` au milieu part de la racine du dossier : ce dossier précis |
| `**/temp/**` | Tout le contenu des dossiers `temp`, à tout niveau |
| `!important.md` | Exception : une règle précédente l'a exclu, celle-ci le ramène |

Quelques précisions :

* `*` remplace n'importe quels caractères dans un même niveau, `?` un seul caractère, `[abc]` un des caractères entre crochets, et `**` seul sur un niveau remplace n'importe quel nombre de niveaux. `?` et `[…]` ne correspondent qu'aux caractères ASCII simples — lettres sans accent, chiffres et symboles courants ; pour les lettres accentuées, le chinois, etc., utilisez `*`.
* Un `/` final ne désigne que des dossiers.
* Les règles s'appliquent de haut en bas et la dernière qui correspond l'emporte : une exception se place après la règle qu'elle annule.
* **Une fois un dossier exclu, les fichiers qu'il contient ne peuvent pas être ramenés avec `!`.** Pour exclure un dossier en gardant un ou deux de ses fichiers, écrivez `brouillons/*` puis `!brouillons/important.md`.
* La casse des lettres A à Z est ignorée : `*.PNG` équivaut à `*.png`. C'est aussi le cas sur les systèmes de fichiers Linux sensibles à la casse, où `Draft/` exclut aussi `draft/`. Les autres lettres, comme les lettres accentuées, doivent respecter la casse du nom : `Été/` n'exclut pas `été/`.
* `\` compte toujours comme `/` : il n'y a donc pas d'échappement par barre oblique inverse ; écrivez `*`, `?`, `[`, `{` et `}` présents dans un nom sous la forme `[*]`, `[?]`, `[[]`, `[{]` et `[}]` (`{a,b}` correspond à `a` ou à `b`).
* Les chemins partent de la racine du dossier ; n'écrivez pas de chemin complet du disque.

### Tous les dossiers et un dossier précis

Chaque dossier applique d'abord les règles de Tous les dossiers, puis les siennes. Les règles propres à un dossier peuvent donc utiliser `!` pour ramener des fichiers qu'une règle de Tous les dossiers a exclus.

Quand des dossiers sont imbriqués (par exemple `Docs` et `Docs/Projet A` ajoutés tous les deux), un fichier n'est jugé que par les règles du dossier le plus profond qui le contient.

### L'éditeur de règles

* Pendant que vous tapez une règle, la ligne en dessous indique si elle est bien écrite et combien de fichiers elle exclurait, et propose une correction en cas de problème.
* L'aperçu liste précisément les fichiers concernés. Cliquez sur une règle de la liste pour ne voir que les fichiers qu'elle exclut.
* Vous pouvez coller plusieurs lignes de règles d'un coup : elles sont séparées en règles et vérifiées une à une.
* Après l'enregistrement, un message indique combien de fichiers vont quitter l'index et propose « Annuler » pendant 10 secondes.

### Quand les règles s'appliquent

Les fichiers exclus quittent l'index environ une minute après l'enregistrement, et vous pouvez encore les trouver d'ici là. Ainsi, « Annuler » ou un changement d'avis ne demandent aucun retraitement. Quand vous retirez une règle, l'analyse suivante ramène les fichiers et les traite à nouveau.

Si des fichiers exclus avaient été envoyés vers une [bibliothèque cloud](/docs/fr/use-cloud-library), la synchronisation suivante les supprime aussi dans le cloud. Avec la synchronisation automatique, quand beaucoup de fichiers seraient supprimés d'un coup, elle se met en pause jusqu'à ce que vous confirmiez par un envoi manuel ; un envoi manuel les supprime directement.

## Fichiers .ignore dans vos dossiers

Les règles peuvent aussi tenir dans un fichier : placez dans un dossier un fichier nommé `.ignore`, écrit comme un `.gitignore`.

* Il s'applique au dossier où il se trouve et à tout ce qu'il contient.
* Il ne nécessite pas de dépôt Git.
* `.gitignore` ne fonctionne que dans les dépôts Git ; `.ignore` fonctionne dans n'importe quel dossier.
* Il est appliqué exactement comme un `.gitignore` : sensible à la casse, et `\` sert d'échappement, donc les chemins n'utilisent que `/`.
* Modifier un fichier `.ignore` ne lance pas d'analyse : les fichiers déjà indexés ne quittent l'index qu'à la prochaine analyse complète, par exemple au redémarrage de Linkly AI.

C'est pratique pour des règles qui doivent suivre le dossier, comme le répertoire d'export d'un projet.

## Règles intégrées

Celles-ci s'appliquent toujours et ne peuvent pas être désactivées ; elles sont aussi listées en bas de l'onglet Règles :

* Fichiers et dossiers masqués : noms commençant par `.`, comme `.git`, `.obsidian`, `.DS_Store`
* Dossiers créés par le système et les applications de synchronisation : `node_modules`, `__pycache__`, `#recycle`, `#SynoRecycle`, `@eaDir`, `@Recycle`, `$RECYCLE.BIN`, `System Volume Information`
* Fichiers de données de Linkly AI : l'index, les paramètres, les journaux et les autres données de l'application (le dossier `ai.linkly.desktop`)
* Fichiers temporaires : les fichiers `~$` créés par Office pendant qu'un document est ouvert, et `Thumbs.db`
* Fichiers ignorés par `.gitignore` dans un dépôt Git
* Règles écrites dans les fichiers `.ignore` de vos dossiers
* Formats non pris en charge, comme les archives, les installateurs et les fichiers de code

Vos propres règles ne peuvent qu'exclure **davantage** ; elles ne peuvent pas ramener ce que ces règles écartent.

> [!NOTE]
>
> Les dossiers `Notes`, `Clips` et `Canvas` de l'[espace Linkly AI](/docs/fr/linkly-space) sont toujours indexés, quels que soient les types désactivés et les règles d'exclusion : la recherche dans les notes, les étiquettes et la lecture des notes par les agents en dépendent.

## Faire écrire les règles par un agent

Les règles sont enregistrées en texte brut dans le champ `indexScope` du fichier `config.json` de Linkly AI : un agent peut donc les lire.

Pour vous faire aider, dites à l'agent ce que vous voulez exclure et demandez-lui le texte des règles. Collez ensuite tout le texte dans l'éditeur de règles, vérifiez les règles et enregistrez.

> [!WARNING]
>
> Ne laissez pas un agent modifier directement `config.json` : l'application ne relit pas ce fichier pendant qu'elle tourne, et la prochaine fois qu'un réglage est enregistré, la modification de l'agent est écrasée. Si l'application redémarre avant, la modification s'applique dès le démarrage telle quelle — sans les vérifications de l'éditeur, sans le délai d'une minute et sans « Annuler ».

Quand un agent parcourt un dossier avec `list` et n'y trouve rien d'indexé, l'indication précise que des règles d'indexation ont pu exclure les fichiers ; l'aperçu `explore` mentionne aussi les types non indexés et le nombre de dossiers qui ont des règles.

## Questions fréquentes

> **J'ai désactivé un type, mais ses fichiers apparaissent encore ?**
>
> C'est normal. Pour que vous puissiez annuler, les fichiers exclus quittent l'index environ une minute après la dernière modification des types ou des règles. Ensuite, la recherche et la bibliothèque ne les montrent plus.

> **Pourquoi !brouillons/important.md ne fonctionne-t-il pas ?**
>
> Parce que `brouillons/` exclut le dossier entier : un dossier exclu n'est plus analysé, donc ses fichiers ne peuvent pas être ramenés un par un. Écrivez plutôt `brouillons/*` puis `!brouillons/important.md`.

> **Mes règles ont disparu après un retour à une version antérieure ?**
>
> Les anciennes versions ne connaissent pas le champ des règles et réécrivent le fichier de configuration au démarrage : les règles sont perdues et les fichiers exclus sont réindexés. Après une nouvelle mise à jour, configurez-les à nouveau.

***

## Pour aller plus loin

* [Paramètres d'indexation](/docs/fr/indexing) — chaque interrupteur de l'indexation et comment dépanner
* [Questions fréquentes](/docs/fr/faq) — que faire quand même le nom d'un fichier est introuvable
* [Espace Linkly AI](/docs/fr/linkly-space) — où sont rangés les notes, clips et canevas


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