用途:cantian-bazi 面向命理场景,依据阳历或农历出生时间生成四柱八字,并可查询黄历/农历干支、宜忌,以及一段时间内的大运、流年、流月、流日、流时。
主要能力:脚本 buildBaziFromSolar.ts 由阳历生成八字,buildBaziFromLunar.ts 由农历生成八字;convertToTrueSolarTime.ts 按经度(或城市名)把北京时间换算为真太阳时;getChineseCalendar.ts 查询指定日期(默认今天)的农历与干支;queryFortuneRange.ts 按时间区间查询大运与流年/流月/流日/流时,结果含干支、十神、神煞及与原命盘的刑冲合会关系,流时按 2 小时时辰段合并,输出为完整 Markdown。
使用方式:先进入 SKILL.md 所在目录,执行 npm i;低版本 Node 可 npm i -D tsx 作兼容。推荐 Node 24 直接运行,如 node scripts/buildBaziFromSolar.ts "1990-05-15T14:30:00";兼容方式用 tsx 替换 node。八字脚本参数为 solarTime/lunarTime(ISO 8601,不带时区)、可选 gender(1 男 0 女,默认 1)、可选 sect(1 表示 23:00-23:59 归明天,2 表示归当天,默认 2)。黄历脚本可传 YYYY-MM-DD。区间查询脚本接收 JSON 字符串,含 birth.calendar/time/gender/sect 与 query.startDateTime/endDateTime/level(year/month/day/hour,默认 year)。
限制:时间字符串不要带时区后缀;真太阳时需先用换算脚本,再传给其它脚本;23:00-23:59 出生建议显式传 sect;区间查询只支持 YYYY-MM-DD 或 YYYY-MM-DDTHH,level=hour 且范围超过 62 天会报错。其余收费、效果等资料暂未提供。