技能介绍

核心问题

把任意 .wav 音频转成特斯拉车机能直接播放的灯光秀，并非简单的节奏映射：需要处理音频特征、车型灯光差异、灯光通道的硬件限制，还要保证生成的 .fseq 文件能通过车机校验。很多自制方案要么通道数不对导致车机拒绝加载，要么节奏与灯光动作错位，要么忽略了不同车型的灯光硬件差异（比如 Model 3 Highland 的内饰氛围灯、Cybertruck 的灯光条）。

工作原理

1. 音频分析与车型适配

输入必须是 44.1 kHz 的 .wav 文件（非此采样率仅提示告警，不阻断生成），同时需明确车型——支持自然语言输入（如 "2024 款 Model 3"、"Plaid X"），自动映射为 6 种车型标识（含 Model 3 Highland 等特殊版本）。分析阶段以 20 ms 帧采样，提取能量、节拍、调性、段落结构等特征，立体声感知 特性会保留 L/R 声道差异，用于驱动左右侧灯光的精准触发（如 hi-hat 右声道偏移时仅点亮右侧标记灯）。

2. 灯光编排与约束处理

根据车型能力绑定音频特征到灯光通道：48 通道覆盖 Model 3/S/Y，200 通道激活 Cybertruck 的灯光条与内饰 RGB。编排时严格遵守硬件限制：如 Model X 的 Falcon 车门仅允许 6 次开合，需提前 25 s 触发开启；关闭动作的触发时机需考虑执行时长（如 liftgate 开启需 14 s 准备时间）。高潮段落（而非随机时间点）会触发全灯光爆发，配合车门/充电口舞蹈动作。

3. 输出校验与异常处理

生成后通过 validator.py 校验文件格式（魔数 PSEQ、版本 2.0、无压缩），注意校验脚本的退出码不可靠：需通过输出首行判断结果（成功提示含帧数与时长），忽略末尾的 EOFError 追踪（因非交互式运行导致）。最终输出需将音频与 .fseq 同名存放于 LightShow/ 目录，车机仅识别 FAT32/exFAT 格式 U 盘。

适用边界与注意点

硬件兼容性：Model 3 Highland 的 200 通道文件可向下兼容旧款 Model 3（多余通道自动忽略），但旧车型无法激活内饰 RGB。
音频限制：超 4 小时音频会被截断，非 44.1 kHz 音频可能在车辆上出现节奏偏移。
动作预算：所有开合动作（车门、充电口等）有次数限制，超量编排会导致灯光秀中断。
车型差异：Model S 的门把手为独有通道，Model X 无门把手但有后雾灯；Cybertruck 的后转向灯实际由前备箱灯模拟，编排时需特殊映射。