К основному содержанию
плагин

vvv — плагин для Claude Code: что делает и как установить

Плагин vvv для Claude Code создаёт и редактирует видеоролики на Remotion по готовым шаблонам. Он синхронизирует кадры с музыкой и собирает готовый проект из фото.

MIT ★ 568 обновлён 2026-10-30

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add actionow-ai/vvv
/plugin install vvv@vibevision
Открыть на GitHub

Что делает vvv

Плагин автоматизирует сборку видеороликов через Remotion на основе настраиваемых шаблонов. Агент распределяет снимки по сценам с учётом композиции, подгоняет длительность кадров под ритм выбранной музыки и рассчитывает тайминги смены планов. Готовый проект сохраняется как редактируемый код на React и TypeScript, поэтому правки можно вносить в исходники или через параметры шаблона.

Инструмент умеет разбирать структуру стороннего видео по раскадровке и переносить его ритм на новые материалы. Команда vvv check проверяет итоговое видео: измеряет громкость, следит за соотношением сторон, находит застывшие кадры и сбитые доли трека.

Для локального рендера на компьютере обязательно нужны Python 3.9+, Node.js 26 и npm. Скрипт vvv.py describe передаёт агенту слоты под фотографии и текст, а validate проверяет параметры до запуска сборки.

Какие задачи решает

  • собрать видеоролик из набора фотографий по готовому шаблону Remotion
  • подогнать переходы и смену слайдов под ритмическую сетку трека
  • разобрать референсное видео на кадры и повторить его структуру со своими снимками
  • проверить готовый монтаж на застывшие кадры и рассинхронизацию с музыкой

Примеры запросов агенту

  • Собери свадебный ролик по шаблону Album из снимков в папке ./photos под трек audio.mp3
  • Проверь проект с помощью vvv check и покажи кадры, которые не попали в бит
  • Обнови шаблоны в текущем проекте до свежей версии через vvv.py update

Как установить vvv

Через маркетплейс плагинов

/plugin marketplace add actionow-ai/vvv
/plugin install vvv@vibevision

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о vvv

Как установить vvv в Claude Code?

Сначала добавьте репозиторий в маркетплейс командой /plugin marketplace add actionow-ai/vvv, затем выполните установку /plugin install vvv@vibevision.

Что делает плагин vvv?

Он помогает агенту собирать и настраивать видеоролики на движке Remotion, генерируя код на React и TypeScript под заданные фотографии и аудиодорожку.

Что нужно для работы vvv?

Для локального рендера требуются Python 3.9+, Node.js 26 и пакетный менеджер npm. Дополнительно можно подключить FFmpeg для работы с медиафайлами.

Исходный текст

SKILL.md · MIT
<div align="center">

<img src="docs/assets/brand/hero-zh-CN.png" width="100%" alt="Vibe Vision Video:一次构建模板,多次复用。给编程 Agent 的开源视频模板。">

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

[![License](https://img.shields.io/badge/License-MIT-1F8BD7)](LICENSE)
[![官网](https://img.shields.io/badge/%E5%AE%98%E7%BD%91-vibevision.video-DFFF00?labelColor=111111)](https://vibevision.video/zh/)
[![Linux.do](https://img.shields.io/badge/Linux.do-%E5%8A%A0%E5%85%A5%E8%AE%A8%E8%AE%BA-2FA4E7?logo=discourse&logoColor=white)](https://linux.do)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-%E6%8F%92%E4%BB%B6-D97757?logo=claude&logoColor=white)](docs/agent-compatibility.md)
[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-25%2B%20%E4%B8%AA%20Agent-8A63D2)](docs/agent-compatibility.md)
[![MCP](https://img.shields.io/badge/MCP-mcp.vibevision.video-111111)](https://vibevision.video/zh/start/#mcp)

[官网](https://vibevision.video/zh/) · [English](README.en.md) · [开始使用](docs/getting-started.md) · [模板](docs/templates.md) · [社区模板](https://vibevision.video/zh/community/) · [文档](docs/README.md)

</div>

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

## 用模板做出来的片子

<table>
  <tr>
    <td align="center" width="33%"><a href="docs/assets/doodle.mp4"><img src="docs/assets/loops/doodle.webp" width="100%" alt="Doodle:水彩爱心在 We're married! 后绽开"></a><br><b>Doodle</b> · 白纸手绘</td>
    <td align="center" width="33%"><a href="docs/assets/album.mp4"><img src="docs/assets/loops/album.webp" width="100%" alt="Album:圆角画册里的恋爱故事拼版"></a><br><b>Album</b> · 留白画册</td>
    <td align="center" width="33%"><a href="docs/assets/dv-story.mp4"><img src="docs/assets/loops/dv-story.webp" width="100%" alt="DV Story:PLAY 回放屏上配打字字幕的照片页"></a><br><b>DV Story</b> · DV 回放</td>
  </tr>
  <tr>
    <td align="center"><a href="docs/assets/comedy.mp4"><img src="docs/assets/loops/comedy.webp" width="100%" alt="Comedy:放错童年照的笑点"></a><br><b>Comedy</b> · 喜剧开场</td>
    <td align="center"><a href="docs/assets/starter.mp4"><img src="docs/assets/loops/starter.webp" width="100%" alt="Starter:名字逐字打出的卡点相册"></a><br><b>Starter</b> · 节拍相册</td>
    <td align="center"><a href="docs/assets/album-vertical.mp4"><img src="docs/assets/loops/album-vertical.webp" width="100%" alt="Album 9:16:竖版短片里的街角拼版"></a><br><b>Album 9:16</b> · 竖版短片</td>
  </tr>
  <tr>
    <td align="center"><a href="docs/assets/editorial.mp4"><img src="docs/assets/loops/editorial.webp" width="100%" alt="Editorial:手写标题旁的新人照片,白色泡泡扫过后圆形双人照展开"></a><br><b>Editorial</b> · 简约杂志</td>
    <td align="center"><a href="docs/assets/cinema.mp4"><img src="docs/assets/loops/cinema.webp" width="100%" alt="Cinema:相遇日期下的一条线展开成第一张合照"></a><br><b>Cinema</b> · 黑幕影院</td>
    <td align="center"><a href="docs/assets/memoir.mp4"><img src="docs/assets/loops/memoir.webp" width="100%" alt="Memoir:家乡地标和童年照贴纸弹出,旁边手写名字"></a><br><b>Memoir</b> · 手写胶片故事</td>
  </tr>
</table>

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

## 从一堆照片到一部成片

<img src="docs/assets/art/workflow.jpg" width="100%" alt="照片从云盘落下、按服装分组、沿节拍时间线做成影片,再回到云盘保存">

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

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

> 用 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`,[说明](docs/agent-compatibility.md)) |
| **WorkBuddy** | 从 [Releases](https://github.com/actionow-ai/vvv/releases) 下载技能 ZIP,在「技能 → 添加技能」中上传([说明](docs/workbuddy.md)) |
| **任何 MCP 客户端** | `claude mcp add --transport http vvv https://mcp.vibevision.video/mcp`,无需安装即可浏览模板和方法指南 |

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

## 一个模板,做每一部新片

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

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

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

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

<img src="docs/assets/art/recreate.jpg" width="100%" alt="一段胶片经过节拍网格变成 V 形:拆解参考视频并重建">

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

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

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

有生图能力的 Agent 效果最好。本机同时装有 Claude Code 和 Codex 时,Claude Code 可以通过内置桥接调用 Codex 的生图能力。不生成视频和配音。[复刻流程](docs/capabilities.md#recreate-a-reference-video)

## 还能做什么

- **按情绪线排照片**:每个模板都标好了自己的情绪段落(先笑后泪、从相识到婚礼)。Agent 先看每张照片,标出人物、情绪和时间,再按段落放进对应位置,渲染前先给你看排好的顺序。
- **风格预设**:片头规则、配乐、署名这些定一次存成预设,之后每部片子都直接沿用,不用每次重新交代。
- **渲染检查**:`vvv check` 测量画幅、音量、静止画面和卡点,直接点出偏离节拍最多的几个画面,并列出只能由人判断的事项。
- **模板更新**:`vvv.py update` 把已有工程的模板代码更新到 kit 的最新版本,保留你自己改过的部分。
- **交接**:把模板、动效或做好的工程打包成一个 [`.vvv` 文件](docs/format/vvv-1.0.md),带上代码、素材授权和渲染验证记录,换一个 Agent 也能接着做。
- **素材工具**:本地 FFmpeg 工具可以探测媒体、截取片段、提取音轨和抽帧([示例](examples/media-workflow.md))。
- **社区模板**:做了满意的模板,打包后在[官网投稿](https://vibevision.video/zh/submit/)。站长审核通过后,它会出现在网站和 MCP 服务里。

Agent 第一次在你的电脑上运行命令时,可能会先征求你的同意。想手动运行或开发新模板,见[开始使用](docs/getting-started.md)和[贡献指南](CONTRIBUTING.md);现成的 `.vvv` 模板包附在 [Releases](https://github.com/actionow-ai/vvv/releases) 中。

<img src="docs/assets/art/cta.jpg" width="100%" alt="一排 V 形立体字,最前面一个亮成荧光黄">

<div align="center">

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

[开始使用](docs/getting-started.md) · [官网](https://vibevision.video/zh/) · [[email protected]](mailto:[email protected]) · [Linux.do](https://linux.do)

</div>

<table>
  <tr>
    <td width="33%" valign="top"><b>状态</b><br>0.2 早期版本。已在 macOS ARM64 上用 Claude Code 和 Codex 完整验证,WorkBuddy 和其他平台测试较少。<a href="docs/verification.md">验证与限制</a></td>
    <td width="33%" valign="top"><b>用途与许可</b><br>仅供学习与研究。代码、文档、模板与演示素材采用 <a href="LICENSE">MIT</a>;字体、预览配乐和第三方代码沿用各自条款,其中 musicdl 仅限非商业使用:<a href="MEDIA_LICENSE.md">媒体许可</a> · <a href="THIRD_PARTY_NOTICES.md">第三方说明</a></td>
    <td width="33%" valign="top"><b>参与</b><br><a href="CONTRIBUTING.md">贡献指南</a> · <a href="ROADMAP.md">路线图</a> · <a href="CHANGELOG.md">更新记录</a><br><a href="SECURITY.md">安全</a> · <a href="docs/brand.md">品牌素材</a> · <a href="https://vibevision.video/zh/submit/">投稿模板</a></td>
  </tr>
</table>

<p align="center"><sub>© 2026 Vibe Vision Video contributors · <a href="https://vibevision.video/zh/">vibevision.video</a></sub></p>

© Vibe Vision Video contributors · MIT · actionow-ai/vvv

Похожие плагины

Все плагины по теме «Фронтенд и UI» →
remotion официальный Remotion Плагин remotion помогает создавать видео на React с анимациями, звуком, субтитрами и 3D прямо в коде. Пригодится при программной сборке и рендеринге роликов через FFmpeg. CX Codex GP ChatGPT ★ 8 052звёзд репо video-motion-design makushingu Скилл video-motion-design для Claude Code создаёт моушн-дизайн ролики на базе Remotion и React. Агент генерирует видеоряд по запросу, включая заставки, трейлеры и анимации. CX Codex +1 ★ 285звёзд репо remotion-assemble notivn Скилл remotion-assemble для Claude Code настраивает сборку видео из сцен HyperFrames, футажей, голоса и звуков по файлу meta.json. Инструкции включаются при редактировании кода в каталоге engines/remotion. CX Codex +1 ★ 147звёзд репо remotion-create remotion-dev Скилл remotion-create для Claude Code и Codex разворачивает проект Remotion с нуля. Инициализирует репозиторий через npx create-video и готовит окружение к вёрстке видео на React. CX Codex +1 375 000установок remotion-captions remotion-dev Скилл remotion-captions для Claude Code и Cursor помогает работать с субтитрами в видеопроектах Remotion. Генерирует тайминги, конвертирует форматы и настраивает анимацию текста на экране. CX Codex +1 373 700установок ffmpeg digitalsamba Готовые команды FFmpeg для конвертации, сжатия, обрезки видео и подготовки ассетов к проектам на Remotion. CX Codex +1 16 500установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой