diff --git a/dozzle/CHANGELOG.md b/dozzle/CHANGELOG.md index 1b32a4f..cd030ad 100644 --- a/dozzle/CHANGELOG.md +++ b/dozzle/CHANGELOG.md @@ -1,3 +1,8 @@ +### 8.12.12 (2025-04-27) +🐞 漏洞修补 +- 修复登录页面宽度 +- 在index.html中添加HTML内容类型 + ### 8.12.5 (2025-04-09) 🚀 特征 diff --git a/dozzle/config.yaml b/dozzle/config.yaml index 35902af..ab557c8 100644 --- a/dozzle/config.yaml +++ b/dozzle/config.yaml @@ -1,5 +1,5 @@ name: docker日志监控Dozzle -version: 8.12.5 +version: 8.12.12 slug: dozzle codenotary: wghaos@163.com description: 'Dozzle 是一个小型轻量级应用程序，具有基于 Web 的界面来监控 Docker 日志' diff --git a/dpanel/CHANGELOG.md b/dpanel/CHANGELOG.md index 93585c7..4b72862 100644 --- a/dpanel/CHANGELOG.md +++ b/dpanel/CHANGELOG.md @@ -1,3 +1,7 @@ +### 1.6.4 (2025-04-27) + +- 版本升级 + ### 1.6.3 (2025-04-09) - 版本升级 diff --git a/dpanel/config.yaml b/dpanel/config.yaml index d56e026..cfe8716 100644 --- a/dpanel/config.yaml +++ b/dpanel/config.yaml @@ -1,5 +1,5 @@ name: DPanel -version: "1.6.3" +version: "1.6.4" slug: dpanel description: Docker 可视化管理面板，提供完善的管理容器的功能 url: "https://github.com/donknap/dpanel" diff --git a/drawio/CHANGELOG.md b/drawio/CHANGELOG.md index 8831972..78ffe56 100644 --- a/drawio/CHANGELOG.md +++ b/drawio/CHANGELOG.md @@ -1,3 +1,7 @@ +### 26.2.15 (2025-04-27) + +- 版本升级 + ### 26.2.8 (2025-04-09) - 版本升级 diff --git a/drawio/config.yaml b/drawio/config.yaml index 5aa5829..56b433f 100644 --- a/drawio/config.yaml +++ b/drawio/config.yaml @@ -1,5 +1,5 @@ name: 'DrawIO' -version: '26.2.8' +version: '26.2.15' slug: 'drawio' codenotary: 'wghaos@163.com' description: "DrawIO是运行在浏览器中的在线绘图工具" diff --git a/emby/CHANGELOG.md b/emby/CHANGELOG.md index 6dbec15..ff9b5ed 100644 --- a/emby/CHANGELOG.md +++ b/emby/CHANGELOG.md @@ -1,3 +1,5 @@ +## 4.8.11.0 (23-04-2025) +- 从linuxserver/docker-emby更新到最新版本 (日志: https://github.com/linuxserver/docker-emby/releases) ## 4.9.0.48 (19-04-2025) - 从linuxserver/docker-emby更新到最新版本 (日志: https://github.com/linuxserver/docker-emby/releases) ## 4.9.0.43-3 (09-04-2025) diff --git a/emby/config.json b/emby/config.json index 17887bc..16de9d8 100644 --- a/emby/config.json +++ b/emby/config.json @@ -124,7 +124,7 @@ "slug": "emby_nas", "udev": true, "url": "https://gitcode.com/waxgourd/addons", - "version": "4.9.0.48", + "version": "4.8.11.0", "video": true, "boot": "manual" } diff --git a/portainer/CHANGELOG.md b/portainer/CHANGELOG.md index 2abbfb8..fda42fd 100644 --- a/portainer/CHANGELOG.md +++ b/portainer/CHANGELOG.md @@ -1,3 +1,15 @@ +### 2.29.2 (27-04-2025) + +- 已知问题 + - Podman支持的已知问题 + 1. Podman环境不受自动入职脚本的支持 + 1. 在Docker上运行Portainer服务器时，无法通过socket添加Podman环境（反之亦然） + 1. 仅支持CentOS 9，Podman 5 rootful +- 变化 +1. 撤销了github.com/gorilla/csrf库的版本升级 + + + ### 2.29.0 (19-04-2025) - 从portainer/portainer更新到最新版本 (更改日志：https://github.com/portainer/portainer/releases) ### 2.28.1 (22-03-2025) diff --git a/portainer/config.json b/portainer/config.json index 8e6d2af..0699cd9 100644 --- a/portainer/config.json +++ b/portainer/config.json @@ -47,5 +47,5 @@ "slug": "portainer", "udev": true, "url": "https://gitcode.com/waxgourd/addons", - "version": "2.29.0" + "version": "2.29.2" } diff --git a/redis-server/CHANGELOG.md b/redis-server/CHANGELOG.md new file mode 100644 index 0000000..1765902 --- /dev/null +++ b/redis-server/CHANGELOG.md @@ -0,0 +1,3 @@ +### 7.2.7（2025-04-24） + +- 首次推出 \ No newline at end of file diff --git a/redis-server/DOCS.md b/redis-server/DOCS.md index 64d8c2f..5d3af57 100644 --- a/redis-server/DOCS.md +++ b/redis-server/DOCS.md @@ -1,10 +1,26 @@ -# Redis 服务器 +# Redis Server Redis 是一个开源的内存数据库，可以用作缓存、消息代理和数据存储。此插件为您的 Home Assistant 安装 Redis 服务器。 +## 安装 + +1. 在 Home Assistant 中添加此存储库 URL 到您的插件商店 +2. 安装 Redis 服务器插件 +3. 启动 Redis 服务器插件 + ## 如何使用 -安装后，Redis 服务器将在默认端口（6379）上运行，并可以通过 Home Assistant 或网络中的其他设备访问。 +安装后，Redis 服务器将在默认端口（6379）上运行，并可以通过 Home Assistant 或者网络中的其他设备连接它： + +``` +redis-cli -h -p 6379 +``` + +如果您设置了密码，可以通过以下方式连接： + +``` +redis-cli -h -p 6379 -a +``` ### 配置 @@ -12,10 +28,10 @@ Redis 是一个开源的内存数据库，可以用作缓存、消息代理和 ```yaml # 示例配置 -port: 6379 -databases: 4 +port: 6379 #服务器监听端口（默认：6379） +databases: 4 #数据库数量（默认：4） password: mypassword # 强烈建议设置密码 -appendonly: true +appendonly: true #启用持久化存储（默认：开启） ``` #### 选项 `port` @@ -32,7 +48,7 @@ Redis 实例中的数据库数量。默认是 4。 #### 选项 `appendonly` -启用/禁用 AOF（Append Only File）持久化。此选项默认为启用，确保在重启后数据仍然可用。 +默认情况下，Redis 数据将保存在`/data`目录中。启用/禁用 AOF（Append Only File）持久化。此选项默认为启用，确保在重启后数据仍然可用。 ## 高级配置 @@ -68,7 +84,7 @@ loglevel notice 关于所有可用配置选项的详细说明，请参考[Redis 官方文档](https://redis.io/topics/config)。 -### 注意事项 +### 注意 - 如果您在配置文件中修改了基本设置（如端口号），请确保同时更新插件的配置选项，以保持一致性。 - 建议在修改配置文件前先创建备份。 @@ -83,6 +99,9 @@ Redis 服务器可以用于多种场景： 3. 临时数据存储 4. 跨设备/服务的共享状态存储 -## 支持 -如有问题或建议，请通过 GitHub 仓库提交问题。 +## 注意事项 + +- 默认情况下，Redis 仅监听本地网络。 +- 建议为您的 Redis 实例设置密码以增强安全性。 +- 如果您修改了配置文件中的基本设置（如端口），请确保同时更新插件的配置选项，以保持一致性。 diff --git a/redis-server/README.md b/redis-server/README.md index cece8f5..b663cf9 100644 --- a/redis-server/README.md +++ b/redis-server/README.md @@ -1,80 +1,9 @@ -# 冬瓜甄选addons：Home Assistant Redis 服务器插件 +# 冬瓜甄选addons：Redis Server +## 关于 这个插件为 Home Assistant 提供了一个 Redis 服务器。Redis 是一个开源的内存数据库，可以用作缓存、消息代理和数据存储。 -## 安装 +## 来源 +Github：https://github.com/redis/redis -1. 在 Home Assistant 中添加此存储库 URL 到您的插件商店 -2. 安装 Redis 服务器插件 -3. 启动 Redis 服务器插件 -## 配置选项 - -| 选项 | 描述 | -| ---------- | ------------------------------ | -| port | Redis 服务器端口（默认：6379） | -| databases | Redis 数据库数量（默认：4） | -| password | Redis 认证密码（可选） | -| appendonly | 启用持久化存储（默认：开启） | - -## 配置文件 - -插件第一次启动时会在`/config/redis/redis.conf`创建一个默认的 Redis 配置文件，并通过软链接到`/etc/redis.conf`。您可以直接编辑此配置文件来自定义 Redis 的高级设置。 - -配置文件的更改将在插件下次重启时生效。插件的基本设置（端口、数据库数量、密码和持久化）会在首次创建配置文件时自动应用。 - -## 如何使用 - -安装并启动后，Redis 服务器将在您的 Home Assistant 实例上运行。您可以使用标准的 Redis 客户端连接它： - -``` -redis-cli -h -p 6379 -``` - -如果您设置了密码，可以通过以下方式连接： - -``` -redis-cli -h -p 6379 -a -``` - -## 数据持久化 - -默认情况下，Redis 数据将保存在`/data`目录中。如果您启用了`appendonly`选项，Redis 将使用 AOF（Append Only File）方式进行持久化。 - -## 开发信息 - -### 自动化构建 - -本项目使用 GitLab CI 进行自动化构建。当代码推送到主分支或创建标签时，CI 流水线会自动构建并推送 Docker 镜像。 - -支持的架构： - -- aarch64 (ARM 64 位) -- amd64 (x86_64) - -### 手动构建 - -如需手动构建，可以使用以下命令： - -```bash -# 获取版本号 -VERSION=$(jq -r '.version' config.yaml) -ARCH="aarch64" # 或 "amd64" - -# 从build.yaml获取基础镜像 -BUILD_FROM=$(yq eval ".build_from.${ARCH}" build.yaml) - -# 构建Docker镜像 -docker build \ - --build-arg BUILD_FROM="${BUILD_FROM}" \ - --build-arg BUILD_ARCH="${ARCH}" \ - --build-arg BUILD_VERSION="${VERSION}" \ - -t "registry.wghaos.com/wghaos/redis-server:${ARCH}-${VERSION}" \ - . -``` - -## 注意事项 - -- 默认情况下，Redis 仅监听本地网络。 -- 建议为您的 Redis 实例设置密码以增强安全性。 -- 如果您修改了配置文件中的基本设置（如端口），请确保同时更新插件的配置选项，以保持一致性。 diff --git a/redis-server/config.yaml b/redis-server/config.yaml index d1a2c70..14a3a71 100644 --- a/redis-server/config.yaml +++ b/redis-server/config.yaml @@ -2,7 +2,8 @@ name: "Redis Server" version: "7.2.7" slug: "redis-server" description: "Redis数据库服务器插件，为您的Home Assistant提供高性能缓存和数据存储服务" -url: "https://github.com/redis/redis" +url: https://gitcode.com/waxgourd/addons +codenotary: wghaos@163.com startup: services boot: manual init: false diff --git a/xiaoya-tvbox/CHANGELOG.md b/xiaoya-tvbox/CHANGELOG.md index 96f918c..c903ab4 100644 --- a/xiaoya-tvbox/CHANGELOG.md +++ b/xiaoya-tvbox/CHANGELOG.md @@ -1,3 +1,11 @@ +### latest-2025042709 (2025-04-27) + +- 版本升级 + +### latest-2025042509 (2025-04-25) + +- 版本升级 + ### latest-2025042309 (2025-04-23) - 版本升级 diff --git a/xiaoya-tvbox/config.yaml b/xiaoya-tvbox/config.yaml index 208318d..b412493 100644 --- a/xiaoya-tvbox/config.yaml +++ b/xiaoya-tvbox/config.yaml @@ -1,6 +1,6 @@ name: "小雅-TvBox" description: "AList代理，支持xiaoya版AList界面管理" -version: "latest-2025042309" +version: "latest-2025042709" slug: "xiaoya-tvbox" url: https://gitcode.com/waxgourd/addons image: r.hassbus.com/wghaos/xiaoya-tvbox diff --git a/xiaozhi-esp32-server-java/CHANGELOG.md b/xiaozhi-esp32-server-java/CHANGELOG.md new file mode 100644 index 0000000..29cc5c3 --- /dev/null +++ b/xiaozhi-esp32-server-java/CHANGELOG.md @@ -0,0 +1,4 @@ +### 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 new file mode 100644 index 0000000..892fcd1 --- /dev/null +++ b/xiaozhi-esp32-server-java/DOCS.md @@ -0,0 +1,182 @@ +# 小智 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 new file mode 100644 index 0000000..6c5ebfe --- /dev/null +++ b/xiaozhi-esp32-server-java/README.md @@ -0,0 +1,149 @@ +# 冬瓜甄选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 new file mode 100644 index 0000000..2ae7144 --- /dev/null +++ b/xiaozhi-esp32-server-java/config.yaml @@ -0,0 +1,38 @@ +name: "小智ESP32语音助手JAVA版" +version: "2.7.22" +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 +services: + - mysql:need +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/translations/en.yaml b/xiaozhi-esp32-server-java/translations/en.yaml new file mode 100644 index 0000000..3b46430 --- /dev/null +++ b/xiaozhi-esp32-server-java/translations/en.yaml @@ -0,0 +1,30 @@ +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 new file mode 100644 index 0000000..7ad2428 --- /dev/null +++ b/xiaozhi-esp32-server-java/translations/zh-Hans.yaml @@ -0,0 +1,30 @@ +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 index 74fe2d6..74edc40 100644 --- a/xiaozhi-esp32-server-mini/CHANGELOG.md +++ b/xiaozhi-esp32-server-mini/CHANGELOG.md @@ -1,35 +1,4 @@ -# 更新日志 - -## 0.3.4 - +## 0.3.11 (2025-04-27) - 版本升级 - -## 1.0.3 - -- 添加 ASR（语音识别）配置选项到 Home Assistant 界面 -- 支持选择不同的语音识别模型（FunASR、SherpaASR、DoubaoASR、TencentASR） -- 为在线语音识别服务添加 API 凭据配置 -- 修复音乐目录递归软链接的问题 -- 优化脚本代码结构，删除冗余注释，提高可读性 -- 修复唤醒词配置保存时出现的空行累积问题 - -## 1.0.2 - -- 添加 LLM 模型名称配置选项，允许用户自定义模型名称 -- 修复翻译文件格式问题 -- 优化配置文件更新逻辑，避免文件格式损坏 -- 改进文件管理方式，使用软链接减少存储空间占用 - -## 1.0.1 - -- 修复 Home Assistant 加载项配置同步功能 -- 添加自动将加载项配置应用到.config.yaml 的功能 -- 完善配置同步机制，支持所有加载项配置参数 -- 更新文档，详细说明配置方法和故障排除 - -## 1.0.0 - -- 首次发布 -- 支持小智 ESP32 语音识别服务 -- 自动下载模型和配置 -- 使用 S6 Overlay 进行服务管理 +## 0.3.4 (2025-04-25) +- 首次推出 \ No newline at end of file diff --git a/xiaozhi-esp32-server-mini/config.yaml b/xiaozhi-esp32-server-mini/config.yaml index 09d48f4..075f46c 100644 --- a/xiaozhi-esp32-server-mini/config.yaml +++ b/xiaozhi-esp32-server-mini/config.yaml @@ -1,5 +1,5 @@ name: "小智 AI Server 极速版" -version: "0.3.4" +version: "0.3.11" slug: "xiaozhi_esp32_server_mini" description: "小智 AI Server 极速版 - 提供语音识别、对话和控制功能，支持与ESP32设备通信" url: "https://gitcode.com/waxgourd/addons" @@ -58,4 +58,4 @@ schema: plugins.get_weather.default_location: str log_level: list(INFO|DEBUG) timezone: str -image: r.hassbus.com/wghaos/xiaozhi-esp32-server-mini +image: r.hassbus.com/wghaos/xiaozhi-esp32-server-mini-{arch} diff --git a/xiaozhi-esp32-server/CHANGELOG.md b/xiaozhi-esp32-server/CHANGELOG.md index 8213934..7403b14 100644 --- a/xiaozhi-esp32-server/CHANGELOG.md +++ b/xiaozhi-esp32-server/CHANGELOG.md @@ -1,31 +1,6 @@ -# 更新日志 - -## 1.0.3 - -- 添加 ASR（语音识别）配置选项到 Home Assistant 界面 -- 支持选择不同的语音识别模型（FunASR、SherpaASR、DoubaoASR、TencentASR） -- 为在线语音识别服务添加 API 凭据配置 -- 修复音乐目录递归软链接的问题 -- 优化脚本代码结构，删除冗余注释，提高可读性 -- 修复唤醒词配置保存时出现的空行累积问题 - -## 1.0.2 - -- 添加 LLM 模型名称配置选项，允许用户自定义模型名称 -- 修复翻译文件格式问题 -- 优化配置文件更新逻辑，避免文件格式损坏 -- 改进文件管理方式，使用软链接减少存储空间占用 - -## 1.0.1 - -- 修复 Home Assistant 加载项配置同步功能 -- 添加自动将加载项配置应用到.config.yaml 的功能 -- 完善配置同步机制，支持所有加载项配置参数 -- 更新文档，详细说明配置方法和故障排除 - -## 1.0.0 - -- 首次发布 -- 支持小智 ESP32 语音识别服务 -- 自动下载模型和配置 -- 使用 S6 Overlay 进行服务管理 +## 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/config.yaml b/xiaozhi-esp32-server/config.yaml index d129707..5a71ff8 100644 --- a/xiaozhi-esp32-server/config.yaml +++ b/xiaozhi-esp32-server/config.yaml @@ -1,8 +1,8 @@ name: "小智 AI Server 最简化版" -version: "0.3.4" +version: "0.3.11" slug: "xiaozhi_esp32_server" description: "小智 AI Server 最简化版 - 提供语音识别、对话和控制功能，支持与ESP32设备通信" -url: "https://github.com/xinnan-tech/xiaozhi-esp32-server" +url: "https://gitcode.com/waxgourd/addons" arch: - aarch64 - amd64 @@ -18,4 +18,4 @@ host_network: false init: false watchdog: "tcp://[HOST]:[PORT:8000]" journald: true -image: r.hassbus.com/wghaos/xiaozhi-esp32-server +image: r.hassbus.com/wghaos/xiaozhi-esp32-server-{arch} diff --git a/xiaozhi-esp32-server/icon.png b/xiaozhi-esp32-server/icon.png index 3a9798f..5ab7a63 100644 Binary files a/xiaozhi-esp32-server/icon.png and b/xiaozhi-esp32-server/icon.png differ diff --git a/xiaozhi-esp32-server/logo.png b/xiaozhi-esp32-server/logo.png index a233d94..a093406 100644 Binary files a/xiaozhi-esp32-server/logo.png and b/xiaozhi-esp32-server/logo.png differ diff --git a/xiaozhi-esp32-webui/CHANGELOG.md b/xiaozhi-esp32-webui/CHANGELOG.md new file mode 100644 index 0000000..74edc40 --- /dev/null +++ b/xiaozhi-esp32-webui/CHANGELOG.md @@ -0,0 +1,4 @@ +## 0.3.11 (2025-04-27) +- 版本升级 +## 0.3.4 (2025-04-25) +- 首次推出 \ No newline at end of file diff --git a/xiaozhi-esp32-webui/config.yaml b/xiaozhi-esp32-webui/config.yaml index e3068a1..9706855 100644 --- a/xiaozhi-esp32-webui/config.yaml +++ b/xiaozhi-esp32-webui/config.yaml @@ -1,8 +1,8 @@ name: "小智 AI OTA 管理" -version: "0.3.4" +version: "0.3.11" slug: "xiaozhi_esp32_webui" -description: "小智 AI Server 全模块版 - 提供语音识别、对话和控制功能，支持与ESP32设备通信，集成WEB管理界面" -url: "https://github.com/xinnan-tech/xiaozhi-esp32-server" +description: "小智 AI OTA 管理 - 提供语音识别、对话和控制功能，支持与ESP32设备通信，集成WEB管理界面" +url: "https://gitcode.com/waxgourd/addons" arch: - aarch64 - amd64