泛微客服邮件发送效率监控大屏

功能概述

从泛微 e-cology OA 系统自动拉取邮件群发列表数据，生成可视化监控大屏：

日历热力图：3个月日历视图，直观展示每日发送密度
迟发/漏发统计：迟发（首日之后才发送）橙色标记，漏发（完全未发送）红色脉冲标记
组织级联筛选：大区→分部→部门→客服经理→客服人员，支持反向回填
发送时段分析：同期发送时间线、效率排名、发送时段分布
OA实时刷新：一键从OA拉取最新数据，Cookie过期自动弹出扫码登录
定时自动刷新：可选15/30/60分钟自动从OA更新数据

使用方式

方式一：对话触发（推荐）

在 WorkBuddy 对话中输入触发词（如"打开邮件发送监控大屏"），AI 会自动执行以下步骤：

检查依赖（Python 3、requests、playwright）
启动本地 HTTP 服务器
首次使用时弹出扫码登录窗口
从泛微OA拉取数据并生成大屏
在浏览器中打开大屏页面

方式二：手动启动

# 1. 进入技能目录
cd <skill_root>

# 2. 启动服务器
python3 server.py 8765

# 3. 浏览器打开
# http://localhost:8765/calendar_view.html

首次使用流程

点击「🔄 从OA刷新」按钮
系统检测到无Cookie → 自动弹出浏览器窗口显示泛微OA登录页
用企业微信扫码登录
登录成功后自动关闭浏览器，开始拉取数据
数据拉取完成后大屏自动刷新

文件结构

<skill_root>/
├── SKILL.md                    # 本文件
├── server.py                   # HTTP服务器（带刷新API端点）
├── refresh_data.py             # 一键刷新脚本（串联fetch+rebuild+login）
├── calendar_view.html          # 日历视图大屏（主页面）
├── journal_monitor.html        # 原版大屏（图表视图）
├── echarts.min.js              # ECharts图表库（离线可用）
├── scripts/
│   ├── fetch_full.py           # 从泛微OA API拉取数据
│   ├── rebuild2.py             # 重建report_data.json + HTML
│   └── ecology_login.py        # 泛微OA扫码登录脚本
├── docs/
│   └── guide.html              # HTML说明文档+效果展示
└── assets/                     # 资源文件

依赖

Python 3.8+（自动检测，无需手动安装）
requests（自动安装：pip install requests）
playwright（扫码登录时需要，自动安装：pip install playwright + python -m playwright install chromium）
泛微OA账号（需要能访问邮件群发列表和客服人员列表的权限）

跨平台支持

macOS / Linux / Windows 均可使用
Python 路径自动检测（使用 sys.executable）
依赖包自动安装（首次运行时检测并安装缺失的包）
Playwright 浏览器自动安装（首次扫码登录时）

API端点

服务器启动后提供以下端点：

| 端点 | 方法 | 说明 | |------|------|------| | /calendar_view.html | GET | 日历视图大屏 | | /journal_monitor.html | GET | 图表视图大屏 | | /api/refresh | POST | 触发从OA拉取最新数据 | | /api/status | GET | 查看刷新状态（含need_login标记） | | /api/qr | GET | 获取登录二维码截图 |

注意事项

首次使用需要扫码登录泛微OA，确保网络能访问 www.e-cology.com.cn
Cookie 有效期有限，过期后系统会自动提示重新扫码
数据拉取约需15-30秒（取决于数据量）
服务器默认端口 8765，可通过参数修改：python3 server.py 9000
迟发/漏发统计已排除离职人员（只在其在职期间的期次计算）