← 开源
actionow-ai

vvv

一次构建视频模板,多次复用:给 Claude Code、Codex 等 25+ 个 Agent 的开源可编辑婚礼视频模板与 Agent Skill。Build a video template once, reuse it across coding agents.

AI EngineeringGive agent toolsPython
在 GitHub 打开
增长势头
+024 小时新增 Star0.0%
524
Star
151
Fork
+19
本周
1
贡献者
创建于 2026-10-22 · 更新于 2026-11-05 · 今日第 18365 名
主要开发者
actionow-ai
README

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

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

Note

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

用模板做出来的片子


Doodle · 白纸手绘

Album · 留白画册

DV Story · DV 回放

Comedy · 喜剧开场

Starter · 节拍相册

Album 9:16 · 竖版短片

Editorial · 简约杂志

Cinema · 黑幕影院

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;对照基准尚未发布,见路线图。

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

把参考视频和属于你的附件交给 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 check 测量画幅、音量、静止画面和卡点,直接点出偏离节拍最多的几个画面,并列出只能由人判断的事项。
  • 模板更新:vvv.py update 把已有工程的模板代码更新到 kit 的最新版本,保留你自己改过的部分。
  • 交接:把模板、动效或做好的工程打包成一个 .vvv 文件,带上代码、素材授权和渲染验证记录,换一个 Agent 也能接着做。
  • 素材工具:本地 FFmpeg 工具可以探测媒体、截取片段、提取音轨和抽帧(示例)。
  • 社区模板:做了满意的模板,打包后在官网投稿。站长审核通过后,它会出现在网站和 MCP 服务里。

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

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

开始使用 · 官网 · contact@vibevision.video · Linux.do

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

© 2026 Vibe Vision Video contributors · vibevision.video

排名相邻
同类项目