refactor(gradle): 强制项目使用Java 7语法并统一API适配范围

- build.gradle: subprojects Java版本从11降级为1.7
- libwinboll/build.gradle: minSdkVersion从21统一为26
- build.properties: 编译计数器自动递增(buildCount: 23→24)

.gitignore

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

aes/build.properties

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

aes/src/main/AndroidManifest.xml

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

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

@@ -1,22 +1,29 @@
 package cc.winboll.studio.aes;
 
-import android.app.Activity;
 import android.os.Bundle;
 import android.view.View;
-import android.widget.Toolbar;
+import androidx.appcompat.widget.Toolbar;
 import cc.winboll.studio.aes.R;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.models.APPInfo;
 import cc.winboll.studio.libappbase.views.AboutView;
 
 /**
  * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
- * @Date 2026/01/11 15:16
+ * @Date 2026/01/13 11:25
  * @Describe 应用介绍窗口
  */
-public class AboutActivity extends Activity {
+public class AboutActivity extends BaseWinBoLLActivity {
 
     public static final String TAG = "AboutActivity";
+	
+	private Toolbar mToolbar;
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
@@ -24,21 +31,33 @@ public class AboutActivity extends Activity {
         setContentView(R.layout.activity_about);
 
 		// 设置工具栏
-        Toolbar toolbar = findViewById(R.id.toolbar);
+        initToolbar();
-		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

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

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

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

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

@@ -6,7 +6,7 @@
 	android:layout_width="match_parent"
 	android:layout_height="match_parent">
 
-	<android.widget.Toolbar
+	<cc.winboll.studio.libaes.views.ASupportToolbar
 		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 Jan 13 03:23:34 HKT 2026
+#Tue Apr 28 17:08:30 HKT 2026
-stageCount=5
+stageCount=22
 libraryProject=libappbase
 baseVersion=15.15
-publishVersion=15.15.4
+publishVersion=15.15.21
 buildCount=0
-baseBetaVersion=15.15.5
+baseBetaVersion=15.15.22

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,6 +16,17 @@
             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>
@@ -30,6 +41,17 @@
 
         </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,17 +23,8 @@ public class AboutActivity extends Activity {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_about);
 
-		// 设置工具栏
         Toolbar toolbar = findViewById(R.id.toolbar);
-		setActionBar(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());
@@ -43,10 +34,10 @@ public class AboutActivity extends Activity {
         LogUtils.d(TAG, "genDefaultAppInfo() 调用");
         String branchName = "appbase";
         APPInfo appInfo = new APPInfo();
-        appInfo.setAppName(getString(R.string.app_name));
+        appInfo.setAppName("APPBase");
         appInfo.setAppIcon(R.drawable.ic_winboll);
         appInfo.setAppDescription(getString(R.string.app_description));
-        appInfo.setAppGitName("APPBase");
+        appInfo.setAppGitName("WinBoLL");
         appInfo.setAppGitOwner("Studio");
         appInfo.setAppGitAPPBranch(branchName);
         appInfo.setAppGitAPPSubProjectFolder(branchName);

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

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

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

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

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

@@ -10,6 +10,7 @@ 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;
@@ -36,13 +37,28 @@ 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";
+	}
 
     /**
      * 创建菜单时回调（加载工具栏菜单）
@@ -87,14 +103,17 @@ public class MainActivity extends Activity {
         }
     }
 
+    public void onLogTestNewTask(View view) {
+        LogActivity.startLogActivity(this, true);
+    }
+
     /**
      * 日志测试按钮点击事件（打开日志查看界面）
      * 启动 LogActivity，用于查看应用运行日志
      * @param view 触发事件的 View（对应布局中的日志测试按钮）
      */
     public void onLogTest(View view) {
-        // 启动日志查看 Activity（通过静态方法传入上下文，简化跳转逻辑）
+        LogActivity.startLogActivity(this, false);
-        LogActivity.startLogActivity(this);
     }
 
     /**
@@ -136,12 +155,41 @@ public class MainActivity extends Activity {
         // 启动意图（唤起浏览器）
         context.startActivity(intent);
     }
-	
+
 	public void onAboutActivity(View view) {
-        LogUtils.d(TAG, "startAboutActivity() 调用");
+        LogUtils.d(TAG, "onAboutActivity() 调用");
         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

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

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

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

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

@@ -23,6 +23,18 @@
 			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"
@@ -47,6 +59,18 @@
 				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"
@@ -62,18 +86,29 @@
 			<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="onAboutActivity"
+				android:onClick="onSplitScreenMode"
 				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>
 
 	</ScrollView>
 
-</LinearLayout>
+</LinearLayout>
-

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

@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout
 	xmlns:android="http://schemas.android.com/apk/res/android"
-	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:orientation="vertical"
 	android:layout_width="match_parent"
 	android:layout_height="match_parent"
-	android:id="@+id/ll_notification">
+	android:gravity="center"
+	android:background="@android:color/white">
 
 	<TextView
 		android:layout_width="wrap_content"
 		android:layout_height="wrap_content"
-		android:text="Text"
+		android:text="Main2Activity"
-		android:id="@+id/info_tv"/>
+		android:textSize="24sp"
-
+		android:textColor="@color/gray_900"/>
-</LinearLayout>
 
+</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,6 +1,15 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 buildscript {
     repositories {
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+		
         mavenLocal {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
@@ -11,19 +20,6 @@ buildscript {
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
         // "WinBoLL Snapshot"
         maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
-        
-        maven { url 'https://maven.aliyun.com/repository/public/' } 
-        maven { url 'https://maven.aliyun.com/repository/google/' }
-        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
-        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
-        maven { url "https://clojars.org/repo/" }
-        maven { url "https://jitpack.io" }
-        mavenCentral()
-        google()
-        //println "mavenLocal : ==========="
-        //println mavenLocal().url
-        //println "mavenLocal : ==========="
-        //mavenLocal()
     }
     dependencies {
 	    // 适配MIUI12
@@ -35,6 +31,15 @@ buildscript {
 
 allprojects {
     repositories {
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+		
         mavenLocal {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
@@ -45,19 +50,6 @@ allprojects {
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
         // "WinBoLL Snapshot"
         maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
-        
-        maven { url 'https://maven.aliyun.com/repository/public/' } 
-        maven { url 'https://maven.aliyun.com/repository/google/' }
-        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
-        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
-        maven { url "https://clojars.org/repo/" }
-        maven { url "https://jitpack.io" }
-        mavenCentral()
-        google()
-        //println "mavenLocal : ==========="
-        //println mavenLocal().url
-        //println "mavenLocal : ==========="
-        //mavenLocal()
     }
     ext {
         // 定义全局变量，常用于版本管理
@@ -104,8 +96,8 @@ allprojects {
         // 1. 对纯 Java 模块的 JavaCompile 任务配置（升级为 Java 11）
         tasks.withType(JavaCompile) {
             options.compilerArgs << "-parameters"
-            sourceCompatibility = JavaVersion.VERSION_11
+            sourceCompatibility = JavaVersion.VERSION_1_7
-            targetCompatibility = JavaVersion.VERSION_11
+            targetCompatibility = JavaVersion.VERSION_1_7
             // 可选：确保编码一致
             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.3'
+    api 'cc.winboll.studio:libappbase:15.15.19'
 	// 备用库 jitpack.io 地址
 	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.3'
 	

libaes/build.properties

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

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

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

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

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

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

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

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

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

libappbase/build.gradle

@@ -21,5 +21,14 @@ 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 Jan 13 03:23:17 HKT 2026
+#Tue Apr 28 17:08:04 HKT 2026
-stageCount=5
+stageCount=22
 libraryProject=libappbase
 baseVersion=15.15
-publishVersion=15.15.4
+publishVersion=15.15.21
 buildCount=0
-baseBetaVersion=15.15.5
+baseBetaVersion=15.15.22

libappbase/src/main/AndroidManifest.xml

@@ -3,7 +3,21 @@
     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"
@@ -24,12 +38,15 @@
             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>
+</manifest>

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

@@ -2,6 +2,7 @@ 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;
@@ -26,6 +27,12 @@ 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）
@@ -53,7 +60,7 @@ public class GlobalApplication extends Application {
         }
         // 将调试状态封装为 APPModel 并保存到文件
         APPModel.saveBeanToFile(
-            getAppModelFilePath(application), 
+            getAppModelFilePath(application),
             new APPModel(isDebugging)
         );
     }
@@ -75,6 +82,42 @@ public class GlobalApplication extends Application {
     public static boolean isDebugging() {
         return isDebugging;
     }
+	
+	// 新增：设置 WinBoLL 服务器主机地址（同时保存到 SP 持久化）
+	public static void setWinbollHost(String host) {
+		if (sInstance == null) {
+			LogUtils.e(TAG, "setWinbollHost: 应用未初始化，设置失败");
+			return;
+		}
+		// 检查并补全末尾 /  核心改动
+		if (host != null && !host.isEmpty() && !host.endsWith("/")) {
+			host += "/";
+		}
+		// 更新内存中的字段
+		winbollHost = host;
+		// 保存到 SP 持久化（私有模式，安全）
+		SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+		sp.edit().putString(SP_KEY_WINBOLL_HOST, host).apply();
+		LogUtils.d(TAG, "setWinbollHost: 服务器地址已设置并持久化，host=" + host);
+	}
+	
+
+    // 新增：获取 WinBoLL 服务器主机地址（优先内存，内存为空则从 SP 读取）
+    public static String getWinbollHost() {
+        if (winbollHost != null) {
+            // 内存中存在，直接返回（提高效率）
+            return winbollHost;
+        }
+        if (sInstance == null) {
+            LogUtils.e(TAG, "getWinbollHost: 应用未初始化，获取失败");
+            return null;
+        }
+        // 内存中不存在，从 SP 读取并更新到内存
+        SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        winbollHost = sp.getString(SP_KEY_WINBOLL_HOST, "https://console.winboll.cc/");
+        LogUtils.d(TAG, "getWinbollHost: 从 SP 读取服务器地址，host=" + winbollHost);
+        return winbollHost;
+    }
 
     /**
      * 应用启动时初始化（仅执行一次）
@@ -85,12 +128,13 @@ public class GlobalApplication extends Application {
         super.onCreate();
         // 初始化单例实例（确保在所有初始化操作前完成）
         sInstance = this;
-		
 
         // 初始化基础组件（日志、崩溃处理、Toast）
         initCoreComponents();
         // 恢复/初始化调试模式状态（从本地文件读取，无文件则默认关闭调试）
         restoreDebugStatus();
+        // 新增：初始化服务器地址（从 SP 读取到内存，提高后续访问效率）
+        initWinbollHost();
 
         LogUtils.d(TAG, "GlobalApplication 初始化完成，单例实例已创建");
     }
@@ -115,7 +159,7 @@ public class GlobalApplication extends Application {
     private void restoreDebugStatus() {
         // 从文件加载 APPModel 实例（存储调试状态的模型类）
         APPModel appModel = APPModel.loadBeanFromFile(
-            getAppModelFilePath(this), 
+            getAppModelFilePath(this),
             APPModel.class
         );
 
@@ -131,6 +175,11 @@ public class GlobalApplication extends Application {
         }
     }
 
+    // 新增：初始化服务器地址（应用启动时从 SP 读取到内存）
+    private void initWinbollHost() {
+        getWinbollHost(); // 触发从 SP 读取并更新内存
+    }
+
     /**
      * 获取应用名称（从 AndroidManifest.xml 的 android:label 读取）
      * @param context 上下文（建议传入 Application 上下文，避免内存泄漏）
@@ -154,7 +203,7 @@ public class GlobalApplication extends Application {
             return appName;
         } catch (NameNotFoundException e) {
             // 包名不存在（理论上不会发生，捕获异常避免崩溃）
-			LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
             //LogUtils.e(TAG, "获取应用名称失败：包名不存在", e);
             e.printStackTrace();
         }
@@ -170,7 +219,6 @@ public class GlobalApplication extends Application {
         // 释放单例引用（可选，避免内存泄漏风险）
         sInstance = null;
         LogUtils.d(TAG, "GlobalApplication 终止，单例实例已释放");
-		
     }
 }
 

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

@@ -1,8 +1,11 @@
 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;
@@ -46,20 +49,39 @@ public class LogActivity extends Activity {
      * @param context 上下文（Activity/Fragment），用于启动 Activity
      */
     public static void startLogActivity(Context context) {
-        // 创建启动当前 Activity 的 Intent
+        startLogActivity(context, true);
+    }
+
+    /**
+     * 启动日志 Activity 的静态方法重载（外部调用入口）
+     * @param context 上下文（Activity/Fragment），用于启动 Activity
+     * @param newTask 是否在新窗口中启动
+     */
+    public static void startLogActivity(Context context, boolean newTask) {
         Intent intent = new Intent(context, LogActivity.class);
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
 
-        // 添加 Intent 标志：支持分屏/多窗口模式（API 24+）
+        if (newTask) {
-        intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
-        // 添加 Intent 标志：创建新任务栈（避免并入调用者任务栈）
+            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
-        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            context.startActivity(intent);
-        // 添加 Intent 标志：标记为新文档（多任务窗口中独立显示）
+        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
-        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
-        // 添加 Intent 标志：允许创建多个任务实例（支持多次启动独立窗口）
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
-        intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
 
-        // 启动 Activity
+            Rect bounds = new Rect();
-        context.startActivity(intent);
+            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,10 +100,52 @@ 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

@@ -0,0 +1,186 @@
+package cc.winboll.studio.libappbase.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.graphics.Color;
+import android.os.Bundle;
+import android.widget.EditText;
+import android.widget.TextView;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.utils.APPUtils;
+import cc.winboll.studio.libappbase.utils.ApkSignUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-20 21:20:00
+ * @LastEditTime 2026-01-24 18:45:00
+ * @Describe 签名显示+正版校验对话框：展示应用签名字节位信息，调用网络接口完成正版合法性校验，实时返回校验结果
+ */
+public class APPValidationDialog extends Dialog {
+    // ===================================== 全局常量 =====================================
+    public static final String TAG = "AppValidationDialog";
+    // 签名字节位分组大小
+    private static final int BIT_GROUP_SIZE = 16;
+
+    // ===================================== 控件与上下文属性 =====================================
+    private Context mContext;
+    private EditText etSignFingerprint;
+    private TextView tvAuthResult;
+
+    // ===================================== 业务入参属性 =====================================
+    private String 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

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

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

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

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

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

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

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

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

@@ -0,0 +1,199 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.Base64;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.SignCheckResponse;
+
+import com.google.gson.Gson;
+
+import java.io.IOException;
+import java.net.URLEncoder;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-20 19:17:00
+ * @LastEditTime 2026-01-24 17:58:00
+ * @Describe APPUtils 应用合法性校验工具类（OKHTTP网络校验版，兼容Java7）
+ * 对外传入签名/哈希值，拼接调试标识后发起网络校验，主线程返回校验结果
+ */
+public class APPUtils {
+    // ===================================== 全局常量/单例属性 =====================================
+    public static final String TAG = "APPUtils";
+    // 网络校验接口基础地址
+    private static final String CHECK_API_URI = "api/app-signatures-check";
+    // OKHTTP客户端单例（复用连接，避免资源浪费）
+    private static final OkHttpClient sOkHttpClient = new OkHttpClient();
+    // Gson解析单例（全局复用，提高解析效率）
+    private static final Gson sGson = new Gson();
+
+    // ===================================== 对外核心校验方法 =====================================
+    /**
+     * 检查应用合法性（外部传入签名+哈希，拼接调试标识发起网络校验）
+     * @param context      上下文，用于主线程回调
+     * @param projectName  项目名称（服务端区分项目标识）
+     * @param versionName  应用版本名（服务端版本校验）
+     * @param clientSign   外部计算的应用签名字符串（Base64）
+     * @param clientHash   外部计算的APK SHA256哈希字符串（小写16进制）
+     * @param callback     校验结果回调（主线程调用，返回是否合法+提示信息）
+     */
+    public void checkAPKValidation(Context context, String 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

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

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

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

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

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

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

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

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

@@ -8,6 +8,7 @@ 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;
@@ -16,163 +17,204 @@ 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>
- * @Date 2026/01/11 12:23:00
+ * @CreateTime 2026-01-11 12:23:00
- * @LastEditTime 2026/01/12 01:05:30
+ * @LastEditTime 2026-01-24 20:50:00
+ * @Describe AboutView 原生实现关于页面，无第三方依赖，适配API30；抽象通用功能控件（邮件/网页跳转），支持调试工具入口动态显隐，集成应用正版校验、调试地址配置弹窗
  */
 public class AboutView extends LinearLayout {
-    // 全局常量区（标识、回调标识）
+    // ===================================== 全局常量 =====================================
     public static final String TAG = "AboutView";
     public static final int MSG_APPUPDATE_CHECKED = 0;
 
-    // 固定链接常量
+    // 固定链接/邮件常量
     private static final String WINBOLL_OFFICIAL_HOME = "https://www.winboll.cc";
-    // 邮件相关常量（统一封装，便于维护）
     private static final String EMAIL_TITLE = "联系WinBoLLStudio";
     private static final String EMAIL_ADDRESS = "studio@winboll.cc";
     private static final String EMAIL_TYPE = "message/rfc822";
 
-    // 布局尺寸常量（统一管理，适配多屏幕，dp为基准单位）
+    // 布局尺寸常量（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 Context mContext;                    // 上下文对象，全局复用
+    private static final String SERVER_DEBUG_HOST = "https://yun-preivew.winboll.cc";
-    private APPInfo mAPPInfo;                    // 应用核心信息实体
+    private static final String SERVER_RELEASE_HOST = "https://yun.winboll.cc";
-    private OnRequestDevUserInfoAutofillListener mOnRequestDevUserInfoAutofillListener;  // 调试信息填充监听
 
-    private String mszAppName = "";              // 应用名称
+    // ===================================== 核心成员属性 =====================================
-    private String mszAppVersionName = "";       // 应用版本号
+    // 上下文与业务实体
-    private String mszAppDescription = "";       // 应用描述文案
+    private Context mContext;
-    private String mszHomePage = "";             // 应用主页/APK下载地址
+    private APPInfo mAPPInfo;
-    private String mszGitea = "";                // 应用Git源码地址
+    private OnRequestDevUserInfoAutofillListener mOnRequestDevUserInfoAutofillListener;
-    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) 构造调用，入参APPInfo：" + (appInfo == null ? "null" : appInfo.getAppName()));
+//        LogUtils.d(TAG, "AboutView(Context,APPInfo)：传入应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
-        this.mContext = context;
+//        this.mContext = context;
-        this.mAPPInfo = appInfo;
+//        this.mAPPInfo = appInfo;
-        initAll();
+//        initViewFromXml();
-    }
+//        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() 调用，传入新APPInfo：" + (appInfo == null ? "null" : appInfo.getAppName()));
+//        LogUtils.d(TAG, "setAPPInfoAndInit()：重置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
-        this.mAPPInfo = appInfo;
+//        this.mAPPInfo = appInfo;
-        removeAllViews();
+//        if (llFunctionContainer != null) llFunctionContainer.removeAllViews();
-        initAll();
+//        initAll();
-        LogUtils.d(TAG, "setAPPInfoAndInit() 应用信息重置+页面重构完成");
+//        LogUtils.d(TAG, "setAPPInfoAndInit()：应用信息重置+页面重构完成");
-    }
+//    }
 
     /**
-     * 设置应用信息（兼容旧调用逻辑），设置后自动重构页面
+     * 设置应用信息，兼容旧调用逻辑，设置后自动重构页面
      * @param appInfo 应用核心信息实体
      */
     public void setAPPInfo(APPInfo appInfo) {
-        LogUtils.d(TAG, "setAPPInfo() 调用，传入APPInfo：" + (appInfo == null ? "null" : appInfo.getAppName()));
+        LogUtils.d(TAG, "setAPPInfo()：设置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
         this.mAPPInfo = appInfo;
-        removeAllViews();
+        if (llFunctionContainer != null) llFunctionContainer.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() ? "https://yun-preivew.winboll.cc" : "https://yun.winboll.cc";
+        mszWinBoLLServerHost = GlobalApplication.isDebugging() ? SERVER_DEBUG_HOST : SERVER_RELEASE_HOST;
-        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();
@@ -180,44 +222,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.d(TAG, "initAppVersionInfo() 获取版本号失败，默认赋值unknown", e);
+            LogUtils.e(TAG, "initAPPVersionInfo()：获取版本号失败，默认赋值unknown", e);
             mszAppVersionName = "unknown";
         }
-        mszCurrentAppPackageName = String.format("%s_%s.apk", mszAppAPKName, mszAppVersionName);
+        mszCurrentAppPackageName = String.format("%s_%s.apk", mszAppVersionName, 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 {
@@ -225,102 +267,98 @@ 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.d(TAG, "initReleaseAPKInfo() 获取正式版版本号失败", e);
+            LogUtils.e(TAG, "initReleaseAPKInfo()：获取正式版版本号失败", e);
         }
         mszReleaseAPKName = String.format("%s_%s.apk", mszAppAPKName, szReleaseAppVersionName);
-        LogUtils.d(TAG, "initReleaseAPKInfo() 完成，正式版APK名：" + mszReleaseAPKName);
+        LogUtils.d(TAG, "initReleaseAPKInfo()：正式版APK信息初始化完成，APK名=" + mszReleaseAPKName);
     }
 
     /**
-     * 核心视图组装：按 图标→应用信息→分割线→通用功能控件 顺序构建页面
+     * 核心视图组装：赋值基础信息到控件，添加通用功能项到容器
      */
     private void initAboutPageView() {
-        LogUtils.d(TAG, "initAboutPageView() 开始组装关于页视图");
+        LogUtils.d(TAG, "initAboutPageView()：开始组装关于页视图");
-        addAppIcon();
+        // 赋值基础信息
-        addAppInfoDesc();
+        ivAppIcon.setImageResource(mnAppIcon);
-        addLineSeparator();
+        tvAppNameVersion.setText(String.format("%s %s", mszAppName, mszAppVersionName));
-
+        if (mszAppDescription.isEmpty()) {
-        // 通用功能控件：网页跳转类+邮件类，复用抽象控件
+            tvAppDesc.setVisibility(GONE);
-        addView(new WebJumpFunctionItemView(mContext, "WinBoLL 主页", WINBOLL_OFFICIAL_HOME, R.drawable.ic_winboll));
+        } else {
-        addView(new EmailFunctionItemView(mContext, "联系邮箱", "WinBoLLStudio<studio@winboll.cc>", R.drawable.ic_winboll));
+            tvAppDesc.setVisibility(VISIBLE);
+            tvAppDesc.setText(mszAppDescription);
+        }
+        // 添加通用功能项
+        addFunctionView(new WebJumpFunctionItemView(mContext, "WinBoLL 主页", WINBOLL_OFFICIAL_HOME, R.drawable.ic_winboll));
+        addFunctionView(new EmailFunctionItemView(mContext, "联系邮箱", "WinBoLLStudio<studio@winboll.cc>", R.drawable.ic_winboll));
         if (!mszHomePage.isEmpty()) {
-            addView(new WebJumpFunctionItemView(mContext, "应用APK下载地址", mszHomePage, R.drawable.ic_winboll));
+            addFunctionView(new WebJumpFunctionItemView(mContext, "应用APK下载地址", mszHomePage, R.drawable.ic_winboll));
         }
         if (!mszGitea.isEmpty()) {
-            addView(new WebJumpFunctionItemView(mContext, "应用Git源码地址", mszGitea, R.drawable.ic_winboll));
+            addFunctionView(new WebJumpFunctionItemView(mContext, "应用Git源码地址", mszGitea, R.drawable.ic_winboll));
         }
-        LogUtils.d(TAG, "initAboutPageView() 视图组装完成，功能项加载完毕");
+        LogUtils.d(TAG, "initAboutPageView()：视图组装完成，功能项加载完毕");
     }
 
-    // 视图构建辅助方法区（基础视图组件）
+    // ===================================== 内部工具/事件方法 =====================================
     /**
-     * 添加应用图标组件，居中展示
+     * 绑定功能按钮点击事件，处理正版校验、调试地址配置弹窗唤起
      */
-    private void addAppIcon() {
+    private void setBtnClickListener() {
-        ImageView ivIcon = new ImageView(mContext);
+        LogUtils.d(TAG, "setBtnClickListener()：开始绑定功能按钮点击事件");
-        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(dp2px(ICON_SIZE), dp2px(ICON_SIZE));
+        // 取消调试状态按钮
-        params.bottomMargin = dp2px(PADDING_MID);
+        ibSebugStepOver.setOnClickListener(new OnClickListener() {
-        ivIcon.setLayoutParams(params);
+				@Override
-        ivIcon.setImageResource(mnAppIcon);
+				public void onClick(View v) {
-        ivIcon.setScaleType(ImageView.ScaleType.CENTER_CROP);
+					LogUtils.d(TAG, "ibSebugStepOver onClick：取消调试状态按钮已点击");
-        addView(ivIcon);
+					GlobalApplication.setIsDebugging(false);
+					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 addAppInfoDesc() {
+    private void addFunctionView(View view) {
-        LinearLayout llDesc = new LinearLayout(mContext);
+        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
-        llDesc.setOrientation(VERTICAL);
+        params.topMargin = 0;
-        llDesc.setGravity(Gravity.CENTER);
+        llFunctionContainer.addView(view, params);
-        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);
     }
 
     /**
-     * 添加视图分割线，区分不同功能模块
+     * dp转px工具方法，适配不同屏幕密度，保证布局一致性
-     */
-    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单位尺寸
      * @return 转换后的px单位尺寸
      */
@@ -335,17 +373,20 @@ 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;
@@ -363,17 +404,32 @@ 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);
-            setBackgroundResource(android.R.drawable.list_selector_background);
+            setBackground(create_item_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) {
@@ -384,20 +440,17 @@ 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);
@@ -407,11 +460,17 @@ 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);
@@ -424,36 +483,37 @@ 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, "邮件唤起成功：系统纯邮件客户端");
+                LogUtils.d(TAG, "EmailFunctionItemView：纯邮件客户端唤起成功");
                 return;
             }
-
+            // 方案2：通用邮件应用兜底
             Intent fallbackIntent = new Intent(Intent.ACTION_SEND);
             fallbackIntent.setType(EMAIL_TYPE);
             fallbackIntent.putExtra(Intent.EXTRA_EMAIL, new String[]{EMAIL_ADDRESS});
             fallbackIntent.putExtra(Intent.EXTRA_SUBJECT, EMAIL_TITLE);
             fallbackIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-
             if (fallbackIntent.resolveActivity(mItemContext.getPackageManager()) != null) {
                 mItemContext.startActivity(fallbackIntent);
-                LogUtils.d(TAG, "邮件唤起成功：通用邮件应用");
+                LogUtils.d(TAG, "EmailFunctionItemView：通用邮件应用唤起成功");
             } else {
                 ToastUtils.show("未找到可发送邮件的应用");
-                LogUtils.w(TAG, "邮件唤起失败：无可用邮件相关应用");
+                LogUtils.w(TAG, "EmailFunctionItemView：邮件唤起失败，无可用邮件应用");
             }
         }
     }
 
-    // 网页跳转类功能控件 - 专属网页跳转逻辑
+    // ===================================== 内部网页跳转功能项子类 =====================================
+    /**
+     * 网页跳转类功能控件，实现专属网页唤起逻辑，包含空地址校验、异常捕获
+     */
     private class WebJumpFunctionItemView extends BaseFunctionItemView {
         public WebJumpFunctionItemView(Context context, String title, String content, int iconRes) {
             super(context, title, content, iconRes);
@@ -466,25 +526,28 @@ 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, "网页跳转失败：地址为空");
+                LogUtils.w(TAG, "WebJumpFunctionItemView：网页跳转失败，地址为空");
                 return;
             }
             try {
                 Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(mContent));
                 browserIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                 mItemContext.startActivity(browserIntent);
-                LogUtils.d(TAG, "网页跳转成功");
+                LogUtils.d(TAG, "WebJumpFunctionItemView：网页跳转成功");
             } catch (Exception e) {
-                LogUtils.d(TAG, "网页跳转失败，异常捕获", e);
+                LogUtils.e(TAG, "WebJumpFunctionItemView：网页跳转失败", e);
                 ToastUtils.show("链接无法打开");
             }
         }
     }
 
-    // 内部接口区（置于类末尾，逻辑闭环）
+    // ===================================== 内部回调接口 =====================================
+    /**
+     * 调试信息自动填充回调接口
+     */
     public interface OnRequestDevUserInfoAutofillListener {
         void requestAutofill(EditText etDevUserName, EditText etDevUserPassword);
     }

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

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

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

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

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M19,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/ic_key.xml

@@ -6,6 +6,6 @@
     android:viewportWidth="24">
     <path
         android:fillColor="#ff000000"
-        android:pathData="M14,3.23V5.29C16.89,6.15 19,8.83 19,12C19,15.17 16.89,17.84 14,18.7V20.77C18,19.86 21,16.28 21,12C21,7.72 18,4.14 14,3.23M16.5,12C16.5,10.23 15.5,8.71 14,7.97V16C15.5,15.29 16.5,13.76 16.5,12M3,9V15H7L12,20V4L7,9H3Z"/>
+        android:pathData="M7,14C5.9,14 5,13.1 5,12S5.9,10 7,10 9,10.9 9,12 8.1,14 7,14M12.6,10C11.8,7.7 9.6,6 7,6C3.7,6 1,8.7 1,12S3.7,18 7,18C9.6,18 11.8,16.3 12.6,14H16V18H20V14H23V10H12.6Z"/>
 
-</vector>
+</vector>

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

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

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

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

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

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

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

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

@@ -11,5 +11,10 @@
         <item name="colorText">#FF00B322</item>
         <item name="colorTextBackgound">#FF000000</item>
 	</style>
+	
+	<style name="DialogStyle" parent="@android:style/Theme.Dialog">
+		<item name="android:windowBackground">@android:color/transparent</item>
+		<item name="android:windowNoTitle">true</item>
+	</style>
 
 </resources>

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

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

libwinboll/build.gradle

@@ -0,0 +1,34 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        minSdkVersion 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'
+
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}

libwinboll/build.properties

@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Sat May 09 21:21:56 CST 2026
+stageCount=27
+libraryProject=libwinboll
+baseVersion=15.11
+publishVersion=15.11.26
+buildCount=24
+baseBetaVersion=15.11.27

libwinboll/proguard-rules.pro

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

libwinboll/src/main/AndroidManifest.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.libwinboll" >
+
+    <application>
+        <activity
+            android:name=".LibraryActivity"
+            android:label="@string/lib_name" >
+        </activity>
+    </application>
+
+</manifest>
+

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

@@ -0,0 +1,14 @@
+package cc.winboll.studio.libwinboll;
+
+import android.app.*;
+import android.os.*;
+
+public class LibraryActivity extends Activity 
+{
+    @Override
+    protected void onCreate(Bundle savedInstanceState)
+    {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.library);
+    }
+}

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

@@ -0,0 +1,11 @@
+<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:text="@string/hello_world"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content" />
+
+</LinearLayout>

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

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

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

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

powerbell/README.md

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

@@ -1 +0,0 @@
-

powerbell/build.gradle

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

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

@@ -1,279 +0,0 @@
-#!/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

@@ -1,143 +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:
-
-# ============================== 基础通用规则 ==============================
-# 保留系统组件
--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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,120 +0,0 @@
-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: 提醒通知发送流程执行完毕");
-    }
-}
-