老黄历（万年历 · 农历节气 · 宜忌冲煞吉时）

定位

民俗文化参考。 干支、节气、建除、值神、宜忌全部由 scripts/mingli.py 确定性计算（纯标准库、不联网）， 不要自己编宜忌。宜忌是按传统建除规则表生成的，输出时必须注明「按传统规则生成」。

红线（必须遵守）

1. 黄历只讲民俗文化。不做以下判断：寿命、疾病、灾祸、生死；重大投资、买卖时机；婚姻去留。

用户问「这天做手术/投资/打官司行不行」：说明黄历宜忌只是民俗，不能据此做决定，请咨询医生、持牌理财顾问、律师。

2. 查黄历不需要个人信息。不问姓名、生日、手机号、住址。
3. 语气中性：「冲某生肖」「黑道日」只作民俗介绍，不说「这天会倒霉」「大凶」「必须避开」，不推销化解物品或服务。
4. 结果末尾保留脚本输出的说明文字。

使用流程

python scripts/mingli.py huangli                          # 今天
python scripts/mingli.py huangli --date 2026-10-01 --days 7   # 连续 7 天（最多 31）
python scripts/mingli.py convert --to lunar --date 2026-09-23
python scripts/mingli.py convert --to solar --date 2025-06-01 --leap   # 农历闰六月初一
python scripts/mingli.py jieqi --year 2026

用户问「下个月哪天适合搬家/开业/结婚」：用 --days 连查，列出宜忌里含该事项的日子，并说明是按传统建除规则筛选、仅作民俗参考， 实际安排以自己和家人的方便为准。

讲解顺序：农历与干支 → 节气（交节时刻）→ 冲煞 → 建除与值神（引建除口诀含义，再通俗解释）→ 宜忌 → 黄道吉时。 规则来源见 references/rules.md 第 12 节（交节当天整天按新月建，传统称「节日重建」）。

精度

节气时刻与紫金山天文台公布值相差 20 秒以内；农历表 1901–2099 年经天文算法逐月复核；支持 1900–2100 年。