Renhuai123/ziwei-doushu

紫微斗数开源排盘引擎 — 基于倪海厦《天纪》体系，含完整排盘算法、四化系统、格局知识库、古籍原文数据

這是什麼

Renhuai123/ziwei-doushu 是以倪海廈《天紀》體系為基礎的 TypeScript 紫微斗數排盤引擎，搭配 Next.js 示範介面、古籍原文與解讀資料集。核心不只是畫命盤，也把真太陽時、中國夏令時、閏月與晚子時換日等差異做成計算模組或設定，讓開發者能檢查排盤依據，而非只接收一個黑箱結果。

為什麼上榜

本次日榜資料顯示累積 6,843 顆星、當日新增 546 顆。README 最近的亮點是十月十五日發布的 v4.0：涵蓋約六十七點五萬張命盤、十三個維度的解讀，並依教學逐字稿與古籍校正引文、補足斷語條件。這提供了值得關注的更新背景，但不能據此斷定流量來源。

更有意思的是 規則引擎與資料輸出分開開放：資料集由引擎加斷語庫確定性生成，不經 AI，同一輸入得到同一輸出；然而斷語庫本身未公開。能下載大量解讀，不等於能從開源碼重新生成全部內容，也不代表這些命理判斷具有科學驗證。

適合誰，可以拿來做什麼

適合想研究傳統術數資料、製作排盤介面，或探索 RAG 與模型微調語料的開發者。README 列出的用途還包括修改格局規則後做基線比較。若只是想看命盤，可先用線上示範；若想自架完整 AI 解讀產品，則要準備自行實作後端與提示詞，不能把這個倉庫視為線上商業站的完整複製品。

上手

依 README 的 最小啟動流程：

git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install
npm run dev

單純排盤在瀏覽器完成，不需要 API Key；可再執行 npm run typecheck 與 npm test 檢查型別及回歸案例。AI 解讀與合盤 AI 分析的 API 並未附上，僅填入金鑰不會啟用。介面中的斷語模組也是占位實作，能畫盤不等於能產生網站那套解讀。

README 重點摘要

• 版本口徑有差異：十月二十日起亮度預設改採《斗數全書》，v4.0 資料仍使用先前預設；比對結果時要先對齊設定。
• 資料不做出生地校正：v4.0 直接依時辰序號排盤；欄位的零至十一是時辰，不是鐘點。
• 解壓空間需預留：v4.0 解壓後為 56.6 GB，可按年份下載；解壓須帶 zstd --long=27。
• 授權分層看：程式碼採 MIT，資料採 CC BY 4.0 並須註明來源；倪師原話不在資料授權範圍內，另有非商用限制。
• 解讀有邊界：README 明示父母、兄弟、子女等六親判斷僅供參考，不宜把資料量當成準確度保證。