# messageBox

**Repository Path**: wangzixu2025/message-box

## Basic Information

- **Project Name**: messageBox
- **Description**: 客户端作业
- **Primary Language**: Kotlin
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# messageBox 项目文档

## 项目简介
messageBox 是一款功能完善的消息管理应用，提供消息列表展示、会话管理、消息搜索、统计分析等核心功能，支持多种消息类型和实时更新。

## 文档导航

- [项目结构详细说明](doc/structure.md)
- [技术方案深度阐述](doc/technical-solution.md)
- [整体架构设计](doc/architecture.md)
- [功能点实现方式](doc/features.md)
- [数据库设计与迁移方案](doc/database.md)
- [消息中心与动态插入机制](doc/message-center.md)
- [开发问题与解决方案](doc/issues.md)

## 快速开始

### 环境要求
- Android Studio
- Kotlin
- Gradle

### 构建与运行
1. 克隆项目到本地
2. 使用 Android Studio 打开项目
3. 连接 Android 设备或启动模拟器
4. 点击 "Run" 按钮构建并运行应用
5. 安装flask`pip install flask`
6. 运行消息中心模拟`python app/src/main/assets/mock_server.py`

## 项目特点

- 支持多种消息类型（文本、图片、操作）
- 实时消息更新与同步
- 高效的消息搜索功能
- 会话管理与历史记录
- 消息统计与分析
- 桌面小部件支持

## 技术栈

- **开发语言**: Kotlin
- **框架**: Android Jetpack (ViewModel, LiveData, Room)
- **网络请求**: Retrofit
- **数据库**: Room Persistence Library
- **UI组件**: Material Design Components
- **异步处理**: Kotlin Coroutines
- **图片加载**: Glide

# 代码运行截图
![输入图片说明](figure/%E6%AF%8F%E6%97%A5%E6%9C%AA%E8%AF%BB%E8%B6%8B%E5%8A%BF.png)
![输入图片说明](figure/%E6%B6%88%E6%81%AF%E5%88%97%E8%A1%A8%E9%A6%96%E9%A1%B5.png)
![输入图片说明](figure/%E6%90%BA%E5%B8%A6%E6%8C%89%E9%92%AE%E7%9A%84%E8%BF%90%E8%90%A5%E7%B1%BB%E6%B6%88%E6%81%AF%E5%AF%B9%E8%AF%9D%E6%A1%86.png)
![输入图片说明](figure/%E5%BC%B1%E7%BD%91%E6%97%A0%E7%BD%91%E4%BD%93%E9%AA%8C%E6%88%AA%E5%9B%BE.png)
![输入图片说明](figure/%E6%90%9C%E7%B4%A2%E6%B6%88%E6%81%AF.png)
![输入图片说明](figure/%E5%B0%8F%E7%BB%84%E4%BB%B6.png)
![输入图片说明](figure/%E5%8A%A0%E8%BD%BD%E8%BF%87%E7%A8%8B%E5%8D%A0%E4%BD%8DUI%20skeleton.png)
![输入图片说明](figure/%E4%BA%91%E5%90%8C%E6%AD%A5.png)
![输入图片说明](figure/%E7%BA%AF%E6%96%87%E6%9C%AC%E5%AF%B9%E8%AF%9D%E6%A1%86.png)
![输入图片说明](figure/%E6%B6%88%E6%81%AF%E9%98%85%E8%AF%BBCTR%E7%BB%9F%E8%AE%A1.png)
![输入图片说明](figure/%E5%A4%87%E6%B3%A8%E9%A1%B5.png)
![输入图片说明](figure/%E6%B6%88%E6%81%AF%E7%B1%BB%E5%9E%8B%E7%82%B9%E5%87%BB%E5%8F%AC%E5%9B%9E%E7%8E%87.png)