交付文档-企业微信智能客服系统
==============================

作者: 系统管理员
更新时间: 2026-03-24 04:20:56

----------------------------------------

企业微信智能客服系统 - 交付文档项目名称：企业微信智能客服系统  
交付日期：2026年1月22日  
版本号：v1.0  
客户：[客户公司名称]一、项目概述本系统是一套基于企业微信的智能客服解决方案，员工或客户通过企业微信与机器人对话，系统自动从知识库中检索相关内容并生成回答。管理员通过后台管理知识库、查看对话记录、分析统计数据。核心功能：
企业微信机器人（支持私聊和群聊）
知识库管理（文档管理、批量导入）
智能问答（RAG技术，语义检索+AI生成）
后台管理（机器人配置、对话记录、统计分析）
定时推送（定时发送通知消息）

二、系统功能清单2.1 企业微信机器人| 功能 | 说明 | 状态 |
|------|------|------|
| 机器人管理 | 创建、编辑、删除机器人，支持多个机器人 | ✅ 已完成 |
| 私聊支持 | 用户私聊机器人，自动回复 | ✅ 已完成 |
| 群聊支持 | 群聊中@机器人，自动回复 | ✅ 已完成 |
| 消息接收 | 接收企业微信推送的消息 | ✅ 已完成 |
| 消息发送 | 向企业微信发送回复消息 | ✅ 已完成 |
| 上下文记忆 | 记住用户最近的对话，实现连续对话 | ✅ 已完成 |
| 回调URL | 自动生成企业微信回调地址 | ✅ 已完成 |使用场景：
员工在企业微信中向机器人提问，机器人自动回答
群聊中@机器人，机器人回复问题
支持创建多个机器人，服务不同部门

2.2 知识库管理| 功能 | 说明 | 状态 |
|------|------|------|
| 文档管理 | 创建、编辑、删除文档 | ✅ 已完成 |
| 分类管理 | 文档分类，便于管理 | ✅ 已完成 |
| 批量导入 | 支持批量导入txt、md、html文件 | ✅ 已完成 |
| 文档搜索 | 搜索文档标题和内容 | ✅ 已完成 |
| 向量索引 | 自动建立向量索引，提高检索准确度 | ✅ 已完成 |使用场景：
整理公司的产品手册、FAQ、操作指南等文档
批量导入现有文档
按分类管理不同类型的知识

2.3 智能问答（RAG）| 功能 | 说明 | 状态 |
|------|------|------|
| 语义检索 | 根据问题检索相关文档 | ✅ 已完成 |
| AI生成回答 | 基于检索到的文档生成回答 | ✅ 已完成 |
| 多AI支持 | 支持火山方舟、腾讯云混元 | ✅ 已完成 |
| Embedding切换 | 支持火山方舟、腾讯云、关键词匹配 | ✅ 已完成 |
| 上下文管理 | 结合历史对话生成回答 | ✅ 已完成 |工作原理：
用户提问
系统在知识库中检索相关文档（Top 5）
将文档内容和问题发送给AI
AI生成回答
返回给用户2.4 后台管理| 功能 | 说明 | 状态 |
|------|------|------|
| 管理员登录 | 后台登录验证 | ✅ 已完成 |
| 机器人管理 | 管理所有机器人 | ✅ 已完成 |
| 知识库管理 | 管理文档和分类 | ✅ 已完成 |
| 对话记录 | 查看所有对话记录 | ✅ 已完成 |
| 统计分析 | 对话量、热门问题等统计 | ✅ 已完成 |
| AI配置 | 配置火山方舟、腾讯云混元 | ✅ 已完成 |
| Embedding配置 | 配置向量化服务 | ✅ 已完成 |
| 全局配置 | 配置默认参数 | ✅ 已完成 |
| 系统设置 | 站点信息、数据备份 | ✅ 已完成 |2.5 定时推送| 功能 | 说明 | 状态 |
|------|------|------|
| 定时任务管理 | 创建、编辑、删除定时任务 | ✅ 已完成 |
| 多种调度 | 支持一次性、每天、每周、每月 | ✅ 已完成 |
| 批量发送 | 支持向多个用户发送 | ✅ 已完成 |
| 立即执行 | 可以立即执行任务测试 | ✅ 已完成 |使用场景：
每天早上发送日报
每周发送周报
定期发送通知消息

三、技术架构3.1 技术栈后端
框架：CodeIgniter 4
语言：PHP 7.4+
数据库：MySQL 5.7+

前端
UI框架：Layui
JavaScript：jQuery
图表：ECharts

第三方服务
企业微信API
火山方舟AI（可选）
腾讯云混元AI（可选）

3.2 数据库表系统共11张核心表：wework_bot - 机器人配置
wework_conversation - 对话记录
wework_user_history - 用户对话历史
wework_user_profile - 用户画像
wework_schedule_task - 定时任务
wework_global_config - 全局配置
kb_document - 知识库文档
kb_category - 文档分类
kb_embedding - 向量索引
cms_admin - 管理员
cms_config - 系统配置详细表结构见：app/Database/install.sql3.3 目录结构project/
├── app/                      # 应用代码
│   ├── Controllers/          # 控制器
│   │   ├── Admin/           # 后台管理
│   │   ├── OpenApi/         # API接口
│   │   └── Wework.php       # 企业微信回调
│   ├── Views/               # 视图文件
│   │   └── admin/           # 后台页面
│   ├── Libraries/           # 类库
│   │   ├── EmbeddingService.php
│   │   └── ...
│   ├── Commands/            # CLI命令
│   │   └── WeworkSchedule.php
│   └── Database/            # 数据库文件
│       └── install.sql
├── public/                  # 公开目录
│   ├── index.php           # 入口文件
│   ├── layui/              # UI框架
│   └── ...
├── writable/               # 可写目录
│   ├── logs/              # 日志
│   └── config/            # 配置文件
└── docs/                  # 文档
四、部署说明4.1 服务器要求最低配置
CPU：2核
内存：4GB
硬盘：50GB
带宽：5Mbps
系统：Linux（推荐CentOS 7+或Ubuntu 18.04+）

软件环境
PHP 7.4+（需要扩展：mysqli |  mbstring |  json |  curl）
MySQL 5.7+
Nginx 或 Apache
SSL证书（HTTPS）

4.2 安装步骤1. 上传代码
# 上传代码到服务器
cd /www/wwwroot/
unzip project.zip
2. 配置数据库
# 创建数据库
mysql -uroot -p
CREATE DATABASE wework_kb DEFAULT CHARSET utf8mb4;导入数据库
mysql -uroot -p wework_kb < app/Database/install.sql
3. 配置系统
# 复制配置文件
cp env .env编辑配置
vi .env
修改以下配置：
database.default.hostname = localhost
database.default.database = wework_kb
database.default.username = root
database.default.password = 你的密码
4. 配置权限
chmod -R 755 /www/wwwroot/project
chmod -R 777 /www/wwwroot/project/writable
5. 配置Nginx
server {
    listen 80;
    server_name yourdomain.com;
    root /www/wwwroot/project/public;
    index index.php;    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}
6. 配置定时任务
crontab -e
添加：
    * cd /www/wwwroot/project && php spark wework:schedule
7. 访问系统
后台地址：https://yourdomain.com/admin
默认账号：admin
默认密码：admin123

详细安装步骤见：docs/企业微信机器人安装指南.md五、使用说明5.1 配置AI服务系统支持两种AI服务，至少配置一种：方案1：火山方舟（推荐）
登录后台 → 火山方舟
填写API Key和Endpoint ID
点击"测试连接"
添加文本模型方案2：腾讯云混元
登录后台 → 腾讯云AI
填写Secret ID和Secret Key
选择模型
点击"测试连接"5.2 配置Embedding（可选）Embedding用于提高检索准确度，可选配置：登录后台 → Embedding配置
选择服务商：
   - 火山方舟Embedding（推荐）
   - 腾讯云混元Embedding
   - 关键词匹配（免费，但准确度较低）
填写配置信息
点击"测试"5.3 创建机器人登录后台 → 企业微信 → 机器人管理
点击"添加机器人"
填写基本信息：
   - 机器人名称
   - 机器人标识（英文，如：customer-service）
填写企业微信配置：
   - 企业ID（在企业微信后台"我的企业"中查看）
   - 应用ID（在应用详情页查看）
   - 应用Secret（在应用详情页查看）
   - Token（自定义，如：abc123）
   - EncodingAESKey（在企业微信后台生成）
配置知识库：
   - 选择知识空间
   - 选择AI模型
   - 填写系统提示词
保存后，复制回调URL5.4 配置企业微信登录企业微信管理后台
进入应用详情页
找到"接收消息"设置
填入：
   - URL：系统生成的回调URL
   - Token：机器人配置中的Token
   - EncodingAESKey：机器人配置中的EncodingAESKey
保存5.5 导入知识库方法1：手动创建
登录后台 → 知识库 → 文档管理
点击"添加文档"
填写标题、分类、内容
保存方法2：批量导入
登录后台 → 知识库 → 批量导入
上传文件（支持txt、md、html）
系统自动导入并建立索引详细使用说明见：docs/企业微信机器人使用说明.md六、功能演示6.1 对话效果用户在企业微信中提问：
用户：你们的产品怎么收费？机器人：
我们的产品采用按需付费模式：基础版：免费
   - 支持100个文档
   - 1个机器人标准版：¥299/月
   - 支持1000个文档
   - 3个机器人企业版：¥999/月
   - 无限文档
   - 无限机器人详情请查看产品价格说明。
6.2 后台界面主要页面：
首页仪表盘：显示今日对话数、总对话数、活跃机器人等
机器人管理：列表显示所有机器人，可编辑配置
知识库管理：文档列表，支持搜索、编辑、删除
对话记录：查看所有对话，可按机器人、用户、时间筛选
统计分析：对话趋势图、热门问题排行

七、常见问题Q1：机器人不回复消息？
检查：
机器人状态是否启用
企业微信回调URL是否配置正确
Token和EncodingAESKey是否匹配
查看系统日志：writable/logs/Q2：回答不准确？
优化方法：
补充相关知识库文档
优化文档内容质量
启用Embedding提高检索准确度
调整系统提示词Q3：如何查看日志？
日志位置：
系统日志：writable/logs/log-{date}.log
对话记录：后台 → 企业微信 → 对话记录

Q4：如何备份数据？
登录后台 → 系统配置 → 系统设置
点击"立即备份"
下载备份文件Q5：支持多少并发用户？
根据服务器配置：
2核4G：支持100+并发
4核8G：支持500+并发
8核16G：支持1000+并发

八、交付清单8.1 源码文件
✅ 完整PHP源代码
✅ 数据库结构文件（install.sql）
✅ 配置文件模板（.env.example）

8.2 文档资料
✅ 安装部署文档
✅ 使用说明文档
✅ 数据库说明文档
✅ 功能开发清单
✅ 本交付文档

8.3 技术支持
✅ 1个月免费技术支持
✅ 微信/邮件响应
✅ 远程协助（如需要）

九、验收标准9.1 功能验收[ ] 能够创建机器人并配置企业微信
[ ] 能够接收企业微信消息
[ ] 能够自动回复消息
[ ] 支持私聊对话
[ ] 支持群聊@回复
[ ] 能够创建和管理知识库文档
[ ] 能够批量导入文档
[ ] 能够智能回答问题
[ ] 能够查看对话记录
[ ] 能够查看统计数据
[ ] 能够配置AI服务
[ ] 能够创建定时任务

9.2 性能验收[ ] 消息响应时间