dhicoc 干支基础（天干地支推算与节气运气映射）
适用范围
- 学生入门：学习天干地支基本概念与纪年方法
- 年份干支快速查询：公历年份转换为干支
- 六十甲子表查阅：确认甲子序列与对应年份
- 节气与六气交司关系：确定某节气所处之气与运
- 节气与五运交司关系：确定某节气所处之运
- 为下游运气推算子技能提供干支基础数据
脚本依赖
| 脚本名称 | 功能说明 | 输入 | 输出 |
|---|---|---|---|
calculate_yunqi_api.py |
公历年份→天干地支（统一推算引擎） | 年份（整数，如2024） | 天干、地支、完整干支（如"甲辰"）、甲子序号（year_gz / sexagenary_index） |
推荐工作流
- ACT: 接收用户请求，明确需要查询的公历年份或干支。若用户仅提供干支（如"甲辰"），需反推年份范围。
- ACT: 调用
calculate_yunqi_api.py，传入年份参数，获取该年的天干、地支、完整干支及甲子序号。命令示例：python scripts/calculate_yunqi_api.py 2024 --json - ACT: 查阅六十甲子表（参考文件
references/liushijiazi.md），确认该干支在六十甲子中的序号位置，并关联该甲子年的大运与司天在泉信息。 - ACT: 查阅节气对应表（参考文件
references/jieqi.md），确定当前或目标节气所处的六气步位（初之气至终之气）与五运步位（初运至终运）。 - ACT: 查阅天干地支基础理论（参考文件
references/tiangan_dizhi.md），根据天干确定中运（大运）五行属性，根据地支确定司天在泉六气。 - ACT: 汇总输出，将干支信息、甲子序号、大运、六气格局、节气运气交司关系整理为结构化结果，传递给下游子技能。
常见误区
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 年份干支算错 | 公历年份与农历年份混淆，或未注意立春为干支年分界 | 以公历年份为准，但需注意：立春（约2月4日）之前仍属上一年干支。脚本输入公历年份，输出该年立春后的干支 |
| 天干地支阴阳配错 | 误以为天干地支可任意配对 | 阳干配阳支，阴干配阴支。甲丙戊庚壬配子寅辰午申戌，乙丁己辛癸配丑卯巳未酉亥 |
| 六十甲子序号算错 | 未从甲子（序号1）开始计数，或误将癸亥（序号60）后接甲子 | 六十甲子从甲子（1）始，至癸亥（60）止，循环往复。用脚本计算确保准确 |
| 节气六气交司时间弄错 | 误将节气与六气的对应关系搞混 | 严格参照 references/jieqi.md 中的交司表。初之气从大寒始，非立春 |
| 大运五行属性取错 | 天干化运与天干本身五行属性混淆 | 大运用"天干化运"（甲己化土、乙庚化金、丙辛化水、丁壬化木、戊癸化火），非天干本身五行 |
输出要求
- 干支推算结果须包含：公历年份、天干、地支、完整干支、甲子序号
- 须标注推算所用脚本名称与版本
- 须注明立春分界提示（若查询日期在立春前后）
- 节气运气交司结果须标注出处（参考文件名）
- 所有五行六气术语须使用标准中医运气学说术语
路由上下文
- 上游入口：用户直接请求干支查询；或由五运六气主技能路由进入
- 下游出口：将干支、甲子序号、大运、六气格局传递给
yunqi-classics（经典文献验证）和docs-generator（报告生成） - 同级关联：与
yunqi-classics同级，均为五运六气技能包的子技能
ACTION REQUIRED
- 确认
calculate_yunqi_api.py脚本可用且路径正确 - 确认参考文件
references/tiangan_dizhi.md、references/liushijiazi.md、references/jieqi.md均存在且内容完整 - 运行脚本验证至少3个已知年份（如2024甲辰、2025乙巳、2026丙午）
- 确认输出格式符合下游子技能的输入要求
任务完成自检
- 天干地支推算结果正确（与已知年份对照验证）
- 六十甲子序号与参考表一致
- 节气与六气交司关系正确引用
- 节气与五运交司关系正确引用
- 立春分界提示已包含（如适用）
- 推算脚本名称已标注
- 输出已结构化，可被下游子技能解析