zimonianhua
69f7a1e2cf
docs(README): 更新安装说明并添加HACS安装方法 - 修改手动安装路径说明，使表述更清晰 - 新增HACS安装方法作为推荐方式，包含详细步骤 chore(hacs): 统一组件名称表述 - 将HACS显示名称从"阿里语音识别"更新为"阿里通义千问语音识别" - 保持与其他文档的一致性 ```
Home Assistant 阿里云通义千问 STT 语音识别插件
本插件集成了阿里云通义千问 (Qwen) 实时语音识别服务，为 Home Assistant 提供高精度的语音转文字功能。
功能特性
- 模型支持：支持
qwen3-asr-flash-realtime（通义千问实时识别）。 - 图形化配置：支持通过 Home Assistant 前端界面直接添加集成。
- 多语言支持：支持中文、英文、粤语等多种语言识别。
- 实时识别：基于 WebSocket 协议，低延迟实时转写。
- 多区域支持：支持北京（国内）和新加坡（国际）节点。
- 音频格式：WAV（PCM 16-bit / 16kHz / 单声道）。
安装说明
方法一：手动安装
- 下载本项目代码。
- 将
/custom_components/下的hass_stt_qwen文件夹复制到您的 Home Assistant 配置目录下的custom_components文件夹中。- 最终路径应为：
/config/custom_components/hass_stt_qwen/
- 最终路径应为：
- 重启 Home Assistant。
方法二：HACS 安装（推荐）
- 确保你已经在 Home Assistant 中安装并配置了 HACS（Home Assistant Community Store）。
- 点击 HACS 界面左上角的菜单，选择
自定义仓库（Custom repositories），在弹出的窗口中输入仓库地址https://github.com/xyzmos/hass_stt_qwen，类别选择集成，然后点击添加。之后再搜索阿里通义千问语音识别即可找到。 - 选择
阿里通义千问语音识别集成，点击下载此存储库。 - 下载完成后，重启 Home Assistant。
配置指南
- 登录 Home Assistant。
- 点击左侧菜单的 配置 -> 设备与服务。
- 点击右下角的 添加集成 按钮。
- 搜索 阿里通义千问语音识别 并点击。
- 在弹出的配置窗口中输入以下信息：
- API 密钥: 您的阿里云 DashScope API 密钥。
- 获取方式：阿里云百炼控制台
- 模型: 选择您需要使用的模型（推荐
qwen3-asr-flash-realtime）。 - 区域: 根据您的 API Key 所在区域选择（北京或新加坡）。
- API 密钥: 您的阿里云 DashScope API 密钥。
- 点击 提交 完成配置。
使用方法
配置完成后，您可以在 Home Assistant 的语音助手设置中选择 阿里通义千问语音识别 作为语音转文字 (STT) 引擎。
- 进入 配置 -> 语音助手。
- 选择或创建一个语音助手。
- 在 语音转文字 选项中选择 阿里通义千问语音识别。
常见问题
Q: 如何获取 API Key？ A: 请访问 阿里云百炼控制台，开通服务并创建 API Key。
Q: 插件支持哪些 Home Assistant 版本？ A: 需要 Home Assistant 支持 SpeechToTextEntity（STT 实体）的版本。
Q: 支持哪些语言？ A: 通义千问 Qwen ASR 支持中文、英文、粤语、日语等多种语言。
Q: 遇到连接失败怎么办？ A: 请检查 API Key 是否正确，以及网络连接是否正常。如果您在海外，请尝试切换到新加坡区域。