Livres de lore

Un livre de lore est une collection d'entrées de connaissances — faits d'univers, détails de personnages, extraits de world-building — injectées sélectivement dans les prompts selon leur pertinence. Cela permet de maintenir de grandes quantités de lore sans saturer la fenêtre de contexte à chaque génération.

Types de livres de lore

Type	Objectif	Attachement
Livre du monde	Lore mondial global, partagé entre plusieurs histoires	Attaché à une ou plusieurs histoires via l'onglet Lore
Livre d'histoire	Lore spécifique à une histoire particulière	Attaché à une histoire
Livre de personnage	Lore centré sur un personnage spécifique (biographie, relations, secrets)	Attaché directement à un personnage

Un même livre de lore peut être attaché à plusieurs histoires simultanément. Les livres de personnage sont attachés à un personnage et automatiquement inclus lorsque ce personnage participe à une histoire.

Créer un livre de lore

Allez dans Livres de lore → Créer un livre de lore. Renseignez le nom, le type, et optionnellement le modèle d'embeddings pour la recherche vectorielle.

Créer des entrées

Dans un livre de lore, cliquez sur Ajouter une entrée. Chaque entrée contient :

Champ	Description
Étiquette	Un nom interne pour identifier l'entrée — non injecté dans le prompt
Contenu	Le texte réel injecté dans le prompt quand l'entrée est déclenchée
Tags	Mots-clés qui déclenchent l'entrée lorsqu'ils apparaissent dans le contexte récent (correspondance exacte, insensible à la casse)
Poids	Priorité de l'entrée (0–5) quand le budget de contexte lore est limité ; les entrées à poids élevé sont conservées en premier
Permanent	Si coché, l'entrée est toujours injectée dans chaque prompt, quels que soient les tags et le contexte

Comment fonctionne la récupération à la génération

Avant chaque génération, Dream Scrolls parcourt l'historique récent des messages pour identifier les entrées pertinentes à injecter :

Scan par tags — les tags de chaque entrée sont recherchés dans les messages récents. Si un tag correspond (correspondance exacte, insensible à la casse), l'entrée est marquée comme candidate.
Recherche vectorielle (si activée) — en plus du scan par tags, les entrées sont classées par similarité sémantique avec le contexte récent.
Application du budget — les entrées candidates sont injectées dans le prompt jusqu'à épuisement du budget de contexte lore défini dans les paramètres de l'histoire.
Priorité par poids — si le budget est insuffisant pour toutes les entrées candidates, celles à poids le plus élevé sont conservées en priorité.
Entrées permanentes — toujours injectées, quel que soit l'état du budget et des tags.

Astuce : si une entrée de lore importante ne se déclenche jamais, essayez de la passer en Permanent temporairement pour vérifier que son contenu est bien injecté, puis affinez ses tags.

Recherche vectorielle

La recherche vectorielle complète le scan par tags avec une récupération par similarité sémantique. Utile pour du lore dont la pertinence repose sur le sens plutôt que sur des mots-clés exacts.

Configurer la recherche vectorielle

Dans la fiche du livre de lore, sélectionnez un modèle d'embeddings dans le champ dédié.
Cliquez sur Re-vectoriser le livre de lore pour générer les embeddings de toutes les entrées existantes.
Chaque nouvelle entrée ajoutée par la suite sera vectorisée automatiquement.

Paramètre Seuil de vectorisation

Le seuil de vectorisation (0–1) contrôle le score de similarité minimum pour qu'une entrée soit incluse via la recherche vectorielle :

Valeur haute (ex. 0,85) — seules les entrées très proches sémantiquement sont incluses ; moins de bruit.
Valeur basse (ex. 0,50) — davantage d'entrées sont incluses, même celles vaguement liées ; risque de contenu hors-sujet.

N'oubliez pas de cliquer Re-vectoriser après avoir ajouté ou modifié des entrées, sinon les nouvelles entrées ne seront pas disponibles pour la recherche sémantique.

Si la recherche vectorielle est activée, le modèle d'embeddings choisi est conservé comme indice portable lors de l'export/import ou du clonage depuis Découvrir, et réassocié par nom à l'import ; si aucun modèle du même nom n'existe sur l'installation cible, le livre de lore retombe sur le modèle d'embeddings par défaut de cette installation.

Attacher des livres de lore aux histoires

Un livre de lore doit être attaché à une histoire pour être actif lors de la génération.

Depuis l'écran de jeu : ouvrez le panneau de config → onglet Lore → cliquez sur Attacher un livre de lore et sélectionnez-le dans la liste.
Depuis la page de l'histoire (hors jeu) : section Livres de lore → ajouter.

Les livres de personnage n'ont pas besoin d'être attachés manuellement aux histoires — ils sont automatiquement inclus dès que le personnage associé est présent dans l'histoire.

Conseils d'utilisation

Tags précis — des tags trop génériques (ex. "personnage") déclencheront des entrées en permanence et consommeront inutilement le budget. Préférez des tags spécifiques (ex. "château de Varendor", "Aria").
Budget de lore — si des entrées importantes ne s'injectent pas, augmentez le contexte de lore dans les paramètres de l'histoire (accordéon Contexte).
Poids pour les priorités — attribuez un poids de 4 ou 5 aux entrées cruciales (règles du monde, informations clés) et un poids de 1 ou 2 aux détails secondaires.
Permanent avec modération — trop d'entrées permanentes saturent rapidement le contexte. Réservez ce flag aux informations toujours pertinentes (ex. les règles fondamentales de l'univers).