视频双MCP生产工作流（OpenCut-MCP + capcut-mate）
本 skill 把一条"AI 短视频自动生产线"打包好：OpenCut 负责剪映做不好的复杂矢量动画/数据图表（导出透明 WebM）→ 通过本地文件中转 → capcut-mate 把素材塞进剪映草稿，叠加实拍/AI抠像/字幕/BGM/转场 → 渲染成片。
核心心法：OpenCut 与 capcut-mate 之间没有 API 互通，靠上层 Agent 当调度中枢，本地共享文件夹当交换介质。两边强项互补，互不越界。
一、两种流水线方案
方案A（推荐，成片质感最优）—— 适合口播/解说短视频
脚本 → OpenCut生成动态图文/透明叠加 → capcut-mate搭建剪映工程 → 剪映渲染
1. Agent 拆分脚本：实拍主视频轨、片头/数据动画/文字动态 B-roll。
2. 调 OpenCut-MCP：生成图表、动态标题、信息卡、透明通道动画，导出 WebM(VP9+Alpha) 到本地 opencut-out/。
3. Agent 切 capcut-mate：建 9:16 草稿 → 实拍主素材放底层主轨 → 把 OpenCut 的 WebM 加为画中画轨道并对齐时间码 → 调用剪映 AI 字幕/配音/BGM/人像抠像/调色/转场。
4. capcut-mate 触发剪映渲染，输出成片到 final/。
> 优势：OpenCut 吃剪映弱的（代码驱动矢量动画、动态数据图）；剪映吃 OpenCut 弱的（人像抠像、发丝优化、海量BGM、中文花字、降噪）。
方案B（反向，极少用）
capcut-mate 先渲染一段实拍 → 丢进 OpenCut 二次动画叠加。不推荐：实拍在 OpenCut 调色/抠像远弱于剪映，损画质，仅适合简单文字叠加。
二、部署架构（MCP层面）
Agent 同时挂载两个 MCP Server：
- opencut（OpenCut-MCP）：控制浏览器 OpenCut 编辑器，生成+导出透明视频。
- capcut（capcut-mate）：FastAPI 服务，读写剪映草稿，操作剪映专业版。
本地共享同一素材根目录（D:/video-pipe），约定 opencut-out/ footage/ drafts/ final/ 四个子目录作中转站。
三、限制与坑点（铁律，违反即出错）
- 文件中转，不是工程互通：OpenCut 工程 JSON 与剪映 draft JSON 格式完全不兼容，只能导出视频文件当素材，禁止互转。
- 透明叠加层只用 WebM VP9 Alpha；普通 MP4 无透明通道，不能当画中画。
- OpenCut 只做画面，绝不在 OpenCut 里混主音频（易音画不同步）；配音/字幕/BGM/降噪全交剪映。
- 时间码由 Agent 统一管：每段脚本标记
[start,end](秒)，OpenCut 动画时长必须 = end-start，剪映画中画严格对齐。 - OpenCut-MCP 依赖 Playwright 无头浏览器，资源占用高、稳定性弱；原则：同项目多动画批量集中生成，单段失败重试≤2次并隔离，不因一段挂掉中断整线；渲染>180s视为失败重试。
四、适用 / 不适合
- ✅ 知识口播、解说视频，需动态图表/信息弹窗/数据动画/矢量片头叠加在真人画面。
- ❌ 纯实拍混剪、纯口播无图表动画：只用 capcut-mate 即可，多一层 OpenCut 反而增复杂度与失败点。
五、配套文件（本 skill 资源）
视频双MCP生产工作台.html：人工可视化跟踪看板（看板+分镜分工+素材中转，数据存浏览器 localStorage）。用来建项目、拆分段、标轨道和时间码，用"今天要处理"盯漏掉的环节。视频双MCP-Agent调度提示词.md：可直接复制进 Agent 的 System Prompt + 用户启动模板。让大模型自动判断哪段交 OpenCut、哪段进剪映并组装成片。mcp.json：Cursor/Claude Code 的 MCP 配置（OpenCut-MCP + capcut-mate），两个 server 共享同一本地素材根目录。README.md：总说明与坑点速记。modules/：6 个细分模块文档（脚本拆分与归属决策 / OpenCut-MCP调度 / 素材中转站管理 / capcut-mate组装 / 成片渲染导出 / 进度可视化工作台）。
六、使用步骤（落地一条视频）
- 按
mcp.json挂好两个 MCP Server，建好D:/video-pipe及四个子目录。 - 把
视频双MCP-Agent调度提示词.md的【系统提示词】粘进 Agent 当 System Prompt。 - 给 Agent 一段带时间码和归属标注的脚本（见提示词里的"用户启动模板"），它会先出"分段决策表"再自动跑。
- 同时可打开
视频双MCP生产工作台.html，手动建项目/拆分段做可视化跟踪，两边口径一致（实拍主轨/OpenCut动画/画中画叠加）。 - 成片由剪映(capcut-mate)渲染输出到
final/；BGM/配音/字幕等剪映强项在最后阶段补齐。
