恢复winboll项目文件为当前origin/winboll分支最新提交版

将 import 从 cc.winboll.studio.libaes 修正为
cc.winboll.studio.libappbase，与布局文件保持一致，
修复打开应用介绍窗口时的 ClassCastException。

.gitignore

@@ -97,9 +97,5 @@ lint-results.html
 ## WinBoLL 基础应用(避免上传敏感配置)
 /winboll.properties
 /local.properties
-
-## WinBoLL 衍生应用，
-## 外派类型类库应用需要注释掉以下部分，以便部署通用类库编译配置。
-## APPBase,AES需要上传以下两种配置。
-#/settings.gradle
-#/gradle.properties
+/settings.gradle
+/gradle.properties

.winboll/winboll_app_build.gradle

@@ -66,8 +66,8 @@ android {
     }
 	
 	compileOptions {
-        sourceCompatibility JavaVersion.VERSION_11
-        targetCompatibility JavaVersion.VERSION_11
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
     }
 
     // 应用包输出配置
@@ -101,12 +101,15 @@ android {
             
             // 创建 WinBoLL Studio 发布接口文件夹
             File fWinBoLLStudioDir = file("/sdcard/WinBoLLStudio/APKs");
+			// 如果配置了APK接口文件夹路径，就设置应用APK输出文件夹为接口文件夹。
+			if(winbollProps != null && winbollProps['APKOutputPath'] != null ) {
+                fWinBoLLStudioDir = file(winbollProps['APKOutputPath']);
+			}
+			
             if(!fWinBoLLStudioDir.exists()) {
-                //fWinBoLLStudioDir.mkdirs();
-                // 如果没有发布接口文件就不用进行APK发布和源码管理操作
-                // 当前编译环境不是 WinBoLL 主机, 以下将忽略APK发布和源码管理操作。
-                println 'The current compilation environment is not in WinBoLL host, and the following APK publishing and source management operations will be ignore.'
-            } else {
+                println "[ WinBoLLStudio ] : " + fWinBoLLStudioDir.getAbsolutePath() + " Folder does not exist."
+                println '[ WinBoLLStudio ] : The APKOutputPath property is not defined in winboll.properties, please configure APK output folder first.'
+			} else {
                 /// WINBOLL 主机的 APK 发布和源码管理操作 ///
                 variant.getAssembleProvider().get().doFirst {
                     /* 后期管理预留代码 */

README.md

@@ -1,175 +1,105 @@
-## OriginMaster
-【OriginMaster】WinBoLL 源生态计划。正如话，我需要一个 Point, 去撬动成个地球。
-WinBoLL系列项目各个项目源码合并推送方向：
-WinBoLL=>APPBase=>OriginMaster
-WinBoLL=>AES=>OriginMaster
-WinBoLL=>PowerBell=>OriginMaster
-WinBoLL=>Positions=>OriginMaster
-仓库规划概述：
-☆ WinBoLL,APPBase,AES,PowerBell与Positions都是开发库。
-☆ OriginMaster 是分支汇总存档库。
-☆ OriginMaster 不适宜作为开发库克隆使用，不是应用开发基础库，而是汇总资料库。
-☆ WinBoLL 库可以作为应用开发的基础继承模板。
+# WinBoLL 源生态计划项目说明书
 
-########
-## ☁ ☁ ☁ WinBoLL APP ☁ ☁ ☁ ☁ ☁ ☁   ☁ ☁   ☁  ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁ ☁ ☁ 
-# ☁    ☁ WinBoLL Studio Android 应用开源项目。☁ ☁   ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁ ☁  ☁ ☁ 
-# ☁ ☁ ☁ WinBoLL 网站地址 https://www.winboll.cc/ ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
-# ☁ ☁ ☁ WinBoLL 源码地址 <https://gitea.winboll.cc/Studio/WinBoLL.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁
-# ☁ ☁ ☁ GitHub 源码地址 <https://github.com/ZhanGSKen/WinBoLL.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
-# ☁ ☁ ☁ 码云 源码地址 <https://gitee.com/zhangsken/winboll.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
-# ☁ ☁ ☁ 在 jitpack.io 托管的 APPBase 类库源码<https://github.com/ZhanGSKen/APPBase.git> ☁ ☁ ☁ ☁  
-# ☁ ☁ ☁ 在 jitpack.io 托管的 AES 类库源码<https://github.com/ZhanGSKen/AES.git> ☁ ☁ ☁ ☁  
-## WinBoLL 提问
-同样是 /sdcard 目录，在开发 Android 应用时，
-能否实现手机编译与电脑编译的源码同步。
-☁因而 WinBoLL 项目组诞生了。
+## 一、项目概述
 
-## WinBoLL 项目组研发计划
-致力于把 WinBoLL-APP 应用在手机端 Android 项目开发。
-也在探索 https://gitea.winboll.cc/<WinBoLL 项目组>/APP.git 应用于 WinBoLL-APP APK 分发。
-更想进阶 https://github.com/<WinBoLL 项目组>/APP.git 应用于 WinBoLL-APP Beta APK 分发。
+### 1. 核心定位
+WinBoLL 手机源码计划，旨在通过核心项目 WinBoLL 构建手机端与服务器端的 Android 项目的开发源码生态。实现手机与服务器的源码的联合开发。
 
-## WinBoLL-APP 汗下...
-#### ☁应用何置如此呢。且观用户云云。
+### 2. 仓库架构
+#### **仓库类型：功能说明**
+☆ 基础项目分支 WinBoLL：手机端安卓应用开发基础模板。
+☆ 应用项目分支 APPBase、AES、PowerBell、Positions**：安卓应用单一管理系列项目。
+☆ 源码汇总管理 OriginMaster**：各类分支源码合并存档，不适宜作为开发库使用。
 
-#### ☁ 正当下 ☁ ###
-#### ☁ 且容傻家叙说 ☁ WinBoLL-APP 应用场景
-### ☁ WinBoLL 设备资源概述
-#### ☁ 1. Raid Disk.
-概述：这是一个矩阵存储类设备。
-优点：该设备具有数据容错存储功能，
-     数据存储具有特长持久性。
-缺点：设备使用能源消耗比较高，
-     设备存取速度一般。
-     
-#### ☁ 2. Data Disk.
-概述：这是一个普通硬盘存储设备
-优点：该设备独立于操作系统，
-     数据持久性一般，
-     存取能源消耗小于 Raid Disk。
-缺点：数据存储速度一般，存储能源消耗一般。
+### 3. 源码合并管理推送路线图
+⚠️ **注意**：仅仅展示不同应用模块源码的综合管理路线。分支合并操作时，必须具备 Git 管理经验。
 
-#### ☁ 3. SSD Disk.
-概述：这是一个 SSD 硬盘存储设备。
-优点：存取速度快于 Data Disk 与 Raid Disk，
-     存取能源消耗小于 Data Disk 与 Raid Disk。
-缺点：数据持久性一般，
-     设备位于操作系统内部文件系统。
-     数据持久性与操作系统挂钩。
-     
-#### ☁ 4. WinBoLL 用户资源概述。
-1> /home/<用户名> 位于 WinBoLL 操作系统目录下。
-2> /rdisk/<用户名> 挂载用户 Raid Disk.
-3> /data/<用户名> 挂载用户 Data Disk.
-4> /sdcard/<用户名> 挂载用户 SSD Disk.
+★ WinBoLL → APPBase → OriginMaster
+★ WinBoLL → AES → OriginMaster
+★ WinBoLL → PowerBell → OriginMaster
+★ WinBoLL → Positions → OriginMaster
 
-#### ☁ 5. WinBoLL-APP 用户资源概述。
-1> /sdcard 挂载用户手机 SD 存储/storage/emulated/0
+## 二、WinBoLL 项目核心信息
 
-### ☁ 稍稍歇 ☁ ###
-### ☁ 急急停 ☁ WinBoLL 应用前置条件
-☁ WinBoLL 主机建立 1Panel MySQL 应用。
-☁ WinBoLL 主机建立 1Panel Gitea 应用。
-☁ WinBoLL 主机设置 WinBoLL 应用为非登录状态。
-☁ WinBoLL 主机建立 WinBoLL 账户与 WinBoLL 用户组。
-☁ WinBoLL 账户 User ID 为： J。
-☁ WinBoLL 用户组 Group ID 为： Studio。
-☁ WinBoLL 主机 WinBoLL 1Panel Gitea 建立 WinBoLL 工作组。
-☁ WinBoLL 主机 WinBoLL 1Panel Gitea 用户项目 APK 编译输出目录为 /sdcard/WinBoLLStudio/<用户名>/APKs/
-☁ WinBoLL 项目配置文件示例为 "<WinBoLL 项目根目录>/.winboll/winboll.properties-demo"(WinBoLL 项目已设置)
-☁ WinBoLL 项目配置文件为 "<WinBoLL 项目根目录>/.winboll/winboll.properties"
-☁ WinBoLL 项目配置文件设定为源码提交时忽略。(WinBoLL 项目已设置)
-☁ Gradle 项目配置文件示例为 "<WinBoLL 项目根目录>/.winboll/local.properties-demo"(WinBoLL 项目已设置)
-☁ Gradle 项目配置文件为 "<WinBoLL 项目根目录>/local.properties"(WinBoLL 项目已设置)
-☁ Gradle 项目配置文件设定为源码提交时忽略。(WinBoLL 项目已设置)
+### 1. 项目简介
+☆ WinBoLL 项目是为手机端开发Android 项目的需求而设计的项目。
 
-### ☁ 登高处 ☁ WinBoLL 应用需求规划
-☁ WinBoLL 主机建立 WinBoLL 客户端用户数据库为 MySQL winbollclient 数据库。
-☁ WinBoLL 主机设置 WinBoLL 客户端用户信息存储在 winbollclient 数据库中。
-☁ MySQL winbollclient 数据库中
-   WinBoLL 客户端用户信息设定为：
-   <用户名, 验证密码, 验证邮箱, 验证手机, 唯一存储令牌Token, 备用验证邮箱>。
-☁ WinBoLL 项目源码仓库托管在 WinBoLL 1Panel Gitea 目录 /opt/1panel/apps/gitea/gitea/data/git/repositories/studio/app.git中。
-☁ WinBoLL 主机提供 WinBoLL 1Panel Gitea 应用的 WinBoLL 项目源码仓库存取功能。（Gitea 应用已提供）
-☁ WinBoLL 主机提供 WinBoLL Gitea 项目仓库存档功能。（Gitea 应用已提供）
-☁ 提供 WinBoLL 客户端用户登录功能。（Gitea 应用已提供）
+### 2. 官方资源
+#### ☆ 官方网站**：https://www.winboll.cc/
+#### ☆ 源码地址：
+★ Gitea：https://gitea.winboll.cc/Studio/WinBoLL.git
+★ GitHub：https://github.com/ZhanGSKen/WinBoLL.git
+★ 码云：https://gitee.com/zhangsken/winboll.git
 
-### ☁ 看远方 ☁ ###
-### ☁ 心忧虑 ☁ WinBoLL-APP 应用前置需求
-☁ WinBoLL-APP WinBoLL 项目根目录设定为手机的 /sdcard/WinBoLLStudio/Sources 目录。（需要用户手动建立文件夹）
-☁ WinBoLL-APP 具有手机 /sdcard/WinBoLL 目录的存储权限。（需要手机操作系统授权）
-☁ WinBoLL-APP WinBoLL 项目仓库源码存储路径为 /sdcard/WinBoLLStudio/Sources/APP.git（需要用户手动建立文件夹）
-☁ WinBoLL-APP 项目 APK 编译输出目录为 /sdcard/WinBoLLStudio/APKs/
-☁ WinBoLL-APP 应用签名验证可定制化。（WinBoLL 项目已提供）
-☁ WinBoLL-APP 与系列衍生 APP 应用共享 cc.winboll.studio 命名空间资源。（WinBoLL 项目已提供）
-☁ WinBoLL-APP 用户客户端信息存储在命名空间为 WinBoLL APP MySQLLite 应用的 winbollappclient 数据库中。
-☁ WinBoLL-APP MySQLLite 应用的 winbollappclient 数据库中， 
-   WinBoLL 用户客户端信息设定为：
-   <用户名, 唯一存储令牌Token>。
+## 三、应用编译环境检查问题
+### 核心判断条件：
+☆ WinBoLL 项目以文件夹 `"/sdcard/WinBoLLStudio/APKs"` 是否存在为判断环境编译输出条件，因为编译输出的APK文件需要一个可供保存的环境。
 
-### ☁ 云游四方 ☁ ###
-### ☁ 呔！ ☁ WinBoLL-APP 应用需求规划
-☁ 如要使用 WinBoLL Android 项目的 Gradle 编译功能，则需要设置以下两个文件夹。
-☁ 1. 则需要建立数据存储目录 /sdcard/WinBoLLStudio/APKs。
-   WinBoLL 项目源码编译出来的安装包会拷贝一份到 /sdcard/WinBoLLStudio/APKs 目录下。 
-☁ 2. 则需要建立数据存储目录 /sdcard/AppProjects。
-   WinBoLL 项目源码编译出来的安装包会拷贝一份并命名 "app.apk" 的安装文件为到 /sdcard/AppProjects 目录下。 
+☆ 文件夹"/sdcard/WinBoLLStudio/APKs" 目录条件设置方法：
+***Linux 服务器端方面***：建立 `/sdcard/WinBoLLStudio/APKs` 目录即可。
+***手机开发端方面***：建立 `"/sdcard/WinBoLLStudio/APKs"` 目录(即 `"/storage/emulated/0/WinBoLLStudio/APKs"` 目录) 即可。
 
+## 四、前置条件
 
-### ☁ 吁！ ☁ WinBoLL-APP 共享计划前景
-☁ WinBoLL-APP 将会实现 https://winboll.cc/api 访问功能。
-☁ WinBoLL-APP 将会实现手机端 Android 应用的开发与管理功能。
+### 1. WinBoLL APP 开发环境配置介绍
+####  WinBoLL APK 编译输出内容包括：
+☆ "/sdcard/WinBoLLStudio/APKs"` 目录内的所有应用分支的 APK 文件。
+winboll.properties 文件的 APKOutputPath 属性可配置这个 APK 输出目录的路径。
+☆ "/sdcard/AppProjects/app.apk"文件。
+winboll.properties 文件的 ExtraAPKOutputPath 属性可配置这个 APK 额外输出文件的路径
+#### WinBoLL APK 源码命名空间规范
+☆ WinBoLL 项目使用 "cc.winboll.studio" 作为源码命名空间。在此命名空间下进行源码定义。
 
-## ☁ WinBoLL ☁ WinBoLL 主机忧虑
-☁ WinBoLL 将会提供 gitea.winboll.cc 域名用户注册登录功能。
-☁ WinBoLL 将会提供 WinBoLL-APP 及其衍生应用的 Gitea 仓库管理服务。
-☁ WinBoLL 将会提供 winboll.cc 域名 WinBoLL 项目组注册登录功能。
+## 五、核心需求规划
 
-# 本项目要实际运用需要注意以下几个步骤：
-# 在项目根目录下：
-## ★. 项目模块编译环境设置(必须)，settings.gradle-demo 要复制为 settings.gradle，并取消相应项目模块的注释。
-## ★. 项目模块编译环境设置(必须) 在根目录拷贝 gradle.properties-androidx-demo 或者 gradle.properties-android-demo 文件为 gradle.properties。
-## ★. 项目 Android SDK 编译环境设置(可选)，local.properties-demo 要复制为 local.properties，并按需要设置 Android SDK 目录。
-## ★. 应用签名密钥 keystore 设置问题。一般调试编译只需用【Termux】cd 进 GenKeyStore 目录执行 $ bash gen_debug_keystore.sh 命令即可完成设置。
-## ☆. 应用 WiBoLL 签名密钥配置问题<非必须考虑>。设置时需要 clone 【keystore】模块源码并拷贝模块目录的 appkey.jks 与 appkey.keystore 到项目根目录即可。
-## ☆. 类库型模块编译环境设置(可选)，winboll.properties-demo 要复制为 winboll.properties，并按需要设置 WinBoLL Maven 库登录用户信息， 和 APK 文件额外输出路径。
+### 1. WinBoLL 应用安全验证需求
+#### ☆ 支持访问 https://console.winboll.cc/ 服务器以校验应用包签名与版本。
 
+### 2. 手机端源码开发管理需求
+#### ☆ 支持切换不同 WinBoLL 分支，以开发不同安卓应用。
 
-# ☆类库型项目编译方法
-## 先编译类库对应的模块测试项目
-### 修改模块测试项目的 build.properties 文件
-设置属性 libraryProject=<类库项目模块文件夹名称>
-### 再编译测试项目
-$ bash .winboll/bashPublishAPKAddTag.sh <应用项目模块文件夹名称>
-#### 测试项目编译后，编译器会复制一份 APK 到 路径："/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/" 文件夹。
-#### 若是 winboll.properties 文件的 [ExtraAPKOutputPath] 属性设置了路径。编译器也会复制一份 APK 到这个路径。
-### 最后编译类库项目
-$ bash .winboll/bashPublishLIBAddTag.sh <类库项目模块文件夹名称>
-#### 类库模块编译命令执行后，编译器会发布到 WinBoLL Nexus Maven 库：Maven 库地址可以参阅根项目目录配置 build.gradle 文件。
-             
-# ☆应用型项目编译方法
-## 直接调用以下命令编译应用型项目
-$ bash .winboll/bashPublishAPKAddTag.sh <应用项目模块文件夹名称>
-#### 应用模块编译命令执行后，编译器会复制一份 APK 到
-#### 测试项目编译后，编译器会复制一份 APK 到 路径："/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/" 文件夹。
-#### 若是 winboll.properties 文件的 [ExtraAPKOutputPath] 属性设置了路径。编译器也会复制一份 APK 到这个路径。
+## 六、编译与使用指南
 
-## ☆应用调试编译方法
-使用以下命令编译调试：
+### 1. 项目初始化（必须）
+#### 1.  复制 `settings.gradle-demo` 为 `settings.gradle`。编辑 `settings.gradle` 文件内容，取消对应项目模块注释。
+#### 2.  复制 `gradle.properties-androidx-demo` (Android X 项目) 或 `gradle.properties-android-demo` (基本 Android 项目) 为 `gradle.properties`。
+#### 3.  复制（可选）`local.properties-demo` 为 `local.properties`，编辑 `local.properties` 文件内容，配置 Android SDK 目录。
+#### 4.  **签名设置**：
+    ☆ **调试编译秘钥制作**：使用 Termux 应用终端，cd 进入 GenKeyStore 目录，运行 `bash gen_debug_keystore.sh` 脚本即可生成应用调试秘钥。
+    ☆  **应用秘钥配置方法**：拷贝调试编译秘钥制作生成的 `appkey.jks` 与 `appkey.keystore` 文件到项目根目录即可。
 
-### Beta调试使用：
-$ bash gradlew assembleBetaDebug
+## 七、应用编译命令介绍
 
-### Stage调试使用：
-$ bash gradlew assembleStageDebug
+### （1）类库型模块配置要点
+#### 1.  **优先修改配置文件**：优先修改应用测试项目（目录为 `"<WinBoLl根目录>/<类库测试应用>/"`）内 `build.properties` 文件，设置对应的类库项目名称：`libraryProject=<类库项目模块名>`。
+#### 2.  **编译优先启动步骤**：使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishAPKAddTag.sh <类库测试项目模块名>` 命令。运行后可生成测试项目与类库项目的编译参数文件 `build.properties`。生成的 `build.properties` 文件有两份，一份在测试项目模块的文件夹内，一份在类库项目本身的模块文件夹内。
+#### 3.  **最后类库编译发布步骤**：使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishLIBAddTag.sh <类库项目模块名>` 命令。运行后可发布至 WinBoLL Nexus Maven 库、本地 maven 目录或者是通用默认的 Gradle Maven 库。
 
-### 若是 winboll.properties 文件的 [ExtraAPKOutputPath] 属性设置了路径。编译器也会复制一份 APK 到这个路径。
+### （2）单一应用型模块与类库测试型模块配置要点
+#### ☆ APK 编译方法：
+使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名>`。
+#### ☆ 运行后的 APK 输出路径：
+★ 默认路径 (`$ bash gradlew assembleBetaDebug` 任务)：APK 在 `/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/debug/` 目录。
+★ 默认路径 (`$ bash assembleStageRelease` 任务)：APK 在 `/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/` 目录。
+★ 额外输出路径：(假设 `winboll.properties` 文件已配置 `ExtraAPKOutputPath` 属性) 输出至 `ExtraAPKOutputPath` 属性配置的目录下。
 
-# 应用版本号命名方式
-## statge 渠道
-V<应用开发环境编号><应用功能变更号><应用调试阶段号>
-如：APPBase_15.7.0
-## beta 渠道
-V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)>
-如：APPBase_15.9.6-beta8_5413
+### （3）手机端应用调试命令介绍
+#### ☆ Beta 渠道调试命令
+$bash gradlew assembleBetaDebug
+
+#### ☆ Stage 渠道调试命令
+$bash gradlew assembleStageDebug
+
+### （4）服务器端开发命令介绍
+##### ☆ Stage 渠道应用发布命令为：
+（"<WinBoLl根目录>/settings.gradle"文件需要配置编译模块开启参数，拷贝 settings.gradle-demo 为 settings.gradle 文件取消对应的分支配置部分即可。）
+$bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
+或者是
+$bash gradlew assembleStageRelease
+ 
+
+## 八、WinBoLL 应用 APK 版本号命名规则
+### ☆ Stage 渠道：
+#### V<应用开发环境编号><应用功能变更号><应用调试阶段号> （示例： APPBase_15.7.0 ）
+### ☆ Beta 渠道：
+#### V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)> （示例： APPBase_15.9.6-beta8_5413 ）

aes/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Tue Jan 13 03:37:01 HKT 2026
-stageCount=2
+#Sat Apr 25 04:16:42 HKT 2026
+stageCount=10
 libraryProject=libaes
 baseVersion=15.15
-publishVersion=15.15.1
+publishVersion=15.15.9
 buildCount=0
-baseBetaVersion=15.15.2
+baseBetaVersion=15.15.10

aes/src/main/AndroidManifest.xml

@@ -3,6 +3,9 @@
     xmlns:android="http://schemas.android.com/apk/res/android"
     package="cc.winboll.studio.aes">
 
+    <!-- 对正在运行的应用重新排序 -->
+    <uses-permission android:name="android.permission.REORDER_TASKS"/>
+
     <application
         android:name=".App"
         android:allowBackup="true"

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

@@ -1,22 +1,29 @@
 package cc.winboll.studio.aes;
 
-import android.app.Activity;
 import android.os.Bundle;
 import android.view.View;
-import android.widget.Toolbar;
+import androidx.appcompat.widget.Toolbar;
 import cc.winboll.studio.aes.R;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.models.APPInfo;
 import cc.winboll.studio.libappbase.views.AboutView;
 
 /**
  * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
- * @Date 2026/01/11 15:16
+ * @Date 2026/01/13 11:25
  * @Describe 应用介绍窗口
  */
-public class AboutActivity extends Activity {
+public class AboutActivity extends BaseWinBoLLActivity {
 
     public static final String TAG = "AboutActivity";
+	
+	private Toolbar mToolbar;
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
@@ -24,21 +31,33 @@ public class AboutActivity extends Activity {
         setContentView(R.layout.activity_about);
 
 		// 设置工具栏
-        Toolbar toolbar = findViewById(R.id.toolbar);
-		setActionBar(toolbar);
-        getActionBar().setSubtitle(TAG);
-        getActionBar().setDisplayHomeAsUpEnabled(true);
-        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
-                @Override
-                public void onClick(View v) {
-                    finish(); // 点击导航栏返回按钮，触发 finish()
-                }
-            });
+        initToolbar();
 
 		AboutView aboutView = findViewById(R.id.aboutview);
 		aboutView.setAPPInfo(genDefaultAppInfo());
     }
 
+	private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					WinBoLLActivityManager.getInstance().resumeActivity(MainActivity.class);
+					WinBoLLActivityManager.getInstance().finish(AboutActivity.this);
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
 	private APPInfo genDefaultAppInfo() {
         LogUtils.d(TAG, "genDefaultAppInfo() 调用");
         String branchName = "aes";

aes/src/main/java/cc/winboll/studio/aes/BaseWinBoLLActivity.java

@@ -0,0 +1,45 @@
+package cc.winboll.studio.aes;
+
+import android.app.Activity;
+import android.os.Bundle;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/13 16:35
+ * @Describe BaseWinBollActivity 【继承AppCompatActivity，保留核心能力，不额外暴露方法】
+ * 继承链路：BaseWinBoLLActivity → AppCompatActivity → FragmentActivity，AppCompat能力天然继承可用
+ */
+public abstract class BaseWinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+    public static final String TAG = "BaseWinBoLLActivity";
+
+    protected volatile AESThemeBean.ThemeType mThemeType;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        mThemeType = AESThemeBean.getThemeStyleType(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        setTheme(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        super.onCreate(savedInstanceState);
+        WinBoLLActivityManager.getInstance().add(this);
+    }
+
+    @Override
+    protected void onDestroy() {
+        WinBoLLActivityManager.getInstance().registeRemove(this);
+        super.onDestroy();
+    }
+
+    // 子类必须实现getTag()，确保唯一标识
+    @Override
+    public abstract String getTag();
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+}
+

aes/src/main/java/cc/winboll/studio/aes/MainActivity.java

@@ -30,7 +30,7 @@ import cc.winboll.studio.libappbase.LogUtils;
 import com.a4455jkjh.colorpicker.ColorPickerDialog;
 import java.util.ArrayList;
 
-public class MainActivity extends DrawerFragmentActivity implements IWinBoLLActivity {
+public class MainActivity extends DrawerFragmentActivity {
 
 
     public static final String TAG = "MainActivity";
@@ -38,11 +38,6 @@ public class MainActivity extends DrawerFragmentActivity implements IWinBoLLActi
     TestAButtonFragment mTestAButtonFragment;
     TestViewPageFragment mTestViewPageFragment;
 
-    @Override
-    public Activity getActivity() {
-        return this;
-    }
-
     @Override
     public String getTag() {
         return TAG;
@@ -188,8 +183,9 @@ public class MainActivity extends DrawerFragmentActivity implements IWinBoLLActi
             Intent intent = new Intent(this, SettingsActivity.class);
             startActivity(intent);
         } else if (nItemId ==  R.id.item_about) {
-            Intent intent = new Intent(this, AboutActivity.class);
-            startActivity(intent);
+//            Intent intent = new Intent(this, AboutActivity.class);
+//            startActivity(intent);
+			WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, AboutActivity.class);
         }
 
 

aes/src/main/java/cc/winboll/studio/aes/WinBoLLActivity.java

@@ -55,6 +55,6 @@ public class WinBoLLActivity extends AppCompatActivity implements IWinBoLLActivi
     @Override
     protected void onDestroy() {
         super.onDestroy();
-        WinBoLLActivityManager.getInstance().registeRemove(this);
+        WinBoLLActivityManager.getInstance().finish(this);
     }
 }

aes/src/main/res/drawable-night/bg_frame.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#00000000" 
+                android:startColor="#1AFFFFFF" /> 
+            <stroke 
+                android:width="1dp" 
+                android:color="#FF666666" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>

aes/src/main/res/drawable/bg_frame.xml

@@ -12,11 +12,7 @@
                 android:angle="270" 
                 android:endColor="#0F000000" 
                 android:startColor="#0F000000" /> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item> 
     <!-- 背景部分 --> 
@@ -31,11 +27,7 @@
                 android:angle="270" 
                 android:endColor="#0FFFFFFF" 
                 android:startColor="#FFFFFFFF" /> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item> 
 </layer-list>

aes/src/main/res/layout/activity_about.xml

@@ -4,9 +4,9 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
-	<android.widget.Toolbar
+	<cc.winboll.studio.libaes.views.ASupportToolbar
 		android:layout_width="match_parent"
 		android:layout_height="wrap_content"
 		android:id="@+id/toolbar"/>

aes/src/main/res/layout/activity_settings.xml

@@ -4,7 +4,7 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<cc.winboll.studio.libaes.views.ADsControlView
 		android:id="@+id/ads_control_view"

aes/src/main/res/layout/activity_testactivitymanager.xml

@@ -4,7 +4,7 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"

appbase/.gitignore

@@ -0,0 +1 @@
+/build

appbase/README.md

@@ -0,0 +1,36 @@
+# APPBase
+[![](https://jitpack.io/v/ZhanGSKen/APPBase.svg)](https://jitpack.io/#ZhanGSKen/APPBase)
+
+#### 介绍
+WinBoLL 安卓手机端安卓应用开发基础类库。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh appbase
+阶段版类库发布命令 ：git pull &&bash .winboll/bashPublishLIBAddTag.sh libappbase
+
+#### 使用说明
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档

appbase/app_update_description.txt

@@ -0,0 +1 @@
+

appbase/build.gradle

@@ -0,0 +1,50 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.appbase"
+        minSdkVersion 26
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.20"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+	
+     // 确保 Java 7 兼容性（已适配项目技术栈）
+     compileOptions {
+         sourceCompatibility JavaVersion.VERSION_1_7
+         targetCompatibility JavaVersion.VERSION_1_7
+     }
+}
+
+dependencies {
+    api project(':libappbase')
+
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}

appbase/build.properties

@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Tue May 12 09:17:15 HKT 2026
+stageCount=10
+libraryProject=libappbase
+baseVersion=15.20
+publishVersion=15.20.9
+buildCount=0
+baseBetaVersion=15.20.10

appbase/proguard-rules.pro

@@ -0,0 +1,126 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（适配你的两个包名）
+#-keep public class * extends com.winboll.WinBoLLActivity
+#-keep public class * extends com.winboll.WinBoLLFragment
+# 主包名
+-keep class cc.winboll.studio.*.** { *; }
+# beta包名
+-keep class cc.winboll.studio.*.beta.** { *; }
+-keepclassmembers class cc.winboll.studio.*.** { *; }
+-keepclassmembers class cc.winboll.studio.*.beta.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架规则 ==============================
+# Retrofit + OkHttp
+-keep class retrofit2.** { *; }
+-keep interface retrofit2.** { *; }
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okio.** { *; }
+-keepclasseswithmembers class * {
+    @retrofit2.http.* <methods>;
+}
+
+# Glide 4.x
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-dontwarn com.bumptech.glide.load.resource.bitmap.VideoDecoder
+
+# GreenDAO 3.x
+-keepclassmembers class * extends org.greenrobot.greendao.AbstractDao {
+    public static java.lang.String TABLENAME;
+}
+-keep class **$Properties
+# 实体类包名（按实际调整）
+#-keep class cc.winboll.studio.appbase.model.** { *; }
+
+# ButterKnife 8.x
+-keep class butterknife.** { *; }
+-dontwarn butterknife.internal.**
+-keep class **$$ViewBinder { *; }
+-keepclasseswithmembernames class * {
+    @butterknife.BindView <fields>;
+    @butterknife.OnClick <methods>;
+}
+
+# EventBus 3.x
+-keepclassmembers class ** {
+    @org.greenrobot.eventbus.Subscribe <methods>;
+}
+-keep enum org.greenrobot.eventbus.ThreadMode { *; }
+
+# ============================== 优化与调试 ==============================
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+-optimizationpasses 5
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+# 保留行号（便于崩溃定位）
+-keepattributes SourceFile,LineNumberTable
+

appbase/src/beta/AndroidManifest.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application
+		tools:replace="android:icon"
+        android:icon="@drawable/ic_winboll_beta">
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+

appbase/src/beta/res/values/strings.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">APPBase+</string>
+
+</resources>

appbase/src/main/AndroidManifest.xml

@@ -0,0 +1,57 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.appbase">
+
+    <application
+        android:name=".App"
+        android:icon="@drawable/ic_winboll"
+        android:label="@string/app_name"
+        android:theme="@style/MyAPPBaseTheme"
+        android:resizeableActivity="true"
+        android:process=":App"
+        android:sharedUserId="@string/shared_user_id"
+        android:sharedUserLabel="@string/shared_user_label">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:resizeableActivity="true"
+            android:launchMode="singleTop"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
+
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+            </intent-filter>
+
+        </activity>
+
+
+
+        <activity
+            android:name=".Main2Activity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:resizeableActivity="true"
+            android:launchMode="singleTop"
+            android:taskAffinity="cc.winboll.studio.appbase.Main2Activity"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
+
+        </activity>
+
+        <activity android:name=".GlobalApplication$CrashActivity"/>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.CrashCopyReceiverActivity"/>
+
+        <activity android:name=".AboutActivity"/>
+
+    </application>
+
+</manifest>

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

@@ -0,0 +1,50 @@
+package cc.winboll.studio.appbase;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Toolbar;
+import cc.winboll.studio.appbase.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 12:55
+ * @Describe AboutActivity
+ */
+public class AboutActivity extends Activity {
+
+    public static final String TAG = "AboutActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setActionBar(toolbar);
+
+		AboutView aboutView = findViewById(R.id.aboutview);
+		aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+	private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "appbase";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName("APPBase");
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=APPBase");
+        appInfo.setAppAPKName("APPBase");
+        appInfo.setAppAPKFolderName("APPBase");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}

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

@@ -0,0 +1,48 @@
+package cc.winboll.studio.appbase;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.BuildConfig;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/01/05 09:54:42
+ * @Describe 应用全局入口类（继承基础库 GlobalApplication）
+ * 负责应用初始化、全局资源管理与生命周期回调处理，是整个应用的核心入口
+ */
+public class App extends GlobalApplication {
+
+    /** 当前应用类的日志 TAG（用于调试输出，标识日志来源） */
+    public static final String TAG = "App";
+
+    /**
+     * 应用创建时回调（全局初始化入口）
+     * 在应用进程启动时执行，仅调用一次，用于初始化全局工具类、第三方库等
+     */
+    @Override
+    public void onCreate() {
+        super.onCreate();
+		// 如果应用不在调试状态，就根据编译类型设置调试状态
+		if (isDebugging() != true) {
+			setIsDebugging(BuildConfig.DEBUG);
+		}
+		// release 版调试码
+		//setIsDebugging(!BuildConfig.DEBUG);
+		
+        // 初始化 Toast 工具类（传入应用全局上下文，确保 Toast 可在任意地方调用）
+        ToastUtils.init(getApplicationContext());
+    }
+
+    /**
+     * 应用终止时回调（资源释放入口）
+     * 仅在模拟环境（如 Android Studio 模拟器）中可靠触发，真机上可能因系统回收进程不执行
+     * 用于释放全局资源，避免内存泄漏
+     */
+    @Override
+    public void onTerminate() {
+        super.onTerminate(); // 调用父类终止逻辑（如基础库资源释放）
+        // 释放 Toast 工具类资源（销毁全局 Toast 实例，避免内存泄漏）
+        ToastUtils.release();
+    }
+}
+

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

@@ -0,0 +1,28 @@
+package cc.winboll.studio.appbase;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class CrashTestActivity extends Activity {
+
+    public static final String TAG = "CrashTestActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_crash_test);
+        LogUtils.d(TAG, "CrashTestActivity onCreate()");
+    }
+
+    public void onBack(View view) {
+        finish();
+    }
+
+    public void onTestCrash(View view) {
+        LogUtils.d(TAG, "onTestCrash()");
+        ToastUtils.show("测试布局崩溃...");
+    }
+}

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

@@ -0,0 +1,20 @@
+package cc.winboll.studio.appbase;
+
+import android.os.Bundle;
+import android.widget.Toolbar;
+import cc.winboll.studio.appbase.R;
+
+public class Main2Activity extends MainActivity {
+
+    public static final String TAG = "Main2Activity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main2);
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        if (toolbar != null) {
+            setActionBar(toolbar);
+        }
+    }
+}

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

@@ -0,0 +1,177 @@
+package cc.winboll.studio.appbase;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Toolbar;
+import cc.winboll.studio.appbase.R;
+import cc.winboll.studio.appbase.model.TestBean;
+import cc.winboll.studio.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 未标注（建议补充创建日期）
+ * @Describe 应用主界面 Activity（入口界面）
+ * 包含功能测试按钮（崩溃测试、日志查看、Toast测试）、顶部工具栏（菜单功能），是应用交互的核心入口
+ */
+public class MainActivity extends Activity {
+
+    /** 当前 Activity 的日志 TAG（用于调试输出，标识日志来源） */
+    public static final String TAG = "MainActivity";
+
+    /** 顶部工具栏（用于展示标题、菜单，绑定布局中的 Toolbar 控件） */
+    private Toolbar mToolbar;
+
+    /**
+     * Activity 创建时回调（初始化界面）
+     * 在 Activity 首次创建时执行，用于加载布局、初始化控件、设置事件监听
+     * @param savedInstanceState 保存 Activity 状态的 Bundle（如屏幕旋转时的数据恢复）
+     */
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        //ToastUtils.show("onCreate"); // 显示 Activity 创建提示（调试用）
+        setContentView(R.layout.activity_main); // 加载主界面布局
+
+        // 初始化 Toolbar 并设置为 ActionBar
+        mToolbar = findViewById(R.id.toolbar);
+        setActionBar(mToolbar); // 将 Toolbar 替代系统默认 ActionBar
+		
+		initTestData();
+    }
+	
+	void initTestData() {
+		TestBean bean1 = new TestBean();
+		bean1.setTestNum1(456);
+		TestBean.saveBeanToFile(getFilesDir().getAbsolutePath() + getTestBeanRelativePath(), bean1);
+		TestBean bean2 = new TestBean();
+		bean2.setTestNum1(789);
+		TestBean.saveBeanToFile(getExternalFilesDir(null).getAbsolutePath() + getTestBeanRelativePath(), bean2);
+	}
+	
+	String getTestBeanRelativePath() {
+		return "/BaseBaen/"+TestBean.class.getName()+".json";
+	}
+
+    /**
+     * 创建菜单时回调（加载工具栏菜单）
+     * 初始化 ActionBar 菜单，加载自定义菜单布局
+     * @param menu 菜单对象（用于承载菜单项）
+     * @return true：显示菜单；false：不显示菜单
+     */
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        // 加载菜单布局（R.menu.toolbar_main 为自定义菜单文件）
+        getMenuInflater().inflate(R.menu.toolbar_main, menu);
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    /**
+     * 菜单 item 点击时回调（处理菜单事件）
+     * 响应 Toolbar 菜单项的点击事件，执行对应业务逻辑
+     * @param item 被点击的菜单项
+     * @return true：消费点击事件；false：不消费（传递给父类）
+     */
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        switch (item.getItemId()) {
+            case R.id.item_home:
+                // 点击 "首页/官网" 菜单项，唤起浏览器打开指定网站
+                openWebsiteInBrowser(this);
+                break;
+				// 可扩展其他菜单项（如设置、关于等）的处理逻辑
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    /**
+     * 崩溃测试按钮点击事件（触发应用崩溃，用于调试异常捕获）
+     * 故意执行非法操作（循环获取不存在的字符串资源），强制应用崩溃
+     * @param view 触发事件的 View（对应布局中的崩溃测试按钮）
+     */
+    public void onCrashTest(View view) {
+        // 循环从 Integer.MIN_VALUE 到 Integer.MAX_VALUE，获取不存在的字符串资源 ID，触发崩溃
+        for (int i = Integer.MIN_VALUE; i < Integer.MAX_VALUE; i++) {
+            getString(i); // i 超出资源 ID 范围，抛出 Resources.NotFoundException 导致崩溃
+        }
+    }
+
+    public void onLogTestNewTask(View view) {
+        LogActivity.startLogActivity(this, true);
+    }
+
+    /**
+     * 日志测试按钮点击事件（打开日志查看界面）
+     * 启动 LogActivity，用于查看应用运行日志
+     * @param view 触发事件的 View（对应布局中的日志测试按钮）
+     */
+    public void onLogTest(View view) {
+        LogActivity.startLogActivity(this, false);
+    }
+
+    /**
+     * Toast 工具测试按钮点击事件（测试全局 Toast 功能）
+     * 测试主线程、子线程中 Toast 的显示效果，验证 ToastUtils 的可用性
+     * @param view 触发事件的 View（对应布局中的 Toast 测试按钮）
+     */
+    public void onToastUtilsTest(View view) {
+        LogUtils.d(TAG, "onToastUtilsTest"); // 打印调试日志，标识进入 Toast 测试
+        ToastUtils.show("Hello, WinBoLL!"); // 主线程显示 Toast
+
+        // 开启子线程，延迟 2 秒后显示 Toast（测试子线程 Toast 兼容性）
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					try {
+						Thread.sleep(2000); // 线程休眠 2 秒
+						// 若 ToastUtils 已处理主线程切换，此处可直接调用；否则需通过 Handler 切换到主线程
+						ToastUtils.show("Thread.sleep(2000);ToastUtils.show...");
+					} catch (InterruptedException e) {
+						// 捕获线程中断异常（如线程被销毁时），不做处理（测试场景）
+						e.printStackTrace();
+					}
+				}
+			}).start();
+    }
+
+    /**
+     * 唤起系统默认浏览器打开指定网站（跳转至应用官网）
+     * 通过 Intent.ACTION_VIEW 隐式意图，触发浏览器打开目标 URL
+     * @param context 上下文对象（如 Activity、Application，此处为 MainActivity）
+     */
+    public void openWebsiteInBrowser(Context context) {
+        String url = "https://www.winboll.cc"; // 目标网站 URL（应用官网）
+        // 构建隐式意图：ACTION_VIEW 表示查看指定数据（Uri 为网站地址）
+        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
+        // 设置标志：在新的任务栈中启动 Activity（避免与当前应用任务栈混淆）
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 启动意图（唤起浏览器）
+        context.startActivity(intent);
+    }
+
+	public void onAboutActivity(View view) {
+        LogUtils.d(TAG, "onAboutActivity() 调用");
+        Intent aboutIntent = new Intent(getApplicationContext(), AboutActivity.class);
+        startActivity(aboutIntent);
+    }
+
+
+
+	public void onMultiInstance(View view) {
+        LogUtils.d(TAG, "onMultiInstance() 多开窗口按钮已点击");
+        ToastUtils.show("多开窗口：已启动新窗口");
+        android.content.Intent intent = new android.content.Intent(this, Main2Activity.class);
+        intent.setFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK);
+        LogUtils.d(TAG, "onMultiInstance() 准备启动Main2Activity");
+        startActivity(intent);
+        LogUtils.d(TAG, "onMultiInstance() Main2Activity已启动");
+    }
+}
+

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

@@ -0,0 +1,17 @@
+package cc.winboll.studio.appbase;
+
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Toolbar;
+import cc.winboll.studio.appbase.R;
+
+public class MainActivityAlias extends MainActivity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setActionBar(toolbar);
+    }
+}

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

@@ -0,0 +1,154 @@
+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 java.io.IOException;
+
+/**
+ * 测试实体类
+ * 继承BaseBean实现JSON序列化/反序列化能力，提供基础int类型属性的封装与数据持久化支持
+ * 适配Java7语法，遵循BaseBean统一的反射识别、JSON读写规范
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/31 19:16:00
+ * @LastEditTime 2026/02/01 10:46:00
+ */
+public class TestBean extends BaseBean {
+
+    // ====================================== 常量定义 ======================================
+    /** 当前类的日志 TAG（用于调试输出） */
+    public static final String TAG = "TestBean";
+
+    // ====================================== 成员属性 ======================================
+    /**
+     * 测试数字属性（默认值：123）
+     * 基础int类型属性，用于测试BaseBean的JSON序列化/反序列化能力
+     */
+    private int testNum1;
+
+    // ====================================== 构造方法 ======================================
+    /**
+     * 无参构造器（默认初始化）
+     * 给testNum1赋值默认值123，满足反射实例化、JSON解析的无参构造要求
+     */
+    public TestBean() {
+        this.testNum1 = 123;
+        LogUtils.d(TAG, "TestBean无参构造器调用，testNum1默认初始化值：" + this.testNum1);
+    }
+
+    /**
+     * 有参构造器（自定义初始化）
+     * @param testNum1 测试数字初始值
+     */
+    public TestBean(int testNum1) {
+        this.testNum1 = testNum1;
+        LogUtils.d(TAG, "TestBean有参构造器调用，传入testNum1：" + testNum1);
+    }
+
+    // ====================================== Get/Set 方法 ======================================
+    /**
+     * 设置测试数字属性值
+     * @param testNum1 待设置的int类型值
+     */
+    public void setTestNum1(int testNum1) {
+        LogUtils.d(TAG, "setTestNum1调用，传入参数：" + testNum1);
+        this.testNum1 = testNum1;
+    }
+
+    /**
+     * 获取测试数字属性值
+     * @return 当前testNum1的int类型值
+     */
+    public int getTestNum1() {
+        LogUtils.d(TAG, "getTestNum1调用，返回值：" + this.testNum1);
+        return testNum1;
+    }
+
+    // ====================================== 重写父类BaseBean方法 ======================================
+    /**
+     * 重写父类方法：获取当前类的全限定名
+     * 用于BaseBean反射识别、类名匹配等统一逻辑
+     * @return 类全限定名（cc.winboll.studio.appbase.model.TestBean）
+     */
+    @Override
+    public String getName() {
+        LogUtils.d(TAG, "getName方法调用，返回类全限定名：" + TestBean.class.getName());
+        return TestBean.class.getName();
+    }
+
+    /**
+     * 重写父类方法：将当前对象序列化为JSON（持久化存储专用）
+     * 遵循BaseBean规范，先执行父类序列化逻辑，再处理子类专属字段
+     * @param jsonWriter JSON写入器（外部传入的JSON流操作实例）
+     * @throws IOException JSON写入异常（流关闭、格式错误等）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        LogUtils.d(TAG, "writeThisToJsonWriter调用，传入参数JsonWriter：" + jsonWriter);
+        // 执行父类公共字段的序列化逻辑
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化子类专属字段testNum1
+        jsonWriter.name("testNum1").value(this.getTestNum1());
+        LogUtils.d(TAG, "writeThisToJsonWriter执行完成，已序列化testNum1：" + this.getTestNum1());
+    }
+
+    /**
+     * 重写父类方法：从JSON字段初始化当前对象属性（解析JSON专用）
+     * 先让父类处理公共字段，再匹配子类专属字段，不匹配则返回false跳过
+     * @param jsonReader JSON读取器（外部传入的JSON流操作实例）
+     * @param name 当前解析的JSON字段名
+     * @return true-字段解析成功；false-字段不匹配，需跳过/父类处理
+     * @throws IOException JSON读取异常（字段类型不匹配、流中断等）
+     */
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        LogUtils.d(TAG, "initObjectsFromJsonReader调用，传入参数：name=" + name + "，JsonReader=" + jsonReader);
+        // 父类优先处理公共字段，处理成功则直接返回
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            LogUtils.d(TAG, "initObjectsFromJsonReader：字段" + name + "由父类BaseBean处理成功");
+            return true;
+        }
+        // 解析子类专属字段
+        if ("testNum1".equals(name)) {
+            this.setTestNum1(jsonReader.nextInt());
+            LogUtils.d(TAG, "initObjectsFromJsonReader：解析testNum1成功，值为：" + this.getTestNum1());
+        } else {
+            LogUtils.w(TAG, "initObjectsFromJsonReader：字段" + name + "不匹配，返回false跳过解析");
+            // 字段不匹配，返回false表示跳过
+            return false;
+        }
+        return true;
+    }
+
+    /**
+     * 重写父类方法：从JSON读取器完整解析并初始化当前对象（JSON解析入口）
+     * 负责JSON对象的开始/结束标识处理，遍历所有字段并调用字段解析方法
+     * 严格遵循writeThisToJsonWriter的序列化结构，保证解析一致性
+     * @param jsonReader JSON读取器（外部传入的JSON流操作实例）
+     * @return 解析后的当前TestBean实例（支持链式调用）
+     * @throws IOException JSON解析异常（格式错误、字段缺失、流异常等）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader调用，传入参数JsonReader：" + jsonReader);
+        // 开始解析JSON对象，与序列化结构保持一致
+        jsonReader.beginObject();
+        // 遍历所有JSON字段
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            LogUtils.d(TAG, "readBeanFromJsonReader：开始解析字段，fieldName=" + fieldName);
+            // 解析字段，不匹配则跳过该值
+            if (!this.initObjectsFromJsonReader(jsonReader, fieldName)) {
+                jsonReader.skipValue();
+                LogUtils.w(TAG, "readBeanFromJsonReader：字段" + fieldName + "解析失败，已跳过该值");
+            }
+        }
+        // 结束JSON对象解析，必须调用避免流异常
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader执行完成，JSON解析结束，当前TestBean实例testNum1：" + this.getTestNum1());
+        // 返回当前实例，支持链式调用
+        return this;
+    }
+}
+

appbase/src/main/res/drawable/bg_container_border.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@android:color/transparent" />
+    <stroke android:width="1dp" android:color="#FFB0B0B0" />
+    <corners android:radius="?attr/borderCornerRadius" />
+</shape>

appbase/src/main/res/drawable/btn_light_blue.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="#81C7F5"/> <!-- 浅蓝色填充 -->
+    <corners android:radius="8dp"/> <!-- 8dp 圆角 -->
+</shape>
+

appbase/src/main/res/layout-night/activity_about.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>

appbase/src/main/res/layout-night/activity_main.xml

@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:padding="0dp"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:gravity="center_vertical"
+			android:spacing="12dp">
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="关于应用"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onAboutActivity"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用崩溃测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onCrashTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试（新窗口）"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTestNewTask"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用吐司测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onToastUtilsTest"
+				android:layout_margin="10dp"/>
+
+
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="多开窗口"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onMultiInstance"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>

appbase/src/main/res/layout-night/activity_main2.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:gravity="center"
+	android:background="@android:color/white">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Main2Activity"
+		android:textSize="24sp"
+		android:textColor="@color/gray_900"/>
+
+</LinearLayout>

appbase/src/main/res/layout/activity_about.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>
+

appbase/src/main/res/layout/activity_crash_test.xml

@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:padding="0dp"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:gravity="center_vertical">
+
+			<cc.winboll.studio.appbase.UndefinedCustomView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="返回"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onBack"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="测试崩溃"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onTestCrash"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>

appbase/src/main/res/layout/activity_main.xml

@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:padding="0dp"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:gravity="center_vertical"
+			android:spacing="12dp">
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="关于应用"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onAboutActivity"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用崩溃测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onCrashTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试（新窗口）"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTestNewTask"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用吐司测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onToastUtilsTest"
+				android:layout_margin="10dp"/>
+
+
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="多开窗口"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onMultiInstance"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>

appbase/src/main/res/layout/activity_main2.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:gravity="center"
+	android:background="?attr/activityBackgroundColor">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Main2Activity"
+		android:textSize="24sp"
+		android:textColor="?attr/activityTextColor"/>
+
+</LinearLayout>

appbase/src/main/res/layout/activity_nfcrsaoperate.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+    
+</LinearLayout>

appbase/src/main/res/menu/toolbar_main.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/item_home"
+        android:title="Home"
+        android:icon="@drawable/ic_winboll"
+        android:showAsAction="always"/>
+</menu>

appbase/src/main/res/values-night/colors.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#FF1B8B29</color>
+    <color name="colorPrimaryDark">#FF0A5520</color>
+    <color name="colorAccent">#FF6EE87C</color>
+    <color name="colorText">#FFB8FF7D</color>
+</resources>

appbase/src/main/res/values-night/styles.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="MyAPPBaseTheme" parent="APPBaseTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+    </style>
+
+    <style name="MyDebugActivityTheme" parent="DebugActivityTheme">
+        <item name="colorTittle">?attr/mainWindowDarkTextColor</item>
+        <item name="colorTittleBackgound">?attr/toolbarBackgroundColor</item>
+        <item name="colorText">?attr/debugTextColor</item>
+        <item name="colorTextBackgound">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+	</style>
+</resources>

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

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <attr name="borderCornerRadius" format="dimension" />
+	<declare-styleable name="AboutView">
+        <attr name="app_name" format="string" />
+        <attr name="app_apkfoldername" format="string" />
+        <attr name="app_apkname" format="string" />
+        <attr name="app_gitname" format="string" />
+        <attr name="app_gitowner" format="string" />
+        <attr name="app_gitappbranch" format="string" />
+        <attr name="app_gitappsubprojectfolder" format="string" />
+        <attr name="appdescription" format="string" />
+        <attr name="appicon" format="reference" />
+        <attr name="is_adddebugtools" format="boolean" />
+    </declare-styleable>
+</resources>

appbase/src/main/res/values/colors.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#FF00B322</color>
+    <color name="colorPrimaryDark">#FF005C12</color>
+    <color name="colorAccent">#FF8DFFA2</color>
+    <color name="colorText">#FFFFFB8D</color>
+</resources>

appbase/src/main/res/values/strings.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">APPBase</string>
+    <string name="app_description">WinBoLL 安卓手机端安卓应用开发基础类库。</string>
+    <string name="app_normal">Click here is switch to Normal APP</string>
+    <string name="app_debug">Click here is switch to APP DEBUG</string>
+	<string name="gitea_home">GITEA HOME</string>
+    <string name="app_update">APP UPDATE</string>
+</resources>

appbase/src/main/res/values/styles.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="MyAPPBaseTheme" parent="APPBaseTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+    </style>
+
+    <style name="MyDebugActivityTheme" parent="DebugActivityTheme">
+        <item name="colorTittle">?attr/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">?attr/toolbarBackgroundColor</item>
+        <item name="colorText">?attr/debugTextColor</item>
+        <item name="colorTextBackgound">?attr/mainWindowBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+	</style>
+</resources>

appbase/src/stage/AndroidManifest.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+

appbase/src/stage/res/values/strings.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>

build.gradle

@@ -1,6 +1,15 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 buildscript {
     repositories {
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+		
         mavenLocal {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
@@ -11,19 +20,6 @@ buildscript {
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
         // "WinBoLL Snapshot"
         maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
-        
-        maven { url 'https://maven.aliyun.com/repository/public/' } 
-        maven { url 'https://maven.aliyun.com/repository/google/' }
-        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
-        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
-        maven { url "https://clojars.org/repo/" }
-        maven { url "https://jitpack.io" }
-        mavenCentral()
-        google()
-        //println "mavenLocal : ==========="
-        //println mavenLocal().url
-        //println "mavenLocal : ==========="
-        //mavenLocal()
     }
     dependencies {
 	    // 适配MIUI12
@@ -35,6 +31,15 @@ buildscript {
 
 allprojects {
     repositories {
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+		
         mavenLocal {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
@@ -45,19 +50,6 @@ allprojects {
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
         // "WinBoLL Snapshot"
         maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
-        
-        maven { url 'https://maven.aliyun.com/repository/public/' } 
-        maven { url 'https://maven.aliyun.com/repository/google/' }
-        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
-        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
-        maven { url "https://clojars.org/repo/" }
-        maven { url "https://jitpack.io" }
-        mavenCentral()
-        google()
-        //println "mavenLocal : ==========="
-        //println mavenLocal().url
-        //println "mavenLocal : ==========="
-        //mavenLocal()
     }
     ext {
         // 定义全局变量，常用于版本管理

gradle.properties

@@ -1,21 +0,0 @@
-# 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=true
-# Automatically convert third-party libraries to use AndroidX
-android.enableJetifier=true
-# 保持与旧版Gradle插件的兼容
-android.disableAutomaticComponentCreation=true

libaes/build.gradle

@@ -63,7 +63,7 @@ dependencies {
     //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
 	
 	// WinBoLL库 nexus.winboll.cc 地址
-    api 'cc.winboll.studio:libappbase:15.15.3'
+    api 'cc.winboll.studio:libappbase:15.15.19'
 	// 备用库 jitpack.io 地址
 	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.3'
 	

libaes/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Tue Jan 13 03:37:01 HKT 2026
-stageCount=2
+#Sat Apr 25 04:16:30 HKT 2026
+stageCount=10
 libraryProject=libaes
 baseVersion=15.15
-publishVersion=15.15.1
+publishVersion=15.15.9
 buildCount=0
-baseBetaVersion=15.15.2
+baseBetaVersion=15.15.10

libaes/src/main/java/cc/winboll/studio/libaes/activitys/DrawerFragmentActivity.java

@@ -5,6 +5,7 @@ package cc.winboll.studio.libaes.activitys;
  * @Date 2024/06/13 18:58:54
  * @Describe 可以加入Fragment的有抽屉的活动窗口抽象类
  */
+import android.app.Activity;
 import android.content.Context;
 import android.content.Intent;
 import android.content.SharedPreferences;
@@ -27,14 +28,16 @@ import cc.winboll.studio.libaes.models.AESThemeBean;
 import cc.winboll.studio.libaes.models.DrawerMenuBean;
 import cc.winboll.studio.libaes.utils.AESThemeUtil;
 import cc.winboll.studio.libaes.utils.DevelopUtils;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
 import cc.winboll.studio.libaes.views.ADrawerMenuListView;
 import cc.winboll.studio.libaes.views.ADsBannerView;
 import cc.winboll.studio.libappbase.GlobalApplication;
 import cc.winboll.studio.libappbase.LogUtils;
 import com.baoyz.widget.PullRefreshLayout;
 import java.util.ArrayList;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
 
-public abstract class DrawerFragmentActivity extends AppCompatActivity implements AdapterView.OnItemClickListener {
+public abstract class DrawerFragmentActivity extends AppCompatActivity implements IWinBoLLActivity, AdapterView.OnItemClickListener {
 
     public static final String TAG = "DrawerFragmentActivity";
 
@@ -61,17 +64,28 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
-        //mContext = this;
-        mThemeType = getThemeType();
-        setThemeStyle();
+        mThemeType = AESThemeBean.getThemeStyleType(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        setTheme(AESThemeUtil.getThemeTypeID(getApplicationContext()));
         super.onCreate(savedInstanceState);
+        WinBoLLActivityManager.getInstance().add(this);
         mActivityType = initActivityType();
         initRootView();
         LogUtils.d(TAG, "onCreate end.");
     }
 
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
     @Override
     protected void onDestroy() {
+		WinBoLLActivityManager.getInstance().registeRemove(this);
         super.onDestroy();
 		// 修复：释放广告资源，避免内存泄漏
 		ADsBannerView adsBannerView = findViewById(R.id.adsbanner);
@@ -157,23 +171,6 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
         super.onBackPressed();
     }
 
-    void setThemeStyle() {
-        //setTheme(AESThemeBean.getThemeStyle(getThemeType()));
-        setTheme(AESThemeUtil.getThemeTypeID(getApplicationContext()));
-    }
-
-    boolean checkThemeStyleChange() {
-        return mThemeType != getThemeType();
-    }
-
-    AESThemeBean.ThemeType getThemeType() {
-        /*SharedPreferences sharedPreferences = getSharedPreferences(
-         SHAREDPREFERENCES_NAME, MODE_PRIVATE);
-         return AESThemeBean.ThemeType.values()[((sharedPreferences.getInt(DRAWER_THEME_TYPE, AESThemeBean.ThemeType.DEFAULT.ordinal())))];
-         */
-        return AESThemeBean.getThemeStyleType(AESThemeUtil.getThemeTypeID(getApplicationContext()));
-    }
-
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         if (AESThemeUtil.onAppThemeItemSelected(this, item)) {
@@ -190,9 +187,6 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
     @Override
     protected void onResume() {
         super.onResume();
-        if (checkThemeStyleChange()) {
-            recreate();
-        }
 
 		ADsBannerView adsBannerView = findViewById(R.id.adsbanner);
 		if (adsBannerView != null) {

libaes/src/main/java/cc/winboll/studio/libaes/interfaces/IWinBoLLActivity.java

@@ -1,18 +1,24 @@
 package cc.winboll.studio.libaes.interfaces;
 
+import android.app.Activity;
+
 /**
  * @Author ZhanGSKen<zhangsken@qq.com>
  * @Date 2025/05/10 09:34
- * @Describe WinBoLL 窗口操作接口
+ * @Describe WinBoll 窗口操作接口（规范定义，职责单一）
  */
- import android.app.Activity;
- 
-public abstract interface IWinBoLLActivity {
+public interface IWinBoLLActivity {
+    String TAG = "IWinBoLLActivity";
+    String ACTION_BIND = IWinBoLLActivity.class.getName() + ".ACTION_BIND";
 
-    public static final String TAG = "IWinBoLLActivity";
+    /**
+     * 获取当前Activity实例
+     */
+    Activity getActivity();
 
-    public static final String ACTION_BIND = IWinBoLLActivity.class.getName() + ".ACTION_BIND";
-
-    public Activity getActivity();
-    public String getTag();
+    /**
+     * 获取Activity唯一标识（建议使用类名+UUID或固定唯一字符串）
+     */
+    String getTag();
 }
+

libaes/src/main/java/cc/winboll/studio/libaes/unittests/SecondaryLibraryActivity.java

@@ -20,11 +20,6 @@ public class SecondaryLibraryActivity extends DrawerFragmentActivity implements
 
     SecondaryLibraryFragment mSecondaryLibraryFragment;
 
-    @Override
-    public Activity getActivity() {
-        return this;
-    }
-
     @Override
     public String getTag() {
         return null;

libaes/src/main/java/cc/winboll/studio/libaes/utils/WinBoLLActivityManager.java

@@ -1,17 +1,12 @@
 package cc.winboll.studio.libaes.utils;
 
-/**
- * @Author ZhanGSKen<zhangsken@qq.com>
- * @Date 2025/05/10 10:02
- * @Describe 应用活动窗口管理器
- * 参考 ：
- * android 类似微信小程序多任务窗口 及 设置 TaskDescription 修改 icon 和 label
- * https://blog.csdn.net/qq_29364417/article/details/109379915?app_version=6.4.2&code=app_1562916241&csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22109379915%22%2C%22source%22%3A%22weixin_38986226%22%7D&uLinkId=usr1mkqgl919blen&utm_source=app
- */
 import android.app.Activity;
 import android.app.ActivityManager;
 import android.content.Context;
 import android.content.Intent;
+import android.os.Build;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
 import cc.winboll.studio.libappbase.GlobalApplication;
 import cc.winboll.studio.libappbase.LogActivity;
@@ -20,273 +15,292 @@ import cc.winboll.studio.libappbase.ToastUtils;
 import java.util.HashMap;
 import java.util.Iterator;
 import java.util.Map;
+import java.util.Objects;
 
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/05/10 10:02
+ * @Describe 应用活动窗口管理器（改进版）
+ * 核心能力：多任务窗口管理、Activity栈维护、任务前台恢复、批量关闭、前后Activity切换
+ * 参考 ：android 类似微信小程序多任务窗口 及 设置 TaskDescription 修改 icon 和 label
+ */
 public class WinBoLLActivityManager {
 
     public static final String TAG = "WinBoLLActivityManager";
-
     public static final String EXTRA_TAG = "EXTRA_TAG";
 
+    public enum WinBoLLUI_TYPE { APPLICATION, SERVICE } // 规范命名 大写开头
 
-    public enum WinBoLLUI_TYPE { Aplication, Service }
+    private GlobalApplication mGlobalApplication;
+    private static volatile WinBoLLActivityManager sInstance; // 单例命名规范
+    private final Map<String, IWinBoLLActivity> mActivityListMap; // 私有不可变
+    private static volatile WinBoLLUI_TYPE sWinBoLLUI_TYPE = WinBoLLUI_TYPE.SERVICE;
 
-    GlobalApplication mGlobalApplication;
-    volatile static WinBoLLActivityManager _mIWinBoLLActivityManager;
-    Map<String, IWinBoLLActivity> mActivityListMap;
-
-    volatile static WinBoLLUI_TYPE _WinBoLLUI_TYPE = WinBoLLUI_TYPE.Service;
-    public static void setWinBoLLUI_TYPE(WinBoLLUI_TYPE winBoLLUI_TYPE) {
-        _WinBoLLUI_TYPE = winBoLLUI_TYPE;
-    }
-
-    public static WinBoLLUI_TYPE getWinBoLLUI_TYPE() {
-        return _WinBoLLUI_TYPE;
-    }
-	
-    WinBoLLActivityManager(GlobalApplication application) {
+    // 私有构造 杜绝外部实例化
+    private WinBoLLActivityManager(@NonNull GlobalApplication application) {
         mGlobalApplication = application;
-        mActivityListMap = new HashMap<String, IWinBoLLActivity>();
+        mActivityListMap = new HashMap<>(); // 菱形泛型简化
     }
 
+    /**
+     * 初始化管理器（必须在Application onCreate中调用）
+     */
+    public static <T extends GlobalApplication> void init(@NonNull T application) {
+        if (sInstance == null) {
+            synchronized (WinBoLLActivityManager.class) {
+                if (sInstance == null) {
+                    sInstance = new WinBoLLActivityManager(application);
+                }
+            }
+        }
+    }
+
+    /**
+     * 获取单例（需先调用init初始化，否则抛异常）
+     */
+    @NonNull
     public static WinBoLLActivityManager getInstance() {
-        return _mIWinBoLLActivityManager;
-    }
-	
-	public static synchronized <T extends GlobalApplication> void init(T application) {
-        if (_mIWinBoLLActivityManager == null) {
-            _mIWinBoLLActivityManager = new WinBoLLActivityManager(application);
+        if (sInstance == null) {
+            throw new IllegalStateException("WinBoLLActivityManager 未初始化，请先在Application中调用 init()");
         }
+        return sInstance;
+    }
+
+    // ===================== 基础配置 =====================
+    public static void setWinBoLLUI_TYPE(@NonNull WinBoLLUI_TYPE winBoLLUI_TYPE) {
+        sWinBoLLUI_TYPE = winBoLLUI_TYPE;
+    }
+
+    @NonNull
+    public static WinBoLLUI_TYPE getWinBoLLUI_TYPE() {
+        return sWinBoLLUI_TYPE;
+    }
+
+    // ===================== Activity 增删查 =====================
+    /**
+     * 把Activity添加到管理中（自动去重）
+     */
+    public <T extends IWinBoLLActivity> void add(@NonNull T activity) {
+        String tag = activity.getTag();
+        if (isActivityActive(tag)) {
+            LogUtils.d(TAG, String.format("Activity[%s] 已处于活跃状态，无需重复添加", tag));
+            return;
+        }
+        mActivityListMap.put(tag, activity);
+        LogUtils.d(TAG, String.format("添加Activity：%s，当前管理数量：%d", tag, mActivityListMap.size()));
     }
 
     /**
-     * 把Activity添加到管理中
+     * 判断指定Tag的Activity是否活跃
      */
-    public <T extends IWinBoLLActivity> void add(T activity) {
-        if (isActivityActive(activity.getTag())) {
-            LogUtils.d(TAG, String.format("add(...) %s is active.", activity.getTag()));
-        } else {
-            mActivityListMap.put(activity.getTag(), activity);
-            LogUtils.d(TAG, String.format("Add activity : %s\n_mapActivityList.size() : %d", activity.getTag(), mActivityListMap.size()));
-        }
-    }
-
-    //
-    // activity: 为 null 时，
-    // intent.putExtra 函数 "tag" 参数为 tag
-    // activity: 不为 null 时，
-    // intent.putExtra 函数 "tag" 参数为 activity.getTag()
-    //
-    public <T extends IWinBoLLActivity> void startWinBoLLActivity(Context context, Class<T> clazz) {
-        // 如果窗口已存在就重启窗口
-        if (!resumeActivity(clazz)) {
-            // 新建一个任务窗口
-            Intent intent = new Intent(context, clazz);
-            //打开多任务窗口 flags
-            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
-            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
-            //intent.putExtra("tag", tag);
-            context.startActivity(intent);
-        }
-    }
-
-    public <T extends IWinBoLLActivity> void startWinBoLLActivity(Context context, Intent intent, Class<T> clazz) {
-        // 如果窗口已存在就重启窗口
-        if (!resumeActivity(clazz)) {
-            // 新建一个任务窗口
-            //Intent intent = new Intent(context, clazz);
-            //打开多任务窗口 flags
-            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
-            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
-            //intent.putExtra("tag", tag);
-            context.startActivity(intent);
-        }
-    }
-
-    public <T extends IWinBoLLActivity> void startLogActivity(Context context) {
-        // 如果窗口已存在就重启窗口
-        //if (!resumeActivity(LogActivity.class)) {
-        // 新建一个任务窗口
-        Intent intent = new Intent(context, LogActivity.class);
-        //打开多任务窗口 flags
-        // Define the bounds.
-//        Rect bounds = new Rect(0, 0, 800, 200);
-//        // Set the bounds as an activity option.
-//        ActivityOptions options = ActivityOptions.makeBasic();
-//        options.setLaunchBounds(bounds);
-        intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
-        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
-        intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
-
-        //intent.putExtra(EXTRA_TAG, tag);
-
-        //context.startActivity(intent, options.toBundle());
-        context.startActivity(intent);
-        //}
-    }
-
-    //
-    // 判断 tag 绑定的 Activity 是否已经创建
-    //
-    public boolean isActivityActive(String tag) {
-        return mActivityListMap.get(tag) != null;
-    }
-
-    Activity getActivityByTag(String tag) {
-        return (mActivityListMap.get(tag) == null) ?null: mActivityListMap.get(tag).getActivity();
-    }
-
-
-    //
-    // 找到tag 绑定的 BaseActivity ，通过 getTaskId() 移动到前台
-    //
-    public <T extends IWinBoLLActivity> boolean resumeActivity(Class<T> clazz) {
-        try {
-            Activity activity = getActivityByTag(clazz.newInstance().getTag());
-            if (activity != null) {
-                return resumeActivity(activity);
-            }
-        } catch (InstantiationException | IllegalAccessException e) {
-            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-        }
-        return false;
-    }
-
-    //
-    // 找到tag 绑定的 BaseActivity ，通过 getTaskId() 移动到前台
-    //
-    public <T extends IWinBoLLActivity> boolean resumeActivity(String tag) {
-        Activity activity = getActivityByTag(tag);
-        if (activity != null) {
-            return resumeActivity(activity);
-        }
-        return false;
-    }
-
-    //
-    // 找到tag 绑定的 BaseActivity ，通过 getTaskId() 移动到前台
-    //
-    public <T extends IWinBoLLActivity> boolean resumeActivity(Activity activity) {
-        ActivityManager am = (ActivityManager) activity.getSystemService(Context.ACTIVITY_SERVICE);
-        //返回启动它的根任务（home 或者 MainActivity）
-        //Intent intent = new Intent(mContext, activity.getClass());
-        //TaskStackBuilder stackBuilder = TaskStackBuilder.create(mContext);
-        //stackBuilder.addNextIntentWithParentStack(intent);
-        //stackBuilder.startActivities();
-        am.moveTaskToFront(activity.getTaskId(), ActivityManager.MOVE_TASK_NO_USER_ACTION);
-        //ToastUtils.show("resumeActivity");
-        return true;
-    }
-
-
-    /**
-     * 结束所有 Activity
-     */
-    public void finishAll() {
-        try {
-            //ToastUtils.show(String.format("finishAll() size : %d", _mIWinBoLLActivityList.size()));
-            for (int i = mActivityListMap.size() - 1; i > -1; i--) {
-                IWinBoLLActivity iWinBoLLActivity = mActivityListMap.get(i);
-                ToastUtils.show("finishAll() activity");
-                if (iWinBoLLActivity != null && iWinBoLLActivity.getActivity() != null && !iWinBoLLActivity.getActivity().isFinishing() && !iWinBoLLActivity.getActivity().isDestroyed()) {
-                    //ToastUtils.show("activity != null ...");
-                    if (getWinBoLLUI_TYPE() == WinBoLLUI_TYPE.Service) {
-                        // 结束窗口和最近任务栏, 建议前台服务类应用使用，可以方便用户再次调用 UI 操作。
-                        iWinBoLLActivity.getActivity().finishAndRemoveTask();
-                        //ToastUtils.show("finishAll() activity.finishAndRemoveTask();");
-                    } else if (getWinBoLLUI_TYPE() == WinBoLLUI_TYPE.Aplication) {
-                        // 结束窗口保留最近任务栏，建议前台服务类应用使用，可以保持应用的系统自觉性。
-                        iWinBoLLActivity.getActivity().finish();
-                        //ToastUtils.show("finishAll() activity.finish();");
-                    } else {
-                        ToastUtils.show("WinBollApplication.WinBollUI_TYPE error.");
-                    }
-                }
-            }
-        } catch (Exception e) {
-            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-        }
+    public boolean isActivityActive(@NonNull String tag) {
+        return mActivityListMap.containsKey(tag) && mActivityListMap.get(tag) != null;
     }
 
     /**
-     * 结束指定Activity
+     * 根据Tag获取Activity（空安全）
      */
-    public <T extends IWinBoLLActivity> void finish(T iWinBoLLActivity) {
-        try {
-            if (iWinBoLLActivity != null && iWinBoLLActivity.getActivity() != null && !iWinBoLLActivity.getActivity().isFinishing() && !iWinBoLLActivity.getActivity().isDestroyed()) {
-                //根据tag 移除 MyActivity
-                //String tag= activity.getTag();
-                //_mIWinBoLLActivityList.remove(tag);
-                //ToastUtils.show("remove");
-                //ToastUtils.show("_mIWinBoLLActivityArrayMap.size() " + Integer.toString(_mIWinBoLLActivityArrayMap.size()));
-
-                // 窗口回调规则：
-                // [] 当前窗口位置 >> 调度出的窗口位置
-                // ★：[0] 1 2 3 4 >> 1
-                // ★：0 1 [2] 3 4 >> 1
-                // ★：0 1 2 [3] 4 >> 2
-                // ★：0 1 2 3 [4] >> 3
-                // ★：[0] >> 直接关闭当前窗口
-                Activity preActivity = getPreActivity(iWinBoLLActivity);
-                iWinBoLLActivity.getActivity().finish();
-                if (preActivity != null) {
-                    resumeActivity(preActivity);
-                }
-            }
-
-        } catch (Exception e) {
-            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+    @Nullable
+    public Activity getActivityByTag(@NonNull String tag) {
+        IWinBoLLActivity winBoLLActivity = mActivityListMap.get(tag);
+        if (winBoLLActivity == null) return null;
+        Activity activity = winBoLLActivity.getActivity();
+        // 过滤已销毁/已结束的Activity
+        if (activity == null || activity.isFinishing() || (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && activity.isDestroyed())) {
+            registeRemove(winBoLLActivity);
+            return null;
         }
+        return activity;
     }
 
-    Activity getPreActivity(IWinBoLLActivity iWinBoLLActivity) {
-        try {
-            boolean bingo = false;
-            IWinBoLLActivity preIWinBoLLActivity = null;
-            for (Map.Entry<String, IWinBoLLActivity> entity : mActivityListMap.entrySet()) {
-                if (entity.getKey().equals(iWinBoLLActivity.getTag())) {
-                    bingo = true;
-                    LogUtils.d(TAG, "bingo");
-                    break;
-                }
-                preIWinBoLLActivity = entity.getValue();
-            }
-
-            if (bingo) {
-                return preIWinBoLLActivity.getActivity();
-            }
-        } catch (Exception e) {
-            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-        }
-
-        return null;
-    }
-
-    public <T extends IWinBoLLActivity> boolean registeRemove(T iWinBoLLActivity) {
-        IWinBoLLActivity iWinBoLLActivityTest = mActivityListMap.get(iWinBoLLActivity.getTag());
-        if (iWinBoLLActivityTest != null) {
-            mActivityListMap.remove(iWinBoLLActivity.getTag());
+    /**
+     * 移除指定Activity（销毁时调用）
+     */
+    public <T extends IWinBoLLActivity> boolean registeRemove(@NonNull T iWinBoLLActivity) {
+        String tag = iWinBoLLActivity.getTag();
+        if (mActivityListMap.containsKey(tag)) {
+            mActivityListMap.remove(tag);
+            LogUtils.d(TAG, String.format("移除Activity：%s，剩余管理数量：%d", tag, mActivityListMap.size()));
             return true;
         }
         return false;
     }
 
-    public void printAvtivityListInfo() {
-        if (!mActivityListMap.isEmpty()) {
-            StringBuilder sb = new StringBuilder("Map entries : " + Integer.toString(mActivityListMap.size()));
-            Iterator<Map.Entry<String, IWinBoLLActivity>> iterator = mActivityListMap.entrySet().iterator();
-            while (iterator.hasNext()) {
-                Map.Entry<String, IWinBoLLActivity> entry = iterator.next();
-                sb.append("\nKey: " + entry.getKey() + ", \nValue: " + entry.getValue().getTag());
-                //ToastUtils.show("\nKey: " + entry.getKey() + ", Value: " + entry.getValue().getTag());
-            }
-            sb.append("\nMap entries end.");
-            LogUtils.d(TAG, sb.toString());
-        } else {
-            LogUtils.d(TAG, "The map is empty.");
+    // ===================== Activity 启动 =====================
+    /**
+     * 启动WinBoLLActivity（存在则前台恢复，不存在则新建多任务窗口）
+     */
+    public <T extends IWinBoLLActivity> void startWinBoLLActivity(@NonNull Context context, @NonNull Class<T> clazz) {
+        if (!resumeActivity(clazz)) {
+            Intent intent = new Intent(context, clazz);
+            setMultiTaskFlags(intent);
+            context.startActivity(intent);
         }
     }
+
+    /**
+     * 带Intent参数启动WinBoLLActivity
+     */
+    public <T extends IWinBoLLActivity> void startWinBoLLActivity(@NonNull Context context, @NonNull Intent intent, @NonNull Class<T> clazz) {
+        if (!resumeActivity(clazz)) {
+            setMultiTaskFlags(intent);
+            context.startActivity(intent);
+        }
+    }
+
+    /**
+     * 启动日志页面（固定多任务模式）
+     */
+    public void startLogActivity(@NonNull Context context) {
+        Intent intent = new Intent(context, LogActivity.class);
+        setMultiTaskFlags(intent);
+        intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT); // 分屏相关
+        context.startActivity(intent);
+    }
+
+    /**
+     * 设置多任务窗口通用Flags
+     */
+    private void setMultiTaskFlags(@NonNull Intent intent) {
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+        intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+    }
+
+    // ===================== Activity 前台恢复 =====================
+    /**
+     * 根据Activity类 恢复前台（反射获取Tag，需保证无参构造）
+     */
+    public <T extends IWinBoLLActivity> boolean resumeActivity(@NonNull Class<T> clazz) {
+        try {
+            T instance = clazz.newInstance();
+            return resumeActivity(instance.getTag());
+        } catch (InstantiationException | IllegalAccessException e) {
+            LogUtils.e(TAG, "恢复Activity失败，类需提供无参构造", e);
+        }
+        return false;
+    }
+
+    /**
+     * 根据Tag 恢复Activity前台
+     */
+    public boolean resumeActivity(@NonNull String tag) {
+        Activity activity = getActivityByTag(tag);
+        return activity != null && resumeActivity(activity);
+    }
+
+    /**
+     * 恢复指定Activity到前台（适配高版本权限）
+     */
+    @SuppressWarnings("deprecation")
+    public boolean resumeActivity(@NonNull Activity activity) {
+        if (activity.isFinishing() || (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && activity.isDestroyed())) {
+            return false;
+        }
+        try {
+            ActivityManager am = (ActivityManager) activity.getSystemService(Context.ACTIVITY_SERVICE);
+            if (am == null) {
+                LogUtils.w(TAG, "获取ActivityManager失败，无法恢复前台");
+                return false;
+            }
+            // Android 11+ 限制，低版本正常使用
+            am.moveTaskToFront(activity.getTaskId(), ActivityManager.MOVE_TASK_NO_USER_ACTION);
+			//ToastUtils.show(String.format("Activity[%s] 已恢复到前台", activity.getClass().getSimpleName()));
+            LogUtils.d(TAG, String.format("Activity[%s] 已恢复到前台", activity.getClass().getSimpleName()));
+            return true;
+        } catch (SecurityException e) {
+			//ToastUtils.show("恢复Activity前台失败，缺少权限或系统限制 ：" + e.getMessage());
+            LogUtils.e(TAG, "恢复Activity前台失败，缺少权限或系统限制", e);
+            //ToastUtils.show("窗口恢复失败，请手动打开");
+            return false;
+        }
+    }
+
+    // ===================== Activity 关闭 =====================
+    /**
+     * 结束所有管理的Activity（按UI类型选择关闭策略）
+     */
+    public void finishAll() {
+        if (mActivityListMap.isEmpty()) {
+            LogUtils.d(TAG, "当前无管理的Activity，无需结束");
+            return;
+        }
+        LogUtils.d(TAG, String.format("开始结束所有Activity，共%d个", mActivityListMap.size()));
+        Iterator<Map.Entry<String, IWinBoLLActivity>> iterator = mActivityListMap.entrySet().iterator();
+        while (iterator.hasNext()) {
+            IWinBoLLActivity winBoLLActivity = iterator.next().getValue();
+            Activity activity = winBoLLActivity.getActivity();
+            if (activity == null) {
+                iterator.remove();
+                continue;
+            }
+            // 安全关闭，避免重复操作
+            if (!activity.isFinishing() && !(Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && activity.isDestroyed())) {
+                if (sWinBoLLUI_TYPE == WinBoLLUI_TYPE.SERVICE) {
+                    activity.finishAndRemoveTask(); // 结束+移除最近任务
+                } else if (sWinBoLLUI_TYPE == WinBoLLUI_TYPE.APPLICATION) {
+                    activity.finish(); // 仅结束页面
+                }
+            }
+            iterator.remove(); // 移除已处理的项
+        }
+        LogUtils.d(TAG, "所有Activity结束完成");
+    }
+
+    /**
+     * 结束指定Activity，自动恢复上一个Activity前台
+     */
+    public <T extends IWinBoLLActivity> void finish(@NonNull T iWinBoLLActivity) {
+        Activity currentActivity = iWinBoLLActivity.getActivity();
+        if (currentActivity == null || currentActivity.isFinishing() || (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && currentActivity.isDestroyed())) {
+            registeRemove(iWinBoLLActivity);
+            return;
+        }
+
+        // 先获取上一个Activity，再关闭当前
+        Activity preActivity = getPreActivity(iWinBoLLActivity);
+        currentActivity.finish();
+        registeRemove(iWinBoLLActivity); // 关闭后移除管理
+
+        // 恢复上一个Activity前台
+        if (preActivity != null) {
+            resumeActivity(preActivity);
+        }
+    }
+
+    /**
+     * 获取当前Activity的上一个栈内Activity（修复原遍历逻辑错误）
+     */
+    @Nullable
+    private Activity getPreActivity(@NonNull IWinBoLLActivity currentActivity) {
+        String currentTag = currentActivity.getTag();
+        IWinBoLLActivity preWinBoLLActivity = null;
+        for (Map.Entry<String, IWinBoLLActivity> entry : mActivityListMap.entrySet()) {
+            String tag = entry.getKey();
+            if (Objects.equals(tag, currentTag)) {
+                break; // 找到当前Activity，循环终止，pre即为上一个
+            }
+            preWinBoLLActivity = entry.getValue();
+        }
+        return preWinBoLLActivity != null ? preWinBoLLActivity.getActivity() : null;
+    }
+
+    // ===================== 调试辅助 =====================
+    /**
+     * 打印所有管理的Activity信息（调试用）
+     */
+    public void printActivityListInfo() {
+        if (mActivityListMap.isEmpty()) {
+            LogUtils.d(TAG, "当前管理的Activity列表为空");
+            return;
+        }
+        StringBuilder sb = new StringBuilder(String.format("Activity管理列表（总数：%d）\n", mActivityListMap.size()));
+        for (Map.Entry<String, IWinBoLLActivity> entry : mActivityListMap.entrySet()) {
+            sb.append("Tag: ").append(entry.getKey())
+				.append(" | Activity: ").append(entry.getValue().getActivity().getClass().getSimpleName())
+				.append("\n");
+        }
+        LogUtils.d(TAG, sb.toString());
+    }
 }
 

libaes/src/main/java/cc/winboll/studio/libaes/views/ASupportToolbar.java

@@ -49,6 +49,10 @@ public class ASupportToolbar extends Toolbar {
         // 工具栏描边
         int nStroke = 5;
 
+        TypedArray taBorder = getContext().obtainStyledAttributes(new int[]{R.attr.borderCornerRadius});
+        float cornerRadius = taBorder.getDimension(0, 6 * getResources().getDisplayMetrics().density);
+        taBorder.recycle();
+
         //分别为开始颜色，中间夜色，结束颜色
         int colors0[] = { mEndColor , mCenterColor,  mStartColor};
         GradientDrawable gradientDrawable0;
@@ -57,7 +61,7 @@ public class ASupportToolbar extends Toolbar {
         gradientDrawable0.setShape(GradientDrawable.RECTANGLE);
         gradientDrawable0.setColors(colors0); //添加颜色组
         gradientDrawable0.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
-        gradientDrawable0.setCornerRadius(20);
+        gradientDrawable0.setCornerRadius(cornerRadius);
 
         int colors1[] = { mCenterColor , mCenterColor, mCenterColor };
         GradientDrawable gradientDrawable1;
@@ -66,7 +70,7 @@ public class ASupportToolbar extends Toolbar {
         gradientDrawable1.setShape(GradientDrawable.RECTANGLE);
         gradientDrawable1.setColors(colors1); //添加颜色组
         gradientDrawable1.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
-        gradientDrawable1.setCornerRadius(20);
+        gradientDrawable1.setCornerRadius(cornerRadius);
 
         int colors2[] = {  mEndColor, mCenterColor, mStartColor };
         GradientDrawable gradientDrawable2;
@@ -75,7 +79,7 @@ public class ASupportToolbar extends Toolbar {
         gradientDrawable2.setShape(GradientDrawable.RECTANGLE);
         gradientDrawable2.setColors(colors2); //添加颜色组
         gradientDrawable2.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
-        gradientDrawable2.setCornerRadius(20);
+        gradientDrawable2.setCornerRadius(cornerRadius);
 
         ld = new LayerDrawable(array); //参数为上面的Drawable数组
         ld.setLayerInset(2, nStroke * 2, nStroke * 2, getWidth() + nStroke * 2, getHeight() + nStroke * 2); 

libaes/src/main/java/cc/winboll/studio/libaes/views/AToolbar.java

@@ -51,6 +51,10 @@ public class AToolbar extends Toolbar {
         // 工具栏描边
         int nStroke = 5;
 
+        TypedArray taBorder = getContext().obtainStyledAttributes(new int[]{R.attr.borderCornerRadius});
+        float cornerRadius = taBorder.getDimension(0, 6 * getResources().getDisplayMetrics().density);
+        taBorder.recycle();
+
         //分别为开始颜色，中间夜色，结束颜色
         int colors0[] = { mEndColor , mCenterColor,  mStartColor};
         GradientDrawable gradientDrawable0;
@@ -59,7 +63,7 @@ public class AToolbar extends Toolbar {
         gradientDrawable0.setShape(GradientDrawable.RECTANGLE);
         gradientDrawable0.setColors(colors0); //添加颜色组
         gradientDrawable0.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
-        gradientDrawable0.setCornerRadius(20);
+        gradientDrawable0.setCornerRadius(cornerRadius);
 
         int colors1[] = { mCenterColor , mCenterColor, mCenterColor };
         GradientDrawable gradientDrawable1;
@@ -68,7 +72,7 @@ public class AToolbar extends Toolbar {
         gradientDrawable1.setShape(GradientDrawable.RECTANGLE);
         gradientDrawable1.setColors(colors1); //添加颜色组
         gradientDrawable1.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
-        gradientDrawable1.setCornerRadius(20);
+        gradientDrawable1.setCornerRadius(cornerRadius);
 
         int colors2[] = {  mEndColor, mCenterColor, mStartColor };
         GradientDrawable gradientDrawable2;
@@ -77,7 +81,7 @@ public class AToolbar extends Toolbar {
         gradientDrawable2.setShape(GradientDrawable.RECTANGLE);
         gradientDrawable2.setColors(colors2); //添加颜色组
         gradientDrawable2.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
-        gradientDrawable2.setCornerRadius(20);
+        gradientDrawable2.setCornerRadius(cornerRadius);
 
 
         ld = new LayerDrawable(array); //参数为上面的Drawable数组

libaes/src/main/res/drawable/acard_frame_main.xml

@@ -13,11 +13,7 @@
                 android:startColor="@color/colorACardShadow"
                 android:centerColor="@color/colorACardShadow"
                 android:endColor="@color/colorACardShadow"/> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item>
     <!-- 边框部分 -->
@@ -32,11 +28,7 @@
                 android:startColor="@color/colorACardFrame"
                 android:centerColor="@color/colorACardFrame"
                 android:endColor="@color/colorACardFrame"/> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item>
     <!-- 背景主体部分 -->
@@ -52,11 +44,7 @@
                 android:startColor="@color/colorACardBackgroung"
                 android:centerColor="@color/colorACardBackgroung"
                 android:endColor="@color/colorACardBackgroung"/> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item> 
 </layer-list>

libaes/src/main/res/drawable/atoolbar_frame.xml

@@ -13,11 +13,7 @@
                 android:startColor="?attr/attrAToolbarEndColor"
                 android:centerColor="?attr/attrAToolbarCenterColor"
                 android:endColor="?attr/attrAToolbarStartColor"/> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape>
     </item>
     <!-- 边框部分 -->
@@ -32,11 +28,7 @@
                 android:startColor="?attr/attrAToolbarCenterColor"
                 android:centerColor="?attr/attrAToolbarCenterColor"
                 android:endColor="?attr/attrAToolbarCenterColor"/> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item>
     <!-- 背景主体部分 -->
@@ -52,11 +44,7 @@
                 android:startColor="?attr/attrAToolbarStartColor"
                 android:centerColor="?attr/attrAToolbarCenterColor"
                 android:endColor="?attr/attrAToolbarEndColor"/> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item> 
 </layer-list>

libaes/src/main/res/drawable/bg_container_border.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@android:color/transparent" />
+    <stroke android:width="1dp" android:color="#FFB0B0B0" />
+    <corners android:radius="?attr/borderCornerRadius" />
+</shape>

libaes/src/main/res/drawable/bg_shadow.xml

@@ -12,11 +12,7 @@
                 android:angle="270" 
                 android:endColor="#0F000000" 
                 android:startColor="#0F000000" /> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item> 
     <!-- 背景部分 --> 
@@ -31,11 +27,7 @@
                 android:angle="270" 
                 android:endColor="@color/colorAccent" 
                 android:startColor="@color/colorAccent" /> 
-            <corners 
-                android:bottomLeftRadius="6dip" 
-                android:bottomRightRadius="6dip" 
-                android:topLeftRadius="6dip" 
-                android:topRightRadius="6dip" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
         </shape> 
     </item> 
 </layer-list>

libaes/src/main/res/drawable/ohpcts_frame.xml

@@ -9,7 +9,7 @@
                 android:startColor="@color/colorOHPCTSBackground"
                 android:centerColor="@color/colorOHPCTSBackground"
                 android:endColor="@color/colorOHPCTSBackground"/> 
-            <corners android:radius="6dip"/> 
+            <corners android:radius="?attr/borderCornerRadius"/> 
         </shape>
     </item>
     <!-- 第二进度条 -->
@@ -22,7 +22,7 @@
                     android:startColor="@color/colorOHPCTSSecondaryProgress"
                     android:centerColor="@color/colorOHPCTSSecondaryProgress"
                     android:endColor="@color/colorOHPCTSSecondaryProgress"/> 
-                <corners android:radius="6dip"/> 
+                <corners android:radius="?attr/borderCornerRadius"/> 
             </shape> 
         </clip>
     </item>
@@ -36,7 +36,7 @@
                     android:startColor="@color/colorOHPCTSProgress"
                     android:centerColor="@color/colorOHPCTSProgress"
                     android:endColor="@color/colorOHPCTSProgress"/> 
-                <corners android:radius="6dip"/> 
+                <corners android:radius="?attr/borderCornerRadius"/> 
             </shape> 
         </clip>
     </item> 

libaes/src/main/res/layout/activity_about.xml

@@ -4,7 +4,7 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<cc.winboll.studio.libaes.views.ASupportToolbar
 		android:layout_width="match_parent"
@@ -16,6 +16,6 @@
 		android:layout_width="match_parent"
 		android:layout_height="0dp"
 		android:layout_weight="1.0"
-		android:id="@+id/aboutviewroot_ll"/>
+		android:id="@+id/aboutviewroot_ll" android:background="@drawable/bg_container_border" />
 
 </LinearLayout>

libaes/src/main/res/layout/activity_drawer.xml

@@ -3,7 +3,7 @@
 	xmlns:android="http://schemas.android.com/apk/res/android"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="wrap_content">
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
 
 	<cc.winboll.studio.libaes.views.ASupportToolbar
 		android:layout_width="match_parent"
@@ -19,13 +19,13 @@
 		<LinearLayout
 			android:orientation="vertical"
 			android:layout_width="match_parent"
-			android:layout_height="match_parent">
+			android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 			<LinearLayout
 				android:layout_width="match_parent"
 				android:layout_height="0dp"
 				android:layout_weight="1.0"
-				android:id="@+id/activitydrawerLinearLayout1"/>
+				android:id="@+id/activitydrawerLinearLayout1" android:background="@drawable/bg_container_border" />
 		</LinearLayout>
 
         <com.baoyz.widget.PullRefreshLayout

libaes/src/main/res/layout/activity_drawerfragment.xml

@@ -4,7 +4,7 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<cc.winboll.studio.libaes.views.ASupportToolbar
 		android:layout_width="match_parent"
@@ -15,7 +15,7 @@
 		android:orientation="vertical"
 		android:layout_width="match_parent"
 		android:layout_height="0dp"
-		android:layout_weight="1.0">
+		android:layout_weight="1.0" android:background="@drawable/bg_container_border">
 
 		<androidx.drawerlayout.widget.DrawerLayout
 			android:layout_width="match_parent"
@@ -26,7 +26,7 @@
 			<FrameLayout
 				android:layout_width="match_parent"
 				android:layout_height="match_parent"
-				android:id="@+id/activitydrawerfragmentFrameLayout1"/>
+				android:id="@+id/activitydrawerfragmentFrameLayout1" android:background="@drawable/bg_container_border" />
 
 			<com.baoyz.widget.PullRefreshLayout
 				android:orientation="vertical"

libaes/src/main/res/layout/activity_secondarylibrary.xml

@@ -4,7 +4,7 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"

libaes/src/main/res/layout/activity_test_aboutfragment.xml

@@ -4,12 +4,12 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<FrameLayout
 		android:layout_width="match_parent"
 		android:layout_height="match_parent"
-		android:id="@+id/activitytestaboutfragmentFrameLayout1"/>
+		android:id="@+id/activitytestaboutfragmentFrameLayout1" android:background="@drawable/bg_container_border" />
 
 </LinearLayout>
 

libaes/src/main/res/layout/activity_testasupporttoolbar.xml

@@ -4,7 +4,7 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<cc.winboll.studio.libaes.views.ASupportToolbar
 		android:layout_width="match_parent"

libaes/src/main/res/layout/activity_testatoolbar.xml

@@ -4,7 +4,7 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<cc.winboll.studio.libaes.views.AToolbar
 		android:layout_width="match_parent"

libaes/src/main/res/layout/dialog_privacy_agreement.xml

@@ -13,7 +13,6 @@
         android:layout_height="wrap_content"
         android:text="用户须知"
         android:textSize="18sp"
-        android:textColor="@android:color/black"
         android:textStyle="bold"
         android:layout_marginBottom="16dp" />
 
@@ -22,14 +21,13 @@
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:orientation="vertical"
-        android:layout_marginBottom="20dp">
+        android:layout_marginBottom="20dp" android:background="@drawable/bg_container_border">
 
         <TextView
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:text="小米广告SDK隐私政策: "
-            android:textSize="14sp"
-            android:textColor="@android:color/darker_gray" />
+            android:textSize="14sp" />
 
         <!-- 可点击链接（用TextView承载，通过代码设置蓝色+下划线） -->
         <TextView
@@ -44,8 +42,7 @@
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:text="，点击链接查看完整政策"
-            android:textSize="14sp"
-            android:textColor="@android:color/darker_gray" />
+            android:textSize="14sp" />
     </LinearLayout>
 
     <!-- 按钮容器（水平排列） -->
@@ -53,7 +50,7 @@
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:orientation="horizontal"
-        android:gravity="end">
+        android:gravity="end" android:background="@drawable/bg_container_border">
 
         <Button
             android:id="@+id/btn_disagree"

libaes/src/main/res/layout/dialog_storagepath.xml

@@ -3,7 +3,7 @@
 	xmlns:android="http://schemas.android.com/apk/res/android"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"
@@ -22,7 +22,7 @@
 		android:orientation="horizontal"
 		android:layout_width="match_parent"
 		android:layout_height="wrap_content"
-		android:gravity="end">
+		android:gravity="end" android:background="@drawable/bg_container_border">
 
 		<Button
 			android:layout_width="wrap_content"

libaes/src/main/res/layout/fragment_abutton.xml

@@ -3,7 +3,7 @@
 	xmlns:android="http://schemas.android.com/apk/res/android"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"

libaes/src/main/res/layout/fragment_viewpage.xml

@@ -5,7 +5,7 @@
 	android:orientation="vertical"
 	android:layout_width="match_parent"
 	android:layout_height="match_parent"
-	android:gravity="center_vertical">
+	android:gravity="center_vertical" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"
@@ -23,7 +23,7 @@
 		android:layout_height="60dp"
 		android:orientation="horizontal"
 		android:gravity="center"
-		android:id="@+id/fragmentviewpageLinearLayout1">
+		android:id="@+id/fragmentviewpageLinearLayout1" android:background="@drawable/bg_container_border">
 
 		<ImageView
 			android:layout_width="wrap_content"

libaes/src/main/res/layout/listview_drawermenu.xml

@@ -5,7 +5,7 @@
     android:layout_width="match_parent"
     android:layout_height="48dp"
     android:gravity="center_vertical"
-    android:orientation="horizontal">
+    android:orientation="horizontal" android:background="@drawable/bg_container_border">
 
     <ImageView
         android:layout_centerVertical="true"

libaes/src/main/res/layout/view_adsbanner.xml

@@ -4,12 +4,12 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:id="@+id/ads_container"
 	android:layout_width="match_parent"
-	android:layout_height="wrap_content">
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
 
 	<LinearLayout
 		android:id="@+id/ads_container"
 		android:layout_width="match_parent"
 		android:layout_height="wrap_content"
-		android:orientation="vertical"/>
+		android:orientation="vertical" android:background="@drawable/bg_container_border" />
 
 </LinearLayout>

libaes/src/main/res/layout/view_adscontrol.xml

@@ -4,14 +4,13 @@
     android:layout_width="match_parent"
     android:layout_height="wrap_content"
     android:orientation="vertical"
-    android:padding="16dp">
+    android:padding="16dp" android:background="@drawable/bg_container_border">
 
     <TextView
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="应用支持模式设置："
         android:textSize="16sp"
-        android:textColor="@android:color/black"
         android:layout_marginBottom="12dp"/>
 
     <RadioGroup
@@ -26,7 +25,6 @@
             android:layout_height="wrap_content"
             android:text="无扰单机模式"
             android:textSize="14sp"
-            android:textColor="@android:color/darker_gray"
             android:layout_marginBottom="8dp"/>
 
         <RadioButton
@@ -35,7 +33,6 @@
             android:layout_height="wrap_content"
             android:text="米盟广告模式"
             android:textSize="14sp"
-            android:textColor="@android:color/darker_gray"
             android:layout_marginBottom="8dp"/>
 
         <RadioButton
@@ -43,8 +40,7 @@
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:text="云宝物语模式"
-            android:textSize="14sp"
-            android:textColor="@android:color/darker_gray"/>
+            android:textSize="14sp"/>
 
     </RadioGroup>
 
@@ -54,7 +50,7 @@
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:visibility="gone"
-        android:layout_marginTop="0dp"> <!-- 移除顶部多余间距 -->
+        android:layout_marginTop="0dp"> <!-- 移除顶部多余间距 -- android:background="@drawable/bg_container_border">
 
         <ImageView
             android:id="@+id/iv_winboll_store"

libaes/src/main/res/layout/viewpage_acard.xml

@@ -3,7 +3,7 @@
 	xmlns:android="http://schemas.android.com/apk/res/android"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"

libaes/src/main/res/layout/viewpage_aohpctccard.xml

@@ -3,7 +3,7 @@
 	xmlns:android="http://schemas.android.com/apk/res/android"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"

libaes/src/main/res/layout/viewpage_aohpctcsb.xml

@@ -4,7 +4,7 @@
 	android:orientation="vertical"
 	android:layout_width="match_parent"
 	android:layout_height="match_parent"
-	android:gravity="center">
+	android:gravity="center" android:background="@drawable/bg_container_border">
 
 	<TextView
         android:layout_width="wrap_content"
@@ -15,7 +15,7 @@
         android:orientation="vertical"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
-        android:gravity="center">
+        android:gravity="center" android:background="@drawable/bg_container_border">
 
         <cc.winboll.studio.libaes.views.AOHPCTCSeekBar
             android:layout_width="300dp"

libaes/src/main/res/layout/viewpage_atickprogressbar.xml

@@ -3,7 +3,7 @@
 	xmlns:android="http://schemas.android.com/apk/res/android"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
-	android:layout_height="match_parent">
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
 
 	<TextView
 		android:layout_width="wrap_content"

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

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     
+    <attr name="borderCornerRadius" format="dimension" />
     <attr name="colorTextColor" format="color" />
     <attr name="colorPrimary" format="color" />
     <attr name="colorPrimaryDark" format="color" />

libappbase/.gitignore

@@ -0,0 +1 @@
+/build

libappbase/build.gradle

@@ -0,0 +1,38 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        minSdkVersion 26
+        targetSdkVersion 30
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+     compileOptions {
+         sourceCompatibility JavaVersion.VERSION_1_7
+         targetCompatibility JavaVersion.VERSION_1_7
+     }
+}
+
+dependencies {
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// Gson
+	api 'com.google.code.gson:gson:2.8.9'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+	// 添加JSch依赖（SFTP核心，com.jcraft:jsch:0.1.54）
+	api 'com.jcraft:jsch:0.1.54'
+
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}

libappbase/build.properties

@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Tue May 12 09:16:45 HKT 2026
+stageCount=10
+libraryProject=libappbase
+baseVersion=15.20
+publishVersion=15.20.9
+buildCount=0
+baseBetaVersion=15.20.10

libappbase/proguard-rules.pro

@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:/tools/adt-bundle-windows-x86_64-20131030/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}

libappbase/src/main/AndroidManifest.xml

@@ -0,0 +1,59 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.libappbase">
+
+    <!-- 拥有完全的网络访问权限 -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+
+    <!-- 读取您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <!-- 修改或删除您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <!-- MANAGE_EXTERNAL_STORAGE -->
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <application
+        android:requestLegacyExternalStorage="true"
+        android:networkSecurityConfig="@xml/network_security_config">
+
+        <activity
+            android:name=".CrashHandler$CrashActivity"
+            android:label="CrashActivity"
+            android:launchMode="singleInstance"
+            android:process=":CrashActivity"/>
+
+        <activity
+            android:name=".GlobalCrashActivity"
+            android:label="GlobalCrashActivity"
+            android:launchMode="singleInstance"
+            android:process=":GlobalCrashActivity"/>
+
+        <activity
+            android:name=".LogActivity"
+            android:label="LogActivity"
+            android:resizeableActivity="true"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation"
+            android:exported="true"
+            android:launchMode="singleInstance"
+            android:taskAffinity="cc.winboll.studio.libappbase.LogActivity"
+            android:process=":LogActivity">
+
+        </activity>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.NfcRsaLoginActivity"/>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.FTPBackupsActivity"/>
+
+        <activity
+            android:name=".utils.ShareLogActivity"
+            android:label="ShareLogActivity"
+            android:exported="true"
+            android:launchMode="singleTask"
+            android:theme="@android:style/Theme.NoDisplay"/>
+
+    </application>
+
+</manifest>

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

@@ -0,0 +1,138 @@
+package cc.winboll.studio.libappbase;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:01
+ * @Describe WinBoLL 应用全局数据模型类
+ * 继承自 BaseBean，用于存储和管理应用的核心配置信息（如调试状态），
+ * 支持 JSON 序列化/反序列化，便于数据持久化或跨组件传递
+ */
+public class APPModel extends BaseBean {
+
+    /**
+     * 日志打印标签，用于区分当前类的日志输出
+     */
+    public static final String TAG = "APPModel";
+
+    /**
+     * 应用调试状态标识
+     * true：应用处于调试模式（可输出详细日志、启用调试功能等）
+     * false：应用处于正式模式（关闭调试相关功能，优化性能）
+     */
+    private boolean isDebugging = false; // 修正拼写：原 isDebuging -> isDebugging（符合命名规范）
+
+    /**
+     * 无参构造方法
+     * 初始化调试状态为默认值：false（正式模式）
+     */
+    public APPModel() {
+        this.isDebugging = false;
+    }
+
+    /**
+     * 带参构造方法
+     * 可通过参数指定应用的初始调试状态
+     * @param isDebugging 初始调试状态（true：调试模式；false：正式模式）
+     */
+    public APPModel(boolean isDebugging) {
+        this.isDebugging = isDebugging;
+    }
+
+    /**
+     * 设置应用调试状态
+     * @param isDebugging 目标调试状态（true：开启调试；false：关闭调试）
+     */
+    public void setIsDebugging(boolean isDebugging) {
+        this.isDebugging = isDebugging;
+    }
+
+    /**
+     * 获取当前应用调试状态
+     * @return 调试状态（true：调试中；false：非调试）
+     */
+    public boolean isDebugging() {
+        return isDebugging;
+    }
+
+    /**
+     * 重写父类方法，返回当前类的全限定名
+     * 用于标识数据模型的类类型（可用于反射、序列化校验等场景）
+     * @return 类的全限定名（如：cc.winboll.studio.libappbase.APPModel）
+     */
+    @Override
+    public String getName() {
+        return APPModel.class.getName();
+    }
+
+    /**
+     * 重写父类方法，将当前模型的字段序列化到 JSON 中
+     * 用于将调试状态等核心数据转换为 JSON 格式（如持久化到文件、网络传输）
+     * @param jsonWriter JSON 写入器对象，用于输出 JSON 数据
+     * @throws IOException 当 JSON 写入失败时抛出（如流关闭、格式错误）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        // 先调用父类方法，序列化父类中的字段（若 BaseBean 有可序列化字段）
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化当前类的调试状态字段：key 为 "isDebuging"（保持与原代码一致，避免兼容性问题），value 为当前状态
+        jsonWriter.name("isDebuging").value(isDebugging());
+    }
+
+    /**
+     * 重写父类方法，从 JSON 中解析字段并初始化当前对象
+     * 用于将 JSON 格式的配置数据解析为 APPModel 实例（如从文件读取、网络接收后解析）
+     * @param jsonReader JSON 读取器对象，用于读取 JSON 数据
+     * @param name 当前解析的 JSON 字段名
+     * @return true：字段解析成功；false：字段不属于当前类，需由调用者处理
+     * @throws IOException 当 JSON 读取失败时抛出（如流关闭、数据格式错误）
+     */
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 先调用父类方法，解析父类中的字段（若 BaseBean 有可解析字段）
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            return true; // 父类已处理该字段，直接返回成功
+        } else {
+            // 解析当前类的字段
+            if (name.equals("isDebuging")) {
+                // 读取 JSON 中 "isDebuging" 字段的值，设置为当前对象的调试状态
+                setIsDebugging(jsonReader.nextBoolean());
+            } else {
+                // 字段不属于当前类，返回 false 提示调用者跳过该字段
+                return false;
+            }
+        }
+        // 字段解析成功，返回 true
+        return true;
+    }
+
+    /**
+     * 重写父类方法，从 JSON 读取器中完整解析一个 APPModel 实例
+     * 负责处理 JSON 对象的开始/结束标记，循环解析所有字段
+     * @param jsonReader JSON 读取器对象，用于读取 JSON 数据
+     * @return 解析完成的当前 APPModel 实例（支持链式调用）
+     * @throws IOException 当 JSON 读取失败时抛出（如流关闭、数据格式错误）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        // 开始解析 JSON 对象（对应 JSON 中的 '{'）
+        jsonReader.beginObject();
+        // 循环读取 JSON 中的所有字段（直到对象结束）
+        while (jsonReader.hasNext()) {
+            // 获取当前字段名
+            String name = jsonReader.nextName();
+            // 解析字段：若当前类无法处理该字段，则跳过（避免解析异常）
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束解析 JSON 对象（对应 JSON 中的 '}'）
+        jsonReader.endObject();
+        // 返回解析完成的实例（当前对象）
+        return this;
+    }
+}
+

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

@@ -0,0 +1,194 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.ObjectInputStream;
+import java.io.ObjectOutputStream;
+
+/**
+ * 应用崩溃保险丝内部类（单例）
+ * 核心作用：限制短时间内重复崩溃，通过「熔断等级」控制崩溃页面启动策略
+ * 等级范围：MINI（1）~ MAX（2），每次崩溃等级-1，熔断后启动基础版崩溃页面
+ */
+public final class AppCrashSafetyWire {
+	
+	public static final String TAG = "AppCrashSafetyWire";
+	
+	/** 单例实例（volatile 保证多线程可见性） */
+	private static volatile AppCrashSafetyWire _AppCrashSafetyWire;
+
+	/** 当前熔断等级（1：最低防护；2：最高防护；≤0：熔断） */
+	private volatile Integer currentSafetyLevel;
+	/** 最低熔断等级（1，再崩溃则熔断） */
+	private static final int _MINI = 1;
+	/** 最高熔断等级（2，初始状态） */
+	private static final int _MAX = 2;
+
+	/**
+	 * 私有构造方法（单例模式，禁止外部实例化）
+	 * 初始化时加载本地存储的熔断等级
+	 */
+	private AppCrashSafetyWire() {
+		LogUtils.d(TAG, "AppCrashSafetyWire()");
+		currentSafetyLevel = loadCurrentSafetyLevel();
+	}
+
+	/**
+	 * 获取单例实例（双重检查锁定，线程安全）
+	 * @return AppCrashSafetyWire 单例
+	 */
+	public static synchronized AppCrashSafetyWire getInstance() {
+		if (_AppCrashSafetyWire == null) {
+			_AppCrashSafetyWire = new AppCrashSafetyWire();
+		}
+		return _AppCrashSafetyWire;
+	}
+
+	/**
+	 * 设置当前熔断等级（内存中）
+	 * @param currentSafetyLevel 目标等级（1~2）
+	 */
+	public void setCurrentSafetyLevel(int currentSafetyLevel) {
+		this.currentSafetyLevel = currentSafetyLevel;
+	}
+
+	/**
+	 * 获取当前熔断等级（内存中）
+	 * @return 当前等级（1~2 或 null）
+	 */
+	public int getCurrentSafetyLevel() {
+		return currentSafetyLevel;
+	}
+
+	/**
+	 * 保存熔断等级到本地文件（持久化，重启应用生效）
+	 * @param currentSafetyLevel 待保存的等级
+	 */
+	public void saveCurrentSafetyLevel(int currentSafetyLevel) {
+		LogUtils.d(TAG, "saveCurrentSafetyLevel()");
+		this.currentSafetyLevel = currentSafetyLevel;
+		try {
+			// 序列化等级到文件（ObjectOutputStream 写入 int）
+			ObjectOutputStream oos = new ObjectOutputStream(new FileOutputStream(CrashHandler._CrashCountFilePath));
+			oos.writeInt(currentSafetyLevel);
+			oos.flush();
+			oos.close();
+			LogUtils.d(TAG, String.format("saveCurrentSafetyLevel writeInt currentSafetyLevel %d", currentSafetyLevel));
+		} catch (IOException e) {
+			LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+		}
+	}
+
+	/**
+	 * 从本地文件加载熔断等级（应用启动时初始化）
+	 * @return 加载的等级（文件不存在则初始化为 MAX（2））
+	 */
+	public int loadCurrentSafetyLevel() {
+		LogUtils.d(TAG, "loadCurrentSafetyLevel()");
+		try {
+			File f = new File(CrashHandler._CrashCountFilePath);
+			if (f.exists()) {
+				// 反序列化从文件读取等级
+				ObjectInputStream ois = new ObjectInputStream(new FileInputStream(CrashHandler._CrashCountFilePath));
+				currentSafetyLevel = ois.readInt();
+				LogUtils.d(TAG, String.format("loadCurrentSafetyLevel() readInt currentSafetyLevel %d", currentSafetyLevel));
+			} else {
+				// 文件不存在，初始化等级为最高（2）并保存
+				currentSafetyLevel = _MAX;
+				LogUtils.d(TAG, String.format("loadCurrentSafetyLevel() currentSafetyLevel init to _MAX->%d", _MAX));
+				saveCurrentSafetyLevel(currentSafetyLevel);
+			}
+		} catch (IOException e) {
+			LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+		}
+		return currentSafetyLevel;
+	}
+
+	/**
+	 * 熔断保险丝（每次崩溃调用，降低防护等级）
+	 * @return 熔断后是否仍在防护范围内（true：是；false：已熔断）
+	 */
+	boolean burnSafetyWire() {
+		LogUtils.d(TAG, "burnSafetyWire()");
+		// 加载当前等级
+		int safeLevel = loadCurrentSafetyLevel();
+		// 若在防护范围内（1~2），等级-1 并保存
+		if (isSafetyWireWorking(safeLevel)) {
+			LogUtils.d(TAG, "burnSafetyWire() use");
+			saveCurrentSafetyLevel(safeLevel - 1);
+			// 返回熔断后的状态
+			return isSafetyWireWorking(safeLevel - 1);
+		}
+		return false;
+	}
+
+	/**
+	 * 检查熔断等级是否在有效范围内（1~2）
+	 * @param safetyLevel 待检查的等级
+	 * @return true：在范围内（防护有效）；false：超出范围（已熔断）
+	 */
+	boolean isSafetyWireWorking(int safetyLevel) {
+		LogUtils.d(TAG, "isSafetyWireOK()");
+		LogUtils.d(TAG, String.format("SafetyLevel %d", safetyLevel));
+
+		if (safetyLevel >= _MINI && safetyLevel <= _MAX) {
+			LogUtils.d(TAG, String.format("In Safety Level"));
+			return true;
+		}
+		LogUtils.d(TAG, String.format("Out of Safety Level"));
+		return false;
+	}
+
+	/**
+	 * 立即恢复熔断等级到最高（2）
+	 * 用于重启应用后重置防护状态
+	 */
+	void resumeToMaximumImmediately() {
+		LogUtils.d(TAG, "resumeToMaximumImmediately() call saveCurrentSafetyLevel(_MAX)");
+		AppCrashSafetyWire.getInstance().saveCurrentSafetyLevel(_MAX);
+	}
+
+	/**
+	 * 关闭防护（设置等级为最低（1））
+	 * 下次崩溃直接熔断
+	 */
+	void off() {
+		LogUtils.d(TAG, "off()");
+		saveCurrentSafetyLevel(_MINI);
+	}
+
+	/**
+	 * 检查当前保险丝是否有效（防护未熔断）
+	 * @return true：有效（等级 1~2）；false：已熔断
+	 */
+	public boolean isAppCrashSafetyWireOK() {
+		LogUtils.d(TAG, "isAppCrashSafetyWireOK()");
+		currentSafetyLevel = loadCurrentSafetyLevel();
+		return isSafetyWireWorking(currentSafetyLevel);
+	}
+
+	/**
+	 * 延迟恢复保险丝到最高等级（500ms 后）
+	 * 核心作用：崩溃页面启动后，若下次即将熔断，提前恢复防护等级，避免持续崩溃
+	 * @param context 上下文（用于获取主线程 Handler）
+	 */
+	void postResumeCrashSafetyWireHandler(final Context context) {
+		// 主线程延迟 500ms 执行（避免页面启动时阻塞）
+		new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "Handler run()");
+					// 检查：若当前等级-1 后超出防护范围（即将熔断），则恢复到最高等级
+					if (!AppCrashSafetyWire.getInstance().isSafetyWireWorking(currentSafetyLevel - 1)) {
+						AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+						LogUtils.d(TAG, "postResumeCrashSafetyWireHandler: 恢复保险丝到最高等级");
+					}
+				}
+			}, 500);
+	}
+}

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

@@ -0,0 +1,436 @@
+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/CrashHandler.java

@@ -0,0 +1,330 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Activity;
+import android.app.Application;
+import android.content.ActivityNotFoundException;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.res.Resources;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+import android.widget.HorizontalScrollView;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.utils.CrashHandleNotifyUtils;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.ObjectInputStream;
+import java.io.ObjectOutputStream;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+
+/**
+ * 应用全局崩溃处理类（单例逻辑）
+ * 核心功能：捕获应用未捕获异常，记录崩溃日志到文件，启动崩溃报告页面，
+ * 并通过「崩溃保险丝」机制防止重复崩溃，保障基础功能可用
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025/11/11 20:14:00
+ * @EditTime 2026/05/11 15:36:45
+ */
+public final class CrashHandler {
+
+    // ====================== 常量定义 ======================
+    /** 日志标签 */
+    public static final String TAG = "CrashHandler";
+    /** 崩溃报告页面标题 */
+    public static final String TITTLE = "CrashReport";
+    /** Intent 传递崩溃信息键 */
+    public static final String EXTRA_CRASH_LOG = "crashInfo";
+    /** SharedPreferences 存储键 */
+    static final String PREFS = CrashHandler.class.getName() + "PREFS";
+    /** 标记是否发生崩溃键 */
+    static final String PREFS_CRASHHANDLER_ISCRASHHAPPEN = "PREFS_CRASHHANDLER_ISCRASHHAPPEN";
+
+    // ====================== 成员变量 ======================
+    /** 崩溃保险丝状态文件路径 */
+    public static String _CrashCountFilePath;
+    /** 系统默认异常处理器兜底 */
+    public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER
+	= Thread.getDefaultUncaughtExceptionHandler();
+
+    // ====================== 对外初始化方法 ======================
+    /**
+     * 初始化崩溃处理器（默认存储路径）
+     * @param app 全局Application实例
+     */
+    public static void init(final Application app) {
+        _CrashCountFilePath = app.getExternalFilesDir("CrashHandler") + "/IsCrashHandlerCrashHappen.dat";
+        LogUtils.d(TAG, "init _CrashCountFilePath = " + _CrashCountFilePath);
+        init(app, null);
+    }
+
+    /**
+     * 初始化崩溃处理器（自定义日志目录）
+     * @param app 全局Application实例
+     * @param crashDir 自定义崩溃日志目录，传null使用默认
+     */
+    public static void init(final Application app, final String crashDir) {
+        Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandler() {
+				@Override
+				public void uncaughtException(final Thread thread, final Throwable throwable) {
+					try {
+						tryUncaughtException(thread, throwable, crashDir, app);
+					} catch (Throwable e) {
+						LogUtils.e(TAG, "uncaughtException error", e);
+						if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+							DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+						}
+					}
+				}
+			});
+    }
+
+    // ====================== 内部崩溃处理核心 ======================
+    /**
+     * 执行崩溃信息收集、日志写入、跳转崩溃页面
+     */
+    private static void tryUncaughtException(final Thread thread,
+											 final Throwable throwable,
+											 final String crashDir,
+											 final Application app) {
+        // 触发崩溃保险丝
+        AppCrashSafetyWire.getInstance().burnSafetyWire();
+
+        // 格式化时间
+        final String time = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss",
+												 Locale.getDefault()).format(new Date());
+
+        // 创建日志文件
+        File logParent = TextUtils.isEmpty(crashDir)
+			? new File(app.getExternalFilesDir(null), "crash")
+			: new File(crashDir);
+        final File crashFile = new File(logParent, "crash_" + time + ".txt");
+
+        // 获取应用版本信息
+        String versionName = "unknown";
+        long versionCode = 0;
+        try {
+            final PackageInfo packageInfo = app.getPackageManager()
+				.getPackageInfo(app.getPackageName(), 0);
+            versionName = packageInfo.versionName;
+            if (Build.VERSION.SDK_INT >= 28) {
+                versionCode = packageInfo.getLongVersionCode();
+            } else {
+                versionCode = packageInfo.versionCode;
+            }
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "get package info fail");
+        }
+
+        // 抓取异常堆栈
+        String fullStackTrace;
+        StringWriter sw = new StringWriter();
+        PrintWriter pw = new PrintWriter(sw);
+        throwable.printStackTrace(pw);
+        fullStackTrace = sw.toString();
+        pw.close();
+
+        // 拼接崩溃头部信息
+        StringBuilder sb = new StringBuilder();
+        sb.append("************* Crash Head ****************\n");
+        sb.append("Time Of Crash                        : ").append(time).append("\n");
+        sb.append("Device Manufacturer                  : ").append(Build.MANUFACTURER).append("\n");
+        sb.append("Device Model                         : ").append(Build.MODEL).append("\n");
+        sb.append("Android Version                      : ").append(Build.VERSION.RELEASE).append("\n");
+        sb.append("Android SDK                          : ").append(Build.VERSION.SDK_INT).append("\n");
+        sb.append("App VersionName                      : ").append(versionName).append("\n");
+        sb.append("App VersionCode                      : ").append(versionCode).append("\n");
+        sb.append("************* Crash Head ****************\n");
+        sb.append("\n").append(fullStackTrace);
+
+        final String errorLog = sb.toString();
+
+        // 写入日志文件
+        try {
+            writeFile(crashFile, errorLog);
+        } catch (IOException e) {
+            LogUtils.e(TAG, "write crash log file fail");
+        }
+
+        // 跳转崩溃页面
+        gotoCrashActivity(errorLog, app);
+    }
+
+    /**
+     * 写入文本到文件
+     */
+    private static void writeFile(final File file, final String content) throws IOException {
+        final File parentFile = file.getParentFile();
+        if (parentFile != null && !parentFile.exists()) {
+            parentFile.mkdirs();
+        }
+        file.createNewFile();
+        FileOutputStream fos = new FileOutputStream(file);
+        fos.write(content.getBytes());
+        fos.close();
+    }
+
+    /**
+     * 根据保险丝状态跳转对应崩溃页面
+     */
+    private static void gotoCrashActivity(final String errorLog, final Application app) {
+        final Intent intent = new Intent();
+        if (AppCrashSafetyWire.getInstance().isAppCrashSafetyWireOK()) {
+            intent.setClass(app, GlobalCrashActivity.class);
+        } else {
+            intent.setClass(app, CrashActivity.class);
+        }
+        intent.putExtra(EXTRA_CRASH_LOG, errorLog);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
+						| Intent.FLAG_ACTIVITY_CLEAR_TOP
+						| Intent.FLAG_ACTIVITY_CLEAR_TASK);
+
+        try {
+            if (GlobalApplication.isDebugging()) {
+                app.startActivity(intent);
+            } else {
+                CrashHandleNotifyUtils.handleUncaughtException(app, intent, GlobalCrashActivity.class);
+            }
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        } catch (ActivityNotFoundException e) {
+            LogUtils.e(TAG, "CrashActivity not found");
+            if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+                DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(Thread.currentThread(), e);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "start CrashActivity error");
+            if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+                DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(Thread.currentThread(), e);
+            }
+        }
+    }
+
+    // ====================== 内部Activity页面 ======================
+    /**
+     * 基础极简崩溃页面
+     * 保险丝熔断时启动，避免复杂布局二次崩溃
+     */
+    public static final class CrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
+        private static final int MENUITEM_COPY = 0;
+        private static final int MENUITEM_RESTART = 1;
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(final Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+            AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(getApplicationContext());
+            mLog = getIntent().getStringExtra(EXTRA_CRASH_LOG);
+            setTheme(android.R.style.Theme_DeviceDefault_Light_DarkActionBar);
+            initLayout();
+        }
+
+        /**
+         * 动态初始化布局
+         */
+        private void initLayout() {
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+
+            HorizontalScrollView hw = new HorizontalScrollView(this);
+            hw.setBackgroundColor(0xFFF5F5F5);
+
+            TextView message = new TextView(this);
+            final int padding = dp2px(16);
+            message.setPadding(padding, padding, padding, padding);
+            message.setText(mLog);
+            message.setTextColor(0xFF000000);
+            message.setTextIsSelectable(true);
+
+            hw.addView(message);
+            contentView.addView(hw, ViewGroup.LayoutParams.MATCH_PARENT,
+								ViewGroup.LayoutParams.MATCH_PARENT);
+            setContentView(contentView);
+
+            getActionBar().setTitle(TITTLE);
+            getActionBar().setSubtitle(GlobalApplication.class.getSimpleName() + " Error");
+        }
+
+        @Override
+        public void onBackPressed() {
+            restartApp();
+        }
+
+        /**
+         * 重启应用
+         */
+        private void restartApp() {
+            final Intent intent = getPackageManager()
+				.getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
+								| Intent.FLAG_ACTIVITY_CLEAR_TOP
+								| Intent.FLAG_ACTIVITY_CLEAR_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        /**
+         * dp转px
+         */
+        private int dp2px(final float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(final Menu menu) {
+            menu.add(0, MENUITEM_COPY, 0, "Copy")
+				.setOnMenuItemClickListener(this)
+				.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+
+            menu.add(0, MENUITEM_RESTART, 0, "Restart")
+				.setOnMenuItemClickListener(this)
+				.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+            return true;
+        }
+
+        @Override
+        public boolean onMenuItemClick(final MenuItem item) {
+            switch (item.getItemId()) {
+                case MENUITEM_COPY:
+                    ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+                    Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
+                    break;
+                case MENUITEM_RESTART:
+                    AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+                    restartApp();
+                    break;
+                default:
+                    break;
+            }
+            return false;
+        }
+    }
+}
+

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

@@ -0,0 +1,224 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Application;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.PackageManager.NameNotFoundException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 19:56
+ * @Describe 全局 Application 类，用于初始化应用核心组件、管理全局状态（如调试模式）
+ * 需在 AndroidManifest.xml 中配置 android:name=".GlobalApplication" 使其生效
+ */
+public class GlobalApplication extends Application {
+
+    /** 日志标签 */
+    public static final String TAG = "GlobalApplication";
+
+    /** 全局 Application 单例实例（volatile 保证多线程可见性，避免指令重排） */
+    private static volatile GlobalApplication sInstance;
+
+    /**
+     * 应用调试模式标记（volatile 保证多线程可见性）
+     * true：调试模式（开启日志、调试功能）；false：正式模式（关闭调试相关功能）
+     */
+    private static volatile boolean isDebugging = false;
+
+    // 新增：WinBoLL 服务器主机地址（volatile 保证多线程可见性）
+    private static volatile String winbollHost = null;
+    // 新增：SP 存储相关常量（私有存储，仅当前应用可访问）
+    private static final String SP_NAME = "WinBoLL_SP_CONFIG";
+    private static final String SP_KEY_WINBOLL_HOST = "winboll_host";
+
+    /**
+     * 获取全局 Application 单例实例（外部可通过此方法获取上下文）
+     * @return GlobalApplication 单例（未初始化时返回 null，需确保配置 AndroidManifest）
+     */
+    public static GlobalApplication getInstance() {
+        return sInstance;
+    }
+
+    /**
+     * 设置应用调试模式
+     * @param debugging 调试模式状态（true/false）
+     */
+    public static void setIsDebugging(boolean debugging) {
+        isDebugging = debugging;
+    }
+
+    /**
+     * 保存调试模式状态到本地文件（持久化存储，重启应用后生效）
+     * @param application 全局 Application 实例（通过 getInstance() 获取更规范）
+     */
+    public static void saveDebugStatus(GlobalApplication application) {
+        if (application == null) {
+            LogUtils.e(TAG, "saveDebugStatus: Application 实例为空，保存失败");
+            return;
+        }
+        // 将调试状态封装为 APPModel 并保存到文件
+        APPModel.saveBeanToFile(
+            getAppModelFilePath(application),
+            new APPModel(isDebugging)
+        );
+    }
+
+    /**
+     * 获取 APPModel 配置文件的存储路径
+     * 路径：应用私有数据目录 / APPModel.json（仅当前应用可访问，安全）
+     * @param application 全局 Application 实例
+     * @return 配置文件绝对路径
+     */
+    private static String getAppModelFilePath(GlobalApplication application) {
+        return application.getDataDir().getPath() + "/APPModel.json";
+    }
+
+    /**
+     * 获取当前应用调试模式状态
+     * @return true：调试模式；false：正式模式
+     */
+    public static boolean isDebugging() {
+        return isDebugging;
+    }
+
+	// 新增：设置 WinBoLL 服务器主机地址（同时保存到 SP 持久化）
+	public static void setWinbollHost(String host) {
+		if (sInstance == null) {
+			LogUtils.e(TAG, "setWinbollHost: 应用未初始化，设置失败");
+			return;
+		}
+		// 检查并补全末尾 /  核心改动
+		if (host != null && !host.isEmpty() && !host.endsWith("/")) {
+			host += "/";
+		}
+		// 更新内存中的字段
+		winbollHost = host;
+		// 保存到 SP 持久化（私有模式，安全）
+		SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+		sp.edit().putString(SP_KEY_WINBOLL_HOST, host).apply();
+		LogUtils.d(TAG, "setWinbollHost: 服务器地址已设置并持久化，host=" + host);
+	}
+
+
+    // 新增：获取 WinBoLL 服务器主机地址（优先内存，内存为空则从 SP 读取）
+    public static String getWinbollHost() {
+        if (winbollHost != null) {
+            // 内存中存在，直接返回（提高效率）
+            return winbollHost;
+        }
+        if (sInstance == null) {
+            LogUtils.e(TAG, "getWinbollHost: 应用未初始化，获取失败");
+            return null;
+        }
+        // 内存中不存在，从 SP 读取并更新到内存
+        SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        winbollHost = sp.getString(SP_KEY_WINBOLL_HOST, "https://console.winboll.cc/");
+        LogUtils.d(TAG, "getWinbollHost: 从 SP 读取服务器地址，host=" + winbollHost);
+        return winbollHost;
+    }
+
+    /**
+     * 应用启动时初始化（仅执行一次）
+     * 初始化核心框架、恢复调试状态、配置全局异常处理等
+     */
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        // 初始化单例实例（确保在所有初始化操作前完成）
+        sInstance = this;
+
+        // 初始化基础组件（日志、崩溃处理、Toast）
+        initCoreComponents();
+        // 恢复/初始化调试模式状态（从本地文件读取，无文件则默认关闭调试）
+        restoreDebugStatus();
+        // 新增：初始化服务器地址（从 SP 读取到内存，提高后续访问效率）
+        initWinbollHost();
+
+        LogUtils.d(TAG, "GlobalApplication 初始化完成，单例实例已创建");
+    }
+
+    /**
+     * 初始化应用核心组件（日志、崩溃处理、Toast 框架）
+     */
+    private void initCoreComponents() {
+        // 初始化日志工具（传入 Application 上下文）
+        LogUtils.init(this);
+        // 初始化全局异常处理器（捕获应用崩溃信息，用于调试或上报）
+        CrashHandler.init(this);
+        // 初始化 Toast 工具（统一 Toast 样式、避免内存泄漏等）
+        ToastUtils.init(this);
+    }
+
+    /**
+     * 恢复调试模式状态（从本地配置文件读取）
+     * 1. 读取本地 APPModel.json 文件
+     * 2. 读取成功：使用保存的调试状态；读取失败（文件不存在）：默认关闭调试并创建配置文件
+     */
+    private void restoreDebugStatus() {
+        // 从文件加载 APPModel 实例（存储调试状态的模型类）
+        APPModel appModel = APPModel.loadBeanFromFile(
+            getAppModelFilePath(this),
+            APPModel.class
+        );
+
+        if (appModel == null) {
+            // 配置文件不存在，默认关闭调试模式并创建文件
+            setIsDebugging(false);
+            saveDebugStatus(this);
+            LogUtils.d(TAG, "调试配置文件不存在，默认关闭调试模式并创建配置文件");
+        } else {
+            // 配置文件存在，使用保存的调试状态
+            setIsDebugging(appModel.isDebugging());
+            LogUtils.d(TAG, "从配置文件恢复调试模式：" + isDebugging);
+        }
+    }
+
+    // 新增：初始化服务器地址（应用启动时从 SP 读取到内存）
+    private void initWinbollHost() {
+        getWinbollHost(); // 触发从 SP 读取并更新内存
+    }
+
+    /**
+     * 获取应用名称（从 AndroidManifest.xml 的 android:label 读取）
+     * @param context 上下文（建议传入 Application 上下文，避免内存泄漏）
+     * @return 应用名称（读取失败返回 null）
+     */
+    public static String getAppName(Context context) {
+        if (context == null) {
+            LogUtils.w(TAG, "getAppName: 上下文为空，返回 null");
+            return null;
+        }
+        PackageManager packageManager = context.getPackageManager();
+        try {
+            // 获取应用信息（包含应用名称、图标等）
+            ApplicationInfo applicationInfo = packageManager.getApplicationInfo(
+                context.getPackageName(),  // 当前应用包名
+                0  // 额外标志（0 表示默认获取基本信息）
+            );
+            // 从应用信息中获取应用名称（支持多语言）
+            String appName = (String) packageManager.getApplicationLabel(applicationInfo);
+            LogUtils.d(TAG, "获取应用名称成功：" + appName);
+            return appName;
+        } catch (NameNotFoundException e) {
+            // 包名不存在（理论上不会发生，捕获异常避免崩溃）
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            //LogUtils.e(TAG, "获取应用名称失败：包名不存在", e);
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    /**
+     * 应用终止时调用（仅用于释放全局资源）
+     */
+    @Override
+    public void onTerminate() {
+        super.onTerminate();
+        // 释放单例引用（可选，避免内存泄漏风险）
+        sInstance = null;
+        LogUtils.d(TAG, "GlobalApplication 终止，单例实例已释放");
+    }
+}
+

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

@@ -0,0 +1,151 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.utils.CrashHandleNotifyUtils;
+
+/**
+ * 应用异常报告观察活动窗口类
+ * 核心功能：应用发生未捕获崩溃时，由 CrashHandler 启动此页面，展示崩溃日志详情，
+ * 并提供「复制日志」「重启应用」操作入口，便于开发者定位问题和用户恢复应用
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025/11/11 19:58:00
+ * @EditTime 2026/05/11 15:40:12
+ */
+public final class GlobalCrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
+
+    // ====================== 常量定义 ======================
+    public static final String TAG = "GlobalCrashActivity";
+    /** 菜单标识：复制崩溃日志 */
+    private static final int MENU_ITEM_COPY = 0;
+    /** 菜单标识：重启应用 */
+    private static final int MENU_ITEM_RESTART = 1;
+
+    // ====================== 成员变量 ======================
+    /** 崩溃报告展示自定义视图 */
+    private GlobalCrashReportView mCrashReportView;
+    /** 崩溃日志文本内容 */
+    private String mCrashLog;
+
+    // ====================== 生命周期方法 ======================
+    @Override
+    protected void onCreate(final Bundle savedInstanceState) {
+        LogUtils.d(TAG, "onCreate 方法进入");
+        try {
+            super.onCreate(savedInstanceState);
+            final Context appContext = getApplicationContext();
+            // 初始化崩溃安全防护机制
+            AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(appContext);
+
+            // 获取传递的崩溃日志
+            mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
+            LogUtils.d(TAG, "获取到崩溃日志，长度：" + (mCrashLog != null ? mCrashLog.length() : 0));
+
+            setContentView(R.layout.activity_globalcrash);
+            mCrashReportView = findViewById(R.id.activityglobalcrashGlobalCrashReportView1);
+            mCrashReportView.setReport(mCrashLog);
+
+            setActionBar(mCrashReportView.getToolbar());
+            if (getActionBar() != null) {
+                getActionBar().setTitle(CrashHandler.TITTLE);
+                getActionBar().setSubtitle(GlobalApplication.getAppName(appContext));
+            }
+        } catch (final Exception e) {
+            LogUtils.e(TAG, "GlobalCrashActivity onCreate 发生异常", e);
+            AppCrashSafetyWire.getInstance().burnSafetyWire();
+
+            mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
+            final Intent intent = new Intent();
+            intent.putExtra(CrashHandler.EXTRA_CRASH_LOG, mCrashLog);
+            CrashHandleNotifyUtils.handleUncaughtException(GlobalApplication.getInstance(), intent, CrashHandler.CrashActivity.class);
+
+            StackTraceElement[] stackElements = Thread.currentThread().getStackTrace();
+            StringBuilder sb = new StringBuilder("GlobalCrashActivity onCreate StackTrace");
+            for (StackTraceElement item : stackElements) {
+                sb.append("\n").append(item.toString());
+            }
+            LogUtils.d(TAG, sb.toString());
+            finish();
+        }
+    }
+
+    @Override
+    public void onBackPressed() {
+        LogUtils.d(TAG, "onBackPressed 触发重启应用");
+        restartApp();
+    }
+
+    // ====================== 菜单相关回调 ======================
+    @Override
+    public boolean onCreateOptionsMenu(final Menu menu) {
+        LogUtils.d(TAG, "onCreateOptionsView 初始化菜单");
+        menu.add(0, MENU_ITEM_COPY, 0, "Copy")
+			.setOnMenuItemClickListener(this)
+			.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+
+        menu.add(0, MENU_ITEM_RESTART, 0, "Restart")
+			.setOnMenuItemClickListener(this)
+			.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+
+        mCrashReportView.updateMenuStyle();
+        return true;
+    }
+
+    @Override
+    public boolean onMenuItemClick(final MenuItem item) {
+        LogUtils.d(TAG, "菜单项被点击，ID：" + item.getItemId());
+        switch (item.getItemId()) {
+            case MENU_ITEM_COPY:
+                copyCrashLogToClipboard();
+                break;
+            case MENU_ITEM_RESTART:
+                AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+                restartApp();
+                break;
+            default:
+                break;
+        }
+        return false;
+    }
+
+    // ====================== 内部私有工具方法 ======================
+    /**
+     * 重启当前应用
+     */
+    private void restartApp() {
+        LogUtils.d(TAG, "开始执行应用重启逻辑");
+        final PackageManager packageManager = getPackageManager();
+        final Intent launchIntent = packageManager.getLaunchIntentForPackage(getPackageName());
+
+        if (launchIntent != null) {
+            launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
+								  | Intent.FLAG_ACTIVITY_CLEAR_TOP
+								  | Intent.FLAG_ACTIVITY_CLEAR_TASK);
+            startActivity(launchIntent);
+        }
+        finish();
+        android.os.Process.killProcess(android.os.Process.myPid());
+        System.exit(0);
+    }
+
+    /**
+     * 将崩溃日志复制到系统剪贴板
+     */
+    private void copyCrashLogToClipboard() {
+        LogUtils.d(TAG, "执行复制崩溃日志到剪贴板");
+        final ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+        final ClipData clipData = ClipData.newPlainText(getPackageName(), mCrashLog);
+        clipboardManager.setPrimaryClip(clipData);
+        Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
+    }
+}
+

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

@@ -0,0 +1,317 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.Color;
+import android.text.SpannableString;
+import android.text.style.ForegroundColorSpan;
+import android.util.AttributeSet;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+import android.widget.Toolbar;
+import cc.winboll.studio.libappbase.R;
+import android.content.res.Resources;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:21
+ * @Describe 全局崩溃报告视图控件
+ * 用于展示应用崩溃信息，包含顶部工具栏和崩溃日志文本区域，支持自定义配色
+ */
+public class GlobalCrashReportView extends LinearLayout {
+
+	// 日志标签
+	public static final String TAG = "GlobalCrashReportView";
+
+	// 上下文对象
+	private Context mContext;
+	// 顶部工具栏（标题栏）
+	private Toolbar mToolbar;
+	// 标题文字颜色
+	private int mTitleColor;
+	// 标题栏背景颜色
+	private int mTitleBackgroundColor;
+	// 日志文本颜色
+	private int mTextColor;
+	// 日志区域背景颜色
+	private int mTextBackgroundColor;
+	// 崩溃日志显示文本控件
+	private TextView mTvReport;
+
+	/**
+	 * 构造方法：仅上下文
+	 * @param context 上下文
+	 */
+	public GlobalCrashReportView(Context context) {
+		super(context);
+		mContext = context;
+		// 初始化默认配置（无自定义属性）
+		initDefaultConfig();
+	}
+
+	/**
+	 * 构造方法：上下文 + 自定义属性
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合
+	 */
+	public GlobalCrashReportView(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		mContext = context;
+		// 初始化视图（解析自定义属性）
+		initView(attrs);
+	}
+
+	/**
+	 * 构造方法：上下文 + 自定义属性 + 样式属性
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合
+	 * @param defStyleAttr 样式属性
+	 */
+	public GlobalCrashReportView(Context context, AttributeSet attrs, int defStyleAttr) {
+		super(context, attrs, defStyleAttr);
+		mContext = context;
+		// 初始化视图（解析自定义属性）
+		initView(attrs);
+	}
+
+	/**
+	 * 构造方法：上下文 + 自定义属性 + 样式属性 + 样式资源
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合
+	 * @param defStyleAttr 样式属性
+	 * @param defStyleRes 样式资源
+	 */
+	public GlobalCrashReportView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+		super(context, attrs, defStyleAttr, defStyleRes);
+		mContext = context;
+		// 初始化视图（解析自定义属性）
+		initView(attrs);
+	}
+
+	/**
+	 * 设置标题文字颜色
+	 * @param titleColor 颜色值（如 Color.WHITE 或 #FFFFFF）
+	 */
+	public void setTitleColor(int titleColor) {
+		this.mTitleColor = titleColor;
+		// 实时更新工具栏标题颜色
+		if (mToolbar != null) {
+			mToolbar.setTitleTextColor(titleColor);
+			mToolbar.setSubtitleTextColor(titleColor);
+		}
+	}
+
+	/**
+	 * 获取标题文字颜色
+	 * @return 标题文字颜色值
+	 */
+	public int getTitleColor() {
+		return mTitleColor;
+	}
+
+	/**
+	 * 设置标题栏背景颜色
+	 * @param titleBackgroundColor 颜色值（如 Color.BLACK 或 #000000）
+	 */
+	public void setTitleBackgroundColor(int titleBackgroundColor) {
+		this.mTitleBackgroundColor = titleBackgroundColor;
+		// 实时更新工具栏背景颜色
+		if (mToolbar != null) {
+			mToolbar.setBackgroundColor(titleBackgroundColor);
+		}
+	}
+
+	/**
+	 * 获取标题栏背景颜色
+	 * @return 标题栏背景颜色值
+	 */
+	public int getTitleBackgroundColor() {
+		return mTitleBackgroundColor;
+	}
+
+	/**
+	 * 设置日志文本颜色
+	 * @param textColor 颜色值（如 Color.BLACK 或 #000000）
+	 */
+	public void setTextColor(int textColor) {
+		this.mTextColor = textColor;
+		// 实时更新日志文本颜色
+		if (mTvReport != null) {
+			mTvReport.setTextColor(textColor);
+		}
+	}
+
+	/**
+	 * 获取日志文本颜色
+	 * @return 日志文本颜色值
+	 */
+	public int getTextColor() {
+		return mTextColor;
+	}
+
+	/**
+	 * 设置日志区域背景颜色
+	 * @param textBackgroundColor 颜色值（如 Color.WHITE 或 #FFFFFF）
+	 */
+	public void setTextBackgroundColor(int textBackgroundColor) {
+		this.mTextBackgroundColor = textBackgroundColor;
+		// 实时更新日志区域和主布局背景颜色
+		if (mTvReport != null) {
+			mTvReport.setBackgroundColor(textBackgroundColor);
+		}
+		setBackgroundColor(textBackgroundColor);
+	}
+
+	/**
+	 * 获取日志区域背景颜色
+	 * @return 日志区域背景颜色值
+	 */
+	public int getTextBackgroundColor() {
+		return mTextBackgroundColor;
+	}
+
+	/**
+	 * 初始化默认配置（无自定义属性时使用）
+	 */
+	private void initDefaultConfig() {
+		// 设置默认配色（使用 debugTextColor 属性）
+		Resources.Theme theme = mContext.getTheme();
+		mTitleColor = theme.getResources().getColor(android.R.color.holo_green_dark);
+		mTitleBackgroundColor = Color.GRAY;
+		mTextColor = obtainDebugTextColor(theme);
+		mTextBackgroundColor = Color.WHITE;
+		// 加载布局
+		inflateView();
+		// 初始化控件样式
+		initWidgetStyle();
+	}
+
+	private int obtainDebugTextColor(Resources.Theme theme) {
+		int[] attrs = new int[] { cc.winboll.studio.libappbase.R.attr.themeDebug };
+		TypedArray themeTypedArray = theme.obtainStyledAttributes(attrs);
+		int themeResId = themeTypedArray.getResourceId(0, 0);
+		themeTypedArray.recycle();
+		if (themeResId != 0) {
+			int[] debugAttrs = new int[] { cc.winboll.studio.libappbase.R.attr.debugTextColor };
+			TypedArray debugTypedArray = theme.obtainStyledAttributes(themeResId, debugAttrs);
+			int color = debugTypedArray.getColor(0, Color.GRAY);
+			debugTypedArray.recycle();
+			return color;
+		}
+		return Color.GRAY;
+	}
+
+	/**
+	 * 初始化视图（解析自定义属性 + 加载布局 + 设置样式）
+	 * @param attrs 自定义属性集合
+	 */
+	private void initView(AttributeSet attrs) {
+		// 解析自定义属性（关联 attrs.xml 中的 GlobalCrashActivity 样式）
+		TypedArray typedArray = mContext.obtainStyledAttributes(
+			attrs,
+			R.styleable.GlobalCrashActivity,
+			R.attr.themeDebug,
+			0
+		);
+
+		// 读取自定义属性值（无设置时使用默认值）
+		mTitleColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTittle,
+			Color.BLACK
+		);
+		mTitleBackgroundColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTittleBackgound, // 注：原拼写错误（Backgound→Background），保持与 attrs.xml 一致
+			Color.BLACK
+		);
+		mTextColor = obtainDebugTextColor(mContext.getTheme());
+		mTextBackgroundColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTextBackgound, // 注：原拼写错误，保持与 attrs.xml 一致
+			Color.WHITE
+		);
+
+		// 回收 TypedArray，避免内存泄漏
+		typedArray.recycle();
+
+		// 加载布局文件
+		inflateView();
+		// 初始化控件样式
+		initWidgetStyle();
+	}
+
+	/**
+	 * 加载布局文件
+	 */
+	private void inflateView() {
+		// 加载自定义布局（R.layout.view_globalcrashreport）
+		inflate(mContext, R.layout.view_globalcrashreport, this);
+		// 绑定控件
+		mToolbar = findViewById(R.id.viewglobalcrashreportToolbar1);
+		mTvReport = findViewById(R.id.viewglobalcrashreportTextView1);
+	}
+
+	/**
+	 * 初始化控件样式（设置配色和基础属性）
+	 */
+	private void initWidgetStyle() {
+		// 配置工具栏样式
+		if (mToolbar != null) {
+			mToolbar.setTitleTextColor(mTitleColor);
+			mToolbar.setSubtitleTextColor(mTitleColor);
+		}
+
+		// 配置日志文本控件样式
+		if (mTvReport != null) {
+			mTvReport.setTextColor(mTextColor);
+			mTvReport.setSingleLine(false);
+			mTvReport.setHorizontallyScrolling(false);
+		}
+	}
+
+	/**
+	 * 设置崩溃报告内容到文本控件
+	 * @param report 崩溃日志字符串（通常包含异常信息、调用栈等）
+	 */
+	public void setReport(String report) {
+		if (mTvReport != null) {
+			mTvReport.setText(report);
+		}
+	}
+
+	/**
+	 * 获取顶部工具栏对象（用于外部设置标题、添加菜单等）
+	 * @return Toolbar 实例
+	 */
+	public Toolbar getToolbar() {
+		return mToolbar;
+	}
+
+	/**
+	 * 更新工具栏菜单文字颜色（与标题颜色保持一致）
+	 * 需在菜单加载完成后调用（如 Toolbar 加载菜单后）
+	 */
+	public void updateMenuStyle() {
+		if (mToolbar == null) return;
+
+		// 获取工具栏菜单
+		Menu menu = mToolbar.getMenu();
+		if (menu == null || menu.size() == 0) return;
+
+		// 遍历所有菜单项，设置文字颜色
+		for (int i = 0; i < menu.size(); i++) {
+			MenuItem menuItem = menu.getItem(i);
+			String title = menuItem.getTitle().toString();
+			// 使用 SpannableString 设置文字颜色
+			SpannableString spanString = new SpannableString(title);
+			spanString.setSpan(
+				new ForegroundColorSpan(mTitleColor),
+				0,
+				spanString.length(),
+				0 //  Spannable.SPAN_INCLUSIVE_EXCLUSIVE（默认值，包含起始位置，不包含结束位置）
+			);
+			menuItem.setTitle(spanString);
+		}
+	}
+}
+

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

@@ -0,0 +1,87 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Activity;
+import android.app.ActivityOptions;
+import android.content.Context;
+import android.content.Intent;
+import android.graphics.Rect;
+import android.os.Build;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.libappbase.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:29
+ * @Describe 应用日志展示 Activity
+ * 用于单独启动窗口展示应用运行日志，依赖 LogView 控件实现日志加载与显示
+ */
+public class LogActivity extends Activity {
+
+    /** 日志标签，用于当前 Activity 的日志输出标识 */
+    public static final String TAG = "LogActivity";
+
+    /** 日志展示控件（用于加载和显示应用日志） */
+    private LogView mLogView;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        // 设置布局文件（包含 LogView 控件）
+        setContentView(R.layout.activity_log);
+
+        // 绑定布局中的 LogView 控件
+        mLogView = findViewById(R.id.logview);
+        // 启动 LogView 日志加载（如实时刷新日志内容）
+        mLogView.start();
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        // 恢复 Activity 时重新启动 LogView（确保日志持续更新）
+        mLogView.start();
+    }
+
+    /**
+     * 启动日志 Activity 的静态方法（外部调用入口）
+     * 配置 Intent 标志，以多任务/分屏模式启动，避免与主应用任务栈冲突
+     * @param context 上下文（Activity/Fragment），用于启动 Activity
+     */
+    public static void startLogActivity(Context context) {
+        startLogActivity(context, true);
+    }
+
+    /**
+     * 启动日志 Activity 的静态方法重载（外部调用入口）
+     * @param context 上下文（Activity/Fragment），用于启动 Activity
+     * @param newTask 是否在新窗口中启动
+     */
+    public static void startLogActivity(Context context, boolean newTask) {
+        Intent intent = new Intent(context, LogActivity.class);
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+        if (newTask) {
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+            context.startActivity(intent);
+        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+            intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+
+            Rect bounds = new Rect();
+            if (context instanceof Activity) {
+                Activity activity = (Activity) context;
+                activity.getWindow().getDecorView().getDisplay().getRectSize(bounds);
+                bounds.set(0, bounds.height() / 2, bounds.width(), bounds.height());
+            }
+            ActivityOptions options = ActivityOptions.makeBasic();
+            options.setLaunchBounds(bounds);
+            context.startActivity(intent, options.toBundle());
+        } else {
+            context.startActivity(intent);
+        }
+    }
+}
+

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

@@ -0,0 +1,683 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.util.Log;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import dalvik.system.DexFile;
+
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.OutputStreamWriter;
+import java.lang.reflect.Field;
+import java.lang.reflect.Modifier;
+import java.text.SimpleDateFormat;
+import java.util.ArrayList;
+import java.util.Enumeration;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-05-09 15:46:28
+ * @EditTime 2026-05-11 15:36:12
+ * @Describe 应用日志工具类
+ * 补全多级别日志重载、自动日志文件裁剪、应用内TAG自动扫描管理；
+ * 支持日志本地持久化、异常堆栈格式化、TAG开关配置、线程与集合打印工具；
+ * 完全兼容Java7语法，严格遵循变量final编码规范；
+ * 重要说明：本类内部调试打印必须使用 android.util.Log，禁止使用LogUtils自身方法，
+ * 避免递归嵌套调用、逻辑漩涡与无限循环调用问题。
+ */
+public class LogUtils {
+
+    // ====================== 常量与枚举 ======================
+    public static final String TAG = "LogUtils";
+
+    /**
+     * 日志级别枚举
+     */
+    public static enum LOG_LEVEL {
+        Off,
+        Error,
+        Warn,
+        Info,
+        Debug,
+        Verbose
+		}
+
+    // ====================== 全局静态成员 ======================
+    private static volatile boolean _IsInited = false;
+    private static Context _mContext;
+    private static final SimpleDateFormat mSimpleDateFormat = new SimpleDateFormat("[yyyyMMdd_HHmmss_SSS]", Locale.getDefault());
+    private static File _mfLogCacheDir;
+    private static File _mfLogDataDir;
+    private static File _mfLogCatchFile;
+    private static File _mfLogUtilsBeanFile;
+    private static LogUtilsBean _mLogUtilsBean;
+    public static final Map<String, Boolean> mapTAGList = new HashMap<String, Boolean>();
+
+    // ====================== 初始化入口 ======================
+    public static void init(final Context context) {
+        init(context, LOG_LEVEL.Off);
+    }
+
+    public static void init(final Context context, final LOG_LEVEL logLevel) {
+        Log.d(TAG, "init 执行日志工具初始化");
+        _mContext = context;
+
+        if (GlobalApplication.isDebugging()) {
+            initDebugDir();
+        } else {
+            initReleaseDir();
+        }
+
+        initLogConfigBean();
+        addClassTAGList();
+        loadTAGBeanSettings();
+        checkAndTrimLogFileSize();
+
+        _IsInited = true;
+        Log.d(TAG, "init 日志工具初始化完成");
+    }
+
+    // ====================== 目录初始化 ======================
+    private static void initDebugDir() {
+        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()) {
+            _mfLogCacheDir.mkdirs();
+        }
+        _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
+
+        _mfLogDataDir = new File(appContext.getFilesDir(), TAG);
+        if (!_mfLogDataDir.exists()) {
+            _mfLogDataDir.mkdirs();
+        }
+        _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
+    }
+
+    private static void initLogConfigBean() {
+        _mLogUtilsBean = LogUtilsBean.loadBeanFromFile(_mfLogUtilsBeanFile.getPath(), LogUtilsBean.class);
+        if (_mLogUtilsBean == null) {
+            _mLogUtilsBean = new LogUtilsBean();
+            _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
+            Log.d(TAG, "initLogConfigBean 自动创建默认日志配置文件");
+        }
+    }
+
+    // ====================== 日志文件裁剪 ======================
+    private static void checkAndTrimLogFileSize() {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return;
+        }
+
+        final long MAX_FILE_SIZE = 6291456L;
+        final long KEEP_FILE_SIZE = 3145728L;
+        final long fileSize = _mfLogCatchFile.length();
+
+        if (fileSize <= MAX_FILE_SIZE) {
+            return;
+        }
+
+        final long needSkip = fileSize - KEEP_FILE_SIZE;
+        final String lineBreak = System.lineSeparator();
+
+        FileInputStream fis = null;
+        BufferedReader reader = null;
+        FileOutputStream fos = null;
+        BufferedWriter writer = null;
+
+        try {
+            fis = new FileInputStream(_mfLogCatchFile);
+            reader = new BufferedReader(new InputStreamReader(fis));
+            fos = new FileOutputStream(_mfLogCatchFile);
+            writer = new BufferedWriter(new OutputStreamWriter(fos));
+
+            final StringBuilder sb = new StringBuilder();
+            String line;
+            long skippedTotal = 0;
+
+            while ((line = reader.readLine()) != null) {
+                final byte[] lineBytes = line.getBytes();
+                skippedTotal += lineBytes.length + lineBreak.getBytes().length;
+                if (skippedTotal > needSkip) {
+                    sb.append(line).append(lineBreak);
+                }
+            }
+            writer.write(sb.toString());
+            Log.d(TAG, "checkAndTrimLogFileSize 日志文件裁剪完成");
+        } catch (IOException e) {
+            Log.e(TAG, "checkAndTrimLogFileSize 日志文件裁剪失败", e);
+        } finally {
+            try {
+                if (reader != null) {
+                    reader.close();
+                }
+            } catch (IOException e) {}
+            try {
+                if (fis != null) {
+                    fis.close();
+                }
+            } catch (IOException e) {}
+            try {
+                if (writer != null) {
+                    writer.close();
+                }
+            } catch (IOException e) {}
+            try {
+                if (fos != null) {
+                    fos.close();
+                }
+            } catch (IOException e) {}
+        }
+    }
+
+    // ====================== TAG 配置管理 ======================
+    public static Map<String, Boolean> getMapTAGList() {
+        return mapTAGList;
+    }
+
+    private static void loadTAGBeanSettings() {
+        final ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
+        LogUtilsClassTAGBean.loadBeanList(_mContext, list, LogUtilsClassTAGBean.class);
+
+        for (final LogUtilsClassTAGBean beanSetting : list) {
+            final String tag = beanSetting.getTag();
+            if (mapTAGList.containsKey(tag)) {
+                mapTAGList.put(tag, beanSetting.getEnable());
+            }
+        }
+    }
+
+    private static void saveTAGBeanSettings() {
+        final ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
+        for (final Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+            list.add(new LogUtilsClassTAGBean(entry.getKey(), entry.getValue()));
+        }
+        LogUtilsClassTAGBean.saveBeanList(_mContext, list, LogUtilsClassTAGBean.class);
+    }
+
+    private static void addClassTAGList() {
+        try {
+            final String packageNamePrefix = "cc.winboll.studio";
+            final List<String> classNames = new ArrayList<String>();
+            final String apkPath = _mContext.getPackageCodePath();
+
+            final DexFile dexfile = new DexFile(apkPath);
+            Enumeration<String> entries = dexfile.entries();
+
+            while (entries.hasMoreElements()) {
+                final String className = entries.nextElement();
+                if (className.startsWith(packageNamePrefix)) {
+                    classNames.add(className);
+                }
+            }
+
+            for (final String className : classNames) {
+                try {
+                    final Class<?> clazz = Class.forName(className);
+                    final Field[] fields = clazz.getDeclaredFields();
+
+                    for (final Field field : fields) {
+                        if (Modifier.isStatic(field.getModifiers())
+							&& Modifier.isPublic(field.getModifiers())
+							&& field.getType() == String.class
+							&& "TAG".equals(field.getName())) {
+
+                            final String tagValue = (String) field.get(null);
+                            mapTAGList.put(tagValue, false);
+                        }
+                    }
+                } catch (NoClassDefFoundError e) {
+                    Log.w(TAG, "addClassTAGList 解析类TAG失败 NoClassDefFoundError");
+                } catch (ClassNotFoundException e) {
+                    Log.w(TAG, "addClassTAGList 解析类TAG失败 ClassNotFoundException");
+                } catch (IllegalAccessException e) {
+                    Log.w(TAG, "addClassTAGList 解析类TAG失败 IllegalAccessException");
+                }
+            }
+        } catch (IOException e) {
+            Log.e(TAG, "addClassTAGList 扫描Dex异常", e);
+        }
+    }
+
+    public static void setTAGListEnable(final String tag, final boolean isEnable) {
+        final Iterator<Map.Entry<String, Boolean>> iterator = mapTAGList.entrySet().iterator();
+        while (iterator.hasNext()) {
+            final Map.Entry<String, Boolean> entry = iterator.next();
+            if (tag.equals(entry.getKey())) {
+                entry.setValue(isEnable);
+                break;
+            }
+        }
+        saveTAGBeanSettings();
+        Log.d(TAG, "setTAGListEnable 更新TAG开关配置");
+    }
+
+    public static void setALlTAGListEnable(final boolean isEnable) {
+        for (final Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+            entry.setValue(isEnable);
+        }
+        saveTAGBeanSettings();
+        Log.d(TAG, "setALlTAGListEnable 全量设置TAG开关");
+    }
+
+    // ====================== 日志级别控制 ======================
+    public static void setLogLevel(final LOG_LEVEL logLevel) {
+        _mLogUtilsBean.setLogLevel(logLevel);
+        _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
+    }
+
+    public static LOG_LEVEL getLogLevel() {
+        return _mLogUtilsBean.getLogLevel();
+    }
+
+    private static boolean isLoggable(final String tag, final LOG_LEVEL logLevel) {
+        if (!_IsInited) {
+            return false;
+        }
+        if (mapTAGList.get(tag) == null || !mapTAGList.get(tag)) {
+            return false;
+        }
+        return isInTheLevel(logLevel);
+    }
+
+    private static boolean isInTheLevel(final LOG_LEVEL logLevel) {
+        return _mLogUtilsBean.getLogLevel().ordinal() >= logLevel.ordinal();
+    }
+
+    // ====================== 基础对外方法 ======================
+    public static File getLogCacheDir() {
+        return _mfLogCacheDir;
+    }
+
+    public static boolean isInited() {
+        return _IsInited;
+    }
+
+    // ====================== Error 日志重载（补齐缺失方法） ======================
+    public static void e(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            saveLog(szTAG, LOG_LEVEL.Error, szMessage);
+        }
+    }
+
+    public static void e(final String szTAG, final String szMessage, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    public static void e(final String szTAG, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final String message = "【异常信息】: " + getExceptionInfo(e);
+            saveLog(szTAG, LOG_LEVEL.Error, message);
+        }
+    }
+
+    public static void e(final String szTAG, final String szMessage, final Exception e, final StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            sb.append("\n【堆栈信息】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    /**
+     * 补齐你需要的：LogUtils.e(TAG, "uncaughtException: 崩溃处理异常", e)
+     */
+    public static void e(final String szTAG, final String szMessage, final Throwable e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getThrowableInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    // ====================== Warn 日志重载 ======================
+    public static void w(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Warn)) {
+            saveLog(szTAG, LOG_LEVEL.Warn, szMessage);
+        }
+    }
+
+    public static void w(final String szTAG, final String szMessage, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Warn)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Warn, sb.toString());
+        }
+    }
+
+    public static void w(final String szTAG, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Warn)) {
+            final String message = "【异常信息】: " + getExceptionInfo(e);
+            saveLog(szTAG, LOG_LEVEL.Warn, message);
+        }
+    }
+
+    // ====================== Info 日志重载 ======================
+    public static void i(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Info)) {
+            saveLog(szTAG, LOG_LEVEL.Info, szMessage);
+        }
+    }
+
+    public static void i(final String szTAG, final String szMessage, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Info)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LOG_LEVEL.Info, sb.toString());
+        }
+    }
+
+    // ====================== Debug 日志重载 ======================
+    public static void d(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            saveLog(szTAG, LOG_LEVEL.Debug, szMessage);
+        }
+    }
+
+    public static void d(final String szTAG, final String szMessage, final StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final StringBuilder sbMessage = new StringBuilder(szMessage);
+            sbMessage.append("\n【调用堆栈】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LOG_LEVEL.Debug, sbMessage.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final String szMessage, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final Exception e, final StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final StringBuilder sbMessage = new StringBuilder();
+            sbMessage.append("【异常信息】: ").append(getExceptionInfo(e));
+            sbMessage.append("\n【调用堆栈】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LOG_LEVEL.Debug, sbMessage.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final String szMessage, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final String message = "【数据对象】: " + objStr;
+            saveLog(szTAG, LOG_LEVEL.Debug, message);
+        }
+    }
+
+    // ====================== Verbose 日志重载 ======================
+    public static void v(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Verbose)) {
+            saveLog(szTAG, LOG_LEVEL.Verbose, szMessage);
+        }
+    }
+
+    public static void v(final String szTAG, final String szMessage, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Verbose)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LOG_LEVEL.Verbose, sb.toString());
+        }
+    }
+
+    public static void v(final String szTAG, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Verbose)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final String message = "【数据对象】: " + objStr;
+            saveLog(szTAG, LOG_LEVEL.Verbose, message);
+        }
+    }
+
+    // ====================== 扩展工具打印 ======================
+    public static void printThreadInfo(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final Thread currentThread = Thread.currentThread();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【线程信息】: ")
+				.append("线程名=").append(currentThread.getName())
+				.append(", 线程ID=").append(currentThread.getId())
+				.append(", 线程状态=").append(currentThread.getState().name());
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static <K, V> void printMap(final String szTAG, final String szMessage, final Map<K, V> map) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug) && map != null) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【Map 数据】size=").append(map.size());
+            for (final Map.Entry<K, V> entry : map.entrySet()) {
+                final String keyStr = entry.getKey() == null ? "null" : entry.getKey().toString();
+                final String valueStr = entry.getValue() == null ? "null" : entry.getValue().toString();
+                sb.append("\n  ").append(keyStr).append(" = ").append(valueStr);
+            }
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static <T> void printList(final String szTAG, final String szMessage, final List<T> list) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug) && list != null) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【List 数据】size=").append(list.size());
+            for (int i = 0; i < list.size(); i++) {
+                final T item = list.get(i);
+                final String itemStr = item == null ? "null" : item.toString();
+                sb.append("\n  索引").append(i).append(" = ").append(itemStr);
+            }
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    // ====================== 私有格式化工具 ======================
+    private static String getExceptionInfo(final Exception e) {
+        if (e == null) {
+            return "异常对象为null";
+        }
+        final StringBuilder sb = new StringBuilder();
+        sb.append(e.getClass().getSimpleName()).append(" : ")
+			.append(e.getMessage() == null ? "无异常消息" : e.getMessage());
+
+        final StackTraceElement[] stackTrace = e.getStackTrace();
+        if (stackTrace != null && stackTrace.length > 0) {
+            final int limit = Math.min(stackTrace.length, 5);
+            for (int i = 0; i < limit; i++) {
+                sb.append("\n    ").append(stackTrace[i].toString());
+            }
+        }
+        return sb.toString();
+    }
+
+    private static String getThrowableInfo(final Throwable e) {
+        if (e == null) {
+            return "异常对象为null";
+        }
+        final StringBuilder sb = new StringBuilder();
+        sb.append(e.getClass().getSimpleName()).append(" : ")
+			.append(e.getMessage() == null ? "无异常消息" : e.getMessage());
+
+        final StackTraceElement[] stackTrace = e.getStackTrace();
+        if (stackTrace != null && stackTrace.length > 0) {
+            final int limit = Math.min(stackTrace.length, 5);
+            for (int i = 0; i < limit; i++) {
+                sb.append("\n    ").append(stackTrace[i].toString());
+            }
+        }
+        return sb.toString();
+    }
+
+    private static String getStackTraceInfo(final StackTraceElement[] stackTrace) {
+        if (stackTrace == null || stackTrace.length == 0) {
+            return "堆栈信息为空";
+        }
+        final StringBuilder sb = new StringBuilder();
+        int count = 0;
+        for (final StackTraceElement element : stackTrace) {
+            if (element.getClassName().contains("cc.winboll.studio.libappbase.LogUtils")) {
+                continue;
+            }
+            sb.append("\n    ").append(element.getClassName()).append(".")
+				.append(element.getMethodName()).append("(")
+				.append(element.getFileName()).append(":").append(element.getLineNumber()).append(")");
+            count++;
+            if (count >= 8) {
+                break;
+            }
+        }
+        return sb.toString();
+    }
+
+    // ====================== 日志持久化读写 ======================
+    private static void saveLog(final String szTAG, final LogUtils.LOG_LEVEL logLevel, final String szMessage) {
+        BufferedWriter out = null;
+        try {
+            if (!_mfLogCatchFile.exists()) {
+                final File parentDir = _mfLogCatchFile.getParentFile();
+                if (parentDir != null && !parentDir.exists()) {
+                    parentDir.mkdirs();
+                }
+                _mfLogCatchFile.createNewFile();
+            }
+            out = new BufferedWriter(new OutputStreamWriter(
+										 new FileOutputStream(_mfLogCatchFile, true), "UTF-8"));
+            final String logLine = "[" + logLevel + "]  "
+				+ mSimpleDateFormat.format(System.currentTimeMillis())
+				+ "  [" + szTAG + "]\n"
+				+ szMessage + "\n\n";
+            out.write(logLine);
+            out.flush();
+        } catch (IOException e) {
+            Log.e(TAG, "saveLog 日志写入失败", e);
+        } finally {
+            if (out != null) {
+                try {
+                    out.close();
+                } catch (IOException e) {
+                    Log.e(TAG, "saveLog 流关闭失败", e);
+                }
+            }
+        }
+    }
+
+    public static String loadLog() {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return "日志文件不存在";
+        }
+        final StringBuffer sb = new StringBuffer();
+        BufferedReader in = null;
+        try {
+            in = new BufferedReader(new InputStreamReader(
+										new FileInputStream(_mfLogCatchFile), "UTF-8"));
+            String line;
+            while ((line = in.readLine()) != null) {
+                sb.append(line).append("\n");
+            }
+        } catch (IOException e) {
+            sb.append("日志加载失败");
+            Log.e(TAG, "loadLog 读取日志异常", e);
+        } finally {
+            if (in != null) {
+                try {
+                    in.close();
+                } catch (IOException e) {
+                    Log.e(TAG, "loadLog 读取流关闭异常", e);
+                }
+            }
+        }
+        return sb.toString();
+    }
+
+    public static void cleanLog() {
+        if (_mfLogCatchFile == null) {
+            Log.d(TAG, "cleanLog 日志文件未初始化");
+            return;
+        }
+        BufferedWriter out = null;
+        try {
+            out = new BufferedWriter(new OutputStreamWriter(
+										 new FileOutputStream(_mfLogCatchFile, false), "UTF-8"));
+            out.write("");
+            out.flush();
+            Log.d(TAG, "cleanLog 日志已清空");
+        } catch (IOException e) {
+            Log.e(TAG, "cleanLog 清空日志失败", e);
+        } finally {
+            if (out != null) {
+                try {
+                    out.close();
+                } catch (IOException e) {
+                    Log.e(TAG, "cleanLog 流关闭异常", e);
+                }
+            }
+        }
+    }
+
+    public static boolean checkLogFileSize(final int maxSizeMB) {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return false;
+        }
+        final long maxSizeByte = 1048576L * maxSizeMB;
+        final long fileSize = _mfLogCatchFile.length();
+        return fileSize > maxSizeByte;
+    }
+
+    public static void showShortToast(final Context context, final String message) {
+        if (context == null || message == null) {
+            return;
+        }
+        if (Thread.currentThread().getId() == android.os.Process.myTid()) {
+            Toast.makeText(context, message, Toast.LENGTH_SHORT).show();
+        } else {
+            final Context uiContext = context;
+            ((android.app.Activity) uiContext).runOnUiThread(new Runnable() {
+					@Override
+					public void run() {
+						Toast.makeText(uiContext, message, Toast.LENGTH_SHORT).show();
+					}
+				});
+        }
+    }
+}
+

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

@@ -0,0 +1,131 @@
+package cc.winboll.studio.libappbase;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/08/23 15:39:07
+ * @Describe LogUtils 配置数据模型（继承 BaseBean，实现 JSON 序列化/反序列化）
+ * 封装 LogUtils 的核心配置参数（当前仅日志级别），用于配置的持久化存储与读取
+ */
+public class LogUtilsBean extends BaseBean {
+
+    /** 当前类的日志 TAG（用于调试输出） */
+    public static final String TAG = "LogUtilsBean";
+
+    /**
+     * 全局日志级别（默认值：Off，即不输出任何日志）
+     * 关联 LogUtils.LOG_LEVEL 枚举，存储日志输出的级别阈值
+     */
+    private LogUtils.LOG_LEVEL logLevel;
+
+    /**
+     * 无参构造方法（默认初始化日志级别为 Off）
+     * 用于 JSON 反序列化时的实例创建
+     */
+    public LogUtilsBean() {
+        this.logLevel = LogUtils.LOG_LEVEL.Off;
+    }
+
+    /**
+     * 有参构造方法（指定初始日志级别）
+     * @param logLevel 初始日志级别（如 LogUtils.LOG_LEVEL.Debug）
+     */
+    public LogUtilsBean(LogUtils.LOG_LEVEL logLevel) {
+        this.logLevel = logLevel;
+    }
+
+    /**
+     * 设置日志级别（更新配置时使用）
+     * @param logLevel 目标日志级别
+     */
+    public void setLogLevel(LogUtils.LOG_LEVEL logLevel) {
+        this.logLevel = logLevel;
+    }
+
+    /**
+     * 获取当前日志级别（读取配置时使用）
+     * @return 当前配置的日志级别
+     */
+    public LogUtils.LOG_LEVEL getLogLevel() {
+        return logLevel;
+    }
+
+    /**
+     * 重写父类方法：获取当前类的全限定名（用于 BaseBean 反射识别）
+     * @return 类全限定名（如 "cc.winboll.studio.libappbase.LogUtilsBean"）
+     */
+    @Override
+    public String getName() {
+        return LogUtilsBean.class.getName();
+    }
+
+    /**
+     * 重写父类方法：将当前配置对象序列化为 JSON（持久化存储时调用）
+     * 序列化字段：logLevel（存储枚举的 ordinal 值，确保反序列化一致性）
+     * @param jsonWriter JSON 写入器（用于输出 JSON 数据）
+     * @throws IOException JSON 写入异常（如流关闭、格式错误）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        // 调用父类序列化逻辑（若 BaseBean 有公共字段，需优先处理）
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化日志级别：存储枚举的索引值（如 Off=0、Error=1...），比存储名称更高效
+        jsonWriter.name("logLevel").value(this.getLogLevel().ordinal());
+    }
+
+    /**
+     * 重写父类方法：从 JSON 字段初始化当前对象（读取配置时调用）
+     * 解析字段：logLevel（通过索引值恢复 LogUtils.LOG_LEVEL 枚举）
+     * @param jsonReader JSON 读取器（用于读取 JSON 数据）
+     * @param name JSON 字段名（当前解析的字段）
+     * @return true：字段解析成功；false：字段不匹配（需父类处理或跳过）
+     * @throws IOException JSON 读取异常（如字段类型不匹配、流中断）
+     */
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 先让父类处理公共字段，处理成功则直接返回
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            return true;
+        }
+        // 解析当前类专属字段
+        if ("logLevel".equals(name)) {
+            // 通过枚举索引值恢复枚举实例（确保与序列化时的 ordinal 对应）
+            int levelOrdinal = jsonReader.nextInt();
+            this.setLogLevel(LogUtils.LOG_LEVEL.values()[levelOrdinal]);
+        } else {
+            // 字段不匹配，返回 false 表示需要跳过该字段
+            return false;
+        }
+        // 字段解析成功
+        return true;
+    }
+
+    /**
+     * 重写父类方法：从 JSON 读取器完整解析配置对象（入口方法）
+     * 负责 JSON 对象的开始/结束解析，遍历所有字段并调用 initObjectsFromJsonReader 处理
+     * @param jsonReader JSON 读取器（传入待解析的 JSON 流）
+     * @return 解析后的当前 LogUtilsBean 实例（支持链式调用）
+     * @throws IOException JSON 解析异常（如格式错误、字段缺失）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        // 开始解析 JSON 对象（必须与 writeThisToJsonWriter 中的结构对应）
+        jsonReader.beginObject();
+        // 遍历 JSON 中的所有字段
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            // 解析字段，若字段不匹配则跳过该值（避免解析失败）
+            if (!this.initObjectsFromJsonReader(jsonReader, fieldName)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象解析（必须调用，否则会导致流异常）
+        jsonReader.endObject();
+        // 返回当前实例，支持链式调用（如 new LogUtilsBean().readBeanFromJsonReader(reader)）
+        return this;
+    }
+}
+