正在改进ToastUtils 20251111_210731_623

appbase/build.gradle

@@ -19,12 +19,15 @@ def genVersionName(def versionName){
 
 android {
     
-    compileSdkVersion 32
+    // 1. compileSdkVersion：必须 ≥ targetSdkVersion，建议直接等于 targetSdkVersion（30）
-    buildToolsVersion "32.0.0"
+    compileSdkVersion 30
+
+    // 2. buildToolsVersion：需匹配 compileSdkVersion，建议使用 30.x.x 最新稳定版（无需高于 compileSdkVersion）
+    buildToolsVersion "30.0.3" // 这是 30 对应的最新稳定版，避免使用 beta 版
 
     defaultConfig {
         applicationId "cc.winboll.studio.appbase"
-        minSdkVersion 24
+        minSdkVersion 23
         targetSdkVersion 30
         versionCode 1
         // versionName 更新后需要手动设置 

appbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Fri Sep 26 05:36:14 HKT 2025
+#Tue Nov 11 13:06:53 GMT 2025
-stageCount=9
+stageCount=10
 libraryProject=libappbase
 baseVersion=15.10
-publishVersion=15.10.8
+publishVersion=15.10.9
-buildCount=0
+buildCount=8
-baseBetaVersion=15.10.9
+baseBetaVersion=15.10.10

appbase/src/main/AndroidManifest.xml

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

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

@@ -8,10 +8,10 @@ import android.os.Bundle;
 import android.view.Menu;
 import android.view.MenuItem;
 import android.view.View;
-import android.widget.Toast;
 import android.widget.Toolbar;
 import cc.winboll.studio.appbase.R;
 import cc.winboll.studio.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libappbase.ToastUtils;
 
 public class MainActivity extends Activity {
@@ -56,6 +56,13 @@ public class MainActivity extends Activity {
     public void onLogTest(View view) {
         LogActivity.startLogActivity(this);
     }
+	
+	public void onToastUtilsTest(View view) {
+		LogUtils.d(TAG, "onToastUtilsTest");
+        ToastUtils.init(getApplicationContext());
+		ToastUtils.show("Hello, WinBoLL!");
+		ToastUtils.release();
+    }
 
 	/**
 	 * 唤起默认浏览器打开指定网站

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

@@ -28,7 +28,8 @@
 			android:background="#81C7F5"
 			android:paddingVertical="12dp"
 			android:layout_marginHorizontal="24dp"
-			android:onClick="onCrashTest"/>
+			android:onClick="onCrashTest"
+			android:layout_margin="10dp"/>
 
 		<Button
 			android:layout_width="match_parent"
@@ -39,7 +40,20 @@
 			android:background="#81C7F5"
 			android:paddingVertical="12dp"
 			android:layout_marginHorizontal="24dp"
-			android:onClick="onLogTest"/>
+			android:onClick="onLogTest"
+			android:layout_margin="10dp"/>
+
+		<Button
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="应用吐司测试"
+			android:textSize="16sp"
+			android:textColor="@android:color/white"
+			android:background="#81C7F5"
+			android:paddingVertical="12dp"
+			android:layout_marginHorizontal="24dp"
+			android:onClick="onToastUtilsTest"
+			android:layout_margin="10dp"/>
 
 	</LinearLayout>
 

libappbase/build.gradle

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

libappbase/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Fri Sep 26 05:36:14 HKT 2025
+#Tue Nov 11 13:06:53 GMT 2025
-stageCount=9
+stageCount=10
 libraryProject=libappbase
 baseVersion=15.10
-publishVersion=15.10.8
+publishVersion=15.10.9
-buildCount=0
+buildCount=8
-baseBetaVersion=15.10.9
+baseBetaVersion=15.10.10

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -213,7 +213,7 @@ public class LogView extends RelativeLayout {
         }
 
         // 加载标签列表
-        Map<String, Boolean> mapTAGList = LogUtils.getMapTAGList();
+        Map<String, Boolean> mapTAGList = LogUtils.getTagEnableMap();
         boolean isAllSelect = true;
         for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
             if (entry.getValue() == false) {
@@ -237,7 +237,7 @@ public class LogView extends RelativeLayout {
         mSelectAllTAGCheckBox.setOnClickListener(new View.OnClickListener(){
                 @Override
                 public void onClick(View v) {
-                    LogUtils.setALlTAGListEnable(mSelectAllTAGCheckBox.isChecked());
+                    LogUtils.setAllTagsEnable(mSelectAllTAGCheckBox.isChecked());
                     //LogUtils.setALlTAGListEnable(false);
                     //mTAGListAdapter.notifyDataSetChanged();
                     mTAGListAdapter.reload();
@@ -483,7 +483,7 @@ public class LogView extends RelativeLayout {
 
                     @Override
                     public void onClick(View v) {
-                        LogUtils.setTAGListEnable(item.getTag(), ((CheckBox)v).isChecked());
+                        LogUtils.setTagEnable(item.getTag(), ((CheckBox)v).isChecked());
                     }
                 });
 

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

@@ -1,34 +1,135 @@
 package cc.winboll.studio.libappbase;
 
 /**
- * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
- * @Date 2025/03/12 12:02:31
+ * @Date 2025/11/11 20:51
+ * @Describe 吐司工具类（单例模式）
+ * 简化 Android 吐司的创建与展示，通过 Handler 确保主线程显示，统一管理上下文，避免内存泄漏
  */
 import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
 import android.widget.Toast;
 
 public class ToastUtils {
 
+    /** 工具类日志 TAG（用于调试输出） */
     public static final String TAG = "ToastUtils";
+    /** 消息标识：显示短时长吐司 */
+    private static final int MSG_SHOW_SHORT_TOAST = 1001;
 
-    volatile static ToastUtils _ToastUtils;
+    /** 单例实例（volatile 保证多线程下可见性，避免指令重排） */
-    Context mContext;
+    private static volatile ToastUtils sInstance;
+    /** 全局上下文（建议传入 Application 实例，避免内存泄漏） */
+    private Context mContext;
+    /** 主线程 Handler（用于接收并处理吐司显示消息，确保 UI 操作在主线程） */
+    private static Handler _mMainHandler;
 
-    ToastUtils() {
+    /**
+     * 私有构造方法（禁止外部直接创建实例，确保单例）
+     * 初始化主线程 Handler，绑定主线程 Looper
+     */
+    private ToastUtils() {
+        // 初始化 Handler，绑定主线程 Looper（确保吐司在主线程显示）
+        _mMainHandler = new Handler(Looper.getMainLooper()) {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                // 处理消息：显示吐司
+                if (msg.what == MSG_SHOW_SHORT_TOAST && msg.obj != null) {
+                    String message = (String) msg.obj;
+                    showToastInternal(message);
+                }
+            }
+        };
     }
 
-    synchronized static ToastUtils getInstance() {
+    /**
-        if (_ToastUtils == null) {
+     * 获取单例实例（双重检查锁定，高效且线程安全）
-            _ToastUtils = new ToastUtils();
+     * @return ToastUtils 单例对象
+     */
+    private static ToastUtils getInstance() {
+        if (sInstance == null) { // 第一次检查（无锁，提升效率）
+            synchronized (ToastUtils.class) { // 加锁，确保线程安全
+                if (sInstance == null) { // 第二次检查（避免多线程并发创建多个实例）
+                    sInstance = new ToastUtils();
+                }
+            }
         }
-        return _ToastUtils;
+        return sInstance;
     }
 
+    /**
+     * 初始化工具类（必须在 Application 或 Activity 启动时调用）
+     * 传入全局上下文，用于创建 Toast 实例
+     * @param context 全局上下文（推荐传入 getApplicationContext()）
+     */
     public static void init(Context context) {
-        getInstance().mContext = context;
+        if (context == null) {
+            throw new IllegalArgumentException("初始化上下文不能为 null！");
+        }
+        // 初始化全局上下文（使用 Application 上下文，避免内存泄漏）
+        getInstance().mContext = context.getApplicationContext();
     }
 
+    /**
+     * 外部接口：显示短时长吐司（默认显示 2 秒）
+     * 接收外部消息参数，通过 Handler 发送消息到主线程
+     * @param message 吐司展示的文本内容（非空）
+     */
     public static void show(String message) {
-        Toast.makeText(getInstance().mContext, message, Toast.LENGTH_SHORT).show();
+        if (message == null || message.isEmpty()) {
+            return; // 空消息直接返回，避免无效显示
+        }
+        // 校验工具类是否初始化
+        if (getInstance().mContext == null) {
+            throw new IllegalStateException("ToastUtils 未初始化！请先调用 init(Context) 方法");
+        }
+        // 发送消息到主线程 Handler
+        getInstance().sendToastMessage(message);
+    }
+
+    /**
+     * 内部私有方法：发送吐司消息（通过 Handler 传递）
+     * 使用实例初始化时的全局上下文确保消息发送有效性
+     * @param message 吐司文本内容
+     */
+    private void sendToastMessage(String message) {
+        // 校验 Handler 和上下文是否有效
+        if (_mMainHandler == null || mContext == null) {
+            return;
+        }
+        // 创建消息对象，携带吐司内容
+        Message msg = _mMainHandler.obtainMessage(MSG_SHOW_SHORT_TOAST);
+        msg.obj = message;
+        // 发送消息（放入主线程消息队列）
+        _mMainHandler.sendMessage(msg);
+    }
+
+    /**
+     * 内部私有方法：实际显示吐司（运行在主线程）
+     * @param message 吐司文本内容
+     */
+    private void showToastInternal(String message) {
+        // 校验上下文有效性
+        if (mContext == null) {
+            return;
+        }
+        // 显示短时长吐司
+        Toast.makeText(mContext, message, Toast.LENGTH_SHORT).show();
+    }
+
+    /**
+     * 可选：释放资源（如在应用退出时调用）
+     * 移除 Handler 未处理的消息，避免内存泄漏
+     */
+    public static void release() {
+        if (getInstance()._mMainHandler != null) {
+            _mMainHandler.removeCallbacksAndMessages(null); // 移除所有未处理消息
+            _mMainHandler = null;
+        }
+        sInstance = null; // 销毁单例实例
     }
 }
+

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

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

positions/README.md

@@ -2,7 +2,6 @@
 
 #### 介绍
 安卓位置应用，有关于地理位置的相关应用。
-PS:使用感言~~~『記低用唔到』。
 
 #### 软件架构
 适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。

positions/build.gradle

@@ -46,9 +46,6 @@ android {
 dependencies {
     api fileTree(dir: 'libs', include: ['*.jar'])
 	
-	// https://mvnrepository.com/artifact/com.jzxiang.pickerview/TimePickerDialog
-	api 'com.jzxiang.pickerview:TimePickerDialog:1.0.1'
-	
 	// 谷歌定位服务核心依赖（FusedLocationProviderClient所在库）
     api 'com.google.android.gms:play-services-location:21.0.1'
     
@@ -62,7 +59,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'
     // AndroidX 类库

positions/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Tue Oct 28 14:17:09 HKT 2025
+#Thu Oct 02 13:16:14 GMT 2025
-stageCount=17
+stageCount=8
 libraryProject=
 baseVersion=15.0
-publishVersion=15.0.16
+publishVersion=15.0.7
-buildCount=0
+buildCount=29
-baseBetaVersion=15.0.17
+baseBetaVersion=15.0.8

positions/src/beta/res/values-zh/strings.xml

@@ -1,4 +1,4 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="app_name">悟空笔记#</string>
+    <string name="app_name">寻龙记#</string>
 </resources>

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

@@ -22,9 +22,9 @@ import android.widget.HorizontalScrollView;
 import android.widget.ScrollView;
 import android.widget.TextView;
 import android.widget.Toast;
-import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
 import cc.winboll.studio.libappbase.GlobalApplication;
-import cc.winboll.studio.libappbase.ToastUtils;
+import com.hjq.toast.ToastUtils;
+import com.hjq.toast.style.WhiteToastStyle;
 import java.io.ByteArrayInputStream;
 import java.io.ByteArrayOutputStream;
 import java.io.Closeable;
@@ -41,6 +41,7 @@ import java.util.Arrays;
 import java.util.Date;
 import java.util.LinkedHashMap;
 import java.util.concurrent.atomic.AtomicBoolean;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
 
 public class App extends GlobalApplication {
 
@@ -57,8 +58,8 @@ public class App extends GlobalApplication {
         ToastUtils.init(this);
         // 设置 Toast 布局样式
         //ToastUtils.setView(R.layout.view_toast);
-        //ToastUtils.setStyle(new WhiteToastStyle());
+        ToastUtils.setStyle(new WhiteToastStyle());
-        //ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
+        ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
         
         //CrashHandler.getInstance().registerGlobal(this);
         //CrashHandler.getInstance().registerPart(this);

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

@@ -21,7 +21,6 @@ import cc.winboll.studio.positions.activities.LocationActivity;
 import cc.winboll.studio.positions.activities.WinBoLLActivity;
 import cc.winboll.studio.positions.services.MainService;
 import cc.winboll.studio.positions.utils.AppConfigsUtil;
-import cc.winboll.studio.positions.utils.ServiceUtil;
 
 /**
  * 主页面：仅负责
@@ -142,11 +141,18 @@ public class MainActivity extends WinBoLLActivity implements IWinBoLLActivity {
 					// 权限就绪：执行服务启停逻辑
 					if (isChecked) {
 						LogUtils.d(TAG, "设置启动服务");
-						ServiceUtil.startAutoService(MainActivity.this);
+						AppConfigsUtil.getInstance(MainActivity.this).setIsEnableMainService(true);
+						// 启动服务（startService确保服务独立运行，不受Activity绑定影响）
+						startService(new Intent(MainActivity.this, MainService.class));
 					} else {
 						LogUtils.d(TAG, "设置关闭服务");
-
+						AppConfigsUtil.getInstance(MainActivity.this).setIsEnableMainService(false);
-						ServiceUtil.stopAutoService(MainActivity.this);
+						// 停止服务前先解绑，避免服务被Activity持有
+//						if (isServiceBound) {
+//							unbindService(mServiceConn);
+//							isServiceBound = false;
+//						}
+						stopService(new Intent(MainActivity.this, MainService.class));
 					}
 
 					mManagePositionsButton.setEnabled(isChecked);

positions/src/main/java/cc/winboll/studio/positions/activities/LocationActivity.java

@@ -5,27 +5,23 @@ package cc.winboll.studio.positions.activities;
  * @Date 2025/09/29 18:22
  * @Describe 位置列表页面（适配MainService GPS接口+规范服务交互+完善生命周期）
  */
-import android.app.Activity;
-import android.content.ComponentName;
-import android.content.Context;
-import android.content.Intent;
-import android.content.ServiceConnection;
 import android.os.Bundle;
 import android.os.IBinder;
-import android.view.View;
+import android.app.Activity;
-import android.view.inputmethod.InputMethodManager;
+import android.content.ComponentName;
-import android.widget.TextView;
+import android.content.Intent;
+import android.content.ServiceConnection;
 import android.widget.Toast;
 import androidx.recyclerview.widget.LinearLayoutManager;
 import androidx.recyclerview.widget.RecyclerView;
+
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.ToastUtils;
-import cc.winboll.studio.positions.R;
 import cc.winboll.studio.positions.adapters.PositionAdapter;
 import cc.winboll.studio.positions.models.PositionModel;
+import cc.winboll.studio.positions.models.PositionTaskModel;
 import cc.winboll.studio.positions.services.MainService;
+import cc.winboll.studio.positions.R;
 import java.util.ArrayList;
-import java.util.concurrent.atomic.AtomicBoolean;
 
 /**
  * Java 7 语法适配：
@@ -34,65 +30,37 @@ import java.util.concurrent.atomic.AtomicBoolean;
  * 3. 所有位置/任务操作通过 MainService 接口执行
  */
 public class LocationActivity extends Activity {
-    public static final String TAG = "LocationActivity";
+    private static final String TAG = "LocationActivity";
 
     private RecyclerView mRvPosition;
     private PositionAdapter mPositionAdapter;
-    
+    private ArrayList<PositionModel> mLocalPosCache; // 本地位置缓存（与MainService同步）
-    // MainService 引用+绑定状态（AtomicBoolean 确保多线程状态可见性）
+
+    // MainService 引用+绑定状态
     private MainService mMainService;
-    private final AtomicBoolean isServiceBound = new AtomicBoolean(false);
+    private boolean isServiceBound = false;
-    // 标记 Adapter 是否已初始化（避免重复初始化/销毁后初始化）
-    private final AtomicBoolean isAdapterInited = new AtomicBoolean(false);
 
-	// ---------------------- 新增：GPS监听核心变量 ----------------------
+    // 服务连接（Java 7 匿名内部类实现）
-    private MainService.GpsUpdateListener mGpsUpdateListener; // GPS监听实例
-    private PositionModel mCurrentGpsPos; // 缓存当前GPS位置（供页面使用）
-    // 本地位置缓存（解决服务数据未同步时Adapter空数据问题）
-    private final ArrayList<PositionModel> mLocalPosCache = new ArrayList<PositionModel>();
-
-
-    // 服务连接（Java 7 匿名内部类实现，强化状态同步+数据预加载）
     private ServiceConnection mServiceConnection = new ServiceConnection() {
         @Override
         public void onServiceConnected(ComponentName name, IBinder service) {
-            // 1. 安全获取服务实例（避免强转失败+服务未就绪）
+            // 假设 MainService 用 LocalBinder 暴露实例（Java 7 强转）
-            if (!(service instanceof MainService.LocalBinder)) {
+            MainService.LocalBinder binder = (MainService.LocalBinder) service;
-                LogUtils.e(TAG, "服务绑定失败：Binder类型不匹配（非MainService.LocalBinder）");
+            mMainService = binder.getService();
-                isServiceBound.set(false);
+            isServiceBound = true;
-                return;
-            }
 
-            try {
+            LogUtils.d(TAG, "MainService绑定成功，开始同步数据");
-                MainService.LocalBinder binder = (MainService.LocalBinder) service;
+            // 从MainService同步初始数据（位置+任务）
-                mMainService = binder.getService();
+            syncDataFromMainService();
-                // 2. 标记服务绑定成功（原子操作，确保多线程可见）
+            // 初始化Adapter（传入MainService实例，确保任务数据从服务获取）
-                isServiceBound.set(true);
+            initPositionAdapter();
-                LogUtils.d(TAG, "MainService绑定成功，开始同步数据+初始化Adapter");
-
-                // 3. 同步服务数据到本地缓存（核心：先同步数据，再初始化Adapter）
-                syncDataFromMainService();
-                // 4. 注册GPS监听（确保监听在Adapter前初始化，数据不丢失）
-                registerGpsListener();
-                // 5. 初始化Adapter（传入本地缓存+服务实例，数据非空）
-                initPositionAdapter();
-
-            } catch (Exception e) {
-                LogUtils.d(TAG, "服务绑定后初始化失败：" + e.getMessage());
-                isServiceBound.set(false);
-                mMainService = null;
-                showToast("服务初始化失败，无法加载数据");
-            }
         }
 
         @Override
         public void onServiceDisconnected(ComponentName name) {
-            LogUtils.w(TAG, "MainService断开连接，清空引用+标记状态");
+            LogUtils.w(TAG, "MainService断开连接，清空引用");
-            // 1. 清空服务引用+标记绑定状态
             mMainService = null;
-            isServiceBound.set(false);
+            isServiceBound = false;
-            // 2. 标记Adapter未初始化（下次绑定需重新初始化）
-            isAdapterInited.set(false);
         }
     };
 
@@ -101,361 +69,159 @@ public class LocationActivity extends Activity {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_location);
 
-        // 1. 初始化视图（优先执行，避免Adapter初始化时视图为空）
+        // 初始化视图+本地缓存
         initView();
-        // 2. 初始化GPS监听（提前创建，避免绑定服务后空指针）
+        mLocalPosCache = new ArrayList<PositionModel>();
-        initGpsUpdateListener();
+
-        // 3. 绑定MainService（最后执行，确保视图/监听已就绪）
+        // 绑定MainService（确保Activity启动时就拿到服务实例）
         bindMainService();
     }
 
     /**
-     * 初始化视图（RecyclerView）- 确保视图先于Adapter初始化
+     * 初始化视图（RecyclerView）
      */
     private void initView() {
         mRvPosition = (RecyclerView) findViewById(R.id.rv_position_list);
-        // 1. 显式设置布局管理器（避免Adapter设置时无布局管理器崩溃）
+        // Java 7 显式设置布局管理器（LinearLayoutManager）
         LinearLayoutManager layoutManager = new LinearLayoutManager(this);
         layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
         mRvPosition.setLayoutManager(layoutManager);
-        // 2. 初始化本地缓存（避免首次加载时缓存为空）
-        mLocalPosCache.clear();
-        LogUtils.d(TAG, "视图初始化完成（布局管理器+本地缓存已就绪）");
     }
 
     /**
-     * 绑定MainService（Java 7 显式Intent，强化绑定安全性）
+     * 绑定MainService（Java 7 显式Intent）
      */
     private void bindMainService() {
-        // 1. 避免重复绑定（快速重建Activity时防止多绑定）
-        if (isServiceBound.get()) {
-            LogUtils.w(TAG, "无需重复绑定：MainService已绑定");
-            return;
-        }
-
         Intent serviceIntent = new Intent(this, MainService.class);
-        // 2. 绑定服务（BIND_AUTO_CREATE：服务不存在时自动创建，增加绑定成功率）
+        // 绑定服务（BIND_AUTO_CREATE：服务不存在时自动创建）
-        boolean bindSuccess = bindService(serviceIntent, mServiceConnection, BIND_AUTO_CREATE);
+        bindService(serviceIntent, mServiceConnection, BIND_AUTO_CREATE);
-        if (!bindSuccess) {
+        LogUtils.d(TAG, "发起MainService绑定请求");
-            LogUtils.e(TAG, "发起MainService绑定请求失败（服务未找到/系统限制）");
-            showToast("服务绑定失败，无法加载位置数据");
-        } else {
-            LogUtils.d(TAG, "MainService绑定请求已发起");
-        }
     }
 
     /**
-     * 从MainService同步数据到本地缓存（核心解决Adapter空数据问题）
+     * 从MainService同步数据（位置+任务）
-     * 作用：1. 服务数据优先同步到本地，Adapter基于本地缓存初始化
-     *      2. 避免服务数据更新时直接操作Adapter，通过缓存中转
      */
     private void syncDataFromMainService() {
-        // 1. 安全校验（服务未绑定/服务空，用本地缓存兜底）
+        if (!isServiceBound || mMainService == null) {
-        if (!isServiceBound.get() || mMainService == null) {
+            LogUtils.w(TAG, "同步数据失败：MainService未绑定");
-            LogUtils.w(TAG, "同步数据：服务未就绪，使用本地缓存（当前缓存量=" + mLocalPosCache.size() + "）");
+            showToast("服务未就绪，无法加载数据");
             return;
         }
 
-        try {
+        // 同步位置数据（从服务获取最新列表）
-            // 2. 从服务获取最新位置数据（同步操作，确保数据拿到后再返回）
+        ArrayList<PositionModel> servicePosList = mMainService.getPositionList();
-            ArrayList<PositionModel> servicePosList = mMainService.getPositionList();
+        if (servicePosList != null && !servicePosList.isEmpty()) {
-            // 3. 同步到本地缓存（清空旧数据+添加新数据，避免重复）
+            mLocalPosCache.clear();
-            synchronized (mLocalPosCache) { // 加锁避免多线程操作缓存冲突
+            mLocalPosCache.addAll(servicePosList);
-                mLocalPosCache.clear();
+            LogUtils.d(TAG, "从MainService同步位置数据完成：数量=" + mLocalPosCache.size());
-                if (servicePosList != null && !servicePosList.isEmpty()) {
-                    mLocalPosCache.addAll(servicePosList);
-                }
-            }
-            LogUtils.d(TAG, "数据同步完成：服务位置数=" + (servicePosList == null ? 0 : servicePosList.size()) 
-                      + "，本地缓存数=" + mLocalPosCache.size());
-
-        } catch (Exception e) {
-            LogUtils.d(TAG, "同步服务数据失败：" + e.getMessage());
-            // 异常时保留本地缓存，避免Adapter无数据
-            LogUtils.w(TAG, "同步失败，使用本地缓存兜底（缓存量=" + mLocalPosCache.size() + "）");
         }
+
+        // 同步任务数据（无需本地缓存，Adapter直接从服务获取）
+        ArrayList<PositionTaskModel> serviceTaskList = mMainService.getAllTasks();
+        LogUtils.d(TAG, "从MainService同步任务数据完成：数量=" + serviceTaskList.size());
     }
 
     /**
-     * 初始化PositionAdapter（核心优化：基于本地缓存初始化，避免空数据）
+     * 初始化PositionAdapter（核心：传入MainService实例）
      */
     private void initPositionAdapter() {
-        // 1. 多重安全校验（避免销毁后初始化/重复初始化/依赖未就绪）
+        if (mMainService == null) {
-        if (isAdapterInited.get() || !isServiceBound.get() || mMainService == null || mRvPosition == null) {
+            LogUtils.e(TAG, "初始化Adapter失败：MainService为空");
-            LogUtils.w(TAG, "Adapter初始化跳过：" 
-                      + "已初始化=" + isAdapterInited.get() 
-                      + "，服务绑定=" + isServiceBound.get() 
-                      + "，视图就绪=" + (mRvPosition != null));
             return;
         }
 
-        try {
+        // Java 7 显式初始化Adapter，传入上下文+本地位置缓存+MainService实例
-            // 2. 基于本地缓存初始化Adapter（缓存已同步服务数据，非空）
+        mPositionAdapter = new PositionAdapter(this, mLocalPosCache, mMainService);
-            mPositionAdapter = new PositionAdapter(this, mLocalPosCache, mMainService);
 
-            // 3. 设置删除回调（删除时同步服务+本地缓存+Adapter）
+        // 设置Adapter回调（处理位置删除/保存，最终同步到MainService）
-            mPositionAdapter.setOnDeleteClickListener(new PositionAdapter.OnDeleteClickListener() {
+        mPositionAdapter.setOnDeleteClickListener(new PositionAdapter.OnDeleteClickListener() {
-                @Override
+				@Override
-                public void onDeleteClick(int position) {
+				public void onDeleteClick(int position) {
-                    // 安全校验（索引有效+服务绑定+缓存非空）
+					// 删除逻辑：先删本地缓存，再调用MainService接口删服务数据
-                    if (position < 0 || position >= mLocalPosCache.size() || !isServiceBound.get() || mMainService == null) {
+					if (position < 0 || position >= mLocalPosCache.size()) {
-                        LogUtils.w(TAG, "删除位置失败：索引无效/服务未就绪（索引=" + position + "，缓存量=" + mLocalPosCache.size() + "）");
+						LogUtils.w(TAG, "删除位置失败：无效索引=" + position);
-                        return;
+						return;
-                    }
+					}
+					PositionModel deletePos = mLocalPosCache.get(position);
+					if (deletePos != null && !deletePos.getPositionId().isEmpty()) {
+						// 1. 调用MainService接口删除服务端数据
+						mMainService.removePosition(deletePos.getPositionId());
+						// 2. 删除本地缓存数据
+						mLocalPosCache.remove(position);
+						// 3. 通知Adapter刷新
+						mPositionAdapter.notifyItemRemoved(position);
+						showToast("删除位置成功：" + deletePos.getMemo());
+						LogUtils.d(TAG, "删除位置完成：ID=" + deletePos.getPositionId() + "（已同步MainService）");
+					}
+				}
+			});
 
-                    PositionModel deletePos = mLocalPosCache.get(position);
+        mPositionAdapter.setOnSavePositionClickListener(new PositionAdapter.OnSavePositionClickListener() {
-                    if (deletePos != null && !deletePos.getPositionId().isEmpty()) {
+				@Override
-                        // 步骤1：调用服务删除（确保服务数据一致性）
+				public void onSavePositionClick(int position, PositionModel updatedPos) {
-                        mMainService.removePosition(deletePos.getPositionId());
+					// 保存逻辑：先更本地缓存，再调用MainService接口更新服务数据
-                        // 步骤2：删除本地缓存（确保缓存与服务同步）
+					if (!isServiceBound || mMainService == null) {
-                        synchronized (mLocalPosCache) {
+						LogUtils.w(TAG, "保存位置失败：MainService未绑定");
-                            mLocalPosCache.remove(position);
+						showToast("服务未就绪，保存失败");
-                        }
+						return;
-                        // 步骤3：通知Adapter刷新（基于缓存操作，避免空数据）
+					}
-                        mPositionAdapter.notifyItemRemoved(position);
+					if (position < 0 || position >= mLocalPosCache.size()) {
-                        showToast("删除位置成功：" + deletePos.getMemo());
+						LogUtils.w(TAG, "保存位置失败：无效索引=" + position);
-                        LogUtils.d(TAG, "删除位置完成：ID=" + deletePos.getPositionId() + "（服务+缓存已同步）");
+						return;
-                    }
+					}
-                }
-            });
 
-            // 4. 设置保存回调（保存时同步服务+本地缓存+Adapter）
+					// 1. 调用MainService接口更新服务端数据
-            mPositionAdapter.setOnSavePositionClickListener(new PositionAdapter.OnSavePositionClickListener() {
+					mMainService.updatePosition(updatedPos);
-                @Override
+					// 2. 更新本地缓存数据
-                public void onSavePositionClick(int position, PositionModel updatedPos) {
+					mLocalPosCache.set(position, updatedPos);
-                    // 安全校验（索引有效+服务绑定+数据非空）
+					// 3. 通知Adapter刷新（可选，Adapter已本地同步）
-                    if (!isServiceBound.get() || mMainService == null 
+					mPositionAdapter.notifyItemChanged(position);
-                        || position < 0 || position >= mLocalPosCache.size() || updatedPos == null) {
+					showToast("保存位置成功：" + updatedPos.getMemo());
-                        LogUtils.w(TAG, "保存位置失败：服务未就绪/索引无效/数据空");
+					LogUtils.d(TAG, "保存位置完成：ID=" + updatedPos.getPositionId() + "（已同步MainService）");
-                        showToast("服务未就绪，保存失败");
+				}
-                        return;
+			});
-                    }
 
-                    // 步骤1：调用服务更新（确保服务数据一致性）
+        // 设置Adapter到RecyclerView
-                    mMainService.updatePosition(updatedPos);
+        mRvPosition.setAdapter(mPositionAdapter);
-                    // 步骤2：更新本地缓存（确保缓存与服务同步）
+        LogUtils.d(TAG, "PositionAdapter初始化完成（已绑定MainService）");
-                    synchronized (mLocalPosCache) {
-                        mLocalPosCache.set(position, updatedPos);
-                    }
-                    // 步骤3：通知Adapter刷新（基于缓存操作，避免空数据）
-                    mPositionAdapter.notifyItemChanged(position);
-                    showToast("保存位置成功：" + updatedPos.getMemo());
-                    LogUtils.d(TAG, "保存位置完成：ID=" + updatedPos.getPositionId() + "（服务+缓存已同步）");
-                }
-            });
-
-            // 5. 设置Adapter到RecyclerView（最后一步，确保Adapter已配置完成）
-            mRvPosition.setAdapter(mPositionAdapter);
-            // 6. 标记Adapter已初始化（避免重复初始化）
-            isAdapterInited.set(true);
-            LogUtils.d(TAG, "PositionAdapter初始化完成（基于本地缓存，数据量=" + mLocalPosCache.size() + "）");
-
-        } catch (Exception e) {
-            LogUtils.d(TAG, "Adapter初始化失败：" + e.getMessage());
-            isAdapterInited.set(false);
-            mPositionAdapter = null;
-            showToast("位置列表初始化失败，请重试");
-        }
     }
 
     /**
-     * 显示Toast（Java 7 显式Toast.makeText，避免空Context）
+     * 显示Toast（Java 7 显式Toast.makeText）
      */
     private void showToast(String content) {
-        if (isFinishing() || isDestroyed()) { // 避免Activity销毁后弹Toast崩溃
-            LogUtils.w(TAG, "Activity已销毁，跳过Toast：" + content);
-            return;
-        }
         Toast.makeText(this, content, Toast.LENGTH_SHORT).show();
     }
-	
-	// ---------------------- 页面交互（新增位置逻辑保留，适配GPS数据） ----------------------
-    /**
-     * 新增位置（调用服务addPosition()，可选：用当前GPS位置初始化新位置）
-     */
-    public void addNewPosition(View view) {
-        // 1. 隐藏软键盘（避免软键盘遮挡操作）
-        InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
-        if (imm != null && getCurrentFocus() != null) {
-            imm.hideSoftInputFromWindow(getCurrentFocus().getWindowToken(), 0);
-        }
-
-        // 2. 安全校验（服务未绑定，不允许新增）
-        if (!isServiceBound.get() || mMainService == null) {
-            LogUtils.w(TAG, "新增位置失败：MainService未绑定");
-            showToast("服务未就绪，无法新增位置");
-            return;
-        }
-
-        // 3. 创建新位置模型（优化：优先用当前GPS位置初始化，无则用默认值）
-        PositionModel newPos = new PositionModel();
-        newPos.setPositionId(PositionModel.genPositionId()); // 生成唯一ID（需PositionModel实现）
-        if (mCurrentGpsPos != null) {
-            newPos.setLongitude(mCurrentGpsPos.getLongitude());
-            newPos.setLatitude(mCurrentGpsPos.getLatitude());
-            newPos.setMemo("当前GPS位置（可编辑）");
-        } else {
-            newPos.setLongitude(116.404267); // 北京经度（默认值）
-            newPos.setLatitude(39.915119);  // 北京纬度（默认值）
-            newPos.setMemo("默认位置（可编辑备注）");
-        }
-        newPos.setIsSimpleView(true);   // 默认简单视图
-        newPos.setIsEnableRealPositionDistance(true); // 启用距离计算（依赖GPS）
-
-        // 4. 调用服务新增+同步本地缓存（确保缓存与服务一致）
-        mMainService.addPosition(newPos);
-        synchronized (mLocalPosCache) {
-            mLocalPosCache.add(newPos);
-        }
-        LogUtils.d(TAG, "通过服务新增位置：ID=" + newPos.getPositionId() + "，纬度=" + newPos.getLatitude() + "（缓存已同步）");
-
-        // 5. 刷新Adapter（基于缓存操作，确保数据立即显示）
-        if (isAdapterInited.get() && mPositionAdapter != null) {
-            mPositionAdapter.notifyItemInserted(mLocalPosCache.size() - 1);
-        }
-        showToast("新增位置成功（已启用GPS距离计算）");
-    }
-
-	// ---------------------- 新增：GPS监听初始化+注册/反注册（核心适配逻辑） ----------------------
-    /**
-     * 初始化GPS监听：实现MainService.GpsUpdateListener，接收实时GPS数据
-     */
-    private void initGpsUpdateListener() {
-        LogUtils.d(TAG, "initGpsUpdateListener()");
-        mGpsUpdateListener = new MainService.GpsUpdateListener() {
-            @Override
-            public void onGpsPositionUpdated(PositionModel currentGpsPos) {
-                if (currentGpsPos == null || isFinishing() || isDestroyed()) {
-                    LogUtils.w(TAG, "GPS位置更新：数据为空或Activity已销毁");
-                    return;
-                }
-                // 缓存当前GPS位置（供页面其他逻辑使用）
-                mCurrentGpsPos = currentGpsPos;
-                LogUtils.d(TAG, String.format("收到GPS更新：纬度=%.4f，经度=%.4f"
-                                              , currentGpsPos.getLatitude(), currentGpsPos.getLongitude()));
-                // 安全更新UI（避免Activity销毁后操作视图崩溃）
-                ((TextView)findViewById(R.id.tv_latitude)).setText(String.format("当前纬度：%f", currentGpsPos.getLatitude()));
-                ((TextView)findViewById(R.id.tv_longitude)).setText(String.format("当前经度：%f", currentGpsPos.getLongitude()));
-            }
-
-            @Override
-            public void onGpsStatusChanged(String status) {
-                if (status == null || isFinishing() || isDestroyed()) return;
-                LogUtils.d(TAG, "GPS状态变化：" + status);
-                if (status.contains("未开启") || status.contains("权限") || status.contains("失败")) {
-                    ToastUtils.show("GPS提示：" + status);
-                }
-            }
-        };
-    }
-
-	/**
-     * 注册GPS监听：调用MainService的PUBLIC方法，绑定监听
-     */
-    private void registerGpsListener() {
-        // 安全校验（避免Activity销毁/服务未绑定/监听为空时注册）
-        if (isFinishing() || isDestroyed() || !isServiceBound.get() || mMainService == null || mGpsUpdateListener == null) {
-            LogUtils.w(TAG, "GPS监听注册跳过：Activity状态异常/依赖未就绪");
-            return;
-        }
-        try {
-            mMainService.registerGpsUpdateListener(mGpsUpdateListener);
-            LogUtils.d(TAG, "GPS监听已注册");
-        } catch (Exception e) {
-            LogUtils.d(TAG, "GPS监听注册失败：" + e.getMessage());
-        }
-    }
-
-    /**
-     * 反注册GPS监听：调用MainService的PUBLIC方法，解绑监听（核心防内存泄漏+数据异常）
-     */
-    private void unregisterGpsListener() {
-        // 避免Activity销毁后调用服务方法（防止空指针/服务已解绑）
-        if (mMainService == null || mGpsUpdateListener == null) {
-            LogUtils.w(TAG, "GPS监听反注册跳过：服务/监听未初始化");
-            return;
-        }
-        try {
-            mMainService.unregisterGpsUpdateListener(mGpsUpdateListener);
-            LogUtils.d(TAG, "GPS监听已反注册");
-        } catch (Exception e) {
-            LogUtils.d(TAG, "GPS监听反注册失败：" + e.getMessage());
-        }
-    }
-
-    /**
-     * 页面可见时同步数据（解决快速切回时数据未更新问题）
-     * 场景：快速关闭再打开Activity，服务已绑定但数据未重新同步
-     */
-    @Override
-    protected void onResume() {
-        super.onResume();
-        // 1. 服务已绑定但Adapter未初始化：重新同步数据+初始化Adapter
-        if (isServiceBound.get() && mMainService != null && !isAdapterInited.get()) {
-            LogUtils.d(TAG, "onResume：服务已绑定但Adapter未初始化，重新同步数据");
-            syncDataFromMainService();
-            initPositionAdapter();
-        }
-        // 2. 服务已绑定且Adapter已初始化：刷新数据（确保与服务同步）
-        else if (isServiceBound.get() && mMainService != null && isAdapterInited.get() && mPositionAdapter != null) {
-            syncDataFromMainService();
-            mPositionAdapter.notifyDataSetChanged();
-            LogUtils.d(TAG, "onResume：刷新位置数据（与服务同步）");
-        }
-    }
-
-    /**
-     * 页面不可见时暂停操作（避免后台操作导致数据异常）
-     */
-    @Override
-    protected void onPause() {
-        super.onPause();
-        // 避免后台时仍执行UI刷新（如GPS更新触发的视图操作）
-        LogUtils.d(TAG, "onPause：页面不可见，暂停UI相关操作");
-    }
 
     @Override
     protected void onDestroy() {
         super.onDestroy();
-        LogUtils.d(TAG, "onDestroy：开始释放资源");
 
-        // 1. 反注册GPS监听（优先执行，避免服务持有Activity引用导致内存泄漏）
+        // 1. 释放Adapter资源（反注册服务监听，避免内存泄漏）
-        unregisterGpsListener();
-
-        // 2. 释放Adapter资源（反注册可能的监听，避免内存泄漏）
         if (mPositionAdapter != null) {
             mPositionAdapter.release();
-            mPositionAdapter = null; // 清空引用，帮助GC回收
-            LogUtils.d(TAG, "Adapter资源已释放");
         }
 
-        // 3. 解绑MainService（最后执行，确保其他资源已释放）
+        // 2. 解绑MainService（避免Activity销毁后服务仍被持有）
-        if (isServiceBound.get()) {
+        if (isServiceBound) {
-            try {
+            unbindService(mServiceConnection);
-                unbindService(mServiceConnection);
+            LogUtils.d(TAG, "MainService解绑完成");
-                LogUtils.d(TAG, "MainService解绑完成");
-            } catch (IllegalArgumentException e) {
-                // 捕获“服务未绑定”异常（快速开关时可能出现，避免崩溃）
-                LogUtils.d(TAG, "解绑MainService失败：服务未绑定（可能已提前解绑）");
-            }
-            // 重置绑定状态+服务引用
-            isServiceBound.set(false);
-            mMainService = null;
         }
-
-        // 4. 清空本地缓存+GPS引用（帮助GC回收）
-        synchronized (mLocalPosCache) {
-            mLocalPosCache.clear();
-        }
-        mCurrentGpsPos = null;
-        mGpsUpdateListener = null;
-        isAdapterInited.set(false);
-        LogUtils.d(TAG, "所有资源释放完成（onDestroy执行结束）");
     }
+	
+	public static class LocalBinder extends android.os.Binder {
+        // 持有 MainService 实例引用
+        private MainService mService;
 
-    // ---------------------- 移除重复定义：LocalBinder 统一在 MainService 中定义 ----------------------
+        // 构造时传入服务实例
-    // 说明：原LocationActivity中的LocalBinder是重复定义（MainService已实现），会导致类型强转失败
+        public LocalBinder(MainService service) {
-    // 此处删除该类，确保Activity绑定服务时强转的是MainService中的LocalBinder
+            this.mService = service;
+        }
+
+        // 对外提供获取服务实例的方法（供Activity调用）
+        public MainService getService() {
+            return mService;
+        }
+    }
 }
 
-

positions/src/main/java/cc/winboll/studio/positions/models/PositionTaskModel.java

@@ -26,22 +26,19 @@ public class PositionTaskModel extends BaseBean {
 	boolean isLessThan;
 	// 任务条件距离（单位：米）
 	int discussDistance;
-	// 任务开始启用时间
-	long startTime;
 	// 任务是否已触发
 	boolean isBingo = false;
 	// 是否启用任务
 	boolean isEnable;
 
 	// 带参构造（强制传入positionId，确保任务与位置绑定）
-	public PositionTaskModel(String taskId, String positionId, String taskDescription, boolean isGreaterThan, int discussDistance, long startTime, boolean isEnable) {
+	public PositionTaskModel(String taskId, String positionId, String taskDescription, boolean isGreaterThan, int discussDistance, boolean isEnable) {
 		this.taskId = (taskId == null || taskId.trim().isEmpty()) ? genTaskId() : taskId; // 空ID自动生成
 		this.positionId = positionId; // 强制绑定位置ID
 		this.taskDescription = (taskDescription == null || taskDescription.trim().isEmpty()) ? "新任务" : taskDescription;
 		this.isGreaterThan = isGreaterThan;
 		this.isLessThan = !isGreaterThan; // 确保互斥
 		this.discussDistance = Math.max(discussDistance, 1); // 距离最小1米，避免无效值
-		this.startTime = startTime;
 		this.isEnable = isEnable;
 	}
 	
@@ -53,18 +50,9 @@ public class PositionTaskModel extends BaseBean {
 		this.isGreaterThan = true;
 		this.isLessThan = false; // 初始互斥
 		this.discussDistance = 100; // 默认100米
-		this.startTime = System.currentTimeMillis();
 		this.isEnable = true;
 	}
 
-	public void setStartTime(long startTime) {
-		this.startTime = startTime;
-	}
-
-	public long getStartTime() {
-		return startTime;
-	}
-
 	public void setIsBingo(boolean isBingo) {
 		this.isBingo = isBingo;
 	}
@@ -156,7 +144,6 @@ public class PositionTaskModel extends BaseBean {
 		jsonWriter.name("isGreaterThan").value(isGreaterThan());
 		jsonWriter.name("isLessThan").value(isLessThan());
 		jsonWriter.name("discussDistance").value(getDiscussDistance());
-		jsonWriter.name("startTime").value(getStartTime());
 		jsonWriter.name("isEnable").value(isEnable());
 	}
 
@@ -178,8 +165,6 @@ public class PositionTaskModel extends BaseBean {
 				setIsLessThan(jsonReader.nextBoolean());
 			} else if (name.equals("discussDistance")) {
 				setDiscussDistance(jsonReader.nextInt());
-			} else if (name.equals("startTime")) {
-				setStartTime(jsonReader.nextLong());
 			} else if (name.equals("isEnable")) {
 				setIsEnable(jsonReader.nextBoolean());
 			} else {

positions/src/main/java/cc/winboll/studio/positions/services/AssistantService.java

@@ -18,8 +18,7 @@ import cc.winboll.studio.positions.utils.ServiceUtil;
 public class AssistantService extends Service {
 
     public final static String TAG = "AssistantService";
-	public static final String EXTRA_IS_SETTING_TO_ENABLE = "EXTRA_IS_SETTING_TO_ENABLE";
+
-	
     MyServiceConnection mMyServiceConnection;
     volatile boolean mIsServiceRunning;
     AppConfigsUtil mAppConfigsUtil;
@@ -38,18 +37,13 @@ public class AssistantService extends Service {
         }
         // 设置运行参数
         mIsServiceRunning = false;
-        if (mAppConfigsUtil.isEnableMainService(true)) {
+        run();
-			run();
-		}
     }
 
     @Override
     public int onStartCommand(Intent intent, int flags, int startId) {
-		if (mAppConfigsUtil.isEnableMainService(true)) {
+        run();
-			run();
+        return START_STICKY;
-		}
-
-        return  mAppConfigsUtil.isEnableMainService(true) ? Service.START_STICKY : super.onStartCommand(intent, flags, startId);
     }
 
     @Override

positions/src/main/java/cc/winboll/studio/positions/services/MainService.java

@@ -20,14 +20,16 @@ import android.os.Handler;
 import android.os.IBinder;
 import android.os.Looper;
 import android.text.TextUtils;
+import android.util.Log;
+
 import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.ToastUtils;
 import cc.winboll.studio.positions.models.PositionModel;
 import cc.winboll.studio.positions.models.PositionTaskModel;
 import cc.winboll.studio.positions.utils.AppConfigsUtil;
-import cc.winboll.studio.positions.utils.DistanceCalculatorUtil;
 import cc.winboll.studio.positions.utils.NotificationUtil;
 import cc.winboll.studio.positions.utils.ServiceUtil;
+import com.hjq.toast.ToastUtils;
+
 import java.lang.ref.WeakReference;
 import java.util.ArrayList;
 import java.util.HashSet;
@@ -35,19 +37,11 @@ import java.util.Iterator;
 import java.util.Set;
 import java.util.concurrent.Executors;
 import java.util.concurrent.ScheduledExecutorService;
-import java.util.concurrent.TimeUnit; // 新增：定时器时间单位依赖
 
 public class MainService extends Service {
 
     public static final String TAG = "MainService";
 
-	public static final String EXTRA_IS_SETTING_TO_ENABLE = "EXTRA_IS_SETTING_TO_ENABLE";
-
-    // ---------------------- 新增：定时器相关变量 ----------------------
-    private ScheduledExecutorService taskCheckTimer; // 任务校验定时器
-    private static final long TASK_CHECK_INTERVAL = 1; // 定时间隔（1分钟）
-    private static final long TASK_CHECK_INIT_DELAY = 1; // 初始延迟（1分钟：立即启动）
-
     // GPS监听接口（Java 7 标准接口定义，无Lambda依赖）
     public interface GpsUpdateListener {
         void onGpsPositionUpdated(PositionModel currentGpsPos);
@@ -75,8 +69,8 @@ public class MainService extends Service {
 
     // 数据存储集合（Java 7 基础集合，避免Stream/forEach等Java 8+特性）
     private final ArrayList<PositionModel> mPositionList = new ArrayList<PositionModel>();   // 位置数据列表
-    private final ArrayList<PositionTaskModel> mAllTasks = new ArrayList<PositionTaskModel>();// 任务数据列表
+    private final ArrayList<PositionTaskModel> mTaskList = new ArrayList<PositionTaskModel>();// 任务数据列表
-    private static PositionModel _mCurrentGpsPosition; // 当前GPS定位数据
+    private PositionModel mCurrentGpsPosition; // 当前GPS定位数据
 
     // 服务相关变量（Java 7 显式声明，保持原逻辑）
     MyServiceConnection mMyServiceConnection;
@@ -90,51 +84,6 @@ public class MainService extends Service {
     private static Context sAppContext;
 
 
-    // =========================================================================
-    // 新增：定时器初始化方法（创建单线程定时器，每1分钟调用任务校验）
-    // =========================================================================
-    private void initTaskCheckTimer() {
-        // 先销毁旧定时器（避免重复创建导致多线程问题）
-        if (taskCheckTimer != null && !taskCheckTimer.isShutdown()) {
-            taskCheckTimer.shutdown();
-        }
-
-        // 创建单线程定时器（确保任务串行执行，避免并发异常）
-        taskCheckTimer = Executors.newSingleThreadScheduledExecutor();
-        // 定时任务：初始延迟1分钟，每1分钟执行一次
-        taskCheckTimer.scheduleAtFixedRate(new Runnable() {
-				@Override
-				public void run() {
-					LogUtils.d(TAG, "定时任务触发：开始校验任务（间隔1分钟）");
-					// 调用任务校验核心方法（与GPS位置变化时逻辑一致）
-					DistanceCalculatorUtil.getInstance(MainService.this).checkAllTaskTriggerCondition(MainService._mCurrentGpsPosition);
-				}
-			}, TASK_CHECK_INIT_DELAY, TASK_CHECK_INTERVAL, TimeUnit.MINUTES);
-
-        LogUtils.d(TAG, "任务校验定时器已启动（间隔：" + TASK_CHECK_INTERVAL + "分钟）");
-    }
-
-    // =========================================================================
-    // 新增：定时器销毁方法（服务销毁时调用，避免内存泄漏）
-    // =========================================================================
-    private void destroyTaskCheckTimer() {
-        if (taskCheckTimer != null && !taskCheckTimer.isShutdown()) {
-            taskCheckTimer.shutdown(); // 优雅关闭：等待已提交任务执行完成
-            try {
-                // 等待1秒，若未终止则强制关闭
-                if (!taskCheckTimer.awaitTermination(1, TimeUnit.SECONDS)) {
-                    taskCheckTimer.shutdownNow(); // 强制终止未完成任务
-                }
-            } catch (InterruptedException e) {
-                taskCheckTimer.shutdownNow(); // 捕获中断异常，强制关闭
-                Thread.currentThread().interrupt(); // 恢复线程中断状态
-            } finally {
-                taskCheckTimer = null; // 置空，避免重复操作
-                LogUtils.d(TAG, "任务校验定时器已销毁");
-            }
-        }
-    }
-
     // =========================================================================
     // 任务操作核心接口（Java 7 实现，全迭代器遍历，无ConcurrentModificationException）
     // =========================================================================
@@ -142,7 +91,7 @@ public class MainService extends Service {
      * 新增任务（Adapter调用，通过MainService统一管理任务，保证数据一致性）
      * @param newTask 待新增的任务模型
      */
-    public void addTask(PositionTaskModel newTask) {
+    public void addPositionTask(PositionTaskModel newTask) {
         // 参数校验（Java 7 基础判断，无Optional等Java 8+特性）
         if (newTask == null || TextUtils.isEmpty(newTask.getPositionId())) {
             LogUtils.w(TAG, "addPositionTask：任务为空或未绑定位置ID，新增失败");
@@ -151,7 +100,7 @@ public class MainService extends Service {
 
         // 任务去重（Java 7 迭代器遍历，避免增强for循环删除/新增导致的并发异常）
         boolean isDuplicate = false;
-        Iterator<PositionTaskModel> taskIter = mAllTasks.iterator();
+        Iterator<PositionTaskModel> taskIter = mTaskList.iterator();
         while (taskIter.hasNext()) {
             PositionTaskModel task = taskIter.next();
             if (newTask.getTaskId().equals(task.getTaskId())) {
@@ -165,8 +114,8 @@ public class MainService extends Service {
         }
 
         // 新增任务+持久化+通知刷新（全Java 7 语法）
-        mAllTasks.add(newTask);
+        mTaskList.add(newTask);
-        saveAllTasks();
+        saveTaskList();
         notifyTaskUpdated(); // 通知所有监听者（如Adapter）任务已更新
         LogUtils.d(TAG, "addPositionTask：成功（位置ID=" + newTask.getPositionId() + "，任务ID=" + newTask.getTaskId() + "）");
     }
@@ -178,12 +127,12 @@ public class MainService extends Service {
      */
     public ArrayList<PositionTaskModel> getTasksByPositionId(String positionId) {
         ArrayList<PositionTaskModel> posTasks = new ArrayList<PositionTaskModel>();
-        if (TextUtils.isEmpty(positionId) || mAllTasks.isEmpty()) {
+        if (TextUtils.isEmpty(positionId) || mTaskList.isEmpty()) {
             return posTasks;
         }
 
         // 筛选任务（Java 7 迭代器遍历，安全筛选）
-        Iterator<PositionTaskModel> taskIter = mAllTasks.iterator();
+        Iterator<PositionTaskModel> taskIter = mTaskList.iterator();
         while (taskIter.hasNext()) {
             PositionTaskModel task = taskIter.next();
             if (positionId.equals(task.getPositionId())) {
@@ -198,51 +147,26 @@ public class MainService extends Service {
      * @return 所有任务的拷贝列表
      */
     public ArrayList<PositionTaskModel> getAllTasks() {
-        return mAllTasks; // Java 7 集合拷贝方式
+        return new ArrayList<PositionTaskModel>(mTaskList); // Java 7 集合拷贝方式
     }
 
-	public void updateTask(PositionTaskModel updatedTask) {
-        if (updatedTask == null || updatedTask.getTaskId() == null) return;
-        for (int i = 0; i < mAllTasks.size(); i++) {
-            PositionTaskModel task = mAllTasks.get(i);
-            if (updatedTask.getTaskId().equals(task.getTaskId())) {
-                mAllTasks.set(i, updatedTask); // 替换为更新后的任务
-                break;
-            }
-		}
-        saveAllTasks(); // 持久化更新后的数据
-    }
-
-    // 4. 仅更新任务启用状态（优化性能，避免全量字段更新）
-    public void updateTaskStatus(PositionTaskModel task) {
-        if (task == null || task.getTaskId() == null) return;
-        for (PositionTaskModel item : mAllTasks) {
-            if (task.getTaskId().equals(item.getTaskId())) {
-                item.setIsEnable(task.isEnable()); // 只更新启用状态字段
-                break;
-            }
-        }
-        saveAllTasks(); // 持久化状态变更
-    }
-
-
     /**
      * 删除任务（Adapter调用，通过迭代器安全删除，避免并发异常）
      * @param taskId 待删除任务的ID
      */
-    public void deleteTask(String taskId) {
+    public void deletePositionTask(String taskId) {
-        if (TextUtils.isEmpty(taskId) || mAllTasks.isEmpty()) {
+        if (TextUtils.isEmpty(taskId) || mTaskList.isEmpty()) {
             LogUtils.w(TAG, "deletePositionTask：任务ID为空或列表为空，删除失败");
             return;
         }
 
         // 迭代器删除（Java 7 唯一安全删除集合元素的方式）
-        Iterator<PositionTaskModel> taskIter = mAllTasks.iterator();
+        Iterator<PositionTaskModel> taskIter = mTaskList.iterator();
         while (taskIter.hasNext()) {
             PositionTaskModel task = taskIter.next();
             if (taskId.equals(task.getTaskId())) {
                 taskIter.remove(); // 迭代器安全删除，无ConcurrentModificationException
-                saveAllTasks();
+                saveTaskList();
                 notifyTaskUpdated();
                 LogUtils.d(TAG, "deletePositionTask：成功（任务ID=" + taskId + "）");
                 break;
@@ -323,10 +247,8 @@ public class MainService extends Service {
      */
     public static synchronized MainService getInstance(Context context) {
         if (sInstance == null) {
-			if (AppConfigsUtil.getInstance(context).isEnableMainService(true)) {
+            Intent intent = new Intent(context.getApplicationContext(), MainService.class);
-				Intent intent = new Intent(context.getApplicationContext(), MainService.class);
+            context.getApplicationContext().startService(intent);
-				context.getApplicationContext().startService(intent);
-			}
             return null;
         }
         if (sAppContext == null) {
@@ -365,14 +287,11 @@ public class MainService extends Service {
             mMyServiceConnection = new MyServiceConnection();
         }
 
-		if (mAppConfigsUtil.isEnableMainService(true)) {
+        run(); // 启动服务核心逻辑
-			run(); // 启动服务核心逻辑
-		}
     }
 
     /**
      * 服务核心逻辑（启动前台服务、初始化GPS、加载数据等）
-     * 【关键修改】新增定时器初始化，每1分钟调用任务校验
      */
     public void run() {
         if (mAppConfigsUtil.isEnableMainService(true)) {
@@ -393,15 +312,11 @@ public class MainService extends Service {
 
                 // 加载本地数据（Java 7 静态方法调用，无方法引用）
                 PositionModel.loadBeanList(MainService.this, mPositionList, PositionModel.class);
-                PositionTaskModel.loadBeanList(MainService.this, mAllTasks, PositionTaskModel.class);
+                PositionTaskModel.loadBeanList(MainService.this, mTaskList, PositionTaskModel.class);
 
-				// 提示与日志（Java 7 基础调用）
+                // 提示与日志（Java 7 基础调用）
                 ToastUtils.show(initialStatus);
                 LogUtils.i(TAG, initialStatus);
-
-                // ---------------------- 关键新增：启动任务校验定时器 ----------------------
-				//checkAllTaskTriggerCondition();
-				initTaskCheckTimer();
             }
         }
     }
@@ -416,7 +331,6 @@ public class MainService extends Service {
 
     /**
      * 服务销毁回调（清理资源、停止GPS、清空数据、反注册监听等）
-     * 【关键修改】新增定时器销毁，避免内存泄漏
      */
     @Override
     public void onDestroy() {
@@ -434,13 +348,6 @@ public class MainService extends Service {
             mTaskListeners.clear();
         }
 
-        // ---------------------- 关键新增：销毁任务校验定时器 ----------------------
-        destroyTaskCheckTimer();
-        // 销毁距离计算线程池（原有逻辑，补充确保线程安全）
-        if (distanceExecutor != null && !distanceExecutor.isShutdown()) {
-            distanceExecutor.shutdown();
-        }
-
         // 重置状态变量
         _mIsServiceRunning = false;
         isGpsEnabled = false;
@@ -464,7 +371,7 @@ public class MainService extends Service {
      * @return 当前GPS定位模型（未获取时返回null）
      */
     public PositionModel getCurrentGpsPosition() {
-        return _mCurrentGpsPosition;
+        return mCurrentGpsPosition;
     }
 
     /**
@@ -518,9 +425,9 @@ public class MainService extends Service {
             return;
         }
         // 全量替换+持久化+通知（Java 7 基础集合操作）
-        mAllTasks.clear();
+        mTaskList.clear();
-        mAllTasks.addAll(newTaskList);
+        mTaskList.addAll(newTaskList);
-        saveAllTasks();
+        saveTaskList();
         notifyTaskUpdated();
     }
 
@@ -558,9 +465,9 @@ public class MainService extends Service {
     /**
      * 持久化任务数据（Java 7 静态方法调用，保持原逻辑）
      */
-    public void saveAllTasks() {
+    void saveTaskList() {
-        LogUtils.d(TAG, String.format("saveTaskList : size=%d", mAllTasks.size()));
+        LogUtils.d(TAG, String.format("saveTaskList : size=%d", mTaskList.size()));
-        PositionTaskModel.saveBeanList(MainService.this, mAllTasks, PositionTaskModel.class);
+        PositionTaskModel.saveBeanList(MainService.this, mTaskList, PositionTaskModel.class);
     }
 
     /**
@@ -568,8 +475,8 @@ public class MainService extends Service {
      */
     public void clearAllData() {
         mPositionList.clear();
-        mAllTasks.clear();
+        mTaskList.clear();
-        _mCurrentGpsPosition = null;
+        mCurrentGpsPosition = null;
         LogUtils.d(TAG, "clearAllData：已清空所有数据");
     }
 
@@ -582,7 +489,7 @@ public class MainService extends Service {
             LogUtils.w(TAG, "syncCurrentGpsPosition：位置为空");
             return;
         }
-        this._mCurrentGpsPosition = position;
+        this.mCurrentGpsPosition = position;
         LogUtils.d(TAG, "syncCurrentGpsPosition：成功（纬度=" + position.getLatitude() + "，经度=" + position.getLongitude() + "）");
         notifyAllGpsListeners(position);
 
@@ -596,14 +503,14 @@ public class MainService extends Service {
      * 同步GPS状态到前台通知（Java 7 匿名Runnable切换主线程，无Lambda）
      */
     private void syncGpsStatusToNotification() {
-        if (!_mIsServiceRunning || _mCurrentGpsPosition == null) {
+        if (!_mIsServiceRunning || mCurrentGpsPosition == null) {
             return;
         }
         // 格式化通知内容（Java 7 String.format，无String.join等Java 8+方法）
         final String gpsStatus = String.format(
 			"GPS位置：北纬%.4f° 东经%.4f° | 可见位置：%d个",
-			_mCurrentGpsPosition.getLatitude(),
+			mCurrentGpsPosition.getLatitude(),
-			_mCurrentGpsPosition.getLongitude(),
+			mCurrentGpsPosition.getLongitude(),
 			mVisiblePositionIds.size()
         );
         // 主线程判断+切换（Java 7 匿名内部类）
@@ -619,7 +526,172 @@ public class MainService extends Service {
         }
     }
 
+    /**
+     * 计算可见位置距离（原逻辑保留，Java 7 语法兼容，无Stream/并行流）
+     */
+    private void calculateVisiblePositionDistance() {
+        // 原有逻辑（Java 7 语法适配：用迭代器/基础循环，无Lambda/forEach）
+        // 注：原代码标注“略”，此处保持空实现，实际使用时补充具体逻辑
+    }
 
+    /**
+     * 计算两点间距离（Haversine公式，纯Java 7 基础API，无数学工具类依赖）
+     * @param gpsLat GPS纬度
+     * @param gpsLon GPS经度
+     * @param posLat 目标位置纬度
+     * @param posLon 目标位置经度
+     * @return 两点间距离（单位：米）
+     */
+    private double calculateHaversineDistance(double gpsLat, double gpsLon, double posLat, double posLon) {
+        final double EARTH_RADIUS = 6371000; // 地球半径（米）
+        double latDiff = Math.toRadians(posLat - gpsLat);
+        double lonDiff = Math.toRadians(posLon - gpsLon);
+        // Haversine公式核心计算（Java 7 基础数学方法）
+        double a = Math.sin(latDiff / 2) * Math.sin(latDiff / 2)
+			+ Math.cos(Math.toRadians(gpsLat)) * Math.cos(Math.toRadians(posLat))
+			* Math.sin(lonDiff / 2) * Math.sin(lonDiff / 2);
+        double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+        return EARTH_RADIUS * c;
+    }
+
+    /**
+     * 强制刷新所有位置距离（GPS更新后调用，计算距离+校验任务触发条件）
+     */
+    public void forceRefreshDistance() {
+        if (mCurrentGpsPosition == null || mPositionList.isEmpty()) {
+            LogUtils.w(TAG, "forceRefreshDistance：GPS未获取或位置为空");
+            return;
+        }
+
+        // 遍历所有位置计算距离（Java 7 增强for循环，无Stream）
+        for (PositionModel pos : mPositionList) {
+            if (pos.isEnableRealPositionDistance()) {
+                try {
+                    double distance = calculateHaversineDistance(
+						mCurrentGpsPosition.getLatitude(),
+						mCurrentGpsPosition.getLongitude(),
+						pos.getLatitude(),
+						pos.getLongitude()
+                    );
+                    pos.setRealPositionDistance(distance);
+                } catch (Exception e) {
+                    pos.setRealPositionDistance(-1); // 标记距离计算失败
+                    LogUtils.e(TAG, "计算距离失败：" + e.getMessage());
+                }
+            } else {
+                pos.setRealPositionDistance(-1); // 未启用距离计算，标记为无效
+            }
+        }
+
+        // 距离刷新后校验任务触发条件+通知GPS监听者
+        checkAllTaskTriggerCondition();
+        notifyAllGpsListeners(mCurrentGpsPosition);
+    }
+
+
+    // =========================================================================
+    // 任务触发相关方法（Java 7 语法，全迭代器遍历，无Java 8+特性）
+    // =========================================================================
+    /**
+     * 校验所有任务触发条件（距离达标则触发任务通知）
+     */
+    private void checkAllTaskTriggerCondition() {
+        if (mCurrentGpsPosition == null || mPositionList.isEmpty() || mTaskList.isEmpty()) {
+            LogUtils.d(TAG, "checkAllTaskTriggerCondition：跳过校验（GPS/位置/任务为空）");
+            return;
+        }
+
+        LogUtils.d(TAG, "checkAllTaskTriggerCondition：开始校验（任务总数=" + mTaskList.size() + "）");
+        // 迭代器遍历任务（Java 7 安全遍历，避免并发修改异常）
+        Iterator<PositionTaskModel> taskIter = mTaskList.iterator();
+        while (taskIter.hasNext()) {
+            PositionTaskModel task = taskIter.next();
+            // 仅校验“已启用”且“绑定有效位置”的任务
+            if (!task.isEnable() || TextUtils.isEmpty(task.getPositionId())) {
+                continue;
+            }
+
+            // 查找任务绑定的位置（Java 7 迭代器遍历位置列表）
+            PositionModel bindPos = null;
+            Iterator<PositionModel> posIter = mPositionList.iterator();
+            while (posIter.hasNext()) {
+                PositionModel pos = posIter.next();
+                if (task.getPositionId().equals(pos.getPositionId())) {
+                    bindPos = pos;
+                    break;
+                }
+            }
+            if (bindPos == null) {
+                LogUtils.w(TAG, "任务ID=" + task.getTaskId() + "：绑定位置不存在，跳过");
+                task.setIsBingo(false);
+                continue;
+            }
+
+            // 校验距离条件（判断是否满足任务触发阈值）
+            double currentDistance = bindPos.getRealPositionDistance();
+            if (currentDistance < 0) {
+                LogUtils.w(TAG, "任务ID=" + task.getTaskId() + "：距离计算失败，跳过");
+                task.setIsBingo(false);
+                continue;
+            }
+
+            boolean isTriggered = false;
+            int taskDistance = task.getDiscussDistance();
+            // 任务触发条件：大于/小于指定距离（Java 7 基础判断，无三元运算符嵌套）
+            if (task.isGreaterThan()) {
+                isTriggered = currentDistance > taskDistance;
+            } else if (task.isLessThan()) {
+                isTriggered = currentDistance < taskDistance;
+            }
+
+            // 更新任务触发状态+发送通知（状态变化时才处理）
+            if (task.isBingo() != isTriggered) {
+                task.setIsBingo(isTriggered);
+                if (isTriggered) {
+                    sendTaskTriggerNotification(task, bindPos, currentDistance);
+                }
+            }
+        }
+        saveTaskList(); // 持久化更新后的任务状态
+    }
+
+    /**
+     * 发送任务触发通知（更新前台通知+显示Toast，Java 7 匿名Runnable切换主线程）
+     * @param task 触发的任务
+     * @param bindPos 任务绑定的位置
+     * @param currentDistance 当前距离
+     */
+    private void sendTaskTriggerNotification(PositionTaskModel task, PositionModel bindPos, double currentDistance) {
+        if (!_mIsServiceRunning) {
+            return;
+        }
+
+        // 格式化通知内容（Java 7 String.format，无TextBlock等Java 15+特性）
+        final String triggerContent = String.format(
+			"任务触发：%s\n位置：%s\n当前距离：%.1f米（条件：%s%d米）",
+			task.getTaskDescription(),
+			bindPos.getMemo(),
+			currentDistance,
+			task.isGreaterThan() ? ">" : "<",
+			task.getDiscussDistance()
+        );
+
+        // 更新前台通知（主线程判断+切换）
+        updateNotificationGpsStatus(triggerContent);
+
+        // 显示Toast（主线程安全调用，Java 7 匿名内部类）
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            ToastUtils.show(triggerContent);
+        } else {
+            new Handler(Looper.getMainLooper()).post(new Runnable() {
+					@Override
+					public void run() {
+						ToastUtils.show(triggerContent);
+					}
+				});
+        }
+        LogUtils.i(TAG, "任务触发通知：" + triggerContent);
+    }
 
 
     // =========================================================================
@@ -630,17 +702,9 @@ public class MainService extends Service {
      */
     @Override
     public int onStartCommand(Intent intent, int flags, int startId) {
-		boolean isSettingToEnable = false;
+        run(); // 重启服务核心逻辑（保证服务启动后进入运行状态）
-		if (intent != null) {
+        // 返回START_STICKY：服务被异常杀死后，系统会尝试重启（原逻辑保留）
-			isSettingToEnable = intent.getBooleanExtra(EXTRA_IS_SETTING_TO_ENABLE, false);
+        return mAppConfigsUtil.isEnableMainService(true) ? Service.START_STICKY : super.onStartCommand(intent, flags, startId);
-			if (isSettingToEnable) {
-				run(); // 重启服务核心逻辑（保证服务启动后进入运行状态）
-			}
-		}
-
-        // 如果被设置为自启动就返回START_STICKY：服务被异常杀死后，系统会尝试重启（原逻辑保留）
-		// 否则就启动默认参数
-        return isSettingToEnable ? Service.START_STICKY : super.onStartCommand(intent, flags, startId);
     }
 
     /**
@@ -662,7 +726,7 @@ public class MainService extends Service {
     }
 
     /**
-	 * 唤醒并绑定辅助服务（检查服务状态，未存活则启动+绑定）
+     * 唤醒并绑定辅助服务（检查服务状态，未存活则启动+绑定）
      */
     void wakeupAndBindAssistant() {
         // 检查辅助服务是否存活（Java 7 静态方法调用，无方法引用）
@@ -703,7 +767,7 @@ public class MainService extends Service {
 
                     // 同步GPS位置+刷新距离+日志（原逻辑保留）
                     syncCurrentGpsPosition(gpsPos);
-					DistanceCalculatorUtil.getInstance(MainService.this).checkAllTaskTriggerCondition(gpsPos);
+                    forceRefreshDistance();
                     LogUtils.d(TAG, "GPS位置更新：纬度=" + location.getLatitude() + "，经度=" + location.getLongitude());
                 }
             }
@@ -749,7 +813,7 @@ public class MainService extends Service {
                 // GPS禁用时清空状态+通知+提示（Java 7 基础逻辑）
                 if (provider.equals(LocationManager.GPS_PROVIDER)) {
                     isGpsEnabled = false;
-                    _mCurrentGpsPosition = null;
+                    mCurrentGpsPosition = null;
                     String statusDesc = "GPS已关闭（用户手动关闭）";
                     LogUtils.w(TAG, statusDesc);
                     notifyAllGpsStatusListeners(statusDesc);
@@ -868,52 +932,11 @@ public class MainService extends Service {
         }
     }
 
-    /**
-     * 发送任务触发通知（更新前台通知+显示Toast，Java 7 匿名Runnable切换主线程）
-     * @param task 触发的任务
-     * @param bindPos 任务绑定的位置
-     * @param currentDistance 当前距离
-     */
-    public void sendTaskTriggerNotification(final PositionTaskModel task, PositionModel bindPos, double currentDistance) {
-        /*if (!_mIsServiceRunning) {
-		 return;
-		 }*/
-
-        // 格式化通知内容（Java 7 String.format，无TextBlock等Java 15+特性）
-        final String triggerContent = String.format(
-			"任务触发：%s\n位置：%s\n当前距离：%.1f米（条件：%s%d米）",
-			task.getTaskDescription(),
-			bindPos.getMemo(),
-			currentDistance,
-			task.isGreaterThan() ? ">" : "<",
-			task.getDiscussDistance()
-        );
-
-        // 更新前台通知（主线程判断+切换）
-        updateNotificationGpsStatus(triggerContent);
-
-        // 显示Toast（主线程安全调用，Java 7 匿名内部类）
-        if (Looper.myLooper() == Looper.getMainLooper()) {
-            ToastUtils.show(triggerContent);
-			NotificationUtil.show(MainService.this, task.getTaskId(), task.getPositionId(), task.getTaskDescription());
-        } else {
-            new Handler(Looper.getMainLooper()).post(new Runnable() {
-					@Override
-					public void run() {
-						ToastUtils.show(triggerContent);
-						NotificationUtil.show(MainService.this, task.getTaskId(), task.getPositionId(), task.getTaskDescription());
-					}
-				});
-        }
-        LogUtils.i(TAG, "任务触发通知：" + triggerContent);
-    }
-
-
     /**
      * 更新前台通知的GPS状态（Java 7 主线程切换，匿名Runnable实现）
      * @param statusText 通知显示的状态文本
      */
-    void updateNotificationGpsStatus(final String statusText) {
+    private void updateNotificationGpsStatus(final String statusText) {
         if (_mIsServiceRunning) {
             // 判断当前线程是否为主线程，避免UI操作在子线程
             if (Looper.myLooper() == Looper.getMainLooper()) {
@@ -937,7 +960,7 @@ public class MainService extends Service {
      * 通知所有GPS监听者位置更新（Java 7 迭代器+弱引用管理，无Stream）
      * @param currentGpsPos 当前最新GPS位置
      */
-    public void notifyAllGpsListeners(PositionModel currentGpsPos) {
+    private void notifyAllGpsListeners(PositionModel currentGpsPos) {
         if (currentGpsPos == null || mGpsListeners.isEmpty()) {
             return;
         }
@@ -1018,8 +1041,8 @@ public class MainService extends Service {
             mGpsListeners.add(new WeakReference<GpsUpdateListener>(listener));
             LogUtils.d(TAG, "GPS监听注册成功，当前数量：" + mGpsListeners.size());
             // 注册后立即推送当前GPS位置（避免监听者错过初始数据）
-            if (_mCurrentGpsPosition != null) {
+            if (mCurrentGpsPosition != null) {
-                notifySingleListener(listener, _mCurrentGpsPosition);
+                notifySingleListener(listener, mCurrentGpsPosition);
             }
         }
     }

positions/src/main/java/cc/winboll/studio/positions/utils/AppConfigsUtil.java

@@ -41,11 +41,11 @@ public class AppConfigsUtil {
         return sInstance;
     }
 
-	public void loadConfigs() {
+	void loadConfigs() {
 		mAppConfigsModel = AppConfigsModel.loadBean(mContext, AppConfigsModel.class);
 	}
 
-	public void saveConfigs() {
+	void saveConfigs() {
 		AppConfigsModel.saveBean(mContext, mAppConfigsModel);
 	}
 

positions/src/main/java/cc/winboll/studio/positions/utils/DensityUtils.java

@@ -1,45 +0,0 @@
-package cc.winboll.studio.positions.utils;
-
-/**
- * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
- * @Date 2025/10/22 01:16
- * @Describe DensityUtils
- */
-
-import android.content.Context;
-import android.util.DisplayMetrics;
-import android.view.WindowManager;
-
-/**
- * 屏幕密度工具类（dp/sp 转 px、获取屏幕尺寸）
- */
-public class DensityUtils {
-	public static final String TAG = "DensityUtils";
-
-	/**
-	 * dp 转 px（根据屏幕密度）
-	 */
-	public static int dp2px(Context context, float dpValue) {
-		final float scale = context.getResources().getDisplayMetrics().density;
-		return (int) (dpValue * scale + 0.5f);
-	}
-
-	/**
-	 * sp 转 px（根据文字缩放比例）
-	 */
-	public static int sp2px(Context context, float spValue) {
-		final float scale = context.getResources().getDisplayMetrics().scaledDensity;
-		return (int) (spValue * scale + 0.5f);
-	}
-
-	/**
-	 * 获取屏幕宽度（像素）
-	 */
-	public static int getScreenWidth(Context context) {
-		WindowManager wm = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
-		DisplayMetrics dm = new DisplayMetrics();
-		wm.getDefaultDisplay().getMetrics(dm);
-		return dm.widthPixels;
-	}
-}
-

positions/src/main/java/cc/winboll/studio/positions/utils/DistanceCalculatorUtil.java

@@ -1,246 +0,0 @@
-package cc.winboll.studio.positions.utils;
-import android.content.Context;
-import android.os.Handler;
-import android.os.Looper;
-import android.text.TextUtils;
-import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.libappbase.ToastUtils;
-import cc.winboll.studio.positions.models.PositionModel;
-import cc.winboll.studio.positions.models.PositionTaskModel;
-import cc.winboll.studio.positions.services.MainService;
-import java.util.ArrayList;
-import java.util.Iterator;
-
-/**
- * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
- * @Date 2025/10/27 18:40
- * @Describe 距离计算工具集（单例模式）
- */
-public class DistanceCalculatorUtil {
-
-    public static final String TAG = "DistanceCalculatorUtil";
-
-    // 1. 私有静态 volatile 实例：保证多线程下实例可见性，避免指令重排序导致的空指针
-    private static volatile DistanceCalculatorUtil sInstance;
-	Context mContext;
-	ArrayList<PositionModel> mPositionList;   // 位置数据列表
-    ArrayList<PositionTaskModel> mAllTasks;// 任务数据列表
-	PositionModel mGpsPositionCalculated;
-	long mLastCalculatedTime = 0;
-	long mMinCalculatedTimeBettween = 30000; // GPS数据更新时，两次计算之间的最小时间间隔
-	double mMinjumpDistance = 10.0f; // GPS数据更新时，能跳跃距离最小有效值，达到有效值时，两次计算之间的最小时间间隔阀值将被忽略。
-
-    // 2. 私有构造器：禁止外部通过 new 关键字创建实例，确保单例唯一性
-    private DistanceCalculatorUtil(Context context) {
-        // 可选：初始化工具类依赖的资源（如配置参数、缓存等）
-		mContext = context;
-
-        LogUtils.d(TAG, "DistanceCalculatorUtil 单例实例初始化");
-    }
-
-    // 3. 公开静态方法：双重校验锁获取单例，兼顾线程安全与性能
-    public static DistanceCalculatorUtil getInstance(Context context) {
-        // 第一重校验：避免已创建实例时的频繁加锁，提升性能
-        if (sInstance == null) {
-            // 加锁：确保多线程下仅一个线程进入实例创建逻辑
-            synchronized (DistanceCalculatorUtil.class) {
-                // 第二重校验：防止多线程并发时重复创建实例
-                if (sInstance == null) {
-                    sInstance = new DistanceCalculatorUtil(context);
-                }
-            }
-        }
-        return sInstance;
-    }
-
-    // ---------------------- 以下可补充距离计算相关工具方法 ----------------------
-    /**
-     * 示例：Haversine 公式计算两点间距离（单位：米）
-     * @param lat1 第一点纬度
-     * @param lon1 第一点经度
-     * @param lat2 第二点纬度
-     * @param lon2 第二点经度
-     * @return 两点间直线距离（米），计算失败返回 -1
-     */
-    public static double calculateHaversineDistance(double lat1, double lon1, double lat2, double lon2) {
-        try {
-            final double EARTH_RADIUS = 6371000; // 地球半径（米）
-            // 角度转弧度
-            double latDiff = Math.toRadians(lat2 - lat1);
-            double lonDiff = Math.toRadians(lon2 - lon1);
-
-            // Haversine 核心公式
-            double a = Math.sin(latDiff / 2) * Math.sin(latDiff / 2)
-				+ Math.cos(Math.toRadians(lat1)) * Math.cos(Math.toRadians(lat2))
-				* Math.sin(lonDiff / 2) * Math.sin(lonDiff / 2);
-            double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
-
-            return EARTH_RADIUS * c; // 返回距离（米）
-        } catch (Exception e) {
-            LogUtils.d(TAG, "Haversine 距离计算失败：" + e.getMessage());
-            return -1; // 标记计算失败
-        }
-    }
-
-
-    /**
-     * 计算两点间距离（Haversine公式，纯Java 7 基础API，无数学工具类依赖）
-     * @param gpsLat GPS纬度
-     * @param gpsLon GPS经度
-     * @param posLat 目标位置纬度
-     * @param posLon 目标位置经度
-     * @return 两点间距离（单位：米）
-     */
-    /*private double calculateHaversineDistance(double gpsLat, double gpsLon, double posLat, double posLon) {
-	 final double EARTH_RADIUS = 6371000; // 地球半径（米）
-	 double latDiff = Math.toRadians(posLat - gpsLat);
-	 double lonDiff = Math.toRadians(posLon - gpsLon);
-	 // Haversine公式核心计算（Java 7 基础数学方法）
-	 double a = Math.sin(latDiff / 2) * Math.sin(latDiff / 2)
-	 + Math.cos(Math.toRadians(gpsLat)) * Math.cos(Math.toRadians(posLat))
-	 * Math.sin(lonDiff / 2) * Math.sin(lonDiff / 2);
-	 double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
-	 return EARTH_RADIUS * c;
-	 }*/
-
-	/**
-     * 校验所有任务触发条件（距离达标则触发任务通知）
-     */
-    public void checkAllTaskTriggerCondition(PositionModel currentGpsPosition) {
-		if (currentGpsPosition == null) {
-			LogUtils.d(TAG, "传入坐标参数为空，退出函数。");
-			return;
-		}
-
-		// 计算频率控制模块
-		//
-		// 计算与最近一次GPS计算的时间间隔
-		long nCalculatedTimeBettween = System.currentTimeMillis() - mLastCalculatedTime;
-		// 计算跳跃距离
-		double gpsPositionCalculatedLatitude = mGpsPositionCalculated == null ?0.0f: mGpsPositionCalculated.getLatitude();
-		double gpsPositionCalculatedLongitude = mGpsPositionCalculated == null ?0.0f: mGpsPositionCalculated.getLongitude();
-		double jumpDistance = calculateHaversineDistance(gpsPositionCalculatedLatitude, gpsPositionCalculatedLongitude, currentGpsPosition.getLatitude(), currentGpsPosition.getLongitude());
-		if (jumpDistance < mMinjumpDistance) {
-			LogUtils.d(TAG, String.format("checkAllTaskTriggerCondition：跳跃距离%f，小于50米。", jumpDistance));
-			// 跳跃距离小于最小有效跳跃值
-			if (nCalculatedTimeBettween < mMinCalculatedTimeBettween) {
-				//间隔小于最小时间间隔设定
-				LogUtils.d(TAG, String.format("checkAllTaskTriggerCondition：与最近一次计算间隔时间%d，坐标变化忽略。", nCalculatedTimeBettween));
-				return;
-			}
-		}
-
-		if (mGpsPositionCalculated == null) {
-			mGpsPositionCalculated = currentGpsPosition;
-			LogUtils.d(TAG, "最后计算位置记录为空，现在使用新坐标为初始化。");
-		}
-
-		LogUtils.d(TAG, String.format("checkAllTaskTriggerCondition：跳跃距离%f，与上次计算间隔%d，现在启动任务数据计算。", jumpDistance, nCalculatedTimeBettween));
-
-		// 获取位置任务基础数据
-		MainService mainService = MainService.getInstance(mContext);
-		mPositionList = mainService.getPositionList();
-		mAllTasks = mainService.getAllTasks();
-
-		// 位置数据为空，跳过校验。
-        if (mPositionList.isEmpty()) {
-            LogUtils.d(TAG, "checkAllTaskTriggerCondition：位置数据为空，跳过距离计算。");
-            return;
-        }
-
-		// 更新所有位置点的位置距离数据
-		refreshRealPositionDistance(currentGpsPosition);
-
-		// 任务数据为空，跳过校验。
-        if (mAllTasks.isEmpty()) {
-            LogUtils.d(TAG, "checkAllTaskTriggerCondition：任务数据为空，跳过任务提醒检查计算。");
-            return;
-        }
-
-        // 迭代器遍历任务（Java 7 安全遍历，避免并发修改异常）
-        Iterator<PositionTaskModel> taskIter = mAllTasks.iterator();
-        while (taskIter.hasNext()) {
-            PositionTaskModel task = taskIter.next();
-            // 仅校验“已启用”且“绑定有效位置”的任务
-            if (!task.isEnable() || TextUtils.isEmpty(task.getPositionId())) {
-                continue;
-            }
-
-            // 查找任务绑定的位置（Java 7 迭代器遍历位置列表）
-            PositionModel bindPos = null;
-            Iterator<PositionModel> posIter = mPositionList.iterator();
-            while (posIter.hasNext()) {
-                PositionModel pos = posIter.next();
-                if (task.getPositionId().equals(pos.getPositionId())) {
-                    bindPos = pos;
-                    break;
-                }
-            }
-            if (bindPos == null) {
-                LogUtils.w(TAG, "任务ID=" + task.getTaskId() + "：绑定位置不存在，跳过");
-                task.setIsBingo(false);
-                continue;
-            }
-
-			// 校验任务开始时间
-			if (task.getStartTime() > System.currentTimeMillis()) {
-				continue;
-			}
-
-            // 校验距离条件（判断是否满足任务触发阈值）
-            double currentDistance = bindPos.getRealPositionDistance();
-            if (currentDistance < 0) {
-                LogUtils.w(TAG, "任务ID=" + task.getTaskId() + "：距离计算失败，跳过");
-                task.setIsBingo(false);
-                continue;
-            }
-
-            boolean isTriggered = false;
-            int taskDistance = task.getDiscussDistance();
-            // 任务触发条件：大于/小于指定距离（Java 7 基础判断，无三元运算符嵌套）
-            if (task.isGreaterThan()) {
-                isTriggered = currentDistance > taskDistance;
-            } else if (task.isLessThan()) {
-                isTriggered = currentDistance < taskDistance;
-            }
-
-            // 更新任务触发状态+发送通知（状态变化时才处理）
-            if (task.isBingo() != isTriggered) {
-                task.setIsBingo(isTriggered);
-                if (isTriggered) {
-                    MainService.getInstance(mContext).sendTaskTriggerNotification(task, bindPos, currentDistance);
-                }
-            }
-        }
-
-        MainService.getInstance(mContext).saveAllTasks(); // 持久化更新后的任务状态
-		// 记录最后坐标更新点
-		mGpsPositionCalculated = currentGpsPosition;
-		// 记录数据计算时间
-		mLastCalculatedTime = System.currentTimeMillis();
-    }
-
-
-    /**
-     * 强制刷新所有位置距离（GPS更新后调用，计算距离+校验任务触发条件）
-     */
-    public void refreshRealPositionDistance(PositionModel currentGpsPosition) {
-        // 遍历所有位置计算距离（Java 7 增强for循环，无Stream）
-        for (PositionModel pos : mPositionList) {
-            if (pos.isEnableRealPositionDistance()) {
-				double distance = DistanceCalculatorUtil.calculateHaversineDistance(
-					currentGpsPosition.getLatitude(),
-					currentGpsPosition.getLongitude(),
-					pos.getLatitude(),
-					pos.getLongitude()
-				);
-				pos.setRealPositionDistance(distance);
-            } else {
-                pos.setRealPositionDistance(-1); // 未启用距离计算，标记为无效
-            }
-        }
-
-        // 距离刷新后通知GPS监听者
-        MainService.getInstance(mContext).notifyAllGpsListeners(currentGpsPosition);
-    }
-}

positions/src/main/java/cc/winboll/studio/positions/utils/NotificationUtil.java

@@ -3,7 +3,7 @@ package cc.winboll.studio.positions.utils;
 /**
  * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
  * @Date 2025/09/30 16:09
- * @Describe NotificationUtils（适配API 30，修复系统默认铃声获取，任务通知循环响铃）
+ * @Describe NotificationUtils
  */
 import android.app.Notification;
 import android.app.NotificationChannel;
@@ -11,183 +11,175 @@ import android.app.NotificationManager;
 import android.app.PendingIntent;
 import android.content.Context;
 import android.content.Intent;
-import android.media.RingtoneManager; // 导入RingtoneManager（关键：用于获取系统默认铃声）
-import android.net.Uri; // 导入Uri（存储铃声路径）
 import android.os.Build;
 import androidx.core.app.NotificationCompat;
 import cc.winboll.studio.positions.R;
-import cc.winboll.studio.positions.activities.LocationActivity;
+import cc.winboll.studio.positions.activities.LocationActivity; // 引入你的前台服务类
 
 /**
- * 通知栏工具类：
+ * 通知栏工具类：专注于任务相关通知的显示与点击跳转 + 前台服务通知管理
- * 1. 任务通知：铃声循环播放（适配API 30），修复系统默认铃声获取方式
+ * 核心功能：
- * 2. 前台服务通知：低打扰（无声无震动），符合API 30规范
+ * 1. 显示任务描述通知，点击后携带positionId/taskId跳转到LocationActivity
+ * 2. 创建前台服务通知（用于DistanceRefreshService保活，符合系统前台服务规范）
  */
 public class NotificationUtil {
-    public static final String TAG = "NotificationUtils";
+	public static final String TAG = "NotificationUtils";
-    // 任务通知常量（独立渠道，确保循环铃声配置不冲突）
+	// 1. 任务通知相关常量（原有）
-    private static final String TASK_NOTIFICATION_CHANNEL_ID = "task_notification_channel_01";
+	private static final String TASK_NOTIFICATION_CHANNEL_ID = "task_notification_channel_01";
-    private static final String TASK_NOTIFICATION_CHANNEL_NAME = "任务通知（循环铃声）";
+	private static final String TASK_NOTIFICATION_CHANNEL_NAME = "任务通知";
-    // 前台服务通知常量（独立渠道，低打扰）
+	// 2. 前台服务通知新增常量（独立渠道，避免与普通任务通知混淆）
-    private static final String FOREGROUND_SERVICE_CHANNEL_ID = "foreground_location_service_channel_02";
+	private static final String FOREGROUND_SERVICE_CHANNEL_ID = "foreground_location_service_channel_02";
-    private static final String FOREGROUND_SERVICE_CHANNEL_NAME = "位置服务";
+	private static final String FOREGROUND_SERVICE_CHANNEL_NAME = "位置服务";
-    public static final int FOREGROUND_SERVICE_NOTIFICATION_ID = 10086; // 固定前台服务通知ID
+	public static final int FOREGROUND_SERVICE_NOTIFICATION_ID = 10086; // 固定ID（前台服务通知无需动态生成）
 
-    // ---------------------- 核心：任务通知（循环响铃+修复系统默认铃声） ----------------------
+	// ---------------------- 原有功能：任务通知（不变） ----------------------
-    private static int getNotificationId(String taskId) {
+	private static int getNotificationId(String taskId) {
-        return taskId.hashCode() & 0xFFFFFF; // 确保通知ID唯一且非负
+		return taskId.hashCode() & 0xFFFFFF;
-    }
+	}
 
-    public static void show(Context context, String taskId, String positionId, String taskDescription) {
+	public static void show(Context context, String taskId, String positionId, String taskDescription) {
-        if (context == null || taskId == null || positionId == null) {
+		if (context == null || taskId == null || positionId == null) {
-            return;
+			return;
-        }
+		}
 
-        NotificationManager notificationManager = 
+		NotificationManager notificationManager = 
-            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+			(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
-        if (notificationManager == null) {
+		if (notificationManager == null) {
-            return;
+			return;
-        }
+		}
 
-        // 1. 初始化通知渠道（配置循环铃声参数，使用修复后的铃声获取方式）
+		createNotificationChannel(notificationManager);
-        createNotificationChannel(notificationManager);
 
-        // 2. 点击跳转Intent（携带任务/位置参数，适配API 30页面栈）
+		Intent jumpIntent = new Intent(context, LocationActivity.class);
-        Intent jumpIntent = new Intent(context, LocationActivity.class);
+		jumpIntent.putExtra("EXTRA_POSITION_ID", positionId);
-        jumpIntent.putExtra("EXTRA_POSITION_ID", positionId);
+		jumpIntent.putExtra("EXTRA_TASK_ID", taskId);
-        jumpIntent.putExtra("EXTRA_TASK_ID", taskId);
+		jumpIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
-        jumpIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
 
-        // 3. PendingIntent（API 30强制加IMMUTABLE，避免安全异常）
+		PendingIntent pendingIntent = PendingIntent.getActivity(
-        PendingIntent pendingIntent = PendingIntent.getActivity(
+			context,
-            context,
+			getNotificationId(taskId),
-            getNotificationId(taskId),
+			jumpIntent,
-            jumpIntent,
+			Build.VERSION.SDK_INT >= Build.VERSION_CODES.M ? 
-            PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT
+			PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT : 
-        );
+			PendingIntent.FLAG_UPDATE_CURRENT
+		);
 
-        // 4. 构建通知（核心：循环响铃+修复的系统默认铃声）
+		Notification notification = new NotificationCompat.Builder(context, TASK_NOTIFICATION_CHANNEL_ID)
-        NotificationCompat.Builder builder = new NotificationCompat.Builder(context, TASK_NOTIFICATION_CHANNEL_ID)
+			.setSmallIcon(R.mipmap.ic_launcher)
-            .setSmallIcon(R.mipmap.ic_launcher) // API 30强制要求，否则通知不显示
+			.setContentTitle("任务提醒")
-            .setContentTitle("任务提醒")
+			.setContentText(taskDescription)
-            .setContentText(taskDescription)
+			.setContentIntent(pendingIntent)
-            .setContentIntent(pendingIntent)
+			.setAutoCancel(true)
-            .setAutoCancel(true) // 点击后取消通知，停止循环响铃
+			.setPriority(NotificationCompat.PRIORITY_DEFAULT)
-            .setPriority(NotificationCompat.PRIORITY_DEFAULT) // 确保铃声能正常播放（API 30规则）
+			.setDefaults(NotificationCompat.DEFAULT_SOUND)
-            //.setVibrationPattern(new long[]{0, 300, 200, 300}) // 震动与铃声同步循环
+			.build();
-            .setOnlyAlertOnce(false); // 重复通知也触发循环提醒
 
-        // 关键修复：用RingtoneManager获取系统默认通知铃声（替代废弃的NotificationManager.getDefaultUri）
+		notificationManager.notify(getNotificationId(taskId), notification);
-        Uri defaultNotificationRingtone = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);
+	}
-        if (defaultNotificationRingtone != null) {
-            builder.setSound(defaultNotificationRingtone); // 设置系统默认铃声
-        } else {
-            builder.setDefaults(NotificationCompat.DEFAULT_SOUND); // 极端情况：铃声Uri为空时，用默认提醒音兜底
-        }
 
-        // 5. 循环响铃核心：设置FLAG_INSISTENT（通知未取消则持续循环）
+	private static void createNotificationChannel(NotificationManager notificationManager) {
-        Notification notification = builder.build();
+		if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-        notification.flags |= Notification.FLAG_INSISTENT;
+			// 原有：任务通知渠道
+			NotificationChannel taskChannel = new NotificationChannel(
+				TASK_NOTIFICATION_CHANNEL_ID,
+				TASK_NOTIFICATION_CHANNEL_NAME,
+				NotificationManager.IMPORTANCE_DEFAULT
+			);
+			taskChannel.setDescription("接收任务相关提醒，点击可查看任务详情");
+			taskChannel.enableVibration(true);
+			taskChannel.setVibrationPattern(new long[]{0, 300});
 
-        // 6. 显示通知（触发循环响铃）
+			// 新增：前台服务通知渠道（重要性设为LOW，避免频繁打扰用户）
-        notificationManager.notify(getNotificationId(taskId), notification);
+			NotificationChannel foregroundChannel = new NotificationChannel(
-    }
+				FOREGROUND_SERVICE_CHANNEL_ID,
+				FOREGROUND_SERVICE_CHANNEL_NAME,
+				NotificationManager.IMPORTANCE_LOW // 仅通知栏显示，无提示音/震动，符合后台服务低打扰需求
+			);
+			foregroundChannel.setDescription("位置服务运行中，用于后台持续获取GPS数据，关闭会影响定位功能"); // 明确告知用户服务作用
+			foregroundChannel.enableVibration(false); // 前台服务通知不震动（避免打扰）
+			foregroundChannel.setSound(null, null); // 关闭提示音（低打扰）
 
-    // ---------------------- 核心：创建通知渠道（修复铃声配置，适配API 30） ----------------------
+			// 注册两个渠道（任务+前台服务）
-    private static void createNotificationChannel(NotificationManager notificationManager) {
+			notificationManager.createNotificationChannel(taskChannel);
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+			notificationManager.createNotificationChannel(foregroundChannel);
-            // 1. 任务通知渠道（用修复后的方式配置系统默认铃声）
+		}
-            NotificationChannel taskChannel = new NotificationChannel(
+	}
-                TASK_NOTIFICATION_CHANNEL_ID,
-                TASK_NOTIFICATION_CHANNEL_NAME,
-                NotificationManager.IMPORTANCE_DEFAULT // 重要性≥DEFAULT，否则铃声不响（API 30规则）
-            );
-            taskChannel.setDescription("任务提醒通知，铃声循环播放至点击取消");
-            taskChannel.enableVibration(true);
-            taskChannel.setVibrationPattern(new long[]{0, 300, 200, 300});
-            taskChannel.setAllowBubbles(false); // 避免气泡打断循环铃声
 
-            // 关键修复：渠道铃声也用RingtoneManager获取（与通知Builder保持一致，确保铃声统一）
+	public static void cancel(Context context, String taskId) {
-            Uri channelDefaultRingtone = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);
+		if (context == null || taskId == null) {
-            taskChannel.setSound(channelDefaultRingtone, null); // 绑定系统默认铃声到渠道
+			return;
+		}
+		NotificationManager notificationManager = 
+			(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+		if (notificationManager != null) {
+			notificationManager.cancel(getNotificationId(taskId));
+		}
+	}
 
-            // 2. 前台服务渠道（低打扰，无声无震动）
+	// ---------------------- 新增核心功能：创建前台服务通知（供DistanceRefreshService调用） ----------------------
-            NotificationChannel foregroundChannel = new NotificationChannel(
+	/**
-                FOREGROUND_SERVICE_CHANNEL_ID,
+	 * 创建前台服务通知（符合Android前台服务规范，用于启动/保活DistanceRefreshService）
-                FOREGROUND_SERVICE_CHANNEL_NAME,
+	 * @param context 服务上下文（直接传入DistanceRefreshService的this即可）
-                NotificationManager.IMPORTANCE_LOW
+	 * @param serviceStatus 服务状态文本（如“正在后台获取GPS位置...”，动态展示服务状态）
-            );
+	 * @return 可直接用于startForeground()的Notification对象
-            foregroundChannel.setDescription("位置服务运行中，无声音/震动提醒");
+	 */
-            foregroundChannel.enableVibration(false);
+	public static Notification createForegroundServiceNotification(Context context, String serviceStatus) {
-            foregroundChannel.setSound(null, null); // 明确关闭铃声
+		// 安全校验：上下文非空（避免服务中调用时的空指针）
-            foregroundChannel.setShowBadge(false);
+		if (context == null) {
+			throw new IllegalArgumentException("Context cannot be null for foreground service notification");
+		}
 
-            // 注册渠道（API 30覆盖旧配置，确保修复后的铃声生效）
+		// 步骤1：初始化通知管理器（复用已有逻辑，确保渠道已创建）
-            notificationManager.createNotificationChannel(taskChannel);
+		NotificationManager notificationManager = 
-            notificationManager.createNotificationChannel(foregroundChannel);
+			(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
-        }
+		if (notificationManager != null) {
-    }
+			createNotificationChannel(notificationManager); // 确保前台服务渠道已注册
+		}
 
-    // ---------------------- 原有功能：取消任务通知（停止循环响铃） ----------------------
+		// 步骤2：构建“点击通知跳转至位置管理页”的Intent（用户点击通知可进入功能页）
-    public static void cancel(Context context, String taskId) {
+		Intent jumpIntent = new Intent(context, LocationActivity.class);
-        if (context == null || taskId == null) {
+		jumpIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP); // 避免创建重复页面
-            return;
-        }
-        NotificationManager notificationManager = 
-            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
-        if (notificationManager != null) {
-            notificationManager.cancel(getNotificationId(taskId)); // 取消后循环铃声自动停止
-        }
-    }
 
-    // ---------------------- 前台服务通知（适配API 30，无声无震动） ----------------------
+		// 步骤3：创建PendingIntent（授权系统在用户点击时执行跳转）
-    public static Notification createForegroundServiceNotification(Context context, String serviceStatus) {
+		PendingIntent pendingIntent = PendingIntent.getActivity(
-        if (context == null) {
+			context,
-            throw new IllegalArgumentException("Context cannot be null for foreground service notification");
+			FOREGROUND_SERVICE_NOTIFICATION_ID, // 请求码与通知ID一致，确保唯一
-        }
+			jumpIntent,
+			// 适配Android 6.0+：IMMUTABLE确保安全性，UPDATE_CURRENT确保Intent参数更新
+			Build.VERSION.SDK_INT >= Build.VERSION_CODES.M ? 
+			PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT : 
+			PendingIntent.FLAG_UPDATE_CURRENT
+		);
 
-        // 确保前台服务渠道已创建（低打扰配置）
+		// 步骤4：构建前台服务通知（低打扰、强关联服务状态）
-        NotificationManager notificationManager = 
+		return new NotificationCompat.Builder(context, FOREGROUND_SERVICE_CHANNEL_ID)
-            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+			.setSmallIcon(R.mipmap.ic_launcher) // 必须设置（系统强制要求，建议用应用图标）
-        if (notificationManager != null) {
+			.setContentTitle("位置服务运行中") // 固定标题，用户快速识别服务类型
-            createNotificationChannel(notificationManager);
+			.setContentText(serviceStatus) // 动态内容（如“正在获取GPS位置”“已连续运行30分钟”）
-        }
+			.setContentIntent(pendingIntent) // 点击跳转至功能页
+			.setOngoing(true) // 关键：设置为“不可手动清除”（仅服务停止时能取消，符合前台服务规范）
+			.setPriority(NotificationCompat.PRIORITY_LOW) // 低优先级：不弹窗、不抢占通知栏焦点
+			.setDefaults(NotificationCompat.DEFAULT_SOUND)
+			.build();
+	}
 
-        // 点击跳转Intent
+	/**
-        Intent jumpIntent = new Intent(context, LocationActivity.class);
+	 * （配套工具方法）更新前台服务通知的状态文本（如GPS获取进度、运行时长）
-        jumpIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
+	 * @param context 服务上下文
-
+	 * @param newServiceStatus 新的状态文本（如“已获取最新位置：北纬30.123°”）
-        // PendingIntent（API 30必加IMMUTABLE）
+	 */
-        PendingIntent pendingIntent = PendingIntent.getActivity(
+	public static void updateForegroundServiceStatus(Context context, String newServiceStatus) {
-            context,
+		if (context == null) {
-            FOREGROUND_SERVICE_NOTIFICATION_ID,
+			return;
-            jumpIntent,
+		}
-            PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT
+		// 重新创建通知（复用create方法，传入新状态文本）
-        );
+		Notification updatedNotification = createForegroundServiceNotification(context, newServiceStatus);
-
+		// 用相同ID更新通知（覆盖旧通知，实现状态刷新）
-        // 构建前台服务通知（无声无震动，符合低打扰）
+		NotificationManager notificationManager = 
-        return new NotificationCompat.Builder(context, FOREGROUND_SERVICE_CHANNEL_ID)
+			(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
-            .setSmallIcon(R.mipmap.ic_launcher)
+		if (notificationManager != null) {
-            .setContentTitle("位置服务运行中")
+			notificationManager.notify(FOREGROUND_SERVICE_NOTIFICATION_ID, updatedNotification);
-            .setContentText(serviceStatus)
+		}
-            .setContentIntent(pendingIntent)
+	}
-            .setOngoing(true) // 不可手动清除（前台服务规范）
-            .setPriority(NotificationCompat.PRIORITY_LOW)
-            .setDefaults(0) // 禁用所有默认提醒（无声无震动）
-            .build();
-    }
-
-    // ---------------------- 前台服务通知状态更新（适配API 30） ----------------------
-    public static void updateForegroundServiceStatus(Context context, String newServiceStatus) {
-        if (context == null) {
-            return;
-        }
-        Notification updatedNotification = createForegroundServiceNotification(context, newServiceStatus);
-        NotificationManager notificationManager = 
-            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
-        if (notificationManager != null) {
-            notificationManager.notify(FOREGROUND_SERVICE_NOTIFICATION_ID, updatedNotification);
-        }
-    }
 }
 

positions/src/main/java/cc/winboll/studio/positions/utils/ServiceUtil.java

@@ -7,10 +7,6 @@ package cc.winboll.studio.positions.utils;
  */
 import android.app.ActivityManager;
 import android.content.Context;
-import android.content.Intent;
-import cc.winboll.studio.libappbase.LogUtils;
-import cc.winboll.studio.positions.services.AssistantService;
-import cc.winboll.studio.positions.services.MainService;
 import java.util.List;
 
 public class ServiceUtil {
@@ -35,35 +31,4 @@ public class ServiceUtil {
 
         return false;
     }
-
-	public static void stopAutoService(Context context) {
-		AppConfigsUtil appConfigsUtil = AppConfigsUtil.getInstance(context);
-		appConfigsUtil.setIsEnableMainService(false);
-		appConfigsUtil.saveConfigs();
-		// 关闭并设置主服务
-		Intent intent1 = new Intent(context, MainService.class);
-		intent1.putExtra(MainService.EXTRA_IS_SETTING_TO_ENABLE, false);
-		context.stopService(intent1); // 先停止旧服务
-		context.startService(intent1); // 传入新的启动标志位，返回给系统
-		// 关闭并设置主服务守护进程
-		Intent intent2 = new Intent(context, AssistantService.class);
-		intent2.putExtra(AssistantService.EXTRA_IS_SETTING_TO_ENABLE, false);
-		context.stopService(intent2); // 先停止旧服务
-		context.startService(intent2); // 传入新的启动标志位，返回给系统
-		// 再次关闭所有服务
-		context.stopService(intent1);
-		context.stopService(intent2);
-
-		LogUtils.d(TAG, "stopAutoService");
-	}
-
-	public static void startAutoService(Context context) {
-		AppConfigsUtil appConfigsUtil = AppConfigsUtil.getInstance(context);
-		appConfigsUtil.setIsEnableMainService(true);
-		appConfigsUtil.saveConfigs();
-		Intent intent = new Intent(context, MainService.class);
-		intent.putExtra(MainService.EXTRA_IS_SETTING_TO_ENABLE, true);
-		context.startService(intent);
-		LogUtils.d(TAG, "startAutoService");
-	}
 }

positions/src/main/java/cc/winboll/studio/positions/views/DateTimePickerPopup.java

@@ -1,254 +0,0 @@
-package cc.winboll.studio.positions.views;
-
-/**
- * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
- * @Date 2025/10/22 02:15
- * @Describe DateTimePickerPopup
- */
-import android.content.Context;
-import android.view.LayoutInflater;
-import android.view.View;
-import android.view.ViewGroup;
-import android.widget.Button;
-import android.widget.NumberPicker;
-import android.widget.PopupWindow;
-import java.util.Calendar;
-import cc.winboll.studio.positions.R;
-import cc.winboll.studio.positions.utils.DensityUtils;
-
-/**
- * 日期时间选择弹窗（竖直滚动行：年、月、日、时、分）
- */
-public class DateTimePickerPopup extends PopupWindow {
-	public static final String TAG = "DateTimePickerPopup";
-
-    private Context mContext;
-    private NumberPicker mPickerYear;
-    private NumberPicker mPickerMonth;
-    private NumberPicker mPickerDay;
-    private NumberPicker mPickerHour;
-    private NumberPicker mPickerMinute;
-    private Button mBtnCancel;
-    private Button mBtnConfirm;
-    private OnDateTimeSelectedListener mListener;
-
-    // 时间范围默认值
-    private int mMinYear = 2000;
-    private int mMaxYear = Calendar.getInstance().get(Calendar.YEAR) + 10;
-    private int mMinMonth = 1;
-    private int mMaxMonth = 12;
-    private int mMinDay = 1;
-    private int mMaxDay = 31;
-    private int mMinHour = 0;
-    private int mMaxHour = 23;
-    private int mMinMinute = 0;
-    private int mMaxMinute = 59;
-
-    // 默认选中时间
-    private int mDefaultYear;
-    private int mDefaultMonth;
-    private int mDefaultDay;
-    private int mDefaultHour;
-    private int mDefaultMinute;
-
-    /**
-     * 日期时间选择回调
-     */
-    public interface OnDateTimeSelectedListener {
-        void onDateTimeSelected(int year, int month, int day, int hour, int minute);
-        void onCancel();
-    }
-
-    /**
-     * Builder 模式
-     */
-    public static class Builder {
-        private Context mContext;
-        private DateTimePickerPopup mPopup;
-
-        public Builder(Context context) {
-            this.mContext = context;
-            mPopup = new DateTimePickerPopup(context);
-            Calendar calendar = Calendar.getInstance();
-            mPopup.mDefaultYear = calendar.get(Calendar.YEAR);
-            mPopup.mDefaultMonth = calendar.get(Calendar.MONTH) + 1;
-            mPopup.mDefaultDay = calendar.get(Calendar.DAY_OF_MONTH);
-            mPopup.mDefaultHour = calendar.get(Calendar.HOUR_OF_DAY);
-            mPopup.mDefaultMinute = calendar.get(Calendar.MINUTE);
-        }
-
-        public Builder setDateTimeRange(int minYear, int maxYear, int minMonth, int maxMonth,
-                                       int minDay, int maxDay, int minHour, int maxHour,
-                                       int minMinute, int maxMinute) {
-            mPopup.mMinYear = minYear;
-            mPopup.mMaxYear = maxYear;
-            mPopup.mMinMonth = minMonth;
-            mPopup.mMaxMonth = maxMonth;
-            mPopup.mMinDay = minDay;
-            mPopup.mMaxDay = maxDay;
-            mPopup.mMinHour = minHour;
-            mPopup.mMaxHour = maxHour;
-            mPopup.mMinMinute = minMinute;
-            mPopup.mMaxMinute = maxMinute;
-            return this;
-        }
-
-        public Builder setDefaultDateTime(int year, int month, int day, int hour, int minute) {
-            mPopup.mDefaultYear = year;
-            mPopup.mDefaultMonth = month;
-            mPopup.mDefaultDay = day;
-            mPopup.mDefaultHour = hour;
-            mPopup.mDefaultMinute = minute;
-            return this;
-        }
-
-        public Builder setOnDateTimeSelectedListener(OnDateTimeSelectedListener listener) {
-            mPopup.mListener = listener;
-            return this;
-        }
-
-        public DateTimePickerPopup build() {
-            mPopup.initView();
-            mPopup.initPickers();
-            mPopup.bindButtonClick();
-            mPopup.setPopupStyle();
-            return mPopup;
-        }
-    }
-
-    private DateTimePickerPopup(Context context) {
-        super(context);
-        this.mContext = context;
-    }
-
-    private void initView() {
-        LayoutInflater inflater = LayoutInflater.from(mContext);
-        View rootView = inflater.inflate(R.layout.dialog_date_time_picker, null, false);
-        setContentView(rootView);
-
-        mPickerYear = (NumberPicker) rootView.findViewById(R.id.picker_year);
-        mPickerMonth = (NumberPicker) rootView.findViewById(R.id.picker_month);
-        mPickerDay = (NumberPicker) rootView.findViewById(R.id.picker_day);
-        mPickerHour = (NumberPicker) rootView.findViewById(R.id.picker_hour);
-        mPickerMinute = (NumberPicker) rootView.findViewById(R.id.picker_minute);
-        mBtnCancel = (Button) rootView.findViewById(R.id.btn_cancel);
-        mBtnConfirm = (Button) rootView.findViewById(R.id.btn_confirm);
-    }
-
-    private void initPickers() {
-        // 初始化年选择器
-        mPickerYear.setMinValue(mMinYear);
-        mPickerYear.setMaxValue(mMaxYear);
-        mPickerYear.setValue(mDefaultYear);
-        mPickerYear.setWrapSelectorWheel(false);
-
-        // 初始化月选择器
-        mPickerMonth.setMinValue(mMinMonth);
-        mPickerMonth.setMaxValue(mMaxMonth);
-        mPickerMonth.setValue(mDefaultMonth);
-        mPickerMonth.setWrapSelectorWheel(false);
-
-        // 初始化日选择器（根据年月动态调整范围）
-        updateDayRange(mDefaultYear, mDefaultMonth);
-        mPickerDay.setValue(mDefaultDay);
-        mPickerDay.setWrapSelectorWheel(false);
-
-        // 初始化时选择器
-        mPickerHour.setMinValue(mMinHour);
-        mPickerHour.setMaxValue(mMaxHour);
-        mPickerHour.setValue(mDefaultHour);
-        mPickerHour.setWrapSelectorWheel(false);
-
-        // 初始化分选择器
-        mPickerMinute.setMinValue(mMinMinute);
-        mPickerMinute.setMaxValue(mMaxMinute);
-        mPickerMinute.setValue(mDefaultMinute);
-        mPickerMinute.setWrapSelectorWheel(false);
-
-        // 年月变化时更新日范围（Java 7 匿名内部类）
-        mPickerYear.setOnValueChangedListener(new NumberPicker.OnValueChangeListener() {
-            @Override
-            public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
-                updateDayRange(newVal, mPickerMonth.getValue());
-            }
-        });
-
-        mPickerMonth.setOnValueChangedListener(new NumberPicker.OnValueChangeListener() {
-            @Override
-            public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
-                updateDayRange(mPickerYear.getValue(), newVal);
-            }
-        });
-    }
-
-    private void updateDayRange(int year, int month) {
-        int maxDay;
-        switch (month) {
-            case 2:
-                if ((year % 4 == 0 && year % 100 != 0) || year % 400 == 0) {
-                    maxDay = 29;
-                } else {
-                    maxDay = 28;
-                }
-                break;
-            case 4:
-            case 6:
-            case 9:
-            case 11:
-                maxDay = 30;
-                break;
-            default:
-                maxDay = 31;
-        }
-        mPickerDay.setMaxValue(maxDay);
-        if (mPickerDay.getValue() > maxDay) {
-            mPickerDay.setValue(maxDay);
-        }
-    }
-
-    private void bindButtonClick() {
-        // 取消按钮（Java 7 匿名内部类）
-        mBtnCancel.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View v) {
-                dismiss();
-                if (mListener != null) {
-                    mListener.onCancel();
-                }
-            }
-        });
-
-        // 确认按钮（Java 7 匿名内部类）
-        mBtnConfirm.setOnClickListener(new View.OnClickListener() {
-            @Override
-            public void onClick(View v) {
-                int year = mPickerYear.getValue();
-                int month = mPickerMonth.getValue();
-                int day = mPickerDay.getValue();
-                int hour = mPickerHour.getValue();
-                int minute = mPickerMinute.getValue();
-
-                if (mListener != null) {
-                    mListener.onDateTimeSelected(year, month, day, hour, minute);
-                }
-                dismiss();
-            }
-        });
-    }
-
-    private void setPopupStyle() {
-        int width = (int) (DensityUtils.getScreenWidth(mContext) * 0.85f);
-        int height = ViewGroup.LayoutParams.WRAP_CONTENT;
-
-        setWidth(width);
-        setHeight(height);
-        setFocusable(true);
-        setOutsideTouchable(true);
-        setBackgroundDrawable(mContext.getResources().getDrawable(R.drawable.bg_dialog_round));
-        setAnimationStyle(R.style.PopupDateTimePickerAnim);
-    }
-
-    public void showAsDropDown(View anchorView) {
-        super.showAsDropDown(anchorView, 0, DensityUtils.dp2px(mContext, 10));
-    }
-}

positions/src/main/java/cc/winboll/studio/positions/views/PositionTaskListView.java

@@ -3,7 +3,7 @@ package cc.winboll.studio.positions.views;
 /**
  * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
  * @Date 2025/09/30 08:09
- * @Describe 位置任务列表视图（适配MainService唯一数据源+同步任务状态+支持简单/编辑模式）
+ * @Describe 位置任务列表视图（支持简单/编辑模式，含 isBingo 红点标识）
  */
 import android.content.Context;
 import android.util.AttributeSet;
@@ -14,6 +14,7 @@ import android.widget.Button;
 import android.widget.CompoundButton;
 import android.widget.EditText;
 import android.widget.LinearLayout;
+import android.widget.RadioButton;
 import android.widget.RadioGroup;
 import android.widget.TextView;
 import android.widget.Toast;
@@ -21,39 +22,31 @@ import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import androidx.recyclerview.widget.LinearLayoutManager;
 import androidx.recyclerview.widget.RecyclerView;
-import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.positions.R;
 import cc.winboll.studio.positions.models.PositionTaskModel;
-import cc.winboll.studio.positions.services.MainService;
-import com.jzxiang.pickerview.TimePickerDialog;
-import com.jzxiang.pickerview.listener.OnDateSetListener;
-import java.text.SimpleDateFormat;
 import java.util.ArrayList;
-import java.util.Calendar;
-import java.util.Date;
 import java.util.List;
-import java.util.Locale;
 
 public class PositionTaskListView extends LinearLayout {
     // 视图模式常量
     public static final int VIEW_MODE_SIMPLE = 1;
     public static final int VIEW_MODE_EDIT = 2;
 
-    // 核心成员变量（新增MainService引用，作为唯一数据源）
+    // 核心成员变量
     private String mBindPositionId;
-    private MainService mMainService; // 持有MainService实例，所有任务数据从服务获取
+    private ArrayList<PositionTaskModel> mTaskList;
     private int mCurrentViewMode;
     private TaskListAdapter mTaskAdapter;
     private RecyclerView mRvTasks;
 
-    // 任务修改回调接口（保留，用于通知外部同步UI）
+    // 任务修改回调接口
     public interface OnTaskUpdatedListener {
         void onTaskUpdated(String positionId, ArrayList<PositionTaskModel> updatedTasks);
     }
 
     private OnTaskUpdatedListener mOnTaskUpdatedListener;
 
-    // ---------------------- 构造函数（不变，新增MainService空校验） ----------------------
+    // ---------------------- 构造函数 ----------------------
     public PositionTaskListView(Context context) {
         super(context);
         initView(context);
@@ -69,7 +62,7 @@ public class PositionTaskListView extends LinearLayout {
         initView(context);
     }
 
-    // 初始化视图（绑定控件+设置布局，Adapter初始化为空数据）
+    // 初始化视图（绑定控件+设置布局）
     private void initView(Context context) {
         setOrientation(VERTICAL);
         LayoutInflater.from(context).inflate(R.layout.view_position_task_list, this, true);
@@ -77,204 +70,94 @@ public class PositionTaskListView extends LinearLayout {
         mRvTasks = (RecyclerView) findViewById(R.id.rv_position_tasks);
         mRvTasks.setLayoutManager(new LinearLayoutManager(context));
 
-        // 初始化为空列表（数据后续从MainService同步）
+        mTaskList = new ArrayList<PositionTaskModel>();
-        mTaskAdapter = new TaskListAdapter(new ArrayList<PositionTaskModel>());
+        mTaskAdapter = new TaskListAdapter(mTaskList);
         mRvTasks.setAdapter(mTaskAdapter);
 
         mCurrentViewMode = VIEW_MODE_SIMPLE;
-        LogUtils.d(TAG, "视图初始化完成（等待绑定MainService和位置ID）");
     }
 
-    // ---------------------- 对外API（核心调整：绑定MainService+从服务同步数据） ----------------------
+    // ---------------------- 对外API ----------------------
-    /**
+    public void init(ArrayList<PositionTaskModel> taskList, String positionId) {
-     * 初始化：绑定MainService+关联位置ID（必须先调用此方法，否则无数据）
-     * @param mainService MainService实例（从Activity传入，确保唯一数据源）
-     * @param positionId 关联的位置ID（只加载该位置下的任务）
-     */
-    public void init(MainService mainService, String positionId) {
-        if (mainService == null) {
-            LogUtils.e(TAG, "init失败：MainService实例为空（需从Activity传入有效服务实例）");
-            showToast("任务列表初始化失败：服务未就绪");
-            return;
-        }
-        if (positionId == null || positionId.trim().isEmpty()) {
-            LogUtils.e(TAG, "init失败：位置ID为空（需关联有效位置）");
-            showToast("任务列表初始化失败：未关联位置");
-            return;
-        }
-
-        // 绑定服务实例+位置ID
-        this.mMainService = mainService;
         this.mBindPositionId = positionId;
-        LogUtils.d(TAG, "已绑定MainService和位置ID：" + positionId);
+        if (this.mTaskList.isEmpty()) {
-
+            ArrayList<PositionTaskModel> matchedTasks = new ArrayList<PositionTaskModel>();
-        // 从MainService同步当前位置的任务（核心：数据来源改为服务）
+            if (taskList != null && !taskList.isEmpty()) {
-        syncTasksFromMainService();
+                for (PositionTaskModel task : taskList) {
-    }
+                    if (task != null && positionId.equals(task.getPositionId())) {
-
+                        matchedTasks.add(task);
-    /**
-     * 从MainService同步当前位置的任务（核心方法，所有数据加载入口）
-     * 作用：1. 清空本地缓存→2. 从服务获取全量任务→3. 筛选当前位置任务→4. 刷新Adapter
-     */
-    public void syncTasksFromMainService() {
-        // 安全校验（服务未绑定/位置ID为空，不执行同步）
-        if (mMainService == null || mBindPositionId == null || mBindPositionId.trim().isEmpty()) {
-            LogUtils.w(TAG, "同步任务失败：MainService未绑定或位置ID无效");
-            return;
-        }
-
-        try {
-            // 1. 从MainService获取全量任务（服务是唯一数据源，避免本地缓存不一致）
-            ArrayList<PositionTaskModel> allServiceTasks = mMainService.getAllTasks();
-            LogUtils.d(TAG, "从MainService获取全量任务数：" + (allServiceTasks == null ? 0 : allServiceTasks.size()));
-
-            // 2. 筛选当前位置关联的任务（只保留与mBindPositionId匹配的任务）
-            ArrayList<PositionTaskModel> currentPosTasks = new ArrayList<PositionTaskModel>();
-            if (allServiceTasks != null && !allServiceTasks.isEmpty()) {
-                for (PositionTaskModel task : allServiceTasks) {
-                    if (isTaskMatchedWithPosition(task)) {
-                        currentPosTasks.add(task);
                     }
                 }
             }
-            LogUtils.d(TAG, "筛选后当前位置任务数：" + currentPosTasks.size());
+            mTaskList.clear();
-
+            mTaskList.addAll(matchedTasks);
-            // 3. 更新Adapter数据（直接替换数据源，避免本地缓存）
-            mTaskAdapter.updateData(currentPosTasks);
-            LogUtils.d(TAG, "从MainService同步任务完成（Adapter已刷新）");
-
-        } catch (Exception e) {
-            LogUtils.d(TAG, "同步任务失败（MainService调用异常）：" + e.getMessage());
-            showToast("任务同步失败，请重试");
         }
+        mTaskAdapter.notifyDataSetChanged();
     }
 
-    // 视图模式切换（不变，刷新Adapter触发视图类型变更）
     public void setViewStatus(int viewMode) {
         if (viewMode != VIEW_MODE_SIMPLE && viewMode != VIEW_MODE_EDIT) {
-            LogUtils.w(TAG, "设置视图模式失败：无效模式（仅支持简单/编辑模式）");
             return;
         }
         mCurrentViewMode = viewMode;
         mTaskAdapter.notifyDataSetChanged();
-        LogUtils.d(TAG, "已切换视图模式：" + (viewMode == VIEW_MODE_SIMPLE ? "简单模式" : "编辑模式"));
     }
 
-    // 保留回调接口（用于通知外部UI刷新，如Activity更新列表）
     public void setOnTaskUpdatedListener(OnTaskUpdatedListener listener) {
         this.mOnTaskUpdatedListener = listener;
-        LogUtils.d(TAG, "已设置任务更新回调监听");
     }
 
-    /**
+    public ArrayList<PositionTaskModel> getAllTasks() {
-     * 获取当前位置的任务（从Adapter数据源获取，而非本地缓存）
+        return new ArrayList<PositionTaskModel>(mTaskList);
-     * @return 当前位置任务列表（新集合，避免外部修改数据源）
-     */
-    public ArrayList<PositionTaskModel> getCurrentPosTasks() {
-        return new ArrayList<PositionTaskModel>(mTaskAdapter.getAdapterData());
     }
 
-    /**
-     * 清空数据（解绑服务+清空位置ID+重置Adapter）
-     * 场景：视图销毁/切换位置时调用，避免数据残留
-     */
     public void clearData() {
-        // 1. 清空Adapter数据源
+        mTaskList.clear();
-        mTaskAdapter.updateData(new ArrayList<PositionTaskModel>());
+        if (mTaskAdapter != null && mTaskAdapter.mData != null) {
-        // 2. 解绑服务+位置ID（避免下次使用时引用旧数据）
+            mTaskAdapter.mData.clear();
-        this.mMainService = null;
+        }
-        this.mBindPositionId = null;
+        mTaskAdapter.notifyDataSetChanged();
-        // 3. 重置视图模式
+        mBindPositionId = null;
-        mCurrentViewMode = VIEW_MODE_SIMPLE;
-        LogUtils.d(TAG, "数据已清空（解绑服务+重置视图）");
     }
 
-    /**
-     * 主动触发任务同步（强制从服务拉取最新数据，刷新视图）
-     * 场景：外部操作后（如新增任务），调用此方法更新列表
-     */
     public void triggerTaskSync() {
-        LogUtils.d(TAG, "主动触发任务同步（从MainService拉取最新数据）");
-        syncTasksFromMainService();
-
-        // 通知外部（如Activity）任务已更新（可选，根据业务需求）
         if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
-            mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, getCurrentPosTasks());
+            mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<PositionTaskModel>(mTaskList));
         }
     }
 
-    // ---------------------- 内部工具方法（新增服务空校验） ----------------------
+    // ---------------------- 内部工具方法 ----------------------
-    private static final String TAG = "PositionTaskListView";
-
-    /**
-     * 校验任务是否与当前绑定的位置匹配
-     * @param task 待校验的任务
-     * @return true=匹配（任务位置ID=当前绑定位置ID），false=不匹配
-     */
     private boolean isTaskMatchedWithPosition(PositionTaskModel task) {
         if (task == null || mBindPositionId == null || mBindPositionId.trim().isEmpty()) {
             return false;
         }
-        // 严格匹配任务的位置ID（确保只加载当前位置的任务）
         return mBindPositionId.equals(task.getPositionId());
     }
 
-    /**
+    // ---------------------- 内部Adapter：适配 isBingo 红点（核心调整） ----------------------
-     * 显示Toast（简化调用，避免重复代码）
-     */
-    private void showToast(String content) {
-        if (getContext() == null) return;
-        Toast.makeText(getContext(), content, Toast.LENGTH_SHORT).show();
-    }
-
-    // ---------------------- 内部Adapter：适配MainService数据源（核心调整） ----------------------
     private class TaskListAdapter extends RecyclerView.Adapter<TaskListAdapter.TaskViewHolder> {
-        // Adapter数据源（仅保留一份，直接从MainService同步，无本地冗余）
+        private final List<PositionTaskModel> mData;
-        private List<PositionTaskModel> mAdapterData;
 
-        // 初始化Adapter（空数据源）
         public TaskListAdapter(List<PositionTaskModel> data) {
-            this.mAdapterData = new ArrayList<PositionTaskModel>(data); // 防御性拷贝，避免外部修改
+            this.mData = data;
         }
 
-        /**
-         * 更新Adapter数据源（核心：从MainService同步后调用，替换数据源并刷新）
-         * @param newData 从MainService筛选后的当前位置任务列表
-         */
-        public void updateData(List<PositionTaskModel> newData) {
-            if (newData == null) {
-                this.mAdapterData.clear();
-            } else {
-                this.mAdapterData = new ArrayList<PositionTaskModel>(newData); // 防御性拷贝
-            }
-            notifyDataSetChanged(); // 刷新列表（数据源已替换，确保显示最新数据）
-        }
-
-        /**
-         * 获取Adapter当前数据源（对外提供，避免直接操作mAdapterData）
-         * @return 当前数据源（新集合，避免外部修改）
-         */
-        public List<PositionTaskModel> getAdapterData() {
-            return new ArrayList<PositionTaskModel>(mAdapterData);
-        }
-
-        //  getItemCount：空列表显示1个“空提示”项，非空显示任务数
         @Override
         public int getItemCount() {
-            return mAdapterData.isEmpty() ? 1 : mAdapterData.size();
+            return mData.isEmpty() ? 1 : mData.size();
         }
 
-        //  getItemViewType：按“空列表/简单模式/编辑模式”区分视图类型（不变）
+        // 调整：根据“是否空列表”+“视图模式”区分视图类型（确保简单/编辑模式加载对应布局）
         @Override
         public int getItemViewType(int position) {
-            if (mAdapterData.isEmpty()) {
+            if (mData.isEmpty()) {
-                return 0; // 0=空提示视图
+                return 0; // 0=空提示
             } else {
-                return mCurrentViewMode; // 1=简单模式视图，2=编辑模式视图
+                return mCurrentViewMode; // 1=简单模式，2=编辑模式（复用视图模式常量）
             }
         }
 
-        //  onCreateViewHolder：按视图类型加载对应布局（不变，确保布局与模式匹配）
+        // 调整：按视图类型加载布局（简单模式加载带红点的布局，编辑模式加载原有布局）
         @NonNull
         @Override
         public TaskViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
@@ -282,298 +165,150 @@ public class PositionTaskListView extends LinearLayout {
             LayoutInflater inflater = LayoutInflater.from(context);
 
             if (viewType == 0) {
-                // 空提示布局（无任务时显示）
+                // 空提示布局
                 View emptyView = inflater.inflate(R.layout.item_task_empty, parent, false);
                 return new EmptyViewHolder(emptyView);
             } else if (viewType == VIEW_MODE_SIMPLE) {
-                // 简单模式布局（带isBingo红点，仅展示）
+                // 简单模式布局（带 isBingo 红点）
                 View simpleTaskView = inflater.inflate(R.layout.item_position_task_simple, parent, false);
                 return new SimpleTaskViewHolder(simpleTaskView);
             } else {
-                // 编辑模式布局（带编辑/删除按钮+启用开关，支持修改）
+                // 编辑模式布局（原有布局不变）
                 View editTaskView = inflater.inflate(R.layout.item_task_content, parent, false);
                 return new TaskContentViewHolder(editTaskView);
             }
         }
 
-        //  onBindViewHolder：按视图类型绑定数据（核心调整：操作后同步MainService）
+        // 调整：按视图类型绑定数据（简单模式绑定红点+文本，编辑模式绑定原有逻辑）
         @Override
         public void onBindViewHolder(@NonNull TaskViewHolder holder, int position) {
-            // 1. 空提示视图绑定（根据模式显示不同提示文案）
+            // 空提示处理（不变）
             if (holder instanceof EmptyViewHolder) {
                 EmptyViewHolder emptyHolder = (EmptyViewHolder) holder;
-                TextView tvEmptyTip = emptyHolder.itemView.findViewById(R.id.tv_task_empty_tip);
+                TextView tvEmptyTip = (TextView) emptyHolder.itemView.findViewById(R.id.tv_task_empty_tip);
-                tvEmptyTip.setText(mCurrentViewMode == VIEW_MODE_EDIT 
+                tvEmptyTip.setText(mCurrentViewMode == VIEW_MODE_EDIT ? "暂无任务，点击\"添加新任务\"创建" : "暂无启用的任务");
-								   ? "暂无任务，点击\"添加新任务\"创建" 
-								   : "暂无启用的任务");
                 return;
             }
 
-            // 2. 任务项有效性校验（避免越界/空数据）
+            // 任务项有效性校验（不变）
-            if (position >= mAdapterData.size()) {
+            if (position >= mData.size()) {
-                LogUtils.w(TAG, "绑定任务数据失败：位置索引越界（position=" + position + "，数据量=" + mAdapterData.size() + "）");
                 return;
             }
-            final PositionTaskModel task = mAdapterData.get(position);
+            final PositionTaskModel task = mData.get(position);
             if (task == null) {
-                LogUtils.w(TAG, "绑定任务数据失败：第" + position + "项任务为空");
                 return;
             }
 
-            // 3. 简单模式绑定（仅展示，无修改操作，不变）
+            // 简单模式：绑定红点（isBingo）和文本数据
             if (holder instanceof SimpleTaskViewHolder) {
                 SimpleTaskViewHolder simpleHolder = (SimpleTaskViewHolder) holder;
-                // 任务描述
+                // 绑定任务描述
-                String taskDesc = task.getTaskDescription() == null ? "未设置描述" : task.getTaskDescription();
+                simpleHolder.tvSimpleTaskDesc.setText(String.format("任务：%s", task.getTaskDescription()));
-                simpleHolder.tvSimpleTaskDesc.setText(String.format("任务：%s", taskDesc));
+                // 绑定距离条件
-				simpleHolder.tvStartTime.setText(genSelectedTimeText(task.getStartTime()));
-                // 距离条件（大于/小于+距离值）
                 String distanceCond = task.isGreaterThan() ? "大于" : "小于";
                 simpleHolder.tvSimpleDistanceCond.setText(String.format("条件：距离 %s %d 米", distanceCond, task.getDiscussDistance()));
-                // 启用状态
+                // 绑定启用状态
                 simpleHolder.tvSimpleIsEnable.setText(task.isEnable() ? "状态：已启用" : "状态：已禁用");
-                // isBingo红点（任务触发时显示，未触发时隐藏）
+                // 核心：根据 isBingo 控制红点显示（true=显示，false=隐藏）
                 simpleHolder.vBingoDot.setVisibility(task.isBingo() ? View.VISIBLE : View.GONE);
-            } else if (holder instanceof TaskContentViewHolder) {
+            }
+            // 编辑模式：沿用原有绑定逻辑（核心修复在此处）
+            else if (holder instanceof TaskContentViewHolder) {
                 TaskContentViewHolder contentHolder = (TaskContentViewHolder) holder;
-                bindEditModeTask(contentHolder, task, position);
+                bindTaskData(contentHolder, task, position);
             }
         }
 
-        /**
+        // ---------------------- 核心修复：编辑模式绑定逻辑（解决布局中通知异常） ----------------------
-         * 编辑模式任务绑定（核心：修改操作→更新MainService→刷新Adapter）
+        private void bindTaskData(final TaskContentViewHolder holder, final PositionTaskModel task, final int position) {
-         */
+            String taskDesc = (task.getTaskDescription() == null) ? "未设置描述" : task.getTaskDescription();
-        private void bindEditModeTask(final TaskContentViewHolder holder, final PositionTaskModel task, final int position) {
-            // 4.1 绑定基础数据（描述+距离条件）
-            String taskDesc = task.getTaskDescription() == null ? "未设置描述" : task.getTaskDescription();
             holder.tvTaskDesc.setText(String.format("任务：%s", taskDesc));
-            String distanceCond = task.isGreaterThan() ? "大于" : "小于";
-            holder.tvTaskDistance.setText(String.format("条件：%s %d 米", distanceCond, task.getDiscussDistance()));
-			holder.tvStartTime.setText(genSelectedTimeText(task.getStartTime()));
 
-            // 4.2 绑定“启用开关”（修复：先解绑监听→设值→再绑定监听，避免设值触发回调）
+            String distanceCondition = task.isGreaterThan() ? "大于" : "小于";
+            holder.tvTaskDistance.setText(String.format("条件：%s %d 米", distanceCondition, task.getDiscussDistance()));
+
+            // 修复点1：先移除开关监听，再设置状态（避免设值时触发回调导致异常）
             holder.cbTaskEnable.setOnCheckedChangeListener(null);
             holder.cbTaskEnable.setChecked(task.isEnable());
-            holder.cbTaskEnable.setEnabled(mCurrentViewMode == VIEW_MODE_EDIT); // 编辑模式才允许操作
+            holder.cbTaskEnable.setEnabled(mCurrentViewMode == VIEW_MODE_EDIT);
 
-            // 4.3 编辑模式特有：显示编辑/删除按钮（仅编辑模式可见）
+            if (mCurrentViewMode == VIEW_MODE_EDIT) {
-            holder.btnEditTask.setVisibility(View.VISIBLE);
+                holder.btnEditTask.setVisibility(View.VISIBLE);
-            holder.btnDeleteTask.setVisibility(View.VISIBLE);
+                holder.btnDeleteTask.setVisibility(View.VISIBLE);
 
-            // 4.4 删除按钮逻辑（核心：删除→同步MainService→刷新Adapter）
+                // 删除按钮逻辑（不变，本身在点击时执行，不涉及布局中通知）
-            holder.btnDeleteTask.setOnClickListener(new View.OnClickListener() {
+                holder.btnDeleteTask.setOnClickListener(new View.OnClickListener() {
-					@Override
+						@Override
-					public void onClick(View v) {
+						public void onClick(View v) {
-						if (mMainService == null) {
+							mData.remove(position);
-							showToast("删除失败：服务未就绪");
-							LogUtils.e(TAG, "删除任务失败：MainService实例为空");
-							return;
-						}
-
-						try {
-							// 步骤1：调用MainService删除任务（服务是唯一数据源，确保数据一致性）
-							mMainService.deleteTask(task.getTaskId()); // 需在MainService中实现deleteTask()方法（删除服务内全量任务列表中的对应项）
-							LogUtils.d(TAG, "调用MainService删除任务：ID=" + task.getTaskId() + "（位置ID=" + mBindPositionId + "）");
-
-							// 步骤2：从Adapter数据源移除任务（避免等待同步，立即反馈UI）
-							//mAdapterData.remove(position);
-							// 步骤3：刷新Adapter（局部刷新+范围通知，避免列表错乱）
 							notifyItemRemoved(position);
-							notifyItemRangeChanged(position, mAdapterData.size());
+							notifyItemRangeChanged(position, mData.size());
-							
-							LogUtils.d(TAG, "Adapter已移除任务，刷新列表（位置索引=" + position + "）");
-
-							// 步骤4：通知外部（如Activity）任务已更新
 							if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
-								mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<PositionTaskModel>(mAdapterData));
+								mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<PositionTaskModel>(mData));
 							}
-							showToast("任务已删除（已同步至服务）");
+							Toast.makeText(getContext(), "任务已删除", Toast.LENGTH_SHORT).show();
-
-						} catch (Exception e) {
-							LogUtils.d(TAG, "删除任务失败（服务调用/Adapter刷新异常）：" + e.getMessage());
-							showToast("删除失败，请重试");
-							// 异常时重新同步数据（确保Adapter与服务一致）
-							syncTasksFromMainService();
 						}
-					}
+					});
-				});
 
-            // 4.5 编辑按钮逻辑（核心：修改后同步MainService→刷新Adapter）
+                // 编辑按钮逻辑（不变，弹窗保存时修复通知时机）
-            holder.btnEditTask.setOnClickListener(new View.OnClickListener() {
+                holder.btnEditTask.setOnClickListener(new View.OnClickListener() {
-					@Override
+						@Override
-					public void onClick(View v) {
+						public void onClick(View v) {
-						if (mMainService == null) {
+							showTaskEditDialog(task, position);
-							showToast("编辑失败：服务未就绪");
-							LogUtils.e(TAG, "编辑任务失败：MainService实例为空");
-							return;
 						}
-						// 弹出编辑弹窗（修改后同步服务）
+					});
-						showEditTaskDialog(task, position);
-					}
-				});
 
-            // 4.6 启用开关逻辑（核心：状态变更→同步MainService→刷新Adapter）
+                // 修复点2：开关监听-用 RecyclerView.post 延迟执行 notify（避免布局中调用）
-            holder.cbTaskEnable.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
+                holder.cbTaskEnable.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
-					@Override
+						@Override
-					public void onCheckedChanged(CompoundButton buttonView, final boolean isChecked) {
+						public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
-						if (mMainService == null) {
+							task.setIsEnable(isChecked); // 先更新数据源（必须执行）
-							showToast("状态修改失败：服务未就绪");
+							// 关键：通过 mRvTasks.post 延迟通知，确保在布局计算/滚动结束后执行
-							LogUtils.e(TAG, "修改任务启用状态失败：MainService实例为空");
-							// 回滚开关状态（避免UI与服务不一致）
-							buttonView.setChecked(!isChecked);
-							return;
-						}
-
-						try {
-							// 步骤1：更新任务状态（先改内存数据，确保UI反馈及时）
-							task.setIsEnable(isChecked);
-							LogUtils.d(TAG, "更新任务启用状态：ID=" + task.getTaskId() + "，新状态=" + (isChecked ? "启用" : "禁用"));
-
-							// 步骤2：调用MainService同步状态（服务是唯一数据源，持久化变更）
-							mMainService.updateTaskStatus(task); // 需在MainService中实现updateTaskStatus()方法（更新服务内任务的isEnable字段）
-							LogUtils.d(TAG, "调用MainService同步任务状态（已" + (isChecked ? "启用" : "禁用") + "）");
-
-							// 步骤3：延迟刷新Adapter（避免列表滚动/布局计算时异常）
 							mRvTasks.post(new Runnable() {
 									@Override
 									public void run() {
 										notifyItemChanged(position);
-										// 通知外部任务已更新
 										if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
-											mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<PositionTaskModel>(mAdapterData));
+											mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<PositionTaskModel>(mData));
 										}
 									}
 								});
-
-						} catch (Exception e) {
-							LogUtils.d(TAG, "修改任务启用状态失败：" + e.getMessage());
-							showToast("状态修改失败，请重试");
-							// 回滚状态（UI与服务保持一致）
-							buttonView.setChecked(!isChecked);
-							task.setIsEnable(!isChecked);
-							// 重新同步数据（修复可能的不一致）
-							syncTasksFromMainService();
 						}
-					}
+					});
-				});
+            } else {
-        }
+                holder.btnEditTask.setVisibility(View.GONE);
-		
+                holder.btnDeleteTask.setVisibility(View.GONE);
-		private String genSelectedTimeText(long timeMillis) {
+                holder.cbTaskEnable.setOnCheckedChangeListener(null);
-			// 2. 格式化时间字符串（Java 7 用 SimpleDateFormat，需处理 ParseException）
-			SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm", Locale.getDefault());
-			String formattedDateTime = sdf.format(new Date(timeMillis)); // Date 需导入 java.util.Date
-
-			return formattedDateTime;
-		}
-
-        /**
-         * 编辑任务弹窗（核心：保存修改→同步MainService→刷新Adapter）
-         */
-        private void showEditTaskDialog(final PositionTaskModel task, final int position) {
-            final Context context = getContext();
-            if (context == null) {
-                LogUtils.w(TAG, "编辑弹窗无法显示：上下文为空");
-                return;
             }
+        }
 
-            // 加载弹窗布局
+        // ---------------------- 修复：编辑弹窗保存逻辑（延迟通知，避免极端场景异常） ----------------------
+        private void showTaskEditDialog(final PositionTaskModel task, final int position) {
+            final Context context = getContext();
             View dialogView = LayoutInflater.from(context).inflate(R.layout.dialog_edit_task, null);
-            final EditText etEditDesc = dialogView.findViewById(R.id.et_edit_task_desc);
-            final RadioGroup rgDistanceCondition = dialogView.findViewById(R.id.rg_distance_condition);
-            final EditText etEditDistance = dialogView.findViewById(R.id.et_edit_distance);
-			Button btnCancel = dialogView.findViewById(R.id.btn_dialog_cancel);
-            Button btnSave = dialogView.findViewById(R.id.btn_dialog_save);
 
+            final EditText etEditDesc = (EditText) dialogView.findViewById(R.id.et_edit_task_desc);
+            final RadioGroup rgDistanceCondition = (RadioGroup) dialogView.findViewById(R.id.rg_distance_condition);
+            final EditText etEditDistance = (EditText) dialogView.findViewById(R.id.et_edit_distance);
+            Button btnCancel = (Button) dialogView.findViewById(R.id.btn_dialog_cancel);
+            Button btnSave = (Button) dialogView.findViewById(R.id.btn_dialog_save);
 
-			// 绑定外层对话框内的控件
+            etEditDesc.setText(task.getTaskDescription());
-			final Button btnSelectTime = (Button) dialogView.findViewById(R.id.btn_select_time);
+            etEditDesc.setSelection(etEditDesc.getText().length());
-			final TextView tv_SelectedTime = (TextView) dialogView.findViewById(R.id.tv_selected_time);
 
-			tv_SelectedTime.setText(genSelectedTimeText(task.getStartTime()));
-
-			// 核心：从 long 时间戳解析年月日时分，用于初始化弹窗
-			// --------------------------
-			Calendar initCalendar = Calendar.getInstance();
-			initCalendar.setTimeInMillis(task.getStartTime()); // 将 long 时间戳传入 Calendar
-
-			// 从 Calendar 中解析出年月日时分（对应弹窗需要的参数格式）
-			int initYear = initCalendar.get(Calendar.YEAR);
-			int initMonth = initCalendar.get(Calendar.MONTH) + 1; // 关键：Calendar 月份0-11，转成1-12
-			int initDay = initCalendar.get(Calendar.DAY_OF_MONTH);
-			int initHour = initCalendar.get(Calendar.HOUR_OF_DAY); // 24小时制
-			int initMinute = initCalendar.get(Calendar.MINUTE);
-
-			// 初始化弹窗，用解析出的年月日时分设置默认选中时间
-			final DateTimePickerPopup dateTimePopup = new DateTimePickerPopup.Builder(context)
-				.setDateTimeRange(2020, 2030, 1, 12, 1, 31, 0, 23, 0, 59)
-				// 用 long 时间戳解析出的参数设置初始时间
-				.setDefaultDateTime(initYear, initMonth, initDay, initHour, initMinute)
-				.setOnDateTimeSelectedListener(new DateTimePickerPopup.OnDateTimeSelectedListener() {
-					@Override
-					public void onDateTimeSelected(int year, int month, int day, int hour, int minute) {
-						// 处理选择的日期时间
-						// 1. 创建 Calendar 实例（用于组装日期时间）
-						Calendar calendar = Calendar.getInstance();
-						// 2. 设置 Calendar 的年、月、日、时、分（注意：Calendar 月份从 0 开始，需减 1）
-						calendar.set(Calendar.YEAR, year);
-						calendar.set(Calendar.MONTH, month - 1); // 关键：传入的 month 是 1-12，需转为 0-11
-						calendar.set(Calendar.DAY_OF_MONTH, day);
-						calendar.set(Calendar.HOUR_OF_DAY, hour); // 24小时制，对应参数中的 hour（0-23）
-						calendar.set(Calendar.MINUTE, minute);
-						calendar.set(Calendar.SECOND, 0); // 秒默认设为 0，避免随机值
-						calendar.set(Calendar.MILLISECOND, 0); // 毫秒默认设为 0，确保时间戳精确
-
-						// 3. 转为 long 类型时间戳（单位：毫秒，从 1970-01-01 00:00:00 开始计算）
-						long timeMillis = calendar.getTimeInMillis();
-
-						// 4. 后续使用（示例：打印时间戳或传递给其他逻辑）
-						tv_SelectedTime.setText(genSelectedTimeText(timeMillis));
-						task.setStartTime(timeMillis);
-					}
-
-					@Override
-					public void onCancel() {
-						// 处理取消操作
-					}
-				})
-				.build();
-
-			// 3. “选择时间”按钮点击事件（弹出 TimePickerPopup）
-			btnSelectTime.setOnClickListener(new View.OnClickListener() {
-					@Override
-					public void onClick(final View v) {
-						dateTimePopup.showAsDropDown(btnSelectTime);
-					}
-				});
-
-
-            // 初始化弹窗数据（填充当前任务信息）
-            etEditDesc.setText(task.getTaskDescription() == null ? "" : task.getTaskDescription());
-            etEditDesc.setSelection(etEditDesc.getText().length()); // 光标定位到末尾
-            // 初始化距离条件（大于/小于）
             if (task.isGreaterThan()) {
                 rgDistanceCondition.check(R.id.rb_greater_than);
             } else {
                 rgDistanceCondition.check(R.id.rb_less_than);
             }
-            etEditDistance.setText(String.valueOf(task.getDiscussDistance())); // 填充当前距离
 
-            // 创建并显示弹窗
+            etEditDistance.setText(String.valueOf(task.getDiscussDistance()));
+
             final android.app.AlertDialog dialog = new android.app.AlertDialog.Builder(context)
 				.setView(dialogView)
-				.setCancelable(false) // 不允许点击外部关闭（避免未保存退出）
 				.create();
             dialog.show();
 
-
-
-			final OnDateSetListener onSateSetListener = new OnDateSetListener(){
-				@Override
-				public void onDateSet(TimePickerDialog timePickerDialog, long p) {
-				}
-			};
-
-            // 取消按钮：关闭弹窗（不做操作）
             btnCancel.setOnClickListener(new View.OnClickListener() {
 					@Override
 					public void onClick(View v) {
@@ -581,17 +316,14 @@ public class PositionTaskListView extends LinearLayout {
 					}
 				});
 
-            // 保存按钮：校验输入→更新任务→同步服务→刷新UI
             btnSave.setOnClickListener(new View.OnClickListener() {
 					@Override
 					public void onClick(View v) {
-						// 1. 输入校验（避免无效数据）
 						String newDesc = etEditDesc.getText().toString().trim();
 						String distanceStr = etEditDistance.getText().toString().trim();
 
 						if (distanceStr.isEmpty()) {
-							showToast("请输入有效距离（1米及以上）");
+							Toast.makeText(context, "请输入有效距离", Toast.LENGTH_SHORT).show();
-							etEditDistance.requestFocus();
 							return;
 						}
 
@@ -599,154 +331,86 @@ public class PositionTaskListView extends LinearLayout {
 						try {
 							newDistance = Integer.parseInt(distanceStr);
 							if (newDistance < 1) {
-								showToast("距离不能小于1米");
+								Toast.makeText(context, "距离不能小于1米", Toast.LENGTH_SHORT).show();
-								etEditDistance.requestFocus();
 								return;
 							}
 						} catch (NumberFormatException e) {
-							showToast("距离请输入数字");
+							Toast.makeText(context, "距离请输入数字", Toast.LENGTH_SHORT).show();
-							etEditDistance.requestFocus();
 							return;
 						}
 
-						// 2. 收集新数据（更新任务对象）
+						task.setTaskDescription(newDesc);
-						task.setTaskDescription(newDesc); // 新描述
+						task.setDiscussDistance(newDistance);
-						task.setDiscussDistance(newDistance); // 新距离
 						boolean isGreater = rgDistanceCondition.getCheckedRadioButtonId() == R.id.rb_greater_than;
-						task.setIsGreaterThan(isGreater); // 新距离条件（大于/小于）
+						task.setIsGreaterThan(isGreater);
-						task.setPositionId(mBindPositionId); // 确保位置ID不变（防止错位）
+						task.setPositionId(mBindPositionId);
 
-						try {
+						// 修复点3：弹窗保存后延迟通知（同开关逻辑，避免列表滚动时异常）
-							// 3. 调用MainService同步修改（服务是唯一数据源，持久化变更）
+						mRvTasks.post(new Runnable() {
-							mMainService.updateTask(task); // 需在MainService中实现updateTask()方法（更新服务内任务的字段）
+								@Override
-							LogUtils.d(TAG, "调用MainService更新任务：ID=" + task.getTaskId() + "（描述=" + newDesc + "，距离=" + newDistance + "米）");
+								public void run() {
-
+									notifyItemChanged(position);
-							// 4. 更新Adapter数据源（立即反馈UI）
+									if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
-							mAdapterData.set(position, task);
+										mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<PositionTaskModel>(mData));
-							// 5. 延迟刷新Adapter（避免弹窗未关闭时布局异常）
-							mRvTasks.post(new Runnable() {
-									@Override
-									public void run() {
-										notifyItemChanged(position);
-										// 通知外部任务已更新
-										if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
-											mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<PositionTaskModel>(mAdapterData));
-										}
 									}
-								});
+								}
+							});
 
-							dialog.dismiss();
+						dialog.dismiss();
-							showToast("任务已更新（已同步至服务）");
+						Toast.makeText(context, "任务已更新", Toast.LENGTH_SHORT).show();
-
-						} catch (Exception e) {
-							LogUtils.d(TAG, "保存任务修改失败：" + e.getMessage());
-							showToast("保存失败，请重试");
-							// 重新同步数据（修复可能的不一致）
-							syncTasksFromMainService();
-						}
 					}
 				});
         }
 
-        // ---------------------- ViewHolder 定义（完全适配布局，无修改） ----------------------
+        // ---------------------- ViewHolder 定义（完全不变） ----------------------
-        // 基础抽象ViewHolder（统一父类，适配多视图类型）
+        // 基础抽象 ViewHolder（不变）
         public abstract class TaskViewHolder extends RecyclerView.ViewHolder {
             public TaskViewHolder(@NonNull View itemView) {
                 super(itemView);
             }
         }
 
-        // 空提示ViewHolder（对应 item_task_empty.xml）
+        // 空提示 Holder（不变）
         public class EmptyViewHolder extends TaskViewHolder {
             public EmptyViewHolder(@NonNull View itemView) {
                 super(itemView);
             }
         }
 
-        // 简单模式ViewHolder（对应 item_position_task_simple.xml，带isBingo红点）
+        // 新增：简单模式 Holder（绑定带红点的布局控件）
         public class SimpleTaskViewHolder extends TaskViewHolder {
             TextView tvSimpleTaskDesc;    // 任务描述
-            TextView tvSimpleDistanceCond;// 距离条件（大于/小于+距离）
+            TextView tvSimpleDistanceCond;// 距离条件
-			TextView tvStartTime;
+            TextView tvSimpleIsEnable;    // 启用状态
-            TextView tvSimpleIsEnable;    // 启用状态（已启用/已禁用）
+            View vBingoDot;               // isBingo 红点控件
-            View vBingoDot;               // isBingo红点（任务触发时显示）
 
             public SimpleTaskViewHolder(@NonNull View itemView) {
                 super(itemView);
-                // 绑定简单模式布局控件（与XML控件ID严格对应）
+                // 绑定简单模式布局中的控件（与 item_task_simple.xml 完全对应）
                 tvSimpleTaskDesc = itemView.findViewById(R.id.tv_simple_task_desc);
                 tvSimpleDistanceCond = itemView.findViewById(R.id.tv_simple_distance_cond);
-				tvStartTime = itemView.findViewById(R.id.tv_starttime);
                 tvSimpleIsEnable = itemView.findViewById(R.id.tv_simple_is_enable);
                 vBingoDot = itemView.findViewById(R.id.v_bingo_dot);
             }
         }
 
-        // 编辑模式ViewHolder（对应 item_task_content.xml，带编辑/删除/开关）
+        // 编辑模式 Holder（原有逻辑，完全不变）
         public class TaskContentViewHolder extends TaskViewHolder {
-            TextView tvTaskDesc;         // 任务描述
+            TextView tvTaskDesc;
-            TextView tvTaskDistance;     // 距离条件
+            TextView tvTaskDistance;
-			TextView tvStartTime;
+            CompoundButton cbTaskEnable;
-            CompoundButton cbTaskEnable; // 启用开关
+            Button btnEditTask;
-            Button btnEditTask;          // 编辑按钮
+            Button btnDeleteTask;
-            Button btnDeleteTask;        // 删除按钮
 
             public TaskContentViewHolder(@NonNull View itemView) {
                 super(itemView);
-                // 绑定编辑模式布局控件（与XML控件ID严格对应）
+                tvTaskDesc = (TextView) itemView.findViewById(R.id.tv_task_desc);
-                tvTaskDesc = itemView.findViewById(R.id.tv_task_desc);
+                tvTaskDistance = (TextView) itemView.findViewById(R.id.tv_task_distance);
-                tvTaskDistance = itemView.findViewById(R.id.tv_task_distance);
+                cbTaskEnable = (CompoundButton) itemView.findViewById(R.id.cb_task_enable);
-				tvStartTime = itemView.findViewById(R.id.tv_starttime);
+                btnEditTask = (Button) itemView.findViewById(R.id.btn_edit_task);
-                cbTaskEnable = itemView.findViewById(R.id.cb_task_enable);
+                btnDeleteTask = (Button) itemView.findViewById(R.id.btn_delete_task);
-                btnEditTask = itemView.findViewById(R.id.btn_edit_task);
-                btnDeleteTask = itemView.findViewById(R.id.btn_delete_task);
             }
         }
     }
-
-    // ---------------------- 新增：外部调用“新增任务”方法（适配MainService） ----------------------
-    /**
-     * 新增任务（对外提供，如Activity调用添加任务）
-     * @param newTask 待新增的任务（需关联当前位置ID）
-     */
-    public void addNewTask(PositionTaskModel newTask) {
-        if (mMainService == null) {
-            showToast("新增任务失败：服务未就绪");
-            LogUtils.e(TAG, "新增任务失败：MainService实例为空");
-            return;
-        }
-        if (newTask == null) {
-            showToast("新增任务失败：任务数据为空");
-            LogUtils.e(TAG, "新增任务失败：待新增任务对象为空");
-            return;
-        }
-        if (mBindPositionId == null || mBindPositionId.trim().isEmpty()) {
-            showToast("新增任务失败：未关联位置");
-            LogUtils.e(TAG, "新增任务失败：未绑定位置ID（需先调用init()方法）");
-            return;
-        }
-
-        try {
-            // 1. 关联任务到当前位置（确保任务属于当前位置）
-            newTask.setPositionId(mBindPositionId);
-            // 2. 调用MainService新增任务（服务是唯一数据源，持久化数据）
-            mMainService.addTask(newTask); // 需在MainService中实现addTask()方法（添加到服务内全量任务列表）
-            LogUtils.d(TAG, "调用MainService新增任务：ID=" + newTask.getTaskId() + "（位置ID=" + mBindPositionId + "）");
-
-            // 3. 重新同步数据（从服务拉取最新列表，避免本地计算错误）
-            syncTasksFromMainService();
-            // 4. 通知外部任务已更新
-            if (mOnTaskUpdatedListener != null) {
-                mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, getCurrentPosTasks());
-            }
-            showToast("新增任务成功（已同步至服务）");
-
-        } catch (Exception e) {
-            LogUtils.d(TAG, "新增任务失败：" + e.getMessage());
-            showToast("新增失败，请重试");
-            // 重新同步数据（修复可能的不一致）
-            syncTasksFromMainService();
-        }
-    }
 }
 

positions/src/main/res/anim/popup_date_time_picker_in.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<set xmlns:android="http://schemas.android.com/apk/res/android"
-    android:duration="300">
-    <translate
-        android:fromYDelta="50%"
-        android:toYDelta="0%"
-        android:interpolator="@android:anim/decelerate_interpolator" />
-    <alpha
-        android:fromAlpha="0.6"
-        android:toAlpha="1.0"
-        android:interpolator="@android:anim/decelerate_interpolator" />
-</set>

positions/src/main/res/anim/popup_date_time_picker_out.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<set xmlns:android="http://schemas.android.com/apk/res/android"
-    android:duration="250">
-    <translate
-        android:fromYDelta="0%"
-        android:toYDelta="50%"
-        android:interpolator="@android:anim/accelerate_interpolator" />
-    <alpha
-        android:fromAlpha="1.0"
-        android:toAlpha="0.6"
-        android:interpolator="@android:anim/accelerate_interpolator" />
-</set>

positions/src/main/res/drawable/bg_dialog_round.xml

@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<shape xmlns:android="http://schemas.android.com/apk/res/android"
-    android:shape="rectangle">
-    <!-- 白色背景 -->
-    <solid android:color="#FFFFFF" />
-    <!-- 圆角（12dp，可根据需求调整） -->
-    <corners android:radius="12dp" />
-    <!-- 轻微阴影（增强层次感） -->
-    <stroke
-        android:width="1dp"
-        android:color="#00000008" /> <!-- 透明黑色阴影，避免生硬 -->
-</shape>
-

positions/src/main/res/drawable/btn_dialog_cancel.xml

@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<shape xmlns:android="http://schemas.android.com/apk/res/android"
-    android:shape="rectangle">
-    <!-- 透明背景 -->
-    <solid android:color="#00000000" />
-    <!-- 灰色边框（与取消按钮文字同色） -->
-    <stroke
-        android:width="1dp"
-        android:color="#FF333333" />
-    <!-- 圆角（与弹窗一致，12dp） -->
-    <corners android:radius="12dp" />
-</shape>
-

positions/src/main/res/drawable/btn_dialog_confirm.xml

@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<shape xmlns:android="http://schemas.android.com/apk/res/android"
-    android:shape="rectangle">
-    <!-- 填充色（示例深灰色，可改为 #FF007AFF 等主题色） -->
-    <solid android:color="#FF333333" />
-    <!-- 圆角（与弹窗一致） -->
-    <corners android:radius="12dp" />
-</shape>
-

positions/src/main/res/layout/dialog_date_time_picker.xml

@@ -1,74 +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="16dp"
-    android:background="@drawable/bg_dialog_round">
-
-    <LinearLayout
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:orientation="horizontal"
-        android:gravity="center">
-
-        <NumberPicker
-            android:id="@+id/picker_year"
-            android:layout_width="0dp"
-            android:layout_height="wrap_content"
-            android:layout_weight="1" />
-
-        <NumberPicker
-            android:id="@+id/picker_month"
-            android:layout_width="0dp"
-            android:layout_height="wrap_content"
-            android:layout_weight="1" />
-
-        <NumberPicker
-            android:id="@+id/picker_day"
-            android:layout_width="0dp"
-            android:layout_height="wrap_content"
-            android:layout_weight="1" />
-
-        <NumberPicker
-            android:id="@+id/picker_hour"
-            android:layout_width="0dp"
-            android:layout_height="wrap_content"
-            android:layout_weight="1" />
-
-        <NumberPicker
-            android:id="@+id/picker_minute"
-            android:layout_width="0dp"
-            android:layout_height="wrap_content"
-            android:layout_weight="1" />
-    </LinearLayout>
-
-    <LinearLayout
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:orientation="horizontal"
-        android:gravity="end"
-        android:layout_marginTop="16dp"
-        android:spacing="12dp">
-
-        <Button
-            android:id="@+id/btn_cancel"
-            android:layout_width="wrap_content"
-            android:layout_height="42dp"
-            android:minWidth="80dp"
-            android:background="@drawable/btn_dialog_cancel"
-            android:text="取消"
-            android:textSize="16sp" />
-
-        <Button
-            android:id="@+id/btn_confirm"
-            android:layout_width="wrap_content"
-            android:layout_height="42dp"
-            android:minWidth="80dp"
-            android:background="@drawable/btn_dialog_confirm"
-            android:text="确认"
-            android:textSize="16sp"
-            android:textColor="@android:color/white" />
-    </LinearLayout>
-</LinearLayout>
-

positions/src/main/res/layout/dialog_edit_task.xml

@@ -1,120 +1,82 @@
 <?xml version="1.0" encoding="utf-8"?>
-<LinearLayout
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-	xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
-	android:layout_width="match_parent"
+    android:layout_height="wrap_content"
-	android:layout_height="wrap_content"
+    android:orientation="vertical"
-	android:orientation="vertical"
+    android:padding="16dp"
-	android:padding="16dp"
+    android:background="@color/white">
-	android:background="@color/white">
 
-	<EditText
+    <EditText
-		android:id="@+id/et_edit_task_desc"
+        android:id="@+id/et_edit_task_desc"
-		android:layout_width="match_parent"
+        android:layout_width="match_parent"
-		android:layout_height="wrap_content"
+        android:layout_height="wrap_content"
-		android:hint="输入任务描述"
+        android:hint="输入任务描述"
-		android:maxLines="1"
+        android:maxLines="1"
-		android:textSize="14sp"/>
+        android:textSize="14sp" />
 
-	<LinearLayout
+    <RadioGroup
-		android:orientation="horizontal"
+        android:id="@+id/rg_distance_condition"
-		android:layout_width="match_parent"
+        android:layout_width="match_parent"
-		android:layout_height="wrap_content"
+        android:layout_height="wrap_content"
-		android:layout_marginTop="12dp"
+        android:orientation="horizontal"
-		android:gravity="center_vertical">
+        android:layout_marginTop="12dp">
 
-		<RadioGroup
+        <RadioButton
-			android:id="@+id/rg_distance_condition"
+            android:id="@+id/rb_greater_than"
-			android:layout_width="wrap_content"
+            android:layout_width="wrap_content"
-			android:layout_height="wrap_content"
+            android:layout_height="wrap_content"
-			android:orientation="horizontal"
+            android:text="大于"
-			android:layout_marginRight="10dp">
+            android:textColor="@color/black"
+            android:textSize="14sp" />
 
-			<RadioButton
+        <RadioButton
-				android:id="@+id/rb_greater_than"
+            android:id="@+id/rb_less_than"
-				android:layout_width="wrap_content"
+            android:layout_width="wrap_content"
-				android:layout_height="wrap_content"
+            android:layout_height="wrap_content"
-				android:text="大于"
+            android:text="小于"
-				android:textColor="@color/black"
+            android:textColor="@color/black"
-				android:textSize="14sp"/>
+            android:textSize="14sp"
+            android:layout_marginLeft="24dp" />
 
-			<RadioButton
+    </RadioGroup>
-				android:id="@+id/rb_less_than"
-				android:layout_width="wrap_content"
-				android:layout_height="wrap_content"
-				android:text="小于"
-				android:textColor="@color/black"
-				android:textSize="14sp"/>
 
-		</RadioGroup>
+    <EditText
+        android:id="@+id/et_edit_distance"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="输入距离（米）"
+        android:inputType="number"
+        android:maxLines="1"
+        android:textSize="14sp"
+        android:layout_marginTop="8dp" />
 
-		<EditText
+    <LinearLayout
-			android:id="@+id/et_edit_distance"
+        android:layout_width="match_parent"
-			android:layout_width="0dp"
+        android:layout_height="wrap_content"
-			android:layout_weight="1.0"
+        android:orientation="horizontal"
-			android:layout_height="wrap_content"
+        android:gravity="end"
-			android:hint="输入距离（米）"
+        android:layout_marginTop="16dp">
-			android:inputType="number"
-			android:maxLines="1"
-			android:textSize="14sp"/>
 
-		<TextView
+        <Button
-			android:layout_width="wrap_content"
+            android:id="@+id/btn_dialog_cancel"
-			android:layout_height="wrap_content"
+            android:layout_width="wrap_content"
-			android:text="米"
+            android:layout_height="40dp"
-			android:layout_marginRight="10dp"/>
+            android:text="取消"
+            android:textColor="@color/black"
+            android:textSize="14sp"
+            android:layout_marginRight="8dp"
+            android:background="@color/gray" />
 
-	</LinearLayout>
+        <Button
+            android:id="@+id/btn_dialog_save"
+            android:layout_width="wrap_content"
+            android:layout_height="40dp"
+            android:text="保存"
+            android:textSize="14sp"
+            android:background="@color/blue"
+            android:textColor="@color/white" />
 
-	<LinearLayout
+    </LinearLayout>
-		android:orientation="horizontal"
-		android:layout_width="match_parent"
-		android:layout_height="wrap_content"
-		android:layout_marginTop="12dp"
-		android:gravity="center_vertical">
-
-		<Button
-			android:layout_width="wrap_content"
-			android:layout_height="wrap_content"
-			android:text="开始时间"
-			android:id="@+id/btn_select_time"/>
-		
-		<TextView
-			android:id="@+id/tv_selected_time"
-			android:layout_width="0dp"
-			android:layout_height="wrap_content"
-			android:text="Text"
-			android:layout_weight="1.0"/>
-
-
-	</LinearLayout>
-
-	<LinearLayout
-		android:layout_width="match_parent"
-		android:layout_height="wrap_content"
-		android:orientation="horizontal"
-		android:gravity="end"
-		android:layout_marginTop="16dp">
-
-		<Button
-			android:id="@+id/btn_dialog_cancel"
-			android:layout_width="wrap_content"
-			android:layout_height="40dp"
-			android:text="取消"
-			android:textColor="@color/black"
-			android:textSize="14sp"
-			android:layout_marginRight="8dp"
-			android:background="@color/gray"/>
-
-		<Button
-			android:id="@+id/btn_dialog_save"
-			android:layout_width="wrap_content"
-			android:layout_height="40dp"
-			android:text="保存"
-			android:textSize="14sp"
-			android:background="@color/blue"
-			android:textColor="@color/white"/>
-
-	</LinearLayout>
 
 </LinearLayout>
 

positions/src/main/res/layout/item_position_task_edit.xml

@@ -92,7 +92,7 @@
         android:padding="8dp"
         android:background="@drawable/edittext_bg"
         android:layout_marginBottom="10dp"/>
-	
+
     <!-- 5. 启用状态（单选组：是/否） -->
     <LinearLayout
         android:layout_width="wrap_content"

positions/src/main/res/layout/item_position_task_simple.xml

@@ -1,77 +1,56 @@
 <?xml version="1.0" encoding="utf-8"?>
-<RelativeLayout
+<!-- 根布局改为 RelativeLayout，支持红点右上角定位（原 LinearLayout 无法便捷实现绝对位置） -->
-	xmlns:android="http://schemas.android.com/apk/res/android"
+<RelativeLayout 
-	android:layout_width="match_parent"
+    xmlns:android="http://schemas.android.com/apk/res/android"
-	android:layout_height="wrap_content"
+    android:layout_width="match_parent"
-	android:orientation="vertical"
+    android:layout_height="wrap_content"
-	android:padding="12dp"
+    android:orientation="vertical"
-	android:background="@drawable/item_bg_simple"
+    android:padding="12dp"
-	android:layout_marginBottom="8dp">
+    android:background="@drawable/item_bg_simple"
+    android:layout_marginBottom="8dp">
 
-	<View
+    <!-- 1. 右上角小红点（仅 isBingo=true 时显示，绑定 isBingo 属性） -->
-		android:id="@+id/v_bingo_dot"
+    <View
-		android:layout_width="12dp"
+        android:id="@+id/v_bingo_dot"
-		android:layout_height="12dp"
+        android:layout_width="12dp"
-		android:layout_alignParentRight="true"
+        android:layout_height="12dp"
-		android:layout_alignParentTop="true"
+        android:layout_alignParentRight="true"
-		android:layout_marginRight="2dp"
+        android:layout_alignParentTop="true"
-		android:layout_marginTop="2dp"
+        android:layout_marginRight="2dp"
-		android:background="@drawable/bg_bingo_dot"
+        android:layout_marginTop="2dp"
-		android:visibility="gone"/>
+        android:background="@drawable/bg_bingo_dot"
+        android:visibility="gone"/>  <!-- 默认隐藏，仅任务触发（isBingo=true）时显示 -->
 
-	<TextView
+    <!-- 2. 任务描述（原控件不变，位置受红点不影响） -->
-		android:id="@+id/tv_simple_task_desc"
+    <TextView
-		android:layout_width="wrap_content"
+        android:id="@+id/tv_simple_task_desc"
-		android:layout_height="wrap_content"
+        android:layout_width="wrap_content"
-		android:textSize="16sp"
+        android:layout_height="wrap_content"
-		android:textColor="#333333"
+        android:textSize="16sp"
-		android:text="任务：无描述"/>
+        android:textColor="#333333"
+        android:text="任务：无描述"/>
 
-	<TextView
+    <!-- 3. 距离条件（原控件不变） -->
-		android:id="@+id/tv_simple_distance_cond"
+    <TextView
-		android:layout_width="wrap_content"
+        android:id="@+id/tv_simple_distance_cond"
-		android:layout_height="wrap_content"
+        android:layout_width="wrap_content"
-		android:textSize="14sp"
+        android:layout_height="wrap_content"
-		android:textColor="#666666"
+        android:textSize="14sp"
-		android:layout_marginTop="6dp"
+        android:textColor="#666666"
-		android:layout_below="@id/tv_simple_task_desc"
+        android:layout_marginTop="6dp"
-		android:text="条件：距离 &gt; 0 米"/>
+        android:layout_below="@id/tv_simple_task_desc"
+        android:text="条件：距离 > 0 米"/>
 
-	<LinearLayout
+    <!-- 4. 启用状态（原控件不变） -->
-		android:orientation="horizontal"
+    <TextView
-		android:layout_marginTop="6dp"
+        android:id="@+id/tv_simple_is_enable"
-		android:layout_width="wrap_content"
+        android:layout_width="wrap_content"
-		android:layout_height="wrap_content"
+        android:layout_height="wrap_content"
-		android:layout_below="@id/tv_simple_distance_cond"
+        android:textSize="14sp"
-		android:id="@+id/ll_starttime"
+        android:textColor="#2E8B57"
-		android:gravity="center_vertical">
+        android:layout_marginTop="4dp"
-
+        android:layout_below="@id/tv_simple_distance_cond"
-		<TextView
+        android:text="状态：已启用"/>
-			android:layout_width="wrap_content"
-			android:layout_height="wrap_content"
-			android:textSize="14sp"
-			android:textColor="#666666"
-			android:text="开始时间："/>
-
-		<TextView
-			android:id="@+id/tv_starttime"
-			android:layout_width="wrap_content"
-			android:layout_height="wrap_content"
-			android:textSize="14sp"
-			android:textColor="#666666"
-			android:text=""/>
-
-	</LinearLayout>
-
-	<TextView
-		android:id="@+id/tv_simple_is_enable"
-		android:layout_width="wrap_content"
-		android:layout_height="wrap_content"
-		android:textSize="14sp"
-		android:textColor="#2E8B57"
-		android:layout_marginTop="4dp"
-		android:layout_below="@id/ll_starttime"
-		android:text="状态：已启用"/>
 
 </RelativeLayout>
 

positions/src/main/res/layout/item_task_content.xml

@@ -1,110 +1,70 @@
 <?xml version="1.0" encoding="utf-8"?>
-<LinearLayout
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
-	xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
-	android:layout_width="match_parent"
+    android:layout_height="wrap_content"
-	android:layout_height="wrap_content"
+    android:orientation="horizontal"
-	android:orientation="horizontal"
+    android:gravity="center_vertical"
-	android:gravity="center_vertical"
+    android:padding="8dp"
-	android:padding="8dp"
+    android:background="@drawable/bg_task_item"
-	android:background="@drawable/bg_task_item"
+    android:layout_marginVertical="4dp">
-	android:layout_marginVertical="4dp">
 
-	<CheckBox
+    <CheckBox
-		android:id="@+id/cb_task_enable"
+        android:id="@+id/cb_task_enable"
-		android:layout_width="wrap_content"
+        android:layout_width="wrap_content"
-		android:layout_height="wrap_content"
+        android:layout_height="wrap_content"
-		android:layout_marginRight="12dp"/>
+        android:layout_marginRight="12dp" />
 
-	<LinearLayout
+    <LinearLayout
-		android:orientation="vertical"
+        android:layout_width="0dp"
-		android:layout_width="0dp"
+        android:layout_height="wrap_content"
-		android:layout_height="wrap_content"
+        android:layout_weight="1"
-		android:layout_weight="1.0">
+        android:orientation="vertical">
 
-		<LinearLayout
+        <TextView
-			android:layout_width="wrap_content"
+            android:id="@+id/tv_task_desc"
-			android:layout_height="wrap_content"
+            android:layout_width="wrap_content"
-			android:orientation="horizontal">
+            android:layout_height="wrap_content"
+            android:text="任务描述"
+            android:textSize="16sp"
+            android:textColor="@color/black" />
 
-			<TextView
+        <TextView
-				android:id="@+id/tv_task_desc"
+            android:id="@+id/tv_task_distance"
-				android:layout_width="wrap_content"
+            android:layout_width="wrap_content"
-				android:layout_height="wrap_content"
+            android:layout_height="wrap_content"
-				android:text="任务描述"
+            android:text="条件：大于 100 米"
-				android:textSize="16sp"
+            android:textSize="12sp"
-				android:textColor="@color/black"/>
+            android:textColor="@color/gray_dark"
+            android:layout_marginTop="2dp" />
 
-		</LinearLayout>
+    </LinearLayout>
 
-		<LinearLayout
+    <LinearLayout
-			android:layout_width="wrap_content"
+        android:layout_width="wrap_content"
-			android:layout_height="wrap_content"
+        android:layout_height="wrap_content"
-			android:orientation="horizontal">
+        android:orientation="horizontal"
+        android:layout_marginLeft="8dp">
 
-			<TextView
+        <Button
-				android:id="@+id/tv_task_distance"
+            android:id="@+id/btn_edit_task"
-				android:layout_width="wrap_content"
+            android:layout_width="wrap_content"
-				android:layout_height="wrap_content"
+            android:layout_height="30dp"
-				android:text="条件：大于 100 米"
+            android:text="修改"
-				android:textSize="12sp"
+            android:textSize="12sp"
-				android:textColor="@color/gray_dark"
+            android:layout_marginRight="4dp"
-				android:layout_marginTop="2dp"/>
+            android:background="@color/blue"
+            android:textColor="@color/white" />
 
-		</LinearLayout>
+        <Button
+            android:id="@+id/btn_delete_task"
+            android:layout_width="wrap_content"
+            android:layout_height="30dp"
+            android:text="删除"
+            android:textSize="12sp"
+            android:background="@color/red"
+            android:textColor="@color/white" />
 
-		<LinearLayout
+    </LinearLayout>
-			android:orientation="horizontal"
-			android:layout_width="wrap_content"
-			android:layout_height="wrap_content"
-			android:layout_below="@id/tv_simple_distance_cond"
-			android:id="@+id/ll_starttime"
-			android:gravity="center_vertical">
-
-			<TextView
-				android:layout_width="wrap_content"
-				android:layout_height="wrap_content"
-				android:textSize="12sp"
-				android:textColor="#666666"
-				android:text="开始时间："/>
-
-			<TextView
-				android:id="@+id/tv_starttime"
-				android:layout_width="wrap_content"
-				android:layout_height="wrap_content"
-				android:textSize="12sp"
-				android:textColor="#666666"
-				android:text=""/>
-
-		</LinearLayout>
-
-		<LinearLayout
-			android:layout_width="wrap_content"
-			android:layout_height="wrap_content"
-			android:orientation="horizontal"
-			android:layout_gravity="center">
-
-			<Button
-				android:id="@+id/btn_edit_task"
-				android:layout_width="wrap_content"
-				android:layout_height="30dp"
-				android:text="修改"
-				android:textSize="12sp"
-				android:layout_marginRight="4dp"
-				android:background="@color/blue"
-				android:textColor="@color/white"/>
-
-			<Button
-				android:id="@+id/btn_delete_task"
-				android:layout_width="wrap_content"
-				android:layout_height="30dp"
-				android:text="删除"
-				android:textSize="12sp"
-				android:background="@color/red"
-				android:textColor="@color/white"/>
-
-		</LinearLayout>
-
-	</LinearLayout>
 
 </LinearLayout>
 

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

@@ -1,4 +1,4 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="app_name">悟空笔记</string>
+    <string name="app_name">寻龙记</string>
 </resources>

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

@@ -29,11 +29,5 @@
 	<!-- 扩展颜色（避免后续新增功能时再次缺失） -->
 	<color name="green">#4CAF50</color> <!-- 绿色（备用：如“启用”状态标识） -->
 	<color name="yellow">#FFC107</color> <!-- 黄色（备用：如“提醒”标识） -->
-    <color name="color_text_primary">#333333</color>
+
-    <color name="color_gray">#999999</color>
-    <color name="color_gray_light">#F5F5F5</color>
-    <color name="color_shadow">#1A000000</color>
-    <color name="color_primary">#2196F3</color> <!-- 主题蓝 -->
-    <color name="color_primary_dark">#1976D2</color> <!-- 主题蓝加深 -->
-	
 </resources>

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

@@ -8,10 +8,4 @@
         <item name="colorAccent">@color/colorAccent</item>
     </style>
 
-	<style name="PopupDateTimePickerAnim" parent="android:Animation">
-		<item name="android:windowEnterAnimation">@anim/popup_date_time_picker_in</item>
-		<item name="android:windowExitAnimation">@anim/popup_date_time_picker_out</item>
-	</style>
-
-
 </resources>