基于 Home Assistant 的海尔设备全屋智能集成方案

基于 Home Assistant 的海尔设备全屋智能集成方案

在 Home Assistant 生态中，海尔智能家居集成插件是目前连接海尔智家设备最成熟的方案之一。它允许我们将空调、热水器、窗帘、开关等各类海尔智能产品无缝接入统一系统，实现真正的全屋智能控制。

需求分析与准备

在动手配置前，建议先梳理一下家里的具体场景：

家庭环境控制

• 夏季空调自动调节温度
• 冬季热水器智能预热
• 窗帘根据光照或时间自动开合

设备管理

• 需要一个统一的控制界面
• 实时查看设备状态
• 支持远程操作

安装与部署

目前主要有两种安装方式，根据你的熟悉程度选择即可。

HACS 一键安装（推荐） 如果你已经安装了 HACS，这是最省心的方式：

1. 打开 HACS 界面
2. 搜索 haier
3. 点击安装按钮

手动安装方案 适合对 HomeAssistant 基础操作更熟悉的用户：

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/ha/haier
2. 复制文件夹：将 custom_components/haier 复制到 HomeAssistant 根目录下的 custom_components 文件夹

认证与配置

安装完成后，进入配置阶段是关键一步：

1. 访问集成界面：前往 配置 > 设备与服务 > 集成
2. 添加海尔集成：搜索 haier 并点击添加
3. 账号认证：输入 Client ID 和 Refresh Token 完成设备连接

这里需要注意，Token 的获取通常需要在海尔官方 App 或开发者后台申请，确保权限正确才能拉取到设备列表。

高级定制与调试

实体过滤与筛选

默认情况下，集成可能会加载所有可用设备。如果家里设备较多，可以通过修改源码进行筛选：

• 在 custom_components/haier/core/config.py 中，可以设置选择性接入特定设备，排除不需要的类型，或者自定义显示顺序。
• 在 custom_components/haier/config_flow.py 中灵活配置，只显示需要的控制项，隐藏不常用的功能，优化界面布局。

这样能避免控制面板过于杂乱，提升日常使用体验。

调试日志开启

遇到连接问题或状态异常时，开启调试日志是排查问题的第一步。在 configuration.yaml 中加入以下配置：

logger:
  default: warn
  logs:
    custom_components.haier: debug

重启后，日志会详细记录组件运行时的交互过程，方便定位是网络问题还是鉴权失败。

常见问题处理

在实际使用中，可能会遇到以下几种情况：

• 设备无法连接：优先检查网络连接是否通畅，以及账号权限是否过期。