Assistela Assistela 文档
支持的服务

Home Assistant

连接 Home Assistant,测试访问权限,并逐个决定 Assistela 对实体只能读取还是也能控制。

连接后可以做什么

收到明确请求后,Assistela 可以读取智能家居的当前状态并调用 Home Assistant 服务。它可以检查温度传感器、读取灯光状态、从允许的摄像头获取快照、运行场景或控制明确允许的设备。

连接有两层保护:Home Assistant 访问令牌和 Assistela 中的实体允许列表。即使令牌允许更多操作,Assistela 也会拒绝使用你没有加入列表的实体。

1. 创建长期访问令牌

1

打开个人资料

在 Home Assistant 中打开用户个人资料,找到 Long-Lived Access Tokens

2

创建令牌

创建新令牌,并使用 Assistela Mac 等便于识别的名称。

3

立即复制

Home Assistant 通常只显示一次令牌值。请复制,并在保存到 Assistela 前保持对话框打开。

令牌属于机密信息

不要将它粘贴到“聊天”、“记忆”或普通备忘录中,只能输入 Home Assistant 访问密钥字段。Assistela 会将它作为受保护凭证存储;如果怀疑已泄露,请在 Home Assistant 中撤销并创建新令牌。

2. 配对 Assistela

1

打开“集成”

在 Assistela 中选择 Assistela → 设置 → 集成 → Home Assistant,然后打开 配对 标签页。

2

输入地址

Home Assistant 地址 中输入浏览器使用的同一 URL,包括 http://https:// 及端口。本地地址示例:http://homeassistant.local:8123

3

粘贴访问密钥

将刚创建的令牌粘贴到 Home Assistant 访问密钥

4

保存并测试

点击 保存并测试连接。使用本地地址时,macOS 可能请求 本地网络 访问权限;请为此用途允许访问。

3. 只允许选定的实体

打开 允许的实体 并刷新项目。可以搜索列表并按类型筛选。每个实体有两个独立选项:

  • 读取:Assistela 可以获取状态和属性。适用于只需要报告情况的传感器和设备。
  • 控制:Assistela 可以调用开灯或运行场景等操作。启用“控制”也会启用“读取”。

先从温度传感器和一盏测试灯等少量无害项目开始。在明确所需指令和审批之前,不要为门锁、警报器、车库门、供暖或其他涉及安全的设备启用“控制”。

首次测试

  1. 询问:“客厅传感器当前是什么状态?”
  2. 读取正常后,测试允许的灯:“短暂打开办公室测试灯。”
  3. 随后直接在 Home Assistant 中核对状态。

如果找不到实体,请刷新列表。缺失 状态通常表示该实体已在 Home Assistant 中改名或删除,需要选择当前实体 ID。