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

# 视频制作（Video Production）

> profy-movie 插件的视频制作管线：从创意简报到专业时间线编辑与导出

# 视频制作

`profy-movie` 插件提供完整的 AI 辅助视频制作管线，从创意构思到最终导出。核心能力包括 AI 生成分镜、多轨时间线编辑器（Widget）、字幕生成与多格式导出。

## 架构概览

```mermaid theme={null}
graph LR
    A[创意简报] --> B[剧本]
    B --> C[分镜脚本]
    C --> D[素材生成]
    D --> E[时间线组装]
    E --> F[手动编辑]
    F --> G[字幕/导出]

    subgraph "Agent 工具"
        M["movie(action=...)"]
        T["timeline_edit(action=...)"]
    end

    subgraph "渲染面"
        W["Video Timeline Widget"]
    end

    M --> B
    M --> C
    M --> E
    M --> G
    T --> F
    E --> W
    T --> W
```

## 工具一览

### `movie` — 视频制作主工具

覆盖从创意到导出的完整流程，通过 `action` 参数选择操作：

| Action       | 说明     | 输入    | 输出                     |
| ------------ | ------ | ----- | ---------------------- |
| `brief`      | 生成创意简报 | 用户描述  | 结构化创意文档                |
| `script`     | 生成剧本   | 简报/描述 | 分场剧本                   |
| `storyboard` | 生成分镜脚本 | 剧本    | 带画面描述的分镜序列             |
| `strategy`   | 生成制作策略 | 分镜    | 模型选择、风格指导              |
| `assemble`   | 组装时间线  | 素材列表  | 多轨时间线 JSON + 打开 Widget |
| `caption`    | 生成字幕   | 视频/音频 | SRT/VTT 字幕文件           |
| `export`     | 导出成品   | 时间线状态 | 视频/素材包/项目文件/字幕         |

**示例**：

```python theme={null}
# 从描述生成分镜
movie(action="storyboard", input="30秒产品宣传片，展示智能手表的三个核心功能")

# 组装素材到时间线
movie(action="assemble", clips=["intro.mp4", "feature1.mp4", "feature2.mp4", "outro.mp4"])

# 生成字幕
movie(action="caption", source="assembled_video.mp4", language="zh")

# 导出
movie(action="export", format="mp4", quality="1080p")
```

### `timeline_edit` — 时间线程序化编辑

Agent 直接操作已打开的时间线，10 种操作覆盖常见编辑需求：

| Action             | 说明        | 关键参数                                          |
| ------------------ | --------- | --------------------------------------------- |
| `add_clip`         | 添加片段到轨道   | `track`, `asset_id`, `start`, `duration`      |
| `remove_clip`      | 移除片段      | `clip_id`                                     |
| `move_clip`        | 移动片段位置    | `clip_id`, `track`, `start`                   |
| `trim_clip`        | 裁剪片段首尾    | `clip_id`, `trim_start`, `trim_end`           |
| `split`            | 分割片段      | `track`, `clip_id`, `at`                      |
| `add_transition`   | 添加转场      | `from_clip`, `to_clip`, `type`, `duration`    |
| `add_text_overlay` | 添加文字覆盖    | `text`, `track`, `start`, `duration`, `style` |
| `adjust_speed`     | 调整播放速度    | `clip_id`, `speed`                            |
| `set_volume`       | 设置音量      | `clip_id`, `volume`                           |
| `snapshot`         | 获取时间线当前状态 | -                                             |

**示例**：

```python theme={null}
# 在轨道 0 的 0 秒处添加 5 秒片段
timeline_edit(action="add_clip", track=0, asset_id="intro_001", start=0, duration=5.0)

# 在 2.5 秒处分割片段
timeline_edit(action="split", track=0, clip_id="c1", at=2.5)

# 添加交叉淡入转场
timeline_edit(action="add_transition", from_clip="c1", to_clip="c2", type="crossfade", duration=0.5)

# 添加标题文字
timeline_edit(action="add_text_overlay", text="智能手表 Pro", track=1, start=0, duration=3.0, style={"fontSize": 48, "position": "center"})

# 获取当前时间线快照
timeline_edit(action="snapshot")
```

## Video Timeline Widget

时间线 Widget 是 Widget 渲染面的特化实例，基于 Twick SDK 提供专业级多轨编辑体验。

**核心能力**：

* 多轨视频/音频/字幕轨道
* 片段拖拽、裁剪、分割
* 转场效果预览
* 关键帧动画
* 实时播放预览

**数据流**：

```
Agent (timeline_edit) ←→ JSON-RPC Bridge ←→ Twick SDK (iframe)
                                            ↕
                                        用户手动编辑
```

Agent 的 `timeline_edit` 操作和用户手动编辑共享同一时间线状态。Agent 可通过 `snapshot` 获取用户编辑后的最新状态。

## Skill 模板系统

`profy-movie` 插件包含 Flova 风格的 7 段式视频制作方法论 Skill，以及针对特定场景的预设模板。

### 7 段式方法论

每个视频项目遵循标准化的七个阶段：

1. **创意定义** — 明确目标受众、核心信息、情绪基调
2. **剧本撰写** — 分场结构、对白/旁白、时长规划
3. **分镜设计** — 画面构图、运镜描述、转场标注
4. **制作策略** — 模型选择、风格一致性、资源预算
5. **素材生成** — AI 生成图片/视频片段
6. **时间线编排** — 组装、节奏调整、音乐匹配
7. **精修导出** — 字幕、调色、格式输出

### 预设模板

#### product-ad（产品宣传片）

适用于 15-60 秒产品展示视频。预设包含：

* 标准结构：Hook → 痛点 → 产品展示 → 功能演示 → CTA
* 推荐模型配置与风格参数
* 运镜模板（推拉、环绕、特写）

#### animated-short（动画短片）

适用于 1-3 分钟叙事动画。预设包含：

* 三幕式叙事结构
* 角色一致性指导
* 场景切换与情绪曲线
* 配乐节奏匹配

## 分镜脚本增强

分镜（Storyboard）阶段支持：

* **拖拽排序** — 调整场景顺序
* **内联编辑** — 直接修改画面描述、时长、运镜
* **标注系统** — 对单个分镜添加备注
* **版本追踪** — 保留修改历史，支持回退

## 导出格式

`movie(action="export")` 支持多种输出格式：

| 格式          | 说明                    | 用途   |
| ----------- | --------------------- | ---- |
| `video`     | MP4/WebM 视频文件         | 最终成品 |
| `assets`    | 所有素材打包（ZIP）           | 素材归档 |
| `project`   | 项目文件（JSON 时间线 + 素材引用） | 后续编辑 |
| `subtitles` | SRT/VTT 字幕文件          | 字幕分发 |

## 用户旅程

典型的视频制作流程：

```
1. 用户描述视频需求
   → Agent 调用 movie(action="brief") 生成创意简报

2. 确认创意方向
   → Agent 调用 movie(action="script") 生成剧本
   → Agent 调用 movie(action="storyboard") 生成分镜

3. 用户审阅/编辑分镜（拖拽排序、标注）

4. Agent 调用 movie(action="strategy") 确定制作策略
   → AI 模型生成各场景素材

5. Agent 调用 movie(action="assemble") 组装时间线
   → Video Timeline Widget 打开

6. 用户在 Widget 中手动微调（拖拽、裁剪、添加转场）
   → Agent 可通过 timeline_edit(action="snapshot") 获取用户编辑结果

7. Agent 调用 movie(action="caption") 生成字幕
   → Agent 调用 movie(action="export") 导出成品
```

## 相关文档

<CardGroup cols={2}>
  <Card title="渲染面" icon="window-maximize" href="/zh/documentation/plugins/rendering-surfaces">
    八种内容展示通道
  </Card>

  <Card title="A2UI" icon="grid-2" href="/zh/documentation/plugins/a2ui">
    声明式交互 UI 组件
  </Card>
</CardGroup>