无头剪辑循环如何用davinci-resolve-mcp纯命令行完成导入、组接与往返校验【免费下载链接】davinci-resolve-mcpMCP server integration for DaVinci Resolve Studio项目地址: https://gitcode.com/gh_mirrors/da/davinci-resolve-mcpdavinci-resolve-mcp 是一个通过 MCP 协议驱动 DaVinci Resolve 的开源服务器。借助它的无头剪辑循环你可以不打开图形界面仅用命令行完成媒体导入、时间线组接以及反复的导出 → 修改 → 重新导入往返校验。整条链路在-nogui模式下与 GUI 完全等价仓库中 238 组对照测量显示没有任何一项能力有界面才行、无界面失败。什么是无头剪辑循环无头headless模式指用-nogui参数启动 DaVinci Resolve进程照常运行、脚本 API 照常监听只是没有窗口。剪辑循环则是一个自动化的迭代闭环导入媒体 → 2. 组接时间线 → 3. 导出为交换格式如 FCP7 XML→ 4. 在 Resolve 外部修改文件 → 5. 重新导入 → 6. 读回结构校验确认帧级一致然后回到第 3 步。适合场景批量粗剪迭代、CI 流水线里的自动 conform、需要反复试错哪一版剪辑更好的自动化流程。快速安装与连接检查先安装 davinci-resolve-mcp 并确认外部脚本可用打开 Resolve Studio在Preferences General External scripting using中设为Localnpx davinci-resolve-mcp setup若偏好从源码使用可克隆仓库后运行 install.pygit clone https://gitcode.com/gh_mirrors/da/davinci-resolve-mcp cd davinci-resolve-mcp python install.py无头启动 DaVinci Resolve 的完整步骤仓库自带批量/CI 入口 scripts/resolve_headless.py把检查单例 → 启动 → 等待可脚本化 → 停止四件事封装成子命令python scripts/resolve_headless.py status # 当前有什么在运行、什么模式 python scripts/resolve_headless.py guard # 不安全则拒绝继续 python scripts/resolve_headless.py start # 以 -nogui 启动并等待可脚本化 python scripts/resolve_headless.py run -- python my_batch.py # 守卫启动运行停止 python scripts/resolve_headless.py stop # 干净 Quit() 退出两个必须知道的前提⚠️一台机器只能有一个 Resolve 实例应用、渲染节点、脚本启动共用同一个单例所以先guard再start。提交-nogui前花 30 秒做预检python scripts/resolve_headless.py run -- python -c print(ok)。输出ok证明启动即可脚本化FAILED: no scripting response时该命令会自动清理它启动的实例。导入媒体并组接第一条时间线首次组接不需要任何交换文件——直接走脚本 API 即可帧级精确clips resolve.GetMediaStorage().AddItemListToMediaPool(paths) # 导入媒体 timeline pool.CreateEmptyTimeline(CUT_v001) # 新建时间线 pool.AppendToTimeline([ {mediaPoolItem: clips[0], startFrame: 0, endFrame: 191}, {mediaPoolItem: clips[1], startFrame: 24, endFrame: 71}, ])两个实测过、容易浪费你整晚的坑endFrame是包含最后一帧的传frames而不是frames - 1否则什么都不会追加。不要为了复制同一段 N 次去用CreateTimelineFromClips([clip] * n)——它会去重15 份拷贝会悄悄变成 1 份。请逐份AppendToTimeline并断言最终帧数。往返循环导出、修改、重新导入进入循环后推荐FCP7 XML或 AAF作为交换格式它不复制媒体、时间线名可控实测连续 5 轮导入全部成功且源入点精确保留timeline.Export(str(path), resolve.EXPORT_FCP_7_XML, resolve.EXPORT_NONE) # ... 在外部修改 XML换剪点、调轨道、写元数据都行... options { timelineName: CUT_v002, # 每轮导入必须唯一 importSourceClips: False, # 复用媒体池不重复导入 sourceClipsFolders: [pool.GetRootFolder()], } timeline pool.ImportTimelineFromFile(str(path), options)格式怎么选官方指南按任务给出了三选一你的需求推荐格式原因完整保真、一次性交接DRT唯一完整保留变换、颜色、旗帜与标记的格式反复迭代的往返循环FCP7 XML / AAF不复制媒体、时间线名可控DRT 两者都不行媒体已被搬走、要重新 conformFCP7 XML / AAF / FCPXML 1.10实测仅有的三种能重新链接媒体的格式一个反直觉的陷阱DRT 看似原生必选但timelineName等选项对它无效且每次导入都会把源媒体再复制一份进媒体池——适合一次性交接不适合跑一百次的循环。往返校验如何确认剪辑帧级一致校验的铁律验证结构而不是返回值。实测中所有失败案例的 API 调用都返回了成功所以每轮导入后都要读回比对读回片段数量与每个片段的GetLeftOffset()和你预期的剪辑点对上复杂剪辑双视频轨音频逐片段变换颜色标记下FCP7 XML 保留缩放/平移/旋转仅丢FlipXAAF 会把变换整体重置为默认值FCPXML 1.10 会悄悄丢一条音轨——选格式就是选保真度平铺的单轨剪辑所有格式都帧级一致别用简单场景下结论。完整数据表可复跑 scripts/roundtrip_matrix.py 重新生成原始运行记录在 docs/reference/evidence/ 中。每轮迭代的版本还能在控制面板的时间线历史页归档随时回看哪一版更对无头剪辑常见陷阱清单⚠️重复的timelineName会静默失效同名导入第 2、3 次直接返回None无错误无异常。循环里名称必须每轮唯一。⚠️文件内部名字会压过timelineNameXML 里sequencename没改重导入拿回的永远是旧时间线。用 MCP 的timeline.import_timeline_checked可自动改写内部名并在拿回旧时间线时报错。⚠️FCPXML 1.10 导出的是目录不是文件导入前把路径指向其中的Info.fcpxml成员。⚠️无头下绝不对未命名项目调SaveProject()GUI 里它弹个保存框无头模式下它永久阻塞整个应用。仓库提供了安全封装 src/utils/project_cleanup.pysave_project_if_safe先确认项目名再保存。⚠️收尾顺序CloseProject→LoadProject(某个已命名项目)→DeleteProject。CloseProject才是释放会话锁的那一步直接落在不可保存的默认项目上才会引出下一个弹窗。延伸阅读完整循环指南与全部实测数据docs/guides/headless-edit-loop.md无头能力矩阵与启动/稳定性测量docs/reference/headless-cli.md往返保真度参考docs/reference/roundtrip-fidelity.mdAAF conform 与重链接细节docs/guides/conforming-an-avid-aaf.md无头模式能力上与 GUI 完全对等且渲染输出逐字节一致——放心把导入、组接与往返校验交给命令行。唯一保留项长时间持续编码的稳定性未经全片级验证正式交付前建议用自己的素材校准并保留 GUI 兜底。【免费下载链接】davinci-resolve-mcpMCP server integration for DaVinci Resolve Studio项目地址: https://gitcode.com/gh_mirrors/da/davinci-resolve-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
