# Volcengine Video Understanding

> 火山引擎视频理解技能，使用 doubao-seed-2.0-code 模型分析视频内容，评估情感表达、画面质量、叙事效果等。

- Skill: `lujiaheng-artpivot/volcengine-video-understanding` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add lujiaheng-artpivot/volcengine-video-understanding`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lujiaheng-artpivot/volcengine-video-understanding/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lujiaheng-artpivot (https://skillmd.com/u/lujiaheng-artpivot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lujiaheng-artpivot/volcengine-video-understanding

---


# Volcengine Video Understanding - 视频理解分析

使用火山引擎 doubao-seed-2.0-code 模型对视频进行深度理解和分析。

## 前置条件

1. 需要火山引擎 API Key，设置环境变量 `ARK_API_KEY`
2. 安装 SDK：`pip install 'volcengine-python-sdk[ark]'`

## 功能

1. **内容描述**：详细描述视频画面内容
2. **情感分析**：分析视频传达的情感氛围
3. **质量评估**：评估画面质量、运镜技巧
4. **叙事分析**：分析视频的叙事结构和节奏
5. **改进建议**：提供优化建议

## 使用方法

### 分析单个视频

```bash
python3 {baseDir}/scripts/analyze_video.py \
  --video "/path/to/video.mp4" \
  --aspect "emotional" \
  --output "{workDir}/analysis_report.md"
```

参数说明：
- `--video`：视频文件路径（必填）
- `--aspect`：分析维度，可选：
  - `content`：内容描述（默认）
  - `emotional`：情感分析
  - `quality`：质量评估
  - `narrative`：叙事分析
  - `comprehensive`：综合分析
- `--output`：分析报告输出路径（可选，默认输出到控制台）

### 批量分析漫剧

分析 manga-drama 生成的所有场景视频：

```bash
python3 {baseDir}/scripts/analyze_drama.py \
  --drama-dir "/path/to/drama_output" \
  --output "{workDir}/drama_analysis.md"
```

## 分析维度说明

### 内容描述 (content)
- 画面主体识别
- 场景环境描述
- 动作行为分析
- 视觉元素提取

### 情感分析 (emotional)
- 整体情感氛围
- 情绪变化曲线
- 观众情感共鸣点
- 情感传达效果

### 质量评估 (quality)
- 画面清晰度
- 色彩表现
- 运镜流畅度
- 构图技巧
- 光影效果

### 叙事分析 (narrative)
- 故事结构
- 节奏把控
- 转场效果
- 信息传达效率

### 综合分析 (comprehensive)
包含以上所有维度的完整分析

## 输出格式

分析报告为 Markdown 格式，包含：

```markdown
# 视频分析报告

## 基本信息
- 视频文件: xxx.mp4
- 时长: X秒
- 分辨率: 1920x1080

## 内容描述
...

## 情感分析
...

## 质量评估
...

## 改进建议
...
```

## 使用场景

1. **漫剧验收**：分析 manga-drama 生成的视频效果
2. **质量把控**：评估视频是否达到预期效果
3. **优化指导**：获取具体的改进建议
4. **内容审核**：检查视频内容是否符合要求

## 进阶资料

当需要系统解读评分、决定返工优先级或归纳常见问题时，读取 `references/evaluation-matrix.md`。