排障指南

先找到你看到的现象，只做这一节。问题解决后不需要继续往下排查。

先判断问题发生在哪一段

1. 01 设备 品牌平台中是否正常
2. 02 Home Assistant 能否看到设备和新状态
3. 03 桥接与数据源 是否在线并持续同步
4. 04 seenzus 是否显示、更新并可控制

设备没出现

1. 在 Home Assistant 中确认设备本身存在且状态正常；
2. 在 seenzus「集成」页确认 Home Assistant 显示在线；
3. 等待片刻，让设备目录完成同步；
4. 仍未出现时，重新加载设备所属的 Home Assistant 集成。

设备还没进 Home Assistant？先按品牌或类型接入设备。

Home Assistant 显示离线

1. 确认 Home Assistant 主机和家庭网络正常；
2. 在 Home Assistant 中确认 seenzus MQTT Bridge 正在运行；
3. 等待桥自动重连；
4. 持续离线时，重启 Home Assistant 后再看。

状态不更新

如果 seenzus 显示在线，但某台设备状态停住：

1. 先在 Home Assistant 中确认这台设备的状态是否更新；
2. 只有 Home Assistant 也停住时，重新加载设备所属集成；
3. Home Assistant 正常、seenzus 仍不更新时，记录设备名和时间后联系支持。

桥只会同步 Home Assistant 当前提供的状态，不会替来源集成猜测新状态。

配对失败

• 授权页打不开：确认 Home Assistant 能访问互联网，然后重新发起；

• 会话已失效：回 Home Assistant 重新选择「快速配对」；

• 授权后没有自动完成：打开下面地址再重试；默认地址打不开时才换用 HA IP：

  http://homeassistant.local:8123

• 提示不支持界面配置：重启 Home Assistant，并确认桥已正确安装。

更具体的处理见快速配对常见问题。

控制没有反应

1. 确认设备显示在线且不是只读设备；
2. 在 Home Assistant 中直接控制一次，排除设备自身问题；
3. 回到 seenzus 重新发起操作，并完成确认卡；
4. 查看最近动作里是否记录了失败原因。

语音不能用

确认浏览器已允许麦克风权限。部分浏览器或受限成员暂不支持语音，可以先改用文字输入。

仍然没有解决

把以下信息发到 [email protected]：

• Home Assistant 版本；
• 发生问题的时间；
• 错误提示或「集成」页状态；
• 受影响的设备名。