# Python卦象模拟器

**Repository Path**: flulife/python-hexagram-simulator

## Basic Information

- **Project Name**: Python卦象模拟器
- **Description**: Python卦象模拟器：基于Python的易经卦象生成工具，提供多种占卜方法和解析功能，适用于学习和研究易经文化。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-16
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python易经卦象模拟器

一个基于Python的专业易经卦象生成与解析工具，提供传统金钱卦占卜体验和完整的易经学习功能。

## 功能特点

- ✨ **专业的金钱卦起卦**：完全模拟传统三枚硬币起卦方法，支持标准和详细两种起卦模式
- 🎨 **美观的彩色界面**：使用colorama库实现丰富的色彩输出和视觉效果
- 📊 **卦象可视化**：直观展示卦象结构、动爻位置和变化过程
- 📚 **完整的易经数据**：包含六十四卦的卦名、卦象、卦辞、爻辞、象传、彖传等完整信息
- 💡 **详细的使用帮助**：提供易经基础知识、起卦方法和卦象解读指南
- ⚡ **动态投掷效果**：模拟硬币投掷的动画过程，增强沉浸感和仪式感
- 🔍 **高级数据查询**：支持按卦名、卦象代码和关键词搜索易经内容
- 📱 **友好的用户交互**：简洁明了的命令行界面，支持多种操作模式
- 🏗️ **模块化设计**：采用面向对象的模块化设计，便于扩展和维护

## 安装说明

### 1. 克隆仓库

```bash
https://gitee.com/flulife/python-hexagram-simulator.git
cd python-hexagram-simulator
```

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

## 使用方法

运行主程序：

```bash
python main.py
```

### 基本操作

- 输入任意键：开始起卦
- 输入`h`：查看帮助信息
- 输入`q`：退出程序

## 项目结构

```
python-hexagram-simulator/
├── main.py              # 主程序入口，处理用户交互和界面显示
├── gua_simulator.py     # 卦象生成核心类，提供GuaGenerator类实现卦象生成
├── gua.py               # 简单卦象生成模块，提供基础的卦象生成功能
├── yijing_data.py       # 易经数据管理类，提供完整的六十四卦数据和查询功能
├── requirements.txt     # 项目依赖声明
├── README.md            # 项目说明文档
└── LICENSE              # 开源许可证
```

## 核心类和功能

### GuaGenerator 类
提供专业的卦象生成功能，支持多种起卦方式和动画效果展示。

### YijingData 类
管理六十四卦的完整数据，提供卦象查询、搜索和解释功能。

### SimpleGuaGenerator 类
提供基础的卦象生成功能，是gua.py中的主要类。

## 使用示例

### 基础起卦
运行程序后，直接按回车键开始快速起卦：

```bash
python main.py
# 然后按回车键
```

### 高级模式
显示详细的起卦过程和动画效果：

```bash
python main.py
a
# 然后按照提示操作
```

### 查看帮助
了解易经基础知识和起卦方法：

```bash
python main.py
h
```

## 技术说明

### 卦象生成原理

本程序基于传统金钱卦的起卦方法，通过模拟三枚硬币的投掷来生成六爻卦象：

- 三个正面：老阴（6）
- 两个正面：少阳（7）
- 一个正面：少阴（8）
- 没有正面：老阳（9）

其中，老阴（6）和老阳（9）为动爻，会在变卦中发生变化。

### 开发环境

- Python 3.6+  
- numpy >= 1.21.0  
- colorama >= 0.4.4

## 扩展开发

如果你想扩展本项目，可以考虑以下方向：

1. 添加更多的起卦方法（如时间起卦、数字起卦等）
2. 完善易经的解释内容
3. 开发图形用户界面（GUI）
4. 添加历史记录功能

## 致谢

感谢所有对本项目提供帮助的朋友！

## 版权信息

本项目仅供学习和研究使用，请勿用于商业用途。

© 2025 Python卦象模拟器团队