# 晴玖客服系统

**Repository Path**: QtCodeCreators/customer-service

## Basic Information

- **Project Name**: 晴玖客服系统
- **Description**: 晴玖客服系统-多商户客服系统-免费客服系统
- **Primary Language**: Go
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://www.79tian.com
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2025-07-30
- **Last Updated**: 2025-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 客服系统, Go语言, 客服分配, 多商户, 多席位

## README

<div align="center">

# 晴玖客服系统

![Go Version](https://img.shields.io/badge/Go-1.19+-blue.svg)
![License](https://img.shields.io/badge/License-MIT-green.svg)
![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen.svg)
![Version](https://img.shields.io/badge/Version-2.1.1-orange.svg)

一个现代化、高性能的网页客服系统，采用Go语言开发，支持实时聊天、管理后台、AI智能客服、自动回复等功能。

[功能特性](#功能特性) • [技术栈](#技术栈) • [快速开始](#快速开始) • [项目地址](https://gitee.com/QtCodeCreators/customer-service/) • [下载地址](https://gitee.com/QtCodeCreators/customer-service/releases)

</div>


---

## 📋 项目概述

**在线客服系统** 是一个简单易用的网页客服系统，支持实时聊天功能。

程序详细介绍：【安装教程，图文介绍】 https://docs.qq.com/doc/DTmNLRmpLeWZRQmtZ

客服后台APP下载：https://pan.quark.cn/s/bffe63f8d3cd

购买或免费领取授权：https://www.79tian.com/#/products

**主要功能：**
- 💬 实时在线聊天
- 🤖 AI智能客服自动回复
- 👥 多客服管理
- 📝 关键词自动回复
- 📱 手机电脑都能用
- 宝塔面板一键安装

### 核心特性

- **💬 实时聊天**: 客户和客服可以实时对话
- **🤖 AI智能客服**: 支持多种AI大模型（阿里云、腾讯云、DeepSeek、SiliconFlow等），智能理解客户问题并自动回复
- **👥 多客服**: 可以添加多个客服账号，支持会话分配和转接
- **📝 消息记录**: 自动保存聊天记录，支持历史消息查询
- **🎯 智能体管理**: 支持创建和管理多个AI智能体，每个智能体可配置独立的系统提示词和工作流
- **📱 简单易用**: 界面简洁，操作方便，支持PC和移动端访问

## 🛠 技术栈

- **后端**: Go语言
- **数据库**: MySQL
- **前端**: JavaScript + HTML + CSS
- **部署**: 宝塔面板



## 🚀 快速开始

### 📦 推荐安装方式：宝塔面板部署（适合生产环境）

#### 1. 安装宝塔面板

**宝塔通用安装脚本：**
```bash
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec
```

#### 2. 安装必要组件

登录宝塔面板后，在「软件商店」中安装以下组件：
- **Nginx 1.28+** - Web服务器
- **MySQL 5.7+** - 数据库服务
- **Redis** - 缓存服务（应用商店安装最新版）

#### 3. 创建项目目录

在宝塔面板中：
1. 点击「文件」菜单
2. 进入 `/www/wwwroot` 目录
3. 创建新文件夹：`chat`

#### 4. 下载并部署程序

1. **创建项目目录并下载安装包**：
   ```bash
   # 创建项目目录（如果不存在）
   mkdir -p /www/wwwroot/chat
   cd /www/wwwroot/chat
   
   # 下载并解压程序安装包
   wget https://gitee.com/QtCodeCreators/customer-service/releases/download/v3.1.0/v3.1.0.zip
   unzip -j v3.1.0.zip -d /www/wwwroot/chat
   ```
   
   解压后会得到多个安装脚本（直接在`/www/wwwroot/chat`目录下）：
    - Linux系统：`download-linux.sh`
    - Windows系统：`download-windows.bat` 
    - macOS系统：`download-macos.sh`
    
    > 💡 **本教程以Linux系统为主**，Windows/macOS用户请使用对应脚本，使用方法与Linux类似。

2. **清理并执行安装脚本**：
   ```bash
   # 进入安装目录
   cd /www/wwwroot/chat
   # 清理其他脚本，只保留download-linux.sh
   rm -f download-windows.bat download-macos.sh
   
   # 赋予执行权限并执行
   chmod +x download-linux.sh
   ./download-linux.sh
   ```
   脚本会自动：
   - 检测系统架构
   - 下载对应的程序安装包
   - 自动解压到当前目录（/www/wwwroot/chat）
   - 设置程序文件执行权限

#### 5. 配置Go项目

在宝塔面板中：
1. 点击「网站」菜单
2. 选择「Go项目」
3. 点击「添加项目」
4. 填写以下信息：
   - **项目可执行程序**：选择解压后的程序文件 `customer-service`
   - **端口**：填写 `8180`
   - **勾选「放行端口」**（如果不勾选，需要配置域名访问）
   - **勾选「开机启动」**
5. 点击「确定」完成项目添加

#### 6. 配置数据库

1. 在宝塔面板「数据库」中创建新数据库：
   - 数据库名：`chat`
   - 用户名：`chat`
   - 密码：自定义强密码

2. 修改程序配置文件：
   ```bash
   cd /www/wwwroot/chat
   vim config.yaml
   ```
   
   更新数据库配置：
   ```yaml
   database:
     host: "127.0.0.1"
     port: 3306
     user: "chat"
     password: "你的数据库密码"
     dbname: "chat"
   ```

#### 7. 启动服务

在宝塔面板的「Go项目」中找到刚添加的项目，点击「启动」按钮。

#### 8. 访问系统

- **客户端访问**：`http://你的服务器IP:8180`
- **客服后台**：`http://你的服务器IP:8180/admin`
- **超级管理员后台**：`http://你的服务器IP:8180/super-admin`
- **商户后台**：`http://你的服务器IP:8180/merchant`

#### 9. 默认账号密码

**超级管理员账号**（用于系统管理和配置）：
- 访问地址：`/super-admin`
- 用户名：`admin`
- 密码：`123456`

**商户后台账号**（用于商户测试）：
- 访问地址：`/merchant`
- 用户名：`test`
- 密码：`123456`

**客服账号**（用于日常客服工作）：
- 访问地址：`/admin`
- 用户名：`service`
- 密码：`123456`

⚠️ **安全提醒**：首次登录后请立即修改默认密码，确保系统安全！

#### 10. 配置域名访问（可选）

**推荐方案：宝塔面板一键配置**

如果你有域名，宝塔面板提供了最简单的域名绑定方式：
1. 在宝塔面板「网站」→「Go项目」中，找到你的项目
2. 点击「设置」→「域名管理」，添加你的域名
3. 系统会自动配置反向代理，无需手动操作，SSL证书的话也可以一键申请

**其他部署方式参考**

如果你使用其他部署方式：
- **Supervisor部署**：需手动配置Nginx反向代理到 `127.0.0.1:8180`
- **Docker部署**：推荐使用1Panel面板，支持一键域名绑定

💡 **提示**：宝塔面板的域名配置最简便，建议优先使用宝塔方案。

---

## 🤖 AI智能客服功能

### 功能概述

系统内置强大的AI智能客服功能，支持多种AI大模型接入，可以智能理解客户问题并提供自动回复，大幅提升客服效率和用户体验。

### 核心能力

#### 1. 多AI渠道支持
- **阿里云通义千问**: 支持阿里云大模型服务
- **腾讯云混元**: 支持腾讯云混元大模型
- **DeepSeek**: 支持DeepSeek大模型服务
- **SiliconFlow**: 支持SiliconFlow平台模型
- **自定义渠道**: 支持OpenAI兼容协议的任意AI服务

#### 2. AI智能体管理
- **创建智能体**: 为不同业务场景创建专属AI智能体
- **系统提示词**: 自定义智能体的角色、行为和工作方式
- **工作流配置**: 配置数据源和工作流，让AI获取上下文信息
- **多智能体支持**: 支持同时管理多个智能体，按需切换使用

#### 3. 智能回复策略
- **优先级机制**: 
  - 优先使用AI智能体回复
  - AI失败时自动降级到关键词自动回复
  - 确保客户问题总能得到响应
- **会话级防抖**: 智能聚合短时间内的多条消息，避免重复回复
- **上下文理解**: AI可以读取会话历史，提供连贯的对话体验

#### 4. 灵活的配置方式
- **网站分组级别**: 为不同网站分组配置独立的AI智能体
- **会话级别**: 支持在会话中动态开启/关闭AI功能
- **商户级别**: 支持商户级别的AI权限和余额管理

### 使用指南

#### 第一步：配置AI渠道

1. 登录超级管理员后台 (`/super-admin`)
2. 进入「AI渠道管理」页面
3. 点击「新增渠道」，填写以下信息：
   - **渠道名称**: 如"阿里云通义千问"
   - **渠道类型**: 选择对应的AI服务商
   - **API地址**: 填写API接口地址
   - **API密钥**: 填写您的API密钥
   - **模型名称**: 选择要使用的模型（如"qwen-plus"）
4. 点击「测试连接」验证配置是否正确
5. 保存配置

#### 第二步：创建AI智能体

1. 进入「AI智能体管理」页面
2. 点击「创建智能体」
3. 填写基本信息：
   - **智能体名称**: 如"售前客服助手"
   - **智能体描述**: 描述智能体的用途
   - **系统提示词**: 定义智能体的角色和行为，例如：
     ```
     你是一个专业的售前客服助手，负责解答客户的产品咨询问题。
     请保持友好、专业的态度，准确回答客户的问题。
     ```
4. 选择AI渠道和模型
5. 配置参数（温度、最大Token数等）
6. （可选）配置数据源工作流，让AI获取更多上下文信息
7. 保存并启用智能体

#### 第三步：配置网站分组

1. 进入「网站分组管理」页面
2. 选择要配置的分组，点击「编辑」
3. 在「AI智能体配置」区域：
   - 开启「启用智能体」开关
   - 选择要使用的智能体（可多选）
   - （可选）设置默认智能体
4. 保存配置

#### 第四步：测试AI回复

1. 打开客户端聊天页面
2. 发送测试消息，如"你好，我想了解一下产品"
3. AI智能体会自动识别并回复
4. 在客服后台可以查看AI回复的详细日志和调试信息

### 高级功能

#### 工作流配置
AI智能体支持丰富的工作流配置，可以：
- **读取会话历史**: 让AI了解对话上下文
- **查询自动回复规则**: 参考已有的回复规则
- **数据库查询**: 查询业务数据（开发中）
- **API数据获取**: 调用外部API获取信息（开发中）

#### 数据源配置示例

```json
{
  "sources": [
    {
      "type": "current_session_messages",
      "config": {
        "message_count": 10,
        "order_by": "desc"
      }
    },
    {
      "type": "auto_reply_data",
      "config": {
        "keywords": ["价格", "费用"],
        "limit": 5
      }
    }
  ]
}
```

### 注意事项

⚠️ **重要提示**：
- AI回复功能需要配置有效的AI渠道和API密钥
- 建议在测试环境充分测试后再用于生产环境
- 定期检查AI回复质量，优化系统提示词
- 关注API调用成本，合理设置使用限制

### 更多帮助

- 🔧 **配置参考**: 系统设置页面 (`/super-admin/settings`) 中的AI配置说明
- 💬 **问题反馈**: 如遇问题，请查看系统日志或联系技术支持

---

## 📞 联系我们

如有问题或建议，请联系我们：
- **客服QQ**: 1186258278
- **反馈邮箱**: keh5@vip.qq.com
- **反馈微信**: CodeCreator
- **项目地址**: https://gitee.com/QtCodeCreators/customer-service/
- **下载地址**: https://gitee.com/QtCodeCreators/customer-service/releases

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！