You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

351 lines
14 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<p align="center">
<img alt="logo" src="https://image.mayongjian.cn/2025/11/11/d6ab67fa0291468ea68afdfb18217ae4.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>1:1 高仿小红书具备内容发布、商品交易、社交互动、算法推荐、即时通讯、AI对话等核心功能适合全栈学习与项目实战。</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](https://opensource.org/licenses/MIT) 协议开源,免费用于学习交流,禁止转售,请提高警惕,谨防受骗。
> 项目名称“小蓝书”为开发代号与“小红书”无任何商业关联,仅为个人学习研究目的使用,演示环境所用图片/视频素材均来源于网络,如有侵权请联系删除。
> 如需商用请保留版权信息,确保合法合规使用,自行承担运营风险,与项目作者无关。
---
## 🚀 项目简介
### 🎓 适合人群
| 👨‍💻 **全栈开发者** | **求职者** | **创业团队** | **学生党** |
|:------------------------------------------------------------------------:|:--------------------------:|:---------------------------:|:-------------------------:|
| 学习 SpringBoot + Vue + Uniapp 全栈开发<br>了解微服务架构设计<br>了解高并发业务场景<br>掌握前后端分离开发 | 简历项目经验<br>面试技术亮点<br>实战能力证明 | 快速搭建社交平台<br>二次开发定制<br>商业化落地 | 毕业设计项目<br>技术栈学习<br>实战经验积累 |
### 📂 项目组成
| 模块 | 模块说明 | 技术栈 | 项目地址 |
|------|-------|--------|---------------------------------------------------------------------------------------------------------------|
| **[HongShu](https://gitee.com/Maverick_Ma/hongshu)** | 后端服务代码Java | SpringBoot + SpringCloud | [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 + TypeScript | [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 + Arco Design + 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代码 | Uniapp + Vue3支持App/小程序/H5 | [gitee](https://gitee.com/Maverick_Ma/hongshu-app) 、 [github](https://github.com/Ma-YongJian/HongShu-App) |
### 🏗️ 技术选型
<table>
<td width="33%">
#### 后端技术栈
- **框架**SpringBoot 3.x、SpringCloud
- **注册中心**Nacos
- **数据库**MySQL 8.x、MyBatis-Plus
- **缓存**Redis 7.x
- **搜索**ElasticSearch 8.x
- **消息队列**RocketMQ
- **即时通讯**WebSocket、Netty
- **AI集成**OpenAI SDK、多模型适配
</td>
<td width="33%">
#### 前端技术栈
- **框架**Vue3 + TypeScript
- **构建工具**Vite 4.x
- **UI组件**Element Plus、Arco Design
- **移动端**Uniapp支持H5、APP、微信小程序
- **状态管理**Pinia
- **网络请求**Axios
- **富文本**WangEditor
- **地图**:高德地图
</td>
<td width="33%">
#### 其他技术
- **容器化**Docker、Docker Compose
- **反向代理**Nginx
- **对象存储**Minio、七牛云、阿里云、腾讯云
- **短信服务**:阿里云、腾讯云、云片
- **支付**:支付宝沙箱
- **监控**SpringBoot Admin
- **文档**Swagger
</td>
</table>
---
## 🌟 项目特色
| 功能模块 | 技术实现 | 创新点 |
|------|-----------------------------------------------------------------|---------------------------------|
| 智能推荐 | 轻量级推荐 + 协同过滤 + ES检索 动态切换 | ✅ 三套算法、新用户优化、性能<100ms |
| 即时通讯 | WebSocket + Netty + RocketMQ | 离线消息、多端同步、高并发支持 |
| 社交电商 | 笔记种草 + 商品转化 + 在线支付 | 价格区间推荐、同城优先、闭环转化 |
| 高并发优化 | Redis + RocketMQ 双通道 + 批量落库 | 性能提升20倍、数据库压力降低90% |
| AI大模型 | ChatGPT + DeepSeek + 多模型适配 | 8+模型支持、智能创作、对话系统 |
| 安全认证 | Token无感刷新 + JWT | 用户无感知、安全可靠 |
| 多云存储 | 本地 + Minio + 七牛云 + 阿里云 + 腾讯云 | 动态切换、后台配置 |
| 智能搜索 | ElasticSearch + MySQL 双引擎 | 多字段权重、模糊匹配 |
| LBS定位 | 高德地图 + IP定位 | 同城推荐、附近内容 |
| 在线支付 | 支付宝沙箱支付 | 完整支付流程 |
| 多端适配 | Web + App + 小程序 | 代码复用、统一API |
| 数据统计 | 用户增长、内容统计、交易分析 | 可视化图表、实时监控 |
---
## 📅 版本演进
> `💡 点击下方版本号可展开查看版本详情`
> [👉 点击获取 Pro 版源码](https://www.yuque.com/xiaomage-ippj7/kaoqwn/rqslw69egcbgx7v7?singleDoc#)
<details>
<summary><b>v1.0Lite版</b></summary>
- ✅ ES 智能查询
- ✅ 笔记随机推荐
- ✅ 图文笔记发布
- ✅ 本地存储、七牛云存储
- ✅ 基础审核机制
</details>
<details>
<summary><b>v2.0Pro版</b></summary>
- ✅ 新增 Uniapp 移动端
- ✅ 支持视频笔记
- ✅ 支持Live Photo动态图片
- ✅ OSS多端存储方案动态配置
- ✅ 协同过滤推荐
</details>
<details>
<summary><b>v3.0Pro版</b></summary>
- ✅ 新增 SpringCloud 微服务架构
- ✅ Nacos 配置中心
- ✅ WebSocket 即时通讯系统
- ✅ 闲置商城(社交电商融合)
- ✅ 高德地图 LBS 定位
- ✅ Redis + RocketMQ 高并发优化
</details>
<details>
<summary><b>v4.0Pro版</b></summary>
- ✅ 支持扫码登录
- ✅ WebSocket 离线消息推送
- ✅ 8+ 主流AI大模型集成
- ✅ 智能对话系统
- ✅ AI辅助创作
- ✅ 微信小程序上线
- ✅ 新增 Arco Design 新版管理后台
-**轻量级推荐算法**(自研)
- 四维度混合召回
- 性能<100ms
</details>
<details>
<summary><b>v5.0Pro版</b>- 微信相关功能开发中</summary>
- ✅ 移动端支持大模型对话
- ✅ 微信一键登录
- ✅ 微信支付
- ✅ 支持微信分享对话、朋友圈
</details>
---
## 🌐 演示站(微服务版本 - 演进更新)
> 💡 **温馨提示**: 因服务器配置有限,如遇访问缓慢请耐心等待
> `小龟速服务器正在奔跑中...`
| 端类型 | 访问方式 | 功能说明 | 推荐指数 |
|--------|------------------------------------------------------------------------------------------|----------------|---------|
| **Web端** | [👉 点击查看(电脑)](https://hongshu.website/) | 完整功能PC体验最佳 | ⭐⭐⭐⭐⭐ |
| **管理端** | [👉 点击查看(电脑)](https://hongshu.website/admin/) | 传统后台管理PC体验最佳 | ⭐⭐⭐⭐ |
| **Arco管理端** | [👉 点击查看(电脑)](https://hongshu.website/arco-admin/) | 现代化管理界面PC体验最佳 | ⭐⭐⭐⭐⭐ |
| **移动端(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="25%">
#### 🤝 项目定制 & 部署
<img src="doc/images/wx.png" width="150"/>
- 项目部署指导
- 功能定制开发
- 技术咨询支持
- Bug修复服务
</td>
<td align="center" width="25%">
#### 💬 技术交流群
<img src="doc/images/qq.png" width="150"/>
- 技术问题解答
- 学习资料分享
- 项目更新通知
- 优先内测资格
</td>
<td align="center" width="25%">
#### 📂 项目资料
<img src="doc/images/gongzhonghao.jpg" width="150"/>
- 搭建部署文档
- 核心功能详解
- 架构图、时序图
- 开题报告、毕业论文
</td>
<td align="center" width="25%">
#### 💖 打赏支持
<img src="doc/images/pay.png" width="150"/>
**您的支持是我前进的动力!**
- 升级服务器配置
- 持续功能开发
- 提升访问速度
- 更好的开源体验
</td>
</tr>
</table>
---
## 📦 项目地址
- **Gitee**: [https://gitee.com/Maverick_Ma/hongshu](https://gitee.com/Maverick_Ma/hongshu) (⭐ Star支持
- **Github**: [https://github.com/Ma-YongJian/HongShu](https://github.com/Ma-YongJian/HongShu) (⭐ Star支持
> **❤️ 如果这个项目对您有帮助,欢迎 Star & Fork 支持一下!** **您的 Star 是对我最大的鼓励!**
## 📚 项目文档
> 都放在公众号里了,自取即可<br>
>
<img src="doc/images/gongzhonghao-search.png" width="300"/>
## 🎬 视频演示
- [演示视频](https://www.bilibili.com/video/BV1dr7Gz9E53/?vd_source=ec9224821314432ac6e12dc7d500d74b)
---
## 📷 演示图
### 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-chat.png" width="300"/></td>
<td><img src="doc/images/app/app-note.png" width="300"/></td>
<td><img src="doc/images/app/app-product.png" width="300"/></td>
</tr>
<tr>
<td><img src="doc/images/app/app-mine.png" width="300"/></td>
<td><img src="doc/images/app/app-message.png" width="300"/></td>
<td><img src="doc/images/app/app-message-chat.png" width="300"/></td>
<td><img src="doc/images/app/app-message-notice.png" width="300"/></td>
</tr>
</table>
### 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-message.png" width="500"/></td>
<td><img src="doc/images/web/web-user.png" width="500"/></td>
</tr>
<tr>
<td><img src="doc/images/web/web-publish.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-notice.png" width="500"/></td>
<td><img src="doc/images/web/web-message-chat.png" width="500"/></td>
</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>
## 🙏 致谢
- [若依 RuoYi](https://gitee.com/y_project/RuoYi)
- [蘑菇博客](https://gitee.com/moxi159753/mogu_blog_v2)
- [RuoYi-ArcoDesignVue](https://gitee.com/renneseme/ruoyi-arco-design-vue)
- [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