# ChatClient

**Repository Path**: Suinnnnnn/chat-client

## Basic Information

- **Project Name**: ChatClient
- **Description**: Qt写的ChatClient
- **Primary Language**: C++
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-13
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chat 客户端

这是一个基于 Qt 开发的桌面聊天客户端应用，提供了丰富的功能模块，包括会话、好友管理、群组详情、历史消息查看等。界面友好，适合用于个人或团队沟通。

## 功能特性

- **会话管理**：支持切换不同的会话页面，查看聊天记录。
- **好友管理**：可以添加、删除好友，并查看好友申请。
- **群组功能**：支持查看群组详细信息。
- **历史消息**：提供历史消息查看功能。
- **用户信息**：支持查看和编辑个人信息。
- **搜索功能**：支持搜索用户信息。
- **自定义控件**：使用了自定义按钮、标签、输入框等控件，提升用户体验。

## 技术栈

- C++
- Qt 框架（包括 QWidget、QML 等模块）
- CMake 构建系统

## 项目结构

- `MainWidget.cpp/h`：主界面逻辑和初始化。
- `MessageShowArea.cpp/h`：消息展示区域，支持添加和清除消息。
- `MessageEditArea.cpp/h`：消息编辑区域。
- `SessionFriendApplyArea.cpp/h`：会话和好友申请区域。
- `ChooseFriendDialog.cpp/h`：选择好友对话框。
- `GroupSessionDetailDialog.cpp/h`：群组详情对话框。
- `UserInfoDialog.cpp/h`：用户信息对话框。
- `SearchDialog.cpp/h`：搜索对话框。
- `Custom/`：自定义控件，如圆形按钮、标签按钮、带提示的输入框等。
- `Model/`：数据模型定义。
- `image/`：项目中使用的图标资源。
- `HistoryDialog.cpp/h`：历史消息查看对话框。
- `SelfInfoDialog.cpp/h`：个人信息编辑对话框。
- `SessionDetailDialog.cpp/h`：会话详情对话框。

## 构建与运行

### 构建要求

- CMake 3.14 或更高版本
- Qt 5 或 Qt 6 开发环境
- C++17 编译器支持

### 构建步骤

1. 安装 Qt 开发环境（建议使用 Qt Creator 或安装 Qt 的命令行工具）。
2. 安装 CMake。
3. 克隆项目到本地：
   ```bash
   git clone https://gitee.com/Suinnnnnn/chat-client.git
   cd chat-client
   ```
4. 构建项目：
   ```bash
   mkdir build && cd build
   cmake ..
   make
   ```
5. 运行程序：
   ```bash
   ./chat-client
   ```

## 使用说明

- 启动程序后，主界面将显示会话、好友、历史等页面。
- 可通过左侧按钮切换不同页面。
- 在会话页面中，可以查看聊天记录和发送新消息。
- 在好友页面中，可以添加或删除好友。
- 在历史消息页面中，可以查看过往的聊天记录。
- 所有界面均支持自定义控件，提供良好的交互体验。

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目。
2. 创建新分支 (`git checkout -b feature/new-feature`)。
3. 提交更改 (`git commit -am 'Add some feature'`)。
4. Push 到分支 (`git push origin feature/new-feature`)。
5. 提交 Pull Request。

## 许可证

本项目使用 MIT 许可证。详情请查看 `LICENSE` 文件。