群消息超时监控 Skill

> 自动监控飞书多维表格中今日未回复的群聊话题，标记已撤回的，推送超时未回的。

>

> 版本：v1.0

> 更新：2026-05-19

触发条件

• 定时触发：cron 每 5 分钟执行一次（cron 任务后续单独配置）
• 手动触发：用户说「检查群消息」「群消息超时监控」

前置条件（每次运行第一步）

1. OAuth 授权检查

尝试以用户身份调用任意 API（如 feishu_get_user），验证授权有效性：

• 有效 → 继续
• 失效/过期 → 提示用户重新授权，终止本次运行

2. 确认当前日期

计算今天的「发送日期」格式：

TZ=Asia/Shanghai date '+%m月%d日'
# 例如：05月19日

数据源

涉及字段

执行流程

阶段一：API 五层筛（一次调用）

用 feishu_bitable_app_table_record 的 list 方法，一次性传入 5 个 filter 条件。

> 条件顺序按筛除效率排列：越筛人的放越前面，减少后续匹配计算量。

{
  "field_names": ["消息ID", "发送时间", "所在群", "消息链接", "聊天记录"],
  "filter": {
    "conjunction": "and",
    "conditions": [
      {"field_name": "发送日期", "operator": "is", "value": ["05月19日"]},
      {"field_name": "根消息ID", "operator": "isEmpty"},
      {"field_name": "话题回复内容", "operator": "isEmpty"},
      {"field_name": "发送人", "operator": "isNot", "value": ["ou_bedf1873f673089685e5d71192b19a22"]},
      {"field_name": "是否撤回", "operator": "is", "value": ["false"]}
    ]
  }
}

预期结果：26000+ 条 → 约个位数候选记录。

阶段二：本地算超时（>30分钟）

对阶段一返回的每条记录，用 check.sh 脚本计算并分组：

bash /workspace/群消息超时监控/scripts/check.sh < input.json > output.json

脚本会：

1. 逐条算 (当前时间 - 发送时间) / 60 > 30
2. 按「所在群ID」分组
3. 输出分组后的 JSON

阶段三：按群查撤回（查群数=N次API，而非记录数）

对阶段二输出的每个分组，用用户身份工具 feishu_im_user_get_messages 查一次消息列表：

chat_id = 组的 chat_id（如 oc_xxx）
relative_time = "last_1_days"
page_size = 50

返回值处理（逐条匹配组内记录的消息ID）：

阶段四：推送未撤回的超时话题

对确认「未撤回」的记录，每条单独推送一张消息卡片到 风控bi报表或超时提醒推送群（oc_5ab81cdc5c51744bcfa2e821c71f895b）。

卡片模板：

┌─────────────────────────────────────┐
│ 🟡 群消息未回复                      │
│                                     │
│ {消息链接}                           │
│                                     │
│ 📍 {所在群名称}                      │
└─────────────────────────────────────┘

完整流程图

开始
 │
 ├─ OAuth 有效？─── 否 ──→ 提示重新授权，终止
 │
 ├─ 阶段一：API 筛
 │   发送日期=今天 → 根消息ID=空 → 话题回复内容=空
 │   → 发送人≠风控值班 → 是否撤回=未勾选
 │   │
 │   └─ 结果：0 条 ──→ 无超时话题，结束
 │
 ├─ 阶段二：本地算超时
 │   每条算 >30分钟，按群分组
 │   │
 │   └─ 结果：0 条 ──→ 无不超时，结束
 │
 ├─ 阶段三：按群查撤回
 │   每组查一次消息列表
 │   │
 │   ├─ 不在群 → 跳过该组
 │   ├─ 找到消息ID → 未撤回
 │   └─ 找不到 → 勾选是否撤回
 │
 └─ 阶段四：推送卡片到目标群

工具使用规则（禁止事项）

身份约束

• ❌ 禁止使用机器人身份工具查询消息（如 feishu_im_bot_image、message）
• ❌ 禁止不使用工具自行编造查询结果
• ❌ 禁止用关键词搜索（feishu_im_user_search_messages）代替按消息ID查话题
• ✅ 必须使用用户身份工具 feishu_im_user_get_messages 查群消息
• ✅ 必须使用用户身份工具 feishu_bitable_app_table_record 读写多维表格

操作约束

• ❌ 禁止修改已勾选「是否撤回」的记录
• ❌ 禁止单条记录重复推送（每次 cron 运行只推一次）
• ✅ 必须在推送成功后确认消息已发出

错误处理