Skip to main content

Qu’est-ce que l’Espace Linkly AI

L’Espace Linkly AI est un dossier tout à fait ordinaire, que l’application crée automatiquement sur votre ordinateur. Voici comment elle le décrit elle-même :
Un dossier par défaut, créé et indexé automatiquement — pour vos documents, notes, extraits, etc.
Son rôle est simple : quand l’application a quelque chose à écrire sur le disque, c’est ici qu’elle l’écrit par défaut. Les notes que vous prenez dans l’application, les pages web capturées avec l’extension de navigateur et les documents d’exemple livrés avec l’installateur atterrissent tous dans ce dossier. C’est un répertoire ordinaire, sans le moindre format propriétaire : il s’ouvre dans le Finder ou l’Explorateur, ses fichiers se modifient avec n’importe quel éditeur, il se passe au grep, et il se copie intégralement ailleurs.
Trois écritures différentes désignent la même chose à trois endroits, et elles ne se contredisent pas :
  • l’interface parle d’Espace Linkly AI (tout en bas de Paramètres → Général)
  • sur le disque, le dossier s’appelle LinklyAI (sans espace)
  • le dossier des documents d’exemple qu’il contient s’appelle Linkly_AI_Examples

Où il se trouve sur le disque

Par défaut, dans votre dossier personnel :
Il s’agit du dossier personnel, et non du dossier Documents. Beaucoup le cherchent par réflexe dans Documents et ne le trouvent pas. Sous macOS, ⌘⇧H dans le Finder ouvre directement le dossier personnel.
Sous Windows, le chemin affiché dans Paramètres → Général utilise des barres obliques normales, par exemple C:/Users/xxx/LinklyAI : l’application normalise les chemins en interne, c’est normal, et il s’agit bien du même dossier que le C:\Users\xxx\LinklyAI de l’Explorateur.
Pour l’ouvrir rapidement : Paramètres → Général → Espace Linkly AI → Ouvrir l’ouvre directement dans le gestionnaire de fichiers du système. Un raccourci est en général également présent sur le bureau.

Ce qu’il contient

Notes/ — les notes

Chaque note en carte écrite dans l’application est un fichier .md de ce dossier, rangé dans un sous-dossier par mois UTC. La règle de nommage, les champs de l’en-tête YAML et les précautions à prendre avec un éditeur externe sont détaillés dans Utiliser les notes.

Clips/ — les captures web

Les pages enregistrées avec l’extension de navigateur arrivent ici, une capture par dossier indépendant, contenant le texte en Markdown et les images de la page. Le fonctionnement de la capture, ses réglages et son comportement de repli sont décrits dans Utiliser l’extension de navigateur.

Linkly_AI_Examples/ — les documents d’exemple

Un ensemble de textes du domaine public livrés avec l’installateur : 159 fichiers, environ 11,9 Mo une fois décompressés, tous en Markdown. Ils sont décompressés et indexés pendant l’écran Préparation de l’assistant de premier lancement, afin que vous puissiez chercher quelque chose dès l’installation terminée et essayer la recherche comme le Chatbot.
Une fois familiarisé, vous pouvez supprimer purement et simplement Linkly_AI_Examples/ : aucune fonctionnalité n’en dépend, et les entrées correspondantes disparaissent automatiquement de l’index.
Les dossiers Clips/ et Notes/ sont recréés au besoin à chaque démarrage : si vous les supprimez à la main, ils réapparaîtront au lancement suivant (mais leur contenu, lui, ne reviendra pas). Linkly_AI_Examples/ n’est en revanche décompressé qu’une seule fois, lors du premier lancement : une fois supprimé, il n’est jamais recréé.

Comment il est indexé

Si le contenu de ce dossier est trouvable, ce n’est pas parce qu’il bénéficie d’un traitement de faveur, mais parce que : l’assistant de premier lancement l’ajoute automatiquement à la liste des dossiers surveillés. Autrement dit, il figure dans Paramètres → Dossiers comme un dossier surveillé ordinaire, strictement au même niveau que les répertoires Documents ou Projets que vous ajouterez ensuite. La logique d’indexation par couches et les réglages qui l’affectent sont identiques à ceux des autres dossiers : voir Paramètres d’indexation.
Les utilisateurs de longue date repassent eux aussi par l’assistant après une mise à jour : cette règle vaut donc également pour eux, il n’y a pas à craindre que ce dossier sorte de la liste surveillée après une montée de version.
Rien ne vous empêche de le retirer depuis Paramètres → Dossiers — mais réfléchissez-y à deux fois.Une fois retiré, il n’est plus indexé, alors que l’application continue tranquillement d’y écrire vos notes et vos captures. Résultat : les notes que vous prenez et les pages que vous capturez existent bel et bien sur le disque, mais ne remontent plus jamais, ni dans la recherche ni dans les requêtes de l’IA — et aucun message ne vous en explique la raison.Si le retrait était accidentel, il suffit de rajouter le dossier depuis Paramètres → Dossiers : les fichiers existants seront réindexés.

Changer son emplacement

Manque de place dans le dossier personnel, envie de basculer sur un autre disque : la section Espace Linkly AI, tout en bas de Paramètres → Général, propose trois boutons — Ouvrir, Modifier… et Rétablir par défaut.
Ce n’est pas une migration. L’application ne déplace aucun de vos fichiers.La boîte de confirmation l’énonce sans ambiguïté :
Les fichiers existants ne seront pas déplacés : ils restent à leur emplacement actuel et y restent indexés. Cette action ne modifie que l’emplacement des nouveaux fichiers à venir.
Et le message affiché après l’opération va dans le même sens :
Emplacement du dossier mis à jour. Les fichiers existants restent à l’ancien emplacement et ne sont pas déplacés automatiquement.
En arrière-plan, l’application ne fait que deux choses : créer un dossier vide au nouvel emplacement et y faire pointer la configuration. Rien n’est copié, déplacé ni supprimé ; aucun redémarrage n’est nécessaire ; l’opération prend moins d’une seconde.
1

Ouvrir Paramètres → Général et descendre tout en bas

Repérez la section Espace Linkly AI : le chemin actuel y est affiché.
2

Cliquer sur Modifier… et choisir un dossier parent

Le sélecteur attend le dossier parent, et non l’espace lui-même. Choisir ~/Documents vous donne ~/Documents/LinklyAI ; choisir la racine d’un disque externe vous donne /Volumes/XXX/LinklyAI.Seule exception : si vous sélectionnez directement un dossier qui s’appelle déjà LinklyAI, l’application l’utilise tel quel, sans ajouter un niveau supplémentaire du type LinklyAI/LinklyAI.
3

Confirmer

Lisez la phrase de la boîte de confirmation, puis cliquez sur Continuer. Le nouveau dossier est créé immédiatement et la configuration prend effet aussitôt.
4

Déplacer vous-même les anciens fichiers (si nécessaire)

L’application ne le fera pas à votre place. Pour que vos anciennes notes et captures rejoignent le nouvel emplacement, vous devez copier vous-même Notes/, Clips/ et le reste dans le gestionnaire de fichiers.
5

Décider du sort de l'indexation de l'ancien emplacement

Voir l’avertissement ci-dessous.
L’ancien chemin reste dans la liste des dossiers surveillés et continue d’être indexé.La plupart des gens s’attendent à ce que seul le nouvel emplacement soit indexé après l’opération ; en réalité, les deux emplacements le sont — pas un seul document de l’ancien dossier ne disparaît des résultats de recherche.C’est une bonne chose si vous vouliez simplement changer l’endroit où sont rangées les nouveautés (vos anciens documents restent accessibles) ; mais si votre intention était de déplacer complètement ce dossier, il vous faut retirer l’ancien chemin depuis Paramètres → Dossiers.
Effet de bord : le raccourci présent sur le bureau est mis à jour pour pointer vers le nouvel emplacement. Le bouton Rétablir par défaut se comporte exactement comme Modifier…, à ceci près que la destination est fixée au dossier LinklyAI du dossier personnel — et là non plus, aucune donnée n’est déplacée.
Le changement d’emplacement est disponible à partir de la v0.8.0. Sur une version antérieure, mettez à jour avant de tenter l’opération.

Raccourci sur le bureau

À la fin de l’assistant de premier lancement, l’application crée sur le bureau du système un raccourci nommé LinklyAI, qui pointe vers le dossier de l’Espace Linkly AI (et non vers l’application elle-même : l’ouvrir mène au dossier, pas au logiciel).
Aucun réglage de l’interface ne permet de le désactiver. La seule façon de s’en débarrasser consiste à supprimer le raccourci du bureau : une fois supprimé, il n’est plus recréé automatiquement.Seule exception, le changement d’emplacement de l’espace : cette opération recrée systématiquement un raccourci pointant vers le nouvel emplacement.
Si votre bureau contenait déjà un fichier ou un dossier nommé LinklyAI que l’application n’a pas créé, elle ne l’écrasera jamais.

À ne pas confondre avec le dossier de données

C’est la paire de notions la plus souvent confondue. L’Espace Linkly AI contient vos contenus, le dossier de données contient les données internes de l’application :

Où se trouvent les journaux

Le fichier journal est logs/app.log, situé dans le dossier de données.
La page Paramètres → À propos ne comporte pas de bouton pour ouvrir les journaux : il faut d’abord cliquer sur Ouvrir à côté de Dossier de données, puis entrer dans le sous-dossier logs/.Par ailleurs, app.log fait l’objet d’une rotation à 2 Mo : au-delà, seule la seconde moitié du contenu est conservée. Quand vous voulez nous signaler un problème, la bonne séquence est donc : récupérer et mettre de côté le journal actuel, puis reproduire le problème. En procédant dans l’ordre inverse, les indices les plus anciens ont de bonnes chances d’avoir déjà été effacés par la rotation.

Que se passe-t-il en cas de suppression ou de déplacement manuel

Ne supprimez pas et ne déplacez pas ce dossier depuis le gestionnaire de fichiers. Voici les conséquences réelles, cas par cas.
La bonne façon de changer d’emplacement :
1

Passer d'abord par Modifier… dans les paramètres

Dans Paramètres → Général → Espace Linkly AI, cliquez sur Modifier… et choisissez le nouveau dossier parent.
2

Copier ensuite vous-même les anciens fichiers

Dans le gestionnaire de fichiers, copiez le contenu de l’ancien dossier vers le nouveau. Préférez la copie au déplacement, et ne supprimez l’ancien qu’après vérification.
3

Décider enfin du sort de l'ancien chemin

Pour que l’ancien emplacement reste interrogeable, ne faites rien ; sinon, retirez l’ancien chemin depuis Paramètres → Dossiers.

Questions fréquentes

Oui, mais sans aucune garantie officielle. L’application ne détecte pas les dossiers de synchronisation cloud et ne vous adresse ni message ni avertissement : si vous l’y placez, elle s’en accommode, et en cas de problème, aucune fenêtre ne s’ouvrira.L’indexation applique tout de même quelques protections génériques qui atténuent une partie des désagréments :
  • les fichiers de substitution cloud non encore téléchargés localement sont ignorés (les résultats de recherche affichent alors Non indexé · espace réservé cloud ; le fichier est réindexé automatiquement une fois téléchargé)
  • les suppressions fugaces dues aux à-coups de la synchronisation bénéficient d’une fenêtre de stabilisation de 60 secondes, de sorte qu’un simple soubresaut ne fait pas sortir un document de l’index
  • les dossiers de métadonnées de synchronisation comme #recycle ou @eaDir sont ignorés
Malgré cela, le téléchargement à la demande, les copies de conflit et les réécritures fréquentes propres au cloud peuvent faire bouger l’index en permanence. Si votre objectif se limite à partager des documents entre plusieurs appareils, ajouter le dossier cloud comme un dossier surveillé ordinaire (Paramètres → Dossiers) est en général plus sûr que d’y déplacer l’espace tout entier.
Non. L’opération se limite à deux choses : créer un dossier au nouvel emplacement et y faire pointer la configuration. Pas un fichier existant n’est touché : ils restent où ils sont et continuent d’être indexés.La phrase « Les fichiers existants ne seront pas déplacés » de la boîte de confirmation n’est pas une clause de non-responsabilité : c’est la description exacte du comportement. Pour que les anciens fichiers suivent, c’est à vous de les copier dans le gestionnaire de fichiers.Et puisque rien n’est déplacé, la question d’une migration interrompue ou ratée en cours de route ne se pose tout simplement pas : l’opération prend moins d’une seconde.
Oui. L’ancien chemin reste dans la liste des dossiers surveillés et continue d’être indexé : les contenus des deux emplacements figurent dans le périmètre de recherche.C’est en général une bonne nouvelle (vos anciens documents ne disparaissent pas brusquement), mais si votre intention était de changer complètement de lieu, il faut retirer l’ancien chemin depuis Paramètres → Dossiers.
Il n’est plus indexé, mais les notes et les captures continuent d’y être écrites — et ce qui s’y écrit devient introuvable, sans le moindre message dans l’interface.C’est le piège le plus courant. Il suffit de rajouter le dossier depuis Paramètres → Dossiers pour tout rétablir : les fichiers existants seront réindexés.
Oui. Linkly_AI_Examples/ ne contient que des textes du domaine public en Markdown : sa suppression n’affecte aucune fonctionnalité, et les entrées correspondantes sont automatiquement nettoyées dans l’index.À garder en tête : ces fichiers ne sont décompressés qu’une seule fois, au premier lancement, et ne sont jamais recréés après suppression — si vous y tenez, faites-en d’abord une copie.
Il suffit de le supprimer : il ne sera plus recréé automatiquement. Aucun réglage de l’interface ne le contrôle.La seule opération capable de le faire réapparaître est le changement d’emplacement de l’espace — cette étape recrée systématiquement un raccourci pointant vers le nouvel emplacement.
Deux cas de figure :
  • Vous n’avez pas encore redémarré l’application : les fichiers sont déjà perdus (notes et captures s’y trouvaient), mais l’index, lui, est intact. Si vous disposez de Time Machine ou de l’Historique des fichiers, restaurez le dossier depuis la sauvegarde sans attendre, puis redémarrez l’application.
  • Vous avez déjà redémarré : l’application a recréé un dossier vide, l’analyse l’a trouvé vide, et les documents concernés sont sortis de l’index après environ 60 secondes. Seule une sauvegarde système permet alors de les récupérer.
L’application ne dispose ni de corbeille ni de mécanisme de sauvegarde propre. Ce dossier contient vos vrais fichiers : traitez-le comme n’importe quel dossier important.
Dans le dossier de données, sous logs/app.log — et non dans l’Espace Linkly AI.Le chemin d’accès : Paramètres → À propos → Dossier de données → Ouvrir, puis le sous-dossier logs/. La page À propos ne comporte pas de bouton ouvrant directement les journaux.app.log fait l’objet d’une rotation à 2 Mo qui ne conserve que la seconde moitié du contenu : pour signaler un problème, récupérez le journal d’abord, reproduisez ensuite.

Pour aller plus loin