Home Assistant 自定义唤醒词：在线训练并通过 Wyoming 接入

输入中文或其他语言短语，先在控制台评估 Basic 模型，再决定是否下载，并通过开源 Wyoming 服务接入 Home Assistant。

完整流程

1. 输入唤醒词并在线训练。
2. 购买前用自己的麦克风测试基础召回和误触发。
3. 决定继续后下载 ONNX 模型包。
4. 运行 Wyoming 服务，在 HA 中添加 Wyoming Protocol。
5. 使用最终麦克风、距离和房间噪声重新验证。

Home Assistant 设置

启动服务后，在 HA 打开设置 → 设备与服务 → 添加集成 → Wyoming Protocol，填写服务 IP 和端口 10400，再到语音助手配置中选择唤醒词。

Wyoming 与 Docker 接入指南 · HA Add-on 源码 · 完整开源运行时

为什么不能直接放进 openWakeWord Add-on？

ONNX 只规定文件格式，不规定统一推理协议。Voicute 使用自研 Causal TCN、配套 Head，以及自己的 Mel 特征、输入窗口和输出定义；openWakeWord 预期另一套模型管线，因此不能直接互换。

Voicute 模型 → onnx-wakeword Wyoming 服务 → Home Assistant

完整紧凑模型针对目标语言和短语训练，而不是只在固定 embedding 上训练小分类器，因此多语言表现更可控；仍需实机验证。