摘要 (Abstract)
紫微斗數為東亞傳統文化中最深奧之象數命理系統之一,其依據個人出生時空座標,將十四正曜與八十六餘顆輔曜、煞曜、神煞分配佈局於地盤十二宮。數十年來之排盤軟體普遍依賴離散查表法,存在數學斷裂點,缺乏真實天文時間修正,且多執於單一流派成見,忽視學術傳統之流變差異。
本論文正式闡述魁茨曼紫微斗數計算引擎(@quizzman/qm-ziwei)之系統架構。該引擎為一建基於魁茨曼曆法天文核心(Quizzman Calendar Engine [1])之規則導向專家系統,透過 HTTPS 端對端(S2S)HMAC 加密協議進行整合,提出六大核心架構貢獻:其一,建立端對端真太陽時整合模型,藉由均時差(Equation of Time [2])與越南1906–1975年八大歷史時區變遷數據,徹底杜絕時辰交界誤判;其二,建立商數與餘數補數之確定性代數演算法,徹底取締紫微星及天府星系安星之鋸齒狀查表;其三,提出二維拓撲幾何演算法,徹底杜絕夾命格(如左右夾命、昌曲夾命)之假陽性判定;其四,依據正統斗君說標準化流月起運遞進演算法;其五,建立流派獨立執行管線(School-Isolated Execution Pipeline),獨立支援北宗(正統陳摶)、南宗(河洛太次郎)、天梁派(太歲三合群)及現代臺灣派(欽天門四化)等四大流派,零跨派數據污染;其六,提出宮位品質評分(Palace Quality Score - PQS)與星盤動態張力指標。全套演算法已通過156項紫微單元測試與108項基礎曆法測試驗證。
1 適用範圍 (Scope)
本文件規範魁茨曼紫微斗數計算引擎(@quizzman/qm-ziwei)之技術規格、演算法及數據結構,涵蓋:
- 透過 HTTPS 伺服器端對端(S2S)協議接收並依據魁茨曼曆法核心之真太陽時標準化出生時空參數 [1]。
- 依六十花甲納音推算命宮、身宮及五行局幾何座標判定演算法。
- 十四正曜及八十六輔曜之商數餘數補數確定性安星法,取締經驗查表。
- 夾命格空間二維拓撲幾何防誤判過濾機制。
- 時間大限(十年)、流年(一年)及斗君流月運勢遞進推演模型。
- 獨立評估四大古典與現代學術流派之十層專家解讀管道(北宗、南宗、天梁派、臺灣派)。
- 臺灣派化忌對宮沖照向量演算法與宮位品質評分(PQS)多維量化模型。
2 規範性引用文件 (Normative references)
下列文件對於本文件之應用為必不可少:
- [3] ISO 8601-1:2019 Date and time — Representations for information interchange.
- [4] ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents.
- [5] ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources.
- [1] Quizzman Research & Engineering Team. Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman.
- [6] Quizzman Engineering Group. Kiến trúc Hệ thống Tính toán Mệnh lý Bát Tự (Tứ Trụ) và Mô hình Khử Sai số Thiên văn trên Nền tảng Lịch pháp Quizzman.
- [7] 陳摶, 羅洪先. 紫微斗數全書. 明代, 約1550年.
- [8] Vân Đằng Thái Thứ Lang. Tử Vi Đẩu Số Tân Biên. Sài Gòn, 1956.
- [9] 阮發祿. 紫微函數. 西貢, 1974.
- [10] 王亭之. 紫微斗數講義(中州派). 香港, 1980.
- [11] 蔡岡廷, 陸子. 欽天門四化紫微斗數秘儀. 臺北, 1990.
- [12] 天梁前輩, 黎德. 紫微十二宮與太歲環. 西貢, 1985.
- [2] Jean Meeus. Astronomical Algorithms. 2nd edition. Richmond: Willmann-Bell, 1998.
- [13] Quizzman Engineering Group. Báo cáo Audit & Vá Lỗi Hệ Thống Tử Vi Đẩu Số — Dossier AUD-2026-TUVI-01.
3 術語與定義 (Terms and definitions)
3.1 地盤宮位 (Worldly palace)
固定對應於子至亥十二地支之十二個空間象限,象徵人生十二大領域,模數索引為 0 至 11。
3.2 五行局 (Five elements bureau)
由命宮干支經六十花甲納音推導出之常數係數()。
3.3 斗君流月說 (Dau Quan doctrine)
自流年太歲宮位出發,逆數生月、順數生時以確定流年正月之古典法則。
3.4 四化 (Four transformations)
天干氣場轉化之四種象態:化祿、化權、化科、化忌。
3.5 真太陽時 (True Solar Time)
個人出生地點經度之視太陽時,經均時差(Equation of Time)與標準子午線經度差修正。
3.6 伺服器端對端架構 (S2S)
服務端直接透過 HTTPS 進行內部通訊,採用 HMAC-SHA256 數位簽章鑑權,完全杜絕客戶端本地未驗證之曆法運算。
4 伺服器端曆法架構與真太陽時修正 (ZIWEI-R005)
4.1 均時差模型杜絕時辰交界誤判
傳統排盤軟體最嚴重之缺陷,在於直接混淆民用平太陽時(鐘錶時間)與視太陽時(真實天象)。由於地球公轉軌道為橢圓形且地軸傾斜 ,真實太陽日的長度四季變動。此誤差經均時差()量化,自2月中旬之 分鐘至11月上旬之 分鐘不等 [2]。
結合出生地點經度()與標準時區子午線經度(),真太陽時()依據 ZIWEI-R005 計算:
其中:
- 為法定民用標準時間。
- 為以儒略日()為參數之均時差值(分鐘)[2]。
- 為出生地實際經度(十進制度數)。
- 為標準時區經度(UTC+7 為 )。
- 常數 代表地球自轉每度經度所需時間(4分鐘/度)。
當個人出生時間位於時辰交界(如早晨 06:55 卯辰之交),淨誤差極易使時辰跨界,徹底顛覆命宮、身宮及十四正曜之排盤結果。
4.2 曆法核心端對端 HMAC 密鑰交握
為杜絕本機舊版運算腳本,紫微引擎透過內部私有 HTTPS 接口直接與魁茨曼曆法核心對接:
通訊採用 HMAC-SHA256 動態簽名鑑權:
- 紫微服務端產生當前 UNIX 時間戳 。
- 計算簽名:,其中 為安全保存之內部密鑰。
- 請求夾帶標頭
X-QM-Internal-Token: <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>T</mi><mo>:</mo></mrow><annotation encoding="application/x-tex">{T}:</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="katex-base"><span class="katex-strut" style="height:0.6833em;"></span><span class="mord"><span class="mord mathnormal" style="margin-right:0.1389em;">T</span></span><span class="mspace" style="margin-right:0.2778em;"></span><span class="mrel">:</span></span></span></span>{Signature}。曆法端校驗時間窗口()與簽名有效性後方予響應。
曆法端精確回傳農曆年月日時之干支、節氣交界與越南 1906–1975 年間八大歷史時區變遷標準化參數。
5 確定性安星演算法與軸對稱幾何 (ZIWEI-R001, ZIWEI-R002)
5.1 命宮、身宮與五行局之判定
設農曆生月為 ,生時真太陽時地支索引為 (子 至 亥 )。寅宮之幾何索引為 2。
命宮索引 與身宮索引 由以下模同餘式解出:
依生年天干 施行「五虎遁月」起寅宮天干,佈列十二宮干支。根據命宮干支之六十花甲納音,確定五行局數 :
- 水二局:
- 木三局:
- 金四局:
- 土五局:
- 火六局:
5.2 商數與餘數補數確定性安紫微星演算法 (ZIWEI-R001)
- 求解最小非負整數補數 ,使生農曆日數 加上 後整除局數 :
- 計算基準商數 :
- 自寅宮(2)順數 步確定基準宮位 :
- 依補數 之奇偶性決定紫微星宮位 :
- 若 為奇數,自基準宮逆數 步:
- 若 為偶數,自基準宮順數 步:
5.3 紫微星系與天府星系寅申軸對稱反射 (ZIWEI-R002)
自紫微星位 出發,紫微組其餘五星依固定角距離逆行佈局: 天機()、太陽()、武曲()、天同()、廉貞()。
天府星與紫微星呈寅(2)–申(8)軸嚴格幾何反射對稱。對稱軸心點為 。天府宮位 公式為:
天府組其餘七星依序順行佈列: 太陰()、貪狼()、巨門()、天相()、天梁()、七殺()、破軍()。
5.4 輔曜、六煞、六吉與動態安星管線
引擎透過 TuviAnimator 實施八階段確定性排盤:
- 第一階段(地盤): 初始化子至亥十二宮。
- 第二階段(命身與局): 確定命身宮、五行局數與納音。
- 第三階段(紫微星系): 安紫微及五逆行正曜。
- 第四階段(天府星系): 鏡射天府並安七順行正曜。
- 第五階段(六煞與六吉): 依干安擎羊、陀羅,依年支與時安火星、鈴星,依時安天空、地劫;文昌、文曲、左輔、右弼、天魁、天鉞。
- 第六階段(太歲與祿存環): 依年支起太歲十二星,依祿存起博士十二神。
- 第七階段(流派四化): 依生年天干與所選流派配置祿、權、科、忌。
- 第八階段(運勢時序): 計算大限起運年齡與斗君流月位。
6 二維拓撲夾命演算法與斗君流月推算 (ZIWEI-R003)
6.1 夾命格假陽性拓撲缺陷修正 (AUD-2026-TUVI-01)
在傳統格局中,「夾命格」嚴格要求二吉曜必須分別居於命宮兩側之相鄰宮位:即一星在父母宮(),另一星在兄弟宮()。
在代碼審計過程(AUD-2026-TUVI-01 [13])中,發現舊版引擎僅將兩鄰宮之星曜合併為單一陣列調用 array.includes(),致使兩星同在一側宮位時仍被判定為夾命格。
本系統實施幾何空間分離判定:
其中 ,。
6.2 斗君流月起運演算法 (ZIWEI-R003)
依據古典文獻 [7, REF-TANBIEN-1956]:
- 定出流年流太歲宮位 。
- 自 逆數至生月 :
- 自 順數至生時 :
- 該 宮位即為該流年之正月斗君所在地。其後各月逐宮順行:
7 十層專家解讀系統與四大流派平行架構 (ZIWEI-R004, ZIWEI-R006)
7.1 紫微引擎十層處理管線
引擎採用十層管線架構:
- 第一層:天文時間標準化(S2S 曆法與真太陽時修正)
- 第二層:命盤幾何拓撲建立(命身宮、局數)
- 第三層:星曜確定性分配(十四正曜與八十六輔曜)
- 第四層:星曜廟旺利陷矩陣運算
- 第五層:三方四正結構交絡分析
- 第六層:格局自動辨識引擎
- 第七層:四化矩陣(依流派配置本命與流曜)
- 第八層:多流派平行解讀通道(四大流派獨立輸出)
- 第九層:動態大限、流年、流月運勢投射
- 第十層:無幻覺確定性多語言自然語言生成
7.2 四大古典與現代學術流派
- 北宗(正統陳摶全書): 重視十四正曜廟旺利陷與四煞(羊、陀、空、劫)。化忌為因果收束點,依正曜光芒定吉凶。
- 南宗(河洛太次郎派): 重視三方四正(命財官)。化忌主是非波折,若逢祿存同度或三方會照,易構「祿逢沖破」或祿被封閉之局。
- 天梁流派(天梁前輩阮發祿): 依太歲軸心四大三合群為綱領:
- 歲虎符組(太歲、官符、白虎):應運得時、剛毅正道。
- 喪歲客組(喪門、歲破、弔客):逆境拼搏、力圖自強。
- 陽紫福組(太陽/少陽、紫微/死符、福德):敏慧仁善、易遭人損。
- 陰龍直組(少陰、龍德、直符):隱忍包容、後運亨通。 同時嚴格對照宮位五行與命盤納音之生剋制化。
- 臺灣流派(欽天門四化派): 視四化為命理靈魂(祿為因,忌為果)。揚棄固定十二年之小限循環,以流年四化飛星入宮為主。
7.3 十天干四化矩陣與流派分歧 (ZIWEI-R004)
十天干四化之古典流派分佈:
| 天干 | 化祿 | 化權 | 化科(北派/臺灣) | 化科(南派) | 化科(天梁派) | 化忌 |
|---|---|---|---|---|---|---|
| 甲 | 廉貞 | 破軍 | 武曲 | 武曲 | 武曲 | 太陽 |
| 乙 | 天機 | 天梁 | 紫微 | 紫微 | 紫微 | 太陰 |
| 丙 | 天同 | 天機 | 文昌 | 文昌 | 文昌 | 廉貞 |
| 丁 | 太陰 | 天同 | 天機 | 天機 | 天機 | 巨門 |
| 戊 | 貪狼 | 太陰 | 右弼 | 右弼 | 右弼 | 天機 |
| 己 | 武曲 | 貪狼 | 天梁 | 天梁 | 天梁 | 文曲 |
| 庚 | 太陽 | 武曲 | 太陰 | 太陰 | 天府 | 天同 |
| 辛 | 巨門 | 太陽 | 文曲 | 文曲 | 文曲 | 文昌 |
| 壬 | 天梁 | 紫微 | 天府 | 左輔 | 左輔 | 武曲 |
| 癸 | 破軍 | 巨門 | 太陰 | 太陰 | 太陰 | 貪狼 |
最顯著之分歧在於庚干(天梁派取天府化科,其餘流派多取太陰化科)與壬干(北派與臺灣派取天府化科,南派與天梁派取左輔化科)。
7.4 臺灣飛星派化忌對宮沖照演算法 (ZIWEI-R006)
依據欽天門四化派秘傳 [11],化忌坐守某宮,必沿 軸線直接沖照對宮:
沖照關係規範如下:
- 忌在遷移 沖命宮(自身多厄、遠行不利)。
- 忌在夫妻 沖官祿(婚姻動盪波及事業)。
- 忌在子女 沖田宅(損耗家業、產業不穩)。
- 忌在僕役 沖兄弟(朋友背信、同僚相傷)。
- 忌在疾厄 沖父母(身體羸弱、親緣有損)。
- 忌在財帛 沖福德(因財生禍、心緒難安)。
7.5 流派獨立執行管線
本系統落實流派獨立執行管線(Isolated School Pipeline):
- 使用者請求指定流派時(如
DAI_LOAN),API 僅推導該流派專屬之四化、大限、流年與流月數據。 - 徹底取締舊版回傳全部四大流派之臃腫冗餘欄位
allSchoolInterpretations。 - 前端介面嚴格呈現所選流派之理論與辭彙,絕不混淆飛星沖照與三合格局。
8 宮位品質量化評分模型 (Palace Quality Score)
8.1 基準分值與四大評估維度
Palace Quality Score (PQS) 將各宮綜合能量量化至連續區間 :
四維構成包含:
- :宮位地支與本命干支五行親和度。
- :正曜權重乘廟旺係數 。
- :六吉星正向增益( 至 )扣減六煞星負向衝擊( 至 )。
- :四化賦能(祿權科 ,忌 )。
8.2 星盤動態張力指標 (Active Tension)
當宮位內吉星與煞星同度時(例如紫微會擎羊),系統計算動態張力指標:
當 ,標記為高張力狀態,提示當事人吉凶交織之複雜運勢。
9 測試驗證與系統完整性 (Verification)
本引擎通過由156項單元測試與108項天文曆法測試構成之自動化迴歸套件:
- 同餘邊界全面遍歷: 測試30個農曆日 5局共150種全排列,達成100%(150/150)正確率。
- 天府對稱性幾何驗證: 遍歷十二宮對稱座標,零幾何漂移。
- 拓撲獨立性測試: 驗證左右夾命、昌曲夾命無假陽性。
- 斗君演算法週期測試: 驗證流月跨年推移無斷裂。
- 流派隔離測試: 驗證四大流派獨立執行,API 回應零數據滲漏。
- 端對端曆法校驗: 驗證 HMAC 密鑰交握與 修正數值精確度。
10 系統限制 (Limitations)
- 輸入精度限制: 必須提供精確出生時點與經緯度;若未提供,系統預設採用 UTC+7(東經 )。
- 時辰粒度限制: 經典體系以兩小時為一時辰;早晚子時之劃分依使用者所選流派配置。
- 星曜範圍限制: 引擎標準納入14正曜與86輔曜,未經經典文獻共識之民間俗俗神煞不列入核心規則集。
- 學術界線聲明: 系統僅提供符號邏輯推演與文化學術研究工具,絕無預知未來之能力。
11 結論 (Conclusion)
魁茨曼紫微斗數計算引擎以VSOP87現代天文曆法、S2S 端對端通訊、確定性商數補數代數演算法及十層專家解讀管道,建立當代紫微排盤之新基準。經典程式設計盲點如鋸齒查表溢位、夾命格拓撲誤判與流月起運倒置皆已徹底剔除。四大流派獨立並行架構落實了客觀多元之學術精神。
參考文獻 (Bibliography)
- [3] International Organization for Standardization. ISO 8601-1:2019 Date and time — Representations for information interchange. Geneva: ISO, 2019.
- [4] International Organization for Standardization. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. Geneva: ISO, 1978.
- [5] International Organization for Standardization. ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. Geneva: ISO, 2021.
- [1] Quizzman Research & Engineering Team. Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman. Quizzman Paper, 2026. Có tại: https://paper.quizzman.com/papers/QP-CAL-001/
- [6] Quizzman Engineering & Metaphysics Research Group. Kiến trúc Hệ thống Tính toán Mệnh lý Bát Tự (Tứ Trụ) và Mô hình Khử Sai số Thiên văn trên Nền tảng Lịch pháp Quizzman. Quizzman Paper, 2026. Có tại: https://paper.quizzman.com/papers/QP-BAZI-001/
- [7] 陳摶, 羅洪先. 紫微斗數全書. 明代, 約1550年.
- [8] Vân Đằng Thái Thứ Lang. Tử Vi Đẩu Số Tân Biên. Sài Gòn: Tinh Hoa Hải Ngoại, 1956.
- [9] 阮發祿. 紫微函數. 西貢: 大南, 1974.
- [10] 王亭之. 紫微斗數講義(中州派). 香港: 中州玄學會, 1980.
- [11] 蔡岡廷, 陸子. 欽天門四化紫微斗數秘儀. 臺北: 自印本, 1990.
- [12] 天梁前輩, 黎德. 紫微十二宮與太歲環. 西貢: 大南, 1985.
- [2] Jean Meeus. Astronomical Algorithms. 2nd edition. Richmond: Willmann-Bell, 1998.
- [13] Quizzman Engineering Group. Báo cáo Audit & Vá Lỗi Hệ Thống Tử Vi Đẩu Số — Dossier AUD-2026-TUVI-01. Quizzman Lab Internal Audit Series, 2026. Có tại: https://insight.quizzman.com/tool/about-tuvi-audit.md
參考文獻(ISO 690 規範)
- [3] International Organization for Standardization. ISO 8601-1:2019 Date and time — Representations for information interchange — Part 1: Basic rules. ISO, 2019. [URL] (Governing international standard for date and time representation and midnight boundary definitions.)
- [4] International Organization for Standardization. ISO 2145:1978 Documentation — Numbering of divisions and subdivisions in written documents. ISO, 1978. [URL] (Governing standard for decimal hierarchy numbering without trailing periods.)
- [5] International Organization for Standardization. ISO 690:2021 Information and documentation — Guidelines for bibliographic references and citations to information resources. ISO, 2021. [URL] (Standard profile for bibliographic records and citation structures.)
- [1] Quizzman Research & Engineering Team. Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman. Quizzman Paper Publishing System, 2026. [URL] (Foundational astronomical specification providing VSOP87 solar terms, Julian Day continuous counting, and True Solar Time reductions.)
- [6] Quizzman Engineering & Metaphysics Research Group. Kiến trúc Hệ thống Tính toán Mệnh lý Bát Tự (Tứ Trụ) và Mô hình Khử Sai số Thiên văn trên Nền tảng Lịch pháp Quizzman. Quizzman Paper Publishing System, 2026. [URL] (Methodological specification formalizing Day Master lordship, sexagenary continuous indexing, and seasonal commands.)
- [7] Hy Di Trần Đoàn (Chen Tuan); La Hồng Tiên (Luo Hongxian) biên soạn. Tử Vi Đẩu Số Toàn Thư (紫微斗數全書). 1550. (Foundational classical treatise codifying the twelve life palaces, 14 major stars, bureau derivation, and essential star placement algorithms.)
- [8] Thái Thứ Lang, Vân Đằng. Tử Vi Đẩu Số Tân Biên. Nhà xuất bản Tinh Hoa Hải Ngoại, 1956. (Authoritative Vietnamese 20th-century compendium formalizing star radiance tiers (Miếu, Vượng, Đắc, Hãm) and minor star configurations.)
- [9] Nguyễn, Phát Lộc. Tử Vi Hàm Số. Nhà xuất bản Đại Nam, 1974. (Algorithmic and mathematical formulation of Ziwei palace coordinates, vector-like star combinations, and life stages.)
- [10] Vương, Đình Chi. Tử Vi Đẩu Số Giảng Nghĩa (Trung Châu Phái). Trung Châu Huyền Học Hội, 1980. (Systematic formulation of Central Plains (Trung Châu) school Si Hua transformation tables, Star cluster mutabilities, and palace fly-in rules.)
- [11] Thái Cương Đình (Cai Gangting); Lục Tự (Lu Zi). Khâm Thiên Môn Tứ Hóa Tử Vi Đẩu Số Bí Nghi (欽天門四化紫微斗數秘儀). 1990. (Foundational text of modern Taiwanese Flying Si Hua doctrine formalizing palace fly-in clashes and karmic causality (Lu as cause, Ji as effect).)
- [12] Lê, Đức; Cụ Thiên Lương. Tử Vi Thập Nhị Cung và Vòng Thái Tuế. Nhà xuất bản Đại Nam, 1985. (Foundational treatise for the Tian Liang school establishing the primacy of the Tai Sui axis, four trine groups, and Na Yin elemental affinities.)
- [2] Meeus, Jean. Astronomical Algorithms. Edition 2nd edition. Willmann-Bell, 1998. (Governing algorithmic reference for solar coordinates, Equation of Time (EOT), and nutation.)
- [13] Quizzman Engineering Group. Báo cáo Audit & Vá Lỗi Hệ Thống Tử Vi Đẩu Số — Dossier AUD-2026-TUVI-01. Quizzman Lab Internal Audit Series, 2026. [URL] (Comprehensive architectural and empirical audit resolving quotient-remainder star placement, Giap Menh topology disambiguation, Dau Quan month transit, and Si Hua stem mappings.)