<libappbase>Library Release 15.11.6

README.md

@@ -3,8 +3,11 @@
 
 ########
 ## ☁ ☁ ☁ WinBoLL APP ☁ ☁ ☁ ☁ ☁ ☁   ☁ ☁   ☁  ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁ ☁ ☁ 
-# ☁    ☁ WinBoLL Studio Android 应用开源项目。☁ ☁   ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁ ☁  ☁ ☁ ☁ 
+# ☁    ☁ WinBoLL Studio Android 应用开源项目。☁ ☁   ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁ ☁  ☁ ☁ 
 # ☁ ☁ ☁ WinBoLL 网站地址 https://www.winboll.cc/ ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
+# ☁ ☁ ☁ WinBoLL 源码地址 <https://gitea.winboll.cc/Studio/APPBase> ☁ ☁ ☁ ☁  ☁ ☁ ☁
+# ☁ ☁ ☁ GitHub 源码地址 <https://github.com/ZhanGSKen/APPBase.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
+# ☁ ☁ ☁ 码云 源码地址 <https://gitee.com/zhangsken/appbase.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
 
 ## WinBoLL 提问
 同样是 /sdcard 目录，在开发 Android 应用时，

aes/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Thu Nov 27 19:18:55 HKT 2025
-stageCount=9
+#Wed Nov 26 15:54:26 GMT 2025
+stageCount=7
 libraryProject=libaes
 baseVersion=15.11
-publishVersion=15.11.8
-buildCount=0
-baseBetaVersion=15.11.9
+publishVersion=15.11.6
+buildCount=32
+baseBetaVersion=15.11.7

appbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Fri Nov 21 11:41:04 HKT 2025
-stageCount=2
+#Sun Nov 30 17:13:07 HKT 2025
+stageCount=7
 libraryProject=libappbase
 baseVersion=15.11
-publishVersion=15.11.1
+publishVersion=15.11.6
 buildCount=0
-baseBetaVersion=15.11.2
+baseBetaVersion=15.11.7

appbase/src/main/AndroidManifest.xml

@@ -2,7 +2,7 @@
 <manifest
     xmlns:android="http://schemas.android.com/apk/res/android"
     package="cc.winboll.studio.appbase">
-	
+
     <application
         android:name=".App"
         android:icon="@drawable/ic_winboll"
@@ -11,7 +11,7 @@
         android:resizeableActivity="true"
         android:process=":App">
 
-		<activity
+        <activity
             android:name=".MainActivity"
             android:label="@string/app_name"
             android:exported="true"
@@ -29,13 +29,15 @@
             </intent-filter>
 
         </activity>
-		
+
         <activity android:name=".GlobalApplication$CrashActivity"/>
-		
+
         <meta-data
             android:name="android.max_aspect"
             android:value="4.0"/>
 
+        <activity android:name="cc.winboll.studio.libappbase.activities.CrashCopyReceiverActivity"/>
+
     </application>
 
-</manifest>
+</manifest>

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

@@ -2,6 +2,7 @@ package cc.winboll.studio.appbase;
 
 import cc.winboll.studio.libappbase.GlobalApplication;
 import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.BuildConfig;
 
 /**
  * @Author ZhanGSKen<zhangsken@qq.com>
@@ -21,6 +22,8 @@ public class App extends GlobalApplication {
     @Override
     public void onCreate() {
         super.onCreate(); // 调用父类初始化逻辑（如基础库配置、全局上下文设置）
+		//setIsDebugging(false);
+		setIsDebugging(BuildConfig.DEBUG);
         // 初始化 Toast 工具类（传入应用全局上下文，确保 Toast 可在任意地方调用）
         ToastUtils.init(getApplicationContext());
     }

apputils/README.md

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

apputils/build.gradle

@@ -29,7 +29,7 @@ android {
         // versionName 更新后需要手动设置 
         // 项目模块目录的 build.gradle 文件的 stageCount=0
         // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
-        versionName "15.8" 
+        versionName "15.10" 
         if(true) {
             versionName = genVersionName("${versionName}")
         }

apputils/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Mon Sep 01 07:56:33 HKT 2025
-stageCount=7
+#Mon Sep 29 01:16:05 HKT 2025
+stageCount=3
 libraryProject=libapputils
-baseVersion=15.8
-publishVersion=15.8.6
+baseVersion=15.10
+publishVersion=15.10.2
 buildCount=0
-baseBetaVersion=15.8.7
+baseBetaVersion=15.10.3

apputils/src/main/AndroidManifest.xml

@@ -2,14 +2,20 @@
 <manifest
     xmlns:android="http://schemas.android.com/apk/res/android"
     package="cc.winboll.studio.apputils">
-
+	
+	<!-- 读取外部存储权限（Android 10 以下） -->
+	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+		
     <application
         android:name=".App"
         android:allowBackup="true"
         android:icon="@drawable/ic_winboll"
         android:label="@string/app_name"
         android:theme="@style/MyUtilsTheme"
-        android:supportsRtl="true">
+        android:supportsRtl="true"
+        android:resizeableActivity="true"
+		android:screenOrientation="unspecified"
+		android:requestLegacyExternalStorage="true">
 
         <activity
             android:name=".MainActivity"
@@ -35,6 +41,8 @@
 
         <activity android:name=".QRCodeDecodeActivity"/>
 
+        <activity android:name=".QRGeneratorActivity"/>
+
     </application>
 
-</manifest>
+</manifest>

apputils/src/main/java/cc/winboll/studio/apputils/AssetsHtmlActivity.java

@@ -15,12 +15,11 @@ import android.view.MenuItem;
 import android.widget.Toolbar;
 import cc.winboll.studio.apputils.R;
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.winboll.IWinBoLLActivity;
 import cc.winboll.studio.libapputils.views.SimpleWebView;
 import java.io.IOException;
 import java.io.InputStream;
 
-public class AssetsHtmlActivity extends WinBoLLActivity implements IWinBoLLActivity {
+public class AssetsHtmlActivity extends Activity {
 
     public static final String TAG = "AssetsHtmlActivity";
 
@@ -32,16 +31,6 @@ public class AssetsHtmlActivity extends WinBoLLActivity implements IWinBoLLActiv
 
     // Assets 文件夹里的 Html 文件的名称
     String mszHtmlFileName;
-
-    @Override
-    public Activity getActivity() {
-        return this;
-    }
-
-    @Override
-    public String getTag() {
-        return TAG;
-    }
     
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {

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

@@ -15,9 +15,10 @@ import android.widget.Toolbar;
 import cc.winboll.studio.apputils.R;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.LogView;
-import cc.winboll.studio.libappbase.utils.ToastUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
 import java.util.List;
 import java.util.Set;
+import cc.winboll.studio.libappbase.LogActivity;
 
 final public class MainActivity extends Activity {
 
@@ -26,21 +27,21 @@ final public class MainActivity extends Activity {
     public static final int REQUEST_QRCODEDECODE_ACTIVITY = 0;
 
     Toolbar mToolbar;
-    LogView mLogView;
+    //LogView mLogView;
 //
 //    @Override
 //    public Activity getActivity() {
 //        return this;
 //    }
 
-    
+
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
 
-        mLogView = findViewById(R.id.logview);
-        mLogView.start();
+//        mLogView = findViewById(R.id.logview);
+//        mLogView.start();
 
         // 初始化工具栏
         mToolbar = findViewById(R.id.toolbar);
@@ -145,13 +146,21 @@ final public class MainActivity extends Activity {
     }
 
     public void onTestLogActivity(View view) {
-//        Intent intent = new Intent(this, LogActivity.class);
-//        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
-//        intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
-//        startActivity(intent);
+		/* 分屏代码有效
+		// 1. 创建启动 SecondActivity 的 Intent
+		Intent splitIntent = new Intent(MainActivity.this, LogActivity.class);
 
-        //WinBoLLActivityManager.getInstance().printAvtivityListInfo();
-        //WinBoLLActivityManager.getInstance(this).startWinBoLLActivity(this, LogActivity.class);
+		// 2. 添加分屏启动必需的两个标志（API 30 兼容）
+		// FLAG_ACTIVITY_LAUNCH_ADJACENT：相邻分屏显示
+		// FLAG_ACTIVITY_NEW_TASK：分屏需要新任务栈
+		splitIntent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT 
+							 | Intent.FLAG_ACTIVITY_NEW_TASK);
+
+		// 3. 启动分屏活动（若设备不支持分屏，会默认全屏启动）
+		startActivity(splitIntent);
+		*/
+
+		LogActivity.startLogActivity(this);
     }
 
     //
@@ -217,10 +226,9 @@ final public class MainActivity extends Activity {
         if (item.getItemId() == R.id.item_exit) {
             //exit();
             return true;
-//        } else if (item.getItemId() == R.id.item_teststringtoqrcodeview) {
-//            Intent intent = new Intent(this, TestStringToQRCodeViewActivity.class);
-//            startActivityForResult(intent, REQUEST_QRCODEDECODE_ACTIVITY);
-//            //WinBoLLActivityManager.getInstance(this).startWinBoLLActivity(this, TestStringToQrCodeViewActivity.class);
+        } else if (item.getItemId() == R.id.item_testqrgeneratoractivity) {
+            Intent intent = new Intent(this, QRGeneratorActivity.class);
+            startActivity(intent);
         } else if (item.getItemId() == R.id.item_testqrcodedecodeactivity) {
             Intent intent = new Intent(this, QRCodeDecodeActivity.class);
             startActivityForResult(intent, REQUEST_QRCODEDECODE_ACTIVITY);
@@ -268,7 +276,7 @@ final public class MainActivity extends Activity {
 //        }
     }
 
-    
+
     public void onTestAssetsHtmlActivity(View view) {
         Intent intent = new Intent(this, AssetsHtmlActivity.class);
         intent.putExtra(AssetsHtmlActivity.EXTRA_HTMLFILENAME, "javascript_test.html");
@@ -281,7 +289,7 @@ final public class MainActivity extends Activity {
     @Override
     protected void onResume() {
         super.onResume();
-        mLogView.start();
+        //mLogView.start();
     }
 
     /*@Override

apputils/src/main/java/cc/winboll/studio/apputils/QRCodeDecodeActivity.java

@@ -1,89 +1,323 @@
 package cc.winboll.studio.apputils;
 
 /**
- * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
  * @Date 2025/01/18 10:32:21
- * @Describe 二维码扫码解码窗口
+ * @Describe 二维码解码窗口
  */
 import android.app.Activity;
+import android.app.AlertDialog;
+import android.content.DialogInterface;
 import android.content.Intent;
 import android.content.pm.PackageManager;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.Canvas;
+import android.graphics.ColorMatrix;
+import android.graphics.ColorMatrixColorFilter;
+import android.graphics.Paint;
+import android.net.Uri;
 import android.os.Bundle;
+import android.provider.MediaStore;
+import android.view.View;
+import android.widget.Button;
+import android.widget.ScrollView;
 import android.widget.TextView;
 import android.widget.Toolbar;
 import cc.winboll.studio.apputils.R;
+import com.google.zxing.BarcodeFormat;
+import com.google.zxing.BinaryBitmap;
+import com.google.zxing.DecodeHintType;
+import com.google.zxing.LuminanceSource;
+import com.google.zxing.MultiFormatReader;
+import com.google.zxing.NotFoundException;
+import com.google.zxing.RGBLuminanceSource;
+import com.google.zxing.Result;
 import com.google.zxing.ResultPoint;
+import com.google.zxing.common.HybridBinarizer;
 import com.journeyapps.barcodescanner.BarcodeCallback;
 import com.journeyapps.barcodescanner.BarcodeResult;
 import com.journeyapps.barcodescanner.DecoratedBarcodeView;
+import com.journeyapps.barcodescanner.DefaultDecoderFactory;
+import java.io.InputStream;
+import java.util.ArrayList;
+import java.util.Hashtable;
 import java.util.List;
 
 public class QRCodeDecodeActivity extends Activity {
 
     public static final String TAG = "QRCodeDecodeActivity";
-
     public static final String EXTRA_RESULT = "EXTRA_RESULT";
     private static final int REQUEST_CAMERA_PERMISSION = 1;
+    private static final int REQUEST_PICK_IMAGE = 2;
+    private static final int REQUEST_READ_STORAGE_PERMISSION = 3;
+    // 图片压缩阈值：超过1000px时压缩，避免内存溢出和解码效率低
+    private static final int MAX_BITMAP_SIZE = 1000;
 
-    TextView resultTextView;
-    DecoratedBarcodeView barcodeView;
-
-//    @Override
-//    public Activity getActivity() {
-//        return this;
-//    }
+    private TextView resultTextView;
+    private DecoratedBarcodeView barcodeView;
+    private Button btnDecodeFromAlbum;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_qrcodedecode);
-
-        // 初始化工具栏
-//        Toolbar mToolbar = findViewById(R.id.toolbar);
-//        setActionBar(mToolbar);
-
-        //resultTextView = findViewById(R.id.activityqrcodedecodeTextView1);
-        barcodeView = findViewById(R.id.activityqrcodedecodeDecoratedBarcodeView1);
-        // 请求相机权限
-//        if (ContextCompat.checkSelfPermission(this, android.Manifest.permission.CAMERA)
-//            != PackageManager.PERMISSION_GRANTED) {
-//            ActivityCompat.requestPermissions(this,
-//                                              new String[]{android.Manifest.permission.CAMERA},
-//                                              REQUEST_CAMERA_PERMISSION);
-//        } else {
-//            startScanning();
-//        }
-        startScanning();
+        initToolbar();
+        initViews();
+        checkCameraPermission();
+        setAlbumDecodeClickListener();
     }
 
-    private void startScanning() {
-        barcodeView.getBarcodeView().setDecoderFactory(null);
-        barcodeView.decodeContinuous(barcodeCallback);
-    }
-
-    @Override
-    public void onRequestPermissionsResult(int requestCode,
-                                           String[] permissions, int[] grantResults) {
-        if (requestCode == REQUEST_CAMERA_PERMISSION) {
-            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
-                startScanning();
-            } else {
-                // 权限被拒绝的处理
+    private void initToolbar() {
+        Toolbar mToolbar = (Toolbar) findViewById(R.id.toolbar);
+        if (mToolbar != null) {
+            setActionBar(mToolbar);
+            if (getActionBar() != null) {
+                getActionBar().setDisplayHomeAsUpEnabled(true);
+                mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+						@Override
+						public void onClick(View v) {
+							finish();
+						}
+					});
             }
         }
     }
 
-    BarcodeCallback barcodeCallback = new BarcodeCallback(){
+    private void initViews() {
+        resultTextView = (TextView) findViewById(R.id.activityqrcodedecodeTextView1);
+        barcodeView = (DecoratedBarcodeView) findViewById(R.id.activityqrcodedecodeDecoratedBarcodeView1);
+        btnDecodeFromAlbum = (Button) findViewById(R.id.btn_decode_from_album);
+        // 初始化扫码解码器（支持所有常见码制，避免仅支持QR_CODE的局限）
+        List<BarcodeFormat> formats = new ArrayList<BarcodeFormat>();
+        formats.add(BarcodeFormat.QR_CODE);
+        formats.add(BarcodeFormat.CODE_128);
+        formats.add(BarcodeFormat.EAN_13);
+        barcodeView.getBarcodeView().setDecoderFactory(new DefaultDecoderFactory(formats));
+    }
+
+    private void setAlbumDecodeClickListener() {
+        btnDecodeFromAlbum.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					if (checkSelfPermission(android.Manifest.permission.READ_EXTERNAL_STORAGE)
+                        != PackageManager.PERMISSION_GRANTED) {
+						requestPermissions(new String[]{android.Manifest.permission.READ_EXTERNAL_STORAGE},
+										   REQUEST_READ_STORAGE_PERMISSION);
+					} else {
+						openAlbum();
+					}
+				}
+			});
+    }
+
+    private void openAlbum() {
+        Intent pickImageIntent = new Intent(Intent.ACTION_PICK);
+        pickImageIntent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");
+        startActivityForResult(pickImageIntent, REQUEST_PICK_IMAGE);
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        if (requestCode == REQUEST_PICK_IMAGE && resultCode == RESULT_OK && data != null) {
+            Uri selectedImageUri = data.getData();
+            if (selectedImageUri != null) {
+                try {
+                    // 1. 读取图片并压缩（关键优化：避免大图片解码失败）
+                    InputStream imageStream = getContentResolver().openInputStream(selectedImageUri);
+                    BitmapFactory.Options options = new BitmapFactory.Options();
+                    options.inJustDecodeBounds = true; // 先获取图片尺寸，不加载像素
+                    BitmapFactory.decodeStream(imageStream, null, options);
+                    imageStream.close(); // 关闭流，重新读取
+
+                    // 计算压缩比例：超过MAX_BITMAP_SIZE时按比例压缩
+                    options.inSampleSize = calculateInSampleSize(options, MAX_BITMAP_SIZE, MAX_BITMAP_SIZE);
+                    options.inJustDecodeBounds = false; // 开始加载压缩后的像素
+                    imageStream = getContentResolver().openInputStream(selectedImageUri);
+                    Bitmap originalBitmap = BitmapFactory.decodeStream(imageStream, null, options);
+                    imageStream.close();
+
+                    if (originalBitmap == null) {
+                        showToast("图片损坏，无法解析");
+                        return;
+                    }
+
+                    // 2. 图片预处理：转为灰度图+提高对比度（解决模糊/低对比度图片识别问题）
+                    Bitmap processedBitmap = processBitmap(originalBitmap);
+
+                    // 3. 解码预处理后的图片
+                    String decodeResult = decodeQrFromBitmap(processedBitmap);
+
+                    // 4. 结果处理
+                    if (decodeResult != null && !decodeResult.isEmpty()) {
+                        resultTextView.setText("图片解码结果：" + decodeResult);
+                        showDecodeResultDialog(decodeResult);
+                        returnResultToPreviousPage(decodeResult);
+                    } else {
+                        // 尝试直接解码原图（防止预处理过度导致识别失败）
+                        String originalResult = decodeQrFromBitmap(originalBitmap);
+                        if (originalResult != null && !originalResult.isEmpty()) {
+                            resultTextView.setText("图片解码结果：" + originalResult);
+                            showDecodeResultDialog(originalResult);
+                            returnResultToPreviousPage(originalResult);
+                        } else {
+                            new AlertDialog.Builder(this)
+								.setTitle("解码失败")
+								.setMessage("图片中未识别到二维码/条码，建议选择清晰、完整的图片")
+								.setPositiveButton("确定", new DialogInterface.OnClickListener() {
+									@Override
+									public void onClick(DialogInterface dialog, int which) {
+										dialog.dismiss();
+									}
+								})
+								.show();
+                        }
+                    }
+
+                    // 回收Bitmap，避免内存泄漏
+                    if (!originalBitmap.isRecycled()) originalBitmap.recycle();
+                    if (!processedBitmap.isRecycled() && processedBitmap != originalBitmap) {
+                        processedBitmap.recycle();
+                    }
+
+                } catch (Exception e) {
+                    e.printStackTrace();
+                    showToast("图片处理失败：" + e.getMessage());
+                }
+            } else {
+                showToast("未选择图片");
+            }
+        }
+    }
+
+    /**
+     * 核心优化1：计算图片压缩比例
+     */
+    private int calculateInSampleSize(BitmapFactory.Options options, int reqWidth, int reqHeight) {
+        final int height = options.outHeight;
+        final int width = options.outWidth;
+        int inSampleSize = 1;
+
+        if (height > reqHeight || width > reqWidth) {
+            final int halfHeight = height / 2;
+            final int halfWidth = width / 2;
+            // 找到最接近reqWidth/reqHeight的压缩比例（2的倍数，保证图片质量）
+            while ((halfHeight / inSampleSize) >= reqHeight
+				   && (halfWidth / inSampleSize) >= reqWidth) {
+                inSampleSize *= 2;
+            }
+        }
+        return inSampleSize;
+    }
+
+    /**
+     * 核心优化2：图片预处理（灰度化+提高对比度）
+     * 解决模糊、低亮度、低对比度图片识别率低的问题
+     */
+    private Bitmap processBitmap(Bitmap bitmap) {
+        int width = bitmap.getWidth();
+        int height = bitmap.getHeight();
+
+        // 创建灰度图
+        Bitmap grayBitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
+        Canvas canvas = new Canvas(grayBitmap);
+        Paint paint = new Paint();
+
+        // 1. 灰度化矩阵
+        ColorMatrix grayMatrix = new ColorMatrix();
+        grayMatrix.setSaturation(0); // 饱和度设为0，转为灰度
+
+        // 2. 提高对比度矩阵（alpha=1.5，亮度=0，可根据需求调整）
+        ColorMatrix contrastMatrix = new ColorMatrix();
+        contrastMatrix.set(new float[]{
+							   1.5f, 0, 0, 0, 0,  // 红通道对比度
+							   0, 1.5f, 0, 0, 0,  // 绿通道对比度
+							   0, 0, 1.5f, 0, 0,  // 蓝通道对比度
+							   0, 0, 0, 1f, 0     // alpha通道不变
+						   });
+
+        // 合并灰度+对比度矩阵
+        ColorMatrix combinedMatrix = new ColorMatrix();
+        combinedMatrix.postConcat(grayMatrix);
+        combinedMatrix.postConcat(contrastMatrix);
+
+        paint.setColorFilter(new ColorMatrixColorFilter(combinedMatrix));
+        canvas.drawBitmap(bitmap, 0, 0, paint);
+
+        return grayBitmap;
+    }
+
+    /**
+     * 核心优化3：修复解码参数，支持更多场景
+     */
+    private String decodeQrFromBitmap(Bitmap bitmap) {
+        if (bitmap == null) return null;
+
+        try {
+            int width = bitmap.getWidth();
+            int height = bitmap.getHeight();
+            int[] pixels = new int[width * height];
+            bitmap.getPixels(pixels, 0, width, 0, 0, width, height);
+
+            // 修复1：使用RGBLuminanceSource，避免YUV格式导致的颜色偏差
+            LuminanceSource source = new RGBLuminanceSource(width, height, pixels);
+            BinaryBitmap binaryBitmap = new BinaryBitmap(new HybridBinarizer(source));
+
+            // 修复2：完善解码参数，解决模糊、变形二维码识别问题
+            Hashtable<DecodeHintType, Object> hints = new Hashtable<DecodeHintType, Object>();
+            // 支持所有常见码制（不仅限于QR_CODE）
+            List<BarcodeFormat> formats = new ArrayList<BarcodeFormat>();
+            formats.add(BarcodeFormat.QR_CODE);
+            formats.add(BarcodeFormat.CODE_128);
+            formats.add(BarcodeFormat.EAN_8);
+            formats.add(BarcodeFormat.EAN_13);
+            hints.put(DecodeHintType.POSSIBLE_FORMATS, formats);
+            // 字符编码：支持中文等多语言
+            hints.put(DecodeHintType.CHARACTER_SET, "UTF-8");
+            // 容错模式：允许二维码有一定损坏（关键！解决轻微变形/污染的二维码）
+            hints.put(DecodeHintType.TRY_HARDER, Boolean.TRUE);
+            // 不使用纯条码模式，兼容带logo的二维码
+            hints.put(DecodeHintType.PURE_BARCODE, Boolean.FALSE);
+
+            MultiFormatReader reader = new MultiFormatReader();
+            reader.setHints(hints);
+            Result result = reader.decode(binaryBitmap);
+            return result.getText();
+
+        } catch (NotFoundException e) {
+            // 正常未识别到，不打印异常（避免日志冗余）
+            return null;
+        } catch (Exception e) {
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    // ==================== 原有逻辑（不变） ====================
+    private void checkCameraPermission() {
+        if (checkSelfPermission(android.Manifest.permission.CAMERA)
+			!= PackageManager.PERMISSION_GRANTED) {
+            requestPermissions(new String[]{android.Manifest.permission.CAMERA},
+							   REQUEST_CAMERA_PERMISSION);
+        } else {
+            startScanning();
+        }
+    }
+
+    private void startScanning() {
+        barcodeView.decodeContinuous(barcodeCallback);
+    }
+
+    private BarcodeCallback barcodeCallback = new BarcodeCallback() {
         @Override
         public void barcodeResult(BarcodeResult result) {
-            if (result.getText() != null) {
-                //Toast.makeText(MainActivity.this, "Scanned: " + result.getText(), Toast.LENGTH_SHORT).show();
-                //ToastUtils.show("Scanned: " + result.getText());
+            if (result != null && result.getText() != null) {
                 barcodeView.pause();
-                Intent intent = new Intent();
-                intent.putExtra(EXTRA_RESULT, result.getText());
-                setResult(RESULT_OK, intent);
-                finish();
+                String decodeResult = result.getText();
+                resultTextView.setText("扫码结果：" + decodeResult);
+                showDecodeResultDialog(decodeResult);
+                returnResultToPreviousPage(decodeResult);
             }
         }
 
@@ -92,16 +326,111 @@ public class QRCodeDecodeActivity extends Activity {
         }
     };
 
+    private void showDecodeResultDialog(String result) {
+        ScrollView scrollView = new ScrollView(this);
+        scrollView.setPadding(dip2px(16), dip2px(16), dip2px(16), dip2px(16));
+
+        TextView dialogTv = new TextView(this);
+        dialogTv.setTextSize(16);
+        dialogTv.setTextColor(getResources().getColor(android.R.color.black));
+        dialogTv.setText(result);
+        scrollView.addView(dialogTv);
+
+        AlertDialog.Builder builder = new AlertDialog.Builder(this);
+        builder.setTitle("解码结果");
+        builder.setView(scrollView);
+        builder.setPositiveButton("确定", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+					barcodeView.resume();
+				}
+			});
+        builder.setCancelable(false);
+        builder.show();
+    }
+
+    private void returnResultToPreviousPage(String result) {
+        Intent intent = new Intent();
+        intent.putExtra(EXTRA_RESULT, result);
+        setResult(RESULT_OK, intent);
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        if (requestCode == REQUEST_CAMERA_PERMISSION) {
+            if (grantResults != null && grantResults.length > 0) {
+                if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                    startScanning();
+                } else {
+                    new AlertDialog.Builder(this)
+						.setTitle("权限申请")
+						.setMessage("扫码需要相机权限，请在设置中开启")
+						.setPositiveButton("确定", new DialogInterface.OnClickListener() {
+							@Override
+							public void onClick(DialogInterface dialog, int which) {
+								dialog.dismiss();
+								finish();
+							}
+						})
+						.setCancelable(false)
+						.show();
+                }
+            }
+        } else if (requestCode == REQUEST_READ_STORAGE_PERMISSION) {
+            if (grantResults != null && grantResults.length > 0) {
+                if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                    openAlbum();
+                } else {
+                    new AlertDialog.Builder(this)
+						.setTitle("权限申请")
+						.setMessage("从相册解码需要存储权限，请在设置中开启")
+						.setPositiveButton("确定", new DialogInterface.OnClickListener() {
+							@Override
+							public void onClick(DialogInterface dialog, int which) {
+								dialog.dismiss();
+							}
+						})
+						.setCancelable(false)
+						.show();
+                }
+            }
+        }
+    }
+
     @Override
     protected void onResume() {
         super.onResume();
-        barcodeView.resume();
+        if (barcodeView != null) {
+            barcodeView.resume();
+        }
     }
 
     @Override
     protected void onPause() {
         super.onPause();
-        barcodeView.pause();
+        if (barcodeView != null) {
+            barcodeView.pause();
+        }
+    }
+
+    private int dip2px(float dpValue) {
+        final float scale = getResources().getDisplayMetrics().density;
+        return (int) (dpValue * scale + 0.5f);
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(android.view.MenuItem item) {
+        if (item.getItemId() == android.R.id.home) {
+            finish();
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    private void showToast(String message) {
+        android.widget.Toast.makeText(this, message, android.widget.Toast.LENGTH_SHORT).show();
     }
 }
 

apputils/src/main/java/cc/winboll/studio/apputils/QRGeneratorActivity.java

@@ -0,0 +1,97 @@
+package cc.winboll.studio.apputils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/22 07:09
+ * @Describe 二维码生成窗口
+ */
+import android.app.Activity;
+import android.graphics.Bitmap;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.ImageView;
+import android.widget.Toast;
+import com.google.zxing.BarcodeFormat;
+import com.google.zxing.WriterException;
+import com.journeyapps.barcodescanner.BarcodeEncoder;
+
+public class QRGeneratorActivity extends Activity {
+	public static final String TAG = "QrGeneratorActivity";
+
+	// 控件引用
+	private EditText etInputText;
+	private ImageView ivQrPreview;
+	private Button btnGenerateQr;
+
+	@Override
+	protected void onCreate(Bundle savedInstanceState) {
+		super.onCreate(savedInstanceState);
+		setContentView(R.layout.activity_qrgenerator);
+
+		// 初始化控件
+		initViews();
+		// 设置按钮点击事件
+		setGenerateClickListener();
+	}
+
+	/**
+	 * 初始化布局控件
+	 */
+	private void initViews() {
+		etInputText = findViewById(R.id.et_input_text);
+		ivQrPreview = findViewById(R.id.iv_qr_preview);
+		btnGenerateQr = findViewById(R.id.btn_generate_qr);
+	}
+
+	/**
+	 * 设置生成按钮点击事件：获取输入文字 → 生成二维码 → 显示到 ImageView
+	 */
+	private void setGenerateClickListener() {
+		btnGenerateQr.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					// 1. 获取输入框文字（去除前后空格）
+					String inputText = etInputText.getText().toString().trim();
+
+					// 2. 空输入判断
+					if (inputText.isEmpty()) {
+						Toast.makeText(QRGeneratorActivity.this, "请先输入要生成二维码的文字", Toast.LENGTH_SHORT).show();
+						return;
+					}
+
+					// 3. 生成二维码 Bitmap（宽高 500px，可调整）
+					Bitmap qrBitmap = generateQrCodeBitmap(inputText, 500, 500);
+
+					// 4. 显示二维码到 ImageView
+					if (qrBitmap != null) {
+						ivQrPreview.setImageBitmap(qrBitmap);
+					} else {
+						Toast.makeText(QRGeneratorActivity.this, "二维码生成失败，请重试", Toast.LENGTH_SHORT).show();
+					}
+				}
+			});
+	}
+
+	/**
+	 * 核心方法：生成二维码 Bitmap
+	 * @param content 二维码内容（输入的文字）
+	 * @param width 二维码宽度（px）
+	 * @param height 二维码高度（px）
+	 * @return 生成的二维码 Bitmap，失败返回 null
+	 */
+	private Bitmap generateQrCodeBitmap(String content, int width, int height) {
+		try {
+			// 初始化二维码编码器（指定格式为 QR_CODE）
+			BarcodeEncoder encoder = new BarcodeEncoder();
+			// 生成二维码 Bitmap（参数：内容、格式、宽、高）
+			return encoder.encodeBitmap(content, BarcodeFormat.QR_CODE, width, height);
+		} catch (WriterException e) {
+			// 生成失败（如内容过长、宽高非法），打印异常信息
+			e.printStackTrace();
+			return null;
+		}
+	}
+}
+

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

@@ -6,19 +6,9 @@ package cc.winboll.studio.apputils;
  * @Describe WinBoLLActivity
  */
 import android.app.Activity;
-import cc.winboll.studio.libappbase.winboll.IWinBoLLActivity;
 
-public class WinBoLLActivity extends Activity implements IWinBoLLActivity {
+public class WinBoLLActivity extends Activity {
 
     public static final String TAG = "WinBoLLActivity";
 
-    @Override
-    public Activity getActivity() {
-        return this;
-    }
-
-    @Override
-    public String getTag() {
-        return TAG;
-    }
 }

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

@@ -54,13 +54,6 @@
 
 		</LinearLayout>
 
-		<cc.winboll.studio.libappbase.LogView
-			android:layout_width="match_parent"
-			android:layout_height="0dp"
-			android:text="Button"
-			android:id="@+id/logview"
-			android:layout_weight="1.0"/>
-
 	</LinearLayout>
 
 </LinearLayout>

apputils/src/main/res/layout/activity_qrcodedecode.xml

@@ -1,20 +1,43 @@
 <?xml version="1.0" encoding="utf-8"?>
-<LinearLayout
+<LinearLayout 
     xmlns:android="http://schemas.android.com/apk/res/android"
-    xmlns:app="http://schemas.android.com/apk/res-auto"
-    android:orientation="vertical"
     android:layout_width="match_parent"
-    android:layout_height="match_parent">
+    android:layout_height="match_parent"
+    android:orientation="vertical">
 
-    <TextView
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="QRCodeDecodeActivity"/>
+    <!-- 工具栏（原有） -->
+    <Toolbar
+        android:id="@+id/toolbar"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"/>
 
+    <!-- 扫码控件（原有） -->
     <com.journeyapps.barcodescanner.DecoratedBarcodeView
-        android:layout_width="wrap_content"
+        android:id="@+id/activityqrcodedecodeDecoratedBarcodeView1"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1"/>
+
+    <!-- 新增：从相册解码按钮 -->
+    <Button
+        android:id="@+id/btn_decode_from_album"
+        android:layout_width="match_parent"
         android:layout_height="wrap_content"
-        android:id="@+id/activityqrcodedecodeDecoratedBarcodeView1"/>
+        android:text="从相册选图解码"
+        android:textSize="16sp"
+        android:textColor="@android:color/white"
+        android:background="#2196F3"
+        android:paddingVertical="12dp"
+        android:layout_margin="16dp"/>
+
+    <!-- 结果显示TextView（原有） -->
+    <TextView
+        android:id="@+id/activityqrcodedecodeTextView1"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:padding="16dp"
+        android:text="等待扫码或选择图片..."
+        android:textSize="16sp"/>
 
 </LinearLayout>
 

apputils/src/main/res/layout/activity_qrgenerator.xml

@@ -0,0 +1,45 @@
+<?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="20dp"
+    android:gravity="top|center_horizontal">
+
+    <!-- 文字输入框 -->
+    <EditText
+        android:id="@+id/et_input_text"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="请输入要生成二维码的文字"
+        android:inputType="textMultiLine"
+        android:minLines="3"
+        android:maxLines="5"
+        android:padding="12dp"
+        android:background="@android:drawable/editbox_background_normal"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 生成二维码按钮 -->
+    <Button
+        android:id="@+id/btn_generate_qr"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="生成二维码"
+        android:textSize="16sp"
+        android:background="#4CAF50"
+        android:textColor="@android:color/white"
+        android:paddingVertical="12dp"
+        android:layout_marginBottom="24dp"/>
+
+    <!-- 二维码预览图片 -->
+    <ImageView
+        android:id="@+id/iv_qr_preview"
+        android:layout_width="280dp"
+        android:layout_height="280dp"
+        android:scaleType="fitCenter"
+        android:background="@android:drawable/dialog_holo_light_frame"
+        android:contentDescription="二维码预览"/>
+
+</LinearLayout>
+

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

@@ -2,8 +2,8 @@
 <menu xmlns:android="http://schemas.android.com/apk/res/android"
 	xmlns:app="http://schemas.android.com/apk/res-auto">
     <item
-        android:id="@+id/item_teststringtoqrcodeview"
-        android:title="TestStringToQRCodeViewActivity"/>
+        android:id="@+id/item_testqrgeneratoractivity"
+        android:title="TestQRGeneratorActivity"/>
     <item
         android:id="@+id/item_testqrcodedecodeactivity"
         android:title="TestQRCodeDecodeActivity"/>

build.gradle

@@ -33,9 +33,6 @@ buildscript {
         //println mavenLocal().url
         //println "mavenLocal : ==========="
         //mavenLocal()
-        
-        // WinBoLL.CC 紧急备用 Maven 仓库
-        maven { url 'https://spare-maven.winboll.cc/repository/' }
     }
     dependencies {
         classpath 'com.android.tools.build:gradle:7.2.1' // 对应 compileSdkVersion 32
@@ -59,7 +56,6 @@ allprojects {
                 password 'AKCp8ih1PFG9tV8qaLyws67dLGZi8udFM39SfsHgihN15cgsiRvHuxj8JzFmuZjaViVeNawaA'
             }
         }
-        
         // Nexus Maven 库地址
         // "WinBoLL Release"
         maven { url "https://nexus.winboll.cc/repository/maven-public/" }
@@ -78,9 +74,6 @@ allprojects {
         //println mavenLocal().url
         //println "mavenLocal : ==========="
         //mavenLocal()
-        
-        // WinBoLL.CC 紧急备用 Maven 仓库
-        maven { url 'https://spare-maven.winboll.cc/repository/' }
     }
     ext {
         // 定义全局变量，常用于版本管理

contacts/build.gradle

@@ -18,8 +18,8 @@ def genVersionName(def versionName){
 }
 
 android {
-    compileSdkVersion 32
-    buildToolsVersion "32.0.0"
+    compileSdkVersion 30
+    buildToolsVersion "30.0.3"
 
     defaultConfig {
         applicationId "cc.winboll.studio.contacts"
@@ -66,7 +66,7 @@ dependencies {
     // 应用介绍页类库
     api 'io.github.medyo:android-about-page:2.0.0'
     // 吐司类库
-    api 'com.github.getActivity:ToastUtils:10.5'
+    //api 'com.github.getActivity:ToastUtils:10.5'
     // 网络连接类库
     api 'com.squareup.okhttp3:okhttp:4.4.1'
     

contacts/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Sun Aug 31 06:05:42 CST 2025
-stageCount=17
+#Mon Nov 03 12:01:02 HKT 2025
+stageCount=22
 libraryProject=
 baseVersion=15.3
-publishVersion=15.3.16
+publishVersion=15.3.21
 buildCount=0
-baseBetaVersion=15.3.17
+baseBetaVersion=15.3.22

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

@@ -7,8 +7,8 @@ package cc.winboll.studio.contacts;
  */
 import android.view.Gravity;
 import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import cc.winboll.studio.libappbase.winboll.WinBoLLActivityManager;
-import com.hjq.toast.ToastUtils;
 
 public class App extends GlobalApplication {
 
@@ -30,7 +30,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);
         
     }
 

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

@@ -8,6 +8,7 @@ package cc.winboll.studio.contacts;
 import android.Manifest;
 import android.app.Activity;
 import android.app.ActivityManager;
+import android.app.AlertDialog;
 import android.content.Context;
 import android.content.Intent;
 import android.content.pm.PackageManager;
@@ -38,8 +39,10 @@ import cc.winboll.studio.contacts.fragments.CallLogFragment;
 import cc.winboll.studio.contacts.fragments.ContactsFragment;
 import cc.winboll.studio.contacts.fragments.LogFragment;
 import cc.winboll.studio.contacts.services.MainService;
+import cc.winboll.studio.contacts.utils.AppGoToSettingsUtil;
 import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import cc.winboll.studio.libappbase.winboll.IWinBoLLActivity;
 import com.google.android.material.tabs.TabLayout;
 import java.util.ArrayList;
@@ -48,10 +51,9 @@ import java.util.List;
 final public class MainActivity extends AppCompatActivity implements IWinBoLLActivity, ViewPager.OnPageChangeListener, View.OnClickListener {
 
     public static final String TAG = "MainActivity";
-
     public static final int REQUEST_HOME_ACTIVITY = 0;
     public static final int REQUEST_ABOUT_ACTIVITY = 1;
-
+    public static final int REQUEST_APP_SETTINGS = 2;
     public static final String ACTION_SOS = "cc.winboll.studio.libappbase.WinBoLL.ACTION_SOS";
 
     static MainActivity _MainActivity;
@@ -72,6 +74,13 @@ final public class MainActivity extends AppCompatActivity implements IWinBoLLAct
     List<String> tabTitleList;
 
     private static final int DIALER_REQUEST_CODE = 1;
+    private static final int REQUEST_REQUIRED_PERMISSIONS = 1002;
+    // 关键修改1：新增 READ_CALL_LOG 权限到必需权限列表（解决通话记录读取崩溃）
+    private String[] REQUIRED_PERMISSIONS = new String[]{
+		Manifest.permission.READ_CONTACTS,  // 通讯录读取（原）
+		Manifest.permission.CALL_PHONE,     // 电话拨号（原）
+		Manifest.permission.READ_CALL_LOG   // 通话记录读取（新增，核心修复）
+    };
 
 
     @Override
@@ -88,9 +97,88 @@ final public class MainActivity extends AppCompatActivity implements IWinBoLLAct
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         _MainActivity = this;
+
+        // 优先检查所有必需权限（含新增的 READ_CALL_LOG）
+        if (!checkAllRequiredPermissions()) {
+            requestAllRequiredPermissions();
+        } else {
+            initUIAndLogic(savedInstanceState);
+        }
+		
+		//ToastUtils.show("onCreate");
+    }
+
+    // 权限检查方法（无需修改，自动包含新增的 READ_CALL_LOG）
+    private boolean checkAllRequiredPermissions() {
+        for (String permission : REQUIRED_PERMISSIONS) {
+            if (ActivityCompat.checkSelfPermission(this, permission) 
+				!= PackageManager.PERMISSION_GRANTED) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    // 权限申请方法（无需修改，自动申请新增的 READ_CALL_LOG）
+    private void requestAllRequiredPermissions() {
+        ActivityCompat.requestPermissions(this, REQUIRED_PERMISSIONS, REQUEST_REQUIRED_PERMISSIONS);
+    }
+
+    // 权限结果回调（无需修改，确保所有权限（含 READ_CALL_LOG）都通过才加载UI）
+    @Override
+    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+
+        if (requestCode == REQUEST_REQUIRED_PERMISSIONS) {
+            boolean allPermissionsGranted = true;
+            for (int result : grantResults) {
+                if (result != PackageManager.PERMISSION_GRANTED) {
+                    allPermissionsGranted = false;
+                    break;
+                }
+            }
+
+            if (allPermissionsGranted) {
+                initUIAndLogic(null);
+            } else {
+                // 关键修改2：更新提示文案，告知用户新增的“通话记录权限”
+                showPermissionDeniedDialogAndExit();
+            }
+        }
+    }
+
+    // 核心修改：新增“设置权限”按钮，点击调用 AppGoToSettingsUtil 跳转设置页
+    private void showPermissionDeniedDialogAndExit() {
+        new AlertDialog.Builder(this)
+			.setTitle("权限不足，无法使用")
+			// 文案修改：明确新增“通话记录读取”权限
+			.setMessage("应用需要「通讯录读取」、「电话」和「通话记录读取」权限才能正常运行，请授予权限后重新打开应用。")
+			.setCancelable(false)
+			// 新增：左侧“设置权限”按钮（先添加的按钮在左侧）
+			.setNegativeButton("设置权限", new AlertDialog.OnClickListener() {
+				@Override
+				public void onClick(android.content.DialogInterface dialog, int which) {
+					dialog.dismiss();
+					// 调用工具类跳转应用设置页（按需求实现）
+					AppGoToSettingsUtil appGoToSettingsUtil = new AppGoToSettingsUtil();
+					appGoToSettingsUtil.GoToSetting(MainActivity.this);
+				}
+			})
+			// 原有：右侧“确定退出”按钮（后添加的按钮在右侧）
+			.setPositiveButton("确定退出", new AlertDialog.OnClickListener() {
+				@Override
+				public void onClick(android.content.DialogInterface dialog, int which) {
+					dialog.dismiss();
+					finishAndRemoveTask();
+				}
+			})
+			.show();
+    }
+
+    // 初始化UI和逻辑（无需修改，权限通过后才加载 CallLogFragment）
+    private void initUIAndLogic(Bundle savedInstanceState) {
         setContentView(R.layout.activity_main);
 
-        // 初始化工具栏（仅加载基础UI）
         mToolbar = (Toolbar) findViewById(R.id.activitymainToolbar1);
         setSupportActionBar(mToolbar);
         getSupportActionBar().setSubtitle(TAG);
@@ -98,34 +186,28 @@ final public class MainActivity extends AppCompatActivity implements IWinBoLLAct
         tabLayout = (TabLayout) findViewById(R.id.tabLayout);
         viewPager = (ViewPager) findViewById(R.id.viewPager);
 
-        // 创建Fragment列表（仅实例化，不加载数据）
         fragmentList = new ArrayList<Fragment>();
         tabTitleList = new ArrayList<String>();
+        // CallLogFragment 仅在权限通过后才实例化（避免提前触发读取）
         fragmentList.add(CallLogFragment.newInstance(0));
-        fragmentList.add(ContactsFragment.newInstance(1)); // 延迟加载联系人数据
+        fragmentList.add(ContactsFragment.newInstance(1));
         fragmentList.add(LogFragment.newInstance(2));
         tabTitleList.add("通话记录");
         tabTitleList.add("联系人");
         tabTitleList.add("应用日志");
 
-        // 设置ViewPager适配器
         MyPagerAdapter adapter = new MyPagerAdapter(getSupportFragmentManager(), fragmentList, tabTitleList);
         viewPager.setAdapter(adapter);
-
-        // 关键：关闭预加载，仅当前页初始化
-        viewPager.setOffscreenPageLimit(0);
-
-        // 关联TabLayout和ViewPager
+        viewPager.setOffscreenPageLimit(0); // 关闭预加载，避免提前初始化 CallLogFragment
         tabLayout.setupWithViewPager(viewPager);
 
-        // 初始化服务状态（延迟启动非核心服务）
+        // 原有服务启动、电话监听等逻辑...
         MainServiceBean mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
         if (mMainServiceBean == null) {
             mMainServiceBean = new MainServiceBean();
             MainServiceBean.saveBean(this, mMainServiceBean);
         }
         if (mMainServiceBean.isEnable()) {
-            // 延迟1秒启动服务，避免阻塞启动
             new Handler().postDelayed(new Runnable() {
 					@Override
 					public void run() {
@@ -134,16 +216,14 @@ final public class MainActivity extends AppCompatActivity implements IWinBoLLAct
 				}, 1000);
         }
 
-        // 初始化电话状态监听（基础功能保留）
         telephonyManager = (TelephonyManager) getSystemService(TELEPHONY_SERVICE);
         phoneStateListener = new MyPhoneStateListener();
         telephonyManager.listen(phoneStateListener, PhoneStateListener.LISTEN_CALL_STATE);
     }
 
 
-    // ViewPager适配器（Java 7语法）
+    // 以下为原有代码（无需修改）
     private class MyPagerAdapter extends FragmentPagerAdapter {
-
         private List<Fragment> fragmentList;
         private List<String> tabTitleList;
 
@@ -173,21 +253,18 @@ final public class MainActivity extends AppCompatActivity implements IWinBoLLAct
         Intent intent = new Intent(Intent.ACTION_DIAL);
         intent.setData(android.net.Uri.parse("tel:" + phoneNumber));
         if (ActivityCompat.checkSelfPermission(_MainActivity, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {
+            Toast.makeText(_MainActivity, "拨号权限不足", Toast.LENGTH_SHORT).show();
             return;
         }
         _MainActivity.startActivity(intent);
     }
 
-    // OnPageChangeListener接口实现
     @Override
     public void onPageScrollStateChanged(int state) {}
-
     @Override
     public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {}
-
     @Override
     public void onPageSelected(int position) {}
-
     @Override
     public void onClick(View v) {}
 
@@ -239,9 +316,6 @@ final public class MainActivity extends AppCompatActivity implements IWinBoLLAct
         super.onResume();
     }
 
-    /**
-     * 检查是否是系统默认电话应用
-     */
     public boolean isDefaultPhoneCallApp() {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
             TelecomManager manger = (TelecomManager) getSystemService(TELECOM_SERVICE);
@@ -272,7 +346,9 @@ final public class MainActivity extends AppCompatActivity implements IWinBoLLAct
                 Toast.makeText(MainActivity.this, getString(R.string.app_name) + " 已成为默认电话应用",
 							   Toast.LENGTH_SHORT).show();
             }
-        }
+        } else if (requestCode == REQUEST_APP_SETTINGS) {
+			recreate();
+		}
     }
 }
 

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

@@ -36,8 +36,8 @@ import cc.winboll.studio.contacts.dun.Rules;
 import cc.winboll.studio.contacts.services.MainService;
 import cc.winboll.studio.contacts.views.DuInfoTextView;
 import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import cc.winboll.studio.libappbase.winboll.IWinBoLLActivity;
-import com.hjq.toast.ToastUtils;
 import java.lang.reflect.Field;
 import java.util.List;
 
@@ -263,7 +263,7 @@ public class SettingsActivity extends AppCompatActivity implements IWinBoLLActiv
                 @Override
                 public void run() {
                     if (tomCat.downloadBoBullToon()) {
-                        ToastUtils.show("BoBullToon downlaod OK!");
+						LogUtils.d(TAG, "BoBullToon downlaod OK!");
                         MainService.restartMainService(SettingsActivity.this);
                         Rules.getInstance(SettingsActivity.this).reload();
                     }

contacts/src/main/java/cc/winboll/studio/contacts/adapters/CallLogAdapter.java

@@ -23,7 +23,7 @@ import cc.winboll.studio.contacts.R;
 import cc.winboll.studio.contacts.beans.CallLogModel;
 import cc.winboll.studio.contacts.utils.ContactUtils;
 import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import java.text.SimpleDateFormat;
 import java.util.List;
 import java.util.Locale;
@@ -76,6 +76,9 @@ public class CallLogAdapter extends RecyclerView.Adapter<CallLogAdapter.CallLogV
 									// Set the clipboard's primary clip.
 									clipboard.setPrimaryClip(clip);
 									Toast.makeText(mContext, "Copy to clipboard.", Toast.LENGTH_SHORT).show();
+								} else if (nItemId == R.id.item_calllog_phonenumber_add_contact) {
+									//ToastUtils.show(callLog.getPhoneNumber());
+									ContactUtils.jumpToAddContact(mContext, callLog.getPhoneNumber());
 								}
 
 								return true;

contacts/src/main/java/cc/winboll/studio/contacts/adapters/ContactAdapter.java

@@ -21,8 +21,9 @@ import androidx.annotation.NonNull;
 import androidx.recyclerview.widget.RecyclerView;
 import cc.winboll.studio.contacts.R;
 import cc.winboll.studio.contacts.beans.ContactModel;
+import cc.winboll.studio.contacts.utils.ContactUtils;
 import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import java.util.List;
 
 public class ContactAdapter extends RecyclerView.Adapter<ContactAdapter.ContactViewHolder> {
@@ -69,6 +70,11 @@ public class ContactAdapter extends RecyclerView.Adapter<ContactAdapter.ContactV
 									// Set the clipboard's primary clip.
 									clipboard.setPrimaryClip(clip);
 									Toast.makeText(mContext, "Copy to clipboard.", Toast.LENGTH_SHORT).show();
+								} else if (nItemId == R.id.item_calllog_phonenumber_edit_contact) {
+									//ToastUtils.show("Test");
+									Long nContactId = ContactUtils.getContactIdByPhone(mContext, contact.getNumber());
+									//ToastUtils.show(String.format("%d", nContactId));
+									ContactUtils.jumpToEditContact(mContext, contact.getNumber(), nContactId);
 								}
 
 								return true;
@@ -112,7 +118,7 @@ public class ContactAdapter extends RecyclerView.Adapter<ContactAdapter.ContactV
         TextView contactName;
         TextView contactNumber;
         AOHPCTCSeekBar dialAOHPCTCSeekBar;
-        
+
         public ContactViewHolder(@NonNull View itemView) {
             super(itemView);
 			llPhoneNumberMain = itemView.findViewById(R.id.itemcontactLinearLayout1);

contacts/src/main/java/cc/winboll/studio/contacts/adapters/PhoneConnectRuleAdapter.java

@@ -7,7 +7,6 @@ package cc.winboll.studio.contacts.adapters;
  */
 import android.content.Context;
 import android.view.LayoutInflater;
-import android.view.MotionEvent;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.Button;
@@ -21,9 +20,8 @@ import cc.winboll.studio.contacts.R;
 import cc.winboll.studio.contacts.beans.PhoneConnectRuleModel;
 import cc.winboll.studio.contacts.dun.Rules;
 import cc.winboll.studio.contacts.views.LeftScrollView;
-import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.dialogs.YesNoAlertDialog;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import java.util.ArrayList;
 import java.util.List;
 

contacts/src/main/java/cc/winboll/studio/contacts/bobulltoon/TomCat.java

@@ -9,7 +9,7 @@ import android.content.Context;
 import cc.winboll.studio.contacts.R;
 import cc.winboll.studio.contacts.dun.Rules;
 import cc.winboll.studio.libappbase.LogUtils;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import java.io.File;
 import java.io.FileFilter;
 import java.io.FileOutputStream;

contacts/src/main/java/cc/winboll/studio/contacts/fragments/CallLogFragment.java

@@ -25,7 +25,6 @@ import androidx.recyclerview.widget.RecyclerView;
 import cc.winboll.studio.contacts.R;
 import cc.winboll.studio.contacts.adapters.CallLogAdapter;
 import cc.winboll.studio.contacts.beans.CallLogModel;
-import com.hjq.toast.ToastUtils;
 import java.util.ArrayList;
 import java.util.Date;
 import java.util.List;
@@ -161,7 +160,7 @@ public class CallLogFragment extends Fragment {
             _CallLogFragment.triggerUpdate();
         }
     }
-	
+
 	@Override
 	public void onResume() {
 		super.onResume();

contacts/src/main/java/cc/winboll/studio/contacts/fragments/ContactsFragment.java

@@ -31,7 +31,7 @@ import cc.winboll.studio.contacts.R;
 import cc.winboll.studio.contacts.adapters.ContactAdapter;
 import cc.winboll.studio.contacts.beans.ContactModel;
 import cc.winboll.studio.libappbase.LogUtils;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.concurrent.ExecutorService;
@@ -95,7 +95,7 @@ public class ContactsFragment extends Fragment {
         recyclerView = (RecyclerView) view.findViewById(R.id.contacts_recycler_view);
         recyclerView.setLayoutManager(new LinearLayoutManager(getContext()));
         contactList = new ArrayList<ContactModel>();
-        contactAdapter = new ContactAdapter(getContext(), contactList);
+        contactAdapter = new ContactAdapter(getActivity(), contactList);
         recyclerView.setAdapter(contactAdapter);
         // 初始隐藏列表，数据加载后显示
         recyclerView.setVisibility(View.GONE);

contacts/src/main/java/cc/winboll/studio/contacts/fragments/LogFragment.java

@@ -14,7 +14,6 @@ import androidx.annotation.Nullable;
 import androidx.fragment.app.Fragment;
 import cc.winboll.studio.contacts.R;
 import cc.winboll.studio.libappbase.LogView;
-import com.hjq.toast.ToastUtils;
 
 public class LogFragment extends Fragment {
 

contacts/src/main/java/cc/winboll/studio/contacts/receivers/MainReceiver.java

@@ -10,7 +10,7 @@ import android.content.Context;
 import android.content.Intent;
 import android.content.IntentFilter;
 import cc.winboll.studio.contacts.services.MainService;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import java.lang.ref.WeakReference;
 
 public class MainReceiver extends BroadcastReceiver {

contacts/src/main/java/cc/winboll/studio/contacts/utils/AppGoToSettingsUtil.java

@@ -0,0 +1,270 @@
+package cc.winboll.studio.contacts.utils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/27 14:27
+ * @Describe 调用应用属性设置页工具类
+ *  来源：https://blog.csdn.net/zhuhai__yizhi/article/details/78737593
+ *  Created by zyy on 2018/3/12.
+ *  直接跳转到权限后返回，可以监控权限授权情况，但是，跳转到应用详情页，无法监测权限情况
+ *  是否要加以区分，若是应用详情页，则跳转回来后，onRestart检测所求权限，如果授权，则收回提示，如果没授权，则继续提示
+ */
+import android.app.Activity;
+import android.content.ComponentName;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.Settings;
+import cc.winboll.studio.contacts.MainActivity;
+
+public class AppGoToSettingsUtil {
+
+    public static final String TAG = "AppGoToSettingsUtil";
+
+    public static final int ACTIVITY_RESULT_APP_SETTINGS = MainActivity.REQUEST_APP_SETTINGS;
+
+    /**
+     * Build.MANUFACTURER判断各大手机厂商品牌
+     */
+    private static final String MANUFACTURER_HUAWEI = "Huawei";//华为
+    private static final String MANUFACTURER_MEIZU = "Meizu";//魅族
+    private static final String MANUFACTURER_XIAOMI = "Xiaomi";//小米
+    private static final String MANUFACTURER_SONY = "Sony";//索尼
+    private static final String MANUFACTURER_OPPO = "OPPO";
+    private static final String MANUFACTURER_LG = "LG";
+    private static final String MANUFACTURER_VIVO = "vivo";
+    private static final String MANUFACTURER_SAMSUNG = "samsung";//三星
+    private static final String MANUFACTURER_LETV = "Letv";//乐视
+    private static final String MANUFACTURER_ZTE = "ZTE";//中兴
+    private static final String MANUFACTURER_YULONG = "YuLong";//酷派
+    private static final String MANUFACTURER_LENOVO = "LENOVO";//联想
+
+    public static boolean isAppSettingOpen=false;
+    /**
+     * 跳转到相应品牌手机系统权限设置页，如果跳转不成功，则跳转到应用详情页
+     * 这里需要改造成返回true或者false，应用详情页:true，应用权限页:false
+     * @param activity
+     */
+    public static void GoToSetting(Activity activity) {
+        switch (Build.MANUFACTURER) {
+            case MANUFACTURER_HUAWEI://华为
+                Huawei(activity);
+                break;
+            case MANUFACTURER_MEIZU://魅族
+                Meizu(activity);
+                break;
+            case MANUFACTURER_XIAOMI://小米
+                Xiaomi(activity);
+                break;
+            case MANUFACTURER_SONY://索尼
+                Sony(activity);
+                break;
+            case MANUFACTURER_OPPO://oppo
+                OPPO(activity);
+                break;
+            case MANUFACTURER_LG://lg
+                LG(activity);
+                break;
+            case MANUFACTURER_LETV://乐视
+                Letv(activity);
+                break;
+            default://其他
+                try {//防止应用详情页也找不到，捕获异常后跳转到设置，这里跳转最好是两级，太多用户也会觉得麻烦，还不如不跳
+                    openAppDetailSetting(activity);
+                    //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+                } catch (Exception e) {
+                    SystemConfig(activity);
+                }
+                break;
+        }
+    }
+
+    /**
+     * 华为跳转权限设置页
+     * @param activity
+     */
+    public static void Huawei(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.huawei.systemmanager", "com.huawei.permissionmanager.ui.MainActivity");
+            intent.setComponent(comp);
+            activity.startActivityForResult(intent, ACTIVITY_RESULT_APP_SETTINGS);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 魅族跳转权限设置页，测试时，点击无反应，具体原因不明
+     * @param activity
+     */
+    public static void Meizu(Activity activity) {
+        try {
+            Intent intent = new Intent("com.meizu.safe.security.SHOW_APPSEC");
+            intent.addCategory(Intent.CATEGORY_DEFAULT);
+            intent.putExtra("packageName", activity.getPackageName());
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 小米，功能正常
+     * @param activity
+     */
+    public static void Xiaomi(Activity activity) {
+        try { //MIUI 8 9
+            Intent localIntent = new Intent("miui.intent.action.APP_PERM_EDITOR");
+            localIntent.setClassName("com.miui.securitycenter", "com.miui.permcenter.permissions.PermissionsEditorActivity");
+            localIntent.putExtra("extra_pkgname", activity.getPackageName());
+            activity.startActivityForResult(localIntent, ACTIVITY_RESULT_APP_SETTINGS);
+            isAppSettingOpen = false;
+            //activity.startActivity(localIntent);
+        } catch (Exception e) {
+            try { //MIUI 5/6/7
+                Intent localIntent = new Intent("miui.intent.action.APP_PERM_EDITOR");
+                localIntent.setClassName("com.miui.securitycenter", "com.miui.permcenter.permissions.AppPermissionsEditorActivity");
+                localIntent.putExtra("extra_pkgname", activity.getPackageName());
+                activity.startActivityForResult(localIntent, ACTIVITY_RESULT_APP_SETTINGS);
+                isAppSettingOpen = false;
+                //activity.startActivity(localIntent);
+            } catch (Exception e1) { //否则跳转到应用详情
+                openAppDetailSetting(activity);
+                //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+                //这里有个问题，进入活动后需要再跳一级活动，就检测不到返回结果
+                //activity.startActivity(getAppDetailSettingIntent());
+            }
+        }
+    }
+
+    /**
+     * 索尼，6.0以上的手机非常少，基本没看见
+     * @param activity
+     */
+    public static void Sony(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.sonymobile.cta", "com.sonymobile.cta.SomcCTAMainActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * OPPO
+     * @param activity
+     */
+    public static void OPPO(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.color.safecenter", "com.color.safecenter.permission.PermissionManagerActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * LG经过测试，正常使用
+     * @param activity
+     */
+    public static void LG(Activity activity) {
+        try {
+            Intent intent = new Intent("android.intent.action.MAIN");
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.android.settings", "com.android.settings.Settings$AccessLockSummaryActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 乐视6.0以上很少，基本都可以忽略了，现在乐视手机不多
+     * @param activity
+     */
+    public static void Letv(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.letv.android.letvsafe", "com.letv.android.letvsafe.PermissionAndApps");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 只能打开到自带安全软件
+     * @param activity
+     */
+    public static void _360(Activity activity) {
+        try {
+            Intent intent = new Intent("android.intent.action.MAIN");
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.qihoo360.mobilesafe", "com.qihoo360.mobilesafe.ui.index.AppEnterActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+    /**
+     * 系统设置界面
+     * @param activity
+     */
+    public static void SystemConfig(Activity activity) {
+        Intent intent = new Intent(Settings.ACTION_SETTINGS);
+        activity.startActivity(intent);
+    }
+    /**
+     * 获取应用详情页面
+     * @return
+     */
+    private static Intent getAppDetailSettingIntent(Activity activity) {
+        Intent localIntent = new Intent();
+        localIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        //if (Build.VERSION.SDK_INT >= 9) {
+        localIntent.setAction("android.settings.APPLICATION_DETAILS_SETTINGS");
+        localIntent.setData(Uri.fromParts("package", activity.getPackageName(), null));
+        /*} else if (Build.VERSION.SDK_INT <= 8) {
+         localIntent.setAction(Intent.ACTION_VIEW);
+         localIntent.setClassName("com.android.settings", "com.android.settings.InstalledAppDetails");
+         localIntent.putExtra("com.android.settings.ApplicationPkgName", activity.getPackageName());
+         }*/
+        return localIntent;
+    }
+
+    public static void openAppDetailSetting(Activity activity) {
+        activity.startActivityForResult(getAppDetailSettingIntent(activity), ACTIVITY_RESULT_APP_SETTINGS);
+        isAppSettingOpen = true;
+    }
+}

contacts/src/main/java/cc/winboll/studio/contacts/utils/ContactUtils.java

@@ -6,10 +6,14 @@ package cc.winboll.studio.contacts.utils;
  * @Describe 联系人工具集
  */
 import android.content.ContentResolver;
+import android.content.ContentUris;
 import android.content.Context;
+import android.content.Intent;
 import android.database.Cursor;
+import android.net.Uri;
 import android.provider.ContactsContract;
 import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 import java.util.HashMap;
 import java.util.Map;
 
@@ -120,4 +124,92 @@ public class ContactUtils {
         }
         return sbSpaceNumber.toString();
     }
+
+
+	/**
+	 * 跳转至系统添加联系人界面的工具函数
+	 * @param context 上下文（如 PhoneCallService、Activity、Fragment 均可，需传入有效上下文）
+	 * @param phoneNumber 可选参数：预填的联系人电话（传 null 则跳转空表单）
+	 */
+	public static void jumpToAddContact(Context mContext, String phoneNumber) {
+		Intent intent = new Intent(Intent.ACTION_INSERT);
+		intent.setType("vnd.android.cursor.dir/person");
+		intent.putExtra(android.provider.ContactsContract.Intents.Insert.PHONE, phoneNumber);
+		mContext.startActivity(intent);
+	}
+
+	/**
+	 * 跳转至系统编辑联系人界面（适配小米等定制机型）
+	 * @param context 上下文（Activity/Service/Fragment）
+	 * @param phoneNumber 待编辑联系人的电话号码（用于匹配已有联系人，必传）
+	 * @param contactId 可选：已有联系人的ID（通过 ContactsContract 获取，传null则自动匹配号码）
+	 */
+	public static void jumpToEditContact(Context context, String phoneNumber, Long contactId) {
+		Intent intent = new Intent(Intent.ACTION_EDIT);
+		// 关键：小米等机型需明确设置数据类型为“单个联系人”，避免参数丢失
+		intent.setType(ContactsContract.Contacts.CONTENT_ITEM_TYPE);
+
+		// 场景A：已知联系人ID（精准定位，优先用此方式，参数传递最稳定）
+		if (contactId != null && contactId > 0) {
+			// 构建联系人的Uri（格式：content://contacts/people/[contactId]，系统标准格式）
+			Uri contactUri = ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI, contactId);
+			intent.setData(contactUri);
+			//ToastUtils.show("1");
+		} else if (phoneNumber != null && !phoneNumber.isEmpty()) {
+			// 方式1：小米等机型兼容的“通过号码定位联系人”参数（部分系统认此参数）
+			//intent.putExtra(ContactsContract.Intents.Insert.PHONE_NUMBER, phoneNumber);
+			// 方式2：补充系统标准的“数据Uri”，强化匹配（避免参数被定制系统忽略）
+			Uri phoneUri = Uri.withAppendedPath(ContactsContract.CommonDataKinds.Phone.CONTENT_FILTER_URI, Uri.encode(phoneNumber));
+			intent.setData(phoneUri);
+		} else {
+			LogUtils.d(TAG, "编辑联系人失败：电话号码和联系人ID均为空");
+			return;
+		}
+
+		// 可选：预填最新号码（覆盖原有号码，若用户修改了号码，编辑时自动更新）
+		if (phoneNumber != null && !phoneNumber.isEmpty()) {
+			intent.putExtra(ContactsContract.CommonDataKinds.Phone.NUMBER, phoneNumber);
+			intent.putExtra(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE);
+		}
+
+		// 启动活动（加防护，避免无联系人应用崩溃）
+		// 小米机型在Service/非Activity中调用，需加NEW_TASK标志，否则可能无法启动
+		intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+		context.startActivity(intent);
+	}
+
+	/**
+	 * 通过电话号码查询联系人ID（适配小米机型，解决编辑时匹配不稳定问题）
+	 * @param context 上下文
+	 * @param phoneNumber 待查询的电话号码
+	 * @return 联系人ID（无匹配时返回-1）
+	 */
+	public static Long getContactIdByPhone(Context context, String phoneNumber) {
+		if (phoneNumber == null || phoneNumber.isEmpty()) {
+			return -1L;
+		}
+
+		ContentResolver cr = context.getContentResolver();
+		// 1. 构建电话查询Uri（系统标准：通过号码过滤联系人数据）
+		Uri queryUri = Uri.withAppendedPath(ContactsContract.CommonDataKinds.Phone.CONTENT_FILTER_URI, Uri.encode(phoneNumber));
+		// 2. 只查询“联系人ID”字段（高效，避免冗余数据）
+		String[] projection = {ContactsContract.CommonDataKinds.Phone.CONTACT_ID};
+		Cursor cursor = null;
+
+		try {
+			cursor = cr.query(queryUri, projection, null, null, null);
+			if (cursor != null && cursor.moveToFirst()) {
+				// 3. 读取联系人ID（返回Long类型，避免int溢出）
+				return cursor.getLong(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.CONTACT_ID));
+			}
+		} catch (Exception e) {
+			LogUtils.d(TAG, "查询联系人ID失败。" + e);
+		} finally {
+			if (cursor != null) {
+				cursor.close(); // 关闭游标，避免内存泄漏
+			}
+		}
+		return -1L; // 无匹配联系人
+	}
+
 }

contacts/src/main/java/cc/winboll/studio/contacts/widgets/APPStatusWidget.java

@@ -13,9 +13,8 @@ import android.content.Context;
 import android.content.Intent;
 import android.widget.RemoteViews;
 import cc.winboll.studio.contacts.R;
-import cc.winboll.studio.contacts.threads.MainServiceThread;
 import cc.winboll.studio.libappbase.LogUtils;
-import com.hjq.toast.ToastUtils;
+import cc.winboll.studio.libappbase.utils.ToastUtils;
 
 public class APPStatusWidget extends AppWidgetProvider {
 

contacts/src/main/res/menu/toolbar_calllog_phonenumber.xml

@@ -5,5 +5,8 @@
     <item
         android:id="@+id/item_calllog_phonenumber_copy"
         android:title="Copy"/>
+    <item
+        android:id="@+id/item_calllog_phonenumber_add_contact"
+        android:title="Add Contact"/>
     
 </menu>

contacts/src/main/res/menu/toolbar_contact_phonenumber.xml

@@ -5,5 +5,8 @@
     <item
         android:id="@+id/item_contact_phonenumber_copy"
         android:title="Copy"/>
+    <item
+        android:id="@+id/item_calllog_phonenumber_edit_contact"
+        android:title="Edit Contact"/>
     
 </menu>

libaes/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Thu Nov 27 19:18:42 HKT 2025
-stageCount=9
+#Wed Nov 26 15:54:26 GMT 2025
+stageCount=7
 libraryProject=libaes
 baseVersion=15.11
-publishVersion=15.11.8
-buildCount=0
-baseBetaVersion=15.11.9
+publishVersion=15.11.6
+buildCount=32
+baseBetaVersion=15.11.7

libaes/src/main/java/cc/winboll/studio/libaes/enums/PrivacyAgreeStatus.java

@@ -1,67 +0,0 @@
-package cc.winboll.studio.libaes.enums;
-
-/**
- * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
- * @Date 2025/11/27 12:35
- * @Describe 隐私协议签约状态枚举
- * 对应值：0-拒绝，1-赞同，2-未签约（默认）
- */
-public enum PrivacyAgreeStatus {
-	REJECTED(0, "拒绝"),      // 0: 拒绝隐私协议
-	AGREED(1, "赞同"),        // 1: 赞同隐私协议
-	UN_SIGNED(2, "未签约");   // 2: 未签约（初始默认状态）
-
-	private final int statusCode;  // 对应存储的int值
-	private final String statusDesc; // 状态描述（可选，便于日志/UI显示）
-
-	// Java 7 枚举构造方法（必须private）
-	private PrivacyAgreeStatus(int statusCode, String statusDesc) {
-		this.statusCode = statusCode;
-		this.statusDesc = statusDesc;
-	}
-
-	/**
-	 * 根据int值获取枚举（SP读取时使用，兼容Java 7）
-	 * @param code 存储的int值（0/1/2）
-	 * @return 对应枚举，默认返回UN_SIGNED（未签约）
-	 */
-	public static PrivacyAgreeStatus fromCode(int code) {
-		// Java 7 不支持switch(String)，用if-else兼容
-		if (code == REJECTED.statusCode) {
-			return REJECTED;
-		} else if (code == AGREED.statusCode) {
-			return AGREED;
-		} else {
-			return UN_SIGNED; // 默认未签约
-		}
-	}
-
-	/**
-	 * 根据SP存储的字符串值获取枚举（兼容原逻辑中String类型存储）
-	 * @param codeStr 存储的字符串值（"0"/"1"/"2"）
-	 * @return 对应枚举，默认返回UN_SIGNED（未签约）
-	 */
-	public static PrivacyAgreeStatus fromString(String codeStr) {
-		if (codeStr == null) {
-			return UN_SIGNED;
-		}
-		try {
-			int code = Integer.parseInt(codeStr);
-			return fromCode(code);
-		} catch (NumberFormatException e) {
-			// 字符串格式异常时，默认返回未签约
-			return UN_SIGNED;
-		}
-	}
-
-	// 获取状态码（用于存储到SP）
-	public int getStatusCode() {
-		return statusCode;
-	}
-
-	// 获取状态描述（用于日志/UI显示，可选）
-	public String getStatusDesc() {
-		return statusDesc;
-	}
-}
-

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

@@ -2,19 +2,27 @@ 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.enums.ADsMode;
 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;
@@ -22,6 +30,8 @@ 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;
+import cc.winboll.studio.libaes.enums.ADsMode;
 
 /**
  * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
@@ -74,8 +84,9 @@ public class ADsBannerView extends LinearLayout {
 
 	void initView(Context context) {
 		this.mContext = context;
+		
 		initMimoSdk(this.mContext);
-
+		
 		// 初始化主线程Handler（关键：确保广告操作在主线程执行）
 		mMainHandler = new Handler(Looper.getMainLooper());
 
@@ -87,13 +98,9 @@ public class ADsBannerView extends LinearLayout {
 	public void resumeADs(final Activity activity) {
 		// 没有设置米盟广告支持就退出
 		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
-			// 2. 释放之前的广告资源
-			if (mBannerAd != null) {
-				mBannerAd.destroy();
-			}
 			return;
 		}
-
+		
 		// 修复：优化广告请求逻辑（添加生命周期判断 + 主线程执行）
 		if (activity != null && !activity.isFinishing() && !activity.isDestroyed()) {
 			if (ADsControlView.getAdsModeFromStatic(this.mContext) == ADsMode.MIMO_SDK) {
@@ -119,7 +126,7 @@ public class ADsBannerView extends LinearLayout {
 		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
 			return;
 		}
-
+		
         LogUtils.d(TAG, "releaseAdResources()");
 
         // 移除Handler回调
@@ -152,7 +159,7 @@ public class ADsBannerView extends LinearLayout {
 		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
 			return;
 		}
-
+		
         LogUtils.d(TAG, "showAd()");
         // 1. 生命周期校验：避免Activity已销毁时操作UI
         if (activity == null || activity.isFinishing() || activity.isDestroyed()) {
@@ -220,7 +227,7 @@ public class ADsBannerView extends LinearLayout {
 		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
 			return;
 		}
-
+		
         LogUtils.d(TAG, "fetchAd()");
         // 1. 双重校验：Activity未销毁 + Context非空
         if (activity == null || activity.isFinishing() || activity.isDestroyed() || activity.getApplicationContext() == null) {
@@ -318,7 +325,7 @@ public class ADsBannerView extends LinearLayout {
 		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
 			return;
 		}
-
+		
 		// 修复：加载失败时移除当前广告实例
 		if (mAllBanners.contains(mBannerAd)) {
 			mAllBanners.remove(mBannerAd);

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

@@ -2,39 +2,31 @@ package cc.winboll.studio.libaes.views;
 
 import android.app.Activity;
 import android.content.Context;
-import android.content.Intent;
+import android.content.DialogInterface;
 import android.content.SharedPreferences;
-import android.net.Uri;
 import android.os.Handler;
 import android.os.Looper;
 import android.os.Message;
 import android.text.TextUtils;
-import android.text.method.LinkMovementMethod;
 import android.util.AttributeSet;
 import android.view.Display;
 import android.view.Gravity;
 import android.view.LayoutInflater;
-import android.view.View;
-import android.view.View.OnClickListener;
 import android.view.Window;
 import android.view.WindowManager;
-import android.widget.Button;
 import android.widget.LinearLayout;
 import android.widget.RadioButton;
 import android.widget.RadioGroup;
-import android.widget.TextView;
 import android.widget.Toast;
 import androidx.appcompat.app.AlertDialog;
 import cc.winboll.studio.libaes.R;
 import cc.winboll.studio.libaes.enums.ADsMode;
-import cc.winboll.studio.libaes.enums.PrivacyAgreeStatus;
 import cc.winboll.studio.libaes.views.ADsControlView;
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.ToastUtils;
 import com.miui.zeus.mimo.sdk.MimoCustomController;
 import com.miui.zeus.mimo.sdk.MimoLocation;
 import com.miui.zeus.mimo.sdk.MimoSdk;
-import android.text.Html;
+import cc.winboll.studio.libappbase.ToastUtils;
 
 /**
  * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
@@ -45,7 +37,7 @@ import android.text.Html;
 public class ADsControlView extends LinearLayout {
 	public static final String TAG = "ADsControlView";
 
-
+	
     // SP存储配置
     private static final String SP_NAME = "ads_control_config";
     private static final String KEY_SELECTED_MODE = "selected_ads_mode";
@@ -53,15 +45,15 @@ public class ADsControlView extends LinearLayout {
 	ADsMode mADsMode;
     private static final String PRIVACY_VALUE = "privacy_value";
 	// 隐私协议签约结果 0: 拒绝，1：赞同 2: 未签约
-	PrivacyAgreeStatus mPrivacyAgreeStatus;
+	String privacyAgreeValue;
 
     // Handler消息标识
     private static final int MSG_UPDATE_MODE = 1001;
 
     // 控件引用
-    private RadioGroup rgADsMode;
+    private RadioGroup rgAdsMode;
     private RadioButton rbStandalone;
-    private RadioButton rbMimoSDK;
+    private RadioButton rbMimoSdk;
 
     // 外部监听、SP实例、Handler实例
     private OnAdsModeSelectedListener listener;
@@ -89,15 +81,13 @@ public class ADsControlView extends LinearLayout {
         initView(context);
     }
 
-	public void setPrivacyAgreeStatus(PrivacyAgreeStatus privacyAgreeStatus) {
-		this.mPrivacyAgreeStatus = privacyAgreeStatus;
-		sharedPreferences.edit().putString(PRIVACY_VALUE, this.mPrivacyAgreeStatus.name()).apply();
+	public void setPrivacyAgreeValue(String privacyAgreeValue) {
+		this.privacyAgreeValue = privacyAgreeValue;
 	}
 
-	public PrivacyAgreeStatus getPrivacyAgreeStatus() {
-        String privacyAgreeStatusStr = sharedPreferences.getString(PRIVACY_VALUE, PrivacyAgreeStatus.UN_SIGNED.name());
-		PrivacyAgreeStatus privacyAgreeStatus = PrivacyAgreeStatus.fromString(privacyAgreeStatusStr);
-		return privacyAgreeStatus;
+	public String getPrivacyAgreeValue() {
+        String privacyAgreeValue = sharedPreferences.getString(PRIVACY_VALUE, "0");
+		return privacyAgreeValue;
 	}
 
 	public void setADsMode(ADsMode mADsMode) {
@@ -123,9 +113,9 @@ public class ADsControlView extends LinearLayout {
         sharedPreferences = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
 
         // 绑定控件
-        rgADsMode = (RadioGroup) findViewById(R.id.rg_ads_mode);
+        rgAdsMode = (RadioGroup) findViewById(R.id.rg_ads_mode);
         rbStandalone = (RadioButton) findViewById(R.id.rb_standalone);
-        rbMimoSDK = (RadioButton) findViewById(R.id.rb_mimo_sdk);
+        rbMimoSdk = (RadioButton) findViewById(R.id.rb_mimo_sdk);
 
         // 初始化Handler（主线程Looper）
         mHandler = new InternalHandler(Looper.getMainLooper());
@@ -134,27 +124,25 @@ public class ADsControlView extends LinearLayout {
         registerControlView(this);
 
         // 从SP读取初始模式并设置
-		//ToastUtils.show(String.format("savedMode : %s", getADsMode().name()));
+		ToastUtils.show(String.format("savedMode : %s", getADsMode().name()));
         setSelectedMode(getADsMode());
 
         // 单选组选择事件监听
-        rgADsMode.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
+        rgAdsMode.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
 				@Override
 				public void onCheckedChanged(RadioGroup group, int checkedId) {
 					if (checkedId == R.id.rb_standalone) {
 						setADsMode(ADsMode.STANDALONE);
 					} else if (checkedId == R.id.rb_mimo_sdk) {
-						handlePrivacyLogic((Activity)context, PrivacyAgreeStatus.UN_SIGNED , new OnPrivacyChangeListener(){
+						showPrivacy(context, new OnPrivacyChangeListener(){
 								@Override
 								public void onAgreePrivacy() {
 									setADsMode(ADsMode.MIMO_SDK);
-									setSelectedMode(ADsMode.MIMO_SDK);
 								}
 
 								@Override
 								public void onDisagreePrivacy() {
 									setADsMode(ADsMode.STANDALONE);
-									setSelectedMode(ADsMode.STANDALONE);
 								}
 							});
 					}
@@ -166,29 +154,31 @@ public class ADsControlView extends LinearLayout {
      * 【静态】显示隐私协议弹窗（供外部调用，带Context参数）
      * @param context 上下文（需传入Activity Context，用于弹窗显示）
      */
-//    public void showPrivacy(OnPrivacyChangeListener onPrivacyChangeListener) {
-//        if (context == null) {
-//            LogUtils.e(TAG, "showPrivacy: Context is null, cannot show privacy dialog");
-//            return;
-//        }
-//        // 校验是否为Activity Context（弹窗必须依附Activity）
-//        Activity activity = null;
-//        try {
-//            activity = (Activity) context;
-//        } catch (ClassCastException e) {
-//            LogUtils.e(TAG, "showPrivacy: Context is not Activity Context", e);
-//            Toast.makeText(context.getApplicationContext(), "请传入Activity上下文以显示隐私协议", Toast.LENGTH_SHORT).show();
-//            return;
-//        }
-//        // 校验Activity状态
-//        if (activity.isFinishing() || activity.isDestroyed()) {
-//            LogUtils.e(TAG, "showPrivacy: Activity is finishing or destroyed");
-//            return;
-//        }
-//
-//        // 读取隐私协议状态并处理逻辑
-//        handlePrivacyLogic(activity, getPrivacyAgreeStatus(), onPrivacyChangeListener);
-//    }
+    public static void showPrivacy(Context context, OnPrivacyChangeListener onPrivacyChangeListener) {
+        if (context == null) {
+            LogUtils.e(TAG, "showPrivacy: Context is null, cannot show privacy dialog");
+            return;
+        }
+        // 校验是否为Activity Context（弹窗必须依附Activity）
+        Activity activity = null;
+        try {
+            activity = (Activity) context;
+        } catch (ClassCastException e) {
+            LogUtils.e(TAG, "showPrivacy: Context is not Activity Context", e);
+            Toast.makeText(context.getApplicationContext(), "请传入Activity上下文以显示隐私协议", Toast.LENGTH_SHORT).show();
+            return;
+        }
+        // 校验Activity状态
+        if (activity.isFinishing() || activity.isDestroyed()) {
+            LogUtils.e(TAG, "showPrivacy: Activity is finishing or destroyed");
+            return;
+        }
+		
+        // 读取隐私协议状态并处理逻辑
+        SbhhharedPreferences sp = getPrivacySharedPreferences(context);
+        String privacyAgreeValue = sp.getString(PRIVACY_VALUE, null);
+        handlePrivacyLogic(activity, privacyAgreeValue, onPrivacyChangeListener);
+    }
 
     /**
      * 【静态】清理SP中存储的隐私协议状态（PRIVACY_VALUE）
@@ -214,30 +204,52 @@ public class ADsControlView extends LinearLayout {
         // 使用ApplicationContext获取SP，避免内存泄漏
         Context appContext = context.getApplicationContext();
         if (appContext != null) {
-            return appContext.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+            return appContext.getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
         }
         // 降级方案：若ApplicationContext为空，使用传入的Context
-        return context.getSharedPreferences(PRIVACY_VALUE, Context.MODE_PRIVATE);
+        return context.getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
     }
 
     // 【配套静态工具方法】隐私协议逻辑处理（供上述两个静态方法调用，需一并添加）
-    private static void handlePrivacyLogic(final Activity activity, PrivacyAgreeStatus privacyAgreeStatus, final OnPrivacyChangeListener onPrivacyChangeListener) {
-        if (privacyAgreeStatus == PrivacyAgreeStatus.REJECTED) {
-            //ADsControlView.updateAdsModeByStatic(activity.getApplicationContext(), ADsMode.STANDALONE);
+    private static void handlePrivacyLogic(final Activity activity, String privacyAgreeValue, final OnPrivacyChangeListener onPrivacyChangeListener) {
+        if (TextUtils.equals(privacyAgreeValue, String.valueOf(0))) {
+            ADsControlView.updateAdsModeByStatic(activity.getApplicationContext(), ADsMode.STANDALONE);
             LogUtils.i(TAG, "已拒绝隐私协议，广告已处于不可用状态...");
             Toast.makeText(activity.getApplicationContext(), "已拒绝隐私协议，广告已处于不可用状态", Toast.LENGTH_SHORT).show();
             return;
-        } else if (privacyAgreeStatus == PrivacyAgreeStatus.AGREED) {
-            //ADsControlView.updateAdsModeByStatic(activity.getApplicationContext(), ADsMode.MIMO_SDK);
+        } else if (TextUtils.equals(privacyAgreeValue, String.valueOf(1))) {
+            ADsControlView.updateAdsModeByStatic(activity.getApplicationContext(), ADsMode.MIMO_SDK);
             LogUtils.i(TAG, "已同意隐私协议，开始初始化米盟SDK...");
             initMimoSdkStatic(activity.getApplicationContext());
             return;
         } else {
             LogUtils.i(TAG, "开始弹出隐私协议...");
-
-			// 2. 替换后的XML布局对话框代码（核心逻辑）
-			AlertDialog dialog = createPrivacyDialog(activity, onPrivacyChangeListener);
-			dialog.show();
+            AlertDialog.Builder builder = new AlertDialog.Builder(activity);
+            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) {
+						SharedPreferences sp = getPrivacySharedPreferences(activity);
+						sp.edit().putString(PRIVACY_VALUE, String.valueOf(1)).apply();
+						initMimoSdkStatic(activity.getApplicationContext());
+						dialog.dismiss();
+						onPrivacyChangeListener.onAgreePrivacy();
+					}
+				});
+            builder.setNegativeButton("拒绝", new DialogInterface.OnClickListener() {
+					@Override
+					public void onClick(DialogInterface dialog, int which) {
+						SharedPreferences sp = getPrivacySharedPreferences(activity);
+						sp.edit().putString(PRIVACY_VALUE, String.valueOf(0)).apply();
+						ADsControlView.updateAdsModeByStatic(activity.getApplicationContext(), ADsMode.STANDALONE);
+						dialog.dismiss();
+						onPrivacyChangeListener.onDisagreePrivacy();
+					}
+				});
+            AlertDialog dialog = builder.create();
 
             // 配置弹窗位置（底部全屏）
             Window window = dialog.getWindow();
@@ -370,7 +382,7 @@ public class ADsControlView extends LinearLayout {
             if (mode2 == ADsMode.STANDALONE) {
                 rbStandalone.setChecked(true);
             } else if (mode2 == ADsMode.MIMO_SDK) {
-                rbMimoSDK.setChecked(true);
+                rbMimoSdk.setChecked(true);
             }
         } else {
             mHandler.post(new Runnable() {
@@ -386,7 +398,7 @@ public class ADsControlView extends LinearLayout {
      * 获取当前选中模式
      */
     public ADsMode getSelectedMode() {
-        int checkedId = rgADsMode.getCheckedRadioButtonId();
+        int checkedId = rgAdsMode.getCheckedRadioButtonId();
         return checkedId == R.id.rb_mimo_sdk ? ADsMode.MIMO_SDK : ADsMode.STANDALONE;
     }
 
@@ -464,116 +476,9 @@ public class ADsControlView extends LinearLayout {
         void onModeSelected(ADsMode selectedMode);
     }
 
-	// 1. 先定义隐私协议变更监听接口（若已定义可忽略）
 	public interface OnPrivacyChangeListener {
-		void onAgreePrivacy();   // 同意隐私协议回调
-		void onDisagreePrivacy();// 拒绝隐私协议回调
+		void onAgreePrivacy();
+		void onDisagreePrivacy();
 	}
-	
-	// 3. 修复：创建隐私协议对话框（XML布局版，解决inflation崩溃）
-	private static AlertDialog createPrivacyDialog(final Activity activity, final OnPrivacyChangeListener onPrivacyChangeListener) {
-		// 1. 加载自定义XML布局（修复：避免解析<a>标签崩溃）
-		View dialogView = LayoutInflater.from(activity).inflate(R.layout.dialog_privacy_agreement, null);
-
-		// 2. 初始化对话框（无标题，使用自定义布局标题）
-		AlertDialog.Builder builder = new AlertDialog.Builder(activity);
-		builder.setView(dialogView)
-			.setCancelable(false); // 点击外部不消失
-		final AlertDialog dialog = builder.create();
-
-		// 3. 初始化控件（修复：绑定链接TextView，替代<a>标签）
-		final TextView tvPrivacyUrl = (TextView) dialogView.findViewById(R.id.tv_privacy_url);
-		Button btnAgree = (Button) dialogView.findViewById(R.id.btn_agree);
-		Button btnDisagree = (Button) dialogView.findViewById(R.id.btn_disagree);
-
-		// 4. 修复：设置链接TextView可点击 + 蓝色下划线样式（模拟网页链接）
-		// 4.1 设置下划线文本
-		tvPrivacyUrl.setText(Html.fromHtml("<u>" + tvPrivacyUrl.getText().toString() + "</u>"));
-		// 4.2 设置点击事件，调用系统浏览器
-		tvPrivacyUrl.setOnClickListener(new OnClickListener() {
-				@Override
-				public void onClick(View v) {
-					String url = tvPrivacyUrl.getText().toString().trim();
-					openUrlInBrowser(activity, url);
-				}
-			});
-		// 4.3 设置点击反馈（可选，提升交互）
-		tvPrivacyUrl.setClickable(true);
-		tvPrivacyUrl.setFocusable(true);
-
-		// 5. 同意按钮点击事件（不变）
-		btnAgree.setOnClickListener(new OnClickListener() {
-				@Override
-				public void onClick(View v) {
-//					// 存储隐私协议状态（枚举+String兼容）
-//					SharedPreferences sp = getPrivacySharedPreferences(activity);
-//					sp.edit()
-//						.putString(PRIVACY_VALUE, String.valueOf(PrivacyAgreeStatus.AGREED.getStatusCode()))
-//						.apply();
-//					// 初始化米盟SDK
-//					initMimoSdkStatic(activity.getApplicationContext());
-					// 回调外部监听
-					if (onPrivacyChangeListener != null) {
-						onPrivacyChangeListener.onAgreePrivacy();
-					}
-					dialog.dismiss();
-				}
-			});
-
-		// 6. 拒绝按钮点击事件（不变）
-		btnDisagree.setOnClickListener(new OnClickListener() {
-				@Override
-				public void onClick(View v) {
-//					// 存储隐私协议状态
-//					SharedPreferences sp = getPrivacySharedPreferences(activity);
-//					sp.edit()
-//						.putString(PRIVACY_VALUE, String.valueOf(PrivacyAgreeStatus.REJECTED.getStatusCode()))
-//						.apply();
-//					// 更新广告模式为单机模式
-//					ADsControlView.updateAdsModeByStatic(activity.getApplicationContext(), AdsMode.STANDALONE);
-					// 回调外部监听
-					if (onPrivacyChangeListener != null) {
-						onPrivacyChangeListener.onDisagreePrivacy();
-					}
-					dialog.dismiss();
-				}
-			});
-
-		// 7. 配置对话框样式（底部全屏，与原逻辑一致）
-		Window window = dialog.getWindow();
-		if (window != null) {
-			window.setGravity(Gravity.BOTTOM);
-			WindowManager m = activity.getWindowManager();
-			Display d = m.getDefaultDisplay();
-			WindowManager.LayoutParams p = window.getAttributes();
-			p.width = d.getWidth(); // 宽度全屏
-			window.setAttributes(p);
-		}
-
-		return dialog;
-	}
-
-	// 4. 不变：调用系统默认浏览器打开链接（Java 7 兼容）
-	private static void openUrlInBrowser(Context context, String url) {
-		if (context == null || TextUtils.isEmpty(url)) {
-			LogUtils.e(TAG, "openUrlInBrowser: Context or Url is null");
-			return;
-		}
-		try {
-			// 构建浏览器意图
-			Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
-			// 确保有应用可处理该意图（避免崩溃）
-			if (browserIntent.resolveActivity(context.getPackageManager()) != null) {
-				context.startActivity(browserIntent);
-			} else {
-				Toast.makeText(context.getApplicationContext(), "未找到可用的浏览器", Toast.LENGTH_SHORT).show();
-				LogUtils.e(TAG, "openUrlInBrowser: No browser app found");
-			}
-		} catch (Exception e) {
-			LogUtils.e(TAG, "openUrlInBrowser: Open url failed", e);
-			Toast.makeText(context.getApplicationContext(), "打开链接失败，请手动复制链接浏览", Toast.LENGTH_SHORT).show();
-		}
-	}
-	
 }
 

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

@@ -1,79 +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="wrap_content"
-    android:orientation="vertical"
-    android:padding="20dp"
-    android:background="@android:color/white">
-
-    <!-- 标题 -->
-    <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"
-        android:layout_marginBottom="16dp" />
-
-    <!-- 内容（用LinearLayout横向排列文本+链接，替代HTML <a>标签） -->
-    <LinearLayout
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:orientation="vertical"
-        android:layout_marginBottom="20dp">
-
-        <TextView
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="小米广告SDK隐私政策: "
-            android:textSize="14sp"
-            android:textColor="@android:color/darker_gray" />
-
-        <!-- 可点击链接（用TextView承载，通过代码设置蓝色+下划线） -->
-        <TextView
-            android:id="@+id/tv_privacy_url"
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="https://dev.mi.com/distribute/doc/details?pId=1688"
-            android:textSize="14sp"
-            android:textColor="@android:color/holo_blue_light" />
-
-        <TextView
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="，点击链接查看完整政策"
-            android:textSize="14sp"
-            android:textColor="@android:color/darker_gray" />
-    </LinearLayout>
-
-    <!-- 按钮容器（水平排列） -->
-    <LinearLayout
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:orientation="horizontal"
-        android:gravity="end">
-
-        <Button
-            android:id="@+id/btn_disagree"
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="拒绝"
-            android:textSize="14sp"
-            android:layout_marginRight="12dp"
-            android:paddingLeft="24dp"
-            android:paddingRight="24dp" />
-
-        <Button
-            android:id="@+id/btn_agree"
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="同意"
-            android:textSize="14sp"
-            android:paddingLeft="24dp"
-            android:paddingRight="24dp" />
-    </LinearLayout>
-
-</LinearLayout>
-

libappbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Fri Nov 21 11:41:04 HKT 2025
-stageCount=2
+#Sun Nov 30 17:12:48 HKT 2025
+stageCount=7
 libraryProject=libappbase
 baseVersion=15.11
-publishVersion=15.11.1
+publishVersion=15.11.6
 buildCount=0
-baseBetaVersion=15.11.2
+baseBetaVersion=15.11.7

libappbase/src/main/AndroidManifest.xml

@@ -3,8 +3,9 @@
     xmlns:android="http://schemas.android.com/apk/res/android"
     package="cc.winboll.studio.libappbase">
 
-    <application>
+	<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
 
+    <application>
         <activity
             android:name=".CrashHandler$CrashActivity"
             android:label="CrashActivity"
@@ -28,6 +29,22 @@
 
         </activity>
 
+		<!-- 崩溃通知复制活动（类库Manifest配置，确保宿主能合并注册） -->
+		<activity
+			android:name="cc.winboll.studio.libappbase.activities.CrashCopyReceiverActivity"
+			android:theme="@android:style/Theme.Translucent.NoTitleBar"
+			android:launchMode="singleTask"
+			android:excludeFromRecents="true"
+			android:taskAffinity=""
+			android:exported="true"
+			android:allowTaskReparenting="false"
+			android:clearTaskOnLaunch="true">
+			<intent-filter>
+				<action android:name="cc.winboll.studio.action.COPY_CRASH_LOG" />
+				<category android:name="android.intent.category.DEFAULT" />
+			</intent-filter>
+		</activity>
+
     </application>
 
 </manifest>

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

@@ -23,6 +23,7 @@ import android.widget.HorizontalScrollView;
 import android.widget.ScrollView;
 import android.widget.TextView;
 import android.widget.Toast;
+import cc.winboll.studio.libappbase.utils.CrashHandleNotifyUtils;
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.FileOutputStream;
@@ -52,7 +53,7 @@ public final class CrashHandler {
 	public static final String TITTLE = "CrashReport";
 
 	/** Intent 传递崩溃信息的键（用于向崩溃页面传递日志） */
-	public static final String EXTRA_CRASH_INFO = "crashInfo";
+	public static final String EXTRA_CRASH_LOG = "crashInfo";
 
 	/** SharedPreferences 存储键（用于记录崩溃状态） */
 	final static String PREFS = CrashHandler.class.getName() + "PREFS";
@@ -169,12 +170,12 @@ public final class CrashHandler {
 							LogUtils.d(TAG, "gotoCrashActiviy: isAppCrashSafetyWireOK");
 							// 保险丝正常：启动自定义样式的崩溃报告页面（GlobalCrashActivity）
 							intent.setClass(app, GlobalCrashActivity.class);
-							intent.putExtra(EXTRA_CRASH_INFO, errorLog); // 传递崩溃日志
+							intent.putExtra(EXTRA_CRASH_LOG, errorLog); // 传递崩溃日志
 						} else {
 							LogUtils.d(TAG, "gotoCrashActiviy: else");
 							// 保险丝熔断：启动基础版崩溃页面（CrashActivity，避免复杂页面再次崩溃）
 							intent.setClass(app, CrashActivity.class);
-							intent.putExtra(EXTRA_CRASH_INFO, errorLog);
+							intent.putExtra(EXTRA_CRASH_LOG, errorLog);
 						}
 
 						// 设置意图标志：清除原有任务栈，创建新任务（避免回到崩溃前页面）
@@ -185,10 +186,17 @@ public final class CrashHandler {
 						);
 
 						try {
-							// 启动崩溃页面，终止当前进程（确保完全重启）
-							app.startActivity(intent);
+							if (GlobalApplication.isDebugging()&&AppCrashSafetyWire.getInstance().isAppCrashSafetyWireOK()) {
+								// 如果是 debug 版，启动崩溃页面窗口
+								app.startActivity(intent);
+							} else {
+								// 如果是 release 版，就只发送一个通知
+								CrashHandleNotifyUtils.handleUncaughtException(app, intent);
+							}
+							// 终止当前进程（确保完全重启）
 							android.os.Process.killProcess(android.os.Process.myPid());
 							System.exit(0);
+
 						} catch (ActivityNotFoundException e) {
 							// 未找到崩溃页面（如未在 Manifest 注册），交给系统默认处理器
 							e.printStackTrace();
@@ -428,7 +436,7 @@ public final class CrashHandler {
 			AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(getApplicationContext());
 
 			// 获取传递的崩溃日志
-			mLog = getIntent().getStringExtra(EXTRA_CRASH_INFO);
+			mLog = getIntent().getStringExtra(EXTRA_CRASH_LOG);
 			// 设置系统默认主题（避免自定义主题冲突）
 			setTheme(android.R.style.Theme_DeviceDefault_Light_DarkActionBar);
 

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

@@ -85,6 +85,7 @@ public class GlobalApplication extends Application {
         super.onCreate();
         // 初始化单例实例（确保在所有初始化操作前完成）
         sInstance = this;
+		
 
         // 初始化基础组件（日志、崩溃处理、Toast）
         initCoreComponents();
@@ -169,6 +170,7 @@ public class GlobalApplication extends Application {
         // 释放单例引用（可选，避免内存泄漏风险）
         sInstance = null;
         LogUtils.d(TAG, "GlobalApplication 终止，单例实例已释放");
+		
     }
 }
 

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

@@ -51,7 +51,7 @@ public final class GlobalCrashActivity extends Activity implements MenuItem.OnMe
 			.postResumeCrashSafetyWireHandler(getApplicationContext());
 
         // 从 Intent 中获取崩溃日志数据（EXTRA_CRASH_INFO 为 CrashHandler 定义的常量键）
-        mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_INFO);
+        mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
 
         // 设置当前 Activity 的布局文件（展示崩溃报告的 UI 结构）
         setContentView(R.layout.activity_globalcrash);

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

@@ -1,240 +0,0 @@
-package cc.winboll.studio.libappbase;
-
-import android.content.Context;
-import android.util.AttributeSet;
-import android.view.View;
-import android.widget.ListView;
-import android.widget.Scroller;
-
-/**
- * @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";
-
-	/** 子项垂直偏移量（用于调整子项在垂直方向的位置，默认 0） */
-	private int mVerticalOffset = 0;
-	/** 平滑滚动控制器（用于实现水平方向的平滑滚动动画） */
-	private Scroller mScroller;
-	/** 所有子项总宽度（包含内边距），用于计算滚动范围 */
-	private int mTotalWidth;
-
-	/**
-	 * 构造方法：仅上下文
-	 * @param context 上下文（Activity/Fragment）
-	 */
-	public HorizontalListView(Context context) {
-		super(context);
-		init();
-	}
-
-	/**
-	 * 构造方法：上下文 + 自定义属性
-	 * @param context 上下文
-	 * @param attrs 自定义属性集合（如布局文件中设置的属性）
-	 */
-	public HorizontalListView(Context context, AttributeSet attrs) {
-		super(context, attrs);
-		init();
-	}
-
-	/**
-	 * 构造方法：上下文 + 自定义属性 + 样式属性
-	 * @param context 上下文
-	 * @param attrs 自定义属性集合
-	 * @param defStyle 样式属性（如系统默认样式）
-	 */
-	public HorizontalListView(Context context, AttributeSet attrs, int defStyle) {
-		super(context, attrs, defStyle);
-		init();
-	}
-
-	/**
-	 * 初始化控件配置
-	 * 初始化滚动控制器，设置滚动条显示状态
-	 */
-	private void init() {
-		// 初始化平滑滚动器（上下文为当前控件所在上下文）
-		mScroller = new Scroller(getContext());
-		// 启用水平滚动条（默认显示）
-		setHorizontalScrollBarEnabled(true);
-		// 禁用垂直滚动条（水平列表无需垂直滚动）
-		setVerticalScrollBarEnabled(false);
-	}
-
-	/**
-	 * 设置子项垂直偏移量
-	 * 用于整体调整所有子项在垂直方向的位置（如居中、偏移）
-	 * @param verticalOffset 垂直偏移像素值（正数向下偏移，负数向上偏移）
-	 */
-	public void setVerticalOffset(int verticalOffset) {
-		this.mVerticalOffset = verticalOffset;
-	}
-
-	/**
-	 * 重写布局方法：实现子项水平排列
-	 * 遍历所有子项，按水平方向依次布局（左对齐，叠加排列）
-	 * @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); // 执行父类布局逻辑（确保基础配置生效）
-
-		int childCount = getChildCount(); // 获取当前可见子项数量
-		int left = getPaddingLeft(); // 子项起始左坐标（包含控件左内边距）
-		// 控件可用高度（总高度 - 上下内边距）
-		int viewHeight = getMeasuredHeight() - getPaddingTop() - getPaddingBottom();
-		mTotalWidth = left; // 初始化总宽度为左内边距
-
-		// 遍历子项，水平排列
-		for (int i = 0; i < childCount; i++) {
-			View child = getChildAt(i); // 获取当前子项
-			int childWidth = child.getMeasuredWidth(); // 子项测量宽度
-			int childHeight = child.getMeasuredHeight(); // 子项测量高度
-
-			// 布局子项：水平方向从 left 开始，垂直方向偏移 mVerticalOffset
-			child.layout(
-				left,                      // 子项左边界
-				mVerticalOffset,           // 子项上边界（带垂直偏移）
-				left + childWidth,         // 子项右边界（左 + 宽度）
-				mVerticalOffset + childHeight // 子项下边界（偏移 + 高度）
-			);
-
-			left += childWidth; // 更新下一个子项的起始左坐标
-		}
-
-		// 计算总宽度（所有子项宽度 + 左右内边距）
-		mTotalWidth = left + getPaddingRight();
-	}
-
-	/**
-	 * 重写测量方法：设置控件测量规则
-	 * 水平方向：允许无限宽度（适应所有子项总宽度）；垂直方向：自适应内容高度
-	 * @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);
-
-		// 执行父类测量逻辑（使用重写后的测量规格）
-		super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
-	}
-
-	/**
-	 * 重写滚动计算方法：实现平滑滚动
-	 * 配合 Scroller 实现水平方向的平滑滚动动画（需在滚动时调用 invalidate() 触发）
-	 */
-	@Override
-	public void computeScroll() {
-		// 判断滚动是否正在进行（Scroller 计算当前滚动位置）
-		if (mScroller.computeScrollOffset()) {
-			// 滚动到当前计算的位置（x 轴水平滚动，y 轴固定 0）
-			scrollTo(mScroller.getCurrX(), mScroller.getCurrY());
-			// 触发重绘，持续更新滚动状态
-			postInvalidate();
-		}
-	}
-
-	/**
-	 * 平滑滚动到指定坐标
-	 * 基于 Scroller 实现水平方向的平滑滚动（300ms 动画时长）
-	 * @param x 目标 x 轴坐标（水平滚动位置）
-	 * @param y 目标 y 轴坐标（固定 0，无需垂直滚动）
-	 */
-	public void smoothScrollTo(int x, int y) {
-		// 计算滚动距离（目标坐标 - 当前滚动坐标）
-		int dx = x - getScrollX();
-		int dy = y - getScrollY();
-
-		// 启动平滑滚动：起始坐标（当前滚动位置）、滚动距离、动画时长（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/LogView.java

@@ -1,5 +1,10 @@
 package cc.winboll.studio.libappbase;
 
+/**
+ * @Author ZhanGSKen@QQ.COM
+ * @Date 2024/08/12 14:36:18
+ * @Describe 日志视图类，继承 RelativeLayout 类。
+ */
 import android.content.ClipData;
 import android.content.ClipboardManager;
 import android.content.Context;
@@ -21,6 +26,9 @@ 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 cc.winboll.studio.libappbase.views.HorizontalListView;
 import java.text.Collator;
 import java.util.ArrayList;
 import java.util.Collections;
@@ -28,49 +36,27 @@ 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";
 
-    /** 日志处理中标志（避免并发刷新，volatile 保证多线程可见性） */
-    private volatile boolean mIsHandling;
-    /** 新日志添加标志（标记有未处理的新日志，volatile 保证多线程可见性） */
-    private volatile boolean mIsAddNewLog;
+    public volatile boolean mIsHandling;
+    public volatile boolean mIsAddNewLog;
 
-    /** 上下文对象（用于布局加载、系统服务获取） */
-    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;
+    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;
 
-    // ====================== 构造方法（初始化视图） ======================
     public LogView(Context context) {
         super(context);
         initView(context);
@@ -91,307 +77,258 @@ public class LogView extends RelativeLayout {
         initView(context);
     }
 
-    /**
-     * 启动日志监听与展示
-     * 1. 初始化并启动 LogViewThread（监听日志文件变化）；
-     * 2. 初始加载并展示日志内容。
-     */
     public void start() {
-        mLogViewThread = new LogViewThread(this);
+        mLogViewThread = new LogViewThread(LogView.this);
         mLogViewThread.start();
-        showAndScrollLogView(); // 初始显示日志并滚动到底部
+        // 显示日志
+        showAndScrollLogView();
     }
 
-    /**
-     * 滚动日志到底部（确保最新日志可见）
-     * 运行在主线程，通过 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);
-					}
-				}
-			});
+    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);
+                    }
+                }
+            });
     }
 
-    /**
-     * 初始化视图组件（加载布局、绑定控件、设置监听）
-     * @param context 上下文对象
-     */
-    private void initView(Context context) {
+    void initView(Context context) {
         mContext = context;
-        mLogViewHandler = new LogViewHandler(); // 初始化主线程 Handler
+        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);
 
-        // 加载日志视图布局（R.layout.view_log 为自定义布局文件）
-        View rootView = LayoutInflater.from(context).inflate(R.layout.view_log, this, true);
-        // 绑定布局控件（通过 ID 找到对应组件）
-        bindViews(rootView);
+        metTagSearch.addTextChangedListener(new TextWatcher() {
 
-        // 设置 TAG 搜索输入框监听（实时搜索并定位 TAG）
-        setupTagSearchListener();
-        // 设置功能按钮监听（清理日志、复制日志）
-        setupFunctionButtonListeners(rootView);
-        // 设置文本选择开关监听（控制日志文本是否可选中）
-        setupTextSelectableListener();
-        // 初始化日志级别下拉框（绑定级别数据，设置默认值）
-        initLogLevelSpinner();
-        // 初始化 TAG 列表（加载所有 TAG，设置全选状态）
-        initTagListView();
-        // 设置默认交互模式（默认禁止子视图获取焦点，避免误触）
+                @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()));
+                }
+            });
+
+
+        // 设置滚动时不聚焦日志
         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()) {
-            // 正在处理日志刷新，标记有新日志待处理
+        if (mLogViewHandler.isHandling() == true) {
+            // 正在处理日志显示，
+            // 就先设置一个新日志标志位
+            // 以便日志显示完后，再次显示新日志内容
             mLogViewHandler.setIsAddNewLog(true);
         } else {
-            // 发送刷新消息到主线程
-            Message refreshMsg = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOG_REFRESH);
-            mLogViewHandler.sendMessage(refreshMsg);
+            //LogUtils.d(TAG, "LogListener showLog(String path)");
+            Message message = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOGVIEW_UPDATE);
+            mLogViewHandler.sendMessage(message);
             mLogViewHandler.setIsAddNewLog(false);
         }
     }
 
-    /**
-     * 显示日志并滚动到底部
-     * 1. 从 LogUtils 加载所有历史日志；
-     * 2. 设置到文本控件并滚动到底部。
-     */
-    private void showAndScrollLogView() {
-        mLogTextView.setText(LogUtils.loadLog()); // 加载并显示日志
-        scrollLogToBottom(); // 滚动到底部，显示最新日志
+    void showAndScrollLogView() {
+        mTextView.setText(LogUtils.loadLog());
+        scrollLogUp();
     }
 
-    /**
-     * 滚动到目标 TAG（根据搜索文本定位匹配的 TAG 并滚动显示）
-     * @param prefix 搜索文本（TAG 前缀）
-     */
-    private void scrollToTargetTag(final String prefix) {
-        if (mTagListAdapter == null || prefix == null || prefix.isEmpty()) {
-            LogUtils.d(TAG, "TAG 搜索参数为空，无法定位");
+    public void scrollToTag(final String prefix) {
+        if (mTAGListAdapter == null || prefix == null || prefix.length() == 0) {
+            LogUtils.d(TAG, "参数为空，无法滚动");
             return;
         }
 
-        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;
-						}
-					}
+        final List<TAGItemModel> itemList = mTAGListAdapter.getItemList();
 
-					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);
-					}
-				}
-			});
+        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);
+                    }
+                }
+            });
     }
 
-    // ====================== 内部类：日志视图 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;
+
+
+    class LogViewHandler extends Handler {
+
+        final static int MSG_LOGVIEW_UPDATE = 0;
+        volatile boolean isHandling;
+        volatile boolean isAddNewLog;
 
         public LogViewHandler() {
             setIsHandling(false);
@@ -414,32 +351,24 @@ public class LogView extends RelativeLayout {
             return isAddNewLog;
         }
 
-        @Override
         public void handleMessage(Message msg) {
-            super.handleMessage(msg);
             switch (msg.what) {
-                case MSG_LOG_REFRESH:
-                    // 未处理日志刷新时，标记为处理中并触发显示
-                    if (!isHandling()) {
-                        setIsHandling(true);
-                        showAndScrollLogView();
+                case MSG_LOGVIEW_UPDATE:{
+                        if (isHandling() == false) {
+                            setIsHandling(true);
+                            showAndScrollLogView();
+                        }
+                        break;
                     }
-                    break;
                 default:
                     break;
             }
+            super.handleMessage(msg);
         }
     }
 
-    // ====================== 内部类：TAG 数据模型（封装 TAG 名称与状态） ======================
-    /**
-     * TAG 列表项数据模型
-     * 封装单个 TAG 的名称及其启用状态（用于 Adapter 数据绑定）
-     */
-    private class TAGItemModel {
-        /** TAG 名称（如 "LogViewThread"、"LogUtils"） */
+    public class TAGItemModel {
         private String tag;
-        /** TAG 启用状态（true：启用；false：禁用） */
         private boolean isChecked;
 
         public TAGItemModel(String tag, boolean isChecked) {
@@ -463,17 +392,18 @@ public class LogView extends RelativeLayout {
             isChecked = checked;
         }
 
-        /**
-         * 重写 equals 方法（按 TAG 名称判断相等）
-         * @param o 比较对象
-         * @return true：TAG 名称相同；false：不同
-         */
+        // getter/setter...
+
         @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 7，不依赖 Objects.equals）
+            // 手动处理空值比较（Java 6 不支持 Objects.equals）
             if (tag == null) {
                 return that.tag == null;
             } else {
@@ -481,174 +411,106 @@ 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(); // 手动处理空值
         }
     }
 
-    // ====================== 内部类：TAG 列表适配器（绑定数据与视图） ======================
-    /**
-     * TAG 水平列表适配器（继承 BaseAdapter）
-     * 负责 TAG 数据与列表项视图的绑定，处理勾选状态变化
-     */
-    private class TAGListAdapter extends BaseAdapter {
-        /** 上下文对象（用于加载列表项布局） */
+
+    public class TAGListAdapter extends BaseAdapter {
+
         private Context context;
-        /** 原始 TAG 启用状态映射表（来自 LogUtils） */
-        private Map<String, Boolean> originTagMap;
-        /** TAG 列表项数据（转换为 TAGItemModel 列表，便于排序和绑定） */
-        private List<TAGItemModel> tagItemList;
+        private Map<String, Boolean> mapOrigin;
+        private List<TAGItemModel> itemList;
 
-        /**
-         * 构造方法（初始化数据并加载到列表）
-         * @param context 上下文
-         * @param tagMap TAG 启用状态映射表
-         */
-        public TAGListAdapter(Context context, Map<String, Boolean> tagMap) {
+        public TAGListAdapter(Context context, Map<String, Boolean> map) {
             this.context = context;
-            this.originTagMap = tagMap;
-            loadTagData(originTagMap); // 加载并转换数据
+            mapOrigin = map;
+            loadMap(mapOrigin);
         }
 
-        /**
-         * 获取 TAG 列表项数据（供外部定位 TAG 使用）
-         * @return TAGItemModel 列表
-         */
         public List<TAGItemModel> getItemList() {
-            return tagItemList;
+            return itemList;
         }
 
-        // ====================== BaseAdapter 抽象方法实现 ======================
         @Override
         public int getCount() {
-            return tagItemList == null ? 0 : tagItemList.size();
+            return itemList.size();
         }
 
         @Override
-        public Object getItem(int position) {
-            return tagItemList.get(position);
+        public Object getItem(int p) {
+            return itemList.get(p);
         }
 
         @Override
-        public long getItemId(int position) {
-            return position;
+        public long getItemId(int p) {
+            return p;
         }
 
-        /**
-         * 加载 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()));
+        void loadMap(Map<String, Boolean> map) {
+            itemList = new ArrayList<TAGItemModel>();
+            for (Map.Entry<String, Boolean> entry : map.entrySet()) {
+                itemList.add(new TAGItemModel(entry.getKey(), entry.getValue()));
             }
-            // 按 TAG 名称升序排序（中文排序兼容）
-            Collections.sort(tagItemList, new TagAscComparator(true));
+            // 添加排序功能，按照tag进行升序排序
+            Collections.sort(itemList, new SortMapEntryByKeyString(true));
+            //Collections.sort(itemList, new SortMapEntryByKeyString(false));
         }
 
-        /**
-         * 重新加载 TAG 数据（用于全选/反选后刷新列表）
-         */
         public void reload() {
-            loadTagData(originTagMap); // 重新加载数据
-            notifyDataSetChanged(); // 通知视图刷新
+            loadMap(mapOrigin);
+            super.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();
-                // 绑定列表项控件（TAG 文本和勾选框）
-                holder.tagTv = convertView.findViewById(R.id.viewlogtagTextView1);
-                holder.tagCb = convertView.findViewById(R.id.viewlogtagCheckBox1);
-                convertView.setTag(holder); // 保存 ViewHolder 到视图
+                holder.tvText = convertView.findViewById(R.id.viewlogtagTextView1);
+                holder.cbChecked = convertView.findViewById(R.id.viewlogtagCheckBox1);
+                convertView.setTag(holder);
             } else {
-                holder = (ViewHolder) convertView.getTag(); // 复用 ViewHolder
+                holder = (ViewHolder) convertView.getTag();
             }
 
-            // 绑定数据到视图
-            final TAGItemModel item = tagItemList.get(position);
-            holder.tagTv.setText(item.getTag()); // 设置 TAG 名称
-            holder.tagCb.setChecked(item.isChecked()); // 设置勾选状态
+            final TAGItemModel item = itemList.get(position);
+            holder.tvText.setText(item.getTag());
+            holder.cbChecked.setChecked(item.isChecked());
+            holder.cbChecked.setOnClickListener(new View.OnClickListener(){
 
-            // 勾选框点击监听（更新 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);
-					}
-				});
+                    @Override
+                    public void onClick(View v) {
+                        LogUtils.setTAGListEnable(item.getTag(), ((CheckBox)v).isChecked());
+                    }
+                });
 
             return convertView;
         }
 
-        /**
-         * 列表项 ViewHolder（缓存控件，提升列表滑动性能）
-         */
-        private class ViewHolder {
-            TextView tagTv; // TAG 名称文本控件
-            CheckBox tagCb; // TAG 启用状态勾选框
+        public class ViewHolder {
+            TextView tvText;
+            CheckBox cbChecked;
         }
     }
 
-    // ====================== 内部类：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;
+    class SortMapEntryByKeyString implements Comparator<TAGItemModel> {
+        private boolean mIsDesc = true;
+        // isDesc 是否降序排列
+        public SortMapEntryByKeyString(boolean isDesc) {
+            mIsDesc = isDesc;
         }
-
-        /**
-         * 比较两个 TAGItemModel（按 TAG 名称排序）
-         * @param o1 第一个比较对象
-         * @param o2 第二个比较对象
-         * @return 比较结果（正数：o1 在 o2 后；负数：o1 在 o2 前；0：相等）
-         */
+        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
         @Override
         public int compare(TAGItemModel o1, TAGItemModel o2) {
-            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); // 升序
+            if (mIsDesc) {
+                return o1.getTag().compareTo(o2.getTag());
             } else {
-                return chineseCollator.compare(tag2, tag1); // 降序
+                return o2.getTag().compareTo(o1.getTag());
             }
         }
     }
 }
-

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

@@ -121,6 +121,18 @@ public class ToastUtils {
         LogUtils.d(TAG, "ToastUtils 初始化完成，上下文已设置");
     }
 
+    // ===================================== 新增：isInited() 方法 =====================================
+    /**
+     * 判断 ToastUtils 是否已初始化（供外部调用，如 CrashHandleNotifyUtils 中的复制提示）
+     * @return true：已初始化（可正常显示吐司）；false：未初始化/已释放（无法正常显示）
+     */
+    public static boolean isInited() {
+        ToastUtils instance = getInstance();
+        // 双重校验：1. 未释放 2. 上下文已设置（确保初始化完成）
+        return !instance.isReleased && instance.mContext != null;
+    }
+    // ===================================== 新增结束 =====================================
+
     /**
      * 外部接口：显示短时长吐司
      * @param message 吐司内容
@@ -243,7 +255,6 @@ public class ToastUtils {
                 instance.mWorkerThread.join(1000);
             } catch (InterruptedException e) {
 				LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
-                //LogUtils.e(TAG, "线程退出异常", e);
                 Thread.currentThread().interrupt();
             }
             instance.mWorkerThread = null;

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

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

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

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

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

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

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

@@ -99,7 +99,7 @@
 			android:layout_weight="1.0"
 			android:id="@+id/viewlogHorizontalScrollView1">
 
-			<cc.winboll.studio.libappbase.HorizontalListView
+			<cc.winboll.studio.libappbase.views.HorizontalListView
 				android:layout_width="wrap_content"
 				android:layout_height="match_parent"
 				android:id="@+id/tags_listview"/>

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

@@ -4,4 +4,5 @@
     <color name="colorPrimaryDark">#FF005C12</color>
     <color name="colorAccent">#FF8DFFA2</color>
     <color name="colorText">#FFFFFB8D</color>
+	<!-- 通知按钮颜色（启用/禁用） -->
 </resources>

libapputils/build.gradle

@@ -21,7 +21,7 @@ android {
 
 dependencies {
     api fileTree(dir: 'libs', include: ['*.jar'])
-    api 'cc.winboll.studio:libappbase:15.9.5'
+    api 'cc.winboll.studio:libappbase:15.10.9'
     
     // 二维码类库
     api 'com.google.zxing:core:3.4.1'
@@ -32,6 +32,8 @@ dependencies {
     
     // Html 解析
     api 'org.jsoup:jsoup:1.13.1'
+	
+	api 'com.google.code.gson:gson:2.10.1'
     
     // SSH
     //api 'com.jcraft:jsch:0.1.55'

libapputils/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Mon Sep 01 07:56:11 HKT 2025
-stageCount=7
+#Mon Sep 29 01:15:55 HKT 2025
+stageCount=3
 libraryProject=libapputils
-baseVersion=15.8
-publishVersion=15.8.6
+baseVersion=15.10
+publishVersion=15.10.2
 buildCount=0
-baseBetaVersion=15.8.7
+baseBetaVersion=15.10.3

libapputils/src/main/java/cc/winboll/studio/libapputils/utils/AppUtils.java

@@ -0,0 +1,29 @@
+package cc.winboll.studio.libapputils.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/15 20:05:03
+ * @Describe AppUtils
+ */
+import android.content.Context;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.PackageManager.NameNotFoundException;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class AppUtils {
+    
+    public static final String TAG = "AppUtils";
+    
+    public static String getAppNameByPackageName(Context context, String packageName) {
+        PackageManager packageManager = context.getPackageManager();
+        try {
+            ApplicationInfo applicationInfo = packageManager.getApplicationInfo(packageName, 0);
+            return (String) packageManager.getApplicationLabel(applicationInfo);
+        } catch (NameNotFoundException e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            return "";
+        }
+    }
+}
+

libapputils/src/main/java/cc/winboll/studio/libapputils/utils/FileUtils.java

@@ -9,10 +9,16 @@ import android.content.Context;
 import android.content.Intent;
 import android.content.res.AssetManager;
 import android.net.Uri;
+import android.support.v4.content.FileProvider;
 import cc.winboll.studio.libappbase.LogUtils;
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.ByteArrayOutputStream;
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.FileOutputStream;
+import java.io.FileReader;
+import java.io.FileWriter;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
@@ -22,7 +28,6 @@ import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
-import android.support.v4.content.FileProvider;
 
 public class FileUtils {
 
@@ -97,36 +102,6 @@ public class FileUtils {
         }
     }
 
-    //
-    // 把字符串写入文件，指定 UTF-8 编码
-    //
-    public static void writeStringToFile(String szFilePath, String szContent) throws IOException {
-        File file = new File(szFilePath);
-        if (!file.getParentFile().exists()) {
-            file.getParentFile().mkdirs();
-        }
-        FileOutputStream outputStream = new FileOutputStream(file);
-        OutputStreamWriter writer = new OutputStreamWriter(outputStream, StandardCharsets.UTF_8);
-        writer.write(szContent);
-        writer.close();
-    }
-
-    //
-    // 读取文件到字符串，指定 UTF-8 编码
-    //
-    public static String readStringFromFile(String szFilePath) throws IOException {
-        File file = new File(szFilePath);
-        FileInputStream inputStream = new FileInputStream(file);
-        InputStreamReader reader = new InputStreamReader(inputStream, StandardCharsets.UTF_8);
-        StringBuilder content = new StringBuilder();
-        int character;
-        while ((character = reader.read()) != -1) {
-            content.append((char) character);
-        }
-        reader.close();
-        return content.toString();
-    }
-
     public static boolean copyFile(File srcFile, File dstFile) {
         if (!srcFile.exists()) {
             LogUtils.d(TAG, "The original file does not exist.");
@@ -154,4 +129,113 @@ public class FileUtils {
         }
         return false;
     }
+	
+
+    /**
+     * 读取文件为字节数组（Java 7 语法）
+     */
+    public static byte[] readByteArrayFromFile(String filePath) {
+        FileInputStream fis = null;
+        ByteArrayOutputStream bos = null;
+        try {
+            fis = new FileInputStream(filePath);
+            bos = new ByteArrayOutputStream();
+            byte[] buffer = new byte[4096];
+            int bytesRead;
+            while ((bytesRead = fis.read(buffer)) != -1) {
+                bos.write(buffer, 0, bytesRead);
+            }
+            return bos.toByteArray();
+        } catch (IOException e) {
+            e.printStackTrace();
+            return null;
+        } finally {
+            // 手动关闭流（Java 7 不支持 try-with-resources）
+            if (fis != null) {
+                try {
+                    fis.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+            if (bos != null) {
+                try {
+                    bos.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+    }
+
+    /**
+     * 写入字节数组到文件（Java 7 语法）
+     */
+    public static boolean writeByteArrayToFile(byte[] data, String filePath) {
+        FileOutputStream fos = null;
+        try {
+            fos = new FileOutputStream(filePath);
+            fos.write(data);
+            return true;
+        } catch (IOException e) {
+            e.printStackTrace();
+            return false;
+        } finally {
+            if (fos != null) {
+                try {
+                    fos.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+    }
+
+    public static String readStringFromFile(String filePath) {
+        BufferedReader reader = null;
+        try {
+            reader = new BufferedReader(new FileReader(filePath));
+            StringBuilder content = new StringBuilder();
+            String line;
+            while ((line = reader.readLine()) != null) {
+                content.append(line).append(System.getProperty("line.separator"));
+            }
+            // 去除最后一个换行符（可选）
+            if (content.length() > 0) {
+                content.deleteCharAt(content.length() - 1);
+            }
+            return content.toString();
+        } catch (IOException e) {
+            e.printStackTrace();
+            return null;
+        } finally {
+            if (reader != null) {
+                try {
+                    reader.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+    }
+	
+    public static boolean writeStringToFile(String content, String filePath, boolean append) {
+        BufferedWriter writer = null;
+        try {
+            writer = new BufferedWriter(new FileWriter(filePath, append));
+            writer.write(content);
+            return true;
+        } catch (IOException e) {
+            e.printStackTrace();
+            return false;
+        } finally {
+            if (writer != null) {
+                try {
+                    writer.close();
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+    }
 }

powerbell/build.gradle

@@ -39,14 +39,7 @@ android {
         }
     }
 
-    buildTypes {
-        release {
-            minifyEnabled false
-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
-        }
-    }
-	
-    // 米盟
+	// 米盟 SDK
     packagingOptions {
          doNotStrip "*/*/libmimo_1011.so"
     }
@@ -55,14 +48,15 @@ android {
 dependencies {
 	
 	// 米盟
-	implementation 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+	api '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'
+    //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
@@ -83,7 +77,7 @@ dependencies {
     //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
     //api 'androidx.fragment:fragment:1.1.0'
     
-	implementation 'cc.winboll.studio:libaes:15.11.4'
+	implementation 'cc.winboll.studio:libaes:15.11.6'
     implementation 'cc.winboll.studio:libappbase:15.11.0'
 	
     //api fileTree(dir: 'libs', include: ['*.aar'])

powerbell/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Wed Nov 19 09:09:24 HKT 2025
-stageCount=4
+#Wed Nov 26 16:27:33 HKT 2025
+stageCount=9
 libraryProject=
 baseVersion=15.11
-publishVersion=15.11.3
+publishVersion=15.11.8
 buildCount=0
-baseBetaVersion=15.11.4
+baseBetaVersion=15.11.9

powerbell/proguard-rules.pro

@@ -9,12 +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">PowerBell☆</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,13 +1,14 @@
 <?xml version='1.0' encoding='utf-8'?>
 <manifest
     xmlns:android="http://schemas.android.com/apk/res/android"
-	xmlns:tools="http://schemas.android.com/tools"
+    xmlns:tools="http://schemas.android.com/tools"
     package="cc.winboll.studio.powerbell">
-	
-    <!-- 通过GPS得到精确位置 -->
-    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
-    <!-- 通过网络得到粗略位置 -->
-    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+
+    <!-- 只能在前台获取精确的位置信息 -->
+    <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"/>
@@ -36,22 +37,22 @@
     <!-- BATTERY_STATS -->
     <uses-permission android:name="android.permission.BATTERY_STATS"/>
 
-    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+    <!-- 计算应用存储空间 -->
+    <uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
 
     <uses-feature android:name="android.hardware.camera"/>
 
     <uses-feature android:name="android.hardware.camera.autofocus"/>
 
-	<!-- 1. 基础应用信息读取权限（Android 11 及以下） -->
-	<uses-permission android:name="android.permission.GET_PACKAGE_SIZE" />
+    <uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
 
-	<!-- 2. Android 11+ 应用列表读取权限（必须声明，否则无法获取全部应用） -->
-	<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
-		tools:ignore="QueryAllPackagesPermission" />
+    <uses-permission
+        android:name="android.permission.QUERY_ALL_PACKAGES"
+        tools:ignore="QueryAllPackagesPermission"/>
 
-	<!-- 3. 可选：若需读取系统应用，添加此权限（部分机型需要） -->
-	<uses-permission android:name="android.permission.ACCESS_PACKAGE_USAGE_STATS"
-		tools:ignore="ProtectedPermissions" />
+    <uses-permission
+        android:name="android.permission.ACCESS_PACKAGE_USAGE_STATS"
+        tools:ignore="ProtectedPermissions"/>
 
     <application
         android:name=".App"
@@ -67,8 +68,21 @@
 
         <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>
 
@@ -78,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"
@@ -152,6 +214,22 @@
 
         <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"/>
+
     </application>
 
-</manifest>
+</manifest>

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

@@ -13,7 +13,14 @@ import java.io.File;
 public class App extends GlobalApplication {
 
     public static final String TAG = "GlobalApplication";
-
+	
+	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;

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

@@ -23,6 +23,7 @@ import cc.winboll.studio.powerbell.activities.ClearRecordActivity;
 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;
 
 /**
@@ -37,6 +38,8 @@ public class MainActivity extends WinBoLLActivity {
 
     public static final String TAG = "MainActivity";
 
+    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：赞同
 //
@@ -81,7 +84,7 @@ public class MainActivity extends WinBoLLActivity {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
 		mADsBannerView = findViewById(R.id.adsbanner);
-		
+
 //        mContainer = findViewById(R.id.ads_container);
 //
 //        // 初始化主线程Handler（关键：确保广告操作在主线程执行）
@@ -119,7 +122,7 @@ public class MainActivity extends WinBoLLActivity {
 //        if (mMainHandler != null) {
 //            mMainHandler.removeCallbacksAndMessages(null);
 //        }
-		if(mADsBannerView != null) {
+		if (mADsBannerView != null) {
 			mADsBannerView.releaseAdResources();
 		}
     }
@@ -165,7 +168,7 @@ public class MainActivity extends WinBoLLActivity {
     public static void reloadBackground() {
         // 修复：添加非空校验，避免Activity已销毁时调用
         if (_mMainActivity != null && !_mMainActivity.isFinishing() && !_mMainActivity.isDestroyed()) {
-            _mMainActivity.mMainViewFragment.loadBackground();
+            _mMainActivity.mMainViewFragment.reloadBackground();
         }
     }
 
@@ -194,7 +197,7 @@ public class MainActivity extends WinBoLLActivity {
         super.onResume();
         reloadBackground();
         setBackgroundColor();
-		if(mADsBannerView != null) {
+		if (mADsBannerView != null) {
 			mADsBannerView.resumeADs();
 		}
 
@@ -221,6 +224,9 @@ public class MainActivity extends WinBoLLActivity {
     public boolean onCreateOptionsMenu(Menu menu) {
         mMenu = menu;
         getMenuInflater().inflate(R.menu.toolbar_main, mMenu);
+		if (App.isDebugging()) {
+			getMenuInflater().inflate(R.menu.toolbar_unittest, mMenu);
+		}
         return true;
     }
 
@@ -238,6 +244,8 @@ public class MainActivity extends WinBoLLActivity {
             startActivity(new Intent(this, BackgroundPictureActivity.class));
         } else if (menuItemId == R.id.action_log) {
             LogActivity.startLogActivity(this);
+        } else if (menuItemId == R.id.action_unittestactivity) {
+            startActivity(new Intent(this, MainUnitTestActivity.class));
         }
         return true;
     }

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

@@ -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,16 +7,16 @@ 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.ToastUtils;
@@ -24,9 +24,11 @@ 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/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/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,12 @@ 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.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 +68,7 @@ public class MainViewFragment extends Fragment {
     TextView mtvUsegeReminderValue;
     CheckBox mcbUsegeReminderValue;
     TextView mtvCurrentValue;
+	BackgroundView bvPreviewBackground;
 
 
     @Override
@@ -79,27 +76,28 @@ 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);
+        /*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);
@@ -302,22 +300,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/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/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,374 @@
+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.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; // 默认 1:1
+    // 标记当前是否处于预览状态
+    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() {
+        initBackgroundImageView();
+        initBackgroundImagePath();
+        loadAndSetImageViewBackground();
+    }
+
+    private void initBackgroundImageView() {
+        ivBackground = new ImageView(mContext);
+        RelativeLayout.LayoutParams layoutParams = new RelativeLayout.LayoutParams(
+			LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
+        layoutParams.addRule(RelativeLayout.CENTER_IN_PARENT);
+        ivBackground.setLayoutParams(layoutParams);
+        ivBackground.setScaleType(ImageView.ScaleType.FIT_CENTER);
+        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, "预览图片路径为空");
+            return;
+        }
+
+        File previewFile = new File(previewImagePath);
+        if (!previewFile.exists() || !previewFile.isFile()) {
+            LogUtils.e(TAG, "预览图片不存在或不是文件：" + previewImagePath);
+            return;
+        }
+
+        // 计算预览图片宽高比
+        if (!calculateImageAspectRatio(previewFile)) {
+            LogUtils.e(TAG, "预览图片尺寸无效，无法预览");
+            return;
+        }
+
+        // 压缩加载预览图片
+        Bitmap previewBitmap = decodeBitmapWithCompress(previewFile, 1080, 1920);
+        if (previewBitmap == null) {
+            LogUtils.e(TAG, "预览图片加载失败");
+            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);
+    }
+
+    /**
+     * 【新增公共函数】退出预览模式，恢复显示正式背景图片
+     */
+    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 = decodeBitmapWithCompress(backgroundFile, 1080, 1920);
+        if (bitmap == null) {
+            LogUtils.e(TAG, "图片加载失败，无法解析为 Bitmap");
+            setDefaultImageViewBackground();
+            return;
+        }
+
+        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);
+        }
+
+        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);
+    }
+
+    /**
+     * 带压缩的 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.setBackgroundResource(R.drawable.default_background);
+        imageAspectRatio = 1.0f;
+        adjustImageViewSize();
+        LogUtils.d(TAG, "已设置 ImageView 默认背景");
+    }
+
+    @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_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/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

@@ -9,9 +9,6 @@
     <item
         android:id="@+id/action_changepicture"
         android:title="@string/item_changepicture"/>
-    <item
-        android:id="@+id/action_log"
-        android:title="@string/item_logview"/>
     <item
         android:id="@+id/action_about"
         android:title="@string/item_aboutview"/>

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,6 +1,7 @@
 <?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_description">一个接收手机电量信息的应用，当电量值达到设定范围时会提醒用户。</string>
     <string name="about_crashed">本应用崩溃了，作者水平有限，敬请谅解！</string>
     <string name="item_mainview">Main View</string>

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

@@ -1,9 +1,17 @@
 <?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</string>
+    <string name="cn1_switch_disabled">能源钟</string>
+    <string name="cn2_switch_disabled">泡额呗额</string>
     <string name="item_mainview">Main View</string>
     <string name="item_aboutview">About</string>
     <string name="item_battery_report">Battery Report</string>
@@ -11,6 +19,7 @@
     <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/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>

settings.gradle-demo

@@ -69,3 +69,7 @@
 // Positions 项目编译设置
 //include ':positions'
 //rootProject.name = "positions"
+
+// WinBoLL 项目编译设置
+//include ':winboll'
+//rootProject.name = "winboll"

winboll/build.gradle

@@ -0,0 +1,78 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+    compileSdkVersion 32
+    buildToolsVersion "32.0.0"
+
+    defaultConfig {
+        applicationId "cc.winboll.studio.winboll"
+        minSdkVersion 24
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.0"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    api fileTree(dir: 'libs', include: ['*.jar'])
+	
+    api 'com.google.code.gson:gson:2.10.1'
+	
+	// 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+    // 吐司类库
+    api 'com.github.getActivity:ToastUtils:10.5'
+    // 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+    // AndroidX 类库
+    api 'androidx.appcompat:appcompat:1.1.0'
+    api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'
+
+    api 'cc.winboll.studio:libaes:15.10.2'
+    api 'cc.winboll.studio:libapputils:15.10.2'
+	api 'cc.winboll.studio:libappbase:15.10.9'
+}

winboll/build.properties

@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Thu Nov 27 01:06:01 GMT 2025
+stageCount=3
+libraryProject=
+baseVersion=15.0
+publishVersion=15.0.2
+buildCount=15
+baseBetaVersion=15.0.3

winboll/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# 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 *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile