> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 视频工作区

> 多模型视频生成流水线，包含 Storyboard 和 Timeline 工作区

## 概述

视频工作区支持 AI 驱动的视频创作流程。当项目 `type: "video"` 时，工作区右侧的轨迹/文件标签页将替换为 **Storyboard（分镜）** 和 **Timeline（时间线）** 面板，左侧对话使用 Agent 的 ReAct 模式编排生成流程。

## 架构

```
┌─────────────────────┐     ┌──────────────────────────────────┐
│    对话区 (左侧)     │     │     视频工作区 (右侧)             │
│                      │     │  ┌──────────┐ ┌──────────┐      │
│  CreativeBriefCard   │     │  │ Storyboard│ │ Timeline │  TOC │
│  ScriptCard          │     │  │   面板    │ │   面板   │      │
│  StoryboardCard ─────┼────►│  │          │ │          │      │
│  VisualGenPathCard   │     │  └──────────┘ └──────────┘      │
│  VisualAssetsCard    │     └──────────────────────────────────┘
│  AudioAssetsCard     │
│  TimelineLinkCard ───┼────► Timeline 面板
└─────────────────────┘
```

### 流水线阶段

| 阶段 | Agent Skill              | 输出卡片              | 后端工具                                                                                  |
| -- | ------------------------ | ----------------- | ------------------------------------------------------------------------------------- |
| 1  | `creative-brief`         | CreativeBriefCard | `video_output_creative_brief`                                                         |
| 2  | `script-writer`（可选）      | ScriptCard        | `video_output_script`                                                                 |
| 3  | `storyboard-designer`    | StoryboardCard    | `video_plan_storyboard`                                                               |
| 4  | `visual-gen-path`        | VisualGenPathCard | `video_output_visual_gen_path`                                                        |
| 5  | `visual-media-generator` | VisualAssetsCard  | `video_generate_element_image` / `video_generate_start_frame` / `video_generate_shot` |
| 6  | `audio-media-generator`  | AudioAssetsCard   | `video_generate_narration` / `video_generate_music`                                   |
| 7  | `video-assembler`        | TimelineLinkCard  | `video_assemble_timeline`                                                             |

工具 Skill：`resource-analyzer` — 用户上传参考素材时自动触发。

### Storyboard 数据模型

```
videoStoryboard
├── storyboardElement (关键元素)
│   └── elementAsset (图片版本)
├── storyboardSegment (段落)
│   └── storyboardShot (镜头)
│       └── shotAsset (起始帧 + 视频版本)
└── storyboardAudio (旁白 & 音乐)
    └── audioAsset (音频版本)
```

所有表定义在 `apps/web/src/db/schema/video.ts`。

## SSE 事件

| 事件                      | 方向      | 用途               |
| ----------------------- | ------- | ---------------- |
| `video_storyboard_init` | 后端 → 前端 | 初始 Storyboard 推送 |
| `video_element_update`  | 后端 → 前端 | Element 资产更新     |
| `video_shot_progress`   | 后端 → 前端 | Shot 生成进度        |
| `video_shot_complete`   | 后端 → 前端 | Shot 生成完成        |
| `video_audio_complete`  | 后端 → 前端 | 音频生成完成           |

由 `stream-processor.ts` 处理，更新 `videoStore`（Zustand）。

## 引用机制

用户可通过 Element / Shot / Audio 卡片上的引用按钮，将 Storyboard 项目引入对话框，格式为 `[[ELEMENT:name|id]]` / `[[SHOT:name|id]]` / `[[AUDIO:name|id]]`，Agent 据此精准定位修改对象。