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

# Utiliser les bibliothèques

> Organisez vos documents en bibliothèques thématiques pour des recherches plus précises et une gestion des connaissances plus efficace.

## Qu'est-ce qu'une bibliothèque

Une bibliothèque est un conteneur nommé dans Linkly AI pour organiser vos documents. Vous pouvez regrouper des documents du même thème dans une bibliothèque et filtrer vos recherches par bibliothèque pour trouver rapidement ce que vous cherchez.

<CardGroup cols={2}>
  <Card title="Isolation thématique" icon="layer-group" iconType="duotone">
    Séparez les « documents de travail » des « articles de recherche » — les
    recherches ne les mélangeront pas
  </Card>

  <Card title="Recherche précise" icon="bullseye" iconType="duotone">
    Limitez la portée de recherche à une bibliothèque spécifique dans le
    Launcher, MCP ou CLI
  </Card>
</CardGroup>

**Les bibliothèques sont une fonctionnalité avancée optionnelle.** Ne pas créer de bibliothèque n'affecte pas les fonctionnalités existantes — la recherche globale reste l'expérience par défaut. Les bibliothèques sont idéales pour les utilisateurs ayant de nombreux documents nécessitant une organisation par catégories.

### Cas d'utilisation

* **Chercheurs** : Classez les articles par sujet dans des bibliothèques comme `ml-papers`, `neuroscience`, etc.
* **Développeurs** : Séparez les docs de projet, les spécifications d'API et les comptes-rendus de réunion
* **Collaboration d'équipe** : Créez des bibliothèques dédiées par projet pour que les assistants IA ne recherchent que dans les documents pertinents via MCP
* **Gestion personnelle des connaissances** : Catégorisez notes, extraits de livres et documents de référence

## Créer une bibliothèque

<Steps>
  <Step title="Ouvrir la page des bibliothèques">
    Allez dans **Paramètres → Bibliothèques**. Vous verrez la page de liste des bibliothèques (vide lors de la première utilisation).
  </Step>

  <Step title="Créer une nouvelle bibliothèque">
    Cliquez sur le bouton **Nouvelle bibliothèque** en haut à droite. Dans la boîte de dialogue, remplissez :

    * **Nom** (obligatoire) : Un identifiant unique pour la bibliothèque. Seuls les lettres minuscules, chiffres et tirets sont autorisés (ex : `my-research`, `work-2024`)
    * **Description** (optionnel) : Une brève description de l'usage de la bibliothèque

    <Tip>
      Le nom utilise le format slug et sert également de paramètre de filtre lors de la recherche. Gardez-le court et mémorable.
    </Tip>
  </Step>

  <Step title="Ajouter des dossiers">
    Après la création, accédez à la page de détails de la bibliothèque et cliquez sur le bouton **Ajouter un dossier** pour sélectionner un dossier via le sélecteur de fichiers système.

    Une bibliothèque peut contenir plusieurs dossiers. Une fois ajouté, Linkly AI scannera et indexera automatiquement les documents qu'il contient.
  </Step>
</Steps>

### Gérer les bibliothèques

Sur la page de détails de la bibliothèque, vous pouvez :

* **Modifier** : Cliquez sur l'icône crayon pour modifier le nom ou la description
* **Supprimer un dossier** : Cliquez sur l'icône de suppression à côté d'un dossier pour le dissocier de la bibliothèque (les fichiers réels ne sont pas supprimés)
* **Supprimer une bibliothèque** : Cliquez sur l'icône de suppression et confirmez pour supprimer la bibliothèque entière. Les documents indexés ne sont pas affectés et restent trouvables via la recherche globale

## Recherche ciblée dans le Launcher

Le Launcher prend en charge la recherche ciblée par bibliothèque déclenchée par `@` :

<Steps>
  <Step title="Tapez @ pour entrer en mode sélection">
    Tapez `@` dans la barre de recherche du Launcher. La vue bascule vers une
    liste de bibliothèques candidates. Continuez à taper pour filtrer par nom.
  </Step>

  <Step title="Sélectionnez une bibliothèque">
    Cliquez ou appuyez sur Entrée pour sélectionner une bibliothèque. Un badge
    bleu apparaît à gauche de la barre de recherche (ex : `@my-research`),
    indiquant que la portée de recherche est limitée.
  </Step>

  <Step title="Entrez votre requête">
    Recherchez dans la portée restreinte. Les résultats proviennent uniquement
    des dossiers inclus dans cette bibliothèque.
  </Step>

  <Step title="Quitter la recherche ciblée">
    Appuyez sur la touche Retour arrière lorsque la barre de recherche est vide,
    ou cliquez sur le bouton retour à gauche pour revenir à la recherche
    globale.
  </Step>
</Steps>

## Utilisation avec les assistants IA

Les assistants IA connectés à Linkly AI (tels qu'OpenClaw, Claude, Cursor, etc.) peuvent rechercher dans des bibliothèques spécifiques. Indiquez simplement la portée de recherche en langage naturel :

<CardGroup cols={1}>
  <Card title="Recherche par bibliothèque" icon="magnifying-glass" iconType="duotone" horizontal>
    « Recherche dans ma bibliothèque ml-papers les documents sur les mécanismes
    d'attention »
  </Card>

  <Card title="Lister les bibliothèques" icon="list" iconType="duotone" horizontal>
    « Liste toutes mes bibliothèques »
  </Card>

  <Card title="Filtrage combiné" icon="filter" iconType="duotone" horizontal>
    « Recherche les fichiers PDF sur les transformers dans ma bibliothèque
    ml-papers »
  </Card>
</CardGroup>

L'assistant IA invoquera automatiquement les outils MCP ou CLI appropriés pour effectuer la recherche.

## Utilisation avec le CLI

### Lister les bibliothèques

```bash theme={null}
linkly list-libraries
```

### Recherche par bibliothèque

```bash theme={null}
linkly search "attention mechanism" --library ml-papers
```

Combiné avec le filtrage par chemin :

```bash theme={null}
linkly search "transformer" --library ml-papers --path-glob "*.pdf"
```

<Tip>
  Les bibliothèques prendront bientôt en charge le push vers le cloud pour un
  accès en ligne 24h/24.
</Tip>

## Questions fréquentes

<AccordionGroup>
  <Accordion title="L'ajout de dossiers à une bibliothèque déclenche-t-il une réindexation ?">
    Non. Si les documents d'un dossier ont déjà été indexés via la gestion des dossiers, la création d'une bibliothèque ne déclenchera pas d'indexation en double. Les bibliothèques ajoutent simplement une couche de regroupement logique par-dessus les index existants.
  </Accordion>

  <Accordion title="La mise à jour vers v0.3.0 déclenche-t-elle une réindexation ?">
    v0.3.0 inclut des modifications de la structure de l'index de mots-clés,
    celui-ci sera donc automatiquement reconstruit après la mise à jour. Ce
    processus ne concerne que les ajustements de structure d'index — il ne
    réanalyse pas le contenu des documents, ce qui le rend beaucoup plus rapide
    qu'une réindexation complète. Selon le nombre de documents, cela prend
    généralement de quelques minutes à quelques heures.
  </Accordion>

  <Accordion title="Quelle est la relation entre bibliothèques et dossiers ? Quand utiliser les bibliothèques ?">
    Les dossiers ajoutés à une bibliothèque apparaissent automatiquement dans la liste de gestion des dossiers — une bibliothèque est essentiellement un regroupement logique de dossiers et constitue une fonctionnalité optionnelle.

    **Ajouter des dossiers directement** convient à la plupart des utilisateurs : les dossiers sont globaux et prennent en charge la recherche locale ainsi que l'accès distant via le tunnel MCP.

    **Les bibliothèques** sont utiles lorsque vous avez besoin d'isoler la portée de recherche par thème, par exemple séparer les documents « professionnels » des documents « académiques ». De plus, les bibliothèques prendront en charge le push vers le cloud et l'intégration avec des outils externes spécifiques à l'avenir.

    Si vous n'avez pas de besoins spécifiques de catégorisation, vous pouvez parfaitement utiliser Linkly AI sans créer de bibliothèque.
  </Accordion>
</AccordionGroup>