用途：通过官方 hass-cli 工具在命令行控制 Home Assistant 智能家居设备，提供比 curl 方式更丰富的交互体验。
主要能力：实体 ID 与服务自动补全（bash/zsh/fish）；实时事件监控（hass-cli event watch）；历史查询（hass-cli state history）；表格/YAML/JSON 输出切换；交互式探索实体与服务。
必要用法：先在 Home Assistant 配置文件中生成长效访问令牌，再设置环境变量 export HASS_SERVER=https://homeassistant.local:8123 与 export HASS_TOKEN=<your-token>，用 hass-cli info 测试连接。常用命令包括 hass-cli state list 列出实体、hass-cli service call light.turn_on --arguments entity_id=light.living_room 控制设备、hass-cli service list 查看服务、hass-cli state history --since 50m light.living_room 查询历史、hass-cli event watch 监控事件；输出格式通过 -o 或 --output 指定 table/yaml/json。
适用场景：适合频繁操作 Home Assistant、需要自动补全和实时监控的用户。
限制：需安装 Python 与 hass-cli；相比 curl 方式依赖更多，脚本化与轻量场景可考虑 curl 方案；自动补全配置与故障排查详见 references/autocomplete.md 与 references/troubleshooting.md。