# chatbox_flutter

**Repository Path**: opengxh/chatbox_flutter

## Basic Information

- **Project Name**: chatbox_flutter
- **Description**: 完全 agent 驱动重写的 im 客户端
- **Primary Language**: Dart
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ChatBox - 现代企业即时通讯与协作平台

ChatBox 是一个基于 Flutter 构建的跨平台（iOS, Android, Web, Desktop）即时通讯与企业协作应用。它融合了现代 UI 设计、高效的沟通工具和智能化的工作流，旨在为企业提供一站式的数字化协作体验。

## 🚀 主要特性

### 💬 即时通讯
- **多平台同步**：支持 iOS, Android, Web 和 Desktop，消息实时同步。
- **富文本消息**：支持文字、表情、图片、文件、语音消息、@提及等多种消息类型。
- **消息管理**：消息搜索、消息转发、消息收藏、消息撤回、消息置顶。
- **群组聊天**：支持创建群组、群组管理、群公告、群成员管理。
- **消息通知**：支持消息通知、免打扰、消息已读/未读状态。

### 🏢 企业协作
- **工作台**：统一的工作入口，集成待办事项、快捷入口、常用应用等。
- **通讯录**：企业通讯录管理，支持部门、职位、联系人管理。
- **日程管理**：日程创建、日程提醒、日程同步、日程协作。
- **任务管理**：任务创建、任务分配、任务跟踪、任务提醒。
- **文档协作**：文档创建、文档编辑、文档共享、文档评论。
- **会议管理**：会议创建、会议提醒、会议纪要、会议协作。

### 🎨 现代 UI 设计
- **沉浸式体验**：支持深色/浅色模式切换，动态壁纸，个性化主题。
- **流畅动画**：支持 Hero 动画、视差滚动、微交互等，提升用户体验。
- **响应式布局**：支持不同屏幕尺寸的自适应布局。
- **多语言支持**：支持多语言切换，满足不同地区用户的需求。

### 🔐 安全与隐私
- **端到端加密**：支持端到端加密，保障消息安全。
- **隐私保护**：支持隐私设置、消息已读/未读控制、消息撤回等。
- **安全认证**：支持手机号注册、邮箱注册、第三方登录等多种认证方式。

## 🛠️ 技术栈

- **框架**：Flutter 3.x
- **状态管理**：Riverpod
- **路由管理**：go_router
- **网络请求**：dio
- **本地存储**：shared_preferences, hive
- **动画库**：flutter_animate
- **图标库**：flutter_svg, font_awesome_flutter
- **UI 组件**：custom_refresh_indicator, smooth_page_indicator

## 📂 项目结构

```
chatbox/
├── lib/
│   ├── main.dart             # 应用入口
│   ├── core/                 # 核心模块
│   │   ├── theme/            # 主题管理
│   │   ├── router/           # 路由管理
│   │   ├── data/             # 数据层
│   │   └── utils/            # 工具类
│   ├── features/             # 功能模块
│   │   ├── auth/             # 认证模块
│   │   ├── home/             # 首页模块
│   │   ├── messages/         # 消息模块
│   │   ├── contacts/         # 通讯录模块
│   │   └── workspace/        # 工作台模块
│   └── shared/               # 共享组件
├── assets/                   # 静态资源
│   ├── images/               # 图片资源
│   ├── icons/                # 图标资源
│   └── fonts/                # 字体资源
├── test/                     # 测试代码
└── pubspec.yaml              # 项目依赖
```

## 🚀 快速开始

### 前提条件
- Flutter SDK 3.x 或更高版本
- Dart SDK 2.12 或更高版本
- Android Studio 或 VS Code

### 安装依赖
```bash
flutter pub get
```

### 运行应用
```bash
# 运行应用
flutter run

# 运行应用并指定设备
flutter run -d <device_id>

# 运行应用并启用热重载
flutter run --hot
```

### 构建应用
```bash
# 构建 Android APK
flutter build apk --debug

# 构建 Android Release APK
flutter build apk --release

# 构建 iOS 应用
flutter build ios --no-codesign

# 构建 Web 应用
flutter build web --release
```

## 📱 预览

### 登录页面
![登录页面](assets/images/login_page.png)

### 首页
![首页](assets/images/home_page.png)

### 消息列表
![消息列表](assets/images/messages_page.png)

### 聊天详情
![聊天详情](assets/images/chat_detail_page.png)

### 通讯录
![通讯录](assets/images/contacts_page.png)

### 工作台
![工作台](assets/images/workspace_page.png)

## 🤝 贡献

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交变更 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目遵循 MIT 许可证。