Lorebooks
Umfassende Anleitung zum Erstellen, Importieren, Verwalten und Verknüpfen von Lorebooks mit KI-Charakteren auf Public.
Lehrbücher (oft auch als Weltinfo bezeichnet) sind eigenständige Sammlungen von Überlieferungen, Schauplätzen, Fraktionsdetails, magischen Systemen und Referenzwissen, auf die Sie verlinken können KI-Charaktere. Wenn Sie mit einem Charakter chatten, werden relevante Einträge aus dem verknüpften Lorebook dynamisch abgerufen und direkt in die Eingabeaufforderung des Modells eingefügt.
Im Gegensatz zur Kernpersönlichkeit eines Charakters ist ein Lorebook vollständig modular aufgebaut: Sie können dasselbe Lorebook mit mehreren Charakteren verknüpfen (z. B. indem Sie ein gemeinsames Starfall Academy Lorebook mit Mira, Tobin, Professor Vale und Lord Ashgrave verknüpfen) oder Lorebooks austauschen, ohne die Stimme des Charakters zu verändern.
Kernkonzepte
Um das Beste aus Lorebooks herauszuholen, ist es hilfreich zu verstehen, wie sie zu den anderen Rollenspiel-Tools auf Public passen:
- Charakterpersönlichkeit – definiert, wer der Charakter ist: sein Sprechstil, seine Hintergrundgeschichte, seine Macken und Verhaltensrichtlinien.
- Chat-Personas – definiert, wer Sie sind: Ihr Name, Ihr Aussehen und Ihre Identität im Gespräch. Siehe Chat-Personas.
- Lehrbücher – definiert die Welt um dich herum: historische Ereignisse, Fraktionen, Orte, Zaubersprüche, Technologieregeln und Beziehungsgeschichten.
Private vs. öffentliche Lorebooks
| Sichtbarkeit | Wer kann es mit einem Charakter verknüpfen? | Wer kann es bearbeiten oder löschen? |
|---|---|---|
| Privat | Nur du | Nur du (der Schöpfer) |
| Public | Jeder Ersteller auf Public kann es beim Erstellen oder Bearbeiten seiner Charaktere verknüpfen | Nur du (der Schöpfer) |
Nur der Besitzer kann ein Lorebook bearbeiten oder löschen. Wenn Sie ein Lorebook löschen, verlieren alle damit verknüpften Charaktere die Verknüpfung sicher, ohne dass ihre Konversationsverläufe oder Persönlichkeiten verloren gehen.
So funktioniert die Kontextinjektion
Wenn Sie in einem Charakter-Chat eine Nachricht senden, führt das Backend eine schnelle Kontext-Assembly-Pipeline aus, bevor es die Antwort der KI generiert:
1. Gescannte Textziele
Die Kontext-Engine sucht im gesamten aktiven Konversationskontext nach übereinstimmenden Einträgen: – Die letzte eingehende Nachricht des Benutzers
- Chat-Verlauf der letzten Gespräche
- Fortlaufende Gesprächszusammenfassung
- Angeheftete und automatisch extrahierte Charakterspeicher – Die ursprüngliche Begrüßung des Charakters
2. Eintragsübereinstimmungstypen
Jeder Eintrag in einem Lorebook hat eines von zwei Auslöseverhalten:
- Keyword-ausgelöst (
constant: false) – Der Eintrag definiert eine Liste von Schlüsselwörtern (z. B.["emberwing", "house of the phoenix"]). Wenn irgendwo im gescannten Konversationstext ein Schlüsselwort vorkommt (Teilzeichenfolgenübereinstimmung ohne Berücksichtigung der Groß-/Kleinschreibung), wird der Eintrag ausgelöst. - Konstant (
constant: true) – Der Eintrag ist immer enthalten in jedem einzelnen Nachrichtenaustausch, wobei Schlüsselwörter vollständig ignoriert werden. Ideal für globale Szenario-Basislinien (z. B. „Das Jahr ist 1204, und der Schleier verbirgt die Starfall Academy vor der Außenwelt“).
3. Prioritäten- und Budgetverwaltung
Modelle verfügen über endliche Eingabeaufforderungskontextfenster. Um schnelle, kohärente und kostengünstige Antworten zu gewährleisten, erzwingt Public ein Injektionsbudget:
- Zeichenbudgetlimit: Bis zu 1.800 Zeichen (
LOREBOOK_INJECT_MAX_CHARS) von Lorebook-Inhalten können pro Nachricht eingefügt werden. - Prioritätsreihenfolge: Alle übereinstimmenden Einträge (sowohl konstant als auch durch Schlüsselwörter ausgelöst) werden nach Priorität in absteigender Reihenfolge sortiert (
100vor50, vorher0). - Budgetanpassung: Einträge werden nacheinander hinzugefügt, beginnend mit der höchsten Priorität, bis das Budget von 1.800 Zeichen erreicht ist. Übersteigt ein Eintrag das verbleibende Budget, wird er weggelassen (bzw. eingepasst, wenn es sich um den ersten Eintrag handelt).
4. Injektionsblockformat
Ausgelöste Einträge werden in einen sauberen Block formatiert und an die Systemeingabeaufforderung des Charakters übergeben:
Relevant world info:
- Universal setting: Magie wird nur an der Starfall Academy gelehrt, und die Außenwelt hält sie für einen Mythos.
- Emberwing House schätzt Mut und Loyalität. Gegründet von Aria Emberwing; die Farben sind Kupfer und Schwarz.
- Duellzauber: Flare blendet einen Gegner; Binding Thread verlangsamt ihn; Mirror Ward reflektiert kleine Flüche.Feldspezifikationen und -grenzen
Lorebook-Metadaten
| Feld | Typ | Erforderlich | Grenzen und Beschreibung |
|---|---|---|---|
name | Zeichenfolge | Erforderlich | Maximal 120 Zeichen. Name der Welt oder Umgebung. |
description | Zeichenfolge | Optional | Maximal 500 Zeichen. Kurze Zusammenfassung der Einstellung. |
visibility | Zeichenfolge | Optional | "private" (Standard) oder "public". Public Lorebooks erscheinen in der Suche und Entdeckung. |
tags | Array | Optional | Bis zu 20 Tags. Tags werden gekürzt und in Kleinbuchstaben geschrieben. |
entries | Array | Optional | Bis zu 100 Einträge pro Lorebook. |
Eintragsmetadaten
| Feld | Typ | Erforderlich | Grenzen und Beschreibung |
|---|---|---|---|
content | Zeichenfolge | Erforderlich | Maximal 1.000 Zeichen. Der tatsächliche Weltinformationstext, der in das Modell eingefügt wird. |
constant | Boolescher Wert | Optional | Standard false. Wenn true, dieser Eintrag ist bei jedem Nachrichtenaustausch immer aktiv. |
keys | Array | Erforderlich, wenn nicht konstant | Bis zu 20 Schlüssel, jeweils maximal 64 Zeichen. Lösen Sie Wörter oder Phrasen aus. Ignoriert, wenn constant: true. |
enabled | Boolescher Wert | Optional | Standard true. Schalten Sie die Option aus, um einen Eintrag vorübergehend zu deaktivieren, ohne ihn zu löschen. |
priority | Nummer | Optional | Standard 0. Höhere Zahlen werden zuerst eingefügt, wenn der Kontextraum eingeschränkt ist (z. B. 100, 85, 50). |
Unterstützte JSON-Formate
Sie können Lorebooks in drei standardisierten Formaten importieren, einfügen und exportieren:
1. Natives Public Lorebook-Schema (empfohlen)
Dies ist das native JSON-Schema von Public. Es unterstützt alle Felder direkt:
{
"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. Export von SillyTavern World-Infos
Der Importer erkennt automatisch die eigenständigen Exporte von SillyTavern entries ist als Objektverzeichnis verschlüsselt:
{
"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-Charakterkarte (character_book)
Sie können auch Charakterkarten (V2- oder V3-Spezifikationskarten) importieren, die a bündeln character_book Objekt:
{
"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
}
]
}
}
}Erstelle und verwalte Lorebooks
Im Internet
Navigieren Sie zu /lorebooks in Ihrem Browser oder wählen Sie Lorebooks aus dem Seitenleistenmenü.
Von Grund auf neu erstellen
- Gehen Sie zu
/lorebooks/create. - Geben Sie Ihrem Lorebook einen beschreibenden Namen und optional eine Beschreibung / Tags.
- Wählen Sie die Sichtbarkeit Privat oder Public.
- Klicken Sie auf Eintrag hinzufügen, um Regeln zu erstellen. Geben Sie Trigger-Schlüsselwörter an oder aktivieren Sie Immer aktiv (konstant).
- Klicken Sie zum Speichern auf Lehrebuch erstellen.
Vorhandene Lorebooks importieren
Sie haben zwei Möglichkeiten, vorhandene Weltinformationen schnell zu laden:
- Datei importieren – Klicken Sie in der oberen Aktionsleiste auf Datei importieren, um eine Datei hochzuladen
.jsonLaden Sie ein Lorebook oder eine Charakterkartendatei von Ihrem Computer herunter. - JSON einfügen – Klicken Sie auf JSON einfügen, um den Parsing-Dialog zu öffnen:
- Klicken Sie auf Aus Zwischenablage einfügen, um aus einer anderen App kopierten JSON-Text abzurufen.
- Klicken Sie auf Beispiel laden, um eine vorab ausgefüllte Starfall Academy-Vorlage zu prüfen.
- Klicken Sie auf Parsen und Importieren, um das Formular sofort auszufüllen.
Exportieren und Kopieren
- Klicken Sie auf jedem Bildschirm zum Erstellen, Bearbeiten oder Detail eines Lorebooks auf JSON kopieren.
- Das gesamte Lorebook wird in standardisiertes Public JSON serialisiert und direkt in Ihre Zwischenablage kopiert.
Verlinkung zu einem KI-Charakter
Sobald Ihr Lorebook erstellt ist:
- Öffnen
/characters/add(Oder klicken Sie bei einem von Ihnen erstellten Charakter auf Bearbeiten). - Scrollen Sie zur Lorebook (optional)-Auswahl.
- Wählen Sie Ihr Lorebook aus oder wählen Sie eines der beliebten öffentlichen Lorebooks aus, die von der Community erstellt wurden.
- Speichern Sie Ihren Charakter. Alle nachfolgenden Chats mit diesem Charakter greifen automatisch auf das Lorebook zurück.
Planlimits und Freischaltung
| Planen | Lorebooks, die Sie erstellen können | Einträge pro Lorebook |
|---|---|---|
| Kostenlos | 3 | Bis zu 100 |
| Grundlegend | 10 | Bis zu 100 |
| Ersteller / Profi | Unbegrenzt | Bis zu 100 |
Für die Erstellung eines Lorebooks ist die Freischaltung von Character Lorebooks erforderlich (in der gleichen Fortschrittsstufe wie benutzerdefinierte Chat-Personas). Siehe Abonnements und Gamifizierung.
Best Practices für YouTuber
- Verwenden Sie beschreibende, spezifische Schlüsselwörter: Verwenden Sie Namen und zusammengesetzte Phrasen wie
["aria emberwing", "house of the phoenix"]statt gebräuchlicher kurzer Wörter wie["the", "is", "he"]. - Konstante Einträge für universelle Regeln reservieren: Behalten
constant: trueEinträge sind auf 1–2 Grundregeln beschränkt (z. B. aktuelle Zeitleiste, Kernweltphysik), damit sie nicht das gesamte Budget von 1.800 Zeichen verbrauchen. - Halten Sie den Eintragsinhalt prägnant: Aussagekräftige Einträge mit 1–3 klaren Sätzen ermöglichen, dass mehrere relevante Einträge gleichzeitig in das Kontextfenster passen.
- Prioritätswerte nutzen: Grundwissen höhere Prioritätswerte geben (
100–80) und kleinere dekorative Fakten niedrigere Werte (40–10), sodass der kritischste Kontext garantiert zuerst eingefügt wird.
Häufig gestellte Fragen
Warum wurde mein Lorebook-Eintrag im Chat nicht ausgelöst?
Überprüfen Sie Folgendes:
- Ist der Eintrag auf Aktiviert gesetzt?
- Ist eines der genauen Schlüsselwörter im letzten Chat oder in der letzten Benutzeraufforderung aufgetaucht? (Bei Übereinstimmungen handelt es sich um Teilzeichenfolgen-Übereinstimmungen, bei denen die Groß-/Kleinschreibung nicht beachtet wird.)
- Haben Einträge mit höherer Priorität zuerst das Budget von 1.800 Zeichen gefüllt? Versuchen Sie, die Prioritätsbewertung des Eintrags zu erhöhen.
Kann ich mehr als ein Lorebook mit einem einzelnen Charakter verknüpfen?
Derzeit kann jeder Charakter jeweils mit einem Lorebook verknüpft werden. Wenn Sie Inhalte aus mehreren Lorebooks benötigen, kombinieren Sie deren Einträge mit den Tools JSON einfügen oder Exportieren in einem einzigen Lorebook.
Was passiert, wenn ich ein Lorebook lösche?
Bei Charakteren, die dieses Lorebook verlinkt haben, wird einfach die Lorebook-Referenz gelöscht. Ihre Gespräche, Einstellungen und Erinnerungen bleiben völlig erhalten.
Kann ich ein öffentliches Lorebook bearbeiten, das von jemand anderem erstellt wurde?
Nein. Nur der ursprüngliche Ersteller kann ein Lorebook bearbeiten. Wenn Sie ein öffentliches Lorebook anpassen möchten, sehen Sie sich das Lorebook an, klicken Sie auf JSON kopieren, erstellen Sie ein neues Lorebook und fügen Sie den JSON in Ihre eigene private Kopie ein.
Ist eine mobile Lorebook-Verwaltung verfügbar?
Die vollständige Erstellung und Bearbeitung von Lorebooks ist derzeit in der Web-App verfügbar. Alle Lorebooks, die mit Charakteren im Web verknüpft sind, funktionieren automatisch im Chat auf allen Plattformen, einschließlich Android und iOS.
Verwandte Dokumentation
- KI-Charaktere – Erstellen Sie benutzerdefinierte Charaktere und verknüpfen Sie Lorebooks
- Chat-Personas – Definieren Sie im Rollenspiel, wer Sie sind
- Abonnements – Planen Sie Kontingente und Freischaltungen von Funktionen
- Web-Übersicht — Webnavigation und Funktionen