八字ツールチェーンを完全オープンソース化：bazi-kit 3パッケージ

八字（四柱推命）プロダクトを作る上で最も難しいのは「どう解釈するか」ではなく、クリーンなバイリンガル用語データベースも使えるチャートUIも存在しないことです。ほとんどのリソースは中国語のみで、見つかるチャートコンポーネントはすべて特定の計算エンジンに縛られています。エンジンを替えたい、英語ラベルを表示したいと思ったら、ビュー層全体を書き直すことになります。

AskingMingの開発でも同じ壁にぶつかりました。そこで製品を支えるツールチェーン全体を抽出し、MITライセンスで bazi-kit としてオープンソース化しました。独立して使える、または組み合わせて使える3つのnpmパッケージです：

• bazi-engine — 計算レイヤー：生年月日時刻・場所・性別を渡すと、完全な命式を返します。
• bazi-terms — バイリンガル用語DB：天干・地支・十神・納音・神煞…構造化・翻訳可能・ゼロ依存。
• bazi-chart — Reactチャートコンポーネント：任意の命式データをクリーンなバイリンガルUIにレンダリング。

依存関係は厳密に単方向：bazi-terms ← bazi-engine / bazi-chart。レンダラーはエンジンに依存しません——私たちのエンジンを使うか、自分のものを持ち込んでください。

bazi-engine：出生データから完全な命式へ

チェーンの中で最も重いレイヤーであり、最も過小評価されやすい部分です。命式計算はテーブル参照に見えますが、真太陽時・歴史的サマータイム・都市座標を正しく処理するには想像以上の工程量が必要です。

import { computeBazi } from 'bazi-engine';

const result = computeBazi({
  solar: '1990-03-24 09:54',
  gender: 'male',
  location: { city: '広州' },
});

computeBazi は純関数です：同じ入力からは常にバイトレベルで同一の出力が得られます。IOなし、Date.now() なし、グローバル状態なし。デフォルトで真太陽時補正（Meeus均時差公式）を有効にし、IANAタイムゾーンデータベースで歴史的サマータイムを処理します。

v1の機能：四柱（干支・蔵干）、十神、納音、旬/空亡、十二長生、自坐、大運、真太陽時、88都市の座標・タイムゾーンマッピング内蔵。刑冲合会・神煞・五行スコアはv2で追加予定。

bazi-terms：すべての概念を翻訳・検索可能に

命式で使われる用語はすべて構造化データです：十天干 STEMS(10)、十二地支 BRANCHES(12)、五行 ELEMENTS、十神 TEN_GODS(11)、十二長生 GROWTH_STAGES、神煞 SHEN_SHA(38)、六十甲子納音 NA_YIN(30音/60組)、刑冲合会 INTERACTION_TYPES(8)、一般用語 GENERAL_TERMS(40+)。

各エントリは key、zh、en、オプションの pinyin、英語 definition を持ちます。主力関数 translate() は決して投げません——認識できない入力はそのまま返すので、エンジンの生出力をそのままパイプできます。

bazi-chart：任意の命式をバイリンガルにレンダリング

命式データを <BaziChart /> に渡すだけ。入力形状を自動検出し、正規化してレンダリング——追加設定不要。四柱、五行スコアバー、刑冲合会パネル、大運タイムライン、補助宮位を完全レンダリング。スタイルはインラインのみ——CSSインポート不要、SSR対応。

独自エンジンをお持ちなら、bazi-chart がそのまま対応——コミュニティで最も一般的な2つのデータ形状を自動検出し、手動構築の NormalizedChart も受け付けます。

インストールと組み合わせ

npm install bazi-engine bazi-chart   # フルスタック
npm install bazi-chart               # レンダリングのみ
npm install bazi-terms               # 用語のみ

すべてESM+CJSデュアルビルド、完全TypeScript型宣言付き。

なぜチェーン全体をオープンソースにしたか

多くの八字プロジェクトはアルゴリズムかUIのどちらかだけをオープンソースにしています。私たちは3層すべてを開きました。それぞれに独立した再利用価値があるからです。

八字アプリ開発中？ bazi-engine + bazi-chart で数ヶ月分のインフラ作業を節約。既にエンジンがある？ bazi-chart はエンジン非依存。正確な日中対訳用語が必要？ bazi-terms はゼロ依存。

AskingMingについて

bazi-kit は AskingMing からオープンソース化されたツールチェーンです——AI駆動の八字インサイト・自己成長プロダクト（今ご覧のサイトそのもの）。ただしこれらのツールはこの分野で開発する誰でも使えるよう設計されています。

まだ初期段階（v0.1.x）ですので、フィードバックを心より歓迎します。

このチャートレンダラーが実際にどんな見た目か見たいですか？ 生年月日時刻を入力して、ご自身の八字命式をすぐに生成できます：無料八字排盤。

GitHub： https://github.com/favkit/bazi-kit · npm： bazi-engine / bazi-terms / bazi-chart