Public Help
Functies

Loreboeken

Uitgebreide gids voor het maken, importeren, beheren en koppelen van Lorebooks aan AI-personages op Public.

Lorebooks (vaak World Info genoemd) zijn op zichzelf staande verzamelingen van kennis, feiten, factiedetails, magische systemen en referentiekennis waarnaar u kunt linken AI-tekens. Wanneer je met een personage chat, worden relevante gegevens uit het gekoppelde lorebook dynamisch opgehaald en rechtstreeks in de prompt van het model geïnjecteerd.

In tegenstelling tot de kernpersoonlijkheid van een personage, is een overleveringsboek volledig modulair: je kunt hetzelfde overleveringsboek aan meerdere personages koppelen (bijvoorbeeld door een gedeeld Starfall Academy-overleveringsboek te koppelen aan Mira, Tobin, Professor Vale en Lord Ashgrave), of overleveringen uitwisselen zonder de stem van het personage te veranderen.

Kernconcepten

Om het meeste uit lorebooks te halen, helpt het om te begrijpen hoe ze passen naast de andere rollenspeltools op Public:

  • Karakterpersoonlijkheid — definieert wie het personage is: hun spreekstijl, achtergrondverhaal, eigenaardigheden en gedragsrichtlijnen.
  • Chatpersona's — definieert wie u bent: uw naam, uiterlijk en identiteit in het gesprek. Zie Chatpersona's.
  • Lorebooks — definieert de wereld om je heen: historische gebeurtenissen, facties, locaties, spreuken, technologieregels en relatieverhalen.

Privé versus openbare leerboeken

ZichtbaarheidWie kan het aan een personage koppelen?Wie kan het bewerken of verwijderen
PrivéAlleen jijAlleen jij (de maker)
PublicElke maker op Public kan deze koppelen bij het maken of bewerken van zijn personagesAlleen jij (de maker)

Alleen de eigenaar kan een lorebook bewerken of verwijderen. Als je een overleveringsboek verwijdert, verliezen alle daaraan gekoppelde personages veilig de link zonder hun gespreksgeschiedenis of persoonlijkheid te verliezen.


Hoe contextinjectie werkt

Wanneer u een bericht verzendt in een karakterchat, voert de backend een snelle pijplijn voor contextassemblage uit voordat het antwoord van de AI wordt gegenereerd:

1. Gescande tekstdoelen

De contextengine controleert op overeenkomende vermeldingen in de gehele actieve gesprekscontext:

  • Het laatste binnenkomende bericht van de gebruiker
  • Recente chatgeschiedenis van gesprekken
  • Rollende gesprekssamenvatting
  • Vastgezette en automatisch geëxtraheerde karakterherinneringen
  • De originele begroeting van het personage

2. Soorten invoermatching

Elke vermelding in een overleveringsboek heeft een van de volgende twee triggergedragingen:

  • Door trefwoorden geactiveerd (constant: false) — De invoer definieert een lijst met trefwoorden (bijv. ["emberwing", "house of the phoenix"]). Als er ergens in de gescande gesprekstekst een trefwoord voorkomt (hoofdlettergevoelige subtekenreeksmatch), wordt de invoer geactiveerd.
  • Constante (constant: true) — De vermelding wordt altijd opgenomen in elke berichtuitwisseling, waarbij trefwoorden volledig worden genegeerd. Ideaal voor basisscenario's voor mondiale scenario's (bijvoorbeeld "Het jaar is 1204 en de Sluier verbergt Starfall Academy voor de buitenwereld").

3. Prioriteits- en budgetbeheer

Modellen hebben eindige promptcontextvensters. Om de reacties snel, coherent en kosteneffectief te houden, dwingt Public een injectiebudget af:

  • Karakterbudgetlimiet: Maximaal 1.800 tekens (LOREBOOK_INJECT_MAX_CHARS) aan Lorebook-inhoud kan per bericht worden geïnjecteerd.
  • Prioriteitsvolgorde: Alle overeenkomende vermeldingen (zowel constant als op basis van trefwoorden) worden gesorteerd op Prioriteit in aflopende volgorde (100 voor 50, vóór 0).
  • Budgetaanpassing: Inzendingen worden één voor één toegevoegd, beginnend bij de hoogste prioriteit, totdat het budget van 1.800 tekens is bereikt. Als een boeking het resterende budget overschrijdt, wordt deze weggelaten (of aangepast als het de eerste boeking betreft).

4. Injectieblokformaat

Geactiveerde vermeldingen worden geformatteerd in een schoon blok en doorgegeven aan de systeemprompt van het personage:

Relevant world info:
- Universele setting: Magie wordt alleen op Starfall Academy onderwezen, en de buitenwereld gelooft dat het een mythe is.
- Emberwing House waardeert moed en loyaliteit. Opgericht door Aria Emberwing; de kleuren zijn koper en zwart.
- Duelspreuken: Flare verblindt een tegenstander; Binding Thread vertraagt hen; Mirror Ward kaatst kleine vloeken terug.

Veldspecificaties en limieten

Lorebook-metagegevens

VeldTypVereistLimieten en beschrijving
nameSnaarVereistMaximaal 120 tekens. Naam van de wereld of setting.
descriptionSnaarOptioneelMaximaal 500 tekens. Korte samenvatting van de instelling.
visibilitySnaarOptioneel"private" (standaard) of "public". Public Lorebooks verschijnen in zoeken en ontdekken.
tagsArrayOptioneelMaximaal 20 tags. Tags zijn bijgesneden en in kleine letters weergegeven.
entriesArrayOptioneelMaximaal 100 vermeldingen per lorebook.

Metagegevens invoeren

VeldTypVereistLimieten en beschrijving
contentSnaarVereistMaximaal 1.000 tekens. De feitelijke wereldinformatietekst die in het model is geïnjecteerd.
constantBooleaansOptioneelStandaard false. Als true, is dit item altijd actief bij elke berichtenuitwisseling.
keysArrayVereist indien niet constantMaximaal 20 sleutels, maximaal 64 tekens elk. Activeer woorden of zinnen. Genegeerd als constant: true.
enabledBooleaansOptioneelStandaard true. Schakel uit om een ​​vermelding tijdelijk uit te schakelen zonder deze te verwijderen.
priorityNummerOptioneelStandaard 0. Hogere getallen worden eerst geïnjecteerd wanneer de contextruimte beperkt is (bijv. 100, 85, 50).

Ondersteunde JSON-formaten

U kunt lorebooks importeren, plakken en exporteren met behulp van drie gestandaardiseerde formaten:

1. Native Public Lorebook-schema (aanbevolen)

Dit is het oorspronkelijke JSON-schema van Public. Het ondersteunt alle velden direct:

{
  "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. SillyTavern Wereldinfo exporteren

De importeur detecteert automatisch SillyTavern standalone exports waar entries is ingetoetst als een objectwoordenboek:

{
  "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. SillyTavern-karakterkaart (character_book)

Je kunt ook personagekaarten (V2- of V3-specificatiekaarten) importeren die a character_book voorwerp:

{
  "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
        }
      ]
    }
  }
}

Maak en beheer lorebooks

Op internet

Navigeer naar /lorebooks in uw browser of selecteer Lorebooks in het zijbalkmenu.

Vanaf nul creëren

  1. Ga naar /lorebooks/create.
  2. Geef uw kennisboek een beschrijvende Naam en optionele Beschrijving / Tags.
  3. Kies Privé of Public zichtbaarheid.
  4. Klik op Invoer toevoegen om regels te maken. Geef triggerzoekwoorden op of vink Altijd actief (constant) aan.
  5. Klik op Lorebook maken om op te slaan.

Bestaande lorebooks importeren

Er zijn twee snelle manieren om bestaande wereldinformatie te laden:

  1. Bestand importeren — Klik op Bestand importeren in de bovenste actiebalk om een bestand te uploaden .json Lorebook- of karakterkaartbestand vanaf uw computer.
  2. JSON plakken — Klik op JSON plakken om het parseerdialoogvenster te openen:
  • Klik op Plakken vanaf klembord om JSON-tekst op te halen die uit een andere app is gekopieerd.
  • Klik op Voorbeeld laden om een ​​vooraf ingevuld Starfall Academy-sjabloon te bekijken.
  • Klik op Parse & Import om het formulier direct in te vullen.

Exporteren en kopiëren

  • Klik in elk scherm voor het maken, bewerken of detailleren van een Lorebook op JSON kopiëren.
  • Het volledige kennisboek wordt geserialiseerd in gestandaardiseerde Public JSON en rechtstreeks naar uw klembord gekopieerd.

Koppelen aan een AI-personage

Zodra je Lorebook is gemaakt:

  1. Openen /characters/add (of klik op Bewerken bij een personage dat je hebt gemaakt).
  2. Scroll naar de Lorebook (optioneel)-kiezer.
  3. Selecteer je kennisboek of kies uit populaire openbare kennisboeken die door de community zijn gemaakt.
  4. Bewaar je personage. Alle volgende chats met dit personage komen automatisch uit het overleveringsboek.

Planlimieten en ontgrendeling

PlannenLoreboeken die u kunt makenInzendingen per overleveringsboek
Gratis3Tot 100
Basis10Tot 100
Ontwerper / ProOnbeperktTot 100

Voor het maken van Lorebooks is de ontgrendeling van Character Lorebooks vereist (in hetzelfde voortgangsniveau als aangepaste chatpersona's). Zie Abonnementen en Gamificatie.


Praktische tips voor makers

  • Gebruik beschrijvende, specifieke trefwoorden: Gebruik namen en samengestelde zinnen zoals ["aria emberwing", "house of the phoenix"] in plaats van gewone korte woorden zoals ["the", "is", "he"].
  • Reserveer constante invoer voor universele regels: Behouden constant: true inzendingen zijn beperkt tot 1 à 2 basisregels (bijv. huidige tijdlijn, kernfysica van de wereld), zodat ze niet het volledige budget van 1.800 tekens in beslag nemen.
  • Houd de inhoud van de inzending beknopt: Door inzendingen met een grote impact van 1-3 duidelijke zinnen passen meerdere relevante inzendingen tegelijk in het contextvenster.
  • Gebruik prioriteitsscores: Geef fundamentele kennis hogere prioriteitsscores (100–80) en kleine decoratieve feiten lagere scores (40–10) zodat de meest kritische context gegarandeerd als eerste wordt geïnjecteerd.

Veelgestelde vragen

Waarom werd mijn Lorebook-invoer niet geactiveerd in de chat?

Controleer het volgende:

  1. Staat de invoer op Ingeschakeld?
  2. Is een van de exacte trefwoorden verschenen in de recente chat of de laatste gebruikersprompt? (Overeenkomsten zijn hoofdletterongevoelige subtekenreeksovereenkomsten).
  3. Hebben inzendingen met een hogere prioriteit als eerste het budget van 1.800 tekens gevuld? Probeer de Prioriteit-score van de inzending te verhogen.

Kan ik meer dan één overleveringsboek aan één personage koppelen?

Momenteel kan elk personage aan één overleveringsboek tegelijk worden gekoppeld. Als je inhoud uit meerdere lorebooks nodig hebt, combineer hun vermeldingen in één lorebook met behulp van de Plakken JSON of exporttools.

Wat gebeurt er als ik een lorebook verwijder?

Van karakters die dat lorebook hadden gelinkt, wordt eenvoudigweg hun lorebook-referentie gewist. Hun gesprekken, instellingen en herinneringen blijven volledig intact.

Kan ik een openbaar kennisboek bewerken dat door iemand anders is gemaakt?

Nee. Alleen de oorspronkelijke maker kan een overleveringsboek bewerken. Als u een openbaar lorebook wilt aanpassen, bekijkt u het lorebook, klikt u op JSON kopiëren, maakt u een nieuw lorebook en plakt u de JSON in uw eigen privékopie.

Is mobiel lorebookbeheer beschikbaar?

Het volledige maken en bewerken van lorebooks is momenteel beschikbaar via de Web-app. Alle lorebooks die aan personages op internet zijn gekoppeld, functioneren automatisch in de chat op alle platforms, inclusief Android en iOS.


Gerelateerde documentatie

Op deze pagina