择吉日课（Rike）工具箱
本工具箱把《择吉日课》课件的口诀与表格结构化，配合 scripts/zeri.py 做确定性推算，避免临场心算出错。
铁律
- 先避凶，后趋吉。凶未避净，吉神再多也不取。
- 能算的必须算。干支、节气、建除、神将一律用脚本算，不心算。
- 查不到就说查不到。二十八宿值宿、偷休日、三煞方、五黄、玄空飞星为课件图表页，脚本无法推算，必须标注「需查通书核对」。
- 依据可核查。每条结论都要能指向某张表、某句口诀或某个地支关系。
目录
| 文件 | 内容 |
|---|---|
references/01-地支刑冲破害合.md |
三刑、六冲、六害、六破、三合、六合 |
references/02-十二月建与十二值神.md |
建除十二神、配值神、黄黑道、吉凶定性 |
references/03-十二时辰吉凶表.md |
日支配时辰的十二神将表（择时用） |
references/04-二十八宿与金神七煞.md |
四象七宿、金神七煞、值宿推算说明 |
references/05-天德月德天赦天愿表.md |
逐月天德/月德/天赦/天愿/天喜/红鸾/福德 |
references/06-吉神方位与天乙贵人表.md |
日干起天乙贵人、文昌、太极、禄、财神、喜神方位 |
references/07-女命出嫁择月表.md |
十二属相大利月、小利月、妨夫妨自妨父母妨公月 |
references/08-安葬吉日禁忌表.md |
逐月受死、月破、月建、重丧、大重、开收、丧门、暴败、五鬼 |
references/09-祈福祭祀宜忌日.md |
祈福宜忌日与六十甲子祈福吉日清单 |
references/10-分场景择日SOP.md |
开业 / 搬家 / 嫁娶 / 安葬 / 祈福 五大流程与口诀 |
references/11-课件存疑与补录.md |
课件内部矛盾、OCR 疑误、图表页缺口清单 |
scripts/zeri.py |
干支四柱、节气、建除、神将、神煞推算 CLI |
使用流程
1. 先拿到三件事
事类、事主生肖（嫁娶要男女双方）、时间窗口。缺哪项问哪项，一次性问完。
2. 跑脚本出底稿
python3 scripts/zeri.py day 2026-09-09 # 单日全量课体
python3 scripts/zeri.py scan 2026-09-01 2026-09-30 --zodiac 卯 # 区间逐日扫描
python3 scripts/zeri.py hour 2026-09-09 # 当日十二时辰神将
python3 scripts/zeri.py terms 2026 # 当年二十四节气
python3 scripts/zeri.py relation 卯 亥 # 两个地支的关系
python3 scripts/zeri.py bride 午 # 女命生肖出嫁择月
python3 scripts/zeri.py burial 九 # 某月安葬忌日
scan 是主力命令：一次把窗口内每天的干支、月建、建除、值神、吉凶、与事主生肖的关系全部列出，直接在此基础上过筛。
3. 按 references/10-分场景择日SOP.md 逐层过筛
避凶清单 → 趋吉清单 → 排序出候选日 → 择时 → 方位与仪式。
4. 出《日课单》
格式见 Agent 主文件的「输出规范」章节。
边界
- 不提供医疗、法律、投资建议；剖腹产择日一律婉拒并说明需遵医嘱。
- 脚本不做公历↔农历换算。择日定月本以节气为界（立春入寅月、惊蛰入卯月……），脚本全部按节气推算，这比按农历初一更合古法。农历日期仅用于沟通，请用户提供或自行以万年历核对。
- 二十八宿值宿、偷休日、三煞方、五黄、玄空飞星、胎元、十二长生不在脚本能力内，需查通书。
