# Quizzman Insight – 八字計算引擎
## 基於Quizzman曆法與天文核心的子平八字計算系統

- HTML 白皮書：https://insight.quizzman.com/tool/about-bazi-zht
- 八字排盤工具：https://insight.quizzman.com/bazi-chart
- Markdown文檔（本文件）：https://insight.quizzman.com/tool/about-bazi-zht.md
- 曆法基礎設施：https://calendar.quizzman.com
- 引擎審計報告：https://insight.quizzman.com/tool/about-bazi-audit
- Quizzman Paper (QPS-ISO 1.0)：https://paper.quizzman.com/papers/QP-BAZI-001/zht/
- 語言：繁體中文 (`lang=zh-Hant`)

---

## 架構核心原則

> **核心原則：** 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.*