核心用法
八字排盘技能通过 buildBaziFromSolar.js 脚本将阳历出生时间转换为传统命理学中的四柱八字结构。用户需提供 ISO 8601 格式的时间字符串(如 1990-05-15T14:30:00),系统返回年柱、月柱、日柱、时柱的天干地支组合,并附带五行属性与十神关系分析。
关键参数配置:
- gender(性别):影响十神排列(男命女命十神对应不同),默认男性
- sect(子时算法):解决 23:00-23:59 出生的跨日争议,
1=晚子时算次日,2=晚子时算当日(默认)
显著优点
1. 历法转换自动化:内置阳历转农历/干支算法,无需手动查万年历,降低专业门槛
2. 十神自动推导:根据日干自动计算比肩、劫财、食神、伤官、正财、偏财、正官、七杀、正印、偏印十组关系
3. 参数灵活可控:子时算法可配置,兼容命理流派差异(如子平派 vs. 滴天髓派)
4. 输出结构标准化:便于后续接入命盘可视化、大运流年计算等扩展模块
潜在缺点与局限性
- 真太阳时未校正:输入时间为平太阳时(标准时区时间),未考虑出生地经度与真太阳时的差异,传统命理中可能产生 1-2 个时辰的误差
- 夏令时盲区:未说明是否自动处理 1986-1991 年中国夏令时历史数据
- 命理解释缺失:仅输出排盘数据,不含格局分析、喜用神判断、流年大运解读等深度内容
- 流派单一性:十神与五行判定基于子平法,未覆盖紫微斗数、七政四余等其他命理体系
适合人群
- 命理爱好者:快速获取自身八字结构,省去手工查表
- 命理从业者:批量生成客户命盘基础数据,作为分析起点
- 文化研究者:需要标准化干支数据进行民俗学或历法研究
- 开发者:构建命理类应用的底层排盘引擎
常规风险
| 风险类型 | 说明 |
|---------|------|
| 时间输入错误 | ISO 格式不含时区,用户可能误填 UTC 或本地时间导致时辰错位 |
| 子时争议 | 23:00-23:59 出生若未正确配置 `sect`,排盘结果可能与预期不符 |
| 命理迷信 | 输出结果可能被过度解读,需明确工具仅提供历法转换,不承诺预测效力 |
| 隐私敏感 | 出生时间属个人敏感信息,系统需确保数据处理合规 |
技术可靠性评估
该技能基于成熟的历法转换算法(农历-阳历映射表、干支纪年循环),数学层面可验证。但命理学本身不属于科学验证范畴,输出结果的"准确性"需区分历法计算准确性(高)与命理解释有效性(无科学共识)。