update at 2026-02-09 16:09:44

miniprogram/README.md

@@ -17,10 +17,13 @@ miniprogram/
 ├── pages/
 │   ├── index/                  # 首页：输入、预览、导出
 │   └── font-picker/            # 字体选择页
+├── config/
+│   └── server.js               # 远端地址/端口/API 路径统一配置
 ├── utils/
 │   ├── core/                   # 纯算法模块
 │   └── mp/                     # 小程序 API 适配层
 ├── assets/fonts.json           # 字体清单（由脚本生成）
+├── assets/default.json         # 首次加载默认配置（内容/颜色/字号/默认字体）
 ├── app.js / app.json / app.wxss
 └── project.config.json
 ```
@@ -34,6 +37,19 @@ miniprogram/
 5. Nginx 配置 `/api/` 反向代理到渲染服务。
 6. 编译运行。
 
+## 服务器配置（换服务器只改一处）
+
+修改 `miniprogram/config/server.js` 中的 `SERVER_CONFIG`：
+
+- `protocol`: `https` / `http`
+- `host`: 服务器域名
+- `port`: 端口（默认 443/80 可留空）
+- `apiPrefix`: API 前缀（默认 `/api`）
+- `fontsManifestPath`: 字体清单路径（默认 `/miniprogram/assets/fonts.json`）
+- `defaultConfigPath`: 默认配置路径（默认 `/miniprogram/assets/default.json`）
+
+`app.js` 和 API 调用会自动使用该配置生成完整 URL。
+
 ## 导出说明
 
 - `SVG`：受微信限制，`shareFileMessage` 需由单次点击直接触发，建议逐个字体导出。
@@ -50,6 +66,29 @@ miniprogram/
 
 如果 `path` 是相对路径（例如 `/fonts/a.ttf`），服务端会根据静态根目录拼接到实际文件路径。
 
+推荐部署结构：
+- 字体目录统一放在服务器根目录：`/fonts/`
+- Web 配置文件独立管理：`/fonts.json`（可选 `/default.json`）
+- 小程序配置文件独立管理：`/miniprogram/assets/fonts.json`、`/miniprogram/assets/default.json`
+
+## 首次默认配置（default.json）
+
+- 默认配置文件与 `fonts.json` 同目录：由 `config/server.js` 自动拼接（默认是 `https://fonts.biboer.cn/miniprogram/assets/default.json`）
+- 小程序会在首次加载时读取该配置（远端失败则回退本地 `miniprogram/assets/default.js`）
+- 配置只在首次加载生效，后续始终使用用户本地已保存配置（选择、收藏、颜色、字号、内容）
+
+示例：
+
+```json
+{
+  "inputText": "星程字体转换",
+  "fontSize": 50,
+  "textColor": "#dc2626",
+  "selectedFontIds": ["0001"],
+  "favoriteFontIds": ["0001"]
+}
+```
+
 ## 调试命令（仓库根目录）
 
 ```bash