name	ze-ri-skill
description	择日学技能。支持建除十二神、黄道黑道、神煞详解、综合评分、时辰择日、日课择日、分类择日（婚嫁/开业/动土/出行/搬家/安葬），提供趋吉避凶建议。
version	4.0.0
author	天工长老

择日学技能 v4.0.0

"择吉避凶，顺天应时。" ——《协纪辨方书》

⚠️ 铁律：先核对时间，再择日！

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

每次择日前必须：

校正当前时间 — 以系统实时时间为准，不可用缓存或旧时间
核实公历日期 — 年、月、日，一一确认
核对农历日期 — 建除十二神以农历月为准
验证节气 — 黄道黑道日以节气定月
独立校验脚本输出 — 脚本若有 bug，人工复核

功能总览 v4.0.0

📅 基础择日

✅ 建除十二神查询（建/除/满/平/定/执/破/危/成/收/开/闭）
✅ 黄道黑道日查询（十二值日）
✅ 神煞吉凶查询（吉神/凶煞）
✅ 宜忌事项查询
✅ 冲煞查询（冲生肖/煞方位）

🔮 神煞详解系统（v4.0.0 增强）

✅ 吉神详解（天德/月德/天赦/三合/六合/生气/福德等 20+ 吉神）
✅ 凶煞详解（月破/岁破/四离/四绝/杨公忌/劫煞/灾煞等 20+ 凶煞）
✅ 神煞叠加分析（吉凶神同现判断）
✅ 神煞化解建议

⏰ 时辰择日

✅ 每日十二时辰吉凶排布
✅ 根据事项推荐最佳时辰
✅ 时辰与日课配合分析
✅ 紫白飞星时辰法

📖 日课择日法（v4.0.0 新增）

✅ 四柱日课（年/月/日/时四柱配合）
✅ 日课吉凶判断
✅ 日课与主人生肖配合
✅ 日课五行平衡分析

🏷️ 分类择日

✅ 婚嫁择日（避开三娘煞、杨公忌等）
✅ 开业择日（重生气/天德/月德）
✅ 动土择日（避开土府/土禁）
✅ 出行择日（重驿马/天德）
✅ 搬家入宅（重天德/月德/成日）
✅ 安葬择日（重天赦/成日/开日）
✅ 签约谈判（重定日/成日）
✅ 求医问诊（重天医/除日）

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

✅ 日课评分（四柱配合度）
✅ 神煞评分（吉凶神数量与权重）
✅ 建除评分（十二值日适配度）
✅ 冲煞扣分（冲生肖/煞方位）
✅ 总分计算（0-100 分）
✅ 等级评定与趋吉避凶建议

🔗 技能联动

✅ 与八字喜用神配合择日
✅ 与奇门择时择方联动
✅ 多事项冲突时优先级建议

使用

python3 scripts/ze_ri.py --date "2026-04-15"
python3 scripts/ze_ri.py --month "2026-04" --event "婚嫁"
python3 scripts/ze_ri.py --date "2026-04-15" --score

变更

v4.0.0 (2026-05-10): 新增综合评分系统、神煞详解增强、日课择日法、紫白飞星时辰、分类择日扩充 v3.3.0 (2026-05-02): 新增时辰择日、分类择日细化、综合择日建议 v3.1.0 (2026-04-11): 统一断语风格、技能联动接口、十大技能协同 v2.0.0: 建除十二神、黄道黑道、神煞查询、分类择日

一、建除十二神

十二值日详解

值日	吉凶	宜	忌
建日	小吉	出行/上任	动土/开仓
除日	吉	扫除/求医/解除	婚嫁/上任
满日	吉	祭祀/祈福/婚嫁	服药/求医
平日	平	修补/平治	种植/动土
定日	吉	签约/订婚/安床	诉讼/出行
执日	吉	种植/捕捉	出行/搬家
破日	大凶	破除/拆迁	百事不宜
危日	小凶	祭祀/祈福	登高/行船
成日	大吉	婚嫁/开业/入学	诉讼/医疗
收日	吉	纳财/收债/入仓	出行/医疗
开日	大吉	开业/开张/动土	安葬
闭日	凶	修筑/闭塞	婚嫁/开业

推算方法

以月支起建，顺行十二日：

正月（寅月）：寅日起建，卯日除，辰日满...
二月（卯月）：卯日起建，辰日除，巳日满...

二、黄道黑道

十二值日黄道黑道

神将	类型	说明
青龙	🟢 黄道	大吉，利百事
明堂	🟢 黄道	吉，利求见/上任
天刑	🔴 黑道	凶，利刑罚/不宜喜事
朱雀	🔴 黑道	凶，利文书/不利口舌
金匮	🟢 黄道	大吉，利财运/婚嫁
天德	🟢 黄道	大吉，利百事
白虎	🔴 黑道	大凶，百事不宜
玉堂	🟢 黄道	吉，利求财/婚嫁
天牢	🔴 黑道	凶，不宜出行/上任
玄武	🔴 黑道	凶，防盗贼/不宜远行
司命	🟢 黄道	吉，利求医/祭祀
勾陈	🔴 黑道	凶，利捕捉/不宜婚嫁

三、神煞详解

吉神（20+）

吉神	推算	效用
天德贵人	按月查日	百事皆吉，逢凶化吉
月德贵人	按月查日	利婚嫁/开业/出行
天赦日	按季查日	百事大吉，赦免灾厄
三合日	按年支查	利合作/婚嫁/签约
六合日	按日支查	利和合/交易
生气日	按月查日	利求财/开业
福德日	按月查日	利祈福/祭祀
天医日	按月查日	利求医/制药
驿马日	按年支查	利出行/搬家
金堂日	按月查日	利求财/纳财
母仓日	按月查日	利婚嫁/孕育
时德日	按季查日	百事皆吉

凶煞（20+）

凶煞	推算	危害
月破日	月支冲日	百事皆凶
岁破日	太岁冲日	大事不宜
四离日	二分二至前一日	百事不宜
四绝日	四立前一日	百事不宜
杨公忌	特定农历日	百事禁忌
劫煞日	按年支查	防盗贼/破财
灾煞日	按年支查	防灾祸/疾病
月煞日	按月支查	不利出行
往亡日	按月查日	不利出行/上任
归忌日	按日查	不利归家/入宅
四击日	按月查日	不利战争/竞争
九空日	按月查日	不利纳财/开仓

特殊禁忌日

禁忌	日期	说明
杨公十三忌	正月十三、二月十一、三月初九...	百事禁忌
三娘煞	每月初三、初七、十三、十八、廿二、廿七	不利婚嫁
红砂日	按季查日	不利婚嫁/动土
暗金煞	按年查	不利动土/装修

四、时辰择日详解

十二时辰吉凶

每个时辰根据当日干支与十二神将的关系判断吉凶：

时辰	时间	阴阳	说明
子时	23:00-01:00	阴极	夜半，阴气最盛
丑时	01:00-03:00	阳生	鸡鸣，阳气初生
寅时	03:00-05:00	阳渐	平旦，阳气渐盛
卯时	05:00-07:00	阳升	日出，阳气上升
辰时	07:00-09:00	阳旺	食时，阳气正旺
巳时	09:00-11:00	阳极	隅中，阳气极盛
午时	11:00-13:00	阴生	日中，阳极阴生
未时	13:00-15:00	阴渐	日昳，阴气渐长
申时	15:00-17:00	阴升	哺时，阴气上升
酉时	17:00-19:00	阴旺	日入，阴气正盛
戌时	19:00-21:00	阴盛	黄昏，阴气渐盛
亥时	21:00-23:00	阴极	人定，阴气极盛

择时原则

事项	推荐时辰	依据
婚嫁	辰、巳、午	阳气旺盛，利喜庆
开业	辰、巳、午、未	阳气正盛，利财运
动土	辰、巳、午	阳气旺，利兴造
出行	寅、卯、辰	阳气升，利远行
签约	巳、午、未	阳气旺，利和合
求医	卯、辰、巳	天医时，利治疗
祭祀	子、丑、寅	清静时，利通神

紫白飞星时辰法

按日干支推算当日各时辰的紫白飞星：

一白时：利求财、桃花
六白时：利贵人、事业
八白时：利财运、置业
九紫时：利喜庆、姻缘

五、日课择日法

四柱日课

选择吉日需综合年月日时四柱：

年柱：不可冲太岁，宜合太岁
月柱：不可冲月令，宜得月令
日柱：不可冲主人生肖，宜与八字相合
时柱：宜生旺主事，不可空亡

日课吉凶判断

大吉日课：四柱相生，无冲无破，吉神叠加
中吉日课：四柱基本和谐，有吉神化解
小吉日课：有小冲小破，但吉神多于凶煞
凶日日课：四柱相冲，凶煞叠至，百事不宜

日课与主人生肖

择日必须避开冲主人生肖之日：

鼠年生人：避开午日（子午冲）
牛年生人：避开未日（丑未冲）
虎年生人：避开申日（寅申冲）
兔年生人：避开酉日（卯酉冲）
龙年生人：避开戌日（辰戌冲）
蛇年生人：避开亥日（巳亥冲）
马年生人：避开子日（子午冲）
羊年生人：避开丑日（丑未冲）
猴年生人：避开寅日（寅申冲）
鸡年生人：避开卯日（卯酉冲）
狗年生人：避开辰日（辰戌冲）
猪年生人：避开巳日（巳亥冲）

六、综合评分系统

评分维度（满分 100 分）

维度	权重	满分	说明
建除值日	25%	25 分	成日/开日 25 分，定日/收日 20 分，破日 0 分
神煞评估	30%	30 分	天德/月德/天赦各 +10，三煞/岁破各 -10
冲煞评估	20%	20 分	不冲主人生肖 20 分，冲则扣 10-20 分
时辰配合	15%	15 分	吉时 15 分，平时 10 分，凶时 0 分
五行平衡	10%	10 分	日课五行生主八字 10 分

等级评定

分数	等级	建议
85-100	上吉日	百事皆宜，大吉之日
70-84	中吉日	多数事项可行，注意避开小凶
55-69	小吉日	需择吉时，化解煞气后可用
40-54	平日	不宜大事，小事可行
0-39	凶日	百事不宜，另择吉日

七、分类择日模板

婚嫁择日

首选：天德/月德/成日/开日 + 三合/六合
避开：三娘煞、杨公忌、红砂日、月破日
最佳月份：春秋两季（二/三/八/九月）

开业择日

首选：生气/天德/成日 + 紫白旺星时辰
避开：岁破、月破、劫煞
最佳时辰：辰时/巳时

动土择日

首选：天德/成日/开日
避开：土府/土禁/红砂/暗金煞
最佳方位：当年大利方

出行择日

首选：驿马/天德/开日
避开：往亡/归忌/月煞
最佳时辰：寅时/卯时

天工长老按： 择日之术，贵在趋吉避凶。v4.0 新增综合评分、日课择日、神煞详解，使择日从"经验判断"走向"量化评估"。

"善择日者不择，重在明理知时，顺势而为。"

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