用途：分析音频或视频文件，生成 beat-grid.json，记录曲目的完整节奏骨架，包括 BPM、各拍时间、强拍、小节与起音瞬态。下游工具可据此把剪辑点、字幕转场或音效对齐到音乐网格。若输入为视频，会先用 ffmpeg 提取音频为临时 WAV，其余流程与纯音频一致。
主要能力：使用 librosa 进行节拍跟踪与起音检测，输出 BPM、拍时间、强拍、小节区间和起音时间；同时写出 manifest.json 记录运行元数据。
使用方式：命令行运行 python3 skills/atoms/audio-editing/extract-beat-grid/scripts/extract_beats.py --source <path> --output-dir <dir> [--beats-per-bar 4]。source 支持 mp3、wav、m4a、aac、flac 及 mp4、mov、webm；output_dir 不存在时会创建；beats_per_bar 默认 4。
适用场景：需要按音乐节拍对齐剪辑、字幕或音效的音频/视频后期流程。
限制：需 ffmpeg/ffprobe 在 PATH 中；需安装 librosa 及 soundfile 或 audioread 后端。视频无音轨会失败；极短或静音音频可能返回空拍或不可靠 BPM，bpm 小于 20 应视为不可靠。收费、价格与平台信息暂未提供。