Communitygithub.com

ZJU-REAL/Easel

音樂卡點影片 / 踩點影片:偵測背景音樂的節拍,讓圖片或片段在節拍點上切換,搭配推進/白閃特效,製作出燃系「卡點」短影片。

Easel 是什麼?

此技能(ZJU-REAL/Easel)是一種基於音訊節拍偵測的影片製作工具,專門用於創建「卡點」或「踩點」風格的短影片。它利用 librosa 函式庫(beatsync.py 腳本)分析背景音樂的 BPM 和節拍時間點,然後自動將使用者提供的圖片或短影片片段硬切到節拍上,並可選用推進(zoom)或白閃(flash)特效來增強視覺衝擊力。支援的命令列選項包括調整切換頻率(每幾拍切一次)、限制輸出長度以及指定畫幅尺寸。該技能會根據使用者設定檔(Profile)建議風格(快閃或舒緩),但最終仍需使用者確認。它與一般幻燈片影片(slideshow-video)的區別在於,卡點影片採用硬切無轉場,以保持節奏感,且素材不足時會自動循環使用。適用於抖音、Instagram Reels 等短影音平台,特別適合潮流、運動、生活或治癒類帳號。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/openclaw/beat-sync-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

音樂卡點影片(踩點混剪)

用 librosa 偵測背景音樂節拍,讓畫面在節拍上硬切換,搭配節拍特效,做出「踩點」燃系短影片。 全部走 skills/shared/scripts/beatsync.py,不要手數節拍、手拼濾鏡——腳本已做 節拍偵測、區間切分、素材循環、音畫對齊。

每圖固定時長的柔和相冊見 slideshow-video;主題→AI 配圖配音成片見 auto-short-video。

輸入

欄位必填說明
背景音樂是決定卡點的音樂檔案(節奏越強效果越好;沒給就問)
素材是一組圖片和/或短片段(按順序,循環使用),或一個目錄
畫幅是使用者或上游任務未明確橫版/豎版(或具體解析度)時,製作前必須追問並等確認;不得按平台、Profile 或預設值靜默推斷,已明確則不重複問
切換頻率否每幾拍切一次(預設每 2 拍)
特效否zoom 推進(預設)/ flash 白閃 / none

輸出(outputs/主題名/)

  • 卡點成片(*.mp4)
  • 報告:卡點段數、總時長、偵測到的 BPM、特效

執行步驟

腳本路徑(相對專案根目錄):skills/shared/scripts/beatsync.py(build -h / beats -h)。

1.(可選)先看節拍

python skills/shared/scripts/beatsync.py beats --music <音樂>
# 列印 tempo(BPM) 與節拍時間點,用於判斷 --every 該設多少

2. 生成卡點影片

python skills/shared/scripts/beatsync.py build \
  -i 1.jpg 2.jpg 3.jpg 4.jpg --music <音樂> \
  -o outputs/主題名/show.mp4 \
  --size 1080x1920 --every 2 --effect zoom
  • 素材 = 圖片或短片段,數量可少於卡點段數(自動循環複用)。
  • --every 1 每拍都切(快閃,素材要多);--every 4 每小節切一次(舒緩)。
  • --effect flash 段首白閃更「燃」;--effect none 乾淨硬切。
  • --max-duration 15 限制成片長度(如做 15s 抖音)。
  • 也可 --images-dir <目錄> 批量餵素材(按檔名排序)。

Profile 感知

  • 有 Profile:platforms.md 只用於給出畫幅建議,仍須使用者確認;卡點風格(快閃/舒緩)與特效貼合帳號調性 (潮流/運動帳號偏快閃 flash,生活/治癒帳號偏 zoom 舒緩)。
  • 無 Profile:先確認橫版/豎版;預設每 2 拍、zoom 特效。

規則

  1. 音樂節奏越明確卡點越準;無明顯節拍時腳本自動退化為等間隔切換並在報告說明。
  2. 卡點用硬切(不加轉場),否則會糊掉節拍感——這是刻意設計。
  3. 素材不足自動循環;素材充足時建議 --every 1~2 讓每段都換新畫面。
  4. 成片預設跟音樂等長,用 --max-duration 卡平台時長。
  5. 產物統一進 outputs/主題名/。

參考來源

節拍偵測用 librosa beat_track(onset 強度 + 動態規劃求拍點),畫面在拍點硬切是卡點混剪的 標準做法。把節拍→區間→逐段渲染→音畫對齊封裝成確定性腳本,避免手數拍子對不齊。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ZJU-REAL/Easel

AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI 视频生成、文生视频、图生视频、AI 生成视频、AI 短视频、让图片动起来、数字人视频、生成一段视频 时使用。与 video-strategy(选型/策略)、video-editing(剪辑处理)、clipify(切片)区别:本 SKILL 是从 0 用 AI 生成新视频。

ZJU-REAL/Easel

通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成 mp3”“调音量/响度”“提取音轨/扒音频”“拼接音频”“淡入淡出”“加速/减速音频”“变速不变调”时使用。与 audio-denoise 的区别:audio-denoise 专做降噪,audio-editing 做除降噪外的通用音频操作(也内置 denoise 作为兜底)。

ZJU-REAL/Easel

一句话主题 → 成品短视频:自动串联 文案→配图/AI视频→配音→字幕→BGM→合成,把 Easel 制作层零件编排成一条'一键出片'流水线。**单条视频、口播/资讯向,画面默认逐句配图 + Ken Burns 缓动,需要动态时才逐段图生视频**。当用户说 一键生成视频、自动做短视频、主题生成视频、帮我做条视频、口播视频一条龙、自动出片、短视频一键生成 时使用。**有剧情/角色/对白/反转/多集的短剧改用 short-drama(每镜强制图生视频、不用静态图冒充);只写脚本用 video-script;只生成单个片段用 ai-video-gen。**

ZJU-REAL/Easel

自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。

ZJU-REAL/Easel

Easel clipify: long English talk → punchline cuts → optional 16:9→9:16 face-pan/split → opus word-by-word ASS burn. Ships scripts + assets/preview.png. Part of 1.6k★ Easel suite.

ZJU-REAL/Easel

>- 通用图像处理加工:改尺寸/缩放、裁剪、补边适配平台尺寸、格式转换(png/jpg/webp)、 压缩到目标大小、加文字或图片水印、圆角、多图拼接、生成缩略图、读图片信息。 基于 image_ops.py 确定性处理。 使用时机:用户说"改尺寸"、"缩放图片"、"裁剪"、"压缩图片"、"加水印"、"转格式"、 "圆角"、"拼图/多图联排"、"缩略图"、"适配小红书/朋友圈尺寸"、"把图 pad 成 1:1"。 和 card-*(卡片类)的区别:card-* 是"HTML 设计→渲染出图", image-editing 只加工已有图片,不负责视觉设计。

ZJU-REAL/Easel

多角色对话配音:按 cast 和逐行对白为不同角色分配音色与情绪,合成多声线音轨和带角色名字幕。 当用户说“多角色/双人/剧本/对话配音、多人对白、不同角色不同声音、有声剧配音”时使用。 单一公共音色用 tts-voiceover;克隆本人音色用 voice-clone;整部短剧制作由 short-drama 编排。

ZJU-REAL/Easel

Easel video-highlights: CN/livestream highlight extract + stable static vertical reframe (sibling to clipify).

ZJU-REAL/Easel

>- 视频制作策略与工具选型:AI 视频生成模型对比、视频脚本结构设计、制作流程规划,覆盖产品演示/解说/社媒短视频场景。 当用户说"视频怎么做""视频选型""用什么工具做视频""视频制作流程""视频策略""视频系列规划"时使用。 和 video-script 的区别:video-strategy 做内容规划与工具选型,video-script 写具体某条视频的脚本。

相關技能