# 摸摸鱼

**Repository Path**: oo-dashuailiu/touch-the-fish

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-05-26
- **Last Updated**: 2025-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 摸摸鱼·HarmonyOS 应用

## 项目简介

本项目是一款基于 HarmonyOS NEXT（ArkTS）开发的多功能效率与娱乐应用，集成了 AI 聊天助手、任务管理、番茄钟计时、二楼动画、MQTT 通信、邮箱注册登录等多种实用与趣味功能，适合日常学习、工作与生活场景。项目结构规范，支持本地数据持久化，界面风格简洁优雅，充分发挥鸿蒙分布式与高性能特性。

## 主要功能

- **AI 摸鱼助手**：内置 AI 聊天机器人，支持常用语快捷对话，助力摸鱼娱乐。
- **任务管理**：支持任务的添加、完成、删除，任务进度可视化统计，提升效率。
- **番茄钟/二楼动画**：首页下拉进入二楼，集成番茄钟计时、事件记录、动效展示，交互新颖。
- **邮箱注册/登录/找回密码**：集成 AGC 邮箱认证，支持注册、登录、忘记密码找回，用户信息本地持久化。
- **MQTT 通信**：内置 MQTT 客户端，支持消息收发、连接管理，适合物联网场景。
- **个性化设置**：支持头像选择、用户信息展示、退出登录等。
- **多页面导航**：采用 HarmonyOS 路由，页面切换流畅。

## 目录结构

```
Recorde/
├── entry/                  # 主入口模块
│   ├── src/main/ets/
│   │   ├── pages/          # 登录、注册、首页、找回密码等页面
│   │   ├── views/          # 任务、AI、设置、番茄钟等功能视图
│   │   ├── model/          # 数据模型
│   │   ├── utils/          # 工具类
│   │   ├── apis/           # AI 聊天接口
│   │   └── resources/      # 图片、字符串、颜色等资源
│   └── oh-package.json5    # 模块配置
├── casesfeature/           # 特色功能模块（已合并到主入口）
│   └── secondfloorloadanimation/ # 二楼动画与番茄钟
├── AppScope/               # 全局配置与资源
└── README.md               # 项目说明文档
```

## 快速开始

1. **环境准备**：
   - 安装 [DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio/) 4.0 及以上版本。
   - 配置 HarmonyOS NEXT 开发环境。
2. **拉取代码**：
   ```bash
   git clone https://gitee.com/oo-dashuailiu/touch-the-fish
   ```
3. **导入项目**：
   - 使用 DevEco Studio 打开项目根目录。
4. **配置 AGC**：
   - 在 AGC 控制台开通邮箱认证服务，下载 `agconnect-services.json`，放入 `AppScope/resources/rawfile/`。
5. **编译运行**：
   - 选择模拟器或真机，点击运行。

## 主要依赖

- @hw-agconnect/auth         # AGC 认证（邮箱注册/登录）
- @ohos/mqtt                 # MQTT 通信
- ArkUI/ArkTS                # 鸿蒙新一代声明式 UI 框架

## 联系方式

- 作者：oo
- 邮箱：3268086119@qq.com
- Issues：欢迎通过 Issue 反馈问题与建议

## 特色亮点

- 完整演示 HarmonyOS 下拉二楼动画与番茄钟交互，支持事件记录与本地数据库。
- AI 聊天助手集成阿里云接口，支持常用语快捷对话。
- 任务管理支持进度统计、任务持久化。
- 支持 AGC 邮箱注册、登录、找回密码，用户信息本地持久化。
- MQTT 客户端适配物联网消息场景。
- 代码结构清晰，注释详细，便于二次开发与学习。

---

> 本项目为 HarmonyOS NEXT 实践案例，适合学习 ArkTS、分布式开发、动画交互、认证集成等场景。