RGB 灯效管理

目标：学会管理 RGB 灯效——浏览内置灯效、AI 生成自定义灯效、删除自定义灯效（内置受保护）

一、灯效页面

打开 RGB 灯效页面（顶栏 图标，或访问 /rgb-animations），可以看到全部灯效列表：

• 每个灯效有中文描述（如「聚光强调」「思考状态灯效」）
• 点击播放试效果，再点停止
• 系统内置 23 个灯效（紧急闪烁、聚光、呼吸、彩虹、扫描、跟随说话…）

二、播放与联动

• 直接在列表点灯效名播放；播放中可停止
• 部分灯效与状态联动：思考时亮"思考灯"、说话时亮"说话灯"、监听时亮"监听灯"
• 音乐播放时灯效随节拍（bpm_pulse 节拍脉冲 / energy_wave 能量波）

三、自定义灯效

AI 生成（推荐）

灯效页面顶部 AI 生成输入条：

1. 输入描述，如"像呼吸一样渐变的粉色灯"
2. 生成后自动注册并出现在列表（存为 sequences/custom/<name>.json）
3. 立即播放验证

支持的模式：solid（纯色）、breathe（呼吸）、pulse（脉冲）、sweep（扫光）、rainbow（彩虹）等。

安全设计：AI 只生成"参数化描述"，不生成 Python 代码，由通用渲染器解释执行——不会引入恶意代码。

手写 JSON（进阶）

在 lelamp/service/rgb/sequences/custom/ 新建 <name>.json：

{
  "name": "my_breathe",
  "description": "我的粉色呼吸灯",
  "mode": "breathe",
  "color": [255, 100, 150],
  "duration": 3.0
}

重启或刷新后出现在列表。

四、删除灯效

• 自定义灯效：列表项有 删除按钮，点击确认后删除（JSON 文件 + 注册表同步移除）
• 系统内置灯效：没有删除按钮，显示灰色「系统内置」标签，悬停提示不可删除——后端也有双重保护，防止误删

五、常见问题