Qimen Dunjia & BaZi Charts

qimen-dunjia-engine

Node.js 向け奇門遁甲（奇门遁甲）盤面計算エンジン — 決定論的で、AI／LLM に依存せず、純粋な計算を行います。

时家转盘法 · 置闰符头定元 · 值使独立转门

実測データ（すべて再現可能で、スクリプトは verify/ にあります）：全件を44,064回走査してクラッシュ0件、不変条件違反0件。41種類の格局について、該当盤が一度もない割合は0％。常に真となるルールなし、実行されないルールなし。拆补と置闰の相違率は41.6％。書籍掲載例を2組監査（142例と79例。それぞれ独立した基準で集計しており、合算できません）。

このエンジンを選ぶ理由

多くのオープンソースの奇門遁甲ライブラリは、細部を省略しています。このエンジンは、古典的な主流ルールを忠実に実装しています。

ルール	他のライブラリでよくある簡略化	このエンジン
置闰による局の決定	約5日単位の概算	符頭ベース：節気の帰属は符頭の日で決定します（上元符头 = 甲子／甲午／己卯／己酉）
值使門	值符星と同じ宮に入り、回転を省略	旬中の時干の位置から独立して回転します
転盤の経路	宮の順序を1-9とする	宮の順序は [1,8,3,4,9,2,7,6]
検証	せいぜいスポットチェック	44,064盤を走査し、5つの不変条件を適用 — verify/

機能

• 時家転盤法、拆补、置闰、超神接气による局の判定
• 盤全体：地盤、天盤、九星、八門、八神、遁干
• 格局の検出：実際の計算で41種類の格局を検出します。伏吟、反吟、門迫、撃刑、入墓、青龍返首、飛鳥跌穴、玉女守門、三奇得使、十干克応の組み合わせなど
• 馬星、旬空、年干・月干の寄宮
• lunar-javascript を使用した、年・月・日・時の四柱（干支）計算
• ネットワーク通信なし、AI 不使用 — 実行するたびに同じ数値を出力

インストール

# Install straight from GitHub (npm supports this natively)
npm install github:wyl743405571-cpu/qimen-dunjia-engine

# Or clone + install
git clone https://github.com/wyl743405571-cpu/qimen-dunjia-engine.git
cd qimen-dunjia-engine && npm install

# npm registry package: coming soon

使い方

const qimen = require('qimen-dunjia-engine');

// year, month, day, hour, minute, method: 'zhirun' | 'chaibu' | 'shenjieqi'
const chart = qimen.paipan(2026, 6, 7, 11, 0, 'zhirun');

console.log(chart.juNum);        // 6  (Yang Dun 6)
console.log(chart.isYang);       // true
console.log(chart.zhiFuXing);    // 天蓬 — Zhi-Fu star
console.log(chart.zhiFuGong);    // 4
console.log(chart.zhiShiMen);    // 休门 — Zhi-Shi door (independently rotated)
console.log(chart.zhiShiGong);   // 3
console.log(chart.dp);           // earth plate stems, keyed by palace 1-9
console.log(chart.tp);           // heaven plate stems
console.log(chart.xing);         // 9 stars by palace
console.log(chart.men);          // 8 doors by palace
console.log(chart.shen);         // 8 gods by palace
console.log(chart.geju);         // detected formations [{name, level, gong, detail}]
console.log(chart.maGong);       // horse palace
console.log(chart.kong);         // void branches, e.g. ['寅','卯']
console.log(chart.ygz);          // four pillars: year/month/day/hour ganzhi

9宮すべての盤を出力する実行可能なデモについては、examples/basic.js を参照してください。

出力項目の説明

項目	意味
juNum / isYang	局数（1–9）と陰遁／陽遁
method	zhirun / chaibu / shenjieqi
xun / kong / kongGongs	時の旬、空亡の地支、空亡の宮
zhiFuXing / zhiFuGong	值符星とその宮
zhiShiMen / zhiShiGong	值使門とその宮
dp / tp	各宮の地盤／天盤の干
xing / men / shen	各宮の星／門／神
dunGan	遁干
geju	吉凶レベル付きで検出された格局
maGong	馬星の宮（驿马）
ygz / mgz / dgz / hgz	年柱／月柱／日柱／時柱

対象範囲

このパッケージが計算するのは盤面のみです。 解釈、判断ルール（用神／断法）、事例ライブラリは含まれていません。これらは QiMenSeek の製品レイヤーに属する資産です。

このエンジンは流派に関して、特定の側面を考慮しています。主流の時家転盤の伝統を実装しており、飛盤の盤面は計算しません。

テストと検証

npm test    # 3 known-good snapshot charts + plate-structure invariants

これはサンプル盤を3つ確認するだけです。実際の数値を確認するには、計測スイートを実行してください。この README に記載されている数値はすべてこれらのスクリプトから得られるもので、お使いのマシンでも同じ出力が得られます。

node verify/sweep_coverage_v2.js 2000 2050   # 44,064 charts: 0 crashes, 0 invariant violations
node verify/measure_divergence.js 30# 12,960 moments: 41.6% of charts differ between Chaibu/Zhirun
node verify/measure_geju.js 10                # 41 formations, 0% zero-hit charts, no dead rules
node verify/audit_book_cases.js               # 142-case classical library audit
node verify/audit_book_cases_v2.js            # 79-case 1990s casebook audit (incl. Shen Jie Qi mode)

各スクリプトで検証できること、検証できないこと、そしてスクリプトの作成中に遭遇した計測上の落とし穴については、verify/README.md を参照してください。

隠していない既知の制限事項

142件の古典書籍ライブラリ（verify/book_case_library_tagged.json、95.8％にページ引用あり）では、書籍に記載された局数を、拆補では64.9％（検証可能な97件中63件）、置閏では42.6％（94件中40件）の割合で再現します。142件のうち、期待される判定が付いているのは51件だけで、そのうち45件はOCRで抽出されたもので、現在もneedsReviewのフラグが付いています。したがって、このライブラリは回帰テストの検討に使用し、精度の主張には使用しないでください。

2つ目の独立したライブラリ（verify/book499_case_library.json、1990年代の事例集から収録した検証可能な79件）では、書籍に記載された局数を拆補で82.3％（79件中65件）、沈解奇モードで91.1％（79件中72件）の割合で再現します。このモードの性質にご注意ください。これはこの事例集自体のデータから適合させたものです。この書籍の内容を説明するものであり、「より古典的」であると主張するものではありません。デフォルトは引き続き拆補です。境界事例のうち説明できない5件は、スクリプト自体に記載されています。2つのライブラリは混在していません。書籍も分母も異なります。

ライブツール

• 無料のオンライン計算機：https://qimenseek.aicreditsapi.com/calculator.html
• 今日の盤と日々の詩句：https://qimenseek.aicreditsapi.com/daily.html
• 公開済みの作盤ルールセット（口径公開）：https://qimenseek.aicreditsapi.com/ruleset.html
• 学派間の差異を測定したレポート：https://qimenseek.aicreditsapi.com/divergence
• このエンジンが生成した実際の占例8件：https://qimenseek.aicreditsapi.com/cases
• MCP エンドポイント（Claude/Cursor）：https://qimenseek.aicreditsapi.com/mcp · ドキュメント：https://qimenseek.aicreditsapi.com/mcp.html · ローカル stdio サーバー：mcp/README.md

エンドユーザー向けガイドと記事

開発者だけでなく、実際の決断に直面している人々に向けて、これらの平易な言葉で書かれたガイドでは、この体系を説明しています（神秘主義に頼らず、推論をすべて示し、主張の根拠をすべて盤の記号に示します）。また、無料ツールへのリンクも掲載しています。

• 奇門遁甲を「時空意思決定システム」として翻訳する理由
• Co-Starは「機能する」のでしょうか？奇門遁甲の視点から

目次：articles/README.md

ライセンス

MIT