mcpField
E
edit-handoff

edit-handoff

github.com/scrollmark创意与媒体1644 次安装1 天前更新
代码仓库

关于 edit-handoff

为 video-studio 视频剪辑交接提供指导，涵盖 Premiere Pro、DaVinci Resolve、Final Cut Pro 和 CapCut 的导出方式，并说明哪些内容会保留、哪些需在编辑器中重建。

主要功能

  1. 01按编辑器选择导出格式
  2. 02保留剪辑、源文件链接和音频
  3. 03说明效果与标题的限制
  4. 04将媒体与时间线打包

适用场景

  1. 01为其他编辑器准备时间线
  2. 02为 Final Cut Pro 选择交接方式
  3. 03避免导出错误项目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/scrollmark/social-skills --skill edit-handoff

安装后在 Claude Code 中输入/edit-handoff确认已加载。

详细介绍

编辑交接

“我能在 Premiere 里完成这个吗？”说的是交接，不是渲染。工作是完成剪辑中繁琐的那一半——把 40 个剪切点精确到实际帧，每个片段都指向真实源文件，音频保持同步——同时还要准确说明哪些内容不会保留下来，因为含糊不清会让剪辑师白白耗上一下午。

要求

pip install 'video-studio-engine[export] @ https://github.com/scrollmark/social-skills/archive/refs/heads/master.tar.gz' 涵盖全部三个导出器（export_fcpxml、export_capcut、export_edit）；只有 export_edit 需要 [export] 这个可选依赖组，用于 OpenTimelineIO。它们都不会随包一起安装——每个导出器都会读取引擎的时间线文档和合成器目录。不安装，就无法导出。能保留下来的，是下文所述的判断；它适用于任何 OTIO 或 FCPXML 交接。字幕也不会保留下来——合成器会根据 props 绘制字幕——因此可使用 video-studio burn_captions 将字幕烧录为像素，或写入 .ass 文件。

导出格式与目标应用

目标脚本导出方式
Premiere Pro、DaVinci Resolvevideo-studio export_edit.otio，原生导入——无需插件
Final Cut Provideo-studio export_fcpxml.fcpxml 1.9，可作为真实项目打开
CapCutvideo-studio export_capcut --install覆盖现有项目中的 draft_info.json
上述任一应用，另一台机器添加 --bundle将媒体复制到时间线旁边
video-studio export_edit --project <dir>

务必传入 --project。 它会先重新构建该项目的时间线。合成器的 props 文档是全局的，因此导出未构建的项目会悄无声息地输出最近一次渲染的视频——文件有误，却看起来完全正确。

没有 .prproj 写入器，而且也不应该有：Premiere 的格式未公开，且随应用版本变化；逆向工程的写入器会在他人的剪辑项目中悄然出错。Adobe 支持的导入方式包括 OTIO、FCP7 XML、AAF 和 EDL。FCPXML 则恰好相反——Apple 公开了这种格式，因此 Final Cut 有专用写入器。

能保留的内容

在所有应用中都能保留： 每个剪切点都精确到实际帧，每个片段都链接到真实源文件，以及每个场景的旁白、音乐和作为侧车文件提供的字幕 .srt（Premiere 会将其导入为字幕轨道）。

通用路径无法保留的内容： 摄像机运动、淡入淡出和画面中的卡片。这并非导出器的缺陷——这些交换格式根本不承载任何效果；OTIO 自己的兼容性矩阵也将效果标记为在 EDL、FCP7 XML、FCP X 和 AAF 中均不受支持。因此，卡片会作为时间线标记并附带卡片文字，放在各自出现的帧上；摄像机运动也会用同样的方式标记。剪辑师拿不到标题，只会看到一个标注了原内容的占位点。

Final Cut 是值得特别指出的例外。 export_fcpxml 会将卡片写成 Final Cut 的 Basic Title 生成器中的真实 <title> 元素，并将摄像机运动写成带关键帧的 <adjust-transform>；两者都能在检查器中编辑。在真实项目上的测试显示，通用 OTIO→FCPX 适配器两者都没有生成。如果卡片很重要，而且剪辑师使用 Final Cut，请选择这条路径。

CapCut 需要先创建空项目

请用户直接在 CapCut 中新建项目（文件 > 新建项目，保存，不添加任何内容），然后提供项目路径。脚本不会创建文件夹。真实项目包含十几个未公开的同级文件——draft_meta_info.json、draft_settings、Resources/、matting/——只有 CapCut 知道如何写入这些文件；缺少这些文件的文件夹会出现在草稿列表中，但点击后毫无反应。卡片在这里同样无法保留。

反模式

  • 导出时未使用 --project。 失败不会提示，而且会导出错误的视频。
  • 说“它会导出整段视频”。 它导出的是剪辑片段。效果会重新构建。
  • 承诺 OTIO 路径会包含卡片。 卡片会作为标记导入。只有 FCPXML 会携带卡片。
  • 声称经过应用测试。 FCPXML 通过解析自身输出进行验证，而不是在 Final Cut 中打开验证。请明确说明是哪一种。

评论

支持 Markdown