<appbase>APK 15.20.22 release Publish.

- AlertDialog → Dialog + 自定义布局，绕过AlertController触摸干扰
- 添加 setCancelable(false) + setCanceledOnTouchOutside(false) 双重防护
- 移除DialogInterface.OnShowListener，改用按钮直接绑定OnClickListener

.gitignore

@@ -97,8 +97,9 @@ lint-results.html
 ## WinBoLL 基础应用(避免上传敏感配置)
 /winboll.properties
 /local.properties
-/settings.gradle
+#/settings.gradle
-/gradle.properties
+#/gradle.properties
 
 ## APPBase 项目配置
-
+aes/
+libaes/

.winboll/bashMergeProjects-to-Projects_Keeper_Tag.sh

@@ -0,0 +1,145 @@
+#!/system/bin/sh
+## 逻辑：按时间取最新标签 → 拉取该标签目录合并
+
+# 按创建时间取模块最新标签（最新打的标签排最后）
+get_latest_module_tag(){
+    local mod=$1
+    git for-each-ref --sort=-creatordate --format='%(refname)' refs/tags/${mod}-* \
+    | grep -v '\^{}' \
+    | head -1 \
+    | sed 's/refs\/tags\///'
+}
+
+# 通过标签获取commit
+get_commit_from_tag(){
+    local tag=$1
+    git rev-parse --short "${tag}^{commit}"
+}
+
+# 工作目录
+TARGET_DIR="/sdcard/AppProjects/Projects_Keeper_Tag"
+echo "进入目录：${TARGET_DIR}"
+cd "${TARGET_DIR}" || exit 1
+
+# 同步远程
+echo "========================================"
+echo "同步远程分支与全部版本标签"
+echo "========================================"
+git fetch origin --prune
+git fetch origin --tags
+echo "同步完成"
+echo ""
+
+# 校验目标分支
+NOW_BRANCH=$(git symbolic-ref --short HEAD)
+TARGET_BRANCH="projects_keeper_tag"
+if [ "${NOW_BRANCH}" != "${TARGET_BRANCH}" ];then
+    echo "错误：请先切换到 ${TARGET_BRANCH} 分支"
+    exit 1
+fi
+
+# 目录结构校验
+MERGE_OBJECTS_LIST=(
+.git
+.gitignore
+.gitmodules
+.winboll
+GenKeyStore
+LICENSE
+LICENSE-Private-Demo
+LICENSE-Private-Demo_docs
+README.md
+aes
+appbase
+autonfc
+build.gradle
+contacts
+debugtemp
+gallery
+gpsrelaysentinel
+gradle
+gradle.properties-android-demo
+gradle.properties-androidx-demo
+gradlew
+libaes
+libappbase
+libdebugtemp
+libgpsrelaysentinel
+libwinboll
+local.properties-demo
+mymessagemanager
+positions
+powerbell
+settings.gradle-demo
+winboll
+winboll.properties-demo
+)
+
+REAL_ITEMS=()
+while IFS= read -r line; do
+    [[ $line != "." && $line != ".." ]] && REAL_ITEMS+=("$line")
+done < <(ls -a)
+
+check_diff(){
+    local miss=() extra=()
+    for i in "${MERGE_OBJECTS_LIST[@]}";do
+        [[ ! " ${REAL_ITEMS[@]} " =~ " ${i} " ]] && miss+=("$i")
+    done
+    for i in "${REAL_ITEMS[@]}";do
+        [[ ! " ${MERGE_OBJECTS_LIST[@]} " =~ " ${i} " ]] && extra+=("$i")
+    done
+    if [[ ${#miss[@]} -gt 0 || ${#extra[@]} -gt 0 ]];then
+        echo "本地目录结构不一致，终止运行"
+        exit 1
+    fi
+}
+check_diff
+
+echo -e "#@@@ 按时间获取最新标签合并模块源码 @@@#"
+
+# 应用型模块
+MERGE_APP_PROJECT_LIST=(DemoAPP)
+echo -e "---------- 应用型模块 ----------"
+for name in "${MERGE_APP_PROJECT_LIST[@]}";do
+    low_name=$(echo "$name" | tr 'A-Z' 'a-z')
+    tag=$(get_latest_module_tag "${low_name}")
+    if [[ -z "${tag}" ]];then
+        echo "跳过 ${low_name}：无远程标签"
+        continue
+    fi
+    commit=$(get_commit_from_tag "${tag}")
+    if [[ -z "${commit}" ]];then
+        echo "跳过 ${low_name}：标签无有效提交点"
+        continue
+    fi
+    echo "模块:${low_name} 最新时间标签:${tag} 提交ID:${commit}"
+    # 强制拉取覆盖
+    git checkout -f "${tag}" -- "${low_name}"
+    git add "${low_name}"
+    git commit -m "合并模块${name} 同步最新时间标签${tag}"
+done
+
+# 类库模块
+MERGE_LIB_PROJECT_LIST=(WinBoLL APPBase AES)
+echo -e "---------- 类库模块 ----------"
+for name in "${MERGE_LIB_PROJECT_LIST[@]}";do
+    low_name=$(echo "$name" | tr 'A-Z' 'a-z')
+    tag=$(get_latest_module_tag "${low_name}")
+    if [[ -z "${tag}" ]];then
+        echo "跳过 ${low_name}：无远程标签"
+        continue
+    fi
+    commit=$(get_commit_from_tag "${tag}")
+    if [[ -z "${commit}" ]];then
+        echo "跳过 ${low_name}：标签无有效提交点"
+        continue
+    fi
+    echo "模块:${low_name} 最新时间标签:${tag} 提交ID:${commit}"
+    git checkout -f "${tag}" -- "${low_name}" "lib${low_name}"
+    git add "${low_name}" "lib${low_name}"
+    git commit -m "合并模块${name} 同步最新时间标签${tag}"
+done
+
+echo "全部模块合并执行完毕"
+echo "执行推送：git push"
+git push

README.md

@@ -103,3 +103,7 @@ $bash gradlew assembleStageRelease
 #### V<应用开发环境编号><应用功能变更号><应用调试阶段号> （示例： APPBase_15.7.0 ）
 ### ☆ Beta 渠道：
 #### V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)> （示例： APPBase_15.9.6-beta8_5413 ）
+
+#### 设置统一版本号，实现应用数据管理阶段性调整的坚实框架。
+#### 以版本号versionCode 1520000为开发起点，15.20基线产品可实现的产品阶段编号为1520000到1520999之间。
+#### 其中版本号000~999是应用数据管理架构的型号。与产品versionName “15.20.<产品编号>”其中的<产品编号>无关。

appbase/README.md

@@ -20,7 +20,7 @@ WinBoLL 安卓手机端安卓应用开发基础类库。
 
 1.  Fork 本仓库
 2.  新建 Feat_xxx 分支
-3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+3.  提交代码 : ZhanGSKen(ZhanGSKen<ZhanGSKen@QQ.COM>)
 4.  新建 Pull Request
 
 

appbase/build.gradle

@@ -26,7 +26,10 @@ android {
         applicationId "cc.winboll.studio.appbase"
         minSdkVersion 26
         targetSdkVersion 30
-        versionCode 1
+		//1. Android 官方规则
+		//-  versionCode  类型：int 整型
+		//- Java int 最大值：2147483647
+        versionCode 1520000
         // versionName 更新后需要手动设置 
         // .winboll/winbollBuildProps.properties 文件的 stageCount=0
         // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"

appbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Sun May 17 02:07:57 HKT 2026
+#Wed May 27 14:51:29 HKT 2026
-stageCount=11
+stageCount=23
 libraryProject=libappbase
 baseVersion=15.20
-publishVersion=15.20.10
+publishVersion=15.20.22
 buildCount=0
-baseBetaVersion=15.20.11
+baseBetaVersion=15.20.23

appbase/src/main/java/cc/winboll/studio/appbase/AboutActivity.java

@@ -37,7 +37,7 @@ public class AboutActivity extends Activity {
         appInfo.setAppName("APPBase");
         appInfo.setAppIcon(R.drawable.ic_winboll);
         appInfo.setAppDescription(getString(R.string.app_description));
-        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitName("APPBase");
         appInfo.setAppGitOwner("Studio");
         appInfo.setAppGitAPPBranch(branchName);
         appInfo.setAppGitAPPSubProjectFolder(branchName);

appbase/src/main/java/cc/winboll/studio/appbase/App.java

@@ -22,12 +22,6 @@ public class App extends GlobalApplication {
     @Override
     public void onCreate() {
         super.onCreate();
-		// 如果应用不在调试状态，就根据编译类型设置调试状态
-		if (isDebugging() != true) {
-			setIsDebugging(BuildConfig.DEBUG);
-		}
-		// release 版调试码
-		//setIsDebugging(!BuildConfig.DEBUG);
 		
         // 初始化 Toast 工具类（传入应用全局上下文，确保 Toast 可在任意地方调用）
         ToastUtils.init(getApplicationContext());

appbase/src/main/java/cc/winboll/studio/appbase/model/TestBean.java

@@ -2,8 +2,8 @@ package cc.winboll.studio.appbase.model;
 
 import android.util.JsonReader;
 import android.util.JsonWriter;
-import cc.winboll.studio.libappbase.BaseBean;
 import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.libs1520000.BaseBean;
 import java.io.IOException;
 
 /**

gradle.properties

@@ -0,0 +1,21 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx2048m
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app"s APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=false
+# Automatically convert third-party libraries to use AndroidX
+android.enableJetifier=false
+# 保持与旧版Gradle插件的兼容
+android.disableAutomaticComponentCreation=true

libappbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Sun May 17 02:07:57 HKT 2026
+#Wed May 27 14:51:29 HKT 2026
-stageCount=11
+stageCount=23
 libraryProject=libappbase
 baseVersion=15.20
-publishVersion=15.20.10
+publishVersion=15.20.22
 buildCount=0
-baseBetaVersion=15.20.11
+baseBetaVersion=15.20.23

libappbase/src/main/java/cc/winboll/studio/libappbase/APPModel.java

@@ -2,6 +2,7 @@ package cc.winboll.studio.libappbase;
 
 import android.util.JsonReader;
 import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.models.libs1520000.BaseBean;
 import java.io.IOException;
 
 /**

libappbase/src/main/java/cc/winboll/studio/libappbase/BaseBean.java

@@ -1,436 +0,0 @@
-package cc.winboll.studio.libappbase;
-
-import android.content.Context;
-import android.util.JsonReader;
-import android.util.JsonWriter;
-import java.io.File;
-import java.io.IOException;
-import java.io.StringReader;
-import java.io.StringWriter;
-import java.util.ArrayList;
-
-/**
- * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
- * @Date 2025/11/11 20:03
- * @Describe WinBoLL JSON 数据模型基类（抽象类）
- * 定义 Json Bean 的核心规范：序列化/反序列化、文件持久化、列表处理等通用逻辑，
- * 子类（如 APPModel）需实现抽象方法，实现自身字段的 JSON 读写
- * @param <T> 泛型约束，限定子类必须继承自 BaseBean
- */
-public abstract class BaseBean<T extends BaseBean> {
-
-	/** 日志标签，用于当前基类的日志输出标识 */
-	public static final String TAG = "BaseBean";
-	/** JSON 中存储 Bean 类名的字段键（用于校验 Bean 类型一致性） */
-	static final String BEAN_NAME = "BeanName";
-
-	/**
-	 * 无参构造方法（子类需默认实现，支持反射实例化）
-	 */
-	public BaseBean() {}
-
-	/**
-	 * 抽象方法：获取当前 Bean 的全限定类名
-	 * 子类需实现，用于标识 Bean 类型（序列化/校验时使用）
-	 * @return 类的全限定名（如：cc.winboll.studio.libappbase.APPModel）
-	 */
-	public abstract String getName();
-
-	/**
-	 * 获取单个 Bean 的 JSON 持久化文件路径
-	 * 路径：外部存储/应用私有目录/BaseBean/[类名].json
-	 * @param context 上下文（用于获取应用存储目录）
-	 * @return 单个 Bean 的文件绝对路径
-	 */
-	public String getBeanJsonFilePath(Context context) {
-		return context.getExternalFilesDir(TAG) + "/" + getName() + ".json";
-	}
-
-	/**
-	 * 获取 Bean 列表的 JSON 持久化文件路径
-	 * 路径：外部存储/应用私有目录/BaseBean/[类名]_List.json
-	 * @param context 上下文（用于获取应用存储目录）
-	 * @return Bean 列表的文件绝对路径
-	 */
-	public String getBeanListJsonFilePath(Context context) {
-		return context.getExternalFilesDir(TAG) + "/" + getName() + "_List.json";
-	}
-
-	/**
-	 * 将 Bean 类名写入 JSON（序列化基础字段）
-	 * 子类可重写扩展，添加自身字段的 JSON 写入逻辑
-	 * @param jsonWriter JSON 写入器（用于输出 JSON 数据）
-	 * @throws IOException JSON 写入失败时抛出（如流异常）
-	 */
-	public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
-		// 写入 Bean 类名字段（用于反序列化时校验类型）
-		jsonWriter.name(BEAN_NAME).value(getName());
-	}
-
-	/**
-	 * 从 JSON 读取字段并初始化 Bean（反序列化基础逻辑）
-	 * 子类需重写，实现自身字段的解析逻辑
-	 * @param jsonReader JSON 读取器（用于读取 JSON 数据）
-	 * @param name 当前解析的 JSON 字段名
-	 * @return true：字段解析成功（当前类处理）；false：字段未处理（需跳过）
-	 * @throws IOException JSON 读取失败时抛出（如流异常）
-	 */
-	public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
-		return false; // 基类未处理任何字段，返回 false
-	}
-
-	/**
-	 * 抽象方法：从 JSON 读取器解析并返回 Bean 实例
-	 * 子类需实现，处理自身字段的完整解析逻辑
-	 * @param jsonReader JSON 读取器（用于读取 JSON 数据）
-	 * @return 解析完成的 Bean 实例
-	 * @throws IOException JSON 读取失败时抛出（如流异常）
-	 */
-	abstract public T readBeanFromJsonReader(JsonReader jsonReader) throws IOException;
-
-	/**
-	 * 校验 JSON 文件中的 Bean 列表与目标类是否一致
-	 * 对比文件中每个 Bean 的类名与目标类名，返回不一致信息
-	 * @param szFilePath JSON 文件路径（存储 Bean 列表的文件）
-	 * @param clazz 目标 Bean 类（用于校验类型）
-	 * @return 空串：校验一致；非空串：不一致信息（总数/差异数）或异常信息
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> String checkIsTheSameBeanListAndFile(String szFilePath, Class<T> clazz) {
-		StringBuilder sbResult = new StringBuilder();
-		String szErrorInfo = "Check Is The Same Bean List And File Error : ";
-
-		try {
-			int sameCount = 0; // 类名匹配的 Bean 数量
-			int totalCount = 0; // 文件中 Bean 总数量
-
-			// 反射创建目标 Bean 实例（用于获取类名）
-			T beanTemp = clazz.newInstance();
-			String targetBeanName = beanTemp.getName();
-			// 读取文件中的 JSON 字符串
-			String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
-			StringReader stringReader = new StringReader(listJson);
-			JsonReader jsonReader = new JsonReader(stringReader);
-
-			jsonReader.beginArray(); // 开始解析 JSON 数组（Bean 列表）
-			while (jsonReader.hasNext()) {
-				totalCount++;
-				jsonReader.beginObject(); // 开始解析单个 Bean 对象
-				while (jsonReader.hasNext()) {
-					String name = jsonReader.nextName();
-					// 只校验 BEAN_NAME 字段，其他字段跳过
-					if (name.equals(BEAN_NAME)) {
-						// 对比当前 Bean 类名与目标类名
-						if (targetBeanName.equals(jsonReader.nextString())) {
-							sameCount++;
-						}
-					} else {
-						jsonReader.skipValue(); // 跳过非目标字段
-					}
-				}
-				jsonReader.endObject(); // 结束单个 Bean 对象解析
-			}
-			jsonReader.endArray(); // 结束 JSON 数组解析
-
-			// 生成校验结果
-			if (sameCount == totalCount) {
-				return ""; // 全部匹配，返回空串
-			} else {
-				// 部分不匹配，返回统计信息
-				sbResult.append("Total : ").append(totalCount)
-					.append(" Diff : ").append(totalCount - sameCount);
-			}
-		} catch (InstantiationException e) {
-			// 反射实例化失败（如无无参构造）
-			sbResult.append(szErrorInfo).append(e);
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		} catch (IllegalAccessException e) {
-			// 反射访问权限异常
-			sbResult.append(szErrorInfo).append(e);
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		} catch (IOException e) {
-			// 文件读取或 JSON 解析异常
-			sbResult.append(szErrorInfo).append(e);
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return sbResult.toString();
-	}
-
-	/**
-	 * 将 JSON 字符串解析为目标 Bean 实例
-	 * 通过反射创建 Bean 实例，调用子类解析逻辑完成初始化
-	 * @param szBean JSON 字符串（单个 Bean 的 JSON 数据）
-	 * @param clazz 目标 Bean 类（用于反射实例化）
-	 * @return 解析成功的 Bean 实例；失败返回 null
-	 * @throws IOException JSON 解析失败时抛出
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> T parseStringToBean(String szBean, Class<T> clazz) throws IOException {
-		StringReader stringReader = new StringReader(szBean);
-		JsonReader jsonReader = new JsonReader(stringReader);
-
-		try {
-			// 反射创建 Bean 实例
-			T beanTemp = clazz.newInstance();
-			// 调用子类解析方法，返回解析后的实例
-			return (T) beanTemp.readBeanFromJsonReader(jsonReader);
-		} catch (InstantiationException | IllegalAccessException e) {
-			// 反射异常日志记录
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return null;
-	}
-
-	/**
-	 * 将 JSON 字符串解析为 Bean 列表
-	 * 清空目标列表，将解析后的 Bean 逐个添加到列表中
-	 * @param szBeanList JSON 字符串（Bean 列表的 JSON 数组）
-	 * @param beanList 目标列表（存储解析后的 Bean）
-	 * @param clazz 目标 Bean 类（用于反射实例化）
-	 * @return true：解析成功；false：解析失败
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> boolean parseStringToBeanList(String szBeanList, ArrayList<T> beanList, Class<T> clazz) {
-		try {
-			// 初始化目标列表（为空则创建，非空则清空）
-			if (beanList == null) {
-				beanList = new ArrayList<T>();
-			} else {
-				beanList.clear();
-			}
-
-			StringReader stringReader = new StringReader(szBeanList);
-			JsonReader jsonReader = new JsonReader(stringReader);
-
-			jsonReader.beginArray(); // 开始解析 JSON 数组
-			while (jsonReader.hasNext()) {
-				// 反射创建 Bean 实例，解析并添加到列表
-				T beanTemp = clazz.newInstance();
-				T bean = (T) beanTemp.readBeanFromJsonReader(jsonReader);
-				if (bean != null) {
-					beanList.add(bean);
-				}
-			}
-			jsonReader.endArray(); // 结束 JSON 数组解析
-			return true;
-		} catch (InstantiationException | IllegalAccessException | IOException e) {
-			// 异常日志记录
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return false;
-	}
-
-	/**
-	 * 重写 toString()，将 Bean 序列化为格式化的 JSON 字符串
-	 * 调用自身序列化逻辑，生成带缩进的 JSON（便于调试）
-	 * @return Bean 的 JSON 字符串；失败返回空串
-	 */
-	@Override
-	public String toString() {
-		StringWriter stringWriter = new StringWriter();
-		JsonWriter jsonWriter = new JsonWriter(stringWriter);
-		jsonWriter.setIndent("  "); // 设置 JSON 缩进（格式化输出）
-
-		try {
-			jsonWriter.beginObject(); // 开始 JSON 对象
-			writeThisToJsonWriter(jsonWriter); // 写入 Bean 字段（子类扩展）
-			jsonWriter.endObject(); // 结束 JSON 对象
-			return stringWriter.toString();
-		} catch (IOException e) {
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return "";
-	}
-
-	/**
-	 * 将 Bean 列表序列化为格式化的 JSON 字符串
-	 * 遍历列表，逐个序列化每个 Bean，生成 JSON 数组
-	 * @param beanList 待序列化的 Bean 列表
-	 * @return 列表的 JSON 字符串；失败返回空串
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> String toStringByBeanList(ArrayList<T> beanList) {
-		try {
-			StringWriter stringWriter = new StringWriter();
-			JsonWriter jsonWriter = new JsonWriter(stringWriter);
-			jsonWriter.setIndent("  "); // 格式化缩进
-
-			jsonWriter.beginArray(); // 开始 JSON 数组
-			for (int i = 0; i < beanList.size(); i++) {
-				jsonWriter.beginObject(); // 单个 Bean 开始
-				beanList.get(i).writeThisToJsonWriter(jsonWriter); // 调用 Bean 自身序列化
-				jsonWriter.endObject(); // 单个 Bean 结束
-			}
-			jsonWriter.endArray(); // 结束 JSON 数组
-			jsonWriter.close();
-			return stringWriter.toString();
-		} catch (IOException e) {
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return "";
-	}
-
-	/**
-	 * 从默认路径（getBeanJsonFilePath）加载 Bean 实例
-	 * 读取应用私有目录下的 JSON 文件，解析为目标 Bean
-	 * @param context 上下文（用于获取文件路径）
-	 * @param clazz 目标 Bean 类（用于反射实例化）
-	 * @return 加载成功的 Bean 实例；失败返回 null
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> T loadBean(Context context, Class<T> clazz) {
-		try {
-			// 反射创建 Bean 实例，获取默认文件路径
-			T beanTemp = clazz.newInstance();
-			return loadBeanFromFile(beanTemp.getBeanJsonFilePath(context), clazz);
-		} catch (InstantiationException | IllegalAccessException e) {
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return null;
-	}
-
-	/**
-	 * 从指定文件路径加载 Bean 实例
-	 * 检查文件是否存在，存在则读取 JSON 并解析为目标 Bean
-	 * @param szFilePath 目标文件路径（存储 Bean 的 JSON 文件）
-	 * @param clazz 目标 Bean 类（用于反射实例化）
-	 * @return 加载成功的 Bean 实例；失败返回 null
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> T loadBeanFromFile(String szFilePath, Class<T> clazz) {
-		try {
-			File file = new File(szFilePath);
-			if (file.exists()) { // 检查文件是否存在
-				T beanTemp = clazz.newInstance();
-				// 读取文件 JSON 字符串，解析为 Bean
-				String json = UTF8FileUtils.readStringFromFile(szFilePath);
-				return beanTemp.parseStringToBean(json, clazz);
-			}
-		} catch (InstantiationException | IllegalAccessException | IOException e) {
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return null;
-	}
-
-	/**
-	 * 将 Bean 保存到默认路径（getBeanJsonFilePath）的文件中
-	 * 序列化 Bean 为 JSON，写入应用私有目录下的文件
-	 * @param context 上下文（用于获取文件路径）
-	 * @param bean 待保存的 Bean 实例
-	 * @return true：保存成功；false：保存失败
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> boolean saveBean(Context context, T bean) {
-		return saveBeanToFile(bean.getBeanJsonFilePath(context), bean);
-	}
-
-	/**
-	 * 将 Bean 保存到指定文件路径
-	 * 序列化 Bean 为 JSON 字符串，写入目标文件（覆盖原有内容）
-	 * @param szFilePath 目标文件路径（保存 JSON 的文件）
-	 * @param bean 待保存的 Bean 实例
-	 * @return true：保存成功；false：保存失败
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> boolean saveBeanToFile(String szFilePath, T bean) {
-		try {
-			// 序列化 Bean 为 JSON 字符串
-			String json = bean.toString();
-			// 写入文件（UTF-8 编码）
-			UTF8FileUtils.writeStringToFile(szFilePath, json);
-			return true;
-		} catch (IOException e) {
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return false;
-	}
-
-	/**
-	 * 从默认路径（getBeanListJsonFilePath）加载 Bean 列表
-	 * 读取应用私有目录下的列表 JSON 文件，解析并填充到目标列表
-	 * @param context 上下文（用于获取文件路径）
-	 * @param beanListDst 目标列表（存储加载后的 Bean）
-	 * @param clazz 目标 Bean 类（用于反射实例化）
-	 * @return true：加载成功；false：加载失败
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> boolean loadBeanList(Context context, ArrayList<T> beanListDst, Class<T> clazz) {
-		try {
-			// 反射创建 Bean 实例，获取默认列表文件路径
-			T beanTemp = clazz.newInstance();
-			return loadBeanListFromFile(beanTemp.getBeanListJsonFilePath(context), beanListDst, clazz);
-		} catch (InstantiationException | IllegalAccessException e) {
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return false;
-	}
-
-	/**
-	 * 从指定文件路径加载 Bean 列表
-	 * 检查文件是否存在，存在则读取 JSON 数组，解析并填充到目标列表
-	 * @param szFilePath 目标文件路径（存储列表 JSON 的文件）
-	 * @param beanList 目标列表（存储加载后的 Bean）
-	 * @param clazz 目标 Bean 类（用于反射实例化）
-	 * @return true：加载成功；false：加载失败
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> boolean loadBeanListFromFile(String szFilePath, ArrayList<T> beanList, Class<T> clazz) {
-		try {
-			File file = new File(szFilePath);
-			if (file.exists()) { // 检查文件是否存在
-				// 读取文件中的 JSON 字符串（Bean 列表数组）
-				String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
-				// 解析 JSON 字符串为 Bean 列表，填充到目标列表
-				return parseStringToBeanList(listJson, beanList, clazz);
-			}
-		} catch (IOException e) {
-			// 日志记录文件读取或解析异常
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return false;
-	}
-
-	/**
-	 * 将 Bean 列表保存到默认路径（getBeanListJsonFilePath）的文件中
-	 * 序列化列表为 JSON 数组，写入应用私有目录下的文件
-	 * @param context 上下文（用于获取文件路径）
-	 * @param beanList 待保存的 Bean 列表
-	 * @param clazz 目标 Bean 类（用于反射获取保存路径）
-	 * @return true：保存成功；false：保存失败
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> boolean saveBeanList(Context context, ArrayList<T> beanList, Class<T> clazz) {
-		try {
-			// 反射创建 Bean 实例，获取默认列表保存路径
-			T beanTemp = clazz.newInstance();
-			return saveBeanListToFile(beanTemp.getBeanListJsonFilePath(context), beanList);
-		} catch (InstantiationException | IllegalAccessException e) {
-			// 日志记录反射实例化异常
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return false;
-	}
-
-	/**
-	 * 将 Bean 列表保存到指定文件路径
-	 * 序列化列表为 JSON 数组字符串，写入目标文件（覆盖原有内容）
-	 * @param szFilePath 目标文件路径（保存列表 JSON 的文件）
-	 * @param beanList 待保存的 Bean 列表
-	 * @return true：保存成功；false：保存失败
-	 * @param <T> 泛型约束，限定为 BaseBean 子类
-	 */
-	public static <T extends BaseBean> boolean saveBeanListToFile(String szFilePath, ArrayList<T> beanList) {
-		try {
-			// 序列化 Bean 列表为 JSON 字符串（数组格式）
-			String json = toStringByBeanList(beanList);
-			// 将 JSON 字符串写入文件（UTF-8 编码）
-			UTF8FileUtils.writeStringToFile(szFilePath, json);
-			return true;
-		} catch (IOException e) {
-			// 日志记录文件写入或序列化异常
-			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-		}
-		return false;
-	}
-}
-

libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalApplication.java

@@ -129,11 +129,10 @@ public class GlobalApplication extends Application {
         // 初始化单例实例（确保在所有初始化操作前完成）
         sInstance = this;
 
+        restoreDebugStatus();
         // 初始化基础组件（日志、崩溃处理、Toast）
         initCoreComponents();
-        // 恢复/初始化调试模式状态（从本地文件读取，无文件则默认关闭调试）
+        // 初始化服务器地址（从 SP 读取到内存，提高后续访问效率）
-        restoreDebugStatus();
-        // 新增：初始化服务器地址（从 SP 读取到内存，提高后续访问效率）
         initWinbollHost();
 
         LogUtils.d(TAG, "GlobalApplication 初始化完成，单例实例已创建");
@@ -144,7 +143,11 @@ public class GlobalApplication extends Application {
      */
     private void initCoreComponents() {
         // 初始化日志工具（传入 Application 上下文）
+		
+		// 调试状态下初始化日志工具
+		if (GlobalApplication.isDebugging()) {
 			LogUtils.init(this);
+		}
         // 初始化全局异常处理器（捕获应用崩溃信息，用于调试或上报）
         CrashHandler.init(this);
         // 初始化 Toast 工具（统一 Toast 样式、避免内存泄漏等）

libappbase/src/main/java/cc/winboll/studio/libappbase/LogActivity.java

@@ -27,6 +27,11 @@ public class LogActivity extends Activity {
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
+		if(!GlobalApplication.isDebugging()) {
+			ToastUtils.show("非调试状态日志功能不可用");
+			finish();
+		}
+		
         // 设置布局文件（包含 LogView 控件）
         setContentView(R.layout.activity_log);
 

libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtils.java

@@ -71,14 +71,13 @@ public class LogUtils {
     }
 
     public static void init(final Context context, final LOG_LEVEL logLevel) {
+		if (!GlobalApplication.isDebugging()) {
+			return;
+		}
 		Log.d(TAG, "init 执行日志工具初始化");
 		_mContext = context;
 
-        if (GlobalApplication.isDebugging()) {
+		initLogUtilsDir();
-            initDebugDir();
-        } else {
-            initReleaseDir();
-        }
 
 		initLogConfigBean();
 		addClassTAGList();
@@ -86,26 +85,11 @@ public class LogUtils {
 		checkAndTrimLogFileSize();
 
 		_IsInited = true;
-        Log.d(TAG, "init 日志工具初始化完成");
+		Log.d(TAG, "init 执行日志工具初始化完成");
     }
 
     // ====================== 目录初始化 ======================
-    private static void initDebugDir() {
+    private static void initLogUtilsDir() {
-        final Context appContext = _mContext.getApplicationContext();
-        _mfLogCacheDir = new File(appContext.getExternalCacheDir(), TAG);
-        if (!_mfLogCacheDir.exists()) {
-            _mfLogCacheDir.mkdirs();
-        }
-        _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
-
-        _mfLogDataDir = appContext.getExternalFilesDir(TAG);
-        if (!_mfLogDataDir.exists()) {
-            _mfLogDataDir.mkdirs();
-        }
-        _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
-    }
-
-    private static void initReleaseDir() {
         final Context appContext = _mContext.getApplicationContext();
         _mfLogCacheDir = new File(appContext.getCacheDir(), TAG);
         if (!_mfLogCacheDir.exists()) {
@@ -113,7 +97,7 @@ public class LogUtils {
         }
         _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
 
-        _mfLogDataDir = new File(appContext.getFilesDir(), TAG);
+        _mfLogDataDir = appContext.getExternalFilesDir(TAG);
         if (!_mfLogDataDir.exists()) {
             _mfLogDataDir.mkdirs();
         }
@@ -136,7 +120,7 @@ public class LogUtils {
         }
 
 		final long KEEP_FILE_SIZE = 25000L; // ~25KB 确保剪贴板可完整复制
-        final long MAX_FILE_SIZE = 2*KEEP_FILE_SIZE;
+        final long MAX_FILE_SIZE = 2 * KEEP_FILE_SIZE;
         final long fileSize = _mfLogCatchFile.length();
 
         if (fileSize <= MAX_FILE_SIZE) {
@@ -266,6 +250,9 @@ public class LogUtils {
     }
 
     public static void setTAGListEnable(final String tag, final boolean isEnable) {
+        if (!_IsInited) {
+            return;
+        }
         final Iterator<Map.Entry<String, Boolean>> iterator = mapTAGList.entrySet().iterator();
         while (iterator.hasNext()) {
             final Map.Entry<String, Boolean> entry = iterator.next();
@@ -279,6 +266,9 @@ public class LogUtils {
     }
 
     public static void setALlTAGListEnable(final boolean isEnable) {
+        if (!_IsInited) {
+            return;
+        }
         for (final Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
             entry.setValue(isEnable);
         }
@@ -288,15 +278,22 @@ public class LogUtils {
 
     // ====================== 日志级别控制 ======================
     public static void setLogLevel(final LOG_LEVEL logLevel) {
+        if (_mLogUtilsBean == null) {
+            Log.d(TAG, "setLogLevel LogUtils未初始化，忽略设置日志级别");
+            return;
+        }
         _mLogUtilsBean.setLogLevel(logLevel);
         _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
     }
 
     public static LOG_LEVEL getLogLevel() {
-        return _mLogUtilsBean.getLogLevel();
+        return _mLogUtilsBean == null ?LOG_LEVEL.Off: _mLogUtilsBean.getLogLevel();
     }
 
     private static boolean isLoggable(final String tag, final LOG_LEVEL logLevel) {
+		if (!GlobalApplication.isDebugging()) {
+			return false;
+		}
         if (!_IsInited) {
             return false;
         }

libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsBean.java

@@ -2,6 +2,7 @@ package cc.winboll.studio.libappbase;
 
 import android.util.JsonReader;
 import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.models.libs1520000.BaseBean;
 import java.io.IOException;
 
 /**

libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsClassTAGBean.java

@@ -2,6 +2,7 @@ package cc.winboll.studio.libappbase;
 
 import android.util.JsonReader;
 import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.models.libs1520000.BaseBean;
 import java.io.IOException;
 
 /**

libappbase/src/main/java/cc/winboll/studio/libappbase/LogViewThread.java

@@ -1,6 +1,7 @@
 package cc.winboll.studio.libappbase;
 
 import android.os.FileObserver;
+import java.io.File;
 import java.lang.ref.WeakReference;
 
 /**
@@ -51,8 +52,15 @@ public class LogViewThread extends Thread {
      */
     @Override
     public void run() {
+		// 调试状态进行日志输出任务
+		if (GlobalApplication.isDebugging()) {
 			// 获取日志缓存目录路径（从 LogUtils 统一获取，确保路径一致性）
-        String logDirPath = LogUtils.getLogCacheDir().getPath();
+			File logDir = LogUtils.getLogCacheDir();
+			if (logDir == null) {
+				LogUtils.d(TAG, "日志缓存目录未初始化，线程退出");
+				return;
+			}
+			String logDirPath = logDir.getPath();
 			LogUtils.d(TAG, "启动日志文件监听，监听目录：" + logDirPath);
 
 			// 初始化日志文件监听器（监听目标目录的文件事件）
@@ -76,6 +84,7 @@ public class LogViewThread extends Thread {
 			mLogListener.stopWatching();
 			LogUtils.d(TAG, "日志文件监听已停止，线程退出");
 		}
+    }
 
     /**
      * 日志文件监听内部类（继承 FileObserver，监听目录下文件变化）

libappbase/src/main/java/cc/winboll/studio/libappbase/models/libs1520000/BaseBean.java

@@ -0,0 +1,415 @@
+package cc.winboll.studio.libappbase.models.libs1520000;
+
+import android.content.Context;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.UTF8FileUtils;
+import java.io.File;
+import java.io.IOException;
+import java.io.StringReader;
+import java.io.StringWriter;
+import java.util.ArrayList;
+
+/**
+ * WinBoLL JSON 数据模型基类（抽象类）
+ * 定义 Json Bean 的核心规范：序列化/反序列化、文件持久化、列表处理等通用逻辑，
+ * 子类需实现抽象方法，完成自身字段JSON读写业务逻辑
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026/05/19 22:33:00
+ * @EditTime 2026/05/19 23:15:48
+ * @param <T> 泛型约束，限定子类必须继承自BaseBean
+ */
+public abstract class BaseBean<T extends BaseBean> {
+
+    // ====================== 静态常量 ======================
+    /** 日志输出标识TAG */
+    public static final String TAG = "BaseBean";
+    /** JSON存储Bean类名字段Key，用于类型校验 */
+    static final String BEAN_NAME = "BeanName";
+
+    // ====================== 构造方法 ======================
+    /**
+     * 无参空构造，满足反射实例化要求
+     */
+    public BaseBean() {
+
+    }
+
+    // ====================== 抽象方法 ======================
+    /**
+     * 获取当前实体类全类名
+     * @return 全限定类名字符串
+     */
+    public abstract String getName();
+
+    /**
+     * 从JSON读取器解析构建实体对象
+     * @param jsonReader JSON读取流
+     * @return 解析完成实体对象
+     * @throws IOException IO读写异常
+     */
+    public abstract T readBeanFromJsonReader(final JsonReader jsonReader) throws IOException;
+
+    // ====================== 路径获取相关 ======================
+    /**
+     * 获取单个实体默认存储JSON文件路径
+     * @param context 应用上下文
+     * @return 文件绝对路径
+     */
+    public String getBeanJsonFilePath(final Context context) {
+        return context.getExternalFilesDir(TAG) + "/" + getName() + ".json";
+    }
+
+    /**
+     * 获取实体列表默认存储JSON文件路径
+     * @param context 应用上下文
+     * @return 文件绝对路径
+     */
+    public String getBeanListJsonFilePath(final Context context) {
+        return context.getExternalFilesDir(TAG) + "/" + getName() + "_List.json";
+    }
+
+    // ====================== JSON序列化基础方法 ======================
+    /**
+     * 写入基础Bean标识字段至JSON
+     * @param jsonWriter JSON写入流
+     * @throws IOException 写入异常
+     */
+    public void writeThisToJsonWriter(final JsonWriter jsonWriter) throws IOException {
+        jsonWriter.name(BEAN_NAME).value(getName());
+    }
+
+    /**
+     * 基类通用字段解析回调
+     * @param jsonReader JSON读取流
+     * @param name 字段名
+     * @return 是否完成当前字段解析
+     * @throws IOException 读取异常
+     */
+    public boolean initObjectsFromJsonReader(final JsonReader jsonReader, final String name) throws IOException {
+        return false;
+    }
+
+    // ====================== 实体字符串序列化 ======================
+    @Override
+    public String toString() {
+        LogUtils.d(TAG, "执行BaseBean实体转JSON字符串");
+        final StringWriter stringWriter = new StringWriter();
+        final JsonWriter jsonWriter = new JsonWriter(stringWriter);
+        jsonWriter.setIndent("  ");
+        try {
+            jsonWriter.beginObject();
+            writeThisToJsonWriter(jsonWriter);
+            jsonWriter.endObject();
+            return stringWriter.toString();
+        } catch (final IOException e) {
+            LogUtils.d(TAG, "实体转JSON字符串异常", Thread.currentThread().getStackTrace());
+        }
+        return "";
+    }
+
+    // ====================== 列表序列化工具 ======================
+    /**
+     * Bean列表转为格式化JSON数组字符串
+     * @param beanList 实体集合
+     * @param <T> 实体泛型
+     * @return JSON字符串
+     */
+    public static <T extends BaseBean> String toStringByBeanList(final ArrayList<T> beanList) {
+        LogUtils.d(TAG, "执行Bean列表序列化JSON操作");
+        try {
+            final StringWriter stringWriter = new StringWriter();
+            final JsonWriter jsonWriter = new JsonWriter(stringWriter);
+            jsonWriter.setIndent("  ");
+            jsonWriter.beginArray();
+            for (int i = 0; i < beanList.size(); i++) {
+                jsonWriter.beginObject();
+                beanList.get(i).writeThisToJsonWriter(jsonWriter);
+                jsonWriter.endObject();
+            }
+            jsonWriter.endArray();
+            jsonWriter.close();
+            return stringWriter.toString();
+        } catch (final IOException e) {
+            LogUtils.d(TAG, "列表序列化JSON异常", Thread.currentThread().getStackTrace());
+        }
+        return "";
+    }
+
+    // ====================== JSON字符串解析实体 ======================
+    /**
+     * JSON文本解析为单个实体对象
+     * @param szBean JSON文本
+     * @param clazz 实体Class字节码
+     * @param <T> 实体泛型
+     * @return 解析完成实体
+     * @throws IOException 解析IO异常
+     */
+    public static <T extends BaseBean> T parseStringToBean(final String szBean, final Class<T> clazz) throws IOException {
+        LogUtils.d(TAG, "进入字符串解析实体方法，目标Class：" + clazz.getSimpleName());
+        final StringReader stringReader = new StringReader(szBean);
+        final JsonReader jsonReader = new JsonReader(stringReader);
+        try {
+            final T beanTemp = clazz.newInstance();
+            return (T) beanTemp.readBeanFromJsonReader(jsonReader);
+        } catch (final InstantiationException e) {
+            LogUtils.d(TAG, "实体反射实例化失败(InstantiationException)", Thread.currentThread().getStackTrace());
+        } catch (final IllegalAccessException e) {
+            LogUtils.d(TAG, "实体反射权限访问失败(IllegalAccessException)", Thread.currentThread().getStackTrace());
+        }
+        return null;
+    }
+
+    /**
+     * JSON数组文本解析填充实体列表
+     * @param szBeanList JSON数组文本
+     * @param beanList 目标存储集合
+     * @param clazz 实体字节码
+     * @param <T> 实体泛型
+     * @return 解析结果
+     */
+    public static <T extends BaseBean> boolean parseStringToBeanList(final String szBeanList, ArrayList<T> beanList, final Class<T> clazz) {
+        LogUtils.d(TAG, "进入列表字符串解析方法");
+        try {
+            if (beanList == null) {
+                beanList = new ArrayList<T>();
+            } else {
+                beanList.clear();
+            }
+            final StringReader stringReader = new StringReader(szBeanList);
+            final JsonReader jsonReader = new JsonReader(stringReader);
+            jsonReader.beginArray();
+            while (jsonReader.hasNext()) {
+                final T beanTemp = clazz.newInstance();
+                final T bean = (T) beanTemp.readBeanFromJsonReader(jsonReader);
+                if (bean != null) {
+                    beanList.add(bean);
+                }
+            }
+            jsonReader.endArray();
+            return true;
+        } catch (final InstantiationException e) {
+            LogUtils.d(TAG, "列表解析反射实例化异常", Thread.currentThread().getStackTrace());
+        } catch (final IllegalAccessException e) {
+            LogUtils.d(TAG, "列表解析反射权限异常", Thread.currentThread().getStackTrace());
+        } catch (final IOException e) {
+            LogUtils.d(TAG, "列表解析JSON读写异常", Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }
+
+    // ====================== 文件加载实体 ======================
+    /**
+     * 从默认路径加载单个实体
+     * @param context 上下文
+     * @param clazz 实体字节码
+     * @param <T> 实体泛型
+     * @return 加载实体
+     */
+    public static <T extends BaseBean> T loadBean(final Context context, final Class<T> clazz) {
+        LogUtils.d(TAG, "执行默认路径加载实体数据");
+        try {
+            final T beanTemp = clazz.newInstance();
+            return loadBeanFromFile(beanTemp.getBeanJsonFilePath(context), clazz);
+        } catch (final InstantiationException e) {
+            LogUtils.d(TAG, "加载实体反射实例化失败", Thread.currentThread().getStackTrace());
+        } catch (final IllegalAccessException e) {
+            LogUtils.d(TAG, "加载实体反射权限失败", Thread.currentThread().getStackTrace());
+        }
+        return null;
+    }
+
+    /**
+     * 自定义文件路径加载单个实体
+     * @param szFilePath 文件路径
+     * @param clazz 实体字节码
+     * @param <T> 实体泛型
+     * @return 实体对象
+     */
+    public static <T extends BaseBean> T loadBeanFromFile(final String szFilePath, final Class<T> clazz) {
+        LogUtils.d(TAG, "指定路径加载实体，路径：" + szFilePath);
+        try {
+            final File file = new File(szFilePath);
+            if (file.exists()) {
+                final T beanTemp = clazz.newInstance();
+                final String json = UTF8FileUtils.readStringFromFile(szFilePath);
+                return beanTemp.parseStringToBean(json, clazz);
+            }
+        } catch (final InstantiationException e) {
+            LogUtils.d(TAG, "文件加载实体反射实例化异常", Thread.currentThread().getStackTrace());
+        } catch (final IllegalAccessException e) {
+            LogUtils.d(TAG, "文件加载实体反射权限异常", Thread.currentThread().getStackTrace());
+        } catch (final IOException e) {
+            LogUtils.d(TAG, "文件读取JSON数据异常", Thread.currentThread().getStackTrace());
+        }
+        return null;
+    }
+
+    /**
+     * 默认路径加载实体列表
+     * @param context 上下文
+     * @param beanListDst 目标集合
+     * @param clazz 实体字节码
+     * @param <T> 实体泛型
+     * @return 加载结果
+     */
+    public static <T extends BaseBean> boolean loadBeanList(final Context context, final ArrayList<T> beanListDst, final Class<T> clazz) {
+        LogUtils.d(TAG, "默认路径加载实体列表数据");
+        try {
+            final T beanTemp = clazz.newInstance();
+            return loadBeanListFromFile(beanTemp.getBeanListJsonFilePath(context), beanListDst, clazz);
+        } catch (final InstantiationException e) {
+            LogUtils.d(TAG, "列表加载反射实例化异常", Thread.currentThread().getStackTrace());
+        } catch (final IllegalAccessException e) {
+            LogUtils.d(TAG, "列表加载反射权限异常", Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }
+
+    /**
+     * 自定义路径加载实体列表
+     * @param szFilePath 文件路径
+     * @param beanList 目标集合
+     * @param clazz 实体字节码
+     * @param <T> 实体泛型
+     * @return 加载结果
+     */
+    public static <T extends BaseBean> boolean loadBeanListFromFile(final String szFilePath, final ArrayList<T> beanList, final Class<T> clazz) {
+        LogUtils.d(TAG, "指定路径加载实体列表，路径：" + szFilePath);
+        try {
+            final File file = new File(szFilePath);
+            if (file.exists()) {
+                final String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
+                return parseStringToBeanList(listJson, beanList, clazz);
+            }
+        } catch (final IOException e) {
+            LogUtils.d(TAG, "列表文件读取异常", Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }
+
+    // ====================== 实体数据保存文件 ======================
+    /**
+     * 默认路径保存单个实体
+     * @param context 上下文
+     * @param bean 待保存实体
+     * @param <T> 实体泛型
+     * @return 保存结果
+     */
+    public static <T extends BaseBean> boolean saveBean(final Context context, final T bean) {
+        return saveBeanToFile(bean.getBeanJsonFilePath(context), bean);
+    }
+
+    /**
+     * 自定义路径保存单个实体
+     * @param szFilePath 保存路径
+     * @param bean 待保存实体
+     * @param <T> 实体泛型
+     * @return 保存结果
+     */
+    public static <T extends BaseBean> boolean saveBeanToFile(final String szFilePath, final T bean) {
+        LogUtils.d(TAG, "执行实体数据写入文件操作");
+        try {
+            final String json = bean.toString();
+            UTF8FileUtils.writeStringToFile(szFilePath, json);
+            return true;
+        } catch (final IOException e) {
+            LogUtils.d(TAG, "实体写入文件异常", Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }
+
+    /**
+     * 默认路径保存实体列表
+     * @param context 上下文
+     * @param beanList 实体集合
+     * @param clazz 实体字节码
+     * @param <T> 实体泛型
+     * @return 保存结果
+     */
+    public static <T extends BaseBean> boolean saveBeanList(final Context context, final ArrayList<T> beanList, final Class<T> clazz) {
+        LogUtils.d(TAG, "默认路径保存实体列表数据");
+        try {
+            final T beanTemp = clazz.newInstance();
+            return saveBeanListToFile(beanTemp.getBeanListJsonFilePath(context), beanList);
+        } catch (final InstantiationException e) {
+            LogUtils.d(TAG, "列表保存反射实例化异常", Thread.currentThread().getStackTrace());
+        } catch (final IllegalAccessException e) {
+            LogUtils.d(TAG, "列表保存反射权限异常", Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }
+
+    /**
+     * 自定义路径保存实体列表
+     * @param szFilePath 保存路径
+     * @param beanList 实体集合
+     * @param <T> 实体泛型
+     * @return 保存结果
+     */
+    public static <T extends BaseBean> boolean saveBeanListToFile(final String szFilePath, final ArrayList<T> beanList) {
+        LogUtils.d(TAG, "指定路径保存实体列表数据");
+        try {
+            final String json = toStringByBeanList(beanList);
+            UTF8FileUtils.writeStringToFile(szFilePath, json);
+            return true;
+        } catch (final IOException e) {
+            LogUtils.d(TAG, "列表数据写入文件异常", Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }
+
+    // ====================== Bean类型一致性校验 ======================
+    /**
+     * 校验本地JSON列表内实体类型是否统一
+     * @param szFilePath 列表文件路径
+     * @param clazz 目标校验实体Class
+     * @param <T> 实体泛型
+     * @return 校验结果信息
+     */
+    public static <T extends BaseBean> String checkIsTheSameBeanListAndFile(final String szFilePath, final Class<T> clazz) {
+        final StringBuilder sbResult = new StringBuilder();
+        final String szErrorInfo = "Check Is The Same Bean List And File Error : ";
+        try {
+            int sameCount = 0;
+            int totalCount = 0;
+            final T beanTemp = clazz.newInstance();
+            final String targetBeanName = beanTemp.getName();
+            final String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
+            final StringReader stringReader = new StringReader(listJson);
+            final JsonReader jsonReader = new JsonReader(stringReader);
+            jsonReader.beginArray();
+            while (jsonReader.hasNext()) {
+                totalCount++;
+                jsonReader.beginObject();
+                while (jsonReader.hasNext()) {
+                    final String name = jsonReader.nextName();
+                    if (BEAN_NAME.equals(name)) {
+                        if (targetBeanName.equals(jsonReader.nextString())) {
+                            sameCount++;
+                        }
+                    } else {
+                        jsonReader.skipValue();
+                    }
+                }
+                jsonReader.endObject();
+            }
+            jsonReader.endArray();
+            if (sameCount != totalCount) {
+                sbResult.append("Total : ").append(totalCount).append(" Diff : ").append(totalCount - sameCount);
+            }
+        } catch (final InstantiationException e) {
+            sbResult.append(szErrorInfo).append(e);
+            LogUtils.d(TAG, "类型校验反射实例化异常", Thread.currentThread().getStackTrace());
+        } catch (final IllegalAccessException e) {
+            sbResult.append(szErrorInfo).append(e);
+            LogUtils.d(TAG, "类型校验反射权限异常", Thread.currentThread().getStackTrace());
+        } catch (final IOException e) {
+            sbResult.append(szErrorInfo).append(e);
+            LogUtils.d(TAG, "类型校验文件读取解析异常", Thread.currentThread().getStackTrace());
+        }
+        return sbResult.toString();
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/views/AboutView.java

@@ -1,6 +1,8 @@
 package cc.winboll.studio.libappbase.views;
 
+import android.app.AlertDialog;
 import android.content.Context;
+import android.content.DialogInterface;
 import android.content.Intent;
 import android.content.pm.PackageManager;
 import android.net.Uri;
@@ -12,6 +14,7 @@ import android.widget.ImageButton;
 import android.widget.ImageView;
 import android.widget.LinearLayout;
 import android.widget.TextView;
+import android.widget.Toast;
 import cc.winboll.studio.libappbase.GlobalApplication;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.R;
@@ -74,12 +77,12 @@ public class AboutView extends LinearLayout {
     private EditText metDevUserPassword;
 
     // ===================================== 页面视图控件 =====================================
-    private DebugSwitchImageView ivAppIcon;
+    private DebugSwitchInfoImageView ivAppIcon;
     private TextView tvAppNameVersion;
     private TextView tvAppDesc;
     private LinearLayout llFunctionContainer;
 	private ImageButton ibSebugStepOver;
-    private ImageButton ibSigngetDialog;
+    private ImageButton ibDebugUnlock;
     private ImageButton ibWinBoLLHostDialog;
 
     // ===================================== 构造方法（按参数从少到多排序） =====================================
@@ -193,12 +196,12 @@ public class AboutView extends LinearLayout {
 		llFunctionContainer = findViewById(R.id.ll_function_container);
 		// 功能按钮绑定
 		ibSebugStepOver = findViewById(R.id.ib_debug_step_over);
-		ibSigngetDialog = findViewById(R.id.ib_signgetdialog);
+		ibDebugUnlock = findViewById(R.id.ib_debug_unlock);
 		ibWinBoLLHostDialog = findViewById(R.id.ib_winbollhostdialog);
 
 		// 调试按钮统一只在调试模式显示
 		ibWinBoLLHostDialog.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
-		//ibSigngetDialog.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
+		//ibDebugUnlock.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
 		ibSebugStepOver.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
 
 		// 绑定按钮点击事件
@@ -310,6 +313,47 @@ public class AboutView extends LinearLayout {
         LogUtils.d(TAG, "initAboutPageView()：视图组装完成，功能项加载完毕");
     }
 
+    // ===================================== 调试解锁弹窗 =====================================
+    private void showDebugUnlockDialog() {
+        final AlertDialog dialog = new AlertDialog.Builder(mContext).create();
+        dialog.setTitle("应用调试解锁");
+        dialog.setCanceledOnTouchOutside(true);
+
+        final EditText etToken = new EditText(mContext);
+        etToken.setHint("请输入调试Token");
+        dialog.setView(etToken);
+
+        dialog.setButton(DialogInterface.BUTTON_POSITIVE, "调试解锁", (DialogInterface.OnClickListener) null);
+        dialog.setButton(DialogInterface.BUTTON_NEGATIVE, "关闭", (DialogInterface.OnClickListener) null);
+        dialog.setOnShowListener(new DialogInterface.OnShowListener() {
+            @Override
+            public void onShow(DialogInterface d) {
+                dialog.getButton(AlertDialog.BUTTON_POSITIVE).setOnClickListener(new View.OnClickListener() {
+                    @Override
+                    public void onClick(View v) {
+                        String inputToken = etToken.getText().toString().trim();
+                        String savedToken = DebugSwitchInfoImageView.getDebugToken();
+                        if (savedToken != null && savedToken.equals(inputToken)) {
+                            GlobalApplication.setIsDebugging(true);
+                            GlobalApplication.saveDebugStatus(GlobalApplication.getInstance());
+                            Toast.makeText(mContext, "调试解锁成功，重启应用后生效", Toast.LENGTH_SHORT).show();
+                        } else {
+                            Toast.makeText(mContext, "调试Token不匹配", Toast.LENGTH_SHORT).show();
+                            dialog.dismiss();
+                        }
+                    }
+                });
+                dialog.getButton(AlertDialog.BUTTON_NEGATIVE).setOnClickListener(new View.OnClickListener() {
+                    @Override
+                    public void onClick(View v) {
+                        dialog.dismiss();
+                    }
+                });
+            }
+        });
+        dialog.show();
+    }
+
     // ===================================== 内部工具/事件方法 =====================================
     /**
      * 绑定功能按钮点击事件，处理正版校验、调试地址配置弹窗唤起
@@ -335,6 +379,15 @@ public class AboutView extends LinearLayout {
 					new DebugHostDialog(mContext).show();
 				}
 			});
+
+        // 应用调试解锁按钮
+        ibDebugUnlock.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "ibDebugUnlock onClick：弹出调试解锁对话框");
+					showDebugUnlockDialog();
+				}
+			});
         LogUtils.d(TAG, "setBtnClickListener()：功能按钮点击事件绑定完成");
     }
 

libappbase/src/main/java/cc/winboll/studio/libappbase/views/DebugSwitchImageView.java

@@ -1,61 +0,0 @@
-package cc.winboll.studio.libappbase.views;
-
-import android.content.Context;
-import android.util.AttributeSet;
-import android.view.View;
-import android.widget.ImageView;
-import android.widget.Toast;
-import cc.winboll.studio.libappbase.GlobalApplication;
-
-/**
- * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
- * @Date 2026/04/06 19:32
- * @Describe 具有调试模式切换功能的应用Logo控件，连续点击10次弹出提示
- */
-public class DebugSwitchImageView extends ImageView {
-
-    public static final String TAG = "DebugSwitchImageView";
-
-    // 连续点击计数
-    private int mClickCount = 0;
-    // 目标点击次数
-    private static final int TARGET_CLICK_COUNT = 10;
-
-	public DebugSwitchImageView(Context context) {
-        super(context);
-        init();
-    }
-
-    public DebugSwitchImageView(Context context, AttributeSet attrs) {
-        super(context, attrs);
-        init();
-    }
-
-    public DebugSwitchImageView(Context context, AttributeSet attrs, int defStyleAttr) {
-        super(context, attrs, defStyleAttr);
-        init();
-    }
-
-    public DebugSwitchImageView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
-        super(context, attrs, defStyleAttr, defStyleRes);
-        init();
-    }
-
-    private void init() {
-        setOnClickListener(new OnClickListener() {
-				@Override
-				public void onClick(View v) {
-					mClickCount++;
-					if (mClickCount == TARGET_CLICK_COUNT) {
-						// 达到10次，弹出Toast
-						Toast.makeText(getContext(), "连续点击已达到10次，现在开启应用调试功能。", Toast.LENGTH_SHORT).show();
-						GlobalApplication.setIsDebugging(true);
-						GlobalApplication.saveDebugStatus(GlobalApplication.getInstance());
-						// 重置计数，可再次触发
-						mClickCount = 0;
-					}
-				}
-			});
-    }
-}
-

libappbase/src/main/java/cc/winboll/studio/libappbase/views/DebugSwitchInfoImageView.java

@@ -0,0 +1,127 @@
+package cc.winboll.studio.libappbase.views;
+
+import android.app.AlertDialog;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.SharedPreferences;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.ImageView;
+import java.util.UUID;
+import cc.winboll.studio.libappbase.GlobalApplication;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/04/06 19:32
+ * @Describe 应用Logo控件，连续点击6次弹出调试Token对话框，支持复制与重置
+ */
+public class DebugSwitchInfoImageView extends ImageView {
+
+    public static final String TAG = "DebugSwitchInfoImageView";
+
+    // 连续点击计数
+    private int mClickCount = 0;
+    // 目标点击次数
+    private static final int TARGET_CLICK_COUNT = 7;
+
+    private static String mDebugToken = null;
+    private static final String SP_DEBUG_TOKEN = "debug_token_prefs";
+    private static final String KEY_DEBUG_TOKEN = "debug_token";
+
+    public static String getDebugToken() {
+        if (mDebugToken != null) {
+            return mDebugToken;
+        }
+        Context context = GlobalApplication.getInstance();
+        if (context != null) {
+            SharedPreferences sp = context.getSharedPreferences(SP_DEBUG_TOKEN, Context.MODE_PRIVATE);
+            mDebugToken = sp.getString(KEY_DEBUG_TOKEN, null);
+            if (mDebugToken == null) {
+                mDebugToken = UUID.randomUUID().toString();
+                sp.edit().putString(KEY_DEBUG_TOKEN, mDebugToken).apply();
+            }
+        }
+        return mDebugToken;
+    }
+
+    public static void resetDebugToken() {
+        Context context = GlobalApplication.getInstance();
+        if (context != null) {
+            mDebugToken = UUID.randomUUID().toString();
+            SharedPreferences sp = context.getSharedPreferences(SP_DEBUG_TOKEN, Context.MODE_PRIVATE);
+            sp.edit().putString(KEY_DEBUG_TOKEN, mDebugToken).apply();
+        }
+    }
+
+    private void showDebugTokenDialog() {
+        final AlertDialog dialog = new AlertDialog.Builder(getContext()).create();
+        dialog.setTitle("调试Token");
+        dialog.setMessage(getDebugToken());
+        dialog.setCanceledOnTouchOutside(false);
+        dialog.setButton(DialogInterface.BUTTON_POSITIVE, "复制到剪贴板", (DialogInterface.OnClickListener) null);
+        dialog.setButton(DialogInterface.BUTTON_NEUTRAL, "重置", (DialogInterface.OnClickListener) null);
+        dialog.setButton(DialogInterface.BUTTON_NEGATIVE, "关闭", (DialogInterface.OnClickListener) null);
+        dialog.setOnShowListener(new DialogInterface.OnShowListener() {
+            @Override
+            public void onShow(DialogInterface d) {
+                dialog.getButton(AlertDialog.BUTTON_POSITIVE).setOnClickListener(new View.OnClickListener() {
+                    @Override
+                    public void onClick(View v) {
+                        ClipboardManager cm = (ClipboardManager) getContext().getSystemService(Context.CLIPBOARD_SERVICE);
+                        cm.setPrimaryClip(ClipData.newPlainText("DebugToken", getDebugToken()));
+                    }
+                });
+                dialog.getButton(AlertDialog.BUTTON_NEUTRAL).setOnClickListener(new View.OnClickListener() {
+                    @Override
+                    public void onClick(View v) {
+                        resetDebugToken();
+                        dialog.setMessage(getDebugToken());
+                    }
+                });
+                dialog.getButton(AlertDialog.BUTTON_NEGATIVE).setOnClickListener(new View.OnClickListener() {
+                    @Override
+                    public void onClick(View v) {
+                        dialog.dismiss();
+                    }
+                });
+            }
+        });
+        dialog.show();
+    }
+
+	public DebugSwitchInfoImageView(Context context) {
+        super(context);
+        init();
+    }
+
+    public DebugSwitchInfoImageView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+
+    public DebugSwitchInfoImageView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        init();
+    }
+
+    public DebugSwitchInfoImageView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        init();
+    }
+
+    private void init() {
+        setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					mClickCount++;
+					if (mClickCount >= TARGET_CLICK_COUNT) {
+						mClickCount = 0;
+						showDebugTokenDialog();
+					}
+				}
+			});
+    }
+}
+

libappbase/src/main/res/layout-night/layout_about_view.xml

@@ -15,7 +15,7 @@
 		android:paddingRight="16dp"
 		android:paddingBottom="16dp">
 
-		<cc.winboll.studio.libappbase.views.DebugSwitchImageView
+		<cc.winboll.studio.libappbase.views.DebugSwitchInfoImageView
 			android:id="@+id/iv_app_icon"
 			android:layout_width="48dp"
 			android:layout_height="48dp"
@@ -81,7 +81,8 @@
 				android:layout_width="48dp"
 				android:layout_height="48dp"
 				android:src="@drawable/ic_key"
-				android:id="@+id/ib_signgetdialog"
+				android:id="@+id/ib_debug_unlock"
+				android:contentDescription="应用调试解锁"
 				android:scaleType="fitCenter"
 				android:adjustViewBounds="true"
 				android:background="@null"/>

libappbase/src/main/res/layout/layout_about_view.xml

@@ -15,7 +15,7 @@
 		android:paddingRight="16dp"
 		android:paddingBottom="16dp">
 
-		<cc.winboll.studio.libappbase.views.DebugSwitchImageView
+		<cc.winboll.studio.libappbase.views.DebugSwitchInfoImageView
 			android:id="@+id/iv_app_icon"
 			android:layout_width="48dp"
 			android:layout_height="48dp"
@@ -81,7 +81,8 @@
 				android:layout_width="48dp"
 				android:layout_height="48dp"
 				android:src="@drawable/ic_key"
-				android:id="@+id/ib_signgetdialog"
+				android:id="@+id/ib_debug_unlock"
+				android:contentDescription="应用调试解锁"
 				android:scaleType="fitCenter"
 				android:adjustViewBounds="true"
 				android:background="@null"/>

libappbase/src/main/res/values/attrs.xml

@@ -60,4 +60,7 @@
     <!-- DebugLogStyle 应用调试日志样式属性 -->
     <attr name="debugTextColor" format="color"/>
 
+    <!-- 边框圆角属性 -->
+    <attr name="borderCornerRadius" format="dimension"/>
+
 </resources>

settings.gradle

@@ -0,0 +1,98 @@
+// AutoInstaller 项目编译设置
+//include ':autoinstaller'
+//rootProject.name = "autoinstaller"
+
+// MJ 项目编译设置
+//include ':mj'
+//rootProject.name = "mj"
+
+// PowerBell 项目编译设置
+//include ':powerbell'
+//rootProject.name = "powerbell"
+
+// APPBase 项目编译设置
+include ':appbase'
+include ':libappbase'
+rootProject.name = "appbase"
+
+// APPUtils 项目编译设置
+//include ':apputils'
+//include ':libapputils'
+//rootProject.name = "apputils"
+
+// JC 项目编译设置
+//include ':jc'
+//include ':libjc'
+//rootProject.name = "jc"
+
+// AES 项目编译设置
+//include ':aes'
+//include ':libaes'
+//rootProject.name = "aes"
+
+// Contacts 项目编译设置
+//include ':contacts'
+//rootProject.name = "contacts"
+
+// MyMessageManager 项目编译设置
+//include ':mymessagemanager'
+//rootProject.name = "mymessagemanager"
+
+// TimeStamp 项目编译设置
+//include ':timestamp'
+//rootProject.name = "timestamp"
+
+// AndroidDemo 项目编译设置
+//include ':androiddemo'
+//rootProject.name = "androiddemo"
+
+// AndroidXDemo 项目编译设置
+//include ':androidxdemo'
+//rootProject.name = "androidxdemo"
+
+// Ollama 项目编译设置
+//include ':ollama'
+//rootProject.name = "ollama"
+
+// NumTable 项目编译设置
+//include ':numtable'
+//rootProject.name = "numtable"
+
+// MidiPlayer 项目编译设置
+//include ':midiplayer'
+//rootProject.name = "midiplayer"
+
+// WebPageSources 项目编译设置
+//include ':webpagesources'
+//rootProject.name = "webpagesources"
+
+// Positions 项目编译设置
+//include ':positions'
+//rootProject.name = "positions"
+
+// WinBoLL 项目编译设置
+//include ':winboll'
+//include ':libwinboll'
+//rootProject.name = "winboll"
+
+// RegExpUtils 项目编译设置
+//include ':regexputils'
+//rootProject.name = "regexputils"
+
+// GPSRelaySentinel 项目编译设置
+//include ':gpsrelaysentinel'
+//include ':libgpsrelaysentinel'
+//rootProject.name = "gpsrelaysentinel"
+
+// Gallery 项目编译设置
+//include ':gallery'
+//rootProject.name = "gallery"
+
+// DebugTemp 项目编译设置
+//include ':debugtemp'
+//include ':libdebugtemp'
+//rootProject.name = "debugtemp"
+
+// AutoNFC 项目编译设置
+//include ':autonfc'
+//rootProject.name = "autonfc"