更新 'matter_server/README.md'
@@ -1,9 +1,10 @@
|
||||
# HaDB addons:Matter Server(官方无法安装可以试试本版本)
|
||||
# HaDB addons:Matter Server
|
||||
|
||||
![Supports aarch64 Architecture][aarch64-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与此服务器进行通信。
|
||||
|
||||
|
||||
@@ -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)
|
||||
- 首次推出
|
||||
@@ -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 Design(Web 管理界面)
|
||||
- **后端**:Java Spring Boot(RESTful API 和 WebSocket 服务)
|
||||
- **语音处理**:VOSK(语音识别)+ ONNX Runtime(模型推理)
|
||||
- **数据存储**:MySQL/MariaDB(对话历史和配置)
|
||||
|
||||
## 支持与贡献
|
||||
|
||||
如有问题或建议,请访问[项目 GitHub 页面](https://github.com/joey-zhou/xiaozhi-esp32-server-java)。
|
||||
欢迎提交问题报告、功能请求或代码贡献。
|
||||
@@ -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)
|
||||
@@ -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}
|
||||
|
Before Width: | Height: | Size: 2.4 KiB |
|
Before Width: | Height: | Size: 35 KiB |
@@ -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
|
||||
@@ -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: 服务启动失败,请检查日志
|
||||
@@ -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)
|
||||
- 首次推出
|
||||
@@ -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/
|
||||
|
||||
(2)LLM(大语言模型服务)模型名称及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
|
||||
|
||||
(3)TTS(文本转语音)和语音识别模型(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查看
|
||||
@@ -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) 开发。
|
||||
@@ -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}
|
||||
|
Before Width: | Height: | Size: 2.5 KiB |
|
Before Width: | Height: | Size: 33 KiB |
@@ -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"
|
||||
@@ -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 大语言模型, DeepSeekLLM:DeepSeek 大语言模型"
|
||||
model_name:
|
||||
name: "LLM模型名称"
|
||||
description: "大语言模型的具体模型名称"
|
||||
llm.api_key:
|
||||
name: "LLM API密钥"
|
||||
description: "所选大语言模型服务的API密钥"
|
||||
tts.type:
|
||||
name: "文本转语音(TTS)"
|
||||
description: "选择使用哪个文本转语音服务(TTS),DoubaoTTS:豆包/火山引擎 文本转语音,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:腾讯云语音识别,FunASR:Fun语音识别"
|
||||
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服务器端口"
|
||||
@@ -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)
|
||||
- 首次推出
|
||||
@@ -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
|
||||
@@ -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) 开发。
|
||||
@@ -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}
|
||||
|
Before Width: | Height: | Size: 2.4 KiB |
|
Before Width: | Height: | Size: 20 KiB |
@@ -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)
|
||||
- 首次推出
|
||||
@@ -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. 首次访问需要注册用户
|
||||
@@ -1,14 +0,0 @@
|
||||
# HaDB addons:小智 AI 智控台
|
||||
|
||||
适用于 Home Assistant 的 小智 AI 智控台的加载项。它是不能单独使用的,需要配合mariadb,redis 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) 开发。
|
||||
@@ -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"
|
||||
|
Before Width: | Height: | Size: 2.9 KiB |
|
Before Width: | Height: | Size: 37 KiB |
@@ -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"
|
||||
@@ -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管理界面端口"
|
||||
@@ -1,3 +0,0 @@
|
||||
### 1.0(2025-05-20)
|
||||
|
||||
- 首次推出
|
||||
@@ -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)
|
||||
@@ -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
|
||||
@@ -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"
|
||||
|
Before Width: | Height: | Size: 99 KiB |
|
Before Width: | Height: | Size: 99 KiB |
@@ -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
|
||||
@@ -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 令牌
|
||||