🔮 周易占卜 - ZhouYi Divination

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

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

📖 核心功能

| 模块 | 功能说明 |

|------|----------|

| ① 铜钱起卦 | 传统三枚铜钱摇卦法，模拟古代占卜仪式 |

| ② 64 卦查询 | 完整卦名、卦辞、大象、爻辞数据库 |

| ③ 本卦/变卦 | 自动识别动爻（老阴×、老阳○）并生成变卦 |

| ④ 八字排盘 | 四柱（年月日时）干支自动计算 |

| ⑤ 五行分析 | 五行分布统计、日主强弱判断 |

| ⑥ 用神推断 | 根据身强身弱推荐用神 |

| ⑦ 大运推演 | 每十年一大运，推算当前大运 |

| ⑧ 综合解读 | 八字背景 + 卦象 + 问题关键词的智能分析 |

🎯 快速开始

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

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

输出包含：

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

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

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

输出包含：

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

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

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

方式四：JSON 格式输出

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

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

方式五：交互模式

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 格式输出 | 可选 |

📊 输出示例

纯起卦输出

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

👶 出生信息：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 🌸