SuperAPI AI 工具集

video-debugger

测试与质量

查看项目

更新于 10-16 06:14

技能介绍

用途:Video Debugger 用于把屏幕录制视频(screen recording)拆解为帧,便于逐帧分析网页动画、CSS 过渡、布局偏移(layout shift)及 UI 行为,辅助定位视觉类缺陷。它来自 testacode/llm-toolkit,页面地址为 https://www.skills.sh/testacode/llm-toolkit/video-debugger。

主要能力:

  • 依赖检查与元数据读取:使用 ffmpeg、ffprobe、python3 检查环境,并用 ffprobe 输出时长、分辨率、帧率、文件大小等信息。
  • 帧提取模式:快速(4 fps)、详细(10 fps)、仅变化(场景检测自动识别)、指定时间段(10 fps)。默认输出 JPEG q:v 2。
  • 自动生成 contact sheet(接触印相表),按帧数选择网格列数与缩放。
  • 视觉差分:通过脚本生成 diffs、diff-motion.mp4、diff-contact.jpg、diff-report.txt、scores.txt,帮助定位变化显著的帧。
  • 可选视觉语义分析:支持本地模型(mlx-vlm 或 LM Studio 后端),输出 vision-analysis.txt,描述运动、glitch、过渡等。

使用方式(命令保持原样): 依赖检查:which ffmpeg && ffmpeg -version | head -1;which ffprobe;which python3。 元数据:ffprobe -v quiet -print_format json -show_format -show_streams <video_path>。 帧提取示例:ffmpeg -i <video> -vf "fps=4" -q:v 2 "$OUTPUT_DIR/frame_%04d.jpg";仅变化:ffmpeg -i <video> -vf "select=gt(scene,0.3)" -vsync vfr -q:v 2 "$OUTPUT_DIR/scene_%04d.jpg"。 视觉能力检测:bash scripts/analyze-frames.sh --check-vision。 差分:bash scripts/analyze-frames.sh <video_path> "$OUTPUT_DIR" --threshold 8。 视觉分析:bash scripts/analyze-frames.sh <video_path> "$OUTPUT_DIR" --vision --threshold 8;或加 --backend lmstudio。

适用场景:网页动画/过渡调试、布局偏移排查、z-index 与透明度闪烁问题、重排重绘伪影等视觉缺陷定位。

限制与注意事项:需先安装 ffmpeg、ffprobe、python3;本地视觉分析为可选,未满足条件时可用 agent frame-analyzer(Sonnet);GIF 因 Bayer dithering 需提高 --threshold 到 12-14;大视频可能缓慢,可加 -threads 4。具体价格、收费等信息暂未提供。