Clawhong 群健康监控

要解决的问题

团队协作群里，谁在线、谁在干活、活儿卡在哪，往往只能靠肉眼翻聊天记录。人多了以后，"某个工人是不是掉线了""今天大家到底完成了多少任务"这类问题很难快速回答。等到发现进度异常时，往往已经过去了几个小时。这个技能就是用来把这类"看人"的工作自动化掉。

核心能力

在线率监控

• 依据每个工人的 lastActive 时间判断状态
• 超过 30 分钟（IDLE_THRESHOLD，默认 1800 秒）未活跃标记为 idle
• 超过 2 小时（OFFLINE_THRESHOLD，默认 7200 秒）未活跃标记为 offline

任务完成率

• 当日完成率按 todayDone / (todayDone + pending) 计算
• 完成率低于 3 标记为低效
• todayDone = 0 且 pending > 0 标记为零产出

响应延迟

• 统计 inbox 任务从创建到进入 inProgress / done 的时间差
• 超过 1 小时（DELAY_WARN）未处理标记为延迟
• 超过 4 小时（DELAY_CRIT）未处理标记为严重延迟

三级告警机制

| 级别 | 触发条件 |
|------|----------|
| CRITICAL | 多人同时 offline，或零产出人数超过半数 |
| WARN | 单人零产出、任务延迟超 1 小时、完成率低于 30% |
| INFO | 单人 idle、完成率偏低、周期趋势变化 |

告警通过 Dashboard API 的群聊接口发送，认证方式为 Authorization: Bearer {TOKEN}。

使用方式与注意点

推荐通过 cron 每 15 分钟触发一次，也可以在需要查看团队状态时手动触发，关键词包括"群健康""团队状态""工人监控"。

需要注意：

• 依赖 Dashboard API 的 GET workers 与群聊告警 POST 两个接口，token 配置在 DASHBOARD_TOKEN
• 阈值均可通过配置覆盖，默认值适合常规节奏，团队时区跨度大时需要自行调整
• 完成率低于 3 这个阈值偏经验值，任务量大的团队可能需要结合实际情况调优