用途：gifgrep 用于搜索 GIF 提供方（Tenor/Giphy），在 TUI 中浏览、下载结果，并提取静帧或帧网格图，形成“搜索→预览→下载→提取”的工作流，方便快速审阅与分享。
主要能力：支持命令行搜索与 TUI 交互；可输出 JSON 或管道友好的字段；可下载到 ~/Downloads 并在 Finder 中显示；可从本地 GIF 提取单张静帧或采样帧网格图（sheet）。
常用用法：gifgrep cats --max 5；gifgrep cats --format url | head -n 5；gifgrep search --json cats | jq '.[0].url'；gifgrep tui "office handshake"；gifgrep cats --download --max 1 --format url。提取静帧：gifgrep still ./clip.gif --at 1.5s -o still.png；生成帧网格：gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png，可用 --frames、--cols、--padding 调整。
提供方与输出：--source auto|tenor|giphy；使用 giphy 需 GIPHY_API_KEY，Tenor 的 TENOR_API_KEY 可选（未设置时用演示密钥）。--json 输出包含 id、title、url、preview_url、tags、width、height 的数组；--format 输出便于管道处理的字段。
限制与注意：CLI 静帧预览 --thumbs 仅支持 Kitty/Ghostty；使用 GIF 资源前应验证 URL 可解析、Content-Type 为 image/gif 且确实为动画，并记录归属/许可/来源；需要本地资源时不要热链，应下载到项目内引用。环境变量 GIFGREP_SOFTWARE_ANIM=1 可强制软件动画，GIFGREP_CELL_ASPECT=0.5 可调整预览几何。