企业微信机器人数据库说明
========================

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

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

企业微信机器人数据库说明数据库文件说明1. install.sql（推荐用于新安装）
位置: app/Database/install.sql说明: 完整的系统数据库，包含所有功能模块：
系统基础表
用户与组织
知识空间与文档
AI功能
API服务
企业微信机器人系统（包含所有高级功能）

适用场景: 
全新安装系统
需要完整功能的部署

安装方法:
mysql -u用户名 -p 数据库名 < app/Database/install.sql
2. wework_bot.sql（独立安装选项）
位置: app/Database/wework_bot.sql说明: 仅包含企业微信机器人相关的6张表：
wework_bot - 机器人配置表
wework_conversation - 对话日志表
wework_user_history - 用户对话历史表
wework_user_profile - 用户画像表
wework_schedule_task - 定时任务表
wework_global_config - 全局配置表

适用场景:
已有系统，只需添加企业微信机器人功能
单独部署企业微信机器人模块

安装方法:
mysql -u用户名 -p 数据库名 < app/Database/wework_bot.sql
数据库表结构核心表说明#### wework_bot（机器人配置表）
存储机器人的基本配置信息，包括：
企业微信应用凭证（corp_id |  agent_id |  secret等）
AI配置（模型、提示词、置信度阈值）
工作模式和时间设置
新增字段：
  - support_group_chat - 支持群聊
  - use_global_config - 使用全局配置
  - enable_user_history - 启用用户历史
  - history_context_length - 历史上下文长度#### wework_conversation（对话日志表）
记录所有对话历史，包括：
用户问题和AI回答
置信度和响应时间
新增字段：
  - message_type - 消息类型（text/image/file等）
  - chat_type - 聊天类型（single私聊/group群聊）
  - room_id - 群聊ID#### wework_user_history（用户对话历史表）
存储每个用户的历史对话，用于个性化回复：
按用户ID和机器人ID分组
保存问答对和上下文信息
支持历史对话检索

#### wework_user_profile（用户画像表）
用户行为分析和画像：
总对话数、平均置信度
用户偏好和标签
最后对话时间

#### wework_schedule_task（定时任务表）
定时批量发送功能：
支持多个机器人账号批量操作
支持一次性、每天、每周、每月调度
可指定目标用户或全员广播

#### wework_global_config（全局配置表）
全局默认配置：
默认工作模式
默认AI配置
默认回复配置
腾讯云混元大模型配置
群聊配置
用户历史配置

升级说明从旧版本升级如果您之前安装了企业微信机器人功能，现在需要升级到新版本：方案1：重新创建表（推荐）
-- 1. 备份现有数据
CREATE TABLE wework_bot_backup AS SELECT * FROM wework_bot;
CREATE TABLE wework_conversation_backup AS SELECT * FROM wework_conversation;-- 2. 删除旧表
DROP TABLE IF EXISTS wework_bot;
DROP TABLE IF EXISTS wework_conversation;-- 3. 导入新表结构
SOURCE app/Database/wework_bot.sql;-- 4. 恢复数据（根据实际字段调整）
INSERT INTO wework_bot SELECT * FROM wework_bot_backup;
INSERT INTO wework_conversation SELECT * FROM wework_conversation_backup;
方案2：手动添加字段
-- 修改机器人表
ALTER TABLE wework_bot 
ADD COLUMN support_group_chat tinyint(1) DEFAULT 1 COMMENT '支持群聊' AFTER status | 
ADD COLUMN use_global_config tinyint(1) DEFAULT 0 COMMENT '使用全局配置' AFTER support_group_chat | 
ADD COLUMN enable_user_history tinyint(1) DEFAULT 1 COMMENT '启用用户历史' AFTER use_global_config | 
ADD COLUMN history_context_length int(11) DEFAULT 5 COMMENT '历史上下文长度' AFTER enable_user_history;-- 修改对话记录表
ALTER TABLE wework_conversation
ADD COLUMN message_type varchar(20) DEFAULT 'text' COMMENT '消息类型' AFTER user_name | 
ADD COLUMN chat_type varchar(20) DEFAULT 'single' COMMENT '聊天类型' AFTER message_type | 
ADD COLUMN room_id varchar(100) DEFAULT NULL COMMENT '群聊ID' AFTER chat_type;-- 创建新表（执行 wework_bot.sql 中的其他表）
注意事项数据备份: 升级前务必备份数据库
字段冲突: 如果执行ALTER TABLE时提示字段已存在，说明您的数据库已经是最新版本
索引优化: 新版本添加了多个索引以提升查询性能
默认配置: 安装后会自动插入默认全局配置，可在后台管理界面修改功能特性已实现功能
✅ 私聊和群@回复  
✅ 用户历史记录和个性化回复  
✅ 全局配置管理  
✅ 群聊支持  
✅ 消息类型扩展  
✅ 定时任务表结构  待实现功能
⏳ 定时任务管理界面  
⏳ 定时任务执行逻辑  
⏳ 全局配置管理UI  
⏳ 腾讯云混元大模型集成  
⏳ 侧边栏助手H5页面  
⏳ 后台UI更新（群聊、用户历史等配置）  技术支持如有问题，请查看：
docs/企业微信机器人安装指南.md
docs/企业微信机器人使用说明.md
docs/企业微信机器人开发完成清单.md