Menções a entidades e @

Referências e vínculos

Menções a entidades e @

Uma gramática de referência: clique com o botão direito no rascunho, @ em textos longos. Detecção não é vínculo.

O que uma referência armazena

O projeto inteiro usa uma única gramática de referência: uma referência armazena a versão do protocolo, o escopo, o tipo de objeto, um ID estável e o texto de exibição. Assim, a pergunta “para quem isto aponta” tem a mesma resposta no manuscrito, no mundo, na linha do tempo, nos prenúncios e em uma mensagem do agente—você não precisa aprender cinco dialetos para cinco telas.

Renomear um objeto mantém todas as referências no mesmo cartão; objetos com o mesmo nome são diferenciados pelo tipo e pelo ID estável, e os apelidos apenas ajudam na busca—eles nunca definem a identidade. Se você tiver um personagem “Moonrise” e um registro de mundo “Moonrise”, os candidatos exibem tipos diferentes e não podem ser misturados.

Quando vale a pena criar um vínculo

Quando as palavras realmente se referem a um cartão existente no projeto. O objetivo não é colorir uma palavra; é garantir que você e a IA saibam exatamente a qual cartão ela se refere—para que a continuação reúna o material correto, as estatísticas façam a atribuição certa e um clique leve diretamente ao cartão. Uma simples menção de passagem a algo que ainda não foi registrado não precisa de vínculo.

No manuscrito: Conectar a…

Arraste para selecionar e clique com o botão direito. A metade superior do menu traz Reescrever / Expandir / Resumir / Polir acompanhados de uma linha de instrução adicional; a metade inferior é “Conectar a…”, que pesquisa tudo no projeto—personagens, locais, objetos, registros de mundo, capítulos, cenas, tempos e lugares, linhas do manuscrito, itens da linha do tempo, prenúncios e entradas de módulos. Se não houver nada disponível, o menu avisa; se uma busca não encontrar resultados, também informa isso.

Quando você realmente quiser criar uma nova ficha, a lista traz opções explícitas como “+ Novo personagem “…” e conectar” e “+ Novo objeto “…” e conectar”. Essa é uma decisão que você tomou, e não um palpite do sistema.

Em textos longos: os dois caminhos do @

  1. Seleção em dois níveis
    Em descrições de mundo, notas de prenúncio e descrições da linha do tempo, digite @, escolha uma categoria (personagens / locais e mapas / objetos / mundo / estrutura do manuscrito / linha do tempo / prenúncios / entradas de módulos) e depois o objeto exato. Os candidatos nunca são cortados dentro de uma categoria: role por todos eles e continue digitando para filtrar.
  2. Ou pesquise direto
    Se você já souber o nome, digite @palavra-chave para pesquisar em todos os tipos de uma só vez. Ambos os caminhos gravam a mesma referência estável.
  3. No próprio local
    A citação surge como uma etiqueta reconhecível exatamente onde você digitou e salta para o cartão; não há uma segunda caixa de prévia embaixo.

A busca contempla nomes oficiais e apelidos, com correspondências exatas ranqueadas acima de prefixos e trechos de texto. Nomes e caminhos são pesquisados separadamente, de modo que buscar o título de uma cena não listará todas as linhas dentro dela.

O que muda após vincular

  • Vínculos de personagens, objetos e locais no manuscrito continuam participando das contagens habituais de presença e uso; outros alvos são vínculos informativos que servem para navegação e contexto, sem jamais reescrever o módulo de destino.
  • Uma referência nunca cria um cartão ausente, e vincular a entrada de um módulo não despeja todo aquele módulo no contexto da IA—ela funciona como navegação.
  • Uma referência não concede permissão de gravação: toda alteração feita pela IA ainda precisa passar pelo cartão de confirmação.

Detecção não é referência

O editor reconhece nomes de personagens, locais, objetos e registros de mundo no texto, mas os sinaliza apenas com um sublinhado pontilhado bem sutil; passar o cursor adiciona um destaque mais claro do que uma seleção, e clicar não abre os detalhes. Em personagens e objetos, o clique oferece “Converter em referência”, que é onde o vínculo verdadeiro é criado. Linhas de personagem ignoram essa etapa—elas já indicam diretamente quem está falando.

Apenas as referências vinculadas alimentam as contagens e a composição da IA; a marcação sutil é apenas um lembrete.

Limites e solução de problemas

  • A sintaxe antiga [[nome]] e as grafias legadas de personagens e objetos ainda podem ser lidas. Quando um nome antigo corresponde a um único objeto, ele é exibido normalmente; se houver múltiplos objetos com o mesmo nome, ele é marcado como ambíguo em vez de escolher silenciosamente o primeiro, e um objeto não encontrado é marcado como inválido.
  • Após a exclusão de um objeto, a referência mantém o texto de exibição original; nenhum outro conteúdo é colocado no lugar.
  • Referências entre projetos não estão disponíveis nesta versão—para transferir seu trabalho, use a exportação e importação do pacote de projeto.
  • Pressionar Tab dentro de um campo de texto não abre o menu de tipos de linha do manuscrito; essa tecla pertence à digitação das linhas do manuscrito.

A direção e os efeitos colaterais estão em Vínculos entre módulos.