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 :
Le dossier par défaut de vos documents : vos notes et extraits y sont rangés, et vous pouvez y ajouter d’autres fichiers.
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 (dans Paramètres → Général, juste au-dessus de Données de l’application)
  • 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 : 151 fichiers Markdown, environ 11,9 Mo une fois décompressés. Dès l’ouverture de l’assistant de premier lancement, l’application les décompresse et les indexe en arrière-plan, afin que vous puissiez chercher quelque chose dès l’installation terminée et essayer la recherche comme les questions à l’IA.
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. Si vous voulez seulement qu’il n’apparaisse plus dans les résultats de recherche, vous pouvez aussi faire un clic droit dessus dans la bibliothèque et choisir « Ajouter une règle d’exclusion… ».
Les dossiers Clips/, Notes/ et Canvas/ 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, c’est un dossier surveillé ordinaire, au même titre que les répertoires Documents ou Projets que vous ajouterez ensuite, et la logique d’indexation par couches est identique à celle des autres dossiers : voir Paramètres d’indexation. Seule différence : ses notes, clips et canevas sont toujours indexés. Les interrupteurs de type de fichier et les règles d’exclusion de l’onglet « Règles » ne s’appliquent pas à ces trois dossiers, et on ne peut pas leur écrire de règle d’exclusion. Dans la liste des dossiers de la colonne de gauche de la Bibliothèque (fenêtre principale), il occupe toujours la première place, sous le nom « Espace Linkly AI ». Dans « Gérer les sources », sa description est « Espace Linkly AI, la bibliothèque par défaut », et il ne peut pas être retiré : les autres dossiers ont un bouton « Retirer » en bout de ligne, lui non.
Les utilisateurs de longue date qui passent directement d’une version antérieure à 0.6 repassent eux aussi par l’assistant : cette règle vaut donc également pour eux.

​
Changer son emplacement

Manque de place dans le dossier personnel, envie de basculer sur un autre disque : utilisez la ligne Espace Linkly AI de Paramètres → Général (juste au-dessus de Données de l’application). Elle comporte trois boutons à droite : Ouvrir, ainsi que deux boutons-icônes dont l’infobulle indique respectivement 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

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

Cliquer sur Modifier et confirmer

Lisez la phrase de la boîte de confirmation, puis cliquez sur Continuer.
3

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.
Une fois le dossier choisi, 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 Bibliothèque → « Gérer les sources ».
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 comme Modifier, à ceci près que la destination est fixée au dossier LinklyAI du dossier personnel : il affiche lui aussi d’abord une boîte de confirmation, 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 les données de l’application

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

​
Où se trouvent les journaux

Le fichier journal est logs/app.log, situé dans le répertoire des Données de l’application. Deux façons d’ouvrir le dossier des journaux :
  • cliquer sur Ouvrir à côté de Données de l’application dans Paramètres → Général, puis entrer dans le sous-dossier logs/
  • dans Paramètres → À propos, cliquer sur Envoyer sur la ligne Envoyer le journal de diagnostic : la fenêtre qui s’ouvre propose Ouvrir le dossier des journaux en bas à gauche
Au-delà de 10 Mo, app.log est tronqué et seuls les 5 derniers Mo sont conservés. 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é coupés.

​
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, confirmez, puis 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 Bibliothèque → « Gérer les sources ».

​
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 (Bibliothèque → « Ajouter un dossier ») 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 Bibliothèque → « Gérer les sources ».
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 répertoire des Données de l’application, sous logs/app.log — et non dans l’Espace Linkly AI.Le chemin d’accès : Paramètres → Général → Données de l’application → Ouvrir, puis le sous-dossier logs/. Vous pouvez aussi, dans Paramètres → À propos, cliquer sur Envoyer sur la ligne Envoyer le journal de diagnostic, puis sur Ouvrir le dossier des journaux dans la fenêtre qui s’affiche.Au-delà de 10 Mo, app.log est tronqué et seuls les 5 derniers Mo sont conservés : pour signaler un problème, récupérez le journal d’abord, reproduisez ensuite.

​
Pour aller plus loin