bazi-mingli

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

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

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

核心原则（贯穿全程）

1. 排盘必用脚本：先选对应引擎，八字干支推算交给 scripts/paipan.py，紫微、梅花、六爻、奇门分别用自己的脚本，绝不手推。八字最易错在年柱、月柱和时间口径；未启用真太阳时校正时不得声称已校正。
2. 方法论固定顺序：八字按排盘 → 定旺衰 → 取用神 → 判格局 → 析岁运 → 落十神六亲 → 分维度断语执行。其他引擎按各自章节执行，不把八字全流程套到占一件事上。
3. 结论必带依据：每条断语后注明推理链，如「事业偏技术创作（伤官透月干为用 + 食神生财）」。不写无依据的泛断。
4. 一象多看：每个重要结论至少两处佐证（星 + 宫，或 原局 + 岁运），单一信号不下死断。
5. 先答问题，再给依据：回复先给 3 至 5 句结论、主要局限和可执行提醒，再展示相关命盘事实与推演依据。完整命书保留计算结果和分析过程；单维度任务聚焦该维度，不把所有扩展内容塞进聊天首屏。
6. 解释与事实分开：脚本结果是按指定口径算出的历法或排盘事实，命理与占测解释属于传统体系中的参考，不能写成经过验证的概率、诊断或必然发生的事件。语气保持倾向性，不做铁口直断祸福。

先路由 · 明确用户要什么

• 根据生辰看命盘或某个生活维度：走八字；明确点名紫微：走紫微。
• 比较两人相处模式：走合婚，分别收集双方输入。
• 问具体一件事：用户指定的梅花、六爻或奇门优先；有数字可走梅花，有六次摇卦结果走六爻，指定奇门起局则走奇门。未选方法时只询问目标与已有输入，不自动运行全部引擎来挑结论。
• 只要求排盘、查看 JSON 或核对已有结果：完成指定范围，不擅自扩展成人生推演。命理推演任务仍按第 11 步默认交付对应主题 HTML，明确只要文字时例外。

收集信息前先利用已有上下文。目标清楚且输入足够就执行，不再要求用户重新确认；只有会改变结果的缺失或歧义才集中问一次。

第 0 步 · 收集与确认输入

本节收集命理生辰。占事任务改收「具体问题、关注期限、对应引擎的起卦或起局输入」，不要向占事用户索要一整套出生资料。

信息	如何处理
目标、出生年月日、历法、性别	八字／紫微必需；历法不清先问，不静默把农历当公历；农历注明是否闰月，闰月用负数输入
出生时分及准确程度	已知就使用，分钟未记可声明按整点输入；八字明确不知道时辰时直接排三柱，紫微不能伪造时辰安宫
出生地与记录时区	已提供城市可取近似经度并注明来源或近似值；未提供地点时不启用真太阳时，也不声称已校正。海外或历史时区不明时须先核实
夏令时与换日口径	23 点附近声明实际使用的流派；历史钟表时间先核对夏令时，--china-dst 只发提示，不自动减一小时
合婚乙方	两人的历法、时区、经度、性别与时辰已知情况分别记录，不把甲方设置复制成乙方事实

口语时间可按明确语义转换，例如下午 2 点半为 14:30、晚上 11 点为 23:00。「上午」「大约」「不记得」不等于精确时刻。未知时辰的八字三柱须声明时柱、精确起运日期及相关判断的局限，不能为填满 HTML 补造数据。支持范围以公历 1600 至 2200 年为准，农历先转换后判断；非法日期或无法确定的必要输入先解决，脚本报错时不得继续生成确定命盘。

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

在本 skill 所在目录下运行，优先使用项目 .venv：macOS／Linux 为 ./.venv/bin/python，Windows 为 .\.venv\Scripts\python.exe。下文 python3 是解释器占位，执行时替换为实际路径；缺依赖按 README 的虚拟环境步骤安装，不向系统 Python 直接装包。

python3 scripts/paipan.py <年> <月> <日> [时] [分] --gender <male|female> [选项]
# 未知时辰三柱盘
python3 scripts/paipan.py <年> <月> <日> --gender <male|female> [选项]

常用选项：

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

支持公历 1600-2200 年；起运岁数按虚岁口径（与大运列表一致）。1986-1991 年中国夏令时核时需由调用方明确加 --china-dst，脚本只提示核对，不自动改动输入钟表时间。

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

保留脚本完整输出作为推演与命书的事实基础。聊天交付先回答用户问题，再列关键数据与依据；完整命盘放在后续详细部分或 HTML 中，不以大段脚本输出挤掉开头结论。

第 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 拉开，不依赖未必安装的书法字体。
• 配色取命局：用神五行定主色调，全局一个朱砂、一个金做签名色，忌神色仅作点缀，不堆色。
• 同一口径：趋势化、带依据、不恐吓，与文字版一致；页脚保留「仅供研究参考」。

可视化不替代推演。先完成当前主题的计算与有依据的解释，再制作 HTML；缺失资料与局限原样保留。

第 12 步 · 报告末尾功能提示与按需继续

本 skill 的固定交互范式是核心自动完成、末尾展示功能、用户选择后继续。

固定提示层（默认附上）：所有引擎的完整报告、单主题报告和纯文字解读，均依 references/23_report_next_steps.md 在正文及附录之后、原有参考声明之前，放置「这份报告之后，你还可以做什么」。完整展示九项功能的用途、示例说法和所需信息，每份报告只放一次；HTML 内也必须包含，不能只在聊天交付时提醒。它是静态功能目录，不新增解读、不自动运行其他引擎，不受下方两三项相关建议上限影响。只求原始排盘或 JSON、只核对数据、明确不要提示时省略；仅交付文件链接时简短指出报告末尾已有目录。

自动层（跑到底，不问）：目标明确、必要输入收齐后，完成相应主题的核心推演和 HTML。未知时辰按三柱降级，单维度聚焦该维度；只求排盘或明确纯文字的任务服从用户范围。

推进层（按相关性提供，用户选择后才做）：固定目录之外，确有相关价值时可点出一至三项建议；在目录对应项上标注即可，不再重复整份清单或另起追问。只推荐这个盘当前用得上的项（命中触发条件才推荐）：

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

措辞纪律：

• 集中提示、按需执行：推荐在固定目录对应项上标注，不逐项追问，也不默认全部执行。
• 相关推荐最多 2 至 3 项，每项一句话；没有合适延伸时省略推荐标注，固定功能目录仍照常保留。不能仅因用户没提供另一人生辰就主动推荐合婚，用户明确关心关系时才推荐。
• 用户说「就这样 / 不用了 / 够了」→ 干净收尾，不再追问。
• 这是主动提供一次选项，不是反复索取确认。提供一次即可，尊重用户自主推进。

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

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

python3 scripts/paipan.py <甲生辰> --gender <X> --partner <乙年月日 [时 [分]]> --partner-gender <Y> [--partner-lng <经度> --partner-tz <时区>]

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

JSON 中 partner_chart 为乙方完整排盘，先用它读取乙方四柱、旺衰数据、大运与局限，再作双盘分析。partner_input、partner_pillars、partner_calendar 等既有摘要字段保留兼容，不因只看摘要而省略乙方独立分析。

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

用户选择梅花，或按前述路由确定以数字或时间起卦占一件具体的事时，走梅花易数这一支；用户已指定六爻或奇门时使用相应引擎。要批一生则按用户选择走八字或紫微。它是占卜，与八字命理分属两个引擎，各归各用、不混断。

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

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

--lunar 与 --zi-sect 只属于时间起卦，必须和 --time 同用；农历小月、不存在的闰月及换算后越出 1600 至 2200 年会明确拒绝。

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

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

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

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

python3 scripts/liuyao.py --yao <六位数> --date <年> <月> <日> [时] [分] --zi-sect <1|2> --query "所占之事"
# 六位数自初爻向上：6=老阴(动) 7=少阳 8=少阴 9=老阳(动)，如 787888
# --gua <上卦数> <下卦数> <动爻> 可直接指定（0=静卦）；--date 后依次为年、月、日、时、分，时和分均可选；--zi-sect 默认 2，23 点附近须声明口径

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

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

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

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

python3 scripts/ziwei.py <年> <月> <日> <时> <分> --gender <male|female>       # 公历起盘
python3 scripts/ziwei.py <年> <月> <日> <时> <分> --gender <male|female> --lunar  # 农历起盘
python3 scripts/ziwei.py <年> <月> <日> <时> <分> --gender <male|female> --year-divide exact  # 立春换生年干支

脚本出：命宫身宫定位 + 命宫干支 + 五行局 + 命主身主 + 十二宫（各宫干支/十四主星/生年四化/六吉/禄存/六煞/宫干飞化/离心与向心自化）+ 大限（附大限宫干四化）+ 小限。默认按实际农历日判断闰月十六日起改用下一月安宫，默认排盘采用年按春节分界；可用 --no-fix-leap 与 --year-divide normal|exact 明确切换。原始输入与口径写入 input，实际农历年保留在 lunar.年干支，有效排盘年与安宫月写入 calculation。选定锚点曾与 iztro 2.5.8 显式配置比对，但晚子时和立春日边界规则并不完全相同，见 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/22 方法论走（用神定式、克应格局、四害旺衰、九步流程、应期十三法均有出处）；飞盘派、伏宫飞宫格、逐事类深度案例库未实现，如实告知。占测趋势化表达，不铁口断吉凶成败。

---

输出结构模板

【先看结论】            ← 回答当前问题，3 至 5 句，明确主要局限
【命盘】               ← 脚本完整输出
【日主与盘面】          ← 日主五行、月令、关键刑冲合会
【旺衰判定】            ← 五看推理 + 身强/弱/从 结论
【用神喜忌】            ← 调候/扶抑逻辑 + 用·喜·忌·仇·闲
【格局】               ← 取格 + 成败救应 + 层次
【大运流年】            ← 各运吉凶 + 关键流年 + 应期
【分维度详断】          ← 性格/事业/财运/婚姻/健康/学业/六亲，逐条带依据
【调候趋避与调养】      ← 方位·行业 + 色彩服饰（穿戴随身环境） + 作息饮食情志的养生建议
【综合总评】            ← 3–5 句收束
【可视化命书】（默认）    ← 推演给完即依 references/07 自动出一页 HTML，交付路径并打开
【功能与使用提示】（默认） ← 依 references/23 展示完整目录，正文及附录之后、原有参考声明之前；HTML 同步包含

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

references 索引（推演时按需 Read）

• references/23_report_next_steps.md：所有报告末尾的固定功能目录、使用示例与所需信息。

不知道该看哪篇？先查 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 局表/三元符头/地盘三奇六仪/旬首值符值使/天盘九星/八门飞宫/八神/旬空驿马/星门伏吟反吟），固定逐宫期望与置闰电池已回归，外部 oracle 快照仍待归档（配 scripts/qimen.py）
• references/22_qimen_duanju.md — 奇门遁甲断局篇：用神体系与分事类定式、十干克应 81 组全表、吉凶格局判定、四害（击刑入墓门迫旬空）与旺衰、门星神吉凶、九步断局流程、应期十三法（引擎已输出可计算标注，断语按此篇展开）

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

• references/20_ziwei.md — 紫微斗数（第四引擎）：十二宫定位、命宫干支五行局、紫微天府双星系、四化、六吉、禄存、六煞、大限小限，选定锚点与 iztro 2.5.8 显式配置比对（配 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（紫微安星+命主身主+飞化自化，并锁定闰月与换年配置锚点）+ test_qimen.py（奇门排局+置闰 35 用例电池+跨年符头+断局标注）+ test_documented_examples.py（四个命例的真实 CLI 输出与文档逐字比对，另核正文十神、藏干、起运、岁运与候选格局条件，HTML 示例的盘面与大运星运对照）+ test_release_contract.py（最低依赖、版本、文档、Tag CI 触发与打印契约）。改动脚本后跑 python3 -m unittest discover -s tests，全绿再用。

断语风格

• 内部推演先核对事实（盘面）、再推理（旺衰用神格局）、后形成结论（断语）；交付时先呈现简短结论，再展开事实与推理过程。
• 趋势化表达（易/倾向/利于/需注意），不说死、不恐吓、不承诺。
• 命理结论是基于模型的倾向性判断；遇用户当真人生大事（婚姻、健康、重大决策）求决时，提示其作参考、结合现实理性决断。