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

.gitignore

@@ -97,5 +97,10 @@ lint-results.html
 ## WinBoLL 基础应用(避免上传敏感配置)
 /winboll.properties
 /local.properties
+
+## WinBoLL 衍生应用，
+## 外派类型类库应用需要注释掉以下部分，以便部署通用类库编译配置。
+## APPBase,AES需要上传以下两种配置。
+## OriginMaster 仓库合并各类分支需要忽略的文件修改
 /settings.gradle
 /gradle.properties

.winboll/winboll_app_build.gradle

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

README.md

@@ -1,105 +1,104 @@
-# WinBoLL 源生态计划项目说明书
+WinBoLL 源生态计划项目说明书
  
-## 一、项目概述
+一、项目概述
  
-### 1. 核心定位
+1. 核心定位
-WinBoLL 手机源码计划，旨在通过核心项目 WinBoLL 构建手机端与服务器端的 Android 项目的开发源码生态。实现手机与服务器的源码的联合开发。
  
-### 2. 仓库架构
+【OriginMaster】WinBoLL 源生态计划，旨在通过核心项目 WinBoLL 联动系列开发库，构建手机端 Android 项目开发与多端编译同步的完整生态，实现手机与电脑的源码同步开发。
-#### **仓库类型：功能说明**
-☆ 基础项目分支 WinBoLL：手机端安卓应用开发基础模板。
-☆ 应用项目分支 APPBase、AES、PowerBell、Positions**：安卓应用单一管理系列项目。
-☆ 源码汇总管理 OriginMaster**：各类分支源码合并存档，不适宜作为开发库使用。
  
-### 3. 源码合并管理推送路线图
+2. 仓库架构
-⚠️ **注意**：仅仅展示不同应用模块源码的综合管理路线。分支合并操作时，必须具备 Git 管理经验。
  
-★ WinBoLL → APPBase → OriginMaster
+仓库类型 包含仓库 功能说明 
-★ WinBoLL → AES → OriginMaster
+开发库 WinBoLL、APPBase、AES、PowerBell、Positions 核心开发依赖库，其中 WinBoLL 可作为应用开发的基础继承模板 
-★ WinBoLL → PowerBell → OriginMaster
+分支汇总存档库 OriginMaster 仅用于汇总各开发库分支，不适宜作为开发库克隆使用，非应用开发基础库 
-★ WinBoLL → Positions → OriginMaster
  
-## 二、WinBoLL 项目核心信息
+3. 源码推送路径
  
-### 1. 项目简介
+- WinBoLL → APPBase → OriginMaster
-☆ WinBoLL 项目是为手机端开发Android 项目的需求而设计的项目。
+- WinBoLL → AES → OriginMaster
+- WinBoLL → PowerBell → OriginMaster
+- WinBoLL → Positions → OriginMaster
  
-### 2. 官方资源
+二、WinBoLL APP 核心信息
-#### ☆ 官方网站**：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
  
-## 三、应用编译环境检查问题
+1. 项目简介
-### 核心判断条件：
-☆ WinBoLL 项目以文件夹 `"/sdcard/WinBoLLStudio/APKs"` 是否存在为判断环境编译输出条件，因为编译输出的APK文件需要一个可供保存的环境。
  
-☆ 文件夹"/sdcard/WinBoLLStudio/APKs" 目录条件设置方法：
+WinBoLL Studio Android 应用开源项目，专注于手机端 Android 开发与多端编译同步。
-***Linux 服务器端方面***：建立 `/sdcard/WinBoLLStudio/APKs` 目录即可。
-***手机开发端方面***：建立 `"/sdcard/WinBoLLStudio/APKs"` 目录(即 `"/storage/emulated/0/WinBoLLStudio/APKs"` 目录) 即可。
  
-## 四、前置条件
+2. 官方资源
  
-### 1. WinBoLL APP 开发环境配置介绍
+- 官方网站：https://www.winboll.cc/
-####  WinBoLL APK 编译输出内容包括：
+- 源码地址：
-☆ "/sdcard/WinBoLLStudio/APKs"` 目录内的所有应用分支的 APK 文件。
+- Gitea：https://gitea.winboll.cc/Studio/WinBoLL.git
-winboll.properties 文件的 APKOutputPath 属性可配置这个 APK 输出目录的路径。
+- GitHub：https://github.com/ZhanGSKen/WinBoLL.git
-☆ "/sdcard/AppProjects/app.apk"文件。
+- 码云：https://gitee.com/zhangsken/winboll.git
-winboll.properties 文件的 ExtraAPKOutputPath 属性可配置这个 APK 额外输出文件的路径
+- 托管类库源码：
-#### WinBoLL APK 源码命名空间规范
+- APPBase（jitpack.io）：https://github.com/ZhanGSKen/APPBase.git
-☆ WinBoLL 项目使用 "cc.winboll.studio" 作为源码命名空间。在此命名空间下进行源码定义。
+- AES（jitpack.io）：https://github.com/ZhanGSKen/AES.git
  
-## 五、核心需求规划
+三、通用特征文件夹前置（/sdcard）
  
-### 1. WinBoLL 应用安全验证需求
+- Linux 系统文件夹直接使用  /sdcard 。
-#### ☆ 支持访问 https://console.winboll.cc/ 服务器以校验应用包签名与版本。
+- 手机 SD 卡存储（ /storage/emulated/0 ）挂载的别名也可为  /sdcard 。
  
-### 2. 手机端源码开发管理需求
+四、前置条件
-#### ☆ 支持切换不同 WinBoLL 分支，以开发不同安卓应用。
  
-## 六、编译与使用指南
+1. WinBoLL-APP 配置
  
-### 1. 项目初始化（必须）
+- APK 编译输出目录： /sdcard/WinBoLLStudio/APKs/ ，以及  /sdcard/AppProjects/ （命名为  app.apk ）
-#### 1.  复制 `settings.gradle-demo` 为 `settings.gradle`。编辑 `settings.gradle` 文件内容，取消对应项目模块注释。
+- 签名与命名空间：支持应用签名验证定制化，与衍生 APP 共享  cc.winboll.studio  命名空间
-#### 2.  复制 `gradle.properties-androidx-demo` (Android X 项目) 或 `gradle.properties-android-demo` (基本 Android 项目) 为 `gradle.properties`。
-#### 3.  复制（可选）`local.properties-demo` 为 `local.properties`，编辑 `local.properties` 文件内容，配置 Android SDK 目录。
-#### 4.  **签名设置**：
-    ☆ **调试编译秘钥制作**：使用 Termux 应用终端，cd 进入 GenKeyStore 目录，运行 `bash gen_debug_keystore.sh` 脚本即可生成应用调试秘钥。
-    ☆  **应用秘钥配置方法**：拷贝调试编译秘钥制作生成的 `appkey.jks` 与 `appkey.keystore` 文件到项目根目录即可。
  
-## 七、应用编译命令介绍
+五、核心需求规划
  
-### （1）类库型模块配置要点
+1. 主机端需求
-#### 1.  **优先修改配置文件**：优先修改应用测试项目（目录为 `"<WinBoLl根目录>/<类库测试应用>/"`）内 `build.properties` 文件，设置对应的类库项目名称：`libraryProject=<类库项目模块名>`。
-#### 2.  **编译优先启动步骤**：使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishAPKAddTag.sh <类库测试项目模块名>` 命令。运行后可生成测试项目与类库项目的编译参数文件 `build.properties`。生成的 `build.properties` 文件有两份，一份在测试项目模块的文件夹内，一份在类库项目本身的模块文件夹内。
-#### 3.  **最后类库编译发布步骤**：使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishLIBAddTag.sh <类库项目模块名>` 命令。运行后可发布至 WinBoLL Nexus Maven 库、本地 maven 目录或者是通用默认的 Gradle Maven 库。
  
-### （2）单一应用型模块与类库测试型模块配置要点
+- 支持  winboll.cc  域名的用户注册登录服务
-#### ☆ APK 编译方法：
+- 支持  https://console.winboll.cc/api  访问
-使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名>`。
-#### ☆ 运行后的 APK 输出路径：
-★ 默认路径 (`$ bash gradlew assembleBetaDebug` 任务)：APK 在 `/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/debug/` 目录。
-★ 默认路径 (`$ bash assembleStageRelease` 任务)：APK 在 `/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/` 目录。
-★ 额外输出路径：(假设 `winboll.properties` 文件已配置 `ExtraAPKOutputPath` 属性) 输出至 `ExtraAPKOutputPath` 属性配置的目录下。
  
-### （3）手机端应用调试命令介绍
+2. APP 端需求
-#### ☆ Beta 渠道调试命令
-$bash gradlew assembleBetaDebug
  
-#### ☆ Stage 渠道调试命令
+- 实现手机端 Android 应用开发与管理功能
-$bash gradlew assembleStageDebug
  
-### （4）服务器端开发命令介绍
+六、编译与使用指南
-##### ☆ Stage 渠道应用发布命令为：
-（"<WinBoLl根目录>/settings.gradle"文件需要配置编译模块开启参数，拷贝 settings.gradle-demo 为 settings.gradle 文件取消对应的分支配置部分即可。）
-$bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
-或者是
-$bash gradlew assembleStageRelease
  
+1. 项目初始化（必须）
  
-## 八、WinBoLL 应用 APK 版本号命名规则
+1. 复制  settings.gradle-demo  为  settings.gradle ，取消对应项目模块注释
-### ☆ Stage 渠道：
+2. 复制  gradle.properties-androidx-demo  或  gradle.properties-android-demo  为  gradle.properties 
-#### V<应用开发环境编号><应用功能变更号><应用调试阶段号> （示例： APPBase_15.7.0 ）
+3. （可选）复制  local.properties-demo  为  local.properties ，配置 Android SDK 目录
-### ☆ Beta 渠道：
+4. 签名设置：
-#### V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)> （示例： APPBase_15.9.6-beta8_5413 ）
+- 调试编译：进入 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 ）

aes/build.properties

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

aes/src/main/AndroidManifest.xml

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

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

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

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

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

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

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

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

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

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

@@ -6,7 +6,7 @@
 	android:layout_width="match_parent"
 	android:layout_height="match_parent">
 
-	<cc.winboll.studio.libaes.views.ASupportToolbar
+	<android.widget.Toolbar
 		android:layout_width="match_parent"
 		android:layout_height="wrap_content"
 		android:id="@+id/toolbar"/>

appbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Tue Apr 28 17:08:30 HKT 2026
+#Tue Jan 13 03:23:34 HKT 2026
-stageCount=22
+stageCount=5
 libraryProject=libappbase
 baseVersion=15.15
-publishVersion=15.15.21
+publishVersion=15.15.4
 buildCount=0
-baseBetaVersion=15.15.22
+baseBetaVersion=15.15.5

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

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

appbase/src/main/AndroidManifest.xml

@@ -16,17 +16,6 @@
             android:label="@string/app_name"
             android:exported="true"
             android:resizeableActivity="true"
-            android:launchMode="singleTop"
-            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
-
-        </activity>
-
-        <activity
-            android:name=".MainActivityAlias"
-            android:label="@string/app_name"
-            android:exported="true"
-            android:resizeableActivity="true"
-            android:launchMode="singleTop"
             android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
 
             <intent-filter>
@@ -41,17 +30,6 @@
 
         </activity>
 
-        <activity
-            android:name=".Main2Activity"
-            android:label="@string/app_name"
-            android:exported="true"
-            android:resizeableActivity="true"
-            android:launchMode="singleTop"
-            android:taskAffinity="cc.winboll.studio.appbase.Main2Activity"
-            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
-
-        </activity>
-
         <activity android:name=".GlobalApplication$CrashActivity"/>
 
         <meta-data

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

@@ -23,8 +23,17 @@ public class AboutActivity extends Activity {
         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());
@@ -34,10 +43,10 @@ public class AboutActivity extends Activity {
         LogUtils.d(TAG, "genDefaultAppInfo() 调用");
         String branchName = "appbase";
         APPInfo appInfo = new APPInfo();
-        appInfo.setAppName("APPBase");
+        appInfo.setAppName(getString(R.string.app_name));
         appInfo.setAppIcon(R.drawable.ic_winboll);
         appInfo.setAppDescription(getString(R.string.app_description));
-        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitName("APPBase");
         appInfo.setAppGitOwner("Studio");
         appInfo.setAppGitAPPBranch(branchName);
         appInfo.setAppGitAPPSubProjectFolder(branchName);

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

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

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

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

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

@@ -10,7 +10,6 @@ import android.view.MenuItem;
 import android.view.View;
 import android.widget.Toolbar;
 import cc.winboll.studio.appbase.R;
-import cc.winboll.studio.appbase.model.TestBean;
 import cc.winboll.studio.libappbase.LogActivity;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.ToastUtils;
@@ -37,27 +36,12 @@ public class MainActivity extends Activity {
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
-        //ToastUtils.show("onCreate"); // 显示 Activity 创建提示（调试用）
+        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";
     }
 
     /**
@@ -103,17 +87,14 @@ public class MainActivity extends Activity {
         }
     }
 
-    public void onLogTestNewTask(View view) {
-        LogActivity.startLogActivity(this, true);
-    }
-
     /**
      * 日志测试按钮点击事件（打开日志查看界面）
      * 启动 LogActivity，用于查看应用运行日志
      * @param view 触发事件的 View（对应布局中的日志测试按钮）
      */
     public void onLogTest(View view) {
-        LogActivity.startLogActivity(this, false);
+        // 启动日志查看 Activity（通过静态方法传入上下文，简化跳转逻辑）
+        LogActivity.startLogActivity(this);
     }
 
     /**
@@ -157,39 +138,10 @@ public class MainActivity extends Activity {
     }
 	
 	public void onAboutActivity(View view) {
-        LogUtils.d(TAG, "onAboutActivity() 调用");
+        LogUtils.d(TAG, "startAboutActivity() 调用");
         Intent aboutIntent = new Intent(getApplicationContext(), AboutActivity.class);
         startActivity(aboutIntent);
-    }
+        LogUtils.d(TAG, "startAboutActivity: 关于页面已启动");
-
-	public void onSplitScreenMode(View view) {
-        LogUtils.d(TAG, "onSplitScreenMode() 分屏测试按钮已点击");
-        ToastUtils.show("分屏测试：已启动新窗口");
-        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.N) {
-            android.graphics.Rect bounds = new android.graphics.Rect();
-            getWindow().getDecorView().getDisplay().getRectSize(bounds);
-            int height = bounds.height();
-            int width = bounds.width();
-            bounds.set(0, 0, width, height / 2);
-            LogUtils.d(TAG, "onSplitScreenMode() 分屏窗口范围: " + bounds);
-            android.content.Intent intent = new android.content.Intent(this, MainActivityAlias.class);
-            intent.setFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK);
-            LogUtils.d(TAG, "onSplitScreenMode() 准备启动MainActivityAlias");
-            android.app.ActivityOptions options = android.app.ActivityOptions.makeBasic();
-            options.setLaunchBounds(bounds);
-            startActivity(intent, options.toBundle());
-            LogUtils.d(TAG, "onSplitScreenMode() MainActivityAlias已启动");
-        }
-    }
-
-	public void onMultiInstance(View view) {
-        LogUtils.d(TAG, "onMultiInstance() 多开窗口按钮已点击");
-        ToastUtils.show("多开窗口：已启动新窗口");
-        android.content.Intent intent = new android.content.Intent(this, Main2Activity.class);
-        intent.setFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK);
-        LogUtils.d(TAG, "onMultiInstance() 准备启动Main2Activity");
-        startActivity(intent);
-        LogUtils.d(TAG, "onMultiInstance() Main2Activity已启动");
     }
 }
 

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

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

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

@@ -1,154 +0,0 @@
-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/layout/activity_main.xml

@@ -23,18 +23,6 @@
 			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="onAboutActivity"
-				android:layout_margin="10dp"/>
-
 			<Button
 				android:layout_width="match_parent"
 				android:layout_height="wrap_content"
@@ -59,18 +47,6 @@
 				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="onLogTestNewTask"
-				android:layout_margin="10dp"/>
-
 			<Button
 				android:layout_width="match_parent"
 				android:layout_height="wrap_content"
@@ -86,25 +62,13 @@
 			<Button
 				android:layout_width="match_parent"
 				android:layout_height="wrap_content"
-				android:text="分屏测试"
+				android:text="关于应用"
 				android:textSize="16sp"
 				android:textColor="@android:color/white"
 				android:background="#81C7F5"
 				android:paddingVertical="12dp"
 				android:layout_marginHorizontal="24dp"
-				android:onClick="onSplitScreenMode"
+				android:onClick="onAboutActivity"
-				android:layout_margin="10dp"/>
-
-			<Button
-				android:layout_width="match_parent"
-				android:layout_height="wrap_content"
-				android:text="多开窗口"
-				android:textSize="16sp"
-				android:textColor="@android:color/white"
-				android:background="#81C7F5"
-				android:paddingVertical="12dp"
-				android:layout_marginHorizontal="24dp"
-				android:onClick="onMultiInstance"
 				android:layout_margin="10dp"/>
 			
 		</LinearLayout>
@@ -112,3 +76,4 @@
 	</ScrollView>
 
 </LinearLayout>
+

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="app_name">APPBase</string>
+    <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>

build.gradle

@@ -1,15 +1,6 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 buildscript {
     repositories {
-        maven { url 'https://maven.aliyun.com/repository/public/' } 
-        maven { url 'https://maven.aliyun.com/repository/google/' }
-        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
-        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
-        maven { url "https://clojars.org/repo/" }
-        maven { url "https://jitpack.io" }
-        mavenCentral()
-        google()
-		
         mavenLocal {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
@@ -20,6 +11,19 @@ buildscript {
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
         // "WinBoLL Snapshot"
         maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
+        
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+        //println "mavenLocal : ==========="
+        //println mavenLocal().url
+        //println "mavenLocal : ==========="
+        //mavenLocal()
     }
     dependencies {
 	    // 适配MIUI12
@@ -31,15 +35,6 @@ buildscript {
 
 allprojects {
     repositories {
-        maven { url 'https://maven.aliyun.com/repository/public/' } 
-        maven { url 'https://maven.aliyun.com/repository/google/' }
-        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
-        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
-        maven { url "https://clojars.org/repo/" }
-        maven { url "https://jitpack.io" }
-        mavenCentral()
-        google()
-		
         mavenLocal {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
@@ -50,6 +45,19 @@ allprojects {
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
         // "WinBoLL Snapshot"
         maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
+        
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+        //println "mavenLocal : ==========="
+        //println mavenLocal().url
+        //println "mavenLocal : ==========="
+        //mavenLocal()
     }
     ext {
         // 定义全局变量，常用于版本管理
@@ -96,8 +104,8 @@ allprojects {
         // 1. 对纯 Java 模块的 JavaCompile 任务配置（升级为 Java 11）
         tasks.withType(JavaCompile) {
             options.compilerArgs << "-parameters"
-            sourceCompatibility = JavaVersion.VERSION_1_7
+            sourceCompatibility = JavaVersion.VERSION_11
-            targetCompatibility = JavaVersion.VERSION_1_7
+            targetCompatibility = JavaVersion.VERSION_11
             // 可选：确保编码一致
             options.encoding = "UTF-8"
         }

libaes/build.gradle

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

libaes/build.properties

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

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

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

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

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

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

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

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

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

libappbase/build.gradle

@@ -21,14 +21,5 @@ android {
 }
 
 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

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Tue Apr 28 17:08:04 HKT 2026
+#Tue Jan 13 03:23:17 HKT 2026
-stageCount=22
+stageCount=5
 libraryProject=libappbase
 baseVersion=15.15
-publishVersion=15.15.21
+publishVersion=15.15.4
 buildCount=0
-baseBetaVersion=15.15.22
+baseBetaVersion=15.15.5

libappbase/src/main/AndroidManifest.xml

@@ -3,21 +3,7 @@
     xmlns:android="http://schemas.android.com/apk/res/android"
     package="cc.winboll.studio.libappbase">
 
-    <!-- 拥有完全的网络访问权限 -->
+    <application>
-    <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"
@@ -38,15 +24,12 @@
             android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation"
             android:exported="true"
             android:launchMode="singleInstance"
-            android:taskAffinity="cc.winboll.studio.libappbase.LogActivity"
             android:process=":LogActivity">
 
         </activity>
 
         <activity android:name="cc.winboll.studio.libappbase.activities.NfcRsaLoginActivity"/>
 
-        <activity android:name="cc.winboll.studio.libappbase.activities.FTPBackupsActivity"/>
-
     </application>
 
 </manifest>

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

@@ -2,7 +2,6 @@ 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;
@@ -27,12 +26,6 @@ public class GlobalApplication extends Application {
      */
     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）
@@ -83,42 +76,6 @@ public class GlobalApplication extends Application {
         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;
-    }
-
     /**
      * 应用启动时初始化（仅执行一次）
      * 初始化核心框架、恢复调试状态、配置全局异常处理等
@@ -129,12 +86,11 @@ public class GlobalApplication extends Application {
         // 初始化单例实例（确保在所有初始化操作前完成）
         sInstance = this;
 		
+
         // 初始化基础组件（日志、崩溃处理、Toast）
         initCoreComponents();
         // 恢复/初始化调试模式状态（从本地文件读取，无文件则默认关闭调试）
         restoreDebugStatus();
-        // 新增：初始化服务器地址（从 SP 读取到内存，提高后续访问效率）
-        initWinbollHost();
 
         LogUtils.d(TAG, "GlobalApplication 初始化完成，单例实例已创建");
     }
@@ -175,11 +131,6 @@ public class GlobalApplication extends Application {
         }
     }
 
-    // 新增：初始化服务器地址（应用启动时从 SP 读取到内存）
-    private void initWinbollHost() {
-        getWinbollHost(); // 触发从 SP 读取并更新内存
-    }
-
     /**
      * 获取应用名称（从 AndroidManifest.xml 的 android:label 读取）
      * @param context 上下文（建议传入 Application 上下文，避免内存泄漏）
@@ -219,6 +170,7 @@ public class GlobalApplication extends Application {
         // 释放单例引用（可选，避免内存泄漏风险）
         sInstance = null;
         LogUtils.d(TAG, "GlobalApplication 终止，单例实例已释放");
+		
     }
 }
 

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

@@ -1,11 +1,8 @@
 package cc.winboll.studio.libappbase;
 
 import android.app.Activity;
-import android.app.ActivityOptions;
 import android.content.Context;
 import android.content.Intent;
-import android.graphics.Rect;
-import android.os.Build;
 import android.os.Bundle;
 import cc.winboll.studio.libappbase.LogView;
 import cc.winboll.studio.libappbase.R;
@@ -49,39 +46,20 @@ public class LogActivity extends Activity {
      * @param context 上下文（Activity/Fragment），用于启动 Activity
      */
     public static void startLogActivity(Context context) {
-        startLogActivity(context, true);
+        // 创建启动当前 Activity 的 Intent
-    }
-
-    /**
-     * 启动日志 Activity 的静态方法重载（外部调用入口）
-     * @param context 上下文（Activity/Fragment），用于启动 Activity
-     * @param newTask 是否在新窗口中启动
-     */
-    public static void startLogActivity(Context context, boolean newTask) {
         Intent intent = new Intent(context, LogActivity.class);
-        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
 
-        if (newTask) {
+        // 添加 Intent 标志：支持分屏/多窗口模式（API 24+）
-            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
-            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
-            context.startActivity(intent);
-        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
         intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
+        // 添加 Intent 标志：创建新任务栈（避免并入调用者任务栈）
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 添加 Intent 标志：标记为新文档（多任务窗口中独立显示）
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+        // 添加 Intent 标志：允许创建多个任务实例（支持多次启动独立窗口）
         intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
 
-            Rect bounds = new Rect();
+        // 启动 Activity
-            if (context instanceof Activity) {
-                Activity activity = (Activity) context;
-                activity.getWindow().getDecorView().getDisplay().getRectSize(bounds);
-                bounds.set(0, bounds.height() / 2, bounds.width(), bounds.height());
-            }
-            ActivityOptions options = ActivityOptions.makeBasic();
-            options.setLaunchBounds(bounds);
-            context.startActivity(intent, options.toBundle());
-        } else {
         context.startActivity(intent);
     }
 }
-}
 

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

@@ -100,52 +100,10 @@ public class LogUtils {
         // 加载当前应用下的所有类的 TAG
         addClassTAGList();
         loadTAGBeanSettings();
-        checkAndTrimLogFileSize();
         _IsInited = true;
         LogUtils.d(TAG, String.format("mapTAGList : %s", mapTAGList.toString()));
     }
 
-    private static void checkAndTrimLogFileSize() {
-        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
-            return;
-        }
-
-        final long MAX_FILE_SIZE = 6291456L;
-        final long KEEP_FILE_SIZE = 3145728L;
-
-        long fileSize = _mfLogCatchFile.length();
-        if (fileSize <= MAX_FILE_SIZE) {
-            return;
-        }
-
-        long needSkip = fileSize - KEEP_FILE_SIZE;
-
-        try (FileInputStream fis = new FileInputStream(_mfLogCatchFile);
-             BufferedReader reader = new BufferedReader(new InputStreamReader(fis));
-             FileOutputStream fos = new FileOutputStream(_mfLogCatchFile);
-             BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(fos))) {
-
-            StringBuilder sb = new StringBuilder();
-            String line;
-            long skippedTotal = 0;
-            final String lineBreak = System.lineSeparator();
-
-            while ((line = reader.readLine()) != null) {
-                byte[] lineBytes = line.getBytes();
-                skippedTotal += lineBytes.length + lineBreak.getBytes().length;
-
-                if (skippedTotal > needSkip) {
-                    sb.append(line).append(lineBreak);
-                }
-            }
-
-            writer.write(sb.toString());
-
-        } catch (IOException e) {
-            e.printStackTrace();
-        }
-    }
-
     public static Map<String, Boolean> getMapTAGList() {
         return mapTAGList;
     }

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

@@ -1,186 +0,0 @@
-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 appName;
-    private String versionName;
-    private String clientSign;
-    private String clientHash;
-
-    // ===================================== 构造方法 =====================================
-    public APPValidationDialog(Context context, String appName, String versionName) {
-        super(context, R.style.DialogStyle);
-        this.mContext = context;
-        this.appName = appName;
-        this.versionName = versionName;
-        LogUtils.d(TAG, "AppValidationDialog: 构造方法初始化，入参-> projectName=" + appName + ", 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,
-			appName,
-			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

@@ -1,99 +0,0 @@
-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/models/SFTPAuthModel.java

@@ -1,101 +0,0 @@
-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

@@ -1,39 +0,0 @@
-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

@@ -1,306 +0,0 @@
-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

@@ -1,199 +0,0 @@
-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 appName, String versionName,
-                                   String clientSign, String clientHash, final CheckResultCallback callback) {
-        // 方法调用+全量入参调试日志
-        LogUtils.d(TAG, "checkAPKValidation: 方法调用，入参-> appName=" + appName
-				   + ", versionName=" + versionName + ", clientSign=" + clientSign + ", clientHash=" + clientHash);
-
-        // 1. 核心入参空值校验（快速失败）
-        if (context == null) {
-            LogUtils.w(TAG, "checkAPKValidation: 入参context为空，直接返回校验失败");
-            callCallbackOnMainThread(callback, false, "上下文对象不能为空");
-            return;
-        }
-        if (isStringEmpty(appName)) {
-            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(appName);
-        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

@@ -1,272 +0,0 @@
-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

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

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

@@ -1,71 +0,0 @@
-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

@@ -8,7 +8,6 @@ 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;
@@ -17,204 +16,163 @@ 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;
 
 /**
+ * @Describe AboutView 原生实现关于页面，无第三方依赖，适配API30，抽象通用功能控件（邮件/网页跳转）
  * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
- * @CreateTime 2026-01-11 12:23:00
+ * @Date 2026/01/11 12:23:00
- * @LastEditTime 2026-01-24 20:50:00
+ * @LastEditTime 2026/01/12 01:05:30
- * @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）
+    // 布局尺寸常量（统一管理，适配多屏幕，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 LINE_HEIGHT = 1;
     private static final int ITEM_ICON_SIZE = 24;
 
-    // 服务器默认地址常量
+    // 成员属性区（按 核心依赖→业务配置→视图相关 归类排序，注释清晰）
-    private static final String SERVER_DEBUG_HOST = "https://yun-preivew.winboll.cc";
+    private Context mContext;                    // 上下文对象，全局复用
-    private static final String SERVER_RELEASE_HOST = "https://yun.winboll.cc";
+    private APPInfo mAPPInfo;                    // 应用核心信息实体
+    private OnRequestDevUserInfoAutofillListener mOnRequestDevUserInfoAutofillListener;  // 调试信息填充监听
 
-    // ===================================== 核心成员属性 =====================================
+    private String mszAppName = "";              // 应用名称
-    // 上下文与业务实体
+    private String mszAppVersionName = "";       // 应用版本号
-    private Context mContext;
+    private String mszAppDescription = "";       // 应用描述文案
-    private APPInfo mAPPInfo;
+    private String mszHomePage = "";             // 应用主页/APK下载地址
-    private OnRequestDevUserInfoAutofillListener mOnRequestDevUserInfoAutofillListener;
+    private String mszGitea = "";                // 应用Git源码地址
+    private String mszAppGitName = "";           // 应用Git仓库名称
+    private String mszAppAPKName = "";           // 应用APK基础名称
+    private String mszAppAPKFolderName = "";     // 应用APK存储文件夹
+    private String mszCurrentAppPackageName = "";// 当前APK完整文件名
+    private String mszReleaseAPKName = "";       // 正式版APK完整文件名
+    private volatile String mszNewestAppPackageName = "";  // 最新版APK文件名（支持异步更新）
+    private String mszWinBoLLServerHost = "";    // 服务器地址
+    private int mnAppIcon = 0;                   // 应用图标资源ID
+    private boolean mIsAddDebugTools = false;    // 是否启用调试工具标识
+    private EditText metDevUserName;             // 调试用户名输入框
+    private EditText metDevUserPassword;         // 调试密码输入框
 
-    // 应用基础信息
+    // 构造方法区（按 参数从少到多 排序，适配 代码创建+XML引用 场景）
-    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 DebugSwitchImageView ivAppIcon;
-    private TextView tvAppNameVersion;
-    private TextView tvAppDesc;
-    private LinearLayout llFunctionContainer;
-	private ImageButton ibSebugStepOver;
-    private ImageButton ibSigngetDialog;
-    private ImageButton ibWinBoLLHostDialog;
-
-    // ===================================== 构造方法（按参数从少到多排序） =====================================
     public AboutView(Context context) {
         super(context);
-        LogUtils.d(TAG, "AboutView(Context)：代码创建视图，执行默认初始化");
+        LogUtils.d(TAG, "AboutView(Context) 构造方法调用，代码创建视图场景");
         this.mContext = context;
         initDefaultParams();
-        initViewFromXml();
     }
 
-//    public AboutView(Context context, APPInfo appInfo) {
+    public AboutView(Context context, APPInfo appInfo) {
-//        super(context);
+        super(context);
-//        LogUtils.d(TAG, "AboutView(Context,APPInfo)：传入应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+        LogUtils.d(TAG, "AboutView(Context,APPInfo) 构造调用，入参APPInfo：" + (appInfo == null ? "null" : appInfo.getAppName()));
-//        this.mContext = context;
+        this.mContext = context;
-//        this.mAPPInfo = appInfo;
+        this.mAPPInfo = appInfo;
-//        initViewFromXml();
+        initAll();
-//        initAll();
+    }
-//    }
 
     public AboutView(Context context, AttributeSet attrs) {
         super(context, attrs);
-        LogUtils.d(TAG, "AboutView(Context,AttributeSet)：XML布局引用，执行默认初始化");
+        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);
+        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));
+        LogUtils.d(TAG, "initAll() 一站式初始化调用，APPInfo是否为空：" + (mAPPInfo == null));
         if (mAPPInfo == null) {
-            LogUtils.w(TAG, "initAll()：初始化终止，APPInfo为null");
+            LogUtils.w(TAG, "initAll() 初始化终止：APPInfo 为 null，无法获取应用核心信息");
             return;
         }
+        // 基础布局配置
+        setOrientation(VERTICAL);
+        setPadding(dp2px(PADDING_MID), dp2px(PADDING_LARGE), dp2px(PADDING_MID), dp2px(PADDING_LARGE));
+        setGravity(Gravity.CENTER_HORIZONTAL);
+
+        // 按初始化流程执行，有序无冗余
         initDefaultParams();
-        initAPPBaseInfo();
+        initAppBaseInfo();
-        initAPPVersionInfo();
+        initAppVersionInfo();
         initServerConfig();
-        initAPPLinkInfo();
+        initAppLinkInfo();
         initReleaseAPKInfo();
         initAboutPageView();
-        LogUtils.d(TAG, "initAll()：所有初始化流程执行完成");
+        LogUtils.d(TAG, "initAll() 所有初始化流程执行完成");
     }
 
     /**
-     * 重置应用信息并重新初始化页面，支持动态更新关于页内容
+     * 重置应用信息并重新初始化关于页，支持动态更新页面内容
      * @param appInfo 新的应用信息实体
      */
-//    public void setAPPInfoAndInit(APPInfo appInfo) {
+    public void setAPPInfoAndInit(APPInfo appInfo) {
-//        LogUtils.d(TAG, "setAPPInfoAndInit()：重置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+        LogUtils.d(TAG, "setAPPInfoAndInit() 调用，传入新APPInfo：" + (appInfo == null ? "null" : appInfo.getAppName()));
-//        this.mAPPInfo = appInfo;
+        this.mAPPInfo = appInfo;
-//        if (llFunctionContainer != null) llFunctionContainer.removeAllViews();
+        removeAllViews();
-//        initAll();
+        initAll();
-//        LogUtils.d(TAG, "setAPPInfoAndInit()：应用信息重置+页面重构完成");
+        LogUtils.d(TAG, "setAPPInfoAndInit() 应用信息重置+页面重构完成");
-//    }
+    }
 
     /**
-     * 设置应用信息，兼容旧调用逻辑，设置后自动重构页面
+     * 设置应用信息（兼容旧调用逻辑），设置后自动重构页面
      * @param appInfo 应用核心信息实体
      */
     public void setAPPInfo(APPInfo appInfo) {
-        LogUtils.d(TAG, "setAPPInfo()：设置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+        LogUtils.d(TAG, "setAPPInfo() 调用，传入APPInfo：" + (appInfo == null ? "null" : appInfo.getAppName()));
         this.mAPPInfo = appInfo;
-        if (llFunctionContainer != null) llFunctionContainer.removeAllViews();
+        removeAllViews();
         initAll();
     }
 
     /**
-     * 设置调试信息自动填充监听，供调试场景回调使用
+     * 设置调试信息自动填充监听，用于调试场景的信息回调
      * @param l 监听回调接口实现
      */
     public void setOnRequestDevUserInfoAutofillListener(OnRequestDevUserInfoAutofillListener l) {
-        LogUtils.d(TAG, "setOnRequestDevUserInfoAutofillListener()：设置调试信息填充监听完成");
+        LogUtils.d(TAG, "setOnRequestDevUserInfoAutofillListener() 调试监听设置完成");
         this.mOnRequestDevUserInfoAutofillListener = l;
     }
 
-    // ===================================== 内部初始化方法 =====================================
+    // 内部初始化方法区（按 基础→业务→视图 流程排序，单一职责）
     /**
      * 初始化默认兜底参数，防止空指针，为后续初始化做基础铺垫
      */
     private void initDefaultParams() {
-        LogUtils.d(TAG, "initDefaultParams()：开始初始化默认参数");
+        LogUtils.d(TAG, "initDefaultParams() 执行默认参数初始化");
-        mszWinBoLLServerHost = GlobalApplication.isDebugging() ? SERVER_DEBUG_HOST : SERVER_RELEASE_HOST;
+        mszWinBoLLServerHost = GlobalApplication.isDebugging() ? "https://yun-preivew.winboll.cc" : "https://yun.winboll.cc";
-        mnAppIcon = (mnAppIcon == 0) ? R.drawable.ic_winboll : mnAppIcon;
+        mnAppIcon = mnAppIcon == 0 ? R.drawable.ic_winboll : mnAppIcon;
         mIsAddDebugTools = false;
-        LogUtils.d(TAG, "initDefaultParams()：默认参数初始化完成，服务器地址=" + mszWinBoLLServerHost + "，应用图标ID=" + mnAppIcon);
+        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);
-		// 功能按钮绑定
-		ibSebugStepOver = findViewById(R.id.ib_debug_step_over);
-		ibSigngetDialog = findViewById(R.id.ib_signgetdialog);
-		ibWinBoLLHostDialog = findViewById(R.id.ib_winbollhostdialog);
-
-		// 调试按钮统一只在调试模式显示
-		ibWinBoLLHostDialog.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
-		//ibSigngetDialog.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
-		ibSebugStepOver.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
-
-		// 绑定按钮点击事件
-		setBtnClickListener();
-		LogUtils.d(TAG, "initViewFromXml()：布局加载+控件绑定+事件初始化完成");
     }
 
     /**
      * 从APPInfo实体读取应用基础核心配置，赋值到本地属性
      */
-    private void initAPPBaseInfo() {
+    private void initAppBaseInfo() {
-        LogUtils.d(TAG, "initAPPBaseInfo()：开始读取APPInfo基础配置");
+        LogUtils.d(TAG, "initAppBaseInfo() 读取APPInfo基础配置");
         if (mAPPInfo == null) {
-            LogUtils.w(TAG, "initAPPBaseInfo()：跳过执行，APPInfo为null");
+            LogUtils.w(TAG, "initAppBaseInfo() 跳过执行：APPInfo 为 null");
             return;
         }
         mszAppName = mAPPInfo.getAppName() == null ? "" : mAPPInfo.getAppName();
@@ -222,44 +180,44 @@ public class AboutView extends LinearLayout {
         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;
+        mnAppIcon = mAPPInfo.getAppIcon() != 0 ? mAPPInfo.getAppIcon() : mnAppIcon;
         mIsAddDebugTools = mAPPInfo.isAddDebugTools();
-        LogUtils.d(TAG, "initAPPBaseInfo()：基础配置读取完成，应用名=" + mszAppName + "，调试开关=" + mIsAddDebugTools);
+        LogUtils.d(TAG, "initAppBaseInfo() 读取完成，应用名：" + mszAppName + "，调试开关：" + mIsAddDebugTools);
     }
 
     /**
-     * 从包管理中获取当前应用版本号，初始化版本相关信息
+     * 初始化应用版本信息，从包管理中获取当前应用版本号
      */
-    private void initAPPVersionInfo() {
+    private void initAppVersionInfo() {
-        LogUtils.d(TAG, "initAPPVersionInfo()：开始初始化应用版本信息");
+        LogUtils.d(TAG, "initAppVersionInfo() 初始化应用版本信息");
         try {
             mszAppVersionName = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0).versionName;
         } catch (PackageManager.NameNotFoundException e) {
-            LogUtils.e(TAG, "initAPPVersionInfo()：获取版本号失败，默认赋值unknown", e);
+            LogUtils.d(TAG, "initAppVersionInfo() 获取版本号失败，默认赋值unknown", e);
             mszAppVersionName = "unknown";
         }
-        mszCurrentAppPackageName = String.format("%s_%s.apk", mszAppVersionName, mszAppVersionName);
+        mszCurrentAppPackageName = String.format("%s_%s.apk", mszAppAPKName, mszAppVersionName);
-        LogUtils.d(TAG, "initAPPVersionInfo()：版本信息初始化完成，版本号=" + mszAppVersionName + "，当前APK名=" + mszCurrentAppPackageName);
+        LogUtils.d(TAG, "initAppVersionInfo() 完成，版本号：" + mszAppVersionName + "，当前APK名：" + mszCurrentAppPackageName);
     }
 
     /**
      * 初始化服务器相关配置，预留扩展接口
      */
     private void initServerConfig() {
-        LogUtils.d(TAG, "initServerConfig()：服务器配置初始化，预留扩展接口");
+        LogUtils.d(TAG, "initServerConfig() 服务器配置初始化（预留扩展）");
     }
 
     /**
-     * 初始化应用相关链接（主页+Git源码地址），根据分支配置动态拼接Git地址
+     * 初始化应用相关链接（主页+Git源码地址），动态拼接Git地址
      */
-    private void initAPPLinkInfo() {
+    private void initAppLinkInfo() {
-        LogUtils.d(TAG, "initAPPLinkInfo()：开始初始化应用链接信息");
+        LogUtils.d(TAG, "initAppLinkInfo() 初始化应用链接信息");
         if (mAPPInfo == null) {
-            LogUtils.w(TAG, "initAPPLinkInfo()：跳过执行，APPInfo为null");
+            LogUtils.w(TAG, "initAppLinkInfo() 跳过执行：APPInfo 为 null");
             return;
         }
         mszHomePage = mAPPInfo.getAppHomePage() == null ? "" : mAPPInfo.getAppHomePage();
-        // 拼接Git地址，兼容无分支配置场景
+        // 分场景拼接Git地址，兼容无分支配置场景
         if (mAPPInfo.getAppGitAPPBranch() == null || mAPPInfo.getAppGitAPPBranch().trim().isEmpty()) {
             mszGitea = String.format("https://gitea.winboll.cc/%s/%s", mAPPInfo.getAppGitOwner(), mszAppGitName);
         } else {
@@ -267,96 +225,100 @@ public class AboutView extends LinearLayout {
 									 mAPPInfo.getAppGitOwner(), mszAppGitName,
 									 mAPPInfo.getAppGitAPPBranch(), mAPPInfo.getAppGitAPPSubProjectFolder());
         }
-        LogUtils.d(TAG, "initAPPLinkInfo()：链接信息初始化完成，应用主页=" + mszHomePage + "，Git地址=" + mszGitea);
+        LogUtils.d(TAG, "initAppLinkInfo() 完成，应用主页：" + mszHomePage + "，Git地址：" + mszGitea);
     }
 
     /**
      * 初始化正式版APK信息，去除beta后缀适配正式包命名规范
      */
     private void initReleaseAPKInfo() {
-        LogUtils.d(TAG, "initReleaseAPKInfo()：开始初始化正式版APK信息");
+        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);
+            LogUtils.d(TAG, "initReleaseAPKInfo() 获取正式版版本号失败", e);
         }
         mszReleaseAPKName = String.format("%s_%s.apk", mszAppAPKName, szReleaseAppVersionName);
-        LogUtils.d(TAG, "initReleaseAPKInfo()：正式版APK信息初始化完成，APK名=" + mszReleaseAPKName);
+        LogUtils.d(TAG, "initReleaseAPKInfo() 完成，正式版APK名：" + mszReleaseAPKName);
     }
 
     /**
-     * 核心视图组装：赋值基础信息到控件，添加通用功能项到容器
+     * 核心视图组装：按 图标→应用信息→分割线→通用功能控件 顺序构建页面
      */
     private void initAboutPageView() {
-        LogUtils.d(TAG, "initAboutPageView()：开始组装关于页视图");
+        LogUtils.d(TAG, "initAboutPageView() 开始组装关于页视图");
-        // 赋值基础信息
+        addAppIcon();
-        ivAppIcon.setImageResource(mnAppIcon);
+        addAppInfoDesc();
-        tvAppNameVersion.setText(String.format("%s %s", mszAppName, mszAppVersionName));
+        addLineSeparator();
-        if (mszAppDescription.isEmpty()) {
+
-            tvAppDesc.setVisibility(GONE);
+        // 通用功能控件：网页跳转类+邮件类，复用抽象控件
-        } else {
+        addView(new WebJumpFunctionItemView(mContext, "WinBoLL 主页", WINBOLL_OFFICIAL_HOME, R.drawable.ic_winboll));
-            tvAppDesc.setVisibility(VISIBLE);
+        addView(new EmailFunctionItemView(mContext, "联系邮箱", "WinBoLLStudio<studio@winboll.cc>", R.drawable.ic_winboll));
-            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));
+            addView(new WebJumpFunctionItemView(mContext, "应用APK下载地址", mszHomePage, R.drawable.ic_winboll));
         }
         if (!mszGitea.isEmpty()) {
-            addFunctionView(new WebJumpFunctionItemView(mContext, "应用Git源码地址", mszGitea, R.drawable.ic_winboll));
+            addView(new WebJumpFunctionItemView(mContext, "应用Git源码地址", mszGitea, R.drawable.ic_winboll));
         }
-        LogUtils.d(TAG, "initAboutPageView()：视图组装完成，功能项加载完毕");
+        LogUtils.d(TAG, "initAboutPageView() 视图组装完成，功能项加载完毕");
     }
 
-    // ===================================== 内部工具/事件方法 =====================================
+    // 视图构建辅助方法区（基础视图组件）
     /**
-     * 绑定功能按钮点击事件，处理正版校验、调试地址配置弹窗唤起
+     * 添加应用图标组件，居中展示
      */
-    private void setBtnClickListener() {
+    private void addAppIcon() {
-        LogUtils.d(TAG, "setBtnClickListener()：开始绑定功能按钮点击事件");
+        ImageView ivIcon = new ImageView(mContext);
-        // 取消调试状态按钮
+        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(dp2px(ICON_SIZE), dp2px(ICON_SIZE));
-        ibSebugStepOver.setOnClickListener(new OnClickListener() {
+        params.bottomMargin = dp2px(PADDING_MID);
-				@Override
+        ivIcon.setLayoutParams(params);
-				public void onClick(View v) {
+        ivIcon.setImageResource(mnAppIcon);
-					LogUtils.d(TAG, "ibSebugStepOver onClick：取消调试状态按钮已点击");
+        ivIcon.setScaleType(ImageView.ScaleType.CENTER_CROP);
-					GlobalApplication.setIsDebugging(false);
+        addView(ivIcon);
-					GlobalApplication.saveDebugStatus(GlobalApplication.getInstance());
-					ToastUtils.show("已取消调试状态，重启应用可生效。");
-				}
-			});
-		// 正版校验弹窗
-        ibSigngetDialog.setOnClickListener(new OnClickListener() {
-				@Override
-				public void onClick(View v) {
-					LogUtils.d(TAG, "ibSigngetDialog onClick：唤起应用正版校验弹窗");
-					new APPValidationDialog(mContext, mszAppName, 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) {
+    private void addAppInfoDesc() {
-        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
+        LinearLayout llDesc = new LinearLayout(mContext);
-        params.topMargin = 0;
+        llDesc.setOrientation(VERTICAL);
-        llFunctionContainer.addView(view, params);
+        llDesc.setGravity(Gravity.CENTER);
+        llDesc.setPadding(0, 0, 0, dp2px(PADDING_MID));
+
+        TextView tvAppName = new TextView(mContext);
+        tvAppName.setText(String.format("%s %s", mszAppName, mszAppVersionName));
+        tvAppName.setTextSize(18);
+        tvAppName.setTextColor(mContext.getResources().getColor(R.color.gray_900));
+        llDesc.addView(tvAppName);
+
+        if (!mszAppDescription.isEmpty()) {
+            TextView tvDesc = new TextView(mContext);
+            tvDesc.setText(mszAppDescription);
+            tvDesc.setTextSize(14);
+            tvDesc.setTextColor(mContext.getResources().getColor(R.color.gray_500));
+            tvDesc.setPadding(0, dp2px(PADDING_SMALL), 0, 0);
+            llDesc.addView(tvDesc);
+        }
+        addView(llDesc);
     }
 
+    /**
+     * 添加视图分割线，区分不同功能模块
+     */
+    private void addLineSeparator() {
+        View line = new View(mContext);
+        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, dp2px(LINE_HEIGHT));
+        params.topMargin = dp2px(PADDING_SMALL);
+        params.bottomMargin = dp2px(PADDING_MID);
+        line.setLayoutParams(params);
+        line.setBackgroundColor(mContext.getResources().getColor(R.color.gray_200));
+        addView(line);
+    }
+
+    // 工具方法区（通用工具+业务工具，静态优先，便于复用）
     /**
      * dp 转 px 工具方法，适配不同屏幕密度，保证布局一致性
      * @param dpValue dp单位尺寸
@@ -373,20 +335,17 @@ public class AboutView extends LinearLayout {
      * @return 去除beta后缀后的正式包名
      */
     public static String subBetaSuffix(String input) {
-        LogUtils.d(TAG, "subBetaSuffix()：执行包名beta后缀去除，原始包名=" + 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);
+            LogUtils.d(TAG, "subBetaSuffix() 处理成功，正式包名：" + result);
             return result;
         }
-        LogUtils.d(TAG, "subBetaSuffix()：无需处理，包名不含beta后缀");
+        LogUtils.d(TAG, "subBetaSuffix() 无需处理，包名不含beta后缀");
         return input == null ? "" : input;
     }
 
-    // ===================================== 内部抽象通用功能项基类 =====================================
+    // 内部抽象通用功能项基类 - 统一样式，减少冗余
-    /**
-     * 通用功能项基类，统一样式、布局、视图构建，减少冗余代码
-     */
     private abstract class BaseFunctionItemView extends LinearLayout implements OnClickListener {
         protected Context mItemContext;
         protected String mTitle;
@@ -404,32 +363,17 @@ public class AboutView extends LinearLayout {
             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);
-            setBackground(create_item_background());
+            setBackgroundResource(android.R.drawable.list_selector_background);
         }
 
-        /**
+        // 统一视图构建
-         * 创建带1像素边框的背景drawable
-         */
-        private android.graphics.drawable.Drawable create_item_background() {
-            android.graphics.drawable.GradientDrawable drawable = new android.graphics.drawable.GradientDrawable();
-            drawable.setStroke(1, mItemContext.getResources().getColor(R.color.gray_200));
-            drawable.setCornerRadius(4);
-            drawable.setColor(mItemContext.getResources().getColor(android.R.color.white));
-            return drawable;
-        }
-
-        /**
-         * 统一构建功能项视图（左侧图标+右侧标题/内容）
-         */
         private void initItemViews() {
             // 左侧图标
             if (mIconRes != 0) {
@@ -440,17 +384,20 @@ public class AboutView extends LinearLayout {
                 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);
@@ -460,17 +407,11 @@ public class AboutView extends LinearLayout {
             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);
@@ -483,37 +424,36 @@ public class AboutView extends LinearLayout {
 
         @Override
         public void onClick(View v) {
-            LogUtils.d(TAG, "EmailFunctionItemView onClick：触发邮件唤起逻辑");
+            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：纯邮件客户端唤起成功");
+                LogUtils.d(TAG, "邮件唤起成功：系统纯邮件客户端");
                 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：通用邮件应用唤起成功");
+                LogUtils.d(TAG, "邮件唤起成功：通用邮件应用");
             } else {
                 ToastUtils.show("未找到可发送邮件的应用");
-                LogUtils.w(TAG, "EmailFunctionItemView：邮件唤起失败，无可用邮件应用");
+                LogUtils.w(TAG, "邮件唤起失败：无可用邮件相关应用");
             }
         }
     }
 
-    // ===================================== 内部网页跳转功能项子类 =====================================
+    // 网页跳转类功能控件 - 专属网页跳转逻辑
-    /**
-     * 网页跳转类功能控件，实现专属网页唤起逻辑，包含空地址校验、异常捕获
-     */
     private class WebJumpFunctionItemView extends BaseFunctionItemView {
         public WebJumpFunctionItemView(Context context, String title, String content, int iconRes) {
             super(context, title, content, iconRes);
@@ -526,28 +466,25 @@ public class AboutView extends LinearLayout {
 
         @Override
         public void onClick(View v) {
-            LogUtils.d(TAG, "WebJumpFunctionItemView onClick：触发网页跳转，地址=" + mContent);
+            LogUtils.d(TAG, "WebJumpFunctionItemView onClick 触发网页跳转，地址：" + mContent);
             if (mContent.isEmpty()) {
                 ToastUtils.show("跳转地址为空");
-                LogUtils.w(TAG, "WebJumpFunctionItemView：网页跳转失败，地址为空");
+                LogUtils.w(TAG, "网页跳转失败：地址为空");
                 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：网页跳转成功");
+                LogUtils.d(TAG, "网页跳转成功");
             } catch (Exception e) {
-                LogUtils.e(TAG, "WebJumpFunctionItemView：网页跳转失败", e);
+                LogUtils.d(TAG, "网页跳转失败，异常捕获", e);
                 ToastUtils.show("链接无法打开");
             }
         }
     }
 
-    // ===================================== 内部回调接口 =====================================
+    // 内部接口区（置于类末尾，逻辑闭环）
-    /**
-     * 调试信息自动填充回调接口
-     */
     public interface OnRequestDevUserInfoAutofillListener {
         void requestAutofill(EditText etDevUserName, EditText etDevUserPassword);
     }

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

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

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

@@ -1,11 +0,0 @@
-<?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_debug_step_over.xml

@@ -1,11 +0,0 @@
-<?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,7H16.19C15.74,6.2 15.12,5.5 14.37,5L16,3.41L14.59,2L12.42,4.17C11.96,4.06 11.5,4 11,4S10.05,4.06 9.59,4.17L7.41,2L6,3.41L7.62,5C6.87,5.5 6.26,6.21 5.81,7H3V9H5.09C5.03,9.33 5,9.66 5,10V11H3V13H5V14C5,14.34 5.03,14.67 5.09,15H3V17H5.81C7.26,19.5 10.28,20.61 13,19.65V19C13,18.43 13.09,17.86 13.25,17.31C12.59,17.76 11.8,18 11,18C8.79,18 7,16.21 7,14V10C7,7.79 8.79,6 11,6S15,7.79 15,10V14C15,14.19 15,14.39 14.95,14.58C15.54,14.04 16.24,13.62 17,13.35V13H19V11H17V10C17,9.66 16.97,9.33 16.91,9H19V7M13,9V11H9V9H13M13,13V15H9V13H13M16,16H22V22H16V16Z"/>
-
-</vector>

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

@@ -1,18 +0,0 @@
-<?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/dialog_sign_get.xml

@@ -1,52 +0,0 @@
-<?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

@@ -1,60 +0,0 @@
-<?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/layout_about_view.xml

@@ -1,92 +0,0 @@
-<?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="16dp"
-		android:paddingRight="16dp"
-		android:paddingBottom="16dp">
-
-		<cc.winboll.studio.libappbase.views.DebugSwitchImageView
-			android:id="@+id/iv_app_icon"
-			android:layout_width="48dp"
-			android:layout_height="48dp"
-			android:layout_marginBottom="8dp"
-			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="4dp"
-			android:layout_marginBottom="8dp"
-			android:textSize="14sp"
-			android:textColor="@color/gray_500"/>
-
-		<View
-			android:layout_width="match_parent"
-			android:layout_height="1px"
-			android:layout_marginTop="4dp"
-			android:layout_marginBottom="8dp"
-			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="8dp"
-			android:spacing="20dp">
-
-			<ImageButton
-				android:layout_width="48dp"
-				android:layout_height="48dp"
-				android:src="@drawable/ic_debug_step_over"
-				android:id="@+id/ib_debug_step_over"
-				android:scaleType="fitCenter"
-				android:adjustViewBounds="true"
-				android:background="@null"/>
-
-			<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/values/styles.xml

@@ -12,9 +12,4 @@
         <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

@@ -1,35 +0,0 @@
-<?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>
-
-
-
-

libwinboll/build.gradle

@@ -1,38 +0,0 @@
-apply plugin: 'com.android.library'
-apply plugin: 'maven-publish'
-apply from: '../.winboll/winboll_lib_build.gradle'
-apply from: '../.winboll/winboll_lint_build.gradle'
-
-android {
-	// 适配MIUI12
-	compileSdkVersion 30
-    buildToolsVersion "30.0.3"
-
-    defaultConfig {
-        minSdkVersion 26
-        targetSdkVersion 30
-    }
-    buildTypes {
-        release {
-            minifyEnabled false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
-        }
-    }
-}
-
-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'
-	
-	// WinBoLL库 nexus.winboll.cc 地址
-	api 'cc.winboll.studio:libaes:15.15.2'
-    api 'cc.winboll.studio:libappbase:15.15.11'
-
-    api fileTree(dir: 'libs', include: ['*.jar'])
-}

libwinboll/build.properties

@@ -1,8 +0,0 @@
-#Created by .winboll/winboll_app_build.gradle
-#Sat May 09 19:01:46 GMT 2026
-stageCount=27
-libraryProject=libwinboll
-baseVersion=15.11
-publishVersion=15.11.26
-buildCount=29
-baseBetaVersion=15.11.27

libwinboll/proguard-rules.pro

@@ -1,17 +0,0 @@
-# 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 *;
-#}

libwinboll/src/main/java/cc/winboll/studio/libwinboll/WinBoLLLibraryActivity.java

@@ -1,17 +0,0 @@
-package cc.winboll.studio.libwinboll;
-
-import android.app.Activity;
-import android.os.Bundle;
-import cc.winboll.studio.libappbase.ToastUtils;
-
-public class WinBoLLLibraryActivity extends Activity 
-{
-    @Override
-    protected void onCreate(Bundle savedInstanceState)
-    {
-        super.onCreate(savedInstanceState);
-        setContentView(R.layout.activity_winbolllibrary);
-		
-		ToastUtils.show("WinBoLLLibraryActivity onCreate");
-    }
-}

libwinboll/src/main/res/layout/activity_winbolllibrary.xml

@@ -1,11 +0,0 @@
-<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    android:gravity="center">
-
-    <TextView
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="cc.winboll.studio.libwinboll.WinBoLLLibraryActivity"/>
-
-</LinearLayout>

libwinboll/src/main/res/values-v21/styles.xml

@@ -1,5 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<resources>
-    <style name="AppTheme" parent="@android:style/Theme.Material.Light">
-	</style>
-</resources>

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

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

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

@@ -1,5 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<resources>
-    <style name="AppTheme" parent="@android:style/Theme.Holo.Light">
-	</style>
-</resources>

powerbell/README.md

@@ -0,0 +1,112 @@
+# PowerBell
+
+#### 介绍
+一个接收手机电量信息的应用，当电量值达到设定范围时会提醒用户。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：gradle assembleStageRelease
+
+#### 使用说明
+
+在安卓系统中需要设置两个权限允许。
+1.自启动权限允许。
+2.省电策略-无限制权限允许。
+3.设置背景图片需要读写手机存储权限。
+4.要在锁屏充电的时候提醒，还需要设置允许锁屏通知权限。
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@qq.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/)
+
+#### 参考文档
+
+AndroidManifest.xml详解
+https://www.jianshu.com/p/3b5b89d4e154
+
+CrashHandler自定义异常处理
+https://www.jianshu.com/p/9a3d800a429a
+
+Android用Intent启动Activity的方法
+https://blog.csdn.net/huangxiaohu_coder/article/details/7105457
+
+Android开发：最详细的 Toolbar 开发实践总结
+https://www.jianshu.com/p/79604c3ddcae
+
+Using the App Toolbar
+https://guides.codepath.com/android/using-the-app-toolbar
+
+Android的onCreateOptionsMenu()创建菜单Menu详解
+https://www.cnblogs.com/spring87/p/4312538.html
+
+Android通知栏-Notification（通知消息）
+https://blog.csdn.net/qq_35507234/article/details/90676587
+
+android之PendingIntent的使用
+https://blog.csdn.net/qq_16628781/article/details/51548324
+
+change seekbar color android” Code Answer
+https://www.codegrepper.com/code-examples/whatever/change+seekbar+color+android
+
+如何选择开源项目许可证
+https://www.zhihu.com/question/28292322
+
+Android最简单的自定义布局Notification
+https://blog.csdn.net/acesheep_911/article/details/81458784?utm_medium=distribute.wap_relevant.none-task-blog-2~default~baidujs_title~default-0.wap_blog_relevant_default&spm=1001.2101.3001.4242.1&utm_relevant_index=3
+
+Android中通知栏Notification详解以及自定义Notification
+https://blog.csdn.net/daitu_liang/article/details/50246803
+
+Android 图像系列: 将本地图片加载到Drawable
+https://blog.csdn.net/qzone123222/article/details/7930035
+
+android 从相册选择,Android开发从相册中选取照片
+https://blog.csdn.net/weixin_42146086/article/details/117570917
+
+Android 任务栈简介
+https://blog.csdn.net/qq_34368586/article/details/107653912
+
+Android用Intent启动Activity的方法
+https://blog.csdn.net/huangxiaohu_coder/article/details/7105457
+
+Android中使用dimen定义尺寸
+https://blog.csdn.net/yuzhiboyi/article/details/7696174
+
+declare-styleable：自定义控件的属性
+https://blog.csdn.net/congqingbin/article/details/7869730
+
+安卓自定义滑动解锁控件
+https://blog.csdn.net/lp506954774/article/details/72677018
+
+Android 添加菜单和返回按钮
+https://blog.csdn.net/my_tiantian/article/details/77822173
+
+Android Button的基本使用
+https://www.cnblogs.com/yishaochu/p/5783605.html
+
+Android应用中实现系统“分享”接口
+https://blog.csdn.net/lowprofile_coding/article/details/37656255
+
+Android 关于mimeType的使用
+https://blog.csdn.net/dorytmx/article/details/80972248
+
+使用GitHub Actions实现Android自动打包apk
+https://blog.csdn.net/ZZL23333/article/details/115798615?app_version=6.0.0&code=app_1562916241&csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22115798615%22%2C%22source%22%3A%22weixin_38986226%22%7D&uLinkId=usr1mkqgl919blen&utm_source=app

powerbell/app_update_description.txt

@@ -0,0 +1 @@
+

powerbell/build.gradle

@@ -0,0 +1,95 @@
+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 {
+    
+	// 关键：改为你已安装的 SDK 32（≥ targetSdkVersion 30，兼容已安装环境）
+    compileSdkVersion 32
+
+    // 直接使用已安装的构建工具 33.0.3（无需修改）
+    buildToolsVersion "33.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.powerbell"
+        minSdkVersion 23
+        targetSdkVersion 30
+        versionCode 7
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.14" 
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+}
+
+dependencies {
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //api 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    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'
+	
+	// uCrop 核心依赖（最新稳定版）
+    implementation 'com.github.yalantis:ucrop:2.2.8'
+    // 兼容AndroidX（若项目用AndroidX，必须添加）
+    //implementation 'androidx.appcompat:appcompat:1.6.1'
+    implementation 'androidx.exifinterface:exifinterface:1.3.6'
+
+	 // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+    
+    // AndroidX 类库
+    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'
+    
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.12.13'
+    api 'cc.winboll.studio:libappbase:15.14.2'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.12.9'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.14.1'
+	
+    //api fileTree(dir: 'libs', include: ['*.aar'])
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}

powerbell/build.properties

@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Wed Jan 07 18:09:34 HKT 2026
+stageCount=50
+libraryProject=
+baseVersion=15.14
+publishVersion=15.14.49
+buildCount=0
+baseBetaVersion=15.14.50

powerbell/build_copyright_pdf.sh

@@ -0,0 +1,279 @@
+#!/bin/bash
+# PowerBell软著版本号快速修改+生成脚本
+# 无需手动改主脚本，输入版本号直接运行
+
+# 颜色输出函数
+red_echo() { echo -e "\033[31m$1\033[0m"; }
+green_echo() { echo -e "\033[32m$1\033[0m"; }
+blue_echo() { echo -e "\033[34m$1\033[0m"; }
+
+# 1. 提示用户输入新版本号
+blue_echo "==== 请输入软著版本号（格式示例：V15、V15.0.1） ===="
+read -p "输入版本号：" NEW_VERSION
+
+# 校验版本号格式（避免特殊符号）
+if [[ ! $NEW_VERSION =~ ^V[0-9]+(\.[0-9]+)*$ ]]; then
+    red_echo "错误：版本号格式无效！请遵循「V+数字」格式（如V15、V15.0.1），不含特殊符号"
+    exit 1
+fi
+
+# 2. 定义固定配置（仅需修改这里的著作权人，其他无需动）
+SOFTWARE_NAME="PowerBell"
+COPYRIGHT_OWNER="张绍建陆丰东海镇云宝软件开发工作室"
+LINES_PER_PAGE=55
+
+# 3. 生成主脚本（自动替换新版本号）
+blue_echo -e "\n==== 生成${NEW_VERSION}版本主脚本 ===="
+cat > build_copyright_pdf_temp.sh << EOF
+#!/bin/bash
+# PowerBell软著PDF生成脚本（版本：$NEW_VERSION）
+red_echo() { echo -e "\033[31m\$1\033[0m"; }
+green_echo() { echo -e "\033[32m\$1\033[0m"; }
+blue_echo() { echo -e "\033[34m\$1\033[0m"; }
+
+# 配置项（已自动替换为${NEW_VERSION}）
+SOFTWARE_NAME="$SOFTWARE_NAME"
+SOFTWARE_VERSION="$NEW_VERSION"
+COPYRIGHT_OWNER="$COPYRIGHT_OWNER"
+LINES_PER_PAGE=$LINES_PER_PAGE
+
+# 步骤1：检查依赖
+blue_echo "==== 1/7 检查并安装依赖 ===="
+sudo apt update > /dev/null 2>&1
+REQUIRED_PKGS=("python3" "wkhtmltopdf" "fonts-wqy-microhei" "pdftk" "poppler-utils")
+for pkg in "\${REQUIRED_PKGS[@]}"; do
+    if ! dpkg -s "\$pkg" > /dev/null 2>&1; then
+        green_echo "安装依赖：\$pkg"
+        sudo apt install -y "\$pkg" > /dev/null 2>&1
+    fi
+done
+
+# 步骤2：生成纯文本源码
+blue_echo -e "\n==== 2/7 生成纯文本核心源码 ===="
+cat > generate_source.py << GEN_EOF
+import os
+PROJECT_PATH = "./"
+OUTPUT_TXT = "PowerBell_Core_Source.txt"
+INCLUDE_EXT = [".java", ".kt"]
+EXCLUDE_DIRS = ["build", "libs", "test", "androidTest", ".git", ".idea", "gradle", "unittest"]
+MIN_LINE_COUNT = 3
+SOFTWARE_NAME = "$SOFTWARE_NAME"
+SOFTWARE_VERSION = "$NEW_VERSION"
+COPYRIGHT_OWNER = "$COPYRIGHT_OWNER"
+
+def clean_text(text):
+    return ''.join(c for c in text if c.isprintable() or c in "\\n\\r\\t")
+
+def generate_source_txt():
+    valid_files = []
+    main_dir = os.path.join(PROJECT_PATH, "src", "main")
+    if not os.path.exists(main_dir):
+        print("Error: src/main directory not found!")
+        return
+    for root, dirs, files in os.walk(main_dir):
+        dirs[:] = [d for d in dirs if d not in EXCLUDE_DIRS]
+        for file in files:
+            if os.path.splitext(file)[1] in INCLUDE_EXT:
+                file_path = os.path.join(root, file)
+                try:
+                    with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
+                        lines = f.readlines()
+                        code_lines = [l for l in lines if l.strip() and not l.strip().startswith("//")]
+                        if len(code_lines) >= MIN_LINE_COUNT:
+                            valid_files.append(file_path)
+                except:
+                    continue
+    valid_files.sort(key=lambda x: os.path.getsize(x), reverse=True)
+    with open(OUTPUT_TXT, "w", encoding="utf-8-sig") as f:
+        f.write(f"\{SOFTWARE_NAME} \{SOFTWARE_VERSION} 核心源码 - 著作权人：\{COPYRIGHT_OWNER}\\n\\n")
+        for idx, file_path in enumerate(valid_files, 1):
+            f.write(f"\\n{'='*60}\\n")
+            f.write(f"文件 \{idx}：\{file_path.replace(PROJECT_PATH, '')}\\n")
+            f.write(f"{'='*60}\\n\\n")
+            try:
+                try:
+                    with open(file_path, "r", encoding="utf-8") as src_f:
+                        content = clean_text(src_f.read())
+                except UnicodeDecodeError:
+                    with open(file_path, "r", encoding="gbk") as src_f:
+                        content = clean_text(src_f.read())
+                f.write(content)
+                f.write("\\n\\n")
+            except Exception as e:
+                f.write(f"文件读取失败：\{str(e)}\\n\\n")
+                continue
+    print(f"有效源码文件数：\{len(valid_files)}")
+    print(f"纯文本文件路径：\{os.path.abspath(OUTPUT_TXT)}")
+
+if __name__ == "__main__":
+    generate_source_txt()
+GEN_EOF
+
+python3 generate_source.py
+if [ ! -f "PowerBell_Core_Source.txt" ]; then
+    red_echo "纯文本源码生成失败！"
+    exit 1
+fi
+
+# 步骤3：生成带版本号页眉的HTML
+blue_echo -e "\n==== 3/7 生成带${NEW_VERSION}页眉的HTML ===="
+cat > txt2html.py << TXT_EOF
+import os
+TXT_FILE = "PowerBell_Core_Source.txt"
+HTML_FILE = "PowerBell_Source.html"
+SOFTWARE_NAME = "$SOFTWARE_NAME"
+SOFTWARE_VERSION = "$NEW_VERSION"
+COPYRIGHT_OWNER = "$COPYRIGHT_OWNER"
+LINES_PER_PAGE = $LINES_PER_PAGE
+
+CSS_STYLE = """
+<style>
+@page {{
+    size: A4;
+    margin: 10mm 5mm;
+    @top-center {{
+        content: "{} {} - 源代码（著作权人：{}）";
+        font-family: 'WenQuanYi Micro Hei', monospace;
+        font-size: 9pt;
+        font-weight: bold;
+    }}
+    @bottom-center {{
+        content: "页码 " counter(page) " / " counter(pages);
+        font-family: 'WenQuanYi Micro Hei', monospace;
+        font-size: 9pt;
+    }}
+}}
+body {{ 
+    font-family: 'WenQuanYi Micro Hei', monospace; 
+    font-size: 9pt;
+    line-height: 1.1;
+    margin: 0;
+    padding: 5mm 0 0 0;
+    counter-reset: code-line;
+}}
+.file-header {{ 
+    background: #f0f0f0; 
+    padding: 3px; 
+    margin: 6px 0; 
+    font-weight: bold; 
+    font-size: 10pt;
+}}
+.code-block {{ 
+    white-space: pre; 
+    margin-left: 8px; 
+    line-height: 1.1;
+    counter-increment: code-line;
+}}
+.code-block:before {{
+    content: counter(code-line) " ";
+    color: #888;
+    display: inline-block;
+    width: 30px;
+    text-align: right;
+    margin-right: 5px;
+}}
+.page-break {{ page-break-after: always; counter-reset: code-line; }}
+</style>
+""".format(SOFTWARE_NAME, SOFTWARE_VERSION, COPYRIGHT_OWNER)
+
+def txt_to_html():
+    with open(TXT_FILE, "r", encoding="utf-8") as f:
+        content = f.read()
+    html_content = "<!DOCTYPE html><html><head><meta charset='utf-8'>" + CSS_STYLE + "</head><body>"
+    content_lines = content.split("\\n")[2:]
+    content_clean = "\\n".join(content_lines)
+    blocks = content_clean.split("====")
+    
+    line_count = 0
+    for block in blocks:
+        if not block.strip():
+            continue
+        if "文件 " in block and ":" in block:
+            file_header = block.split("\\n")[0].strip() if "\\n" in block else block.strip()
+            html_content += f"<div class='file-header'>\{file_header}</div>"
+            code_part = block.split("\\n")[1:] if "\\n" in block else []
+            block = "\\n".join(code_part)
+        code_lines = block.split("\\n")
+        for line in code_lines:
+            if line.strip() or line_count > 0:
+                line_count += 1
+                html_content += f"<div class='code-block'>\{line}</div>"
+                if line_count >= LINES_PER_PAGE:
+                    html_content += "<div class='page-break'></div>"
+                    line_count = 0
+    html_content += "</body></html>"
+    with open(HTML_FILE, "w", encoding="utf-8") as f:
+        f.write(html_content)
+    print(f"HTML文件路径：\{os.path.abspath(HTML_FILE)}")
+
+if __name__ == "__main__":
+    txt_to_html()
+TXT_EOF
+
+python3 txt2html.py
+if [ ! -f "PowerBell_Source.html" ]; then
+    red_echo "HTML文件生成失败！"
+    exit 1
+fi
+
+# 步骤4：生成完整PDF
+blue_echo -e "\n==== 4/7 生成完整PDF（版本：${NEW_VERSION}） ===="
+wkhtmltopdf --page-size A4 \
+            --margin-top 15mm --margin-bottom 15mm --margin-left 5mm --margin-right 5mm \
+            --encoding utf-8 \
+            --no-images --disable-javascript \
+            --enable-local-file-access \
+            --no-stop-slow-scripts \
+            PowerBell_Source.html PowerBell_soft_full.pdf
+
+if [ ! -f "PowerBell_soft_full.pdf" ]; then
+    red_echo "完整PDF生成失败！"
+    exit 1
+fi
+
+# 步骤5：截取60页
+blue_echo -e "\n==== 5/7 截取前30+后30页 ===="
+TOTAL_PAGES=\$(pdfinfo PowerBell_soft_full.pdf | grep "Pages" | awk '{print \$2}')
+green_echo "源码完整PDF总页数：\$TOTAL_PAGES 页"
+
+if [ "\$TOTAL_PAGES" -le 60 ]; then
+    cp PowerBell_soft_full.pdf PowerBell_软著源码_${NEW_VERSION}_60页.pdf
+    green_echo "源码不足60页，直接使用完整PDF"
+else
+    pdftk PowerBell_soft_full.pdf cat 1-30 output PowerBell_前30页.pdf
+    START_PAGE=\$((TOTAL_PAGES - 29))
+    pdftk PowerBell_soft_full.pdf cat \$START_PAGE-\$TOTAL_PAGES output PowerBell_后30页.pdf
+    pdftk PowerBell_前30页.pdf PowerBell_后30页.pdf cat output PowerBell_软著源码_${NEW_VERSION}_60页.pdf
+    rm -f PowerBell_前30页.pdf PowerBell_后30页.pdf
+    green_echo "源码超过60页，已截取前30页+后30页合并为60页"
+fi
+
+# 步骤6：验证规范
+blue_echo -e "\n==== 6/7 验证${NEW_VERSION}版本PDF规范 ===="
+FINAL_PAGES=\$(pdfinfo PowerBell_软著源码_${NEW_VERSION}_60页.pdf | grep "Pages" | awk '{print \$2}')
+green_echo "最终PDF页数：\$FINAL_PAGES 页"
+green_echo "每页代码行数：\$LINES_PER_PAGE 行（≥50行）"
+green_echo "页眉信息：$SOFTWARE_NAME $NEW_VERSION - 源代码（著作权人：$COPYRIGHT_OWNER）"
+
+# 步骤7：清理临时文件
+blue_echo -e "\n==== 7/7 清理临时文件 ===="
+rm -f generate_source.py txt2html.py PowerBell_Core_Source.txt PowerBell_Source.html PowerBell_soft_full.pdf
+green_echo "临时文件清理完成！"
+
+# 输出结果
+green_echo -e "\n====================================="
+green_echo "✅ $SOFTWARE_NAME $NEW_VERSION 软著PDF生成成功！🎉"
+green_echo "📄 最终文件：\$(pwd)/PowerBell_软著源码_${NEW_VERSION}_60页.pdf"
+green_echo "💡 可直接提交软著登记，无需手动修改！"
+green_echo "====================================="
+EOF
+
+# 4. 赋予执行权限并运行
+chmod +x build_copyright_pdf_temp.sh
+blue_echo -e "\n==== 开始生成${NEW_VERSION}版本PDF ===="
+./build_copyright_pdf_temp.sh
+
+# 5. 删除临时主脚本（可选，保留则注释此行）
+rm -f build_copyright_pdf_temp.sh
+
+green_echo -e "\n==== 操作完成！${NEW_VERSION}版本PDF已生成 ===="

powerbell/proguard-rules.pro

@@ -0,0 +1,143 @@
+# 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:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-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 class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-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 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-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.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+# ============================== 必要补充规则 ==============================
+# OkHttp 4.4.1 补充规则（Java 7 兼容）
+-keep class okhttp3.internal.concurrent.** { *; }
+-keep class okhttp3.internal.connection.** { *; }
+-dontwarn okhttp3.internal.concurrent.TaskRunner
+-dontwarn okhttp3.internal.connection.RealCall
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-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 *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+

powerbell/src/beta/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
+        tools:replace="android:icon"
+        android:icon="@drawable/ic_launcher_beta">
+
+    </application>
+
+</manifest>
+

powerbell/src/beta/res/values-zh/string.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name_cn1">能源钟★</string>
+    <string name="app_name_cn2">泡额呗额☆</string>
+
+</resources>

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

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

powerbell/src/beta/res/xml/shortcutsmaincn1.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+	        android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>

powerbell/src/beta/res/xml/shortcutsmaincn2.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+	        android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+</shortcuts>

powerbell/src/beta/res/xml/shortcutsmainen1.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<!--<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+	        android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>

powerbell/src/main/AndroidManifest.xml

@@ -0,0 +1,329 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    package="cc.winboll.studio.powerbell">
+
+    <!-- 此应用可显示在其他应用上方 -->
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
+
+    <!-- 运行前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <!-- 运行“specialUse”类型的前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE"/>
+
+    <!-- 开机启动 -->
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+
+    <!-- 显示通知 -->
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+
+    <!-- PACKAGE_USAGE_STATS -->
+    <uses-permission android:name="android.permission.PACKAGE_USAGE_STATS"/>
+
+    <!-- BATTERY_STATS -->
+    <uses-permission android:name="android.permission.BATTERY_STATS"/>
+
+    <!-- 计算应用存储空间 -->
+    <uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
+
+    <!-- 请求忽略电池优化 -->
+    <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
+
+    <!-- 读取您共享存储空间中的内容 -->
+    <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"/>
+
+    <!-- 拍摄照片和视频 -->
+    <uses-permission android:name="android.permission.CAMERA"/>
+
+    <uses-permission
+        android:name="android.permission.ACCESS_PACKAGE_USAGE_STATS"
+        tools:ignore="ProtectedPermissions"/>
+
+    <uses-permission
+        android:name="android.permission.QUERY_ALL_PACKAGES"
+        tools:ignore="QueryAllPackagesPermission"/>
+
+    <uses-permission android:name="android.permission.BATTERY_STATS"/>
+
+    <uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
+
+    <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
+
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <uses-permission android:name="android.permission.CAMERA"/>
+
+    <uses-feature
+        android:name="android.hardware.camera"
+        android:required="false"/>
+
+    <uses-feature
+        android:name="android.hardware.camera.autofocus"
+        android:required="false"/>
+
+    <queries>
+
+        <package android:name="com.miui.securitycenter"/>
+
+    </queries>
+
+    <application
+        android:name=".App"
+        android:process=":main"
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/AppTheme_Default"
+        android:persistent="true"
+        android:resizeableActivity="true"
+        android:requestLegacyExternalStorage="true"
+        android:usesCleartextTraffic="true"
+        android:supportsRtl="true"
+        tools:ignore="GoogleAppIndexingWarning,UnusedAttribute">
+
+        <activity
+            android:process=":main"
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:launchMode="singleTask"/>
+
+        <activity-alias
+            android:name=".MainActivityEN1"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmainen1"/>
+
+        </activity-alias>
+
+        <activity-alias
+            android:name=".MainActivityCN1"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name_cn1"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="false">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmaincn1"/>
+
+        </activity-alias>
+
+        <activity-alias
+            android:name=".MainActivityCN2"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name_cn2"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="false">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmaincn2"/>
+
+        </activity-alias>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.CrashActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.ClearRecordActivity"
+            android:parentActivityName="cc.winboll.studio.powerbell.MainActivity"
+            android:launchMode="singleTask"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.BackgroundSettingsActivity"
+            android:parentActivityName="cc.winboll.studio.powerbell.MainActivity"
+            android:exported="true"
+            android:launchMode="singleTask">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.SEND"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+                <data android:mimeType="image/jpeg"/>
+
+                <data android:mimeType="image/jpg"/>
+
+                <data android:mimeType="image/png"/>
+
+                <data android:mimeType="image/webp"/>
+
+                <data android:mimeType="image/*"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.BatteryReporterActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.PixelPickerActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.BatteryReportActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".unittest.MainUnitTestActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.ShortcutActionActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.SettingsActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name="cc.winboll.studio.powerbell.unittest.MainUnitTest2Activity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name="com.yalantis.ucrop.UCropActivity"
+            android:theme="@style/Theme.AppCompat.Light.NoActionBar"
+            android:exported="true"/>
+
+        <receiver
+            android:process=":main"
+            android:name=".receivers.MainReceiver"
+            android:enabled="true"
+            android:exported="true"
+            android:directBootAware="true">
+
+            <intent-filter android:priority="1000">
+
+                <action android:name="android.intent.action.BOOT_COMPLETED"/>
+
+                <action android:name="android.intent.action.POWER_CONNECTED"/>
+
+                <action android:name="android.intent.action.USER_PRESENT"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <service
+            android:name=".services.ControlCenterService"
+            android:priority="1000"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":main"
+            android:stopWithTask="false"
+            android:foregroundServiceType="dataSync">
+
+            <property
+                android:name="android.app.PROPERTY_SPECIAL_USE_FOREGROUND_SERVICE"
+                android:value="后台核心功能运行、持续保活"/>
+
+        </service>
+
+        <service
+            android:name=".services.AssistantService"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":assistant"
+            android:stopWithTask="false"
+            android:foregroundServiceType="dataSync">
+
+            <property
+                android:name="android.app.PROPERTY_SPECIAL_USE_FOREGROUND_SERVICE"
+                android:value="辅助核心功能运行"/>
+
+        </service>
+
+        <service
+            android:name=".services.TTSPlayService"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":main"
+            android:stopWithTask="false"/>
+
+        <service android:name=".services.ThoughtfulService"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":main"
+            android:stopWithTask="false"/>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true"
+            android:process=":main">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+    </application>
+
+</manifest>

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

@@ -0,0 +1,320 @@
+package cc.winboll.studio.powerbell;
+
+import android.content.Context;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.models.NotificationMessage;
+import cc.winboll.studio.powerbell.receivers.GlobalApplicationReceiver;
+import cc.winboll.studio.powerbell.utils.AppCacheUtils;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.BitmapCacheUtils;
+import cc.winboll.studio.powerbell.utils.NotificationManagerUtils;
+import cc.winboll.studio.powerbell.views.MemoryCachedBackgroundView;
+
+/**
+ * 应用全局入口类
+ * 适配：Java7 语法规范 | Android API30 系统版本
+ * 核心策略：极致强制缓存 - 无论内存紧张程度，永不自动清理任何缓存（Bitmap/视图控件/路径记录）
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025-12-29 15:30:00
+ * @LastModified 2026-01-02 19:01:00
+ */
+public class App extends GlobalApplication {
+
+    // ====================================== 常量区 - 置顶排序 (按功能归类) ======================================
+    // 基础日志TAG
+    private static final String TAG = "App";
+    // 缓存保护专用TAG
+    private static final String CACHE_PROTECT_TAG = "FORCE_CACHE_PROTECT";
+    // 电池无效值常量（修复拼写错误：INVALID_BATTERY_VALUE）
+    private static final int INVALID_BATTERY_VALUE = -1;
+
+    // 组件跳转常量
+    public static final String COMPONENT_EN1 = "cc.winboll.studio.powerbell.MainActivityEN1";
+    public static final String COMPONENT_CN1 = "cc.winboll.studio.powerbell.MainActivityCN1";
+    public static final String COMPONENT_CN2 = "cc.winboll.studio.powerbell.MainActivityCN2";
+
+    // 动作跳转常量
+    public static final String ACTION_SWITCHTO_EN1 = "cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1";
+    public static final String ACTION_SWITCHTO_CN1 = "cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1";
+    public static final String ACTION_SWITCHTO_CN2 = "cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2";
+
+    // ====================================== 静态属性区 - 全局单例/状态 (按核心程度排序) ======================================
+    // 应用单例
+    private static App sApp;
+
+    // 配置与缓存工具 (全局单例)
+    public static AppConfigUtils sAppConfigUtils;
+    private static AppCacheUtils sAppCacheUtils;
+
+    // 资源与视图缓存 (强制驻留，极致缓存核心)
+    public static BackgroundSourceUtils sBackgroundSourceUtils;
+    public static BitmapCacheUtils sBitmapCacheUtils;
+    private static MemoryCachedBackgroundView sMemoryCachedBackgroundView;
+
+    // 系统状态 (电池电量)
+    public static volatile int sQuantityOfElectricity = INVALID_BATTERY_VALUE;
+
+    // 系统工具 (通知管理器)
+    private static NotificationManagerUtils sNotificationManagerUtils;
+
+    // ====================================== 成员属性区 - 非静态成员 (广播接收器) ======================================
+    private GlobalApplicationReceiver mGlobalReceiver;
+
+    // ====================================== 公共静态方法 - 单例/工具获取 (对外入口) ======================================
+    /**
+     * 获取应用全局单例实例
+     * @return 应用单例App实例
+     */
+    public static App getInstance() {
+        LogUtils.d(TAG, "【getInstance】应用单例获取方法调用 | 当前实例：" + sApp);
+        return sApp;
+    }
+
+    /**
+     * 获取配置工具类单例实例
+     * @param context 上下文对象
+     * @return 配置工具类AppConfigUtils实例
+     */
+    public static AppConfigUtils getAppConfigUtils(Context context) {
+        String contextClass = context != null ? context.getClass().getSimpleName() : "null";
+        LogUtils.d(TAG, "【getAppConfigUtils】配置工具获取方法调用 | 入参Context类型：" + contextClass);
+
+        if (sAppConfigUtils == null) {
+            sAppConfigUtils = AppConfigUtils.getInstance(context);
+            LogUtils.d(TAG, "【getAppConfigUtils】配置工具实例为空，已初始化新实例");
+        }
+        return sAppConfigUtils;
+    }
+
+    /**
+     * 获取缓存工具类单例实例
+     * @param context 上下文对象
+     * @return 缓存工具类AppCacheUtils实例
+     */
+    public static AppCacheUtils getAppCacheUtils(Context context) {
+        String contextClass = context != null ? context.getClass().getSimpleName() : "null";
+        LogUtils.d(TAG, "【getAppCacheUtils】缓存工具获取方法调用 | 入参Context类型：" + contextClass);
+
+        if (sAppCacheUtils == null) {
+            sAppCacheUtils = AppCacheUtils.getInstance(context);
+            LogUtils.d(TAG, "【getAppCacheUtils】缓存工具实例为空，已初始化新实例");
+        }
+        return sAppCacheUtils;
+    }
+
+    // ====================================== 公共成员方法 - 业务逻辑 (实例方法) ======================================
+    /**
+     * 清除电池历史数据
+     */
+    public void clearBatteryHistory() {
+        LogUtils.d(TAG, "【clearBatteryHistory】清除电池历史数据方法调用");
+        if (sAppCacheUtils != null) {
+            sAppCacheUtils.clearBatteryHistory();
+            LogUtils.d(TAG, "【clearBatteryHistory】电池历史数据清除成功");
+        } else {
+            LogUtils.w(TAG, "【clearBatteryHistory】电池历史数据清除失败 | 缓存工具实例sAppCacheUtils为空");
+        }
+    }
+
+    /**
+     * 获取视图缓存实例
+     * @return 视图缓存MemoryCachedBackgroundView实例
+     */
+    public MemoryCachedBackgroundView getMemoryCachedBackgroundView() {
+        LogUtils.d(TAG, "【getMemoryCachedBackgroundView】视图缓存获取方法调用 | 当前实例：" + sMemoryCachedBackgroundView);
+        return sMemoryCachedBackgroundView;
+    }
+
+    // ====================================== 公共静态方法 - 业务逻辑 (全局工具方法) ======================================
+    /**
+     * 手动清理所有缓存（仅主动调用生效，符合极致缓存策略）
+     */
+    public static void manualClearAllCache() {
+        LogUtils.w(CACHE_PROTECT_TAG, "【manualClearAllCache】手动清理缓存方法调用 | 仅主动触发生效");
+
+        // 清理Bitmap缓存
+        if (sBitmapCacheUtils != null) {
+            sBitmapCacheUtils.clearAllCache();
+            LogUtils.d(CACHE_PROTECT_TAG, "【manualClearAllCache】Bitmap缓存已清理");
+        }
+
+        // 仅置空视图缓存引用，不销毁实例（极致缓存策略）
+        if (sMemoryCachedBackgroundView != null) {
+            LogUtils.d(CACHE_PROTECT_TAG, "【manualClearAllCache】视图缓存引用已置空 | 实例保留");
+            sMemoryCachedBackgroundView = null;
+        }
+
+        LogUtils.w(CACHE_PROTECT_TAG, "【manualClearAllCache】手动清理缓存操作完成");
+    }
+
+    /**
+     * 发送通知消息（仅调试模式下生效）
+     * @param title 通知标题
+     * @param content 通知内容
+     */
+    public static void notifyMessage(String title, String content) {
+        LogUtils.d(TAG, "【notifyMessage】发送通知消息方法调用 | 标题：" + title + " | 内容：" + content);
+
+        boolean canSend = isDebugging() && sApp != null && sNotificationManagerUtils != null;
+        if (canSend) {
+            NotificationMessage message = new NotificationMessage(title, content, "");
+            sNotificationManagerUtils.showMessageNotification(sApp, message);
+            LogUtils.d(TAG, "【notifyMessage】通知消息发送成功");
+        } else {
+            LogUtils.d(TAG, "【notifyMessage】通知消息发送失败 | 条件不满足：调试模式=" + isDebugging() + " | 应用实例=" + (sApp != null) + " | 通知工具=" + (sNotificationManagerUtils != null));
+        }
+    }
+
+    // ====================================== 生命周期方法 - 应用全局生命周期 (重写父类方法) ======================================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "【onCreate】应用启动生命周期方法调用 | 开始初始化应用...");
+
+        // 初始化应用单例与调试模式
+        sApp = this;
+        setIsDebugging(BuildConfig.DEBUG);
+        LogUtils.d(TAG, "【onCreate】应用单例已初始化 | 调试模式：" + BuildConfig.DEBUG);
+
+        // 初始化核心组件
+        initBaseTools();
+        initUtils();
+        initReceiver();
+
+        LogUtils.d(TAG, "【onCreate】应用初始化完成 | 极致强制缓存策略已激活");
+    }
+
+    @Override
+    public void onTerminate() {
+        super.onTerminate();
+        LogUtils.d(TAG, "【onTerminate】应用终止生命周期方法调用 | 开始释放非缓存资源...");
+
+        // 释放非缓存资源
+        ToastUtils.release();
+        releaseNotificationManager();
+        releaseReceiver();
+
+        // 核心策略：不清理任何缓存
+        LogUtils.w(CACHE_PROTECT_TAG, "【onTerminate】极致缓存策略生效 | 所有缓存将保留在内存中");
+        LogUtils.d(TAG, "【onTerminate】非缓存资源释放完成");
+    }
+
+    @Override
+    public void onTrimMemory(int level) {
+        super.onTrimMemory(level);
+        LogUtils.w(CACHE_PROTECT_TAG, "【onTrimMemory】系统内存修剪回调 | 内存等级：" + level + " | 忽略修剪，缓存强制保护");
+        logDetailedCacheStatus();
+    }
+
+    @Override
+    public void onLowMemory() {
+        super.onLowMemory();
+        LogUtils.w(CACHE_PROTECT_TAG, "【onLowMemory】系统低内存回调 | 极致缓存策略生效 | 不执行任何缓存清理操作");
+        logDetailedCacheStatus();
+    }
+
+    // ====================================== 私有初始化方法 - 组件初始化 (按依赖顺序排序) ======================================
+    /**
+     * 初始化基础工具类（Activity管理、Toast、通知管理器）
+     */
+    private void initBaseTools() {
+        LogUtils.d(TAG, "【initBaseTools】基础工具类初始化开始...");
+        WinBoLLActivityManager.init(this);
+        ToastUtils.init(this);
+        sNotificationManagerUtils = new NotificationManagerUtils(this);
+        LogUtils.d(TAG, "【initBaseTools】基础工具类初始化完成");
+    }
+
+    /**
+     * 初始化核心工具与缓存（极致强制驻留，缓存核心）
+     */
+    private void initUtils() {
+        LogUtils.d(TAG, "【initUtils】核心工具与缓存初始化开始 | 极致缓存策略激活");
+
+        // 1. 配置与基础缓存工具初始化
+        sAppConfigUtils = getAppConfigUtils(this);
+        sAppCacheUtils = getAppCacheUtils(this);
+
+        // 2. 资源与Bitmap缓存工具初始化（永久驻留）
+        sBackgroundSourceUtils = BackgroundSourceUtils.getInstance(this);
+        sBackgroundSourceUtils.loadSettings();
+        sBitmapCacheUtils = BitmapCacheUtils.getInstance();
+        LogUtils.d(TAG, "【initUtils】资源与Bitmap缓存工具初始化完成 | 永久驻留内存");
+
+        // 3. 视图缓存初始化（永久驻留，无实例则创建）
+        sMemoryCachedBackgroundView = MemoryCachedBackgroundView.getLastInstance(this);
+        if (sMemoryCachedBackgroundView == null) {
+            sMemoryCachedBackgroundView = MemoryCachedBackgroundView.getInstance(this, sBackgroundSourceUtils.getCurrentBackgroundBean(), true);
+            LogUtils.d(TAG, "【initUtils】视图缓存无现有实例，已创建新实例");
+        }
+        LogUtils.d(TAG, "【initUtils】视图缓存初始化完成 | 永久驻留内存");
+    }
+
+    /**
+     * 注册全局广播接收器
+     */
+    private void initReceiver() {
+        LogUtils.d(TAG, "【initReceiver】全局广播接收器注册开始...");
+        mGlobalReceiver = new GlobalApplicationReceiver(this);
+        mGlobalReceiver.registerAction();
+        LogUtils.d(TAG, "【initReceiver】全局广播接收器注册完成");
+    }
+
+    // ====================================== 私有释放方法 - 资源释放 (按创建逆序排序) ======================================
+    /**
+     * 释放全局广播接收器
+     */
+    private void releaseReceiver() {
+        LogUtils.d(TAG, "【releaseReceiver】全局广播接收器释放开始...");
+        if (mGlobalReceiver != null) {
+            mGlobalReceiver.unregisterAction();
+            mGlobalReceiver = null;
+            LogUtils.d(TAG, "【releaseReceiver】全局广播接收器释放完成");
+        }
+    }
+
+    /**
+     * 释放通知管理器资源
+     */
+    private void releaseNotificationManager() {
+        LogUtils.d(TAG, "【releaseNotificationManager】通知管理器资源释放开始...");
+        if (sNotificationManagerUtils != null) {
+            sNotificationManagerUtils.release();
+            sNotificationManagerUtils = null;
+            LogUtils.d(TAG, "【releaseNotificationManager】通知管理器资源释放完成");
+        }
+    }
+
+    // ====================================== 私有辅助方法 - 日志/工具 (辅助功能) ======================================
+    /**
+     * 记录当前缓存详细状态（用于调试监控，极致缓存策略监控）
+     */
+    private void logDetailedCacheStatus() {
+        LogUtils.d(TAG, "【logDetailedCacheStatus】缓存状态监控日志开始...");
+
+        // Bitmap缓存状态
+        if (sBitmapCacheUtils != null) {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】BitmapCache - 有效");
+            try {
+                LogUtils.d(CACHE_PROTECT_TAG, "【缓存详情】Bitmap缓存数量：" + sBitmapCacheUtils.getCacheCount());
+            } catch (Exception e) {
+                LogUtils.e(CACHE_PROTECT_TAG, "【缓存详情】获取Bitmap缓存数量失败", e);
+            }
+        } else {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】BitmapCache - 未初始化");
+        }
+
+        // 视图缓存状态
+        if (sMemoryCachedBackgroundView != null) {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】ViewCache - 有效");
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存详情】视图实例数量：" + MemoryCachedBackgroundView.getInstanceCount());
+        } else {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】ViewCache - 引用已置空（实例可能保留）");
+        }
+    }
+}
+

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

@@ -0,0 +1,638 @@
+package cc.winboll.studio.powerbell;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.graphics.drawable.Drawable;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Message;
+import android.view.KeyEvent;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewStub;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.activitys.AboutActivity;
+import cc.winboll.studio.libaes.models.APPInfo;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.DevelopUtils;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.activities.BackgroundSettingsActivity;
+import cc.winboll.studio.powerbell.activities.BatteryReportActivity;
+import cc.winboll.studio.powerbell.activities.ClearRecordActivity;
+import cc.winboll.studio.powerbell.activities.SettingsActivity;
+import cc.winboll.studio.powerbell.activities.WinBoLLActivity;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.models.BatteryStyle;
+import cc.winboll.studio.powerbell.models.ControlCenterServiceBean;
+import cc.winboll.studio.powerbell.services.ControlCenterService;
+import cc.winboll.studio.powerbell.unittest.MainUnitTest2Activity;
+import cc.winboll.studio.powerbell.unittest.MainUnitTestActivity;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.ImageUtils;
+import cc.winboll.studio.powerbell.utils.PermissionUtils;
+import cc.winboll.studio.powerbell.utils.ServiceUtils;
+import cc.winboll.studio.powerbell.views.BatteryStyleView;
+import cc.winboll.studio.powerbell.views.MainContentView;
+
+/**
+ * 应用核心主活动
+ * 功能：管理电池监控、背景设置、服务启停、权限申请等核心功能
+ * 适配：Java7 | API30 | 内存泄漏防护 | UI与服务状态实时同步
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class MainActivity extends WinBoLLActivity implements MainContentView.OnViewActionListener {
+
+    // ======================== 静态常量区（抽离魔法值，按功能分类）========================
+    public static final String TAG = "MainActivity";
+    private static final int REQUEST_BACKGROUND_SETTINGS_ACTIVITY = 1001;
+    public static final String EXTRA_ISRELOAD_BACKGROUNDVIEW = "EXTRA_ISRELOAD_BACKGROUNDVIEW";
+    public static final String EXTRA_ISRELOAD_ACCENTCOLOR = "EXTRA_ISRELOAD_ACCENTCOLOR";
+    private static final long DELAY_LOAD_NON_CRITICAL = 500L;
+
+    // Handler 消息常量
+    public static final int MSG_RELOAD_APPCONFIG = 0;
+    public static final int MSG_CURRENTVALUEBATTERY = 1;
+    public static final int MSG_LOAD_BACKGROUND = 2;
+    private static final int MSG_UPDATE_SERVICE_SWITCH = 3;
+	private static final int MSG_UPDATE_BATTERYDRAWABLE = 4;
+
+    // ======================== 静态成员区（全局共享，管控生命周期）========================
+    private static MainActivity sMainActivity;
+    private static Handler sGlobalHandler;
+
+    // ======================== 工具类实例区（单例化，避免重复初始化）========================
+    private PermissionUtils mPermissionUtils;
+    private AppConfigUtils mAppConfigUtils;
+    private BackgroundSourceUtils mBgSourceUtils;
+
+    // ======================== 应用核心实例区 =========================
+    private App mApplication;
+    private MainContentView mMainContentView;
+    private ControlCenterServiceBean mServiceControlBean;
+
+    // ======================== 基础视图组件区 =========================
+    private Toolbar mToolbar;
+    private ViewStub mAdsViewStub;
+    private ADsBannerView mADsBannerView;
+    private Drawable mFrameDrawable;
+    private Menu mMenu;
+
+    // ======================== 生命周期方法区（按系统调用顺序排列）========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate() 调用 | savedInstanceState: " + savedInstanceState);
+
+        initGlobalHandler();
+        setContentView(R.layout.activity_main);
+        initPermissionUtils();
+        initMainContentView();
+        initCriticalView();
+        initCoreUtilsAsync();
+        loadNonCriticalViewDelayed();
+
+        // 处理首次启动参数
+        handleReloadBackgroundParam(getIntent());
+    }
+
+    @Override
+    protected void onNewIntent(Intent intent) {
+        super.onNewIntent(intent);
+        LogUtils.d(TAG, "onNewIntent() 调用 | intent: " + intent);
+        // 关键：更新Activity持有的Intent，确保后续获取最新值
+        setIntent(intent);
+        // 统一处理刷新背景参数
+        handleReloadBackgroundParam(intent);
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        LogUtils.d(TAG, "onPostCreate() 调用 | savedInstanceState: " + savedInstanceState);
+        mPermissionUtils.startPermissionRequest(this);
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume() 调用");
+
+        if (mADsBannerView != null) {
+            mADsBannerView.resumeADs(this);
+            LogUtils.d(TAG, "onResume: 广告视图已恢复");
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        LogUtils.d(TAG, "onPause() 调用");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy() 调用");
+
+        // 释放广告资源
+        if (mADsBannerView != null) {
+            mADsBannerView.releaseAdResources();
+            mADsBannerView = null;
+            LogUtils.d(TAG, "onDestroy: 广告资源已释放");
+        }
+        // 释放核心视图
+        if (mMainContentView != null) {
+            mMainContentView.releaseResources();
+            mMainContentView = null;
+            LogUtils.d(TAG, "onDestroy: 核心视图资源已释放");
+        }
+        // 销毁Handler防止内存泄漏
+        if (sGlobalHandler != null) {
+            sGlobalHandler.removeCallbacksAndMessages(null);
+            sGlobalHandler = null;
+            LogUtils.d(TAG, "onDestroy: 全局Handler已销毁");
+        }
+        // 释放Drawable
+        if (mFrameDrawable != null) {
+            mFrameDrawable.setCallback(null);
+            mFrameDrawable = null;
+            LogUtils.d(TAG, "onDestroy: 框架Drawable已释放");
+        }
+        // 置空所有引用，消除内存泄漏风险
+        sMainActivity = null;
+        mPermissionUtils = null;
+        mAppConfigUtils = null;
+        mBgSourceUtils = null;
+        mServiceControlBean = null;
+        mMenu = null;
+        mApplication = null;
+        mToolbar = null;
+        mAdsViewStub = null;
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        LogUtils.d(TAG, "onActivityResult() 调用 | requestCode: " + requestCode + " | resultCode: " + resultCode + " | data: " + data);
+        mPermissionUtils.handlePermissionRequest(this, requestCode, resultCode, data);
+
+        if (requestCode == REQUEST_BACKGROUND_SETTINGS_ACTIVITY && sGlobalHandler != null) {
+            sGlobalHandler.sendEmptyMessage(MSG_LOAD_BACKGROUND);
+            LogUtils.d(TAG, "onActivityResult: 发送背景加载消息");
+        }
+    }
+
+    // ======================== 菜单与导航方法区 ========================
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        LogUtils.d(TAG, "onCreateOptionsMenu() 调用 | menu: " + menu);
+        mMenu = menu;
+        AESThemeUtil.inflateMenu(this, menu);
+
+        // 调试模式加载测试菜单
+        if (App.isDebugging()) {
+            DevelopUtils.inflateMenu(this, menu);
+            getMenuInflater().inflate(R.menu.toolbar_unittest, mMenu);
+            LogUtils.d(TAG, "onCreateOptionsMenu: 已加载测试菜单");
+        }
+        getMenuInflater().inflate(R.menu.toolbar_main, mMenu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        LogUtils.d(TAG, "onOptionsItemSelected() 调用 | itemId: " + item.getItemId());
+        // 主题切换处理
+        if (AESThemeUtil.onAppThemeItemSelected(this, item)) {
+            recreate();
+			Intent mainIntent = new Intent(MainActivity.this, MainActivity.class);
+			mainIntent.putExtra(MainActivity.EXTRA_ISRELOAD_BACKGROUNDVIEW, true);
+			mainIntent.putExtra(MainActivity.EXTRA_ISRELOAD_ACCENTCOLOR, true);
+			startActivity(mainIntent);
+            return true;
+        }
+        // 开发者功能处理
+        if (DevelopUtils.onDevelopItemSelected(this, item)) {
+            return true;
+        }
+        // 菜单点击事件分发
+        switch (item.getItemId()) {
+            case R.id.action_settings:
+                startActivity(new Intent(this, SettingsActivity.class));
+                break;
+            case R.id.action_battery_report:
+                startActivity(new Intent(this, BatteryReportActivity.class));
+                break;
+            case R.id.action_clearrecord:
+                startActivity(new Intent(this, ClearRecordActivity.class));
+                break;
+            case R.id.action_changepicture:
+                startActivityForResult(new Intent(this, BackgroundSettingsActivity.class), REQUEST_BACKGROUND_SETTINGS_ACTIVITY);
+                break;
+            case R.id.action_unittestactivity:
+                startActivity(new Intent(this, MainUnitTestActivity.class));
+                break;
+            case R.id.action_unittest2activity:
+                startActivity(new Intent(this, MainUnitTest2Activity.class));
+                break;
+            case R.id.action_about:
+                startAboutActivity();
+                break;
+            default:
+                return super.onOptionsItemSelected(item);
+        }
+        return true;
+    }
+
+    @Override
+    public void setupToolbar() {
+        super.setupToolbar();
+        LogUtils.d(TAG, "setupToolbar() 调用");
+        if (getSupportActionBar() != null) {
+            getSupportActionBar().setDisplayHomeAsUpEnabled(false);
+            LogUtils.d(TAG, "setupToolbar: 已隐藏返回按钮");
+        }
+    }
+
+    @Override
+    public void onBackPressed() {
+        LogUtils.d(TAG, "onBackPressed() 调用");
+        moveTaskToBack(true);
+        LogUtils.d(TAG, "onBackPressed: 应用已退至后台");
+    }
+
+    @Override
+    public boolean dispatchKeyEvent(KeyEvent event) {
+        LogUtils.d(TAG, "dispatchKeyEvent() 调用 | event: " + event);
+        return super.dispatchKeyEvent(event);
+    }
+
+    // ======================== 核心初始化方法区 ========================
+    private void initPermissionUtils() {
+        LogUtils.d(TAG, "initPermissionUtils() 调用");
+        mPermissionUtils = PermissionUtils.getInstance();
+        LogUtils.d(TAG, "initPermissionUtils: 权限工具类已初始化");
+    }
+
+    private void initGlobalHandler() {
+        LogUtils.d(TAG, "initGlobalHandler() 调用");
+        if (sGlobalHandler == null) {
+            sGlobalHandler = new Handler() {
+                @Override
+                public void handleMessage(Message msg) {
+                    // Activity已销毁则跳过消息处理
+                    if (sMainActivity == null || sMainActivity.isFinishing() || sMainActivity.isDestroyed()) {
+                        LogUtils.w(TAG, "handleMessage: Activity已销毁，跳过消息 | what: " + msg.what);
+                        return;
+                    }
+                    LogUtils.d(TAG, "handleMessage() 调用 | what: " + msg.what);
+
+                    switch (msg.what) {
+                        case MSG_RELOAD_APPCONFIG:
+                            sMainActivity.updateViewData();
+                            break;
+                        case MSG_CURRENTVALUEBATTERY:
+                            if (sMainActivity.mMainContentView != null) {
+                                sMainActivity.mMainContentView.updateCurrentBattery(msg.arg1);
+                                LogUtils.d(TAG, "handleMessage: 更新当前电量 | value: " + msg.arg1);
+                            }
+                            break;
+                        case MSG_LOAD_BACKGROUND:
+                            sMainActivity.reloadBackground();
+                            break;
+                        case MSG_UPDATE_SERVICE_SWITCH:
+                            sMainActivity.updateServiceSwitchUI();
+                            break;
+						case MSG_UPDATE_BATTERYDRAWABLE:
+                            sMainActivity.updateBatteryDrawable();
+                            break;
+                    }
+                }
+            };
+            LogUtils.d(TAG, "initGlobalHandler: 全局Handler已创建");
+        } else {
+            LogUtils.d(TAG, "initGlobalHandler: 全局Handler已存在，无需重复创建");
+        }
+    }
+
+    private void initMainContentView() {
+        LogUtils.d(TAG, "initMainContentView() 调用");
+        View rootView = findViewById(android.R.id.content);
+        mMainContentView = new MainContentView(this, rootView, this);
+        LogUtils.d(TAG, "initMainContentView: 核心内容视图已初始化");
+    }
+
+    private void initCriticalView() {
+        LogUtils.d(TAG, "initCriticalView() 调用");
+        sMainActivity = this;
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        if (mToolbar != null) {
+            mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+            LogUtils.d(TAG, "initCriticalView: 工具栏已设置标题样式");
+        }
+        mAdsViewStub = findViewById(R.id.stub_ads_banner);
+        LogUtils.d(TAG, "initCriticalView: 广告ViewStub已获取");
+    }
+
+    private void initCoreUtilsAsync() {
+        LogUtils.d(TAG, "initCoreUtilsAsync() 调用");
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "initCoreUtilsAsync: 异步线程启动 | threadId: " + Thread.currentThread().getId());
+					mApplication = (App) getApplication();
+					mAppConfigUtils = AppConfigUtils.getInstance(getApplicationContext());
+					mBgSourceUtils = BackgroundSourceUtils.getInstance(getActivity());
+
+					// 初始化服务控制配置
+					mServiceControlBean = ControlCenterServiceBean.loadBean(getApplicationContext(), ControlCenterServiceBean.class);
+					if (mServiceControlBean == null) {
+						mServiceControlBean = new ControlCenterServiceBean(false);
+						ControlCenterServiceBean.saveBean(getApplicationContext(), mServiceControlBean);
+						LogUtils.d(TAG, "initCoreUtilsAsync: 服务配置不存在，已创建默认配置");
+					}
+
+					// 根据配置启停服务
+					final boolean isServiceEnable = mServiceControlBean.isEnableService();
+					final boolean isServiceAlive = ServiceUtils.isServiceAlive(getApplicationContext(), ControlCenterService.class.getName());
+					LogUtils.d(TAG, "initCoreUtilsAsync: 服务配置状态 | isServiceEnable: " + isServiceEnable + " | isServiceAlive: " + isServiceAlive);
+
+					if (isServiceEnable && !isServiceAlive) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									ControlCenterService.startControlCenterService(getApplicationContext());
+									LogUtils.d(TAG, "initCoreUtilsAsync: 服务已启动");
+								}
+							});
+					} else if (!isServiceEnable && isServiceAlive) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									ControlCenterService.stopControlCenterService(getApplicationContext());
+									LogUtils.d(TAG, "initCoreUtilsAsync: 服务已停止");
+								}
+							});
+					}
+
+					// 主线程更新UI
+					runOnUiThread(new Runnable() {
+							@Override
+							public void run() {
+								if (isFinishing() || isDestroyed()) {
+									LogUtils.w(TAG, "initCoreUtilsAsync: Activity已销毁，跳过UI更新");
+									return;
+								}
+								// 适配API30，兼容低版本Drawable加载
+								if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+									mFrameDrawable = getResources().getDrawable(R.drawable.bg_frame, getTheme());
+								} else {
+									mFrameDrawable = getResources().getDrawable(R.drawable.bg_frame);
+								}
+								updateViewData();
+								sGlobalHandler.sendEmptyMessage(MSG_LOAD_BACKGROUND);
+								sGlobalHandler.sendEmptyMessage(MSG_UPDATE_SERVICE_SWITCH);
+								LogUtils.d(TAG, "initCoreUtilsAsync: UI更新消息已发送");
+							}
+						});
+				}
+			}).start();
+    }
+
+    private void loadNonCriticalViewDelayed() {
+        LogUtils.d(TAG, "loadNonCriticalViewDelayed() 调用 | 延迟时长: " + DELAY_LOAD_NON_CRITICAL + "ms");
+        new Handler().postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					if (isFinishing() || isDestroyed()) {
+						LogUtils.w(TAG, "loadNonCriticalViewDelayed: Activity已销毁，跳过广告加载");
+						return;
+					}
+					loadAdsView();
+				}
+			}, DELAY_LOAD_NON_CRITICAL);
+    }
+
+    // ======================== 视图操作方法区 ========================
+    private void handleReloadBackgroundParam(Intent intent) {
+        LogUtils.d(TAG, "handleReloadBackgroundParam() 调用 | intent: " + intent);
+        if (intent == null) {
+            LogUtils.d(TAG, "handleReloadBackgroundParam: Intent 为空");
+            return;
+        }
+
+		boolean isReloadAccentColor = intent.getBooleanExtra(EXTRA_ISRELOAD_ACCENTCOLOR, false);
+        if (isReloadAccentColor) {
+			App.sBackgroundSourceUtils.getCurrentBackgroundBean().setPixelColor(ImageUtils.getColorAccent(this));
+			App.sBackgroundSourceUtils.saveSettings();
+        }
+
+        boolean isReloadBackgroundView = intent.getBooleanExtra(EXTRA_ISRELOAD_BACKGROUNDVIEW, false);
+        if (isReloadBackgroundView) {
+            LogUtils.d(TAG, "handleReloadBackgroundParam: 接收到刷新背景视图指令");
+            reloadBackgroundView();
+        }
+    }
+
+    private void reloadBackgroundView() {
+        LogUtils.d(TAG, "reloadBackgroundView() 调用");
+        mMainContentView.reloadBackgroundView();
+    }
+
+    private void loadAdsView() {
+        LogUtils.d(TAG, "loadAdsView() 调用");
+        if (mAdsViewStub == null) {
+            LogUtils.e(TAG, "loadAdsView: 广告ViewStub为空，加载失败");
+            return;
+        }
+        if (mADsBannerView == null) {
+            View adsView = mAdsViewStub.inflate();
+            mADsBannerView = adsView.findViewById(R.id.adsbanner);
+            LogUtils.d(TAG, "loadAdsView: 广告视图已加载");
+        } else {
+            LogUtils.d(TAG, "loadAdsView: 广告视图已存在，无需重复加载");
+        }
+    }
+
+    private void updateViewData() {
+        LogUtils.d(TAG, "updateViewData() 调用");
+        if (mMainContentView == null || mFrameDrawable == null) {
+            LogUtils.e(TAG, "updateViewData: 核心视图或框架背景为空，更新失败");
+            return;
+        }
+        mMainContentView.updateViewData(mFrameDrawable);
+        LogUtils.d(TAG, "updateViewData: 视图数据已更新");
+    }
+
+	void updateBatteryDrawable() {
+		BatteryStyle batteryStyle = BatteryStyleView.getSavedBatteryStyle(this);
+		mMainContentView.updateBatteryDrawable(batteryStyle);
+	}
+
+	public static void sendUpdateBatteryDrawableMessage() {
+		if (sGlobalHandler != null) {
+			sGlobalHandler.sendEmptyMessage(MSG_UPDATE_BATTERYDRAWABLE);
+		}
+	}
+
+    private void reloadBackground() {
+        LogUtils.d(TAG, "reloadBackground() 调用");
+        if (mMainContentView == null || mBgSourceUtils == null) {
+            LogUtils.e(TAG, "reloadBackground: 核心视图或背景工具类为空，加载失败");
+            return;
+        }
+        BackgroundBean currentBgBean = mBgSourceUtils.getCurrentBackgroundBean();
+        if (currentBgBean != null) {
+            mMainContentView.backgroundView.loadByBackgroundBean(currentBgBean, true);
+            LogUtils.d(TAG, "reloadBackground: 已加载自定义背景");
+        } else {
+            mMainContentView.backgroundView.setBackgroundResource(R.drawable.default_background);
+            LogUtils.d(TAG, "reloadBackground: 已加载默认背景");
+        }
+    }
+
+    private void updateServiceSwitchUI() {
+        LogUtils.d(TAG, "updateServiceSwitchUI() 调用");
+        if (mMainContentView == null || mServiceControlBean == null) {
+            LogUtils.e(TAG, "updateServiceSwitchUI: 核心视图或服务配置为空，更新失败");
+            return;
+        }
+        boolean configEnabled = mServiceControlBean.isEnableService();
+        mMainContentView.setServiceSwitchEnabled(false);
+        mMainContentView.setServiceSwitchChecked(configEnabled);
+        mMainContentView.setServiceSwitchEnabled(true);
+        LogUtils.d(TAG, "updateServiceSwitchUI: 服务开关已更新 | 状态: " + configEnabled);
+    }
+
+    // ======================== 服务与线程管理方法区 ========================
+    private void toggleServiceEnableState(boolean isEnable) {
+        LogUtils.d(TAG, "toggleServiceEnableState() 调用 | 目标状态: " + isEnable);
+        if (mServiceControlBean == null) {
+            LogUtils.e(TAG, "toggleServiceEnableState: 服务配置为空，切换失败");
+            return;
+        }
+        mServiceControlBean.setIsEnableService(isEnable);
+        ControlCenterServiceBean.saveBean(getApplicationContext(), mServiceControlBean);
+        LogUtils.d(TAG, "toggleServiceEnableState: 服务配置已保存");
+
+        // UI开关联动服务启停
+        if (isEnable) {
+            if (!ServiceUtils.isServiceAlive(getApplicationContext(), ControlCenterService.class.getName())) {
+                ControlCenterService.startControlCenterService(getApplicationContext());
+                LogUtils.d(TAG, "toggleServiceEnableState: 服务已启动");
+            }
+        } else {
+            ControlCenterService.stopControlCenterService(getApplicationContext());
+            LogUtils.d(TAG, "toggleServiceEnableState: 服务已停止");
+        }
+
+        sGlobalHandler.sendEmptyMessage(MSG_UPDATE_SERVICE_SWITCH);
+    }
+
+    // ======================== 页面跳转方法区 ========================
+    private void startAboutActivity() {
+        LogUtils.d(TAG, "startAboutActivity() 调用");
+        Intent aboutIntent = new Intent(getApplicationContext(), AboutActivity.class);
+        APPInfo appInfo = genDefaultAppInfo();
+        aboutIntent.putExtra(AboutActivity.EXTRA_APPINFO, appInfo);
+        WinBoLLActivityManager.getInstance().startWinBoLLActivity(getApplicationContext(), aboutIntent, AboutActivity.class);
+        LogUtils.d(TAG, "startAboutActivity: 关于页面已启动");
+    }
+
+    // ======================== 消息发送方法区 ========================
+    private void notifyServiceAppConfigChange() {
+        LogUtils.d(TAG, "notifyServiceAppConfigChange() 调用");
+        ControlCenterService.sendAppConfigStatusUpdateMessage(this);
+        reloadAppConfig();
+        LogUtils.d(TAG, "notifyServiceAppConfigChange: 服务配置已通知更新");
+    }
+
+    public static void reloadAppConfig() {
+        LogUtils.d(TAG, "reloadAppConfig() 调用");
+        if (sGlobalHandler != null) {
+            sGlobalHandler.sendEmptyMessage(MSG_RELOAD_APPCONFIG);
+            LogUtils.d(TAG, "reloadAppConfig: 配置重载消息已发送");
+        } else {
+            LogUtils.w(TAG, "reloadAppConfig: 全局Handler为空，消息发送失败");
+        }
+    }
+
+    public static void sendCurrentBatteryValueMessage(int value) {
+        LogUtils.d(TAG, "sendCurrentBatteryValueMessage() 调用 | 电量: " + value);
+        if (sGlobalHandler != null) {
+            Message msg = sGlobalHandler.obtainMessage(MSG_CURRENTVALUEBATTERY);
+            msg.arg1 = value;
+            sGlobalHandler.sendMessage(msg);
+            LogUtils.d(TAG, "sendCurrentBatteryValueMessage: 电量消息已发送");
+        } else {
+            LogUtils.w(TAG, "sendCurrentBatteryValueMessage: 全局Handler为空，消息发送失败");
+        }
+    }
+
+    // ======================== 辅助工具方法区 ========================
+    private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "powerbell";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName(getString(R.string.app_name));
+        appInfo.setAppIcon(R.drawable.ic_launcher);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=PowerBell");
+        appInfo.setAppAPKName("PowerBell");
+        appInfo.setAppAPKFolderName("PowerBell");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+
+    // ======================== MainContentView 事件回调区 ========================
+    @Override
+    public void onChargeReminderSwitchChanged(boolean isChecked) {
+        LogUtils.d(TAG, "onChargeReminderSwitchChanged() 调用 | isChecked: " + isChecked);
+        notifyServiceAppConfigChange();
+    }
+
+    @Override
+    public void onUsageReminderSwitchChanged(boolean isChecked) {
+        LogUtils.d(TAG, "onUsageReminderSwitchChanged() 调用 | isChecked: " + isChecked);
+        notifyServiceAppConfigChange();
+    }
+
+    @Override
+    public void onServiceSwitchChanged(boolean isChecked) {
+        LogUtils.d(TAG, "onServiceSwitchChanged() 调用 | isChecked: " + isChecked);
+        toggleServiceEnableState(isChecked);
+    }
+
+    @Override
+    public void onChargeReminderProgressChanged(int progress) {
+        LogUtils.d(TAG, "onChargeReminderProgressChanged() 调用 | progress: " + progress);
+        notifyServiceAppConfigChange();
+    }
+
+    @Override
+    public void onUsageReminderProgressChanged(int progress) {
+        LogUtils.d(TAG, "onUsageReminderProgressChanged() 调用 | progress: " + progress);
+        notifyServiceAppConfigChange();
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BackgroundSettingsActivity.java

@@ -0,0 +1,994 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.Manifest;
+import android.app.Activity;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.graphics.Bitmap;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.provider.MediaStore;
+import android.provider.Settings;
+import android.text.TextUtils;
+import android.view.View;
+import android.view.ViewTreeObserver;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.widget.Toolbar;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+import androidx.core.content.FileProvider;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.dialogs.BackgroundPicturePreviewDialog;
+import cc.winboll.studio.powerbell.dialogs.ColorPaletteDialog;
+import cc.winboll.studio.powerbell.dialogs.NetworkBackgroundDialog;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.BitmapCacheUtils;
+import cc.winboll.studio.powerbell.utils.FileUtils;
+import cc.winboll.studio.powerbell.utils.ImageCropUtils;
+import cc.winboll.studio.powerbell.utils.ImageUtils;
+import cc.winboll.studio.powerbell.utils.UriUtils;
+import cc.winboll.studio.powerbell.views.BackgroundView;
+import java.io.File;
+
+/**
+ * 背景设置页面（支持图片选择、拍照、裁剪、像素拾取、调色板等功能）
+ * 核心：基于强制缓存策略，支持预览与设置提交分离，保留操作状态
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class BackgroundSettingsActivity extends WinBoLLActivity {
+    // ====================== 常量定义（按功能分类排序）======================
+    public static final String TAG = "BackgroundSettingsActivity";
+
+    // 系统版本常量
+    private static final int SDK_VERSION_TIRAMISU = 33;
+
+    // 请求码（按功能分组，从小到大排序）
+    public static final int REQUEST_SELECT_PICTURE = 0;
+    public static final int REQUEST_TAKE_PHOTO = 1;
+    public static final int REQUEST_CROP_IMAGE = 2;
+    private static final int REQUEST_PIXELPICKER = 1001;
+    private static final int REQUEST_CAMERA_PERMISSION = 1004;
+
+    // Bitmap解析常量
+    private static final int BITMAP_MAX_SIZE = 2048;
+    private static final int BITMAP_MAX_SAMPLE_SIZE = 16;
+
+    // ====================== 成员变量（按依赖优先级+功能分类）======================
+    // 工具类实例
+    private BackgroundSourceUtils mBgSourceUtils;
+    private BitmapCacheUtils mBitmapCache;
+
+    // 视图组件
+    private Toolbar mToolbar;
+    private BackgroundView mBackgroundView;
+
+    // 状态标记（volatile保证多线程可见性）
+    private volatile boolean isCommitSettings = false;
+    private volatile boolean isPreviewBackgroundChanged = false;
+
+    // ====================== 生命周期方法（按执行顺序排列）======================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate() 开始初始化");
+        setContentView(R.layout.activity_background_settings);
+
+        // 初始化核心组件
+        initCoreComponents();
+        // 初始化Toolbar与点击事件
+        initToolbar();
+        initClickListeners();
+        LogUtils.d(TAG, "onCreate() 视图与事件绑定完成");
+
+        // 处理分享意图或初始化预览
+        handleIntentOrPreview();
+        // 初始化预览环境并刷新
+        initPreviewEnvironment();
+
+        LogUtils.d(TAG, "onCreate() 初始化完成");
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        LogUtils.d(TAG, "onPostCreate() 执行双重刷新预览");
+
+        // 监听视图布局完成事件
+        mBackgroundView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
+				@Override
+				public void onGlobalLayout() {
+					// 移除监听，避免重复回调
+					if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+						mBackgroundView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
+					} else {
+						mBackgroundView.getViewTreeObserver().removeGlobalOnLayoutListener(this);
+					}
+
+					// 此时已获取真实宽高
+					int width = mBackgroundView.getWidth();
+					int height = mBackgroundView.getHeight();
+					LogUtils.d(TAG, String.format("onPostCreate() 获取视图尺寸 | width=%d | height=%d", width, height));
+					if (width > 0 && height > 0) {
+						AppConfigUtils appConfigUtils = AppConfigUtils.getInstance(BackgroundSettingsActivity.this);
+						appConfigUtils.loadAppConfig();
+						appConfigUtils.mAppConfigBean.setDefaultFrameWidth(width);
+						appConfigUtils.mAppConfigBean.setDefaultFrameHeight(height);
+						appConfigUtils.saveAppConfig();
+						LogUtils.d(TAG, "onPostCreate() 保存默认相框尺寸成功");
+						doubleRefreshPreview();
+					}
+				}
+			});
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        LogUtils.d(TAG, String.format("onActivityResult() | requestCode=%d | resultCode=%d | data=%s",
+									  requestCode, resultCode, data != null ? data.toString() : "null"));
+
+        try {
+            if (resultCode != RESULT_OK) {
+                LogUtils.d(TAG, String.format("onActivityResult() 操作取消 | requestCode=%d", requestCode));
+                handleOperationCancelOrFail();
+                return;
+            }
+            handleActivityResult(requestCode, data);
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("onActivityResult() 异常 | requestCode=%d | 异常信息=%s",
+										  requestCode, e.getMessage()));
+            ToastUtils.show("操作失败");
+        }
+    }
+
+    @Override
+    public void finish() {
+        LogUtils.d(TAG, String.format("finish() | isCommitSettings=%b | isPreviewBackgroundChanged=%b",
+									  isCommitSettings, isPreviewBackgroundChanged));
+        if (isCommitSettings) {
+            super.finish();
+        } else {
+            handleFinishConfirmation();
+        }
+    }
+
+    // ====================== 权限回调方法（单独分类）======================
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        LogUtils.d(TAG, String.format("onRequestPermissionsResult() | requestCode=%d | 权限数量=%d | 结果数量=%d",
+									  requestCode, permissions.length, grantResults.length));
+        if (requestCode == REQUEST_CAMERA_PERMISSION) {
+            handleCameraPermissionResult(grantResults);
+        }
+    }
+
+    // ====================== 界面初始化方法（Toolbar + 点击事件）======================
+    private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+    private void initClickListeners() {
+        LogUtils.d(TAG, "initClickListeners() 开始绑定按钮点击事件");
+        // 绑定所有按钮点击事件
+        bindClickListener(R.id.activitybackgroundsettingsAButton1, onOriginNullClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton2, onReceivedPictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton3, onTakePhotoClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton4, onSelectPictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton5, onNetworkBackgroundDialog);
+        bindClickListener(R.id.activitybackgroundsettingsAButton6, onCropPictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton7, onCropFreePictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton8, onPixelPickerClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton9, onColorPaletteClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton10, onCleanPixelClickListener);
+        LogUtils.d(TAG, "initClickListeners() 按钮点击事件绑定完成");
+    }
+
+    // 通用按钮绑定工具方法
+    private void bindClickListener(int resId, View.OnClickListener listener) {
+        LogUtils.d(TAG, String.format("bindClickListener() | resId=%d", resId));
+        View view = findViewById(resId);
+        if (view != null) {
+            view.setOnClickListener(listener);
+            LogUtils.d(TAG, String.format("bindClickListener() | resId=%d 绑定成功", resId));
+        } else {
+            LogUtils.e(TAG, String.format("bindClickListener() | 未找到视图：%d", resId));
+        }
+    }
+
+    // ====================== 按钮点击事件（按功能分类）======================
+    private View.OnClickListener onOriginNullClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onOriginNullClickListener() | 取消背景图片");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onOriginNullClickListener() | 预览Bean为空");
+                return;
+            }
+            previewBean.setIsUseBackgroundFile(false);
+            mBgSourceUtils.saveSettings();
+            doubleRefreshPreview();
+            isPreviewBackgroundChanged = true;
+        }
+    };
+
+    private View.OnClickListener onSelectPictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onSelectPictureClickListener() | 选择图片");
+            launchImageSelector();
+        }
+    };
+
+    private View.OnClickListener onNetworkBackgroundDialog = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onNetworkBackgroundDialog() | 打开网络背景对话框");
+            NetworkBackgroundDialog networkBackgroundDialog = new NetworkBackgroundDialog(BackgroundSettingsActivity.this, new NetworkBackgroundDialog.OnDialogClickListener() {
+					@Override
+					public void onConfirm(String szConfirmFilePath) {
+						LogUtils.d(TAG, String.format("网络背景确认 onConfirm() | 文件路径=%s", szConfirmFilePath));
+						// 拷贝文件到预览数据并启动裁剪
+						if (putUriFileToPreviewSource(new File(szConfirmFilePath))) {
+							startImageCrop(false);
+						}
+					}
+
+					@Override
+					public void onCancel() {
+						LogUtils.d(TAG, "网络背景取消 onCancel()");
+					}
+				});
+            networkBackgroundDialog.show();
+        }
+    };
+
+    private View.OnClickListener onCropPictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onCropPictureClickListener() | 固定比例裁剪");
+            startImageCrop(false);
+        }
+    };
+
+    private View.OnClickListener onCropFreePictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onCropFreePictureClickListener() | 自由裁剪");
+            startImageCrop(true);
+        }
+    };
+
+    private View.OnClickListener onTakePhotoClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onTakePhotoClickListener() | 拍照");
+            // 动态申请相机权限
+            if (ContextCompat.checkSelfPermission(BackgroundSettingsActivity.this, Manifest.permission.CAMERA)
+				!= PackageManager.PERMISSION_GRANTED) {
+                LogUtils.d(TAG, "拍照准备 | 相机权限未授予，发起申请");
+                ActivityCompat.requestPermissions(
+					BackgroundSettingsActivity.this,
+					new String[]{Manifest.permission.CAMERA},
+					REQUEST_CAMERA_PERMISSION);
+                return;
+            }
+            handleTakePhoto();
+        }
+    };
+
+    private View.OnClickListener onReceivedPictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onReceivedPictureClickListener() | 恢复收到的图片");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onReceivedPictureClickListener() | 预览Bean为空");
+                return;
+            }
+            previewBean.setIsUseBackgroundFile(true);
+            mBgSourceUtils.saveSettings();
+            doubleRefreshPreview();
+            isPreviewBackgroundChanged = true;
+        }
+    };
+
+    private View.OnClickListener onPixelPickerClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onPixelPickerClickListener() | 像素拾取");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onPixelPickerClickListener() | 预览Bean为空");
+                ToastUtils.show("无有效图片可拾取像素");
+                return;
+            }
+            String targetImagePath = previewBean.getBackgroundFilePath();
+            File targetFile = new File(targetImagePath);
+            if (targetFile == null || !targetFile.exists() || targetFile.length() <= 0) {
+                ToastUtils.show("无有效图片可拾取像素");
+                LogUtils.e(TAG, String.format("像素拾取失败 | 文件无效：%s", targetImagePath));
+                return;
+            }
+            Intent intent = new Intent(getApplicationContext(), PixelPickerActivity.class);
+            intent.putExtra("imagePath", targetImagePath);
+            startActivityForResult(intent, REQUEST_PIXELPICKER);
+            LogUtils.d(TAG, String.format("像素拾取启动 | 路径：%s", targetImagePath));
+        }
+    };
+
+    private View.OnClickListener onCleanPixelClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onCleanPixelClickListener() | 清空像素颜色");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onCleanPixelClickListener() | 预览Bean为空");
+                return;
+            }
+            int oldColor = previewBean.getPixelColor();
+            previewBean.setPixelColor(ImageUtils.getColorAccent(BackgroundSettingsActivity.this));
+            mBgSourceUtils.saveSettings();
+            doubleRefreshPreview();
+            isPreviewBackgroundChanged = true;
+            ToastUtils.show("像素颜色已清空");
+            LogUtils.d(TAG, String.format("像素清空 | 旧颜色：#%08X", oldColor));
+        }
+    };
+
+    private View.OnClickListener onColorPaletteClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onColorPaletteClickListener() | 调色板按钮");
+            final BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onColorPaletteClickListener() | 预览Bean为空");
+                return;
+            }
+            int initialColor = previewBean.getPixelColor();
+            LogUtils.d(TAG, String.format("调色板 | 初始颜色：#%08X", initialColor));
+            ColorPaletteDialog dialog = new ColorPaletteDialog(BackgroundSettingsActivity.this, initialColor, new ColorPaletteDialog.OnColorSelectedListener() {
+					@Override
+					public void onColorSelected(int color) {
+						previewBean.setPixelColor(color);
+						mBgSourceUtils.saveSettings();
+						doubleRefreshPreview();
+						isPreviewBackgroundChanged = true;
+						LogUtils.d(TAG, String.format("颜色选择 | 选中颜色：#%08X", color));
+					}
+				});
+            dialog.show();
+            LogUtils.d(TAG, "调色板 | 对话框已显示");
+        }
+    };
+
+    // ====================== 工具方法（通用工具 + 视图工具）======================
+    /**
+     * 生成 FileProvider Uri，适配 Android 7.0+
+     * @param file 目标文件
+     * @return 适配后的Uri，失败返回null
+     */
+    public Uri getFileProviderUri(File file) {
+        LogUtils.d(TAG, String.format("getFileProviderUri() | 文件路径：%s", (file != null ? file.getAbsolutePath() : "null")));
+        if (file == null) {
+            LogUtils.e(TAG, "getFileProviderUri() | 文件为空");
+            return null;
+        }
+        try {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                String FILE_PROVIDER_AUTHORITY = getPackageName() + ".fileprovider";
+                return FileProvider.getUriForFile(this, FILE_PROVIDER_AUTHORITY, file);
+            } else {
+                return Uri.fromFile(file);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("getFileProviderUri() | 生成Uri失败：%s", e.getMessage()));
+            return null;
+        }
+    }
+
+    /**
+     * 校验 Bitmap 是否有效（未被回收且不为空）
+     * @param bitmap 目标Bitmap
+     * @return 有效返回true，否则false
+     */
+    private boolean isBitmapValid(Bitmap bitmap) {
+        boolean isValid = bitmap != null && !bitmap.isRecycled();
+        LogUtils.d(TAG, String.format("isBitmapValid() | Bitmap有效性校验：%b", isValid));
+        return isValid;
+    }
+
+    /**
+     * 双重刷新预览，确保背景加载最新数据
+     */
+    private void doubleRefreshPreview() {
+        LogUtils.d(TAG, "doubleRefreshPreview() 开始双重刷新预览");
+        if (mBgSourceUtils == null || mBackgroundView == null || isFinishing()) {
+            LogUtils.w(TAG, "双重刷新 跳过：对象为空或Activity已结束");
+            return;
+        }
+
+        // 第一重刷新
+        try {
+            mBgSourceUtils.loadSettings();
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            mBackgroundView.loadByBackgroundBean(previewBean, true);
+            LogUtils.d(TAG, "双重刷新 第一重完成");
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("双重刷新 第一重异常：%s", e.getMessage()));
+            return;
+        }
+
+        // 第二重刷新（延迟执行）
+        new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					if (mBackgroundView != null && !isFinishing() && mBgSourceUtils != null) {
+						try {
+							mBgSourceUtils.loadSettings();
+							BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+							mBackgroundView.loadByBackgroundBean(previewBean, true);
+							LogUtils.d(TAG, "双重刷新 第二重完成");
+						} catch (Exception e) {
+							LogUtils.e(TAG, String.format("双重刷新 第二重异常：%s", e.getMessage()));
+						}
+					}
+				}
+			}, 200);
+    }
+
+    // ====================== 业务逻辑方法（按功能分类）======================
+    /**
+     * 初始化核心组件（工具类+视图）
+     */
+    private void initCoreComponents() {
+        LogUtils.d(TAG, "initCoreComponents() 开始初始化");
+        // 初始化视图
+        mBackgroundView = findViewById(R.id.background_view);
+        if (mBackgroundView == null) {
+            LogUtils.e(TAG, "initCoreComponents() | BackgroundView未找到");
+        }
+        // 初始化工具类
+        mBgSourceUtils = BackgroundSourceUtils.getInstance(this);
+        mBgSourceUtils.loadSettings();
+        mBitmapCache = BitmapCacheUtils.getInstance();
+        LogUtils.d(TAG, "initCoreComponents() 视图与工具类加载完成");
+    }
+
+    /**
+     * 处理意图或初始化预览
+     */
+    private void handleIntentOrPreview() {
+        LogUtils.d(TAG, "handleIntentOrPreview() 开始处理");
+        if (handleShareIntent()) {
+            ToastUtils.show("已接收分享图片");
+            LogUtils.d(TAG, "handleIntentOrPreview() | 处理分享意图成功");
+        } else {
+            mBgSourceUtils.setCurrentSourceToPreview();
+            LogUtils.d(TAG, "handleIntentOrPreview() | 加载当前背景配置");
+        }
+    }
+
+    /**
+     * 初始化预览环境
+     */
+    private void initPreviewEnvironment() {
+        LogUtils.d(TAG, "initPreviewEnvironment() 开始初始化");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        mBgSourceUtils.createAndUpdatePreviewEnvironmentForCropping(previewBean);
+        doubleRefreshPreview();
+        LogUtils.d(TAG, "initPreviewEnvironment() 初始化完成");
+    }
+
+    /**
+     * 处理分享意图
+     * @return 处理成功返回true，否则false
+     */
+    private boolean handleShareIntent() {
+        LogUtils.d(TAG, "handleShareIntent() 开始处理");
+        Intent intent = getIntent();
+        if (intent != null) {
+            String action = intent.getAction();
+            String type = intent.getType();
+            LogUtils.d(TAG, String.format("分享处理 | action：%s，type：%s", action, type));
+            if (Intent.ACTION_SEND.equals(action) && type != null && isImageType(type)) {
+                showSharePreviewDialog();
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * 显示分享图片预览对话框
+     */
+    private void showSharePreviewDialog() {
+        LogUtils.d(TAG, "showSharePreviewDialog() 开始显示");
+        BackgroundPicturePreviewDialog dlg = new BackgroundPicturePreviewDialog(this, new BackgroundPicturePreviewDialog.IOnRecivedPictureListener() {
+				@Override
+				public void onAcceptRecivedPicture(Uri uriRecivedPicture) {
+					LogUtils.d(TAG, String.format("分享确认 | Uri：%s", uriRecivedPicture.toString()));
+					if (putUriFileToPreviewSource(uriRecivedPicture)) {
+						startImageCrop(false);
+					}
+				}
+			});
+        dlg.show();
+        LogUtils.d(TAG, "分享处理 | 显示图片预览对话框");
+    }
+
+    /**
+     * 判断是否为图片类型
+     * @param mimeType MIME类型
+     * @return 是图片返回true，否则false
+     */
+    private boolean isImageType(String mimeType) {
+        if (mimeType == null) {
+            return false;
+        }
+        String lowerMimeType = mimeType.toLowerCase();
+        LogUtils.d(TAG, String.format("isImageType() | mimeType: %s, lowerMimeType: %s", mimeType, lowerMimeType));
+        return lowerMimeType.startsWith("image/");
+    }
+
+    /**
+     * 启动图片选择器
+     */
+    private void launchImageSelector() {
+        LogUtils.d(TAG, "launchImageSelector() 启动图片选择器");
+        Intent[] intents = createImageSelectorIntents();
+        Intent validIntent = findValidIntent(intents);
+
+        if (validIntent != null) {
+            launchImageChooser(validIntent);
+        } else {
+            showNoGalleryDialog();
+        }
+    }
+
+    /**
+     * 创建图片选择器意图数组
+     * @return 意图数组
+     */
+    private Intent[] createImageSelectorIntents() {
+        LogUtils.d(TAG, "createImageSelectorIntents() 开始创建");
+        Intent[] intents = new Intent[3];
+        // ACTION_GET_CONTENT
+        Intent getContentIntent = new Intent(Intent.ACTION_GET_CONTENT);
+        getContentIntent.setType("image/*");
+        getContentIntent.addCategory(Intent.CATEGORY_OPENABLE);
+        getContentIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+        intents[0] = getContentIntent;
+
+        // ACTION_PICK
+        Intent pickIntent = new Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
+        pickIntent.setType("image/*");
+        pickIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+        intents[1] = pickIntent;
+
+        // ACTION_OPEN_DOCUMENT（API19+）
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            Intent openDocIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
+            openDocIntent.setType("image/*");
+            openDocIntent.addCategory(Intent.CATEGORY_OPENABLE);
+            openDocIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
+            intents[2] = openDocIntent;
+        }
+        LogUtils.d(TAG, "createImageSelectorIntents() 意图数组创建完成");
+        return intents;
+    }
+
+    /**
+     * 查找有效的意图
+     * @param intents 意图数组
+     * @return 有效意图，无则返回null
+     */
+    private Intent findValidIntent(Intent[] intents) {
+        LogUtils.d(TAG, "findValidIntent() 开始查找");
+        for (Intent intent : intents) {
+            if (intent != null && intent.resolveActivity(getPackageManager()) != null) {
+                LogUtils.d(TAG, "findValidIntent() | 找到有效意图");
+                return intent;
+            }
+        }
+        LogUtils.d(TAG, "findValidIntent() | 无有效意图");
+        return null;
+    }
+
+    /**
+     * 启动图片选择器
+     * @param validIntent 有效意图
+     */
+    private void launchImageChooser(Intent validIntent) {
+        LogUtils.d(TAG, "launchImageChooser() 启动选择器");
+        Intent chooser = Intent.createChooser(validIntent, "选择图片");
+        chooser.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
+        startActivityForResult(chooser, REQUEST_SELECT_PICTURE);
+        LogUtils.d(TAG, "launchImageChooser() | 启动图片选择");
+    }
+
+    /**
+     * 显示无相册应用提示对话框
+     */
+    private void showNoGalleryDialog() {
+        LogUtils.d(TAG, "showNoGalleryDialog() | 无相册应用");
+        runOnUiThread(new Runnable() {
+				@Override
+				public void run() {
+					ToastUtils.show("未找到相册应用，请安装后重试");
+					new AlertDialog.Builder(BackgroundSettingsActivity.this)
+                        .setTitle("无图片选择应用")
+                        .setMessage("需要安装相册应用才能选择图片")
+                        .setPositiveButton("确定", new DialogInterface.OnClickListener() {
+                            @Override
+                            public void onClick(DialogInterface dialog, int which) {
+                                launchGalleryMarket();
+                            }
+                        })
+                        .setNegativeButton("取消", null)
+                        .show();
+				}
+			});
+    }
+
+    /**
+     * 启动应用商店下载相册
+     */
+    private void launchGalleryMarket() {
+        LogUtils.d(TAG, "launchGalleryMarket() 启动应用商店");
+        Intent marketIntent = new Intent(Intent.ACTION_VIEW);
+        marketIntent.setData(Uri.parse("market://details?id=com.android.gallery3d"));
+        if (marketIntent.resolveActivity(getPackageManager()) != null) {
+            startActivity(marketIntent);
+            LogUtils.d(TAG, "launchGalleryMarket() | 启动成功");
+        } else {
+            ToastUtils.show("无法打开应用商店");
+            LogUtils.e(TAG, "launchGalleryMarket() | 启动失败");
+        }
+    }
+
+    /**
+     * 处理操作取消或失败
+     */
+    private void handleOperationCancelOrFail() {
+        LogUtils.d(TAG, "handleOperationCancelOrFail() 操作取消或失败");
+        mBgSourceUtils.setCurrentSourceToPreview();
+        ToastUtils.show("操作取消或失败");
+        doubleRefreshPreview();
+    }
+
+    /**
+     * 处理拍照逻辑（权限通过后执行）
+     */
+    void handleTakePhoto() {
+        LogUtils.d(TAG, "handleTakePhoto() 开始处理拍照");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "handleTakePhoto() | 预览Bean为空");
+            ToastUtils.show("拍照文件创建失败");
+            return;
+        }
+
+        File takePhotoFile = new File(previewBean.getBackgroundFilePath());
+        if (!takePhotoFile.exists()) {
+            ToastUtils.show("拍照文件创建失败");
+            LogUtils.e(TAG, String.format("handleTakePhoto() | 文件不存在：%s", takePhotoFile.getAbsolutePath()));
+            return;
+        }
+
+        Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
+        try {
+            Uri photoUri = getFileProviderUri(takePhotoFile);
+            if (photoUri == null) {
+                throw new Exception("生成FileProvider Uri失败");
+            }
+            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri);
+            startActivityForResult(takePictureIntent, REQUEST_TAKE_PHOTO);
+            LogUtils.d(TAG, String.format("handleTakePhoto() | Uri：%s", photoUri.toString()));
+        } catch (Exception e) {
+            String errMsg = "拍照启动异常：" + e.getMessage();
+            ToastUtils.show(errMsg.substring(0, 20));
+            LogUtils.e(TAG, String.format("handleTakePhoto() | %s", e.getMessage()));
+        }
+    }
+
+    /**
+     * 处理ActivityResult分发
+     * @param requestCode 请求码
+     * @param data 回调数据
+     */
+    private void handleActivityResult(int requestCode, Intent data) {
+        LogUtils.d(TAG, String.format("handleActivityResult() | 处理请求码：%d", requestCode));
+        switch (requestCode) {
+            case REQUEST_SELECT_PICTURE:
+                handleSelectPictureResult(data);
+                break;
+            case REQUEST_TAKE_PHOTO:
+                handleTakePhotoResult(data);
+                break;
+            case REQUEST_CROP_IMAGE:
+                handleCropImageResult(data);
+                break;
+            case REQUEST_PIXELPICKER:
+                handlePixelPickerResult();
+                break;
+            default:
+                LogUtils.d(TAG, String.format("handleActivityResult() | 未知requestCode：%d", requestCode));
+                break;
+        }
+    }
+
+    /**
+     * 处理拍照结果
+     * @param data 回调数据
+     */
+    private void handleTakePhotoResult(Intent data) {
+        LogUtils.d(TAG, "handleTakePhotoResult() 处理拍照结果");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "handleTakePhotoResult() | 预览Bean为空");
+            return;
+        }
+
+        previewBean.setIsUseBackgroundFile(true);
+        previewBean.setIsUseBackgroundScaledCompressFile(false);
+        mBgSourceUtils.saveSettings();
+        doubleRefreshPreview();
+
+        startImageCrop(false);
+        LogUtils.d(TAG, "handleTakePhotoResult() | 已启动裁剪");
+    }
+
+    /**
+     * 处理选图结果
+     * @param data 回调数据
+     */
+    private void handleSelectPictureResult(Intent data) {
+        LogUtils.d(TAG, "handleSelectPictureResult() 处理选图结果");
+        Uri selectedImage = data.getData();
+        if (selectedImage == null) {
+            ToastUtils.show("图片Uri为空");
+            LogUtils.e(TAG, "handleSelectPictureResult() | Uri为空");
+            return;
+        }
+        LogUtils.d(TAG, String.format("handleSelectPictureResult() | 系统返回Uri : %s", selectedImage.toString()));
+
+        // 申请持久化权限（API33+）
+        if (Build.VERSION.SDK_INT >= SDK_VERSION_TIRAMISU) {
+            getContentResolver().takePersistableUriPermission(
+				selectedImage,
+				Intent.FLAG_GRANT_READ_URI_PERMISSION);
+            LogUtils.d(TAG, "handleSelectPictureResult() | 已添加持久化权限");
+        }
+
+        // 同步文件并启动裁剪
+        if (putUriFileToPreviewSource(selectedImage)) {
+            LogUtils.d(TAG, "handleSelectPictureResult() | 路径绑定完成");
+            startImageCrop(false);
+        } else {
+            ToastUtils.show("图片同步失败");
+            LogUtils.e(TAG, "handleSelectPictureResult() | 文件复制失败");
+        }
+    }
+
+    /**
+     * 将 Uri 文件同步到预览 Bean
+     * @param srcUriFile 源Uri
+     * @return 同步成功返回true，否则false
+     */
+    private boolean putUriFileToPreviewSource(Uri srcUriFile) {
+        LogUtils.d(TAG, String.format("putUriFileToPreviewSource() | 源Uri：%s", srcUriFile.toString()));
+        String filePath = UriUtils.getFilePathFromUri(this, srcUriFile);
+        if (TextUtils.isEmpty(filePath)) {
+            LogUtils.e(TAG, "putUriFileToPreviewSource() | Uri解析路径为空");
+            return false;
+        }
+        File srcFile = new File(filePath);
+        return putUriFileToPreviewSource(srcFile);
+    }
+
+    /**
+     * 将 File 同步到预览 Bean
+     * @param srcFile 源文件
+     * @return 同步成功返回true，否则false
+     */
+    private boolean putUriFileToPreviewSource(File srcFile) {
+        LogUtils.d(TAG, String.format("putUriFileToPreviewSource() | 源文件：%s", srcFile.getAbsolutePath()));
+        mBgSourceUtils.loadSettings();
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        File dstFile = new File(previewBean.getBackgroundFilePath());
+        LogUtils.d(TAG, String.format("putUriFileToPreviewSource() | 目标文件：%s", dstFile.getAbsolutePath()));
+        if (FileUtils.copyFile(srcFile, dstFile)) {
+            LogUtils.d(TAG, "putUriFileToPreviewSource() | 文件拷贝成功");
+            return true;
+        }
+        LogUtils.d(TAG, "putUriFileToPreviewSource() | 文件无法拷贝");
+        return false;
+    }
+
+    /**
+     * 处理裁剪结果
+     * @param data 回调数据
+     */
+    private void handleCropImageResult(Intent data) {
+        LogUtils.d(TAG, "handleCropImageResult() 处理裁剪结果");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "handleCropImageResult() | 预览Bean为空");
+            handleOperationCancelOrFail();
+            return;
+        }
+
+        File cropTempFile = new File(previewBean.getBackgroundScaledCompressFilePath());
+        boolean isFileExist = cropTempFile.exists();
+        boolean isFileReadable = isFileExist ? cropTempFile.canRead() : false;
+        long fileSize = isFileExist ? cropTempFile.length() : 0;
+        boolean isCropSuccess = isFileExist && isFileReadable && fileSize > 100;
+
+        if (isCropSuccess) {
+            handleCropSuccess(previewBean, fileSize);
+        } else {
+            handleCropFailure(isFileExist, isFileReadable, fileSize);
+        }
+    }
+
+    /**
+     * 处理裁剪成功
+     * @param previewBean 预览Bean
+     * @param fileSize 文件大小
+     */
+    private void handleCropSuccess(BackgroundBean previewBean, long fileSize) {
+        LogUtils.d(TAG, String.format("handleCropSuccess() | 裁剪成功，文件大小：%d", fileSize));
+        isPreviewBackgroundChanged = true;
+        previewBean.setIsUseBackgroundFile(true);
+        previewBean.setIsUseBackgroundScaledCompressFile(true);
+        mBgSourceUtils.saveSettings();
+        doubleRefreshPreview();
+    }
+
+    /**
+     * 处理裁剪失败
+     * @param isFileExist 文件是否存在
+     * @param isFileReadable 文件是否可读
+     * @param fileSize 文件大小
+     */
+    private void handleCropFailure(boolean isFileExist, boolean isFileReadable, long fileSize) {
+        LogUtils.e(TAG, String.format("handleCropFailure() | 裁剪失败，文件状态：存在=%b，可读=%b，大小=%d",
+									  isFileExist, isFileReadable, fileSize));
+        handleOperationCancelOrFail();
+    }
+
+    /**
+     * 处理像素拾取结果
+     */
+    private void handlePixelPickerResult() {
+        LogUtils.d(TAG, "handlePixelPickerResult() 处理像素拾取结果");
+        doubleRefreshPreview();
+        isPreviewBackgroundChanged = true;
+    }
+
+    /**
+     * 处理相机权限申请结果
+     * @param grantResults 权限结果数组
+     */
+    private void handleCameraPermissionResult(int[] grantResults) {
+        LogUtils.d(TAG, "handleCameraPermissionResult() 处理相机权限结果");
+        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+            LogUtils.d(TAG, "handleCameraPermissionResult() | 相机权限授予成功");
+            handleTakePhoto();
+        } else {
+            LogUtils.d(TAG, "handleCameraPermissionResult() | 相机权限授予失败");
+            ToastUtils.show("相机权限被拒绝，无法拍照");
+            // 引导用户到设置页面开启权限（用户选择不再询问时）
+            if (!ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
+                launchAppSettings();
+            }
+        }
+    }
+
+    /**
+     * 启动应用设置页面
+     */
+    private void launchAppSettings() {
+        LogUtils.d(TAG, "launchAppSettings() 启动应用设置页面");
+        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+        Uri uri = Uri.fromParts("package", getPackageName(), null);
+        intent.setData(uri);
+        startActivity(intent);
+        ToastUtils.show("请在设置中开启相机权限");
+    }
+
+    /**
+     * 处理Finish确认对话框
+     */
+    private void handleFinishConfirmation() {
+        LogUtils.d(TAG, "handleFinishConfirmation() 处理Finish确认");
+        if (isPreviewBackgroundChanged) {
+            YesNoAlertDialog.show(this, "背景更换问题", "是否确定背景图片设置？", new YesNoAlertDialog.OnDialogResultListener() {
+					@Override
+					public void onYes() {
+						mBgSourceUtils.commitPreviewSourceToCurrent();
+						isCommitSettings = true;
+						finish();
+						Intent mainIntent = new Intent(BackgroundSettingsActivity.this, MainActivity.class);
+						mainIntent.putExtra(MainActivity.EXTRA_ISRELOAD_BACKGROUNDVIEW, true);
+						startActivity(mainIntent);
+						LogUtils.d(TAG, "handleFinishConfirmation() | 确认设置，启动MainActivity并刷新背景");
+					}
+
+					@Override
+					public void onNo() {
+						isCommitSettings = true;
+						finish();
+						LogUtils.d(TAG, "handleFinishConfirmation() | 取消设置，关闭页面");
+					}
+				});
+        } else {
+            isCommitSettings = true;
+            finish();
+        }
+    }
+
+    /**
+     * 启动图片裁剪
+     * @param isFreeCrop 是否自由裁剪
+     */
+    private void startImageCrop(boolean isFreeCrop) {
+        LogUtils.d(TAG, String.format("startImageCrop() | 是否自由裁剪：%b", isFreeCrop));
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "startImageCrop() | 预览Bean为空");
+            ToastUtils.show("裁剪失败：无有效图片");
+            return;
+        }
+        int width = isFreeCrop ? 0 : mBackgroundView.getWidth();
+        int height = isFreeCrop ? 0 : mBackgroundView.getHeight();
+        ImageCropUtils.startImageCrop(BackgroundSettingsActivity.this,
+									  previewBean,
+									  width,
+									  height,
+									  isFreeCrop,
+									  REQUEST_CROP_IMAGE);
+        LogUtils.d(TAG, String.format("startImageCrop() | 目标尺寸：%dx%d", width, height));
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BatteryReportActivity.java

@@ -0,0 +1,598 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageManager;
+import android.os.Build;
+import android.os.Bundle;
+import android.provider.Settings;
+import android.text.Editable;
+import android.text.TextWatcher;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.EditText;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 电池报告页面，统计应用24小时运行时长与电池消耗情况
+ * 支持应用搜索、累计耗电计算、电池广播监听，适配 API30
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class BatteryReportActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量（按功能分类） =========================
+    public static final String TAG = "BatteryReportActivity";
+    private static final long ONE_DAY_MS = 24 * 3600 * 1000;   // 24小时毫秒数
+    private static final long ONE_MINUTE_MS = 60 * 1000;       // 1分钟毫秒数
+
+    // ======================== 成员变量（按依赖优先级+功能分类） =========================
+    // UI组件
+    private Toolbar mToolbar;
+    private RecyclerView rvBatteryReport;
+    private EditText etSearch;
+
+    // 数据与适配器
+    private BatteryReportAdapter adapter;
+    private List<AppBatteryModel> dataList = new ArrayList<>();
+    private List<AppBatteryModel> filteredList = new ArrayList<>();
+
+    // 电池相关
+    private BroadcastReceiver batteryReceiver;
+    private int batteryCapacity = 5400;                        // 电池容量（mAh）
+    private float lastBatteryPercent = 100.0f;                 // 上次电池百分比
+    private long lastCheckTime = System.currentTimeMillis();   // 上次检查时间戳
+
+    // 缓存相关
+    private Map<String, Long> appRunTimeCache = new HashMap<>();
+    private Map<String, String> packageToAppNameCache = new HashMap<>();
+    private PackageManager mPackageManager;
+
+    // ======================== 接口实现方法 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期方法（按执行顺序排列） =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_battery_report);
+        LogUtils.d(TAG, "【onCreate】BatteryReportActivity 初始化开始");
+
+        // 初始化UI组件
+        initView();
+        // 初始化PackageManager
+        mPackageManager = getPackageManager();
+        LogUtils.d(TAG, "【onCreate】基础组件初始化完成");
+
+        // 权限检查（Java7 传统条件判断）
+        if (!hasUsageStatsPermission(this)) {
+            Toast.makeText(this, "请进入设置-应用-权限-特殊访问权限-使用情况访问权限，开启本应用的权限", Toast.LENGTH_LONG).show();
+            startActivity(new Intent(Settings.ACTION_USAGE_ACCESS_SETTINGS));
+            LogUtils.w(TAG, "【onCreate】缺少使用情况访问权限，引导用户开启");
+            return;
+        }
+
+        // 初始化数据流程：加载应用→缓存名称→获取运行时长→计算初始累计耗电
+        loadAllAppPackage();
+        preCacheAllAppNames();
+        appRunTimeCache = getAppRunTime();
+        updateAppRunTimeToModel();
+        calculateInitial24hTotalConsumption();
+        filteredList.addAll(dataList);
+        LogUtils.d(TAG, "【onCreate】数据初始化完成，原始数据量：" + dataList.size());
+
+        // 初始化适配器
+        adapter = new BatteryReportAdapter(this, filteredList, mPackageManager, packageToAppNameCache);
+        rvBatteryReport.setAdapter(adapter);
+        LogUtils.d(TAG, "【onCreate】适配器初始化完成，过滤后数据量：" + filteredList.size());
+
+        // 绑定搜索监听 + 注册电池广播
+        bindSearchListener();
+        registerBatteryReceiver();
+
+        LogUtils.d(TAG, "【onCreate】BatteryReportActivity 初始化完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // Java7 显式非空判断
+        if (batteryReceiver != null) {
+            unregisterReceiver(batteryReceiver);
+            LogUtils.d(TAG, "【onDestroy】电池广播已注销");
+        }
+        LogUtils.d(TAG, "【onDestroy】BatteryReportActivity 销毁完成");
+    }
+
+    // ======================== UI初始化方法 =========================
+    private void initView() {
+        // 初始化Toolbar
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【导航栏】点击返回");
+					finish();
+				}
+			});
+
+        // 初始化RecyclerView与搜索框
+        etSearch = (EditText) findViewById(R.id.et_search);
+        rvBatteryReport = (RecyclerView) findViewById(R.id.rv_battery_report);
+        rvBatteryReport.setLayoutManager(new LinearLayoutManager(this));
+        LogUtils.d(TAG, "【initView】UI组件初始化完成");
+    }
+
+    // ======================== 搜索监听绑定方法 =========================
+    private void bindSearchListener() {
+        etSearch.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {
+					String keyword = s.toString().trim();
+					LogUtils.d(TAG, "【bindSearchListener】搜索关键词变化：" + keyword);
+					filterAppsByPackageAndName(keyword);
+				}
+
+				@Override
+				public void afterTextChanged(Editable s) {}
+			});
+        LogUtils.d(TAG, "【bindSearchListener】搜索监听绑定完成");
+    }
+
+    // ======================== 电池广播注册方法 =========================
+    private void registerBatteryReceiver() {
+        batteryReceiver = new BroadcastReceiver() {
+            @Override
+            public void onReceive(Context context, Intent intent) {
+                int level = intent.getIntExtra("level", 100);
+                int scale = intent.getIntExtra("scale", 100);
+                float currentPercent = (float) level / scale * 100;
+                LogUtils.d(TAG, "【电池广播】电池百分比变化：" + lastBatteryPercent + " -> " + currentPercent);
+
+                if (currentPercent < lastBatteryPercent) {
+                    float dropPercent = lastBatteryPercent - currentPercent;
+                    long duration = System.currentTimeMillis() - lastCheckTime;
+                    LogUtils.d(TAG, "【电池广播】电池消耗：" + dropPercent + "%，时长：" + formatRunTime(duration));
+
+                    // 更新运行时长并计算耗电
+                    appRunTimeCache = getAppRunTime();
+                    updateAppRunTimeToModel();
+                    calculateSingleConsumptionAndAccumulate(dropPercent, appRunTimeCache);
+                }
+
+                // 刷新记录
+                lastBatteryPercent = currentPercent;
+                lastCheckTime = System.currentTimeMillis();
+            }
+        };
+        registerReceiver(batteryReceiver, new IntentFilter(Intent.ACTION_BATTERY_CHANGED));
+        LogUtils.d(TAG, "【registerBatteryReceiver】电池广播注册完成");
+    }
+
+    // ======================== 权限检查方法 =========================
+    /**
+     * 检查是否拥有使用情况访问权限
+     * @param context 上下文
+     * @return 拥有权限返回true，否则返回false
+     */
+    private boolean hasUsageStatsPermission(Context context) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
+            LogUtils.w(TAG, "【hasUsageStatsPermission】系统版本低于LOLLIPOP，不支持使用情况访问权限");
+            return false;
+        }
+
+        android.app.usage.UsageStatsManager manager =
+			(android.app.usage.UsageStatsManager) context.getSystemService(Context.USAGE_STATS_SERVICE);
+        if (manager == null) {
+            LogUtils.e(TAG, "【hasUsageStatsPermission】获取UsageStatsManager失败");
+            return false;
+        }
+
+        long endTime = System.currentTimeMillis();
+        long startTime = endTime - ONE_MINUTE_MS;
+        List<android.app.usage.UsageStats> statsList = manager.queryUsageStats(
+			android.app.usage.UsageStatsManager.INTERVAL_DAILY, startTime, endTime);
+
+        boolean hasPermission = statsList != null && !statsList.isEmpty();
+        LogUtils.d(TAG, "【hasUsageStatsPermission】使用情况访问权限检查结果：" + hasPermission);
+        return hasPermission;
+    }
+
+    // ======================== 数据加载与缓存方法 =========================
+    /**
+     * 加载所有应用包名，初始化数据模型
+     */
+    private void loadAllAppPackage() {
+        List<ApplicationInfo> appList = mPackageManager.getInstalledApplications(PackageManager.GET_META_DATA);
+        dataList.clear();
+        LogUtils.d(TAG, "【loadAllAppPackage】开始加载应用包名列表，共找到" + appList.size() + "个应用");
+
+        for (ApplicationInfo appInfo : appList) {
+            String packageName = appInfo.packageName;
+            dataList.add(new AppBatteryModel(packageName, 0.0f, 0.0f, 0));
+        }
+        LogUtils.d(TAG, "【loadAllAppPackage】应用包名列表加载完成，共添加" + dataList.size() + "个包名");
+    }
+
+    /**
+     * 预缓存所有应用名称，减少PackageManager重复调用
+     */
+    private void preCacheAllAppNames() {
+        packageToAppNameCache.clear();
+        LogUtils.d(TAG, "【preCacheAllAppNames】开始预缓存包名-应用名称映射");
+
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            String appName = getAppNameByPackage(packageName);
+            packageToAppNameCache.put(packageName, appName);
+        }
+        LogUtils.d(TAG, "【preCacheAllAppNames】预缓存完成，共缓存" + packageToAppNameCache.size() + "个应用名称");
+    }
+
+    /**
+     * 通过包名获取应用名称，带异常处理
+     * @param packageName 应用包名
+     * @return 应用名称，获取失败返回包名
+     */
+    private String getAppNameByPackage(String packageName) {
+        LogUtils.v(TAG, "【getAppNameByPackage】查询包名：" + packageName);
+        try {
+            ApplicationInfo appInfo = mPackageManager.getApplicationInfo(packageName, 0);
+            return mPackageManager.getApplicationLabel(appInfo).toString();
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "【getAppNameByPackage】包名" + packageName + "对应的应用未找到：" + e.getMessage());
+            return packageName;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【getAppNameByPackage】查询应用名称失败（包名：" + packageName + "）：" + e.getMessage());
+            return packageName;
+        }
+    }
+
+    /**
+     * 更新运行时长到数据模型
+     */
+    private void updateAppRunTimeToModel() {
+        int updateCount = 0;
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long runTime = appRunTimeCache.containsKey(packageName) ? appRunTimeCache.get(packageName) : 0L;
+            model.setRunTime(runTime);
+            if (runTime > 0) {
+                updateCount++;
+            }
+        }
+        LogUtils.d(TAG, "【updateAppRunTimeToModel】更新完成，数据量：" + dataList.size() + "，更新运行时长应用数：" + updateCount);
+    }
+
+    /**
+     * 获取应用24小时运行时长
+     * @return 应用包名-运行时长（ms）映射
+     */
+    private Map<String, Long> getAppRunTime() {
+        Map<String, Long> runTimeMap = new HashMap<>();
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            try {
+                android.app.usage.UsageStatsManager manager =
+					(android.app.usage.UsageStatsManager) getSystemService(Context.USAGE_STATS_SERVICE);
+                long endTime = System.currentTimeMillis();
+                long startTime = endTime - ONE_DAY_MS; // 近24小时
+                List<android.app.usage.UsageStats> statsList = manager.queryUsageStats(
+					android.app.usage.UsageStatsManager.INTERVAL_DAILY, startTime, endTime);
+
+                for (android.app.usage.UsageStats stats : statsList) {
+                    long runTimeMs = stats.getTotalTimeInForeground();
+                    String packageName = stats.getPackageName();
+                    runTimeMap.put(packageName, runTimeMs);
+                    LogUtils.v(TAG, "【getAppRunTime】包名" + packageName + "24小时运行时长：" + formatRunTime(runTimeMs));
+                    if (packageName.equals("aidepro.top")) {
+                        LogUtils.d(TAG, "【getAppRunTime】特殊查询包名" + packageName + "有结果");
+                    }
+                }
+            } catch (Exception e) {
+                LogUtils.e(TAG, "【getAppRunTime】获取应用运行时长失败：" + e.getMessage());
+            }
+        }
+        LogUtils.d(TAG, "【getAppRunTime】应用运行时长列表数量：" + runTimeMap.size());
+        return runTimeMap;
+    }
+
+    // ======================== 核心计算方法 =========================
+    /**
+     * 初始化时计算24小时累计耗电（赋值给totalConsumption）
+     * 逻辑：基于24小时运行时长占比，分配当前电池容量的理论24小时消耗
+     */
+    private void calculateInitial24hTotalConsumption() {
+        long total24hRunTime = 0;
+        // 1. 计算24小时内所有应用总运行时长
+        for (Map.Entry<String, Long> entry : appRunTimeCache.entrySet()) {
+            total24hRunTime += entry.getValue();
+        }
+        LogUtils.d(TAG, "【calculateInitial24hTotalConsumption】24小时内所有应用总运行时长：" + formatRunTime(total24hRunTime));
+
+        // 2. 按运行时长占比分配24小时累计耗电
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long app24hRunTime = appRunTimeCache.getOrDefault(packageName, 0L);
+
+            float ratio = (total24hRunTime > 0) ? (float) app24hRunTime / total24hRunTime : 0;
+            float initialTotalConsumption = batteryCapacity * ratio;
+            model.setTotalConsumption(initialTotalConsumption);
+            LogUtils.v(TAG, "【calculateInitial24hTotalConsumption】应用包" + packageName + "24小时累计耗电初始化：" + initialTotalConsumption + " mAh");
+        }
+        LogUtils.d(TAG, "【calculateInitial24hTotalConsumption】24小时累计耗电初始化完成");
+    }
+
+    /**
+     * 计算单次耗电（赋值给consumption）+ 累加至累计耗电
+     * @param dropPercent 电池下降百分比
+     * @param runTimeMap  应用运行时长映射
+     */
+    private void calculateSingleConsumptionAndAccumulate(float dropPercent, Map<String, Long> runTimeMap) {
+        LogUtils.d(TAG, "【calculateSingleConsumptionAndAccumulate】开始计算，电池下降百分比：" + dropPercent);
+        long totalSingleRunTime = 0;
+        // 1. 计算本次电池下降期间的总运行时长
+        for (Map.Entry<String, Long> entry : runTimeMap.entrySet()) {
+            totalSingleRunTime += entry.getValue();
+        }
+        LogUtils.d(TAG, "【calculateSingleConsumptionAndAccumulate】本次电池下降总运行时长：" + formatRunTime(totalSingleRunTime));
+
+        // 2. 遍历计算每个应用的单次耗电并累加
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long appSingleRunTime = runTimeMap.getOrDefault(packageName, 0L);
+
+            float ratio = (totalSingleRunTime > 0) ? (float) appSingleRunTime / totalSingleRunTime : 0;
+            float singleConsumption = batteryCapacity * dropPercent / 100 * ratio;
+            model.setConsumption(singleConsumption);
+
+            // 累加至累计耗电
+            float newTotalConsumption = model.getTotalConsumption() + singleConsumption;
+            model.setTotalConsumption(newTotalConsumption);
+            model.setRunTime(appSingleRunTime);
+
+            LogUtils.v(TAG, String.format("【calculateSingleConsumptionAndAccumulate】应用包%s：单次耗电%.1f mAh，累计耗电%.1f mAh",
+										  packageName, singleConsumption, newTotalConsumption));
+        }
+
+        // 3. 按累计耗电降序排序
+        Collections.sort(dataList, new Comparator<AppBatteryModel>() {
+				@Override
+				public int compare(AppBatteryModel m1, AppBatteryModel m2) {
+					return Float.compare(m2.getTotalConsumption(), m1.getTotalConsumption());
+				}
+			});
+
+        // 4. 重新过滤并刷新列表
+        filterAppsByPackageAndName(etSearch.getText().toString().trim());
+        LogUtils.d(TAG, "【calculateSingleConsumptionAndAccumulate】单次耗电计算与累加完成，列表已刷新");
+    }
+
+    /**
+     * 双维度过滤（包名+应用名）
+     * @param keyword 搜索关键词
+     */
+    private void filterAppsByPackageAndName(String keyword) {
+        filteredList.clear();
+        if (keyword == null || keyword.isEmpty()) {
+            filteredList.addAll(dataList);
+            LogUtils.d(TAG, "【filterAppsByPackageAndName】搜索关键词为空，显示全部应用，数量：" + filteredList.size());
+        } else {
+            String lowerKeyword = keyword.toLowerCase();
+            for (AppBatteryModel model : dataList) {
+                String packageName = model.getPackageName();
+                String packageNameLower = packageName.toLowerCase();
+                String appName = packageToAppNameCache.get(packageName);
+                String appNameLower = appName.toLowerCase();
+
+                boolean isMatched = packageNameLower.contains(lowerKeyword) || appNameLower.contains(lowerKeyword);
+                if (isMatched) {
+                    filteredList.add(model);
+                }
+            }
+            LogUtils.d(TAG, "【filterAppsByPackageAndName】搜索关键词：" + keyword + "，匹配应用数量：" + filteredList.size());
+        }
+        adapter.notifyDataSetChanged();
+    }
+
+    // ======================== 工具方法 =========================
+    /**
+     * 格式化运行时长
+     * @param runTimeMs 运行时长（ms）
+     * @return 格式化后的运行时长字符串
+     */
+    private String formatRunTime(long runTimeMs) {
+        if (runTimeMs <= 0) {
+            return "0秒";
+        }
+        long seconds = runTimeMs / 1000;
+        long hours = seconds / 3600;
+        long minutes = (seconds % 3600) / 60;
+        seconds = seconds % 60;
+
+        if (hours > 0) {
+            return String.format("%d时%d分%d秒", hours, minutes, seconds);
+        } else if (minutes > 0) {
+            return String.format("%d分%d秒", minutes, seconds);
+        } else {
+            return String.format("%d秒", seconds);
+        }
+    }
+
+    // ======================== 内部类：数据模型 =========================
+    /**
+     * 应用电池数据模型
+     * - consumption：单次耗电（两次电池广播间的消耗）
+     * - totalConsumption：累计耗电（24小时初始化值+后续单次累加）
+     * - runTime：运行时长（ms）
+     */
+    public static class AppBatteryModel {
+        private String packageName;    // 应用包名（核心标识）
+        private float consumption;     // 单次耗电（mAh）
+        private float totalConsumption;// 累计耗电（mAh）
+        private long runTime;          // 运行时长（ms）
+
+        // Java7 显式构造
+        public AppBatteryModel(String packageName, float consumption, float totalConsumption, long runTime) {
+            this.packageName = packageName;
+            this.consumption = consumption;
+            this.totalConsumption = totalConsumption;
+            this.runTime = runTime;
+        }
+
+        // Getter/Setter
+        public String getPackageName() {
+            return packageName;
+        }
+
+        public float getConsumption() {
+            return consumption;
+        }
+
+        public void setConsumption(float consumption) {
+            this.consumption = consumption;
+        }
+
+        public float getTotalConsumption() {
+            return totalConsumption;
+        }
+
+        public void setTotalConsumption(float totalConsumption) {
+            this.totalConsumption = totalConsumption;
+        }
+
+        public long getRunTime() {
+            return runTime;
+        }
+
+        public void setRunTime(long runTime) {
+            this.runTime = runTime;
+        }
+    }
+
+    // ======================== 内部类：RecyclerView适配器 =========================
+    /**
+     * 电池报告列表适配器，显示应用名称、累计耗电、运行时长
+     */
+    public static class BatteryReportAdapter extends RecyclerView.Adapter<BatteryReportAdapter.ViewHolder> {
+        private Context mContext;
+        private List<AppBatteryModel> mDataList;
+        private PackageManager mPm;
+        private Map<String, String> mPackageToNameCache;
+
+        // Java7 显式构造
+        public BatteryReportAdapter(Context context, List<AppBatteryModel> dataList,
+                                    PackageManager pm, Map<String, String> packageToNameCache) {
+            this.mContext = context;
+            this.mDataList = dataList;
+            this.mPm = pm;
+            this.mPackageToNameCache = packageToNameCache;
+            LogUtils.d(TAG, "【BatteryReportAdapter】适配器构造完成，数据量：" + dataList.size());
+        }
+
+        @Override
+        public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+            View itemView = LayoutInflater.from(mContext)
+				.inflate(android.R.layout.simple_list_item_2, parent, false);
+            return new ViewHolder(itemView);
+        }
+
+        @Override
+        public void onBindViewHolder(ViewHolder holder, int position) {
+            // Java7 显式非空判断
+            if (mDataList == null || mDataList.isEmpty() || position >= mDataList.size()) {
+                holder.tvAppName.setText("未知应用");
+                holder.tvConsumption.setText("累计耗电：0.0 mAh | 运行时长：0秒");
+                LogUtils.w(TAG, "【onBindViewHolder】数据异常，位置：" + position);
+                return;
+            }
+
+            AppBatteryModel model = mDataList.get(position);
+            String packageName = model.getPackageName();
+            String appName = "";
+
+            // 优先从缓存获取应用名
+            if (mPackageToNameCache != null && mPackageToNameCache.containsKey(packageName)) {
+                appName = mPackageToNameCache.get(packageName);
+            } else {
+                // 缓存无数据时兜底查询
+                try {
+                    ApplicationInfo appInfo = mPm.getApplicationInfo(packageName, 0);
+                    appName = mPm.getApplicationLabel(appInfo).toString();
+                    if (mPackageToNameCache != null) {
+                        mPackageToNameCache.put(packageName, appName);
+                    }
+                } catch (PackageManager.NameNotFoundException e) {
+                    appName = packageName;
+                    LogUtils.e("BatteryReportAdapter", "【onBindViewHolder】包名" + packageName + "对应的应用未找到：" + e.getMessage());
+                } catch (Exception e) {
+                    appName = packageName;
+                    LogUtils.e("BatteryReportAdapter", "【onBindViewHolder】查询应用名称失败（包名：" + packageName + "）：" + e.getMessage());
+                }
+            }
+
+            // 显示逻辑：应用名称 + 累计耗电 + 运行时长
+            holder.tvAppName.setText(appName);
+            String runTimeStr = ((BatteryReportActivity) mContext).formatRunTime(model.getRunTime());
+            String totalConsumptionText = String.format("累计耗电：%.1f mAh | 运行时长：%s",
+														model.getTotalConsumption(), runTimeStr);
+            holder.tvConsumption.setText(totalConsumptionText);
+
+            // 显示优化
+            holder.tvAppName.setTextColor(mContext.getResources().getColor(android.R.color.black));
+            holder.tvConsumption.setTextColor(mContext.getResources().getColor(android.R.color.darker_gray));
+            holder.tvAppName.setTextSize(16);
+            holder.tvConsumption.setTextSize(14);
+        }
+
+        @Override
+        public int getItemCount() {
+            return mDataList == null ? 0 : mDataList.size();
+        }
+
+        /**
+         * ViewHolder：绑定系统布局控件
+         */
+        public static class ViewHolder extends RecyclerView.ViewHolder {
+            TextView tvAppName;     // 应用名称
+            TextView tvConsumption; // 累计耗电 + 运行时长
+
+            public ViewHolder(View itemView) {
+                super(itemView);
+                tvAppName = (TextView) itemView.findViewById(android.R.id.text1);
+                tvConsumption = (TextView) itemView.findViewById(android.R.id.text2);
+            }
+        }
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ClearRecordActivity.java

@@ -0,0 +1,166 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Switch;
+import android.widget.TextView;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BatteryInfoBean;
+import cc.winboll.studio.powerbell.receivers.ControlCenterServiceReceiver;
+import cc.winboll.studio.powerbell.utils.AppCacheUtils;
+import cc.winboll.studio.powerbell.utils.StringUtils;
+import java.util.ArrayList;
+
+/**
+ * 电池记录清理页面，支持滑动清理记录、切换记录显示格式
+ * 适配 API30，基于 Java7 开发
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class ClearRecordActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量（按功能分类） =========================
+    public static final String TAG = "ClearRecordActivity";
+    private static final String TOAST_MSG_CLEAR_SUCCESS = "The APP battery record is cleaned.";
+
+    // ======================== 成员变量（按依赖优先级+功能分类） =========================
+    // UI组件
+    private Toolbar mToolbar;
+    private TextView mtvRecordText;
+    private TextView tvAOHPCTCSeekBarMSG;
+    private AOHPCTCSeekBar aOHPCTCSeekBar;
+
+    // 应用与配置
+    private App mApplication;
+    private boolean mIsShowRecordWithEnter = false; // 记录是否带换行显示
+
+    // ======================== 接口实现方法 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期方法（按执行顺序排列） =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_clearrecord);
+        LogUtils.d(TAG, "【onCreate】ClearRecordActivity 初始化开始");
+
+        // 初始化应用实例
+        mApplication = (App) getApplication();
+        LogUtils.d(TAG, "【onCreate】应用实例初始化完成");
+
+        // 初始化核心逻辑
+        initView();
+        initSeekBar();
+        initRecordText();
+
+        LogUtils.d(TAG, "【onCreate】ClearRecordActivity 初始化完成");
+    }
+
+    // ======================== UI初始化方法 =========================
+    /**
+     * 初始化Toolbar与显示文本组件
+     */
+    private void initView() {
+        // 初始化Toolbar
+        mToolbar = (Toolbar) findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【导航栏】点击返回按钮，关闭当前页面");
+					finish();
+				}
+			});
+
+        // 初始化显示文本组件
+        tvAOHPCTCSeekBarMSG = (TextView) findViewById(R.id.activityclearrecordTextView1);
+        mtvRecordText = (TextView) findViewById(R.id.activityclearrecordTextView2);
+        tvAOHPCTCSeekBarMSG.setText(R.string.msg_AOHPCTCSeekBar_ClearRecord);
+
+        LogUtils.d(TAG, "【initView】UI组件初始化完成");
+    }
+
+    /**
+     * 初始化滑动清理控件，设置回调监听
+     */
+    private void initSeekBar() {
+        aOHPCTCSeekBar = (AOHPCTCSeekBar) findViewById(R.id.activityclearrecordAOHPCTCSeekBar1);
+        aOHPCTCSeekBar.setThumb(getDrawable(R.drawable.cursor_pointer));
+        aOHPCTCSeekBar.setThumbOffset(0);
+        aOHPCTCSeekBar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+				@Override
+				public void onOHPCommit() {
+					LogUtils.d(TAG, "【onOHPCommit】滑动清理触发，开始执行记录清理逻辑");
+					// 清理电池历史记录
+					mApplication.clearBatteryHistory();
+					// 发送广播更新前台通知
+					sendBroadcast(new Intent(ControlCenterServiceReceiver.ACTION_UPDATE_FOREGROUND_NOTIFICATION));
+					// 刷新记录显示
+					initRecordText();
+					// 提示清理成功
+					ToastUtils.show(TOAST_MSG_CLEAR_SUCCESS);
+					LogUtils.d(TAG, "【onOHPCommit】电池记录清理完成，已发送前台通知更新广播");
+				}
+			});
+
+        LogUtils.d(TAG, "【initSeekBar】滑动清理控件初始化完成，回调监听已绑定");
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 初始化记录显示文本，根据配置切换带换行/不带换行格式
+     */
+    void initRecordText() {
+        ArrayList<BatteryInfoBean> listBatteryInfo = AppCacheUtils.getInstance(this).getArrayListBatteryInfo();
+        String szRecordText;
+
+        // 判空处理：避免空列表导致异常
+        if (listBatteryInfo == null || listBatteryInfo.isEmpty()) {
+            szRecordText = getString(R.string.msg_no_battery_record);
+            LogUtils.d(TAG, "【initRecordText】无电池记录数据，显示空记录提示文本");
+        } else {
+            // 根据配置切换显示格式
+            if (mIsShowRecordWithEnter) {
+                szRecordText = StringUtils.formatPCMListStringWithEnter(listBatteryInfo);
+                LogUtils.d(TAG, String.format("【initRecordText】使用带换行格式显示记录，记录数量：%d", listBatteryInfo.size()));
+            } else {
+                szRecordText = StringUtils.formatPCMListString(listBatteryInfo);
+                LogUtils.d(TAG, String.format("【initRecordText】使用无换行格式显示记录，记录数量：%d", listBatteryInfo.size()));
+            }
+        }
+
+        mtvRecordText.setText(szRecordText);
+        LogUtils.d(TAG, "【initRecordText】记录显示文本刷新完成");
+    }
+
+    // ======================== 事件回调方法 =========================
+    /**
+     * 切换记录显示格式（带换行/不带换行）
+     * @param view 触发事件的Switch控件
+     */
+    public void onShowRecordWithEnter(View view) {
+        Switch swShowRecordWithEnter = (Switch) view;
+        mIsShowRecordWithEnter = swShowRecordWithEnter.isChecked();
+        LogUtils.d(TAG, String.format("【onShowRecordWithEnter】记录显示格式切换，带换行显示：%b", mIsShowRecordWithEnter));
+        // 刷新记录显示
+        initRecordText();
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/activities/PixelPickerActivity.java

@@ -0,0 +1,346 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.app.Dialog;
+import android.content.Intent;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.Color;
+import android.os.Bundle;
+import android.view.MenuItem;
+import android.view.MotionEvent;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.ImageView;
+import android.widget.RelativeLayout;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.AToolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+
+/**
+ * 像素拾取页面，支持加载图片并拾取指定位置像素颜色，同步至背景配置
+ * 适配 API30，基于 Java7 开发
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/22 14:15
+ */
+public class PixelPickerActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "PixelPickerActivity";
+    public static final String EXTRA_IMAGE_PATH = "imagePath"; // 图片路径传递键
+    // 提示文本常量
+    private static final String MSG_IMAGE_LOADED = "图片已加载，点击获取像素值";
+    private static final String MSG_NO_IMAGE_PATH = "未找到图片路径";
+    private static final String MSG_IMAGE_LOAD_FAILED = "图片加载失败";
+    private static final String MSG_FILE_NOT_EXIST = "图片文件不存在";
+    private static final String MSG_FILE_NOT_FOUND = "图片文件未找到";
+    private static final String MSG_PIXEL_OUT_OF_RANGE = "像素坐标超出范围";
+    private static final String MSG_TOUCH_OUT_OF_IMAGE = "点击位置超出图片显示范围";
+    private static final String MSG_PIXEL_CALC_FAILED = "计算像素位置失败";
+    private static final String MSG_PIXEL_RECORDED = "已记录像素值";
+
+    // ======================== 成员变量 =========================
+    // UI组件
+    private Toolbar mToolbar;
+    private ImageView imageView;
+    private TextView infoText;
+    private ViewGroup imageContainer;
+    private RelativeLayout mainLayout;
+    // 图片与像素数据
+    private Bitmap originalBitmap; // 原始图片Bitmap（用于像素拾取）
+
+    // ======================== 接口实现方法 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_pixelpicker);
+        LogUtils.d(TAG, "【onCreate】PixelPickerActivity 初始化开始");
+
+        // 初始化UI组件
+        initView();
+        // 初始化工具栏
+        initToolbar();
+        // 加载传递的图片
+        loadImageFromIntent();
+        // 绑定图片触摸事件
+        bindImageTouchListener();
+
+        LogUtils.d(TAG, "【onCreate】PixelPickerActivity 初始化完成");
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "【onResume】PixelPickerActivity 恢复显示");
+        // 同步背景颜色
+        setBackgroundColor();
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // 回收Bitmap资源，避免内存泄漏
+        if (originalBitmap != null && !originalBitmap.isRecycled()) {
+            originalBitmap.recycle();
+            originalBitmap = null;
+            LogUtils.d(TAG, "【onDestroy】原始图片Bitmap资源已回收");
+        }
+        LogUtils.d(TAG, "【onDestroy】PixelPickerActivity 销毁完成");
+    }
+
+    // ======================== UI初始化方法 =========================
+    /**
+     * 初始化所有UI组件
+     */
+    private void initView() {
+        imageView = findViewById(R.id.imageView);
+        infoText = findViewById(R.id.infoText);
+        imageContainer = findViewById(R.id.imageContainer);
+        mainLayout = findViewById(R.id.activitypixelpickerRelativeLayout1);
+
+        LogUtils.d(TAG, "【initView】UI组件初始化完成");
+    }
+
+    /**
+     * 初始化工具栏，设置导航与标题
+     */
+    private void initToolbar() {
+		LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 从Intent中获取图片路径并加载图片
+     */
+    private void loadImageFromIntent() {
+        String imagePath = getIntent().getStringExtra(EXTRA_IMAGE_PATH);
+        LogUtils.d(TAG, "【loadImageFromIntent】获取到图片路径：" + imagePath);
+
+        if (imagePath != null) {
+            loadImage(imagePath);
+        } else {
+            infoText.setText(MSG_NO_IMAGE_PATH);
+            LogUtils.w(TAG, "【loadImageFromIntent】未获取到图片路径");
+        }
+    }
+
+    /**
+     * 加载指定路径的图片
+     * @param imagePath 图片文件路径
+     */
+    private void loadImage(String imagePath) {
+        try {
+            File file = new File(imagePath);
+            if (file.exists()) {
+                // 解码图片（加载原图）
+                BitmapFactory.Options options = new BitmapFactory.Options();
+                options.inSampleSize = 1;
+                originalBitmap = BitmapFactory.decodeStream(new FileInputStream(file), null, options);
+
+                if (originalBitmap != null) {
+                    imageView.setImageBitmap(originalBitmap);
+                    infoText.setText(MSG_IMAGE_LOADED);
+                    LogUtils.d(TAG, "【loadImage】图片加载成功，尺寸：" + originalBitmap.getWidth() + "x" + originalBitmap.getHeight());
+                } else {
+                    infoText.setText(MSG_IMAGE_LOAD_FAILED);
+                    LogUtils.e(TAG, "【loadImage】图片解码失败");
+                }
+            } else {
+                infoText.setText(MSG_FILE_NOT_EXIST);
+                LogUtils.w(TAG, "【loadImage】图片文件不存在：" + imagePath);
+            }
+        } catch (FileNotFoundException e) {
+            e.printStackTrace();
+            infoText.setText(MSG_FILE_NOT_FOUND);
+            LogUtils.e(TAG, "【loadImage】图片文件未找到：" + e.getMessage());
+        }
+    }
+
+    /**
+     * 显示像素颜色信息对话框
+     * @param pixelColor 拾取的像素颜色（ARGB）
+     * @param x 像素X坐标
+     * @param y 像素Y坐标
+     */
+    private void showPixelDialog(final int pixelColor, int x, int y) {
+        final Dialog dialog = new Dialog(this);
+        dialog.setContentView(R.layout.dialog_pixel);
+        dialog.setCancelable(true);
+
+        // 设置颜色预览与信息展示
+        TextView colorView = dialog.findViewById(R.id.pixelColorView);
+        TextView infoTextView = dialog.findViewById(R.id.colorInfoText);
+        colorView.setBackgroundColor(pixelColor);
+
+        String colorInfo = String.format(
+			"RGB: (%d, %d, %d)\n" +
+			"ARGB: #%08X\n" +
+			"实际像素位置: (%d, %d)",
+			Color.red(pixelColor),
+			Color.green(pixelColor),
+			Color.blue(pixelColor),
+			pixelColor,
+			x, y);
+        infoTextView.setText(colorInfo);
+        LogUtils.d(TAG, "【showPixelDialog】显示像素信息：" + colorInfo);
+
+        // 确定按钮点击事件
+        Button confirmButton = dialog.findViewById(R.id.confirmButton);
+        confirmButton.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					dialog.dismiss();
+					// 保存像素颜色到背景配置
+					savePixelColor(pixelColor);
+					Toast.makeText(PixelPickerActivity.this, MSG_PIXEL_RECORDED, Toast.LENGTH_SHORT).show();
+					// 同步背景颜色
+					setBackgroundColor();
+				}
+			});
+
+        dialog.show();
+        LogUtils.d(TAG, "【showPixelDialog】像素对话框已显示");
+    }
+
+    /**
+     * 保存拾取的像素颜色到背景配置
+     * @param pixelColor 拾取的像素颜色（ARGB）
+     */
+    private void savePixelColor(int pixelColor) {
+        BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(this);
+        BackgroundBean bean = utils.getPreviewBackgroundBean();
+        bean.setPixelColor(pixelColor);
+        utils.saveSettings();
+        LogUtils.d(TAG, "【savePixelColor】像素颜色已保存：#" + Integer.toHexString(pixelColor));
+    }
+
+    /**
+     * 同步背景颜色为拾取的像素颜色
+     */
+    void setBackgroundColor() {
+        BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(this);
+        BackgroundBean bean = utils.getPreviewBackgroundBean();
+        int pixelColor = bean.getPixelColor();
+        mainLayout.setBackgroundColor(pixelColor);
+        LogUtils.d(TAG, "【setBackgroundColor】背景颜色已同步：#" + Integer.toHexString(pixelColor));
+    }
+
+    // ======================== 事件回调方法 =========================
+    /**
+     * 绑定图片容器的触摸事件，处理像素拾取逻辑
+     */
+    private void bindImageTouchListener() {
+        imageContainer.setOnTouchListener(new View.OnTouchListener() {
+				@Override
+				public boolean onTouch(View v, MotionEvent event) {
+					if (event.getAction() == MotionEvent.ACTION_DOWN && originalBitmap != null) {
+						float touchX = event.getX();
+						float touchY = event.getY();
+						LogUtils.v(TAG, "【onTouch】触摸坐标：(" + touchX + ", " + touchY + ")");
+
+						try {
+							// 获取图片在窗口中的位置与尺寸
+							int[] imageLocation = new int[2];
+							imageView.getLocationInWindow(imageLocation);
+							int imageWidth = imageView.getWidth();
+							int imageHeight = imageView.getHeight();
+							LogUtils.v(TAG, "【onTouch】图片显示尺寸：" + imageWidth + "x" + imageHeight + "，位置：(" + imageLocation[0] + ", " + imageLocation[1] + ")");
+
+							// 计算缩放比例
+							float scaleX = (float) originalBitmap.getWidth() / imageWidth;
+							float scaleY = (float) originalBitmap.getHeight() / imageHeight;
+							LogUtils.v(TAG, "【onTouch】图片缩放比例：X=" + scaleX + "，Y=" + scaleY);
+
+							// 调整触摸坐标到图片显示区域坐标系
+							float adjustedX = touchX - imageLocation[0];
+							float adjustedY = touchY - imageLocation[1];
+							LogUtils.v(TAG, "【onTouch】调整后触摸坐标：(" + adjustedX + ", " + adjustedY + ")");
+
+							// 检查是否在图片显示范围内
+							if (adjustedX >= 0 && adjustedX <= imageWidth && adjustedY >= 0 && adjustedY <= imageHeight) {
+								// 计算原始图片的像素坐标
+								int pixelX = (int) (adjustedX * scaleX);
+								int pixelY = (int) (adjustedY * scaleY);
+								LogUtils.v(TAG, "【onTouch】计算后像素坐标：(" + pixelX + ", " + pixelY + ")");
+
+								// 检查像素坐标是否在原始图片范围内
+								if (pixelX >= 0 && pixelX < originalBitmap.getWidth() && pixelY >= 0 && pixelY < originalBitmap.getHeight()) {
+									int pixelColor = originalBitmap.getPixel(pixelX, pixelY);
+									showPixelDialog(pixelColor, pixelX, pixelY);
+								} else {
+									Toast.makeText(PixelPickerActivity.this, MSG_PIXEL_OUT_OF_RANGE, Toast.LENGTH_SHORT).show();
+									LogUtils.w(TAG, "【onTouch】像素坐标超出原始图片范围");
+								}
+							} else {
+								Toast.makeText(PixelPickerActivity.this, MSG_TOUCH_OUT_OF_IMAGE, Toast.LENGTH_SHORT).show();
+								LogUtils.w(TAG, "【onTouch】触摸位置超出图片显示范围");
+							}
+						} catch (Exception e) {
+							e.printStackTrace();
+							Toast.makeText(PixelPickerActivity.this, MSG_PIXEL_CALC_FAILED, Toast.LENGTH_SHORT).show();
+							LogUtils.e(TAG, "【onTouch】计算像素位置失败：" + e.getMessage());
+						}
+					}
+					return true;
+				}
+			});
+        LogUtils.d(TAG, "【bindImageTouchListener】图片触摸事件已绑定");
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (item.getItemId() == android.R.id.home) {
+            LogUtils.d(TAG, "【onOptionsItemSelected】点击返回菜单");
+            Intent intent = new Intent(this, BackgroundSettingsActivity.class);
+            startActivity(intent);
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    @Override
+    public void onBackPressed() {
+        super.onBackPressed();
+        setResult(RESULT_OK);
+        finish();
+        LogUtils.d(TAG, "【onBackPressed】返回键触发，页面关闭");
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/activities/SettingsActivity.java

@@ -0,0 +1,184 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+import android.provider.Settings;
+import android.view.View;
+import android.view.WindowManager;
+import android.widget.CheckBox;
+import android.widget.Toast;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.ThoughtfulServiceBean;
+import java.lang.reflect.Field;
+
+/**
+ * 应用设置窗口，提供应用配置项的统一入口
+ * 适配 API30，基于 Java7 开发
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 14:26
+ * @Describe 应用设置窗口
+ */
+public class SettingsActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "SettingsActivity";
+    // 权限请求常量（为后续读取媒体图片权限预留）
+    private static final int REQUEST_READ_MEDIA_IMAGES = 1001;
+
+    // ======================== 成员变量 =========================
+    private Toolbar mToolbar; // 顶部工具栏
+
+    // ======================== 接口实现方法 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_settings);
+        LogUtils.d(TAG, "【onCreate】SettingsActivity 初始化开始");
+
+        // 初始化工具栏
+        initToolbar();
+		
+		ThoughtfulServiceBean thoughtfulServiceBean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+		if (thoughtfulServiceBean == null) {
+			thoughtfulServiceBean = new ThoughtfulServiceBean();
+		}
+		((CheckBox)findViewById(R.id.activitysettingsCheckBox1)).setChecked(thoughtfulServiceBean.isEnableUsePowerTts());
+		((CheckBox)findViewById(R.id.activitysettingsCheckBox2)).setChecked(thoughtfulServiceBean.isEnableChargeTts());
+
+        LogUtils.d(TAG, "【onCreate】SettingsActivity 初始化完成");
+    }
+
+    // ======================== UI初始化方法 =========================
+    /**
+     * 初始化顶部工具栏，设置导航返回与样式
+     */
+    private void initToolbar() {
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        // 设置工具栏副标题与标题样式
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        // 显示返回按钮
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        // 绑定导航点击事件
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【导航栏】点击返回");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "【initToolbar】工具栏初始化完成");
+    }
+
+	public void onCheckTTSDrawOverlaysPermission(View view) {
+		canDrawOverlays();
+	}
+
+	public void onEnableChargeTts(View view) {
+		ThoughtfulServiceBean thoughtfulServiceBean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+		if (thoughtfulServiceBean == null) {
+			thoughtfulServiceBean = new ThoughtfulServiceBean();
+		}
+		thoughtfulServiceBean.setIsEnableChargeTts(((CheckBox)view).isChecked());
+		ThoughtfulServiceBean.saveBean(this, thoughtfulServiceBean);
+	}
+
+	public void onEnableUsePowerTts(View view) {
+		ThoughtfulServiceBean thoughtfulServiceBean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+		if (thoughtfulServiceBean == null) {
+			thoughtfulServiceBean = new ThoughtfulServiceBean();
+		}
+		thoughtfulServiceBean.setIsEnableUsePowerTts(((CheckBox)view).isChecked());
+		ThoughtfulServiceBean.saveBean(this, thoughtfulServiceBean);
+	}
+
+	/**
+     * 悬浮窗权限检查与请求
+     */
+	void canDrawOverlays() {
+        LogUtils.d(TAG, "onCanDrawOverlays: 检查悬浮窗权限");
+        // API6.0+校验权限
+        if (Build.VERSION.SDK_INT >= 23 && !Settings.canDrawOverlays(this)) {
+            LogUtils.d(TAG, "onCanDrawOverlays: 未开启悬浮窗权限，发起请求");
+            showDrawOverlayRequestDialog();
+        } else {
+            ToastUtils.show("悬浮窗权限已开启");
+        }
+    }
+
+
+    /**
+     * 显示悬浮窗权限请求对话框
+     */
+    private void showDrawOverlayRequestDialog() {
+        AlertDialog dialog = new AlertDialog.Builder(this)
+			.setTitle("权限请求")
+			.setMessage("为保证通话监听功能正常，需开启悬浮窗权限")
+			.setPositiveButton("去设置", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+					jumpToDrawOverlaySettings();
+				}
+			})
+			.setNegativeButton("稍后", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+				}
+			})
+			.create();
+
+        // 解决对话框焦点问题
+        if (dialog.getWindow() != null) {
+            dialog.getWindow().setFlags(
+				WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
+				WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE);
+        }
+        dialog.show();
+    }
+
+    /**
+     * 跳转悬浮窗权限设置页面（反射适配低版本）
+     */
+    private void jumpToDrawOverlaySettings() {
+        LogUtils.d(TAG, "jumpToDrawOverlaySettings: 跳转悬浮窗权限设置");
+        try {
+            // 反射获取设置页面Action（避免高版本API依赖）
+            Class<?> settingsClazz = Settings.class;
+            Field actionField = settingsClazz.getDeclaredField("ACTION_MANAGE_OVERLAY_PERMISSION");
+            String action = (String) actionField.get(null);
+
+            // 跳转当前应用权限设置页
+            Intent intent = new Intent(action);
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.setData(Uri.parse("package:" + getPackageName()));
+            startActivity(intent);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "jumpToDrawOverlaySettings: 跳转权限设置失败", e);
+            Toast.makeText(this, "请手动在设置中开启悬浮窗权限", Toast.LENGTH_LONG).show();
+        }
+    }
+
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ShortcutActionActivity.java

@@ -0,0 +1,75 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.utils.APPPlusUtils;
+
+/**
+ * 应用快捷方式活动类，处理应用图标快捷菜单的切换请求
+ * 适配 API30，基于 Java7 开发
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/15 13:45
+ * @Describe 应用快捷方式活动类
+ */
+public class ShortcutActionActivity extends Activity {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "ShortcutActionActivity";
+    // 快捷指令常量
+    private static final String ACTION_SWITCH_TO_EN1 = "switchto_en1";
+    private static final String ACTION_SWITCH_TO_CN1 = "switchto_cn1";
+    private static final String ACTION_SWITCH_TO_CN2 = "switchto_cn2";
+
+    // ======================== 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "【onCreate】ShortcutActionActivity 启动，开始处理快捷方式请求");
+
+        // 处理应用图标快捷菜单的切换请求
+        handleSwitchRequest();
+
+        LogUtils.d(TAG, "【onCreate】快捷方式请求处理完成，关闭活动");
+        finish();
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 处理应用图标快捷菜单的请求，根据意图数据切换应用启动组件
+     */
+    private void handleSwitchRequest() {
+        Intent intent = getIntent();
+        if (intent == null) {
+            LogUtils.w(TAG, "【handleSwitchRequest】意图为空，无法处理快捷方式请求");
+            return;
+        }
+
+        String dataString = intent.getDataString();
+        LogUtils.d(TAG, "【handleSwitchRequest】获取到快捷指令：" + dataString);
+
+        // 匹配快捷指令并切换组件
+        if (ACTION_SWITCH_TO_EN1.equals(dataString)) {
+            APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_EN1);
+            String toastMsg = "切换至" + getString(R.string.app_name) + "图标";
+            ToastUtils.show(toastMsg);
+            LogUtils.d(TAG, "【handleSwitchRequest】已切换至EN1组件：" + App.COMPONENT_EN1);
+        } else if (ACTION_SWITCH_TO_CN1.equals(dataString)) {
+            APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN1);
+            String toastMsg = "切换至" + getString(R.string.app_name_cn1) + "图标";
+            ToastUtils.show(toastMsg);
+            LogUtils.d(TAG, "【handleSwitchRequest】已切换至CN1组件：" + App.COMPONENT_CN1);
+        } else if (ACTION_SWITCH_TO_CN2.equals(dataString)) {
+            APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN2);
+            String toastMsg = "切换至" + getString(R.string.app_name_cn2) + "图标";
+            ToastUtils.show(toastMsg);
+            LogUtils.d(TAG, "【handleSwitchRequest】已切换至CN2组件：" + App.COMPONENT_CN2);
+        } else {
+            LogUtils.w(TAG, "【handleSwitchRequest】未匹配到有效快捷指令：" + dataString);
+        }
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/activities/WinBoLLActivity.java

@@ -0,0 +1,215 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.annotation.SuppressLint;
+import android.app.Activity;
+import android.graphics.Color;
+import android.os.Bundle;
+import android.util.TypedValue;
+import android.view.Gravity;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.FrameLayout;
+import android.widget.TextView;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.BuildConfig;
+import cc.winboll.studio.powerbell.R;
+
+/** 
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/19 20:35
+ * @Describe 应用窗口基类，提供主题设置、Activity 管理、工具栏配置、全屏切换、版本标签显示等通用功能
+ * 适配 API30，基于 Java7 开发，所有子类需继承此类实现统一窗口行为
+ */
+public abstract class WinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "WinBoLLActivity";
+    private static final String VERSION_TAG_TEXT = "MIMO SDK V%s"; // 版本标签文本格式
+    private static final float VERSION_TAG_TEXT_SIZE = 10f; // 版本标签字体大小（sp）
+
+    // ======================== 成员变量 =========================
+    protected volatile AESThemeBean.ThemeType mThemeType; // 当前主题类型
+    protected TextView mTagView; // 版本标签显示控件
+
+    // ======================== 接口实现 & 抽象方法 =========================
+    @Override
+    public abstract Activity getActivity();
+
+    @Override
+    public abstract String getTag();
+
+    // ======================== 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        LogUtils.d(TAG, String.format("【%s-onCreate】窗口基类初始化开始", getTag()));
+        // 初始化主题
+        mThemeType = getThemeType();
+        setThemeStyle();
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, String.format("【%s-onCreate】窗口基类初始化完成，当前主题：%s", getTag(), mThemeType));
+    }
+
+    @Override
+    protected void onStart() {
+        super.onStart();
+        LogUtils.d(TAG, String.format("【%s-onStart】添加版本标签到页面", getTag()));
+        // 添加版本标签
+        addVersionNameToContentView();
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        // 注册到Activity管理器
+        WinBoLLActivityManager.getInstance().add(this);
+        LogUtils.d(TAG, String.format("【%s-onPostCreate】已注册到Activity管理器", getTag()));
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // 从Activity管理器移除
+        WinBoLLActivityManager.getInstance().registeRemove(this);
+        LogUtils.d(TAG, String.format("【%s-onDestroy】已从Activity管理器移除", getTag()));
+    }
+
+    // ======================== 主题相关方法 =========================
+    /**
+     * 获取当前主题类型
+     * @return 主题类型枚举
+     */
+    AESThemeBean.ThemeType getThemeType() {
+        int themeId = AESThemeUtil.getThemeTypeID(getApplicationContext());
+        AESThemeBean.ThemeType themeType = AESThemeBean.getThemeStyleType(themeId);
+        LogUtils.d(TAG, String.format("【%s-getThemeType】获取主题类型，ID：%d，类型：%s", getTag(), themeId, themeType));
+        return themeType;
+    }
+
+    /**
+     * 设置主题样式
+     */
+    void setThemeStyle() {
+        int themeId = AESThemeUtil.getThemeTypeID(getApplicationContext());
+        setTheme(themeId);
+        LogUtils.d(TAG, String.format("【%s-setThemeStyle】应用主题样式，ID：%d", getTag(), themeId));
+    }
+
+    // ======================== UI 配置方法 =========================
+    /**
+     * 添加版本标签到页面底部
+     */
+    protected void addVersionNameToContentView() {
+        if (!isTagViewVisible()) {
+            LogUtils.d(TAG, String.format("【%s-addVersionNameToContentView】版本标签不可见，跳过添加", getTag()));
+            return;
+        }
+
+        if (mTagView == null) {
+            mTagView = new TextView(this);
+            // 配置版本标签样式
+            mTagView.setTextColor(Color.GRAY);
+            mTagView.setTextSize(TypedValue.COMPLEX_UNIT_SP, VERSION_TAG_TEXT_SIZE);
+            mTagView.setText(String.format(VERSION_TAG_TEXT, BuildConfig.VERSION_NAME));
+            // 配置布局参数
+            FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(
+				ViewGroup.LayoutParams.WRAP_CONTENT,
+				ViewGroup.LayoutParams.WRAP_CONTENT);
+            params.gravity = Gravity.BOTTOM | Gravity.CENTER_HORIZONTAL;
+            // 添加到根布局
+            FrameLayout frameLayout = findViewById(android.R.id.content);
+            if (frameLayout != null) {
+                frameLayout.addView(mTagView, params);
+                LogUtils.d(TAG, String.format("【%s-addVersionNameToContentView】版本标签添加完成，版本：%s", getTag(), BuildConfig.VERSION_NAME));
+            } else {
+                LogUtils.w(TAG, String.format("【%s-addVersionNameToContentView】根布局为空，无法添加版本标签", getTag()));
+            }
+        }
+    }
+
+    /**
+     * 配置工具栏，显示返回按钮
+     */
+    public void setupToolbar() {
+        Toolbar mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar != null) {
+            setSupportActionBar(mToolbar);
+            if (getSupportActionBar() != null) {
+                getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+                LogUtils.d(TAG, String.format("【%s-setupToolbar】工具栏配置完成，已显示返回按钮", getTag()));
+            } else {
+                LogUtils.w(TAG, String.format("【%s-setupToolbar】ActionBar为空，无法显示返回按钮", getTag()));
+            }
+        } else {
+            LogUtils.w(TAG, String.format("【%s-setupToolbar】未找到工具栏控件（ID：toolbar）", getTag()));
+        }
+    }
+
+    /**
+     * 版本标签是否可见
+     * @return 默认为true，子类可重写修改
+     */
+    protected boolean isTagViewVisible() {
+        return true;
+    }
+
+    // ======================== 菜单 & 返回键处理 =========================
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (item.getItemId() == android.R.id.home) {
+            LogUtils.d(TAG, String.format("【%s-onOptionsItemSelected】点击返回菜单", getTag()));
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    @Override
+    public void onBackPressed() {
+        super.onBackPressed();
+        LogUtils.d(TAG, String.format("【%s-onBackPressed】触发返回键", getTag()));
+    }
+
+    // ======================== 工具方法 =========================
+    /**
+     * 切换至全屏模式，隐藏状态栏与导航栏
+     * @param activity 目标Activity
+     */
+    public void changeFullScreen(Activity activity) {
+        if (activity == null) {
+            LogUtils.w(TAG, String.format("【%s-changeFullScreen】目标Activity为空，无法切换全屏", getTag()));
+            return;
+        }
+
+        Window window = activity.getWindow();
+        if (window == null) {
+            LogUtils.w(TAG, String.format("【%s-changeFullScreen】窗口为空，无法切换全屏", getTag()));
+            return;
+        }
+
+        View decorView = window.getDecorView();
+        if (decorView == null) {
+            LogUtils.w(TAG, String.format("【%s-changeFullScreen】DecorView为空，无法切换全屏", getTag()));
+            return;
+        }
+
+        // 配置全屏标志位
+        int flag = decorView.getSystemUiVisibility();
+        flag |= View.SYSTEM_UI_FLAG_FULLSCREEN;
+        flag |= View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
+        flag |= View.SYSTEM_UI_FLAG_HIDE_NAVIGATION;
+        flag |= View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION;
+        flag |= View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;
+        decorView.setSystemUiVisibility(flag);
+        // 配置窗口标志位
+        window.setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN);
+        LogUtils.d(TAG, String.format("【%s-changeFullScreen】已切换至全屏模式", getTag()));
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/adapters/BatteryAdapter.java

@@ -0,0 +1,107 @@
+package cc.winboll.studio.powerbell.adapters;
+
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.TextView;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BatteryData;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 电池报告数据适配器，用于RecyclerView展示电池电量、充放电时间数据
+ * 适配 API30，基于 Java7 开发
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/22 14:38:55
+ * @Describe 电池报告数据适配器
+ */
+public class BatteryAdapter extends RecyclerView.Adapter<BatteryAdapter.ViewHolder> {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "BatteryAdapter";
+    private static final String FORMAT_BATTERY_LEVEL = "%d%%"; // 电量显示格式
+    private static final String PREFIX_DISCHARGE_TIME = "使用时间: "; // 放电时间前缀
+    private static final String PREFIX_CHARGE_TIME = "充电时间: "; // 充电时间前缀
+
+    // ======================== 成员变量 =========================
+    private List<BatteryData> dataList = new ArrayList<>(); // 电池数据列表
+
+    // ======================== 构造方法 =========================
+    public BatteryAdapter() {
+        LogUtils.d(TAG, "【BatteryAdapter】适配器初始化，初始数据列表为空");
+    }
+
+    // ======================== 数据操作方法 =========================
+    /**
+     * 更新适配器数据并刷新列表
+     * @param newData 新的电池数据列表
+     */
+    public void updateData(List<BatteryData> newData) {
+        LogUtils.d(TAG, "【updateData】开始更新数据，新数据列表是否为空：" + (newData == null));
+        // 判空处理，避免空指针
+        if (newData != null) {
+            dataList = newData;
+            LogUtils.d(TAG, "【updateData】数据更新完成，当前数据量：" + dataList.size());
+        } else {
+            dataList.clear();
+            LogUtils.w(TAG, "【updateData】新数据列表为空，已清空本地数据");
+        }
+        notifyDataSetChanged();
+        LogUtils.d(TAG, "【updateData】已通知列表刷新");
+    }
+
+    // ======================== RecyclerView 重写方法 =========================
+    @Override
+    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+        LogUtils.d(TAG, "【onCreateViewHolder】创建ViewHolder，父容器：" + parent.getContext().getClass().getSimpleName());
+        View view = LayoutInflater.from(parent.getContext())
+			.inflate(R.layout.item_battery_report, parent, false);
+        ViewHolder viewHolder = new ViewHolder(view);
+        LogUtils.d(TAG, "【onCreateViewHolder】ViewHolder创建完成");
+        return viewHolder;
+    }
+
+    @Override
+    public void onBindViewHolder(ViewHolder holder, int position) {
+        LogUtils.d(TAG, "【onBindViewHolder】绑定ViewHolder，位置：" + position);
+        // 判空与越界校验
+        if (dataList == null || dataList.isEmpty() || position >= dataList.size()) {
+            LogUtils.w(TAG, "【onBindViewHolder】数据异常，无法绑定视图，位置：" + position);
+            return;
+        }
+
+        BatteryData item = dataList.get(position);
+        // 绑定数据到视图
+        holder.tvLevel.setText(String.format(FORMAT_BATTERY_LEVEL, item.getCurrentLevel()));
+        holder.tvDischargeTime.setText(PREFIX_DISCHARGE_TIME + item.getDischargeTime());
+        holder.tvChargeTime.setText(PREFIX_CHARGE_TIME + item.getChargeTime());
+
+        LogUtils.d(TAG, "【onBindViewHolder】视图绑定完成，位置：" + position + "，电量：" + item.getCurrentLevel() + "%");
+    }
+
+    @Override
+    public int getItemCount() {
+        int count = dataList.size();
+        LogUtils.d(TAG, "【getItemCount】获取条目数量：" + count);
+        return count;
+    }
+
+    // ======================== ViewHolder 内部类 =========================
+    static class ViewHolder extends RecyclerView.ViewHolder {
+        TextView tvLevel; // 电量显示
+        TextView tvDischargeTime; // 放电时间显示
+        TextView tvChargeTime; // 充电时间显示
+
+        ViewHolder(View itemView) {
+            super(itemView);
+            // 初始化视图控件
+            tvLevel = itemView.findViewById(R.id.tvLevel);
+            tvDischargeTime = itemView.findViewById(R.id.tvDischargeTime);
+            tvChargeTime = itemView.findViewById(R.id.tvChargeTime);
+            LogUtils.d(TAG, "【ViewHolder】控件初始化完成");
+        }
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/BackgroundPicturePreviewDialog.java

@@ -0,0 +1,153 @@
+package cc.winboll.studio.powerbell.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.text.TextUtils;
+import android.view.View;
+import android.widget.Button;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.activities.BackgroundSettingsActivity;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.UriUtils;
+import cc.winboll.studio.powerbell.views.BackgroundView;
+
+/**
+ * 背景图片的接收分享文件后的预览对话框
+ * 适配 API30，基于 Java7 开发，支持分享图片的Uri解析、预览与确认选择
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/04/25 16:27:53
+ * @Describe 背景图片的接收分享文件后的预览对话框
+ */
+public class BackgroundPicturePreviewDialog extends Dialog {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "BackgroundPicturePreviewDialog";
+    private static final String TOAST_MSG_EMPTY_FILE = "接收到的文件为空。"; // 空文件提示文本
+
+    // ======================== 成员变量 =========================
+    private Context mContext; // 上下文对象
+    private IOnRecivedPictureListener mIOnRecivedPictureListener; // 图片接收监听
+    private Uri mUriRecivedPicture; // 接收的图片Uri
+    // 控件对象
+    private BackgroundView mBackgroundView; // 背景预览视图
+    private Button dialogbackgroundpicturepreviewButton1; // 取消按钮
+    private Button dialogbackgroundpicturepreviewButton2; // 确认按钮
+
+    // ======================== 接口定义 =========================
+    /**
+     * 图片接收监听接口，用于通知确认选择的图片Uri
+     */
+    public interface IOnRecivedPictureListener {
+        void onAcceptRecivedPicture(Uri uriRecivedPicture);
+    }
+
+    // ======================== 构造方法 =========================
+    public BackgroundPicturePreviewDialog(Context context, IOnRecivedPictureListener iOnRecivedPictureListener) {
+        super(context);
+        LogUtils.d(TAG, "【BackgroundPicturePreviewDialog】对话框初始化开始");
+        // 初始化成员变量
+        mContext = context;
+        mIOnRecivedPictureListener = iOnRecivedPictureListener;
+
+        // 设置布局与控件
+        setContentView(R.layout.dialog_backgroundpicturepreview);
+        initViews();
+        bindButtonClickEvents();
+
+        // 预览接收的图片
+        previewRecivedPicture();
+        LogUtils.d(TAG, "【BackgroundPicturePreviewDialog】对话框初始化完成");
+    }
+
+    // ======================== 视图初始化方法 =========================
+    /**
+     * 初始化对话框内所有控件
+     */
+    private void initViews() {
+        mBackgroundView = findViewById(R.id.backgroundview);
+        dialogbackgroundpicturepreviewButton1 = findViewById(R.id.dialogbackgroundpicturepreviewButton1);
+        dialogbackgroundpicturepreviewButton2 = findViewById(R.id.dialogbackgroundpicturepreviewButton2);
+        LogUtils.d(TAG, "【initViews】对话框控件初始化完成");
+    }
+
+    // ======================== 事件绑定方法 =========================
+    /**
+     * 绑定按钮点击事件
+     */
+    private void bindButtonClickEvents() {
+        // 取消按钮：跳转到主页面并关闭对话框
+        dialogbackgroundpicturepreviewButton1.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View view) {
+					LogUtils.d(TAG, "【onClick】点击取消按钮，跳转到主页面");
+					Intent intent = new Intent(mContext, MainActivity.class);
+					mContext.startActivity(intent);
+					dismiss();
+					LogUtils.d(TAG, "【onClick】对话框已关闭");
+				}
+			});
+
+        // 确认按钮：通知监听并关闭对话框
+        dialogbackgroundpicturepreviewButton2.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【onClick】点击确认按钮，通知接收图片");
+					if (mIOnRecivedPictureListener != null && mUriRecivedPicture != null) {
+						mIOnRecivedPictureListener.onAcceptRecivedPicture(mUriRecivedPicture);
+						LogUtils.d(TAG, "【onClick】已通知监听，图片Uri：" + mUriRecivedPicture);
+					} else {
+						LogUtils.w(TAG, "【onClick】监听为空或图片Uri无效，无法通知");
+					}
+					dismiss();
+					LogUtils.d(TAG, "【onClick】对话框已关闭");
+				}
+			});
+        LogUtils.d(TAG, "【bindButtonClickEvents】按钮点击事件绑定完成");
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 预览接收的分享图片
+     */
+    private void previewRecivedPicture() {
+        LogUtils.d(TAG, "【previewRecivedPicture】开始预览接收的图片");
+        // 校验上下文类型
+        if (!(mContext instanceof BackgroundSettingsActivity)) {
+            LogUtils.e(TAG, "【previewRecivedPicture】上下文不是BackgroundSettingsActivity，无法获取图片Uri");
+            Toast.makeText(mContext, TOAST_MSG_EMPTY_FILE, Toast.LENGTH_SHORT).show();
+            dismiss();
+            return;
+        }
+
+        BackgroundSettingsActivity activity = (BackgroundSettingsActivity) mContext;
+        // 从Intent中获取图片Uri（优先getData，其次EXTRA_STREAM）
+        mUriRecivedPicture = activity.getIntent().getData();
+        if (mUriRecivedPicture == null) {
+            mUriRecivedPicture = activity.getIntent().getParcelableExtra(Intent.EXTRA_STREAM);
+            LogUtils.d(TAG, "【previewRecivedPicture】从EXTRA_STREAM获取Uri：" + mUriRecivedPicture);
+        } else {
+            LogUtils.d(TAG, "【previewRecivedPicture】从getData获取Uri：" + mUriRecivedPicture);
+        }
+
+        // 解析Uri为文件路径
+        String szSrcImage = UriUtils.getFilePathFromUri(mContext, mUriRecivedPicture);
+		//App.notifyMessage(TAG, "szSrcImage : " + szSrcImage);
+        if (TextUtils.isEmpty(szSrcImage)) {
+            LogUtils.w(TAG, "【previewRecivedPicture】解析的文件路径为空");
+            Toast.makeText(mContext, TOAST_MSG_EMPTY_FILE, Toast.LENGTH_SHORT).show();
+            dismiss();
+            return;
+        }
+
+        // 加载图片到预览视图
+		int nCurrentPixelColor = BackgroundSourceUtils.getInstance(mContext).getCurrentBackgroundBean().getPixelColor();
+        mBackgroundView.loadImage(nCurrentPixelColor, szSrcImage, true);
+        LogUtils.d(TAG, "【previewRecivedPicture】图片预览完成，文件路径：" + szSrcImage);
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/ColorPaletteDialog.java

@@ -0,0 +1,733 @@
+package cc.winboll.studio.powerbell.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.graphics.Color;
+import android.graphics.drawable.GradientDrawable;
+import android.os.Bundle;
+import android.text.Editable;
+import android.text.TextUtils;
+import android.text.TextWatcher;
+import android.view.Gravity;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.EditText;
+import android.widget.HorizontalScrollView;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.SeekBar;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import com.a4455jkjh.colorpicker.ColorPickerDialog;
+import com.a4455jkjh.colorpicker.view.OnColorChangedListener;
+
+/**
+ * 调色板对话框（支持颜色拾取、RGB输入、透明度/亮度调节，兼容 API29-30+ 小米机型）
+ * 适配 API30，基于 Java7 开发，返回 0xAARRGGBB 格式颜色（含透明度）
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/16 11:47
+ * @Describe 调色板对话框（支持颜色拾取、RGB输入、透明度/亮度调节，兼容 API29-30+ 小米机型）
+ */
+public class ColorPaletteDialog extends Dialog implements View.OnClickListener, SeekBar.OnSeekBarChangeListener {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    public static final String TAG = "ColorPaletteDialog";
+    private static final int MAX_RGB_VALUE = 255;      // RGB分量最大值（0-255）
+    private static final int DEFAULT_BRIGHTNESS = 100; // 默认亮度百分比（100%，无调节）
+    private static final int BRIGHTNESS_STEP = 5;     // 亮度调节步长（每次±5%，精准流畅）
+    private static final int MIN_BRIGHTNESS = 10;     // 亮度最小值（10%，避免全黑看不见）
+    private static final int MAX_BRIGHTNESS = 200;    // 亮度最大值（200%，避免过曝失真）
+    private static final int MAX_ALPHA_PERCENT = 100; // 透明度最大值（100%=不透明）
+    private static final int MIN_ALPHA_PERCENT = 0;   // 透明度最小值（0%=完全透明）
+    private static final String FORMAT_COLOR_HEX = "#%08X"; // 颜色值格式化（AARRGGBB）
+    private static final String FORMAT_PERCENT = "%d%%"; // 百分比格式化（X%）
+
+    // ====================== 回调接口（紧跟常量，逻辑关联） ======================
+    public interface OnColorSelectedListener {
+        void onColorSelected(int color); // 返回0xAARRGGBB格式颜色（含透明度）
+    }
+
+    // ====================== 成员变量（按优先级排序：核心数据→控件引用） ======================
+    // 核心数据：原始基准值（用户输入/选择颜色时更新）+ 实时调节值（亮度/透明度变化时更新）
+    private OnColorSelectedListener mListener; // 颜色选择回调（非空校验）
+    private int mInitialColor;                 // 初始颜色（传入的默认颜色）
+    private int mCurrentColor;                 // 当前最终颜色（含亮度+透明度调节）
+    private int mCurrentBrightnessPercent;     // 当前亮度百分比（10%-200%）
+    // 透明度：百分比（0-100%，用户直观操作）+ 原始/实时值（0-255，颜色计算用）
+    private int mOriginalAlphaPercent;         // 原始透明度百分比（基准值，用户输入/选色时更新）
+    private int mCurrentAlphaPercent;          // 实时透明度百分比（调节进度条时更新）
+    private int mOriginalAlpha;                // 原始透明度（0-255，基准值）
+    private int mCurrentAlpha;                 // 实时透明度（0-255，计算用）
+    // RGB：原始基准值+实时调节值
+    private int mOriginalR;                    // 原始R分量（基准值，用户输入/选色时更新）
+    private int mOriginalG;                    // 原始G分量（基准值，用户输入/选色时更新）
+    private int mOriginalB;                    // 原始B分量（基准值，用户输入/选色时更新）
+    private int mCurrentR;                     // 实时R分量（亮度调节后，同步输入框显示）
+    private int mCurrentG;                     // 实时G分量（亮度调节后，同步输入框显示）
+    private int mCurrentB;                     // 实时B分量（亮度调节后，同步输入框显示）
+    // 并发控制标记：是否是应用程序自身在更新颜色（避免循环回调/重复触发）
+    private static volatile boolean isAppSelfUpdatingColor = false;
+
+    // 控件引用
+    private ImageView ivColorPicker;   // 颜色预览拾取框
+    private ImageView ivColorScaler;   // 颜色渐变拾取框
+    private EditText etR;              // R分量输入框（显示实时调节值）
+    private EditText etG;              // G分量输入框（显示实时调节值）
+    private EditText etB;              // B分量输入框（显示实时调节值）
+    private EditText etColorValue;     // 颜色值输入框（#AARRGGBB，显示最终值）
+    private SeekBar sbAlpha;           // 透明度调节进度条（0-100%）
+    private TextView tvAlphaValue;     // 透明度数值显示（X%）
+    private TextView tvBrightnessMinus;// 亮度减少按钮（-）
+    private TextView tvBrightnessValue;// 亮度数值显示（X%，直观易懂）
+    private TextView tvBrightnessPlus; // 亮度增加按钮（+）
+    private TextView tvConfirm;        // 确认按钮
+    private TextView tvCancel;         // 取消按钮
+
+    // ====================== 构造方法（初始化核心数据，严格校验） ======================
+    public ColorPaletteDialog(Context context, int initialColor, OnColorSelectedListener listener) {
+        super(context, R.style.CustomDialogStyle);
+        this.mInitialColor = initialColor;
+        this.mListener = listener;
+
+        // 1. 强制回调非空，避免后续空指针（容错）
+        if (mListener == null) {
+            throw new IllegalArgumentException("OnColorSelectedListener can not be null!");
+        }
+
+        // 2. 解析初始颜色：原始基准值 = 实时值（初始无调节）
+        this.mOriginalAlpha = Color.alpha(initialColor);
+        this.mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+        this.mCurrentAlpha = mOriginalAlpha;
+        this.mCurrentAlphaPercent = mOriginalAlphaPercent;
+
+        this.mOriginalR = Color.red(initialColor);
+        this.mOriginalG = Color.green(initialColor);
+        this.mOriginalB = Color.blue(initialColor);
+        this.mCurrentR = mOriginalR;
+        this.mCurrentG = mOriginalG;
+        this.mCurrentB = mOriginalB;
+
+        // 3. 初始化当前状态（默认亮度100%，当前颜色=初始颜色）
+        this.mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+        this.mCurrentColor = initialColor;
+
+        LogUtils.d(TAG, String.format("init dialog success | 初始颜色：%s | 原始RGB：%d,%d,%d | 原始透明度：%s | 初始亮度：%s",
+									  String.format(FORMAT_COLOR_HEX, initialColor),
+									  mOriginalR, mOriginalG, mOriginalB,
+									  String.format(FORMAT_PERCENT, mOriginalAlphaPercent),
+									  String.format(FORMAT_PERCENT, mCurrentBrightnessPercent)));
+    }
+
+    // ====================== 生命周期方法（按执行顺序排列，逻辑清晰） ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        requestWindowFeature(Window.FEATURE_NO_TITLE); // 隐藏标题栏
+        View view = LayoutInflater.from(getContext()).inflate(R.layout.dialog_color_palette, null);
+        setContentView(view);
+
+        // 初始化流程：控件绑定→数据赋值→监听设置→尺寸适配（小米机型优先适配）
+        initViewBind(view);
+        initData();
+        initListener();
+        adjustDialogSize();
+        LogUtils.d(TAG, "dialog create complete | 适配小米API29-30机型");
+    }
+
+    @Override
+    public void dismiss() {
+        super.dismiss();
+        // 释放资源，避免内存泄漏（回调引用置空）
+        mListener = null;
+        LogUtils.d(TAG, "dialog dismiss | 释放资源完成");
+    }
+
+    // ====================== 初始化核心方法（职责单一，便于维护） ======================
+    /**
+     * 控件绑定
+     */
+    private void initViewBind(View view) {
+        ivColorPicker = view.findViewById(R.id.iv_color_picker);
+        ivColorScaler = view.findViewById(R.id.iv_color_scaler);
+        etR = view.findViewById(R.id.et_r);
+        etG = view.findViewById(R.id.et_g);
+        etB = view.findViewById(R.id.et_b);
+        etColorValue = view.findViewById(R.id.et_color_value);
+        sbAlpha = view.findViewById(R.id.sb_alpha);
+        tvAlphaValue = view.findViewById(R.id.tv_alpha_value);
+        tvBrightnessMinus = view.findViewById(R.id.tv_brightness_minus);
+        tvBrightnessValue = view.findViewById(R.id.tv_brightness_value);
+        tvBrightnessPlus = view.findViewById(R.id.tv_brightness_plus);
+        tvConfirm = view.findViewById(R.id.tv_confirm);
+        tvCancel = view.findViewById(R.id.tv_cancel);
+
+        // 控件非空校验（小米低版本容错，绑定失败直接关闭对话框）
+        if (ivColorPicker == null || ivColorScaler == null || etR == null || etG == null || etB == null || etColorValue == null
+			|| sbAlpha == null || tvAlphaValue == null
+			|| tvBrightnessMinus == null || tvBrightnessValue == null || tvBrightnessPlus == null
+			|| tvConfirm == null || tvCancel == null) {
+            LogUtils.e(TAG, "view bind failed | 请检查布局ID是否正确！");
+            dismiss();
+            return;
+        }
+        LogUtils.d(TAG, "view bind complete | 所有控件绑定成功");
+    }
+
+    /**
+     * 数据初始化（无监听状态下赋值，避免循环回调）
+     */
+    private void initData() {
+        // 1. 颜色预览（显示当前最终颜色，初始=原始颜色）
+        ivColorPicker.setBackgroundColor(mCurrentColor);
+
+        // 2. RGB输入框（显示「实时分量」，初始=原始值）
+        etR.setText(String.valueOf(mCurrentR));
+        etG.setText(String.valueOf(mCurrentG));
+        etB.setText(String.valueOf(mCurrentB));
+
+        // 3. 颜色值输入框（显示当前最终颜色，格式#AARRGGBB）
+        etColorValue.setText(String.format(FORMAT_COLOR_HEX, mCurrentColor));
+
+        // 4. 透明度控件（进度条+文本，初始=原始透明度）
+        sbAlpha.setProgress(mCurrentAlphaPercent);
+        tvAlphaValue.setText(String.format(FORMAT_PERCENT, mCurrentAlphaPercent));
+
+        // 5. 亮度控件（显示默认100%，初始化按钮状态）
+        tvBrightnessValue.setText(String.format(FORMAT_PERCENT, mCurrentBrightnessPercent));
+        updateBrightnessBtnStatus(); // 禁用边界值按钮
+
+        LogUtils.d(TAG, String.format("init data complete | 原始透明度：%s",
+									  String.format(FORMAT_PERCENT, mOriginalAlphaPercent)));
+    }
+
+    /**
+     * 监听初始化
+     */
+    private void initListener() {
+        // 点击监听（按钮+颜色拾取框）
+        ivColorPicker.setOnClickListener(this);
+        ivColorScaler.setOnClickListener(this);
+        tvConfirm.setOnClickListener(this);
+        tvCancel.setOnClickListener(this);
+        tvBrightnessMinus.setOnClickListener(this);
+        tvBrightnessPlus.setOnClickListener(this);
+        // 透明度进度条监听
+        sbAlpha.setOnSeekBarChangeListener(this);
+        // 输入框监听（RGB+颜色值，避免循环同步）
+        initTextWatcherListener();
+        LogUtils.d(TAG, "all listener init complete | 监听绑定成功");
+    }
+
+    /**
+     * 对话框尺寸适配（小米全面屏+软键盘优化，避免输入框被遮挡）
+     */
+    private void adjustDialogSize() {
+        Window window = getWindow();
+        if (window != null) {
+            WindowManager.LayoutParams lp = window.getAttributes();
+            // 宽度占屏幕80%，高度自适应（适配不同屏幕尺寸）
+            lp.width = (int) (getContext().getResources().getDisplayMetrics().widthPixels * 0.8);
+            lp.height = WindowManager.LayoutParams.WRAP_CONTENT;
+            // 软键盘适配：小米虚拟导航栏兼容
+            window.setAttributes(lp);
+            window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_PAN
+									| WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN);
+            LogUtils.d(TAG, "dialog size adjust complete | 适配全面屏+软键盘");
+        }
+    }
+
+    // ====================== 监听子方法（细分类型，逻辑清晰） ======================
+    /**
+     * 输入框文本监听（RGB+颜色值，传入触发ID避免循环同步）
+     */
+    private void initTextWatcherListener() {
+        // RGB输入框监听（复用方法，减少冗余）
+        setEditTextWatcher(etR, R.id.et_r);
+        setEditTextWatcher(etG, R.id.et_g);
+        setEditTextWatcher(etB, R.id.et_b);
+
+        // 颜色值输入框监听（支持#RRGGBB/#AARRGGBB格式）
+        etColorValue.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {}
+
+				@Override
+				public void afterTextChanged(Editable s) {
+					// 关键：判断非应用自身更新，才执行解析（避免循环回调）
+					if (!isAppSelfUpdatingColor) {
+						parseColorFromStr(s.toString().trim(), R.id.et_color_value);
+					}
+				}
+			});
+    }
+
+    // ====================== 透明度进度条监听实现 ======================
+    @Override
+    public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
+        // 仅处理用户手动拖动进度条（避免应用自身更新时触发）
+        if (fromUser && !isAppSelfUpdatingColor) {
+            updateAlphaBySeekBar(progress);
+        }
+    }
+
+    @Override
+    public void onStartTrackingTouch(SeekBar seekBar) {}
+
+    @Override
+    public void onStopTrackingTouch(SeekBar seekBar) {}
+
+    /**
+     * 拖动透明度进度条更新颜色
+     */
+    private synchronized void updateAlphaBySeekBar(int alphaPercent) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true; // 标记为应用自身更新
+            try {
+                // 更新实时透明度（百分比+0-255值）
+                mCurrentAlphaPercent = alphaPercent;
+                mCurrentAlpha = percent2Alpha(alphaPercent);
+                // 重新计算最终颜色（基于当前亮度+新透明度）
+                calculateBrightnessAndUpdate();
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("update alpha by seekbar | 透明度：%s",
+											  String.format(FORMAT_PERCENT, mCurrentAlphaPercent)));
+            } finally {
+                isAppSelfUpdatingColor = false; // 释放标记
+            }
+        }
+    }
+
+    // ====================== 颜色核心逻辑 ======================
+    /**
+     * 核心计算：基于原始RGB+当前亮度+当前透明度，计算实时RGB+最终颜色
+     */
+    private void calculateBrightnessAndUpdate() {
+        // 亮度百分比转调节系数（10%→0.1，100%→1.0，200%→2.0）
+        float brightnessFactor = mCurrentBrightnessPercent / 100.0f;
+
+        // RGB三个分量同时调节（基于原始基准值，避免叠加失真），限制0-255
+        mCurrentR = Math.min(Math.max(Math.round(mOriginalR * brightnessFactor), 0), MAX_RGB_VALUE);
+        mCurrentG = Math.min(Math.max(Math.round(mOriginalG * brightnessFactor), 0), MAX_RGB_VALUE);
+        mCurrentB = Math.min(Math.max(Math.round(mOriginalB * brightnessFactor), 0), MAX_RGB_VALUE);
+
+        // 拼接「实时透明度」+「实时RGB」，得到最终颜色（0xAARRGGBB）
+        mCurrentColor = Color.argb(mCurrentAlpha, mCurrentR, mCurrentG, mCurrentB);
+    }
+
+    /**
+     * 亮度减少（每次减5%，最低10%）
+     */
+    private void decreaseBrightness() {
+        changeBrightness(false);
+    }
+
+    /**
+     * 亮度增加（每次加5%，最高200%）
+     */
+    private void increaseBrightness() {
+        changeBrightness(true);
+    }
+
+    /**
+     * 亮度调节核心方法（统一逻辑，加并发控制）
+     */
+    private synchronized void changeBrightness(boolean isIncrease) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true;
+            try {
+                if (isIncrease) {
+                    if (mCurrentBrightnessPercent >= MAX_BRIGHTNESS) return;
+                    mCurrentBrightnessPercent += BRIGHTNESS_STEP;
+                } else {
+                    if (mCurrentBrightnessPercent <= MIN_BRIGHTNESS) return;
+                    mCurrentBrightnessPercent -= BRIGHTNESS_STEP;
+                }
+                // 计算亮度调节后的实时RGB+最终颜色
+                calculateBrightnessAndUpdate();
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("%s brightness | 亮度：%s | 实时RGB：%d,%d,%d",
+											  isIncrease ? "increase" : "decrease",
+											  String.format(FORMAT_PERCENT, mCurrentBrightnessPercent),
+											  mCurrentR, mCurrentG, mCurrentB));
+            } finally {
+                isAppSelfUpdatingColor = false;
+            }
+        }
+    }
+
+    /**
+     * 解析颜色字符串（支持#RRGGBB/#AARRGGBB，更新原始基准值+实时值）
+     */
+    private void parseColorFromStr(String colorStr, int triggerViewId) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true;
+            try {
+                if (TextUtils.isEmpty(colorStr)) return;
+
+                // 补全#前缀（兼容用户输入习惯）
+                if (!colorStr.startsWith("#")) {
+                    colorStr = "#" + colorStr;
+                }
+
+                // 格式校验（仅支持6位RRGGBB/8位AARRGGBB）
+                if (colorStr.length() != 7 && colorStr.length() != 9) {
+                    LogUtils.e(TAG, String.format("parse color failed | 格式错误（需#RRGGBB/#AARRGGBB），输入：%s", colorStr));
+                    return;
+                }
+
+                // 解析颜色
+                int parsedColor = Color.parseColor(colorStr);
+
+                // 更新原始基准值与实时值
+                mOriginalAlpha = Color.alpha(parsedColor);
+                mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+                mOriginalR = Color.red(parsedColor);
+                mOriginalG = Color.green(parsedColor);
+                mOriginalB = Color.blue(parsedColor);
+                mCurrentAlpha = mOriginalAlpha;
+                mCurrentAlphaPercent = mOriginalAlphaPercent;
+                mCurrentR = mOriginalR;
+                mCurrentG = mOriginalG;
+                mCurrentB = mOriginalB;
+                mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+                mCurrentColor = parsedColor;
+
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("parse color success | 解析颜色：%s | 透明度：%s | 重置亮度：%s",
+											  String.format(FORMAT_COLOR_HEX, parsedColor),
+											  String.format(FORMAT_PERCENT, mCurrentAlphaPercent),
+											  String.format(FORMAT_PERCENT, DEFAULT_BRIGHTNESS)));
+            } catch (IllegalArgumentException e) {
+                LogUtils.e(TAG, String.format("parse color failed | 非法颜色格式，输入：%s", colorStr), e);
+            } finally {
+                isAppSelfUpdatingColor = false;
+            }
+        }
+    }
+
+    /**
+     * 通过RGB输入框更新颜色（用户输入后，更新原始基准值+实时值，重置亮度为100%）
+     */
+    private synchronized void updateColorByRGB(int triggerViewId) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true;
+            try {
+                // 解析用户输入的RGB值（限制0-255，非法输入设为0）
+                int inputR = parseInputValue(etR.getText().toString());
+                int inputG = parseInputValue(etG.getText().toString());
+                int inputB = parseInputValue(etB.getText().toString());
+
+                // 更新原始基准值与实时值
+                mOriginalR = inputR;
+                mOriginalG = inputG;
+                mOriginalB = inputB;
+                mCurrentR = inputR;
+                mCurrentG = inputG;
+                mCurrentB = inputB;
+                mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+                mCurrentColor = Color.argb(mCurrentAlpha, mCurrentR, mCurrentG, mCurrentB);
+
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("update color by RGB | 新原始RGB：%d,%d,%d | 透明度：%s | 重置亮度：%s",
+											  mOriginalR, mOriginalG, mOriginalB,
+											  String.format(FORMAT_PERCENT, mCurrentAlphaPercent),
+											  String.format(FORMAT_PERCENT, DEFAULT_BRIGHTNESS)));
+            } catch (Exception e) {
+                LogUtils.e(TAG, "update color by RGB failed", e);
+            } finally {
+                isAppSelfUpdatingColor = false;
+            }
+        }
+    }
+
+    /**
+     * 核心同步：更新所有控件显示
+     */
+    private void updateAllViews() {
+        // 1. 同步颜色预览
+        ivColorPicker.setBackgroundColor(mCurrentColor);
+
+        // 2. 同步RGB输入框
+        etR.setText(String.valueOf(mCurrentR));
+        etG.setText(String.valueOf(mCurrentG));
+        etB.setText(String.valueOf(mCurrentB));
+
+        // 3. 同步颜色值输入框
+        etColorValue.setText(String.format(FORMAT_COLOR_HEX, mCurrentColor));
+
+        // 4. 同步透明度控件
+        sbAlpha.setProgress(mCurrentAlphaPercent);
+        tvAlphaValue.setText(String.format(FORMAT_PERCENT, mCurrentAlphaPercent));
+
+        // 5. 同步亮度控件
+        tvBrightnessValue.setText(String.format(FORMAT_PERCENT, mCurrentBrightnessPercent));
+        updateBrightnessBtnStatus();
+
+        LogUtils.d(TAG, String.format("sync all views complete | 最终颜色：%s | 实时RGB：%d,%d,%d | 透明度：%s | 亮度：%s",
+									  String.format(FORMAT_COLOR_HEX, mCurrentColor),
+									  mCurrentR, mCurrentG, mCurrentB,
+									  String.format(FORMAT_PERCENT, mCurrentAlphaPercent),
+									  String.format(FORMAT_PERCENT, mCurrentBrightnessPercent)));
+    }
+
+    /**
+     * 更新亮度按钮状态（边界值禁用，提升交互体验）
+     */
+    private void updateBrightnessBtnStatus() {
+        boolean canMinus = mCurrentBrightnessPercent > MIN_BRIGHTNESS;
+        boolean canPlus = mCurrentBrightnessPercent < MAX_BRIGHTNESS;
+
+        tvBrightnessMinus.setEnabled(canMinus);
+        tvBrightnessPlus.setEnabled(canPlus);
+        tvBrightnessMinus.setTextColor(canMinus ? Color.BLACK : Color.parseColor("#CCCCCC"));
+        tvBrightnessPlus.setTextColor(canPlus ? Color.BLACK : Color.parseColor("#CCCCCC"));
+    }
+
+    // ====================== 工具方法 ======================
+    /**
+     * 透明度：0-255 → 0-100%
+     */
+    private int alpha2Percent(int alpha) {
+        return Math.round((float) alpha / MAX_RGB_VALUE * MAX_ALPHA_PERCENT);
+    }
+
+    /**
+     * 透明度：0-100% → 0-255
+     */
+    private int percent2Alpha(int percent) {
+        return Math.round((float) percent / MAX_ALPHA_PERCENT * MAX_RGB_VALUE);
+    }
+
+    /**
+     * 解析输入值（限制0-255，非法输入返回0）
+     */
+    private int parseInputValue(String input) {
+        if (TextUtils.isEmpty(input)) return 0;
+        try {
+            int value = Integer.parseInt(input);
+            return Math.min(Math.max(value, 0), MAX_RGB_VALUE);
+        } catch (NumberFormatException e) {
+            LogUtils.e(TAG, String.format("parse input failed | 非法数字，输入：%s", input), e);
+            return 0;
+        }
+    }
+
+    /**
+     * RGB输入框监听复用
+     */
+    private void setEditTextWatcher(EditText editText, final int viewId) {
+        editText.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {}
+
+				@Override
+				public void afterTextChanged(Editable s) {
+					if (!isAppSelfUpdatingColor) {
+						updateColorByRGB(viewId);
+					}
+				}
+			});
+    }
+
+    /**
+     * dp转px（适配小米不同分辨率）
+     */
+    private int dp2px(float dp) {
+        return (int) (dp * getContext().getResources().getDisplayMetrics().density + 0.5f);
+    }
+
+    /**
+     * 显示系统颜色选择器（兼容API29-30，无高版本依赖，小米机型适配）
+     */
+    private void showSystemColorPicker() {
+        LogUtils.d(TAG, "show system color picker | 兼容小米API29-30，支持横向滚动");
+        final android.app.AlertDialog.Builder builder = new android.app.AlertDialog.Builder(getContext());
+        builder.setTitle("选择基础颜色");
+
+        // 50种常用颜色：按彩虹光谱顺序排列
+        final int[] systemColors = {
+			0xFFCC0000, 0xFFFF0000, 0xFFFF6666, 0xFFFF1493, 0xFF8B0000, 0xFFFF4500,
+			0xFFCC6600, 0xFFFF8800, 0xFFFFAA33, 0xFFFFBB00, 0xFFF5A623,
+			0xFFCCCC00, 0xFFFFFF00, 0xFFFFEE99, 0xFFFFFACD, 0xFFFFD700,
+			0xFF006600, 0xFF00FF00, 0xFF99FF99, 0xFF66CC66, 0xFF98FB98, 0xFF00FF99, 0xFF003300,
+			0xFF006666, 0xFF00FFFF, 0xFF99FFFF, 0xFF00CCCC, 0xFF40E0D0,
+			0xFF0000CC, 0xFF00008B, 0xFF0000FF, 0xFF6666FF, 0xFF87CEEB, 0xFF0066FF, 0xFF0099FF, 0xFF4B0082,
+			0xFF660099, 0xFF8800FF, 0xFFAA99FF, 0xFF9370DB, 0xFFCBC3E3, 0xFF8A2BE2,
+			0xFFFF00FF, 0xFFFF99CC, 0xFFFFCCDD, 0xFFFFB6C1, 0xFFFFA5A5,
+			0xFF8B4513, 0xFFA0522D, 0xFFD2B48C, 0xFFCD853F,
+			0xFF333333, 0xFF666666, 0xFF888888, 0xFFAAAAAA, 0xFFCCCCCC, 0xFFE6E6E6,
+			0xFF000000, 0xFFFFFFFF, 0xFFFFFAFA
+        };
+
+        // 1. 第一级：水平滚动容器
+        HorizontalScrollView horizontalScrollView = new HorizontalScrollView(getContext());
+        horizontalScrollView.setHorizontalScrollBarEnabled(true);
+        horizontalScrollView.setScrollBarStyle(View.SCROLLBARS_INSIDE_OVERLAY);
+        horizontalScrollView.setPadding(dp2px(5), dp2px(5), dp2px(5), dp2px(5));
+
+        // 2. 第二级：颜色排列容器（横向）
+        LinearLayout colorLayout = new LinearLayout(getContext());
+        colorLayout.setOrientation(LinearLayout.HORIZONTAL);
+        colorLayout.setGravity(Gravity.CENTER_VERTICAL);
+        colorLayout.setPadding(dp2px(10), dp2px(10), dp2px(10), dp2px(10));
+
+        // 3. 循环添加颜色按钮（内置圆形效果）
+        for (int i = 0; i < systemColors.length; i++) {
+            final int color = systemColors[i];
+            ImageView colorBtn = new ImageView(getContext());
+            LinearLayout.LayoutParams lp = new LinearLayout.LayoutParams(dp2px(40), dp2px(40));
+            if (i != systemColors.length - 1) {
+                lp.setMargins(0, 0, dp2px(10), 0); // 按钮间距
+            }
+            colorBtn.setLayoutParams(lp);
+
+            // 内置圆形背景（白色边框+圆形形状）
+            GradientDrawable circleBg = new GradientDrawable();
+            circleBg.setShape(GradientDrawable.OVAL);
+            circleBg.setColor(color);
+            circleBg.setStroke(dp2px(2), Color.WHITE);
+            colorBtn.setBackground(circleBg);
+
+            colorBtn.setClickable(true);
+            colorBtn.setFocusable(true);
+
+            // 点击事件
+            colorBtn.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						if (!isAppSelfUpdatingColor) {
+							isAppSelfUpdatingColor = true;
+							try {
+								mOriginalAlpha = Color.alpha(color);
+								mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+								mOriginalR = Color.red(color);
+								mOriginalG = Color.green(color);
+								mOriginalB = Color.blue(color);
+								mCurrentAlpha = mOriginalAlpha;
+								mCurrentAlphaPercent = mOriginalAlphaPercent;
+								mCurrentR = mOriginalR;
+								mCurrentG = mOriginalG;
+								mCurrentB = mOriginalB;
+								mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+								mCurrentColor = color;
+								updateAllViews();
+								builder.create().dismiss();
+								LogUtils.d(TAG, String.format("select system color | 选择颜色：%s | 透明度：%s",
+															  String.format(FORMAT_COLOR_HEX, color),
+															  String.format(FORMAT_PERCENT, mCurrentAlphaPercent)));
+							} finally {
+								isAppSelfUpdatingColor = false;
+							}
+						}
+					}
+				});
+            colorLayout.addView(colorBtn);
+        }
+
+        // 层级嵌套
+        horizontalScrollView.addView(colorLayout);
+        builder.setView(horizontalScrollView).setNegativeButton("关闭", null).show();
+    }
+
+    // ====================== 点击事件实现 ======================
+    @Override
+    public void onClick(View v) {
+        int id = v.getId();
+        // 所有点击事件均加并发判断
+        if (!isAppSelfUpdatingColor) {
+            if (id == R.id.iv_color_picker) {
+                showSystemColorPicker();
+            } else if (id == R.id.iv_color_scaler) {
+                openColorScalerDialog(mCurrentColor);
+            } else if (id == R.id.tv_confirm) {
+                mListener.onColorSelected(mCurrentColor);
+                LogUtils.d(TAG, String.format("confirm color | 回调颜色：%s",
+											  String.format(FORMAT_COLOR_HEX, mCurrentColor)));
+                dismiss();
+            } else if (id == R.id.tv_cancel) {
+                dismiss();
+                LogUtils.d(TAG, "cancel color | 取消选择，关闭对话框");
+            } else if (id == R.id.tv_brightness_minus) {
+                decreaseBrightness();
+            } else if (id == R.id.tv_brightness_plus) {
+                increaseBrightness();
+            }
+        }
+    }
+
+    /**
+     * 打开颜色渐变选择器
+     */
+    void openColorScalerDialog(int nColor) {
+        LogUtils.d(TAG, String.format("openColorScalerDialog | 初始颜色：%s",
+									  String.format(FORMAT_COLOR_HEX, nColor)));
+        final ColorScalerDialog dlg = new ColorScalerDialog(getContext(), nColor);
+        dlg.setOnColorChangedListener(new OnColorChangedListener() {
+				@Override
+				public void beforeColorChanged() {}
+
+				@Override
+				public void onColorChanged(int color) {
+					dlg.currentColorScalerDialogColor = color;
+				}
+
+				@Override
+				public void afterColorChanged() {}
+			});
+        dlg.show();
+    }
+
+    // ====================== 内部类 ======================
+    class ColorScalerDialog extends ColorPickerDialog {
+        public int currentColorScalerDialogColor = 0;
+
+        public ColorScalerDialog(Context context, int p) {
+            super(context, p);
+            this.currentColorScalerDialogColor = p;
+        }
+
+        @Override
+        public void dismiss() {
+            super.dismiss();
+            int color = currentColorScalerDialogColor;
+            ToastUtils.show(String.format("选择颜色：%s", String.format(FORMAT_COLOR_HEX, color)));
+            if (!isAppSelfUpdatingColor) {
+                isAppSelfUpdatingColor = true;
+                try {
+                    mOriginalAlpha = Color.alpha(color);
+                    mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+                    mOriginalR = Color.red(color);
+                    mOriginalG = Color.green(color);
+                    mOriginalB = Color.blue(color);
+                    mCurrentAlpha = mOriginalAlpha;
+                    mCurrentAlphaPercent = mOriginalAlphaPercent;
+                    mCurrentR = mOriginalR;
+                    mCurrentG = mOriginalG;
+                    mCurrentB = mOriginalB;
+                    mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+                    mCurrentColor = color;
+                    updateAllViews();
+                    LogUtils.d(TAG, String.format("select scaler color | 选择颜色：%s | 透明度：%s",
+												  String.format(FORMAT_COLOR_HEX, color),
+												  String.format(FORMAT_PERCENT, mCurrentAlphaPercent)));
+                } finally {
+                    isAppSelfUpdatingColor = false;
+                }
+            }
+        }
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/NetworkBackgroundDialog.java

@@ -0,0 +1,340 @@
+package cc.winboll.studio.powerbell.dialogs;
+
+import android.content.Context;
+import android.content.DialogInterface;
+import android.os.Handler;
+import android.os.Message;
+import android.text.TextUtils;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.ImageDownloader;
+import cc.winboll.studio.powerbell.views.BackgroundView;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/19 20:11
+ * @Describe 网络背景使用提示对话框
+ * 继承 AndroidX AlertDialog，绑定自定义布局 dialog_networkbackground.xml
+ * 适配 API30，基于 Java7 开发，支持网络图片下载、预览与回调
+ */
+public class NetworkBackgroundDialog extends AlertDialog {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    public static final String TAG = "NetworkBackgroundDialog";
+    private static final int MSG_IMAGE_LOAD_SUCCESS = 1001; // 图片加载成功消息标识
+    private static final int MSG_IMAGE_LOAD_FAILED = 1002; // 图片加载失败消息标识
+
+    // ====================== 回调接口（紧跟常量，逻辑关联） ======================
+    /**
+     * 按钮点击回调接口（Java7 接口实现）
+     */
+    public interface OnDialogClickListener {
+        void onConfirm(String szConfirmFilePath); // 确认按钮点击，返回图片路径
+        void onCancel();                          // 取消按钮点击
+    }
+
+    // ====================== 成员变量（按优先级排序：核心数据→控件引用） ======================
+    // 核心数据
+    private OnDialogClickListener listener;       // 按钮点击回调
+    private Context mContext;                     // 上下文对象
+    private Handler mUiHandler;                   // 主线程 Handler，用于接收子线程消息更新 UI
+    private String mPreviewFilePath;              // 预览图片文件路径
+    private String mPreviewFileUrl;               // 预览图片网络 URL
+    private String mDownloadSavedPath;            // 下载图片保存路径
+    // 控件引用
+    private TextView tvTitle;                     // 对话框标题
+    private TextView tvContent;                   // 对话框内容
+    private Button btnCancel;                     // 取消按钮
+    private Button btnConfirm;                    // 确认按钮
+    private Button btnPreview;                    // 预览按钮
+    private EditText etURL;                       // URL 输入框
+    private BackgroundView mBackgroundView;       // 背景预览视图
+
+    // ====================== 构造方法（Java7 显式构造，按参数重载排序） ======================
+    /**
+     * 基础构造（仅传入 Context）
+     * @param context 上下文
+     */
+    public NetworkBackgroundDialog(@NonNull Context context) {
+        super(context);
+        LogUtils.d(TAG, "NetworkBackgroundDialog: 基础构造初始化");
+        initHandler();
+        initView();
+        setDismissListener();
+    }
+
+    /**
+     * 带回调的构造（便于外部处理点击事件）
+     * @param context 上下文
+     * @param listener 按钮点击回调
+     */
+    public NetworkBackgroundDialog(@NonNull Context context, OnDialogClickListener listener) {
+        super(context);
+        this.listener = listener;
+        LogUtils.d(TAG, "NetworkBackgroundDialog: 带回调构造初始化");
+        initHandler();
+        initView();
+        setDismissListener();
+    }
+
+    // ====================== 生命周期相关方法（对话框消失监听、Handler 初始化） ======================
+    /**
+     * 初始化主线程 Handler，用于接收子线程消息并更新 UI
+     */
+    private void initHandler() {
+        mUiHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                // 对话框已消失时，不再处理 UI 消息
+                if (!isShowing()) {
+                    LogUtils.d(TAG, "handleMessage: 对话框已消失，忽略消息");
+                    return;
+                }
+                switch (msg.what) {
+                    case MSG_IMAGE_LOAD_SUCCESS:
+                        // 图片加载成功，获取文件路径并设置背景
+                        mDownloadSavedPath = (String) msg.obj;
+                        LogUtils.d(TAG, String.format("handleMessage: 图片加载成功，保存路径：%s", mDownloadSavedPath));
+						int nCurrentPixelColor = BackgroundSourceUtils.getInstance(mContext).getCurrentBackgroundBean().getPixelColor();
+						
+                        mBackgroundView.loadImage(nCurrentPixelColor, mDownloadSavedPath, true);
+                        break;
+                    case MSG_IMAGE_LOAD_FAILED:
+                        // 图片加载失败，设置默认背景
+                        LogUtils.e(TAG, "handleMessage: 图片加载失败");
+                        mBackgroundView.setBackgroundResource(R.drawable.ic_launcher);
+                        ToastUtils.show("图片预览失败，请检查链接");
+                        break;
+                    default:
+                        break;
+                }
+            }
+        };
+        LogUtils.d(TAG, "initHandler: 主线程 Handler 初始化完成");
+    }
+
+    /**
+     * 设置对话框消失监听：移除 Handler 消息，避免内存泄漏
+     */
+    private void setDismissListener() {
+        this.setOnDismissListener(new OnDismissListener() {
+				@Override
+				public void onDismiss(DialogInterface dialog) {
+					// 对话框消失时，移除所有未处理的消息和回调
+					if (mUiHandler != null) {
+						mUiHandler.removeCallbacksAndMessages(null);
+						LogUtils.d(TAG, "onDismiss: Handler 消息已清理");
+					}
+					LogUtils.d(TAG, "onDismiss: 对话框已消失");
+				}
+			});
+        LogUtils.d(TAG, "setDismissListener: 对话框消失监听已设置");
+    }
+
+    // ====================== 初始化方法（布局、控件、点击事件） ======================
+    /**
+     * 初始化布局和控件
+     */
+    private void initView() {
+        mContext = this.getContext();
+        // 加载自定义布局
+        View dialogView = LayoutInflater.from(getContext()).inflate(R.layout.dialog_networkbackground, null);
+        // 设置对话框内容视图
+        setView(dialogView);
+
+        // 绑定控件
+        tvTitle = (TextView) dialogView.findViewById(R.id.tv_dialog_title);
+        tvContent = (TextView) dialogView.findViewById(R.id.tv_dialog_content);
+        btnCancel = (Button) dialogView.findViewById(R.id.btn_cancel);
+        btnConfirm = (Button) dialogView.findViewById(R.id.btn_confirm);
+        btnPreview = (Button) dialogView.findViewById(R.id.btn_preview);
+        etURL = (EditText) dialogView.findViewById(R.id.et_url);
+        mBackgroundView = (BackgroundView) dialogView.findViewById(R.id.bv_background_preview);
+
+        // 控件非空校验
+        if (tvTitle == null || tvContent == null || btnCancel == null || btnConfirm == null || btnPreview == null
+			|| etURL == null || mBackgroundView == null) {
+            LogUtils.e(TAG, "initView: 控件绑定失败，请检查布局ID是否正确");
+            dismiss();
+            return;
+        }
+
+        // 加载初始图片
+        mBackgroundView.setBackgroundResource(R.drawable.blank100x100);
+        // 设置按钮点击事件
+        setButtonClickListeners();
+
+        LogUtils.d(TAG, "initView: 布局和控件初始化完成");
+    }
+
+    /**
+     * 设置按钮点击监听
+     */
+    private void setButtonClickListeners() {
+        // 取消按钮：关闭对话框 + 回调外部
+        btnCancel.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "onClick: 取消按钮点击");
+					BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(mContext);
+					utils.setCurrentSourceToPreview();
+
+					dismiss(); // 关闭对话框
+					if (listener != null) {
+						listener.onCancel();
+						LogUtils.d(TAG, "onClick: 取消回调已执行");
+					}
+				}
+			});
+
+        // 确认按钮：关闭对话框 + 回调外部
+        btnConfirm.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "onClick: 确认按钮点击");
+					dismiss(); // 关闭对话框
+					if (TextUtils.isEmpty(mDownloadSavedPath)) {
+						ToastUtils.show("未下载图片。");
+						LogUtils.w(TAG, "onClick: 确认失败，未下载图片");
+						return;
+					}
+					if (listener != null) {
+						listener.onConfirm(mDownloadSavedPath);
+						LogUtils.d(TAG, String.format("onClick: 确认回调已执行，图片路径：%s", mDownloadSavedPath));
+					}
+				}
+			});
+
+        // 图片预览按钮：预览输入框地址图片
+        btnPreview.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "onClick: 预览按钮点击");
+					downloadImageToAlbumAndPreview();
+				}
+			});
+
+        LogUtils.d(TAG, "setButtonClickListeners: 按钮点击监听已设置");
+    }
+
+    // ====================== 业务逻辑方法（图片下载、预览） ======================
+    /**
+     * 下载网络图片并预览
+     */
+    void downloadImageToAlbumAndPreview() {
+        mPreviewFileUrl = etURL.getText().toString().trim();
+        if (TextUtils.isEmpty(mPreviewFileUrl)) {
+            ToastUtils.show("请输入图片URL");
+            LogUtils.w(TAG, "downloadImageToAlbumAndPreview: 图片URL为空");
+            return;
+        }
+
+        LogUtils.d(TAG, String.format("downloadImageToAlbumAndPreview: 开始下载图片，URL：%s", mPreviewFileUrl));
+        ImageDownloader.getInstance(mContext).downloadImage(mPreviewFileUrl, new ImageDownloader.DownloadCallback() {
+				@Override
+				public void onSuccess(String savePath) {
+					LogUtils.d(TAG, String.format("onSuccess: 图片下载成功，保存路径：%s", savePath));
+					// 发送消息到主线程，携带图片路径
+					Message successMsg = mUiHandler.obtainMessage(MSG_IMAGE_LOAD_SUCCESS, savePath);
+					mUiHandler.sendMessage(successMsg);
+				}
+
+				@Override
+				public void onFailure(String errorMsg) {
+					LogUtils.e(TAG, String.format("onFailure: 图片下载失败，错误信息：%s", errorMsg));
+					ToastUtils.show("下载失败：" + errorMsg);
+					// 发送图片加载失败消息
+					Message failMsg = mUiHandler.obtainMessage(MSG_IMAGE_LOAD_FAILED);
+					mUiHandler.sendMessage(failMsg);
+				}
+			});
+    }
+
+    /**
+     * 根据文件路径设置 BackgroundView 背景（主线程调用）
+     * @param previewFilePath 图片文件路径
+     */
+    private void previewBackground(String previewFilePath) {
+        if (TextUtils.isEmpty(previewFilePath)) {
+            LogUtils.w(TAG, "previewBackground: 预览文件路径为空");
+            return;
+        }
+
+        FileInputStream fis = null;
+        try {
+            File imageFile = new File(previewFilePath);
+            if (!imageFile.exists()) {
+                ToastUtils.show("图片文件不存在：" + previewFilePath);
+                LogUtils.e(TAG, String.format("previewBackground: 图片文件不存在，路径：%s", previewFilePath));
+                mBackgroundView.setBackgroundResource(R.drawable.ic_launcher);
+                return;
+            }
+
+            // 预览背景
+            mPreviewFilePath = previewFilePath;
+            BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(mContext);
+            utils.saveFileToPreviewBean(new File(mPreviewFilePath), mPreviewFileUrl);
+            mBackgroundView.loadByBackgroundBean(utils.getPreviewBackgroundBean());
+
+            LogUtils.d(TAG, String.format("previewBackground: 图片预览成功，路径：%s", previewFilePath));
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("previewBackground: 图片预览失败，错误信息：%s", e.getMessage()), e);
+            mBackgroundView.setBackgroundResource(R.drawable.ic_launcher);
+        } finally {
+            // Java7 手动关闭流，避免资源泄漏
+            if (fis != null) {
+                try {
+                    fis.close();
+                    LogUtils.d(TAG, "previewBackground: 文件输入流已关闭");
+                } catch (IOException e) {
+                    LogUtils.e(TAG, String.format("previewBackground: 关闭文件输入流失败，错误信息：%s", e.getMessage()), e);
+                }
+            }
+        }
+    }
+
+    // ====================== 对外提供方法（灵活适配不同场景） ======================
+    /**
+     * 对外提供方法：修改对话框标题
+     * @param title 标题文本
+     */
+    public void setTitle(String title) {
+        if (tvTitle != null && !TextUtils.isEmpty(title)) {
+            tvTitle.setText(title);
+            LogUtils.d(TAG, String.format("setTitle: 对话框标题已修改为：%s", title));
+        }
+    }
+
+    /**
+     * 对外提供方法：修改对话框内容
+     * @param content 内容文本
+     */
+    public void setContent(String content) {
+        if (tvContent != null && !TextUtils.isEmpty(content)) {
+            tvContent.setText(content);
+            LogUtils.d(TAG, String.format("setContent: 对话框内容已修改为：%s", content));
+        }
+    }
+
+    /**
+     * 对外提供方法：设置按钮点击回调（替代带参构造）
+     * @param listener 按钮点击回调
+     */
+    public void setOnDialogClickListener(OnDialogClickListener listener) {
+        this.listener = listener;
+        LogUtils.d(TAG, "setOnDialogClickListener: 按钮点击回调已设置");
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/handlers/ControlCenterServiceHandler.java

@@ -0,0 +1,120 @@
+package cc.winboll.studio.powerbell.handlers;
+
+import android.os.Handler;
+import android.os.Message;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.models.NotificationMessage;
+import cc.winboll.studio.powerbell.services.ControlCenterService;
+import java.lang.ref.WeakReference;
+
+/**
+ * 服务通信Handler
+ * 功能：处理电量提醒消息，构建并发送标准化通知
+ * 特性：弱引用防泄漏、参数严格校验、通知格式统一
+ * 适配：Java7 | API30 | 小米手机
+ */
+public class ControlCenterServiceHandler extends Handler {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "ControlCenterServiceHandler";
+    public static final int MSG_REMIND_TEXT = 1001; // 电量提醒消息标识
+
+    // 提醒类型常量
+    private static final String REMIND_TYPE_CHARGE = "+";
+    private static final String REMIND_TYPE_USAGE = "-";
+
+    // 电量范围常量
+    private static final int BATTERY_LEVEL_MIN = 0;
+    private static final int BATTERY_LEVEL_MAX = 100;
+
+    // 通知文案常量（抽离魔法值，便于统一修改）
+    private static final String CHARGE_REMIND_TITLE = "充电提醒";
+    private static final String USAGE_REMIND_TITLE = "耗电提醒";
+    private static final String CHARGE_REMIND_CONTENT_FORMAT = "(+)电量已达额定值。当前电量%d%%，%s。";
+    private static final String USAGE_REMIND_CONTENT_FORMAT = "(-)电量低于指定值。当前电量%d%%，%s。";
+    private static final String CHARGE_STATE_CHARGING = "充电中";
+    private static final String CHARGE_STATE_NOT_CHARGING = "未充电";
+
+    // ================================== 成员变量区（弱引用防泄漏，final保证不可变）=================================
+    private final WeakReference<ControlCenterService> mwrControlCenterService;
+
+    // ================================== 构造方法（强制传入服务，初始化弱引用）=================================
+    public ControlCenterServiceHandler(ControlCenterService service) {
+        LogUtils.d(TAG, "构造方法执行 | service=" + (service != null ? service.getClass().getSimpleName() : "null"));
+        this.mwrControlCenterService = new WeakReference<>(service);
+    }
+
+    // ================================== 核心消息处理（重写handleMessage，解析多参数消息）=================================
+    @Override
+    public void handleMessage(Message msg) {
+        super.handleMessage(msg);
+        // 解析消息参数：obj=提醒类型(+/-)，arg1=当前电量，arg2=充电状态(1=充电/0=未充电)
+        String remindType = (msg.obj != null) ? (String) msg.obj : "";
+        int currentBattery = msg.arg1;
+        boolean isCharging = msg.arg2 == 1;
+
+        LogUtils.d(TAG, "handleMessage: 接收消息 | what=" + msg.what + " | type=" + remindType + " | battery=" + currentBattery + " | isCharging=" + isCharging);
+
+        // 弱引用获取服务，避免内存泄漏
+        ControlCenterService service = mwrControlCenterService.get();
+        if (service == null) {
+            LogUtils.e(TAG, "handleMessage: 服务实例已被GC回收，终止消息处理");
+            return;
+        }
+
+        // 按消息类型分发处理
+        switch (msg.what) {
+            case MSG_REMIND_TEXT:
+                handleRemindMessage(service, remindType, currentBattery, isCharging);
+                break;
+            default:
+                LogUtils.w(TAG, "handleMessage: 未知消息类型，忽略处理 | what=" + msg.what);
+                break;
+        }
+    }
+
+    // ================================== 业务辅助方法（构建通知并发送，全链路参数校验）=================================
+    /**
+     * 处理电量提醒消息，构建带电量+充电状态的通知并发送
+     * @param service         控制中心服务实例（已校验非空）
+     * @param remindType      提醒类型（+充电/-耗电）
+     * @param currentBattery  当前电量（0-100）
+     * @param isCharging      充电状态
+     */
+    private void handleRemindMessage(ControlCenterService service, String remindType, int currentBattery, boolean isCharging) {
+        LogUtils.d(TAG, "handleRemindMessage: 开始处理提醒消息 | type=" + remindType + " | battery=" + currentBattery + " | isCharging=" + isCharging);
+
+        // 1. 前置校验：通知工具类+参数有效性
+        if (service.getNotificationManager() == null) {
+            LogUtils.e(TAG, "handleRemindMessage: 通知管理工具类未初始化，无法发送提醒");
+            return;
+        }
+        if (!REMIND_TYPE_CHARGE.equals(remindType) && !REMIND_TYPE_USAGE.equals(remindType)) {
+            LogUtils.w(TAG, "handleRemindMessage: 提醒类型无效，忽略 | type=" + remindType + " | 允许值：" + REMIND_TYPE_CHARGE + "/" + REMIND_TYPE_USAGE);
+            return;
+        }
+        if (currentBattery < BATTERY_LEVEL_MIN || currentBattery > BATTERY_LEVEL_MAX) {
+            LogUtils.w(TAG, "handleRemindMessage: 电量值超出范围，忽略 | battery=" + currentBattery + " | 允许范围：" + BATTERY_LEVEL_MIN + "-" + BATTERY_LEVEL_MAX);
+            return;
+        }
+
+        // 2. 构建通知模型，使用统一格式
+        NotificationMessage remindMsg = new NotificationMessage();
+        String chargeStateDesc = isCharging ? CHARGE_STATE_CHARGING : CHARGE_STATE_NOT_CHARGING;
+        if (REMIND_TYPE_CHARGE.equals(remindType)) {
+            remindMsg.setTitle(CHARGE_REMIND_TITLE);
+            remindMsg.setContent(String.format(CHARGE_REMIND_CONTENT_FORMAT, currentBattery, chargeStateDesc));
+            remindMsg.setRemindMSG("charge_remind");
+        } else {
+            remindMsg.setTitle(USAGE_REMIND_TITLE);
+            remindMsg.setContent(String.format(USAGE_REMIND_CONTENT_FORMAT, currentBattery, chargeStateDesc));
+            remindMsg.setRemindMSG("usage_remind");
+        }
+        LogUtils.d(TAG, "handleRemindMessage: 通知模型构建完成 | title=" + remindMsg.getTitle() + " | content=" + remindMsg.getContent());
+
+        // 3. 调用通知工具类发送提醒
+        LogUtils.d(TAG, "handleRemindMessage: 调用通知工具类发送提醒 | remindMSG=" + remindMsg.getRemindMSG());
+        service.getNotificationManager().showRemindNotification(service, remindMsg);
+        LogUtils.d(TAG, "handleRemindMessage: 提醒通知发送流程执行完毕");
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/models/AppConfigBean.java

@@ -0,0 +1,274 @@
+package cc.winboll.studio.powerbell.models;
+
+import android.os.Parcel;
+import android.os.Parcelable;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+import java.io.Serializable;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/04/29 17:24:53
+ * @Describe 应用运行参数类
+ * 适配 API30，支持 Serializable 持久化、Parcelable Intent 传递、JSON 序列化/反序列化
+ * 包含耗电提醒、充电提醒、电量检测、铃声提醒、相框尺寸等核心配置
+ */
+public class AppConfigBean extends BaseBean implements Serializable, Parcelable {
+    // ====================== 静态常量区（首屏可见，统一管理） ======================
+    // 序列化版本号（Serializable 必备，避免反序列化失败）
+    private static final long serialVersionUID = 1L;
+    // 日志标签（全局统一）
+    transient public static final String TAG = "AppConfigBean";
+    // 字段校验常量（统一阈值，避免硬编码）
+    private static final int MIN_INTERVAL = 500;        // 最小检测间隔（ms）
+    private static final int MIN_REMIND_INTERVAL = 1000;// 最小提醒间隔（ms）
+    private static final int BATTERY_MIN = 0;           // 电量最小值
+    private static final int BATTERY_MAX = 100;         // 电量最大值
+    private static final int INVALID_BATTERY = -1;      // 无效电量标识
+    private static final int DEFAULT_FRAME_WIDTH = 500; // 默认相框宽度（px）
+    private static final int DEFAULT_FRAME_HEIGHT = 500;// 默认相框高度（px）
+
+    // ====================== 成员变量区（按功能分类：提醒配置→电量状态→检测配置→相框配置） ======================
+    // 耗电提醒配置
+    boolean isEnableUsageReminder = false; // 耗电提醒开关
+    int usageReminderValue = 45;           // 耗电提醒阈值（0-100）
+    // 充电提醒配置
+    boolean isEnableChargeReminder = false;// 充电提醒开关
+    int chargeReminderValue = 100;         // 充电提醒阈值（0-100）
+    // 铃声提醒配置
+    int reminderIntervalTime = 5000;       // 铃声提醒间隔（ms）
+    // 电量状态
+    boolean isCharging = false;            // 是否充电
+    // 电量检测配置
+    int batteryDetectInterval = 2000;      // 电量检测间隔（ms，适配 RemindThread）
+    // 相框配置
+    int defaultFrameWidth = DEFAULT_FRAME_WIDTH;  // 默认相框宽度（px）
+    int defaultFrameHeight = DEFAULT_FRAME_HEIGHT;// 默认相框高度（px）
+
+    // ====================== 构造方法（初始化默认配置，强化默认值校验） ======================
+    public AppConfigBean() {
+        setChargeReminderValue(100);
+        setEnableChargeReminder(false);
+        setUsageReminderValue(10);
+        setEnableUsageReminder(false);
+        setReminderIntervalTime(5000);
+        setBatteryDetectInterval(1000);
+        setDefaultFrameWidth(DEFAULT_FRAME_WIDTH);
+        setDefaultFrameHeight(DEFAULT_FRAME_HEIGHT);
+        LogUtils.d(TAG, "AppConfigBean() 构造器执行 | 默认配置初始化完成");
+    }
+
+    // ====================== 核心业务方法（Setter/Getter，按字段功能分类，补充调试日志） ======================
+    // --------------- 充电状态相关 ---------------
+    public void setIsCharging(boolean isCharging) {
+        this.isCharging = isCharging;
+        LogUtils.d(TAG, String.format("setIsCharging() 执行 | 充电状态=%b", isCharging));
+    }
+
+    public boolean isCharging() {
+        return isCharging;
+    }
+
+    // --------------- 耗电提醒配置相关 ---------------
+    public void setEnableUsageReminder(boolean isEnableUsageReminder) {
+        this.isEnableUsageReminder = isEnableUsageReminder;
+        LogUtils.d(TAG, String.format("setEnableUsageReminder() 执行 | 耗电提醒开关=%b", isEnableUsageReminder));
+    }
+
+    public boolean isEnableUsageReminder() {
+        return isEnableUsageReminder;
+    }
+
+    public void setUsageReminderValue(int usageReminderValue) {
+        this.usageReminderValue = Math.min(Math.max(usageReminderValue, BATTERY_MIN), BATTERY_MAX);
+        LogUtils.d(TAG, String.format("setUsageReminderValue() 执行 | 最终阈值=%d | 输入值=%d", this.usageReminderValue, usageReminderValue));
+    }
+
+    public int getUsageReminderValue() {
+        return usageReminderValue;
+    }
+
+    // --------------- 充电提醒配置相关 ---------------
+    public void setEnableChargeReminder(boolean isEnableChargeReminder) {
+        this.isEnableChargeReminder = isEnableChargeReminder;
+        LogUtils.d(TAG, String.format("setEnableChargeReminder() 执行 | 充电提醒开关=%b", isEnableChargeReminder));
+    }
+
+    public boolean isEnableChargeReminder() {
+        return isEnableChargeReminder;
+    }
+
+    public void setChargeReminderValue(int chargeReminderValue) {
+        this.chargeReminderValue = Math.min(Math.max(chargeReminderValue, BATTERY_MIN), BATTERY_MAX);
+        LogUtils.d(TAG, String.format("setChargeReminderValue() 执行 | 最终阈值=%d | 输入值=%d", this.chargeReminderValue, chargeReminderValue));
+    }
+
+    public int getChargeReminderValue() {
+        return chargeReminderValue;
+    }
+
+    // --------------- 铃声提醒配置相关 ---------------
+    public void setReminderIntervalTime(int reminderIntervalTime) {
+        this.reminderIntervalTime = Math.max(reminderIntervalTime, MIN_REMIND_INTERVAL);
+        LogUtils.d(TAG, String.format("setReminderIntervalTime() 执行 | 最终间隔=%dms | 输入值=%dms", this.reminderIntervalTime, reminderIntervalTime));
+    }
+
+    public int getReminderIntervalTime() {
+        return reminderIntervalTime;
+    }
+
+    // --------------- 电量检测配置相关 ---------------
+    public void setBatteryDetectInterval(int batteryDetectInterval) {
+        this.batteryDetectInterval = Math.max(batteryDetectInterval, MIN_INTERVAL);
+        LogUtils.d(TAG, String.format("setBatteryDetectInterval() 执行 | 最终间隔=%dms | 输入值=%dms", this.batteryDetectInterval, batteryDetectInterval));
+    }
+
+    public int getBatteryDetectInterval() {
+        return batteryDetectInterval;
+    }
+
+    // --------------- 相框配置相关 ---------------
+    public void setDefaultFrameWidth(int defaultFrameWidth) {
+        this.defaultFrameWidth = defaultFrameWidth;
+        LogUtils.d(TAG, String.format("setDefaultFrameWidth() 执行 | 最终宽度=%dpx | 输入值=%dpx", this.defaultFrameWidth, defaultFrameWidth));
+    }
+
+    public int getDefaultFrameWidth() {
+        return defaultFrameWidth;
+    }
+
+    public void setDefaultFrameHeight(int defaultFrameHeight) {
+        this.defaultFrameHeight = defaultFrameHeight;
+        LogUtils.d(TAG, String.format("setDefaultFrameHeight() 执行 | 最终高度=%dpx | 输入值=%dpx", this.defaultFrameHeight, defaultFrameHeight));
+    }
+
+    public int getDefaultFrameHeight() {
+        return defaultFrameHeight;
+    }
+
+    // ====================== 父类重写方法（JSON 序列化/反序列化，兼容旧配置） ======================
+    @Override
+    public String getName() {
+        return AppConfigBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        LogUtils.d(TAG, "writeThisToJsonWriter() 执行 | 开始JSON序列化");
+
+        // 原有字段序列化
+        jsonWriter.name("isEnableUsageReminder").value(isEnableUsageReminder());
+        jsonWriter.name("usageReminderValue").value(getUsageReminderValue());
+        jsonWriter.name("isEnableChargeReminder").value(isEnableChargeReminder());
+        jsonWriter.name("chargeReminderValue").value(getChargeReminderValue());
+        jsonWriter.name("reminderIntervalTime").value(getReminderIntervalTime());
+        jsonWriter.name("isCharging").value(isCharging());
+        // 新增字段序列化（检测配置）
+        jsonWriter.name("batteryDetectInterval").value(getBatteryDetectInterval());
+        // 新增字段序列化（相框配置）
+        jsonWriter.name("defaultFrameWidth").value(getDefaultFrameWidth());
+        jsonWriter.name("defaultFrameHeight").value(getDefaultFrameHeight());
+
+        LogUtils.d(TAG, "writeThisToJsonWriter() 完成 | JSON序列化成功");
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader() 执行 | 开始JSON反序列化");
+        AppConfigBean bean = new AppConfigBean();
+        jsonReader.beginObject();
+
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            // 兼容拼写错误字段（isEnableUsegeReminder → isEnableUsageReminder）
+            if (name.equals("isEnableUsageReminder") || name.equals("isEnableUsegeReminder")) {
+                bean.setEnableUsageReminder(jsonReader.nextBoolean());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%b", name, bean.isEnableUsageReminder()));
+            } else if (name.equals("usageReminderValue") || name.equals("usegeReminderValue")) {
+                bean.setUsageReminderValue(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getUsageReminderValue()));
+            } else if (name.equals("isEnableChargeReminder")) {
+                bean.setEnableChargeReminder(jsonReader.nextBoolean());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%b", name, bean.isEnableChargeReminder()));
+            } else if (name.equals("chargeReminderValue")) {
+                bean.setChargeReminderValue(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getChargeReminderValue()));
+            } else if (name.equals("reminderIntervalTime")) {
+                bean.setReminderIntervalTime(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getReminderIntervalTime()));
+            } else if (name.equals("isCharging")) {
+                bean.setIsCharging(jsonReader.nextBoolean());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%b", name, bean.isCharging()));
+            } else if (name.equals("batteryDetectInterval")) {
+                bean.setBatteryDetectInterval(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getBatteryDetectInterval()));
+            } else if (name.equals("defaultFrameWidth")) {
+                bean.setDefaultFrameWidth(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getDefaultFrameWidth()));
+            } else if (name.equals("defaultFrameHeight")) {
+                bean.setDefaultFrameHeight(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getDefaultFrameHeight()));
+            } else {
+                jsonReader.skipValue();
+                LogUtils.w(TAG, String.format("readBeanFromJsonReader() 跳过未知字段 | %s", name));
+            }
+        }
+
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader() 完成 | JSON反序列化成功");
+        return bean;
+    }
+
+    // ====================== Parcelable 接口实现（API30 Intent 传递必备） ======================
+    @Override
+    public int describeContents() {
+        return 0; // 无特殊内容描述，固定返回0
+    }
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        LogUtils.d(TAG, "writeToParcel() 执行 | 开始Parcel序列化");
+        // 按成员变量顺序写入，boolean 转 byte 存储
+        dest.writeByte((byte) (isEnableUsageReminder ? 1 : 0));
+        dest.writeInt(usageReminderValue);
+        dest.writeByte((byte) (isEnableChargeReminder ? 1 : 0));
+        dest.writeInt(chargeReminderValue);
+        dest.writeInt(reminderIntervalTime);
+        dest.writeByte((byte) (isCharging ? 1 : 0));
+        dest.writeInt(batteryDetectInterval);
+        dest.writeInt(defaultFrameWidth);
+        dest.writeInt(defaultFrameHeight);
+        LogUtils.d(TAG, "writeToParcel() 完成 | Parcel序列化成功");
+    }
+
+    // 反序列化 Creator（必须 public static final 修饰，Java7 适配）
+    public static final Parcelable.Creator<AppConfigBean> CREATOR = new Parcelable.Creator<AppConfigBean>() {
+        @Override
+        public AppConfigBean createFromParcel(Parcel source) {
+            LogUtils.d(TAG, "createFromParcel() 执行 | 开始Parcel反序列化");
+            AppConfigBean bean = new AppConfigBean();
+            // 按 writeToParcel 顺序读取
+            bean.isEnableUsageReminder = source.readByte() != 0;
+            bean.usageReminderValue = source.readInt();
+            bean.isEnableChargeReminder = source.readByte() != 0;
+            bean.chargeReminderValue = source.readInt();
+            bean.reminderIntervalTime = source.readInt();
+            bean.isCharging = source.readByte() != 0;
+            bean.batteryDetectInterval = source.readInt();
+            bean.defaultFrameWidth = source.readInt();
+            bean.defaultFrameHeight = source.readInt();
+            LogUtils.d(TAG, "createFromParcel() 完成 | Parcel反序列化成功");
+            return bean;
+        }
+
+        @Override
+        public AppConfigBean[] newArray(int size) {
+            return new AppConfigBean[size];
+        }
+    };
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/models/BackgroundBean.java

@@ -0,0 +1,296 @@
+package cc.winboll.studio.powerbell.models;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+import java.io.Serializable;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/18 11:52:28
+ * @Describe 应用背景图片数据类
+ * 适配 API30，支持 Serializable 持久化、JSON 序列化/反序列化
+ * 存储正式/预览背景配置，包含原图、压缩图、裁剪比例、像素颜色等核心字段
+ */
+public class BackgroundBean extends BaseBean implements Serializable {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    // 日志标签（全局统一，替换 Log 为 LogUtils）
+    public static final String TAG = "BackgroundBean";
+    // 兼容旧字段常量（统一管理，避免硬编码）
+    private static final String OLD_FIELD_USE_SCALED_COMPRESS = "isUseScaledCompress";
+    // 字段默认值常量（统一管理，避免魔法值）
+    private static final int DEFAULT_DIMENSION = 100; // 默认宽高
+    private static final int MIN_DIMENSION = 1;       // 最小宽高
+
+    // ====================== 成员变量（按功能分类：原图配置→压缩图配置→控制字段→裁剪配置→像素颜色） ======================
+    // 原图配置
+    private String backgroundFileName = "";          // 背景图片文件名
+    private String backgroundFilePath = "";          // 背景图片完整路径
+    private String backgroundFileInfo = "";          // 图片信息（Uri、网络地址等）
+    // 压缩图配置
+    private String backgroundScaledCompressFileName = ""; // 压缩后背景图片文件名
+    private String backgroundScaledCompressFilePath = ""; // 压缩后背景图片完整路径
+    // 控制字段
+    private boolean isUseBackgroundFile = false;             // 是否启用背景图片
+    private boolean isUseBackgroundScaledCompressFile = false; // 是否启用压缩背景图（重命名：原isUseScaledCompress）
+    // 裁剪配置
+    private int backgroundWidth = DEFAULT_DIMENSION;  // 背景图宽度
+    private int backgroundHeight = DEFAULT_DIMENSION; // 背景图高度
+    // 像素颜色
+    private int pixelColor = 0xFFFFFFFF;                       // 拾取的像素颜色（纯色背景用）
+
+    // ====================== 构造方法（无参构造，JSON反序列化必备） ======================
+    /**
+     * 无参构造器（必须，JSON反序列化时需默认构造器）
+     */
+    public BackgroundBean() {
+        LogUtils.d(TAG, "BackgroundBean: 无参构造初始化完成");
+    }
+
+    // ====================== Getter/Setter 方法（按功能分类，补充调试日志，强化校验） ======================
+    // --------------- 原图配置相关 ---------------
+    public String getBackgroundFileName() {
+        return backgroundFileName;
+    }
+
+    public void setBackgroundFileName(String backgroundFileName) {
+        this.backgroundFileName = backgroundFileName == null ? "" : backgroundFileName;
+        LogUtils.d(TAG, String.format("setBackgroundFileName: 背景文件名设置为 %s", this.backgroundFileName));
+    }
+
+    public String getBackgroundFilePath() {
+        return backgroundFilePath;
+    }
+
+    public void setBackgroundFilePath(String backgroundFilePath) {
+        this.backgroundFilePath = backgroundFilePath == null ? "" : backgroundFilePath;
+        LogUtils.d(TAG, String.format("setBackgroundFilePath: 背景文件路径设置为 %s", this.backgroundFilePath));
+    }
+
+    public String getBackgroundFileInfo() {
+        return backgroundFileInfo;
+    }
+
+    public void setBackgroundFileInfo(String backgroundFileInfo) {
+        this.backgroundFileInfo = backgroundFileInfo == null ? "" : backgroundFileInfo;
+        LogUtils.d(TAG, String.format("setBackgroundFileInfo: 背景文件信息设置为 %s", this.backgroundFileInfo));
+    }
+
+    // --------------- 控制字段相关 ---------------
+    public boolean isUseBackgroundFile() {
+        return isUseBackgroundFile;
+    }
+
+    public void setIsUseBackgroundFile(boolean isUseBackgroundFile) {
+        this.isUseBackgroundFile = isUseBackgroundFile;
+        LogUtils.d(TAG, String.format("setIsUseBackgroundFile: 是否启用背景图设置为 %b", isUseBackgroundFile));
+    }
+
+    // --------------- 压缩图配置相关 ---------------
+    public String getBackgroundScaledCompressFileName() {
+        return backgroundScaledCompressFileName;
+    }
+
+    public void setBackgroundScaledCompressFileName(String backgroundScaledCompressFileName) {
+        this.backgroundScaledCompressFileName = backgroundScaledCompressFileName == null ? "" : backgroundScaledCompressFileName;
+        LogUtils.d(TAG, String.format("setBackgroundScaledCompressFileName: 压缩背景文件名设置为 %s", this.backgroundScaledCompressFileName));
+    }
+
+    public String getBackgroundScaledCompressFilePath() {
+        return backgroundScaledCompressFilePath;
+    }
+
+    public void setBackgroundScaledCompressFilePath(String backgroundScaledCompressFilePath) {
+        this.backgroundScaledCompressFilePath = backgroundScaledCompressFilePath == null ? "" : backgroundScaledCompressFilePath;
+        LogUtils.d(TAG, String.format("setBackgroundScaledCompressFilePath: 压缩背景文件路径设置为 %s", this.backgroundScaledCompressFilePath));
+    }
+
+    /**
+     * 重命名：原isUseScaledCompress → 新isUseBackgroundScaledCompressFile（Getter/Setter同步修改）
+     * 语义：明确表示“是否启用背景压缩图文件”，避免与其他压缩逻辑混淆
+     */
+    public boolean isUseBackgroundScaledCompressFile() {
+        return isUseBackgroundScaledCompressFile;
+    }
+
+    public void setIsUseBackgroundScaledCompressFile(boolean isUseBackgroundScaledCompressFile) {
+        this.isUseBackgroundScaledCompressFile = isUseBackgroundScaledCompressFile;
+        LogUtils.d(TAG, String.format("setIsUseBackgroundScaledCompressFile: 是否启用压缩背景图设置为 %b", isUseBackgroundScaledCompressFile));
+    }
+
+    // --------------- 裁剪配置相关 ---------------
+    public int getBackgroundWidth() {
+        return backgroundWidth;
+    }
+
+    public void setBackgroundWidth(int backgroundWidth) {
+        this.backgroundWidth = backgroundWidth < MIN_DIMENSION ? DEFAULT_DIMENSION : backgroundWidth;
+        LogUtils.d(TAG, String.format("setBackgroundWidth: 背景宽度设置为 %d（输入值：%d）", this.backgroundWidth, backgroundWidth));
+    }
+
+    public int getBackgroundHeight() {
+        return backgroundHeight;
+    }
+
+    public void setBackgroundHeight(int backgroundHeight) {
+        this.backgroundHeight = backgroundHeight < MIN_DIMENSION ? DEFAULT_DIMENSION : backgroundHeight;
+        LogUtils.d(TAG, String.format("setBackgroundHeight: 背景高度设置为 %d（输入值：%d）", this.backgroundHeight, backgroundHeight));
+    }
+
+    // --------------- 像素颜色相关 ---------------
+    public int getPixelColor() {
+        return pixelColor;
+    }
+
+    public void setPixelColor(int pixelColor) {
+        this.pixelColor = pixelColor;
+        LogUtils.d(TAG, String.format("setPixelColor: 像素颜色设置为 0x%08X", pixelColor));
+    }
+
+    // ====================== 序列化/反序列化方法（适配重命名字段，兼容旧版本，补充调试日志） ======================
+    @Override
+    public String getName() {
+        String className = BackgroundBean.class.getName();
+        LogUtils.d(TAG, String.format("getName: 类名标识为 %s", className));
+        return className;
+    }
+
+    /**
+     * 序列化：同步重命名字段（原isUseScaledCompress → 新isUseBackgroundScaledCompressFile）
+     * 确保新字段能正常持久化，同时兼容旧版本JSON（保留旧字段写入，避免旧版本读取异常）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        BackgroundBean bean = this;
+        // 原图配置序列化
+        jsonWriter.name("backgroundFileName").value(bean.getBackgroundFileName());
+        jsonWriter.name("backgroundFilePath").value(bean.getBackgroundFilePath());
+        jsonWriter.name("backgroundFileInfo").value(bean.getBackgroundFileInfo());
+        // 控制字段序列化
+        jsonWriter.name("isUseBackgroundFile").value(bean.isUseBackgroundFile());
+        // 压缩图配置序列化
+        jsonWriter.name("backgroundScaledCompressFileName").value(bean.getBackgroundScaledCompressFileName());
+        jsonWriter.name("backgroundScaledCompressFilePath").value(bean.getBackgroundScaledCompressFilePath());
+        // 关键：新字段序列化（核心）
+        jsonWriter.name("isUseBackgroundScaledCompressFile").value(bean.isUseBackgroundScaledCompressFile());
+        // 兼容旧版本：保留旧字段名写入（避免旧版本Bean读取时缺失字段）
+        jsonWriter.name(OLD_FIELD_USE_SCALED_COMPRESS).value(bean.isUseBackgroundScaledCompressFile());
+        // 裁剪配置与像素颜色序列化
+        jsonWriter.name("backgroundWidth").value(bean.getBackgroundWidth());
+        jsonWriter.name("backgroundHeight").value(bean.getBackgroundHeight());
+        jsonWriter.name("pixelColor").value(bean.getPixelColor());
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON 序列化完成，已兼容旧字段");
+    }
+
+    /**
+     * 反序列化：同步处理重命名字段（兼容旧版本JSON，新旧字段都能读取）
+     * 逻辑：优先读取新字段，若新字段不存在则读取旧字段（确保升级后旧配置仍有效）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        BackgroundBean bean = new BackgroundBean();
+        jsonReader.beginObject();
+        // 临时变量：存储旧字段值（用于兼容）
+        boolean tempUseScaledCompress = false;
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            switch (name) {
+                case "backgroundFileName":
+                    bean.setBackgroundFileName(jsonReader.nextString());
+                    break;
+                case "backgroundFilePath":
+                    bean.setBackgroundFilePath(jsonReader.nextString());
+                    break;
+                case "backgroundFileInfo":
+                    bean.setBackgroundFileInfo(jsonReader.nextString());
+                    break;
+                case "isUseBackgroundFile":
+                    bean.setIsUseBackgroundFile(jsonReader.nextBoolean());
+                    break;
+                case "backgroundScaledCompressFileName":
+                    bean.setBackgroundScaledCompressFileName(jsonReader.nextString());
+                    break;
+                case "backgroundScaledCompressFilePath":
+                    bean.setBackgroundScaledCompressFilePath(jsonReader.nextString());
+                    break;
+                case "isUseBackgroundScaledCompressFile":
+                    // 关键：读取新字段（优先）
+                    bean.setIsUseBackgroundScaledCompressFile(jsonReader.nextBoolean());
+                    LogUtils.d(TAG, "readBeanFromJsonReader: 读取新字段 isUseBackgroundScaledCompressFile 完成");
+                    break;
+                case OLD_FIELD_USE_SCALED_COMPRESS:
+                    // 兼容旧版本：读取旧字段（若新字段未读取，则用旧字段值）
+                    tempUseScaledCompress = jsonReader.nextBoolean();
+                    LogUtils.d(TAG, "readBeanFromJsonReader: 读取旧字段 isUseScaledCompress 完成");
+                    break;
+                case "backgroundWidth":
+                    bean.setBackgroundWidth(jsonReader.nextInt());
+                    break;
+                case "backgroundHeight":
+                    bean.setBackgroundHeight(jsonReader.nextInt());
+                    break;
+                case "pixelColor":
+                    bean.setPixelColor(jsonReader.nextInt());
+                    break;
+                default:
+                    jsonReader.skipValue();
+                    LogUtils.w(TAG, String.format("readBeanFromJsonReader: 跳过未知字段 %s", name));
+                    break;
+            }
+        }
+        jsonReader.endObject();
+        // 兼容逻辑：若新字段未被赋值（旧版本JSON无此字段），则用旧字段值填充
+        if (!bean.isUseBackgroundScaledCompressFile()) {
+            bean.setIsUseBackgroundScaledCompressFile(tempUseScaledCompress);
+            LogUtils.d(TAG, "readBeanFromJsonReader: 旧字段值已填充到新字段");
+        }
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON 反序列化完成");
+        return bean;
+    }
+
+    // ====================== 辅助方法（重置配置、配置校验，补充调试日志） ======================
+    /**
+     * 重置背景配置（适配“取消背景”功能，同步重置重命名字段）
+     */
+    public void resetBackgroundConfig() {
+        this.backgroundFileName = "";
+        this.backgroundFilePath = "";
+        this.backgroundScaledCompressFileName = "";
+        this.backgroundScaledCompressFilePath = "";
+        this.backgroundFileInfo = "";
+        this.isUseBackgroundFile = false;
+        this.isUseBackgroundScaledCompressFile = false;
+        this.backgroundWidth = DEFAULT_DIMENSION;
+        this.backgroundHeight = DEFAULT_DIMENSION;
+        LogUtils.d(TAG, "resetBackgroundConfig: 背景配置已重置为默认值");
+    }
+
+    /**
+     * 检查背景配置是否有效（适配BackgroundSettingsActivity的预览/保存校验）
+     * 同步使用重命名字段判断压缩图是否启用
+     * @return true-配置有效（可显示背景图），false-配置无效
+     */
+    public boolean isBackgroundConfigValid() {
+        // 启用背景图时，需确保：原图路径/文件名 或 压缩图路径/文件名 非空
+        if (!isUseBackgroundFile) {
+            LogUtils.d(TAG, "isBackgroundConfigValid: 未启用背景图，配置无效");
+            return false;
+        }
+        // 原图校验：路径非空 或 文件名非空
+        boolean isOriginalValid = !backgroundFilePath.isEmpty() || !backgroundFileName.isEmpty();
+        // 压缩图校验：启用压缩图时，路径/文件名需非空
+        boolean isCompressValid = true;
+        if (isUseBackgroundScaledCompressFile()) {
+            isCompressValid = !backgroundScaledCompressFilePath.isEmpty() || !backgroundScaledCompressFileName.isEmpty();
+        }
+        // 逻辑：启用压缩图则需压缩图有效；不启用压缩图则需原图有效
+        boolean isValid = isUseBackgroundScaledCompressFile() ? isCompressValid : isOriginalValid;
+        LogUtils.d(TAG, String.format("isBackgroundConfigValid: 背景配置有效性为 %b（启用压缩图：%b，原图有效：%b，压缩图有效：%b）",
+									  isValid, isUseBackgroundScaledCompressFile(), isOriginalValid, isCompressValid));
+        return isValid;
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryData.java

@@ -0,0 +1,82 @@
+package cc.winboll.studio.powerbell.models;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/22 14:30:51
+ * @Describe 电池报告数据模型
+ * 适配 API30，存储当前电量、放电时间、充电时间核心数据
+ * 支持参数校验与调试日志输出
+ */
+public class BatteryData {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    public static final String TAG = "BatteryData";
+    // 字段校验常量（避免硬编码，统一管理）
+    private static final int BATTERY_MIN = 0;
+    private static final int BATTERY_MAX = 100;
+    private static final String EMPTY_TIME = "00:00:00";
+
+    // ====================== 成员变量（按功能分类：电量→时间） ======================
+    private int currentLevel;     // 当前电池电量（0-100）
+    private String dischargeTime; // 放电时间
+    private String chargeTime;    // 充电时间
+
+    // ====================== 构造方法（按参数重载排序，补充校验与日志） ======================
+    /**
+     * 无参构造器（适配 JSON 反序列化、反射实例化场景）
+     */
+    public BatteryData() {
+        this.currentLevel = BATTERY_MIN;
+        this.dischargeTime = EMPTY_TIME;
+        this.chargeTime = EMPTY_TIME;
+        LogUtils.d(TAG, "BatteryData: 无参构造初始化完成，默认值已设置");
+    }
+
+    /**
+     * 带参构造器（核心构造，初始化所有字段）
+     * @param currentLevel 当前电量（0-100）
+     * @param dischargeTime 放电时间
+     * @param chargeTime 充电时间
+     */
+    public BatteryData(int currentLevel, String dischargeTime, String chargeTime) {
+        // 电量范围校验（0-100，异常值置为0）
+        this.currentLevel = currentLevel >= BATTERY_MIN && currentLevel <= BATTERY_MAX 
+			? currentLevel : BATTERY_MIN;
+        // 时间字段防 null（空值置为默认空时间）
+        this.dischargeTime = dischargeTime == null ? EMPTY_TIME : dischargeTime;
+        this.chargeTime = chargeTime == null ? EMPTY_TIME : chargeTime;
+
+        // 调试日志：输出入参与最终赋值结果
+        LogUtils.d(TAG, String.format("BatteryData: 带参构造初始化完成 | 当前电量：%d（输入：%d）| 放电时间：%s（输入：%s）| 充电时间：%s（输入：%s）",
+									  this.currentLevel, currentLevel,
+									  this.dischargeTime, dischargeTime,
+									  this.chargeTime, chargeTime));
+    }
+
+    // ====================== Getter 方法（按成员变量顺序排列，补充日志可选） ======================
+    /**
+     * 获取当前电池电量
+     * @return 当前电量（0-100）
+     */
+    public int getCurrentLevel() {
+        return currentLevel;
+    }
+
+    /**
+     * 获取放电时间
+     * @return 放电时间
+     */
+    public String getDischargeTime() {
+        return dischargeTime;
+    }
+
+    /**
+     * 获取充电时间
+     * @return 充电时间
+     */
+    public String getChargeTime() {
+        return chargeTime;
+    }
+}
+