# Quizzman Insight – 四柱推命エンジン
## Quizzman暦法・天文計算基盤に基づく子平八字計算システム

- HTML 白書：https://insight.quizzman.com/tool/about-bazi-jp
- 命式算出ツール：https://insight.quizzman.com/bazi-chart
- Markdown（本文）：https://insight.quizzman.com/tool/about-bazi-jp.md
- 暦法基盤：https://calendar.quizzman.com
- 監査報告：https://insight.quizzman.com/tool/about-bazi-audit
- 言語：日本語 (`lang=ja`)

---

## 基本設計理念

> **設計理念：** BaZi Engineは単なる簡易命式作成ツールではありません。**Quizzman独自の高精度天文暦法基盤上に直截構築された、学術的・決定論的命理計算エンジン**です。古典子平学の原典理論と天文学的位置計算モデル、連続時間規格を融合し、推命結果の完全な一貫性と透明な検証可能性を担保しています。

Quizzman Insight – BaZi Engineは、Quizzman研究エコシステム内で開発された子平八字（四柱推命）命式作成・構造解析エンジンです。一般的な民生用暦のように太陽暦の生年月日を単純な干支テーブルに機械的に当てはめる方式とは異なり、四柱の各柱が形成される厳密な天文学的根拠、境界条件の定義、アルゴリズムの検証可能性を最重要視しています。

---

## 1. 四柱推命（子平八字）とは何か？

四柱推命（八字 / 子平）は、生年月日の4つの時間軸から導出される8つの十干十二支（干支）によって構成されます：

| 柱位 | 干支の構成 | 天文学的決定基準と伝統的象徴 |
| :--- | :--- | :--- |
| **年柱** | 誕生年の天干と地支 | 天文学的**立春（太陽黄経315°）**の節入り時刻を基準に厳密に年の干支が切り替わります。祖先、家系、幼少期の環境を表します。 |
| **月柱** | 誕生月の天干と地支 | **二十四節気**の各節入り時刻に基づき決定（立春建寅より開始）。両親、社会環境、季節性および五行の司令（月令）を表します。 |
| **日柱** | 誕生日の天干と地支 | 日干は**日主（日元）**と呼ばれ、本人の本質を表します。日支は配偶者宮（配偶者との関係）を表します。 |
| **時柱** | 誕生時刻の天干と地支 | 地方時（真太陽時）と日干の組み合わせ（五鼠遁法）によって算出。子供運、晩年期、内面的精神世界を表します。 |

---

## 2. 暦法基盤：Quizzman Calendar Engine

四柱推命の計算において最大の鍵となるのは、背後で時間と暦を算出する基盤システムです。Quizzman Calendarは**完全独立した高精度天文暦法計算エンジン**です。

- 暦法基盤：https://calendar.quizzman.com

### 2.1. 天文力学モデルに基づく精密計算
- **VSOP87惑星位置解析理論：** 太陽視黄経（$\lambda_\odot$）を精密に計算し、二十四節気の交替時刻（節入り）を分単位以下の高解像度で算出。
- **ユリウス日（Julian Day）：** 連続的時間尺度を採用し、歴史的な暦法改訂（グレゴリオ暦導入時の日付跳躍など）による干支の断絶を排除。
- **二十四節気：** 太陽黄経が15°進むごとの天文学的瞬間を特定し、固定日付での概算による誤差を完全排除。
- **朔望月と合朔：** 経度・タイムゾーンに基づき新月（合朔）の瞬間を算出。
- **歴史的法定时区データベース：** ベトナムおよび東アジア各地域の夏時間・標準時変更履歴を網羅。

### 2.2. なぜ節気が四柱推命において決定的なのか？
正統な子平推命では、**年の境界および月の境界は、旧正月の元日でもグレゴリオ暦の元旦でもありません**：
- **年柱の交代：** 厳密に**立春（黄経315°）**の交替時刻を基準とします。
- **月柱の交代：** 各月の中気ではなく節入り（立春、啓蟄、清明、立夏...）の瞬間ごとに切り替わります。

*境界例：* **2026年2月3日**生まれの場合、2026年立春の節入り前であるため、太陽暦は2026年ですが四柱推命では依然として**乙巳年（蛇年）**となります。

---

## 3. BaZi Engine の機能構成

- **四柱推命の完全命式算出：** 年月日時四柱の八字と納音五行を正確に算出。
- **通変星・十神マトリクス（100組）：** 比肩、劫財、食神、傷官、偏財、正財、偏官（七殺）、正官、偏印、印綬（正印）の全100組の相互関係を完全網羅。
- **地支蔵干と配分比率（%）：** 十二地支の余気・中気・本気を分類し、司令日数に応じた比率を数値化。
- **五行バランスと用神の基礎提示：** 天干と蔵干の配分から木火土金水のスコアを総合し、身強・身弱の傾向と用神の基盤を提示。
- **10年大運の精密計算：** 年干の陰陽と性別による順行・逆行の判定。「3日＝1年」の規則に基づき起運年を精密算出。
- **26種の標準神殺の算出：** 天乙貴人、文昌貴人、駅馬、紅艶、華蓋、羊刃、天徳貴人、月徳貴人など26種を体系化。
- **干支の合衝刑害の自動判定：** 天干五合、地支六合、三合会局、半合、地支六冲、三刑・自刑、相害、相破などの干支相互作用を解析。

---

## 4. 計算パイプラインと REST API

```
生年月日・時刻・時区
          │
          ▼
ユリウス日（JD）とUTC+7標準化
          │
          ▼
VSOP87太陽黄経と二十四節気解法
          │
          ▼
立春年柱 · 節気月柱 · ユリウス日日柱 · 五鼠遁時柱
          │
          ▼
地支蔵干比率展開と五行エネルギー行列
          │
          ▼
通変星マッピング · 大運順逆推算 · 26神殺検証
          │
          ▼
構造化JSONデータ出力 (UI / REST API)
```

### REST API：
- `POST /api/tool-module/bazi/calculate` — 命式の完全算出
- `GET /api/tool-module/bazi/ten-gods` — 通変星マッピング一覧
- `GET /api/tool-module/bazi/hidden-stems/:chi` — 地支蔵干と重み比率の取得
- `POST /api/tool-module/bazi/luck-pillars` — 大運タイムラインの算出
- `POST /api/tool-module/bazi/shen-sha` — 神殺の判定リスト取得
- `POST /api/tool-module/bazi/compatibility` — 二者間の干支相性・合衝判定

---

## 5. 精度とアルゴリズムの検証

2026年2月実施の自動テスト結果：

| テスト対象 | 検証結果 | カバー範囲 |
| :--- | :--- | :--- |
| **BaZi Engine** | **128/128件 合格（PASSED）** | 四柱干支、立春交替、節気月割、通変星、蔵干比率、大運、神殺 |
| **Calendar Engine** | **108/108件 合格（PASSED）** | UTC+7天文同期、閏月判定、太陽黄経度数および至点・節気点 |
| **通変星マトリクス** | 100/100組 全網羅 | 日干10種×各干10種の全組み合わせ検証 |
| **地支蔵干** | 12/12支 全網羅 | 十二地支の本気・中気・余気の比率整合性 |
| **神殺判定** | 26種標準神殺 | 全トリガー条件のロジック整合性検証 |

> **テスト指標の意義：**
> 「内部テスト128/128件合格」とは、公開時点における内部回帰テストスイートで設定された全エッジケースを完全にクリアしていることを示します。
>
> **この指標は、あらゆる歴史的古籍や主観的解釈流派における「絶対的な唯一性」を主張するものではありません。**
>
> Quizzmanでは独立した第三者機関（例：*Jade Almanac*とのクロス検証計画）による客観的対照評価を推進しています。

---

## 6. 依拠する古典文献

1. **『淵海子平』：** 徐升（徐子平遺法）、日干本位の理論を確立し、通変星体系の基礎を築いた原典。
2. **『三命通会』：** 万民英、明代以前の命理諸説、神殺体系、納音格局を集成した大百科書。
3. **『滴天髄』：** 京図原著/劉基注、五行の体用と気勢流転を深く論述した最高峰の理論書。
4. **『子平真詮』：** 沈孝瞻、月令用神と格局の純雑・成敗救応を論理体系化した著作。
5. **『窮通宝鑑』：** 余春台編、季節の寒暖燥湿と十干の調候用神論に特化した著作。

---

## 7. 利用範囲と免責事項

1. **暦法・天文計算：** 節気交替の時刻、陰陽暦の変換、時区補正、六十干支の巡回は客観的・数学的に検証可能な天文学的領域です。
2. **伝統的命理推論：** 性格傾向や運勢に関する定性的解釈は伝統的象徴解釈の枠組みであり、**現代実証科学における因果関係とは異なります**。

**Quizzmanは人の運命を絶対的に予言できると主張することは決してありません。**

---

## Quizzman Insight – BaZi Engine の探索

- **四柱推命ツール：** https://insight.quizzman.com/bazi-chart
- **Quizzman Calendar：** https://calendar.quizzman.com
- **Quizzman Wiki：** https://wiki.quizzman.com
- **Quizzman Insight Hub：** https://insight.quizzman.com

*Quizzman Insight – 現代の計算工学に基づく東洋伝統数理の研究。*
*© 2026 Quizzman. All rights reserved.*