first commit

2025-09-06 21:06:18 +08:00
commit 8083f136c9
94 changed files with 20559 additions and 0 deletions
--- a/note/快速启动指南.md
+++ b/note/快速启动指南.md
@@ -0,0 +1,193 @@
+# TSP智能助手 - 快速启动指南
+
+## 🚀 一键启动
+
+### 方法1: 使用综合管理平台（推荐）
+```bash
+python start_dashboard.py
+```
+访问: http://localhost:5000
+
+### 方法2: 使用原有启动方式
+```bash
+python start_web.py
+```
+
+## 📋 功能清单
+
+### ✅ 已整合的功能
+- [x] **仪表板** - 系统概览和性能监控
+- [x] **智能对话** - 实时聊天和工单创建
+- [x] **Agent管理** - Agent状态和工具管理
+- [x] **预警管理** - 预警监控和规则管理
+- [x] **知识库管理** - 知识检索和添加
+- [x] **工单管理** - 工单创建和状态跟踪
+- [x] **数据分析** - 性能分析和趋势展示
+- [x] **系统设置** - 参数配置和系统信息
+
+## 🎯 快速体验
+
+### 1. 启动系统
+```bash
+python start_dashboard.py
+```
+
+### 2. 访问主页
+打开浏览器访问: http://localhost:5000
+
+### 3. 体验功能
+1. **查看仪表板** - 了解系统整体状态
+2. **开始对话** - 测试智能对话功能
+3. **管理预警** - 查看和处理预警
+4. **浏览知识库** - 查看和添加知识
+5. **创建工单** - 测试工单管理功能
+
+## 🔧 配置说明
+
+### 环境要求
+- Python 3.8+
+- 已安装项目依赖
+- 数据库已初始化
+
+### 端口配置
+- 默认端口: 5000
+- 如需修改，编辑 `start_dashboard.py` 中的端口设置
+
+### 数据库配置
+- 默认使用SQLite数据库
+- 如需使用MySQL，修改 `src/config/config.py`
+
+## 📱 界面预览
+
+### 主界面布局
+```
+┌─────────────────────────────────────────────────────────┐
+│ TSP智能助手 - 综合管理平台                                │
+├─────────────┬───────────────────────────────────────────┤
+│ 控制面板    │ 主内容区                                   │
+│ • 仪表板    │ ┌─────────────────────────────────────────┐ │
+│ • 智能对话  │ │ 统计卡片 (活跃会话/预警/工单/知识)        │ │
+│ • Agent管理 │ ├─────────────────────────────────────────┤ │
+│ • 预警管理  │ │ 性能趋势图                              │ │
+│ • 知识库    │ ├─────────────────────────────────────────┤ │
+│ • 工单管理  │ │ 系统健康状态                            │ │
+│ • 数据分析  │ └─────────────────────────────────────────┘ │
+│ • 系统设置  │                                           │
+└─────────────┴───────────────────────────────────────────┘
+```
+
+## 🎨 界面特色
+
+### 现代化设计
+- 渐变色彩搭配
+- 圆角卡片设计
+- 动态效果过渡
+- 响应式布局
+
+### 直观操作
+- 侧边栏导航
+- 标签页切换
+- 模态框交互
+- 实时状态更新
+
+### 数据可视化
+- Chart.js图表
+- 进度条显示
+- 状态指示器
+- 趋势分析
+
+## 🔍 功能详解
+
+### 仪表板
+- **实时监控**: 系统健康状态、内存使用、CPU使用率
+- **统计概览**: 活跃会话、预警数量、工单状态、知识条目
+- **性能趋势**: 24小时性能变化图表
+- **快速操作**: 一键访问各功能模块
+
+### 智能对话
+- **实时聊天**: 基于WebSocket的即时通信
+- **知识库集成**: 自动检索相关知识
+- **工单创建**: 对话中直接创建工单
+- **快速操作**: 预设常用问题
+
+### Agent管理
+- **状态监控**: Agent运行状态和活跃目标
+- **工具管理**: 查看工具使用统计和成功率
+- **主动监控**: Agent主动发现和解决问题
+- **执行历史**: 查看Agent执行记录
+
+### 预警管理
+- **预警统计**: 按严重程度分类显示
+- **预警列表**: 实时显示活跃预警
+- **预警处理**: 一键解决预警问题
+- **规则管理**: 创建和管理预警规则
+
+### 知识库管理
+- **知识检索**: 搜索和浏览知识库
+- **知识添加**: 手动添加新知识
+- **统计分析**: 使用统计和置信度
+- **分类管理**: 按类别组织知识
+
+### 工单管理
+- **工单列表**: 查看和管理所有工单
+- **状态过滤**: 按状态和优先级筛选
+- **工单创建**: 创建新的工单
+- **统计分析**: 工单处理统计
+
+### 数据分析
+- **性能趋势**: 系统性能变化
+- **类别分布**: 问题类别分布图
+- **详细报告**: 综合分析报告
+- **智能推荐**: 基于分析的改进建议
+
+### 系统设置
+- **参数配置**: 调整系统运行参数
+- **模式切换**: 启用/禁用Agent模式
+- **系统信息**: 版本和运行状态
+- **设置保存**: 持久化配置
+
+## 🚨 注意事项
+
+### 首次使用
+1. 确保已安装所有依赖: `pip install -r requirements.txt`
+2. 初始化数据库: `python init_database.py`
+3. 配置API密钥: 编辑 `src/config/config.py`
+
+### 常见问题
+1. **端口被占用**: 修改端口或关闭占用进程
+2. **数据库错误**: 检查数据库连接和权限
+3. **API调用失败**: 检查网络连接和API密钥
+
+### 性能建议
+1. **内存使用**: 监控内存使用情况
+2. **数据库优化**: 定期清理历史数据
+3. **缓存策略**: 启用浏览器缓存
+
+## 📞 技术支持
+
+### 日志查看
+- 应用日志: `logs/dashboard.log`
+- 系统日志: `logs/tsp_assistant.log`
+
+### 调试模式
+```bash
+export FLASK_ENV=development
+python start_dashboard.py
+```
+
+### 问题反馈
+如遇到问题，请提供：
+1. 错误日志
+2. 操作步骤
+3. 系统环境
+4. 浏览器信息
+
+## 🎉 开始使用
+
+现在你已经了解了TSP智能助手综合管理平台的所有功能，可以开始体验这个强大的智能客服系统了！
+
+```bash
+python start_dashboard.py
+```
+
+访问 http://localhost:5000 开始你的智能客服之旅！