feat：养马岛对应的智念端分支

scripts/README-update-appid.md

@@ -1,6 +1,6 @@
 # 客户端配置切换脚本使用说明
 
-这个脚本用于在不同客户端配置之间快速切换，支持智念、朵花、天沐等多个客户端。
+这个脚本用于在不同客户端配置之间快速切换，支持智念、念念、智念助手、朵朵和沐沐。
 
 ## 主要功能
 
@@ -16,7 +16,7 @@
 ```json
 {
   "zhinian": {
-    "clientId": "2",
+    "clientId": "6",
     "appId": "wx5e79df5996572539",
     "name": "智念",
     "logo": "https://oss.nianxx.cn/mp/static/version_101/login/dh_logo.png"
@@ -24,13 +24,13 @@
   "duohua": {
     "clientId": "2",
     "appId": "wx23f86d809ae80259",
-    "name": "朵花",
+    "name": "朵朵",
     "logo": "https://oss.nianxx.cn/mp/static/version_101/login/dh_logo.png"
   },
   "tianmu": {
     "clientId": "4",
     "appId": "wx0be424e1d22065a9",
-    "name": "天沐",
+    "name": "沐沐",
     "logo": "https://oss.nianxx.cn/mp/static/version_101/login/tm_logo.png"
   }
 }
@@ -41,9 +41,12 @@
 | 客户端名称   | 显示名称 | AppID              |
 | ------------ | -------- | ------------------ |
 | `zhinian`    | 智念     | wx5e79df5996572539 |
-| `duohua`     | 朵花     | wx23f86d809ae80259 |
-| `tianmu`     | 天沐     | wx0be424e1d22065a9 |
-| `nianhelper` | 念念     | wx6fcf7b3db3deee6c |
+| `niannian`   | 念念     | wx5e79df5996572539 |
+| `duohua`     | 朵朵     | wx23f86d809ae80259 |
+| `tianmu`     | 沐沐     | wx0be424e1d22065a9 |
+| `nianhelper` | 智念助手 | wx6fcf7b3db3deee6c |
+
+AppID 以 `client-configs.json` 为准。当前念念与智念使用相同的 AppID；若念念使用独立小程序，请先修改 `niannian.appId`，再执行切换或构建命令。
 
 ## 使用方法
 
@@ -53,16 +56,34 @@
 # 切换到智念客户端
 npm run switch-client zhinian
 
-# 切换到念念助手客户端
+# 切换到念念客户端
+npm run switch-client -- niannian
+
+# 切换到智念助手客户端
 npm run switch-client nianhelper
 
-# 切换到朵花客户端
+# 切换到朵朵客户端
 npm run switch-client duohua
 
-# 切换到天沐客户端
+# 切换到沐沐客户端
 npm run switch-client tianmu
 ```
 
+### 念念端快捷命令
+
+```bash
+# 仅切换配置
+npm run switch-client:niannian
+
+# 切换到念念并启动微信小程序开发编译
+npm run dev:mp-weixin:niannian
+
+# 切换到念念并构建微信小程序生产包
+npm run build:mp-weixin:niannian
+```
+
+这些命令会修改工作区中的当前客户端配置；开发和构建命令仅在切换成功后继续执行。不同端请勿在同一工作区并行编译。
+
 ### 直接运行脚本
 
 ```bash
@@ -93,8 +114,10 @@ node scripts/update-appid.js tianmu
 3. **src/constant/base.js**
    - 更新 `getCurrentConfig()` 函数返回的客户端配置
 
-4. **client-configs.json**
-   - 统一的配置文件，所有客户端配置的单一数据源
+4. **src/uni.scss**
+   - 根据客户端的 `theme` 更新主题色变量
+
+`client-configs.json` 是读取的配置源，切换脚本不会修改它。
 
 ## 执行结果示例
 
@@ -102,12 +125,12 @@ node scripts/update-appid.js tianmu
 
 ```
 🚀 开始更新配置...
-🎯 检测到客户端配置: 天沐 (tianmu)
-目标客户端: 天沐 (tianmu)
+🎯 检测到客户端配置: 沐沐 (tianmu)
+目标客户端: 沐沐 (tianmu)
 目标appid: wx0be424e1d22065a9
 
 📝 正在更新 base.js...
-✅ base.js 更新成功，切换到 天沐 配置
+✅ base.js 更新成功，切换到 沐沐 配置
 📝 正在更新 manifest.json...
 ✅ manifest.json 更新成功
 📝 正在更新 project.config.json...
@@ -116,7 +139,7 @@ node scripts/update-appid.js tianmu
    新appid: wx0be424e1d22065a9
 
 🎉 所有文件更新完成！
-💡 已切换到 天沐 客户端配置
+💡 已切换到 沐沐 客户端配置
 💡 提示: 请检查文件内容确认更新正确
 ```
 
@@ -132,7 +155,7 @@ node scripts/update-appid.js tianmu
 
 ## 注意事项
 
-1. **配置同步**: 确保 `client-configs.json` 与 `src/constant/base.js` 中的基础配置保持同步
+1. **配置同步**: `src/constant/base.js` 自动读取 JSON 配置；新增端还需补齐 `ClientType` 和 `currentClientType()` 映射，确保各端登录缓存键相互独立
 2. **测试建议**: 切换配置后建议先进行测试，确认功能正常
 3. **备份建议**: 重要更新前建议备份相关配置文件
 
@@ -142,7 +165,7 @@ node scripts/update-appid.js tianmu
 A: 请确保在项目根目录执行脚本，并检查文件路径是否正确。
 
 **Q: 脚本提示不支持的客户端名称怎么办？**
-A: 请检查输入的客户端名称是否正确，支持的客户端名称有：zhinian、duohua、tianmu。
+A: 请检查输入的客户端名称是否正确，支持名称以 `client-configs.json` 的键为准，当前有：zhinian、niannian、nianhelper、duohua、tianmu。
 
 **Q: 如何恢复到之前的配置？**
 A: 可以使用版本控制系统恢复，或者再次运行脚本切换到其他客户端配置。
@@ -155,11 +178,19 @@ A: 在 `client-configs.json` 中添加新的客户端配置：
   "clientId": "客户端ID",
   "appId": "微信小程序AppID",
   "name": "客户端显示名称",
-  "logo": "@/pages/login/images/logo.png",
+  "logo": "@/pages/login/images/logo.png"
 }
 ```
 
-`src/constant/base.js` 会自动读取并处理新配置，无需手动修改。
+切换脚本会自动识别新配置。还需在 `src/constant/base.js` 中添加对应的 `ClientType` 和名称映射；如需切换主题色，在配置中添加与现有客户端相同结构的 `theme` 字段。最后运行 `npm run switch-client -- new_client` 应用配置。
 
 **Q: 脚本提示"读取配置文件失败"怎么办？**
 A: 检查 `client-configs.json` 文件是否存在且格式正确。
+
+## 验证客户端切换
+
+```bash
+node --test scripts/update-appid.test.cjs
+```
+
+测试在临时目录中切换五个客户端，检查配置、客户端类型、AppID 和主题色，不修改工作区当前配置。