# havcs

**Repository Path**: luopengtao/havcs

## Basic Information

- **Project Name**: havcs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-04-08
- **Last Updated**: 2024-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 备注
- master分支为最新功能并适配更高的HA版本号，如要使用旧版本插件到[release][1]页面下载
- havcs经历3次大更新（配置使用方法有变动），目前为havcs v3，使用教程[传送门][2]
- HA版本迭代较快，无法保证一一适配，进行功能更新会使用新版本HA进行测试
- 建议使用版本： 2021.5.4
## 更新日志
- 2021-05-26
  1. HA 2021.5.4版本测试
  2. 测试小度音箱平台定时任务逻辑有调整：之前是平台发送定时指令，由插件定时触发；现在是平台定时后发送控制指令
  3. 修复添加集成重复注册web菜单错误
  4. 集成设置增加ha_url设置（自动判断会优先读取旧版本.storage/core.config的ip配置导致不准确）
- 2020-10-19
  1. 增加fan类型设置模式指令支持（部分，不同平台模式的定义与插件的定义有差异）
- 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. 指令映射模式下，支持执行多条指令（设置方法有变化，请查看教程）
  2. 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. 根据[教程][3]调整插件的调试级别查看详细的运行日志
2. 配置好插件，启动HA，观看是否有mqtt连接成功信息（app技能接入方式）
3. 授权过程，观看是否有相关的处理日志
4. 说音响指令后，观看是否有相关的处理日志
5. web页面->开发者工具->服务->havcs.reload，观看是否生成设备信息
> WARN: 如需要帮助，请提供以上步骤相对应的日志信息方便定位原因。


[1]: https://github.com/cnk700i/havcs/releases "历史版本"
[2]: https://ljr.im/articles/plugins-havcs-edible-instructions/ "【插件】HAVCS食用说明"
[3]: https://ljr.im/articles/home-assistant-novice-question-set/#3-%E8%B0%83%E8%AF%95%E5%8F%8A%E6%9F%A5%E7%9C%8B%E7%A8%8B%E5%BA%8F%E8%BF%90%E8%A1%8C%E6%97%A5%E5%BF%97 "调试及查看程序运行日志"