bushi4java

卜筮 — Java 六爻 / 梅花易数排盘引擎，基于 tyme4j。

功能

• 64卦排盘（本卦、互卦、变卦）
• 六爻装卦（纳甲、六亲、世应、伏藏、六神）
• 梅花易数起卦（时间 / 数字 / 随机 / 手摇）
• 六爻起卦（时间 / 数字 / 随机 / 手摇）
• 基于 tyme4j 提供干支、旬空、农历月日
• 晚子时自动换日（23:00~00:00 归入次日子时）
• 内置 64 卦卦爻辞与解卦静态文本（见下方开源说明）

安装

Maven：

<dependency>
    <groupId>io.github.ericonyu</groupId>
    <artifactId>bushi4java</artifactId>
    <version>0.1.0</version>
</dependency>

Gradle：

implementation 'io.github.ericonyu:bushi4java:0.1.0'

快速上手

import io.github.ericonyu.bushi4java.context.TymeContextBuilder;
import io.github.ericonyu.bushi4java.liuyao.LiuYao;
import io.github.ericonyu.bushi4java.meihua.MeiHua;
import io.github.ericonyu.bushi4java.gua64.GuaTextsLoader;
import java.time.LocalDateTime;

DivinationContext ctx = TymeContextBuilder.build(LocalDateTime.of(2026, 4, 30, 10, 0));

// 六爻时间起卦
PaipanResult r = LiuYao.shiJianQiGua(ctx);
System.out.println(r.getBenGua().getName());     // 地水师
System.out.println(r.getBianGua().getName());     // 山水蒙
System.out.println(r.getBenGuaEx().getLiuQin());  // 父兄官财官子

// 梅花时间起卦
PaipanResult mh = MeiHua.shiJianQiGua(ctx);

起卦方式

方式	六爻	梅花
时间起卦	LiuYao.shiJianQiGua	MeiHua.shiJianQiGua
数字起卦	LiuYao.shuZiQiGua	MeiHua.shuZiQiGua
随机起卦	LiuYao.suiJiQiGua	MeiHua.suiJiQiGua
手摇起卦	LiuYao.shouYaoQiGua	MeiHua.shouYaoQiGua

排盘结果

PaipanResult 包含：

• benGua / huGua / bianGua：本卦、互卦、变卦（卦名 + 六爻阴阳）
• benGuaEx / bianGuaEx：纳甲装卦（地支干支、六亲、世应、伏藏、卦身、八宫、五行、类型）
• liuShen：六神（根据日干排列）
• ganZhi：四柱干支、xunKong：旬空
• bianYao：动爻位置

六爻坐标契约（集成必读）

本库所有六爻数据统一按画面从上到下排列，调用方不得自行猜测或二次反转：

语义	上爻（六爻）	五爻	四爻	三爻	二爻	初爻
数组索引	0	1	2	3	4	5
世应/伏藏位置	1	2	3	4	5	6

• 爻数组、六亲、干支和六神都是“上爻到初爻”；UI 应直接按索引 0...5 从上向下绘制。
• 世爻、应爻和伏藏位置是 1-based，换算数组索引只需 position - 1。
• 动爻索引是 0-based；-1 表示无动爻。手摇多动爻时，结果中的单个动爻字段只记录首个动爻，全部动爻应检查本卦爻值中的老阳 3 和老阴 4。
• 铜钱手摇通常按“初爻到上爻”依次记录；传入手摇 API 前必须反转一次成为“上爻到初爻”，返回后不要再反转。
• 变卦六亲以本卦所属五行为基准重装，不能直接使用变卦静态扩展数据中的原始六亲。
• 数字起卦参数为 [上卦数, 下卦数, 动爻位]；第三个数字独立决定爻位，不与前两个数字求和。动爻位按6取余；0及6的倍数为上爻，其他余数1...5对应初爻至五爻，例如7为初爻、12为上爻。
• 时间起卦先按传统算法得到 1...6 的爻位，再统一转换为顶部优先数组索引；随机起卦独立随机上下卦和 1...6 的动爻。

标准回归案例

基准时间为 2026-08-08 亥时（四柱：丙午、丙申、甲寅、乙亥，旬空：子丑）。山火贲（艮宫、六合）三爻动，变山雷颐（巽宫、游魂）。以下各列均从上爻到初爻：

卦	六亲	干支	世应	伏藏
山火贲	官财兄财兄官	寅木、子水、戌土、亥水、丑土、卯木	世=6，应=3	4=子申金，5=父午火
山雷颐	官财兄兄官财	寅木、子水、戌土、辰土、寅木、子水	世=3，应=6	2=子巳火，4=官酉金

甲日六神为 玄武、白虎、螣蛇、勾陈、朱雀、青龙。本案例已经作为自动化测试固定，适合用于客户端接入后的截图或字段对照。

卦爻辞与解卦

GuaTexts texts = GuaTextsLoader.getGuaTexts("乾为天");
// texts.getYaoCi() → 卦辞 + 爻辞
// texts.getJieXi() → 解卦解析

多语言版本

bushi（卜筮）同时提供以下语言版本：

• Dart：bushi4dart
• Go：bushi4go
• Java：bushi4java
• Python：bushi4python
• TypeScript：bushi4ts
• Swift：bushi4swift
• Kotlin：bushi4kotlin

---

关于不惑之心

不惑之心 — 传统文化与命理工具品牌

• 官网：https://www.buhuo.xin
• 作者：净志
• 微信：haitaojingzhi

开源说明

• 排盘算法（六爻、梅花易数、64 卦）以 MIT 许可证开源。
• src/main/resources/data/gua_texts.json 内附 64 卦卦爻辞、解卦等静态文本， 其版权归 不惑之心 所有，随库附带方便调用，但 不以 MIT 开源， 不得用于另行出版、售卖或二次分发。
• 诸葛神算、观音灵签、81 数理等解读服务，请访问 不惑之心。

许可证

MIT

Copyright (c) 2026 不惑之心