resolve-mcp

DaVinci Resolve MCP — 索引

DaVinci Resolve MCP 任务的导航指南。这是地图，不是详解——下方每个领域技能都有自己的路由规则，并根据各自的 description 触发。打开匹配的技能；如果任务跨越多个领域，则使用本索引。本技能不会自动加载其他技能，只会指向它们。

两个服务——离线计算，实时应用

• 实时 — davinci-resolve（Python）：通过脚本 API 驱动正在运行的 Resolve。
• 高级／离线 — davinci-resolve-advanced（Node）：编写 .drp／.drt／.drx 文件并修补项目 DB，无需打开 Resolve。

经验法则：离线计算调色、QC 和套底数学，然后实时应用结果。Node 不会驱动 Resolve。

领域

任务	技能	核心文档	任意 MCP 客户端提示词
调色、视觉风格、镜头匹配、LUT/CDL/DRX	resolve-color	color-grade-kernel.md	/color_grade_workflow
剪辑、修剪、范围、变体、变更列表	resolve-edit	timeline-edit-kernel.md	/timeline_edit_workflow
套底、重新链接、成片 QC、调色追踪	resolve-conform	timeline-conform-interchange-kernel.md	/conform_workflow
渲染、交付物 QC、媒体／来源信息	resolve-delivery	render-deliver-kernel.md	/delivery_workflow
Fusion 合成（标题、MG、VFX）	resolve-fusion	fusion-composition-kernel.md	/fusion_workflow
音频／Fairlight（音轨、总线、响度）	resolve-audio	audio-fairlight-kernel.md	/audio_workflow
媒体池导入／整理／多机位	resolve-media-pool	media-pool-ingest-kernel.md	/media_pool_workflow
读取／分析源媒体	resolve-media-analysis	media-analysis-guide.md	/analyze_media

较少见的领域（没有专用技能——直接使用核心文档／工具）

这些领域有实际覆盖，但使用频率较低，因此通过本索引路由，而非使用专属技能：

• 项目生命周期 — 创建／导出／导入／归档／恢复项目、数据库、设置、预设：project_manager 组合工具 → docs/kernels/project-lifecycle-kernel.md。离线 DB 读取／修补：高级 project_read／project_db（项目必须关闭，并退出／重新启动 Resolve）。
• 审阅／注释 — 时间线标记、审阅报告、注释复制／移动／范围：timeline_markers → docs/kernels/review-annotation-kernel.md。 离线审计／溯源：高级 provenance。
• 扩展编写 — 安装／移除 Fuse/DCTL/Lua-Python 插件： script_plugin → docs/kernels/extension-authoring-kernel.md、 docs/authoring/。
• 流水线（以 DB 为准） — 使用 YAML 编写规范项目 DB，通过关卡和溯源执行分阶段运行，并检测偏差：高级 pipeline 工具 → resolve-advanced/README.md。

承诺某项能力前，先确认构建版本

脚本 API 会随 PATCH 版本更新，而不是只随主版本更新。“Resolve 21” 这个标签还不够精确，无法据此判断：GetFairlightPresets 在 20.2.2 中存在， 但在 19.1.3 中不存在；21.0.4 中报告的三个接口在 21.0.2 中也不存在。 不了解构建版本就给出指导，Agent 就可能坚持说某个方法存在，实际上却并非如此（issue #132）。

因此，在说明哪些操作可行之前：

1. resolve_control get_version → 记录 version_string（Resolve 构建版本）和 mcp.version（此服务的版本）。
2. resolve_control check_version_support → 查看此构建版本未通过的所有已记录版本门槛。提供 symbol 时，则会针对单个方法给出结果。
3. resolve_control api_truth "<topic>" → 每条事实现在都带有 version_context，说明该事实是在更旧、更新还是相同的构建版本上测得。较旧版本上的测量结果只是先验参考，不是结论。

有两种值得指出的失败模式，因为它们都不会自行提示：

• unknown 是最常见的答案，它的意思是要进行探测，而不是肯定。 只有有已记录证据的接口才会设置版本门槛；API 的大部分内容从未经过版本二分测试。不在不可用列表中，并不代表某个方法一定存在。
• mcp.version 是此进程启动时使用的版本。 运行中的服务会继续执行该版本，因此 git pull 不会刷新记录，必须重启服务才行——api_truth 未命中可能意味着“服务已过时”，而不是“没有已知问题”。

如果某个构建版本太旧，无法满足请求，请明确说明并指出最低版本。不要提供调用方式后再让它失败。

通用规则（始终适用）

• 源媒体至关重要（AGENTS.md）：除非用户明确要求，否则绝不修改、转码、转换、代理、重新链接或派生源媒体。输出应放在 sidecar、临时目录或分析项目根目录中。
• 先看帧，再调色：应用任何 grade/look/LUT/CDL/DRX 前，先检查 Resolve 渲染的帧，并保留可恢复的调色版本。
• 高级服务的防护机制会拒绝操作，而不是伪造结果——重试前先阅读“refused”消息（通常是值空间错误、帧采用对数编码、缺少媒体，或缺少可选依赖；请调用高级 capabilities 工具）。

深入参考

• AGENTS.md — 权威说明，以及 ## Domain Routing 索引（适用于所有平台）。
• docs/SKILL.md — 两个服务的操作参考。
• docs/kernels/ — 各操作的深入说明。resolve-advanced/README.md — 离线目录。