vvv README

项目的 README,来自 github.com/actionow-ai/vvv。合并为一个 markdown 文件:README.md。

Vibe Vision Video:一次构建模板,多次复用。给编程 Agent 的开源视频模板。

换上照片和文案,就是一部新片;
给一部喜欢的片子,复刻出你自己的版本。

License 官网 Linux.do Claude Code Agent Skills MCP

官网 · English · 开始使用 · 模板 · 社区模板 · 文档

[!NOTE] 仅供学习与研究。 本项目用于学习和研究可复用的视频模板、节拍剪辑与 Agent 工作流。示例中的新人和照片均为虚构。复刻参考视频是为了学习它的结构与节奏,请勿搬运或冒充他人作品;照片、音乐和字体请确认你有权使用。

用模板做出来的片子

Doodle:水彩爱心在 We're married! 后绽开
Doodle · 白纸手绘
Album:圆角画册里的恋爱故事拼版
Album · 留白画册
DV Story:PLAY 回放屏上配打字字幕的照片页
DV Story · DV 回放
Comedy:放错童年照的笑点
Comedy · 喜剧开场
Starter:名字逐字打出的卡点相册
Starter · 节拍相册
Album 9:16:竖版短片里的街角拼版
Album 9:16 · 竖版短片
Editorial:手写标题旁的新人照片,白色泡泡扫过后圆形双人照展开
Editorial · 简约杂志
Cinema:相遇日期下的一条线展开成第一张合照
Cinema · 黑幕影院
Memoir:家乡地标和童年照贴纸弹出,旁边手写名字
Memoir · 手写胶片故事

点击动图观看带配乐的完整预览。全部由模板直接渲染并通过 vvv check,新人和照片均为虚构示例。最新加入的 Editorial、Cinema 和 Memoir 都从参考片复刻:简约杂志风婚礼 MV、现场大屏黑底开场片、手写胶片人生故事。全部模板、画幅与风格

从一堆照片到一部成片

照片从云盘落下、按服装分组、沿节拍时间线做成影片,再回到云盘保存

把照片和想法交给 Agent,从整理照片到渲染成片,每一步它都能接手。你只需要说想法、看样片、拍板。

准备照片理清想法样片与修改成片与保存
01 说想法
告诉 Agent 想要的风格、画幅和歌曲,一两句话就够。
04 理需求
整理风格、画幅、时长和歌曲。点名的歌用你手里的音乐文件,或由你自装的 musicdl 获取(仅限个人使用)。
07 出样片
配乐自动对齐:副歌落在高潮页,渲染前先告诉你全片多长、每页停几秒。
10 出成片
渲染 1080p 高清成片,自动检查画幅、音量、静止画面和卡点。
02 放照片
照片放在本地文件夹,或给一个百度网盘分享链接。
05 看照片
逐张识别人物、情绪和服装,按套分组;同一页用同一套,相邻两组自动换装。
08 提意见
看完样片,直接说哪里要改。
11 存网盘
需要时把成片存进你的百度网盘,经你确认才上传。
03 取照片
Agent 下载原图,自动缩到渲染尺寸,原图不动。
06 定方案
三选一:推荐最合适的模板、用你指定的模板,或学习一部你喜欢的参考视频的结构和节奏,用自己的素材复刻(抖音、小红书、快手链接直接用)。
09 改到位
换照片、改文案、调节奏,逐条修改,只重渲改动的部分。
12 留工程
可编辑工程一并留存,以后随时能改,也能交给另一个 Agent 接着做。

用 vvv 技能做一部婚礼 MV:照片在百度网盘 https://pan.baidu.com/s/…(提取码 abcd),歌用《咱们结婚吧》,风格参考这条小红书 https://xhslink.cn/o/…。新郎林以舟、新娘许知夏,10 月 18 日结婚。先给我看样片。

装进你的 Agent

任选一种:

Agent 安装
Claude Code /plugin install vvv --marketplace actionow-ai/vvv(插件里已包含模板库)
Codex、Cursor、Gemini CLI、Copilot 等 20 多个 npx skills add actionow-ai/vvv(再 clone 本仓库,并设置 VVV_KIT,说明)
WorkBuddy 从 Releases 下载技能 ZIP,在「技能 → 添加技能」中上传(说明)
任何 MCP 客户端 claude mcp add --transport http vvv https://mcp.vibevision.video/mcp,无需安装即可浏览模板和方法指南

渲染在你的电脑上进行,需要装好 Python 3.9+、Node.js 26 和 npm;其余依赖由 Agent 安装。可选(用你自己的账号):下载分享链接参考片用的 TikHub Token、百度网盘登录、musicdl(集成说明)。

一个模板,做每一部新片

场景、版式、节奏和检查只做一次。新片只改属于它自己的东西。

只做一次场景结构与镜头运动 · 16:9 与 9:16 版式 · 按节拍规划的时间线 · 渲染检查
每部片子各自修改照片 · 名字和日期 · 每一句文案 · 配乐与画幅

vvv.py describe 告诉 Agent 每个模板的照片位、可改文案和配置,validate 在渲染前拦下错误输入。Agent 优先改模板开放的输入,只有需求需要时才动 React/TypeScript 源码。复用模板是为了省下反复设计、生成和调试同类视频代码的 token;对照基准尚未发布,见路线图。

给它一部你喜欢的片子,做出你自己的。

一段胶片经过节拍网格变成 V 形:拆解参考视频并重建

把参考视频和属于你的附件交给 Agent:照片、Logo、文案、音乐。它会拆解参考片为什么好看,再用你的素材重建成一个可编辑的工程。

01 参考视频 + 附件
一个视频文件,或抖音、小红书、快手、TikTok 的分享链接,加上你的照片(本地或百度网盘)、Logo、文案和音乐。参考片只用来学习,不会被打包分发。
02 逐页清单
按节拍列出每一页:每个转场按 0.1 秒密集截帧,从定格帧量出照片框坐标,写清每个元素怎么进、怎么出。清单确认后才开始写代码。
03 重建并对照
基于最接近的模板或全新的构图。缺的素材以参考截图为风格参考生成;新旧画面并排对照,偏离节拍的峰值逐个列出。

用 vvv 技能把这条小红书视频 https://xhslink.cn/o/… 复刻成我们自己的片子:用 ./photos 里的照片、我们的 Logo 和文案重建,缺的画面素材用生图补上,正式渲染前先给我看检查过的样片。

有生图能力的 Agent 效果最好。本机同时装有 Claude Code 和 Codex 时,Claude Code 可以通过内置桥接调用 Codex 的生图能力。不生成视频和配音。复刻流程

还能做什么

Agent 第一次在你的电脑上运行命令时,可能会先征求你的同意。想手动运行或开发新模板,见开始使用和贡献指南;现成的 .vvv 模板包附在 Releases 中。

一排 V 形立体字,最前面一个亮成荧光黄

今天就做出你的第一部片子。

开始使用 · 官网 · [email protected] · Linux.do

状态
0.2 早期版本。已在 macOS ARM64 上用 Claude Code 和 Codex 完整验证,WorkBuddy 和其他平台测试较少。验证与限制
用途与许可
仅供学习与研究。代码、文档、模板与演示素材采用 MIT;字体、预览配乐和第三方代码沿用各自条款,其中 musicdl 仅限非商业使用:媒体许可 · 第三方说明
参与
贡献指南 · 路线图 · 更新记录
安全 · 品牌素材 · 投稿模板

© 2026 Vibe Vision Video contributors · vibevision.video

vvv (actionow-ai/vvv)

正在搜索数据库…

561 ·GitHub
这是什么?vvv 让你只需一次性用 Remotion/React 搭建一个可编辑的视频模板,然后就能在 25 个以上的编程智能体中复用(包括 Claude Code 和 Codex),用你自己的照片和文字生成个性化视频,比如婚礼短片。
这是独立的视频编辑器,还是要通过我的编程智能体运行?它是一个 Agent Skill 加上一套 Remotion/React 模板库:你和编程智能体对话,由它选定模板、填入你的照片和文案,然后在你的电脑上渲染成视频。
我要怎么把它添加到我的编程智能体中?Claude Code 请运行 '/plugin install vvv --marketplace actionow-ai/vvv';Codex、Cursor、Gemini CLI、Copilot 以及其他 20 多个智能体,请运行 'npx skills add actionow-ai/vvv' 并设置 VVVKIT;WorkBuddy 用户则需要上传 Releases 中的 skill ZIP 压缩包。
要在电脑上渲染视频,需要预先安装什么?渲染需要你的电脑上已安装 Python 3.9+、Node.js 26 和 npm;其余依赖由智能体自行安装。
这个项目成熟度如何?它会自己生成视频内容吗?这是 0.1 早期版本,仅在 macOS ARM64 上配合 Claude Code 和 Codex 完成了端到端验证;WorkBuddy 等其他平台则被标注为测试较少。它本身也不会生成视频或语音内容,这些必须来自你自己的素材和资源。
它能在 Windows 和 Linux 上运行,还是只支持 macOS?目前只有 macOS ARM64 完成了端到端验证;由于基于 Python 和 Node,其他操作系统或许也能运行,但 README 明确指出,在这个早期阶段其他平台测试较少。
'vvv check' 到底检查什么?它会检测渲染出的视频的格式、音频、静止画面片段以及节拍对齐情况,然后列出仍需由人工观看者判断的内容。
如果我已经喜欢某个视频,能不能直接复刻它,而不是选模板?可以。你只需把参考视频连同你的照片、Logo、文案和音乐交给智能体,它会测量参考视频的节拍和镜头时长,然后在最接近的模板上或新建的合成中,把它重建为一个可编辑的项目。
'.vvv' 文件是什么?它是一个交接包,把模板、特效或已完成的项目连同其代码、媒体授权和渲染证据打包在一起,让任何智能体都能接手并继续工作。
为什么要复用模板,而不是每次都让智能体重新编写视频代码?复用是为了节省 token,否则这些 token 会花在为每部新影片重新设计、重新生成和调试同样的视频代码上。
大小
201.8 MB
星标
561
时长
27天
提交 · 90 天