用途：gifgrep 用于搜索 GIF 提供方（Tenor/Giphy），在 TUI 中浏览、下载结果，并提取静帧或帧网格图，形成“搜索→预览→下载→提取”的快速流程，便于审阅与分享。
主要能力：支持命令行搜索与 JSON 输出；支持 TUI 交互浏览；支持下载并定位文件；支持从 GIF 提取单张静帧或采样帧网格图（sheet）。
使用方式： 搜索：gifgrep cats --max 5 管道输出：gifgrep cats --format url | head -n 5 JSON：gifgrep search --json cats | jq '.[0].url' TUI：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
参数与配置：--download 保存到 ~/Downloads，--reveal 在 Finder 中显示最近下载；--thumbs 提供 CLI 静帧预览（仅 Kitty/Ghostty）；--source auto|tenor|giphy 选择来源，--source giphy 需要 GIPHY_API_KEY，TENOR_API_KEY 可选（未设置时使用 Tenor 演示密钥）；--json 输出包含 id、title、url、preview_url、tags、width、height 的数组；--format 输出便于管道的字段。sheet 可用 --frames、--cols、--padding 调整。环境变量 GIFGREP_SOFTWARE_ANIM=1 强制软件动画，GIFGREP_CELL_ASPECT=0.5 调整预览几何。
适用场景：快速检索与审阅 GIF、为文档/PR/聊天生成帧网格图、脚本化获取 GIF URL。
限制：--thumbs 仅支持 Kitty/Ghostty；Giphy 来源需 API 密钥；其余平台与收费信息暂未提供。