Gif Whatsapp

核心用法

该 skill 通过命令行工具链实现 WhatsApp GIF 发送的完整工作流：使用 gifgrep 搜索 Tenor 图库获取 GIF URL，curl 下载至本地，ffmpeg 转换为 MP4 格式（含必要的 yuv420p 像素格式和偶数尺寸调整），最后通过消息工具以 gifPlayback=true 参数发送，确保在 WhatsApp 中显示为循环播放的动画。

显著优点

1. 解决兼容性问题：直接处理 WhatsApp 不支持 Tenor/Giphy 直链的限制，底层模拟 WhatsApp 原生 GIF 转换逻辑
2. 轻量高效：依赖成熟的命令行工具（curl/ffmpeg），无额外运行时开销
3. 场景化引导：内置情绪-搜索词映射表（庆祝/认可/惊讶/沮丧等），降低用户决策成本
4. 防滥用机制：明确建议"单场景仅一个 GIF"，避免过度发送

潜在缺点与局限

• 外部服务依赖：Tenor API 可用性影响功能稳定性
• 手动 URL 选择：搜索后需人工挑选具体 GIF，未实现自动择优
• 临时文件管理：/tmp 路径写入需关注磁盘空间与权限
• 无预览功能：发送前无法本地查看 GIF 内容
• ffmpeg 参数固定：缩放策略可能不适合极端长宽比的素材

适合人群

• 频繁使用 WhatsApp 进行轻松社交沟通的 CLI 用户
• 需要通过自动化脚本发送节日祝福、项目里程碑庆祝的企业场景
• 偏好键盘驱动工作流、接受命令行交互的技术用户

常规风险

| 风险点 | 说明 |

|--------|------|

| 版权内容 | Tenor 搜索结果可能含版权素材 |

| 文件泄露 | /tmp 残留文件在共享环境中可被访问 |

| 网络暴露 | curl 下载过程暴露用户 IP 至 Tenor CDN |

| 格式失败 | 异常 GIF 结构可能导致 ffmpeg 转换失败，需手动重试 |

核心用法

gif-whatsapp 是一个文档型 WhatsApp 自动化工具，解决了一个常见痛点：WhatsApp 不支持直接发送 Tenor/Giphy GIF 链接，必须转换为 MP4 格式并标记 gifPlayback: true 才能正常显示为循环动图。

使用流程分为三步：
1. 搜索 GIF：通过 gifgrep "关键词" --max 3 --format url 从 Tenor 获取候选链接
2. 格式转换：用 curl 下载 GIF，再通过 ffmpeg 转为兼容 MP4（关键参数：-movflags faststart -pix_fmt yuv420p 确保 WhatsApp 识别）
3. 发送消息：调用 message 工具并设置 gifPlayback=true

显著优点

• 精准解决痛点：封装了 WhatsApp GIF 发送的完整技术链路，用户无需理解底层格式转换细节
• 依赖透明：仅需 gifgrep、ffmpeg、curl 三个标准工具，无隐藏依赖
• 场景指导完善：附带情绪-搜索词对照表，降低用户决策成本
• 轻量化设计：纯 Markdown 文档型 Skill（T-MD），无可执行代码，审计友好

潜在局限

• 手动选图：需人工从搜索结果中挑选 URL，未实现自动选择最优结果
• 临时文件管理：使用 /tmp 路径，多并发场景可能冲突
• 网络依赖：必须连通 Tenor API，无离线 fallback
• T3 来源：个人开发者维护，无企业级 SLA 保障

适合人群

• WhatsApp 自动化开发者，需集成富媒体消息功能
• 个人用户希望快速发送表情动图，不愿手动处理格式转换
• 对安全敏感但功能需求简单的场景（代码完全可读）

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 供应链攻击 | 低 | 依赖 Tenor（Google 旗下），HTTPS 加密传输 |

| 隐私泄露 | 极低 | 仅传输 GIF 二进制，无个人数据收集 |

| 功能失效 | 中 | Tenor API 变更或 WhatsApp 协议更新可能导致流程中断 |

| 滥用风险 | 低 | 文档明确建议"不过度使用"，单次单图策略合理 |

安全认证评分 92/S 级，静态分析无危险函数、无敏感信息泄露，整体风险可控。