# AI-CS 智能客服系统 > 一个融合 AI 技术与人工客服的现代化智能客服解决方案 ## 🌐 在线演示 **Demo 站点**: https://demo.cscorp.top - **官网首页**: https://demo.cscorp.top - **访客聊天**: 点击首页右下角客服插件按钮 - **客服登录**: https://demo.cscorp.top/agent/login ## ✨ 核心特性 - 🤖 **AI 客服支持**：支持多厂商 AI 模型，可配置 API 和模型选择 - 👥 **人工客服**：实时在线状态显示，支持多客服协作 - 💬 **实时通信**：基于 WebSocket 的双向实时消息推送 - 📁 **文件传输**：支持图片、文档上传和预览 - 📚 **FAQ 管理**：知识库管理，关键词搜索 - 👤 **用户管理**：完整的用户权限管理系统 - 🎨 **现代化 UI**：基于 Shadcn UI 的响应式设计 - 🔌 **访客小窗插件**：可嵌入任何网站的客服小窗组件 - 🌐 **产品官网**：内置产品展示页面 ## 🚀 快速开始 ### 方式一：预构建镜像一键部署（推荐，最简单）⭐ > **最简单快捷的方式**，直接使用预构建的 Docker 镜像，无需构建，一行命令启动。 #### 前置要求 - Docker Desktop（Windows/Mac）或 Docker + Docker Compose（Linux） #### 部署步骤 1. **克隆项目并进入目录** ```bash git clone https://github.com/2930134478/AI-CS.git cd AI-CS ``` 2. **配置环境变量** ```bash # 复制环境变量模板 cp .env.example .env # 编辑 .env 文件，至少修改以下配置： # - MYSQL_ROOT_PASSWORD: MySQL root 密码 # - ADMIN_PASSWORD: 管理员密码（首次登录使用） # - ENCRYPTION_KEY: 加密密钥（生成 64 位十六进制字符串） ``` 生成加密密钥： ```bash # Linux/Mac openssl rand -hex 32 # Windows PowerShell -join ((48..57) + (97..102) | Get-Random -Count 64 | ForEach-Object {[char]$_}) ``` 3. **一键启动** ```bash # 使用预构建镜像启动（自动从 Docker Hub 拉取镜像） docker-compose -f docker-compose.prod.yml up -d ``` 就这么简单！🎉 4. **访问应用** - **前端首页**: http://localhost:3000 - **访客聊天**: http://localhost:3000/chat - **客服登录**: http://localhost:3000/agent/login - 用户名：`admin`（或 `.env` 中配置的 `ADMIN_USERNAME`） - 密码：`.env` 中配置的 `ADMIN_PASSWORD` #### 端口配置 **默认端口**：后端 `18080`，前端 `3000` **修改端口**：在 `.env` 文件中设置 `BACKEND_PORT` 和 `FRONTEND_PORT` ⚠️ **注意**：预构建镜像的图片加载已硬编码为 `18080` 端口，如需修改端口，请使用方式二（本地构建）重新构建镜像。 #### 常用命令 ```bash # 查看日志 docker-compose -f docker-compose.prod.yml logs -f # 查看服务状态 docker-compose -f docker-compose.prod.yml ps # 停止服务 docker-compose -f docker-compose.prod.yml stop # 停止并删除容器（保留数据） docker-compose -f docker-compose.prod.yml down # 完全重置（删除所有数据） docker-compose -f docker-compose.prod.yml down -v ``` --- ### 方式二：Docker 本地构建部署 > 适合需要自定义构建或网络无法访问 Docker Hub 的情况。 #### 前置要求 - Docker Desktop（Windows/Mac）或 Docker + Docker Compose（Linux） - Git #### 部署步骤 1. **克隆项目** ```bash git clone https://github.com/2930134478/AI-CS.git cd AI-CS ``` 2. **配置环境变量** ```bash # 复制环境变量模板 cp .env.example .env # 编辑 .env 文件，至少修改以下配置： # - MYSQL_ROOT_PASSWORD: MySQL root 密码 # - ADMIN_PASSWORD: 管理员密码（首次登录使用） # - ENCRYPTION_KEY: 加密密钥（生成 64 位十六进制字符串） ``` 生成加密密钥： ```bash # Linux/Mac openssl rand -hex 32 # Windows PowerShell -join ((48..57) + (97..102) | Get-Random -Count 64 | ForEach-Object {[char]$_}) ``` 3. **构建并启动服务** ```bash # 构建并启动所有服务（首次构建需要一些时间） docker-compose up -d --build # 查看日志 docker-compose logs -f # 查看服务状态 docker-compose ps ``` 4. **访问应用** - **前端首页**: http://localhost:3000 - **访客聊天**: http://localhost:3000/chat - **客服登录**: http://localhost:3000/agent/login - 用户名：`admin`（或 `.env` 中配置的 `ADMIN_USERNAME`） - 密码：`.env` 中配置的 `ADMIN_PASSWORD` #### 端口配置 **默认端口**：后端 `18080`，前端 `3000` **修改端口**：在 `.env` 文件中设置 `BACKEND_PORT` 和 `FRONTEND_PORT`，然后重新构建： ```bash docker-compose up -d --build ``` #### 常用命令 ```bash # 停止服务 docker-compose stop # 停止并删除容器（保留数据） docker-compose down # 完全重置（删除所有数据） docker-compose down -v # 查看日志 docker-compose logs -f backend docker-compose logs -f frontend ``` --- ### 方式三：传统部署（手动安装） #### 环境要求 - Go 1.24 或更高版本 - Node.js 18+ 和 npm/yarn - MySQL 8.0 或更高版本 #### 1. 克隆项目 ```bash git clone https://github.com/2930134478/AI-CS.git cd AI-CS ``` #### 2. 配置后端 ```bash cd backend # 创建 .env 文件 cat > .env << EOF # 数据库配置 DB_HOST=localhost DB_PORT=3306 DB_USER=root DB_PASSWORD=your_password DB_NAME=ai_cs # 管理员账号配置（必填） ADMIN_USERNAME=admin ADMIN_PASSWORD=your_admin_password # 服务器配置 SERVER_HOST=0.0.0.0 SERVER_PORT=18080 # 默认端口 18080，可修改 GIN_MODE=debug # 加密密钥（用于加密 AI API Keys，可选） ENCRYPTION_KEY=$(openssl rand -hex 32) EOF # 安装依赖 go mod tidy # 启动服务（默认端口 8080） go run main.go ``` > ⚠️ **重要**：`ADMIN_PASSWORD` 是必填项，如果不设置，系统不会创建默认管理员账号。 #### 3. 配置前端 ```bash cd frontend # 安装依赖 npm install # 启动开发服务器（默认端口 3000） npm run dev ``` **端口配置**： - 后端端口：修改 `backend/.env` 中的 `SERVER_PORT`（默认 `8080`） - 前端端口：启动时通过 `PORT` 环境变量修改，如 `PORT=4000 npm run dev` - 图片加载端口：创建 `frontend/.env.local`，设置 `NEXT_PUBLIC_BACKEND_PORT=你的后端端口` #### 4. 访问应用 - **官网首页**: http://localhost:3000 - **访客聊天**: - 直接访问：http://localhost:3000/chat - 或点击首页右下角的客服插件按钮 - **客服登录**: http://localhost:3000/agent/login #### 5. 默认管理员账号 ⚠️ **重要说明**： 系统会在首次启动时**自动创建**管理员账号（如果不存在），但**必须先在 `backend/.env` 文件中配置 `ADMIN_PASSWORD` 环境变量**。 **配置步骤**： 1. 在 `backend/.env` 文件中设置： ```env ADMIN_USERNAME=admin # 可选，默认为 admin ADMIN_PASSWORD=your_password # ⚠️ 必填，首次登录后请立即修改密码 ``` 2. 启动后端服务，系统会自动创建管理员账号 3. 使用配置的用户名和密码登录 **安全提示**： - 生产环境请使用强密码 - 首次登录后请立即修改密码 - `ADMIN_PASSWORD` 是必填项，如果不设置，系统不会创建管理员账号 ### 后端环境变量 在 `backend/.env` 中配置： ```env # 数据库配置 DB_HOST=localhost # 数据库主机 DB_PORT=3306 # 数据库端口 DB_USER=root # 数据库用户名 DB_PASSWORD=your_password # 数据库密码 DB_NAME=ai_cs # 数据库名称 # 管理员账号配置 ADMIN_USERNAME=admin # 管理员用户名（可选，默认为 admin） ADMIN_PASSWORD=your_admin_password # ⚠️ 管理员密码（必填） # 服务器配置 SERVER_HOST=0.0.0.0 # 服务器监听地址 SERVER_PORT=8080 # 服务器端口 GIN_MODE=debug # 运行模式（debug/release） # 加密密钥（用于加密 AI API Keys） ENCRYPTION_KEY=your_32_byte_key # 使用 openssl rand -hex 32 生成 ``` **重要提示**： - `ADMIN_PASSWORD` 是必填项，如果不设置，系统不会创建默认管理员账号 - 生产环境请使用强密码并设置 `GIN_MODE=release` ## 🔌 集成客服插件到你的网站 #### 步骤 1：在 HTML 中添加代码 在你的网站 HTML 的 `` 标签之前添加： ```html
``` #### 步骤 2：修改域名 将代码中的 `https://demo.cscorp.top` 替换为你的实际域名（部署 AI-CS 的域名）。 **示例**： ```html ``` ### 响应式设计 插件会自动适配不同设备： - **移动端**：小窗宽度自适应，最大高度优化 - **平板端**：中等尺寸窗口 - **桌面端**：完整尺寸窗口 ### 自定义样式 如果需要自定义样式，可以通过 CSS 覆盖： ```css /* 自定义浮动按钮 */ #ai-cs-toggle-btn { background-color: #your-color !important; width: 60px !important; height: 60px !important; } /* 自定义聊天窗口 */ #ai-cs-chat-iframe { border-radius: 16px !important; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25) !important; } ``` ## 🤝 贡献 欢迎提交 Issue 和 Pull Request！ ## 📄 许可证 [MIT](LICENSE) © 2025 2930134478 ## 🙏 致谢 感谢所有为这个项目做出贡献的开发者！ --- **最后更新**: 2025-01-12