一個中國命理儲存庫開源了兩百億字,引擎是 MIT,句子不是

本週 GitHub 上成長第四快的儲存庫,是一個用 TypeScript 寫的中國命理排盤專案。七天內它拿到 4,906 顆星,這個速度壓過大多數模型發布,前面只剩下少數幾個 agent 工具。一週榜單的前幾名,平常幾乎都是模型和基礎設施專案的地盤。
專案叫 ziwei-doushu,名字取自它實作的紫微斗數體系。整套東西建立在已故中醫 Ni Haixia 的教學之上,他談紫微斗數的講座一共十四講。儲存庫裡裝著完整的排盤引擎、公有領域的古籍原文,以及一份資料集。老實說,多數人會點進這個儲存庫,圖的就是這份資料集。
資料集裡到底裝了什麼
10 月 15 日發布的 4.0 版收了 674,976 張命盤。每張盤展開成十三個解讀維度,一共產生 8,774,688 條解讀。把這些內文疊起來約 20.4 billion characters,解壓縮後 56.6 gigabytes,壓縮後 161 megabytes,再按年份切成 77 個檔案。

命盤數量是窮舉出來的:1950 到 2026 年之間的每一個真實日期,乘上十二個傳統時辰,再乘上兩種性別。平均下來,每張盤配大約三萬字的解讀。換句話說,只要生日在公曆上真實存在,就能在資料集裡找到對應的盤。
發布之前,維護者把 77 個檔案全部解壓縮,逐位元組和來源資料比對過一遍。會寫這種 QA 說明的人,多半是被資料坑過一次。這件事做起來不難,只是無聊,而無聊的事通常沒人做。
上一版 3.0 涵蓋 1924 到 1983 年的 518,400 張盤,解壓縮後 33.1 gigabytes。4.0 把時間範圍往前推了十七年,盤數多了 30%,解壓縮體積漲了 71%。體積漲得比盤數快,是因為每張盤的解讀文字變長了。
引擎才是重寫之後還留得下來的部分
排盤核心放在 `lib/ziwei/` 裡。看功能清單,像在看一份業界吵了幾十年的問題列表。引擎這一層,也是整個專案重寫之後唯一還會留下的東西。
真太陽時校正同時處理經度差和均時差,所以在西部記錄的出生時間,不會因為鐘錶走時而整整挪後一個時辰。1986 到 1991 年中國的日光節約時間會被辨識出來,但刻意不自動扣減:應用程式先把這段時間標出來,等使用者確認鐘錶讀數,再進行換算。閏月支援四套並行慣例,全部可以設定,而不是寫死到某一派。晚子時在 23:00 換日,換不換也能設定。星曜亮度分七級,另留三級粗檔給顯示備援,亮度採哪一派本身就是個開關,因為主流排盤軟體之間本來就對不上。
再往下是四化與飛星體系、分屬本命層和流年層的十二神煞,還有一個收錄 1,100 條以上規則的格局庫,紫府同宮、七殺朝斗這些經典格局都在裡面。這幾個名詞在命理圈裡不需要額外解釋。
這些都不是裝飾。在一個各派對亮度賦值互不認同的體系裡,把某一種解讀寫死在程式碼裡,等於把產品決策偽裝成實作細節。把它們做成開關,才讓一個自用工具變成別的業者也願意接手的東西。
跑起來
技術堆疊是 Next.js 16 加 App Router、TypeScript、Tailwind、Framer Motion,排盤邏輯底下用 iztro 和 lunar-javascript。整套裝起來不複雜,前提是本機已經有 Node 環境。
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install
cp .env.example .env.local
npm run dev
驗證只有一條指令。`npm test` 會跑一套涵蓋 768 張命盤的回歸測試,包含核心規則、日光節約時間邊界、立春邊界、範例一致性、時辰索引邊界、日期合法性,以及同一宮位出現雙重四化的情況。挑的全是這類系統裡最容易出錯的地方。每次 push,GitHub Actions 都跑同一套。
看盤不需要 API key,也不需要後端。引擎就在瀏覽器裡跑,整個流程都是純前端計算,後面沒有伺服器。
邊界畫得異常精確
這個儲存庫和多數開源發布不一樣的地方就在這裡。維護者沒有含糊過去,而是逐項列出了哪些東西沒有開源,還附上行數當證據:命盤頁 75 行對 1,227 行,解讀面板 467 對 5,088,命盤宮格 285 對 1,334,宮位儲存格 201 對 1,192,合盤頁 368 對 1,937。五組數字擺在一起,從示範版到商業版差出多少行,一眼就能看出來。
解讀公式庫沒有開源,而它才是真正告訴使用者這張盤什麼意思的東西。儲存庫裡的 `db-analysis.ts` 只是個佔位檔案。AI 解讀用的 prompt 沒有開源。後端路由沒有開源,README 寫得很直白:就算設好 API key,`/api/interpret` 也不會動,因為開源版裡根本沒有這個端點。使用者系統、付款流程、防濫用層、部署設定,一樣都不在。這些東西加起來,才是一個能上線收錢的產品,而它們全在閉源那一側。
開源出來的是:引擎、古籍原文、一張涵蓋十四主星與十二宮位的 SEO 知識圖譜、示範介面,以及前面那些資料集。
授權照同一套邏輯拆成四塊。程式碼是 MIT。資料集是 CC BY 4.0,允許商用,署名即可。古籍屬於公有領域。從講座整理出的 1,848 條引文是 CC BY-NC-SA 4.0,只能非商業使用,資料集授權也明確把它們排除在外。
最後這一條值得多看一眼。兩百億字的生成解讀,只要署名就能拿去商用。它們據以生成的那 1,848 條原始引文,不行。分界線不在字數上,在來源上。
拋開命理,這件事為什麼有意思
這個儲存庫有三件事可以推廣到命理以外。
第一是護城河的形狀。一個人先做排盤引擎,再做知識庫,再做資料集,然後把重建成本高、複製成本低的部分開源出去,留下寫起來便宜、複製很難的部分:解讀文字、prompt、轉換漏斗。這套對開源的理解,比很多拿了資金的創業公司都精細。
第二是把資料集當產品。生成 8.7 million 條解讀是覆蓋面上的暴力活:每個日期、每個時辰、兩種性別、十三個維度,全部鋪一遍。它可以拿來做評測、做微調、做競品,也可以拿來檢查兩種解讀在整整一段日期範圍裡會不會自相矛盾。發布它的散佈成本幾乎為零,換回來的可信度,一個落地頁買不到。
第三是散佈。README 結尾邀請人去小紅書、抖音和閒魚找他們。漏斗的順序就是 GitHub 儲存庫、託管網站、社群帳號,儲存庫在幹一份內容行銷預算平常在幹的活。這個順序反過來說,效果通常差得多。
維護者把這個儲存庫稱作 "open snapshot",而不是一個持續維護的產品,提醒 issue 回覆可能很慢,還要求改動排盤慣例的人帶上文獻引用。一個有 16,700 顆星、56 gigabyte 資料集的專案,這樣描述這樁交易算誠實。
想要引擎,拿去用。想要那些句子,句子就是生意。