Communitygithub.com

zhaoxuan0205-sys/drum-performance-video-editor

将人物演奏视频与单独录制的鼓声音频同步剪成架子鼓成片。适用于筛选正确录制版本、保留歌曲前奏、对齐落鼓动作与鼓声、删除准备或操作设备画面、检查漂移并轻度提亮。

¿Qué es drum-performance-video-editor?

drum-performance-video-editor is a Claude Code agent skill that 将人物演奏视频与单独录制的鼓声音频同步剪成架子鼓成片。适用于筛选正确录制版本、保留歌曲前奏、对齐落鼓动作与鼓声、删除准备或操作设备画面、检查漂移并轻度提亮。.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add zhaoxuan0205-sys/drum-performance-video-editor

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

架子鼓演奏视频剪辑

把人物画面与外录音频剪成自然、准确同步的连续演奏视频。 当前常用设备为 DJI Action 拍摄画面、罗兰 TD-17 KVX2 内嵌录制音频。设备型号用于判断采样率、独立时钟漂移和音轨来源,不限制 Skill 处理其他相机或鼓机。

核心流程

  1. 检查素材时长、帧率、音轨和录制次数。
  2. 根据停顿、操作手机和重新就位,选择用户指定的正确版本。
  3. 分别确定:音乐开始、第一次视觉落鼓、对应的第一下鼓声。
  4. 以“鼓棒接触鼓面或镲片的画面帧 ↔ 鼓声瞬态”建立同步;歌曲有前奏时必须保留,不能把音乐开始误当成第一下鼓声。
  5. 检查开头、中段和结尾。误差一致时调整固定偏移;误差持续增大时才修正漂移。
  6. 删除准备、错误版本和操作设备画面。结尾保留最后一击及约 1–2 秒自然停顿。
  7. 成片只能使用外录音频;相机原声必须完全静音,禁止与外录音频混合。画面偏暗时仅做轻度提亮。
  8. 完整观看成片,确认首鼓、中段、结尾同步后再制作封面或进入发布流程。 具体判断和验收方法见 references/workflow.md。

渲染

确定视频入点、音频入点和时长后运行:

python scripts/render_edit.py \
  --video camera.mp4 \
  --audio recorder.wav \
  --video-in 6.300 \
  --audio-in 10.684 \
  --duration 188.800 \
  --output final.mp4 \
  --brighten

每组素材必须重新测量参数,不得沿用上一首歌的数据。

关键规则

  • 整段波形相关性只能辅助检查,不能单独决定初始同步点;它可能只对齐伴奏。
  • 只看鼓棒真实接触,不能用手臂开始运动或回弹作为落鼓时刻。
  • 渲染时只映射人物视频的画面轨和外录文件的音轨;不得映射或混合相机音轨。
  • DJI Action 与 TD-17 KVX2 独立计时;长曲必须检查首、中、尾三个锚点,确认是否存在时钟漂移。
  • 不逐个量化真实演奏中的小误差,也不随意改变视频速度。
  • 未经用户最终确认,不执行公开发布。

Skills relacionados