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

# 企业微信机器人数据库说明 ## 数据库文件说明 ### 1. install.sql（推荐用于新安装） **位置**: `app/Database/install.sql` **说明**: 完整的系统数据库，包含所有功能模块： - 系统基础表 - 用户与组织 - 知识空间与文档 - AI功能 - API服务 - **企业微信机器人系统**（包含所有高级功能） **适用场景**: - 全新安装系统 - 需要完整功能的部署 **安装方法**: ```bash 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` - 全局配置表 **适用场景**: - 已有系统，只需添加企业微信机器人功能 - 单独部署企业微信机器人模块 **安装方法**: ```bash 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：重新创建表（推荐）** ```sql -- 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：手动添加字段** ```sql -- 修改机器人表 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 中的其他表） ``` ## 注意事项 1. **数据备份**: 升级前务必备份数据库 2. **字段冲突**: 如果执行ALTER TABLE时提示字段已存在，说明您的数据库已经是最新版本 3. **索引优化**: 新版本添加了多个索引以提升查询性能 4. **默认配置**: 安装后会自动插入默认全局配置，可在后台管理界面修改 ## 功能特性 ### 已实现功能 ✅ 私聊和群@回复 ✅ 用户历史记录和个性化回复 ✅ 全局配置管理 ✅ 群聊支持 ✅ 消息类型扩展 ✅ 定时任务表结构 ### 待实现功能 ⏳ 定时任务管理界面 ⏳ 定时任务执行逻辑 ⏳ 全局配置管理UI ⏳ 腾讯云混元大模型集成 ⏳ 侧边栏助手H5页面 ⏳ 后台UI更新（群聊、用户历史等配置） ## 技术支持 如有问题，请查看： - `docs/企业微信机器人安装指南.md` - `docs/企业微信机器人使用说明.md` - `docs/企业微信机器人开发完成清单.md`