更新 'matter_server/README.md'

This commit is contained in:
2025-11-11 09:39:35 +00:00
committed by admin@cnod.net
parent 49cb62ca8f
commit 32fede081e
39 changed files with 2 additions and 1398 deletions

View File

@@ -1,9 +1,10 @@
# HaDB addonsMatter Server(官方无法安装可以试试本版本) # HaDB addonsMatter Server
![Supports aarch64 Architecture][aarch64-shield] ![Supports aarch64 Architecture][aarch64-shield]
![Supports amd64 Architecture][amd64-shield] ![Supports amd64 Architecture][amd64-shield]
## 关于 ## 关于
HaDB官方同步版官方源无法安装的可以安装本插件
Matter Python WebSocket服务器用于Home Assistant Core。Matter原名Connected Home over IP或CHIP是基于IPv6的智能家居标准。此插件提供了一个Matter控制器可让您调试和控制Matter设备。与之匹配的Home Assistant Core集成通过WebSocket与此服务器进行通信。 Matter Python WebSocket服务器用于Home Assistant Core。Matter原名Connected Home over IP或CHIP是基于IPv6的智能家居标准。此插件提供了一个Matter控制器可让您调试和控制Matter设备。与之匹配的Home Assistant Core集成通过WebSocket与此服务器进行通信。

View File

@@ -1,8 +0,0 @@
### 2.7.42 2025-05-09
- 版本升级
### 2.7.40 2025-05-08
- 版本升级
### 2.7.22 2025-04-27
- 版本升级
### 1.0.0-32 (2025-04-25)
- 首次推出

View File

@@ -1,182 +0,0 @@
# 小智 ESP32 语音助手
这是一个基于 ESP32 的语音交互助手系统,支持中文语音识别和播放功能,适用于智能家居控制。作为 Home Assistant 的加载项,提供便捷的安装和管理体验。
## 使用指南
### 安装前准备
1. Home Assistant OS、Supervised 或 Container 安装方式
2. MariaDB 加载项已安装(或外部 MySQL/MariaDB 数据库)
3. 具有较好网络连接的环境
4. 足够的存储空间(至少 500MB
### 配置选项说明
| 选项 | 描述 |
| ---------------- | ------------------------------------------------------ |
| `mysql_host` | 数据库主机地址,默认使用 MariaDB 插件为 `core-mariadb` |
| `mysql_port` | 数据库端口,默认为 `3306` |
| `mysql_database` | 数据库名称,默认为 `xiaozhi` |
| `mysql_user` | 数据库用户名,默认为 `xiaozhi` |
| `mysql_password` | 数据库密码,默认为 `123456` |
| `java_memory` | Java 应用内存分配,如 `512m``1g``1.5g` |
### 数据库设置
**自动配置方式**
插件会尝试自动创建数据库和所需表结构,您只需在配置中提供有效的数据库连接信息。
**手动配置方式**
如果您希望手动设置数据库,可以执行以下步骤:
```sql
CREATE DATABASE xiaozhi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'xiaozhi'@'%' IDENTIFIED BY '你的安全密码';
GRANT ALL PRIVILEGES ON xiaozhi.* TO 'xiaozhi'@'%';
FLUSH PRIVILEGES;
```
### 内存管理
可以通过配置项 `java_memory` 控制分配给 Java 应用的堆内存大小,格式示例:
- `512m`512 兆字节,适合大多数使用场景)
- `1g`1 吉字节,适合大量设备和频繁交互场景)
- `1.5g`或更高(适合高负载场景)
**内存管理建议**
- 默认内存分配512MB足够普通使用
- 对于多设备场景,建议分配 1GB 或更多内存
- 如遇内存不足问题,增加分配至 1GB 或更高
**优化资源使用**
- **关闭其他不必要的加载项释放资源**Home Assistant 上可能同时运行多个加载项,每个加载项都会消耗系统资源。建议临时停用不常用的加载项,特别是资源密集型的加载项(如 Node-RED、VS Code 等),以释放更多内存给语音识别服务。
- **监控资源使用**:通过 Home Assistant 的系统监控加载项,定期检查系统资源使用情况,确保有足够的可用内存。
- **优化运行时参数**:对于性能有限的设备(如某些 Raspberry Pi 型号),确保系统有足够的交换空间(swap)。
- **定期重启**:如果发现内存使用率持续升高,建议定期重启加载项,以释放累积的内存占用。可以在 Home Assistant 中设置自动化,定期重启此加载项。
### 端口说明
本加载项使用以下端口:
- **8091**API 服务端口ESP32 设备通过 WebSocket 连接此端口)
- **8084**Web 管理界面端口(可通过 Home Assistant 边栏访问)
## Web 界面功能
通过 Home Assistant 的边栏图标或直接访问`http://你的HA地址:8084`进入 Web 管理界面。
默认账号admin
默认密码123456
### 设备管理
可以添加、编辑和删除 ESP32 设备,主要功能:
- 设备列表查看
- 设备状态监控(在线/离线)
- 设备信息编辑
### 音色配置
支持为 ESP32 设备配置不同的语音合成音色:
- 预设多种中文音色
- 音色预览功能
- 为不同设备分配不同音色
### 角色设置
可以选择不同的 AI 助手角色:
- AI 助手
- 智能家居助手
- 其他预设角色
### 对话管理
查看与 ESP32 设备的历史对话:
- 按时间查看历史消息
- 按关键词搜索对话内容
- 消息管理功能
## ESP32 设备配置
1. 获取并烧录 ESP32 固件(从[原始项目](https://github.com/78/xiaozhi-esp32)获取)
2. 将 ESP32 设备连接到与 Home Assistant 相同的网络
3. 在 ESP32 固件配置中设置服务器地址:
```
ws://你的HA地址:8091/ws/xiaozhi/v1/
```
4. 在 Web 管理界面中添加对应的设备信息
## 高级功能
### 持久化对话
系统支持持久化对话记录,可以记住与用户的对话上下文:
- 自动保存对话历史
- 根据历史对话进行上下文理解
- 提供更自然的对话体验
### 自定义唤醒词(需 ESP32 固件支持)
如果 ESP32 固件支持,可以通过接口设置自定义唤醒词。
## 故障排查
### 加载项无法启动
- 检查 MariaDB 服务是否正常运行
- 验证数据库连接信息(主机、端口、用户名、密码)
- 查看 Home Assistant 日志是否有错误信息
- 确保分配了足够的内存给加载项
### 语音模型问题
- 检查 `/config/models/vosk-model` 目录是否存在模型文件
- 如果模型不存在,请手动下载并解压到该目录
- 确保存储空间足够(至少需要 100MB 空闲空间)
- 确保下载的是中文语音模型
### ESP32 设备无法连接
- 验证 ESP32 和 Home Assistant 在同一网络环境
- 检查 WebSocket 地址格式是否正确ws://ip:8091/ws/xiaozhi/v1/
- 确认 ESP32 固件是否正确配置
- 检查防火墙是否阻止了 WebSocket 连接
### 内存不足错误
- **增加`java_memory`配置**:根据设备性能适当增加,如从 512m 改为 1g
- **关闭其他不必要的加载项释放资源**
- 在 Home Assistant 的加载项页面,暂时停用不常用的资源密集型加载项
- 特别关注数据库、多媒体相关加载项,它们通常消耗较多资源
- 考虑使用 Home Assistant 的"系统诊断"功能,检查哪些加载项占用较多资源
- 如果使用的是低配置设备(如 Raspberry Pi 3 或更低),可能需要限制同时运行的加载项数量
- **优化系统配置**
- 增加系统交换空间(在树莓派等设备上尤为重要)
- 考虑使用性能更强的设备运行 Home Assistant
- 确保设备有足够的散热,避免因过热导致的性能降低
## 技术架构
本加载项基于以下技术构建:
- **容器技术**Docker + S6 Overlay进程管理
- **前端**Vue.js + Ant DesignWeb 管理界面)
- **后端**Java Spring BootRESTful API 和 WebSocket 服务)
- **语音处理**VOSK语音识别+ ONNX Runtime模型推理
- **数据存储**MySQL/MariaDB对话历史和配置
## 支持与贡献
如有问题或建议,请访问[项目 GitHub 页面](https://github.com/joey-zhou/xiaozhi-esp32-server-java)。
欢迎提交问题报告、功能请求或代码贡献。

View File

@@ -1,149 +0,0 @@
# 冬瓜甄选addons小智ESP32语音助手JAVA版
这是一个基于 ESP32 的语音交互助手系统,支持语音识别和播放功能,适用于智能家居控制。此插件将小智 ESP32 服务器整合为 Home Assistant 加载项,提供更简便的部署和管理方式。
## 功能特点
- **中文语音识别**:基于 VOSK 语音识别引擎,支持准确的中文语音识别
- **与 Home Assistant 集成**:完全集成到 Home Assistant 界面中,一键安装和配置
- **Web 管理界面**:提供直观的 Web 界面管理 ESP32 设备
- **内置中文语音模型**:预装中文语音识别模型,开箱即用
- **数据库自动化**:自动创建并初始化必要的数据库表结构
- **资源占用优化**:可自定义 Java 内存分配,适应不同性能的设备
## 安装方法
### 前置要求
- Home Assistant OS 或 Supervised 环境(最低版本 2023.3
- MariaDB 插件(或外部 MySQL/MariaDB 数据库)
- 网络连接(用于初始化)
### 安装步骤
1. 在 Home Assistant 中,进入**设置** -> **加载项** -> **加载项商店**
2. 点击右上角的菜单按钮,选择**存储库**
3. 添加此仓库地址: ``
4. 点击**添加**,然后关闭存储库对话框
5. 在加载项商店中找到**小智 ESP32 语音助手**并安装
## 配置选项
| 配置项 | 默认值 | 描述 |
| -------------- | ------------ | ---------------------------------------------- |
| mysql_host | core-mariadb | MySQL 数据库主机地址 |
| mysql_port | 3306 | MySQL 数据库端口 |
| mysql_database | xiaozhi | 数据库名称 |
| mysql_user | xiaozhi | 数据库用户名 |
| mysql_password | 123456 | 数据库密码 |
| java_memory | 512m | Java 应用内存分配,格式为 XmXg如 512m、1g 等 |
## 使用说明
### 首次启动
1. 安装并配置 MariaDB 加载项(如果使用外部数据库则跳过此步骤)
2. 在小智 ESP32 语音助手的配置页面,设置数据库连接信息
3. 如需调整 Java 应用内存,可修改 java_memory 参数(默认 512m
4. 点击**保存**,然后启动加载项
### 访问 Web 界面
启动加载项后,有两种方式访问 Web 管理界面:
1. 通过 Home Assistant 边栏中的**小智 ESP32**图标直接访问
2. 或访问`http://你的HomeAssistant地址:8084`
### 设备连接
在 Web 管理界面中,您可以添加和管理 ESP32 设备:
1. 进入**设备管理**页面
2. 点击**添加设备**
3. 输入设备名称、IP 地址等信息
4. 在 ESP32 设备上设置 WebSocket 服务器地址为:`ws://你的HomeAssistant地址:8091/ws/xiaozhi/v1/`
## 数据库说明
首次启动时,插件会自动:
1. 连接到配置的 MySQL/MariaDB 数据库
2. 如果指定数据库不存在,则创建数据库
3. 执行必要的 SQL 脚本初始化表结构
如果您希望手动初始化数据库,可以:
1. 使用 MySQL 客户端连接到数据库服务器
2. 创建名为"xiaozhi"(或您指定的名称)的数据库
3. 导入`/app/db/`目录下的 SQL 文件
## 内存管理
通过配置项 `java_memory` 控制分配给 Java 应用的堆内存大小,格式示例:
- `512m`512 兆字节,适合大多数使用场景)
- `1g`1 吉字节,适合大量设备和频繁交互场景)
- `1.5g`或更高(适合高负载场景)
**内存管理建议**
- 默认内存分配512MB足够普通使用
- 对于多设备场景,建议分配 1GB 或更多内存
- 如遇内存不足问题,增加分配至 1GB 或更高
## 故障排查
如果遇到问题,请尝试以下方法:
1. **无法启动**
- 检查 MariaDB 服务是否正常运行
- 确认数据库连接信息正确
- 查看 Home Assistant 日志中是否有错误信息
2. **Web 界面无法访问**
- 确认端口 8084 和 8091 未被占用
- 检查 Home Assistant 的网络设置,确保这些端口可以访问
3. **语音模型问题**
- 检查 `/config/models/vosk-model` 目录是否存在模型文件
- 如果模型不存在,请手动下载并上传到该目录
- 确保存储空间足够(至少需要 100MB 空闲空间)
4. **内存不足**
- 增加 java_memory 参数,分配更多内存(如从 512m 改为 1g
- 关闭其他不必要的加载项释放资源
- 考虑使用性能更强的设备运行 Home Assistant
## 技术架构
本插件采用以下技术栈:
- **前端**Vue.js + Ant Design
- **后端**Java Spring Boot
- **语音识别**VOSK + ONNX Runtime
- **数据库**MySQL/MariaDB
- **容器化**Docker + S6 Overlay
## S6 初始化系统
插件使用 S6 Overlay 作为容器初始化系统,主要初始化流程:
1. **环境变量设置**:读取 Home Assistant 配置,设置数据库连接信息等
2. **数据库初始化**:等待 MySQL 可用,创建并初始化数据库
3. **模型检查**:检查语音模型是否存在并可用
4. **Java 应用启动**:启动 Spring Boot 应用
5. **Nginx 服务**:提供静态资源服务,反向代理 API 请求
## 版权和许可
本项目基于[xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java)开发,采用 MIT 许可证。
## 参考资源
- [小智 ESP32 服务器 Java 版](https://github.com/joey-zhou/xiaozhi-esp32-server-java)
- [VOSK 语音识别系统](https://alphacephei.com/vosk/)
- [Home Assistant 开发者文档](https://developers.home-assistant.io/)
- [S6 Overlay](https://github.com/just-containers/s6-overlay)

View File

@@ -1,36 +0,0 @@
name: "小智ESP32语音助手JAVA版"
version: "2.7.42"
slug: "xiaozhi_esp32_server_java"
description: "基于ESP32的语音交互助手支持语音识别和播放功能"
url: "https://gitcode.com/waxgourd/addons"
arch:
- aarch64
- amd64
startup: application
boot: manual
init: false
host_network: false
map:
- config:rw
options:
mysql_host: "core-mariadb"
mysql_port: 3306
mysql_database: "xiaozhi"
mysql_user: "homeassistant"
mysql_password: "homeassistant"
java_memory: "512m"
schema:
mysql_host: str
mysql_port: port
mysql_database: str
mysql_user: str
mysql_password: password
java_memory: str
ports:
8091/tcp: 8091
8084/tcp: 8084
ports_description:
8091/tcp: "API/WS服务端口"
8084/tcp: "Web管理界面"
webui: "http://[HOST]:[PORT:8084]"
image: r.hassbus.com/wghaos/xiaozhi-esp32-server-java-{arch}

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 35 KiB

View File

@@ -1,30 +0,0 @@
configuration:
mysql_host:
name: MySQL Host
description: MySQL database host address
mysql_port:
name: MySQL Port
description: MySQL database port
mysql_database:
name: Database Name
description: Database name, default is xiaozhi
mysql_user:
name: Database Username
description: Username for database connection
mysql_password:
name: Database Password
description: Password for database connection
java_memory:
name: Java Memory Size
description: Memory allocation for Java application in format like XmXg, e.g. 512m, 1g
addon:
start: Starting Xiaozhi ESP32 Voice Assistant...
stop: Stopping Xiaozhi ESP32 Voice Assistant...
configure: After configuration, click Save and restart the add-on to apply changes
logs:
starting: Starting service...
started: Service started
stopping: Stopping service...
stopped: Service stopped
error: Service failed to start, please check logs

View File

@@ -1,30 +0,0 @@
configuration:
mysql_host:
name: MySQL主机
description: MySQL数据库主机地址
mysql_port:
name: MySQL端口
description: MySQL数据库端口
mysql_database:
name: 数据库名称
description: 数据库名称默认为xiaozhi
mysql_user:
name: 数据库用户名
description: 用于连接数据库的用户名
mysql_password:
name: 数据库密码
description: 用于连接数据库的密码
java_memory:
name: Java内存大小
description: 分配给Java应用的内存大小格式为 XmXg 等例如512m, 1g
addon:
start: 正在启动小智ESP32语音助手...
stop: 正在停止小智ESP32语音助手...
configure: 完成配置后,点击保存并重启加载项使配置生效
logs:
starting: 正在启动服务...
started: 服务已启动
stopping: 正在停止服务...
stopped: 服务已停止
error: 服务启动失败,请检查日志

View File

@@ -1,46 +0,0 @@
## 0.8.5 (2025-10-23)
- 版本升级
## 0.8.2 (2025-09-23)
- 版本升级
## 0.8.1 (2025-09-18)
- 版本升级
## 0.7.6 (2025-09-10)
- 版本升级
## 0.7.4 (2025-08-11)
- 版本升级
## 0.7.2 (2025-07-31)
- 版本升级
## 0.6.3 (2025-07-11)
- 版本升级
## 0.5.7 (2025-06-18)
- 版本升级
## 0.5.5 (2025-06-09)
- 版本升级
## 0.5.4 (2025-06-05)
- 版本升级
## 0.5.3 (2025-06-03)
- 增加视觉大模型供应器和配置
- 支持openai类型接口的视觉模型调用(默认是智谱免费版视觉模型)
- 兼容虾哥1.6.6版本调用mcp拍照识图功能
- 小智容器端口8003主机端口8002无需更改网络配置
## 0.5.1 (2025-05-29)
- 版本升级
## 0.4.4 (2025-05-23)
- 版本升级
## 0.4.3 (2025-05-16)
- 版本升级
## 0.4.2 (2025-05-13)
- 版本升级
## 0.4.1 (2025-05-08)
- 版本升级
## 0.3.13 (2025-05-07)
- 版本升级
## 0.3.12 (2025-04-28)
- 增加支持 OTA 接口
- 支持下发 WebSocket 接口地址
## 0.3.11 (2025-04-27)
- 版本升级
## 0.3.4 (2025-04-25)
- 首次推出

View File

@@ -1,52 +0,0 @@
# 小智 AI Server 极速版
本加载项提供虾哥小智AI音箱的HA本地服务器功能让大家简单玩转AI语音设备控制。
## 安装
1. 安装"小智 AI Server 极速版"加载项
3. 配置加载项
## 使用说明(快速入门)
使用之前先做如下的准备:
1. 更换成小智AI音箱HA专用固件
1烧录专用固件固件烧录地址https://xzfw.wghaos.com/
2配置网络
2. 火山引擎
1注册并认证火山引擎https://www.volcengine.com/
2LLM大语言模型服务模型名称及API密钥的获取
- 打开以下网址开通的服务搜索Doubao-pro-32k开通它
开通改地址https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false
- 免费额度500000token
- 开通后进入这里获取密钥https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D
3TTS文本转语音和语音识别模型ASR的语音识别APPID和语音合成令牌的获取
TTS和ASR可以使用同一个。
- 在后面链接申请相关Key等信息https://console.volcengine.com/speech/app
- 填写相应的appid和access_token
- 语音合成音色,可以填"BV001_streaming"
3. 填写homeassistant令牌
点击左下角的用户头像,选择**安全**,向下滚动到长期访问令牌部分,点击创建令牌,生成后复制并保存(关闭后无法再次查看)
4. 启动体验
### 支持
详细错做说明请查看www.wghaos.com或者https://bbs.hassbian.com查看

View File

@@ -1,23 +0,0 @@
# 冬瓜甄选addons小智 AI Server 极速版
小智 AI Server是home assistant中专用的小智AI服务器免搭建让小智快速在HA中使用。
## 关于
此系列共有三个版本旨在满足不同需求的用户快速玩转小智AI
- 小智 AI Server 极速版在addons配置进行优化介绍以豆包平台为主可以在10分钟内建好小智AI控制。
- 小智 AI Server 简化版:原汁原味官方简化版,可方便对照网上教程调整配置。
- 小智 AI OTA管理: 官方的全模块版主要是OTA管理可研究通讯方式等。
另提供小智AI的固件在线刷机支持免激活版。
链接https://xzfw.wghaos.com
## 支持与反馈
本项目基于[xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 开发。

View File

@@ -1,73 +0,0 @@
name: "小智 AI Server 极速版"
version: "0.8.5"
slug: "xiaozhi_esp32_server_mini"
description: "小智 AI Server 极速版 - 提供语音识别、对话和控制功能支持与ESP32设备通信"
url: "https://gitcode.com/waxgourd/addons"
arch:
- aarch64
- amd64
startup: application
boot: manual
translations: true
ports:
8000/tcp: 8000
8003/tcp: 8002
ports_description:
8000/tcp: "WebSocket服务端口"
8003/tcp: "http服务的端口用于简单OTA接口(单服务部署),以及视觉分析接口"
map:
- addon_config:rw
host_network: false
init: false
watchdog: "tcp://[HOST]:[PORT:8000]"
# webui: "http://[HOST]:[PORT:8002]"
journald: true
hassio_api: true
options:
plugins.home_assistant.base_url: http://homeassistant.local:8123
plugins.home_assistant.api_key: ""
plugins.home_assistant.devices: []
llm.type: DoubaoLLM
model_name: "doubao-1-5-pro-32k-250115"
llm.api_key: ""
tts.type: DoubaoTTS
tts.appid: ""
tts.access_token: ""
tts.voice: ""
asr.type: DoubaoASR
asr.appid: ""
asr.access_token: ""
asr.secret_key: ""
vllm.type: ChatGLMVLLM
vllm.model_name: "glm-4v-flash"
vllm.api_key: ""
plugins.get_weather.api_key: a861d0d5e7bf4ee1a83d9a9e4f96d4da
plugins.get_weather.default_location: 广州
log_level: INFO
timezone: Asia/Shanghai
host_ip: "homeassistant.local"
schema:
plugins.home_assistant.base_url: url
plugins.home_assistant.api_key: str
plugins.home_assistant.devices:
- str
llm.type: list(DoubaoLLM|ChatGLMLLM|DeepSeekLLM)
model_name: str
llm.api_key: str
tts.type: list(DoubaoTTS|EdgeTTS)
tts.appid: str?
tts.access_token: str?
tts.voice: str?
asr.type: list(DoubaoASR|TencentASR|FunASR)
asr.appid: str?
asr.access_token: str?
asr.secret_key: str?
vllm.type: list(ChatGLMVLLM|QwenVLVLLM)
vllm.model_name: str?
vllm.api_key: str?
plugins.get_weather.api_key: str
plugins.get_weather.default_location: str
log_level: list(INFO|DEBUG)
timezone: str
host_ip: str?
image: r.hassbus.com/wghaos/xiaozhi-esp32-server-mini-{arch}

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 33 KiB

View File

@@ -1,62 +0,0 @@
---
configuration:
timezone:
name: "Timezone"
description: "Set the server timezone"
host_ip:
name: "Host IP Address"
description: "IP address for WebSocket connection, leave empty to auto-detect LAN IP"
log_level:
name: "Log Level"
description: "Set the verbosity of logs"
llm.type:
name: "LLM Type"
description: "Choose which Large Language Model service to use"
model_name:
name: "LLM Model Name"
description: "Specific model name for the LLM"
llm.api_key:
name: "LLM API Key"
description: "API key for the selected Large Language Model service"
tts.type:
name: "TTS Type"
description: "Choose which Text-to-Speech service to use"
tts.appid:
name: "TTS AppID"
description: "Application ID for text-to-speech service (required for DoubaoTTS only)"
tts.access_token:
name: "TTS Access Token"
description: "Access token for text-to-speech service (required for DoubaoTTS only)"
tts.voice:
name: "TTS Voice"
description: "Voice setting for text-to-speech service (optional, defaults to BV001_streaming)"
asr.type:
name: "Speech Recognition Model"
description: "Choose which speech recognition model to use, different models support different languages"
asr.appid:
name: "Speech Recognition AppID"
description: "Application ID for speech recognition service (required for online services only)"
asr.access_token:
name: "Speech Recognition Token/Secret ID"
description: "Access token or secret ID for speech recognition service (required for online services only)"
asr.secret_key:
name: "Speech Recognition Secret Key"
description: "Secret key for speech recognition service (required for Tencent ASR only)"
plugins.get_weather.api_key:
name: "Weather API Key"
description: "QWeather API key"
plugins.get_weather.default_location:
name: "Default Location"
description: "Default location for weather queries"
plugins.home_assistant.base_url:
name: "Home Assistant URL"
description: "URL of your Home Assistant instance"
plugins.home_assistant.api_key:
name: "Home Assistant Token"
description: "Long-lived access token for Home Assistant"
plugins.home_assistant.devices:
name: "Home Assistant Devices"
description: "List of Home Assistant devices to control"
network:
8000/tcp: "WebSocket server port for ESP32 device communication"

View File

@@ -1,62 +0,0 @@
---
configuration:
timezone:
name: "时区"
description: "设置服务器时区"
host_ip:
name: "主机IP地址"
description: "用于WebSocket连接的IP地址留空将自动获取内网IP"
log_level:
name: "日志级别"
description: "设置日志详细程度"
llm.type:
name: "大语言模型LLM"
description: "选择使用哪个大语言模型LLM DoubaoLLM豆包大语言模型 ChatGLMLLM智谱 AI 大语言模型, DeepSeekLLMDeepSeek 大语言模型"
model_name:
name: "LLM模型名称"
description: "大语言模型的具体模型名称"
llm.api_key:
name: "LLM API密钥"
description: "所选大语言模型服务的API密钥"
tts.type:
name: "文本转语音TTS"
description: "选择使用哪个文本转语音服务TTSDoubaoTTS豆包/火山引擎 文本转语音EdgeTTS微软 Edge 浏览器 文本转语音"
tts.appid:
name: "语音合成AppID"
description: "语音合成服务的应用ID仅DoubaoTTS需要"
tts.access_token:
name: "语音合成访问令牌"
description: "语音合成服务的访问令牌仅DoubaoTTS需要"
tts.voice:
name: "语音合成音色"
description: "语音合成服务的音色设置可选默认为BV001_streaming"
asr.type:
name: "语音识别模型ASR"
description: "选择使用哪种语音识别模型不同模型支持不同语言DoubaoASR豆包语音识别TencentASR腾讯云语音识别FunASRFun语音识别"
asr.appid:
name: "语音识别AppID"
description: "语音识别服务的应用ID仅在线服务需要"
asr.access_token:
name: "语音识别Token/Secret ID"
description: "语音识别服务的访问令牌或密钥ID仅在线服务需要"
asr.secret_key:
name: "语音识别Secret Key"
description: "语音识别服务的密钥仅腾讯ASR需要"
plugins.get_weather.api_key:
name: "天气API密钥"
description: "和风天气API密钥"
plugins.get_weather.default_location:
name: "默认位置"
description: "天气查询的默认位置"
plugins.home_assistant.base_url:
name: "Home Assistant地址"
description: "您的Home Assistant实例地址"
plugins.home_assistant.api_key:
name: "Home Assistant令牌"
description: "Home Assistant的长期访问令牌"
plugins.home_assistant.devices:
name: "Home Assistant设备"
description: "要控制的Home Assistant设备列表"
network:
8000/tcp: "ESP32设备通信的WebSocket服务器端口"

View File

@@ -1,46 +0,0 @@
## 0.8.5 (2025-10-22)
- 版本升级
## 0.8.2 (2025-09-23)
- 版本升级
## 0.8.1 (2025-09-18)
- 版本升级
## 0.7.6 (2025-09-10)
- 版本升级
## 0.7.4 (2025-08-11)
- 版本升级
## 0.7.2 (2025-07-24)
- 版本升级
## 0.6.3 (2025-07-11)
- 版本升级
## 0.6.2 (2025-07-03)
- 版本升级
## 0.5.7 (2025-06-19)
- 版本升级
## 0.5.5 (2025-06-09)
- 版本升级
## 0.5.4 (2025-06-06)
- 版本升级
## 0.5.3 (2025-06-03)
- 版本升级
## 0.5.1 (2025-05-29)
- 版本升级
## 0.4.4 (2025-05-23)
- 版本升级
## 0.4.3-1 (2025-05-20)
- 版本升级
## 0.4.3 (2025-05-16)
- 版本升级
## 0.4.2 (2025-05-13)
- 版本升级
## 0.4.1 (2025-05-08)
- 版本升级
## 0.3.13 (2025-05-07)
- 版本升级
## 0.3.12 (2025-04-28)
- 版本升级
## 0.3.11 (2025-04-27)
- 版本升级
## 0.3.4-20 (2025-04-25)
- 版本升级
## 0.3.4 (2025-04-25)
- 首次推出

View File

@@ -1,206 +0,0 @@
# 小智 AI Server 最简化版
本加载项提供小智 ESP32 语音识别服务器功能,可与 ESP32 设备配合使用实现语音识别功能。
## 安装
1. 更换成小智AI音箱HA专用固件烧录地址https://xzfw.wghaos.com/ 并配置网络
1. 在 Home Assistant 的加载项商店中添加此仓库地址或复制到本地加载项目录
1. 安装"小智 AI Server 最简化版"加载项
1. 配置加载项
## 配置参数
| 参数 | 描述 |
| ------------------------------------ | --------------------------------- |
| timezone | 时区设置 |
| server.auth.enabled | 是否启用设备认证(可选) |
| server.auth.tokens | 设备认证令牌列表(可选) |
| log_level | 日志级别 (INFO/DEBUG) |
| llm.type | 大语言模型类型 |
| model_name | 大语言模型名称 |
| llm.api_key | 大语言模型 API 密钥 |
| tts.type | 语音合成服务类型 |
| tts.appid | TTS 服务应用 ID (DoubaoTTS 需要) |
| tts.access_token | TTS 服务访问令牌 (DoubaoTTS 需要) |
| tts.voice | TTS 音色 (DoubaoTTS 可选) |
| asr.type | 语音识别服务类型 |
| asr.appid | ASR 服务应用 ID在线服务需要 |
| asr.access_token | ASR 服务访问令牌(在线服务需要) |
| asr.secret_key | ASR 服务密钥(腾讯 ASR 需要) |
| plugins.get_weather.api_key | 和风天气 API 密钥 |
| plugins.get_weather.default_location | 默认天气查询位置 |
| plugins.home_assistant.base_url | Home Assistant 地址 |
| plugins.home_assistant.api_key | Home Assistant 长期访问令牌 |
| plugins.home_assistant.devices | Home Assistant 设备列表 |
## 使用说明
安装并启动后,服务器会在 8000 端口启动 WebSocket 服务。您可以通过 ESP32 设备连接到此服务进行语音识别。
### 配置方式说明
本加载项支持两种配置方式:
1. **通过 Home Assistant 加载项页面配置**:在 Home Assistant -> 设置 -> 加载项 -> 小智 AI Server 最简化版 中配置基本参数
- 这些配置会自动应用到服务器的.config.yaml 文件中
- 每次重启加载项时Home Assistant 配置会自动覆盖相应的.config.yaml 设置
2. **手动编辑配置文件**
- 配置文件位于: `/config/data/.config.yaml`(通过文件编辑器访问)
- 适合进行高级配置调整,如不在加载项页面提供的参数
**注意**:所有需要的 ASR 和 LLM 参数都应当在 Home Assistant 加载项配置页面中设置,这是推荐的配置方法。修改后需要重启加载项才能生效。
### 具体配置路径
1. **加载项配置页面**:
- Home Assistant → 设置 → 加载项 → 小智 AI Server 极速版 → 配置
- 在此页面可以设置所有主要参数,包括 ASR 类型、appid、access_token、LLM 类型、model_name 和 api_key 等
2. **通过文件编辑器**:
- Home Assistant → 设置 → 加载项 → 文件编辑器
- 导航到 `/config/data/.config.yaml` (加载项配置文件)
- 此文件包含更详细的配置,但每次重启加载项后会被加载项配置页面的设置覆盖
### 模型文件
使用 FunASR 模型时,需要使用 SenseVoiceSmall 模型文件才能正常工作。系统会自动下载模型文件并放置在以下位置:
```
/config/models/SenseVoiceSmall/model.pt
```
如果自动下载失败,您需要手动下载并放置模型文件。
### 语音识别服务 (ASR)
本插件支持以下语音识别服务:
1. **FunASR**:本地语音识别模型,需要下载模型文件。无需配置 API 密钥。
2. **DoubaoASR**:豆包 ASR 服务,需要配置 appid 和 access_token。
3. **TencentASR**:腾讯云 ASR 服务,需要配置 appid、access_token 和 secret_key。
**注意**:如果您选择 DoubaoASR 或 TencentASR但未提供完整的配置信息系统将无法启动相应服务。请确保提供所有必要的参数。
### 大语言模型服务 (LLM)
本插件支持以下大语言模型服务:
1. **DoubaoLLM**:豆包大语言模型服务
2. **ChatGLMLLM**:智谱 AI 大语言模型服务
3. **DeepSeekLLM**DeepSeek 大语言模型服务
每种 LLM 服务都需要配置相应的 model_name 和 api_key。
### 如何获取各服务的配置信息
#### DoubaoASR (豆包语音识别)
- **获取地址**: [火山引擎语音服务](https://console.volcengine.com/speech/app)
- **appid**: 申请开通火山引擎语音合成服务后获取的 appid
- **access_token**: 开通后获取的访问令牌
#### TencentASR (腾讯云语音识别)
- **密钥申请**: [获取密钥](https://console.cloud.tencent.com/cam/capi)
- **免费资源**: [领取免费资源](https://console.cloud.tencent.com/asr/resourcebundle)
- **appid**: 腾讯云语音识别服务应用 ID
- **secret_id**: 获取的腾讯云语音识别 SecretID
- **secret_key**: 获取的腾讯云语音识别 SecretKey
#### DoubaoLLM (豆包大语言模型)
- **开通地址**: [开通服务](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
- **获取密钥**: 开通后,进入[这里](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D)获取
- **适用模型**: 推荐模型名 `doubao-pro-32k-functioncall-241028`
- **免费额度**: 开通后提供 500000 token 的免费额度
#### ChatGLMLLM (智谱 AI 大语言模型)
- **获取密钥**: [智谱 AI 平台](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
- **推荐模型**: `glm-4-flash` (免费模型,但需要注册并填写 API 密钥)
- **API 访问**: 模型通过 `https://open.bigmodel.cn/api/paas/v4/` 接口访问
#### DeepSeekLLM (DeepSeek 大语言模型)
- **获取密钥**: [DeepSeek 平台](https://platform.deepseek.com/)
- **模型名称**: 如 `deepseek-chat`
- **访问地址**: https://api.deepseek.com
### 语音合成服务 (TTS)
本插件支持多种语音合成服务:
#### EdgeTTS (微软 Edge 浏览器 TTS)
- **无需 API 密钥**: 免费使用的本地 TTS 服务
- **默认语音**: `zh-CN-XiaoxiaoNeural`,中文女声
#### DoubaoTTS (豆包/火山引擎 TTS)
- **配置参数**: 需要设置`tts.appid``tts.access_token``tts.voice`(可选)
- **获取地址**: [火山引擎语音合成](https://console.volcengine.com/speech/service/8)
- **购买建议**: 建议购买付费服务,起步价 30 元可获得 100 并发,免费版本只有 2 个并发
- **特色音色**: 湾湾小何音色可在[此处开通](https://console.volcengine.com/speech/service/10007)
- **音色设置**: 默认使用`BV001_streaming`,湾湾小何音色设置为`zh_female_wanwanxiaohe_moon_bigtts`
- **开通说明**: 购买服务后,可能需要等待约半小时才能使用
- **验证要求**: 系统会在启动时验证 appid 和 access_token如果缺少将无法启动
### FunASR 才会使用下面模型文件
您可以通过以下方式下载模型文件(正常情况下会自动下载):
1. 线路一:[阿里魔塔下载 SenseVoiceSmall](https://www.modelscope.cn/models/iic/SenseVoiceSmall/summary)
2. 线路二:[百度网盘下载 SenseVoiceSmall](https://pan.baidu.com/s/1HW_UmfLiXhWwMjzS0GIpWg?pwd=qvna) 提取码:`qvna`
下载后,请将模型文件放置在上述路径中,或通过文件编辑器上传到 addon 配置目录的 models/SenseVoiceSmall 文件夹中。
### 配置文件
配置文件位于加载项配置目录:
```
/config/data/.config.yaml
```
如果未找到配置文件,系统会自动创建默认配置文件。首次运行时,会提示您修改配置文件中的 API 密钥等重要信息。
### 初次运行
首次启动插件时,会出现以下流程:
1. 检查模型文件,不存在则自动下载
2. 检查配置文件,不存在则自动创建
3. 提示您修改配置文件中的 API 密钥和其他设置
4. 配置好后需重启插件应用更改
这些提示只会在首次运行时显示,后续启动不会重复提示。
## 技术实现
本插件基于以下技术实现:
1. 使用 Home Assistant 标准加载项结构
2. 采用 S6-Overlay 进行服务管理,提高稳定性和可靠性
3. 使用 addon_config 目录存储配置和模型文件,符合 Home Assistant 最佳实践
4. 自动同步 Home Assistant 加载项配置到服务器配置
## 连接 ESP32 设备
1. 确保 ESP32 设备与 Home Assistant 在同一网络
2. WebSocket 服务地址:`ws://<您的Home Assistant IP>:8000/xiaozhi/v1/`
3. 将 ESP32 设备配置为连接上述 WebSocket 地址
## 故障排除
如果遇到以下问题,请参考处理方法:
1. **语音识别出现韩文、日文、英文**:检查模型文件是否正确加载
2. **TTS 任务出错或超时**:检查网络连接和配置文件设置
3. **连接问题**:确保 ESP32 设备与 Home Assistant 在同一网络
4. **无法自动下载模型**:网络问题或服务器故障,请尝试手动下载
5. **配置问题**:如果在加载项页面修改的配置未生效,请重启加载项并检查日志
6. **ASR 配置不完整错误**:确保您选择的 ASR 服务(如 DoubaoASR 或 TencentASR已配置所有必要的参数
7. **TTS 配置不完整错误**:当选择 DoubaoTTS 时,确保已配置 appid 和 access_token

View File

@@ -1,24 +0,0 @@
# 冬瓜甄选addons小智 AI Server 最简化版
适用于 Home Assistant 的小智 AI Server 最简化版加载项。
## 功能特点
- 基于 WebSocket 的语音识别服务
- 支持多种语音识别服务FunASR 本地模型、豆包 ASR 在线服务、腾讯 ASR 在线服务)
- 支持大语言模型对话功能
- 自动下载模型和配置
- 支持常见架构aarch64 和 amd64
- 使用 S6-Overlay 管理服务
## 使用方法
1. 安装加载项
2. 配置语音识别服务 (ASR) 和大语言模型 (LLM) 参数
3. 点击启动,并查看日志,等待小智客户端接入
详细使用说明请参阅 DOCS.md 文档。
## 支持与反馈
本项目基于[xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 开发。

View File

@@ -1,23 +0,0 @@
name: "小智 AI Server 最简化版"
version: "0.8.5"
slug: "xiaozhi_esp32_server"
description: "小智 AI Server 最简化版 - 提供语音识别、对话和控制功能支持与ESP32设备通信"
url: "https://gitcode.com/waxgourd/addons"
arch:
- aarch64
- amd64
startup: application
boot: manual
ports:
8000/tcp: 8000
8003/tcp: 8003
ports_description:
8000/tcp: "WebSocket服务端口"
8003/tcp: "http服务的端口用于简单OTA接口(单服务部署),以及视觉分析接口"
map:
- addon_config:rw
host_network: false
init: false
watchdog: "tcp://[HOST]:[PORT:8000]"
journald: true
image: r.hassbus.com/wghaos/xiaozhi-esp32-server-{arch}

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

View File

@@ -1,40 +0,0 @@
## 0.8.5 (2025-10-21)
- 版本升级
## 0.8.2 (2025-09-23)
- 版本升级
## 0.7.6 (2025-09-10)
- 版本升级
## 0.7.4 (2025-08-15)
- 版本升级
## 0.7.2 (2025-07-24)
- 版本升级
## 0.6.3 (2025-07-11)
- 版本升级
## 0.6.2 (2025-07-03)
- 版本升级
## 0.5.7 (2025-06-18)
- 版本升级
## 0.5.5 (2025-06-09)
- 版本升级
## 0.5.4 (2025-06-05)
- 版本升级
## 0.5.3 (2025-06-03)
- 版本升级
## 0.5.1 (2025-05-29)
- 版本升级
## 0.4.4 (2025-05-23)
- 版本升级
## 0.4.3 (2025-05-16)
- 版本升级
## 0.4.2 (2025-05-13)
- 版本升级
## 0.4.1 (2025-05-08)
- 版本升级
## 0.3.13 (2025-05-07)
- 版本升级
## 0.3.12 (2025-04-28)
- 版本升级
## 0.3.11 (2025-04-27)
- 版本升级
## 0.3.4 (2025-04-25)
- 首次推出

View File

@@ -1,108 +0,0 @@
# 小智 AI 智控台
本加载项提供小智 ESP32 是智控台的docker服务需配合其它addons一起使用快速体验本地化小智后端服务全功能版的乐趣。
## 安装方法与次序
1. 在加载项仓库中另外安装配套的addons
mariadb在core仓库中HA官方自带
redis server在冬瓜甄选仓库中
小智AI server最简安装版在冬瓜甄选仓库中
1. "Redis Server" 直接启动
无需任何操作
1. 配置"MariaDB" 并启动
1在“Databases”里增加下面内容然后回车
```
xiaozhi_esp32_server
```
2在“Logins”修改数据库密码为root省事可用下面一行直接替换第一行
```
- password: root
```
3在“Rights”最后增加以下内容
```
- database: xiaozhi_esp32_server
username: homeassistant
```
4保存后启动
1. "小智 AI 智控台" 本addons直接启动
因为本文档开始直接默认设置了mariadb的密码为root。redis的服务器直接设置为“冬瓜甄选仓库”中的redis服务器名。所以直接启动就行。
1自己注册一个管理员并登录
2进入后点击上方的“参数管理”复制第一行开头为“server.secret”里的“参数值”里的字符串
3模型配置——配置大语音模型建议豆包
4模型配置——配置语音合成建议豆包
5模型配置——配置语音识别建议豆包
6模型配置——配置意图识别需要控制HA的话选最后一项“Intent_function_call”设置为"默认"
- 然后点击“修改”,在“函数列表”的最后面,加上以下的字符后,保存。
```
;hass_get_state;hass_set_state
```
1. 配置 "小智 AI Server最简安装版"
1先启动一次等默认配置生成然后停止。
2使用filebrowser等方式修改“小智AI Server最简安装版”的在“addon_configs”目录——“7eca76cc_xiaozhi_esp32_server”目录——“data”目录——编辑“.config.yaml”文件
- 把http://127.0.0.1:8002/xiaozhi那一行替换成
```
url: http://homeassistant.local:8002/xiaozhi
```
- 把刚才复制的“server.secret”放到最后一行替换掉注意空格要留好。
3启动“小智 AI Server最简安装版”服务。
1. 配置"小智 AI 智控台"接口等
上续操作等,己经能正常启动了。但是智控台中“参数管理”中
- server.websocket
```
ws://homeassistant.local:8000/xiaozhi/v1/
```
关键己说明,可以直接开始使用,细节配置大家看一下官方的说明
## 备用的技术参考配置(可忽略)
```yaml
mysql_host: core-mariadb #MySQL/MariaDB数据库主机地址,查看方式Home Assistant → 设置 → 加载项 → MySQL/MariaDB → 信息 → 宿主名
mysql_port: 3306 #MySQL/MariaDB数据库端口默认: 3306
mysql_database: xiaozhi_esp32_server #要使用的数据库名称
mysql_username: homeassistant #数据库认证用户名
mysql_password: root #数据库认证密码
redis_host: 0920e2ff-redis-server #Redis服务器主机地址查看方式Home Assistant → 设置 → 加载项 → Redis Server → 信息 → 宿主名
redis_port: 6379 #Redis服务器端口默认: 6379
timezone: Asia/Shanghai #设置服务器时区
```
## 使用说明
1. 启动后,点击“打开网页界面”,浏览器访问 http://homeassistant.local:8002 进入 Web 管理界面
2. 首次访问需要注册用户

View File

@@ -1,14 +0,0 @@
# HaDB addons小智 AI 智控台
适用于 Home Assistant 的 小智 AI 智控台的加载项。它是不能单独使用的需要配合mariadbredis server和“小智AI Server最简版”同时使用。
## 相关说明
1. 小智后端服务xiaozhi-esp32-server布署有两种方式。都是采用的docker compose的安装方式其中有一个全模块安装法。
2. 此次换种方式没有全套打包而是充分体现小型云主机特点不同的docker形成不同的addons相互配合使用。
详细使用说明请原项目的帮助文档和网上的一些经验。
## 支持与反馈
本项目基于[xinnan-tech/xiaozhi-esp32-server](https://github.com/xinnan-tech/xiaozhi-esp32-server) 开发。

View File

@@ -1,39 +0,0 @@
name: "小智 AI 智控台"
version: "0.8.5"
slug: "xiaozhi_esp32_webui"
description: "小智 AI 智控台 - 提供语音识别、对话和控制功能支持与ESP32设备通信集成WEB管理界面"
url: "https://git.hadb.cn/ha/addons/src/master/xiaozhi-esp32-webui"
arch:
- aarch64
- amd64
startup: application
boot: manual
translations: true
ports:
8002/tcp: 8002
ports_description:
8002/tcp: "WEB服务端口"
host_network: false
init: false
webui: "http://[HOST]:[PORT:8002]/"
watchdog: "http://[HOST]:[PORT:8002]/"
journald: true
options:
mysql_host: core-mariadb
mysql_port: 3306
mysql_database: xiaozhi_esp32_server
mysql_username: homeassistant
mysql_password: root
redis_host: 7eca76cc-redis-server
redis_port: 6379
timezone: Asia/Shanghai
schema:
mysql_host: str
mysql_port: port
mysql_database: str
mysql_username: str
mysql_password: password
redis_host: str
redis_port: port
timezone: str
image: "r.hassbus.com/wghaos/xiaozhi-esp32-webui"

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 37 KiB

View File

@@ -1,29 +0,0 @@
---
configuration:
mysql_host:
name: "MySQL Host"
description: "MySQL/MariaDB database host address"
mysql_port:
name: "MySQL Port"
description: "MySQL/MariaDB database port (default: 3306)"
mysql_database:
name: "MySQL Database"
description: "Name of the database to use"
mysql_username:
name: "MySQL Username"
description: "Username for database authentication"
mysql_password:
name: "MySQL Password"
description: "Password for database authentication"
redis_host:
name: "Redis Host"
description: "Redis server host address"
redis_port:
name: "Redis Port"
description: "Redis server port (default: 6379)"
timezone:
name: "Timezone"
description: "Set the server timezone"
network:
8002/tcp: "Web management interface port"

View File

@@ -1,29 +0,0 @@
---
configuration:
mysql_host:
name: "MySQL主机"
description: "MySQL/MariaDB数据库主机地址"
mysql_port:
name: "MySQL端口"
description: "MySQL/MariaDB数据库端口默认: 3306"
mysql_database:
name: "MySQL数据库名"
description: "要使用的数据库名称"
mysql_username:
name: "MySQL用户名"
description: "数据库认证用户名"
mysql_password:
name: "MySQL密码"
description: "数据库认证密码"
redis_host:
name: "Redis主机"
description: "Redis服务器主机地址"
redis_port:
name: "Redis端口"
description: "Redis服务器端口默认: 6379"
timezone:
name: "时区"
description: "设置服务器时区"
network:
8002/tcp: "Web管理界面端口"

View File

@@ -1,3 +0,0 @@
### 1.02025-05-20
- 首次推出

View File

@@ -1,24 +0,0 @@
# 小智 Mcp Server
## 安装
1. 安装本addons
2. 安装Mcp Server 服务器插件
3. 登录小智平台获取Mcp接入点
## 使用说明:
### 参数说明
1. **小智 MCP 接入点:** 登录[小智官方]( https://xiaozhi.me/console/agents )服务器即可获取。
2. **HA MCP SERVER 地址:** 直接安装MCP Server集成。
* 点击此链接:[Home Assistant MCP Server 集成](https://my.home-assistant.io/redirect/config_flow_start?domain=mcp_server)直达安装
* 或 在 Home Assistant 中,前往 **设置 > 设备和服务 > 添加集成 > Model Context Protocol Server**
* 默认直接确认或从列表中选择“**模型上下文协议服务器**”,并按照屏幕上的说明完成设置。
3. **HA长效 API 令牌:** 用于授权访问你的 Home Assistant 实例。
* 访问你的 [Home Assistant 账户配置文件设置](https://my.home-assistant.io/redirect/profile),进入“**安全**”选项卡。
* 创建**长期访问令牌**。
4. **备注:** ha中的服务器地址为域写法可以不用更改。
——————————————————————————
作者原帖:[小智AI和Ha无缝对接官方 MCP 接入点的最佳实践](https://bbs.hassbian.com/thread-29314-1-1.html)

View File

@@ -1,14 +0,0 @@
# HaDB Addons: 小智 Mcp Server
## 关于
本addons由瀚思彼岸论坛shay的docker生成。小智官方服务器(虾哥)对接home assistant的mcp server
## 原理
利用ha的mcp server集成与小智官方平台的mcp接口进行对接快速实现AI语音设备控制
## 来源
Github: https://github.com/shawn996/mcp_ha_xiaozhi

View File

@@ -1,25 +0,0 @@
name: "小智 Mcp Server"
version: "1.0"
slug: "mcp_ha_xiaozhi"
description: "小智官方服务器(虾哥)对接home assistant的mcp server"
url: "https://git.hadb.cn/ha/addons/src/master/xiaozhi-mcp-server"
arch:
- aarch64
- amd64
startup: application
boot: manual
translations: true
init: false
environment:
XIAOZHI_MCP_ENDPOINT: "wss://api.xiaozhi.me/mcp/?token="
HA_MCP_ENDPOINT: "http://homeassistant:8123/mcp_server/sse"
API_ACCESS_TOKEN: ""
options:
XIAOZHI_MCP_ENDPOINT: "wss://api.xiaozhi.me/mcp/?token="
HA_MCP_ENDPOINT: "http://homeassistant:8123/mcp_server/sse"
API_ACCESS_TOKEN:
schema:
XIAOZHI_MCP_ENDPOINT: str
HA_MCP_ENDPOINT: str
API_ACCESS_TOKEN: str
image: "r.hassbus.com/wghaos/xiaozhi-mcp-server"

Binary file not shown.

Before

Width:  |  Height:  |  Size: 99 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 99 KiB

View File

@@ -1,10 +0,0 @@
configuration:
XIAOZHI_MCP_ENDPOINT:
name: XIAOZHI_MCP_ENDPOINT
description: Your XiaoZhi MCP access point
HA_MCP_ENDPOINT:
name: HA_MCP_ENDPOINT
description: Your HA MCP server address
API_ACCESS_TOKEN:
name: API_ACCESS_TOKEN
description: Your HA MCP server address

View File

@@ -1,10 +0,0 @@
configuration:
XIAOZHI_MCP_ENDPOINT:
name: XIAOZHI_MCP_ENDPOINT
description: 你的小智 MCP 接入点
HA_MCP_ENDPOINT:
name: HA_MCP_ENDPOINT
description: 你的 HA MCP SERVER 地址
API_ACCESS_TOKEN:
name: API_ACCESS_TOKEN
description: 你的长效 API 令牌