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 вместо этого загружают ZIP-архив навыка из раздела Releases.
Что нужно установить на компьютер, чтобы рендерить видео?Для рендеринга на вашем компьютере нужны 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'?Он измеряет формат, звук, отрезки статичных кадров и совпадение с битами музыки в готовом видео, а затем перечисляет всё, что ещё требует оценки живого зрителя.
Могу ли я воссоздать видео, которое мне уже понравилось, вместо выбора шаблона?Да — дайте агенту эталонное видео, а также свои фотографии, логотип, тексты и музыку; он измерит биты и длину кадров эталона, а затем пересоберёт его как редактируемый проект на ближайшем шаблоне или в новой композиции.
Что такое файл '.vvv'?Это пакет передачи, который объединяет шаблон, эффект или готовый проект вместе с их кодом, лицензиями на медиафайлы и доказательствами рендеринга, чтобы любой агент мог подхватить работу и продолжить её.
Зачем повторно использовать шаблоны, а не позволять агенту каждый раз писать новый код видео?Повторное использование призвано экономить токены, которые иначе уходили бы на перепроектирование, повторную генерацию и отладку одного и того же видеокода для каждого нового фильма.
Какие есть похожие проекты?herk-edit-kit, guizang-product-video-skill, youtube-agent-skill, brag, baocut, skills, skills, open-steps
Автор
actionow-ai
Размер
201.8 MB
Звёзды
561
Возраст
27 д
Коммиты · 90 дней