| name | analyze-game-video |
| description | Analyze game videos from YouTube by downloading with yt-dlp, extracting frames with ffmpeg, and providing comprehensive analysis of UI/UX, gameplay, art style, and technical implementation. Use when the user wants to analyze a game video, study game design from YouTube footage, or extract frames from gameplay videos. |
游戏视频分析
从 YouTube 下载游戏视频，用 ffmpeg 截帧，对截取的画面进行全面分析并生成报告。
前置依赖
yt-dlp：下载 YouTube 视频ffmpeg：视频截帧
工作流程
Step 1: 下载视频
使用 yt-dlp 下载视频到临时目录：
mkdir -p /tmp/game-video-analysis
yt-dlp -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" \
--merge-output-format mp4 \
-o "/tmp/game-video-analysis/%(title)s.%(ext)s" \
"<YouTube_URL>"
如果只需要分析画面（不需要音频），可以只下载视频流以加快速度：
yt-dlp -f "bestvideo[height<=1080]" \
-o "/tmp/game-video-analysis/%(title)s.%(ext)s" \
"<YouTube_URL>"
Step 2: 截帧
默认每秒截 1 帧。用户可指定不同的截帧频率。
mkdir -p /tmp/game-video-analysis/frames
ffmpeg -i "/tmp/game-video-analysis/<video_file>" \
-vf "fps=1" \
-q:v 2 \
"/tmp/game-video-analysis/frames/frame_%04d.jpg"
常用截帧频率参考：
| 频率 | fps 值 | 适用场景 |
|---|
| 每秒 1 帧 | fps=1 | 默认，通用分析 |
| 每 2 秒 1 帧 | fps=0.5 | 长视频概览 |
| 每 5 秒 1 帧 | fps=0.2 | 快速浏览 |
| 每秒 2 帧 | fps=2 | 动作细节分析 |
截帧完成后，统计总帧数以便规划分析：
ls /tmp/game-video-analysis/frames/ | wc -l
Step 3: 分析截帧
逐批读取截帧图片（每批 5-10 张），从以下四个维度进行分析：
3.1 UI/UX 界面设计
- HUD 布局与信息层级
- 菜单系统与导航流程
- 字体、图标、配色方案
- 交互反馈（按钮状态、动画提示）
- 信息密度与可读性
3.2 游戏玩法机制
- 核心循环（Core Loop）
- 操作方式与控制方案
- 进度系统与成长体系
- 关卡/场景设计思路
- 难度曲线与节奏控制
3.3 美术风格与视觉表现
- 整体美术风格定位（写实 / 卡通 / 像素 / 其他）
- 色彩运用与氛围营造
- 角色与场景设计特点
- 特效与粒子系统表现
- 光影与后处理效果
3.4 技术实现
- 推测使用的引擎或框架
- 渲染技术特点
- 性能表现观察（帧率、加载等）
- 值得借鉴的技术方案
Step 4: 生成报告
将分析结果输出为 Markdown 文件，保存到 Docs/ 目录。
报告模板：
# [游戏名称] 视频分析报告
> 视频来源：[YouTube URL]
> 分析日期：[日期]
> 截帧设置：每秒 X 帧，共 N 帧
## 概述
[一段话总结游戏的核心特点与整体印象]
## UI/UX 分析
### 亮点
- ...
### 可改进之处
- ...
## 玩法机制分析
### 核心循环
- ...
### 特色系统
- ...
## 美术风格分析
### 风格定位
- ...
### 视觉亮点
- ...
## 技术实现分析
### 引擎与技术
- ...
### 值得借鉴
- ...
## 关键截帧参考
[插入最具代表性的截帧及说明]
## 总结与启发
### 可借鉴的设计要素
1. ...
2. ...
3. ...
### 对当前项目的建议
1. ...
2. ...
3. ...
Step 5: 清理
分析完成后，询问用户是否删除临时文件：
rm -rf /tmp/game-video-analysis
注意事项
- 截帧数量较多时（>50），分批分析，每批 5-10 张
- 优先分析画面变化较大的帧，跳过重复或相似的帧
- 如果视频较长（>10 分钟），建议降低截帧频率或截取特定时间段
- 截取特定时间段示例：
ffmpeg -ss 00:01:00 -to 00:03:00 -i video.mp4 -vf "fps=1" -q:v 2 frames/frame_%04d.jpg
- 报告文件名格式：
Docs/GameAnalysis_[游戏名]_[日期].md
