From 5e4fffbce469ff040aa9923387ed5b9c2c1966e0 Mon Sep 17 00:00:00 2001 From: douboer Date: Wed, 11 Feb 2026 11:07:30 +0800 Subject: [PATCH] update at 2026-02-11 11:07:30 --- release.md | 87 +++++++++++++++++++++++++++--------------------------- 1 file changed, 43 insertions(+), 44 deletions(-) diff --git a/release.md b/release.md index c666d08..6ee0d44 100644 --- a/release.md +++ b/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 配置不一致时不切换（保护行为） +- 目标节点不可用时不切换（保护行为）