跳舞模式

目标：学会让 LeLamp 跟着音乐跳舞（节拍联动 + 跳舞动画 + RGB 灯光联动）

一、什么是跳舞模式

跳舞模式让 LeLamp 随音乐"动起来"：系统实时读取音乐的节拍（BPM）和能量（energy），自动切换不同的跳舞动画，同时 RGB 灯光配合舞步变换颜色。

启动跳舞模式前，先确保有音乐在播放（本地音乐 / 在线搜索 / Spotify 都可以）

音乐源会提供 BPM 和能量值：Spotify 提供真实分析值；本地/在线播放会回传估算值；没放音乐时能量为 0，不会跳舞。

方式	操作	你应看到什么
界面开关	Dashboard 页面点开跳舞模式（dance）开关	开关变蓝/ON，日志区出现"Starting dance mode"，LeLamp 开始随音乐摆动
语音触发	播放音乐后说 "来段舞" / "跳个舞"	LeLamp 回应并开始跳舞动作
工作流触发	说"派对模式"，激活派对工作流	灯光闪烁 + 音乐 + 舞步联动

关闭：再点一次开关，或说"别跳了"（停止后回到待机姿态 idle）。

系统按能量值（0.0-1.0）自动切换动画：

可调项（进阶）：dance_threshold（默认 0.25）和 excited_threshold（默认 0.6）两个阈值可在配置中调整，调低一点会让 LeLamp 更容易"嗨起来"。

即使不开跳舞模式，也可以让 LeLamp 随节拍小幅律动：在 Dashboard 打开 music_mod 开关，舵机会在基础姿态上叠加周期性摆动，跟着 BPM 点头/摇摆。

灯光可以独立于电机开关，形成"四象限"玩法：

	动作（电机）	灯效（RGB）
音乐驱动	music_mod 节拍律动	灯效音律：灯光随 BPM 脉冲，颜色随能量变化
跳舞驱动	跳舞模式（CSV 动画）	灯效跳舞：灯光波浪冲刷，配合舞步变色

在 Dashboard 灯效区点 灯效音律 或 灯效跳舞 即可开关：

灯效音律和灯效跳舞互斥，开一个会自动关另一个；两者都可以在不开电机跳舞时单独使用（比如只想让灯跟着音乐闪）。

问题	处理
开了跳舞开关但不动	检查是否有音乐播放（能量为 0 不触发）；确认 dance_normal.csv / dance_excited.csv 存在；确认电机服务正常
跳得不够嗨	播放能量更高的歌；或调低 excited_threshold
灯光没反应	确认灯效开关已开（音律/跳舞二选一）；RGB 需要 `rgb.enabled=true` 且驱动正常；无音乐时灯效音律只有温和呼吸，属正常
灯效跳舞开了但没变化	灯效跳舞需要配合"跳舞模式"开启且能量高于阈值才会触发灯光切换
只想要灯闪、不想电机动	单独开灯效音律/灯效跳舞即可，不用开跳舞模式
没声音	检查音频设备配置（`player.audio_device`）；树莓派需 `sudo apt install mpv ffmpeg`；在线链接有时效，换源重试