MINARA使用 Minara客户端与界面消息平台
Home Assistant
通过任意 Home Assistant notify.* 目标路由 Minara 提醒，支持移动推送、TTS、电子邮件、Pushover 等。
🟢 运行时就绪：通过 HA 的
notify.*服务域发送即忘通知。仅支持发送：notify.*为单次调用，不返回消息 ID，因此无法编辑。助手会缓冲 token，在最终确认时统一发送。
功能说明
- 任意
notify.*目标，HA 均可路由：mobile_app_<device>：通过 HA 伴侣 App 推送至 iOS / Androidalexa_media_<device>：通过 Echo 设备播报google_assistant_sdk：通过 Google Home 播报 TTSpushover/telegram/discord，经 HA 集成代理转发tts.*服务：通过 HA 语音栈播报- 自定义
notify.*服务（在 YAML 中定义）
- 默认不绑定频道。HA 服务负责路由消息；
channel覆盖参数会被忽略（HA 服务 ID 在网关创建时设定） - 软限制 4 096 字符（助手默认值）；HA 本身无硬性上限
配置步骤
1. 创建长期访问令牌
- 打开 Home Assistant 界面
- 点击左下角头像，进入 Long-lived access tokens
- 点击 Create Token，命名为 "Minara"，复制令牌（仅显示一次）
2. 选择 notify 服务
在 HA 中，进入 Developer Tools 的 Services 页，在服务选择器中输入 notify.，选择一个可用服务。移动推送是常见起点：
notify.mobile_app_your_phone在 HA 界面直接用测试消息触发该服务，确认目标可达后再接入 Minara。
3. 配置 Minara
minara auth messaging add home_assistant或直接编辑项目根目录的 .env 文件：
HASS_URL=https://hass.example:8123
HASS_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
HASS_NOTIFY_SERVICE=mobile_app_your_phoneHASS_URL 填写完整基础 URL，末尾不加斜杠。HASS_NOTIFY_SERVICE 中的 notify. 前缀可省略，网关会自动处理。
4. 测试
minara auth messaging test home_assistant测试消息会发送至所选 notify 目标。若选择的是 Alexa TTS 服务，设备会朗读消息内容；若选择的是推送，手机会收到通知。
notify 路由示例
| 用途 | HASS_NOTIFY_SERVICE | 说明 |
|---|---|---|
| 手机推送（iOS/Android） | mobile_app_<device> | 需安装 HA 伴侣 App 并启用推送 |
| 房间播报（Echo） | alexa_media_<device> | 需安装 alexa_media_player HACS 集成 |
| Google Home TTS | google_assistant_sdk | 需安装 google_assistant_sdk 集成 |
| Pushover 升级提醒 | pushover | 集成名称：notify.pushover_* |
| 转发至 Telegram | telegram | 已配置 HA → Telegram 时可用；Minara → HA → Telegram 多一层转发，但可将路由逻辑集中在 HA 管理 |
| 广播至分组 | YAML 中定义的 notify.grouped_alerts: 扇出服务 | 在 configuration.yaml 中定义分组，然后在此引用 |
为何不支持频道覆盖
HA 路由到 notify 服务 ID，而非消息目标 ID。如需扇出，可在 HA 中创建 YAML 分组服务：
# configuration.yaml
notify:
- platform: group
name: grouped_alerts
services:
- service: mobile_app_pixel
- service: alexa_media_kitchen将 HASS_NOTIFY_SERVICE=grouped_alerts 后，单条 Minara 提醒即可扇出至所有服务。
常见问题
"401 Unauthorized"
HASS_TOKEN有误或已撤销。在 HA 的 Profile 页重新生成长期访问令牌。
"404 Not Found"，提示服务未找到
HASS_NOTIFY_SERVICE在当前 HA 实例中不存在。在 Developer Tools 的 Services 页核查；notify 域仅显示当前已注册的服务。
"TLS error / certificate rejected"
HASS_URL使用了自签名证书。可将证书安装到系统信任存储，或通过 Caddy / Traefik / Cloudflare Tunnel 为 HA 配置正式证书。
"消息已到达 HA，但未收到通知"
- 移动 App：伴侣 App 未启用推送，或设备处于勿扰模式。先在 HA 界面直接触发相同服务排查：若同样失败，则问题在 HA 侧。