登录 注册

rea-video (视频分镜逆向拆解与复刻)

去点 Star
图像、视频与音频开发者工具
6,263
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
Python
语言
创建时间
最近更新

项目能做什么

一款视频逆向分析工具,逐镜头拆解是实拍、AI生成还是代码制作,并提供复刻思路。
来源:AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 README 原仓库文档

项目简介

rea-video 是一款专为 AI Agent(如 Claude Code、Codex 等)设计的视频逆向分析工具。它能够逐个镜头拆解视频,判断每个镜头是实拍(Filmed)、AI 生成(AI-generated)还是代码/模板制作(Coded),并输出详尽的复刻指导方案与 HTML 报告。

核心功能

  • 多类型镜头拆解与判定:
  • 实拍视频:识别机位、构图、运镜、灯光布置(包含设备参考清单)及调色风格。
  • AI 视频:提供判定依据、逐镜头反推生成 Prompt、分批次生成建议及推荐模型。
  • 数字人 / 口播:判断数字人镜头,指出所需的肖像底图和音频。
  • 3D / 动画:判定更适合由视频模型生成还是通过 3D 代码渲染。
  • 代码 / 动态模板:提取文字、排版和动画节奏,可直接用于搭建 Remotion 项目。
  • 屏幕录制:标注哪些是需要开发者自行录制的真实素材。
  • 混剪合成:分别判定每个镜头并在原始时间线上完整还原。
  • 全方位制作细节提取:
  • 字幕与花字:分析起止时间(可导出 SRT / ASS 格式)、文字颜色、描边及入场动效。
  • 音视频节奏:识别剪辑切点、踩点节奏、真人/AI 配音、BGM 及其 BPM、音效落点。
  • 贴纸与物料:标注贴纸/画中画位置与时长,整理出需要自行准备的物料清单(截图、产品图等)。
  • 生成产物:
  • 一句话成分总结(例如:“41% AI 视频 + 59% 代码 UI,8 秒真实录屏,122 BPM 罐头音乐”)。
  • 模块化复刻计划(区分实拍、生成、编写代码部分)。
  • 完整的交互式 report.html 报告(包含单帧画面、推导证据、Prompt、灯光参数等)。

适合谁用

  • 想借鉴或复刻优质短视频、爆款视频的创作者与剪辑师。
  • 从事文生视频、图生视频的 AI 视频创作者。
  • 习惯使用 Claude Code、Codex 等能执行终端命令的 AI Agent 开发者。

安装步骤

前置依赖

  • Python:>= 3.10
  • ffmpeg

方式 1:通过 AI Agent 自动安装与运行(推荐)

在 Claude Code、Codex 或任何具备命令执行权限的 Agent 中发送:

Install https://github.com/JuneYaooo/rea-video, then break down this video: /path/to/video.mp4

Agent 会自动完成 CLI 安装、学习分析流程并执行全套拆解。

方式 2:手动安装

# 安装 ffmpeg 依赖
brew install ffmpeg            # macOS 环境;Ubuntu/Debian 请使用: sudo apt install ffmpeg

# 克隆仓库
git clone https://github.com/JuneYaooo/rea-video && cd rea-video

# 执行安装脚本(会自动通过 pip、pipx 或本地 .venv 安装 CLI,并将技能链接至 ~/.claude, ~/.codex, ~/.agents)
bash scripts/install_skill.sh

# 检查安装
rea-video --help

配置说明

  • 基础使用:无需配置额外大模型即可独立运行。若 Agent 本身具备识图能力,会自动核对不确定的镜头。
  • 接入视觉大模型(可选):
  • 可以向 Agent 提供具备视频理解能力的大模型接入点与密钥(原文提及 Gemini 或 豆包 Doubao 均可)。
  • 配置后能提高实拍/AI/3D 的判定准确率,并为每个镜头反推生成 Prompt。
  • 语言设置:
  • 报告语言遵循提问所用的语言(支持中文或英文)。

常见问题

  • Q: 为什么我自己测试 sample 视频的结果和官方示例报告不同?
    A: 仓库内 docs/cases/videos/ 中的测试样例为了减小体积经过了二次压缩,去除了 TikTok / 抖音等平台标记。如果在没有外接视觉模型的情况下运行,识别结果可能会有差异;如需复现官方报告效果,建议使用平台原始下载的无损素材。
原始 README 摘录(英文原文,节选前 3000 字符)
<div align="center">

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/brand/logo-light.svg">
  <img src="docs/brand/logo-dark.svg" width="400" alt="rea-video">
</picture>

Reverse-engineer any video.

Shot by shot: was it filmed, AI-generated or coded, and how to remake it.

[Website](https://www.reavideo.ai) | [中文](i18n/README_zh.md) | English | [Русский](i18n/README_ru.md) | [日本語](i18n/README_ja.md) | [한국어](i18n/README_ko.md) | [Español](i18n/README_es.md) | [Português](i18n/README_pt.md) | [Français](i18n/README_fr.md) | [Deutsch](i18n/README_de.md)

[![Stars](https://img.shields.io/github/stars/JuneYaooo/rea-video?style=flat)](https://github.com/JuneYaooo/rea-video/stargazers)
![Python](https://img.shields.io/badge/python-%E2%89%A53.10-blue)
![Agent](https://img.shields.io/badge/runs%20in-Claude%20Code%20%7C%20Codex-8A2BE2)

<a href="https://trendshift.io/repositories/334878" target="_blank"><img src="https://trendshift.io/api/badge/trendshift/repositories/334878/daily" alt="JuneYaooo/rea-video | Trendshift" width="250" height="55"></a>

[![Visit our website](https://img.shields.io/badge/Visit%20our%20website-6644D8?style=for-the-badge)](https://www.reavideo.ai) [![Join our Discord](https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/dZj8D3GqWT) [![Follow on X](https://img.shields.io/badge/Follow%20%40yao__june12106-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/yao_june12106)

⭐ *Help more people find rea-video. Star this repo!*

<img src="docs/cases/demo.gif" width="440" alt="Left: TikTok original shot on a phone; right: someone's AI remake with a different product">

Left: a TikTok ad shot on a phone. Right: an AI remake with another product. rea-video's verdict: the left is all live footage, one set and two camera positions; the right is all AI, 8 shots across 3 generations.

</div>

## Quick start

rea-video is built for AI agents. In Claude Code, Codex or any agent that can run commands, say:

```text
Install https://github.com/JuneYaooo/rea-video, then break down this video: /path/to/video.mp4
```

The agent installs the CLI, learns the workflow and runs the whole thing. You need ffmpeg and Python 3.10+.

<details><summary>Install by hand</summary>

```bash
brew install ffmpeg            # or: sudo apt install ffmpeg
git clone https://github.com/JuneYaooo/rea-video && cd rea-video
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
```

</details>

You get:

- a one-line summary, e.g. "41% AI video + 59% code UI, 8 s of real screen recording, library music at 122 BPM"
- a remake plan, split into what to film, what to generate and what to code
- a full `report.html` with per-shot frames, evidence, prompts, camera and lighting notes, and the audio breakdown

You can also hook up a video-capable model (Gemi
阅读完整原文

商业机会分析 AI 生成

开箱即用的爆款视频逆向 SaaS 平台

产品构想将基于 CLI 与 Agent 的本地工具封装为 Web/小程序端 SaaS,提供视频上传/链接输入,自动生成分镜报告与复刻提示词包。
核心功能视频链接一键解析、分镜标签化(实拍/AI/代码)、逆向提示词导出、Remotion 代码与剪辑工程包下载、多语言报告导出。
目标用户缺乏开发环境配置能力的短视频编导、电商带货团队、广告优化师。
难度/周期中等 · 3-5 周 · 成本:极低(主要是服务器部署、前端交互及多模态 API 调用成本)
收费模式按解析次数计费或月度会员订阅(提供免费额度 + Pro 版无限解析)。
竞争风险多模态大模型(Gemini/豆包等)视频分析 Token 成本较高;若逆向准确率和提示词效果未达预期易造成退订。
依据 数据支持的判断

出海广告/电商素材批量逆向与换品复刻流水线(B2B/API)

产品构想面向广告代投放和电商团队,提供批量自动化监控、分析竞品高转化素材并自动提炼可换品复刻模版的解决方案。
核心功能批量视频投喂、镜头元素提取与替换建议、自动对接下游视频生成 API(如 Kling/Runway/Sora 等)生成变体素材。
目标用户跨境电商出海团队、信息流广告代运营服务商。
难度/周期高 · 2-3 个月 · 成本:中等(需维护下游生成流水线及批处理队列)
收费模式企业级 API 接口订阅、定制化交付实施费或按生成量分成(推测)。
竞争风险涉及竞品视频深度模仿可能存在版权与平台合规争议;对下游视频生成模型的稳定性依赖强。
依据 AI推测

AI Agent 专属技能插件与高级逆向案例库

产品构想结合项目天然为 Claude Code / Codex 设计的特性,提供深度优化的高级 Agent Skill 插件及高价值爆款视频逆向工程案例库。
核心功能针对专业分镜的高级 Agent 技能包、针对 3D/Remotion 代码视频的精准复原模板、经过实测可用的提示词精修库。
目标用户技术型视频创作者、独立开发者、AI 短剧创作者。
难度/周期低 · 1-2 周 · 成本:极低(基于已有项目进行技能精调与内容整理)
收费模式知识付费/数字商品售卖、高级 Agent 工具包一次性买断或订阅。
竞争风险开源项目本身已包含基础 Skill 脚本,高级特性的差异化壁垒较难建立。
依据 已验证事实
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 GitHub Search 真实检索

项目中文简介Stars语言
morluto/rea 利用 Agent 逆向工程任何内容,涵盖应用行为到原生二进制文件。 447,656 TypeScript
mattpocock/skills 专为工程师打造的 Agent 技能合集,直接源自作者的配置目录。 319,984 Shell
obra/superpowers 实用的 Agent 技能框架与配套软件开发方法论。 315,272 Shell
affaan-m/ECC 面向 Claude Code、Cursor 等工具的 Agent 性能优化与技能管理系统。 300,337 JavaScript
anthropics/skills Anthropic 官方公开的 Agent 技能(Skills)代码仓库。 191,332 Python
DietrichGebert/ponytail 让 AI Agent 像资深开发者一样思考,尽量减少编写不必要的代码。 187,893 JavaScript
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度创建于 ,最近推送
社区活跃Star 6,263 / Fork 0 / Issue 0(数据支持,可自行核实)
许可证未检测到(需人工确认)
主要风险上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价

安装与使用

快速开始(以仓库 README 为准)
git clone https://github.com/JuneYaooo/rea-video.git
cd rea-video
# 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
阅读原仓库文档
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。