video-use 教程:用 Opus 5.5 把素材文件夹剪成 final.mp4(2026)

推荐链接(推广):数字严选大约 11 分钟AI 视频Opus 5.5 做视频Claude Code 视频video-use视频剪辑ElevenLabs

阅读说明

仓库信息查阅日期:2026-10-24;星数、更新时间会变,以仓库页面为准;本文不写价格。

一句话结论

browser-use/video-useopen in new window 是一个开源技能:把原始素材放进一个文件夹,在 Claude Code 里用对话剪辑,拿回 final.mp4。README 写明适用于口播、混剪、教程、旅行、访谈,不靠预设和菜单。

适合手里已经有成片素材,希望助手按转写稿下刀,并且可以自己提供 ElevenLabs API key 的人。README 写明云端版还在准备,当前路径是本地仓库加编程助手。

仓库信息

截至 2026-10-24,星数、最近推送和创建时间取自仓库元数据,日期为北京时间。

仓库星数最近推送(北京时间)许可创建时间
browser-use/video-useopen in new window29,6112026-10-09MITopen in new window2026-04-12

仓库描述是 “Edit videos with coding agents”。README 标题下的句子是 “edit videos with Claude Code. 100% open source.”

README 没有单独的许可章节。仓库元数据的许可是 MIT,根目录有 LICENSEopen in new window。素材成片、ElevenLabs 和动画引擎的许可,README 未说明。

仓库主页字段是 video-use.com。README 写明云端版即将推出,等候名单在该站,链接带跟踪参数。本文不放这条链接。

默认分支是 main。根目录有 README.md,没有中文 README。

它能做什么样的视频

README 用一份清单说明能力:

  • 剪掉口头禅(umm、uh、说错重来)和两条拍摄之间的空白。
  • 给每一段自动调色。例子是 warm cinematic、neutral punch,或任意自定义的 ffmpeg 滤镜链。
  • 每个切口做 30 毫秒音频淡化,避免爆音。
  • 按你的样式烧录字幕。默认是两个词、全大写的一块,样式可以改。
  • 用 HyperFramesopen in new window、Remotionopen in new window、Manimopen in new window 或 PIL 生成动画叠加。每个动画开一个并行的子助手。
  • 在给你看结果之前,对渲染结果的每个切口做自检。
  • 把这次会话记在 project.md 里,下次接着做。

你在素材目录里说 “edit these into a launch video”。助手先盘点素材,提出策略,等你同意,再在素材旁边写出 edit/final.mp4。所有产出都在 <videos_dir>/edit/。技能仓库目录保持干净。

README 写明模型不看视频,而是读两层材料:

  1. 转写,每次都会载入。每个素材调一次 ElevenLabs Scribe,得到词级时间戳、说话人分离,以及 (laughter)、(applause)、(sigh) 这类音频事件。全部素材收成一份大约 12KB 的 takes_packed.md。
  2. 画面复合图,需要时才调。timeline_view 对某一段时间画出胶片条、波形和词标签的 PNG,用在含糊的停顿、多条重拍的比较、切口是否靠谱。

README 用这个对照说明用量:30,000 帧 × 1,500 token = 45M token;这条路径是大约 12KB 文字,再加几张 PNG。

流水线原文是:

Transcribe ──> Pack ──> LLM Reasons ──> EDL ──> Render ──> Self-Eval
                                                              │
                                                              └─ issue? fix + re-render (max 3)

自检对已经渲染出来的成片的每个切口跑 timeline_view,用来抓画面跳变、音频爆音和被挡住的字幕。通过之后才给你看预览。修和重渲最多 3 次。

README 的五条设计原则是:文字为主、画面按需;声音决定切口,画面跟着走;先问、确认、再执行、自检、然后记下来,没有策略确认不动剪;不假设内容类型;12 条硬规则管制作正确性,其余地方可以有取舍。这 12 条的正文 README 没有列出,它指向 SKILL.mdopen in new window。

README 给的转写阅读样例是:

## C0103  (duration: 43.0s, 8 phrases)
  [002.52-005.36] S0 Ninety percent of what a web agent does is completely wasted.
  [006.08-006.74] S0 We fixed this.

仓库目录

路径说明
README.md安装、用法、流水线
install.mdREADME 的安装提示词要求助手先读它。手动安装命令以 README 的 Manual install 为准,本文不另抄 install.md
SKILL.mdREADME 写明日常用法和生产规则在这里
helpers/README 写明编辑脚本在这里。目录里有 timeline_view.py、transcribe.py、transcribe_batch.py、pack_transcripts.py、render.py、grade.py。除 timeline_view 外,README 没有逐个解释文件名
.env.example复制成 .env。文件内容只有 ELEVENLABS_API_KEY=
pyproject.tomlREADME 未说明这个文件里的依赖清单。手动安装写的是 uv sync 或 pip install -e .
skills/其下有 manim-video/。README 未说明这个目录怎么用。动画引擎的名字写在功能清单里
static/README 的横幅和流程图放在这里
tests/、poster.htmlREADME 未说明
LICENSEMIT

分辨率、帧率、成片时长,README 未说明。

需要准备什么

README 的手动安装和安装提示词写到了这些。没有一张「最低版本」表。

需要用来README 写明的装法
Git克隆仓库git clone https://github.com/browser-use/video-use ~/Developer/video-use
能跑 shell 的编程助手注册技能并剪辑提示词点名 Claude Code、Codex、Hermes、Openclaw,或任何能跑 shell 的助手
Python 环境里的 uv 或 pip安装仓库依赖uv sync,或者 pip install -e .。Python 版本 README 未说明
ffmpegREADME 在手动安装里标成 requiredbrew install ffmpeg。其他系统的命令 README 未说明
yt-dlp可选,用来下载网上的素材brew install yt-dlp
ElevenLabs API keyScribe 转写复制 .env.example 为 .env,写入 ELEVENLABS_API_KEY。领取页 README 写的是 elevenlabs.io/app/settings/api-keysopen in new window

HyperFrames、Remotion、Manim、PIL 出现在功能清单里。这些引擎的安装命令,README 未说明。Node.js 也没有出现在手动安装里。

README 还写了一句:如果要在自己的 VPS 或 Telegram 上一直开着剪,可以通过 Browser Use Box 跑助手,并附有一条演示。本文不放这两处外链。

安装与第一次运行

下面两段都在 README 里。第一段是交给助手的安装提示词,第二段是手动命令。

  1. README 写明把下面这段贴给 Claude Code、Codex、Hermes、Openclaw,或任何能跑 shell 的助手:
Set up https://github.com/browser-use/video-use for me.

Read install.md first to install this repo, wire up ffmpeg, register the skill with whichever agent you're running under, and set up the ElevenLabs API key — ask me to paste it when you need it. Then read SKILL.md for daily usage, and always read helpers/ because that's where the editing scripts live. After install, don't transcribe anything on your own — just tell me it's ready and wait for me to drop footage into a folder.

助手负责克隆、依赖、技能注册,并在需要时问你要一次 ElevenLabs API key。装完不要自己开始转写,告诉你已经好了,等你把素材放进文件夹。

  1. 想自己装时,README 的命令是:
# 1. Clone and symlink into your agent's skills directory
git clone https://github.com/browser-use/video-use ~/Developer/video-use
ln -sfn ~/Developer/video-use ~/.claude/skills/video-use        # Claude Code
# ln -sfn ~/Developer/video-use ~/.codex/skills/video-use       # Codex

# 2. Install deps
cd ~/Developer/video-use
uv sync                         # or: pip install -e .
brew install ffmpeg             # required
brew install yt-dlp             # optional, for downloading online sources

# 3. Add your ElevenLabs API key
cp .env.example .env
$EDITOR .env                    # ELEVENLABS_API_KEY=...

Codex 那一行在 README 里是注释。用 Codex 时去掉行首的 #。Claude Code 用上面没有注释的那条 ln -sfn。

  1. 把助手开在素材目录。README 的命令是:
cd /path/to/your/videos
claude    # or codex, hermes, etc.
  1. 在会话里说:
edit these into a launch video

助手盘点素材,给出策略,等你同意,然后把成片写到素材目录的 edit/final.mp4。

install.md 里还有按系统分的安装、技能注册和验收命令。README 的 Manual install 没有收录那些命令。本文不把它们写成另一套步骤。

在 Claude Code 里用 Opus 5.5 驱动它

在 Claude Code 里用 /model 选 Opus 5.5,详见 Claude Opus 5.5。

README 没有写必须使用 Opus 5.5,也没有单独的斜杠命令。安装提示词可以贴给 Claude Code,也可以贴给 Codex、Hermes、Openclaw,或任何能跑 shell 的助手。

示例提示词

安装用 README 原文,就是上一节的英文整段。仓库没有给出这段的中文版。

日常开剪,用 README 里的英文原句:

edit these into a launch video

示例提示词(按 README 写明的用法改写,不是仓库原文)

把安装提示词改成中文,步骤仍是 README 那一段:

帮我装好 https://github.com/browser-use/video-use 。先读 install.md,完成仓库安装、接上 ffmpeg、向当前这个助手注册技能,并准备 ElevenLabs API key。需要我粘贴密钥时再问我。然后读 SKILL.md 了解日常用法,编辑脚本以 helpers/ 为准。装完不要自己开始转写,告诉我已经就绪,等我把素材放进文件夹。

素材已经放进当前目录时:

把这些素材剪成一支发布视频。先盘点素材并给出策略,等我同意后再剪。去掉口头禅和空镜,每个切口做 30 毫秒音频淡化,字幕先用默认的两词全大写分块。成片写到 edit/final.mp4。

限制与已知问题

  • 模型不直接看视频。切口来自转写和静音,画面复合图只在决定点调用。
  • 转写依赖 ElevenLabs Scribe。README 未说明可以换成别的转写服务。
  • 手动安装只写了 brew install ffmpeg 和 brew install yt-dlp。apt、pacman 或其他系统的命令,README 未说明。
  • Python 版本、Node 版本、成片分辨率、帧率和时长,README 未说明。
  • 动画引擎的安装命令,README 未说明。
  • 默认字幕是两个词的全大写分块。中文怎么断句,README 未说明。
  • 自检失败时修和重渲最多 3 次。第 4 次怎么处理,README 未说明。
  • 12 条硬规则的正文不在 README,在 SKILL.md。
  • 云端托管 README 写明尚未提供,只有等候名单。
  • 产出在素材目录的 edit/,不在技能仓库里。
  • 截至 2026-10-24,开放的 issue 有 33 个,开放的 pull request 有 125 个。

常见问题

成品是 HTML 还是 MP4?怎么预览?

README 写明成片是素材目录下的 edit/final.mp4。自检通过之后才给你看预览。动画叠加可以由 HyperFrames、Remotion、Manim 或 PIL 生成,README 没有把 HTML 文件写成最终交付物。分辨率和帧率 README 未说明。

能不能商用?

仓库许可是 MIT,全文在根目录 LICENSE。README 没有写你的素材、ElevenLabs 转写结果,以及 HyperFrames、Remotion、Manim 的许可是否随仓库一起给出去。这些要各自看对应项目。本文不写价格。

要不要 API key?

要。README 写明 ElevenLabs API key 用于 Scribe 转写,装的时候问你粘贴一次,写进仓库根目录的 .env,变量名是 ELEVENLABS_API_KEY。.env.example 里只有这一项。

有没有中文字幕和中文配音?

会烧录字幕,默认是两个英文词的全大写分块,README 写明样式可以改。中文断句、中文字体和中文配音,README 未说明。转写结果带词级时间戳和说话人分离,样例句子是英文。

相关阅读

参考来源

上次编辑于:
贡献者: Masoooon