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

# Espace Linkly AI

> Le dossier par défaut que l'application crée et indexe toute seule : où il se trouve, ce qu'il contient, comment en changer l'emplacement, et les pièges à éviter.

## 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](/docs/fr/use-notes) que vous prenez dans l'application, les pages web capturées avec l'[extension de navigateur](/docs/fr/use-extension) 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.

<Note>
  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`
</Note>

***

## Où il se trouve sur le disque

Par défaut, dans **votre dossier personnel** :

| Système     | Chemin par défaut                       |
| ----------- | --------------------------------------- |
| **macOS**   | `/Users/<nom d'utilisateur>/LinklyAI`   |
| **Windows** | `C:\Users\<nom d'utilisateur>\LinklyAI` |
| **Linux**   | `/home/<nom d'utilisateur>/LinklyAI`    |

<Warning>**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.</Warning>

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

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](#raccourci-sur-le-bureau) est en général également présent sur le bureau.

***

## Ce qu'il contient

```
~/LinklyAI/
├── Clips/                      pages web capturées par l'extension de navigateur
│   └── <titre de la capture>/  un dossier par capture, avec le .md et les images
├── Notes/                      notes en cartes
│   └── YYYY-MM/                un dossier par mois, en UTC
│       └── <10 premiers caractères>-<id sur 8 caractères>.md
└── Linkly_AI_Examples/         documents d'exemple livrés avec l'installateur
    ├── A-Life-in-10-Years/
    ├── Detectives-Library/
    ├── Federalist-Papers/
    ├── Mission-Logs/
    └── WPA-Slave-Narratives/
```

### `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](/docs/fr/use-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](/docs/fr/use-extension).

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

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

<Note>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éé.</Note>

***

## 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](/docs/fr/indexing).

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

<Warning>
  **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.
</Warning>

***

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

<Warning>
  **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.
</Warning>

<Steps>
  <Step title="Ouvrir Paramètres → Général et descendre tout en bas">
    Repérez la section **Espace Linkly AI** : le chemin actuel y est affiché.
  </Step>

  <Step title="Cliquer sur Modifier… et choisir un dossier parent">
    <Warning>
      **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`.
    </Warning>
  </Step>

  <Step title="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.</Step>

  <Step title="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.</Step>

  <Step title="Décider du sort de l'indexation de l'ancien emplacement">
    Voir l'avertissement ci-dessous.
  </Step>
</Steps>

<Warning>
  **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**.
</Warning>

<Note>Effet de bord : le [raccourci](#raccourci-sur-le-bureau) 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.</Note>

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

***

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

| Système     | Forme                     |
| ----------- | ------------------------- |
| **macOS**   | lien symbolique (symlink) |
| **Windows** | raccourci `.lnk`          |
| **Linux**   | fichier `.desktop`        |

<Note>
  **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](#changer-son-emplacement) : cette opération recrée systématiquement un raccourci pointant vers le nouvel emplacement.
</Note>

<Tip>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**.</Tip>

***

## À 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** :

|                                   | Espace Linkly AI                                    | Dossier de données                                                   |
| --------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------- |
| **Contenu**                       | Vos contenus : notes, captures, documents d'exemple | Index, base de données, journaux, modèles téléchargés                |
| **Où le voir**                    | Paramètres → Général → Espace Linkly AI             | Paramètres → À propos → Dossier de données                           |
| **Emplacement modifiable**        | Oui                                                 | L'interface indique explicitement **Ne pas modifier sauf nécessité** |
| **Compatible cloud**              | Possible, mais sans garantie                        | **Surtout pas**                                                      |
| **Conséquence d'une suppression** | Perte de contenus (notes, captures)                 | Perte de l'index et de la configuration, réindexation nécessaire     |

### Où se trouvent les journaux

Le fichier journal est `logs/app.log`, situé dans le **dossier de données**.

<Warning>
  **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.
</Warning>

***

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

<Warning>**Ne supprimez pas et ne déplacez pas ce dossier depuis le gestionnaire de fichiers.** Voici les conséquences réelles, cas par cas.</Warning>

| Ce que vous faites                                      | Résultat                                                                                                                                                                            |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Supprimer le dossier sans redémarrer l'application**  | L'index ne bouge pas immédiatement ; **Paramètres → Dossiers** affiche **Dossier introuvable**                                                                                      |
| **Supprimer le dossier, puis redémarrer l'application** | L'application recrée un `~/LinklyAI` **vide**, l'analyse le trouve vide, et les documents concernés sortent de l'index après environ **60 secondes**                                |
| **Déplacer le dossier à la main**                       | La configuration continue de pointer vers l'ancien chemin, recréé vide au redémarrage ; **le nouvel emplacement n'est pas indexé du tout, sauf ajout manuel à la liste surveillée** |
| **Supprimer uniquement `Linkly_AI_Examples`**           | Sans danger. Les exemples ne sont décompressés qu'au premier lancement, ne sont pas recréés, et n'affectent aucune fonctionnalité                                                   |

**La bonne façon de changer d'emplacement** :

<Steps>
  <Step title="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.</Step>
  <Step title="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.</Step>
  <Step title="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**.</Step>
</Steps>

***

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Peut-on placer l'Espace Linkly AI dans iCloud, Dropbox ou OneDrive ?">
    **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.
  </Accordion>

  <Accordion title="Après un changement d'emplacement, les anciens fichiers sont-ils déplacés ?">
    **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.
  </Accordion>

  <Accordion title="Après un changement d'emplacement, les documents de l'ancien dossier restent-ils trouvables ?">
    **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**.
  </Accordion>

  <Accordion title="Je l'ai retiré depuis Paramètres → Dossiers, que se passe-t-il ?">
    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.
  </Accordion>

  <Accordion title="Peut-on supprimer les documents d'exemple ?">
    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.
  </Accordion>

  <Accordion title="Comment retirer le raccourci LinklyAI du bureau ?">
    **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](#changer-son-emplacement) — cette étape recrée systématiquement un raccourci pointant vers le nouvel emplacement.
  </Accordion>

  <Accordion title="J'ai supprimé ~/LinklyAI par erreur, que faire ?">
    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.
  </Accordion>

  <Accordion title="Où se trouve le fichier journal ?">
    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**.
  </Accordion>
</AccordionGroup>

***

## Pour aller plus loin

* [Démarrage rapide](/docs/fr/quickstart) — installer, dérouler l'assistant, ajouter vos propres documents
* [Paramètres d'indexation](/docs/fr/indexing) — comment le contenu de ce dossier est indexé, concrètement
* [Utiliser les notes](/docs/fr/use-notes) — la règle de nommage et le format YAML de `Notes/`
* [Utiliser les bibliothèques](/docs/fr/use-libraries) — rattacher ce dossier (ou l'un de ses sous-dossiers) à une bibliothèque
* [Questions fréquentes](/docs/fr/faq) — les autres pistes de diagnostic
* [Utiliser le Chat IA](/docs/fr/use-chatbot) — référencer le contenu de ce dossier avec `@` dans une conversation
* [Utiliser l'extension de navigateur](/docs/fr/use-extension) — d'où vient le contenu de `Clips/`
