Public Help
Caractéristiques

Livres d'histoire

Guide complet pour créer, importer, gérer et lier des livres d'histoire aux personnages IA sur Public.

Les Livres d'histoire (souvent appelés World Info) sont des recueils autonomes d'histoires, de faits de contexte, de détails sur les factions, de systèmes magiques et de connaissances de référence auxquels vous pouvez créer un lien. Personnages IA. Lorsque vous discutez avec un personnage, les entrées pertinentes du livre d'histoire lié sont récupérées dynamiquement et injectées directement dans l'invite du modèle.

Contrairement à la personnalité principale d'un personnage, un livre d'histoire est complètement modulaire: vous pouvez lier le même livre d'histoire à plusieurs personnages (par exemple, lier un livre d'histoire partagé Starfall Academy à Mira, Tobin, la professeure Vale et lord Ashgrave), ou échanger des livres d'histoire sans altérer la voix du personnage.

Concepts de base

Pour tirer le meilleur parti des livres d'histoire, il est utile de comprendre comment ils s'intègrent aux autres outils de jeu de rôle sur Public:

  • Personnalité du personnage — définit qui est le personnage: son style de parole, son histoire, ses bizarreries et ses directives comportementales.
  • Personnages de chat: définit qui vous êtes: votre nom, votre apparence et votre identité dans la conversation. Voir Personnages de discussion.
  • Lorebooks — définit le monde qui vous entoure: événements historiques, factions, lieux, sorts, règles technologiques et traditions relationnelles.

Livres d'histoire privés ou publics

VisibilitéQui peut le lier à un personnageQui peut le modifier ou le supprimer
PrivéSeulement toiSeulement toi (le créateur)
PublicTout créateur sur Public peut le lier lors de la création ou de la modification de ses personnagesSeulement toi (le créateur)

Seul le propriétaire peut modifier ou supprimer un livre d'histoire. Si vous supprimez un livre d'histoire, tous les personnages qui y sont liés perdent le lien en toute sécurité sans perdre leur historique de conversation ou leur personnalité.


Comment fonctionne l'injection de contexte

Lorsque vous envoyez un message dans une conversation entre personnages, le backend exécute un pipeline d'assemblage de contexte rapide avant de générer la réponse de l'IA:

1. Cibles de texte numérisées

Le moteur de contexte vérifie les entrées correspondantes dans l'ensemble du contexte de conversation actif:

  • Le dernier message entrant de l'utilisateur
  • Historique des conversations récentes
  • Résumé de la conversation continue
  • Mémoires de personnages épinglées et auto-extraites
  • La salutation originale du personnage

2. Types de correspondance d'entrée

Chaque entrée d'un livre d'histoire a l'un des deux comportements déclencheurs suivants:

  • ** Déclenché par un mot clé (constant: false)** — L'entrée définit une liste de mots-clés (par ex. ["emberwing", "house of the phoenix"]). Si un mot-clé apparaît n'importe où dans le texte de la conversation analysé (correspondance de sous-chaîne insensible à la casse), l'entrée se déclenche.
  • Constante (constant: true) — L'entrée est toujours incluse dans chaque échange de message, ignorant complètement les mots-clés. Idéal pour les scénarios de base globaux (par exemple, "L'année est 1204 et le Voile cache Starfall Academy du monde extérieur").

3. Gestion des priorités et du budget

Les modèles ont des fenêtres contextuelles d'invite limitées. Pour que les réponses restent rapides, cohérentes et rentables, Public applique un budget d'injection:

  • Limite du budget de caractères: Jusqu'à 1 800 caractères (LOREBOOK_INJECT_MAX_CHARS) du contenu du livre d'histoire peut être injecté par message.
  • Ordre de priorité: Toutes les entrées correspondantes (à la fois constantes et déclenchées par un mot-clé) sont triées par Priorité dans l'ordre décroissant (100 avant 50, avant 0).
  • Ajustement du budget: Les entrées sont ajoutées une par une en commençant par la priorité la plus élevée jusqu'à ce que le budget de 1 800 caractères soit atteint. Si une entrée dépasse le budget restant, elle est omise (ou ajustée s'il s'agit de la première entrée).

4. Format du bloc d'injection

Les entrées déclenchées sont formatées dans un bloc propre et transmises à l'invite système du personnage:

Relevant world info:
- Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth.
- Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black.
- Dueling spells: Flare blinds an opponent; Binding Thread slows them; Mirror Ward reflects minor curses.

Spécifications et limites des champs

Métadonnées du livre d'histoire

ChampTapezObligatoireLimites et description
nameChaîneObligatoire120 caractères maximum. Nom du monde ou du décor.
descriptionChaîneFacultatif500 caractères maximum. Bref résumé du réglage.
visibilityChaîneFacultatif"private" (par défaut) ou "public". Les livres de connaissances Public apparaissent dans la recherche et la découverte.
tagsTableauFacultatifJusqu'à 20 balises. Les balises sont tronquées et en minuscules.
entriesTableauFacultatifJusqu'à 100 entrées par livre d'histoire.

Entry metadata

ChampTapezObligatoireLimites et description
contentChaîneObligatoire1 000 caractères maximum. Le texte d'information mondial réel injecté dans le modèle.
constantBooleanFacultatifPar défaut false. Si true, cette entrée est toujours active dans chaque échange de messages.
keysTableauObligatoire si non constantJusqu'à 20 clés, maximum 64 caractères chacune. Déclenchez des mots ou des phrases. Ignoré si constant: true.
enabledBooléenFacultatifPar défaut true. Désactivez-la pour désactiver temporairement une entrée sans la supprimer.
priorityNuméroFacultatifPar défaut 0. Des nombres plus élevés sont injectés en premier lorsque l'espace contextuel est contraint (par ex. 100, 85, 50).

Formats JSON pris en charge

Vous pouvez importer, coller et exporter des livres d'histoire en utilisant trois formats standardisés:

1. Schéma du livre de connaissances natif Public (recommandé)

Il s'agit du schéma JSON natif de Public. Il prend en charge directement tous les champs:

{
  "name": "Starfall Academy",
  "description": "Comprehensive lorebook covering Starfall Academy's houses, spells, lore, and magical laws.",
  "visibility": "public",
  "tags": [
    "fantasy",
    "starfall",
    "academy",
    "magic",
    "spells"
  ],
  "entries": [
    {
      "keys": [],
      "content": "Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth. Magic is channeled through focus crystals.",
      "enabled": true,
      "constant": true,
      "priority": 100
    },
    {
      "keys": [
        "emberwing",
        "aria emberwing",
        "house of the phoenix"
      ],
      "content": "Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black. Its common room is at the top of the Ember Tower.",
      "enabled": true,
      "constant": false,
      "priority": 85
    },
    {
      "keys": [
        "focus crystal",
        "crystal lore",
        "crystal vault"
      ],
      "content": "Every student bonds with one focus crystal. Crystals are grown from rare minerals and hold a single element such as flame, tide, or storm. A bond breaks only by choice.",
      "enabled": true,
      "constant": false,
      "priority": 80
    },
    {
      "keys": [
        "flare",
        "binding thread",
        "mirror ward"
      ],
      "content": "Dueling spells: Flare (blinds an opponent), Binding Thread (slows them), and Mirror Ward (creates a shield that reflects minor curses).",
      "enabled": true,
      "constant": false,
      "priority": 75
    }
  ]
}

2. Exportation de SillyTavern World Info

L'importateur détecte automatiquement les exportations autonomes de SillyTavern où entries est saisi comme un dictionnaire d'objets:

{
  "name": "Starfall World Info",
  "description": "SillyTavern export",
  "entries": {
    "0": {
      "uid": 0,
      "key": ["the veil", "magic"],
      "content": "The Veil hides Starfall Academy from the outside world.",
      "constant": true,
      "disable": false,
      "order": 100
    },
    "1": {
      "uid": 1,
      "key": ["starfall academy", "castle"],
      "content": "Starfall Academy stands on a floating island above the Silver Sea.",
      "constant": false,
      "disable": false,
      "order": 50
    }
  }
}

3. Carte de personnage SillyTavern (character_book)

Vous pouvez également importer des cartes de personnage (cartes de spécifications V2 ou V3) qui regroupent un character_book objet:

{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "Mira Vale",
    "tags": ["fantasy", "magic"],
    "character_book": {
      "name": "Starfall Library Lore",
      "description": "Magical theory and reference entries",
      "entries": [
        {
          "keys": ["silverkey", "unlocking charm"],
          "content": "The Silverkey charm unlocks standard doors and windows.",
          "enabled": true,
          "constant": false,
          "insertion_order": 10
        }
      ]
    }
  }
}

Créer et gérer des livres d'histoire

Sur le Web

Accédez à /lorebooks dans votre navigateur ou sélectionnez Lorebooks dans le menu de la barre latérale.

Créer à partir de zéro

  1. Allez à /lorebooks/create.
  2. Donnez à votre livre d'histoire un Nom descriptif et une Description/Tags facultatifs.
  3. Choisissez la visibilité Privé ou Public.
  4. Cliquez sur Ajouter une entrée pour créer des règles. Spécifiez des mots-clés déclencheurs ou cochez Toujours actif (constant).
  5. Cliquez sur Créer un livre d'histoire pour enregistrer.

Importation de livres d'histoire existants

Vous disposez de deux méthodes rapides pour charger les informations mondiales existantes:

  1. Importer un fichier — Cliquez sur Importer un fichier dans la barre d'action supérieure pour télécharger n'importe quel fichier. .json un livre de connaissances ou un fichier de carte de personnage depuis votre ordinateur.
  2. Coller JSON — Cliquez sur Coller JSON pour ouvrir la boîte de dialogue d'analyse:
  • Cliquez sur Coller depuis le presse-papiers pour extraire le texte JSON copié à partir d'une autre application.
  • Cliquez sur Charger l'exemple pour inspecter un modèle Starfall Academy pré-rempli.
  • Cliquez sur Analyser et importer pour remplir le formulaire instantanément.

Exportation et copie

  • Sur n'importe quel écran de création, de modification ou de détail d'un livre d'histoire, cliquez sur Copier JSON.
  • L'intégralité du livre de connaissances est sérialisée en JSON Public standardisé et copiée directement dans votre presse-papiers.

Lien vers un personnage IA

Une fois votre livre de connaissances créé:

  1. Ouvrir /characters/add (ou cliquez sur Modifier sur n'importe quel personnage que vous avez créé).
  2. Faites défiler jusqu'au sélecteur Lorebook (facultatif).
  3. Sélectionnez votre livre d'histoire ou choisissez parmi les livres d'histoire publics populaires créés par la communauté.
  4. Enregistrez votre personnage. Toutes les discussions ultérieures avec ce personnage seront automatiquement tirées du livre d'histoire.

Limites du forfait et déverrouillage

PlanifierLivres d'histoire que vous pouvez créerEntrées par livre d'histoire
Gratuit3Jusqu'à 100
Basique10Jusqu'à 100
Créateur / ProIllimitéJusqu'à 100

La création de livres d'histoire nécessite le déverrouillage des livres d'histoire des personnages (dans le même niveau de progression que les personnages de chat personnalisés). Voir Abonnements et Gamification.


Bonnes pratiques pour les créateurs

  • Utilisez des mots-clés descriptifs et spécifiques: Utilisez des noms et des expressions composées comme ["aria emberwing", "house of the phoenix"] plutôt que des mots courts et courants comme ["the", "is", "he"].
  • Réservez les entrées constantes pour les règles universelles: Conservez constant: true entrées limitées à 1 à 2 règles de base (par exemple, chronologie actuelle, physique du monde principal) afin qu'elles ne consomment pas la totalité du budget de 1 800 caractères.
  • Gardez le contenu de l'entrée concis: Les entrées à fort impact de 1 à 3 phrases claires permettent à plusieurs entrées pertinentes de s'insérer simultanément dans la fenêtre contextuelle.
  • Utiliser les scores de priorité: Donnez des scores de priorité plus élevés aux connaissances fondamentales (100–80) et des faits décoratifs mineurs des scores inférieurs (40–10), le contexte le plus critique est donc assuré d'être injecté en premier.

Questions fréquemment posées

Pourquoi mon entrée dans le livre d'histoire ne s'est-elle pas déclenchée dans le chat?

Vérifiez les éléments suivants:

  1. L'entrée est-elle activée Enabled?
  2. L'un des mots-clés exacts est-il apparu dans la discussion récente ou dans la dernière invite utilisateur? (Les correspondances sont des correspondances de sous-chaînes insensibles à la casse).
  3. Les entrées de priorité plus élevée ont-elles rempli en premier le budget de 1 800 caractères? Essayez d'augmenter le score Priorité de l'entrée.

Puis-je associer plusieurs livres d'histoire à un seul personnage?

Actuellement, chaque personnage peut être lié à un livre d'histoire à la fois. Si vous avez besoin du contenu de plusieurs livres d'histoire, combinez leurs entrées en un seul livre d'histoire à l'aide de Coller JSON ou des outils d'exportation.

Que se passe-t-il si je supprime un livre d'histoire?

Les personnages qui avaient lié ce livre d'histoire verront simplement leur référence au livre d'histoire effacée. Leurs conversations, paramètres et souvenirs restent totalement intacts.

Puis-je modifier un livre d'histoire public créé par quelqu'un d'autre?

Non. Seul le créateur original peut modifier un livre d'histoire. Si vous souhaitez personnaliser un livre d'histoire public, affichez le livre d'histoire, cliquez sur Copier JSON, créez un nouveau livre d'histoire et collez le JSON dans votre propre copie privée.

La gestion mobile des livres d'histoire est-elle disponible?

La création et l'édition complètes de livres d'histoire sont actuellement disponibles sur l'application Web. Tous les livres d'histoire liés aux personnages sur le Web fonctionneront automatiquement dans le chat sur toutes les plateformes, y compris Android et iOS.


Documentation associée

Sur cette page