玄烛命理 - 八字排盘库

首个基于纯JavaScript无依赖的八字排盘库，也是首个具有完整的神煞系统的八字排盘库，完全根据渊海子平原文发表的八字排盘原理，提供完整的八字命理计算和分析功能 完全功能使用可以在这个网页中看到：

https://8char.space 页面预览

作者B站账号：玄烛排盘，人气低迷求关注~

https://space.bilibili.com/3546581452196143

功能特性

核心功能

• ✅ 八字排盘 - 根据出生年月日时计算四柱八字
• ✅ 大运流年 - 自动计算大运、流年、小运
• ✅ 十神分析 - 完整的十神关系分析
• ✅ 五行力量 - 五行力量计算和平衡分析
• ✅ 神煞系统 - 天乙贵人、月德贵人等神煞标注
• ✅ 渊海子平 - 月令、太岁、身强分等传统分析

高级功能

• ✅ 当前运势 - 聚焦当前年份的大运/流年/小运分析
• ✅ 流月流日 - 精确到月和日的运势分析
• ✅ 命宫身宫 - 命宫、身宫、胎元、胎息计算
• ✅ 天干地支关系 - 五合、六合、相冲等关系分析
• ✅ 性格分析 - 基于八字的人格特质分析

安装使用

安装

npm install mystilight-8char

基本使用

import paipan from 'mystilight-8char';
// 获取当前八字分析
const result = paipan.getCurrentEightCharJSON({
  year: 1990,    // 出生年
  month: 5,      // 出生月
  day: 15,       // 出生日
  hour: 14,      // 出生时
  minute: 30,    // 出生分
  sect: 2,       // 八字流派 (1或2)
  gender: 1      // 性别 (1男，0女)
});

console.log(result);

API 文档

getCurrentEightCharJSON(options)

获取当前八字分析的完整JSON结果。

参数:

• year (number): 出生年
• month (number): 出生月
• day (number): 出生日
• hour (number, 可选): 出生时，默认0
• minute (number, 可选): 出生分，默认0
• second (number, 可选): 出生秒，默认0
• sect (number, 可选): 八字流派(1或2)，默认2
• gender (number, 可选): 性别(1男，0女)，默认1
• currentYear (number, 可选): 当前年，默认系统年
• currentMonth (number, 可选): 当前月，默认系统月
• currentDay (number, 可选): 当前日，默认系统日

返回值: 包含完整八字分析的对象

fromBaZi(yearGanZhi, monthGanZhi, dayGanZhi, timeGanZhi, sect, baseYear)

从八字反推可能的出生日期。

参数:

• yearGanZhi (string): 年柱
• monthGanZhi (string): 月柱
• dayGanZhi (string): 日柱
• timeGanZhi (string): 时柱
• sect (number, 可选): 八字流派
• baseYear (number, 可选): 基准年

返回值: 可能的出生日期数组

输出结构示例

{
  "input": {
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 14,
    "minute": 30
  },
  "current": {
    "year": 2025,
    "month": 1,
    "day": 1
  },
  "pillars": {
    "year": {
      "value": "庚午",
      "gan": "庚",
      "zhi": "午",
      "hideGan": ["丁", "己"],
      "wuXing": "金火",
      "naYin": "路旁土",
      "shiShenGan": "正财",
      "shiShenZhi": ["劫财", "伤官"]
    }
    // ... 月柱、日柱、时柱
  },
  "wuXingPower": {
    "木": 14.95,
    "火": 30.84,
    "土": 42.99,
    "金": 8.41,
    "水": 2.8
  },
  "currentYun": {
    "daYun": {
      "ganZhi": "丙寅",
      "shiShen": "劫财"
    },
    "liuNian": {
      "year": 2025,
      "ganZhi": "乙巳",
      "shiShen": "偏印"
    }
  }
}

运行测试

npm test

技术特点

• 纯JavaScript - 无外部依赖，轻量级实现
• 高性能 - 优化的算法和数据结构
• 模块化设计 - 易于扩展和维护
• 完整测试 - 确保计算准确性
• TypeScript支持 - 提供类型定义

注意事项

1. 本库仅供学习和研究使用
2. 命理分析结果仅供参考，不应作为决策依据
3. 计算结果可能存在微小误差，建议交叉验证

贡献指南

欢迎提交Issue和Pull Request来改进这个项目。

许可证

ISC License

更新日志

v1.0.0

• 初始版本发布
• 完整的八字排盘功能
• 大运流年计算
• 神煞系统集成

---

本项目基于传统八字命理学原理开发，计算结果仅供学术研究参考。