用途：通过 Home Assistant 的 REST API 和 Webhook 控制智能家居设备、运行自动化，并接收事件回调。
主要能力：列出与查询实体、获取实体状态；控制 light、switch、climate、cover、media_player 等设备；触发 script、automation，激活 scene；通过 Webhook 接收 Home Assistant 主动推送的事件。
使用方式：先在 ~/.config/home-assistant/config.json 写入 url 与 token，或用环境变量 HA_URL、HA_TOKEN。令牌在 Home Assistant 的 Profile → Long-Lived Access Tokens 创建，仅显示一次。调用示例：列出实体 curl -s -H "Authorization: Bearer $HA_TOKEN" "$HA_URL/api/states"；开灯 curl -X POST -H "Authorization: Bearer $HA_TOKEN" -H "Content-Type: application/json" "$HA_URL/api/services/light/turn_on" -d '{"entity_id": "light.living_room"}'；亮度参数 brightness 取值 0-255。也提供 scripts/ha.sh 封装，如 ha.sh list lights、ha.sh on light.living_room 200、ha.sh scene movie_night、ha.sh call light turn_on '{...}'。接收事件需在 HA 中配置 rest_command 指向回调地址，并在自动化中调用。
限制与排错：401 表示令牌失效需重新生成；连接被拒需检查 HA_URL 与实例可访问性；实体未找到需先列出实体确认 entity_id。更多高级用法见其 references/api.md。收费、价格与平台支持暂未提供。