玄学管家（Metaphysics Steward）

覆盖 7 种传统中式推演术数的专业排盘工具，强调天文精度与交叉验证。

能力清单（七法 + 合婚）

术数	引擎文件	能力
八字 Bazi	scripts/core/bazi.py	四柱精确到节气时刻换柱；十神、藏干、纳音；大运起运（3日=1年）与十年大运
紫微斗数 Ziwei	scripts/core/ziwei.py	12 宫与 14 主星；年系四化；五行局；宫位渲染
大六壬 Da Liuren	scripts/core/liuren.py	中气定月将；四课三传九宗门全口径（贼克/比用/涉害·临位孟仲季/遥克·蒿矢先弹射/伏吟/返吟/八专/昴星）；逐传六亲·遁干·空亡·天将
奇门遁甲 Qimen	scripts/core/qimen.py	3x3 九宫渲染：八神、九星、八门、天地盘；拆补法定局
梅花易数 Meihua	scripts/core/meihua.py	时间起卦与数字起卦；本卦/互卦/变卦；体用
金口诀 Jinkoujue	scripts/core/jinkoujue.py	人元、贵神、月将、地分四层课式
六爻 Liuyao	scripts/core/liuyao.py	铜钱/数字/时间三法起卦；定卦名定宫；安世应；纳甲；配六亲；装六神；动爻变卦
八字合婚 Hehun	scripts/core/hehun.py	双造同排；生肖六合冲害、年命纳音、日干五合、夫妻宫六合三合冲刑、五行互补；综合评分

排盘口径

• 八字/紫微/六爻以 真太阳时（经度 + 均时差修正）为排盘基准时刻
• 大六壬/金口诀/奇门以 民用时间（钟表时间） 起课
• 节气换柱、奇门拆补、六爻装卦等口径经大量实测验证（已 golden 锁定）

使用

cd scripts

# 综合（八字+梅花+奇门+紫微+六壬+金口诀+六爻 时间起卦）
python3 steward.py --birthdate "1990-02-04 10:40" --sex 1 --birthplace 116.4 --mode all

# 单法
python3 steward.py --birthdate "1990-02-04 10:40" --sex 1 --mode bazi
python3 steward.py --birthdate "1990-02-04 10:40" --mode qimen
python3 steward.py --birthdate "1990-02-04 10:40" --mode ziwei
python3 steward.py --birthdate "1990-02-04 10:40" --mode liuren

# 梅花 / 六爻（数字起卦）
python3 steward.py --mode meihua --numbers "123,456,7"
python3 steward.py --mode liuyao --birthdate "2026-09-12 12:00" --numbers "12,34,56"

# 六爻（手工指定爻值 6/7/8/9，自初爻到上爻）
python3 steward.py --mode liuyao --birthdate "2026-09-12 12:00" --yao "7,7,7,7,7,7"
# 六爻（铜钱：每爻背数 0-3，自初爻到上爻；3背=老阳动、0背=老阴动）
python3 steward.py --mode liuyao --birthdate "2026-09-12 12:00" --coin "3,1,2,1,2,1"

# 八字合婚（双造同排）
python3 steward.py --mode hehun --male "1990-02-04 10:40" --female "1991-01-01 12:00" --birthplace 116.4

# JSON 输出（供程序调用）
python3 steward.py --birthdate "1990-02-04 10:40" --mode json

参数

参数	说明
--birthdate	YYYY-MM-DD HH:MM，缺省用当前时间
--sex	1 男/乾造，0 女/坤造
--birthplace	经度或城市名（北京/上海/西安/合肥等），用于真太阳时
--mode	bazi/ziwei/liuren/qimen/meihua/jinkoujue/liuyao/hehun/all/json
--numbers	梅花/六爻 三数起卦
--yao	六爻手工指定 6 个爻值
--coin	六爻铜钱 6 个背数
--difen	金口诀地分
--male / --female	合婚：男/女命出生时间
--male-lon / --female-lon	合婚：双方出生经度/城市
--no-true-solar	八字日/时柱不校正真太阳时

参考资料

• references/liuyao_najia.md — 六爻纳甲装卦规则
• references/liuyao_lost_items.md — 六爻寻物断法
• references/hehun_rules.md — 八字合婚要则
• references/meihua_notes.md — 梅花易数实现说明
• references/LUNAR_PYTHON_REFERENCE.md — lunar-python API 笔记

依赖

• lunar-python：公农历、干支、节气（>= 1.4）