更新记录

1.0.0（2026-06-05） 下载此版本

• 预览地址: http://nelyo.online:8082
• 支持登录注册、用户资料、好友列表、好友申请
• 支持单聊、群聊、会话列表、未读数、消息撤回、引用回复
• 支持文本、图片、语音等消息类型
• 支持 WebSocket 实时通信、心跳保活、断线重连、ACK 消息确认
• 支持社区动态、帖子详情、发布动态、评论互动
• 提供配套 Node.js 后端服务和部署说明

平台兼容性

uni-app(3.8.1)

在线预览: http://nelyo.online:8082/#/

Tips: 测试账号 linyi / 密码 123456，也可使用 muyan / 123456 体验聊天互动。

v: jzt03562524

GMTY 是一套基于 uni-app + Vue3 的即时通讯与社交功能组件包，适合用于快速搭建聊天、好友、群组、社区动态等业务场景。项目已包含前端页面、IM 通信适配层、接口封装、状态管理以及配套 Node.js 后端服务，可作为 IM 社交类小程序、H5 、APP应用或业务系统的二次开发基础。

核心功能

• 登录注册：支持账号注册、登录鉴权、用户资料完善。
• 消息会话：支持会话列表、最近消息预览、未读数、置顶、免打扰、清空会话、删除会话。
• 单聊功能：支持好友之间一对一实时聊天。
• 群聊功能：支持创建群聊、邀请成员、群资料、成员管理、退出群聊、解散群聊、转让群主、管理员角色设置。
• 消息类型：支持文本、图片、语音、系统消息等常用消息类型。
• 消息操作：支持消息撤回、引用回复、聊天记录搜索、历史消息分页加载。
• 好友系统：支持好友列表、好友详情、添加好友、好友申请处理。
• 社区动态：支持动态列表、帖子详情、发布图文动态、评论互动、个人主页。
• 图片上传：内置图片上传、图片资源校验和基础图片处理能力。
• 本地缓存：支持会话、消息、好友、群组、草稿等数据缓存，提升页面打开速度和弱网体验。

IM 通信能力

GMTY 的 IM 模块采用 WebSocket 实时通信方案，前端通过统一的 IM Adapter 管理连接、消息发送、消息接收和会话状态，后端负责连接鉴权、消息落库、在线用户路由和实时推送。

通信链路具备以下能力：

• 实时收发：消息通过 WebSocket 即时投递，单聊和群聊均可实时同步。
• 鉴权连接：WebSocket 连接接入登录 Token 校验，避免未授权用户进入通信链路。
• ACK 确认机制：消息发送后等待服务端确认，前端可准确感知发送成功、失败或超时状态。
• 心跳保活：内置心跳检测，持续维护连接可用性。
• 断线重连：连接异常中断后自动尝试恢复，减少网络波动对聊天体验的影响。
• 多端在线分发：服务端按用户在线连接进行消息推送，支持同一用户多连接场景。
• 会话同步：新消息到达后自动更新会话预览、时间排序和未读状态。
• 群聊广播：群消息按成员关系进行分发，并校验发送者是否属于当前群聊。
• 输入状态：支持“正在输入”状态透传，增强聊天实时感。
• 已读回执：支持会话已读上报与消息已读状态同步。
• 消息安全校验：服务端校验空消息、非法图片/语音地址、非法会话、非法引用消息等异常数据。
• 离线数据补偿：历史消息和会话列表通过接口加载，配合本地缓存减少重复请求。

整体通信设计兼顾实时性、稳定性和可维护性，适合中小型 IM、社交、社区、客服、私域沟通等场景二次开发。

前端模块

• Vue3 + TypeScript + uni-app
• Pinia 状态管理
• 会话、消息、好友、群组、社区等业务 Store
• 统一 API 请求封装
• IM Adapter 通信适配层
• 消息气泡、聊天输入框、会话项、社区卡片、图片九宫格、评论组件等常用 UI 组件
• 支持 H5 和微信小程序构建

后端能力

• Node.js + Express 服务
• WebSocket 实时通信服务
• 用户鉴权与 Token 解析
• 会话、消息、好友、群组、社区数据接口
• 图片上传服务
• 数据表自动补齐能力
• 支持部署到普通服务器并通过 PM2 运行

适用场景

• 即时通讯小程序
• 社交聊天应用
• 社区互动应用
• 私域用户沟通工具
• 客服会话系统原型
• 校园、兴趣圈、社群类应用
• 需要快速集成聊天能力的 uni-app 项目

技术特点

• 组件化结构清晰，便于拆分和二次开发。
• 前后端功能完整，减少从零搭建 IM 基础链路的时间。
• 已内置常见聊天业务状态，如未读、草稿、置顶、免打扰、撤回、引用、已读等。
• 真实 WebSocket 通信方案，不依赖纯前端模拟数据。
• 本地缓存与接口数据结合，兼顾首屏速度和数据一致性。
• 消息发送流程包含超时、失败、服务端确认等状态处理，用户体验更稳定。

说明

本项目适合具备一定 uni-app、Vue3 和 Node.js 基础的开发者使用。购买后可根据自身业务继续扩展表情、红包、文件消息、音视频通话、内容审核、云存储、消息漫游等能力。