Menciones a entidades y @

Referencias y vínculos

Menciones a entidades y @

Una gramática común: clic derecho en el borrador, @ en textos largos. Detectar no es vincular.

Qué almacena una referencia

Todo el proyecto utiliza la misma gramática de referencias: una referencia conserva una versión de protocolo, un alcance, un tipo de objeto, un ID estable y el texto visible. Así, «a quién apunta esto» tiene la misma respuesta en el manuscrito, en el mundo, en las líneas de tiempo, en las prefiguraciones y en un mensaje del agente; no tienes que aprender cinco dialectos para cinco pantallas distintas.

Cambiar el nombre de un objeto mantiene todas las referencias en la misma ficha; los objetos con el mismo nombre se distinguen por tipo y por ID estable, y los alias solo ayudan en la búsqueda: nunca definen la identidad. Si tienes un personaje llamado «Moonrise» y una entrada de mundo llamada «Moonrise», los candidatos mostrarán tipos distintos y no se podrán confundir.

Cuándo vale la pena crear un vínculo

Cuando las palabras se refieren realmente a una ficha existente. La clave no es colorear una palabra; es que tanto tú como la IA sepáis con certeza a qué ficha se refiere, de modo que la continuación reúna el material adecuado, las estadísticas atribuyan las apariciones correctamente y un clic te lleve directo a la ficha. Una mención de pasada a algo que todavía no se ha registrado no necesita un vínculo.

En el manuscrito: clic derecho «Conectar con…»

Arrastra para seleccionar y haz clic derecho. La mitad superior del menú contiene Reescribir / Ampliar / Condensar / Pulir más una línea para instrucciones adicionales; la mitad inferior es «Conectar con…», que busca en todo el proyecto: personajes, lugares, objetos, entradas del mundo, capítulos, escenas, tiempos y lugares, líneas del manuscrito, elementos de la línea de tiempo, prefiguraciones y accesos a módulos. Si no hay nada disponible, te lo indica; y si una búsqueda no da resultados, también lo avisa.

Cuando realmente quieras una ficha nueva, la lista ofrece opciones explícitas como «+ Nuevo personaje…» y «+ Nuevo objeto…» para crearlo y conectarlo. Esa es una decisión que tomas tú, no una suposición del sistema.

En textos largos: las dos vías con @

  1. Selección en dos niveles
    En descripciones del mundo, notas de prefiguraciones y descripciones de la línea de tiempo, escribe @, elige una categoría (personajes / lugares y mapas / objetos / mundo / estructura del manuscrito / línea de tiempo / prefiguraciones / accesos a módulos) y luego el objeto exacto. Los candidatos nunca se truncan dentro de una categoría: desplázate por todos ellos y sigue escribiendo para filtrar.
  2. O busca directamente
    Si ya conoces el nombre, escribe @palabra_clave para buscar en todos los tipos. Ambas vías guardan la misma referencia estable.
  3. En su sitio
    La mención aparece como una etiqueta reconocible justo donde la escribiste y salta a la ficha; no hay un segundo cuadro de vista previa debajo.

La coincidencia abarca nombres oficiales y alias, priorizando las coincidencias exactas sobre los prefijos y las subcadenas. Los nombres y las rutas se comparan por separado, por lo que buscar el título de una escena no mostrará cada una de las líneas que contiene esa escena.

Qué ocurre tras vincular

  • Los vínculos a personajes, objetos y lugares en el manuscrito siguen formando parte de los recuentos habituales de apariciones y uso; los demás destinos son enlaces informativos que permiten saltar y aportan contexto, sin reescribir jamás el módulo de destino.
  • Una referencia nunca crea una ficha que falte, y vincular el acceso a un módulo no vuelca todo ese módulo en el contexto de la IA: es simple navegación.
  • Una referencia no concede permisos de escritura: cualquier cambio propuesto por la IA sigue pasando por la tarjeta de confirmación.

La detección automática no es una referencia

El editor reconoce los nombres de personajes, lugares, objetos y entradas del mundo, pero solo los marca con un subrayado punteado muy tenue; pasar el cursor añade un sombreado más pálido que una selección y hacer clic no abre los detalles. En personajes y objetos, al hacer clic se ofrece «Convertir en referencia», que es donde se crea la referencia real. Las líneas de personaje omiten esta capa: ya declaran explícitamente quién está hablando.

Solo las referencias vinculadas alimentan los recuentos y la recopilación de contexto para la IA; la marca tenue es tan solo un aviso visual.

Límites y solución de problemas

  • La sintaxis antigua [[nombre]] y las grafías anteriores de personajes y objetos se siguen leyendo. Si un nombre antiguo coincide con un solo objeto, se muestra bien; si coincide con varios, se marca como ambiguo en lugar de elegir el primero en silencio, y si el objeto ya no existe, se marca como no válido.
  • Cuando se elimina un objeto, la referencia conserva su texto visible original; no se sustituye por ningún otro contenido.
  • Las referencias entre proyectos distintos no están disponibles en esta versión: traslada tu trabajo utilizando el paquete de proyecto.
  • Pulsar Tabulador dentro de un campo no abre el menú de tipos de línea del manuscrito; esa pulsación pertenece exclusivamente a las líneas del manuscrito.

El sentido y los efectos secundarios se detallan en Vínculos entre módulos.