wecom_it_smart_desk/docs/05-用户手册/会话存档功能-操作手册.md

会话存档功能 - 操作手册

版本: v1.0 | 日期: 2026-07-15 | 状态: 已完成

---

1. 功能概述

会话存档功能用于管理 IT 智能服务台的会话历史数据，通过自动归档策略优化系统性能，同时满足合规审计需求。

1.1 核心特性

• 自动归档：已结单会话超过 90 天自动标记为已归档
• 分级存储：热数据（90天内）/ 冷数据（90天外）
• 审计支持：管理后台可查看完整会话历史

---

2. 坐席端操作指南

2.1 历史会话显示规则

坐席端历史会话按以下规则显示：

层级	显示内容	位置
当前会话	活跃会话（排队/服务中/待关闭）	顶部"我的会话"
历史会话	≤90天已结单会话	"历史会话"标签
更久历史	不显示	—

2.2 查看更早会话

问题：坐席端看不到 90 天前的历史会话

解决方案：

1. 访问管理后台
2. 进入「会话审计」页面
3. 使用筛选功能查找历史会话

---

3. 管理后台操作指南

3.1 访问会话审计

URL: https://itsupport.servyou.com.cn/itadmin/
路径: 会话管理 → 会话审计

3.2 按归档状态筛选

1. 进入会话审计页面
2. 找到「归档」筛选下拉框
3. 选择筛选条件：
   • 全部
   • 未归档
   • 已归档

3.3 查看归档会话详情

1. 在会话列表中找到已归档的会话（显示「已归档」标签）
2. 点击会话行查看详情
3. 可查看完整的会话消息历史

3.4 筛选条件组合

场景	状态	归档	日期范围
查看所有历史会话	resolved	全部	—
查看近期会话	resolved	未归档	近90天
查看归档会话	resolved	已归档	90天前

---

4. 运维操作指南

4.1 定时任务配置

归档脚本通过 crontab 定时执行：

# 编辑 crontab
crontab -e

# 添加以下行（每天凌晨3点执行）
0 3 * * * cd /opt/wecom-it-desk/backend && python scripts/archive_sessions.py >> /var/log/itdesk-archive.log 2>&1

4.2 手动执行归档

# SSH 到服务器
ssh sxn@10.212.189.210

# 进入后端目录
cd /opt/wecom-it-desk/backend

# 执行归档脚本
python scripts/archive_sessions.py

4.3 查看归档日志

# 查看归档日志
tail -f /var/log/itdesk-archive.log

# 查看历史归档记录
cat /var/log/itdesk-archive.log | grep归档

4.4 日志示例

[2026-07-15 03:00:00] 开始执行会话归档任务...
[2026-07-15 03:00:00] 归档阈值: 90 天
[2026-07-15 03:00:00] 找到 15 个需要归档的会话
[2026-07-15 03:00:01] 成功归档 15 个会话
[2026-07-15 03:00:01] 归档时间: 2026-07-15T03:00:01+00:00

---

5. 常见问题

5.1 坐席端看不到历史会话

原因：会话已超过 90 天，已自动归档

解决：到管理后台查看

5.2 归档状态筛选不生效

检查：

1. 确认筛选条件填写正确
2. 尝试清除筛选条件查看全部

5.3 归档脚本执行失败

常见原因：

1. 数据库连接失败
2. Python 依赖缺失

解决：

1. 检查数据库配置
2. 确认已安装依赖：pip install -r requirements.txt

---

6. 版本历史

版本	日期	变更
v1.0	2026-07-15	初始版本