feat: 添加使用脚本切换小程序的替换

2025-09-22 22:07:18 +08:00
parent 5975914e55
commit 4503e487f1
7 changed files with 521 additions and 66 deletions
--- a/scripts/README-update-appid.md
+++ b/scripts/README-update-appid.md
@@ -0,0 +1,173 @@
+# 客户端配置切换脚本使用说明
+
+这个脚本用于在不同客户端配置之间快速切换，支持智念、朵花、天沐等多个客户端。
+
+## 主要功能
+
+- 支持通过客户端名称切换配置
+- 自动更新相关配置文件
+- 统一的JSON配置文件管理
+- 完整的错误处理和验证
+
+## 配置文件结构
+
+配置文件位于项目根目录的 `client-configs.json`，包含所有客户端的完整配置信息：
+
+```json
+{
+  "zhinian": {
+    "clientId": "2",
+    "appId": "wx5e79df5996572539",
+    "name": "智念",
+    "placeholder": "快告诉智念您在想什么~",
+    "loginDesc": "您好，欢迎来到智念科技",
+    "logo": "@/pages/login/images/dh.png",
+    "subLogo": "@/pages/login/images/dhwq.png"
+  },
+  "duohua": {
+    "clientId": "2",
+    "appId": "wx23f86d809ae80259",
+    "name": "朵花",
+    "placeholder": "快告诉朵朵您在想什么~",
+    "loginDesc": "您好，欢迎来到朵花温泉",
+    "logo": "@/pages/login/images/dh.png",
+    "subLogo": "@/pages/login/images/dhwq.png"
+  },
+  "tianmu": {
+    "clientId": "4",
+    "appId": "wx0be424e1d22065a9",
+    "name": "天沐",
+    "placeholder": "快告诉沐沐您在想什么~",
+    "loginDesc": "您好，欢迎来到天沐温泉",
+    "logo": "@/pages/login/images/tm.png",
+    "subLogo": "@/pages/login/images/wsmm.png"
+  }
+}
+```
+
+## 支持的客户端
+
+| 客户端名称 | 显示名称 | AppID              |
+| ---------- | -------- | ------------------ |
+| `zhinian`  | 智念     | wx5e79df5996572539 |
+| `duohua`   | 朵花     | wx23f86d809ae80259 |
+| `tianmu`   | 天沐     | wx0be424e1d22065a9 |
+
+## 使用方法
+
+### 使用客户端名称切换
+
+```bash
+# 切换到天沐客户端
+npm run switch-client tianmu
+
+# 切换到智念客户端
+npm run switch-client zhinian
+
+# 切换到朵花客户端
+npm run switch-client duohua
+```
+
+### 直接运行脚本
+
+```bash
+# 使用客户端名称
+node scripts/update-appid.js tianmu
+```
+
+## AppID 信息
+
+微信小程序的 AppID 通常格式为：
+
+- 以 `wx` 开头
+- 后跟 16 位字符（数字和字母）
+- 总长度 18 位
+
+示例：`wx1234567890abcdef`
+
+## 更新的文件
+
+1. **src/manifest.json**
+
+   - 更新 `mp-weixin.appid` 字段
+   - 保持文件中的注释不变
+
+2. **project.config.json**
+
+   - 更新根级别的 `appid` 字段
+   - 保持 JSON 格式化
+
+3. **src/constant/base.js**
+   - 更新 `getCurrentConfig()` 函数返回的客户端配置
+
+4. **client-configs.json**
+   - 统一的配置文件，所有客户端配置的单一数据源
+
+## 执行结果示例
+
+### 使用客户端名称切换：
+
+```
+🚀 开始更新配置...
+🎯 检测到客户端配置: 天沐 (tianmu)
+目标客户端: 天沐 (tianmu)
+目标appid: wx0be424e1d22065a9
+
+📝 正在更新 base.js...
+✅ base.js 更新成功，切换到 天沐 配置
+📝 正在更新 manifest.json...
+✅ manifest.json 更新成功
+📝 正在更新 project.config.json...
+✅ project.config.json 更新成功
+   旧appid: wx5e79df5996572539
+   新appid: wx0be424e1d22065a9
+
+🎉 所有文件更新完成！
+💡 已切换到 天沐 客户端配置
+💡 提示: 请检查文件内容确认更新正确
+```
+
+## 错误处理
+
+脚本包含以下验证和错误处理：
+
+- 检查必需参数是否提供
+- 验证客户端名称是否有效
+- 检查目标文件是否存在
+- 捕获文件读写错误
+- 智能跳过不需要的更新
+
+## 注意事项
+
+1. **配置同步**: 确保 `client-configs.json` 与 `src/constant/client-config.js` 中的基础配置保持同步
+2. **测试建议**: 切换配置后建议先进行测试，确认功能正常
+3. **备份建议**: 重要更新前建议备份相关配置文件
+
+## 常见问题
+
+**Q: 脚本提示文件不存在怎么办？**
+A: 请确保在项目根目录执行脚本，并检查文件路径是否正确。
+
+**Q: 脚本提示不支持的客户端名称怎么办？**
+A: 请检查输入的客户端名称是否正确，支持的客户端名称有：zhinian、duohua、tianmu。
+
+**Q: 如何恢复到之前的配置？**
+A: 可以使用版本控制系统恢复，或者再次运行脚本切换到其他客户端配置。
+
+**Q: 如何添加新的客户端配置？**
+A: 在 `client-configs.json` 中添加新的客户端配置：
+   ```json
+   "new_client": {
+     "clientId": "客户端ID",
+     "appId": "微信小程序AppID",
+     "name": "客户端显示名称",
+     "placeholder": "输入框占位符文本",
+     "loginDesc": "登录页面描述文本",
+     "logo": "@/pages/login/images/logo.png",
+     "subLogo": "@/pages/login/images/sublogo.png"
+   }
+   ```
+   `src/constant/client-config.js` 会自动读取并处理新配置，无需手动修改。
+
+**Q: 脚本提示"读取配置文件失败"怎么办？**
+A: 检查 `client-configs.json` 文件是否存在且格式正确。