Skip to main content
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.
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 : 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, 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.
Les dossiers Notes, Clips et Canvas de l’espace Linkly AI 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.
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

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