homeassistant-assist

🏠 一句话掌控全屋智能设备

🥥14总安装量 6评分人数 5
100% 的用户推荐

基于 Home Assistant 官方 Conversation API 的智能家居控制技能,通过自然语言直接操控全屋设备,实现零配置门槛的智能语音交互体验。

A

基本安全,请在特定环境下使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 代码完全透明,无恶意功能或隐藏网络操作
  • ✅ 认证令牌通过环境变量读取,无硬编码泄露风险
  • ✅ 目标服务器 URL 完全由用户配置,无预置可疑地址
  • ⚠️ HASS_TOKEN 为长期访问令牌,需妥善保管避免泄露
  • ⚠️ 建议强制使用 HTTPS 协议保护通信安全

使用说明

核心用法

Home Assistant Assist Skill 采用极简的"fire and forget"设计理念,用户只需用自然语言描述需求,技能便会将请求原封不动地传递给 Home Assistant 的 Assist API。无需记忆复杂的实体 ID 或服务名称,也无需手动解析意图——"打开客厅灯并调暗到 30%"这样的口语化指令即可直接执行。技能仅依赖 curl 工具,通过 POST 请求将用户文本发送至 $HASS_SERVER/api/conversation/process,并返回 Assist 生成的自然语言反馈。

显著优点

极致简洁:代码层面仅一行 curl 调用,却承载了 Home Assistant 生态完整的 NLU 能力,包括模糊匹配、区域感知、多轮对话等高级特性。零维护负担:Assist 的意图解析和实体解析逻辑完全由 Home Assistant 服务端维护,技能本身无需随 HA 版本更新而调整。生态兼容:支持灯光、开关、温控、窗帘、扫地机器人、媒体播放器等全品类设备,覆盖 Home Assistant 能接入的一切智能硬件。透明可控:开源实现,无隐藏逻辑,用户完全掌控目标服务器和认证令牌。

潜在缺点与局限性

强依赖 Home Assistant:技能本身不具备任何智能解析能力,若 HA 服务端未正确配置设备别名或区域信息,Assist 可能返回"无法找到设备"等错误。网络单点故障:所有控制指令必须实时连接 HA 服务器,本地网络中断或服务器宕机将导致完全不可用。错误反馈有限:Assist 的错误提示较为笼统,如"no_valid_targets"仅表明找不到目标,无法精确定位是名称错误、权限不足还是设备离线。语言支持受限:虽然支持多语言,但实际效果取决于 HA 的 Assist 配置,中文等非英语语种的识别准确率可能波动。

适合的目标群体

已部署 Home Assistant 的智能家居用户,尤其是追求"一句话控制"体验、不愿编写复杂自动化脚本的技术爱好者。对于拥有数十个智能设备、需要频繁跨房间/跨品类操控的家庭场景尤为适用。同时适合希望将 AI 助手与现有 HA 生态快速对接的开发者,无需额外开发意图识别模块。

使用风险

令牌泄露风险HASS_TOKEN 为长期访问令牌,若环境变量配置不当或被日志记录,可能导致未授权访问家庭设备。中间人攻击:若 HASS_SERVER 未强制使用 HTTPS,局域网内的控制指令可能被窃听或篡改。服务端漏洞传导:Home Assistant 本身的 RCE、权限绕过等漏洞可能通过此技能被间接利用,需保持 HA 版本更新。性能瓶颈:高频调用可能触发 HA 的 API 速率限制,大规模自动化场景建议直接使用 HA 原生自动化而非反复调用 Conversation API。

homeassistant-assist 内容

手动下载zip · 2.1 kB
SKILL.mdtext/markdown
请选择文件