通过 Home Assistant Assist API 用自然语言控制全屋智能设备，零配置意图解析，token 高效。
说明：
## 核心用法
本 skill 是 Home Assistant Assist (Conversation) API 的轻量级封装，采用 **「fire and forget」** 设计理念：将用户的自然语言指令原封不动地传递给 HA 的 NLU 引擎，由 Assist 完成意图识别、实体模糊匹配、区域感知执行等全部工作。开发者仅需配置 `HASS_SERVER` 和 `HASS_TOKEN` 两个环境变量，即可通过单条 curl 调用实现对灯光、开关、温控、窗帘、扫地机器人、媒体播放器等全品类设备的语音控制。
### 显著优点
1. **极简集成**：不维护设备清单、不解析意图、不处理状态同步，完全 offload 给 HA 生态
2. **自然语言友好**：用户无需记忆实体 ID，可说「把客厅灯调暗一点」或「打开空气净化器」
3. **区域感知**：自动识别「厨房」「主卧」等空间限定词
4. **响应即结果**：直接透传 `response.speech.plain.speech`，无需二次加工
5. **Token 经济**：单次 API 调用完成复杂指令，避免多轮工具调用
### 潜在局限
– **强依赖 HA 配置**：设备别名模糊、重复命名、区域划分混乱会直接导致 Assist 返回 `no_valid_targets` 或歧义错误
– **网络单点**：需确保 HA 实例可达，本地离线场景不可用
– **无细粒度反馈**：只能获得自然语言结果，无法直接获取执行状态码或设备原始属性（如亮度数值、温度读数）
– **语言支持**：依赖 HA 实例的语言配置，非英语环境需确认 Assist 语言包
### 适合人群
– 已部署 Home Assistant 且追求「一句话控全屋」的智能家居用户
– 希望快速接入 HA 生态、不愿维护庞大数据模型的 AI 助手开发者
– 需要自然语言桥接而非底层设备管控的场景
### 常规风险
| 风险类型 | 说明 |
|———|——|
| 配置泄露 | `HASS_TOKEN` 为长期有效令牌，需妥善保管，避免硬编码 |
| 误操作 | 模糊指令可能触发非预期设备（如「关灯」匹配到多个房间） |
| 依赖漂移 | HA 版本升级可能变更 API 行为，需关注 `/api/conversation/process` 兼容性 |
| 响应不可信 | 仅透传 Assist 返回的文本，无法验证设备实际物理状态 |
会员专属
