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












