名称： gif-whatsapp
版本： 1.1.0
描述： 在 WhatsApp 中搜索并发送 GIF。处理 WhatsApp 所需的 Tenor→MP4 转换。
作者： Leo 🦁
主页： https://clawhub.com/skills/gif-whatsapp
元数据： {"clawdbot":{"emoji":"🎬","requires":{"bins":["gifgrep","ffmpeg","curl"]},"requiresTools":["message"],"notes":"使用平台的消息工具（已配置）进行 WhatsApp 发送。gifgrep 仅搜索 Tenor/Giphy。下载文件保存至 /tmp，发送后自动清理。"}}
允许工具： [exec, message]

GIF 发送器

在 WhatsApp 对话中自然地发送 GIF。

重要提示：WhatsApp GIF 工作流程

WhatsApp 不支持直接的 Tenor/Giphy URL。你必须：
1. 下载 GIF 文件
2. 转换为 MP4 格式
3. 使用 gifPlayback: true 参数发送

完整工作流程

步骤 1：搜索 GIF

gifgrep "搜索词" --max 5 --format url

使用英文搜索以获得最佳结果。

务必获取 5 个结果并选择最佳的一个——根据文件名/描述判断，不要直接使用第一个结果。

步骤 2：下载 GIF

curl -sL "GIF_URL" -o /tmp/gif.gif

步骤 3：转换为 MP4

ffmpeg -i /tmp/gif.gif -movflags faststart -pix_fmt yuv420p -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" /tmp/gif.mp4 -y

步骤 4：通过消息工具发送

message action=send to=号码 message="‎" filePath=/tmp/gif.mp4 gifPlayback=true

注意：使用不可见字符 ‎（左至右标记，U+200E）作为消息内容，以便发送不带可见标题的 GIF。

单行命令示例

# 搜索
gifgrep "thumbs up" --max 3 --format url

# 选择最佳 URL，然后：
curl -sL "https://media.tenor.com/xxx.gif" -o /tmp/g.gif && \
ffmpeg -i /tmp/g.gif -movflags faststart -pix_fmt yuv420p -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" /tmp/g.mp4 -y 2>/dev/null

# 然后使用消息工具发送，并设置 gifPlayback=true

何时发送 GIF

✅ 适用场景：
- 用户主动要求 GIF
- 庆祝好消息
- 有趣的反应
- 表达情绪（兴奋、捂脸等）

❌ 避免滥用：
- 同一情境下发送一个 GIF 即可
- 并非每条消息都需要 GIF

常用搜索词

安全注意事项

• 来源域名：gifgrep 仅搜索受信任的 GIF 提供商（Tenor、Giphy）
• 文件处理：所有下载文件均保存至 /tmp，每次发送后会被覆盖（使用 -y 标志）
• 空标题：使用 ‎ 字符（U+200E，左至右标记）作为不可见标题，使 WhatsApp 发送不带可见文本的 GIF。这是标准的 Unicode 控制字符，并非注入技术
• WhatsApp 集成：使用平台内置的 message 工具——无需单独的 WhatsApp 凭据
• ffmpeg 安全：仅处理来自受信任提供商的 GIF 文件；不执行任意文件

工作原理

• WhatsApp 在内部将所有 GIF 转换为 MP4
• 直接的 Tenor/Giphy URL 通常发送失败
• 带有 gifPlayback=true 的 MP4 文件会显示为循环播放的 GIF
• 文件体积小，发送速度快