最近在折腾梅花易数，发现网上起卦工具要么是网页版广告满天飞，要么是手机 app 动不动就要付费解锁。作为一个写了多年 Python 的人，想着这玩意儿不就是几组数字映射吗，干脆自己撸一个。

于是有了 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 一起聊。