← ブログに戻る
Ai読了目安 12 分

1100のルールで動く占星術エンジンは、多くのAI製品よりよくできている

公開日 2026年11月9日
1100のルールで動く占星術エンジンは、多くのAI製品よりよくできている

中国の占星術の命盤を計算するTypeScriptのリポジトリが、今週GitHubで16,868スターを集めた。多くの開発者ツールが一生かけて届かない数だ。しかも、西洋のエンジニアの大半が「ソフトウェアではない」と分類するだろう題材で。

面白いのは題材ではない。「AI製品」という看板で出てくるものの多くより、このリポジトリのほうがよくできた工学だという点である。

ziwei-doushuは紫微斗数のオープンソースエンジンで、倪海厦が天紀の講義で教えた体系に基づいている。命盤はすべてブラウザ内で計算される。APIキーもモデルも推論もない。算術と参照表と、1,100行のパターンルールである。

そして768枚の回帰用の命盤が付いてくる。

実際に何を計算しているか

この領域を知らなくても、READMEの機能表は、この種の計算がどこで間違えるかのリストとして読める。

真太陽時の補正。時計に記録された出生時刻は、その土地の太陽時ではない。エンジンは経度差と均時差を補正するので、国の東側で立てた命盤が二時間ずれることがない。これは占星術版のタイムゾーンバグで、素朴な実装が最初に壊れる場所だ。

中国の夏時間、1986年から1991年。この国は6年間だけ夏時間を採用し、その後やめた。エンジンはその期間を検出するが、意図的に1時間を自動で引かない。READMEは明示している。時計の読みは利用者が確認し、別のclock-adjust.tsを通して変換する、と。正しい直感だ。利用者の入力を黙って調整することが、自信満々に間違った命盤を作る方法である。

閏月の4つの流儀。流派によって、閏月を前の月に属させるか、次の月か、日で分割するか、独立した月とするかが分かれる。エンジンはどれかに決めず、設定にする。星の明度も同じで、伝統によって、同じ商用ソフトでも版によって、異なる尺度を使う。7段階をサポートし、表示の代替として粗い3段階の分類も持つ。

遅い子の刻の日付切り替え。23時から23時59分は翌日、0時から0時59分は当日として扱う。出生地が与えられていれば、真太陽時で判断し、2つの規則が矛盾しないようにする。

その上に四化と飛星、本命盤と年盤で位置が変わる12の神殺、そして1,100を超えるパターンのライブラリが載る。紫府同宮、日月并明、七杀朝斗、そのほかである。

A carved wooden printing block and a worn ink brush on coarse paper

テストがこのリポジトリの主張そのものだ

命盤エンジンが正しいと言うこと自体は誰でもできる。このプロジェクトは、プッシュとプルリクエストのたびに走るテストスイートを公開しており、何を確認しているかのリストがリポジトリで最も情報量の多い部分だ。

体系の鉄則に対する768枚の命盤。夏時間の期間。立春の境界。この暦で年が変わる場所で、ほとんどすべての実装が1年ずれる。红鸾と天喜の位置。サンプル命盤間での時辰インデックスの一貫性。時辰インデックスの境界条件。日付の妥当性。2つの化が同じ宮に入る場合。

宣伝用のリストではない。それぞれに順番に噛まれた人が書いたリストだ。立春の境界だけでも、2月の第1週に生まれた人について、素朴な実装は毎年必ず壊れる。

インストール

3つのコマンド。

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

任意でcp .env.example .env.local、そしてnpm run dev。検証はnpm run typecheckでTypeScript全体を通し、npm testで命盤エンジンの回帰スイートを走らせる。

命盤の作成と表示にAPIキーは不要で、相性の命盤にも要らない。すべてがクライアント側で動く。生年月日と出生地から作るものにとって、これは正しい判断だ。

作者が引いた境界線と、それがREADMEで最も正直な記述である理由

オープンソース版にはバックエンドのAPIルートが含まれない。命盤の作成、表示、相性の作成はすべてローカルだ。しかしAIによる解釈のエンドポイント/api/interpretと、相性分析のエンドポイントは実装されていない。

それがなくても、インターフェースはオープンソース版にそのエンドポイントが含まれないとはっきり表示する。そしてREADMEは、利用者が何度も報告していた問題に決着をつける一行を添えている。APIキーを設定しても、これらの機能は動かない。issue #30は、利用者がそう思い込んだために存在する。

珍しい判断だ。楽なのは、モデルを呼んでそれらしい解説を返すスタブを出すことだったろう。代わりにこのリポジトリは、自分が神託であるふりを拒む計算機になった。この題材のオンライン上の存在の多くが自信満々のナンセンスであることを思えば、計算できる範囲の縁で止まるツールは注目に値する。

命名と、ライブラリのように読める理由

コードはこの分野が実際に教えられる順に組織されていて、だから読める。

lib/ziwei/algorithm.tsが命盤作成の手順を持つ。命宮を置き、五行局を定め、14の主星を置き、補助星を置き、大限と流年の周期を並べる。constants.tsは天干、地支、星のリストを持つ。sihua.tsは四化、禄、権、科、忌を、飛星の自己化のケースも含めて持つ。そのあとにパターンライブラリと明度表の独立したモジュールが続く。

この分野を知っていれば、その対応は明白だ。知らなくても読める。定数、算術、ルール、解釈に近いデータ、という順である。領域は馴染みがなく、構造は馴染みがある。流行ではなく対象を理解した人が作ったソフトウェアの姿だ。

TypeScriptを選んだことも効いている。命盤は星を載せた宮の木で、互いを参照するルールで変換される。「宮は星のリストを持ち、各星は固定集合の明度を持つ」と表現できる型システムは、まとまった種類のバグをコンパイル時に捕まえる。リポジトリは何より先に型チェックを通す。列挙値の多い領域では、それは飾りではない。

AIのブログが占星術エンジンを書く理由

今のAI製品の作り方に対する、きれいな反例だからだ。

ここには、すべての出力が決定論的で、すべてのルールが名前のある伝統に帰属し、あいまいな慣習はすべて意見ではなく設定スイッチで、正しさが768の回帰ケースで強制されるシステムがある。2回同じ質問をすれば同じ答えが返る。何も捏造されない。何も生成されていないからだ。

そして明示的にやらない部分がある。解釈だ。判断を要し、実践者によって意見が分かれる層は、利用者か、別に実装されたエンドポイントに委ねられる。

言語モデルで作っているチームの多くは、この分割を真似すると得をする。計算できるものは正確に計算し、解釈が始まる場所を明示する。代替は、両者の違いについて権威的に響くシステムだ。このリポジトリが避けるように設計された失敗が、まさにそれである。

コードはMIT。データセットはCC BY 4.0。古典籍はパブリックドメイン。講師自身の言葉は非商用ライセンスで、READMEにもそう書かれている。すべてが文書化されている。はるかに争いの少ない素材についてほとんどのプロジェクトが果たせていないことだ。

題材を信じる必要はない。工学から学べることはある。たいてい、それがよくできたものの印である。

関連記事