用途:从视频文件中抽取帧,供 LLM 进行视觉分析。当用户发送视频并询问“视频里有什么”、想抽取指定帧或时间戳、需要缩略图或关键帧,或要求对视频内容做视觉分析时使用。
主要能力:通过捆绑脚本抽取帧,也可手动用 ffmpeg 抽取单帧、仅关键帧(I 帧)或每 N 秒一帧;用 ffprobe 获取视频时长与元数据。
使用方式:脚本调用为 bash "$(telclaude skill-path video-frames scripts/frame.sh)" <video_path> [output_dir] [interval]。video_path 为视频路径(Telegram 上传可查 /media/inbox/);output_dir 默认 /media/outbox/frames/;interval 为帧间隔秒数,默认 2。手动抽取示例:单帧 ffmpeg -ss 00:00:05 -i /media/inbox/video.mp4 -frames:v 1 -q:v 2 /media/outbox/frame.jpg;关键帧 ffmpeg -i /media/inbox/video.mp4 -vf "select=eq(pict_type,I)" -vsync vfr -q:v 2 /media/outbox/keyframe_%03d.jpg;每 N 秒 ffmpeg -i /media/inbox/video.mp4 -vf "fps=1/5" -q:v 2 /media/outbox/frame_%03d.jpg。获取时长:ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 /media/inbox/video.mp4。
输出建议:短视频(小于 30 秒)抽取 3-5 张代表性帧;较长视频使用更大间隔或仅关键帧。抽取后用 Read 工具查看帧并描述所见内容。输出帧保存到 /media/outbox/,以便中继回传。
限制:依赖 ffmpeg 与 ffprobe 环境;具体安装方式、收费与平台支持暂未提供。