Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5e4fffbce4 |
87
release.md
87
release.md
@@ -1,48 +1,4 @@
|
||||
# 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
|
||||
发布时间:2026年2月9日
|
||||
版本定位:小程序 UI 优化与布局完善
|
||||
@@ -132,3 +88,46 @@ miniprogram/
|
||||
|
||||
- 邮箱:douboer@gmail.com
|
||||
- 仓库: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 配置不一致时不切换(保护行为)
|
||||
- 目标节点不可用时不切换(保护行为)
|
||||
|
||||
Reference in New Issue
Block a user