Releases: PraxiGEN/ha_workchat_connect
Releases · PraxiGEN/ha_workchat_connect
Release list
v1.1.4 - 小版本升级
Contributors
PraxiGEN
Assets 3
v1.1.3 - 小版本升级
说明
语音文件清理规则：
- 定时：凌晨 3:00
- 周期：每天
- 规则：文件最后修改时间
- 文件保留时间：3天
What's Changed
🐛 Bug Fixes / 问题修复
- fix:修复音频文件清理 by @hzonz in #12
Full Changelog: v1.1.2...v1.1.3
Contributors
PraxiGEN
Assets 3
v1.1.2 - 小版本升级
What's Changed
🐛 Bug Fixes / 问题修复
📝 Documentation / 文档
- 修正最低支持的HA版本 by @hzonz in #11
Full Changelog: v1.1.1...v1.1.2
Contributors
PraxiGEN
Assets 3
v1.1.1 - 小版本升级
What's Changed
✨ Features / 新功能
📝 Documentation / 文档
- 文档更新 by @hzonz in #4
Full Changelog: v1.1.0...v1.1.1
Contributors
PraxiGEN
Assets 3
v1.1.0 - 最新稳定版本
Description
说明：该版本，包含破坏性变更，为了集成正确工作，请重新添加集成。
很高兴，v1.1.0版本发布了，让我们来看看升级了什么：
- 新增：语音实体，自动下载语音文件并转换为 mp3 格式。
- 新增： PR ISSUES 提交模板，自动验证工程流程。
- 修复：翻译键中包含，大写，空格的问题。
- 增强：优化代码结构，健壮性升级。
What's Changed
✨ Features / 新功能
- 新增自动标签导入 by @hzonz in #3
🐛 Bug Fixes / 问题修复
- Fix:翻译键修复 by @hzonz in #2
Other Changes / 其他
- 结构性升级1.1.0 by @hzonz in #1
New Contributors
- @hzonz made their first contribution in #1
Full Changelog: v1.0.5...v1.1.0
Contributors
PraxiGEN
Assets 3
v1.0.5 - 企业微信回调验证修复与媒体上传优化更新
说明：
- 修复添加集成后，回调地址无法在企业微信验证通过的问题。
- 修复媒体上传报错的问题。
- 优化代码硬编码问题，逐步替换为英文，然后在翻译中汉化。
- 优化实体属性的中文翻译。
v1.0.4 - 全面架构升级与实体体系重构
说明：
核心架构重构 (Major Refactoring)
- 本次更新最核心的变化是引入了 DataUpdateCoordinator (数据协调器) 模式，实现了逻辑层与平台层的彻底解耦：
- api.py (底层通讯层)：专注于纯粹的 HTTP 通讯，管理 Access Token 的生命周期与自动重试机制，不涉及任何 HA 实体逻辑。
- coordinator.py (逻辑协调层)：作为集成的“大脑”，统一管理设备信息（DeviceInfo）、全局状态数据、Webhook 回调分发以及主动消息发送逻辑。
- views.py (网络视图层)：独立处理企微 Webhook 校验与消息接收，提供增强的 HTML 可视化诊断页面。
实体平台优化 (Entity Enhancements)
- 所有的传感器和通知服务均已适配最新的描述符驱动 (Description-driven) 模式：
- 统一设备管理：所有传感器和通知实体现在都统一归类在同一个“企微应用”设备下，支持在 UI 中一键跳转企微后台配置页。
- 全量描述符化：sensor.py 和 notify.py 均使用 EntityDescription 定义，确保了 Entity ID 后缀生成（如 _callback_info）与 多语言翻译 (Translation Key) 的完美兼容。
- 实体化通知 (Notify Entity)：适配 HA 最新规范，将传统的 notify 服务升级为实体类平台，支持更多的实体属性和状态显示。
健壮性与安全性提升
- Token 自动容错：在检测到 API 返回 40014（Token 失效）时，集成会自动触发静默刷新并重试当前任务，用户无感知。
- 防御性编程：增强了集成启动阶段的空数据保护。在网络不稳定或 API 尚未返回数据时，实体会安全地显示为“断开”或“未知”，防止整个集成崩溃。
- 常量化管理：通过 const.py 统一管理所有 API 路径和消息类型，彻底杜绝了代码中的硬编码字符串，降低了维护成本。
- 高性能加解密：AES 加解密和文件 IO 操作全部通过 async_add_executor_job 放入线程池执行，确保不阻塞 HA 主循环。
v1.0.3 - 修复实体ID生成问题
说明：
- 修复传感器实体ID生成错误的问题。
- 修复通知实体ID生成问题，修复实体名称翻译问题。
v1.0.2 - 支持 UI 重新配置
说明：
🛠️ 新增功能：
- 支持 UI 重新配置 (Reconfigure)：适配 HA 2024.x 后的新特性。当企业 Secret 过期或回调 URL 变更时，用户可以直接在集成选项菜单中选择“重新配置”，无需删除并重新添加集成，完美保留现有实体的历史数据。
v1.0.1 - 新增 web 状态诊断页
说明：
🛠️ 新增功能：Web 状态诊断页 (Diagnostic Web Page)
- 可视化 Webhook 验证：现在直接在浏览器访问你的 Webhook 回调地址，即可进入实时诊断页面。
- 即时诊断：支持实时检测 Access Token 有效性、显示 Agent ID 及其外部访问 URL。
- 通信追踪：新增“最后收信时间”记录，帮助你精准判断内网穿透或企微后台配置是否生效。