Gif Whatsapp

核心用法

本技能解决 WhatsApp 无法直接使用 Tenor/Giphy 链接发送 GIF 的技术痛点，通过 gifgrep 搜索 GIF 资源，经 curl 下载、ffmpeg 转码为 MP4 后，利用平台内置 message 工具以 gifPlayback=true 参数发送，最终在 WhatsApp 中呈现为循环播放的 GIF 效果。

完整流程：搜索（gifgrep）→ 下载（curl）→ 转码（ffmpeg）→ 发送（message）。推荐每次获取 5 个结果人工挑选最优项，使用 U+200E 不可见字符作为空 caption 实现无文字干扰的纯 GIF 发送。

显著优点

1. 技术闭环完整：独自完成搜索-下载-转码-发送全链路，无需用户手动处理文件格式转换
2. 平台深度整合：直接复用已配置的 message 工具，无需额外 WhatsApp 认证
3. 文件安全处理：强制写入 /tmp 目录且使用 -y 覆盖策略，避免磁盘堆积
4. 发送体验优化：不可见 caption 技巧确保 GIF 呈现纯净，无多余文字干扰

潜在局限

• 搜索语言限制：Tenor/Giphy 英文索引更优，中文搜索效果可能打折
• 依赖本地工具链：需预装 gifgrep、ffmpeg、curl 三个二进制依赖
• 临时文件风险：虽限定 /tmp 目录，但并发场景下可能出现文件名冲突（未使用随机化命名）
• 无内容审核层：直接透传用户搜索词，存在不当内容检索风险
• 单平台锁定：转码逻辑专为 WhatsApp MP4 需求设计，不具备跨平台通用性

适合人群

• 高频使用 WhatsApp 进行非正式沟通、需要生动表情辅助的用户
• 希望自动化 GIF 发送流程、避免手动下载转码繁琐操作的用户
• 对英文搜索接受度良好的用户群体

常规风险

• 第三方内容风险：Tenor/Giphy 内容由社区上传，存在版权或不当内容隐患
• 网络传输安全：HTTP 明文下载（curl -L 跟随重定向），存在中间人篡改可能
• ffmpeg 处理风险：虽限定 GIF 输入，但下载文件完整性未校验，损坏文件可能导致不可预期行为
• 频率控制缺失：文档提示"不要过度使用"，但无硬性速率限制机制，存在滥用风险

核心用法

gif-whatsapp 是一个专注于 WhatsApp 场景的 GIF 发送工具。用户通过自然语言描述情绪或场景（如 "thumbs up"、"celebration"），工具调用 gifgrep 搜索 Tenor/Giphy 图库，获取 3-5 个候选结果后选择最优 GIF。随后通过 curl 下载到 /tmp 临时目录，使用 ffmpeg 转换为 MP4 格式（pix_fmt yuv420p 确保兼容性），最终通过平台内置的 message 工具以 gifPlayback=true 参数发送，实现无缝的 GIF 播放体验。

显著优点

1. 原生 WhatsApp 兼容：解决直接 Tenor/Giphy URL 发送失败的问题，通过 MP4 转换确保 100% 送达率
2. 零配置集成：复用平台已配置的 message 工具，无需额外 WhatsApp 凭据
3. 智能搜索策略：强制获取 5 个结果并择优选择，避免首条结果质量不佳的问题
4. 轻量无依赖：仅依赖系统级工具（curl/ffmpeg/gifgrep），无第三方包管理风险
5. 无痕发送：使用 Unicode 不可见字符（U+200E）作为 caption，实现纯 GIF 发送

潜在缺点与局限性

• 外部服务依赖：Tenor/Giphy 服务中断或内容变更将直接影响功能可用性
• T3 来源可信度：作者为个人开发者 Leo，无组织背书，需用户自行审查代码
• 无内置 URL 验证：文档示例假设 URL 可信，未强制限制域名白名单
• 临时文件风险：虽使用 /tmp 和 -y 覆盖模式，但多实例并发可能产生文件名冲突
• 功能单一：仅支持发送，无收藏、历史记录或本地 GIF 管理能力

适合人群

• 频繁使用 WhatsApp 进行非正式沟通的商务人士
• 希望通过生动表情提升消息感染力的社交活跃用户
• 已熟悉命令行工具、愿意审查代码的技术型用户
• 需要快速发送庆祝、赞同、惊讶等标准化情绪反馈的场景

常规风险

• 供应链风险：gifgrep 工具若为第三方编译版本，可能存在搜索结果被注入风险
• 内容合规风险：Tenor/Giphy 返回的 UGC 内容可能包含版权或敏感元素
• 隐私元数据：搜索关键词可能暴露用户情绪状态和对话上下文
• 过度使用陷阱：文档明确警告 "One GIF per context"，但缺乏硬限制机制