Lorebooks
Saber del mundo que aparece en el prompt justo cuando es relevante.
Un lorebook es una colección de entradas más ajustes de escaneo. Adjunta a una conversación tantos libros como quieras; todos los libros adjuntos se escanean juntos como un solo grupo.
| Ajuste | Rango | Efecto |
|---|---|---|
scanDepth | 0-100 | Cuántos mensajes recientes se escanean en busca de palabras clave. Cuentan tanto tus mensajes como los del personaje. |
tokenBudget | 100-32000 | Tope de tokens totales de las entradas activadas. Si los libros difieren, gana el presupuesto más alto. |
recursiveScanning | sí / no | El contenido de las entradas activadas se vuelve a escanear, así que la lore puede activar más lore (hasta 3 pasadas). |
Una entrada tiene claves (palabras disparadoras separadas por comas), claves secundarias opcionales y contenido. Cuando alguna clave aparece en el historial escaneado, la entrada se activa y su contenido se inyecta.
El modo selectivo exige que coincidan una clave primaria Y una secundaria. Las entradas constantes saltan la coincidencia y siempre se inyectan. Las desactivadas quedan en el libro pero nunca disparan. Palabras completas evita que fuego coincida dentro de fogueo.
Cada entrada tiene un nombre visible (comentario) que solo ordena la lista del editor; nunca se envía al modelo y sobrevive a los ciclos de importación y exportación.
Dos números deciden el destino de una entrada. La prioridad decide quién sobrevive al presupuesto de tokens: las entradas de mayor prioridad se conservan primero cuando falta espacio.
El orden (orden de inserción) decide la colocación entre las supervivientes: un orden mayor aparece antes en el prompt. A igualdad de orden decide la prioridad y luego el id de la entrada.
Todas las entradas activadas se renderizan en un único hueco de lorebook de la plantilla de prompt, cada una como mensaje propio con el rol elegido: sistema, usuario o asistente.
No existe posición por entrada; mueve el hueco de lorebook en el editor de plantilla de prompt para controlar dónde cae la lore respecto a todo lo demás.
Las líneas que empiezan con @@ al inicio del contenido ajustan el comportamiento de esa entrada:
@@probability 50
@@scan_depth 8
@@role assistant
@@activate_only_after 4
@@keep| Decorador | Efecto |
|---|---|
@@probability | Probabilidad porcentual de inyectarse al activarse; la tirada es estable dentro del turno. |
@@scan_depth | Anula la profundidad de escaneo del libro para esta entrada. |
@@order / @@priority | Anula el orden de colocación o la prioridad de presupuesto de esta entrada. |
@@role | Anula el rol de inyección de esta entrada. |
@@activate_only_after / @@activate_only_every | Dispara solo después de N mensajes, o solo cada N mensajes. |
@@keep / @@dont_activate_after_match | Mantiene la entrada activa tras su primera coincidencia, o no vuelve a activarla tras coincidir. |
@@is_greeting | Solo activa mientras el chat sigue en el mensaje de saludo. |
El conteo usa el tokenizador del modelo activo, así que el presupuesto refleja lo que el modelo ve de verdad. Cuando las entradas exceden el presupuesto, caen primero las de menor prioridad.
Si la lore se recorta sin parar, sube el presupuesto, reduce la dispersión de prioridades o acorta entradas. El registro de peticiones muestra exactamente qué entradas entraron en cada petición.