# smart-chat

**Repository Path**: wc521521/smart-chat

## Basic Information

- **Project Name**: smart-chat
- **Description**: smart-chat是一站式大模型聚合调度服务，解决多平台 API 切换繁琐、本地模型私有化部署难、知识库搭建成本高的痛点。一键切换豆包、OpenAI、DeepSeek、Claude、文心一言、通义千问、讯飞星火、智谱清言、腾讯混元等主流云端模型；支持 Ollama等本地大模型私有化运行与私有知识库问答，兼容 Coze 扣子、Dify、FastGPT、Gitee AI 模力方舟第三方平台接口
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://www.lingdou.top/ai-chat
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-07-31
- **Last Updated**: 2026-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SmartChat — 开箱即用的全栈 AI 对话平台

<p align="center">
    <a href="https://gitee.com/yaukie/smart-chat" target="_blank">
    	<img src="https://svg.hamm.cn/gitee.svg?type=star&user=yaukie&project=smartchat" alt="Gitee Star"/>
    </a>
    <a href="https://gitcode.com/yaukie/smartchat" target="_blank">
        <img src="https://gitcode.com/yaukie/smartchat/star/badge.svg" alt="GitCode Star"/>
    </a>
    <img src="https://img.shields.io/badge/SpringBoot-2.3.7-brightgreen.svg" alt="Spring Boot"/>
    <img src="https://img.shields.io/badge/JDK-8%2B-orange.svg" alt="JDK"/>
    <img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License"/>
    <a href="#联系我们"><img src="https://img.shields.io/badge/公众号-MasterAII-blue" alt="公众号"></a>
</p>

<p align="center">
  <strong>一个项目覆盖 Web 端 · 移动端 · 管理后台，10 分钟搭建属于你的 AI 对话产品</strong>
</p>

---

> **开源声明**
>
> 本项目发布于 [Gitee](https://gitee.com/yaukie/smart-chat)、[GitCode](https://gitcode.com/yaukie/smartchat) 和 [GitHub](https://github.com/yaukie/smart-chat)，遵循 **Apache License 2.0** 协议，仅供学习与研究使用，**严禁转卖**。
>
> 如需商用，须保留版权信息。请确保合法合规运营，由此产生的一切后果由使用者自行承担，与作者无关。

---

## 你是否也遇到过这些痛点？

| 痛点 | 场景描述 |
|---|---|
| **模型接入碎片化** | DeepSeek、ChatGPT、豆包、通义千问……每家 API 格式不同、鉴权方式各异，逐个对接耗时耗力 |
| **密钥管理混乱** | 多个模型的 Key 散落在配置文件与环境变量中，切换模型还要改配置、重启服务 |
| **从零搭建成本高** | 鉴权、支付、会员、用户管理……对话之外的业务基建占了 80% 的开发量 |
| **本地模型难整合** | 想用 Ollama 跑本地模型、用 Dify 搭工作流，却无法与线上服务统一管理 |
| **多端适配麻烦** | Web、小程序、App 各写一套代码，维护成本成倍增长 |

**SmartChat 正是为解决这些问题而生。** 它将上述所有能力封装为一套开箱即用的全栈方案，让你**专注业务创新，不再重复造轮子**。

---

## 项目简介

SmartChat 是一套**企业级全栈 AI 对话平台**，采用前后端分离架构，一个项目同时覆盖：

- **Web 用户端**（Vue3 + TypeScript + Naive UI）
- **管理后台**（Vue2 + Element UI）
- **Java 后端服务**（Spring Boot 多模块）
- **移动端**（UniApp → App / 微信小程序 / H5，商业版提供）

无论是个人开发者快速验证 AI 创意，还是企业团队搭建自有对话产品，SmartChat 都能让你**从 0 到 1 最快落地**。

> 如果项目对你有帮助，请点个 **Star** 支持一下！如需 ChatGPT / Claude 接入或商业版授权，欢迎[联系作者](#联系我们)。
>
> 期待更多模型或功能？欢迎提交 [Issues](https://gitee.com/yaukie/smart-chat/issues) 参与讨论。

---

## 核心亮点

### 10+ 主流大模型，后台一键切换

内置 **DeepSeek（满血 R1）、ChatGPT、Claude3、豆包、Kimi（月之暗面）、文心一言、通义千问、讯飞星火、智谱清言、书生浦语、腾讯混元** 等主流模型。

所有模型的密钥、版本号、接口地址均在管理后台可视化配置，**改完即时生效，无需修改代码、无需重启服务**。

### 云端 + 本地 + 智能体平台，三路打通

不仅支持官方 API 直连，还深度兼容：

| 接入方式 | 支持平台 |
|---|---|
| **本地私有化** | [Ollama](https://ollama.com/)、[Langchain-chatchat](https://github.com/chatchat-space/Langchain-Chatchat) |
| **在线智能体** | [Coze（扣子）](https://www.coze.cn/home)、[Dify](https://cloud.dify.ai/explore/apps)、[FastGPT](https://cloud.fastgpt.cn/)、[RagFlow](https://ragflow.io/)、[Gitee AI（模力方舟）](https://ai.gitee.com/) |

一个后台统一纳管所有 AI 能力，自由组合、按需调度。

### 全栈交付，不只是聊天

开箱即带完整的商业化基建，省去从零造轮子的时间：

- **JWT 多端鉴权** — 前台用户 Token 与后台管理员 Token 独立隔离
- **VIP / SVIP 会员体系** — 多级权益、灵活定价、到期自动处理
- **微信支付** — 同时支持普通商户与服务商模式
- **灵豆数计费系统** — 按次 / 按灵豆数灵活计费，注册即赠送体验额度
- **兑换码** — 批量生成、一键核销，可兑换灵豆数或会员
- **分享裂变** — 分享获取灵豆数奖励，驱动社交传播拉新
- **用户管理** — 账号禁用、信息编辑、使用统计全掌控
- **数据统计** — 可视化仪表盘，运营指标一目了然

### 深度思考 · 联网搜索 · 多模态对话

- **深度思考**：支持 DeepSeek R1 等推理模型，完整展示思维链过程
- **联网搜索**：实时联网获取最新资讯，回答不再受限于训练数据
- **文档 / 图片对话**：上传 PDF、Word、图片等文件即可对话，满足专业场景需求
- **智能体 / 工作流**：对接 Coze、Dify、FastGPT 等多智能体平台，灵活扩展 AI 能力边界

### 流式响应，打字机级体验

同步 & 流式（SSE）双模式输出，实时逐字呈现 AI 回答，**用户感知延迟趋近于零**。

### 一键部署，10 分钟上线

提供完整的 **Docker Compose** [一键部署方案](./deploy/deploy.md)，从拉取镜像到服务上线，最快 10 分钟即可完成。同时也支持传统 JAR 包手动部署，满足不同运维场景。

---

## 技术栈一览

| 层级 | 技术选型 | 说明 |
|---|---|---|
| 服务端 | Spring Boot 2.3.7 + Spring Security + JWT | 多模块架构，RESTful API 设计 |
| ORM | MyBatis-Plus | 简化数据库操作，内置分页与代码生成 |
| 数据库 | MySQL 5.7+ | 主业务数据存储 |
| 缓存 | Redis | 会话管理、Token 缓存、接口限流 |
| Web 用户端 | Vue 3 + TypeScript + Naive UI | 现代响应式 SPA，暗色主题 |
| 管理后台 | Vue 2 + Element UI | 经典企业级后台管理框架 |
| 移动端 | UniApp（App / 小程序 / H5） | 一套代码多端发布（商业版提供） |

> **JDK 版本说明：** `master` 分支默认使用 **JDK 8**；另有 `springboot3` 分支支持 **JDK 17 / 20**，适配 Spring Boot 3.x，[查看 SpringBoot3 分支](https://gitee.com/yaukie/smart-chat/tree/springboot3)。

---

## 在线演示

| 端 | 演示地址 | 账号 / 密码 |
|---|---|---|
| Web 用户端 | [https://www.lingdou.top/ai-chat](https://www.lingdou.top/ai-chat) | 注册即可体验 |
| 管理后台 | [https://www.lingdou.top/smart-admin](https://www.lingdou.top/smart-admin/#) | `yaukie` / `yaukiechat` |
| 移动端 | 关注公众号[扫码体验](#联系我们) | — |

### Web 用户端预览

![移动端效果](./doc/file/app.png)
![登录页面](./doc/file/login.png)
![首页效果](./doc/file/index.png)
![对话效果](./doc/file/chat.gif)
![对话效果-移动端](./doc/file/h5.gif)

### 管理后台预览

<table>
    <tr>
        <td><img src="./doc/file/admin/1.jpg"/></td>
        <td><img src="./doc/file/admin/2.jpg"/></td>
    </tr>
    <tr>
        <td><img src="./doc/file/admin/3.jpg" /></td>
        <td><img src="./doc/file/admin/4.jpg"/></td>
    </tr>
    <tr>
        <td><img src="./doc/file/admin/5.jpg"/></td>
        <td><img src="./doc/file/admin/6.jpg"/></td>
    </tr>
    <tr>
        <td><img src="./doc/file/admin/7.jpg"/></td>
        <td><img src="./doc/file/admin/8.jpg"/></td>
        <td><img src="./doc/file/admin/9.jpg"/></td>
        <td><img src="./doc/file/admin/10.jpg"/></td>
    </tr>
</table>

---

## 功能全景

### AI 对话能力

| 能力 | 详细说明 |
|---|---|
| 多模型一键切换 | 10+ 国内外主流大模型，后台可视化配置，即时生效无需重启 |
| 流式打字机输出 | 同步 & SSE 流式双模式，逐字实时呈现，体验流畅 |
| 深度思考 | 支持 R1 等推理模型，完整展示思维链（Chain-of-Thought）推导过程 |
| 联网搜索 | 对话中实时联网检索，获取最新资讯，突破训练数据时效限制 |
| 文档 / 图片对话 | 上传 PDF、Word、图片等文件进行多模态对话，满足专业分析场景 |
| 本地模型部署 | 兼容 Ollama、Langchain-chatchat，支持完全私有化离线运行 |
| 智能体 / 工作流 | 无缝对接 Coze、Dify、FastGPT、RagFlow、Gitee AI 等在线平台 |
| 自定义助手 | 后台配置 Prompt 模板与角色设定，按场景精准输出专业内容 |
| 上下文记忆 | 支持多轮对话上下文关联，保持对话连贯性 |

### 商业化能力

| 能力 | 详细说明 |
|---|---|
| VIP / SVIP 会员 | 多级会员体系，不同等级享受不同模型使用额度与计费折扣 |
| 微信支付 | 同时支持普通商户与服务商两种支付模式，覆盖各类经营场景 |
| 兑换码系统 | 批量生成、一键核销，可兑换灵豆数或会员时长，适合营销推广 |
| 灵豆数计费 | 按次 / 按灵豆数灵活计费，新用户注册即赠体验额度，降低使用门槛 |
| 分享裂变 | 用户分享获取灵豆数奖励，利用社交关系链实现低成本拉新 |
| 用户管理 | 账号启禁用、信息编辑、使用统计、登录记录，全方位用户运营 |

### 管理后台

| 模块 | 功能说明 |
|---|---|
| 工作台 | 核心数据聚合看板，快捷入口一键直达常用功能 |
| 数据中心 | 可视化图表展示用户增长、模型调用、灵豆数消耗等运营指标 |
| 任务中心 | 对话记录全程留痕、绘画任务可追溯，支持按用户 / 时间筛选 |
| 订单管理 | 会员订单查看、支付流水核对、在线退款操作 |
| 会员中心 | 用户信息总览、模型使用次数统计、灵豆数消耗明细 |
| 模型管理 | 大模型信息、版本号、API 密钥可视化配置，支持启用 / 停用 |
| 助手中心 | Assistant 分类管理、Prompt 模板配置，支持提示词 / 智能体 / 工作流类型 |
| 应用管理 | 站点基础配置、微信公众号接入、OSS 文件存储、SMS 短信、用户协议 |
| 系统管理 | 菜单权限、角色管理、系统字典等基础运维功能 |

---

## 已接入模型

> 模型版本持续更新，详细变更记录请查看 [CHANGELOG](./CHANGELOG.md)。

| 模型 | 厂商 | 国内可用 | 免费额度 | 官网 |
|---|---|---|---|---|
| DeepSeek（含 R1） | 深度求索 | ✅ 是 | 有 | [chat.deepseek.com](https://chat.deepseek.com/) |
| ChatGPT | OpenAI | ❌ 需代理 | 否 | [chat.openai.com](https://chat.openai.com/) |
| Claude3 | Anthropic | ❌ 需代理 | 否 | [claude.ai](https://claude.ai/) |
| 豆包 | 字节跳动 | ✅ 是 | 有 | [doubao.com](https://www.doubao.com/) |
| Kimi（月之暗面） | Moonshot AI | ✅ 是 | 有 | [kimi.moonshot.cn](https://kimi.moonshot.cn/) |
| 文心一言 | 百度 | ✅ 是 | 有 | [yiyan.baidu.com](https://yiyan.baidu.com/) |
| 通义千问 | 阿里巴巴 | ✅ 是 | 有 | [tongyi.aliyun.com](https://tongyi.aliyun.com/) |
| 讯飞星火 | 科大讯飞 | ✅ 是 | 有 | [xinghuo.xfyun.cn](https://xinghuo.xfyun.cn/) |
| 智谱清言 (GLM) | 智谱 AI | ✅ 是 | 有 | [chatglm.cn](https://chatglm.cn/) |
| 书生浦语 | 上海 AI Lab | ✅ 是 | 有 | [internlm-chat.intern-ai.org.cn](https://internlm-chat.intern-ai.org.cn/) |
| 腾讯混元 | 腾讯 | ✅ 是 | 有 | [hunyuan.tencent.com](https://hunyuan.tencent.com/) |

> **接入提示：** ChatGPT / Claude 可通过 Cloudflare Workers 或代理中转访问，接口地址与密钥统一在管理后台配置，无需改动代码。同时支持自定义 OpenAI 兼容格式的中转 API。

---

## 项目结构

```
smartChat-open/
├── smart-chat-plus/          # Java 后端服务（Spring Boot 多模块）
│   ├── smartchat-api/        # RESTful API 接口层（Controller）
│   ├── smartchat-client/     # 外部服务调用客户端
│   ├── smartchat-core/       # 核心业务逻辑与 LLM 模型调用
│   ├── smartchat-framework/  # 框架层（安全、拦截器、通用配置）
│   ├── smartchat-helper/     # 工具类与公共辅助模块
│   ├── smartchat-sys/        # 系统管理（用户、角色、菜单、字典等）
│   ├── smartchat-quartz/     # 定时任务调度模块
│   ├── ext/                  # 扩展模块
│   └── sql/                  # 数据库初始化脚本
├── smartchat-web-front/      # Web 用户端（Vue3 + TypeScript + Naive UI）
├── smartchat-admin-front/    # 管理后台（Vue2 + Element UI）
├── smartchat-common/         # 前端公共模块与工具库
├── deploy/                   # 部署文档与 Docker 配置
└── doc/                      # 项目文档与截图资源
```

---

## 快速开始

### 环境要求

| 依赖 | 最低版本 | 推荐版本 | 说明 |
|---|---|---|---|
| JDK | 8 | 8 / 17 | master 分支用 JDK 8，springboot3 分支用 JDK 17+ |
| MySQL | 5.7 | 8.0 | 字符集建议 `utf8mb4` |
| Redis | 5.0 | 6.x / 7.x | 用于缓存与 Session 管理 |
| Node.js | 14 | 16 / 18 | 前端编译构建 |
| Maven | 3.6 | 3.8+ | Java 依赖管理 |

### 三步上手

```bash
# 1. 克隆项目
git clone https://gitee.com/yaukie/smart-chat.git

# 2. 导入数据库
# 执行 smart-chat-plus/sql/ 目录下的 SQL 脚本，创建 smart_chat 数据库并初始化数据

# 3. 按文档启动后端和前端
```

> 完整的部署步骤（含 Docker Compose 一键部署、Nginx 配置、常见问题排查）请查阅 **[部署指南](./deploy/deploy.md)**。
>
> 遇到问题？先看看 **[常见问题 FAQ](./doc/常见问题.md)**，90% 的问题都能找到答案。

---

## 产品路线图

| 状态 | 功能 | 说明 |
|---|---|---|
| ✅ 已完成 | 多模型统一接入 & 流式输出 | 10+ 大模型 + SSE 打字机效果 |
| ✅ 已完成 | 会员体系 & 微信支付 | VIP/SVIP + 普通商户/服务商 |
| ✅ 已完成 | 本地模型支持 | Ollama / Langchain-chatchat |
| ✅ 已完成 | 智能体平台对接 | Coze / Dify / FastGPT / RagFlow / Gitee AI |
| ✅ 已完成 | 多模态对话 | 文档上传 + 图片识别 + 深度思考 + 联网搜索 |
| ✅ 已完成 | Docker 一键部署 | Docker Compose 全流程编排 |
| ✅ 已完成 | 公众号智能客服 | 微信公众号接入 AI 自动回复 |
| 🚧 规划中 | MJ / SD AI 绘画 | Midjourney / Stable Diffusion 绘画能力 |
| 🚧 规划中 | 语音对话 | 语音输入 + AI 语音合成输出 |
| 🚧 规划中 | 视频生成 | AI 视频内容生成 |

---

## 相关资源

| 资源 | 链接 |
|---|---|
| 开发文档 | [语雀文档](https://www.yuque.com/yaukie/ct0azl/ehxcgoy0xg41l9c3) |
| 部署教程 | [部署指南](./deploy/deploy.md) |
| 常见问题 | [FAQ](./doc/常见问题.md) |
| 商业版详情 | [产品功能手册](./deploy/product-plus.md) |
| GitHub 镜像 | [github.com/yaukie/smart-chat](https://github.com/yaukie/smart-chat) |
| 版本记录 | [CHANGELOG](./CHANGELOG.md) |

> **云服务器推荐（新用户享大额优惠）：**
> - 阿里云折扣场 [点我进入](https://www.aliyun.com/minisite/goods?userCode=iqguofg4) ｜ [领取优惠券](https://www.aliyun.com/daily-act/ecs/activity_selection?userCode=iqguofg4)
> - 腾讯云秒杀场 [点我进入](https://curl.qcloud.com/11y0ob0f) ｜ [领取优惠券](https://curl.qcloud.com/EUbjrCcu)

---

## 参与贡献

在提交贡献之前，请先阅读 [贡献指南](./CONTRIBUTING.md)，了解 Commit 规范与 PR 流程。

我们欢迎任何形式的贡献，包括但不限于：

- 提交代码改进与新功能 PR
- 优化文档内容或翻译
- 提交 Bug Issue 与 Feature Request
- 分享使用心得与最佳实践

**感谢每一位贡献者的付出，是你们让这个项目变得更好！**

---

## 关注公众号

扫码关注 **MasterAII** 公众号，获取第一手更新资讯与技术干货：

<div style="display: flex;">
    <img style="width: 100%; max-width: 400px;" src="./doc/file/personal.png" alt="公众号 MasterAII" />
</div>

## 联系我们

扫码加入微信交流群，与开发者们一起讨论交流：

<div style="display: flex; gap: 20px;">
    <img style="max-width: 100%; max-width: 400px;" src="./doc/file/qr_code.jpeg" alt="微信交流群" />
</div>

---

### 关于后端对接

SmartChat 开源版已提供**完整的前端 + 后端源码**，你可以自行部署运行。但在实际落地过程中，你可能还需要对接以下外部服务：

| 依赖服务 | 用途 | 说明 |
|---------|------|------|
| AI 大模型 API | 对话能力核心引擎 | DeepSeek / ChatGPT / 豆包 / Kimi 等，需在各自官网申请 API Key |
| 微信支付 | 会员购买 & 灵豆充值 | 需有微信商户号，支持普通商户与服务商两种接入模式 |
| 阿里云 OSS | 文件 / 图片存储 | 用户上传文件、头像、对话图片的持久化存储 |
| SMS 短信服务 | 手机号验证 & 通知 | 阿里云 / 腾讯云短信服务，用于注册验证与运营通知 |
| 微信公众号 | 智能客服 & 消息推送 | 需认证服务号，对接微信消息接口实现 AI 自动回复 |
| SSL 证书 & 域名 | HTTPS 访问 | 生产环境必须配置 HTTPS，否则微信 JS-SDK 等功能无法正常使用 |

如果你希望：
- **跳过繁琐的 API 申请与调试**，直接对接我们已调通的模型通道
- **获取商业版源码**，解锁移动端（UniApp 小程序 / App）、AI 绘画、语音对话等高级功能
- **私有化部署支持**，帮你跑通从服务器搭建到第一个用户对话的全流程
- **定制化二次开发**（换品牌、接私有模型、定制计费规则、对接企业微信等）

欢迎添加作者微信 **`yaukie`** 私聊对接，我们可以提供：

> - 商业版全套源码 + 移动端代码 + 完整数据库脚本（开箱即用）
> - AI 模型联调支持（帮你配通第一个对话请求，解决 Key 申请、代理中转等问题）
> - 服务器部署指导（宝塔 / Docker Compose / K8s 均可，包含 Nginx 反向代理配置）
> - 功能定制与商业授权方案

> **商业合作 / 定制开发 / 技术咨询**，欢迎添加作者微信：`yaukie`

## 捐赠支持

如果 SmartChat 对你有所帮助，请作者喝杯咖啡吧 ☺ 你的支持是持续更新的动力！

![捐赠二维码](./doc/file/donate.jpg)

---

## 许可证

[Apache License 2.0](./LICENSE)

Copyright (c) 2023 知韵软件开发工作室 Limited All rights reserved.