[分享创造] 用 Python 三行代码起一卦,还能让 Hermes 帮你解卦?

最近在折腾梅花易数,发现网上起卦工具要么是网页版广告满天飞,要么是手机 app 动不动就要付费解锁。作为一个写了多年 Python 的人,想着这玩意儿不就是几组数字映射吗,干脆自己撸一个。 于是有了 meihua-yi ( https://github.com/handsomejustin/meih...
[分享创造] 用 Python 三行代码起一卦,还能让 Hermes 帮你解卦?
[分享创造] 用 Python 三行代码起一卦,还能让 Hermes 帮你解卦?


于是有了 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 一起聊。
来源: v2ex查看原文