video-use

使用指南

## 什么时候用 当你已有原始视频，希望通过 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