# mhys_uniapp

**Repository Path**: zed058/mhys_uniapp

## Basic Information

- **Project Name**: mhys_uniapp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-26
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 合一个 - uni-app版本

基于传统智慧的现代解读，占卜小程序应用。

## 项目概述

本项目是将原Flutter版本的"合一个"应用重构为uni-app版本，实现跨平台小程序开发。保持了原有的所有功能和UI设计风格。

## 功能特性

### 🎯 核心功能
- **四种起卦方式**
  - 🎤 语音起卦：基于语音内容生成卦象
  - 📸 拍照起卦：通过图片信息起卦
  - ⏰ 时间起卦：根据特定时间生成卦象
  - 🔢 数字起卦：使用数字组合起卦

### 📱 主要页面
- **首页**：起卦入口和今日卦签
- **占卜结果页**：显示卦象和简要解读
- **卦象详情页**：完整的卦象解读和建议
- **卦辞页面**：六十四卦的完整列表
- **解析页面**：功能扩展和占卜记录
- **个人中心**：用户信息和设置

### 🎨 设计特色
- 渐变背景设计，营造神秘氛围
- 传统易经符号与现代UI结合
- 响应式布局，适配不同设备
- 流畅的动画过渡效果

## 技术架构

### 前端框架
- **uni-app**：跨平台开发框架
- **Vue 3**：渐进式JavaScript框架
- **SCSS**：CSS预处理器

### 项目结构
```
mhys_uniapp/
├── components/          # 通用组件
│   ├── app-card/       # 卡片组件
│   ├── app-button/     # 按钮组件
│   ├── custom-navbar/  # 自定义导航栏
│   ├── divination-card/ # 起卦卡片
│   └── gradient-background/ # 渐变背景
├── pages/              # 页面文件
│   ├── index/          # 首页
│   ├── voice-divination/ # 语音起卦
│   ├── photo-divination/ # 拍照起卦
│   ├── time-divination/  # 时间起卦
│   ├── number-divination/ # 数字起卦
│   ├── divination-result/ # 占卜结果
│   ├── hexagram-detail/   # 卦象详情
│   ├── hexagram-texts/    # 卦辞页面
│   ├── analysis/          # 解析页面
│   └── profile/           # 个人中心
├── static/             # 静态资源
│   ├── css/           # 样式文件
│   └── icons/         # 图标资源
├── utils/             # 工具类
│   ├── hexagram.js    # 卦象数据模型
│   └── hexagram-service.js # 卦象服务类
├── App.vue            # 应用主组件
├── main.js            # 应用入口
├── pages.json         # 页面配置
├── manifest.json      # 应用配置
└── uni.scss          # 全局样式
```

## 开发指南

### 环境要求
- HBuilderX 或 VS Code + uni-app插件
- Node.js (推荐14.x或更高版本)
- 微信开发者工具（用于小程序调试）

### 安装依赖
```bash
npm install
```

### 开发运行
```bash
# 微信小程序
npm run dev:mp-weixin

# H5
npm run dev:h5

# APP
npm run dev:app-plus
```

### 打包构建
```bash
# 微信小程序
npm run build:mp-weixin

# H5
npm run build:h5

# APP
npm run build:app-plus
```

## 核心算法

### 卦象生成算法
项目实现了多种起卦方式：

1. **时间起卦**：基于时间的小时、分钟、秒数生成种子
2. **数字起卦**：用户选择的两个数字映射到八卦
3. **文本起卦**：基于文本内容的哈希值生成
4. **图片起卦**：基于图片路径信息生成

### 五行相生相克
实现了完整的五行理论：
- 金生水，水生木，木生火，火生土，土生金
- 金克木，木克土，土克水，水克火，火克金

## 数据存储

### 本地存储
- 使用uni-app的本地存储API
- 占卜记录自动保存
- 支持数据导出和备份

### 存储结构
```javascript
// 占卜记录
{
  hexagram: {
    name: "乾为天",
    upperSymbol: "☰",
    lowerSymbol: "☰",
    description: "天行健，君子以自强不息",
    upperElement: "金",
    lowerElement: "金"
  },
  timestamp: 1640995200000,
  timeStr: "2021/12/31 20:00:00"
}
```

## 部署说明

### 微信小程序
1. 在微信开发者工具中导入项目
2. 配置AppID和相关权限
3. 提交审核上线

### H5版本
1. 执行构建命令生成dist目录
2. 将dist目录部署到Web服务器
3. 配置域名和HTTPS

### APP版本
1. 使用HBuilderX云打包
2. 配置应用图标和启动图
3. 生成安装包

## 功能扩展

### 计划功能
- [ ] 用户账号系统
- [ ] 社区分享功能
- [ ] 专家在线解读
- [ ] 占卜统计分析
- [ ] 多语言支持
- [ ] 主题切换

### API接口
预留了扩展接口：
- 用户认证API
- 卦象数据API
- 社区功能API
- 推送通知API

## 注意事项

### 开发注意
1. 严格遵循uni-app开发规范
2. 测试多平台兼容性
3. 注意小程序包大小限制
4. 遵循各平台审核要求

### 性能优化
1. 图片资源压缩
2. 代码分包加载
3. 组件懒加载
4. 缓存优化

## 版本历史

### v1.0.0 (2025-08-26)
- ✅ 完成uni-app版本重构
- ✅ 实现所有核心功能
- ✅ 保持UI设计一致性
- ✅ 添加本地存储功能

## 贡献指南

1. Fork项目
2. 创建功能分支
3. 提交代码变更
4. 发起Pull Request

## 许可证

MIT License

## 联系方式

- 项目维护：开发团队
- 邮箱：support@mhys.com
- 技术支持：技术团队# 合一个 - uni-app版本