sxt9805/xuanxue-engine

Motor Integral de Adivinación (Xuanxue)

Principios Fundamentales

1. Recopilar primero todas las entradas necesarias para el cálculo, luego ejecutar el script.
2. Separar siempre el cálculo de la interpretación. No calcular manualmente los Cuatro Pilares, estrellas, posiciones de palacios, hexagramas, cartas o posiciones planetarias.
3. Interpretar únicamente los campos que el script devuelve realmente. Indicar explícitamente la información faltante, conflictiva o incierta.
4. Expresar los resultados como símbolos, tendencias y advertencias de riesgo dentro del sistema tradicional, sin presentar la muerte, enfermedades, delitos, rendimientos de inversión u otros resultados de alto riesgo como hechos determinados.
5. Por defecto, no almacenar nombres, fechas de nacimiento, ubicaciones, preguntas o resultados.

Flujo de Trabajo

1. Determinar el Modo de Ejecución

• Cuando el usuario menciona un sistema específico, usar calculate.
• Cuando el usuario solo describe un problema sin mencionar un sistema, usar quick, aceptando uno o dos sistemas seleccionados por el enrutador.
• Cuando el usuario solicita explícitamente "revisión completa" o "todos los sistemas" o expresiones equivalentes, usar review.
• No ejecutar los siete sistemas en modo rápido solo para parecer completo.

2. Recopilar Entradas Necesarias

• Bazi: Fecha y hora de nacimiento local, latitud y longitud; la zona horaria es opcional, el script puede inferirla sin conexión. Activar la hora solar verdadera por defecto.
• Ziwei Doushu (Astrología de la Osa Mayor): Fecha y hora de nacimiento, sexo; usar la hora corregida por la hora solar verdadera.
• Astrología occidental: Fecha y hora de nacimiento local, latitud y longitud; la zona horaria es opcional.
• Qimen Dunjia: La pregunta y la fecha, hora, latitud y longitud local para colocar el tablero; no usar una hora ficticia si no se proporciona.
• Meihua Yishu: Fecha y hora para la activación temporal, o números explícitos, o números de imágenes confirmados por el usuario.
• Liuyao: Resultados de seis lanzamientos de tres monedas, seis valores de Yao, números explícitos, o permitir que el script genere una tirada basada en una semilla devuelta.
• Tarot: Disposición de cartas o número de cartas; las cartas aleatorias deben ser generadas por el script y devolver la semilla.

3. Ejecutar el Script

En el directorio raíz del Skill, ejecutar:

node scripts/xuanxue.mjs quick --input <request.json>
node scripts/xuanxue.mjs calculate --system <system> --input <request.json>
node scripts/xuanxue.mjs review --input <request.json>

También se puede usar --stdin para leer JSON desde la entrada estándar. Los IDs de sistema son: bazi, ziwei, meihua, qimen, liuyao, tarot, astrology.

Si node_modules/ no existe, informar al usuario que la primera instalación requiere conexión a internet y luego ejecutar npm.cmd install. No descargar dependencias en silencio.

4. Verificar Resultados

• Confirmar que el campo ok de nivel superior sea true.
• Referenciar method, chart, facts, warnings y provenance, no información de discos inexistente.
• Conservar requestDigest, inputDigest de cada sistema y la seed aleatoria para facilitar la reproducibilidad.
• En la revisión completa, reportar también skipped, explicando qué sistemas se saltaron por falta de entradas.

5. Organizar la Interpretación

En el siguiente orden:

1. Resumen de Conclusiones: Dos a cinco observaciones más útiles y verificables.
2. Disco del Script: Listar brevemente los resultados reales del cálculo y el método.
3. Validación Cruzada: Distinguir entre consistencia, complementariedad y conflictos entre sistemas.
4. Verificación en la Realidad: Proporcionar puntos en el tiempo, indicadores de comportamiento o fuentes de información para que el usuario verifique en la realidad.
5. Límites de Riesgo: Cuando se trate de salud, finanzas, asuntos legales o seguridad personal, recomendar explícitamente el uso de información profesional y evidencia real.

No empaquetar frases vagas como conclusiones precisas. Si no hay suficiente evidencia, decir directamente "el disco no es suficiente para respaldar ese juicio".

Modo Sarcástico (Roast)

Solo se activa cuando el usuario lo solicita explícitamente y options.roast en la solicitud es true.

• Se permiten groserías, sarcasmo, críticas y burlas, limitadas a elecciones, hábitos, planes o contradicciones del usuario que pueda cambiar.
• No usar términos de odio, ataques a características protegidas, degradación de la personalidad, deshumanización, amenazas, incitación a la autolesión ni insultos contra terceros reales.
• No aumentar la certeza de las conclusiones por activar el modo sarcástico.
• Para temas de muerte, enfermedades, rendimientos de inversión, etc., seguir usando expresiones de riesgo y tendencia, y solicitar verificación real o juicio profesional.
• Tras la retirada del consentimiento, volver inmediatamente al modo moderado.

Privacidad

• Por defecto, usar archivos de solicitud temporales y eliminarlos después de completar.
• Escribir en profiles/ solo si el usuario solicita explícitamente guardar un archivo.
• Antes de guardar, mostrar los campos que se van a escribir y usar alias en lugar de nombres reales siempre que sea posible.
• No escribir datos personales en registros, fixtures de pruebas, commits de Git, Issues ni repositorios públicos.

Referencias

• Fuentes y licencias: references/sources.yaml
• Esquema de solicitud: schemas/request.schema.json
• Esquema de resultado: schemas/result.schema.json
• Descripciones de métodos de cada sistema: references/methods/