| 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
