核心用法
RoughCut 是一款专为 macOS 设计的本地视频粗剪工具，通过命令行脚本将原始谈话类视频自动转换为 Final Cut Pro 可用的 FCPXML 时间线变体。用户只需提供本地视频路径或 HTTPS 下载链接，系统即可在本地完成处理，生成包含多种剪辑方案的 ZIP 压缩包。
显著优点
- 完全本地优先：视频文件无需上传至任何云端服务，从根本上杜绝数据泄露风险
- 智能内容识别：支持自动识别并移除"坏镜头"（bad takes）和"冗余内容"（fluff），前者基于技术检测，后者借助 Gemini API 进行语义分析
- 灵活输入方式：既支持本地文件路径，也支持通过预签名 URL 直接下载处理
- 多版本输出：一次运行生成多个时间线变体，方便快速对比选择
- Final Cut Pro 原生兼容：输出标准 FCPXML 格式，导入流程零摩擦
潜在缺点与局限性
- 平台限制严重：仅支持 macOS（darwin），Windows/Linux 用户无法使用
- 环境依赖复杂：需要预装 bash、python3、curl、ffmpeg、node、npm 等多种工具链
- Gemini API 依赖：开启 fluff 移除功能时必须配置 GEMINI_API_KEY，且该功能受限于 API 可用性与成本
- 仓库依赖：需要手动克隆并维护 RoughCut 代码仓库
- 仅适用于谈话类视频：算法针对" talking-head "场景优化，其他类型视频效果可能不佳
适合人群
- 需要快速产出粗剪版本的自媒体创作者、播客主持人、在线课程讲师
- 对数据隐私敏感、拒绝云端处理的企业内训团队
- 已熟练使用 Final Cut Pro 的 macOS 专业剪辑师
- 需要批量处理访谈、会议录像的内容制作团队
常规风险
- API 密钥管理：GEMINI_API_KEY 若配置不当可能被泄露，建议仅在需要 fluff 移除时启用
- 路径与权限问题：macOS 的沙盒机制可能导致某些目录无法访问，需确保 output_root 有写入权限
- ffmpeg 版本兼容性：不同版本的 ffmpeg 可能导致处理失败或输出异常
- URL 下载风险：使用
--video-url时，需确保来源可信，避免下载恶意文件 - Gemini API 成本：大文件或高频调用可能产生显著 API 费用
配置要点
运行前必须在 OpenClaw 配置中设置 skills.entries.roughcut.config.repo_root（代码仓库路径）和 skills.entries.roughcut.config.output_root（输出目录），并确保 GEMINI_API_KEY 环境变量在需要时可用。