Sobre el proyecto

Liyuan es una aplicación de rol centrada en agentes de IA que funcionaliza las diversas capacidades del agente para el rol, buscando ofrecer a los usuarios una buena experiencia de juego de rol. Las características principales incluyen: 1. Optimización de memoria: modificando el harness para elevar el límite de memoria desde la fuente, recortando el contexto en cada turno a nivel de arquitectura, filtrando operaciones intermedias redundantes y conservando únicamente el texto narrativo y las instantáneas. Adopta una estructura de memoria de cuatro capas: contexto puro (memoria de trabajo) → libro mayor estructurado (un modelo lateral lleva la contabilidad automáticamente cada turno: objetos, afinidad, tiempo, hilos argumentales) → activos de recuperación (libro mundial + base de conocimiento, recuperados solo cuando se necesitan) → compresión narrativa (genera resúmenes de capítulos anteriores según la lógica narrativa). 2. Modo de consulta del agente: en nodos clave de la trama (definición de nuevos personajes, giros importantes, etc.), el agente muestra una tarjeta de selección que ofrece múltiples direcciones creativas y un campo de entrada libre, permitiendo al usuario participar profundamente y decidir el rumbo de la historia, evitando regeneraciones repetidas. 3. Sistema de paneles: el agente puede generar y actualizar en tiempo real diversos paneles, como inventario de equipo, mapas SVG, etc., visualizando el proceso de rol. 4. Capacidad de extensión: admite los mecanismos clásicos de skill y MCP del agente, simplificando la implementación de extensiones complejas como la generación de imágenes a partir de texto. 5. Sistema de líneas mundiales: ofrece funciones de guardado a nivel de juego (/store para fijar guardado, /back para retroceder, /line para ver el panorama completo de líneas mundiales). Al retroceder, todo el mundo (texto narrativo, libro mayor de estado, mapa, inventario de equipo, montaje de base de conocimiento) regresa consistentemente a ese punto temporal, con guardado sin pérdida. 6. Base de conocimiento y biblioteca de recursos: admite bases de conocimiento personalizadas creadas conjuntamente por el agente y el usuario; la biblioteca de recursos almacena los archivos e imágenes subidos en una carpeta VPS, adjuntando solo la ruta en los mensajes, reduciendo el consumo de contexto. 7. Gobernanza dividida de doble agente: el modelo de trama se centra en la actuación, un agente «asistente» independiente maneja asuntos del sistema (diagnosticar calidad de respuestas, ajustar configuración, corregir libro mayor, etc.), el asistente puede especificar un modelo por separado y nunca escribe el texto narrativo. En cuanto a compatibilidad: admite importación directa de tarjetas PNG y JSON (incluido libro mundial incrustado en la tarjeta), importación de libros mundiales JSON (luz azul activación constante / luz verde activación por palabra clave), importación de registros de chat antiguos jsonl para continuar jugando (limpieza automática que elimina barras de estado antiguas y cadenas de pensamiento), importación de presets (incluido motor de variables), scripts regex (compatibilidad con los de embellecimiento de visualización), ejecución en sandbox HTML/JS de tarjetas de programa. No es compatible con STscript completo, reescritura directa del texto narrativo desde la interfaz, ni complementos frontend que dependan del DOM/tema de Tavern. El proyecto no utiliza ningún código de SillyTavern e implementa el análisis de formatos de forma independiente según especificaciones públicas. Los métodos de despliegue incluyen script de instalación con un clic (servicio systemd), Docker Compose, empaquetado manual y subida, requiriendo Node.js≥22 y una API Key compatible con OpenAI. La licencia es PolyForm Noncommercial 1.0.0, con código fuente abierto para uso personal y no comercial.