解决 HASS.Agent 的安装和设置问题

获取帮助

你可以在很多地方获取帮助，我们更多信息可以在 获取帮助 部分找到。

设备在 Home Assistant 中不显示？

不幸的是，自动发现问题很常见，目前解决它的最佳方法是重新安装集成。

警告

在 Hass.Agent 集成下只会显示通知和媒体播放器。对于命令和传感器，你需要查看 MQTT 集成。

解决步骤

1. 移除集成。
   1. 打开 HACS。
   2. 打开 Hass.Agent 2 Integration - Media Player & Notifications。
   3. 点击 3 个点。
   4. 点击 Remove。
2. 重启 Home Assistant。
3. 正常安装集成。
4. 重启 Home Assistant。

这应该可以解决大多数设备不显示的问题。

移除后设备在 Home Assistant 中仍然显示？

如果你在移除后设备仍然在 Home Assistant 中显示，你可以尝试重启 Home Assistant。如果它们仍然显示，请尝试以下步骤：

1. 下载并安装 MQTT Explorer。
2. 打开 MQTT Explorer。
3. 连接到你的 MQTT 中继。
4. 找到主题 homeassistant/device_type/your_device_name/old_entity 并删除它。

如果我删除了一个活动实体呢?

如果任何 HASS.Agent 实体被移除，它将自动被添加，所以你不需要担心会丢失任何数据。小心不要移除任何与 HASS.Agent 无关的内容。

频繁出现的问题

实体命名警告

如果你在 Home Assistant 控制台中看到实体名称警告，这很可能是因为一段时间前对实体命名方式做出的更改。

发生了什么？技术概述

HA 现在自动追加设备名称

HA 实施的更改是现在它自动将设备名称追加到实体名称的开始部分。所以如果你的设备命名为 my-pc，而实体名为 gpu-temp，HA 将自动将它们连接起来创建 my-pc_gpu-temp。

我为什么需要做任何事？

如果你什么也不做，并且你目前以设备开头命名实体（V1 的默认设置），它将显示为控制台错误，因为实体将被命名为：my-pc + my-pc_gpu-temp，创建：my-pc_my-pc_gpu-temp。

解决方法

HASS.Agent V2 带有一个 compat_names 参数，可以传递给 .exe 来自动修复名称。你可以按照以下步骤使用它：

1. 在 Windows 搜索中输入 PowerShell 并以管理员身份运行它。
2. 使用此命令切换到 HASS.Agent 目录：cd C:\Users\YOURUSERNAME\AppData\Local\Hass.Agent\Client。
3. 现在你应该在 hass.agent 目录内的管理员 PowerShell 窗口中，输入以下命令：.\HASS.Agent.exe compat_names。
4. 你应该看到类似于下面的弹窗，并且控制台中没有错误，完成后它将关闭，你可以关闭所有窗口后重新打开 HASS.Agent。