老黄历计算技能（Lao Huangli）

何时使用

当用户出现以下需求时启用：

• - 询问“老黄历是怎么算出来的”
• 指定日期要查询：农历、干支、节气、宜忌、冲煞、值日神
• 需要解释“哪些部分可精确计算、哪些部分来自规则流派”
• 关键词触发：老黄历、黄历、万年历、宜忌、择日、通胜、冲煞、彭祖百忌、建除十二神、INLINECODE9

核心原则

1. 1. 先算历法，再套规则：先得到可靠的天文/历法基础字段，再生成宜忌。
2. 区分“确定性”与“流派性”：节气、干支、农历可精确计算；宜忌、吉凶级别常依赖规则库。
3. 必须可追溯：输出时明确计算边界、时区、采用的规则版本。

双原典边界

• - 基础历法层：以 GB/T 33661-2017《农历的编算和颁行》 为准，负责农历、节气、朔望、闰月、干支。
• 黄历规则层：以 《钦定协纪辨方书》 为准，负责建除、黄黑道、神煞、冲煞、胎神、彭祖百忌和宜忌裁决。
• 补充古籍：若某事实层字段暂未在 《钦定协纪辨方书》 中结构化落盘，可使用其他可追溯古籍补充，但必须在 provenance.sourceRefs 中逐项显式标明，不得冒称为协纪辨方书原文。
• 术语/展示材料：只用于解释字段含义，不得直接替代规则原典。

计算总流程（工程化）

1. 1. 输入标准化

1. 2. 基础历法计算（确定性）

1. 3. 干支计算（确定性）

1. 4. 黄历神煞/值日体系（规则表）

1. 5. 宜忌生成（规则引擎）

1. 6. 可解释输出

精确计算 vs 规则依赖

• - 可精确计算：公历换算、JDN、节气时刻、朔望月、农历日期、干支。
• 依赖规则库：宜忌、吉凶等级、部分神煞解释、事项冲突裁决。
• 可能分歧点：年界（立春/春节）、日界（23:00/00:00）、流派差异（通书体系不同版本）。

对话执行模板

1. 1. 先确认日期时间与时区。
2. 给出历法基础结果（农历 + 干支 + 节气）。
3. 再给宜忌结果，并说明规则来源。
4. 明确风险提示：黄历建议仅作文化参考，不替代法律、医疗、财务和安全决策。

计算执行（脚本优先）

优先使用脚本计算“可精算字段”，不要直接凭网页汇总给结论。

CODEBLOCK0

脚本产出保证：

• - 公历→农历
• 年/月/日/时干支
• 节气区间与交节时刻
• 12 时辰干支

当前脚本支持三种 profile：

• - market-folk-v1：春节换年 + 00:00 换日（更贴近大众挂历）
• INLINECODE16：春节换年 + 00:00 换日（规则来源预留为《协纪辨方书》体系）
• INLINECODE17：立春换年 + 23:00 换日（更贴近八字排盘）

默认直接查询时，优先按 market-folk-v1 输出，效果更接近常见挂历版老黄历。

兼容说明：

• - 仍兼容旧参数 INLINECODE19
• 推荐新调用方式统一使用 INLINECODE20

脚本不会伪造：

• - 宜/忌、建除、值神、吉神凶神、冲煞、胎神、彭祖百忌等规则字段（未加载规则库时明确输出“待规则库补齐”）

推荐直接运行（无需本地安装依赖）：

CODEBLOCK1

如需本地固定环境，再手动安装依赖：

CODEBLOCK2

当前实现状态：

• - profile/ruleset 目录结构已建立
• INLINECODE21 与 rule_engine 模块骨架已建立
• INLINECODE23 已输出 profileId、profileLabel、边界信息、ruleLayer、INLINECODE27
• INLINECODE28 与 market-folk-v1 已输出可用的 INLINECODE30
• INLINECODE31 已稳定承载 jianchu、yellowBlackDao、dutyGod、goodStars、badStars、chongsha、taishen、INLINECODE39
• INLINECODE40 的 宜/忌 已覆盖 建/除/满/平/定/执/破/危/成/收/开/闭 的一批卷十直引条目
• INLINECODE43 已补齐常用 冲煞、胎神、彭祖百忌，并沿用同一批高频 建除 宜忌收口
• INLINECODE48 已补齐常用 财神 / 喜神 / 福神 方位
• INLINECODE50 默认只输出 bazi-core，如指定 --overlay-ruleset 则输出 hybrid 黄历层
• INLINECODE53 已输出 ruleLayer、ruleSourceLevel、sourceRefs、INLINECODE57
• 节气现已改为 Skyfield + JPL ephemeris 的天文时刻窗口输出，并带 currentAt / INLINECODE60
• INLINECODE61 现已提供 table、currentJie、currentQi、nextJie、nextQi，便于后续按 6tail 风格继续派生字段
• INLINECODE67 现已提供 monthStartDate、monthEndDate、monthDayCount、leapMonth、zhongQi、containsZhongQi、anchorYear、yearMonthTable、yearMonthCount、yearLeapMonth、currentMonthIndex、INLINECODE79
• 农历月序、定朔与无中气置闰仍未完整升级到 GB/T 33661-2017 口径

规则来源约束：

• - 每条规则文件必须带 INLINECODE81
• 每条规则文件必须带 INLINECODE82
• INLINECODE83 当前混合 L1-primary 与 INLINECODE85
• INLINECODE86 目前使用 L2-derived-documented / L3-market-observed 混合标记

输出格式（仿挂历，默认详细版）

默认输出采用“挂历完整版”（正常版本），只有用户明确要求“简版/速览”时才降级精简。
下面只示意版式，不表示某个真实日期的计算结果。

CODEBLOCK3

字段顺序（固定）

1. 1. 顶部主栏：公历日期 + 星期
2. 历法层：农历（含闰月）、干支、节气（当前/下个与时刻）
3. 宜忌层：【宜】 与 【忌】（宜在前）
4. 日神层：建除、黄黑道、值神、冲煞、胎神、彭祖百忌、吉神凶煞
5. 方位层：财神/喜神/福神
6. 时辰层：12 时辰吉凶（每行含时间段、吉凶、宜忌）
7. 末尾说明：规则版本与边界（年界/日界）

模式规则

• - 默认：详细版（正常版）
• 仅当用户明确要求“简版、速览、只看宜忌”时，输出精简版

排版规则

• - 【宜】 与 【忌】 必须分行且“宜在前”
• 时辰吉凶固定为 12 行（可折叠但不可省略为 1 行总结）
• 若字段缺失，必须写 待规则库补齐，不可静默忽略
• 末尾必须附：

示例

用户：INLINECODE95

回答结构建议：

1. 1. 历法层：公历/农历/干支/节气
2. 规则层：建除/值神/冲煞
3. 结论层：宜出行的规则依据 + 忌事项 + 边界说明

按需阅读

• - 计算细化：INLINECODE96
• 规则分歧处理：INLINECODE97
• 脚本实现：INLINECODE98