name	fengshui-skill
description	风水堪舆技能。支持八宅风水、玄空飞星、二十四山向、三元九运、煞气识别、流年飞星、综合评分与布局建议。
version	4.0.0
author	天工长老

风水堪舆技能 v4.0.0

"风水者，藏风得水也。气乘风则散，界水则止。" ——《葬书》

⚠️ 铁律：先核对时间，再排盘！

"差之毫厘，谬以千里。" —— 时间一错，吉凶颠倒。

每次排盘前必须：

校正当前时间 — 以系统实时时间为准，不可用缓存或旧时间
核实公历日期 — 年、月、日，一一确认
核对农历年份 — 命卦以农历年计算
验证方位与节气 — 流年飞星以立春为界
独立校验脚本输出 — 脚本若有 bug，人工复核

功能总览 v4.0.0

🏠 八宅风水

✅ 东四宅/西四宅判断
✅ 命卦计算（出生年份推算）
✅ 游年九星排布（伏位/生气/天医/延年/祸害/六煞/五鬼/绝命）
✅ 方位吉凶分析
✅ 布局建议（门窗/卧室/厨房/卫生间）

🌟 玄空飞星（v4.0.0 新增）

✅ 三元九运（上元/中元/下元，每元三运，每运20年）
✅ 下卦飞星排盘（运星/山星/向星）
✅ 九宫飞星顺逆排法
✅ 旺山旺向/上山下水/双星到向判断
✅ 城门诀、七星打劫
✅ 飞星组合断语（108 种组合）

🧭 二十四山向

✅ 二十四山向详解（壬子癸/丑艮寅/甲卯乙/辰巽巳/丙午丁/未坤申/庚酉辛/戌乾亥）
✅ 三元龙（天元/地元/人元）
✅ 阴阳顺逆判断
✅ 兼向替卦

💫 煞气识别系统

✅ 形煞识别（路冲/反弓/天斩/壁刀/穿心/探头/孤峰/逼压）
✅ 理煞识别（五黄/二黑/三煞/岁破/太岁）
✅ 煞气等级评估（轻/中/重）
✅ 化解建议与物品推荐

📅 流年飞星

✅ 当年九宫飞星图
✅ 流年吉凶方位标注
✅ 每月飞星变化

📐 综合评分系统（v4.0.0 新增）

✅ 宅运评分（基于玄空飞星）
✅ 方位评分（基于八宅游年）
✅ 煞气扣分（形煞+理煞）
✅ 总分计算（0-100 分）
✅ 趋吉避凶建议

🎯 分类布局

✅ 按房间分类（客厅/卧室/厨房/书房/卫生间）
✅ 按用途推荐（招财/旺运/健康/感情/学业）
✅ 与八字喜用神联动布局

使用

python3 scripts/fengshui_pan.py --year 1990
python3 scripts/fengshui_pan.py --year 1990 --direction "坐北朝南"
python3 scripts/fengshui_pan.py --year 1990 --direction "坐北朝南" --method xuan Kong

变更

v4.0.0 (2026-05-10): 新增玄空飞星、二十四山向、三元九运、综合评分系统、108 种飞星组合断语 v3.3.0 (2026-05-02): 新增煞气识别增强、流年飞星排布、布局建议细化 v3.1.0 (2026-04-11): 统一断语风格、技能联动接口、十大技能协同 v2.0.0: 游年九星、布局建议、煞气化解

一、八宅风水

命卦计算

性别	公式	示例
男	(100 - 出生年尾两位) ÷ 9 取余	1990年生：(100-90)÷9=1余1 → 坎卦(东四命)
女	(出生年尾两位 - 4) ÷ 9 取余	1990年生：(90-4)÷9=9余5 → 坤卦(西四命)

余数对应：1坎、2坤、3震、4巽、5男坤女艮、6乾、7兑、8艮、9离

八宅游年九星

星名	五行	吉凶	说明
生气	木	大吉	求财旺运、事业发达
天医	土	大吉	健康长寿、贵人相助
延年	金	中吉	婚姻和谐、人际融洽
伏位	木	小吉	平稳安定、宜守不宜动
祸害	土	小凶	口舌是非、小人暗害
六煞	水	中凶	桃花劫、破财损名
五鬼	火	大凶	疾病灾祸、意外横祸
绝命	金	大凶	破财伤身、官非牢狱

二、玄空飞星

三元九运

元	运	年份	当令星
上元	一运	1864-1883	一白
上元	二运	1884-1903	二黑
上元	三运	1904-1923	三碧
中元	四运	1924-1943	四绿
中元	五运	1944-1963	五黄
中元	六运	1964-1983	六白
下元	七运	1984-2003	七赤
下元	八运	2004-2023	八白
下元	九运	2024-2043	九紫

当前：九运（2024-2043），九紫右弼星当令。

九宫飞星顺逆

顺飞路线： 中宫 → 乾 → 兑 → 艮 → 离 → 坎 → 坤 → 震 → 巽

逆飞路线： 中宫 → 巽 → 震 → 坤 → 坎 → 离 → 艮 → 兑 → 乾

山星：坐山之星，管人丁健康
向星：朝向之星，管财运事业
运星：当元之运星，管整体运势

格局判断

格局	条件	吉凶
旺山旺向	山星当令到坐、向星当令到向	大吉
上山下水	山星当令到向、向星当令到坐	大凶
双星到向	山星向星皆当令到向	中吉
双星到坐	山星向星皆当令到坐	中凶

飞星组合速查（部分）

组合	断语
1-6/6-1	文昌显达，利学业考试
1-4/4-1	桃花旺盛，利感情姻缘
2-5/5-2	病符叠至，主疾病灾殃
6-7/7-6	交剑煞，主争斗官非
8-9/9-8	吉庆叠加，九运大吉
9-9	双紫临门，九运最旺

三、二十四山向

二十四山向与三元龙

卦	三元龙	山向	阴阳
坎	天元	子	阴
坎	地元	壬	阳
坎	人元	癸	阴
艮	天元	艮	阳
艮	地元	丑	阴
艮	人元	寅	阳
震	天元	卯	阴
震	地元	甲	阳
震	人元	乙	阴
巽	天元	巽	阳
巽	地元	辰	阴
巽	人元	巳	阳
离	天元	午	阴
离	地元	丙	阳
离	人元	丁	阴
坤	天元	坤	阳
坤	地元	未	阴
坤	人元	申	阳
兑	天元	酉	阴
兑	地元	庚	阳
兑	人元	辛	阴
乾	天元	乾	阳
乾	地元	戌	阴
乾	人元	亥	阳

兼向规则

兼向分度：每山 15°，正中 ±2° 为正针，±2°~±4.5° 为兼针

兼同元 → 顺飞
兼异元 → 替卦逆飞

四、煞气识别详解

形煞（外在环境）

煞名	特征	化解
路冲煞	道路直冲大门	石狮子、屏风
反弓煞	道路反弓对宅	八卦镜、植物
天斩煞	两高楼之间狭窄	泰山石敢当
壁刀煞	邻屋墙角对宅	葫芦、植物
穿心煞	道路穿过宅基	五帝钱、葫芦
探头煞	屋后有屋探头	泰山石敢当
孤峰煞	独楼高耸无依	种植树木
逼压煞	高楼逼近	八卦镜、窗帘

理煞（飞星煞气）

煞名	飞星	方位	化解
五黄煞	五黄廉贞星	当年五黄位	铜铃/六帝钱
二黑煞	二黑巨门星	当年二黑位	铜葫芦
三煞	劫煞/灾煞/岁煞	当年三煞方	安忍水
岁破	太岁冲位	岁破方	少动土

五、综合评分系统

评分维度（满分 100 分）

维度	权重	满分	说明
玄空宅运	40%	40 分	基于飞星格局（旺山旺向40分，双星到向30分，上山下水5分）
八宅方位	25%	25 分	大门、主卧、厨房在吉方加分
煞气评估	20%	20 分	无煞20分，每有形煞扣2分，理煞扣3分
流年飞星	15%	15 分	当年旺星到门/主卧加分

等级评定

分数	等级	建议
85-100	上上宅	风水宝地，安居乐业
70-84	中上宅	总体吉利，微调更佳
55-69	中平宅	吉凶参半，化解煞气
40-54	中下宅	煞气较重，需大调整
0-39	下下宅	风水不佳，建议搬迁

六、分类布局建议

按房间

房间	宜	忌
大门	生气/延年方	五鬼/绝命方
主卧	天医/延年方	五鬼/六煞方
厨房	祸害/六煞方（压煞）	天医方（烧财）
书房	文昌位（四绿）	厕所上方
卫生间	凶方（以煞制煞）	大门正对

按用途

用途	方位	物品
招财	当令旺方	聚宝盆、水晶洞
旺运	生气方	紫水晶、发财树
健康	天医方	铜葫芦、绿植
感情	延年方	粉水晶、鸳鸯
学业	文昌位	文昌塔、毛笔

天工长老按： 风水之术，重在藏风聚气。v4.0 新增玄空飞星、二十四山向、综合评分，使风水分析更加全面精准。

"善风水者不局，重在顺势布局，趋吉避凶。"

🏮 天工长老敬撰 v4.0.0 2026-05-10