edit — 剪辑 → 成片,在故事所指的软件中完成 是做什么的?
影片在作者将继续工作的剪辑软件中完成剪辑。config.json 中指明了位置:
"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
| Key | 含义 |
|---|---|
id | none — 你独自使用 ffmpeg 剪辑。或指定软件:davinci_resolve, premiere_pro, final_cut_pro, capcut, 或作者给出的其他名称。 |
mcp | 当该软件的 MCP 服务器已安装并在你的客户端中连接时,设为 true。 |
computer_use | 当你可以操控屏幕时(Claude 的计算机使用能力,或你工具的等价功能),设为 true。 |
notes | 可选的自由文本:软件的版本、版本号、项目位置。 |
没有 editor 键等同于 { "id": "none" }。
第 0 步 — 验证所有片段(每个路径都要做)
无论使用何种剪辑软件,先执行 assemble 技能的第 1 步:每个模块都有一个片段,按顺序,以其实际时长存在。基于缺失模块剪辑而成的影片,就是一部有洞的影片。
路径 A — editor.id: "none":你即是剪辑师
遵循 assemble 技能。输出是 renders/final/film.mp4。这就是整个阶段的全部。
路径 B — 指定软件:在软件中剪辑
B1. 检查你可触及的范围,然后告知作者
在接触任何内容之前,确认 config.json 中的声明是否真实:
- MCP: 调用该软件服务器上的一个只读工具(对于 DaVinci Resolve,是项目或时间线列表)。如果失败,打印
config.jsonmcp_servers中该服务器的安装命令(npx storyseam mcp --agent <yours>;对于 Resolve,是npx davinci-resolve-mcp setup)并等待。只有在作者确认该服务器不打算存在之后,才将editor.mcp设为false。切勿自行安装。 - 计算机使用: 截取一张屏幕截图,确认软件已打开,或者可以打开。
然后用一句话告诉作者你将采用哪种模式工作,并且在接管屏幕之前必须请求许可:计算机使用会控制他们的鼠标和键盘。
B2. MCP 与计算机使用协同工作
两者单独使用都不够,在每一步同时使用两者能获得最佳效果:
- MCP 执行精确、可重复的工作: 以故事的分辨率和帧率创建项目和时间线,按模块顺序导入
renders/clips/block_NN.mp4,将每个片段在 V1/A1 上首尾相连地放置,根据shotlist/shotlist.json为每个模块添加标记,设置渲染设置,并启动渲染。精确无误,无错点。 - 计算机使用是你的眼睛,也是你在 API 触及不到之处的手: 在每一步 MCP 操作后截图,确认它确实完成了所报告的操作;在查看器中逐帧检查每个拼接点,查看两侧的画面;检查音频表;并处理 MCP 无法暴露的任何内容(对话框、面板、拖拽操作、没有 API 的设置项)。
- 绝不要信任你未曾亲眼查看过的 MCP 成功消息。 以错误帧率导入的片段、以错误分辨率创建的时间线、或空的渲染队列,都会报告成功。
当只有一种能力可用时:
mcp | computer_use | 工作方式 |
|---|---|---|
| true | true | 两者并用,如上所述。这是默认且最佳的方式。 |
| true | false | 仅使用 MCP。告知作者剪辑结果未经肉眼验证,请他们亲自检查拼接点。 |
| false | true | 仅使用计算机使用。这会更慢,所以告知作者,并保持每一步操作很小,每次操作后截图。 |
| false | false | 你无法操作该软件。编写 renders/edit/timeline.edl(CMX 3600 格式,根据 shotlist.json 和片段的实际时长,按顺序每个模块一个事件),告诉作者如何导入它,并通过 assemble 技能同时生成 renders/final/film.mp4,以便无论哪种方式都能有一部影片。 |
B3. 剪辑步骤
- 项目以
storyseam.md的title命名,使用片段的实际分辨率和帧率(使用ffprobe检查一个片段,不要假设)。 - 一条时间线。模块按顺序放在 V1 上,其音频放在 A1 上,无间隙,无重叠。
- 每个模块一个标记,以其模块 ID 和第一个镜头命名。
- 为作者留出一条空白的音乐轨道(A2)。切勿添加音乐。 配乐是作者的工作,应放入
assets/audio/music/。 - 渲染输出到
renders/final/film.mp4(H.264 视频编码,AAC 音频编码,时间线的分辨率),并将软件自身的项目文件保存在其默认位置。将该路径记录在editor.notes中。
B4. 软件说明
- DaVinci Resolve. 其 MCP 服务器驱动 Resolve 的脚本 API。外部脚本仅限 Studio 版;在免费版上,应用内桥接(工作区 › 脚本)是入口,而在免费版 21.1+ 中,Python 脚本已移除,因此预期将更多依赖计算机使用。在剪辑页面上处理时间线,在交付页面上进行渲染;在开始渲染之前,通过截图确认渲染队列。
- 任何其他软件。 首先寻找其 MCP 服务器。如果没有,就属于上面
mcp: false的情况。不要自行安装软件、插件或 MCP 服务器;告诉作者需要什么帮助,让他们来做。
最后一步 — 报告
报告内容:影片的路径、实际运行时长和分辨率、软件的项目文件、你采用的工作模式(MCP + 计算机使用、其中一种、或 EDL)、任何你无法通过肉眼验证的内容,以及影片设计上不包含音乐。