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
- 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.
- 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 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