bushi4py

卜筮 — Python 六爻 / 梅花易数排盘引擎，基于 lunar-python。

功能

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

安装

pip install bushi4py

快速上手

from datetime import datetime
from bushi4py import build_context, liu_yao_shi_jian_qi_gua, mei_hua_shi_jian_qi_gua
from bushi4py.gua_texts import get_gua_texts

ctx = build_context(datetime(2026, 4, 30, 10, 0))

# 六爻时间起卦
r = liu_yao_shi_jian_qi_gua(ctx)
print(r.ben_gua.name)       # 地水师
print(r.bian_gua.name)      # 山水蒙
print(r.ben_gua_ex.liu_qin) # 父兄官财官子

# 梅花时间起卦
mh = mei_hua_shi_jian_qi_gua(ctx)
print(mh.ben_gua.name)

# 卦爻辞与解卦
texts = get_gua_texts("乾为天")
print(texts.yao_ci)  # 卦辞 + 爻辞
print(texts.jie_xi)  # 解卦解析

起卦方式

方式	六爻	梅花
时间起卦	liu_yao_shi_jian_qi_gua	mei_hua_shi_jian_qi_gua
数字起卦	liu_yao_shu_zi_qi_gua	mei_hua_shu_zi_qi_gua
随机起卦	liu_yao_sui_ji_qi_gua	mei_hua_sui_ji_qi_gua
手摇起卦	liu_yao_shou_yao_qi_gua	mei_hua_shou_yao_qi_gua

排盘结果

PaipanResult 包含：

• ben_gua / hu_gua / bian_gua：本卦、互卦、变卦（卦名 + 六爻阴阳）
• ben_gua_ex / bian_gua_ex：纳甲装卦（地支干支、六亲、世应、伏藏、卦身、八宫、五行、类型）
• liu_shen：六神（根据日干排列）
• gan_zhi：四柱干支、xun_kong：旬空
• bian_yao：动爻位置

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

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

语义	上爻（六爻）	五爻	四爻	三爻	二爻	初爻
数组索引	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=官酉金

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

卦爻辞与解卦

texts = get_gua_texts('乾为天')
print(texts.yao_ci)  # 卦辞 + 爻辞
print(texts.jie_xi)  # 解卦解析

多语言版本

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

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

---

关于不惑之心

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

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

开源说明

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

许可证

MIT

Copyright (c) 2026 不惑之心