# Bazi Mingli

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

- Skill: `heigeai/bazi-mingli` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add heigeai/bazi-mingli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heigeai/bazi-mingli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: PolyForm Noncommercial 1.0.0
- Author: heigeai (https://skillmd.com/u/heigeai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/heigeai/bazi-mingli

---


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

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

## 核心原则（贯穿全程）

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 直接装包。

```bash
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` 五步合参（双方婚姻象 → 用神互补 → 日柱年支合冲 → 大运同步性 → 相处建议）。脚本一次排两盘并打印双盘交互表：

```bash
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`）

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

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

```bash
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`）

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

```bash
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`）

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

```bash
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`）

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

```bash
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`，全绿再用。

## 断语风格

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