Guida al lorebook di SillyTavern: un percorso più semplice

Un lorebook in SillyTavern è un file basato su JSON contenente voci: ogni voce ha un insieme di parole chiave, un livello di profondità/priorità e un blocco di testo che descrive un personaggio, un luogo, un oggetto o un evento. Quando una parola chiave appare nella cronologia della chat o nel tuo ultimo messaggio, SillyTavern inserisce la voce corrispondente nella finestra di contesto dell'AI (di solito vicino alla fine del prompt, tramite la modalità di inserimento "post-history"). Le voci possono anche essere impostate come "constant" in modo che si carichino sempre. Il sistema supporta fino a 1000 voci per lorebook, anche se il limite pratico dipende dalla dimensione del contesto (ad esempio, 4096 token per la maggior parte delle API gratuite). Ogni voce ha un campo "secondary key" per trigger multi-parola e un cursore "probability" (0-100%) che controlla se la voce si attiva ogni volta o solo a volte, utile per incontri casuali. Puoi anche assegnare un "role" (system, user, assistant o character) in modo che la voce sia formattata come dialogo. I lorebook vengono salvati come file .json nella cartella /data/default-user/lorebooks/. Il vantaggio principale è che i lorebook alleggeriscono la memoria dalla tua scheda personaggio principale, mantenendo l'AI concentrata sulla scena attuale senza dimenticare i fatti stabiliti.

Apri SillyTavern, vai alla scheda "Lorebook" (l'icona del libro nella barra laterale sinistra). Clicca "Import" per caricare un .json esistente o inizia da zero con "Add Entry". Una voce vuota ha questi campi: Primary Keywords (separate da virgole, ad esempio "taverna, locanda, bar"), Secondary Keys (trigger alternativi, ad esempio "Il Drago Ubriaco"), Content (il testo inserito quando attivato: mantienilo sotto i 300 token per efficienza), Depth (numero intero da 0 a 50; una profondità maggiore significa che la voce è posizionata più vicino all'attenzione dell'AI: usa 10 per fatti di base, 30 per punti critici della trama), Probability (100% = si attiva sempre, 50% = metà delle volte), Role ("system" per la narrazione, "character" per il dialogo in-character), Group (per organizzare più voci sotto una scheda) e Is Constant (seleziona questa opzione per caricare sempre la voce, ignorando le parole chiave). Per una taverna, imposta le parole chiave su "taverna, locanda, oste", il contenuto su "La Taverna del Chiodo Arrugginito ha tavoli di quercia, un camino scoppiettante e un oste muto di nome Gregor che comunica con una lavagna." Depth 10, probability 100%, role system. Salva. Prova digitando "Entro nella taverna": l'AI dovrebbe ora menzionare Gregor.

Oltre alla semplice corrispondenza di parole chiave, i lorebook di SillyTavern supportano trigger regex tramite il campo "Secondary Keys" attivando l'interruttore "Regex" per ogni voce. Usa pattern come \bsword\b|\bblade\b per trovare entrambe le parole. Gli slider di probabilità ti permettono di creare lore imprevedibile: imposta una voce "porta nascosta" al 20% così l'AI la menziona solo ogni tanto, spingendo all'esplorazione. I tag di ruolo (system, user, assistant, character) controllano come viene formattata la voce. Le voci con ruolo "Character" vengono iniettate come se le avesse dette la compagna—utili per i retroscena degli NPC. Le voci con ruolo "System" restano fatti narrativi neutri. Puoi anche usare il campo "Group" per organizzare le voci in gruppi comprimibili (es. "NPC", "Luoghi", "Missioni") per modificarle più facilmente dopo. Un trucco potente: crea una voce con parole chiave come "*" (wildcard) e imposta la probabilità all'1%—così inietti un dettaglio ambientale casuale (es. "l'aria sa di pioggia") in ogni scena. La profondità conta più di quanto pensi: le voci con depth > 30 vengono inserite dopo il prompt principale ma prima dell'ultimo messaggio dell'utente, rendendole più influenti. Sperimenta con depth 1-5 per fatti di mondo passivi che non devono sovrascrivere la scena attiva.

SillyTavern ti permette di collegare i lorebook a singoli personaggi o di attivarli globalmente. I lorebook specifici per personaggio sono ideali per compagne con retroscena o oggetti unici (es. il libro di incantesimi di una maga che si attiva solo chattando con quella maga). Per assegnarli, apri la scheda del personaggio, vai alla scheda "Advanced" e seleziona un lorebook dal menu a tendina. I lorebook di mondo si caricano per qualsiasi personaggio e sono perfetti per luoghi persistenti (una taverna che compare in più avventure) o regole universali (sistemi magici, geografia). La regola pratica: se la lore riguarda un solo personaggio, rendila specifica per personaggio; se riguarda l'ambientazione, usa un lorebook di mondo. Puoi anche impilare fino a 5 lorebook per personaggio (tramite la scheda "Lorebooks" nell'editor del personaggio). Voci sovrapposte tra lorebook diversi possono causare conflitti—l'AI potrebbe confondersi se due voci definiscono lo stesso luogo in modo diverso. Per evitarlo, usa una convenzione di nomi gerarchica: "World_Tavern" contro "Character_Wizard_Spellbook". Sul fronte prestazioni, i lorebook di mondo scansionano tutte le parole chiave a ogni messaggio, quindi tieni il totale delle voci sotto 300 tra tutti i lorebook attivi per evitare lag con finestre di contesto grandi.

Il problema più frequente è che le voci non si attivano. Primo, controlla che le parole chiave compaiano davvero nella chat—il confronto ignora maiuscole/minuscole, ma è a corrispondenza esatta (niente parziali se la regex non è attiva). Secondo, verifica che la probabilità della voce non sia allo 0%. Terzo, assicurati che il lorebook sia abilitato (interruttore nella scheda Lorebook). Quarto, conferma che la profondità della voce non sia così bassa (es. depth 0) da essere tagliata dalla dimensione del contesto—SillyTavern dà priorità alle voci con depth più alta quando la finestra di contesto è piena. Un'altra trappola: sovraccaricare il contesto. Se hai 50 voci con depth 50, competono tutte per lo spazio token limitato. Usa la profondità con parsimonia (depth 1-10 per la maggior parte delle voci). Se l'AI ignora la lore, apri il "Prompt Item Manager" (l'icona del cubo) per vedere esattamente cosa viene iniettato. Cerca la tua voce nella sezione "Lorebooks". Se manca, la parola chiave non ha fatto match oppure la voce era troppo profonda ed è stata tagliata. Inoltre, le voci lunghe (>200 token) vengono spesso troncate; tieni ogni voce sotto i 150 token. Infine, evita parole chiave duplicate tra le voci—la prima voce che fa match (per depth, poi per ordine) ha la precedenza.

I lorebook non sono solo enciclopedie statiche—possono guidare narrazioni che evolvono. Crea una voce "Plot Hook" con parole chiave come "quest, task, mission" e un contenuto che genera un nuovo obiettivo ogni volta (es. "Senti voci di una miniera perduta tra le montagne."). Abbinala a una probabilità del 50% così non ogni menzione produce una missione. Per eventi legati al tempo, usa una voce "Constant" con una data (es. "La festa del raccolto inizia tra 3 giorni") e aggiornala manualmente col passare dei giorni in gioco. Puoi anche concatenare i lorebook: una voce attivata può includere una parola chiave che ne attiva un'altra (es. la voce della taverna attiva "Gregor"). Questo richiede un design attento delle parole chiave. Molti utenti avanzati archiviano gli inventari dei personaggi come lorebook: ogni oggetto è una voce (parole chiave: "pozione, pozione curativa") con un contenuto che lo descrive. Quando il giocatore dice "usa pozione", la voce si attiva e ricorda all'AI gli effetti dell'oggetto. Per mondi davvero dinamici, valuta di usare [SillyTavern's Extras](https://github.com/SillyTavern/SillyTavern-Extras) con integrazione dei lorebook—anche se richiede una configurazione aggiuntiva. Il tetto è alto: alcuni utenti gestiscono lorebook con oltre 500 voci per campagne GDR sterminate.