中国占術のリポジトリが200億文字を公開した。エンジンはMIT、文章はMITではない

今週GitHubで最も伸びたリポジトリの4位は、中国の占星術の命盤を計算するTypeScriptプロジェクトだ。7日間で4,906個のスターを獲得した。ほとんどのモデル公開を上回る速度で、上に残っているのは数本のagentツールだけという位置にいる。週間ランキングの上位は、普段ならモデルか基盤側のプロジェクトが占めている。
プロジェクト名はziwei-doushu。実装している紫微斗数の体系から取った名前だ。土台にあるのは故・漢方医Ni Haixiaの教学体系で、このテーマの講義は全14回にわたる。リポジトリには完全な命盤エンジン、パブリックドメインになった原典、そしてこのリポジトリをわざわざ開く理由そのものであるデータセットが入っている。
データセットの中身
10月15日に公開されたバージョン4.0には674,976枚の命盤が収録されている。各命盤は13の解釈次元に展開され、合計8,774,688件の解釈になる。本文はおよそ20.4 billion characters、解凍すると56.6 gigabytes、圧縮状態で161 megabytes、年ごとに分割した77ファイルに分かれる。

命盤の数は網羅的だ。1950年から2026年までの実在するすべての日付に、12の伝統的な時辰と男女2性を掛け合わせている。1枚あたり平均およそ3万字の解釈が付く。裏を返せば、戸籍に存在する誕生日なら、対応する命盤がこのデータセットの中にある。
公開の前に、メンテナは77ファイルすべてを解凍し、元データとバイト単位で突き合わせた。こういうQAの注記を残す人は、過去にデータで痛い目を見ている。作業自体は難しくない。ただ退屈で、退屈な作業はたいてい誰もやらない。
前バージョンの3.0は1924年から1983年までの518,400枚で、解凍後は33.1 gigabytesだった。4.0は対象期間を17年広げ、枚数を30パーセント増やし、解凍サイズを71パーセント増やした。サイズの伸びが枚数の伸びを上回るのは、1枚あたりの解釈文が長くなったからだ。
書き直しても残るのはエンジンのほう
命盤作成の中核は `lib/ziwei/` にある。機能一覧を読むと、業界が何十年も議論してきた論点のリストを眺めている気分になる。エンジンの層は、作り直しても残る唯一の部分でもある。
真太陽時補正は経度差と均時差の両方を扱う。だから中国西部で記録された出生時刻が、時計の都合で丸ごと1時辰ずれることはない。1986年から1991年の夏時間は検出するが、意図的に差し引かない。アプリはその期間に印を付けて、時計の読みを利用者に確認させてから換算する。閏月は4つの慣行に対応し、どれも設定可能で、特定の流派に焼き込んではいない。晩子時は23:00で日付を切り替える仕様で、これも切り替えられる。星の輝度は7段階で等級付けし、表示用のフォールバックとして粗い3段階も残す。輝度をどの流派で取るか自体がトグルになっているのは、主要な命盤ソフト同士の見解が揃っていないからだ。
さらに四化と飛星の体系、本命層と年運層に分かれた12の神煞、そして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
検証はコマンド1つだ。`npm test` は768枚の命盤を対象に回帰スイートを走らせる。中核ルール、夏時間の境界、立春の境界、サンプルの一貫性、時辰インデックスの端、日付の妥当性、同じ宮で起きる二重四化が含まれる。こうしたシステムで壊れやすい場所ばかりを選んでいる。同じスイートがpushのたびにGitHub Actionsで回る。
命盤を見るのにAPIキーもバックエンドも要らない。エンジンはブラウザの中で動く。
境界線の引き方が異常に精密
このリポジトリが他の大半のオープンソース公開と違うのは、ここだ。メンテナは曖昧にせず、含まれていないものを一覧にして証拠として行数を添えている。命盤ページはデモが75行、商用製品が1,227行。解釈パネルは467対5,088。命盤グリッドは285対1,334。宮のセルは201対1,192。相性ページは368対1,937。
解釈式のライブラリ、つまりこの命盤が何を意味するかを実際に利用者へ伝える部分は非公開だ。リポジトリの `db-analysis.ts` はプレースホルダにすぎない。AI解釈用のプロンプトも非公開。バックエンドのルートも非公開で、READMEにははっきり書いてある。APIキーを設定しても `/api/interpret` は動かない。オープン版にそのエンドポイントが存在しないからだ。ユーザー管理、決済フロー、不正利用対策、デプロイ設定も、どれも入っていない。これらが揃って初めて、課金して回せる製品になる。そして全部が閉じた側にある。
公開されているのは、エンジン、原典、14の主星と12の宮を扱うSEOナレッジグラフ、デモのUI、そしてデータセットだ。
ライセンスも同じ論理で4つに分かれる。コードはMIT。データセットはCC BY 4.0で、表示を条件に商用利用できる。原典はパブリックドメイン。講義から起こした1,848件の引用はCC BY-NC-SA 4.0、つまり非商用に限られ、データセットのライセンスはそれらを明示的に除外している。
最後の一条に目を留めたい。200億文字の生成解釈は、表示さえすれば商用利用できる。その元になった1,848件の引用は、できない。線は文字数ではなく、出所で引かれている。
占術の外側でなぜ面白いか
このリポジトリには、占術以外にも通用する点が3つある。
1つ目は堀の形だ。個人開発者がまず命盤エンジンを作り、次にナレッジベース、次にデータセットを作り、作り直すのに高くつくがコピーは安い部分をオープンソースにした。手元に残したのは、書くのは安いがコピーが難しい部分だ。解釈文、プロンプト、導線である。資金を調達したスタートアップより、"オープンソース"の読み方が精緻だ。
2つ目はデータセットを製品として扱っていることだ。8.7 million件の解釈を生成するのは網羅性の力技で、すべての日付、すべての時辰、男女2性、13次元を埋めていく。評価にもファインチューニングにも、競合製品を作るのにも使える。2つの解釈が日付範囲の全体で矛盾しないかを確かめたい人にも効く。配布コストはほぼゼロで、ランディングページでは買えない種類の信頼が手に入る。
3つ目は流通だ。READMEの最後は、Xiaohongshu、Douyin、そして中国の中古売買アプリXianyuで声をかけてほしいという誘いで終わる。導線はGitHubリポジトリからホスト済みのサイト、そこからSNSアカウントへと、この順に流れる。リポジトリが、普段はコンテンツマーケティングの予算が担う仕事をしている。順番を逆にすると、たいてい効きが悪くなる。
メンテナはこのリポジトリを、維持される製品ではなく "open snapshot" と呼ぶ。issueの返信は遅れることがあると断り、命盤の慣行を変えたい人には出典を添えてほしいと求めている。16,700スター、56ギガバイトのデータセットを抱えるプロジェクトとしては、取引の説明として正直なほうだ。
エンジンが欲しいなら持っていけばいい。文章が欲しいなら、その文章こそがビジネスだ。