Feishu Message Recall

---
name: feishu-message-recall
description: |
  飞书消息撤回/删除工具 / Feishu message recall tool. 撤回或删除已发送的普通群消息和话题（Thread）消息，支持批量删除和话题消息列表查询。
  Use when: "撤回飞书消息", "recall feishu message", "删除群消息", "delete group message", "批量撤回", "batch recall", "话题消息删除", "thread message deletion", "清理误发消息", "clean up accidental messages".
  只能删除自己发送的消息，超过 24 小时可能无法撤回，支持单条删除和话题批量删除。Cross-references: feishu-chat-monitor, feishu-group-welcome, feishu-chat-extractor.
  Built by UniqueClub 🌐 https://uniqueclub.ai
version: "1.0.0"
---

# Feishu Message Recall

> 飞书消息撤回/删除工具——用于撤回或删除已发送的普通群消息和话题（Thread）消息，支持批量删除。

## When to Use

Use this skill when:
- 需要删除自己误发的单条群消息时
- 需要批量删除话题（Thread）中的多条消息时
- 需要清理测试消息或历史垃圾消息时
- 需要查询话题中的消息列表以便选择性删除时

Do NOT use this skill if:
- 需要删除别人发送的消息 → 飞书 API 仅支持删除自己发送的消息
- 消息发送已超过 24 小时 → 可能无法撤回
- 需要撤回系统消息或机器人自动消息 → 权限可能受限

Typical triggers:
- 「撤回这条消息」「删除话题里的消息」
- "批量清理我刚才发的消息", "Recall the last Feishu message I sent"

## Workflow

1. **探查 (Probe)**
确认消息 ID（`om_xxx`）或话题 ID（`omt_xxx`），以及是否需要批量删除。

2. **约束 (Constrain)**
只能删除自己发送的消息。超过 24 小时的消息可能无法删除。话题消息的删除权限与普通群消息相同。批量删除前建议先用 `--list-thread` 查询话题中的消息列表。删除操作不可恢复，请谨慎执行。不降级——尝试删除别人的消息时报告权限错误。

3. **证据 (Evidence)**
确认目标消息由当前应用/用户发送。批量删除前查询话题中的消息列表确认范围。

4. **执行 (Execute)**
```bash
# 删除单条消息
python3 skills/feishu-message-recall/scripts/recall.py --msg-id om_x100b5741b264fca0c12f636d26d1cdd

# 删除话题中的所有消息
python3 skills/feishu-message-recall/scripts/recall.py --thread-id omt_1ae2d7a2164f9ce5

# 查询话题中的消息
python3 skills/feishu-message-recall/scripts/recall.py --list-thread omt_xxx
```

5. **验证 (Verify)**
确认删除成功，返回成功/失败计数。检查消息是否已从群聊中移除。

6. **交付 (Deliver)**
返回操作结果摘要，清理临时文件。

## Output

返回操作结果摘要，包含删除的消息数量、成功/失败计数和涉及的消息 ID 列表。

## Guardrails

**Anti-patterns**
- NEVER 尝试删除别人发送的消息（飞书 API 不支持）
- Do NOT 在未查询话题消息列表的情况下批量删除
- Do NOT 对超过 24 小时的消息强行撤回（可能失败）
- 禁止删除操作后不验证（可能部分失败）

**Constraints**
- 只能删除自己发送的消息
- 超过 24 小时的消息可能无法删除
- 话题消息的删除权限与普通群消息相同
- 批量删除前建议先用 `--list-thread` 查询话题中的消息列表
- 删除操作不可恢复，请谨慎执行
- `APP_ID` 和 `APP_SECRET` 从环境变量或 `config.py` 读取，需要 Python 3.8+ 和 `requests`

## API Limitations

- `APP_ID` 和 `APP_SECRET` 从环境变量或 `config.py` 读取
- 需要 Python 3.8+ 和 `requests`
- 飞书 API 仅支持删除自己发送的消息
- 超过 24 小时的消息可能无法撤回

## Usage Examples

```bash
# 删除单条消息
python3 skills/feishu-message-recall/scripts/recall.py --msg-id om_xxx

# 删除话题中的所有消息
python3 skills/feishu-message-recall/scripts/recall.py --thread-id omt_xxx

# 查询话题中的消息
python3 skills/feishu-message-recall/scripts/recall.py --list-thread omt_xxx
```

## Related Skills

- **feishu-chat-monitor** — 检查遗漏的 @提及
- **feishu-group-welcome** — 群聊欢迎消息管理
- **feishu-chat-extractor** — 提取和分析聊天记录

## About UniqueClub

Part of the UniqueClub toolkit.
🌐 https://uniqueclub.ai