飞书表情回复

让 Agent 学会用表情说话——主动表达、读懂情绪、知道什么时候该回应什么时候该闭嘴。

快速开始

// 给当前消息加表情
message({
  action: "react",
  channel: "feishu",
  emoji: "THUMBSUP"
})

核心概念

1. 添加表情

用表情回应用户消息——确认、表达情绪、轻量反馈，不用打字。

// 确认
message({ action: "react", channel: "feishu", emoji: "THUMBSUP" })

// 表达情绪
message({ action: "react", channel: "feishu", emoji: "THINKING" })  // 🤔
message({ action: "react", channel: "feishu", emoji: "SPEECHLESS" })  // 无语

// 庆祝
message({ action: "react", channel: "feishu", emoji: "PARTY" })  // 🎉

只加表情不回文字时，用 NO_REPLY 结尾，避免暴露原始 JSON。

2. 响应用户的表情

用户给你的消息加表情时，根据情绪决定回不回：

要回应的：

• 情绪类：😢 😤 😭 🙈 😮‍💨 → "懂了 💙" 或 "收到～"
• 困惑/质疑：❓ 🤔 🤨 → 解释或澄清
• 强烈反应：🔥 💯 🎉 😱 → "谢谢！😊"

闭嘴的（NO_REPLY）：

• 简单认可：👍 ✅ OK
• 中性确认：👀 🙏

判断标准：真人聊天时不回会不会尴尬？会→回。不会→闭嘴。

为什么这很重要：无视用户的情绪反应会让对话变冷，用户能感觉到你没反应——这会让交互变得机械。

3. 学习新表情

遇到没见过的表情时，按四步走：

第一步：观察 — 从 reaction 事件中提取表情类型

[message_id: om_xxx:reaction:SPITBLOOD:uuid]
User: [reacted with SPITBLOOD to message om_xxx]
→ 提取: "SPITBLOOD"

第二步：尝试 — 试着用这个表情

message({
  action: "react",
  emoji: "SPITBLOOD",
  message_id: "om_yyy"
})

第三步：记录 — 成功加入词汇表，失败标记不可用

第四步：积累 — 持续更新到 TOOLS.md 或 memory/emoji-learned.md

完整示例：

用户: [reacted with AWESOMEN]
→ 提取: "AWESOMEN" 🐮
→ 尝试: message({emoji: "AWESOMEN"})
→ 结果: {"ok":true}
→ 学会了: AWESOMEN = 牛逼

4. 文化语境

有些表情的含义不能按字面翻译：

注意观察用户在什么语境下使用表情，理解真实含义。

常用表情速查

速查表（完整清单见 references/emoji-list.md）：

加载 references/emoji-list.md 获取完整清单和文化注释。

API 参数

重要：message_id 必须是纯 om_xxx 格式！

当你收到 reaction 事件时，消息 ID 会带后缀，格式为 om_xxx:reaction:EMOJI:uuid。调用飞书 API 时必须去掉后缀，只用 om_xxx 部分。

// 收到的 message_id（合成的，不能直接用）
om_x100b53f9861300a8c30a3d16a2f7f05:reaction:WHAT:48538ccb-9d13-4357-8d7b-3c12f864d27f

// 提取纯 message_id（用这个调 API）
om_x100b53f9861300a8c30a3d16a2f7f05

提取方法：取 :reaction: 之前的部分，或者取第一个 om_ 开头到下一个 : 之间的内容。