安装¶

HASS.Agent 由两部分组成：客户端/Windows 应用程序和 Home Assistant 集成。您需要安装和配置这两部分才能使用 HASS.Agent 的许多功能。

从 2.0.0 之前版本迁移?

如果您已经在 2.0.0 之前安装了 HASS.Agent，请查看页面底部的信息以了解如何迁移。

前置条件¶

Home Assistant: 确保您的 Home Assistant 版本高于 2023.6.0。如果您需要有关 Home Assistant 的帮助，请参阅官方文档。
MQTT: 设置一个 MQTT 中继器并在 Home Assistant 中安装/配置 MQTT 插件。一个简单的 MQTT 设置指南可以在这里找到。
Windows 10/11: HASS.Agent 支持 Windows 10 和 11。旧版本可能可以工作，但功能无法保证。

我不想安装或使用 MQTT，我还能使用 HASS.Agent 吗?

您不需要 MQTT 就可以使用 HASS.Agent；然而，大多数功能依赖于它进行双向通信。没有 MQTT，只有快速操作会起作用。

安装 HASS.Agent¶

要开始安装 HASS.Agent，请按照以下步骤操作：

从这里下载最新的安装程序。
打开安装程序并按照屏幕上的说明进行操作。
可选： 安装程序允许您从之前安装的 HASS.Agent 版本（Pre-2.0.0）复制配置。

安装 Home Assistant 集成¶

我完全不想使用 HASS.Agent 集成

您不需要使用集成，但是您将失去对媒体播放器和通知功能的使用权限。

在您的 PC 上安装 HASS.Agent 后，请按照以下步骤安装 Home Assistant 集成：

步骤

确保您已安装 HACS。如果没有，请按照安装指南这里进行操作。
点击 HACS 集成屏幕右上角的三个点
1. 选择 "自定义仓库"
2. 粘贴以下信息
  1. 仓库： https://github.com/hass-agent/HASS.Agent-Integration
  2. 类别： 集成
3. 点击 "添加"
点击下面的按钮打开集成
点击右下角的 "下载" 以安装

3 点菜单的图片

我不想安装 HACS，我还能安装 HASS.Agent 集成吗?

是的，可以在没有 HACS 的情况下安装集成；然而，这更困难。更多信息可以在这里找到。

完成¶

安装完集成和客户端/Windows 应用程序后，请继续进行初始设置和配置。

Info

安装完成后，您可以删除 HASS.Agent.Installer.exe。

从 2.0.0 之前版本迁移¶

如果您在 2.0.0 之前有 HASS.Agent，可以按照以下步骤迁移到新的版本。

创建备份可选¶

HASS.Agent v2 有一个从 v1 复制配置的迁移过程，但如果您不想冒丢失之前配置的风险，可以通过将配置文件夹的整个内容复制到您电脑的其他位置来创建备份。默认情况下，它们存储在这两个文件夹中：

主配置¶

%localappdata%\HASS.Agent\Client\config

卫星服务配置¶

C:\Program Files\HASS.Agent Satellite Service\Service\config

安装 2.0.0+¶

按照上述步骤安装最新的 hass.agent 客户端，确保在最后勾选迁移配置的选项。

实体命名变更

从 2.0.0 之前版本迁移后，由于实体命名变更，您可能会在控制台中看到错误。更多信息和一个解决方案可以在这里找到。

按照上述指南正常安装最新的集成。

移除旧的 HASS.Agent 可选¶

不需要保留旧的 HASS.Agent，因此您现在可以从设置或控制面板中将其移除。旧的称为 "HASS.Agent"，新的称为 "HASS.Agent 2"。

Warning

建议您移除旧的集成以确保没有冲突，只需在 HACS 中选择集成，您就会在三个点下找到删除选项。

安装¶