Quizzman Insight – 八字計算引擎

排八字命盤

基於Quizzman曆法與天文計算基礎的子平八字（四柱八字）計算系統

128/128 八字內部測試通過 108/108 Calendar曆法引擎通過 VSOP87與儒略日天文曆算 100組十神全映射 26種規範神煞查驗 REST API
架構核心原則： BaZi Engine不僅是一個排盤工具，而是直接構建於Quizzman獨立曆法與天文計算基礎之上的專業命理計算應用。系統將經典子平命理學原理與天文學行星模型、連續時間標準化和現代數據處理深度融合，確保命盤推算具備嚴密的一致性與可驗證性。

Quizzman Insight – BaZi Engine是Quizzman學術研究生態系統中開發的子平八字（四柱八字）排盤與結構分析系統。區別於市面上僅將公曆生日簡單機械映射為干支符號的民用萬年曆工具，BaZi Engine專注於各柱生成的精密天文天象依據、嚴格的時間判定界限以及全透明的演算法可核驗性。

系統採用 Quizzman Calendar Engine（曆法引擎） 作為底層基礎設施，確保太陽視黃經天文演算與八字各層級分析組件之間的高度嚴謹與完全統一。

1. 什麼是子平八字（四柱八字）？

八字，亦稱四柱或子平術，是源於東方的傳統命理模型，依據出生時間的四個基準維度推導出八個天干地支符號：

柱位 干支構成 天文推演依據與傳統象徵
年柱 生年的天干與地支 嚴格以天文學立春（太陽視黃經315°）交節時刻為準換年。代表祖先根基、祖德、幼年生活背景。
月柱 生月的天干與地支 依據二十四節氣確定（以立春建寅開始）。代表父母、社會環境、生月提綱及五行司令（月令氣數）。
日柱 生日的天干與地支 日干稱為日主（日元），代表當事人自身核心；日支為配偶宮（夫妻宮）。
時柱 生時的天干與地支 依真太陽時結合日干推算（五鼠遁法）。代表子女、晚景歸宿及隱秘內心世界。

由此四柱八字，子平系統衍生出陰陽五行平衡、十神生剋、地支藏干分佈、大運起運流轉等核心分析架構。

Quizzman BaZi Engine實現了這一整套計算流程的全面自動化與規範化，便於研究者按確鑿的規則深入查證命盤的數理結構。

2. 曆法底座：Quizzman Calendar Engine

八字推算最為核心的前提，在於其底層支撐的時間與曆法系統。

Quizzman Calendar並非普通的靜態陰陽曆查閱界面，而是一個獨立的高精度天文曆法計算引擎。它基於精密的天體力學理論與位置模型開發，為Quizzman生態系統中的所有命理與天文工具提供嚴謹的干支週期、精確節氣及歷史時間校正服務。

Quizzman Calendar Engine 曆算基礎設施

統一服務於八字、紫微斗數、易經周易及天文觀象台的核心曆算法則，內部自動化測試108/108項全通過。

探索 Quizzman Calendar 引擎

2.1. 基於天文模型的精密計算

引擎集成了多項現代天文計算法則：

  • VSOP87行星攝動理論： 計算太陽視黃經（$\lambda_\odot$），精確求解各節氣交接點，達到分鐘級的高精度解析度。
  • 儒略日（Julian Day）： 採用天文學連續時間標尺，消除了歷史上改曆（如1582年格里曆改曆跳日）造成的干支斷層，保證六十甲子週期不間斷回溯。
  • 二十四節氣： 依據太陽視黃經每行進15°精確定位，拒絕傳統民用曆按固定日期粗略推算的誤差。
  • 日月合朔與朔望月： 結合各經緯度地理時區嚴格推算日月合朔時刻。
  • 歷史法定制度時區： 包含越南及東亞各歷史時期夏令時與標準時區演變數據庫（如GMT+7、GMT+8、GMT+9）。

2.2. 為什麼節氣對八字至關重要？

在正統子平命理中，八字年份和月份的交替界限，絕非跟隨農曆正月初一春節，亦非公曆元旦或自然月份：

  • 年柱： 必須以立春（立春交節時刻）為分界，立春前出生即便已過春節，仍屬上一年干支。
  • 月柱： 嚴格以十二個中氣節氣交接為界，立春交節建寅，驚蟄交節建卯，依次遞推。
典型邊界案例： 公曆2026年2月3日，因尚未到達2026年立春交節時刻，在子平八字中依然屬於乙巳年（蛇年），而非公曆2026年或即將到來的丙午年（馬年）。

通過天文學視黃經計算節氣交節時間，從根源上避免了普通網絡排盤工具由於固定日期切分而導致的月柱推算錯誤。

2.3. 歷史時區與子時分界

世界時的同一物理時刻在不同經度與法時計區下可能歸入不同公曆日。在處理歷史出生數據時，法時計區的變更直接影響日柱與時柱的歸屬。Quizzman Calendar提供歷史時區追溯支持。

同時，針對命理學界關於早子時（夜子時，23:00–24:00）與晚子時（正子時，00:00–01:00）的日柱歸屬流派爭議，系統在架構上做到了清晰解耦與透明呈現。

3. BaZi Engine 核心功能模組

四柱八字完整排盤

基於統一的天文節氣時刻與儒略日連貫計算，準確輸出年、月、日、時四柱八字及納音屬性。

十神全矩陣分析（十神）

完整建立日主與各干之間的生剋偏正模型：比肩、劫財、食神、傷官、偏財、正財、七殺、正官、偏印、正印，涵蓋100組全組合映射。

地支藏干與百分比權重（藏干）

規範化展現十二地支所藏天干（本氣、中氣、餘氣），並按司權天數賦予百分比權重（如寅木含甲木60%、丙火30%、戊土10%），用於量化五行分佈。

五行旺衰量化與用神初探

綜合天干顯露與地支藏干權重，量化金、木、水、火、土五行得分，分析五行強弱傾向並提供基礎用神建議。

精密大運排盤（大運）

依年干陰陽屬性及性別決定大運順逆行；依據出生時刻距離節氣交接點的實際間隔，按三日折合一年的古法精密換算起運歲數。

26種規範神煞查詢（神煞）

內建標準神煞演算法，涵蓋天乙貴人、文昌、驛馬、桃花、華蓋、羊刃、天德貴人、月德貴人、紅豔、金神、孤辰、寡宿等26種常見神煞。

干支刑衝合害關係識別

自動識別天干五合、地支六合、三合局、半合、地支六衝、相刑（三刑、自刑）、相害、相破等多維生剋互動關係。

4. 計算流程與分層架構

總計算流程（Pipeline）：

1
輸入： 用戶輸入的出生年月日時及所處時區。
2
時間標準化： 轉換為連續儒略日（JD）與UTC+7基準時間。
3
Quizzman Calendar核心： 調用VSOP87模型求解太陽黃經，定位當年立春交接點及當月節氣交接時刻。
4
干支推演： 立春定年柱，月節定月柱，儒略日定日柱，五鼠遁法定日上起時。
5
結構展開： 提取地支藏干，計算五行權重，確立日主基準。
6
命理分析： 匹配十神映射，推算大運順逆與起運時刻，查驗26種神煞與干支合衝刑害。
7
輸出交付： 生成規範結構化JSON數據供前端UI呈現或通過REST API交付。

核心構件計算法則：

構件模組 計算方法與執行規範
年柱推算 嚴格以太陽視黃經315°（立春）交節時刻為界，與農曆正月初一切割解耦。
月柱推算 嚴格按十二節（立春、驚蟄、清明、立夏、芒種、小暑、立秋、白露、寒露、立冬、大雪、小寒）分段判定。
日柱推算 依據連續儒略日數（JDN）對60取模計算甲子干支循環，杜絕任何歷史曆法改制造成的間斷。
時柱推算 結合十二時辰地支與日干，嚴格依據“五鼠遁”（甲己還加甲，乙庚丙作初...）計算。
十神推算 依據日主與客干間的陰陽異同及生剋關係匹配（10 × 10 = 100種完整排列）。
藏干推算 基於傳統子平經典賦權，將地支藏干規範化分解為本氣、中氣、餘氣並計算能量佔比。
大運推算 年干陰陽配合性別判定順逆；以出生時刻與交節時刻的時間差，按三日折合一年計算起運歲數。

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. 演算法準確度與測試驗證

Quizzman始終強調計算過程的透明可復核性。根據2026年2月公佈的自動化內部迴歸測試結果：

測試組件 內部測試結果 覆蓋範圍
BaZi Engine 128/128 測試項全部通過（PASSED） 覆蓋四柱排盤、立春交界、節氣換月、十神矩陣、藏干權重、大運順逆與起運點、神煞觸發等迴歸用例。
Calendar Engine 108/108 測試項全部通過（PASSED） UTC+7天文同步、閏月推算、太陽黃經度數及極值節氣點驗證。
十神矩陣 100/100 組合全覆蓋 遍歷10天干日主與10客干之間的所有生剋配對。
地支藏干 12/12 地支全覆蓋 十二地支本氣、中氣、餘氣及百分比分佈全部驗證。
神煞系統 26種標準神煞 依據日干、日支、年干或月支的觸發條件全部通過邏輯校驗。
測試基準的技術含義：
“128/128項內部測試通過”表明在發佈時，引擎完全滿足內部迴歸測試集中設定的所有工程邊界與演算法條件（包括立春臨界點、節氣交界點及子夜時辰交接等極端情況）。

這一結果並不等同於宣稱在所有歷史古籍、不同流派異本或主觀推演層面具備“絕對100%的唯一正確性”。

Quizzman堅持持續擴充測試樣本，正積極籌備引入第三方獨立基準庫（例如與獨立合作方 Jade Almanac 進行交叉對驗），以期發佈更具公信力與技術深度的對照報告。

6. 經典文獻基礎與研究方法

八字引擎在規則設計上深入考證了子平命理學史上的五部核心經典：

📜 淵海子平

宋代 · 徐升（徐子平遺法）

子平術的奠基之作，確立以日干為主的根本原則，系統奠定了十神體系。

📜 三命通會

明代 · 萬民英

命理學集大成之作，廣泛收錄先明諸家學說、神煞譜系及納音格局考證。

📜 滴天髓

明代 · 京圖原著 / 劉基注

闡發五行體用、氣勢流轉與全局格局動態平衡的精微理論著作。

📜 子平真詮

清代 · 沈孝瞻

以格局論命之典範，系統論述月令取用、格局純雜及成敗救應準則。

📜 窮通寶鑑

清代 · 余春台輯

專注五行調候學說，論述十干在十二個月令自然環境下的寒暖燥濕平衡。

上述經典為演算法提供了扎實的理論架構支撐。在所有模組開發中，Quizzman均堅持將可通過數學模型驗算的曆法天象與屬於人文文化範疇的命理推演作嚴格區分。

7. 架構演進與發展定位

Quizzman Insight – BaZi Engine定位於構建一個結構化、可拓展、方法論透明嚴謹的研究工具：

  • Quizzman Calendar 承擔底層通用天文曆算基礎設施之責。
  • BaZi Engine 專注於子平模型的結構組織與專業命理計算。

統一下層曆法，確保了八字、紫微斗數與易經等各工具之間數理的一致性。我們的目標不僅是提升排盤效率，更是幫助使用者清晰洞悉其背後的演算法假設與系統邊界。

8. 適用範圍與邊界聲明

本引擎面向命理學習者、曆法研究者、傳統文化從業者以及需要接入四柱八字接口的開發者。

邊界劃分與科學聲明：

1. 曆法天文計算： 節氣時刻、陰陽曆轉換、時區偏差及六十甲子排列屬於嚴謹的天文幾何與數學範疇，具備完全客觀的確定性與可復驗性。

2. 傳統命理推演： 關於性格偏向或發展趨勢等表述屬於傳統符號文化分析體系，絕非現代實證科學的確定性因果結論。

Quizzman絕不宣稱具備預言人類命運的能力。 工具旨在提供精確的數據與計算方法，供用戶在批判性思考與自強自立的精神下進行學術研討與修養參考。

準備好排布您的四柱八字了嗎？

依托Quizzman Calendar UTC+7高精度天文演算法排布您的八字命盤。

排八字命盤 Markdown版本 (.md)