用途：通过 grok（grok build CLI）配合 ffmpeg，完成网络/X 搜索、大批量调研、图片生成、视频生成、绿幕与视频后处理、图片后处理六类任务。图片与视频走 grok 登录态内置工具（image_gen/image_to_video），消耗订阅额度，不产生 xAI API 费用。
主要能力与路由：网络/X 搜索（带引用）用 grok-search.mjs（需 XAI_API_KEY）或 grok headless 登录态；大批量多主题调研用 grok -p headless 加 subagents（默认启用）；生成图片用 grok-media.mjs image；生成视频（文生/图生）用 grok-media.mjs video；绿幕抠像、拼接、水印、GIF 用 ffmpeg 现场编写命令。
使用方式：先运行 node {baseDir}/scripts/preflight.mjs 自检环境，报告 OS、grok 登录、ffmpeg filter 与编码器，并按平台给出安装建议。媒体生成用跨平台 node 封装脚本 grok-media.mjs，例如 node "$BASE/scripts/grok-media.mjs" image --prompt "..." --out city.jpg --aspect-ratio 16:9，视频支持 duration 1-15s、resolution 480p/720p/1080p。搜索示例：node "$BASE/scripts/grok-search.mjs" "..." --mode auto。后处理不提供固定脚本，参考 post-processing.md 按素材现场调参，如 chromakey=0x00FF00:<sim>:<blend>,despill。
平台与安装：macOS/Linux 用 curl -fsSL https://x.ai/cli/install.sh | bash；Windows 用原生 PowerShell（irm https://x.ai/cli/install.ps1 | iex）或 WSL2。媒体生成需登录（SuperGrok / X Premium+）：grok login。技能安装：npx skills add Wangnov/grok-skills，或加 -g -a claude-code 指定全局与 Claude Code。
机制与限制：媒体生成由严格 prompt 驱动内置工具，产物先落 ~/.grok/sessions/<cwd>/<id>/（视频在 videos/）再复制到工作目录；视频自带 AAC 音轨、H.264、24fps，比例跟随源图或请求。单图约 30–70s，单段视频数分钟。脚本清单包括 preflight.mjs、grok-media.mjs、grok-search.mjs、search-selftest.mjs。ffmpeg 后处理刻意不提供固定脚本，需按环境与素材现场编写。