hongshu/README.md

<p align="center">
  <img alt="logo" src="https://image.mayongjian.cn/2024/07/03/1de3ee08e0a34ab6bf9a163d380fb596.png" width="100"/>
</p>

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">HongShu</h1>
<p align="center">
  <b>基于 SpringBoot + Vue + Uniapp + AI 大模型的仿小红书全栈项目</b>
</p>
<p align="center">
  <i>一款高仿小红书的全栈开源项目，支持内容发布、商品交易、社交互动、即时通讯等核心功能，适合全栈学习与实战。</i>
</p>

<p align="center">
  <a href="https://gitee.com/Maverick_Ma/hongshu/stargazers">
    <img src="https://gitee.com/Maverick_Ma/hongshu/badge/star.svg?theme=dark">
  </a>
  <a href="https://gitee.com/Maverick_Ma/hongshu">
    <img src="https://img.shields.io/badge/HongShu-v1.0-brightgreen.svg">
  </a>
  <a href="https://gitee.com/Maverick_Ma/hongshu/blob/master/LICENSE">
    <img src="https://img.shields.io/github/license/mashape/apistatus.svg">
  </a>
</p>


> **声明**  
> 本项目基于 MIT 协议，免费开源，仅供学习交流，禁止转卖，谨防受骗。如需商用请保留版权信息，确保合法合规使用，运营风险自负，与作者无关。

---

## 🚀 项目简介

HongShu - 一款深度融合 AI 大模型能力的现代化社交电商平台，采用 SpringBoot + Vue + Uniapp 前后端分离架构，完整复刻小红书核心功能，并创新性集成多模态 AI 技术，打造智能化的内容创作与社交体验。

### 📂 项目组成

| 模块 | 模块说明  | 技术栈 | 项目地址                                                                                                          |
|------|-------|--------|---------------------------------------------------------------------------------------------------------------|
| **[HongShu](https://gitee.com/Maverick_Ma/hongshu)** | 后端服务代码（Java） | SpringBoot | [Gitee](https://gitee.com/Maverick_Ma/hongshu) 、 [github](https://github.com/Ma-YongJian/HongShu)             |
| **[HongShu-Web](https://gitee.com/Maverick_Ma/hongshu-web)** | web端代码（vue） | Vue3 + Element Plus | [Gitee](https://gitee.com/Maverick_Ma/hongshu-web) 、 [github](https://github.com/Ma-YongJian/HongShu-Web)     |
| **[HongShu-Admin](https://gitee.com/Maverick_Ma/hongshu-admin)**  | 管理端代码（vue） | Vue3 + Vite | [Gitee](https://gitee.com/Maverick_Ma/hongshu-admin) 、 [github](https://github.com/Ma-YongJian/HongShu-Admin) |
| **[HongShu-App](https://gitee.com/Maverick_Ma/hongshu-app)** | 移动端uniapp代码，<br/>支持app、小程序、H5 | Uniapp | [Gitee](https://gitee.com/Maverick_Ma/hongshu-app) 、 [github](https://github.com/Ma-YongJian/HongShu-App)     |

### 🏗️ 技术选型

- 后端：SpringBoot、SpringCloud、Nacos、Redis、ElasticSearch、MySQL
- 前端：Vue3、TypeScript、Element UI、Vite、uniapp
- 消息：WebSocket、Netty、MQ
- 存储：本地、Minio、七牛云、腾讯云、阿里云
- 短信：阿里云、腾讯云、云片
- 地图：高德地图
- AI大模型：ChatGPT、DeepSeek、豆包、文心一言、通义千问、Kimi、讯飞星火等
---

## 🌟 项目特色

| 功能模块      | 技术实现                       |
|-----------|----------------------------|
| 智能推荐      | ElasticSearch + 协同过滤算法     |
| 即时通讯      | WebSocket + Netty          |
| 多端存储方案    | Minio/七牛云/阿里云/腾讯云OSS动态切换   |
| 高并发优化     | Redis + MQ 消息队列            |
| 安全认证      | 双Token无感刷新机制               |
| 数据双通道同步机制 | 实时写入机制、定时更新机制              |
| 社交与电商融入   | 打通商品和社交通道，实现种草分享，链接购买      |
| AI大模型交互   | 融入ChatGPT、DeepSeek等主流AI大模型 |

---

## 📅 版本演进
> 💡 点击下方版本号可展开查看演进详情
<details>
<summary><b>v1.0（Lite版）</b></summary>

- ES 智能查询、笔记随机推荐
- 笔记支持图文类型
- 本地存储、七牛云存储
- 审核机制

</details>

<details>
<summary><b>v2.0（Pro版）</b></summary>

- 新增 uniapp 移动端
- 笔记支持视频和 live 图类型
- 新增多种 OSS 存储方式，可动态配置
- 协同过滤算法推荐

</details>

<details>
<summary><b>v3.0（Pro版）</b></summary>

- 重构为 springCloud 微服务架构，Nacos 配置中心
- 引入高德地图
- 闲置商城购物功能
- Netty 重构消息聊天
- MQ+Redis 优化点赞、收藏、浏览

</details>

<details>
<summary><b>v4.0（Pro版）</b></summary>

- 新增AI大模型
- 上线微信小程序
- Arco-Design实现新的后台管理系统

</details>

> 👉 [点击获取 Pro 版完整源码](https://www.yuque.com/xiaomage-ippj7/kaoqwn/rqslw69egcbgx7v7?singleDoc#)

---

## 🌐 演示站（微服务版本 - 演进更新）

> 💡 **温馨提示**: 服务器配置有限，如遇访问缓慢请耐心等待
> `小龟速服务器正在奔跑中...`

| 端类型 | 访问方式                                                                           | 备注 |
|--------|--------------------------------------------------------------------------------|------|
| Web端 | [点击访问](https://hongshu.website/)                                                  | 完整功能体验 |
| 管理端 | [点击访问](https://hongshu.website/admin/)                                           | 后台管理系统 |
| Arco管理端 | [点击访问](https://hongshu.website/arco-admin/)                                      | 新版管理界面 |
| 移动端(H5) | [点击访问](https://hongshu.website/app/) 或 <img src="doc/images/h5.png" width="80"/> | 扫码体验 |
| 微信小程序 | 体验版 <img src="doc/images/wxamp.png" width="80"/>                               | 扫码体验 |
---

## 📞 联系与支持

<table>
<tr>
<td align="center" width="50%">

#### 🤝 项目定制 & 部署
<img src="doc/images/wx.png" width="200"/>
<p>微信联系</p>
</td>
<td align="center" width="50%">

#### 💬 技术交流
<img src="doc/images/qq.png" width="200"/>
<p>QQ交流群</p>
</td>
</tr>
</table>

---

## 📦 项目地址

- Gitee: [https://gitee.com/Maverick_Ma/hongshu](https://gitee.com/Maverick_Ma/hongshu)
- Github: [https://github.com/Ma-YongJian/HongShu](https://github.com/Ma-YongJian/HongShu)

> **欢迎 Star & Fork 支持项目一下！**

---

## 📚 项目文档

- [部署文档](https://www.yuque.com/xiaomage-ippj7/kaoqwn/zdgtgrco82vftbot?singleDoc#)

---

## 🎬 视频演示

- [Bilibili 演示视频](https://www.bilibili.com/video/BV1dr7Gz9E53/?vd_source=ec9224821314432ac6e12dc7d500d74b)

---

## 💖 打赏支持

当前服务器配置有限（2核4G），偶尔会有加载缓慢的情况。
感谢小伙伴们打赏支持用于升级服务器❤️

<img src="doc/images/pay.png" width="300"/>

---

## 📷 演示图

### Web端

<table>
  <tr>
    <td><img src="doc/images/web/web-login.png" width="500"/></td>
    <td><img src="doc/images/web/web-dashboard.png" width="500"/></td>
    <td><img src="doc/images/web/web-idle.png" width="500"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/web/web-trends-note.png" width="500"/></td>
    <td><img src="doc/images/web/web-trends-idle.png" width="500"/></td>
    <td><img src="doc/images/web/web-publish.png" width="500"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/web/web-publish-map.png" width="500"/></td>
    <td><img src="doc/images/web/web-publish-img.png" width="500"/></td>
    <td><img src="doc/images/web/web-publish-video.png" width="500"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/web/web-message-comment.png" width="500"/></td>  
    <td><img src="doc/images/web/web-message-like.png" width="500"/></td>
    <td><img src="doc/images/web/web-user.png" width="500"/></td>
  </tr>
  <tr>
  </tr>
</table>

### 管理端

<table>
  <tr>
    <td><img src="doc/images/admin/admin-login.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-data.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-data-map.png" width="500"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/admin/admin-navbar.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-note.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-idle.png" width="500"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/admin/admin-member.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-album.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-config.png" width="500"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/admin/admin-gpt.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-gpt-login.png" width="500"/></td>
    <td><img src="doc/images/admin/admin-gpt-chat.png" width="500"/></td>
  </tr>
</table>

### App端

<table>
  <tr>
    <td><img src="doc/images/app/app-login.png" width="300"/></td>
    <td><img src="doc/images/app/app-index.png" width="300"/></td>
    <td><img src="doc/images/app/app-follow.png" width="300"/></td>
    <td><img src="doc/images/app/app-near.png" width="300"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/app/app-idle.png" width="300"/></td>
    <td><img src="doc/images/app/app-user.png" width="300"/></td>
    <td><img src="doc/images/app/app-main.png" width="300"/></td>
    <td><img src="doc/images/app/app-user-mine.png" width="300"/></td>
  </tr>
  <tr>
    <td><img src="doc/images/app/app-message.png" width="300"/></td>
    <td><img src="doc/images/app/app-message-follow.png" width="300"/></td>
    <td><img src="doc/images/app/app-message-comment.png" width="300"/></td>
    <td><img src="doc/images/app/app-message-like.png" width="300"/></td>
  </tr>
</table>


## 🙏 致谢

- [若依 RuoYi](https://gitee.com/y_project/RuoYi)
- [蘑菇博客](https://gitee.com/moxi159753/mogu_blog_v2)
- [xiaozhao 仿小红书前端](https://gitee.com/xzjsccz/xiaohongshu)
- [Chat MASTER](https://gitee.com/panday94/chat-master)
- <img src="./doc/images/qiniu.jpg" width="80" />感谢 [七牛云](https://portal.qiniu.com/signup?utm_source=kaiyuan&utm_media=mogu) 提供的免费云存储和CDN服务
- <img src="./doc/images/jetbrains.png" width="40" />感谢 [jetbrains](https://www.jetbrains.com/?from=mogu_blog_v2) 提供的开源License