用途:通过 Home Assistant 控制智能家居设备、读取传感器数据,并回答家庭状态、历史趋势与活动记录相关问题。
主要能力:读取单个实体状态、列出实体、调用服务控制设备(灯、开关、风扇、窗帘、空调、场景、脚本、自动化)、查询历史与日志、获取家庭总览、抓取摄像头 JPEG 快照、渲染模板批量查询、触发自动化事件、通知与 TTS 语音播报。
使用方式:优先用 ha_list_entities 或 ha_get_home_status 发现真实实体 ID,切勿猜测;单实体用 ha_get_state,控制设备用 ha_call_service,趋势用 ha_get_history,日志用 ha_get_logbook,复杂状态查询用 ha_render_template。摄像头快照用 ha_get_camera_snapshot,会保存到 selfies_{your_slug}/ 并返回路径。
适用场景:家庭传感器读数、设备开关控制、历史数据分析、家庭状态总览、摄像头画面获取。
限制:实体 ID 常与预期不符;状态可能为 unavailable 或 unknown,不可当作读数;灯光亮度为 0-255;破坏性操作需先确认;PTZ 无通用服务,需按集成发现;保存快照不可写入 sibling_journal/。其他细节暂未提供。