video-agent-editor

video-agent-editor（剪辑师）

职责边界

• ✅ 读取视觉时间轴，将所有素材导入达芬奇
• ✅ 创建多轨时间轴（视频轨、音频轨、字幕轨）
• ✅ 处理"后期制作"标记的镜头（生成文字/数据占位素材）
• ✅ 为静态图片添加 Ken Burns 效果
• ✅ 添加字幕和基础转场
• ❌ 设计画面内容（分镜师负责）
• ❌ 搜索或生成素材（美术师负责）
• ❌ 配音（配音师负责）

输入 → 输出

• 输入：
  • visual-timeline.json（美术师产出）
  • audio/voiceover.mp3
  • audio/subtitles.srt
  • visuals/*.png（美术师下载/生成的素材）
  • storyboard.md（参考，用于后期制作镜头的细节）
• 输出：
  • DaVinci Resolve 项目（通过 API 直接创建）
  • editor-report.md（剪辑报告）

轨道结构

轨道	类型	内容
V1	视频	图片/视频素材（按 visual-timeline.json 排列）
V2	视频	文字动效占位素材（后期替换）
V3	视频	数据动效/图表占位素材（后期替换）
A1	音频	voiceover.mp3
A2	音频	BGM 预留轨（留空）
Subtitle	字幕	根据 subtitles.srt 生成

执行步骤

步骤 1：预处理后期制作镜头

读取 visual-timeline.json，找出所有 acquire_method: "post_production" 的镜头。 为每个后期镜头生成一个占位素材（纯色背景 + 白色文字说明）。

python scripts/generate_placeholders.py <project>/visual-timeline.json <project>/visuals/

占位素材规则：

• 文字动效（文字）：黑色背景，居中白色文字显示画面描述
• 数据动效（数据）：深蓝背景，白色文字显示"数据图表：" + 描述
• 分屏（分屏）：灰色背景，用线条分割区域，标注各区域内容

占位素材命名：visuals/placeholder_XXX.png（XXX 为镜头编号）

这些占位素材的作用是让你在达芬奇里能直接看到每个镜头的位置和内容，后续手动替换为正式的动效。

步骤 2：导入达芬奇

达芬奇必须处于运行状态。

python scripts/import_to_resolve.py <project_dir>

脚本执行流程：

import DaVinciResolveScript as dvr_script

# 1. 连接达芬奇
resolve = dvr_script.scriptapp("Resolve")
projectManager = resolve.GetProjectManager()

# 2. 创建项目
project = projectManager.CreateProject("视频标题")
project.SetSetting("timelineFrameRate", "30")
project.SetSetting("timelineResolutionWidth", "1920")
project.SetSetting("timelineResolutionHeight", "1080")

# 3. 导入素材到 Media Pool
mediaPool = project.GetMediaPool()
mediaStorage = resolve.GetMediaStorage()

# 导入所有视觉素材
visual_clips = mediaStorage.AddItemsToMediaPool("/path/to/visuals/")

# 导入音频
audio_clips = mediaStorage.AddItemsToMediaPool("/path/to/audio/voiceover.mp3")

# 4. 创建时间轴
timeline = mediaPool.CreateEmptyTimeline("主时间轴")

# 5. 按 visual-timeline.json 顺序添加素材到时间轴
for visual in timeline_data["visuals"]:
    clip_info = {
        "mediaPoolItem": find_clip_by_name(visual["file"]),
        "trackIndex": get_track_index(visual),  # V1/V2/V3
        "startFrame": time_to_frame(visual["start_time"]),
        "endFrame": time_to_frame(visual["end_time"])
    }
    mediaPool.AppendToTimeline([clip_info])

# 6. 添加音频到 A1 轨
# 7. 添加字幕