libros de historia
Guía completa para crear, importar, administrar y vincular Lorebooks con personajes de IA en Public.
Libros de historia (a menudo llamados Información mundial) son colecciones independientes de historia, hechos de escenarios, detalles de facciones, sistemas mágicos y conocimientos de referencia a los que puedes vincular personajes de IA. Cuando chateas con un personaje, las entradas relevantes del libro de historia vinculado se recuperan dinámicamente y se inyectan directamente en el mensaje del modelo.
A diferencia de la personalidad central de un personaje, un libro de historia es completamente modular: puedes vincular el mismo libro de historia a múltiples personajes (por ejemplo, vincular un libro de historia compartido Starfall Academy a Mira, Tobin, Profesor Vale y Lord Ashgrave), o intercambiar libros de historia sin alterar la voz del personaje.
Conceptos básicos
Para aprovechar al máximo los libros de historia, es útil comprender cómo encajan con las otras herramientas de juego de roles en Public:
- Personalidad del personaje: define quién es el personaje: su estilo de hablar, su historia de fondo, sus peculiaridades y sus pautas de comportamiento.
- Personas de chat: define quién eres: tu nombre, apariencia e identidad en la conversación. Ver personas de chat.
- Libros de historia: define el mundo que te rodea: eventos históricos, facciones, ubicaciones, hechizos, reglas tecnológicas y tradiciones de relaciones.
Libros de historia públicos y privados
| Visibilidad | ¿Quién puede vincularlo a un personaje? | ¿Quién puede editarlo o eliminarlo? |
|---|---|---|
| Privado | solo tu | Sólo tú (el creador) |
| Public | Cualquier creador en Public puede vincularlo al crear o editar sus personajes. | Sólo tú (el creador) |
Sólo el propietario puede editar o eliminar un libro de historia. Si eliminas un libro de historia, cualquier personaje vinculado a él perderá el vínculo de forma segura sin perder sus historias de conversación ni sus personalidades.
Cómo funciona la inyección de contexto
Cuando envías un mensaje en un chat de personajes, el backend ejecuta un rápido proceso de ensamblaje de contexto antes de generar la respuesta de la IA:
1. Destinos de texto escaneados
El motor de contexto busca entradas coincidentes en todo el contexto de la conversación activa:
- El último mensaje entrante del usuario.
- Historial de chat de conversaciones recientes
- Resumen continuo de la conversación
- Recuerdos de personajes fijados y extraídos automáticamente.
- El saludo original del personaje.
2. Tipos de coincidencia de entradas
Cada entrada en un libro de historia tiene uno de dos comportamientos desencadenantes:
- Activado por palabra clave (
constant: false): la entrada define una lista de palabras clave (p. ej.["emberwing", "house of the phoenix"]). Si aparece alguna palabra clave en cualquier parte del texto de la conversación escaneada (coincidencia de subcadena que no distingue entre mayúsculas y minúsculas), se activa la entrada. - Constante (
constant: true): la entrada siempre se incluye en cada intercambio de mensajes, ignorando las palabras clave por completo. Ideal para líneas de base de escenarios globales (por ejemplo, "El año es 1204 y el Velo oculta a Starfall Academy del mundo exterior").
3. Gestión de prioridades y presupuesto
Los modelos tienen ventanas de contexto de aviso finitas. Para mantener las respuestas rápidas, coherentes y rentables, Public aplica un presupuesto de inyección:
- Límite de presupuesto de caracteres: Hasta 1800 caracteres (
LOREBOOK_INJECT_MAX_CHARS) de contenido del libro de historia se pueden inyectar por mensaje. - Orden de prioridad: Todas las entradas coincidentes (tanto constantes como activadas por palabras clave) se ordenan por Prioridad en orden descendente (
100antes50, antes0). - Ajuste del presupuesto: Las entradas se agregan una por una comenzando desde la prioridad más alta hasta alcanzar el presupuesto de 1800 caracteres. Si una entrada excede el presupuesto restante, se omite (o se ajusta si es la primera entrada).
4. Formato de bloque de inyección
Las entradas activadas se formatean en un bloque limpio y se pasan al indicador del sistema del personaje:
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.Especificaciones y límites de campo
Metadatos del libro de historia
| campo | Tipo | Requerido | Límites y descripción |
|---|---|---|---|
name | cuerda | Requerido | Máximo 120 caracteres. Nombre del mundo o escenario. |
description | cuerda | Opcional | Máximo 500 caracteres. Breve resumen de la ambientación. |
visibility | cuerda | Opcional | "private" (predeterminado) o "public". Los libros de historia Public aparecen en la búsqueda y el descubrimiento. |
tags | matriz | Opcional | Hasta 20 etiquetas. Las etiquetas están recortadas y en minúsculas. |
entries | matriz | Opcional | Hasta 100 entradas por libro de historia. |
Metadatos de entrada
| campo | Tipo | Requerido | Límites y descripción |
|---|---|---|---|
content | cuerda | Requerido | Máximo 1000 caracteres. El texto de información del mundo real inyectado en el modelo. |
constant | Booleano | Opcional | Predeterminado false. si true, esta entrada siempre está activa en cada intercambio de mensajes. |
keys | matriz | Obligatorio si no es constante | Hasta 20 claves, máximo 64 caracteres cada una. Palabras o frases desencadenantes. ignorado si constant: true. |
enabled | Booleano | Opcional | Predeterminado true. Desactive esta opción para desactivar temporalmente una entrada sin eliminarla. |
priority | Número | Opcional | Predeterminado 0. Los números más altos se inyectan primero cuando el espacio de contexto está limitado (p. ej. 100, 85, 50). |
Formatos JSON compatibles
Puede importar, pegar y exportar libros de historia utilizando tres formatos estandarizados:
1. Esquema del libro de historia nativo Public (recomendado)
Este es el esquema JSON nativo de Public. Soporta todos los campos directamente:
{
"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. Exportación de información mundial de SillyTavern
El importador detecta automáticamente las exportaciones independientes de SillyTavern donde entries está codificado como un diccionario de objetos:
{
"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. Tarjeta de personaje de SillyTavern (character_book)
También puedes importar tarjetas de personaje (tarjetas de especificaciones V2 o V3) que incluyen un character_book objeto:
{
"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
}
]
}
}
}Crear y gestionar libros de historia
En la web
Navegar a /lorebooks en tu navegador o selecciona Lorebooks en el menú de la barra lateral.
Creando desde cero
- Ir a
/lorebooks/create. - Dale a tu libro de historia un Nombre descriptivo y una Descripción / Etiquetas opcionales.
- Elija visibilidad Privada o Public.
- Haga clic en Agregar entrada para crear reglas. Especifique palabras clave desencadenantes o marque Siempre activo (constante).
- Haz clic en Crear libro de historia para guardar.
Importación de libros de historia existentes
Tienes dos formas rápidas de cargar información mundial existente:
- Importar archivo: haga clic en Importar archivo en la barra de acciones superior para cargar cualquier
.jsonarchivo de libro de historia o tarjeta de personaje desde tu computadora. - Pegar JSON: haga clic en Pegar JSON para abrir el cuadro de diálogo de análisis:
- Haga clic en Pegar desde el portapapeles para extraer el texto JSON copiado de otra aplicación.
- Haga clic en Cargar ejemplo para inspeccionar una plantilla prellenada de Starfall Academy.
- Haga clic en Analizar e importar para completar el formulario al instante.
Exportar y copiar
- En cualquier pantalla de creación, edición o detalle de un libro de historia, haz clic en Copiar JSON.
- Todo el libro de historia se serializa en Public JSON estandarizado y se copia directamente a su portapapeles.
Vinculación a un personaje de IA
Una vez creado tu libro de historia:
- Abierto
/characters/add(o haz clic en Editar en cualquier personaje que hayas creado). - Desplázate hasta el selector Lorebook (opcional).
- Seleccione su libro de historia o elija entre libros de historia públicos populares creados por la comunidad.
- Guarda tu personaje. Cualquier conversación posterior con este personaje se extraerá automáticamente del libro de historia.
Límites del plan y desbloqueo
| Planificar | Libros de historia que puedes crear | Entradas por libro de historia |
|---|---|---|
| Gratis | 3 | hasta 100 |
| Básico | 10 | hasta 100 |
| Creador / Profesional | Ilimitado | hasta 100 |
La creación de libros de historia requiere el desbloqueo de Libros de historia de personajes (en el mismo nivel de progresión que los personajes de chat personalizados). Ver Suscripciones y Gamificación.
Mejores prácticas para creadores
- Utilice palabras clave descriptivas y específicas: Utilice nombres y frases compuestas como
["aria emberwing", "house of the phoenix"]en lugar de palabras cortas comunes como["the", "is", "he"]. - Reservar entradas constantes para reglas universales: Mantener
constant: truelas entradas se limitan a 1 o 2 reglas básicas (por ejemplo, línea de tiempo actual, física mundial central) para que no consuman todo el presupuesto de 1.800 caracteres. - Mantenga el contenido de las entradas conciso: Las entradas de alto impacto de 1 a 3 oraciones claras permiten que varias entradas relevantes quepan en la ventana de contexto a la vez.
- Utilizar puntuaciones de prioridad: Dar puntuaciones de prioridad más altas a la historia fundamental (
100–80) y hechos decorativos menores puntuaciones más bajas (40–10) por lo que se garantiza que el contexto más crítico se inyectará primero.
Preguntas frecuentes
¿Por qué no se activó la entrada de mi libro de historia en el chat?
Verifique lo siguiente:
- ¿La entrada está activada Habilitada?
- ¿Apareció alguna de las palabras clave exactas en el chat reciente o en el mensaje de usuario más reciente? (Las coincidencias son coincidencias de subcadenas que no distinguen entre mayúsculas y minúsculas).
- ¿Las entradas de mayor prioridad llenaron primero el presupuesto de 1.800 caracteres? Intente aumentar la puntuación de Prioridad de la entrada.
¿Puedo vincular más de un libro de historia a un solo personaje?
Actualmente, cada personaje se puede vincular a un libro de historia a la vez. Si necesita contenido de varios libros de historia, combine sus entradas en un solo libro de historia usando Pegar JSON o herramientas de exportación.
¿Qué pasa si elimino un libro de historia?
A los personajes que habían vinculado ese libro de historia simplemente se les borrará la referencia de su libro de historia. Sus conversaciones, escenarios y recuerdos permanecen completamente intactos.
¿Puedo editar un libro de historia público creado por otra persona?
No. Sólo el creador original puede editar un libro de historia. Si desea personalizar un libro de historia público, vea el libro de historia, haga clic en Copiar JSON, cree un nuevo libro de historia y pegue el JSON en su propia copia privada.
¿Está disponible la gestión de libros de historia móviles?
La creación y edición completa del libro de historia está disponible actualmente en la aplicación Web. Cualquier libro de historia vinculado a personajes en la web funcionará automáticamente en el chat en todas las plataformas, incluidas Android y iOS.
Documentación relacionada
- personajes de IA — crear personajes personalizados y vincular libros de historia
- personas de chat — define quién eres en el juego de rol
- Suscripciones — planificar cuotas y desbloqueos de funciones
- Descripción web — navegación web y funciones