Public Help
Características

Livros de história

Guia completo para criar, importar, gerenciar e vincular Lorebooks a personagens de IA em Public.

Livros de história (frequentemente chamados de Informações do mundo) são coleções independentes de história, fatos de cenário, detalhes de facções, sistemas mágicos e conhecimento de referência aos quais você pode vincular Personagens de IA. Quando você conversa com um personagem, entradas relevantes do livro de história vinculado são recuperadas dinamicamente e injetadas diretamente no prompt do modelo.

Ao contrário da personalidade central de um personagem, um livro de histórias é completamente modular: você pode vincular o mesmo livro de histórias a vários personagens (por exemplo, vincular um livro de histórias Academia Starfall compartilhado a Mira, Tobin, Professora Vale e Lorde Ashgrave) ou trocar livros de histórias sem alterar a voz do personagem.

Conceitos básicos

Para aproveitar ao máximo os livros de história, é útil entender como eles se encaixam com as outras ferramentas de roleplay em Public:

  • Personalidade do personagem — define quem é o personagem: seu estilo de falar, história de fundo, peculiaridades e diretrizes comportamentais.
  • Personas de bate-papo — define quem você é: seu nome, aparência e identidade na conversa. Veja Personagens de bate-papo.
  • Livros de história — define o mundo ao seu redor: eventos históricos, facções, locais, feitiços, regras tecnológicas e conhecimento de relacionamento.

Livros de história privados versus públicos

VisibilidadeQuem pode vinculá-lo a um personagemQuem pode editá-lo ou excluí-lo
PrivadoSó vocêSomente você (o criador)
PublicQualquer criador em Public pode vinculá-lo ao criar ou editar seus personagensSomente você (o criador)

Somente o proprietário pode editar ou excluir um livro de história. Se você excluir um livro de história, todos os personagens vinculados a ele perderão o link com segurança, sem perder seus históricos de conversas ou personalidades.


Como funciona a injeção de contexto

Quando você envia uma mensagem em um chat de personagem, o backend executa um pipeline rápido de montagem de contexto antes de gerar a resposta da IA:

1. Destinos de texto digitalizados

O mecanismo de contexto verifica entradas correspondentes em todo o contexto de conversação ativa:

  • A última mensagem recebida do usuário
  • Histórico de conversas recentes
  • Resumo da conversa contínua
  • Memórias de personagens fixadas e extraídas automaticamente
  • A saudação original do personagem

2. Tipos de correspondência de entrada

Cada entrada em um livro de história tem um de dois comportamentos de gatilho:

  • ** Acionado por palavra-chave (constant: false)** — A entrada define uma lista de palavras-chave (por exemplo, ["emberwing", "house of the phoenix"]). Se alguma palavra-chave aparecer em qualquer lugar no texto da conversa digitalizada (correspondência de substring sem distinção entre maiúsculas e minúsculas), a entrada será acionada.
  • Constante (constant: true) — A entrada é sempre incluída em cada troca de mensagens, ignorando completamente as palavras-chave. Ideal para linhas de base de cenários globais (por exemplo, "O ano é 1204 e o Véu esconde a Academia Starfall do mundo exterior").

3. Gestão de prioridades e orçamento

Os modelos têm janelas de contexto de prompt finitas. Para manter as respostas rápidas, coerentes e econômicas, Public impõe um orçamento de injeção:

  • Limite de orçamento de caracteres: Até 1.800 caracteres (LOREBOOK_INJECT_MAX_CHARS) do conteúdo do livro de história pode ser injetado por mensagem.
  • Ordenação de prioridade: Todas as entradas correspondentes (constantes e acionadas por palavra-chave) são classificadas por Prioridade em ordem decrescente (100 antes 50, antes 0).
  • Ajuste ao orçamento: As entradas são adicionadas uma a uma, começando pela prioridade mais alta até atingir o orçamento de 1.800 caracteres. Se uma entrada exceder o orçamento restante, ela será omitida (ou ajustada se for a primeira entrada).

4. Formato do bloco de injeção

As entradas acionadas são formatadas em um bloco limpo e passadas para o prompt do sistema do personagem:

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.

Especificações e limites de campo

Metadados do Lorebook

CampoTipoObrigatórioLimites e Descrição
nameCordaObrigatórioMáximo 120 caracteres. Nome do mundo ou cenário.
descriptionCordaOpcionalMáximo 500 caracteres. Breve resumo da configuração.
visibilityCordaOpcional"private" (padrão) ou "public". Public livros de história aparecem em pesquisas e descobertas.
tagsMatrizOpcionalAté 20 tags. As tags são cortadas e em letras minúsculas.
entriesMatrizOpcionalAté 100 entradas por livro de história.

Metadados de entrada

CampoTipoObrigatórioLimites e Descrição
contentCordaObrigatórioMáximo 1.000 caracteres. O texto de informação mundial real injetado no modelo.
constantBooleanoOpcionalPadrão false. Se true, esta entrada estará sempre ativa em todas as trocas de mensagens.
keysMatrizObrigatório se não for constanteAté 20 chaves, máximo de 64 caracteres cada. Palavras ou frases de gatilho. Ignorado se constant: true.
enabledBooleanoOpcionalPadrão true. Desative para desativar temporariamente uma entrada sem excluí-la.
priorityNúmeroOpcionalPadrão 0. Números mais altos são injetados primeiro quando o espaço de contexto é restrito (por exemplo 100, 85, 50).

Formatos JSON suportados

Você pode importar, colar e exportar livros de história usando três formatos padronizados:

1. Esquema nativo Public do livro de história (recomendado)

Este é o esquema JSON nativo de Public. Suporta todos os campos diretamente:

{
  "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. Exportação de informações do mundo SillyTavern

O importador detecta automaticamente as exportações autônomas do SillyTavern onde entries é digitado como um dicionário 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. Cartão de personagem SillyTavern (character_book)

Você também pode importar cartões de personagem (cartões de especificação V2 ou V3) que agrupam um 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
        }
      ]
    }
  }
}

Crie e gerencie livros de história

Na web

Navegue até /lorebooks no seu navegador ou selecione Lorebooks no menu da barra lateral.

Criando do zero

  1. Vá para /lorebooks/create.
  2. Dê ao seu livro de história um Nome descritivo e Descrição / Tags opcionais.
  3. Escolha visibilidade Privada ou Public.
  4. Clique em Adicionar entrada para criar regras. Especifique palavras-chave de acionamento ou marque Sempre ativo (constante).
  5. Clique em Criar livro de história para salvar.

Importando livros de história existentes

Você tem duas maneiras rápidas de carregar informações mundiais existentes:

  1. Importar arquivo — Clique em Importar arquivo na barra de ação superior para fazer upload de qualquer .json lorebook ou arquivo de cartão de personagem do seu computador.
  2. Colar JSON — Clique em Colar JSON para abrir a caixa de diálogo de análise:
  • Clique em Colar da área de transferência para extrair o texto JSON copiado de outro aplicativo.
  • Clique em Carregar exemplo para inspecionar um modelo Starfall Academy pré-preenchido.
  • Clique em Analisar e importar para preencher o formulário instantaneamente.

Exportando e copiando

  • Em qualquer tela de criação, edição ou detalhe do livro de história, clique em Copiar JSON.
  • Todo o livro de história é serializado em JSON Public padronizado e copiado diretamente para sua área de transferência.

Vinculando a um personagem de IA

Depois que seu livro de história for criado:

  1. Abra /characters/add (ou clique em Editar em qualquer personagem que você criou).
  2. Vá até o seletor Lorebook (opcional).
  3. Selecione seu livro de história ou escolha um dos livros de história públicos populares criados pela comunidade.
  4. Salve seu personagem. Quaisquer bate-papos subsequentes com este personagem serão automaticamente extraídos do livro de história.

Planeje limites e desbloqueio

PlanoLivros de história que você pode criarEntradas por livro de história
Grátis3Até 100
Básico10Até 100
Criador/ProfissionalIlimitadoAté 100

A criação do livro de história requer o desbloqueio de livros de história do personagem (no mesmo nível de progressão das personas de bate-papo personalizadas). Veja Assinaturas e Gamificação.


Práticas recomendadas para criadores

  • Use palavras-chave descritivas e específicas: Use nomes e frases compostas como ["aria emberwing", "house of the phoenix"] em vez de palavras curtas comuns como ["the", "is", "he"].
  • Reserve entradas constantes para regras universais: Mantenha constant: true entradas limitadas a 1–2 regras básicas (por exemplo, linha do tempo atual, física mundial central) para que não consumam todo o orçamento de 1.800 caracteres.
  • Mantenha o conteúdo das entradas conciso: Entradas de alto impacto de 1 a 3 frases claras permitem que várias entradas relevantes caibam na janela de contexto de uma só vez.
  • Utilize pontuações de prioridade: Dê pontuações de prioridade mais altas ao conhecimento fundamental (100–80) e fatos decorativos menores pontuações mais baixas (40–10) portanto, é garantido que o contexto mais crítico seja injetado primeiro.

Perguntas frequentes

Por que minha entrada no livro de história não foi acionada no chat?

Verifique o seguinte:

  1. A entrada está ativada Ativada?
  2. Alguma das palavras-chave exatas apareceu no bate-papo recente ou na última solicitação do usuário? (As correspondências são correspondências de substring que não diferenciam maiúsculas de minúsculas).
  3. As entradas de maior prioridade preencheram primeiro o orçamento de 1.800 caracteres? Tente aumentar a pontuação de Prioridade da inscrição.

Posso vincular mais de um livro de história a um único personagem?

Atualmente, cada personagem pode ser vinculado a um livro de história por vez. Se você precisar de conteúdo de vários livros de história, combine suas entradas em um único livro de história usando Colar JSON ou ferramentas de exportação.

O que acontece se eu excluir um livro de história?

Personagens que vincularam esse livro de história simplesmente terão sua referência ao livro de história apagada. Suas conversas, configurações e memórias permanecem completamente intactas.

Posso editar um livro de história público criado por outra pessoa?

Não. Somente o criador original pode editar um livro de história. Se você quiser personalizar um livro de histórias público, visualize o livro de histórias, clique em Copiar JSON, crie um novo livro de histórias e cole o JSON em sua própria cópia privada.

O gerenciamento do livro de história móvel está disponível?

A criação e edição completa do livro de história está atualmente disponível no aplicativo Web. Quaisquer livros de história vinculados a personagens na web funcionarão automaticamente no bate-papo em todas as plataformas, incluindo Android e iOS.


Documentação relacionada

Nesta página