> ## 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.
# Questions fréquentes
> Réponses aux questions les plus posées sur Linkly AI.
Cette page rassemble les questions les plus fréquemment posées par les utilisateurs de Linkly AI.
## Comment Linkly AI protège-t-il la confidentialité des données ?
Linkly AI repose sur une architecture **local-first**. Les documents originaux, l'index plein texte, l'index vectoriel ainsi que l'inférence du modèle d'embedding s'exécutent tous sur votre appareil et ne sont, par défaut, envoyés à aucun serveur.
### Quelles données restent sur votre appareil
* **Documents originaux** : ils restent dans leur dossier d'origine. Linkly AI se contente de les lire — il ne les copie pas et ne les déplace pas.
* **Index plein texte (BM25)** : construit localement avec Tantivy.
* **Index vectoriel** : les embeddings sont stockés dans une base de données locale.
* **Modèle d'embedding** : un modèle d'embedding local s'exécute entièrement sur votre appareil ; sur Apple Silicon, l'accélération GPU Metal est activée automatiquement.
* **Journaux d'application** : écrits uniquement dans des fichiers locaux, jamais envoyés automatiquement.
### Où vont les données du chat IA
Quand le chatbot appelle un grand modèle de langage, le chemin des données dépend du provider que vous avez choisi :
Ollama, LM Studio ou tout autre service local compatible OpenAI. Les données restent entièrement sur votre machine.
Les requêtes sont relayées par `api.linkly.ai` vers un fournisseur de modèles tiers. Elles transitent par les serveurs Linkly.
Connexion directe à OpenAI, Anthropic, etc. Les requêtes ne passent pas par les serveurs Linkly.
Vous pouvez ajouter, basculer ou désactiver chaque provider depuis **Paramètres → Modèles IA**.
### Programme d'amélioration de l'expérience utilisateur (télémétrie)
Pour comprendre quelles fonctionnalités sont utilisées et dans quels environnements l'application tourne, Linkly AI envoie par défaut un rapport d'usage **anonyme** :
| Données envoyées | Données NON envoyées |
| -------------------------------------------------- | ------------------------------------ |
| Compteurs d'usage par fonctionnalité | Contenu des documents, noms, chemins |
| Version de l'appli, OS, architecture | Contenu des chats, requêtes |
| Identifiant d'appareil aléatoire généré localement | Clés API, URL personnalisées |
Vous pouvez le désactiver à tout moment depuis **Paramètres → Confidentialité → Programme d'amélioration de l'expérience utilisateur**. Une fois désactivé, les événements en attente en mémoire sont également jetés.
Le panneau « Confidentialité » des paramètres affiche, sous forme de trois cartes, le flux de chaque fonctionnalité (**Local / Cloud officiel / Tiers**), pour que vous voyiez d'un coup d'œil quelles données quittent votre appareil.
### Engagements de confidentialité
* Aucun SDK d'analytique tiers (Google Analytics, etc.).
* Nous ne lisons ni votre historique de navigation, ni votre presse-papiers.
* Aucun compte obligatoire — les fonctionnalités essentielles fonctionnent hors ligne.
* Les journaux d'application restent sur votre machine et ne nous sont envoyés que si vous les partagez explicitement.
## Combien de temps prend l'indexation Linkly AI ?
Le temps d'indexation dépend du **nombre de fichiers, de leur type, des performances de la machine** et du **mode d'indexation**. L'indexation se déroule en trois phases :
Dès qu'un fichier est détecté, son chemin et son nom sont écrits dans l'index plein texte, ce qui vous permet de chercher par nom de fichier pendant que l'indexation continue.
Le contenu des documents (txt, md, html, docx, pptx, epub, pdf, images, ainsi que l'audio et la vidéo une fois la transcription activée) est analysé ; les sommaires et métadonnées sont écrits dans Tantivy. Plusieurs workers peuvent traiter en parallèle.
Le modèle d'embedding local génère un vecteur pour chaque morceau de document et l'écrit dans l'index vectoriel.
### Facteurs qui influencent la vitesse
* **Nombre de fichiers** : à peu près linéaire avec le temps total.
* **Format des fichiers** : le texte brut est le plus rapide ; les PDF nécessitent l'analyse de la mise en page.
* **Performances de la machine** : sur Apple Silicon (série M), l'accélération GPU Metal rend les embeddings nettement plus rapides que l'inférence CPU. Sous Windows / Linux, l'inférence est actuellement sur CPU.
* **Mode d'indexation** : choisissez `Performance / Équilibré / Auto` dans **Paramètres → Index**. Le mode Performance utilise plus de concurrence et de CPU ; Auto bascule sur Performance quand le système est inactif.
### Estimations approximatives
Ces ordres de grandeur ne sont qu'indicatifs — le temps réel varie beaucoup selon le matériel et le mix de fichiers :
| Scénario | Temps approximatif |
| --------------------------------------------------------- | ----------------------------------------------- |
| Milliers de fichiers texte brut (txt / md), Mac M | Quelques minutes |
| Dizaines de milliers de fichiers mixtes (avec PDF), Mac M | Plusieurs dizaines de minutes à quelques heures |
| Beaucoup d'images nécessitant l'OCR | Sensiblement plus long |
| Même volume sur Windows / Linux en CPU pur | Plus lent que sur Mac |
Vous pouvez suivre la progression en temps réel (indexés / en attente) en haut du Launcher. L'indexation tourne en arrière-plan et ne bloque pas la recherche — dès que l'index des noms de fichiers est terminé, la recherche est immédiatement disponible.
Si vous découvrez Linkly AI, commencez avec une **petite base de connaissances** (centaines à milliers de fichiers), puis ajoutez des dossiers plus volumineux une fois que vous êtes à l'aise.
## Pourquoi ce fichier est-il introuvable ?
Commencez par un tri : **cherchez-le par son nom de fichier**. Les trois résultats possibles correspondent à trois problèmes radicalement différents.
| Résultat de la recherche par nom | Ce que cela signifie | Où continuer |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Trouvé, **avec un badge gris « Non indexé · … »** | Le fichier est bien entré dans l'index, mais son contenu a été laissé de côté | Les [quatre causes possibles](#quatre-causes-possibles), juste en dessous |
| Trouvé, **sans badge**, mais le contenu reste introuvable | Le contenu n'a pas encore été traité, ou l'extraction correspondante est désactivée | [Section suivante](#le-nom-se-trouve-sans-badge-mais-pas-le-contenu) |
| **Même le nom est introuvable** | Le fichier n'est tout simplement jamais entré dans l'index | [Section d'après](#même-le-nom-du-fichier-est-introuvable) |
Cette étape est décisive : les trois cas se traitent de manière complètement différente, et sauter le tri conduit très souvent à s'acharner longtemps dans la mauvaise direction.
Les fichiers laissés de côté **ne sont pas** listés séparément dans les paramètres. **Le badge affiché dans les résultats de recherche est le seul moyen de les repérer** — d'où la nécessité de faire ce tri vous-même.
### Quatre causes possibles
| Badge | Ce qui s'est réellement passé |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Non indexé · espace réservé cloud** | Le fichier existe bien dans le service cloud, mais **il n'a pas encore été téléchargé sur cette machine** — le disque n'en contient qu'un espace réservé |
| **Non indexé · signature invalide** | Le contenu réel du fichier ne correspond pas à son extension (un fichier nommé `.pdf` dont le contenu n'a rien d'un PDF, par exemple) |
| **Non indexé · pas de piste audio** | Cette vidéo ne comporte pas de piste audio : il n'y a rien à transcrire |
| **Non indexé · transcription échouée** | La transcription n'a pas abouti (audio indécodable, ou format audio non pris en charge) |
Le survol du badge donne la même explication. Ces fichiers restent présents dans les résultats de recherche ; simplement, aucun contenu n'y est interrogeable.
### Les espaces réservés cloud, de quoi s'agit-il
iCloud Drive, OneDrive, Dropbox, Synology Drive et consorts proposent tous un **téléchargement à la demande** (aussi appelé « fichiers à la demande », « en ligne uniquement » ou « synchronisation intelligente ») : le fichier est visible dans le Finder ou l'Explorateur, mais son contenu réside encore dans le cloud et n'est réellement téléchargé qu'au moment où vous l'ouvrez.
Linkly AI **s'abstient délibérément d'ouvrir ces fichiers** : les ouvrir déclencherait leur téléchargement, ce qui reviendrait à rapatrier en local, le temps d'une indexation, les centaines de gigaoctets de votre espace cloud — disque saturé et bande passante engloutie à la clé. Il se contente donc d'examiner leurs attributs et, dès qu'il reconnaît un espace réservé, laisse le contenu de côté en conservant l'index du nom de fichier.
**Que faire** : dans le client de votre service cloud, marquez les dossiers que vous voulez vraiment pouvoir interroger comme devant rester en local (chaque éditeur a son propre libellé : « Toujours conserver sur cet appareil » chez OneDrive, « Rendre disponible hors ligne » chez Dropbox, un clic droit → « Télécharger maintenant » sur iCloud). Une fois les fichiers présents localement, Linkly AI constatera leur disponibilité lors de l'analyse suivante et **complétera l'indexation du contenu tout seul** — sans reconstruction d'index ni réajout du dossier.
Une analyse se déclenche automatiquement au démarrage de l'application, à chaque changement de configuration (ajout ou retrait d'un dossier) et lorsqu'un grand nombre de modifications de fichiers est détecté. Pour en provoquer une immédiatement, le plus simple reste de redémarrer l'application.
### Que faire en cas de signature invalide
Ce badge signale que les octets caractéristiques en tête de fichier ne correspondent pas à l'extension. Cela se produit couramment avec les fichiers doublure ou stub produits par certains outils de synchronisation, les téléchargements interrompus en cours de route, ou les fichiers dont l'extension a été changée à la main.
Ouvrez le fichier avec le logiciel censé le lire pour en avoir le cœur net : s'il ne s'ouvre pas davantage, Linkly AI a eu raison de le laisser de côté ; s'il s'agit simplement d'une extension erronée, il suffit de la corriger.
Sur ce point, l'arbitrage de Linkly AI est **plutôt laisser passer que rejeter à tort** : si la lecture de l'en-tête se heurte à une erreur d'E/S passagère ou à un aléa de permissions, le fichier est systématiquement considéré comme lisible. Un échec ponctuel ne fera jamais marquer définitivement un vrai fichier comme une doublure.
## Le nom se trouve, sans badge, mais pas le contenu
L'absence de badge signale que le fichier lui-même ne pose pas de problème : c'est **l'étape d'extraction du contenu qui n'a pas encore eu lieu, ou qui ne peut pas aboutir**. Par ordre de probabilité décroissante :
1. **L'extraction correspondante est désactivée.** Les images et les PDF scannés dépendent de la **Reconnaissance de texte dans les images (OCR)** ; l'audio et la vidéo dépendent de la **Transcription audio** et de la **Transcription vidéo** — **ces deux dernières sont désactivées par défaut**. Vérifiez dans **Paramètres → Index**.
2. **Son tour n'est pas encore venu.** L'OCR et la transcription des médias sont les tâches les plus lourdes ; une file d'attente lente est normale. Le détail d'état de la page des paramètres indique ce qui est en cours de traitement.
3. **L'analyse de ce fichier a échoué.** Un fichier corrompu ou un PDF chiffré, par exemple. Ce cas ne produit aucun badge : le fichier est simplement laissé de côté, sans nouvelle tentative.
Le rôle et la valeur par défaut de chaque réglage, ainsi que la signification de chaque ligne du détail d'état, sont expliqués sur cette page.
## Même le nom du fichier est introuvable
C'est que le fichier **n'est jamais entré dans l'index**. Trois causes courantes :
**1. Ce dossier n'est pas surveillé.** Vérifiez dans **Paramètres → Dossiers** que son répertoire parent figure bien dans la liste. L'assistant de premier lancement n'indexe que les exemples fournis : vos propres répertoires, c'est à vous de les ajouter.
**2. Ce format ne figure pas dans la liste des formats pris en charge.** Linkly AI fonctionne par liste blanche : seules les extensions PDF, DOCX, PPTX, EPUB, Markdown, TXT, HTML, images, audio et vidéo sont retenues. **xlsx, csv, doc, rtf, htm et avi n'en font actuellement pas partie** — un fichier hors liste blanche ne voit même pas son nom enregistré. La liste complète figure dans [Présentation des outils](/docs/fr/tools-intro).
**3. Il se trouve dans un répertoire ignoré.** Les répertoires suivants sont écartés en bloc, avec l'intégralité de leur arborescence :
* **Les répertoires cachés commençant par un point** (`.git`, `.cache`, `.dropbox.cache`, etc.)
* **`node_modules`, `__pycache__`** et les caches de dépendances ou de build du même genre
* **Les répertoires de métadonnées de synchronisation des NAS** : `#recycle`, `#SynoRecycle`, `@eaDir` (Synology), `@Recycle` (QNAP)
* **Les répertoires système** : `$RECYCLE.BIN`, `System Volume Information`
Dans un dépôt Git, les fichiers exclus par le `.gitignore` ne sont pas indexés non plus. Si vos notes se trouvent justement dans un répertoire ignoré d'un dépôt, déplacez-les ailleurs, ou ajoutez ce répertoire séparément dans **Paramètres → Dossiers**.
## Impossible de retrouver ce qui est dit dans un audio ou une vidéo ?
Parce que **la transcription audio et la transcription vidéo sont désactivées par défaut**. Désactivées, les fichiers multimédias sont malgré tout enregistrés dans l'index — leur nom reste donc trouvable — mais ce qui s'y dit n'est pas transcrit.
Activez **Transcription audio** et **Transcription vidéo** dans **Paramètres → Index** : l'application téléchargera le modèle de reconnaissance vocale, puis rattrapera automatiquement l'ensemble des fichiers multimédias déjà présents — sans nouvelle analyse ni reconstruction d'index.
Cette page détaille le rôle et la valeur par défaut de chaque réglage de **Paramètres → Index**, ainsi que la marche à suivre complète lorsque l'indexation se comporte mal.
## Où se trouvent les réglages les plus courants ?
La fenêtre des paramètres est découpée par domaine. Voici les pages que l'on cherche le plus souvent :
* **Langue** : la langue d'affichage de l'interface
* **Lancer à l'ouverture de session** : démarrer Linkly AI à l'ouverture de session
* **Démarrage silencieux** : au démarrage automatique, rester en arrière-plan sans ouvrir la fenêtre principale — **activé par défaut**, ce qui laisse tourner l'indexation et le service MCP sans vous déranger
* **Raccourci de recherche** : le raccourci global qui affiche/masque le [lanceur](/docs/fr/use-launcher). Un clic suffit pour le réenregistrer, et **Réinitialiser** rétablit celui d'origine. Si un message signale que la combinaison est déjà prise ou réservée par le système, choisissez-en une autre
* **Espace Linkly AI** : le dossier indexé par défaut, que l'on peut ouvrir ou déplacer ailleurs ; voir [Espace Linkly AI](/docs/fr/linkly-space)
* **Thème** : Clair / Sombre / Système
* **Taille du texte** : Petite / Standard / Grande, appliquée à la fois à l'interface et au contenu des conversations
* **Afficher l'icône du Dock** (macOS) : une fois désactivée, l'application ne subsiste que dans la barre d'état système et n'occupe plus de place dans le Dock
* **Vérifier les mises à jour** : rechercher et télécharger manuellement une nouvelle version ; une fois le téléchargement terminé, un clic sur **Redémarrer pour mettre à jour** suffit
* **Rejoindre le programme bêta** : une fois activé, vous recevez les versions bêta et accédez en avant-première aux nouvelles fonctionnalités, au prix de changements pas encore complètement éprouvés
* **Dossier de données** : l'emplacement de l'index, des réglages et des journaux ; le bouton **Ouvrir** y mène directement (c'est là que se trouvent les journaux, voir la section suivante)
* On y trouve également les liens vers le journal des modifications, la politique de confidentialité, les conditions d'utilisation, ainsi que la présentation du CLI et des Skills
Cette page recense l'intégralité des raccourcis de l'application. Depuis le lanceur, `⌘ + /` (ou `Ctrl + /` sous Windows/Linux) l'ouvre directement.
**Suspendre l'indexation** ne se trouve pas dans les paramètres : cette commande n'existe que dans le **menu de la barre d'état système**, qui ne se déploie qu'au **clic droit** sur l'icône L de la barre d'état (un clic gauche ouvre la fenêtre de conversation IA). Voir [Paramètres d'indexation](/docs/fr/indexing).
## Comment récupérer les journaux d'application Linkly AI ?
Pendant qu'elle tourne, l'application écrit automatiquement tous ses journaux dans un fichier local `app.log` (2 Mo maximum par fichier, avec rotation). Joindre ce fichier accélère considérablement le diagnostic lorsque vous nous signalez un problème ou que vous le résolvez vous-même. Les données sensibles sont déjà masquées.
Il y a deux façons de récupérer le journal :
### Option 1 : Ouvrir depuis l'application (recommandé)
C'est la méthode la plus simple :
Dans Linkly AI, allez dans **Paramètres → À propos**.
Repérez la ligne « **Dossier de données** » et cliquez sur le bouton « **Ouvrir** » à droite. Le gestionnaire de fichiers s'ouvre sur le dossier des données de l'application.
Ouvrez le sous-dossier `logs/` et envoyez-nous `app.log`.
### Option 2 : Ouvrir le répertoire de données manuellement
Si l'application a planté ou ne se lance plus, ouvrez le dossier directement sur le disque :
1. Ouvrez le Finder.
2. Dans la barre de menus, choisissez **Aller → Aller au dossier…** (ou appuyez sur ⌘ + ⇧ + G).
3. Collez le chemin suivant et appuyez sur Entrée :
```
~/Library/Application Support/ai.linkly.desktop/logs
```
4. Trouvez `app.log` dans le dossier ouvert et envoyez-le-nous.
1. Appuyez sur Win + R pour ouvrir la fenêtre « Exécuter ».
2. Collez le chemin suivant et appuyez sur Entrée :
```
%APPDATA%\ai.linkly.desktop\logs
```
3. Trouvez `app.log` dans le dossier ouvert et envoyez-le-nous.
Dans un terminal :
```bash theme={null}
xdg-open ~/.local/share/ai.linkly.desktop/logs
```
Ou copiez `app.log` directement :
```bash theme={null}
cp ~/.local/share/ai.linkly.desktop/logs/app.log ~/Desktop/
```
### Que faire si l'application plante au démarrage ?
Si l'application plante immédiatement au lancement, `app.log` peut ne pas avoir eu le temps d'être écrit. Dans ce cas, nous enregistrons les informations de plantage dans un **journal de plantage au démarrage** distinct `linkly-ai-startup-panic.log`. Voici où le trouver.
1. Ouvrez le Finder.
2. Dans le menu, choisissez **Aller → Aller au dossier…** (ou appuyez sur ⌘ + ⇧ + G).
3. Collez le chemin ci-dessous et appuyez sur Entrée :
```
~/Library/Application Support
```
4. Trouvez `linkly-ai-startup-panic.log` dans le dossier ouvert et envoyez-le-nous.
1. Appuyez sur Win + R pour ouvrir la fenêtre « Exécuter ».
2. Collez le chemin ci-dessous et appuyez sur Entrée :
```
%LOCALAPPDATA%
```
3. Trouvez `linkly-ai-startup-panic.log` dans le dossier ouvert et envoyez-le-nous.
Notez que ce chemin utilise `%LOCALAPPDATA%` (données locales), et non `%APPDATA%` (données itinérantes) utilisé par `app.log`.
Dans un terminal :
```bash theme={null}
cp ~/.local/share/linkly-ai-startup-panic.log ~/Desktop/
```
Ce journal n'est créé que lorsqu'un plantage survient au démarrage, et chaque plantage remplace le précédent. Si ce fichier n'existe pas non plus, faites une capture d'écran de la fenêtre de plantage et envoyez-la-nous avec votre version d'OS.
Ouvrez une issue GitHub ou contactez-nous via l'un des canaux de la page communauté.