工作负荷分析 (Workload Analysis)
概述
分析指定时间段内员工的工时和加班数据，按项目维度和员工维度输出统计报告。
默认仅统计项目名含「数字能源」的产品，其他项目自动过滤。数字能源运维（特殊班次）不参与排序，固定放最后。
工作流程
1. 交互引导
调用本 skill 时，必须依次引导用户输入（未提供则逐项询问）：
- 账号 — 中思互联 accountId
- 密码 — 登录密码
- 开始日期 — YYYY-MM-DD
- 结束日期 — YYYY-MM-DD
- 是否需要发送企业微信群 — 需提供 webhook URL
- 是否需要发送邮件 — 需提供 SMTP 配置 + 收件人
2. 执行分析
python3 scripts/workload_analysis.py \
--account "<账号>" \
--password "<密码>" \
--start "YYYY-MM-DD" \
--end "YYYY-MM-DD" \
--output json
| 参数 | 说明 |
|---|---|
--output json |
JSON 格式（推荐） |
--output text |
可读文本 |
--send-email <addr> |
发送邮件 |
--smtp-host / --smtp-port / --smtp-user / --smtp-password / --smtp-from |
SMTP 配置 |
3. 结果呈现
Agent 收到 JSON 后：
- 对话窗口：表格呈现三部分（项目 → Top 10 → Bottom 10）
- 企业微信群：通过 webhook POST Markdown 消息
- 邮件：脚本内置 HTML 表格 + 纯文本双版本；端口 465 走 SMTP_SSL，587 走 STARTTLS
4. 报告结构
| 部分 | 内容 |
|---|---|
| 按项目分析 | 人数、日均工时、日均加班、节假日加班人数、人均节假日加班、加班率 |
| Top 10 | 排名、员工、项目、日均工时、均上班、均下班、工作日OT、节假日OT、总OT |
| Bottom 10 | 同上 |
计算规则
详见 references/calculation_rules.md。核心：
| 项目 | 规则 |
|---|---|
| 打卡窗口 | 每天 05:00 ~ 次日 05:00 |
| 上班/下班 | 窗口内最早/最晚打卡 |
| 休息排除 | 午休 12:00-13:30 |
| 工作日加班 | 18:00 起至下班 |
| 非工作日加班 | 首末次打卡差值 |
| 节假日判定 | 2026 年国务院安排硬编码 + API 后备 |
| 项目过滤 | 仅含「数字能源」的产品 |
| 排序 | 日均加班 + 节假日加班率降序，运维固定最后 |
数据 API
| 步骤 | 接口 | 说明 |
|---|---|---|
| 1 | POST https://my.chinasie.com/certification/api/v1/certificate/login |
获取 token |
| 2 | POST https://ihr.chinasie.com/punch/api/v1/punch/attendance/punchdetail/list |
打卡明细（自动分页） |
| 3 | POST https://my.chinasie.com/datacenter/api/spot/findSpotManageInfo/0/200 |
员工→项目映射 |
Token 放在 Cookie: token=xxx 和 Authorization: Bearer xxx 中。
依赖
pip install requests
