FAQ et dépannage

Réponses aux problèmes les plus courants rencontrés sur Dream Scrolls.

1. L'IA ne génère rien

Symptôme : après avoir envoyé un message ou cliqué sur Continuer, rien ne se passe.

Causes possibles et solutions :

Modèle non configuré ou inaccessible — vérifiez dans Config → Modèles IA que le modèle sélectionné pour l'histoire est correctement configuré. Contactez votre administrateur si vous n'avez pas accès à cette section.
Clé API manquante ou invalide — vérifiez que la clé API du modèle est renseignée et valide (les clés expirées ou incorrectes provoquent des erreurs silencieuses).
Aucun personnage IA disponible — l'histoire doit avoir au moins un personnage qui soit (1) présent, (2) non muet, et (3) non incarné par un utilisateur. Un personnage incarné ne sera jamais généré par l'IA.
Tous les personnages sont muets — vérifiez l'onglet Personnages du panneau de config et désactivez le toggle Muet sur les personnages concernés.

2. Les entrées de lore ne se déclenchent pas

Symptôme : des entrées de lore que vous avez créées n'apparaissent jamais dans les réponses de l'IA.

Causes possibles et solutions :

Tags non présents dans le contexte récent — la correspondance par tags est exacte et insensible à la casse. Si le tag est "Varendor" mais que les messages récents écrivent "varendor" ou "château de Varendor", essayez d'adapter les tags. La recherche porte sur les messages récents uniquement, pas sur tout l'historique.
Budget de lore insuffisant — si votre budget de contexte lore est trop bas, les entrées sont écartées faute de place. Augmentez la Longueur du contexte de lore dans l'accordéon Contexte des paramètres de l'histoire.
Poids trop faible — en cas de concurrence entre entrées, celles à poids faible sont exclues en premier. Augmentez le poids des entrées importantes.
Test rapide — passez temporairement l'entrée en Permanent pour vérifier que son contenu est bien injecté et que le problème vient bien du déclenchement par tags.

3. L'IA écrit toujours le même personnage

Symptôme : un seul personnage IA prend la parole, les autres restent silencieux.

Causes possibles et solutions :

Chativity déséquilibrée — si un personnage a une Chativity de 1 et les autres de 0,1, le premier dominera. Équilibrez les valeurs entre les personnages.
Personnage muté accidentellement — vérifiez dans l'onglet Personnages que les autres personnages ne sont pas muets (toggle Muet désactivé).
Personnage absent — vérifiez que les personnages silencieux ont bien le toggle Présence activé dans le panneau de config.
Instructions finales dans le Prompt système — si votre template de Prompt système demande explicitement à l'IA de continuer en tant qu'un personnage précis (ex. près des instructions de clôture, après le bloc d'historique des messages), elle suivra toujours cette instruction. Vérifiez la fin de votre Prompt système dans les paramètres du preset ou de l'histoire.

4. La génération est très lente

Symptôme : les réponses de l'IA prennent beaucoup de temps.

Causes possibles et solutions :

Modèle lourd ou fournisseur lent — la vitesse dépend entièrement du modèle et de son fournisseur. Les modèles locaux (Ollama, Llama.cpp) dépendent des performances matérielles de la machine hôte.
Contexte trop grand — un contexte très long (historique + lore + prompts) ralentit la génération. Réduisez la Longueur de contexte ou activez le résumé automatique.
Max nouveaux tokens trop élevé — réduisez la valeur de Max nouveaux tokens si des réponses très longues ne sont pas nécessaires.
Essayez un modèle plus petit — depuis le panneau de config → onglet Modèle, changez temporairement pour un modèle plus léger.

5. Le contexte se remplit trop vite

Symptôme : les messages anciens disparaissent du contexte, l'IA oublie des événements importants.

Causes possibles et solutions :

Activer le résumé automatique — voir Avancé → Résumé automatique. Le résumé compresse l'historique ancien pour libérer de l'espace.
Réduire les entrées permanentes — chaque entrée permanente consomme des tokens à chaque génération. Limitez-les aux informations vraiment essentielles.
Raccourcir les descriptions de personnages — des descriptions très longues consomment du contexte à chaque tour. Déplacez les informations secondaires vers un livre de lore avec des tags appropriés.
Augmenter la Longueur de contexte — si votre modèle supporte une fenêtre plus grande, augmentez la Longueur de contexte dans les paramètres de l'histoire.

6. L'import échoue avec une erreur 413

Symptôme : lors de l'import d'un fichier .scenario.zip ou d'une CharacterCard PNG, un message d'erreur 413 (Payload Too Large) apparaît.

Solution : le fichier dépasse la limite de taille autorisée par le serveur. Demandez à votre administrateur d'augmenter la variable HTTP_BODY_LIMIT dans la configuration du backend. Cette limite s'applique à toutes les requêtes entrantes, pas seulement aux imports.

7. Les personnages n'apparaissent pas dans mon histoire

Symptôme : des personnages que vous avez créés ne sont pas visibles dans l'onglet Personnages du panneau de config.

Causes possibles et solutions :

Personnage non attaché à l'histoire — allez dans la page de configuration de l'histoire (hors jeu) et ajoutez le personnage dans la section Personnages.
Toggle Présence désactivé — même s'il est attaché, un personnage avec Présence désactivée n'apparaît pas dans la scène active. Activez le toggle dans l'onglet Personnages du panneau de config.

8. Je ne peux pas envoyer de messages

Symptôme : la zone de saisie est visible mais les messages ne s'envoient pas ou le bouton est grisé.

Cause et solution : vous devez incarner un personnage pour envoyer des messages en son nom. Ouvrez le panneau de config → onglet Personnages → cliquez sur Voix sur le personnage que vous souhaitez jouer. Une fois incarné, la zone de saisie devient active.

9. La recherche vectorielle ne fonctionne pas

Symptôme : les entrées de lore ne semblent pas être récupérées par similarité sémantique, même pour des contenus thématiquement proches.

Causes possibles et solutions :

Aucun modèle d'embeddings assigné — vérifiez que le livre de lore a un modèle d'embeddings sélectionné dans ses paramètres.
Embeddings non générés — cliquez sur Re-vectoriser le livre de lore après avoir assigné le modèle. Les entrées existantes ne sont pas vectorisées automatiquement lors de l'assignation.
Nouvelles entrées non vectorisées — si vous avez ajouté ou modifié des entrées après la dernière vectorisation, cliquez à nouveau sur Re-vectoriser.
Seuil trop élevé — abaissez le Seuil de vectorisation pour inclure des correspondances sémantiques moins strictes.

10. J'ai perdu mon histoire après avoir joué en anonyme

Symptôme : vous avez joué une session sans compte et, en revenant, l'histoire a disparu.

Explication : les sessions anonymes (invités) ne sont pas sauvegardées entre les visites. Aucune donnée n'est persistée côté serveur pour les utilisateurs non connectés.

Solution : créez un compte Utilisateur avant de commencer une histoire importante. Une fois connecté, toutes vos histoires, personnages et livres de lore sont sauvegardés de façon permanente et accessibles depuis n'importe quel appareil.