# SaaS 蓝牙添加设备上线记录 — 2026-09-21

已部署至 `https://82.157.201.114/customer/devices`，Web 版本为 `0.99.3-rc.ble1`，上一版本为 `0.99.2-rc.admin1`。

## 发布范围

- 家庭端“添加陪伴设备”移除绑定码模式，仅保留蓝牙发现。
- 添加流程调整为“搜索附近设备 → 选择并连接 → 发送 Wi-Fi 配网信息”。
- Web 蓝牙客户端改用与当前小程序和固件一致的 BLE 明文 v2 帧，不再要求设备标签编号、配网密码或 Security2 握手。
- 只叠加 5 个生产前端文件和 1 个回归测试文件；API、Worker、数据库与运行配置均未修改。

## 发布结果

- 当前目录：`/opt/data-terminal-cloud/releases/0.99.3-rc.ble1`
- Web 镜像：`data-terminal-cloud-web:0.99.3-rc.ble1`
- API 保持：`0.99.0-rc.portal1`
- JS：`/assets/index-BvMiW62U.js`
- CSS：`/assets/index-BE0QqIen.css`
- 发布包 SHA-256：`36b472b04341e2cab95ea4b7d35d93f2c1e2ffb85a09ad79b674a9cccd5919eb`

## 验证与回退

候选 TypeScript/Vite 构建和 BLE v2 回归测试通过。公网首页、设备页面、JS、CSS 摘要与候选一致；线上 JS 包含“搜索附近设备”和“发送配网信息”，不包含“绑定码添加”。Web 容器运行且重启次数为零；API、Worker、PostgreSQL、Redis、MinIO、Gateway、Callbacks、Keycloak 容器均未更换。

服务器发布目录保存 `ble-saas-release-manifest.json`。本地候选、发布包、部署脚本和线上清单位于 `.tmp-ble-saas-deploy/`。若需回退，使用上一版本完整 Compose 层只重建 Web，并重载 Gateway；不执行整栈 down，不修改数据库。