最近在折腾梅花易数，发现网上起卦工具要么是网页版广告满天飞，要么是手机 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 一起聊。