AI 内容生成器

目标：学会用一句话让 AI（DeepSeek）自动生成动画、灯效、情绪定义——不用手写 CSV 或代码，说需求即可生成可用的内容

一、能生成什么

LeLamp 内置三个 AI 生成器，覆盖三类可自定义内容：

生成的动画、灯效、情绪立即生效，无需重启、无需写代码。

二、在哪里用

方式一：Web 页面（推荐）

在「动画」「RGB 灯效」「情绪」三个页面的顶部，都有一个紫色 AI 生成输入条：

1. 输入一句话描述需求（例如"先左摆再点头的打招呼动作"）
2. 点击生成
3. 生成成功后列表自动刷新，新内容直接可用；失败会红字显示原因

方式二：命令行（SSH）

# 生成动画（--dry-run 只看结果不保存）
python3 scripts/gen_animation.py "开心地点头打招呼" --dry-run
python3 scripts/gen_animation.py "开心地点头打招呼"

# 生成灯效
python3 scripts/gen_rgb.py "粉色呼吸灯"

# 生成情绪
python3 scripts/gen_emotion.py "得意的情绪，抬头加金色光"

三、生成原理（了解即可）

1. 提示词模板：每个生成器内置一套固定 schema 提示词，告诉 AI 输出什么样的 JSON 结构（关节名、幅度范围、软限约束等）
2. JSON 校验：AI 返回的 JSON 经过严格校验（字段类型、数值范围、关节白名单），不合法就拒绝并提示
3. 安全约束：
   • 动画：关键帧的关节值会被软限校验（如 base_pitch ±30 防翻倒），超限直接拒绝
   • 灯效：只生成"参数化描述"（呼吸/脉冲/扫光等），不生成 Python 代码，由通用渲染器解释执行——安全且一致
   • 情绪：合并写入 emotions.json，标签去重
4. 依赖 DeepSeek：生成走 DeepSeek API（与 AI 对话同一个后端），需要网络可用

四、常见问题