自然语言全屋智控，一键对话即执行

通过 Home Assistant Assist API 用自然语言控制全屋智能设备，零配置意图解析，token 高效。

基本信息

• 技能名称?Home Assistant Assist
• 中文名称?自然语言全屋智控，一键对话即执行
• 作者?developmentcats
• 分类?专业技能
• 版本?1.1.1
• 标签?home-assistant, smart-home, iot, voice-control, automation, conversation-api, nlu

使用方法

使用说明
核心用法
本 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 返回的文本，无法验证设备实际物理状态 |