1.1 版本号

需要安装并配置好Home Assistant（下称HASS） v0.73及以上版本（0.89.2版测试通过）；

1.2 公网访问

通过端口映射或内网穿透将HASS开放到公网（http或https均可）；

1.3 Customize基本设置

在customize.yaml里，将想添加到天猫精灵的设备下加入一条 tmall_genie: true （必须添加，否则无法识别设备）；

1.4 Customize高级设置

由于天猫精灵官方不支持同一位置多传感器，本技能通过高级设置可以达到虚拟传感器效果。具体代码如下：

sensor.temperature_158d000000:
  friendly_name: 小米温度
  tmall_genie:
    enabled: true
    attach_sensor:
      - entity_id: sensor.humidity_158d111111

1.5 长效令牌获取

最后一步，需要在你的HASS实例中，生成一个长期访问令牌。具体方法如下，在HASS界面左上角，点击你的名字的首字母，滚动到页面最下方长期访问令牌处，点击创建令牌，名称随便输入（最好输入tmall以便记忆，且不要随意删除），然后点击确定会生成一长串字符，将以上字符拷贝出来，保存备用。

2.1 搜索技能

打开天猫精灵APP，点击“我的”，点击“添加智能设备”，搜索设备品牌“HASSMART”，找到“HASSMART”技能，点击绑定平台账号，跳转到授权页面；

2.2 输入HASS地址

输入你的HASS公网地址，要包括http或https，如https://my.hass.com:8123。点击确定，系统会验证HASS地址的有效性，并跳转到你的HASS实例的OAuth登录页面；

2.3 OAuth登录

输入HASS用户名和密码授权登录，鉴权正确之后会提示授权成功，第一次使用需要填写昵称、邮箱地址和长效令牌（1.5部分获取得到的），点击确定，系统会验证长效令牌的可用性，如果检查成功会提示token获取成功，并自动跳转到设备管理界面；

2.4 设备列表中选择设备位置和别名

此时天猫精灵智能设备管理界面会显示HASS里已配置为tmall_genie: true的设备列表，但还没完事，这时还需要在此列表中点击相应设备，设置其位置或别名（必须设置，否则天猫精灵无法识别）；

2.5 语音测试

设置完成后，就可以对天猫精灵说了：天猫精灵，打开卧室吸顶灯（假设你的设备是light，位置选的卧室，别名选的吸顶灯）；

2.6 设备更新

如果HASS中设置进行了更新，在确保HASS已启动成功后，在天猫精灵设备管理界面，下拉刷新即可更新设备列表。注意：更新后可能需要重新选择位置和别名。