beat-sync-video · 音乐卡点视频
音乐卡点短视频制作 skill：用 librosa 检测背景音乐的节拍，让图片或短片段在节拍点上硬切换，配推进（zoom）或白闪（flash）特效，生成"踩点"燃系短视频。
输入背景音乐与一组素材即可：切换频率可调（默认每 2 拍切一次），素材不足时自动循环复用；成片默认与音乐等长，可用时长参数卡平台限制。
调用示例：在聊天框中说"用这首歌和这几张照片做一条 15 秒竖屏卡点视频"。
产品详解
定位
beat-sync-video 是音乐卡点短视频生成器：节拍检测决定画面切换点，而不是固定时长切换。它做"踩点"混剪这一种视频形态，不做通用剪辑。
核心能力
- 节拍检测：librosa
beat_track检测音乐节拍（onset 强度 + 动态规划求拍点），输出 BPM 与拍点时间轴；无明显节拍时自动退化为等间隔切换并在报告中说明。 - 节拍硬切：画面在拍点硬切换（刻意不用转场，避免糊掉节拍感），按设定的每 N 拍切换一次。
- 节拍特效：zoom 推进（默认）/ flash 白闪 / none 干净硬切。
- 素材循环：素材数量可少于卡点段数，自动循环复用；也可批量喂目录按文件名排序。
- 生成报告：卡点段数、总时长、检测到的 BPM、所用特效。
工作流程
- 检测节拍（打印 BPM 与拍点，判断切换频率）
- 按参数生成卡点视频（素材、画幅、每几拍切、特效）
- 产物落盘
outputs/主题名/：成片 + 报告
输入与输出
| 输入 | 说明 |
|---|---|
| 背景音乐 | 必填，决定卡点；节奏越强效果越好 |
| 素材 | 必填，一组图片和/或短片段（按顺序），或一个目录 |
| 画幅 | 必填，横版/竖版/分辨率，须用户确认，不做默认推断 |
| 切换频率 | 选填，每几拍切一次（默认 2） |
| 特效 | 选填，zoom / flash / none |
| 时长限制 | 选填，如 15s 抖音规格 |
输出：卡点成片 *.mp4 + 生成报告（卡点段数、总时长、BPM、特效）。
与相邻 skill 的区别
| skill | 分工 |
|---|---|
| beat-sync-video（本） | 切换点由音乐节拍决定，硬切踩点带特效 |
| slideshow-video | 每图固定时长、柔和转场的相册视频 |
| auto-short-video | 主题→AI 配图配音的一键成片流水线 |
适用场景
- 音乐/潮流/运动账号的卡点混剪内容
- 用少量照片快速做出节奏感强的短视频
- 需要精确对齐鼓点的宣传片头片段
使用前准备
- 需准备背景音乐文件与素材；节奏明确的音乐效果最佳。
- 画幅须在制作前明确确认（横版/竖版/分辨率）。
- 本地脚本处理，无第三方 API 费用；首次使用需安装 librosa 等依赖。
beat-sync-video 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。