# shuShi

**Repository Path**: silence-szn/shuShi

## Basic Information

- **Project Name**: shuShi
- **Description**: 顺时是一个基于鸿蒙系统开发的个人命盘应用，围绕"个人命盘"提供每日时运、命盘展示、命理知识学习、个人管理与交互咨询的功能。
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-01
- **Last Updated**: 2025-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 顺时 - 个人命盘应用

## 项目简介

顺时是一个基于鸿蒙系统开发的个人命盘应用，围绕"个人命盘"提供每日时运、命盘展示、命理知识学习、个人管理与交互咨询的功能。

## 主要功能

### 🔮 时运页（今日运势）
- **概览模块**：展示今日评分、简短判断、当天干支信息和今日十神
- **指南模块**：提供穿衣、饮食、出行、健康四类日常建议
- **宜忌模块**：列出适宜与不宜的事项
- **幸运信息**：显示今日幸运色与幸运方位
- **时辰运势**：时间轴展示各时段的干支、十神、吉凶状态

### 📊 命盘页（我的命盘）
- **个人信息横幅**：显示昵称、生日、乾造/坤造标识
- **四柱展示**：年月日时四柱的天干地支、藏干与五行
- **分析概览**：日主、旺衰、五行分布、喜用忌神等核心结论

### 📚 顺时学堂页
- **搜索与筛选**：支持关键字搜索知识内容
- **新手必读**：入门内容推荐
- **知识分类**：五行、天干、地支、十神等分类入口
- **推荐内容**：精选命理知识文章

### 👤 我的页（个人中心）
- **命盘概要**：头像、昵称、出生信息展示
- **命盘管理**：多命盘管理，支持切换和添加
- **设置与功能**：推送设置、收藏、反馈等功能

### 💬 对话页（顺时对话）
- **智能对话**：AI助手提供命理咨询
- **择时建议**：根据命盘推荐最佳时段
- **运势分析**：个性化运势解读
- **生活指导**：结合命理的实用建议

## 技术特点

### 架构设计
- **MVVM架构**：使用鸿蒙ArkTS框架的状态管理
- **组件化开发**：可复用的UI组件库
- **模块化设计**：清晰的代码结构和职责分离

### 用户体验
- **卡片化布局**：统一的视觉风格
- **响应式设计**：适配不同屏幕尺寸
- **流畅动画**：自然的页面切换和状态变化
- **无障碍支持**：考虑可访问性设计

### 数据处理
- **状态管理**：全局应用状态管理
- **数据持久化**：本地存储用户数据
- **错误处理**：完善的异常处理机制
- **降级显示**：数据缺失时的友好提示

## 项目结构

```
entry/src/main/ets/
├── components/          # 通用组件
│   ├── CommonCard.ets      # 卡片组件
│   ├── TopNavigation.ets   # 顶部导航
│   ├── BottomNavigation.ets # 底部导航
│   └── CreateChartDialog.ets # 创建命盘弹窗
├── model/              # 数据模型
│   └── DataTypes.ets       # 类型定义
├── pages/              # 页面组件
│   ├── Index.ets           # 主页面
│   ├── FortunePage.ets     # 时运页
│   ├── ChartPage.ets       # 命盘页
│   ├── KnowledgePage.ets   # 学堂页
│   ├── ProfilePage.ets     # 我的页
│   └── ChatPage.ets        # 对话页
├── store/              # 状态管理
│   └── AppStore.ets        # 应用状态
└── utils/              # 工具类
    └── MockDataService.ets # 模拟数据服务
```

## 开发环境

- **开发工具**：DevEco Studio
- **框架版本**：HarmonyOS NEXT
- **编程语言**：ArkTS
- **最低API版本**：API 12

## 安装运行

1. 使用DevEco Studio打开项目
2. 配置鸿蒙开发环境
3. 连接鸿蒙设备或启动模拟器
4. 点击运行按钮编译安装

## 功能演示

### 首次使用
1. 打开应用后会提示创建命盘
2. 填写个人信息（昵称、性别、出生日期等）
3. 创建成功后自动跳转到时运页

### 日常使用
1. **查看运势**：在时运页查看今日运势和建议
2. **了解命盘**：在命盘页查看个人八字信息
3. **学习知识**：在学堂页浏览命理知识
4. **管理设置**：在我的页管理命盘和设置
5. **智能咨询**：在对话页与AI助手交流

## 设计理念

### 用户友好
- 面向非专业用户设计，避免过度术语化
- 提供清晰的引导和帮助信息
- 支持多命盘管理，满足家庭使用需求

### 视觉统一
- 采用统一的卡片风格和色彩体系
- 重要信息突出显示，辅助信息简洁
- 吉凶状态使用统一的颜色标识

### 体验流畅
- 页面切换动画自然流畅
- 加载状态和错误提示明确
- 支持离线使用和数据缓存

## 未来规划

- [ ] 接入真实的命理计算API
- [ ] 增加更多个性化设置选项
- [ ] 支持社区分享和交流功能
- [ ] 添加更多命理知识内容
- [ ] 优化AI对话的准确性和实用性

## 贡献指南

欢迎提交Issue和Pull Request来改进这个项目。在贡献代码前，请确保：

1. 代码符合项目的编码规范
2. 添加必要的注释和文档
3. 测试功能的完整性和稳定性

## 许可证

本项目采用MIT许可证，详见LICENSE文件。

---

**注意**：本应用仅供娱乐和学习使用，不构成任何形式的人生指导建议。请理性对待命理内容，以科学的态度面对生活。