于是有了 meihua-yi ( https://github.com/handsomejustin/meihua-yi)。
装好就能用
pip install meihua-yi
装完直接在终端起卦:
# 铜钱起卦,每次结果不同
meihua -q "这个项目能成吗" -m coin
# 时间起卦,同一时辰结果一样
meihua -q "今天适合上线吗"
输出是这样的:
================ 起卦结果 ================
[主卦] [互卦] [变卦]
上卦: 乾(金) ☰ 上卦: 巽(木) ☴ 上卦: 乾(金) ☰
下卦: 坎(水) ☵ 下卦: 离(火) ☲ 下卦: 巽(木) ☴
第 6 爻: ▅▅▅▅▅ ▅▅▅▅▅ ▅▅▅▅▅
第 5 爻: ▅▅▅▅▅ ▅▅ ▅▅ ▅▅▅▅▅
第 4 爻: ▅▅ ▅▅ (动) ▅▅▅▅▅ ▅▅▅▅▅
...
主卦名: 天水讼
体卦: 乾(金)
用卦: 坎(水)
关系: 体生用(泄气) → 不利
主卦、互卦、变卦、体用关系、五行生克,一步到位。
两种起卦法
时间起卦,用的是梅花易数那套年月日时取数的算法。同一个时辰内结果固定,装了 lunardate 会自动转农历算。
铜钱起卦,模拟 3 枚硬币抛 6 次的过程,每次结果随机。如果觉得随机不够有仪式感,也可以手动指定每次投掷的数字:
meihua -q "财运" -m coin --coins "6,7,8,9,7,6"
接上 LLM 就能解卦
起卦只是算数,解卦才见功夫。format_hexagram_text() 输出的格式是专门为 LLM prompt 设计的:
from meihua_yi import qigua_coin, format_hexagram_text
lines, moving, _ = qigua_coin()
text = format_hexagram_text(lines, moving)
# 把 text 塞进 system prompt ,发给任何 LLM 就行
项目里附了一个完整的 LLM 解卦示例( examples/llm_decode.py ),对接的是 OpenAI 兼容接口,本地跑 Ollama 或者用云端 API 都行。铜钱起完卦,卦象文本自动拼进 prompt ,LLM
流式输出解卦结果,从主卦含义到体用生克到动爻爻辞,一路讲下来。
export LLM_URL="http://localhost:8888/v1/chat/completions"
python examples/llm_decode.py -q "该不该换工作"
作为 Python 库用
不需要 CLI ,纯当库调用也没问题:
from meihua_yi import qigua_coin, compute_hexagrams, analyze_ti_yong
lines, moving, _ = qigua_coin()
result = compute_hexagrams(lines, moving)
rel, fortune = analyze_ti_yong(result["ti"]["element"], result["yong"]["element"])
print(f"{rel} → {fortune}")
# 用生体(得助) → 大吉
零网络请求,零外部依赖( lunardate 可选),纯算法计算。64 卦全名表内置,体用五行生克判断内置,拿来做什么都行:做成 Telegram Bot 、接进 Home Assistant 、写个 Web 服务,随便折腾。
JSON 模式方便二次开发
meihua --json -q "项目能成吗" -m coin
输出标准 JSON ,主卦互卦变卦的上下卦五行、动爻位置、体用关系全在里面,拿去写前端或者做数据 pipeline 都很方便。
========================================
在 Agent 里直接用
项目里内置了三套技能文件,Claude Code 、Hermes Agent 、OpenClaw 三个平台都能直接识别。Agent 看到"起卦"、"算卦"这类关键词会自动调用,起完卦自己解。
Claude Code ,把技能文件复制到你的项目目录:
cp skills/claude-code/CLAUDE.md your-project/
然后在项目里跟 Claude 说"帮我起一卦,看看这个项目能不能成"就行。
Hermes Agent ,放到技能目录:
cp -r skills/hermes ~/.hermes/skills/meihua-yi/
OpenClaw ,按平台的 skill 目录规则放置 skills/openclaw/SKILL.md 。
前提是环境里装了 pip install meihua-yi ,Agent 会自己跑 python -m meihua_yi.cli --json --method coin ,拿到 JSON
后按体用五行生克的框架解卦,从主卦含义、互卦过程、变卦走向到动爻解读,一路给结论。不需要额外配置 API ,Agent 自己就能解。
===================================
---
项目地址: https://github.com/handsomejustin/meihua-yi
pip install meihua-yi 就能用。如果你也喜欢折腾这些传统数术和代码的交叉地带,欢迎来 GitHub 点个 Star ,有什么想法也可以提 issue 一起聊。