rea-video

# rea-video

把任何视频逐镜头拆开，说明它的画面、文字、剪辑和音频是怎么做出来的，再给出翻拍方案。适合使用 Claude Code 或 Codex 的创作者和营销人员。

由 JuneYaooo 在 GitHub 上制作。这些说明是 Mindket 根据其 README 写的，项目自己的文件和许可证在它的仓库里。

## 简介

它是什么：rea-video 是给 AI 智能体用的技能和命令行工具，用来逆向分析视频。它一次一个镜头地解释画面、屏幕文字、剪辑和声音是怎么做出来的。然后它写出一份做你自己版本的方案，分成实拍、用 AI 生成和写代码三类。

适合谁：它适合想知道一段视频怎么做出来的创作者、营销人员和剪辑师，也适合想用自己的产品或故事翻拍的人。

```table
行业 | 谁在用 | 怎么用 | 例子
营销 | 广告团队 | 拆解一条爆款广告，看它是怎么做的 | 得知一条手机拍的 TikTok 广告全是实拍，只有一个场景和两个机位
内容创作 | 短视频创作者 | 为喜欢的片段拿到翻拍方案 | 看看 AI 视频的镜头怎样合并成更少的生成次数
动态设计 | 设计师和开发者 | 检查一条宣传片是否由代码驱动，再重建它 | 一条大部分由代码驱动的产品宣传片可以重建成一个 Remotion 项目
视频剪辑 | 剪辑师 | 提取字幕的时间和样式 | 把每行字幕连同起止时间导出为 SRT 或 ASS
```

只想观看或裁剪视频、不关心它怎么做出来的人，可以跳过它。

用在哪里：它运行在能执行命令的 AI 智能体里，视频模型是可选的额外项。

- Claude Code
- Codex
- 任何其他能执行命令的智能体
- 支持视频的模型，例如 Gemini 或 Doubao，把它的端点和密钥交给智能体即可添加

```table
使用场景 | 谁 | 得到什么
研究一条爆款广告 | 营销人员 | report.html 文件里的逐镜头画面、依据、机位和灯光说明
规划 AI 翻拍 | 创作者 | 每个镜头反向推出的提示词，以及合并镜头和选择模型的建议
重建动态图形 | 开发者 | 文字、它的位置和何时移动，让你可以用 Remotion 项目重现它
提取字幕 | 剪辑师 | 每行字幕的时间，以及它的颜色、描边和入场样式
```

如何设置：开始之前你需要几样东西。

- ffmpeg
- Python 3.10 或更高版本
- 能执行命令的 AI 智能体，例如 Claude Code 或 Codex
- 可选：支持视频的模型，以及它的端点和密钥

1. 最简单的办法是让你的智能体从项目的 GitHub 页面安装它，并按路径拆解一个视频文件。智能体会安装命令行工具并学习工作流程。
2. 想手动安装，先安装 ffmpeg，再克隆项目的仓库并打开它的文件夹。
3. 在那个文件夹里运行安装脚本。它会安装命令行工具，并把技能链接到各个智能体的文件夹。
4. 运行帮助命令，检查命令行工具是否正常。

```bash
brew install ffmpeg            # or: sudo apt install ffmpeg
bash scripts/install_skill.sh  # installs the CLI (pip, or pipx / a local .venv if pip is blocked) and links the skill into ~/.claude, ~/.codex, ~/.agents
rea-video --help
```

如何使用：告诉你的智能体去拆解一个视频，并给它文件路径。报告会用你提问的语言输出，中文或英文都行，由你的智能体替你传入 --lang 选项。你会拿回三样东西。

- 一句话总结这个视频是怎么做的
- 一份翻拍方案，把工作分成实拍、AI 生成和写代码
- 一份详细的 report.html 页面，显示每个镜头的画面、依据、提示词、机位和灯光说明，以及音频是怎么做的

示例：你让智能体拆解一条一分钟的产品宣传片。它回复一句总结，大致是 41% AI 视频和 59% 代码界面，然后展示翻拍方案。报告会列出每个镜头的画面、依据和背后的提示词。

新手与专家：rea-video 是为 AI 智能体打造的，所以你主要和智能体对话，由它来干活。可以先让它拆解你手头的一段短视频。

每个镜头会单独判断是实拍、AI 视频、数字人、3D、代码还是屏幕录制。混合视频会按原来的时间线重新拼起来。每个视频还会得到关于字幕、贴纸、剪辑点和音频的说明，包括人声类型、音乐和 BPM。支持视频的模型能让对实拍、AI 和 3D 的判断更准确。没有这类模型时，能看图的智能体会自己检查不确定的镜头。

```flow
你把一个视频文件交给智能体
智能体安装命令行工具并学习工作流程
每个镜头被判断为实拍、AI、3D、代码或屏幕
它收集文字、剪辑和音频的说明
它写出总结、翻拍方案和 report.html
```

注意事项：

- 它需要 ffmpeg 和 Python 3.10 或更高版本
- 篇幅较长的文档目前只有中文，但你的智能体可以读取它并用你的语言回复
- 六份示例报告是英文的，所以不用安装就能看到报告的样子
- 仓库里的示例视频经过重新压缩，会去掉平台标签，所以你的结果可能与示例报告不同
- 安装脚本使用 pip，如果 pip 被阻止，就用 pipx 或本地 .venv

## GitHub 上的数据（2026年11月6日）

- 星标：2,477
- 复刻：348
- 关注：8
- 未关闭的议题和拉取请求：2
- 语言：Python
- 许可证：Apache-2.0
- 话题：agent-skills, ai-video, aigc-detection, claude-code, codex, ffmpeg, prompt-engineering, remotion, reverse-engineering, short-video, shot-detection, subtitles

## 链接

- 代码：https://github.com/JuneYaooo/rea-video
- 发布版本：https://github.com/JuneYaooo/rea-video/releases
- 议题：https://github.com/JuneYaooo/rea-video/issues
- 星标历史：https://www.star-history.com/#JuneYaooo/rea-video&Date

## 获取代码

```
git clone https://github.com/JuneYaooo/rea-video.git
```

然后按它的 README 完成设置。这个工具包里没有会自己运行的东西。

README.md  6 KB