Método y límites
Cálculo, evidencia, interpretación, validación
Esta explicación detalla cómo hacemos el cálculo de la carta y la interpretación, qué criterios seguimos, en qué conclusiones hay diferencias entre escuelas y qué no hacemos deliberadamente. Debe ser verificable, no un texto de marketing.
Proceso en cuatro capas
- 01
Cálculo: la carta se genera con algoritmos
La conversión del calendario, los momentos de los términos solares, la zona horaria, la corrección por hora solar verdadera, los troncos y ramas de los cuatro pilares, los troncos ocultos, la dirección de los ciclos de suerte y el momento de inicio de dichos ciclos se calculan con algoritmos deterministas y se escriben en campos estructurados. El modelo de lenguaje no participa en este paso ni puede inferir los cuatro pilares directamente a partir de la fecha de nacimiento.
- 02
Evidencia: cada conclusión debe poder enumerar sus fundamentos
La fuerza del Amo del Día, la configuración de los Diez Dioses, las combinaciones, choques, castigos y daños, el ajuste climático y el patrón se muestran como elementos de evidencia revisables uno por uno: qué rama mensual, qué punto de enraizamiento, qué tronco o rama se activa. La puntuación solo es una expresión interna de esa evidencia, no el juicio en sí.
- 03
Interpretación: la IA redacta, no calcula
El modelo de lenguaje convierte la evidencia estructurada en una explicación legible e indica las condiciones en que se aplican las conclusiones. Cuando hay diferencias entre escuelas, explicamos los puntos de divergencia y la prioridad que adoptamos, en lugar de presentar una de ellas como la única respuesta correcta.
- 04
Validación: comprobación de coherencia y límites antes de la salida
Una vez generada la interpretación, comprobamos que se pueda rastrear hasta elementos de evidencia estructurados y filtramos el contenido de alto riesgo según los límites temáticos. La validación de coherencia (Dios Útil, Dios Favorable, Dios Desfavorable y Dios Enemigo son mutuamente distintos) es una restricción estricta de la capa de selección del Dios Útil: si el elemento auxiliar que indica la tabla de ajuste climático coincide con el que «genera al Dios Desfavorable», se reasigna según la definición funcional y se verifica por regresión en las 120 combinaciones de Amo del Día × rama mensual.
Engine version and changelog
Every algorithm fix that changes computed output bumps the engine version and is recorded here. A saved chart whose version no longer matches the current one is treated as stale and recomputed — using the same birth details stored alongside it, so conventions such as true solar time are not lost. In the rare case where an early record lacks the fields needed (year, month, day, hour, minute) it cannot be recomputed faithfully, so we keep the original chart rather than guess at one. Copy and layout changes do not bump the version.
Changelog
- v52026-09-25
黄历吉时判定改用黄道黑道十二神
Affects: Almanac
此前吉时是按「当日宜的条数多于忌的条数」推断的，方向性是错的：实测 2026-09-25 会把 5 个黑道时辰列为吉时，反而把当天唯一的青龙黄道时辰（庚子）列为凶时。现改为按十二值神的黄道/黑道属性判定；引擎异常时返回 degraded 标记，页面显示「暂无数据」而不是编造吉时。同一天还把 Web 端与引擎包里逐行相同的两份黄历实现合并为一份，避免两端算出不同结果。
- v42026-09-20
年柱改以立春为界，闰月盘与平月盘分开缓存
Affects: BaZi · Zi Wei Dou Shu
年柱此前按农历正月初一切换，导致立春到春节之间出生的人年柱错误；现以立春为界。同时紫微斗数的缓存 key 加入 isLeapMonth —— 此前闰月盘与平月盘共用同一个 key，会互相污染（缓存版本因此从 v3 提到 v4）。
- v32026-09-20
时干改用五鼠遁
Affects: BaZi
部分时辰的时干存在偏移，现统一按五鼠遁由日干推时干。
- v22026-09-20
修复 computeBaziAccurate 在特定输入下崩溃
Affects: BaZi
特定出生信息组合会让排盘函数直接抛错，导致整个结果页不可用。
- v12026-09-20
引入引擎版本号（回溯起点）
Affects: All
此前没有版本概念，缓存失效靠人工改字符串。v1 是补记的起点，用于让后续版本号有参照。
Reproducible verification
These numbers can be reproduced directly — the commands live in the repository. We also pin known deviations with tests: a test list that only reports passes is not informative; one that states exactly where we differ is.
- Engine regression tests (divination-core, bun test)
- 110
- Web and mobile tests (bun test lib apps/mobile) · 29 files
- 215
Total: 325 · 2026-09-29
What the tests pin down
- Day-pillar anchor: 1949-10-01 = 甲子. The old implementation returned 庚申/戊子 and drifted with the host time zone.
- Every 子 hour's stem follows the five-rat rule. The old implementation got the stem wrong for *every* 子 hour because of a rotated-array index error (a 癸 day's 子 hour should be 壬子; it returned 甲子).
- The year pillar switches at 立春, not at the lunar new year.
- Leap-month birthdays must land on the leap month itself. Measured on 2023 leap second month, day 20: the old implementation was 30 days off and placed palaces differently in the second half of the leap month.
- **Known deviations are pinned explicitly**: 23:00 does not roll the day pillar (early/late 子 hour is a genuine school disagreement; BaZi here uses the 子正 rollover), and solar-term day boundaries use an approximation table rather than a second-precise solar-term instant. These are known, test-recorded behaviours — not undiscovered defects.
Passing tests show the implementation matches the conventions we state. They are not evidence that the method itself is scientifically validated.
Criterios que adoptamos
En BaZi existen varias prácticas tradicionales igualmente fundamentadas. Nuestro principio es fijar un conjunto, documentarlo y permitir su verificación, en lugar de usar reglas distintas en cada página.
- Referencia temporal
- Por defecto se usa la hora de reloj introducida. La hora solar verdadera es una corrección opcional: solo si se activa y se proporciona la longitud del lugar de nacimiento, se ajusta según la longitud y la ecuación de tiempo, y se registra la hora corregida en el resultado.
- Límite del pilar anual
- Cambia en el momento exacto del inicio de la primavera (Li Chun); no usa el 1 de enero ni el Año Nuevo Chino.
- Límite del pilar mensual
- Cambia en el momento exacto de los doce nodos (términos solares), independientemente del mes del calendario lunar.
- Cambio de día en la hora Zi
- Si la hora Zi tardía cuenta como el mismo día o como el día siguiente es una diferencia entre escuelas, y hay quienes usan ambas. Nuestra implementación fija una regla y la mantiene consistente; si estás acostumbrado a la otra, el pilar diario y los Diez Dioses se desplazan en conjunto, y puedes comprobar la diferencia a partir de eso.
- Fuerza y selección del Dios Útil
- La técnica de apoyo y control y el ajuste climático se calculan por separado; **ambas conclusiones se muestran en el resultado de la carta**. Cuando ambos enfoques apuntan en direcciones distintas, explicamos el punto de divergencia, qué capa se adopta y por qué se elige así. La diferencia en sí no es un error: la técnica de apoyo y control pregunta si el Amo del Día puede sostener la carga, y el ajuste climático pregunta por el frío, calor, sequedad o humedad de la estación; son dos preguntas diferentes.
- Cartas límite
- La fuerza del Amo del Día suma varias operaciones de adición y sustracción en una puntuación bruta y luego la clasifica en bandas de 75 / 60 / 40 / 25 puntos. Cuando la puntuación bruta queda dentro de 3 puntos de algún umbral, lo indicamos directamente en el resultado de la carta y distinguimos dos casos: los que al cruzar pasan a otro método de selección (y los cinco dioses cambian en consecuencia) y los que solo cambian el nombre del nivel. La clasificación por bandas no es una inferencia: la rama de selección del Dios Útil se ha extraído como una función pura que puede evaluarse para un nivel hipotético; calculamos una vez los cinco dioses completos (Dios Útil / Dios Desfavorable / Dios Favorable / Dios Enemigo / Dios Neutral) a cada lado del umbral y los comparamos término por término. En pruebas, alrededor del 40% de las cartas cae dentro de la tolerancia de 3 puntos de algún umbral.
Lo que no hacemos
Salud
No ofrecemos diagnósticos de enfermedades, evaluaciones del estado físico ni recomendaciones de tratamiento. Para problemas de salud, consulta a profesionales médicos.
Inversión y finanzas
No ofrecemos puntos de compra o venta de acciones, fondos o criptomonedas, ni predecimos precios concretos. Para decisiones financieras, basate en información financiera regulada.
Legal
No ofrecemos asesoramiento legal ni determinamos el resultado de litigios.
Seguridad personal
No hacemos afirmaciones sobre peligros, accidentes o longevidad; para cuestiones de seguridad, busca ayuda profesional en el mundo real.
Decisiones vitales importantes
No usamos las conclusiones de la lectura como única base para decisiones como el matrimonio, la emigración o la renuncia al trabajo.
Predicciones deterministas
No prometemos fechas ni resultados de eventos concretos. En nuestro enfoque, la astrología china es un marco de referencia de la cultura tradicional y no afirmamos que tenga validez científica moderna.
Limitaciones conocidas
- Cuando la hora de nacimiento no es precisa, la fiabilidad de las conclusiones relacionadas con el pilar de la hora disminuye notablemente; esto es especialmente cierto cerca de los límites de una hora doble o de un término solar.
- Las diferencias entre escuelas no se pueden «resolver», solo explicar. Señalamos los puntos de divergencia en lugar de ocultarlos.
- Las cartas en el límite las señalamos, pero **señalarlas no significa que la conclusión se vuelva más sólida**: cuando la puntuación se acerca al umbral, cambiar el criterio de ponderación puede dar lugar a una dirección opuesta del elemento útil. Esta incertidumbre no se puede eliminar, solo explicar con claridad. Este apartado «si cruzar el umbral cambiaría o no el elemento útil» se calcula **carta por carta**, no es una estimación — pero también es solo la respuesta bajo el criterio actual.
- En algunas combinaciones de ajuste climático, la etiqueta de elemento enemigo se determina por retroceso funcional (los cinco elementos auxiliares clásicos del ajuste climático se conservan prioritariamente como elemento favorable), lo que difiere ligeramente de la definición estricta de «el que genera al elemento desfavorable»; en estas combinaciones, tómese como referencia la «base para la elección del elemento útil».
- La explicación de la IA puede presentar desviaciones de redacción. Si una explicación no encuentra respaldo en la capa de evidencia, prevalecerán el cálculo de la carta y los campos de evidencia.
- Aceptamos correcciones: si encuentras un error en el cálculo de la carta o en las reglas, puedes enviarlo a través del canal de comentarios y lo corregiremos en versiones posteriores.
Preguntas frecuentes
¿La IA puede equivocarse al calcular el BaZi?
El cálculo de la carta lo realiza un algoritmo determinista y se escribe en campos estructurados, por lo que se puede verificar punto por punto. La IA solo se encarga de la capa de interpretación; por lo tanto, los errores de cálculo y las desviaciones de interpretación son dos tipos de problemas: los primeros se pueden reproducir y verificar, y las segundas se pueden revisar mediante la capa de evidencia.
¿Por qué no se puede calcular la carta directamente solo con un modelo de lenguaje grande?
La conversión del calendario, los momentos de los términos solares y la corrección de zona horaria dependen de reglas precisas y datos históricos; un modelo de lenguaje no puede reproducirlos de forma estable. Delegar los cálculos deterministas en un algoritmo es clave para reducir los errores no reproducibles.
Sus resultados no coinciden con los de un maestro de astrología china, ¿quién tiene razón?
En la mayoría de los casos se debe a criterios distintos, no a un error de cálculo. Las diferencias habituales provienen de si se usa la hora solar verdadera, la regla de cambio de día en la hora Zi, las ponderaciones de fuerza y debilidad, y el marco de selección del elemento útil. Se puede verificar punto por punto; publicaremos las reglas adoptadas en la página de explicación del método.
¿Cómo abordan las diferencias entre escuelas?
Explicamos los puntos de divergencia y la prioridad que se adopta actualmente. Tanto la capa de apoyo y restricción como la de ajuste climático se calculan y se muestran en el resultado: cuando coinciden, indica que la conclusión está respaldada por dos caminos independientes; cuando no, se explica qué elige cada una, qué capa se adopta actualmente y por qué se elige así.
¿Qué pasa si las conclusiones de las dos capas se contradicen?
Que el elemento útil, el elemento favorable, el elemento desfavorable y el elemento enemigo no sean iguales entre sí es una restricción dura de la capa de selección del elemento útil. Las 120 combinaciones de Amo del Día × rama mensual tienen cobertura de regresión; si alguna vez resultan iguales entre sí, lo tratamos como un defecto y lo corregimos.
¿Consideran los resultados como una predicción científica?
No. En nuestro enfoque, la astrología china es un marco de referencia de la cultura tradicional; no hacemos afirmaciones sobre su carácter científico ni fomentamos que sustituya el juicio profesional en la vida real.
Términos relacionados
- Hora de nacimiento, zona horaria y hora solar verdadera: ajusta bien la hora antes de calcular el BaZi
- Cómo interpretar la fuerza del Amo del Día: no es una puntuación
- Cómo entender los elementos favorables y útiles: no se trata de «completar lo que falta»
- Qué es el ajuste climático: por qué el frío, el calor, la sequedad y la humedad influyen en el análisis BaZi
Método y límites · 2026-09-20