diff --git a/matter_server/README.md b/matter_server/README.md index ae38fc9..98256e3 100644 --- a/matter_server/README.md +++ b/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与此服务器进行通信。 diff --git a/xiaozhi-esp32-server-java/CHANGELOG.md b/xiaozhi-esp32-server-java/CHANGELOG.md deleted file mode 100644 index a56fb95..0000000 --- a/xiaozhi-esp32-server-java/CHANGELOG.md +++ /dev/null @@ -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) -- 首次推出 \ No newline at end of file diff --git a/xiaozhi-esp32-server-java/DOCS.md b/xiaozhi-esp32-server-java/DOCS.md deleted file mode 100644 index 892fcd1..0000000 --- a/xiaozhi-esp32-server-java/DOCS.md +++ /dev/null @@ -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)。 -欢迎提交问题报告、功能请求或代码贡献。 diff --git a/xiaozhi-esp32-server-java/README.md b/xiaozhi-esp32-server-java/README.md deleted file mode 100644 index 6c5ebfe..0000000 --- a/xiaozhi-esp32-server-java/README.md +++ /dev/null @@ -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) diff --git a/xiaozhi-esp32-server-java/config.yaml b/xiaozhi-esp32-server-java/config.yaml deleted file mode 100644 index 523dc37..0000000 --- a/xiaozhi-esp32-server-java/config.yaml +++ /dev/null @@ -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} diff --git a/xiaozhi-esp32-server-java/icon.png b/xiaozhi-esp32-server-java/icon.png deleted file mode 100644 index 5ab7a63..0000000 Binary files a/xiaozhi-esp32-server-java/icon.png and /dev/null differ diff --git a/xiaozhi-esp32-server-java/logo.png b/xiaozhi-esp32-server-java/logo.png deleted file mode 100644 index a093406..0000000 Binary files a/xiaozhi-esp32-server-java/logo.png and /dev/null differ diff --git a/xiaozhi-esp32-server-java/translations/en.yaml b/xiaozhi-esp32-server-java/translations/en.yaml deleted file mode 100644 index 3b46430..0000000 --- a/xiaozhi-esp32-server-java/translations/en.yaml +++ /dev/null @@ -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 diff --git a/xiaozhi-esp32-server-java/translations/zh-Hans.yaml b/xiaozhi-esp32-server-java/translations/zh-Hans.yaml deleted file mode 100644 index 7ad2428..0000000 --- a/xiaozhi-esp32-server-java/translations/zh-Hans.yaml +++ /dev/null @@ -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: 服务启动失败，请检查日志 diff --git a/xiaozhi-esp32-server-mini/CHANGELOG.md b/xiaozhi-esp32-server-mini/CHANGELOG.md deleted file mode 100644 index 1a54731..0000000 --- a/xiaozhi-esp32-server-mini/CHANGELOG.md +++ /dev/null @@ -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) -- 首次推出 \ No newline at end of file diff --git a/xiaozhi-esp32-server-mini/DOCS.md b/xiaozhi-esp32-server-mini/DOCS.md deleted file mode 100644 index 89ebed5..0000000 --- a/xiaozhi-esp32-server-mini/DOCS.md +++ /dev/null @@ -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查看 diff --git a/xiaozhi-esp32-server-mini/README.md b/xiaozhi-esp32-server-mini/README.md deleted file mode 100644 index 7d177ad..0000000 --- a/xiaozhi-esp32-server-mini/README.md +++ /dev/null @@ -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) 开发。 diff --git a/xiaozhi-esp32-server-mini/config.yaml b/xiaozhi-esp32-server-mini/config.yaml deleted file mode 100644 index f10ec4b..0000000 --- a/xiaozhi-esp32-server-mini/config.yaml +++ /dev/null @@ -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} diff --git a/xiaozhi-esp32-server-mini/icon.png b/xiaozhi-esp32-server-mini/icon.png deleted file mode 100644 index 0d8f03c..0000000 Binary files a/xiaozhi-esp32-server-mini/icon.png and /dev/null differ diff --git a/xiaozhi-esp32-server-mini/logo.png b/xiaozhi-esp32-server-mini/logo.png deleted file mode 100644 index 3f1b2de..0000000 Binary files a/xiaozhi-esp32-server-mini/logo.png and /dev/null differ diff --git a/xiaozhi-esp32-server-mini/translations/en.yaml b/xiaozhi-esp32-server-mini/translations/en.yaml deleted file mode 100644 index ff19024..0000000 --- a/xiaozhi-esp32-server-mini/translations/en.yaml +++ /dev/null @@ -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" diff --git a/xiaozhi-esp32-server-mini/translations/zh-Hans.yaml b/xiaozhi-esp32-server-mini/translations/zh-Hans.yaml deleted file mode 100644 index 4eca806..0000000 --- a/xiaozhi-esp32-server-mini/translations/zh-Hans.yaml +++ /dev/null @@ -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服务器端口" diff --git a/xiaozhi-esp32-server/CHANGELOG.md b/xiaozhi-esp32-server/CHANGELOG.md deleted file mode 100644 index 47ced92..0000000 --- a/xiaozhi-esp32-server/CHANGELOG.md +++ /dev/null @@ -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) -- 首次推出 \ No newline at end of file diff --git a/xiaozhi-esp32-server/DOCS.md b/xiaozhi-esp32-server/DOCS.md deleted file mode 100644 index 7485b76..0000000 --- a/xiaozhi-esp32-server/DOCS.md +++ /dev/null @@ -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 diff --git a/xiaozhi-esp32-server/README.md b/xiaozhi-esp32-server/README.md deleted file mode 100644 index e0894b7..0000000 --- a/xiaozhi-esp32-server/README.md +++ /dev/null @@ -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) 开发。 diff --git a/xiaozhi-esp32-server/config.yaml b/xiaozhi-esp32-server/config.yaml deleted file mode 100644 index 933c86d..0000000 --- a/xiaozhi-esp32-server/config.yaml +++ /dev/null @@ -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} diff --git a/xiaozhi-esp32-server/icon.png b/xiaozhi-esp32-server/icon.png deleted file mode 100644 index 3a9798f..0000000 Binary files a/xiaozhi-esp32-server/icon.png and /dev/null differ diff --git a/xiaozhi-esp32-server/logo.png b/xiaozhi-esp32-server/logo.png deleted file mode 100644 index a233d94..0000000 Binary files a/xiaozhi-esp32-server/logo.png and /dev/null differ diff --git a/xiaozhi-esp32-webui/CHANGELOG.md b/xiaozhi-esp32-webui/CHANGELOG.md deleted file mode 100644 index 9c05b12..0000000 --- a/xiaozhi-esp32-webui/CHANGELOG.md +++ /dev/null @@ -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) -- 首次推出 \ No newline at end of file diff --git a/xiaozhi-esp32-webui/DOCS.md b/xiaozhi-esp32-webui/DOCS.md deleted file mode 100644 index 524ab80..0000000 --- a/xiaozhi-esp32-webui/DOCS.md +++ /dev/null @@ -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. 首次访问需要注册用户 \ No newline at end of file diff --git a/xiaozhi-esp32-webui/README.md b/xiaozhi-esp32-webui/README.md deleted file mode 100644 index 72c1140..0000000 --- a/xiaozhi-esp32-webui/README.md +++ /dev/null @@ -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) 开发。 diff --git a/xiaozhi-esp32-webui/config.yaml b/xiaozhi-esp32-webui/config.yaml deleted file mode 100644 index 1d0a54f..0000000 --- a/xiaozhi-esp32-webui/config.yaml +++ /dev/null @@ -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" diff --git a/xiaozhi-esp32-webui/icon.png b/xiaozhi-esp32-webui/icon.png deleted file mode 100644 index 01869ac..0000000 Binary files a/xiaozhi-esp32-webui/icon.png and /dev/null differ diff --git a/xiaozhi-esp32-webui/logo.png b/xiaozhi-esp32-webui/logo.png deleted file mode 100644 index 550b470..0000000 Binary files a/xiaozhi-esp32-webui/logo.png and /dev/null differ diff --git a/xiaozhi-esp32-webui/translations/en.yaml b/xiaozhi-esp32-webui/translations/en.yaml deleted file mode 100644 index 82502c5..0000000 --- a/xiaozhi-esp32-webui/translations/en.yaml +++ /dev/null @@ -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" diff --git a/xiaozhi-esp32-webui/translations/zh-Hans.yaml b/xiaozhi-esp32-webui/translations/zh-Hans.yaml deleted file mode 100644 index 86aa1ef..0000000 --- a/xiaozhi-esp32-webui/translations/zh-Hans.yaml +++ /dev/null @@ -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管理界面端口" diff --git a/xiaozhi-mcp-server/CHANGELOG.md b/xiaozhi-mcp-server/CHANGELOG.md deleted file mode 100644 index 2163763..0000000 --- a/xiaozhi-mcp-server/CHANGELOG.md +++ /dev/null @@ -1,3 +0,0 @@ -### 1.0（2025-05-20） - -- 首次推出 \ No newline at end of file diff --git a/xiaozhi-mcp-server/DOCS.md b/xiaozhi-mcp-server/DOCS.md deleted file mode 100644 index 63436c6..0000000 --- a/xiaozhi-mcp-server/DOCS.md +++ /dev/null @@ -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) \ No newline at end of file diff --git a/xiaozhi-mcp-server/README.md b/xiaozhi-mcp-server/README.md deleted file mode 100644 index 2f15e2b..0000000 --- a/xiaozhi-mcp-server/README.md +++ /dev/null @@ -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 \ No newline at end of file diff --git a/xiaozhi-mcp-server/config.yaml b/xiaozhi-mcp-server/config.yaml deleted file mode 100644 index 813d819..0000000 --- a/xiaozhi-mcp-server/config.yaml +++ /dev/null @@ -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" diff --git a/xiaozhi-mcp-server/icon.png b/xiaozhi-mcp-server/icon.png deleted file mode 100644 index 4ffe02b..0000000 Binary files a/xiaozhi-mcp-server/icon.png and /dev/null differ diff --git a/xiaozhi-mcp-server/logo.png b/xiaozhi-mcp-server/logo.png deleted file mode 100644 index 4ffe02b..0000000 Binary files a/xiaozhi-mcp-server/logo.png and /dev/null differ diff --git a/xiaozhi-mcp-server/translations/en.yaml b/xiaozhi-mcp-server/translations/en.yaml deleted file mode 100644 index 559c97d..0000000 --- a/xiaozhi-mcp-server/translations/en.yaml +++ /dev/null @@ -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 diff --git a/xiaozhi-mcp-server/translations/zh-Hans.yaml b/xiaozhi-mcp-server/translations/zh-Hans.yaml deleted file mode 100644 index 7185f1b..0000000 --- a/xiaozhi-mcp-server/translations/zh-Hans.yaml +++ /dev/null @@ -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 令牌 \ No newline at end of file