rea-video (视频分镜逆向拆解与复刻)
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) [](https://github.com/JuneYaooo/rea-video/stargazers)   <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> [](https://www.reavideo.ai) [](https://discord.gg/dZj8D3GqWT) [](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 章节有说明。