update at 2026-02-11 11:07:30

This commit is contained in:
douboer
2026-02-11 11:07:30 +08:00
parent a582bf09a8
commit 5e4fffbce4

View File

@@ -1,48 +1,4 @@
# Release Notes # Release Notes
## v1.0.3
发布时间2026年2月10日
版本定位:小程序远端路由切换与多节点接入增强
### 里程碑与亮点
- 新增小程序“无发版切换后端”能力(基于远端 `route-config.json`
- 引入双确认切换策略,避免单点误配置导致错误跳转
- 增加 `cooldown` 防抖,防止 A/B 来回抖动
- 新增 Cloudflare Tunnel 入口域名支持(`mac-tunnel.biboer.cn`
### 核心变更
#### 小程序路由管理
- 新增 `route-manager`,负责:
- 启动时读取路由配置
- 回前台按节流规则检查路由
- 接口失败时触发兜底路由检查
- 路由状态本地持久化:`activeServerKey``lastSwitchAt``routeConfigCache``lastRouteCheckAt`
#### 切换规则
- 双确认:当前服务读取到目标为 `B` 时,必须继续读取 `B` 的配置并确认 `active=B` 才切换
- 防抖:`cooldownMinutes` 控制最短驻留时间,`0` 表示允许立即切换
- 读取失败保护:目标配置读取失败或非法时保持当前服务不变
#### 接入与运维
- 新增 `miniprogram/assets/route-config.json` 配置模板
- `scripts/deploy-fonts.sh` 支持同步 `route-config.json`
- `miniprogram/README.md``apiserver/README.md` 同步更新
- mac 侧新增 Tunnel 接入路径,支持 `mac-tunnel.biboer.cn` 对外服务
### 配置注意事项
- 小程序后台必须将目标域名加入 `request``downloadFile` 合法域名
- `route-config.json` 修改后建议清除本地 `route-state` 并冷启动验证
- `/healthz` 建议使用 `GET` 校验(`HEAD` 可能返回 `501`
### 验收项
- 可通过修改远端 `route-config.json` 在 A/B 节点间切换,无需重新发布小程序
- A/B 配置不一致时不切换(保护行为)
- 目标节点不可用时不切换(保护行为)
## v1.0.1 ## v1.0.1
发布时间2026年2月9日 发布时间2026年2月9日
版本定位:小程序 UI 优化与布局完善 版本定位:小程序 UI 优化与布局完善
@@ -132,3 +88,46 @@ miniprogram/
- 邮箱douboer@gmail.com - 邮箱douboer@gmail.com
- 仓库Issues - 仓库Issues
## v1.0.3
发布时间2026年2月10日
版本定位:小程序远端路由切换与多节点接入增强
### 里程碑与亮点
- 新增小程序“无发版切换后端”能力(基于远端 `route-config.json`
- 引入双确认切换策略,避免单点误配置导致错误跳转
- 增加 `cooldown` 防抖,防止 A/B 来回抖动
- 新增 Cloudflare Tunnel 入口域名支持(`mac-tunnel.biboer.cn`
### 核心变更
#### 小程序路由管理
- 新增 `route-manager`,负责:
- 启动时读取路由配置
- 回前台按节流规则检查路由
- 接口失败时触发兜底路由检查
- 路由状态本地持久化:`activeServerKey``lastSwitchAt``routeConfigCache``lastRouteCheckAt`
#### 切换规则
- 双确认:当前服务读取到目标为 `B` 时,必须继续读取 `B` 的配置并确认 `active=B` 才切换
- 防抖:`cooldownMinutes` 控制最短驻留时间,`0` 表示允许立即切换
- 读取失败保护:目标配置读取失败或非法时保持当前服务不变
#### 接入与运维
- 新增 `miniprogram/assets/route-config.json` 配置模板
- `scripts/deploy-fonts.sh` 支持同步 `route-config.json`
- `miniprogram/README.md``apiserver/README.md` 同步更新
- mac 侧新增 Tunnel 接入路径,支持 `mac-tunnel.biboer.cn` 对外服务
### 配置注意事项
- 小程序后台必须将目标域名加入 `request``downloadFile` 合法域名
- `route-config.json` 修改后建议清除本地 `route-state` 并冷启动验证
- `/healthz` 建议使用 `GET` 校验(`HEAD` 可能返回 `501`
### 验收项
- 可通过修改远端 `route-config.json` 在 A/B 节点间切换,无需重新发布小程序
- A/B 配置不一致时不切换(保护行为)
- 目标节点不可用时不切换(保护行为)