璇玑九术

九术融一，万法归宗。本技能融合中国传统九大术数体系，12个计算脚本驱动排盘核心，14种工作流覆盖从日常问卦到年度预警的全场景，真太阳时校正确保时辰精度，运势报告Word一键出文档。

核心能力一览：

九术体系概览

辅助脚本：daily_fortune.py(每日运势)、realtime_divination.py(实时分析)、alert_nodes.py(流年预警)、report_generator.py(Word报告)

基础速查: ganzhi_table.md
流派对照: schools_ref.md

工作流决策

用户请求
  ├─ 包含出生时间/八字/四柱/排盘 → 八字排盘流(W1)
  ├─ 包含摇卦/起卦/断卦/问事   → 占卜断事流(W2)
  ├─ 包含紫微/斗数/命宫        → 紫微排盘流(W3)
  ├─ 包含奇门/遁甲             → 奇门排盘流(W4)
  ├─ 包含风水/宅/方位          → 风水分析流(W5)
  ├─ 包含择吉/宜忌/黄道/吉日   → 择吉分析流(W6)
  ├─ 包含姓名/取名/评分        → 姓名分析流(W7)
  ├─ 包含运势/今日/每日命数    → 每日运势流(W8)
  ├─ 包含交叉验证/多体系       → 交叉验证流(W9)
  ├─ 包含现在/当前/即时/此刻   → 实时分析流(W10)
  ├─ 包含看到了/听到/外应/眼前 → 外应取象流(W11)
  ├─ 包含预警/冲太岁/五黄/三煞/年运提醒 → 流年节点预警流(W12)
  ├─ 包含综合报告/运势报告/完整报告/详细分析 → 综合运势报告流(W13)
  └─ 无法判断时 → 先走W10实时分析，再根据结果推荐专项流

W1: 八字排盘流

1. 获取出生年月日时（公历），若用户提供农历需先转换
2. 执行 python scripts/ganzhi.py --year Y --month M --day D --hour H [--minute M] [--longitude L] 获取四柱
   - --minute：出生分钟数（用于真太阳时校正，如55表示18:55）
   - --longitude：出生地经度（如合肥117.27，默认120即不校正）
   - 启用后自动计算真太阳时，含经度校正+均时差(EoT)校正，输出含真太阳时字段
   - 早晚子时：23:00-23:59为晚子时，时支取子，日干用次日推算
3. 读取 bazi_ref.md 进行十神分析、格局判断
4. 若用户问大运流年，执行 python scripts/dayun.py --year Y --month M --day D --hour H --gender G --current YYYY 获取大运流年详情
5. 综合输出：四柱 → 十神 → 五行旺衰 → 格局 → 大运 → 流年 → 简评

W2: 占卜断事流

1. 确定占法：用户指定六爻则走六爻，指定梅花则走梅花，默认根据问题选择
2. 六爻:
   - 摇卦方式三选一：
   • 自动摇卦（推荐）：python scripts/yijing.py --auto_yao [--method coins|yarrow] [--dong 1,3]（三硬币法/揲蓍法随机模拟，可选指定动爻）
   • 手动报卦：用户报6次铜钱结果 或 时间起卦，执行 python scripts/yijing.py --liuyao --upper U --lower L
   • 一键排盘：python scripts/yijing.py --auto_yao（自动摇卦+完整六爻排盘，含世应/六亲/旺衰/空亡/断卦提示）
   • 完整排盘输出含：本卦、变卦、世应、六亲、动爻、日辰月建、旺衰、空亡、断卦提示
   • 读取 liuyao_ref.md 取用神、断吉凶
3. 梅花:
   - 起卦：用户报数 或 时间起卦
   - 执行 python scripts/yijing.py --meihua --number N 或 --today_hexagram
   - 读取 meihua_ref.md 分析体用生克
4. 综合断语：主卦→互卦→变卦→应期

W3: 紫微排盘流

1. 获取出生年月日时及性别（紫微须用农历月份；若用户给阳历需自行换算农历月日）
2. 执行 python scripts/ziwei.py --year Y --month M --day D --hour H --gender G 获取命盘
3. 排盘输出已含：十四主星、六吉星（左辅右弼/文昌文曲/天魁天钺）、六煞星（擎羊陀罗/火星铃星/地空地劫）、杂曜（禄存天马/红鸾天喜/天刑天姚/解神天巫）、身宫、生年四化
4. 读取 ziwei_ref.md 补充安星口诀、辅星组合格局、四化表、格局判定
5. 按十二宫输出命盘结构（含主星+辅星+四化标记+身宫标记）
6. 分析格局、四化影响、大限流年

W4: 奇门排盘流

1. 确定时间（默认当前），判断阳遁/阴遁
2. 执行 python scripts/qimen.py --date YYYY-MM-DD --hour H 或 --now 排盘
3. 读取 qimen_ref.md 补充吉格凶格、断事取用
4. 定局→布三奇六仪→排九星→排八门→排八神
5. 根据所问之事取用断局

W5: 风水分析流

1. 获取房屋坐向、建造年份、住户出生年份及性别
2. 执行 python scripts/fengshui.py --all --sitting 坐山 --facing 朝向 --birth_year Y --gender G [--build_year BY] [--year LY]
3. 脚本自动输出三大模块：
   - 八宅法: 命卦推算 → 东西四命 → 八方游年(生气/天医/延年/伏位/祸害/六煞/五鬼/绝命) → 命宅匹配
   - 玄空飞星: 运盘+山盘+向盘三盘排布 → 格局判定(旺山旺向/双星到向/上山下水等) → 九宫飞星组合
   - 流年飞星: 年度九星入中 → 五黄/二黑方位 → 各方位吉凶提示
4. 亦可单独调用模块：
   - --bazi --birth_year Y --gender G 仅命卦推算
   - --bazhai --facing 朝向 --birth_year Y --gender G 八宅法完整
   - --xuankong --sitting 坐山 玄空飞星
   - --liunian --year Y 流年飞星
5. 读取 fengshui_ref.md 补充煞气化解、形峦配合等建议

W6: 择吉分析流

1. 获取目标日期（默认今日）或事项类型
2. 执行 python scripts/zeji.py --date YYYY-MM-DD 或 --today
3. 读取 zeji_ref.md 补充杨公忌日等
4. 输出：干支→建除→黄道黑道→宜忌→综合评价

W7: 姓名分析流

1. 获取姓名
2. 执行 python scripts/xingming.py --name 姓名
3. 读取 xingming_ref.md 补充数理含义
4. 输出：笔画→五格→三才→吉凶→评分→建议
5. 若用户求取名，根据姓氏和性别推荐吉名

W8: 每日运势流

1. 执行 python scripts/daily_fortune.py --today 获取综合每日运势（干支+择吉+评分+吉方吉色）
2. 若用户提供出生年月日，加 --birth_year Y --birth_month M --birth_day D 获取个性化流日提示
3. 读取 schools_ref.md 了解流派选择
4. 综合输出：今日干支→建除宜忌→五行吉方→评分等级→流日提示→建议

W9: 交叉验证流

1. 确定问题及可用体系
2. 读取 schools_ref.md 了解各派差异，选择适配流派
3. 分别用2-3种术数体系独立分析（同一体系可选不同流派对比）
4. 多体系交叉验证方法论：
   - 八字×紫微：八字看五行格局大势，紫微看命宫星曜细节，二者五行结论互验（如八字木旺vs紫微命宫天机/贪狼木系星，一致则可信度+1）
   - 八字×奇门：八字为"命"（先天），奇门为"运"（当下时局），命局吉而时局凶→静守，命局凶而时局吉→可动
   - 紫微×奇门：紫微大限宫位与奇门值使门方对照，同宫位共振→该领域应验概率提升
   - 梅花×六爻：梅花取象+六爻取爻，象义共振→结论强化
   - 交叉验证矩阵格式：
   | 体系A\体系B | 吉 | 凶 | 中平 | |-------------|----|----|------| | 吉 | ✅强吉 | ⚠️分歧 | 🔄偏吉 | | 凶 | ⚠️分歧 | ✅强凶 | 🔄偏凶 | | 中平 | 🔄偏吉 | 🔄偏凶 | ✅中平 |
5. 对比各体系/流派结论：
   - 格局派看宏观大势 → 结论可比对
   - 象数派看因果细节 → 链条可补全
   - 实战派看具体应验 → 时间可锁定
6. 综合判定：
   - 各体系一致→高可信度
   - 多数一致少数不同→参考主流
   - 各体系矛盾→提示分歧，供用户判断
7. 输出交叉验证矩阵和综合判断

W10: 实时分析流

1. 用户随时问事，执行 python scripts/realtime_divination.py --now [--question "关键词"]
2. 系统自动基于当前时辰排盘：
   - 四柱：当前年月日时干支
   - 梅花即时卦：时间起卦，体用生克分析
   - 奇门时盘：阳/阴遁局数、值符值使、八神
3. 若用户指定问题关键词（事业/财运/婚姻/健康等），自动匹配取用建议
4. 综合输出：四柱→梅花卦象及吉凶→奇门时盘→取用建议
5. 若需更深入分析，可继续调用对应体系专项工作流（W1-W7）

W11: 外应取象流

1. 用户描述当下所见所闻（如"窗外有鸟叫""看到红色车"等）
2. 将外应映射为卦象：
   - 读 meihua_ref.md 外应取象部分
   - 方位→八卦：北坎/南离/东震/西兑/东北艮/东南巽/西南坤/西北乾
   - 动物→八卦：马乾/牛坤/龙震/鸡巽/猪坎/狗艮/雉离/羊兑
   - 颜色→五行：青木/红火/黄土/白金/黑水→对应八卦
   - 声音→八卦：1乾/2兑/3离/4震/5巽/6坎/7艮/8坤
   - 数字→卦：除8取余
3. 起卦方式：
   - 单一外应：取为上卦，当前时辰地支数为下卦，(上+下+时)÷6取动爻
   - 两个外应：分别为上卦和下卦，加时数取动爻
   - 三要十应：结合眼见(三要)/耳闻/心感综合断卦
4. 按梅花体用生克法断吉凶
5. 输出：外应→起卦→卦象→体用→断语→应期

W12: 流年节点预警流

1. 执行 python scripts/alert_nodes.py --year YYYY [--birth_zhi "丑"] [--house_facing "午"]
2. 系统自动计算年度关键凶煞：
   - 冲太岁/值太岁/刑太岁/害太岁（个人生肖相关）
   - 三煞方（方位忌动土）
   - 五黄煞/二黑病符（飞星方位）
   - 太岁方/岁破方
3. 若指定月份，加 --month M 列出该月凶日速查
4. 输出：预警清单（等级×类型×建议）→月度关键月→化解建议
5. 可绑定定时任务，每年初自动生成年度预警报告

W13: 综合运势报告流

1. 获取出生年月日时及性别（提供农历月日更佳）
2. 执行 python scripts/report_generator.py --year Y --month M --day D --hour H --gender G [--lunar_month LM --lunar_day LD --output PATH]
3. 报告自动整合五大模块：
   - 八字命盘：四柱、十神、五行统计、纳音
   - 紫微斗数：命身宫、辅星总览、四化、十二宫详局
   - 大运流年：大运排布、当前大运高亮
   - 今日择吉：建除、黄道黑道、宜忌、综合评价
   - 关键节点预警：冲/值/害太岁、三煞方、五黄煞、月度预警
4. 输出为格式化 Word 文档（封面+分章节+颜色标注）
5. 可用于：个人年度运势总览、定时推送每日运势报告、关键节点提醒

W14: 多盘同屏对比流

1. 用户要求对比两人或多时间盘面（如合婚、流年对比、不同时辰校验）
2. 分别排盘后并排输出，格式：
   | 维度 | 盘A（XXX） | 盘B（XXX） | 对比判定 | |------|-----------|-----------|---------| | 五行旺衰 | 木旺土弱 | 火旺金弱 | 木土冲 | | 格局 | 正官格 | 七杀格 | 官杀混杂 | | ... | ... | ... | ... |
3. 合婚场景：八字日柱天合地合→加分，天克地冲→减分，综合评分
4. 流年对比：同一年不同体系对同一事项的判断差异一目了然
5. 时辰校验：邻近代时排盘对比，辅助用户确认出生时辰

历法校准说明

本技能排盘精度依赖历法校准，具体机制如下：

• 真太阳时校正：ganzhi.py 启用 --minute + --longitude 参数后，自动完成经度校正（每度4分钟）+均时差(Equation of Time)校正，确保时辰划分与出生地实际天象一致
• 节气精度：择吉与八字月柱划分以天文节气时刻为准（非历书近似），年度节气数据库精确到分钟
• 早晚子时处理：23:00-23:59为晚子时（时支取子，日干用次日推算）；0:00-0:59为早子时（时支取子，日干用当日）
• 农历转换：支持公历↔农历双向转换，闰月按传统"前月"处理
• 校准可信度标注：启用真太阳时→"已校准"；未启用→"未校准（默认东经120°）"，提醒用户补充出生地经度

推理透明原则

本技能遵循"AI是推的，不是猜的"原则：

• 每个断语必须标注推理路径：[体系]→[规则]→[结论]，例如：[八字·子平]→[丁火生于辰月，泄气太过]→[身弱喜木火]
• 排盘计算步骤可追溯：脚本命令+入参+输出均记录
• 不确定的推断标注置信度：大概率(>80%) / 可能(50-80%) / 存疑(<50%)
• 流派分歧明确标注：不同流派对同一格局的不同解读并列呈现
• 用户可要求"展开推理过程"，技能将逐步回溯计算链条

脚本清单

输出规范

• 排盘结果以结构化表格呈现
• 断语先吉后凶，先总后分
• 引用术语附简要释义，避免行话堆砌
• 风水/择吉建议具体可操作
• 用户指定流派时按该流派断法；未指定时默认子平法（八字）/增删派（六爻）/三合派（紫微）/转盘拆补（奇门）
• 交叉验证时标注各结论所据流派，方便用户判断
• 综合运势报告(W13)输出为Word格式，含封面、分章节、颜色标注（红色=凶/忌，绿色=吉/宜，紫色=主星/四化，蓝色=提示/建议）
• 免责声明：术数为传统文化参考，不构成决策依据

最新动态/功能更新（2026年7月）

v2.0 核心升级

• 风水堪舆脚本 fengshui.py（NEW）：八宅命卦+八方游年+玄空飞星三盘+流年飞星，一键--all输出，九运二十四山旺山旺向/双星到向/上山下水格局自动判定
• 真太阳时校正（UPGRADE）：ganzhi.py新增--minute+--longitude参数，经度校正+均时差(EoT)校正，早晚子时处理，确保非120°经度地区时辰准确
• 纳音五行算法修正：从简化公式替换为完整60条查表，与万年历逐一验证通过
• 紫微辅星全套：六吉星+六煞星+杂曜+身宫+生年四化，地空地劫安法修正（逆/顺）
• 六爻自动摇卦：--auto_yao一键排盘，含世应/六亲/旺衰/空亡/断卦提示/伏神系统/纳甲装卦
• 运势报告Word生成：五模块（八字+紫微+大运+择吉+预警），封面+分章节+颜色标注

参考文档深度补充

• meihua_ref.md：时间起卦必须用农历数字规则+阳历转农历要点+常见错误对照
• zeji_ref.md：二十八宿值日算法（28宿完整表+推算公式+吉凶宿分类）
• fengshui_ref.md：九运(2024-2043)飞星排盘详解（运盘图+24山旺山旺向表+上山下水避忌+山向盘顺逆定法）
• xingming_ref.md：康熙笔画使用详解（12偏旁对照+30个高频易错字+五格评分权重）
• qimen_ref.md：真太阳时在奇门中的应用+合肥速查表+转盘拆补置闰法（24节气局数口诀+与无闰法对比）
• bazi_ref.md：盲派做功理论（制用结构+宾主理论+做功方式分类）
• ziwei_ref.md：飞星四化理论（宫干飞化+自化+互化+飞星追踪法）
• liuyoa_ref.md：伏神系统+进退神详解+纳甲装卦五步流程

精度校验

• 日柱基准修正：1900-01-01="甲戌日"（天干偏移=0，地支偏移=10），万年历验证通过
• 紫微四化校验：甲乙丙丁戊庚6个天干四化逐一验证通过
• 安全扫描0风险，技能验证通过

免责

本技能基于中国传统术数文化，仅供文化学习与参考，不构成任何决策依据。术数推演结果因流派、师承不同可能存在差异。人生重大决策（婚姻、投资、择业等）请以理性判断和专业人士意见为准，切勿因术数结论盲从盲信。