Renhuai123/ziwei-doushu: 倪海厦式紫微斗数排盤をTypeScriptで
/ 9 min read
Table of Contents
リポジトリ
- Renhuai123/ziwei-doushu
- 主要言語: TypeScript / ライセンス: MIT / ★ 6,872
Renhuai123/ziwei-doushu とは
本リポジトリは、中国の伝統的な占術「紫微斗数(しびとすう)」の排盤(命盤作成)エンジンをオープンソースで提供するプロジェクトです。著名な漢方医で中国古典の大家である倪海厦(ニー・ハイシャー)氏の『天紀』に基づいた体系を採用している点が特徴です。完全な排盤アルゴリズム、四化(しか)システム、格局(かくきょく)知識ベース、古籍の原文データまでを包括しています。TypeScriptで記述され、占術研究者からアプリケーション開発者まで幅広い層にとって価値ある基盤となります。
紫微斗数(しびとすう)の奥深さに触れる
紫微斗数は、生年月日と出生時刻から個人の運勢や性格、人生の傾向を読み解く中国の占星術です。西洋占星術のように星の位置を計算しますが、紫微斗数では特定の12の宮(ハウス)に主星や副星を配置し、それらの組み合わせや相互作用から運命を推し量ります。その複雑さと精緻さから「帝王の学問」とも称され、古くから重要な意思決定に用いられてきました。排盤とは、この生年月日と出生時刻から個人の命盤(ホロスコープに相当)を作成する一連の計算プロセスのことを指します。
本リポジトリの主要な特徴と強み
倪海厦《天紀》に基づく正確な排盤アルゴリズム
本エンジンの中核は、倪海厦氏の『天紀』の教えに厳密に従って設計された排盤アルゴリズムです。これにより、従来の紫微斗数ソフトウェアとは一線を画す、一貫した理論体系に基づいた命盤作成が可能です。以下のような要素が詳細に実装されています。
- 完全な排盤アルゴリズム: 紫微斗数の命盤を構成する12宮や各星の配置を正確に算出します。
- 四化システム: 主星に影響を与える「化禄(かろく)」「化権(かけん)」「化科(かか)」「化忌(かき)」といった四つの変化のメカニズムを実装し、命盤の動的な解釈を可能にします。
- 格局知識ベース: 命盤に現れる特定の星の配置が示す「格局」の知識を網羅し、その解釈に深みを与えます。
- 古籍原文データ: 占術の根拠となる古典文献の原文データを保持しており、研究の助けとなります。
- 真太陽時と夏時間対応: 出生地の経度に基づいた真太陽時補正や、中国の過去の夏時間(夏令時)への対応も細かく行われており、より精度の高い排盤を実現します。
膨大な命盤データセットとその応用可能性
このプロジェクトの特筆すべき点は、その巨大な命盤解読データセットです。2026年10月15日に公開が予定されているv4.0解読データセットは、以下のような驚異的な規模を誇ります。
- 約67.5万枚の命盤: 1950年から2026年までの実在する全ての日付(各12時辰、男女別)をカバー。
- 13の解釈次元: 各命盤に対して13種類の異なる角度から解釈を提供。
- 約877万段の解読文: 全体で約204億字に及ぶ詳細な解読文が含まれます。
- データサイズ: 解凍後56.6GB(圧縮後161MB)にもなり、必要な年次だけをダウンロードすることも可能です。
この膨大なデータセットは、占術研究における統計的分析や、独自の解釈システムを構築する上での貴重な資源となります。例えば、特定の星の配置がどのような運勢の傾向を示すかを大規模データで検証したり、データ駆動型の解釈ロジックを開発したりといった、先進的な取り組みが可能になるでしょう。
占術研究を支える知識ベースと古籍データ
リポジトリには、倪海厦氏の『天紀・紫微斗数』に関する講義の原文(1848条)も含まれており、原文と照らし合わせながら学べるようになっています。また、サイトの知識ベースでは『紫微斗数全書』の古籍引証が244箇所から405箇所に増加し、それぞれの引用元を原文で確認できるようになっています。これにより、学習者や研究者は、解釈の根拠を深く掘り下げて探求できます。
開発者を考慮した設計と実装
TypeScriptで書かれたコードベースは、その堅牢性と型安全性の高さから、大規模なアプリケーション開発にも適しています。排盤エンジンのモジュール化された構造は、特定の機能だけを抽出して利用するといった柔軟な使い方も可能です。例えば、ウェブアプリケーションのバックエンドとして組み込んだり、デスクトップアプリケーションやモバイルアプリのコアロジックとして活用したりと、多様なプラットフォームでの展開が考えられます。
活用が期待されるシーン
本リポジトリは、以下のような多様な現場で役立つことが期待されます。
- 占術サービス開発: 紫微斗数を用いたオンライン占いやモバイルアプリケーションを開発する際の強力なバックエンドエンジンとして。
- 研究・教育: 紫微斗数のアルゴリズムや解釈法を深く研究したい学者、あるいは学習教材として活用したい教育機関。
- データ分析: 占術データを統計的に分析し、新たな知見を発見しようとするデータサイエンティスト。
- 個人利用: 個人的な興味から、自身の命盤を深く理解したいと考える愛好家が、カスタマイズされたツールを開発する基盤として。
オンラインで提供されている体験版「Metis Ziwei」(metisziwei.com)では、このエンジンとデータセットを基盤とした高度な解読機能や命盤の履歴管理が提供されており、本エンジンの可能性を垣間見ることができます。
まとめ
Renhuai123/ziwei-doushu は、倪海厦氏の『天紀』体系に基づいた紫微斗数の排盤エンジンとして、その精緻なアルゴリズムと膨大なデータセットで、この伝統的な占術の分野に新たな地平を切り開いています。オープンソースであることにより、世界中の開発者や研究者が協力し、紫微斗数に関するアプリケーションや研究を一層発展させる可能性を秘めています。このリポジトリは、単なるツールではなく、奥深い占術の世界を探求し、現代技術と融合させるための強力な足がかりとなるでしょう。