查看与导出运行日志

遇到 HA 断连、授权、保存或中控配对问题时，先记录发生时间，再打开编辑器右上角的「日志」。

找到相关记录

1. 打开「日志」，进入「全局日志」。
2. 按错误、警告等日志级别筛选，再选择相关分类。
3. 用搜索框查找来源、分类或内容；需要最新记录时点击「刷新」。
4. 展开记录的「查看详情」，检查中文原因、实体、操作阶段或请求编号。
5. 需要更早记录时点击「加载更多」。

复现问题后立即查看，通常更容易把操作和错误对应起来。全局日志最多保留最近 7 天，容量上限为 5 MiB，更早记录会被清理。

导出并反馈

点击「导出日志」下载文本，导出内容遵循当前筛选条件。反馈时同时提供：

• HA Bridge 版本、Docker 或 Add-on 安装方式；
• 使用的手机、平板或浏览器，以及 IP / 域名访问方式；
• 问题发生时间、触发步骤和预期结果；
• 相关日志文本或错误详情。

需要保留完整上下文时，先取消筛选再导出。清空日志会删除现有记录，排查结束前先导出留存。

程序无法启动或页面打不开

编辑器内日志需要程序运行并能登录。打不开时查看 Docker 容器日志，或 Home Assistant 的 HA Bridge Add-on 日志；启动版本不兼容、挂载路径或磁盘错误通常从这里定位。

下一步：更新与使用问题排查。