Agentic 视频编辑

Primitive-First 工作流

ScreenKite 的 agentic 编辑保持得很简单：应用只暴露确定性的编辑 primitive，而规划、转录推理和编辑策略由你的 agent 负责。

推荐循环

1. 先读取 getProjectState(scope: "summary")、getProjectState(scope: "layout") 和 getProjectResources()。
2. 当时间点很关键时，先导出转录，再在修改时间线之前规划 beats。
3. 修改画幅前先运行 setCanvas(..., dryRun: true)，做复杂布局前先运行 setSceneLayout(..., dryRun: true)。
4. 用 editTimeline 做时间线编辑，用 setSceneLayout 做构图修改，用 manageEffects 做效果处理。
5. 需要 shorts 或其他画幅时，用 exportArtifact(type: "range", settings.canvasOverride) 导出，不要直接改 long-form 项目。
6. 每一批修改后，用 getProjectState(scope: "visual") 或 snapshot 导出来验证。

各个 primitive 适合做什么

• editTimeline：切段、修剪、按单词边界清理
• setSceneLayout：按时间范围修改构图，包括 advanced layout DSL
• manageEffects：字幕、缩放和其他效果处理
• vfxExportVideoSegment 配合 vfxOverlayProcessedClip：外部渲染 round-trip
• exportArtifact：最终文件、snapshot、SRT 和 range 导出

护栏

• 不要在单词中间切开。只要语音节奏重要，就按转录里的单词边界处理。
• 发生 timeout 后，如果要重试 mutating call，先重新读取 project state。
• 把 overlay 渲染放回时间线之前，先确保它的宽、高、fps 和帧时长与目标构图完全一致。
• 自检循环不要无限跑。如果做了几轮可视化检查还是不对，就直接检查 layout 或源素材。