Merge remote-tracking branch 'origin/winboll' into appbase

.gitignore

@@ -94,8 +94,12 @@ lint-results.html
 ## 忽略 AndroidIDE 临时文件夹
 .androidide
 
-## 忽略模块应用编译配置
-/settings.gradle
-/gradle.properties
+## WinBoLL 基础应用(避免上传敏感配置)
 /winboll.properties
 /local.properties
+
+## WinBoLL 衍生应用，
+## 外派类型类库应用需要注释掉以下部分，以便部署通用类库编译配置。
+## APPBase,AES需要上传以下两种配置。
+#/settings.gradle
+#/gradle.properties

README.md

@@ -1,175 +1,104 @@
-## 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 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 分发。
-
-## WinBoLL-APP 汗下...
-#### ☁应用何置如此呢。且观用户云云。
-
-#### ☁ 正当下 ☁ ###
-#### ☁ 且容傻家叙说 ☁ WinBoLL-APP 应用场景
-### ☁ WinBoLL 设备资源概述
-#### ☁ 1. Raid Disk.
-概述：这是一个矩阵存储类设备。
-优点：该设备具有数据容错存储功能，
-     数据存储具有特长持久性。
-缺点：设备使用能源消耗比较高，
-     设备存取速度一般。
-     
-#### ☁ 2. Data Disk.
-概述：这是一个普通硬盘存储设备
-优点：该设备独立于操作系统，
-     数据持久性一般，
-     存取能源消耗小于 Raid Disk。
-缺点：数据存储速度一般，存储能源消耗一般。
-
-#### ☁ 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.
-
-#### ☁ 5. WinBoLL-APP 用户资源概述。
-1> /sdcard 挂载用户手机 SD 存储/storage/emulated/0
-
-### ☁ 稍稍歇 ☁ ###
-### ☁ 急急停 ☁ 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 项目已设置)
-
-### ☁ 登高处 ☁ 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 应用已提供）
-
-### ☁ 看远方 ☁ ###
-### ☁ 心忧虑 ☁ 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-APP 应用需求规划
-☁ 如要使用 WinBoLL Android 项目的 Gradle 编译功能，则需要设置以下两个文件夹。
-☁ 1. 则需要建立数据存储目录 /sdcard/WinBoLLStudio/APKs。
-   WinBoLL 项目源码编译出来的安装包会拷贝一份到 /sdcard/WinBoLLStudio/APKs 目录下。 
-☁ 2. 则需要建立数据存储目录 /sdcard/AppProjects。
-   WinBoLL 项目源码编译出来的安装包会拷贝一份并命名 "app.apk" 的安装文件为到 /sdcard/AppProjects 目录下。 
-
-
-### ☁ 吁！ ☁ WinBoLL-APP 共享计划前景
-☁ WinBoLL-APP 将会实现 https://winboll.cc/api 访问功能。
-☁ WinBoLL-APP 将会实现手机端 Android 应用的开发与管理功能。
-
-## ☁ 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 文件额外输出路径。
-
-
-# ☆类库型项目编译方法
-## 先编译类库对应的模块测试项目
-### 修改模块测试项目的 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 到这个路径。
-
-## ☆应用调试编译方法
-使用以下命令编译调试：
-
-### Beta调试使用：
-$ bash gradlew assembleBetaDebug
-
-### Stage调试使用：
-$ bash gradlew assembleStageDebug
-
-### 若是 winboll.properties 文件的 [ExtraAPKOutputPath] 属性设置了路径。编译器也会复制一份 APK 到这个路径。
-
-# 应用版本号命名方式
-## statge 渠道
-V<应用开发环境编号><应用功能变更号><应用调试阶段号>
-如：APPBase_15.7.0
-## beta 渠道
-V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)>
-如：APPBase_15.9.6-beta8_5413
+WinBoLL 源生态计划项目说明书
+ 
+一、项目概述
+ 
+1. 核心定位
+ 
+【OriginMaster】WinBoLL 源生态计划，旨在通过核心项目 WinBoLL 联动系列开发库，构建手机端 Android 项目开发与多端编译同步的完整生态，实现手机与电脑的源码同步开发。
+ 
+2. 仓库架构
+ 
+仓库类型 包含仓库 功能说明 
+开发库 WinBoLL、APPBase、AES、PowerBell、Positions 核心开发依赖库，其中 WinBoLL 可作为应用开发的基础继承模板 
+分支汇总存档库 OriginMaster 仅用于汇总各开发库分支，不适宜作为开发库克隆使用，非应用开发基础库 
+ 
+3. 源码推送路径
+ 
+- WinBoLL → APPBase → OriginMaster
+- WinBoLL → AES → OriginMaster
+- WinBoLL → PowerBell → OriginMaster
+- WinBoLL → Positions → OriginMaster
+ 
+二、WinBoLL APP 核心信息
+ 
+1. 项目简介
+ 
+WinBoLL Studio Android 应用开源项目，专注于手机端 Android 开发与多端编译同步。
+ 
+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
+- 托管类库源码：
+- APPBase（jitpack.io）：https://github.com/ZhanGSKen/APPBase.git
+- AES（jitpack.io）：https://github.com/ZhanGSKen/AES.git
+ 
+三、通用特征文件夹前置（/sdcard）
+ 
+- Linux 系统文件夹直接使用  /sdcard 。
+- 手机 SD 卡存储（ /storage/emulated/0 ）挂载的别名也可为  /sdcard 。
+ 
+四、前置条件
+ 
+1. WinBoLL-APP 配置
+ 
+- APK 编译输出目录： /sdcard/WinBoLLStudio/APKs/ ，以及  /sdcard/AppProjects/ （命名为  app.apk ）
+- 签名与命名空间：支持应用签名验证定制化，与衍生 APP 共享  cc.winboll.studio  命名空间
+ 
+五、核心需求规划
+ 
+1. 主机端需求
+ 
+- 支持  winboll.cc  域名的用户注册登录服务
+- 支持  https://console.winboll.cc/api  访问
+ 
+2. APP 端需求
+ 
+- 实现手机端 Android 应用开发与管理功能
+ 
+六、编译与使用指南
+ 
+1. 项目初始化（必须）
+ 
+1. 复制  settings.gradle-demo  为  settings.gradle ，取消对应项目模块注释
+2. 复制  gradle.properties-androidx-demo  或  gradle.properties-android-demo  为  gradle.properties 
+3. （可选）复制  local.properties-demo  为  local.properties ，配置 Android SDK 目录
+4. 签名设置：
+- 调试编译：进入 GenKeyStore 目录执行  bash gen_debug_keystore.sh 
+- 非必须：clone keystore 模块，拷贝  appkey.jks  与  appkey.keystore  到项目根目录
+ 
+2. 编译命令
+ 
+（1）类库型项目
+ 
+1. 修改测试项目  build.properties ，设置  libraryProject=<类库项目模块名> 
+2. 编译测试项目： bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
+3. 编译类库项目： bash .winboll/bashPublishLIBAddTag.sh <类库项目模块名> （发布至 WinBoLL Nexus Maven 库）
+ 
+（2）应用型项目
+ 
+- 编译命令： bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
+ 
+（3）调试编译
+ 
+- Beta 调试： bash gradlew assembleBetaDebug 
+- Stage 调试： bash gradlew assembleStageDebug
+ 
+（4）发布编译
+ 
+- Stage 发布：bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
+             或者执行  bash gradlew assembleStageRelease
+ 
+3. 编译输出路径
+ 
+- 默认路径(assembleBetaDebug任务)： /sdcard/WinBoLLStudio/APKs/<项目根目录名称>/debug/ 
+- 默认路径(assembleStageRelease任务)： /sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/ 
+- 额外路径：若  winboll.properties  配置  ExtraAPKOutputPath ，APK 同步拷贝至该ExtraAPKOutputPath路径
+ 
+4. 版本号命名规则
+ 
+- Stage 渠道： V<应用开发环境编号><应用功能变更号><应用调试阶段号> （示例： APPBase_15.7.0 ）
+- Beta 渠道： V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)> （示例： APPBase_15.9.6-beta8_5413 ）

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 21
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.15"
+        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
+#Sat Jan 31 13:02:06 GMT 2026
+stageCount=12
+libraryProject=libappbase
+baseVersion=15.15
+publishVersion=15.15.11
+buildCount=29
+baseBetaVersion=15.15.12

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,45 @@
+<?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">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:resizeableActivity="true"
+            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=".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,59 @@
+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);
+        getActionBar().setSubtitle(TAG);
+        getActionBar().setDisplayHomeAsUpEnabled(true);
+        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View v) {
+                    finish(); // 点击导航栏返回按钮，触发 finish()
+                }
+            });
+
+		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(getString(R.string.app_name));
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("APPBase");
+        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,43 @@
+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(); // 调用父类初始化逻辑（如基础库配置、全局上下文设置）
+		//setIsDebugging(false);
+		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/MainActivity.java

@@ -0,0 +1,199 @@
+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.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.activities.FTPBackupsActivity;
+import cc.winboll.studio.libappbase.dialogs.SFTPBackupsSettingsDialog;
+import cc.winboll.studio.libappbase.models.SFTPAuthModel;
+import java.util.HashMap;
+import android.os.Environment;
+import java.io.File;
+import cc.winboll.studio.appbase.model.TestBean;
+
+/**
+ * @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 导致崩溃
+        }
+    }
+
+    /**
+     * 日志测试按钮点击事件（打开日志查看界面）
+     * 启动 LogActivity，用于查看应用运行日志
+     * @param view 触发事件的 View（对应布局中的日志测试按钮）
+     */
+    public void onLogTest(View view) {
+        // 启动日志查看 Activity（通过静态方法传入上下文，简化跳转逻辑）
+        LogActivity.startLogActivity(this);
+    }
+
+    /**
+     * 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 onFTPBackupsActivity(View view) {
+		LogUtils.d(TAG, "onFTPBackupsActivity() 调用");
+		SFTPBackupsSettingsDialog dlg = new SFTPBackupsSettingsDialog(this);
+		SFTPAuthModel authModel = SFTPBackupsSettingsDialog.getSFTPAuthModelFromSP(this);
+		if (authModel == null) {
+			dlg.show();
+		} else {
+			// 1. 构建应用Data目录待备份文件Map
+			HashMap<String, String> dataFileMap = new HashMap<>();
+			// 存入文件：key=唯一标识，value=应用Data目录下的相对路径
+			dataFileMap.put(TestBean.class.getName() + ".json", 
+							getTestBeanRelativePath());
+			// 构建SDCard目录待备份文件Map（与BackupUtils的SdcardMap泛型一致：String-String）
+			HashMap<String, String> sdcardFileMap = new HashMap<>();
+			// 存入文件：key=唯一标识，value=应用专属外部文件目录下的相对路径
+			sdcardFileMap.put(TestBean.class.getName() + ".json", 
+							  getTestBeanRelativePath());
+
+			// 2. 构建Intent，指定跳转到FTPBackupsActivity
+			Intent ftpBackupsIntent = new Intent(getApplicationContext(), FTPBackupsActivity.class);
+			// 3. 序列化传递Map参数（使用FTPBackupsActivity中定义的常量，避免硬编码）
+			ftpBackupsIntent.putExtra(FTPBackupsActivity.EXTRA_DATA_DIR_FILE_MAP, dataFileMap);
+			ftpBackupsIntent.putExtra(FTPBackupsActivity.EXTRA_SDCARD_DIR_FILE_MAP, sdcardFileMap);
+            // 传递FTP上传目标目录参数，路径为/WinBoLLStudio/APPBackups/WinBoLL
+            ftpBackupsIntent.putExtra(FTPBackupsActivity.EXTRA_FTP_TARGET_DIR, "/WinBoLLStudio/APPBackups/WinBoLL");
+
+			// 4. 启动Activity，参数自动透传
+			startActivity(ftpBackupsIntent);
+		}
+	}
+}
+

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/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/activity_about.xml

@@ -0,0 +1,21 @@
+<?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.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		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_main.xml

@@ -0,0 +1,91 @@
+<?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="16dp">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		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="@android:color/white"
+				android:background="#81C7F5"
+				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="@android:color/white"
+				android:background="#81C7F5"
+				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="@android:color/white"
+				android:background="#81C7F5"
+				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="FTP应用备份"
+				android:textSize="16sp"
+				android:textColor="@android:color/white"
+				android:background="#81C7F5"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onFTPBackupsActivity"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="关于应用"
+				android:textSize="16sp"
+				android:textColor="@android:color/white"
+				android:background="#81C7F5"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onAboutActivity"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</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/attrs.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+	<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,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="MyAPPBaseTheme" parent="APPBaseTheme">
+        <item name="themeGlobalCrashActivity">@style/MyGlobalCrashActivityTheme</item>
+    </style>
+
+    <style name="MyGlobalCrashActivityTheme" parent="GlobalCrashActivityTheme">
+        <item name="colorTittle">#FFFFFFFF</item>
+        <item name="colorTittleBackgound">#FF00A4B3</item>
+        <item name="colorText">#FFFFFFFF</item>
+        <item name="colorTextBackgound">#FF000000</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>

gradle.properties

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

libappbase/.gitignore

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

libappbase/build.gradle

@@ -0,0 +1,34 @@
+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 21
+        targetSdkVersion 30
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+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
+#Sat Jan 31 13:02:06 GMT 2026
+stageCount=12
+libraryProject=libappbase
+baseVersion=15.15
+publishVersion=15.15.11
+buildCount=29
+baseBetaVersion=15.15.12

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,51 @@
+<?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:process=":LogActivity">
+
+        </activity>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.NfcRsaLoginActivity"/>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.FTPBackupsActivity"/>
+
+    </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/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,558 @@
+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.graphics.Color;
+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>
+ * @Date 2025/11/11 20:14
+ * @Describe  * 应用全局崩溃处理类（单例逻辑）
+ * 核心功能：捕获应用未捕获异常，记录崩溃日志到文件，启动崩溃报告页面，
+ * 并通过「崩溃保险丝」机制防止重复崩溃，保障基础功能可用
+ */
+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 存储键（用于记录崩溃状态） */
+	final static String PREFS = CrashHandler.class.getName() + "PREFS";
+	/** SharedPreferences 中存储「是否发生崩溃」的键 */
+	final static String PREFS_CRASHHANDLER_ISCRASHHAPPEN = "PREFS_CRASHHANDLER_ISCRASHHAPPEN";
+
+	/** 崩溃保险丝状态文件路径（存储当前熔断等级） */
+	public static String _CrashCountFilePath;
+
+	/** 系统默认的未捕获异常处理器（用于降级处理，避免 CrashHandler 自身崩溃） */
+	public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+
+	/**
+	 * 初始化崩溃处理器（默认存储路径）
+	 * 调用重载方法，崩溃日志默认存储在应用外部私有目录的 crash 文件夹下
+	 * @param app 全局 Application 实例（用于获取存储目录、包信息等）
+	 */
+	public static void init(Application app) {
+		// 初始化崩溃保险丝状态文件路径（外部存储/CrashHandler/IsCrashHandlerCrashHappen.dat）
+		_CrashCountFilePath = app.getExternalFilesDir("CrashHandler") + "/IsCrashHandlerCrashHappen.dat";
+		LogUtils.d(TAG, String.format("_CrashCountFilePath %s", _CrashCountFilePath));
+		// 调用带目录参数的初始化方法，传入 null 使用默认路径
+		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(Thread thread, Throwable throwable) {
+					try {
+						// 尝试处理崩溃（捕获内部异常，避免 CrashHandler 自身崩溃）
+						tryUncaughtException(thread, throwable);
+					} catch (Throwable e) {
+						e.printStackTrace();
+						// 处理失败时，交给系统默认处理器兜底
+						if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+							DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+						}
+					}
+				}
+
+				/**
+				 * 实际处理崩溃的核心方法
+				 * 1. 熔断保险丝（记录崩溃次数）；2. 收集崩溃信息；3. 写入日志文件；4. 启动崩溃报告页面
+				 * @param thread 发生崩溃的线程
+				 * @param throwable 崩溃异常对象（包含堆栈信息）
+				 */
+				private void tryUncaughtException(Thread thread, Throwable throwable) {
+					// 触发崩溃保险丝（每次崩溃熔断一次，降低防护等级）
+					AppCrashSafetyWire.getInstance().burnSafetyWire();
+
+					// 格式化崩溃发生时间（用于日志文件名和内容）
+					final String time = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss", Locale.getDefault()).format(new Date());
+					// 创建崩溃日志文件（默认路径：外部存储/crash/[时间].txt）
+					File crashFile = new File(
+						TextUtils.isEmpty(crashDir) ? new File(app.getExternalFilesDir(null), "crash") : new File(crashDir),
+						"crash_" + time + ".txt"
+					);
+
+					// 获取应用版本信息（版本名、版本号）
+					String versionName = "unknown";
+					long versionCode = 0;
+					try {
+						PackageInfo packageInfo = app.getPackageManager().getPackageInfo(app.getPackageName(), 0);
+						versionName = packageInfo.versionName;
+						// 适配 Android 9.0+（API 28）的版本号获取方式
+						versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+					} catch (PackageManager.NameNotFoundException ignored) {}
+
+					// 将异常堆栈信息转换为字符串
+					String fullStackTrace;
+					{
+						StringWriter sw = new StringWriter();
+						PrintWriter pw = new PrintWriter(sw);
+						throwable.printStackTrace(pw); // 将异常堆栈写入 PrintWriter
+						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"); // Android 版本
+					sb.append("Android SDK                          : ").append(Build.VERSION.SDK_INT).append("\n"); // SDK 版本
+					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 ignored) {}
+
+					// 启动崩溃报告页面（标签用于代码块折叠）
+					gotoCrashActiviy: {
+						Intent intent = new Intent();
+						LogUtils.d(TAG, "gotoCrashActiviy: ");
+
+						// 根据保险丝状态选择启动的崩溃页面
+						if (AppCrashSafetyWire.getInstance().isAppCrashSafetyWireOK()) {
+							LogUtils.d(TAG, "gotoCrashActiviy: isAppCrashSafetyWireOK");
+							// 保险丝正常：启动自定义样式的崩溃报告页面（GlobalCrashActivity）
+							intent.setClass(app, GlobalCrashActivity.class);
+							intent.putExtra(EXTRA_CRASH_LOG, errorLog); // 传递崩溃日志
+						} else {
+							LogUtils.d(TAG, "gotoCrashActiviy: else");
+							// 保险丝熔断：启动基础版崩溃页面（CrashActivity，避免复杂页面再次崩溃）
+							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()&&AppCrashSafetyWire.getInstance().isAppCrashSafetyWireOK()) {
+								// 如果是 debug 版，启动崩溃页面窗口
+								app.startActivity(intent);
+							} else {
+								// 如果是 release 版，就只发送一个通知
+								CrashHandleNotifyUtils.handleUncaughtException(app, intent);
+							}
+							// 终止当前进程（确保完全重启）
+							android.os.Process.killProcess(android.os.Process.myPid());
+							System.exit(0);
+
+						} catch (ActivityNotFoundException e) {
+							// 未找到崩溃页面（如未在 Manifest 注册），交给系统默认处理器
+							e.printStackTrace();
+							if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+								DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+							}
+						} catch (Exception e) {
+							// 其他异常，兜底处理
+							e.printStackTrace();
+							if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+								DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+							}
+						}
+					}
+				}
+
+				/**
+				 * 将字符串内容写入文件（创建父目录、覆盖写入）
+				 * @param file 目标文件（包含路径）
+				 * @param content 待写入的内容（崩溃日志）
+				 * @throws IOException 文件创建或写入失败时抛出
+				 */
+				private void writeFile(File file, String content) throws IOException {
+					File parentFile = file.getParentFile();
+					// 父目录不存在则创建
+					if (parentFile != null && !parentFile.exists()) {
+						parentFile.mkdirs();
+					}
+					file.createNewFile(); // 创建文件
+					FileOutputStream fos = new FileOutputStream(file);
+					fos.write(content.getBytes()); // 写入内容（默认 UTF-8 编码）
+					try {
+						fos.close(); // 关闭流
+					} catch (IOException e) {}
+				}
+			});
+	}
+
+	/**
+	 * 应用崩溃保险丝内部类（单例）
+	 * 核心作用：限制短时间内重复崩溃，通过「熔断等级」控制崩溃页面启动策略
+	 * 等级范围：MINI（1）~ MAX（2），每次崩溃等级-1，熔断后启动基础版崩溃页面
+	 */
+	public static final class 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(_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(_CrashCountFilePath);
+				if (f.exists()) {
+					// 反序列化从文件读取等级
+					ObjectInputStream ois = new ObjectInputStream(new FileInputStream(_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：已熔断
+		 */
+		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);
+		}
+	}
+
+	/**
+	 * 基础版崩溃报告页面（保险丝熔断时启动）
+	 * 极简实现：仅展示崩溃日志，提供复制、重启功能，避免复杂布局导致二次崩溃
+	 */
+	public static final class CrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
+		/** 菜单标识：复制崩溃日志 */
+		private static final int MENUITEM_COPY = 0;
+		/** 菜单标识：重启应用 */
+		private static final int MENUITEM_RESTART = 1;
+
+		/** 崩溃日志文本（从 CrashHandler 传递过来） */
+		private String mLog;
+
+		@Override
+		protected void onCreate(Bundle savedInstanceState) {
+			super.onCreate(savedInstanceState);
+			// 初始化崩溃保险丝延迟恢复机制
+			AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(getApplicationContext());
+
+			// 获取传递的崩溃日志
+			mLog = getIntent().getStringExtra(EXTRA_CRASH_LOG);
+			// 设置系统默认主题（避免自定义主题冲突）
+			setTheme(android.R.style.Theme_DeviceDefault_Light_DarkActionBar);
+
+			// 动态创建布局（避免 XML 布局加载异常）
+			setContentView: {
+				// 垂直滚动视图（处理日志过长）
+				ScrollView contentView = new ScrollView(this);
+				contentView.setFillViewport(true);
+
+				// 水平滚动视图（处理日志行过长）
+				HorizontalScrollView hw = new HorizontalScrollView(this);
+				hw.setBackgroundColor(Color.GRAY); // 背景色设为灰色
+
+				// 日志显示文本框
+				TextView message = new TextView(this);
+				{
+					int padding = dp2px(16); // 内边距 16dp（适配不同屏幕）
+					message.setPadding(padding, padding, padding, padding);
+					message.setText(mLog); // 设置崩溃日志
+					message.setTextColor(Color.BLACK); // 文字黑色
+					message.setTextIsSelectable(true); // 支持文本选择（便于手动复制）
+				}
+
+				// 组装布局：TextView -> HorizontalScrollView -> ScrollView
+				hw.addView(message);
+				contentView.addView(hw, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+				// 设置当前 Activity 布局
+				setContentView(contentView);
+
+				// 配置 ActionBar 标题和副标题
+				getActionBar().setTitle(TITTLE);
+				getActionBar().setSubtitle(GlobalApplication.class.getSimpleName() + " Error");
+			}
+		}
+
+		/**
+		 * 重写返回键逻辑：点击返回键直接重启应用
+		 */
+		@Override
+		public void onBackPressed() {
+			restart();
+		}
+
+		/**
+		 * 重启当前应用（与 GlobalCrashActivity 逻辑一致）
+		 * 清除任务栈，启动主 Activity，终止当前进程
+		 */
+		private void restart() {
+			PackageManager pm = getPackageManager();
+			// 获取应用启动意图（默认启动主 Activity）
+			Intent intent = pm.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（适配不同屏幕密度）
+		 * @param dpValue dp 值
+		 * @return 转换后的 px 值
+		 */
+		private int dp2px(final float dpValue) {
+			final float scale = Resources.getSystem().getDisplayMetrics().density;
+			return (int) (dpValue * scale + 0.5f); // 四舍五入确保精度
+		}
+
+		/**
+		 * 菜单点击事件回调（处理复制、重启）
+		 * @param item 被点击的菜单项
+		 * @return false：不消费事件（保持默认行为）
+		 */
+		@Override
+		public boolean onMenuItemClick(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();
+					restart();
+					break;
+			}
+			return false;
+		}
+
+		/**
+		 * 创建 ActionBar 菜单（添加复制、重启项）
+		 * @param menu 菜单容器
+		 * @return true：显示菜单
+		 */
+		@Override
+		public boolean onCreateOptionsMenu(Menu menu) {
+			// 添加「复制」菜单：有空间时显示在 ActionBar，否则放入溢出菜单
+			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;
+		}
+	}
+}
+

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,186 @@
+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.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 19:58
+ * @Describe 应用异常报告观察活动窗口类
+ * 核心功能：应用发生未捕获崩溃时，由 CrashHandler 启动此页面，展示崩溃日志详情，
+ * 并提供「复制日志」「重启应用」操作入口，便于开发者定位问题和用户恢复应用
+ */
+public final class GlobalCrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
+
+    /** 日志标签（用于调试日志输出，唯一标识当前 Activity） */
+    public static final String TAG = "GlobalCrashActivity";
+
+    /** 菜单标识：复制崩溃日志（用于区分菜单项点击事件） */
+    private static final int MENU_ITEM_COPY = 0;
+    /** 菜单标识：重启应用（用于区分菜单项点击事件） */
+    private static final int MENU_ITEM_RESTART = 1;
+
+    /** 崩溃报告展示自定义视图 */
+    // 负责渲染崩溃日志文本、提供 Toolbar 容器，封装了日志展示和菜单样式控制逻辑
+    private GlobalCrashReportView mCrashReportView;
+
+    /** 崩溃日志文本内容 */
+    // 从 CrashHandler 通过 Intent 传递过来，包含异常堆栈、设备信息等完整崩溃数据
+    private String mCrashLog;
+
+    /**
+     * Activity 创建时初始化（生命周期核心方法，仅执行一次）
+     * @param savedInstanceState 保存的实例状态（崩溃页面无需恢复状态，此处仅作兼容）
+     */
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+
+        // 初始化崩溃安全防护机制
+        // 作用：防止应用重启后短时间内再次崩溃，由 CrashHandler 内部实现防护逻辑
+        CrashHandler.AppCrashSafetyWire.getInstance()
+			.postResumeCrashSafetyWireHandler(getApplicationContext());
+
+        // 从 Intent 中获取崩溃日志数据（EXTRA_CRASH_INFO 为 CrashHandler 定义的常量键）
+        mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
+
+        // 设置当前 Activity 的布局文件（展示崩溃报告的 UI 结构）
+        setContentView(R.layout.activity_globalcrash);
+
+        // 初始化崩溃报告展示视图（通过布局 ID 找到自定义 View 实例）
+        mCrashReportView = findViewById(R.id.activityglobalcrashGlobalCrashReportView1);
+        // 将崩溃日志设置到视图中，由自定义 View 负责排版和显示
+        mCrashReportView.setReport(mCrashLog);
+
+        // 设置页面的 ActionBar（复用自定义 View 中的 Toolbar 作为系统 ActionBar）
+        setActionBar(mCrashReportView.getToolbar());
+
+        // 配置 ActionBar 标题和副标题（非空判断避免空指针异常）
+        if (getActionBar() != null) {
+            // 设置标题：使用 CrashHandler 中定义的统一标题（如 "应用崩溃报告"）
+            getActionBar().setTitle(CrashHandler.TITTLE);
+            // 设置副标题：显示当前应用名称（从全局 Application 工具方法获取）
+            getActionBar().setSubtitle(GlobalApplication.getAppName(getApplicationContext()));
+        }
+    }
+
+    /**
+     * 重写返回键点击事件
+     * 逻辑：点击手机返回键时，直接重启应用（而非返回上一页，因崩溃后上一页状态可能异常）
+     */
+    @Override
+    public void onBackPressed() {
+        restartApp();
+    }
+
+    /**
+     * 重启当前应用（核心工具方法）
+     * 实现逻辑：
+     * 1. 获取应用的启动意图（默认启动 AndroidManifest 中配置的主 Activity）
+     * 2. 设置意图标志，清除原有任务栈，避免残留异常页面
+     * 3. 启动主 Activity 并终止当前进程，确保应用完全重启
+     */
+    private void restartApp() {
+        // 获取 PackageManager 实例（用于获取应用相关信息和意图）
+        PackageManager packageManager = getPackageManager();
+        // 获取应用的启动意图（参数为当前应用包名，返回主 Activity 的意图）
+        Intent launchIntent = packageManager.getLaunchIntentForPackage(getPackageName());
+
+        if (launchIntent != null) {
+            // 设置意图标志：
+            // FLAG_ACTIVITY_NEW_TASK：创建新的任务栈启动 Activity
+            // FLAG_ACTIVITY_CLEAR_TOP：清除目标 Activity 之上的所有 Activity
+            // FLAG_ACTIVITY_CLEAR_TASK：清除当前任务栈中的所有 Activity
+            launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
+								  | Intent.FLAG_ACTIVITY_CLEAR_TOP
+								  | Intent.FLAG_ACTIVITY_CLEAR_TASK);
+            // 启动应用主 Activity
+            startActivity(launchIntent);
+        }
+
+        // 关闭当前崩溃报告页面
+        finish();
+        // 终止当前应用进程（确保释放所有资源，避免内存泄漏）
+        android.os.Process.killProcess(android.os.Process.myPid());
+        // 强制退出虚拟机（彻底终止应用，防止残留线程继续运行）
+        System.exit(0);
+    }
+
+    /**
+     * 菜单项点击事件回调（实现 MenuItem.OnMenuItemClickListener 接口）
+     * @param item 被点击的菜单项实例
+     * @return boolean：true 表示事件已消费，不再向下传递；false 表示未消费
+     */
+    @Override
+    public boolean onMenuItemClick(MenuItem item) {
+        // 根据菜单项 ID 判断点击的是哪个功能
+        switch (item.getItemId()) {
+            case MENU_ITEM_COPY:
+                // 点击「复制」菜单，执行复制崩溃日志到剪贴板
+                copyCrashLogToClipboard();
+                break;
+            case MENU_ITEM_RESTART:
+                // 点击「重启」菜单：先恢复崩溃防护机制到最大等级，再重启应用
+                CrashHandler.AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+                restartApp();
+                break;
+        }
+        return false;
+    }
+
+    /**
+     * 创建页面顶部菜单（ActionBar 菜单）
+     * @param menu 菜单容器，用于添加菜单项
+     * @return boolean：true 表示显示菜单；false 表示不显示
+     */
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        // 添加「复制」菜单项：
+        // 参数说明：菜单组 ID（0 表示默认组）、菜单项 ID（MENU_ITEM_COPY）、排序号（0）、菜单文本（"Copy"）
+        // setOnMenuItemClickListener(this)：绑定点击事件到当前 Activity
+        // setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM)：有空间时显示在 ActionBar 上，否则放入溢出菜单
+        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);
+
+        // 调用自定义视图的方法，更新菜单文字样式（如颜色、字体大小等，由自定义 View 内部实现）
+        mCrashReportView.updateMenuStyle();
+
+        return true;
+    }
+
+    /**
+     * 将崩溃日志复制到系统剪贴板（工具方法）
+     * 功能：用户点击复制菜单后，将完整崩溃日志存入剪贴板，方便粘贴到聊天工具或文档中
+     */
+    private void copyCrashLogToClipboard() {
+        // 获取系统剪贴板服务（需通过 getSystemService 方法获取）
+        ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+
+        // 创建剪贴板数据：
+        // 参数 1：标签（用于标识剪贴板内容来源，此处用应用包名）
+        // 参数 2：实际复制的文本内容（崩溃日志）
+        ClipData clipData = ClipData.newPlainText(getPackageName(), mCrashLog);
+
+        // 将数据设置到剪贴板（完成复制操作）
+        clipboardManager.setPrimaryClip(clipData);
+
+        // 显示复制成功的 Toast 提示（告知用户操作结果）
+        Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
+    }
+}
+

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

@@ -0,0 +1,309 @@
+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;
+
+/**
+ * @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() {
+		// 设置默认配色
+		mTitleColor = Color.WHITE;
+		mTitleBackgroundColor = Color.BLACK;
+		mTextColor = Color.BLACK;
+		mTextBackgroundColor = Color.WHITE;
+		// 加载布局
+		inflateView();
+		// 初始化控件样式
+		initWidgetStyle();
+	}
+
+	/**
+	 * 初始化视图（解析自定义属性 + 加载布局 + 设置样式）
+	 * @param attrs 自定义属性集合
+	 */
+	private void initView(AttributeSet attrs) {
+		// 解析自定义属性（关联 attrs.xml 中的 GlobalCrashActivity 样式）
+		TypedArray typedArray = mContext.obtainStyledAttributes(
+			attrs,
+			R.styleable.GlobalCrashActivity,
+			R.attr.themeGlobalCrashActivity,
+			0
+		);
+
+		// 读取自定义属性值（无设置时使用默认值）
+		mTitleColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTittle,
+			Color.WHITE
+		);
+		mTitleBackgroundColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTittleBackgound, // 注：原拼写错误（Backgound→Background），保持与 attrs.xml 一致
+			Color.BLACK
+		);
+		mTextColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorText,
+			Color.BLACK
+		);
+		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() {
+		// 设置主布局背景颜色
+		setBackgroundColor(mTextBackgroundColor);
+
+		// 配置工具栏样式
+		if (mToolbar != null) {
+			mToolbar.setBackgroundColor(mTitleBackgroundColor);
+			mToolbar.setTitleTextColor(mTitleColor);
+			mToolbar.setSubtitleTextColor(mTitleColor);
+		}
+
+		// 配置日志文本控件样式
+		if (mTvReport != null) {
+			mTvReport.setTextColor(mTextColor);
+			mTvReport.setBackgroundColor(mTextBackgroundColor);
+			// 可选：设置日志文本换行方式（默认已换行，此处增强可读性）
+			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,65 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+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) {
+        // 创建启动当前 Activity 的 Intent
+        Intent intent = new Intent(context, LogActivity.class);
+
+        // 添加 Intent 标志：支持分屏/多窗口模式（API 24+）
+        intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
+        // 添加 Intent 标志：创建新任务栈（避免并入调用者任务栈）
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 添加 Intent 标志：标记为新文档（多任务窗口中独立显示）
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+        // 添加 Intent 标志：允许创建多个任务实例（支持多次启动独立窗口）
+        intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+
+        // 启动 Activity
+        context.startActivity(intent);
+    }
+}
+

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

@@ -0,0 +1,732 @@
+package cc.winboll.studio.libappbase;
+
+/**
+ * @Author ZhanGSKen@QQ.COM
+ * @Date 2024/08/12 13:44:06
+ * @Describe LogUtils
+ * @Describe 应用日志类（补全所有日志重载方法，适配不同调试场景）
+ */
+import android.content.Context;
+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;
+
+
+public class LogUtils {
+
+    public static final String TAG = "LogUtils";
+
+    public static enum LOG_LEVEL { Off, Error, Warn, Info, Debug, Verbose }
+
+    static volatile boolean _IsInited = false;
+    static Context _mContext;
+    // 日志显示时间格式
+    static SimpleDateFormat mSimpleDateFormat = new SimpleDateFormat("[yyyyMMdd_HHmmss_SSS]", Locale.getDefault());
+    // 应用日志文件夹
+    static File _mfLogCacheDir;
+    static File _mfLogDataDir;
+    // 应用日志文件
+    static File _mfLogCatchFile;
+    static File _mfLogUtilsBeanFile;
+    static LogUtilsBean _mLogUtilsBean;
+    public static Map<String, Boolean> mapTAGList = new HashMap<String, Boolean>();
+
+    //
+    // 初始化函数
+    //
+    public static void init(Context context) {
+        _mContext = context;
+        init(context, LOG_LEVEL.Off);
+    }
+
+    //
+    // 初始化函数
+    //
+    public static void init(Context context, LOG_LEVEL logLevel) {
+        if (GlobalApplication.isDebugging()) {
+            // 初始化日志缓存文件路径（debug模式：外部存储）
+            _mfLogCacheDir = new File(context.getApplicationContext().getExternalCacheDir(), TAG);
+            if (!_mfLogCacheDir.exists()) {
+                _mfLogCacheDir.mkdirs();
+            }
+            _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
+
+            // 初始化日志配置文件路径
+            _mfLogDataDir = context.getApplicationContext().getExternalFilesDir(TAG);
+            if (!_mfLogDataDir.exists()) {
+                _mfLogDataDir.mkdirs();
+            }
+            _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
+        } else {
+            // 初始化日志缓存文件路径（release模式：内部存储）
+            _mfLogCacheDir = new File(context.getApplicationContext().getCacheDir(), TAG);
+            if (!_mfLogCacheDir.exists()) {
+                _mfLogCacheDir.mkdirs();
+            }
+            _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
+
+            // 初始化日志配置文件路径
+            _mfLogDataDir = new File(context.getApplicationContext().getFilesDir(), TAG);
+            if (!_mfLogDataDir.exists()) {
+                _mfLogDataDir.mkdirs();
+            }
+            _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
+        }
+
+        _mLogUtilsBean = LogUtilsBean.loadBeanFromFile(_mfLogUtilsBeanFile.getPath(), LogUtilsBean.class);
+        if (_mLogUtilsBean == null) {
+            _mLogUtilsBean = new LogUtilsBean();
+            _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
+        }
+
+        // 加载当前应用下的所有类的 TAG
+        addClassTAGList();
+        loadTAGBeanSettings();
+        _IsInited = true;
+        LogUtils.d(TAG, String.format("mapTAGList : %s", mapTAGList.toString()));
+    }
+
+    public static Map<String, Boolean> getMapTAGList() {
+        return mapTAGList;
+    }
+
+    static void loadTAGBeanSettings() {
+        ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
+        LogUtilsClassTAGBean.loadBeanList(_mContext, list, LogUtilsClassTAGBean.class);
+        for (int i = 0; i < list.size(); i++) {
+            LogUtilsClassTAGBean beanSetting = list.get(i);
+            for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+                if (entry.getKey().equals(beanSetting.getTag())) {
+                    entry.setValue(beanSetting.getEnable());
+                }
+            }
+        }
+    }
+
+    static void saveTAGBeanSettings() {
+        ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
+        for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+            list.add(new LogUtilsClassTAGBean(entry.getKey(), entry.getValue()));
+        }
+        LogUtilsClassTAGBean.saveBeanList(_mContext, list, LogUtilsClassTAGBean.class);
+    }
+
+    static void addClassTAGList() {
+        try {
+            // 包名前缀（过滤当前应用的类）
+            String packageNamePrefix = "cc.winboll.studio";
+            List<String> classNames = new ArrayList<>();
+            String apkPath = _mContext.getPackageCodePath();
+            LogUtils.d(TAG, String.format("apkPath : %s", apkPath));
+
+            DexFile dexfile = new DexFile(apkPath);
+            int countTemp = 0;
+            Enumeration<String> entries = dexfile.entries();
+            while (entries.hasMoreElements()) {
+                countTemp++;
+                String className = entries.nextElement();
+                if (className.startsWith(packageNamePrefix)) {
+                    classNames.add(className);
+                }
+            }
+
+            LogUtils.d(TAG, String.format("countTemp : %d\nClassNames size : %d", countTemp, classNames.size()));
+
+            for (String className : classNames) {
+                try {
+                    Class<?> clazz = Class.forName(className);
+                    Field[] fields = clazz.getDeclaredFields();
+                    for (Field field : fields) {
+                        // 过滤静态、公共、String类型的 TAG 字段
+                        if (Modifier.isStatic(field.getModifiers()) 
+							&& Modifier.isPublic(field.getModifiers()) 
+							&& field.getType() == String.class 
+							&& "TAG".equals(field.getName())) {
+                            String tagValue = (String) field.get(null);
+                            mapTAGList.put(tagValue, false); // 默认禁用，可通过设置开启
+                        }
+                    }
+                } catch (NoClassDefFoundError | ClassNotFoundException | IllegalAccessException e) {
+                    LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+                }
+            }
+        } catch (IOException e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+    }
+
+    public static void setTAGListEnable(String tag, boolean isEnable) {
+        Iterator<Map.Entry<String, Boolean>> iterator = mapTAGList.entrySet().iterator();
+        while (iterator.hasNext()) {
+            Map.Entry<String, Boolean> entry = iterator.next();
+            if (tag.equals(entry.getKey())) {
+                entry.setValue(isEnable);
+                break;
+            }
+        }
+        saveTAGBeanSettings();
+        LogUtils.d(TAG, String.format("mapTAGList : %s", mapTAGList.toString()));
+    }
+
+    public static void setALlTAGListEnable(boolean isEnable) {
+        Iterator<Map.Entry<String, Boolean>> iterator = mapTAGList.entrySet().iterator();
+        while (iterator.hasNext()) {
+            Map.Entry<String, Boolean> entry = iterator.next();
+            entry.setValue(isEnable);
+        }
+        saveTAGBeanSettings();
+        LogUtils.d(TAG, String.format("mapTAGList : %s", mapTAGList.toString()));
+    }
+
+    public static void setLogLevel(LOG_LEVEL logLevel) {
+        LogUtils._mLogUtilsBean.setLogLevel(logLevel);
+        _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
+    }
+
+    public static LOG_LEVEL getLogLevel() {
+        return LogUtils._mLogUtilsBean.getLogLevel();
+    }
+
+    static boolean isLoggable(String tag, LOG_LEVEL logLevel) {
+        if (!_IsInited) {
+            return false;
+        } 
+        // TAG 未配置或禁用时，不打印日志
+        if (mapTAGList.get(tag) == null || !mapTAGList.get(tag)) {
+            return false;
+        } 
+        // 日志级别不符合时，不打印日志
+        if (!isInTheLevel(logLevel)) {
+            return false;
+        }
+        return true;
+    }
+
+    static boolean isInTheLevel(LOG_LEVEL logLevel) {
+        // 当前日志级别 >= 目标级别时，允许打印（级别顺序：Off < Error < Warn < Info < Debug < Verbose）
+        return LogUtils._mLogUtilsBean.getLogLevel().ordinal() >= logLevel.ordinal();
+    }
+
+    //
+    // 获取应用日志文件夹
+    //
+    public static File getLogCacheDir() {
+        return _mfLogCacheDir;
+    }
+
+    // ================================= 补全所有日志重载方法（Error 级别） =================================
+    /**
+     * Error 级别日志（仅消息）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     */
+    public static void e(String szTAG, String szMessage) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Error)) {
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Error, szMessage);
+        }
+    }
+
+    /**
+     * Error 级别日志（消息 + 异常）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param e 异常对象
+     */
+    public static void e(String szTAG, String szMessage, Exception e) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Error)) {
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    /**
+     * Error 级别日志（仅异常）
+     * @param szTAG 标签
+     * @param e 异常对象
+     */
+    public static void e(String szTAG, Exception e) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Error)) {
+            String message = "【异常信息】: " + getExceptionInfo(e);
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Error, message);
+        }
+    }
+
+    /**
+     * Error 级别日志（消息 + 异常 + 堆栈）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param e 异常对象
+     * @param listStackTrace 堆栈信息
+     */
+    public static void e(String szTAG, String szMessage, Exception e, StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Error)) {
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            sb.append("\n【堆栈信息】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    // ================================= 补全所有日志重载方法（Warn 级别） =================================
+    /**
+     * Warn 级别日志（仅消息）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     */
+    public static void w(String szTAG, String szMessage) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Warn)) {
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Warn, szMessage);
+        }
+    }
+
+    /**
+     * Warn 级别日志（消息 + 异常）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param e 异常对象
+     */
+    public static void w(String szTAG, String szMessage, Exception e) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Warn)) {
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Warn, sb.toString());
+        }
+    }
+
+    /**
+     * Warn 级别日志（仅异常）
+     * @param szTAG 标签
+     * @param e 异常对象
+     */
+    public static void w(String szTAG, Exception e) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Warn)) {
+            String message = "【异常信息】: " + getExceptionInfo(e);
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Warn, message);
+        }
+    }
+
+    // ================================= 补全所有日志重载方法（Info 级别） =================================
+    /**
+     * Info 级别日志（仅消息）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     */
+    public static void i(String szTAG, String szMessage) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Info)) {
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Info, szMessage);
+        }
+    }
+
+    /**
+     * Info 级别日志（消息 + 数据对象）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param obj 数据对象（自动转为字符串）
+     */
+    public static void i(String szTAG, String szMessage, Object obj) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Info)) {
+            String objStr = obj == null ? "null" : obj.toString();
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Info, sb.toString());
+        }
+    }
+
+    // ================================= 补全所有日志重载方法（Debug 级别） =================================
+    /**
+     * Debug 级别日志（仅消息）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     */
+    public static void d(String szTAG, String szMessage) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, szMessage);
+        }
+    }
+
+    /**
+     * Debug 级别日志（消息 + 堆栈）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param listStackTrace 堆栈信息
+     */
+    public static void d(String szTAG, String szMessage, StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
+            StringBuilder sbMessage = new StringBuilder(szMessage);
+            sbMessage.append("\n【调用堆栈】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sbMessage.toString());
+        }
+    }
+
+    /**
+     * Debug 级别日志（消息 + 异常）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param e 异常对象
+     */
+    public static void d(String szTAG, String szMessage, Exception e) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    /**
+     * Debug 级别日志（异常 + 堆栈）
+     * @param szTAG 标签
+     * @param e 异常对象
+     * @param listStackTrace 堆栈信息
+     */
+    public static void d(String szTAG, Exception e, StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
+            StringBuilder sbMessage = new StringBuilder();
+            sbMessage.append("【异常信息】: ").append(getExceptionInfo(e));
+            sbMessage.append("\n【调用堆栈】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sbMessage.toString());
+        }
+    }
+
+    /**
+     * Debug 级别日志（消息 + 数据对象）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param obj 数据对象（自动转为字符串）
+     */
+	public static void d(String szTAG, String szMessage, Object obj) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
+            String objStr = obj == null ? "null" : obj.toString();
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    /**
+     * Debug 级别日志（仅数据对象）
+     * @param szTAG 标签
+     * @param obj 数据对象（自动转为字符串）
+     */
+    public static void d(String szTAG, Object obj) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
+            String objStr = obj == null ? "null" : obj.toString();
+            String message = "【数据对象】: " + objStr;
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, message);
+        }
+    }
+
+    // ================================= 补全所有日志重载方法（Verbose 级别） =================================
+    /**
+     * Verbose 级别日志（仅消息）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     */
+    public static void v(String szTAG, String szMessage) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Verbose)) {
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Verbose, szMessage);
+        }
+    }
+
+    /**
+     * Verbose 级别日志（消息 + 数据对象）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param obj 数据对象（自动转为字符串）
+     */
+    public static void v(String szTAG, String szMessage, Object obj) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Verbose)) {
+            String objStr = obj == null ? "null" : obj.toString();
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Verbose, sb.toString());
+        }
+    }
+
+    /**
+     * Verbose 级别日志（仅数据对象）
+     * @param szTAG 标签
+     * @param obj 数据对象（自动转为字符串）
+     */
+    public static void v(String szTAG, Object obj) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Verbose)) {
+            String objStr = obj == null ? "null" : obj.toString();
+            String message = "【数据对象】: " + objStr;
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Verbose, message);
+        }
+    }
+
+    // ================================= 新增：通用日志工具方法（补充调试能力） =================================
+    /**
+     * 打印当前线程信息（Debug 级别）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     */
+    public static void printThreadInfo(String szTAG, String szMessage) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
+            Thread currentThread = Thread.currentThread();
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【线程信息】: ")
+				.append("线程名=").append(currentThread.getName())
+				.append(", 线程ID=").append(currentThread.getId())
+				.append(", 线程状态=").append(currentThread.getState().name());
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    /**
+     * 打印 Map 数据（Debug 级别，格式化输出，便于查看）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param map 要打印的 Map 数据
+     */
+    public static <K, V> void printMap(String szTAG, String szMessage, Map<K, V> map) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug) && map != null) {
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【Map 数据】（size=").append(map.size()).append("）:");
+            for (Map.Entry<K, V> entry : map.entrySet()) {
+                String keyStr = entry.getKey() == null ? "null" : entry.getKey().toString();
+                String valueStr = entry.getValue() == null ? "null" : entry.getValue().toString();
+                sb.append("\n  ").append(keyStr).append(" = ").append(valueStr);
+            }
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    /**
+     * 打印 List 数据（Debug 级别，格式化输出）
+     * @param szTAG 标签
+     * @param szMessage 日志消息
+     * @param list 要打印的 List 数据
+     */
+    public static <T> void printList(String szTAG, String szMessage, List<T> list) {
+        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug) && list != null) {
+            StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【List 数据】（size=").append(list.size()).append("）:");
+            for (int i = 0; i < list.size(); i++) {
+                T item = list.get(i);
+                String itemStr = item == null ? "null" : item.toString();
+                sb.append("\n  索引").append(i).append(" = ").append(itemStr);
+            }
+            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    // ================================= 私有工具方法（异常/堆栈信息格式化） =================================
+    /**
+     * 格式化异常信息（提取异常类型、消息、简化堆栈）
+     * @param e 异常对象
+     * @return 格式化后的异常字符串
+     */
+    private static String getExceptionInfo(Exception e) {
+        if (e == null) {
+            return "异常对象为null";
+        }
+        StringBuilder sb = new StringBuilder();
+        // 异常类型 + 异常消息
+        sb.append(e.getClass().getSimpleName()).append(" : ").append(e.getMessage() == null ? "无异常消息" : e.getMessage());
+        // 简化堆栈（取前5行，避免日志过长）
+        StackTraceElement[] stackTrace = e.getStackTrace();
+        if (stackTrace != null && stackTrace.length > 0) {
+            sb.append("\n  简化堆栈（前5行）:");
+            int limit = Math.min(stackTrace.length, 5);
+            for (int i = 0; i < limit; i++) {
+                sb.append("\n    ").append(stackTrace[i].toString());
+            }
+        }
+        return sb.toString();
+    }
+
+    /**
+     * 格式化堆栈信息（提取关键调用链路）
+     * @param stackTrace 堆栈数组
+     * @return 格式化后的堆栈字符串
+     */
+    private static String getStackTraceInfo(StackTraceElement[] stackTrace) {
+        if (stackTrace == null || stackTrace.length == 0) {
+            return "堆栈信息为空";
+        }
+        StringBuilder sb = new StringBuilder();
+        // 过滤 LogUtils 内部调用，取真实业务调用链路（前8行）
+        int count = 0;
+        for (StackTraceElement element : stackTrace) {
+            // 跳过 LogUtils 自身的堆栈（避免冗余）
+            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();
+    }
+
+    // ================================= 原有核心方法（保留并优化） =================================
+    /**
+     * 日志文件保存函数（优化：增加异常捕获完整性，避免流泄漏）
+     * @param szTAG 标签
+     * @param logLevel 日志级别
+     * @param szMessage 日志消息
+     */
+    static void saveLog(String szTAG, LogUtils.LOG_LEVEL logLevel, String szMessage) {
+        BufferedWriter out = null;
+        try {
+            // 确保日志文件存在（创建父目录 + 文件）
+            if (!_mfLogCatchFile.exists()) {
+                File parentDir = _mfLogCatchFile.getParentFile();
+                if (parentDir != null && !parentDir.exists()) {
+                    parentDir.mkdirs();
+                }
+                _mfLogCatchFile.createNewFile();
+            }
+            // 追加写入日志（UTF-8编码，避免中文乱码）
+            out = new BufferedWriter(new OutputStreamWriter(
+										 new FileOutputStream(_mfLogCatchFile, true), "UTF-8"));
+            String logLine = "[" + logLevel + "]  " 
+				+ mSimpleDateFormat.format(System.currentTimeMillis()) 
+				+ "  [" + szTAG + "]\n" 
+				+ szMessage + "\n\n"; // 增加空行，区分不同日志
+            out.write(logLine);
+            out.flush(); // 强制刷新，确保日志及时写入
+        } catch (IOException e) {
+            // 日志写入失败时，打印系统日志（避免递归调用）
+            android.util.Log.e(TAG, "日志写入失败: " + e.getMessage());
+        } finally {
+            // 关闭流，避免资源泄漏（Java 7 手动关闭，无 try-with-resources）
+            if (out != null) {
+                try {
+                    out.close();
+                } catch (IOException e) {
+                    android.util.Log.e(TAG, "流关闭失败: " + e.getMessage());
+                }
+            }
+        }
+    }
+
+    /**
+     * 历史日志加载函数（优化：增加流关闭，避免内存泄漏）
+     * @return 日志内容字符串（空串表示无日志）
+     */
+    public static String loadLog() {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return "日志文件不存在";
+        }
+        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);
+                sb.append("\n");
+            }
+        } catch (IOException e) {
+            sb.append("日志加载失败: ").append(e.getMessage());
+            LogUtils.e(TAG, "日志加载异常", e);
+        } finally {
+            // 关闭流，避免资源泄漏
+            if (in != null) {
+                try {
+                    in.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "流关闭异常", e);
+                }
+            }
+        }
+        return sb.toString();
+    }
+
+    /**
+     * 清理日志函数（优化：支持清空日志，避免文件过大）
+     */
+    public static void cleanLog() {
+        if (_mfLogCatchFile == null) {
+            LogUtils.d(TAG, "日志文件未初始化，无需清理");
+            return;
+        }
+        try {
+            // 清空文件内容（覆盖写入空字符串）
+            BufferedWriter out = new BufferedWriter(new OutputStreamWriter(
+														new FileOutputStream(_mfLogCatchFile, false), "UTF-8"));
+            out.write("");
+            out.flush();
+            out.close();
+            LogUtils.d(TAG, "日志已清空，文件路径: " + _mfLogCatchFile.getPath());
+        } catch (IOException e) {
+            LogUtils.e(TAG, "日志清空失败", e);
+        }
+    }
+
+    /**
+     * 检查日志文件大小（新增：避免日志文件过大占用内存）
+     * @param maxSizeMB 最大允许大小（MB）
+     * @return true：文件超过限制；false：文件大小正常
+     */
+    public static boolean checkLogFileSize(int maxSizeMB) {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return false;
+        }
+        // 转换为字节（1MB = 1024*1024 字节）
+        long maxSizeByte = maxSizeMB * 1024 * 1024;
+        long fileSize = _mfLogCatchFile.length();
+        LogUtils.d(TAG, String.format("日志文件大小: %.2f MB（限制: %d MB）", 
+									  fileSize / (1024.0 * 1024), maxSizeMB));
+        return fileSize > maxSizeByte;
+    }
+
+    /**
+     * 初始化检查（新增：快速判断 LogUtils 是否初始化完成）
+     * @return true：已初始化；false：未初始化
+     */
+    public static boolean isInited() {
+        return _IsInited;
+    }
+
+    /**
+     * 显示短提示（新增：日志+Toast联动，调试时快速提示）
+     * @param context 上下文
+     * @param message 提示内容
+     */
+    public static void showShortToast(final Context context, final String message) {
+        if (context == null || message == null) {
+            return;
+        }
+        // 主线程显示Toast，避免子线程崩溃
+        if (Thread.currentThread().getId() == android.os.Process.myTid()) {
+            Toast.makeText(context, message, Toast.LENGTH_SHORT).show();
+        } else {
+            ((android.app.Activity) context).runOnUiThread(new Runnable() {
+					@Override
+					public void run() {
+						Toast.makeText(context, message, Toast.LENGTH_SHORT).show();
+					}
+				});
+        }
+        // 同时写入日志
+        LogUtils.d(TAG, "Toast提示: " + message);
+    }
+}
+

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;
+    }
+}
+

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

@@ -0,0 +1,161 @@
+package cc.winboll.studio.libappbase;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/01/04 14:17:02
+ * @Describe 日志 TAG 过滤配置模型（继承 BaseBean，实现 JSON 序列化/反序列化）
+ * 封装单个日志 TAG 的名称及其启用状态，用于 LogUtils 的 TAG 过滤规则持久化存储与读取
+ */
+public class LogUtilsClassTAGBean extends BaseBean {
+
+    /** 当前类的日志 TAG（用于调试输出） */
+    public static final String TAG = "LogUtilsClassTAGBean";
+
+    /**
+     * 日志 TAG 名称（如 "LogViewThread"、"ToastUtils"）
+     * 与 LogUtils 中扫描的应用内 TAG 一一对应
+     */
+    private String tag;
+
+    /**
+     * TAG 启用状态（控制该 TAG 的日志是否输出）
+     * true：启用（输出该 TAG 的日志）；false：禁用（不输出该 TAG 的日志）
+     */
+    private Boolean enable;
+
+    /**
+     * 无参构造方法（默认初始化：TAG 为当前类 TAG，启用状态为 true）
+     * 用于 JSON 反序列化时的实例创建，或默认配置生成
+     */
+    public LogUtilsClassTAGBean() {
+        this.tag = TAG;       // 默认 TAG 为当前类的 TAG
+        this.enable = true;   // 默认启用该 TAG 的日志输出
+    }
+
+    /**
+     * 有参构造方法（指定 TAG 名称和启用状态）
+     * 用于主动创建 TAG 过滤配置实例
+     * @param tag     日志 TAG 名称
+     * @param enable  TAG 启用状态（true/false）
+     */
+    public LogUtilsClassTAGBean(String tag, Boolean enable) {
+        this.tag = tag;
+        this.enable = enable;
+    }
+
+    /**
+     * 设置日志 TAG 名称
+     * @param tag 目标 TAG 名称
+     */
+    public void setTag(String tag) {
+        this.tag = tag;
+    }
+
+    /**
+     * 获取日志 TAG 名称
+     * @return 当前配置的 TAG 名称
+     */
+    public String getTag() {
+        return tag;
+    }
+
+    /**
+     * 设置 TAG 启用状态
+     * @param enable 目标启用状态（true：启用；false：禁用）
+     */
+    public void setEnable(Boolean enable) {
+        this.enable = enable;
+    }
+
+    /**
+     * 获取 TAG 启用状态
+     * @return 当前 TAG 的启用状态
+     */
+    public Boolean getEnable() {
+        return enable;
+    }
+
+    /**
+     * 重写父类方法：获取当前类的全限定名（用于 BaseBean 反射识别）
+     * @return 类全限定名（如 "cc.winboll.studio.libappbase.LogUtilsClassTAGBean"）
+     */
+    @Override
+    public String getName() {
+        return LogUtilsClassTAGBean.class.getName();
+    }
+
+    /**
+     * 重写父类方法：将当前 TAG 配置对象序列化为 JSON（持久化存储时调用）
+     * 序列化字段：tag（TAG 名称）、enable（启用状态）
+     * @param jsonWriter JSON 写入器（用于输出 JSON 数据）
+     * @throws IOException JSON 写入异常（如流关闭、格式错误）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        // 调用父类序列化逻辑（若 BaseBean 有公共字段，需优先处理）
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化 TAG 名称
+        jsonWriter.name("tag").value(this.getTag());
+        // 序列化启用状态
+        jsonWriter.name("enable").value(this.getEnable());
+    }
+
+    /**
+     * 重写父类方法：从 JSON 字段初始化当前对象（读取配置时调用）
+     * 解析字段：tag（TAG 名称）、enable（启用状态）
+     * @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 ("tag".equals(name)) {
+            // 读取 TAG 名称并设置
+            this.setTag(jsonReader.nextString());
+        } else if ("enable".equals(name)) {
+            // 读取启用状态并设置
+            this.setEnable(jsonReader.nextBoolean());
+        } else {
+            // 字段不匹配，返回 false 表示需要跳过该字段
+            return false;
+        }
+        // 字段解析成功
+        return true;
+    }
+
+    /**
+     * 重写父类方法：从 JSON 读取器完整解析配置对象（入口方法）
+     * 负责 JSON 对象的开始/结束解析，遍历所有字段并调用 initObjectsFromJsonReader 处理
+     * @param jsonReader JSON 读取器（传入待解析的 JSON 流）
+     * @return 解析后的当前 LogUtilsClassTAGBean 实例（支持链式调用）
+     * @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 LogUtilsClassTAGBean().readBeanFromJsonReader(reader)）
+        return this;
+    }
+}
+

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

@@ -0,0 +1,542 @@
+package cc.winboll.studio.libappbase;
+
+/**
+ * @Author ZhanGSKen@QQ.COM
+ * @Date 2024/08/12 14:36:18
+ * @Describe 日志视图类，继承 RelativeLayout 类。
+ */
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.os.Handler;
+import android.os.Message;
+import android.text.Editable;
+import android.text.TextWatcher;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.AdapterView;
+import android.widget.ArrayAdapter;
+import android.widget.BaseAdapter;
+import android.widget.CheckBox;
+import android.widget.EditText;
+import android.widget.HorizontalScrollView;
+import android.widget.RelativeLayout;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.views.HorizontalListView;
+import cc.winboll.studio.libappbase.widget.LogTagSpinner;
+import java.text.Collator;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+
+public class LogView extends RelativeLayout {
+
+    public static final String TAG = "LogView";
+
+    public volatile boolean mIsHandling;
+    public volatile boolean mIsAddNewLog;
+
+    Context mContext;
+    ScrollView mScrollView;
+    TextView mTextView;
+    EditText metTagSearch;
+    CheckBox mSelectableCheckBox;
+    CheckBox mSelectAllTAGCheckBox;
+    TAGListAdapter mTAGListAdapter;
+    LogViewThread mLogViewThread;
+    LogViewHandler mLogViewHandler;
+    LogTagSpinner mLogLevelSpinner;
+    ArrayAdapter<CharSequence> mLogLevelSpinnerAdapter;
+    // 标签列表
+    HorizontalListView mListViewTags;
+
+    public LogView(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public LogView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    public LogView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    public LogView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        initView(context);
+    }
+
+    public void start() {
+        mLogViewThread = new LogViewThread(LogView.this);
+        mLogViewThread.start();
+        // 显示日志
+        showAndScrollLogView();
+    }
+
+    public void scrollLogUp() {
+        mScrollView.post(new Runnable() {
+                @Override
+                public void run() {
+                    mScrollView.fullScroll(ScrollView.FOCUS_DOWN);
+                    // 日志显示结束
+                    mLogViewHandler.setIsHandling(false);
+                    // 检查是否添加了新日志
+                    if (mLogViewHandler.isAddNewLog()) {
+                        // 有新日志添加，先更改新日志标志
+                        mLogViewHandler.setIsAddNewLog(false);
+                        // 再次发送显示日志的显示
+                        Message message = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOGVIEW_UPDATE);
+                        mLogViewHandler.sendMessage(message);
+                    }
+                }
+            });
+    }
+
+    void initView(Context context) {
+        mContext = context;
+        mLogViewHandler = new LogViewHandler();
+        // 加载视图布局
+        addView(inflate(mContext, cc.winboll.studio.libappbase.R.layout.view_log, null));
+        // 初始化日志子控件视图
+        //
+        mScrollView = findViewById(cc.winboll.studio.libappbase.R.id.viewlogScrollViewLog);
+        mTextView = findViewById(cc.winboll.studio.libappbase.R.id.viewlogTextViewLog);
+        metTagSearch = findViewById(cc.winboll.studio.libappbase.R.id.tagsearch_et);
+        // 获取Log Level spinner实例
+        mLogLevelSpinner = findViewById(cc.winboll.studio.libappbase.R.id.viewlogSpinner1);
+
+		metTagSearch.setTextColor(mContext.getResources().getColor(R.color.white));
+        metTagSearch.addTextChangedListener(new TextWatcher() {
+
+                @Override
+                public void afterTextChanged(Editable editable) {
+                }
+
+                @Override
+                public void beforeTextChanged(CharSequence charSequence, int p, int p1, int p2) {
+                }
+
+                @Override
+                public void onTextChanged(CharSequence s, int start, int before, int count) {
+                    LogUtils.d(TAG, s.toString());
+                    if (s.length() > 0) {
+                        scrollToTag(s.toString());
+                    } else {
+                        HorizontalScrollView hsRoot = findViewById(R.id.viewlogHorizontalScrollView1);
+                        hsRoot.smoothScrollTo(0, 0);
+                        mListViewTags.resetScrollToStart();
+                    }
+//                    mListViewTags.postDelayed(new Runnable() {
+//                            @Override
+//                            public void run() {
+//                                mListViewTags.scrollToItem(5);
+//                            }
+//                        }, 100);
+                }
+                // 其他方法留空或按需实现
+            });
+
+
+        (findViewById(cc.winboll.studio.libappbase.R.id.viewlogButtonClean)).setOnClickListener(new View.OnClickListener(){
+
+                @Override
+                public void onClick(View v) {
+                    LogUtils.cleanLog();
+                    LogUtils.d(TAG, "Log is cleaned.");
+                }
+            });
+        (findViewById(cc.winboll.studio.libappbase.R.id.viewlogButtonCopy)).setOnClickListener(new View.OnClickListener(){
+
+                @Override
+                public void onClick(View v) {
+
+                    ClipboardManager cm = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(mContext.getPackageName(), LogUtils.loadLog()));
+                    LogUtils.d(TAG, "Log is copied.");
+                }
+            });
+        mSelectableCheckBox = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBoxSelectable);
+        mSelectableCheckBox.setOnClickListener(new View.OnClickListener(){
+                @Override
+                public void onClick(View v) {
+                    if (mSelectableCheckBox.isChecked()) {
+                        setDescendantFocusability(ViewGroup.FOCUS_BEFORE_DESCENDANTS);
+                    } else {
+                        setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
+                    }
+                }
+            });
+
+        // 设置日志级别列表
+//        ArrayList<String> adapterItems = new ArrayList<>();
+//        for (LogUtils.LOG_LEVEL e : LogUtils.LOG_LEVEL.values()) {
+//            adapterItems.add(e.name());
+//        }
+		String[] mLogLevelSpinnerData = new String[LogUtils.LOG_LEVEL.values().length];
+		for (int i = 0; i < LogUtils.LOG_LEVEL.values().length; i++) {
+			mLogLevelSpinnerData[i] = LogUtils.LOG_LEVEL.values()[i].name();
+		}
+		mLogLevelSpinner.setLogTagData(mLogLevelSpinnerData);
+        // 假设你有一个字符串数组作为选项列表
+        //String[] options = {"Option 1", "Option 2", "Option 3"};
+        // 创建一个ArrayAdapter来绑定数据到spinner
+//        mLogLevelSpinnerAdapter = ArrayAdapter.createFromResource(
+//            context, cc.winboll.studio.libappbase.R.array.enum_loglevel_array, android.R.layout.simple_spinner_item);
+//        mLogLevelSpinnerAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
+
+//        // 设置适配器并将它应用到spinner上
+//        mLogLevelSpinnerAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item); // 设置下拉视图样式
+//        mLogLevelSpinner.setAdapter(mLogLevelSpinnerAdapter);
+        // 为Spinner添加监听器
+        mLogLevelSpinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
+                @Override
+                public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
+                    //String selectedOption = mLogLevelSpinnerAdapter.getItem(position);
+                    // 处理选中的选项...
+                    LogUtils.setLogLevel(LogUtils.LOG_LEVEL.values()[position]);
+                }
+                @Override
+                public void onNothingSelected(AdapterView<?> parent) {
+                    // 如果没有选择，则执行此操作...
+                }
+            });
+        // 获取默认值的索引
+        int defaultValueIndex = LogUtils.getLogLevel().ordinal();
+
+        if (defaultValueIndex != -1) {
+            // 如果找到了默认值，设置默认选项
+            mLogLevelSpinner.setSelection(defaultValueIndex);
+        }
+
+        // 加载标签列表
+        Map<String, Boolean> mapTAGList = LogUtils.getMapTAGList();
+        boolean isAllSelect = true;
+        for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+            if (entry.getValue() == false) {
+                isAllSelect = false;
+                break;
+            }
+        }
+        CheckBox cbALLTAG = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBox1);
+        cbALLTAG.setChecked(isAllSelect);
+
+        // 加载标签表
+        mListViewTags = findViewById(cc.winboll.studio.libappbase.R.id.tags_listview);
+        mListViewTags.setVerticalOffset(10);
+        mTAGListAdapter = new TAGListAdapter(mContext, mapTAGList);
+        mListViewTags.setAdapter(mTAGListAdapter);
+
+        // 可以添加点击监听器来处理勾选框状态变化后的逻辑，比如获取当前勾选情况等
+        mTAGListAdapter.notifyDataSetChanged();
+
+        mSelectAllTAGCheckBox = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBox1);
+		ViewGroup.LayoutParams layoutParams2 = mSelectAllTAGCheckBox.getLayoutParams();
+		if (layoutParams2 != null) {
+			layoutParams2.width = ViewGroup.LayoutParams.WRAP_CONTENT;
+			layoutParams2.height = 75;
+		}
+		mSelectAllTAGCheckBox.setLayoutParams(layoutParams2);
+		//mSelectAllTAGCheckBox.setPadding(0,0,0,0);
+		mSelectAllTAGCheckBox.setTextColor(mContext.getResources().getColor(R.color.white));
+        mSelectAllTAGCheckBox.setOnClickListener(new View.OnClickListener(){
+                @Override
+                public void onClick(View v) {
+                    LogUtils.setALlTAGListEnable(mSelectAllTAGCheckBox.isChecked());
+                    //LogUtils.setALlTAGListEnable(false);
+                    //mTAGListAdapter.notifyDataSetChanged();
+                    mTAGListAdapter.reload();
+                    //ToastUtils.show(String.format("onClick\nmSelectAllTAGCheckBox.isChecked() : %s", mSelectAllTAGCheckBox.isChecked()));
+                }
+            });
+
+
+		mLogLevelSpinner.updateTextSize(R.dimen.log_spinner_text_size);
+
+        // 设置滚动时不聚焦日志
+        setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
+    }
+
+    public void updateLogView() {
+        if (mLogViewHandler.isHandling() == true) {
+            // 正在处理日志显示，
+            // 就先设置一个新日志标志位
+            // 以便日志显示完后，再次显示新日志内容
+            mLogViewHandler.setIsAddNewLog(true);
+        } else {
+            //LogUtils.d(TAG, "LogListener showLog(String path)");
+            Message message = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOGVIEW_UPDATE);
+            mLogViewHandler.sendMessage(message);
+            mLogViewHandler.setIsAddNewLog(false);
+        }
+    }
+
+    void showAndScrollLogView() {
+        mTextView.setText(LogUtils.loadLog());
+        scrollLogUp();
+    }
+
+    public void scrollToTag(final String prefix) {
+        if (mTAGListAdapter == null || prefix == null || prefix.length() == 0) {
+            LogUtils.d(TAG, "参数为空，无法滚动");
+            return;
+        }
+
+        final List<TAGItemModel> itemList = mTAGListAdapter.getItemList();
+
+        mListViewTags.post(new Runnable() {
+                @Override
+                public void run() {
+                    // 查找匹配的标签位置
+                    int targetPosition = -1;
+
+                    for (int i = 0; i < itemList.size(); i++) {
+                        String tag = itemList.get(i).getTag();
+                        if (tag != null && tag.toLowerCase().startsWith(prefix.toLowerCase())) {
+                            targetPosition = i;
+
+                            break;
+                        }
+                    }
+
+                    if (targetPosition != -1) {
+                        // 优化滚动逻辑
+                        //mListViewTags.setSelection(targetPosition);
+                        //mListViewTags.invalidateViews(); // 强制刷新所有可见项
+
+                        // 单独刷新目标视图
+//                        View targetView = mListViewTags.getChildAt(targetPosition);
+//                        if (targetView != null) {
+//                            targetView.requestLayout();
+//                            targetView.requestFocus();
+//                        }
+
+                        final int scrollPosition = targetPosition;
+
+                        // 延迟滚动确保布局完成
+                        mListViewTags.postDelayed(new Runnable() {
+                                @Override
+                                public void run() {
+                                    LogUtils.d(TAG, String.format("scrollPosition %d", scrollPosition));
+                                    mListViewTags.scrollToItem(scrollPosition);
+                                }
+                            }, 100);
+                    } else {
+                        LogUtils.d(TAG, "未找到匹配的标签前缀：" + prefix);
+                    }
+                }
+            });
+    }
+
+
+
+    class LogViewHandler extends Handler {
+
+        final static int MSG_LOGVIEW_UPDATE = 0;
+        volatile boolean isHandling;
+        volatile boolean isAddNewLog;
+
+        public LogViewHandler() {
+            setIsHandling(false);
+            setIsAddNewLog(false);
+        }
+
+        public void setIsHandling(boolean isHandling) {
+            this.isHandling = isHandling;
+        }
+
+        public boolean isHandling() {
+            return isHandling;
+        }
+
+        public void setIsAddNewLog(boolean isAddNewLog) {
+            this.isAddNewLog = isAddNewLog;
+        }
+
+        public boolean isAddNewLog() {
+            return isAddNewLog;
+        }
+
+        public void handleMessage(Message msg) {
+            switch (msg.what) {
+                case MSG_LOGVIEW_UPDATE:{
+                        if (isHandling() == false) {
+                            setIsHandling(true);
+                            showAndScrollLogView();
+                        }
+                        break;
+                    }
+                default:
+                    break;
+            }
+            super.handleMessage(msg);
+        }
+    }
+
+    public class TAGItemModel {
+        private String tag;
+        private boolean isChecked;
+
+        public TAGItemModel(String tag, boolean isChecked) {
+            this.tag = tag;
+            this.isChecked = isChecked;
+        }
+
+        public String getTag() {
+            return tag;
+        }
+
+        public void setTag(String tag) {
+            this.tag = tag;
+        }
+
+        public boolean isChecked() {
+            return isChecked;
+        }
+
+        public void setChecked(boolean checked) {
+            isChecked = checked;
+        }
+
+        // getter/setter...
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) {
+                return true;
+            }
+            if (o == null || getClass() != o.getClass()) {
+                return false;
+            }
+            TAGItemModel that = (TAGItemModel) o;
+            // 手动处理空值比较（Java 6 不支持 Objects.equals）
+            if (tag == null) {
+                return that.tag == null;
+            } else {
+                return tag.equals(that.tag);
+            }
+        }
+
+        @Override
+        public int hashCode() {
+            return tag == null ? 0 : tag.hashCode(); // 手动处理空值
+        }
+    }
+
+
+    public class TAGListAdapter extends BaseAdapter {
+
+        private Context context;
+        private Map<String, Boolean> mapOrigin;
+        private List<TAGItemModel> itemList;
+
+        public TAGListAdapter(Context context, Map<String, Boolean> map) {
+            this.context = context;
+            mapOrigin = map;
+            loadMap(mapOrigin);
+        }
+
+        public List<TAGItemModel> getItemList() {
+            return itemList;
+        }
+
+        @Override
+        public int getCount() {
+            return itemList.size();
+        }
+
+        @Override
+        public Object getItem(int p) {
+            return itemList.get(p);
+        }
+
+        @Override
+        public long getItemId(int p) {
+            return p;
+        }
+
+        void loadMap(Map<String, Boolean> map) {
+            itemList = new ArrayList<TAGItemModel>();
+            for (Map.Entry<String, Boolean> entry : map.entrySet()) {
+                itemList.add(new TAGItemModel(entry.getKey(), entry.getValue()));
+            }
+            // 添加排序功能，按照tag进行升序排序
+            Collections.sort(itemList, new SortMapEntryByKeyString(true));
+            //Collections.sort(itemList, new SortMapEntryByKeyString(false));
+        }
+
+        public void reload() {
+            loadMap(mapOrigin);
+            super.notifyDataSetChanged();
+        }
+
+        @Override
+        public View getView(int position, View convertView, ViewGroup parent) {
+            ViewHolder holder;
+            if (convertView == null) {
+                convertView = LayoutInflater.from(context).inflate(R.layout.item_logtag, parent, false);
+                holder = new ViewHolder();
+                holder.tvText = convertView.findViewById(R.id.viewlogtagTextView1);
+                holder.cbChecked = convertView.findViewById(R.id.viewlogtagCheckBox1);
+                convertView.setTag(holder);
+            } else {
+                holder = (ViewHolder) convertView.getTag();
+            }
+
+            final TAGItemModel item = itemList.get(position);
+            holder.tvText.setText(item.getTag());
+			ViewGroup.LayoutParams layoutParams = holder.tvText.getLayoutParams();
+			if (layoutParams != null) {
+				layoutParams.width = ViewGroup.LayoutParams.WRAP_CONTENT;
+				layoutParams.height = 75;
+			}
+			holder.tvText.setLayoutParams(layoutParams);
+			holder.tvText.setPadding(0,0,0,0);
+			holder.tvText.setTextColor(mContext.getResources().getColor(R.color.white));
+            holder.cbChecked.setChecked(item.isChecked());
+			holder.cbChecked.setLayoutParams(layoutParams);
+			holder.cbChecked.setPadding(0,0,0,0);
+            holder.cbChecked.setOnClickListener(new View.OnClickListener(){
+
+                    @Override
+                    public void onClick(View v) {
+                        LogUtils.setTAGListEnable(item.getTag(), ((CheckBox)v).isChecked());
+                    }
+                });
+
+            return convertView;
+        }
+
+        public class ViewHolder {
+            TextView tvText;
+            CheckBox cbChecked;
+        }
+    }
+
+    class SortMapEntryByKeyString implements Comparator<TAGItemModel> {
+        private boolean mIsDesc = true;
+        // isDesc 是否降序排列
+        public SortMapEntryByKeyString(boolean isDesc) {
+            mIsDesc = isDesc;
+        }
+        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
+        @Override
+        public int compare(TAGItemModel o1, TAGItemModel o2) {
+            if (mIsDesc) {
+                return o1.getTag().compareTo(o2.getTag());
+            } else {
+                return o2.getTag().compareTo(o1.getTag());
+            }
+        }
+    }
+}

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

@@ -0,0 +1,140 @@
+package cc.winboll.studio.libappbase;
+
+import android.os.FileObserver;
+import java.lang.ref.WeakReference;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/08/12 14:43:50
+ * @Describe 日志视图线程类
+ * 独立线程监听日志文件目录变化（如写入、删除），触发日志视图更新，避免阻塞主线程
+ */
+public class LogViewThread extends Thread {
+
+    /** 日志标签（用于调试输出） */
+    public static final String TAG = "LogViewThread";
+
+    /** 线程退出标志（volatile 保证多线程可见性，控制循环退出） */
+    private volatile boolean isExit = false;
+    /** 日志文件目录监听实例（监听文件写入、删除事件） */
+    private LogListener mLogListener;
+    /** 日志视图弱引用（避免持有 LogView 强引用导致内存泄漏） */
+    private final WeakReference<LogView> mLogViewWeakRef;
+
+    /**
+     * 构造函数
+     * @param logView 日志显示视图实例（需通过弱引用持有，避免内存泄漏）
+     */
+    public LogViewThread(LogView logView) {
+        // 使用弱引用包装 LogView，当视图销毁时可被 GC 回收
+        mLogViewWeakRef = new WeakReference<>(logView);
+    }
+
+    /**
+     * 设置线程退出标志（触发线程停止监听并退出）
+     * @param exit true：退出线程；false：继续运行（默认）
+     */
+    public void setExit(boolean exit) {
+        this.isExit = exit;
+    }
+
+    /**
+     * 获取当前线程退出状态
+     * @return true：已标记退出；false：运行中
+     */
+    public boolean isExit() {
+        return isExit;
+    }
+
+    /**
+     * 线程核心逻辑：初始化文件监听并启动循环，直到收到退出标志
+     */
+    @Override
+    public void run() {
+        // 获取日志缓存目录路径（从 LogUtils 统一获取，确保路径一致性）
+        String logDirPath = LogUtils.getLogCacheDir().getPath();
+        LogUtils.d(TAG, "启动日志文件监听，监听目录：" + logDirPath);
+
+        // 初始化日志文件监听器（监听目标目录的文件事件）
+        mLogListener = new LogListener(logDirPath);
+        // 开始监听文件事件（非阻塞，内部通过 Native 层实现）
+        mLogListener.startWatching();
+
+        // 循环等待退出标志（每 1 秒检查一次，降低 CPU 占用）
+        while (!isExit()) {
+            try {
+                Thread.sleep(1000); // 休眠 1 秒，避免忙等
+            } catch (InterruptedException e) {
+                // 线程被中断时，恢复中断标志并退出循环（避免无限阻塞）
+                Thread.currentThread().interrupt();
+                LogUtils.d(TAG, "日志监听线程被中断，准备退出。" + e);
+                break;
+            }
+        }
+
+        // 收到退出标志，停止监听并释放资源
+        mLogListener.stopWatching();
+        LogUtils.d(TAG, "日志文件监听已停止，线程退出");
+    }
+
+    /**
+     * 日志文件监听内部类（继承 FileObserver，监听目录下文件变化）
+     * 仅关注文件写入完成（CLOSE_WRITE）和文件删除（DELETE）事件
+     */
+    private class LogListener extends FileObserver {
+
+        /**
+         * 构造函数
+         * @param path 监听的目录路径（此处为日志缓存目录）
+         */
+        public LogListener(String path) {
+            // 父类构造：监听指定目录的所有事件（通过位掩码 ALL_EVENTS 指定）
+            super(path);
+        }
+
+        /**
+         * 文件事件回调（运行在系统私有线程，非主线程）
+         * @param event 事件类型（通过位掩码表示，需与 ALL_EVENTS 按位与解析）
+         * @param path 发生事件的文件名（相对监听目录的路径）
+         */
+        @Override
+        public void onEvent(int event, String path) {
+            // 解析事件类型（排除无关事件，只处理目标事件）
+            int eventType = event & FileObserver.ALL_EVENTS;
+
+            switch (eventType) {
+					// 事件：文件写入完成（如日志写入结束并关闭文件）
+                case FileObserver.CLOSE_WRITE:
+                    // 触发日志视图更新（需先判断 LogView 是否未被回收）
+                    updateLogView();
+                    break;
+
+					// 事件：文件被删除（如日志清理操作）
+                case FileObserver.DELETE:
+                    LogUtils.d(TAG, "日志文件被删除，文件名：" + (path != null ? path : "未知"));
+                    // 触发日志视图更新（刷新视图显示空状态）
+                    updateLogView();
+                    break;
+
+                default:
+                    // 忽略其他无关事件（如文件创建、访问等）
+                    break;
+            }
+        }
+
+        /**
+         * 触发日志视图更新（通过弱引用获取 LogView，避免内存泄漏）
+         */
+        private void updateLogView() {
+            // 从弱引用中获取 LogView 实例（若视图已销毁，get() 返回 null）
+            LogView logView = mLogViewWeakRef.get();
+            if (logView != null) {
+                // 调用 LogView 的更新方法（需确保 updateLogView 内部处理主线程切换）
+                logView.updateLogView();
+            } else {
+                LogUtils.w(TAG, "LogView 已被回收，无法更新日志视图");
+            }
+        }
+    }
+}
+

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

@@ -0,0 +1,268 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
+import android.widget.Toast;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:51
+ * @Describe 吐司工具类（单例模式）
+ * 简化 Android 吐司的创建与展示，通过独立线程 + Handler 处理消息，最终切换到主线程显示吐司，避免内存泄漏
+ */
+public class ToastUtils {
+
+    /** 工具类日志 TAG（用于调试输出） */
+    public static final String TAG = "ToastUtils";
+    /** 消息标识：显示短时长吐司 */
+    private static final int MSG_SHOW_SHORT_TOAST = 1001;
+
+    /** 单例实例（volatile 保证多线程下可见性，避免指令重排） */
+    private static volatile ToastUtils sInstance;
+    /** 全局上下文（volatile 保证多线程可见性，避免空指针） */
+    private volatile Context mContext;
+    /** 独立线程的 Handler（volatile 保证可见性） */
+    private volatile Handler mWorkerHandler;
+    /** 主线程 Handler（volatile 保证可见性） */
+    private volatile Handler mMainHandler;
+    /** 消息处理独立线程 */
+    private Thread mWorkerThread;
+    /** 资源释放标记（volatile 避免多线程误操作） */
+    private volatile boolean isReleased = false;
+
+    /**
+     * 私有构造方法（禁止外部直接创建实例，确保单例）
+     * 1. 初始化主线程 Handler；
+     * 2. 创建并启动独立消息处理线程。
+     */
+    private ToastUtils() {
+        initMainHandler(); // 优先初始化主线程 Handler
+        startWorkerThread(); // 启动独立消息处理线程
+    }
+
+    /**
+     * 初始化主线程 Handler
+     */
+    private void initMainHandler() {
+        if (Looper.getMainLooper() == null) {
+            LogUtils.e(TAG, "主线程 Looper 为空，无法初始化 mMainHandler");
+            throw new IllegalStateException("主线程 Looper 未初始化，无法创建 ToastUtils");
+        }
+        mMainHandler = new Handler(Looper.getMainLooper());
+        LogUtils.d(TAG, "主线程 Handler 初始化完成，线程ID：" + Looper.getMainLooper().getThread().getId());
+    }
+
+    /**
+     * 启动独立消息处理线程
+     */
+    private void startWorkerThread() {
+        mWorkerThread = new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "消息处理线程启动，线程ID：" + Thread.currentThread().getId());
+					Looper.prepare();
+
+					mWorkerHandler = new Handler(Looper.myLooper()) {
+						@Override
+						public void handleMessage(Message msg) {
+							super.handleMessage(msg);
+							// 若已释放，直接返回，不处理消息
+							if (isReleased) {
+								LogUtils.w(TAG, "资源已释放，忽略消息处理");
+								return;
+							}
+							LogUtils.d(TAG, "WorkerHandler 接收消息，当前线程ID：" + Thread.currentThread().getId());
+							if (msg.what == MSG_SHOW_SHORT_TOAST && msg.obj != null) {
+								String message = (String) msg.obj;
+								postToMainThreadShowToast(message);
+							}
+						}
+					};
+
+					Looper.loop();
+					LogUtils.d(TAG, "消息处理线程退出");
+				}
+			}, "ToastWorkerThread");
+        mWorkerThread.start();
+    }
+
+    /**
+     * 获取单例实例（双重检查锁定）
+     * @return ToastUtils 单例对象
+     */
+    private static ToastUtils getInstance() {
+        if (sInstance == null) {
+            synchronized (ToastUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new ToastUtils();
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    /**
+     * 初始化工具类（必须在 Application 启动时调用）
+     * @param context 全局上下文（推荐 Application 上下文）
+     */
+    public static void init(Context context) {
+        if (context == null) {
+            throw new IllegalArgumentException("初始化上下文不能为 null！");
+        }
+        ToastUtils instance = getInstance();
+        // 若已释放，重置释放标记
+        if (instance.isReleased) {
+            instance.isReleased = false;
+            instance.startWorkerThread(); // 重新启动线程
+        }
+        instance.mContext = context.getApplicationContext();
+        LogUtils.d(TAG, "ToastUtils 初始化完成，上下文已设置");
+    }
+
+    // ===================================== 新增：isInited() 方法 =====================================
+    /**
+     * 判断 ToastUtils 是否已初始化（供外部调用，如 CrashHandleNotifyUtils 中的复制提示）
+     * @return true：已初始化（可正常显示吐司）；false：未初始化/已释放（无法正常显示）
+     */
+    public static boolean isInited() {
+        ToastUtils instance = getInstance();
+        // 双重校验：1. 未释放 2. 上下文已设置（确保初始化完成）
+        return !instance.isReleased && instance.mContext != null;
+    }
+    // ===================================== 新增结束 =====================================
+
+    /**
+     * 外部接口：显示短时长吐司
+     * @param message 吐司内容
+     */
+    public static void show(String message) {
+        LogUtils.d(TAG, "外部调用 show()，当前线程ID：" + Thread.currentThread().getId());
+        if (message == null || message.isEmpty()) {
+            return;
+        }
+
+        ToastUtils instance = getInstance();
+        // 校验资源是否已释放
+        if (instance.isReleased) {
+            LogUtils.w(TAG, "ToastUtils 已释放，无法显示吐司：" + message);
+            return;
+        }
+        // 校验上下文是否初始化
+        if (instance.mContext == null) {
+            LogUtils.e(TAG, "ToastUtils 未初始化！请先调用 init(Context) 方法");
+            // 不抛出异常，避免崩溃，改为日志提示
+            return;
+        }
+
+        instance.sendToastMessage(message);
+    }
+
+    /**
+     * 发送吐司消息到 WorkerHandler
+     * @param message 吐司内容
+     */
+    private void sendToastMessage(String message) {
+        LogUtils.d(TAG, "发送消息到 WorkerHandler");
+        // 校验 WorkerHandler 是否就绪
+        if (mWorkerHandler == null) {
+            LogUtils.w(TAG, "WorkerHandler 未就绪，直接主线程显示");
+            postToMainThreadShowToast(message);
+            return;
+        }
+        // 发送消息
+        Message msg = mWorkerHandler.obtainMessage(MSG_SHOW_SHORT_TOAST);
+        msg.obj = message;
+        mWorkerHandler.sendMessage(msg);
+    }
+
+    /**
+     * 切换到主线程显示吐司
+     * @param message 吐司内容
+     */
+    private void postToMainThreadShowToast(final String message) {
+        LogUtils.d(TAG, "切换到主线程显示吐司，当前线程ID：" + Thread.currentThread().getId());
+        // 校验资源是否已释放
+        if (isReleased) {
+            LogUtils.w(TAG, "资源已释放，取消显示吐司");
+            return;
+        }
+        // 校验并初始化 mMainHandler
+        if (mMainHandler == null) {
+            LogUtils.e(TAG, "mMainHandler 为空，尝试重新初始化");
+            initMainHandler();
+            if (mMainHandler == null) {
+                LogUtils.e(TAG, "mMainHandler 初始化失败，无法显示吐司：" + message);
+                return;
+            }
+        }
+        // 主线程显示
+        mMainHandler.post(new Runnable() {
+				@Override
+				public void run() {
+					if (isReleased) return; // 释放后取消执行
+					showToastInternal(message);
+				}
+			});
+    }
+
+    /**
+     * 实际显示吐司（主线程）
+     * @param message 吐司内容
+     */
+    private void showToastInternal(String message) {
+        LogUtils.d(TAG, "执行 showToastInternal()");
+        // 最终校验上下文
+        if (mContext == null) {
+            LogUtils.w(TAG, "上下文为空，无法显示吐司：" + message);
+            // 尝试重新获取 Application 上下文（降级策略）
+            Context appContext = GlobalApplication.getInstance();
+            if (appContext != null) {
+                mContext = appContext;
+                Toast.makeText(mContext, message, Toast.LENGTH_SHORT).show();
+                LogUtils.d(TAG, "通过 GlobalApplication 获取上下文，成功显示吐司");
+            }
+            return;
+        }
+        Toast.makeText(mContext, message, Toast.LENGTH_SHORT).show();
+    }
+
+    /**
+     * 释放资源（仅在应用退出时调用）
+     */
+    public static void release() {
+        LogUtils.d(TAG, "开始释放 ToastUtils 资源");
+        ToastUtils instance = getInstance();
+        // 标记为已释放，阻止后续消息处理
+        instance.isReleased = true;
+
+        // 停止 Worker 线程
+        if (instance.mWorkerHandler != null && instance.mWorkerHandler.getLooper() != null) {
+            instance.mWorkerHandler.getLooper().quit();
+            instance.mWorkerHandler = null;
+        }
+
+        // 清理主线程 Handler
+        if (instance.mMainHandler != null) {
+            instance.mMainHandler.removeCallbacksAndMessages(null);
+            instance.mMainHandler = null;
+        }
+
+        // 等待线程退出
+        if (instance.mWorkerThread != null && instance.mWorkerThread.isAlive()) {
+            try {
+                instance.mWorkerThread.join(1000);
+            } catch (InterruptedException e) {
+				LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                Thread.currentThread().interrupt();
+            }
+            instance.mWorkerThread = null;
+        }
+
+        // 清空上下文（避免内存泄漏）
+        instance.mContext = null;
+        LogUtils.d(TAG, "ToastUtils 资源释放完成");
+    }
+}
+

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

@@ -0,0 +1,86 @@
+package cc.winboll.studio.libappbase;
+
+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.nio.charset.StandardCharsets;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:45
+ * @Describe UTF-8 编码文件操作工具类
+ * 提供字符串与文件的相互转换，强制使用 UTF-8 编码，确保跨平台字符兼容性
+ */
+public class UTF8FileUtils {
+
+    /** 工具类日志 TAG（用于调试输出） */
+    public static final String TAG = "UTF8FileUtils";
+
+    /**
+     * 将字符串写入文件（强制 UTF-8 编码）
+     * 若文件父目录不存在，自动创建；覆盖原有文件内容
+     * @param filePath 文件路径（包含文件名，如 "/sdcard/test.txt"）
+     * @param content 要写入的字符串内容
+     * @throws IOException 写入失败时抛出（如权限不足、路径无效等）
+     */
+    public static void writeStringToFile(String filePath, String content) throws IOException {
+        // 根据路径创建文件对象
+        File file = new File(filePath);
+        // 获取父目录，若不存在则递归创建
+        File parentDir = file.getParentFile();
+        if (parentDir != null && !parentDir.exists()) {
+            parentDir.mkdirs();
+        }
+
+        // 初始化文件输出流（覆盖模式）
+        FileOutputStream outputStream = new FileOutputStream(file);
+        // 包装为 UTF-8 编码的字符输出流
+        OutputStreamWriter writer = new OutputStreamWriter(outputStream, StandardCharsets.UTF_8);
+
+        try {
+            // 写入字符串内容
+            writer.write(content);
+        } finally {
+            // 强制关闭流，避免资源泄漏（即使写入失败也确保流关闭）
+            writer.close();
+        }
+    }
+
+    /**
+     * 从文件读取字符串（强制 UTF-8 编码）
+     * 逐字符读取文件内容，拼接为完整字符串返回
+     * @param filePath 文件路径（包含文件名，如 "/sdcard/test.txt"）
+     * @return 文件内容字符串（空文件返回空字符串）
+     * @throws IOException 读取失败时抛出（如文件不存在、权限不足等）
+     */
+    public static String readStringFromFile(String filePath) throws IOException {
+        // 根据路径创建文件对象
+        File file = new File(filePath);
+        // 初始化文件输入流
+        FileInputStream inputStream = new FileInputStream(file);
+        // 包装为 UTF-8 编码的字符输入流
+        InputStreamReader reader = new InputStreamReader(inputStream, StandardCharsets.UTF_8);
+
+        // 字符串构建器，用于拼接读取的字符
+        StringBuilder content = new StringBuilder();
+        int charCode; // 存储单个字符的 ASCII 码
+
+        try {
+            // 逐字符读取（-1 表示读取到文件末尾）
+            while ((charCode = reader.read()) != -1) {
+                // 将 ASCII 码转换为字符，追加到字符串
+                content.append((char) charCode);
+            }
+        } finally {
+            // 强制关闭流，避免资源泄漏
+            reader.close();
+        }
+
+        // 返回读取的完整字符串
+        return content.toString();
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/activities/FTPBackupsActivity.java

@@ -0,0 +1,262 @@
+package cc.winboll.studio.libappbase.activities;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.view.View;
+
+import java.io.Serializable;
+import java.util.HashMap;
+import java.util.Map;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.models.SFTPAuthModel;
+import cc.winboll.studio.libappbase.utils.BackupUtils;
+import cc.winboll.studio.libappbase.utils.FTPUtils;
+import cc.winboll.studio.libappbase.dialogs.SFTPBackupsSettingsDialog;
+
+/**
+ * BackupUtils 调用实例
+ * 支持Intent传入双Map参数+FTP上传目标目录，初始化BackupUtils的待备份文件列表和上传路径
+ * 强制校验FTP上传目录参数，未传参时直接提示不执行备份
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/30 20:55
+ * @LastEditTime 2026/02/01 11:00
+ */
+public class FTPBackupsActivity extends Activity {
+
+    public static final String TAG = "FTPBackupsActivity";
+    // 主线程Handler：子线程更新UI专用
+    private Handler mMainHandler;
+    // FTP服务器上传目标目录-默认值（移除，改为强制传参，无默认值）
+    private static final String DEFAULT_FTP_TARGET_DIR = null;
+
+    // ==================== Intent传参常量（规范外部调用）====================
+    /**
+     * Intent传入参数-Data目录待备份文件Map
+     * 类型：HashMap<String,String> 实现Serializable接口
+     */
+    public static final String EXTRA_DATA_DIR_FILE_MAP = "extra_data_dir_file_map";
+    /**
+     * Intent传入参数-SDCard目录待备份文件Map
+     * 类型：HashMap<String,String> 实现Serializable接口
+     */
+    public static final String EXTRA_SDCARD_DIR_FILE_MAP = "extra_sdcard_dir_file_map";
+    /**
+     * Intent传入参数-FTP/SFTP服务器上传目标目录【强制传参】
+     * 类型：String 示例：/backup/app/ ，必须传参否则不执行备份
+     */
+    public static final String EXTRA_FTP_TARGET_DIR = "extra_ftp_target_dir";
+
+    // 解析后的参数（用于初始化BackupUtils）
+    private Map<String, String> mDataDirFileMap;
+    private Map<String, String> mSdcardDirFileMap;
+    private String mFtpTargetDir; // 解析后的FTP上传目标目录（强制非空）
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_ftp_backups);
+        // 初始化主线程Handler，避免子线程更新UI崩溃
+        mMainHandler = new Handler(Looper.getMainLooper());
+        // 解析Intent中的所有参数（双Map+FTP上传目录）
+        parseIntentParams();
+    }
+
+    /**
+     * 解析Intent传入的所有序列化参数
+     * 兜底处理：双Map解析失败初始化空Map，FTP目录**未传/空则直接赋值null，不兜底默认值**
+     */
+    private void parseIntentParams() {
+        Intent intent = getIntent();
+        if (intent == null) {
+            LogUtils.w(TAG, "parseIntentParams：Intent为null，参数解析失败");
+            initEmptyParams();
+            return;
+        }
+
+        // 1. 解析Data目录Map：强转为HashMap，失败则初始化空Map
+        Serializable dataMapSer = intent.getSerializableExtra(EXTRA_DATA_DIR_FILE_MAP);
+        if (dataMapSer instanceof HashMap) {
+            mDataDirFileMap = (HashMap<String, String>) dataMapSer;
+            LogUtils.d(TAG, "Intent解析Data目录Map成功，共" + mDataDirFileMap.size() + "个文件");
+        } else {
+            mDataDirFileMap = new HashMap<>();
+            LogUtils.d(TAG, "Intent未解析到有效Data目录Map，初始化空Map");
+        }
+
+        // 2. 解析SDCard目录Map：强转为HashMap，失败则初始化空Map
+        Serializable sdcardMapSer = intent.getSerializableExtra(EXTRA_SDCARD_DIR_FILE_MAP);
+        if (sdcardMapSer instanceof HashMap) {
+            mSdcardDirFileMap = (HashMap<String, String>) sdcardMapSer;
+            LogUtils.d(TAG, "Intent解析SDCard目录Map成功，共" + mSdcardDirFileMap.size() + "个文件");
+        } else {
+            mSdcardDirFileMap = new HashMap<>();
+            LogUtils.d(TAG, "Intent未解析到有效SDCard目录Map，初始化空Map");
+        }
+
+        // 3. 解析FTP上传目标目录：**强制校验，未传/空/空格则直接赋值null，不兜底**
+        String inputFtpDir = intent.getStringExtra(EXTRA_FTP_TARGET_DIR);
+        if (inputFtpDir != null && !inputFtpDir.trim().isEmpty()) {
+            mFtpTargetDir = inputFtpDir.trim().endsWith("/") ? inputFtpDir.trim() : inputFtpDir.trim() + "/";
+            LogUtils.d(TAG, "Intent解析FTP上传目录成功：" + mFtpTargetDir);
+        } else {
+            mFtpTargetDir = null;
+            LogUtils.w(TAG, "Intent未传递/传递空的FTP上传目录参数，禁止执行备份");
+        }
+    }
+
+    /**
+     * 初始化空参数：Intent为null时使用，FTP目录直接赋值null
+     */
+    private void initEmptyParams() {
+        mDataDirFileMap = new HashMap<>();
+        mSdcardDirFileMap = new HashMap<>();
+        mFtpTargetDir = null;
+    }
+
+    public void onSFTPSettings(View view) {
+        SFTPBackupsSettingsDialog dlg = new SFTPBackupsSettingsDialog(this);
+        dlg.show();
+    }
+
+    /**
+     * 点击事件：执行FTP备份（核心调用方法）
+     * 【强制校验】未传递FTP_TARGET_DIR参数时，仅吐司提示，不执行任何操作
+     * 每次点击都重新解析Intent参数，保证参数最新
+     */
+    public void onBackups(View view) {
+        // 1. 重新解析参数，保证最新
+        parseIntentParams();
+        // 2. 强制核心校验：FTP上传目录未传参，直接吐司提示，不执行后续操作
+        if (mFtpTargetDir == null) {
+            ToastUtils.show("备份失败：未设置FTP上传目标目录参数");
+            LogUtils.e(TAG, "触发备份操作失败：Intent未传递EXTRA_FTP_TARGET_DIR参数");
+            return;
+        }
+        // 3. 校验SFTP配置，未配置则弹框
+        SFTPAuthModel authModel = SFTPBackupsSettingsDialog.getSFTPAuthModelFromSP(this);
+        if (authModel == null) {
+            ToastUtils.show("备份失败：请先配置SFTP服务器信息");
+            new SFTPBackupsSettingsDialog(this).show();
+            LogUtils.w(TAG, "触发备份操作失败：未配置SFTP服务器信息");
+            return;
+        }
+        // 4. 所有校验通过，提示并执行备份
+        ToastUtils.show("开始执行FTP备份，请勿退出页面...");
+        LogUtils.d(TAG, "所有校验通过，开启子线程执行备份核心逻辑");
+        doBackups(authModel, mDataDirFileMap, mSdcardDirFileMap, mFtpTargetDir);
+    }
+
+    /**
+     * 核心备份逻辑：子线程执行（仅在校验通过后调用）
+     * @param authModel SFTP认证模型
+     * @param dataDirFileMap Intent解析的Data目录文件Map
+     * @param sdcardDirFileMap Intent解析的SDCard目录文件Map
+     * @param ftpTargetDir Intent解析的FTP上传目标目录（已标准化、非空）
+     */
+    void doBackups(final SFTPAuthModel authModel, final Map<String, String> dataDirFileMap,
+                   final Map<String, String> sdcardDirFileMap, final String ftpTargetDir) {
+        // 所有BackupUtils操作放入子线程，规避网络/IO主线程异常
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					try {
+						// 初始化BackupUtils单例，透传动态解析的FTP上传目录
+						BackupUtils backupUtils = BackupUtils.getInstance(
+                            getApplicationContext(),
+                            authModel,
+                            ftpTargetDir
+						);
+
+						// 向BackupUtils添加解析后的待备份文件（双Map）
+						addBackupFilesToUtils(backupUtils, dataDirFileMap, sdcardDirFileMap);
+
+						LogUtils.d(TAG, "待备份文件初始化完成 → Data目录：" + backupUtils.getAllDataDirFiles().size() + "个 | SDCard目录：" + backupUtils.getAllSdcardFiles().size() + "个 | 上传目录：" + ftpTargetDir);
+
+						// 核心执行：打包为ZIP + SFTP上传（内部已实现登录→打包→上传→登出）
+						boolean isSuccess = backupUtils.packAndUploadByFtp();
+
+						// 主线程反馈执行结果
+						if (isSuccess) {
+							updateUi("FTP备份成功！文件已打包为ZIP上传至服务器：" + ftpTargetDir);
+							LogUtils.i(TAG, "FTP备份全流程执行成功，上传目录：" + ftpTargetDir);
+						} else {
+							updateUi("FTP备份失败！请检查服务器配置或文件路径");
+							LogUtils.e(TAG, "FTP备份全流程执行失败，上传目录：" + ftpTargetDir);
+						}
+
+					} catch (IllegalArgumentException e) {
+						// 捕获初始化参数异常
+						LogUtils.e(TAG, "BackupUtils初始化失败：" + e.getMessage(), e);
+						updateUi("备份初始化失败：" + e.getMessage());
+					} catch (Exception e) {
+						// 捕获所有执行异常
+						LogUtils.e(TAG, "FTP备份执行异常：" + e.getMessage(), e);
+						updateUi("备份执行失败：" + e.getMessage());
+					} finally {
+						// 仅保留FTP断连，BackupUtils内部已兜底登出/断连，此处做双重保障
+						FTPUtils.getInstance().disconnect();
+						// 关键日志：明确仅删除临时ZIP包，不修改/删除源文件
+						LogUtils.d(TAG, "备份流程结束：仅删除本地临时ZIP打包文件，待备份源文件未做任何修改/删除");
+					}
+				}
+			}).start();
+    }
+
+    /**
+     * 向BackupUtils添加待备份文件：遍历双Map，调用add方法逐个添加
+     * 先清空原有文件，避免Activity复用导致文件重复
+     * @param backupUtils BackupUtils实例
+     * @param dataMap Data目录待备份文件Map
+     * @param sdcardMap SDCard目录待备份文件Map
+     */
+    private void addBackupFilesToUtils(BackupUtils backupUtils, Map<String, String> dataMap, Map<String, String> sdcardMap) {
+        backupUtils.clearDataDirFiles();
+        backupUtils.clearSdcardFiles();
+        // 添加Data目录文件
+        for (Map.Entry<String, String> entry : dataMap.entrySet()) {
+            backupUtils.addDataDirFile(entry.getKey(), entry.getValue());
+        }
+        // 添加SDCard目录文件
+        for (Map.Entry<String, String> entry : sdcardMap.entrySet()) {
+            backupUtils.addSdcardFile(entry.getKey(), entry.getValue());
+        }
+    }
+
+    /**
+     * 子线程更新UI工具方法（Toast提示）
+     * @param msg 提示信息
+     */
+    private void updateUi(final String msg) {
+        mMainHandler.post(new Runnable() {
+				@Override
+				public void run() {
+					ToastUtils.show(msg);
+				}
+			});
+    }
+
+    /**
+     * 页面销毁：释放资源，避免内存泄漏
+     * 仅释放本地资源，不清空Map/重复断连FTP
+     */
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // 移除Handler未执行的任务
+        if (mMainHandler != null) {
+            mMainHandler.removeCallbacksAndMessages(null);
+        }
+        // 清空本地引用，协助GC
+        mDataDirFileMap = null;
+        mSdcardDirFileMap = null;
+        mFtpTargetDir = null;
+        LogUtils.d(TAG, "FTPBackupsActivity销毁：已释放本地资源，不影响二次备份初始化");
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/activities/NfcRsaLoginActivity.java

@@ -0,0 +1,328 @@
+package cc.winboll.studio.libappbase.activities;
+
+import android.app.Activity;
+import android.app.PendingIntent;
+import android.content.Intent;
+import android.nfc.NfcAdapter;
+import android.nfc.Tag;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Button;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.utils.NfcRsaAuthTool;
+
+/**
+ * @Describe NFC RSA登录认证窗口
+ * 核心逻辑：贴近NFC→有密钥显示保存按钮（存应用data区+内存缓存）→无密钥启用初始化按钮（生成私钥写NFC）
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 20:34:00
+ * @LastEditTime 2026/01/12 16:28:00
+ */
+public class NfcRsaLoginActivity extends Activity implements View.OnClickListener {
+    // 常量定义
+    private static final String TAG = "NfcRsaLoginActivity";
+
+    // NFC核心相关属性
+    private NfcAdapter mNfcAdapter;
+    private PendingIntent mNfcPendingIntent;
+
+    // 视图控件相关属性
+    private TextView mTvNfcState;
+    private TextView mTvPrivateKey;
+    private TextView mTvPublicKey;
+    private Button mBtnOptKey; // 复用按钮：有密钥=保存本地，无密钥=初始化密钥
+
+    // 业务相关属性
+    private NfcRsaAuthTool mNfcRsaAuthTool;
+    private boolean isPreparingInit = false;  // 标记是否准备初始化密钥（替代原写入标记）
+    private String mTempPrivateKey;          // 临时存储NFC读取的有效私钥，用于后续保存
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_nfc_rsa_operate);
+        initView();
+        initNfcTool();
+        initNfcConfig();
+        LogUtils.d(TAG, "onCreate: NFC RSA登录窗口初始化完成");
+    }
+
+    /**
+     * 初始化视图控件，绑定点击事件，默认状态配置
+     */
+    private void initView() {
+        mTvNfcState = findViewById(R.id.tv_nfc_state);
+        mTvPrivateKey = findViewById(R.id.tv_private_key);
+        mTvPublicKey = findViewById(R.id.tv_public_key);
+        mBtnOptKey = findViewById(R.id.btn_create_write_key);
+
+        mBtnOptKey.setOnClickListener(this);
+        mBtnOptKey.setEnabled(false);
+        mTvNfcState.setText("正在监听NFC卡片，请贴近设备检测密钥...");
+        mTvPrivateKey.setText("私钥内容：无");
+        mTvPublicKey.setText("公钥内容：无");
+        LogUtils.d(TAG, "initView: 视图控件初始化完成，功能按钮默认禁用");
+    }
+
+    /**
+     * 初始化核心工具类NfcRsaAuthTool，校验NFC基础可用性
+     */
+    private void initNfcTool() {
+        mNfcRsaAuthTool = NfcRsaAuthTool.getInstance(this);
+        LogUtils.d(TAG, "initNfcTool: NfcRsaAuthTool单例获取完成");
+
+        if (!mNfcRsaAuthTool.isNfcAvailable()) {
+            mTvNfcState.setText("❌ 设备不支持NFC或未开启NFC");
+            mBtnOptKey.setEnabled(false);
+            Toast.makeText(this, "请先在设置中开启NFC功能", Toast.LENGTH_LONG).show();
+            LogUtils.w(TAG, "initNfcTool: NFC不可用，设备不支持或未开启");
+        } else {
+            LogUtils.d(TAG, "initNfcTool: NFC基础可用性校验通过");
+        }
+    }
+
+    /**
+     * 初始化NFC前台监听配置，页面打开即生效，适配API30
+     */
+    private void initNfcConfig() {
+        mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
+        mNfcPendingIntent = PendingIntent.getActivity(
+			this,
+			0,
+			new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP),
+			PendingIntent.FLAG_UPDATE_CURRENT
+        );
+        LogUtils.d(TAG, "initNfcConfig: NFC前台监听配置初始化完成，适配API30");
+    }
+
+    /**
+     * 核心分发方法：处理NFC相关意图，区分 密钥检测/密钥初始化 逻辑
+     * @param intent NFC触发的意图对象
+     */
+    private void handleNfcIntent(Intent intent) {
+        if (mNfcRsaAuthTool == null || !mNfcRsaAuthTool.isNfcAvailable()) {
+            LogUtils.w(TAG, "handleNfcIntent: NFC工具类为空或NFC不可用，跳过意图处理");
+            return;
+        }
+
+        String action = intent.getAction();
+        LogUtils.d(TAG, "handleNfcIntent: 收到NFC意图，action=" + action);
+        if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(action)
+			|| NfcAdapter.ACTION_TECH_DISCOVERED.equals(action)
+			|| NfcAdapter.ACTION_TAG_DISCOVERED.equals(action)) {
+            Tag tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
+            if (tag != null) {
+                LogUtils.d(TAG, "handleNfcIntent: 成功提取NFC Tag对象，当前初始化准备状态=" + isPreparingInit);
+                if (isPreparingInit) {
+                    createWriteAndValidateKey(tag); // 准备初始化：生成+写NFC
+                } else {
+                    readAndValidateKey(tag);        // 正常状态：检测NFC密钥
+                }
+            } else {
+                LogUtils.w(TAG, "handleNfcIntent: NFC意图中未提取到有效Tag对象");
+            }
+        }
+    }
+
+    /**
+     * 读取NFC中私钥，执行有效性校验，区分场景更新UI（有有效密钥显保存按钮，无则显初始化按钮）
+     * @param tag NFC卡片Tag对象
+     */
+    private void readAndValidateKey(final Tag tag) {
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "readAndValidateKey: 子线程读取NFC私钥，Tag=" + tag);
+					final String privateKeyStr = mNfcRsaAuthTool.readPrivateKeyFromNfc(tag);
+					runOnUiThread(new Runnable() {
+							@Override
+							public void run() {
+								if (privateKeyStr != null && !privateKeyStr.isEmpty()) {
+									// NFC读取到私钥，校验有效性
+									boolean priValid = mNfcRsaAuthTool.validatePrivateKey(privateKeyStr);
+									String publicKeyStr = mNfcRsaAuthTool.getCachePublicKeyStr();
+									boolean pubValid = mNfcRsaAuthTool.validatePublicKey(privateKeyStr, publicKeyStr);
+
+									LogUtils.d(TAG, "readAndValidateKey: 私钥读取完成，有效性=" + priValid + "，公钥提取有效性=" + pubValid);
+									if (priValid) {
+										mTempPrivateKey = privateKeyStr; // 缓存有效私钥，用于后续保存
+										mTvNfcState.setText("✅ NFC检测到有效密钥，点击按钮保存到本地");
+										mBtnOptKey.setText("保存密钥到应用本地并缓存");
+									} else {
+										mTvNfcState.setText("⚠️ NFC私钥无效，点击按钮重新初始化");
+										mBtnOptKey.setText("初始化RSA密钥写入NFC");
+										mTempPrivateKey = null;
+									}
+									mTvPrivateKey.setText("私钥内容：\n" + privateKeyStr);
+									mTvPublicKey.setText(publicKeyStr != null ? "公钥内容：\n" + publicKeyStr : "公钥内容：提取失败");
+									mBtnOptKey.setEnabled(true);
+									Toast.makeText(NfcRsaLoginActivity.this, priValid ? "检测到有效密钥" : "密钥无效，请初始化", Toast.LENGTH_SHORT).show();
+								} else {
+									// NFC无有效私钥，显示初始化按钮
+									LogUtils.w(TAG, "readAndValidateKey: NFC中未读取到有效私钥");
+									mTvNfcState.setText("❌ NFC无有效RSA私钥，点击按钮初始化");
+									mTvPrivateKey.setText("私钥内容：无");
+									mTvPublicKey.setText("公钥内容：无");
+									mBtnOptKey.setText("初始化RSA密钥写入NFC");
+									mBtnOptKey.setEnabled(true);
+									mTempPrivateKey = null;
+									Toast.makeText(NfcRsaLoginActivity.this, "未检测到有效私钥", Toast.LENGTH_SHORT).show();
+								}
+								isPreparingInit = false; // 重置初始化标记
+								LogUtils.d(TAG, "readAndValidateKey: 私钥检测流程结束，重置初始化准备状态");
+							}
+						});
+				}
+			}).start();
+    }
+
+    /**
+     * 生成RSA私钥、写入NFC、执行密钥有效性校验并更新UI（初始化密钥核心逻辑）
+     * @param tag NFC卡片Tag对象
+     */
+    private void createWriteAndValidateKey(final Tag tag) {
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "createWriteAndValidateKey: 开始创建私钥并写入NFC，Tag=" + tag);
+					// 1. 生成RSA私钥
+					final String privateKeyStr = mNfcRsaAuthTool.generateRsaPrivateKey();
+					if (privateKeyStr == null) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									mTvNfcState.setText("❌ 私钥生成失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "私钥生成失败，请重试", Toast.LENGTH_SHORT).show();
+									isPreparingInit = false;
+									mBtnOptKey.setEnabled(true);
+								}
+							});
+						LogUtils.e(TAG, "createWriteAndValidateKey: RSA私钥生成失败");
+						return;
+					}
+					LogUtils.d(TAG, "createWriteAndValidateKey: RSA私钥生成成功");
+
+					// 2. 写入NFC卡片
+					final boolean writeSuccess = mNfcRsaAuthTool.writePrivateKeyToNfc(tag, privateKeyStr);
+					if (!writeSuccess) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									mTvNfcState.setText("❌ 私钥写入NFC失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "私钥写入失败，请重试", Toast.LENGTH_SHORT).show();
+									isPreparingInit = false;
+									mBtnOptKey.setEnabled(true);
+								}
+							});
+						LogUtils.e(TAG, "createWriteAndValidateKey: 私钥写入NFC失败");
+						return;
+					}
+					LogUtils.d(TAG, "createWriteAndValidateKey: 私钥写入NFC成功");
+
+					// 3. 提取公钥并双重校验有效性
+					final String publicKeyStr = mNfcRsaAuthTool.extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+					final boolean priValid = mNfcRsaAuthTool.validatePrivateKey(privateKeyStr);
+					final boolean pubValid = mNfcRsaAuthTool.validatePublicKey(privateKeyStr, publicKeyStr);
+
+					runOnUiThread(new Runnable() {
+							@Override
+							public void run() {
+								LogUtils.d(TAG, "createWriteAndValidateKey: 密钥校验完成，私钥有效=" + priValid + "，公钥有效=" + pubValid);
+								if (priValid && pubValid) {
+									mTvNfcState.setText("✅ 密钥初始化成功，已写入NFC");
+									mTvPrivateKey.setText("私钥内容：\n" + privateKeyStr);
+									mTvPublicKey.setText(publicKeyStr != null ? "公钥内容：\n" + publicKeyStr : "公钥内容：提取失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "密钥创建写入成功，可贴近NFC保存本地", Toast.LENGTH_LONG).show();
+								} else {
+									mTvNfcState.setText("⚠️ 写入成功，但密钥校验失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "写入成功但密钥无效，请重新操作", Toast.LENGTH_LONG).show();
+								}
+								mBtnOptKey.setText("初始化RSA密钥写入NFC");
+								mBtnOptKey.setEnabled(true);
+								isPreparingInit = false;
+								mTempPrivateKey = null;
+							}
+						});
+				}
+			}).start();
+    }
+
+    /**
+     * 保存有效私钥到应用data区，同时缓存到工具类内存属性
+     */
+    private void saveKeyToLocalAndCache() {
+        LogUtils.d(TAG, "saveKeyToLocalAndCache: 开始执行密钥本地保存+内存缓存");
+        if (mTempPrivateKey == null || mTempPrivateKey.isEmpty()) {
+            Toast.makeText(this, "无有效密钥可保存", Toast.LENGTH_SHORT).show();
+            LogUtils.w(TAG, "saveKeyToLocalAndCache: 临时有效私钥为空，保存失败");
+            return;
+        }
+        boolean saveSuccess = mNfcRsaAuthTool.savePrivateKeyToLocal(mTempPrivateKey);
+        if (saveSuccess) {
+            mTvNfcState.setText("✅ 密钥已保存到应用本地，登录完成");
+            mTvPrivateKey.setText("私钥内容：\n" + mNfcRsaAuthTool.getCachePrivateKeyStr());
+            mTvPublicKey.setText("公钥内容：\n" + mNfcRsaAuthTool.getCachePublicKeyStr());
+            mBtnOptKey.setEnabled(false);
+            Toast.makeText(this, "密钥保存成功，已缓存到内存", Toast.LENGTH_LONG).show();
+            LogUtils.d(TAG, "saveKeyToLocalAndCache: 密钥本地存储+工具类内存缓存成功");
+        } else {
+            Toast.makeText(this, "密钥保存到本地失败", Toast.LENGTH_SHORT).show();
+            LogUtils.e(TAG, "saveKeyToLocalAndCache: 密钥本地保存失败");
+        }
+    }
+
+    @Override
+    public void onClick(View v) {
+        if (v.getId() == R.id.btn_create_write_key) {
+            LogUtils.d(TAG, "onClick: 点击功能按钮，当前按钮文本=" + mBtnOptKey.getText().toString());
+            if (!mNfcRsaAuthTool.isNfcAvailable()) {
+                Toast.makeText(this, "NFC不可用，无法执行操作", Toast.LENGTH_SHORT).show();
+                LogUtils.w(TAG, "onClick: NFC不可用，拒绝按钮操作");
+                return;
+            }
+
+            if (mBtnOptKey.getText().toString().contains("保存")) {
+                // 按钮为保存功能：直接保存本地+缓存
+                saveKeyToLocalAndCache();
+            } else {
+                // 按钮为初始化功能：进入准备状态，等待贴近NFC
+                isPreparingInit = true;
+                mTvNfcState.setText("请贴近NFC卡片，执行密钥写入...");
+                mBtnOptKey.setEnabled(false);
+                Toast.makeText(this, "请贴近NFC卡片完成密钥初始化", Toast.LENGTH_SHORT).show();
+                LogUtils.d(TAG, "onClick: 已进入密钥初始化准备状态，等待NFC贴近");
+            }
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        if (mNfcAdapter != null && mNfcRsaAuthTool.isNfcAvailable()) {
+            mNfcAdapter.enableForegroundDispatch(this, mNfcPendingIntent, null, null);
+            LogUtils.d(TAG, "onResume: NFC前台监听已启用");
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        if (mNfcAdapter != null) {
+            mNfcAdapter.disableForegroundDispatch(this);
+            LogUtils.d(TAG, "onPause: NFC前台监听已禁用");
+        }
+    }
+
+    @Override
+    protected void onNewIntent(Intent intent) {
+        super.onNewIntent(intent);
+        setIntent(intent);
+        LogUtils.d(TAG, "onNewIntent: 收到新NFC意图，分发处理");
+        handleNfcIntent(intent);
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/AppValidationDialog.java

@@ -0,0 +1,186 @@
+package cc.winboll.studio.libappbase.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.graphics.Color;
+import android.os.Bundle;
+import android.widget.EditText;
+import android.widget.TextView;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.utils.APPUtils;
+import cc.winboll.studio.libappbase.utils.ApkSignUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-20 21:20:00
+ * @LastEditTime 2026-01-24 18:45:00
+ * @Describe 签名显示+正版校验对话框：展示应用签名字节位信息，调用网络接口完成正版合法性校验，实时返回校验结果
+ */
+public class AppValidationDialog extends Dialog {
+    // ===================================== 全局常量 =====================================
+    public static final String TAG = "AppValidationDialog";
+    // 签名字节位分组大小
+    private static final int BIT_GROUP_SIZE = 16;
+
+    // ===================================== 控件与上下文属性 =====================================
+    private Context mContext;
+    private EditText etSignFingerprint;
+    private TextView tvAuthResult;
+
+    // ===================================== 业务入参属性 =====================================
+    private String projectName;
+    private String versionName;
+    private String clientSign;
+    private String clientHash;
+
+    // ===================================== 构造方法 =====================================
+    public AppValidationDialog(Context context, String projectName, String versionName) {
+        super(context, R.style.DialogStyle);
+        this.mContext = context;
+        this.projectName = projectName;
+        this.versionName = versionName;
+        LogUtils.d(TAG, "AppValidationDialog: 构造方法初始化，入参-> projectName=" + projectName + ", versionName=" + versionName);
+    }
+
+    // ===================================== 生命周期方法 =====================================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: 对话框创建，开始初始化布局与业务逻辑");
+        setContentView(R.layout.dialog_sign_get);
+        setCancelable(true);
+        // 初始化应用签名与哈希
+        initSignAndHash();
+        // 初始化页面控件
+        initView();
+        // 执行签名展示与正版校验
+        doSignShowAndAuthCheck();
+        LogUtils.d(TAG, "onCreate: 对话框初始化流程执行完成");
+    }
+
+    // ===================================== 页面与数据初始化方法 =====================================
+    /**
+     * 初始化页面控件，绑定视图并设置基础属性
+     */
+    private void initView() {
+        LogUtils.d(TAG, "initView: 开始初始化页面控件");
+        etSignFingerprint = findViewById(R.id.et_sign_fingerprint);
+        tvAuthResult = findViewById(R.id.tv_auth_result);
+        // 签名显示框设为只读，方便用户复制
+        etSignFingerprint.setEnabled(false);
+        // 填充签名字节位信息
+        etSignFingerprint.setText(convertSignToBitArrayWithWrap(clientSign));
+        LogUtils.d(TAG, "initView: 控件初始化完成，已填充签名字节位信息");
+    }
+
+    /**
+     * 初始化应用签名与SHA256哈希，调用工具类获取与服务端对齐的参数
+     */
+    private void initSignAndHash() {
+        LogUtils.d(TAG, "initSignAndHash: 开始获取应用签名与SHA256哈希");
+        this.clientSign = ApkSignUtils.getApkSignAlignedWithServer(mContext);
+        this.clientHash = ApkSignUtils.getApkSHA256Hash(mContext);
+        LogUtils.d(TAG, "initSignAndHash: 签名与哈希获取完成-> clientSign=" + clientSign + ", clientHash=" + clientHash);
+    }
+
+    // ===================================== 核心业务方法 =====================================
+    /**
+     * 核心业务：展示签名字节位信息，发起网络正版校验请求
+     */
+    private void doSignShowAndAuthCheck() {
+        LogUtils.d(TAG, "doSignShowAndAuthCheck: 开始执行应用正版合法性校验");
+        // 校验签名与哈希非空，避免空参请求
+        if (clientSign == null || clientHash == null) {
+            String errorMsg = "应用签名或哈希获取失败，无法执行正版校验";
+            LogUtils.e(TAG, "doSignShowAndAuthCheck: " + errorMsg);
+            tvAuthResult.setTextColor(Color.RED);
+            tvAuthResult.setText(errorMsg);
+            ToastUtils.show(errorMsg);
+            return;
+        }
+        // 调用网络校验接口
+        new APPUtils().checkAPKValidation(
+			mContext,
+			projectName,
+			versionName,
+			clientSign,
+			clientHash,
+			new APPUtils.CheckResultCallback() {
+				@Override
+				public void onResult(boolean isValid, String message) {
+					LogUtils.d(TAG, "checkAPKValidation: 校验结果返回-> isValid=" + isValid + ", message=" + message);
+					handleAuthResult(isValid, message);
+				}
+			}
+        );
+    }
+
+    /**
+     * 处理正版校验结果，更新UI并提示用户
+     * @param isValid 校验是否通过
+     * @param message 服务端返回提示信息
+     */
+    private void handleAuthResult(boolean isValid, String message) {
+        String showMessage;
+        if (isValid) {
+            showMessage = "< 这是正版的 WinBoLL 应用，请放心使用。 >";
+            tvAuthResult.setTextColor(Color.BLUE);
+            LogUtils.d(TAG, "handleAuthResult: 正版校验通过，" + showMessage + "，服务端信息：" + message);
+        } else {
+            showMessage = "< 您使用的可能不是正版的 WinBoLL 应用。 >";
+            tvAuthResult.setTextColor(Color.RED);
+            LogUtils.e(TAG, "handleAuthResult: 正版校验失败，" + showMessage + "，失败原因：" + message);
+        }
+        // 更新UI并弹提示
+        tvAuthResult.setText(showMessage);
+        ToastUtils.show(showMessage);
+    }
+
+    // ===================================== 工具方法 =====================================
+    /**
+     * 签名字符串转0/1比特数组格式：每2个bit加空格，每16位换行，提升可读性
+     * @param signStr 原始签名字符串
+     * @return 格式化后的比特数字符串，签名字符为空返回空串
+     */
+    private String convertSignToBitArrayWithWrap(String signStr) {
+        LogUtils.d(TAG, "convertSignToBitArrayWithWrap: 开始格式化签名字符串为比特数组");
+        if (signStr == null || signStr.isEmpty()) {
+            LogUtils.w(TAG, "convertSignToBitArrayWithWrap: 原始签名字符串为空，返回空串");
+            return "";
+        }
+        // 字符转8位补零的二进制字符串
+        StringBuilder bitBuilder = new StringBuilder();
+        for (char c : signStr.toCharArray()) {
+            String bit8 = String.format("%8s", Integer.toBinaryString(c)).replace(' ', '0');
+            bitBuilder.append(bit8);
+        }
+        String fullBitStr = bitBuilder.toString();
+        LogUtils.d(TAG, "convertSignToBitArrayWithWrap: 签名转二进制完成，总长度=" + fullBitStr.length() + "bit");
+
+        // 按16位分组，组内每2bit加空格，分组后换行
+        StringBuilder finalBuilder = new StringBuilder();
+        for (int i = 0; i < fullBitStr.length(); i += BIT_GROUP_SIZE) {
+            int end = Math.min(i + BIT_GROUP_SIZE, fullBitStr.length());
+            String group = fullBitStr.substring(i, end);
+            // 组内加空格
+            StringBuilder groupWithSpace = new StringBuilder();
+            for (int j = 0; j < group.length(); j++) {
+                groupWithSpace.append(group.charAt(j));
+                if ((j + 1) % 2 == 0 && j != group.length() - 1) {
+                    groupWithSpace.append(" ");
+                }
+            }
+            finalBuilder.append(groupWithSpace);
+            // 最后一组不换行
+            if (end < fullBitStr.length()) {
+                finalBuilder.append("\n");
+            }
+        }
+        LogUtils.d(TAG, "convertSignToBitArrayWithWrap: 签名比特数组格式化完成");
+        return finalBuilder.toString();
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/DebugHostDialog.java

@@ -0,0 +1,99 @@
+package cc.winboll.studio.libappbase.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.os.Bundle;
+import android.text.TextUtils;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/22 20:59
+ * @Describe WinBoLL服务器地址设置对话框（调试模式专用）
+ */
+public class DebugHostDialog extends Dialog implements View.OnClickListener {
+    public static final String TAG = "DebugHostDialog";
+
+    private Context mContext;
+    private EditText etHostInput;
+    private Button btnConfirm;
+    private Button btnCancel;
+
+    // 构造方法（适配默认样式）
+    public DebugHostDialog(Context context) {
+        super(context, R.style.DialogStyle);
+        this.mContext = context;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.dialog_winboll_host); // 绑定XML布局
+        setCancelable(true); // 点击外部可关闭
+        initView();
+        initData();
+        LogUtils.d(TAG, "DebugHostDialog 初始化完成");
+    }
+
+    // 初始化视图
+    private void initView() {
+        etHostInput = findViewById(R.id.et_host_input);
+        btnConfirm = findViewById(R.id.btn_confirm);
+        btnCancel = findViewById(R.id.btn_cancel);
+
+        // 绑定点击事件
+        btnConfirm.setOnClickListener(this);
+        btnCancel.setOnClickListener(this);
+    }
+
+    // 初始化数据（显示当前已保存的地址）
+    private void initData() {
+        String currentHost = GlobalApplication.getWinbollHost();
+        if (!TextUtils.isEmpty(currentHost)) {
+            etHostInput.setText(currentHost);
+            etHostInput.setSelection(currentHost.length()); // 光标定位到末尾
+            LogUtils.d(TAG, "当前已保存的服务器地址：" + currentHost);
+        }
+    }
+
+    @Override
+    public void onClick(View v) {
+        int id = v.getId();
+        if (id == R.id.btn_confirm) {
+            handleConfirm(); // 确认设置
+        } else if (id == R.id.btn_cancel) {
+            dismiss(); // 取消对话框
+        }
+    }
+
+    // 处理确认设置逻辑
+    private void handleConfirm() {
+        String inputHost = etHostInput.getText().toString().trim();
+        if (TextUtils.isEmpty(inputHost)) {
+            ToastUtils.show("服务器地址不能为空");
+            LogUtils.w(TAG, "设置失败：地址为空");
+            return;
+        }
+
+        // 简单校验URL格式（避免明显错误）
+        if (!inputHost.startsWith("http://") && !inputHost.startsWith("https://")) {
+            ToastUtils.show("地址需以http://或https://开头");
+            LogUtils.w(TAG, "设置失败：地址格式错误，input=" + inputHost);
+            return;
+        }
+
+        // 保存地址到SP+内存
+        GlobalApplication.setWinbollHost(inputHost);
+        ToastUtils.show("服务器地址设置成功");
+        LogUtils.d(TAG, "服务器地址设置成功：" + inputHost);
+        dismiss(); // 关闭对话框
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/SFTPBackupsSettingsDialog.java

@@ -0,0 +1,372 @@
+package cc.winboll.studio.libappbase.dialogs;
+
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.text.TextUtils;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.widget.Button;
+import android.widget.CheckBox;
+import android.widget.EditText;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.models.SFTPAuthModel;
+
+/**
+ * SFTP备份设置对话框
+ * 功能：1.布局式UI展示SFTP配置项 2.SP持久化存储SFTPAuthModel模型数据 3.提供公开静态方法供外部读取/清空SP配置
+ * 存储模式：SharedPreferences私有模式，仅本应用可访问
+ * UI实现：通过XML布局文件自定义控件，支持账号密码/秘钥双登录方式配置
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/31 12:36:00
+ * @LastEditTime 2026/01/31 21:58:00
+ */
+public class SFTPBackupsSettingsDialog {
+    // ************************ 常量属性 ************************
+    public static final String TAG = "SFTPBackupsSettingsDialog";
+    // SP存储核心常量
+    private static final String SP_NAME = "sftp_backup_settings_sp";
+    private static final String SP_KEY_PREFIX = "sftp_backup_";
+    // SP各字段存储Key
+    private static final String KEY_SERVER = SP_KEY_PREFIX + "server";
+    private static final String KEY_PORT = SP_KEY_PREFIX + "port";
+    private static final String KEY_USERNAME = SP_KEY_PREFIX + "username";
+    private static final String KEY_PASSWORD = SP_KEY_PREFIX + "password";
+    private static final String KEY_KEY_PATH = SP_KEY_PREFIX + "key_path";
+    private static final String KEY_KEY_PWD = SP_KEY_PREFIX + "key_pwd";
+    private static final String KEY_ACTIVE_MODE = SP_KEY_PREFIX + "active_mode";
+    private static final String KEY_CHARSET = SP_KEY_PREFIX + "charset";
+    // SFTP默认配置常量（抽离便于维护）
+    private static final int SFTP_DEFAULT_PORT = 22;
+    private static final String SFTP_DEFAULT_CHARSET = "UTF-8";
+
+    // ************************ 成员属性 ************************
+    // 上下文与对话框核心实例
+    private final Context mContext;
+    private AlertDialog mDialog;
+    // 布局控件实例（按配置模块排序，便于查找）
+    private EditText etServer;
+    private EditText etPort;
+    private EditText etUsername;
+    private EditText etPwd;
+    private EditText etKeyPath;
+    private EditText etKeyPwd;
+    private EditText etCharset;
+    private CheckBox cbActiveMode;
+    private Button btnSave;
+    private Button btnCancel;
+    private Button btnClear;
+
+    // ************************ 构造方法 ************************
+    /**
+     * 构造方法：初始化对话框核心依赖与流程
+     * @param context 上下文（推荐Application/Activity，避免内存泄漏）
+     */
+    public SFTPBackupsSettingsDialog(Context context) {
+        LogUtils.d(TAG, "SFTPBackupsSettingsDialog构造方法调用，传入上下文：" + context.getClass().getSimpleName());
+        this.mContext = context;
+        initDialog();
+        initView();
+        initData();
+        initListener();
+        LogUtils.d(TAG, "SFTPBackupsSettingsDialog初始化全流程执行完成");
+    }
+
+    // ************************ 公共方法 ************************
+    /**
+     * 显示SFTP配置对话框（做非空/非显示校验，避免重复显示）
+     */
+    public void show() {
+        LogUtils.d(TAG, "show()方法调用，对话框当前状态：" + (mDialog == null ? "未初始化" : mDialog.isShowing() ? "已显示" : "未显示"));
+        if (mDialog != null && !mDialog.isShowing()) {
+            mDialog.show();
+            LogUtils.i(TAG, "SFTP配置对话框显示成功");
+        }
+    }
+
+    /**
+     * 【公开静态方法】从SP读取SFTPAuthModel配置模型
+     * 外部可直接调用，无有效配置（服务器地址空）返回null
+     * @param context 上下文
+     * @return 已存储的配置模型/无有效配置返回null
+     */
+    public static SFTPAuthModel getSFTPAuthModelFromSP(Context context) {
+        LogUtils.d(TAG, "getSFTPAuthModelFromSP()静态方法调用，传入上下文：" + (context == null ? "null" : context.getClass().getSimpleName()));
+        try {
+            // 前置非空校验，避免空指针
+            if (context == null) {
+                LogUtils.e(TAG, "getSFTPAuthModelFromSP()执行失败：传入上下文为null");
+                return null;
+            }
+            SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+            SFTPAuthModel model = new SFTPAuthModel();
+            // 读取基础配置
+            model.setFtpServer(sp.getString(KEY_SERVER, null));
+            model.setFtpPort(sp.getInt(KEY_PORT, SFTP_DEFAULT_PORT));
+            model.setFtpUsername(sp.getString(KEY_USERNAME, null));
+            model.setFtpPassword(sp.getString(KEY_PASSWORD, null));
+            // 读取秘钥配置
+            model.setFtpKeyPath(sp.getString(KEY_KEY_PATH, null));
+            model.setFtpKeyPwd(sp.getString(KEY_KEY_PWD, null));
+            // 读取高级配置
+            model.setFtpCharset(sp.getString(KEY_CHARSET, SFTP_DEFAULT_CHARSET));
+
+            // 核心有效校验：服务器地址为空则判定为无有效配置
+            if (TextUtils.isEmpty(model.getFtpServer())) {
+                LogUtils.w(TAG, "getSFTPAuthModelFromSP()执行完成：SP中无有效SFTP配置（服务器地址为空）");
+                return null;
+            }
+            LogUtils.i(TAG, "getSFTPAuthModelFromSP()执行成功，读取到SFTP配置：" + model.getFtpServer() + ":" + model.getFtpPort());
+            return model;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getSFTPAuthModelFromSP()执行异常：" + e.getMessage(), e);
+            return null;
+        }
+    }
+
+    /**
+     * 【公开静态方法】清空SP中所有SFTP配置数据
+     * 外部可直接调用，做前置非空校验避免崩溃
+     * @param context 上下文
+     */
+    public static void clearSFTPAuthModelFromSP(Context context) {
+        LogUtils.d(TAG, "clearSFTPAuthModelFromSP()静态方法调用，传入上下文：" + (context == null ? "null" : context.getClass().getSimpleName()));
+        try {
+            if (context == null) {
+                LogUtils.e(TAG, "clearSFTPAuthModelFromSP()执行失败：传入上下文为null");
+                return;
+            }
+            SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+            SharedPreferences.Editor editor = sp.edit();
+            editor.clear();
+            editor.commit();
+            LogUtils.i(TAG, "clearSFTPAuthModelFromSP()执行成功：SP中SFTP配置已全部清空");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "clearSFTPAuthModelFromSP()执行异常：" + e.getMessage(), e);
+        }
+    }
+
+    // ************************ 私有初始化方法 ************************
+    /**
+     * 初始化对话框基础样式与布局绑定
+     */
+    private void initDialog() {
+        LogUtils.d(TAG, "initDialog()方法调用，开始初始化对话框基础样式");
+        View dialogView = LayoutInflater.from(mContext).inflate(R.layout.dialog_sftp_backup_settings, null);
+        AlertDialog.Builder builder = new AlertDialog.Builder(mContext);
+        builder.setView(dialogView);
+        builder.setCancelable(false); // 禁止外部点击/返回键关闭
+        mDialog = builder.create();
+        // 对话框样式适配，解决全屏/背景异常问题
+        if (mDialog.getWindow() != null) {
+            mDialog.getWindow().setBackgroundDrawableResource(android.R.color.white);
+        }
+        LogUtils.d(TAG, "initDialog()执行完成，对话框基础实例创建成功");
+    }
+
+    /**
+     * 初始化布局控件：绑定XML控件ID与Java实例（一一对应）
+     */
+    private void initView() {
+        LogUtils.d(TAG, "initView()方法调用，开始绑定布局控件实例");
+        View rootView = mDialog.getLayoutInflater().inflate(R.layout.dialog_sftp_backup_settings, null);
+        // 基础配置控件
+        etServer = rootView.findViewById(R.id.et_sftp_server);
+        etPort = rootView.findViewById(R.id.et_sftp_port);
+        etUsername = rootView.findViewById(R.id.et_sftp_username);
+        etPwd = rootView.findViewById(R.id.et_sftp_pwd);
+        // 秘钥配置控件
+        etKeyPath = rootView.findViewById(R.id.et_sftp_key_path);
+        etKeyPwd = rootView.findViewById(R.id.et_sftp_key_pwd);
+        // 高级配置控件
+        etCharset = rootView.findViewById(R.id.et_sftp_charset);
+        // 操作按钮控件
+        btnSave = rootView.findViewById(R.id.btn_sftp_save);
+        btnCancel = rootView.findViewById(R.id.btn_sftp_cancel);
+        btnClear = rootView.findViewById(R.id.btn_sftp_clear);
+        // 重新绑定对话框View，确保控件生效
+        mDialog.setView(rootView);
+        LogUtils.d(TAG, "initView()执行完成，所有布局控件绑定成功");
+    }
+
+    /**
+     * 初始化控件数据：从SP读取配置并回显到控件，无配置则设默认值
+     */
+    private void initData() {
+        LogUtils.d(TAG, "initData()方法调用，开始回显SP配置到控件");
+        SFTPAuthModel model = getSFTPAuthModelFromSP(mContext);
+        if (model == null) {
+            LogUtils.w(TAG, "initData()执行提示：SP中无有效SFTP配置，控件设置默认值");
+            // 无配置时设置默认值，提升用户体验
+            etPort.setText(String.valueOf(SFTP_DEFAULT_PORT));
+            etCharset.setText(SFTP_DEFAULT_CHARSET);
+            return;
+        }
+        // 回显基础配置（做非空校验，避免空指针）
+        etServer.setText(TextUtils.isEmpty(model.getFtpServer()) ? "" : model.getFtpServer());
+        etPort.setText(model.getFtpPort() <= 0 ? String.valueOf(SFTP_DEFAULT_PORT) : String.valueOf(model.getFtpPort()));
+        etUsername.setText(TextUtils.isEmpty(model.getFtpUsername()) ? "" : model.getFtpUsername());
+        etPwd.setText(TextUtils.isEmpty(model.getFtpPassword()) ? "" : model.getFtpPassword());
+        // 回显秘钥配置
+        etKeyPath.setText(TextUtils.isEmpty(model.getFtpKeyPath()) ? "" : model.getFtpKeyPath());
+        etKeyPwd.setText(TextUtils.isEmpty(model.getFtpKeyPwd()) ? "" : model.getFtpKeyPwd());
+        // 回显高级配置
+        etCharset.setText(TextUtils.isEmpty(model.getFtpCharset()) ? SFTP_DEFAULT_CHARSET : model.getFtpCharset());
+        LogUtils.d(TAG, "initData()执行完成，SP配置已成功回显到所有控件");
+    }
+
+    /**
+     * 初始化控件监听：为所有按钮设置Java7原生点击事件（匿名内部类）
+     */
+    private void initListener() {
+        LogUtils.d(TAG, "initListener()方法调用，开始设置控件点击事件");
+        // 保存按钮点击事件
+        btnSave.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					onSaveClick();
+				}
+			});
+        // 取消按钮点击事件
+        btnCancel.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					onCancelClick();
+				}
+			});
+        // 清空按钮点击事件
+        btnClear.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					onClearClick();
+				}
+			});
+        LogUtils.d(TAG, "initListener()执行完成，所有按钮点击事件设置成功");
+    }
+
+    // ************************ 私有事件处理方法 ************************
+    /**
+     * 保存按钮点击事件处理：控件数据→模型封装→有效性校验→SP持久化
+     */
+    private void onSaveClick() {
+        LogUtils.d(TAG, "onSaveClick()方法调用，开始处理配置保存逻辑");
+        SFTPAuthModel model = getModelFromView();
+        if (checkModelValid(model)) {
+            saveSFTPAuthModelToSP(mContext, model);
+            Toast.makeText(mContext, "SFTP配置保存成功", Toast.LENGTH_SHORT).show();
+            mDialog.dismiss();
+            LogUtils.i(TAG, "SFTP配置保存成功，服务器配置：" + model.getFtpServer() + ":" + model.getFtpPort());
+        }
+    }
+
+    /**
+     * 取消按钮点击事件处理：直接关闭对话框，不做任何数据修改
+     */
+    private void onCancelClick() {
+        LogUtils.d(TAG, "onCancelClick()方法调用，开始处理取消配置逻辑");
+        mDialog.dismiss();
+        LogUtils.i(TAG, "SFTP配置对话框已关闭（用户主动取消）");
+    }
+
+    /**
+     * 清空按钮点击事件处理：清空所有控件输入数据，恢复默认值（不修改SP）
+     */
+    private void onClearClick() {
+        LogUtils.d(TAG, "onClearClick()方法调用，开始处理控件数据清空逻辑");
+        // 清空基础配置控件
+        etServer.setText("");
+        etPort.setText(String.valueOf(SFTP_DEFAULT_PORT));
+        etUsername.setText("");
+        etPwd.setText("");
+        // 清空秘钥配置控件
+        etKeyPath.setText("");
+        etKeyPwd.setText("");
+        // 清空高级配置控件
+        cbActiveMode.setChecked(false);
+        etCharset.setText(SFTP_DEFAULT_CHARSET);
+        // 提示用户
+        Toast.makeText(mContext, "控件数据已清空", Toast.LENGTH_SHORT).show();
+        LogUtils.d(TAG, "onClearClick()执行完成，所有控件数据已恢复默认值");
+    }
+
+    // ************************ 私有业务方法 ************************
+    /**
+     * 从控件读取输入数据，封装为SFTPAuthModel模型
+     * 做基础非空处理，避免空字符串存入SP
+     * @return 封装后的SFTP配置模型
+     */
+    private SFTPAuthModel getModelFromView() {
+        LogUtils.d(TAG, "getModelFromView()方法调用，开始从控件读取数据封装模型");
+        SFTPAuthModel model = new SFTPAuthModel();
+        // 读取基础配置（trim去空格，避免无效空格）
+        model.setFtpServer(etServer.getText().toString().trim());
+        String portStr = etPort.getText().toString().trim();
+        model.setFtpPort(TextUtils.isEmpty(portStr) ? SFTP_DEFAULT_PORT : Integer.parseInt(portStr));
+        model.setFtpUsername(etUsername.getText().toString().trim());
+        model.setFtpPassword(etPwd.getText().toString().trim());
+        // 读取秘钥配置
+        model.setFtpKeyPath(etKeyPath.getText().toString().trim());
+        model.setFtpKeyPwd(etKeyPwd.getText().toString().trim());
+        // 读取高级配置
+        model.setFtpCharset(TextUtils.isEmpty(etCharset.getText().toString().trim()) ? SFTP_DEFAULT_CHARSET : etCharset.getText().toString().trim());
+        LogUtils.d(TAG, "getModelFromView()执行完成，控件数据已成功封装为SFTPAuthModel");
+        return model;
+    }
+
+    /**
+     * 校验SFTP配置模型的有效性（核心必选参数校验）
+     * 仅校验服务器地址和端口号，其他参数为可选
+     * @param model 待校验的SFTP配置模型
+     * @return true=配置有效 false=配置无效
+     */
+    private boolean checkModelValid(SFTPAuthModel model) {
+        LogUtils.d(TAG, "checkModelValid()方法调用，开始校验配置模型有效性");
+        // 校验服务器地址（必选）
+        if (TextUtils.isEmpty(model.getFtpServer())) {
+            Toast.makeText(mContext, "请输入SFTP服务器地址", Toast.LENGTH_SHORT).show();
+            LogUtils.w(TAG, "配置校验失败：SFTP服务器地址为空");
+            return false;
+        }
+        // 校验端口号（必选，1-65535合法范围）
+        if (model.getFtpPort() <= 0 || model.getFtpPort() > 65535) {
+            Toast.makeText(mContext, "请输入有效的端口号（1-65535）", Toast.LENGTH_SHORT).show();
+            LogUtils.w(TAG, "配置校验失败：SFTP端口号无效，当前值：" + model.getFtpPort());
+            return false;
+        }
+        LogUtils.d(TAG, "checkModelValid()执行完成，SFTP配置模型核心参数校验通过");
+        return true;
+    }
+
+    /**
+     * 将SFTPAuthModel模型数据存入SP（私有方法，仅内部调用）
+     * 使用commit同步提交，保证配置即时生效
+     * @param context 上下文
+     * @param model 待存储的SFTP配置模型
+     */
+    private static void saveSFTPAuthModelToSP(Context context, SFTPAuthModel model) {
+        LogUtils.d(TAG, "saveSFTPAuthModelToSP()方法调用，准备存储SFTP配置：" + model.getFtpServer() + ":" + model.getFtpPort());
+        try {
+            SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+            SharedPreferences.Editor editor = sp.edit();
+            // 存储基础配置
+            editor.putString(KEY_SERVER, model.getFtpServer());
+            editor.putInt(KEY_PORT, model.getFtpPort());
+            editor.putString(KEY_USERNAME, model.getFtpUsername());
+            editor.putString(KEY_PASSWORD, model.getFtpPassword());
+            // 存储秘钥配置
+            editor.putString(KEY_KEY_PATH, model.getFtpKeyPath());
+            editor.putString(KEY_KEY_PWD, model.getFtpKeyPwd());
+            // 存储高级配置
+            editor.putString(KEY_CHARSET, model.getFtpCharset());
+            // 同步提交，保证配置即时生效（区别于apply异步）
+            editor.commit();
+            LogUtils.d(TAG, "saveSFTPAuthModelToSP()执行完成，SFTP配置已成功存入SP");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "saveSFTPAuthModelToSP()执行异常：" + e.getMessage(), e);
+        }
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/models/APPInfo.java

@@ -0,0 +1,214 @@
+package cc.winboll.studio.libappbase.models;
+
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.Serializable;
+
+/**
+ * @Describe 应用信息实体类，存储应用核心配置信息，实现序列化接口
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 12:29:00
+ * @LastEditTime 2026/01/12 00:15:00
+ */
+public class APPInfo implements Serializable {
+    // 常量定义区
+    public static final String TAG = "APPInfo";
+
+    // 成员属性区（按功能归类排序，统一私有访问权限，Java7 兼容，注释清晰）
+    private String appName;             // 应用名称
+    private int appIcon;                // 应用图标资源ID
+    private String appDescription;      // 应用描述文案
+    private String appGitName;          // 应用Git仓库名称
+    private String appGitOwner;         // 应用Git仓库拥有者账号
+    private String appGitAPPBranch;     // 应用Git仓库对应分支
+    private String appGitAPPSubProjectFolder;  // 应用Git仓库内子项目文件夹路径
+    private String appHomePage;         // 应用官方主页地址
+    private String appAPKName;          // 应用安装包名称
+    private String appAPKFolderName;    // 应用安装包存储文件夹名称
+    private boolean isAddDebugTools;    // 是否启用应用调试工具功能
+
+    // 构造方法区（按 参数从少到多 排序，逻辑清晰，便于调用选型）
+    /**
+     * 无参构造方法，默认初始化WinBoLL应用基础配置
+     */
+    public APPInfo() {
+        LogUtils.d(TAG, "APPInfo() 无参构造方法调用，执行默认配置初始化");
+        String szBranchName = "winboll";
+        this.appName = "WinBoLL";
+        this.appIcon = R.drawable.ic_winboll;
+        this.appDescription = "Hello, WinBoLl!";
+        this.appGitName = "WinBoLL";
+        this.appGitOwner = "Studio";
+        this.appGitAPPBranch = szBranchName;
+        this.appGitAPPSubProjectFolder = szBranchName;
+        this.appHomePage = "https://www.winboll.cc/apks/index.php?project=WinBoLL";
+        this.appAPKName = "WinBoLL";
+        this.appAPKFolderName = "WinBoLL";
+        this.isAddDebugTools = false;
+        LogUtils.d(TAG, "APPInfo() 无参构造初始化完成，默认应用名称：" + this.appName);
+    }
+
+    /**
+     * 多参构造方法（不含调试工具配置，默认关闭调试功能）
+     * @param appName 应用名称
+     * @param appIcon 应用图标资源ID
+     * @param appDescription 应用描述
+     * @param appGitName Git仓库名称
+     * @param appGitOwner Git仓库拥有者
+     * @param appGitAPPBranch Git仓库分支
+     * @param appGitAPPSubProjectFolder Git子项目文件夹
+     * @param appHomePage 应用主页
+     * @param appAPKName 应用包名
+     * @param appAPKFolderName 应用包存储文件夹名
+     */
+    public APPInfo(String appName, int appIcon, String appDescription, String appGitName, String appGitOwner, 
+                   String appGitAPPBranch, String appGitAPPSubProjectFolder, String appHomePage, 
+                   String appAPKName, String appAPKFolderName) {
+        LogUtils.d(TAG, "APPInfo(多参无调试) 构造调用，入参应用名：" + appName + " | Git仓库名：" + appGitName);
+        this.appName = appName;
+        this.appIcon = appIcon;
+        this.appDescription = appDescription;
+        this.appGitName = appGitName;
+        this.appGitOwner = appGitOwner;
+        this.appGitAPPBranch = appGitAPPBranch;
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+        this.appHomePage = appHomePage;
+        this.appAPKName = appAPKName;
+        this.appAPKFolderName = appAPKFolderName;
+        this.isAddDebugTools = false;
+        LogUtils.d(TAG, "APPInfo(多参无调试) 构造初始化完成");
+    }
+
+    /**
+     * 全参构造方法（包含调试工具配置，支持自定义调试开关）
+     * @param appName 应用名称
+     * @param appIcon 应用图标资源ID
+     * @param appDescription 应用描述
+     * @param appGitName Git仓库名称
+     * @param appGitOwner Git仓库拥有者
+     * @param appGitAPPBranch Git仓库分支
+     * @param appGitAPPSubProjectFolder Git子项目文件夹
+     * @param appHomePage 应用主页
+     * @param appAPKName 应用包名
+     * @param appAPKFolderName 应用包存储文件夹名
+     * @param isAddDebugTools 是否开启调试工具
+     */
+    public APPInfo(String appName, int appIcon, String appDescription, String appGitName, String appGitOwner, 
+                   String appGitAPPBranch, String appGitAPPSubProjectFolder, String appHomePage, 
+                   String appAPKName, String appAPKFolderName, boolean isAddDebugTools) {
+        LogUtils.d(TAG, "APPInfo(全参带调试) 构造调用，入参应用名：" + appName + " | 调试开关：" + isAddDebugTools);
+        this.appName = appName;
+        this.appIcon = appIcon;
+        this.appDescription = appDescription;
+        this.appGitName = appGitName;
+        this.appGitOwner = appGitOwner;
+        this.appGitAPPBranch = appGitAPPBranch;
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+        this.appHomePage = appHomePage;
+        this.appAPKName = appAPKName;
+        this.appAPKFolderName = appAPKFolderName;
+        this.isAddDebugTools = isAddDebugTools;
+        LogUtils.d(TAG, "APPInfo(全参带调试) 构造初始化完成");
+    }
+
+    // Getter/Setter 方法区（严格跟随成员属性定义顺序，易查找维护，仅Setter加调试日志）
+    public String getAppName() {
+        return appName;
+    }
+
+    public void setAppName(String appName) {
+        LogUtils.d(TAG, "setAppName() 调用，传入应用名称：" + appName);
+        this.appName = appName;
+    }
+
+    public int getAppIcon() {
+        return appIcon;
+    }
+
+    public void setAppIcon(int appIcon) {
+        LogUtils.d(TAG, "setAppIcon() 调用，传入图标资源ID：" + appIcon);
+        this.appIcon = appIcon;
+    }
+
+    public String getAppDescription() {
+        return appDescription;
+    }
+
+    public void setAppDescription(String appDescription) {
+        LogUtils.d(TAG, "setAppDescription() 调用，传入描述文案：" + appDescription);
+        this.appDescription = appDescription;
+    }
+
+    public String getAppGitName() {
+        return appGitName;
+    }
+
+    public void setAppGitName(String appGitName) {
+        LogUtils.d(TAG, "setAppGitName() 调用，传入Git仓库名：" + appGitName);
+        this.appGitName = appGitName;
+    }
+
+    public String getAppGitOwner() {
+        return appGitOwner;
+    }
+
+    public void setAppGitOwner(String appGitOwner) {
+        LogUtils.d(TAG, "setAppGitOwner() 调用，传入Git拥有者：" + appGitOwner);
+        this.appGitOwner = appGitOwner;
+    }
+
+    public String getAppGitAPPBranch() {
+        return appGitAPPBranch;
+    }
+
+    public void setAppGitAPPBranch(String appGitAPPBranch) {
+        LogUtils.d(TAG, "setAppGitAPPBranch() 调用，传入Git分支：" + appGitAPPBranch);
+        this.appGitAPPBranch = appGitAPPBranch;
+    }
+
+    public String getAppGitAPPSubProjectFolder() {
+        return appGitAPPSubProjectFolder;
+    }
+
+    public void setAppGitAPPSubProjectFolder(String appGitAPPSubProjectFolder) {
+        LogUtils.d(TAG, "setAppGitAPPSubProjectFolder() 调用，传入Git子项目文件夹：" + appGitAPPSubProjectFolder);
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+    }
+
+    public String getAppHomePage() {
+        return appHomePage;
+    }
+
+    public void setAppHomePage(String appHomePage) {
+        LogUtils.d(TAG, "setAppHomePage() 调用，传入应用主页地址：" + appHomePage);
+        this.appHomePage = appHomePage;
+    }
+
+    public String getAppAPKName() {
+        return appAPKName;
+    }
+
+    public void setAppAPKName(String appAPKName) {
+        LogUtils.d(TAG, "setAppAPKName() 调用，传入应用包名：" + appAPKName);
+        this.appAPKName = appAPKName;
+    }
+
+    public String getAppAPKFolderName() {
+        return appAPKFolderName;
+    }
+
+    public void setAppAPKFolderName(String appAPKFolderName) {
+        LogUtils.d(TAG, "setAppAPKFolderName() 调用，传入包存储文件夹名：" + appAPKFolderName);
+        this.appAPKFolderName = appAPKFolderName;
+    }
+
+    public boolean isAddDebugTools() {
+        return isAddDebugTools;
+    }
+
+    public void setIsAddDebugTools(boolean isAddDebugTools) {
+        LogUtils.d(TAG, "setIsAddDebugTools() 调用，传入调试开关状态：" + isAddDebugTools);
+        this.isAddDebugTools = isAddDebugTools;
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/models/SFTPAuthModel.java

@@ -0,0 +1,101 @@
+package cc.winboll.studio.libappbase.models;
+
+/**
+ * SFTP登录验证信息实体类
+ * 封装SFTP登录所需的所有配置信息：服务端地址、端口、账号密码、秘钥信息、编码
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/30 19:08:00
+ * @LastEditTime 2026/01/31 22:45:00
+ */
+public class SFTPAuthModel {
+    public static final String TAG = "SFTPAuthModel";
+
+    // SFTP服务器地址（必填，如192.168.1.100、sftp.xxx.com）
+    private String ftpServer;
+    // SFTP服务器端口（必填，默认22）
+    private int ftpPort = 22;
+    // SFTP登录用户名（匿名登录传null/空）
+    private String ftpUsername;
+    // SFTP登录密码（匿名登录传null/空）
+    private String ftpPassword;
+    // SFTP登录秘钥路径（秘钥登录时使用，本地绝对路径，如/sdcard/sftp/key.pem，账号密码登录传null/空）
+    private String ftpKeyPath;
+    // SFTP登录秘钥密码（秘钥有密码时填写，无密码传null/空）
+    private String ftpKeyPwd;
+    // SFTP编码（默认UTF-8，解决中文文件名乱码）
+    private String ftpCharset = "UTF-8";
+
+    // 空参构造（JavaBean规范）
+    public SFTPAuthModel() {
+    }
+
+    // 全参构造（快速初始化）
+    public SFTPAuthModel(String ftpServer, int ftpPort, String ftpUsername, String ftpPassword,
+						 String ftpKeyPath, String ftpKeyPwd, String ftpCharset) {
+        this.ftpServer = ftpServer;
+        this.ftpPort = ftpPort;
+        this.ftpUsername = ftpUsername;
+        this.ftpPassword = ftpPassword;
+        this.ftpKeyPath = ftpKeyPath;
+        this.ftpKeyPwd = ftpKeyPwd;
+        this.ftpCharset = ftpCharset;
+    }
+
+    // ==================== Get/Set 方法 ====================
+    public String getFtpServer() {
+        return ftpServer;
+    }
+
+    public void setFtpServer(String ftpServer) {
+        this.ftpServer = ftpServer;
+    }
+
+    public int getFtpPort() {
+        return ftpPort;
+    }
+
+    public void setFtpPort(int ftpPort) {
+        this.ftpPort = ftpPort;
+    }
+
+    public String getFtpUsername() {
+        return ftpUsername;
+    }
+
+    public void setFtpUsername(String ftpUsername) {
+        this.ftpUsername = ftpUsername;
+    }
+
+    public String getFtpPassword() {
+        return ftpPassword;
+    }
+
+    public void setFtpPassword(String ftpPassword) {
+        this.ftpPassword = ftpPassword;
+    }
+
+    public String getFtpKeyPath() {
+        return ftpKeyPath;
+    }
+
+    public void setFtpKeyPath(String ftpKeyPath) {
+        this.ftpKeyPath = ftpKeyPath;
+    }
+
+    public String getFtpKeyPwd() {
+        return ftpKeyPwd;
+    }
+
+    public void setFtpKeyPwd(String ftpKeyPwd) {
+        this.ftpKeyPwd = ftpKeyPwd;
+    }
+
+    public String getFtpCharset() {
+        return ftpCharset;
+    }
+
+    public void setFtpCharset(String ftpCharset) {
+        this.ftpCharset = ftpCharset;
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/models/SignCheckResponse.java

@@ -0,0 +1,39 @@
+package cc.winboll.studio.libappbase.models;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/22 20:37
+ */
+// ==================== JSON响应模型（与后端返回字段完全匹配）====================
+public class SignCheckResponse {
+    private int code;                // 根节点code（后端返回）
+    private String msg;              // 根节点提示信息（后端返回，替换原message）
+    private DataBean data;           // 根节点data对象（后端返回）
+
+    // 内部DataBean：对应后端返回的data字段内容
+    public static class DataBean {
+        private boolean valid;       // 实际是否合法的标识（后端data.valid）
+        private String signature;    // 加密后的签名
+        private String decryptedSign;// 解密后的原始签名
+        private long validTime;      // 时间戳
+    }
+
+    // Getter/Setter（关键：获取data中的valid字段）
+    public boolean isValid() {
+        return data != null && data.valid; // 从data中获取valid值
+    }
+
+    public String getMessage() {
+        return msg; // 对应后端根节点的msg字段
+    }
+
+    // 其他必要的Getter/Setter（用于后续扩展）
+    public int getCode() {
+        return code;
+    }
+
+    public DataBean getData() {
+        return data;
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APKFileUtils.java

@@ -0,0 +1,306 @@
+package cc.winboll.studio.libappbase.utils;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+import java.util.Base64;
+import java.util.jar.JarEntry;
+import java.util.jar.JarFile;
+
+/**
+ * APK文件工具类（单例）- 生产级签名+哈希双校验版（修复Too short异常）
+ * 1. 稳定解析CERT.RSA原始字节，与客户端Signature.toByteArray()1:1对齐，解决X509解析异常
+ * 2. 支持SHA256文件哈希字节级唯一校验，签名+哈希双重验证
+ * 3. 入参包含：项目名/版本名/APK名/客户端签名/客户端哈希，适配生产级版本管理
+ * 4. APK路径规范：apks_root/项目名/debug/tag/APK文件（支持调试/正式环境）
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ */
+public class APKFileUtils {
+    // 单例实例
+    private static volatile APKFileUtils sInstance;
+    // 配置项
+    private static final String CONFIG_SECTION = "APP";
+    private static final String KEY_APKS_FOLDER = "apks_folder_path";
+    // 算法常量（与客户端严格对齐）
+    private static final String SIGN_ALGORITHM = "SHA1";    // 签名摘要算法
+    private static final String HASH_ALGORITHM = "SHA-256"; // 文件哈希算法
+    // 签名文件（兼容大小写，适配所有打包工具）
+    private static final String CERT_RSA_UPPER = "META-INF/CERT.RSA";
+    private static final String CERT_RSA_LOWER = "META-INF/cert.rsa";
+    // APK根目录
+    private String apksRootPath;
+
+    private APKFileUtils() {}
+
+    /**
+     * 初始化工具类（需在应用启动时调用）
+     */
+    public static void init() {
+        if (sInstance == null) {
+            synchronized (APKFileUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new APKFileUtils();
+                    //sInstance.loadConfig();
+                }
+            }
+        }
+    }
+
+    /**
+     * 获取单例实例
+     */
+    public static APKFileUtils getInstance() {
+        if (sInstance == null) {
+            LogUtils.e("APKFileUtils", "请先调用init()初始化工具类");
+            throw new IllegalStateException("APKFileUtils未初始化，请先调用init()");
+        }
+        return sInstance;
+    }
+
+    /**
+     * 加载配置文件中的APK根目录
+     */
+//    private void loadConfig() {
+//        try {
+//            apksRootPath = IniConfigUtils.getConfigValue(CONFIG_SECTION, KEY_APKS_FOLDER, "").trim();
+//            if (apksRootPath.isEmpty()) {
+//                LogUtils.e("APKFileUtils", "配置项apks_folder_path为空，初始化失败");
+//                return;
+//            }
+//            File rootDir = new File(apksRootPath);
+//            if (!rootDir.exists() && !rootDir.mkdirs()) {
+//                LogUtils.e("APKFileUtils", "APK根目录创建失败：" + apksRootPath);
+//                apksRootPath = "";
+//                return;
+//            }
+//            LogUtils.i("APKFileUtils", "APK根目录加载成功：" + apksRootPath);
+//        } catch (Exception e) {
+//            LogUtils.e("APKFileUtils", "加载APK根目录配置失败", e);
+//            apksRootPath = "";
+//        }
+//    }
+
+    /**
+     * 对外暴露核心校验方法：签名 + SHA256文件哈希 双校验
+     * 入参包含：项目名/版本名/APK文件名/客户端签名Base64/客户端文件哈希
+     * APK路径规范：apksRootPath/项目名/版本名/APK文件
+     * @param projectName 项目名（非空）
+     * @param versionName 版本名（非空，如15.11.11）
+     * @param apkFileName APK文件名（非空，需以.apk结尾）
+     * @param clientSignBase64 客户端传入的签名Base64（非空）
+     * @param clientFileHash 客户端传入的APK文件SHA256哈希（小写/大写均可，非空）
+     * @return 校验通过返回true，否则false
+     */
+    public static boolean checkAPK(String projectName, String versionName, String apkFileName,
+                                   String clientSignBase64, String clientFileHash) {
+        return getInstance().doCheckAPK(projectName, versionName, apkFileName, clientSignBase64, clientFileHash);
+    }
+
+    /**
+     * 核心校验实现：严格按「哈希先验，签名后验」顺序，哈希不匹配直接返回
+     */
+    private boolean doCheckAPK(String projectName, String versionName, String apkFileName,
+                               String clientSignBase64, String clientFileHash) {
+        // 1. 基础入参非空校验
+        if (isParamEmpty(projectName) || isParamEmpty(versionName) || isParamEmpty(apkFileName)
+            || isParamEmpty(clientSignBase64) || isParamEmpty(clientFileHash)) {
+            LogUtils.w("APKFileUtils", "基础参数不能为空：projectName/versionName/apkFileName/clientSignBase64/clientFileHash");
+            return false;
+        }
+        // 2. APK文件名格式校验
+        if (!apkFileName.endsWith(".apk")) {
+            LogUtils.w("APKFileUtils", "APK文件名格式错误，需以.apk结尾：" + apkFileName);
+            return false;
+        }
+        // 3. APK根目录校验
+        if (isParamEmpty(apksRootPath)) {
+            LogUtils.w("APKFileUtils", "APK根目录未配置，无法进行校验");
+            return false;
+        }
+        // 4. 拼接标准APK路径：根目录/项目名/debug/项目名_版本名.apk（调试环境，可切换tag）
+        String apkFullPath = String.format("%s/%s/debug/%s_%s.apk",
+                                           apksRootPath,
+                                           projectName,
+                                           projectName,
+                                           versionName);
+        //正式环境路径（注释保留，切换时解开即可）
+//        String apkFullPath = String.format("%s/%s/tag/%s_%s.apk",
+//                                           apksRootPath,
+//                                           projectName,
+//                                           projectName,
+//                                           versionName);
+        LogUtils.d("APKFileUtils", String.format("apkFullPath : %s", apkFullPath));
+        File apkFile = new File(apkFullPath);
+        // 5. APK文件存在性校验
+        if (!apkFile.exists() || !apkFile.isFile()) {
+            LogUtils.w("APKFileUtils", "APK文件不存在或非文件类型：" + apkFullPath);
+            return false;
+        }
+
+        try {
+            // ===== 第一步：SHA256文件哈希校验（字节级唯一，优先级最高）=====
+            String serverFileHash = getAPKFileHash(apkFile);
+            if (isParamEmpty(serverFileHash)) {
+                LogUtils.w("APKFileUtils", "解析服务端APK文件哈希失败：" + apkFileName);
+                return false;
+            }
+            boolean isHashMatch = serverFileHash.equalsIgnoreCase(clientFileHash.trim());
+            LogUtils.d("APKFileUtils", "【哈希对比】服务端SHA256：" + serverFileHash);
+            LogUtils.d("APKFileUtils", "【哈希对比】客户端SHA256：" + clientFileHash.trim());
+            if (!isHashMatch) {
+                LogUtils.i("APKFileUtils", "【哈希对比结果】❌ 不匹配（字节级文件不一致）");
+                return false;
+            }
+            LogUtils.i("APKFileUtils", "【哈希对比结果】✅ 匹配（字节级文件完全一致）");
+
+            // ===== 第二步：签名校验（直接读取CERT.RSA原始字节，与客户端严格对齐）=====
+            String serverSignBase64 = getAPKSign(apkFile);
+            if (isParamEmpty(serverSignBase64)) {
+                LogUtils.w("APKFileUtils", "解析服务端APK签名失败：" + apkFileName);
+                return false;
+            }
+            boolean isSignMatch = serverSignBase64.equals(clientSignBase64.trim());
+            LogUtils.d("APKFileUtils", "【签名对比】服务端Base64：" + serverSignBase64);
+            LogUtils.d("APKFileUtils", "【签名对比】客户端Base64：" + clientSignBase64.trim());
+            if (!isSignMatch) {
+                LogUtils.i("APKFileUtils", "【签名对比结果】❌ 不匹配（签名不一致）");
+                return false;
+            }
+            LogUtils.i("APKFileUtils", "【签名对比结果】✅ 匹配（签名完全一致）");
+
+            // 所有校验通过
+            LogUtils.i("APKFileUtils", "APK双校验全部通过：项目名=" + projectName + "，版本名=" + versionName + "，文件名=" + apkFileName);
+            return true;
+        } catch (Exception e) {
+            LogUtils.e("APKFileUtils", "APK双校验异常", e);
+            return false;
+        }
+    }
+
+    /**
+     * 稳定解析APK签名：直接读取CERT.RSA原始字节，SHA1+Base64（与客户端1:1对齐）
+     * 解决X509证书解析的Too short异常，兼容所有APK（普通/加固/自定义打包）
+     * @param apkFile APK文件
+     * @return 签名Base64字符串，失败返回null
+     */
+    private String getAPKSign(File apkFile) {
+        JarFile jarFile = null;
+        InputStream certIs = null;
+        try {
+            jarFile = new JarFile(apkFile);
+            // 先找大写CERT.RSA，找不到再找小写，兼容所有打包工具
+            JarEntry certEntry = jarFile.getJarEntry(CERT_RSA_UPPER);
+            if (certEntry == null) {
+                certEntry = jarFile.getJarEntry(CERT_RSA_LOWER);
+                if (certEntry == null) {
+                    LogUtils.w("APKFileUtils", "APK中未找到签名文件：META-INF/CERT.RSA/cert.rsa");
+                    return null;
+                }
+            }
+            // 核心：直接读取CERT.RSA的原始字节流（不做证书解析，适配PKCS7签名块）
+            certIs = jarFile.getInputStream(certEntry);
+            byte[] sigRawBytes = readStreamToBytes(certIs);
+            if (sigRawBytes == null || sigRawBytes.length == 0) {
+                LogUtils.w("APKFileUtils", "读取CERT.RSA原始字节为空");
+                return null;
+            }
+            // 与客户端完全一致的处理流程：SHA1摘要 → Base64编码（去换行）
+            MessageDigest md = MessageDigest.getInstance(SIGN_ALGORITHM);
+            byte[] signDigest = md.digest(sigRawBytes);
+            String signBase64 = Base64.getEncoder().encodeToString(signDigest)
+				.replaceAll("\\r", "").replaceAll("\\n", "");
+
+            LogUtils.d("APKFileUtils", "APK签名解析成功(Base64)：" + signBase64);
+            return signBase64;
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e("APKFileUtils", "解析签名失败：" + SIGN_ALGORITHM + "算法不存在", e);
+            return null;
+        } catch (Exception e) {
+            LogUtils.e("APKFileUtils", "解析APK签名异常", e);
+            return null;
+        } finally {
+            // 强制关闭流资源，避免内存泄漏
+            try {
+                if (certIs != null) certIs.close();
+                if (jarFile != null) jarFile.close();
+            } catch (IOException e) {
+                LogUtils.e("APKFileUtils", "关闭签名文件流失败", e);
+            }
+        }
+    }
+
+    /**
+     * 解析APK文件的SHA256哈希（字节级唯一，任何字节修改都会改变）
+     * @param apkFile APK文件
+     * @return 小写64位SHA256哈希字符串，失败返回null
+     */
+    private String getAPKFileHash(File apkFile) {
+        FileInputStream fis = null;
+        try {
+            MessageDigest md = MessageDigest.getInstance(HASH_ALGORITHM);
+            fis = new FileInputStream(apkFile);
+            byte[] buffer = new byte[8192]; // 8K缓冲区，提升大APK读取效率
+            int len;
+            while ((len = fis.read(buffer)) != -1) {
+                md.update(buffer, 0, len);
+            }
+            // 哈希字节转小写16进制字符串（64位，官方标准格式）
+            byte[] hashBytes = md.digest();
+            StringBuilder sb = new StringBuilder();
+            for (byte b : hashBytes) {
+                sb.append(String.format("%02x", b));
+            }
+            String fileHash = sb.toString();
+            LogUtils.d("APKFileUtils", "APK文件SHA256哈希解析成功：" + fileHash);
+            return fileHash;
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e("APKFileUtils", "获取文件哈希失败：" + HASH_ALGORITHM + "算法不存在", e);
+            return null;
+        } catch (Exception e) {
+            LogUtils.e("APKFileUtils", "解析APK文件哈希异常", e);
+            return null;
+        } finally {
+            if (fis != null) {
+                try {
+                    fis.close();
+                } catch (IOException e) {
+                    LogUtils.e("APKFileUtils", "关闭APK文件流失败", e);
+                }
+            }
+        }
+    }
+
+    /**
+     * 流转字节数组工具方法：稳定读取任意输入流，无截断/空指针问题
+     */
+    private byte[] readStreamToBytes(InputStream is) throws IOException {
+        if (is == null) {
+            LogUtils.w("APKFileUtils", "readStreamToBytes: 输入流为null");
+            return new byte[0];
+        }
+        ByteArrayOutputStream bos = new ByteArrayOutputStream();
+        byte[] buffer = new byte[4096];
+        int len;
+        while ((len = is.read(buffer)) != -1) {
+            bos.write(buffer, 0, len);
+        }
+        byte[] result = bos.toByteArray();
+        // 按顺序关闭流
+        is.close();
+        bos.close();
+        return result;
+    }
+
+    /**
+     * 工具方法：判断参数是否为空（null/空字符串/全空格）
+     */
+    private boolean isParamEmpty(String param) {
+        return param == null || param.trim().isEmpty();
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APPUtils.java

@@ -0,0 +1,199 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.Base64;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.SignCheckResponse;
+
+import com.google.gson.Gson;
+
+import java.io.IOException;
+import java.net.URLEncoder;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-20 19:17:00
+ * @LastEditTime 2026-01-24 17:58:00
+ * @Describe APPUtils 应用合法性校验工具类（OKHTTP网络校验版，兼容Java7）
+ * 对外传入签名/哈希值，拼接调试标识后发起网络校验，主线程返回校验结果
+ */
+public class APPUtils {
+    // ===================================== 全局常量/单例属性 =====================================
+    public static final String TAG = "APPUtils";
+    // 网络校验接口基础地址
+    private static final String CHECK_API_URI = "api/app-signatures-check";
+    // OKHTTP客户端单例（复用连接，避免资源浪费）
+    private static final OkHttpClient sOkHttpClient = new OkHttpClient();
+    // Gson解析单例（全局复用，提高解析效率）
+    private static final Gson sGson = new Gson();
+
+    // ===================================== 对外核心校验方法 =====================================
+    /**
+     * 检查应用合法性（外部传入签名+哈希，拼接调试标识发起网络校验）
+     * @param context      上下文，用于主线程回调
+     * @param projectName  项目名称（服务端区分项目标识）
+     * @param versionName  应用版本名（服务端版本校验）
+     * @param clientSign   外部计算的应用签名字符串（Base64）
+     * @param clientHash   外部计算的APK SHA256哈希字符串（小写16进制）
+     * @param callback     校验结果回调（主线程调用，返回是否合法+提示信息）
+     */
+    public void checkAPKValidation(Context context, String projectName, String versionName,
+                                   String clientSign, String clientHash, final CheckResultCallback callback) {
+        // 方法调用+全量入参调试日志
+        LogUtils.d(TAG, "checkAPKValidation: 方法调用，入参-> projectName=" + projectName
+				   + ", versionName=" + versionName + ", clientSign=" + clientSign + ", clientHash=" + clientHash);
+
+        // 1. 核心入参空值校验（快速失败）
+        if (context == null) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参context为空，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "上下文对象不能为空");
+            return;
+        }
+        if (isStringEmpty(projectName)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参projectName为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "项目名称不能为空");
+            return;
+        }
+        if (isStringEmpty(versionName)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参versionName为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "应用版本名不能为空");
+            return;
+        }
+        if (isStringEmpty(clientSign)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参clientSign为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "应用签名字符串不能为空");
+            return;
+        }
+        if (isStringEmpty(clientHash)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参clientHash为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "APK SHA256哈希字符串不能为空");
+            return;
+        }
+        LogUtils.d(TAG, "checkAPKValidation: 入参校验通过，开始处理网络请求");
+
+        // 2. 动态参数URL编码（避免特殊字符导致请求解析异常）
+        LogUtils.d(TAG, "checkAPKValidation: 开始对动态参数进行UTF-8 URL编码");
+        String encodeProjectName = urlEncode(projectName);
+        String encodeVersionName = urlEncode(versionName);
+        String encodeClientSign = urlEncode(clientSign);
+        String encodeClientHash = urlEncode(clientHash);
+        String isDebug = String.valueOf(GlobalApplication.isDebugging());
+        LogUtils.d(TAG, "checkAPKValidation: 参数编码完成，debug标识=" + isDebug);
+
+        // 3. 构建完整网络校验请求URL
+        String requestUrl = String.format("%s?isDebug=%s&projectName=%s&versionName=%s&clientSign=%s&clientHash=%s",
+										  GlobalApplication.getWinbollHost() + CHECK_API_URI,
+										  isDebug,
+										  encodeProjectName,
+										  encodeVersionName,
+										  encodeClientSign,
+										  encodeClientHash);
+        LogUtils.d(TAG, "checkAPKValidation: 构建网络校验请求URL=" + requestUrl);
+
+        // 4. 发起OKHTTP异步GET请求（避免阻塞主线程）
+        LogUtils.d(TAG, "checkAPKValidation: 发起异步网络校验请求");
+        Request request = new Request.Builder().url(requestUrl).build();
+        sOkHttpClient.newCall(request).enqueue(new Callback() {
+				@Override
+				public void onFailure(Call call, IOException e) {
+					String errorMsg = "网络校验请求失败：" + e.getMessage();
+					LogUtils.e(TAG, "checkAPKValidation: " + errorMsg, e);
+					callCallbackOnMainThread(callback, false, errorMsg);
+				}
+
+				@Override
+				public void onResponse(Call call, Response response) throws IOException {
+					if (response.isSuccessful() && response.body() != null) {
+						// 响应成功，解析返回JSON
+						String responseJson = response.body().string();
+						LogUtils.d(TAG, "checkAPKValidation: 网络校验响应成功，JSON=" + responseJson);
+						SignCheckResponse checkResponse = sGson.fromJson(responseJson, SignCheckResponse.class);
+						boolean isValid = checkResponse != null && checkResponse.isValid();
+						String msg = checkResponse != null ? checkResponse.getMessage() : "服务端响应解析失败";
+						LogUtils.d(TAG, "checkAPKValidation: 校验结果解析完成，isValid=" + isValid + ", 提示信息=" + msg);
+						callCallbackOnMainThread(callback, isValid, msg);
+					} else {
+						// 响应失败，返回状态码信息
+						String errorMsg = "网络校验响应失败，服务端状态码=" + response.code();
+						LogUtils.e(TAG, "checkAPKValidation: " + errorMsg);
+						callCallbackOnMainThread(callback, false, errorMsg);
+					}
+				}
+			});
+    }
+
+    // ===================================== 内部工具方法 =====================================
+    /**
+     * 字符串空值/空白校验工具
+     * @param str 待校验字符串
+     * @return true=空/空白，false=非空
+     */
+    private boolean isStringEmpty(String str) {
+        return str == null || str.trim().isEmpty();
+    }
+
+    /**
+     * URL编码工具（Java7适配，UTF-8编码，处理特殊字符）
+     * @param content 待编码内容
+     * @return 编码后的字符串，编码失败返回原内容
+     */
+    private String urlEncode(String content) {
+        try {
+            return URLEncoder.encode(content, "UTF-8");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "urlEncode: 字符串编码失败，content=" + content, e);
+            return content;
+        }
+    }
+
+    /**
+     * 主线程执行回调（统一处理，避免外部线程切换）
+     * @param callback 回调接口
+     * @param isValid  是否合法
+     * @param message   提示信息
+     */
+    private void callCallbackOnMainThread(final CheckResultCallback callback,
+                                          final boolean isValid, final String message) {
+        if (callback == null) {
+            LogUtils.w(TAG, "callCallbackOnMainThread: 回调接口为null，无需执行");
+            return;
+        }
+        // 已在主线程直接执行，否则切换主线程
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            callback.onResult(isValid, message);
+        } else {
+            new Handler(Looper.getMainLooper()).post(new Runnable() {
+					@Override
+					public void run() {
+						callback.onResult(isValid, message);
+					}
+				});
+        }
+    }
+
+    // ===================================== 校验结果回调接口 =====================================
+    /**
+     * 应用合法性校验结果回调接口（主线程调用）
+     */
+    public interface CheckResultCallback {
+        /**
+         * 校验结果回调方法
+         * @param isValid 是否合法（true=校验通过，false=校验失败）
+         * @param message 校验提示信息（失败时返回错误原因，成功时返回服务端提示）
+         */
+        void onResult(boolean isValid, String message);
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/ApkSignUtils.java

@@ -0,0 +1,272 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.Signature;
+import android.util.Base64;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+import java.util.Enumeration;
+import java.util.jar.JarEntry;
+import java.util.jar.JarFile;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-24 10:00:00
+ * @LastEditTime 2026-01-24 22:00:00
+ * @Describe 客户端签名工具类：与服务端APKFileUtils签名/哈希校验逻辑严格对齐，纯Java7实现；兼容MT重签名（遍历META-INF所有RSA文件），增加PackageManager兜底方案
+ */
+public class ApkSignUtils {
+    // ===================================== 全局常量定义 =====================================
+    private static final String TAG = "ApkSignUtils";
+    // 加密算法常量
+    private static final String ALGORITHM_SHA1 = "SHA1";
+    private static final String ALGORITHM_SHA256 = "SHA-256";
+    // 缓冲区大小常量（按业务场景区分）
+    private static final int BUFFER_4K = 4096;
+    private static final int BUFFER_8K = 8192;
+    // 签名文件目录与后缀
+    private static final String META_INF_DIR = "META-INF/";
+    private static final String RSA_SUFFIX_UPPER = ".RSA";
+    private static final String RSA_SUFFIX_LOWER = ".rsa";
+
+    // ===================================== 对外核心方法 =====================================
+    /**
+     * 获取与服务端对齐的签名Base64串（兼容MT重签名）
+     * 优先逻辑：遍历APK内META-INF所有.RSA文件 → 读取第一个有效文件原始字节 → SHA1摘要 → Base64.NO_WRAP
+     * 兜底逻辑：PackageManager获取系统解析的签名 → SHA1摘要 → Base64.NO_WRAP
+     * @param context 上下文，用于获取当前应用APK路径/包信息
+     * @return 签名Base64字符串，任意步骤失败返回null
+     */
+    public static String getApkSignAlignedWithServer(Context context) {
+        LogUtils.d(TAG, "getApkSignAlignedWithServer: 方法调用，开始执行服务端对齐签名计算（兼容MT重签名）");
+        // 入参空值快速校验
+        if (context == null) {
+            LogUtils.w(TAG, "getApkSignAlignedWithServer: 入参context为null，直接返回null");
+            return null;
+        }
+
+        // 方案1：优先读取APK内META-INF目录下所有RSA文件（兼容MT重签名任意命名）
+        String signBase64 = getSignFromApkRsaFile(context);
+        if (signBase64 != null) {
+            LogUtils.d(TAG, "getApkSignAlignedWithServer: 方案1成功（APK内读取RSA文件），返回签名Base64");
+            return signBase64;
+        }
+
+        // 方案2：兜底 - PackageManager获取系统解析的应用签名（避免APK文件读取失败）
+        signBase64 = getSignFromPackageManager(context);
+        if (signBase64 != null) {
+            LogUtils.d(TAG, "getApkSignAlignedWithServer: 方案2成功（PackageManager兜底），返回签名Base64");
+            return signBase64;
+        }
+
+        // 所有方案失败
+        LogUtils.e(TAG, "getApkSignAlignedWithServer: 所有签名获取方案均失败");
+        return null;
+    }
+
+    /**
+     * 获取当前运行APK的SHA256哈希值（兼容重签名APK）
+     * 逻辑：读取APK完整文件字节流 → SHA256摘要 → 转小写64位16进制字符串，服务端同款校验逻辑
+     * @param context 上下文，用于获取当前应用APK的真实安装路径
+     * @return SHA256小写16进制字符串，任意步骤失败返回null
+     */
+    public static String getApkSHA256Hash(Context context) {
+        LogUtils.d(TAG, "getApkSHA256Hash: 方法调用，开始执行APK文件SHA256哈希计算");
+        // 入参空值快速校验
+        if (context == null) {
+            LogUtils.w(TAG, "getApkSHA256Hash: 入参context为null，直接返回null");
+            return null;
+        }
+
+        JarFile jarFile = null;
+        FileInputStream fis = null;
+        try {
+            // 1. 获取当前应用APK真实路径
+            ApplicationInfo appInfo = context.getApplicationContext().getApplicationInfo();
+            String apkPath = appInfo.sourceDir;
+            LogUtils.d(TAG, "getApkSHA256Hash: 成功获取APK路径，path=" + apkPath);
+            if (apkPath == null || apkPath.trim().isEmpty()) {
+                LogUtils.e(TAG, "getApkSHA256Hash: 获取到的APK路径为空，无法读取文件计算哈希");
+                return null;
+            }
+
+            // 2. 读取APK文件并计算SHA256哈希（完善流关闭）
+            File apkFile = new File(apkPath);
+            MessageDigest md = MessageDigest.getInstance(ALGORITHM_SHA256);
+            fis = new FileInputStream(apkFile);
+            byte[] buffer = new byte[BUFFER_8K];
+            int readLen;
+            while ((readLen = fis.read(buffer)) != -1) {
+                md.update(buffer, 0, readLen);
+            }
+            LogUtils.d(TAG, "getApkSHA256Hash: APK文件读取完成，开始转换哈希结果");
+
+            // 3. 哈希字节数组转小写64位16进制字符串
+            byte[] hashBytes = md.digest();
+            StringBuilder sb = new StringBuilder();
+            for (byte b : hashBytes) {
+                sb.append(String.format("%02x", b));
+            }
+            String sha256Hash = sb.toString();
+            LogUtils.d(TAG, "getApkSHA256Hash: APK SHA256哈希计算完成，成功返回结果");
+            return sha256Hash;
+
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "getApkSHA256Hash: 获取SHA-256算法实例失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getApkSHA256Hash: 计算APK SHA256哈希发生未知异常", e);
+        } finally {
+            // 强制关闭流，避免重签名APK解析的流泄漏
+            try {
+                if (fis != null) fis.close();
+                if (jarFile != null) jarFile.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "getApkSHA256Hash: 关闭流资源异常", e);
+            }
+        }
+        return null;
+    }
+
+    // ===================================== 内部核心工具方法（兼容重签名） =====================================
+    /**
+     * 方案1：遍历APK内META-INF所有.RSA/.rsa文件，读取第一个有效文件计算签名
+     * @param context 上下文
+     * @return 签名Base64，失败返回null
+     */
+    private static String getSignFromApkRsaFile(Context context) {
+        JarFile jarFile = null;
+        InputStream is = null;
+        try {
+            // 获取APK路径
+            ApplicationInfo appInfo = context.getApplicationContext().getApplicationInfo();
+            String apkPath = appInfo.sourceDir;
+            if (apkPath == null || apkPath.trim().isEmpty()) {
+                LogUtils.w(TAG, "getSignFromApkRsaFile: APK路径为空，跳过该方案");
+                return null;
+            }
+
+            // 打开APK的JarFile
+            jarFile = new JarFile(apkPath);
+            Enumeration<JarEntry> entries = jarFile.entries();
+            JarEntry targetRsaEntry = null;
+
+            // 遍历所有条目，找到META-INF下第一个.RSA/.rsa文件
+            while (entries.hasMoreElements()) {
+                JarEntry entry = entries.nextElement();
+                String entryName = entry.getName();
+                // 过滤：META-INF目录下 + 以.RSA/.rsa结尾 + 非目录
+                if (entryName.startsWith(META_INF_DIR) && !entry.isDirectory()
+					&& (entryName.endsWith(RSA_SUFFIX_UPPER) || entryName.endsWith(RSA_SUFFIX_LOWER))) {
+                    targetRsaEntry = entry;
+                    LogUtils.d(TAG, "getSignFromApkRsaFile: 找到有效签名文件，name=" + entryName);
+                    break; // 取第一个有效RSA文件即可
+                }
+            }
+
+            // 未找到任何RSA文件
+            if (targetRsaEntry == null) {
+                LogUtils.w(TAG, "getSignFromApkRsaFile: 未在META-INF找到任何.RSA/.rsa签名文件");
+                return null;
+            }
+
+            // 读取RSA文件原始字节
+            is = jarFile.getInputStream(targetRsaEntry);
+            byte[] certRawBytes = readStreamToBytes(is);
+            if (certRawBytes == null || certRawBytes.length == 0) {
+                LogUtils.w(TAG, "getSignFromApkRsaFile: 读取RSA文件字节为空");
+                return null;
+            }
+
+            // 计算SHA1+Base64
+            MessageDigest md = MessageDigest.getInstance(ALGORITHM_SHA1);
+            byte[] signDigest = md.digest(certRawBytes);
+            return Base64.encodeToString(signDigest, Base64.NO_WRAP);
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getSignFromApkRsaFile: 从APK内读取RSA文件失败", e);
+            return null;
+        } finally {
+            // 强制关闭所有流
+            try {
+                if (is != null) is.close();
+                if (jarFile != null) jarFile.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "getSignFromApkRsaFile: 关闭流资源异常", e);
+            }
+        }
+    }
+
+    /**
+     * 方案2：兜底 - 通过PackageManager获取系统解析的应用签名
+     * 避免APK文件读取失败（如权限、解析问题），兼容所有重签名场景
+     * @param context 上下文
+     * @return 签名Base64，失败返回null
+     */
+    private static String getSignFromPackageManager(Context context) {
+        try {
+            // 获取当前应用包信息（包含签名）
+            PackageInfo packageInfo = context.getPackageManager()
+				.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);
+            if (packageInfo == null || packageInfo.signatures == null || packageInfo.signatures.length == 0) {
+                LogUtils.w(TAG, "getSignFromPackageManager: 未获取到应用签名信息");
+                return null;
+            }
+
+            // 取第一个签名（重签名后一般只有一个签名）
+            Signature signature = packageInfo.signatures[0];
+            byte[] signBytes = signature.toByteArray();
+
+            // 计算SHA1+Base64，与服务端逻辑对齐
+            MessageDigest md = MessageDigest.getInstance(ALGORITHM_SHA1);
+            byte[] signDigest = md.digest(signBytes);
+            return Base64.encodeToString(signDigest, Base64.NO_WRAP);
+
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "getSignFromPackageManager: 包名未找到，无法获取签名", e);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "getSignFromPackageManager: 获取SHA1算法实例失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getSignFromPackageManager: PackageManager获取签名失败", e);
+        }
+        return null;
+    }
+
+    /**
+     * 输入流转字节数组，通用工具方法（完善try-finally）
+     * 4K缓冲区，适配小文件读取（如RSA签名文件），保证流资源正常关闭
+     * @param is 待读取的输入流
+     * @return 转换后的字节数组，流为null/读取失败返回空字节数组
+     * @throws IOException 流读取相关异常向上抛出
+     */
+    private static byte[] readStreamToBytes(InputStream is) throws IOException {
+        if (is == null) {
+            LogUtils.w(TAG, "readStreamToBytes: 入参输入流为null，返回空字节数组");
+            return new byte[0];
+        }
+        ByteArrayOutputStream bos = new ByteArrayOutputStream();
+        byte[] buffer = new byte[BUFFER_4K];
+        int readLen;
+        try {
+            while ((readLen = is.read(buffer)) != -1) {
+                bos.write(buffer, 0, readLen);
+            }
+            return bos.toByteArray();
+        } finally {
+            // 强制关闭所有流
+            is.close();
+            bos.close();
+        }
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/BackupUtils.java

@@ -0,0 +1,305 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.os.Environment;
+import android.text.TextUtils;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.zip.ZipEntry;
+import java.util.zip.ZipOutputStream;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.SFTPAuthModel;
+
+/**
+ * 文件备份工具类（单例模式）
+ * 区分应用Data目录/应用专属外部文件目录双Map管理备份文件路径
+ * 核心功能：文件添加/移除 + ZIP打包（分data/sdcard目录） + SFTP分步式上传（登录→传输→登出）
+ * 依赖：FTPUtils（单例）、SFTPAuthModel（外部实体类）、Android上下文
+ * 兼容：Java7、Android 6.0+，无第三方依赖（ZIP为原生实现），免动态读写权限
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/30 20:18:00
+ * @LastEditTime 2026/02/01 02:05:00
+ */
+public class BackupUtils {
+    public static final String TAG = "BackupUtils";
+    // ZIP内部分级目录常量（统一维护，便于修改）
+    private static final String ZIP_DIR_DATA = "data/";
+    private static final String ZIP_DIR_SDCARD = "sdcard/";
+
+    // 单例实例（双重校验锁，volatile保证可见性，线程安全）
+    private static volatile BackupUtils sInstance;
+
+    // 双Map分目录管理：key=文件唯一标识，value=对应目录下的相对路径
+    private final Map<String, String> mDataDirFileMap; // 基础根目录：应用私有Data目录(/data/data/[包名]/files)
+    private final Map<String, String> mSdcardFileMap; // 基础根目录：应用专属外部文件目录(/storage/emulated/0/Android/data/[包名]/files)
+
+    // 全局上下文（持有Application上下文，避免Activity内存泄漏）
+    private Context mAppContext;
+    // SFTP认证配置（直接引用外部实体类，无内部封装）
+    private SFTPAuthModel mFtpAuthModel;
+    // SFTP服务器指定上传目录（独立参数传入，标准化后作为成员变量）
+    private String mFtpTargetDir;
+    // 应用专属外部文件目录（SDCard Map的基础根目录，初始化时赋值，避免重复创建）
+    private File mAppExternalFilesDir;
+
+    // 私有构造器：新增双Map入参，空值则使用内部默认初始化，非空则用入参初始化
+    private BackupUtils(Context context, SFTPAuthModel ftpAuthModel, String ftpTargetDir,
+                        Map<String, String> dataDirFileMap, Map<String, String> sdcardFileMap) {
+        this.mAppContext = context.getApplicationContext();
+        this.mFtpAuthModel = ftpAuthModel;
+        // 初始化SDCard Map的基础根目录：应用专属外部文件目录（/storage/emulated/0/Android/data/[包名]/files）
+        this.mAppExternalFilesDir = mAppContext.getExternalFilesDir(null);
+        // 标准化SFTP上传目录：空则默认/，非空则补全结尾斜杠
+        this.mFtpTargetDir = TextUtils.isEmpty(ftpTargetDir) ? "/" : (ftpTargetDir.endsWith("/") ? ftpTargetDir : ftpTargetDir + "/");
+
+        // 核心修改：入参Map非空且非空集合时，使用入参初始化；否则内部new HashMap()
+        this.mDataDirFileMap = (dataDirFileMap != null && !dataDirFileMap.isEmpty()) 
+			? new HashMap<>(dataDirFileMap) // 新建Map避免外部篡改内部数据
+			: new HashMap<>();
+        this.mSdcardFileMap = (sdcardFileMap != null && !sdcardFileMap.isEmpty())
+			? new HashMap<>(sdcardFileMap) // 深拷贝，隔离外部引用
+			: new HashMap<>();
+
+        LogUtils.d(TAG, "BackupUtils初始化完成 → SFTP服务器：" + ftpAuthModel.getFtpServer() + ":" + ftpAuthModel.getFtpPort() + " | 上传目录：" + mFtpTargetDir);
+        LogUtils.d(TAG, "SDCard Map基础根目录：" + (mAppExternalFilesDir == null ? "获取失败" : mAppExternalFilesDir.getAbsolutePath()));
+        LogUtils.d(TAG, "初始化后DataMap大小：" + mDataDirFileMap.size() + " | SdcardMap大小：" + mSdcardFileMap.size());
+    }
+
+    /**
+     * 单例初始化方法（必须先调用，否则getInstance()会抛异常）
+     * 新增双Map入参，支持外部初始化待备份文件列表
+     * @param context 上下文（推荐传Application，避免内存泄漏）
+     * @param ftpAuthModel 外部SFTP认证实体类（含服务器/账号/端口等）
+     * @param ftpTargetDir SFTP服务器指定上传目录（如/backup，自动补全斜杠）
+     * @param dataDirFileMap 外部传入的Data目录文件Map，null/空则内部默认初始化
+     * @param sdcardFileMap 外部传入的SDCard目录文件Map，null/空则内部默认初始化
+     * @return BackupUtils单例实例
+     */
+    public static BackupUtils getInstance(Context context, SFTPAuthModel ftpAuthModel, String ftpTargetDir,
+                                          Map<String, String> dataDirFileMap, Map<String, String> sdcardFileMap) {
+        if (sInstance == null) {
+            synchronized (BackupUtils.class) {
+                if (sInstance == null) {
+                    // 前置强校验：避免空参数导致后续空指针
+                    if (context == null) {
+                        throw new IllegalArgumentException("初始化失败：Context 不能为空");
+                    }
+                    if (ftpAuthModel == null || TextUtils.isEmpty(ftpAuthModel.getFtpServer())) {
+                        throw new IllegalArgumentException("初始化失败：SFTPAuthModel/ftpServer 不能为空");
+                    }
+                    // 透传新增的双Map入参至构造器
+                    sInstance = new BackupUtils(context, ftpAuthModel, ftpTargetDir, dataDirFileMap, sdcardFileMap);
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    /**
+     * 重载默认初始化方法：兼容原有调用逻辑，无需传入Map，内部默认初始化
+     * 避免修改后影响原有代码调用
+     */
+    public static BackupUtils getInstance(Context context, SFTPAuthModel ftpAuthModel, String ftpTargetDir) {
+        return getInstance(context, ftpAuthModel, ftpTargetDir, null, null);
+    }
+
+    /**
+     * 获取单例实例（需先调用带参getInstance初始化）
+     * @return BackupUtils单例实例
+     */
+    public static BackupUtils getInstance() {
+        if (sInstance == null) {
+            throw new IllegalStateException("BackupUtils未初始化，请先调用getInstance(Context, SFTPAuthModel, String[, Map, Map])");
+        }
+        return sInstance;
+    }
+
+    // ====================================== 以下原有方法均未修改 ======================================
+    public void addDataDirFile(String key, String relativePath) {
+        if (!TextUtils.isEmpty(key) && !TextUtils.isEmpty(relativePath)) {
+            mDataDirFileMap.put(key, relativePath);
+            LogUtils.d(TAG, "添加Data目录文件：" + key + " → " + relativePath);
+        }
+    }
+
+    public void removeDataDirFile(String key) {
+        if (!TextUtils.isEmpty(key) && mDataDirFileMap.containsKey(key)) {
+            mDataDirFileMap.remove(key);
+            LogUtils.d(TAG, "移除Data目录文件：" + key);
+        }
+    }
+
+    public String getDataDirFile(String key) {
+        return mDataDirFileMap.get(key);
+    }
+
+    public Map<String, String> getAllDataDirFiles() {
+        return new HashMap<>(mDataDirFileMap);
+    }
+
+    public void clearDataDirFiles() {
+        mDataDirFileMap.clear();
+        LogUtils.d(TAG, "清空Data目录所有备份文件");
+    }
+
+    public void addSdcardFile(String key, String relativePath) {
+        if (!TextUtils.isEmpty(key) && !TextUtils.isEmpty(relativePath) && mAppExternalFilesDir != null) {
+            mSdcardFileMap.put(key, relativePath);
+            LogUtils.d(TAG, "添加外部文件目录文件：" + key + " → " + relativePath);
+        }
+    }
+
+    public void removeSdcardFile(String key) {
+        if (!TextUtils.isEmpty(key) && mSdcardFileMap.containsKey(key)) {
+            mSdcardFileMap.remove(key);
+            LogUtils.d(TAG, "移除外部文件目录文件：" + key);
+        }
+    }
+
+    public String getSdcardFile(String key) {
+        return mSdcardFileMap.get(key);
+    }
+
+    public Map<String, String> getAllSdcardFiles() {
+        return new HashMap<>(mSdcardFileMap);
+    }
+
+    public void clearSdcardFiles() {
+        mSdcardFileMap.clear();
+        LogUtils.d(TAG, "清空外部文件目录所有备份文件");
+    }
+
+    public boolean packAndUploadByFtp() {
+        if (mDataDirFileMap.isEmpty() && mSdcardFileMap.isEmpty()) {
+            LogUtils.e(TAG, "SFTP上传失败：无待备份文件（DataDir+外部文件目录均为空）");
+            return false;
+        }
+        if (mAppExternalFilesDir == null) {
+            LogUtils.e(TAG, "SFTP上传失败：应用专属外部文件目录获取失败，无法访问文件");
+            return false;
+        }
+
+        String zipFileName = UUID.randomUUID().toString().replace("-", "")
+			+ "-" + System.currentTimeMillis() + ".zip";
+        File tempZipFile = new File(mAppContext.getExternalCacheDir(), zipFileName);
+        String remoteFtpFilePath = mFtpTargetDir + zipFileName;
+
+        FTPUtils ftpUtils = FTPUtils.getInstance();
+        boolean isUploadSuccess = false;
+
+        try {
+            LogUtils.d(TAG, "开始SFTP登录：" + mFtpAuthModel.getFtpServer() + ":" + mFtpAuthModel.getFtpPort());
+            boolean isFtpLogin = ftpUtils.login(mFtpAuthModel);
+            if (!isFtpLogin) {
+                LogUtils.e(TAG, "SFTP上传失败：SFTP登录失败（账号/密码/服务器/端口错误）");
+                return false;
+            }
+            LogUtils.i(TAG, "SFTP登录成功，准备打包文件：" + zipFileName);
+
+            LogUtils.d(TAG, "开始本地ZIP打包（分data/sdcard目录），临时文件路径：" + tempZipFile.getAbsolutePath());
+            boolean isPackSuccess = packFilesToZip(tempZipFile);
+            if (!isPackSuccess || !tempZipFile.exists() || tempZipFile.length() == 0) {
+                LogUtils.e(TAG, "SFTP上传失败：ZIP打包失败（文件不存在/空文件）");
+                return false;
+            }
+            LogUtils.i(TAG, "ZIP打包成功，文件大小：" + tempZipFile.length() / 1024 + "KB");
+
+            LogUtils.d(TAG, "开始SFTP上传：本地→SFTP" + remoteFtpFilePath);
+            isUploadSuccess = ftpUtils.uploadFile(tempZipFile.getAbsolutePath(), remoteFtpFilePath);
+            if (isUploadSuccess) {
+                LogUtils.i(TAG, "SFTP上传全流程成功：" + remoteFtpFilePath);
+            } else {
+                LogUtils.e(TAG, "SFTP上传失败：文件传输到服务器失败（响应码异常/权限不足）");
+            }
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "SFTP上传异常：" + e.getMessage(), e);
+            isUploadSuccess = false;
+        } finally {
+            if (ftpUtils.isConnected()) {
+                ftpUtils.logout();
+            }
+            ftpUtils.disconnect();
+            if (tempZipFile.exists()) {
+                boolean isDelete = tempZipFile.delete();
+                LogUtils.d(TAG, "本地临时ZIP文件删除：" + (isDelete ? "成功" : "失败"));
+            }
+            System.gc();
+        }
+
+        return isUploadSuccess;
+    }
+
+    private boolean packFilesToZip(File zipFile) {
+        ZipOutputStream zos = null;
+        try {
+            zos = new ZipOutputStream(new FileOutputStream(zipFile), Charset.forName("UTF-8"));
+            zos.setLevel(ZipOutputStream.DEFLATED);
+
+            if (!mDataDirFileMap.isEmpty()) {
+                packDirFilesToZip(zos, mDataDirFileMap, mAppContext.getFilesDir(), ZIP_DIR_DATA);
+                LogUtils.d(TAG, "Data目录文件已打包到ZIP→" + ZIP_DIR_DATA + "子目录");
+            }
+            if (!mSdcardFileMap.isEmpty() && mAppExternalFilesDir != null) {
+                packDirFilesToZip(zos, mSdcardFileMap, mAppExternalFilesDir, ZIP_DIR_SDCARD);
+                LogUtils.d(TAG, "应用专属外部文件目录文件已打包到ZIP→" + ZIP_DIR_SDCARD + "子目录");
+            }
+
+            zos.flush();
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "ZIP打包IO异常：" + e.getMessage(), e);
+            return false;
+        } finally {
+            if (zos != null) {
+                try {
+                    zos.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "关闭ZIP流异常：" + e.getMessage(), e);
+                }
+            }
+        }
+    }
+
+    private void packDirFilesToZip(ZipOutputStream zos, Map<String, String> fileMap, File baseDir, String zipSubDir) {
+        for (Map.Entry<String, String> entry : fileMap.entrySet()) {
+            String relativePath = entry.getValue();
+            if (TextUtils.isEmpty(relativePath)) {
+                continue;
+            }
+            File localFile = new File(baseDir, relativePath);
+            if (!localFile.exists() || !localFile.isFile()) {
+                LogUtils.w(TAG, "跳过无效文件：" + localFile.getAbsolutePath());
+                continue;
+            }
+            String zipInnerPath = zipSubDir + relativePath;
+            try {
+                addSingleFileToZip(zos, localFile, zipInnerPath);
+            } catch (IOException e) {
+                LogUtils.e(TAG, "打包单个文件失败：" + zipInnerPath, e);
+            }
+        }
+    }
+
+    private void addSingleFileToZip(ZipOutputStream zos, File localFile, String zipInnerPath) throws IOException {
+        ZipEntry zipEntry = new ZipEntry(zipInnerPath);
+        zos.putNextEntry(zipEntry);
+        FileInputStream fis = new FileInputStream(localFile);
+        byte[] buffer = new byte[4096];
+        int len;
+        while ((len = fis.read(buffer)) != -1) {
+            zos.write(buffer, 0, len);
+        }
+        fis.close();
+        zos.closeEntry();
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/CrashHandleNotifyUtils.java

@@ -0,0 +1,264 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.app.Application;
+import android.app.Notification;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Build;
+import android.text.TextUtils;
+
+import cc.winboll.studio.libappbase.CrashHandler;
+import cc.winboll.studio.libappbase.GlobalCrashActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/29 21:12
+ * @Describe 应用崩溃处理通知实用工具集（类库兼容版）
+ * 核心功能：作为独立类库使用，发送崩溃通知，点击跳转宿主应用的 GlobalCrashActivity 并传递日志
+ * 适配说明：移除固定包名依赖，通过外部传入宿主包名，支持任意应用集成使用
+ */
+public class CrashHandleNotifyUtils {
+
+    public static final String TAG = "CrashHandleNotifyUtils";
+
+    /** 通知渠道ID（Android 8.0+ 必须） */
+    private static final String CRASH_NOTIFY_CHANNEL_ID = "crash_notify_channel";
+    /** 通知渠道名称（用户可见） */
+    private static final String CRASH_NOTIFY_CHANNEL_NAME = "应用崩溃通知";
+    /** 通知ID（唯一） */
+    public static final int CRASH_NOTIFY_ID = 0x001;
+    /** Android 12 对应 API 版本号（31） */
+    private static final int API_LEVEL_ANDROID_12 = 31;
+    /** PendingIntent.FLAG_IMMUTABLE 常量值（API 31+） */
+    private static final int FLAG_IMMUTABLE = 0x00000040;
+
+    /** 通知内容最大行数（控制在3行，超出部分省略） */
+    private static final int NOTIFICATION_MAX_LINES = 3;
+
+
+    /**
+     * 处理未捕获异常（核心方法，类库入口）
+     * 改进点：新增宿主包名参数，移除类库对固定包名的依赖
+     * @param hostApp 宿主应用的 Application 实例（用于获取宿主上下文）
+     * @param hostPackageName 宿主应用的包名（关键：用于绑定意图、匹配 Activity）
+     * @param errorLog 崩溃日志（从宿主 CrashHandler 传递过来）
+     */
+    public static void handleUncaughtException(Application hostApp, String hostPackageName, String errorLog) {
+        // 1. 校验核心参数（类库场景必须严格校验，避免空指针）
+        if (hostApp == null || TextUtils.isEmpty(hostPackageName) || TextUtils.isEmpty(errorLog)) {
+            LogUtils.e(TAG, "发送崩溃通知失败：参数为空（hostApp=" + hostApp + ", hostPackageName=" + hostPackageName + ", errorLog=" + errorLog + "）");
+            return;
+        }
+
+        // 2. 获取宿主应用名称（使用宿主上下文，避免类库包名混淆）
+        String hostAppName = getHostAppName(hostApp, hostPackageName);
+
+        // 3. 发送崩溃通知到宿主通知栏（点击跳转宿主的 GlobalCrashActivity）
+        sendCrashNotification(hostApp, hostPackageName, hostAppName, errorLog);
+    }
+
+    /**
+     * 重载方法：兼容原有调用逻辑（避免宿主集成时改动过大）
+     * 从 Intent 中提取崩溃日志和宿主包名，适配原有 CrashHandler 调用方式
+     * @param hostApp 宿主应用的 Application 实例
+     * @param intent 存储崩溃信息的意图（extra 中携带崩溃日志）
+     */
+    public static void handleUncaughtException(Application hostApp, Intent intent) {
+        // 从意图中提取宿主包名（优先使用意图中携带的包名，无则用宿主 Application 包名）
+        String hostPackageName = intent.getStringExtra("EXTRA_HOST_PACKAGE_NAME");
+        if (TextUtils.isEmpty(hostPackageName)) {
+            hostPackageName = hostApp.getPackageName();
+            LogUtils.w(TAG, "意图中未携带宿主包名，使用 Application 包名：" + hostPackageName);
+        }
+
+        // 从意图中提取崩溃日志（与 CrashHandler.EXTRA_CRASH_INFO 保持一致）
+        String errorLog = intent.getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
+
+        // 调用核心方法处理
+        handleUncaughtException(hostApp, hostPackageName, errorLog);
+    }
+
+    /**
+     * 获取宿主应用名称（类库场景适配：使用宿主包名获取，避免类库包名干扰）
+     * @param hostContext 宿主应用的上下文（Application 实例）
+     * @param hostPackageName 宿主应用的包名
+     * @return 宿主应用名称（读取失败返回 "未知应用"）
+     */
+    private static String getHostAppName(Context hostContext, String hostPackageName) {
+        try {
+            // 用宿主包名获取宿主应用信息，确保获取的是宿主的应用名称（类库关键改进）
+            return hostContext.getPackageManager().getApplicationLabel(
+                hostContext.getPackageManager().getApplicationInfo(hostPackageName, 0)
+            ).toString();
+        } catch (Exception e) {
+            LogUtils.e(TAG, "获取宿主应用名称失败（包名：" + hostPackageName + "）", e);
+            return "未知应用";
+        }
+    }
+
+    /**
+     * 发送崩溃通知到宿主系统通知栏（类库兼容版）
+     * 改进点：全程使用宿主上下文和宿主包名，避免类库包名依赖
+     * @param hostContext 宿主应用的上下文（Application 实例）
+     * @param hostPackageName 宿主应用的包名
+     * @param hostAppName 宿主应用的名称（用于通知标题）
+     * @param errorLog 崩溃日志（传递给宿主的 GlobalCrashActivity）
+     */
+    private static void sendCrashNotification(Context hostContext, String hostPackageName, String hostAppName, String errorLog) {
+        // 1. 获取宿主的通知管理器（使用宿主上下文，确保通知归属宿主应用）
+        NotificationManager notificationManager = (NotificationManager) hostContext.getSystemService(Context.NOTIFICATION_SERVICE);
+        if (notificationManager == null) {
+            LogUtils.e(TAG, "获取宿主 NotificationManager 失败（包名：" + hostPackageName + "）");
+            return;
+        }
+
+        // 2. 适配 Android 8.0+（API 26+）：创建宿主的通知渠道（归属宿主，避免类库渠道冲突）
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            createCrashNotifyChannel(hostContext, notificationManager);
+        }
+
+        // 3. 构建通知意图（核心改进：绑定宿主包名，跳转宿主的 GlobalCrashActivity）
+        PendingIntent jumpIntent = getGlobalCrashPendingIntent(hostContext, hostPackageName, errorLog);
+        if (jumpIntent == null) {
+            LogUtils.e(TAG, "构建跳转意图失败（宿主包名：" + hostPackageName + "）");
+            return;
+        }
+
+        // 4. 构建通知实例（使用宿主上下文，确保通知资源归属宿主）
+        Notification notification = buildNotification(hostContext, hostAppName, errorLog, jumpIntent);
+
+        // 5. 发送通知（归属宿主应用，避免类库与宿主通知混淆）
+        notificationManager.notify(CRASH_NOTIFY_ID, notification);
+        LogUtils.d(TAG, "崩溃通知发送成功（宿主包名：" + hostPackageName + "，标题：" + hostAppName + "，日志长度：" + errorLog.length() + "字符）");
+    }
+
+    /**
+     * 创建宿主应用的崩溃通知渠道（类库场景：渠道归属宿主，避免类库与宿主渠道冲突）
+     * @param hostContext 宿主应用的上下文
+     * @param notificationManager 宿主的通知管理器
+     */
+    private static void createCrashNotifyChannel(Context hostContext, NotificationManager notificationManager) {
+        // 仅 Android 8.0+ 执行（避免低版本报错）
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            // 构建通知渠道（归属宿主应用，描述明确类库用途）
+            android.app.NotificationChannel channel = new android.app.NotificationChannel(
+                CRASH_NOTIFY_CHANNEL_ID,
+                CRASH_NOTIFY_CHANNEL_NAME,
+                NotificationManager.IMPORTANCE_DEFAULT
+            );
+            channel.setDescription("应用崩溃通知（由 WinBoLL Studio 类库提供，点击查看详情）");
+            // 注册渠道到宿主的通知管理器，确保渠道归属宿主
+            notificationManager.createNotificationChannel(channel);
+            LogUtils.d(TAG, "宿主崩溃通知渠道创建成功（宿主包名：" + hostContext.getPackageName() + "，渠道ID：" + CRASH_NOTIFY_CHANNEL_ID + "）");
+        }
+    }
+
+    /**
+     * 核心改进：构建跳转宿主 GlobalCrashActivity 的意图（类库关键）
+     * 1. 绑定宿主包名，确保类库能正确启动宿主的 Activity；
+     * 2. 传递崩溃日志，与宿主 GlobalCrashActivity 日志接收逻辑匹配；
+     * 3. 使用宿主上下文，避免类库上下文导致的适配问题。
+     * @param hostContext 宿主应用的上下文
+     * @param hostPackageName 宿主应用的包名
+     * @param errorLog 崩溃日志（传递给宿主的 GlobalCrashActivity）
+     * @return 跳转崩溃详情页的 PendingIntent
+     */
+    private static PendingIntent getGlobalCrashPendingIntent(Context hostContext, String hostPackageName, String errorLog) {
+        try {
+            // 1. 构建跳转宿主 GlobalCrashActivity 的显式意图（类库场景必须显式指定宿主包名）
+            Intent crashIntent = new Intent(hostContext, GlobalCrashActivity.class);
+            // 关键：绑定宿主包名，确保意图能正确匹配宿主的 Activity（避免类库包名干扰）
+            crashIntent.setPackage(hostPackageName);
+            // 传递崩溃日志（键：EXTRA_CRASH_INFO，与宿主 GlobalCrashActivity 完全匹配）
+            crashIntent.putExtra(CrashHandler.EXTRA_CRASH_LOG, errorLog);
+            // 设置意图标志：确保在宿主应用中正常启动，避免重复创建和任务栈混乱
+            crashIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+            // 2. 构建 PendingIntent（使用宿主上下文，适配高版本）
+            int flags = PendingIntent.FLAG_UPDATE_CURRENT;
+            if (Build.VERSION.SDK_INT >= API_LEVEL_ANDROID_12) {
+                flags |= FLAG_IMMUTABLE;
+            }
+
+            return PendingIntent.getActivity(
+                hostContext,
+                CRASH_NOTIFY_ID, // 用通知ID作为请求码，确保唯一（避免意图复用）
+                crashIntent,
+                flags
+            );
+        } catch (Exception e) {
+            LogUtils.e(TAG, "构建跳转意图失败（宿主包名：" + hostPackageName + "）", e);
+            return null;
+        }
+    }
+
+    /**
+     * 构建通知实例（类库兼容版）
+     * 改进点：使用宿主上下文加载资源，确保通知样式适配宿主应用
+     * @param hostContext 宿主应用的上下文
+     * @param hostAppName 宿主应用的名称（通知标题）
+     * @param errorLog 崩溃日志（通知内容）
+     * @param jumpIntent 通知点击跳转意图（跳转宿主的 GlobalCrashActivity）
+     * @return 构建完成的 Notification 对象
+     */
+    private static Notification buildNotification(Context hostContext, String hostAppName, String errorLog, PendingIntent jumpIntent) {
+        // 兼容 Android 8.0+：指定宿主的通知渠道ID
+        Notification.Builder builder = new Notification.Builder(hostContext);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            builder.setChannelId(CRASH_NOTIFY_CHANNEL_ID);
+        }
+
+        // 核心：用BigTextStyle控制“默认3行省略，下拉显示完整”（使用宿主上下文构建）
+        Notification.BigTextStyle bigTextStyle = new Notification.BigTextStyle();
+        bigTextStyle.setSummaryText("日志已省略，下拉查看完整内容");
+        bigTextStyle.bigText(errorLog);
+        bigTextStyle.setBigContentTitle(hostAppName + " 崩溃"); // 标题明确标识宿主和崩溃状态
+        builder.setStyle(bigTextStyle);
+
+        // 配置通知核心参数（全程使用宿主上下文，确保资源归属宿主）
+        builder
+            // 关键：使用宿主应用的小图标（避免类库图标显示异常）
+            .setSmallIcon(hostContext.getApplicationInfo().icon)
+            .setContentTitle(hostAppName + " 崩溃")
+            .setContentText(getShortContent(errorLog)) // 3行内缩略文本
+            .setContentIntent(jumpIntent) // 点击跳转宿主的 GlobalCrashActivity
+            .setAutoCancel(true) // 点击后自动关闭
+            .setWhen(System.currentTimeMillis())
+            .setPriority(Notification.PRIORITY_DEFAULT);
+
+        // 适配 Android 4.1+：确保在宿主应用中正常显示
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+            return builder.build();
+        } else {
+            return builder.getNotification();
+        }
+    }
+
+    /**
+     * 辅助方法：截取日志文本，确保显示在3行内（通用逻辑，无包名依赖）
+     * @param content 完整崩溃日志
+     * @return 3行内的缩略文本
+     */
+    private static String getShortContent(String content) {
+        if (content == null || content.isEmpty()) {
+            return "无崩溃日志";
+        }
+        int maxLength = 80; // 估算3行字符数（可根据需求调整）
+        return content.length() <= maxLength ? content : content.substring(0, maxLength) + "...";
+    }
+
+    /**
+     * 释放资源（类库场景：空实现，避免宿主调用时报错，预留扩展）
+     * @param hostContext 宿主应用的上下文（显式传入，避免类库上下文依赖）
+     */
+    public static void release(Context hostContext) {
+        LogUtils.d(TAG, "CrashHandleNotifyUtils 资源释放完成（宿主包名：" + (hostContext != null ? hostContext.getPackageName() : "未知") + "）");
+    }
+}

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/FTPUtils.java

@@ -0,0 +1,487 @@
+package cc.winboll.studio.libappbase.utils;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.SFTPAuthModel;
+import com.jcraft.jsch.ChannelSftp;
+import com.jcraft.jsch.JSch;
+import com.jcraft.jsch.JSchException;
+import com.jcraft.jsch.Session;
+import com.jcraft.jsch.SftpATTRS;
+import com.jcraft.jsch.SftpException;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.util.Properties;
+import java.util.Vector;
+
+/**
+ * SFTP/FTP工具类（单例模式）- Java7兼容 · 适配FTPAuthModel实体类
+ * 底层严格基于JSch 0.1.54原生ChannelSftp+SftpException接口实现，替换原commons-net FTP
+ * 核心功能：登录/登出、文件上传/下载、文件夹列举、文件/文件夹存在性判断
+ * 依赖：com.jcraft:jsch:0.1.54
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/30 19:04
+ */
+public class FTPUtils {
+    // 单例实例（双重校验锁 volatile 保证可见性，Java7兼容）
+    private static volatile FTPUtils sInstance;
+    // JSch核心对象：Session（连接会话）、ChannelSftp（SFTP通道）
+    private JSch mJSch;
+    private Session mSession;
+    private ChannelSftp mSftpChannel;
+    // 日志TAG
+    public static final String TAG = "FTPUtils";
+    // SFTP默认端口（FTPAuthModel未设置时使用）
+    private static final int DEFAULT_SFTP_PORT = 22;
+    // 连接超时时间 5s（Java7原生Socket超时）
+    private static final int CONNECT_TIMEOUT = 5000;
+
+    // 私有构造器：禁止外部实例化
+    private FTPUtils() {
+        initSftpClient();
+    }
+
+    /**
+     * 获取单例实例（双重校验锁，线程安全，Java7兼容）
+     * @return FTPUtils 单例
+     */
+    public static FTPUtils getInstance() {
+        if (sInstance == null) {
+            synchronized (FTPUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new FTPUtils();
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    /**
+     * 初始化SFTP客户端（JSch），创建核心原生对象
+     */
+    private void initSftpClient() {
+        if (mJSch == null) {
+            mJSch = new JSch();
+            LogUtils.d(TAG, "SFTP客户端（JSch）初始化完成");
+        }
+        // 重置会话和通道，避免连接残留
+        mSession = null;
+        mSftpChannel = null;
+    }
+
+    /**
+     * 【推荐】SFTP登录（基于FTPAuthModel实体类，完全兼容原有参数）
+     * @param ftpAuthModel 登录配置实体类（不能为空，端口默认22，编码默认UTF-8）
+     * @return 登录成功返回true，失败false
+     */
+    public boolean login(SFTPAuthModel ftpAuthModel) {
+        // 1. 实体类非空校验
+        if (ftpAuthModel == null) {
+            LogUtils.e(TAG, "SFTP登录失败：FTPAuthModel实体类为null");
+            return false;
+        }
+        // 2. 核心参数校验（服务器地址不能为空）
+        if (isParamEmpty(ftpAuthModel.getFtpServer())) {
+            LogUtils.e(TAG, "SFTP登录失败：服务器地址（ftpServer）不能为空");
+            return false;
+        }
+        // 3. 若已连接，先断开
+        if (isConnected()) {
+            logout();
+        }
+        // 4. 重新初始化客户端
+        initSftpClient();
+
+        try {
+            // 获取服务器地址、端口（默认22）、账号、密码
+            String host = ftpAuthModel.getFtpServer();
+            int port = ftpAuthModel.getFtpPort() <= 0 ? DEFAULT_SFTP_PORT : ftpAuthModel.getFtpPort();
+            String username = ftpAuthModel.getFtpUsername();
+            String password = ftpAuthModel.getFtpPassword();
+
+            // SFTP不支持匿名登录，账号密码不能为空（原生接口无匿名登录能力）
+            if (isParamEmpty(username) || isParamEmpty(password)) {
+                LogUtils.e(TAG, "SFTP登录失败：SFTP不支持匿名登录，请配置有效账号密码");
+                return false;
+            }
+
+            // 1. 创建JSch会话（原生接口）
+            mSession = mJSch.getSession(username, host, port);
+            mSession.setPassword(password);
+
+            // 2. 设置会话属性（跳过SSH密钥校验，适配大部分服务器）
+            Properties sessionProps = new Properties();
+            sessionProps.put("StrictHostKeyChecking", "no");
+            sessionProps.put("PreferredAuthentications", "password");
+            mSession.setConfig(sessionProps);
+
+            // 3. 设置会话连接超时（原生接口，底层Socket超时）
+            mSession.setTimeout(CONNECT_TIMEOUT);
+
+            // 4. 建立会话连接（原生接口）
+            mSession.connect();
+            LogUtils.d(TAG, "SFTP会话连接成功：" + host + ":" + port);
+
+            // 5. 打开SFTP通道（类型：sftp，原生接口强转）
+            mSftpChannel = (ChannelSftp) mSession.openChannel("sftp");
+            mSftpChannel.connect();
+
+            // 6. 设置文件名编码（解决中文乱码，ChannelSftp原生接口）
+            String charset = isParamEmpty(ftpAuthModel.getFtpCharset()) ? "UTF-8" : ftpAuthModel.getFtpCharset();
+            mSftpChannel.setFilenameEncoding(charset);
+            LogUtils.d(TAG, "SFTP文件名编码设置成功：" + charset);
+
+            LogUtils.i(TAG, "SFTP登录成功，服务器：" + host + ":" + port + "，用户名：" + username);
+            return true;
+
+        } catch (JSchException e) {
+            LogUtils.e(TAG, "SFTP登录JSch异常：" + e.getMessage(), e);
+            logout();
+            return false;
+        } catch (SftpException e) {
+            // 匹配SftpException原生属性和方法
+            LogUtils.e(TAG, "SFTP通道初始化异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            logout();
+            return false;
+        }
+    }
+
+    /**
+     * 【已废弃】原FTP多参数登录方法，适配JSch后保留，推荐使用login(FTPAuthModel)
+     * @deprecated 请使用基于FTPAuthModel的登录方法
+     */
+    @Deprecated
+    public boolean login(String host, int port, String username, String password) {
+        SFTPAuthModel ftpAuthModel = new SFTPAuthModel();
+        ftpAuthModel.setFtpServer(host);
+        ftpAuthModel.setFtpPort(port <= 0 ? DEFAULT_SFTP_PORT : port);
+        ftpAuthModel.setFtpUsername(username);
+        ftpAuthModel.setFtpPassword(password);
+        return login(ftpAuthModel);
+    }
+
+    /**
+     * SFTP登出并断开连接，释放所有资源（严格调用原生disconnect接口）
+     * @return 登出成功返回true，失败false
+     */
+    public boolean logout() {
+        boolean isSuccess = true;
+        // 关闭SFTP通道（原生接口disconnect，非空判断即可）
+        if (mSftpChannel != null) {
+            try {
+                mSftpChannel.disconnect();
+                LogUtils.d(TAG, "SFTP通道已断开");
+            } catch (Exception e) {
+                LogUtils.e(TAG, "关闭SFTP通道异常：" + e.getMessage(), e);
+                isSuccess = false;
+            }
+        }
+        // 关闭JSch会话（原生接口disconnect，非空判断即可）
+        if (mSession != null) {
+            try {
+                mSession.disconnect();
+                LogUtils.d(TAG, "SFTP会话已断开");
+            } catch (Exception e) {
+                LogUtils.e(TAG, "关闭SFTP会话异常：" + e.getMessage(), e);
+                isSuccess = false;
+            }
+        }
+        // 重置客户端，避免资源残留
+        initSftpClient();
+        if (isSuccess) {
+            LogUtils.i(TAG, "SFTP登出成功");
+        } else {
+            LogUtils.w(TAG, "SFTP登出失败：部分资源未正常释放");
+        }
+        return isSuccess;
+    }
+
+    /**
+     * 强制断开连接（兜底资源释放），同logout方法
+     */
+    public void disconnect() {
+        logout();
+    }
+
+    /**
+     * 判断SFTP是否已连接（会话+通道均调用原生isConnected接口）
+     * @return 已连接返回true，否则false
+     */
+    public boolean isConnected() {
+        return mSession != null && mSession.isConnected()
+			&& mSftpChannel != null && mSftpChannel.isConnected();
+    }
+
+    /**
+     * 上传文件到SFTP指定路径（覆盖式上传，调用ChannelSftp原生put接口，OVERWRITE模式）
+     * @param localFilePath 本地文件绝对路径（如/sdcard/test.apk）
+     * @param remoteFilePath SFTP服务器目标路径（如/ftp/apk/test.apk，需包含文件名）
+     * @return 上传成功返回true，失败false
+     */
+    public boolean uploadFile(String localFilePath, String remoteFilePath) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "文件上传失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(localFilePath) || isParamEmpty(remoteFilePath)) {
+            LogUtils.e(TAG, "文件上传失败：本地/远程路径不能为空");
+            return false;
+        }
+        File localFile = new File(localFilePath);
+        if (!localFile.exists() || !localFile.isFile()) {
+            LogUtils.e(TAG, "文件上传失败：本地文件不存在/非文件，路径：" + localFilePath);
+            return false;
+        }
+
+        InputStream fis = null;
+        try {
+            // 自动创建远程多级目录（基于原生mkdir/stat接口）
+            createRemoteDir(remoteFilePath);
+            // 读取本地文件，上传到SFTP（原生put接口，OVERWRITE覆盖模式）
+            fis = new FileInputStream(localFile);
+            mSftpChannel.put(fis, remoteFilePath, ChannelSftp.OVERWRITE);
+            LogUtils.i(TAG, "文件上传成功：本地" + localFilePath + " → 远程" + remoteFilePath);
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "文件上传IO异常：" + e.getMessage(), e);
+            return false;
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "文件上传SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            return false;
+        } finally {
+            // 关闭流资源，避免内存泄漏
+            closeStream(fis, null);
+        }
+    }
+
+    /**
+     * 从SFTP下载文件到本地指定路径（覆盖式下载，调用ChannelSftp原生get接口）
+     * @param remoteFilePath SFTP服务器文件路径（如/ftp/apk/test.apk）
+     * @param localFilePath 本地目标路径（如/sdcard/test.apk，需包含文件名）
+     * @return 下载成功返回true，失败false
+     */
+    public boolean downloadFile(String remoteFilePath, String localFilePath) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "文件下载失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(remoteFilePath) || isParamEmpty(localFilePath)) {
+            LogUtils.e(TAG, "文件下载失败：远程/本地路径不能为空");
+            return false;
+        }
+        // 校验远程文件是否存在（基于ChannelSftp原生stat接口）
+        if (!isFileExists(remoteFilePath)) {
+            LogUtils.e(TAG, "文件下载失败：远程文件不存在，路径：" + remoteFilePath);
+            return false;
+        }
+
+        OutputStream fos = null;
+        try {
+            // 创建本地多级目录
+            File localFile = new File(localFilePath);
+            File parentDir = localFile.getParentFile();
+            if (!parentDir.exists() && !parentDir.mkdirs()) {
+                LogUtils.e(TAG, "文件下载失败：创建本地目录失败，路径：" + parentDir.getAbsolutePath());
+                return false;
+            }
+            // 从SFTP读取文件，写入本地（原生get接口）
+            fos = new FileOutputStream(localFile);
+            mSftpChannel.get(remoteFilePath, fos);
+            LogUtils.i(TAG, "文件下载成功：远程" + remoteFilePath + " → 本地" + localFilePath);
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "文件下载IO异常：" + e.getMessage(), e);
+            // 删除未下载完成的本地文件
+            new File(localFilePath).delete();
+            return false;
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "文件下载SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            // 删除未下载完成的本地文件
+            new File(localFilePath).delete();
+            return false;
+        } finally {
+            // 关闭流资源，避免内存泄漏
+            closeStream(null, fos);
+        }
+    }
+
+    /**
+     * 列举SFTP指定文件夹下的所有文件/文件夹（返回ChannelSftp原生Vector，过滤.和..）
+     * @param remoteDir SFTP服务器目录路径（如/ftp/apk/，结尾带/或不带均可）
+     * @return 成功返回原生Vector<ChannelSftp.LsEntry>，失败返回空Vector
+     */
+    @SuppressWarnings("rawtypes")
+    public Vector listDir(String remoteDir) {
+        Vector fileList = new Vector();
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "列举目录失败：SFTP未连接服务器");
+            return fileList;
+        }
+        if (isParamEmpty(remoteDir)) {
+            LogUtils.e(TAG, "列举目录失败：远程目录路径不能为空");
+            return fileList;
+        }
+        // 校验目录是否存在（基于ChannelSftp原生stat接口）
+        if (!isDirExists(remoteDir)) {
+            LogUtils.e(TAG, "列举目录失败：远程目录不存在，路径：" + remoteDir);
+            return fileList;
+        }
+
+        try {
+            // 列举目录下所有文件/文件夹（调用ChannelSftp原生ls接口，返回原生Vector）
+            Vector vector = mSftpChannel.ls(remoteDir);
+            if (vector != null && vector.size() > 0) {
+                for (Object obj : vector) {
+                    // 过滤.和..上级目录，仅保留有效文件/目录
+                    ChannelSftp.LsEntry entry = (ChannelSftp.LsEntry) obj;
+                    String fileName = entry.getFilename();
+                    if (!".".equals(fileName) && !"..".equals(fileName)) {
+                        fileList.add(obj);
+                    }
+                }
+            }
+            LogUtils.i(TAG, "列举目录成功：" + remoteDir + "，共" + fileList.size() + "个文件/文件夹");
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "列举目录SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+        }
+        return fileList;
+    }
+
+    /**
+     * 判断SFTP服务器上**文件**是否存在（基于ChannelSftp原生stat接口，匹配SftpException原生异常）
+     * @param remoteFilePath SFTP服务器文件路径（如/ftp/apk/test.apk）
+     * @return 存在且为文件返回true，否则false
+     */
+    public boolean isFileExists(String remoteFilePath) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "判断文件存在性失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(remoteFilePath)) {
+            LogUtils.e(TAG, "判断文件存在性失败：远程文件路径不能为空");
+            return false;
+        }
+
+        try {
+            // 调用ChannelSftp原生stat接口获取属性，不存在会抛出SSH_FX_NO_SUCH_FILE异常
+            SftpATTRS attrs = mSftpChannel.stat(remoteFilePath);
+            // 原生isReg()判断是否为文件
+            return attrs.isReg();
+        } catch (SftpException e) {
+            // 仅匹配原生异常码SSH_FX_NO_SUCH_FILE(2)：文件/目录不存在，不记错误日志
+            if (e.id != ChannelSftp.SSH_FX_NO_SUCH_FILE) {
+                LogUtils.e(TAG, "判断文件存在性SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            }
+            return false;
+        }
+    }
+
+    /**
+     * 判断SFTP服务器上**文件夹**是否存在（基于ChannelSftp原生stat接口，匹配SftpException原生异常）
+     * @param remoteDir SFTP服务器目录路径（如/ftp/apk/，结尾带/或不带均可）
+     * @return 存在且为目录返回true，否则false
+     */
+    public boolean isDirExists(String remoteDir) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "判断目录存在性失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(remoteDir)) {
+            LogUtils.e(TAG, "判断目录存在性失败：远程目录路径不能为空");
+            return false;
+        }
+
+        try {
+            // 调用ChannelSftp原生stat接口获取属性，不存在会抛出SSH_FX_NO_SUCH_FILE异常
+            SftpATTRS attrs = mSftpChannel.stat(remoteDir);
+            // 原生isDir()判断是否为目录
+            return attrs.isDir();
+        } catch (SftpException e) {
+            // 仅匹配原生异常码SSH_FX_NO_SUCH_FILE(2)：文件/目录不存在，不记错误日志
+            if (e.id != ChannelSftp.SSH_FX_NO_SUCH_FILE) {
+                LogUtils.e(TAG, "判断目录存在性SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            }
+            return false;
+        }
+    }
+
+    // ===================================== 内部工具方法（仅调用原生接口） =====================================
+    /**
+     * 递归创建SFTP远程多级目录（基于ChannelSftp原生mkdir/stat接口，不存在则创建）
+     * @param remoteFilePath SFTP远程文件路径/目录路径
+     */
+    private void createRemoteDir(String remoteFilePath) {
+        if (!isConnected()) {
+            LogUtils.e(TAG, "创建远程目录失败：SFTP未连接服务器");
+            return;
+        }
+        try {
+            // 提取目录路径（文件路径→目录路径，目录路径直接使用）
+            String remoteDir = remoteFilePath.lastIndexOf("/") > 0
+				? remoteFilePath.substring(0, remoteFilePath.lastIndexOf("/"))
+				: remoteFilePath;
+            // 按/分割多级目录，递归创建（避免多级目录不存在）
+            String[] dirs = remoteDir.split("/");
+            StringBuilder currentDir = new StringBuilder();
+            for (String dir : dirs) {
+                if (isParamEmpty(dir)) {
+                    continue;
+                }
+                currentDir.append("/").append(dir);
+                String dirPath = currentDir.toString();
+                // 目录不存在则调用ChannelSftp原生mkdir创建
+                if (!isDirExists(dirPath)) {
+                    mSftpChannel.mkdir(dirPath);
+                    LogUtils.d(TAG, "创建SFTP远程目录成功：" + dirPath);
+                }
+            }
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "创建远程目录SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+        }
+    }
+
+    /**
+     * 关闭流资源（通用工具方法，Java7原生IO，避免内存泄漏）
+     * @param is 输入流（可为null）
+     * @param os 输出流（可为null）
+     */
+    private void closeStream(InputStream is, OutputStream os) {
+        if (is != null) {
+            try {
+                is.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "关闭输入流异常：" + e.getMessage(), e);
+            }
+        }
+        if (os != null) {
+            try {
+                os.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "关闭输出流异常：" + e.getMessage(), e);
+            }
+        }
+    }
+
+    /**
+     * 判断参数是否为空（null/空字符串/全空格，Java7原生字符串操作）
+     * @param param 待判断参数
+     * @return 为空返回true，否则false
+     */
+    private boolean isParamEmpty(String param) {
+        return param == null || param.trim().isEmpty();
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/NfcRsaAuthTool.java

@@ -0,0 +1,480 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.nfc.NfcAdapter;
+import android.nfc.Tag;
+import android.nfc.tech.Ndef;
+import android.nfc.tech.NdefFormatable;
+import android.util.Base64;
+import cc.winboll.studio.libappbase.LogUtils;
+
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.security.KeyFactory;
+import java.security.KeyPair;
+import java.security.KeyPairGenerator;
+import java.security.NoSuchAlgorithmException;
+import java.security.PrivateKey;
+import java.security.PublicKey;
+import java.security.spec.PKCS8EncodedKeySpec;
+import java.security.spec.RSAPrivateCrtKeySpec;
+import java.security.spec.RSAPublicKeySpec;
+import java.security.spec.X509EncodedKeySpec;
+import javax.crypto.Cipher;
+
+/**
+ * @Describe NFC RSA认证工具类，单例模式
+ * 核心功能：RSA密钥生成、NFC密钥读写、本地data区密钥存储、密钥有效性校验、内存密钥缓存
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 21:00:00
+ * @LastEditTime 2026/01/12 17:46:00
+ */
+public class NfcRsaAuthTool {
+    // 常量配置（集中管理，简洁无冗余）
+    private static final String TAG                  = "NfcRsaAuthTool";
+    private static final String RSA_ALGORITHM        = "RSA";
+    private static final int RSA_KEY_SIZE            = 2048;
+    private static final String NFC_KEY_TAG          = "RSA_AUTH_PRIV_";
+    private static final String CHARSET              = "UTF-8";
+    private static final String LOCAL_KEY_FILE_NAME  = "rsa_auth_private.key";
+    private static final String RSA_TEST_DATA        = "NFC_RSA_AUTH_VALID";
+
+    // 单例实例（线程安全双重校验锁核心）
+    private static volatile NfcRsaAuthTool sInstance;
+
+    // 核心属性（按用途排序，注释清晰）
+    private Context mContext;
+    private NfcAdapter mNfcAdapter;
+    private String mCachePrivateKeyStr;  // 内存缓存Base64私钥字符串
+    private String mCachePublicKeyStr;   // 内存缓存Base64公钥字符串
+
+    // 私有构造器（禁止外部实例化，绑定全局上下文）
+    private NfcRsaAuthTool(Context context) {
+        this.mContext = context.getApplicationContext();
+        this.mNfcAdapter = NfcAdapter.getDefaultAdapter(mContext);
+        LogUtils.d(TAG, "构造初始化完成，已绑定全局上下文");
+    }
+
+    /**
+     * 获取单例实例（线程安全，双重校验锁，适配多线程场景）
+     * @param context 上下文对象
+     * @return 单例工具类实例
+     */
+    public static NfcRsaAuthTool getInstance(Context context) {
+        if (sInstance == null) {
+            synchronized (NfcRsaAuthTool.class) {
+                if (sInstance == null) {
+                    sInstance = new NfcRsaAuthTool(context);
+                    LogUtils.d(TAG, "首次创建单例实例成功");
+                }
+            }
+        }
+        LogUtils.d(TAG, "获取单例实例成功");
+        return sInstance;
+    }
+
+    // ==================== 核心功能1：生成RSA私钥（返回Base64编码字符串，便于存储） ====================
+    public String generateRsaPrivateKey() {
+        LogUtils.d(TAG, "开始生成RSA私钥，密钥长度：" + RSA_KEY_SIZE);
+        try {
+            KeyPairGenerator keyPairGen = KeyPairGenerator.getInstance(RSA_ALGORITHM);
+            keyPairGen.initialize(RSA_KEY_SIZE);
+            KeyPair keyPair = keyPairGen.generateKeyPair();
+            PrivateKey privateKey = keyPair.getPrivate();
+            String privateKeyStr = Base64.encodeToString(privateKey.getEncoded(), Base64.NO_WRAP);
+            LogUtils.d(TAG, "RSA私钥生成成功，已完成Base64编码");
+            return privateKeyStr;
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "RSA私钥生成失败，无对应算法支持", e);
+            return null;
+        }
+    }
+
+    // ==================== 核心功能2：NFC密钥读写（适配NDEF标签，兼容已格式化/未格式化场景） ====================
+    /**
+     * 写入Base64私钥到NFC标签，带专属标识防数据混淆
+     * @param tag NFC标签对象
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 写入成功返回true，失败返回false
+     */
+    public boolean writePrivateKeyToNfc(Tag tag, String privateKeyStr) {
+        LogUtils.d(TAG, "写入NFC私钥，入参校验：Tag=" + tag + "，私钥非空=" + (privateKeyStr != null && !privateKeyStr.isEmpty()));
+        if (tag == null || privateKeyStr == null || privateKeyStr.isEmpty() || mNfcAdapter == null) {
+            LogUtils.w(TAG, "入参无效，写入失败（Tag/NFC适配器为空或私钥为空）");
+            return false;
+        }
+        try {
+            byte[] writeData = (NFC_KEY_TAG + privateKeyStr).getBytes(CHARSET);
+            boolean result = writeNfcData(tag, writeData);
+            LogUtils.d(TAG, "NFC私钥写入结果：" + result);
+            return result;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "NFC私钥写入异常", e);
+            return false;
+        }
+    }
+
+    /**
+     * 从NFC标签读取私钥，自动校验标识并缓存到内存
+     * @param tag NFC标签对象
+     * @return 有效私钥返回Base64字符串，无效返回null
+     */
+    public String readPrivateKeyFromNfc(Tag tag) {
+        LogUtils.d(TAG, "读取NFC私钥，Tag对象：" + tag);
+        if (tag == null || mNfcAdapter == null) {
+            LogUtils.w(TAG, "Tag或NFC适配器为空，读取失败");
+            return null;
+        }
+        try {
+            byte[] nfcData = readNfcData(tag);
+            if (nfcData == null || nfcData.length == 0) {
+                LogUtils.w(TAG, "NFC标签无有效存储数据");
+                return null;
+            }
+            String allDataStr = new String(nfcData, CHARSET);
+            if (!allDataStr.startsWith(NFC_KEY_TAG)) {
+                LogUtils.w(TAG, "NFC数据无专属标识，判定为无效私钥数据");
+                return null;
+            }
+            String privateKeyStr = allDataStr.substring(NFC_KEY_TAG.length());
+            if (!privateKeyStr.isEmpty()) {
+                mCachePrivateKeyStr = privateKeyStr;
+                extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+                LogUtils.d(TAG, "NFC私钥读取成功，已缓存私钥并提取公钥");
+            }
+            return privateKeyStr;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "NFC私钥读取异常", e);
+            return null;
+        }
+    }
+
+    // ==================== 核心功能3：本地data区密钥存储（仅应用可访问，安全存储） ====================
+    /**
+     * 私钥存储到应用内部data区，同步缓存到内存
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 存储成功返回true，失败返回false
+     */
+    public boolean savePrivateKeyToLocal(String privateKeyStr) {
+        LogUtils.d(TAG, "本地存储私钥，私钥非空校验：" + (privateKeyStr != null && !privateKeyStr.isEmpty()));
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "待存储私钥为空，存储失败");
+            return false;
+        }
+        File keyFile = new File(mContext.getFilesDir(), LOCAL_KEY_FILE_NAME);
+        FileOutputStream fos = null;
+        try {
+            fos = new FileOutputStream(keyFile);
+            fos.write(privateKeyStr.getBytes(CHARSET));
+            fos.flush();
+            mCachePrivateKeyStr = privateKeyStr;
+            extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+            LogUtils.d(TAG, "私钥本地存储成功，存储路径：" + keyFile.getAbsolutePath());
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "私钥本地存储失败", e);
+            return false;
+        } finally {
+            if (fos != null) {
+                try {
+                    fos.close();
+                } catch (IOException e) {
+                    LogUtils.w(TAG, "关闭存储输出流异常", e);
+                }
+            }
+        }
+    }
+
+    /**
+     * 从本地data区读取私钥，同步缓存到内存
+     * @return 本地私钥返回Base64字符串，无文件返回null
+     */
+    public String getLocalPrivateKey() {
+        LogUtils.d(TAG, "开始读取本地存储私钥");
+        File keyFile = new File(mContext.getFilesDir(), LOCAL_KEY_FILE_NAME);
+        if (!keyFile.exists()) {
+            LogUtils.w(TAG, "本地私钥文件不存在");
+            return null;
+        }
+        FileInputStream fis = null;
+        ByteArrayOutputStream bos = null;
+        try {
+            fis = new FileInputStream(keyFile);
+            bos = new ByteArrayOutputStream();
+            byte[] buffer = new byte[1024];
+            int len;
+            while ((len = fis.read(buffer)) != -1) {
+                bos.write(buffer, 0, len);
+            }
+            String privateKeyStr = new String(bos.toByteArray(), CHARSET);
+            mCachePrivateKeyStr = privateKeyStr;
+            extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+            LogUtils.d(TAG, "本地私钥读取成功，已同步缓存");
+            return privateKeyStr;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "本地私钥读取失败", e);
+            return null;
+        } finally {
+            try {
+                if (fis != null) fis.close();
+                if (bos != null) bos.close();
+            } catch (IOException e) {
+                LogUtils.w(TAG, "关闭读取流异常", e);
+            }
+        }
+    }
+
+    // ==================== 核心功能4：私钥提取公钥（自动缓存，全局可用） ====================
+    public String extractPublicKeyFromPrivateKeyStr(String privateKeyStr) {
+        LogUtils.d(TAG, "从私钥提取公钥，私钥非空校验：" + (privateKeyStr != null && !privateKeyStr.isEmpty()));
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "待提取私钥为空，提取失败");
+            return null;
+        }
+        try {
+            byte[] priKeyBytes = Base64.decode(privateKeyStr, Base64.NO_WRAP);
+            PKCS8EncodedKeySpec priSpec = new PKCS8EncodedKeySpec(priKeyBytes);
+            KeyFactory keyFactory = KeyFactory.getInstance(RSA_ALGORITHM);
+            PrivateKey privateKey = keyFactory.generatePrivate(priSpec);
+
+            RSAPrivateCrtKeySpec privateCrtSpec = (RSAPrivateCrtKeySpec) keyFactory.getKeySpec(privateKey, RSAPrivateCrtKeySpec.class);
+            RSAPublicKeySpec publicKeySpec = new RSAPublicKeySpec(privateCrtSpec.getModulus(), privateCrtSpec.getPublicExponent());
+            PublicKey publicKey = keyFactory.generatePublic(publicKeySpec);
+
+            String publicKeyStr = Base64.encodeToString(publicKey.getEncoded(), Base64.NO_WRAP);
+            mCachePublicKeyStr = publicKeyStr;
+            LogUtils.d(TAG, "公钥提取成功，已缓存");
+            return publicKeyStr;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "公钥提取失败", e);
+            return null;
+        }
+    }
+
+    // ==================== 核心功能5：密钥有效性校验（私钥自校验，公钥交叉校验） ====================
+    /**
+     * 私钥有效性校验：自加密自解密测试明文
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 有效返回true，无效返回false
+     */
+    public boolean validatePrivateKey(String privateKeyStr) {
+        LogUtils.d(TAG, "开始校验私钥有效性");
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "待校验私钥为空，直接判定无效");
+            return false;
+        }
+        try {
+            byte[] priBytes = Base64.decode(privateKeyStr, Base64.NO_WRAP);
+            PKCS8EncodedKeySpec priSpec = new PKCS8EncodedKeySpec(priBytes);
+            PrivateKey privateKey = KeyFactory.getInstance(RSA_ALGORITHM).generatePrivate(priSpec);
+
+            Cipher cipher = Cipher.getInstance(RSA_ALGORITHM);
+            cipher.init(Cipher.ENCRYPT_MODE, privateKey);
+            byte[] encryptData = cipher.doFinal(RSA_TEST_DATA.getBytes(CHARSET));
+            cipher.init(Cipher.DECRYPT_MODE, privateKey);
+            byte[] decryptData = cipher.doFinal(encryptData);
+
+            boolean valid = RSA_TEST_DATA.equals(new String(decryptData, CHARSET));
+            LogUtils.d(TAG, "私钥有效性校验结果：" + valid);
+            return valid;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "私钥校验异常，判定无效", e);
+            return false;
+        }
+    }
+
+    /**
+     * 公钥有效性校验：私钥加密+公钥解密测试明文
+     * @param privateKeyStr 基准Base64私钥字符串
+     * @param publicKeyStr  待校验Base64公钥字符串
+     * @return 有效返回true，无效返回false
+     */
+    public boolean validatePublicKey(String privateKeyStr, String publicKeyStr) {
+        LogUtils.d(TAG, "开始校验公钥有效性，私钥非空=" + (privateKeyStr != null && !privateKeyStr.isEmpty()) + "，公钥非空=" + (publicKeyStr != null && !publicKeyStr.isEmpty()));
+        if (privateKeyStr == null || publicKeyStr == null || privateKeyStr.isEmpty() || publicKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "私钥或公钥为空，直接判定无效");
+            return false;
+        }
+        try {
+            PrivateKey privateKey = getPrivateKeyFromStr(privateKeyStr);
+            PublicKey publicKey = getPublicKeyFromStr(publicKeyStr);
+            if (privateKey == null || publicKey == null) {
+                LogUtils.w(TAG, "私钥或公钥转对象失败，判定无效");
+                return false;
+            }
+
+            Cipher cipher = Cipher.getInstance(RSA_ALGORITHM);
+            cipher.init(Cipher.ENCRYPT_MODE, privateKey);
+            byte[] encryptData = cipher.doFinal(RSA_TEST_DATA.getBytes(CHARSET));
+
+            cipher.init(Cipher.DECRYPT_MODE, publicKey);
+            byte[] decryptData = cipher.doFinal(encryptData);
+
+            boolean valid = RSA_TEST_DATA.equals(new String(decryptData, CHARSET));
+            LogUtils.d(TAG, "公钥有效性校验结果：" + valid);
+            return valid;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "公钥校验异常，判定无效", e);
+            return false;
+        }
+    }
+
+    // ==================== 内部辅助方法（密钥字符串转对象，仅工具类内部调用） ====================
+    /**
+     * 内部辅助：Base64私钥字符串转PrivateKey对象
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 转换成功返回对象，失败返回null
+     */
+    private PrivateKey getPrivateKeyFromStr(String privateKeyStr) {
+        LogUtils.d(TAG, "私钥字符串转PrivateKey对象");
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "私钥字符串为空，转换失败");
+            return null;
+        }
+        try {
+            byte[] priBytes = Base64.decode(privateKeyStr, Base64.NO_WRAP);
+            PKCS8EncodedKeySpec priSpec = new PKCS8EncodedKeySpec(priBytes);
+            return KeyFactory.getInstance(RSA_ALGORITHM).generatePrivate(priSpec);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "设备不支持RSA算法，私钥转换失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "私钥格式无效，转换失败", e);
+        }
+        return null;
+    }
+
+    /**
+     * 内部辅助：Base64公钥字符串转PublicKey对象
+     * @param publicKeyStr Base64编码公钥字符串
+     * @return 转换成功返回对象，失败返回null
+     */
+    private PublicKey getPublicKeyFromStr(String publicKeyStr) {
+        LogUtils.d(TAG, "公钥字符串转PublicKey对象");
+        if (publicKeyStr == null || publicKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "公钥字符串为空，转换失败");
+            return null;
+        }
+        try {
+            byte[] pubBytes = Base64.decode(publicKeyStr, Base64.NO_WRAP);
+            X509EncodedKeySpec pubSpec = new X509EncodedKeySpec(pubBytes);
+            return KeyFactory.getInstance(RSA_ALGORITHM).generatePublic(pubSpec);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "设备不支持RSA算法，公钥转换失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "公钥格式无效，转换失败", e);
+        }
+        return null;
+    }
+
+    // ==================== 内部NFC读写辅助方法（底层交互，对外隐藏） ====================
+    /**
+     * 内部辅助：读取NFC标签原始字节数据
+     */
+    private byte[] readNfcData(Tag tag) {
+        Ndef ndef = Ndef.get(tag);
+        if (ndef != null) {
+            try {
+                ndef.connect();
+                byte[] data = ndef.getNdefMessage().getRecords()[0].getPayload();
+                ndef.close();
+                return data;
+            } catch (Exception e) {
+                LogUtils.e(TAG, "NDEF格式NFC读取异常", e);
+                try { ndef.close(); } catch (IOException ex) { LogUtils.w(TAG, "关闭Ndef连接异常", ex); }
+            }
+        }
+        LogUtils.w(TAG, "NFC标签非NDEF格式，无有效数据");
+        return null;
+    }
+
+    /**
+     * 内部辅助：写入字节数据到NFC标签，兼容两种标签状态
+     */
+    private boolean writeNfcData(Tag tag, byte[] data) {
+        Ndef ndef = Ndef.get(tag);
+        if (ndef != null) return writeToNdef(ndef, data);
+
+        NdefFormatable formatable = NdefFormatable.get(tag);
+        if (formatable != null) return writeToFormatable(formatable, data);
+
+        LogUtils.w(TAG, "NFC标签不支持NDEF格式，写入失败");
+        return false;
+    }
+
+    /**
+     * 内部辅助：写入数据到已格式化NDEF标签
+     */
+    private boolean writeToNdef(Ndef ndef, byte[] data) {
+        try {
+            ndef.connect();
+            ndef.writeNdefMessage(createNdefMessage(data));
+            ndef.close();
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "写入已格式化NFC异常", e);
+            try { ndef.close(); } catch (IOException ex) { LogUtils.w(TAG, "关闭Ndef连接异常", ex); }
+            return false;
+        }
+    }
+
+    /**
+     * 内部辅助：格式化标签并写入数据
+     */
+    private boolean writeToFormatable(NdefFormatable formatable, byte[] data) {
+        try {
+            formatable.connect();
+            formatable.format(createNdefMessage(data));
+            formatable.close();
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "格式化NFC并写入异常", e);
+            try { formatable.close(); } catch (IOException ex) { LogUtils.w(TAG, "关闭NdefFormatable连接异常", ex); }
+            return false;
+        }
+    }
+
+    /**
+     * 内部辅助：创建标准NDEF消息，适配NFC传输规范
+     */
+    private android.nfc.NdefMessage createNdefMessage(byte[] payload) {
+        android.nfc.NdefRecord record = new android.nfc.NdefRecord(
+			android.nfc.NdefRecord.TNF_MIME_MEDIA,
+			"application/octet-stream".getBytes(),
+			new byte[0],
+			payload
+        );
+        return new android.nfc.NdefMessage(new android.nfc.NdefRecord[]{record});
+    }
+
+    // ==================== 对外公共访问方法（获取缓存/状态，简洁易用） ====================
+    public String getCachePrivateKeyStr() {
+        return mCachePrivateKeyStr;
+    }
+
+    public String getCachePublicKeyStr() {
+        return mCachePublicKeyStr;
+    }
+
+    /**
+     * 校验NFC功能是否可用（硬件支持+已开启）
+     * @return 可用返回true，不可用返回false
+     */
+    public boolean isNfcAvailable() {
+        boolean available = mNfcAdapter != null && mNfcAdapter.isEnabled();
+        LogUtils.d(TAG, "NFC当前可用性：" + available);
+        return available;
+    }
+
+    /**
+     * 清空内存中密钥缓存（如退出登录场景使用）
+     */
+    public void clearCache() {
+        mCachePrivateKeyStr = null;
+        mCachePublicKeyStr = null;
+        LogUtils.d(TAG, "内存密钥缓存已清空");
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/utils/SignGetUtils.java

@@ -0,0 +1,71 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.Signature;
+import android.util.Base64;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/20 19:50
+ * @Describe 获取应用签名指纹（SHA1+Base64，直接复制用）
+ */
+public class SignGetUtils {
+    private static final String TAG = "SignGetUtils";
+
+    /**
+     * 一键获取当前应用签名指纹（直接调用，看日志复制结果）
+     */
+    public static void getCurrentAppSign(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "context不能为空");
+            return;
+        }
+        try {
+            PackageManager pm = context.getPackageManager();
+            PackageInfo pkgInfo = pm.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);
+            Signature[] signatures = pkgInfo.signatures;
+            if (signatures == null || signatures.length == 0) {
+                LogUtils.e(TAG, "未获取到应用签名");
+                return;
+            }
+            // 和APPUtils校验格式完全一致（SHA1+Base64 NO_WRAP）
+            MessageDigest md = MessageDigest.getInstance("SHA1");
+            md.update(signatures[0].toByteArray());
+            String signBase64 = Base64.encodeToString(md.digest(), Base64.NO_WRAP);
+
+            // 关键日志：复制【】里的内容到APPUtils的TARGET_SIGN_FINGERPRINT
+            LogUtils.d(TAG, "当前应用包名：" + context.getPackageName());
+            LogUtils.d(TAG, "当前应用签名指纹（直接复制）：【" + signBase64 + "】");
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "获取签名失败：包名不存在", e);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "获取签名失败：不支持SHA1", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "获取签名失败", e);
+        }
+    }
+	
+	// 新增：直接返回签名字符串，供对话框调用
+//	public static String getSignStr(Context context) {
+//		if (context == null) return null;
+//		try {
+//			PackageManager pm = context.getPackageManager();
+//			PackageInfo pkgInfo = pm.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);
+//			Signature[] signatures = pkgInfo.signatures;
+//			if (signatures == null || signatures.length == 0) return null;
+//
+//			MessageDigest md = MessageDigest.getInstance("SHA1");
+//			md.update(signatures[0].toByteArray());
+//			return Base64.encodeToString(md.digest(), Base64.NO_WRAP);
+//		} catch (Exception e) {
+//			LogUtils.e(TAG, "获取签名字符串失败", e);
+//			return null;
+//		}
+//	}
+}
+

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

@@ -0,0 +1,528 @@
+package cc.winboll.studio.libappbase.views;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import android.util.AttributeSet;
+import android.view.Gravity;
+import android.view.View;
+import android.widget.EditText;
+import android.widget.ImageButton;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.dialogs.DebugHostDialog;
+import cc.winboll.studio.libappbase.dialogs.AppValidationDialog;
+import cc.winboll.studio.libappbase.models.APPInfo;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-11 12:23:00
+ * @LastEditTime 2026-01-24 20:50:00
+ * @Describe AboutView 原生实现关于页面，无第三方依赖，适配API30；抽象通用功能控件（邮件/网页跳转），支持调试工具入口动态显隐，集成应用正版校验、调试地址配置弹窗
+ */
+public class AboutView extends LinearLayout {
+    // ===================================== 全局常量 =====================================
+    public static final String TAG = "AboutView";
+    public static final int MSG_APPUPDATE_CHECKED = 0;
+
+    // 固定链接/邮件常量
+    private static final String WINBOLL_OFFICIAL_HOME = "https://www.winboll.cc";
+    private static final String EMAIL_TITLE = "联系WinBoLLStudio";
+    private static final String EMAIL_ADDRESS = "studio@winboll.cc";
+    private static final String EMAIL_TYPE = "message/rfc822";
+
+    // 布局尺寸常量（dp）
+    private static final int PADDING_LARGE = 32;
+    private static final int PADDING_MID = 16;
+    private static final int PADDING_SMALL = 8;
+    private static final int ICON_SIZE = 48;
+    private static final int ITEM_ICON_SIZE = 24;
+
+    // 服务器默认地址常量
+    private static final String SERVER_DEBUG_HOST = "https://yun-preivew.winboll.cc";
+    private static final String SERVER_RELEASE_HOST = "https://yun.winboll.cc";
+
+    // ===================================== 核心成员属性 =====================================
+    // 上下文与业务实体
+    private Context mContext;
+    private APPInfo mAPPInfo;
+    private OnRequestDevUserInfoAutofillListener mOnRequestDevUserInfoAutofillListener;
+
+    // 应用基础信息
+    private String mszAppName = "";
+    private String mszAppVersionName = "";
+    private String mszAppDescription = "";
+    private String mszHomePage = "";
+    private String mszGitea = "";
+    private String mszAppGitName = "";
+    private String mszAppAPKName = "";
+    private String mszAppAPKFolderName = "";
+    private String mszCurrentAppPackageName = "";
+    private String mszReleaseAPKName = "";
+    private volatile String mszNewestAppPackageName = "";
+    private String mszWinBoLLServerHost = "";
+    private int mnAppIcon = 0;
+    private boolean mIsAddDebugTools = false;
+
+    // 调试视图
+    private EditText metDevUserName;
+    private EditText metDevUserPassword;
+
+    // ===================================== 页面视图控件 =====================================
+    private ImageView ivAppIcon;
+    private TextView tvAppNameVersion;
+    private TextView tvAppDesc;
+    private LinearLayout llFunctionContainer;
+    private ImageButton ibSigngetDialog;
+    private ImageButton ibWinBoLLHostDialog;
+
+    // ===================================== 构造方法（按参数从少到多排序） =====================================
+    public AboutView(Context context) {
+        super(context);
+        LogUtils.d(TAG, "AboutView(Context)：代码创建视图，执行默认初始化");
+        this.mContext = context;
+        initDefaultParams();
+        initViewFromXml();
+    }
+
+    public AboutView(Context context, APPInfo appInfo) {
+        super(context);
+        LogUtils.d(TAG, "AboutView(Context,APPInfo)：传入应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+        this.mContext = context;
+        this.mAPPInfo = appInfo;
+        initViewFromXml();
+        initAll();
+    }
+
+    public AboutView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        LogUtils.d(TAG, "AboutView(Context,AttributeSet)：XML布局引用，执行默认初始化");
+        this.mContext = context;
+        initDefaultParams();
+        initViewFromXml();
+    }
+
+    public AboutView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        LogUtils.d(TAG, "AboutView(Context,AttributeSet,int)：XML布局+样式配置，defStyleAttr=" + defStyleAttr);
+        this.mContext = context;
+        initDefaultParams();
+        initViewFromXml();
+    }
+
+    // ===================================== 对外公开方法 =====================================
+    /**
+     * 一站式初始化所有关于页逻辑，包含参数、应用信息、页面视图全流程
+     */
+    public void initAll() {
+        LogUtils.d(TAG, "initAll()：开始一站式初始化，APPInfo是否为空=" + (mAPPInfo == null));
+        if (mAPPInfo == null) {
+            LogUtils.w(TAG, "initAll()：初始化终止，APPInfo为null");
+            return;
+        }
+        initDefaultParams();
+        initAppBaseInfo();
+        initAppVersionInfo();
+        initServerConfig();
+        initAppLinkInfo();
+        initReleaseAPKInfo();
+        initAboutPageView();
+        LogUtils.d(TAG, "initAll()：所有初始化流程执行完成");
+    }
+
+    /**
+     * 重置应用信息并重新初始化页面，支持动态更新关于页内容
+     * @param appInfo 新的应用信息实体
+     */
+    public void setAPPInfoAndInit(APPInfo appInfo) {
+        LogUtils.d(TAG, "setAPPInfoAndInit()：重置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+        this.mAPPInfo = appInfo;
+        if (llFunctionContainer != null) llFunctionContainer.removeAllViews();
+        initAll();
+        LogUtils.d(TAG, "setAPPInfoAndInit()：应用信息重置+页面重构完成");
+    }
+
+    /**
+     * 设置应用信息，兼容旧调用逻辑，设置后自动重构页面
+     * @param appInfo 应用核心信息实体
+     */
+    public void setAPPInfo(APPInfo appInfo) {
+        LogUtils.d(TAG, "setAPPInfo()：设置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+        this.mAPPInfo = appInfo;
+        if (llFunctionContainer != null) llFunctionContainer.removeAllViews();
+        initAll();
+    }
+
+    /**
+     * 设置调试信息自动填充监听，供调试场景回调使用
+     * @param l 监听回调接口实现
+     */
+    public void setOnRequestDevUserInfoAutofillListener(OnRequestDevUserInfoAutofillListener l) {
+        LogUtils.d(TAG, "setOnRequestDevUserInfoAutofillListener()：设置调试信息填充监听完成");
+        this.mOnRequestDevUserInfoAutofillListener = l;
+    }
+
+    // ===================================== 内部初始化方法 =====================================
+    /**
+     * 初始化默认兜底参数，防止空指针，为后续初始化做基础铺垫
+     */
+    private void initDefaultParams() {
+        LogUtils.d(TAG, "initDefaultParams()：开始初始化默认参数");
+        mszWinBoLLServerHost = GlobalApplication.isDebugging() ? SERVER_DEBUG_HOST : SERVER_RELEASE_HOST;
+        mnAppIcon = (mnAppIcon == 0) ? R.drawable.ic_winboll : mnAppIcon;
+        mIsAddDebugTools = false;
+        LogUtils.d(TAG, "initDefaultParams()：默认参数初始化完成，服务器地址=" + mszWinBoLLServerHost + "，应用图标ID=" + mnAppIcon);
+    }
+
+    /**
+     * 加载XML布局并绑定所有视图控件，初始化按钮点击事件
+     */
+    private void initViewFromXml() {
+        LogUtils.d(TAG, "initViewFromXml()：开始加载布局并绑定控件");
+        View.inflate(mContext, R.layout.layout_about_view, this);
+        // 基础控件绑定
+        ivAppIcon = findViewById(R.id.iv_app_icon);
+        tvAppNameVersion = findViewById(R.id.tv_app_name_version);
+        tvAppDesc = findViewById(R.id.tv_app_desc);
+        llFunctionContainer = findViewById(R.id.ll_function_container);
+        // 功能按钮绑定
+        ibSigngetDialog = findViewById(R.id.ib_signgetdialog);
+        ibWinBoLLHostDialog = findViewById(R.id.ib_winbollhostdialog);
+        // 调试地址按钮动态显隐
+        ibWinBoLLHostDialog.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
+        // 绑定按钮点击事件
+        setBtnClickListener();
+        LogUtils.d(TAG, "initViewFromXml()：布局加载+控件绑定+事件初始化完成");
+    }
+
+    /**
+     * 从APPInfo实体读取应用基础核心配置，赋值到本地属性
+     */
+    private void initAppBaseInfo() {
+        LogUtils.d(TAG, "initAppBaseInfo()：开始读取APPInfo基础配置");
+        if (mAPPInfo == null) {
+            LogUtils.w(TAG, "initAppBaseInfo()：跳过执行，APPInfo为null");
+            return;
+        }
+        mszAppName = mAPPInfo.getAppName() == null ? "" : mAPPInfo.getAppName();
+        mszAppAPKFolderName = mAPPInfo.getAppAPKFolderName() == null ? "" : mAPPInfo.getAppAPKFolderName();
+        mszAppAPKName = mAPPInfo.getAppAPKName() == null ? "" : mAPPInfo.getAppAPKName();
+        mszAppGitName = mAPPInfo.getAppGitName() == null ? "" : mAPPInfo.getAppGitName();
+        mszAppDescription = mAPPInfo.getAppDescription() == null ? "" : mAPPInfo.getAppDescription();
+        mnAppIcon = (mAPPInfo.getAppIcon() != 0) ? mAPPInfo.getAppIcon() : mnAppIcon;
+        mIsAddDebugTools = mAPPInfo.isAddDebugTools();
+        LogUtils.d(TAG, "initAppBaseInfo()：基础配置读取完成，应用名=" + mszAppName + "，调试开关=" + mIsAddDebugTools);
+    }
+
+    /**
+     * 从包管理中获取当前应用版本号，初始化版本相关信息
+     */
+    private void initAppVersionInfo() {
+        LogUtils.d(TAG, "initAppVersionInfo()：开始初始化应用版本信息");
+        try {
+            mszAppVersionName = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0).versionName;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "initAppVersionInfo()：获取版本号失败，默认赋值unknown", e);
+            mszAppVersionName = "unknown";
+        }
+        mszCurrentAppPackageName = String.format("%s_%s.apk", mszAppVersionName, mszAppVersionName);
+        LogUtils.d(TAG, "initAppVersionInfo()：版本信息初始化完成，版本号=" + mszAppVersionName + "，当前APK名=" + mszCurrentAppPackageName);
+    }
+
+    /**
+     * 初始化服务器相关配置，预留扩展接口
+     */
+    private void initServerConfig() {
+        LogUtils.d(TAG, "initServerConfig()：服务器配置初始化，预留扩展接口");
+    }
+
+    /**
+     * 初始化应用相关链接（主页+Git源码地址），根据分支配置动态拼接Git地址
+     */
+    private void initAppLinkInfo() {
+        LogUtils.d(TAG, "initAppLinkInfo()：开始初始化应用链接信息");
+        if (mAPPInfo == null) {
+            LogUtils.w(TAG, "initAppLinkInfo()：跳过执行，APPInfo为null");
+            return;
+        }
+        mszHomePage = mAPPInfo.getAppHomePage() == null ? "" : mAPPInfo.getAppHomePage();
+        // 拼接Git地址，兼容无分支配置场景
+        if (mAPPInfo.getAppGitAPPBranch() == null || mAPPInfo.getAppGitAPPBranch().trim().isEmpty()) {
+            mszGitea = String.format("https://gitea.winboll.cc/%s/%s", mAPPInfo.getAppGitOwner(), mszAppGitName);
+        } else {
+            mszGitea = String.format("https://gitea.winboll.cc/%s/%s/src/branch/%s/%s",
+									 mAPPInfo.getAppGitOwner(), mszAppGitName,
+									 mAPPInfo.getAppGitAPPBranch(), mAPPInfo.getAppGitAPPSubProjectFolder());
+        }
+        LogUtils.d(TAG, "initAppLinkInfo()：链接信息初始化完成，应用主页=" + mszHomePage + "，Git地址=" + mszGitea);
+    }
+
+    /**
+     * 初始化正式版APK信息，去除beta后缀适配正式包命名规范
+     */
+    private void initReleaseAPKInfo() {
+        LogUtils.d(TAG, "initReleaseAPKInfo()：开始初始化正式版APK信息");
+        String szReleaseAppVersionName = "unknown";
+        try {
+            String szSubBetaSuffix = subBetaSuffix(mContext.getPackageName());
+            szReleaseAppVersionName = mContext.getPackageManager().getPackageInfo(szSubBetaSuffix, 0).versionName;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "initReleaseAPKInfo()：获取正式版版本号失败", e);
+        }
+        mszReleaseAPKName = String.format("%s_%s.apk", mszAppAPKName, szReleaseAppVersionName);
+        LogUtils.d(TAG, "initReleaseAPKInfo()：正式版APK信息初始化完成，APK名=" + mszReleaseAPKName);
+    }
+
+    /**
+     * 核心视图组装：赋值基础信息到控件，添加通用功能项到容器
+     */
+    private void initAboutPageView() {
+        LogUtils.d(TAG, "initAboutPageView()：开始组装关于页视图");
+        // 赋值基础信息
+        ivAppIcon.setImageResource(mnAppIcon);
+        tvAppNameVersion.setText(String.format("%s %s", mszAppName, mszAppVersionName));
+        if (mszAppDescription.isEmpty()) {
+            tvAppDesc.setVisibility(GONE);
+        } else {
+            tvAppDesc.setVisibility(VISIBLE);
+            tvAppDesc.setText(mszAppDescription);
+        }
+        // 添加通用功能项
+        addFunctionView(new WebJumpFunctionItemView(mContext, "WinBoLL 主页", WINBOLL_OFFICIAL_HOME, R.drawable.ic_winboll));
+        addFunctionView(new EmailFunctionItemView(mContext, "联系邮箱", "WinBoLLStudio<studio@winboll.cc>", R.drawable.ic_winboll));
+        if (!mszHomePage.isEmpty()) {
+            addFunctionView(new WebJumpFunctionItemView(mContext, "应用APK下载地址", mszHomePage, R.drawable.ic_winboll));
+        }
+        if (!mszGitea.isEmpty()) {
+            addFunctionView(new WebJumpFunctionItemView(mContext, "应用Git源码地址", mszGitea, R.drawable.ic_winboll));
+        }
+        LogUtils.d(TAG, "initAboutPageView()：视图组装完成，功能项加载完毕");
+    }
+
+    // ===================================== 内部工具/事件方法 =====================================
+    /**
+     * 绑定功能按钮点击事件，处理正版校验、调试地址配置弹窗唤起
+     */
+    private void setBtnClickListener() {
+        LogUtils.d(TAG, "setBtnClickListener()：开始绑定功能按钮点击事件");
+        // 正版校验弹窗
+        ibSigngetDialog.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "ibSigngetDialog onClick：唤起应用正版校验弹窗");
+					new AppValidationDialog(mContext, mszAppGitName, mszAppVersionName).show();
+				}
+			});
+        // 调试地址配置弹窗
+        ibWinBoLLHostDialog.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "ibWinBoLLHostDialog onClick：唤起调试地址配置弹窗");
+					new DebugHostDialog(mContext).show();
+				}
+			});
+        LogUtils.d(TAG, "setBtnClickListener()：功能按钮点击事件绑定完成");
+    }
+
+    /**
+     * 添加功能项视图到容器，统一设置间距
+     * @param view 功能项视图
+     */
+    private void addFunctionView(View view) {
+        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
+        params.topMargin = dp2px(PADDING_SMALL);
+        llFunctionContainer.addView(view, params);
+    }
+
+    /**
+     * dp转px工具方法，适配不同屏幕密度，保证布局一致性
+     * @param dpValue dp单位尺寸
+     * @return 转换后的px单位尺寸
+     */
+    private int dp2px(int dpValue) {
+        float density = mContext.getResources().getDisplayMetrics().density;
+        return (int) (dpValue * density + 0.5f);
+    }
+
+    /**
+     * 去除包名beta后缀，适配正式版包名规范，静态方法支持外部调用
+     * @param input 原始包名
+     * @return 去除beta后缀后的正式包名
+     */
+    public static String subBetaSuffix(String input) {
+        LogUtils.d(TAG, "subBetaSuffix()：执行包名beta后缀去除，原始包名=" + input);
+        if (input != null && input.endsWith(".beta")) {
+            String result = input.substring(0, input.length() - ".beta".length());
+            LogUtils.d(TAG, "subBetaSuffix()：处理成功，正式包名=" + result);
+            return result;
+        }
+        LogUtils.d(TAG, "subBetaSuffix()：无需处理，包名不含beta后缀");
+        return input == null ? "" : input;
+    }
+
+    // ===================================== 内部抽象通用功能项基类 =====================================
+    /**
+     * 通用功能项基类，统一样式、布局、视图构建，减少冗余代码
+     */
+    private abstract class BaseFunctionItemView extends LinearLayout implements OnClickListener {
+        protected Context mItemContext;
+        protected String mTitle;
+        protected String mContent;
+        protected int mIconRes;
+
+        public BaseFunctionItemView(Context context, String title, String content, int iconRes) {
+            super(context);
+            this.mItemContext = context;
+            this.mTitle = title;
+            this.mContent = content;
+            this.mIconRes = iconRes;
+            initItemLayout();
+            initItemViews();
+            setOnClickListener(this);
+        }
+
+        /**
+         * 统一初始化功能项布局属性
+         */
+        private void initItemLayout() {
+            setOrientation(HORIZONTAL);
+            setGravity(Gravity.CENTER_VERTICAL);
+            setPadding(dp2px(PADDING_MID), dp2px(PADDING_SMALL), dp2px(PADDING_MID), dp2px(PADDING_SMALL));
+            setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT));
+            setClickable(true);
+            setBackgroundResource(android.R.drawable.list_selector_background);
+        }
+
+        /**
+         * 统一构建功能项视图（左侧图标+右侧标题/内容）
+         */
+        private void initItemViews() {
+            // 左侧图标
+            if (mIconRes != 0) {
+                ImageView ivIcon = new ImageView(mItemContext);
+                LayoutParams iconParams = new LayoutParams(dp2px(ITEM_ICON_SIZE), dp2px(ITEM_ICON_SIZE));
+                iconParams.rightMargin = dp2px(PADDING_SMALL);
+                ivIcon.setLayoutParams(iconParams);
+                ivIcon.setImageResource(mIconRes);
+                addView(ivIcon);
+            }
+            // 右侧文本容器
+            LinearLayout llText = new LinearLayout(mItemContext);
+            llText.setOrientation(VERTICAL);
+            llText.setLayoutParams(new LayoutParams(0, LayoutParams.WRAP_CONTENT, 1.0f));
+            addView(llText);
+            // 标题
+            TextView tvTitle = new TextView(mItemContext);
+            tvTitle.setText(mTitle);
+            tvTitle.setTextSize(16);
+            tvTitle.setTextColor(mItemContext.getResources().getColor(R.color.gray_900));
+            llText.addView(tvTitle);
+            // 内容
+            TextView tvContent = new TextView(mItemContext);
+            tvContent.setText(mContent);
+            tvContent.setTextSize(14);
+            tvContent.setTextColor(getContentTextColor());
+            tvContent.setPadding(0, dp2px(PADDING_SMALL), 0, 0);
+            llText.addView(tvContent);
+        }
+
+        /**
+         * 子类抽象方法：指定内容文本颜色
+         * @return 颜色值
+         */
+        protected abstract int getContentTextColor();
+    }
+
+    // ===================================== 内部邮件功能项子类 =====================================
+    /**
+     * 邮件类功能控件，实现专属邮件唤起逻辑，双方案兼容（纯邮件客户端/通用邮件应用）
+     */
+    private class EmailFunctionItemView extends BaseFunctionItemView {
+        public EmailFunctionItemView(Context context, String title, String content, int iconRes) {
+            super(context, title, content, iconRes);
+        }
+
+        @Override
+        protected int getContentTextColor() {
+            return mItemContext.getResources().getColor(R.color.blue_normal);
+        }
+
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "EmailFunctionItemView onClick：触发邮件唤起逻辑");
+            // 方案1：纯邮件客户端唤起
+            Intent emailIntent = new Intent(Intent.ACTION_SENDTO);
+            emailIntent.setData(Uri.parse("mailto:" + EMAIL_ADDRESS));
+            emailIntent.putExtra(Intent.EXTRA_SUBJECT, EMAIL_TITLE);
+            emailIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            if (emailIntent.resolveActivity(mItemContext.getPackageManager()) != null) {
+                mItemContext.startActivity(emailIntent);
+                LogUtils.d(TAG, "EmailFunctionItemView：纯邮件客户端唤起成功");
+                return;
+            }
+            // 方案2：通用邮件应用兜底
+            Intent fallbackIntent = new Intent(Intent.ACTION_SEND);
+            fallbackIntent.setType(EMAIL_TYPE);
+            fallbackIntent.putExtra(Intent.EXTRA_EMAIL, new String[]{EMAIL_ADDRESS});
+            fallbackIntent.putExtra(Intent.EXTRA_SUBJECT, EMAIL_TITLE);
+            fallbackIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            if (fallbackIntent.resolveActivity(mItemContext.getPackageManager()) != null) {
+                mItemContext.startActivity(fallbackIntent);
+                LogUtils.d(TAG, "EmailFunctionItemView：通用邮件应用唤起成功");
+            } else {
+                ToastUtils.show("未找到可发送邮件的应用");
+                LogUtils.w(TAG, "EmailFunctionItemView：邮件唤起失败，无可用邮件应用");
+            }
+        }
+    }
+
+    // ===================================== 内部网页跳转功能项子类 =====================================
+    /**
+     * 网页跳转类功能控件，实现专属网页唤起逻辑，包含空地址校验、异常捕获
+     */
+    private class WebJumpFunctionItemView extends BaseFunctionItemView {
+        public WebJumpFunctionItemView(Context context, String title, String content, int iconRes) {
+            super(context, title, content, iconRes);
+        }
+
+        @Override
+        protected int getContentTextColor() {
+            return mItemContext.getResources().getColor(R.color.blue_normal);
+        }
+
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "WebJumpFunctionItemView onClick：触发网页跳转，地址=" + mContent);
+            if (mContent.isEmpty()) {
+                ToastUtils.show("跳转地址为空");
+                LogUtils.w(TAG, "WebJumpFunctionItemView：网页跳转失败，地址为空");
+                return;
+            }
+            try {
+                Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(mContent));
+                browserIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                mItemContext.startActivity(browserIntent);
+                LogUtils.d(TAG, "WebJumpFunctionItemView：网页跳转成功");
+            } catch (Exception e) {
+                LogUtils.e(TAG, "WebJumpFunctionItemView：网页跳转失败", e);
+                ToastUtils.show("链接无法打开");
+            }
+        }
+    }
+
+    // ===================================== 内部回调接口 =====================================
+    /**
+     * 调试信息自动填充回调接口
+     */
+    public interface OnRequestDevUserInfoAutofillListener {
+        void requestAutofill(EditText etDevUserName, EditText etDevUserPassword);
+    }
+}
+

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

@@ -0,0 +1,129 @@
+package cc.winboll.studio.libappbase.views;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/03/12 12:29:01
+ * @Describe 水平布局的 ListView
+ */
+import android.content.Context;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.ListView;
+import android.widget.Scroller;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class HorizontalListView extends ListView {
+    public static final String TAG = "HorizontalListView";
+    private int verticalOffset = 0;
+    private Scroller scroller;
+    private int totalWidth;
+
+    public HorizontalListView(Context context) {
+        super(context);
+        init();
+    }
+
+    public HorizontalListView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+
+    public HorizontalListView(Context context, AttributeSet attrs, int defStyle) {
+        super(context, attrs, defStyle);
+        init();
+    }
+
+    private void init() {
+        scroller = new Scroller(getContext());
+        setHorizontalScrollBarEnabled(true);
+        setVerticalScrollBarEnabled(false);
+    }
+
+    public void setVerticalOffset(int verticalOffset) {
+        this.verticalOffset = verticalOffset;
+    }
+
+    @Override
+    protected void onLayout(boolean changed, int l, int t, int r, int b) {
+        super.onLayout(changed, l, t, r, b);
+        int childCount = getChildCount();
+        int left = getPaddingLeft();
+        int viewHeight = getMeasuredHeight() - getPaddingTop() - getPaddingBottom();
+        totalWidth = left;
+
+        for (int i = 0; i < childCount; i++) {
+            View child = getChildAt(i);
+            int width = child.getMeasuredWidth();
+            int height = child.getMeasuredHeight();
+            child.layout(left, verticalOffset, left + width, verticalOffset + height);
+            left += width;
+        }
+        totalWidth = left + getPaddingRight();
+    }
+
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
+    }
+
+    @Override
+    public void computeScroll() {
+        if (scroller.computeScrollOffset()) {
+            scrollTo(scroller.getCurrX(), scroller.getCurrY());
+            postInvalidate();
+        }
+    }
+
+    public void smoothScrollTo(int x, int y) {
+        int dx = x - getScrollX();
+        int dy = y - getScrollY();
+        scroller.startScroll(getScrollX(), getScrollY(), dx, dy, 300); // 300ms平滑动画
+        invalidate();
+    }
+
+    @Override
+    public int computeHorizontalScrollRange() {
+        return totalWidth;
+    }
+
+    @Override
+    public int computeHorizontalScrollOffset() {
+        return getScrollX();
+    }
+
+    @Override
+    public int computeHorizontalScrollExtent() {
+        return getWidth();
+    }
+
+    public void scrollToItem(int position) {
+        if (position < 0 || position >= getChildCount()) {
+            LogUtils.d(TAG, "无效的position: " + position);
+            return;
+        }
+
+        View targetView = getChildAt(position);
+        int targetLeft = targetView.getLeft();
+        int scrollX = targetLeft - getPaddingLeft();
+
+        // 修正最大滚动范围计算
+        int maxScrollX = totalWidth;
+        scrollX = Math.max(0, Math.min(scrollX, maxScrollX));
+
+        // 强制重新布局和绘制
+        requestLayout();
+        invalidateViews();
+        smoothScrollTo(scrollX, 0);
+        LogUtils.d(TAG, String.format("滚动到position: %d, scrollX: %d computeHorizontalScrollRange() %d", position, scrollX, computeHorizontalScrollRange()));
+    }
+
+    public void resetScrollToStart() {
+        // 强制重新布局和绘制
+        requestLayout();
+        invalidateViews();
+        smoothScrollTo(0, 0);
+    }
+}
+

libappbase/src/main/java/cc/winboll/studio/libappbase/widget/LogTagSpinner.java

@@ -0,0 +1,248 @@
+package cc.winboll.studio.libappbase.widget;
+
+import android.content.Context;
+import android.graphics.Color;
+import android.text.TextUtils;
+import android.util.AttributeSet;
+import android.util.TypedValue;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ArrayAdapter;
+import android.widget.Spinner;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/15 13:51
+ * @Describe 纯原生 LogTag 专属 Spinner（无 androidx 依赖）
+ * 核心特性：1. 继承原生 Spinner，适配全 Android 版本；2. dimen 统一配置所有尺寸；3. 文字大小支持 dp 单位；4. 简化外部初始化
+ */
+public class LogTagSpinner extends Spinner {
+	public static final String TAG = "LogTagSpinner";
+
+	Context mContext;
+	// 尺寸缓存（dimen 解析后转 px，避免重复计算）
+	private int mSpinnerWidth;       // 控件自身框度（px）
+	private int mSpinnerHeight;       // 控件自身高度（px）
+	private int mItemWidth;          // 下拉项单个高度（px）
+	private int mItemHeight;          // 下拉项单个高度（px）
+	private float mTextSizePx;        // 文字大小（px，dp 转译后）
+	private int mTextPadding;         // 文字左右内边距（px）
+
+	// 内置适配器（外部无需关心内部实现）
+	private ArrayAdapter<String> mLogTagAdapter;
+
+
+	// -------------------------- 构造方法（原生 Spinner 必重写 3 个）--------------------------
+	public LogTagSpinner(Context context) {
+		super(context);
+		initCoreLogic(context);
+	}
+
+	public LogTagSpinner(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		initCoreLogic(context);
+	}
+
+	public LogTagSpinner(Context context, AttributeSet attrs, int defStyle) {
+		super(context, attrs, defStyle);
+		initCoreLogic(context);
+	}
+
+	// -------------------------- 核心初始化（解析资源 + 配置样式 + 初始化适配器）--------------------------
+	private void initCoreLogic(Context context) {
+		this.mContext = context;
+		// 1. 读取 dimen 资源（dp 转 px，核心适配）
+		parseDimenResources();
+		// 2. 设置 Spinner 自身基础样式（高度、背景）
+		configSelfStyle();
+		// 3. 初始化适配器（统一选中项+下拉项样式）
+		initCustomAdapter();
+	}
+
+
+	/**
+	 * 步骤 1：解析 dimen 资源，所有 dp 单位转为 px（跨设备视觉一致）
+	 */
+	private void parseDimenResources() {
+		Context context = this.mContext;
+		// 控件自身宽度（dp → px）
+		mSpinnerWidth = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_width);
+		// 控件自身高度（dp → px）
+		mSpinnerHeight = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_height);
+		// 下拉项宽度（dp → px）
+		mItemWidth = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_item_width);
+		// 下拉项高度（dp → px）
+		mItemHeight = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_item_height);
+		// 文字大小（dp → px，核心：用 getDimensionPixelSize 确保 dp 精准转译）
+		mTextSizePx = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_text_size);
+		// 文字内边距（dp → px）
+		mTextPadding = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_text_padding);
+
+		LogUtils.d("LogTagSpinner", "dimen 解析完成：高度=" + mSpinnerHeight + "px，文字大小=" + mTextSizePx + "px");
+	}
+
+
+	/**
+	 * 步骤 2：配置 Spinner 自身样式（覆盖布局属性，统一控制）
+	 */
+	private void configSelfStyle() {
+		// 动态设置控件高度（布局中 layout_height 设 wrap_content 即可，这里统一控制）
+		ViewGroup.LayoutParams layoutParams = getLayoutParams();
+		if (layoutParams != null) {
+			layoutParams.width = mSpinnerWidth;
+			layoutParams.height = mSpinnerHeight;
+		} else {
+			// 代码创建控件时，手动初始化布局参数
+			layoutParams = new ViewGroup.LayoutParams(
+				mSpinnerWidth,
+				mSpinnerHeight
+			);
+		}
+		setLayoutParams(layoutParams);
+
+		// 统一背景色（外部可通过 setBackground 手动覆盖）
+		setBackgroundColor(this.mContext.getColor(R.color.btn_gray_normal));
+	}
+
+
+	/**
+	 * 步骤 3：初始化自定义适配器，统一选中项+下拉项样式
+	 */
+	private void initCustomAdapter() {
+		// 用原生系统布局（避免自定义布局，减少依赖），后续重写样式
+		mLogTagAdapter = new ArrayAdapter<String>(this.mContext, android.R.layout.simple_spinner_item) {
+			// 重写：控制「已选中项」的样式（文字大小、高度、内边距）
+			@Override
+			public View getView(int position, View convertView, ViewGroup parent) {
+				TextView itemTv = (TextView) super.getView(position, convertView, parent);
+				setItemUniformStyle(itemTv);
+				return itemTv;
+			}
+
+			// 重写：控制「下拉列表项」的样式（必须重写，否则下拉项样式不生效）
+			@Override
+			public View getDropDownView(int position, View convertView, ViewGroup parent) {
+				TextView itemTv = (TextView) super.getDropDownView(position, convertView, parent);
+				setItemUniformStyle(itemTv);
+				return itemTv;
+			}
+		};
+
+		// 绑定下拉项布局（原生系统布局，确保低版本兼容）
+		mLogTagAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
+		// 设置适配器到 Spinner
+		setAdapter(mLogTagAdapter);
+	}
+
+
+	/**
+	 * 通用方法：统一设置列表项（选中项/下拉项）的样式
+	 */
+	private void setItemUniformStyle(TextView itemTv) {
+		if (itemTv == null) return;
+
+		// 1. 文字大小（核心：按 px 赋值，dp 转译后无二次换算，精准适配）
+		itemTv.setTextSize(TypedValue.COMPLEX_UNIT_PX, mTextSizePx);
+		// 2. 列表项高度（固定高度，避免文字多少导致高度不一致）
+		itemTv.setWidth(mItemWidth);
+		itemTv.setHeight(mItemHeight);
+		// 3. 内边距（左右留白，优化排版，避免文字贴边）
+		itemTv.setPadding(mTextPadding, 0, mTextPadding, 0);
+		// 4. 文字对齐（垂直居中+靠左，符合常规 UI 设计）
+		//itemTv.setGravity(View.GRAVITY_CENTER_VERTICAL | View.GRAVITY_START);
+		// 5. 文字颜色（统一深色，可改为项目颜色资源）
+		itemTv.setTextColor(this.mContext.getColor(R.color.white));
+		itemTv.setBackgroundColor(this.mContext.getColor(R.color.btn_gray_normal));
+		// 6. 文字溢出处理（最多 2 行，超出省略，避免长标签换行过多）
+		itemTv.setSingleLine(false);
+		itemTv.setMaxLines(2);
+		itemTv.setEllipsize(TextUtils.TruncateAt.END);
+	}
+
+
+	// -------------------------- 外部调用 API（极简用法，无需关心内部逻辑）--------------------------
+	/**
+	 * 填充日志标签数据（外部核心调用，一行代码搞定）
+	 * @param logTagArray 日志标签数组（如：{"TAG_MAIN", "TAG_NET", "TAG_DB"}）
+	 */
+	public void setLogTagData(String[] logTagArray) {
+		if (mLogTagAdapter == null || logTagArray == null || logTagArray.length == 0) {
+			LogUtils.w("LogTagSpinner", "填充数据失败：适配器为空或数据无效");
+			return;
+		}
+		// 清空旧数据，添加新数据，刷新适配器
+		mLogTagAdapter.clear();
+		mLogTagAdapter.addAll(logTagArray);
+		mLogTagAdapter.notifyDataSetChanged();
+	}
+
+	/**
+	 * 设置默认选中的标签（索引从 0 开始）
+	 * @param defaultIndex 默认选中索引（需在 setLogTagData 之后调用）
+	 */
+	public void setDefaultSelectedTag(int defaultIndex) {
+		if (mLogTagAdapter == null) return;
+		// 索引合法性校验，避免数组越界
+		if (defaultIndex >= 0 && defaultIndex < mLogTagAdapter.getCount()) {
+			setSelection(defaultIndex);
+			LogUtils.d("LogTagSpinner", "默认选中标签：" + mLogTagAdapter.getItem(defaultIndex));
+		} else {
+			LogUtils.w("LogTagSpinner", "默认选中索引无效：" + defaultIndex);
+		}
+	}
+
+	/**
+	 * 获取当前选中的日志标签（外部业务逻辑调用）
+	 * @return 当前选中的标签文字（无选中时返回空字符串）
+	 */
+	public String getCurrentSelectedTag() {
+		Object selectedItem = getSelectedItem();
+		return selectedItem != null ? selectedItem.toString() : "";
+	}
+
+
+	// -------------------------- 优化扩展（可选，提升稳定性）--------------------------
+	/**
+	 * 视图附着到窗口时，确保默认有数据（避免空指针）
+	 */
+	@Override
+	protected void onAttachedToWindow() {
+		super.onAttachedToWindow();
+		if (mLogTagAdapter != null && mLogTagAdapter.getCount() == 0) {
+			setLogTagData(new String[]{"默认标签"});
+		}
+	}
+
+	/**
+	 * 外部扩展：动态修改文字大小（dp 单位）
+	 * @param textSizeDp 目标文字大小（dp）
+	 */
+	public void updateTextSize(int textSizeDp) {
+		mTextSizePx = this.mContext.getResources().getDimensionPixelSize(textSizeDp);
+		// 刷新所有列表项样式
+		if (mLogTagAdapter != null) {
+			mLogTagAdapter.notifyDataSetChanged();
+		}
+	}
+
+	/**
+	 * 外部扩展：动态修改文字颜色
+	 * @param textColorRes 文字颜色资源 ID（如 R.color.red）
+	 */
+	public void updateTextColor(int textColorRes) {
+		int textColor = this.mContext.getResources().getColor(textColorRes);
+		// 刷新选中项颜色
+		TextView selectedTv = (TextView) getSelectedView();
+		if (selectedTv != null) {
+			selectedTv.setTextColor(textColor);
+		}
+		// 刷新下拉项颜色
+		if (mLogTagAdapter != null) {
+			mLogTagAdapter.notifyDataSetChanged();
+		}
+	}
+}
+

libappbase/src/main/res/drawable/bg_border.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <stroke
+        android:width="1dp"
+        android:color="#000000" /> <!-- 这里可调整边框宽度和颜色 -->
+    <solid android:color="@android:color/transparent" />
+</shape>

libappbase/src/main/res/drawable/bg_border_round.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <stroke
+        android:width="1dp"
+        android:color="#000000" /> <!-- 这里可调整边框宽度和颜色 -->
+    <solid android:color="@android:color/transparent" />
+    <corners 
+        android:bottomLeftRadius="6dip" 
+        android:bottomRightRadius="6dip" 
+        android:topLeftRadius="6dip" 
+        android:topRightRadius="6dip" /> 
+</shape>

libappbase/src/main/res/drawable/bg_toolbar_log.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="@color/colorPrimary" 
+                android:startColor="@color/colorPrimary" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="@color/colorPrimary" 
+                android:startColor="@color/colorPrimary" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+</layer-list>

libappbase/src/main/res/drawable/btn_gray_bg.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 按钮状态选择器：按优先级匹配（按压 > 禁用 > 默认） -->
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <!-- 状态 1：按压时（手指按住）→ 深灰色 -->
+    <item android:color="@color/btn_gray_pressed" android:state_pressed="true"/>
+
+    <!-- 状态 2：禁用时（setEnabled(false)）→ 浅灰色 -->
+    <item android:color="@color/btn_gray_disabled" android:state_enabled="false"/>
+
+    <!-- 状态 3：默认态（正常可点击）→ 常规灰色 -->
+    <item android:color="@color/btn_gray_normal"/>
+
+</selector>

libappbase/src/main/res/drawable/ic_bug.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M14,12H10V10H14M14,16H10V14H14M20,8H17.19C16.74,7.22 16.12,6.55 15.37,6.04L17,4.41L15.59,3L13.42,5.17C12.96,5.06 12.5,5 12,5C11.5,5 11.04,5.06 10.59,5.17L8.41,3L7,4.41L8.62,6.04C7.88,6.55 7.26,7.22 6.81,8H4V10H6.09C6.04,10.33 6,10.66 6,11V12H4V14H6V15C6,15.34 6.04,15.67 6.09,16H4V18H6.81C7.85,19.79 9.78,21 12,21C14.22,21 16.15,19.79 17.19,18H20V16H17.91C17.96,15.67 18,15.34 18,15V14H20V12H18V11C18,10.66 17.96,10.33 17.91,10H20V8Z"/>
+
+</vector>

libappbase/src/main/res/drawable/ic_content_copy.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M19,21H8V7H19M19,5H8A2,2 0,0 0,6 7V21A2,2 0,0 0,8 23H19A2,2 0,0 0,21 21V7A2,2 0,0 0,19 5M16,1H4A2,2 0,0 0,2 3V17H4V3H16V1Z"/>
+
+</vector>

libappbase/src/main/res/drawable/ic_key.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M7,14C5.9,14 5,13.1 5,12S5.9,10 7,10 9,10.9 9,12 8.1,14 7,14M12.6,10C11.8,7.7 9.6,6 7,6C3.7,6 1,8.7 1,12S3.7,18 7,18C9.6,18 11.8,16.3 12.6,14H16V18H20V14H23V10H12.6Z"/>
+
+</vector>

libappbase/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="@color/colorPrimary"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>

libappbase/src/main/res/drawable/ic_winboll.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item
+        android:width="256dp"
+        android:height="256dp"
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/ic_winboll_logo">
+    </item>
+</layer-list>

libappbase/src/main/res/drawable/ic_winboll_beta.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/ic_winboll_logo"/>
+</layer-list>

libappbase/src/main/res/drawable/ic_winboll_logo.xml

@@ -0,0 +1,48 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M103.77 307.45C103.02 293.07 104.03 271.24 129.24 248.85 135.25 243.52 141.74 239.48 147.89 236.44 160.24 230.34 171.23 228.28 174.15 227.92 174.31 227.9 174.44 227.89 174.55 227.88 174.66 227.87 174.75 227.86 174.81 227.86 176.62 227.85 216.5 230.02 234.65 253.79 253.9 278.99 266.43 314.66 221.67 356.93 184.69 391.85 179.97 411.36 180.15 411.08"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M248.17 309.83C247.43 295.45 248.43 273.62 273.64 251.23 279.65 245.9 286.14 241.86 292.29 238.82 304.65 232.72 315.63 230.65 318.55 230.3 318.71 230.28 318.84 230.27 318.95 230.26 319.06 230.25 319.15 230.24 319.21 230.24 321.02 230.22 360.9 232.4 379.06 256.17 398.3 281.37 410.83 317.04 366.08 359.31 329.09 394.23 324.37 413.74 324.55 413.46"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+</vector>

libappbase/src/main/res/drawable/shape_edittext_bg.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:state_focused="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF"/>
+            <stroke android:width="1dp" android:color="#007AFF"/>
+            <corners android:radius="8dp"/>
+        </shape>
+    </item>
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF"/>
+            <stroke android:width="1dp" android:color="#E5E5E5"/>
+            <corners android:radius="8dp"/>
+        </shape>
+    </item>
+</selector>
+

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

@@ -0,0 +1,20 @@
+<?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.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutviewroot_ll"/>
+</LinearLayout>

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

@@ -0,0 +1,30 @@
+<?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
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="right">
+
+		<Button
+			android:layout_width="48dp"
+			android:layout_height="48dp"
+			android:text="⚙️"
+			android:onClick="onSFTPSettings"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="48dp"
+			android:text="Backups"
+			android:onClick="onBackups"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+

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

@@ -0,0 +1,15 @@
+<?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">
+
+	<cc.winboll.studio.libappbase.GlobalCrashReportView
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/activityglobalcrashGlobalCrashReportView1"/>
+
+</LinearLayout>
+

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

@@ -0,0 +1,14 @@
+<?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:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libappbase.LogView
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/logview"/>
+
+</LinearLayout>
+

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

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:padding="24dp"
+    android:gravity="center_horizontal"
+    android:background="@android:color/white">
+
+    <!-- NFC状态提示文本 -->
+    <TextView
+        android:id="@+id/tv_nfc_state"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="正在监听NFC卡片，请贴近设备检测密钥..."
+        android:textSize="17sp"
+        android:textColor="@android:color/black"
+        android:gravity="center"
+        android:padding="12dp"
+        android:layout_marginBottom="30dp"/>
+
+    <!-- 私钥显示区域 -->
+    <TextView
+        android:id="@+id/tv_private_key"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="私钥内容：无"
+        android:textSize="14sp"
+        android:textColor="@android:color/darker_gray"
+        android:layout_marginBottom="12dp"
+        android:maxLines="5"
+        android:ellipsize="end"/>
+
+    <!-- 公钥显示区域 -->
+    <TextView
+        android:id="@+id/tv_public_key"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="公钥内容：无"
+        android:textSize="14sp"
+        android:textColor="@android:color/darker_gray"
+        android:layout_marginBottom="40dp"
+        android:maxLines="5"
+        android:ellipsize="end"/>
+
+    <!-- 核心功能按钮（复用：保存本地/初始化密钥） -->
+    <Button
+        android:id="@+id/btn_create_write_key"
+        android:layout_width="300dp"
+        android:layout_height="wrap_content"
+        android:text="功能按钮待激活"
+        android:textSize="16sp"
+        android:textColor="@android:color/white"
+        android:backgroundTint="@android:color/holo_blue_light"
+        android:padding="14dp"
+        android:enabled="false"/>
+
+</LinearLayout>
+

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

@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:padding="20dp"
+    android:gravity="center_horizontal">
+
+    <!-- 标题 -->
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="SFTP备份配置"
+        android:textSize="18sp"
+        android:textColor="#333333"
+        android:layout_marginBottom="20dp"/>
+
+    <!-- 基础配置区域 -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:layout_marginBottom="15dp">
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="基础配置"
+            android:textSize="16sp"
+            android:textColor="#666666"
+            android:layout_marginBottom="10dp"/>
+
+        <EditText
+            android:id="@+id/et_sftp_server"
+            android:layout_width="match_parent"
+            android:layout_height="48dp"
+            android:hint="SFTP服务器地址（IP/域名）"
+            android:paddingHorizontal="15dp"
+            android:background="@drawable/shape_edittext_bg"
+            android:layout_marginBottom="8dp"/>
+
+        <EditText
+            android:id="@+id/et_sftp_port"
+            android:layout_width="match_parent"
+            android:layout_height="48dp"
+            android:hint="端口号（默认22）"
+            android:inputType="number"
+            android:paddingHorizontal="15dp"
+            android:background="@drawable/shape_edittext_bg"
+            android:layout_marginBottom="8dp"/>
+
+        <EditText
+            android:id="@+id/et_sftp_username"
+            android:layout_width="match_parent"
+            android:layout_height="48dp"
+            android:hint="登录用户名"
+            android:paddingHorizontal="15dp"
+            android:background="@drawable/shape_edittext_bg"
+            android:layout_marginBottom="8dp"/>
+
+        <EditText
+            android:id="@+id/et_sftp_pwd"
+            android:layout_width="match_parent"
+            android:layout_height="48dp"
+            android:hint="登录密码"
+            android:inputType="textPassword"
+            android:paddingHorizontal="15dp"
+            android:background="@drawable/shape_edittext_bg"/>
+    </LinearLayout>
+
+    <!-- 秘钥配置区域 -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:layout_marginBottom="15dp">
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="秘钥配置（可选，优先账号密码）"
+            android:textSize="16sp"
+            android:textColor="#666666"
+            android:layout_marginBottom="10dp"/>
+
+        <EditText
+            android:id="@+id/et_sftp_key_path"
+            android:layout_width="match_parent"
+            android:layout_height="48dp"
+            android:hint="秘钥本地路径（如/sdcard/key.pem）"
+            android:paddingHorizontal="15dp"
+            android:background="@drawable/shape_edittext_bg"
+            android:layout_marginBottom="8dp"/>
+
+        <EditText
+            android:id="@+id/et_sftp_key_pwd"
+            android:layout_width="match_parent"
+            android:layout_height="48dp"
+            android:hint="秘钥密码（无则留空）"
+            android:inputType="textPassword"
+            android:paddingHorizontal="15dp"
+            android:background="@drawable/shape_edittext_bg"/>
+    </LinearLayout>
+
+    <!-- 高级配置区域 -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:layout_marginBottom="20dp">
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="高级配置"
+            android:textSize="16sp"
+            android:textColor="#666666"
+            android:layout_marginBottom="10dp"/>
+
+        <EditText
+            android:id="@+id/et_sftp_charset"
+            android:layout_width="match_parent"
+            android:layout_height="48dp"
+            android:hint="编码（默认UTF-8）"
+            android:paddingHorizontal="15dp"
+            android:background="@drawable/shape_edittext_bg"
+            android:text="UTF-8"/>
+    </LinearLayout>
+
+    <!-- 操作按钮 -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:gravity="center"
+        android:spacing="10dp">
+        <Button
+            android:id="@+id/btn_sftp_clear"
+            android:layout_width="0dp"
+            android:layout_height="48dp"
+            android:layout_weight="1"
+            android:text="清空"
+            android:backgroundTint="#FF9500"
+            android:textColor="#FFFFFF"/>
+
+        <Button
+            android:id="@+id/btn_sftp_cancel"
+            android:layout_width="0dp"
+            android:layout_height="48dp"
+            android:layout_weight="1"
+            android:text="取消"
+            android:backgroundTint="#999999"
+            android:textColor="#FFFFFF"/>
+
+        <Button
+            android:id="@+id/btn_sftp_save"
+            android:layout_width="0dp"
+            android:layout_height="48dp"
+            android:layout_weight="1"
+            android:text="保存"
+            android:backgroundTint="#007AFF"
+            android:textColor="#FFFFFF"/>
+    </LinearLayout>
+
+</LinearLayout>
+

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

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="wrap_content"
+	android:layout_height="wrap_content"
+	android:orientation="vertical"
+	android:padding="16dp"
+	android:gravity="center"
+	android:background="#FFDCDCDC">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="应用指纹校验"
+		android:textSize="16sp"
+		android:textColor="@color/gray_900"
+		android:textStyle="bold"
+		android:layout_marginBottom="12dp"/>
+
+	<ScrollView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content">
+
+		<EditText
+			android:id="@+id/et_sign_fingerprint"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:background="@android:drawable/edit_text"
+			android:textSize="12sp"
+			android:gravity="top"
+			android:hint="签名获取中..."
+			android:singleLine="false"
+			android:scrollHorizontally="false"
+			android:scrollbars="vertical"
+			android:overScrollMode="always"
+			android:typeface="monospace"
+			android:paddingLeft="10dp"
+			android:paddingRight="10dp"/>
+
+	</ScrollView>
+
+	<TextView
+		android:id="@+id/tv_auth_result"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp"
+		android:textSize="11sp"
+		android:gravity="center"
+		android:textColor="@color/gray_900"/>
+
+</LinearLayout>
+

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

@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:padding="16dp"
+    android:background="#FFFFFF">
+
+    <!-- 标题 -->
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="设置服务器地址"
+        android:textSize="16sp"
+        android:textColor="#212121"
+        android:textStyle="bold"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 地址输入框 -->
+    <EditText
+        android:id="@+id/et_host_input"
+        android:layout_width="300dp"
+        android:layout_height="wrap_content"
+        android:hint="请输入服务器地址（如http://localhost:8080）"
+        android:textSize="14sp"
+        android:inputType="textUri"
+        android:padding="8dp"
+        android:background="@android:drawable/edit_text"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 按钮容器 -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:gravity="end">
+
+        <!-- 取消按钮 -->
+        <Button
+            android:id="@+id/btn_cancel"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="取消"
+            android:textSize="14sp"
+            android:layout_marginRight="8dp"/>
+
+        <!-- 确认按钮 -->
+        <Button
+            android:id="@+id/btn_confirm"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="确认"
+            android:textSize="14sp"
+            android:backgroundTint="#2196F3"
+            android:textColor="#FFFFFF"/>
+
+    </LinearLayout>
+
+</LinearLayout>
+

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

@@ -0,0 +1,24 @@
+<?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="horizontal"
+	android:layout_width="wrap_content"
+	android:layout_height="match_parent"
+	android:background="@drawable/bg_border_round">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="@dimen/log_button_height"
+		android:textSize="@dimen/log_text_size"
+		android:layout_marginLeft="5dp"
+		android:id="@+id/viewlogtagTextView1"/>
+
+	<CheckBox
+		android:layout_width="wrap_content"
+		android:layout_height="@dimen/log_button_height"
+		android:textSize="@dimen/log_text_size"
+		android:id="@+id/viewlogtagCheckBox1"/>
+
+</LinearLayout>
+

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

@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="vertical"
+		android:gravity="center_horizontal"
+		android:paddingLeft="16dp"
+		android:paddingTop="32dp"
+		android:paddingRight="16dp"
+		android:paddingBottom="32dp">
+
+		<ImageView
+			android:id="@+id/iv_app_icon"
+			android:layout_width="48dp"
+			android:layout_height="48dp"
+			android:layout_marginBottom="16dp"
+			android:scaleType="centerCrop"/>
+
+		<TextView
+			android:id="@+id/tv_app_name_version"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="18sp"
+			android:textColor="@color/gray_900"/>
+
+		<TextView
+			android:id="@+id/tv_app_desc"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="8dp"
+			android:layout_marginBottom="16dp"
+			android:textSize="14sp"
+			android:textColor="@color/gray_500"/>
+
+		<View
+			android:layout_width="match_parent"
+			android:layout_height="1px"
+			android:layout_marginTop="8dp"
+			android:layout_marginBottom="16dp"
+			android:background="@color/gray_200"/>
+
+		<LinearLayout
+			android:id="@+id/ll_function_container"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"/>
+
+		<LinearLayout
+			android:orientation="horizontal"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center"
+			android:layout_marginTop="16dp"
+			android:spacing="20dp">
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_winboll"
+				android:id="@+id/ib_winbollhostdialog"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_key"
+				android:id="@+id/ib_signgetdialog"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+</ScrollView>
+

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

@@ -0,0 +1,35 @@
+<?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:id="@+id/viewglobalcrashreportLinearLayout1">
+
+    <android.widget.Toolbar
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+		android:id="@+id/viewglobalcrashreportToolbar1"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<HorizontalScrollView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent">
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:background="#FFFFFFFF"
+				android:id="@+id/viewglobalcrashreportTextView1"/>
+
+		</HorizontalScrollView>
+
+	</ScrollView>
+
+</LinearLayout>
+

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

@@ -0,0 +1,148 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="#FF000000">
+
+	<RelativeLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="34dp"
+		android:layout_alignParentTop="true"
+		android:background="@drawable/bg_toolbar_log"
+		android:id="@+id/viewlogRelativeLayoutToolbar">
+
+		<Button
+			android:layout_width="@dimen/log_button_width"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:text="Clean"
+			android:textColor="@color/white"
+			android:backgroundTint="@drawable/btn_gray_bg"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogButtonClean"
+			android:layout_marginLeft="5dp"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="20dp"
+			android:textSize="@dimen/log_text_size"
+			android:padding="@dimen/log_text_padding"
+			android:text="LV:"
+			android:layout_toRightOf="@+id/viewlogButtonClean"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogTextView1"
+			android:background="@color/btn_gray_normal"
+			android:textColor="@color/black"/>
+
+		<cc.winboll.studio.libappbase.widget.LogTagSpinner
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_toRightOf="@+id/viewlogTextView1"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogSpinner1"
+			android:padding="@dimen/log_spinner_text_padding"/>
+
+		<CheckBox
+			android:layout_width="@dimen/log_checkbox_width"
+			android:layout_height="@dimen/log_checkbox_height"
+			android:textSize="@dimen/log_text_size"
+			android:layout_toLeftOf="@+id/viewlogButtonCopy"
+			android:layout_centerVertical="true"
+			android:text="Selectable"
+			android:background="@color/btn_gray_normal"
+			android:id="@+id/viewlogCheckBoxSelectable"
+			android:padding="@dimen/log_text_padding"
+			android:textColor="@color/white"/>
+
+		<Button
+			android:layout_width="@dimen/log_button_width"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:textColor="@color/white"
+			android:backgroundTint="@drawable/btn_gray_bg"
+			android:text="Copy"
+			android:layout_alignParentRight="true"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogButtonCopy"
+			android:layout_marginRight="5dp"/>
+
+	</RelativeLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/log_button_height"
+		android:layout_below="@+id/viewlogRelativeLayoutToolbar"
+		android:id="@+id/viewlogLinearLayout1"
+		android:gravity="center_vertical"
+		android:background="@drawable/bg_toolbar_log">
+
+		<CheckBox
+			android:layout_width="wrap_content"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:text="ALL"
+			android:padding="2dp"
+			android:id="@+id/viewlogCheckBox1"
+			android:background="@drawable/bg_border_round"
+			android:layout_marginLeft="5dp"
+			android:layout_marginRight="5dp"/>
+
+		<EditText
+			android:layout_width="50dp"
+			android:ems="10"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:singleLine="true"
+			android:id="@+id/tagsearch_et"/>
+
+		<HorizontalScrollView
+			android:layout_width="0dp"
+			android:layout_height="match_parent"
+			android:background="@drawable/bg_border"
+			android:scrollbars="none"
+			android:padding="2dp"
+			android:layout_weight="1.0"
+			android:id="@+id/viewlogHorizontalScrollView1">
+
+			<cc.winboll.studio.libappbase.views.HorizontalListView
+				android:layout_width="wrap_content"
+				android:layout_height="match_parent"
+				android:id="@+id/tags_listview"/>
+
+		</HorizontalScrollView>
+
+	</LinearLayout>
+
+	<RelativeLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_weight="1.0"
+		android:layout_alignParentBottom="true"
+		android:layout_below="@+id/viewlogLinearLayout1">
+
+		<ScrollView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:background="#FF000000"
+			android:id="@+id/viewlogScrollViewLog">
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:textSize="@dimen/log_text_size"
+				android:text="Text"
+				android:textColor="#FF00FF00"
+				android:textIsSelectable="true"
+				android:id="@+id/viewlogTextViewLog"/>
+
+		</ScrollView>
+
+	</RelativeLayout>
+
+</RelativeLayout>
+

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

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <array name="enum_loglevel_array">
+        <item>Off</item>
+        <item>Error</item>
+        <item>Warn</item>
+        <item>Info</item>
+        <item>Debug</item>
+        <item>Verbose</item>
+    </array>
+</resources>

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

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <attr name="themeGlobalCrashActivity" format="reference"/>
+
+    <declare-styleable name="GlobalCrashActivity">
+        <attr name="colorTittle" format="color" />
+        <attr name="colorTittleBackgound" format="color" />
+        <attr name="colorText" format="color" />
+        <attr name="colorTextBackgound" format="color" />
+    </declare-styleable>
+
+</resources>

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

@@ -0,0 +1,74 @@
+<?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>
+	<color name="colorTextBackgound">#FF000000</color>
+
+	<!-- ============== 基础黑白（必含，适配文字/背景） ============== -->
+	<color name="white">#FFFFFF</color>          <!-- 纯白色（文字/背景） -->
+	<color name="black">#000000</color>          <!-- 近黑色（重要文字） -->
+
+	<!-- ============== 基础色系（按钮/强调色常用） ============== -->
+	<!-- 蓝色系（常用：确认/链接/主题色） -->
+	<color name="blue_light">#4A90E2</color>     <!-- 浅蓝（次要按钮） -->
+	<color name="blue_normal">#2196F3</color>    <!-- 标准蓝（主题/确认按钮） -->
+	<color name="blue_dark">#1976D2</color>      <!-- 深蓝（按压态/重要强调） -->
+	<!-- 绿色系（常用：成功/完成/安全提示） -->
+	<color name="green_light">#66BB6A</color>    <!-- 浅绿（次要成功态） -->
+	<color name="green_normal">#4CAF50</color>   <!-- 标准绿（成功按钮/提示） -->
+	<color name="green_dark">#388E3C</color>     <!-- 深绿（按压态/重要成功） -->
+	<!-- 红色系（常用：错误/警告/删除按钮） -->
+	<color name="red_light">#EF5350</color>      <!-- 浅红（次要错误提示） -->
+	<color name="red_normal">#F44336</color>     <!-- 标准红（删除/错误按钮） -->
+	<color name="red_dark">#D32F2F</color>       <!-- 深红（按压态/重要错误） -->
+	<!-- 黄色系（常用：警告/提醒/高亮） -->
+	<color name="yellow_light">#FFF59D</color>   <!-- 浅黄（次要提醒） -->
+	<color name="yellow_normal">#FFC107</color>  <!-- 标准黄（警告提示/高亮） -->
+	<color name="yellow_dark">#FFA000</color>    <!-- 深黄（重要警告） -->
+	<!-- 橙色系（常用：提醒/进度/活力色） -->
+	<color name="orange_normal">#FF9800</color>  <!-- 标准橙（提醒按钮/进度） -->
+	<!-- 紫色系（常用：特殊强调/个性按钮） -->
+	<color name="purple_normal">#9C27B0</color>  <!-- 标准紫（特殊功能按钮） -->
+
+	<!-- ============== 透明色（遮罩/背景叠加） ============== -->
+	<color name="transparent">#00000000</color>  <!-- 全透明 -->
+	<color name="black_transparent_50">#80000000</color> <!-- 50%透明黑（遮罩） -->
+
+
+
+	<!-- 1. 不透明灰色（常用深浅梯度，直接用） -->
+	<color name="gray_100">#F5F5F5</color> <!-- 极浅灰（接近白色，背景用） -->
+	<color name="gray_200">#EEEEEE</color> <!-- 浅灰（卡片/分割线背景） -->
+	<color name="gray_300">#E0E0E0</color> <!-- 中浅灰（边框/次要背景） -->
+	<color name="gray_400">#BDBDBD</color> <!-- 中灰（次要文字/图标） -->
+	<color name="gray_500">#9E9E9E</color> <!-- 标准中灰（常用辅助文字） -->
+	<color name="gray_600">#757575</color> <!-- 中深灰（常规辅助文字） -->
+	<color name="gray_700">#616161</color> <!-- 深灰（重要辅助文字） -->
+	<color name="gray_800">#424242</color> <!-- 极深灰（接近黑色，标题副文本） -->
+	<color name="gray_900">#212121</color> <!-- 近黑色（特殊场景用） -->
+
+	<!-- 2. 半透明灰色（带透明度，遮罩/蒙层用） -->
+	<color name="gray_transparent_30">#4D9E9E9E</color> <!-- 30%透明中灰（A=4D） -->
+	<color name="gray_transparent_50">#809E9E9E</color> <!-- 50%透明中灰（A=80） -->
+	<color name="gray_transparent_70">#B39E9E9E</color> <!-- 70%透明中灰（A=B3） -->
+
+	<color name="gray_light">#EEE</color>  <!-- 等价 #EEEEEE（浅灰） -->
+	<color name="gray_mid">#999</color>    <!-- 等价 #999999（中灰） -->
+	<color name="gray_dark">#666</color>   <!-- 等价 #666666（深灰） -->
+	<color name="gray_black">#333</color>  <!-- 等价 #333333（极深灰） -->
+
+	<!-- 50% 透明中灰（弹窗遮罩常用） -->
+	<color name="mask_gray">#809E9E9E</color>
+	<!-- 30% 透明深灰（背景叠加） -->
+	<color name="bg_overlay_gray">#4D424242</color>
+
+	<!-- 1. 常规灰色（按钮默认态，常用中灰） -->
+	<color name="btn_gray_normal">#9E9E9E</color>
+	<!-- 2. 按压深色（按钮点击态，加深一级，提升交互感） -->
+	<color name="btn_gray_pressed">#757575</color>
+	<!-- 3. 禁用灰色（按钮不可点击态，浅灰） -->
+	<color name="btn_gray_disabled">#E0E0E0</color>
+
+</resources>

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

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <dimen name="log_text_size">12dp</dimen>
+	<dimen name="log_text_padding">2dp</dimen>
+
+    <dimen name="log_button_width">65dp</dimen>
+    <dimen name="log_button_height">34dp</dimen>
+
+    <dimen name="log_checkbox_width">100dp</dimen>
+    <dimen name="log_checkbox_height">20dp</dimen>
+	
+	<dimen name="log_spinner_width">60dp</dimen>
+	<dimen name="log_spinner_height">16dp</dimen>
+	<dimen name="log_spinner_item_width">@dimen/log_spinner_width</dimen>
+	<dimen name="log_spinner_item_height">@dimen/log_spinner_height</dimen>
+	<dimen name="log_spinner_text_size">@dimen/log_text_size</dimen>
+	<dimen name="log_spinner_text_padding">@dimen/log_text_padding</dimen>
+
+</resources>

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

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libappbase</string>
+    <string name="hello_world">Hello, world!</string>
+</resources>

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

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <style name="APPBaseTheme" parent="@android:style/Theme.DeviceDefault.Light.NoActionBar">
+        <item name="themeGlobalCrashActivity">@style/GlobalCrashActivityTheme</item>
+    </style>
+
+    <style name="GlobalCrashActivityTheme" parent="@android:style/Theme.DeviceDefault.Light.NoActionBar">
+        <item name="colorTittle">#FFFFF600</item>
+        <item name="colorTittleBackgound">#FF00B322</item>
+        <item name="colorText">#FF00B322</item>
+        <item name="colorTextBackgound">#FF000000</item>
+	</style>
+	
+	<style name="DialogStyle" parent="@android:style/Theme.Dialog">
+		<item name="android:windowBackground">@android:color/transparent</item>
+		<item name="android:windowNoTitle">true</item>
+	</style>
+
+</resources>

libappbase/src/main/res/xml/network_security_config.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <!-- 原有配置 保留 -->
+        <domain includeSubdomains="true">winboll.cc</domain>
+        <domain includeSubdomains="true">localhost</domain>
+        <domain includeSubdomains="true">127.0.0.1</domain>
+
+        <!-- 精准配置10.8.0.0/24 前20个IP（10.8.0.0~10.8.0.19）-->
+        <domain includeSubdomains="false">10.8.0.0</domain>
+        <domain includeSubdomains="false">10.8.0.1</domain>
+        <domain includeSubdomains="false">10.8.0.2</domain>
+        <domain includeSubdomains="false">10.8.0.3</domain>
+        <domain includeSubdomains="false">10.8.0.4</domain>
+        <domain includeSubdomains="false">10.8.0.5</domain>
+        <domain includeSubdomains="false">10.8.0.6</domain>
+        <domain includeSubdomains="false">10.8.0.7</domain>
+        <domain includeSubdomains="false">10.8.0.8</domain>
+        <domain includeSubdomains="false">10.8.0.9</domain>
+        <domain includeSubdomains="false">10.8.0.10</domain>
+        <domain includeSubdomains="false">10.8.0.11</domain>
+        <domain includeSubdomains="false">10.8.0.12</domain>
+        <domain includeSubdomains="false">10.8.0.13</domain>
+        <domain includeSubdomains="false">10.8.0.14</domain>
+        <domain includeSubdomains="false">10.8.0.15</domain>
+        <domain includeSubdomains="false">10.8.0.16</domain>
+        <domain includeSubdomains="false">10.8.0.17</domain>
+        <domain includeSubdomains="false">10.8.0.18</domain>
+        <domain includeSubdomains="false">10.8.0.19</domain>
+    </domain-config>
+</network-security-config>
+
+
+
+

settings.gradle

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

winboll/README.md

@@ -13,6 +13,9 @@ WinBoLL 网站浏览器。
 阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh winboll
 
 #### 使用说明
+3. Termux应用配置：
+- 已安装Termux（包名 com.termux ）；
+- 执行  echo "allow-external-apps = true" > ~/.termux/termux.properties
 
 #### 参与贡献
 

winboll/build.gradle

@@ -73,12 +73,13 @@ dependencies {
      implementation 'com.alibaba:fastjson:1.2.76'
     
 	// AndroidX 类库
-    api 'androidx.appcompat:appcompat:1.1.0'
+    /*api 'androidx.appcompat:appcompat:1.1.0'
     //api 'com.google.android.material:material:1.4.0'
     //api 'androidx.viewpager:viewpager:1.0.0'
     //api 'androidx.vectordrawable:vectordrawable:1.1.0'
     //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
-    //api 'androidx.fragment:fragment:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'*/
+	
 	
 	// 米盟
 	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
@@ -88,14 +89,31 @@ dependencies {
     api 'com.google.code.gson:gson:2.8.5'
     api 'com.github.bumptech.glide:glide:4.9.0'
     //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+
+	implementation "androidx.annotation:annotation:1.3.0"
+    implementation "androidx.core:core:1.6.0"
+    implementation "androidx.drawerlayout:drawerlayout:1.1.1"
+    implementation "androidx.preference:preference:1.1.1"
+    implementation "androidx.viewpager:viewpager:1.0.0"
+    implementation "com.google.android.material:material:1.4.0"
+    implementation "com.google.guava:guava:24.1-jre"
+    /*
+	implementation "io.noties.markwon:core:$markwonVersion"
+    implementation "io.noties.markwon:ext-strikethrough:$markwonVersion"
+    implementation "io.noties.markwon:linkify:$markwonVersion"
+    implementation "io.noties.markwon:recycler:$markwonVersion"
+	*/
+	implementation 'com.termux:terminal-emulator:0.118.0'
+	implementation 'com.termux:terminal-view:0.118.0'
+	implementation 'com.termux:termux-shared:0.118.0'
 	
 	// WinBoLL库 nexus.winboll.cc 地址
-	api 'cc.winboll.studio:libaes:15.12.13'
-    api 'cc.winboll.studio:libappbase:15.14.2'
+	api 'cc.winboll.studio:libaes:15.15.2'
+    api 'cc.winboll.studio:libappbase:15.15.11'
 	
 	// WinBoLL备用库 jitpack.io 地址
-	//api 'com.github.ZhanGSKen:AES:aes-v15.12.9'
-	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.14.1'
+	//api 'com.github.ZhanGSKen:AES:aes-v15.15.7'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.4'
 	
 	api fileTree(dir: 'libs', include: ['*.jar'])
 }

winboll/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Tue Jan 13 03:11:40 HKT 2026
-stageCount=10
+#Thu Jan 29 17:03:53 HKT 2026
+stageCount=15
 libraryProject=
 baseVersion=15.11
-publishVersion=15.11.9
+publishVersion=15.11.14
 buildCount=0
-baseBetaVersion=15.11.10
+baseBetaVersion=15.11.15