update at 2026-02-10 14:10:20

miniprogram/README.md

@@ -21,9 +21,10 @@ miniprogram/
 │   └── server.js               # 远端地址/端口/API 路径统一配置
 ├── utils/
 │   ├── core/                   # 纯算法模块
-│   └── mp/                     # 小程序 API 适配层
+│   └── mp/                     # 小程序 API 适配层（含 route-manager）
 ├── assets/fonts.json           # 字体清单（由脚本生成）
 ├── assets/default.json         # 首次加载默认配置（内容/颜色/字号/默认字体）
+├── assets/route-config.json    # 手动切换 A/B 服务器配置
 ├── app.js / app.json / app.wxss
 └── project.config.json
 ```
@@ -47,9 +48,30 @@ miniprogram/
 - `apiPrefix`: API 前缀（默认 `/api`）
 - `fontsManifestPath`: 字体清单路径（默认 `/miniprogram/assets/fonts.json`）
 - `defaultConfigPath`: 默认配置路径（默认 `/miniprogram/assets/default.json`）
+- `routeConfigPath`: 路由配置路径（默认 `/miniprogram/assets/route-config.json`）
 
 `app.js` 和 API 调用会自动使用该配置生成完整 URL。
 
+## 手动切换 A/B 服务器（无需发版）
+
+远端 `route-config.json`（A、B 都部署）示例：
+
+```json
+{
+  "active": "A",
+  "cooldownMinutes": 10,
+  "servers": {
+    "A": { "baseUrl": "https://fonts.biboer.cn" },
+    "B": { "baseUrl": "https://mac.biboer.cn" }
+  }
+}
+```
+
+- 冷启动时先读取当前服务器的 `route-config.json`。
+- 若发现 `active` 指向另一台服务器，会读取目标服务器配置做“双确认”。
+- 仅当目标服务器也返回相同 `active`，并且满足 `cooldownMinutes`，才切换。
+- 回前台会按 60 秒节流检查一次；API/配置请求失败时会触发一次兜底检查。
+
 ## 导出说明
 
 - `SVG`：受微信限制，`shareFileMessage` 需由单次点击直接触发，建议逐个字体导出。