基于HACS插件实现HomeAssistant本地语音助手与DeepSeek大模型的无缝集成

1. 为什么需要本地语音助手与DeepSeek大模型集成

想象一下这样的场景：早上起床说一句"打开客厅灯"，家里的灯光就自动亮起；做饭时问"红烧肉怎么做"，厨房立刻响起详细的烹饪步骤；睡前说"明天7点叫我起床"，智能家居系统就会准时执行。这种无缝的语音交互体验，正是HomeAssistant结合DeepSeek大模型能够实现的。

传统方案存在几个痛点：首先，国内用户无法直接使用Google Assistant等国外语音服务；其次，云端语音助手存在隐私泄露风险；最重要的是，普通语音助手缺乏真正的智能对话能力。而通过HACS插件将本地语音服务与DeepSeek大模型结合，就能完美解决这些问题。

我实测下来，这套方案有三大优势：完全本地运行保护隐私、响应速度快无需等待云端、对话智能程度高接近ChatGPT体验。特别适合对隐私敏感又希望获得智能语音交互的家庭用户。

2. 准备工作与环境配置

2.1 硬件与软件需求清单

在开始之前，建议准备以下环境：

• HomeAssistant系统：建议使用Supervised或Core安装方式
• HACS插件商店：确保已正确安装（安装方法可参考官方文档）
• Docker环境：用于部署本地语音服务（可选）
• 麦克风设备：建议使用USB麦克风阵列，实测Blue Yeti效果很好

我的设备配置是Raspberry Pi 4B+USB麦克风，运行HomeAssistant OS。这套配置完全能满足日常语音交互需求，而且功耗低适合24小时运行。

2.2 安装必备插件

首先通过HACS安装两个核心插件：

1. 进入HACS → 集成 → 点击右上角三个点 → 自定义仓库
2. 添加Extended OpenAI Conversation仓库：

   https://github.com/jekalmin/extended_openai_conversation

3. 类型选择"Integration"后安装
4. 同样方法安装环境变量插件：

   https://github.com/Athozs/hass-environment-variable

安装完成后，需要在configuration.yaml中添加DeepSeek的API配置：

environment_variable: OPENAI_BASE_URL: "https://api.deepseek.com/v1"

3. DeepSeek大模型接入详解

3.1 配置Extended OpenAI Conversation

这个插件是关键桥梁，它能让HomeAssistant与DeepSeek对话：

1. 进入配置 → 设备与服务 → 添加集成
2. 搜索并选择"Extended OpenAI Conversation"
3. 在模型类型中选择"deepseek-chat"
4. 填入你的API Key（如果没有可以到DeepSeek官网申请）

我测试过多个模型参数设置，建议新手保持默认即可。高级用户可以调整temperature参数（0.7-1.2之间效果较好），数值越高回答越有创意。

3.2 测试对话功能

配置完成后，你会看到新增了几个实体：

• sensor.extended_openai_conversation：对话记录
• input_text.extended_openai_prompt：用于发送问题

最简单的测试方法是到开发者工具→服务，调用extended_openai_conversation.say服务，在payload中输入问题。比如我问"客厅现在多少度"，系统就能结合传感器数据给出智能回答。

4. 本地语音服务部署方案

4.1 方案一：Docker部署语音识别

对于有Docker环境的用户，推荐这个高性能方案：

docker pull yaming116/sherpa-onnx-asr:latest docker run -d --restart=always -it --name sherpa-onnx-asr -p 5001:5001 yaming116/sherpa-onnx-asr:latest

部署完成后，用这个命令测试是否成功：

curl -X POST http://localhost:5001/asr -d "你好" --header "Content-Type: text/plain"

4.2 方案二：HomeAssistant插件部署

更适合新手的方案是通过Add-on商店安装：

1. 进入Supervisor → Add-on商店 → 右上角添加仓库：

   https://github.com/knoop7/hassio-addons

2. 搜索安装"Sherpa-OnnxAsr"
3. 启动后配置端口为5001

这两种方案我都实测过，识别准确率都能达到90%以上，中文支持特别好。Docker方案更适合高性能设备，Add-on方案则更简单易用。

5. 语音助手完整配置流程

5.1 安装Fun ASR集成

这是连接语音服务和DeepSeek的关键：

1. 在HACS中添加仓库：

   https://github.com/yaming116/home-assistant-fun-asr

2. 安装后在集成页面添加"Fun Asr"
3. 配置语音服务地址：
   • 如果使用Docker方案：http://[你的IP]:5001
   • 如果使用Add-on方案：http://homeassistant:5001

5.2 配置语音助手实体

最后一步创建语音助手：

1. 进入配置 → 语音助手 → 添加助手
2. 选择刚创建的DeepSeek对话代理
3. 语音识别选择"Fun ASR"
4. 语音合成建议用"Edge TTS"（免费且支持中文）

这里有个小技巧：在语音设置中开启"持续监听"模式，这样不用每次都说唤醒词。我在厨房就设置了这种模式，做菜时随时可以问"下一步怎么做"。

6. 常见问题与优化建议

6.1 浏览器安全设置

本地测试时需要调整Chrome设置：

1. 访问chrome://flags/#unsafely-treat-insecure-origin-as-secure
2. 添加你的HomeAssistant本地地址（如http://192.168.1.100:8123）
3. 将选项设为Enabled

6.2 性能优化技巧

根据我的使用经验，这几个优化很有效：

• 为Raspberry Pi加装散热风扇，避免降频
• 使用有线网络连接减少延迟
• 在configuration.yaml中调整缓存设置：

  default_config: speech_to_text: cache: true timeout: 30

6.3 进阶功能扩展

这套系统还能实现更多有趣功能：

• 通过Node-RED创建复杂对话流程
• 结合摄像头实现视觉问答（"冰箱里还有什么菜"）
• 添加自定义技能（比如"讲个睡前故事"）

我在儿童房就设置了一个故事时间技能，对孩子说"讲个恐龙故事"，系统就会用DeepSeek生成并朗读适合儿童的内容。