Beat Sync Video 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 特效。

规则

• 音乐节奏越明确卡点越准；无明显节拍时脚本自动退化为等间隔切换并在报告说明。
• 卡点用硬切（不加转场），否则会糊掉节拍感——这是刻意设计。
• 素材不足自动循环；素材充足时建议 --every 1~2 让每段都换新画面。
• 成片默认跟音乐等长，用 --max-duration 卡平台时长。
• 产物统一进 outputs/主题名/。

参考来源

节拍检测用 librosa beat_track（onset 强度 + 动态规划求拍点），画面在拍点硬切是卡点混剪的

标准做法。把节拍→区间→逐段渲染→音画对齐封装成确定性脚本，避免手数拍子对不齐。