計算・根拠・解釈・検証

4層のプロセス

1. 01

   計算：命式はアルゴリズムが作成する

   暦の換算、節気の時刻、タイムゾーン、真太陽時の補正、四柱の干支、蔵干、大運の順行・逆行と起運の時期は、すべて決定論的アルゴリズムで計算され、構造化フィールドに書き込まれます。言語モデルはこの段階には関与せず、生年月日から四柱を直接推測することも許可されていません。

2. 02

   根拠：結論は根拠を列挙できなければならない

   日主の強弱、十神の配置、合・冲・刑・害、調候と格局は、すべて一つずつ確認できる根拠項目として出力されます。どの月令か、どこに通根しているか、どの干支が作用しているか。スコアはこうした根拠を内部的に表したものにすぎず、判断そのものではありません。

3. 03

   解釈：AI は表現を担い、計算は担わない

   言語モデルは構造化された根拠を読みやすい解釈に書き換え、その結論が当てはまる条件を説明します。流派による見解の違いがある場合は、相違点と現在採用している優先順位を示し、どちらか一方を唯一の正解として装うことはしません。

4. 04

   検証：出力前に整合性と境界のチェックを行う

   解釈を生成した後、それが構造化された根拠項目までたどれるかを確認し、テーマごとの境界に沿って高リスクな内容をフィルタリングします。整合性チェック（用神・喜神・忌神・仇神が互いに異なること）は、用神を決める層における厳格な制約です。調候表が示す補助的な五行が「忌神を生むもの」と重なる場合は、機能の定義に従って再割り当てし、日主×月支の全120通りの組み合わせについて回帰検証を行います。

Engine version and changelog

Every algorithm fix that changes computed output bumps the engine version and is recorded here. A saved chart whose version no longer matches the current one is treated as stale and recomputed — using the same birth details stored alongside it, so conventions such as true solar time are not lost. In the rare case where an early record lacks the fields needed (year, month, day, hour, minute) it cannot be recomputed faithfully, so we keep the original chart rather than guess at one. Copy and layout changes do not bump the version.

Changelog

1. v52026-09-25

   黄历吉时判定改用黄道黑道十二神

   Affects: Almanac

   此前吉时是按「当日宜的条数多于忌的条数」推断的，方向性是错的：实测 2026-09-25 会把 5 个黑道时辰列为吉时，反而把当天唯一的青龙黄道时辰（庚子）列为凶时。现改为按十二值神的黄道/黑道属性判定；引擎异常时返回 degraded 标记，页面显示「暂无数据」而不是编造吉时。同一天还把 Web 端与引擎包里逐行相同的两份黄历实现合并为一份，避免两端算出不同结果。

2. v42026-09-20

   年柱改以立春为界，闰月盘与平月盘分开缓存

   Affects: BaZi · Zi Wei Dou Shu

   年柱此前按农历正月初一切换，导致立春到春节之间出生的人年柱错误；现以立春为界。同时紫微斗数的缓存 key 加入 isLeapMonth —— 此前闰月盘与平月盘共用同一个 key，会互相污染（缓存版本因此从 v3 提到 v4）。

3. v32026-09-20

   时干改用五鼠遁

   Affects: BaZi

   部分时辰的时干存在偏移，现统一按五鼠遁由日干推时干。

4. v22026-09-20

   修复 computeBaziAccurate 在特定输入下崩溃

   Affects: BaZi

   特定出生信息组合会让排盘函数直接抛错，导致整个结果页不可用。

5. v12026-09-20

   引入引擎版本号（回溯起点）

   Affects: All

   此前没有版本概念，缓存失效靠人工改字符串。v1 是补记的起点，用于让后续版本号有参照。

Reproducible verification

These numbers can be reproduced directly — the commands live in the repository. We also pin known deviations with tests: a test list that only reports passes is not informative; one that states exactly where we differ is.

Engine regression tests (divination-core, bun test)

110

Web and mobile tests (bun test lib apps/mobile) · 29 files

215

Total: 325 · 2026-09-29

What the tests pin down

• Day-pillar anchor: 1949-10-01 = 甲子. The old implementation returned 庚申/戊子 and drifted with the host time zone.
• Every 子 hour's stem follows the five-rat rule. The old implementation got the stem wrong for *every* 子 hour because of a rotated-array index error (a 癸 day's 子 hour should be 壬子; it returned 甲子).
• The year pillar switches at 立春, not at the lunar new year.
• Leap-month birthdays must land on the leap month itself. Measured on 2023 leap second month, day 20: the old implementation was 30 days off and placed palaces differently in the second half of the leap month.
• **Known deviations are pinned explicitly**: 23:00 does not roll the day pillar (early/late 子 hour is a genuine school disagreement; BaZi here uses the 子正 rollover), and solar-term day boundaries use an approximation table rather than a second-precise solar-term instant. These are known, test-recorded behaviours — not undiscovered defects.

Passing tests show the implementation matches the conventions we state. They are not evidence that the method itself is scientifically validated.

私たちが採用している基準

四柱推命には、同じくらい根拠のある伝統的なやり方が複数あります。私たちの原則は、一つの方法を固定し、記録し、検証できるようにすることであり、ページごとに異なるルールを使うことではありません。

時刻の基準

既定では入力された時計時間を使用します。真太陽時は任意の補正で、有効にされ、かつ出生地の経度が入力されている場合にのみ、経度と均時差に基づいて調整し、結果に補正後の時刻を記録します。

年柱の境界

立春の具体的な時刻で切り替えます。元旦も旧正月も使用しません。

月柱の境界

十二節（節気）の具体的な時刻で切り替え、旧暦の月とは関係ありません。

子の刻の日付切り替え

晩子の刻を当日とするか翌日とするかは流派による違いで、どちらのやり方にも使用者がいます。私たちの実装では一つのルールを固定して一貫させています。別の習慣をお持ちの場合、日柱と十神が全体的にずれるので、それを手がかりに違いを確認できます。

日主の強弱と用神の取り方

扶抑と調候は別々に計算し、**両方の層の結論を命式の結果に表示します**。両者が異なる方向を示す場合は、相違点、現在どちらの層を採用しているか、なぜそう選んだのかを説明します。違いそのものは誤りではありません。扶抑が問うのは日主が担えるかどうか、調候が問うのは季節の寒暖燥湿であり、これは二つの異なる問いです。

しきい値付近の命式

日主の強弱は、複数の加減点を一つの素点に累積し、75 / 60 / 40 / 25 で区分します。素点がしきい値の 3 点以内に入る場合は、命式の結果にそのまま明示し、二つに分けます。またいだ先で別の用神の取り方に変わるもの（五神もそれに伴って変わる）と、等級の名称だけが変わるものです。等級分けは推測ではありません。用神選択の分岐は、仮定した等級に対して評価できる純粋関数として切り出してあり、しきい値の両側で完全な五神（用神 / 忌神 / 喜神 / 仇神 / 閑神）をそれぞれ計算し、一字ずつ照合します。実測では、約四割の命式がどれかのしきい値の 3 点の許容範囲に入ります。

私たちが行わないこと

• 健康

  病気の診断、身体状態の判断、治療の助言は提供しません。健康上の問題は専門の医療従事者にご相談ください。

• 投資と財務

  株式、投資信託、暗号資産の売買タイミングは提供せず、具体的な価格の予測も行いません。財務上の意思決定は、適切な金融情報に基づいて行ってください。

• 法律

  法律上の意見は提供せず、訴訟の結果を判断することもありません。

• 身体の安全

  危険、事故、寿命について断定的なことは述べません。安全に関わる問題は、現実の専門家の助けを求めてください。

• 人生の重大な決定

  結婚、移住、退職などの決定で、命理の結論を唯一の根拠とすることはしません。

• 断定的な予言

  具体的な出来事の日付や結果を約束するものではありません。当サービスにおける命理は伝統文化の参照枠であり、現代科学としての有効性を主張するものではありません。

既知の制限

• 出生時刻が不正確な場合、時柱に関する結論の信頼性は明確に低下します。とくに時辰や節気の境界に近いときはその傾向が強くなります。
• 流派の違いは「解決」できません。できるのは説明することだけです。私たちは相違点を隠さず、明記します。
• 境界付近の命式には注記を付けますが、**注記があるからといって結論が固まるわけではありません**：スコアがしきい値に近い場合、重み付けの基準を変えるだけで用神の方向が逆になることもあります。この不確実性は消せないため、明示するしかありません。「しきい値をまたぐと用神が変わるかどうか」は**命式ごとに計算した結果**であり、推定ではありません —— ただし、あくまで現在の基準における答えです。
• 一部の調候の組み合わせにおける仇神のラベルは、機能に基づくフォールバックで決定しています（古典的な調候の補助五行は喜神として優先的に残します）。厳密な「忌神を生じるもの」という定義とはやや異なりますので、こうした組み合わせでは「用神の根拠」を優先してください。
• AI の解説には言い回しのずれが生じることがあります。ある解説が根拠レイヤーで裏付けられない場合は、命式と根拠フィールドを優先してください。
• 私たちは訂正を受け付けます。命式やルールに誤りを見つけた場合は、フィードバック窓口からご報告ください。今後のバージョンで修正します。

よくある質問

関連項目

• 出生時刻・タイムゾーンと真太陽時：命式を立てる前に時間を正しく計算する
• 身強・身弱の見方：日主の強弱は点数ではない
• 喜用神の理解：「欠けているものを補う」ではない
• 調候とは何か：寒暖燥湿がなぜ四柱推命の判断に入るのか