v0.6.2

Yutai BLE v0.6.2

本版本改进简体中文界面的型号选择、填写说明和错误提示，并把对应说明补充到 README。
已有设备配置、内部型号值和实体唯一 ID 保留，无需删除设备或重新扫码。

界面改进

• 添加页面的型号选择显示 禹泰电工计量版（fsov8m） 和
  禹泰电工普通版（WY-E802 / fsov7m），便于与扫码结果核对。
• 为设备名称、蓝牙地址、插座型号和蓝牙长期密钥增加填写说明，明确密钥需要
  64 个十六进制字符（32 字节）。
• 补充配置失败、轮询设置和设备操作失败的中文提示；英文界面仍有对应的英文翻译。
• README 增加中文名称与完整型号对照表、字段填写示例及更新后刷新界面的说明。

本次仅改进用户提示及型号选择控件。协议型号仍保存为 yutai.plug.fsov8m /
yutai.plug.fsov7m；BLE 控制、读回确认、排队、失败退避和禁止自动重发写入的行为保持一致。

如何更新

1. 在 HACS 中打开 Yutai BLE，执行 更新信息 → 重新下载，选择 v0.6.2。
   如果 HA 的“设置 → 更新”已出现该集成，直接安装更新即可。
2. 重启 Home Assistant。
3. 再次打开添加页面。若仍显示旧文案，刷新浏览器；确认当前 HA 用户使用简体中文。

手动安装者下载 yutai-ble-v0.6.2.zip，替换 custom_components/yutai_ble 后重启 HA。
已有设备不必重新添加。独立 Windows 扫码包随版本提供，本次没有改动其功能。

下载与校验

• yutai-ble-v0.6.2.zip：HA 组件。
• yutai-ble-qr-windows-v0.6.2.zip：独立 Windows 扫码工具。
• SHA256SUMS.txt：两个 ZIP 的 SHA-256 校验值。

发布由 Python 3.13 / 3.14 离线测试、Home Assistant 2026.10.4 框架检查和 Windows
启动器检查共同把关，上传后核对附件摘要。没有操作正在运行的 HA 或实际插座。

完整填写示例见 README。

v0.6.1

Yutai BLE v0.6.1

本版本修复 BLE 排队、失败诊断刷新和 Windows 扫码工具安装恢复问题。
已有设备配置和实体唯一 ID 保留，更新后重启 Home Assistant 即可，无需重新配对或扫码。

修复内容

• 多设备排队：后台轮询等待全局蓝牙连接队列时，可以为随后提交的手动命令让路，
  避免手动操作被自己设备的后台轮询阻塞。保留手动命令的先后顺序、断连冷却，
  不打断已经开始的蓝牙事务。
• 连续失败诊断：连续读取或控制失败后，继续更新失败次数和通信诊断，
  包括控制失败后的第一次轮询失败。设备仍保持不可用，不会因刷新诊断被误报为在线。
• Windows 扫码工具：启动前检查依赖；如果此前安装依赖失败但虚拟环境已创建，
  再次启动会重试安装，避免一直跳过安装步骤。

下载

文件	用途
yutai-ble-v0.6.1.zip	Home Assistant 组件，供手动安装或更新
yutai-ble-qr-windows-v0.6.1.zip	独立 Windows 扫码工具；已有 HA 配置无需使用
SHA256SUMS.txt	两个 ZIP 的 SHA-256 校验值
GitHub 自动提供的 Source code	完整源码，包括协议研究代码和测试

如何更新 HA

更新前保留 HA 备份。

• HACS 安装：打开 Yutai BLE，执行“更新信息（Update information）”，再选择
  “重新下载（Redownload）”并确认 v0.6.1；若“设置 → 更新”已出现该集成，直接安装即可。
• Marketplace 管理：在“设置 → 更新”中安装 Yutai BLE 更新。
• 手动安装：下载组件 ZIP，用其中的 custom_components/yutai_ble 替换 HA 中的同名目录。
  最终应有 /config/custom_components/yutai_ble/manifest.json。

安装后进入 设置 → 系统 → 右上角电源图标 → 重启 Home Assistant → 重启。
保留已有设备条目和 .storage。仅刷新浏览器或重新加载集成不能替代代码更新后的 HA 重启。
详细步骤见 安装、更新与维护。

验证与范围

• Python 3.13 / 3.14 CI 运行集成、协议、两组研究代码的离线回归测试，并构建安装包。
• Home Assistant 2026.10.4 的真实协调器测试验证连续失败通知。
• Windows CI 使用实际 cmd.exe 验证扫码工具依赖安装失败后的恢复。
• 发布流程在上述检查通过后校验安装包、上传附件并验证远端 SHA-256，再公开 Release。

继续支持禹泰普通版 yutai.plug.fsov7m 和计量版 yutai.plug.fsov8m。
炎米 Y1 仍为独立研究代码；本版本没有新增蓝牙代理、计时或电量统计能力。
本次验证未操作实际插座或正在运行的 HA，真实射频环境下的延迟和恢复表现仍需实机确认。

v0.6.0 - 手动操作优先与减少重复建连

Changes

• Prioritize manual commands over queued background polls, including requests from other devices. Manual commands retain FIFO order; active BLE transactions are not interrupted.
• Let manual commands interrupt a background read's retry wait or pre-connect cooldown.
• Reuse newer verified snapshots for overlapping queued refreshes and pending recovery reads to avoid unnecessary connections.
• Coalesce consecutive identical overlapping commands only after the preceding command succeeds. ON/OFF/ON and later explicit requests are preserved.
• Keep write readback, disconnect cleanup, cooldowns, and the no-automatic-write-retry rule.

Packages

• yutai-ble-v0.6.0.zip: Home Assistant integration. Existing HACS users can update and restart Home Assistant; no need to recreate device entries.
• yutai-ble-qr-windows-v0.6.0.zip: optional Windows QR authentication helper, unchanged in this release.
• SHA256SUMS.txt: package checksums.

Both Yutai fsov7m and fsov8m remain supported in HA. Wiing/Yanmi Y1 remains research-only. The repository source includes all three researched models.

Validation And Limits

410 offline tests passed. The integration import/API check passed on HA 2026.10.4. Actual hardware latency improvement and multi-device radio behavior have not been measured.

This reduces redundant transactions; it does not keep a persistent BLE connection or reuse cryptographic sessions. Each actual transaction still connects, authenticates, reads back and disconnects.

Back up Home Assistant before updating. This is an experimental custom integration, not an official HA integration or a default HACS repository.

v0.5.0 - 普通版与计量版禹泰均可添加到 HA

新增 yutai.plug.fsov7m 普通版的 HA 配置入口，不再仅限 fsov8m 计量版。普通版提供总开关、指示灯跟随/常灭、通电默认关/开/记忆和连接诊断；计量版原有能力保持不变。按型号分别解码并在 HA 边界再次校验，普通版不创建未经验证的计量、勿扰或双击控件。两款共用连接排队、断连退避和写入不自动重试保护。扫码密钥复制工具也支持两款。普通版的本地/循环定时仍保留为研究源码，未做成 HA 控件；炎米 Y1 仍为研究源码。本地 392 项离线测试通过，Python 3.13/3.14 CI 均通过；新 HA 路径和混合型号实物仍待验收。本次仅更新公开源码和安装包，没有升级或重启现有 HA，也未操作电器。使用旧版本者先备份，更新组件并重启 HA，再选择 fsov7m 添加普通版；已有实体 ID 和配置结构保持不变。

v0.4.0 - 三款插座源码与 HACS 安装包（实验版）

公开三款已测试插座的源码：禹泰计量版 yutai.plug.fsov8m 的 HA 集成；普通版 yutai.plug.fsov7m 的开关、设置、本地/循环定时研究源码；炎米 Y1 wiing.plug.v7icm 的鉴权、读取及空载开关恢复测试源码。当前 HACS 入口仅支持 fsov8m，另外两款尚未接成 HA 配置入口。Source code 下载包含三款全部源码；yutai-ble-v0.4.0.zip 是手动安装组件包；qr-windows 是独立扫码工具；SHA256SUMS.txt 提供校验值。本地 377 项离线测试通过，GitHub CI 在 Python 3.13/3.14 均通过。公开源码不含设备密钥、个人真实地址、私有备份或手机抓包。此版本多设备与打包版继电器操作仍待真机验收；本次未更新现有 HA、未操作电器。详见 README 和 docs/MODELS.md。