cutroom：实践指南

如果把cutroom放进候选清单，不能只看热度；它的定位是Claude Code 和其他特工通过对话进行视频编辑：剪切停顿、重构、标题、字幕。从视频制作的使用方式看，素材、节奏、编码和最终画面容易不一致是采用前必须回答的问题。更实际的做法是拿一组已有素材完成一段短样片，同时核对素材路径、渲染结果、音画同步和导出格式，不要直接在关键项目上。编辑判断上，有真实素材并需要稳定视频产出的创作者可以优先研究它；其他团队不必为了热门标签勉强接入。

剪辑室

Claude Code 和 Codex 的对话式视频编辑。将其指向您的镜头并说出您想要的内容：减少停顿和滑动，插入和退出，这样静态镜头就不会静止不动，在屏幕上显示名称和价格，标准化响度。它会转录、与您一起规划剪辑、渲染、检查自己的输出并进行迭代。

基于 browser-use/video-use 浏览器使用。

它的作用

• 转录。 使用 Apple Silicon 上的 mlx-whisper 进行免费本地转录，或使用您自己的密钥进行 ElevenLabs Scribe。字级时间戳驱动每一次剪辑。
• 收紧。 超过阈值的每个停顿都会被削减，根据要求删除重录和失误，并且保留语音级音频的停顿将被标记为转录员错过的单词。
• 重新取景。 单个静态摄像机上的平滑切入：镜头大小的变化在剪辑中轻松变化，而不是跳跃，每个镜头内都有缓慢的漂移，并在主题变化时插入。
• 标题。 屏幕上的姓名和数字来自设计的 ASS 文件，与渲染剪辑同步。
• 渲染。 每段提取剪切到整个帧，在渲染之间缓存，响度标准化为 -14 LUFS，AAC 编码后真实峰值保持在 -1 AAC。
• 自我检查。一次渲染：根据计划的时间线，一张包含每个剪切、响度和真实峰值的表格，以及可选的与计划保留的文字不同的重新转录。
• 从视频使用：颜色分级、叠加动画（HyperFrames、Remotion、Manim、PIL）、字幕、多镜头选择。

视频使用带来了什么变化

• 本地转录助手 (transcribe_local.py) 作为 ElevenLabs 的替代品。
• 新助手：tighten.py、verify_render.py、parts.py（分成最多一分钟的部分）、timeline_view.py --edl，以及从每个范围的 frame 目标重新构建。
• render.py：全帧片段，使字幕和标题不再偏离语音，片段音频保持 PCM，使声音在各个剪辑中保持同步，一个用于混合形状源的画布，显式音频流映射，编辑文件夹中每个 EDL 共享的片段缓存，ass 标题字段，以及之后测量的真实峰值AAC 编码。
• 帮助程序在 uv 项目环境中运行，仅包含它们导入的依赖项。
• 不包括出售的 manim-video 技能和浏览器使用品牌。

要求

• 具有插件支持的 Claude Code，或其他读取代理技能的代理（请参阅安装）。
• uv PATH 上的：它在首次使用时构建助手的 Python 环境。
• ffmpeg 和 ffprobe 使用 libass 和 libzimg（subtitles、ass 和 zscale 过滤器）构建。 Homebrew 的默认 ffmpeg 两者都缺少； ffmpeg-full 有它们。
• 转录路径：
  • 免费：Apple Silicon 上的 macOS 和 uv tool install mlx-whisper，Whisper 知道的任何语言（填充物最好保留为俄语和英语）；
  • 环境中已付费：ELEVENLABS_API_KEY。
• Node.js 22+ 仅适用于 HyperFrames 或 Remotion 动画。

安装

克劳德·科德

claude plugin marketplace add boundlessend/cutroom
claude plugin install cutroom@cutroom

法典

codex plugin marketplace add boundlessend/cutroom
codex plugin add cutroom@cutroom

在 Codex 桌面应用程序中，打开插件目录，选择 cutroom，然后安装 cutroom。安装后开始新的聊天。

cutroom 也可从共享 Senya 插件 市场获取：

codex plugin marketplace add boundlessend/yougile-tracking
codex plugin add cutroom@senya-plugins

选择一个 cutroom 市场以避免重复技能。

对于独立技能，请询问 Codex：

$skill-installer install https://github.com/boundlessend/cutroom/tree/main/skills/cutroom

其他代理

该技能遵循 业务代表技能 格式。选择您的代理支持的安装程序：

npx skills add boundlessend/cutroom
gh skill install boundlessend/cutroom cutroom
gemini extensions install https://github.com/boundlessend/cutroom

动画工作者和批评者通行证使用主持人的委托工具：Claude Code 中的 Agent，协作或 Codex 中的 spawn_agent。如果委派不可用或不允许，主会话将按顺序执行工作并报告该限制。

更新中

克劳德代码：

claude plugin marketplace update cutroom
claude plugin update cutroom@cutroom

法典：

codex plugin marketplace upgrade cutroom
codex plugin add cutroom@cutroom

如果您从 senya-plugins 安装，请改用该市场名称。更新后重启主机。

使用

用简单的话询问，并附上您的素材路径：

• “从 ~/Videos/IMG_1234.MOV 中删除停顿和滑行，保持宽高比。”
• “添加平滑的插入点，这样镜头就不是静态的。”
• “把产品名称和价格放在我头顶上方的屏幕上。”
• “将结果分成最多一分钟的部分。”

所有输出都进入素材旁边的 edit/ 文件夹；插件目录永远不会被写入。

测试

uv run --project skills/cutroom python -m unittest discover -s skills/cutroom/tests

烟雾测试使用真实的 ffmpeg 渲染合成剪辑，并检查唇形同步、持续时间和真实峰值。