bashen-ts-lib

八神法占卜 TypeScript 库 - 用于传统占卜术数计算

介绍

八神法是一种传统占卜术,起课简单,使用方便,准确度稳定。本库提供了完整的八神法占卜算法实现。

安装

``bash
npm install bashen-ts-lib


或

pnpm add bashen-ts-lib

或

yarn add bashen-ts-lib
`

使用方法

$3

`typescript
import { divinate, TianGan, DiZhi } from 'bashen-ts-lib'

// 使用时干法占卜 - 甲寅时
const result = divinate({
gan: TianGan.Jia,
zhi: DiZhi.Yin,
})

console.log(result)
// {
// ganZhi: { gan: '甲', zhi: '寅' },
// gongWei: { gan: '震', zhi: '离' },
// shenPan: { 震: '青龙', 巽: '六合', ... },
// timestamp: Date
// }
`

$3

`typescript
import { getPaiGongWei, TianGan, DiZhi } from 'bashen-ts-lib'

const gongWei = getPaiGongWei({
gan: TianGan.Jia,
zhi: DiZhi.Yin,
})

console.log(gongWei)
// { gan: '震', zhi: '离' }
`

$3

`typescript
import { getPaiShenPan, TianGan, DiZhi } from 'bashen-ts-lib'

const shenPan = getPaiShenPan({
gan: TianGan.Yi,
zhi: DiZhi.Mao,
})

console.log(shenPan)
// { 震: '六合', 巽: '朱雀', 离: '腾蛇', ... }
`

API 文档

$3

- TianGan: 十天干 (甲、乙、丙、丁、戊、己、庚、辛、壬、癸)
- DiZhi: 十二地支 (子、丑、寅、卯、辰、巳、午、未、申、酉、戌、亥)
- Bagua: 后天八卦 (震、巽、离、艮、兑、乾、坎、坤)
- BaShen: 八神 (青龙、六合、朱雀、腾蛇、勾陈、贵人、白虎、玄武)

$3

#### divinate(ganZhi: GanZhi): DivinationResult

执行完整的八神法占卜

- 参数: ganZhi - 干支时辰
- 返回: 完整的占卜结果,包括宫位和神盘

#### getPaiGongWei(ganZhi: GanZhi): GongWei

排干支宫 - 计算天干地支对应的八卦宫位

- 参数: ganZhi - 干支时辰
- 返回: 宫位信息

#### getPaiShenPan(ganZhi: GanZhi): ShenPan

排神盘 - 根据天干确定八神在八卦中的分布

- 参数: ganZhi - 干支时辰
- 返回: 神盘映射

$3

- tianGanToBagua(gan: TianGan): Bagua - 天干转八卦
- diZhiToBagua(zhi: DiZhi): Bagua - 地支转八卦
- getStartBaShen(gan: TianGan): BaShen - 获取天干对应的起始八神

开发

`bash


安装依赖

pnpm install

开发模式(监听文件变化)

pnpm dev

构建

pnpm build

代码检查

pnpm lint

代码格式化

pnpm format
``

原理说明

$3

天干从震开始顺数:
- 甲→震, 乙→巽, 丙→离, 丁→艮, 戊→兑, 己→乾, 庚→坎, 辛→坤, 壬→震...

地支从震开始顺数:
- 子→震, 丑→巽, 寅→离, 卯→艮, 辰→兑, 巳→乾, 午→坎, 未→坤, 申→震...

$3

天干起始八神:
- 甲日起青龙, 乙日起六合, 丙朱雀, 丁腾蛇, 戊勾陈, 己贵人, 庚辛白虎, 壬癸玄武

从震宫开始,按八卦顺序(震→巽→离→艮→兑→乾→坎→坤)排列八神。

License

MIT