智能台灯LeLampX快速入门教程-目录
LeLampX 智能台灯简介
00 LeLampX 是什么
目标：了解 LeLampX 是什么、能做什么、由什么组成
LeLampX 历史
-
最早的灵感来源是苹果的elegnt，具体演示可以看看youtube的视频，一款非常人性化的智能台灯机器人
-
基于这个灵感，humancomputerlab开发了lelamp的基础版本，这个版本功能比较基础。封装lerobot的控制接口，和简单的灯效和动作功能。
-
加拿大多伦多大学的学生创客活动(uofthacks)期间开发了一套基于lelamp的功能扩展lelampv2，这个就有更多的功能。但是各项功能基于国外服务搭建，国内基本用不上。但是提供给了一个很好的功能框架和基础服务。
-
在这些前辈的基础上，我们对硬件和模型做了进一步的优化，对整个功能框架进行重构和扩展，才有现在功能更完善的版本LeLampX。现包含语音交互，大模型推理，动作管理，灯效管理，音乐管理，视频和图片管理，情绪管理，配置管理，工作流管理，闹钟管理等更强大的功能。
相关设备
- LeLampX套件: 采购地址
一、产品定位
LeLampX 是一台智能桌面机器人台灯——把 AI 语音助手装进一盏会动的台灯里。它可以：
- 语音对话：像朋友一样聊天、问答、执行指令
- 灯光控制：RGB 彩灯，颜色/亮度/灯效随心调
- 音乐播放：本地音乐、在线点歌、跟随节拍跳舞
- 动作表达：5 个舵机让台灯"活"起来——点头、摇头、鞠躬、挥手
- 定时提醒：语音设置定时器、闹钟
- 工作流：一句话生成多步骤流程（专注模式、智能闹钟等）
- 视觉能力：摄像头人脸追踪、手势识别、场景描述
- 联网查询：天气、新闻、时间、系统状态
二、能力总览
┌─────────────────────────────────────────────┐
│ LeLampX │
│ ┌─────────┐ ┌─────────┐ ┌───────────────┐ │
│ │ 语音交互 │ │ 运动表达 │ │ 灯光/音乐/视觉 │ │
│ │ STT+LLM │ │ 5×舵机 │ │ RGB+音频+相机 │ │
│ │ +TTS │ │ 动作编排 │ │ 工作流系统 │ │
│ └─────────┘ └─────────┘ └───────────────┘ │
│ ▲ ▲ │
│ └── Web 管理界面 ──┘ │
└─────────────────────────────────────────────┘核心交互方式有两种：
- 语音——直接说话，LeLampX 用语音回答（最快最自然）
- Web 界面——浏览器访问管理页面（配置、查看、精细控制）
三、系统组成
| 部件 | 说明 |
|---|---|
| 树莓派 | 主控计算单元（推荐 Pi 5 或更高） |
| 舵机 ×5 | 飞特 12V 总线舵机：底座左右/前后、肘部、手腕旋转/俯仰 |
| RGB LED | 24 颗 WS2812B 灯珠，台灯照明 + 状态灯效 |
| 麦克风阵列 | ReSpeaker 2-Mic，远场拾音 |
| 扬声器 | 语音回复与音乐播放 |
| 摄像头 | 人脸追踪、手势识别、场景描述 |
| 电源 | 12V 供电（建议 5A 以上，舵机负载大） |
四、软件架构（了解即可）
┌───────────────────────────────────────────────┐
│ Web UI（React + Vite） ← 浏览器管理界面 │
├───────────────────────────────────────────────┤
│ API 服务（FastAPI） ← REST + WebSocket │
├───────────────────────────────────────────────┤
│ 语音管线（v1/v2） ← STT → LLM → TTS │
│ · STT：FunASR / SenseVoice / Faster-Whisper │
│ · LLM：DeepSeek / Ollama │
│ · TTS：EdgeTTS / Piper │
├───────────────────────────────────────────────┤
│ 设备服务 │
│ · 动画服务（舵机播放/编排） │
│ · 音频服务（播放/录制） │
│ · 视觉服务（摄像头/人脸/手势） │
│ · 工作流服务（多步骤流程引擎） │
│ · 音乐管理（本地/在线/Spotify） │
└───────────────────────────────────────────────┘用户不需要懂软件架构也能正常使用；了解它有助于理解后续教程中"为什么这样做"。