企业官网建设流程全解析

不开Resolve也能改工程：davinci-resolve-advanced-mcp离线编辑drp/drt/drx文件揭秘

【免费下载链接】davinci-resolve-mcpMCP server integration for DaVinci Resolve Studio项目地址: https://gitcode.com/gh_mirrors/da/davinci-resolve-mcp

davinci-resolve-advanced-mcp 是 davinci-resolve-mcp 项目里隐藏的"离线编辑"服务端：它不需要打开 DaVinci Resolve，就能直接读取和修改工程文件.drp、时间线文件.drt、调色文件.drx，还能批量注入调色、重排节点图、做离线 Conform 检查。本文带你搞懂它是什么、能干什么、如何两步接入。

为什么需要"不开 Resolve"的离线编辑？

通常用 MCP 控制 DaVinci Resolve，走的是官方 Scripting API——前提是本机必须有 Resolve 在运行。但现实里经常遇到这些场景：

• 🌥️云端/服务器环境：CI 机器、渲染农场上没有安装（也没有 GPU 驱动的）Resolve；
• 📦批处理工程文件：收到一个.drp，想批量改时间线、换素材、注入调色，不想逐台开软件；
• 🔒文件级审查：做 Conform、素材核对、交付质检，只读文件就能完成，不必加载工程；
• 🎨离线算调色：从截帧直接算出色度方案，生成.drx后再回 Resolve 应用。

davinci-resolve-advanced-mcp就是为此而生的：它不驱动应用，而是直接编辑 Resolve 的文件格式和数据库，所以云和本地通吃，且核心为纯 JS 实现、零必需原生依赖，装完即用（详见 resolve-advanced/README.md）。

davinci-resolve-advanced-mcp 是什么：一次安装，两个 MCP 服务

npm 包davinci-resolve-mcp一次安装，自带两个独立服务：

它提供 18 个工具：drp、drt、drx、offline_ref、conform、color_trace、fusion、audio、audio_plan、fairlight、project_db、project_read、pipeline、capabilities、deliverable、media、editorial、provenance。除 MCP 服务外，它还能当库直接import使用，公开 API 按 codec（格式编解码）、grading（确定性调色计算）、pipeline（DB-as-truth 流水线）、tools（工具处理）分组，见 server/lib.mjs。

配套的本地浏览器控制台可以查看工程状态；离线服务处理文件期间，它依然是查看实时状态的窗口。

三种文件离线编辑玩法：drp、drt、drx 分别能做什么

.drp 工程文件：从零搭工程，到批量改时间线

drp工具覆盖工程文件的创建、搭建、编辑、调色注入、结构对比（实现见 drp.mjs），常用动作包括：

• 从零创建：create_empty_project、assemble_timeline、add_media_clip——不用打开 Resolve 就能生成一个合法工程；
• 摆元素：place_fusion_title（Fusion 字幕）、place_generator（色条等发生器）、place_transition（转场）；
• 时间线手术：move_clip、delete_clip、trim_clip、split_clip、ripple_timeline，支持按轨道/DbId/名称选片；
• 换素材：relink_media、repoint_media——素材挪窝后批量重指路径；
• 调色注入：inject_grades把.drx内容写进指定片子的调色节点，extract_node_graphs反向导出节点图；
• 节点图重排：relayout_node_graphs就是 UI 里那个没有 API 的 "Cleanup Node Graph"——整个工程里每张节点图都按 RGB 连线拓扑排成 Resolve 的"干净行"，调色字节一个不动，还支持 dry-run 预览与读回校验。

.drt 时间线文件：从 EDL/OTIO 甚至 PR 工程生成可导入时间线

.drt是 Resolve 原生时间线格式（zip+XML），drt工具（见 drt.mjs）支持：

• parse/validate：解析与校验，列出所有 SeqContainer；
• inject_into_drp/extract_from_drp：把时间线从工程里拆出来/植回去，本质是 zip 条目的拷贝，所以无损；
• assemble：真正的杀手锏——从EDL、OTIO、XMEML、AAF 乃至 Premiere 的.prproj生成一个Resolve 可直接导入的.drt，连转场、变速/倒放、多轨、字幕、标记都能带上。这意味着不用 Premiere就能把 PR 工程的时间线搬进 Resolve，是官方脚本 API 完全做不到的事；
• 细节上它还会按目标版本重写ProjectVersion时间戳，保证老版本 Resolve 也能顺利导入。

.drx 调色文件：离线算出色调，再注入工程

drx工具（见 drx.mjs）是"每个片子的调色"编解码器：parse（解析节点图/调色器/曲线/限定器）、generate（参数→.drx）、export_cdl（导出 ASC CDL）、merge（往已有.drx上嫁接节点）。更妙的是它内置了一套离线调色/QC 目录，全部本地确定性计算：

工作模式是：你负责抽帧（ffmpeg），引擎离线算出.drx，回 Resolve 应用——缺帧就跳过、绝不伪造匹配。

典型工作流：节点图重排、ColorTrace 与 Conform 检查

三个进阶能力特别值得一提：

• ColorTrace（color_trace.mjs）：按介质身份（pool item id / 文件路径 / 盘片号 + 源区间重叠）匹配两条时间线，把源工程里已调色的片段无损搬运成.drx+ 应用计划；官方实测 878 片 conform、254 个调色、0 失败；
• 离线 Conform（conform.mjs）：基于帧级数学（而非文件名匹配）的素材重链 QC、反向片库修复、逐刀口帧 QC，还能直接吃 Resolve 自己的 FCP7 导出；
• 交付质检（deliverable.mjs）：ffprobe 渲染件对照规格逐项判定 pass/fail、EBU R128 响度 QC、广播安全/黑场检查——只报告、不替你放行。

这些动作在控制台里都会留下可审查的计划记录：

快速上手：把 davinci-resolve-advanced-mcp 接入 MCP 客户端

安装只需一条命令（两个服务一并装好）：

npx davinci-resolve-mcp setup

然后在任意 MCP 客户端（Claude Desktop、Cursor、Cline 等）里指向高级服务的入口即可，例如：

{ "mcpServers": { "resolve-advanced": { "command": "node", "args": ["/path/to/bin/davinci-resolve-advanced-mcp.mjs"] } } }

环境要求是 Node.js ≥ 20.9（见 resolve-advanced/package.json）。少数功能需要你自己补装可选依赖，缺了会给出明确提示而不是崩溃：ffmpeg（音频操作/帧对比）、sharp（调色目录帧计算）、better-sqlite3（项目 DB 流水线）、js-yaml（YAML 编译）。完整安装说明见 docs/install.md。

离线编辑的边界：哪些操作还需要 Resolve

说句公道话，离线服务不是替代品，而是互补：

• ✅纯文件层：.drp/.drt/.drx读写、格式互转、结构对比、调色计算——完全离线；
• ⚠️需要 Resolve 的：真正把.drx应用到运行中的时间线、预览与最终渲染、AAF 的实时导入（Python 服务可原生读 AAF）。官方推荐的配合方式是"离线规划 + 在线执行"，无头跑批的完整回环见 docs/guides/headless-edit-loop.md。

源码与文档索引

• 高级服务端总览：resolve-advanced/README.md
• 18 个工具处理器：resolve-advanced/server/tools/
• 格式编解码库（drp/drt/drx 的 MIT 实现）：resolve-advanced/vendor/
• 无头回环指南：docs/guides/headless-edit-loop.md
• 无头 CLI 参考：docs/reference/headless-cli.md

一句话总结：把 Resolve 的文件当"可编程对象"，davinci-resolve-advanced-mcp 让你在不打开软件的前提下完成批量工程改造、离线调色与交付质检——这正是它被称为"beyond-the-API"的原因。

【免费下载链接】davinci-resolve-mcpMCP server integration for DaVinci Resolve Studio项目地址: https://gitcode.com/gh_mirrors/da/davinci-resolve-mcp