SKILL.md

---
name: feishu-recall-message
description: 撤回飞书群消息。以用户身份撤回（recall）飞书群聊或单聊中的消息。群主/管理员可撤回任意成员消息，普通成员只能撤回自己的消息。支持单条撤回、批量撤回、按时间范围撤回。触发词：撤回消息、recall message、删除群消息、recall、撤回。
---

# 飞书群消息撤回

使用 `feishu_im_user_message` 工具的 `delete` action 以用户身份撤回消息。

## 前置条件

- 已完成飞书用户 OAuth 授权（撤回操作需要用户身份）
- 应用已开通 `im:message` scope
- 群主/管理员可撤回群内任意消息；普通成员只能撤回自己的消息

## 撤回单条消息

```
feishu_im_user_message(action="delete", message_id="om_xxx")
```

可选参数 `need_notification`：设为 `true` 则群内显示"xxx 撤回了一条消息"通知。默认 `false`（静默撤回）。

## 撤回引用的消息

当用户引用某条消息说"撤回"时，从引用上下文获取 `message_id`，直接调用 delete。

## 批量撤回

1. 用 `feishu_im_user_get_messages` 获取目标消息列表（支持 `start_time`/`end_time` 时间范围过滤，`chat_id` 指定群）
2. 过滤掉 `deleted: true` 的消息
3. 逐条调用 `feishu_im_user_message(action="delete", message_id="om_xxx")`
4. 汇报结果：成功数 / 失败数

## 按时间范围撤回

```
# 获取指定时间范围的消息
feishu_im_user_get_messages(
  chat_id="oc_xxx",
  start_time="2026-03-27T00:00:00+08:00",
  end_time="2026-03-27T23:59:59+08:00",
  page_size=50
)

# 逐条撤回未删除的消息
for msg in messages:
  if not msg.deleted:
    feishu_im_user_message(action="delete", message_id=msg.message_id)
```

注意：单次 `get_messages` 最多返回 50 条。如消息量大，需分页（用 `page_token`）。

## 注意事项

- 飞书限制：不支持撤回发出时间超过 1 天的消息
- 已删除的消息返回 `deleted: true`，跳过即可
- 撤回机器人消息也可用 `message` 系统工具的 `delete` action（无需用户授权）
- 撤回用户消息必须用 `feishu_im_user_message` 的 `delete`（需要用户 OAuth token）