海尔智能家居接入 HomeAssistant 完整配置指南
准备工作与环境检查
在开始安装前，请确保你的智能家居系统满足以下基本条件：
系统兼容性清单：
- HomeAssistant 版本 2023.1.0 或更高
- 海尔智家 APP 中设备运行正常
- 稳定的网络连接环境
- 有效的海尔智家账号
验证操作步骤：
- 登录 HomeAssistant 后台确认系统版本
- 在海尔智家 APP 中检查设备在线状态
- 确保网络连接质量可靠
三种安装方法对比选择
HACS 可视化安装（新手首选）
如果你已经安装了 HACS 组件，这是最快捷的安装方式：
- 打开 HACS 管理面板
- 进入"集成"功能选项卡
- 搜索"Haier"关键词
- 点击安装按钮并重启服务
手动文件部署（技术用户适用）
对于熟悉命令行操作的用户，推荐使用传统部署方式：
git clone <project_repo_url>
cp -r haier/custom_components/haier /config/custom_components/
压缩包安装（无 Git 环境）
直接下载项目压缩包，解压后将 custom_components/haier 文件夹完整复制到 HomeAssistant 的 custom_components 目录中。
账号配置与设备连接
第一步：添加集成服务
进入 HomeAssistant 配置界面，选择"设备与服务"，点击"添加集成"按钮，搜索"haier"并选择相应选项。
第二步：账号认证流程
输入你的海尔智家账号和密码，系统会自动完成认证授权过程，确保设备访问权限正常。
第三步：设备发现验证
耐心等待设备自动扫描和发现，确认列表中显示所有预期设备，检查设备状态是否正常同步。
核心功能模块深度解析
设备通信核心
custom_components/haier/core/client.py- 负责与海尔云平台的实时数据交换custom_components/haier/core/device.py- 设备信息管理和状态同步机制
实体控制实现
custom_components/haier/climate.py- 空调温度、模式、风速全方位控制custom_components/haier/water_heater.py- 热水器温度设定和加热模式管理custom_components/haier/switch.py- 智能开关状态控制和监测custom_components/haier/sensor.py- 各类传感器数据实时采集
用户交互设计
custom_components/haier/config_flow.py- 引导式配置流程custom_components/haier/entity.py- 统一实体基础框架
