核心用法
homeassistant-cli 是一个文档型 Skill，旨在指导用户使用官方 hass-cli 工具控制 Home Assistant 智能家居系统。用户需先通过 pip 或 Homebrew 安装 hass-cli，配置 HASS_SERVER 和 HASS_TOKEN 环境变量后即可使用。核心功能包括：设备状态查询与控制（灯光、开关、传感器等）、服务调用与场景激活、实时事件监控（event watch）、历史数据查询（state history），以及灵活的输出格式切换（table/YAML/JSON）。Skill 提供了完整的命令示例和自动补全配置指南，支持 bash/zsh/fish 等主流 shell。
显著优点
1. 交互体验丰富：相比 curl 方案，提供自动补全、实时事件流、历史查询等高级功能，大幅降低命令行操作门槛。
2. 输出格式灵活：一键切换 table/YAML/JSON 格式，兼顾人工阅读与脚本自动化需求。
3. 官方生态背书：基于 Home Assistant 官方 CLI 工具，社区活跃、文档完善、持续维护。
4. 零代码风险：纯文档型 Skill，不执行任何系统命令或网络请求，完全由用户自主控制操作。
5. 安装便捷：支持 pip 和 Homebrew 双渠道安装，跨平台兼容性好。
潜在缺点与局限性
1. 依赖外部工具：必须预先安装 hass-cli 和 Python 环境，相比纯 curl 方案增加了依赖负担。
2. 配置门槛存在：需要用户手动生成长期访问令牌并配置环境变量，对新手有一定学习成本。
3. 网络环境要求：依赖与 Home Assistant 服务器的稳定连接，内网穿透或 HTTPS 证书配置可能带来额外复杂度。
4. 功能边界清晰：作为文档型 Skill，本身不执行任何自动化操作，所有控制需用户手动发起。
适合的目标群体
- 智能家居重度用户：频繁与 Home Assistant 交互，需要高效命令行工具进行批量设备管理。
- 技术爱好者与极客：偏好 CLI 工作流，希望将智能家居控制集成到终端日常操作中。
- 自动化脚本开发者：需要结构化输出（JSON/YAML）进行下游处理的工程师。
- Home Assistant 管理员：负责多设备维护、故障排查、历史数据分析的系统管理者。
使用风险
1. 令牌安全管理：HASS_TOKEN 具有长期访问权限，若硬编码在脚本或泄露可能导致未授权访问，建议严格使用环境变量并设置文件权限。
2. 网络传输安全：默认依赖 HTTPS 加密，但用户若配置不当或使用自签名证书可能引入中间人攻击风险。
3. 依赖项维护：hass-cli 版本更新可能与 Home Assistant 服务器版本产生兼容性波动，需关注官方更新日志。
4. 误操作风险：命令行操作直接生效，批量控制设备时需谨慎确认实体 ID，避免意外触发场景。