AI 提供商配置

目标：学会切换 LLM（DeepSeek/Ollama）、STT 与 TTS 引擎，配置 API Key，更换 LeLamp 的声音

一、前提

• ✅ 能打开 Web 设置界面 /settings
• ✅ 如需改 config.yaml，准备好 SSH 终端（见教程 31 网络与远程访问）

LeLamp 的 AI 能力分三块，可独立切换：

二、两种配置方式

无论哪种方式，改完配置都要让配置生效：Web 方式一般自动重启，config.yaml 方式执行 sudo systemctl restart lelamp。

三、切换 LLM：DeepSeek（云端）或 Ollama（本地）

先看对比，选适合你的

选择建议：家里网络稳定 → DeepSeek（更聪明）；想完全离线/省钱 → Ollama。

用 Web 界面切换

1. 打开 /settings → "AI 后端设置"卡片
2. 提供商选择 DeepSeekLLM 或 OllamaLLM
3. 选 DeepSeek 时填入 API Key（见第四节）

你应看到什么：仪表盘"AI 后端信息"显示当前 LLM 名称；对 LeLamp 说"现在几点了"，它能正常回答。

用 config.yaml 切换

pipeline:
  llm:
    # 1. 本地 Ollama
    provider: OllamaLLM

    # 2. 云端 DeepSeek（二选一）
    provider: DeepSeekLLM
    api_key: 'sk-your-key-here'
    model: deepseek-chat        # deepseek-chat (V3) / deepseek-reasoner (R1)
    base_url: https://api.deepseek.com
    temperature: 0.7

模型选择注意：deepseek-v4-flash 支持工具调用（开关灯、放音乐等）；

这套实现兼容所有 OpenAI 格式的 API：OpenAI、OpenRouter、Groq、Together AI 等，只需把 base_url 和 api_key 改成对应服务商的即可。

四、设置 API Key

三种方式任选其一：

你应看到什么：Key 填错时，LeLamp 会回复"AI 服务返回错误"（401），日志里也会记录状态码；填对后对话恢复正常。Key 要去 platform.deepseek.com 申请。

五、切换 STT 引擎（让 LeLamp 更听懂你）

三种引擎，默认是 FasterWhisper（tiny 模型）：

中文用户建议换 FunASR 或 SenseVoice——又准又快还省内存。 目前只使用效果最好的SenseVoice

切换步骤

# 1. 安装依赖（项目用 uv 则：uv pip install funasr onnxruntime）
pip install funasr onnxruntime

# 2. 修改 config.yaml

stt:
  provider: SenseVoiceSTT            # FasterWhisperSTT / FunASRSTT / SenseVoiceSTT
  model: paraformer-zh-small     # tiny / paraformer-zh-small / iic/SenseVoiceSmall

# 3. 重启生效
sudo systemctl restart lelamp

验证

cd ~/lelampv2
python3 scripts/test_stt_backends.py --record   # 录音并测试所有后端
python3 scripts/test_stt_backends.py --backend funasr --file test.wav

你应看到什么：测试脚本打印各后端的识别文本；换用 FunASR 后说同一句中文，识别准确率明显更高。SenseVoice 还能额外识别情感（高兴/悲伤/愤怒/中性）和事件（掌声/笑声/音乐）。

六、切换 TTS 引擎与语音（给 LeLamp 换声音）

四种引擎：

推荐优先级：edge-tts（在线、免费、音质最好）> kokoro（离线）> gTTS > piper。 目前只使用效果最好的dge-tts

切换步骤

# 1. 安装依赖（Edge 需要 ffmpeg 解码）
pip install edge-tts
sudo apt install ffmpeg

# 2. 修改 config.yaml
tts:
  provider: edge                 # edge / gtts / kokoro / piper
  voice: zh-CN-XiaoxiaoNeural    # 各后端独立命名
  lang: zh
  edge:
    rate: "+0%"                  # 语速，如 "+20%" 加快
    pitch: "+0Hz"                # 音调

常用中文语音

验证

cd ~/lelampv2
python3 scripts/test_tts_backends.py --quick            # 单句对比所有后端并播放
python3 scripts/test_tts_backends.py --list-voices      # 查看全部可用语音

你应看到什么：脚本依次播放各引擎合成的声音，并打印耗时对比表；改完配置重启后，对 LeLamp 说句话，听到的声音就是新引擎/新音色了。

七、语音指令快捷切换（临时）

不改配置也能临时切换，直接说：

语音切换是运行时生效，重启后仍以 config.yaml 为准。想要长期固定某个引擎，请用第二节的配置方式。

八、常见问题