PeekFate 是一個將傳統命理學(八字、易經、奇門遁甲)系統化、程式碼化的純前端規則引擎。它將複雜的命理推算邏輯轉化為一套可運算的演算法,讓使用者在瀏覽器端即可完成每日時辰的運勢推演。
這個專案解決的核心問題是如何將非標準化的民俗命理規則,轉化為可量化、可追溯且具備一致性的計算模型。開發者不再是單純地提供隨機的運勢文字,而是建立了一套基於 JSON 資料庫的引擎,讓每一分吉凶得分都有對應的命理依據。
核心做法與技術實現
PeekFate 採用模組化的引擎設計,將推算過程拆分為多個獨立的 JS 引擎。首先由日期引擎處理西元日期與節氣的轉換,接著由干支引擎推算出四柱八字。隨後,八字引擎、易經引擎與奇門遁甲引擎會同步運作,分別從十神關係、卦象變動、九宮格格局三個維度產出原始數據。
最關鍵的技術亮點在於計分引擎。開發者意識到傳統的簡單加法計分無法區分不同性質的事件,因此引入了事件類型專用計分模型。系統定義了 22 種子事件(如就職、金牌、逝世、封殺等),每種事件擁有獨立的目標十神、避免十神、權重與乘數。例如,死亡事件會觸發高倍率的負向乘數,而就職事件則對正官、七殺有較高權重。這種做法將命理推算從單純的吉凶預測,提升到了事件分類的量化分析。
適合誰使用
對於對傳統文化有興趣但不想學習複雜排盤的普通使用者,這是一個便捷的 PWA 工具。對於工程師而言,這個專案提供了一個將複雜業務規則(Domain Knowledge)轉化為 JSON 驅動引擎的實作範例,展示了如何處理大量對照表與條件判斷邏輯。
實務限制與導入風險
從技術角度看,該專案存在明顯的領域限制。首先,節氣資料雖涵蓋 1900 至 2100 年,但天文演算仍有正負一日的誤差,這會直接影響月柱邊界出生者的推算結果。其次,奇門遁甲流派眾多,本專案僅採行固定的時家奇門規則,無法代表所有流派。
導入風險在於其對命理規則的依賴性。由於所有邏輯都寫死在 JSON 與 JS 引擎中,若要調整推算邏輯,必須對命理學有深厚理解才能修改對應的權重參數。
成熟度判斷
PeekFate 具有極高的工程完備度。它不僅完成了功能開發,還建立了一套完整的測試體系,包含八字、易經、奇門各模組的 JSON 測試案例。最令人印象深刻的是其驗證報告,開發者利用 252 位名人的 231 筆歷史事件進行回測,通過率達 94%,這證明了其計分引擎在邏輯上具有高度的自洽性與穩定性。
總結來說,這不是一個簡單的隨機運勢生成器,而是一個嚴謹的規則引擎實作。它將民俗文化以數據結構化的方式呈現,並透過 PWA 技術實現了離線可用與隱私保護,是一個技術含量相當紮實的工具型專案。