Guia do chat

Lorebooks

Conhecimento do mundo que entra no prompt exatamente quando é relevante.

Livros

Um lorebook é uma coleção de entradas mais configurações de varredura. Anexe quantos livros quiser a uma conversa; todos os livros anexados são varridos juntos como um único conjunto.

Configuração	Faixa	Efeito
`scanDepth`	0-100	Quantas mensagens recentes são varridas em busca de palavras-chave. Suas mensagens e as do personagem contam.
`tokenBudget`	100-32000	Teto de tokens do total de entradas ativadas. Quando os livros divergem, o maior orçamento vence.
`recursiveScanning`	sim / não	O conteúdo das entradas ativadas é varrido de novo, permitindo que lore ative mais lore (até 3 passadas).

Entradas

Uma entrada tem chaves (palavras-gatilho separadas por vírgula), chaves secundárias opcionais e conteúdo. Quando alguma chave aparece no histórico varrido, a entrada ativa e seu conteúdo é injetado.

O modo seletivo exige que uma chave primária E uma secundária coincidam. Entradas constantes pulam a checagem e são sempre injetadas. Entradas desativadas ficam no livro mas nunca disparam. Palavras inteiras evita que fogo case dentro de fogueira.

Cada entrada tem um nome de exibição (comentário) usado só para organizar a lista do editor; nunca é enviado ao modelo e sobrevive às idas e vindas de importação e exportação.

Prioridade versus ordem

Dois números decidem o destino de uma entrada. A prioridade decide quem sobrevive ao orçamento de tokens: entradas de prioridade maior são mantidas primeiro quando falta espaço.

A ordem (ordem de inserção) decide a colocação entre as sobreviventes: ordem maior aparece antes no prompt. Empate na ordem cai para prioridade e depois para o id da entrada.

Injeção

Todas as entradas ativadas rendem em um único slot de lorebook do template de prompt, cada uma como mensagem própria com o papel escolhido: sistema, usuário ou assistente.

Não existe posição por entrada; mova o slot de lorebook no editor de template de prompt para controlar onde a lore cai em relação ao resto.

Decoradores

Linhas começando com @@ no topo do conteúdo ajustam o comportamento daquela entrada:

text

@@probability 50
@@scan_depth 8
@@role assistant
@@activate_only_after 4
@@keep

Decorador	Efeito
`@@probability`	Chance percentual de injetar quando ativada; o sorteio é estável dentro do turno.
`@@scan_depth`	Substitui a profundidade de varredura do livro para esta entrada.
`@@order / @@priority`	Substitui a ordem de colocação ou a prioridade de orçamento desta entrada.
`@@role`	Substitui o papel de injeção desta entrada.
`@@activate_only_after / @@activate_only_every`	Dispara só depois de N mensagens, ou só a cada N mensagens.
`@@keep / @@dont_activate_after_match`	Mantém a entrada ativa após a primeira correspondência, ou nunca mais ativa depois de casar.
`@@is_greeting`	Ativa apenas enquanto o chat ainda está na mensagem de saudação.

Comportamento do orçamento de tokens

A contagem usa o tokenizador do modelo ativo, então o orçamento reflete o que o modelo realmente vê. Quando as entradas excedem o orçamento, as de menor prioridade caem primeiro.

Se a lore vive sendo cortada, aumente o orçamento, reduza a dispersão de prioridades ou encurte as entradas. O registro de requisições mostra exatamente quais entradas entraram em cada requisição.