Aide : Démarrage · Histoires · Personnages · Livres de lore · Multijoueur · Découvrir · Avancé · Templates · FAQ
Cette section couvre les fonctionnalités avancées de Dream Scrolls : presets de génération et leurs templates de prompts, évaluation Humeur/État, résumé automatique, et la configuration des modèles IA (réservée aux administrateurs).
Un preset est un bundle réutilisable combinant les cinq templates de prompts (Système, Narrateur, Humeur, État, Résumé) et des paramètres de génération. Les presets permettent de sauvegarder une configuration précise et de la réappliquer à n'importe quelle histoire en un clic.
Lors de la création ou de la modification d'une histoire, sélectionnez un de vos presets dans le sélecteur Template du formulaire — tous les champs de prompts et paramètres sont pré-remplis automatiquement. (Le formulaire l'appelle « Template », mais il liste vos propres presets — voir Histoires.)
Les presets peuvent être exportés et importés au format JSON depuis Config → Presets — utile pour les partager hors plateforme ou en faire des sauvegardes locales.
Il n'y a pas d'« ordre d'assemblage » fixe fait de slots séparés — chacun des cinq champs de prompt ci-dessous est un template Mustache complet et indépendant que vous rédigez intégralement, et un seul d'entre eux est rendu par appel de génération selon le contexte. Il n'existe pas de champs séparés Pré/Post-Description, Pré/Post-Lore ou Pré/Post-Historique : les descriptions de personnages, les entrées de lore et l'historique des messages ne sont pas injectés à des positions fixes automatiquement — c'est vous qui les placez, où vous voulez dans le template, à l'aide de variables comme {{#presentChars}}, {{#hasLore}} et {{#messages}} (voir Templates pour la référence complète des variables et un exemple détaillé).
| Template | Utilisé pour |
|---|---|
| Prompt système | Le prompt par défaut pour le tour d'un personnage — celui auquel vous consacrerez le plus de temps. |
| Prompt du narrateur | Remplace le Prompt système lors d'une génération Narrer (voir Histoires), pour donner à la narration sans personnage son propre ton, ses propres règles et sa propre mise en forme. |
| Prompt système d'humeur | Remplace le Prompt système lorsque l'IA réévalue l'Humeur d'un personnage, juste avant son tour, lorsque l'évaluation Humeur/État est activée (voir plus bas). |
| Prompt système d'état | Identique, pour l'État du personnage. |
| Prompt système de résumé | Remplace le Prompt système lors de la génération d'un résumé des anciens messages (voir Résumé automatique plus bas). |
Les templates Humeur et État doivent demander au modèle de produire une courte description, en référençant la valeur actuelle du personnage (via {{char.mood}}/{{char.state}}) afin qu'elle soit mise à jour de façon incrémentale plutôt que redérivée de zéro à chaque fois.
Ces paramètres sont accessibles dans l'accordéon Génération du formulaire d'histoire et dans le panneau de config → onglet Histoire pendant le jeu.
| Paramètre | Plage | Description |
|---|---|---|
| Longueur de contexte | En tokens | Taille totale de la fenêtre de contexte envoyée au modèle |
| Contexte de lore | En tokens | Budget réservé aux entrées de livres de lore injectées |
| Activer l'évaluation Humeur/État | Booléen | Active la mise à jour automatique de l'humeur et de l'état des personnages par l'IA (voir plus bas). Désactivé par défaut, car cela ajoute un appel LLM supplémentaire avant chaque tour de personnage |
| Longueur de contexte Humeur/État | En tokens | Budget de contexte pour les appels d'évaluation Humeur/État, indépendant de la Longueur de contexte principale. Visible uniquement si l'évaluation est activée |
| Max tokens Humeur/État | En tokens | Nombre maximum de tokens générés par appel d'évaluation Humeur/État — ces réponses tiennent normalement en une ou deux phrases. Visible uniquement si l'évaluation est activée |
| Max nouveaux tokens | En tokens | Longueur maximale de la réponse générée par le modèle |
| Température | 0–2+ | Aléatoire ; valeurs basses = cohérent, valeurs hautes = créatif mais imprévisible |
| Top P | 0–1 | Échantillonnage nucleus ; 1 = désactivé |
| Pénalité de présence | -2 à 2 | Pénalise les tokens déjà apparus dans le contexte pour réduire la répétition |
| Pénalité de fréquence | -2 à 2 | Pénalise les tokens proportionnellement à leur fréquence d'apparition |
| Graine | Entier | Valeur fixe pour une génération reproductible ; 0 = aléatoire |
| Budget de réflexion | En tokens | Tokens alloués au raisonnement interne ("thinking") si le modèle le supporte |
| Avec noms | Booléen | Inclut les noms des personnages dans l'historique pour aider le modèle à distinguer les voix |
Le résumé automatique compresse l'historique ancien en un court résumé injecté à la place des messages bruts, libérant du budget de contexte pour les nouveaux échanges. Indispensable pour les longues histoires.
Dans le formulaire d'histoire, ouvrez l'accordéon Résumé et activez le résumé automatique.
| Paramètre | Description |
|---|---|
| Intervalle de résumé | Nombre de messages à regrouper en un résumé ; des valeurs basses résument plus fréquemment |
| Longueur de contexte du résumé | Nombre maximum de tokens que le modèle peut utiliser pour écrire un résumé |
| Taille de l'historique de résumé | Nombre de résumés passés inclus lors de l'écriture d'un nouveau (assure la continuité narrative) |
| Tokens de messages récents | Nombre de tokens réservés aux derniers messages non résumés, toujours présents tels quels dans le contexte |
| Modèle d'embeddings pour les résumés | Si renseigné, les résumés sont vectorisés et récupérables par recherche sémantique comme les entrées de lore |
Le résumé s'exécute en tâche de fond après réception des messages. Il n'interrompt pas la session — vous pouvez continuer à jouer pendant qu'il tourne. Vous pouvez suivre sa progression dans l'interface.
Chaque personnage possède un champ Humeur et un champ État (voir Personnages) que l'IA peut maintenir à jour automatiquement, donnant au modèle une continuité émotionnelle et situationnelle à court terme sans que vous ayez à tout réécrire dans la description du personnage.
Activez Activer l'évaluation Humeur/État dans l'accordéon Contexte d'une histoire (ou d'un preset). C'est désactivé par défaut : évaluer l'humeur et l'état ajoute un appel LLM supplémentaire juste avant chaque tour de personnage, ce qui ajoute de la latence à la conversation.
| Paramètre | Emplacement | Description |
|---|---|---|
| Modèle Humeur/État | Section Modèle de l'histoire/preset | Le modèle utilisé pour les appels d'évaluation. Utilise le modèle de complétion de l'histoire si non renseigné |
| Longueur de contexte Humeur/État | Accordéon Contexte | Budget de tokens pour le prompt d'évaluation, indépendant de la Longueur de contexte principale — volontairement réduit car ce sont des appels fréquents et peu coûteux |
| Max tokens Humeur/État | Accordéon Contexte | Nombre maximum de tokens générés par évaluation. Les réponses tiennent en une ou deux phrases |
Les modèles IA sont les configurations de fournisseurs utilisés pour la génération de texte et les embeddings. Seuls les administrateurs peuvent en créer ou en modifier.
Allez dans Config → Modèles IA.
| Champ | Description |
|---|---|
| Type | Le fournisseur : OpenAI, Ollama, Mistral, DeepSeek, Open Router, VLLM, Llama.cpp |
| URL API | L'URL de base de l'endpoint API du fournisseur |
| Nom du modèle | L'identifiant exact du modèle transmis au fournisseur lors de chaque requête |
| Clé API | Identifiants d'authentification pour le fournisseur (stockés de façon sécurisée, jamais affichés après la sauvegarde) |
| Capable de complétion | Activer si ce modèle peut générer du texte narratif |
| Capable d'embeddings | Activer si ce modèle peut générer des vecteurs d'embeddings (pour la recherche vectorielle des livres de lore) |
| Capable de génération d'images | Activer si ce modèle génère des images plutôt que du texte. Les modèles image sont utilisés exclusivement pour la génération d'illustrations dans les histoires et n'apparaissent pas dans le sélecteur de modèle de texte |
| Taille de contexte maximale | Limite dure optionnelle sur la fenêtre de contexte. Quand renseignée, Dream Scrolls n'enverra jamais plus de tokens que cette valeur, quelle que soit la configuration de l'histoire |
Les modèles ComfyUI disposent de champs de configuration supplémentaires — un JSON de workflow ComfyUI et le nom du nœud de prompt textuel — pour cibler n'importe quel pipeline ComfyUI sans modifier la configuration serveur.
Chaque champ de prompt décrit plus haut (Système, Narrateur, Humeur, État et Résumé) est rédigé en Mustache, le même langage de templating utilisé pour les descriptions de personnages et les entrées de lore. Pour la référence complète — variables disponibles, syntaxe Mustache et balises de rôle — consultez la page Templates.