Método e limites
Cálculo, evidências, interpretação, validação
Esta explicação descreve como fazemos o mapa e a leitura, quais critérios adotamos, em quais conclusões há divergência entre escolas e o que claramente não fazemos. Ela deve ser verificável, não um texto de marketing.
Fluxo em quatro camadas
- 01
Cálculo: o mapa é gerado por algoritmo
Conversão de calendário, momentos dos termos solares, fuso horário, correção do tempo solar verdadeiro, os quatro pilares (troncos e ramos), troncos ocultos, direção dos ciclos decenais (Da Yun) e momento de início — tudo é calculado por algoritmo determinístico e gravado em campos estruturados. O modelo de linguagem não participa desta etapa e não tem permissão para inferir os quatro pilares diretamente a partir da data de nascimento.
- 02
Evidências: toda conclusão precisa listar sua base
A força do Mestre do Dia, a configuração dos Dez Deuses, combinações, conflitos, punições e danos, ajuste climático e estrutura (ge ju) são emitidos como itens de evidência verificáveis um a um: qual comando sazonal (yue ling), onde há raiz de apoio (tong gen), qual tronco-ramo foi acionado. A pontuação é apenas uma expressão interna dessas evidências, não o julgamento em si.
- 03
Interpretação: a IA é responsável pela expressão, não pelo cálculo
O modelo de linguagem transforma evidências estruturadas em uma explicação legível, indicando as condições de aplicação das conclusões. Quando há divergência entre escolas, explicamos o ponto de divergência e a prioridade adotada no momento, em vez de apresentar uma delas como a única resposta correta.
- 04
Validação: verificação de consistência e limites antes da saída
Depois que a interpretação é gerada, verificamos se ela pode ser rastreada até itens de evidência estruturados e filtramos conteúdo de alto risco conforme os limites temáticos. A verificação de consistência (Deus Útil, Deus Favorável, Deus Desfavorável e Deus Inimigo sendo todos distintos entre si) é uma restrição rígida da camada de seleção de uso: se o elemento auxiliar indicado pela tabela de ajuste climático coincidir com o 「gerador do Deus Desfavorável」, ele é reatribuído conforme a definição funcional, e fazemos validação de regressão em todas as 120 combinações de Mestre do Dia × ramo do mês.
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
- v102026-10-19
夏令时地点判定重写;流年与生年口径统一
Affects: Zi Wei Dou Shu
两处修正。其一,1986-1991 夏令时归一的地点判定此前要求出生地正向命中一份 85 城市的短表,导致两类错误:台湾「彰化县中山路」因为含有「中山」(广东中山)被误扣 1 小时;而洛阳、保定、唐山等未收录的大陆城市、繁体写法「廣州」、英文写法「Beijing」则一直没有归一,等于夏令时修正对这批用户未生效。现改为四级判定:港澳台优先豁免 → 国际城市豁免 → 大陆省级行政区 → 388 个大陆城市,都不命中则不归一(与此前一致,不引入新错误)。其二,流年干支此前仍按立春换年,而生年已按正月初一换年,每年春节与立春之间会出现本命盘与流年盘口径不一致;现统一为农历年,流年四化与本命同源。
- v92026-10-18
1986-1991 中国大陆夏令时归一
Affects: Zi Wei Dou Shu
中国大陆在 1986-1991 年实行夏令时,期间钟表比标准时间快 1 小时。当年夏令时期间出生的用户在表单里填的是壁钟时间,此前系统直接拿去排盘,会把时辰整体排错一档(例:1988 年 7 月某日填 14:30,实际标准时间是 13:30,未时被排成午时一段)。现按 IANA 时区数据库的权威边界(起止逐日核对,其中 1989 年结束日为 9 月 17 日——网间常见的 9 月 10 日是以讹传讹)自研归一层:出生地为中国大陆已知城市、且时间落在夏令时窗口内,排盘前自动减去 1 小时;港澳台当年未实行夏令时,不在归一范围。1986-1991 大陆夏令时期间出生用户的紫微存量盘打开时会自动重算修复。
- v82026-10-18
紫微生年干支改按正月初一换年(古法主流口径)
Affects: Zi Wei Dou Shu
此前紫微与八字都按立春换年干——那是八字的口径。紫微安星以农历生日为基础,生年四化理应跟农历年:《紫微斗数全书》古法、中州派、文墨天机、倪海厦均按正月初一换年。影响范围是每年春节与立春之间出生的用户(1950-2026 合计约占生日的 2%):此前他们的年柱排为上一年的立春年干,生年四化随之偏移。判定依据是 renhuai v4.0 开源数据集(CC BY 4.0)9 个分布位年份 78,864 盘的交叉验证——按正月初一换年口径与我方引擎 100% 一致,按立春口径在窗口内全部不一致。这些用户的紫微盘与流年解读将在打开时自动重算;八字模块不受影响(八字年柱按立春是正统)。落在分歧窗口内的排盘,结果页会标注两派各排什么年。
- 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.
Critérios que adotamos
No BaZi existem várias práticas tradicionais igualmente fundamentadas. Nosso princípio é fixar um conjunto, documentá-lo e permitir verificação, em vez de usar regras diferentes em páginas diferentes.
- Base temporal
- Por padrão, usamos o horário de relógio informado. O tempo solar verdadeiro é uma correção opcional: só é ajustado por longitude e equação do tempo quando está ativado e a longitude do local de nascimento é fornecida, com o horário corrigido registrado no resultado.
- Normalização do horário de verão 1986-1991
- A China continental adotou o horário de verão entre 1986 e 1991 (relógios uma hora adiantados). Quando o local de nascimento corresponde a uma cidade conhecida do continente e o horário informado cai dentro de uma janela de horário de verão, subtraímos uma hora para devolvê-lo à hora padrão antes de calcular a carta. Hong Kong, Macau e Taiwan nunca adotaram a política e não são afetados. Na noite em que o horário de verão terminava, os relógios atrasavam uma hora e o intervalo 01:00-01:59 ocorria duas vezes; os registros de nascimento não permitem saber qual, então tratamos sempre como a primeira ocorrência (horário de verão). O impacto é de cerca de uma hora por ano.
- Limite do pilar do ano
- A troca ocorre no momento exato do Início da Primavera (Li Chun), não no primeiro de janeiro nem no Ano Novo Lunar.
- Limite do ano de nascimento no Zi Wei
- O Zi Wei Dou Shu difere deliberadamente do BaZi neste ponto: a colocação das estrelas parte do aniversário lunar, de modo que as transformações do ano de nascimento seguem o ano lunar e mudam no primeiro dia do primeiro mês lunar (a leitura clássica do 《Zi Wei Dou Shu Quan Shu》, compartilhada pela escola Zhongzhou). O BaZi rege o mês pelos termos solares, então seu pilar do ano muda em 立春. Nos dias entre o Ano Novo Lunar e 立春 de cada ano (em média 2% dos aniversários entre 1950 e 2026), as duas escolas produzem transformações diferentes; para cartas nessa janela indicamos direto no resultado que ano cada escola lê.
- Limite do pilar do mês
- A troca ocorre no momento exato dos doze nós (termos solares), independentemente do mês lunar.
- Troca de dia na hora Zi
- Considerar a hora Zi tardia como pertencente ao dia atual ou ao dia seguinte é uma divergência entre escolas, e ambas as práticas têm adeptos. Nossa implementação fixa uma regra e mantém consistência; se você costuma usar a outra, o pilar do dia e os Dez Deuses vão se deslocar como um todo, e isso pode servir para conferir a diferença.
- Força e seleção de uso
- Suporte e restrição (fu yi) e ajuste climático (tiao hou) são calculados separadamente, e **as conclusões das duas camadas são apresentadas no resultado do mapa**. Quando apontam para direções diferentes, explicamos o ponto de divergência, qual camada está sendo adotada no momento e por que essa escolha. A diferença em si não é erro: o suporte e a restrição perguntam se o Mestre do Dia consegue sustentar a carga, enquanto o ajuste climático pergunta sobre o frio, o calor, a secura e a umidade da estação — duas perguntas diferentes.
- Mapas no limiar
- A força do Mestre do Dia é obtida somando vários ajustes em uma pontuação bruta e depois enquadrando-a nas faixas 75 / 60 / 40 / 25. Quando a pontuação bruta cai dentro de 3 pontos de um limiar, marcamos isso diretamente no resultado do mapa, em duas categorias: quando cruzar o limiar muda para outro conjunto de seleção (com os Cinco Deuses mudando junto) e quando apenas muda o nome do nível. O enquadramento não é inferência — o ramo de seleção de uso foi extraído como uma função pura que pode ser avaliada para um nível hipotético; calculamos uma vez os Cinco Deuses completos (Deus Útil / Deus Desfavorável / Deus Favorável / Deus Inimigo / Deus Neutro) em cada lado do limiar e comparamos termo a termo. Na prática, cerca de 40% dos mapas caem dentro da tolerância de 3 pontos de algum limiar.
O que não fazemos
Saúde
Não fornecemos diagnóstico de doenças, avaliação de estado físico ou recomendações de tratamento. Para questões de saúde, consulte profissionais de saúde.
Investimentos e finanças
Não fornecemos pontos de compra e venda de ações, fundos ou criptomoedas, nem prevemos preços específicos. Decisões financeiras devem se basear em informações financeiras regulamentadas.
Jurídico
Não fornecemos opinião jurídica nem julgamos o resultado de processos.
Segurança pessoal
Não fazemos afirmações sobre perigos, acidentes ou longevidade; para questões de segurança, procure ajuda profissional no mundo real.
Decisões importantes de vida
Não apresentamos conclusões de leitura de destino como base única para decisões de casamento, imigração, pedido de demissão etc.
Previsões determinísticas
Não prometemos datas nem resultados de eventos específicos. Em nosso posicionamento, a metafísica chinesa é um quadro de referência da cultura tradicional; não afirmamos que ela tenha validade científica moderna.
Limitações conhecidas
- Quando o horário de nascimento não é preciso, a confiabilidade das conclusões ligadas ao pilar da hora cai bastante — especialmente perto das fronteiras entre as horas chinesas (shichen) ou entre termos solares.
- As divergências entre escolas não podem ser “resolvidas”, apenas explicitadas. Sinalizamos onde há divergência, em vez de escondê-la.
- Sinalizamos os mapas limítrofes, mas **sinalizar não significa que a conclusão ficou mais sólida**: quando a pontuação fica perto do limiar, basta trocar o conjunto de pesos para chegar à direção oposta do elemento útil, e essa incerteza não pode ser eliminada, só explicada com clareza. Esse nível — “cruzar o limiar muda ou não o elemento útil?” — é **calculado mapa por mapa**, não estimado — mas ainda assim é apenas a resposta dentro do critério atual.
- Em algumas combinações de ajuste climático, o rótulo de elemento nocivo é definido por um recuo funcional (os cinco elementos clássicos de apoio ao ajuste climático são preservados prioritariamente como elemento favorável), o que difere um pouco da definição estrita de “quem gera o elemento desfavorável”; para essas combinações, tome como referência o campo “Base da escolha do elemento útil”.
- As explicações da IA podem apresentar imprecisões de redação. Se alguma explicação não tiver respaldo na camada de evidências, tome como referência o mapa calculado e os campos de evidência.
- Aceitamos correções: se você encontrar um erro no cálculo do mapa ou nas regras, envie pelo canal de feedback e nós o corrigiremos nas próximas versões.
Perguntas frequentes
A IA pode errar o cálculo do BaZi?
O cálculo do mapa é feito por algoritmos determinísticos e gravado em campos estruturados, o que permite conferir item por item. A IA cuida apenas da camada de interpretação; por isso, erro de cálculo e desvio de interpretação são dois tipos de problema — o primeiro pode ser reproduzido e verificado, o segundo pode ser checado pela camada de evidências.
Por que não dá para calcular o mapa só com um grande modelo de linguagem?
A conversão do calendário, os horários dos termos solares e a correção de fuso horário dependem de regras precisas e dados históricos, que um modelo de linguagem não consegue reproduzir de forma consistente. Deixar o cálculo determinístico a cargo de algoritmos é o ponto-chave para reduzir erros não reproduzíveis.
O resultado de vocês é diferente do de um especialista em BaZi. Quem está certo?
Na maioria dos casos é diferença de critérios, não erro de cálculo. As divergências mais comuns vêm do uso ou não do horário solar verdadeiro, da regra de virada do dia na hora Zi, dos pesos de força e fraqueza e do referencial de escolha dos elementos. Tudo pode ser conferido item por item; publicamos as regras adotadas na página de metodologia.
Como vocês lidam com as divergências entre escolas?
Explicitamos os pontos de divergência e a prioridade adotada no momento. As duas camadas — equilíbrio (sustentar/restringir) e ajuste climático — são calculadas e apresentadas no resultado: quando coincidem, indicamos que a conclusão é corroborada por dois caminhos independentes; quando divergem, mostramos o que cada uma conclui, qual camada está sendo usada no momento e por que essa escolha.
E se as duas camadas chegarem a conclusões contraditórias?
Que elemento útil, elemento favorável, elemento desfavorável e elemento nocivo sejam todos diferentes entre si é uma restrição rígida da camada de escolha dos elementos, e todas as 120 combinações de Mestre do Dia × Ramo do Mês têm cobertura de regressão; se dois deles se igualarem, tratamos como defeito e corrigimos.
Vocês tratam o resultado como uma previsão científica?
Não. Em nosso posicionamento, a metafísica chinesa é um quadro de referência da cultura tradicional; não fazemos afirmações sobre seu caráter científico nem incentivamos que ela substitua julgamentos profissionais na vida real.
Termos relacionados
- Hora de nascimento, fuso horário e tempo solar verdadeiro: acerte o horário antes de montar o BaZi
- Como avaliar a força do Mestre do Dia: força não é pontuação
- Como entender os elementos favoráveis e úteis: não é 「completar o que falta」
- O que é Tiao Hou: por que frio, calor, secura e umidade entram na leitura do BaZi
Método e limites · 2026-09-20