家庭助手命令行工具 CLI 指南

家庭助手命令行工具 CLI 指南

cli:white_square_button: Home Assistant command line interface项目地址:https://gitcode.com/gh_mirrors/cli58/cli

项目介绍

家庭助手命令行工具 (home-assistant/cli) 是一个专为家庭自动化平台 Home Assistant 设计的官方命令行界面。它允许开发者和用户通过终端轻松管理他们的 Home Assistant 实例，执行各种操作如配置设备、查看状态、以及触发场景等，无需通过图形界面，提高了效率和灵活性。

项目快速启动

要快速开始使用 home-assistant/cli，请遵循以下步骤：

安装

首先，确保你的系统中安装了 Python 和 pip。然后，可以通过pip全局安装 CLI 工具：

pip install homeassistant-cli

验证安装

安装完成后，你可以通过运行 hass-cli --version 来验证是否安装成功，这将会显示当前安装的版本号。

连接到Home Assistant实例

在终端中，使用以下命令连接到你的本地Home Assistant实例（假设你的Home Assistant运行在默认的8123端口）：

hass --host http://localhost:8123

如果你的实例部署在不同的地址或需要认证，使用相应参数添加用户名和密码：

hass --host http://your-home-assistant-url --auth user:password

应用案例和最佳实践

查询设备状态

快速检查家中某个设备的状态，例如名为“Living Room Light”的灯：

hass device state Living_Room_Light

控制设备

比如，开/关客厅的灯：

hass service call light.turn_on entity_id=Living_Room_Light
hass service call light.turn_off entity_id=Living_Room_Light

自动化脚本创建

编写自动化可以提升家中的智能体验。虽然大部分自动化在UI中配置，但了解通过CLI管理也是个好习惯。

典型生态项目

家庭助手拥有庞大的社区生态，包括大量的集成插件(integrations)和自定义组件，使得与智能家居设备的连接变得简单。例如，想要添加Philips Hue灯光支持，通常在GUI中完成配置，而通过CLI，你能探索更多高级调优选项和批量操作的可能性。

为了深入了解并利用这些生态项目，建议访问Home Assistant的官方文档，特别是关于如何集成新设备和服务的部分。这些资料不仅提供基础安装指导，还有高级特性和最佳实践分享，让你能够充分利用home-assistant/cli的强大功能，实现家庭自动化梦想。

cli:white_square_button: Home Assistant command line interface项目地址:https://gitcode.com/gh_mirrors/cli58/cli