resolume-cowork-helper-mcp-automation

# resolume-cowork-helper-mcp-automation **一款 AI 代理可以为您构建 Resolume 作品集和自定义的控制器快捷键布局。** 本套件证明了这一点：FFT 反应式作品集逐场景构建，一个完整的 APC40 mkII 快捷键布局已编写和验证（91 个映射、网格颜色等），甚至是自定义的 FFGL 插件 - 以及确切的复制粘贴提示，以便在您的机器上使用您的剪辑实现。无需购买；只需准备 Resolume Avenue/Arena 7、一个控制器和一个带有 Resolume MCP 的代理（Claude Code / Cowork）。 > 已在 Resolume Avenue 7.27 + Resolume MCP 7.26, Windows 11 上测试。 > 版本漂移是真实的；请在此固定您的期望。 <!-- TODO before publish: 3 GIFs - (1) the APC grid lighting up in column colors, (2) a deck playing with FFT response, (3) an agent building the layout live. Screenshots sell this better than any paragraph. --> ## 这是什么 Resolume 自己的术语中的三件事： 1. **一个完整的 Resolume 作品集，以可构建的规格交付。** “Res Fable Orbit”是一个完整的 Avenue/Arena 作品集：5 个通道 x 4 个层 x 9 列 - 180 个剪辑槽的命名场景，层混合模式已设置（Alpha/Screen/Screen/Add），顶层有一个 Bloom，一个 7 效果的作品集架已绕过，每个 Pulse 行剪辑都是一个原生生成源，其不透明度 FFT 链接（频带、增益、回退、地板均指定）。`manifests/` JSON 是该作品集的单元格；提示 07 有一个代理在您的机器上重建 .avc。主题是精确科学 - 每一列都是一个带有引用的真实现象，第 9 列的每个通道都是下一个的 TRANSIT。 2. **自定义的控制器快捷键布局。** 一个工作的“APC 40 MK II”MIDI 预设 XML 映射到该作品集：91 个快捷键 - 剪辑启动垫具有每列的颜色反馈，层不透明度淡入淡出，效果绕过点击，场景启动按钮上的过渡和通道切换。 3. **制作这两个的提示和协议。** 九个复制粘贴提示，以便代理对您的作品集和硬件执行相同的操作，以及让代理驱动 Avenue 的经过崩溃测试的规则。 零剪辑文件被发送 - 作品集是 100% 生成源，因此它在任何机器上都打开，manifests 标记了您的 footage 插入的确切位置。您的剪辑，您的权利，您的设置。 ## 仓库树 ``` resolume-cowork-helper-mcp-automation/ manifests/ orbit_gen_O1..O5.json - 五个通道的机器可读规格：每个单元格源，FFT 频带/增益/回退/地板，情绪 笔记，用户槽，自定义源的原生回退 prompts/ 01-first-contact - 验证代理<->Resolume 环路（5 分钟） 02-fft-starter-comp - 构建一个 4 层反应乐器 03-apc40-layout - 代理写入您的控制器预设 04-apc-mini-painter - 双表面装置 + 网格绘制脚本 05-your-clips - 整理和连接您的库，安全 06-custom-ffgl - 从 FFGL SDK 构建插件 07-orbit-gen-rebuild - 从 manifests/ 重建整个设置 08-your-topic-pack - 任意主题 -> 完整的 4x8 银行优化设置 09-any-controller - 带来您自己的硬件；代理研究 其银行/颜色并映射到它 compositions/ 两个可以直接加载的全生成 .avc 文件，每个单元格 填充并可立即播放： Res Fable Live Gen.avc - 6 通道 x 4x8，更简单的起点 Res Fable Orbit Gen.avc - 5 通道 x 4x9，太空之旅 controllers/ APC 40 MK II - Orbit v1.xml（91 个快捷键，已验证）+ LAYOUT_CARD.md（可打印，每个控件解释） docs/ fft-recipe-card.md - 接线约定以及为什么它感觉活着 stability-protocol.md - 如何在代理驱动时不让 Avenue 崩溃 orbit-placards.md - 科学，一场景一读，准备好朗读 LICENSE MIT ``` ## 只想玩？ -> [INSTALL.md](INSTALL.md) 一页，四步复制粘贴：作品集，插件，控制器预设，音频。无需 AI，无需编码，约 10 分钟即可点亮网格。 ## 安装 APC40 mkII 快捷键（以前从未这样做过？阅读本内容） 预设只是一个 XML 文件，您将其复制到一个文件夹中，然后从菜单中选择它。步骤如下： 1. 从此仓库的 `controllers/` 文件夹下载预设： `APC 40 MK II - Orbit v1.xml`（适用于 Orbit 作品集）或 `APC 40 MK II - Fable v4.2.xml`（适用于 Live 作品集）。 2. 如果 Resolume 正在运行，请关闭它。 3. 打开文件资源管理器（Mac 上的 Finder），进入您的 Documents 文件夹， 然后进入 `Resolume Avenue` > `Shortcuts` > `MIDI`。注意：如果您运行的是 Arena， 文件夹名为 `Resolume Arena`；如果 Windows 将您的 Documents 存放在 OneDrive 中， 它是 OneDrive 的 Documents 文件夹；如果 `Shortcuts\MIDI` 不存在， 请启动 Resolume 一次，按 Ctrl+M 然后按 Escape，文件夹就会出现。 4. 将 XML 文件复制到该 `MIDI` 文件夹中。这就是整个安装过程。 5. 在启动 Resolume 之前连接 APC40 mkII，然后启动 Resolume， 从 `compositions/` 打开匹配的作品集。 6. 在 Resolume 中：Avenue（或 Arena）菜单 > 首选项 > MIDI。您将看到 “APC40 mkII”列为设备。将其打开为输入和输出 - 两个复选框。 输出使垫子亮起来。 7. 仍在该 MIDI 首选项面板中，在设备旁边有一个预设下拉菜单 - 选择您复制的预设（“APC 40 MK II - Orbit v1”或“- Fable v4.2”）。 8. 关闭首选项。在几秒钟内，垫网格将以作品集的列颜色亮起。 按左下角的垫：它应该启动左下角的剪辑（第 1 层，第 1 列）。 淡入淡出控制层不透明度；右下角的场景启动按钮跳转到下一个通道。 如果出现问题：无灯光表示未启用输出（步骤 6）； 错误的剪辑启动表示另一个应用程序（例如 Ableton）先占用了控制器 - 关闭它并重启 APC；下拉菜单中缺少预设表示 XML 位于错误的文件夹中（步骤 3）。 完整的故障排除和每个按钮的映射：`controllers/INSTALL.md` 和 `controllers/LAYOUT_CARD.md`。 ## 从零开始？在这里开始（从零开始的路径） 您不需要编程任何东西。您输入句子；代理执行点击。五个安装和粘贴： 1. **Resolume Avenue 或 Arena 7** - resolume.com（试用版有效；它 会给输出添加水印，但此套件中的所有内容都有效）。 2. **Claude** - Claude 桌面应用程序（Cowork 模式）或 Claude Code （终端版本）来自 claude.com。如果终端让您害怕，请使用 桌面应用程序 - 相同的脑子。 3. **Resolume MCP 服务器** - 这是让代理看到 和驱动 Resolume 的适配器。在 GitHub 或 Resolume 论坛上搜索“Resolume MCP”并按照其安装步骤进行；在 Claude 中， 然后在设置 > 连接器（桌面）或 `claude mcp add`（代码）中添加它。 一次性设置，大约十分钟。 4. 启动 Resolume 时，打开任意作品集，甚至是一个空的作品集。 5. 从此套件中打开 `prompts/01-first-contact.md`，复制行下面的所有内容， 粘贴到 Claude 中，观看它大声朗读您的设备。这就是整个技能。 每个其他提示的工作方式完全相同：打开文件，复制，粘贴。 代理将在保存任何内容之前询问。 ## 快速入门（10 分钟到第一个灯光，如果您已经设置好） 1. 将您的代理连接到 Resolume MCP；打开 Avenue/Arena 7 中的任意作品集。 2. 运行 `prompts/01-first-contact.md`。如果读取结果与您的屏幕匹配，请继续。 3. 或者，跳过代理：打开 `compositions/` 中的作品集 - 两个作品集 都已发货完成。代理路线：`prompts/07-orbit-gen-rebuild.md`（重建 五通道设置）或 `prompts/02-fft-starter-comp.md`（从头开始构建一个简单的 单通道乐器）。 4. 将 `controllers/APC 40 MK II - Orbit v1.xml` 放入 Resolume 的 MIDI 预设文件夹；首选项 > MIDI：启用 APC40 mkII 作为输入和输出； 选择预设。网格在您的列颜色中亮起。 5. 设置您的音频输入设备（设置对外部 FFT 做出反应 - 房间， 而不是剪辑）并播放。 ## 这是谁的 想要一个无需手动映射 91 个快捷键的控制器布局的 VJ。想要一个真实的设备项目的代理用户。怀疑者：预设 XML 和 manifests 在没有 AI 参与的情况下工作 - 提示只是自动化它们所记录的内容。此套件提供工具，而不是输出；品味仍然是您的。 ## 自定义源和后续内容 三个 Pulse 单元格引用非库存 Avenue 源：Fable Pulsar （自定义 FFGL 源 - CP1919 脉冲星脊线，无状态，7 个标量参数） 和两个 Wire 补丁（Golden Flicker Reel，Geometry Pattern Maker）。 每个此类单元格都标记为 `custom_source`，具有本机 `fallback` - 设置无需它们即可播放。路线图：可加载的生成 `.avc` 作品集 和 Fable Optics 插件包在 Resolume FFGL SDK 条款审查后发布（如果需要重新分发，则仅限源代码）。提示 06 构建 您无论哪种方式都可以构建插件。 ## 制作您自己的包（实际重点） Orbit 是一个主题：太空，以五个物理状态讲述。格式是可重用的部分 - 一个包只有五个东西：主题的 deck manifests（在 `manifests/` 中窃取 JSON 模式，它是自解释的），能量轮廓 列顺序，解释真相的 placards，匹配的控制器预设， 以及 `docs/` 中的纪律。`prompts/08-your-topic-pack.md` 是一个复制粘贴版本： 填写您的主题（深海，真菌，底特律科技 历史，罗马引水渠...）和您的代理设计，构建， FFT 连接，控制器映射整个设置 - 根据 APC40 的 4x8 垫银行从第一个设计决策开始塑形，引用 placards，能量轮廓 强制执行。不拥有 APC40？`prompts/09-any-controller.md` 有代理研究 您的硬件的实际银行，按钮和颜色系统，为其导出网格规则， 并为其编写预设以匹配 - 加上您自己的指定要求。 Claude 是使用此套件构建和测试的内容，但提示是 纯文本，manifests 是纯 JSON - 任何可以驱动 Resolume MCP 的代理都可以玩。如果您制作了一个包， 请像此套件一样发布它：manifests + prompts + preset + placards，无剪辑文件，无 个人路径。那就是整个传统。发送链接。 ## 安全，支持，许可 `docs/` 中的稳定性协议不是可选阅读 - 每个规则都是用真正的崩溃换来的。 保存始终需要人类明确确认；提示就是这样设计的。 按原样，欢迎 PR，无承诺支持。套件文本，manifests，提示： MIT（参见 LICENSE）。Placard 事实带有内联引用 - 修正是 最受欢迎的 PR。