HassLife 设备接入配置手册
一、核心配置项
# configuration.yaml 基础配置
logger:
default: info
logs:
custom_components.hasslife: debug
二、参数说明表
| 参数 |
类型 |
说明 |
参考来源 |
api_key
|
string |
HassLife平台生成的32位鉴权密钥，需在控制台创建 |
[4][5] |
exposure_entities
|
list |
允许同步到米家/天猫精灵的实体ID列表，支持通配符（如light.*） |
[3][8] |
device_sync
|
bool |
启用后支持米家APP状态实时同步到Home Assistant |
[2][3] |
三、设备绑定流程
前置条件：确认已安装HACS（https://hacs.xyz）并完成hasslife插件安装[6]
- 在HA侧边栏点击头像 → 创建长期令牌（用于hasslife平台鉴权）[5]
- 访问 www.hasslife.com 完成：
- 绑定HA地址（格式：
http://{IP}:8123）
- 输入上一步生成的长期令牌[4]
- 在米家APP → 我的 → 其他平台设备 → 添加hasslife服务[3]
- 在天猫精灵APP → 精灵技能 → 搜索hasslife完成绑定[5][8]
四、Docker部署示例
# 特权模式启动容器（必须参数）
docker run -d \
--name homeassistant \
--privileged \ # 硬件访问必需[1][4]
-v /PATH_TO_CONFIG:/config \
-v /run/dbus:/run/dbus:ro \
--net=host \
homeassistant/home-assistant:latest
五、故障排查
-
设备未同步：检查
exposure_entities是否包含目标实体[8]
-
API连接失败：确认HA地址可从公网访问（或启用hasslife内网穿透）[5]
-
米家控制延迟：检查HA日志中的
hasslife组件状态[4]