<powerbell>APK 15.11.10 release Publish.

.winboll/winboll_app_build.gradle

@@ -28,12 +28,17 @@ android {
         }
     }
     buildTypes {
-        release {
-            signingConfig signingConfigs.winboll
-        }
         debug {
-            signingConfig signingConfigs.winboll
-        }
+			 signingConfig signingConfigs.winboll
+         }
+        release {
+			 signingConfig signingConfigs.winboll
+             minifyEnabled true // 开启混淆（核心开关）
+             shrinkResources true // 可选：移除无用资源（进一步减小体积）
+             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), // 官方默认规则（优化版）
+                          'proguard-rules.pro' // 自定义规则文件
+         }
+		 
     }
     
     flavorDimensions "WinBoLLApp"
@@ -71,6 +76,7 @@ android {
         // 2. 配置 Beta Debug 版应用包输出
 	    //
         if((variant.flavorName == "beta" && variant.buildType.name == "debug")
+        || (variant.flavorName == "beta" && variant.buildType.name == "release")
         || (variant.flavorName == "stage" && variant.buildType.name == "debug")
         || (variant.flavorName == "stage" && variant.buildType.name == "release")) {
             println "Project root directory: " + project.rootDir.toString()

aes/build.gradle

@@ -18,18 +18,22 @@ def genVersionName(def versionName){
 }
 
 android {
-    compileSdkVersion 32
-    buildToolsVersion "32.0.0"
+
+    // 1. compileSdkVersion：必须 ≥ targetSdkVersion，建议直接等于 targetSdkVersion（30）
+    compileSdkVersion 30
+
+    // 2. buildToolsVersion：需匹配 compileSdkVersion，建议使用 30.x.x 最新稳定版（无需高于 compileSdkVersion）
+    buildToolsVersion "30.0.3" // 这是 30 对应的最新稳定版，避免使用 beta 版
 
     defaultConfig {
         applicationId "cc.winboll.studio.aes"
-        minSdkVersion 24
+        minSdkVersion 23
         targetSdkVersion 30
         versionCode 1
         // versionName 更新后需要手动设置 
         // 项目模块目录的 build.gradle 文件的 stageCount=0
         // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
-        versionName "15.10" 
+        versionName "15.11" 
         if(true) {
             versionName = genVersionName("${versionName}")
         }

aes/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Mon Sep 29 13:04:18 HKT 2025
-stageCount=3
+#Wed Nov 19 09:04:33 HKT 2025
+stageCount=5
 libraryProject=libaes
-baseVersion=15.10
-publishVersion=15.10.2
+baseVersion=15.11
+publishVersion=15.11.4
 buildCount=0
-baseBetaVersion=15.10.3
+baseBetaVersion=15.11.5

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

@@ -8,8 +8,7 @@ package cc.winboll.studio.aes;
 import android.view.Gravity;
 import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
 import cc.winboll.studio.libappbase.GlobalApplication;
-import com.hjq.toast.ToastUtils;
-import com.hjq.toast.style.WhiteToastStyle;
+import cc.winboll.studio.libappbase.ToastUtils;
 
 
 public class App extends GlobalApplication {
@@ -19,15 +18,16 @@ public class App extends GlobalApplication {
     @Override
     public void onCreate() {
         super.onCreate();
+		setIsDebugging(BuildConfig.DEBUG);
 		WinBoLLActivityManager.init(this);
 
         // 初始化 Toast 框架
         ToastUtils.init(this);
-        // 设置 Toast 布局样式
-        //ToastUtils.setView(R.layout.view_toast);
-        ToastUtils.setStyle(new WhiteToastStyle());
-        ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
-
     }
 
+	@Override
+	public void onTerminate() {
+		super.onTerminate();
+		ToastUtils.release();
+	}
 }

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

@@ -91,8 +91,8 @@ public class MainActivity extends DrawerFragmentActivity implements IWinBoLLActi
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
         getMenuInflater().inflate(R.menu.toolbar_library, menu);
-        if(App.isDebuging()) {
-            getMenuInflater().inflate(cc.winboll.studio.libapputils.R.menu.toolbar_studio_debug, menu);
+        if(App.isDebugging()) {
+            getMenuInflater().inflate(cc.winboll.studio.libaes.R.menu.toolbar_studio_debug, menu);
         }
         return super.onCreateOptionsMenu(menu);
     }

appbase/build.gradle

@@ -19,29 +19,31 @@ def genVersionName(def versionName){
 
 android {
     
-    compileSdkVersion 32
-    buildToolsVersion "32.0.0"
+    // 1. compileSdkVersion：必须 ≥ targetSdkVersion，建议直接等于 targetSdkVersion（30）
+    compileSdkVersion 30
+
+    // 2. buildToolsVersion：需匹配 compileSdkVersion，建议使用 30.x.x 最新稳定版（无需高于 compileSdkVersion）
+    buildToolsVersion "30.0.3" // 这是 30 对应的最新稳定版，避免使用 beta 版
 
     defaultConfig {
         applicationId "cc.winboll.studio.appbase"
-        minSdkVersion 24
+        minSdkVersion 23
         targetSdkVersion 30
         versionCode 1
         // versionName 更新后需要手动设置 
         // .winboll/winbollBuildProps.properties 文件的 stageCount=0
         // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
-        versionName "15.10"
+        versionName "15.11"
         if(true) {
             versionName = genVersionName("${versionName}")
         }
     }
-
-    buildTypes {
-        release {
-            minifyEnabled false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
-        }
-    }
+	
+     // 确保 Java 7 兼容性（已适配项目技术栈）
+     compileOptions {
+         sourceCompatibility JavaVersion.VERSION_1_7
+         targetCompatibility JavaVersion.VERSION_1_7
+     }
 }
 
 dependencies {

appbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Fri Sep 26 05:36:14 HKT 2025
-stageCount=9
+#Fri Nov 21 11:41:04 HKT 2025
+stageCount=2
 libraryProject=libappbase
-baseVersion=15.10
-publishVersion=15.10.8
+baseVersion=15.11
+publishVersion=15.11.1
 buildCount=0
-baseBetaVersion=15.10.9
+baseBetaVersion=15.11.2

appbase/proguard-rules.pro

@@ -15,3 +15,112 @@
 #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
 #   public *;
 #}
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（适配你的两个包名）
+#-keep public class * extends com.winboll.WinBoLLActivity
+#-keep public class * extends com.winboll.WinBoLLFragment
+# 主包名
+-keep class cc.winboll.studio.*.** { *; }
+# beta包名
+-keep class cc.winboll.studio.*.beta.** { *; }
+-keepclassmembers class cc.winboll.studio.*.** { *; }
+-keepclassmembers class cc.winboll.studio.*.beta.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架规则 ==============================
+# Retrofit + OkHttp
+-keep class retrofit2.** { *; }
+-keep interface retrofit2.** { *; }
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okio.** { *; }
+-keepclasseswithmembers class * {
+    @retrofit2.http.* <methods>;
+}
+
+# Glide 4.x
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-dontwarn com.bumptech.glide.load.resource.bitmap.VideoDecoder
+
+# GreenDAO 3.x
+-keepclassmembers class * extends org.greenrobot.greendao.AbstractDao {
+    public static java.lang.String TABLENAME;
+}
+-keep class **$Properties
+# 实体类包名（按实际调整）
+#-keep class cc.winboll.studio.appbase.model.** { *; }
+
+# ButterKnife 8.x
+-keep class butterknife.** { *; }
+-dontwarn butterknife.internal.**
+-keep class **$$ViewBinder { *; }
+-keepclasseswithmembernames class * {
+    @butterknife.BindView <fields>;
+    @butterknife.OnClick <methods>;
+}
+
+# EventBus 3.x
+-keepclassmembers class ** {
+    @org.greenrobot.eventbus.Subscribe <methods>;
+}
+-keep enum org.greenrobot.eventbus.ThreadMode { *; }
+
+# ============================== 优化与调试 ==============================
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+-optimizationpasses 5
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+# 保留行号（便于崩溃定位）
+-keepattributes SourceFile,LineNumberTable
+

appbase/src/main/AndroidManifest.xml

@@ -3,9 +3,6 @@
     xmlns:android="http://schemas.android.com/apk/res/android"
     package="cc.winboll.studio.appbase">
 	
-	<!-- 网络权限 -->
-	<uses-permission android:name="android.permission.INTERNET" />
-		
     <application
         android:name=".App"
         android:icon="@drawable/ic_winboll"

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

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

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

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

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

@@ -11,37 +11,57 @@
 		android:layout_height="wrap_content"
 		android:id="@+id/toolbar"/>
 
-	<LinearLayout
+	<ScrollView
 		android:layout_width="match_parent"
 		android:layout_height="0dp"
-		android:layout_weight="1"
-		android:orientation="vertical"
-		android:gravity="center_vertical"
-		android:spacing="12dp">
+		android:layout_weight="1.0">
 
-		<Button
+		<LinearLayout
 			android:layout_width="match_parent"
 			android:layout_height="wrap_content"
-			android:text="应用崩溃测试"
-			android:textSize="16sp"
-			android:textColor="@android:color/white"
-			android:background="#81C7F5"
-			android:paddingVertical="12dp"
-			android:layout_marginHorizontal="24dp"
-			android:onClick="onCrashTest"/>
+			android:orientation="vertical"
+			android:gravity="center_vertical"
+			android:spacing="12dp">
 
-		<Button
-			android:layout_width="match_parent"
-			android:layout_height="wrap_content"
-			android:text="应用日志测试"
-			android:textSize="16sp"
-			android:textColor="@android:color/white"
-			android:background="#81C7F5"
-			android:paddingVertical="12dp"
-			android:layout_marginHorizontal="24dp"
-			android:onClick="onLogTest"/>
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用崩溃测试"
+				android:textSize="16sp"
+				android:textColor="@android:color/white"
+				android:background="#81C7F5"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onCrashTest"
+				android:layout_margin="10dp"/>
 
-	</LinearLayout>
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试"
+				android:textSize="16sp"
+				android:textColor="@android:color/white"
+				android:background="#81C7F5"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用吐司测试"
+				android:textSize="16sp"
+				android:textColor="@android:color/white"
+				android:background="#81C7F5"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onToastUtilsTest"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
 
 </LinearLayout>
 

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

@@ -1,5 +1,4 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="app_name">AppBase</string>
-    <string name="tileservice_name">WinBoLL</string>
 </resources>

build.gradle

@@ -5,6 +5,16 @@ buildscript {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
         }
+		
+        //米盟通过maven接入时，要做如下配置
+        maven {
+            url "https://repos.xiaomi.com/maven"
+            credentials {
+                username 'mimo-developer'
+                password 'AKCp8ih1PFG9tV8qaLyws67dLGZi8udFM39SfsHgihN15cgsiRvHuxj8JzFmuZjaViVeNawaA'
+            }
+        }
+		
         // Nexus Maven 库地址
         // "WinBoLL Release"
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
@@ -40,6 +50,15 @@ allprojects {
             // 设置本地Maven仓库路径
             url 'file:///sdcard/.m2/repository/'
         }
+		
+        //米盟通过maven接入时，要做如下配置
+        maven {
+            url "https://repos.xiaomi.com/maven"
+            credentials {
+                username 'mimo-developer'
+                password 'AKCp8ih1PFG9tV8qaLyws67dLGZi8udFM39SfsHgihN15cgsiRvHuxj8JzFmuZjaViVeNawaA'
+            }
+        }
         
         // Nexus Maven 库地址
         // "WinBoLL Release"
@@ -117,4 +136,3 @@ task clean(type: Delete) {
     delete rootProject.buildDir
 }
 
-

libaes/build.gradle

@@ -4,11 +4,15 @@ apply from: '../.winboll/winboll_lib_build.gradle'
 apply from: '../.winboll/winboll_lint_build.gradle'
 
 android {
-    compileSdkVersion 32
-    buildToolsVersion "32.0.0"
+    
+    // 1. compileSdkVersion：必须 ≥ targetSdkVersion，建议直接等于 targetSdkVersion（30）
+    compileSdkVersion 30
+
+    // 2. buildToolsVersion：需匹配 compileSdkVersion，建议使用 30.x.x 最新稳定版（无需高于 compileSdkVersion）
+    buildToolsVersion "30.0.3" // 这是 30 对应的最新稳定版，避免使用 beta 版
 
     defaultConfig {
-        minSdkVersion 24
+        minSdkVersion 23
         targetSdkVersion 30
     }
     buildTypes {
@@ -20,13 +24,6 @@ android {
 }
 
 dependencies {
-    api fileTree(dir: 'libs', include: ['*.jar'])
-    api 'cc.winboll.studio:libapputils:15.10.2'
-	api 'cc.winboll.studio:libappbase:15.10.9'
-    
-    // 吐司类库
-    api 'com.github.getActivity:ToastUtils:10.5'
-    
     // 权限请求框架：https://github.com/getActivity/XXPermissions
     api 'com.github.getActivity:XXPermissions:18.63'
     // 下拉控件
@@ -52,4 +49,17 @@ dependencies {
     //api 'androidx.vectordrawable:vectordrawable:1.1.0'
     //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
     //api 'androidx.fragment:fragment:1.1.0'
+	
+	// 米盟
+	implementation 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    implementation 'androidx.recyclerview:recyclerview:1.0.0'
+    implementation 'com.google.code.gson:gson:2.8.5'
+    implementation 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+	
+	api 'cc.winboll.studio:libappbase:15.11.0'
+	
+    api fileTree(dir: 'libs', include: ['*.jar'])
 }

libaes/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Mon Sep 29 13:04:07 HKT 2025
-stageCount=3
+#Wed Nov 19 09:04:27 HKT 2025
+stageCount=5
 libraryProject=libaes
-baseVersion=15.10
-publishVersion=15.10.2
+baseVersion=15.11
+publishVersion=15.11.4
 buildCount=0
-baseBetaVersion=15.10.3
+baseBetaVersion=15.11.5

libaes/src/main/AndroidManifest.xml

@@ -1,9 +1,25 @@
 <?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.libaes">
 
-    <application>
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
+    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+    <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
+        tools:ignore="QueryAllPackagesPermission" />
+
+    <!-- 通过GPS得到精确位置 -->
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <!-- 通过网络得到粗略位置 -->
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+
+    <application
+		android:networkSecurityConfig="@xml/network_security_config"
+        android:usesCleartextTraffic="true"
+        tools:ignore="GoogleAppIndexingWarning">
 
         <activity
             android:name="cc.winboll.studio.libaes.unittests.SecondaryLibraryActivity"
@@ -33,6 +49,18 @@
             android:name="cc.winboll.studio.libaes.winboll.WinBoLLMail"
             android:exported="true"/>
 
+
+        <provider
+			android:name="androidx.core.content.FileProvider"
+			android:authorities="${applicationId}.fileprovider"
+			android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider" />
+
+        </provider>
+
     </application>
 
-</manifest>
+</manifest>

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

@@ -31,6 +31,9 @@ import cc.winboll.studio.libappbase.LogUtils;
 import com.baoyz.widget.PullRefreshLayout;
 import java.util.ArrayList;
 import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.ToastUtils;
 
 public abstract class DrawerFragmentActivity extends AppCompatActivity implements AdapterView.OnItemClickListener {
 
@@ -71,17 +74,22 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
     @Override
     protected void onDestroy() {
         super.onDestroy();
+		// 修复：释放广告资源，避免内存泄漏
+		ADsBannerView adsBannerView = findViewById(R.id.adsbanner);
+		if (adsBannerView != null) {
+			adsBannerView.releaseAdResources();
+		}
     }
 
     /*@Override
-    public Intent getIntent() {
-        // TODO: Implement this method
-        return super.getIntent();
-    }
+	 public Intent getIntent() {
+	 // TODO: Implement this method
+	 return super.getIntent();
+	 }
 
-    public Context getContext() {
-        return this.mContext;
-    }*/
+	 public Context getContext() {
+	 return this.mContext;
+	 }*/
 
     @Override
     public MenuInflater getMenuInflater() {
@@ -90,9 +98,9 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
     }
 
     /*public void setSubtitle(CharSequence context) {
-        // TODO: Implement this method
-        getSupportActionBar().setSubtitle(context);
-    }*/
+	 // TODO: Implement this method
+	 getSupportActionBar().setSubtitle(context);
+	 }*/
 
     @Override
     public void recreate() {
@@ -100,9 +108,9 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
     }
 
     /*@Override
-    public boolean moveTaskToBack(boolean nonRoot) {
-        return super.moveTaskToBack(nonRoot);
-    }*/
+	 public boolean moveTaskToBack(boolean nonRoot) {
+	 return super.moveTaskToBack(nonRoot);
+	 }*/
 
     @Override
     public void startActivity(Intent intent) {
@@ -115,24 +123,24 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
     }
 
     /*@Override
-    public FragmentManager getSupportFragmentManager() {
-        return super.getSupportFragmentManager();
-    }
+	 public FragmentManager getSupportFragmentManager() {
+	 return super.getSupportFragmentManager();
+	 }
 
-    public void setSubtitle(int resId) {
-        // TODO: Implement this method
-        getSupportActionBar().setSubtitle(resId);
-    }
+	 public void setSubtitle(int resId) {
+	 // TODO: Implement this method
+	 getSupportActionBar().setSubtitle(resId);
+	 }
 
-    public void setTitle(CharSequence context) {
-        // TODO: Implement this method
-        getSupportActionBar().setTitle(context);
-    }
+	 public void setTitle(CharSequence context) {
+	 // TODO: Implement this method
+	 getSupportActionBar().setTitle(context);
+	 }
 
-    public void setTitle(int resId) {
-        // TODO: Implement this method
-        getSupportActionBar().setTitle(resId);
-    }*/
+	 public void setTitle(int resId) {
+	 // TODO: Implement this method
+	 getSupportActionBar().setTitle(resId);
+	 }*/
 
     @Override
     public SharedPreferences getSharedPreferences(String name, int mode) {
@@ -175,6 +183,9 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
             for (int i = Integer.MIN_VALUE; i < Integer.MAX_VALUE; i++) {
                 getString(i);
             }
+        } else if (R.id.item_log == item.getItemId()) {
+			ToastUtils.show("Test");
+            LogActivity.startLogActivity(this);
         } else if (R.id.item_about == item.getItemId()) {
             LogUtils.d(TAG, "onAbout");
         } else if (android.R.id.home == item.getItemId()) {
@@ -189,6 +200,11 @@ public abstract class DrawerFragmentActivity extends AppCompatActivity implement
         if (checkThemeStyleChange()) {
             recreate();
         }
+
+		ADsBannerView adsBannerView = findViewById(R.id.adsbanner);
+		if (adsBannerView != null) {
+			adsBannerView.resumeADs();
+		}
     }
 
     void initRootView() {

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

@@ -13,7 +13,7 @@ import androidx.fragment.app.Fragment;
 import cc.winboll.studio.libaes.R;
 import cc.winboll.studio.libaes.views.AButton;
 import cc.winboll.studio.libappbase.LogUtils;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
 
 public class TestAButtonFragment extends Fragment {
 

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

@@ -12,14 +12,13 @@ import android.view.View;
 import android.view.ViewGroup;
 import android.widget.ImageView;
 import android.widget.LinearLayout;
-import android.widget.Toast;
 import androidx.fragment.app.Fragment;
 import androidx.viewpager.widget.ViewPager;
 import cc.winboll.studio.libaes.ImagePagerAdapter;
 import cc.winboll.studio.libaes.R;
 import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
 import cc.winboll.studio.libappbase.LogView;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
 import java.util.ArrayList;
 import java.util.List;
 

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

@@ -0,0 +1,33 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.content.Context;
+import android.util.DisplayMetrics;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/18 15:23
+ * @Describe 米盟 MimoUtils
+ */
+public final class MimoUtils {
+	public static final String TAG = "Utils";
+
+	public static int dpToPx(Context context, float dp) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (dp * displayMetrics.density + 0.5f);
+	}
+
+	public static int pxToDp(Context context, float px) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (px / displayMetrics.density + 0.5f);
+	}
+
+	public static int pxToSp(Context context, float pxValue) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (pxValue / displayMetrics.scaledDensity + 0.5f);
+	}
+
+	public static int spToPx(Context context, float spValue) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (spValue * displayMetrics.scaledDensity + 0.5f);
+	}
+}

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

@@ -0,0 +1,33 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/13 06:50
+ * @Describe 应用变量保存工具
+ */
+
+public class PrefUtils {
+
+    public static final String TAG = "PrefUtils";
+
+    //
+    // 保存字符串到SharedPreferences的函数
+    //
+    public static void saveString(Context context, String key, String value) {
+        SharedPreferences sharedPreferences = context.getSharedPreferences("myPrefs", Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = sharedPreferences.edit();
+        editor.putString(key, value);
+        editor.apply();
+    }
+
+    //
+    // 从SharedPreferences读取字符串的函数
+    //
+    public static String getString(Context context, String key, String defaultValue) {
+        SharedPreferences sharedPreferences = context.getSharedPreferences("myPrefs", Context.MODE_PRIVATE);
+        return sharedPreferences.getString(key, defaultValue);
+    }
+}

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

@@ -0,0 +1,485 @@
+package cc.winboll.studio.libaes.views;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.SharedPreferences;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.util.AttributeSet;
+import android.view.Display;
+import android.view.Gravity;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.FrameLayout;
+import android.widget.LinearLayout;
+import android.widget.Toast;
+import androidx.appcompat.app.AlertDialog;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.utils.MimoUtils;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import com.miui.zeus.mimo.sdk.ADParams;
+import com.miui.zeus.mimo.sdk.BannerAd;
+import com.miui.zeus.mimo.sdk.MimoCustomController;
+import com.miui.zeus.mimo.sdk.MimoLocation;
+import com.miui.zeus.mimo.sdk.MimoSdk;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/18 14:41
+ * @Describe WinBoLL 横幅广告类
+ */
+public class ADsBannerView extends LinearLayout {
+
+    public static final String TAG = "ADsBannerView";
+
+	private static final String PRIVACY_FILE = "privacy_pfs";
+    private static final String PRIVACY_VALUE = "privacy_value";//0: 拒绝，1：赞同
+
+	private String BANNER_POS_ID = "802e356f1726f9ff39c69308bfd6f06a";
+    private String BANNER_POS_ID_WINBOLL_BETA = "d129ee5a263911f981a6dc7a9802e3e7";
+    private String BANNER_POS_ID_WINBOLL = "4ec30efdb32271765b9a4efac902828b";
+
+	/*
+	 private String BANNER_POS_ID = "802e356f1726f9ff39c69308bfd6f06a";
+	 private String BANNER_POS_ID_WINBOLL_BETA = "802e356f1726f9ff39c69308bfd6f06a";
+	 private String BANNER_POS_ID_WINBOLL = "802e356f1726f9ff39c69308bfd6f06a";
+	 */
+
+	Context mContext;
+	View mMianView;
+	SharedPreferences mSharedPreferences;
+	ViewGroup mContainer;
+	BannerAd mBannerAd;
+	List<BannerAd> mAllBanners = new ArrayList<>();
+	// 新增：主线程Handler，确保广告操作在主线程执行
+    private Handler mMainHandler;
+
+    public ADsBannerView(Context context) {
+		super(context);
+		this.mContext = context;
+		initView();
+	}
+
+	public ADsBannerView(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		this.mContext = context;
+		initView();
+	}
+
+	public ADsBannerView(Context context, AttributeSet attrs, int defStyleAttr) {
+		super(context, attrs, defStyleAttr);
+		this.mContext = context;
+		initView();
+	}
+
+	public ADsBannerView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+		super(context, attrs, defStyleAttr, defStyleRes);
+		this.mContext = context;
+		initView();
+	}
+
+	void initView() {
+
+        // 初始化主线程Handler（关键：确保广告操作在主线程执行）
+        mMainHandler = new Handler(Looper.getMainLooper());
+
+        // 米盟模块：隐私协议弹窗
+        showPrivacy();
+
+		this.mMianView = inflate(this.mContext, R.layout.view_adsbanner, null);
+		mContainer = this.mMianView.findViewById(R.id.ads_container);
+		addView(this.mMianView);
+	}
+
+	Activity getActivity() {
+		try {
+			Activity activity = (Activity)this.mContext;
+			return activity;
+		} catch (Exception ex) {
+		}
+		return null;
+	}
+
+	public void resumeADs() {
+		// 修复：优化广告请求逻辑（添加生命周期判断 + 主线程执行）
+		if (getActivity() != null && !getActivity().isFinishing() && !getActivity().isDestroyed()) {
+			String privacyAgreeValue = getSharedPreferences().getString(PRIVACY_VALUE, null);
+			if (TextUtils.equals(privacyAgreeValue, String.valueOf(1))) {
+				LogUtils.i(TAG, "已同意隐私协议，开始播放米盟广告...");
+				mMainHandler.postDelayed(new Runnable() {
+						@Override
+						public void run() {
+							//ToastUtils.show("ADs run");
+							// 再次校验生命周期，避免延迟执行时Activity已销毁
+							if (getActivity() != null && !getActivity().isFinishing() && !getActivity().isDestroyed()) {
+								fetchAd();
+							}
+						}
+					}, 1000); // 延迟1秒请求广告，提升页面加载体验
+			}
+		}
+	}
+
+    /**
+     * 释放广告资源（关键：避免内存泄漏和空Context调用）
+     */
+    public void releaseAdResources() {
+        LogUtils.d(TAG, "releaseAdResources()");
+
+        // 移除Handler回调
+        if (mMainHandler != null) {
+            mMainHandler.removeCallbacksAndMessages(null);
+        }
+
+        // 销毁所有广告实例
+        if (mAllBanners != null && !mAllBanners.isEmpty()) {
+            for (BannerAd ad : mAllBanners) {
+                if (ad != null) {
+                    ad.destroy();
+                }
+            }
+            mAllBanners.clear();
+        }
+        // 置空当前广告引用
+        mBannerAd = null;
+        // 移除广告容器中的视图
+        if (mContainer != null) {
+            mContainer.removeAllViews();
+        }
+    }
+
+    /**
+     * 显示广告（核心修复：传递安全的Context + 生命周期校验）
+     */
+    private void showAd() {
+        LogUtils.d(TAG, "showAd()");
+        // 1. 生命周期校验：避免Activity已销毁时操作UI
+        if (getActivity() == null || getActivity().isFinishing() || getActivity().isDestroyed()) {
+            LogUtils.e(TAG, "showAd: Activity is finishing or destroyed");
+            return;
+        }
+        // 2. 非空校验：广告实例和容器
+        if (mBannerAd == null || mContainer == null) {
+            LogUtils.e(TAG, "showAd: BannerAd or Container is null");
+            return;
+        }
+        // 3. 创建广告容器（使用ApplicationContext避免内存泄漏）
+        final FrameLayout container = new FrameLayout(getActivity().getApplicationContext());
+        container.setPadding(0, 0, 0, MimoUtils.dpToPx(getActivity(), 10));
+        mContainer.addView(container, new FrameLayout.LayoutParams(
+							   FrameLayout.LayoutParams.MATCH_PARENT,
+							   FrameLayout.LayoutParams.WRAP_CONTENT
+						   ));
+
+//        if (mIsBiddingWin) {
+//            mBannerAd.setPrice(getPrice());
+//        }
+        // 4. 显示广告：传递ApplicationContext，避免Activity Context失效
+        mBannerAd.showAd(getActivity(), container, new BannerAd.BannerInteractionListener() {
+				@Override
+				public void onAdClick() {
+					LogUtils.d(TAG, "onAdClick");
+				}
+
+				@Override
+				public void onAdShow() {
+					LogUtils.d(TAG, "onAdShow");
+				}
+
+				@Override
+				public void onAdDismiss() {
+					LogUtils.d(TAG, "onAdDismiss");
+					// 修复：移除容器时校验Activity状态
+					if (getActivity() != null && !getActivity().isFinishing() && !getActivity().isDestroyed() && mContainer != null) {
+						mContainer.removeView(container);
+					}
+				}
+
+				@Override
+				public void onRenderSuccess() {
+					LogUtils.d(TAG, "onRenderSuccess");
+				}
+
+				@Override
+				public void onRenderFail(int code, String msg) {
+					LogUtils.e(TAG, "onRenderFail errorCode " + code + " errorMsg " + msg);
+					// 修复：渲染失败时移除容器
+					if (getActivity() != null && !getActivity().isFinishing() && !getActivity().isDestroyed() && mContainer != null) {
+						mContainer.removeView(container);
+					}
+				}
+			});
+    }
+
+    /**
+     * 请求广告（核心修复：Context安全校验 + 异常捕获 + 资源管理）
+     */
+    private void fetchAd() {
+        LogUtils.d(TAG, "fetchAd()");
+        // 1. 双重校验：Activity未销毁 + Context非空
+        if (getActivity() == null || getActivity().isFinishing() || getActivity().isDestroyed() || getActivity().getApplicationContext() == null) {
+            LogUtils.e(TAG, "fetchAd: Invalid Context or Activity state");
+            return;
+        }
+        // 2. 释放之前的广告资源，避免内存泄漏
+        if (mBannerAd != null) {
+            mBannerAd.destroy();
+        }
+        // 3. 初始化广告（使用ApplicationContext，避免Activity Context失效）
+        try {
+            mBannerAd = new BannerAd();
+            mAllBanners.add(mBannerAd);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "fetchAd: Init BannerAd failed", e);
+            return;
+        }
+        // 4. 设置下载监听
+        mBannerAd.setDownLoadListener(new BannerAd.BannerDownloadListener() {
+				@Override
+				public void onDownloadStarted() {
+					LogUtils.d(TAG, "onDownloadStarted");
+				}
+
+				@Override
+				public void onDownloadPaused() {
+					LogUtils.d(TAG, "onDownloadPaused");
+				}
+
+				@Override
+				public void onDownloadFailed(int errorCode) {
+					String msg = "onDownloadFailed, errorCode = " + errorCode;
+					LogUtils.d(TAG, msg);
+					//ToastUtils.show(msg);
+				}
+
+				@Override
+				public void onDownloadFinished() {
+					LogUtils.d(TAG, "onDownloadFinished");
+				}
+
+				@Override
+				public void onDownloadProgressUpdated(int progress) {
+					LogUtils.d(TAG, "onDownloadProgressUpdated " + progress + "%");
+				}
+
+				@Override
+				public void onInstallFailed(int errorCode) {
+					LogUtils.d(TAG, "onInstallFailed, errorCode = " + errorCode);
+				}
+
+				@Override
+				public void onInstallStart() {
+					LogUtils.d(TAG, "onInstallStart");
+				}
+
+				@Override
+				public void onInstallSuccess() {
+					LogUtils.d(TAG, "onInstallSuccess");
+				}
+
+				@Override
+				public void onDownloadCancel() {
+					LogUtils.d(TAG, "onDownloadCancel");
+				}
+			});
+
+        // 5. 构建广告参数并请求
+        String currentAD_ID = getAD_ID();
+        LogUtils.d(TAG, String.format("currentAD_ID = %s", currentAD_ID));
+        ADParams params = new ADParams.Builder().setUpId(currentAD_ID).build();
+        mBannerAd.loadAd(params, new BannerAd.BannerLoadListener() {
+				@Override
+				public void onBannerAdLoadSuccess() {
+					LogUtils.d(TAG, "onBannerAdLoadSuccess()");
+					// 修复：广告加载成功后校验Activity状态
+					if (getActivity() != null && !getActivity().isFinishing() && !getActivity().isDestroyed()) {
+						showAd();
+					}
+				}
+
+				@Override
+				public void onAdLoadFailed(int errorCode, String errorMsg) {
+					String msg = "onAdLoadFailed: errorCode = " + errorCode + ", errorMsg = " + errorMsg;
+					LogUtils.d(TAG, msg);
+					removeAllBanners();
+				}
+			});
+    }
+
+	void removeAllBanners() {
+		// 修复：加载失败时移除当前广告实例
+		if (mAllBanners.contains(mBannerAd)) {
+			mAllBanners.remove(mBannerAd);
+		}
+		mBannerAd.destroy();
+		mBannerAd = null;
+	}
+
+    /**
+     * 根据当前秒数获取广告ID（原逻辑保留）
+     */
+    private String getAD_ID() {
+        long currentSecond = System.currentTimeMillis() / 1000;
+        return (currentSecond % 2 == 0) ? BANNER_POS_ID :
+			(GlobalApplication.isDebugging() ? BANNER_POS_ID_WINBOLL_BETA : BANNER_POS_ID_WINBOLL);
+    }
+
+    /**
+     * 获取广告价格（原逻辑保留，添加空指针校验）
+     */
+    private long getPrice() {
+        if (mBannerAd == null) {
+            return 0;
+        }
+        Map<String, Object> map = mBannerAd.getMediaExtraInfo();
+        if (map == null || map.isEmpty() || !map.containsKey("price")) {
+            LogUtils.w(TAG, "getPrice: media extra info is null or no price key");
+            return 0;
+        }
+        Object priceObj = map.get("price");
+        if (priceObj instanceof Long) {
+            return (Long) priceObj;
+        } else if (priceObj instanceof Integer) {
+            return ((Integer) priceObj).longValue();
+        } else {
+            LogUtils.e(TAG, "getPrice: price type is invalid");
+            return 0;
+        }
+    }
+
+    /**
+     * 显示隐私协议弹窗（原逻辑保留，优化Context使用）
+     */
+    private void showPrivacy() {
+        // 校验Activity状态，避免弹窗泄露
+        if (getActivity() == null || getActivity().isFinishing() || getActivity().isDestroyed()) {
+            return;
+        }
+        String privacyAgreeValue = getSharedPreferences().getString(PRIVACY_VALUE, null);
+        if (TextUtils.equals(privacyAgreeValue, String.valueOf(0))) {
+            LogUtils.i(TAG, "已拒绝隐私协议，广告已处于不可用状态...");
+            Toast.makeText(getActivity().getApplicationContext(), "已拒绝隐私协议，广告已处于不可用状态", Toast.LENGTH_SHORT).show();
+            return;
+        }
+        if (TextUtils.equals(privacyAgreeValue, String.valueOf(1))) {
+            LogUtils.i(TAG, "已同意隐私协议，开始初始化米盟SDK...");
+            initMimoSdk();
+            return;
+        }
+        LogUtils.i(TAG, "开始弹出隐私协议...");
+        AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
+        builder.setTitle("用户须知");
+        builder.setMessage("小米广告SDK隐私政策: https://dev.mi.com/distribute/doc/details?pId=1688, 请复制到浏览器查看");
+        builder.setIcon(R.drawable.ic_launcher);
+        builder.setCancelable(false); // 点击对话框以外的区域不消失
+        builder.setPositiveButton("同意", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					getSharedPreferences().edit()
+                        .putString(PRIVACY_VALUE, String.valueOf(1))
+                        .apply();
+					initMimoSdk();
+					dialog.dismiss();
+				}
+			});
+        builder.setNegativeButton("拒绝", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					getSharedPreferences().edit()
+                        .putString(PRIVACY_VALUE, String.valueOf(0))
+                        .apply();
+					dialog.dismiss();
+				}
+			});
+        AlertDialog dialog = builder.create();
+
+        // 配置弹窗位置（底部全屏）
+        Window window = dialog.getWindow();
+        if (window != null) {
+            window.setGravity(Gravity.BOTTOM);
+            WindowManager m = getActivity().getWindowManager();
+            Display d = m.getDefaultDisplay();
+            WindowManager.LayoutParams p = window.getAttributes();
+            p.width = d.getWidth();
+            window.setAttributes(p);
+        }
+        dialog.show();
+    }
+
+    /**
+     * 初始化米盟SDK（核心修复：传递ApplicationContext + 异常捕获）
+     */
+    private void initMimoSdk() {
+        // 1. 安全获取ApplicationContext，避免Activity Context失效
+        Context appContext = getActivity().getApplicationContext();
+        if (appContext == null) {
+            LogUtils.e(TAG, "initMimoSdk: ApplicationContext is null");
+            return;
+        }
+        // 2. 初始化SDK，捕获异常避免崩溃
+        try {
+            MimoSdk.init(appContext, new MimoCustomController() {
+					@Override
+					public boolean isCanUseLocation() {
+						return true;
+					}
+
+					@Override
+					public MimoLocation getMimoLocation() {
+						return null;
+					}
+
+					@Override
+					public boolean isCanUseWifiState() {
+						return true;
+					}
+
+					@Override
+					public boolean alist() {
+						return true;
+					}
+				}, new MimoSdk.InitCallback() {
+					@Override
+					public void success() {
+						LogUtils.d(TAG, "MimoSdk init success");
+					}
+
+					@Override
+					public void fail(int code, String msg) {
+						LogUtils.e(TAG, "MimoSdk init fail, code=" + code + ",msg=" + msg);
+					}
+				});
+            MimoSdk.setDebugOn(true);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "initMimoSdk: init failed", e);
+        }
+    }
+
+
+    /**
+     * 获取SharedPreferences实例（原逻辑保留，添加空指针校验）
+     */
+    SharedPreferences getSharedPreferences() {
+        if (mSharedPreferences == null) {
+            // 修复：使用ApplicationContext获取SharedPreferences，避免Activity Context泄露
+            Context appContext = getActivity().getApplicationContext();
+            if (appContext != null) {
+                mSharedPreferences = appContext.getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
+            } else {
+                LogUtils.e(TAG, "getSharedPreferences: ApplicationContext is null");
+                // 降级方案：若ApplicationContext为空，使用Activity Context（仅作兼容）
+                mSharedPreferences = getActivity().getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
+            }
+        }
+        return mSharedPreferences;
+    }
+}

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

@@ -12,7 +12,6 @@ import android.content.res.TypedArray;
 import android.net.Uri;
 import android.os.Message;
 import android.util.AttributeSet;
-import android.view.LayoutInflater;
 import android.view.View;
 import android.widget.EditText;
 import android.widget.LinearLayout;
@@ -20,11 +19,11 @@ import cc.winboll.studio.libaes.R;
 import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
 import cc.winboll.studio.libaes.models.APPInfo;
 import cc.winboll.studio.libaes.utils.AppVersionUtils;
+import cc.winboll.studio.libaes.utils.PrefUtils;
 import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
 import cc.winboll.studio.libappbase.GlobalApplication;
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libapputils.utils.PrefUtils;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
 import java.io.IOException;
 import mehdi.sakout.aboutpage.AboutPage;
 import mehdi.sakout.aboutpage.Element;
@@ -108,7 +107,7 @@ public class AboutView extends LinearLayout {
         mszAppDescription = mAPPInfo.getAppDescription();
         mnAppIcon = mAPPInfo.getAppIcon();
 
-        mszWinBoLLServerHost = GlobalApplication.isDebuging() ?  "https://yun-preivew.winboll.cc": "https://yun.winboll.cc";
+        mszWinBoLLServerHost = GlobalApplication.isDebugging() ?  "https://yun-preivew.winboll.cc": "https://yun.winboll.cc";
 
         try {
             mszAppVersionName = _mContext.getPackageManager().getPackageInfo(_mContext.getPackageName(), 0).versionName;
@@ -229,7 +228,7 @@ public class AboutView extends LinearLayout {
             // 定义应用调试按钮
             //
             Element elementAppMode;
-            if (GlobalApplication.isDebuging()) {
+            if (GlobalApplication.isDebugging()) {
                 elementAppMode = new Element(_mContext.getString(R.string.app_normal), R.drawable.ic_winboll);
                 elementAppMode.setOnClickListener(mAppNormalOnClickListener);
             } else {
@@ -263,8 +262,8 @@ public class AboutView extends LinearLayout {
         if (intent != null) {
             //intent.setAction(cc.winboll.studio.libapputils.intent.action.DEBUGVIEW);
             intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-            GlobalApplication.setIsDebuging(true);
-            GlobalApplication.saveDebugStatus(_mContext);
+            GlobalApplication.setIsDebugging(true);
+            GlobalApplication.saveDebugStatus((GlobalApplication)_mContext.getApplicationContext());
 
             WinBoLLActivityManager.getInstance().finishAll();
             context.startActivity(intent);
@@ -275,8 +274,8 @@ public class AboutView extends LinearLayout {
         Intent intent = context.getPackageManager().getLaunchIntentForPackage(context.getPackageName());
         if (intent != null) {
             intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-            GlobalApplication.setIsDebuging(false);
-            GlobalApplication.saveDebugStatus(_mContext);
+            GlobalApplication.setIsDebugging(false);
+            GlobalApplication.saveDebugStatus((GlobalApplication)_mContext.getApplicationContext());
 
             WinBoLLActivityManager.getInstance().finishAll();
             context.startActivity(intent);
@@ -301,7 +300,7 @@ public class AboutView extends LinearLayout {
                         String szUrl = mszWinBoLLServerHost + "/studio/details.php?app=" + mszAppAPKFolderName;
                         // 构建包含认证信息的请求
                         String credential = "";
-                        if (GlobalApplication.isDebuging()) {
+                        if (GlobalApplication.isDebugging()) {
                             credential = Credentials.basic(metDevUserName.getText().toString(), metDevUserPassword.getText().toString());
                             PrefUtils.saveString(_mContext, "metDevUserName", metDevUserName.getText().toString());
                             PrefUtils.saveString(_mContext, "metDevUserPassword", metDevUserPassword.getText().toString());

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

@@ -10,7 +10,7 @@
 		android:layout_width="match_parent"
 		android:layout_height="wrap_content"
 		android:id="@+id/activitydrawerfragmentASupportToolbar1"/>
-    
+
 	<LinearLayout
 		android:orientation="vertical"
 		android:layout_width="match_parent"
@@ -19,7 +19,8 @@
 
 		<androidx.drawerlayout.widget.DrawerLayout
 			android:layout_width="match_parent"
-			android:layout_height="match_parent"
+			android:layout_height="0dp"
+			android:layout_weight="1.0"
 			android:id="@+id/activitydrawerfragmentDrawerLayout1">
 
 			<FrameLayout
@@ -52,7 +53,13 @@
 
 		</androidx.drawerlayout.widget.DrawerLayout>
 
+		
 	</LinearLayout>
 
+	<cc.winboll.studio.libaes.views.ADsBannerView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/adsbanner"/>
+
 </LinearLayout>
 

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

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

libaes/src/main/res/menu/toolbar_studio_debug.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    <!--<item android:title="@string/app_theme">
+    <menu>-->
+    <!-- 定义一组单选按钮 -->
+    <!-- checkableBehavior的可选值由三个：single设置为单选，all为多选，none为普通选项 -->
+    <!--        <group android:checkableBehavior="single">
+    <item android:id="@+id/app_defaulttheme" android:title="@string/app_defaulttheme"/>
+    <item android:id="@+id/app_skytheme" android:title="@string/app_skytheme"/>
+    <item android:id="@+id/app_goldentheme" android:title="@string/app_goldentheme"/>
+    </group>
+    </menu>
+    </item>-->
+
+    <item android:title="DebugTools">
+        <menu>
+            <item
+                android:id="@+id/item_testcrashreport"
+                android:title="Test Application Crash Report"/>
+            <item
+                android:id="@+id/item_unittest"
+                android:title="UnitTest"/>
+            <item
+                android:id="@+id/item_log"
+                android:title="APPLOG"/>
+            <item
+                android:id="@+id/item_info"
+                android:title="Info"/>
+            <item
+                android:id="@+id/item_exitdebug"
+                android:title="ExitDebug"/>
+        </menu>
+    </item>
+</menu>

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

@@ -12,5 +12,10 @@
     <string name="text_GoldenTheme">GoldenTheme</string>
     <string name="text_MemorTheme">MemorTheme</string>
     <string name="text_TaoTheme">TaoTheme</string>
-    
+
+    <string name="app_normal">Click here is switch to Normal APP</string>
+    <string name="app_debug">Click here is switch to APP DEBUG</string>
+	<string name="gitea_home">GITEA HOME</string>
+    <string name="app_update">APP UPDATE</string>
+
 </resources>

libaes/src/main/res/xml/file_provider.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths>
+    <external-path path="mimoDownload" name="files_root" />
+    <external-path path="." name="external_storage_root" />
+</paths>

libaes/src/main/res/xml/network_security_config.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <!-- 允许 winboll.cc 及其子域名的明文流量（HTTP） -->
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">winboll.cc</domain>
+    </domain-config>
+	<!-- 米盟 SDK 配置 -->
+    <base-config cleartextTrafficPermitted="true" />
+    <debug-overrides>
+        <trust-anchors>
+            <!-- Trust user added CAs while debuggable only -->
+            <certificates src="system" />
+            <certificates src="user" />
+        </trust-anchors>
+    </debug-overrides>
+</network-security-config>

libappbase/build.gradle

@@ -5,11 +5,14 @@ apply from: '../.winboll/winboll_lint_build.gradle'
 
 android {
     
-    compileSdkVersion 32
-    buildToolsVersion "32.0.0"
+    // 1. compileSdkVersion：必须 ≥ targetSdkVersion，建议直接等于 targetSdkVersion（30）
+    compileSdkVersion 30
+
+    // 2. buildToolsVersion：需匹配 compileSdkVersion，建议使用 30.x.x 最新稳定版（无需高于 compileSdkVersion）
+    buildToolsVersion "30.0.3" // 这是 30 对应的最新稳定版，避免使用 beta 版
 
     defaultConfig {
-        minSdkVersion 24
+        minSdkVersion 23
         targetSdkVersion 30
     }
     buildTypes {
@@ -22,9 +25,4 @@ android {
 
 dependencies {
     api fileTree(dir: 'libs', include: ['*.jar'])
-    // 网络连接类库
-    api 'com.squareup.okhttp3:okhttp:4.4.1'
-    // https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind
-    
-    api 'com.google.code.gson:gson:2.10.1'
 }

libappbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Fri Sep 26 05:36:14 HKT 2025
-stageCount=9
+#Fri Nov 21 11:41:04 HKT 2025
+stageCount=2
 libraryProject=libappbase
-baseVersion=15.10
-publishVersion=15.10.8
+baseVersion=15.11
+publishVersion=15.11.1
 buildCount=0
-baseBetaVersion=15.10.9
+baseBetaVersion=15.11.2

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

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

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

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

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

@@ -1,10 +1,5 @@
 package cc.winboll.studio.libappbase;
 
-/**
- * @Author ZhanGSKen<zhangsken@qq.com>
- * @Date 2024/08/12 13:22:12
- * @Describe 异常处理类
- */
 import android.app.Activity;
 import android.app.Application;
 import android.content.ActivityNotFoundException;
@@ -12,29 +7,22 @@ import android.content.ClipData;
 import android.content.ClipboardManager;
 import android.content.Context;
 import android.content.Intent;
-import android.content.pm.ApplicationInfo;
 import android.content.pm.PackageInfo;
 import android.content.pm.PackageManager;
 import android.content.res.Resources;
 import android.graphics.Color;
-import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
 import android.os.Handler;
 import android.os.Looper;
-import android.text.SpannableString;
 import android.text.TextUtils;
-import android.text.style.ForegroundColorSpan;
 import android.view.Menu;
 import android.view.MenuItem;
 import android.view.ViewGroup;
 import android.widget.HorizontalScrollView;
-import android.widget.LinearLayout;
 import android.widget.ScrollView;
 import android.widget.TextView;
 import android.widget.Toast;
-import android.widget.Toolbar;
-import cc.winboll.studio.libappbase.R;
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.FileOutputStream;
@@ -48,358 +36,515 @@ import java.text.SimpleDateFormat;
 import java.util.Date;
 import java.util.Locale;
 
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:14
+ * @Describe  * 应用全局崩溃处理类（单例逻辑）
+ * 核心功能：捕获应用未捕获异常，记录崩溃日志到文件，启动崩溃报告页面，
+ * 并通过「崩溃保险丝」机制防止重复崩溃，保障基础功能可用
+ */
 public final class CrashHandler {
 
-    public static final String TAG = "CrashHandler";
+	/** 日志标签，用于当前类的日志输出标识 */
+	public static final String TAG = "CrashHandler";
 
-    public static final String TITTLE = "CrashReport";
+	/** 崩溃报告页面标题 */
+	public static final String TITTLE = "CrashReport";
 
-    public static final String EXTRA_CRASH_INFO = "crashInfo";
+	/** Intent 传递崩溃信息的键（用于向崩溃页面传递日志） */
+	public static final String EXTRA_CRASH_INFO = "crashInfo";
 
-    final static String PREFS = CrashHandler.class.getName() + "PREFS";
-    final static String PREFS_CRASHHANDLER_ISCRASHHAPPEN = "PREFS_CRASHHANDLER_ISCRASHHAPPEN";
+	/** SharedPreferences 存储键（用于记录崩溃状态） */
+	final static String PREFS = CrashHandler.class.getName() + "PREFS";
+	/** SharedPreferences 中存储「是否发生崩溃」的键 */
+	final static String PREFS_CRASHHANDLER_ISCRASHHAPPEN = "PREFS_CRASHHANDLER_ISCRASHHAPPEN";
 
-    public static String _CrashCountFilePath;
+	/** 崩溃保险丝状态文件路径（存储当前熔断等级） */
+	public static String _CrashCountFilePath;
 
-    public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+	/** 系统默认的未捕获异常处理器（用于降级处理，避免 CrashHandler 自身崩溃） */
+	public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
 
-    public static void init(Application app) {
-        _CrashCountFilePath = app.getExternalFilesDir("CrashHandler") + "/IsCrashHandlerCrashHappen.dat";
-        LogUtils.d(TAG, String.format("_CrashCountFilePath %s", _CrashCountFilePath));
-        init(app, null);
-    }
+	/**
+	 * 初始化崩溃处理器（默认存储路径）
+	 * 调用重载方法，崩溃日志默认存储在应用外部私有目录的 crash 文件夹下
+	 * @param app 全局 Application 实例（用于获取存储目录、包信息等）
+	 */
+	public static void init(Application app) {
+		// 初始化崩溃保险丝状态文件路径（外部存储/CrashHandler/IsCrashHandlerCrashHappen.dat）
+		_CrashCountFilePath = app.getExternalFilesDir("CrashHandler") + "/IsCrashHandlerCrashHappen.dat";
+		LogUtils.d(TAG, String.format("_CrashCountFilePath %s", _CrashCountFilePath));
+		// 调用带目录参数的初始化方法，传入 null 使用默认路径
+		init(app, null);
+	}
 
-    public static void init(final Application app, final String crashDir) {
-        Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandler(){
+	/**
+	 * 初始化崩溃处理器（指定日志存储目录）
+	 * 替换系统默认的未捕获异常处理器，自定义崩溃处理逻辑
+	 * @param app 全局 Application 实例
+	 * @param crashDir 崩溃日志存储目录（null 则使用默认路径）
+	 */
+	public static void init(final Application app, final String crashDir) {
+		// 设置自定义未捕获异常处理器
+		Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandler() {
+				@Override
+				public void uncaughtException(Thread thread, Throwable throwable) {
+					try {
+						// 尝试处理崩溃（捕获内部异常，避免 CrashHandler 自身崩溃）
+						tryUncaughtException(thread, throwable);
+					} catch (Throwable e) {
+						e.printStackTrace();
+						// 处理失败时，交给系统默认处理器兜底
+						if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+							DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+						}
+					}
+				}
 
-                @Override
-                public void uncaughtException(Thread thread, Throwable throwable) {
-                    try {
-                        tryUncaughtException(thread, throwable);
-                    } catch (Throwable e) {
-                        e.printStackTrace();
-                        if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null)
-                            DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
-                    }
-                }
+				/**
+				 * 实际处理崩溃的核心方法
+				 * 1. 熔断保险丝（记录崩溃次数）；2. 收集崩溃信息；3. 写入日志文件；4. 启动崩溃报告页面
+				 * @param thread 发生崩溃的线程
+				 * @param throwable 崩溃异常对象（包含堆栈信息）
+				 */
+				private void tryUncaughtException(Thread thread, Throwable throwable) {
+					// 触发崩溃保险丝（每次崩溃熔断一次，降低防护等级）
+					AppCrashSafetyWire.getInstance().burnSafetyWire();
 
-                private void tryUncaughtException(Thread thread, Throwable throwable) {
-                    // 每到这里就燃烧一次保险丝
-                    AppCrashSafetyWire.getInstance().burnSafetyWire();
+					// 格式化崩溃发生时间（用于日志文件名和内容）
+					final String time = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss", Locale.getDefault()).format(new Date());
+					// 创建崩溃日志文件（默认路径：外部存储/crash/[时间].txt）
+					File crashFile = new File(
+						TextUtils.isEmpty(crashDir) ? new File(app.getExternalFilesDir(null), "crash") : new File(crashDir),
+						"crash_" + time + ".txt"
+					);
 
-                    final String time = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss", Locale.getDefault()).format(new Date());
-                    File crashFile = new File(TextUtils.isEmpty(crashDir) ? new File(app.getExternalFilesDir(null), "crash")
-                                              : new File(crashDir), "crash_" + time + ".txt");
+					// 获取应用版本信息（版本名、版本号）
+					String versionName = "unknown";
+					long versionCode = 0;
+					try {
+						PackageInfo packageInfo = app.getPackageManager().getPackageInfo(app.getPackageName(), 0);
+						versionName = packageInfo.versionName;
+						// 适配 Android 9.0+（API 28）的版本号获取方式
+						versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+					} catch (PackageManager.NameNotFoundException ignored) {}
 
-                    String versionName = "unknown";
-                    long versionCode = 0;
-                    try { 
-                        PackageInfo packageInfo = app.getPackageManager().getPackageInfo(app.getPackageName(), 0);
-                        versionName = packageInfo.versionName;
-                        versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode()
-                            : packageInfo.versionCode;
-                    } catch (PackageManager.NameNotFoundException ignored) {}
+					// 将异常堆栈信息转换为字符串
+					String fullStackTrace;
+					{
+						StringWriter sw = new StringWriter();
+						PrintWriter pw = new PrintWriter(sw);
+						throwable.printStackTrace(pw); // 将异常堆栈写入 PrintWriter
+						fullStackTrace = sw.toString();
+						pw.close();
+					}
 
-                    String fullStackTrace; {
-                        StringWriter sw = new StringWriter(); 
-                        PrintWriter pw = new PrintWriter(sw);
-                        throwable.printStackTrace(pw);
-                        fullStackTrace = sw.toString();
-                        pw.close();
-                    }
+					// 拼接崩溃信息（设备信息 + 应用信息 + 堆栈信息）
+					StringBuilder sb = new StringBuilder();
+					sb.append("************* Crash Head ****************\n");
+					sb.append("Time Of Crash                        : ").append(time).append("\n");
+					sb.append("Device Manufacturer                  : ").append(Build.MANUFACTURER).append("\n"); // 设备厂商
+					sb.append("Device Model                         : ").append(Build.MODEL).append("\n"); // 设备型号
+					sb.append("Android Version                      : ").append(Build.VERSION.RELEASE).append("\n"); // Android 版本
+					sb.append("Android SDK                          : ").append(Build.VERSION.SDK_INT).append("\n"); // SDK 版本
+					sb.append("App VersionName                      : ").append(versionName).append("\n"); // 应用版本名
+					sb.append("App VersionCode                      : ").append(versionCode).append("\n"); // 应用版本号
+					sb.append("************* Crash Head ****************\n");
+					sb.append("\n").append(fullStackTrace); // 拼接异常堆栈
 
-                    StringBuilder sb = new StringBuilder();
-                    sb.append("************* Crash Head ****************\n");
-                    sb.append("Time Of Crash                        : ").append(time).append("\n");
-                    sb.append("Device Manufacturer                  : ").append(Build.MANUFACTURER).append("\n");
-                    sb.append("Device Model                         : ").append(Build.MODEL).append("\n");
-                    sb.append("Android Version                      : ").append(Build.VERSION.RELEASE).append("\n");
-                    sb.append("Android SDK                          : ").append(Build.VERSION.SDK_INT).append("\n");
-                    sb.append("App VersionName                      : ").append(versionName).append("\n");
-                    sb.append("App VersionCode                      : ").append(versionCode).append("\n");
-                    sb.append("************* Crash Head ****************\n");
-                    sb.append("\n").append(fullStackTrace);
+					final String errorLog = sb.toString();
 
-                    String errorLog = sb.toString();
+					// 将崩溃日志写入文件（忽略写入失败）
+					try {
+						writeFile(crashFile, errorLog);
+					} catch (IOException ignored) {}
 
-                    try {
-                        writeFile(crashFile, errorLog);
-                    } catch (IOException ignored) {}
+					// 启动崩溃报告页面（标签用于代码块折叠）
+					gotoCrashActiviy: {
+						Intent intent = new Intent();
+						LogUtils.d(TAG, "gotoCrashActiviy: ");
 
-                    gotoCrashActiviy: {
-                        Intent intent = new Intent();
-                        LogUtils.d(TAG, "gotoCrashActiviy: ");
-                        if (AppCrashSafetyWire.getInstance().isAppCrashSafetyWireOK()) {
-                            LogUtils.d(TAG, "gotoCrashActiviy: isAppCrashSafetyWireOK");
-                            intent.setClass(app, GlobalCrashActivity.class);
-                            intent.putExtra(EXTRA_CRASH_INFO, errorLog);
-                            // 如果发生了 CrashHandler 内部崩溃， 就调用基础的应用崩溃显示类
-//                            intent.setClass(app, GlobalCrashActiviy.class);
-//                            intent.putExtra(GlobalCrashActiviy.EXTRA_CRASH_INFO, errorLog);
-                        } else {
-                            LogUtils.d(TAG, "gotoCrashActiviy: else");
-                            // 正常状态调用进阶的应用崩溃显示页
-                            intent.setClass(app, CrashActivity.class);
-                            intent.putExtra(EXTRA_CRASH_INFO, errorLog);
-                        }
+						// 根据保险丝状态选择启动的崩溃页面
+						if (AppCrashSafetyWire.getInstance().isAppCrashSafetyWireOK()) {
+							LogUtils.d(TAG, "gotoCrashActiviy: isAppCrashSafetyWireOK");
+							// 保险丝正常：启动自定义样式的崩溃报告页面（GlobalCrashActivity）
+							intent.setClass(app, GlobalCrashActivity.class);
+							intent.putExtra(EXTRA_CRASH_INFO, errorLog); // 传递崩溃日志
+						} else {
+							LogUtils.d(TAG, "gotoCrashActiviy: else");
+							// 保险丝熔断：启动基础版崩溃页面（CrashActivity，避免复杂页面再次崩溃）
+							intent.setClass(app, CrashActivity.class);
+							intent.putExtra(EXTRA_CRASH_INFO, errorLog);
+						}
 
+						// 设置意图标志：清除原有任务栈，创建新任务（避免回到崩溃前页面）
+						intent.addFlags(
+							Intent.FLAG_ACTIVITY_NEW_TASK
+							| Intent.FLAG_ACTIVITY_CLEAR_TOP
+							| Intent.FLAG_ACTIVITY_CLEAR_TASK
+						);
 
+						try {
+							// 启动崩溃页面，终止当前进程（确保完全重启）
+							app.startActivity(intent);
+							android.os.Process.killProcess(android.os.Process.myPid());
+							System.exit(0);
+						} catch (ActivityNotFoundException e) {
+							// 未找到崩溃页面（如未在 Manifest 注册），交给系统默认处理器
+							e.printStackTrace();
+							if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+								DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+							}
+						} catch (Exception e) {
+							// 其他异常，兜底处理
+							e.printStackTrace();
+							if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+								DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+							}
+						}
+					}
+				}
 
-//                        intent.setClass(app, CrashActiviy.class);
-//                        intent.putExtra(CrashActiviy.EXTRA_CRASH_INFO, errorLog);
+				/**
+				 * 将字符串内容写入文件（创建父目录、覆盖写入）
+				 * @param file 目标文件（包含路径）
+				 * @param content 待写入的内容（崩溃日志）
+				 * @throws IOException 文件创建或写入失败时抛出
+				 */
+				private void writeFile(File file, String content) throws IOException {
+					File parentFile = file.getParentFile();
+					// 父目录不存在则创建
+					if (parentFile != null && !parentFile.exists()) {
+						parentFile.mkdirs();
+					}
+					file.createNewFile(); // 创建文件
+					FileOutputStream fos = new FileOutputStream(file);
+					fos.write(content.getBytes()); // 写入内容（默认 UTF-8 编码）
+					try {
+						fos.close(); // 关闭流
+					} catch (IOException e) {}
+				}
+			});
+	}
 
+	/**
+	 * 应用崩溃保险丝内部类（单例）
+	 * 核心作用：限制短时间内重复崩溃，通过「熔断等级」控制崩溃页面启动策略
+	 * 等级范围：MINI（1）~ MAX（2），每次崩溃等级-1，熔断后启动基础版崩溃页面
+	 */
+	public static final class AppCrashSafetyWire {
 
-                        intent.addFlags(
-                            Intent.FLAG_ACTIVITY_NEW_TASK
-                            | Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_CLEAR_TASK
-                        );
+		/** 单例实例（volatile 保证多线程可见性） */
+		private static volatile AppCrashSafetyWire _AppCrashSafetyWire;
 
-                        try {
-                            app.startActivity(intent);
-                            android.os.Process.killProcess(android.os.Process.myPid());
-                            System.exit(0);
-                        } catch (ActivityNotFoundException e) {
-                            e.printStackTrace();
-                            if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null)
-                                DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
-                        } catch (Exception e) {
-                            e.printStackTrace();
-                            if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null)
-                                DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
-                        }
-                    }
+		/** 当前熔断等级（1：最低防护；2：最高防护；≤0：熔断） */
+		private volatile Integer currentSafetyLevel;
+		/** 最低熔断等级（1，再崩溃则熔断） */
+		private static final int _MINI = 1;
+		/** 最高熔断等级（2，初始状态） */
+		private static final int _MAX = 2;
 
-                }
+		/**
+		 * 私有构造方法（单例模式，禁止外部实例化）
+		 * 初始化时加载本地存储的熔断等级
+		 */
+		private AppCrashSafetyWire() {
+			LogUtils.d(TAG, "AppCrashSafetyWire()");
+			currentSafetyLevel = loadCurrentSafetyLevel();
+		}
 
-                private void writeFile(File file, String content) throws IOException {
-                    File parentFile = file.getParentFile();
-                    if (parentFile != null && !parentFile.exists()) {
-                        parentFile.mkdirs();
-                    }
-                    file.createNewFile();
-                    FileOutputStream fos = new FileOutputStream(file);
-                    fos.write(content.getBytes());
-                    try {
-                        fos.close();
-                    } catch (IOException e) {}
-                }
+		/**
+		 * 获取单例实例（双重检查锁定，线程安全）
+		 * @return AppCrashSafetyWire 单例
+		 */
+		public static synchronized AppCrashSafetyWire getInstance() {
+			if (_AppCrashSafetyWire == null) {
+				_AppCrashSafetyWire = new AppCrashSafetyWire();
+			}
+			return _AppCrashSafetyWire;
+		}
 
-            });
-    }
+		/**
+		 * 设置当前熔断等级（内存中）
+		 * @param currentSafetyLevel 目标等级（1~2）
+		 */
+		public void setCurrentSafetyLevel(int currentSafetyLevel) {
+			this.currentSafetyLevel = currentSafetyLevel;
+		}
 
-    //
-    // 应用崩溃保险丝
-    //
-    public static final class AppCrashSafetyWire {
+		/**
+		 * 获取当前熔断等级（内存中）
+		 * @return 当前等级（1~2 或 null）
+		 */
+		public int getCurrentSafetyLevel() {
+			return currentSafetyLevel;
+		}
 
-        volatile static AppCrashSafetyWire _AppCrashSafetyWire;
+		/**
+		 * 保存熔断等级到本地文件（持久化，重启应用生效）
+		 * @param currentSafetyLevel 待保存的等级
+		 */
+		public void saveCurrentSafetyLevel(int currentSafetyLevel) {
+			LogUtils.d(TAG, "saveCurrentSafetyLevel()");
+			this.currentSafetyLevel = currentSafetyLevel;
+			try {
+				// 序列化等级到文件（ObjectOutputStream 写入 int）
+				ObjectOutputStream oos = new ObjectOutputStream(new FileOutputStream(_CrashCountFilePath));
+				oos.writeInt(currentSafetyLevel);
+				oos.flush();
+				oos.close();
+				LogUtils.d(TAG, String.format("saveCurrentSafetyLevel writeInt currentSafetyLevel %d", currentSafetyLevel));
+			} catch (IOException e) {
+				LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+			}
+		}
 
-        volatile Integer currentSafetyLevel; // 熔断值，为 0 表示熔断了。
-        private static final int _MINI = 1;
-        private static final int _MAX = 2;
+		/**
+		 * 从本地文件加载熔断等级（应用启动时初始化）
+		 * @return 加载的等级（文件不存在则初始化为 MAX（2））
+		 */
+		public int loadCurrentSafetyLevel() {
+			LogUtils.d(TAG, "loadCurrentSafetyLevel()");
+			try {
+				File f = new File(_CrashCountFilePath);
+				if (f.exists()) {
+					// 反序列化从文件读取等级
+					ObjectInputStream ois = new ObjectInputStream(new FileInputStream(_CrashCountFilePath));
+					currentSafetyLevel = ois.readInt();
+					LogUtils.d(TAG, String.format("loadCurrentSafetyLevel() readInt currentSafetyLevel %d", currentSafetyLevel));
+				} else {
+					// 文件不存在，初始化等级为最高（2）并保存
+					currentSafetyLevel = _MAX;
+					LogUtils.d(TAG, String.format("loadCurrentSafetyLevel() currentSafetyLevel init to _MAX->%d", _MAX));
+					saveCurrentSafetyLevel(currentSafetyLevel);
+				}
+			} catch (IOException e) {
+				LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+			}
+			return currentSafetyLevel;
+		}
 
-        AppCrashSafetyWire() {
-            LogUtils.d(TAG, "AppCrashSafetyWire()");
-            currentSafetyLevel = loadCurrentSafetyLevel();
-        }
+		/**
+		 * 熔断保险丝（每次崩溃调用，降低防护等级）
+		 * @return 熔断后是否仍在防护范围内（true：是；false：已熔断）
+		 */
+		boolean burnSafetyWire() {
+			LogUtils.d(TAG, "burnSafetyWire()");
+			// 加载当前等级
+			int safeLevel = loadCurrentSafetyLevel();
+			// 若在防护范围内（1~2），等级-1 并保存
+			if (isSafetyWireWorking(safeLevel)) {
+				LogUtils.d(TAG, "burnSafetyWire() use");
+				saveCurrentSafetyLevel(safeLevel - 1);
+				// 返回熔断后的状态
+				return isSafetyWireWorking(safeLevel - 1);
+			}
+			return false;
+		}
 
-        public static synchronized AppCrashSafetyWire getInstance() {
-            if (_AppCrashSafetyWire == null) {
-                _AppCrashSafetyWire = new AppCrashSafetyWire();
-            }
-            return _AppCrashSafetyWire;
-        }
+		/**
+		 * 检查熔断等级是否在有效范围内（1~2）
+		 * @param safetyLevel 待检查的等级
+		 * @return true：在范围内（防护有效）；false：超出范围（已熔断）
+		 */
+		boolean isSafetyWireWorking(int safetyLevel) {
+			LogUtils.d(TAG, "isSafetyWireOK()");
+			LogUtils.d(TAG, String.format("SafetyLevel %d", safetyLevel));
 
-        public void setCurrentSafetyLevel(int currentSafetyLevel) {
-            this.currentSafetyLevel = currentSafetyLevel;
-        }
+			if (safetyLevel >= _MINI && safetyLevel <= _MAX) {
+				LogUtils.d(TAG, String.format("In Safety Level"));
+				return true;
+			}
+			LogUtils.d(TAG, String.format("Out of Safety Level"));
+			return false;
+		}
 
-        public int getCurrentSafetyLevel() {
-            return currentSafetyLevel;
-        }
+		/**
+		 * 立即恢复熔断等级到最高（2）
+		 * 用于重启应用后重置防护状态
+		 */
+		void resumeToMaximumImmediately() {
+			LogUtils.d(TAG, "resumeToMaximumImmediately() call saveCurrentSafetyLevel(_MAX)");
+			AppCrashSafetyWire.getInstance().saveCurrentSafetyLevel(_MAX);
+		}
 
-        public void saveCurrentSafetyLevel(int currentSafetyLevel) {
-            LogUtils.d(TAG, "saveCurrentSafetyLevel()");
-            this.currentSafetyLevel = currentSafetyLevel;
-            try {
-                ObjectOutputStream oos = new ObjectOutputStream(new FileOutputStream(_CrashCountFilePath));
-                oos.writeInt(currentSafetyLevel);
-                oos.flush();
-                oos.close();
-                LogUtils.d(TAG, String.format("saveCurrentSafetyLevel writeInt currentSafetyLevel %d", currentSafetyLevel));
-            } catch (IOException e) {
-                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-            }
-        }
+		/**
+		 * 关闭防护（设置等级为最低（1））
+		 * 下次崩溃直接熔断
+		 */
+		void off() {
+			LogUtils.d(TAG, "off()");
+			saveCurrentSafetyLevel(_MINI);
+		}
 
-        public int loadCurrentSafetyLevel() {
-            LogUtils.d(TAG, "loadCurrentSafetyLevel()");
-            try {
-                File f = new File(_CrashCountFilePath);
-                if (f.exists()) {
-                    ObjectInputStream ois = new ObjectInputStream(new FileInputStream(_CrashCountFilePath));
-                    currentSafetyLevel = ois.readInt();
-                    LogUtils.d(TAG, String.format("loadCurrentSafetyLevel() readInt currentSafetyLevel %d", currentSafetyLevel));
-                } else {
-                    currentSafetyLevel = _MAX;
-                    LogUtils.d(TAG, String.format("loadCurrentSafetyLevel() currentSafetyLevel init to _MAX->%d", _MAX));
-                    saveCurrentSafetyLevel(currentSafetyLevel);
-                }
-            } catch (IOException e) {
-                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-            }
-            return currentSafetyLevel;
-        }
+		/**
+		 * 检查当前保险丝是否有效（防护未熔断）
+		 * @return true：有效（等级 1~2）；false：已熔断
+		 */
+		boolean isAppCrashSafetyWireOK() {
+			LogUtils.d(TAG, "isAppCrashSafetyWireOK()");
+			currentSafetyLevel = loadCurrentSafetyLevel();
+			return isSafetyWireWorking(currentSafetyLevel);
+		}
 
-        boolean burnSafetyWire() {
-            LogUtils.d(TAG, "burnSafetyWire()");
-            // 崩溃计数进入崩溃保险值
-            int safeLevel = loadCurrentSafetyLevel();
-            if (isSafetyWireWorking(safeLevel)) {
-                // 如果保险丝未熔断, 就增加一次熔断值
-                LogUtils.d(TAG, "burnSafetyWire() use");
-                saveCurrentSafetyLevel(safeLevel - 1);
-                return isSafetyWireWorking(safeLevel - 1);
-            }
-            return false;
-        }
+		/**
+		 * 延迟恢复保险丝到最高等级（500ms 后）
+		 * 核心作用：崩溃页面启动后，若下次即将熔断，提前恢复防护等级，避免持续崩溃
+		 * @param context 上下文（用于获取主线程 Handler）
+		 */
+		void postResumeCrashSafetyWireHandler(final Context context) {
+			// 主线程延迟 500ms 执行（避免页面启动时阻塞）
+			new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+					@Override
+					public void run() {
+						LogUtils.d(TAG, "Handler run()");
+						// 检查：若当前等级-1 后超出防护范围（即将熔断），则恢复到最高等级
+						if (!AppCrashSafetyWire.getInstance().isSafetyWireWorking(currentSafetyLevel - 1)) {
+							AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+							LogUtils.d(TAG, "postResumeCrashSafetyWireHandler: 恢复保险丝到最高等级");
+						}
+					}
+				}, 500);
+		}
+	}
 
-        boolean isSafetyWireWorking(int safetyLevel) {
-            LogUtils.d(TAG, "isSafetyWireOK()");
-            //safetyLevel = _MINI;
-            //safetyLevel = _MINI - 1;
-            //safetyLevel = _MINI + 1;
-            //safetyLevel = _MAX;
-            //safetyLevel = _MAX + 1;
-            LogUtils.d(TAG, String.format("SafetyLevel %d", safetyLevel));
+	/**
+	 * 基础版崩溃报告页面（保险丝熔断时启动）
+	 * 极简实现：仅展示崩溃日志，提供复制、重启功能，避免复杂布局导致二次崩溃
+	 */
+	public static final class CrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
+		/** 菜单标识：复制崩溃日志 */
+		private static final int MENUITEM_COPY = 0;
+		/** 菜单标识：重启应用 */
+		private static final int MENUITEM_RESTART = 1;
 
-            if (safetyLevel >= _MINI && safetyLevel <= _MAX) {
-                // 如果在保险值之内
-                LogUtils.d(TAG, String.format("In Safety Level"));
-                return true;
-            }
-            LogUtils.d(TAG, String.format("Out of Safety Level"));
-            return false;
-        }
+		/** 崩溃日志文本（从 CrashHandler 传递过来） */
+		private String mLog;
 
-        void resumeToMaximumImmediately() {
-            LogUtils.d(TAG, "resumeToMaximumImmediately() call saveCurrentSafetyLevel(_MAX)");
-            AppCrashSafetyWire.getInstance().saveCurrentSafetyLevel(_MAX);
-        }
+		@Override
+		protected void onCreate(Bundle savedInstanceState) {
+			super.onCreate(savedInstanceState);
+			// 初始化崩溃保险丝延迟恢复机制
+			AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(getApplicationContext());
 
-        void off() {
-            LogUtils.d(TAG, "off()");
-            saveCurrentSafetyLevel(_MINI);
-        }
+			// 获取传递的崩溃日志
+			mLog = getIntent().getStringExtra(EXTRA_CRASH_INFO);
+			// 设置系统默认主题（避免自定义主题冲突）
+			setTheme(android.R.style.Theme_DeviceDefault_Light_DarkActionBar);
 
-        boolean isAppCrashSafetyWireOK() {
-            LogUtils.d(TAG, "isAppCrashSafetyWireOK()");
-            currentSafetyLevel = loadCurrentSafetyLevel();
-            return isSafetyWireWorking(currentSafetyLevel);
-        }
+			// 动态创建布局（避免 XML 布局加载异常）
+			setContentView: {
+				// 垂直滚动视图（处理日志过长）
+				ScrollView contentView = new ScrollView(this);
+				contentView.setFillViewport(true);
 
-        // 调用函数以启用持续崩溃保险，从而调用 CrashHandler 内部崩溃处理窗口
-        void postResumeCrashSafetyWireHandler(final Context context) {
-            new Handler(Looper.getMainLooper()).postDelayed(new Runnable(){
-                    @Override
-                    public void run() {
-                        LogUtils.d(TAG, "Handler run()");
-                        if (!AppCrashSafetyWire.getInstance().isSafetyWireWorking(currentSafetyLevel - 1)) {
-                            // 如果下一次应用崩溃时，保险丝熔断，则先恢复保险丝满能状态
-                            // 进程持续运行时，恢复保险丝熔断值
-                            //Resume to maximum
-                            AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
-                            LogUtils.d(TAG, "postResumeCrashSafetyWireHandler");
-                        }         
-                    }
-                }, 500);
-        }
-    }
+				// 水平滚动视图（处理日志行过长）
+				HorizontalScrollView hw = new HorizontalScrollView(this);
+				hw.setBackgroundColor(Color.GRAY); // 背景色设为灰色
 
-    public static final class CrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
-        private static final int MENUITEM_COPY = 0;
-        private static final int MENUITEM_RESTART = 1;
+				// 日志显示文本框
+				TextView message = new TextView(this);
+				{
+					int padding = dp2px(16); // 内边距 16dp（适配不同屏幕）
+					message.setPadding(padding, padding, padding, padding);
+					message.setText(mLog); // 设置崩溃日志
+					message.setTextColor(Color.BLACK); // 文字黑色
+					message.setTextIsSelectable(true); // 支持文本选择（便于手动复制）
+				}
 
-        private String mLog;
+				// 组装布局：TextView -> HorizontalScrollView -> ScrollView
+				hw.addView(message);
+				contentView.addView(hw, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+				// 设置当前 Activity 布局
+				setContentView(contentView);
 
-        @Override
-        protected void onCreate(Bundle savedInstanceState) {
-            super.onCreate(savedInstanceState);
-            AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(getApplicationContext());
+				// 配置 ActionBar 标题和副标题
+				getActionBar().setTitle(TITTLE);
+				getActionBar().setSubtitle(GlobalApplication.class.getSimpleName() + " Error");
+			}
+		}
 
-            mLog = getIntent().getStringExtra(EXTRA_CRASH_INFO);
-            setTheme(android.R.style.Theme_DeviceDefault_Light_DarkActionBar);
-            setContentView: {
-                ScrollView contentView = new ScrollView(this);
-                contentView.setFillViewport(true);
+		/**
+		 * 重写返回键逻辑：点击返回键直接重启应用
+		 */
+		@Override
+		public void onBackPressed() {
+			restart();
+		}
 
-                HorizontalScrollView hw = new HorizontalScrollView(this);
-                hw.setBackgroundColor(Color.GRAY);
-                TextView message = new TextView(this); {
-                    int padding = dp2px(16);
-                    message.setPadding(padding, padding, padding, padding);
-                    message.setText(mLog);
-                    message.setTextColor(Color.BLACK);
-                    message.setTextIsSelectable(true);
-                }
-                hw.addView(message);
+		/**
+		 * 重启当前应用（与 GlobalCrashActivity 逻辑一致）
+		 * 清除任务栈，启动主 Activity，终止当前进程
+		 */
+		private void restart() {
+			PackageManager pm = getPackageManager();
+			// 获取应用启动意图（默认启动主 Activity）
+			Intent intent = pm.getLaunchIntentForPackage(getPackageName());
+			if (intent != null) {
+				// 设置意图标志：清除原有任务栈，创建新任务
+				intent.addFlags(
+					Intent.FLAG_ACTIVITY_NEW_TASK
+					| Intent.FLAG_ACTIVITY_CLEAR_TOP
+					| Intent.FLAG_ACTIVITY_CLEAR_TASK
+				);
+				startActivity(intent);
+			}
+			// 关闭当前页面，终止进程，确保完全重启
+			finish();
+			android.os.Process.killProcess(android.os.Process.myPid());
+			System.exit(0);
+		}
 
-                contentView.addView(hw, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
-                setContentView(contentView);
-                getActionBar().setTitle(TITTLE);
-                getActionBar().setSubtitle(GlobalApplication.class.getSimpleName() + " Error");
-            }
-        }
+		/**
+		 * dp 转 px（适配不同屏幕密度）
+		 * @param dpValue dp 值
+		 * @return 转换后的 px 值
+		 */
+		private int dp2px(final float dpValue) {
+			final float scale = Resources.getSystem().getDisplayMetrics().density;
+			return (int) (dpValue * scale + 0.5f); // 四舍五入确保精度
+		}
 
-        @Override
-        public void onBackPressed() {
-            restart();
-        }
+		/**
+		 * 菜单点击事件回调（处理复制、重启）
+		 * @param item 被点击的菜单项
+		 * @return false：不消费事件（保持默认行为）
+		 */
+		@Override
+		public boolean onMenuItemClick(MenuItem item) {
+			switch (item.getItemId()) {
+				case MENUITEM_COPY:
+					// 复制日志到剪贴板
+					ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+					cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+					Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
+					break;
+				case MENUITEM_RESTART:
+					// 恢复保险丝到最高等级，然后重启应用
+					AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+					restart();
+					break;
+			}
+			return false;
+		}
 
-        private void restart() {
-            PackageManager pm = getPackageManager();
-            Intent intent = pm.getLaunchIntentForPackage(getPackageName());
-            if (intent != null) {
-                intent.addFlags(
-                    Intent.FLAG_ACTIVITY_NEW_TASK
-                    | Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_CLEAR_TASK
-                );
-                startActivity(intent);
-            }
-            finish();
-            android.os.Process.killProcess(android.os.Process.myPid());
-            System.exit(0);
-        }
-
-        private int dp2px(final float dpValue) {
-            final float scale = Resources.getSystem().getDisplayMetrics().density;
-            return (int) (dpValue * scale + 0.5f);
-        }
-
-        @Override
-        public boolean onMenuItemClick(MenuItem item) {
-            switch (item.getItemId()) {
-                case MENUITEM_COPY: 
-                    ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
-                    cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
-                    Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
-                    break;
-                case MENUITEM_RESTART: 
-                    AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
-                    restart();
-                    break;
-            }
-            return false;
-        }
-
-        @Override
-        public boolean onCreateOptionsMenu(Menu menu) {
-            menu.add(0, MENUITEM_COPY, 0, "Copy").setOnMenuItemClickListener(this)
-                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
-            menu.add(0, MENUITEM_RESTART, 0, "Restart").setOnMenuItemClickListener(this)
-                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
-            return true;
-        }
-    }
+		/**
+		 * 创建 ActionBar 菜单（添加复制、重启项）
+		 * @param menu 菜单容器
+		 * @return true：显示菜单
+		 */
+		@Override
+		public boolean onCreateOptionsMenu(Menu menu) {
+			// 添加「复制」菜单：有空间时显示在 ActionBar，否则放入溢出菜单
+			menu.add(0, MENUITEM_COPY, 0, "Copy")
+				.setOnMenuItemClickListener(this)
+				.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+			// 添加「重启」菜单：同上
+			menu.add(0, MENUITEM_RESTART, 0, "Restart")
+				.setOnMenuItemClickListener(this)
+				.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+			return true;
+		}
+	}
 }
 

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

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

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

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

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

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

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

@@ -1,129 +1,240 @@
 package cc.winboll.studio.libappbase;
 
-/**
- * @Author ZhanGSKen<zhangsken@qq.com>
- * @Date 2025/03/12 12:29:01
- * @Describe 水平布局的 ListView
- */
 import android.content.Context;
 import android.util.AttributeSet;
 import android.view.View;
 import android.widget.ListView;
 import android.widget.Scroller;
-import cc.winboll.studio.libappbase.LogUtils;
 
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:26
+ * @Describe 水平滚动 ListView 控件
+ * 继承自 ListView，重写布局和测量逻辑，实现子项水平排列和滚动，替代默认垂直布局
+ */
 public class HorizontalListView extends ListView {
-    public static final String TAG = "HorizontalListView";
-    private int verticalOffset = 0;
-    private Scroller scroller;
-    private int totalWidth;
+	/** 日志标签，用于当前控件的日志输出标识 */
+	public static final String TAG = "HorizontalListView";
 
-    public HorizontalListView(Context context) {
-        super(context);
-        init();
-    }
+	/** 子项垂直偏移量（用于调整子项在垂直方向的位置，默认 0） */
+	private int mVerticalOffset = 0;
+	/** 平滑滚动控制器（用于实现水平方向的平滑滚动动画） */
+	private Scroller mScroller;
+	/** 所有子项总宽度（包含内边距），用于计算滚动范围 */
+	private int mTotalWidth;
 
-    public HorizontalListView(Context context, AttributeSet attrs) {
-        super(context, attrs);
-        init();
-    }
+	/**
+	 * 构造方法：仅上下文
+	 * @param context 上下文（Activity/Fragment）
+	 */
+	public HorizontalListView(Context context) {
+		super(context);
+		init();
+	}
 
-    public HorizontalListView(Context context, AttributeSet attrs, int defStyle) {
-        super(context, attrs, defStyle);
-        init();
-    }
+	/**
+	 * 构造方法：上下文 + 自定义属性
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合（如布局文件中设置的属性）
+	 */
+	public HorizontalListView(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		init();
+	}
 
-    private void init() {
-        scroller = new Scroller(getContext());
-        setHorizontalScrollBarEnabled(true);
-        setVerticalScrollBarEnabled(false);
-    }
+	/**
+	 * 构造方法：上下文 + 自定义属性 + 样式属性
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合
+	 * @param defStyle 样式属性（如系统默认样式）
+	 */
+	public HorizontalListView(Context context, AttributeSet attrs, int defStyle) {
+		super(context, attrs, defStyle);
+		init();
+	}
 
-    public void setVerticalOffset(int verticalOffset) {
-        this.verticalOffset = verticalOffset;
-    }
+	/**
+	 * 初始化控件配置
+	 * 初始化滚动控制器，设置滚动条显示状态
+	 */
+	private void init() {
+		// 初始化平滑滚动器（上下文为当前控件所在上下文）
+		mScroller = new Scroller(getContext());
+		// 启用水平滚动条（默认显示）
+		setHorizontalScrollBarEnabled(true);
+		// 禁用垂直滚动条（水平列表无需垂直滚动）
+		setVerticalScrollBarEnabled(false);
+	}
 
-    @Override
-    protected void onLayout(boolean changed, int l, int t, int r, int b) {
-        super.onLayout(changed, l, t, r, b);
-        int childCount = getChildCount();
-        int left = getPaddingLeft();
-        int viewHeight = getMeasuredHeight() - getPaddingTop() - getPaddingBottom();
-        totalWidth = left;
+	/**
+	 * 设置子项垂直偏移量
+	 * 用于整体调整所有子项在垂直方向的位置（如居中、偏移）
+	 * @param verticalOffset 垂直偏移像素值（正数向下偏移，负数向上偏移）
+	 */
+	public void setVerticalOffset(int verticalOffset) {
+		this.mVerticalOffset = verticalOffset;
+	}
 
-        for (int i = 0; i < childCount; i++) {
-            View child = getChildAt(i);
-            int width = child.getMeasuredWidth();
-            int height = child.getMeasuredHeight();
-            child.layout(left, verticalOffset, left + width, verticalOffset + height);
-            left += width;
-        }
-        totalWidth = left + getPaddingRight();
-    }
+	/**
+	 * 重写布局方法：实现子项水平排列
+	 * 遍历所有子项，按水平方向依次布局（左对齐，叠加排列）
+	 * @param changed 布局是否发生变化（true：首次布局或尺寸变化；false：重绘）
+	 * @param l 控件左边界坐标
+	 * @param t 控件上边界坐标
+	 * @param r 控件右边界坐标
+	 * @param b 控件下边界坐标
+	 */
+	@Override
+	protected void onLayout(boolean changed, int l, int t, int r, int b) {
+		super.onLayout(changed, l, t, r, b); // 执行父类布局逻辑（确保基础配置生效）
 
-    @Override
-    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
-        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
-        int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
-        super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
-    }
+		int childCount = getChildCount(); // 获取当前可见子项数量
+		int left = getPaddingLeft(); // 子项起始左坐标（包含控件左内边距）
+		// 控件可用高度（总高度 - 上下内边距）
+		int viewHeight = getMeasuredHeight() - getPaddingTop() - getPaddingBottom();
+		mTotalWidth = left; // 初始化总宽度为左内边距
 
-    @Override
-    public void computeScroll() {
-        if (scroller.computeScrollOffset()) {
-            scrollTo(scroller.getCurrX(), scroller.getCurrY());
-            postInvalidate();
-        }
-    }
+		// 遍历子项，水平排列
+		for (int i = 0; i < childCount; i++) {
+			View child = getChildAt(i); // 获取当前子项
+			int childWidth = child.getMeasuredWidth(); // 子项测量宽度
+			int childHeight = child.getMeasuredHeight(); // 子项测量高度
 
-    public void smoothScrollTo(int x, int y) {
-        int dx = x - getScrollX();
-        int dy = y - getScrollY();
-        scroller.startScroll(getScrollX(), getScrollY(), dx, dy, 300); // 300ms平滑动画
-        invalidate();
-    }
+			// 布局子项：水平方向从 left 开始，垂直方向偏移 mVerticalOffset
+			child.layout(
+				left,                      // 子项左边界
+				mVerticalOffset,           // 子项上边界（带垂直偏移）
+				left + childWidth,         // 子项右边界（左 + 宽度）
+				mVerticalOffset + childHeight // 子项下边界（偏移 + 高度）
+			);
 
-    @Override
-    public int computeHorizontalScrollRange() {
-        return totalWidth;
-    }
+			left += childWidth; // 更新下一个子项的起始左坐标
+		}
 
-    @Override
-    public int computeHorizontalScrollOffset() {
-        return getScrollX();
-    }
+		// 计算总宽度（所有子项宽度 + 左右内边距）
+		mTotalWidth = left + getPaddingRight();
+	}
 
-    @Override
-    public int computeHorizontalScrollExtent() {
-        return getWidth();
-    }
+	/**
+	 * 重写测量方法：设置控件测量规则
+	 * 水平方向：允许无限宽度（适应所有子项总宽度）；垂直方向：自适应内容高度
+	 * @param widthMeasureSpec 父控件传递的宽度测量规格
+	 * @param heightMeasureSpec 父控件传递的高度测量规格
+	 */
+	@Override
+	protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+		// 重写宽度测量规则：最大值（Integer.MAX_VALUE >> 2 避免溢出），自适应内容
+		int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+		// 重写高度测量规则：同上，自适应子项高度
+		int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
 
-    public void scrollToItem(int position) {
-        if (position < 0 || position >= getChildCount()) {
-            LogUtils.d(TAG, "无效的position: " + position);
-            return;
-        }
+		// 执行父类测量逻辑（使用重写后的测量规格）
+		super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
+	}
 
-        View targetView = getChildAt(position);
-        int targetLeft = targetView.getLeft();
-        int scrollX = targetLeft - getPaddingLeft();
+	/**
+	 * 重写滚动计算方法：实现平滑滚动
+	 * 配合 Scroller 实现水平方向的平滑滚动动画（需在滚动时调用 invalidate() 触发）
+	 */
+	@Override
+	public void computeScroll() {
+		// 判断滚动是否正在进行（Scroller 计算当前滚动位置）
+		if (mScroller.computeScrollOffset()) {
+			// 滚动到当前计算的位置（x 轴水平滚动，y 轴固定 0）
+			scrollTo(mScroller.getCurrX(), mScroller.getCurrY());
+			// 触发重绘，持续更新滚动状态
+			postInvalidate();
+		}
+	}
 
-        // 修正最大滚动范围计算
-        int maxScrollX = totalWidth;
-        scrollX = Math.max(0, Math.min(scrollX, maxScrollX));
+	/**
+	 * 平滑滚动到指定坐标
+	 * 基于 Scroller 实现水平方向的平滑滚动（300ms 动画时长）
+	 * @param x 目标 x 轴坐标（水平滚动位置）
+	 * @param y 目标 y 轴坐标（固定 0，无需垂直滚动）
+	 */
+	public void smoothScrollTo(int x, int y) {
+		// 计算滚动距离（目标坐标 - 当前滚动坐标）
+		int dx = x - getScrollX();
+		int dy = y - getScrollY();
 
-        // 强制重新布局和绘制
-        requestLayout();
-        invalidateViews();
-        smoothScrollTo(scrollX, 0);
-        LogUtils.d(TAG, String.format("滚动到position: %d, scrollX: %d computeHorizontalScrollRange() %d", position, scrollX, computeHorizontalScrollRange()));
-    }
-    
-    public void resetScrollToStart() {
-        // 强制重新布局和绘制
-        requestLayout();
-        invalidateViews();
-        smoothScrollTo(0, 0);
-    }
+		// 启动平滑滚动：起始坐标（当前滚动位置）、滚动距离、动画时长（300ms）
+		mScroller.startScroll(getScrollX(), getScrollY(), dx, dy, 300);
+		// 触发重绘，启动滚动动画
+		invalidate();
+	}
+
+	/**
+	 * 计算水平滚动总范围（用于滚动条显示比例）
+	 * @return 滚动总宽度（所有子项总宽度 + 内边距）
+	 */
+	@Override
+	public int computeHorizontalScrollRange() {
+		return mTotalWidth;
+	}
+
+	/**
+	 * 计算当前水平滚动偏移量（用于滚动条位置）
+	 * @return 当前 x 轴滚动坐标
+	 */
+	@Override
+	public int computeHorizontalScrollOffset() {
+		return getScrollX();
+	}
+
+	/**
+	 * 计算水平滚动可视范围（用于滚动条大小）
+	 * @return 控件可见宽度（当前显示区域宽度）
+	 */
+	@Override
+	public int computeHorizontalScrollExtent() {
+		return getWidth();
+	}
+
+	/**
+	 * 滚动到指定位置的子项（水平方向）
+	 * 定位目标子项，计算滚动坐标，执行平滑滚动
+	 * @param position 子项索引（从 0 开始，仅当前可见子项有效）
+	 */
+	public void scrollToItem(int position) {
+		// 校验索引有效性（避免数组越界）
+		if (position < 0 || position >= getChildCount()) {
+			LogUtils.d(TAG, "无效的子项索引: " + position);
+			return;
+		}
+
+		View targetView = getChildAt(position); // 获取目标子项
+		int targetLeft = targetView.getLeft(); // 目标子项左边界坐标
+		// 计算目标滚动坐标（子项左边界 - 控件左内边距，确保子项左对齐显示）
+		int scrollX = targetLeft - getPaddingLeft();
+
+		// 修正滚动范围（避免超出总宽度或小于 0）
+		int maxScrollX = mTotalWidth - getWidth(); // 最大滚动坐标（总宽度 - 控件宽度）
+		scrollX = Math.max(0, Math.min(scrollX, maxScrollX));
+
+		// 强制重新布局和绘制（确保子项位置正确）
+		requestLayout();
+		invalidateViews();
+		// 平滑滚动到目标坐标
+		smoothScrollTo(scrollX, 0);
+
+		// 打印滚动日志（调试用）
+		LogUtils.d(TAG, String.format(
+					   "滚动到子项索引: %d, 目标滚动X: %d, 总滚动范围: %d",
+					   position, scrollX, computeHorizontalScrollRange()
+				   ));
+	}
+
+	/**
+	 * 重置滚动到起始位置（最左侧）
+	 * 强制重新布局后，平滑滚动到 x=0 坐标
+	 */
+	public void resetScrollToStart() {
+		// 强制重新布局和绘制（确保滚动位置准确）
+		requestLayout();
+		invalidateViews();
+		// 平滑滚动到最左侧（x=0，y=0）
+		smoothScrollTo(0, 0);
+	}
 }
 

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

@@ -1,10 +1,5 @@
 package cc.winboll.studio.libappbase;
 
-/**
- * @Author ZhanGSKen<zhangsken@qq.com>
- * @Date 2025/03/25 20:34:47
- * @Describe 应用日志窗口
- */
 import android.app.Activity;
 import android.content.Context;
 import android.content.Intent;
@@ -12,35 +7,59 @@ import android.os.Bundle;
 import cc.winboll.studio.libappbase.LogView;
 import cc.winboll.studio.libappbase.R;
 
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:29
+ * @Describe 应用日志展示 Activity
+ * 用于单独启动窗口展示应用运行日志，依赖 LogView 控件实现日志加载与显示
+ */
 public class LogActivity extends Activity {
 
+    /** 日志标签，用于当前 Activity 的日志输出标识 */
     public static final String TAG = "LogActivity";
 
-    LogView mLogView;
+    /** 日志展示控件（用于加载和显示应用日志） */
+    private LogView mLogView;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
+        // 设置布局文件（包含 LogView 控件）
         setContentView(R.layout.activity_log);
-        //ToastUtils.show("LogActivity onCreate");
 
+        // 绑定布局中的 LogView 控件
         mLogView = findViewById(R.id.logview);
+        // 启动 LogView 日志加载（如实时刷新日志内容）
         mLogView.start();
     }
 
     @Override
     protected void onResume() {
         super.onResume();
+        // 恢复 Activity 时重新启动 LogView（确保日志持续更新）
         mLogView.start();
     }
 
-	public static void startLogActivity(Context context) {
-		Intent intent = new Intent(context, LogActivity.class);
-        // 打开多任务窗口
+    /**
+     * 启动日志 Activity 的静态方法（外部调用入口）
+     * 配置 Intent 标志，以多任务/分屏模式启动，避免与主应用任务栈冲突
+     * @param context 上下文（Activity/Fragment），用于启动 Activity
+     */
+    public static void startLogActivity(Context context) {
+        // 创建启动当前 Activity 的 Intent
+        Intent intent = new Intent(context, LogActivity.class);
+
+        // 添加 Intent 标志：支持分屏/多窗口模式（API 24+）
         intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
+        // 添加 Intent 标志：创建新任务栈（避免并入调用者任务栈）
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 添加 Intent 标志：标记为新文档（多任务窗口中独立显示）
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+        // 添加 Intent 标志：允许创建多个任务实例（支持多次启动独立窗口）
         intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+
+        // 启动 Activity
         context.startActivity(intent);
-	}
+    }
 }
+

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

@@ -1,13 +1,6 @@
 package cc.winboll.studio.libappbase;
 
-/**
- * @Author ZhanGSKen<zhangsken@qq.com>
- * @Date 2024/08/12 13:44:06
- * @Describe LogUtils
- * @Describe 应用日志类
- */
 import android.content.Context;
-import cc.winboll.studio.libappbase.GlobalApplication;
 import dalvik.system.DexFile;
 import java.io.BufferedReader;
 import java.io.BufferedWriter;
@@ -28,353 +21,617 @@ import java.util.List;
 import java.util.Locale;
 import java.util.Map;
 
-
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:36
+ * @Describe WinBoLl 应用日志管理工具类（单例逻辑）
+ * 核心功能：日志分级控制、日志文件读写、TAG 过滤配置、应用内所有 TAG 自动扫描
+ * 支持 Debug/Release 模式区分存储路径，日志持久化与清理
+ * 适配 Java 7 语法，移除 Lambda、Stream 等 Java 8+ 特性
+ */
 public class LogUtils {
 
+    /** 当前工具类的日志 TAG */
     public static final String TAG = "LogUtils";
 
+    /**
+     * 日志级别枚举（从低到高：关闭→错误→警告→信息→调试→详细）
+     * 级别越高，输出的日志越详细
+     */
     public static enum LOG_LEVEL { Off, Error, Warn, Info, Debug, Verbose }
 
-    static volatile boolean _IsInited = false;
-    static Context _mContext;
-    // 日志显示时间格式
-    static SimpleDateFormat mSimpleDateFormat = new SimpleDateFormat("[yyyyMMdd_HHmmss_SSS]", Locale.getDefault());
-    // 应用日志文件夹
-    static File _mfLogCacheDir;
-    static File _mfLogDataDir;
-    // 应用日志文件
-    static File _mfLogCatchFile;
-    static File _mfLogUtilsBeanFile;
-    static LogUtilsBean _mLogUtilsBean;
-    public static Map<String, Boolean> mapTAGList = new HashMap<String, Boolean>();
+    /** 是否初始化完成标志（volatile 保证多线程可见性） */
+    private static volatile boolean sIsInited = false;
+    /** 全局上下文（用于获取存储路径、包信息） */
+    private static Context sContext;
+    /** 日志时间格式化工具（格式：[yyyyMMdd_HHmmss_SSS]，精确到毫秒） */
+    private static SimpleDateFormat sSimpleDateFormat = new SimpleDateFormat("[yyyyMMdd_HHmmss_SSS]", Locale.getDefault());
+    /** 日志缓存文件夹（Debug 模式下存储在外部缓存，Release 存储在内部缓存） */
+    private static File sLogCacheDir;
+    /** 日志配置文件夹（存储 TAG 配置文件） */
+    private static File sLogDataDir;
+    /** 日志存储文件（所有日志写入此文件） */
+    private static File sLogFile;
+    /** 日志配置文件（存储日志级别、TAG 启用状态等配置） */
+    private static File sLogConfigFile;
+    /** 日志配置实体类（封装日志级别等配置） */
+    private static LogUtilsBean sLogConfigBean;
+    /** TAG 过滤映射表（key：TAG 名称；value：是否启用该 TAG 的日志输出） */
+    public static Map<String, Boolean> sTagEnableMap = new HashMap<String, Boolean>();
 
-    //
-    // 初始化函数
-    //
+    /**
+     * 初始化日志工具（默认日志级别：Off，不输出日志）
+     * @param context 全局上下文（建议传入 Application 实例）
+     */
     public static void init(Context context) {
-        _mContext = context;
+        sContext = context;
         init(context, LOG_LEVEL.Off);
     }
 
-    //
-    // 初始化函数
-    //
+    /**
+     * 初始化日志工具（指定日志级别）
+     * 1. 根据 Debug/Release 模式初始化日志存储路径；
+     * 2. 加载日志配置文件；
+     * 3. 扫描应用内所有类的 TAG 并初始化过滤映射表；
+     * 4. 标记初始化完成。
+     * @param context 全局上下文
+     * @param logLevel 初始日志级别
+     */
     public static void init(Context context, LOG_LEVEL logLevel) {
-        if (GlobalApplication.isDebuging()) {
-            // 初始化日志缓存文件路径
-            _mfLogCacheDir = new File(context.getApplicationContext().getExternalCacheDir(), TAG);
-            if (!_mfLogCacheDir.exists()) {
-                _mfLogCacheDir.mkdirs();
-            }
-            _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
-
-            // 初始化日志配置文件路径
-            _mfLogDataDir = context.getApplicationContext().getExternalFilesDir(TAG);
-            if (!_mfLogDataDir.exists()) {
-                _mfLogDataDir.mkdirs();
-            }
-            _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
+        sContext = context;
+        // 根据 Debug 模式选择存储路径（外部/内部存储）
+        if (GlobalApplication.isDebugging()) {
+            // Debug 模式：存储在外部缓存目录（可通过文件管理器查看）
+            sLogCacheDir = new File(context.getApplicationContext().getExternalCacheDir(), TAG);
+            sLogDataDir = context.getApplicationContext().getExternalFilesDir(TAG);
         } else {
-            // 初始化日志缓存文件路径
-            _mfLogCacheDir = new File(context.getApplicationContext().getCacheDir(), TAG);
-            if (!_mfLogCacheDir.exists()) {
-                _mfLogCacheDir.mkdirs();
+            // Release 模式：存储在内部缓存目录（仅应用自身可访问）
+            sLogCacheDir = new File(context.getApplicationContext().getCacheDir(), TAG);
+            sLogDataDir = new File(context.getApplicationContext().getFilesDir(), TAG);
+        }
+
+        // 创建日志文件夹（不存在则创建）
+        createDirIfNotExists(sLogCacheDir);
+        createDirIfNotExists(sLogDataDir);
+
+        // 初始化日志文件和配置文件路径
+        sLogFile = new File(sLogCacheDir, "log.txt");
+        sLogConfigFile = new File(sLogDataDir, TAG + ".json");
+
+        // 加载日志配置（从文件读取，读取失败则创建默认配置）
+        sLogConfigBean = LogUtilsBean.loadBeanFromFile(sLogConfigFile.getPath(), LogUtilsBean.class);
+        if (sLogConfigBean == null) {
+            sLogConfigBean = new LogUtilsBean();
+            sLogConfigBean.setLogLevel(logLevel);
+            // 保存默认配置到文件
+            sLogConfigBean.saveBeanToFile(sLogConfigFile.getPath(), sLogConfigBean);
+        }
+
+        // 扫描应用内所有类的 TAG 并添加到过滤映射表
+        scanAllClassTags();
+        // 加载已保存的 TAG 启用状态配置
+        loadTagEnableSettings();
+        // 标记初始化完成
+        sIsInited = true;
+
+        // 打印初始化日志（调试用）
+        d(TAG, String.format("TAG 过滤映射表初始化完成：%s", sTagEnableMap.toString()));
+    }
+
+    /**
+     * 获取 TAG 过滤映射表（外部可通过此方法获取所有 TAG 及其启用状态）
+     * @return TAG 名称与启用状态的映射
+     */
+    public static Map<String, Boolean> getTagEnableMap() {
+        return sTagEnableMap;
+    }
+
+    /**
+     * 加载已保存的 TAG 启用状态配置
+     * 从 LogUtilsClassTAGBean 列表中读取每个 TAG 的启用状态，更新到映射表
+     */
+    private static void loadTagEnableSettings() {
+        ArrayList<LogUtilsClassTAGBean> tagSettingList = new ArrayList<LogUtilsClassTAGBean>();
+        // 从文件加载 TAG 配置列表
+        LogUtilsClassTAGBean.loadBeanList(sContext, tagSettingList, LogUtilsClassTAGBean.class);
+
+        // 遍历配置列表，更新 TAG 启用状态（Java 7 增强 for 循环）
+        for (LogUtilsClassTAGBean tagSetting : tagSettingList) {
+            String tag = tagSetting.getTag();
+            boolean isEnable = tagSetting.getEnable();
+            // 仅更新已存在的 TAG（避免无效配置）
+            if (sTagEnableMap.containsKey(tag)) {
+                sTagEnableMap.put(tag, isEnable);
             }
-            _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
-
-            // 初始化日志配置文件路径
-            _mfLogDataDir = new File(context.getApplicationContext().getFilesDir(), TAG);
-            if (!_mfLogDataDir.exists()) {
-                _mfLogDataDir.mkdirs();
-            }
-            _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
-        }
-
-//        Toast.makeText(context,
-//                       "_mfLogUtilsBeanFile : " + _mfLogUtilsBeanFile
-//                       + "\n_mfLogCatchFile : " + _mfLogCatchFile,
-//                       Toast.LENGTH_SHORT).show();
-//
-        _mLogUtilsBean = LogUtilsBean.loadBeanFromFile(_mfLogUtilsBeanFile.getPath(), LogUtilsBean.class);
-        if (_mLogUtilsBean == null) {
-            _mLogUtilsBean = new LogUtilsBean();
-            _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
-        }
-
-        // 加载当前应用下的所有类的 TAG
-        addClassTAGList();
-        loadTAGBeanSettings();
-        _IsInited = true;
-        LogUtils.d(TAG, String.format("mapTAGList : %s", mapTAGList.toString()));
-    }
-
-    public static Map<String, Boolean> getMapTAGList() {
-        return mapTAGList;
-    }
-
-    static void loadTAGBeanSettings() {
-        ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
-        LogUtilsClassTAGBean.loadBeanList(_mContext, list, LogUtilsClassTAGBean.class);
-        for (int i = 0; i < list.size(); i++) {
-            LogUtilsClassTAGBean beanSetting = list.get(i);
-            for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
-                if (entry.getKey().equals(beanSetting.getTag())) {
-                    entry.setValue(beanSetting.getEnable());
-                }
-            }
-
         }
     }
 
-    static void saveTAGBeanSettings() {
-        ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
-        for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
-            list.add(new LogUtilsClassTAGBean(entry.getKey(), entry.getValue()));
+    /**
+     * 保存当前 TAG 启用状态配置到文件
+     * 将映射表中的 TAG 及其启用状态转换为 LogUtilsClassTAGBean 列表，持久化到文件
+     */
+    private static void saveTagEnableSettings() {
+        ArrayList<LogUtilsClassTAGBean> tagSettingList = new ArrayList<LogUtilsClassTAGBean>();
+        // 遍历映射表，构建配置列表（Java 7 迭代器遍历）
+        Iterator<Map.Entry<String, Boolean>> iterator = sTagEnableMap.entrySet().iterator();
+        while (iterator.hasNext()) {
+            Map.Entry<String, Boolean> entry = iterator.next();
+            tagSettingList.add(new LogUtilsClassTAGBean(entry.getKey(), entry.getValue()));
         }
-        LogUtilsClassTAGBean.saveBeanList(_mContext, list, LogUtilsClassTAGBean.class);
+        // 保存配置列表到文件
+        LogUtilsClassTAGBean.saveBeanList(sContext, tagSettingList, LogUtilsClassTAGBean.class);
     }
 
-    static void addClassTAGList() {
-        //ClassLoader classLoader = getClass().getClassLoader();
+    /**
+     * 扫描应用内所有类的 TAG 并添加到过滤映射表
+     * 1. 通过 DexFile 读取 APK 中所有类；
+     * 2. 过滤指定包名前缀（cc.winboll.studio）的类；
+     * 3. 反射获取类中 public static final String TAG 字段的值；
+     * 4. 将 TAG 加入映射表，默认禁用（false）。
+     */
+    private static void scanAllClassTags() {
         try {
-            //String packageName = context.getPackageName();
-            String packageNamePrefix = "cc.winboll.studio";
-            List<String> classNames = new ArrayList<>();
-            String apkPath = _mContext.getPackageCodePath();
-            //Log.d("APK_PATH", "The APK path is: " + apkPath);
-            LogUtils.d(TAG, String.format("apkPath : %s", apkPath));
-            //String apkPath = "/data/app/" + packageName + "-";
+            // 应用 APK 路径（通过上下文获取）
+            String apkPath = sContext.getPackageCodePath();
+            d(TAG, String.format("APK 路径：%s", apkPath));
 
-            //DexFile dexfile = new DexFile(apkPath + "1/base.apk");
-            DexFile dexfile = new DexFile(apkPath);
+            // 读取 APK 中的所有类
+            DexFile dexFile = new DexFile(apkPath);
+            Enumeration<String> classNames = dexFile.entries();
 
-            int countTemp = 0;
-            Enumeration<String> entries = dexfile.entries();
-            while (entries.hasMoreElements()) {
-                countTemp++;
-                String className = entries.nextElement();
-                if (className.startsWith(packageNamePrefix)) {
-                    classNames.add(className);
+            int totalClassCount = 0; // 总类数（调试用）
+            List<String> targetClassNames = new ArrayList<String>(); // 目标包名下的类名列表
+            String targetPackagePrefix = "cc.winboll.studio"; // 目标包名前缀
+
+            // 过滤目标包名下的类（Java 7 枚举遍历）
+            while (classNames.hasMoreElements()) {
+                totalClassCount++;
+                String className = classNames.nextElement();
+                if (className.startsWith(targetPackagePrefix)) {
+                    targetClassNames.add(className);
                 }
             }
 
-            LogUtils.d(TAG, String.format("countTemp : %d\nClassNames size : %d", countTemp, classNames.size()));
+            // 打印扫描统计（调试用）
+            d(TAG, String.format("APK 总类数：%d，目标包下类数：%d", totalClassCount, targetClassNames.size()));
 
-            for (String className : classNames) {
+            // 反射获取每个类的 TAG 字段（Java 7 增强 for 循环）
+            for (String className : targetClassNames) {
                 try {
                     Class<?> clazz = Class.forName(className);
+                    // 获取类中所有声明的字段
                     Field[] fields = clazz.getDeclaredFields();
                     for (Field field : fields) {
-                        if (Modifier.isStatic(field.getModifiers()) && Modifier.isPublic(field.getModifiers()) && field.getType() == String.class && "TAG".equals(field.getName())) {
+                        // 过滤条件：public static String 类型，且字段名是 "TAG"
+                        if (Modifier.isStatic(field.getModifiers())
+							&& Modifier.isPublic(field.getModifiers())
+							&& field.getType() == String.class
+							&& "TAG".equals(field.getName())) {
+                            // 获取 TAG 字段的值（静态字段，传入 null 即可）
                             String tagValue = (String) field.get(null);
-                            //Log.d("TAG_INFO", "Class: " + className + ", TAG value: " + tagValue);
-                            //LogUtils.d(TAG, String.format("Tag Value : %s", tagValue));
-                            //mapTAGList.put(tagValue, true);
-                            mapTAGList.put(tagValue, false);
+                            // 添加到映射表，默认禁用
+                            sTagEnableMap.put(tagValue, false);
                         }
                     }
-                } catch (NoClassDefFoundError | ClassNotFoundException | IllegalAccessException e) {
-                    LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
-                    //LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-                    //Toast.makeText(context, TAG + " : " + e.getMessage(), Toast.LENGTH_SHORT).show();
+                } catch (NoClassDefFoundError e) {
+                    // 捕获反射异常，避免单个类扫描失败影响整体
+                    d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+                } catch (ClassNotFoundException e) {
+                    d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+                } catch (IllegalAccessException e) {
+                    d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
                 }
             }
         } catch (IOException e) {
-            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-            //Toast.makeText(context, TAG + " : " + e.getMessage(), Toast.LENGTH_SHORT).show();
+            // 捕获 APK 读取异常
+            d(TAG, e, Thread.currentThread().getStackTrace());
         }
     }
 
-    public static void setTAGListEnable(String tag, boolean isEnable) {
-        Iterator<Map.Entry<String, Boolean>> iterator = mapTAGList.entrySet().iterator();
+    /**
+     * 设置单个 TAG 的启用状态
+     * @param tag TAG 名称
+     * @param isEnable 是否启用（true：输出该 TAG 的日志；false：不输出）
+     */
+    public static void setTagEnable(String tag, boolean isEnable) {
+        // 遍历映射表，更新目标 TAG 的状态（Java 7 迭代器遍历）
+        Iterator<Map.Entry<String, Boolean>> iterator = sTagEnableMap.entrySet().iterator();
         while (iterator.hasNext()) {
             Map.Entry<String, Boolean> entry = iterator.next();
             if (tag.equals(entry.getKey())) {
                 entry.setValue(isEnable);
-                //System.out.println("Key: " + entry.getKey() + ", Value: " + entry.getValue());
                 break;
             }
         }
-        saveTAGBeanSettings();
-        LogUtils.d(TAG, String.format("mapTAGList : %s", mapTAGList.toString()));
+        // 保存配置到文件（持久化）
+        saveTagEnableSettings();
+        d(TAG, String.format("TAG 配置更新：%s", sTagEnableMap.toString()));
     }
 
-    public static void setALlTAGListEnable(boolean isEnable) {
-        Iterator<Map.Entry<String, Boolean>> iterator = mapTAGList.entrySet().iterator();
+    /**
+     * 设置所有 TAG 的启用状态（批量控制）
+     * @param isEnable 是否启用（true：所有 TAG 均输出日志；false：所有 TAG 均不输出）
+     */
+    public static void setAllTagsEnable(boolean isEnable) {
+        // 遍历映射表，批量更新所有 TAG 的状态（Java 7 迭代器遍历）
+        Iterator<Map.Entry<String, Boolean>> iterator = sTagEnableMap.entrySet().iterator();
         while (iterator.hasNext()) {
             Map.Entry<String, Boolean> entry = iterator.next();
             entry.setValue(isEnable);
-            //System.out.println("Key: " + entry.getKey() + ", Value: " + entry.getValue());
         }
-        saveTAGBeanSettings();
-        LogUtils.d(TAG, String.format("mapTAGList : %s", mapTAGList.toString()));
+        // 保存配置到文件（持久化）
+        saveTagEnableSettings();
+        d(TAG, String.format("所有 TAG 配置更新：%s", sTagEnableMap.toString()));
     }
 
+    /**
+     * 设置全局日志级别（控制日志输出的详细程度）
+     * @param logLevel 目标日志级别
+     */
     public static void setLogLevel(LOG_LEVEL logLevel) {
-        LogUtils._mLogUtilsBean.setLogLevel(logLevel);
-        _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
+        if (sLogConfigBean != null) {
+            sLogConfigBean.setLogLevel(logLevel);
+            // 保存配置到文件（持久化）
+            sLogConfigBean.saveBeanToFile(sLogConfigFile.getPath(), sLogConfigBean);
+        }
     }
 
+    /**
+     * 获取当前全局日志级别
+     * @return 当前日志级别
+     */
     public static LOG_LEVEL getLogLevel() {
-        return LogUtils._mLogUtilsBean.getLogLevel();
+        return sLogConfigBean != null ? sLogConfigBean.getLogLevel() : LOG_LEVEL.Off;
     }
 
-    static boolean isLoggable(String tag, LOG_LEVEL logLevel) {
-        if (!_IsInited) {
+    /**
+     * 判断当前日志是否可输出（校验初始化状态、TAG 启用状态、日志级别）
+     * @param tag 日志 TAG
+     * @param logLevel 日志级别
+     * @return true：可输出；false：不可输出
+     */
+    private static boolean isLoggable(String tag, LOG_LEVEL logLevel) {
+        // 未初始化：不输出
+        if (!sIsInited) {
             return false;
-        } 
-        if (mapTAGList.get(tag) == null
-            || !mapTAGList.get(tag)) {
+        }
+        // TAG 未配置或未启用：不输出
+        if (sTagEnableMap.get(tag) == null || !sTagEnableMap.get(tag)) {
             return false;
-        } 
-        if (!isInTheLevel(logLevel)) {
+        }
+        // 日志级别未达到：不输出
+        if (!isLevelMatched(logLevel)) {
             return false;
         }
         return true;
     }
 
-    static boolean isInTheLevel(LOG_LEVEL logLevel) {
-        return (LogUtils._mLogUtilsBean.getLogLevel().ordinal() == logLevel.ordinal()
-            || LogUtils._mLogUtilsBean.getLogLevel().ordinal() > logLevel.ordinal());
+    /**
+     * 判断日志级别是否匹配（当前全局级别 >= 目标级别时可输出）
+     * 例：全局级别为 Debug（4），则 Error（1）、Warn（2）、Info（3）、Debug（4）均可输出
+     * @param logLevel 目标日志级别
+     * @return true：级别匹配；false：不匹配
+     */
+    private static boolean isLevelMatched(LOG_LEVEL logLevel) {
+        if (sLogConfigBean == null) {
+            return false;
+        }
+        // 枚举的 ordinal() 方法返回索引（Off=0，Error=1，...，Verbose=5）
+        return sLogConfigBean.getLogLevel().ordinal() >= logLevel.ordinal();
     }
 
-    //
-    // 获取应用日志文件夹
-    //
+    /**
+     * 获取日志缓存文件夹路径（外部可通过此方法获取日志存储目录）
+     * @return 日志缓存文件夹
+     */
     public static File getLogCacheDir() {
-        return _mfLogCacheDir;
+        return sLogCacheDir;
     }
 
-    //
-    // 调试日志写入函数
-    //
-    public static void e(String szTAG, String szMessage) {
-        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Error)) {
-            saveLog(szTAG, LogUtils.LOG_LEVEL.Error, szMessage);
+    /**
+     * 输出 Error 级别日志
+     * @param tag TAG 名称
+     * @param message 日志内容
+     */
+    public static void e(String tag, String message) {
+        if (isLoggable(tag, LOG_LEVEL.Error)) {
+            saveLog(tag, LOG_LEVEL.Error, message);
         }
     }
 
-    //
-    // 调试日志写入函数
-    //
-    public static void w(String szTAG, String szMessage) {
-        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Warn)) {
-            saveLog(szTAG, LogUtils.LOG_LEVEL.Warn, szMessage);
+    /**
+     * 输出 Error 级别日志（带异常信息和调用栈）
+     * 错误级别专用，包含完整异常详情，便于错误定位和排查
+     * @param tag TAG 名称
+     * @param message 日志内容
+     * @param e 异常对象（存储异常信息和调用栈）
+     */
+    public static void e(String tag, String message, Exception e) {
+        if (isLoggable(tag, LOG_LEVEL.Error)) {
+            StackTraceElement[] stackTrace = Thread.currentThread().getStackTrace();
+            StringBuilder sb = new StringBuilder(message);
+            // 拼接异常信息（类型 + 消息）
+            sb.append(" \nException: ")
+				.append(e.getClass().getSimpleName())
+				.append(" : ")
+				.append(e.getMessage() != null ? e.getMessage() : "无异常消息");
+            // 拼接调用栈信息（stackTrace[2] 为实际调用处）
+            sb.append(" \nAt ")
+				.append(stackTrace[2].getMethodName())
+				.append(" (")
+				.append(stackTrace[2].getFileName())
+				.append(":")
+				.append(stackTrace[2].getLineNumber())
+				.append(")");
+            saveLog(tag, LOG_LEVEL.Error, sb.toString());
         }
     }
 
-    //
-    // 调试日志写入函数
-    //
-    public static void i(String szTAG, String szMessage) {
-        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Info)) {
-            saveLog(szTAG, LogUtils.LOG_LEVEL.Info, szMessage);
+    /**
+     * 输出 Warn 级别日志
+     * @param tag TAG 名称
+     * @param message 日志内容
+     */
+    public static void w(String tag, String message) {
+        if (isLoggable(tag, LOG_LEVEL.Warn)) {
+            saveLog(tag, LOG_LEVEL.Warn, message);
         }
     }
 
-    //
-    // 调试日志写入函数
-    //
-    public static void d(String szTAG, String szMessage) {
-        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
-            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, szMessage);
+    /**
+     * 输出 Warn 级别日志（带异常信息和调用栈）
+     * 包含日志内容、异常详情、调用位置，便于警告场景下的问题定位
+     * @param tag TAG 名称
+     * @param message 日志内容
+     * @param e 异常对象（存储异常信息和调用栈）
+     */
+    public static void w(String tag, String message, Exception e) {
+        if (isLoggable(tag, LOG_LEVEL.Warn)) {
+            StackTraceElement[] stackTrace = Thread.currentThread().getStackTrace();
+            StringBuilder sb = new StringBuilder(message);
+            // 拼接异常信息（类型 + 消息）
+            sb.append(" \nException: ")
+				.append(e.getClass().getSimpleName())
+				.append(" : ")
+				.append(e.getMessage() != null ? e.getMessage() : "无异常消息");
+            // 拼接调用栈信息（stackTrace[2] 为实际调用处）
+            sb.append(" \nAt ")
+				.append(stackTrace[2].getMethodName())
+				.append(" (")
+				.append(stackTrace[2].getFileName())
+				.append(":")
+				.append(stackTrace[2].getLineNumber())
+				.append(")");
+            saveLog(tag, LOG_LEVEL.Warn, sb.toString());
         }
     }
 
-    //
-    // 调试日志写入函数
-    // 包含线程调试堆栈信息
-    //
-    public static void d(String szTAG, String szMessage, StackTraceElement[] listStackTrace) {
-        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
-            StringBuilder sbMessage = new StringBuilder(szMessage);
-            sbMessage.append(" \nAt ");
-            sbMessage.append(listStackTrace[2].getMethodName());
-            sbMessage.append(" (");
-            sbMessage.append(listStackTrace[2].getFileName());
-            sbMessage.append(":");
-            sbMessage.append(listStackTrace[2].getLineNumber());
-            sbMessage.append(")");
-            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sbMessage.toString());
+    /**
+     * 输出 Info 级别日志
+     * @param tag TAG 名称
+     * @param message 日志内容
+     */
+    public static void i(String tag, String message) {
+        if (isLoggable(tag, LOG_LEVEL.Info)) {
+            saveLog(tag, LOG_LEVEL.Info, message);
         }
     }
 
-    //
-    // 调试日志写入函数
-    // 包含异常信息和线程调试堆栈信息
-    //
-    public static void d(String szTAG, Exception e, StackTraceElement[] listStackTrace) {
-        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Debug)) {
-            StringBuilder sbMessage = new StringBuilder(e.getClass().toGenericString());
-            sbMessage.append(" : ");
-            sbMessage.append(e.getMessage());
-            sbMessage.append(" \nAt ");
-            sbMessage.append(listStackTrace[2].getMethodName());
-            sbMessage.append(" (");
-            sbMessage.append(listStackTrace[2].getFileName());
-            sbMessage.append(":");
-            sbMessage.append(listStackTrace[2].getLineNumber());
-            sbMessage.append(")");
-            saveLog(szTAG, LogUtils.LOG_LEVEL.Debug, sbMessage.toString());
+    /**
+     * 输出 Debug 级别日志（基础版）
+     * @param tag TAG 名称
+     * @param message 日志内容
+     */
+    public static void d(String tag, String message) {
+        if (isLoggable(tag, LOG_LEVEL.Debug)) {
+            saveLog(tag, LOG_LEVEL.Debug, message);
         }
     }
 
-    //
-    // 调试日志写入函数
-    //
-    public static void v(String szTAG, String szMessage) {
-        if (isLoggable(szTAG, LogUtils.LOG_LEVEL.Verbose)) {
-            saveLog(szTAG, LogUtils.LOG_LEVEL.Verbose, szMessage);
+    /**
+     * 输出 Debug 级别日志（带调用栈信息）
+     * 包含调用方法名、文件名、行号，便于调试定位
+     * @param tag TAG 名称
+     * @param message 日志内容
+     * @param stackTrace 线程调用栈（通常传入 Thread.currentThread().getStackTrace()）
+     */
+    public static void d(String tag, String message, StackTraceElement[] stackTrace) {
+        if (isLoggable(tag, LOG_LEVEL.Debug)) {
+            StringBuilder sb = new StringBuilder(message);
+            // 拼接调用栈信息（stackTrace[2] 为实际调用处）
+            sb.append(" \nAt ")
+				.append(stackTrace[2].getMethodName())
+				.append(" (")
+				.append(stackTrace[2].getFileName())
+				.append(":")
+				.append(stackTrace[2].getLineNumber())
+				.append(")");
+            saveLog(tag, LOG_LEVEL.Debug, sb.toString());
         }
     }
 
-    //
-    // 日志文件保存函数
-    //
-    static void saveLog(String szTAG, LogUtils.LOG_LEVEL logLevel, String szMessage) {
+    /**
+     * 输出 Debug 级别日志（带异常信息和调用栈）
+     * 包含异常类型、异常信息、调用位置，便于异常定位
+     * @param tag TAG 名称
+     * @param e 异常对象
+     * @param stackTrace 线程调用栈
+     */
+    public static void d(String tag, Exception e, StackTraceElement[] stackTrace) {
+        if (isLoggable(tag, LOG_LEVEL.Debug)) {
+            StringBuilder sb = new StringBuilder();
+            // 拼接异常信息
+            sb.append(e.getClass().getSimpleName())
+				.append(" : ")
+				.append(e.getMessage() != null ? e.getMessage() : "无异常消息")
+				// 拼接调用栈信息
+				.append(" \nAt ")
+				.append(stackTrace[2].getMethodName())
+				.append(" (")
+				.append(stackTrace[2].getFileName())
+				.append(":")
+				.append(stackTrace[2].getLineNumber())
+				.append(")");
+            saveLog(tag, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    /**
+     * 输出 Debug 级别日志（带日志内容+异常对象，简化调用）
+     * 无需手动传入调用栈，内部自动获取，适配常见调试场景
+     * @param tag TAG 名称
+     * @param message 日志内容
+     * @param e 异常对象（存储异常信息和调用栈）
+     */
+    public static void d(String tag, String message, Exception e) {
+        if (isLoggable(tag, LOG_LEVEL.Debug)) {
+            // 自动获取当前线程调用栈，简化外部调用
+            StackTraceElement[] stackTrace = Thread.currentThread().getStackTrace();
+            StringBuilder sb = new StringBuilder(message);
+            // 拼接异常信息（类型 + 消息）
+            sb.append(" \nException: ")
+				.append(e.getClass().getSimpleName())
+				.append(" : ")
+				.append(e.getMessage() != null ? e.getMessage() : "无异常消息");
+            // 拼接调用栈信息（stackTrace[2] 为实际调用处）
+            sb.append(" \nAt ")
+				.append(stackTrace[2].getMethodName())
+				.append(" (")
+				.append(stackTrace[2].getFileName())
+				.append(":")
+				.append(stackTrace[2].getLineNumber())
+				.append(")");
+            saveLog(tag, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    /**
+     * 输出 Verbose 级别日志（最详细级别）
+     * @param tag TAG 名称
+     * @param message 日志内容
+     */
+    public static void v(String tag, String message) {
+        if (isLoggable(tag, LOG_LEVEL.Verbose)) {
+            saveLog(tag, LOG_LEVEL.Verbose, message);
+        }
+    }
+
+    /**
+     * 核心日志保存方法（将日志写入文件）
+     * 日志格式：[级别]  [时间戳]  [TAG]
+     *          日志内容
+     * @param tag TAG 名称
+     * @param logLevel 日志级别
+     * @param message 日志内容
+     */
+    private static void saveLog(String tag, LOG_LEVEL logLevel, String message) {
+        BufferedWriter writer = null;
         try {
-            BufferedWriter out = null;
-            out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(_mfLogCatchFile, true), "UTF-8"));
-            out.write("[" + logLevel + "]  " + mSimpleDateFormat.format(System.currentTimeMillis()) + "  [" + szTAG + "]\n" + szMessage + "\n");
-            out.close();
+            // 以追加模式打开日志文件，UTF-8 编码
+            writer = new BufferedWriter(
+                new OutputStreamWriter(
+                    new FileOutputStream(sLogFile, true), 
+                    "UTF-8"
+                )
+            );
+            // 拼接日志内容（级别 + 时间 + TAG + 消息）
+            String logContent = String.format(
+                "[%s]  %s  [%s]\n%s\n",
+                logLevel.name(),          // 日志级别（如 Debug）
+                sSimpleDateFormat.format(System.currentTimeMillis()), // 时间戳
+                tag,                      // TAG 名称
+                message                   // 日志内容
+            );
+            // 写入文件
+            writer.write(logContent);
         } catch (IOException e) {
-            LogUtils.d(TAG, "IOException : " + e.getMessage());
-        }
-    }
-
-    //
-    // 历史日志加载函数
-    //
-    public static String loadLog() {
-        if (_mfLogCatchFile.exists()) {
-            StringBuffer sb = new StringBuffer();
-            try {
-                BufferedReader in = null;
-                in = new BufferedReader(new InputStreamReader(new FileInputStream(_mfLogCatchFile), "UTF-8"));
-                String line = "";
-                while ((line = in.readLine()) != null) {
-                    sb.append(line);
-                    sb.append("\n");
+            // 日志写入失败时，输出内部调试日志
+            d(TAG, "日志写入失败：" + (e.getMessage() != null ? e.getMessage() : "未知错误"));
+        } finally {
+            // 关闭流，避免资源泄漏（Java 7 手动关闭，不使用 try-with-resources）
+            if (writer != null) {
+                try {
+                    writer.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
                 }
-            } catch (IOException e) {
-                LogUtils.d(TAG, "IOException : " + e.getMessage());
-            } 
-            return sb.toString();
-        }
-        return "";
-    }
-
-    //
-    // 清理日志函数
-    //
-    public static void cleanLog() {
-        if (_mfLogCatchFile.exists()) {
-            try {
-                UTF8FileUtils.writeStringToFile(_mfLogCatchFile.getPath(), "");
-                //LogUtils.d(TAG, "cleanLog");
-            } catch (IOException e) {
-                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
             }
         }
     }
+
+    /**
+     * 加载历史日志（读取日志文件所有内容）
+     * @return 历史日志字符串（空字符串表示文件不存在或读取失败）
+     */
+    public static String loadLog() {
+        // 日志文件不存在，返回空
+        if (sLogFile == null || !sLogFile.exists()) {
+            return "";
+        }
+
+        StringBuilder logContent = new StringBuilder();
+        BufferedReader reader = null;
+        try {
+            // 以 UTF-8 编码读取日志文件
+            reader = new BufferedReader(
+                new InputStreamReader(
+                    new FileInputStream(sLogFile), 
+                    "UTF-8"
+                )
+            );
+            String line;
+            // 逐行读取并拼接（Java 7 普通 while 循环）
+            while ((line = reader.readLine()) != null) {
+                logContent.append(line).append("\n");
+            }
+        } catch (IOException e) {
+            // 读取失败时，输出内部调试日志
+            d(TAG, "日志读取失败：" + (e.getMessage() != null ? e.getMessage() : "未知错误"));
+        } finally {
+            // 关闭流，避免资源泄漏
+            if (reader != null) {
+                try {
+                    reader.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+        return logContent.toString();
+    }
+
+    /**
+     * 清理历史日志（清空日志文件内容）
+     */
+    public static void cleanLog() {
+        if (sLogFile == null || !sLogFile.exists()) {
+            return;
+        }
+
+        try {
+            // 写入空字符串到文件，实现清空（Java 7 手动处理流）
+            BufferedWriter writer = new BufferedWriter(
+                new OutputStreamWriter(
+                    new FileOutputStream(sLogFile), 
+                    "UTF-8"
+                )
+            );
+            writer.write("");
+            writer.close();
+        } catch (IOException e) {
+            // 清空失败时，输出内部调试日志（带调用栈）
+            d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+    }
+
+    /**
+     * 辅助方法：创建文件夹（不存在则创建）
+     * @param dir 目标文件夹
+     */
+    private static void createDirIfNotExists(File dir) {
+        if (dir != null && !dir.exists()) {
+            dir.mkdirs();
+        }
+    }
 }
+

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

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

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

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

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

@@ -1,10 +1,5 @@
 package cc.winboll.studio.libappbase;
 
-/**
- * @Author ZhanGSKen<zhangsken@qq.com>
- * @Date 2024/08/12 14:36:18
- * @Describe 日志视图类，继承 RelativeLayout 类。
- */
 import android.content.ClipData;
 import android.content.ClipboardManager;
 import android.content.Context;
@@ -26,8 +21,6 @@ import android.widget.RelativeLayout;
 import android.widget.ScrollView;
 import android.widget.Spinner;
 import android.widget.TextView;
-import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.R;
 import java.text.Collator;
 import java.util.ArrayList;
 import java.util.Collections;
@@ -35,27 +28,49 @@ import java.util.Comparator;
 import java.util.List;
 import java.util.Map;
 
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/08/12 14:36:18
+ * @Describe 日志可视化自定义 View（继承 RelativeLayout）
+ * 核心功能：日志展示、日志级别筛选、TAG 过滤（启用/禁用）、TAG 搜索定位、日志清理/复制、视图交互控制
+ * 依赖 LogUtils 进行日志读写，通过 LogViewThread 监听日志文件变化并自动刷新
+ */
 public class LogView extends RelativeLayout {
 
+    /** 当前 View 的日志 TAG（用于调试输出） */
     public static final String TAG = "LogView";
 
-    public volatile boolean mIsHandling;
-    public volatile boolean mIsAddNewLog;
+    /** 日志处理中标志（避免并发刷新，volatile 保证多线程可见性） */
+    private volatile boolean mIsHandling;
+    /** 新日志添加标志（标记有未处理的新日志，volatile 保证多线程可见性） */
+    private volatile boolean mIsAddNewLog;
 
-    Context mContext;
-    ScrollView mScrollView;
-    TextView mTextView;
-    EditText metTagSearch;
-    CheckBox mSelectableCheckBox;
-    CheckBox mSelectAllTAGCheckBox;
-    TAGListAdapter mTAGListAdapter;
-    LogViewThread mLogViewThread;
-    LogViewHandler mLogViewHandler;
-    Spinner mLogLevelSpinner;
-    ArrayAdapter<CharSequence> mLogLevelSpinnerAdapter;
-    // 标签列表
-    HorizontalListView mListViewTags;
+    /** 上下文对象（用于布局加载、系统服务获取） */
+    private Context mContext;
+    /** 日志滚动视图（包裹日志文本，支持垂直滚动） */
+    private ScrollView mLogScrollView;
+    /** 日志文本展示控件（显示所有日志内容） */
+    private TextView mLogTextView;
+    /** TAG 搜索输入框（用于搜索并定位目标 TAG） */
+    private EditText mTagSearchEt;
+    /** 文本选择开关（控制是否允许选中日志文本） */
+    private CheckBox mTextSelectableCb;
+    /** 全选 TAG 开关（控制所有 TAG 的启用/禁用） */
+    private CheckBox mSelectAllTagCb;
+    /** TAG 列表适配器（绑定 TAG 数据与视图，处理勾选状态） */
+    private TAGListAdapter mTagListAdapter;
+    /** 日志监听线程（监听日志文件变化，触发视图刷新） */
+    private LogViewThread mLogViewThread;
+    /** 日志视图 Handler（主线程更新 UI，避免跨线程操作） */
+    private LogViewHandler mLogViewHandler;
+    /** 日志级别选择下拉框（用于切换全局日志输出级别） */
+    private Spinner mLogLevelSpinner;
+    /** 日志级别适配器（绑定 LogUtils.LOG_LEVEL 枚举与 Spinner） */
+    private ArrayAdapter<CharSequence> mLogLevelAdapter;
+    /** TAG 水平列表视图（横向展示所有 TAG，支持滚动） */
+    private HorizontalListView mTagHorizontalListView;
 
+    // ====================== 构造方法（初始化视图） ======================
     public LogView(Context context) {
         super(context);
         initView(context);
@@ -76,258 +91,307 @@ public class LogView extends RelativeLayout {
         initView(context);
     }
 
+    /**
+     * 启动日志监听与展示
+     * 1. 初始化并启动 LogViewThread（监听日志文件变化）；
+     * 2. 初始加载并展示日志内容。
+     */
     public void start() {
-        mLogViewThread = new LogViewThread(LogView.this);
+        mLogViewThread = new LogViewThread(this);
         mLogViewThread.start();
-        // 显示日志
-        showAndScrollLogView();
+        showAndScrollLogView(); // 初始显示日志并滚动到底部
     }
 
-    public void scrollLogUp() {
-        mScrollView.post(new Runnable() {
-                @Override
-                public void run() {
-                    mScrollView.fullScroll(ScrollView.FOCUS_DOWN);
-                    // 日志显示结束
-                    mLogViewHandler.setIsHandling(false);
-                    // 检查是否添加了新日志
-                    if (mLogViewHandler.isAddNewLog()) {
-                        // 有新日志添加，先更改新日志标志
-                        mLogViewHandler.setIsAddNewLog(false);
-                        // 再次发送显示日志的显示
-                        Message message = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOGVIEW_UPDATE);
-                        mLogViewHandler.sendMessage(message);
-                    }
-                }
-            });
+    /**
+     * 滚动日志到底部（确保最新日志可见）
+     * 运行在主线程，通过 post 提交 Runnable 避免 UI 线程阻塞
+     */
+    private void scrollLogToBottom() {
+        mLogScrollView.post(new Runnable() {
+				@Override
+				public void run() {
+					// 滚动到 ScrollView 底部（FOCUS_DOWN 表示聚焦到底部）
+					mLogScrollView.fullScroll(ScrollView.FOCUS_DOWN);
+					// 标记日志处理完成
+					mLogViewHandler.setIsHandling(false);
+					// 检查是否有未处理的新日志，有则再次触发刷新
+					if (mLogViewHandler.isAddNewLog()) {
+						mLogViewHandler.setIsAddNewLog(false);
+						Message refreshMsg = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOG_REFRESH);
+						mLogViewHandler.sendMessage(refreshMsg);
+					}
+				}
+			});
     }
 
-    void initView(Context context) {
+    /**
+     * 初始化视图组件（加载布局、绑定控件、设置监听）
+     * @param context 上下文对象
+     */
+    private void initView(Context context) {
         mContext = context;
-        mLogViewHandler = new LogViewHandler();
-        // 加载视图布局
-        addView(inflate(mContext, cc.winboll.studio.libappbase.R.layout.view_log, null));
-        // 初始化日志子控件视图
-        //
-        mScrollView = findViewById(cc.winboll.studio.libappbase.R.id.viewlogScrollViewLog);
-        mTextView = findViewById(cc.winboll.studio.libappbase.R.id.viewlogTextViewLog);
-        metTagSearch = findViewById(cc.winboll.studio.libappbase.R.id.tagsearch_et);
-        // 获取Log Level spinner实例
-        mLogLevelSpinner = findViewById(cc.winboll.studio.libappbase.R.id.viewlogSpinner1);
+        mLogViewHandler = new LogViewHandler(); // 初始化主线程 Handler
 
-        metTagSearch.addTextChangedListener(new TextWatcher() {
+        // 加载日志视图布局（R.layout.view_log 为自定义布局文件）
+        View rootView = LayoutInflater.from(context).inflate(R.layout.view_log, this, true);
+        // 绑定布局控件（通过 ID 找到对应组件）
+        bindViews(rootView);
 
-                @Override
-                public void afterTextChanged(Editable editable) {
-                }
-
-                @Override
-                public void beforeTextChanged(CharSequence charSequence, int p, int p1, int p2) {
-                }
-
-                @Override
-                public void onTextChanged(CharSequence s, int start, int before, int count) {
-                    LogUtils.d(TAG, s.toString());
-                    if (s.length() > 0) {
-                        scrollToTag(s.toString());
-                    } else {
-                        HorizontalScrollView hsRoot = findViewById(R.id.viewlogHorizontalScrollView1);
-                        hsRoot.smoothScrollTo(0, 0);
-                        mListViewTags.resetScrollToStart();
-                    }
-//                    mListViewTags.postDelayed(new Runnable() {
-//                            @Override
-//                            public void run() {
-//                                mListViewTags.scrollToItem(5);
-//                            }
-//                        }, 100);
-                }
-                // 其他方法留空或按需实现
-            });
-
-
-        (findViewById(cc.winboll.studio.libappbase.R.id.viewlogButtonClean)).setOnClickListener(new View.OnClickListener(){
-
-                @Override
-                public void onClick(View v) {
-                    LogUtils.cleanLog();
-                    LogUtils.d(TAG, "Log is cleaned.");
-                }
-            });
-        (findViewById(cc.winboll.studio.libappbase.R.id.viewlogButtonCopy)).setOnClickListener(new View.OnClickListener(){
-
-                @Override
-                public void onClick(View v) {
-
-                    ClipboardManager cm = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
-                    cm.setPrimaryClip(ClipData.newPlainText(mContext.getPackageName(), LogUtils.loadLog()));
-                    LogUtils.d(TAG, "Log is copied.");
-                }
-            });
-        mSelectableCheckBox = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBoxSelectable);
-        mSelectableCheckBox.setOnClickListener(new View.OnClickListener(){
-                @Override
-                public void onClick(View v) {
-                    if (mSelectableCheckBox.isChecked()) {
-                        setDescendantFocusability(ViewGroup.FOCUS_BEFORE_DESCENDANTS);
-                    } else {
-                        setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
-                    }
-                }
-            });
-
-        // 设置日志级别列表
-        ArrayList<String> adapterItems = new ArrayList<>();
-        for (LogUtils.LOG_LEVEL e : LogUtils.LOG_LEVEL.values()) {
-            adapterItems.add(e.name());
-        }
-        // 假设你有一个字符串数组作为选项列表
-        //String[] options = {"Option 1", "Option 2", "Option 3"};
-        // 创建一个ArrayAdapter来绑定数据到spinner
-        mLogLevelSpinnerAdapter = ArrayAdapter.createFromResource(
-            context, cc.winboll.studio.libappbase.R.array.enum_loglevel_array, android.R.layout.simple_spinner_item);
-        mLogLevelSpinnerAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
-
-        // 设置适配器并将它应用到spinner上
-        mLogLevelSpinnerAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item); // 设置下拉视图样式
-        mLogLevelSpinner.setAdapter(mLogLevelSpinnerAdapter);
-        // 为Spinner添加监听器
-        mLogLevelSpinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
-                @Override
-                public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
-                    //String selectedOption = mLogLevelSpinnerAdapter.getItem(position);
-                    // 处理选中的选项...
-                    LogUtils.setLogLevel(LogUtils.LOG_LEVEL.values()[position]);
-                }
-                @Override
-                public void onNothingSelected(AdapterView<?> parent) {
-                    // 如果没有选择，则执行此操作...
-                }
-            });
-        // 获取默认值的索引
-        int defaultValueIndex = LogUtils.getLogLevel().ordinal();
-
-        if (defaultValueIndex != -1) {
-            // 如果找到了默认值，设置默认选项
-            mLogLevelSpinner.setSelection(defaultValueIndex);
-        }
-
-        // 加载标签列表
-        Map<String, Boolean> mapTAGList = LogUtils.getMapTAGList();
-        boolean isAllSelect = true;
-        for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
-            if (entry.getValue() == false) {
-                isAllSelect = false;
-                break;
-            }
-        }
-        CheckBox cbALLTAG = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBox1);
-        cbALLTAG.setChecked(isAllSelect);
-
-        // 加载标签表
-        mListViewTags = findViewById(cc.winboll.studio.libappbase.R.id.tags_listview);
-        mListViewTags.setVerticalOffset(10);
-        mTAGListAdapter = new TAGListAdapter(mContext, mapTAGList);
-        mListViewTags.setAdapter(mTAGListAdapter);
-
-        // 可以添加点击监听器来处理勾选框状态变化后的逻辑，比如获取当前勾选情况等
-        mTAGListAdapter.notifyDataSetChanged();
-
-        mSelectAllTAGCheckBox = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBox1);
-        mSelectAllTAGCheckBox.setOnClickListener(new View.OnClickListener(){
-                @Override
-                public void onClick(View v) {
-                    LogUtils.setALlTAGListEnable(mSelectAllTAGCheckBox.isChecked());
-                    //LogUtils.setALlTAGListEnable(false);
-                    //mTAGListAdapter.notifyDataSetChanged();
-                    mTAGListAdapter.reload();
-                    //ToastUtils.show(String.format("onClick\nmSelectAllTAGCheckBox.isChecked() : %s", mSelectAllTAGCheckBox.isChecked()));
-                }
-            });
-
-
-        // 设置滚动时不聚焦日志
+        // 设置 TAG 搜索输入框监听（实时搜索并定位 TAG）
+        setupTagSearchListener();
+        // 设置功能按钮监听（清理日志、复制日志）
+        setupFunctionButtonListeners(rootView);
+        // 设置文本选择开关监听（控制日志文本是否可选中）
+        setupTextSelectableListener();
+        // 初始化日志级别下拉框（绑定级别数据，设置默认值）
+        initLogLevelSpinner();
+        // 初始化 TAG 列表（加载所有 TAG，设置全选状态）
+        initTagListView();
+        // 设置默认交互模式（默认禁止子视图获取焦点，避免误触）
         setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
     }
 
+    /**
+     * 绑定布局控件（通过 ID 查找并初始化所有子组件）
+     * @param rootView 根布局视图
+     */
+    private void bindViews(View rootView) {
+        mLogScrollView = rootView.findViewById(R.id.viewlogScrollViewLog);
+        mLogTextView = rootView.findViewById(R.id.viewlogTextViewLog);
+        mTagSearchEt = rootView.findViewById(R.id.tagsearch_et);
+        mLogLevelSpinner = rootView.findViewById(R.id.viewlogSpinner1);
+        mTextSelectableCb = rootView.findViewById(R.id.viewlogCheckBoxSelectable);
+        mSelectAllTagCb = rootView.findViewById(R.id.viewlogCheckBox1);
+        mTagHorizontalListView = rootView.findViewById(R.id.tags_listview);
+    }
+
+    /**
+     * 设置 TAG 搜索输入框监听（文本变化时触发 TAG 定位）
+     */
+    private void setupTagSearchListener() {
+        mTagSearchEt.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 searchText = s.toString().trim();
+					LogUtils.d(TAG, "TAG 搜索内容：" + searchText);
+					if (!searchText.isEmpty()) {
+						// 搜索文本非空，定位匹配的 TAG
+						scrollToTargetTag(searchText);
+					} else {
+						// 搜索文本为空，重置滚动位置
+						HorizontalScrollView parentHs = findViewById(R.id.viewlogHorizontalScrollView1);
+						parentHs.smoothScrollTo(0, 0);
+						mTagHorizontalListView.resetScrollToStart();
+					}
+				}
+
+				@Override
+				public void afterTextChanged(Editable s) {}
+			});
+    }
+
+    /**
+     * 设置功能按钮监听（清理日志、复制日志）
+     */
+    private void setupFunctionButtonListeners(View rootView) {
+        // 清理日志按钮（点击清空所有历史日志）
+        rootView.findViewById(R.id.viewlogButtonClean).setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.cleanLog();
+					LogUtils.d(TAG, "日志已清理");
+				}
+			});
+
+        // 复制日志按钮（点击复制所有日志到剪贴板）
+        rootView.findViewById(R.id.viewlogButtonCopy).setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					ClipboardManager clipboard = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
+					// 将日志内容复制到剪贴板（标签为应用包名）
+					clipboard.setPrimaryClip(ClipData.newPlainText(mContext.getPackageName(), LogUtils.loadLog()));
+					LogUtils.d(TAG, "日志已复制到剪贴板");
+				}
+			});
+    }
+
+    /**
+     * 设置文本选择开关监听（控制日志文本是否可选中复制）
+     */
+    private void setupTextSelectableListener() {
+        mTextSelectableCb.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					if (mTextSelectableCb.isChecked()) {
+						// 允许文本选择：子视图优先获取焦点
+						setDescendantFocusability(ViewGroup.FOCUS_BEFORE_DESCENDANTS);
+					} else {
+						// 禁止文本选择：阻止子视图获取焦点
+						setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
+					}
+				}
+			});
+    }
+
+    /**
+     * 初始化日志级别下拉框（Spinner）
+     * 1. 绑定 LogUtils.LOG_LEVEL 枚举数据；
+     * 2. 设置默认选中当前全局日志级别；
+     * 3. 监听级别变化，更新 LogUtils 全局配置。
+     */
+    private void initLogLevelSpinner() {
+        // 从资源文件加载日志级别数组（R.array.enum_loglevel_array 与 LOG_LEVEL 枚举对应）
+        mLogLevelAdapter = ArrayAdapter.createFromResource(
+			mContext, R.array.enum_loglevel_array, android.R.layout.simple_spinner_item);
+        // 设置下拉列表样式
+        mLogLevelAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
+        mLogLevelSpinner.setAdapter(mLogLevelAdapter);
+
+        // 监听下拉框选择变化
+        mLogLevelSpinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
+				@Override
+				public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
+					// 根据选择的位置设置全局日志级别（position 与 LOG_LEVEL 枚举索引对应）
+					LogUtils.setLogLevel(LogUtils.LOG_LEVEL.values()[position]);
+				}
+
+				@Override
+				public void onNothingSelected(AdapterView<?> parent) {}
+			});
+
+        // 设置默认选中当前日志级别
+        int defaultLevelIndex = LogUtils.getLogLevel().ordinal();
+        if (defaultLevelIndex >= 0) {
+            mLogLevelSpinner.setSelection(defaultLevelIndex);
+        }
+    }
+
+    /**
+     * 初始化 TAG 水平列表
+     * 1. 加载 LogUtils 中的所有 TAG 及其启用状态；
+     * 2. 初始化 TAG 列表适配器；
+     * 3. 设置全选 TAG 开关监听。
+     */
+    private void initTagListView() {
+        // 获取 LogUtils 中的 TAG 启用状态映射表
+        Map<String, Boolean> tagEnableMap = LogUtils.getTagEnableMap();
+        // 判断是否所有 TAG 都已启用（初始化全选开关状态）
+        boolean isAllTagEnabled = isAllTagsEnabled(tagEnableMap);
+        mSelectAllTagCb.setChecked(isAllTagEnabled);
+
+        // 初始化 TAG 水平列表（设置垂直偏移，绑定适配器）
+        mTagHorizontalListView.setVerticalOffset(10);
+        mTagListAdapter = new TAGListAdapter(mContext, tagEnableMap);
+        mTagHorizontalListView.setAdapter(mTagListAdapter);
+        mTagListAdapter.notifyDataSetChanged(); // 刷新列表数据
+
+        // 全选 TAG 开关监听（点击时启用/禁用所有 TAG）
+        mSelectAllTagCb.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					boolean isSelectAll = mSelectAllTagCb.isChecked();
+					LogUtils.setAllTagsEnable(isSelectAll); // 批量更新所有 TAG 状态
+					mTagListAdapter.reload(); // 重新加载 TAG 数据并刷新视图
+				}
+			});
+    }
+
+    /**
+     * 判断是否所有 TAG 都已启用
+     * @param tagEnableMap TAG 启用状态映射表
+     * @return true：所有 TAG 均启用；false：存在未启用的 TAG
+     */
+    private boolean isAllTagsEnabled(Map<String, Boolean> tagEnableMap) {
+        for (Map.Entry<String, Boolean> entry : tagEnableMap.entrySet()) {
+            if (!entry.getValue()) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * 更新日志视图（由 LogViewThread 触发，通知有新日志）
+     * 避免并发刷新：正在处理时标记新日志，处理完成后再次刷新
+     */
     public void updateLogView() {
-        if (mLogViewHandler.isHandling() == true) {
-            // 正在处理日志显示，
-            // 就先设置一个新日志标志位
-            // 以便日志显示完后，再次显示新日志内容
+        if (mLogViewHandler.isHandling()) {
+            // 正在处理日志刷新，标记有新日志待处理
             mLogViewHandler.setIsAddNewLog(true);
         } else {
-            //LogUtils.d(TAG, "LogListener showLog(String path)");
-            Message message = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOGVIEW_UPDATE);
-            mLogViewHandler.sendMessage(message);
+            // 发送刷新消息到主线程
+            Message refreshMsg = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOG_REFRESH);
+            mLogViewHandler.sendMessage(refreshMsg);
             mLogViewHandler.setIsAddNewLog(false);
         }
     }
 
-    void showAndScrollLogView() {
-        mTextView.setText(LogUtils.loadLog());
-        scrollLogUp();
+    /**
+     * 显示日志并滚动到底部
+     * 1. 从 LogUtils 加载所有历史日志；
+     * 2. 设置到文本控件并滚动到底部。
+     */
+    private void showAndScrollLogView() {
+        mLogTextView.setText(LogUtils.loadLog()); // 加载并显示日志
+        scrollLogToBottom(); // 滚动到底部，显示最新日志
     }
 
-    public void scrollToTag(final String prefix) {
-        if (mTAGListAdapter == null || prefix == null || prefix.length() == 0) {
-            LogUtils.d(TAG, "参数为空，无法滚动");
+    /**
+     * 滚动到目标 TAG（根据搜索文本定位匹配的 TAG 并滚动显示）
+     * @param prefix 搜索文本（TAG 前缀）
+     */
+    private void scrollToTargetTag(final String prefix) {
+        if (mTagListAdapter == null || prefix == null || prefix.isEmpty()) {
+            LogUtils.d(TAG, "TAG 搜索参数为空，无法定位");
             return;
         }
 
-        final List<TAGItemModel> itemList = mTAGListAdapter.getItemList();
+        final List<TAGItemModel> tagItemList = mTagListAdapter.getItemList();
+        mTagHorizontalListView.post(new Runnable() {
+				@Override
+				public void run() {
+					int targetPosition = -1;
+					// 遍历 TAG 列表，查找前缀匹配的 TAG（忽略大小写）
+					for (int i = 0; i < tagItemList.size(); i++) {
+						String tag = tagItemList.get(i).getTag();
+						if (tag != null && tag.toLowerCase().startsWith(prefix.toLowerCase())) {
+							targetPosition = i;
+							break;
+						}
+					}
 
-        mListViewTags.post(new Runnable() {
-                @Override
-                public void run() {
-                    // 查找匹配的标签位置
-                    int targetPosition = -1;
-
-                    for (int i = 0; i < itemList.size(); i++) {
-                        String tag = itemList.get(i).getTag();
-                        if (tag != null && tag.toLowerCase().startsWith(prefix.toLowerCase())) {
-                            targetPosition = i;
-
-                            break;
-                        }
-                    }
-
-                    if (targetPosition != -1) {
-                        // 优化滚动逻辑
-                        //mListViewTags.setSelection(targetPosition);
-                        //mListViewTags.invalidateViews(); // 强制刷新所有可见项
-
-                        // 单独刷新目标视图
-//                        View targetView = mListViewTags.getChildAt(targetPosition);
-//                        if (targetView != null) {
-//                            targetView.requestLayout();
-//                            targetView.requestFocus();
-//                        }
-
-                        final int scrollPosition = targetPosition;
-
-                        // 延迟滚动确保布局完成
-                        mListViewTags.postDelayed(new Runnable() {
-                                @Override
-                                public void run() {
-                                    LogUtils.d(TAG, String.format("scrollPosition %d", scrollPosition));
-                                    mListViewTags.scrollToItem(scrollPosition);
-                                }
-                            }, 100);
-                    } else {
-                        LogUtils.d(TAG, "未找到匹配的标签前缀：" + prefix);
-                    }
-                }
-            });
+					if (targetPosition != -1) {
+						final int targetPositionFinal = targetPosition;
+						// 延迟滚动（确保布局完成，避免滚动失效）
+						mTagHorizontalListView.postDelayed(new Runnable() {
+								@Override
+								public void run() {
+									LogUtils.d(TAG, "定位到 TAG 位置：" + targetPositionFinal);
+									mTagHorizontalListView.scrollToItem(targetPositionFinal);
+								}
+							}, 100);
+					} else {
+						LogUtils.d(TAG, "未找到匹配前缀的 TAG：" + prefix);
+					}
+				}
+			});
     }
 
-
-
-    class LogViewHandler extends Handler {
-
-        final static int MSG_LOGVIEW_UPDATE = 0;
-        volatile boolean isHandling;
-        volatile boolean isAddNewLog;
+    // ====================== 内部类：日志视图 Handler（主线程更新 UI） ======================
+    /**
+     * 日志视图 Handler（运行在主线程，处理日志刷新消息）
+     * 避免跨线程操作 UI，通过标志位控制并发刷新
+     */
+    private class LogViewHandler extends Handler {
+        /** 日志刷新消息标识 */
+        private static final int MSG_LOG_REFRESH = 0;
+        /** 日志处理中标志（与外部 mIsHandling 同步） */
+        private volatile boolean isHandling;
+        /** 新日志添加标志（与外部 mIsAddNewLog 同步） */
+        private volatile boolean isAddNewLog;
 
         public LogViewHandler() {
             setIsHandling(false);
@@ -350,24 +414,32 @@ public class LogView extends RelativeLayout {
             return isAddNewLog;
         }
 
+        @Override
         public void handleMessage(Message msg) {
+            super.handleMessage(msg);
             switch (msg.what) {
-                case MSG_LOGVIEW_UPDATE:{
-                        if (isHandling() == false) {
-                            setIsHandling(true);
-                            showAndScrollLogView();
-                        }
-                        break;
+                case MSG_LOG_REFRESH:
+                    // 未处理日志刷新时，标记为处理中并触发显示
+                    if (!isHandling()) {
+                        setIsHandling(true);
+                        showAndScrollLogView();
                     }
+                    break;
                 default:
                     break;
             }
-            super.handleMessage(msg);
         }
     }
 
-    public class TAGItemModel {
+    // ====================== 内部类：TAG 数据模型（封装 TAG 名称与状态） ======================
+    /**
+     * TAG 列表项数据模型
+     * 封装单个 TAG 的名称及其启用状态（用于 Adapter 数据绑定）
+     */
+    private class TAGItemModel {
+        /** TAG 名称（如 "LogViewThread"、"LogUtils"） */
         private String tag;
+        /** TAG 启用状态（true：启用；false：禁用） */
         private boolean isChecked;
 
         public TAGItemModel(String tag, boolean isChecked) {
@@ -391,18 +463,17 @@ public class LogView extends RelativeLayout {
             isChecked = checked;
         }
 
-        // getter/setter...
-
+        /**
+         * 重写 equals 方法（按 TAG 名称判断相等）
+         * @param o 比较对象
+         * @return true：TAG 名称相同；false：不同
+         */
         @Override
         public boolean equals(Object o) {
-            if (this == o) {
-                return true;
-            }
-            if (o == null || getClass() != o.getClass()) {
-                return false;
-            }
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
             TAGItemModel that = (TAGItemModel) o;
-            // 手动处理空值比较（Java 6 不支持 Objects.equals）
+            // 手动处理空值比较（兼容 Java 7，不依赖 Objects.equals）
             if (tag == null) {
                 return that.tag == null;
             } else {
@@ -410,106 +481,174 @@ public class LogView extends RelativeLayout {
             }
         }
 
+        /**
+         * 重写 hashCode 方法（基于 TAG 名称生成哈希值）
+         * @return 哈希值（空 TAG 返回 0）
+         */
         @Override
         public int hashCode() {
-            return tag == null ? 0 : tag.hashCode(); // 手动处理空值
+            return tag == null ? 0 : tag.hashCode();
         }
     }
 
-
-    public class TAGListAdapter extends BaseAdapter {
-
+    // ====================== 内部类：TAG 列表适配器（绑定数据与视图） ======================
+    /**
+     * TAG 水平列表适配器（继承 BaseAdapter）
+     * 负责 TAG 数据与列表项视图的绑定，处理勾选状态变化
+     */
+    private class TAGListAdapter extends BaseAdapter {
+        /** 上下文对象（用于加载列表项布局） */
         private Context context;
-        private Map<String, Boolean> mapOrigin;
-        private List<TAGItemModel> itemList;
+        /** 原始 TAG 启用状态映射表（来自 LogUtils） */
+        private Map<String, Boolean> originTagMap;
+        /** TAG 列表项数据（转换为 TAGItemModel 列表，便于排序和绑定） */
+        private List<TAGItemModel> tagItemList;
 
-        public TAGListAdapter(Context context, Map<String, Boolean> map) {
+        /**
+         * 构造方法（初始化数据并加载到列表）
+         * @param context 上下文
+         * @param tagMap TAG 启用状态映射表
+         */
+        public TAGListAdapter(Context context, Map<String, Boolean> tagMap) {
             this.context = context;
-            mapOrigin = map;
-            loadMap(mapOrigin);
+            this.originTagMap = tagMap;
+            loadTagData(originTagMap); // 加载并转换数据
         }
 
+        /**
+         * 获取 TAG 列表项数据（供外部定位 TAG 使用）
+         * @return TAGItemModel 列表
+         */
         public List<TAGItemModel> getItemList() {
-            return itemList;
+            return tagItemList;
         }
 
+        // ====================== BaseAdapter 抽象方法实现 ======================
         @Override
         public int getCount() {
-            return itemList.size();
+            return tagItemList == null ? 0 : tagItemList.size();
         }
 
         @Override
-        public Object getItem(int p) {
-            return itemList.get(p);
+        public Object getItem(int position) {
+            return tagItemList.get(position);
         }
 
         @Override
-        public long getItemId(int p) {
-            return p;
+        public long getItemId(int position) {
+            return position;
         }
 
-        void loadMap(Map<String, Boolean> map) {
-            itemList = new ArrayList<TAGItemModel>();
-            for (Map.Entry<String, Boolean> entry : map.entrySet()) {
-                itemList.add(new TAGItemModel(entry.getKey(), entry.getValue()));
+        /**
+         * 加载 TAG 数据（将 Map 转换为 List 并排序）
+         * @param tagMap TAG 启用状态映射表
+         */
+        private void loadTagData(Map<String, Boolean> tagMap) {
+            tagItemList = new ArrayList<>();
+            // 遍历 Map，转换为 TAGItemModel 并添加到列表
+            for (Map.Entry<String, Boolean> entry : tagMap.entrySet()) {
+                tagItemList.add(new TAGItemModel(entry.getKey(), entry.getValue()));
             }
-            // 添加排序功能，按照tag进行升序排序
-            Collections.sort(itemList, new SortMapEntryByKeyString(true));
-            //Collections.sort(itemList, new SortMapEntryByKeyString(false));
+            // 按 TAG 名称升序排序（中文排序兼容）
+            Collections.sort(tagItemList, new TagAscComparator(true));
         }
 
+        /**
+         * 重新加载 TAG 数据（用于全选/反选后刷新列表）
+         */
         public void reload() {
-            loadMap(mapOrigin);
-            super.notifyDataSetChanged();
+            loadTagData(originTagMap); // 重新加载数据
+            notifyDataSetChanged(); // 通知视图刷新
         }
 
+        /**
+         * 创建/复用列表项视图（优化性能，避免重复 inflate）
+         * @param position 列表项位置
+         * @param convertView 复用视图（可为 null）
+         * @param parent 父容器
+         * @return 列表项视图
+         */
         @Override
         public View getView(int position, View convertView, ViewGroup parent) {
             ViewHolder holder;
+            // 复用视图（减少布局加载开销）
             if (convertView == null) {
+                // 加载列表项布局（R.layout.item_logtag 为 TAG 项自定义布局）
                 convertView = LayoutInflater.from(context).inflate(R.layout.item_logtag, parent, false);
                 holder = new ViewHolder();
-                holder.tvText = convertView.findViewById(R.id.viewlogtagTextView1);
-                holder.cbChecked = convertView.findViewById(R.id.viewlogtagCheckBox1);
-                convertView.setTag(holder);
+                // 绑定列表项控件（TAG 文本和勾选框）
+                holder.tagTv = convertView.findViewById(R.id.viewlogtagTextView1);
+                holder.tagCb = convertView.findViewById(R.id.viewlogtagCheckBox1);
+                convertView.setTag(holder); // 保存 ViewHolder 到视图
             } else {
-                holder = (ViewHolder) convertView.getTag();
+                holder = (ViewHolder) convertView.getTag(); // 复用 ViewHolder
             }
 
-            final TAGItemModel item = itemList.get(position);
-            holder.tvText.setText(item.getTag());
-            holder.cbChecked.setChecked(item.isChecked());
-            holder.cbChecked.setOnClickListener(new View.OnClickListener(){
+            // 绑定数据到视图
+            final TAGItemModel item = tagItemList.get(position);
+            holder.tagTv.setText(item.getTag()); // 设置 TAG 名称
+            holder.tagCb.setChecked(item.isChecked()); // 设置勾选状态
 
-                    @Override
-                    public void onClick(View v) {
-                        LogUtils.setTAGListEnable(item.getTag(), ((CheckBox)v).isChecked());
-                    }
-                });
+            // 勾选框点击监听（更新 TAG 启用状态）
+            holder.tagCb.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						boolean isChecked = ((CheckBox) v).isChecked();
+						// 调用 LogUtils 更新该 TAG 的启用状态
+						LogUtils.setTagEnable(item.getTag(), isChecked);
+						// 同步更新本地模型状态（避免刷新后状态不一致）
+						item.setChecked(isChecked);
+					}
+				});
 
             return convertView;
         }
 
-        public class ViewHolder {
-            TextView tvText;
-            CheckBox cbChecked;
+        /**
+         * 列表项 ViewHolder（缓存控件，提升列表滑动性能）
+         */
+        private class ViewHolder {
+            TextView tagTv; // TAG 名称文本控件
+            CheckBox tagCb; // TAG 启用状态勾选框
         }
     }
 
-    class SortMapEntryByKeyString implements Comparator<TAGItemModel> {
-        private boolean mIsDesc = true;
-        // isDesc 是否降序排列
-        public SortMapEntryByKeyString(boolean isDesc) {
-            mIsDesc = isDesc;
+    // ====================== 内部类：TAG 排序比较器（中文兼容） ======================
+    /**
+     * TAG 名称排序比较器（实现 Comparator）
+     * 支持中文排序（基于系统默认中文 Locale），可选择升序/降序
+     */
+    private class TagAscComparator implements Comparator<TAGItemModel> {
+        /** 排序方向（true：升序；false：降序） */
+        private boolean isAsc;
+        /** 中文排序器（兼容中文汉字排序） */
+        private Collator chineseCollator = Collator.getInstance(java.util.Locale.CHINA);
+
+        public TagAscComparator(boolean isAsc) {
+            this.isAsc = isAsc;
         }
-        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
+
+        /**
+         * 比较两个 TAGItemModel（按 TAG 名称排序）
+         * @param o1 第一个比较对象
+         * @param o2 第二个比较对象
+         * @return 比较结果（正数：o1 在 o2 后；负数：o1 在 o2 前；0：相等）
+         */
         @Override
         public int compare(TAGItemModel o1, TAGItemModel o2) {
-            if (mIsDesc) {
-                return o1.getTag().compareTo(o2.getTag());
+            String tag1 = o1.getTag();
+            String tag2 = o2.getTag();
+            // 处理空值（空 TAG 排在最前）
+            if (tag1 == null) return -1;
+            if (tag2 == null) return 1;
+
+            // 根据排序方向返回比较结果
+            if (isAsc) {
+                return chineseCollator.compare(tag1, tag2); // 升序
             } else {
-                return o2.getTag().compareTo(o1.getTag());
+                return chineseCollator.compare(tag2, tag1); // 降序
             }
         }
     }
 }
+

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

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

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

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

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

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

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

@@ -2,6 +2,5 @@
 <resources>
 
     <string name="lib_name">libappbase</string>
-    <string name="hello_world">Hello world!</string>
-    <string name="action_sos">cc.winboll.studio.libappbase.action.SOS</string>
+    <string name="hello_world">Hello, world!</string>
 </resources>

powerbell/README.md

@@ -24,7 +24,7 @@
 
 1.  Fork 本仓库
 2.  新建 Feat_xxx 分支
-3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@qq.com>)
 4.  新建 Pull Request
 
 

powerbell/build.gradle

@@ -18,40 +18,46 @@ def genVersionName(def versionName){
 }
 
 android {
-    compileSdkVersion 32
-    buildToolsVersion "32.0.0"
+    
+    // 1. compileSdkVersion：必须 ≥ targetSdkVersion，建议直接等于 targetSdkVersion（30）
+    compileSdkVersion 30
+
+    // 2. buildToolsVersion：需匹配 compileSdkVersion，建议使用 30.x.x 最新稳定版（无需高于 compileSdkVersion）
+    buildToolsVersion "30.0.3" // 这是 30 对应的最新稳定版，避免使用 beta 版
 
     defaultConfig {
         applicationId "cc.winboll.studio.powerbell"
-        minSdkVersion 24
+        minSdkVersion 23
         targetSdkVersion 30
         versionCode 6
         // versionName 更新后需要手动设置 
         // .winboll/winbollBuildProps.properties 文件的 stageCount=0
         // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
-        versionName "15.4" 
+        versionName "15.11" 
         if(true) {
             versionName = genVersionName("${versionName}")
         }
     }
 
-    buildTypes {
-        release {
-            minifyEnabled false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
-        }
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
     }
 }
 
 dependencies {
-    api fileTree(dir: 'libs', include: ['*.jar'])
-    api 'cc.winboll.studio:libaes:15.9.3'
-    api 'cc.winboll.studio:libapputils:15.8.5'
-    api 'cc.winboll.studio:libappbase:15.9.5'
-    
-    // 吐司提示库
-    api 'com.github.getActivity:ToastUtils:10.5'
-    // 应用介绍页类库
+	
+	// 米盟
+	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'
+	
+	
+	 // 应用介绍页类库
     api 'io.github.medyo:android-about-page:2.0.0'
     // SSH
     api 'com.jcraft:jsch:0.1.55'
@@ -71,23 +77,9 @@ dependencies {
     //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
     //api 'androidx.fragment:fragment:1.1.0'
     
-    
-    /*api 'cc.winboll.studio:winboll-shared:1.8.0'
-    api 'io.github.medyo:android-about-page:2.0.0'
-    api 'com.jcraft:jsch:0.1.55'
-    api 'org.jsoup:jsoup:1.13.1'
-    api 'com.squareup.okhttp3:okhttp:4.4.1'
-    
-    api 'androidx.appcompat:appcompat:1.0.0'
-    api 'androidx.fragment:fragment:1.0.0'
-    api 'com.google.android.material:material:1.0.0'
-    
-    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
-    api 'com.github.getActivity:ToastUtils:10.5'
-    api 'io.github.medyo:android-about-page:2.0.0'
-    api 'org.jsoup:jsoup:1.13.1'
-    api 'com.squareup.okhttp3:okhttp:4.4.1'
-    
-    api 'cc.winboll.studio:libaes:7.6.0'
-    */
+	implementation 'cc.winboll.studio:libaes:15.11.8'
+    implementation 'cc.winboll.studio:libappbase:15.11.0'
+	
+    //api fileTree(dir: 'libs', include: ['*.aar'])
+    api fileTree(dir: 'libs', include: ['*.jar'])
 }

powerbell/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Wed Sep 03 20:59:53 HKT 2025
-stageCount=13
+#Thu Nov 27 19:24:29 HKT 2025
+stageCount=11
 libraryProject=
-baseVersion=15.4
-publishVersion=15.4.12
+baseVersion=15.11
+publishVersion=15.11.10
 buildCount=0
-baseBetaVersion=15.4.13
+baseBetaVersion=15.11.11

powerbell/proguard-rules.pro

@@ -9,9 +9,135 @@
 
 # Add any project specific keep options here:
 
-# If your project uses WebView with JS, uncomment the following
-# and specify the fully qualified class name to the JavaScript interface
-# class:
-#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
-#   public *;
-#}
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep 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

@@ -6,18 +6,6 @@
         tools:replace="android:icon"
         android:icon="@drawable/ic_launcher_beta">
 
-        <provider
-            android:name="androidx.core.content.FileProvider"
-            android:authorities="cc.winboll.studio.powerbell.beta.fileprovider"
-            android:exported="false"
-            android:grantUriPermissions="true">
-
-            <meta-data
-                android:name="android.support.FILE_PROVIDER_PATHS"
-                android:resource="@xml/file_provider"/>
-
-        </provider>
-
     </application>
 
 </manifest>

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

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

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

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

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

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

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

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

powerbell/src/main/AndroidManifest.xml

@@ -1,8 +1,15 @@
 <?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.ACCESS_FINE_LOCATION"/>
+
+    <!-- 只有在前台运行时才能获取大致位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+
     <!-- 拍摄照片和视频 -->
     <uses-permission android:name="android.permission.CAMERA"/>
 
@@ -24,10 +31,29 @@
     <!-- 显示通知 -->
     <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-feature android:name="android.hardware.camera"/>
 
     <uses-feature android:name="android.hardware.camera.autofocus"/>
 
+    <uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
+
+    <uses-permission
+        android:name="android.permission.QUERY_ALL_PACKAGES"
+        tools:ignore="QueryAllPackagesPermission"/>
+
+    <uses-permission
+        android:name="android.permission.ACCESS_PACKAGE_USAGE_STATS"
+        tools:ignore="ProtectedPermissions"/>
+
     <application
         android:name=".App"
         android:allowBackup="true"
@@ -36,12 +62,27 @@
         android:theme="@style/AppTheme_Default"
         android:persistent="true"
         android:resizeableActivity="true"
-        android:requestLegacyExternalStorage="true">
+        android:requestLegacyExternalStorage="true"
+        android:usesCleartextTraffic="true"
+        tools:ignore="GoogleAppIndexingWarning">
 
         <activity
             android:name=".MainActivity"
-            android:launchMode="singleTask"
-            android:exported="true">
+            android:label="@string/app_name"
+            android:exported="true"
+            android:launchMode="singleTask">
+
+        </activity>
+
+        <activity android:name=".activities.CrashActivity"/>
+
+        <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>
 
@@ -51,7 +92,55 @@
 
             </intent-filter>
 
-        </activity>
+            <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:name="cc.winboll.studio.powerbell.activities.ClearRecordActivity"
@@ -123,6 +212,26 @@
 
         <activity android:name="cc.winboll.studio.powerbell.activities.PixelPickerActivity"/>
 
+        <activity android:name="cc.winboll.studio.powerbell.activities.BatteryReportActivity"/>
+
+        <activity android:name="cc.winboll.studio.powerbell.unittest.MainUnitTestActivity"/>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+
+        <activity android:name="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"/>
+
+        <activity android:name="cc.winboll.studio.powerbell.activities.SettingsActivity"/>
+
     </application>
 
 </manifest>

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

@@ -4,16 +4,23 @@ import android.content.Context;
 import android.os.Environment;
 import android.view.Gravity;
 import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
 import cc.winboll.studio.powerbell.receivers.GlobalApplicationReceiver;
 import cc.winboll.studio.powerbell.utils.AppCacheUtils;
 import cc.winboll.studio.powerbell.utils.AppConfigUtils;
-import com.hjq.toast.ToastUtils;
 import java.io.File;
 
 public class App extends GlobalApplication {
 
-    public static final String TAG = "GlobalApplication";
-
+    public static final String TAG = "App";
+	
+	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";
+	
     // 数据配置存储工具
     static AppConfigUtils _mAppConfigUtils;
     static AppCacheUtils _mAppCacheUtils;
@@ -27,6 +34,7 @@ public class App extends GlobalApplication {
     @Override
     public void onCreate() {
         super.onCreate();
+		setIsDebugging(BuildConfig.DEBUG);
 
         // 临时文件夹方案1
         // 获取Pictures文件夹路径（Android 10及以上推荐使用MediaStore，此处为传统方式）
@@ -50,7 +58,7 @@ public class App extends GlobalApplication {
         // 设置 Toast 布局样式
         //ToastUtils.setView(R.layout.toast_custom_view);
         //ToastUtils.setStyle(new WhiteToastStyle());
-        ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
+        //ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
 
         // 设置数据配置存储工具
         _mAppConfigUtils = getAppConfigUtils(this);
@@ -77,5 +85,13 @@ public class App extends GlobalApplication {
     public void clearBatteryHistory() {
         _mAppCacheUtils.clearBatteryHistory();
     }
+
+	@Override
+	public void onTerminate() {
+		super.onTerminate();
+		ToastUtils.release();
+	}
+	
+	
 }
 

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

@@ -8,36 +8,66 @@ import android.database.Cursor;
 import android.net.Uri;
 import android.os.Bundle;
 import android.provider.MediaStore;
+import android.view.KeyEvent;
 import android.view.Menu;
 import android.view.MenuItem;
 import android.widget.RelativeLayout;
-import android.widget.Toast;
-import cc.winboll.studio.libaes.views.AToolbar;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.LogActivity;
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.powerbell.MainActivity;
 import cc.winboll.studio.powerbell.activities.AboutActivity;
 import cc.winboll.studio.powerbell.activities.BackgroundPictureActivity;
-import cc.winboll.studio.powerbell.activities.BatteryReporterActivity;
+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.beans.BackgroundPictureBean;
 import cc.winboll.studio.powerbell.fragments.MainViewFragment;
+import cc.winboll.studio.powerbell.unittest.MainUnitTestActivity;
 import cc.winboll.studio.powerbell.utils.BackgroundPictureUtils;
 
+/**
+ * 主活动类（修复小米广告SDK空Context崩溃问题）
+ * 核心修改点：
+ * 1. 添加全局Context安全校验
+ * 2. 优化广告请求的生命周期判断
+ * 3. 确保广告操作在主线程执行
+ * 4. 完善广告资源释放逻辑
+ */
 public class MainActivity extends WinBoLLActivity {
 
     public static final String TAG = "MainActivity";
-    public static final int BACKGROUND_PICTURE_REQUEST_CODE = 0;
+
+    private static final int REQUEST_WRITE_STORAGE_PERMISSION = 1001;
+
+//    private static final String PRIVACY_FILE = "privacy_pfs";
+//    private static final String PRIVACY_VALUE = "privacy_value";//0: 拒绝，1：赞同
+//
+//    private SharedPreferences mSharedPreferences;
+//
+//    private String BANNER_POS_ID = "802e356f1726f9ff39c69308bfd6f06a";
+//    private String BANNER_POS_ID_WINBOLL_BETA = "d129ee5a263911f981a6dc7a9802e3e7";
+//    private String BANNER_POS_ID_WINBOLL = "4ec30efdb32271765b9a4efac902828b";
+
+//    private BannerAd mBannerAd;
+//    private List<BannerAd> mAllBanners = new ArrayList<>();
+//
+//    private ViewGroup mContainer;
+//
+//    private boolean mIsBiddingWin = true;
+//
+//    public static final int BACKGROUND_PICTURE_REQUEST_CODE = 0;
 
     public static MainActivity _mMainActivity;
-    //LogView mLogView;
-    //ArrayList<Fragment> mlistFragment;
-    App mApplication;
-    //AppConfigUtils mAppConfigUtils;
-    Menu mMenu;
-    Fragment mCurrentShowFragment;
-    MainViewFragment mMainViewFragment;
-    AToolbar mAToolbar;
+    private App mApplication;
+    private Menu mMenu;
+    private Fragment mCurrentShowFragment;
+    private MainViewFragment mMainViewFragment;
+    private Toolbar mToolbar;
+    // 新增：主线程Handler，确保广告操作在主线程执行
+    //private Handler mMainHandler;
+	ADsBannerView mADsBannerView;
 
     @Override
     public Activity getActivity() {
@@ -51,26 +81,28 @@ public class MainActivity extends WinBoLLActivity {
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
-        //LogUtils.d(TAG, "onCreate(...)");
+        LogUtils.d(TAG, "onCreate(...)");
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
+		mADsBannerView = findViewById(R.id.adsbanner);
 
-        // 设置调试日志
-//        mLogView = findViewById(R.id.logview);
-//        mLogView.start();
-//        //LogUtils.d(TAG, "LogView Start.");
-//        mLogView.updateLogView();
+//        mContainer = findViewById(R.id.ads_container);
+//
+//        // 初始化主线程Handler（关键：确保广告操作在主线程执行）
+//        mMainHandler = new Handler(Looper.getMainLooper());
+//
+//        // 米盟模块：隐私协议弹窗
+//        showPrivacy();
 
-        _mMainActivity = MainActivity.this;
+        _mMainActivity = this;
         mApplication = (App) getApplication();
-        //mAppConfigUtils = AppConfigUtils.getInstance(mApplication);
 
         // 初始化工具栏
-        mAToolbar = (AToolbar) findViewById(R.id.toolbar);
-        setActionBar(mAToolbar);
-        //mAToolbar.setSubtitle("Main");
-        mAToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
 
+        // 初始化主Fragment
         if (mMainViewFragment == null) {
             FragmentTransaction tx = getFragmentManager().beginTransaction();
             mMainViewFragment = new MainViewFragment();
@@ -78,13 +110,46 @@ public class MainActivity extends WinBoLLActivity {
             tx.commit();
         }
         showFragment(mMainViewFragment);
-
-//        NotificationHelper notificationUtils = new NotificationHelper(this);
-//        notificationUtils.createNotificationChannels();
-
-
     }
 
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+//        // 修复：释放广告资源，避免内存泄漏
+//        releaseAdResources();
+        // 置空静态引用，避免内存泄漏
+        _mMainActivity = null;
+//        // 移除Handler回调
+//        if (mMainHandler != null) {
+//            mMainHandler.removeCallbacksAndMessages(null);
+//        }
+		if (mADsBannerView != null) {
+			mADsBannerView.releaseAdResources();
+		}
+    }
+//
+//    /**
+//     * 释放广告资源（关键：避免内存泄漏和空Context调用）
+//     */
+//    private void releaseAdResources() {
+//        LogUtils.d(TAG, "releaseAdResources()");
+//        // 销毁所有广告实例
+//        if (mAllBanners != null && !mAllBanners.isEmpty()) {
+//            for (BannerAd ad : mAllBanners) {
+//                if (ad != null) {
+//                    ad.destroy();
+//                }
+//            }
+//            mAllBanners.clear();
+//        }
+//        // 置空当前广告引用
+//        mBannerAd = null;
+//        // 移除广告容器中的视图
+//        if (mContainer != null) {
+//            mContainer.removeAllViews();
+//        }
+//    }
+
     void showFragment(Fragment fragment) {
         FragmentTransaction tx = getFragmentManager().beginTransaction();
         for (Fragment item : getFragmentManager().getFragments()) {
@@ -95,7 +160,6 @@ public class MainActivity extends WinBoLLActivity {
         mCurrentShowFragment = fragment;
     }
 
-
     @Override
     protected void onPostCreate(Bundle savedInstanceState) {
         super.onPostCreate(savedInstanceState);
@@ -103,8 +167,9 @@ public class MainActivity extends WinBoLLActivity {
     }
 
     public static void reloadBackground() {
-        if (_mMainActivity != null) {
-            _mMainActivity.mMainViewFragment.loadBackground();
+        // 修复：添加非空校验，避免Activity已销毁时调用
+        if (_mMainActivity != null && !_mMainActivity.isFinishing() && !_mMainActivity.isDestroyed()) {
+            _mMainActivity.mMainViewFragment.reloadBackground();
         }
     }
 
@@ -113,94 +178,95 @@ public class MainActivity extends WinBoLLActivity {
      */
     private String getRealPathFromURI(Uri contentUri) {
         String[] proj = {MediaStore.MediaColumns.DATA};
-        Cursor cursor=getContentResolver().query(contentUri, proj, null, null, null);
-        if (cursor.moveToNext()) {
-			int nColumnIndex = cursor.getColumnIndex(MediaStore.MediaColumns.DATA);
-			if (nColumnIndex > -1) {
-				return cursor.getString(nColumnIndex);
-			} else {
-				LogUtils.d(TAG, "getRealPathFromURI nColumnIndex is -1.");
-			}
+        Cursor cursor = getContentResolver().query(contentUri, proj, null, null, null);
+        if (cursor != null && cursor.moveToNext()) {
+            int nColumnIndex = cursor.getColumnIndex(MediaStore.MediaColumns.DATA);
+            if (nColumnIndex > -1) {
+                String path = cursor.getString(nColumnIndex);
+                cursor.close();
+                return path;
+            } else {
+                LogUtils.d(TAG, "getRealPathFromURI nColumnIndex is -1.");
+            }
+            cursor.close();
         }
-        cursor.close();
         return null;
-	}
+    }
 
     @Override
     protected void onResume() {
         super.onResume();
-        // 回到窗口自动取消提醒消息
-        //NotificationHelper.cancelRemindNotification(this);
         reloadBackground();
-		setBackgroundColor();
+        setBackgroundColor();
+		if (mADsBannerView != null) {
+			mADsBannerView.resumeADs(MainActivity.this);
+		}
+
+//        // 修复：优化广告请求逻辑（添加生命周期判断 + 主线程执行）
+//        if (!isFinishing() && !isDestroyed()) {
+//			String privacyAgreeValue = getSharedPreferences().getString(PRIVACY_VALUE, null);
+//			if (TextUtils.equals(privacyAgreeValue, String.valueOf(1))) {
+//				LogUtils.i(TAG, "已同意隐私协议，开始播放米盟广告...");
+//				mMainHandler.postDelayed(new Runnable() {
+//						@Override
+//						public void run() {
+//							// 再次校验生命周期，避免延迟执行时Activity已销毁
+//							if (!isFinishing() && !isDestroyed()) {
+//								fetchAd();
+//							}
+//						}
+//					}, 1000); // 延迟1秒请求广告，提升页面加载体验
+//			}
+//
+//        }
     }
 
-    // Menu icons are inflated just as they were with actionbar
-    //
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
-        // Inflate the menu; this adds items to the action bar if it is present.
         mMenu = menu;
         getMenuInflater().inflate(R.menu.toolbar_main, mMenu);
+		if (App.isDebugging()) {
+			getMenuInflater().inflate(R.menu.toolbar_unittest, mMenu);
+		}
         return true;
     }
 
-    // 回退开发者选项重设UI到初始用户状态
-    //
-    /*public void resetUI(MainActivity MainActivity) {
-     mMenu.clear();
-     getMenuInflater().inflate(R.menu.toolbar_main, mMenu);
-     }*/
-
-    @Override 
-    public boolean onOptionsItemSelected(MenuItem item) { 
-        super.onOptionsItemSelected(item); 
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        super.onOptionsItemSelected(item);
         int menuItemId = item.getItemId();
-        if (menuItemId == R.id.action_about) {
-            Intent intent = new Intent(this, AboutActivity.class);
-            startActivity(intent);
-        } else if (menuItemId == R.id.action_battery_reporter) {
-            Intent intent = new Intent();
-            intent.setClass(this, BatteryReporterActivity.class);
-            startActivity(intent);
+        if (menuItemId == R.id.action_settings) {
+            startActivity(new Intent(this, SettingsActivity.class));
+        } else if (menuItemId == R.id.action_about) {
+            startActivity(new Intent(this, AboutActivity.class));
+        } else if (menuItemId == R.id.action_battery_report) {
+            startActivity(new Intent(this, BatteryReportActivity.class));
         } else if (menuItemId == R.id.action_clearrecord) {
-            Intent intent = new Intent();
-            intent.setClass(this, ClearRecordActivity.class);
-            startActivity(intent);
+            startActivity(new Intent(this, ClearRecordActivity.class));
         } else if (menuItemId == R.id.action_changepicture) {
-            Intent intent = new Intent();
-            intent.setClass(this, BackgroundPictureActivity.class);
-            startActivity(intent);
+            startActivity(new Intent(this, BackgroundPictureActivity.class));
         } else if (menuItemId == R.id.action_log) {
-            App.getWinBoLLActivityManager().startLogActivity(this);
+            LogActivity.startLogActivity(this);
+        } else if (menuItemId == R.id.action_unittestactivity) {
+            startActivity(new Intent(this, MainUnitTestActivity.class));
         }
-
         return true;
     }
 
     @Override
     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
-        //LogUtils.d(TAG, "onActivityResult(...)");
-        //LogUtils.d(TAG, "requestCode is : " + Integer.toString(requestCode));
-        //LogUtils.d(TAG, "resultCode is : " + Integer.toString(resultCode));
-
         super.onActivityResult(requestCode, resultCode, data);
-        if (requestCode == BACKGROUND_PICTURE_REQUEST_CODE) {
-            // 处理选择后图片
-            if (resultCode == RESULT_OK) {
-                //mMainViewFragment.loadBackgroundPicture();
-                Toast.makeText(getApplication(), "OK", Toast.LENGTH_SHORT).show();
-            }
-        } else {
-            String sz = "Unsolved requestCode = " + Integer.toString(requestCode);
-            Toast.makeText(getApplication(), sz, Toast.LENGTH_SHORT).show();
-            LogUtils.d(TAG, sz);
-        }
+//        if (requestCode == BACKGROUND_PICTURE_REQUEST_CODE) {
+//            if (resultCode == RESULT_OK) {
+//                Toast.makeText(getApplicationContext(), "OK", Toast.LENGTH_SHORT).show();
+//            }
+//        } else {
+//            String sz = "Unsolved requestCode = " + Integer.toString(requestCode);
+//            Toast.makeText(getApplicationContext(), sz, Toast.LENGTH_SHORT).show();
+//            LogUtils.d(TAG, sz);
+//        }
     }
 
-    /**
-     * 返回键
-     */
     @Override
     public void onBackPressed() {
         if (mCurrentShowFragment != mMainViewFragment) {
@@ -210,11 +276,349 @@ public class MainActivity extends WinBoLLActivity {
         }
     }
 
-	void setBackgroundColor() {
-		BackgroundPictureUtils utils = BackgroundPictureUtils.getInstance(MainActivity.this);
-		BackgroundPictureBean bean = utils.getBackgroundPictureBean();
-		int nPixelColor = bean.getPixelColor();
-		RelativeLayout mainLayout = findViewById(R.id.activitymainRelativeLayout1);
-		mainLayout.setBackgroundColor(nPixelColor);
-	}
-} 
+    void setBackgroundColor() {
+        // 修复：添加Activity非空校验
+        if (isFinishing() || isDestroyed()) {
+            return;
+        }
+        BackgroundPictureUtils utils = BackgroundPictureUtils.getInstance(this);
+        BackgroundPictureBean bean = utils.getBackgroundPictureBean();
+        int nPixelColor = bean.getPixelColor();
+        RelativeLayout mainLayout = findViewById(R.id.activitymainRelativeLayout1);
+        if (mainLayout != null) {
+            mainLayout.setBackgroundColor(nPixelColor);
+        }
+    }
+//
+//    /**
+//     * 显示广告（核心修复：传递安全的Context + 生命周期校验）
+//     */
+//    private void showAd() {
+//        LogUtils.d(TAG, "showAd()");
+//        // 1. 生命周期校验：避免Activity已销毁时操作UI
+//        if (isFinishing() || isDestroyed()) {
+//            LogUtils.e(TAG, "showAd: Activity is finishing or destroyed");
+//            return;
+//        }
+//        // 2. 非空校验：广告实例和容器
+//        if (mBannerAd == null || mContainer == null) {
+//            LogUtils.e(TAG, "showAd: BannerAd or Container is null");
+//            return;
+//        }
+//        // 3. 创建广告容器（使用ApplicationContext避免内存泄漏）
+//        final FrameLayout container = new FrameLayout(getApplicationContext());
+//        container.setPadding(0, 0, 0, MimoUtils.dpToPx(this, 10));
+//        mContainer.addView(container, new FrameLayout.LayoutParams(
+//							   FrameLayout.LayoutParams.MATCH_PARENT,
+//							   FrameLayout.LayoutParams.WRAP_CONTENT
+//						   ));
+//
+//        if (mIsBiddingWin) {
+//            mBannerAd.setPrice(getPrice());
+//        }
+//        // 4. 显示广告：传递ApplicationContext，避免Activity Context失效
+//        mBannerAd.showAd(MainActivity.this, container, new BannerAd.BannerInteractionListener() {
+//				@Override
+//				public void onAdClick() {
+//					LogUtils.d(TAG, "onAdClick");
+//				}
+//
+//				@Override
+//				public void onAdShow() {
+//					LogUtils.d(TAG, "onAdShow");
+//				}
+//
+//				@Override
+//				public void onAdDismiss() {
+//					LogUtils.d(TAG, "onAdDismiss");
+//					// 修复：移除容器时校验Activity状态
+//					if (!isFinishing() && !isDestroyed() && mContainer != null) {
+//						mContainer.removeView(container);
+//					}
+//				}
+//
+//				@Override
+//				public void onRenderSuccess() {
+//					LogUtils.d(TAG, "onRenderSuccess");
+//				}
+//
+//				@Override
+//				public void onRenderFail(int code, String msg) {
+//					LogUtils.e(TAG, "onRenderFail errorCode " + code + " errorMsg " + msg);
+//					// 修复：渲染失败时移除容器
+//					if (!isFinishing() && !isDestroyed() && mContainer != null) {
+//						mContainer.removeView(container);
+//					}
+//				}
+//			});
+//    }
+//
+//    /**
+//     * 请求广告（核心修复：Context安全校验 + 异常捕获 + 资源管理）
+//     */
+//    private void fetchAd() {
+//        LogUtils.d(TAG, "fetchAd()");
+//        // 1. 双重校验：Activity未销毁 + Context非空
+//        if (isFinishing() || isDestroyed() || getApplicationContext() == null) {
+//            LogUtils.e(TAG, "fetchAd: Invalid Context or Activity state");
+//            return;
+//        }
+//        // 2. 释放之前的广告资源，避免内存泄漏
+//        if (mBannerAd != null) {
+//            mBannerAd.destroy();
+//        }
+//        // 3. 初始化广告（使用ApplicationContext，避免Activity Context失效）
+//        try {
+//            mBannerAd = new BannerAd();
+//            mAllBanners.add(mBannerAd);
+//        } catch (Exception e) {
+//            LogUtils.e(TAG, "fetchAd: Init BannerAd failed", e);
+//            return;
+//        }
+//        // 4. 设置下载监听
+//        mBannerAd.setDownLoadListener(new BannerAd.BannerDownloadListener() {
+//				@Override
+//				public void onDownloadStarted() {
+//					LogUtils.d(TAG, "onDownloadStarted");
+//				}
+//
+//				@Override
+//				public void onDownloadPaused() {
+//					LogUtils.d(TAG, "onDownloadPaused");
+//				}
+//
+//				@Override
+//				public void onDownloadFailed(int errorCode) {
+//					LogUtils.d(TAG, "onDownloadFailed, errorCode = " + errorCode);
+//				}
+//
+//				@Override
+//				public void onDownloadFinished() {
+//					LogUtils.d(TAG, "onDownloadFinished");
+//				}
+//
+//				@Override
+//				public void onDownloadProgressUpdated(int progress) {
+//					LogUtils.d(TAG, "onDownloadProgressUpdated " + progress + "%");
+//				}
+//
+//				@Override
+//				public void onInstallFailed(int errorCode) {
+//					LogUtils.d(TAG, "onInstallFailed, errorCode = " + errorCode);
+//				}
+//
+//				@Override
+//				public void onInstallStart() {
+//					LogUtils.d(TAG, "onInstallStart");
+//				}
+//
+//				@Override
+//				public void onInstallSuccess() {
+//					LogUtils.d(TAG, "onInstallSuccess");
+//				}
+//
+//				@Override
+//				public void onDownloadCancel() {
+//					LogUtils.d(TAG, "onDownloadCancel");
+//				}
+//			});
+//
+//        // 5. 构建广告参数并请求
+//        String currentAD_ID = getAD_ID();
+//        LogUtils.d(TAG, String.format("currentAD_ID = %s", currentAD_ID));
+//        ADParams params = new ADParams.Builder().setUpId(currentAD_ID).build();
+//        mBannerAd.loadAd(params, new BannerAd.BannerLoadListener() {
+//				@Override
+//				public void onBannerAdLoadSuccess() {
+//					LogUtils.d(TAG, "onBannerAdLoadSuccess()");
+//					// 修复：广告加载成功后校验Activity状态
+//					if (!isFinishing() && !isDestroyed()) {
+//						showAd();
+//					}
+//				}
+//
+//				@Override
+//				public void onAdLoadFailed(int errorCode, String errorMsg) {
+//					LogUtils.e(TAG, "onAdLoadFailed: errorCode = " + errorCode + ", errorMsg = " + errorMsg);
+//					// 修复：加载失败时移除当前广告实例
+//					if (mAllBanners.contains(mBannerAd)) {
+//						mAllBanners.remove(mBannerAd);
+//					}
+//					mBannerAd.destroy();
+//					mBannerAd = null;
+//				}
+//			});
+//    }
+//
+//    /**
+//     * 根据当前秒数获取广告ID（原逻辑保留）
+//     */
+//    private String getAD_ID() {
+//        long currentSecond = System.currentTimeMillis() / 1000;
+//        return (currentSecond % 2 == 0) ? BANNER_POS_ID :
+//			(BuildConfig.DEBUG ? BANNER_POS_ID_WINBOLL_BETA : BANNER_POS_ID_WINBOLL);
+//    }
+//
+//    /**
+//     * 获取广告价格（原逻辑保留，添加空指针校验）
+//     */
+//    private long getPrice() {
+//        if (mBannerAd == null) {
+//            return 0;
+//        }
+//        Map<String, Object> map = mBannerAd.getMediaExtraInfo();
+//        if (map == null || map.isEmpty() || !map.containsKey("price")) {
+//            LogUtils.w(TAG, "getPrice: media extra info is null or no price key");
+//            return 0;
+//        }
+//        Object priceObj = map.get("price");
+//        if (priceObj instanceof Long) {
+//            return (Long) priceObj;
+//        } else if (priceObj instanceof Integer) {
+//            return ((Integer) priceObj).longValue();
+//        } else {
+//            LogUtils.e(TAG, "getPrice: price type is invalid");
+//            return 0;
+//        }
+//    }
+//
+//    /**
+//     * 显示隐私协议弹窗（原逻辑保留，优化Context使用）
+//     */
+//    private void showPrivacy() {
+//        // 校验Activity状态，避免弹窗泄露
+//        if (isFinishing() || isDestroyed()) {
+//            return;
+//        }
+//        String privacyAgreeValue = getSharedPreferences().getString(PRIVACY_VALUE, null);
+//        if (TextUtils.equals(privacyAgreeValue, String.valueOf(0))) {
+//            LogUtils.i(TAG, "已拒绝隐私协议，广告已处于不可用状态...");
+//            Toast.makeText(getApplicationContext(), "已拒绝隐私协议，广告已处于不可用状态", Toast.LENGTH_SHORT).show();
+//            return;
+//        }
+//        if (TextUtils.equals(privacyAgreeValue, String.valueOf(1))) {
+//            LogUtils.i(TAG, "已同意隐私协议，开始初始化米盟SDK...");
+//            initMimoSdk();
+//            return;
+//        }
+//        LogUtils.i(TAG, "开始弹出隐私协议...");
+//        AlertDialog.Builder builder = new AlertDialog.Builder(this);
+//        builder.setTitle("用户须知");
+//        builder.setMessage("小米广告SDK隐私政策: https://dev.mi.com/distribute/doc/details?pId=1688, 请复制到浏览器查看");
+//        builder.setIcon(R.drawable.ic_launcher);
+//        builder.setCancelable(false); // 点击对话框以外的区域不消失
+//        builder.setPositiveButton("同意", new DialogInterface.OnClickListener() {
+//				@Override
+//				public void onClick(DialogInterface dialog, int which) {
+//					getSharedPreferences().edit()
+//                        .putString(PRIVACY_VALUE, String.valueOf(1))
+//                        .apply();
+//					initMimoSdk();
+//					dialog.dismiss();
+//				}
+//			});
+//        builder.setNegativeButton("拒绝", new DialogInterface.OnClickListener() {
+//				@Override
+//				public void onClick(DialogInterface dialog, int which) {
+//					getSharedPreferences().edit()
+//                        .putString(PRIVACY_VALUE, String.valueOf(0))
+//                        .apply();
+//					dialog.dismiss();
+//				}
+//			});
+//        AlertDialog dialog = builder.create();
+//
+//        // 配置弹窗位置（底部全屏）
+//        Window window = dialog.getWindow();
+//        if (window != null) {
+//            window.setGravity(Gravity.BOTTOM);
+//            WindowManager m = getWindowManager();
+//            Display d = m.getDefaultDisplay();
+//            WindowManager.LayoutParams p = window.getAttributes();
+//            p.width = d.getWidth();
+//            window.setAttributes(p);
+//        }
+//        dialog.show();
+//    }
+//
+//    /**
+//     * 初始化米盟SDK（核心修复：传递ApplicationContext + 异常捕获）
+//     */
+//    private void initMimoSdk() {
+//        // 1. 安全获取ApplicationContext，避免Activity Context失效
+//        Context appContext = getApplicationContext();
+//        if (appContext == null) {
+//            Log.e(TAG, "initMimoSdk: ApplicationContext is null");
+//            return;
+//        }
+//        // 2. 初始化SDK，捕获异常避免崩溃
+//        try {
+//            MimoSdk.init(appContext, new MimoCustomController() {
+//					@Override
+//					public boolean isCanUseLocation() {
+//						return true;
+//					}
+//
+//					@Override
+//					public MimoLocation getMimoLocation() {
+//						return null;
+//					}
+//
+//					@Override
+//					public boolean isCanUseWifiState() {
+//						return true;
+//					}
+//
+//					@Override
+//					public boolean alist() {
+//						return true;
+//					}
+//				}, new MimoSdk.InitCallback() {
+//					@Override
+//					public void success() {
+//						Log.d(TAG, "MimoSdk init success");
+//					}
+//
+//					@Override
+//					public void fail(int code, String msg) {
+//						Log.e(TAG, "MimoSdk init fail, code=" + code + ",msg=" + msg);
+//					}
+//				});
+//            MimoSdk.setDebugOn(true);
+//        } catch (Exception e) {
+//            Log.e(TAG, "initMimoSdk: init failed", e);
+//        }
+//    }
+
+    @Override
+    public boolean dispatchKeyEvent(KeyEvent event) {
+        return super.dispatchKeyEvent(event);
+    }
+
+    @Override
+    public void setupToolbar() {
+        super.setupToolbar();
+        if (getSupportActionBar() != null) {
+            getSupportActionBar().setDisplayHomeAsUpEnabled(false);
+        }
+    }
+//
+//    /**
+//     * 获取SharedPreferences实例（原逻辑保留，添加空指针校验）
+//     */
+//    public SharedPreferences getSharedPreferences() {
+//        if (mSharedPreferences == null) {
+//            // 修复：使用ApplicationContext获取SharedPreferences，避免Activity Context泄露
+//            Context appContext = getApplicationContext();
+//            if (appContext != null) {
+//                mSharedPreferences = appContext.getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
+//            } else {
+//                Log.e(TAG, "getSharedPreferences: ApplicationContext is null");
+//                // 降级方案：若ApplicationContext为空，使用Activity Context（仅作兼容）
+//                mSharedPreferences = super.getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
+//            }
+//        }
+//        return mSharedPreferences;
+//    }
+}
+

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

@@ -10,9 +10,9 @@ import android.content.Context;
 import android.os.Bundle;
 import android.view.ViewGroup;
 import android.widget.LinearLayout;
+import cc.winboll.studio.libaes.models.APPInfo;
 import cc.winboll.studio.libaes.views.AToolbar;
-import cc.winboll.studio.libaes.winboll.APPInfo;
-import cc.winboll.studio.libaes.winboll.AboutView;
+import cc.winboll.studio.libaes.views.AboutView;
 import cc.winboll.studio.powerbell.R;
 
 public class AboutActivity extends Activity {
@@ -57,7 +57,7 @@ public class AboutActivity extends Activity {
         appInfo.setAppGitOwner("Studio");
         appInfo.setAppGitAPPBranch(szBranchName);
         appInfo.setAppGitAPPSubProjectFolder(szBranchName);
-        appInfo.setAppHomePage("https://discuz.winboll.cc/forum.php?mod=viewthread&tid=1");
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=PowerBell");
         appInfo.setAppAPKName("PowerBell");
         appInfo.setAppAPKFolderName("PowerBell");
         return new AboutView(mContext, appInfo);

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

@@ -7,26 +7,28 @@ import android.content.Intent;
 import android.content.pm.PackageManager;
 import android.graphics.Bitmap;
 import android.graphics.BitmapFactory;
-import android.graphics.drawable.Drawable;
 import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
 import android.provider.MediaStore;
+import android.text.TextUtils;
 import android.view.View;
-import android.widget.ImageView;
 import android.widget.RelativeLayout;
 import androidx.core.app.ActivityCompat;
 import androidx.core.content.ContextCompat;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
 import cc.winboll.studio.libaes.views.AToolbar;
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.utils.ToastUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
 import cc.winboll.studio.powerbell.App;
 import cc.winboll.studio.powerbell.R;
 import cc.winboll.studio.powerbell.beans.BackgroundPictureBean;
 import cc.winboll.studio.powerbell.dialogs.BackgroundPicturePreviewDialog;
+import cc.winboll.studio.powerbell.dialogs.NetworkBackgroundDialog;
 import cc.winboll.studio.powerbell.utils.BackgroundPictureUtils;
 import cc.winboll.studio.powerbell.utils.FileUtils;
 import cc.winboll.studio.powerbell.utils.UriUtil;
+import cc.winboll.studio.powerbell.views.BackgroundView;
 import java.io.BufferedOutputStream;
 import java.io.File;
 import java.io.FileNotFoundException;
@@ -53,6 +55,10 @@ public class BackgroundPictureActivity extends WinBoLLActivity implements Backgr
     private File mfTempCropPicture;     // 剪裁临时文件
     private File mfRecivedCropPicture;  // 剪裁后的目标文件
 
+	private String preViewFileBackgroundView = "";
+	BackgroundView bvPreviewBackground;
+	boolean isCommitSettings = false;
+
     // 静态变量
     public static String _mszRecivedCropPicture = "RecivedCrop.jpg";
     private static String _mszCommonFileType = "jpeg";
@@ -102,7 +108,7 @@ public class BackgroundPictureActivity extends WinBoLLActivity implements Backgr
         mAToolbar.setNavigationOnClickListener(new View.OnClickListener() {
                 @Override
                 public void onClick(View v) {
-                    finish();
+                    finish(); // 点击导航栏返回按钮，触发 finish()
                 }
             });
 
@@ -157,31 +163,36 @@ public class BackgroundPictureActivity extends WinBoLLActivity implements Backgr
      */
     public void updatePreviewBackground() {
         LogUtils.d(TAG, "updatePreviewBackground");
-        ImageView ivPreviewBackground = (ImageView) findViewById(R.id.activitybackgroundpictureImageView1);
+        //ImageView ivPreviewBackground = (ImageView) findViewById(R.id.activitybackgroundpictureImageView1);
+        bvPreviewBackground = (BackgroundView) findViewById(R.id.activitybackgroundpictureBackgroundView1);
         BackgroundPictureUtils utils = BackgroundPictureUtils.getInstance(this);
         utils.loadBackgroundPictureBean();
 
         boolean isUseBackgroundFile = utils.getBackgroundPictureBean().isUseBackgroundFile();
         if (isUseBackgroundFile && mfRecivedCropPicture.exists()) {
-            try {
-                String filePath = utils.getBackgroundDir() + getBackgroundFileName();
-                Drawable drawable = FileUtils.getImageDrawable(filePath);
-                if (drawable != null) {
-                    //drawable.setAlpha(120);
-                    ivPreviewBackground.setImageDrawable(drawable);
-                }
-                //ToastUtils.show("背景图片已更新");
-            } catch (IOException e) {
-                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-                ToastUtils.show("背景图片加载失败");
-            }
+            //try {
+			String filePath = utils.getBackgroundDir() + getBackgroundFileName();
+			preViewFileBackgroundView = filePath;
+			bvPreviewBackground.previewBackgroundImage(preViewFileBackgroundView);
+			/*Drawable drawable = FileUtils.getImageDrawable(filePath);
+			 if (drawable != null) {
+			 //drawable.setAlpha(120);
+			 //bvPreviewBackground.setImageDrawable(drawable);
+			 }*/
+			//ToastUtils.show("背景图片已更新");
+//            } catch (IOException e) {
+//                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+//                ToastUtils.show("背景图片加载失败");
+//            }
         } else {
             ToastUtils.show("未使用背景图片");
-            Drawable drawable = getResources().getDrawable(R.drawable.blank10x10);
-            if (drawable != null) {
-                drawable.setAlpha(120);
-                ivPreviewBackground.setImageDrawable(drawable);
-            }
+			preViewFileBackgroundView = "";
+			bvPreviewBackground.previewBackgroundImage(preViewFileBackgroundView);
+//            Drawable drawable = getResources().getDrawable(R.drawable.blank10x10);
+//            if (drawable != null) {
+//                drawable.setAlpha(120);
+//                bvPreviewBackground.setImageDrawable(drawable);
+//            }
         }
     }
 
@@ -433,13 +444,13 @@ public class BackgroundPictureActivity extends WinBoLLActivity implements Backgr
                     fos.close();
                 } catch (IOException e) {
                     LogUtils.e(TAG, "流关闭异常" + e);
-                }
-            }
-            if (scaledBitmap != null && !scaledBitmap.isRecycled()) {
-                scaledBitmap.recycle();
-            }
-        }
-    }
+				}
+			}
+			if (scaledBitmap != null && !scaledBitmap.isRecycled()) {
+				scaledBitmap.recycle();
+			}
+		}
+	}
 
     /**
      * 缩放Bitmap
@@ -589,5 +600,60 @@ public class BackgroundPictureActivity extends WinBoLLActivity implements Backgr
 		super.onResume();
 		setBackgroundColor();
 	}
+
+	public void onNetworkBackgroundDialog(View view) {
+		// 在需要显示对话框的地方（如网络状态监听回调中）
+		NetworkBackgroundDialog dialog = new NetworkBackgroundDialog(this, new NetworkBackgroundDialog.OnDialogClickListener() {
+				@Override
+				public void onConfirm() {
+					ToastUtils.show("onConfirm");
+					// 处理确认逻辑（如允许后台网络使用）
+					LogUtils.d("MainActivity", "用户允许后台网络使用");
+					// 执行具体业务：如开启后台网络请求服务
+				}
+
+				@Override
+				public void onCancel() {
+					ToastUtils.show("onCancel");
+					// 处理取消逻辑（如禁止后台网络使用）
+					LogUtils.d("MainActivity", "用户禁止后台网络使用");
+					// 执行具体业务：如关闭后台网络请求
+				}
+			});
+
+		// 可选：修改对话框标题和内容（适配自定义场景）
+		dialog.setTitle("网络图片下载对话框");
+		dialog.setContent("是否下载地址中的图片资源，作为应用背景图片？");
+
+		// 显示对话框
+		dialog.show();
+
+	}
+
+    /**
+     * 重写finish方法，确保所有退出场景都触发Toast
+     */
+    @Override
+    public void finish() {
+        if (!isCommitSettings) {
+			YesNoAlertDialog.show(this, "应用背景更改提示：", "是否应用预览图片？", new YesNoAlertDialog.OnDialogResultListener(){
+
+					@Override
+					public void onNo() {
+						isCommitSettings = true;
+						finish();
+					}
+
+					@Override
+					public void onYes() {
+						bvPreviewBackground.saveToBackgroundSources(preViewFileBackgroundView);
+						isCommitSettings = true;
+						finish();
+					}
+				});
+		} else {
+			super.finish();
+		}
+    }
 }
 

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

@@ -0,0 +1,516 @@
+package cc.winboll.studio.powerbell.activities;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/10/22 13:21
+ * @Describe BatteryReportActivity
+ */
+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.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+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;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class BatteryReportActivity extends Activity {
+    public static final String TAG = "BatteryReportActivity";
+
+    private RecyclerView rvBatteryReport;
+    private BatteryReportAdapter adapter;
+    private List<AppBatteryModel> dataList = new ArrayList<AppBatteryModel>(); 
+    private List<AppBatteryModel> filteredList = new ArrayList<AppBatteryModel>(); 
+    private BroadcastReceiver batteryReceiver;
+    private int batteryCapacity = 5400; // 电池容量（mAh）
+    private float lastBatteryPercent = 100.0f;
+    private long lastCheckTime = System.currentTimeMillis();
+    private EditText etSearch;
+    private Map<String, Long> appRunTimeCache = new HashMap<String, Long>();
+    private Map<String, String> packageToAppNameCache = new HashMap<String, String>();
+    private PackageManager mPackageManager;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_battery_report);
+        mPackageManager = getPackageManager();
+
+        // 权限检查（Java7 传统条件判断）
+        if (!hasUsageStatsPermission(this)) {
+            Toast.makeText(this, "请进入设置-应用-权限-特殊访问权限-使用情况访问权限，开启本应用的权限", Toast.LENGTH_LONG).show();
+            startActivity(new Intent(Settings.ACTION_USAGE_ACCESS_SETTINGS));
+            return;
+        }
+
+        etSearch = (EditText) findViewById(R.id.et_search); 
+        rvBatteryReport = (RecyclerView) findViewById(R.id.rv_battery_report); 
+        rvBatteryReport.setLayoutManager(new LinearLayoutManager(this));
+
+        // 初始化流程：新增“加载24小时累计耗电”步骤
+        loadAllAppPackage();
+        preCacheAllAppNames();
+        appRunTimeCache = getAppRunTime();
+        updateAppRunTimeToModel();
+        calculateInitial24hTotalConsumption(); // 初始化时计算24小时累计耗电
+        filteredList.addAll(dataList);
+        adapter = new BatteryReportAdapter(this, filteredList, mPackageManager, packageToAppNameCache);
+        rvBatteryReport.setAdapter(adapter);
+
+        // 搜索监听（不变）
+        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) {
+					filterAppsByPackageAndName(s.toString());
+				}
+
+				@Override
+				public void afterTextChanged(Editable s) {}
+			});
+
+        // 电池广播：调用修改后的“单次耗电计算+累计累加”方法
+        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 + "%，时长：" + duration + "ms");
+                    appRunTimeCache = getAppRunTime();
+                    updateAppRunTimeToModel();
+                    calculateSingleConsumptionAndAccumulate(dropPercent, appRunTimeCache); // 单次+累计逻辑
+                }
+
+                lastBatteryPercent = currentPercent;
+                lastCheckTime = System.currentTimeMillis();
+            }
+        };
+        registerReceiver(batteryReceiver, new IntentFilter(Intent.ACTION_BATTERY_CHANGED));
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // Java7 显式非空判断
+        if (batteryReceiver != null) {
+            unregisterReceiver(batteryReceiver);
+        }
+    }
+
+    /**
+     * 加载所有应用（仅获取包名，初始化模型时单次耗电、累计耗电均设为0）
+     */
+    private void loadAllAppPackage() {
+        List<ApplicationInfo> appList = mPackageManager.getInstalledApplications(PackageManager.GET_META_DATA);
+        dataList.clear();
+
+        LogUtils.d(TAG, "开始加载应用包名列表，共找到" + appList.size() + "个应用");
+
+        for (ApplicationInfo appInfo : appList) {
+            String packageName = appInfo.packageName;
+            // 初始化：单次耗电（consumption）=0，累计耗电（totalConsumption）=0，运行时长=0
+            dataList.add(new AppBatteryModel(packageName, 0.0f, 0.0f, 0));
+        }
+
+        LogUtils.d(TAG, "应用包名列表加载完成，共添加" + dataList.size() + "个包名。");
+    }
+
+    /**
+     * 预缓存应用名称（逻辑不变）
+     */
+    private void preCacheAllAppNames() {
+        packageToAppNameCache.clear();
+        LogUtils.d(TAG, "开始预缓存包名-应用名称映射");
+
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            String appName = getAppNameByPackage(packageName);
+            packageToAppNameCache.put(packageName, appName);
+        }
+
+        LogUtils.d(TAG, "预缓存完成，共缓存" + packageToAppNameCache.size() + "个应用名称");
+    }
+
+    /**
+     * 通过包名获取应用名称（逻辑不变）
+     */
+    private String getAppNameByPackage(String packageName) {
+        try {
+            ApplicationInfo appInfo = mPackageManager.getApplicationInfo(packageName, 0);
+            return mPackageManager.getApplicationLabel(appInfo).toString();
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "包名" + packageName + "对应的应用未找到：" + e.getMessage());
+            return packageName;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "查询应用名称失败（包名：" + packageName + "）：" + e.getMessage());
+            return packageName;
+        }
+    }
+
+    /**
+     * 更新运行时长到模型（逻辑不变）
+     */
+    private void updateAppRunTimeToModel() {
+        int nCount = 0;
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long runTime;
+            if (appRunTimeCache.containsKey(packageName)) {
+                runTime = appRunTimeCache.get(packageName);
+                LogUtils.d(TAG, String.format("应用包 %s 运行时长已更新。", packageName));
+                nCount++;
+            } else {
+                runTime = 0L;
+            }
+            model.setRunTime(runTime);
+        }
+        LogUtils.d(TAG, String.format("dataList.size() %d， appRunTimeCache.size() %d。", dataList.size(), appRunTimeCache.size()));
+        LogUtils.d(TAG, String.format("updateAppRunTimeToModel() 更新的数据量为：%d", nCount));
+    }
+
+    /**
+     * 【新增】初始化时计算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, "24小时内所有应用总运行时长：" + formatRunTime(total24hRunTime));
+
+        // 2. 按运行时长占比分配24小时累计耗电（假设电池满电循环，用总容量近似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; // 用电池容量近似24小时总消耗
+            model.setTotalConsumption(initialTotalConsumption); // 初始化累计耗电
+            LogUtils.d(TAG, String.format("应用包 %s 24小时累计耗电初始化：%.1f mAh", packageName, initialTotalConsumption));
+        }
+    }
+
+    /**
+     * 【核心修改】计算单次耗电（赋值给consumption）+ 累加至累计耗电（totalConsumption = totalConsumption + consumption）
+     */
+    private void calculateSingleConsumptionAndAccumulate(float dropPercent, Map<String, Long> runTimeMap) {
+        long totalSingleRunTime = 0;
+        // 1. 计算本次电池下降期间的总运行时长
+        for (Map.Entry<String, Long> entry : runTimeMap.entrySet()) {
+            totalSingleRunTime += entry.getValue();
+        }
+
+        // 2. 遍历计算每个应用的“单次耗电”并“累加至累计”
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long appSingleRunTime = runTimeMap.getOrDefault(packageName, 0L);
+
+            // 步骤1：计算本次单次耗电（赋值给consumption）
+            float ratio = (totalSingleRunTime > 0) ? (float) appSingleRunTime / totalSingleRunTime : 0;
+            float singleConsumption = batteryCapacity * dropPercent / 100 * ratio; // 单次消耗
+            model.setConsumption(singleConsumption); // 存储单次耗电
+
+            // 步骤2：累加单次耗电到累计耗电（totalConsumption = 原有累计 + 本次单次）
+            float newTotalConsumption = model.getTotalConsumption() + singleConsumption;
+            model.setTotalConsumption(newTotalConsumption); // 更新累计耗电
+
+            // 同步运行时长
+            model.setRunTime(appSingleRunTime);
+
+            LogUtils.d(TAG, String.format("应用包 %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());
+    }
+
+    /**
+     * 双维度过滤（逻辑不变）
+     */
+    private void filterAppsByPackageAndName(String keyword) {
+        filteredList.clear();
+        if (keyword == null || keyword.isEmpty()) {
+            filteredList.addAll(dataList);
+        } 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);
+                }
+            }
+        }
+        adapter.notifyDataSetChanged();
+    }
+
+    /**
+     * 获取应用运行时长（逻辑不变，返回24小时运行时长）
+     */
+    private Map<String, Long> getAppRunTime() {
+        Map<String, Long> runTimeMap = new HashMap<String, Long>();
+        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 - 24 * 3600 * 1000; // 近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();
+                    LogUtils.d(TAG, "包名" + packageName + "24小时运行时长：" + formatRunTime(runTimeMs));
+                    runTimeMap.put(packageName, runTimeMs);
+                    if (packageName.equals("aidepro.top")) {
+                        LogUtils.d(TAG, String.format("runTimeMap.put(packageName, runTimeMs) 特殊查询 %s 查询有结果。", packageName));
+                    }
+                }
+            } catch (Exception e) {
+                LogUtils.e(TAG, "获取应用运行时长失败：" + e.getMessage());
+            }
+        }
+
+        LogUtils.d(TAG, String.format("应用运行时长列表数量%d。", runTimeMap.size()));
+        return runTimeMap;
+    }
+
+    /**
+     * 格式化运行时长（逻辑不变）
+     */
+    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);
+        }
+    }
+
+    /**
+     * 权限检查（逻辑不变）
+     */
+    private boolean hasUsageStatsPermission(Context context) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
+            return false;
+        }
+
+        android.app.usage.UsageStatsManager manager =
+            (android.app.usage.UsageStatsManager) context.getSystemService(Context.USAGE_STATS_SERVICE);
+        if (manager == null) {
+            return false;
+        }
+
+        long endTime = System.currentTimeMillis();
+        long startTime = endTime - 1000 * 60;
+        List<android.app.usage.UsageStats> statsList = manager.queryUsageStats(
+            android.app.usage.UsageStatsManager.INTERVAL_DAILY, startTime, endTime);
+
+        return statsList != null && !statsList.isEmpty();
+    }
+
+    /**
+     * 【核心修改】数据模型：明确字段含义
+     * - consumption：单次耗电（两次电池广播间的消耗，float类型便于计算）
+     * - totalConsumption：累计耗电（24小时初始化值+后续单次累加，显示用）
+     */
+    public static class AppBatteryModel {
+        private String packageName;    // 应用包名（核心标识）
+        private float consumption;     // 单次耗电（mAh，float类型）
+        private float totalConsumption;// 累计耗电（mAh，显示+排序用）
+        private long runTime;          // 运行时长（ms）
+
+		// Java7 显式构造：初始化单次耗电、累计耗电为0
+        public AppBatteryModel(String packageName, float consumption, float totalConsumption, long runTime) {
+            this.packageName = packageName;
+            this.consumption = consumption; // 单次耗电初始为0
+            this.totalConsumption = totalConsumption; // 累计耗电初始为0（后续初始化时赋值）
+            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 适配器：仅显示累计耗电（totalConsumption），逻辑适配模型修改
+     */
+    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;
+        }
+
+        @Override
+        public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+            // 加载系统列表项布局（text1显示应用名，text2显示累计耗电+时长）
+            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秒");
+                return;
+            }
+
+            AppBatteryModel model = mDataList.get(position);
+            String packageName = model.getPackageName();
+            String appName = "";
+
+            // 优先从缓存获取应用名：减少PackageManager调用，提升性能
+            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("Adapter", "包名" + packageName + "对应的应用未找到：" + e.getMessage());
+                } catch (Exception e) {
+                    appName = packageName; // 其他异常时用包名兜底
+                    LogUtils.e("Adapter", "查询应用名称失败（包名：" + packageName + "）：" + e.getMessage());
+                }
+            }
+
+            // 显示逻辑：仅展示累计耗电（totalConsumption），隐藏单次耗电
+            holder.tvAppName.setText(appName);
+            // 格式化运行时长 + 累计耗电（保留1位小数，提升可读性）
+            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);
+        }
+
+        // 获取列表长度：Java7 三元运算符判断空值，避免空指针
+        @Override
+        public int getItemCount() {
+            return mDataList == null ? 0 : mDataList.size();
+        }
+
+        /**
+         * ViewHolder：绑定系统布局控件，与显示逻辑对应
+         */
+        public static class ViewHolder extends RecyclerView.ViewHolder {
+            TextView tvAppName;     // 显示应用名称
+            TextView tvConsumption; // 显示累计耗电 + 运行时长
+
+            // Java7 显式构造：绑定控件ID（系统布局固定ID：text1、text2）
+            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/BatteryReporterActivity.java

@@ -1,51 +0,0 @@
-package cc.winboll.studio.powerbell.activities;
-
-/**
- * @Author ZhanGSKen<zhangsken@qq.com>
- * @Date 2025/03/22 14:20:15
- */
-import android.app.Activity;
-import android.os.Bundle;
-import androidx.recyclerview.widget.DividerItemDecoration;
-import androidx.recyclerview.widget.LinearLayoutManager;
-import androidx.recyclerview.widget.RecyclerView;
-import cc.winboll.studio.powerbell.R;
-import cc.winboll.studio.powerbell.adapters.BatteryAdapter;
-import cc.winboll.studio.powerbell.beans.BatteryData;
-import java.util.Arrays;
-import java.util.List;
-
-public class BatteryReporterActivity extends Activity {
-    public static final String TAG = "BatteryReporterActivity";
-
-    private RecyclerView rvBatteryReport;
-    private BatteryAdapter adapter;
-
-    @Override
-    protected void onCreate(Bundle savedInstanceState) {
-        super.onCreate(savedInstanceState);
-        setContentView(R.layout.activity_battery_reporter);
-
-        rvBatteryReport = findViewById(R.id.rvBatteryReport);
-        setupRecyclerView();
-        loadSampleData();
-    }
-
-    private void setupRecyclerView() {
-        adapter = new BatteryAdapter();
-        rvBatteryReport.setLayoutManager(new LinearLayoutManager(this));
-        rvBatteryReport.setAdapter(adapter);
-        rvBatteryReport.addItemDecoration(new DividerItemDecoration(this, DividerItemDecoration.VERTICAL));
-    }
-
-    private void loadSampleData() {
-        List<BatteryData> dataList = Arrays.asList(
-            new BatteryData(95, "01:23:45", "00:05:12"),
-            new BatteryData(80, "02:15:30", "00:10:00"),
-            new BatteryData(65, "03:45:15", "00:15:30"),
-            new BatteryData(50, "05:00:00", "00:20:45")
-        );
-        adapter.updateData(dataList);
-    }
-}
-

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

@@ -4,11 +4,12 @@ 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 cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
 import cc.winboll.studio.libaes.views.AToolbar;
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.utils.ToastUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
 import cc.winboll.studio.powerbell.App;
 import cc.winboll.studio.powerbell.R;
 import cc.winboll.studio.powerbell.beans.BatteryInfoBean;
@@ -16,7 +17,6 @@ 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;
-import android.widget.Switch;
 
 public class ClearRecordActivity extends Activity {
 

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

@@ -6,6 +6,7 @@ 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;
@@ -19,11 +20,11 @@ import android.widget.ImageView;
 import android.widget.RelativeLayout;
 import android.widget.TextView;
 import android.widget.Toast;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
 import cc.winboll.studio.libaes.views.AToolbar;
 import cc.winboll.studio.libappbase.GlobalApplication;
-import cc.winboll.studio.libappbase.winboll.IWinBoLLActivity;
-import cc.winboll.studio.powerbell.MainActivity;
 import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.activities.BackgroundPictureActivity;
 import cc.winboll.studio.powerbell.activities.PixelPickerActivity;
 import cc.winboll.studio.powerbell.beans.BackgroundPictureBean;
 import cc.winboll.studio.powerbell.utils.BackgroundPictureUtils;
@@ -233,7 +234,10 @@ public class PixelPickerActivity extends WinBoLLActivity implements IWinBoLLActi
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         if (item.getItemId() == android.R.id.home) {
-            GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), BackgroundPictureActivity.class);
+			Intent intent = new Intent();
+            intent.setClass(this, BackgroundPictureActivity.class);
+            startActivity(intent);
+            //GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), );
             return true;
         }
         // 在switch语句中处理每个ID，并在处理完后返回true，未处理的情况返回false。
@@ -243,7 +247,10 @@ public class PixelPickerActivity extends WinBoLLActivity implements IWinBoLLActi
 	@Override
 	public void onBackPressed() {
 		super.onBackPressed();
-		GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), BackgroundPictureActivity.class);
+		Intent intent = new Intent();
+		intent.setClass(this, BackgroundPictureActivity.class);
+		startActivity(intent);
+		//GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), BackgroundPictureActivity.class);
 	}
 }
 

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

@@ -0,0 +1,21 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.os.Bundle;
+import cc.winboll.studio.powerbell.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 14:26
+ * @Describe 应用设置窗口
+ */
+public class SettingsActivity extends Activity {
+    
+    public static final String TAG = "SettingsActivity";
+    
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_settings);
+    }
+}

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

@@ -0,0 +1,49 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.utils.APPPlusUtils;
+import cc.winboll.studio.powerbell.App;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/15 13:45
+ * @Describe 应用快捷方式活动类
+ */
+public class ShortcutActionActivity extends Activity {
+
+    public static final String TAG = "ShortcutActionActivity";
+
+	@Override
+	protected void onCreate(Bundle savedInstanceState) {
+		super.onCreate(savedInstanceState);
+		// 处理应用级别的切换请求
+        handleSwitchRequest();
+		finish();
+	}
+
+	/**
+     * 处理应用图标快捷菜单的请求
+     */
+    private void handleSwitchRequest() {
+        Intent intent = getIntent();
+        if (intent != null && "switchto_en1".equals(intent.getDataString())) {
+			APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_EN1);
+            ToastUtils.show("切换至" + getString(R.string.app_name) + "图标");
+			//moveTaskToBack(true);
+        }
+		if (intent != null && "switchto_cn1".equals(intent.getDataString())) {
+			APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN1);
+            ToastUtils.show("切换至" + getString(R.string.app_name_cn1) + "图标");
+			//moveTaskToBack(true);
+        }
+		if (intent != null && "switchto_cn2".equals(intent.getDataString())) {
+			APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN2);
+            ToastUtils.show("切换至" + getString(R.string.app_name_cn2) + "图标");
+			//moveTaskToBack(true);
+        }
+    }
+}

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

@@ -5,40 +5,93 @@ package cc.winboll.studio.powerbell.activities;
  * @Date 2025/06/19 20:35
  * @Describe 应用窗口基类
  */
+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 cc.winboll.studio.libappbase.GlobalApplication;
-import cc.winboll.studio.libappbase.winboll.IWinBoLLActivity;
-import cc.winboll.studio.powerbell.App;
-import cc.winboll.studio.powerbell.MainActivity;
+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.powerbell.BuildConfig;
 import cc.winboll.studio.powerbell.R;
 
-public abstract class WinBoLLActivity extends Activity implements IWinBoLLActivity {
+@SuppressLint("SetTextI18n")
+public abstract class WinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
 
     public static final String TAG = "WinBoLLActivity";
-
+	
+	protected TextView mTagView;
+	
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
+		changeFullScreen(this);
+    }
+	
+
+    @Override
+    protected void onStart() {
+        super.onStart();
+        addVersionNameToContentView();
+    }
+
+    protected void addVersionNameToContentView() {
+        if (!isTagViewVisible()) {
+            return;
+        }
+        if (mTagView == null) {
+            mTagView = new TextView(this);
+            mTagView.setTextColor(Color.GRAY);
+            mTagView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 10);
+            mTagView.setText("MIMO SDK V" + 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);
+            frameLayout.addView(mTagView, params);
+        }
+    }
+
+    protected boolean isTagViewVisible() {
+        return true;
+    }
+
+    public void setupToolbar() {
+        Toolbar mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar != null) {
+            setSupportActionBar(mToolbar);
+            if (getSupportActionBar() != null) {
+                getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+            }
+        }
     }
 
     @Override
     protected void onPostCreate(Bundle savedInstanceState) {
         super.onPostCreate(savedInstanceState);
-        GlobalApplication.getWinBoLLActivityManager().add(this);
+        //GlobalApplication.getWinBoLLActivityManager().add(this);
     }
 
     @Override
     protected void onDestroy() {
         super.onDestroy();
-        GlobalApplication.getWinBoLLActivityManager().registeRemove(this);
+        //GlobalApplication.getWinBoLLActivityManager().registeRemove(this);
     }
 
     @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         if (item.getItemId() == android.R.id.home) {
-            GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), MainActivity.class);
+            //GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), MainActivity.class);
             return true;
         }
         // 在switch语句中处理每个ID，并在处理完后返回true，未处理的情况返回false。
@@ -48,6 +101,25 @@ public abstract class WinBoLLActivity extends Activity implements IWinBoLLActivi
 	@Override
 	public void onBackPressed() {
 		super.onBackPressed();
-		GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), MainActivity.class);
+		//GlobalApplication.getWinBoLLActivityManager().startWinBoLLActivity(getApplicationContext(), MainActivity.class);
 	}
+	
+	public void changeFullScreen(Activity activity) {
+        Window window =  activity.getWindow();
+        if (window == null){
+            return;
+        }
+        View decorView = window.getDecorView();
+        if (decorView == null){
+            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);
+    }
 }

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

@@ -0,0 +1,291 @@
+package cc.winboll.studio.powerbell.dialogs;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.os.Handler;
+import android.os.Message;
+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.PictureUtils;
+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
+ */
+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;
+
+    // 控件引用
+    private TextView tvTitle;
+    private TextView tvContent;
+    private Button btnCancel;
+    private Button btnConfirm;
+    private Button btnPreview;
+    private EditText etURL;
+    BackgroundView bvBackgroundPreview;
+    Context mContext;
+    // 主线程 Handler，用于接收子线程消息并更新 UI
+    private Handler mUiHandler;
+	String previewFilePath;
+
+    // 按钮点击回调接口（Java7 接口实现）
+    public interface OnDialogClickListener {
+        void onConfirm(); // 确认按钮点击
+        void onCancel();  // 取消按钮点击
+    }
+
+    private OnDialogClickListener listener;
+
+    // Java7 显式构造（必须传入 Context）
+    public NetworkBackgroundDialog(@NonNull Context context) {
+        super(context);
+        initHandler(); // 初始化 Handler
+        initView(); // 初始化布局和控件
+        setDismissListener(); // 设置对话框消失监听
+    }
+
+    // 带回调的构造（便于外部处理点击事件）
+    public NetworkBackgroundDialog(@NonNull Context context, OnDialogClickListener listener) {
+        super(context);
+        this.listener = listener;
+        initHandler(); // 初始化 Handler
+        initView();
+        setDismissListener(); // 设置对话框消失监听
+    }
+
+    /**
+     * 初始化主线程 Handler，用于更新 UI
+     */
+    private void initHandler() {
+        mUiHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                // 对话框已消失时，不再处理 UI 消息
+                if (!isShowing()) {
+                    return;
+                }
+                switch (msg.what) {
+                    case MSG_IMAGE_LOAD_SUCCESS:
+                        // 图片加载成功，获取文件路径并设置背景
+                        String filePath = (String) msg.obj;
+                        setBackgroundFromPath(filePath);
+                        break;
+                    case MSG_IMAGE_LOAD_FAILED:
+                        // 图片加载失败，设置默认背景
+                        bvBackgroundPreview.setBackgroundResource(R.drawable.ic_launcher);
+                        ToastUtils.show("图片预览失败，请检查链接");
+                        break;
+                }
+            }
+        };
+    }
+
+    /**
+     * 设置对话框消失监听：移除 Handler 消息，避免内存泄漏
+     */
+    private void setDismissListener() {
+        this.setOnDismissListener(new OnDismissListener() {
+				@Override
+				public void onDismiss(DialogInterface dialog) {
+					// 对话框消失时，移除所有未处理的消息和回调
+					if (mUiHandler != null) {
+						mUiHandler.removeCallbacksAndMessages(null);
+					}
+					LogUtils.d(TAG, "对话框已消失，Handler 消息已清理");
+				}
+			});
+    }
+
+    /**
+     * 初始化布局和控件
+     */
+    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);
+        bvBackgroundPreview = (BackgroundView) dialogView.findViewById(R.id.bv_background_preview);
+
+        // 设置按钮点击事件
+        setButtonClickListeners();
+    }
+
+    /**
+     * 设置按钮点击监听
+     */
+    private void setButtonClickListeners() {
+        // 取消按钮：关闭对话框 + 回调外部
+        btnCancel.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d("NetworkBackgroundDialog", "取消按钮点击");
+					dismiss(); // 关闭对话框
+					if (listener != null) {
+						listener.onCancel();
+					}
+				}
+			});
+
+        // 确认按钮：关闭对话框 + 回调外部
+        btnConfirm.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d("NetworkBackgroundDialog", "确认按钮点击");
+					// 确定预览背景资源
+					bvBackgroundPreview.saveToBackgroundSources(previewFilePath);
+
+					dismiss(); // 关闭对话框
+					if (listener != null) {
+						listener.onConfirm();
+					}
+				}
+			});
+
+        // 图片预览按钮：预览输入框地址图片
+        btnPreview.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d("NetworkBackgroundDialog", "确认预览点击");
+					downloadImageToAlbumAndPreview();
+					/*String url = etURL.getText().toString().trim();
+					 if (url.isEmpty()) {
+					 ToastUtils.show("请输入图片链接");
+					 return;
+					 }
+					 ImageDownloader.getInstance(mContext).downloadImage(url, mDownloadCallback);*/
+				}
+			});
+    }
+
+    /**
+     * 根据文件路径设置 BackgroundView 背景（主线程调用）
+     * @param filePath 图片文件路径
+     */
+    private void setBackgroundFromPath(String filePath) {
+        FileInputStream fis = null;
+        try {
+            File imageFile = new File(filePath);
+            if (!imageFile.exists()) {
+                LogUtils.e(TAG, "图片文件不存在：" + filePath);
+				ToastUtils.show("Test");
+                //bvBackgroundPreview.setBackgroundResource(R.drawable.ic_launcher);
+                return;
+            }
+
+			// 预览背景
+			previewFilePath = filePath;
+            bvBackgroundPreview.previewBackgroundImage(previewFilePath);
+
+            LogUtils.d(TAG, "图片预览成功：" + filePath);
+
+        } catch (Exception e) {
+            e.printStackTrace();
+            bvBackgroundPreview.setBackgroundResource(R.drawable.ic_launcher);
+            LogUtils.e(TAG, "图片预览失败：" + e.getMessage());
+        } finally {
+            // Java7 手动关闭流，避免资源泄漏
+            if (fis != null) {
+                try {
+                    fis.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+    }
+
+    /**
+     * 对外提供方法：修改对话框标题（灵活适配不同场景）
+     */
+    public void setTitle(String title) {
+        if (tvTitle != null) {
+            tvTitle.setText(title);
+        }
+    }
+
+    /**
+     * 对外提供方法：修改对话框内容（灵活适配不同场景）
+     */
+    public void setContent(String content) {
+        if (tvContent != null) {
+            tvContent.setText(content);
+        }
+    }
+
+    /**
+     * 对外提供方法：设置按钮点击回调（替代带参构造）
+     */
+    public void setOnDialogClickListener(OnDialogClickListener listener) {
+        this.listener = listener;
+    }
+
+    /*ImageDownloader.DownloadCallback mDownloadCallback = new ImageDownloader.DownloadCallback() {
+	 @Override
+	 public void onSuccess(String filePath) {
+	 ToastUtils.show("图片下载成功：" + filePath);
+	 LogUtils.d(TAG, filePath);
+	 // 发送消息到主线程，携带图片路径
+	 Message successMsg = mUiHandler.obtainMessage(MSG_IMAGE_LOAD_SUCCESS, filePath);
+	 mUiHandler.sendMessage(successMsg);
+	 }
+
+	 @Override
+	 public void onFailure(String errorMsg) {
+	 ToastUtils.show("下载失败：" + errorMsg);
+	 LogUtils.e(TAG, errorMsg);
+	 // 发送图片加载失败消息
+	 mUiHandler.sendEmptyMessage(MSG_IMAGE_LOAD_FAILED);
+	 }
+	 };*/
+
+	void downloadImageToAlbumAndPreview() {
+		//String imgUrl = "https://example.com/test.jpg";
+		String imgUrl = etURL.getText().toString();
+		PictureUtils.downloadImageToAlbum(mContext, imgUrl, new PictureUtils.DownloadCallback(){
+				@Override
+				public void onSuccess(String savePath) {
+					ToastUtils.show("下载成功：" + savePath);
+					// 发送消息到主线程，携带图片路径
+					Message successMsg = mUiHandler.obtainMessage(MSG_IMAGE_LOAD_SUCCESS, savePath);
+					mUiHandler.sendMessage(successMsg);
+				}
+
+				@Override
+				public void onFailure(Exception e) {
+					ToastUtils.show("下载失败：" + e.getMessage());
+				}
+			});
+
+	}
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/fragments/MainViewFragment.java

@@ -9,7 +9,6 @@ import android.os.Message;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.ViewGroup;
-import android.view.ViewTreeObserver;
 import android.widget.CheckBox;
 import android.widget.CompoundButton;
 import android.widget.ImageView;
@@ -20,15 +19,15 @@ import android.widget.TextView;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.powerbell.App;
 import cc.winboll.studio.powerbell.R;
-import cc.winboll.studio.powerbell.activities.BackgroundPictureActivity;
+import cc.winboll.studio.powerbell.activities.PixelPickerActivity;
 import cc.winboll.studio.powerbell.beans.BackgroundPictureBean;
 import cc.winboll.studio.powerbell.services.ControlCenterService;
 import cc.winboll.studio.powerbell.utils.AppConfigUtils;
 import cc.winboll.studio.powerbell.utils.BackgroundPictureUtils;
 import cc.winboll.studio.powerbell.utils.ServiceUtils;
+import cc.winboll.studio.powerbell.views.BackgroundView;
 import cc.winboll.studio.powerbell.views.BatteryDrawable;
 import cc.winboll.studio.powerbell.views.VerticalSeekBar;
-import java.io.File;
 
 public class MainViewFragment extends Fragment {
 
@@ -72,6 +71,7 @@ public class MainViewFragment extends Fragment {
     TextView mtvUsegeReminderValue;
     CheckBox mcbUsegeReminderValue;
     TextView mtvCurrentValue;
+	BackgroundView bvPreviewBackground;
 
 
     @Override
@@ -79,27 +79,33 @@ public class MainViewFragment extends Fragment {
         mView = inflater.inflate(R.layout.fragment_mainview, container, false);
         _mMainViewFragment = MainViewFragment.this;
         mAppConfigUtils = App.getAppConfigUtils(getActivity());
-        
+
         // 获取指定ID的View实例
-        final View mainImageView = mView.findViewById(R.id.fragmentmainviewImageView1);
+	    bvPreviewBackground = mView.findViewById(R.id.fragmentmainviewBackgroundView1);
+		
+		BackgroundPictureUtils utils = BackgroundPictureUtils.getInstance(getActivity());
+		BackgroundPictureBean bean = utils.getBackgroundPictureBean();
+		int nPixelColor = bean.getPixelColor();
+		bvPreviewBackground.setBackgroundColor(nPixelColor);
+        /*final View mainImageView = mView.findViewById(R.id.fragmentmainviewImageView1);
 
-        // 注册OnGlobalLayoutListener
-        mainImageView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
-                @Override
-                public void onGlobalLayout() {
-                    // 获取宽度和高度
-                    int width = mainImageView.getMeasuredWidth();
-                    int height = mainImageView.getMeasuredHeight();
+		 // 注册OnGlobalLayoutListener
+		 mainImageView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
+		 @Override
+		 public void onGlobalLayout() {
+		 // 获取宽度和高度
+		 int width = mainImageView.getMeasuredWidth();
+		 int height = mainImageView.getMeasuredHeight();
 
-                    BackgroundPictureUtils utils = BackgroundPictureUtils.getInstance(getActivity());
-                    BackgroundPictureBean bean = utils.loadBackgroundPictureBean();
-                    bean.setBackgroundWidth(width);
-                    bean.setBackgroundHeight(height);
-                    utils.saveData();
-                    // 移除监听器以避免内存泄漏
-                    mainImageView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
-                }
-            });
+		 BackgroundPictureUtils utils = BackgroundPictureUtils.getInstance(getActivity());
+		 BackgroundPictureBean bean = utils.loadBackgroundPictureBean();
+		 bean.setBackgroundWidth(width);
+		 bean.setBackgroundHeight(height);
+		 utils.saveData();
+		 // 移除监听器以避免内存泄漏
+		 mainImageView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
+		 }
+		 });*/
 
         mDrawableFrame = getActivity().getDrawable(R.drawable.bg_frame);
         mllLeftSeekBar = (LinearLayout) mView.findViewById(R.id.fragmentmainviewLinearLayout1);
@@ -143,6 +149,17 @@ public class MainViewFragment extends Fragment {
         return mView;
     }
 
+	@Override
+	public void onResume() {
+		super.onResume();
+		BackgroundPictureUtils utils = BackgroundPictureUtils.getInstance(getActivity());
+		BackgroundPictureBean bean = utils.getBackgroundPictureBean();
+		int nPixelColor = bean.getPixelColor();
+		bvPreviewBackground.setBackgroundColor(nPixelColor);
+	}
+	
+	
+
     void setViewData() {
         int nChargeReminderValue = mAppConfigUtils.getChargeReminderValue();
         int nUsegeReminderValue = mAppConfigUtils.getUsegeReminderValue();
@@ -302,22 +319,23 @@ public class MainViewFragment extends Fragment {
         }
     }
 
-    public void loadBackground() {
-        BackgroundPictureBean bean = BackgroundPictureUtils.getInstance(getActivity()).getBackgroundPictureBean();
-        ImageView imageView = mView.findViewById(R.id.fragmentmainviewImageView1);
-        String szBackgroundFilePath = BackgroundPictureUtils.getInstance(getActivity()).getBackgroundDir() + BackgroundPictureActivity.getBackgroundFileName();
-        File fBackgroundFilePath = new File(szBackgroundFilePath);
-        LogUtils.d(TAG, "szBackgroundFilePath : " + szBackgroundFilePath);
-        LogUtils.d(TAG, String.format("fBackgroundFilePath.exists() %s", fBackgroundFilePath.exists()));
-        if (bean.isUseBackgroundFile() && fBackgroundFilePath.exists()) {
-            Drawable drawableBackground = Drawable.createFromPath(szBackgroundFilePath);
-            //drawableBackground.setAlpha(120);
-            imageView.setImageDrawable(drawableBackground);
-        } else {
-            Drawable drawableBackground = getActivity().getDrawable(R.drawable.blank10x10);
-            //drawableBackground.setAlpha(120);
-            imageView.setImageDrawable(drawableBackground);
-        }
+    public void reloadBackground() {
+		bvPreviewBackground.reloadBackgroundImage();
+//        BackgroundPictureBean bean = BackgroundPictureUtils.getInstance(getActivity()).getBackgroundPictureBean();
+//        ImageView imageView = mView.findViewById(R.id.fragmentmainviewImageView1);
+//        String szBackgroundFilePath = BackgroundPictureUtils.getInstance(getActivity()).getBackgroundDir() + BackgroundPictureActivity.getBackgroundFileName();
+//        File fBackgroundFilePath = new File(szBackgroundFilePath);
+//        LogUtils.d(TAG, "szBackgroundFilePath : " + szBackgroundFilePath);
+//        LogUtils.d(TAG, String.format("fBackgroundFilePath.exists() %s", fBackgroundFilePath.exists()));
+//        if (bean.isUseBackgroundFile() && fBackgroundFilePath.exists()) {
+//            Drawable drawableBackground = Drawable.createFromPath(szBackgroundFilePath);
+//            //drawableBackground.setAlpha(120);
+//            imageView.setImageDrawable(drawableBackground);
+//        } else {
+//            Drawable drawableBackground = getActivity().getDrawable(R.drawable.blank10x10);
+//            //drawableBackground.setAlpha(120);
+//            imageView.setImageDrawable(drawableBackground);
+//        }
     }
 
     Handler mHandler = new Handler(){

powerbell/src/main/java/cc/winboll/studio/powerbell/services/ControlCenterService.java

@@ -14,10 +14,12 @@ import android.content.ComponentName;
 import android.content.Context;
 import android.content.Intent;
 import android.content.ServiceConnection;
+import android.os.Handler;
 import android.os.IBinder;
+import android.os.Looper;
 import android.widget.RemoteViews;
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.utils.ToastUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
 import cc.winboll.studio.powerbell.App;
 import cc.winboll.studio.powerbell.MainActivity;
 import cc.winboll.studio.powerbell.R;
@@ -32,8 +34,6 @@ import cc.winboll.studio.powerbell.utils.AppConfigUtils;
 import cc.winboll.studio.powerbell.utils.NotificationHelper;
 import cc.winboll.studio.powerbell.utils.ServiceUtils;
 import cc.winboll.studio.powerbell.utils.StringUtils;
-import android.os.Handler;
-import android.os.Looper;
 
 public class ControlCenterService extends Service {
 
@@ -73,8 +73,8 @@ public class ControlCenterService extends Service {
         mAppConfigUtils = App.getAppConfigUtils(this);
         mAppCacheUtils = App.getAppCacheUtils(this);
         mNotificationHelper = new NotificationHelper(ControlCenterService.this);
-        
-        
+
+
         if (mMyServiceConnection == null) {
             mMyServiceConnection = new MyServiceConnection();
         }
@@ -105,7 +105,7 @@ public class ControlCenterService extends Service {
             Intent intent = new Intent(this, MainActivity.class);
             notification = helper.showForegroundNotification(intent, getString(R.string.app_name), "Service Running, Click to open app");
             startForeground(NotificationHelper.FOREGROUND_NOTIFICATION_ID, notification);
-            
+
 //            NotificationMessage notificationMessage=createNotificationMessage();
 //            //Toast.makeText(getApplication(), "", Toast.LENGTH_SHORT).show();
 //            mNotificationUtils.createForegroundNotification(this, notificationMessage);
@@ -116,7 +116,7 @@ public class ControlCenterService extends Service {
                 mControlCenterServiceReceiver = new ControlCenterServiceReceiver(this);
                 mControlCenterServiceReceiver.registerAction(this);
             }
-            
+
             new Handler(Looper.getMainLooper()).postDelayed(new Runnable(){
 
                     @Override
@@ -126,7 +126,7 @@ public class ControlCenterService extends Service {
                         LogUtils.i(TAG, "Service Is Start.");
                     }
                 }, 2000);
-            
+
         }
     }
 
@@ -263,15 +263,15 @@ public class ControlCenterService extends Service {
         NotificationHelper helper = new NotificationHelper(ControlCenterService.this);
         Intent intent = new Intent(ControlCenterService.this, MainActivity.class);
         helper.showTemporaryNotification(intent, getString(R.string.app_name), msg);
-        
-        
-        
+
+
+
 //        NotificationMessage notificationMessage = createNotificationMessage();
 //        notificationMessage.setRemindMSG(szRemindMSG);
 //        //LogUtils.d(TAG, "notificationMessage : " + notificationMessage.getRemindMSG());
 //        updateRemindNotification(notificationMessage);
     }
-    
+
     // 设置颜色背景
     public static RemoteViews setLinearLayoutColor(RemoteViews remoteViews, int viewId, int color) {
         remoteViews.setInt(viewId, "setBackgroundColor", color);

powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/BackgroundViewTestFragment.java

@@ -0,0 +1,48 @@
+package cc.winboll.studio.powerbell.unittest;
+
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import androidx.fragment.app.Fragment;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import android.widget.Button;
+import cc.winboll.studio.powerbell.MainActivity;
+import android.content.Intent;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/19 18:16
+ * @Describe BackgroundViewTestFragment
+ */
+public class BackgroundViewTestFragment extends Fragment {
+
+    public static final String TAG = "BackgroundViewTestFragment";
+
+	View mainView;
+
+	@Override
+	public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+		//super.onCreateView(inflater, container, savedInstanceState);
+
+		// 非调试状态就结束本线程
+		if (!GlobalApplication.isDebugging()) {
+			Thread.currentThread().destroy();
+		}
+
+		mainView = inflater.inflate(R.layout.fragment_test_backgroundview, container, false);
+		
+		((Button)mainView.findViewById(R.id.btn_main_activity)).setOnClickListener(new View.OnClickListener(){
+
+				@Override
+				public void onClick(View v) {
+					getActivity().startActivity(new Intent(getActivity(), MainActivity.class));
+				}
+			});
+
+		ToastUtils.show(String.format("%s onCreate", TAG));
+		return mainView;
+	}
+}

powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/MainUnitTestActivity.java

@@ -0,0 +1,39 @@
+package cc.winboll.studio.powerbell.unittest;
+
+import android.os.Bundle;
+import android.widget.FrameLayout;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.powerbell.R;
+import androidx.fragment.app.FragmentManager;
+import androidx.fragment.app.FragmentTransaction;
+import android.nfc.tech.TagTechnology;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/19 18:04
+ * @Describe 单元测试启动主页窗口
+ */
+public class MainUnitTestActivity extends AppCompatActivity {
+
+    public static final String TAG = "MainUnitTestActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+		// 非调试状态就退出
+		if (!GlobalApplication.isDebugging()) {
+			finish();
+		}
+        setContentView(R.layout.activity_mainunittest);
+		
+		FragmentManager fragmentManager = getSupportFragmentManager();
+		FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
+		fragmentTransaction.add(R.id.activitymainunittestFrameLayout1, new BackgroundViewTestFragment(), BackgroundViewTestFragment.TAG);
+		fragmentTransaction.commit();
+		
+		ToastUtils.show(String.format("%s onCreate", TAG));
+    }
+
+}

powerbell/src/main/java/cc/winboll/studio/powerbell/utils/APPPlusUtils.java

@@ -0,0 +1,164 @@
+package cc.winboll.studio.powerbell.utils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/26 15:54
+ * @Describe 应用图标切换工具类（启用组件时创建对应快捷方式）
+ */
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Build;
+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;
+
+public class APPPlusUtils {
+    public static final String TAG = "APPPlusUtils";
+
+    // 快捷方式配置（名称+图标，需与实际资源匹配）
+//    private static final String PLUS_SHORTCUT_NAME = "位置服务-Laojun";
+//    private static final int PLUS_SHORTCUT_ICON = R.mipmap.ic_launcher; // Laojun 图标资源
+
+    /**
+     * 添加Plus组件与图标
+     */
+    public static boolean switchAppLauncherToComponent(Context context, String componentName) {
+        if (context == null) {
+            LogUtils.d(TAG, "切换失败：上下文为空");
+            Toast.makeText(context, context.getString(R.string.app_name) + "图标切换失败", Toast.LENGTH_SHORT).show();
+            return false;
+        }
+
+        PackageManager pm = context.getPackageManager();
+		
+        ComponentName plusComponentSwitchTo = new ComponentName(context, componentName);
+        ComponentName plusComponentEN1 = new ComponentName(context, App.COMPONENT_EN1);
+        ComponentName plusComponentCN1 = new ComponentName(context, App.COMPONENT_CN1);
+        ComponentName plusComponentCN2 = new ComponentName(context, App.COMPONENT_CN2);
+
+        try {
+			disableComponent(pm, plusComponentEN1);
+			disableComponent(pm, plusComponentCN1);
+			disableComponent(pm, plusComponentCN2);
+            enableComponent(pm, plusComponentSwitchTo);
+
+            return true;
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "图标切换失败：" + e.getMessage());
+            Toast.makeText(context, context.getString(R.string.app_name) + "图标切换失败" + e.getMessage(), Toast.LENGTH_SHORT).show();
+            return false;
+        }
+    }
+
+    /**
+     * 创建指定组件的桌面快捷方式（自动去重，兼容 Android 8.0+）
+     * @param component 目标组件（如 LAOJUN_ACTIVITY）
+     * @param name 快捷方式名称
+     * @param iconRes 快捷方式图标资源ID
+     * @return 是否创建成功
+     */
+    private static boolean createComponentShortcut(Context context, ComponentName component, String name, int iconRes) {
+        if (context == null || component == null || name == null || iconRes == 0) {
+            LogUtils.d(TAG, "快捷方式创建失败：参数为空");
+            return false;
+        }
+
+        // Android 8.0+（API 26+）：使用 ShortcutManager（系统推荐）
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            try {
+                PackageManager pm = context.getPackageManager();
+                android.content.pm.ShortcutManager shortcutManager = context.getSystemService(android.content.pm.ShortcutManager.class);
+                if (shortcutManager == null || !shortcutManager.isRequestPinShortcutSupported()) {
+                    LogUtils.d(TAG, "系统不支持创建快捷方式");
+                    return false;
+                }
+
+                // 检查是否已存在该组件的快捷方式（去重）
+                for (android.content.pm.ShortcutInfo info : shortcutManager.getPinnedShortcuts()) {
+                    if (component.getClassName().equals(info.getIntent().getComponent().getClassName())) {
+                        LogUtils.d(TAG, "快捷方式已存在：" + component.getClassName());
+                        return true;
+                    }
+                }
+
+                // 构建启动目标组件的意图
+                Intent launchIntent = new Intent(Intent.ACTION_MAIN)
+					.setComponent(component)
+					.addCategory(Intent.CATEGORY_LAUNCHER)
+					.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+                // 构建快捷方式信息
+                android.content.pm.ShortcutInfo shortcutInfo = new android.content.pm.ShortcutInfo.Builder(context, component.getClassName())
+					.setShortLabel(name)
+					.setLongLabel(name)
+					.setIcon(android.graphics.drawable.Icon.createWithResource(context, iconRes))
+					.setIntent(launchIntent)
+					.build();
+
+                // 请求创建快捷方式（需用户确认）
+                shortcutManager.requestPinShortcut(shortcutInfo, null);
+                return true;
+
+            } catch (Exception e) {
+                LogUtils.d(TAG, "Android O+ 快捷方式创建失败：" + e.getMessage());
+                return false;
+            }
+        } else {
+            // Android 8.0 以下：使用广播（兼容旧机型）
+            try {
+                // 构建启动目标组件的意图
+                Intent launchIntent = new Intent(Intent.ACTION_MAIN)
+					.setComponent(component)
+					.addCategory(Intent.CATEGORY_LAUNCHER)
+					.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+                // 构建创建快捷方式的广播意图
+                Intent installIntent = new Intent("com.android.launcher.action.INSTALL_SHORTCUT");
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, launchIntent);
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
+									   Intent.ShortcutIconResource.fromContext(context, iconRes));
+                installIntent.putExtra("duplicate", false); // 禁止重复创建
+
+                context.sendBroadcast(installIntent);
+                return true;
+
+            } catch (Exception e) {
+                LogUtils.d(TAG, "Android O- 快捷方式创建失败：" + e.getMessage());
+                return false;
+            }
+        }
+    }
+
+    /**
+     * 启用组件（带状态检查，避免重复操作）
+     */
+    private static void enableComponent(PackageManager pm, ComponentName component) {
+        if (pm.getComponentEnabledSetting(component) != PackageManager.COMPONENT_ENABLED_STATE_ENABLED) {
+            pm.setComponentEnabledSetting(
+				component,
+				PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
+				PackageManager.DONT_KILL_APP | PackageManager.SYNCHRONOUS
+            );
+        }
+    }
+
+    /**
+     * 禁用组件（带状态检查，避免重复操作）
+     */
+    private static void disableComponent(PackageManager pm, ComponentName component) {
+        if (pm.getComponentEnabledSetting(component) != PackageManager.COMPONENT_ENABLED_STATE_DISABLED) {
+            pm.setComponentEnabledSetting(
+				component,
+				PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
+				PackageManager.DONT_KILL_APP | PackageManager.SYNCHRONOUS
+            );
+        }
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageDownloader.java

@@ -0,0 +1,294 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.os.Environment;
+import android.text.TextUtils;
+import android.util.Log;
+import cc.winboll.studio.libappbase.LogUtils;
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.util.UUID;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/19 20:52
+ * @Describe 图片下载工具类（单例模式）
+ * 功能：下载网络图片到缓存目录、清理过期文件、获取最新下载文件
+ */
+public class ImageDownloader {
+	public static final String TAG = "ImageDownloader";
+	// 单例实例
+	private static ImageDownloader sInstance;
+	// OkHttp 客户端（全局复用，提升性能）
+	private OkHttpClient mOkHttpClient;
+	// 缓存目录：/data/data/应用包名/cache/networkdownload
+	private File mCacheDir;
+	// 过期时间：7天（单位：毫秒），可按需调整
+	private static final long EXPIRE_TIME = 7 * 24 * 3600 * 1000;
+
+	/**
+	 * 私有构造（单例模式禁止外部实例化）
+	 * @param context 上下文（用于获取缓存目录）
+	 */
+	private ImageDownloader(Context context) {
+		// 初始化 OkHttp 客户端（设置超时时间）
+		mOkHttpClient = new OkHttpClient.Builder()
+			.connectTimeout(10, TimeUnit.SECONDS)
+			.readTimeout(15, TimeUnit.SECONDS)
+			.writeTimeout(15, TimeUnit.SECONDS)
+			.build();
+
+		// 初始化缓存目录：networkdownload
+		initCacheDir(context);
+		// 初始化时清理过期文件
+		clearExpiredFiles();
+	}
+
+	/**
+	 * 单例获取方法（线程安全）
+	 * @param context 上下文（建议使用 Application 上下文避免内存泄漏）
+	 * @return 单例实例
+	 */
+	public static synchronized ImageDownloader getInstance(Context context) {
+		if (sInstance == null) {
+			// 使用 Application 上下文，防止 Activity 销毁导致的内存泄漏
+			sInstance = new ImageDownloader(context.getApplicationContext());
+		}
+		return sInstance;
+	}
+
+	/**
+	 * 初始化缓存目录：若不存在则创建
+	 */
+	private void initCacheDir(Context context) {
+		// 获取应用内置缓存目录（无需权限）
+		File cacheRoot = context.getCacheDir();
+		mCacheDir = new File(cacheRoot, "networkdownload");
+
+		// 若目录不存在则创建（包括父目录）
+		if (!mCacheDir.exists()) {
+			boolean isCreated = mCacheDir.mkdirs();
+			if (isCreated) {
+				LogUtils.d("ImageDownloader", "networkdownload 缓存目录创建成功：" + mCacheDir.getAbsolutePath());
+			} else {
+				LogUtils.e("ImageDownloader", "networkdownload 缓存目录创建失败");
+			}
+		} else {
+			LogUtils.d("ImageDownloader", "networkdownload 缓存目录已存在：" + mCacheDir.getAbsolutePath());
+		}
+	}
+
+	/**
+	 * 清理过期文件（最后修改时间超过 EXPIRE_TIME 的文件）
+	 */
+	private void clearExpiredFiles() {
+		if (mCacheDir == null || !mCacheDir.exists()) {
+			return;
+		}
+
+		File[] files = mCacheDir.listFiles();
+		if (files == null || files.length == 0) {
+			LogUtils.d("ImageDownloader", "缓存目录无文件，无需清理");
+			return;
+		}
+
+		long currentTime = System.currentTimeMillis();
+		int deleteCount = 0;
+
+		// 遍历所有文件，删除过期文件
+		for (File file : files) {
+			long lastModifyTime = file.lastModified();
+			if (currentTime - lastModifyTime > EXPIRE_TIME) {
+				if (file.delete()) {
+					deleteCount++;
+					LogUtils.d("ImageDownloader", "删除过期文件：" + file.getName());
+				} else {
+					LogUtils.e("ImageDownloader", "删除过期文件失败：" + file.getName());
+				}
+			}
+		}
+
+		LogUtils.d("ImageDownloader", "过期文件清理完成，共删除 " + deleteCount + " 个文件");
+	}
+
+	/**
+	 * 下载网络图片到缓存目录
+	 * @param imageUrl 图片网络链接
+	 * @param callback 下载结果回调（成功/失败）
+	 */
+	public void downloadImage(final String imageUrl, final DownloadCallback callback) {
+		// 校验参数
+		if (TextUtils.isEmpty(imageUrl)) {
+			if (callback != null) {
+				callback.onFailure("图片链接为空");
+			}
+			return;
+		}
+
+		if (mCacheDir == null || !mCacheDir.exists()) {
+			if (callback != null) {
+				callback.onFailure("缓存目录不存在");
+			}
+			return;
+		}
+
+		// 构建 OkHttp 请求
+		Request request = new Request.Builder()
+			.url(imageUrl)
+			.build();
+
+		// 异步下载（避免阻塞主线程）
+		mOkHttpClient.newCall(request).enqueue(new Callback() {
+				@Override
+				public void onFailure(Call call, IOException e) {
+					// 下载失败，回调主线程
+					if (callback != null) {
+						callback.onFailure("下载失败：" + e.getMessage());
+					}
+					LogUtils.e("ImageDownloader", "图片下载失败：" + e.getMessage());
+				}
+
+				@Override
+				public void onResponse(Call call, Response response) throws IOException {
+					if (!response.isSuccessful()) {
+						// 响应失败（如 404、500）
+						if (callback != null) {
+							callback.onFailure("响应失败：" + response.code());
+						}
+						LogUtils.e("ImageDownloader", "图片响应失败，状态码：" + response.code());
+						return;
+					}
+
+					// 响应成功，写入文件
+					InputStream inputStream = null;
+					FileOutputStream outputStream = null;
+					try {
+						inputStream = response.body().byteStream();
+						// 生成 UUID 唯一文件名（保留原文件后缀）
+						String fileExtension = getFileExtension(imageUrl);
+						String fileName = UUID.randomUUID().toString() + fileExtension;
+						File imageFile = new File(mCacheDir, fileName);
+
+						// 写入文件
+						outputStream = new FileOutputStream(imageFile);
+						byte[] buffer = new byte[1024];
+						int len;
+						while ((len = inputStream.read(buffer)) != -1) {
+							outputStream.write(buffer, 0, len);
+						}
+						outputStream.flush();
+
+						// 下载成功，回调主线程并返回文件路径
+						if (callback != null) {
+							callback.onSuccess(imageFile.getAbsolutePath());
+						}
+						LogUtils.d("ImageDownloader", "图片下载成功：" + imageFile.getAbsolutePath());
+
+					} catch (IOException e) {
+						if (callback != null) {
+							callback.onFailure("文件写入失败：" + e.getMessage());
+						}
+						LogUtils.e("ImageDownloader", "图片写入失败：" + e.getMessage());
+					} finally {
+						// 关闭流（Java7 手动关闭，避免资源泄漏）
+						if (inputStream != null) {
+							try {
+								inputStream.close();
+							} catch (IOException e) {
+								e.printStackTrace();
+							}
+						}
+						if (outputStream != null) {
+							try {
+								outputStream.close();
+							} catch (IOException e) {
+								e.printStackTrace();
+							}
+						}
+						// 关闭响应体
+						if (response.body() != null) {
+							response.body().close();
+						}
+					}
+				}
+			});
+	}
+
+	/**
+	 * 获取 networkdownload 目录中最后下载的文件（按修改时间排序）
+	 * @return 最后下载的文件路径（null 表示无文件）
+	 */
+	public String getLastDownloadedFile() {
+		if (mCacheDir == null || !mCacheDir.exists()) {
+			LogUtils.e("ImageDownloader", "缓存目录不存在");
+			return null;
+		}
+
+		File[] files = mCacheDir.listFiles();
+		if (files == null || files.length == 0) {
+			LogUtils.d("ImageDownloader", "缓存目录无文件");
+			return null;
+		}
+
+		// 按最后修改时间降序排序，取第一个即为最新文件
+		File lastFile = files[0];
+		for (File file : files) {
+			if (file.lastModified() > lastFile.lastModified()) {
+				lastFile = file;
+			}
+		}
+
+		LogUtils.d("ImageDownloader", "最后下载的文件：" + lastFile.getAbsolutePath());
+		return lastFile.getAbsolutePath();
+	}
+
+	/**
+	 * 工具方法：从图片链接中提取文件后缀（如 .png、.jpg）
+	 * @param imageUrl 图片链接
+	 * @return 文件后缀（含点号，若无法提取则返回 .jpg）
+	 */
+	private String getFileExtension(String imageUrl) {
+		if (TextUtils.isEmpty(imageUrl)) {
+			return ".jpg";
+		}
+
+		int lastDotIndex = imageUrl.lastIndexOf(".");
+		int lastSlashIndex = imageUrl.lastIndexOf("/");
+		// 确保后缀在最后一个斜杠之后，且长度合理（1-5 个字符）
+		if (lastDotIndex > lastSlashIndex && lastDotIndex < imageUrl.length() - 1) {
+			String extension = imageUrl.substring(lastDotIndex);
+			if (extension.length() <= 5) {
+				return extension.toLowerCase(); // 统一转为小写
+			}
+		}
+
+		// 无法提取后缀时，默认使用 .jpg
+		return ".jpg";
+	}
+
+	/**
+	 * 下载结果回调接口（Java7 接口实现）
+	 */
+	public interface DownloadCallback {
+		/**
+		 * 下载成功
+		 * @param filePath 图片保存路径
+		 */
+		void onSuccess(String filePath);
+
+		/**
+		 * 下载失败
+		 * @param errorMsg 失败原因
+		 */
+		void onFailure(String errorMsg);
+	}
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/utils/MimoUtils.java

@@ -0,0 +1,33 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.util.DisplayMetrics;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/14 11:14
+ * @Describe 米盟 MimoUtils
+ */
+public final class MimoUtils {
+	public static final String TAG = "Utils";
+
+	public static int dpToPx(Context context, float dp) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (dp * displayMetrics.density + 0.5f);
+	}
+
+	public static int pxToDp(Context context, float px) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (px / displayMetrics.density + 0.5f);
+	}
+
+	public static int pxToSp(Context context, float pxValue) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (pxValue / displayMetrics.scaledDensity + 0.5f);
+	}
+
+	public static int spToPx(Context context, float spValue) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (spValue * displayMetrics.scaledDensity + 0.5f);
+	}
+}

powerbell/src/main/java/cc/winboll/studio/powerbell/utils/PictureUtils.java

@@ -0,0 +1,207 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Environment;
+import android.util.Log;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/21 18:55
+ * @Describe
+ * 图片下载工具类（指定目录保存：Pictures/PowerBell/BackgroundHistory）
+ */
+public class PictureUtils {
+    private static final String TAG = "PictureUtils";
+    private static final String ROOT_DIR = "PowerBell/BackgroundHistory"; // 自定义目录结构
+    private static OkHttpClient sOkHttpClient;
+
+    static {
+        sOkHttpClient = new OkHttpClient();
+    }
+
+    /**
+     * 下载网络图片到指定目录（外部存储/Pictures/PowerBell/BackgroundHistory）
+     * @param context 上下文（用于通知相册刷新）
+     * @param imgUrl 图片网络URL
+     * @param callback 下载结果回调（成功/失败）
+     */
+    public static void downloadImageToAlbum(final Context context, final String imgUrl, final DownloadCallback callback) {
+        // 检查参数合法性
+        if (context == null) {
+            if (callback != null) {
+                callback.onFailure(new IllegalArgumentException("Context不能为空"));
+            }
+            return;
+        }
+        if (imgUrl == null || imgUrl.isEmpty()) {
+            if (callback != null) {
+                callback.onFailure(new IllegalArgumentException("图片URL为空"));
+            }
+            return;
+        }
+
+        startDownload(context, imgUrl, callback);
+    }
+
+    /**
+     * 执行实际的下载逻辑
+     */
+    private static void startDownload(final Context context, final String imgUrl, final DownloadCallback callback) {
+        Request request = new Request.Builder().url(imgUrl).build();
+        sOkHttpClient.newCall(request).enqueue(new Callback() {
+				@Override
+				public void onResponse(Call call, Response response) throws IOException {
+					if (!response.isSuccessful()) {
+						if (callback != null) {
+							callback.onFailure(new IOException("请求失败，响应码：" + response.code()));
+						}
+						return;
+					}
+
+					InputStream inputStream = null;
+					FileOutputStream outputStream = null;
+					try {
+						inputStream = response.body().byteStream();
+						// 1. 获取并创建指定保存目录（外部存储/Pictures/PowerBell/BackgroundHistory）
+						File saveDir = getTargetSaveDir(context);
+						if (!saveDir.exists()) {
+							boolean isDirCreated = saveDir.mkdirs(); // 递归创建多级目录
+							if (!isDirCreated) {
+								if (callback != null) {
+									callback.onFailure(new IOException("创建目录失败：" + saveDir.getAbsolutePath()));
+								}
+								return;
+							}
+						}
+
+						// 2. 解析图片后缀
+						String fileSuffix = getImageSuffix(imgUrl, response);
+						// 3. 生成时间戳文件名
+						String fileName = generateTimeFileName() + fileSuffix;
+						// 4. 创建文件
+						final File saveFile = new File(saveDir, fileName);
+
+						// 5. 写入文件
+						outputStream = new FileOutputStream(saveFile);
+						byte[] buffer = new byte[1024 * 4];
+						int len;
+						while ((len = inputStream.read(buffer)) != -1) {
+							outputStream.write(buffer, 0, len);
+						}
+						outputStream.flush();
+
+						// 6. 通知相册刷新（使图片显示在系统相册中）
+						notifyAlbumRefresh(context, saveFile);
+
+						// 成功回调
+						if (callback != null) {
+							callback.onSuccess(saveFile.getAbsolutePath());
+						}
+
+					} catch (Exception e) {
+						Log.e(TAG, "下载图片异常", e);
+						if (callback != null) {
+							callback.onFailure(e);
+						}
+					} finally {
+						// 关闭资源
+						if (inputStream != null) inputStream.close();
+						if (outputStream != null) outputStream.close();
+						if (response.body() != null) response.body().close();
+					}
+				}
+
+				@Override
+				public void onFailure(Call call, final IOException e) {
+					Log.e(TAG, "下载图片失败", e);
+					if (callback != null) {
+						callback.onFailure(e);
+					}
+				}
+			});
+    }
+
+    /**
+     * 获取目标保存目录：外部存储/Pictures/PowerBell/BackgroundHistory
+     */
+    private static File getTargetSaveDir(Context context) {
+        // 优先使用公共Pictures目录（兼容多数设备）
+        File publicPicturesDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
+        if (publicPicturesDir.exists()) {
+            return new File(publicPicturesDir, ROOT_DIR);
+        }
+        // 备选：应用私有Pictures目录（若公共目录不可用）
+        File appPicturesDir = context.getExternalFilesDir(Environment.DIRECTORY_PICTURES);
+        if (appPicturesDir != null) {
+            return new File(appPicturesDir, ROOT_DIR);
+        }
+        // 极端情况：外部存储根目录
+        return new File(Environment.getExternalStorageDirectory(), ROOT_DIR);
+    }
+
+    /**
+     * 解析图片后缀名
+     */
+    private static String getImageSuffix(String imgUrl, Response response) {
+        // 优先从URL解析
+        if (imgUrl.lastIndexOf('.') != -1) {
+            String suffix = imgUrl.substring(imgUrl.lastIndexOf('.'));
+            if (suffix.length() <= 5 && (suffix.contains("png") || suffix.contains("jpg") || suffix.contains("jpeg") || suffix.contains("gif"))) {
+                return suffix.toLowerCase(Locale.getDefault());
+            }
+        }
+        // 从响应头解析
+        String contentType = response.header("Content-Type");
+        if (contentType != null) {
+            if (contentType.contains("png")) return ".png";
+            if (contentType.contains("jpeg") || contentType.contains("jpg")) return ".jpg";
+            if (contentType.contains("gif")) return ".gif";
+        }
+        return ".jpg"; // 默认后缀
+    }
+
+    /**
+     * 生成时间戳文件名
+     */
+    private static String generateTimeFileName() {
+        SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmssSSS", Locale.getDefault());
+        return sdf.format(new Date());
+    }
+
+    /**
+     * 通知相册刷新
+     */
+    private static void notifyAlbumRefresh(Context context, File file) {
+        try {
+            Intent intent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
+            Uri uri = Uri.fromFile(file);
+            intent.setData(uri);
+            context.sendBroadcast(intent);
+        } catch (Exception e) {
+            Log.e(TAG, "通知相册刷新失败", e);
+        }
+    }
+
+    /**
+     * 下载结果回调接口
+     */
+    public interface DownloadCallback {
+        void onSuccess(String savePath); // 下载成功（子线程回调）
+        void onFailure(Exception e);    // 下载失败（子线程回调）
+    }
+}
+

powerbell/src/main/java/cc/winboll/studio/powerbell/views/BackgroundView.java

@@ -0,0 +1,401 @@
+package cc.winboll.studio.powerbell.views;
+
+import android.content.Context;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.drawable.BitmapDrawable;
+import android.graphics.drawable.ColorDrawable;
+import android.graphics.drawable.Drawable;
+import android.util.AttributeSet;
+import android.widget.ImageView;
+import android.widget.RelativeLayout;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/19 18:01
+ * @Describe 背景图片视图控件（全透明背景 + 不拉伸居中平铺 + 完全填充父视图）
+ */
+public class BackgroundView extends RelativeLayout {
+
+    public static final String TAG = "BackgroundView";
+
+    Context mContext;
+    private ImageView ivBackground;
+
+    private static String BACKGROUND_IMAGE_FOLDER = "Background";
+    private static String BACKGROUND_IMAGE_FILENAME = "current.data";
+    private static String BACKGROUND_IMAGE_PREVIEW_FILENAME = "current_preview.data";
+    private static String backgroundSourceFilePath;
+    private float imageAspectRatio = 1.0f; // 图片原始宽高比（控制不拉伸）
+    // 标记当前是否处于预览模式
+    private boolean isPreviewMode = false;
+
+    public BackgroundView(Context context) {
+        super(context);
+        this.mContext = context;
+        initView();
+    }
+
+    public BackgroundView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        this.mContext = context;
+        initView();
+    }
+
+    public BackgroundView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        this.mContext = context;
+        initView();
+    }
+
+    public BackgroundView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        this.mContext = context;
+        initView();
+    }
+
+    void initView() {
+        // 1. 控件本身：完全填充父视图 + 全透明背景 + 无内边距
+        setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
+        setPadding(0, 0, 0, 0); // 取消自身内边距
+        setBackgroundColor(0x00000000); // 全透明背景（#00000000）
+        setBackground(new ColorDrawable(0x00000000)); // 双重保障：同时设置Background为透明（兼容低版本）
+
+        initBackgroundImageView(); // 初始化内部ImageView（全透明 + 不拉伸居中平铺）
+        initBackgroundImagePath();
+        loadAndSetImageViewBackground();
+    }
+
+    private void initBackgroundImageView() {
+        ivBackground = new ImageView(mContext);
+        // 2. ImageView：初始宽高WRAP_CONTENT + 居中 + 无内边距 + 全透明背景
+        RelativeLayout.LayoutParams layoutParams = new RelativeLayout.LayoutParams(
+			LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
+        layoutParams.addRule(RelativeLayout.CENTER_IN_PARENT); // 居中显示
+        layoutParams.setMargins(0, 0, 0, 0); // 取消边距
+        ivBackground.setLayoutParams(layoutParams);
+
+        // 3. 缩放模式：FIT_CENTER（不拉伸，按比例显示）
+        ivBackground.setScaleType(ImageView.ScaleType.FIT_CENTER);
+        ivBackground.setPadding(0, 0, 0, 0); // 取消内部padding
+        ivBackground.setBackgroundColor(0x00000000); // ImageView背景全透明
+        ivBackground.setBackground(new ColorDrawable(0x00000000)); // 双重保障（兼容低版本）
+
+        this.addView(ivBackground);
+    }
+
+    private void initBackgroundImagePath() {
+        File externalFilesDir = mContext.getExternalFilesDir(null);
+        if (externalFilesDir == null) {
+            LogUtils.e(TAG, "外置存储不可用，无法初始化背景图片路径");
+            return;
+        }
+
+        File backgroundDir = new File(externalFilesDir, BACKGROUND_IMAGE_FOLDER);
+        if (!backgroundDir.exists()) {
+            backgroundDir.mkdirs();
+        }
+        backgroundSourceFilePath = new File(backgroundDir, BACKGROUND_IMAGE_FILENAME).getAbsolutePath();
+    }
+
+    /**
+     * 拷贝图片文件到背景资源目录（正式背景）
+     */
+    public void saveToBackgroundSources(String srcBackgroundPath) {
+        initBackgroundImagePath();
+        if (backgroundSourceFilePath == null) {
+            LogUtils.e(TAG, "目标路径初始化失败，无法保存背景图片");
+            return;
+        }
+
+        File srcFile = new File(srcBackgroundPath);
+        if (!srcFile.exists() || !srcFile.isFile()) {
+            LogUtils.e(TAG, String.format("源文件不存在或不是文件：%s", srcBackgroundPath));
+            return;
+        }
+
+        File destFile = new File(backgroundSourceFilePath);
+        File destDir = destFile.getParentFile();
+        if (destDir != null && !destDir.exists()) {
+            boolean isDirCreated = destDir.mkdirs();
+            if (!isDirCreated) {
+                LogUtils.e(TAG, "目标目录创建失败：" + destDir.getAbsolutePath());
+                return;
+            }
+        }
+
+        FileInputStream fis = null;
+        FileOutputStream fos = null;
+        try {
+            fis = new FileInputStream(srcFile);
+            fos = new FileOutputStream(destFile);
+
+            byte[] buffer = new byte[4096];
+            int len;
+            while ((len = fis.read(buffer)) != -1) {
+                fos.write(buffer, 0, len);
+            }
+            fos.flush();
+
+            LogUtils.d(TAG, String.format("文件拷贝成功：%s -> %s", srcBackgroundPath, backgroundSourceFilePath));
+            // 拷贝成功后，若处于预览模式则退出预览，加载正式背景
+            if (isPreviewMode) {
+                exitPreviewMode();
+            } else {
+                loadAndSetImageViewBackground();
+            }
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("文件拷贝失败：%s", e.getMessage()), e);
+            if (destFile.exists()) {
+                destFile.delete();
+                LogUtils.d(TAG, "已删除损坏的目标文件");
+            }
+        } finally {
+            if (fis != null) {
+                try {
+                    fis.close();
+                } catch (Exception e) {
+                    LogUtils.e(TAG, "输入流关闭失败：" + e.getMessage());
+                }
+            }
+            if (fos != null) {
+                try {
+                    fos.close();
+                } catch (Exception e) {
+                    LogUtils.e(TAG, "输出流关闭失败：" + e.getMessage());
+                }
+            }
+        }
+    }
+
+    /**
+     * 预览临时图片（全透明背景 + 不拉伸居中平铺）
+     * @param previewImagePath 临时预览图片的路径
+     */
+    public void previewBackgroundImage(String previewImagePath) {
+        if (previewImagePath == null || previewImagePath.isEmpty()) {
+            LogUtils.e(TAG, "预览图片路径为空");
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        File previewFile = new File(previewImagePath);
+        if (!previewFile.exists() || !previewFile.isFile()) {
+            LogUtils.e(TAG, "预览图片不存在或不是文件：" + previewImagePath);
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        // 计算图片原始宽高比
+        if (!calculateImageAspectRatio(previewFile)) {
+            LogUtils.e(TAG, "预览图片尺寸无效，无法预览");
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        // 压缩加载预览图片（保持比例）
+        Bitmap previewBitmap = decodeBitmapWithCompress(previewFile, 1080, 1920);
+        if (previewBitmap == null) {
+            LogUtils.e(TAG, "预览图片加载失败");
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        // 设置预览图片（保持ImageView透明背景）
+        Drawable previewDrawable = new BitmapDrawable(mContext.getResources(), previewBitmap);
+        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.JELLY_BEAN) {
+            ivBackground.setBackground(previewDrawable);
+        } else {
+            ivBackground.setBackgroundDrawable(previewDrawable);
+        }
+
+        // 调整ImageView尺寸（居中平铺，不拉伸）
+        adjustImageViewSize();
+        isPreviewMode = true;
+        LogUtils.d(TAG, "进入预览模式，预览图片路径：" + previewImagePath + "，宽高比：" + imageAspectRatio);
+    }
+
+    /**
+     * 退出预览模式，恢复显示正式背景图片
+     */
+    public void exitPreviewMode() {
+        if (isPreviewMode) {
+            loadAndSetImageViewBackground();
+            isPreviewMode = false;
+            LogUtils.d(TAG, "退出预览模式，恢复正式背景");
+        }
+    }
+
+    /**
+     * 公共函数：供外部类调用，重新加载正式背景图片（刷新显示）
+     */
+    public void reloadBackgroundImage() {
+        LogUtils.d(TAG, "外部调用重新加载背景图片");
+        initBackgroundImagePath();
+        loadAndSetImageViewBackground();
+        // 若处于预览模式，退出预览
+        if (isPreviewMode) {
+            isPreviewMode = false;
+        }
+    }
+
+    /**
+     * 加载正式背景图片并设置到 ImageView（全透明背景 + 不拉伸居中平铺）
+     */
+    private void loadAndSetImageViewBackground() {
+        if (backgroundSourceFilePath == null) {
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        File backgroundFile = new File(backgroundSourceFilePath);
+        if (!backgroundFile.exists() || !backgroundFile.isFile()) {
+            LogUtils.e(TAG, "背景图片不存在：" + backgroundSourceFilePath);
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        // 计算图片原始宽高比
+        if (!calculateImageAspectRatio(backgroundFile)) {
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        // 压缩加载 Bitmap（保持比例）
+        Bitmap bitmap = decodeBitmapWithCompress(backgroundFile, 1080, 1920);
+        if (bitmap == null) {
+            LogUtils.e(TAG, "图片加载失败，无法解析为 Bitmap");
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        // 设置图片（保持ImageView透明背景）
+        Drawable backgroundDrawable = new BitmapDrawable(mContext.getResources(), bitmap);
+        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.JELLY_BEAN) {
+            ivBackground.setBackground(backgroundDrawable);
+        } else {
+            ivBackground.setBackgroundDrawable(backgroundDrawable);
+        }
+
+        // 调整ImageView尺寸（居中平铺，不拉伸）
+        adjustImageViewSize();
+        LogUtils.d(TAG, "ImageView 背景加载成功（全透明+不拉伸），宽高比：" + imageAspectRatio);
+    }
+
+    /**
+     * 计算图片原始宽高比（宽/高）
+     */
+    private boolean calculateImageAspectRatio(File file) {
+        try {
+            BitmapFactory.Options options = new BitmapFactory.Options();
+            options.inJustDecodeBounds = true;
+            BitmapFactory.decodeFile(file.getAbsolutePath(), options);
+
+            int imageWidth = options.outWidth;
+            int imageHeight = options.outHeight;
+
+            if (imageWidth <= 0 || imageHeight <= 0) {
+                LogUtils.e(TAG, "图片尺寸无效：宽=" + imageWidth + ", 高=" + imageHeight);
+                return false;
+            }
+
+            imageAspectRatio = (float) imageWidth / imageHeight;
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "计算图片宽高比失败：" + e.getMessage());
+            return false;
+        }
+    }
+
+    /**
+     * 调整ImageView尺寸（不拉伸，居中平铺）
+     */
+    private void adjustImageViewSize() {
+        int parentWidth = getWidth(); // 控件宽度（已填充父视图）
+        int parentHeight = getHeight(); // 控件高度（已填充父视图）
+
+        if (parentWidth == 0 || parentHeight == 0) {
+            post(new Runnable() {
+					@Override
+					public void run() {
+						adjustImageViewSize();
+					}
+				});
+            return;
+        }
+
+        int imageViewWidth, imageViewHeight;
+        if (imageAspectRatio >= 1.0f) { // 横图
+            imageViewWidth = Math.min(parentWidth, (int) (parentHeight * imageAspectRatio));
+            imageViewHeight = (int) (imageViewWidth / imageAspectRatio);
+        } else { // 竖图
+            imageViewHeight = Math.min(parentHeight, (int) (parentWidth / imageAspectRatio));
+            imageViewWidth = (int) (imageViewHeight * imageAspectRatio);
+        }
+
+        // 应用尺寸
+        RelativeLayout.LayoutParams layoutParams = (RelativeLayout.LayoutParams) ivBackground.getLayoutParams();
+        layoutParams.width = imageViewWidth;
+        layoutParams.height = imageViewHeight;
+        ivBackground.setLayoutParams(layoutParams);
+
+        LogUtils.d(TAG, "ImageView 尺寸调整完成：宽=" + imageViewWidth + ", 高=" + imageViewHeight);
+    }
+
+    /**
+     * 带压缩的 Bitmap 解码（保持比例，避免 OOM）
+     */
+    private Bitmap decodeBitmapWithCompress(File file, int maxWidth, int maxHeight) {
+        try {
+            BitmapFactory.Options options = new BitmapFactory.Options();
+            options.inJustDecodeBounds = true;
+            BitmapFactory.decodeFile(file.getAbsolutePath(), options);
+
+            int scaleX = options.outWidth / maxWidth;
+            int scaleY = options.outHeight / maxHeight;
+            int inSampleSize = Math.max(scaleX, scaleY);
+            if (inSampleSize <= 0) {
+                inSampleSize = 1;
+            }
+
+            options.inJustDecodeBounds = false;
+            options.inSampleSize = inSampleSize;
+            options.inPreferredConfig = Bitmap.Config.RGB_565;
+            return BitmapFactory.decodeFile(file.getAbsolutePath(), options);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "图片压缩加载失败：" + e.getMessage());
+            return null;
+        }
+    }
+
+    /**
+     * 设置默认背景（全透明兜底，避免空白）
+     */
+    private void setDefaultImageViewBackground() {
+        // 关键：默认背景设为全透明（而非默认图，避免遮挡下层视图）
+        ivBackground.setBackground(new ColorDrawable(0x00000000)); // 全透明背景
+        imageAspectRatio = 1.0f;
+        adjustImageViewSize();
+        LogUtils.d(TAG, "已设置默认透明背景");
+    }
+
+    @Override
+    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
+        super.onSizeChanged(w, h, oldw, oldh);
+        adjustImageViewSize();
+    }
+
+    /**
+     * 对外提供：判断当前是否处于预览模式
+     */
+    public boolean isPreviewMode() {
+        return isPreviewMode;
+    }
+}
+

powerbell/src/main/res/drawable/default_background.xml

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

powerbell/src/main/res/layout/activity_backgroundpicture.xml

@@ -21,14 +21,15 @@
 			android:layout_height="match_parent"
 			android:id="@+id/activitybackgroundpictureRelativeLayout1"/>
 
-
-		<ImageView
+		<cc.winboll.studio.powerbell.views.BackgroundView
+			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/activitybackgroundpictureImageView1"
-			android:layout_below="@id/toolbar">
+			android:background="#FF7381FF"
+			android:id="@+id/activitybackgroundpictureBackgroundView1">
 
-		</ImageView>
+		</cc.winboll.studio.powerbell.views.BackgroundView>
 
 		<LinearLayout
 			android:orientation="vertical"
@@ -80,6 +81,23 @@
 					android:layout_margin="5dp"
 					android:id="@+id/activitybackgroundpictureAButton2"/>
 
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="♾"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundpictureAButton9"
+					android:onClick="onNetworkBackgroundDialog"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right">
+
 				<cc.winboll.studio.libaes.views.AButton
 					android:layout_width="50dp"
 					android:layout_height="36dp"
@@ -103,7 +121,7 @@
 					android:layout_gravity="center_vertical"
 					android:layout_margin="5dp"
 					android:id="@+id/activitybackgroundpictureAButton7"/>
-				
+
 				<cc.winboll.studio.libaes.views.AButton
 					android:layout_width="50dp"
 					android:layout_height="36dp"
@@ -111,11 +129,12 @@
 					android:layout_gravity="center_vertical"
 					android:layout_margin="5dp"
 					android:id="@+id/activitybackgroundpictureAButton8"/>
-				
+
 			</LinearLayout>
 
 		</LinearLayout>
 
 	</RelativeLayout>
+
 </LinearLayout>
 

powerbell/src/main/res/layout/activity_battery_report.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout 
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:background="@android:color/white">
+
+    <!-- 搜索框：提示文本改为“搜索应用名称或包名” -->
+    <EditText
+        android:id="@+id/et_search"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_margin="8dp"
+        android:padding="12dp"
+        android:hint="搜索应用名称或包名"
+        android:background="@android:drawable/btn_default_small"
+        android:inputType="text"
+        android:textSize="16sp"/>
+
+    <!-- 应用列表 -->
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/rv_battery_report"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1"
+        android:layout_marginLeft="8dp"
+        android:layout_marginRight="8dp"/>
+
+</LinearLayout>

powerbell/src/main/res/layout/activity_battery_reporter.xml

@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<LinearLayout 
-    xmlns:android="http://schemas.android.com/apk/res/android"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    android:orientation="vertical"
-    android:padding="16dp">
-
-    <TextView
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="电池使用报告"
-        android:textSize="24sp"
-        android:fontFamily="sans-serif-medium"
-        android:layout_marginBottom="16dp"/>
-
-    <androidx.recyclerview.widget.RecyclerView
-        android:id="@+id/rvBatteryReport"
-        android:layout_width="match_parent"
-        android:layout_height="match_parent"
-        android:divider="@drawable/divider_line"
-        android:dividerHeight="1dp"/>
-
-</LinearLayout>

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

@@ -6,7 +6,7 @@
 	android:layout_height="match_parent"
 	android:orientation="vertical">
 
-	<cc.winboll.studio.libaes.views.AToolbar
+	<cc.winboll.studio.libaes.views.ASupportToolbar
 		android:layout_width="match_parent"
 		android:layout_height="@dimen/toolbar_height"
 		android:id="@+id/toolbar"
@@ -21,8 +21,7 @@
 		<RelativeLayout
 			android:layout_width="match_parent"
 			android:layout_height="match_parent"
-			android:id="@+id/activitymainRelativeLayout1"
-			android:background="#FFEE2121"/>
+			android:id="@+id/activitymainRelativeLayout1"/>
 
 		<FrameLayout
 			android:layout_width="match_parent"
@@ -31,5 +30,10 @@
 
 	</RelativeLayout>
 
+	<cc.winboll.studio.libaes.views.ADsBannerView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/adsbanner"/>
+
 </LinearLayout>
 

powerbell/src/main/res/layout/activity_mainunittest.xml

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

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

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.AToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		style="@style/DefaultAToolbar"/>
+	
+    <cc.winboll.studio.libaes.views.ADsControlView
+		android:id="@+id/ads_control_view"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content" />
+</LinearLayout>

powerbell/src/main/res/layout/dialog_networkbackground.xml

@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:layout_margin="16dp"
+	android:orientation="vertical"
+	android:background="@android:color/white"
+	android:padding="20dp"
+	android:radius="12dp">
+
+	<TextView
+		android:id="@+id/tv_dialog_title"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="网络后台提示"
+		android:textSize="18sp"
+		android:textColor="@android:color/black"
+		android:textStyle="bold"/>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp">
+
+		<EditText
+			android:layout_width="0dp"
+			android:ems="10"
+			android:layout_height="wrap_content"
+			android:layout_weight="1.0"
+			android:id="@+id/et_url"
+			android:singleLine="true"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="↻"
+			android:id="@+id/btn_preview"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="100dp"
+		android:layout_marginTop="12dp"
+		android:layout_gravity="center_vertical">
+
+		<cc.winboll.studio.powerbell.views.BackgroundView
+			android:layout_width="100dp"
+			android:layout_height="100dp"
+			android:id="@+id/bv_background_preview"/>
+
+	</LinearLayout>
+
+	<TextView
+		android:id="@+id/tv_dialog_content"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp"
+		android:text="应用正在后台使用网络，是否继续允许？"
+		android:textSize="15sp"
+		android:textColor="@android:color/darker_gray"/>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="20dp"
+		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:background="@android:drawable/btn_default_small"
+			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:background="@android:drawable/btn_default_small"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+

powerbell/src/main/res/layout/fragment_mainview.xml

@@ -5,12 +5,13 @@
 	android:layout_width="match_parent"
 	android:layout_height="match_parent">
 
-	<ImageView
+	<cc.winboll.studio.powerbell.views.BackgroundView
+		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/fragmentmainviewImageView1">
-
-	</ImageView>
+		android:background="#FF7381FF"
+		android:id="@+id/fragmentmainviewBackgroundView1"/>
 
 	<LinearLayout
 		android:orientation="vertical"

powerbell/src/main/res/layout/fragment_test_backgroundview.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<cc.winboll.studio.powerbell.views.BackgroundView
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="#FF7381FF">
+
+	<HorizontalScrollView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Main"
+			android:id="@+id/btn_main_activity"/>
+
+	</HorizontalScrollView>
+
+</cc.winboll.studio.powerbell.views.BackgroundView>
+

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

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <menu xmlns:android="http://schemas.android.com/apk/res/android">
     <item
-        android:id="@+id/action_battery_reporter"
-        android:title="@string/item_battery_reporter"/>
+        android:id="@+id/action_battery_report"
+        android:title="@string/item_battery_report"/>
     <item
         android:id="@+id/action_clearrecord"
         android:title="@string/item_clearrecord"/>
@@ -10,9 +10,9 @@
         android:id="@+id/action_changepicture"
         android:title="@string/item_changepicture"/>
     <item
-        android:id="@+id/action_log"
-        android:title="@string/item_logview"/>
+        android:id="@+id/action_settings"
+        android:title="@string/item_settings"/>
     <item
         android:id="@+id/action_about"
-        android:title="@string/item_aboutview"/>
+        android:title="@string/item_about"/>
 </menu>

powerbell/src/main/res/menu/toolbar_unittest.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <item
+        android:id="@+id/action_log"
+        android:title="@string/item_logview"/>
+    <item
+        android:id="@+id/action_unittestactivity"
+        android:title="@string/item_mainunittestactivity"/>
+    
+</menu>

powerbell/src/main/res/values-zh/strings.xml

@@ -1,15 +1,19 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="app_name">能源钟</string>
+    <string name="app_name_cn1">能源钟</string>
+    <string name="app_name_cn2">泡额呗额</string>
     <string name="app_description">一个接收手机电量信息的应用，当电量值达到设定范围时会提醒用户。</string>
     <string name="about_crashed">本应用崩溃了，作者水平有限，敬请谅解！</string>
-    <string name="item_mainview">Main View</string>
-    <string name="item_aboutview">About</string>
-    <string name="item_clearrecord">Clear Record</string>
-    <string name="item_changepicture">Change Picture</string>
-    <string name="item_devoloperoptionsview">Developer View</string>
-    <string name="item_logview">Log View</string>
-    <string name="item_sourceview">Source View</string>
+    <string name="item_main">主窗口</string>
+    <string name="item_about">关于</string>
+    <string name="item_settings">应用设置</string>
+    <string name="item_battery_report">应用耗电记录</string>
+    <string name="item_mainunittestactivity">开发调试窗口</string>
+    <string name="item_clearrecord">清理电量记录</string>
+    <string name="item_changepicture">更换背景图片</string>
+    <string name="item_devoloperoptionsview">开发调试窗口</string>
+    <string name="item_logview">日志窗口</string>
+    <string name="item_sourceview">源码窗口</string>
     <string name="txt_aboveswitch">消息总开关</string>
     <string name="txt_aboveswitchtips">当电量低于左边（放电状态）或高于右边（充电状态），就会发送一个提醒铃声。</string>
     <string name="texthint_CustomSlideToCleanRecord">Slide Right To Clean Up APP Record.</string>

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

@@ -25,16 +25,15 @@
     <color name="colorShuiDark">#FF0072A4</color>
     <color name="colorShuiAccent">#FF33C1FF</color>
     <color name="colorXinling">#FFFCC500</color>
-    <color name="colorPrimary">@color/colorShuiDark</color>
+    <!--<color name="colorPrimary">@color/colorShuiDark</color>
     <color name="colorPrimaryDark">@color/colorFeng</color>
     <color name="colorAccent">@color/colorShui</color>
-    <color name="colorYellow">#FFFFFF00</color>
-    <color name="colorRed">#FFFF0000</color>
-    <color name="colorBlue">#FF000FFF</color>
+	-->
+    <color name="colorYellow">#FFBEBE48</color>
+    <color name="colorRed">#FFC85C5C</color>
+    <color name="colorBlue">#FF2677C7</color>
     <color name="colorBlack">#FF000000</color>
-    <color name="colorUsege">@color/colorHuo</color>
-    <color name="colorCurrent">@color/colorShui</color>
-    <color name="colorCharge">@color/colorXinling</color>
+	<color name="colorText">@color/colorBlack</color>
     <!-- 调试配置
     <color name="colorYellow">#FF630066</color>
     <color name="colorRed">#FF23244D</color>
@@ -47,15 +46,19 @@
     <color name="colorBlue">#FF000DE5</color>
     <color name="colorBlack">#FF000000</color>
     -->
-    <!-- 原色配置
-    <color name="colorYellow">#FFFFFF00</color>
+    <!-- 原色配置 -->
+    <!--<color name="colorYellow">#FFFFFF00</color>
     <color name="colorRed">#FFFF0000</color>
     <color name="colorBlue">#FF000FFF</color>
     <color name="colorBlack">#FF000000</color>
+	-->
+    <color name="colorPrimary">@color/colorShui</color>
+    <color name="colorPrimaryDark">@color/colorShuiDark</color>
+    <color name="colorAccent">@color/colorShuiAccent</color>
     <color name="colorUsege">@color/colorRed</color>
     <color name="colorCurrent">@color/colorBlue</color>
     <color name="colorCharge">@color/colorYellow</color>
-    -->
+    
     <!--CustomSlideToUnlockView控件配置-->
     <color name="colorCustomSlideToUnlockViewWhite">#FFFFFFFF</color>
     

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

@@ -1,16 +1,26 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="app_name">PowerBell</string>
+    <string name="app_name_cn1">能源钟</string>
+    <string name="app_name_cn2">泡额呗额</string>
     <string name="app_projectname">PowerBell</string>
     <string name="app_description">A mobile app that receives battery level information from a phone and alerts the user when the battery level reaches a predefined range.</string>
     <string name="about_crashed">This application has crashed, the author level is limited, please understand!</string>
+    <string name="switchto_en1">PowerBell</string>
+    <string name="switchto_cn1">能源钟</string>
+    <string name="switchto_cn2">泡额呗额</string>
+    <string name="en1_switch_disabled">PowerBell X</string>
+    <string name="cn1_switch_disabled">能源钟 X</string>
+    <string name="cn2_switch_disabled">泡额呗额 X</string>
     <string name="item_mainview">Main View</string>
-    <string name="item_aboutview">About</string>
-    <string name="item_battery_reporter">Battery Reporter</string>
+    <string name="item_about">About</string>
+    <string name="item_settings">Settings</string>
+    <string name="item_battery_report">Battery Report</string>
     <string name="item_clearrecord">Clear Record</string>
     <string name="item_changepicture">Change Picture</string>
     <string name="item_devoloperoptionsview">Developer View</string>
     <string name="item_logview">Log View</string>
+    <string name="item_mainunittestactivity">Debug Activity</string>
     <string name="item_cleanlog">Clean Log</string>
     <string name="item_sourceview">Source View</string>
     <string name="txt_aboveswitch">Message master switch</string>

powerbell/src/main/res/xml/file_provider.xml

@@ -13,6 +13,9 @@
     <external-files-path
         name="external_file_path"
         path="." />
+	<external-files-path
+		name="files_root"
+		path="mimoDownload" />
     <!--代表app 外部存储区域根目录下的文件 Context.getExternalCacheDir目录下的目录-->
     <external-cache-path
         name="external_cache_path"

powerbell/src/main/res/xml/shortcutsmaincn1.xml

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

powerbell/src/main/res/xml/shortcutsmaincn2.xml

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

powerbell/src/main/res/xml/shortcutsmainen1.xml

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

powerbell/src/stage/AndroidManifest.xml

@@ -4,18 +4,6 @@
 
     <application>
 
-        <provider
-            android:name="androidx.core.content.FileProvider"
-            android:authorities="cc.winboll.studio.powerbell.fileprovider"
-            android:exported="false"
-            android:grantUriPermissions="true">
-
-            <meta-data
-                android:name="android.support.FILE_PROVIDER_PATHS"
-                android:resource="@xml/file_provider"/>
-
-        </provider>
-
     </application>
 
 </manifest>