# Quizzman Insight – 八字计算引擎
## 基于Quizzman历法与天文内核的子平八字计算系统

- HTML 白皮书：https://insight.quizzman.com/tool/about-bazi-zh
- 八字排盘工具：https://insight.quizzman.com/bazi-chart
- Markdown文档（本文件）：https://insight.quizzman.com/tool/about-bazi-zh.md
- 历法基础设施：https://calendar.quizzman.com
- 引擎审计报告：https://insight.quizzman.com/tool/about-bazi-audit
- 语言：简体中文 (`lang=zh-CN`)

---

## 架构核心原则

> **核心原则：** BaZi Engine不仅是一个排盘工具，而是**直接构建于Quizzman独立历法与天文计算基础之上的专业命理计算应用**。系统将经典子平命理学原理与天文学行星模型、连续时间标准化和现代数据处理深度融合，确保命盘推算具备严密的一致性与可验证性。

Quizzman Insight – BaZi Engine是Quizzman学术研究生态系统中开发的子平八字（四柱八字）排盘与结构分析系统。区别于市面上仅将公历生日简单机械映射为干支符号的民用万年历工具，BaZi Engine专注于各柱生成的精密天文天象依据、严格的时间判定界限以及全透明的算法可核验性。

系统采用 **Quizzman Calendar Engine（历法引擎）** 作为底层基础设施，确保太阳视黄经天文演算与八字各层级分析组件之间的高度严谨与完全统一。

---

## 1. 什么是子平八字？

八字（四柱）是源于东方的传统命理模型，依据出生时间的四个基准维度推导出八个天干地支符号：

| 柱位 | 干支构成 | 天文推演依据与传统象征 |
| :--- | :--- | :--- |
| **年柱** | 生年的天干与地支 | 严格以天文学**立春（太阳视黄经315°）**交节时刻为准换年。代表祖先根基、祖德、幼年生活背景。 |
| **月柱** | 生月的天干与地支 | 依据**二十四节气**确定（以立春建寅开始）。代表父母、社会环境、生月提纲及五行司令（月令气数）。 |
| **日柱** | 生日的天干与地支 | 日干称为**日主（日元）**，代表当事人自身核心；日支为配偶宫（夫妻宫）。 |
| **时柱** | 生时的天干与地支 | 依真太阳时结合日干推算（五鼠遁法）。代表子女、晚景归宿及隐秘内心世界。 |

由此四柱八字，子平系统衍生出阴阳五行平衡、十神生克、地支藏干分布、大运起运流转等核心分析架构。

---

## 2. 历法底座：Quizzman Calendar Engine

八字推算最为核心的前提，在于其底层支撑的时间与历法系统。Quizzman Calendar是一个**独立的高精度天文历法计算引擎**。

- 访问 Quizzman Calendar：https://calendar.quizzman.com

### 2.1. 基于天文模型的精密计算
- **VSOP87行星理论：** 计算太阳视黄经（$\lambda_\odot$），精确求解各节气交接时刻。
- **儒略日（Julian Day）：** 采用天文学连续时间标尺，消除历史改历跳日断层，保证六十甲子周期不间断回溯。
- **二十四节气：** 依据太阳视黄经每行进15°精确定位，拒绝固定日期粗略推算。
- **日月合朔：** 结合经纬度地理时区推算日月合朔时刻。
- **历史法定时区：** 追踪越南及东亚各历史时期夏令时与标准时区变迁。

### 2.2. 为什么节气对八字至关重要？
在正统子平命理中，**八字年份和月份的交替界限，绝非跟随农历正月初一春节，亦非公历元旦**：
- **年柱：** 必须以**立春**交节时刻为界。
- **月柱：** 严格以十二个中气节气交接为界（立春建寅，惊蛰建卯...）。

*边界案例：* 公历**2026年2月3日**，因尚未到达2026年立春交节时刻，在八字中依然属于**乙巳年（蛇年）**。

---

## 3. BaZi Engine 核心功能模块

- **四柱八字排盘：** 准确输出年、月、日、时四柱八字及纳音属性。
- **十神全矩阵分析：** 比肩、劫财、食神、伤官、偏财、正财、七杀、正官、偏印、正印，涵盖100组全组合映射。
- **地支藏干权重：** 十二地支藏干（本气、中气、余气）及百分比权重。
- **五行旺衰量化：** 量化金木水火土得分，评估平衡倾向与基础用神。
- **精密大运排盘：** 年干阴阳配合性别判定顺逆；按三日折合一年计算起运岁数。
- **26种规范神煞：** 天乙贵人、文昌、驿马、桃花、华盖、羊刃、天德、月德等。
- **干支刑冲合害：** 天干五合、地支六合、三合、六冲、相刑、相害自动识别。

---

## 4. 计算流程与分层架构

### 处理流程：
```
出生年月日时与时区
       │
       ▼
连续儒略日与UTC+7标准化
       │
       ▼
VSOP87太阳黄经与节气解算
       │
       ▼
立春定年 · 节气定月 · 儒略日定日 · 五鼠遁定时
       │
       ▼
地支藏干展开与五行能量矩阵
       │
       ▼
十神映射 · 大运顺逆推算 · 26神煞查验
       │
       ▼
规范结构化数据输出 (UI / REST API)
```

### REST API 接口：
- `POST /api/tool-module/bazi/calculate` — 计算完整八字命盘
- `GET /api/tool-module/bazi/ten-gods` — 十神对照矩阵
- `GET /api/tool-module/bazi/hidden-stems/:chi` — 指定地支藏干及权重
- `POST /api/tool-module/bazi/luck-pillars` — 大运起运岁数与干支序列
- `POST /api/tool-module/bazi/shen-sha` — 命盘神煞列表
- `POST /api/tool-module/bazi/compatibility` — 八字配对分析

---

## 5. 算法准确度与测试验证

根据2026年2月公布的自动化内部回归测试结果：

| 测试组件 | 内部测试结果 | 覆盖范围 |
| :--- | :--- | :--- |
| **BaZi Engine** | **128/128 测试项全部通过** | 四柱排盘、立春交界、节气换月、十神、藏干、大运、神煞 |
| **Calendar Engine** | **108/108 测试项全部通过** | UTC+7天文同步、闰月推算、太阳黄经及极值节气点 |
| **十神矩阵** | 100/100 组合全覆盖 | 10天干日主与10客干全排列 |
| **地支藏干** | 12/12 地支全覆盖 | 十二地支藏干百分比分布 |
| **神煞系统** | 26种标准神煞 | 各种触发条件逻辑全部校验 |

> **测试基准的技术含义：**
> **“128/128项内部测试通过”**表明在发布时，引擎完全满足内部回归测试集中设定的所有工程边界与算法条件。
>
> **这一结果并不等同于宣称在所有历史古籍、不同流派异本或主观推演层面具备“绝对100%的唯一正确性”。**
>
> Quizzman坚持持续扩充测试样本，正积极筹备引入第三方独立基准库（如计划与独立合作方 *Jade Almanac* 进行交叉对验）。

---

## 6. 经典文献基础

1. **《渊海子平》：** 徐升（徐子平遗法），确立以日干为主的根本原则。
2. **《三命通会》：** 万民英，命理集大成之作，广泛收录神煞谱系与格局。
3. **《滴天髓》：** 京图原著/刘基注，五行体用与全局气势流转精论。
4. **《子平真诠》：** 沈孝瞻，月令取用与格局成败救应准则。
5. **《穷通宝鉴》：** 余春台辑，五行四时调候学说宝典。

---

## 7. 适用范围与边界声明

1. **历法天文计算：** 节气时刻、阴阳历转换、时区偏差属于严谨的天文几何与数学范畴，具备完全客观的可复验性。
2. **传统命理推演：** 性格或发展趋势表述属于传统符号文化分析体系，**绝非实证科学的确定性因果结论**。

**Quizzman绝不宣称具备预言人类命运的能力。** 工具旨在提供精确的数据与计算方法，供学术研讨与个人修养参考。

---

## 探索 Quizzman Insight – BaZi Engine

- **八字排盘工具：** https://insight.quizzman.com/bazi-chart
- **Quizzman Calendar：** https://calendar.quizzman.com
- **Quizzman Wiki：** https://wiki.quizzman.com
- **Quizzman Insight Hub：** https://insight.quizzman.com

*Quizzman Insight – 现代计算工程承载东方传统数理。*
*© 2026 Quizzman. All rights reserved.*