备注

• HAVCS 插件开源地址：https://github.com/cnk700i/havcs
• 论坛教程：https://bbs.hassbian.com/thread-15591-5-1.html
• havcs作者的官方文档（https://ljr.im/articles/plugins-havcs-edible-instructions/）
• 建议使用版本： 2021.5.4

更新日志

• 2023-05-26
  1. HA版本：2023.5.2
  2. 测试小度音箱平台定时任务逻辑有调整：之前是平台发送定时指令，由插件定时触发；现在是平台定时后发送控制指令 https://bbs.hassbian.com/thread-21059-1-1.html
  3. 实际在小度开放平台上配置调试授权的时候，Oath2跳转的连接里面是https://xiaodu-dbp.baidu.com
  4. havcs.reload 报错，报错信息 havcs的插件代码里面调用了ha的 async_get_registry 方法不存在，搜索发现在另一个项目的issue里面看到这个方法在去年就已经弃用，因为我的ha版本是相当新的，已经被官方移除了。rospogrigio/localtuya#855
• 2022-03-19
  1. ha升级到2022.3后，所有"with async_timeout.timeout(5, loop=hass.loop):"中 loop参数弃用出错了，说很早就提示了。我是每次出问题了才知道。https://bbs.hassbian.com/thread-15591-1-1.html
• 2020-10-14
  1. 修复自动生成平台设备类型的逻辑导致无法正确返回设备类型
  2. 修复manifest.json的mqtt依赖导致不启用mqtt插件无法启动本插件
• 2020-09-22
  1. 修复设置actions但不设置自定义指令造成无法控制
• 2020-09-18
  1. 修复小度音箱定时指令失效
  2. 修复自定义指令失效
  3. 修复天猫精灵"Detected I/O inside the event loop"警告
• 2020-08-31
  1. HA 0.114.4版本测试
  2. 调整UI管理界面，增加指令过滤设置选项，避免配置了自建技能情况下使用havcs APP技能，会重复返回2次设备（小度音箱会有这种情况）
  3. 修复UI管理界面嵌套显示
• 2020-05-05
  1. 修复刷新token校验条件不正确
• 2020-04-15
  1. 修复web管理页面平台可见属性与后台不匹配
• 2020-04-12
  1. 修复dueros获取未知属性会返回错误
• 2020-04-10
  1. 修复修改集成配置clients不生效
  2. 修复group寻找entity_id错误
• 2020-04-09
  1. 修复页面注册方法兼容问题
• 2020-04-06
  1. 增加页面get方法方便检测
  2. 去除失效的自动测试提醒
• 2020-04-05（注意：服务url以及插件配置有调整）
  1. 增加授权页面，可自定义客户端ID，调整各服务url进同一层级（/havcs/）
  2. 设备管理页面增加导出、导入、同步设备、查看插件配置信息的功能
  3. 修复若干bug
• 2020-04-01
  1. 修复页面新增按钮失效、增加新增设备简单校验
• 2020-03-30
  1. havcs v3版本，增加UI配置管理
• 2020-02-23
  1. 旧证书有问题重新进行更新，如使用app的havcs技能（连接mqtt服务器）需要重新替换本地ca.crt文件
• 2020-01-28
  1. 调整"entity_key"配置项（加密entity_id）为可选
• 2020-01-23
  1. 调整设备类型生成逻辑，优先尝试根据设备名称识别生成
• 2020-01-17
  1. 增加企业微信控制功能（测试）
  2. ca证书过期，更新证书
• 2020-01-12
  1. 修复天猫精灵名称识别总是匹配到大类的问题
  2. 修复查询指令返回属性不正确
• 2020-01-02
  1. 刷新token增加返回refresh_token值（天猫精灵要求）
• 2019-11-21
  1. 修复旧版本(0.89)mqtt初始化成功判断失效
• 2019-10-20
  1. 修复havcs_device_type不设置会导致错误、自动生成device_tpye代码出错
• 2019-10-03
  1. 修复指定device_type没有匹配相应的actions
  2. 修复叮咚生成设备信息中的话术信息可能导致的错
• 2019-09-25
  1. 重构音箱网关代码，改用独立文件配置设备信息
  2. 修复取消配置后不能正常清除config entry信息的问题
  3. 调整设备信息属性havcs_enable为havcs_visable，可以设置该设备只对指定平台可见
• 2019-09-17
  1. 修复天猫精灵获取变量信息失败导致初始化失败
• 2019-08-23
  1. HA 0.97.2版本下测试，修复一些小度音箱定时控制指令功能的bug
• 2019-08-20
  1. 小度音箱支持light、switch、inputboolean类型定时打开/关闭指令，需配合common_timer插件使用
• 2019-05-10
  1. 采用新方案，在不影响HA的token超时时间参数情况下，现在可以为token独立设置超时时间
• 2019-05-07
  1. 修复原生input_boolean打开关闭指令失效
  2. 修复token正则匹配不正确
• 2019-05-06
  1. 重新设计配置项更容易设置
  2. 优化三种模式代码逻辑
  3. 整合模式一服务网关，重新测试
  4. 优化调试日志的样式
• 2019-05-03
  1. input_boolean实体支持对调节亮度操作指令映射service（aihome_actions属性）
  2. 指令映射模式下，支持执行多条指令（设置方法有变化，请查看教程）
  3. HA 0.92.1版本测试
• 2019-04-09
  1. 增加设备配置样例（使用packages方式导入即可测试）
  2. 修复叮咚启动不同步信息bug
• 2019-04-07
  1. 精简配置项，增加模式三简略配置说明
• 2019-04-01
  1. 增加首次启动连接mqtt测试功能，如果正常INFO级别日志会显示提示信息，否则请检查appkey以及网络连接
• 2019-03-29
  1. 设备开关状态主动上报（小度音箱），可通过配置文件设置是否上报
  2. HA 0.90.2版本测试
  3. 前端页面优化，上线了密码找回功能
• 2019-03-06
  1. HA 0.88.2版本测试
• 2019-02-27
  1. input_boolean支持直接调用service指令
• 2019-02-22
  1. 增加叮咚设备更新（插件启动触发更新）
  2. 修复京东音箱、小度音箱对input_boolean类的开/关控制
  3. 天猫精灵设备配置命名风格统一
  4. 更改设备发现模式为非主动发现,使用"aihome_device"属性设置设备可被发现
  5. 传感器类设备配置属性精简
  6. 说明文档补充设备配置样例
• 2019-01-xx HA 0.86.4 和 HA 0.82.1，本地单机测试

调试Tips

1. 根据教程调整插件的调试级别查看详细的运行日志
2. 配置好插件，启动HA，观看是否有mqtt连接成功信息（app技能接入方式）
3. 授权过程，观看是否有相关的处理日志
4. 说音响指令后，观看是否有相关的处理日志
5. web页面->开发者工具->服务->havcs.reload，观看是否生成设备信息

WARN: 如需要帮助，请提供以上步骤相对应的日志信息方便定位原因。