# studyapp

**Repository Path**: weedd/studyapp

## Basic Information

- **Project Name**: studyapp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 华夏历史文化宝库

一款基于 HarmonyOS 的中华传统文化综合学习平台，融合历史知识、传统科学、文化探索、互动答题等多维度功能，致力于传承和弘扬中华优秀传统文化。

## 项目简介

本项目是一个全方位的传统文化学习应用，通过互动式答题、知识学习、传统工具模拟、文化探索等多种形式，帮助用户深入了解中国历史、传统科学、民俗文化等内容。应用采用现代化的界面设计和组件化架构，为用户提供流畅的学习体验。

## 技术栈

- 开发平台: HarmonyOS
- 开发语言: ArkTS
- 最低 API 版本: API 12
- 架构模式: 组件化开发、模块化数据管理
- 界面设计: 响应式布局、深色主题、毛玻璃效果

## 核心功能

### 一、首页模块

首页展示核心的传统文化学习功能：

- 八字排盘与命理分析
- 快捷访问常用功能
- 个性化推荐内容

### 二、工具模块

#### 2.1 历史科学工具

展示中国古代科学技术成就的模拟工具：

**时间测量工具**
- 日晷: 古代太阳时计模拟器
- 刻漏: 传统漏壶计时器
- 圭表: 古代天文测量仪器

**导航定位工具**
- 司南: 中国古代指南针
- 罗盘: 传统风水罗盘工具

**天文观测**
- 地动仪: 张衡地动仪模拟展示

**计算工具**
- 算盘模拟器: 可交互的珠算工具
- 算筹: 古代计算器具演示

**测量工具**
- 鲁班尺: 传统建筑测量工具
- 度量衡转换: 古今度量单位换算

**哲学工具**
- 太极图: 阴阳哲学可视化
- 五行图: 五行相生相克展示
- 河图洛书: 传统数理图示

**传统艺术**
- 活字印刷: 活字印刷术互动体验
- 水墨画板: 传统水墨画创作工具

#### 2.2 历史文化工具

**历法与节气**
- 万年历: 公历农历互转、黄历宜忌查询
- 节气轮盘: 二十四节气可视化展示
- 藏历查询: 藏族传统历法
- 儒略日计算: 天文学日期换算
- 干支计算器: 天干地支纪年计算

**时间相关**
- 时辰转换器: 现代时间与古代时辰对照
- 时间戳工具: Unix 时间戳转换
- 倒计时工具: 重要日期倒计时提醒
- 计时器: 精确计时功能

**节日与物候**
- 法定节假日查询: 当年节假日安排
- 三伏天计算: 夏季三伏天日期
- 梅雨天查询: 江南梅雨季节时间
- 物候查询: 二十四节气七十二候
- 小寒查询: 节气详细信息

**传统命理**
- 八字排盘: 生辰八字分析
- 择吉日: 黄道吉日查询
- 月相查询: 月球盈亏变化
- 星座运势: 十二星座分析
- 九星排盘: 九星风水布局
- 六星查询: 六星命理分析

**实用工具**
- 古风名字生成器: 基于诗经楚辞的取名工具
- 随机生成器: 多用途随机工具
- 计算器: 科学计算功能
- 取色器: 颜色选择工具

#### 2.3 程序员工具

**文本处理**
- 繁简转换器: 简体繁体互转
- 拼音转换: 汉字转拼音标注
- 文本处理器: 文本格式化工具
- JSON 格式化: JSON 数据美化
- Base64 编解码: Base64 加解密
- URL 编解码: URL 转义处理

**数据工具**
- Hash 计算器: MD5/SHA 哈希计算
- UUID 生成器: 唯一标识符生成
- 进制转换器: 多进制数值转换
- 颜色工具: RGB/HEX 颜色转换
- 二维码生成器: 文本转二维码

### 三、答题模块

趣味互动答题挑战系统：

**核心挑战**
- 猜皇帝: 根据历史线索推断皇帝身份，包含中国历史上重要帝王
- 猜民族: 学习中国 56 个民族的文化特色
- 猜节气: 了解二十四节气的由来和习俗
- 每日一练: 每日更新的历史知识问答

**特色功能**
- 历史上的今天: 回顾历史事件
- 每日一词: 传统文化词汇学习
- 智能提示系统: 答错后逐步提供线索
- 答题记录: 自动保存答题进度

### 四、学习模块

系统化的历史文化知识库：

#### 4.1 皇帝知识
- 按朝代分类: 秦、汉、唐、宋、元、明、清等历代帝王
- 详细资料: 包含姓名、谥号、在位时间、历史功绩
- 重要人物: 秦始皇、汉高祖、唐太宗、武则天、康熙、乾隆等

#### 4.2 朝代历史
- 朝代时间线: 中国历朝历代完整时间轴
- 朝代详情: 各朝代的建立、发展、灭亡过程
- 历史地图: 各朝代疆域版图展示

#### 4.3 民族文化
- 56 个民族: 完整的民族信息库
- 民族特色: 服饰、语言、习俗、节日介绍
- 分布地区: 各民族主要聚居地

#### 4.4 节气知识
- 二十四节气: 完整的节气系统
- 按季节分类: 春夏秋冬四季节气
- 节气习俗: 传统习俗和农事活动
- 物候变化: 七十二候详细说明

#### 4.5 其他学习内容
- 历史故事: 按时期和主题分类的历史典故
- 诗词歌赋: 按朝代、诗人、主题分类
- 成语典故: 按主题分类的成语学习
- 历史人物: 按类别分类的历史名人
- 历史事件: 按时期分类的重大事件
- 文物鉴赏: 按朝代和类别分类的文物介绍
- 古籍文献: 按类型分类的古代典籍
- 文化成就: 各领域文化成就展示

### 五、探索模块

#### 5.1 去哪玩
- 记里鼓车: 古代里程计模拟
- 旅行探索: 历史文化景点推荐

#### 5.2 图鉴系统
完整的收藏展示系统，记录学习成果：

- 皇帝图鉴: 展示已答对的皇帝及详细信息
- 民族图鉴: 展示已学习的民族知识
- 节气图鉴: 展示已掌握的节气内容
- 进度统计: 学习完成度可视化

#### 5.3 打卡功能
- 每日打卡: 养成学习习惯
- 打卡日历: 可视化打卡记录
- 连续打卡统计: 激励持续学习

#### 5.4 随手拍
- 相机拍照: 记录文化景观
- 照片画廊: 照片管理和浏览
- 添加感想: 为照片添加文字记录
- 照片预览: 支持缩放和详细查看
- 数据管理: 照片和感想的本地存储

#### 5.5 诗词格律检测
- 格律分析: 检测诗词平仄韵律
- 拼音标注: 自动标注汉字拼音
- 格律规则: 学习诗词创作规范

### 六、个人中心

- 学习统计: 答题进度和完成度展示
- 数据管理: 清空学习记录功能
- 应用信息: 版本信息和文化理念
- 用户设置: 个性化配置选项

## 数据管理

### 本地存储
- UserProgressManager: 管理猜皇帝答题数据
- UserNationalityProgressManager: 管理猜民族答题数据
- UserSolarTermProgressManager: 管理猜节气答题数据
- CheckInDataManager: 管理打卡记录数据
- SnapShotDataManager: 管理随手拍照片和感想数据

### 数据库内容
- 皇帝数据库: 涵盖秦始皇至宣统帝等重要帝王
- 朝代数据库: 完整的中国历朝历代信息
- 民族数据库: 56 个民族的详细资料
- 节气数据库: 二十四节气及七十二候
- 诗词数据库: 按朝代分类的诗词作品
- 成语数据库: 按主题分类的成语典故
- 历史故事库: 按时期分类的历史故事
- 文物数据库: 按朝代分类的文物信息
- 人物数据库: 历史名人资料
- 事件数据库: 重大历史事件记录

## 设计特色

### 界面设计
- 深色主题: 深紫黑色渐变背景，护眼舒适
- 毛玻璃效果: 现代化的卡片设计
- 胶囊式导航: 圆润的 Tab 导航设计
- 响应式布局: 适配不同屏幕尺寸
- 流畅动画: 200ms 过渡动画

### 交互设计
- 自动滚动居中: Tab 切换时自动定位
- 渐进式提示: 答题时逐步显示线索
- 数据自动刷新: 答题后实时更新图鉴
- 长按操作: 照片长按分享和删除
- 手势支持: 支持缩放、拖拽等手势

### 用户体验
- 知识导向: 注重历史文化知识传播
- 寓教于乐: 通过游戏化方式学习
- 成就激励: 图鉴收集激发学习兴趣
- 数据持久化: 学习进度自动保存
- 安全区域适配: 完美适配刘海屏等设备

## 权限说明

应用需要以下权限：

- ohos.permission.CAMERA: 用于随手拍功能，拍摄文化景观照片

## 项目结构

```
myhis/
├── entry/src/main/
│   ├── ets/
│   │   ├── entryability/          # 应用入口
│   │   ├── pages/                 # 页面组件
│   │   │   ├── Index.ets          # 主页面（导航和 Tab 管理）
│   │   │   ├── GuessEmperorTab.ets    # 首页
│   │   │   ├── ToolsTab.ets       # 工具模块
│   │   │   ├── QuizTab.ets        # 答题模块
│   │   │   ├── LearnTab.ets       # 学习模块
│   │   │   ├── ExploreTab.ets     # 探索模块
│   │   │   ├── ProfileTab.ets     # 个人中心
│   │   │   └── ...                # 各功能详情页面
│   │   └── data/                  # 数据层
│   │       ├── EmperorData.ets    # 皇帝数据库
│   │       ├── DynastyData.ets    # 朝代数据库
│   │       ├── NationalityData.ets # 民族数据库
│   │       ├── SolarTermData.ets  # 节气数据库
│   │       ├── UserData.ets       # 用户进度管理
│   │       ├── CheckInData.ets    # 打卡数据管理
│   │       └── SnapShotData.ets   # 随手拍数据管理
│   └── resources/                 # 资源文件
├── build-profile.json5            # 构建配置
└── README.md                      # 项目说明
```

## 开发指南

### 环境要求
- DevEco Studio: 最新版本
- HarmonyOS SDK: API 12 或更高
- Node.js: 建议 LTS 版本

### 运行项目
1. 使用 DevEco Studio 打开项目
2. 配置 HarmonyOS 模拟器或连接真机
3. 点击运行按钮启动应用

### 构建发布
1. 修改 build-profile.json5 中的版本号
2. 配置签名证书
3. 执行 Build -> Build Hap(s)/APP(s)
4. 生成的安装包位于 build/outputs/ 目录

## 教育价值

本应用通过多元化的学习方式，帮助用户：

1. 系统了解中国历史朝代和重要帝王
2. 学习中华民族多元文化特色
3. 掌握二十四节气及传统习俗
4. 体验中国古代科学技术成就
5. 培养对中华历史文化的兴趣
6. 传承和弘扬优秀传统文化

## 开源协议

本项目采用开源协议发布，欢迎学习和交流。

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

- Issue: 在 GitHub 仓库提交问题
- Email: 通过项目主页联系作者

## 致谢

感谢所有为中华传统文化传承做出贡献的学者和开发者。

---

传承历史文化，启发智慧人生