开源视频剪辑 Agent Skill:把原始素材放进文件夹,通过对话完成转写、选段、去口癖与停顿、调色、字幕、动画叠加和成片自检,最终输出 final.mp4。剪辑脚本开源免费,但语音转写依赖 ElevenLabs API,上传含个人信息或商业敏感内容前应确认授权、费用和数据边界。
## 什么时候用 当你已有原始视频,希望通过 Codex、Claude Code、Hermes 或 OpenClaw 等 Agent 对话式完成口播、访谈、教程、旅行或混剪视频时使用。它会保留 EDL、字幕、转写缓存和项目记录,适合持续迭代;如果你需要传统可视化时间线或素材不能发送外部转写服务,则不适用。 ## 准备条件 - Python 3.10 及以上 - FFmpeg 和 FFprobe - 能运行 shell、读取文件的 Agent - ElevenLabs API Key,用于 Scribe 逐词转写 - 可选:yt-dlp、HyperFrames、Remotion、Manim,仅在具体任务需要时安装 ## 安装 ```bash git clone https://github.com/browser-use/video-use ~/Developer/video-use cd ~/Developer/video-use uv sync # 或 pip install -e . ln -sfn ~/Developer/video-use ~/.codex/skills/video-use ``` 安装时应链接整个仓库目录,不能只复制 SKILL.md;辅助脚本位于同级 helpers/。FFmpeg 和新的系统依赖应在用户确认后安装。API Key 保存在仓库根目录的 .env,权限设为 600,不得提交或回显。 ## 最短使用路径 1. 把原始视频放在一个独立文件夹中,原文件保持不变。 2. 进入素材文件夹并启动 Agent。 3. 先让 video-use 盘点素材并提出剪辑策略。 4. 在第一次 ElevenLabs 转写前确认素材授权、数据边界和费用。 5. 确认策略后生成 EDL、预览、自检,再输出 final.mp4。 6. 后续修改复用既有转写和 project.md,避免重复付费转写。 ## 你会得到什么 - edit/final.mp4 和 preview.mp4 - edit/edl.json - edit/master.srt - edit/takes_packed.md 与转写缓存 - edit/project.md - 动画源文件、验证截图和未解决事项 ## 完成标准 - 原始素材没有被修改。 - 成片可以正常播放,时长与 EDL 预期一致。 - 剪辑点位于词边界,切口没有明显爆音或跳帧。 - 字幕在所有叠加层之后合成且时间对齐。 - Agent 已检查每个剪辑点以及成片首尾和中段样本。 - 最多自修三轮;仍有问题时明确列出,而不是无限重试。 ## 失败后怎么调整 转写失败先检查 API Key、音轨和文件变化;剪辑节奏不对先修改 EDL 与策略,不要重新转写;画面或字幕问题只修改对应渲染阶段。连续三轮仍无法通过时保留预览和诊断证据,交由用户决定下一步。 ## 费用、隐私与版权 仓库代码采用 MIT 许可证,但 ElevenLabs 转写和云端运行可能产生费用。音频或视频可能包含个人信息、未公开商业资料、肖像和第三方版权内容;发送外部服务前必须取得相应授权并确认服务商条款。不要把 API Key 写入素材目录、日志或版本库。 来源:https://github.com/browser-use/video-use 许可证:MIT