🔮 周易占卜 - ZhouYi Divination#

基于《周易》的完整占卜系统，支持铜钱法起卦、八字排盘、五行分析、大运推演，以及卦象与命理的综合解读。

纯 Python 实现，无外部依赖，安全本地运行。

---

📖 核心功能#

模块功能说明① 铜钱起卦传统三枚铜钱摇卦法，模拟古代占卜仪式② 64 卦查询完整卦名、卦辞、大象、爻辞数据库③ 本卦/变卦自动识别动爻（老阴×、老阳○）并生成变卦④ 八字排盘四柱（年月日时）干支自动计算⑤ 五行分析五行分布统计、日主强弱判断⑥ 用神推断根据身强身弱推荐用神⑦ 大运推演每十年一大运，推算当前大运⑧ 综合解读八字背景 + 卦象 + 问题关键词的智能分析

---

🎯 快速开始#

方式一：纯起卦（最简单）#

bash

python scripts/divine.py --question "我今年的事业运势如何？"

输出包含：

• 六爻起卦过程
• 本卦 + 变卦信息
• 卦辞解读
• Oracle 寄语

---

方式二：八字 + 起卦综合解读（推荐）#

bash

python scripts/divine.py ^
  --question "今年适合创业吗？" ^
  --birth-year 1990 ^
  --birth-month 5 ^
  --birth-day 15 ^
  --birth-hour 14 ^
  --gender 男

输出包含：

• ✅ 完整八字排盘
• ✅ 五行分布图
• ✅ 日主强弱分析
• ✅ 用神建议
• ✅ 当前大运
• ✅ 卦象 + 八字综合解读

---

方式三：只排八字（不占卦）#

bash

python scripts/divine.py --mode bazi ^
  --birth-year 1990 ^
  --birth-month 5 ^
  --birth-day 15 ^
  --birth-hour 14

---

方式四：JSON 格式输出#

bash

python scripts/divine.py --question "问题" --json

适合编程调用或保存结果。

---

方式五：交互模式#

bash

python scripts/divine.py

按屏幕提示选择模式，逐步操作。

---

📋 参数说明#

参数简称说明必填--question``-q你想问的问题否--birth-year-出生年份可选--birth-month-出生月份 (1-12)可选--birth-day-出生日期 (1-31)可选--birth-hour-出生时辰 (0-23)可选--gender-性别 (男/女)可选，默认"男"--mode-模式 (hexagram/bazi/both)可选，默认"both"--json-JSON 格式输出可选

---

📊 输出示例#

纯起卦输出#

text

==================================================
📜 八字排盘报告
==================================================

👶 出生信息：1990 年 5 月 15 日 14:00

🔮 四柱八字:
   年柱：庚午
   月柱：丙午
   日柱：丁酉 ← 日主
   时柱：丁未

⚖️  五行分布:
   金：██ (2)
   木：  (0)
   水：  (0)
   火：█████ (5)
   土：█ (1)

💎 日主分析:
   日元：丁 (火)
   强弱指数：5/8
   状态：🟢 身强
   建议用神：土，金，水

...

═══════════════ 🎯 本卦信息 ═══════════════
   卦名：山地剥 (第 23 卦)
   卦象：上艮下坤
   卦辞：不利有攸往

...

💭 Oracle 寄语:
您的八字显示'丁'日主身强，精力充沛。当前山地剥提醒您 '不利有攸往'。
建议发挥优势但注意收敛锋芒，配合流年运势把握机遇。

---

📚 哲学参考#

本工具参考以下经典：

• 《周易·系辞传》
• 《周易正义》（孔颖达）
• 《朱子本义》
• 《三命通会》
• 《渊海子平》

---

⚠️ 安全说明#

• ✅ 纯本地运行：无任何外部 API 调用
• ✅ 开源代码：所有逻辑透明可见
• ✅ 无敏感权限：不访问网络、不读写敏感文件
• ✅ 数据保密：所有个人信息仅在内存中处理

---

💡 温馨提示#

《周易》的核心是" 观其德义"，不是单纯的算命。

" 善为易者不占" — 真正懂易经的人，重视的是其中的人生智慧，而不是依赖占卜结果。

本工具仅供学习和娱乐，最终决策请结合自身实际情况～ 💕

---

🛠️ 技术栈#

项目内容语言Python 3.8+依赖无第三方库平台Windows / Linux / macOS编码UTF-8

---

Created by 小艺 · 公司办公室行政 AI 🌸