bazi-mingli

name	bazi-mingli
description	四柱八字与紫微斗数命理排盘推演，兼梅花易数、六爻、奇门遁甲占测。当用户提供生辰要求算命、批八字、看命盘、看紫微星盘、合婚、测运势/事业/财运/婚姻/健康、分析五行喜用神大运流年/十二宫大限小限，或要起卦占一件具体的事（梅花起卦、六爻摇卦装卦、奇门排盘起局、占卦问事求测成败）时使用。排盘、安星、起卦、装卦、排局均由脚本精确计算，推演按固定方法论逐层展开、每条断语标依据。
license	PolyForm Noncommercial 1.0.0
metadata	{"trigger":"/bazi-mingli","version":"1.14.0","engine-version":"1.3.1","meihua-version":"1.0.1","liuyao-version":"1.0.1","ziwei-version":"1.1.0","qimen-version":"1.1.0"}

八字命理 · 精确排盘与系统推演

一套可复现、有据可依的四柱八字命理引擎。定位是「像做技术分析一样算命」：排盘交给脚本算准，推演按固定方法论逐层展开，每个结论都标注依据（出自哪个十神 / 宫位 / 用神 / 大运），孤证不立，中间推理全程透明。

核心原则（贯穿全程）

1. 排盘必用脚本：干支推算交给 scripts/paipan.py，绝不手推。手推最易错在三处：年柱用错正月初一（应以立春）、月柱用错农历月（应以节气）、忽略真太阳时。
2. 方法论固定顺序：排盘 → 定旺衰 → 取用神 → 判格局 → 析岁运 → 落十神六亲 → 分维度断语。先定旺衰用神，再谈一切，顺序不可乱。
3. 结论必带依据：每条断语后注明推理链，如「事业偏技术创作（伤官透月干为用 + 食神生财）」。不写无依据的泛断。
4. 一象多看：每个重要结论至少两处佐证（星 + 宫，或 原局 + 岁运），单一信号不下死断。
5. 展示推理过程：本 skill 面向研究与深度分析，完整呈现中间推演（旺衰打分、取用逻辑、格局成败），不只给结论。
6. 命理是概率与倾向，非宿命：用「易…、倾向、利于、需注意」等语气陈述趋势，落到可执行的趋避建议；不做铁口直断祸福。

第 0 步 · 收集与确认输入

必需信息：

• 出生日期：阳历或农历，年、月、日。（默认按阳历；用户说农历/阴历则加 --lunar）
• 出生时间：时、分。口语时间换算：早上8点=08:00，下午2点半=14:30，晚上11点=23:00。
• 性别：男 / 女（决定大运顺逆排）。

可选信息：

• 出生地（经度）：用于真太阳时校正，提升时柱精度。已知城市可用其经度（如北京116.4、上海121.5、广州113.3、成都104.1）。
• 不知道出生时间时：可只排年月日三柱，但须声明：时柱主子女、晚年、部分格局与时支神煞将缺失，结论存在局限，建议尽量回忆时辰。

确认信息无误后再排盘。信息有歧义（如农历阳历不明、闰月）必须先问清；用户生在农历闰月的，脚本里用负数月输入（如 -2 = 闰二月）。

第 1 步 · 精确排盘（运行脚本）

在本 skill 所在目录下运行（脚本位于 skill 目录的 scripts/ 下，装在别处按实际安装路径调整）：

python3 scripts/paipan.py <年> <月> <日> <时> <分> --gender <male|female> [选项]

常用选项：

• --lunar：输入按农历；闰月用负数月表示（如 -2 = 闰二月）
• --lng <经度>：启用真太阳时校正（如 --lng 113.3），范围 -180~180，东经正、西经负
• --tz <时区偏移>：出生地时区（默认 +8，即东八区北京时间），配合 --lng 使用
• --years <起始年> <年数>：指定流年区间（如 --years 2024 12），默认从当前干支年（按立春分界）起 10 年
• --json：输出 JSON（需要结构化处理时）
• --zi-sect <1|2>：子时流派，1=晚子(23点)换日、2=不换日；出生在 23 点附近时声明所用流派
• --target-date <年> <月> <日>：指定公历日，输出其流年 / 流月 / 流日干支、十神与对原局的引动（流月以节气定月；断语止于月，流日只列干支事实，不做每日吉凶）
• --partner <年> <月> <日> <时> [分] 配 --partner-gender <male|female>：合婚第二人生辰（默认公历；乙方按农历时加 --partner-lunar，独立于主盘），一次排两盘并打印双盘交互表（见下「合婚」节）

支持公历 1600-2200 年；起运岁数按虚岁口径（与大运列表一致）。1986-1991 年中国夏令时期出生的，脚本会提示核对钟表时间。

脚本输出包含：四柱干支 / 五行 / 藏干 / 天干十神 / 藏干十神 / 纳音 / 星运（长生十二宫）/ 旬空 / 节气与星座 / 胎元命宫身宫 / 地支刑冲合会与天干合冲（自动检出） / 五行个数与缺失五行 / 五行力量加权分值与同党异党参考 / 神煞 / 大运（顺逆·起运·各步干支与十神）/ 流年。

把脚本输出的命盘完整呈现给用户，作为后续推演的事实基础。

第 2 步 · 读盘定盘面

从命盘提取关键要素，按 references/01_paipan_jichu.md 校验理解：

• 日主（日干）：命主本人，记其五行、阴阳。
• 月令（月支）：当令五行，旺衰第一权重。
• 天干透出的十神、地支藏干、通根情况。
• 地支之间的刑冲合害会（六合/三合/三会/六冲/相刑/六害），这是断动应、吉凶的关键，逐一标出。

第 3 步 · 判定日主旺衰（依据 references/02）

按「五看」综合判断，展示推理：

1. 月令得失（权重最大）：日主在月支的长生状态，得令/失令。
2. 通根：日主天干在四支有无同类根，坐下（日支）尤重。
3. 生扶：印星生、比劫帮的力量。
4. 党众：参考脚本给出的同党（印比）vs 异党（食伤财官）加权分值。
5. 定档：身强 / 身弱 / 均衡 / 从格。

量化分值只是辅助，月令权重远高于单纯计数。临界（同党 45%–55%）时回到月令与通根细辨，不可只看百分比。先排除从格/专旺的极端情形（见 references/05），再按常格论。

第 4 步 · 取用神定喜忌（依据 references/02 + 03）

按五法择用，优先级：调候 ≥ 扶抑 > 通关 > 病药；从格则顺势：

1. 调候：查 references/03_tiaohou_qiongtong.md，看日主生于该月所需调候用神是否在局中、是否有力。冬生无火、夏生无水须重点指出。
2. 扶抑：身强取克泄耗（官杀/食伤/财），身弱取生扶（印/比劫）。
3. 通关 / 病药：两行相战取通关；有忌神为病则取药。
4. 明确列出 用神 / 喜神 / 忌神 / 仇神 / 闲神，并说明取用理由。

用神是后续事业、财运、婚姻、健康、行业方位一切吉凶判断的总开关，务必论证清楚。

第 5 步 · 判定格局成败（依据 references/05）

1. 取格：以月令本气透干定格，不透取中气余气透出者，再不透以月令本气论。
2. 成败：顺用之格（官财印食）看是否得相神护卫、流通；逆用之格（杀伤刃枭）看是否得制化。指出成格、破格、或破后救应。
3. 特殊格局：核对是否构成从格、专旺、化气、魁罡等，条件须严格（尤其从格，一点根气即不成）。
4. 定层次：格成用旺 → 上；格成用弱或破而有救 → 中、起伏后成；格破无救 → 平常坎坷。

第 6 步 · 大运流年分析

• 大运：脚本已排好顺逆、起运、各步干支与十神。逐步看大运五行引动用神还是忌神：引用神之运为顺境（事业财运婚姻向好），引忌神之运为逆境（对应领域受挫）。注意大运与原局的合冲（尤其冲提纲、冲用神）。
• 流年：在当前/目标大运背景下，看流年干支与命局、大运的作用。重点关注：用神到位之年（机遇）、忌神当道之年（坎坷）、岁运并临、天克地冲、刑冲用神宫位之年。
• 应期：把「会发生何事」（十神类象）落到「何时发生」（具体大运流年），给出可参考的时间段。要把应期细到流月时，用 scripts/paipan.py --target-date <年月日> 取该日流年 / 流月 / 流日干支与对原局的引动；断语止于月，流日只作干支事实参考，不做每日吉凶。

第 7 步 · 十神六亲落宫（依据 references/04）

• 标出各十神所在宫位（年月日时），对应人生阶段与领域。
• 取六亲星（男财女官为配偶、印为母、偏财为父、官杀/食伤为子女、比劫为兄弟），看其旺衰喜忌与所居宫位刑冲，断六亲缘分厚薄、助力损益。
• 日支为夫妻宫，重点看婚姻。

第 8 步 · 分维度断语（依据 references/04）

按需输出，每维度结论后注明依据：

• 性格：日主五行阴阳底色 + 格局十神 + 最旺之神。
• 事业：官杀（管理/公职）/ 食伤（技艺/创作/自由）/ 印（文教研究）为用的方向 + 适宜行业方位（取用神五行）。
• 财运：财星旺衰、身能否任财、食伤生财、财逢冲夺；判富贵层次与得财方式、应财之运。
• 婚姻感情：夫妻星 + 夫妻宫 + 星与日主合冲 + 桃花红艳，四象交叉。
• 健康：五行过旺/受克绝对应脏腑（木肝胆·火心血·土脾胃·金肺·水肾），指出隐患与高发之运。
• 学业才华：印星、食伤、文昌华盖、官印相生 / 伤官配印。
• 六亲：父母、配偶、子女、兄弟缘分。

第 9 步 · 调候趋避与个性化调养（依据 references/15 16）

把用神落到可执行，分趋避、色彩服饰、调养三层：

趋避（环境与选择）：

• 方位：用神五行对应方位（木东·火南·土中·金西·水北），利发展的城市 / 方向。
• 颜色 / 数字 / 行业：用神色（木青绿·火红紫·土黄棕·金白·水黑蓝）概览、宜从事的行业属性；色彩怎么穿戴见下「色彩服饰」层。
• 避忌：忌神之运、之年的注意事项。

色彩服饰（穿戴随身环境，依据 references/16）：把用神色落到日常的衣着、配饰、首饰、随身物、居家办公环境，提升向、可执行。

• 认准标的：穿戴用神喜神所属色、节制忌神过旺所属色。缺的五行若为忌神则不穿不补，缺啥穿啥是误区。
• 颜色为主轴：颜色五行最有据；材质形状为辅；宝石玉石按呈现的主色取五行，只作参考，不神化、不承诺转运招财。
• 四个落地面：穿（用神色做服装主色）、戴（首饰配饰取用神色与材质）、随身物（手机壳 / 包 / 车 / 文具，低门槛高频补色）、环境（居家办公主色调与灯光冷暖，呼应调候）。
• 守边界：审美、得体、场合优先于五行，顺势调适、参考非转运。

养生调养（作息饮食情志，依据 references/15）：把命局的用神喜忌、缺失、过旺、寒暖燥湿、脏腑隐患，翻译成针对性的作息、饮食、情志、运动、起居建议，提升向、可执行。

• 认准标的：只补用神喜神所属五行、节制忌神过旺所属五行。缺的五行若为忌神则不补，缺啥补啥是误区。
• 三步生成：定标的（该扶 / 该泄的五行）→ 查五行调养总表译成作息饮食情志动养 → 叠加寒暖燥湿体质与脏腑隐患微调，每条带依据。
• 可结合习惯：默认纯基于盘给建议；命主愿意提供作息饮食运动居住现状，则二次校准，给三到五条低门槛小调整。
• 守边界：养生是辅助参考，务实非迷信、参考非医嘱，慢病急症孕产用药一律以医生为准。

第 10 步 · 综合总评

用 3–5 句收束：命局核心结构（日主+格局+用神一句话定性）、整体格局高低、一生大势起伏（哪些大运是关键转折）、最突出的优势与最需注意的短板。

第 11 步 · 可视化命书（默认交付，不再征询）

文字推演（第 0–10 步）完整给出后，直接产出一页可视化 HTML 命书，作为默认交付的一部分，不问「要不要」。仅当用户明确说只要文字版、不要 HTML 时跳过。若用户在任务开头就点名要 HTML 报告，视为已授权，推演完成即出。

默认口径无需确认：主题默认「我的一生」（用户只问单一维度时可换成对应主题，如「2027 事业运」）；信息按用户提供的原样呈现（自用场景）。仅当用户提到要对外分享、发布或入库时，才提醒一句脱敏（换虚构生辰重排，见 references/07 第七节）。

产出与交付规范：

• 输出位置：写入当前工作目录（用户指定目录则从之），文件名 命书-<姓名或代号>-<公历生日YYYYMMDD>.html。
• 交付动作：给出文件的完整绝对路径；在支持的环境下直接用系统命令打开（macOS open / Linux xdg-open / Windows start），打不开就给路径请用户点开。

产出依据 references/07_keshihua_baoshu.md，记住五条铁律：

• 内容零改动：HTML 只是文字推演的视觉化呈现，命盘、用神、断语必须与上文逐字一致，绝不为排版另造结论。
• 每个内容区块配「黑哥解读」白话框：把该段专业术语逐个翻译成普通人能看懂的话（只翻译不新增结论，比喻降维到给我妈能解释清楚，短句口语用「你」），独立卡片样式全卷统一，见 references/07 五之一节。
• 字体可靠性：中文以思源宋体（Noto Serif SC）为骨架，字体栈必须以系统宋体兜底（'Noto Serif SC','Songti SC','STSong',serif），断网也不塌字；视觉层次靠字重 300→900 拉开，不依赖未必安装的书法字体。
• 配色取命局：用神五行定主色调，全局一个朱砂、一个金做签名色，忌神色仅作点缀，不堆色。
• 同一口径：趋势化、带依据、不恐吓，与文字版一致；页脚保留「仅供研究参考」。

可视化是锦上添花，不替代推演的严谨。没有完整的第 0–10 步，不直接出 HTML。

第 12 步 · 交付后主动推进（分层交互协议）

命书交付不是终点。本 skill 的固定交互范式是核心自动跑到底、延伸功能主动列清单问一次。既不闷头停下什么都不提，也不默认把所有延伸功能全铺开。

自动层（跑到底，不问）：第 0–11 步核心命书 + HTML。用户给了生辰就一路做完、直接交付，中途不打断确认。

推进层（交付后主动列清单，用户点了才做）：核心命书给完后，主动递上一份「还能往下做什么」的简明清单，让用户挑。只列这个盘当前用得上的项（命中触发条件才列），一次问清：

可选后续	触发条件（命中才列）	走哪一支
合婚合参	用户尚未提供对方生辰	下方「合婚」段、references/17
指定流年 / 以果验时校时	想看某一年运势，或想用已发生的事反推校准时辰	第 6 步 + paipan.py --target-date、校时枚举
单维度深挖	某方面（事业 / 财 / 婚 / 健康 / 学业）想展开细论	第 8 步对应维度 + references/04、08
养生 · 色彩落地详单	想把调养建议做成可执行的作息 / 饮食 / 穿戴清单	第 9 步深化、references/15、16
紫微斗数详参	核心只跑了八字，想再看紫微星盘互证	scripts/ziwei.py、references/20
起卦占一件事	有一件具体的事想占（问事求测，非批一生）	梅花 / 六爻 / 奇门引擎，一事一占

措辞纪律：

• 一次问清、批量给选项：把命中项列成一份短清单同时递出，别一项一项挤牙膏式追问，也别默认全做把回复塞满一屏。
• 清单要短、每项一句话说清是什么；只列命中触发条件的项，用户挑几项就做几项。
• 用户说「就这样 / 不用了 / 够了」→ 干净收尾，不再追问。
• 这是主动提供一次选项，不是反复索取确认。提供一次即可，尊重用户自主推进。

合婚 · 双盘合参（依据 references/17）

用户要合婚（提供两人生辰）时走这一支：先各自按第 0–8 步排盘取用神，再按 references/17_hehun.md 五步合参（双方婚姻象 → 用神互补 → 日柱年支合冲 → 大运同步性 → 相处建议）。脚本一次排两盘并打印双盘交互表：

python3 scripts/paipan.py <甲生辰> --gender <X> --partner <乙生辰> --partner-gender <Y>

铁律：只输出相处模式与磨合点，禁打分制、禁「合 / 不合」二元判词。交互表只给可计算的关系事实（日干、夫妻宫、生肖合冲、五行互补），用神互补与相处判断由方法论推演。双方生辰均需本人知情同意；缺一方时辰时按 references/17 降级规则标注存疑；属相相冲一票否决、合婚煞法等旧法不取（见 references/10）。

梅花易数 · 起卦占事（第二引擎，依据 references/18）

用户要占一件具体的事（占卦、问事、求测某事成败）时，走梅花易数这一支；要批一生的走八字引擎。它是占卜，与八字命理分属两个引擎，各归各用、不混断。

起卦交脚本算准（先天八卦数取余定卦、互卦、变卦、体用定位最易手推错）：

python3 scripts/meihua.py --time <年> <月> <日> <时> [分]    # 时间起卦
python3 scripts/meihua.py --numbers <上数> <下数>            # 数字起卦
python3 scripts/meihua.py --gua <上卦数> <下卦数> <动爻> --query "所占之事"

脚本出本卦 / 互卦 / 变卦 + 体用定位 + 五行生克 + 类象 + 趋势化提示。据 references/18 断：体为自身、用为所占之事，本卦定当下、互卦看过程、变卦看终局；用生体 / 比和为顺，用克体为阻，结合卦气旺衰与万物类象落到可执行提醒。

铁律：占卜非命理、一事一占（同一事不反复摇卦）、趋势化不打分不铁口，不承诺祸福成败；碰上大事提示结合现实理性拍板。

六爻 · 摇卦装卦断事（第三引擎，依据 references/19）

用户摇了卦（报六次摇卦结果）或要用六爻细断一件事时走这一支。六爻与梅花同属易卦占事，多一整套装卦系统（纳甲干支、八宫世应、六亲、六神），断得更细。装卦交脚本装准：

python3 scripts/liuyao.py --yao <六位数> --date <年> <月> <日> [时] --query "所占之事"
# 六位数自初爻向上：6=老阴(动) 7=少阳 8=少阴 9=老阳(动)，如 787888
# --gua <上卦数> <下卦数> <动爻> 可直接指定（0=静卦）；--date 装月建/日辰/旬空/六神，交节日补第 4 个数（时）精确定月建

脚本出：本卦（卦名/宫/世应）+ 逐爻六神六亲纳甲干支 + 动爻与变卦 + 月建日辰旬空。据 references/19 断：按所测之事取用神（六亲对照表），看用神旺衰（月建日辰）、动静生克（回头生克）、空亡月破，世应关系断双方，六神辅象义，应期取值合冲之时。

铁律与梅花同：占卜非命理、一事一占、趋势化不打分；三引擎各归各用（八字批一生、梅花取象快断、六爻装卦细断），不混断。

紫微斗数 · 安星与十二宫初断（第五引擎，依据 references/20）

用户要看紫微星盘、批一生走紫微这一支时用这支，与八字同属命理（批一生），非占卜。安星（十二宫定位、五行局、十四主星、四化、六吉六煞、大限小限）交脚本算准：

python3 scripts/ziwei.py <年> <月> <日> <时> <分> --gender <male|female>       # 公历起盘
python3 scripts/ziwei.py <年> <月> <日> <时> <分> --gender <male|female> --lunar  # 农历起盘

脚本出：命宫身宫定位 + 命宫干支 + 五行局 + 命主身主 + 十二宫（各宫干支/十四主星/生年四化/六吉/六煞/宫干飞化/离心与向心自化）+ 大限（附大限宫干四化）+ 小限。全部安星公式已用开源实现 iztro 的真实测试用例交叉验证（安星 40+ 项数值核验 39 项精确吻合；命主身主与飞化自化另经 iztro 实测逐项对拍，见 references/20 出处说明）。

铁律：安星与飞化排法交脚本，断语按 references/20 第十四节框架层走（四化四义、忌冲对宫、我宫他宫、自化倾向、限年叠冲四句是入门共识可用；梁派 672 象等单源深水区不作通说）；天马等杂曜、庙旺利陷、逐宫深断语暂未支持，如实告知用户当前范围。命理是概率与倾向，趋势化表达，不做铁口直断；与八字各自独立成篇不混断，与梅花六爻的占卜门类也不混断。

奇门遁甲 · 时家转盘排局（第六引擎，依据 references/21）

用户要奇门排盘、起局占一时一事（问事求测、择时、方位）时走这一支。它是占测，与八字紫微批一生分属两类，一事一占不混断。排局（定局/地盘/值符值使/天盘九星/八门/八神）交脚本算准：

python3 scripts/qimen.py <年> <月> <日> <时> [分]              # 时家转盘排局（拆补法）
python3 scripts/qimen.py <年> <月> <日> <时> [分] --ju-fa zhirun  # 置闰法（超神接气，阈值 --zhirun-leap-min 8|9）
python3 scripts/qimen.py <年> <月> <日> <时> [分] --json       # JSON 输出
python3 scripts/qimen.py <年> <月> <日> <时> [分] --zi-sect 2  # 夜子时不换日（可选流派）

脚本出：四柱 + 节气精确交气时刻 + 阴阳遁局数三元符头（置闰法附正授/超神/接气/闰段状态）+ 旬首遁仪 + 值符值使及落宫 + 九宫逐宫（天地盘干/九星/八门/八神）+ 旬空驿马伏吟反吟 + 断局标注层（逐宫十干克应格名、九星旺衰、击刑/入墓/门迫/门制、全局格局清单、五不遇时）。流派口径：拆补法默认、置闰可选、转盘、中五寄坤二、23 点换日，全部公式经独立实现交叉核验（见 references/21 出处说明）。

铁律：排局与可计算标注交脚本，断局按 references/22 方法论走（用神定式、克应格局、四害旺衰、九步流程、应期十三法均有出处）；飞盘派、伏宫飞宫格、逐事类深度案例库未实现，如实告知。占测趋势化表达，不铁口断吉凶成败。

---

输出结构模板

【命盘】               ← 脚本完整输出
【日主与盘面】          ← 日主五行、月令、关键刑冲合会
【旺衰判定】            ← 五看推理 + 身强/弱/从 结论
【用神喜忌】            ← 调候/扶抑逻辑 + 用·喜·忌·仇·闲
【格局】               ← 取格 + 成败救应 + 层次
【大运流年】            ← 各运吉凶 + 关键流年 + 应期
【分维度详断】          ← 性格/事业/财运/婚姻/健康/学业/六亲，逐条带依据
【调候趋避与调养】      ← 方位·行业 + 色彩服饰（穿戴随身环境） + 作息饮食情志的养生建议
【综合总评】            ← 3–5 句收束
【可视化命书】（默认）    ← 推演给完即依 references/07 自动出一页 HTML，交付路径并打开
【主动推进清单】（默认）   ← 交付后主动列一份命中项清单，问用户要不要往下做（合婚/流年/单维度深挖/养生色彩详单/紫微详参/起卦占事），选了才做

可按用户具体诉求裁剪：若用户只问「2027 年事业如何」，则聚焦排盘→用神→该运该年事业分析，不必全维度铺开，但旺衰用神这一根基步骤不可省。

references 索引（推演时按需 Read）

不知道该看哪篇？先查 references/00_gainian_suoyin.md：把命理概念（调候 / 相神 / 从格 / 病药…）按推演步骤、核心概念、典籍溯源三种入口直接映射到篇目。

• references/00_gainian_suoyin.md — 概念→篇目检索索引：有概念先在此定位该读哪篇，再深读
• references/01_paipan_jichu.md — 干支五行阴阳、地支藏干、十神生成、长生十二宫、刑冲合害会
• references/02_wangshuai_yongshen.md — 旺衰五看、取用神五法、流派仲裁决策树（多用神候选听谁的）、用神喜忌定义、常见误区
• references/03_tiaohou_qiongtong.md — 穷通宝鉴十干分十二月调候用神速查表
• references/04_shishen_xiangyi.md — 十神类象、四柱宫位、六亲取用、分维度断法
• references/05_geju.md — 八格取法、成败救应、从格/专旺/化气等特殊格局
• references/06_shensha.md — 常用神煞查法、吉凶象义、使用原则
• references/07_keshihua_baoshu.md — 可视化命书：默认交付时机与输出规范、HTML 结构模板、字体可靠性铁律、五行配色映射、反 AI 体检

经典典籍深化层（08-14，把方法论锚到古籍原典，多模型亦可直接调用此知识底座）：

• references/08_gufu_duanyu.md — 古籍赋文经验断语：渊海/三命/神峰赋诀分维度精选，短引＋白话＋调用提示，孤证不立
• references/09_shenfeng_tongkao.md — 神峰通考：病药说主线、动静说、盖头截脚、伤官伤尽辨、十干体象、辟谬批判
• references/10_mingli_yueyan.md — 命理约言理性派：生克扶抑总纲、用神精神说、格局正变、神煞纳音小运胎元的祛魅清单
• references/11_sanming_tonghui.md — 三命通会：旺相休囚死五态、寄生十二宫体用、十神立名本义、格局神煞集成纲目、大运小运太岁取法
• references/12_dianji_yuanliu.md — 典籍源流导航：宋明清民国 12 部命书的贡献、对应篇目、公版出处与调用路径地图
• references/13_ditian_sui.md — 滴天髓：衰旺真机、中和为贵、体用精神、极旺极衰辩证、气势顺逆通关、寒暖燥湿、任注实证精神
• references/14_ziping_zhenquan.md — 子平真诠：月令取格、顺用逆用、相神护格（本库独有补强）、成败救应（因成得败 / 因败得成）、格局高低、用神变化、行运同看

调养落地篇（配合第 9 步，把用神落到生活）：

• references/15_yangsheng_tiaoyang.md — 五行养生调养：把用神喜忌、缺失、过旺、寒暖燥湿，翻译成针对性的作息、饮食、情志、运动、起居建议（调养标的只认用神喜忌，缺啥补啥是误区，参考非医嘱）
• references/16_secai_fushi.md — 色彩服饰调候：把用神喜忌、缺失、过旺、寒暖燥湿，翻译成针对性的衣着、配饰、首饰、随身物、居家办公的色彩与材质（认用神喜忌，缺啥穿啥是误区；颜色为主轴、宝石玉石按色参考不神化，参考非转运）
• references/17_hehun.md — 正派合婚双盘合参：双方婚姻象 + 用神互补 + 日柱年支合冲 + 大运同步性 + 相处建议（只断相处模式与磨合点，禁打分、禁合不合判词；属相相冲一票否决、合婚煞法等旧法不取）

占卜引擎（占一时一事，与八字命理分属不同门类）：

• references/18_meihua_yishu.md — 梅花易数（第二引擎）：起卦法（时间/数字/物象）、先天八卦数、体用取法、互变卦、体用生克断事、卦气旺衰与应期、八卦万物类象、《梅花易数》源流（占卜非命理、一事一占、趋势化不打分，配 scripts/meihua.py）
• references/19_liuyao.md — 六爻纳甲筮法（第三引擎）：摇卦装卦（纳甲/八宫世应/六亲/六神）、取用神六亲对照、旺衰（月建日辰）、动静生克与回头生克、空亡月破、应期、京房至《增删卜易》源流（配 scripts/liuyao.py）
• references/21_qimen.md — 奇门遁甲排局篇（第六引擎）：时家转盘排局（拆补法与置闰法定局/72 局表/三元符头/地盘三奇六仪/旬首值符值使/天盘九星/八门飞宫/八神/旬空驿马伏吟反吟），全部公式经独立实现交叉核验，流派分歧逐处裁决并标注（配 scripts/qimen.py）
• references/22_qimen_duanju.md — 奇门遁甲断局篇：用神体系与分事类定式、十干克应 81 组全表、吉凶格局判定、四害（击刑入墓门迫旬空）与旺衰、门星神吉凶、九步断局流程、应期十三法（引擎已输出可计算标注，断语按此篇展开）

第二命理引擎（批一生，与八字同门类）：

• references/20_ziwei.md — 紫微斗数（第五引擎）：十二宫定位、命宫干支五行局、紫微天府双星系、四化、六吉六煞、大限小限，全部公式经开源实现 iztro 真实测试用例交叉验证（配 scripts/ziwei.py；本版止于安星层，深度断语方法论待后续）

推演主干仍是 01-07；08-14 是溯源与佐证层，遇争议判断、需引经典措辞、或要核实某说出处时再查；15、16 是第 9 步调养落地篇，17 是合婚双盘合参篇，18、19、21、22 是占测引擎篇（梅花、六爻、奇门排局与断局，占一时一事非命理、一事一占），20 是紫微斗数命理引擎（批一生，安星+命主身主+飞化）。古籍多托名辑录，引用前先认版本，凡标「存疑」者只作倾向参考，不当原文铁证。

命例库与测试

• cases/ — 完整推演范例：每例由 scripts/paipan.py 实跑真盘 + 第 0 到 10 步完整走一遍 + 每条断语带依据，生辰虚构脱敏。想学怎么把方法落到一个真盘，先看这里。
• tests/ — 回归测试：test_paipan.py（八字排盘，古法定式校验纯函数 + 立春/节气/子时/大运/流月流日/合婚等边界）+ test_meihua.py（梅花起卦，「观梅占」黄金例校验全链路）+ test_liuyao.py（六爻装卦，京房纳甲/八宫世应/六亲/六神定式钉死）+ test_ziwei.py（紫微安星+命主身主+飞化自化，开源实现 iztro 真实测试用例与实测对拍钉死）+ test_qimen.py（奇门排局+置闰 35 用例电池+断局标注，四源交叉逐宫黄金盘与边界钉死）。改动脚本后跑 python3 -m unittest discover -s tests，全绿再用。

断语风格

• 严谨、专业、有逻辑，像分析师拆解问题：先摆事实（盘面）、再推理（旺衰用神格局）、后结论（断语）。
• 趋势化表达（易/倾向/利于/需注意），不说死、不恐吓、不承诺。
• 命理结论是基于模型的倾向性判断；遇用户当真人生大事（婚姻、健康、重大决策）求决时，提示其作参考、结合现实理性决断。