commit 47ace290e5cea965516ccf2b6cc9bd79f0c09fa3
Author: ZhanGSKen <zhangsken@qq.com>
Date:   Wed May 13 15:54:02 2026 +0800

    拷贝https://gitea.winboll.cc/Studio/WinBoLL_Bck20260513_154646_588.git项目提交点为9d90b35fc20c7190472db1fdaa9e1417067856c0的源码

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..3be31ff
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,101 @@
+# Built application files
+*.apk
+*.aar
+*.ap_
+*.aab
+
+# Files for the ART/Dalvik VM
+*.dex
+
+# Java class files
+*.class
+
+# Generated files
+bin/
+gen/
+out/
+#  Uncomment the following line in case you need and you don't have the release build type files in your app
+# release/
+
+# Gradle files
+.gradle/
+build/
+
+# Local configuration file (sdk path, etc)
+local.properties
+
+# Proguard folder generated by Eclipse
+proguard/
+
+# Log Files
+*.log
+
+# Android Studio Navigation editor temp files
+.navigation/
+
+# Android Studio captures folder
+captures/
+
+# IntelliJ
+*.iml
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/gradle.xml
+.idea/assetWizardSettings.xml
+.idea/dictionaries
+.idea/libraries
+# Android Studio 3 in .gitignore file.
+.idea/caches
+.idea/modules.xml
+# Comment next line if keeping position of elements in Navigation Editor is relevant for you
+.idea/navEditor.xml
+
+# Keystore files
+# Uncomment the following lines if you do not want to check your keystore files in.
+*.jks
+*.keystore
+
+# External native build folder generated in Android Studio 2.2 and later
+.externalNativeBuild
+.cxx/
+
+# Google Services (e.g. APIs or Firebase)
+# google-services.json
+
+# Freeline
+freeline.py
+freeline/
+freeline_project_description.json
+
+# fastlane
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots
+fastlane/test_output
+fastlane/readme.md
+
+# Version control
+vcs.xml
+
+# lint
+lint/intermediates/
+lint/generated/
+lint/outputs/
+lint/tmp/
+# lint/reports/
+
+# Android Profiling
+*.hprof
+
+# 忽略 Lint 输出文件
+lint-results.xml
+lint-results.html
+
+## 忽略 AndroidIDE 临时文件夹
+.androidide
+
+## WinBoLL 基础应用(避免上传敏感配置)
+/winboll.properties
+/local.properties
+/settings.gradle
+/gradle.properties
\ No newline at end of file
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..c97416e
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "libjc/jcc/libs"]
+	path = libjc/jcc/libs
+	url = https://gitea.winboll.cc/Studio/APP_libjc_jcc_libs.git
diff --git a/.winboll/Readme.txt b/.winboll/Readme.txt
new file mode 100644
index 0000000..f618520
--- /dev/null
+++ b/.winboll/Readme.txt
@@ -0,0 +1,18 @@
+## WinBoLL 主机编译事项提醒
+
+## 类库类型源码发布
+# 类库发布使用以下面命令
+git pull && bash .winboll/bashPublishLIBAddTag.sh <类库模块文件夹名称>
+
+## 纯应用类型源码发布
+# 应用发布使用以下命令
+git pull && bash .winboll/bashPublishAPKAddTag.sh <应用模块文件夹名称>
+
+## 编译时提问。Add Github Workflows Tag? (yes/No)
+回答yes: 将会添加一个 GitHub 工作流标签
+        GitHub 仓库会执行以该标签为标志的编译工作流。
+回答No(默认): 就忽略 GitHub 标签，忽略 GitHub 工作流调用。
+
+## Github Workflows 工作流设置注意事项
+应用名称改变时需要修改.github/workflows/android.yml文件设置，
+在第79行：asset_name: 处有应用包名称设置。
diff --git a/.winboll/bashCheckGitCommitStatus.sh b/.winboll/bashCheckGitCommitStatus.sh
new file mode 100644
index 0000000..1adb83c
--- /dev/null
+++ b/.winboll/bashCheckGitCommitStatus.sh
@@ -0,0 +1,32 @@
+#!/usr/bin/bash
+
+# 使用 `-z` 命令检查变量是否为空
+if [ -z "$1" ] || [ -z "$2" ]; then
+    echo "Script parameter error: $0"
+    exit 2
+fi
+
+# 进入项目根目录
+cd ${1}
+echo -e "Work dir : \n"`pwd`
+
+git config --global --add safe.directory "${1}"
+echo "Current dir : "`pwd`
+versionName=${2}
+
+## 设置要检查的标签
+tag="v"${versionName}
+
+## 如果Git已经提交了所有代码就执行标签检查操作
+if [[ -n $(git diff --stat)  ]]
+then
+  echo 'Source is no commit git completely, tag action cancel.'
+  exit 1
+else
+  echo "Git status is clean."
+  if [ "$(git tag -l ${tag})" == "${tag}" ]; then
+      echo "Tag ${tag} exist."
+      exit 2
+  fi
+  echo "${0}: Git tag is checked OK: (${tag})"
+fi
diff --git a/.winboll/bashCommitAppPublishBuildFlagInfo.sh b/.winboll/bashCommitAppPublishBuildFlagInfo.sh
new file mode 100644
index 0000000..791e58c
--- /dev/null
+++ b/.winboll/bashCommitAppPublishBuildFlagInfo.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/bash
+## 提交新的 APK 编译配置标志信息，并推送到Git仓库。
+
+# 使用 `-z` 命令检查变量是否为空
+if [ -z "$1" ] || [ -z "$2" ] || [ -z "$3" ] || [ -z "$4" ]; then
+    echo "$0 Script parameter error."
+    echo "(Script Demo : [ bashCommitAppPublishBuildFlagInfo.sh <RootProjectDir> <VersionName> <BuildType Name> <RootProject Name> ])"
+    exit 2
+fi
+
+# 进入项目根目录
+cd ${1}
+echo -e "Work dir : \n"`pwd`
+
+git add .
+git commit -m "<$4>APK ${2} ${3} Publish."
+git push origin && git push origin --tags
diff --git a/.winboll/bashCommitLibReleaseBuildFlagInfo.sh b/.winboll/bashCommitLibReleaseBuildFlagInfo.sh
new file mode 100644
index 0000000..d92f320
--- /dev/null
+++ b/.winboll/bashCommitLibReleaseBuildFlagInfo.sh
@@ -0,0 +1,48 @@
+#!/usr/bin/bash
+## 提交新的 Library 编译配置标志信息，并推送到Git仓库。
+
+# 检查是否指定了将要发布的类库名称
+# 使用 `-z` 命令检查变量是否为空
+if [ -z "$1" ]; then
+    echo "Library name error: $0"
+    exit 2
+fi
+
+## 开始执行脚本
+echo -e "Current dir : \n"`pwd`
+# 检查当前目录是否是项目根目录
+if [[ -e $1/build.properties ]]; then
+    echo "The $1/build.properties file exists."
+    echo -e "Work dir correctly."
+else
+    echo "The $1/build.properties file does not exist."
+    echo "尝试进入根目录"
+    # 进入项目根目录
+    cd ..
+fi
+## 本脚本需要在项目根目录下执行
+echo -e "Current dir : \n"`pwd`
+# 检查当前目录是否是项目根目录
+if [[ -e $1/build.properties ]]; then
+    echo "The $1/build.properties file exists."
+    echo -e "Work dir correctly."
+else
+    echo "The $1/build.properties file does not exist."
+    echo -e "Work dir error."
+    exit 1
+fi
+
+# 就读取脚本 .winboll/winboll_app_build.gradle 生成的 publishVersion。
+# 如果文件中有 publishVersion 这一项，
+# 使用grep找到包含"publishVersion="的那一行，然后用awk提取其后的值
+PUBLISH_VERSION=$(grep -o "publishVersion=.*" $1/build.properties | awk -F '=' '{print $2}')
+echo "< $1/build.properties publishVersion : ${PUBLISH_VERSION} >"
+## 设新的 WinBoLL 标签
+# 脚本调试时使用
+#tag="v7.6.4-test1"
+# 正式设置标签时使用
+#tag="v"${PUBLISH_VERSION}
+
+git add .
+git commit -m "<$1>Library Release ${PUBLISH_VERSION}"
+git push origin && git push origin --tags
diff --git a/.winboll/bashPublishAPKAddTag.sh b/.winboll/bashPublishAPKAddTag.sh
new file mode 100644
index 0000000..082dc7e
--- /dev/null
+++ b/.winboll/bashPublishAPKAddTag.sh
@@ -0,0 +1,223 @@
+#!/usr/bin/bash
+# ==============================================================================
+# WinBoLL 应用发布脚本
+# 功能：检查Git源码状态 → 编译Stage Release包 → 添加WinBoLL标签 → 提交并推送源码
+# 依赖：build.properties、app_update_description.txt（项目根目录下）
+# 使用：./script_name.sh <APP_NAME>
+# 作者：豆包&ZhanGSKen<zhangsken@qq.com>
+# ==============================================================================
+
+# ==================== 常量定义 ====================
+# 脚本退出码
+EXIT_CODE_SUCCESS=0
+EXIT_CODE_ERR_NO_APP_NAME=2
+EXIT_CODE_ERR_WORK_DIR=1
+EXIT_CODE_ERR_GIT_CHECK=1
+EXIT_CODE_ERR_ADD_WINBOLL_TAG=1
+
+# Gradle 任务（正式发布）
+GRADLE_TASK_PUBLISH="assembleStageRelease"
+# Gradle 任务（调试用，注释备用）
+# GRADLE_TASK_DEBUG="assembleBetaDebug"
+
+# ==================== 函数定义 ====================
+# 检查Git源码是否已完全提交（无未提交变更）
+# 返回值：0=已完全提交，1=存在未提交变更
+function checkGitSources() {
+    # 配置Git安全目录（解决权限问题）
+    git config --global --add safe.directory "$(pwd)"
+    
+    # 检查是否有未提交的变更
+    if [[ -n $(git diff --stat) ]]; then
+        echo "[ERROR] Git源码存在未提交变更，请先提交所有修改！"
+        return 1
+    fi
+    
+    echo "[INFO] Git源码检查通过：所有变更已提交。"
+    return 0
+}
+
+# 询问是否添加GitHub Workflows标签（当前逻辑注释，保留扩展能力）
+# 返回值：1=用户选择是，0=用户选择否
+function askAddWorkflowsTag() {
+    read -p "是否添加GitHub Workflows标签？(Y/n) " answer
+    if [[ $answer =~ ^[Yy]$ ]]; then
+        return 1
+    else
+        return 0
+    fi
+}
+
+# 添加WinBoLL正式标签
+# 参数：$1=应用名称（项目根目录名）
+# 返回值：0=标签添加成功，1=标签已存在/添加失败
+function addWinBoLLTag() {
+    local app_name=$1
+    local build_prop_path="${app_name}/build.properties"
+    
+    # 从build.properties中提取publishVersion
+    local publish_version=$(grep -o "publishVersion=.*" "${build_prop_path}" | awk -F '=' '{print $2}')
+    if [[ -z ${publish_version} ]]; then
+        echo "[ERROR] 未从${build_prop_path}中提取到publishVersion配置！"
+        return 1
+    fi
+    echo "[INFO] 从${build_prop_path}读取到publishVersion：${publish_version}"
+    
+    # 构造WinBoLL标签（格式：<APP_NAME>-v<publishVersion>）
+    local tag="${app_name}-v${publish_version}"
+    echo "[INFO] 准备添加WinBoLL标签：${tag}"
+    
+    # 检查标签是否已存在
+    if [[ "$(git tag -l ${tag})" == "${tag}" ]]; then
+        echo "[ERROR] WinBoLL标签${tag}已存在！"
+        return 1
+    fi
+    
+    # 添加带注释的标签（注释来自app_update_description.txt）
+    git tag -a "${tag}" -F "${app_name}/app_update_description.txt"
+    echo "[INFO] WinBoLL标签${tag}添加成功！"
+    return 0
+}
+
+# 添加GitHub Workflows Beta标签（当前逻辑注释，保留扩展能力）
+# 参数：$1=应用名称（项目根目录名）
+# 返回值：0=标签添加成功，1=标签已存在/添加失败
+function addWorkflowsTag() {
+    local app_name=$1
+    local build_prop_path="${app_name}/build.properties"
+    
+    # 从build.properties中提取baseBetaVersion
+    local base_beta_version=$(grep -o "baseBetaVersion=.*" "${build_prop_path}" | awk -F '=' '{print $2}')
+    if [[ -z ${base_beta_version} ]]; then
+        echo "[ERROR] 未从${build_prop_path}中提取到baseBetaVersion配置！"
+        return 1
+    fi
+    echo "[INFO] 从${build_prop_path}读取到baseBetaVersion：${base_beta_version}"
+    
+    # 构造Workflows标签（格式：<APP_NAME>-v<baseBetaVersion>-beta）
+    local tag="${app_name}-v${base_beta_version}-beta"
+    echo "[INFO] 准备添加Workflows标签：${tag}"
+    
+    # 检查标签是否已存在
+    if [[ "$(git tag -l ${tag})" == "${tag}" ]]; then
+        echo "[ERROR] Workflows标签${tag}已存在！"
+        return 1
+    fi
+    
+    # 添加带注释的标签（注释来自app_update_description.txt）
+    git tag -a "${tag}" -F "${app_name}/app_update_description.txt"
+    echo "[INFO] Workflows标签${tag}添加成功！"
+    return 0
+}
+
+# ==================== 主流程开始 ====================
+echo "============================================="
+echo "          WinBoLL 应用发布脚本"
+echo "============================================="
+
+# 1. 检查应用名称参数是否指定
+if [ -z "$1" ]; then
+    echo "[ERROR] 未指定应用名称！使用方式：${0} <APP_NAME>"
+    exit ${EXIT_CODE_ERR_NO_APP_NAME}
+fi
+APP_NAME=$1
+echo "[INFO] 待发布应用名称：${APP_NAME}"
+
+# 2. 检查并切换到项目根目录（确保build.properties存在）
+echo "[INFO] 当前工作目录：$(pwd)"
+if [[ ! -e "${APP_NAME}/build.properties" ]]; then
+    echo "[WARNING] 当前目录不存在${APP_NAME}/build.properties，尝试切换到上级目录..."
+    cd ..
+    echo "[INFO] 切换后工作目录：$(pwd)"
+fi
+
+# 验证最终工作目录是否正确
+if [[ ! -e "${APP_NAME}/build.properties" ]]; then
+    echo "[ERROR] 工作目录错误！${APP_NAME}/build.properties 文件不存在。"
+    exit ${EXIT_CODE_ERR_WORK_DIR}
+fi
+echo "[INFO] 工作目录验证通过：${APP_NAME}/build.properties 存在。"
+
+# 3. 检查Git源码状态
+echo "---------------------------------------------"
+echo "          步骤1：检查Git源码状态"
+echo "---------------------------------------------"
+checkGitSources
+if [[ $? -ne ${EXIT_CODE_SUCCESS} ]]; then
+    echo "[ERROR] Git源码检查失败，脚本终止！"
+    exit ${EXIT_CODE_ERR_GIT_CHECK}
+fi
+
+# 4. 编译Stage Release版本APK
+echo "---------------------------------------------"
+echo "          步骤2：编译Stage Release APK"
+echo "---------------------------------------------"
+echo "[INFO] 开始执行Gradle任务：${GRADLE_TASK_PUBLISH}"
+# 调试用（注释正式任务，启用调试任务）
+# bash gradlew :${APP_NAME}:${GRADLE_TASK_DEBUG}
+bash gradlew :${APP_NAME}:${GRADLE_TASK_PUBLISH}
+
+if [[ $? -ne ${EXIT_CODE_SUCCESS} ]]; then
+    echo "[ERROR] Gradle编译任务失败！"
+    exit 1
+fi
+echo "[INFO] Stage Release APK编译成功！"
+
+# 5. 添加WinBoLL正式标签
+echo "---------------------------------------------"
+echo "          步骤3：添加WinBoLL标签"
+echo "---------------------------------------------"
+addWinBoLLTag ${APP_NAME}
+if [[ $? -ne ${EXIT_CODE_SUCCESS} ]]; then
+    echo "[ERROR] WinBoLL标签添加失败，脚本终止！"
+    exit ${EXIT_CODE_ERR_ADD_WINBOLL_TAG}
+fi
+
+# 6. （可选）添加GitHub Workflows标签（当前逻辑注释，保留扩展能力）
+# echo "---------------------------------------------"
+# echo "          步骤4：添加Workflows标签（可选）"
+# echo "---------------------------------------------"
+# echo "是否添加GitHub Workflows Beta标签？(Y/n) "
+# askAddWorkflowsTag
+# nAskAddWorkflowsTag=$?
+# if [[ ${nAskAddWorkflowsTag} -eq 1 ]]; then
+#     addWorkflowsTag ${APP_NAME}
+#     if [[ $? -ne ${EXIT_CODE_SUCCESS} ]]; then
+#         echo "[ERROR] Workflows标签添加失败，脚本终止！"
+#         exit 1
+#     fi
+# fi
+
+# 7. 清理更新描述文件
+echo "---------------------------------------------"
+echo "          步骤5：清理更新描述文件"
+echo "---------------------------------------------"
+echo "" > "${APP_NAME}/app_update_description.txt"
+echo "[INFO] 已清空${APP_NAME}/app_update_description.txt"
+
+# 8. 提交并推送源码与标签
+echo "---------------------------------------------"
+echo "          步骤6：提交并推送源码"
+echo "---------------------------------------------"
+git add .
+git commit -m "<${APP_NAME}> 开始新的Stage版本开发。"
+echo "[INFO] 源码提交成功，开始推送..."
+
+# 推送源码到远程仓库
+git push origin
+# 推送标签到远程仓库
+git push origin --tags
+
+if [[ $? -eq ${EXIT_CODE_SUCCESS} ]]; then
+    echo "[INFO] 源码与标签推送成功！"
+else
+    echo "[ERROR] 源码与标签推送失败！"
+    exit 1
+fi
+
+# ==================== 主流程结束 ====================
+echo "============================================="
+echo "          WinBoLL 应用发布完成！"
+echo "============================================="
+exit ${EXIT_CODE_SUCCESS}
+
diff --git a/.winboll/bashPublishDebugAPKAddTag.sh b/.winboll/bashPublishDebugAPKAddTag.sh
new file mode 100644
index 0000000..0deb526
--- /dev/null
+++ b/.winboll/bashPublishDebugAPKAddTag.sh
@@ -0,0 +1,166 @@
+#!/usr/bin/bash
+
+# 检查是否指定了将要发布的调试版应用名称
+# 使用 `-z` 命令检查变量是否为空
+if [ -z "$1" ]; then
+    echo "No APP name specified : $0"
+    exit 2
+fi
+
+## 定义相关函数
+## 检查 Git 源码是否完全提交了，完全提交就返回0
+function checkGitSources {
+    #local input="$1"
+    #echo "The string is: $input"
+    git config --global --add safe.directory `pwd`
+    if [[ -n $(git diff --stat)  ]]
+    then
+        local result="Source is no commit completely."
+        echo $result
+        # 脚本调试时使用
+        #return 0
+        # 正式检查源码时使用
+        return 1
+    fi
+    local result="Git Source Check OK."
+    echo $result
+    return 0
+}
+
+function askAddWorkflowsTag {
+    read answer
+    if [[ $answer =~ ^[Yy]$ ]]; then
+        #echo "You chose yes."
+        return 1
+    else
+        #echo "You chose no."
+        return 0
+    fi
+}
+
+function addWinBoLLTag {
+    # 就读取脚本 .winboll/winboll_app_build.gradle 生成的 publishVersion。
+    # 如果文件中有 publishVersion 这一项，
+    # 使用grep找到包含"publishVersion="的那一行，然后用awk提取其后的值
+    PUBLISH_VERSION=$(grep -o "publishVersion=.*" $1/build.properties | awk -F '=' '{print $2}')
+    echo "< $1/build.properties publishVersion : ${PUBLISH_VERSION} >"
+    ## 设新的 WinBoLL 标签
+    # 脚本调试时使用
+    #tag="v7.6.4-test1"
+    # 正式调试版设置标签时使用
+    tag=$1"-v"${PUBLISH_VERSION}"-debug"
+    echo "< WinBoLL Tag To: $tag >";
+    # 检查是否已经添加了 WinBoLL Tag
+    if [ "$(git tag -l ${tag})" == "${tag}" ]; then
+        echo -e "< WinBoLL Tag ${tag} exist! >"
+        return 1 # WinBoLL标签重复
+    fi
+    # 添加WinBoLL标签
+    git tag -a ${tag} -F $1/app_update_description.txt
+    return 0
+}
+
+function addWorkflowsTag {
+    # 就读取脚本 .winboll/winboll_app_build.gradle 生成的 baseBetaVersion。
+    # 如果文件中有 baseBetaVersion 这一项，
+    # 使用grep找到包含"baseBetaVersion="的那一行，然后用awk提取其后的值
+    BASE_BETA_VERSION=$(grep -o "baseBetaVersion=.*" $1/build.properties | awk -F '=' '{print $2}')
+    echo "< $1/build.properties baseBetaVersion : ${BASE_BETA_VERSION} >"
+    ## 设新的 workflows 标签
+    # 脚本调试时使用
+    #tag="v7.6.4-beta"
+    # 正式设置标签时使用
+    tag=$1"-"v"${BASE_BETA_VERSION}-beta-debug
+    echo "< Workflows Tag To: $tag >";
+    # 检查是否已经添加了工作流 Tag
+    if [ "$(git tag -l ${tag})" == "${tag}" ]; then
+        echo -e "< Github Workflows Tag ${tag} exist! >"
+        return 1 # 工作流标签重复
+    fi
+    # 添加工作流标签
+    git tag -a ${tag} -F $1/app_update_description.txt
+    return 0
+}
+
+## 开始执行脚本
+echo -e "Current dir : \n"`pwd`
+# 检查当前目录是否是项目根目录
+if [[ -e $1/build.properties ]]; then
+    echo "The $1/build.properties file exists."
+    echo -e "Work dir correctly."
+else
+    echo "The $1/build.properties file does not exist."
+    echo "尝试进入根目录"
+    # 进入项目根目录
+    cd ..
+fi
+## 本脚本需要在项目根目录下执行
+echo -e "Current dir : \n"`pwd`
+# 检查当前目录是否是项目根目录
+if [[ -e $1/build.properties ]]; then
+    echo "The $1/build.properties file exists."
+    echo -e "Work dir correctly."
+else
+    echo "The $1/build.properties file does not exist."
+    echo -e "Work dir error."
+    exit 1
+fi
+
+# 检查源码状态
+result=$(checkGitSources)
+if [[ $? -eq 0 ]]; then
+    echo $result
+    # 如果Git已经提交了所有代码就执行标签和应用发布操作
+
+    # 预先询问是否添加工作流标签
+    echo "Add Github Workflows Tag? (yes/no)"
+    result=$(askAddWorkflowsTag)
+    nAskAddWorkflowsTag=$?
+    echo $result
+
+    # 发布应用
+    echo "Publishing WinBoLL Debug APK ..."
+    # 脚本调试时使用
+    #bash gradlew :$1:assembleBetaDebug
+    # 正式发布调试版
+    bash gradlew :$1:assembleStageDebug
+    echo "Publishing WinBoLL Debug APK OK."
+    
+    # 添加 WinBoLL 标签
+    result=$(addWinBoLLTag $1)
+    echo $result
+    if [[ $? -eq 0 ]]; then
+        echo $result
+        # WinBoLL 标签添加成功
+    else
+        echo -e "${0}: addWinBoLLTag $1\n${result}\nAdd WinBoLL tag cancel."
+        exit 1 # addWinBoLLTag 异常
+    fi
+    
+    # 添加 GitHub 工作流标签
+    if [[ $nAskAddWorkflowsTag -eq 1 ]]; then
+        # 如果用户选择添加工作流标签
+        result=$(addWorkflowsTag $1)
+        if [[ $? -eq 0 ]]; then
+            echo $result
+            # 工作流标签添加成功
+        else
+            echo -e "${0}: addWorkflowsTag $1\n${result}\nAdd workflows tag cancel."
+            exit 1 # addWorkflowsTag 异常
+        fi
+    fi
+    
+    ## 清理更新描述文件内容
+    echo "" > $1/app_update_description.txt
+    
+    # 设置新版本开发参数配置
+    # 提交配置
+    git add .
+    git commit -m "<$1>Start New Stage Debug Version."
+    echo "Push sources to git repositories ..."
+    # 推送源码到所有仓库
+    git push origin && git push origin --tags
+else
+    echo -e "${0}: checkGitSources\n${result}\nShell cancel."
+    exit 1 # checkGitSources 异常
+fi
diff --git a/.winboll/bashPublishLIBAddTag.sh b/.winboll/bashPublishLIBAddTag.sh
new file mode 100644
index 0000000..7ab6a3a
--- /dev/null
+++ b/.winboll/bashPublishLIBAddTag.sh
@@ -0,0 +1,14 @@
+#!/usr/bin/bash
+
+# 检查是否指定了将要发布的类库名称
+# 使用 `-z` 命令检查变量是否为空
+if [ -z "$1" ]; then
+    echo "No Library name specified : $0"
+    exit 2
+fi
+
+## 正式发布使用
+git pull && bash gradlew :$1:publishReleasePublicationToWinBoLLReleaseRepository && bash .winboll/bashCommitLibReleaseBuildFlagInfo.sh $1
+
+## 调试使用
+#bash gradlew :$1:publishSnapshotWinBoLLPublicationToWinBoLLSnapshotRepository && bash .winboll/bashCommitLibReleaseBuildFlagInfo.sh $1
diff --git a/.winboll/winboll_app_build.gradle b/.winboll/winboll_app_build.gradle
new file mode 100644
index 0000000..57b6ba7
--- /dev/null
+++ b/.winboll/winboll_app_build.gradle
@@ -0,0 +1,342 @@
+// WinBoLL 应用签名配置
+//
+
+android {
+	def winbollProps = new Properties()
+    def winbollPropsFile = rootProject.file("${winbollFilePath}")
+    if(winbollPropsFile.exists()) {
+        winbollProps.load(new FileInputStream(winbollPropsFile))
+	}
+    
+    // 读取秘钥配置文件
+    //
+    def keyProps = new Properties()
+    def keyPropsFile = rootProject.file("${keyPropsFilePath}")
+    //println 'Test keystore path'
+    //println 'KeyProsFile :' + Boolean.toString(keyPropsFile.exists())
+    //assert(false)
+    if(keyPropsFile.exists()) {
+		keyProps.load(new FileInputStream(keyPropsFile))
+	}
+    
+    // 配置签名
+    signingConfigs {
+		if(keyPropsFile.exists()) {
+            winboll {
+                assert(keyProps['keyAlias'] != null && keyProps['keyPassword'] != null && keyProps['storeFile'] != null && keyProps['storePassword'] != null)
+                keyAlias keyProps['keyAlias']
+                keyPassword keyProps['keyPassword']
+                storeFile keyProps['storeFile'] ? file(keyProps['storeFile']) : null
+                storePassword keyProps['storePassword']
+            }
+		}
+    }
+    buildTypes {
+        debug {
+			if(keyPropsFile.exists()) {
+			    signingConfig signingConfigs.winboll
+		    }
+         }
+        release {
+			if(keyPropsFile.exists()) {
+			    signingConfig signingConfigs.winboll
+			}
+			
+            minifyEnabled true // 开启混淆（核心开关）
+            shrinkResources true // 可选：移除无用资源（进一步减小体积）
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), // 官方默认规则（优化版）
+                          'proguard-rules.pro' // 自定义规则文件
+         }
+		 
+    }
+    
+    flavorDimensions "WinBoLLApp"
+    productFlavors {
+        beta {
+            // 检查编译标志位配置
+            assert (winbollBuildProps['buildCount'] != null)
+            dimension "WinBoLLApp"
+            applicationIdSuffix ".beta"
+            LocalDateTime localDateTimeNow = LocalDateTime.now(ZoneId.of("Asia/Shanghai"));
+            versionNameSuffix "-beta" + winbollBuildProps['buildCount'] + "_" + localDateTimeNow.format('mmss')
+        }
+        stage {
+            dimension "WinBoLLApp"
+        }
+    }
+	
+	compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+
+    // 应用包输出配置
+    //
+    android.applicationVariants.all { variant ->
+        //
+        // GitHub 应用包输出配置
+        // 1. 配置 Beta Release 版应用包输出
+        // 注意 ：GitHub 打包使用 android.yml 的 "bash ./gradlew assembleBetaRelease" 命令
+        //
+        if(variant.flavorName == "beta" && variant.buildType.name == "release") {
+            /* 后期管理预留代码 */
+            /* 暂时没有需要的 GitHub 应用包输出配置 */
+            /* GitHub 部分代码忽略 */
+        }
+        
+        //
+        // WinBoLL 应用包输出配置
+        // 1. 配置 Stage Release 版应用包输出
+        // 2. 配置 Beta Debug 版应用包输出
+	    //
+        if((variant.flavorName == "beta" && variant.buildType.name == "debug")
+        || (variant.flavorName == "beta" && variant.buildType.name == "release")
+        || (variant.flavorName == "stage" && variant.buildType.name == "debug")
+        || (variant.flavorName == "stage" && variant.buildType.name == "release")) {
+            println "Project root directory: " + project.rootDir.toString()
+            println "Project root directory name : " + project.rootDir.name
+            def outputPath="${project.projectDir.absolutePath}/build/outputs/apk/${variant.buildType.name}"
+            //def outputFileName="${rootProject.name}_${versionName}.apk"
+            def outputFileName=project.rootDir.name + "_${versionName}.apk"
+            
+            // 创建 WinBoLL Studio 发布接口文件夹
+            File fWinBoLLStudioDir = file("/sdcard/WinBoLLStudio/APKs");
+			// 如果配置了APK接口文件夹路径，就设置应用APK输出文件夹为接口文件夹。
+			if(winbollProps != null && winbollProps['APKOutputPath'] != null ) {
+                fWinBoLLStudioDir = file(winbollProps['APKOutputPath']);
+			}
+			
+            if(!fWinBoLLStudioDir.exists()) {
+                println "[ WinBoLLStudio ] : " + fWinBoLLStudioDir.getAbsolutePath() + " Folder does not exist."
+                println '[ WinBoLLStudio ] : The APKOutputPath property is not defined in winboll.properties, please configure APK output folder first.'
+			} else {
+                /// WINBOLL 主机的 APK 发布和源码管理操作 ///
+                variant.getAssembleProvider().get().doFirst {
+                    /* 后期管理预留代码 */
+                } //doFirst {
+                
+                // 编译输出后处理文件部分
+                //
+                variant.getAssembleProvider().get().doLast {
+                        variant.outputs.forEach{ file->
+                            // 如果正在调试，就拷贝到 WinBoLL 备份管理文件夹
+                            // 
+                            if(variant.flavorName == "beta"&&variant.buildType.name == "debug"){
+                                //File outBuildBckDir = new File(fWinBoLLStudioDir, "/${rootProject.name}/${variant.buildType.name}")
+                                File outBuildBckDir = new File(fWinBoLLStudioDir, "/" + project.rootDir.name + "/${variant.buildType.name}")
+                                // 创建目标路径目录
+                                if(!outBuildBckDir.exists()) {
+                                    outBuildBckDir.mkdirs();
+                                    println "Output Folder Created.(WinBoLLStudio) : " + outBuildBckDir.getAbsolutePath()
+                                }
+                                if(outBuildBckDir.exists()) {
+                                    copy{
+                                        from file.outputFile
+                                        into outBuildBckDir
+                                        rename {
+                                            String fileName -> "${outputFileName}"
+                                        }
+                                        println "Output APK (WinBoLLStudio): " + outBuildBckDir.getAbsolutePath() + "/${outputFileName}"
+                                    }
+                                    // 检查编译标志位配置
+                                    assert (winbollBuildProps['buildCount'] != null)
+                                    assert (winbollBuildProps['libraryProject'] != null)
+                                    //构建计数增加
+                                    int buildCount = Integer.parseInt(winbollBuildProps['buildCount']) + 1;
+                                    // 设置编译计数
+                                    winbollBuildProps.setProperty("buildCount", Integer.toString(buildCount));
+                                    
+                                    //保存编译标志配置
+                                    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+                                    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+                                    fos.close();
+									println "\n\n>>> Project build.properties saved.\n\n";
+                                    
+                                    if(winbollBuildProps['libraryProject'] != "") {
+                                        // 如果应用 build.properties 文件设置了类库模块项目文件名
+                                        // 就拷贝一份新的编译标志配置到类库项目文件夹
+                                        File libraryProjectBuildPropsFile = new File("$RootProjectDir/" + winbollBuildProps['libraryProject'] + "/build.properties")
+                                        assert(winbollBuildPropsFile.exists())
+                                        assert(libraryProjectBuildPropsFile.exists())
+                                        java.nio.file.Path sourceFilePath = winbollBuildPropsFile.toPath();
+                                        java.nio.file.Path targetFilePath = libraryProjectBuildPropsFile.toPath();
+                                        // 使用copyTo()方法复制文件，如果目标文件存在会被覆盖，可选参数可以选择不覆盖
+	                                    java.nio.file.Files.copy(sourceFilePath, targetFilePath, java.nio.file.StandardCopyOption.REPLACE_EXISTING);
+										
+										println "\n\n>>> Library Project build.properties saved.\n\n";
+                                    }
+                                }
+                            }
+                            
+                            // 如果正在发布，就拷贝到 WinBoLL 标签管理文件夹，和处理 Git 仓库管理任务。
+                            //
+                            if(variant.flavorName == "stage"&&variant.buildType.name == "release"){
+                                // 发布 APK 文件
+                                //
+                                // 截取版本号的版本字段为短版本名
+                                String szVersionName = "${versionName}"
+                                String[] szlistTemp = szVersionName.split("-")
+                                String szShortVersionName = szlistTemp[0]
+                                //String szCommonTagAPKName = "${rootProject.name}_" + szShortVersionName + ".apk"
+                                String szCommonTagAPKName = project.rootDir.name + "_" + szShortVersionName + ".apk"
+                                println "CommonTagAPKName is : " + szCommonTagAPKName
+                                
+                                //File outTagDir = new File(fWinBoLLStudioDir, "/${rootProject.name}/tag/")
+                                File outTagDir = new File(fWinBoLLStudioDir, "/" + project.rootDir.name + "/tag/")
+                                // 创建目标路径目录
+                                if(!outTagDir.exists()) {
+                                    outTagDir.mkdirs();
+                                    println "Output Folder Created.(Tags) : " + outTagDir.getAbsolutePath()
+                                }
+                                
+                                if(outTagDir.exists()) {
+                                    File targetAPK = new File(outTagDir, "${szCommonTagAPKName}")
+                                    if(targetAPK.exists()) {
+                                        // 标签版本APK文件已经存在，构建拷贝任务停止
+                                        assert (!targetAPK.exists())
+                                        // 可选择删除并继续输出APK文件
+                                        //delete targetAPK
+                                    }
+                                    // 复制一个备份
+                                    copy{
+                                        from file.outputFile
+                                        into outTagDir
+                                        rename {
+                                            String fileName -> "${outputFileName}"
+                                        }
+                                        println "Output APK (Tags): "+ outTagDir.getAbsolutePath() + "/${outputFileName}"
+                                    }
+                                    // 复制一个并重命名为短版本名
+                                    copy{
+                                        from file.outputFile
+                                        into outTagDir
+                                        rename {
+                                            String fileName -> "${szCommonTagAPKName}"
+                                        }
+                                        println "Output APK (Tags): "+ outTagDir.getAbsolutePath() + "/${szCommonTagAPKName}"
+                                    }
+                                    // 检查编译标志位配置
+                                    assert (winbollBuildProps['stageCount'] != null)
+                                    assert (winbollBuildProps['publishVersion'] != null)
+                                    assert (winbollBuildProps['buildCount'] != null)
+                                    assert (winbollBuildProps['baseVersion'] != null)
+                                    assert (winbollBuildProps['baseBetaVersion'] != null)
+                                    assert (winbollBuildProps['libraryProject'] != null)
+                                    
+                                    // 设置类库的默认版本名
+                                    winbollBuildProps.setProperty("publishVersion", "${versionName}");
+                                    // Stage 发布计数增加
+                                    int stageCount = Integer.parseInt(winbollBuildProps['stageCount']) + 1;
+                                    winbollBuildProps.setProperty("stageCount", Integer.toString(stageCount));
+                                    // 设置类库的默认Beta版本名
+                                    winbollBuildProps.setProperty("baseBetaVersion", winbollBuildProps['baseVersion'] + "." + Integer.toString(stageCount));
+                                    // 构建计数重置
+                                    winbollBuildProps.setProperty("buildCount", "0");
+                                    
+                                    //保存编译标志配置
+                                    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+                                    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+                                    fos.close();
+                                    
+                                    if(winbollBuildProps['libraryProject'] != "") {
+                                        // 如果应用 build.properties 文件设置了类库模块项目文件名
+                                        // 就拷贝一份新的编译标志配置到类库项目文件夹
+                                        File libraryProjectBuildPropsFile = new File("$RootProjectDir/" + winbollBuildProps['libraryProject'] + "/build.properties")
+                                        assert(winbollBuildPropsFile.exists())
+                                        assert(libraryProjectBuildPropsFile.exists())
+                                        java.nio.file.Path sourceFilePath = winbollBuildPropsFile.toPath();
+                                        java.nio.file.Path targetFilePath = libraryProjectBuildPropsFile.toPath();
+                                        // 使用copyTo()方法复制文件，如果目标文件存在会被覆盖，可选参数可以选择不覆盖
+                                        java.nio.file.Files.copy(sourceFilePath, targetFilePath, java.nio.file.StandardCopyOption.REPLACE_EXISTING);
+                                    }
+                                    
+                                    // 提交新的编译标志配置
+									println 'exec bashCommitAppPublishBuildFlagInfoFilePath ...'
+                                    def resultCommitBuildFlag = exec {
+                                        commandLine 'bash', '--', "${RootProjectDir}/${bashCommitAppPublishBuildFlagInfoFilePath}", "${RootProjectDir}", "${versionName}", variant.buildType.name , rootProject.name
+                                    }
+                                    // 检查bash命令的返回值（假设非零表示失败）
+                                    assert(resultCommitBuildFlag.getExitValue() == 0)
+                                }
+                            } //  if(variant.buildType.name == "release"){
+							
+							// 如果正在调试发布版，就只生成和输出APK文件，不处理 Git 仓库提交与更新问题。
+							//
+					        if(variant.flavorName == "stage"&&variant.buildType.name == "debug"){
+                                // 发布 APK 文件
+                                //
+                                // 截取版本号的版本字段为短版本名
+                                String szVersionName = "${versionName}"
+                                String[] szlistTemp = szVersionName.split("-")
+                                String szShortVersionName = szlistTemp[0]
+                                //String szCommonTagAPKName = "${rootProject.name}_" + szShortVersionName + ".apk"
+                                String szCommonTagAPKName = project.rootDir.name + "_" + szShortVersionName + ".apk"
+                                println "CommonTagAPKName is : " + szCommonTagAPKName
+                                
+                                //File outTagDir = new File(fWinBoLLStudioDir, "/${rootProject.name}/tag/")
+                                File outTagDir = new File(fWinBoLLStudioDir, "/" + project.rootDir.name + "/${variant.buildType.name}/")
+                                // 创建目标路径目录
+                                if(!outTagDir.exists()) {
+                                    outTagDir.mkdirs();
+                                    println "Output Folder Created.(Tags) : " + outTagDir.getAbsolutePath()
+                                }
+                                
+                                if(outTagDir.exists()) {
+                                    File targetAPK = new File(outTagDir, "${szCommonTagAPKName}")
+                                    if(targetAPK.exists()) {
+                                        // 标签版本APK文件已经存在，构建拷贝任务停止
+										println '如果是在调试 Stage 版应用包构建，请删除(注：在debug目录)现有的 Stage 应用包('+targetAPK.getAbsolutePath()+')。再编译一次。'
+                                        assert (!targetAPK.exists())
+                                        // 可选择删除并继续输出APK文件
+                                        //delete targetAPK
+                                    }
+                                    // 复制一个备份
+                                    copy{
+                                        from file.outputFile
+                                        into outTagDir
+                                        rename {
+                                            String fileName -> "${outputFileName}"
+                                        }
+                                        println "Output APK (Tags): "+ outTagDir.getAbsolutePath() + "/${outputFileName}"
+                                    }
+                                    // 复制一个并重命名为短版本名
+                                    copy{
+                                        from file.outputFile
+                                        into outTagDir
+                                        rename {
+                                            String fileName -> "${szCommonTagAPKName}"
+                                        }
+                                        println "Output APK (Tags): "+ outTagDir.getAbsolutePath() + "/${szCommonTagAPKName}"
+                                    }
+                                    
+                                    //不保存编译标志配置
+                                }
+                            }
+                            
+                            // 如果配置了APK额外输出路径，就复制一份拷贝到额外路径。
+                            //
+							if(winbollProps != null && winbollProps['ExtraAPKOutputPath'] != null ) {
+                                File apkFile = new File(winbollProps['ExtraAPKOutputPath'])
+								File outCommonDir = apkFile.getParentFile();
+                                String commandAPKName = apkFile.getName();
+                                if(outCommonDir.exists()) {
+                                    copy{
+                                        from file.outputFile
+                                        into outCommonDir
+                                        rename {
+                                            String fileName -> "${commandAPKName}"
+                                        }
+                                        println "Output APK (Common): " + outCommonDir.getAbsolutePath() + "/${commandAPKName}"
+                                    }
+                                }
+						    }
+                            
+                        
+                    }
+	            }// End of (variant.getAssembleProvider().get().doLast {)
+            }/// WINBOLL 主机的 APK 发布和源码管理操作结束 ///
+        }
+        
+    } // End of (android.applicationVariants.all { variant ->)
+}
+
diff --git a/.winboll/winboll_lib_build.gradle b/.winboll/winboll_lib_build.gradle
new file mode 100644
index 0000000..f63aa52
--- /dev/null
+++ b/.winboll/winboll_lib_build.gradle
@@ -0,0 +1,211 @@
+// 本机和 WinBoLL Maven 仓库传输配置。
+//
+
+def getDefaultVersion(){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['publishVersion'] != null)
+    // 返回编译版本号
+    return winbollBuildProps['publishVersion']
+}
+
+def siteUrl = 'https://winboll.cc/?page=studio/details.php&app=${rootProject.name}' // 项目主页
+def gitUrl = 'https://gitea.winboll.cc/WinBoLL/${rootProject.name}' // 项目的git地址
+def DefaultGroupId = 'cc.winboll.studio' // 类库所有者groupId
+def DefaultVersion = getDefaultVersion() // 版本号
+def DeveloperId='zhangsken' // 开发者账号
+def DeveloperName='ZhanGSKen' // 开发者名称
+def DeveloperEMail='zhangsken@188.com' // 开发者邮箱地址
+def LicenseName='The Apache Software License, Version 2.0'
+def LicenseUrl='http://www.apache.org/licenses/LICENSE-2.0.txt'
+
+Properties properties = new Properties()
+
+afterEvaluate {
+    publishing {
+        repositories {
+            if(file("${RootProjectDir}/${winbollFilePath}").exists()) {
+                properties.load(file("${RootProjectDir}/${winbollFilePath}").newDataInputStream())
+                def NexusUserName = properties.getProperty("Nexus.name")
+                def NexusPassword = properties.getProperty("Nexus.password")
+                // WinBoLL Release 仓库
+                maven{
+                    //仓库的名字和地址
+                    name = "WinBoLLRelease"
+                    url="https://nexus.winboll.cc/repository/maven-releases/"
+                    // 仓库用户名密码
+                    credentials {
+                        username = NexusUserName
+                        password = NexusPassword
+                    }
+                }
+                // WinBoLL Snapshot 仓库
+                maven{
+                    //仓库的名字和地址
+                    name = "WinBoLLSnapshot"
+                    url="https://nexus.winboll.cc/repository/maven-snapshots/"
+                    // 仓库用户名密码
+                    credentials {
+                        username = NexusUserName
+                        password = NexusPassword
+                    }
+                }
+            }
+        }
+        publications {
+            // Local Maven 仓库传输任务
+            //
+            release(MavenPublication) {
+                groupId = DefaultGroupId
+                artifactId = project.name
+                version = DefaultVersion
+    
+                //from components.java
+                // 必须有这个 否则不会上传AAR包
+                afterEvaluate { artifact(tasks.getByName("bundleReleaseAar")) }
+                // 上传source，这样使用方可以看到方法注释
+                //artifact generateSourcesJar
+                //要上传的aar路径
+                //artifact "$buildDir/outputs/aar/${project.getName()}-release.aar"
+                //artifact "$buildDir/outputs/aar/${project.getName()}-debug.aar"
+                
+                //对pom进行的操作
+                pom.withXml{
+                    Node pomNode = asNode()
+                    pomNode.dependencies.'*'.findAll() {
+                        //将所有的默认依赖移除
+                        //it.parent().remove(it)
+                    }
+                }
+                pom {
+                    name = artifactId
+                    url = siteUrl
+                    licenses {
+                        license { //证书说明
+                           name=LicenseName // 开源协议名称
+                           url=LicenseUrl // 协议地址
+                        }
+                    }
+                    developers {
+                        developer {
+                            id=DeveloperId // 开发者账号
+                            name=DeveloperName // 开发者名称
+                            email=DeveloperEMail // 开发者邮箱地址
+                        }
+                    }
+                    //软件配置管理
+                    scm {
+                        connection=gitUrl
+                        developerConnection=gitUrl
+                        url=siteUrl
+                    }
+                }
+            }
+            
+            // WinBoLL Maven Release 仓库传输任务
+            //
+            releaseWinBoLL(MavenPublication) {
+                // 需要使用的变体，假设有free和pay两个变体，可以选择一个
+                //from components.free
+                
+                groupId = DefaultGroupId // 文件的groupId
+                artifactId = project.name //文件的名字
+                version = DefaultVersion //版本号
+    
+                //from components.java
+                // 必须有这个 否则不会上传AAR包
+                afterEvaluate { artifact(tasks.getByName("bundleReleaseAar")) }
+                // 上传source，这样使用方可以看到方法注释
+                //artifact generateSourcesJar
+                //要上传的aar路径
+                //artifact "$buildDir/outputs/aar/${project.getName()}-release.aar"
+                //artifact "$buildDir/outputs/aar/${project.getName()}-debug.aar"
+                
+                //对pom进行的操作
+                pom.withXml{
+                    Node pomNode = asNode()
+                    pomNode.dependencies.'*'.findAll() {
+                        //将所有的默认依赖移除
+                        //it.parent().remove(it)
+                    }
+                }
+                pom {
+                    name = artifactId
+                    url = siteUrl
+                    licenses {
+                        license { //证书说明
+                           name=LicenseName // 开源协议名称
+                           url=LicenseUrl // 协议地址
+                        }
+                    }
+                    developers {
+                        developer {
+                            id=DeveloperId // 开发者账号
+                            name=DeveloperName // 开发者名称
+                            email=DeveloperEMail // 开发者邮箱地址
+                        }
+                    }
+                    //软件配置管理
+                    scm {
+                        connection=gitUrl
+                        developerConnection=gitUrl
+                        url=siteUrl
+                    }
+                }
+                
+            } // 创建名为 release 的任务结束
+            
+            // WinBoLL Maven Snapshot 仓库传输任务
+            //
+            snapshotWinBoLL(MavenPublication) {
+                // 需要使用的变体，假设有free和pay两个变体，可以选择一个
+                //from components.free
+                
+                groupId = DefaultGroupId // 文件的groupId
+                artifactId = project.name //文件的名字
+                version = DefaultVersion + "-SNAPSHOT" //版本号
+    
+                //from components.java
+                // 必须有这个 否则不会上传AAR包
+                afterEvaluate { artifact(tasks.getByName("bundleReleaseAar")) }
+                // 上传source，这样使用方可以看到方法注释
+                //artifact generateSourcesJar
+                //要上传的aar路径
+                //artifact "$buildDir/outputs/aar/${project.getName()}-release.aar"
+                //artifact "$buildDir/outputs/aar/${project.getName()}-debug.aar"
+                
+                //对pom进行的操作
+                pom.withXml{
+                    Node pomNode = asNode()
+                    pomNode.dependencies.'*'.findAll() {
+                        //将所有的默认依赖移除
+                        //it.parent().remove(it)
+                    }
+                }
+                pom {
+                    name = artifactId
+                    url = siteUrl
+                    licenses {
+                        license { //证书说明
+                           name=LicenseName // 开源协议名称
+                           url=LicenseUrl // 协议地址
+                        }
+                    }
+                    developers {
+                        developer {
+                            id=DeveloperId // 开发者账号
+                            name=DeveloperName // 开发者名称
+                            email=DeveloperEMail // 开发者邮箱地址
+                        }
+                    }
+                    //软件配置管理
+                    scm {
+                        connection=gitUrl
+                        developerConnection=gitUrl
+                        url=siteUrl
+                    }
+                }
+            } // 创建名为 snapshot 的任务结束
+        }
+        
+    }
+}
diff --git a/.winboll/winboll_lint_build.gradle b/.winboll/winboll_lint_build.gradle
new file mode 100644
index 0000000..b2ec440
--- /dev/null
+++ b/.winboll/winboll_lint_build.gradle
@@ -0,0 +1,50 @@
+android {
+    lintOptions {
+        // true--关闭lint报告的分析进度
+        //quiet true
+        // true--错误发生后停止gradle构建
+        abortOnError false
+        // true--只报告error
+        //ignoreWarnings true
+        // true--忽略有错误的文件的全/绝对路径(默认是true)
+        //absolutePaths true
+        // true--检查所有问题点，包含其他默认关闭项
+        checkAllWarnings true
+        // true--所有warning当做error
+        //warningsAsErrors true
+        // 关闭指定问题检查
+        //disable 'ExpiredTargetSdkVersion','HardcodedText','UnknownNullness','ButtonStyle','GradleDependency','UnusedResources'
+        // 打开指定问题检查
+        //enable 'RtlHardcoded','RtlCompat', 'RtlEnabled'
+        // 仅检查指定问题
+        //check 'NewApi', 'InlinedApi'
+        // true--error输出文件不包含源码行号
+        //noLines true
+        // true--显示错误的所有发生位置，不截取
+        showAll true
+        // 回退lint设置(默认规则)
+        //lintConfig file("default-lint.xml")
+        // true--生成txt格式报告(默认false)
+        //textReport true
+        // 重定向输出；可以是文件或'stdout'
+        //textOutput 'stdout'
+        // true--生成XML格式报告
+        xmlReport true
+        // 指定xml报告文档(默认lint-results.xml)
+        xmlOutput file("${lintXmlReportFilePath}")
+        // true--生成HTML报告(带问题解释，源码位置，等)
+        htmlReport true
+        // html报告可选路径(构建器默认是lint-results.html )
+        htmlOutput file("${lintHTMLReportFilePath}")
+        //  true--所有正式版构建执行规则生成崩溃的lint检查，如果有崩溃问题将停止构建
+        checkReleaseBuilds true
+        // 在发布版本编译时检查(即使不包含lint目标)，指定问题的规则生成崩溃
+        //fatal 'NewApi', 'InlineApi'
+        // 指定问题的规则生成错误
+        //error 'Wakelock', 'TextViewEdits'
+        // 指定问题的规则生成警告
+        //warning 'ResourceAsColor'
+        // 忽略指定问题的规则(同关闭检查)
+        //ignore 'TypographyQuotes'
+    }
+}
diff --git a/GenKeyStore/gen_debug_keystore.sh b/GenKeyStore/gen_debug_keystore.sh
new file mode 100644
index 0000000..6ecd6ac
--- /dev/null
+++ b/GenKeyStore/gen_debug_keystore.sh
@@ -0,0 +1,49 @@
+#!/bin/bash
+# 应用秘钥创建脚本
+# Linux 命令行创建JKS秘钥，alias和keyAlias可配置，文件名含时间戳
+
+# 可配置参数（按需修改）
+ALIAS="WinBoLL.CC_Debug"  # 别名（与keyAlias一致）
+STORE_PASS="androiddebugkey"
+KEY_PASS="androiddebugkey"
+COUNTRY="CN"        # 国家代码
+
+# 获取当前时间戳
+TIMESTAMP=$(date +%Y%m%d%H%M%S)
+FILENAME="${ALIAS}_${TIMESTAMP}.jks"
+STORENAME="${ALIAS}_${TIMESTAMP}.keystore"
+
+# 生成JKS文件（alias与keyAlias同步）
+keytool -genkeypair \
+  -alias "${ALIAS}" \
+  -keyalg RSA \
+  -keysize 2048 \
+  -validity 1 \
+  -keystore "${FILENAME}" \
+  -dname "CN=WBFans, OU=Studio, O=WinBoLL, L=Shanwei, ST=Guangdong, C=${COUNTRY}" \
+  -storepass "${STORE_PASS}" \
+  -keypass "${KEY_PASS}"
+
+# 写入配置文件
+cat <<EOF > ${STORENAME}
+keyAlias=${ALIAS}
+keyPassword=${KEY_PASS}
+storeFile=../appkey.jks
+storePassword=${STORE_PASS}
+EOF
+
+echo "已生成秘钥：${FILENAME}"
+echo "配置已写入 ${STORENAME}（keyAlias=${ALIAS}）"
+
+# 询问是否复制文件
+read -p "是否需要将文件复制为 appkey.jks 和 appkey.keystore？(y/n): " CONFIRM
+
+if [[ $CONFIRM =~ ^[Yy]$ ]]; then
+  # 复制 jks 文件为 appkey.jks
+  cp -v ${FILENAME} ../appkey.jks
+  # 复制 keystore 文件为 appkey.keystore
+  cp -v ${STORENAME} ../appkey.keystore
+  echo "文件复制完成"
+else
+  echo "已取消文件复制"
+fi
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..261eeb9
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/LICENSE-Private-Demo b/LICENSE-Private-Demo
new file mode 100644
index 0000000..dc5f366
--- /dev/null
+++ b/LICENSE-Private-Demo
@@ -0,0 +1,97 @@
+# WinBoLL 源码 LICENSE-Private-Demo 规范说明书
+
+# LICENSE-Private-Demo
+
+# WinBoLL 源码公共转私有继承开发规范守则
+
+## 核心声明
+
+本文档**唯一核心设计目的**：通过文件标识、分支隔离、操作规范、责任界定四重约束，**从根源规避私有开发分支代码被人为合并、推送、提交至公共开源主流分支的风险**，明确人为操作失误、违规合并的全部责任归属，同时保证私有分支可正常同步、拉取公共主流分支的上游更新。
+
+## 一、文件宗旨与风险防控说明
+
+本文件为 WinBoLL 项目公共开源分支转为私有独立分支开发的**强制标准化操作手册与责任界定文件**，核心风控目标：
+
+1. 严格隔离公共开源分支与私有开发分支，通过授权文件标记实现分支属性一眼可辨，杜绝人为操作混淆
+
+2. **重点防控人为操作导致的私有分支代码违规合并、回合、推送至公共 ****`winboll`**** 主流分支**，从流程上封堵合并风险
+
+3. 明确所有开发提交者的操作责任，违规合并公共分支的行为由操作人承担全部代码泄露、合规风险
+
+4. 规范私有分支初始化全流程，保证私有分支仅可单向同步公共分支更新，禁止任何反向代码流入公共分支
+
+## 二、公私分支授权标识文件定义（风控核心依据）
+
+### 1. 公共开源分支唯一标识
+
+**文件名：LICENSE**
+
+- 仅允许存在于公共主流分支 `winboll` 及官方公共衍生分支
+
+- 标识当前分支为**开源公开可贡献分支**，遵循原开源授权协议
+
+- **严禁私有分支内保留、恢复此文件**，出现即判定分支属性异常
+
+### 2. 私有开发分支唯一标识
+
+**文件名：LICENSE-Private**
+
+- 仅允许存在于私有开发分支，**绝对禁止出现在公共 ****`winboll`**** 分支**
+
+- 标识当前分支为**私有闭源分支**，代码仅限内部使用，禁止公开、禁止对外贡献
+
+- 为本分支私有属性的法定判定依据，也是禁止合并至公共分支的核心标记
+
+## 三、分支管理与合并风控规则（强制遵守）
+
+1. **公共主流分支**：固定为 `winboll`，为项目唯一开源主线，仅保留 `LICENSE` 文件，**禁止接收任何私有分支的合并、提交、推送请求**。
+
+2. **私有开发分支**：统一从 `winboll` 分支检出，命名固定格式为 `private-demo-*`，与公共分支物理隔离。
+
+3. **核心合并风控铁则**
+
+    - 私有分支 → 公共分支：**永久禁止任何形式的合并、推送、PR 提交、代码回合，人为操作也绝不允许**
+
+    - 公共分支 → 私有分支：允许正常拉取、同步上游更新，不影响私有开发迭代
+
+4. 所有仓库提交者、合并操作者，均视为已阅读并完全认可本规则，**人为执行私有分支向公共分支的合并操作，由操作人承担全部代码泄露、合规违约、项目安全风险**。
+
+## 四、公共转私有标准化操作步骤（锁死合并风险）
+
+请严格按顺序执行，每一步均为风控必要环节，不可跳过、不可修改顺序。
+
+1. 基于公共主流分支 `winboll`，新建私有开发分支，严格使用 `private-demo-*` 命名，从名称上明确分支私有属性，避免人为混淆。
+
+2. 本地仓库切换至新建私有分支，确认当前分支名称、检出来源无误。
+
+3. **永久删除项目根目录公共授权文件 ****`LICENSE`**，彻底移除公共分支标识，断绝误合并的标识漏洞。
+
+4. 将本规范文件 `LICENSE-Private-Demo` 复制并重命名为 `LICENSE-Private`，作为私有分支生效授权文件。
+
+5. 将以上所有变更执行一次性 Git 提交，**提交信息必须固定使用以下内容，不可修改**：
+
+    > 初始化私有开发分支，已切换私有授权文件，本分支禁止任何人为合并、推送至 winboll 公共分支
+    > 
+    > 
+
+6. 提交完成后，本分支正式转为私有开发状态，后续所有代码提交、分支合并、版本迭代，均严禁指向公共 `winboll` 分支。
+
+## 五、人为操作责任界定（核心补充条款）
+
+1. 本分支所有开发者、代码提交者、分支合并操作者，均视为**完全知晓本分支的私有属性与合并禁令**，自愿遵守本规范全部约束。
+
+2. **无论故意或过失，凡是人为执行私有分支向公共 ****`winboll`**** 分支的合并、推送、PR 提交、代码回合操作，全部责任由执行操作的本人独立承担**，项目方不承担任何因人为违规操作导致的代码泄露、开源合规、版本污染风险。
+
+3. 仓库管理员需严格校验合并请求的分支标识与授权文件，发现带有 `LICENSE-Private` 标记的分支申请合并至公共分支，一律直接拒绝，并记录操作人信息。
+
+4. 分支属性校验以根目录授权文件为唯一标准：只要分支内存在 `LICENSE-Private` 文件，就绝对禁止向公共分支发起任何合并操作。
+
+## 六、分支状态校验与异常处理
+
+- 合规公共分支：仅存在 `LICENSE`，无 `LICENSE-Private`
+
+- 合规私有分支：仅存在 `LICENSE-Private`，无 `LICENSE`
+
+- 异常状态：两个文件同时存在 / 均不存在 → 立即停止开发与提交，按本规范重置分支状态，严禁执行任何合并操作
+
+> （注：文档部分内容可能由 AI 生成）
diff --git a/LICENSE-Private-Demo_docs/LICENSE-Private-Demo b/LICENSE-Private-Demo_docs/LICENSE-Private-Demo
new file mode 100644
index 0000000..dc5f366
--- /dev/null
+++ b/LICENSE-Private-Demo_docs/LICENSE-Private-Demo
@@ -0,0 +1,97 @@
+# WinBoLL 源码 LICENSE-Private-Demo 规范说明书
+
+# LICENSE-Private-Demo
+
+# WinBoLL 源码公共转私有继承开发规范守则
+
+## 核心声明
+
+本文档**唯一核心设计目的**：通过文件标识、分支隔离、操作规范、责任界定四重约束，**从根源规避私有开发分支代码被人为合并、推送、提交至公共开源主流分支的风险**，明确人为操作失误、违规合并的全部责任归属，同时保证私有分支可正常同步、拉取公共主流分支的上游更新。
+
+## 一、文件宗旨与风险防控说明
+
+本文件为 WinBoLL 项目公共开源分支转为私有独立分支开发的**强制标准化操作手册与责任界定文件**，核心风控目标：
+
+1. 严格隔离公共开源分支与私有开发分支，通过授权文件标记实现分支属性一眼可辨，杜绝人为操作混淆
+
+2. **重点防控人为操作导致的私有分支代码违规合并、回合、推送至公共 ****`winboll`**** 主流分支**，从流程上封堵合并风险
+
+3. 明确所有开发提交者的操作责任，违规合并公共分支的行为由操作人承担全部代码泄露、合规风险
+
+4. 规范私有分支初始化全流程，保证私有分支仅可单向同步公共分支更新，禁止任何反向代码流入公共分支
+
+## 二、公私分支授权标识文件定义（风控核心依据）
+
+### 1. 公共开源分支唯一标识
+
+**文件名：LICENSE**
+
+- 仅允许存在于公共主流分支 `winboll` 及官方公共衍生分支
+
+- 标识当前分支为**开源公开可贡献分支**，遵循原开源授权协议
+
+- **严禁私有分支内保留、恢复此文件**，出现即判定分支属性异常
+
+### 2. 私有开发分支唯一标识
+
+**文件名：LICENSE-Private**
+
+- 仅允许存在于私有开发分支，**绝对禁止出现在公共 ****`winboll`**** 分支**
+
+- 标识当前分支为**私有闭源分支**，代码仅限内部使用，禁止公开、禁止对外贡献
+
+- 为本分支私有属性的法定判定依据，也是禁止合并至公共分支的核心标记
+
+## 三、分支管理与合并风控规则（强制遵守）
+
+1. **公共主流分支**：固定为 `winboll`，为项目唯一开源主线，仅保留 `LICENSE` 文件，**禁止接收任何私有分支的合并、提交、推送请求**。
+
+2. **私有开发分支**：统一从 `winboll` 分支检出，命名固定格式为 `private-demo-*`，与公共分支物理隔离。
+
+3. **核心合并风控铁则**
+
+    - 私有分支 → 公共分支：**永久禁止任何形式的合并、推送、PR 提交、代码回合，人为操作也绝不允许**
+
+    - 公共分支 → 私有分支：允许正常拉取、同步上游更新，不影响私有开发迭代
+
+4. 所有仓库提交者、合并操作者，均视为已阅读并完全认可本规则，**人为执行私有分支向公共分支的合并操作，由操作人承担全部代码泄露、合规违约、项目安全风险**。
+
+## 四、公共转私有标准化操作步骤（锁死合并风险）
+
+请严格按顺序执行，每一步均为风控必要环节，不可跳过、不可修改顺序。
+
+1. 基于公共主流分支 `winboll`，新建私有开发分支，严格使用 `private-demo-*` 命名，从名称上明确分支私有属性，避免人为混淆。
+
+2. 本地仓库切换至新建私有分支，确认当前分支名称、检出来源无误。
+
+3. **永久删除项目根目录公共授权文件 ****`LICENSE`**，彻底移除公共分支标识，断绝误合并的标识漏洞。
+
+4. 将本规范文件 `LICENSE-Private-Demo` 复制并重命名为 `LICENSE-Private`，作为私有分支生效授权文件。
+
+5. 将以上所有变更执行一次性 Git 提交，**提交信息必须固定使用以下内容，不可修改**：
+
+    > 初始化私有开发分支，已切换私有授权文件，本分支禁止任何人为合并、推送至 winboll 公共分支
+    > 
+    > 
+
+6. 提交完成后，本分支正式转为私有开发状态，后续所有代码提交、分支合并、版本迭代，均严禁指向公共 `winboll` 分支。
+
+## 五、人为操作责任界定（核心补充条款）
+
+1. 本分支所有开发者、代码提交者、分支合并操作者，均视为**完全知晓本分支的私有属性与合并禁令**，自愿遵守本规范全部约束。
+
+2. **无论故意或过失，凡是人为执行私有分支向公共 ****`winboll`**** 分支的合并、推送、PR 提交、代码回合操作，全部责任由执行操作的本人独立承担**，项目方不承担任何因人为违规操作导致的代码泄露、开源合规、版本污染风险。
+
+3. 仓库管理员需严格校验合并请求的分支标识与授权文件，发现带有 `LICENSE-Private` 标记的分支申请合并至公共分支，一律直接拒绝，并记录操作人信息。
+
+4. 分支属性校验以根目录授权文件为唯一标准：只要分支内存在 `LICENSE-Private` 文件，就绝对禁止向公共分支发起任何合并操作。
+
+## 六、分支状态校验与异常处理
+
+- 合规公共分支：仅存在 `LICENSE`，无 `LICENSE-Private`
+
+- 合规私有分支：仅存在 `LICENSE-Private`，无 `LICENSE`
+
+- 异常状态：两个文件同时存在 / 均不存在 → 立即停止开发与提交，按本规范重置分支状态，严禁执行任何合并操作
+
+> （注：文档部分内容可能由 AI 生成）
diff --git a/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.docx b/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.docx
new file mode 100644
index 0000000..0859049
Binary files /dev/null and b/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.docx differ
diff --git a/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.pdf b/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.pdf
new file mode 100644
index 0000000..10c3c11
Binary files /dev/null and b/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.pdf differ
diff --git a/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.txt b/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.txt
new file mode 100644
index 0000000..e191e48
--- /dev/null
+++ b/LICENSE-Private-Demo_docs/WinBoLL_源码_LICENSE-Private-Demo_规范说明书.txt
@@ -0,0 +1,97 @@
+# WinBoLL 源码 LICENSE\-Private\-Demo 规范说明书
+
+# LICENSE\-Private\-Demo
+
+# WinBoLL 源码公共转私有继承开发规范守则
+
+## 核心声明
+
+本文档**唯一核心设计目的**：通过文件标识、分支隔离、操作规范、责任界定四重约束，**从根源规避私有开发分支代码被人为合并、推送、提交至公共开源主流分支的风险**，明确人为操作失误、违规合并的全部责任归属，同时保证私有分支可正常同步、拉取公共主流分支的上游更新。
+
+## 一、文件宗旨与风险防控说明
+
+本文件为 WinBoLL 项目公共开源分支转为私有独立分支开发的**强制标准化操作手册与责任界定文件**，核心风控目标：
+
+1. 严格隔离公共开源分支与私有开发分支，通过授权文件标记实现分支属性一眼可辨，杜绝人为操作混淆
+
+2. **重点防控人为操作导致的私有分支代码违规合并、回合、推送至公共 ****`winboll`**** 主流分支**，从流程上封堵合并风险
+
+3. 明确所有开发提交者的操作责任，违规合并公共分支的行为由操作人承担全部代码泄露、合规风险
+
+4. 规范私有分支初始化全流程，保证私有分支仅可单向同步公共分支更新，禁止任何反向代码流入公共分支
+
+## 二、公私分支授权标识文件定义（风控核心依据）
+
+### 1\. 公共开源分支唯一标识
+
+**文件名：LICENSE**
+
+- 仅允许存在于公共主流分支 `winboll` 及官方公共衍生分支
+
+- 标识当前分支为**开源公开可贡献分支**，遵循原开源授权协议
+
+- **严禁私有分支内保留、恢复此文件**，出现即判定分支属性异常
+
+### 2\. 私有开发分支唯一标识
+
+**文件名：LICENSE\-Private**
+
+- 仅允许存在于私有开发分支，**绝对禁止出现在公共 ****`winboll`**** 分支**
+
+- 标识当前分支为**私有闭源分支**，代码仅限内部使用，禁止公开、禁止对外贡献
+
+- 为本分支私有属性的法定判定依据，也是禁止合并至公共分支的核心标记
+
+## 三、分支管理与合并风控规则（强制遵守）
+
+1. **公共主流分支**：固定为 `winboll`，为项目唯一开源主线，仅保留 `LICENSE` 文件，**禁止接收任何私有分支的合并、提交、推送请求**。
+
+2. **私有开发分支**：统一从 `winboll` 分支检出，命名固定格式为 `private\-demo\-\*`，与公共分支物理隔离。
+
+3. **核心合并风控铁则**
+
+    - 私有分支 → 公共分支：**永久禁止任何形式的合并、推送、PR 提交、代码回合，人为操作也绝不允许**
+
+    - 公共分支 → 私有分支：允许正常拉取、同步上游更新，不影响私有开发迭代
+
+4. 所有仓库提交者、合并操作者，均视为已阅读并完全认可本规则，**人为执行私有分支向公共分支的合并操作，由操作人承担全部代码泄露、合规违约、项目安全风险**。
+
+## 四、公共转私有标准化操作步骤（锁死合并风险）
+
+请严格按顺序执行，每一步均为风控必要环节，不可跳过、不可修改顺序。
+
+1. 基于公共主流分支 `winboll`，新建私有开发分支，严格使用 `private\-demo\-\*` 命名，从名称上明确分支私有属性，避免人为混淆。
+
+2. 本地仓库切换至新建私有分支，确认当前分支名称、检出来源无误。
+
+3. **永久删除项目根目录公共授权文件 ****`LICENSE`**，彻底移除公共分支标识，断绝误合并的标识漏洞。
+
+4. 将本规范文件 `LICENSE\-Private\-Demo` 复制并重命名为 `LICENSE\-Private`，作为私有分支生效授权文件。
+
+5. 将以上所有变更执行一次性 Git 提交，**提交信息必须固定使用以下内容，不可修改**：
+
+    > 初始化私有开发分支，已切换私有授权文件，本分支禁止任何人为合并、推送至 winboll 公共分支
+    > 
+    > 
+
+6. 提交完成后，本分支正式转为私有开发状态，后续所有代码提交、分支合并、版本迭代，均严禁指向公共 `winboll` 分支。
+
+## 五、人为操作责任界定（核心补充条款）
+
+1. 本分支所有开发者、代码提交者、分支合并操作者，均视为**完全知晓本分支的私有属性与合并禁令**，自愿遵守本规范全部约束。
+
+2. **无论故意或过失，凡是人为执行私有分支向公共 ****`winboll`**** 分支的合并、推送、PR 提交、代码回合操作，全部责任由执行操作的本人独立承担**，项目方不承担任何因人为违规操作导致的代码泄露、开源合规、版本污染风险。
+
+3. 仓库管理员需严格校验合并请求的分支标识与授权文件，发现带有 `LICENSE\-Private` 标记的分支申请合并至公共分支，一律直接拒绝，并记录操作人信息。
+
+4. 分支属性校验以根目录授权文件为唯一标准：只要分支内存在 `LICENSE\-Private` 文件，就绝对禁止向公共分支发起任何合并操作。
+
+## 六、分支状态校验与异常处理
+
+- 合规公共分支：仅存在 `LICENSE`，无 `LICENSE\-Private`
+
+- 合规私有分支：仅存在 `LICENSE\-Private`，无 `LICENSE`
+
+- 异常状态：两个文件同时存在 / 均不存在 → 立即停止开发与提交，按本规范重置分支状态，严禁执行任何合并操作
+
+> （注：文档部分内容可能由 AI 生成）
diff --git a/LICENSE-Private-Demo_docs/long_pic_1778650008421587_503089827979333.jpg b/LICENSE-Private-Demo_docs/long_pic_1778650008421587_503089827979333.jpg
new file mode 100644
index 0000000..77b5918
Binary files /dev/null and b/LICENSE-Private-Demo_docs/long_pic_1778650008421587_503089827979333.jpg differ
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2c681b4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,105 @@
+# WinBoLL 源生态计划项目说明书
+
+## 一、项目概述
+
+### 1. 核心定位
+WinBoLL 手机源码计划，旨在通过核心项目 WinBoLL 构建手机端与服务器端的 Android 项目的开发源码生态。实现手机与服务器的源码的联合开发。
+
+### 2. 仓库架构
+#### **仓库类型：功能说明**
+☆ 基础项目分支 WinBoLL：手机端安卓应用开发基础模板。
+☆ 应用项目分支 APPBase、AES、PowerBell、Positions**：安卓应用单一管理系列项目。
+☆ 源码汇总管理 OriginMaster**：各类分支源码合并存档，不适宜作为开发库使用。
+
+### 3. 源码合并管理推送路线图
+⚠️ **注意**：仅仅展示不同应用模块源码的综合管理路线。分支合并操作时，必须具备 Git 管理经验。
+
+★ WinBoLL → APPBase → OriginMaster
+★ WinBoLL → AES → OriginMaster
+★ WinBoLL → PowerBell → OriginMaster
+★ WinBoLL → Positions → OriginMaster
+
+## 二、WinBoLL 项目核心信息
+
+### 1. 项目简介
+☆ WinBoLL 项目是为手机端开发Android 项目的需求而设计的项目。
+
+### 2. 官方资源
+#### ☆ 官方网站**：https://www.winboll.cc/
+#### ☆ 源码地址：
+★ Gitea：https://gitea.winboll.cc/Studio/WinBoLL.git
+★ GitHub：https://github.com/ZhanGSKen/WinBoLL.git
+★ 码云：https://gitee.com/zhangsken/winboll.git
+
+## 三、应用编译环境检查问题
+### 核心判断条件：
+☆ WinBoLL 项目以文件夹 `"/sdcard/WinBoLLStudio/APKs"` 是否存在为判断环境编译输出条件，因为编译输出的APK文件需要一个可供保存的环境。
+
+☆ 文件夹"/sdcard/WinBoLLStudio/APKs" 目录条件设置方法：
+***Linux 服务器端方面***：建立 `/sdcard/WinBoLLStudio/APKs` 目录即可。
+***手机开发端方面***：建立 `"/sdcard/WinBoLLStudio/APKs"` 目录(即 `"/storage/emulated/0/WinBoLLStudio/APKs"` 目录) 即可。
+
+## 四、前置条件
+
+### 1. WinBoLL APP 开发环境配置介绍
+####  WinBoLL APK 编译输出内容包括：
+☆ "/sdcard/WinBoLLStudio/APKs"` 目录内的所有应用分支的 APK 文件。
+winboll.properties 文件的 APKOutputPath 属性可配置这个 APK 输出目录的路径。
+☆ "/sdcard/AppProjects/app.apk"文件。
+winboll.properties 文件的 ExtraAPKOutputPath 属性可配置这个 APK 额外输出文件的路径
+#### WinBoLL APK 源码命名空间规范
+☆ WinBoLL 项目使用 "cc.winboll.studio" 作为源码命名空间。在此命名空间下进行源码定义。
+
+## 五、核心需求规划
+
+### 1. WinBoLL 应用安全验证需求
+#### ☆ 支持访问 https://console.winboll.cc/ 服务器以校验应用包签名与版本。
+
+### 2. 手机端源码开发管理需求
+#### ☆ 支持切换不同 WinBoLL 分支，以开发不同安卓应用。
+
+## 六、编译与使用指南
+
+### 1. 项目初始化（必须）
+#### 1.  复制 `settings.gradle-demo` 为 `settings.gradle`。编辑 `settings.gradle` 文件内容，取消对应项目模块注释。
+#### 2.  复制 `gradle.properties-androidx-demo` (Android X 项目) 或 `gradle.properties-android-demo` (基本 Android 项目) 为 `gradle.properties`。
+#### 3.  复制（可选）`local.properties-demo` 为 `local.properties`，编辑 `local.properties` 文件内容，配置 Android SDK 目录。
+#### 4.  **签名设置**：
+    ☆ **调试编译秘钥制作**：使用 Termux 应用终端，cd 进入 GenKeyStore 目录，运行 `bash gen_debug_keystore.sh` 脚本即可生成应用调试秘钥。
+    ☆  **应用秘钥配置方法**：拷贝调试编译秘钥制作生成的 `appkey.jks` 与 `appkey.keystore` 文件到项目根目录即可。
+
+## 七、应用编译命令介绍
+
+### （1）类库型模块配置要点
+#### 1.  **优先修改配置文件**：优先修改应用测试项目（目录为 `"<WinBoLl根目录>/<类库测试应用>/"`）内 `build.properties` 文件，设置对应的类库项目名称：`libraryProject=<类库项目模块名>`。
+#### 2.  **编译优先启动步骤**：使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishAPKAddTag.sh <类库测试项目模块名>` 命令。运行后可生成测试项目与类库项目的编译参数文件 `build.properties`。生成的 `build.properties` 文件有两份，一份在测试项目模块的文件夹内，一份在类库项目本身的模块文件夹内。
+#### 3.  **最后类库编译发布步骤**：使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishLIBAddTag.sh <类库项目模块名>` 命令。运行后可发布至 WinBoLL Nexus Maven 库、本地 maven 目录或者是通用默认的 Gradle Maven 库。
+
+### （2）单一应用型模块与类库测试型模块配置要点
+#### ☆ APK 编译方法：
+使用 Termux 应用，进入 `"<WinBoLl根目录>"`，运行 `$ bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名>`。
+#### ☆ 运行后的 APK 输出路径：
+★ 默认路径 (`$ bash gradlew assembleBetaDebug` 任务)：APK 在 `/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/debug/` 目录。
+★ 默认路径 (`$ bash assembleStageRelease` 任务)：APK 在 `/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/` 目录。
+★ 额外输出路径：(假设 `winboll.properties` 文件已配置 `ExtraAPKOutputPath` 属性) 输出至 `ExtraAPKOutputPath` 属性配置的目录下。
+
+### （3）手机端应用调试命令介绍
+#### ☆ Beta 渠道调试命令
+$bash gradlew assembleBetaDebug
+
+#### ☆ Stage 渠道调试命令
+$bash gradlew assembleStageDebug
+
+### （4）服务器端开发命令介绍
+##### ☆ Stage 渠道应用发布命令为：
+（"<WinBoLl根目录>/settings.gradle"文件需要配置编译模块开启参数，拷贝 settings.gradle-demo 为 settings.gradle 文件取消对应的分支配置部分即可。）
+$bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
+或者是
+$bash gradlew assembleStageRelease
+ 
+
+## 八、WinBoLL 应用 APK 版本号命名规则
+### ☆ Stage 渠道：
+#### V<应用开发环境编号><应用功能变更号><应用调试阶段号> （示例： APPBase_15.7.0 ）
+### ☆ Beta 渠道：
+#### V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)> （示例： APPBase_15.9.6-beta8_5413 ）
diff --git a/aes/.gitignore b/aes/.gitignore
new file mode 100644
index 0000000..42afabf
--- /dev/null
+++ b/aes/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/aes/README.md b/aes/README.md
new file mode 100644
index 0000000..1606637
--- /dev/null
+++ b/aes/README.md
@@ -0,0 +1,36 @@
+# AES
+[![](https://jitpack.io/v/ZhanGSKen/AES.svg)](https://jitpack.io/#ZhanGSKen/AES)
+
+#### 介绍
+WinBoLL AndroidX 可视化元素类库。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh aes
+阶段版类库发布命令 ：git pull &&bash .winboll/bashPublishLIBAddTag.sh libaes
+
+#### 使用说明
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/aes/app_update_description.txt b/aes/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/aes/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/aes/build.gradle b/aes/build.gradle
new file mode 100644
index 0000000..8039c8c
--- /dev/null
+++ b/aes/build.gradle
@@ -0,0 +1,48 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.aes"
+        minSdkVersion 26
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // 项目模块目录的 build.gradle 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.20" 
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+	
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+}
+
+dependencies {
+	api project(':libaes')
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/aes/build.properties b/aes/build.properties
new file mode 100644
index 0000000..4e746cb
--- /dev/null
+++ b/aes/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Tue May 12 13:11:28 HKT 2026
+stageCount=4
+libraryProject=libaes
+baseVersion=15.20
+publishVersion=15.20.3
+buildCount=0
+baseBetaVersion=15.20.4
diff --git a/aes/proguard-rules.pro b/aes/proguard-rules.pro
new file mode 100644
index 0000000..a18de74
--- /dev/null
+++ b/aes/proguard-rules.pro
@@ -0,0 +1,137 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/aes/src/beta/AndroidManifest.xml b/aes/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/aes/src/beta/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/aes/src/beta/res/values/strings.xml b/aes/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..6f287f2
--- /dev/null
+++ b/aes/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+    <string name="app_name">AES+</string>
+</resources>
diff --git a/aes/src/main/AndroidManifest.xml b/aes/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..c732afa
--- /dev/null
+++ b/aes/src/main/AndroidManifest.xml
@@ -0,0 +1,45 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.aes">
+
+    <!-- 对正在运行的应用重新排序 -->
+    <uses-permission android:name="android.permission.REORDER_TASKS"/>
+
+    <application
+        android:name=".App"
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/MyAESTheme"
+        android:requestLegacyExternalStorage="true"
+        android:supportsRtl="true"
+        android:networkSecurityConfig="@xml/network_security_config">
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name=".TestActivityManagerActivity"/>
+
+        <activity android:name=".SettingsActivity"/>
+
+        <activity android:name=".AboutActivity"/>
+
+    </application>
+
+</manifest>
\ No newline at end of file
diff --git a/aes/src/main/java/cc/winboll/studio/aes/AboutActivity.java b/aes/src/main/java/cc/winboll/studio/aes/AboutActivity.java
new file mode 100644
index 0000000..26c89bf
--- /dev/null
+++ b/aes/src/main/java/cc/winboll/studio/aes/AboutActivity.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.aes;
+
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.aes.R;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/13 11:25
+ * @Describe 应用介绍窗口
+ */
+public class AboutActivity extends BaseWinBoLLActivity {
+
+    public static final String TAG = "AboutActivity";
+	
+	private Toolbar mToolbar;
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+		// 设置工具栏
+        initToolbar();
+
+		AboutView aboutView = findViewById(R.id.aboutview);
+		aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+	private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					WinBoLLActivityManager.getInstance().resumeActivity(MainActivity.class);
+					WinBoLLActivityManager.getInstance().finish(AboutActivity.this);
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+	private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "aes";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName(getString(R.string.app_name));
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("AES");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=AES");
+        appInfo.setAppAPKName("AES");
+        appInfo.setAppAPKFolderName("AES");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
diff --git a/aes/src/main/java/cc/winboll/studio/aes/App.java b/aes/src/main/java/cc/winboll/studio/aes/App.java
new file mode 100644
index 0000000..f6816f7
--- /dev/null
+++ b/aes/src/main/java/cc/winboll/studio/aes/App.java
@@ -0,0 +1,34 @@
+package cc.winboll.studio.aes;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/13 19:03:58
+ * @Describe AES应用类
+ */
+import android.view.Gravity;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+
+public class App extends GlobalApplication {
+
+    public static final String TAG = "App";
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+		setIsDebugging(BuildConfig.DEBUG);
+		//setIsDebugging(false);
+		WinBoLLActivityManager.init(this);
+
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+    }
+
+	@Override
+	public void onTerminate() {
+		super.onTerminate();
+		ToastUtils.release();
+	}
+}
diff --git a/aes/src/main/java/cc/winboll/studio/aes/BaseWinBoLLActivity.java b/aes/src/main/java/cc/winboll/studio/aes/BaseWinBoLLActivity.java
new file mode 100644
index 0000000..0526f82
--- /dev/null
+++ b/aes/src/main/java/cc/winboll/studio/aes/BaseWinBoLLActivity.java
@@ -0,0 +1,45 @@
+package cc.winboll.studio.aes;
+
+import android.app.Activity;
+import android.os.Bundle;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/13 16:35
+ * @Describe BaseWinBollActivity 【继承AppCompatActivity，保留核心能力，不额外暴露方法】
+ * 继承链路：BaseWinBoLLActivity → AppCompatActivity → FragmentActivity，AppCompat能力天然继承可用
+ */
+public abstract class BaseWinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+    public static final String TAG = "BaseWinBoLLActivity";
+
+    protected volatile AESThemeBean.ThemeType mThemeType;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        mThemeType = AESThemeBean.getThemeStyleType(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        setTheme(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        super.onCreate(savedInstanceState);
+        WinBoLLActivityManager.getInstance().add(this);
+    }
+
+    @Override
+    protected void onDestroy() {
+        WinBoLLActivityManager.getInstance().registeRemove(this);
+        super.onDestroy();
+    }
+
+    // 子类必须实现getTag()，确保唯一标识
+    @Override
+    public abstract String getTag();
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+}
+
diff --git a/aes/src/main/java/cc/winboll/studio/aes/MainActivity.java b/aes/src/main/java/cc/winboll/studio/aes/MainActivity.java
new file mode 100644
index 0000000..927c852
--- /dev/null
+++ b/aes/src/main/java/cc/winboll/studio/aes/MainActivity.java
@@ -0,0 +1,196 @@
+package cc.winboll.studio.aes;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/13 19:05:52
+ * @Describe 应用主窗口
+ */
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.AdapterView;
+import android.widget.Toast;
+import cc.winboll.studio.aes.R;
+import cc.winboll.studio.libaes.activitys.DrawerFragmentActivity;
+import cc.winboll.studio.libaes.dialogs.LocalFileSelectDialog;
+import cc.winboll.studio.libaes.dialogs.StoragePathDialog;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.DrawerMenuBean;
+import cc.winboll.studio.libaes.unittests.SecondaryLibraryActivity;
+import cc.winboll.studio.libaes.unittests.TestAButtonFragment;
+import cc.winboll.studio.libaes.unittests.TestASupportToolbarActivity;
+import cc.winboll.studio.libaes.unittests.TestAToolbarActivity;
+import cc.winboll.studio.libaes.unittests.TestDrawerFragmentActivity;
+import cc.winboll.studio.libaes.unittests.TestViewPageFragment;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import com.a4455jkjh.colorpicker.ColorPickerDialog;
+import java.util.ArrayList;
+
+public class MainActivity extends DrawerFragmentActivity {
+
+
+    public static final String TAG = "MainActivity";
+
+    TestAButtonFragment mTestAButtonFragment;
+    TestViewPageFragment mTestViewPageFragment;
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        if (mTestAButtonFragment == null) {
+            mTestAButtonFragment = new TestAButtonFragment();
+            addFragment(mTestAButtonFragment);
+        }
+        showFragment(mTestAButtonFragment);
+        //setSubtitle(TAG);
+        //ToastUtils.show("onCreate");
+    }
+
+    @Override
+    public void initDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+        super.initDrawerMenuItemList(listDrawerMenu);
+        LogUtils.d(TAG, "initDrawerMenuItemList");
+        //listDrawerMenu.clear();
+        // 添加抽屉菜单项
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestAButtonFragment.TAG));
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestViewPageFragment.TAG));
+        notifyDrawerMenuDataChanged();
+    }
+
+    @Override
+    public void reinitDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+        super.reinitDrawerMenuItemList(listDrawerMenu);
+        LogUtils.d(TAG, "reinitDrawerMenuItemList");
+        //listDrawerMenu.clear();
+        // 添加抽屉菜单项
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestAButtonFragment.TAG));
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestViewPageFragment.TAG));
+        notifyDrawerMenuDataChanged();
+    }
+
+    @Override
+    public DrawerFragmentActivity.ActivityType initActivityType() {
+        return DrawerFragmentActivity.ActivityType.Main;
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.toolbar_main, menu);
+//        if(App.isDebugging()) {
+//            getMenuInflater().inflate(cc.winboll.studio.libaes.R.menu.toolbar_studio_debug, menu);
+//        }
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    @Override
+    public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
+        super.onItemClick(parent, view, position, id);
+        switch (position) {
+            case 0 : {
+                    if (mTestAButtonFragment == null) {
+                        mTestAButtonFragment = new TestAButtonFragment();
+                        addFragment(mTestAButtonFragment);
+                    }
+                    showFragment(mTestAButtonFragment);
+                    break;
+                }
+            case 1 : {
+                    if (mTestViewPageFragment == null) {
+                        mTestViewPageFragment = new TestViewPageFragment();
+                        addFragment(mTestViewPageFragment);
+                    }
+                    showFragment(mTestViewPageFragment);
+                    break;
+                }
+        }
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int nItemId = item.getItemId();
+        if (item.getItemId() == R.id.item_testactivitymanager) {
+            WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, TestActivityManagerActivity.class);
+			//ToastUtils.show("item_testactivitymanager");
+        } else 
+        if (nItemId == R.id.item_atoast) {
+            Toast.makeText(getApplication(), "item_testatoast", Toast.LENGTH_SHORT).show();
+        } else if (nItemId == R.id.item_atoolbar) {
+            Intent intent = new Intent(this, TestAToolbarActivity.class);
+            startActivity(intent);
+
+        } else if (nItemId == R.id.item_asupporttoolbar) {
+            Intent intent = new Intent(this, TestASupportToolbarActivity.class);
+            startActivity(intent);
+
+        } else if (nItemId == R.id.item_colordialog) {
+            ColorPickerDialog dlg = new ColorPickerDialog(this, getResources().getColor(R.color.colorPrimary));
+            dlg.setOnColorChangedListener(new com.a4455jkjh.colorpicker.view.OnColorChangedListener() {
+
+                    @Override
+                    public void beforeColorChanged() {
+                    }
+
+                    @Override
+                    public void onColorChanged(int color) {
+
+                    }
+
+                    @Override
+                    public void afterColorChanged() {
+                    }
+
+
+                });
+            dlg.show();
+
+        } else if (nItemId ==  R.id.item_dialogstoragepath) {
+            final StoragePathDialog dialog = new StoragePathDialog(this, 0);
+            dialog.setOnOKClickListener(new View.OnClickListener() {
+                    @Override
+                    public void onClick(View v) {
+                        dialog.dismiss();
+                    }
+                });
+            dialog.show();
+
+        } else if (nItemId ==  R.id.item_localfileselectdialog) {
+            final LocalFileSelectDialog dialog = new LocalFileSelectDialog(this);
+            dialog.setOnOKClickListener(new LocalFileSelectDialog.OKClickListener() {
+                    @Override
+                    public void onOKClick(String sz) {
+                        Toast.makeText(getApplication(), sz, Toast.LENGTH_SHORT).show();
+                        //dialog.dismiss();
+                    }
+                });
+            dialog.open();
+
+        } else if (nItemId ==  R.id.item_secondarylibraryactivity) {
+            Intent intent = new Intent(this, SecondaryLibraryActivity.class);
+            startActivity(intent);
+        } else if (nItemId ==  R.id.item_drawerfragmentactivity) {
+            Intent intent = new Intent(this, TestDrawerFragmentActivity.class);
+            startActivity(intent);
+        } else if (nItemId ==  R.id.item_settings) {
+            Intent intent = new Intent(this, SettingsActivity.class);
+            startActivity(intent);
+        } else if (nItemId ==  R.id.item_about) {
+//            Intent intent = new Intent(this, AboutActivity.class);
+//            startActivity(intent);
+			WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, AboutActivity.class);
+        }
+
+
+        return super.onOptionsItemSelected(item);
+    }
+
+
+}
diff --git a/aes/src/main/java/cc/winboll/studio/aes/SettingsActivity.java b/aes/src/main/java/cc/winboll/studio/aes/SettingsActivity.java
new file mode 100644
index 0000000..1767c02
--- /dev/null
+++ b/aes/src/main/java/cc/winboll/studio/aes/SettingsActivity.java
@@ -0,0 +1,39 @@
+package cc.winboll.studio.aes;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import cc.winboll.studio.libaes.views.ADsControlView;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/26 18:01
+ * @Describe SettingsActivity
+ */
+public class SettingsActivity extends Activity {
+
+    public static final String TAG = "SettingsActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_settings);
+        ADsControlView adsControlView = (ADsControlView) findViewById(R.id.ads_control_view);
+		
+//		adsControlView.setOnAdsModeSelectedListener(new ADsControlView.OnAdsModeSelectedListener() {
+//				@Override
+//				public void onModeSelected(ADsMode selectedMode) {
+//					if (selectedMode == ADsMode.STANDALONE) {
+//						// 处理单机模式逻辑（如释放米盟资源）
+//						ToastUtils.show("STANDALONE");
+//					} else if (selectedMode == ADsMode.MIMO_SDK) {
+//						// 处理米盟SDK模式逻辑（如初始化SDK）
+//						ToastUtils.show("MIMO_SDK");
+//					}
+//				}
+//			});
+    }
+	
+}
diff --git a/aes/src/main/java/cc/winboll/studio/aes/TestActivityManagerActivity.java b/aes/src/main/java/cc/winboll/studio/aes/TestActivityManagerActivity.java
new file mode 100644
index 0000000..71d114d
--- /dev/null
+++ b/aes/src/main/java/cc/winboll/studio/aes/TestActivityManagerActivity.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.aes;
+
+import android.app.Activity;
+import android.os.Bundle;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/28 21:07
+ * @Describe 窗口管理类测试窗口
+ */
+public class TestActivityManagerActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    
+    public static final String TAG = "TestActivityManagerActivity";
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+	
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_testactivitymanager);
+        
+    }
+    
+}
diff --git a/aes/src/main/java/cc/winboll/studio/aes/WinBoLLActivity.java b/aes/src/main/java/cc/winboll/studio/aes/WinBoLLActivity.java
new file mode 100644
index 0000000..bc45765
--- /dev/null
+++ b/aes/src/main/java/cc/winboll/studio/aes/WinBoLLActivity.java
@@ -0,0 +1,60 @@
+package cc.winboll.studio.aes;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/29 00:11
+ * @Describe WinBoLL 窗口基础类
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.MenuItem;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class WinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "WinBoLLActivity";
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, String.format("onResume %s", getTag()));
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        /*if (item.getItemId() == R.id.item_log) {
+            WinBoLLActivityManager.getInstance().startLogActivity(this);
+            return true;
+        } else if (item.getItemId() == R.id.item_home) {
+			startActivity(new Intent(this, MainActivity.class));
+            return true;
+        }*/
+        // 在switch语句中处理每个ID，并在处理完后返回true，未处理的情况返回false。
+        return super.onOptionsItemSelected(item);
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        WinBoLLActivityManager.getInstance().add(this);
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        WinBoLLActivityManager.getInstance().finish(this);
+    }
+}
diff --git a/aes/src/main/res/drawable-night/bg_frame.xml b/aes/src/main/res/drawable-night/bg_frame.xml
new file mode 100644
index 0000000..bf2fe54
--- /dev/null
+++ b/aes/src/main/res/drawable-night/bg_frame.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#00000000" 
+                android:startColor="#1AFFFFFF" /> 
+            <stroke 
+                android:width="1dp" 
+                android:color="#FF666666" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/aes/src/main/res/drawable/bg_frame.xml b/aes/src/main/res/drawable/bg_frame.xml
new file mode 100644
index 0000000..2f208a6
--- /dev/null
+++ b/aes/src/main/res/drawable/bg_frame.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0FFFFFFF" 
+                android:startColor="#FFFFFFFF" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/aes/src/main/res/layout/activity_about.xml b/aes/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..5cbe3fd
--- /dev/null
+++ b/aes/src/main/res/layout/activity_about.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>
+
diff --git a/aes/src/main/res/layout/activity_settings.xml b/aes/src/main/res/layout/activity_settings.xml
new file mode 100644
index 0000000..99dee06
--- /dev/null
+++ b/aes/src/main/res/layout/activity_settings.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ADsControlView
+		android:id="@+id/ads_control_view"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="@drawable/bg_frame"
+		android:padding="10dp"/>
+
+</LinearLayout>
+
diff --git a/aes/src/main/res/layout/activity_testactivitymanager.xml b/aes/src/main/res/layout/activity_testactivitymanager.xml
new file mode 100644
index 0000000..f46d824
--- /dev/null
+++ b/aes/src/main/res/layout/activity_testactivitymanager.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="窗口管理类测试窗口"/>
+
+</LinearLayout>
+
diff --git a/aes/src/main/res/menu/toolbar_main.xml b/aes/src/main/res/menu/toolbar_main.xml
new file mode 100644
index 0000000..b87657a
--- /dev/null
+++ b/aes/src/main/res/menu/toolbar_main.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+	<item
+		android:id="@+id/item_testactivitymanager"
+		android:title="TestActivityManager"/>
+    <item
+        android:id="@+id/item_log"
+        android:title="LogActivity"/>
+    <item
+        android:id="@+id/item_colordialog"
+        android:title="ColorDialog"/>
+    <item
+        android:id="@+id/item_dialogstoragepath"
+        android:title="StoragePathDialog"/>
+
+    <item
+        android:id="@+id/item_localfileselectdialog"
+        android:title="LocalFileSelectDialog"/>
+
+    <item
+        android:id="@+id/item_atoolbar"
+        android:title="Test AToolbar"/>
+    <item
+        android:id="@+id/item_asupporttoolbar"
+        android:title="Test ASupportToolbar"/>
+    <item
+        android:id="@+id/item_atoast"
+        android:title="Test AToast"/>
+    <item
+        android:id="@+id/item_secondarylibraryactivity"
+        android:title="Test SecondaryLibraryActivity"/>
+    <item
+        android:id="@+id/item_drawerfragmentactivity"
+        android:title="Test DrawerFragmentActivity"/>
+    <item
+        android:id="@+id/item_settings"
+        android:title="Settings"/>
+	<item
+        android:id="@+id/item_about"
+        android:title="About"/>
+</menu>
diff --git a/aes/src/main/res/values-night/styles.xml b/aes/src/main/res/values-night/styles.xml
new file mode 100644
index 0000000..5ac0e76
--- /dev/null
+++ b/aes/src/main/res/values-night/styles.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="MyAESTheme" parent="AESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+    </style>
+
+    <style name="MyDebugActivityTheme" parent="Theme.AppCompat.NoActionBar">
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+        <item name="colorTittle">@color/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">@color/toolbarBackgroundColor</item>
+        <item name="colorText">@color/debugTextColor</item>
+        <item name="colorTextBackgound">@color/mainWindowBackgroundColor</item>
+        <item name="debugTextColor">@color/debugTextColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+    </style>
+</resources>
\ No newline at end of file
diff --git a/aes/src/main/res/values/colors.xml b/aes/src/main/res/values/colors.xml
new file mode 100644
index 0000000..87d3836
--- /dev/null
+++ b/aes/src/main/res/values/colors.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#FF00B322</color>
+    <color name="colorPrimaryDark">#FF005C12</color>
+    <color name="colorAccent">#FF8DFFA2</color>
+    <color name="colorText">#FFFFFB8D</color>
+</resources>
diff --git a/aes/src/main/res/values/strings.xml b/aes/src/main/res/values/strings.xml
new file mode 100644
index 0000000..664f43a
--- /dev/null
+++ b/aes/src/main/res/values/strings.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">AES</string>
+    <string name="app_description">WinBoLL AndroidX 可视化元素类库。</string>
+
+</resources>
diff --git a/aes/src/main/res/values/styles.xml b/aes/src/main/res/values/styles.xml
new file mode 100644
index 0000000..267068a
--- /dev/null
+++ b/aes/src/main/res/values/styles.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="MyAESTheme" parent="AESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+    </style>
+
+    <style name="MyDebugActivityTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+        <item name="colorTittle">@color/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">@color/toolbarBackgroundColor</item>
+        <item name="colorText">@color/debugTextColor</item>
+        <item name="colorTextBackgound">@color/mainWindowBackgroundColor</item>
+        <item name="debugTextColor">@color/debugTextColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+    </style>
+</resources>
\ No newline at end of file
diff --git a/aes/src/main/res/xml/network_security_config.xml b/aes/src/main/res/xml/network_security_config.xml
new file mode 100644
index 0000000..ee39aa4
--- /dev/null
+++ b/aes/src/main/res/xml/network_security_config.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">winboll.cc</domain>
+    </domain-config>
+</network-security-config>
diff --git a/aes/src/stage/AndroidManifest.xml b/aes/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/aes/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/aes/src/stage/res/values/strings.xml b/aes/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/aes/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/appbase/.gitignore b/appbase/.gitignore
new file mode 100644
index 0000000..42afabf
--- /dev/null
+++ b/appbase/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/appbase/README.md b/appbase/README.md
new file mode 100644
index 0000000..97cdffc
--- /dev/null
+++ b/appbase/README.md
@@ -0,0 +1,36 @@
+# APPBase
+[![](https://jitpack.io/v/ZhanGSKen/APPBase.svg)](https://jitpack.io/#ZhanGSKen/APPBase)
+
+#### 介绍
+WinBoLL 安卓手机端安卓应用开发基础类库。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh appbase
+阶段版类库发布命令 ：git pull &&bash .winboll/bashPublishLIBAddTag.sh libappbase
+
+#### 使用说明
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/appbase/app_update_description.txt b/appbase/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/appbase/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/appbase/build.gradle b/appbase/build.gradle
new file mode 100644
index 0000000..b95d796
--- /dev/null
+++ b/appbase/build.gradle
@@ -0,0 +1,50 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.appbase"
+        minSdkVersion 26
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.20"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+	
+     // 确保 Java 7 兼容性（已适配项目技术栈）
+     compileOptions {
+         sourceCompatibility JavaVersion.VERSION_1_7
+         targetCompatibility JavaVersion.VERSION_1_7
+     }
+}
+
+dependencies {
+    api project(':libappbase')
+
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/appbase/build.properties b/appbase/build.properties
new file mode 100644
index 0000000..68642b1
--- /dev/null
+++ b/appbase/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Tue May 12 09:17:15 HKT 2026
+stageCount=10
+libraryProject=libappbase
+baseVersion=15.20
+publishVersion=15.20.9
+buildCount=0
+baseBetaVersion=15.20.10
diff --git a/appbase/proguard-rules.pro b/appbase/proguard-rules.pro
new file mode 100644
index 0000000..574eeec
--- /dev/null
+++ b/appbase/proguard-rules.pro
@@ -0,0 +1,126 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（适配你的两个包名）
+#-keep public class * extends com.winboll.WinBoLLActivity
+#-keep public class * extends com.winboll.WinBoLLFragment
+# 主包名
+-keep class cc.winboll.studio.*.** { *; }
+# beta包名
+-keep class cc.winboll.studio.*.beta.** { *; }
+-keepclassmembers class cc.winboll.studio.*.** { *; }
+-keepclassmembers class cc.winboll.studio.*.beta.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架规则 ==============================
+# Retrofit + OkHttp
+-keep class retrofit2.** { *; }
+-keep interface retrofit2.** { *; }
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okio.** { *; }
+-keepclasseswithmembers class * {
+    @retrofit2.http.* <methods>;
+}
+
+# Glide 4.x
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-dontwarn com.bumptech.glide.load.resource.bitmap.VideoDecoder
+
+# GreenDAO 3.x
+-keepclassmembers class * extends org.greenrobot.greendao.AbstractDao {
+    public static java.lang.String TABLENAME;
+}
+-keep class **$Properties
+# 实体类包名（按实际调整）
+#-keep class cc.winboll.studio.appbase.model.** { *; }
+
+# ButterKnife 8.x
+-keep class butterknife.** { *; }
+-dontwarn butterknife.internal.**
+-keep class **$$ViewBinder { *; }
+-keepclasseswithmembernames class * {
+    @butterknife.BindView <fields>;
+    @butterknife.OnClick <methods>;
+}
+
+# EventBus 3.x
+-keepclassmembers class ** {
+    @org.greenrobot.eventbus.Subscribe <methods>;
+}
+-keep enum org.greenrobot.eventbus.ThreadMode { *; }
+
+# ============================== 优化与调试 ==============================
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+-optimizationpasses 5
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+# 保留行号（便于崩溃定位）
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/appbase/src/beta/AndroidManifest.xml b/appbase/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..32817e8
--- /dev/null
+++ b/appbase/src/beta/AndroidManifest.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application
+		tools:replace="android:icon"
+        android:icon="@drawable/ic_winboll_beta">
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/appbase/src/beta/res/values/strings.xml b/appbase/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..49fc4c9
--- /dev/null
+++ b/appbase/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">APPBase+</string>
+
+</resources>
diff --git a/appbase/src/main/AndroidManifest.xml b/appbase/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..4c0df09
--- /dev/null
+++ b/appbase/src/main/AndroidManifest.xml
@@ -0,0 +1,57 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.appbase">
+
+    <application
+        android:name=".App"
+        android:icon="@drawable/ic_winboll"
+        android:label="@string/app_name"
+        android:theme="@style/MyAPPBaseTheme"
+        android:resizeableActivity="true"
+        android:process=":App"
+        android:sharedUserId="@string/shared_user_id"
+        android:sharedUserLabel="@string/shared_user_label">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:resizeableActivity="true"
+            android:launchMode="singleTop"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
+
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+            </intent-filter>
+
+        </activity>
+
+
+
+        <activity
+            android:name=".Main2Activity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:resizeableActivity="true"
+            android:launchMode="singleTop"
+            android:taskAffinity="cc.winboll.studio.appbase.Main2Activity"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
+
+        </activity>
+
+        <activity android:name=".GlobalApplication$CrashActivity"/>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.CrashCopyReceiverActivity"/>
+
+        <activity android:name=".AboutActivity"/>
+
+    </application>
+
+</manifest>
diff --git a/appbase/src/main/java/cc/winboll/studio/appbase/AboutActivity.java b/appbase/src/main/java/cc/winboll/studio/appbase/AboutActivity.java
new file mode 100644
index 0000000..060bded
--- /dev/null
+++ b/appbase/src/main/java/cc/winboll/studio/appbase/AboutActivity.java
@@ -0,0 +1,50 @@
+package cc.winboll.studio.appbase;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Toolbar;
+import cc.winboll.studio.appbase.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 12:55
+ * @Describe AboutActivity
+ */
+public class AboutActivity extends Activity {
+
+    public static final String TAG = "AboutActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setActionBar(toolbar);
+
+		AboutView aboutView = findViewById(R.id.aboutview);
+		aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+	private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "appbase";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName("APPBase");
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=APPBase");
+        appInfo.setAppAPKName("APPBase");
+        appInfo.setAppAPKFolderName("APPBase");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
diff --git a/appbase/src/main/java/cc/winboll/studio/appbase/App.java b/appbase/src/main/java/cc/winboll/studio/appbase/App.java
new file mode 100644
index 0000000..9df2ed8
--- /dev/null
+++ b/appbase/src/main/java/cc/winboll/studio/appbase/App.java
@@ -0,0 +1,48 @@
+package cc.winboll.studio.appbase;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.BuildConfig;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/01/05 09:54:42
+ * @Describe 应用全局入口类（继承基础库 GlobalApplication）
+ * 负责应用初始化、全局资源管理与生命周期回调处理，是整个应用的核心入口
+ */
+public class App extends GlobalApplication {
+
+    /** 当前应用类的日志 TAG（用于调试输出，标识日志来源） */
+    public static final String TAG = "App";
+
+    /**
+     * 应用创建时回调（全局初始化入口）
+     * 在应用进程启动时执行，仅调用一次，用于初始化全局工具类、第三方库等
+     */
+    @Override
+    public void onCreate() {
+        super.onCreate();
+		// 如果应用不在调试状态，就根据编译类型设置调试状态
+		if (isDebugging() != true) {
+			setIsDebugging(BuildConfig.DEBUG);
+		}
+		// release 版调试码
+		//setIsDebugging(!BuildConfig.DEBUG);
+		
+        // 初始化 Toast 工具类（传入应用全局上下文，确保 Toast 可在任意地方调用）
+        ToastUtils.init(getApplicationContext());
+    }
+
+    /**
+     * 应用终止时回调（资源释放入口）
+     * 仅在模拟环境（如 Android Studio 模拟器）中可靠触发，真机上可能因系统回收进程不执行
+     * 用于释放全局资源，避免内存泄漏
+     */
+    @Override
+    public void onTerminate() {
+        super.onTerminate(); // 调用父类终止逻辑（如基础库资源释放）
+        // 释放 Toast 工具类资源（销毁全局 Toast 实例，避免内存泄漏）
+        ToastUtils.release();
+    }
+}
+
diff --git a/appbase/src/main/java/cc/winboll/studio/appbase/CrashTestActivity.java b/appbase/src/main/java/cc/winboll/studio/appbase/CrashTestActivity.java
new file mode 100644
index 0000000..6f2a687
--- /dev/null
+++ b/appbase/src/main/java/cc/winboll/studio/appbase/CrashTestActivity.java
@@ -0,0 +1,28 @@
+package cc.winboll.studio.appbase;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class CrashTestActivity extends Activity {
+
+    public static final String TAG = "CrashTestActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_crash_test);
+        LogUtils.d(TAG, "CrashTestActivity onCreate()");
+    }
+
+    public void onBack(View view) {
+        finish();
+    }
+
+    public void onTestCrash(View view) {
+        LogUtils.d(TAG, "onTestCrash()");
+        ToastUtils.show("测试布局崩溃...");
+    }
+}
diff --git a/appbase/src/main/java/cc/winboll/studio/appbase/Main2Activity.java b/appbase/src/main/java/cc/winboll/studio/appbase/Main2Activity.java
new file mode 100644
index 0000000..1b989f7
--- /dev/null
+++ b/appbase/src/main/java/cc/winboll/studio/appbase/Main2Activity.java
@@ -0,0 +1,20 @@
+package cc.winboll.studio.appbase;
+
+import android.os.Bundle;
+import android.widget.Toolbar;
+import cc.winboll.studio.appbase.R;
+
+public class Main2Activity extends MainActivity {
+
+    public static final String TAG = "Main2Activity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main2);
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        if (toolbar != null) {
+            setActionBar(toolbar);
+        }
+    }
+}
\ No newline at end of file
diff --git a/appbase/src/main/java/cc/winboll/studio/appbase/MainActivity.java b/appbase/src/main/java/cc/winboll/studio/appbase/MainActivity.java
new file mode 100644
index 0000000..96b99c4
--- /dev/null
+++ b/appbase/src/main/java/cc/winboll/studio/appbase/MainActivity.java
@@ -0,0 +1,177 @@
+package cc.winboll.studio.appbase;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Toolbar;
+import cc.winboll.studio.appbase.R;
+import cc.winboll.studio.appbase.model.TestBean;
+import cc.winboll.studio.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 未标注（建议补充创建日期）
+ * @Describe 应用主界面 Activity（入口界面）
+ * 包含功能测试按钮（崩溃测试、日志查看、Toast测试）、顶部工具栏（菜单功能），是应用交互的核心入口
+ */
+public class MainActivity extends Activity {
+
+    /** 当前 Activity 的日志 TAG（用于调试输出，标识日志来源） */
+    public static final String TAG = "MainActivity";
+
+    /** 顶部工具栏（用于展示标题、菜单，绑定布局中的 Toolbar 控件） */
+    private Toolbar mToolbar;
+
+    /**
+     * Activity 创建时回调（初始化界面）
+     * 在 Activity 首次创建时执行，用于加载布局、初始化控件、设置事件监听
+     * @param savedInstanceState 保存 Activity 状态的 Bundle（如屏幕旋转时的数据恢复）
+     */
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        //ToastUtils.show("onCreate"); // 显示 Activity 创建提示（调试用）
+        setContentView(R.layout.activity_main); // 加载主界面布局
+
+        // 初始化 Toolbar 并设置为 ActionBar
+        mToolbar = findViewById(R.id.toolbar);
+        setActionBar(mToolbar); // 将 Toolbar 替代系统默认 ActionBar
+		
+		initTestData();
+    }
+	
+	void initTestData() {
+		TestBean bean1 = new TestBean();
+		bean1.setTestNum1(456);
+		TestBean.saveBeanToFile(getFilesDir().getAbsolutePath() + getTestBeanRelativePath(), bean1);
+		TestBean bean2 = new TestBean();
+		bean2.setTestNum1(789);
+		TestBean.saveBeanToFile(getExternalFilesDir(null).getAbsolutePath() + getTestBeanRelativePath(), bean2);
+	}
+	
+	String getTestBeanRelativePath() {
+		return "/BaseBaen/"+TestBean.class.getName()+".json";
+	}
+
+    /**
+     * 创建菜单时回调（加载工具栏菜单）
+     * 初始化 ActionBar 菜单，加载自定义菜单布局
+     * @param menu 菜单对象（用于承载菜单项）
+     * @return true：显示菜单；false：不显示菜单
+     */
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        // 加载菜单布局（R.menu.toolbar_main 为自定义菜单文件）
+        getMenuInflater().inflate(R.menu.toolbar_main, menu);
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    /**
+     * 菜单 item 点击时回调（处理菜单事件）
+     * 响应 Toolbar 菜单项的点击事件，执行对应业务逻辑
+     * @param item 被点击的菜单项
+     * @return true：消费点击事件；false：不消费（传递给父类）
+     */
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        switch (item.getItemId()) {
+            case R.id.item_home:
+                // 点击 "首页/官网" 菜单项，唤起浏览器打开指定网站
+                openWebsiteInBrowser(this);
+                break;
+				// 可扩展其他菜单项（如设置、关于等）的处理逻辑
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    /**
+     * 崩溃测试按钮点击事件（触发应用崩溃，用于调试异常捕获）
+     * 故意执行非法操作（循环获取不存在的字符串资源），强制应用崩溃
+     * @param view 触发事件的 View（对应布局中的崩溃测试按钮）
+     */
+    public void onCrashTest(View view) {
+        // 循环从 Integer.MIN_VALUE 到 Integer.MAX_VALUE，获取不存在的字符串资源 ID，触发崩溃
+        for (int i = Integer.MIN_VALUE; i < Integer.MAX_VALUE; i++) {
+            getString(i); // i 超出资源 ID 范围，抛出 Resources.NotFoundException 导致崩溃
+        }
+    }
+
+    public void onLogTestNewTask(View view) {
+        LogActivity.startLogActivity(this, true);
+    }
+
+    /**
+     * 日志测试按钮点击事件（打开日志查看界面）
+     * 启动 LogActivity，用于查看应用运行日志
+     * @param view 触发事件的 View（对应布局中的日志测试按钮）
+     */
+    public void onLogTest(View view) {
+        LogActivity.startLogActivity(this, false);
+    }
+
+    /**
+     * Toast 工具测试按钮点击事件（测试全局 Toast 功能）
+     * 测试主线程、子线程中 Toast 的显示效果，验证 ToastUtils 的可用性
+     * @param view 触发事件的 View（对应布局中的 Toast 测试按钮）
+     */
+    public void onToastUtilsTest(View view) {
+        LogUtils.d(TAG, "onToastUtilsTest"); // 打印调试日志，标识进入 Toast 测试
+        ToastUtils.show("Hello, WinBoLL!"); // 主线程显示 Toast
+
+        // 开启子线程，延迟 2 秒后显示 Toast（测试子线程 Toast 兼容性）
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					try {
+						Thread.sleep(2000); // 线程休眠 2 秒
+						// 若 ToastUtils 已处理主线程切换，此处可直接调用；否则需通过 Handler 切换到主线程
+						ToastUtils.show("Thread.sleep(2000);ToastUtils.show...");
+					} catch (InterruptedException e) {
+						// 捕获线程中断异常（如线程被销毁时），不做处理（测试场景）
+						e.printStackTrace();
+					}
+				}
+			}).start();
+    }
+
+    /**
+     * 唤起系统默认浏览器打开指定网站（跳转至应用官网）
+     * 通过 Intent.ACTION_VIEW 隐式意图，触发浏览器打开目标 URL
+     * @param context 上下文对象（如 Activity、Application，此处为 MainActivity）
+     */
+    public void openWebsiteInBrowser(Context context) {
+        String url = "https://www.winboll.cc"; // 目标网站 URL（应用官网）
+        // 构建隐式意图：ACTION_VIEW 表示查看指定数据（Uri 为网站地址）
+        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
+        // 设置标志：在新的任务栈中启动 Activity（避免与当前应用任务栈混淆）
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 启动意图（唤起浏览器）
+        context.startActivity(intent);
+    }
+
+	public void onAboutActivity(View view) {
+        LogUtils.d(TAG, "onAboutActivity() 调用");
+        Intent aboutIntent = new Intent(getApplicationContext(), AboutActivity.class);
+        startActivity(aboutIntent);
+    }
+
+
+
+	public void onMultiInstance(View view) {
+        LogUtils.d(TAG, "onMultiInstance() 多开窗口按钮已点击");
+        ToastUtils.show("多开窗口：已启动新窗口");
+        android.content.Intent intent = new android.content.Intent(this, Main2Activity.class);
+        intent.setFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK);
+        LogUtils.d(TAG, "onMultiInstance() 准备启动Main2Activity");
+        startActivity(intent);
+        LogUtils.d(TAG, "onMultiInstance() Main2Activity已启动");
+    }
+}
+
diff --git a/appbase/src/main/java/cc/winboll/studio/appbase/model/TestBean.java b/appbase/src/main/java/cc/winboll/studio/appbase/model/TestBean.java
new file mode 100644
index 0000000..ee3e70a
--- /dev/null
+++ b/appbase/src/main/java/cc/winboll/studio/appbase/model/TestBean.java
@@ -0,0 +1,154 @@
+package cc.winboll.studio.appbase.model;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+
+/**
+ * 测试实体类
+ * 继承BaseBean实现JSON序列化/反序列化能力，提供基础int类型属性的封装与数据持久化支持
+ * 适配Java7语法，遵循BaseBean统一的反射识别、JSON读写规范
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/31 19:16:00
+ * @LastEditTime 2026/02/01 10:46:00
+ */
+public class TestBean extends BaseBean {
+
+    // ====================================== 常量定义 ======================================
+    /** 当前类的日志 TAG（用于调试输出） */
+    public static final String TAG = "TestBean";
+
+    // ====================================== 成员属性 ======================================
+    /**
+     * 测试数字属性（默认值：123）
+     * 基础int类型属性，用于测试BaseBean的JSON序列化/反序列化能力
+     */
+    private int testNum1;
+
+    // ====================================== 构造方法 ======================================
+    /**
+     * 无参构造器（默认初始化）
+     * 给testNum1赋值默认值123，满足反射实例化、JSON解析的无参构造要求
+     */
+    public TestBean() {
+        this.testNum1 = 123;
+        LogUtils.d(TAG, "TestBean无参构造器调用，testNum1默认初始化值：" + this.testNum1);
+    }
+
+    /**
+     * 有参构造器（自定义初始化）
+     * @param testNum1 测试数字初始值
+     */
+    public TestBean(int testNum1) {
+        this.testNum1 = testNum1;
+        LogUtils.d(TAG, "TestBean有参构造器调用，传入testNum1：" + testNum1);
+    }
+
+    // ====================================== Get/Set 方法 ======================================
+    /**
+     * 设置测试数字属性值
+     * @param testNum1 待设置的int类型值
+     */
+    public void setTestNum1(int testNum1) {
+        LogUtils.d(TAG, "setTestNum1调用，传入参数：" + testNum1);
+        this.testNum1 = testNum1;
+    }
+
+    /**
+     * 获取测试数字属性值
+     * @return 当前testNum1的int类型值
+     */
+    public int getTestNum1() {
+        LogUtils.d(TAG, "getTestNum1调用，返回值：" + this.testNum1);
+        return testNum1;
+    }
+
+    // ====================================== 重写父类BaseBean方法 ======================================
+    /**
+     * 重写父类方法：获取当前类的全限定名
+     * 用于BaseBean反射识别、类名匹配等统一逻辑
+     * @return 类全限定名（cc.winboll.studio.appbase.model.TestBean）
+     */
+    @Override
+    public String getName() {
+        LogUtils.d(TAG, "getName方法调用，返回类全限定名：" + TestBean.class.getName());
+        return TestBean.class.getName();
+    }
+
+    /**
+     * 重写父类方法：将当前对象序列化为JSON（持久化存储专用）
+     * 遵循BaseBean规范，先执行父类序列化逻辑，再处理子类专属字段
+     * @param jsonWriter JSON写入器（外部传入的JSON流操作实例）
+     * @throws IOException JSON写入异常（流关闭、格式错误等）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        LogUtils.d(TAG, "writeThisToJsonWriter调用，传入参数JsonWriter：" + jsonWriter);
+        // 执行父类公共字段的序列化逻辑
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化子类专属字段testNum1
+        jsonWriter.name("testNum1").value(this.getTestNum1());
+        LogUtils.d(TAG, "writeThisToJsonWriter执行完成，已序列化testNum1：" + this.getTestNum1());
+    }
+
+    /**
+     * 重写父类方法：从JSON字段初始化当前对象属性（解析JSON专用）
+     * 先让父类处理公共字段，再匹配子类专属字段，不匹配则返回false跳过
+     * @param jsonReader JSON读取器（外部传入的JSON流操作实例）
+     * @param name 当前解析的JSON字段名
+     * @return true-字段解析成功；false-字段不匹配，需跳过/父类处理
+     * @throws IOException JSON读取异常（字段类型不匹配、流中断等）
+     */
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        LogUtils.d(TAG, "initObjectsFromJsonReader调用，传入参数：name=" + name + "，JsonReader=" + jsonReader);
+        // 父类优先处理公共字段，处理成功则直接返回
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            LogUtils.d(TAG, "initObjectsFromJsonReader：字段" + name + "由父类BaseBean处理成功");
+            return true;
+        }
+        // 解析子类专属字段
+        if ("testNum1".equals(name)) {
+            this.setTestNum1(jsonReader.nextInt());
+            LogUtils.d(TAG, "initObjectsFromJsonReader：解析testNum1成功，值为：" + this.getTestNum1());
+        } else {
+            LogUtils.w(TAG, "initObjectsFromJsonReader：字段" + name + "不匹配，返回false跳过解析");
+            // 字段不匹配，返回false表示跳过
+            return false;
+        }
+        return true;
+    }
+
+    /**
+     * 重写父类方法：从JSON读取器完整解析并初始化当前对象（JSON解析入口）
+     * 负责JSON对象的开始/结束标识处理，遍历所有字段并调用字段解析方法
+     * 严格遵循writeThisToJsonWriter的序列化结构，保证解析一致性
+     * @param jsonReader JSON读取器（外部传入的JSON流操作实例）
+     * @return 解析后的当前TestBean实例（支持链式调用）
+     * @throws IOException JSON解析异常（格式错误、字段缺失、流异常等）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader调用，传入参数JsonReader：" + jsonReader);
+        // 开始解析JSON对象，与序列化结构保持一致
+        jsonReader.beginObject();
+        // 遍历所有JSON字段
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            LogUtils.d(TAG, "readBeanFromJsonReader：开始解析字段，fieldName=" + fieldName);
+            // 解析字段，不匹配则跳过该值
+            if (!this.initObjectsFromJsonReader(jsonReader, fieldName)) {
+                jsonReader.skipValue();
+                LogUtils.w(TAG, "readBeanFromJsonReader：字段" + fieldName + "解析失败，已跳过该值");
+            }
+        }
+        // 结束JSON对象解析，必须调用避免流异常
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader执行完成，JSON解析结束，当前TestBean实例testNum1：" + this.getTestNum1());
+        // 返回当前实例，支持链式调用
+        return this;
+    }
+}
+
diff --git a/appbase/src/main/res/drawable/bg_container_border.xml b/appbase/src/main/res/drawable/bg_container_border.xml
new file mode 100644
index 0000000..09c5bdf
--- /dev/null
+++ b/appbase/src/main/res/drawable/bg_container_border.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@android:color/transparent" />
+    <stroke android:width="1dp" android:color="#FFB0B0B0" />
+    <corners android:radius="?attr/borderCornerRadius" />
+</shape>
diff --git a/appbase/src/main/res/drawable/btn_light_blue.xml b/appbase/src/main/res/drawable/btn_light_blue.xml
new file mode 100644
index 0000000..58415fd
--- /dev/null
+++ b/appbase/src/main/res/drawable/btn_light_blue.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="#81C7F5"/> <!-- 浅蓝色填充 -->
+    <corners android:radius="8dp"/> <!-- 8dp 圆角 -->
+</shape>
+
diff --git a/appbase/src/main/res/layout-night/activity_about.xml b/appbase/src/main/res/layout-night/activity_about.xml
new file mode 100644
index 0000000..f8af6b0
--- /dev/null
+++ b/appbase/src/main/res/layout-night/activity_about.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/appbase/src/main/res/layout-night/activity_main.xml b/appbase/src/main/res/layout-night/activity_main.xml
new file mode 100644
index 0000000..383caad
--- /dev/null
+++ b/appbase/src/main/res/layout-night/activity_main.xml
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:padding="0dp"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:gravity="center_vertical"
+			android:spacing="12dp">
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="关于应用"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onAboutActivity"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用崩溃测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onCrashTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试（新窗口）"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTestNewTask"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用吐司测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onToastUtilsTest"
+				android:layout_margin="10dp"/>
+
+
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="多开窗口"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onMultiInstance"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/appbase/src/main/res/layout-night/activity_main2.xml b/appbase/src/main/res/layout-night/activity_main2.xml
new file mode 100644
index 0000000..7a96c0c
--- /dev/null
+++ b/appbase/src/main/res/layout-night/activity_main2.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:gravity="center"
+	android:background="@android:color/white">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Main2Activity"
+		android:textSize="24sp"
+		android:textColor="@color/gray_900"/>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/appbase/src/main/res/layout/activity_about.xml b/appbase/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..dab263a
--- /dev/null
+++ b/appbase/src/main/res/layout/activity_about.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>
+
diff --git a/appbase/src/main/res/layout/activity_crash_test.xml b/appbase/src/main/res/layout/activity_crash_test.xml
new file mode 100644
index 0000000..fed285a
--- /dev/null
+++ b/appbase/src/main/res/layout/activity_crash_test.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:padding="0dp"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:gravity="center_vertical">
+
+			<cc.winboll.studio.appbase.UndefinedCustomView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="返回"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onBack"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="测试崩溃"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onTestCrash"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>
diff --git a/appbase/src/main/res/layout/activity_main.xml b/appbase/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..383caad
--- /dev/null
+++ b/appbase/src/main/res/layout/activity_main.xml
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:padding="0dp"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:gravity="center_vertical"
+			android:spacing="12dp">
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="关于应用"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onAboutActivity"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用崩溃测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onCrashTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTest"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用日志测试（新窗口）"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onLogTestNewTask"
+				android:layout_margin="10dp"/>
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="应用吐司测试"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onToastUtilsTest"
+				android:layout_margin="10dp"/>
+
+
+
+			<Button
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="多开窗口"
+				android:textSize="16sp"
+				android:textColor="?attr/activityTextColor"
+				android:background="?attr/toolbarBackgroundColor"
+				android:paddingVertical="12dp"
+				android:layout_marginHorizontal="24dp"
+				android:onClick="onMultiInstance"
+				android:layout_margin="10dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/appbase/src/main/res/layout/activity_main2.xml b/appbase/src/main/res/layout/activity_main2.xml
new file mode 100644
index 0000000..ef00547
--- /dev/null
+++ b/appbase/src/main/res/layout/activity_main2.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:gravity="center"
+	android:background="?attr/activityBackgroundColor">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Main2Activity"
+		android:textSize="24sp"
+		android:textColor="?attr/activityTextColor"/>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/appbase/src/main/res/layout/activity_nfcrsaoperate.xml b/appbase/src/main/res/layout/activity_nfcrsaoperate.xml
new file mode 100644
index 0000000..6684a21
--- /dev/null
+++ b/appbase/src/main/res/layout/activity_nfcrsaoperate.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+    
+</LinearLayout>
\ No newline at end of file
diff --git a/appbase/src/main/res/menu/toolbar_main.xml b/appbase/src/main/res/menu/toolbar_main.xml
new file mode 100644
index 0000000..f2bc25b
--- /dev/null
+++ b/appbase/src/main/res/menu/toolbar_main.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/item_home"
+        android:title="Home"
+        android:icon="@drawable/ic_winboll"
+        android:showAsAction="always"/>
+</menu>
diff --git a/appbase/src/main/res/values-night/colors.xml b/appbase/src/main/res/values-night/colors.xml
new file mode 100644
index 0000000..baec1be
--- /dev/null
+++ b/appbase/src/main/res/values-night/colors.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#FF1B8B29</color>
+    <color name="colorPrimaryDark">#FF0A5520</color>
+    <color name="colorAccent">#FF6EE87C</color>
+    <color name="colorText">#FFB8FF7D</color>
+</resources>
\ No newline at end of file
diff --git a/appbase/src/main/res/values-night/styles.xml b/appbase/src/main/res/values-night/styles.xml
new file mode 100644
index 0000000..a03559c
--- /dev/null
+++ b/appbase/src/main/res/values-night/styles.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="MyAPPBaseTheme" parent="APPBaseTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+    </style>
+
+    <style name="MyDebugActivityTheme" parent="DebugActivityTheme">
+        <item name="colorTittle">?attr/mainWindowDarkTextColor</item>
+        <item name="colorTittleBackgound">?attr/toolbarBackgroundColor</item>
+        <item name="colorText">?attr/debugTextColor</item>
+        <item name="colorTextBackgound">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+	</style>
+</resources>
\ No newline at end of file
diff --git a/appbase/src/main/res/values/attrs.xml b/appbase/src/main/res/values/attrs.xml
new file mode 100644
index 0000000..1c8802a
--- /dev/null
+++ b/appbase/src/main/res/values/attrs.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <attr name="borderCornerRadius" format="dimension" />
+	<declare-styleable name="AboutView">
+        <attr name="app_name" format="string" />
+        <attr name="app_apkfoldername" format="string" />
+        <attr name="app_apkname" format="string" />
+        <attr name="app_gitname" format="string" />
+        <attr name="app_gitowner" format="string" />
+        <attr name="app_gitappbranch" format="string" />
+        <attr name="app_gitappsubprojectfolder" format="string" />
+        <attr name="appdescription" format="string" />
+        <attr name="appicon" format="reference" />
+        <attr name="is_adddebugtools" format="boolean" />
+    </declare-styleable>
+</resources>
diff --git a/appbase/src/main/res/values/colors.xml b/appbase/src/main/res/values/colors.xml
new file mode 100644
index 0000000..87d3836
--- /dev/null
+++ b/appbase/src/main/res/values/colors.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#FF00B322</color>
+    <color name="colorPrimaryDark">#FF005C12</color>
+    <color name="colorAccent">#FF8DFFA2</color>
+    <color name="colorText">#FFFFFB8D</color>
+</resources>
diff --git a/appbase/src/main/res/values/strings.xml b/appbase/src/main/res/values/strings.xml
new file mode 100644
index 0000000..8dcd2c7
--- /dev/null
+++ b/appbase/src/main/res/values/strings.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">APPBase</string>
+    <string name="app_description">WinBoLL 安卓手机端安卓应用开发基础类库。</string>
+    <string name="app_normal">Click here is switch to Normal APP</string>
+    <string name="app_debug">Click here is switch to APP DEBUG</string>
+	<string name="gitea_home">GITEA HOME</string>
+    <string name="app_update">APP UPDATE</string>
+</resources>
diff --git a/appbase/src/main/res/values/styles.xml b/appbase/src/main/res/values/styles.xml
new file mode 100644
index 0000000..be91a4e
--- /dev/null
+++ b/appbase/src/main/res/values/styles.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="MyAPPBaseTheme" parent="APPBaseTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+    </style>
+
+    <style name="MyDebugActivityTheme" parent="DebugActivityTheme">
+        <item name="colorTittle">?attr/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">?attr/toolbarBackgroundColor</item>
+        <item name="colorText">?attr/debugTextColor</item>
+        <item name="colorTextBackgound">?attr/mainWindowBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+	</style>
+</resources>
diff --git a/appbase/src/stage/AndroidManifest.xml b/appbase/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/appbase/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/appbase/src/stage/res/values/strings.xml b/appbase/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/appbase/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/appbase/基于_sharedUserId_+_自有签名_+_LocalBroadcastManager_跨应用通信技术文档.docx b/appbase/基于_sharedUserId_+_自有签名_+_LocalBroadcastManager_跨应用通信技术文档.docx
new file mode 100644
index 0000000..a50e177
Binary files /dev/null and b/appbase/基于_sharedUserId_+_自有签名_+_LocalBroadcastManager_跨应用通信技术文档.docx differ
diff --git a/autonfc/.gitignore b/autonfc/.gitignore
new file mode 100644
index 0000000..42afabf
--- /dev/null
+++ b/autonfc/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/autonfc/README.md b/autonfc/README.md
new file mode 100644
index 0000000..7421e1d
--- /dev/null
+++ b/autonfc/README.md
@@ -0,0 +1,34 @@
+# AutoNFC
+
+#### 介绍
+NFC 卡应用，主要管理 NFC 卡接触手机的动作响应，NFC 接触状态用于作为其他应用激活活动动作的启动令牌。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh autonfc
+
+#### 使用说明
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/autonfc/app_update_description.txt b/autonfc/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/autonfc/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/autonfc/build.gradle b/autonfc/build.gradle
new file mode 100644
index 0000000..92c012a
--- /dev/null
+++ b/autonfc/build.gradle
@@ -0,0 +1,119 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.autonfc"
+	    minSdkVersion 23
+		// 适配MIUI12
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.11"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+	
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['libs'] // 若SO库放在libs目录下
+        }
+    }
+}
+
+dependencies {
+    
+    api 'com.google.code.gson:gson:2.10.1'
+	
+	// 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// OkHttp网络请求
+     implementation 'com.squareup.okhttp3:okhttp:3.14.9'
+     // FastJSON解析
+     implementation 'com.alibaba:fastjson:1.2.76'
+    
+	// AndroidX 类库
+    /*api 'androidx.appcompat:appcompat:1.1.0'
+    //api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'*/
+	
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+
+	implementation "androidx.annotation:annotation:1.3.0"
+    implementation "androidx.core:core:1.6.0"
+    implementation "androidx.drawerlayout:drawerlayout:1.1.1"
+    implementation "androidx.preference:preference:1.1.1"
+    implementation "androidx.viewpager:viewpager:1.0.0"
+    implementation "com.google.android.material:material:1.4.0"
+    implementation "com.google.guava:guava:24.1-jre"
+    /*
+	implementation "io.noties.markwon:core:$markwonVersion"
+    implementation "io.noties.markwon:ext-strikethrough:$markwonVersion"
+    implementation "io.noties.markwon:linkify:$markwonVersion"
+    implementation "io.noties.markwon:recycler:$markwonVersion"
+	*/
+	implementation 'com.termux:terminal-emulator:0.118.0'
+	implementation 'com.termux:terminal-view:0.118.0'
+	implementation 'com.termux:termux-shared:0.118.0'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.2'
+    api 'cc.winboll.studio:libappbase:15.15.11'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.15.7'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.4'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/autonfc/build.properties b/autonfc/build.properties
new file mode 100644
index 0000000..4599e56
--- /dev/null
+++ b/autonfc/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Mon Mar 16 18:30:19 GMT 2026
+stageCount=0
+libraryProject=
+baseVersion=15.11
+publishVersion=15.0.0
+buildCount=54
+baseBetaVersion=15.0.1
diff --git a/autonfc/proguard-rules.pro b/autonfc/proguard-rules.pro
new file mode 100644
index 0000000..64b4a05
--- /dev/null
+++ b/autonfc/proguard-rules.pro
@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
\ No newline at end of file
diff --git a/autonfc/src/beta/AndroidManifest.xml b/autonfc/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/autonfc/src/beta/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/autonfc/src/beta/res/values/strings.xml b/autonfc/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..3c165aa
--- /dev/null
+++ b/autonfc/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">AutoNFC✌</string>
+
+</resources>
diff --git a/autonfc/src/main/AndroidManifest.xml b/autonfc/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..97234a5
--- /dev/null
+++ b/autonfc/src/main/AndroidManifest.xml
@@ -0,0 +1,51 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.autonfc">
+
+    <uses-permission android:name="android.permission.NFC"/>
+
+    <uses-feature
+        android:name="android.hardware.nfc"
+        android:required="true"/>
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:resizeableActivity="true"
+        android:name=".App">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+
+        <activity
+            android:name=".nfc.NFCInterfaceActivity"
+            android:launchMode="singleTop">
+            <intent-filter>
+                <action android:name="android.nfc.action.NDEF_DISCOVERED"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+                <data android:mimeType="*/*"/>
+            </intent-filter>
+        </activity>
+
+        <!-- NFC 绑定服务 -->
+        <service
+            android:name=".nfc.AutoNFCService"
+            android:exported="false"/>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+    </application>
+</manifest>
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/App.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/App.java
new file mode 100644
index 0000000..d64ac77
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/App.java
@@ -0,0 +1,344 @@
+package cc.winboll.studio.autonfc;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.res.Resources;
+import android.graphics.Typeface;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.util.Log;
+import android.view.Gravity;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+import android.widget.HorizontalScrollView;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Arrays;
+import java.util.Date;
+import java.util.LinkedHashMap;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+public class App extends GlobalApplication {
+
+    private static Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        
+        // 初始化 Toast 框架
+//        ToastUtils.init(this);
+//        // 设置 Toast 布局样式
+//        //ToastUtils.setView(R.layout.view_toast);
+//        ToastUtils.setStyle(new WhiteToastStyle());
+//        ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
+//        
+        //CrashHandler.getInstance().registerGlobal(this);
+        //CrashHandler.getInstance().registerPart(this);
+    }
+
+    public static void write(InputStream input, OutputStream output) throws IOException {
+        byte[] buf = new byte[1024 * 8];
+        int len;
+        while ((len = input.read(buf)) != -1) {
+            output.write(buf, 0, len);
+        }
+    }
+
+    public static void write(File file, byte[] data) throws IOException {
+        File parent = file.getParentFile();
+        if (parent != null && !parent.exists()) parent.mkdirs();
+
+        ByteArrayInputStream input = new ByteArrayInputStream(data);
+        FileOutputStream output = new FileOutputStream(file);
+        try {
+            write(input, output);
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static String toString(InputStream input) throws IOException {
+        ByteArrayOutputStream output = new ByteArrayOutputStream();
+        write(input, output);
+        try {
+            return output.toString("UTF-8");
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static void closeIO(Closeable... closeables) {
+        for (Closeable closeable : closeables) {
+            try {
+                if (closeable != null) closeable.close();
+            } catch (IOException ignored) {}
+        }
+    }
+
+    public static class CrashHandler {
+
+        public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+
+        private static CrashHandler sInstance;
+
+        private PartCrashHandler mPartCrashHandler;
+
+        public static CrashHandler getInstance() {
+            if (sInstance == null) {
+                sInstance = new CrashHandler();
+            }
+            return sInstance;
+        }
+
+        public void registerGlobal(Context context) {
+            registerGlobal(context, null);
+        }
+
+        public void registerGlobal(Context context, String crashDir) {
+            Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandlerImpl(context.getApplicationContext(), crashDir));
+        }
+
+        public void unregister() {
+            Thread.setDefaultUncaughtExceptionHandler(DEFAULT_UNCAUGHT_EXCEPTION_HANDLER);
+        }
+
+        public void registerPart(Context context) {
+            unregisterPart(context);
+            mPartCrashHandler = new PartCrashHandler(context.getApplicationContext());
+            MAIN_HANDLER.postAtFrontOfQueue(mPartCrashHandler);
+        }
+
+        public void unregisterPart(Context context) {
+            if (mPartCrashHandler != null) {
+                mPartCrashHandler.isRunning.set(false);
+                mPartCrashHandler = null;
+            }
+        }
+
+        private static class PartCrashHandler implements Runnable {
+
+            private final Context mContext;
+
+            public AtomicBoolean isRunning = new AtomicBoolean(true);
+
+            public PartCrashHandler(Context context) {
+                this.mContext = context;
+            }
+
+            @Override
+            public void run() {
+                while (isRunning.get()) {
+                    try {
+                        Looper.loop();
+                    } catch (final Throwable e) {
+                        e.printStackTrace();
+                        if (isRunning.get()) {
+                            MAIN_HANDLER.post(new Runnable(){
+
+                                    @Override
+                                    public void run() {
+                                        Toast.makeText(mContext, e.toString(), Toast.LENGTH_LONG).show();
+                                    }
+                                });
+                        } else {
+                            if (e instanceof RuntimeException) {
+                                throw (RuntimeException)e;
+                            } else {
+                                throw new RuntimeException(e);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        private static class UncaughtExceptionHandlerImpl implements UncaughtExceptionHandler {
+
+            private static DateFormat DATE_FORMAT = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss");
+
+            private final Context mContext;
+
+            private final File mCrashDir;
+
+            public UncaughtExceptionHandlerImpl(Context context, String crashDir) {
+                this.mContext = context;
+                this.mCrashDir = TextUtils.isEmpty(crashDir) ? new File(mContext.getExternalCacheDir(), "crash") : new File(crashDir);
+            }
+
+            @Override
+            public void uncaughtException(Thread thread, Throwable throwable) {
+                try {
+
+                    String log = buildLog(throwable);
+                    writeLog(log);
+
+                    try {
+                        Intent intent = new Intent(mContext, CrashActivity.class);
+                        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                        intent.putExtra(Intent.EXTRA_TEXT, log);
+                        mContext.startActivity(intent);
+                    } catch (Throwable e) {
+                        e.printStackTrace();
+                        writeLog(e.toString());
+                    }
+
+                    throwable.printStackTrace();
+                    android.os.Process.killProcess(android.os.Process.myPid());
+                    System.exit(0);
+
+                } catch (Throwable e) {
+                    if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+                }
+            }
+
+            private String buildLog(Throwable throwable) {
+                String time = DATE_FORMAT.format(new Date());
+
+                String versionName = "unknown";
+                long versionCode = 0;
+                try {
+                    PackageInfo packageInfo = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0);
+                    versionName = packageInfo.versionName;
+                    versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+                } catch (Throwable ignored) {}
+
+                LinkedHashMap<String, String> head = new LinkedHashMap<String, String>();
+                head.put("Time Of Crash", time);
+                head.put("Device", String.format("%s, %s", Build.MANUFACTURER, Build.MODEL));
+                head.put("Android Version", String.format("%s (%d)", Build.VERSION.RELEASE, Build.VERSION.SDK_INT));
+                head.put("App Version", String.format("%s (%d)", versionName, versionCode));
+                head.put("Kernel", getKernel());
+                head.put("Support Abis", Build.VERSION.SDK_INT >= 21 && Build.SUPPORTED_ABIS != null ? Arrays.toString(Build.SUPPORTED_ABIS): "unknown");
+                head.put("Fingerprint", Build.FINGERPRINT);
+
+                StringBuilder builder = new StringBuilder();
+
+                for (String key : head.keySet()) {
+                    if (builder.length() != 0) builder.append("\n");
+                    builder.append(key);
+                    builder.append(" :    ");
+                    builder.append(head.get(key));
+                }
+
+                builder.append("\n\n");
+                builder.append(Log.getStackTraceString(throwable));
+
+                return builder.toString(); 
+            }
+
+            private void writeLog(String log) {
+                String time = DATE_FORMAT.format(new Date());
+                File file = new File(mCrashDir, "crash_" + time + ".txt");
+                try {
+                    write(file, log.getBytes("UTF-8"));
+                } catch (Throwable e) {
+                    e.printStackTrace();
+                } 
+            }
+
+            private static String getKernel() {
+                try {
+                    return App.toString(new FileInputStream("/proc/version")).trim();
+                } catch (Throwable e) {
+                    return e.getMessage();
+                }
+            }
+        }
+    }
+
+    public static final class CrashActivity extends Activity {
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+
+            setTheme(android.R.style.Theme_DeviceDefault);
+            setTitle("App Crash");
+
+            mLog = getIntent().getStringExtra(Intent.EXTRA_TEXT);
+
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+
+            HorizontalScrollView horizontalScrollView = new HorizontalScrollView(this);
+
+            TextView textView = new TextView(this);
+            int padding = dp2px(16);
+            textView.setPadding(padding, padding, padding, padding);
+            textView.setText(mLog);
+            textView.setTextIsSelectable(true);
+            textView.setTypeface(Typeface.DEFAULT);
+            textView.setLinksClickable(true);
+
+            horizontalScrollView.addView(textView);
+            contentView.addView(horizontalScrollView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+
+            setContentView(contentView);
+        }
+
+        private void restart() {
+            Intent intent = getPackageManager().getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        private static int dp2px(float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(Menu menu) {
+            menu.add(0, android.R.id.copy, 0, android.R.string.copy)
+                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+            return super.onCreateOptionsMenu(menu);
+        }
+
+        @Override
+        public boolean onOptionsItemSelected(MenuItem item) {
+            switch (item.getItemId()) {
+                case android.R.id.copy:
+                    ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+                    return true;
+            }
+            return super.onOptionsItemSelected(item);
+        }
+
+        @Override
+        public void onBackPressed() {
+            restart();
+        }
+    }
+}
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/MainActivity.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/MainActivity.java
new file mode 100644
index 0000000..03743b7
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/MainActivity.java
@@ -0,0 +1,180 @@
+package cc.winboll.studio.autonfc;
+
+import android.app.PendingIntent;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.nfc.NfcAdapter;
+import android.os.Bundle;
+import android.os.IBinder;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.autonfc.nfc.ActionDialog;
+import cc.winboll.studio.autonfc.nfc.AutoNFCService;
+import cc.winboll.studio.autonfc.nfc.NFCInterfaceActivity;
+import cc.winboll.studio.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class MainActivity extends AppCompatActivity {
+
+    public static final String TAG = "MainActivity";
+
+    private NfcAdapter mNfcAdapter;
+    private PendingIntent mPendingIntent;
+    private AutoNFCService mService;
+    private boolean mBound = false;
+
+    // 服务连接
+    private ServiceConnection mConnection = new ServiceConnection() {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            AutoNFCService.LocalBinder binder = (AutoNFCService.LocalBinder) service;
+            mService = binder.getService();
+            mBound = true;
+            LogUtils.d(TAG, "onServiceConnected: 服务已绑定");
+
+            // 关键：把 Activity 传给 Service，用于回调
+            mService.attachActivity(MainActivity.this);
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            mBound = false;
+            mService = null;
+            LogUtils.d(TAG, "onServiceDisconnected: 服务已断开");
+        }
+    };
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+
+        // 初始化 NFC
+        mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
+        Intent nfcIntent = new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
+        mPendingIntent = PendingIntent.getActivity(this, 0, nfcIntent, 0);
+
+        LogUtils.d(TAG, "onCreate() -> NFC 监听已绑定到 MainActivity");
+    }
+
+    @Override
+    protected void onStart() {
+        super.onStart();
+        // 绑定服务
+        Intent intent = new Intent(this, AutoNFCService.class);
+        bindService(intent, mConnection, Context.BIND_AUTO_CREATE);
+        LogUtils.d(TAG, "onStart: 绑定服务");
+    }
+
+    @Override
+    protected void onStop() {
+        super.onStop();
+        // 解绑服务
+        if (mBound) {
+            unbindService(mConnection);
+            mBound = false;
+            LogUtils.d(TAG, "onStop: 解绑服务");
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume() -> 开启 NFC 前台分发");
+        if (mNfcAdapter != null) {
+            mNfcAdapter.enableForegroundDispatch(this, mPendingIntent, null, null);
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        LogUtils.d(TAG, "onPause() -> 关闭 NFC 前台分发");
+        if (mNfcAdapter != null) {
+            mNfcAdapter.disableForegroundDispatch(this);
+        }
+    }
+
+    // NFC 卡片靠近唯一入口
+    @Override
+    protected void onNewIntent(Intent intent) {
+        super.onNewIntent(intent);
+        LogUtils.d(TAG, "onNewIntent() -> 检测到 NFC 卡片");
+
+        // 把 NFC 事件交给 Service 处理
+        if (mBound && mService != null) {
+            mService.handleNfcIntent(intent);
+        } else {
+            LogUtils.e(TAG, "服务未绑定，无法处理 NFC");
+        }
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.main_menu, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int id = item.getItemId();
+
+        if (id == R.id.menu_log) {
+            LogActivity.startLogActivity(this);
+            return true;
+        }
+
+        return super.onOptionsItemSelected(item);
+    }
+
+    public void onNFCInterfaceActivity(View view) {
+        startActivity(new Intent(this, NFCInterfaceActivity.class));
+    }
+
+    // ========================= 【新增】关键方法：由 Service 回调来弹出对话框 =========================
+    /**
+     * Service 解析完 NFC 数据后，回调此方法在 Activity 中弹出对话框
+     */
+    public void showNfcActionDialog(final String nfcData) {
+        LogUtils.d(TAG, "showNfcActionDialog() ->  Activity 存活，安全弹出对话框");
+
+        // Activity 正在运行，直接弹框，绝对不会报 BadTokenException
+        final ActionDialog dialog = new ActionDialog(this);
+        dialog.setNfcData(nfcData);
+        dialog.setButtonClickListener(new ActionDialog.OnButtonClickListener() {
+				@Override
+				public void onBuildClick() {
+					LogUtils.d(TAG, "点击 Build");
+					if (mService != null) {
+						mService.executeTermuxCommand(AutoNFCService.ACTION_BUILD, nfcData);
+					}
+					dialog.dismiss();
+				}
+
+				@Override
+				public void onViewClick() {
+					LogUtils.d(TAG, "点击 View");
+					if (mService != null) {
+						mService.executeTermuxCommand(AutoNFCService.ACTION_BUILD_VIEW, nfcData);
+					}
+					dialog.dismiss();
+				}
+
+				@Override
+				public void onCancelClick() {
+					dialog.dismiss();
+				}
+			});
+
+        dialog.show();
+    }
+}
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/models/NfcTermuxCmd.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/models/NfcTermuxCmd.java
new file mode 100644
index 0000000..faab4cb
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/models/NfcTermuxCmd.java
@@ -0,0 +1,66 @@
+package cc.winboll.studio.autonfc.models;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/03/16 09:38
+ */
+public class NfcTermuxCmd {
+
+    private String script;        // 要执行的预制脚本名（如 auth.sh）
+    private String[] args;         // 脚本参数
+    private String workDir;       // 工作目录
+    private boolean background;   // 是否后台执行
+    private String resultDir;     // 结果输出目录（可为 null）
+
+    public NfcTermuxCmd() {
+    }
+
+    public NfcTermuxCmd(String script, String[] args, String workDir, boolean background, String resultDir) {
+        this.script = script;
+        this.args = args;
+        this.workDir = workDir;
+        this.background = background;
+        this.resultDir = resultDir;
+    }
+
+    public String getScript() {
+        return script;
+    }
+
+    public void setScript(String script) {
+        this.script = script;
+    }
+
+    public String[] getArgs() {
+        return args;
+    }
+
+    public void setArgs(String[] args) {
+        this.args = args;
+    }
+
+    public String getWorkDir() {
+        return workDir;
+    }
+
+    public void setWorkDir(String workDir) {
+        this.workDir = workDir;
+    }
+
+    public boolean isBackground() {
+        return background;
+    }
+
+    public void setBackground(boolean background) {
+        this.background = background;
+    }
+
+    public String getResultDir() {
+        return resultDir;
+    }
+
+    public void setResultDir(String resultDir) {
+        this.resultDir = resultDir;
+    }
+}
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/ActionDialog.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/ActionDialog.java
new file mode 100644
index 0000000..c3f65d7
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/ActionDialog.java
@@ -0,0 +1,123 @@
+package cc.winboll.studio.autonfc.nfc;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.view.View;
+import android.widget.Button;
+import android.widget.LinearLayout;
+
+import cc.winboll.studio.autonfc.R;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * 自定义对话框类，用于与用户交互，展示 NFC 相关操作选项
+ * 兼容 Java 7 语法
+ *
+ * @author 豆包&ZhanGSKen
+ * @create 2025-08-15
+ * @lastModify 2026-03-17
+ */
+public class ActionDialog extends Dialog {
+
+    private static final String TAG = "ActionDialog";
+    private String mNfcData;
+    private OnButtonClickListener mClickListener;
+
+    /**
+     * 构造函数
+     */
+    public ActionDialog(Context context) {
+        super(context);
+        initDialog();
+    }
+
+    /**
+     * 设置 NFC 数据
+     */
+    public void setNfcData(String nfcData) {
+        this.mNfcData = nfcData;
+        LogUtils.d(TAG, "setNfcData() -> " + nfcData);
+    }
+
+    /**
+     * 设置点击监听
+     */
+    public void setButtonClickListener(OnButtonClickListener listener) {
+        this.mClickListener = listener;
+    }
+
+    /**
+     * 初始化布局
+     */
+    private void initDialog() {
+        setTitle("请选择操作");
+
+        LinearLayout layout = new LinearLayout(getContext());
+        layout.setOrientation(LinearLayout.VERTICAL);
+        layout.setPadding(20, 20, 20, 20);
+
+        addButtons(layout);
+
+        setContentView(layout);
+    }
+
+    /**
+     * 添加按钮
+     */
+    private void addButtons(LinearLayout layout) {
+        // Build 按钮
+        Button btnBuild = createButton("Build", new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "点击 Build");
+					if (mClickListener != null) {
+						mClickListener.onBuildClick();
+					}
+				}
+			});
+        layout.addView(btnBuild);
+
+        // View 按钮
+        Button btnView = createButton("View", new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "点击 View");
+					if (mClickListener != null) {
+						mClickListener.onViewClick();
+					}
+				}
+			});
+        layout.addView(btnView);
+
+        // 取消按钮
+        Button btnCancel = createButton("Cancel", new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "点击 Cancel");
+					dismiss();
+				}
+			});
+        layout.addView(btnCancel);
+    }
+
+    /**
+     * 创建按钮
+     */
+    private Button createButton(String text, View.OnClickListener listener) {
+        Button button = new Button(getContext());
+        button.setText(text);
+        button.setPadding(10, 10, 10, 10);
+        button.setOnClickListener(listener);
+        return button;
+    }
+
+    /**
+     * 回调接口
+     */
+    public interface OnButtonClickListener {
+        void onBuildClick();
+        void onViewClick();
+        void onCancelClick();
+    }
+}
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/AutoNFCService.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/AutoNFCService.java
new file mode 100644
index 0000000..0addf65
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/AutoNFCService.java
@@ -0,0 +1,202 @@
+package cc.winboll.studio.autonfc.nfc;
+
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.nfc.NdefMessage;
+import android.nfc.NdefRecord;
+import android.nfc.NfcAdapter;
+import android.nfc.Tag;
+import android.nfc.tech.Ndef;
+import android.os.Binder;
+import android.os.IBinder;
+
+import cc.winboll.studio.autonfc.MainActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+import java.nio.charset.Charset;
+import java.util.Arrays;
+
+public class AutoNFCService extends Service {
+
+    public static final String TAG = "AutoNFCService";
+
+    // ================= 已修改：更新为 Beta 包名 =================
+    public static final String ACTION_BUILD = "cc.winboll.studio.winboll.termux.NfcTermuxBridgeActivity.ACTION_BUILD";
+    public static final String ACTION_BUILD_VIEW = "cc.winboll.studio.winboll.termux.NfcTermuxBridgeActivity.ACTION_BUILD_VIEW";
+
+    private final IBinder mBinder = new LocalBinder();
+    private String mNfcData;
+    private MainActivity mActivity; // 持有 Activity 引用，用于回调
+
+    // ========================= 生命周期 =========================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "onCreate() -> 服务创建");
+        // 移除：startForeground(NOTIFICATION_ID, buildNotification());
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy() -> 服务已停止");
+        mActivity = null; // 释放引用
+    }
+
+    // ========================= 服务绑定 =========================
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.d(TAG, "onBind() -> 服务被绑定");
+        return mBinder;
+    }
+
+    @Override
+    public boolean onUnbind(Intent intent) {
+        LogUtils.d(TAG, "onUnbind() -> 服务解绑");
+        // 移除：stopForeground(true);
+        stopSelf();
+        return super.onUnbind(intent);
+    }
+
+    // ========================= 对外暴露方法 =========================
+    /**
+     * 绑定 Activity，用于回调显示对话框
+     */
+    public void attachActivity(MainActivity activity) {
+        this.mActivity = activity;
+    }
+
+    /**
+     * 处理 NFC 意图
+     */
+    public void handleNfcIntent(Intent intent) {
+        LogUtils.d(TAG, "handleNfcIntent() -> 开始处理");
+
+        if (intent == null) {
+            LogUtils.e(TAG, "handleNfcIntent() -> 参数 intent 为空");
+            return;
+        }
+
+        String action = intent.getAction();
+        LogUtils.d(TAG, "handleNfcIntent() -> Action = " + action);
+
+        if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(action)
+			|| NfcAdapter.ACTION_TECH_DISCOVERED.equals(action)
+			|| NfcAdapter.ACTION_TAG_DISCOVERED.equals(action)) {
+
+            LogUtils.d(TAG, "handleNfcIntent() -> 匹配 NFC 动作");
+
+            Tag tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
+            if (tag == null) {
+                LogUtils.e(TAG, "handleNfcIntent() -> Tag 为空");
+                return;
+            }
+
+            LogUtils.d(TAG, "handleNfcIntent() -> Tag ID = " + bytesToHexString(tag.getId()));
+            LogUtils.d(TAG, "handleNfcIntent() -> Tech List = " + Arrays.toString(tag.getTechList()));
+
+            parseNdefData(tag);
+        }
+    }
+
+    // ========================= 内部业务 =========================
+    private void parseNdefData(Tag tag) {
+        LogUtils.d(TAG, "parseNdefData() -> 开始解析");
+
+        if (tag == null) return;
+
+        Ndef ndef = Ndef.get(tag);
+        if (ndef == null) {
+            LogUtils.e(TAG, "parseNdefData() -> 不支持 NDEF 格式");
+            return;
+        }
+
+        try {
+            ndef.connect();
+            NdefMessage msg = ndef.getNdefMessage();
+
+            if (msg == null || msg.getRecords() == null || msg.getRecords().length == 0) {
+                LogUtils.w(TAG, "parseNdefData() -> 卡片无数据");
+                return;
+            }
+
+            NdefRecord record = msg.getRecords()[0];
+            byte[] payload = record.getPayload();
+
+            int langLen = payload[0] & 0x3F;
+            int start = 1 + langLen;
+
+            if (start < payload.length) {
+                mNfcData = new String(payload, start, payload.length - start, Charset.forName("UTF-8"));
+                LogUtils.d(TAG, "parseNdefData() -> 读卡成功: " + mNfcData);
+
+                // 关键：回调给 Activity 弹框，此时 Activity 一定是存活状态
+                if (mActivity != null) {
+                    mActivity.showNfcActionDialog(mNfcData);
+                }
+            }
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "parseNdefData() -> 读取失败", e);
+        } finally {
+            try {
+                ndef.close();
+            } catch (Exception e) {
+                // 忽略关闭异常
+            }
+        }
+    }
+
+    /**
+     * 执行 Termux 命令
+     */
+    public void executeTermuxCommand(String action, String nfcData) {
+        LogUtils.d(TAG, "executeTermuxCommand() -> 开始执行");
+
+        if (nfcData == null || nfcData.isEmpty()) {
+            ToastUtils.show("数据错误");
+            return;
+        }
+
+        try {
+            LogUtils.d(TAG, "executeTermuxCommand() -> 发送指令: " + nfcData);
+
+            Intent bridgeIntent = new Intent(action);
+
+            // ================= 已修改：使用 Beta 包名 =================
+            bridgeIntent.setClassName(
+                "cc.winboll.studio.winboll.beta",
+                "cc.winboll.studio.winboll.termux.NfcTermuxBridgeActivity"
+            );
+
+            bridgeIntent.putExtra(Intent.EXTRA_TEXT, nfcData);
+            bridgeIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+
+            startActivity(bridgeIntent);
+            ToastUtils.show("指令已发送");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "executeTermuxCommand() -> 发送失败", e);
+            ToastUtils.show("发送失败");
+        }
+    }
+
+    // ========================= 工具方法 =========================
+    private String bytesToHexString(byte[] bytes) {
+        if (bytes == null || bytes.length == 0) return "";
+        StringBuilder sb = new StringBuilder();
+        for (byte b : bytes) {
+            sb.append(String.format("%02X", b));
+        }
+        return sb.toString();
+    }
+
+    // ========================= Binder =========================
+    public class LocalBinder extends Binder {
+        public AutoNFCService getService() {
+            return AutoNFCService.this;
+        }
+    }
+}
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NFCInterfaceActivity.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NFCInterfaceActivity.java
new file mode 100644
index 0000000..28b6f18
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NFCInterfaceActivity.java
@@ -0,0 +1,230 @@
+package cc.winboll.studio.autonfc.nfc;
+
+import android.app.Activity;
+import android.app.PendingIntent;
+import android.content.Intent;
+import android.nfc.NfcAdapter;
+import android.nfc.Tag;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.EditText;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.autonfc.R;
+import cc.winboll.studio.autonfc.models.NfcTermuxCmd;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+
+public class NFCInterfaceActivity extends Activity {
+
+    public static final String TAG = "NFCInterfaceActivity";
+
+    private EditText et_script;
+    private EditText et_args;
+    private EditText et_workDir;
+    private EditText et_background;
+    private EditText et_resultDir;
+
+    private TextView tvResult;
+    private TextView tvStatus;
+
+    private NfcAdapter mNfcAdapter;
+    private PendingIntent mNfcPendingIntent;
+    private Tag mCurrentTag;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_nfc_interface);
+        initView();
+        initNfc();
+    }
+
+    private void initView() {
+        et_script = findViewById(R.id.et_script);
+        et_args = findViewById(R.id.et_args);
+        et_workDir = findViewById(R.id.et_workDir);
+        et_background = findViewById(R.id.et_background);
+        et_resultDir = findViewById(R.id.et_resultDir);
+
+        tvResult = findViewById(R.id.tv_result);
+        tvStatus = findViewById(R.id.tv_status);
+    }
+
+    private void initNfc() {
+        mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
+
+        if (mNfcAdapter == null) {
+            tvStatus.setText("设备不支持NFC");
+            return;
+        }
+        if (!mNfcAdapter.isEnabled()) {
+            tvStatus.setText("请开启NFC");
+            return;
+        }
+
+        Intent nfcIntent = new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
+        mNfcPendingIntent = PendingIntent.getActivity(this, 0, nfcIntent, PendingIntent.FLAG_UPDATE_CURRENT);
+
+        tvStatus.setText("NFC已启动，等待卡片靠近");
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        if (mNfcAdapter != null && mNfcAdapter.isEnabled()) {
+            mNfcAdapter.enableForegroundDispatch(this, mNfcPendingIntent, null, null);
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        if (mNfcAdapter != null) {
+            mNfcAdapter.disableForegroundDispatch(this);
+        }
+        mCurrentTag = null;
+    }
+
+    @Override
+    protected void onNewIntent(Intent intent) {
+        super.onNewIntent(intent);
+        mCurrentTag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
+        if (mCurrentTag == null) return;
+
+        tvStatus.setText("卡片已连接，解析中...");
+        readNfc();
+    }
+
+    // -------------------------------------------------------------------------
+    // 读取 NFC（完全委托给工具类）
+    // -------------------------------------------------------------------------
+    private void readNfc() {
+        try {
+            NfcTermuxCmd cmd = NfcUtils.readTag(mCurrentTag);
+            if (cmd == null) {
+                tvStatus.setText("读取成功：标签为空");
+                tvResult.setText("");
+                // 清空窗体
+                clearUiFields();
+                return;
+            }
+
+            // 核心改动：读取成功后，同时更新详情显示 和 窗体输入框
+            updateUiWithCmd(cmd);
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "readNfc 失败", e);
+            tvStatus.setText("读取失败：" + e.getMessage());
+            // 出错时清空窗体
+            clearUiFields();
+        }
+    }
+
+    // -------------------------------------------------------------------------
+    // 新增：根据读取到的 Cmd 填充 UI（详情 + 窗体）
+    // -------------------------------------------------------------------------
+    private void updateUiWithCmd(NfcTermuxCmd cmd) {
+        if (cmd == null) return;
+
+        String time = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.CHINA).format(new Date());
+        String show = "【读取时间】 " + time + "\n\n"
+			+ "【解析结果】\n"
+			+ "script:    " + cmd.getScript() + "\n"
+			+ "args:      " + (cmd.getArgs() != null ? String.join(", ", cmd.getArgs()) : "[]") + "\n"
+			+ "workDir:   " + cmd.getWorkDir() + "\n"
+			+ "background: " + cmd.isBackground() + "\n"
+			+ "resultDir: " + cmd.getResultDir();
+
+        tvResult.setText(show);
+        tvStatus.setText("读取成功！");
+
+        // 👇 关键逻辑：自动填入窗体（每次读取后都会覆盖输入框）
+        et_script.setText(cmd.getScript() != null ? cmd.getScript() : "");
+        et_args.setText(cmd.getArgs() != null ? String.join(",", cmd.getArgs()) : "");
+        et_workDir.setText(cmd.getWorkDir() != null ? cmd.getWorkDir() : "");
+        et_background.setText(String.valueOf(cmd.isBackground()));
+        et_resultDir.setText(cmd.getResultDir() != null ? cmd.getResultDir() : "");
+    }
+
+    // -------------------------------------------------------------------------
+    // 辅助：清空所有输入框
+    // -------------------------------------------------------------------------
+    private void clearUiFields() {
+        et_script.setText("");
+        et_args.setText("");
+        et_workDir.setText("");
+        et_background.setText("");
+        et_resultDir.setText("");
+    }
+
+    // -------------------------------------------------------------------------
+    // 写入按钮（委托给工具类）
+    // -------------------------------------------------------------------------
+    public void onWriteClick(View view) {
+        if (mCurrentTag == null) {
+            showToast("请先靠近卡片");
+            return;
+        }
+
+        try {
+            NfcTermuxCmd cmd = buildCmdFromUI();
+            NfcUtils.writeTag(mCurrentTag, cmd);
+
+            tvStatus.setText("写入成功！");
+            showToast("写入成功");
+            readNfc(); // 写入后重读，此时会自动填入窗体
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "写入失败", e);
+            tvStatus.setText("写入失败：" + e.getMessage());
+            showToast("写入失败");
+        }
+    }
+
+    // -------------------------------------------------------------------------
+    // 填充调试数据
+    // -------------------------------------------------------------------------
+    public void onFillTestDataClick(View view) {
+        String testJson = "{\"script\":\"BuildWinBoLLProject.sh\",\"args\":[\"DebugTemp\"],\"workDir\":null,\"background\":true,\"resultDir\":null}";
+        try {
+            NfcTermuxCmd cmd = NfcUtils.jsonToCmd(testJson);
+            et_script.setText(cmd.getScript());
+            et_args.setText(cmd.getArgs() != null ? String.join(",", cmd.getArgs()) : "");
+            et_workDir.setText(cmd.getWorkDir() != null ? cmd.getWorkDir() : "");
+            et_background.setText(String.valueOf(cmd.isBackground()));
+            et_resultDir.setText(cmd.getResultDir() != null ? cmd.getResultDir() : "");
+
+            showToast("调试数据已填入");
+        } catch (Exception e) {
+            showToast("解析失败");
+        }
+    }
+
+    // -------------------------------------------------------------------------
+    // 从 UI 构建 NfcTermuxCmd
+    // -------------------------------------------------------------------------
+    private NfcTermuxCmd buildCmdFromUI() {
+        String script = et_script.getText().toString().trim();
+        String argsStr = et_args.getText().toString().trim();
+        String workDir = et_workDir.getText().toString().trim();
+        String bgStr = et_background.getText().toString().trim();
+        String resultDir = et_resultDir.getText().toString().trim();
+
+        NfcTermuxCmd cmd = new NfcTermuxCmd();
+        cmd.setScript(script);
+        cmd.setArgs(argsStr.isEmpty() ? new String[0] : argsStr.split(","));
+        cmd.setWorkDir(workDir.isEmpty() ? null : workDir);
+        cmd.setBackground("true".equalsIgnoreCase(bgStr));
+        cmd.setResultDir(resultDir.isEmpty() ? null : resultDir);
+
+        return cmd;
+    }
+
+    private void showToast(String msg) {
+        Toast.makeText(this, msg, Toast.LENGTH_SHORT).show();
+    }
+}
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NfcStateMonitor.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NfcStateMonitor.java
new file mode 100644
index 0000000..a58fead
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NfcStateMonitor.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.autonfc.nfc;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class NfcStateMonitor {
+    private static Map<String, OnNfcStateListener> sListenerMap = new HashMap<>();
+    private static boolean sIsRunning = false;
+
+    public static void startMonitor() {
+        if (sIsRunning) return;
+        sListenerMap = new HashMap<>();
+        sIsRunning = true;
+    }
+
+    public static void stopMonitor() {
+        if (!sIsRunning) return;
+        sIsRunning = false;
+        if (sListenerMap != null) {
+            sListenerMap.clear();
+            sListenerMap = null;
+        }
+    }
+
+    // 你原来的方法名：registerListener
+    public static void registerListener(String key, OnNfcStateListener listener) {
+        if (!sIsRunning || listener == null) return;
+        sListenerMap.put(key, listener);
+    }
+
+    public static void unregisterListener(String key) {
+        if (!sIsRunning || key == null) return;
+        sListenerMap.remove(key);
+    }
+
+    public static void notifyNfcConnected() {
+        if (!sIsRunning) return;
+        for (OnNfcStateListener l : sListenerMap.values()) {
+            l.onNfcConnected();
+        }
+    }
+
+    public static void notifyNfcDisconnected() {
+        if (!sIsRunning) return;
+        for (OnNfcStateListener l : sListenerMap.values()) {
+            l.onNfcDisconnected();
+        }
+    }
+
+    public static void notifyReadSuccess(String data) {
+        if (!sIsRunning) return;
+        for (OnNfcStateListener l : sListenerMap.values()) {
+            l.onNfcReadSuccess(data);
+        }
+    }
+
+    public static void notifyReadFail(String error) {
+        if (!sIsRunning) return;
+        for (OnNfcStateListener l : sListenerMap.values()) {
+            l.onNfcReadFail(error);
+        }
+    }
+
+    public static void notifyWriteSuccess() {
+        if (!sIsRunning) return;
+        for (OnNfcStateListener l : sListenerMap.values()) {
+            l.onNfcWriteSuccess();
+        }
+    }
+
+    public static void notifyWriteFail(String error) {
+        if (!sIsRunning) return;
+        for (OnNfcStateListener l : sListenerMap.values()) {
+            l.onNfcWriteFail(error);
+        }
+    }
+}
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NfcUtils.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NfcUtils.java
new file mode 100644
index 0000000..65ac597
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/NfcUtils.java
@@ -0,0 +1,136 @@
+package cc.winboll.studio.autonfc.nfc;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/03/16 14:26
+ */
+import android.nfc.NdefMessage;
+import android.nfc.NdefRecord;
+import android.nfc.Tag;
+import android.nfc.tech.Ndef;
+import com.google.gson.Gson;
+import com.google.gson.JsonSyntaxException;
+import cc.winboll.studio.autonfc.models.NfcTermuxCmd;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.nio.charset.Charset;
+import java.util.Locale;
+
+public class NfcUtils {
+
+    public static final String TAG = "NfcUtils";
+    private static Gson sGson = new Gson();
+
+    // -------------------------------------------------------------------------
+    // 读取 NFC 标签并解析为 NfcTermuxCmd
+    // -------------------------------------------------------------------------
+    public static NfcTermuxCmd readTag(Tag tag) throws Exception {
+        if (tag == null) {
+            LogUtils.e(TAG, "readTag: tag is null");
+            return null;
+        }
+
+        Ndef ndef = Ndef.get(tag);
+        if (ndef == null) {
+            LogUtils.e(TAG, "readTag: 不支持 NDEF");
+            return null;
+        }
+
+        try {
+            ndef.connect();
+            NdefMessage msg = ndef.getNdefMessage();
+            if (msg == null) return null;
+
+            NdefRecord[] records = msg.getRecords();
+            if (records == null || records.length == 0) return null;
+
+            byte[] payload = records[0].getPayload();
+            int status = payload[0] & 0xFF;
+            int langLen = status & 0x3F;
+            int start = 1 + langLen;
+
+            if (start >= payload.length) return null;
+
+            String json = new String(payload, start, payload.length - start, Charset.forName("UTF-8"));
+            LogUtils.d(TAG, "readTag: 提取 JSON -> " + json);
+
+            return sGson.fromJson(json, NfcTermuxCmd.class);
+        } finally {
+            if (ndef != null && ndef.isConnected()) {
+                ndef.close();
+            }
+        }
+    }
+
+    // -------------------------------------------------------------------------
+    // 写入 NfcTermuxCmd 到 NFC 标签
+    // -------------------------------------------------------------------------
+    public static void writeTag(Tag tag, NfcTermuxCmd cmd) throws Exception {
+        if (tag == null) throw new Exception("tag is null");
+
+        String json = sGson.toJson(cmd);
+        writeJson(tag, json);
+    }
+
+    // -------------------------------------------------------------------------
+    // 写入原始 JSON 字符串到 NFC
+    // -------------------------------------------------------------------------
+    public static void writeJson(Tag tag, String json) throws Exception {
+        if (tag == null) throw new Exception("tag is null");
+
+        Ndef ndef = Ndef.get(tag);
+        if (ndef == null) throw new Exception("标签不支持 NDEF");
+
+        try {
+            ndef.connect();
+            int maxSize = ndef.getMaxSize();
+            int realSize = json.getBytes(Charset.forName("UTF-8")).length;
+
+            if (realSize > maxSize) {
+                throw new Exception("数据过大 (" + realSize + ") > 容量 (" + maxSize + ")");
+            }
+
+            NdefRecord record = createTextRecord(json, true);
+            NdefMessage msg = new NdefMessage(new NdefRecord[]{record});
+
+            ndef.writeNdefMessage(msg);
+            LogUtils.d(TAG, "writeJson: 写入成功");
+        } finally {
+            if (ndef != null && ndef.isConnected()) {
+                ndef.close();
+            }
+        }
+    }
+
+    // -------------------------------------------------------------------------
+    // 创建 NFC 文本记录
+    // -------------------------------------------------------------------------
+    public static NdefRecord createTextRecord(String text, boolean isUtf8) {
+        byte[] langBytes = "en".getBytes(Charset.forName("US-ASCII"));
+        byte[] textBytes = text.getBytes(Charset.forName(isUtf8 ? "UTF-8" : "UTF-16"));
+
+        int status = isUtf8 ? 0 : 0x80;
+        status |= langBytes.length & 0x3F;
+
+        byte[] data = new byte[1 + langBytes.length + textBytes.length];
+        data[0] = (byte) status;
+        System.arraycopy(langBytes, 0, data, 1, langBytes.length);
+        System.arraycopy(textBytes, 0, data, 1 + langBytes.length, textBytes.length);
+
+        return new NdefRecord(NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_TEXT, new byte[0], data);
+    }
+
+    // -------------------------------------------------------------------------
+    // 辅助：JSON -> NfcTermuxCmd
+    // -------------------------------------------------------------------------
+    public static NfcTermuxCmd jsonToCmd(String json) throws JsonSyntaxException {
+        return sGson.fromJson(json, NfcTermuxCmd.class);
+    }
+
+    // -------------------------------------------------------------------------
+    // 辅助：NfcTermuxCmd -> JSON
+    // -------------------------------------------------------------------------
+    public static String cmdToJson(NfcTermuxCmd cmd) {
+        return sGson.toJson(cmd);
+    }
+}
+
diff --git a/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/OnNfcStateListener.java b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/OnNfcStateListener.java
new file mode 100644
index 0000000..4b149d5
--- /dev/null
+++ b/autonfc/src/main/java/cc/winboll/studio/autonfc/nfc/OnNfcStateListener.java
@@ -0,0 +1,11 @@
+package cc.winboll.studio.autonfc.nfc;
+
+public interface OnNfcStateListener {
+    void onNfcConnected(); // 无参数！
+    void onNfcDisconnected();
+    void onNfcReadSuccess(String data);
+    void onNfcReadFail(String error);
+    void onNfcWriteSuccess();
+    void onNfcWriteFail(String error);
+}
+
diff --git a/autonfc/src/main/res/drawable-v24/ic_launcher_foreground.xml b/autonfc/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 0000000..c7bd21d
--- /dev/null
+++ b/autonfc/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1" />
+</vector>
diff --git a/autonfc/src/main/res/drawable/ic_launcher_background.xml b/autonfc/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..d5fccc5
--- /dev/null
+++ b/autonfc/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>
diff --git a/autonfc/src/main/res/layout/activity_main.xml b/autonfc/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..a6032d0
--- /dev/null
+++ b/autonfc/src/main/res/layout/activity_main.xml
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical">
+
+	<com.google.android.material.appbar.AppBarLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+
+		<androidx.appcompat.widget.Toolbar
+			android:id="@+id/toolbar"
+			android:layout_width="match_parent"
+			android:layout_height="?attr/actionBarSize"
+			app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+	</com.google.android.material.appbar.AppBarLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:gravity="center_vertical|center_horizontal">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="NFC Interface Activity"
+			android:onClick="onNFCInterfaceActivity"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/autonfc/src/main/res/layout/activity_nfc_interface.xml b/autonfc/src/main/res/layout/activity_nfc_interface.xml
new file mode 100644
index 0000000..b7e1800
--- /dev/null
+++ b/autonfc/src/main/res/layout/activity_nfc_interface.xml
@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="vertical"
+		android:padding="16dp">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="脚本名称 script:"/>
+
+		<EditText
+			android:id="@+id/et_script"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:hint="如 auth.sh"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="8dp"
+			android:text="参数 args (逗号分隔):"/>
+
+		<EditText
+			android:id="@+id/et_args"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:hint="user1,pass123"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="8dp"
+			android:text="工作目录 workDir:"/>
+
+		<EditText
+			android:id="@+id/et_workDir"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:hint="/data/data/com.termux/files/home"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="8dp"
+			android:text="后台执行 background (true/false):"/>
+
+		<EditText
+			android:id="@+id/et_background"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="true"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="8dp"
+			android:text="结果目录 resultDir:"/>
+
+		<EditText
+			android:id="@+id/et_resultDir"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:hint="/data/data/com.termux/files/log"/>
+
+		<Button
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="16dp"
+			android:onClick="onFillTestDataClick"
+			android:text="填入调试数据 (BuildWinBoLLProject.sh)"/>
+
+		<Button
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="8dp"
+			android:onClick="onWriteClick"
+			android:text="写入 NFC (NfcTermuxCmd JSON)"/>
+
+		<TextView
+			android:id="@+id/tv_status"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="16dp"
+			android:text="状态"/>
+
+		<TextView
+			android:id="@+id/tv_result"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="16dp"
+			android:scrollbars="vertical"
+			android:textSize="14sp"/>
+
+	</LinearLayout>
+
+</ScrollView>
+
diff --git a/autonfc/src/main/res/menu/main_menu.xml b/autonfc/src/main/res/menu/main_menu.xml
new file mode 100644
index 0000000..4cbce25
--- /dev/null
+++ b/autonfc/src/main/res/menu/main_menu.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    <item
+        android:id="@+id/menu_log"
+        android:title="启动日志"/>
+</menu>
diff --git a/autonfc/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/autonfc/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/autonfc/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/autonfc/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/autonfc/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/autonfc/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/autonfc/src/main/res/mipmap-hdpi/ic_launcher.png b/autonfc/src/main/res/mipmap-hdpi/ic_launcher.png
new file mode 100644
index 0000000..a2f5908
Binary files /dev/null and b/autonfc/src/main/res/mipmap-hdpi/ic_launcher.png differ
diff --git a/autonfc/src/main/res/mipmap-hdpi/ic_launcher_round.png b/autonfc/src/main/res/mipmap-hdpi/ic_launcher_round.png
new file mode 100644
index 0000000..1b52399
Binary files /dev/null and b/autonfc/src/main/res/mipmap-hdpi/ic_launcher_round.png differ
diff --git a/autonfc/src/main/res/mipmap-mdpi/ic_launcher.png b/autonfc/src/main/res/mipmap-mdpi/ic_launcher.png
new file mode 100644
index 0000000..ff10afd
Binary files /dev/null and b/autonfc/src/main/res/mipmap-mdpi/ic_launcher.png differ
diff --git a/autonfc/src/main/res/mipmap-mdpi/ic_launcher_round.png b/autonfc/src/main/res/mipmap-mdpi/ic_launcher_round.png
new file mode 100644
index 0000000..115a4c7
Binary files /dev/null and b/autonfc/src/main/res/mipmap-mdpi/ic_launcher_round.png differ
diff --git a/autonfc/src/main/res/mipmap-xhdpi/ic_launcher.png b/autonfc/src/main/res/mipmap-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..dcd3cd8
Binary files /dev/null and b/autonfc/src/main/res/mipmap-xhdpi/ic_launcher.png differ
diff --git a/autonfc/src/main/res/mipmap-xhdpi/ic_launcher_round.png b/autonfc/src/main/res/mipmap-xhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..459ca60
Binary files /dev/null and b/autonfc/src/main/res/mipmap-xhdpi/ic_launcher_round.png differ
diff --git a/autonfc/src/main/res/mipmap-xxhdpi/ic_launcher.png b/autonfc/src/main/res/mipmap-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..8ca12fe
Binary files /dev/null and b/autonfc/src/main/res/mipmap-xxhdpi/ic_launcher.png differ
diff --git a/autonfc/src/main/res/mipmap-xxhdpi/ic_launcher_round.png b/autonfc/src/main/res/mipmap-xxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..8e19b41
Binary files /dev/null and b/autonfc/src/main/res/mipmap-xxhdpi/ic_launcher_round.png differ
diff --git a/autonfc/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/autonfc/src/main/res/mipmap-xxxhdpi/ic_launcher.png
new file mode 100644
index 0000000..b824ebd
Binary files /dev/null and b/autonfc/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ
diff --git a/autonfc/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png b/autonfc/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..4c19a13
Binary files /dev/null and b/autonfc/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png differ
diff --git a/autonfc/src/main/res/values/colors.xml b/autonfc/src/main/res/values/colors.xml
new file mode 100644
index 0000000..479769a
--- /dev/null
+++ b/autonfc/src/main/res/values/colors.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#009688</color>
+    <color name="colorPrimaryDark">#00796B</color>
+    <color name="colorAccent">#FF9800</color>
+</resources>
\ No newline at end of file
diff --git a/autonfc/src/main/res/values/strings.xml b/autonfc/src/main/res/values/strings.xml
new file mode 100644
index 0000000..21a2d6d
--- /dev/null
+++ b/autonfc/src/main/res/values/strings.xml
@@ -0,0 +1,4 @@
+<resources>
+    <string name="app_name">AutoNFC</string>
+    
+</resources>
diff --git a/autonfc/src/main/res/values/styles.xml b/autonfc/src/main/res/values/styles.xml
new file mode 100644
index 0000000..a70e242
--- /dev/null
+++ b/autonfc/src/main/res/values/styles.xml
@@ -0,0 +1,11 @@
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="MyAppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+</resources>
diff --git a/autonfc/src/stage/AndroidManifest.xml b/autonfc/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/autonfc/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/autonfc/src/stage/res/values/strings.xml b/autonfc/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/autonfc/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/build.gradle b/build.gradle
new file mode 100644
index 0000000..2cbeeae
--- /dev/null
+++ b/build.gradle
@@ -0,0 +1,104 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+buildscript {
+    repositories {
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+		
+        mavenLocal {
+            // 设置本地Maven仓库路径
+            url 'file:///sdcard/.m2/repository/'
+        }
+
+        // Nexus Maven 库地址
+        // "WinBoLL Release"
+        maven { url "https://nexus.winboll.cc/repository/maven-public/" }
+        // "WinBoLL Snapshot"
+        maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
+    }
+    dependencies {
+	    // 适配MIUI12
+        classpath 'com.android.tools.build:gradle:7.2.1' // 对应 compileSdkVersion 32
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+}
+
+allprojects {
+    repositories {
+        maven { url 'https://maven.aliyun.com/repository/public/' } 
+        maven { url 'https://maven.aliyun.com/repository/google/' }
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin/' }
+        maven { url 'https://dl.bintray.com/ppartisan/maven/' }
+        maven { url "https://clojars.org/repo/" }
+        maven { url "https://jitpack.io" }
+        mavenCentral()
+        google()
+		
+        mavenLocal {
+            // 设置本地Maven仓库路径
+            url 'file:///sdcard/.m2/repository/'
+        }
+		
+        // Nexus Maven 库地址
+        // "WinBoLL Release"
+        maven { url "https://nexus.winboll.cc/repository/maven-public/" }
+        // "WinBoLL Snapshot"
+        maven { url "https://nexus.winboll.cc/repository/maven-snapshots/" }
+    }
+    ext {
+        // 定义全局变量，常用于版本管理
+        // 变量在子模块的build.gradle中直接以： $NAME 的形式调用
+        // 定义版本管理文件
+        RootProjectDir = "${rootProject.projectDir}".replace("\\", "/")
+        bashCheckGitCommitStatusFilePath = ".winboll/bashCheckGitCommitStatus.sh"
+        bashCommitAppPublishBuildFlagInfoFilePath = ".winboll/bashCommitAppPublishBuildFlagInfo.sh"
+        
+        winbollFilePath = "winboll.properties"
+        keyPropsFilePath = "appkey.keystore"
+        // 定义 lint 输出文件
+        lintXmlReportFilePath = "build/reports/lint-results.xml"
+        lintHTMLReportFilePath = "build/reports/lint-results.html"
+        
+        // 检查编译配置文件
+        subProjectPath = "$RootProjectDir/$project.name"
+        println "Sub project path: $subProjectPath"
+        winbollBuildPropsDesc="Created by .winboll/winboll_app_build.gradle"
+        winbollBuildPropsFile = rootProject.file("$subProjectPath/build.properties")
+        winbollBuildPropsFilePath = winbollBuildPropsFile.getAbsolutePath();
+        assert(winbollBuildPropsFile.exists())
+        winbollBuildProps = new Properties()
+        // 读取编译标志位配置文件
+        winbollBuildProps.load(new FileInputStream(winbollBuildPropsFile))
+        // 读取编译标志位配置文件
+        assert (winbollBuildProps['stageCount'] != null)
+        assert (winbollBuildProps['baseVersion'] != null)
+        assert (winbollBuildProps['publishVersion'] != null)
+	    assert (winbollBuildProps['buildCount'] != null)
+    }
+    
+    afterEvaluate {
+        task cleanLintFile() {
+            dependsOn tasks.findAll { task -> task.name.startsWith('lint') }
+            doFirst {
+                // 这里是将在Lint任务开始前执行的代码
+                println "Lint task will run after this setup."
+            }
+	    }
+    }
+    
+    subprojects {
+        tasks.withType(JavaCompile) {
+            options.encoding = "UTF-8"
+        }
+	}
+}
+
+task clean(type: Delete) {
+    delete rootProject.buildDir
+}
diff --git a/contacts/README.md b/contacts/README.md
new file mode 100644
index 0000000..3a2e48f
--- /dev/null
+++ b/contacts/README.md
@@ -0,0 +1,40 @@
+# Contacts
+源码参考自：
+https://github.com/aJIEw/PhoneCallApp.git
+
+#### 介绍
+这是可以根据正则表达式匹配拦截骚扰电话的手机拨号应用。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：gradle assembleStageRelease
+
+#### 使用说明
+
+在安卓系统中需要设置两个权限允许。
+1.自启动权限允许。
+2.省电策略-无限制权限允许。
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/contacts/app_update_description.txt b/contacts/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/contacts/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/contacts/build.gradle b/contacts/build.gradle
new file mode 100644
index 0000000..7206901
--- /dev/null
+++ b/contacts/build.gradle
@@ -0,0 +1,100 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+ 	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        applicationId "cc.winboll.studio.contacts"
+        minSdkVersion 23
+		// 适配MIUI12
+        targetSdkVersion 30
+        versionCode 2
+        // versionName 更新后需要手动设置 
+        // 项目模块目录的 build.gradle 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.14" 
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+	
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+}
+
+dependencies {
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //api 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+	
+    // 权限请求框架：https://github.com/getActivity/XXPermissions
+    //api 'com.github.getActivity:XXPermissions:18.63'
+    // 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    // 拼音搜索
+    // https://mvnrepository.com/artifact/com.github.open-android/pinyin4j
+    api 'com.github.open-android:pinyin4j:2.5.0'
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+    // 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+    
+    // AndroidX 类库
+    /*implementation 'androidx.appcompat:appcompat:1.1.0'
+    implementation 'androidx.viewpager:viewpager:1.0.0'
+    implementation 'androidx.vectordrawable:vectordrawable:1.1.0'
+    implementation 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    implementation 'androidx.fragment:fragment:1.1.0'
+    implementation 'com.google.android.material:material:1.4.0'
+    */
+    api 'androidx.appcompat:appcompat:1.1.0'
+    api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.12.13'
+    api 'cc.winboll.studio:libappbase:15.14.2'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.12.9'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.14.1'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/contacts/build.properties b/contacts/build.properties
new file mode 100644
index 0000000..2cc727b
--- /dev/null
+++ b/contacts/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Sat Apr 18 21:14:59 HKT 2026
+stageCount=13
+libraryProject=
+baseVersion=15.14
+publishVersion=15.14.12
+buildCount=0
+baseBetaVersion=15.14.13
diff --git a/contacts/proguard-rules.pro b/contacts/proguard-rules.pro
new file mode 100644
index 0000000..855b18a
--- /dev/null
+++ b/contacts/proguard-rules.pro
@@ -0,0 +1,143 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+# ============================== 必要补充规则 ==============================
+# OkHttp 4.4.1 补充规则（Java 7 兼容）
+-keep class okhttp3.internal.concurrent.** { *; }
+-keep class okhttp3.internal.connection.** { *; }
+-dontwarn okhttp3.internal.concurrent.TaskRunner
+-dontwarn okhttp3.internal.connection.RealCall
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/contacts/src/beta/AndroidManifest.xml b/contacts/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..c598f4f
--- /dev/null
+++ b/contacts/src/beta/AndroidManifest.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application
+        tools:replace="android:icon"
+        android:icon="@drawable/ic_winbollbeta">
+
+        <!-- Put flavor specific code here -->
+    </application>
+
+</manifest>
+
diff --git a/contacts/src/beta/res/values/strings.xml b/contacts/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..dc3720a
--- /dev/null
+++ b/contacts/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">Contacts+</string>
+
+</resources>
diff --git a/contacts/src/main/AndroidManifest.xml b/contacts/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..3a2a347
--- /dev/null
+++ b/contacts/src/main/AndroidManifest.xml
@@ -0,0 +1,258 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.contacts">
+
+    <!-- BIND_AUTOFILL_SERVICE -->
+    <uses-permission android:name="android.permission.BIND_AUTOFILL_SERVICE"/>
+
+    <!-- 拨打电话 -->
+    <uses-permission android:name="android.permission.CALL_PHONE"/>
+
+    <!-- 读取手机状态和身份 -->
+    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
+
+    <!-- 读取电话号码 -->
+    <uses-permission android:name="android.permission.READ_PHONE_NUMBERS"/>
+
+    <!-- 修改系统设置 -->
+    <uses-permission android:name="android.permission.WRITE_SETTINGS"/>
+
+    <!-- 读取联系人 -->
+    <uses-permission android:name="android.permission.READ_CONTACTS"/>
+
+    <!-- 修改您的通讯录 -->
+    <uses-permission android:name="android.permission.WRITE_CONTACTS"/>
+
+    <!-- GET_CONTACTS -->
+    <uses-permission android:name="android.permission.GET_CONTACTS"/>
+
+    <!-- 此应用可显示在其他应用上方 -->
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
+
+    <!-- 更改您的音频设置 -->
+    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
+
+    <!-- 读取通话记录 -->
+    <uses-permission android:name="android.permission.READ_CALL_LOG"/>
+
+    <!-- 新建/修改/删除通话记录 -->
+    <uses-permission android:name="android.permission.WRITE_CALL_LOG"/>
+
+    <!-- GET_CALL_LOG -->
+    <uses-permission android:name="android.permission.GET_CALL_LOG"/>
+
+    <!-- 录音 -->
+    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
+
+    <!-- 运行前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <!-- 运行“dataSync”类型的前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC"/>
+
+    <!-- 运行“phoneCall”类型的前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL"/>
+
+    <!-- 运行“microphone”类型的前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>
+
+    <!-- BIND_CALL_SCREENING_SERVICE -->
+    <uses-permission android:name="android.permission.BIND_CALL_SCREENING_SERVICE"/>
+
+    <!-- 读取您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <!-- 修改或删除您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <!-- MANAGE_EXTERNAL_STORAGE -->
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <application
+        android:name=".App"
+        android:allowBackup="true"
+        android:icon="@drawable/ic_winboll"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:requestLegacyExternalStorage="true"
+        android:supportsRtl="true"
+        android:networkSecurityConfig="@xml/network_security_config">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity
+            android:name=".activities.CallActivity"
+            android:label="CallActivity"
+            android:launchMode="singleTask"
+            android:exported="true">
+
+        </activity>
+
+        <activity
+            android:name=".phonecallui.PhoneCallActivity"
+            android:launchMode="singleTask"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.DIAL"/>
+
+                <action android:name="android.intent.action.VIEW"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+                <category android:name="android.intent.category.BROWSABLE"/>
+
+                <data android:scheme="tel"/>
+
+            </intent-filter>
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.DIAL"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity android:name="cc.winboll.studio.contacts.activities.SettingsActivity"/>
+
+        <service
+            android:name=".services.MainService"
+            android:foregroundServiceType="dataSync"
+            android:exported="false"
+            android:stopWithTask="false"/>
+
+        <service
+            android:name=".services.AssistantService"
+            android:exported="false"
+            android:stopWithTask="false"/>
+
+        <service
+            android:name=".phonecallui.PhoneCallService"
+            android:permission="android.permission.BIND_INCALL_SERVICE"
+            android:exported="false"
+            android:stopWithTask="false">
+
+            <meta-data
+                android:name="android.telecom.IN_CALL_SERVICE_UI"
+                android:value="true"/>
+
+            <intent-filter>
+
+                <action android:name="android.telecom.InCallService"/>
+
+            </intent-filter>
+
+        </service>
+
+        <service
+            android:name=".listenphonecall.CallListenerService"
+            android:enabled="true"
+            android:exported="false"
+            android:stopWithTask="false">
+
+            <intent-filter android:priority="1000">
+
+                <action android:name=".service.CallShowService"/>
+
+            </intent-filter>
+
+        </service>
+
+        <service
+            android:name=".services.MyCallScreeningService"
+            android:permission="android.permission.BIND_CALL_SCREENING_SERVICE"
+            android:exported="true"
+            android:stopWithTask="false">
+
+            <intent-filter>
+
+                <action android:name="android.telecom.CallScreeningService"/>
+
+            </intent-filter>
+
+        </service>
+
+        <receiver
+            android:name=".receivers.MainReceiver"
+            android:stopWithTask="false">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.contacts.receivers.MainReceiver"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <receiver
+            android:name=".widgets.APPStatusWidget"
+            android:exported="true"
+            android:stopWithTask="false">
+
+            <intent-filter>
+
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
+
+                <action android:name="cc.winboll.studio.contacts.widgets.APPStatusWidget.ACTION_STATUS_ACTIVE"/>
+
+                <action android:name="cc.winboll.studio.contacts.widgets.APPStatusWidget.ACTION_STATUS_NOACTIVE"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/appwidget_provider_info"/>
+
+        </receiver>
+
+        <receiver
+            android:name=".widgets.APPStatusWidgetClickListener"
+            android:stopWithTask="false">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.contacts.widgets.APPStatusWidgetClickListener.ACTION_APPICON_CLICK"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+
+        <activity android:name="cc.winboll.studio.contacts.activities.UnitTestActivity"/>
+
+        <activity android:name="cc.winboll.studio.contacts.activities.AboutActivity"/>
+
+        <service android:name="cc.winboll.studio.contacts.services.LimitedTimeSpecialChannelService"/>
+
+    </application>
+
+</manifest>
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/ActivityStack.java b/contacts/src/main/java/cc/winboll/studio/contacts/ActivityStack.java
new file mode 100644
index 0000000..59a12dc
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/ActivityStack.java
@@ -0,0 +1,313 @@
+package cc.winboll.studio.contacts;
+
+import android.app.Activity;
+import android.os.Handler;
+import android.os.Looper;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/13 06:58:04
+ * @Describe Activity 栈管理工具，统一管理应用内 Activity 生命周期
+ * 适配：Java7 + Android API29-30 + 小米机型，优化并发安全与通话场景稳定性
+ */
+public class ActivityStack {
+    // 常量定义（核心标识+版本兼容常量）
+    public static final String TAG = "ActivityStack";
+    private static final int API_VERSION_O = 26; // Android 8.0 API26（isDestroyed适配用）
+
+    // 单例与核心成员变量（按优先级排序）
+    private static final ActivityStack INSTANCE = new ActivityStack();
+    // 替换为ArrayList+同步锁：解决CopyOnWriteArrayList迭代器不能删除的崩溃，兼顾并发安全
+    private final List<Activity> mActivityList = new ArrayList<Activity>();
+    private final Handler mMainHandler = new Handler(Looper.getMainLooper()); // 复用主线程Handler，避免内存泄漏
+
+    // 单例对外暴露方法
+    public static ActivityStack getInstance() {
+        return INSTANCE;
+    }
+
+    // 私有构造，禁止外部实例化
+    private ActivityStack() {
+        LogUtils.d(TAG, "ActivityStack 初始化完成");
+    }
+
+    // ====================== 栈基础操作（添加/移除） ======================
+    /**
+     * 添加Activity到栈中，避免重复入栈
+     * @param activity 待添加的Activity
+     */
+    public void addActivity(Activity activity) {
+        if (activity == null) {
+            LogUtils.w(TAG, "addActivity: activity is null, skip");
+            return;
+        }
+        // 同步锁：解决多线程并发添加冲突（小米机型多线程场景适配）
+        synchronized (mActivityList) {
+            if (!mActivityList.contains(activity)) {
+                mActivityList.add(activity);
+                LogUtils.d(TAG, "addActivity: " + activity.getClass().getSimpleName() + ", stack size: " + mActivityList.size());
+            }
+        }
+    }
+
+    /**
+     * 移除Activity（不销毁，用于正常退出场景）
+     * @param activity 待移除的Activity
+     */
+    public void removeActivity(Activity activity) {
+        if (activity == null) {
+            LogUtils.w(TAG, "removeActivity: activity is null, skip");
+            return;
+        }
+        synchronized (mActivityList) {
+            if (mActivityList.remove(activity)) {
+                LogUtils.d(TAG, "removeActivity: " + activity.getClass().getSimpleName() + ", stack size: " + mActivityList.size());
+            }
+        }
+    }
+
+    // ====================== Activity状态查询（获取/判断存活） ======================
+    /**
+     * 获取栈顶有效Activity（迭代遍历替代递归，避免栈溢出，适配小米多页面场景）
+     * @return 栈顶有效Activity，无则返回null
+     */
+    public Activity getTopActivity() {
+        synchronized (mActivityList) {
+            if (mActivityList.isEmpty()) {
+                LogUtils.w(TAG, "getTopActivity: stack is empty, return null");
+                return null;
+            }
+
+            Activity validTopActivity = null;
+            // 倒序遍历，优先取最顶层有效Activity，同时清理无效残留
+            for (int i = mActivityList.size() - 1; i >= 0; i--) {
+                Activity activity = mActivityList.get(i);
+                // 版本兼容校验：API26+才支持isDestroyed
+                if (activity != null && !activity.isFinishing() && (getSdkVersion() < API_VERSION_O || !activity.isDestroyed())) {
+                    validTopActivity = activity;
+                    break;
+                } else {
+                    mActivityList.remove(i);
+                    String className = (activity != null) ? activity.getClass().getSimpleName() : "null";
+                    LogUtils.w(TAG, "getTopActivity: remove invalid activity: " + className);
+                }
+            }
+
+            if (validTopActivity != null) {
+                LogUtils.d(TAG, "getTopActivity: top activity: " + validTopActivity.getClass().getSimpleName());
+            }
+            return validTopActivity;
+        }
+    }
+
+    /**
+     * 获取指定类的有效Activity实例（通话场景核心方法，判断页面是否存活）
+     * @param activityClass 目标Activity类
+     * @return 有效实例，无则返回null
+     */
+    public Activity getActivity(Class<?> activityClass) {
+        if (activityClass == null) {
+            LogUtils.w(TAG, "getActivity: activityClass is null, return null");
+            return null;
+        }
+        synchronized (mActivityList) {
+            if (mActivityList.isEmpty()) {
+                LogUtils.w(TAG, "getActivity: stack empty, return null");
+                return null;
+            }
+
+            for (Activity activity : mActivityList) {
+                if (activity != null && activity.getClass().equals(activityClass) && !activity.isFinishing() && (getSdkVersion() < API_VERSION_O || !activity.isDestroyed())) {
+                    LogUtils.d(TAG, "getActivity: find valid activity: " + activityClass.getSimpleName());
+                    return activity;
+                }
+            }
+            LogUtils.w(TAG, "getActivity: no valid activity: " + activityClass.getSimpleName());
+            return null;
+        }
+    }
+
+    /**
+     * 判断指定Activity是否存活（简化通话场景调用，避免重复判空）
+     * @param activityClass 目标Activity类
+     * @return true：存活，false：未存活
+     */
+    public boolean isActivityAlive(Class<?> activityClass) {
+        boolean isAlive = getActivity(activityClass) != null;
+        LogUtils.d(TAG, "isActivityAlive: " + activityClass.getSimpleName() + ", result: " + isAlive);
+        return isAlive;
+    }
+
+    // ====================== Activity销毁操作（单/批量/全部） ======================
+    /**
+     * 销毁栈顶Activity（主线程执行，适配小米机型线程限制）
+     */
+    public void finishTopActivity() {
+        runOnMainThread(new Runnable() {
+				@Override
+				public void run() {
+					synchronized (mActivityList) {
+						if (mActivityList.isEmpty()) {
+							LogUtils.w(TAG, "finishTopActivity: stack is empty, skip");
+							return;
+						}
+
+						// 先移除再校验，避免并发冲突（小米多线程场景适配）
+						Activity topActivity = mActivityList.remove(mActivityList.size() - 1);
+						if (topActivity == null) {
+							LogUtils.w(TAG, "finishTopActivity: top activity is null, skip");
+							return;
+						}
+
+						if (!topActivity.isFinishing() && (getSdkVersion() < API_VERSION_O || !topActivity.isDestroyed())) {
+							topActivity.finish();
+							LogUtils.d(TAG, "finishTopActivity: destroy top activity: " + topActivity.getClass().getSimpleName() + ", stack size: " + mActivityList.size());
+						}
+					}
+				}
+			});
+    }
+
+    /**
+     * 销毁指定Activity（主线程执行，避免跨线程异常）
+     * @param activity 待销毁的Activity
+     */
+    public void finishActivity(final Activity activity) {
+        runOnMainThread(new Runnable() {
+				@Override
+				public void run() {
+					if (activity == null) {
+						LogUtils.w(TAG, "finishActivity: activity is null, skip");
+						return;
+					}
+					synchronized (mActivityList) {
+						if (mActivityList.contains(activity) && !activity.isFinishing() && (getSdkVersion() < API_VERSION_O || !activity.isDestroyed())) {
+							mActivityList.remove(activity);
+							activity.finish();
+							LogUtils.d(TAG, "finishActivity: destroy activity: " + activity.getClass().getSimpleName() + ", stack size: " + mActivityList.size());
+						}
+					}
+				}
+			});
+    }
+
+    /**
+     * 销毁指定类的所有Activity（核心修复：迭代器删除崩溃，通话场景核心）
+     * @param activityClass 目标Activity类
+     */
+    public void finishActivity(final Class<?> activityClass) {
+        runOnMainThread(new Runnable() {
+				@Override
+				public void run() {
+					if (activityClass == null) {
+						LogUtils.w(TAG, "finishActivity: activityClass is null, skip");
+						return;
+					}
+					synchronized (mActivityList) {
+						if (mActivityList.isEmpty()) {
+							LogUtils.w(TAG, "finishActivity: stack empty, skip");
+							return;
+						}
+
+						// 核心修复：用索引遍历+倒序删除，替代迭代器删除（避免UnsupportedOperationException）
+						for (int i = mActivityList.size() - 1; i >= 0; i--) {
+							Activity activity = mActivityList.get(i);
+							if (activity != null && activity.getClass().equals(activityClass)) {
+								if (!activity.isFinishing() && (getSdkVersion() < API_VERSION_O || !activity.isDestroyed())) {
+									mActivityList.remove(i); // 索引删除，支持ArrayList
+									activity.finish();
+									LogUtils.d(TAG, "finishActivity: destroy class activity: " + activityClass.getSimpleName() + ", stack size: " + mActivityList.size());
+								} else {
+									mActivityList.remove(i); // 清理无效残留
+								}
+							}
+						}
+					}
+				}
+			});
+    }
+
+    /**
+     * 销毁栈中所有Activity（退出应用/清空栈场景用）
+     */
+    public void finishAllActivity() {
+        runOnMainThread(new Runnable() {
+				@Override
+				public void run() {
+					synchronized (mActivityList) {
+						if (mActivityList.isEmpty()) {
+							LogUtils.w(TAG, "finishAllActivity: stack is empty, skip");
+							return;
+						}
+
+						// 遍历销毁所有有效Activity，逐个状态校验（小米机型稳定性适配）
+						for (Activity activity : mActivityList) {
+							if (activity != null && !activity.isFinishing() && (getSdkVersion() < API_VERSION_O || !activity.isDestroyed())) {
+								activity.finish();
+								LogUtils.d(TAG, "finishAllActivity: destroy activity: " + activity.getClass().getSimpleName());
+							}
+						}
+						mActivityList.clear();
+						LogUtils.d(TAG, "finishAllActivity: all activity destroyed, stack cleared");
+					}
+				}
+			});
+    }
+
+    // ====================== 栈优化与工具方法 ======================
+    /**
+     * 清理栈中所有无效Activity（null/已销毁/已结束），优化小米机型内存占用
+     */
+    public void clearInvalidActivities() {
+        runOnMainThread(new Runnable() {
+				@Override
+				public void run() {
+					synchronized (mActivityList) {
+						if (mActivityList.isEmpty()) {
+							return;
+						}
+
+						// 倒序索引删除，避免遍历过程中索引错乱
+						for (int i = mActivityList.size() - 1; i >= 0; i--) {
+							Activity activity = mActivityList.get(i);
+							if (activity == null || activity.isFinishing() || (getSdkVersion() >= API_VERSION_O && activity.isDestroyed())) {
+								mActivityList.remove(i);
+								String className = (activity != null) ? activity.getClass().getSimpleName() : "null";
+								LogUtils.d(TAG, "clearInvalidActivities: remove invalid activity: " + className);
+							}
+						}
+						LogUtils.d(TAG, "clearInvalidActivities: done, stack size: " + mActivityList.size());
+					}
+				}
+			});
+    }
+
+    /**
+     * 确保任务在主线程执行（Activity操作必须主线程，小米机型严格限制）
+     * @param runnable 待执行任务
+     */
+    private void runOnMainThread(Runnable runnable) {
+        if (runnable == null) {
+            return;
+        }
+        // 避免不必要的线程切换，优化性能（小米机型流畅度适配）
+        if (Looper.getMainLooper() == Looper.myLooper()) {
+            runnable.run();
+        } else {
+            mMainHandler.post(runnable);
+            LogUtils.d(TAG, "runOnMainThread: post task to main thread");
+        }
+    }
+
+    /**
+     * 辅助方法：获取当前系统SDK版本（简化版本判断逻辑，统一调用）
+     * @return SDK版本号
+     */
+    private int getSdkVersion() {
+        return android.os.Build.VERSION.SDK_INT;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/App.java b/contacts/src/main/java/cc/winboll/studio/contacts/App.java
new file mode 100644
index 0000000..05e51ac
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/App.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.contacts;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/12/08 15:10:51
+ * @Describe 全局应用类
+ */
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class App extends GlobalApplication {
+
+    public static final String TAG = "App";
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+		// 设置应用调试标志
+        setIsDebugging(BuildConfig.DEBUG);
+
+		// 初始化窗口管理类
+		WinBoLLActivityManager.init(this);
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+    }
+
+	@Override
+	public void onTerminate() {
+		super.onTerminate();
+		ToastUtils.release();
+	}
+}
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/MainActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/MainActivity.java
new file mode 100644
index 0000000..b997cf5
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/MainActivity.java
@@ -0,0 +1,529 @@
+package cc.winboll.studio.contacts;
+
+import android.Manifest;
+import android.app.Activity;
+import android.app.ActivityManager;
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+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.telecom.TelecomManager;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.CheckBox;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.Toast;
+import androidx.appcompat.widget.Toolbar;
+import androidx.fragment.app.Fragment;
+import androidx.fragment.app.FragmentManager;
+import androidx.fragment.app.FragmentPagerAdapter;
+import androidx.viewpager.widget.ViewPager;
+import cc.winboll.studio.contacts.activities.SettingsActivity;
+import cc.winboll.studio.contacts.activities.WinBollActivity;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.contacts.fragments.CallLogFragment;
+import cc.winboll.studio.contacts.fragments.ContactsFragment;
+import cc.winboll.studio.contacts.fragments.LogFragment;
+import cc.winboll.studio.contacts.model.MainServiceBean;
+import cc.winboll.studio.contacts.services.MainService;
+import cc.winboll.studio.contacts.utils.PermissionUtils;
+import cc.winboll.studio.contacts.views.DunTemperatureView;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+import com.google.android.material.tabs.TabLayout;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/08/30 14:32
+ * @Describe Contacts 主窗口（完全适配 API 30 + Java 7 语法）
+ * 核心优化：1. 移除电话状态监听 2. 移除通话筛选服务 3. 移除 MainService 所有相关逻辑 4. ViewPager 实现 Fragment 懒加载（仅首屏初始化）
+ * 问题修复：解决首屏 Fragment 空白问题（删除 setPrimaryItem 冲突逻辑+延迟首屏初始化）
+ */
+public final class MainActivity extends WinBollActivity implements IWinBoLLActivity, ViewPager.OnPageChangeListener, View.OnClickListener {
+
+    // ====================== 1. 常量定义区（硬编码API版本，避免高版本依赖） ======================
+    public static final String TAG = "MainActivity";
+    public static final int REQUEST_HOME_ACTIVITY = 0;
+    public static final int REQUEST_ABOUT_ACTIVITY = 1;
+    public static final int REQUEST_APP_SETTINGS = 2;
+    public static final String ACTION_SOS = "cc.winboll.studio.libappbase.WinBoLL.ACTION_SOS";
+    private static final int DIALER_REQUEST_CODE = 1;
+    private static final int REQUEST_REQUIRED_PERMISSIONS = 1002;
+    private static final int REQUEST_OVERLAY_PERMISSION = 1003;
+
+    // API版本硬编码常量（Java 7兼容，杜绝Build.VERSION_CODES高版本引用）
+    private static final int ANDROID_6_API = 23;
+    private static final int ANDROID_8_API = 26;
+    private static final int ANDROID_10_API = 29;
+    private static final int ANDROID_14_API = 34;
+
+    // ====================== 2. 静态成员区 ======================
+    static MainActivity _MainActivity;
+
+    // ====================== 3. 权限常量区 ======================
+    private final String[] REQUIRED_PERMISSIONS = PermissionUtils.BASE_PERMISSIONS;
+
+    // ====================== 4. UI控件成员区 ======================
+    private ADsBannerView mADsBannerView;
+    private LogView mLogView;
+    private Toolbar mToolbar;
+    private CheckBox cbMainService;
+    private TabLayout tabLayout;
+    private ViewPager viewPager;
+    private List<View> views;
+    private ImageView[] imageViews;
+    private LinearLayout linearLayout;
+
+    // ====================== 5. 业务逻辑成员区 ======================
+    private int currentPoint = 0;
+    private List<Fragment> fragmentList;
+    private List<String> tabTitleList;
+    // 记录已初始化的Fragment位置（避免重复初始化）
+    private boolean[] isFragmentInit;
+
+    // ====================== 6. 接口实现区 ======================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ====================== 7. 生命周期函数区 ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "===== onCreate: 主Activity开始创建 =====");
+        _MainActivity = this;
+
+        // 直接初始化UI（原权限检查逻辑注释保留，按需启用）
+        initUIAndLogic(savedInstanceState);
+
+		MainServiceBean mainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+		if (mainServiceBean != null && mainServiceBean.isEnable()) {
+			Intent intent = new Intent(this, MainService.class);
+			// 根据应用前后台状态选择启动方式（Android 12+ 后台用 startForegroundService）
+			if (Build.VERSION.SDK_INT >= 31) {
+				startForegroundService(intent);
+			} else {
+				startService(intent);
+			}
+		}
+        LogUtils.d(TAG, "===== onCreate: 主Activity创建流程结束 =====");
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        LogUtils.d(TAG, "onPostCreate: 主Activity创建完成");
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        if (mADsBannerView != null) {
+            mADsBannerView.resumeADs(MainActivity.this);
+            LogUtils.d(TAG, "onResume: 广告栏资源已恢复");
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "===== onDestroy: 主Activity开始销毁 =====");
+        // 释放广告资源
+        if (mADsBannerView != null) {
+            mADsBannerView.releaseAdResources();
+            LogUtils.d(TAG, "onDestroy: 广告栏资源已释放");
+        }
+        // 清空Fragment相关引用，避免内存泄漏
+        if (fragmentList != null) {
+            fragmentList.clear();
+            fragmentList = null;
+        }
+        if (tabTitleList != null) {
+            tabTitleList.clear();
+            tabTitleList = null;
+        }
+        isFragmentInit = null;
+        LogUtils.d(TAG, "===== onDestroy: 主Activity销毁完成 =====");
+    }
+
+    // ====================== 8. 权限相关回调函数区 ======================
+    @Override
+    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        LogUtils.d(TAG, "onRequestPermissionsResult: 权限请求回调，requestCode=" + requestCode);
+
+        if (requestCode == REQUEST_REQUIRED_PERMISSIONS) {
+            String deniedPerms = PermissionUtils.getDeniedPermissions(this, permissions);
+            if (deniedPerms.length() == 0) {
+                LogUtils.d(TAG, "onRequestPermissionsResult: 所有危险权限授予成功");
+                checkAndRequestRemainingPermissions();
+            } else {
+                LogUtils.e(TAG, "onRequestPermissionsResult: 被拒权限：" + deniedPerms);
+                showPermissionDeniedDialogAndExit("应用需要「" + deniedPerms + "」权限才能正常运行，请授予权限后重新打开应用。");
+            }
+        }
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        LogUtils.d(TAG, "onActivityResult: 页面回调触发，requestCode=" + requestCode + "，resultCode=" + resultCode);
+
+        switch (requestCode) {
+            case DIALER_REQUEST_CODE:
+                if (resultCode == Activity.RESULT_OK) {
+                    LogUtils.d(TAG, "onActivityResult: 设为默认拨号应用成功");
+                    Toast.makeText(MainActivity.this, getString(R.string.app_name) + " 已成为默认电话应用", Toast.LENGTH_SHORT).show();
+                }
+                break;
+            case REQUEST_APP_SETTINGS:
+                LogUtils.d(TAG, "onActivityResult: 从设置页返回，重建Activity");
+                recreate();
+                break;
+            case REQUEST_OVERLAY_PERMISSION:
+                handleOverlayPermissionResult();
+                break;
+            default:
+                LogUtils.w(TAG, "onActivityResult: 未知requestCode=" + requestCode);
+                break;
+        }
+    }
+
+    /**
+     * 处理悬浮窗权限申请结果
+     */
+    private void handleOverlayPermissionResult() {
+        if (PermissionUtils.isOverlayPermissionGranted(this)) {
+            LogUtils.d(TAG, "handleOverlayPermissionResult: 悬浮窗权限申请成功");
+            LogUtils.d(TAG, "handleOverlayPermissionResult: 所有权限已授予");
+            initUIAndLogic(null);
+        } else {
+            LogUtils.e(TAG, "handleOverlayPermissionResult: 悬浮窗权限申请失败");
+            showPermissionDeniedDialogAndExit("应用需要悬浮窗权限才能展示来电弹窗，请授予后重新打开应用。");
+        }
+    }
+
+    /**
+     * 检查并申请剩余权限（仅保留悬浮窗）
+     */
+    private void checkAndRequestRemainingPermissions() {
+        if (!PermissionUtils.isOverlayPermissionGranted(this)) {
+            LogUtils.d(TAG, "checkAndRequestRemainingPermissions: 悬浮窗权限未授予，跳转设置页");
+            PermissionUtils.requestOverlayPermission(this, REQUEST_OVERLAY_PERMISSION);
+        } else {
+            LogUtils.d(TAG, "checkAndRequestRemainingPermissions: 所有权限已授予");
+            initUIAndLogic(null);
+        }
+    }
+
+    /**
+     * 权限拒绝提示对话框（Java 7 匿名内部类实现，禁止Lambda）
+     */
+    private void showPermissionDeniedDialogAndExit(String tip) {
+        LogUtils.d(TAG, "showPermissionDeniedDialogAndExit: 弹出权限不足提示框");
+        AlertDialog.Builder builder = new AlertDialog.Builder(this);
+        builder.setTitle("权限不足，无法使用");
+        builder.setMessage(tip);
+        builder.setCancelable(false);
+
+        builder.setNegativeButton("去设置", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+					LogUtils.d(TAG, "showPermissionDeniedDialogAndExit: 用户选择去设置权限");
+					PermissionUtils.goAppDetailsSettings(MainActivity.this);
+				}
+			});
+
+        builder.setPositiveButton("确定退出", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+					LogUtils.d(TAG, "showPermissionDeniedDialogAndExit: 用户选择退出应用");
+					finishAndRemoveTask();
+				}
+			});
+
+        builder.show();
+    }
+
+    // ====================== 9. UI与业务逻辑初始化区 ======================
+    private void initUIAndLogic(Bundle savedInstanceState) {
+        if (mToolbar != null) {
+            LogUtils.d(TAG, "initUIAndLogic: UI已初始化，无需重复执行");
+            return;
+        }
+
+        LogUtils.d(TAG, "===== initUIAndLogic: 开始初始化UI与业务逻辑 =====");
+        setContentView(R.layout.activity_main);
+
+        // 1. 工具栏初始化
+        mToolbar = (Toolbar) findViewById(R.id.activitymainToolbar1);
+        setSupportActionBar(mToolbar);
+        getSupportActionBar().setSubtitle(TAG);
+        LogUtils.d(TAG, "initUIAndLogic: 工具栏初始化完成");
+
+        // 2. TabLayout与ViewPager初始化
+        tabLayout = (TabLayout) findViewById(R.id.tabLayout);
+        viewPager = (ViewPager) findViewById(R.id.viewPager);
+        initViewPagerAndTabs();
+        tabLayout.setupWithViewPager(viewPager);
+        LogUtils.d(TAG, "initUIAndLogic: ViewPager与TabLayout初始化完成");
+
+        // 3. 广告栏初始化
+        mADsBannerView = (ADsBannerView) findViewById(R.id.adsbanner);
+        LogUtils.d(TAG, "initUIAndLogic: 广告栏控件初始化完成");
+
+        // 左边盾值视图初始化（Java7分步写法，禁止链式调用）
+        DunTemperatureView tempViewLeft = (DunTemperatureView) findViewById(R.id.dun_temp_view_left);
+        tempViewLeft.setMaxValue(Rules.getInstance(this).getSettingsModel().getDunTotalCount());
+        tempViewLeft.setCurrentValue(Rules.getInstance(this).getSettingsModel().getDunCurrentCount());
+
+        int[] customColors = new int[2];
+        customColors[0] = Color.parseColor("#FF3366FF");
+        customColors[1] = Color.parseColor("#FF9900CC");
+        float[] positions = new float[2];
+        positions[0] = 0.0f;
+        positions[1] = 1.0f;
+        tempViewLeft.setGradientColors(customColors, positions);
+        // 文本放在温度条右侧（默认，可省略）
+        tempViewLeft.setTextPosition(true);
+        // 右边盾值视图初始化（Java7分步写法，禁止链式调用）
+        DunTemperatureView tempViewRight = (DunTemperatureView) findViewById(R.id.dun_temp_view_right);
+        tempViewRight.setMaxValue(Rules.getInstance(this).getSettingsModel().getDunTotalCount());
+        tempViewRight.setCurrentValue(Rules.getInstance(this).getSettingsModel().getDunCurrentCount());
+
+        tempViewRight.setGradientColors(customColors, positions);
+        // 文本放在温度条左侧
+        tempViewRight.setTextPosition(false);
+        LogUtils.d(TAG, "initUIAndLogic: 盾值视图初始化完成");
+        LogUtils.d(TAG, "===== initUIAndLogic: 初始化流程全部结束 =====");
+    }
+
+    /**
+     * 初始化ViewPager与Tab数据（Java7规范，泛型完整声明），添加懒加载标记
+     * 关键修改：延迟50ms初始化首屏，确保Fragment控件就绪；删除setPrimaryItem冲突逻辑
+     */
+    private void initViewPagerAndTabs() {
+        LogUtils.d(TAG, "initViewPagerAndTabs: 开始初始化ViewPager数据");
+        fragmentList = new ArrayList<Fragment>();
+        tabTitleList = new ArrayList<String>();
+
+        // 添加Fragment实例（仅创建对象，不初始化业务逻辑）
+        fragmentList.add(CallLogFragment.newInstance(0));
+        fragmentList.add(ContactsFragment.newInstance(1));
+        fragmentList.add(LogFragment.newInstance(2));
+        tabTitleList.add("通话记录");
+        tabTitleList.add("联系人");
+        tabTitleList.add("应用日志");
+
+        // 初始化懒加载标记数组（默认均未初始化）
+        int fragmentCount = fragmentList.size();
+        isFragmentInit = new boolean[fragmentCount];
+        for (int i = 0; i < fragmentCount; i++) {
+            isFragmentInit[i] = false;
+        }
+
+        // 设置自定义适配器（已删除setPrimaryItem，避免初始化冲突）
+        LazyLoadPagerAdapter adapter = new LazyLoadPagerAdapter(getSupportFragmentManager(), fragmentList, tabTitleList);
+        viewPager.setAdapter(adapter);
+        // 关闭预加载（设为0仅加载当前页，关键）
+        viewPager.setOffscreenPageLimit(0);
+        viewPager.addOnPageChangeListener(this);
+
+        // 关键优化：延迟50ms初始化首屏（确保Fragment已完成onCreateView，控件绑定就绪）
+        new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					initFragmentByPosition(0);
+					LogUtils.d(TAG, "initViewPagerAndTabs: 延迟初始化首屏Fragment，位置=0");
+				}
+			}, 50);
+
+        LogUtils.d(TAG, "initViewPagerAndTabs: ViewPager初始化完成，等待延迟初始化首屏");
+    }
+
+    /**
+     * 根据位置初始化Fragment（调用Fragment的初始化逻辑，避免重复执行）
+     * 优化：添加isAdded判断，确保Fragment已附加到Activity，防止上下文空指针
+     */
+    private void initFragmentByPosition(int position) {
+        // 校验位置合法性 + 避免重复初始化 + 确保Fragment已附加到Activity
+        if (position < 0 || position >= fragmentList.size() || isFragmentInit[position]) {
+            return;
+        }
+        Fragment targetFragment = fragmentList.get(position);
+        if (targetFragment != null && targetFragment.isAdded()) {
+            // 触发Fragment初始化（调用各Fragment的initData方法）
+            if (targetFragment instanceof CallLogFragment) {
+                ((CallLogFragment) targetFragment).initData();
+            } else if (targetFragment instanceof ContactsFragment) {
+                ((ContactsFragment) targetFragment).initData();
+            } else if (targetFragment instanceof LogFragment) {
+                ((LogFragment) targetFragment).initData();
+            }
+            // 标记为已初始化
+            isFragmentInit[position] = true;
+            LogUtils.d(TAG, "initFragmentByPosition: 初始化Fragment，位置=" + position + "，标题=" + tabTitleList.get(position));
+        } else {
+            LogUtils.w(TAG, "initFragmentByPosition: Fragment未附加到Activity/实例为空，位置=" + position);
+        }
+    }
+
+    // ====================== 10. 菜单相关函数区 ======================
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.toolbar_main, menu);
+        LogUtils.d(TAG, "onCreateOptionsMenu: 菜单加载完成");
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (item.getItemId() == R.id.item_settings) {
+            LogUtils.d(TAG, "onOptionsItemSelected: 用户点击设置菜单");
+            startActivity(new Intent(this, SettingsActivity.class));
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    // ====================== 11. ViewPager页面回调区（切换时初始化对应Fragment） ======================
+    @Override
+    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {}
+
+    @Override
+    public void onPageSelected(int position) {
+        currentPoint = position;
+        LogUtils.d(TAG, "onPageSelected: 页面切换至[" + position + "]，标题=" + tabTitleList.get(position));
+        // 切换页面时，初始化当前页Fragment（未初始化过才执行）
+        initFragmentByPosition(position);
+    }
+
+    @Override
+    public void onPageScrollStateChanged(int state) {}
+
+    @Override
+    public void onClick(View v) {}
+
+    // ====================== 12. 工具函数区 ======================
+    /**
+     * 拨号工具方法（添加空指针防护）
+     */
+    public static void dialPhoneNumber(String phoneNumber) {
+        if (_MainActivity == null) {
+            LogUtils.e(TAG, "dialPhoneNumber: MainActivity实例为空，无法拨号");
+            return;
+        }
+        if (phoneNumber == null || phoneNumber.trim().isEmpty()) {
+            LogUtils.e(TAG, "dialPhoneNumber: 拨号号码为空");
+            return;
+        }
+        if (PermissionUtils.checkPermission(_MainActivity, Manifest.permission.CALL_PHONE)) {
+            Intent intent = new Intent(Intent.ACTION_DIAL);
+            intent.setData(Uri.parse("tel:" + phoneNumber));
+            LogUtils.d(TAG, "dialPhoneNumber: 发起拨号，号码=" + phoneNumber);
+            _MainActivity.startActivity(intent);
+        } else {
+            LogUtils.e(TAG, "dialPhoneNumber: 拨号权限不足，无法发起拨号");
+            Toast.makeText(_MainActivity, "拨号权限不足", Toast.LENGTH_SHORT).show();
+        }
+    }
+
+    /**
+     * 判断是否为默认拨号应用（适配API30，硬编码版本判断）
+     */
+    public boolean isDefaultPhoneCallApp() {
+        if (Build.VERSION.SDK_INT >= ANDROID_6_API) {
+            TelecomManager manager = (TelecomManager) getSystemService(Context.TELECOM_SERVICE);
+            if (manager != null && manager.getDefaultDialerPackage() != null) {
+                boolean isDefault = manager.getDefaultDialerPackage().equals(getPackageName());
+                LogUtils.d(TAG, "isDefaultPhoneCallApp: 是否为默认拨号应用=" + isDefault);
+                return isDefault;
+            }
+        }
+        LogUtils.d(TAG, "isDefaultPhoneCallApp: 系统版本低于Android 6，无法判断");
+        return false;
+    }
+
+    /**
+     * 检查服务是否正在运行（通用工具方法，添加空指针防护）
+     */
+    public boolean isServiceRunning(Class<?> serviceClass) {
+        if (serviceClass == null) {
+            LogUtils.e(TAG, "isServiceRunning: 服务类参数为null");
+            return false;
+        }
+        ActivityManager manager = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
+        if (manager == null) {
+            LogUtils.w(TAG, "isServiceRunning: ActivityManager获取失败");
+            return false;
+        }
+
+        for (ActivityManager.RunningServiceInfo service : manager.getRunningServices(Integer.MAX_VALUE)) {
+            if (serviceClass.getName().equals(service.service.getClassName())) {
+                LogUtils.d(TAG, "isServiceRunning: 服务[" + serviceClass.getSimpleName() + "]正在运行");
+                return true;
+            }
+        }
+        LogUtils.d(TAG, "isServiceRunning: 服务[" + serviceClass.getSimpleName() + "]未运行");
+        return false;
+    }
+
+    // ====================== 13. 内部类定义区（Java 7 规范，禁止Lambda） ======================
+    /**
+     * 自定义懒加载ViewPager适配器（删除setPrimaryItem方法，解决首屏初始化冲突）
+     */
+    private class LazyLoadPagerAdapter extends FragmentPagerAdapter {
+        private final List<Fragment> fragmentList;
+        private final List<String> tabTitleList;
+
+        public LazyLoadPagerAdapter(FragmentManager fm, List<Fragment> fragmentList, List<String> tabTitleList) {
+            super(fm);
+            this.fragmentList = fragmentList;
+            this.tabTitleList = tabTitleList;
+            LogUtils.d(MainActivity.TAG, "LazyLoadPagerAdapter: 初始化完成，Fragment数量=" + fragmentList.size());
+        }
+
+        @Override
+        public Fragment getItem(int position) {
+            return fragmentList.get(position);
+        }
+
+        @Override
+        public int getCount() {
+            return fragmentList.size();
+        }
+
+        @Override
+        public CharSequence getPageTitle(int position) {
+            return tabTitleList.get(position);
+        }
+
+        // 【已删除】移除setPrimaryItem方法，避免与手动初始化+onPageSelected回调冲突
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/activities/AboutActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/activities/AboutActivity.java
new file mode 100644
index 0000000..792d59d
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/activities/AboutActivity.java
@@ -0,0 +1,116 @@
+package cc.winboll.studio.contacts.activities;
+
+import android.app.Activity;
+import android.content.Context;
+import android.os.Bundle;
+import android.view.ViewGroup;
+import android.widget.LinearLayout;
+
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.APPInfo;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libaes.views.AboutView;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/31 15:15:54
+ * @Describe 应用介绍窗口
+ */
+public class AboutActivity extends WinBollActivity implements IWinBoLLActivity {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "AboutActivity";
+    private static final String BRANCH_NAME = "contacts";
+
+    // ====================== 成员变量区 ======================
+    private Context mContext;
+    private Toolbar mToolbar;
+
+    // ====================== 接口实现区 ======================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ====================== 生命周期函数区 ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: 关于页面开始创建");
+
+        mContext = this;
+        setContentView(R.layout.activity_about);
+
+        // 初始化工具栏
+        initToolbar();
+        // 初始化关于页面视图
+        initAboutView();
+        // 注册Activity管理
+        WinBoLLActivityManager.getInstance().add(this);
+
+        LogUtils.d(TAG, "onCreate: 关于页面初始化完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: 关于页面开始销毁");
+        WinBoLLActivityManager.getInstance().registeRemove(this);
+        LogUtils.d(TAG, "onDestroy: 关于页面销毁完成");
+    }
+
+    // ====================== 控件初始化函数区 ======================
+    private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar: 初始化工具栏");
+        // Java7 适配：添加强制类型转换
+        mToolbar = (Toolbar) findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(TAG);
+        // 非空判断，避免空指针异常
+        if (getSupportActionBar() != null) {
+            getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        }
+    }
+
+    private void initAboutView() {
+        LogUtils.d(TAG, "initAboutView: 初始化关于页面内容视图");
+        AboutView aboutView = createAboutView();
+        LinearLayout layout = (LinearLayout) findViewById(R.id.aboutviewroot_ll);
+
+        ViewGroup.LayoutParams params = new ViewGroup.LayoutParams(
+			ViewGroup.LayoutParams.MATCH_PARENT,
+			ViewGroup.LayoutParams.MATCH_PARENT
+        );
+        layout.addView(aboutView, params);
+        LogUtils.d(TAG, "initAboutView: AboutView已添加到布局");
+    }
+
+    // ====================== 业务逻辑函数区 ======================
+    private AboutView createAboutView() {
+        LogUtils.d(TAG, "createAboutView: 构建APP信息并创建AboutView");
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName("Contacts");
+        appInfo.setAppIcon(cc.winboll.studio.libaes.R.drawable.ic_winboll);
+        appInfo.setAppDescription("这是可以根据正则表达式匹配拦截骚扰电话的手机拨号应用。");
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(BRANCH_NAME);
+        appInfo.setAppGitAPPSubProjectFolder(BRANCH_NAME);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=Contacts");
+        appInfo.setAppAPKName("Contacts");
+        appInfo.setAppAPKFolderName("Contacts");
+
+        return new AboutView(mContext, appInfo);
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/activities/CallActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/activities/CallActivity.java
new file mode 100644
index 0000000..b06356d
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/activities/CallActivity.java
@@ -0,0 +1,159 @@
+package cc.winboll.studio.contacts.activities;
+
+import android.Manifest;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Bundle;
+import android.telephony.PhoneStateListener;
+import android.telephony.TelephonyManager;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/20 17:15:46
+ * @Describe 拨号窗口
+ */
+public class CallActivity extends AppCompatActivity {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "CallActivity";
+    private static final int REQUEST_CALL_PHONE = 1;
+
+    // ====================== UI控件区 ======================
+    private EditText phoneNumberEditText;
+    private TextView callStatusTextView;
+    private Button dialButton;
+
+    // ====================== 业务成员区 ======================
+    private TelephonyManager telephonyManager;
+    private MyPhoneStateListener phoneStateListener;
+
+    // ====================== 生命周期函数区 ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: 拨号页面开始创建");
+        setContentView(R.layout.activity_call);
+
+        // 初始化控件
+        initViews();
+        // 初始化电话状态监听
+        initPhoneStateListener();
+        LogUtils.d(TAG, "onCreate: 拨号页面初始化完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: 拨号页面开始销毁");
+        // 取消电话状态监听，避免内存泄漏
+        if (telephonyManager != null && phoneStateListener != null) {
+            telephonyManager.listen(phoneStateListener, PhoneStateListener.LISTEN_NONE);
+            LogUtils.d(TAG, "onDestroy: 电话状态监听已取消");
+        }
+        LogUtils.d(TAG, "onDestroy: 拨号页面销毁完成");
+    }
+
+    // ====================== 权限回调函数区 ======================
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        LogUtils.d(TAG, "onRequestPermissionsResult: 权限请求回调，requestCode=" + requestCode);
+        if (requestCode == REQUEST_CALL_PHONE) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                LogUtils.d(TAG, "onRequestPermissionsResult: 拨打电话权限授予成功");
+                String phoneNumber = phoneNumberEditText.getText().toString().trim();
+                dialPhoneNumber(phoneNumber);
+            } else {
+                LogUtils.w(TAG, "onRequestPermissionsResult: 拨打电话权限被拒绝");
+                Toast.makeText(this, "未授予拨打电话权限", Toast.LENGTH_SHORT).show();
+            }
+        }
+    }
+
+    // ====================== 控件初始化函数区 ======================
+    private void initViews() {
+        LogUtils.d(TAG, "initViews: 初始化UI控件");
+        // Java7 适配：添加强制类型转换
+        phoneNumberEditText = (EditText) findViewById(R.id.phone_number);
+        dialButton = (Button) findViewById(R.id.dial_button);
+        callStatusTextView = (TextView) findViewById(R.id.call_status);
+
+        // 设置拨号按钮点击事件
+        dialButton.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					String phoneNumber = phoneNumberEditText.getText().toString().trim();
+					LogUtils.d(TAG, "initViews: 拨号按钮点击，号码=" + phoneNumber);
+					if (phoneNumber.isEmpty()) {
+						Toast.makeText(CallActivity.this, "请输入电话号码", Toast.LENGTH_SHORT).show();
+						return;
+					}
+
+					// 权限检查
+					if (ContextCompat.checkSelfPermission(CallActivity.this, Manifest.permission.CALL_PHONE)
+                        != PackageManager.PERMISSION_GRANTED) {
+						LogUtils.w(TAG, "initViews: 拨打电话权限未授予，发起权限申请");
+						ActivityCompat.requestPermissions(CallActivity.this,
+														  new String[]{Manifest.permission.CALL_PHONE},
+														  REQUEST_CALL_PHONE);
+					} else {
+						dialPhoneNumber(phoneNumber);
+					}
+				}
+			});
+    }
+
+    // ====================== 电话状态监听初始化函数区 ======================
+    private void initPhoneStateListener() {
+        LogUtils.d(TAG, "initPhoneStateListener: 初始化电话状态监听");
+        telephonyManager = (TelephonyManager) getSystemService(TELEPHONY_SERVICE);
+        phoneStateListener = new MyPhoneStateListener();
+        telephonyManager.listen(phoneStateListener, PhoneStateListener.LISTEN_CALL_STATE);
+    }
+
+    // ====================== 核心业务函数区 ======================
+    private void dialPhoneNumber(String phoneNumber) {
+        LogUtils.d(TAG, "dialPhoneNumber: 发起拨号，号码=" + phoneNumber);
+        Intent intent = new Intent(Intent.ACTION_CALL);
+        intent.setData(android.net.Uri.parse("tel:" + phoneNumber));
+        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {
+            LogUtils.e(TAG, "dialPhoneNumber: 拨打电话权限缺失，拨号失败");
+            return;
+        }
+        startActivity(intent);
+    }
+
+    // ====================== 内部电话状态监听类 ======================
+    private class MyPhoneStateListener extends PhoneStateListener {
+        @Override
+        public void onCallStateChanged(int state, String incomingNumber) {
+            super.onCallStateChanged(state, incomingNumber);
+            switch (state) {
+                case TelephonyManager.CALL_STATE_IDLE:
+                    callStatusTextView.setText("电话已挂断");
+                    LogUtils.d(TAG, "MyPhoneStateListener: 通话状态-挂断");
+                    break;
+                case TelephonyManager.CALL_STATE_OFFHOOK:
+                    callStatusTextView.setText("正在通话中");
+                    LogUtils.d(TAG, "MyPhoneStateListener: 通话状态-通话中");
+                    break;
+                case TelephonyManager.CALL_STATE_RINGING:
+                    callStatusTextView.setText("来电: " + incomingNumber);
+                    LogUtils.d(TAG, "MyPhoneStateListener: 通话状态-来电，号码=" + incomingNumber);
+                    break;
+            }
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/activities/DialerActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/activities/DialerActivity.java
new file mode 100644
index 0000000..0fc4134
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/activities/DialerActivity.java
@@ -0,0 +1,80 @@
+package cc.winboll.studio.contacts.activities;
+
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.Toast;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/20 20:18:26
+ * @Describe 拨号盘窗口（跳转到系统拨号界面）
+ */
+public class DialerActivity extends AppCompatActivity {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "DialerActivity";
+
+    // ====================== UI控件区 ======================
+    private EditText phoneNumberEditText;
+    private Button dialButton;
+
+    // ====================== 生命周期函数区 ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: 拨号盘页面开始创建");
+        setContentView(R.layout.activity_dialer);
+
+        // 初始化UI控件与点击事件
+        initViews();
+        LogUtils.d(TAG, "onCreate: 拨号盘页面初始化完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: 拨号盘页面已销毁");
+    }
+
+    // ====================== 控件初始化函数区 ======================
+    private void initViews() {
+        LogUtils.d(TAG, "initViews: 初始化UI控件");
+        // Java7 适配：添加强制类型转换
+        phoneNumberEditText = (EditText) findViewById(R.id.phone_number_edit_text);
+        dialButton = (Button) findViewById(R.id.dial_button);
+
+        // 设置拨号按钮点击事件
+        dialButton.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					String phoneNumber = phoneNumberEditText.getText().toString().trim();
+					LogUtils.d(TAG, "initViews: 拨号按钮点击，输入号码=" + phoneNumber);
+
+					// 空号码校验
+					if (phoneNumber.isEmpty()) {
+						LogUtils.w(TAG, "initViews: 拨号失败，号码为空");
+						Toast.makeText(DialerActivity.this, "请输入有效电话号码", Toast.LENGTH_SHORT).show();
+						return;
+					}
+
+					// 跳转到系统拨号界面
+					Intent intent = new Intent(Intent.ACTION_DIAL, Uri.parse("tel:" + phoneNumber));
+					if (intent.resolveActivity(getPackageManager()) != null) {
+						startActivity(intent);
+						LogUtils.d(TAG, "initViews: 成功跳转到系统拨号界面");
+					} else {
+						LogUtils.e(TAG, "initViews: 跳转失败，无可用拨号应用");
+						Toast.makeText(DialerActivity.this, "未找到可用拨号应用", Toast.LENGTH_SHORT).show();
+					}
+				}
+			});
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/activities/SettingsActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/activities/SettingsActivity.java
new file mode 100644
index 0000000..4ca030b
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/activities/SettingsActivity.java
@@ -0,0 +1,613 @@
+package cc.winboll.studio.contacts.activities;
+
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.media.AudioManager;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+import android.provider.Settings;
+import android.view.View;
+import android.view.WindowManager;
+import android.widget.EditText;
+import android.widget.SeekBar;
+import android.widget.Switch;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.adapters.PhoneConnectRuleAdapter;
+import cc.winboll.studio.contacts.bobulltoon.TomCat;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.contacts.model.MainServiceBean;
+import cc.winboll.studio.contacts.model.PhoneConnectRuleBean;
+import cc.winboll.studio.contacts.model.RingTongBean;
+import cc.winboll.studio.contacts.model.SettingsBean;
+import cc.winboll.studio.contacts.services.MainService;
+import cc.winboll.studio.contacts.views.DuInfoTextView;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.lang.reflect.Field;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/21 05:37:42
+ * @Describe Contacts 设置页面（完全适配 API 30 + Java 7 语法）
+ * 核心优化：1. 移除高版本API依赖 2. Java7规范写法 3. 强化内存泄漏防护 4. 版本判断硬编码 5. LogUtils统一日志管理
+ */
+public class SettingsActivity extends WinBollActivity implements IWinBoLLActivity {
+
+    // ====================== 常量定义区（置顶，统一管理） ======================
+    public static final String TAG = "SettingsActivity";
+    // API版本硬编码（替代Build.VERSION_CODES，适配Java7）
+    private static final int ANDROID_6_API = 23;
+
+    // ====================== 静态成员属性区 ======================
+    private static DuInfoTextView sDuInfoTextView; // 规范命名：静态属性加s前缀
+
+    // ====================== 数据业务属性区 ======================
+    private int mStreamMaxVolume; // 铃音最大音量
+    private int mStreamVolume;    // 当前铃音音量
+    private List<PhoneConnectRuleBean> mRuleList; // 通话规则列表
+    private PhoneConnectRuleAdapter mRuleAdapter; // 规则列表适配器
+
+    // ====================== UI控件属性区（统一归类，规范命名） ======================
+    private Toolbar mToolbar;                  // 顶部工具栏
+    private Switch mSwMainService;             // 主服务开关
+    private SeekBar mSbVolume;                 // 音量调节条
+    private TextView mTvVolume;                // 音量显示文本
+    private Switch mSwEnableDun;               // 云盾功能开关
+    private EditText mEtDunTotalCount;         // 云盾总次数输入框
+    private EditText mEtDunResumeSecondCount;  // 云盾恢复秒数输入框
+    private EditText mEtDunResumeCount;        // 云盾恢复次数输入框
+    private RecyclerView mRvRuleList;          // 规则列表RecyclerView
+    private EditText mEtBoBullToonUrl;         // BoBullToon地址输入框
+    private EditText mEtSearchPhone;           // 号码查询输入框
+
+    // ====================== 接口实现区（IWinBoLLActivity规范实现） ======================
+    @Override
+    public AppCompatActivity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ====================== 生命周期函数区（按执行顺序排列） ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: 设置页面启动");
+        setContentView(R.layout.activity_settings);
+
+        // 初始化核心流程（按优先级执行）
+        initToolbar();          // 工具栏初始化（优先）
+        initMainServiceSwitch();// 主服务开关初始化
+        initVolumeControl();    // 音量控制初始化
+        initRuleRecyclerView(); // 规则列表初始化
+        initDunSettings();      // 云盾设置初始化
+        initBoBullToonViews();  // BoBullToon功能初始化
+
+        LogUtils.d(TAG, "onCreate: 设置页面初始化完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: 设置页面销毁");
+        // 内存泄漏防护：清空所有引用（静态+成员+UI）
+        sDuInfoTextView = null;
+        mRuleList = null;
+        mRuleAdapter = null;
+        mToolbar = null;
+        mSwMainService = null;
+        mSbVolume = null;
+        mTvVolume = null;
+        mSwEnableDun = null;
+        mEtDunTotalCount = null;
+        mEtDunResumeSecondCount = null;
+        mEtDunResumeCount = null;
+        mRvRuleList = null;
+        mEtBoBullToonUrl = null;
+        mEtSearchPhone = null;
+        LogUtils.d(TAG, "onDestroy: 设置页面资源清理完成");
+    }
+
+    // ====================== 初始化函数区（按功能模块归类） ======================
+    /**
+     * 初始化顶部工具栏（后退按钮+标题）
+     */
+    private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar: 初始化工具栏");
+        mToolbar = (Toolbar) findViewById(R.id.activitymainToolbar1);
+        setSupportActionBar(mToolbar);
+
+        // 显示后退按钮（空指针防护）
+        if (getSupportActionBar() != null) {
+            getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+            getSupportActionBar().setSubtitle(TAG);
+        }
+
+        // 后退按钮点击事件（Java7匿名内部类）
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "initToolbar: 点击后退按钮，关闭页面");
+					finish();
+				}
+			});
+    }
+
+    /**
+     * 初始化主服务开关（联动MainService启停）
+     */
+    private void initMainServiceSwitch() {
+        LogUtils.d(TAG, "initMainServiceSwitch: 初始化主服务开关");
+        mSwMainService = (Switch) findViewById(R.id.sw_mainservice);
+        MainServiceBean serviceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+
+        // 加载开关状态（空指针防护）
+        boolean isServiceEnable = serviceBean != null && serviceBean.isEnable();
+        mSwMainService.setChecked(isServiceEnable);
+        LogUtils.d(TAG, "initMainServiceSwitch: 主服务当前状态：" + (isServiceEnable ? "启用" : "禁用"));
+
+        // 开关点击事件
+        mSwMainService.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					boolean isChecked = mSwMainService.isChecked();
+					LogUtils.d(TAG, "initMainServiceSwitch: 主服务开关切换：" + (isChecked ? "启用" : "禁用"));
+					if (isChecked) {
+						MainService.startMainServiceAndSaveStatus(SettingsActivity.this);
+					} else {
+						MainService.stopMainServiceAndSaveStatus(SettingsActivity.this);
+					}
+				}
+			});
+    }
+
+    /**
+     * 初始化音量控制（SeekBar+音量显示+配置保存）
+     */
+    private void initVolumeControl() {
+        LogUtils.d(TAG, "initVolumeControl: 初始化音量控制");
+        mSbVolume = (SeekBar) findViewById(R.id.bellvolume);
+        mTvVolume = (TextView) findViewById(R.id.tv_volume);
+        final AudioManager audioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);
+
+        // 空指针防护：AudioManager获取失败直接返回
+        if (audioManager == null) {
+            LogUtils.e(TAG, "initVolumeControl: AudioManager获取失败，音量控制初始化失败");
+            return;
+        }
+
+        // 初始化音量参数
+        mStreamMaxVolume = audioManager.getStreamMaxVolume(AudioManager.STREAM_RING);
+        mStreamVolume = audioManager.getStreamVolume(AudioManager.STREAM_RING);
+        mSbVolume.setMax(mStreamMaxVolume);
+        mSbVolume.setProgress(mStreamVolume);
+        updateVolumeDisplay(); // 更新音量文本显示
+
+        // 音量调节监听
+        mSbVolume.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
+				@Override
+				public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
+					if (fromUser) {
+						LogUtils.d(TAG, "initVolumeControl: 音量调节至：" + progress + "/" + mStreamMaxVolume);
+						// 实时更新系统音量+保存配置
+						audioManager.setStreamVolume(AudioManager.STREAM_RING, progress, 0);
+						RingTongBean ringBean = RingTongBean.loadBean(SettingsActivity.this, RingTongBean.class);
+						if (ringBean == null) {
+							ringBean = new RingTongBean();
+						}
+						ringBean.setStreamVolume(progress);
+						RingTongBean.saveBean(SettingsActivity.this, ringBean);
+						mStreamVolume = progress;
+						updateVolumeDisplay();
+					}
+				}
+
+				@Override
+				public void onStartTrackingTouch(SeekBar seekBar) {}
+
+				@Override
+				public void onStopTrackingTouch(SeekBar seekBar) {}
+			});
+    }
+
+    /**
+     * 初始化通话规则列表（加载黑白名单规则）
+     */
+    private void initRuleRecyclerView() {
+        LogUtils.d(TAG, "initRuleRecyclerView: 初始化规则列表");
+        mRvRuleList = (RecyclerView) findViewById(R.id.recycler_view);
+        mRvRuleList.setLayoutManager(new LinearLayoutManager(this));
+
+        // 加载规则数据
+        Rules rules = Rules.getInstance(this);
+        if (rules == null) {
+            LogUtils.e(TAG, "initRuleRecyclerView: Rules实例获取失败，列表初始化失败");
+            return;
+        }
+        mRuleList = rules.getPhoneBlacRuleBeanList();
+        mRuleAdapter = new PhoneConnectRuleAdapter(this, mRuleList);
+        mRvRuleList.setAdapter(mRuleAdapter);
+        LogUtils.d(TAG, "initRuleRecyclerView: 规则列表加载完成，共" + mRuleList.size() + "条规则");
+    }
+
+    /**
+     * 初始化云盾设置（参数加载+开关联动）
+     */
+    private void initDunSettings() {
+        LogUtils.d(TAG, "initDunSettings: 初始化云盾设置");
+        sDuInfoTextView = (DuInfoTextView) findViewById(R.id.tv_DunInfo);
+        mSwEnableDun = (Switch) findViewById(R.id.sw_IsEnableDun);
+        mEtDunTotalCount = (EditText) findViewById(R.id.et_DunTotalCount);
+        mEtDunResumeSecondCount = (EditText) findViewById(R.id.et_DunResumeSecondCount);
+        mEtDunResumeCount = (EditText) findViewById(R.id.et_DunResumeCount);
+
+        // 加载云盾配置
+        Rules rules = Rules.getInstance(this);
+        if (rules == null) {
+            LogUtils.e(TAG, "initDunSettings: Rules实例获取失败，云盾初始化失败");
+            return;
+        }
+        SettingsBean dunSettings = rules.getSettingsModel();
+        if (dunSettings == null) {
+            LogUtils.e(TAG, "initDunSettings: 云盾配置获取失败");
+            return;
+        }
+
+        // 填充配置参数
+        mEtDunTotalCount.setText(String.valueOf(dunSettings.getDunTotalCount()));
+        mEtDunResumeSecondCount.setText(String.valueOf(dunSettings.getDunResumeSecondCount()));
+        mEtDunResumeCount.setText(String.valueOf(dunSettings.getDunResumeCount()));
+        mSwEnableDun.setChecked(dunSettings.isEnableDun());
+
+        // 开关联动：启用云盾时禁用参数编辑
+        boolean isDunEnable = dunSettings.isEnableDun();
+        mEtDunTotalCount.setEnabled(!isDunEnable);
+        mEtDunResumeSecondCount.setEnabled(!isDunEnable);
+        mEtDunResumeCount.setEnabled(!isDunEnable);
+        LogUtils.d(TAG, "initDunSettings: 云盾当前状态：" + (isDunEnable ? "启用" : "禁用"));
+    }
+
+    /**
+     * 初始化BoBullToon功能（地址配置+号码查询）
+     */
+    private void initBoBullToonViews() {
+        LogUtils.d(TAG, "initBoBullToonViews: 初始化BoBullToon功能");
+        mEtBoBullToonUrl = (EditText) findViewById(R.id.bobulltoonurl_et);
+        mEtSearchPhone = (EditText) findViewById(R.id.activitysettingsEditText1);
+
+        // 加载保存的地址
+        Rules rules = Rules.getInstance(this);
+        if (rules != null) {
+            mEtBoBullToonUrl.setText(rules.getBoBullToonURL());
+            LogUtils.d(TAG, "initBoBullToonViews: 加载BoBullToon地址完成");
+        } else {
+            LogUtils.e(TAG, "initBoBullToonViews: Rules实例获取失败，地址加载失败");
+        }
+    }
+
+    // ====================== 点击事件回调区（按功能模块归类） ======================
+    /**
+     * 云盾开关点击事件（联动参数编辑权限+配置保存）
+     */
+    public void onSW_IsEnableDun(View view) {
+        boolean isChecked = mSwEnableDun.isChecked();
+        LogUtils.d(TAG, "onSW_IsEnableDun: 云盾开关切换：" + (isChecked ? "启用" : "禁用"));
+
+        // 联动参数编辑权限
+        mEtDunTotalCount.setEnabled(!isChecked);
+        mEtDunResumeSecondCount.setEnabled(!isChecked);
+        mEtDunResumeCount.setEnabled(!isChecked);
+
+        // 保存配置
+        Rules rules = Rules.getInstance(this);
+        if (rules == null) {
+            LogUtils.e(TAG, "onSW_IsEnableDun: Rules实例获取失败，配置保存失败");
+            mSwEnableDun.setChecked(false);
+            return;
+        }
+        SettingsBean dunSettings = rules.getSettingsModel();
+        if (dunSettings == null) {
+            LogUtils.e(TAG, "onSW_IsEnableDun: 云盾配置获取失败，保存失败");
+            mSwEnableDun.setChecked(false);
+            return;
+        }
+
+        // 启用云盾时校验参数合法性
+        if (isChecked) {
+            try {
+                String totalCountStr = mEtDunTotalCount.getText().toString().trim();
+                String resumeSecStr = mEtDunResumeSecondCount.getText().toString().trim();
+                String resumeCountStr = mEtDunResumeCount.getText().toString().trim();
+
+                // 空参数校验
+                if (totalCountStr.isEmpty() || resumeSecStr.isEmpty() || resumeCountStr.isEmpty()) {
+                    throw new NumberFormatException("参数不能为空");
+                }
+
+                // 转换参数并保存
+                int totalCount = Integer.parseInt(totalCountStr);
+                int resumeSec = Integer.parseInt(resumeSecStr);
+                int resumeCount = Integer.parseInt(resumeCountStr);
+                dunSettings.setDunTotalCount(totalCount);
+                dunSettings.setDunResumeSecondCount(resumeSec);
+                dunSettings.setDunResumeCount(resumeCount);
+                LogUtils.d(TAG, "onSW_IsEnableDun: 云盾参数保存完成，总次数：" + totalCount + "，恢复秒数：" + resumeSec);
+
+                // 提示信息
+                String toastMsg = totalCount == 1 ? "电话骚扰防御力几乎为0" : "连拨" + totalCount + "次后接通电话";
+                ToastUtils.show(toastMsg);
+            } catch (NumberFormatException e) {
+                LogUtils.e(TAG, "onSW_IsEnableDun: 云盾参数格式错误", e);
+                ToastUtils.show("参数格式错误，请输入整数");
+                mSwEnableDun.setChecked(false);
+                return;
+            }
+        }
+
+        // 保存开关状态并刷新配置
+        dunSettings.setIsEnableDun(isChecked);
+        rules.saveDun();
+        rules.reload();
+        LogUtils.d(TAG, "onSW_IsEnableDun: 云盾配置保存完成");
+    }
+
+    /**
+     * 添加新通话规则（黑白名单）
+     */
+    public void onAddNewConnectionRule(View view) {
+        LogUtils.d(TAG, "onAddNewConnectionRule: 添加新通话规则");
+        Rules rules = Rules.getInstance(this);
+        if (rules == null) {
+            LogUtils.e(TAG, "onAddNewConnectionRule: Rules实例获取失败，添加失败");
+            return;
+        }
+        mRuleList.add(new PhoneConnectRuleBean());
+        rules.saveRules();
+        mRuleAdapter.notifyDataSetChanged();
+        LogUtils.d(TAG, "onAddNewConnectionRule: 规则添加完成，当前共" + mRuleList.size() + "条规则");
+    }
+
+    /**
+     * 跳转默认电话应用设置
+     */
+    public void onDefaultPhone(View view) {
+        LogUtils.d(TAG, "onDefaultPhone: 跳转默认电话应用设置");
+        startActivity(new Intent(Settings.ACTION_MANAGE_DEFAULT_APPS_SETTINGS));
+    }
+
+    /**
+     * 悬浮窗权限检查与请求
+     */
+    public void onCanDrawOverlays(View view) {
+        LogUtils.d(TAG, "onCanDrawOverlays: 检查悬浮窗权限");
+        // API6.0+校验权限
+        if (Build.VERSION.SDK_INT >= ANDROID_6_API && !Settings.canDrawOverlays(this)) {
+            LogUtils.d(TAG, "onCanDrawOverlays: 未开启悬浮窗权限，发起请求");
+            showDrawOverlayRequestDialog();
+        } else {
+            ToastUtils.show("悬浮窗权限已开启");
+        }
+    }
+
+    /**
+     * 清理BoBullToon本地数据
+     */
+    public void onCleanBoBullToonData(View view) {
+        LogUtils.d(TAG, "onCleanBoBullToonData: 清理BoBullToon数据");
+        TomCat tomCat = TomCat.getInstance(this);
+        if (tomCat != null) {
+            tomCat.cleanBoBullToon();
+            ToastUtils.show("BoBullToon数据已清理");
+            LogUtils.d(TAG, "onCleanBoBullToonData: 数据清理完成");
+        } else {
+            LogUtils.e(TAG, "onCleanBoBullToonData: TomCat实例获取失败，清理失败");
+        }
+    }
+
+    /**
+     * 重置BoBullToon默认地址
+     */
+    public void onResetBoBullToonURL(View view) {
+        LogUtils.d(TAG, "onResetBoBullToonURL: 重置BoBullToon地址");
+        Rules rules = Rules.getInstance(this);
+        if (rules == null) {
+            LogUtils.e(TAG, "onResetBoBullToonURL: Rules实例获取失败，重置失败");
+            return;
+        }
+        rules.resetDefaultBoBullToonURL();
+        mEtBoBullToonUrl.setText(rules.getBoBullToonURL());
+        ToastUtils.show("BoBullToon地址已重置为默认");
+        LogUtils.d(TAG, "onResetBoBullToonURL: 地址重置完成");
+    }
+
+    /**
+     * 下载BoBullToon数据（子线程执行，避免阻塞UI）
+     */
+    public void onDownloadBoBullToon(View view) {
+        LogUtils.d(TAG, "onDownloadBoBullToon: 开始下载BoBullToon数据");
+        Rules rules = Rules.getInstance(this);
+        if (rules == null) {
+            LogUtils.e(TAG, "onDownloadBoBullToon: Rules实例获取失败，下载失败");
+            return;
+        }
+
+        // 校验并更新地址
+        String inputUrl = mEtBoBullToonUrl.getText().toString().trim();
+        String savedUrl = rules.getBoBullToonURL();
+        if (!inputUrl.equals(savedUrl)) {
+            rules.setBoBullToonURL(inputUrl);
+            LogUtils.d(TAG, "onDownloadBoBullToon: BoBullToon地址更新为：" + inputUrl);
+        }
+
+        // 子线程下载（Java7匿名内部类）
+        final TomCat tomCat = TomCat.getInstance(this);
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					boolean downloadSuccess = tomCat != null && tomCat.downloadBoBullToon();
+					if (downloadSuccess) {
+						LogUtils.d(TAG, "onDownloadBoBullToon: 数据下载成功");
+						// 主线程更新UI
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									ToastUtils.show("BoBullToon下载成功");
+								}
+							});
+						// 重启主服务+刷新配置
+						MainService.restartMainService(SettingsActivity.this);
+						Rules.getInstance(SettingsActivity.this).reload();
+					} else {
+						LogUtils.e(TAG, "onDownloadBoBullToon: 数据下载失败");
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									ToastUtils.show("BoBullToon下载失败");
+								}
+							});
+					}
+				}
+			}).start();
+    }
+
+    /**
+     * 查询号码是否为BoBullToon号码
+     */
+    public void onSearchBoBullToonPhone(View view) {
+        LogUtils.d(TAG, "onSearchBoBullToonPhone: 执行号码查询");
+        String phone = mEtSearchPhone.getText().toString().trim();
+        // 空号码校验
+        if (phone.isEmpty()) {
+            LogUtils.w(TAG, "onSearchBoBullToonPhone: 查询号码为空，取消查询");
+            ToastUtils.show("请输入查询号码");
+            return;
+        }
+
+        // 执行查询
+        TomCat tomCat = TomCat.getInstance(this);
+        if (tomCat == null || !tomCat.loadPhoneBoBullToon()) {
+            LogUtils.w(TAG, "onSearchBoBullToonPhone: BoBullToon数据未加载，查询失败");
+            ToastUtils.show("请先下载BoBullToon数据");
+            return;
+        }
+
+        boolean isBoBullToon = tomCat.isPhoneBoBullToon(phone);
+        String resultMsg = isBoBullToon ? "是BoBullToon号码" : "非BoBullToon号码";
+        ToastUtils.show(resultMsg);
+        LogUtils.d(TAG, "onSearchBoBullToonPhone: 号码" + phone + "查询结果：" + resultMsg);
+    }
+
+    /**
+     * 跳转单元测试页面
+     */
+    public void onUnitTest(View view) {
+        LogUtils.d(TAG, "onUnitTest: 跳转单元测试页面");
+        startActivity(new Intent(this, UnitTestActivity.class));
+    }
+
+    /**
+     * 跳转关于页面
+     */
+    public void onAbout(View view) {
+        LogUtils.d(TAG, "onAbout: 跳转关于页面");
+        WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, AboutActivity.class);
+    }
+
+    /**
+     * 跳转日志查看页面
+     */
+    public void onLogView(View view) {
+        LogUtils.d(TAG, "onLogView: 跳转日志页面");
+        WinBoLLActivityManager.getInstance().startLogActivity(this);
+    }
+
+    // ====================== 工具方法区（通用功能+权限相关） ======================
+    /**
+     * 更新音量显示文本（当前音量/最大音量）
+     */
+    private void updateVolumeDisplay() {
+        mTvVolume.setText(mStreamVolume + "/" + mStreamMaxVolume);
+    }
+
+    /**
+     * 显示悬浮窗权限请求对话框
+     */
+    private void showDrawOverlayRequestDialog() {
+        AlertDialog dialog = new AlertDialog.Builder(this)
+			.setTitle("权限请求")
+			.setMessage("为保证通话监听功能正常，需开启悬浮窗权限")
+			.setPositiveButton("去设置", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+					jumpToDrawOverlaySettings();
+				}
+			})
+			.setNegativeButton("稍后", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+				}
+			})
+			.create();
+
+        // 解决对话框焦点问题
+        if (dialog.getWindow() != null) {
+            dialog.getWindow().setFlags(
+				WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
+				WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE);
+        }
+        dialog.show();
+    }
+
+    /**
+     * 跳转悬浮窗权限设置页面（反射适配低版本）
+     */
+    private void jumpToDrawOverlaySettings() {
+        LogUtils.d(TAG, "jumpToDrawOverlaySettings: 跳转悬浮窗权限设置");
+        try {
+            // 反射获取设置页面Action（避免高版本API依赖）
+            Class<?> settingsClazz = Settings.class;
+            Field actionField = settingsClazz.getDeclaredField("ACTION_MANAGE_OVERLAY_PERMISSION");
+            String action = (String) actionField.get(null);
+
+            // 跳转当前应用权限设置页
+            Intent intent = new Intent(action);
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.setData(Uri.parse("package:" + getPackageName()));
+            startActivity(intent);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "jumpToDrawOverlaySettings: 跳转权限设置失败", e);
+            Toast.makeText(this, "请手动在设置中开启悬浮窗权限", Toast.LENGTH_LONG).show();
+        }
+    }
+
+    // ====================== 静态通知方法区（云盾信息更新） ======================
+    /**
+     * 通知云盾信息刷新（外部调用）
+     */
+    public static void notifyDunInfoUpdate() {
+        if (sDuInfoTextView != null) {
+            LogUtils.d(TAG, "notifyDunInfoUpdate: 刷新云盾信息显示");
+            sDuInfoTextView.notifyInfoUpdate();
+        } else {
+            LogUtils.w(TAG, "notifyDunInfoUpdate: 云盾信息控件未初始化，刷新失败");
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/activities/UnitTestActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/activities/UnitTestActivity.java
new file mode 100644
index 0000000..8d3c2f5
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/activities/UnitTestActivity.java
@@ -0,0 +1,154 @@
+package cc.winboll.studio.contacts.activities;
+
+import android.os.Bundle;
+import android.view.View;
+import android.widget.EditText;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.activities.UnitTestActivity;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.contacts.services.LimitedTimeSpecialChannelService;
+import cc.winboll.studio.contacts.utils.IntUtils;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/02 16:07:04
+ * @Describe 规则单元测试页面
+ */
+public class UnitTestActivity extends WinBollActivity implements IWinBoLLActivity {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "UnitTestActivity";
+
+    // ====================== UI控件区 ======================
+    private LogView logView;
+    private EditText etPhone;
+
+    // ====================== 接口实现区 ======================
+    @Override
+    public AppCompatActivity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+	
+    // ====================== 生命周期函数区 ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: 单元测试页面开始创建");
+        setContentView(R.layout.activity_unittest);
+
+        // 初始化控件
+        initViews();
+        LogUtils.d(TAG, "onCreate: 单元测试页面初始化完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: 单元测试页面开始销毁");
+        if (logView != null) {
+            // 若LogView有停止方法，建议调用避免资源泄漏
+            // logView.stop();
+            LogUtils.d(TAG, "onDestroy: LogView资源已处理");
+        }
+        LogUtils.d(TAG, "onDestroy: 单元测试页面销毁完成");
+    }
+
+    // ====================== 控件初始化函数区 ======================
+    private void initViews() {
+        LogUtils.d(TAG, "initViews: 初始化UI控件");
+        // Java7 适配：添加强制类型转换
+        logView = (LogView) findViewById(R.id.logview);
+        etPhone = (EditText) findViewById(R.id.phone_et);
+
+        // 启动日志视图
+        logView.start();
+        LogUtils.d(TAG, "initViews: LogView已启动");
+    }
+
+    // ====================== 点击事件测试函数区 ======================
+    /**
+     * 测试单个号码匹配规则
+     */
+    public void onTestPhone(View view) {
+        LogUtils.d(TAG, "onTestPhone: 开始测试单个号码规则匹配");
+        String phone = etPhone.getText().toString().trim();
+        if (phone.isEmpty()) {
+            LogUtils.w(TAG, "onTestPhone: 测试号码为空，跳过匹配");
+            return;
+        }
+
+        Rules rules = Rules.getInstance(this);
+        boolean isAllowed = rules.isAllowed(phone);
+        LogUtils.d(TAG, String.format("onTestPhone: 测试号码: %s | 匹配结果: %s", phone, isAllowed));
+    }
+
+    /**
+     * 批量测试预设号码规则匹配
+     */
+    public void onTestMain(View view) {
+        LogUtils.d(TAG, "onTestMain: 开始批量测试号码规则匹配");
+        // 测试IntUtils工具类方法
+        LogUtils.d(TAG, "onTestMain: 执行 IntUtils.unittest_getIntInRange() 测试");
+        IntUtils.unittest_getIntInRange();
+
+        // 初始化规则实例
+        Rules rules = Rules.getInstance(this);
+        // 无规则时添加测试规则集
+        initTestRulesIfEmpty(rules);
+
+        // 预设测试号码列表
+        String[] testPhones = {
+			"16769764848", "16856582777", "17519703124",
+			"0205658955", "0108965253", "+8616769764848",
+			"4005816769764848", "95566"
+        };
+
+        // 遍历测试号码并输出结果
+        for (String phone : testPhones) {
+            boolean isAllowed = rules.isAllowed(phone);
+            LogUtils.d(TAG, String.format("onTestMain: 测试号码: %s | 匹配结果: %s", phone, isAllowed));
+        }
+        LogUtils.d(TAG, "onTestMain: 批量号码规则测试完成");
+		
+		new Thread(new Runnable(){
+				@Override
+				public void run() {
+					LimitedTimeSpecialChannelService.unitTest(UnitTestActivity.this);
+				}
+			}).start(); 
+    }
+
+    // ====================== 私有工具函数区 ======================
+    /**
+     * 规则集为空时初始化测试规则
+     */
+    private void initTestRulesIfEmpty(Rules rules) {
+        if (rules.getPhoneBlacRuleBeanList().size() == 0) {
+            LogUtils.d(TAG, "initTestRulesIfEmpty: 当前无规则，添加测试规则集");
+            // 规则1：中国手机号允许
+            rules.add("^1[3-9]\\d{9}$", true, true);
+            // 规则2：0660区号号码允许
+            rules.add("^0660\\d+$", true, true);
+            // 规则3：020区号号码允许
+            rules.add("^020\\d+$", true, true);
+            // 规则4：默认拒接所有号码
+            rules.add(".*", false, true);
+
+            // 保存规则到本地
+            rules.saveRules();
+            LogUtils.d(TAG, "initTestRulesIfEmpty: 测试规则集已保存");
+        } else {
+            LogUtils.d(TAG, "initTestRulesIfEmpty: 当前已有规则，跳过初始化");
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/activities/WinBollActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/activities/WinBollActivity.java
new file mode 100644
index 0000000..8b640eb
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/activities/WinBollActivity.java
@@ -0,0 +1,84 @@
+package cc.winboll.studio.contacts.activities;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.MenuItem;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/31 15:16:45
+ * @Describe 应用窗口基类，统一处理主题设置与导航返回
+ */
+public class WinBollActivity extends AppCompatActivity implements IWinBoLLActivity {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "WinBollActivity";
+
+    // ====================== 成员变量区 ======================
+    protected volatile AESThemeBean.ThemeType mThemeType;
+
+    // ====================== 接口实现区 ======================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ====================== 生命周期函数区 ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        //LogUtils.d(TAG, "onCreate: 基类页面开始创建");
+        // 优先设置主题，再执行父类初始化
+//        mThemeType = getThemeType();
+//        setThemeStyle();
+        super.onCreate(savedInstanceState);
+        //LogUtils.d(TAG, "onCreate: 基类主题设置完成，当前主题类型=" + mThemeType);
+    }
+
+    // ====================== 主题相关函数区 ======================
+    /**
+     * 获取当前应用主题类型
+     */
+    AESThemeBean.ThemeType getThemeType() {
+        LogUtils.d(TAG, "getThemeType: 获取应用主题类型");
+        // 注释的SharedPreferences逻辑保留，便于后续扩展
+        /*SharedPreferences sharedPreferences = getSharedPreferences(
+         SHAREDPREFERENCES_NAME, MODE_PRIVATE);
+         return AESThemeBean.ThemeType.values()[((sharedPreferences.getInt(DRAWER_THEME_TYPE, AESThemeBean.ThemeType.DEFAULT.ordinal())))];
+         */
+        return AESThemeBean.getThemeStyleType(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+    }
+
+    /**
+     * 应用当前主题样式
+     */
+    void setThemeStyle() {
+        LogUtils.d(TAG, "setThemeStyle: 开始设置应用主题");
+        // 替换原注释逻辑，使用AESThemeUtil获取的主题ID
+        setTheme(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        LogUtils.d(TAG, "setThemeStyle: 主题设置完成");
+    }
+
+    // ====================== 菜单与导航函数区 ======================
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        LogUtils.d(TAG, "onOptionsItemSelected: 菜单选项点击，itemId=" + item.getItemId());
+        // 处理导航栏返回按钮点击事件
+//        if (item.getItemId() == android.R.id.home) {
+//            LogUtils.d(TAG, "onOptionsItemSelected: 点击导航返回按钮，关闭当前页面");
+//            finish();
+//            return true;
+//        }
+        return super.onOptionsItemSelected(item);
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/adapters/CallLogAdapter.java b/contacts/src/main/java/cc/winboll/studio/contacts/adapters/CallLogAdapter.java
new file mode 100644
index 0000000..4486910
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/adapters/CallLogAdapter.java
@@ -0,0 +1,183 @@
+package cc.winboll.studio.contacts.adapters;
+
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.view.LayoutInflater;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.PopupMenu;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.model.CallLogModel;
+import cc.winboll.studio.contacts.utils.ContactUtils;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.text.SimpleDateFormat;
+import java.util.List;
+import java.util.Locale;
+import cc.winboll.studio.contacts.dun.Rules;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/26 13:09:32
+ * @Describe 通话记录列表适配器
+ */
+public class CallLogAdapter extends RecyclerView.Adapter<CallLogAdapter.CallLogViewHolder> {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "CallLogAdapter";
+    private static final SimpleDateFormat DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.getDefault());
+
+    // ====================== 成员变量区 ======================
+    private Context mContext;
+    private List<CallLogModel> callLogList;
+    private ContactUtils mContactUtils;
+
+    // ====================== 构造函数区 ======================
+    public CallLogAdapter(Context context, List<CallLogModel> callLogList) {
+        LogUtils.d(TAG, "CallLogAdapter: 初始化适配器，数据量=" + callLogList.size());
+        this.mContext = context;
+        this.callLogList = callLogList;
+        this.mContactUtils = ContactUtils.getInstance(mContext);
+    }
+
+    // ====================== 公共方法区 ======================
+    /**
+     * 重新加载联系人数据
+     */
+    public void relaodContacts() {
+        LogUtils.d(TAG, "relaodContacts: 开始重新加载联系人数据");
+        this.mContactUtils.reloadContacts();
+        notifyDataSetChanged();
+        LogUtils.d(TAG, "relaodContacts: 联系人数据加载完成，列表已刷新");
+    }
+
+    // ====================== RecyclerView 重写方法区 ======================
+    @NonNull
+    @Override
+    public CallLogViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        LogUtils.d(TAG, "onCreateViewHolder: 创建列表项ViewHolder");
+        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_call_log, parent, false);
+        return new CallLogViewHolder(view);
+    }
+
+    @Override
+    public void onBindViewHolder(@NonNull CallLogViewHolder holder, int position) {
+        LogUtils.d(TAG, "onBindViewHolder: 绑定列表项数据，position=" + position);
+        final CallLogModel callLog = callLogList.get(position);
+
+        // 绑定通话号码与联系人名称
+        String contactName = mContactUtils.getContactName(callLog.getPhoneNumber());
+        String phoneText = callLog.getPhoneNumber() + "☎" + (contactName == null ? "" : contactName);
+        holder.phoneNumber.setText(phoneText);
+
+        // 号码长按弹出菜单事件
+        holder.phoneNumber.setOnLongClickListener(new View.OnLongClickListener() {
+				@Override
+				public boolean onLongClick(View p1) {
+					showPhonePopupMenu(holder.phoneNumber, callLog);
+					return true;
+				}
+			});
+
+        // 绑定通话状态与时间
+        holder.callStatus.setText(callLog.getCallStatus());
+        holder.callDate.setText(DATE_FORMAT.format(callLog.getCallDate()));
+
+        // 初始化滑动拨号SeekBar
+        initDialSeekBar(holder.dialAOHPCTCSeekBar, callLog);
+    }
+
+    @Override
+    public int getItemCount() {
+        return callLogList == null ? 0 : callLogList.size();
+    }
+
+    // ====================== 私有工具方法区 ======================
+    /**
+     * 显示号码操作弹窗菜单
+     */
+    private void showPhonePopupMenu(View anchorView, final CallLogModel callLog) {
+        LogUtils.d(TAG, "showPhonePopupMenu: 弹出号码操作菜单");
+        PopupMenu menu = new PopupMenu(mContext, anchorView);
+        menu.getMenuInflater().inflate(R.menu.toolbar_calllog_phonenumber, menu.getMenu());
+
+        menu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
+				@Override
+				public boolean onMenuItemClick(MenuItem menuItem) {
+					int itemId = menuItem.getItemId();
+					if (itemId == R.id.item_calllog_phonenumber_copy) {
+						// 复制号码到剪贴板
+						ClipboardManager clipboard = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
+						ClipData clip = ClipData.newPlainText("call_log_phone", callLog.getPhoneNumber());
+						clipboard.setPrimaryClip(clip);
+						Toast.makeText(mContext, "Copy to clipboard.", Toast.LENGTH_SHORT).show();
+						LogUtils.d(TAG, "showPhonePopupMenu: 号码" + callLog.getPhoneNumber() + "已复制到剪贴板");
+					} else if (itemId == R.id.item_calllog_phonenumber_yundun_test) {
+						// 跳转到添加联系人页面
+						//if (Rules.getInstance(mContext).isAllowed(callLog.getPhoneNumber(), false)) {
+						if (Rules.getInstance(mContext).isAllowed(callLog.getPhoneNumber(), true)) {
+							ToastUtils.show("(✔)" + callLog.getPhoneNumber() + " Is Allowed By YunDun.");
+						} else {
+							ToastUtils.show("(✘)YunDun Defense The Phone " + callLog.getPhoneNumber() + "");
+						}
+					} else if (itemId == R.id.item_calllog_phonenumber_add_contact) {
+						// 跳转到添加联系人页面
+						ContactUtils.jumpToAddContact(mContext, callLog.getPhoneNumber());
+						LogUtils.d(TAG, "showPhonePopupMenu: 跳转添加联系人页面，号码=" + callLog.getPhoneNumber());
+					}
+					return true;
+				}
+			});
+        menu.show();
+    }
+
+    /**
+     * 初始化滑动拨号SeekBar
+     */
+    private void initDialSeekBar(AOHPCTCSeekBar seekBar, final CallLogModel callLog) {
+        LogUtils.d(TAG, "initDialSeekBar: 初始化滑动拨号控件");
+        seekBar.setThumb(seekBar.getContext().getDrawable(R.drawable.ic_call));
+        seekBar.setBlurRightDP(80);
+        seekBar.setThumbOffset(0);
+
+        seekBar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+				@Override
+				public void onOHPCommit() {
+					String phoneNumber = callLog.getPhoneNumber().replaceAll("\\s", "");
+					LogUtils.d(TAG, "initDialSeekBar: 滑动拨号触发，号码=" + phoneNumber);
+					ToastUtils.show(phoneNumber);
+
+					Intent intent = new Intent(Intent.ACTION_CALL);
+					intent.setData(android.net.Uri.parse("tel:" + phoneNumber));
+					intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+					mContext.startActivity(intent);
+				}
+			});
+    }
+
+    // ====================== ViewHolder 内部类 ======================
+    public class CallLogViewHolder extends RecyclerView.ViewHolder {
+        TextView phoneNumber;
+        TextView callStatus;
+        TextView callDate;
+        AOHPCTCSeekBar dialAOHPCTCSeekBar;
+
+        public CallLogViewHolder(@NonNull View itemView) {
+            super(itemView);
+            // Java7 适配：添加强制类型转换
+            phoneNumber = (TextView) itemView.findViewById(R.id.phone_number);
+            callStatus = (TextView) itemView.findViewById(R.id.call_status);
+            callDate = (TextView) itemView.findViewById(R.id.call_date);
+            dialAOHPCTCSeekBar = (AOHPCTCSeekBar) itemView.findViewById(R.id.aohpctcseekbar_dial);
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/adapters/ContactAdapter.java b/contacts/src/main/java/cc/winboll/studio/contacts/adapters/ContactAdapter.java
new file mode 100644
index 0000000..f213121
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/adapters/ContactAdapter.java
@@ -0,0 +1,157 @@
+package cc.winboll.studio.contacts.adapters;
+
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.view.LayoutInflater;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.LinearLayout;
+import android.widget.PopupMenu;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.model.ContactModel;
+import cc.winboll.studio.contacts.utils.ContactUtils;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/26 13:35:44
+ * @Describe 联系人列表适配器
+ */
+public class ContactAdapter extends RecyclerView.Adapter<ContactAdapter.ContactViewHolder> {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "ContactAdapter";
+    // 移除未使用的 REQUEST_CALL_PHONE 常量，精简冗余代码
+
+    // ====================== 成员变量区 ======================
+    private Context mContext;
+    private List<ContactModel> contactList;
+
+    // ====================== 构造函数区 ======================
+    public ContactAdapter(Context context, List<ContactModel> contactList) {
+        LogUtils.d(TAG, "ContactAdapter: 初始化适配器，联系人数量=" + contactList.size());
+        this.mContext = context;
+        this.contactList = contactList;
+    }
+
+    // ====================== RecyclerView 重写方法区 ======================
+    @NonNull
+    @Override
+    public ContactViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        LogUtils.d(TAG, "onCreateViewHolder: 创建联系人列表项ViewHolder");
+        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_contact, parent, false);
+        return new ContactViewHolder(view);
+    }
+
+    @Override
+    public void onBindViewHolder(@NonNull ContactViewHolder holder, int position) {
+        LogUtils.d(TAG, "onBindViewHolder: 绑定联系人列表项数据，position=" + position);
+        final ContactModel contact = contactList.get(position);
+
+        // 绑定联系人名称与号码
+        holder.contactName.setText(contact.getName());
+        holder.contactNumber.setText(contact.getNumber());
+
+        // 长按联系人条目弹出操作菜单
+        holder.llPhoneNumberMain.setOnLongClickListener(new View.OnLongClickListener() {
+				@Override
+				public boolean onLongClick(View v) {
+					showContactPopupMenu(holder.llPhoneNumberMain, contact);
+					return true;
+				}
+			});
+
+        // 初始化滑动拨号SeekBar
+        initDialSeekBar(holder.dialAOHPCTCSeekBar, contact);
+    }
+
+    @Override
+    public int getItemCount() {
+        // 增加空指针判断，避免空列表崩溃
+        return contactList == null ? 0 : contactList.size();
+    }
+
+    // ====================== 私有工具方法区 ======================
+    /**
+     * 显示联系人操作弹窗菜单
+     */
+    private void showContactPopupMenu(View anchorView, final ContactModel contact) {
+        LogUtils.d(TAG, "showContactPopupMenu: 弹出联系人操作菜单");
+        PopupMenu menu = new PopupMenu(mContext, anchorView);
+        menu.getMenuInflater().inflate(R.menu.toolbar_contact_phonenumber, menu.getMenu());
+
+        menu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
+				@Override
+				public boolean onMenuItemClick(MenuItem menuItem) {
+					int itemId = menuItem.getItemId();
+					if (itemId == R.id.item_contact_phonenumber_copy) {
+						// 复制联系人号码到剪贴板
+						ClipboardManager clipboard = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
+						ClipData clip = ClipData.newPlainText("contact_phone", contact.getNumber());
+						clipboard.setPrimaryClip(clip);
+						Toast.makeText(mContext, "Copy to clipboard.", Toast.LENGTH_SHORT).show();
+						LogUtils.d(TAG, "showContactPopupMenu: 联系人号码" + contact.getNumber() + "已复制到剪贴板");
+					} else if (itemId == R.id.item_calllog_phonenumber_edit_contact) {
+						// 跳转到编辑联系人页面
+						Long contactId = ContactUtils.getContactIdByPhone(mContext, contact.getNumber());
+						ContactUtils.jumpToEditContact(mContext, contact.getNumber(), contactId);
+						LogUtils.d(TAG, "showContactPopupMenu: 跳转编辑联系人页面，号码=" + contact.getNumber() + "，ID=" + contactId);
+					}
+					return true;
+				}
+			});
+        menu.show();
+    }
+
+    /**
+     * 初始化滑动拨号SeekBar
+     */
+    private void initDialSeekBar(AOHPCTCSeekBar seekBar, final ContactModel contact) {
+        LogUtils.d(TAG, "initDialSeekBar: 初始化滑动拨号控件");
+        seekBar.setThumb(seekBar.getContext().getDrawable(R.drawable.ic_call));
+        seekBar.setBlurRightDP(80);
+        seekBar.setThumbOffset(0);
+
+        seekBar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+				@Override
+				public void onOHPCommit() {
+					String phoneNumber = contact.getNumber().replaceAll("\\s", "");
+					LogUtils.d(TAG, "initDialSeekBar: 滑动拨号触发，号码=" + phoneNumber);
+					ToastUtils.show(phoneNumber);
+
+					Intent intent = new Intent(Intent.ACTION_CALL);
+					intent.setData(android.net.Uri.parse("tel:" + phoneNumber));
+					intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+					mContext.startActivity(intent);
+				}
+			});
+    }
+
+    // ====================== ViewHolder 内部类 ======================
+    public class ContactViewHolder extends RecyclerView.ViewHolder {
+        LinearLayout llPhoneNumberMain;
+        TextView contactName;
+        TextView contactNumber;
+        AOHPCTCSeekBar dialAOHPCTCSeekBar;
+
+        public ContactViewHolder(@NonNull View itemView) {
+            super(itemView);
+            // Java7 适配：添加强制类型转换
+            llPhoneNumberMain = (LinearLayout) itemView.findViewById(R.id.itemcontactLinearLayout1);
+            contactName = (TextView) itemView.findViewById(R.id.contact_name);
+            contactNumber = (TextView) itemView.findViewById(R.id.contact_number);
+            dialAOHPCTCSeekBar = (AOHPCTCSeekBar) itemView.findViewById(R.id.aohpctcseekbar_dial);
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/adapters/PhoneConnectRuleAdapter.java b/contacts/src/main/java/cc/winboll/studio/contacts/adapters/PhoneConnectRuleAdapter.java
new file mode 100644
index 0000000..276d729
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/adapters/PhoneConnectRuleAdapter.java
@@ -0,0 +1,257 @@
+package cc.winboll.studio.contacts.adapters;
+
+import android.content.Context;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.CheckBox;
+import android.widget.EditText;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.model.PhoneConnectRuleBean;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.contacts.views.LeftScrollView;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/02 17:27:41
+ * @Describe 通话规则列表适配器，支持简单查看/编辑两种视图切换
+ */
+public class PhoneConnectRuleAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "PhoneConnectRuleAdapter";
+    private static final int VIEW_TYPE_SIMPLE = 0;
+    private static final int VIEW_TYPE_EDIT = 1;
+    private static final String NULL_RULE_TEXT = "[NULL]";
+
+    // ====================== 成员变量区 ======================
+    private Context mContext;
+    private List<PhoneConnectRuleBean> mRuleList;
+
+    // ====================== 构造函数区 ======================
+    public PhoneConnectRuleAdapter(Context context, List<PhoneConnectRuleBean> ruleList) {
+        LogUtils.d(TAG, "PhoneConnectRuleAdapter: 初始化适配器，规则数量=" + ruleList.size());
+        this.mContext = context;
+        this.mRuleList = ruleList;
+    }
+
+    // ====================== RecyclerView 重写方法区 ======================
+    @NonNull
+    @Override
+    public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        LayoutInflater inflater = LayoutInflater.from(mContext);
+        if (viewType == VIEW_TYPE_SIMPLE) {
+            LogUtils.d(TAG, "onCreateViewHolder: 创建简单视图ViewHolder");
+            View view = inflater.inflate(R.layout.view_phone_connect_rule_simple, parent, false);
+            return new SimpleViewHolder(parent, view);
+        } else {
+            LogUtils.d(TAG, "onCreateViewHolder: 创建编辑视图ViewHolder");
+            View view = inflater.inflate(R.layout.view_phone_connect_rule, parent, false);
+            return new EditViewHolder(view);
+        }
+    }
+
+    @Override
+    public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder, final int position) {
+        final PhoneConnectRuleBean model = mRuleList.get(position);
+        LogUtils.d(TAG, "onBindViewHolder: 绑定规则数据，position=" + position + "，视图类型=" + getItemViewType(position));
+
+        if (holder instanceof SimpleViewHolder) {
+            bindSimpleViewHolder((SimpleViewHolder) holder, model, position);
+        } else if (holder instanceof EditViewHolder) {
+            bindEditViewHolder((EditViewHolder) holder, model, position);
+        }
+    }
+
+    @Override
+    public int getItemCount() {
+        return mRuleList == null ? 0 : mRuleList.size();
+    }
+
+    @Override
+    public int getItemViewType(int position) {
+        return mRuleList.get(position).isSimpleView() ? VIEW_TYPE_SIMPLE : VIEW_TYPE_EDIT;
+    }
+
+    // ====================== 私有视图绑定方法区 ======================
+    /**
+     * 绑定简单视图数据
+     */
+    private void bindSimpleViewHolder(final SimpleViewHolder holder, final PhoneConnectRuleBean model, final int position) {
+        // 绑定规则文本，空值显示[NULL]
+        String ruleText = model.getRuleText().trim().isEmpty() ? NULL_RULE_TEXT : model.getRuleText().trim();
+        holder.tvRuleText.setText(ruleText);
+        // 设置复选框状态并禁用编辑
+        holder.checkBoxAllow.setChecked(model.isAllowConnection());
+        holder.checkBoxAllow.setEnabled(false);
+        holder.checkBoxEnable.setChecked(model.isEnable());
+        holder.checkBoxEnable.setEnabled(false);
+
+        // 设置左滑操作监听
+        holder.scrollView.setOnActionListener(new LeftScrollView.OnActionListener() {
+				@Override
+				public void onUp() {
+					LogUtils.d(TAG, "onUp: 规则上移，position=" + position);
+					moveRuleUp(position);
+					holder.scrollView.smoothScrollTo(0, 0);
+				}
+
+				@Override
+				public void onDown() {
+					LogUtils.d(TAG, "onDown: 规则下移，position=" + position);
+					moveRuleDown(position);
+					holder.scrollView.smoothScrollTo(0, 0);
+				}
+
+				@Override
+				public void onEdit() {
+					LogUtils.d(TAG, "onEdit: 切换到编辑视图，position=" + position);
+					model.setIsSimpleView(false);
+					notifyItemChanged(position);
+					holder.scrollView.smoothScrollTo(0, 0);
+				}
+
+				@Override
+				public void onDelete() {
+					LogUtils.d(TAG, "onDelete: 触发规则删除确认，position=" + position);
+					showDeleteConfirmDialog(holder.scrollView.getContext(), model, position);
+				}
+			});
+    }
+
+    /**
+     * 绑定编辑视图数据
+     */
+    private void bindEditViewHolder(final EditViewHolder holder, final PhoneConnectRuleBean model, final int position) {
+        // 绑定规则文本到输入框
+        holder.editText.setText(model.getRuleText());
+        // 绑定复选框状态
+        holder.checkBoxAllow.setChecked(model.isAllowConnection());
+        holder.checkBoxEnable.setChecked(model.isEnable());
+
+        // 确认按钮点击事件
+        holder.buttonConfirm.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					String newRuleText = holder.editText.getText().toString().trim();
+					model.setRuleText(newRuleText);
+					model.setIsAllowConnection(holder.checkBoxAllow.isChecked());
+					model.setIsEnable(holder.checkBoxEnable.isChecked());
+					model.setIsSimpleView(true);
+
+					// 保存规则并刷新视图
+					Rules.getInstance(mContext).saveRules();
+					notifyItemChanged(position);
+					Toast.makeText(mContext, "保存成功", Toast.LENGTH_SHORT).show();
+					LogUtils.d(TAG, "bindEditViewHolder: 规则保存成功，position=" + position + "，规则内容=" + newRuleText);
+				}
+			});
+    }
+
+    // ====================== 私有业务工具方法区 ======================
+    /**
+     * 规则上移
+     */
+    private void moveRuleUp(int position) {
+        if (position <= 0) {
+            ToastUtils.show("已到顶部，无法上移");
+            return;
+        }
+        ArrayList<PhoneConnectRuleBean> ruleList = Rules.getInstance(mContext).getPhoneBlacRuleBeanList();
+        swapRulePosition(ruleList, position, position - 1);
+    }
+
+    /**
+     * 规则下移
+     */
+    private void moveRuleDown(int position) {
+        ArrayList<PhoneConnectRuleBean> ruleList = Rules.getInstance(mContext).getPhoneBlacRuleBeanList();
+        if (position >= ruleList.size() - 1) {
+            ToastUtils.show("已到底部，无法下移");
+            return;
+        }
+        swapRulePosition(ruleList, position, position + 1);
+    }
+
+    /**
+     * 交换规则位置
+     */
+    private void swapRulePosition(ArrayList<PhoneConnectRuleBean> list, int fromPos, int toPos) {
+        PhoneConnectRuleBean temp = list.get(fromPos);
+        list.set(fromPos, list.get(toPos));
+        list.set(toPos, temp);
+        Rules.getInstance(mContext).saveRules();
+        notifyDataSetChanged();
+        LogUtils.d(TAG, "swapRulePosition: 规则位置交换完成，from=" + fromPos + "，to=" + toPos);
+    }
+
+    /**
+     * 显示删除确认弹窗
+     */
+    private void showDeleteConfirmDialog(Context dialogContext, final PhoneConnectRuleBean model, final int position) {
+        YesNoAlertDialog.show(dialogContext, "删除确认", "是否删除该通话规则？", new YesNoAlertDialog.OnDialogResultListener() {
+				@Override
+				public void onYes() {
+					ArrayList<PhoneConnectRuleBean> ruleList = Rules.getInstance(mContext).getPhoneBlacRuleBeanList();
+					ruleList.remove(position);
+					Rules.getInstance(mContext).saveRules();
+					notifyDataSetChanged();
+					LogUtils.d(TAG, "showDeleteConfirmDialog: 规则删除成功，position=" + position);
+				}
+
+				@Override
+				public void onNo() {
+					LogUtils.d(TAG, "showDeleteConfirmDialog: 用户取消删除规则，position=" + position);
+				}
+			});
+    }
+
+    // ====================== ViewHolder 内部类区 ======================
+    static class SimpleViewHolder extends RecyclerView.ViewHolder {
+        LeftScrollView scrollView;
+        TextView tvRuleText;
+        CheckBox checkBoxAllow;
+        CheckBox checkBoxEnable;
+
+        public SimpleViewHolder(@NonNull ViewGroup parent, @NonNull View itemView) {
+            super(itemView);
+            scrollView = (LeftScrollView) itemView.findViewById(R.id.scrollView);
+            // 初始化简单视图内容布局
+            LayoutInflater inflater = LayoutInflater.from(itemView.getContext());
+            View viewContent = inflater.inflate(R.layout.view_phone_connect_rule_simple_content, parent, false);
+            tvRuleText = (TextView) viewContent.findViewById(R.id.ruletext_tv);
+            checkBoxAllow = (CheckBox) viewContent.findViewById(R.id.checkbox_allow);
+            checkBoxEnable = (CheckBox) viewContent.findViewById(R.id.checkbox_enable);
+            // 设置内容宽度并添加到滚动视图
+            scrollView.setContentWidth(parent.getWidth());
+            scrollView.addContentLayout(viewContent);
+        }
+    }
+
+    static class EditViewHolder extends RecyclerView.ViewHolder {
+        EditText editText;
+        CheckBox checkBoxAllow;
+        CheckBox checkBoxEnable;
+        Button buttonConfirm;
+
+        public EditViewHolder(@NonNull View itemView) {
+            super(itemView);
+            // Java7 适配：添加强制类型转换
+            editText = (EditText) itemView.findViewById(R.id.edit_text);
+            checkBoxAllow = (CheckBox) itemView.findViewById(R.id.checkbox_allow);
+            checkBoxEnable = (CheckBox) itemView.findViewById(R.id.checkbox_enable);
+            buttonConfirm = (Button) itemView.findViewById(R.id.button_confirm);
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/bobulltoon/TomCat.java b/contacts/src/main/java/cc/winboll/studio/contacts/bobulltoon/TomCat.java
new file mode 100644
index 0000000..da6cdf0
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/bobulltoon/TomCat.java
@@ -0,0 +1,260 @@
+package cc.winboll.studio.contacts.bobulltoon;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/02 13:47:48
+ * @Describe 汤姆猫管家 ：使用 BoBullToon 项目，对通讯地址进行筛选判断的好朋友。
+ */
+import android.content.Context;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.io.File;
+import java.io.FileFilter;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.zip.ZipEntry;
+import java.util.zip.ZipInputStream;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+public class TomCat {
+
+    public static final String TAG = "TomCat";
+
+    List<String> listPhoneBoBullToon = new ArrayList<String>();
+    String mszBoBullToon_URL;
+
+    static volatile TomCat _TomCat;
+    Context mContext;
+    TomCat(Context context) {
+        mContext = context;
+    }
+
+    public static synchronized TomCat getInstance(Context context) {
+        if (_TomCat == null) {
+            _TomCat = new TomCat(context);
+        }
+        return _TomCat;
+    }
+
+    public String getDefaultBobulltoonUrl() {
+        return mContext.getString(R.string.default_bobulltoon_url);
+    }
+
+    boolean downloadAndExtractZip(String zipUrl, String destinationFolder) throws IOException {
+        OkHttpClient client = new OkHttpClient();
+        Request request = new Request.Builder()
+            .url(zipUrl)
+            .build();
+
+        try {
+            Response response = client.newCall(request).execute();
+            if (!response.isSuccessful()) {
+                throw new IOException("Unexpected code " + response);
+            }
+
+            // 下载 ZIP 文件到临时位置
+            File tempZipFile = File.createTempFile("temp", ".zip");
+            try {
+                InputStream inputStream = response.body().byteStream();
+                FileOutputStream outputStream = new FileOutputStream(tempZipFile);
+                byte[] buffer = new byte[1024];
+                int length;
+                while ((length = inputStream.read(buffer)) > 0) {
+                    outputStream.write(buffer, 0, length);
+                }
+            } catch (Exception e) {
+                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            }
+
+            // 解压 ZIP 文件到指定文件夹
+            try {
+                ZipInputStream zipInputStream = new ZipInputStream(Files.newInputStream(tempZipFile.toPath()));
+                ZipEntry zipEntry;
+                while ((zipEntry = zipInputStream.getNextEntry()) != null) {
+                    Path targetFilePath = Paths.get(destinationFolder, zipEntry.getName());
+                    if (zipEntry.isDirectory()) {
+                        Files.createDirectories(targetFilePath);
+                    } else {
+                        Files.createDirectories(targetFilePath.getParent());
+                        try (FileOutputStream fos = new FileOutputStream(targetFilePath.toFile())) {
+                            byte[] buffer = new byte[1024];
+                            int len;
+                            while ((len = zipInputStream.read(buffer)) > 0) {
+                                fos.write(buffer, 0, len);
+                            }
+                        }
+                    }
+                    zipInputStream.closeEntry();
+                }
+            } catch (Exception e) {
+                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            }
+
+            // 删除临时 ZIP 文件
+            tempZipFile.delete();
+            LogUtils.d(TAG, "已更新 BoBullToon 数据");
+            return true;
+        } catch (Exception e) {
+            ToastUtils.show(e.getMessage());
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            return false;
+        }
+    }
+
+    public boolean downloadBoBullToon() {
+        String zipUrl = Rules.getInstance(mContext).getBoBullToonURL(); // 替换为实际的 ZIP 文件 URL
+        String destinationFolder = getWorkingFolder().getPath(); // 替换为实际的目标文件夹路径
+        try {
+            // 删除旧文件
+            File fOldFolder = new File(destinationFolder);
+            if (fOldFolder.exists()) {
+                deleteFolderRecursive(fOldFolder);
+                fOldFolder.mkdirs();
+                LogUtils.d(TAG, "已清空 BoBullToon 数据");
+            }
+
+            // 更新新文件
+            if (downloadAndExtractZip(zipUrl, destinationFolder)) {
+                LogUtils.d(TAG, "ZIP 文件下载并解压成功。");
+                return true;
+            }
+            return false;
+        } catch (IOException e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }
+
+    // 递归删除文件夹及其内容的方法
+    public static void deleteFolderRecursive(File file) {
+        // 判断是否为文件夹
+        if (file.isDirectory()) {
+            // 列出文件夹中的所有文件和子文件夹
+            File[] files = file.listFiles();
+            if (files != null) {
+                // 遍历并递归删除每个文件和子文件夹
+                for (File f : files) {
+                    deleteFolderRecursive(f);
+                }
+            }
+        }
+        // 删除文件或空文件夹
+        file.delete();
+    }
+
+    File getWorkingFolder() {
+        return mContext.getExternalFilesDir(TAG);
+    }
+	
+	public File getBoBullToonDataFolder() {
+		File fCheckRoot = getWorkingFolder();
+		if (fCheckRoot == null || !fCheckRoot.exists()) {
+			return fCheckRoot;
+		}
+
+		// 递归查找符合条件的文件夹
+		File targetFolder = findTargetFolder(fCheckRoot);
+		return targetFolder != null ? targetFolder : fCheckRoot;
+	}
+
+	/**
+	 * 递归查找同时包含LICENSE和README.md文件的文件夹
+	 */
+	private File findTargetFolder(File currentFolder) {
+		// 检查当前文件夹是否符合条件
+		if (hasRequiredFiles(currentFolder)) {
+			return currentFolder;
+		}
+
+		// 查找子文件夹（Java 7不支持方法引用，用匿名内部类过滤）
+		File[] subFolders = currentFolder.listFiles(new FileFilter() {
+				@Override
+				public boolean accept(File file) {
+					return file.isDirectory(); // 仅保留子文件夹
+				}
+			});
+
+		if (subFolders != null) {
+			for (File subFolder : subFolders) {
+				File result = findTargetFolder(subFolder);
+				if (result != null) {
+					return result;
+				}
+			}
+		}
+
+		return null;
+	}
+
+	/**
+	 * 检查文件夹中是否同时存在LICENSE和README.md文件
+	 */
+	private boolean hasRequiredFiles(File folder) {
+		if (folder == null || !folder.isDirectory()) {
+			return false;
+		}
+
+		// 检查两个文件是否同时存在且均为文件（非文件夹）
+		File licenseFile = new File(folder, "LICENSE");
+		File readmeFile = new File(folder, "README.md");
+
+		return licenseFile.exists() && licenseFile.isFile()
+			&& readmeFile.exists() && readmeFile.isFile();
+	}
+
+	public void cleanBoBullToon() {
+		String destinationFolder = getWorkingFolder().getPath(); // 替换为实际的目标文件夹路径
+		// 删除旧文件
+		File fOldFolder = new File(destinationFolder);
+		if (fOldFolder.exists()) {
+			deleteFolderRecursive(fOldFolder);
+			fOldFolder.mkdirs();
+		}
+
+		ToastUtils.show("已清空 BoBullToon 数据!");
+		LogUtils.d(TAG, "已清空 BoBullToon 数据");
+	}
+
+    public boolean loadPhoneBoBullToon() {
+        listPhoneBoBullToon.clear();
+        File fBoBullToon = getBoBullToonDataFolder();
+        if (fBoBullToon.exists()) {
+            LogUtils.d(TAG, String.format("getBoBullToonDataFolder() %s", getWorkingFolder()));
+            for (File userFolder : fBoBullToon.listFiles()) {
+                if (userFolder.isDirectory()) {
+                    for (File recordFile : userFolder.listFiles()) {
+                        listPhoneBoBullToon.add(recordFile.getName());
+                    }
+                }
+            }
+
+            for (int i = 0; i < listPhoneBoBullToon.size(); i++) {
+                LogUtils.d(TAG, String.format("listPhoneBoBullToon add : %s", listPhoneBoBullToon.get(i)));
+            }
+            return true;
+        } else {
+            LogUtils.d(TAG, "fBoBullToon not exists。");
+        }
+        return false;
+    }
+
+    public boolean isPhoneBoBullToon(String phone) {
+        for (int i = 0; i < listPhoneBoBullToon.size(); i++) {
+            LogUtils.d(TAG, String.format("isPhoneBoBullToon(...) get(i) phone : %s", listPhoneBoBullToon.get(i)));
+            if (listPhoneBoBullToon.get(i).equals(phone)) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/dun/Rules.java b/contacts/src/main/java/cc/winboll/studio/contacts/dun/Rules.java
new file mode 100644
index 0000000..0bc4402
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/dun/Rules.java
@@ -0,0 +1,280 @@
+package cc.winboll.studio.contacts.dun;
+
+import android.content.Context;
+import cc.winboll.studio.contacts.activities.SettingsActivity;
+import cc.winboll.studio.contacts.bobulltoon.TomCat;
+import cc.winboll.studio.contacts.model.PhoneConnectRuleBean;
+import cc.winboll.studio.contacts.model.SettingsBean;
+import cc.winboll.studio.contacts.services.LimitedTimeSpecialChannelService;
+import cc.winboll.studio.contacts.services.MainService;
+import cc.winboll.studio.contacts.utils.ContactUtils;
+import cc.winboll.studio.contacts.utils.IntUtils;
+import cc.winboll.studio.contacts.utils.RegexPPiUtils;
+import cc.winboll.studio.contacts.views.DunTemperatureView;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.ArrayList;
+import java.util.Timer;
+import java.util.TimerTask;
+import java.util.regex.Pattern;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/21 06:15:10
+ * @Describe 云盾防御规则（双重校验锁单例模式）
+ */
+public class Rules {
+
+    public static final String TAG = "Rules";
+
+    // 单例核心：volatile 保证多线程可见性，禁止指令重排
+    private static volatile Rules sInstance;
+    // 上下文需使用 ApplicationContext 避免内存泄漏
+    private static Context sApplicationContext;
+
+    ArrayList<PhoneConnectRuleBean> _PhoneConnectRuleModelList;
+    Context mContext;
+    SettingsBean mSettingsModel;
+    Timer mDunResumeTimer;
+
+    /**
+     * 私有化构造方法，禁止外部 new 实例
+     */
+    private Rules(Context context) {
+        mContext = context.getApplicationContext();
+        _PhoneConnectRuleModelList = new ArrayList<PhoneConnectRuleBean>();
+        reload();
+    }
+
+    /**
+     * 获取单例实例（双重校验锁，线程安全）
+     * @param context 上下文，建议传入 ApplicationContext
+     * @return Rules 唯一实例
+     */
+    public static Rules getInstance(Context context) {
+        // 第一次校验：无锁，提高性能
+        if (sInstance == null) {
+            // 加锁：保证多线程下仅初始化一次
+            synchronized (Rules.class) {
+                // 第二次校验：防止多线程并发时重复创建
+                if (sInstance == null) {
+                    sInstance = new Rules(context);
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    public void reload() {
+        LogUtils.d(TAG, "reload()");
+        loadRules();
+        loadDun();
+        setDunResumTimer();
+    }
+
+    public void setDunResumTimer() {
+        if (mDunResumeTimer != null) {
+            mDunResumeTimer.cancel();
+        }
+
+        // 盾牌恢复定时器
+        mDunResumeTimer = new Timer();
+        int ss = IntUtils.getIntInRange(mSettingsModel.getDunResumeSecondCount() * 1000, SettingsBean.MIN_INTRANGE, SettingsBean.MAX_INTRANGE);
+        mDunResumeTimer.schedule(new TimerTask() {
+				@Override
+				public void run() {
+					if (mSettingsModel.getDunCurrentCount() != mSettingsModel.getDunTotalCount()) {
+						LogUtils.d(TAG, String.format("当前防御值为%d，最大防御值为%d", mSettingsModel.getDunCurrentCount(), mSettingsModel.getDunTotalCount()));
+						int newDunCount = mSettingsModel.getDunCurrentCount() + mSettingsModel.getDunResumeCount();
+						// 设置盾值在[0，DunTotalCount]之内其他值一律重置为 DunTotalCount。
+						newDunCount = (newDunCount > mSettingsModel.getDunTotalCount()) ?mSettingsModel.getDunTotalCount(): newDunCount;
+						mSettingsModel.setDunCurrentCount(newDunCount);
+						LogUtils.d(TAG, String.format("设置防御值为%d", newDunCount));
+						saveDun();
+						// 一键更新所有 DunTemperatureView 实例的盾值
+						DunTemperatureView.updateDunValue(mSettingsModel.getDunTotalCount(), mSettingsModel.getDunCurrentCount());
+
+						SettingsActivity.notifyDunInfoUpdate();
+					}
+				}
+			}, 1000, ss);
+    }
+
+    public void loadRules() {
+        _PhoneConnectRuleModelList.clear();
+        PhoneConnectRuleBean.loadBeanList(mContext, _PhoneConnectRuleModelList, PhoneConnectRuleBean.class);
+    }
+
+    public void saveRules() {
+        LogUtils.d(TAG, String.format("saveRules()"));
+        PhoneConnectRuleBean.saveBeanList(mContext, _PhoneConnectRuleModelList, PhoneConnectRuleBean.class);
+    }
+
+    public void resetDefaultBoBullToonURL() {
+        mSettingsModel.setBoBullToon_URL(TomCat.getInstance(mContext).getDefaultBobulltoonUrl());
+        saveDun();
+    }
+
+    public void setBoBullToonURL(String szUrl) {
+        mSettingsModel.setBoBullToon_URL(szUrl);
+        saveDun();
+    }
+
+    public String getBoBullToonURL() {
+        return mSettingsModel.getBoBullToon_URL();
+    }
+
+    public void loadDun() {
+        mSettingsModel = SettingsBean.loadBean(mContext, SettingsBean.class);
+        if (mSettingsModel == null) {
+            mSettingsModel = new SettingsBean();
+            SettingsBean.saveBean(mContext, mSettingsModel);
+        }
+    }
+
+    public void saveDun() {
+        LogUtils.d(TAG, String.format("saveDun()"));
+        SettingsBean.saveBean(mContext, mSettingsModel);
+    }
+
+	public boolean isAllowed(String phoneNumber) {
+		return isAllowed(phoneNumber, false);
+	}
+
+    public boolean isAllowed(String phoneNumber, boolean isTest) {
+        // 没有启用云盾，默认允许接通任何电话
+        if (!mSettingsModel.isEnableDun()) {
+            LogUtils.d(TAG, String.format("没有启用云盾，默认允许接通任何电话。isAllowed(...) return true"));
+            return true;
+        }
+
+        // 云盾防御体系
+        boolean isDefend = false; // 盾牌是否生效
+        boolean isConnect = true; // 防御结果是否连接
+
+        // 进行盾牌层数预计缩减计算
+        int nDunCurrentCount = mSettingsModel.getDunCurrentCount() - 1;
+        LogUtils.d(TAG, String.format("nDunCurrentCount : %d", nDunCurrentCount));
+
+        // 如果盾值小于1，则解除防御
+        if (!isDefend && nDunCurrentCount < 1) {
+            // 盾层为1以下，防御解除
+            LogUtils.d(TAG, "盾层为1以下，防御解除");
+            isDefend = true;
+            isConnect = true;
+            LogUtils.d(TAG, String.format("isDefend == %s\nisConnect == %s", isDefend, isConnect));
+        }
+
+        // 正则运算预防针
+        if (!isDefend && !RegexPPiUtils.isPPiOK(phoneNumber)) {
+            LogUtils.d(TAG, "正则运算预防针生效。");
+            isDefend = true;
+            isConnect = false;
+            LogUtils.d(TAG, String.format("isDefend == %s\nisConnect == %s", isDefend, isConnect));
+        }
+		
+        // 限时特殊通道打开时返回连接
+        if (!isDefend && LimitedTimeSpecialChannelService.isServiceRunning()) {
+            LogUtils.d(TAG, String.format("PhoneNumber %s\n and Limited Time Special Channel Service Is Running.", phoneNumber));
+            isDefend = true;
+            isConnect = true;
+            LogUtils.d(TAG, String.format("isDefend == %s\nisConnect == %s", isDefend, isConnect));
+        }
+
+        // 检验拨不通号码群
+        if (!isDefend && MainService.isPhoneInBoBullToon(phoneNumber)) {
+            LogUtils.d(TAG, String.format("PhoneNumber %s\n Is In BoBullToon", phoneNumber));
+            isDefend = true;
+            isConnect = false;
+            LogUtils.d(TAG, String.format("isDefend == %s\nisConnect == %s", isDefend, isConnect));
+        }
+
+        // 查询通讯录是否有该联系人
+        boolean isPhoneInContacts = ContactUtils.getInstance(mContext).isPhoneInContacts(mContext, phoneNumber);
+        if (!isDefend) {
+            if (isPhoneInContacts) {
+                LogUtils.d(TAG, String.format("Phone %s is in contacts.", phoneNumber));
+                isDefend = true;
+                isConnect = true;
+                LogUtils.d(TAG, String.format("isDefend == %s\nisConnect == %s", isDefend, isConnect));
+            } else {
+                LogUtils.d(TAG, String.format("Phone %s is not in contacts.", phoneNumber));
+            }
+        }
+
+        // 正则匹配规则名单校验
+        if (!isDefend) {
+            for (int i = 0; i < _PhoneConnectRuleModelList.size(); i++) {
+                if (_PhoneConnectRuleModelList.get(i).isEnable()) {
+                    String regex = _PhoneConnectRuleModelList.get(i).getRuleText();
+                    if (Pattern.matches(regex, phoneNumber)) {
+                        LogUtils.d(TAG, String.format("Phone Number [%s] is matched by rule : %s", phoneNumber, _PhoneConnectRuleModelList.get(i)));
+                        isDefend = true;
+                        isConnect = _PhoneConnectRuleModelList.get(i).isAllowConnection();
+                        LogUtils.d(TAG, String.format("isDefend == %s\nisConnect == %s", isDefend, isConnect));
+                        break;
+                    }
+                }
+            }
+        }
+
+		// 如果不是规则测试时，就执行云盾防御机能。
+		if (isTest == false) {
+			if (isConnect) {
+				// 如果防御结果为连接，则恢复防御盾牌最大值层数
+				mSettingsModel.setDunCurrentCount(mSettingsModel.getDunTotalCount());
+				LogUtils.d(TAG, String.format("防御结果为连接，恢复防御盾牌最大值层数 %d", mSettingsModel.getDunTotalCount()));
+				saveDun();
+				SettingsActivity.notifyDunInfoUpdate();
+			} else if (isDefend) {
+				// 如果触发了以上某个防御模块，减少防御盾牌层数
+				int newDunCount = nDunCurrentCount;
+				LogUtils.d(TAG, String.format("新的防御层数预计为 %d", newDunCount));
+
+				// 保证盾值在[1，DunTotalCount]之内其他值一律重置为 DunTotalCount。
+				if (newDunCount > 0 && newDunCount < mSettingsModel.getDunTotalCount()) {
+					mSettingsModel.setDunCurrentCount(newDunCount);
+					LogUtils.d(TAG, String.format("设置防御层数为 %d", newDunCount));
+				} else {
+					mSettingsModel.setDunCurrentCount(mSettingsModel.getDunTotalCount());
+					LogUtils.d(TAG, String.format("盾值不在[0，%d]区间，恢复防御最大值%d", mSettingsModel.getDunTotalCount(), mSettingsModel.getDunTotalCount()));
+				}
+
+				saveDun();
+				SettingsActivity.notifyDunInfoUpdate();
+			}
+
+			// 一键更新所有 DunTemperatureView 实例的盾值
+			DunTemperatureView.updateDunValue(mSettingsModel.getDunTotalCount(), mSettingsModel.getDunCurrentCount());
+		}
+
+		// 返回校验结果
+		LogUtils.d(TAG, String.format("返回校验结果 isConnect == %s", isConnect));
+		return isConnect;
+	}
+
+    public void add(String szPhoneConnectRule, boolean isAllowConnection, boolean isEnable) {
+        _PhoneConnectRuleModelList.add(new PhoneConnectRuleBean(szPhoneConnectRule, isAllowConnection, isEnable));
+    }
+
+    public ArrayList<PhoneConnectRuleBean> getPhoneBlacRuleBeanList() {
+        return _PhoneConnectRuleModelList;
+    }
+
+    public SettingsBean getSettingsModel() {
+        return mSettingsModel;
+    }
+
+    /**
+     * 可选：释放单例资源（如退出应用时调用）
+     */
+    public static void releaseInstance() {
+        if (sInstance != null) {
+            sInstance.mDunResumeTimer.cancel();
+            sInstance._PhoneConnectRuleModelList.clear();
+            sInstance.mSettingsModel = null;
+            sInstance.mContext = null;
+            sInstance = null;
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/fragments/CallLogFragment.java b/contacts/src/main/java/cc/winboll/studio/contacts/fragments/CallLogFragment.java
new file mode 100644
index 0000000..9e2ca6a
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/fragments/CallLogFragment.java
@@ -0,0 +1,258 @@
+package cc.winboll.studio.contacts.fragments;
+
+import android.Manifest;
+import android.content.pm.PackageManager;
+import android.database.Cursor;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
+import android.provider.CallLog;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.core.app.ActivityCompat;
+import androidx.fragment.app.Fragment;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.adapters.CallLogAdapter;
+import cc.winboll.studio.contacts.model.CallLogModel;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.ArrayList;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/20 12:57:00
+ * @Describe 通话记录区域视图（支持懒加载，仅切换到当前页才加载数据）
+ */
+public class CallLogFragment extends Fragment {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "CallLogFragment";
+    public static final int MSG_UPDATE = 1;
+    private static final String ARG_PAGE = "ARG_PAGE";
+    private static final int REQUEST_READ_CALL_LOG = 1;
+
+    // ====================== 静态成员区 ======================
+    static volatile CallLogFragment _CallLogFragment;
+
+    // ====================== 页面参数区 ======================
+    private int mPage;
+
+    // ====================== UI控件与适配器区 ======================
+    private RecyclerView recyclerView;
+    private CallLogAdapter callLogAdapter;
+    private List<CallLogModel> callLogList = new ArrayList<CallLogModel>();
+
+    // ====================== 业务逻辑成员区 ======================
+    private Handler mHandler;
+    // 懒加载标记：记录当前Fragment是否已初始化数据（避免重复加载）
+    private boolean isDataInited = false;
+
+    // ====================== 单例与实例化函数区 ======================
+    CallLogFragment() {
+        super();
+    }
+
+    public static CallLogFragment newInstance(int page) {
+        LogUtils.d(TAG, "newInstance: 创建通话记录Fragment实例，页码=" + page);
+        Bundle args = new Bundle();
+        args.putInt(ARG_PAGE, page);
+        CallLogFragment fragment = new CallLogFragment();
+        fragment.setArguments(args);
+        _CallLogFragment = fragment;
+        return fragment;
+    }
+
+    // ====================== 生命周期函数区 ======================
+    @Override
+    public void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: Fragment创建开始");
+        if (getArguments() != null) {
+            mPage = getArguments().getInt(ARG_PAGE);
+            LogUtils.d(TAG, "onCreate: 读取页面参数，mPage=" + mPage);
+        }
+        // Java7 兼容：移除Lambda，使用匿名内部类初始化Handler
+        mHandler = new Handler(Looper.getMainLooper()) {
+            @Override
+            public void handleMessage(Message msg) {
+                if (msg.what == MSG_UPDATE) {
+                    LogUtils.d(TAG, "handleMessage: 收到更新消息，开始读取通话记录");
+                    readCallLog();
+                }
+            }
+        };
+        LogUtils.d(TAG, "onCreate: Fragment创建完成");
+    }
+
+    @Nullable
+    @Override
+    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
+        LogUtils.d(TAG, "onCreateView: 加载Fragment布局");
+        return inflater.inflate(R.layout.fragment_call_log, container, false);
+    }
+
+    @Override
+    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
+        super.onViewCreated(view, savedInstanceState);
+        LogUtils.d(TAG, "onViewCreated: 视图创建完成，仅初始化控件（不加载数据）");
+        // 初始化RecyclerView（仅绑定控件、设置布局管理器，不设置数据/发起请求）
+        recyclerView = (RecyclerView) view.findViewById(R.id.recyclerView);
+        recyclerView.setLayoutManager(new LinearLayoutManager(getContext()));
+        // 初始化适配器（传入空列表，后续懒加载时更新数据）
+        callLogAdapter = new CallLogAdapter(getContext(), callLogList);
+        recyclerView.setAdapter(callLogAdapter);
+        LogUtils.d(TAG, "onViewCreated: RecyclerView控件初始化完成（未加载数据）");
+    }
+
+    @Override
+    public void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume: Fragment进入前台");
+        // 已初始化过数据 → 仅刷新（避免重复初始化，优化性能）
+        if (isDataInited && callLogAdapter != null) {
+            LogUtils.d(TAG, "onResume: 数据已初始化，仅刷新列表");
+            callLogAdapter.relaodContacts();
+            readCallLog(); // 刷新最新通话记录
+            LogUtils.d(TAG, "onResume: 通话记录数据刷新完成");
+        }
+        // 未初始化 → 不操作（等待MainActivity调用initData触发初始化）
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: Fragment开始销毁");
+        if (mHandler != null) {
+            mHandler.removeCallbacksAndMessages(null);
+            LogUtils.d(TAG, "onDestroy: Handler消息已清空");
+        }
+        // 释放资源，避免内存泄漏
+        if (callLogList != null) {
+            callLogList.clear();
+            callLogList = null;
+        }
+        callLogAdapter = null;
+        recyclerView = null;
+        _CallLogFragment = null;
+        isDataInited = false;
+        LogUtils.d(TAG, "onDestroy: Fragment销毁完成");
+    }
+
+    // ====================== 权限回调函数区 ======================
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        LogUtils.d(TAG, "onRequestPermissionsResult: 权限请求回调，requestCode=" + requestCode);
+        if (requestCode == REQUEST_READ_CALL_LOG) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                LogUtils.d(TAG, "onRequestPermissionsResult: 通话记录权限授予成功，开始加载数据");
+                mHandler.sendEmptyMessage(MSG_UPDATE);
+            } else {
+                LogUtils.e(TAG, "onRequestPermissionsResult: 通话记录权限被拒绝，无法加载数据");
+            }
+        }
+    }
+
+    // ====================== 懒加载核心方法（供MainActivity调用） ======================
+    public void initData() {
+        // 避免重复初始化（双重防护：标记+判断）
+        if (isDataInited || getContext() == null) {
+            LogUtils.d(TAG, "initData: 数据已初始化/上下文为空，跳过");
+            return;
+        }
+        LogUtils.d(TAG, "initData: 开始懒加载初始化通话记录数据");
+        // 权限检查与数据加载（原onViewCreated中的核心逻辑迁移至此）
+        if (ActivityCompat.checkSelfPermission(requireContext(), Manifest.permission.READ_CALL_LOG) != PackageManager.PERMISSION_GRANTED) {
+            LogUtils.w(TAG, "initData: 读取通话记录权限未授予，发起权限申请");
+            ActivityCompat.requestPermissions(requireActivity(), new String[]{Manifest.permission.READ_CALL_LOG}, REQUEST_READ_CALL_LOG);
+        } else {
+            LogUtils.d(TAG, "initData: 权限已授予，发送更新消息加载数据");
+            mHandler.sendEmptyMessage(MSG_UPDATE);
+        }
+        // 标记为已初始化（后续仅刷新，不重复初始化）
+        isDataInited = true;
+        LogUtils.d(TAG, "initData: 懒加载初始化流程完成");
+    }
+
+    // ====================== 业务核心函数区 ======================
+    private void readCallLog() {
+        LogUtils.d(TAG, "readCallLog: 开始读取系统通话记录");
+        // 避免空指针（懒加载场景下，控件可能未初始化完成）
+        if (callLogList == null || callLogAdapter == null || getContext() == null) {
+            LogUtils.w(TAG, "readCallLog: 控件/列表为空，跳过读取");
+            return;
+        }
+        callLogList.clear();
+        Cursor cursor = null;
+        try {
+            cursor = requireContext().getContentResolver().query(
+                CallLog.Calls.CONTENT_URI,
+                null,
+                null,
+                null,
+                CallLog.Calls.DATE + " DESC"
+            );
+            if (cursor != null) {
+                LogUtils.d(TAG, "readCallLog: 成功获取通话记录游标，数据条数=" + cursor.getCount());
+                while (cursor.moveToNext()) {
+                    String phoneNumber = cursor.getString(cursor.getColumnIndex(CallLog.Calls.NUMBER));
+                    int callType = cursor.getInt(cursor.getColumnIndex(CallLog.Calls.TYPE));
+                    long callDateLong = cursor.getLong(cursor.getColumnIndex(CallLog.Calls.DATE));
+                    Date callDate = new Date(callDateLong);
+                    String callStatus = getCallStatus(callType);
+
+                    callLogList.add(new CallLogModel(phoneNumber, callStatus, callDate));
+                }
+                callLogAdapter.notifyDataSetChanged();
+                LogUtils.d(TAG, "readCallLog: 通话记录数据解析完成，共" + callLogList.size() + "条");
+            } else {
+                LogUtils.w(TAG, "readCallLog: 通话记录游标为空");
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "readCallLog: 读取通话记录异常", e);
+        } finally {
+            if (cursor != null) {
+                cursor.close();
+                LogUtils.d(TAG, "readCallLog: 游标已关闭");
+            }
+        }
+    }
+
+    private String getCallStatus(int callType) {
+        switch (callType) {
+            case CallLog.Calls.OUTGOING_TYPE:
+                return "Outgoing";
+            case CallLog.Calls.INCOMING_TYPE:
+                return "Incoming";
+            case CallLog.Calls.MISSED_TYPE:
+                return "Missed";
+            default:
+                return "Unknown";
+        }
+    }
+
+    // ====================== 外部调用函数区 ======================
+    public void triggerUpdate() {
+        LogUtils.d(TAG, "triggerUpdate: 外部触发通话记录更新");
+        if (isDataInited) { // 已初始化才触发更新（避免未加载时调用）
+            mHandler.sendEmptyMessage(MSG_UPDATE);
+        }
+    }
+
+    public static void updateCallLogFragment() {
+        if (_CallLogFragment != null) {
+            LogUtils.d(TAG, "updateCallLogFragment: 静态方法触发Fragment更新");
+            _CallLogFragment.triggerUpdate();
+        } else {
+            LogUtils.w(TAG, "updateCallLogFragment: Fragment实例为空，无法更新");
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/fragments/ContactsFragment.java b/contacts/src/main/java/cc/winboll/studio/contacts/fragments/ContactsFragment.java
new file mode 100644
index 0000000..1d177ed
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/fragments/ContactsFragment.java
@@ -0,0 +1,401 @@
+package cc.winboll.studio.contacts.fragments;
+
+import android.Manifest;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.database.Cursor;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.provider.ContactsContract;
+import android.text.Editable;
+import android.text.TextWatcher;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.EditText;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.core.app.ActivityCompat;
+import androidx.fragment.app.Fragment;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.adapters.ContactAdapter;
+import cc.winboll.studio.contacts.model.ContactModel;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/08/30 14:32
+ * @Describe 联系人区域视图（支持懒加载，仅切换到当前页才加载数据）
+ */
+public class ContactsFragment extends Fragment {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "ContactsFragment";
+    private static final String ARG_PAGE = "ARG_PAGE";
+    private static final int REQUEST_READ_CONTACTS = 1;
+    private static final long DEBOUNCE_DELAY = 300; // 搜索防抖延迟
+
+    // ====================== 静态缓存区 ======================
+    // 全局复用联系人数据，减少重复查询
+    private static List<ContactModel> sCachedOriginalList = new ArrayList<ContactModel>();
+    private static List<ContactModel> sCachedFilteredList = new ArrayList<ContactModel>();
+
+    // ====================== 页面参数区 ======================
+    private int mPage;
+    private boolean isViewInitialized = false; // 视图初始化标记（控件绑定完成）
+    private boolean isDataLoaded = false;     // 数据加载标记（数据+功能初始化完成）
+    private boolean isLazyInitCompleted = false; // 懒加载总标记（供MainActivity判断）
+
+    // ====================== UI控件区 ======================
+    private RecyclerView recyclerView;
+    private ContactAdapter contactAdapter;
+    private EditText searchEditText;
+    private Button btnDial;
+
+    // ====================== 数据容器区 ======================
+    private List<ContactModel> contactList = new ArrayList<ContactModel>();
+    private List<ContactModel> originalContactList = new ArrayList<ContactModel>();
+
+    // ====================== 异步工具区 ======================
+    private final ExecutorService executor = Executors.newSingleThreadExecutor();
+    private final Handler mainHandler = new Handler(Looper.getMainLooper());
+
+    // ====================== 实例化函数区 ======================
+    public static ContactsFragment newInstance(int page) {
+        LogUtils.d(TAG, "newInstance: 创建联系人Fragment实例，页码=" + page);
+        Bundle args = new Bundle();
+        args.putInt(ARG_PAGE, page);
+        ContactsFragment fragment = new ContactsFragment();
+        fragment.setArguments(args);
+        return fragment;
+    }
+
+    // ====================== 生命周期函数区 ======================
+    @Override
+    public void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: Fragment创建开始");
+        if (getArguments() != null) {
+            mPage = getArguments().getInt(ARG_PAGE);
+            LogUtils.d(TAG, "onCreate: 读取页面参数，mPage=" + mPage);
+        }
+        LogUtils.d(TAG, "onCreate: Fragment创建完成");
+    }
+
+    @Nullable
+    @Override
+    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
+        LogUtils.d(TAG, "onCreateView: 加载Fragment布局");
+        return inflater.inflate(R.layout.fragment_contacts, container, false);
+    }
+
+    @Override
+    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
+        super.onViewCreated(view, savedInstanceState);
+        LogUtils.d(TAG, "onViewCreated: 开始初始化UI控件（仅绑定，不加载数据/功能）");
+        // 初始化RecyclerView（仅绑定控件、设适配器，隐藏列表）
+        recyclerView = (RecyclerView) view.findViewById(R.id.contacts_recycler_view);
+        recyclerView.setLayoutManager(new LinearLayoutManager(getContext()));
+        contactAdapter = new ContactAdapter(getActivity(), contactList);
+        recyclerView.setAdapter(contactAdapter);
+        recyclerView.setVisibility(View.GONE);
+
+        // 绑定搜索框和拨号按钮（仅赋值，不显示、不绑定事件）
+        searchEditText = (EditText) view.findViewById(R.id.search_edit_text);
+        btnDial = (Button) view.findViewById(R.id.btn_dial);
+        searchEditText.setVisibility(View.GONE);
+        btnDial.setVisibility(View.GONE);
+
+        // 标记视图控件绑定完成
+        isViewInitialized = true;
+        LogUtils.d(TAG, "onViewCreated: UI控件初始化完成（未加载数据/功能）");
+    }
+
+    @Override
+    public void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume: Fragment进入前台");
+        // 已完成懒加载 → 仅恢复缓存数据（切回页面时刷新）
+        if (isLazyInitCompleted && isDataLoaded) {
+            LogUtils.d(TAG, "onResume: 懒加载已完成，恢复缓存数据");
+            contactList.clear();
+            contactList.addAll(sCachedFilteredList);
+            contactAdapter.notifyDataSetChanged();
+            recyclerView.setVisibility(View.VISIBLE);
+        }
+        // 未完成懒加载 → 不操作（等待MainActivity调用initData触发）
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: Fragment开始销毁");
+        executor.shutdown(); // 关闭线程池
+        mainHandler.removeCallbacksAndMessages(null); // 清空Handler任务
+        // 释放本地数据引用（保留静态缓存，全局复用）
+        if (contactList != null) {
+            contactList.clear();
+            contactList = null;
+        }
+        if (originalContactList != null) {
+            originalContactList.clear();
+            originalContactList = null;
+        }
+        // 重置标记
+        isViewInitialized = false;
+        isDataLoaded = false;
+        isLazyInitCompleted = false;
+        LogUtils.d(TAG, "onDestroy: 异步工具+本地资源已释放");
+    }
+
+    @Override
+    public void onHiddenChanged(boolean hidden) {
+        super.onHiddenChanged(hidden);
+        LogUtils.d(TAG, "onHiddenChanged: Fragment隐藏状态变更，hidden=" + hidden);
+        // 已完成懒加载+显示状态 → 恢复缓存数据（兼容Tab切换场景）
+        if (!hidden && isLazyInitCompleted && isDataLoaded) {
+            contactList.clear();
+            contactList.addAll(sCachedFilteredList);
+            contactAdapter.notifyDataSetChanged();
+            recyclerView.setVisibility(View.VISIBLE);
+            LogUtils.d(TAG, "onHiddenChanged: 恢复缓存数据，列表已显示");
+        }
+    }
+
+    // ====================== 权限相关函数区 ======================
+    private void checkContactPermission() {
+        LogUtils.d(TAG, "checkContactPermission: 检查联系人读取权限");
+        if (ActivityCompat.checkSelfPermission(requireContext(), Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED) {
+            LogUtils.w(TAG, "checkContactPermission: 权限未授予，发起申请");
+            ActivityCompat.requestPermissions(requireActivity(), new String[]{Manifest.permission.READ_CONTACTS}, REQUEST_READ_CONTACTS);
+        } else {
+            LogUtils.d(TAG, "checkContactPermission: 权限已授予，开始加载数据");
+            loadContacts();
+        }
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        LogUtils.d(TAG, "onRequestPermissionsResult: 权限回调触发，requestCode=" + requestCode);
+        if (requestCode == REQUEST_READ_CONTACTS) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                LogUtils.d(TAG, "onRequestPermissionsResult: 联系人权限授予成功");
+                loadContacts();
+            } else {
+                LogUtils.e(TAG, "onRequestPermissionsResult: 联系人权限被拒绝");
+                ToastUtils.show("请授予联系人权限以查看联系人列表");
+                recyclerView.setVisibility(View.VISIBLE);
+                // 权限拒绝也标记懒加载完成（避免重复触发）
+                isLazyInitCompleted = true;
+            }
+        }
+    }
+
+    // ====================== 懒加载核心方法（供MainActivity调用） ======================
+    public void initData() {
+        // 双重防护：避免重复初始化（标记+视图就绪判断）
+        if (isLazyInitCompleted || !isViewInitialized || getContext() == null) {
+            LogUtils.d(TAG, "initData: 懒加载已完成/视图未就绪，跳过");
+            return;
+        }
+        LogUtils.d(TAG, "initData: 开始懒加载初始化（功能+数据）");
+        // 1. 初始化搜索、拨号功能（原onResume首次进入逻辑迁移至此）
+        initSearchAndDial();
+        // 2. 检查权限+加载数据（原onResume首次进入逻辑迁移至此）
+        checkContactPermission();
+        // 标记懒加载总流程完成（无论权限是否授予，仅执行一次）
+        isLazyInitCompleted = true;
+        LogUtils.d(TAG, "initData: 懒加载初始化流程启动完成");
+    }
+
+    // ====================== UI功能初始化区 ======================
+    private void initSearchAndDial() {
+        LogUtils.d(TAG, "initSearchAndDial: 初始化搜索和拨号功能");
+        // 显示控件
+        searchEditText.setVisibility(View.VISIBLE);
+        btnDial.setVisibility(View.VISIBLE);
+
+        // 搜索防抖监听
+        searchEditText.addTextChangedListener(new DebounceTextWatcher(DEBOUNCE_DELAY) {
+				@Override
+				public void onDebounceTextChanged(String query) {
+					filterContacts(query);
+				}
+			});
+
+        // 拨号按钮点击事件
+        btnDial.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					String phoneNumber = searchEditText.getText().toString().replaceAll("\\s", "");
+					if (phoneNumber.isEmpty()) {
+						ToastUtils.show("请输入号码");
+						return;
+					}
+					LogUtils.d(TAG, "initSearchAndDial: 发起拨号，号码=" + phoneNumber);
+					Intent intent = new Intent(Intent.ACTION_CALL);
+					intent.setData(android.net.Uri.parse("tel:" + phoneNumber));
+					intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+					startActivity(intent);
+				}
+			});
+        LogUtils.d(TAG, "initSearchAndDial: 功能初始化完成");
+    }
+
+    // ====================== 数据加载与处理区 ======================
+    private void loadContacts() {
+        // 优先使用缓存数据（保留原有缓存逻辑，提升性能）
+        if (!sCachedOriginalList.isEmpty() && !sCachedFilteredList.isEmpty()) {
+            LogUtils.d(TAG, "loadContacts: 存在缓存数据，直接复用");
+            originalContactList.clear();
+            originalContactList.addAll(sCachedOriginalList);
+            contactList.clear();
+            contactList.addAll(sCachedFilteredList);
+            contactAdapter.notifyDataSetChanged();
+            recyclerView.setVisibility(View.VISIBLE);
+            isDataLoaded = true;
+            return;
+        }
+
+        // 无缓存时异步加载（保留原有异步逻辑，避免主线程阻塞）
+        if (!isDataLoaded) {
+            LogUtils.d(TAG, "loadContacts: 无缓存，异步读取联系人数据");
+            recyclerView.setVisibility(View.GONE);
+            executor.execute(new Runnable() {
+					@Override
+					public void run() {
+						final List<ContactModel> tempList = readContactsInBackground();
+						// 主线程更新UI和缓存
+						mainHandler.post(new Runnable() {
+								@Override
+								public void run() {
+									sCachedOriginalList.clear();
+									sCachedOriginalList.addAll(tempList);
+									sCachedFilteredList.clear();
+									sCachedFilteredList.addAll(tempList);
+
+									originalContactList.clear();
+									originalContactList.addAll(sCachedOriginalList);
+									contactList.clear();
+									contactList.addAll(sCachedFilteredList);
+
+									contactAdapter.notifyDataSetChanged();
+									recyclerView.setVisibility(View.VISIBLE);
+									isDataLoaded = true;
+
+									LogUtils.d(TAG, "loadContacts: 联系人数据加载完成，共" + contactList.size() + "条");
+								}
+							});
+					}
+				});
+        }
+    }
+
+    private List<ContactModel> readContactsInBackground() {
+        LogUtils.d(TAG, "readContactsInBackground: 子线程读取联系人");
+        List<ContactModel> tempList = new ArrayList<ContactModel>();
+        Cursor cursor = null;
+        try {
+            cursor = requireContext().getContentResolver().query(
+                ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
+                new String[]{
+                    ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
+                    ContactsContract.CommonDataKinds.Phone.NUMBER
+                },
+                null,
+                null,
+                ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME + " ASC"
+            );
+
+            if (cursor != null && cursor.moveToFirst()) {
+                int nameIndex = cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME);
+                int numberIndex = cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER);
+                do {
+                    String name = cursor.getString(nameIndex);
+                    String number = cursor.getString(numberIndex).replaceAll("\\s", "");
+                    tempList.add(new ContactModel(name, number));
+                } while (cursor.moveToNext());
+                LogUtils.d(TAG, "readContactsInBackground: 成功读取" + tempList.size() + "条联系人数据");
+            } else {
+                LogUtils.w(TAG, "readContactsInBackground: 未读取到联系人数据");
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "readContactsInBackground: 读取联系人异常", e);
+        } finally {
+            if (cursor != null) {
+                cursor.close();
+                LogUtils.d(TAG, "readContactsInBackground: 游标已关闭");
+            }
+        }
+        return tempList;
+    }
+
+    private void filterContacts(String query) {
+        LogUtils.d(TAG, "filterContacts: 搜索过滤，关键词=" + query);
+        contactList.clear();
+        sCachedFilteredList.clear();
+        if (query.isEmpty()) {
+            contactList.addAll(originalContactList);
+            sCachedFilteredList.addAll(originalContactList);
+        } else {
+            String lowerQuery = query.toLowerCase();
+            for (ContactModel contact : originalContactList) {
+                boolean matchName = contact.getName().toLowerCase().contains(lowerQuery);
+                boolean matchPinyin = contact.getPinyin().toLowerCase().contains(lowerQuery);
+                boolean matchFirstLetter = contact.getPinyinFirstLetter().toLowerCase().contains(lowerQuery);
+                boolean matchNumber = contact.getNumber().contains(lowerQuery);
+                if (matchName || matchPinyin || matchFirstLetter || matchNumber) {
+                    contactList.add(contact);
+                }
+            }
+            sCachedFilteredList.addAll(contactList);
+        }
+        contactAdapter.notifyDataSetChanged();
+        recyclerView.setVisibility(View.VISIBLE);
+        LogUtils.d(TAG, "filterContacts: 过滤完成，显示" + contactList.size() + "条数据");
+    }
+
+    // ====================== 内部防抖监听类 ======================
+    public abstract static class DebounceTextWatcher implements TextWatcher {
+        private final long debounceDelay;
+        private Handler handler = new Handler(Looper.getMainLooper());
+        private Runnable pendingRunnable;
+
+        public DebounceTextWatcher(long debounceDelay) {
+            this.debounceDelay = debounceDelay;
+        }
+
+        @Override
+        public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+        @Override
+        public void onTextChanged(final CharSequence s, int start, int before, int count) {
+            if (pendingRunnable != null) {
+                handler.removeCallbacks(pendingRunnable);
+            }
+            pendingRunnable = new Runnable() {
+                @Override
+                public void run() {
+                    onDebounceTextChanged(s.toString());
+                }
+            };
+            handler.postDelayed(pendingRunnable, debounceDelay);
+        }
+
+        @Override
+        public void afterTextChanged(Editable s) {}
+
+        public abstract void onDebounceTextChanged(String query);
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/fragments/LogFragment.java b/contacts/src/main/java/cc/winboll/studio/contacts/fragments/LogFragment.java
new file mode 100644
index 0000000..625e327
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/fragments/LogFragment.java
@@ -0,0 +1,118 @@
+package cc.winboll.studio.contacts.fragments;
+
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.fragment.app.Fragment;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/20 12:58:15
+ * @Describe 应用日志区域视图（支持懒加载，仅切换到当前页才启动日志）
+ */
+public class LogFragment extends Fragment {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "LogFragment";
+    private static final String ARG_PAGE = "ARG_PAGE";
+
+    // ====================== 页面参数区 ======================
+    private int mPage;
+
+    // ====================== UI控件区 ======================
+    private LogView mLogView;
+
+    // ====================== 懒加载标记区 ======================
+    private boolean isViewInitialized = false; // 视图控件绑定完成标记
+    private boolean isLazyInitCompleted = false; // 懒加载总流程完成标记
+    private boolean isLogViewStarted = false; // LogView启动状态标记
+
+    // ====================== 实例化函数区 ======================
+    public static LogFragment newInstance(int page) {
+        LogUtils.d(TAG, "newInstance: 创建日志Fragment实例，页码=" + page);
+        Bundle args = new Bundle();
+        args.putInt(ARG_PAGE, page);
+        LogFragment fragment = new LogFragment();
+        fragment.setArguments(args);
+        return fragment;
+    }
+
+    // ====================== 生命周期函数区 ======================
+    @Override
+    public void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: Fragment创建开始");
+        if (getArguments() != null) {
+            mPage = getArguments().getInt(ARG_PAGE);
+            LogUtils.d(TAG, "onCreate: 读取页面参数，mPage=" + mPage);
+        }
+        LogUtils.d(TAG, "onCreate: Fragment创建完成");
+    }
+
+    @Nullable
+    @Override
+    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
+                             @Nullable Bundle savedInstanceState) {
+        LogUtils.d(TAG, "onCreateView: 加载Fragment布局");
+        View view = inflater.inflate(R.layout.fragment_log, container, false);
+        // Java7 适配：添加强制类型转换，仅初始化LogView控件（不启动）
+        mLogView = (LogView) view.findViewById(R.id.logview);
+        LogUtils.d(TAG, "onCreateView: LogView控件初始化完成（未启动）");
+        // 标记视图控件绑定完成
+        isViewInitialized = true;
+        return view;
+    }
+
+    @Override
+    public void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume: Fragment进入前台");
+        // 已完成懒加载 → 仅重启LogView（切回页面时恢复日志显示）
+        if (isLazyInitCompleted && mLogView != null && !isLogViewStarted) {
+            mLogView.start();
+            isLogViewStarted = true;
+            LogUtils.d(TAG, "onResume: LogView已重启，恢复日志显示");
+        }
+        // 未完成懒加载 → 不操作（等待MainActivity调用initData触发）
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: Fragment开始销毁");
+        if (mLogView != null) {
+            // 若LogView有停止方法，必须调用（避免后台持续占用资源，根据实际API调整）
+            // mLogView.stop(); // 关键：释放LogView资源，防止内存泄漏
+            LogUtils.d(TAG, "onDestroy: LogView资源已释放");
+        }
+        // 重置所有标记，避免重建时状态异常
+        mLogView = null;
+        isViewInitialized = false;
+        isLazyInitCompleted = false;
+        isLogViewStarted = false;
+        LogUtils.d(TAG, "onDestroy: Fragment销毁完成");
+    }
+
+    // ====================== 懒加载核心方法（供MainActivity调用） ======================
+    public void initData() {
+        // 双重防护：避免重复初始化（标记+视图就绪+控件非空）
+        if (isLazyInitCompleted || !isViewInitialized || mLogView == null || getContext() == null) {
+            LogUtils.d(TAG, "initData: 懒加载已完成/视图未就绪，跳过");
+            return;
+        }
+        LogUtils.d(TAG, "initData: 开始懒加载初始化，启动LogView");
+        // 核心：启动LogView（原onCreateView中的start逻辑迁移至此）
+        mLogView.start();
+        isLogViewStarted = true;
+        // 标记懒加载总流程完成（仅执行一次）
+        isLazyInitCompleted = true;
+        LogUtils.d(TAG, "initData: 懒加载初始化完成，LogView正常启动");
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/handlers/MainServiceHandler.java b/contacts/src/main/java/cc/winboll/studio/contacts/handlers/MainServiceHandler.java
new file mode 100644
index 0000000..bd08e58
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/handlers/MainServiceHandler.java
@@ -0,0 +1,38 @@
+package cc.winboll.studio.contacts.handlers;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/14 03:51:40
+ */
+import android.os.Handler;
+import android.os.Message;
+import cc.winboll.studio.contacts.services.MainService;
+import java.lang.ref.WeakReference;
+
+public class MainServiceHandler extends Handler {
+    public static final String TAG = "MainServiceHandler";
+
+    public static final int MSG_REMINDTHREAD = 0;
+
+    WeakReference<MainService> serviceWeakReference;
+    public MainServiceHandler(MainService service) {
+        serviceWeakReference = new WeakReference<MainService>(service);
+    }
+
+    @Override
+    public void handleMessage(Message msg) {
+        switch (msg.what) {
+            case MSG_REMINDTHREAD: // 处理下载完成消息，更新UI
+                {
+                    // 显示提醒消息
+                    //
+                    //LogUtils.d(TAG, "显示提醒消息");
+                    MainService mainService = serviceWeakReference.get();
+                    if (mainService != null) {
+                        mainService.appenMessage((String)msg.obj);
+                    }
+                    break;
+                }
+        }
+    }
+}
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/listenphonecall/CallListenerService.java b/contacts/src/main/java/cc/winboll/studio/contacts/listenphonecall/CallListenerService.java
new file mode 100644
index 0000000..9230eb4
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/listenphonecall/CallListenerService.java
@@ -0,0 +1,392 @@
+package cc.winboll.studio.contacts.listenphonecall;
+
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.ActivityInfo;
+import android.graphics.PixelFormat;
+import android.os.Build;
+import android.os.Handler;
+import android.os.IBinder;
+import android.os.Looper;
+import android.telephony.PhoneStateListener;
+import android.telephony.TelephonyManager;
+import android.text.TextUtils;
+import android.view.Gravity;
+import android.view.KeyEvent;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.view.WindowManager;
+import android.widget.Button;
+import android.widget.FrameLayout;
+import android.widget.TextView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.model.MainServiceBean;
+import cc.winboll.studio.contacts.phonecallui.PhoneCallActivity;
+import cc.winboll.studio.contacts.phonecallui.PhoneCallService;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Describe 通话监听服务（无前台服务），负责监听通话状态、显示通话悬浮窗、跳转通话界面
+ * 严格适配 Java7 语法 + Android API29-30 | 轻量稳定 | 避免内存泄漏
+ */
+public class CallListenerService extends Service {
+
+    // ====================== 常量定义区（精准适配API29-30，无冗余） ======================
+    public static final String TAG = "CallListenerService";
+
+    // Android版本常量（仅保留适配必需版本，精简无用定义）
+    private static final int ANDROID_8_API = 26;   // 悬浮窗类型适配（API26+必需）
+    private static final int ANDROID_10_API = 29;  // API29+ 悬浮窗权限/参数适配
+    private static final int ANDROID_19_API = 19;  // 透明状态栏/导航栏适配
+
+    // 延迟初始化参数（让出主线程，避免启动阻塞）
+    private static final long DELAY_INIT_MS = 100L;
+
+    // ====================== 成员属性区（按功能归类，命名规范） ======================
+    // 延迟初始化核心
+    private Handler mDelayHandler;                // 延迟处理器（避免onCreate阻塞）
+
+    // 通话监听核心
+    private TelephonyManager mTelephonyManager;   // 电话管理器（监听通话状态）
+    private PhoneStateListener mPhoneStateListener;// 通话状态监听回调
+    private String mCallNumber;                   // 当前通话号码
+    private boolean mIsCallingIn;                 // 是否为来电（true=来电，false=去电）
+
+    // 悬浮窗核心
+    private WindowManager mWindowManager;         // 窗口管理器（添加/移除悬浮窗）
+    private WindowManager.LayoutParams mWindowParams;// 悬浮窗参数配置
+    private View mPhoneCallView;                  // 通话悬浮窗根视图
+    private TextView mTvCallNumber;               // 悬浮窗号码显示控件
+    private Button mBtnOpenApp;                   // 悬浮窗跳转APP按钮
+    private boolean mHasShown;                    // 悬浮窗显示状态标记（避免重复操作）
+
+    // ====================== Service生命周期方法区（按执行顺序排列） ======================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "===== onCreate: 通话监听服务启动 =====");
+
+        // 延迟初始化所有逻辑（让出主线程，避免启动阻塞，提升启动速度）
+        initDelayHandlerAndLogic();
+
+        LogUtils.d(TAG, "===== onCreate: 通话监听服务启动完成 =====");
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand: 服务被启动，startId=" + startId);
+
+        // 加载服务配置，决定重启策略（启用则自动重启，禁用则默认）
+        MainServiceBean serviceConfig = MainServiceBean.loadBean(this, MainServiceBean.class);
+        int startMode = (serviceConfig != null && serviceConfig.isEnable()) ? START_STICKY : super.onStartCommand(intent, flags, startId);
+        LogUtils.d(TAG, "onStartCommand: 服务启动模式：" + (startMode == START_STICKY ? "START_STICKY（自动重启）" : "默认模式"));
+
+        return startMode;
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.d(TAG, "onBind: 服务无需绑定，返回null");
+        return null;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "===== onDestroy: 通话监听服务开始销毁 =====");
+
+        // 全量清理资源，彻底避免内存泄漏
+        dismissFloatWindow();        // 移除悬浮窗
+        unregisterPhoneStateListener();// 注销通话监听
+        clearDelayHandler();         // 清空延迟任务
+        resetAllReferences();        // 置空所有成员属性
+
+        LogUtils.d(TAG, "===== onDestroy: 通话监听服务销毁完成 =====");
+    }
+
+    // ====================== 延迟初始化方法区（非阻塞启动，提升稳定性） ======================
+    /**
+     * 初始化延迟处理器，执行核心逻辑（通话监听+悬浮窗）
+     */
+    private void initDelayHandlerAndLogic() {
+        mDelayHandler = new Handler(Looper.getMainLooper());
+        mDelayHandler.postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "initDelayHandlerAndLogic: 开始延迟初始化核心逻辑");
+					initPhoneStateListener();  // 初始化通话状态监听
+					initFloatWindow();         // 初始化通话悬浮窗
+					LogUtils.d(TAG, "initDelayHandlerAndLogic: 延迟初始化完成，服务就绪");
+				}
+			}, DELAY_INIT_MS);
+    }
+
+    /**
+     * 初始化通话状态监听（注册TelephonyManager，响应通话状态变化）
+     */
+    private void initPhoneStateListener() {
+        // 1. 创建通话状态监听回调
+        mPhoneStateListener = new PhoneStateListener() {
+            @Override
+            public void onCallStateChanged(int callState, String incomingNumber) {
+                super.onCallStateChanged(callState, incomingNumber);
+                mCallNumber = incomingNumber;
+                LogUtils.d(TAG, "onCallStateChanged: 通话状态变化，状态=" + getCallStateDesc(callState) + "，号码=" + incomingNumber);
+
+                // 响应不同通话状态
+                switch (callState) {
+                    case TelephonyManager.CALL_STATE_IDLE:
+                        // 通话空闲（挂断/未通话）：隐藏悬浮窗
+                        dismissFloatWindow();
+                        break;
+                    case TelephonyManager.CALL_STATE_RINGING:
+                        // 来电响铃：标记来电状态，更新UI并显示悬浮窗
+                        mIsCallingIn = true;
+                        updateFloatWindowUI();
+                        showFloatWindow();
+                        break;
+                    case TelephonyManager.CALL_STATE_OFFHOOK:
+                        // 通话中（接听/拨号）：更新UI并显示悬浮窗
+                        updateFloatWindowUI();
+                        showFloatWindow();
+                        break;
+                }
+            }
+        };
+
+        // 2. 注册通话监听（非空校验，避免崩溃）
+        mTelephonyManager = (TelephonyManager) getSystemService(TELEPHONY_SERVICE);
+        if (mTelephonyManager != null) {
+            mTelephonyManager.listen(mPhoneStateListener, PhoneStateListener.LISTEN_CALL_STATE);
+            LogUtils.d(TAG, "initPhoneStateListener: 通话状态监听注册成功");
+        } else {
+            LogUtils.e(TAG, "initPhoneStateListener: TelephonyManager获取失败，监听注册失败");
+        }
+    }
+
+    /**
+     * 初始化通话悬浮窗（配置参数+加载布局+绑定事件，适配API29-30）
+     */
+    private void initFloatWindow() {
+        // 1. 获取窗口管理器（非空校验，避免后续崩溃）
+        mWindowManager = (WindowManager) getApplicationContext().getSystemService(Context.WINDOW_SERVICE);
+        if (mWindowManager == null) {
+            LogUtils.e(TAG, "initFloatWindow: WindowManager获取失败，悬浮窗初始化失败");
+            return;
+        }
+
+        // 2. 配置悬浮窗参数（精准适配API29+，兼容悬浮窗权限）
+        initFloatWindowParams();
+
+        // 3. 加载悬浮窗布局（添加返回键拦截，避免误关闭）
+        FrameLayout keyInterceptorLayout = new FrameLayout(this) {
+            @Override
+            public boolean dispatchKeyEvent(KeyEvent event) {
+                // 拦截返回键，保障通话时悬浮窗正常显示
+                if (event.getAction() == KeyEvent.ACTION_DOWN && event.getKeyCode() == KeyEvent.KEYCODE_BACK) {
+                    LogUtils.d(TAG, "dispatchKeyEvent: 拦截悬浮窗返回键事件");
+                    return true;
+                }
+                return super.dispatchKeyEvent(event);
+            }
+        };
+        mPhoneCallView = LayoutInflater.from(this).inflate(R.layout.view_phone_call, keyInterceptorLayout);
+
+        // 4. 绑定悬浮窗控件，设置跳转按钮事件
+        bindFloatWindowViews();
+
+        LogUtils.d(TAG, "initFloatWindow: 悬浮窗初始化完成");
+    }
+
+    /**
+     * 配置悬浮窗参数（适配API29+窗口类型，确保正常显示）
+     */
+    private void initFloatWindowParams() {
+        mWindowParams = new WindowManager.LayoutParams();
+        // 窗口位置：顶部居中
+        mWindowParams.gravity = Gravity.CENTER_HORIZONTAL | Gravity.TOP;
+        // 窗口大小：宽度全屏，高度自适应
+        mWindowParams.width = WindowManager.LayoutParams.MATCH_PARENT;
+        mWindowParams.height = WindowManager.LayoutParams.WRAP_CONTENT;
+        // 固定竖屏显示
+        mWindowParams.screenOrientation = ActivityInfo.SCREEN_ORIENTATION_PORTRAIT;
+        // 窗口格式：半透明
+        mWindowParams.format = PixelFormat.TRANSLUCENT;
+
+        // 窗口类型（API29+ 强制用 TYPE_APPLICATION_OVERLAY，需悬浮窗权限）
+        if (Build.VERSION.SDK_INT >= ANDROID_10_API) {
+            mWindowParams.type = WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY;
+            LogUtils.d(TAG, "initFloatWindowParams: API29+ 悬浮窗类型=TYPE_APPLICATION_OVERLAY（需开启悬浮窗权限）");
+        } else if (Build.VERSION.SDK_INT >= ANDROID_8_API) {
+            mWindowParams.type = WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY;
+        } else {
+            mWindowParams.type = WindowManager.LayoutParams.TYPE_PHONE;
+        }
+
+        // 窗口标志：无焦点（不抢占输入）、全屏布局、兼容透明状态栏/导航栏
+        mWindowParams.flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
+			| WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN;
+        if (Build.VERSION.SDK_INT >= ANDROID_19_API) {
+            mWindowParams.flags |= WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS
+				| WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION;
+        }
+    }
+
+    /**
+     * 绑定悬浮窗控件，设置跳转通话详情页事件
+     */
+    private void bindFloatWindowViews() {
+        mTvCallNumber = (TextView) mPhoneCallView.findViewById(R.id.tv_call_number);
+        mBtnOpenApp = (Button) mPhoneCallView.findViewById(R.id.btn_open_app);
+
+        // 跳转按钮点击事件
+        mBtnOpenApp.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					if (TextUtils.isEmpty(mCallNumber)) {
+						LogUtils.w(TAG, "bindFloatWindowViews: 通话号码为空，跳过跳转");
+						return;
+					}
+					LogUtils.d(TAG, "bindFloatWindowViews: 点击跳转通话详情页，号码=" + mCallNumber);
+					PhoneCallService.CallType callType = mIsCallingIn ? PhoneCallService.CallType.CALL_IN : PhoneCallService.CallType.CALL_OUT;
+					PhoneCallActivity.actionStart(CallListenerService.this, mCallNumber, callType);
+				}
+			});
+    }
+
+    // ====================== 悬浮窗功能逻辑区（显示/隐藏/更新UI） ======================
+    /**
+     * 显示通话悬浮窗（避免重复添加，防止窗口泄露）
+     */
+    private void showFloatWindow() {
+        if (!mHasShown && mPhoneCallView != null && mWindowManager != null) {
+            try {
+                mWindowManager.addView(mPhoneCallView, mWindowParams);
+                mHasShown = true;
+                LogUtils.d(TAG, "showFloatWindow: 悬浮窗显示成功");
+            } catch (SecurityException e) {
+                LogUtils.e(TAG, "showFloatWindow: 悬浮窗显示失败（无悬浮窗权限，需引导用户开启）", e);
+            } catch (Exception e) {
+                LogUtils.e(TAG, "showFloatWindow: 悬浮窗显示异常", e);
+            }
+        } else {
+            LogUtils.d(TAG, "showFloatWindow: 悬浮窗已显示/组件未初始化，跳过显示");
+        }
+    }
+
+    /**
+     * 隐藏通话悬浮窗（避免重复移除，防止崩溃）
+     */
+    private void dismissFloatWindow() {
+        if (mHasShown && mPhoneCallView != null && mWindowManager != null) {
+            try {
+                mWindowManager.removeView(mPhoneCallView);
+                LogUtils.d(TAG, "dismissFloatWindow: 悬浮窗隐藏成功");
+            } catch (Exception e) {
+                LogUtils.e(TAG, "dismissFloatWindow: 悬浮窗隐藏异常", e);
+            } finally {
+                mHasShown = false;
+                mIsCallingIn = false;  // 重置来电状态标记
+            }
+        } else {
+            LogUtils.d(TAG, "dismissFloatWindow: 悬浮窗已隐藏/组件未初始化，跳过隐藏");
+        }
+    }
+
+    /**
+     * 更新悬浮窗UI（显示格式化号码+通话类型图标）
+     */
+    private void updateFloatWindowUI() {
+        if (mTvCallNumber == null || TextUtils.isEmpty(mCallNumber)) {
+            LogUtils.w(TAG, "updateFloatWindowUI: 控件未初始化/号码为空，更新失败");
+            return;
+        }
+
+        // 格式化11位手机号（3-4-4分隔，提升可读性）
+        String formattedNumber = formatPhoneNumber(mCallNumber);
+        mTvCallNumber.setText(formattedNumber);
+
+        // 设置通话类型图标（来电/去电区分）
+        int iconResId = mIsCallingIn ? R.drawable.ic_phone_call_in : R.drawable.ic_phone_call_out;
+        mTvCallNumber.setCompoundDrawablesWithIntrinsicBounds(
+			null, null, getResources().getDrawable(iconResId), null
+        );
+        LogUtils.d(TAG, "updateFloatWindowUI: 悬浮窗UI更新完成，号码=" + formattedNumber + "，类型=" + (mIsCallingIn ? "来电" : "去电"));
+    }
+
+    // ====================== 资源清理方法区（服务销毁时全量释放） ======================
+    /**
+     * 注销通话状态监听（释放TelephonyManager资源）
+     */
+    private void unregisterPhoneStateListener() {
+        if (mTelephonyManager != null && mPhoneStateListener != null) {
+            mTelephonyManager.listen(mPhoneStateListener, PhoneStateListener.LISTEN_NONE);
+            LogUtils.d(TAG, "unregisterPhoneStateListener: 通话监听已注销");
+        }
+        mTelephonyManager = null;
+        mPhoneStateListener = null;
+    }
+
+    /**
+     * 清空延迟处理器（移除未执行任务，避免内存泄漏）
+     */
+    private void clearDelayHandler() {
+        if (mDelayHandler != null) {
+            mDelayHandler.removeCallbacksAndMessages(null);
+            mDelayHandler = null;
+            LogUtils.d(TAG, "clearDelayHandler: 延迟处理器已清空");
+        }
+    }
+
+    /**
+     * 置空所有成员属性（彻底释放引用，避免内存泄漏）
+     */
+    private void resetAllReferences() {
+        mCallNumber = null;
+        mPhoneCallView = null;
+        mWindowParams = null;
+        mWindowManager = null;
+        mTvCallNumber = null;
+        mBtnOpenApp = null;
+    }
+
+    // ====================== 工具方法区（通用辅助功能，独立归类） ======================
+    /**
+     * 格式化手机号（11位手机号：3-4-4分隔，非11位保持原格式）
+     * @param phoneNum 待格式化的手机号
+     * @return 格式化后的号码
+     */
+    public static String formatPhoneNumber(String phoneNum) {
+        if (!TextUtils.isEmpty(phoneNum) && phoneNum.length() == 11) {
+            String formatted = phoneNum.substring(0, 3) + "-"
+				+ phoneNum.substring(3, 7) + "-"
+				+ phoneNum.substring(7);
+            LogUtils.d(TAG, "formatPhoneNumber: 号码格式化，原=" + phoneNum + "，新=" + formatted);
+            return formatted;
+        }
+        LogUtils.d(TAG, "formatPhoneNumber: 非11位号码，无需格式化，号码=" + phoneNum);
+        return phoneNum;
+    }
+
+    /**
+     * 转换通话状态为文字描述（便于日志查看，快速定位问题）
+     * @param callState 通话状态（TelephonyManager常量）
+     * @return 状态描述文字
+     */
+    private String getCallStateDesc(int callState) {
+        switch (callState) {
+            case TelephonyManager.CALL_STATE_IDLE:
+                return "空闲（挂断/未通话）";
+            case TelephonyManager.CALL_STATE_RINGING:
+                return "响铃（来电）";
+            case TelephonyManager.CALL_STATE_OFFHOOK:
+                return "通话中（接听/拨号）";
+            default:
+                return "未知状态";
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/model/CallLogModel.java b/contacts/src/main/java/cc/winboll/studio/contacts/model/CallLogModel.java
new file mode 100644
index 0000000..377fbb7
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/model/CallLogModel.java
@@ -0,0 +1,43 @@
+package cc.winboll.studio.contacts.model;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.Date;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/26 13:10:57
+ * @Describe 通话记录数据模型
+ */
+public class CallLogModel {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "CallLogModel";
+
+    // ====================== 成员变量区 ======================
+    private String phoneNumber;
+    private String callStatus;
+    private Date callDate;
+
+    // ====================== 构造函数区 ======================
+    public CallLogModel(String phoneNumber, String callStatus, Date callDate) {
+        // 去除号码中的空格并初始化
+        this.phoneNumber = phoneNumber.replaceAll("\\s", "");
+        this.callStatus = callStatus;
+        this.callDate = callDate;
+
+        LogUtils.d(TAG, "CallLogModel: 初始化通话记录模型 | 号码=" + this.phoneNumber 
+				   + " | 状态=" + this.callStatus + " | 时间=" + this.callDate);
+    }
+
+    // ====================== Getter 方法区 ======================
+    public String getPhoneNumber() {
+        return phoneNumber;
+    }
+
+    public String getCallStatus() {
+        return callStatus;
+    }
+
+    public Date getCallDate() {
+        return callDate;
+    }
+}
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/model/ContactModel.java b/contacts/src/main/java/cc/winboll/studio/contacts/model/ContactModel.java
new file mode 100644
index 0000000..e83c1f7
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/model/ContactModel.java
@@ -0,0 +1,135 @@
+package cc.winboll.studio.contacts.model;
+
+import net.sourceforge.pinyin4j.PinyinHelper;
+import net.sourceforge.pinyin4j.format.HanyuPinyinCaseType;
+import net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;
+import net.sourceforge.pinyin4j.format.HanyuPinyinToneType;
+import net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/08/30 14:32
+ * @Describe 联系人信息数据模型，支持姓名转全拼和拼音首字母
+ */
+public class ContactModel {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "ContactModel";
+    // 汉字匹配正则常量，避免重复创建
+    private static final String CHINESE_CHAR_REGEX = "[\\u4e00-\\u9fa5]";
+
+    // ====================== 成员变量区 ======================
+    private String name;
+    private String number;
+    private String pinyin;
+    private String pinyinFirstLetter;
+
+    // ====================== 构造函数区 ======================
+    public ContactModel(String name, String number) {
+        LogUtils.d(TAG, "ContactModel: 开始初始化联系人模型");
+        this.name = name == null ? "" : name;
+        // 去除号码空格，空值处理为""
+        this.number = number == null ? "" : number.replaceAll("\\s", "");
+        // 初始化拼音和拼音首字母
+        this.pinyin = convertToPinyin(this.name);
+        this.pinyinFirstLetter = convertToPinyinFirstLetter(this.name);
+
+        LogUtils.d(TAG, "ContactModel: 联系人初始化完成 | 姓名=" + this.name 
+				   + " | 号码=" + this.number + " | 全拼=" + this.pinyin 
+				   + " | 拼音首字母=" + this.pinyinFirstLetter);
+    }
+
+    // ====================== 拼音转换工具方法区 ======================
+    /**
+     * 姓名转为全拼（多音字默认取首个拼音）
+     */
+    private String convertToPinyin(String chinese) {
+        LogUtils.d(TAG, "convertToPinyin: 开始转换姓名为全拼，姓名=" + chinese);
+        HanyuPinyinOutputFormat format = getPinyinOutputFormat();
+        StringBuilder pinyinSb = new StringBuilder();
+
+        for (int i = 0; i < chinese.length(); i++) {
+            char ch = chinese.charAt(i);
+            // 仅处理汉字
+            if (Character.toString(ch).matches(CHINESE_CHAR_REGEX)) {
+                try {
+                    String[] pinyinArray = PinyinHelper.toHanyuPinyinStringArray(ch, format);
+                    if (pinyinArray != null && pinyinArray.length > 0) {
+                        pinyinSb.append(pinyinArray[0]);
+                        LogUtils.v(TAG, "convertToPinyin: 字符[" + ch + "]转为拼音[" + pinyinArray[0] + "]");
+                    }
+                } catch (BadHanyuPinyinOutputFormatCombination e) {
+                    LogUtils.e(TAG, "convertToPinyin: 拼音转换异常，字符=" + ch, e);
+                }
+            } else {
+                pinyinSb.append(ch);
+                LogUtils.v(TAG, "convertToPinyin: 非汉字字符直接拼接，字符=" + ch);
+            }
+        }
+
+        String result = pinyinSb.toString();
+        LogUtils.d(TAG, "convertToPinyin: 全拼转换完成，结果=" + result);
+        return result;
+    }
+
+    /**
+     * 姓名转为拼音首字母（多音字默认取首个拼音首字母）
+     */
+    private String convertToPinyinFirstLetter(String chinese) {
+        LogUtils.d(TAG, "convertToPinyinFirstLetter: 开始转换姓名为拼音首字母，姓名=" + chinese);
+        HanyuPinyinOutputFormat format = getPinyinOutputFormat();
+        StringBuilder firstLetterSb = new StringBuilder();
+
+        for (int i = 0; i < chinese.length(); i++) {
+            char ch = chinese.charAt(i);
+            if (Character.toString(ch).matches(CHINESE_CHAR_REGEX)) {
+                try {
+                    String[] pinyinArray = PinyinHelper.toHanyuPinyinStringArray(ch, format);
+                    if (pinyinArray != null && pinyinArray.length > 0) {
+                        char firstChar = pinyinArray[0].charAt(0);
+                        firstLetterSb.append(firstChar);
+                        LogUtils.v(TAG, "convertToPinyinFirstLetter: 字符[" + ch + "]转为首字母[" + firstChar + "]");
+                    }
+                } catch (BadHanyuPinyinOutputFormatCombination e) {
+                    LogUtils.e(TAG, "convertToPinyinFirstLetter: 拼音首字母转换异常，字符=" + ch, e);
+                }
+            } else {
+                firstLetterSb.append(ch);
+                LogUtils.v(TAG, "convertToPinyinFirstLetter: 非汉字字符直接拼接，字符=" + ch);
+            }
+        }
+
+        String result = firstLetterSb.toString();
+        LogUtils.d(TAG, "convertToPinyinFirstLetter: 拼音首字母转换完成，结果=" + result);
+        return result;
+    }
+
+    /**
+     * 获取统一的拼音输出格式（小写、无音调）
+     * 抽离为公共方法，避免重复创建对象
+     */
+    private HanyuPinyinOutputFormat getPinyinOutputFormat() {
+        HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
+        format.setCaseType(HanyuPinyinCaseType.LOWERCASE);
+        format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
+        return format;
+    }
+
+    // ====================== Getter 方法区 ======================
+    public String getName() {
+        return name;
+    }
+
+    public String getNumber() {
+        return number;
+    }
+
+    public String getPinyin() {
+        return pinyin;
+    }
+
+    public String getPinyinFirstLetter() {
+        return pinyinFirstLetter;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/model/MainServiceBean.java b/contacts/src/main/java/cc/winboll/studio/contacts/model/MainServiceBean.java
new file mode 100644
index 0000000..63b24ff
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/model/MainServiceBean.java
@@ -0,0 +1,91 @@
+package cc.winboll.studio.contacts.model;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/13 07:06:13
+ * @Describe 主服务配置实体类，支持JSON序列化与反序列化
+ */
+public class MainServiceBean extends BaseBean {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "MainServiceBean";
+    private static final String JSON_KEY_IS_ENABLE = "isEnable";
+
+    // ====================== 成员变量区 ======================
+    private boolean isEnable;
+
+    // ====================== 构造函数区 ======================
+    public MainServiceBean() {
+        this.isEnable = false;
+        LogUtils.d(TAG, "MainServiceBean: 初始化实体类，默认状态为禁用");
+    }
+
+    // ====================== Getter & Setter 方法区 ======================
+    public void setIsEnable(boolean isEnable) {
+        LogUtils.d(TAG, "setIsEnable: 服务状态设置为" + isEnable);
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    // ====================== 重写 BaseBean 抽象方法区 ======================
+    @Override
+    public String getName() {
+        String className = MainServiceBean.class.getName();
+        LogUtils.v(TAG, "getName: 获取类名=" + className);
+        return className;
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        LogUtils.d(TAG, "writeThisToJsonWriter: 开始将实体类写入JSON");
+        super.writeThisToJsonWriter(jsonWriter);
+        // 写入服务启用状态字段
+        jsonWriter.name(JSON_KEY_IS_ENABLE).value(this.isEnable);
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON写入完成，isEnable=" + this.isEnable);
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 优先调用父类方法处理通用字段
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            LogUtils.v(TAG, "initObjectsFromJsonReader: 父类已处理字段=" + name);
+            return true;
+        }
+
+        // 处理当前类专属字段
+        if (JSON_KEY_IS_ENABLE.equals(name)) {
+            this.isEnable = jsonReader.nextBoolean();
+            LogUtils.d(TAG, "initObjectsFromJsonReader: 读取字段[" + name + "]值=" + this.isEnable);
+            return true;
+        }
+
+        LogUtils.w(TAG, "initObjectsFromJsonReader: 未识别字段=" + name);
+        return false;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader: 开始从JSON读取实体类数据");
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                LogUtils.w(TAG, "readBeanFromJsonReader: 跳过未识别字段=" + name);
+                jsonReader.skipValue();
+            }
+        }
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON读取完成，当前实体状态=" + this.isEnable);
+        return this;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/model/PhoneConnectRuleBean.java b/contacts/src/main/java/cc/winboll/studio/contacts/model/PhoneConnectRuleBean.java
new file mode 100644
index 0000000..6d3c765
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/model/PhoneConnectRuleBean.java
@@ -0,0 +1,148 @@
+package cc.winboll.studio.contacts.model;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/21 09:52:10
+ * @Describe 电话黑名单规则实体类，支持JSON序列化与反序列化
+ */
+public class PhoneConnectRuleBean extends BaseBean {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "PhoneConnectRuleModel";
+    // JSON字段名常量，避免硬编码错误
+    private static final String JSON_KEY_RULE_TEXT = "ruleText";
+    private static final String JSON_KEY_ALLOW_CONNECTION = "isAllowConnection";
+    private static final String JSON_KEY_IS_ENABLE = "isEnable";
+
+    // ====================== 成员变量区 ======================
+    private String ruleText;
+    private boolean isAllowConnection;
+    private boolean isEnable;
+    private boolean isSimpleView;
+
+    // ====================== 构造函数区 ======================
+    /**
+     * 默认构造，初始化默认值
+     */
+    public PhoneConnectRuleBean() {
+        this.ruleText = "";
+        this.isAllowConnection = false;
+        this.isEnable = false;
+        this.isSimpleView = true;
+        LogUtils.d(TAG, "PhoneConnectRuleModel: 默认构造初始化完成 | 规则文本空串，默认禁用状态");
+    }
+
+    /**
+     * 带参构造，初始化核心规则参数
+     */
+    public PhoneConnectRuleBean(String ruleText, boolean isAllowConnection, boolean isEnable) {
+        this.ruleText = ruleText == null ? "" : ruleText;
+        this.isAllowConnection = isAllowConnection;
+        this.isEnable = isEnable;
+        this.isSimpleView = true;
+        LogUtils.d(TAG, "PhoneConnectRuleModel: 带参构造初始化完成 | 规则文本=" + this.ruleText
+				   + " | 允许连接=" + this.isAllowConnection + " | 规则启用=" + this.isEnable);
+    }
+
+    // ====================== Getter & Setter 方法区 ======================
+    public String getRuleText() {
+        return ruleText;
+    }
+
+    public void setRuleText(String ruleText) {
+        String oldValue = this.ruleText;
+        this.ruleText = ruleText == null ? "" : ruleText;
+        LogUtils.d(TAG, "setRuleText: 规则文本更新 | 旧值=" + oldValue + " | 新值=" + this.ruleText);
+    }
+
+    public boolean isAllowConnection() {
+        return isAllowConnection;
+    }
+
+    public void setIsAllowConnection(boolean isAllowConnection) {
+        LogUtils.d(TAG, "setIsAllowConnection: 允许连接状态更新为" + isAllowConnection);
+        this.isAllowConnection = isAllowConnection;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        LogUtils.d(TAG, "setIsEnable: 规则启用状态更新为" + isEnable);
+        this.isEnable = isEnable;
+    }
+
+    public boolean isSimpleView() {
+        return isSimpleView;
+    }
+
+    public void setIsSimpleView(boolean isSimpleView) {
+        LogUtils.d(TAG, "setIsSimpleView: 视图模式更新 | 简洁模式=" + isSimpleView);
+        this.isSimpleView = isSimpleView;
+    }
+
+    // ====================== 重写 BaseBean 抽象方法区 ======================
+    @Override
+    public String getName() {
+        String className = PhoneConnectRuleBean.class.getName();
+        LogUtils.v(TAG, "getName: 获取当前类名=" + className);
+        return className;
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        LogUtils.d(TAG, "writeThisToJsonWriter: 开始JSON序列化规则数据");
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化核心字段
+        jsonWriter.name(JSON_KEY_RULE_TEXT).value(getRuleText());
+        jsonWriter.name(JSON_KEY_ALLOW_CONNECTION).value(isAllowConnection());
+        jsonWriter.name(JSON_KEY_IS_ENABLE).value(isEnable());
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON序列化完成");
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 优先让父类处理通用字段
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            LogUtils.v(TAG, "initObjectsFromJsonReader: 父类已处理字段=" + name);
+            return true;
+        }
+
+        // 处理当前类专属字段
+        if (JSON_KEY_RULE_TEXT.equals(name)) {
+            setRuleText(jsonReader.nextString());
+        } else if (JSON_KEY_ALLOW_CONNECTION.equals(name)) {
+            setIsAllowConnection(jsonReader.nextBoolean());
+        } else if (JSON_KEY_IS_ENABLE.equals(name)) {
+            setIsEnable(jsonReader.nextBoolean());
+        } else {
+            LogUtils.w(TAG, "initObjectsFromJsonReader: 未识别的JSON字段=" + name);
+            return false;
+        }
+        LogUtils.v(TAG, "initObjectsFromJsonReader: 成功解析字段=" + name);
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader: 开始从JSON解析规则数据");
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, fieldName)) {
+                LogUtils.w(TAG, "readBeanFromJsonReader: 跳过未识别字段=" + fieldName);
+                jsonReader.skipValue();
+            }
+        }
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON解析完成 | 解析后规则=" + getRuleText());
+        return this;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/model/RingTongBean.java b/contacts/src/main/java/cc/winboll/studio/contacts/model/RingTongBean.java
new file mode 100644
index 0000000..ab633ed
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/model/RingTongBean.java
@@ -0,0 +1,107 @@
+package cc.winboll.studio.contacts.model;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/24 18:47:11
+ * @Describe 手机铃声设置参数类，支持JSON序列化与反序列化
+ */
+public class RingTongBean extends BaseBean {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "AudioRingTongBean";
+    private static final String JSON_KEY_STREAM_VOLUME = "streamVolume";
+    // 铃声音量范围常量（参考AudioManager标准）
+    private static final int VOLUME_MIN = 0;
+    private static final int VOLUME_MAX = 100;
+
+    // ====================== 成员变量区 ======================
+    private int streamVolume;
+
+    // ====================== 构造函数区 ======================
+    /**
+     * 默认构造，铃声音量初始化为最大值
+     */
+    public RingTongBean() {
+        this.streamVolume = VOLUME_MAX;
+        LogUtils.d(TAG, "RingTongBean: 默认构造初始化 | 铃声音量=" + this.streamVolume);
+    }
+
+    /**
+     * 带参构造，初始化指定铃声音量
+     */
+    public RingTongBean(int streamVolume) {
+        // 音量值范围校验，避免非法值
+        this.streamVolume = Math.max(VOLUME_MIN, Math.min(VOLUME_MAX, streamVolume));
+        LogUtils.d(TAG, "RingTongBean: 带参构造初始化 | 原始音量=" + streamVolume + " | 校正后=" + this.streamVolume);
+    }
+
+    // ====================== Getter & Setter 方法区 ======================
+    public int getStreamVolume() {
+        return streamVolume;
+    }
+
+    public void setStreamVolume(int streamVolume) {
+        int oldVolume = this.streamVolume;
+        // 音量值范围校验
+        this.streamVolume = Math.max(VOLUME_MIN, Math.min(VOLUME_MAX, streamVolume));
+        LogUtils.d(TAG, "setStreamVolume: 铃声音量更新 | 旧值=" + oldVolume + " | 新值=" + this.streamVolume);
+    }
+
+    // ====================== 重写 BaseBean 抽象方法区 ======================
+    @Override
+    public String getName() {
+        String className = RingTongBean.class.getName();
+        LogUtils.v(TAG, "getName: 获取当前类名=" + className);
+        return className;
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        LogUtils.d(TAG, "writeThisToJsonWriter: 开始JSON序列化铃声音量参数");
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name(JSON_KEY_STREAM_VOLUME).value(getStreamVolume());
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON序列化完成 | 音量值=" + getStreamVolume());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 优先调用父类处理通用字段
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            LogUtils.v(TAG, "initObjectsFromJsonReader: 父类已处理字段=" + name);
+            return true;
+        }
+
+        // 处理当前类专属字段
+        if (JSON_KEY_STREAM_VOLUME.equals(name)) {
+            setStreamVolume(jsonReader.nextInt());
+            LogUtils.v(TAG, "initObjectsFromJsonReader: 解析字段[" + name + "]值=" + this.streamVolume);
+            return true;
+        }
+
+        LogUtils.w(TAG, "initObjectsFromJsonReader: 未识别的JSON字段=" + name);
+        return false;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader: 开始从JSON解析铃声音量参数");
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, fieldName)) {
+                LogUtils.w(TAG, "readBeanFromJsonReader: 跳过未识别字段=" + fieldName);
+                jsonReader.skipValue();
+            }
+        }
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON解析完成 | 最终音量值=" + this.streamVolume);
+        return this;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/model/SettingsBean.java b/contacts/src/main/java/cc/winboll/studio/contacts/model/SettingsBean.java
new file mode 100644
index 0000000..2b40c8c
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/model/SettingsBean.java
@@ -0,0 +1,216 @@
+package cc.winboll.studio.contacts.model;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+
+import java.io.IOException;
+
+import cc.winboll.studio.contacts.utils.IntUtils;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/02 19:51:40
+ * @Describe 应用设置数据模型，支持云盾防御配置与JSON序列化
+ */
+public class SettingsBean extends BaseBean {
+
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "SettingsModel";
+    // 数值范围常量
+    public static final int MAX_INTRANGE = 666666;
+    public static final int MIN_INTRANGE = 1;
+    // JSON字段名常量，消除硬编码
+    private static final String JSON_KEY_DUN_TOTAL = "dunTotalCount";
+    private static final String JSON_KEY_DUN_CURRENT = "dunCurrentCount";
+    private static final String JSON_KEY_DUN_RESUME_SECOND = "dunResumeSecondCount";
+    private static final String JSON_KEY_DUN_RESUME_COUNT = "dunResumeCount";
+    private static final String JSON_KEY_DUN_ENABLE = "isEnableDun";
+    private static final String JSON_KEY_URL = "szBoBullToon_URL";
+
+    // ====================== 成员变量区 ======================
+    // 云盾防御层数量
+    private int dunTotalCount;
+    // 当前云盾防御层
+    private int dunCurrentCount;
+    // 防御层恢复时间间隔(秒钟)
+    private int dunResumeSecondCount;
+    // 每次恢复防御层数
+    private int dunResumeCount;
+    // 是否启用云盾
+    private boolean isEnableDun;
+    // BoBullToon 应用模块数据请求地址
+    private String szBoBullToon_URL;
+
+    // ====================== 构造函数区 ======================
+    /**
+     * 默认构造，初始化默认配置
+     */
+    public SettingsBean() {
+        this.dunTotalCount = 6;
+        this.dunCurrentCount = 6;
+        this.dunResumeSecondCount = 60;
+        this.dunResumeCount = 1;
+        this.isEnableDun = false;
+        this.szBoBullToon_URL = "";
+        LogUtils.d(TAG, "SettingsModel: 默认构造初始化完成 | 云盾默认配置加载完毕");
+    }
+
+    /**
+     * 带参构造，初始化自定义配置并校验数值范围
+     */
+    public SettingsBean(int dunTotalCount, int dunCurrentCount, int dunResumeSecondCount,
+                         int dunResumeCount, boolean isEnableDun, String szBoBullToon_URL) {
+        this.dunTotalCount = getSettingsModelRangeInt(dunTotalCount);
+        this.dunCurrentCount = getSettingsModelRangeInt(dunCurrentCount);
+        this.dunResumeSecondCount = getSettingsModelRangeInt(dunResumeSecondCount);
+        this.dunResumeCount = getSettingsModelRangeInt(dunResumeCount);
+        this.isEnableDun = isEnableDun;
+        this.szBoBullToon_URL = szBoBullToon_URL == null ? "" : szBoBullToon_URL;
+
+        LogUtils.d(TAG, "SettingsModel: 带参构造初始化完成 | 总层数=" + this.dunTotalCount
+				   + " | 当前层数=" + this.dunCurrentCount + " | 恢复间隔=" + this.dunResumeSecondCount
+				   + " | 恢复层数=" + this.dunResumeCount + " | 云盾启用=" + this.isEnableDun);
+    }
+
+    // ====================== 私有工具方法区 ======================
+    /**
+     * 数值范围校验，确保参数在 MIN~MAX 区间内
+     */
+    private int getSettingsModelRangeInt(int origin) {
+        int result = IntUtils.getIntInRange(origin, MIN_INTRANGE, MAX_INTRANGE);
+        if (result != origin) {
+            LogUtils.w(TAG, "getSettingsModelRangeInt: 数值校正 | 原始值=" + origin + " | 校正后=" + result);
+        }
+        return result;
+    }
+
+    // ====================== Getter & Setter 方法区 ======================
+    public int getDunTotalCount() {
+        return dunTotalCount;
+    }
+
+    public void setDunTotalCount(int dunTotalCount) {
+        int oldValue = this.dunTotalCount;
+        this.dunTotalCount = getSettingsModelRangeInt(dunTotalCount);
+        LogUtils.d(TAG, "setDunTotalCount: 总防御层数更新 | 旧值=" + oldValue + " | 新值=" + this.dunTotalCount);
+    }
+
+    public int getDunCurrentCount() {
+        return dunCurrentCount;
+    }
+
+    public void setDunCurrentCount(int dunCurrentCount) {
+        int oldValue = this.dunCurrentCount;
+        this.dunCurrentCount = getSettingsModelRangeInt(dunCurrentCount);
+        LogUtils.d(TAG, "setDunCurrentCount: 当前防御层数更新 | 旧值=" + oldValue + " | 新值=" + this.dunCurrentCount);
+    }
+
+    public int getDunResumeSecondCount() {
+        return dunResumeSecondCount;
+    }
+
+    public void setDunResumeSecondCount(int dunResumeSecondCount) {
+        int oldValue = this.dunResumeSecondCount;
+        this.dunResumeSecondCount = getSettingsModelRangeInt(dunResumeSecondCount);
+        LogUtils.d(TAG, "setDunResumeSecondCount: 恢复间隔更新 | 旧值=" + oldValue + " | 新值=" + this.dunResumeSecondCount);
+    }
+
+    public int getDunResumeCount() {
+        return dunResumeCount;
+    }
+
+    public void setDunResumeCount(int dunResumeCount) {
+        int oldValue = this.dunResumeCount;
+        this.dunResumeCount = getSettingsModelRangeInt(dunResumeCount);
+        LogUtils.d(TAG, "setDunResumeCount: 恢复层数更新 | 旧值=" + oldValue + " | 新值=" + this.dunResumeCount);
+    }
+
+    public boolean isEnableDun() {
+        return isEnableDun;
+    }
+
+    public void setIsEnableDun(boolean isEnableDun) {
+        LogUtils.d(TAG, "setIsEnableDun: 云盾启用状态更新为" + isEnableDun);
+        this.isEnableDun = isEnableDun;
+    }
+
+    public String getBoBullToon_URL() {
+        return szBoBullToon_URL;
+    }
+
+    public void setBoBullToon_URL(String boBullToon_URL) {
+        String oldValue = this.szBoBullToon_URL;
+        this.szBoBullToon_URL = boBullToon_URL == null ? "" : boBullToon_URL;
+        LogUtils.d(TAG, "setBoBullToon_URL: 请求地址更新 | 旧值=" + oldValue + " | 新值=" + this.szBoBullToon_URL);
+    }
+
+    // ====================== 重写 BaseBean 抽象方法区 ======================
+    @Override
+    public String getName() {
+        String className = SettingsBean.class.getName();
+        LogUtils.v(TAG, "getName: 获取当前类名=" + className);
+        return className;
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        LogUtils.d(TAG, "writeThisToJsonWriter: 开始JSON序列化设置数据");
+        super.writeThisToJsonWriter(jsonWriter);
+        // 写入所有配置字段
+        jsonWriter.name(JSON_KEY_DUN_TOTAL).value(getDunTotalCount());
+        jsonWriter.name(JSON_KEY_DUN_CURRENT).value(getDunCurrentCount());
+        jsonWriter.name(JSON_KEY_DUN_RESUME_SECOND).value(getDunResumeSecondCount());
+        jsonWriter.name(JSON_KEY_DUN_RESUME_COUNT).value(getDunResumeCount());
+        jsonWriter.name(JSON_KEY_DUN_ENABLE).value(isEnableDun());
+        jsonWriter.name(JSON_KEY_URL).value(getBoBullToon_URL());
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON序列化完成");
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 优先调用父类处理通用字段
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            LogUtils.v(TAG, "initObjectsFromJsonReader: 父类已处理字段=" + name);
+            return true;
+        }
+
+        // 处理当前类专属配置字段
+        if (JSON_KEY_DUN_TOTAL.equals(name)) {
+            setDunTotalCount(getSettingsModelRangeInt(jsonReader.nextInt()));
+        } else if (JSON_KEY_DUN_CURRENT.equals(name)) {
+            setDunCurrentCount(getSettingsModelRangeInt(jsonReader.nextInt()));
+        } else if (JSON_KEY_DUN_RESUME_SECOND.equals(name)) {
+            setDunResumeSecondCount(getSettingsModelRangeInt(jsonReader.nextInt()));
+        } else if (JSON_KEY_DUN_RESUME_COUNT.equals(name)) {
+            setDunResumeCount(getSettingsModelRangeInt(jsonReader.nextInt()));
+        } else if (JSON_KEY_DUN_ENABLE.equals(name)) {
+            setIsEnableDun(jsonReader.nextBoolean());
+        } else if (JSON_KEY_URL.equals(name)) {
+            setBoBullToon_URL(jsonReader.nextString());
+        } else {
+            LogUtils.w(TAG, "initObjectsFromJsonReader: 未识别的JSON字段=" + name);
+            return false;
+        }
+        LogUtils.v(TAG, "initObjectsFromJsonReader: 成功解析字段=" + name);
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader: 开始从JSON解析设置数据");
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, fieldName)) {
+                LogUtils.w(TAG, "readBeanFromJsonReader: 跳过未识别字段=" + fieldName);
+                jsonReader.skipValue();
+            }
+        }
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON解析完成 | 云盾配置加载完毕");
+        return this;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallActivity.java b/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallActivity.java
new file mode 100644
index 0000000..4da49e7
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallActivity.java
@@ -0,0 +1,362 @@
+package cc.winboll.studio.contacts.phonecallui;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
+import android.view.View;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.contacts.ActivityStack;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.Timer;
+import java.util.TimerTask;
+
+import static cc.winboll.studio.contacts.listenphonecall.CallListenerService.formatPhoneNumber;
+
+/**
+ * @Author aJIEw, ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/14 21:01
+ * @Describe 接打电话界面（单例模式 + 适配API29 - 30 + 小米机型兼容性优化）
+ * 功能：单例通话窗口、来电/去电显示、通话计时、免提控制、锁屏显示
+ */
+public class PhoneCallActivity extends Activity implements View.OnClickListener {
+    // 常量定义区（核心常量+小米适配标识）
+    public static final String TAG = "PhoneCallActivity";
+    private static final int MSG_CLOSE_ACTIVITY = 0x001;
+    private static final String MI_ADAPT_TAG = "MiAdapt";
+    private static final String TOAST_CALLING = "通话进行中，无法重复创建通话窗口";
+    private static final long CLOSE_DELAY_MS = 100; // 小米机型关闭延迟时间
+
+    // 静态属性区（单例核心+全局工具对象）
+    private static volatile boolean sIsActivityAlive = false;
+    private static Handler sCloseHandler;
+
+    // 控件属性区（按界面布局顺序排列）
+    private TextView mTvCallNumberLabel;
+    private TextView mTvCallNumber;
+    private TextView mTvPickUp;
+    private TextView mTvCallingTime;
+    private TextView mTvHangUp;
+
+    // 业务属性区（按依赖优先级排列）
+    private PhoneCallManager mPhoneCallManager;
+    private PhoneCallService.CallType mCallType;
+    private String mPhoneNumber;
+    private Timer mOnGoingCallTimer;
+    private int mCallingTime;
+    private boolean isClosing = false; // 新增：避免重复关闭页面
+
+    // 对外静态接口（单例启动+外部关闭）
+    public static void actionStart(Context context, String phoneNumber, PhoneCallService.CallType callType) {
+        if (context == null || phoneNumber == null || callType == null) {
+            LogUtils.e(TAG, "actionStart: 入参为空，启动失败");
+            return;
+        }
+
+        if (sIsActivityAlive) {
+            LogUtils.w(TAG, MI_ADAPT_TAG + " 已有活跃通话窗口，拒绝重复启动");
+            Toast.makeText(context, TOAST_CALLING, Toast.LENGTH_SHORT).show();
+            return;
+        }
+
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 启动通话界面，号码=" + phoneNumber + "，类型=" + callType.name());
+        Intent intent = new Intent(context, PhoneCallActivity.class);
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
+        intent.putExtra("call_type", callType);
+        intent.putExtra(Intent.EXTRA_PHONE_NUMBER, phoneNumber);
+        context.startActivity(intent);
+    }
+
+    public static void closePhoneCallActivity() {
+        LogUtils.d(TAG, "closePhoneCallActivity: 收到外部关闭指令");
+        if (sIsActivityAlive && sCloseHandler != null) {
+            sCloseHandler.sendEmptyMessage(MSG_CLOSE_ACTIVITY);
+            LogUtils.d(TAG, "closePhoneCallActivity: 关闭消息已发送");
+        } else {
+            LogUtils.w(TAG, "closePhoneCallActivity: 页面已销毁或Handler未初始化，关闭跳过");
+        }
+    }
+
+    // 生命周期方法区（按执行流程排序）
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 通话界面开始创建，SDK版本=" + Build.VERSION.SDK_INT);
+
+        // 单例双重校验，防止异常场景多实例
+        if (sIsActivityAlive) {
+            Toast.makeText(this, TOAST_CALLING, Toast.LENGTH_SHORT).show();
+            LogUtils.w(TAG, MI_ADAPT_TAG + " 拦截重复创建，即将关闭当前实例");
+            finish();
+            return;
+        }
+        sIsActivityAlive = false;
+
+        setContentView(R.layout.activity_phone_call);
+        ActivityStack.getInstance().addActivity(this);
+        adaptLockScreenAndXiaomi();
+        initHandler();
+        initData();
+        initView();
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 通话界面创建完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 通话界面开始销毁");
+
+        sIsActivityAlive = false;
+        isClosing = false;
+        stopTimer();
+        // 销毁通话管理器
+        if (mPhoneCallManager != null) {
+            mPhoneCallManager.destroy();
+            mPhoneCallManager = null;
+            LogUtils.d(TAG, "销毁通话管理器资源");
+        }
+        // 销毁Handler避免内存泄漏
+        if (sCloseHandler != null) {
+            sCloseHandler.removeCallbacksAndMessages(null);
+            sCloseHandler = null;
+            LogUtils.d(TAG, "销毁关闭Handler");
+        }
+        ActivityStack.getInstance().removeActivity(this);
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 通话界面销毁完成");
+    }
+
+    @Override
+    protected void onStop() {
+        super.onStop();
+        if (isFinishing()) {
+            sIsActivityAlive = false;
+            LogUtils.d(TAG, MI_ADAPT_TAG + " 页面即将关闭，重置单例标记");
+        }
+    }
+
+    // 点击事件回调
+    @Override
+    public void onClick(View v) {
+        if (v == null) {
+            LogUtils.w(TAG, "onClick: 点击控件为空，忽略操作");
+            return;
+        }
+        switch (v.getId()) {
+            case R.id.tv_phone_pick_up:
+                LogUtils.d(TAG, "onClick: 触发接听操作");
+                answerCall();
+                break;
+            case R.id.tv_phone_hang_up:
+                LogUtils.d(TAG, "onClick: 触发挂断操作，当前通话时长=" + mCallingTime + "秒");
+                hangUpCall();
+                break;
+            default:
+                LogUtils.w(TAG, "onClick: 未知点击事件，控件ID=" + v.getId());
+        }
+    }
+
+    // 初始化方法区（按初始化顺序排列）
+    private void initHandler() {
+        sCloseHandler = new Handler(Looper.getMainLooper()) {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                if (msg.what == MSG_CLOSE_ACTIVITY) {
+                    LogUtils.d(TAG, "handleMessage: 收到关闭消息，执行挂断逻辑");
+                    hangUpCall();
+                }
+            }
+        };
+        LogUtils.d(TAG, "initHandler: 关闭Handler初始化完成");
+    }
+
+    private void initData() {
+        LogUtils.d(TAG, "initData: 开始初始化业务数据");
+        mPhoneCallManager = PhoneCallManager.getInstance(this);
+        Intent intent = getIntent();
+
+        if (intent == null) {
+            LogUtils.e(TAG, "initData: 启动Intent为空，终止初始化");
+            removeFromRecentsAndFinish();
+            return;
+        }
+
+        mPhoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);
+        mCallType = (PhoneCallService.CallType) intent.getSerializableExtra("call_type");
+        if (mPhoneNumber == null || mCallType == null) {
+            LogUtils.e(TAG, "initData: 通话号码或类型解析失败");
+            removeFromRecentsAndFinish();
+            return;
+        }
+
+        mOnGoingCallTimer = new Timer();
+        mCallingTime = 0;
+        LogUtils.d(TAG, "initData: 业务数据初始化完成，号码=" + mPhoneNumber);
+    }
+
+    private void initView() {
+        LogUtils.d(TAG, "initView: 开始初始化界面控件");
+        // 修复沉浸式导航栏语法，适配小米全面屏
+        int uiOptions = View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
+			| View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
+			| View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
+			| View.SYSTEM_UI_FLAG_LAYOUT_STABLE;
+        getWindow().getDecorView().setSystemUiVisibility(uiOptions);
+
+        // 绑定控件
+        mTvCallNumberLabel = findViewById(R.id.tv_call_number_label);
+        mTvCallNumber = findViewById(R.id.tv_call_number);
+        mTvPickUp = findViewById(R.id.tv_phone_pick_up);
+        mTvCallingTime = findViewById(R.id.tv_phone_calling_time);
+        mTvHangUp = findViewById(R.id.tv_phone_hang_up);
+
+        // 设置控件属性
+        mTvCallNumber.setText(formatPhoneNumber(mPhoneNumber));
+        mTvPickUp.setOnClickListener(this);
+        mTvHangUp.setOnClickListener(this);
+
+        // 区分来电/去电UI样式
+        if (PhoneCallService.CallType.CALL_IN == mCallType) {
+            mTvCallNumberLabel.setText("来电号码");
+            mTvPickUp.setVisibility(View.VISIBLE);
+            mTvCallingTime.setVisibility(View.GONE);
+        } else if (PhoneCallService.CallType.CALL_OUT == mCallType) {
+            mTvCallNumberLabel.setText("呼叫号码");
+            mTvPickUp.setVisibility(View.GONE);
+            mTvCallingTime.setVisibility(View.VISIBLE);
+            mTvCallingTime.setText("通话中：00:00");
+            if (mPhoneCallManager != null) {
+                mPhoneCallManager.openSpeaker();
+                LogUtils.d(TAG, MI_ADAPT_TAG + " 去电模式自动开启免提");
+            }
+            startCallTimer();
+        }
+        LogUtils.d(TAG, "initView: 界面控件初始化完成");
+    }
+
+    // 小米机型专属适配方法
+    private void adaptLockScreenAndXiaomi() {
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 执行锁屏适配逻辑");
+        Window window = getWindow();
+        if (window == null) {
+            LogUtils.e(TAG, MI_ADAPT_TAG + " Window对象为空，适配失败");
+            return;
+        }
+
+        int flags = WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
+			| WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+			| WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED;
+
+        // 小米机型额外添加解锁屏标志，解决MIUI锁屏拦截问题
+        if (Build.MANUFACTURER.equalsIgnoreCase("Xiaomi")) {
+            flags |= WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD;
+            LogUtils.d(TAG, MI_ADAPT_TAG + " 已添加小米机型专属锁屏适配标志");
+        }
+        window.addFlags(flags);
+
+        // 适配API29+锁屏新接口
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            setShowWhenLocked(true);
+            setTurnScreenOn(true);
+            LogUtils.d(TAG, MI_ADAPT_TAG + " 适配API29+锁屏接口完成");
+        }
+    }
+
+    // 通话核心业务方法
+    private void answerCall() {
+        LogUtils.d(TAG, "answerCall: 执行接听操作");
+        if (mPhoneCallManager == null) {
+            LogUtils.e(TAG, "answerCall: 通话管理器为空，接听失败");
+            return;
+        }
+        mPhoneCallManager.answer();
+        mTvPickUp.setVisibility(View.GONE);
+        mTvCallingTime.setVisibility(View.VISIBLE);
+        mTvCallingTime.setText("通话中：00:00");
+        startCallTimer();
+        LogUtils.d(TAG, "answerCall: 接听操作完成，启动通话计时");
+    }
+
+    private void hangUpCall() {
+        if (isClosing) {
+            LogUtils.w(TAG, "hangUpCall: 挂断操作已执行，无需重复调用");
+            return;
+        }
+        LogUtils.d(TAG, "hangUpCall: 执行挂断操作，当前时长=" + mCallingTime + "秒");
+        isClosing = true;
+        stopTimer();
+        if (mPhoneCallManager != null) {
+            mPhoneCallManager.disconnect();
+            LogUtils.d(TAG, "hangUpCall: 通话连接已断开");
+        }
+        // 延迟关闭页面，适配小米机型通话时序
+        new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					removeFromRecentsAndFinish();
+				}
+			}, CLOSE_DELAY_MS);
+    }
+
+    // 任务栈清理方法
+    private void removeFromRecentsAndFinish() {
+        if (isFinishing()) {
+            LogUtils.d(TAG, "removeFromRecentsAndFinish: 页面已在关闭中，无需重复操作");
+            return;
+        }
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            finishAndRemoveTask();
+            LogUtils.d(TAG, MI_ADAPT_TAG + " 移除任务栈并关闭页面");
+        } else {
+            finish();
+            LogUtils.d(TAG, "兼容低版本，关闭页面");
+        }
+    }
+
+    // 计时工具方法
+    private void startCallTimer() {
+        LogUtils.d(TAG, "startCallTimer: 启动通话计时器");
+        if (mOnGoingCallTimer == null) {
+            mOnGoingCallTimer = new Timer();
+        }
+        mOnGoingCallTimer.schedule(new TimerTask() {
+				@Override
+				public void run() {
+					runOnUiThread(new Runnable() {
+							@Override
+							public void run() {
+								mCallingTime++;
+								mTvCallingTime.setText("通话中：" + formatCallingTime(mCallingTime));
+							}
+						});
+				}
+			}, 0, 1000);
+    }
+
+    private void stopTimer() {
+        LogUtils.d(TAG, "stopTimer: 停止通话计时器");
+        if (mOnGoingCallTimer != null) {
+            mOnGoingCallTimer.cancel();
+            mOnGoingCallTimer = null;
+        }
+        mCallingTime = 0;
+    }
+
+    // 辅助工具方法：格式化通话时长
+    private String formatCallingTime(int seconds) {
+        int minute = seconds / 60;
+        int second = seconds % 60;
+        String minuteStr = minute < 10 ? "0" + minute : String.valueOf(minute);
+        String secondStr = second < 10 ? "0" + second : String.valueOf(second);
+        return minuteStr + ":" + secondStr;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallManager.java b/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallManager.java
new file mode 100644
index 0000000..9307cdf
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallManager.java
@@ -0,0 +1,204 @@
+package cc.winboll.studio.contacts.phonecallui;
+
+import android.content.Context;
+import android.media.AudioManager;
+import android.os.Build;
+import android.telecom.Call;
+import android.telecom.VideoProfile;
+import androidx.annotation.RequiresApi;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/15 20:11
+ * @Describe 通话核心管理类
+ * 功能：接听/挂断通话、免提控制、资源释放，适配API29-30及小米机型
+ */
+@RequiresApi(api = Build.VERSION_CODES.Q) // 匹配目标适配区间API29
+public class PhoneCallManager {
+    // 常量定义区
+    public static final String TAG = "PhoneCallManager";
+    private static final String MI_ADAPT_TAG = "MiDeviceAdapt"; // 小米适配标识
+    private static final int VIDEO_PROFILE_AUDIO_ONLY = VideoProfile.STATE_AUDIO_ONLY;
+    private static final int AUDIO_MODE_BACKUP = -1; // 音频模式备份默认值
+
+    // 成员属性区（按依赖优先级排序，移除静态call避免跨组件冲突）
+    private Context mContext;
+    private AudioManager mAudioManager;
+    private int mAudioModeBackup; // 备份原始音频模式，避免影响其他应用
+    private boolean mIsSpeakerOpened; // 免提状态标记，防止重复切换
+
+    // 构造方法（单例化改造，避免多实例冲突）
+    private static volatile PhoneCallManager sInstance;
+    public static PhoneCallManager getInstance(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "getInstance: 上下文为空，初始化失败");
+            return null;
+        }
+        if (sInstance == null) {
+            synchronized (PhoneCallManager.class) {
+                if (sInstance == null) {
+                    sInstance = new PhoneCallManager(context.getApplicationContext()); // 用应用上下文，避免内存泄漏
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    // 私有构造，禁止外部实例化
+    private PhoneCallManager(Context context) {
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 初始化通话管理类");
+        this.mContext = context;
+        this.mAudioModeBackup = AUDIO_MODE_BACKUP;
+        this.mIsSpeakerOpened = false;
+        initAudioManager();
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 通话管理类初始化完成");
+    }
+
+    // 初始化辅助方法
+    private void initAudioManager() {
+        mAudioManager = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE);
+        if (mAudioManager != null) {
+            // 备份原始音频模式（小米机型切换后需恢复，避免外放异常）
+            mAudioModeBackup = mAudioManager.getMode();
+            LogUtils.d(TAG, "音频管理器初始化成功，原始模式备份：" + mAudioModeBackup);
+        } else {
+            LogUtils.e(TAG, "音频管理器初始化失败，将影响通话音频控制");
+        }
+    }
+
+    // 核心业务方法（按使用场景排序，强化小米适配+容错）
+    /**
+     * 接听电话，默认音频通话模式
+     */
+    public void answer() {
+        LogUtils.d(TAG, "执行接听通话操作");
+        // 从PhoneCallService的静态管理器获取通话对象，统一数据源
+        Call currentCall = PhoneCallService.PhoneCallManager.call;
+        if (currentCall == null) {
+            LogUtils.e(TAG, "接听失败：通话对象为空");
+            return;
+        }
+
+        // 校验通话状态，避免重复接听（小米机型状态变更延迟）
+        if (currentCall.getState() != Call.STATE_RINGING) {
+            LogUtils.w(TAG, MI_ADAPT_TAG + " 非响铃状态，无需接听，当前状态：" + currentCall.getState());
+            return;
+        }
+
+        try {
+            currentCall.answer(VIDEO_PROFILE_AUDIO_ONLY);
+            openSpeaker(); // 接听后自动开免提
+            LogUtils.d(TAG, "通话接听成功，自动开启免提");
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, MI_ADAPT_TAG + " 接听权限不足（需android.permission.ANSWER_PHONE_CALLS）", e);
+        } catch (IllegalStateException e) {
+            LogUtils.e(TAG, MI_ADAPT_TAG + " 通话状态异常，无法接听", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "接听通话异常", e);
+        }
+    }
+
+    /**
+     * 断开通话（支持来电拒接、通话中挂断）
+     */
+    public void disconnect() {
+        LogUtils.d(TAG, "执行断开通话操作");
+        Call currentCall = PhoneCallService.PhoneCallManager.call;
+        if (currentCall == null) {
+            LogUtils.e(TAG, "挂断失败：通话对象为空");
+            return;
+        }
+
+        // 校验通话状态，避免重复挂断
+        if (currentCall.getState() == Call.STATE_DISCONNECTED) {
+            LogUtils.w(TAG, MI_ADAPT_TAG + " 通话已断开，无需重复操作");
+            return;
+        }
+
+        try {
+            currentCall.disconnect();
+            closeSpeaker(); // 挂断后关闭免提+恢复音频模式
+            LogUtils.d(TAG, "通话断开成功");
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, MI_ADAPT_TAG + " 挂断权限不足（需android.permission.CALL_PHONE）", e);
+        } catch (IllegalStateException e) {
+            LogUtils.e(TAG, MI_ADAPT_TAG + " 通话状态异常，无法挂断", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "断开通话异常", e);
+        }
+    }
+
+    /**
+     * 打开免提，适配小米机型音频通道切换（解决MIUI音频混乱）
+     */
+    public void openSpeaker() {
+        LogUtils.d(TAG, "执行打开免提操作");
+        if (mAudioManager == null) {
+            LogUtils.e(TAG, "打开免提失败：音频管理器未初始化");
+            return;
+        }
+        if (mIsSpeakerOpened) {
+            LogUtils.w(TAG, "免提已开启，无需重复操作");
+            return;
+        }
+
+        try {
+            // 小米机型适配步骤：1. 设置通话模式 2. 关闭静音 3. 开启免提（固定顺序）
+            mAudioManager.setMode(AudioManager.MODE_IN_CALL);
+            mAudioManager.setStreamMute(AudioManager.STREAM_VOICE_CALL, false); // 确保通话音频不静音
+            mAudioManager.setSpeakerphoneOn(true);
+
+            mIsSpeakerOpened = true;
+            LogUtils.d(TAG, MI_ADAPT_TAG + " 免提开启成功，当前模式：" + mAudioManager.getMode());
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, MI_ADAPT_TAG + " 音频控制权限不足", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "打开免提异常", e);
+        }
+    }
+
+    /**
+     * 新增：关闭免提（挂断/切换场景调用，修复小米音频残留）
+     */
+    public void closeSpeaker() {
+        LogUtils.d(TAG, "执行关闭免提操作");
+        if (mAudioManager == null || !mIsSpeakerOpened) {
+            LogUtils.w(TAG, "免提未开启或音频管理器为空，无需操作");
+            return;
+        }
+
+        try {
+            mAudioManager.setSpeakerphoneOn(false);
+            // 恢复原始音频模式（关键：小米机型不恢复会导致其他应用外放异常）
+            if (mAudioModeBackup != AUDIO_MODE_BACKUP) {
+                mAudioManager.setMode(mAudioModeBackup);
+                LogUtils.d(TAG, MI_ADAPT_TAG + " 恢复原始音频模式：" + mAudioModeBackup);
+            }
+            mIsSpeakerOpened = false;
+            LogUtils.d(TAG, "免提关闭成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, MI_ADAPT_TAG + " 关闭免提异常", e);
+        }
+    }
+
+    /**
+     * 销毁资源，避免内存泄漏+音频残留（适配小米内存管理）
+     */
+    public void destroy() {
+        LogUtils.d(TAG, "开始销毁通话管理资源");
+        closeSpeaker(); // 销毁前强制关闭免提+恢复音频模式
+        // 释放资源（应用上下文无需主动置空，避免空指针）
+        mAudioManager = null;
+        sInstance = null; // 单例置空，下次重新初始化
+        LogUtils.d(TAG, MI_ADAPT_TAG + " 通话管理资源销毁完成");
+    }
+
+    /**
+     * 新增：获取当前免提状态（供UI层同步显示）
+     */
+    public boolean isSpeakerOpened() {
+        return mIsSpeakerOpened;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallService.java b/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallService.java
new file mode 100644
index 0000000..e5beede
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/phonecallui/PhoneCallService.java
@@ -0,0 +1,284 @@
+package cc.winboll.studio.contacts.phonecallui;
+
+import android.media.AudioManager;
+import android.telecom.Call;
+import android.telecom.InCallService;
+import android.telephony.TelephonyManager;
+import androidx.annotation.RequiresApi;
+import cc.winboll.studio.contacts.ActivityStack;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.contacts.fragments.CallLogFragment;
+import cc.winboll.studio.contacts.model.RingTongBean;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * 监听电话通信状态的服务，实现该类的同时必须提供电话管理的 UI
+ * @author aJIEw, ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @see PhoneCallActivity
+ * @see android.telecom.InCallService
+ * 适配：Java7 语法 + Android API29 - 30 | 移除录音功能 | 强化小米设备稳定性与容错性
+ */
+@RequiresApi(api = 29)
+public class PhoneCallService extends InCallService {
+    // 常量定义区
+    public static final String TAG = "PhoneCallService";
+    // 小米设备适配标识，便于日志区分
+    private static final String MI_DEVICE_TAG = "MiDeviceAdapt";
+
+    // 成员属性区（按依赖顺序排列）
+    private Call.Callback mCallCallback;
+    private AudioManager mAudioManager;
+
+    // 内部枚举类（通话类型定义）
+    public enum CallType {
+        CALL_IN,  // 来电
+        CALL_OUT  // 去电
+		}
+
+    // Service生命周期方法区（按执行流程排序）
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, MI_DEVICE_TAG + " 通话监听服务启动");
+        initAudioManager();
+        initCallCallback();
+        LogUtils.d(TAG, MI_DEVICE_TAG + " 服务初始化完成");
+    }
+
+    @Override
+    public void onCallAdded(Call call) {
+        super.onCallAdded(call);
+        LogUtils.d(TAG, "检测到新通话");
+        if (call == null) {
+            LogUtils.e(TAG, "通话对象为空，跳过处理");
+            return;
+        }
+
+        // 双重校验回调，避免重复注册
+        if (mCallCallback != null) {
+            call.registerCallback(mCallCallback);
+        }
+        // 绑定通话对象到管理器，供UI层调用
+        PhoneCallManager.call = call;
+        LogUtils.d(TAG, MI_DEVICE_TAG + " 通话回调注册成功，对象绑定完成");
+
+        CallType callType = judgeCallType(call);
+        if (callType != null) {
+            handleValidCall(call, callType);
+        } else {
+            LogUtils.w(TAG, "无法识别通话类型，状态码：" + call.getState());
+        }
+    }
+
+    @Override
+    public void onCallRemoved(Call call) {
+        super.onCallRemoved(call);
+        LogUtils.d(TAG, "通话结束，开始清理资源");
+        if (call != null && mCallCallback != null) {
+            call.unregisterCallback(mCallCallback);
+            LogUtils.d(TAG, "通话回调已注销");
+        }
+
+        // 延迟置空通话对象，避免UI层挂断时对象已被释放（适配小米机型时序）
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					try {
+						// 延迟200ms，确保PhoneCallActivity挂断逻辑执行完成
+						Thread.sleep(200);
+						PhoneCallManager.call = null;
+					} catch (InterruptedException e) {
+						LogUtils.e(TAG, MI_DEVICE_TAG + " 延迟置空通话对象异常", e);
+					}
+				}
+			}).start();
+
+        PhoneCallActivity.closePhoneCallActivity();
+        LogUtils.d(TAG, MI_DEVICE_TAG + " 通话资源清理完成");
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "服务开始销毁");
+        CallLogFragment.updateCallLogFragment();
+        // 释放资源，适配小米设备内存管理，避免内存泄漏
+        mCallCallback = null;
+        mAudioManager = null;
+        LogUtils.d(TAG, MI_DEVICE_TAG + " 服务销毁完成");
+    }
+
+    // 初始化方法区
+    private void initAudioManager() {
+        mAudioManager = (AudioManager) getSystemService(AUDIO_SERVICE);
+        if (mAudioManager == null) {
+            LogUtils.e(TAG, MI_DEVICE_TAG + " 获取音频管理器失败");
+        } else {
+            LogUtils.d(TAG, MI_DEVICE_TAG + " 音频管理器初始化成功");
+        }
+    }
+
+    private void initCallCallback() {
+        mCallCallback = new Call.Callback() {
+            @Override
+            public void onStateChanged(Call call, int state) {
+                super.onStateChanged(call, state);
+                if (call == null) {
+                    LogUtils.e(TAG, "onStateChanged: 通话对象为空");
+                    return;
+                }
+                String stateDesc = getCallStateDesc(state);
+                LogUtils.d(TAG, "通话状态变更：" + stateDesc + "（状态码：" + state + "）");
+
+                switch (state) {
+                    case Call.STATE_DISCONNECTED:
+                        // 双重校验，避免重复关闭页面
+                        if (ActivityStack.getInstance().getActivity(PhoneCallActivity.class) != null) {
+                            ActivityStack.getInstance().finishActivity(PhoneCallActivity.class);
+                            LogUtils.d(TAG, "通话界面已关闭");
+                        }
+                        break;
+                    case Call.STATE_ACTIVE:
+                        LogUtils.d(TAG, MI_DEVICE_TAG + " 通话进入活跃状态，适配音频通道");
+                        break;
+                    default:
+                        break;
+                }
+            }
+        };
+        LogUtils.d(TAG, "通话状态回调初始化完成");
+    }
+
+    // 核心业务处理方法区
+    private CallType judgeCallType(Call call) {
+        if (call == null) {
+            LogUtils.e(TAG, "judgeCallType: 通话对象为空");
+            return null;
+        }
+        int callState = call.getState();
+        if (callState == Call.STATE_RINGING) {
+            LogUtils.d(TAG, "识别为来电");
+            return CallType.CALL_IN;
+        } else if (callState == Call.STATE_CONNECTING) {
+            LogUtils.d(TAG, "识别为去电");
+            return CallType.CALL_OUT;
+        }
+        return null;
+    }
+
+    private boolean handleValidCall(Call call, CallType callType) {
+        if (call == null || callType == null) {
+            LogUtils.e(TAG, "handleValidCall: 通话对象或类型为空");
+            return false;
+        }
+
+        Call.Details callDetails = call.getDetails();
+        if (callDetails == null || callDetails.getHandle() == null) {
+            LogUtils.e(TAG, "通话详情缺失，处理终止");
+            return false;
+        }
+
+        String phoneNumber = callDetails.getHandle().getSchemeSpecificPart();
+        LogUtils.d(TAG, "处理通话：号码=" + phoneNumber + "，类型=" + callType.name());
+
+        if (mAudioManager == null) {
+            LogUtils.e(TAG, "音频管理器未初始化");
+            PhoneCallActivity.actionStart(this, phoneNumber, callType);
+            return true;
+        }
+
+        if (checkRulesAndHandleRingerVolumeControl(phoneNumber, call)) {
+            PhoneCallActivity.actionStart(this, phoneNumber, callType);
+            LogUtils.d(TAG, MI_DEVICE_TAG + " 通话界面启动成功");
+            return true;
+        }
+        return false;
+    }
+
+    private boolean checkRulesAndHandleRingerVolumeControl(String phoneNumber, Call call) {
+        if (mAudioManager == null || phoneNumber == null || call == null) {
+            LogUtils.e(TAG, "checkRulesAndHandleRingerVolumeControl: 入参为空");
+            return false;
+        }
+
+        int currentVolume = mAudioManager.getStreamVolume(AudioManager.STREAM_RING);
+        LogUtils.d(TAG, "当前铃声音量：" + currentVolume);
+
+        RingTongBean ringTongBean = RingTongBean.loadBean(this, RingTongBean.class);
+        if (ringTongBean == null) {
+            ringTongBean = new RingTongBean();
+            RingTongBean.saveBean(this, ringTongBean);
+            LogUtils.d(TAG, "初始化默认铃音配置");
+        }
+        final int configVolume = ringTongBean.getStreamVolume();
+
+        try {
+            // 小米机型适配：调整音量时添加权限校验
+            if (currentVolume != configVolume) {
+                mAudioManager.setStreamVolume(AudioManager.STREAM_RING, configVolume, 0);
+                LogUtils.d(TAG, MI_DEVICE_TAG + " 铃声音量调整为配置值：" + configVolume);
+            }
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, "音量调整失败，权限不足", e);
+            return false;
+        }
+
+        // 校验拦截规则
+        if (!Rules.getInstance(this).isAllowed(phoneNumber)) {
+            LogUtils.d(TAG, "号码" + phoneNumber + "命中拦截规则");
+            try {
+                // 拦截时静音并挂断
+                mAudioManager.setStreamVolume(AudioManager.STREAM_RING, 0, 0);
+                call.disconnect();
+                LogUtils.d(TAG, MI_DEVICE_TAG + " 拦截通话已挂断并静音");
+
+                // 延迟恢复音量，适配小米机型音频通道延迟
+                new Thread(new Runnable() {
+						@Override
+						public void run() {
+							try {
+								Thread.sleep(500);
+								if (mAudioManager != null) {
+									mAudioManager.setStreamVolume(AudioManager.STREAM_RING, configVolume, 0);
+									LogUtils.d(TAG, MI_DEVICE_TAG + " 延迟恢复铃音配置");
+								}
+							} catch (InterruptedException e) {
+								LogUtils.e(TAG, "恢复音量线程中断", e);
+							}
+						}
+					}).start();
+            } catch (SecurityException e) {
+                LogUtils.e(TAG, "拦截静音失败", e);
+                return false;
+            }
+            return false;
+        }
+        return true;
+    }
+
+    // 辅助工具方法区：解析通话状态描述
+    private String getCallStateDesc(int state) {
+        switch (state) {
+            case TelephonyManager.CALL_STATE_RINGING:
+                return "响铃中";
+            case TelephonyManager.CALL_STATE_OFFHOOK:
+                return "通话中";
+            case TelephonyManager.CALL_STATE_IDLE:
+                return "空闲";
+            case Call.STATE_ACTIVE:
+                return "通话活跃";
+            case Call.STATE_CONNECTING:
+                return "连接中";
+            case Call.STATE_DISCONNECTED:
+                return "已断开";
+            default:
+                return "未知状态";
+        }
+    }
+
+    // 静态内部类：统一管理通话对象，避免跨组件对象混乱
+    public static class PhoneCallManager {
+        public static Call call;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/receivers/MainReceiver.java b/contacts/src/main/java/cc/winboll/studio/contacts/receivers/MainReceiver.java
new file mode 100644
index 0000000..e135fa5
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/receivers/MainReceiver.java
@@ -0,0 +1,98 @@
+package cc.winboll.studio.contacts.receivers;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import cc.winboll.studio.contacts.services.MainService;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.lang.ref.WeakReference;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/13 06:58:04
+ * @Describe 主要广播接收器，监听系统开机广播并自动启动主服务
+ */
+public class MainReceiver extends BroadcastReceiver {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "MainReceiver";
+    // 监听的系统广播 Action
+    private static final String ACTION_BOOT_COMPLETED = "android.intent.action.BOOT_COMPLETED";
+
+    // ====================== 成员变量区 ======================
+    // 使用弱引用关联 MainService，避免内存泄漏
+    private WeakReference<MainService> mMainServiceWeakRef;
+
+    // ====================== 构造函数区 ======================
+    public MainReceiver(MainService service) {
+        this.mMainServiceWeakRef = new WeakReference<>(service);
+        LogUtils.d(TAG, "MainReceiver: 初始化完成，已关联 MainService 实例");
+    }
+
+    // ====================== 重写 BroadcastReceiver 核心方法 ======================
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        // 空值校验，避免空指针异常
+        if (context == null) {
+            LogUtils.e(TAG, "onReceive: Context 为 null，无法处理广播");
+            return;
+        }
+        if (intent == null || intent.getAction() == null) {
+            LogUtils.w(TAG, "onReceive: 接收到空 Intent 或空 Action");
+            return;
+        }
+
+        String action = intent.getAction();
+        LogUtils.d(TAG, "onReceive: 接收到广播 | Action=" + action);
+
+        // 处理开机完成广播
+        if (ACTION_BOOT_COMPLETED.equals(action)) {
+            LogUtils.i(TAG, "onReceive: 监听到开机完成广播，自动启动 MainService");
+            ToastUtils.show("设备开机，启动拨号主服务");
+            MainService.startMainService(context);
+        } else {
+            LogUtils.i(TAG, "onReceive: 接收到未处理的广播 | Action=" + action);
+            ToastUtils.show("收到广播：" + action);
+        }
+    }
+
+    // ====================== 广播注册/注销方法区 ======================
+    /**
+     * 注册广播接收器，监听指定系统广播
+     * @param context 上下文对象
+     */
+    public void registerAction(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "registerAction: Context 为 null，注册失败");
+            return;
+        }
+
+        IntentFilter intentFilter = new IntentFilter();
+        intentFilter.addAction(ACTION_BOOT_COMPLETED);
+        // 可按需添加其他监听的 Action
+        // intentFilter.addAction(AudioManager.RINGER_MODE_CHANGED_ACTION);
+
+        context.registerReceiver(this, intentFilter);
+        LogUtils.d(TAG, "registerAction: 广播接收器注册成功 | 监听 Action=" + ACTION_BOOT_COMPLETED);
+    }
+
+    /**
+     * 注销广播接收器，释放资源（解决 mMainReceiver.unregisterAction(this) 调用缺失问题）
+     * @param context 上下文对象
+     */
+    public void unregisterAction(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "unregisterAction: Context 为 null，注销失败");
+            return;
+        }
+
+        try {
+            context.unregisterReceiver(this);
+            LogUtils.d(TAG, "unregisterAction: 广播接收器注销成功");
+        } catch (IllegalArgumentException e) {
+            LogUtils.w(TAG, "unregisterAction: 广播接收器未注册，无需注销", e);
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/services/AssistantService.java b/contacts/src/main/java/cc/winboll/studio/contacts/services/AssistantService.java
new file mode 100644
index 0000000..efb2ced
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/services/AssistantService.java
@@ -0,0 +1,251 @@
+package cc.winboll.studio.contacts.services;
+
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.Binder;
+import android.os.IBinder;
+import cc.winboll.studio.contacts.model.MainServiceBean;
+import cc.winboll.studio.contacts.utils.NotificationManagerUtils;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/14 03:38:31
+ * @Describe 守护进程服务，用于监控并保活主服务 MainService
+ * 适配 Android 12+ 后台服务启动限制，支持前台服务运行
+ * 兼容 Java 7 语法 & 低版本 SDK 编译
+ * 移除无关的 microphone 类型配置，修复前台服务类型不匹配崩溃
+ */
+public class AssistantService extends Service {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "AssistantService";
+    // 前台服务通知配置
+    private static final String FOREGROUND_CHANNEL_ID = "assistant_service_foreground_channel";
+    private static final int FOREGROUND_NOTIFICATION_ID = 1002;
+    // 修复：前台服务类型改为 dataSync(0x00000001)，与 Manifest 保持一致，移除 microphone 类型
+    private static final int FOREGROUND_SERVICE_TYPE_DATA_SYNC = 0x00000001;
+    // Android 版本常量硬编码（Java 7 兼容）
+    private static final int ANDROID_8_API = 26;      // 通知渠道最低版本
+    private static final int ANDROID_10_API = 29;     // 前台服务类型最低支持版本
+    private static final int ANDROID_12_API = 31;     // 后台启动限制最低版本
+    // 重试延迟时间（避免频繁触发后台启动限制）
+    private static final long RETRY_DELAY_MS = 3000L;
+
+    // ====================== 成员变量区 ======================
+    private MainServiceBean mMainServiceBean;
+    private MyServiceConnection mMyServiceConnection;
+    private MainService mMainService;
+    private boolean mIsBound = false;
+    private volatile boolean mIsThreadAlive = false;
+
+    // ====================== Binder 内部类 ======================
+    /**
+     * 对外暴露服务实例的 Binder
+     */
+    public class MyBinder extends Binder {
+        public AssistantService getService() {
+            LogUtils.d(TAG, "MyBinder.getService: 获取 AssistantService 实例");
+            return AssistantService.this;
+        }
+    }
+
+    // ====================== ServiceConnection 内部类 ======================
+    /**
+     * 主服务连接状态监听回调
+     */
+    private class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            if (service == null) {
+                LogUtils.w(TAG, "MyServiceConnection.onServiceConnected: 绑定的 IBinder 为 null");
+                mIsBound = false;
+                return;
+            }
+
+            try {
+                MainService.MyBinder binder = (MainService.MyBinder) service;
+                mMainService = binder.getService();
+                mIsBound = true;
+                LogUtils.d(TAG, "MyServiceConnection.onServiceConnected: 主服务绑定成功 | MainService=" + mMainService);
+            } catch (ClassCastException e) {
+                LogUtils.e(TAG, "MyServiceConnection.onServiceConnected: IBinder 类型转换失败", e);
+                mIsBound = false;
+            }
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            LogUtils.w(TAG, "MyServiceConnection.onServiceDisconnected: 主服务连接断开");
+            mMainService = null;
+            mIsBound = false;
+
+            // 尝试重新绑定主服务（如果配置为启用）
+            reloadMainServiceConfig();
+            if (mMainServiceBean != null && mMainServiceBean.isEnable()) {
+                LogUtils.d(TAG, "MyServiceConnection.onServiceDisconnected: 延迟重试绑定主服务");
+                wakeupAndBindMain();
+            }
+        }
+    }
+
+    // ====================== 对外方法区 ======================
+    /**
+     * 设置线程存活状态
+     */
+    public synchronized void setIsThreadAlive(boolean isThreadAlive) {
+        this.mIsThreadAlive = isThreadAlive;
+        LogUtils.d(TAG, "setIsThreadAlive: 线程存活状态变更 | " + isThreadAlive);
+    }
+
+    /**
+     * 获取线程存活状态
+     */
+    public boolean isThreadAlive() {
+        return mIsThreadAlive;
+    }
+
+    // ====================== 前台服务辅助方法 ======================
+    /**
+     * 创建前台服务通知（Android 8.0+ 必须配置渠道）
+     */
+//    private Notification createForegroundNotification() {
+//        // 1. 创建通知渠道（API 26+ 必需）
+//        if (Build.VERSION.SDK_INT >= ANDROID_8_API) {
+//            NotificationChannel channel = new NotificationChannel(
+//				FOREGROUND_CHANNEL_ID,
+//				"守护服务",
+//				NotificationManager.IMPORTANCE_LOW
+//            );
+//            channel.setDescription("守护服务后台运行，保障主服务存活");
+//            // 空指针防护
+//            NotificationManager manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
+//            if (manager != null) {
+//                manager.createNotificationChannel(channel);
+//                LogUtils.d(TAG, "createForegroundNotification: 通知渠道创建成功");
+//            }
+//        }
+//
+//        // 2. 构建通知（Java 7 分步设置，取消链式调用简化）
+//        Notification.Builder builder;
+//        if (Build.VERSION.SDK_INT >= ANDROID_8_API) {
+//            builder = new Notification.Builder(this, FOREGROUND_CHANNEL_ID);
+//        } else {
+//            builder = new Notification.Builder(this);
+//        }
+//        builder.setSmallIcon(R.drawable.ic_launcher);
+//        builder.setContentTitle("守护服务运行中");
+//        builder.setContentText("正在监控主服务状态");
+//        builder.setPriority(Notification.PRIORITY_LOW);
+//        builder.setOngoing(true); // 不可手动取消
+//
+//        return builder.build();
+//    }
+
+    // ====================== Service 生命周期方法区 ======================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "onCreate: 守护服务创建");
+
+        // 初始化主服务连接回调
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+            LogUtils.d(TAG, "onCreate: 初始化 MyServiceConnection 完成");
+        }
+
+        // 初始化运行状态
+        setIsThreadAlive(false);
+        // 启动守护逻辑
+        assistantService();
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.d(TAG, "onBind: 服务被绑定 | Intent=" + intent);
+        return new MyBinder();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand: 服务被启动 | startId=" + startId);
+        // 每次启动都执行守护逻辑，确保主服务存活
+        assistantService();
+        // START_STICKY：服务被杀死后系统尝试重启
+        return START_STICKY;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: 守护服务销毁");
+
+        // 停止线程并解除主服务绑定
+        setIsThreadAlive(false);
+        if (mIsBound && mMyServiceConnection != null) {
+            try {
+                unbindService(mMyServiceConnection);
+                LogUtils.d(TAG, "onDestroy: 解除主服务绑定成功");
+            } catch (IllegalArgumentException e) {
+                LogUtils.w(TAG, "onDestroy: 解除绑定失败，服务未绑定", e);
+            }
+            mIsBound = false;
+        }
+        mMainService = null;
+    }
+
+    // ====================== 核心守护逻辑方法区 ======================
+    /**
+     * 守护服务核心逻辑：检查配置并保活主服务
+     */
+    private void assistantService() {
+        LogUtils.d(TAG, "assistantService: 执行守护逻辑");
+
+        // 加载主服务配置
+        reloadMainServiceConfig();
+        if (mMainServiceBean == null) {
+            LogUtils.e(TAG, "assistantService: 主服务配置加载失败，终止守护逻辑");
+            return;
+        }
+
+        LogUtils.d(TAG, "assistantService: 主服务启用状态 | " + mMainServiceBean.isEnable());
+        // 配置启用且线程未存活时，唤醒并绑定主服务
+        if (mMainServiceBean.isEnable() && !isThreadAlive()) {
+            setIsThreadAlive(true);
+            wakeupAndBindMain();
+        } else if (!mMainServiceBean.isEnable()) {
+            setIsThreadAlive(false);
+            LogUtils.d(TAG, "assistantService: 主服务已禁用，停止保活");
+        }
+    }
+
+    /**
+     * 唤醒并绑定主服务 MainService（适配后台启动限制）
+     */
+    private void wakeupAndBindMain() {
+        if (mMyServiceConnection == null) {
+            LogUtils.e(TAG, "wakeupAndBindMain: MyServiceConnection 未初始化，绑定失败");
+            return;
+        }
+
+        Intent intent = new Intent(this, MainService.class);
+        // 根据应用前后台状态选择启动方式（Android 12+ 后台用 startForegroundService）
+        startForegroundService(intent);
+
+        // BIND_IMPORTANT：提高绑定优先级，主服务被杀时会回调断开
+        bindService(intent, mMyServiceConnection, Context.BIND_IMPORTANT);
+        LogUtils.d(TAG, "wakeupAndBindMain: 已启动并绑定主服务 MainService");
+    }
+
+    // ====================== 辅助方法区 ======================
+    /**
+     * 重新加载主服务配置
+     */
+    private void reloadMainServiceConfig() {
+        mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        LogUtils.d(TAG, "reloadMainServiceConfig: 主服务配置重新加载完成 | " + mMainServiceBean);
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/services/LimitedTimeSpecialChannelService.java b/contacts/src/main/java/cc/winboll/studio/contacts/services/LimitedTimeSpecialChannelService.java
new file mode 100644
index 0000000..aa62f02
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/services/LimitedTimeSpecialChannelService.java
@@ -0,0 +1,327 @@
+package cc.winboll.studio.contacts.services;
+
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Handler;
+import android.os.IBinder;
+import android.os.Looper;
+import androidx.localbroadcastmanager.content.LocalBroadcastManager;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/04/18 15:00:00 (GMT+8)
+ * @LastEditTime 2026/04/22 17:20:00 (GMT+8)
+ * @Describe 限时特殊通道服务
+ * 提供安全的服务启动、令牌校验及循环任务管理
+ * 新增功能：
+ * 1. 计时过程中实时输出剩余秒数
+ * 2. 服务销毁前，发送本地广播通知应用内其他组件，并携带剩余秒数信息
+ * 3. 每秒发送一次倒计时状态的本地广播
+ */
+public class LimitedTimeSpecialChannelService extends Service {
+
+    // ========================= 常量定义 =========================
+    public static final String TAG = "LimitedTimeSpecialChannelService";
+    public static final String EXTRA_DELAY_MILLIS = "EXTRA_DELAY_MILLIS";
+    private static final String EXTRA_SECURITY_TOKEN = "EXTRA_SECURITY_TOKEN";
+
+    // 本地广播 Action 常量
+    public static final String ACTION_SERVICE_DESTROYED = "cc.winboll.studio.contacts.services.ACTION_SERVICE_DESTROYED";
+
+    // 倒计时心跳广播 Action
+    public static final String ACTION_COUNTDOWN_TICK = "cc.winboll.studio.contacts.services.ACTION_COUNTDOWN_TICK";
+    // 广播携带的额外参数：剩余秒数
+    public static final String EXTRA_REMAINING_SECONDS = "EXTRA_REMAINING_SECONDS";
+    // 广播携带的额外参数：总定时秒数
+    public static final String EXTRA_TOTAL_SECONDS = "EXTRA_TOTAL_SECONDS";
+
+    // ========================= 静态变量 =========================
+    /**
+     * 公共静态私有字段：安全校验令牌
+     * 确保全局可访问且值不可变更
+     */
+    public static final String mValidToken = "VALID_TOKEN_" + System.currentTimeMillis();
+
+    private static volatile LimitedTimeSpecialChannelService sInstance = null;
+    private static volatile boolean sIsServiceRunning = false;
+
+    // ========================= 成员变量 =========================
+    private final Handler mHandler = new Handler(Looper.getMainLooper());
+    private long mTotalMillis = 0;      // 总定时时长
+    private long mRemainingMillis = 0;  // 剩余时长
+    private LocalBroadcastManager mLocalBroadcastManager; // 本地广播管理器实例
+
+    // ========================= 公共静态方法 =========================
+    /**
+     * 公共静态方法：启动服务
+     * @param context 上下文
+     * @param delayMillis 定时时长（毫秒）
+     */
+    public static void startService(Context context, long delayMillis) {
+        LogUtils.i(TAG, "调用静态入口方法 startService");
+        LogUtils.i(TAG, "入参 - context: " + context + ", delayMillis: " + delayMillis);
+
+        if (context == null) {
+            LogUtils.w(TAG, "启动失败，上下文为null");
+            return;
+        }
+        if (isServiceRunning()) {
+            LogUtils.i(TAG, "服务已运行，忽略重复启动请求");
+            return;
+        }
+
+        // 构建Intent传递参数
+        Intent intent = new Intent(context, LimitedTimeSpecialChannelService.class);
+        intent.putExtra(EXTRA_SECURITY_TOKEN, mValidToken);
+        intent.putExtra(EXTRA_DELAY_MILLIS, delayMillis);
+
+        context.startService(intent);
+        LogUtils.i(TAG, "服务启动命令已发出");
+    }
+
+    /**
+     * 公共静态方法：停止服务
+     * @param context 上下文
+     */
+    public static void stopService(Context context) {
+        LogUtils.i(TAG, "调用静态入口方法 stopService");
+        LogUtils.i(TAG, "入参 - context: " + context);
+
+        if (context == null) {
+            LogUtils.w(TAG, "停止失败，上下文为null");
+            return;
+        }
+        Intent intent = new Intent(context, LimitedTimeSpecialChannelService.class);
+        context.stopService(intent);
+        LogUtils.i(TAG, "服务停止命令已发出");
+    }
+
+    /**
+     * 公共静态方法：查询服务运行状态
+     * @return true if running
+     */
+    public static boolean isServiceRunning() {
+        return sIsServiceRunning;
+    }
+
+    /**
+     * 【核心单元测试方法】
+     * 执行完整的单元测试流程
+     * @param context 上下文
+     */
+    public static void unitTest(Context context) {
+        LogUtils.i(TAG, "=== 开始执行单元测试 ===");
+
+        // 测试1: 初始状态应为未运行
+        boolean initialState = isServiceRunning();
+        LogUtils.i(TAG, "测试1 - 初始状态检查: " + (initialState ? "失败(不应运行)" : "成功(未运行)"));
+
+        // 启动服务，设置5秒定时
+        startService(context, 5000L);
+
+        // 核心修复：同步等待服务启动完成
+        try {
+            Thread.sleep(1200);
+        } catch (InterruptedException e) {
+            LogUtils.e(TAG, "单元测试等待被中断", e);
+        }
+
+        // 测试3: 验证服务已启动
+        boolean runningState = isServiceRunning();
+        LogUtils.i(TAG, "测试3 - 运行状态检查: " + (runningState ? "成功(运行中)" : "失败(未运行)"));
+
+        // 测试4: 尝试重复启动
+        LogUtils.i(TAG, "测试4 - 尝试重复启动(预期忽略)");
+        startService(context, 5000L);
+
+        // 测试5: 等待服务自动停止
+        LogUtils.i(TAG, "测试5 - 等待服务自动停止(5秒)...");
+        try {
+            // 等待超过服务的5秒运行时间，确保能观测到销毁状态
+            Thread.sleep(6000);
+        } catch (InterruptedException e) {
+            LogUtils.e(TAG, "测试等待被中断", e);
+        }
+
+        // 验证最终状态
+        boolean finalState = isServiceRunning();
+        LogUtils.i(TAG, "测试5 - 最终状态检查: " + (!finalState ? "成功(已销毁)" : "失败(仍运行)"));
+        LogUtils.i(TAG, "=== 单元测试执行完成 ===");
+    }
+
+    // ========================= 生命周期 =========================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.i(TAG, "服务 onCreate，创建实例");
+        sInstance = this;
+        sIsServiceRunning = true;
+
+        // 初始化本地广播管理器
+        mLocalBroadcastManager = LocalBroadcastManager.getInstance(this);
+        LogUtils.i(TAG, "本地广播管理器初始化完成");
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.i(TAG, "服务 onStartCommand，处理启动请求");
+        LogUtils.i(TAG, "入参 - intent: " + intent + ", flags: " + flags + ", startId: " + startId);
+
+        if (!isValidToken(intent)) {
+            LogUtils.w(TAG, "安全校验失败，拒绝启动服务");
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+
+        long delayMillis = intent.getLongExtra(EXTRA_DELAY_MILLIS, 0);
+        if (delayMillis <= 0) {
+            LogUtils.w(TAG, "无效的定时时长: " + delayMillis + "，服务将退出");
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+
+        // 初始化总时长和剩余时长
+        mTotalMillis = delayMillis;
+        mRemainingMillis = delayMillis;
+        LogUtils.i(TAG, "初始化定时时长: " + (mTotalMillis / 1000) + " 秒");
+
+        startLoopTask();
+        // 设置自动停止定时器
+        mHandler.postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.i(TAG, "定时时长结束，准备停止服务");
+					stopSelf();
+				}
+			}, delayMillis);
+
+        return START_STICKY;
+    }
+
+    @Override
+    public void onDestroy() {
+        LogUtils.i(TAG, "服务 onDestroy，准备销毁");
+
+        // 发送本地广播，通知应用内其他组件服务即将销毁
+        // 此处携带剩余秒数信息，方便接收端知晓具体的结束状态
+        sendServiceDestroyedBroadcast();
+
+        // 重置运行状态
+        sIsServiceRunning = false;
+        sInstance = null;
+
+        // 清理所有回调
+        mHandler.removeCallbacksAndMessages(null);
+
+        // 执行父类销毁
+        super.onDestroy();
+
+        LogUtils.i(TAG, "服务销毁流程完成");
+    }
+
+    /**
+     * 发送服务销毁的本地广播
+     * 确保应用内所有注册了该广播接收器的组件都能收到通知
+     * [新增] 携带当前剩余秒数信息
+     */
+    private void sendServiceDestroyedBroadcast() {
+        LogUtils.i(TAG, "准备发送服务销毁本地广播");
+        try {
+            Intent intent = new Intent(ACTION_SERVICE_DESTROYED);
+            // 新增：将当前剩余秒数放入广播附加数据中
+            intent.putExtra(EXTRA_REMAINING_SECONDS, mRemainingMillis / 1000);
+
+            mLocalBroadcastManager.sendBroadcast(intent);
+            LogUtils.i(TAG, "服务销毁广播发送成功，Action: " + ACTION_SERVICE_DESTROYED);
+            LogUtils.i(TAG, "广播附加数据 - 剩余秒数: " + (mRemainingMillis / 1000));
+        } catch (Exception e) {
+            LogUtils.e(TAG, "发送服务销毁广播失败", e);
+        }
+    }
+
+    /**
+     * 发送倒计时心跳的本地广播
+     * 每秒执行一次，携带当前剩余秒数和总时长
+     */
+    private void sendCountdownTickBroadcast() {
+        try {
+            Intent intent = new Intent(ACTION_COUNTDOWN_TICK);
+            intent.putExtra(EXTRA_REMAINING_SECONDS, mRemainingMillis / 1000);
+            intent.putExtra(EXTRA_TOTAL_SECONDS, mTotalMillis / 1000);
+
+            mLocalBroadcastManager.sendBroadcast(intent);
+            // 日志已精简，只在关键节点打印
+        } catch (Exception e) {
+            LogUtils.e(TAG, "发送倒计时广播失败", e);
+        }
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.i(TAG, "服务 onBind，不支持绑定操作");
+        // 不支持绑定
+        return null;
+    }
+
+    // ========================= 私有辅助方法 =========================
+    /**
+     * 校验令牌有效性
+     */
+    private boolean isValidToken(Intent intent) {
+        LogUtils.i(TAG, "调用 isValidToken 方法进行安全校验");
+        LogUtils.i(TAG, "入参 - intent: " + intent);
+
+        if (intent == null) {
+            return false;
+        }
+        String incomingToken = intent.getStringExtra(EXTRA_SECURITY_TOKEN);
+        LogUtils.i(TAG, "接收到外部传入令牌: " + incomingToken);
+        LogUtils.i(TAG, "本地校验令牌: " + mValidToken);
+        return mValidToken.equals(incomingToken);
+    }
+
+    /**
+     * 启动循环任务
+     */
+    private void startLoopTask() {
+        LogUtils.i(TAG, "启动倒计时循环任务");
+        mHandler.removeCallbacks(mLoopTaskRunnable);
+        mHandler.postDelayed(mLoopTaskRunnable, 1000);
+    }
+
+    /**
+     * 循环任务心跳
+     * 核心逻辑：先递减时长，再发送广播，确保0秒能被正确发送
+     */
+    private final Runnable mLoopTaskRunnable = new Runnable() {
+        @Override
+        public void run() {
+            if (sIsServiceRunning) {
+                // 核心修复：先递减剩余时长
+                if (mRemainingMillis >= 1000) {
+                    mRemainingMillis -= 1000;
+                } else {
+                    // 兜底：防止负数，直接置为0
+                    mRemainingMillis = 0;
+                }
+
+                // 计算并发送当前剩余秒数
+                long remainingSeconds = mRemainingMillis / 1000;
+                // 日志已精简，只在非0状态打印，避免日志刷屏
+                if (remainingSeconds > 0) {
+                    LogUtils.i(TAG, "循环心跳：剩余 " + remainingSeconds + " 秒");
+                }
+
+                // 发送倒计时广播
+                sendCountdownTickBroadcast();
+
+                // 递归调用，形成循环
+                startLoopTask();
+            }
+        }
+    };
+
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/services/MainService.java b/contacts/src/main/java/cc/winboll/studio/contacts/services/MainService.java
new file mode 100644
index 0000000..1b7d469
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/services/MainService.java
@@ -0,0 +1,593 @@
+package cc.winboll.studio.contacts.services;
+
+import android.app.ActivityManager;
+import android.app.Notification;
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.media.AudioManager;
+import android.os.Binder;
+import android.os.Handler;
+import android.os.IBinder;
+import android.os.Looper;
+import cc.winboll.studio.contacts.bobulltoon.TomCat;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.contacts.handlers.MainServiceHandler;
+import cc.winboll.studio.contacts.listenphonecall.CallListenerService;
+import cc.winboll.studio.contacts.model.MainServiceBean;
+import cc.winboll.studio.contacts.model.RingTongBean;
+import cc.winboll.studio.contacts.receivers.MainReceiver;
+import cc.winboll.studio.contacts.utils.NotificationManagerUtils;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.Timer;
+import java.util.TimerTask;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/13 06:56:41
+ * @Describe 拨号主服务，负责核心业务逻辑、守护进程绑定、铃声音量监控及通话监听启动
+ * 严格适配 Android API 30 + Java 7 语法规范 | 解决前台服务启动超时崩溃
+ * 核心优化：1. 移除延迟启动逻辑 2. 标准化日志管理 3. 强化资源清理 4. 结构分层重构
+ */
+public class MainService extends Service {
+
+    // ====================== 常量定义区（全硬编码，无高版本API依赖） ======================
+    public static final String TAG = "MainService";
+    public static final int MSG_UPDATE_STATUS = 0;
+
+    // 铃声音量监控参数（定时检查+恢复）
+    private static final long VOLUME_CHECK_DELAY = 1000L;    // 首次检查延迟1s
+    private static final long VOLUME_CHECK_PERIOD = 60000L; // 后续每60s检查一次
+
+    // 前台服务配置（固定ID+渠道，避免重复创建）
+    private static final String FOREGROUND_CHANNEL_ID = "main_service_foreground_channel";
+    private static final int FOREGROUND_NOTIFICATION_ID = 1001;
+    private static final int FOREGROUND_SERVICE_TYPE_DATA_SYNC = 0x00000001; // dataSync类型硬编码
+
+    // Android版本常量（替代Build.VERSION_CODES，适配Java7）
+    private static final int ANDROID_8_API = 26;  // Android 8.0
+    private static final int ANDROID_10_API = 29; // Android 10
+    private static final int ANDROID_12_API = 31; // Android 12
+
+    // 守护服务重绑定延迟（仅保留核心重试逻辑）
+    private static final long RETRY_DELAY_MS = 3000L;
+
+    // ====================== 静态成员属性区（全局共享实例，统一前缀s） ======================
+    private static MainService sMainServiceInstance;    // 主服务全局实例
+    private static volatile TomCat sTomCatInstance;     // 号码识别核心实例（volatile保证可见性）
+
+    // ====================== 成员属性区（业务+UI+资源，统一前缀m） ======================
+    private volatile boolean mIsServiceRunning;         // 服务运行状态标记（volatile防指令重排）
+    private MainServiceBean mMainServiceBean;           // 服务配置实体（启用状态存储）
+    private MainServiceHandler mMainServiceHandler;     // 服务消息处理器（主线程通信）
+    private MyServiceConnection mServiceConnection;     // 守护服务连接实例
+    private AssistantService mAssistantService;         // 绑定的守护服务实例
+    private boolean mIsAssistantBound;                  // 守护服务绑定状态标记
+    private MainReceiver mMainReceiver;                 // 全局广播接收器（监听系统事件）
+    private Timer mVolumeCheckTimer;                    // 铃声音量检查定时器（定时恢复配置）
+
+    // ====================== 内部类：Binder（服务绑定通信，优先定义） ======================
+    public class MyBinder extends Binder {
+        /**
+         * 外部组件绑定服务时，获取主服务实例
+         * @return MainService 主服务实例
+         */
+        public MainService getService() {
+            LogUtils.d(TAG, "MyBinder.getService: 外部获取主服务实例");
+            return MainService.this;
+        }
+    }
+
+    // ====================== 内部类：ServiceConnection（守护服务绑定回调） ======================
+    private class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            if (service == null) {
+                LogUtils.w(TAG, "MyServiceConnection.onServiceConnected: 绑定的IBinder为空，绑定失败");
+                mIsAssistantBound = false;
+                return;
+            }
+
+            try {
+                // 类型转换获取守护服务实例
+                AssistantService.MyBinder binder = (AssistantService.MyBinder) service;
+                mAssistantService = binder.getService();
+                mIsAssistantBound = true;
+                LogUtils.d(TAG, "MyServiceConnection.onServiceConnected: 守护服务绑定成功");
+            } catch (ClassCastException e) {
+                LogUtils.e(TAG, "MyServiceConnection.onServiceConnected: IBinder类型转换失败", e);
+                mIsAssistantBound = false;
+            }
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            LogUtils.w(TAG, "MyServiceConnection.onServiceDisconnected: 守护服务连接断开");
+            mAssistantService = null;
+            mIsAssistantBound = false;
+
+            // 服务启用状态下，重试绑定守护服务（主服务存活核心保障）
+            if (mMainServiceBean != null && mMainServiceBean.isEnable()) {
+                LogUtils.d(TAG, "MyServiceConnection.onServiceDisconnected: " + RETRY_DELAY_MS + "ms后重试绑定守护服务");
+                new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+						@Override
+						public void run() {
+							wakeupAndBindAssistantService();
+						}
+					}, RETRY_DELAY_MS);
+            } else {
+                LogUtils.w(TAG, "MyServiceConnection.onServiceDisconnected: 主服务已禁用，跳过重试绑定");
+            }
+        }
+    }
+
+    // ====================== 对外静态方法区（服务启停/重启/状态查询，全局调用） ======================
+    /**
+     * 检查号码是否在BoBullToon库中（外部组件调用，静态入口）
+     * @param phone 待查询号码
+     * @return true=是BoBullToon号码，false=否/初始化失败
+     */
+    public static boolean isPhoneInBoBullToon(String phone) {
+        if (sTomCatInstance != null && phone != null && !phone.isEmpty()) {
+            boolean result = sTomCatInstance.isPhoneBoBullToon(phone);
+            LogUtils.d(TAG, "isPhoneInBoBullToon: 号码" + phone + "查询结果：" + (result ? "是" : "否"));
+            return result;
+        }
+        LogUtils.w(TAG, "isPhoneInBoBullToon: TomCat未初始化或号码为空，查询失败");
+        return false;
+    }
+
+    /**
+     * 停止主服务（仅停止，不修改配置）
+     * @param context 上下文（非空校验）
+     */
+    public static void stopMainService(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "stopMainService: 上下文为空，无法停止服务");
+            return;
+        }
+        LogUtils.d(TAG, "stopMainService: 执行停止主服务操作");
+        context.stopService(new Intent(context, MainService.class));
+    }
+
+    /**
+     * 启动主服务（仅启动，不修改配置）
+     * @param context 上下文（非空校验）
+     */
+    public static void startMainService(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "startMainService: 上下文为空，无法启动服务");
+            return;
+        }
+        LogUtils.d(TAG, "startMainService: 执行启动主服务操作（前台服务模式）");
+        Intent intent = new Intent(context, MainService.class);
+        context.startForegroundService(intent);
+    }
+
+    /**
+     * 重启主服务（先停后启，需服务已启用）
+     * @param context 上下文（非空校验）
+     */
+    public static void restartMainService(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "restartMainService: 上下文为空，无法重启服务");
+            return;
+        }
+        LogUtils.d(TAG, "restartMainService: 执行主服务重启流程");
+
+        MainServiceBean config = MainServiceBean.loadBean(context, MainServiceBean.class);
+        if (config != null && config.isEnable()) {
+            stopMainService(context);
+            startMainService(context);
+            LogUtils.i(TAG, "restartMainService: 主服务重启完成");
+        } else {
+            LogUtils.w(TAG, "restartMainService: 服务未启用或配置为空，跳过重启");
+        }
+    }
+
+    /**
+     * 停止服务并保存禁用状态（更新配置+停止服务）
+     * @param context 上下文（非空校验）
+     */
+    public static void stopMainServiceAndSaveStatus(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "stopMainServiceAndSaveStatus: 上下文为空，操作失败");
+            return;
+        }
+        LogUtils.d(TAG, "stopMainServiceAndSaveStatus: 保存禁用状态并停止服务");
+        MainServiceBean config = new MainServiceBean();
+        config.setIsEnable(false);
+        MainServiceBean.saveBean(context, config);
+        stopMainService(context);
+    }
+
+    /**
+     * 启动服务并保存启用状态（更新配置+启动服务，先停后启避免重复）
+     * @param context 上下文（非空校验）
+     */
+    public static void startMainServiceAndSaveStatus(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "startMainServiceAndSaveStatus: 上下文为空，操作失败");
+            return;
+        }
+        LogUtils.d(TAG, "startMainServiceAndSaveStatus: 保存启用状态并启动服务");
+        MainServiceBean config = new MainServiceBean();
+        config.setIsEnable(true);
+        MainServiceBean.saveBean(context, config);
+        stopMainService(context); // 先停止旧服务，避免冲突
+        startMainService(context);
+    }
+
+    // ====================== 核心工具方法区（服务状态检查+前台通知创建，通用功能） ======================
+    /**
+     * 补充消息追加方法（外部组件向服务发送消息）
+     * @param message 待追加消息（空值防护）
+     */
+    public void appenMessage(String message) {
+        String msg = message == null ? "null" : message;
+        LogUtils.d(TAG, "appenMessage: 接收外部消息：" + msg);
+
+        if (mMainServiceHandler != null) {
+            android.os.Message handlerMsg = android.os.Message.obtain();
+            handlerMsg.what = MSG_UPDATE_STATUS;
+            handlerMsg.obj = msg;
+            mMainServiceHandler.sendMessage(handlerMsg);
+            LogUtils.d(TAG, "appenMessage: 消息已发送至Handler处理");
+        } else {
+            LogUtils.w(TAG, "appenMessage: MainServiceHandler未初始化，消息发送失败");
+        }
+    }
+
+    /**
+     * 创建前台服务通知（Android8.0+需渠道，低版本兼容）
+     * @return Notification 前台服务通知实例
+     */
+//    private Notification createForegroundNotification() {
+//        // 1. Android8.0+创建通知渠道（必需，否则通知不显示）
+//        if (Build.VERSION.SDK_INT >= ANDROID_8_API) {
+//            NotificationChannel channel = new NotificationChannel(
+//				FOREGROUND_CHANNEL_ID,
+//				"拨号主服务",
+//				NotificationManager.IMPORTANCE_LOW
+//            );
+//            channel.setDescription("主服务后台运行，保障通话监听与号码识别功能正常");
+//            channel.setSound(null, null); // 关闭通知声音
+//            channel.enableVibration(false); // 关闭振动
+//
+//            NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
+//            if (notificationManager != null) {
+//                notificationManager.createNotificationChannel(channel);
+//                LogUtils.d(TAG, "createForegroundNotification: Android8.0+通知渠道创建成功");
+//            } else {
+//                LogUtils.e(TAG, "createForegroundNotification: NotificationManager获取失败，渠道创建失败");
+//            }
+//        }
+//
+//        // 2. 构建通知实例（分版本兼容Builder）
+//        Notification.Builder builder;
+//        if (Build.VERSION.SDK_INT >= ANDROID_8_API) {
+//            builder = new Notification.Builder(this, FOREGROUND_CHANNEL_ID);
+//        } else {
+//            builder = new Notification.Builder(this);
+//        }
+//        builder.setSmallIcon(R.drawable.ic_launcher);
+//        builder.setContentTitle("拨号服务运行中");
+//        builder.setContentText("后台保障通话监听与号码识别，请勿手动关闭");
+//        builder.setPriority(Notification.PRIORITY_LOW); // 低优先级，不打扰用户
+//        builder.setOngoing(true); // 不可手动清除，保障服务存活
+//
+//        LogUtils.d(TAG, "createForegroundNotification: 前台服务通知构建完成");
+//        return builder.build();
+//    }
+
+    /**
+     * 检查指定服务是否正在运行（通过ActivityManager查询）
+     * @param serviceClass 待检查服务类
+     * @return true=运行中，false=未运行/查询失败
+     */
+    private boolean isServiceRunning(Class<?> serviceClass) {
+        if (serviceClass == null) {
+            LogUtils.e(TAG, "isServiceRunning: 服务类为空，检查失败");
+            return false;
+        }
+
+        ActivityManager activityManager = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
+        if (activityManager == null) {
+            LogUtils.w(TAG, "isServiceRunning: ActivityManager获取失败，检查失败");
+            return false;
+        }
+
+        // 遍历运行中服务，匹配类名
+        for (ActivityManager.RunningServiceInfo serviceInfo : activityManager.getRunningServices(Integer.MAX_VALUE)) {
+            if (serviceClass.getName().equals(serviceInfo.service.getClassName())) {
+                LogUtils.d(TAG, "isServiceRunning: 服务" + serviceClass.getSimpleName() + "正在运行");
+                return true;
+            }
+        }
+        LogUtils.d(TAG, "isServiceRunning: 服务" + serviceClass.getSimpleName() + "未运行");
+        return false;
+    }
+
+    // ====================== Service生命周期方法区（按执行顺序：创建→绑定→启动→销毁） ======================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "===== onCreate: 主服务开始创建 =====");
+        sMainServiceInstance = this;
+        mIsServiceRunning = false;
+
+        // 初始化核心组件（无延迟，直接初始化）
+        mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        mServiceConnection = new MyServiceConnection();
+        mMainServiceHandler = new MainServiceHandler(this);
+
+        // 初始化音量监控定时器（服务启动即开启，保障音量配置）
+        initVolumeCheckTimer();
+
+        // 执行核心业务启动逻辑（无延迟，优先启动）
+        startCoreBusiness();
+
+        LogUtils.d(TAG, "===== onCreate: 主服务创建完成 =====");
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.d(TAG, "onBind: 主服务被外部组件绑定，Intent=" + (intent != null ? intent.getAction() : "null"));
+        return new MyBinder();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand: 主服务被启动，startId=" + startId);
+        // 重复启动时再次执行核心业务（避免服务被杀死后重启失败）
+        startCoreBusiness();
+
+        // 服务启用则返回START_STICKY（系统杀死后自动重启），否则默认行为
+        int result = (mMainServiceBean != null && mMainServiceBean.isEnable()) ? START_STICKY : super.onStartCommand(intent, flags, startId);
+        LogUtils.d(TAG, "onStartCommand: 服务启动模式：" + (result == START_STICKY ? "START_STICKY（自动重启）" : "默认模式"));
+        return result;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "===== onDestroy: 主服务开始销毁，全量清理资源 =====");
+
+        // 1. 停止音量监控定时器（释放线程资源）
+        cancelVolumeCheckTimer();
+
+        // 2. 解除守护服务绑定（避免内存泄漏）
+        if (mIsAssistantBound && mServiceConnection != null) {
+            try {
+                unbindService(mServiceConnection);
+                LogUtils.d(TAG, "onDestroy: 守护服务绑定已解除");
+            } catch (IllegalArgumentException e) {
+                LogUtils.w(TAG, "onDestroy: 解除守护服务绑定失败（服务未绑定）", e);
+            }
+            mIsAssistantBound = false;
+            mServiceConnection = null;
+        }
+
+        // 3. 注销广播接收器（释放系统资源）
+        if (mMainReceiver != null) {
+            mMainReceiver.unregisterAction(this);
+            mMainReceiver = null;
+            LogUtils.d(TAG, "onDestroy: 全局广播接收器已注销");
+        }
+
+        // 4. 停止所有子服务（强制停止，避免子服务残留）
+        stopService(new Intent(this, AssistantService.class));
+        stopService(new Intent(this, CallListenerService.class));
+        stopService(new Intent(this, MyCallScreeningService.class));
+        LogUtils.d(TAG, "onDestroy: 所有子服务已强制停止");
+
+        // 5. 清空所有引用（静态+成员，彻底避免内存泄漏，不修改配置Bean）
+        sMainServiceInstance = null;
+        sTomCatInstance = null;
+        mMainServiceHandler = null;
+        mAssistantService = null;
+        mMainServiceBean = null;
+
+        // 标记服务为未运行
+        mIsServiceRunning = false;
+        LogUtils.d(TAG, "===== onDestroy: 主服务销毁完成，资源全清理 =====");
+    }
+
+    // ====================== 核心业务逻辑区（服务启动核心流程，无延迟） ======================
+    /**
+     * 启动核心业务（主服务核心入口，避免重复启动）
+     */
+    private synchronized void startCoreBusiness() {
+        // 服务已运行则直接返回，避免重复执行启动流程
+        if (mIsServiceRunning) {
+            LogUtils.d(TAG, "startCoreBusiness: 主服务已运行，跳过重复启动");
+            return;
+        }
+        mIsServiceRunning = true;
+
+        // 重新加载最新配置（避免配置修改后未生效）
+        mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        if (mMainServiceBean == null || !mMainServiceBean.isEnable()) {
+            LogUtils.w(TAG, "startCoreBusiness: 服务配置未启用或配置为空，启动流程终止");
+            mIsServiceRunning = false;
+            stopSelf(); // 未启用则主动停止服务
+            return;
+        }
+
+        LogUtils.i(TAG, "startCoreBusiness: 服务配置已启用，启动核心流程");
+
+        // 1. 优先启动前台服务（避免前台服务启动超时崩溃，核心优先级）
+        try {
+			NotificationManagerUtils notificationManagerUtils = new NotificationManagerUtils(this);
+			notificationManagerUtils.startForegroundServiceNotify(this, "主要拨号服务已启动。");
+            LogUtils.i(TAG, "startCoreBusiness: 前台服务启动成功，通知ID=" + FOREGROUND_NOTIFICATION_ID);
+        } catch (IllegalArgumentException e) {
+            LogUtils.e(TAG, "startCoreBusiness: 前台服务启动失败（服务类型不匹配）", e);
+            mIsServiceRunning = false;
+            stopSelf();
+            return;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "startCoreBusiness: 前台服务启动异常", e);
+            mIsServiceRunning = false;
+            stopSelf();
+            return;
+        }
+
+        // 2. 绑定守护服务（保障主服务存活，防系统杀死）
+        wakeupAndBindAssistantService();
+
+        // 3. 初始化核心业务组件（号码识别+黑白名单规则）
+        initTomCatComponent();
+        initRulesConfig();
+
+        // 4. 启动通话监听相关服务（无延迟，直接启动，保障功能生效）
+        startCallRelatedServices();
+
+        LogUtils.i(TAG, "startCoreBusiness: 主服务核心流程启动完成，服务正常运行");
+    }
+
+    /**
+     * 唤醒并绑定守护服务（分版本适配启动方式，Android10+前台服务启动）
+     */
+    private void wakeupAndBindAssistantService() {
+        if (mServiceConnection == null) {
+            LogUtils.e(TAG, "wakeupAndBindAssistantService: 服务连接实例未初始化，绑定失败");
+            return;
+        }
+
+        Intent assistantIntent = new Intent(this, AssistantService.class);
+        // Android10+应用后台启动服务需用前台服务模式
+        LogUtils.d(TAG, "wakeupAndBindAssistantService: Android10+，前台服务模式启动守护服务");
+		startService(assistantIntent);
+
+        // 绑定守护服务（BIND_IMPORTANT：高优先级绑定，断开时回调）
+        bindService(assistantIntent, mServiceConnection, Context.BIND_IMPORTANT);
+        LogUtils.d(TAG, "wakeupAndBindAssistantService: 守护服务启动并发起绑定请求");
+    }
+
+    // ====================== 铃声音量监控方法区（定时检查+恢复配置） ======================
+    /**
+     * 初始化音量检查定时器（先取消旧定时器，避免重复创建）
+     */
+    private void initVolumeCheckTimer() {
+        cancelVolumeCheckTimer();
+        mVolumeCheckTimer = new Timer();
+        mVolumeCheckTimer.schedule(new TimerTask() {
+				@Override
+				public void run() {
+					checkAndRestoreRingerVolume();
+				}
+			}, VOLUME_CHECK_DELAY, VOLUME_CHECK_PERIOD);
+        LogUtils.d(TAG, "initVolumeCheckTimer: 铃声音量监控定时器启动，周期" + VOLUME_CHECK_PERIOD + "ms");
+    }
+
+    /**
+     * 检查并恢复铃声音量（对比配置值，不一致则恢复，保障用户配置生效）
+     */
+    private void checkAndRestoreRingerVolume() {
+        AudioManager audioManager = (AudioManager) getSystemService(AUDIO_SERVICE);
+        if (audioManager == null) {
+            LogUtils.e(TAG, "checkAndRestoreRingerVolume: AudioManager获取失败，音量检查终止");
+            return;
+        }
+
+        // 加载音量配置（无配置则初始化默认值）
+        RingTongBean ringConfig = RingTongBean.loadBean(this, RingTongBean.class);
+        if (ringConfig == null) {
+            ringConfig = new RingTongBean();
+            RingTongBean.saveBean(this, ringConfig);
+            LogUtils.d(TAG, "checkAndRestoreRingerVolume: 音量配置未存在，初始化默认配置");
+            return;
+        }
+
+        try {
+            int currentVolume = audioManager.getStreamVolume(AudioManager.STREAM_RING);
+            int configVolume = ringConfig.getStreamVolume();
+            // 音量不一致则恢复配置值
+            if (currentVolume != configVolume) {
+                audioManager.setStreamVolume(AudioManager.STREAM_RING, configVolume, 0);
+                LogUtils.d(TAG, "checkAndRestoreRingerVolume: 铃声音量已恢复，配置值=" + configVolume + "，原当前值=" + currentVolume);
+			} else {
+                LogUtils.v(TAG, "checkAndRestoreRingerVolume: 铃声音量与配置一致，无需调整");
+            }
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, "checkAndRestoreRingerVolume: 音量设置权限不足，恢复失败", e);
+        }
+    }
+
+    /**
+     * 取消音量检查定时器（释放Timer资源，避免内存泄漏）
+     */
+    private void cancelVolumeCheckTimer() {
+        if (mVolumeCheckTimer != null) {
+            mVolumeCheckTimer.cancel();
+            mVolumeCheckTimer = null;
+            LogUtils.d(TAG, "cancelVolumeCheckTimer: 铃声音量监控定时器已取消");
+        }
+    }
+
+    // ====================== 辅助初始化方法区（业务组件初始化，统一归类） ======================
+    /**
+     * 初始化TomCat组件（号码识别核心，加载本地数据）
+     */
+    private void initTomCatComponent() {
+        sTomCatInstance = TomCat.getInstance(this);
+        if (sTomCatInstance.loadPhoneBoBullToon()) {
+            LogUtils.d(TAG, "initTomCatComponent: BoBullToon号码库加载成功");
+        } else {
+            LogUtils.w(TAG, "initTomCatComponent: BoBullToon号码库未下载，加载失败（不影响服务运行）");
+        }
+    }
+
+    /**
+     * 初始化黑白名单规则配置（加载本地规则，保障通话筛选生效）
+     */
+    private void initRulesConfig() {
+        Rules rules = Rules.getInstance(this);
+        if (rules != null) {
+            rules.loadRules();
+            LogUtils.d(TAG, "initRulesConfig: 黑白名单通话规则加载完成");
+        } else {
+            LogUtils.e(TAG, "initRulesConfig: Rules实例获取失败，通话规则加载失败");
+        }
+    }
+
+    /**
+     * 初始化广播接收器（监听系统事件，如开机启动、网络变化）
+     */
+    private void initMainReceiver() {
+        if (mMainReceiver == null) {
+            mMainReceiver = new MainReceiver(this);
+            mMainReceiver.registerAction(this);
+            LogUtils.d(TAG, "initMainReceiver: 全局广播接收器注册完成");
+        } else {
+            LogUtils.d(TAG, "initMainReceiver: 广播接收器已初始化，跳过重复注册");
+        }
+    }
+
+    /**
+     * 启动通话相关服务（通话监听+通话筛选，核心功能服务）
+     */
+    private void startCallRelatedServices() {
+        // 启动通话监听服务
+        try {
+            Intent callListenerIntent = new Intent(this, CallListenerService.class);
+            startService(callListenerIntent);
+            LogUtils.d(TAG, "startCallRelatedServices: CallListenerService启动成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "startCallRelatedServices: CallListenerService启动失败", e);
+        }
+
+        // 启动通话筛选服务（API10+生效，低版本兼容）
+        try {
+            Intent screeningIntent = new Intent(this, MyCallScreeningService.class);
+            startService(screeningIntent);
+            LogUtils.d(TAG, "startCallRelatedServices: MyCallScreeningService启动成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "startCallRelatedServices: MyCallScreeningService启动失败", e);
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/services/MyCallScreeningService.java b/contacts/src/main/java/cc/winboll/studio/contacts/services/MyCallScreeningService.java
new file mode 100644
index 0000000..95a0884
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/services/MyCallScreeningService.java
@@ -0,0 +1,246 @@
+package cc.winboll.studio.contacts.services;
+
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.telecom.CallScreeningService;
+import android.telephony.TelephonyManager;
+import androidx.annotation.NonNull;
+import androidx.annotation.RequiresApi;
+import cc.winboll.studio.contacts.model.MainServiceBean;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Describe 通话筛选服务（无前台服务），负责识别通话类型、拦截指定号码、处理正常通话逻辑
+ * 严格适配 Java7 语法 + Android API29-30 | 轻量稳定 | 强化空指针防护 | 无冗余代码
+ */
+@RequiresApi(api = 29) // 父类 CallScreeningService 最低要求 API29，明确标注
+public class MyCallScreeningService extends CallScreeningService {
+
+    // ====================== 常量定义区（全硬编码，无高版本API依赖） ======================
+    public static final String TAG = "MyCallScreeningService";
+
+    // 通话方向常量（硬编码替代 Call.Details 高版本字段，适配API29-30）
+    private static final int CALL_DIRECTION_INCOMING = 1; // 来电
+    private static final int CALL_DIRECTION_OUTGOING = 2; // 外拨
+
+    // ====================== 成员属性区（精简必要属性，命名规范） ======================
+    private Context mContext; // 上下文对象，避免重复调用 getApplicationContext()
+
+    // ====================== Service生命周期方法区（按执行顺序排列） ======================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        mContext = this;
+        LogUtils.d(TAG, "===== onCreate: 通话筛选服务启动 =====");
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand: 服务被启动，startId=" + startId);
+
+        // 加载服务配置，决定重启策略（启用则自动重启，禁用则默认）
+        MainServiceBean serviceConfig = MainServiceBean.loadBean(this, MainServiceBean.class);
+        int startMode = (serviceConfig != null && serviceConfig.isEnable()) ? START_STICKY : super.onStartCommand(intent, flags, startId);
+        LogUtils.d(TAG, "onStartCommand: 服务启动模式：" + (startMode == START_STICKY ? "START_STICKY（自动重启）" : "默认模式"));
+
+        return startMode;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        // 置空上下文，释放引用，避免内存泄漏
+        mContext = null;
+        LogUtils.d(TAG, "===== onDestroy: 通话筛选服务销毁完成 =====");
+    }
+
+    // ====================== 核心通话筛选方法区（父类抽象方法实现） ======================
+    /**
+     * 核心：通话筛选入口（API29-30标准方法，100%兼容）
+     * 功能：识别通话号码/类型、拦截指定号码、处理正常通话
+     */
+    @Override
+    @RequiresApi(api = 29)
+    public void onScreenCall(@NonNull android.telecom.Call.Details details) {
+        LogUtils.d(TAG, "===== onScreenCall: 开始筛选通话 =====");
+
+        // 1. 安全获取通话号码（多层空指针防护，Java7规范写法）
+        String phoneNumber = getSafePhoneNumber(details);
+        // 2. 识别通话方向（来电/外拨/未知）
+        int callDirection = details.getCallDirection();
+        String callTypeDesc = getCallDirectionDesc(callDirection);
+        int callState = getCallStateByDirection(callDirection);
+
+        LogUtils.d(TAG, "筛选结果：通话类型=" + callTypeDesc + "，号码=" + phoneNumber);
+
+        // 3. 自定义拦截逻辑（示例：拦截指定号码10086，可按需扩展黑白名单）
+        boolean isNeedBlock = isTargetBlockNumber(phoneNumber);
+
+        // 4. 构建筛选响应（Java7分步调用，不使用链式写法，避免兼容问题）
+        CallResponse callResponse = buildCallScreeningResponse(isNeedBlock);
+
+        // 5. 提交筛选结果（必须调用父类方法，完成拦截/放行逻辑）
+        respondToCall(details, callResponse);
+
+        // 6. 分场景处理后续逻辑（拦截日志/正常通话业务）
+        handleCallAfterScreening(phoneNumber, callTypeDesc, isNeedBlock);
+
+        LogUtils.d(TAG, "===== onScreenCall: 通话筛选完成 =====");
+    }
+
+    // ====================== 业务逻辑方法区（按功能拆分，低耦合） ======================
+    /**
+     * 安全获取通话号码（多层空指针+空字符串防护，避免崩溃）
+     */
+    private String getSafePhoneNumber(android.telecom.Call.Details details) {
+        String phoneNumber = "未知号码";
+        if (details == null) {
+            LogUtils.w(TAG, "getSafePhoneNumber: 通话详情为空，无法获取号码");
+            return phoneNumber;
+        }
+
+        Uri handle = details.getHandle();
+        if (handle != null) {
+            String schemePart = handle.getSchemeSpecificPart();
+            if (schemePart != null && !schemePart.trim().isEmpty()) {
+                phoneNumber = schemePart.trim();
+                LogUtils.d(TAG, "getSafePhoneNumber: 成功获取号码，原始值=" + schemePart + "，处理后=" + phoneNumber);
+            } else {
+                LogUtils.w(TAG, "getSafePhoneNumber: 号码格式异常，schemePart=" + schemePart);
+            }
+        } else {
+            LogUtils.w(TAG, "getSafePhoneNumber: 通话 handle 为空，无法获取号码");
+        }
+        return phoneNumber;
+    }
+
+    /**
+     * 判断是否为目标拦截号码（可扩展黑白名单逻辑，当前示例拦截10086）
+     */
+    private boolean isTargetBlockNumber(String phoneNumber) {
+        if (phoneNumber == null || phoneNumber.trim().isEmpty()) {
+            LogUtils.w(TAG, "isTargetBlockNumber: 号码为空，不拦截");
+            return false;
+        }
+
+        // 示例拦截逻辑：拦截 10086（实际可替换为黑白名单查询）
+        boolean isBlock = "10086".equals(phoneNumber.trim());
+        if (isBlock) {
+            LogUtils.d(TAG, "isTargetBlockNumber: 命中拦截规则，号码=" + phoneNumber);
+        } else {
+            LogUtils.d(TAG, "isTargetBlockNumber: 未命中拦截规则，号码=" + phoneNumber);
+        }
+        return isBlock;
+    }
+
+    /**
+     * 构建通话筛选响应（按需配置拦截/放行参数，适配API29-30）
+     */
+    private CallResponse buildCallScreeningResponse(boolean isNeedBlock) {
+        CallResponse.Builder responseBuilder = new CallResponse.Builder();
+        // 拦截配置：是否禁止通话+是否拒绝通话（两者配合实现拦截）
+        responseBuilder.setDisallowCall(isNeedBlock);
+        responseBuilder.setRejectCall(isNeedBlock);
+        // 日志/通知配置：拦截的通话跳过日志和通知，正常通话保留
+        responseBuilder.setSkipCallLog(isNeedBlock);
+        responseBuilder.setSkipNotification(isNeedBlock);
+
+        CallResponse response = responseBuilder.build();
+        LogUtils.d(TAG, "buildCallScreeningResponse: 响应构建完成，拦截状态=" + isNeedBlock);
+        return response;
+    }
+
+    /**
+     * 筛选后分场景处理（拦截日志/正常通话业务扩展）
+     */
+    private void handleCallAfterScreening(String phoneNumber, String callTypeDesc, boolean isNeedBlock) {
+        if (isNeedBlock) {
+            // 拦截场景：仅打日志（可扩展：添加拦截记录、本地存储等）
+            LogUtils.d(TAG, "handleCallAfterScreening: 已拦截通话，类型=" + callTypeDesc + "，号码=" + phoneNumber);
+        } else {
+            // 正常通话场景：处理业务逻辑（可扩展：通话记录、广播通知、号码识别等）
+            int callState = getCallStateByDirection(getCallDirectionFromDesc(callTypeDesc));
+            handleNormalCallBusiness(phoneNumber, callState);
+        }
+    }
+
+    /**
+     * 正常通话业务处理（核心业务扩展入口，强化空指针防护）
+     */
+    private void handleNormalCallBusiness(String phoneNumber, int callState) {
+        if (phoneNumber == null || phoneNumber.trim().isEmpty()) {
+            LogUtils.w(TAG, "handleNormalCallBusiness: 号码为空，跳过业务处理");
+            return;
+        }
+
+        String callStateDesc = getCallStateDesc(callState);
+        LogUtils.d(TAG, "handleNormalCallBusiness: 处理正常通话业务，号码=" + phoneNumber + "，状态=" + callStateDesc);
+
+        // 此处可扩展业务逻辑（示例）：
+        // 1. 保存通话记录到本地
+        // 2. 发送广播通知其他组件（如通话监听服务）
+        // 3. 调用号码识别接口，匹配联系人信息
+    }
+
+    // ====================== 工具辅助方法区（统一归类，复用性强） ======================
+    /**
+     * 通话方向转文字描述（便于日志查看，快速定位场景）
+     */
+    private String getCallDirectionDesc(int callDirection) {
+        switch (callDirection) {
+            case CALL_DIRECTION_INCOMING:
+                return "来电";
+            case CALL_DIRECTION_OUTGOING:
+                return "外拨";
+            default:
+                return "未知通话";
+        }
+    }
+
+    /**
+     * 文字描述转通话方向（配合业务逻辑反向匹配，避免重复判断）
+     */
+    private int getCallDirectionFromDesc(String callTypeDesc) {
+        if ("来电".equals(callTypeDesc)) {
+            return CALL_DIRECTION_INCOMING;
+        } else if ("外拨".equals(callTypeDesc)) {
+            return CALL_DIRECTION_OUTGOING;
+        } else {
+            return -1; // 未知方向
+        }
+    }
+
+    /**
+     * 通话方向转 TelephonyManager 状态（统一状态标准，便于业务复用）
+     */
+    private int getCallStateByDirection(int callDirection) {
+        switch (callDirection) {
+            case CALL_DIRECTION_INCOMING:
+                return TelephonyManager.CALL_STATE_RINGING; // 来电=响铃中
+            case CALL_DIRECTION_OUTGOING:
+                return TelephonyManager.CALL_STATE_OFFHOOK; // 外拨=通话中
+            default:
+                return TelephonyManager.CALL_STATE_IDLE; // 未知=空闲
+        }
+    }
+
+    /**
+     * TelephonyManager 状态转文字描述（统一日志格式，提升可读性）
+     */
+    private String getCallStateDesc(int callState) {
+        switch (callState) {
+            case TelephonyManager.CALL_STATE_RINGING:
+                return "响铃中";
+            case TelephonyManager.CALL_STATE_OFFHOOK:
+                return "通话中";
+            case TelephonyManager.CALL_STATE_IDLE:
+                return "空闲";
+            default:
+                return "未知状态";
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/threads/MainServiceThread.java b/contacts/src/main/java/cc/winboll/studio/contacts/threads/MainServiceThread.java
new file mode 100644
index 0000000..5f0e01b
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/threads/MainServiceThread.java
@@ -0,0 +1,104 @@
+package cc.winboll.studio.contacts.threads;
+
+import android.content.Context;
+import cc.winboll.studio.contacts.handlers.MainServiceHandler;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.lang.ref.WeakReference;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/14 03:46:44
+ * @Describe 主服务后台工作线程，负责定时轮询与消息调度
+ */
+public class MainServiceThread extends Thread {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "MainServiceThread";
+    // 线程休眠周期（1秒）
+    private static final long THREAD_SLEEP_INTERVAL = 1000L;
+
+    // ====================== 静态成员变量区 ======================
+    private static volatile MainServiceThread sInstance;
+
+    // ====================== 成员变量区 ======================
+    // 线程运行控制标记
+    private volatile boolean mIsExit;
+    private volatile boolean mIsStarted;
+    // 弱引用持有上下文和Handler，避免内存泄漏
+    private WeakReference<Context> mContextWeakRef;
+    private WeakReference<MainServiceHandler> mHandlerWeakRef;
+
+    // ====================== 私有构造函数 ======================
+    private MainServiceThread(Context context, MainServiceHandler handler) {
+        this.mContextWeakRef = new WeakReference<>(context);
+        this.mHandlerWeakRef = new WeakReference<>(handler);
+        this.mIsExit = false;
+        this.mIsStarted = false;
+        LogUtils.d(TAG, "MainServiceThread: 线程实例初始化完成");
+    }
+
+    // ====================== 单例获取方法 ======================
+    public static MainServiceThread getInstance(Context context, MainServiceHandler handler) {
+        // 若已有实例，先标记退出并销毁旧实例
+        if (sInstance != null) {
+            LogUtils.d(TAG, "getInstance: 存在旧线程实例，标记退出");
+            sInstance.setIsExit(true);
+            sInstance = null;
+        }
+        // 创建新线程实例
+        sInstance = new MainServiceThread(context, handler);
+        LogUtils.d(TAG, "getInstance: 新线程实例已创建");
+        return sInstance;
+    }
+
+    // ====================== 运行状态控制方法 ======================
+    public void setIsExit(boolean isExit) {
+        this.mIsExit = isExit;
+        LogUtils.d(TAG, "setIsExit: 线程退出标记已更新 | " + isExit);
+    }
+
+    public boolean isExit() {
+        return mIsExit;
+    }
+
+    public void setIsStarted(boolean isStarted) {
+        this.mIsStarted = isStarted;
+    }
+
+    public boolean isStarted() {
+        return mIsStarted;
+    }
+
+    // ====================== 线程核心执行方法 ======================
+    @Override
+    public void run() {
+        // 防止重复启动
+        if (mIsStarted) {
+            LogUtils.w(TAG, "run: 线程已启动，避免重复执行");
+            return;
+        }
+
+        // 标记线程启动状态
+        mIsStarted = true;
+        LogUtils.i(TAG, "run: 线程开始运行");
+
+        // 线程主循环
+        while (!mIsExit) {
+            try {
+                // 此处可添加业务逻辑（如定时任务、消息分发）
+                Thread.sleep(THREAD_SLEEP_INTERVAL);
+            } catch (InterruptedException e) {
+                LogUtils.e(TAG, "run: 线程休眠被中断", e);
+                // 恢复线程中断状态
+                Thread.currentThread().interrupt();
+            }
+        }
+
+        // 线程退出清理
+        mIsStarted = false;
+        mContextWeakRef.clear();
+        mHandlerWeakRef.clear();
+        sInstance = null;
+        LogUtils.i(TAG, "run: 线程正常退出");
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/AppGoToSettingsUtil.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/AppGoToSettingsUtil.java
new file mode 100644
index 0000000..839b342
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/AppGoToSettingsUtil.java
@@ -0,0 +1,268 @@
+package cc.winboll.studio.contacts.utils;
+
+import android.app.Activity;
+import android.content.ComponentName;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.Settings;
+
+import cc.winboll.studio.contacts.MainActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/27 14:27
+ * @Describe 应用权限设置页跳转工具类，适配主流手机厂商的权限页路径，跳转失败时降级到应用详情页
+ */
+public class AppGoToSettingsUtil {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "AppGoToSettingsUtil";
+    // 跳转设置页的 Activity 结果码，复用 MainActivity 的请求码
+    public static final int ACTIVITY_RESULT_APP_SETTINGS = MainActivity.REQUEST_APP_SETTINGS;
+
+    // 主流手机厂商品牌常量
+    private static final String MANUFACTURER_HUAWEI = "Huawei";
+    private static final String MANUFACTURER_MEIZU = "Meizu";
+    private static final String MANUFACTURER_XIAOMI = "Xiaomi";
+    private static final String MANUFACTURER_SONY = "Sony";
+    private static final String MANUFACTURER_OPPO = "OPPO";
+    private static final String MANUFACTURER_LG = "LG";
+    private static final String MANUFACTURER_VIVO = "vivo";
+    private static final String MANUFACTURER_SAMSUNG = "samsung";
+    private static final String MANUFACTURER_LETV = "Letv";
+    private static final String MANUFACTURER_ZTE = "ZTE";
+    private static final String MANUFACTURER_YULONG = "YuLong";
+    private static final String MANUFACTURER_LENOVO = "LENOVO";
+
+    // ====================== 成员变量区 ======================
+    // 标记当前跳转的是应用详情页(true)还是厂商权限页(false)
+    public static boolean isAppSettingOpen = false;
+
+    // ====================== 核心跳转方法区 ======================
+    /**
+     * 跳转到对应品牌手机的系统权限设置页，跳转失败则降级到应用详情页
+     * @param activity 上下文 Activity
+     */
+    public static void goToSetting(Activity activity) {
+        // 空值校验，避免空指针异常
+        if (activity == null) {
+            LogUtils.e(TAG, "goToSetting: Activity 为 null，无法跳转设置页");
+            return;
+        }
+
+        String manufacturer = Build.MANUFACTURER;
+        LogUtils.d(TAG, "goToSetting: 当前设备厂商 | " + manufacturer);
+
+        // 根据厂商跳转对应权限页
+        switch (manufacturer) {
+            case MANUFACTURER_HUAWEI:
+                gotoHuaweiSetting(activity);
+                break;
+            case MANUFACTURER_MEIZU:
+                gotoMeizuSetting(activity);
+                break;
+            case MANUFACTURER_XIAOMI:
+                gotoXiaomiSetting(activity);
+                break;
+            case MANUFACTURER_SONY:
+                gotoSonySetting(activity);
+                break;
+            case MANUFACTURER_OPPO:
+                gotoOppoSetting(activity);
+                break;
+            case MANUFACTURER_LG:
+                gotoLgSetting(activity);
+                break;
+            case MANUFACTURER_LETV:
+                gotoLetvSetting(activity);
+                break;
+            default:
+                LogUtils.w(TAG, "goToSetting: 未适配当前厂商，跳转应用详情页");
+                openAppDetailSetting(activity);
+                break;
+        }
+    }
+
+    // ====================== 各厂商权限页跳转方法区 ======================
+    /**
+     * 跳转华为手机权限设置页
+     */
+    private static void gotoHuaweiSetting(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            intent.setComponent(new ComponentName("com.huawei.systemmanager",
+												  "com.huawei.permissionmanager.ui.MainActivity"));
+            activity.startActivityForResult(intent, ACTIVITY_RESULT_APP_SETTINGS);
+            isAppSettingOpen = false;
+            LogUtils.d(TAG, "gotoHuaweiSetting: 跳转华为权限设置页成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "gotoHuaweiSetting: 跳转失败，降级到应用详情页", e);
+            openAppDetailSetting(activity);
+        }
+    }
+
+    /**
+     * 跳转魅族手机权限设置页
+     */
+    private static void gotoMeizuSetting(Activity activity) {
+        try {
+            Intent intent = new Intent("com.meizu.safe.security.SHOW_APPSEC");
+            intent.addCategory(Intent.CATEGORY_DEFAULT);
+            intent.putExtra("packageName", activity.getPackageName());
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+            LogUtils.d(TAG, "gotoMeizuSetting: 跳转魅族权限设置页成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "gotoMeizuSetting: 跳转失败，降级到应用详情页", e);
+            openAppDetailSetting(activity);
+        }
+    }
+
+    /**
+     * 跳转小米手机权限设置页
+     */
+    private static void gotoXiaomiSetting(Activity activity) {
+        try {
+            // 适配 MIUI 8/9 及以上版本
+            Intent intent = new Intent("miui.intent.action.APP_PERM_EDITOR");
+            intent.setClassName("com.miui.securitycenter",
+								"com.miui.permcenter.permissions.PermissionsEditorActivity");
+            intent.putExtra("extra_pkgname", activity.getPackageName());
+            activity.startActivityForResult(intent, ACTIVITY_RESULT_APP_SETTINGS);
+            isAppSettingOpen = false;
+            LogUtils.d(TAG, "gotoXiaomiSetting: 跳转小米权限设置页(MIUI8+)成功");
+        } catch (Exception e) {
+            try {
+                // 适配 MIUI 5/6/7 版本
+                Intent intent = new Intent("miui.intent.action.APP_PERM_EDITOR");
+                intent.setClassName("com.miui.securitycenter",
+									"com.miui.permcenter.permissions.AppPermissionsEditorActivity");
+                intent.putExtra("extra_pkgname", activity.getPackageName());
+                activity.startActivityForResult(intent, ACTIVITY_RESULT_APP_SETTINGS);
+                isAppSettingOpen = false;
+                LogUtils.d(TAG, "gotoXiaomiSetting: 跳转小米权限设置页(MIUI5-7)成功");
+            } catch (Exception e1) {
+                LogUtils.e(TAG, "gotoXiaomiSetting: 所有版本适配失败，降级到应用详情页", e1);
+                openAppDetailSetting(activity);
+            }
+        }
+    }
+
+    /**
+     * 跳转索尼手机权限设置页
+     */
+    private static void gotoSonySetting(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            intent.setComponent(new ComponentName("com.sonymobile.cta",
+												  "com.sonymobile.cta.SomcCTAMainActivity"));
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+            LogUtils.d(TAG, "gotoSonySetting: 跳转索尼权限设置页成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "gotoSonySetting: 跳转失败，降级到应用详情页", e);
+            openAppDetailSetting(activity);
+        }
+    }
+
+    /**
+     * 跳转OPPO手机权限设置页
+     */
+    private static void gotoOppoSetting(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            intent.setComponent(new ComponentName("com.color.safecenter",
+												  "com.color.safecenter.permission.PermissionManagerActivity"));
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+            LogUtils.d(TAG, "gotoOppoSetting: 跳转OPPO权限设置页成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "gotoOppoSetting: 跳转失败，降级到应用详情页", e);
+            openAppDetailSetting(activity);
+        }
+    }
+
+    /**
+     * 跳转LG手机权限设置页
+     */
+    private static void gotoLgSetting(Activity activity) {
+        try {
+            Intent intent = new Intent("android.intent.action.MAIN");
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            intent.setComponent(new ComponentName("com.android.settings",
+												  "com.android.settings.Settings$AccessLockSummaryActivity"));
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+            LogUtils.d(TAG, "gotoLgSetting: 跳转LG权限设置页成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "gotoLgSetting: 跳转失败，降级到应用详情页", e);
+            openAppDetailSetting(activity);
+        }
+    }
+
+    /**
+     * 跳转乐视手机权限设置页
+     */
+    private static void gotoLetvSetting(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            intent.setComponent(new ComponentName("com.letv.android.letvsafe",
+												  "com.letv.android.letvsafe.PermissionAndApps"));
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+            LogUtils.d(TAG, "gotoLetvSetting: 跳转乐视权限设置页成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "gotoLetvSetting: 跳转失败，降级到应用详情页", e);
+            openAppDetailSetting(activity);
+        }
+    }
+
+    // ====================== 降级跳转方法区 ======================
+    /**
+     * 跳转系统设置主界面
+     */
+    public static void gotoSystemConfig(Activity activity) {
+        if (activity == null) {
+            LogUtils.e(TAG, "gotoSystemConfig: Activity 为 null，无法跳转");
+            return;
+        }
+        Intent intent = new Intent(Settings.ACTION_SETTINGS);
+        activity.startActivity(intent);
+        LogUtils.d(TAG, "gotoSystemConfig: 跳转系统设置主界面成功");
+    }
+
+    /**
+     * 获取应用详情页的 Intent
+     */
+    private static Intent getAppDetailSettingIntent(Activity activity) {
+        Intent intent = new Intent();
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        intent.setAction("android.settings.APPLICATION_DETAILS_SETTINGS");
+        intent.setData(Uri.fromParts("package", activity.getPackageName(), null));
+        return intent;
+    }
+
+    /**
+     * 打开应用详情设置页
+     */
+    public static void openAppDetailSetting(Activity activity) {
+        if (activity == null) {
+            LogUtils.e(TAG, "openAppDetailSetting: Activity 为 null，无法跳转");
+            return;
+        }
+        activity.startActivityForResult(getAppDetailSettingIntent(activity), ACTIVITY_RESULT_APP_SETTINGS);
+        isAppSettingOpen = true;
+        LogUtils.d(TAG, "openAppDetailSetting: 跳转应用详情设置页成功");
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/ContactUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/ContactUtils.java
new file mode 100644
index 0000000..9d2fc6c
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/ContactUtils.java
@@ -0,0 +1,351 @@
+package cc.winboll.studio.contacts.utils;
+
+import android.content.ContentResolver;
+import android.content.ContentUris;
+import android.content.Context;
+import android.content.Intent;
+import android.database.Cursor;
+import android.net.Uri;
+import android.provider.ContactsContract;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/08/30 14:32
+ * @Describe 联系人工具集：提供联系人查询、添加、编辑、号码格式化等功能，适配主流机型
+ */
+public class ContactUtils {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "ContactUtils";
+    // 手机号正则（11位中国大陆手机号）
+    private static final String REGEX_CHINA_MOBILE = "^1[0-9]{10}$";
+
+    // ====================== 单例与成员变量区 ======================
+    // 单例实例（volatile 保证多线程可见性）
+    private static volatile ContactUtils sInstance;
+    // 上下文（弱引用避免内存泄漏，Java7 兼容）
+    private final Context mContext;
+    // 缓存联系人：key=纯数字号码，value=联系人姓名
+    private final Map<String, String> mContactMap = new HashMap<>();
+
+    // ====================== 单例构造区 ======================
+    /**
+     * 私有构造器：初始化上下文并加载联系人
+     */
+    private ContactUtils(Context context) {
+        // 传入应用上下文，避免Activity上下文泄漏
+        this.mContext = context.getApplicationContext();
+        LogUtils.d(TAG, "ContactUtils 初始化，开始加载联系人");
+        reloadContacts();
+    }
+
+    /**
+     * 获取单例实例（双重校验锁，Java7 安全）
+     */
+    public static ContactUtils getInstance(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "getInstance: 上下文为null，无法创建实例");
+            throw new IllegalArgumentException("Context cannot be null");
+        }
+        if (sInstance == null) {
+            synchronized (ContactUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new ContactUtils(context);
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    // ====================== 联系人缓存与查询区 ======================
+    /**
+     * 重新加载联系人到缓存
+     */
+    public void reloadContacts() {
+        LogUtils.d(TAG, "reloadContacts: 开始刷新联系人缓存");
+        mContactMap.clear();
+        readContactsFromSystem();
+        LogUtils.d(TAG, "reloadContacts: 联系人缓存刷新完成，共缓存 " + mContactMap.size() + " 个联系人");
+    }
+
+    /**
+     * 从系统通讯录读取所有联系人（核心方法）
+     */
+    private void readContactsFromSystem() {
+        ContentResolver resolver = mContext.getContentResolver();
+        // 只查询姓名和号码字段，减少IO开销
+        String[] projection = {
+			ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,
+			ContactsContract.CommonDataKinds.Phone.NUMBER
+        };
+
+        Cursor cursor = null;
+        try {
+            cursor = resolver.query(
+				ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
+				projection,
+				null,
+				null,
+				null
+            );
+
+            if (cursor == null) {
+                LogUtils.w(TAG, "readContactsFromSystem: 通讯录查询Cursor为null，可能缺少权限");
+                return;
+            }
+
+            while (cursor.moveToNext()) {
+                String name = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
+                String phone = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
+
+                if (phone != null) {
+                    String simplePhone = formatToSimplePhoneNumber(phone);
+                    mContactMap.put(simplePhone, name != null ? name : "[UnknownName]");
+                    LogUtils.v(TAG, "readContactsFromSystem: 缓存联系人 - 号码：" + simplePhone + "，姓名：" + name);
+                }
+            }
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, "readContactsFromSystem: 读取通讯录失败，缺少 READ_CONTACTS 权限", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "readContactsFromSystem: 读取通讯录异常", e);
+        } finally {
+            if (cursor != null) {
+                cursor.close(); // 确保游标关闭，避免内存泄漏
+            }
+        }
+    }
+
+    /**
+     * 从缓存中获取联系人姓名
+     */
+    public String getContactName(String phone) {
+        if (phone == null) {
+            LogUtils.w(TAG, "getContactName: 输入号码为null");
+            return "[NotInContacts]";
+        }
+        String simplePhone = formatToSimplePhoneNumber(phone);
+        String name = mContactMap.get(simplePhone);
+        LogUtils.d(TAG, "getContactName: 查询号码 " + simplePhone + "，姓名：" + (name == null ? "[NotInContacts]" : name));
+        return name == null ? "[NotInContacts]" : name;
+    }
+
+    // ====================== 号码格式化工具区 ======================
+    /**
+     * 格式化号码为纯数字（去除所有非数字字符）
+     */
+    public static String formatToSimplePhoneNumber(String number) {
+        if (number == null || number.isEmpty()) {
+            LogUtils.w(TAG, "formatToSimplePhoneNumber: 输入号码为空");
+            return "";
+        }
+        String simpleNumber = number.replaceAll("[^0-9]", "");
+        LogUtils.v(TAG, "formatToSimplePhoneNumber: 原号码 " + number + " → 纯数字号码 " + simpleNumber);
+        return simpleNumber;
+    }
+
+    /**
+     * 格式化11位手机号为带空格格式（如：138 0000 1234）
+     */
+    public static String formatToSpacePhoneNumber(String simpleNumber) {
+        if (simpleNumber == null || !simpleNumber.matches(REGEX_CHINA_MOBILE)) {
+            LogUtils.v(TAG, "formatToSpacePhoneNumber: 号码不符合11位手机号格式，无需格式化");
+            return simpleNumber;
+        }
+
+        StringBuilder sb = new StringBuilder();
+        sb.append(simpleNumber.substring(0, 3))
+			.append(" ")
+			.append(simpleNumber.substring(3, 7))
+			.append(" ")
+			.append(simpleNumber.substring(7, 11));
+
+        String formatted = sb.toString();
+        LogUtils.v(TAG, "formatToSpacePhoneNumber: 纯数字号码 " + simpleNumber + " → 带空格号码 " + formatted);
+        return formatted;
+    }
+
+    // ====================== 联系人查询（直接查系统，不走缓存）区 ======================
+    /**
+     * 直接查询系统通讯录获取联系人姓名（按原始号码匹配）
+     */
+    public static String getDisplayNameByPhone(Context context, String phoneNumber) {
+        if (context == null || phoneNumber == null) {
+            LogUtils.w(TAG, "getDisplayNameByPhone: 上下文或号码为空");
+            return null;
+        }
+
+        ContentResolver resolver = context.getContentResolver();
+        String[] projection = {ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME};
+        Cursor cursor = null;
+        String displayName = null;
+
+        try {
+            cursor = resolver.query(
+				ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
+				projection,
+				ContactsContract.CommonDataKinds.Phone.NUMBER + "=?",
+				new String[]{phoneNumber},
+				null
+            );
+
+            if (cursor != null && cursor.moveToFirst()) {
+                displayName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
+            }
+            LogUtils.d(TAG, "getDisplayNameByPhone: 按原始号码 " + phoneNumber + " 查询，姓名：" + displayName);
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, "getDisplayNameByPhone: 缺少 READ_CONTACTS 权限", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getDisplayNameByPhone: 查询异常", e);
+        } finally {
+            if (cursor != null) {
+                cursor.close();
+            }
+        }
+        return displayName;
+    }
+
+    /**
+     * 直接查询系统通讯录获取联系人姓名（按纯数字号码匹配）
+     */
+    public static String getDisplayNameByPhoneSimple(Context context, String phoneNumber) {
+        if (phoneNumber == null) {
+            LogUtils.w(TAG, "getDisplayNameByPhoneSimple: 输入号码为null");
+            return null;
+        }
+        String simplePhone = formatToSimplePhoneNumber(phoneNumber);
+        LogUtils.d(TAG, "getDisplayNameByPhoneSimple: 按纯数字号码 " + simplePhone + " 查询");
+        return getDisplayNameByPhone(context, simplePhone);
+    }
+
+    /**
+     * 判断号码是否在系统通讯录中
+     */
+    public static boolean isPhoneInContacts(Context context, String phoneNumber) {
+        if (context == null || phoneNumber == null) {
+            LogUtils.w(TAG, "isPhoneInContacts: 上下文或号码为空");
+            return false;
+        }
+
+        String simplePhone = formatToSimplePhoneNumber(phoneNumber);
+        String displayName = getDisplayNameByPhone(context, simplePhone);
+
+        if (displayName == null) {
+            LogUtils.d(TAG, "isPhoneInContacts: 号码 " + simplePhone + " 未找到联系人（纯数字匹配）");
+            String spacePhone = formatToSpacePhoneNumber(simplePhone);
+            displayName = getDisplayNameByPhone(context, spacePhone);
+            if (displayName == null) {
+                LogUtils.d(TAG, "isPhoneInContacts: 号码 " + spacePhone + " 未找到联系人（带空格匹配）");
+                return false;
+            }
+        }
+
+        LogUtils.d(TAG, "isPhoneInContacts: 号码 " + simplePhone + " 已在联系人中，姓名：" + displayName);
+        return true;
+    }
+
+    /**
+     * 通过电话号码查询联系人ID（适配定制机型）
+     */
+    public static Long getContactIdByPhone(Context context, String phoneNumber) {
+        if (context == null || phoneNumber == null || phoneNumber.isEmpty()) {
+            LogUtils.w(TAG, "getContactIdByPhone: 上下文或号码为空");
+            return -1L;
+        }
+
+        ContentResolver resolver = context.getContentResolver();
+        Uri queryUri = Uri.withAppendedPath(ContactsContract.CommonDataKinds.Phone.CONTENT_FILTER_URI, Uri.encode(phoneNumber));
+        String[] projection = {ContactsContract.CommonDataKinds.Phone.CONTACT_ID};
+        Cursor cursor = null;
+        Long contactId = -1L;
+
+        try {
+            cursor = resolver.query(queryUri, projection, null, null, null);
+            if (cursor != null && cursor.moveToFirst()) {
+                contactId = cursor.getLong(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.CONTACT_ID));
+            }
+            LogUtils.d(TAG, "getContactIdByPhone: 号码 " + phoneNumber + " 对应的联系人ID：" + contactId);
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, "getContactIdByPhone: 缺少 READ_CONTACTS 权限", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getContactIdByPhone: 查询异常", e);
+        } finally {
+            if (cursor != null) {
+                cursor.close();
+            }
+        }
+        return contactId;
+    }
+
+    // ====================== 联系人跳转工具区 ======================
+    /**
+     * 跳转至系统添加联系人界面
+     * @param context 上下文
+     * @param phoneNumber 预填号码（可为null）
+     */
+    public static void jumpToAddContact(Context context, String phoneNumber) {
+        if (context == null) {
+            LogUtils.e(TAG, "jumpToAddContact: 上下文为null");
+            return;
+        }
+
+        Intent intent = new Intent(Intent.ACTION_INSERT);
+        intent.setType("vnd.android.cursor.dir/person");
+        if (phoneNumber != null) {
+            intent.putExtra(ContactsContract.Intents.Insert.PHONE, phoneNumber);
+            LogUtils.d(TAG, "jumpToAddContact: 跳转添加联系人，预填号码：" + phoneNumber);
+        } else {
+            LogUtils.d(TAG, "jumpToAddContact: 跳转添加联系人，无预填号码");
+        }
+
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); // 支持非Activity上下文调用
+        context.startActivity(intent);
+    }
+
+    /**
+     * 跳转至系统编辑联系人界面（适配小米等定制机型）
+     * @param context 上下文
+     * @param phoneNumber 待编辑号码（必传）
+     * @param contactId 联系人ID（可选，优先使用）
+     */
+    public static void jumpToEditContact(Context context, String phoneNumber, Long contactId) {
+        if (context == null) {
+            LogUtils.e(TAG, "jumpToEditContact: 上下文为null");
+            return;
+        }
+
+        // 校验必要参数
+        if (contactId == null || contactId <= 0) {
+            if (phoneNumber == null || phoneNumber.isEmpty()) {
+                LogUtils.e(TAG, "jumpToEditContact: 联系人ID和号码均为空，无法编辑");
+                return;
+            }
+        }
+
+        Intent intent = new Intent(Intent.ACTION_EDIT);
+        intent.setType(ContactsContract.Contacts.CONTENT_ITEM_TYPE);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+
+        // 优先通过ID定位（精准）
+        if (contactId != null && contactId > 0) {
+            Uri contactUri = ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI, contactId);
+            intent.setData(contactUri);
+            LogUtils.d(TAG, "jumpToEditContact: 通过ID " + contactId + " 定位联系人，准备编辑");
+        } else {
+            // 通过号码定位
+            Uri phoneUri = Uri.withAppendedPath(ContactsContract.CommonDataKinds.Phone.CONTENT_FILTER_URI, Uri.encode(phoneNumber));
+            intent.setData(phoneUri);
+            LogUtils.d(TAG, "jumpToEditContact: 通过号码 " + phoneNumber + " 定位联系人，准备编辑");
+        }
+
+        // 预填最新号码
+        if (phoneNumber != null && !phoneNumber.isEmpty()) {
+            intent.putExtra(ContactsContract.CommonDataKinds.Phone.NUMBER, phoneNumber);
+            intent.putExtra(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE);
+        }
+
+        context.startActivity(intent);
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/EditTextIntUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/EditTextIntUtils.java
new file mode 100644
index 0000000..b0a44d5
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/EditTextIntUtils.java
@@ -0,0 +1,51 @@
+package cc.winboll.studio.contacts.utils;
+
+import android.widget.EditText;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/04/13 00:59:13
+ * @Describe Int类型数字输入框工具集：安全读取 EditText 中的整数内容
+ */
+public class EditTextIntUtils {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "EditTextIntUtils";
+    // 默认返回值：读取失败时返回
+    private static final int DEFAULT_INT_VALUE = 0;
+
+    // ====================== 工具方法区 ======================
+    /**
+     * 从 EditText 中安全读取整数
+     * @param editText 目标输入框
+     * @return 输入框中的整数，读取失败返回 0
+     */
+    public static int getIntFromEditText(EditText editText) {
+        // 空值校验：防止 EditText 为 null 导致空指针
+        if (editText == null) {
+            LogUtils.w(TAG, "getIntFromEditText: EditText 实例为 null，返回默认值 " + DEFAULT_INT_VALUE);
+            return DEFAULT_INT_VALUE;
+        }
+
+        // 获取并去除首尾空格
+        String inputStr = editText.getText().toString().trim();
+        LogUtils.d(TAG, "getIntFromEditText: 输入框原始内容 | " + inputStr);
+
+        // 校验空字符串
+        if (inputStr.isEmpty()) {
+            LogUtils.w(TAG, "getIntFromEditText: 输入框内容为空，返回默认值 " + DEFAULT_INT_VALUE);
+            return DEFAULT_INT_VALUE;
+        }
+
+        // 安全转换整数，捕获格式异常
+        try {
+            int result = Integer.parseInt(inputStr);
+            LogUtils.d(TAG, "getIntFromEditText: 转换成功 | 结果=" + result);
+            return result;
+        } catch (NumberFormatException e) {
+            LogUtils.e(TAG, "getIntFromEditText: 内容不是有效整数 | 输入内容=" + inputStr, e);
+            return DEFAULT_INT_VALUE;
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/IntUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/IntUtils.java
new file mode 100644
index 0000000..a5564c8
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/IntUtils.java
@@ -0,0 +1,64 @@
+package cc.winboll.studio.contacts.utils;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/04/13 01:16:28
+ * @Describe Int数字操作工具集：提供整数范围限制、数值边界校准功能
+ */
+public class IntUtils {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "IntUtils";
+
+    // ====================== 核心工具方法区 ======================
+    /**
+     * 将整数限制在指定区间内，自动校准超出边界的数值
+     * @param origin  原始整数
+     * @param range_a 区间端点1（无需区分大小）
+     * @param range_b 区间端点2（无需区分大小）
+     * @return 校准后的整数，结果始终在 [min(range_a,range_b), max(range_a,range_b)] 内
+     */
+    public static int getIntInRange(int origin, int range_a, int range_b) {
+        int min = Math.min(range_a, range_b);
+        int max = Math.max(range_a, range_b);
+        int res = Math.min(origin, max);
+        res = Math.max(res, min);
+
+        // 打印调试日志，记录参数与计算结果
+        LogUtils.d(TAG, String.format("getIntInRange: 原始值=%d, 区间=[%d,%d], 校准后=%d",
+									  origin, min, max, res));
+        return res;
+    }
+
+    // ====================== 单元测试方法区 ======================
+    /**
+     * 单元测试：验证 getIntInRange 方法在不同场景下的正确性
+     */
+    public static void unittest_getIntInRange() {
+        LogUtils.i(TAG, "unittest_getIntInRange: 开始执行单元测试");
+
+        // 正数区间测试
+        LogUtils.d(TAG, String.format("测试1: getIntInRange(-100, 5, 10) = %d", getIntInRange(-100, 5, 10)));
+        LogUtils.d(TAG, String.format("测试2: getIntInRange(8, 5, 10) = %d", getIntInRange(8, 5, 10)));
+        LogUtils.d(TAG, String.format("测试3: getIntInRange(200, 5, 10) = %d", getIntInRange(200, 5, 10)));
+
+        // 跨正负区间测试
+        LogUtils.d(TAG, String.format("测试4: getIntInRange(-100, -5, 10) = %d", getIntInRange(-100, -5, 10)));
+        LogUtils.d(TAG, String.format("测试5: getIntInRange(9, -5, 10) = %d", getIntInRange(9, -5, 10)));
+        LogUtils.d(TAG, String.format("测试6: getIntInRange(100, -5, 10) = %d", getIntInRange(100, -5, 10)));
+
+        // 端点顺序颠倒测试
+        LogUtils.d(TAG, String.format("测试7: getIntInRange(500, 5, -10) = %d", getIntInRange(500, 5, -10)));
+        LogUtils.d(TAG, String.format("测试8: getIntInRange(4, 5, -10) = %d", getIntInRange(4, 5, -10)));
+        LogUtils.d(TAG, String.format("测试9: getIntInRange(-20, 5, -10) = %d", getIntInRange(-20, 5, -10)));
+
+        // 大数区间测试
+        LogUtils.d(TAG, String.format("测试10: getIntInRange(500, 50, 10) = %d", getIntInRange(500, 50, 10)));
+        LogUtils.d(TAG, String.format("测试11: getIntInRange(30, 50, 10) = %d", getIntInRange(30, 50, 10)));
+        LogUtils.d(TAG, String.format("测试12: getIntInRange(6, 50, 10) = %d", getIntInRange(6, 50, 10)));
+
+        LogUtils.i(TAG, "unittest_getIntInRange: 单元测试执行完毕");
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/NotificationManagerUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/NotificationManagerUtils.java
new file mode 100644
index 0000000..1cc3bae
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/NotificationManagerUtils.java
@@ -0,0 +1,505 @@
+package cc.winboll.studio.contacts.utils;
+
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.content.SharedPreferences;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.media.RingtoneManager;
+import android.os.Build;
+import android.provider.Settings;
+
+import cc.winboll.studio.contacts.MainActivity;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * 通知工具类：统一管理前台服务/临时通知
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025/12/14 21:01:00
+ * @LastEditTime 2026/01/07 22:00:00
+ * @Describe 适配API30，支持拨号服务前台保活通知、临时通知提醒，提供通知的创建、更新、取消功能；支持通知版本管理，版本变更时自动清理旧渠道
+ */
+public class NotificationManagerUtils {
+    // ================================== 静态常量（置顶统一管理，杜绝魔法值）=================================
+    public static final String TAG = "NotificationManagerUtils";
+    // ********** 新增：通知版本管理常量 **********
+    /** 通知版本标识（源码标记版本，变更时会清理旧渠道） */
+    public static final String NOTIFICATION_VERSION = "v1.0.3";
+    /** SP存储键：已保存的通知版本 */
+    private static final String SP_KEY_NOTIFICATION_VERSION = "sp_key_notification_version";
+    /** SP文件名 */
+    private static final String SP_NAME_NOTIFICATION = "sp_notification_manager";
+    // ******************************************
+    // 通知渠道ID（API26+ 必需，区分通知类型）
+    public static final String CHANNEL_ID_FOREGROUND = "cc.winboll.studio.contacts.channel.foreground";
+    public static final String CHANNEL_ID_TEMPORARY = "cc.winboll.studio.contacts.channel.temporary";
+    // 通知ID（唯一标识，避免重复）
+    public static final int NOTIFY_ID_FOREGROUND_SERVICE = 1001;
+    public static final int NOTIFY_ID_TEMPORARY = 1002;
+    // 低版本兼容：默认通知图标（API<21 避免显示异常）
+    private static final int NOTIFICATION_DEFAULT_ICON = R.drawable.ic_launcher;
+    // 通知内容兜底常量
+    private static final String FOREGROUND_NOTIFY_TITLE_DEFAULT = "拨号服务前台通知";
+    private static final String FOREGROUND_NOTIFY_CONTENT_DEFAULT = "前台通知内容";
+    private static final String TEMPORARY_NOTIFY_TITLE_DEFAULT = "拨号服务临时通知";
+    private static final String TEMPORARY_NOTIFY_CONTENT_DEFAULT = "临时通知内容";
+    // PendingIntent请求码
+    private static final int PENDING_INTENT_REQUEST_CODE_FOREGROUND = 0;
+    private static final int PENDING_INTENT_REQUEST_CODE_TEMPORARY = 1;
+    // 消息通知自增ID（起始值）
+    private static int snMessageNotificationID = 10000;
+
+    // ================================== 成员变量（私有封装，按依赖优先级排序）=================================
+    // 核心上下文（应用级，避免内存泄漏）
+    private Context mContext;
+    // 系统通知服务（核心依赖）
+    private NotificationManager mNotificationManager;
+    // 前台服务通知实例（单独持有，便于更新/取消）
+    private Notification mForegroundServiceNotify;
+    // ********** 新增：SP实例（用于版本存储） **********
+    private SharedPreferences mSp;
+
+    // ================================== 构造方法（初始化核心资源，前置校验）=================================
+    public NotificationManagerUtils(Context context) {
+        LogUtils.d(TAG, "NotificationManagerUtils() 构造方法调用 | context=" + context);
+        // 前置校验：Context非空
+        if (context == null) {
+            LogUtils.e(TAG, "NotificationManagerUtils() 构造失败：context is null");
+            return;
+        }
+        // 初始化核心资源
+        this.mContext = context.getApplicationContext();
+        this.mNotificationManager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
+        // ********** 新增：初始化SP **********
+        this.mSp = mContext.getSharedPreferences(SP_NAME_NOTIFICATION, Context.MODE_PRIVATE);
+        LogUtils.d(TAG, "NotificationManagerUtils() 核心资源初始化完成 | mContext=" + mContext + " | mNotificationManager=" + mNotificationManager + " | mSp=" + mSp);
+
+        // ********** 新增：版本检查与旧渠道清理 **********
+        checkNotificationVersionAndCleanOldChannels();
+
+        // 初始化通知渠道（API26+ 必需）
+        initNotificationChannels();
+        LogUtils.d(TAG, "NotificationManagerUtils() 构造完成");
+    }
+
+    // ================================== 新增核心方法：通知版本检查与旧渠道清理 =================================
+    /**
+     * 检查当前通知版本与SP中保存的版本是否一致
+     * 若不一致，清理所有旧通知渠道，并更新SP中的版本记录
+     */
+    private void checkNotificationVersionAndCleanOldChannels() {
+        LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 方法调用 | 源码版本=" + NOTIFICATION_VERSION + " | SP版本=" + getSavedNotificationVersion());
+        // 1. 版本一致，无需处理
+        if (NOTIFICATION_VERSION.equals(getSavedNotificationVersion())) {
+            LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 版本一致，无需清理渠道");
+            return;
+        }
+
+        // 2. 版本不一致，清理所有旧渠道
+        LogUtils.w(TAG, "checkNotificationVersionAndCleanOldChannels() 版本不一致，开始清理所有旧通知渠道");
+        cleanAllNotificationChannels();
+
+        // 3. 取消所有旧通知
+        cancelAllNotifications();
+        LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 已取消所有旧通知");
+
+        // 4. 更新SP中的版本记录
+        saveNotificationVersion(NOTIFICATION_VERSION);
+        LogUtils.d(TAG, "checkNotificationVersionAndCleanOldChannels() 已更新SP版本记录为：" + NOTIFICATION_VERSION);
+    }
+
+    /**
+     * 从SP中获取已保存的通知版本
+     * @return 已保存的版本号，无则返回空字符串
+     */
+    private String getSavedNotificationVersion() {
+        return mSp.getString(SP_KEY_NOTIFICATION_VERSION, "");
+    }
+
+    /**
+     * 将当前通知版本保存到SP
+     * @param version 要保存的版本号
+     */
+    private void saveNotificationVersion(String version) {
+        mSp.edit().putString(SP_KEY_NOTIFICATION_VERSION, version).commit();
+    }
+
+    /**
+     * 清理所有已创建的通知渠道（API26+ 有效）
+     */
+    private void cleanAllNotificationChannels() {
+        LogUtils.d(TAG, "cleanAllNotificationChannels() 方法调用");
+        // API<26 无渠道机制，直接返回
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O || mNotificationManager == null) {
+            LogUtils.d(TAG, "cleanAllNotificationChannels() API<26 或 NotificationManager为空，无需清理");
+            return;
+        }
+
+        // 遍历所有渠道并删除
+        for (NotificationChannel channel : mNotificationManager.getNotificationChannels()) {
+            LogUtils.d(TAG, "cleanAllNotificationChannels() 正在删除渠道：" + channel.getId() + " | " + channel.getName());
+            mNotificationManager.deleteNotificationChannel(channel.getId());
+        }
+        LogUtils.d(TAG, "cleanAllNotificationChannels() 所有旧渠道清理完成");
+    }
+
+    // ================================== 核心初始化方法（通知渠道，API分级适配）=================================
+    /**
+     * 初始化通知渠道：前台服务渠道（无铃声+无振动）、临时提醒渠道（系统默认铃声+无振动）
+     */
+    private void initNotificationChannels() {
+        LogUtils.d(TAG, "initNotificationChannels() 执行通知渠道初始化");
+        // API<26 无渠道机制，直接返回
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
+            LogUtils.d(TAG, "initNotificationChannels() API<26，无需创建渠道");
+            return;
+        }
+        // 通知服务为空，避免空指针
+        if (mNotificationManager == null) {
+            LogUtils.e(TAG, "initNotificationChannels() 失败：NotificationManager is null");
+            return;
+        }
+
+        // 1. 拨号前台服务渠道（低优先级，后台保活无打扰）
+        NotificationChannel foregroundChannel = new NotificationChannel(
+			CHANNEL_ID_FOREGROUND,
+			"拨号前台服务",
+			NotificationManager.IMPORTANCE_LOW
+        );
+        foregroundChannel.setDescription("拨号前台服务后台运行，无声音、无振动");
+        foregroundChannel.enableLights(false);
+        foregroundChannel.enableVibration(false);
+        foregroundChannel.setSound(null, null); // 强制无铃声
+        foregroundChannel.setShowBadge(false);
+        foregroundChannel.setLockscreenVisibility(Notification.VISIBILITY_SECRET);
+        LogUtils.d(TAG, "initNotificationChannels() 拨号前台服务渠道配置完成");
+
+        // 2. 其他临时通知渠道（中优先级，系统默认铃声，无振动）
+        NotificationChannel temporaryChannel = new NotificationChannel(
+			CHANNEL_ID_TEMPORARY,
+			"临时通知",
+			NotificationManager.IMPORTANCE_DEFAULT
+        );
+        temporaryChannel.setDescription("其他临时通知，系统默认铃声，无振动");
+        temporaryChannel.enableLights(true);
+        temporaryChannel.enableVibration(false);
+        temporaryChannel.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION), Notification.AUDIO_ATTRIBUTES_DEFAULT);
+        temporaryChannel.setShowBadge(false);
+        temporaryChannel.setLockscreenVisibility(Notification.VISIBILITY_PUBLIC);
+        LogUtils.d(TAG, "initNotificationChannels() 其他临时通知渠道配置完成");
+
+        // 注册渠道到系统
+        mNotificationManager.createNotificationChannel(foregroundChannel);
+        mNotificationManager.createNotificationChannel(temporaryChannel);
+        LogUtils.d(TAG, "initNotificationChannels() 成功：创建前台服务+其他临时通知渠道");
+    }
+
+    // ================================== 对外核心方法（前台服务通知：启动/更新/取消）=================================
+    /**
+     * 启动前台服务通知（API30适配，无铃声）
+     * @param service 前台服务实例
+     * @param message 通知内容
+     */
+    public void startForegroundServiceNotify(Service service, String message) {
+        LogUtils.d(TAG, "startForegroundServiceNotify() 方法调用 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE + " | service=" + service + " | message=" + message);
+        // 前置校验：参数非空
+        if (service == null || mNotificationManager == null) {
+            LogUtils.e(TAG, "startForegroundServiceNotify() 失败：param is null | service=" + service + " | mNotificationManager=" + mNotificationManager);
+            return;
+        }
+
+        // 构建前台通知
+        mForegroundServiceNotify = buildForegroundNotification(message);
+        if (mForegroundServiceNotify == null) {
+            LogUtils.e(TAG, "startForegroundServiceNotify() 失败：构建通知为空");
+            return;
+        }
+
+        // 启动前台服务（API30无FOREGROUND_SERVICE_TYPE限制）
+        try {
+            service.startForeground(NOTIFY_ID_FOREGROUND_SERVICE, mForegroundServiceNotify);
+            LogUtils.d(TAG, "startForegroundServiceNotify() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "startForegroundServiceNotify() 异常", e);
+        }
+    }
+
+    /**
+     * 更新前台服务通知内容（复用通知ID，保持无铃声）
+     * @param message 新的通知内容
+     */
+    public void updateForegroundServiceNotify(String message) {
+        LogUtils.d(TAG, "updateForegroundServiceNotify() 方法调用 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE + " | message=" + message);
+        if (mNotificationManager == null) {
+            LogUtils.e(TAG, "updateForegroundServiceNotify() 失败：mNotificationManager is null");
+            return;
+        }
+
+        mForegroundServiceNotify = buildForegroundNotification(message);
+        if (mForegroundServiceNotify == null) {
+            LogUtils.e(TAG, "updateForegroundServiceNotify() 失败：构建通知为空");
+            return;
+        }
+
+        try {
+            mNotificationManager.notify(NOTIFY_ID_FOREGROUND_SERVICE, mForegroundServiceNotify);
+            LogUtils.d(TAG, "updateForegroundServiceNotify() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "updateForegroundServiceNotify() 异常", e);
+        }
+    }
+
+    /**
+     * 取消前台服务通知（Service销毁时调用）
+     */
+    public void cancelForegroundServiceNotify() {
+        LogUtils.d(TAG, "cancelForegroundServiceNotify() 方法调用 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE);
+        cancelNotification(NOTIFY_ID_FOREGROUND_SERVICE);
+        mForegroundServiceNotify = null;
+        LogUtils.d(TAG, "cancelForegroundServiceNotify() 成功");
+    }
+
+    // ================================== 对外核心方法（临时通知：发送）=================================
+    /**
+     * 发送临时通知（自增ID，避免覆盖，系统默认铃声）
+     * @param context 上下文
+     * @param message 通知内容
+     */
+    public synchronized void showTemporaryNotification(Context context, String message) {
+        snMessageNotificationID++;
+        LogUtils.d(TAG, "showTemporaryNotification() 方法调用 | notifyId=" + snMessageNotificationID + " | context=" + context + " | message=" + message);
+        // 前置校验：参数非空
+        if (context == null || mNotificationManager == null) {
+            LogUtils.e(TAG, "showTemporaryNotification() 失败：param is null | context=" + context + " | mNotificationManager=" + mNotificationManager);
+            return;
+        }
+
+        Notification temporaryNotify = buildTemporaryNotification(context, message);
+        if (temporaryNotify == null) {
+            LogUtils.e(TAG, "showTemporaryNotification() 失败：构建通知为空");
+            return;
+        }
+
+        try {
+            mNotificationManager.notify(snMessageNotificationID, temporaryNotify);
+            LogUtils.d(TAG, "showTemporaryNotification() 成功 | notifyId=" + snMessageNotificationID);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "showTemporaryNotification() 异常 | notifyId=" + snMessageNotificationID, e);
+        }
+    }
+
+    // ================================== 对外工具方法（通知取消：单个/全部）=================================
+    /**
+     * 取消指定ID的通知
+     * @param notifyId 通知唯一标识
+     */
+    public void cancelNotification(int notifyId) {
+        LogUtils.d(TAG, "cancelNotification() 方法调用 | notifyId=" + notifyId);
+        if (mNotificationManager == null) {
+            LogUtils.e(TAG, "cancelNotification() 失败：NotificationManager is null");
+            return;
+        }
+        try {
+            mNotificationManager.cancel(notifyId);
+            LogUtils.d(TAG, "cancelNotification() 成功 | notifyId=" + notifyId);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "cancelNotification() 异常 | notifyId=" + notifyId, e);
+        }
+    }
+
+    /**
+     * 取消所有通知（兜底场景使用）
+     */
+    public void cancelAllNotifications() {
+        LogUtils.d(TAG, "cancelAllNotifications() 方法调用");
+        if (mNotificationManager == null) {
+            LogUtils.e(TAG, "cancelAllNotifications() 失败：NotificationManager is null");
+            return;
+        }
+        try {
+            mNotificationManager.cancelAll();
+            LogUtils.d(TAG, "cancelAllNotifications() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "cancelAllNotifications() 异常", e);
+        }
+    }
+
+    // ================================== 内部辅助方法（通知构建：前台服务通知）=================================
+    /**
+     * 构建前台服务通知（全版本无铃声+无振动）
+     * @param message 通知内容
+     * @return 构建完成的前台通知实例
+     */
+    private Notification buildForegroundNotification(String message) {
+        LogUtils.d(TAG, "buildForegroundNotification() 方法调用 | message=" + message);
+        if (mContext == null) {
+            LogUtils.e(TAG, "buildForegroundNotification() 失败：mContext is null");
+            return null;
+        }
+
+        // 内容兜底
+        String title = FOREGROUND_NOTIFY_TITLE_DEFAULT;
+        String content = (message != null && !message.isEmpty()) ? message : FOREGROUND_NOTIFY_CONTENT_DEFAULT;
+        LogUtils.d(TAG, "buildForegroundNotification() 内容兜底完成 | title=" + title + " | content=" + content);
+
+        Notification.Builder builder;
+        // API分级构建
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            builder = new Notification.Builder(mContext, CHANNEL_ID_FOREGROUND);
+            LogUtils.d(TAG, "buildForegroundNotification() 使用API26+渠道构建");
+        } else {
+            builder = new Notification.Builder(mContext);
+            builder.setSound(null);
+            builder.setVibrate(new long[]{0});
+            builder.setDefaults(0);
+            LogUtils.d(TAG, "buildForegroundNotification() 使用API<26手动配置");
+        }
+
+        // 通用配置
+        builder.setSmallIcon(NOTIFICATION_DEFAULT_ICON)
+			.setContentTitle(title)
+			.setContentText(content)
+			.setAutoCancel(false)
+			.setOngoing(true)
+			.setWhen(System.currentTimeMillis())
+			.setContentIntent(createJumpPendingIntent(mContext, PENDING_INTENT_REQUEST_CODE_FOREGROUND));
+
+        // API21+ 新增大图标+主题色
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            builder.setLargeIcon(getAppIcon(mContext))
+				.setColor(mContext.getResources().getColor(R.color.colorPrimary))
+				.setPriority(Notification.PRIORITY_LOW);
+            LogUtils.d(TAG, "buildForegroundNotification() 补充API21+配置");
+        }
+
+        Notification notification = builder.build();
+        LogUtils.d(TAG, "buildForegroundNotification() 成功构建前台通知");
+        return notification;
+    }
+
+    // ================================== 内部辅助方法（通知构建：临时通知）=================================
+    /**
+     * 构建临时通知（全版本系统默认铃声+无振动）
+     * @param context 上下文
+     * @param message 通知内容
+     * @return 构建完成的临时通知实例
+     */
+    private Notification buildTemporaryNotification(Context context, String message) {
+        LogUtils.d(TAG, "buildTemporaryNotification() 方法调用 | context=" + context + " | message=" + message);
+        if (context == null) {
+            LogUtils.e(TAG, "buildTemporaryNotification() 失败：context is null");
+            return null;
+        }
+
+        // 内容兜底
+        String title = TEMPORARY_NOTIFY_TITLE_DEFAULT;
+        String content = (message != null && !message.isEmpty()) ? message : TEMPORARY_NOTIFY_CONTENT_DEFAULT;
+        LogUtils.d(TAG, "buildTemporaryNotification() 内容兜底完成 | title=" + title + " | content=" + content);
+
+        Notification.Builder builder;
+        // API分级构建
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            builder = new Notification.Builder(context, CHANNEL_ID_TEMPORARY);
+            LogUtils.d(TAG, "buildTemporaryNotification() 使用API26+渠道构建");
+        } else {
+            builder = new Notification.Builder(context);
+            builder.setSound(Settings.System.DEFAULT_NOTIFICATION_URI);
+            builder.setVibrate(new long[]{0});
+            builder.setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_SOUND);
+            LogUtils.d(TAG, "buildTemporaryNotification() 使用API<26手动配置");
+        }
+
+        // 通用配置
+        builder.setSmallIcon(NOTIFICATION_DEFAULT_ICON)
+			.setContentTitle(title)
+			.setContentText(content)
+			.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION), Notification.AUDIO_ATTRIBUTES_DEFAULT)
+			.setAutoCancel(true)
+			.setOngoing(false)
+			.setWhen(System.currentTimeMillis())
+			.setContentIntent(createJumpPendingIntent(context, PENDING_INTENT_REQUEST_CODE_TEMPORARY));
+
+        // API21+ 新增大图标+主题色
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            builder.setLargeIcon(getAppIcon(context))
+				.setColor(context.getResources().getColor(R.color.colorPrimary))
+				.setPriority(Notification.PRIORITY_DEFAULT);
+            LogUtils.d(TAG, "buildTemporaryNotification() 补充API21+配置");
+        }
+
+        Notification notification = builder.build();
+        LogUtils.d(TAG, "buildTemporaryNotification() 成功构建临时通知");
+        return notification;
+    }
+
+    // ================================== 内部辅助方法（创建跳转PendingIntent，API30安全适配）=================================
+    /**
+     * 创建跳转MainActivity的PendingIntent，API23+ 添加IMMUTABLE标记
+     * @param context 上下文
+     * @param requestCode 请求码
+     * @return 构建完成的PendingIntent
+     */
+    private PendingIntent createJumpPendingIntent(Context context, int requestCode) {
+        LogUtils.d(TAG, "createJumpPendingIntent() 方法调用 | requestCode=" + requestCode + " | context=" + context);
+        Intent intent = new Intent(context, MainActivity.class);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+        LogUtils.d(TAG, "createJumpPendingIntent() 跳转Intent配置完成");
+
+        // API23+ 必需添加IMMUTABLE，适配API30安全规范
+        int flags = PendingIntent.FLAG_UPDATE_CURRENT;
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+            flags |= PendingIntent.FLAG_IMMUTABLE;
+            LogUtils.d(TAG, "createJumpPendingIntent() 添加FLAG_IMMUTABLE标记（API23+）");
+        }
+
+        PendingIntent pendingIntent = PendingIntent.getActivity(context, requestCode, intent, flags);
+        LogUtils.d(TAG, "createJumpPendingIntent() 成功 | requestCode=" + requestCode);
+        return pendingIntent;
+    }
+
+    // ================================== 内部辅助方法（获取APP图标，异常兜底）=================================
+    /**
+     * 获取APP图标，失败返回默认图标
+     * @param context 上下文
+     * @return APP图标Bitmap实例
+     */
+    private Bitmap getAppIcon(Context context) {
+        LogUtils.d(TAG, "getAppIcon() 方法调用 | context=" + context);
+        try {
+            PackageInfo pkgInfo = context.getPackageManager().getPackageInfo(context.getPackageName(), 0);
+            Bitmap appIcon = BitmapFactory.decodeResource(context.getResources(), pkgInfo.applicationInfo.icon);
+            LogUtils.d(TAG, "getAppIcon() 成功：获取应用图标");
+            return appIcon;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "getAppIcon() 异常：获取应用图标失败，使用默认图标", e);
+            return BitmapFactory.decodeResource(context.getResources(), NOTIFICATION_DEFAULT_ICON);
+        }
+    }
+
+    // ================================== 资源释放方法（避免内存泄漏）=================================
+    /**
+     * 释放资源，销毁时调用
+     */
+    public void release() {
+        LogUtils.d(TAG, "release() 方法调用：执行资源释放");
+        cancelForegroundServiceNotify();
+        mNotificationManager = null;
+        mContext = null;
+        mSp = null; // ********** 新增：释放SP实例 **********
+        LogUtils.d(TAG, "release() 成功：所有资源已释放");
+    }
+
+    // ================================== 对外 getter 方法（仅前台通知实例，只读）=================================
+    public Notification getForegroundServiceNotify() {
+        return mForegroundServiceNotify;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/PermissionUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/PermissionUtils.java
new file mode 100644
index 0000000..6b3e774
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/PermissionUtils.java
@@ -0,0 +1,254 @@
+package cc.winboll.studio.contacts.utils;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.Settings;
+import android.telecom.TelecomManager;
+import androidx.annotation.NonNull;
+import androidx.core.app.ActivityCompat;
+import androidx.fragment.app.Fragment;
+import androidx.fragment.app.FragmentActivity;
+import java.lang.reflect.Method;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/12 16:28
+ * @Describe 敏感权限申请工具类（完全适配 Android API 30 + Java 7 语法）
+ * 修复 ACTION_CHANGE_DEFAULT_CALL_SCREENING_APP / EXTRA_PACKAGE_NAME 未定义问题
+ */
+public class PermissionUtils {
+    public static final String TAG = "PermissionUtils";
+
+    // API 版本硬编码常量（Java 7 兼容，不依赖 Build.VERSION_CODES 高版本字段）
+    private static final int ANDROID_6_API = 23;
+    private static final int ANDROID_10_API = 29;
+    private static final int ANDROID_13_API = 33;
+    private static final int ANDROID_14_API = 34;
+
+    // 硬编码系统常量字符串，解决 API 30 下未定义问题
+    private static final String ACTION_CHANGE_DEFAULT_CALL_SCREENING_APP =
+	"android.telecom.action.CHANGE_DEFAULT_CALL_SCREENING_APP";
+    private static final String EXTRA_PACKAGE_NAME =
+	"android.telecom.extra.PACKAGE_NAME";
+
+    // 基础权限组（严格适配 API 30，移除废弃/不存在的权限）
+    public static final String[] BASE_PERMISSIONS = {
+		android.Manifest.permission.READ_CONTACTS,
+		android.Manifest.permission.WRITE_CONTACTS,
+		android.Manifest.permission.READ_CALL_LOG,
+		android.Manifest.permission.CALL_PHONE,
+		android.Manifest.permission.RECORD_AUDIO,
+		android.Manifest.permission.MODIFY_AUDIO_SETTINGS
+    };
+
+    /**
+     * 获取所有需要申请的权限（Java 7 传统 for 循环，无菱形运算符）
+     */
+    public static String[] getAllNeedPermissions() {
+        List<String> permissions = new ArrayList<String>();
+        // Java 7 传统循环遍历数组
+        for (int i = 0; i < BASE_PERMISSIONS.length; i++) {
+            permissions.add(BASE_PERMISSIONS[i]);
+        }
+        // 显式创建数组并转换，避免 Java 7 泛型转换警告
+        String[] permissionArray = new String[permissions.size()];
+        return permissions.toArray(permissionArray);
+    }
+
+    /**
+     * 检查单个权限是否授予（使用 PackageManager 标准常量）
+     */
+    public static boolean checkPermission(@NonNull Context context, @NonNull String permission) {
+        return ActivityCompat.checkSelfPermission(context, permission) == PackageManager.PERMISSION_GRANTED;
+    }
+
+    /**
+     * 检查权限组是否全部授予（Java 7 传统循环）
+     */
+    public static boolean checkPermissions(@NonNull Context context, @NonNull String[] permissions) {
+        // Java 7 遍历数组，避免增强 for 循环的语法糖问题
+        for (int i = 0; i < permissions.length; i++) {
+            String permission = permissions[i];
+            if (!checkPermission(context, permission)) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * 申请权限组（Activity 中调用，Java 7 兼容）
+     */
+    public static void requestPermissions(@NonNull FragmentActivity activity,
+                                          @NonNull String[] permissions,
+                                          int requestCode) {
+        ActivityCompat.requestPermissions(activity, permissions, requestCode);
+    }
+
+    /**
+     * 申请权限组（Fragment 中调用，Java 7 兼容）
+     */
+    public static void requestPermissions(@NonNull Fragment fragment,
+                                          @NonNull String[] permissions,
+                                          int requestCode) {
+        fragment.requestPermissions(permissions, requestCode);
+    }
+
+    /**
+     * 检查悬浮窗权限（API 30 适配）
+     */
+    public static boolean isOverlayPermissionGranted(@NonNull Context context) {
+        if (Build.VERSION.SDK_INT >= ANDROID_6_API) {
+            return Settings.canDrawOverlays(context);
+        }
+        // 6.0 以下默认授予
+        return true;
+    }
+
+    /**
+     * 申请悬浮窗权限（Java 7 规范，拆分 Intent 创建步骤）
+     */
+    public static void requestOverlayPermission(@NonNull Context context, int requestCode) {
+        if (Build.VERSION.SDK_INT >= ANDROID_6_API && !isOverlayPermissionGranted(context)) {
+            Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION);
+            Uri uri = Uri.parse("package:" + context.getPackageName());
+            intent.setData(uri);
+            if (context instanceof FragmentActivity) {
+                ((FragmentActivity) context).startActivityForResult(intent, requestCode);
+            }
+        }
+    }
+
+    /**
+     * 检查修改系统设置权限（API 30 适配）
+     */
+    public static boolean isWriteSettingsPermissionGranted(@NonNull Context context) {
+        if (Build.VERSION.SDK_INT >= ANDROID_6_API) {
+            return Settings.System.canWrite(context);
+        }
+        // 6.0 以下默认授予
+        return true;
+    }
+
+    /**
+     * 申请修改系统设置权限（Java 7 规范）
+     */
+    public static void requestWriteSettingsPermission(@NonNull Context context, int requestCode) {
+        if (Build.VERSION.SDK_INT >= ANDROID_6_API && !isWriteSettingsPermissionGranted(context)) {
+            Intent intent = new Intent(Settings.ACTION_MANAGE_WRITE_SETTINGS);
+            Uri uri = Uri.parse("package:" + context.getPackageName());
+            intent.setData(uri);
+            if (context instanceof FragmentActivity) {
+                ((FragmentActivity) context).startActivityForResult(intent, requestCode);
+            }
+        }
+    }
+
+    /**
+     * 检查通话筛选权限（适配 API 30，优化反射逻辑 + 异常捕获）
+     */
+    public static boolean isCallScreeningPermissionGranted(@NonNull Context context) {
+        if (Build.VERSION.SDK_INT >= ANDROID_10_API) {
+            TelecomManager telecomManager = (TelecomManager) context.getSystemService(Context.TELECOM_SERVICE);
+            if (telecomManager == null) {
+                return false;
+            }
+            String defaultPackage = null;
+            // 反射调用高版本方法，捕获所有异常避免崩溃（Java 7 必须显式捕获 Exception）
+            try {
+                Method method = TelecomManager.class.getMethod("getDefaultCallScreeningAppPackage");
+                defaultPackage = (String) method.invoke(telecomManager);
+            } catch (NoSuchMethodException e) {
+                // API 30-32 无此方法，返回 false
+                return false;
+            } catch (Exception e) {
+                // 其他反射异常，返回 false
+                return false;
+            }
+            return defaultPackage != null && defaultPackage.equals(context.getPackageName());
+        }
+        // 10.0 以下无此权限，默认返回 true
+        return true;
+    }
+
+    /**
+     * 申请通话筛选权限（完全适配 API 30，解决 ActivityNotFoundException 崩溃）
+     */
+    public static void requestCallScreeningPermission(@NonNull Context context, int requestCode) {
+        if (Build.VERSION.SDK_INT >= ANDROID_10_API && !isCallScreeningPermissionGranted(context)) {
+            FragmentActivity activity = null;
+            if (context instanceof FragmentActivity) {
+                activity = (FragmentActivity) context;
+            }
+            if (activity == null) {
+                return;
+            }
+
+            Intent intent = null;
+            // 版本分级处理：避免高版本 ACTION 失效
+            if (Build.VERSION.SDK_INT >= ANDROID_14_API) {
+                // Android 14+：跳转默认应用设置页
+                intent = new Intent(Settings.ACTION_MANAGE_DEFAULT_APPS_SETTINGS);
+                Uri uri = Uri.parse("package:" + context.getPackageName());
+                intent.setData(uri);
+            } else if (Build.VERSION.SDK_INT >= ANDROID_13_API) {
+                // Android 13：使用硬编码 ACTION
+                intent = new Intent(ACTION_CHANGE_DEFAULT_CALL_SCREENING_APP);
+                intent.putExtra(EXTRA_PACKAGE_NAME, context.getPackageName());
+            } else {
+                // API 30-32：直接跳转应用详情页
+                goAppDetailsSettings(context);
+                return;
+            }
+
+            // 捕获 Activity 找不到异常，兜底处理（Java 7 必须显式捕获）
+            try {
+                activity.startActivityForResult(intent, requestCode);
+            } catch (android.content.ActivityNotFoundException e) {
+                // 兜底：跳转应用详情页
+                goAppDetailsSettings(context);
+            }
+        }
+    }
+
+    /**
+     * 跳转应用详情页（权限兜底引导，Java 7 规范）
+     */
+    public static void goAppDetailsSettings(@NonNull Context context) {
+        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+        Uri uri = Uri.fromParts("package", context.getPackageName(), null);
+        intent.setData(uri);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        context.startActivity(intent);
+    }
+
+    /**
+     * 解析被拒绝的权限（Java 7 字符串操作，无 Lambda）
+     */
+    public static String getDeniedPermissions(@NonNull Context context, @NonNull String[] permissions) {
+        StringBuilder deniedPerms = new StringBuilder();
+        // Java 7 传统循环遍历权限数组
+        for (int i = 0; i < permissions.length; i++) {
+            String permission = permissions[i];
+            if (!checkPermission(context, permission)) {
+                // 截取权限名称，优化展示
+                int lastDotIndex = permission.lastIndexOf(".");
+                if (lastDotIndex != -1 && lastDotIndex < permission.length() - 1) {
+                    String permName = permission.substring(lastDotIndex + 1);
+                    deniedPerms.append(permName).append("、");
+                }
+            }
+        }
+        // 移除最后一个分隔符（Java 7 字符串操作）
+        if (deniedPerms.length() > 0) {
+            deniedPerms.deleteCharAt(deniedPerms.length() - 1);
+        }
+        return deniedPerms.toString();
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/PhoneUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/PhoneUtils.java
new file mode 100644
index 0000000..34641de
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/PhoneUtils.java
@@ -0,0 +1,58 @@
+package cc.winboll.studio.contacts.utils;
+
+import android.Manifest;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import androidx.core.app.ActivityCompat;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/02/26 15:21:48
+ * @Describe 拨打电话工具类：封装拨打电话逻辑与权限校验
+ */
+public class PhoneUtils {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "PhoneUtils";
+    // 拨打电话 Action 与 Uri 前缀
+    private static final String CALL_ACTION = Intent.ACTION_CALL;
+    private static final String TEL_URI_PREFIX = "tel:";
+
+    // ====================== 核心工具方法区 ======================
+    /**
+     * 直接拨打电话（需申请 CALL_PHONE 权限）
+     * @param context     上下文对象
+     * @param phoneNumber 目标电话号码
+     */
+    public static void call(Context context, String phoneNumber) {
+        // 空值校验：防止上下文或号码为空导致异常
+        if (context == null) {
+            LogUtils.e(TAG, "call: Context 为 null，无法执行拨打电话操作");
+            return;
+        }
+        if (phoneNumber == null || phoneNumber.trim().isEmpty()) {
+            LogUtils.e(TAG, "call: 电话号码为空，无法执行拨打电话操作");
+            return;
+        }
+        String targetPhone = phoneNumber.trim();
+        LogUtils.d(TAG, "call: 准备拨打号码 | " + targetPhone);
+
+        // 权限校验：检查是否持有拨打电话权限
+        if (ActivityCompat.checkSelfPermission(context, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {
+            LogUtils.w(TAG, "call: 缺少 CALL_PHONE 权限，无法直接拨打电话");
+            return;
+        }
+
+        // 构建拨打电话 Intent 并启动
+        Intent callIntent = new Intent(CALL_ACTION);
+        callIntent.setData(Uri.parse(TEL_URI_PREFIX + targetPhone));
+        // 添加 FLAG 支持非 Activity 上下文启动
+        callIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+
+        context.startActivity(callIntent);
+        LogUtils.i(TAG, "call: 拨打电话 Intent 已发送 | 号码=" + targetPhone);
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/utils/RegexPPiUtils.java b/contacts/src/main/java/cc/winboll/studio/contacts/utils/RegexPPiUtils.java
new file mode 100644
index 0000000..1f91c60
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/utils/RegexPPiUtils.java
@@ -0,0 +1,42 @@
+package cc.winboll.studio.contacts.utils;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2024/12/09 19:00:21
+ * @Describe 正则前置校验工具类（RegexPPi）：检验文本是否满足基础正则匹配要求
+ */
+public class RegexPPiUtils {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "RegexPPiUtils";
+    // 基础匹配正则：匹配任意文本（包括空字符串）
+    private static final String BASE_REGEX = ".*";
+    // 预编译正则 Pattern，提升重复调用效率
+    private static final Pattern BASE_PATTERN = Pattern.compile(BASE_REGEX);
+
+    // ====================== 核心校验方法区 ======================
+    /**
+     * 检验文本是否满足基础正则表达式模式（.*）匹配要求
+     * @param text 待校验的文本内容
+     * @return 匹配结果，文本为null时返回false
+     */
+    public static boolean isPPiOK(String text) {
+        // 空值校验，避免空指针异常
+        if (text == null) {
+            LogUtils.w(TAG, "isPPiOK: 待校验文本为 null，返回 false");
+            return false;
+        }
+
+        // 执行正则匹配
+        Matcher matcher = BASE_PATTERN.matcher(text);
+        boolean isMatch = matcher.matches();
+
+        // 打印调试日志，记录校验结果
+        LogUtils.d(TAG, String.format("isPPiOK: 文本=[%s]，匹配结果=%b", text, isMatch));
+        return isMatch;
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/views/DuInfoTextView.java b/contacts/src/main/java/cc/winboll/studio/contacts/views/DuInfoTextView.java
new file mode 100644
index 0000000..3b4a40d
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/views/DuInfoTextView.java
@@ -0,0 +1,117 @@
+package cc.winboll.studio.contacts.views;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Message;
+import android.util.AttributeSet;
+import android.widget.TextView;
+import cc.winboll.studio.contacts.dun.Rules;
+import cc.winboll.studio.contacts.model.SettingsBean;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/02 21:11:03
+ * @Describe 云盾防御信息视图控件：展示云盾防御值统计，并支持消息驱动更新
+ */
+public class DuInfoTextView extends TextView {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "DuInfoTextView";
+    public static final int MSG_NOTIFY_INFO_UPDATE = 0;
+
+    // ====================== 成员变量区 ======================
+    private Context mContext;
+    private Handler mHandler;
+
+    // ====================== 构造函数区 ======================
+    public DuInfoTextView(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public DuInfoTextView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    public DuInfoTextView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    public DuInfoTextView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        initView(context);
+    }
+
+    // ====================== 初始化方法区 ======================
+    private void initView(Context context) {
+        LogUtils.d(TAG, "initView: 开始初始化云盾信息控件");
+        this.mContext = context;
+        initHandler();
+        updateInfo();
+        LogUtils.d(TAG, "initView: 云盾信息控件初始化完成");
+    }
+
+    /**
+     * 初始化 Handler，处理信息更新消息
+     */
+    private void initHandler() {
+        mHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                if (msg.what == MSG_NOTIFY_INFO_UPDATE) {
+                    LogUtils.d(TAG, "handleMessage: 收到信息更新消息，开始刷新视图");
+                    updateInfo();
+                }
+            }
+        };
+    }
+
+    // ====================== 视图更新方法区 ======================
+    /**
+     * 更新云盾防御信息显示
+     */
+    private void updateInfo() {
+        LogUtils.d(TAG, "updateInfo: 开始更新云盾防御信息");
+        // 空值校验，避免上下文为空导致异常
+        if (mContext == null) {
+            LogUtils.w(TAG, "updateInfo: 上下文为空，跳过信息更新");
+            setText("(云盾防御值【--/--】)");
+            return;
+        }
+
+        try {
+            SettingsBean settingsModel = Rules.getInstance(mContext).getSettingsModel();
+            // 校验 SettingsBean 非空，防止空指针
+            if (settingsModel == null) {
+                LogUtils.w(TAG, "updateInfo: SettingsBean 为空，显示默认值");
+                setText("(云盾防御值【--/--】)");
+                return;
+            }
+
+            int currentCount = settingsModel.getDunCurrentCount();
+            int totalCount = settingsModel.getDunTotalCount();
+            String info = String.format("(云盾防御值【%d/%d】)", currentCount, totalCount);
+            setText(info);
+            LogUtils.d(TAG, "updateInfo: 云盾防御信息更新完成 | " + info);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "updateInfo: 信息更新异常", e);
+            setText("(云盾防御值【--/--】)");
+        }
+    }
+
+    /**
+     * 对外提供的信息更新通知方法
+     */
+    public void notifyInfoUpdate() {
+        LogUtils.d(TAG, "notifyInfoUpdate: 发送信息更新通知");
+        if (mHandler != null) {
+            mHandler.sendMessage(mHandler.obtainMessage(MSG_NOTIFY_INFO_UPDATE));
+        } else {
+            LogUtils.w(TAG, "notifyInfoUpdate: Handler 未初始化，无法发送更新消息");
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/views/DunTemperatureView.java b/contacts/src/main/java/cc/winboll/studio/contacts/views/DunTemperatureView.java
new file mode 100644
index 0000000..7cce563
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/views/DunTemperatureView.java
@@ -0,0 +1,393 @@
+package cc.winboll.studio.contacts.views;
+
+import android.content.Context;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.LinearGradient;
+import android.graphics.Paint;
+import android.graphics.RectF;
+import android.graphics.Shader;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
+import android.util.AttributeSet;
+import android.util.TypedValue;
+import android.view.View;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.WeakHashMap;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/19 14:04:20
+ * @Describe 云盾华氏度热力视图，垂直盾值温度视图控件（带颜色渐变+静态Handler更新）
+ * 采用绘图方式展示盾值温度，填充色随盾值比例渐变，支持设置文本在温度条左侧/右侧，底部对齐竖排显示
+ * 温度条宽度=5dp，文本区宽度固定=5dp，整体左右边距=0，无任何多余空白间距
+ */
+public class DunTemperatureView extends View {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "DunTemperatureView";
+    // 控件默认高度
+    private static final int DEFAULT_HEIGHT = 200;
+    // 温度条宽度（5dp）、文本区宽度（固定5dp）
+    private static final int THERMOMETER_WIDTH_DP = 5;
+    private static final int TEXT_AREA_WIDTH_DP = 5;
+    // 填充区域内边距（左右=0，上下=2避免贴边）
+    private static final int FILL_PADDING_HORIZONTAL = 0;
+    private static final int FILL_PADDING_VERTICAL = 2;
+    // 竖排文本字间距
+    private static final float TEXT_CHAR_SPACING = 8f;
+    // Handler消息标识
+    public static final int MSG_UPDATE_DUN_VALUE = 0x01;
+    // 消息参数Key
+    public static final String KEY_MAX_VALUE = "max_value";
+    public static final String KEY_CURRENT_VALUE = "current_value";
+
+    // ====================== 静态成员区 ======================
+    // 弱引用缓存控件实例，避免内存泄漏
+    private static WeakHashMap<DunTemperatureView, Object> sViewCache = new WeakHashMap<>();
+    // 静态Handler，处理跨线程更新消息
+    private static Handler sStaticHandler;
+
+    // ====================== 成员变量区 ======================
+    // 画笔相关
+    private Paint mThermometerPaint;
+    private Paint mFillPaint;
+    private Paint mTextPaint;
+    // 尺寸参数（dp转px后的值）
+    private int mThermometerWidth;
+    private int mTextAreaWidth;
+    private int mMaxValue = 100; // 最高盾值
+    private int mCurrentValue = 0; // 当前盾值
+    private RectF mThermometerRect; // 温度条矩形区域
+    // 渐变颜色配置（低→中→高 对应绿→黄→红）
+    private int[] mGradientColors = {Color.GREEN, Color.YELLOW, Color.RED};
+    private float[] mGradientPositions = {0.0f, 0.5f, 1.0f};
+    // 布局配置：true=文本在温度条右侧（默认），false=文本在温度条左侧
+    private boolean isTextOnRight = true;
+    // 其他颜色配置
+    private int mBorderColor = Color.parseColor("#FF444444");
+    private int mTextColor = Color.parseColor("#FF000000");
+
+    // ====================== 静态代码块 ======================
+    static {
+        // 初始化静态Handler，绑定主线程Looper
+        sStaticHandler = new Handler(Looper.getMainLooper()) {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                if (msg.what == MSG_UPDATE_DUN_VALUE) {
+                    // 获取消息中的盾值参数
+                    int maxValue = msg.getData().getInt(KEY_MAX_VALUE, 100);
+                    int currentValue = msg.getData().getInt(KEY_CURRENT_VALUE, 0);
+                    LogUtils.d(TAG, "sStaticHandler: 收到更新消息，max=" + maxValue + ", current=" + currentValue);
+
+                    // 遍历缓存的控件实例，更新所有实例
+                    for (DunTemperatureView view : sViewCache.keySet()) {
+                        if (view != null && view.isShown()) {
+                            view.setMaxValue(maxValue);
+                            view.setCurrentValue(currentValue);
+                        }
+                    }
+                }
+            }
+        };
+    }
+
+    // ====================== 构造函数区 ======================
+    public DunTemperatureView(Context context) {
+        super(context);
+        init();
+    }
+
+    public DunTemperatureView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+
+    public DunTemperatureView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        init();
+    }
+
+    // ====================== 初始化方法区 ======================
+    /**
+     * 初始化画笔和参数
+     */
+    private void init() {
+        LogUtils.d(TAG, "init: 开始初始化云盾温度视图控件");
+        // dp转px（适配不同分辨率）
+        mThermometerWidth = dp2px(getContext(), THERMOMETER_WIDTH_DP);
+        mTextAreaWidth = dp2px(getContext(), TEXT_AREA_WIDTH_DP);
+        LogUtils.d(TAG, "init: 温度条宽度5dp转px=" + mThermometerWidth + "，文本区宽度5dp转px=" + mTextAreaWidth);
+
+        // 温度条边框画笔（宽度1px，适配5dp宽度）
+        mThermometerPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
+        mThermometerPaint.setColor(mBorderColor);
+        mThermometerPaint.setStyle(Paint.Style.STROKE);
+        mThermometerPaint.setStrokeWidth(1);
+
+        // 温度条填充画笔（支持渐变）
+        mFillPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
+        mFillPaint.setStyle(Paint.Style.FILL);
+
+        // 文本画笔（适配5dp窄文本区，文字居中绘制）
+        mTextPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
+        mTextPaint.setColor(mTextColor);
+        mTextPaint.setTextSize(18); // 缩小字号适配5dp窄文本区（避免文字超出）
+        mTextPaint.setTextAlign(Paint.Align.CENTER);
+        mTextPaint.setFakeBoldText(true); // 文字加粗，提升窄区域可读性
+
+        // 初始化温度条矩形
+        mThermometerRect = new RectF();
+
+        // 将当前实例加入静态缓存
+        sViewCache.put(this, null);
+        LogUtils.d(TAG, "init: 云盾温度视图控件初始化完成，实例已加入缓存");
+    }
+
+    // ====================== 工具方法区 ======================
+    /**
+     * dp 转 px（适配不同屏幕分辨率）
+     */
+    private int dp2px(Context context, float dpValue) {
+        return (int) TypedValue.applyDimension(
+			TypedValue.COMPLEX_UNIT_DIP,
+			dpValue,
+			context.getResources().getDisplayMetrics()
+        );
+    }
+
+    // ====================== 对外控制方法区 ======================
+    /**
+     * 设置文本相对于温度条的位置
+     * @param isOnRight true=文本在温度条右侧（默认），false=文本在温度条左侧
+     */
+    public void setTextPosition(boolean isOnRight) {
+        this.isTextOnRight = isOnRight;
+        invalidate(); // 刷新布局绘制
+    }
+
+    /**
+     * 获取当前文本位置配置
+     * @return true=右侧，false=左侧
+     */
+    public boolean isTextOnRight() {
+        return isTextOnRight;
+    }
+
+    // ====================== 对外静态方法区 ======================
+    /**
+     * 静态外部方法：发送消息更新所有 DunTemperatureView 实例的盾值
+     * 可在子线程中调用
+     * @param maxValue 最高盾值
+     * @param currentValue 当前盾值
+     */
+    public static void updateDunValue(int maxValue, int currentValue) {
+        if (sStaticHandler == null) {
+            LogUtils.w(TAG, "updateDunValue: 静态Handler未初始化");
+            return;
+        }
+        // 封装参数到消息
+        Message msg = sStaticHandler.obtainMessage(MSG_UPDATE_DUN_VALUE);
+        msg.getData().putInt(KEY_MAX_VALUE, maxValue);
+        msg.getData().putInt(KEY_CURRENT_VALUE, currentValue);
+        // 发送消息
+        sStaticHandler.sendMessage(msg);
+    }
+
+    // ====================== 对外实例方法区 ======================
+    /**
+     * 设置最高盾值
+     * @param maxValue 最高盾值（需大于0）
+     */
+    public void setMaxValue(int maxValue) {
+        if (maxValue <= 0) {
+            LogUtils.w(TAG, "setMaxValue: 最高盾值必须大于0，当前值=" + maxValue);
+            return;
+        }
+        this.mMaxValue = maxValue;
+        // 限制当前值不超过最大值
+        mCurrentValue = Math.min(mCurrentValue, maxValue);
+        invalidate(); // 重绘控件
+    }
+
+    /**
+     * 设置当前盾值
+     * @param currentValue 当前盾值（范围 0~maxValue）
+     */
+    public void setCurrentValue(int currentValue) {
+        int oldValue = this.mCurrentValue;
+        this.mCurrentValue = Math.max(0, Math.min(currentValue, mMaxValue));
+        if (oldValue != this.mCurrentValue) {
+            LogUtils.d(TAG, "setCurrentValue: 当前盾值从" + oldValue + "更新为" + mCurrentValue);
+            invalidate(); // 重绘控件
+        }
+    }
+
+    /**
+     * 获取当前盾值
+     */
+    public int getCurrentValue() {
+        return mCurrentValue;
+    }
+
+    /**
+     * 获取最高盾值
+     */
+    public int getMaxValue() {
+        return mMaxValue;
+    }
+
+    /**
+     * 设置自定义渐变颜色
+     * @param colors 渐变颜色数组（至少2种颜色）
+     * @param positions 颜色位置数组（与colors长度一致，0.0~1.0）
+     */
+    public void setGradientColors(int[] colors, float[] positions) {
+        if (colors == null || colors.length < 2 || positions == null || positions.length != colors.length) {
+            LogUtils.w(TAG, "setGradientColors: 渐变颜色参数不合法，颜色数组长度=" + (colors == null ? "null" : colors.length));
+            return;
+        }
+        this.mGradientColors = colors;
+        this.mGradientPositions = positions;
+        LogUtils.d(TAG, "setGradientColors: 自定义渐变颜色已设置");
+        invalidate();
+    }
+
+    /**
+     * 设置温度条边框颜色
+     */
+    public void setBorderColor(int color) {
+        this.mBorderColor = color;
+        mThermometerPaint.setColor(color);
+        LogUtils.d(TAG, "setBorderColor: 边框颜色已更新");
+        invalidate();
+    }
+
+    /**
+     * 设置文本颜色
+     */
+    public void setTextColor(int color) {
+        this.mTextColor = color;
+        mTextPaint.setColor(color);
+        LogUtils.d(TAG, "setTextColor: 文本颜色已更新");
+        invalidate();
+    }
+
+    // ====================== 生命周期方法 ======================
+    @Override
+    protected void onDetachedFromWindow() {
+        super.onDetachedFromWindow();
+        // 控件从窗口移除时，从缓存中清除，避免内存泄漏
+        sViewCache.remove(this);
+        LogUtils.d(TAG, "onDetachedFromWindow: 控件实例已从缓存移除");
+    }
+
+    // ====================== 测量与绘制区 ======================
+    /**
+     * 测量辅助函数
+     */
+    private int measureSize(int defaultSize, int measureSpec) {
+        int result = defaultSize;
+        int specMode = MeasureSpec.getMode(measureSpec);
+        int specSize = MeasureSpec.getSize(measureSpec);
+        if (specMode == MeasureSpec.EXACTLY) {
+            result = specSize;
+        } else if (specMode == MeasureSpec.AT_MOST) {
+            result = Math.min(defaultSize, specSize);
+        }
+        return result;
+    }
+
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
+        // 强制控件整体左右内边距=0，彻底消除外部边距
+        setPadding(0, getPaddingTop(), 0, getPaddingBottom());
+
+        // 控件宽度=温度条宽度 + 文本区宽度（均为5dp转px，无额外空白）
+        int defaultWidth = mThermometerWidth + mTextAreaWidth;
+        int width = measureSize(defaultWidth, widthMeasureSpec);
+        int height = measureSize(DEFAULT_HEIGHT, heightMeasureSpec);
+        setMeasuredDimension(width, height);
+
+        // 根据文本位置配置，计算温度条矩形坐标
+        float thermometerLeft, thermometerRight;
+        if (isTextOnRight) {
+            // 文本在右侧：温度条靠左，右接文本区
+            thermometerLeft = 0;
+            thermometerRight = thermometerLeft + mThermometerWidth;
+        } else {
+            // 文本在左侧：温度条靠右，左接文本区
+            thermometerLeft = width - mThermometerWidth;
+            thermometerRight = width;
+        }
+        float thermometerTop = getPaddingTop();
+        float thermometerBottom = height - getPaddingBottom();
+        mThermometerRect.set(thermometerLeft, thermometerTop, thermometerRight, thermometerBottom);
+
+        LogUtils.v(TAG, "onMeasure: 文本位置=" + (isTextOnRight ? "右侧" : "左侧") + "，控件尺寸=" + width + "x" + height + "，温度条区域=" + mThermometerRect.toShortString());
+    }
+
+    @Override
+    protected void onDraw(Canvas canvas) {
+        super.onDraw(canvas);
+        // 1. 绘制温度条边框（5dp宽度，小圆角适配）
+        canvas.drawRoundRect(mThermometerRect, 3, 3, mThermometerPaint);
+
+        // 2. 计算填充高度（根据当前值占最大值的比例）
+        float fillRatio = (float) mCurrentValue / mMaxValue;
+        float fillHeight = mThermometerRect.height() * fillRatio;
+        float fillTop = mThermometerRect.bottom - fillHeight;
+
+        // 3. 绘制渐变填充部分（左右贴边框，无间距）
+        if (fillHeight > 0) {
+            RectF fillRect = new RectF(
+                mThermometerRect.left + FILL_PADDING_HORIZONTAL,
+                fillTop + FILL_PADDING_VERTICAL,
+                mThermometerRect.right - FILL_PADDING_HORIZONTAL,
+                mThermometerRect.bottom - FILL_PADDING_VERTICAL
+            );
+            LinearGradient gradient = new LinearGradient(
+                fillRect.centerX(), fillRect.bottom,
+                fillRect.centerX(), fillRect.top,
+                mGradientColors,
+                mGradientPositions,
+                Shader.TileMode.CLAMP
+            );
+            mFillPaint.setShader(gradient);
+            canvas.drawRoundRect(fillRect, 2, 2, mFillPaint);
+            mFillPaint.setShader(null);
+        }
+
+        // 4. 绘制文本（5dp固定宽度文本区，底部对齐竖排，文字居中）
+        String text = String.format("%d/%d", mCurrentValue, mMaxValue);
+        if (text.isEmpty()) return;
+
+        float textBaseX;
+        if (isTextOnRight) {
+            // 文本在右侧：X=温度条右边缘 + 文本区宽度的一半（紧贴温度条）
+            textBaseX = mThermometerRect.right + (mTextAreaWidth / 2f);
+        } else {
+            // 文本在左侧：X=文本区宽度的一半（紧贴控件左边缘）
+            textBaseX = mTextAreaWidth / 2f;
+        }
+
+        // 文本绘制参数（适配5dp窄区域，缩小字间距提升紧凑度）
+        float singleCharHeight = mTextPaint.getTextSize() + (TEXT_CHAR_SPACING - 2f); // 字间距减为6f
+        float totalTextHeight = (singleCharHeight * text.length()) - (TEXT_CHAR_SPACING - 2f);
+        Paint.FontMetrics fontMetrics = mTextPaint.getFontMetrics();
+        float charBottomOffset = fontMetrics.bottom;
+
+        // 文本起始Y（底部对齐控件底部，无间距）
+        float startTextY = getHeight() - getPaddingBottom() - charBottomOffset;
+
+        // 逐字竖排绘制（文字居中于5dp文本区，无超出）
+        for (int i = 0; i < text.length(); i++) {
+            char singleChar = text.charAt(i);
+            float currentTextY = startTextY - (i * singleCharHeight);
+            canvas.drawText(String.valueOf(singleChar), textBaseX, currentTextY, mTextPaint);
+        }
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/views/LeftScrollView.java b/contacts/src/main/java/cc/winboll/studio/contacts/views/LeftScrollView.java
new file mode 100644
index 0000000..0cbc2b1
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/views/LeftScrollView.java
@@ -0,0 +1,306 @@
+package cc.winboll.studio.contacts.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.view.MotionEvent;
+import android.view.View;
+import android.widget.Button;
+import android.widget.HorizontalScrollView;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/04 10:51:50
+ * @Describe 左滑显示操作按钮的自定义滚动视图，支持编辑、删除、上移、下移功能
+ */
+public class LeftScrollView extends HorizontalScrollView {
+    // ====================== 常量定义区 ======================
+    public static final String TAG = "LeftScrollView";
+
+    // ====================== 成员变量区 ======================
+    // 布局控件
+    private LinearLayout contentLayout;
+    private LinearLayout toolLayout;
+    private TextView textView;
+    private Button editButton;
+    private Button deleteButton;
+    private Button upButton;
+    private Button downButton;
+    // 滑动事件相关
+    private float mStartX;
+    private float mEndX;
+    private boolean isScrolling = false;
+    private int nScrollAcceptSize;
+    // 回调接口
+    private OnActionListener onActionListener;
+
+    // ====================== 构造函数区 ======================
+    public LeftScrollView(Context context) {
+        super(context);
+        init();
+    }
+
+    public LeftScrollView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+
+    public LeftScrollView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        init();
+    }
+
+    // ====================== 初始化方法区 ======================
+    private void init() {
+        LogUtils.d(TAG, "init: 开始初始化左滑滚动视图");
+        // 加载布局
+        View viewMain = inflate(getContext(), R.layout.view_left_scroll, null);
+        if (viewMain == null) {
+            LogUtils.e(TAG, "init: 布局加载失败，无法初始化控件");
+            return;
+        }
+
+        // 绑定布局控件
+        contentLayout = viewMain.findViewById(R.id.content_layout);
+        toolLayout = viewMain.findViewById(R.id.action_layout);
+        editButton = viewMain.findViewById(R.id.edit_btn);
+        deleteButton = viewMain.findViewById(R.id.delete_btn);
+        upButton = viewMain.findViewById(R.id.up_btn);
+        downButton = viewMain.findViewById(R.id.down_btn);
+
+        // 校验控件是否绑定成功
+        if (contentLayout == null || toolLayout == null) {
+            LogUtils.e(TAG, "init: 核心布局控件绑定失败");
+            return;
+        }
+
+        // 添加主布局到当前视图
+        addView(viewMain);
+        // 设置按钮点击事件
+        setButtonClickListener();
+
+        LogUtils.d(TAG, "init: 左滑滚动视图初始化完成");
+    }
+
+    /**
+     * 设置操作按钮的点击事件
+     */
+    private void setButtonClickListener() {
+        // 编辑按钮
+        if (editButton != null) {
+            editButton.setOnClickListener(new OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.d(TAG, "onClick: 点击编辑按钮");
+						if (onActionListener != null) {
+							onActionListener.onEdit();
+						}
+					}
+				});
+        }
+
+        // 删除按钮
+        if (deleteButton != null) {
+            deleteButton.setOnClickListener(new OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.d(TAG, "onClick: 点击删除按钮");
+						if (onActionListener != null) {
+							onActionListener.onDelete();
+						}
+					}
+				});
+        }
+
+        // 上移按钮
+        if (upButton != null) {
+            upButton.setOnClickListener(new OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.d(TAG, "onClick: 点击上移按钮");
+						if (onActionListener != null) {
+							onActionListener.onUp();
+						}
+					}
+				});
+        }
+
+        // 下移按钮
+        if (downButton != null) {
+            downButton.setOnClickListener(new OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.d(TAG, "onClick: 点击下移按钮");
+						if (onActionListener != null) {
+							onActionListener.onDown();
+						}
+					}
+				});
+        }
+    }
+
+    // ====================== 对外提供的方法区 ======================
+    /**
+     * 添加内容视图到容器
+     * @param viewContent 待添加的内容视图
+     */
+    public void addContentLayout(View viewContent) {
+        if (contentLayout == null) {
+            LogUtils.w(TAG, "addContentLayout: 内容布局未初始化，无法添加视图");
+            return;
+        }
+        if (viewContent == null) {
+            LogUtils.w(TAG, "addContentLayout: 待添加视图为null");
+            return;
+        }
+        contentLayout.addView(viewContent, LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.MATCH_PARENT);
+        LogUtils.d(TAG, "addContentLayout: 内容视图添加成功");
+    }
+
+    /**
+     * 设置内容布局的宽度
+     * @param contentWidth 目标宽度
+     */
+    public void setContentWidth(int contentWidth) {
+        if (contentLayout == null) {
+            LogUtils.w(TAG, "setContentWidth: 内容布局未初始化，无法设置宽度");
+            return;
+        }
+        LinearLayout.LayoutParams layoutParams = (LinearLayout.LayoutParams) contentLayout.getLayoutParams();
+        layoutParams.width = contentWidth;
+        contentLayout.setLayoutParams(layoutParams);
+        LogUtils.d(TAG, "setContentWidth: 内容布局宽度设置为 " + contentWidth);
+    }
+
+    /**
+     * 设置文本内容（原代码未初始化textView，添加空校验）
+     * @param text 待显示的文本
+     */
+    public void setText(CharSequence text) {
+        if (textView == null) {
+            LogUtils.w(TAG, "setText: 文本控件未初始化，无法设置文本");
+            return;
+        }
+        textView.setText(text);
+        LogUtils.d(TAG, "setText: 文本设置为 " + text);
+    }
+
+    /**
+     * 设置事件回调监听器
+     * @param listener 回调接口实例
+     */
+    public void setOnActionListener(OnActionListener listener) {
+        this.onActionListener = listener;
+        LogUtils.d(TAG, "setOnActionListener: 事件监听器已设置");
+    }
+
+    // ====================== 滑动事件处理区 ======================
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {
+        if (event == null) {
+            return super.onTouchEvent(event);
+        }
+
+        switch (event.getAction()) {
+            case MotionEvent.ACTION_DOWN:
+                mStartX = event.getX();
+                LogUtils.d(TAG, "onTouchEvent: ACTION_DOWN，起始X坐标 = " + mStartX);
+                break;
+            case MotionEvent.ACTION_MOVE:
+                // 可根据需求添加滑动中逻辑
+                break;
+            case MotionEvent.ACTION_UP:
+            case MotionEvent.ACTION_CANCEL:
+                mEndX = event.getX();
+                int scrollX = getScrollX();
+                LogUtils.d(TAG, String.format("onTouchEvent: ACTION_UP/CANCEL，起始X=%f 结束X=%f 滚动距离=%d",
+											  mStartX, mEndX, scrollX));
+
+                if (scrollX > 0) {
+                    handleScrollLogic();
+                }
+                break;
+        }
+        return super.onTouchEvent(event);
+    }
+
+    /**
+     * 处理滑动结束后的逻辑，判断滑动方向并执行滚动
+     */
+    private void handleScrollLogic() {
+        float deltaX = Math.abs(mStartX - mEndX);
+        // 校验按钮是否存在，避免空指针
+        float threshold = editButton != null ? editButton.getWidth() : 50;
+
+        if (mEndX < mStartX) {
+            // 向左滑，显示操作按钮
+            if (deltaX > threshold) {
+                smoothScrollToRight();
+            } else {
+                smoothScrollToLeft();
+            }
+        } else {
+            // 向右滑，隐藏操作按钮
+            if (deltaX > threshold) {
+                smoothScrollToLeft();
+            } else {
+                smoothScrollToRight();
+            }
+        }
+    }
+
+    /**
+     * 平滑滚动到右侧（显示操作按钮）
+     */
+    private void smoothScrollToRight() {
+        post(new Runnable() {
+				@Override
+				public void run() {
+					View childView = getChildAt(0);
+					if (childView != null) {
+						int scrollToX = childView.getWidth() - getWidth();
+						int targetX = Math.max(0, scrollToX);
+						smoothScrollTo(targetX, 0);
+						LogUtils.d(TAG, "smoothScrollToRight: 滚动到右侧，目标X坐标 = " + targetX);
+					}
+				}
+			});
+        // 重置坐标
+        resetScrollCoordinate();
+    }
+
+    /**
+     * 平滑滚动到左侧（隐藏操作按钮）
+     */
+    private void smoothScrollToLeft() {
+        post(new Runnable() {
+				@Override
+				public void run() {
+					smoothScrollTo(0, 0);
+					LogUtils.d(TAG, "smoothScrollToLeft: 滚动到左侧");
+				}
+			});
+        // 重置坐标
+        resetScrollCoordinate();
+    }
+
+    /**
+     * 重置滑动坐标
+     */
+    private void resetScrollCoordinate() {
+        mStartX = 0;
+        mEndX = 0;
+    }
+
+    // ====================== 回调接口定义区 ======================
+    public interface OnActionListener {
+        void onEdit();
+        void onDelete();
+        void onUp();
+        void onDown();
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/views/LimitedTimeSpecialChannelView.java b/contacts/src/main/java/cc/winboll/studio/contacts/views/LimitedTimeSpecialChannelView.java
new file mode 100644
index 0000000..c73e168
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/views/LimitedTimeSpecialChannelView.java
@@ -0,0 +1,323 @@
+package cc.winboll.studio.contacts.views;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.widget.Button;
+import android.widget.CompoundButton;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.Switch;
+import androidx.localbroadcastmanager.content.LocalBroadcastManager;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.contacts.services.LimitedTimeSpecialChannelService;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/04/18 15:05:00 (GMT+8)
+ * @LastEditTime 2026/04/22 17:30:00 (GMT+8)
+ * @Describe 限时特殊通道视图
+ * 功能说明：
+ * 1. Switch 打开时，EditText 不可编辑，布局背景变为绿色，加减按钮不可用
+ * 2. Switch 关闭时，EditText 可编辑，布局背景恢复为白色，加减按钮恢复可用
+ * 3. 监听服务销毁本地广播，到达后自动关闭 Switch 并恢复背景色与按钮状态
+ * 4. 监听倒计时心跳广播，实时更新EditText显示剩余秒数
+ * 5. 加减按钮控制秒数增减，最小值限制为0
+ * 6. 新增快速设置按钮(btn_thisSeconds)，点击直接设置为当前量级3600秒
+ * 7. [新增] 服务销毁时，恢复EditText显示为倒计时剩余秒数
+ */
+public class LimitedTimeSpecialChannelView extends LinearLayout {
+
+    // ====================== 常量定义 =========================
+    public static final String TAG = "LimitedTimeSpecialChannelView";
+    // 定义秒数增量的量级
+    private static final long SECONDS_INCREMENT = 3600;
+
+    // ====================== 成员变量 =========================
+    private Context mContext;
+    private EditText mEtSeconds;
+    private Switch mSwEnable;
+    private LinearLayout mLlMain;
+    private Button mBtnAddSeconds;
+    private Button mBtnSubSeconds;
+    // [新增] 快速设置量级按钮
+    private Button mBtnThisSeconds;
+    private android.content.BroadcastReceiver mCountdownReceiver;
+
+    // ====================== 构造函数 =========================
+    public LimitedTimeSpecialChannelView(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public LimitedTimeSpecialChannelView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    public LimitedTimeSpecialChannelView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    // ====================== 初始化方法 =========================
+    private void initView(Context context) {
+        LogUtils.i(TAG, "开始初始化视图...");
+        this.mContext = context;
+
+        // 加载布局文件
+        LayoutInflater.from(context).inflate(R.layout.view_limitedtimespecialchannel, this, true);
+        LogUtils.i(TAG, "布局文件加载完成");
+
+        // 绑定控件ID
+        bindViews();
+        // 初始化所有按钮点击事件
+        initButtons();
+        // 初始化开关状态
+        initSwitchState();
+        // 注册广播监听
+        registerServiceDestroyedListener();
+        registerCountdownTickListener();
+
+        LogUtils.i(TAG, "视图初始化流程结束");
+    }
+
+    /**
+     * 绑定布局中的所有控件ID
+     */
+    private void bindViews() {
+        LogUtils.i(TAG, "开始绑定控件ID");
+        mEtSeconds = (EditText) findViewById(R.id.et_seconds);
+        mSwEnable = (Switch) findViewById(R.id.sw_enable);
+        mLlMain = (LinearLayout) findViewById(R.id.ll_main);
+        mBtnAddSeconds = (Button) findViewById(R.id.btn_addSeconds);
+        mBtnSubSeconds = (Button) findViewById(R.id.btn_subSeconds);
+        // [新增] 绑定快速设置按钮ID
+        mBtnThisSeconds = (Button) findViewById(R.id.btn_thisSeconds);
+
+        // 健壮性检查
+        if (mEtSeconds == null) LogUtils.e(TAG, "未找到ID为 et_seconds 的EditText");
+        if (mSwEnable == null) LogUtils.e(TAG, "未找到ID为 sw_enable 的Switch");
+        if (mLlMain == null) LogUtils.w(TAG, "未找到ID为 ll_main 的LinearLayout，将无法设置背景色");
+        if (mBtnAddSeconds == null) LogUtils.e(TAG, "未找到ID为 btn_addSeconds 的Button");
+        if (mBtnSubSeconds == null) LogUtils.e(TAG, "未找到ID为 btn_subSeconds 的Button");
+        if (mBtnThisSeconds == null) LogUtils.e(TAG, "未找到ID为 btn_thisSeconds 的Button");
+
+        LogUtils.i(TAG, "控件ID绑定完成");
+    }
+
+    /**
+     * 初始化所有按钮的点击事件
+     * 包含：加号、减号、快速设置量级按钮
+     */
+    private void initButtons() {
+        LogUtils.i(TAG, "初始化按钮点击事件");
+
+        // 1. 加号按钮：增加一个量级
+        if (mBtnAddSeconds != null) {
+            mBtnAddSeconds.setOnClickListener(new OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.i(TAG, "点击加号按钮，准备增加秒数");
+						try {
+							long current = Long.parseLong(mEtSeconds.getText().toString().trim());
+							long newValue = current + SECONDS_INCREMENT;
+							mEtSeconds.setText(String.valueOf(newValue));
+							LogUtils.i(TAG, "增加成功，当前秒数: " + newValue);
+						} catch (NumberFormatException e) {
+							LogUtils.e(TAG, "当前输入格式错误，无法增加", e);
+							mEtSeconds.setText("0");
+						}
+					}
+				});
+        }
+
+        // 2. 减号按钮：减少一个量级，最低为0
+        if (mBtnSubSeconds != null) {
+            mBtnSubSeconds.setOnClickListener(new OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.i(TAG, "点击减号按钮，准备减少秒数");
+						try {
+							long current = Long.parseLong(mEtSeconds.getText().toString().trim());
+							long newValue = Math.max(0, current - SECONDS_INCREMENT);
+							mEtSeconds.setText(String.valueOf(newValue));
+							LogUtils.i(TAG, "减少成功，当前秒数: " + newValue);
+						} catch (NumberFormatException e) {
+							LogUtils.e(TAG, "当前输入格式错误，无法减少", e);
+							mEtSeconds.setText("0");
+						}
+					}
+				});
+        }
+
+        // 3. [新增] 快速设置按钮：点击直接设置为量级数值 3600
+        if (mBtnThisSeconds != null) {
+            mBtnThisSeconds.setOnClickListener(new OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.i(TAG, "点击快速设置按钮，设置秒数为: " + SECONDS_INCREMENT);
+						// 直接设置为常量数值
+						mEtSeconds.setText(String.valueOf(SECONDS_INCREMENT));
+						LogUtils.i(TAG, "快速设置成功，当前秒数: " + SECONDS_INCREMENT);
+					}
+				});
+        }
+    }
+
+    /**
+     * 初始化开关状态
+     * 设置Switch的监听事件，以及背景色、按钮可点击状态
+     */
+    private void initSwitchState() {
+        LogUtils.i(TAG, "初始化开关状态");
+        boolean isChecked = mSwEnable.isChecked();
+
+        // 设置初始UI状态
+        updateUIState(!isChecked);
+
+        LogUtils.i(TAG, "初始状态 - 开关: " + (isChecked ? "开启" : "关闭") + ", 背景色: " + (isChecked ? "绿色" : "白色") + ", 按钮可用: " + (!isChecked ? "是" : "否"));
+
+        // 设置开关切换监听
+        mSwEnable.setOnCheckedChangeListener(new Switch.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
+					LogUtils.i(TAG, "开关状态变更为: " + (isChecked ? "开启" : "关闭"));
+					// 根据开关状态更新UI可操作状态
+					updateUIState(!isChecked);
+
+					if (isChecked) {
+						startLimitedTimeSpecialChannelService();
+					} else {
+						LimitedTimeSpecialChannelService.stopService(mContext);
+					}
+				}
+			});
+    }
+
+    /**
+     * 统一更新UI可操作状态
+     * @param enabled 可用状态
+     */
+    private void updateUIState(boolean enabled) {
+        if (mEtSeconds != null) mEtSeconds.setEnabled(enabled);
+        if (mBtnAddSeconds != null) mBtnAddSeconds.setEnabled(enabled);
+        if (mBtnSubSeconds != null) mBtnSubSeconds.setEnabled(enabled);
+        // [新增] 同步快速设置按钮状态
+        if (mBtnThisSeconds != null) mBtnThisSeconds.setEnabled(enabled);
+
+        if (mLlMain != null) {
+            mLlMain.setBackgroundColor(enabled ? android.graphics.Color.WHITE : android.graphics.Color.GREEN);
+        }
+    }
+
+    /**
+     * 注册服务销毁本地广播监听
+     * [修改] 接收广播时检索倒计时剩余秒数参数并设置到EditText
+     */
+    private void registerServiceDestroyedListener() {
+        LogUtils.i(TAG, "注册服务销毁广播监听");
+        IntentFilter filter = new IntentFilter(LimitedTimeSpecialChannelService.ACTION_SERVICE_DESTROYED);
+        LocalBroadcastManager.getInstance(mContext).registerReceiver(new android.content.BroadcastReceiver() {
+				@Override
+				public void onReceive(Context context, Intent intent) {
+					if (LimitedTimeSpecialChannelService.ACTION_SERVICE_DESTROYED.equals(intent.getAction())) {
+						LogUtils.i(TAG, "收到服务销毁广播，执行恢复操作");
+
+						// 1. 恢复开关状态
+						if (mSwEnable != null && mSwEnable.isChecked()) {
+							mSwEnable.setChecked(false);
+						}
+
+						// 2. [核心修改] 检索并设置倒计时剩余秒数参数
+						// 从广播附加数据中获取之前服务发送的剩余秒数
+						long remainingSeconds = intent.getLongExtra(LimitedTimeSpecialChannelService.EXTRA_REMAINING_SECONDS, 0);
+						// 实际倒计时消耗冲正
+						remainingSeconds -= 1;
+						// 倒计时秒数0值保底
+						remainingSeconds = remainingSeconds < 0? 0 : remainingSeconds;
+						LogUtils.i(TAG, "从销毁广播中检索到剩余秒数参数: " + remainingSeconds + " 秒");
+						//ToastUtils.show("从销毁广播中检索到剩余秒数参数: " + remainingSeconds + " 秒");
+
+						// 3. 恢复所有UI状态为可用
+						updateUIState(true);
+						// 4. 设置EditText显示为倒计时剩余秒数
+						if (mEtSeconds != null) {
+							mEtSeconds.setText(String.valueOf(remainingSeconds));
+							LogUtils.i(TAG, "已将EditText设置为剩余秒数: " + remainingSeconds);
+						}
+
+						//ToastUtils.show("服务已销毁，恢复倒计时剩余状态");
+					}
+				}
+			}, filter);
+    }
+
+    /**
+     * 注册倒计时心跳广播监听
+     */
+    private void registerCountdownTickListener() {
+        LogUtils.i(TAG, "注册倒计时心跳广播监听");
+        mCountdownReceiver = new android.content.BroadcastReceiver() {
+            @Override
+            public void onReceive(Context context, Intent intent) {
+                if (LimitedTimeSpecialChannelService.ACTION_COUNTDOWN_TICK.equals(intent.getAction())) {
+                    long remainingSeconds = intent.getLongExtra(LimitedTimeSpecialChannelService.EXTRA_REMAINING_SECONDS, 0);
+                    if (mEtSeconds != null) {
+                        mEtSeconds.setText(String.valueOf(remainingSeconds));
+                    }
+					if (mSwEnable != null) {
+                        mSwEnable.setChecked(remainingSeconds>0);
+                    }
+                }
+            }
+        };
+
+        IntentFilter filter = new IntentFilter(LimitedTimeSpecialChannelService.ACTION_COUNTDOWN_TICK);
+        LocalBroadcastManager.getInstance(mContext).registerReceiver(mCountdownReceiver, filter);
+        LogUtils.i(TAG, "倒计时广播注册成功");
+    }
+
+    /**
+     * 启动限时特殊通道服务
+     */
+    private void startLimitedTimeSpecialChannelService() {
+        LogUtils.i(TAG, "准备启动限时特殊通道服务");
+        String secondsStr = mEtSeconds.getText().toString().trim();
+        if (secondsStr.isEmpty()) {
+            LogUtils.w(TAG, "输入框为空，使用默认值 3600 秒");
+            secondsStr = "3600";
+        }
+
+        try {
+            long seconds = Long.parseLong(secondsStr);
+            long delayMillis = seconds * 1000;
+
+            LogUtils.i(TAG, "启动参数 - 输入秒数: " + seconds + ", 转换毫秒: " + delayMillis);
+            //ToastUtils.show("调用 LimitedTimeSpecialChannelService 服务");
+            LimitedTimeSpecialChannelService.startService(mContext, delayMillis);
+        } catch (NumberFormatException e) {
+            LogUtils.e(TAG, "输入的秒数格式错误: " + secondsStr, e);
+        }
+    }
+
+    // ====================== 生命周期方法 =========================
+    @Override
+    protected void onDetachedFromWindow() {
+        super.onDetachedFromWindow();
+        LogUtils.i(TAG, "视图销毁，反注册所有广播接收器");
+
+        if (mCountdownReceiver != null) {
+            LocalBroadcastManager.getInstance(mContext).unregisterReceiver(mCountdownReceiver);
+            LogUtils.i(TAG, "反注册倒计时心跳广播接收器");
+        }
+
+        LogUtils.i(TAG, "所有广播反注册完成");
+    }
+}
+
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/widgets/APPStatusWidget.java b/contacts/src/main/java/cc/winboll/studio/contacts/widgets/APPStatusWidget.java
new file mode 100644
index 0000000..edd6b26
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/widgets/APPStatusWidget.java
@@ -0,0 +1,75 @@
+package cc.winboll.studio.contacts.widgets;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/17 14:49:31
+ * @Describe APPStatusWidget
+ */
+import android.app.PendingIntent;
+import android.appwidget.AppWidgetManager;
+import android.appwidget.AppWidgetProvider;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.widget.RemoteViews;
+import cc.winboll.studio.contacts.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class APPStatusWidget extends AppWidgetProvider {
+
+    public static final String TAG = "APPSOSReportWidget";
+
+    public static final String ACTION_STATUS_ACTIVE = "cc.winboll.studio.contacts.widgets.APPStatusWidget.ACTION_STATUS_ACTIVE";
+    public static final String ACTION_STATUS_NOACTIVE = "cc.winboll.studio.contacts.widgets.APPStatusWidget.ACTION_STATUS_NOACTIVE";
+
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        for (int appWidgetId : appWidgetIds) {
+            updateAppWidget(context, appWidgetManager, appWidgetId);
+        }
+    }
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        super.onReceive(context, intent);
+        if (intent.getAction().equals(ACTION_STATUS_ACTIVE)) {
+            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
+            int[] appWidgetIds = appWidgetManager.getAppWidgetIds(new ComponentName(context, APPStatusWidget.class));
+            for (int appWidgetId : appWidgetIds) {
+                updateAppWidget(context, appWidgetManager, appWidgetId);
+            }
+        } else if (intent.getAction().equals(ACTION_STATUS_NOACTIVE)) {
+            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
+            int[] appWidgetIds = appWidgetManager.getAppWidgetIds(new ComponentName(context, APPStatusWidget.class));
+            for (int appWidgetId : appWidgetIds) {
+                updateAppWidget(context, appWidgetManager, appWidgetId);
+            }
+        }
+
+    }
+
+    private void updateAppWidget(Context context, AppWidgetManager appWidgetManager, int appWidgetId) {
+        LogUtils.d(TAG, "updateAppWidget(...)");
+
+        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
+        //设置按钮点击事件
+        Intent intentAppButton = new Intent(context, APPStatusWidgetClickListener.class);
+        intentAppButton.setAction(APPStatusWidgetClickListener.ACTION_APPICON_CLICK);
+        PendingIntent pendingIntentAppButton = PendingIntent.getBroadcast(context, 0, intentAppButton, PendingIntent.FLAG_UPDATE_CURRENT);
+        views.setOnClickPendingIntent(R.id.widgetlayoutImageView1, pendingIntentAppButton);
+
+//        boolean isActive = !MainServiceThread.isExist();
+//        if (isActive) {
+//            views.setImageViewResource(R.id.widgetlayoutImageView1, R.drawable.ic_launcher);
+//        } else {
+//            views.setImageViewResource(R.id.widgetlayoutImageView1, R.drawable.ic_launcher_disable);
+//
+//        }
+        appWidgetManager.updateAppWidget(appWidgetId, views);
+    }
+
+    public static void onAPPStatusWidgetClick(Context context) {
+        ToastUtils.show("onAPPStatusWidgetClick");
+    }
+}
diff --git a/contacts/src/main/java/cc/winboll/studio/contacts/widgets/APPStatusWidgetClickListener.java b/contacts/src/main/java/cc/winboll/studio/contacts/widgets/APPStatusWidgetClickListener.java
new file mode 100644
index 0000000..3525067
--- /dev/null
+++ b/contacts/src/main/java/cc/winboll/studio/contacts/widgets/APPStatusWidgetClickListener.java
@@ -0,0 +1,32 @@
+package cc.winboll.studio.contacts.widgets;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/17 14:59:55
+ * @Describe WidgetButtonClickListener
+ */
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class APPStatusWidgetClickListener extends BroadcastReceiver {
+
+    public static final String TAG = "APPStatusWidgetClickListener";
+
+    public static final String ACTION_APPICON_CLICK = "cc.winboll.studio.contacts.widgets.APPStatusWidgetClickListener.ACTION_APPICON_CLICK";
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent.getAction();
+        if (action == null) {
+            LogUtils.d(TAG, String.format("action %s", action));
+            return;
+        }
+        if (action.equals(ACTION_APPICON_CLICK)) {
+            LogUtils.d(TAG, "ACTION_APPICON_CLICK");
+            Toast.makeText(context, "ACTION_APPICON_CLICK", Toast.LENGTH_SHORT).show();
+        }
+    }
+}
diff --git a/contacts/src/main/res/drawable/ic_call.xml b/contacts/src/main/res/drawable/ic_call.xml
new file mode 100644
index 0000000..c5802bb
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_call.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M6.62,10.79C8.06,13.62 10.38,15.94 13.21,17.38L15.41,15.18C15.69,14.9 16.08,14.82 16.43,14.93C17.55,15.3 18.75,15.5 20,15.5A1,1 0,0 1,21 16.5V20A1,1 0,0 1,20 21A17,17 0,0 1,3 4A1,1 0,0 1,4 3H7.5A1,1 0,0 1,8.5 4C8.5,5.25 8.7,6.45 9.07,7.57C9.18,7.92 9.1,8.31 8.82,8.59L6.62,10.79Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/contacts/src/main/res/drawable/ic_launcher.xml b/contacts/src/main/res/drawable/ic_launcher.xml
new file mode 100644
index 0000000..d4d1eaf
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_launcher.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="15dp" 
+        android:top="15dp" 
+        android:right="15dp" 
+        android:bottom="15dp"
+        android:drawable="@drawable/ic_launcher_foreground"/>
+</layer-list>
diff --git a/contacts/src/main/res/drawable/ic_launcher_background.xml b/contacts/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..9486190
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="@color/colorPrimary"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/contacts/src/main/res/drawable/ic_launcher_disable.xml b/contacts/src/main/res/drawable/ic_launcher_disable.xml
new file mode 100644
index 0000000..9a31905
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_launcher_disable.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="15dp" 
+        android:top="15dp" 
+        android:right="15dp" 
+        android:bottom="15dp"
+        android:drawable="@drawable/ic_launcher_foreground_disable"/>
+</layer-list>
diff --git a/contacts/src/main/res/drawable/ic_launcher_foreground.xml b/contacts/src/main/res/drawable/ic_launcher_foreground.xml
new file mode 100644
index 0000000..872b04e
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_launcher_foreground.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M16.61,15.15C16.15,15.15 15.77,14.78 15.77,14.32S16.15,13.5 16.61,13.5H16.61C17.07,13.5 17.45,13.86 17.45,14.32C17.45,14.78 17.07,15.15 16.61,15.15M7.41,15.15C6.95,15.15 6.57,14.78 6.57,14.32C6.57,13.86 6.95,13.5 7.41,13.5H7.41C7.87,13.5 8.24,13.86 8.24,14.32C8.24,14.78 7.87,15.15 7.41,15.15M16.91,10.14L18.58,7.26C18.67,7.09 18.61,6.88 18.45,6.79C18.28,6.69 18.07,6.75 18,6.92L16.29,9.83C14.95,9.22 13.5,8.9 12,8.91C10.47,8.91 9,9.24 7.73,9.82L6.04,6.91C5.95,6.74 5.74,6.68 5.57,6.78C5.4,6.87 5.35,7.08 5.44,7.25L7.1,10.13C4.25,11.69 2.29,14.58 2,18H22C21.72,14.59 19.77,11.7 16.91,10.14H16.91Z"/>
+</vector>
diff --git a/contacts/src/main/res/drawable/ic_launcher_foreground_disable.xml b/contacts/src/main/res/drawable/ic_launcher_foreground_disable.xml
new file mode 100644
index 0000000..763b72c
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_launcher_foreground_disable.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#FFAAAAAA"
+        android:pathData="M16.61,15.15C16.15,15.15 15.77,14.78 15.77,14.32S16.15,13.5 16.61,13.5H16.61C17.07,13.5 17.45,13.86 17.45,14.32C17.45,14.78 17.07,15.15 16.61,15.15M7.41,15.15C6.95,15.15 6.57,14.78 6.57,14.32C6.57,13.86 6.95,13.5 7.41,13.5H7.41C7.87,13.5 8.24,13.86 8.24,14.32C8.24,14.78 7.87,15.15 7.41,15.15M16.91,10.14L18.58,7.26C18.67,7.09 18.61,6.88 18.45,6.79C18.28,6.69 18.07,6.75 18,6.92L16.29,9.83C14.95,9.22 13.5,8.9 12,8.91C10.47,8.91 9,9.24 7.73,9.82L6.04,6.91C5.95,6.74 5.74,6.68 5.57,6.78C5.4,6.87 5.35,7.08 5.44,7.25L7.1,10.13C4.25,11.69 2.29,14.58 2,18H22C21.72,14.59 19.77,11.7 16.91,10.14H16.91Z"/>
+</vector>
diff --git a/contacts/src/main/res/drawable/ic_phone_call_in.xml b/contacts/src/main/res/drawable/ic_phone_call_in.xml
new file mode 100644
index 0000000..792377d
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_phone_call_in.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="36dp"
+    android:height="36dp"
+    android:viewportHeight="1024"
+    android:viewportWidth="1024">
+    <path
+        android:fillColor="#fff"
+        android:pathData="M847.53,307.03L597.5,307.03c-8.54,0.17 -13.66,-11.26 -13.66,-19.97 0.17,-8.7 5.12,-14.17 13.66,-14.17h250.02c30.21,-0.34 31.41,34.14 0,34.14zM736.6,428.71c-6.14,6.32 -16.05,6.32 -22.02,0.17l-128.34,-130.56c-5.98,-6.14 -5.8,-16.22 0.17,-22.53l122.37,-124.76c6.14,-6.31 16.05,-6.31 22.02,-0.34 5.98,6.14 5.81,16.22 -0.34,22.36L623.1,289.62l113.5,116.22a16.33,16.33 0,0 1,0 22.87zM833.02,717.99c-18.78,-12.63 -122.37,-64.85 -141.99,-77.14 -2.05,0 -7.34,0.68 -14.85,4.43 -8.02,4.1 -31.23,16.9 -63.66,34.99l-25.26,14.16 -23.9,-16.38c-17.75,-12.11 -56.32,-41.3 -115.03,-98.64 -58.88,-57.69 -88.58,-95.23 -101.04,-112.47l-16.72,-23.38L345.09,418.82c13.99,-23.9 30.72,-52.9 35.84,-62.46 4.1,-7.51 4.44,-12.63 4.44,-14.17v-0.51C374.27,324.44 303.27,219.65 290.3,201.22c-1.88,-0.34 -5.8,0 -10.75,3.42 -40.28,28.5 -82.43,68.95 -88.41,84.65C195.24,373.42 270.85,491.52 404.48,622.25c133.8,130.73 251.22,205.49 336.9,209.41 16.22,-5.63 62.81,-52.05 91.65,-91.14 2.05,-2.9 3.24,-3.58 3.24,-6.99 0,-0.51 -3.07,-15.02 -3.24,-15.53zM867.5,770.73c-0.68,1.02 -81.58,108.03 -126.12,106.67 -125.1,-3.93 -265.73,-128.86 -366.94,-227.84 -101.38,-98.99 -225.45,-238.25 -229.38,-360.96v-1.02c0,-43.01 124.76,-128 125.78,-128.69 19.62,-13.14 36.35,-13.82 52.39,10.41 7.85,10.92 87.73,123.9 96.94,138.58 3.92,6.49 11.09,25.94 11.09,34.48 0,10.92 -3.24,23.21 -9.73,34.98 -6.31,11.61 -26.62,46.59 -36.69,63.83 10.92,15.19 46.76,61.44 103.94,117.25 56.83,55.63 85.16,72.19 100.69,82.77 17.58,-9.73 53.42,-29.7 65.2,-35.67 22.18,-11.44 44.37,-12.8 59.39,-3.42 14.16,8.7 136.02,88.41 147.79,96.6 10.93,7.68 16.9,21.67 16.9,36.69 0.17,11.78 -3.58,24.41 -11.26,35.33z" />
+</vector>
diff --git a/contacts/src/main/res/drawable/ic_phone_call_out.xml b/contacts/src/main/res/drawable/ic_phone_call_out.xml
new file mode 100644
index 0000000..833d25a
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_phone_call_out.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="36dp"
+    android:height="36dp"
+    android:viewportHeight="1024"
+    android:viewportWidth="1024">
+    <path
+        android:fillColor="#fff"
+        android:pathData="M861.86,307.03L614.4,307.03c-31.06,-0.17 -29.86,-34.48 0,-34.14h247.46c8.54,0.17 13.31,5.46 13.49,14.17 0,8.87 -4.95,20.14 -13.49,19.97zM872.96,298.5l-126.98,130.56c-5.98,6.14 -15.7,5.98 -21.85,-0.17 -6.14,-6.32 -6.14,-16.38 -0.17,-22.36l112.3,-116.22L730.11,173.74c-6.14,-6.31 -6.14,-16.38 -0.17,-22.35 5.97,-6.14 15.7,-5.98 21.84,0.34L872.96,276.48c5.8,5.8 5.98,15.87 0,22.02zM833.02,717.99c-18.78,-12.63 -122.37,-64.85 -141.99,-77.14 -2.05,0 -7.34,0.68 -14.85,4.43 -8.02,4.1 -31.23,16.9 -63.66,34.99l-25.26,14.16 -23.9,-16.38c-17.75,-12.11 -56.32,-41.3 -115.03,-98.64 -58.88,-57.69 -88.41,-95.23 -100.86,-112.47L330.75,443.56l14.5,-24.74c14,-23.9 30.72,-52.9 35.84,-62.46 4.1,-7.51 4.44,-12.63 4.44,-14.17v-0.51C374.44,324.44 303.45,219.65 290.3,201.22c-1.88,-0.34 -5.8,0 -10.75,3.42 -40.28,28.5 -82.43,68.95 -88.41,84.65C195.24,373.42 270.85,491.52 404.48,622.25c133.63,130.73 251.05,205.49 336.9,209.41 16.22,-5.63 62.81,-52.05 91.65,-91.14 2.05,-2.9 3.24,-3.58 3.24,-6.99 0,-0.51 -3.07,-15.02 -3.24,-15.53zM867.5,770.73c-0.68,1.02 -81.58,108.03 -126.12,106.67 -125.1,-3.93 -265.56,-128.86 -366.94,-227.84 -101.38,-98.99 -225.45,-238.25 -229.38,-360.96v-1.02c0,-43.01 124.76,-128 125.78,-128.69 19.62,-13.14 36.35,-13.82 52.39,10.41 7.85,10.92 87.73,123.9 96.94,138.58 4.1,6.49 11.09,25.94 11.09,34.48 0,10.92 -3.24,23.21 -9.73,34.98 -6.14,11.61 -26.62,46.59 -36.69,63.83 10.75,15.19 46.76,61.44 103.94,117.25 56.83,55.63 85.16,72.19 100.69,82.77 17.58,-9.73 53.42,-29.7 65.2,-35.67 22.18,-11.44 44.37,-12.8 59.39,-3.42 14.16,8.7 136.19,88.41 147.79,96.6 10.93,7.68 16.9,21.67 16.9,36.69 0.17,11.78 -3.58,24.41 -11.26,35.33z" />
+</vector>
diff --git a/contacts/src/main/res/drawable/ic_phone_hang_up.xml b/contacts/src/main/res/drawable/ic_phone_hang_up.xml
new file mode 100644
index 0000000..98b57b2
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_phone_hang_up.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="64dp"
+    android:height="64dp"
+    android:viewportHeight="1024"
+    android:viewportWidth="1024">
+    <path
+        android:fillColor="#201f1f"
+        android:pathData="M841.22,856.06c185.86,-185.86 185.86,-487.42 0,-673.79C655.36,-3.58 353.79,-3.58 167.42,182.27c-185.86,185.86 -185.86,487.42 0,673.79 186.37,185.86 487.94,185.86 673.79,0zM218.62,495.1c0,-47.62 111.1,-113.66 285.7,-113.66 175.1,0 285.7,66.05 285.7,113.66 0,40.96 10.75,102.4 -73.73,93.18 -84.48,-9.22 -78.85,-40.96 -78.85,-83.46 0,-29.7 -68.61,-36.35 -133.12,-36.35 -65.02,0 -133.12,6.66 -133.12,36.35 0,42.5 5.63,74.24 -78.85,83.46 -84.99,9.22 -73.73,-51.71 -73.73,-93.18z" />
+</vector>
diff --git a/contacts/src/main/res/drawable/ic_phone_pick_up.xml b/contacts/src/main/res/drawable/ic_phone_pick_up.xml
new file mode 100644
index 0000000..23080f1
--- /dev/null
+++ b/contacts/src/main/res/drawable/ic_phone_pick_up.xml
@@ -0,0 +1,30 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="64dp"
+    android:height="64dp"
+    android:viewportHeight="1024"
+    android:viewportWidth="1024">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M277.9,742s167.9,-294.1 465.3,-465.3C575.7,577.8 277.9,742 277.9,742z" />
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M743.1,742S575.2,447.9 277.8,276.7C445.3,577.8 743.1,742 743.1,742z" />
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M284.1,343m-49,0a49,49 0,1 0,98 0,49 49,0 1,0 -98,0Z" />
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M284.1,515.5m-49,0a49,49 0,1 0,98 0,49 49,0 1,0 -98,0Z" />
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M284.1,683.5m-49,0a49,49 0,1 0,98 0,49 49,0 1,0 -98,0Z" />
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M808.4,341.6s-208.5,-61.2 -420,0c211.5,64.8 420,0 420,0zM808.4,516.6s-208.5,-61.2 -420,0c211.5,64.8 420,0 420,0zM808.4,684.6s-208.5,-61.2 -420,0c211.5,64.8 420,0 420,0z" />
+    <path
+        android:fillColor="#0EC469"
+        android:pathData="M512,512m-448,0a448,448 0,1 0,896 0,448 448,0 1,0 -896,0Z" />
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M701.4,786.8h-0.3c-3.2,-0.3 -6.4,-0.8 -9.5,-1.4C290,725.2 237.2,331.5 237.2,331.5h0.1c-5.9,-27.8 0.8,-56.8 22.5,-78.5 9.5,-9.5 22.5,-18.1 31.3,-19.2l111.6,111.6c-1.1,8.8 -9.6,21.7 -19.1,31.2 -8.5,8.5 -17.9,14.4 -28.4,18.6 57.7,214.5 272.1,271.5 272.1,271.5l0.3,0.2c4.2,-10.5 9.6,-19.3 18.1,-27.8 9.5,-9.5 22.6,-18.1 31.4,-19.2l111.6,111.6c-1.1,8.8 -9.6,21.7 -19.1,31.2 -18.9,19 -43.4,26.3 -68.2,24.1z" />
+</vector>
diff --git a/contacts/src/main/res/drawable/recycler_view_border.xml b/contacts/src/main/res/drawable/recycler_view_border.xml
new file mode 100644
index 0000000..d538cab
--- /dev/null
+++ b/contacts/src/main/res/drawable/recycler_view_border.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <stroke
+        android:width="1dp"
+        android:color="#000000" /> <!-- 设置边框宽度和颜色，这里是黑色 1dp 边框 -->
+    <solid android:color="#ffffff" /> <!-- 设置背景颜色，这里是白色 -->
+</shape>
+
diff --git a/contacts/src/main/res/drawable/shape_gradient.xml b/contacts/src/main/res/drawable/shape_gradient.xml
new file mode 100644
index 0000000..c164fe9
--- /dev/null
+++ b/contacts/src/main/res/drawable/shape_gradient.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android">
+    <gradient
+        android:angle="180"
+        android:endColor="#FFFFFFFF"
+        android:startColor="#FFFFFFFF"
+        android:type="linear" />
+
+    <corners android:radius="10dp" />
+</shape>
diff --git a/contacts/src/main/res/layout/activity_about.xml b/contacts/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..425769a
--- /dev/null
+++ b/contacts/src/main/res/layout/activity_about.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <androidx.appcompat.widget.Toolbar
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+    <LinearLayout
+        android:orientation="vertical"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1.0"
+        android:id="@+id/aboutviewroot_ll"/>
+    
+</LinearLayout>
diff --git a/contacts/src/main/res/layout/activity_call.xml b/contacts/src/main/res/layout/activity_call.xml
new file mode 100644
index 0000000..460b416
--- /dev/null
+++ b/contacts/src/main/res/layout/activity_call.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:padding="16dp">
+
+    <EditText
+        android:id="@+id/phone_number"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="请输入电话号码"/>
+
+    <Button
+        android:id="@+id/dial_button"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="拨号"/>
+
+    <TextView
+        android:id="@+id/call_status"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:paddingTop="16dp"/>
+
+</LinearLayout>
diff --git a/contacts/src/main/res/layout/activity_dialer.xml b/contacts/src/main/res/layout/activity_dialer.xml
new file mode 100644
index 0000000..dc18c88
--- /dev/null
+++ b/contacts/src/main/res/layout/activity_dialer.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:padding="16dp">
+
+    <EditText
+        android:id="@+id/phone_number_edit_text"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="Enter phone number" />
+
+    <Button
+        android:id="@+id/dial_button"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="Dial" />
+
+</LinearLayout>
diff --git a/contacts/src/main/res/layout/activity_main.xml b/contacts/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..f06ae70
--- /dev/null
+++ b/contacts/src/main/res/layout/activity_main.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	xmlns:tools="http://schemas.android.com/tools"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<androidx.appcompat.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/activitymainToolbar1"/>
+
+	<cc.winboll.studio.libaes.views.ADsBannerView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/adsbanner"/>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:paddingTop="10dp"
+		android:paddingBottom="10dp">
+
+		<cc.winboll.studio.contacts.views.DunTemperatureView
+			android:layout_width="wrap_content"
+			android:layout_height="match_parent"
+			android:id="@+id/dun_temp_view_left"
+			android:layout_alignParentLeft="true"/>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/activitymainLinearLayout1"
+			android:layout_toRightOf="@id/dun_temp_view_left"
+			android:layout_toLeftOf="@id/dun_temp_view_right">
+
+			<androidx.viewpager.widget.ViewPager
+				android:layout_width="match_parent"
+				android:layout_height="0dp"
+				android:layout_weight="1.0"
+				android:id="@+id/viewPager"/>
+
+			<com.google.android.material.tabs.TabLayout
+				android:layout_width="match_parent"
+				android:layout_height="60dp"
+				android:id="@+id/tabLayout"/>
+
+		</LinearLayout>
+
+		<cc.winboll.studio.contacts.views.DunTemperatureView
+			android:layout_width="wrap_content"
+			android:layout_height="match_parent"
+			android:id="@+id/dun_temp_view_right"
+			android:layout_alignParentRight="true"/>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/activity_phone_call.xml b/contacts/src/main/res/layout/activity_phone_call.xml
new file mode 100644
index 0000000..327130c
--- /dev/null
+++ b/contacts/src/main/res/layout/activity_phone_call.xml
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:tools="http://schemas.android.com/tools"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical"
+	tools:context=".phonecallui.PhoneCallActivity">
+
+	<RelativeLayout
+		android:id="@+id/rl_user_info"
+		android:layout_width="match_parent"
+		android:layout_height="300dp"
+		android:background="@color/colorPrimaryDark"
+		android:layout_marginTop="100dp">
+
+		<TextView
+			android:id="@+id/tv_call_number_label"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:layout_above="@+id/tv_call_number"
+			android:layout_marginBottom="16dp"
+			android:gravity="center"
+			android:text="来电号码"
+			android:textColor="@android:color/white"
+			android:textSize="18sp"/>
+
+		<TextView
+			android:id="@+id/tv_call_number"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center"
+			android:textAlignment="center"
+			android:textColor="@android:color/white"
+			android:textSize="28sp"
+			android:textStyle="bold"
+			android:layout_centerInParent="true"
+			tools:text="133-9527-9527"/>
+
+	</RelativeLayout>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:background="@android:color/white">
+
+		<TextView
+			android:id="@+id/tv_phone_calling_time"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_centerHorizontal="true"
+			android:layout_marginTop="24dp"
+			android:text="通话中：01:33"
+			android:textColor="@android:color/black"
+			android:textSize="18sp"
+			android:visibility="gone"
+			tools:visibility="visible"/>
+
+		<RelativeLayout
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_centerInParent="true">
+
+			<TextView
+				android:id="@+id/tv_phone_hang_up"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:drawablePadding="16dp"
+				android:drawableTop="@drawable/ic_phone_hang_up"
+				android:foreground="?android:attr/selectableItemBackground"
+				android:gravity="center"
+				android:padding="8dp"
+				android:text="挂  断"
+				android:textColor="@android:color/black"
+				tools:visibility="visible"/>
+
+			<TextView
+				android:id="@+id/tv_phone_pick_up"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:layout_marginLeft="50dp"
+				android:layout_toRightOf="@id/tv_phone_hang_up"
+				android:drawablePadding="16dp"
+				android:drawableTop="@drawable/ic_phone_pick_up"
+				android:foreground="?android:attr/selectableItemBackground"
+				android:gravity="center"
+				android:padding="8dp"
+				android:text="接  听"
+				android:textColor="@android:color/black"
+				android:visibility="gone"
+				tools:visibility="visible"/>
+
+		</RelativeLayout>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/activity_settings.xml b/contacts/src/main/res/layout/activity_settings.xml
new file mode 100644
index 0000000..08335f9
--- /dev/null
+++ b/contacts/src/main/res/layout/activity_settings.xml
@@ -0,0 +1,382 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	xmlns:tools="http://schemas.android.com/tools"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content">
+
+		<androidx.appcompat.widget.Toolbar
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:id="@+id/activitymainToolbar1"/>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="0dp"
+			android:layout_weight="1.0">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="服务设置："/>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content">
+
+				<Switch
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="主要服务"
+					android:id="@+id/sw_mainservice"
+					android:layout_margin="5dp"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="云盾设置："/>
+
+				<cc.winboll.studio.contacts.views.DuInfoTextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:id="@+id/tv_DunInfo"/>
+
+			</LinearLayout>
+			
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="特殊通道设置："/>
+
+				<cc.winboll.studio.contacts.views.LimitedTimeSpecialChannelView
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:id="@+id/view_LimitedTimeSpecialChannel"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content">
+
+				<Switch
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="是否启用云盾防御"
+					android:layout_margin="5dp"
+					android:id="@+id/sw_IsEnableDun"
+					android:onClick="onSW_IsEnableDun"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="center_vertical">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="初始防御层的叠加数量："/>
+
+				<EditText
+					android:layout_width="0dp"
+					android:inputType="number"
+					android:layout_height="wrap_content"
+					android:ems="10"
+					android:layout_weight="1.0"
+					android:id="@+id/et_DunTotalCount"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="center_vertical">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="防御层每次恢复的时间间隔(秒钟)："/>
+
+				<EditText
+					android:layout_width="0dp"
+					android:inputType="number"
+					android:layout_height="wrap_content"
+					android:ems="10"
+					android:layout_weight="1.0"
+					android:id="@+id/et_DunResumeSecondCount"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="center_vertical">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="防御层每次恢复的叠加数量："/>
+
+				<EditText
+					android:layout_width="0dp"
+					android:inputType="number"
+					android:layout_height="wrap_content"
+					android:ems="10"
+					android:layout_weight="1.0"
+					android:id="@+id/et_DunResumeCount"/>
+
+			</LinearLayout>
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="应用权限设置："/>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right">
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="悬浮窗设置"
+					android:id="@+id/activitysettingsButton2"
+					android:onClick="onCanDrawOverlays"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="默认拨号设置"
+					android:id="@+id/activitysettingsButton1"
+					android:onClick="onDefaultPhone"/>
+
+			</LinearLayout>
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="音量设置："/>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="center_vertical">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:layout_marginLeft="10dp"
+					android:id="@+id/tv_volume"/>
+
+				<SeekBar
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:layout_margin="10dp"
+					android:max="100"
+					android:id="@+id/bellvolume"/>
+
+			</LinearLayout>
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="拨不通电话记录查询："/>
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right"
+				android:layout_margin="10dp">
+
+				<EditText
+					android:layout_width="match_parent"
+					android:ems="10"
+					android:layout_height="wrap_content"
+					android:id="@+id/bobulltoonurl_et"/>
+
+				<HorizontalScrollView
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content">
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content">
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="下载数据"
+							android:onClick="onDownloadBoBullToon"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="清空 BoBullToon 数据"
+							android:onClick="onCleanBoBullToonData"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="重置地址"
+							android:onClick="onResetBoBullToonURL"/>
+
+					</LinearLayout>
+
+				</HorizontalScrollView>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right|center_vertical"
+				android:layout_margin="10dp">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="查询电话："/>
+
+				<EditText
+					android:layout_width="0dp"
+					android:inputType="phone"
+					android:layout_height="wrap_content"
+					android:ems="10"
+					android:layout_weight="1.0"
+					android:id="@+id/activitysettingsEditText1"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="查询记录"
+					android:onClick="onSearchBoBullToonPhone"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content">
+
+				<TextView
+					android:layout_width="0dp"
+					android:layout_height="wrap_content"
+					android:text="Phone Connect Rule :"
+					android:layout_weight="1.0"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="添加新规则"
+					android:onClick="onAddNewConnectionRule"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="center_horizontal">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="&lt;&lt;==向左拉动列表项可编辑内容"/>
+
+			</LinearLayout>
+
+			<androidx.recyclerview.widget.RecyclerView
+				android:id="@+id/recycler_view"
+				android:layout_width="match_parent"
+				android:layout_height="300dp"
+				android:background="@drawable/recycler_view_border"
+				android:layout_margin="5dp"/>
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="单元测试："/>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right">
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="LogView"
+					android:onClick="onLogView"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="Unit Test"
+					android:onClick="onUnitTest"/>
+
+			</LinearLayout>
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="其他："/>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right">
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="关于应用"
+					android:onClick="onAbout"/>
+
+			</LinearLayout>
+
+			<cc.winboll.studio.libaes.views.ADsControlView
+				android:id="@+id/ads_control_view"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content" />
+
+		</LinearLayout>
+
+	</LinearLayout>
+
+</ScrollView>
+
diff --git a/contacts/src/main/res/layout/activity_unittest.xml b/contacts/src/main/res/layout/activity_unittest.xml
new file mode 100644
index 0000000..c2e50cd
--- /dev/null
+++ b/contacts/src/main/res/layout/activity_unittest.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="right">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Add Demo Rules(While size is 0) and Test"
+			android:onClick="onTestMain"
+			android:textSize="10sp"
+			android:textAllCaps="false"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="测试号码："/>
+
+		<EditText
+			android:layout_width="0dp"
+			android:inputType="phone"
+			android:layout_height="wrap_content"
+			android:ems="10"
+			android:layout_weight="1.0"
+			android:id="@+id/phone_et"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Test Phone"
+			android:onClick="onTestPhone"
+			android:textAllCaps="false"/>
+
+	</LinearLayout>
+
+	<cc.winboll.studio.libappbase.LogView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/logview"/>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/fragment_call_log.xml b/contacts/src/main/res/layout/fragment_call_log.xml
new file mode 100644
index 0000000..32fcbf0
--- /dev/null
+++ b/contacts/src/main/res/layout/fragment_call_log.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/recyclerView"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent" />
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/fragment_contacts.xml b/contacts/src/main/res/layout/fragment_contacts.xml
new file mode 100644
index 0000000..77f06a6
--- /dev/null
+++ b/contacts/src/main/res/layout/fragment_contacts.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content">
+
+		<EditText
+			android:id="@+id/search_edit_text"
+			android:layout_width="0dp"
+			android:layout_height="wrap_content"
+			android:hint="Search contacts"
+			android:padding="16dp"
+			android:layout_weight="1.0"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Dial"
+			android:id="@+id/btn_dial"/>
+
+	</LinearLayout>
+
+	<androidx.recyclerview.widget.RecyclerView
+		android:id="@+id/contacts_recycler_view"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"/>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/fragment_log.xml b/contacts/src/main/res/layout/fragment_log.xml
new file mode 100644
index 0000000..7636182
--- /dev/null
+++ b/contacts/src/main/res/layout/fragment_log.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+     <cc.winboll.studio.libappbase.LogView
+            android:layout_height="match_parent"
+            android:layout_width="match_parent"
+            android:id="@+id/logview"/>
+</LinearLayout>
diff --git a/contacts/src/main/res/layout/item_call_log.xml b/contacts/src/main/res/layout/item_call_log.xml
new file mode 100644
index 0000000..0f19546
--- /dev/null
+++ b/contacts/src/main/res/layout/item_call_log.xml
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content">
+
+		<TextView
+			android:id="@+id/phone_number"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:textSize="18sp"
+			android:textStyle="bold"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content">
+
+		<TextView
+			android:id="@+id/call_status"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="14sp"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content">
+
+		<TextView
+			android:id="@+id/call_date"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="14sp"/>
+
+	</LinearLayout>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:padding="10dp">
+
+		<View
+			android:layout_width="20dp"
+			android:layout_height="20dp"
+			android:background="#FFE7E7E7"
+			android:id="@+id/itemcalllogView1"
+			android:layout_alignParentLeft="true"/>
+
+		<cc.winboll.studio.libaes.views.AOHPCTCSeekBar
+			android:layout_toRightOf="@id/itemcalllogView1"
+			android:layout_toLeftOf="@id/itemcalllogView2"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:id="@+id/aohpctcseekbar_dial"/>
+
+		<View
+			android:layout_width="20dp"
+			android:layout_height="20dp"
+			android:background="#FFE7E7E7"
+			android:id="@+id/itemcalllogView2"
+			android:layout_alignParentRight="true"/>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/item_contact.xml b/contacts/src/main/res/layout/item_contact.xml
new file mode 100644
index 0000000..0006eaa
--- /dev/null
+++ b/contacts/src/main/res/layout/item_contact.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:orientation="vertical">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/itemcontactLinearLayout1">
+
+		<TextView
+			android:id="@+id/contact_number"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="18sp"
+			android:textStyle="bold"/>
+
+		<TextView
+			android:id="@+id/contact_number"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="18sp"
+			android:text="☎"
+			android:textStyle="bold"/>
+
+		<TextView
+			android:id="@+id/contact_name"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="18sp"
+			android:textStyle="bold"/>
+
+	</LinearLayout>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:padding="10dp">
+
+		<View
+			android:layout_width="20dp"
+			android:layout_height="20dp"
+			android:background="#FFE7E7E7"
+			android:id="@+id/itemcalllogView1"
+			android:layout_alignParentLeft="true"/>
+
+		<cc.winboll.studio.libaes.views.AOHPCTCSeekBar
+			android:layout_toRightOf="@id/itemcalllogView1"
+			android:layout_toLeftOf="@id/itemcalllogView2"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:id="@+id/aohpctcseekbar_dial"/>
+
+		<View
+			android:layout_width="20dp"
+			android:layout_height="20dp"
+			android:background="#FFE7E7E7"
+			android:id="@+id/itemcalllogView2"
+			android:layout_alignParentRight="true"/>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/view_left_scroll.xml b/contacts/src/main/res/layout/view_left_scroll.xml
new file mode 100644
index 0000000..b06c552
--- /dev/null
+++ b/contacts/src/main/res/layout/view_left_scroll.xml
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="horizontal">
+
+    <!-- 内容区域 -->
+    <LinearLayout
+        android:id="@+id/content_layout"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:padding="16dp"
+        android:background="@color/white">
+        <!-- 这里放置你的列表项内容 -->
+    </LinearLayout>
+
+    <!-- 操作按钮 -->
+    <LinearLayout
+        android:id="@+id/action_layout"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:background="@color/lightgray">
+
+        <Button
+            android:id="@+id/edit_btn"
+            android:layout_width="80dp"
+            android:layout_height="wrap_content"
+            android:text="编辑"
+            android:background="@color/blue" />
+        <Button
+            android:id="@+id/up_btn"
+            android:layout_width="40dp"
+            android:layout_height="wrap_content"
+            android:text="△"
+            android:background="@color/green" />
+        <Button
+            android:id="@+id/down_btn"
+            android:layout_width="40dp"
+            android:layout_height="wrap_content"
+            android:text="▽"
+            android:background="@color/green" />
+        <Button
+            android:id="@+id/delete_btn"
+            android:layout_width="80dp"
+            android:layout_height="wrap_content"
+            android:text="删除"
+            android:background="@color/red" />
+    </LinearLayout>
+</LinearLayout>
diff --git a/contacts/src/main/res/layout/view_limitedtimespecialchannel.xml b/contacts/src/main/res/layout/view_limitedtimespecialchannel.xml
new file mode 100644
index 0000000..da6d713
--- /dev/null
+++ b/contacts/src/main/res/layout/view_limitedtimespecialchannel.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:gravity="center_vertical|center_horizontal"
+	android:id="@+id/ll_main">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="总倒计时:"/>
+
+		<EditText
+			android:layout_width="85dp"
+			android:inputType="number"
+			android:layout_height="wrap_content"
+			android:ems="10"
+			android:text="3600"
+			android:id="@+id/et_seconds"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="秒"/>
+
+		<Switch
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:id="@+id/sw_enable"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content">
+
+		<Button
+			android:layout_width="40dp"
+			android:layout_height="40dp"
+			android:text="-"
+			android:id="@+id/btn_subSeconds"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="40dp"
+			android:text="3600秒"
+			android:id="@+id/btn_thisSeconds"/>
+
+		<Button
+			android:layout_width="40dp"
+			android:layout_height="40dp"
+			android:text="+"
+			android:id="@+id/btn_addSeconds"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/view_phone_call.xml b/contacts/src/main/res/layout/view_phone_call.xml
new file mode 100644
index 0000000..5036c76
--- /dev/null
+++ b/contacts/src/main/res/layout/view_phone_call.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:id="@+id/rl_user_info"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:background="@color/colorPrimary">
+
+    <TextView
+        android:id="@+id/tv_call_number"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_centerHorizontal="true"
+        android:layout_marginTop="30dp"
+        android:gravity="center"
+        android:textAlignment="center"
+        android:textColor="@android:color/white"
+        android:textSize="18sp"
+        tools:text="133-8892-9579" />
+
+    <Button
+        android:id="@+id/btn_open_app"
+        style="@style/Base.Widget.AppCompat.Button.Borderless.Colored"
+        android:layout_width="match_parent"
+        android:textColor="@android:color/white"
+        android:layout_height="wrap_content"
+        android:layout_below="@id/tv_call_number"
+        android:gravity="center"
+        android:text="打开 Phone Call App"
+        android:textAlignment="center"
+        android:textSize="16sp" />
+
+</RelativeLayout>
\ No newline at end of file
diff --git a/contacts/src/main/res/layout/view_phone_connect_rule.xml b/contacts/src/main/res/layout/view_phone_connect_rule.xml
new file mode 100644
index 0000000..89310cc
--- /dev/null
+++ b/contacts/src/main/res/layout/view_phone_connect_rule.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:padding="16dp">
+
+	<EditText
+		android:id="@+id/edit_text"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:hint="请输入规则文本"/>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="right|center_vertical">
+
+		<CheckBox
+			android:id="@+id/checkbox_allow"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="连接"/>
+
+        <CheckBox
+            android:id="@+id/checkbox_enable"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="启用"/>
+
+        <Button
+            android:id="@+id/button_confirm"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="确定"/>
+        
+	</LinearLayout>
+
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/view_phone_connect_rule_simple.xml b/contacts/src/main/res/layout/view_phone_connect_rule_simple.xml
new file mode 100644
index 0000000..4c59751
--- /dev/null
+++ b/contacts/src/main/res/layout/view_phone_connect_rule_simple.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:orientation="horizontal"
+	android:padding="2dp">
+
+	<cc.winboll.studio.contacts.views.LeftScrollView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/scrollView"/>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/view_phone_connect_rule_simple_content.xml b/contacts/src/main/res/layout/view_phone_connect_rule_simple_content.xml
new file mode 100644
index 0000000..a3a0d16
--- /dev/null
+++ b/contacts/src/main/res/layout/view_phone_connect_rule_simple_content.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:layout_gravity="center_vertical"
+	android:gravity="center_vertical">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Text"
+		android:layout_weight="1.0"
+		android:id="@+id/ruletext_tv"/>
+
+	<CheckBox
+		android:id="@+id/checkbox_allow"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="连接"
+		android:clickable="false"
+		android:focusable="false"/>
+
+	<CheckBox
+		android:id="@+id/checkbox_enable"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="启用"
+		android:clickable="false"
+		android:focusable="false"/>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/layout/view_toast.xml b/contacts/src/main/res/layout/view_toast.xml
new file mode 100644
index 0000000..d6a9915
--- /dev/null
+++ b/contacts/src/main/res/layout/view_toast.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:background="@drawable/shape_gradient"
+    android:gravity="center"
+    android:orientation="vertical"
+    android:padding="10dp">
+    
+    <LinearLayout
+        android:orientation="horizontal"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content">
+
+        <ImageView
+            android:layout_width="40dp"
+            android:layout_height="40dp"
+            android:src="@drawable/ic_launcher"/>
+
+        <TextView
+            android:id="@android:id/message"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:layout_margin="10dp"
+            android:textColor="#FF000000"
+            android:textSize="16sp"/>
+
+    </LinearLayout>
+
+</LinearLayout>
diff --git a/contacts/src/main/res/layout/widget_layout.xml b/contacts/src/main/res/layout/widget_layout.xml
new file mode 100644
index 0000000..0dc6b46
--- /dev/null
+++ b/contacts/src/main/res/layout/widget_layout.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="40dp"
+	android:layout_height="40dp">
+
+	<ImageView
+		android:layout_width="40dp"
+		android:layout_height="40dp"
+		android:id="@+id/widgetlayoutImageView1"/>
+
+</LinearLayout>
+
diff --git a/contacts/src/main/res/menu/toolbar_calllog_phonenumber.xml b/contacts/src/main/res/menu/toolbar_calllog_phonenumber.xml
new file mode 100644
index 0000000..2626dd9
--- /dev/null
+++ b/contacts/src/main/res/menu/toolbar_calllog_phonenumber.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    <item
+        android:id="@+id/item_calllog_phonenumber_copy"
+        android:title="Copy"/>
+    <item
+        android:id="@+id/item_calllog_phonenumber_yundun_test"
+        android:title="YunDun Test"/>
+    <item
+        android:id="@+id/item_calllog_phonenumber_add_contact"
+        android:title="Add Contact"/>
+    
+</menu>
diff --git a/contacts/src/main/res/menu/toolbar_contact_phonenumber.xml b/contacts/src/main/res/menu/toolbar_contact_phonenumber.xml
new file mode 100644
index 0000000..3e4a9e9
--- /dev/null
+++ b/contacts/src/main/res/menu/toolbar_contact_phonenumber.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <item
+        android:id="@+id/item_contact_phonenumber_copy"
+        android:title="Copy"/>
+    <item
+        android:id="@+id/item_calllog_phonenumber_edit_contact"
+        android:title="Edit Contact"/>
+    
+</menu>
diff --git a/contacts/src/main/res/menu/toolbar_main.xml b/contacts/src/main/res/menu/toolbar_main.xml
new file mode 100644
index 0000000..00359d9
--- /dev/null
+++ b/contacts/src/main/res/menu/toolbar_main.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/item_settings"
+        android:title="Settings"
+        app:showAsAction="ifRoom"/>
+</menu>
diff --git a/contacts/src/main/res/values/colors.xml b/contacts/src/main/res/values/colors.xml
new file mode 100644
index 0000000..5b13816
--- /dev/null
+++ b/contacts/src/main/res/values/colors.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- WinBoLL 默认方案 -->
+    <color name="colorPrimary">#FF196ABC</color>
+    <color name="colorPrimaryDark">#FF002B57</color>
+    <color name="colorAccent">#FF80BFFF</color>
+    <color name="blue">#FF379AFF</color>
+    <color name="green">#FF69E551</color>
+    <color name="red">#FFE55151</color>
+    <color name="white">#FFFFFFFF</color>
+    <color name="lightgray">#FFE0E0E0</color>
+    
+</resources>
diff --git a/contacts/src/main/res/values/strings.xml b/contacts/src/main/res/values/strings.xml
new file mode 100644
index 0000000..8817cbe
--- /dev/null
+++ b/contacts/src/main/res/values/strings.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">Contacts</string>
+    <string name="default_bobulltoon_url">https://gitea.winboll.cc/Studio/BoBullToon/archive/main.zip</string>
+
+</resources>
diff --git a/contacts/src/main/res/values/styles.xml b/contacts/src/main/res/values/styles.xml
new file mode 100644
index 0000000..fecdea6
--- /dev/null
+++ b/contacts/src/main/res/values/styles.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- 方案1：无 ActionBar 主题（推荐，适合自定义标题栏） -->
+    <style name="MyAppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+        <item name="android:windowFullscreen">false</item>
+        <item name="android:windowContentOverlay">@null</item>
+
+    </style>
+
+    <style name="GlobalCrashActivityTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
+        <item name="colorTittle">@color/colorAccent</item>
+        <item name="colorTittleBackgound">@color/colorPrimary</item>
+        <item name="colorText">@color/colorAccent</item>
+        <item name="colorTextBackgound">@color/colorPrimaryDark</item>
+
+    </style>
+
+    <!-- 方案2：带 ActionBar 主题（如需系统默认标题栏，启用此方案） -->
+    <!--
+    <style name="MyAppTheme" parent="Theme.MaterialComponents.Light">
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+        <item name="android:windowFullscreen">true</item>
+        <item name="android:windowContentOverlay">@null</item>
+
+        <item name="android:textSizeHeadline">18sp</item>
+        <item name="android:textSizeBody">16sp</item>
+        <item name="android:textSizeSubtitle">14sp</item>
+        <item name="android:textSizeCaption">12sp</item>
+    </style>
+
+    <style name="GlobalCrashActivityTheme" parent="Theme.MaterialComponents.Light">
+        <item name="colorTittle">@color/colorAccent</item>
+        <item name="colorTittleBackgound">@color/colorPrimary</item>
+        <item name="colorText">@color/colorAccent</item>
+        <item name="colorTextBackgound">@color/colorPrimaryDark</item>
+
+        <item name="android:textSizeHeadline">20sp</item>
+        <item name="android:textSizeBody">14sp</item>
+        <item name="android:textSizeButton">16sp</item>
+    </style>
+    -->
+</resources>
+
diff --git a/contacts/src/main/res/xml/appwidget_provider_info.xml b/contacts/src/main/res/xml/appwidget_provider_info.xml
new file mode 100644
index 0000000..7dda9ab
--- /dev/null
+++ b/contacts/src/main/res/xml/appwidget_provider_info.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+    android:minWidth="40dp"
+    android:minHeight="40dp"
+    android:updatePeriodMillis="0"
+    android:initialLayout="@layout/widget_layout"
+    android:resizeMode="none">
+</appwidget-provider>
diff --git a/contacts/src/main/res/xml/file_provider.xml b/contacts/src/main/res/xml/file_provider.xml
new file mode 100644
index 0000000..f045677
--- /dev/null
+++ b/contacts/src/main/res/xml/file_provider.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths>
+    <external-path
+        name="external_storage_root"
+        path="." />
+    <files-path
+        name="files_path"
+        path="." />
+    <cache-path
+        name="cache_path"
+        path="." />
+    <!--/storage/emulated/0/Android/data/...-->
+    <external-files-path
+        name="external_file_path"
+        path="." />
+    <!--代表app 外部存储区域根目录下的文件 Context.getExternalCacheDir目录下的目录-->
+    <external-cache-path
+        name="external_cache_path"
+        path="." />
+    <!--配置root-path。这样子可以读取到sd卡和一些应用分身的目录，否则微信分身保存的图片，就会导致 java.lang.IllegalArgumentException: Failed to find configured root that contains /storage/emulated/999/tencent/MicroMsg/WeiXin/export1544062754693.jpg，在小米6的手机上微信分身有这个crash，华为没有
+    -->
+    <root-path
+        name="root_path"
+        path="" />
+</paths>
diff --git a/contacts/src/main/res/xml/network_security_config.xml b/contacts/src/main/res/xml/network_security_config.xml
new file mode 100644
index 0000000..9d70815
--- /dev/null
+++ b/contacts/src/main/res/xml/network_security_config.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">winboll.cc</domain>
+    </domain-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="false">10.8.0.12</domain>
+    </domain-config>
+</network-security-config>
diff --git a/contacts/src/stage/AndroidManifest.xml b/contacts/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/contacts/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/contacts/src/stage/res/values/strings.xml b/contacts/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/contacts/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/debugtemp/README.md b/debugtemp/README.md
new file mode 100644
index 0000000..070f4b4
--- /dev/null
+++ b/debugtemp/README.md
@@ -0,0 +1,37 @@
+# WinBoLL
+
+#### 介绍
+WinBoLL 应用编译功能临时调试项目
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh debugtemp
+
+#### 使用说明
+3. Termux应用配置：
+- 已安装Termux（包名 com.termux ）；
+- 执行  echo "allow-external-apps = true" > ~/.termux/termux.properties
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/debugtemp/app_update_description.txt b/debugtemp/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/debugtemp/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/debugtemp/build.gradle b/debugtemp/build.gradle
new file mode 100644
index 0000000..12e9985
--- /dev/null
+++ b/debugtemp/build.gradle
@@ -0,0 +1,120 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.debugtemp"
+	    minSdkVersion 23
+		// 适配MIUI12
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.0"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+	
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['libs'] // 若SO库放在libs目录下
+        }
+    }
+}
+
+dependencies {
+	api project(':libdebugtemp')
+    
+    api 'com.google.code.gson:gson:2.10.1'
+	
+	// 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// OkHttp网络请求
+     implementation 'com.squareup.okhttp3:okhttp:3.14.9'
+     // FastJSON解析
+     implementation 'com.alibaba:fastjson:1.2.76'
+    
+	// AndroidX 类库
+    /*api 'androidx.appcompat:appcompat:1.1.0'
+    //api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'*/
+	
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+
+	implementation "androidx.annotation:annotation:1.3.0"
+    implementation "androidx.core:core:1.6.0"
+    implementation "androidx.drawerlayout:drawerlayout:1.1.1"
+    implementation "androidx.preference:preference:1.1.1"
+    implementation "androidx.viewpager:viewpager:1.0.0"
+    implementation "com.google.android.material:material:1.4.0"
+    implementation "com.google.guava:guava:24.1-jre"
+    /*
+	implementation "io.noties.markwon:core:$markwonVersion"
+    implementation "io.noties.markwon:ext-strikethrough:$markwonVersion"
+    implementation "io.noties.markwon:linkify:$markwonVersion"
+    implementation "io.noties.markwon:recycler:$markwonVersion"
+	*/
+	implementation 'com.termux:terminal-emulator:0.118.0'
+	implementation 'com.termux:terminal-view:0.118.0'
+	implementation 'com.termux:termux-shared:0.118.0'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.2'
+    api 'cc.winboll.studio:libappbase:15.15.11'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.15.7'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.4'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/debugtemp/build.properties b/debugtemp/build.properties
new file mode 100644
index 0000000..9805e56
--- /dev/null
+++ b/debugtemp/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Fri May 01 17:09:11 HKT 2026
+stageCount=57
+libraryProject=libdebugtemp
+baseVersion=15.0
+publishVersion=15.0.56
+buildCount=0
+baseBetaVersion=15.0.57
diff --git a/debugtemp/proguard-rules.pro b/debugtemp/proguard-rules.pro
new file mode 100644
index 0000000..a18de74
--- /dev/null
+++ b/debugtemp/proguard-rules.pro
@@ -0,0 +1,137 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/debugtemp/src/beta/AndroidManifest.xml b/debugtemp/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/debugtemp/src/beta/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/debugtemp/src/beta/res/values/strings.xml b/debugtemp/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..c7757f1
--- /dev/null
+++ b/debugtemp/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">DebugTemp☆</string>
+
+</resources>
diff --git a/debugtemp/src/main/AndroidManifest.xml b/debugtemp/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..9056a79
--- /dev/null
+++ b/debugtemp/src/main/AndroidManifest.xml
@@ -0,0 +1,37 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.debugtemp">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:resizeableActivity="true"
+        android:name=".App">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name=".GlobalApplication$CrashActivity"/>
+
+    </application>
+
+</manifest>
diff --git a/debugtemp/src/main/java/cc/winboll/studio/debugtemp/App.java b/debugtemp/src/main/java/cc/winboll/studio/debugtemp/App.java
new file mode 100644
index 0000000..a2d9d99
--- /dev/null
+++ b/debugtemp/src/main/java/cc/winboll/studio/debugtemp/App.java
@@ -0,0 +1,340 @@
+package cc.winboll.studio.debugtemp;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.res.Resources;
+import android.graphics.Typeface;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.util.Log;
+import android.view.Gravity;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+import android.widget.HorizontalScrollView;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Arrays;
+import java.util.Date;
+import java.util.LinkedHashMap;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+public class App extends GlobalApplication {
+
+    private static Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+		
+        //CrashHandler.getInstance().registerGlobal(this);
+        //CrashHandler.getInstance().registerPart(this);
+    }
+
+    public static void write(InputStream input, OutputStream output) throws IOException {
+        byte[] buf = new byte[1024 * 8];
+        int len;
+        while ((len = input.read(buf)) != -1) {
+            output.write(buf, 0, len);
+        }
+    }
+
+    public static void write(File file, byte[] data) throws IOException {
+        File parent = file.getParentFile();
+        if (parent != null && !parent.exists()) parent.mkdirs();
+
+        ByteArrayInputStream input = new ByteArrayInputStream(data);
+        FileOutputStream output = new FileOutputStream(file);
+        try {
+            write(input, output);
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static String toString(InputStream input) throws IOException {
+        ByteArrayOutputStream output = new ByteArrayOutputStream();
+        write(input, output);
+        try {
+            return output.toString("UTF-8");
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static void closeIO(Closeable... closeables) {
+        for (Closeable closeable : closeables) {
+            try {
+                if (closeable != null) closeable.close();
+            } catch (IOException ignored) {}
+        }
+    }
+
+    public static class CrashHandler {
+
+        public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+
+        private static CrashHandler sInstance;
+
+        private PartCrashHandler mPartCrashHandler;
+
+        public static CrashHandler getInstance() {
+            if (sInstance == null) {
+                sInstance = new CrashHandler();
+            }
+            return sInstance;
+        }
+
+        public void registerGlobal(Context context) {
+            registerGlobal(context, null);
+        }
+
+        public void registerGlobal(Context context, String crashDir) {
+            Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandlerImpl(context.getApplicationContext(), crashDir));
+        }
+
+        public void unregister() {
+            Thread.setDefaultUncaughtExceptionHandler(DEFAULT_UNCAUGHT_EXCEPTION_HANDLER);
+        }
+
+        public void registerPart(Context context) {
+            unregisterPart(context);
+            mPartCrashHandler = new PartCrashHandler(context.getApplicationContext());
+            MAIN_HANDLER.postAtFrontOfQueue(mPartCrashHandler);
+        }
+
+        public void unregisterPart(Context context) {
+            if (mPartCrashHandler != null) {
+                mPartCrashHandler.isRunning.set(false);
+                mPartCrashHandler = null;
+            }
+        }
+
+        private static class PartCrashHandler implements Runnable {
+
+            private final Context mContext;
+
+            public AtomicBoolean isRunning = new AtomicBoolean(true);
+
+            public PartCrashHandler(Context context) {
+                this.mContext = context;
+            }
+
+            @Override
+            public void run() {
+                while (isRunning.get()) {
+                    try {
+                        Looper.loop();
+                    } catch (final Throwable e) {
+                        e.printStackTrace();
+                        if (isRunning.get()) {
+                            MAIN_HANDLER.post(new Runnable(){
+
+                                    @Override
+                                    public void run() {
+                                        Toast.makeText(mContext, e.toString(), Toast.LENGTH_LONG).show();
+                                    }
+                                });
+                        } else {
+                            if (e instanceof RuntimeException) {
+                                throw (RuntimeException)e;
+                            } else {
+                                throw new RuntimeException(e);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        private static class UncaughtExceptionHandlerImpl implements UncaughtExceptionHandler {
+
+            private static DateFormat DATE_FORMAT = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss");
+
+            private final Context mContext;
+
+            private final File mCrashDir;
+
+            public UncaughtExceptionHandlerImpl(Context context, String crashDir) {
+                this.mContext = context;
+                this.mCrashDir = TextUtils.isEmpty(crashDir) ? new File(mContext.getExternalCacheDir(), "crash") : new File(crashDir);
+            }
+
+            @Override
+            public void uncaughtException(Thread thread, Throwable throwable) {
+                try {
+
+                    String log = buildLog(throwable);
+                    writeLog(log);
+
+                    try {
+                        Intent intent = new Intent(mContext, CrashActivity.class);
+                        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                        intent.putExtra(Intent.EXTRA_TEXT, log);
+                        mContext.startActivity(intent);
+                    } catch (Throwable e) {
+                        e.printStackTrace();
+                        writeLog(e.toString());
+                    }
+
+                    throwable.printStackTrace();
+                    android.os.Process.killProcess(android.os.Process.myPid());
+                    System.exit(0);
+
+                } catch (Throwable e) {
+                    if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+                }
+            }
+
+            private String buildLog(Throwable throwable) {
+                String time = DATE_FORMAT.format(new Date());
+
+                String versionName = "unknown";
+                long versionCode = 0;
+                try {
+                    PackageInfo packageInfo = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0);
+                    versionName = packageInfo.versionName;
+                    versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+                } catch (Throwable ignored) {}
+
+                LinkedHashMap<String, String> head = new LinkedHashMap<String, String>();
+                head.put("Time Of Crash", time);
+                head.put("Device", String.format("%s, %s", Build.MANUFACTURER, Build.MODEL));
+                head.put("Android Version", String.format("%s (%d)", Build.VERSION.RELEASE, Build.VERSION.SDK_INT));
+                head.put("App Version", String.format("%s (%d)", versionName, versionCode));
+                head.put("Kernel", getKernel());
+                head.put("Support Abis", Build.VERSION.SDK_INT >= 21 && Build.SUPPORTED_ABIS != null ? Arrays.toString(Build.SUPPORTED_ABIS): "unknown");
+                head.put("Fingerprint", Build.FINGERPRINT);
+
+                StringBuilder builder = new StringBuilder();
+
+                for (String key : head.keySet()) {
+                    if (builder.length() != 0) builder.append("\n");
+                    builder.append(key);
+                    builder.append(" :    ");
+                    builder.append(head.get(key));
+                }
+
+                builder.append("\n\n");
+                builder.append(Log.getStackTraceString(throwable));
+
+                return builder.toString(); 
+            }
+
+            private void writeLog(String log) {
+                String time = DATE_FORMAT.format(new Date());
+                File file = new File(mCrashDir, "crash_" + time + ".txt");
+                try {
+                    write(file, log.getBytes("UTF-8"));
+                } catch (Throwable e) {
+                    e.printStackTrace();
+                } 
+            }
+
+            private static String getKernel() {
+                try {
+                    return App.toString(new FileInputStream("/proc/version")).trim();
+                } catch (Throwable e) {
+                    return e.getMessage();
+                }
+            }
+        }
+    }
+
+    public static final class CrashActivity extends Activity {
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+
+            setTheme(android.R.style.Theme_DeviceDefault);
+            setTitle("App Crash");
+
+            mLog = getIntent().getStringExtra(Intent.EXTRA_TEXT);
+
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+
+            HorizontalScrollView horizontalScrollView = new HorizontalScrollView(this);
+
+            TextView textView = new TextView(this);
+            int padding = dp2px(16);
+            textView.setPadding(padding, padding, padding, padding);
+            textView.setText(mLog);
+            textView.setTextIsSelectable(true);
+            textView.setTypeface(Typeface.DEFAULT);
+            textView.setLinksClickable(true);
+
+            horizontalScrollView.addView(textView);
+            contentView.addView(horizontalScrollView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+
+            setContentView(contentView);
+        }
+
+        private void restart() {
+            Intent intent = getPackageManager().getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        private static int dp2px(float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(Menu menu) {
+            menu.add(0, android.R.id.copy, 0, android.R.string.copy)
+                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+            return super.onCreateOptionsMenu(menu);
+        }
+
+        @Override
+        public boolean onOptionsItemSelected(MenuItem item) {
+            switch (item.getItemId()) {
+                case android.R.id.copy:
+                    ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+                    return true;
+            }
+            return super.onOptionsItemSelected(item);
+        }
+
+        @Override
+        public void onBackPressed() {
+            restart();
+        }
+    }
+}
diff --git a/debugtemp/src/main/java/cc/winboll/studio/debugtemp/MainActivity.java b/debugtemp/src/main/java/cc/winboll/studio/debugtemp/MainActivity.java
new file mode 100644
index 0000000..4f5927b
--- /dev/null
+++ b/debugtemp/src/main/java/cc/winboll/studio/debugtemp/MainActivity.java
@@ -0,0 +1,38 @@
+package cc.winboll.studio.debugtemp;
+
+import android.content.Intent;
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.LibraryActivity;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class MainActivity extends AppCompatActivity {
+
+	LogView mLogView;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+		Toolbar toolbar=(Toolbar)findViewById(R.id.toolbar);
+		setSupportActionBar(toolbar);
+
+        mLogView = findViewById(R.id.logview);
+
+        ToastUtils.show("onCreate");
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        mLogView.start();
+    }
+
+    public void onLibraryActivity(View view) {
+		startActivity(new Intent(this, LibraryActivity.class));
+    }
+}
diff --git a/debugtemp/src/main/res/drawable-v24/ic_launcher_foreground.xml b/debugtemp/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 0000000..c7bd21d
--- /dev/null
+++ b/debugtemp/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1" />
+</vector>
diff --git a/debugtemp/src/main/res/drawable/ic_launcher_background.xml b/debugtemp/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..d5fccc5
--- /dev/null
+++ b/debugtemp/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>
diff --git a/debugtemp/src/main/res/layout/activity_main.xml b/debugtemp/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..ee193ec
--- /dev/null
+++ b/debugtemp/src/main/res/layout/activity_main.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical">
+
+	<com.google.android.material.appbar.AppBarLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+
+		<androidx.appcompat.widget.Toolbar
+			android:id="@+id/toolbar"
+			android:layout_width="match_parent"
+			android:layout_height="?attr/actionBarSize"
+			app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+	</com.google.android.material.appbar.AppBarLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:gravity="center_vertical|center_horizontal">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="DebugTemp"
+			android:textAppearance="?android:attr/textAppearanceLarge"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Open LibraryActivity"
+			android:onClick="onLibraryActivity"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<cc.winboll.studio.libappbase.LogView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/logview"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/debugtemp/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/debugtemp/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/debugtemp/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/debugtemp/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/debugtemp/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/debugtemp/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/debugtemp/src/main/res/mipmap-hdpi/ic_launcher.png b/debugtemp/src/main/res/mipmap-hdpi/ic_launcher.png
new file mode 100644
index 0000000..a2f5908
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-hdpi/ic_launcher.png differ
diff --git a/debugtemp/src/main/res/mipmap-hdpi/ic_launcher_round.png b/debugtemp/src/main/res/mipmap-hdpi/ic_launcher_round.png
new file mode 100644
index 0000000..1b52399
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-hdpi/ic_launcher_round.png differ
diff --git a/debugtemp/src/main/res/mipmap-mdpi/ic_launcher.png b/debugtemp/src/main/res/mipmap-mdpi/ic_launcher.png
new file mode 100644
index 0000000..ff10afd
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-mdpi/ic_launcher.png differ
diff --git a/debugtemp/src/main/res/mipmap-mdpi/ic_launcher_round.png b/debugtemp/src/main/res/mipmap-mdpi/ic_launcher_round.png
new file mode 100644
index 0000000..115a4c7
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-mdpi/ic_launcher_round.png differ
diff --git a/debugtemp/src/main/res/mipmap-xhdpi/ic_launcher.png b/debugtemp/src/main/res/mipmap-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..dcd3cd8
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-xhdpi/ic_launcher.png differ
diff --git a/debugtemp/src/main/res/mipmap-xhdpi/ic_launcher_round.png b/debugtemp/src/main/res/mipmap-xhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..459ca60
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-xhdpi/ic_launcher_round.png differ
diff --git a/debugtemp/src/main/res/mipmap-xxhdpi/ic_launcher.png b/debugtemp/src/main/res/mipmap-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..8ca12fe
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-xxhdpi/ic_launcher.png differ
diff --git a/debugtemp/src/main/res/mipmap-xxhdpi/ic_launcher_round.png b/debugtemp/src/main/res/mipmap-xxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..8e19b41
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-xxhdpi/ic_launcher_round.png differ
diff --git a/debugtemp/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/debugtemp/src/main/res/mipmap-xxxhdpi/ic_launcher.png
new file mode 100644
index 0000000..b824ebd
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ
diff --git a/debugtemp/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png b/debugtemp/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..4c19a13
Binary files /dev/null and b/debugtemp/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png differ
diff --git a/debugtemp/src/main/res/values/colors.xml b/debugtemp/src/main/res/values/colors.xml
new file mode 100644
index 0000000..479769a
--- /dev/null
+++ b/debugtemp/src/main/res/values/colors.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#009688</color>
+    <color name="colorPrimaryDark">#00796B</color>
+    <color name="colorAccent">#FF9800</color>
+</resources>
\ No newline at end of file
diff --git a/debugtemp/src/main/res/values/strings.xml b/debugtemp/src/main/res/values/strings.xml
new file mode 100644
index 0000000..cddc36c
--- /dev/null
+++ b/debugtemp/src/main/res/values/strings.xml
@@ -0,0 +1,4 @@
+<resources>
+    <string name="app_name">DebugTemp</string>
+    
+</resources>
diff --git a/debugtemp/src/main/res/values/styles.xml b/debugtemp/src/main/res/values/styles.xml
new file mode 100644
index 0000000..a70e242
--- /dev/null
+++ b/debugtemp/src/main/res/values/styles.xml
@@ -0,0 +1,11 @@
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="MyAppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+</resources>
diff --git a/debugtemp/src/stage/AndroidManifest.xml b/debugtemp/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/debugtemp/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/debugtemp/src/stage/res/values/strings.xml b/debugtemp/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/debugtemp/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/gallery/README.md b/gallery/README.md
new file mode 100644
index 0000000..33637b0
--- /dev/null
+++ b/gallery/README.md
@@ -0,0 +1,34 @@
+# Gallery
+
+#### 介绍
+云宝相册应用
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh gallery
+
+#### 使用说明
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/gallery/app_update_description.txt b/gallery/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/gallery/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/gallery/build.gradle b/gallery/build.gradle
new file mode 100644
index 0000000..7d8c427
--- /dev/null
+++ b/gallery/build.gradle
@@ -0,0 +1,119 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.gallery"
+	    minSdkVersion 23
+		// 适配MIUI12
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.0"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+	
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['libs'] // 若SO库放在libs目录下
+        }
+    }
+}
+
+dependencies {
+    
+    api 'com.google.code.gson:gson:2.10.1'
+	
+	// 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// OkHttp网络请求
+     implementation 'com.squareup.okhttp3:okhttp:3.14.9'
+     // FastJSON解析
+     implementation 'com.alibaba:fastjson:1.2.76'
+    
+	// AndroidX 类库
+    /*api 'androidx.appcompat:appcompat:1.1.0'
+    //api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'*/
+	
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+
+	implementation "androidx.annotation:annotation:1.3.0"
+    implementation "androidx.core:core:1.6.0"
+    implementation "androidx.drawerlayout:drawerlayout:1.1.1"
+    implementation "androidx.preference:preference:1.1.1"
+    implementation "androidx.viewpager:viewpager:1.0.0"
+    implementation "com.google.android.material:material:1.4.0"
+    implementation "com.google.guava:guava:24.1-jre"
+    /*
+	implementation "io.noties.markwon:core:$markwonVersion"
+    implementation "io.noties.markwon:ext-strikethrough:$markwonVersion"
+    implementation "io.noties.markwon:linkify:$markwonVersion"
+    implementation "io.noties.markwon:recycler:$markwonVersion"
+	*/
+	/*implementation 'com.termux:terminal-emulator:0.118.0'
+	implementation 'com.termux:terminal-view:0.118.0'
+	implementation 'com.termux:termux-shared:0.118.0'
+	*/
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.9'
+    api 'cc.winboll.studio:libappbase:15.15.21'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.15.7'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.4'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/gallery/build.properties b/gallery/build.properties
new file mode 100644
index 0000000..167b855
--- /dev/null
+++ b/gallery/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Sat May 02 10:32:03 CST 2026
+stageCount=16
+libraryProject=
+baseVersion=15.0
+publishVersion=15.0.15
+buildCount=19
+baseBetaVersion=15.0.16
diff --git a/gallery/proguard-rules.pro b/gallery/proguard-rules.pro
new file mode 100644
index 0000000..a18de74
--- /dev/null
+++ b/gallery/proguard-rules.pro
@@ -0,0 +1,137 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/gallery/src/beta/AndroidManifest.xml b/gallery/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/gallery/src/beta/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/gallery/src/beta/res/values/strings.xml b/gallery/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..9a532e7
--- /dev/null
+++ b/gallery/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+    <string name="app_name">Gallery+</string>
+</resources>
diff --git a/gallery/src/main/AndroidManifest.xml b/gallery/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..e806f31
--- /dev/null
+++ b/gallery/src/main/AndroidManifest.xml
@@ -0,0 +1,66 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.gallery">
+
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:label="@string/app_name"
+        android:theme="@style/AppTheme"
+        android:resizeableActivity="true"
+        android:name=".GlobalWinBoLLApplication"
+		android:requestLegacyExternalStorage="true">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity
+            android:name=".SettingsActivity"
+            android:label="@string/settings_title"/>
+
+        <activity
+            android:name=".AlbumActivity"
+            android:label="@string/app_name"/>
+
+        <activity
+            android:name=".ImageViewerActivity"
+            android:label="@string/app_name"/>
+
+        <activity
+            android:name=".TrashActivity"
+            android:label="@string/trash"/>
+            
+        <activity
+            android:name=".CropActivity"
+            android:label="调整封面"/>
+        
+        <activity
+            android:name=".AboutActivity"
+            android:label="@string/about"/>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name=".GlobalApplication$CrashActivity"/>
+
+    </application>
+
+</manifest>
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/AboutActivity.java b/gallery/src/main/java/cc/winboll/studio/gallery/AboutActivity.java
new file mode 100644
index 0000000..f9afe0e
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/AboutActivity.java
@@ -0,0 +1,51 @@
+package cc.winboll.studio.gallery;
+
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+
+public class AboutActivity extends AppCompatActivity {
+
+    public static final String TAG = "AboutActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                finish();
+            }
+        });
+
+        AboutView aboutView = findViewById(R.id.aboutview);
+        aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+    private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "gallery";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName("Gallery");
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=Gallery");
+        appInfo.setAppAPKName("Gallery");
+        appInfo.setAppAPKFolderName("Gallery");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/Album.java b/gallery/src/main/java/cc/winboll/studio/gallery/Album.java
new file mode 100644
index 0000000..42aaa02
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/Album.java
@@ -0,0 +1,25 @@
+package cc.winboll.studio.gallery;
+
+import android.net.Uri;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class Album {
+    public static final String TAG = "Album";
+    private String name;
+    private String path;
+    private Uri coverUri;
+    private int imageCount;
+
+    public Album(String name, String path, Uri coverUri, int imageCount) {
+        LogUtils.d(TAG, "Album created: " + name);
+        this.name = name;
+        this.path = path;
+        this.coverUri = coverUri;
+        this.imageCount = imageCount;
+    }
+
+    public String getName() { return name; }
+    public String getPath() { return path; }
+    public Uri getCoverUri() { return coverUri; }
+    public int getImageCount() { return imageCount; }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/AlbumActivity.java b/gallery/src/main/java/cc/winboll/studio/gallery/AlbumActivity.java
new file mode 100644
index 0000000..a9ccac2
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/AlbumActivity.java
@@ -0,0 +1,251 @@
+package cc.winboll.studio.gallery;
+
+import android.content.ContentResolver;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.database.Cursor;
+import android.net.Uri;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+import androidx.recyclerview.widget.GridLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import com.google.android.material.floatingactionbutton.FloatingActionButton;
+import java.util.ArrayList;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.gallery.ImageAdapter.OnImageClickListener;
+
+public class AlbumActivity extends AppCompatActivity {
+    public static final String TAG = "AlbumActivity";
+    private static final int PERMISSION_REQUEST_CODE = 101;
+    public static final String EXTRA_ALBUM_PATH = "album_path";
+    public static final String EXTRA_ALBUM_NAME = "album_name";
+    private RecyclerView recyclerView;
+    private ImageAdapter adapter;
+    private String albumPath;
+    private String albumName;
+    private FloatingActionButton fabScrollTop;
+    private Preferences prefs;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        LogUtils.d(TAG, "onCreate");
+        
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        
+        albumPath = getIntent().getStringExtra(EXTRA_ALBUM_PATH);
+        albumName = getIntent().getStringExtra(EXTRA_ALBUM_NAME);
+        
+        getSupportActionBar().setTitle(albumName);
+        
+        prefs = new Preferences(this);
+        
+        recyclerView = findViewById(R.id.recycler_view);
+        recyclerView.setLayoutManager(new GridLayoutManager(this, 3));
+        adapter = new ImageAdapter();
+        adapter.setContext(this);
+        adapter.setAlbumPath(albumPath);
+        recyclerView.setAdapter(adapter);
+        
+        fabScrollTop = findViewById(R.id.fab_scroll_top);
+        fabScrollTop.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                recyclerView.scrollToPosition(0);
+            }
+        });
+        
+        recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
+            @Override
+            public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
+                super.onScrolled(recyclerView, dx, dy);
+                GridLayoutManager layoutManager = (GridLayoutManager) recyclerView.getLayoutManager();
+                if (layoutManager != null) {
+                    int firstVisible = layoutManager.findFirstVisibleItemPosition();
+                    if (firstVisible > 0) {
+                        fabScrollTop.setVisibility(View.VISIBLE);
+                    } else {
+                        fabScrollTop.setVisibility(View.GONE);
+                    }
+                }
+            }
+        });
+        
+        adapter.setOnImageClickListener(new OnImageClickListener() {
+            @Override
+            public void onImageClick(int position, ArrayList<Uri> urls, ArrayList<String> paths) {
+                Intent intent = new Intent(AlbumActivity.this, ImageViewerActivity.class);
+                intent.putParcelableArrayListExtra(ImageViewerActivity.EXTRA_IMAGE_URLS, urls);
+                intent.putStringArrayListExtra(ImageViewerActivity.EXTRA_POSITIONS, paths);
+                intent.putExtra(ImageViewerActivity.EXTRA_POSITION, position);
+                startActivity(intent);
+            }
+        });
+        
+        if (checkPermission()) {
+            loadImages();
+        } else {
+            requestPermission();
+        }
+    }
+
+    private boolean checkPermission() {
+        return ContextCompat.checkSelfPermission(this, android.Manifest.permission.READ_EXTERNAL_STORAGE) 
+            == PackageManager.PERMISSION_GRANTED;
+    }
+
+    private void requestPermission() {
+        ActivityCompat.requestPermissions(this, 
+            new String[]{android.Manifest.permission.READ_EXTERNAL_STORAGE}, 
+            PERMISSION_REQUEST_CODE);
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, 
+            @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        if (requestCode == PERMISSION_REQUEST_CODE) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                loadImages();
+            } else {
+                Toast.makeText(this, "Permission denied", Toast.LENGTH_SHORT).show();
+            }
+        }
+    }
+
+private String getSortOrder(int sortMode) {
+        switch (sortMode) {
+            case Preferences.SORT_TIME_ASC:
+                return android.provider.MediaStore.Images.Media.DATE_ADDED + " ASC";
+            case Preferences.SORT_NAME_DESC:
+                return android.provider.MediaStore.Images.Media.DISPLAY_NAME + " DESC";
+            case Preferences.SORT_NAME_ASC:
+                return android.provider.MediaStore.Images.Media.DISPLAY_NAME + " ASC";
+            case Preferences.SORT_TIME_DESC:
+            default:
+                return android.provider.MediaStore.Images.Media.DATE_ADDED + " DESC";
+        }
+    }
+    
+    private void loadImages() {
+        LogUtils.d(TAG, "loadImages");
+        ArrayList<Uri> imageUrls = new ArrayList<>();
+        ArrayList<String> imagePaths = new ArrayList<>();
+        ContentResolver contentResolver = getContentResolver();
+        Uri collection = android.provider.MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
+        
+        String selection = android.provider.MediaStore.Images.Media.DATA + " LIKE ?";
+        String[] selectionArgs = new String[]{albumPath + "%"};
+        int sortMode = prefs.getAlbumSortMode();
+        String sortOrder = getSortOrder(sortMode);
+        
+        try (Cursor cursor = contentResolver.query(collection, null, selection, selectionArgs, sortOrder)) {
+            if (cursor != null) {
+                int dataColumn = cursor.getColumnIndexOrThrow(android.provider.MediaStore.Images.Media.DATA);
+                while (cursor.moveToNext()) {
+                    String path = cursor.getString(dataColumn);
+                    if (path != null && path.startsWith(albumPath + "/")) {
+                        long id = cursor.getLong(cursor.getColumnIndexOrThrow(android.provider.MediaStore.Images.Media._ID));
+                        Uri contentUri = Uri.withAppendedPath(collection, String.valueOf(id));
+                        imageUrls.add(contentUri);
+                        imagePaths.add(path);
+                    }
+                }
+            }
+        }
+        
+        if (imageUrls.isEmpty()) {
+            Toast.makeText(this, R.string.no_images_found, Toast.LENGTH_SHORT).show();
+            LogUtils.i(TAG, "No images found");
+        }
+        adapter.setData(imageUrls, imagePaths);
+        LogUtils.d(TAG, "Loaded " + imageUrls.size() + " images");
+    }
+    
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.menu_album, menu);
+        int sortMode = prefs.getAlbumSortMode();
+        int menuId = getSortMenuId(sortMode);
+        MenuItem item = menu.findItem(menuId);
+        if (item != null) {
+            item.setChecked(true);
+        }
+        MenuItem sortItem = menu.findItem(R.id.action_sort);
+        if (sortItem != null && sortItem.getSubMenu() != null) {
+            sortItem.getSubMenu().setGroupCheckable(0, true, true);
+        }
+        return true;
+    }
+    
+    private int getSortMenuId(int sortMode) {
+        switch (sortMode) {
+            case Preferences.SORT_TIME_ASC:
+                return R.id.sort_time_asc;
+            case Preferences.SORT_NAME_DESC:
+                return R.id.sort_name_desc;
+            case Preferences.SORT_NAME_ASC:
+                return R.id.sort_name_asc;
+            case Preferences.SORT_TIME_DESC:
+            default:
+                return R.id.sort_time_desc;
+        }
+    }
+    
+    @Override
+    public boolean onOptionsItemSelected(@NonNull MenuItem item) {
+        int itemId = item.getItemId();
+        if (itemId == R.id.sort_time_desc) {
+            prefs.setAlbumSortMode(Preferences.SORT_TIME_DESC);
+            item.setChecked(true);
+            loadImages();
+            return true;
+        } else if (itemId == R.id.sort_time_asc) {
+            prefs.setAlbumSortMode(Preferences.SORT_TIME_ASC);
+            item.setChecked(true);
+            loadImages();
+            return true;
+        } else if (itemId == R.id.sort_name_desc) {
+            prefs.setAlbumSortMode(Preferences.SORT_NAME_DESC);
+            item.setChecked(true);
+            loadImages();
+            return true;
+        } else if (itemId == R.id.sort_name_asc) {
+            prefs.setAlbumSortMode(Preferences.SORT_NAME_ASC);
+            item.setChecked(true);
+            loadImages();
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+    
+    @Override
+    protected void onResume() {
+        super.onResume();
+        if (checkPermission()) {
+            loadImages();
+        }
+        if (adapter != null) {
+            adapter.refreshBg();
+        }
+    }
+    
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        if (requestCode == 100 && resultCode == RESULT_OK) {
+            loadImages();
+        }
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/AlbumAdapter.java b/gallery/src/main/java/cc/winboll/studio/gallery/AlbumAdapter.java
new file mode 100644
index 0000000..fa435bd
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/AlbumAdapter.java
@@ -0,0 +1,255 @@
+package cc.winboll.studio.gallery;
+
+import android.net.Uri;
+import android.provider.MediaStore;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.view.View.OnLongClickListener;
+import android.view.ViewGroup;
+import android.widget.ImageView;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import com.bumptech.glide.Glide;
+import java.io.File;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class AlbumAdapter extends RecyclerView.Adapter<AlbumAdapter.ViewHolder> {
+    public static final String TAG = "AlbumAdapter";
+    private ArrayList<Album> albums = new ArrayList<>();
+    private OnAlbumClickListener listener;
+    private Preferences prefs;
+    private int bgType = 0;
+    private PinnedAlbumDbHelper pinnedDbHelper;
+    private OnCoverSizeListener coverSizeListener;
+    private boolean coverSizeReported = false;
+    
+    private int getBgRes() {
+        switch (bgType) {
+            case 0:
+                return R.drawable.bg_checkerboard;
+            case 1:
+                return R.drawable.bg_white;
+            case 2:
+                return R.drawable.bg_black;
+            default:
+                return R.drawable.bg_checkerboard;
+        }
+    }
+
+    public interface OnAlbumClickListener {
+        void onAlbumClick(Album album);
+    }
+    
+    public interface OnCoverSizeListener {
+        void onCoverSize(int width, int height);
+    }
+    
+    public static final int DEFAULT_COVER_WIDTH = 240;
+    public static final int DEFAULT_COVER_HEIGHT = 120;
+    
+    public void setOnAlbumClickListener(OnAlbumClickListener listener) {
+        this.listener = listener;
+    }
+    
+    public void setOnCoverSizeListener(OnCoverSizeListener listener) {
+        this.coverSizeListener = listener;
+    }
+
+    public void setData(ArrayList<Album> albums) {
+        this.albums = sortAlbums(albums);
+        LogUtils.d(TAG, "setData: " + albums.size() + " albums");
+        notifyDataSetChanged();
+    }
+    
+    private ArrayList<Album> sortAlbums(ArrayList<Album> list) {
+        if (pinnedDbHelper == null || list == null || list.isEmpty()) {
+            return list;
+        }
+        ArrayList<Album> pinned = new ArrayList<>();
+        ArrayList<Album> unpinned = new ArrayList<>();
+        for (Album album : list) {
+            if (pinnedDbHelper.isPinned(album.getPath())) {
+                pinned.add(album);
+            } else {
+                unpinned.add(album);
+            }
+        }
+        pinned.addAll(unpinned);
+        return pinned;
+    }
+    
+    public void setContext(android.content.Context context) {
+        prefs = new Preferences(context);
+        bgType = prefs.getBgType();
+        pinnedDbHelper = PinnedAlbumDbHelper.getInstance(context);
+    }
+    
+    public void refreshBg() {
+        if (prefs != null) {
+            bgType = prefs.getBgType();
+        }
+        notifyDataSetChanged();
+    }
+    
+    public void refreshCover() {
+        notifyDataSetChanged();
+    }
+    
+    public void refreshPinned() {
+        if (pinnedDbHelper != null && albums != null && !albums.isEmpty()) {
+            ArrayList<Album> pinned = new ArrayList<>();
+            ArrayList<Album> unpinned = new ArrayList<>();
+            for (Album album : albums) {
+                if (pinnedDbHelper.isPinned(album.getPath())) {
+                    pinned.add(album);
+                } else {
+                    unpinned.add(album);
+                }
+            }
+            Comparator<Album> nameComparator = new Comparator<Album>() {
+                @Override
+                public int compare(Album a1, Album a2) {
+                    return a1.getName().compareToIgnoreCase(a2.getName());
+                }
+            };
+            Collections.sort(pinned, nameComparator);
+            Collections.sort(unpinned, nameComparator);
+            albums.clear();
+            albums.addAll(pinned);
+            albums.addAll(unpinned);
+            notifyDataSetChanged();
+        }
+    }
+    
+private void showContextMenu(View view, final Album album) {
+        android.app.AlertDialog.Builder builder = new android.app.AlertDialog.Builder(view.getContext());
+        builder.setTitle(album.getName());
+        final boolean isPinned = pinnedDbHelper != null && pinnedDbHelper.isPinned(album.getPath());
+        String[] items = isPinned ? new String[]{"取消置顶"} : new String[]{"置顶"};
+        builder.setItems(items, new android.content.DialogInterface.OnClickListener() {
+            @Override
+            public void onClick(android.content.DialogInterface dialog, int which) {
+                if (pinnedDbHelper != null) {
+                    if (which == 0) {
+                        if (isPinned) {
+                            pinnedDbHelper.unpinAlbum(album.getPath());
+                        } else {
+                            pinnedDbHelper.pinAlbum(album.getPath());
+                        }
+                        refreshPinned();
+                    }
+                }
+            }
+        });
+        builder.show();
+    }
+
+    @NonNull
+    @Override
+    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        View view = LayoutInflater.from(parent.getContext())
+            .inflate(R.layout.item_album, parent, false);
+        return new ViewHolder(view);
+    }
+
+    @Override
+    public void onBindViewHolder(@NonNull ViewHolder holder, final int position) {
+        final Album album = albums.get(position);
+        LogUtils.d(TAG, "bind: " + album.getName() + ", cover=" + album.getCoverUri());
+        
+        holder.coverImage.setBackgroundResource(getBgRes());
+        
+        boolean isPinned = pinnedDbHelper != null && pinnedDbHelper.isPinned(album.getPath());
+        holder.pinIcon.setVisibility(isPinned ? View.VISIBLE : View.GONE);
+        
+        holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {
+            @Override
+            public boolean onLongClick(View v) {
+                showContextMenu(holder.itemView, album);
+                return true;
+            }
+        });
+        
+        holder.albumName.setText(album.getName());
+        holder.imageCount.setText(album.getImageCount() + " photos");
+        
+        holder.itemView.post(new Runnable() {
+            @Override
+            public void run() {
+                if (!coverSizeReported && prefs != null) {
+                    int savedWidth = prefs.getCoverWidth();
+                    if (savedWidth == AlbumAdapter.DEFAULT_COVER_WIDTH) {
+                        int width = holder.coverImage.getWidth();
+                        int height = holder.coverImage.getHeight();
+                        if (width > 0 && height > 0) {
+                            prefs.setCoverWidth(width);
+                            prefs.setCoverHeight(height);
+                            float ratio = (float) width / height;
+                            prefs.setCoverRatio(ratio);
+                            coverSizeReported = true;
+                            if (coverSizeListener != null) {
+                                coverSizeListener.onCoverSize(width, height);
+                            }
+                        }
+                    }
+                }
+            }
+        });
+        
+        holder.itemView.setOnClickListener(new OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                if (listener != null) {
+                    listener.onAlbumClick(album);
+                }
+            }
+        });
+        
+        Uri coverUri = album.getCoverUri();
+        if (coverUri != null) {
+            String uriString = coverUri.toString();
+            LogUtils.d(TAG, "uri scheme: " + coverUri.getScheme() + ", path: " + uriString);
+            
+            if ("file".equals(coverUri.getScheme())) {
+                File coverFile = new File(coverUri.getPath());
+                if (coverFile.exists()) {
+                    Glide.with(holder.coverImage.getContext())
+                        .load(coverFile)
+                        .fitCenter()
+                        .into(holder.coverImage);
+                    return;
+                }
+            }
+            
+            Glide.with(holder.coverImage.getContext())
+                .load(coverUri)
+                .fitCenter()
+                .into(holder.coverImage);
+        }
+    }
+
+    @Override
+    public int getItemCount() {
+        return albums.size();
+    }
+
+    static class ViewHolder extends RecyclerView.ViewHolder {
+        ImageView coverImage;
+        ImageView pinIcon;
+        TextView albumName;
+        TextView imageCount;
+        ViewHolder(View itemView) {
+            super(itemView);
+            coverImage = itemView.findViewById(R.id.album_cover);
+            pinIcon = itemView.findViewById(R.id.pin_icon);
+            albumName = itemView.findViewById(R.id.album_name);
+            imageCount = itemView.findViewById(R.id.image_count);
+        }
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/AlbumCoverDbHelper.java b/gallery/src/main/java/cc/winboll/studio/gallery/AlbumCoverDbHelper.java
new file mode 100644
index 0000000..3a74d25
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/AlbumCoverDbHelper.java
@@ -0,0 +1,131 @@
+package cc.winboll.studio.gallery;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class AlbumCoverDbHelper extends SQLiteOpenHelper {
+    public static final String TAG = "AlbumCoverDbHelper";
+    private static final String DB_NAME = "album_cover.db";
+    private static final int DB_VERSION = 2;
+    private static final String TABLE_NAME = "album_covers";
+    private static final String COLUMN_ALBUM_PATH = "album_path";
+    private static final String COLUMN_IMAGE_PATH = "image_path";
+    private static final String COLUMN_CROP_PATH = "crop_path";
+    
+    private static final String SQL_CREATE = "CREATE TABLE " + TABLE_NAME + " (" 
+        + COLUMN_ALBUM_PATH + " TEXT PRIMARY KEY, "
+        + COLUMN_IMAGE_PATH + " TEXT, "
+        + COLUMN_CROP_PATH + " TEXT)";
+    
+    private static AlbumCoverDbHelper dbHelper;
+    
+    public static AlbumCoverDbHelper getInstance(Context context) {
+        if (dbHelper == null) {
+            dbHelper = new AlbumCoverDbHelper(context.getApplicationContext());
+        }
+        return dbHelper;
+    }
+    
+    public AlbumCoverDbHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+    
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        db.execSQL(SQL_CREATE);
+    }
+    
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        if (oldVersion < 2) {
+            try {
+                db.execSQL("ALTER TABLE " + TABLE_NAME + " ADD COLUMN " + COLUMN_CROP_PATH + " TEXT");
+            } catch (Exception e) {
+                db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME);
+                onCreate(db);
+            }
+        }
+    }
+    
+    public void setCoverWithCrop(String albumPath, String imagePath, String cropPath) {
+        SQLiteDatabase db = getWritableDatabase();
+        ContentValues values = new ContentValues();
+        values.put(COLUMN_ALBUM_PATH, albumPath);
+        values.put(COLUMN_IMAGE_PATH, imagePath);
+        values.put(COLUMN_CROP_PATH, cropPath);
+        db.insertWithOnConflict(TABLE_NAME, null, values, SQLiteDatabase.CONFLICT_REPLACE);
+        LogUtils.d(TAG, "setCoverWithCrop: album=" + albumPath + ", image=" + imagePath + ", crop=" + cropPath);
+    }
+    
+    public void setCover(String albumPath, String imagePath) {
+        SQLiteDatabase db = getWritableDatabase();
+        ContentValues values = new ContentValues();
+        values.put(COLUMN_ALBUM_PATH, albumPath);
+        values.put(COLUMN_IMAGE_PATH, imagePath);
+        db.insertWithOnConflict(TABLE_NAME, null, values, SQLiteDatabase.CONFLICT_REPLACE);
+        LogUtils.d(TAG, "setCover: album=" + albumPath + ", image=" + imagePath);
+    }
+    
+    public String getCover(String albumPath) {
+        SQLiteDatabase db = getReadableDatabase();
+        Cursor cursor = db.query(TABLE_NAME, new String[]{COLUMN_CROP_PATH, COLUMN_IMAGE_PATH}, 
+            COLUMN_ALBUM_PATH + " = ?", new String[]{albumPath}, null, null, null);
+        String coverPath = null;
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                coverPath = cursor.getString(0);
+                if (coverPath == null) {
+                    coverPath = cursor.getString(1);
+                }
+            }
+            cursor.close();
+        }
+        return coverPath;
+    }
+    
+    public String getCropPath(String albumPath) {
+        SQLiteDatabase db = getReadableDatabase();
+        Cursor cursor = db.query(TABLE_NAME, new String[]{COLUMN_CROP_PATH}, 
+            COLUMN_ALBUM_PATH + " = ?", new String[]{albumPath}, null, null, null);
+        String cropPath = null;
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                cropPath = cursor.getString(0);
+            }
+            cursor.close();
+        }
+        return cropPath;
+    }
+    
+    public String getOriginalImagePath(String albumPath) {
+        SQLiteDatabase db = getReadableDatabase();
+        Cursor cursor = db.query(TABLE_NAME, new String[]{COLUMN_IMAGE_PATH}, 
+            COLUMN_ALBUM_PATH + " = ?", new String[]{albumPath}, null, null, null);
+        String imagePath = null;
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                imagePath = cursor.getString(0);
+            }
+            cursor.close();
+        }
+        return imagePath;
+    }
+    
+    public void clearCover(String albumPath) {
+        SQLiteDatabase db = getWritableDatabase();
+        ContentValues values = new ContentValues();
+        values.putNull(COLUMN_CROP_PATH);
+        db.update(TABLE_NAME, values, COLUMN_ALBUM_PATH + " = ?", new String[]{albumPath});
+        LogUtils.d(TAG, "clearCover: " + albumPath);
+    }
+    
+    public void deleteCover(String albumPath) {
+        SQLiteDatabase db = getWritableDatabase();
+        db.delete(TABLE_NAME, COLUMN_ALBUM_PATH + " = ?", new String[]{albumPath});
+        LogUtils.d(TAG, "deleteCover: " + albumPath);
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/CropActivity.java b/gallery/src/main/java/cc/winboll/studio/gallery/CropActivity.java
new file mode 100644
index 0000000..7463937
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/CropActivity.java
@@ -0,0 +1,313 @@
+package cc.winboll.studio.gallery;
+
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.RectF;
+import android.net.Uri;
+import android.os.Bundle;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.RectF;
+import android.net.Uri;
+import android.os.Bundle;
+import android.provider.MediaStore;
+import android.view.View;
+import android.widget.ImageView;
+import android.widget.ScrollView;
+import android.widget.SeekBar;
+import android.widget.TextView;
+import android.widget.LinearLayout;
+import android.widget.Toast;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.util.Random;
+
+public class CropActivity extends AppCompatActivity {
+    public static final String TAG = "CropActivity";
+    public static final String EXTRA_IMAGE_URI = "image_uri";
+    public static final String EXTRA_IMAGE_PATH = "image_path";
+    public static final String EXTRA_ALBUM_PATH = "album_path";
+    public static final String EXTRA_CROP_WIDTH = "crop_width";
+    public static final String EXTRA_CROP_HEIGHT = "crop_height";
+    
+    private CropCanvasView cropCanvasView;
+    private ZoomContainerView zoomContainer;
+    private Bitmap originalBitmap;
+    private String imagePath;
+    private String albumPath;
+    private int cropWidth = 240;
+    private int cropHeight = 120;
+    private float cropRatio = 2.0f;
+    private Preferences prefs;
+    
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_crop);
+        
+        imagePath = getIntent().getStringExtra(EXTRA_IMAGE_PATH);
+        albumPath = getIntent().getStringExtra(EXTRA_ALBUM_PATH);
+        cropWidth = getIntent().getIntExtra(EXTRA_CROP_WIDTH, 240);
+        cropHeight = getIntent().getIntExtra(EXTRA_CROP_HEIGHT, 120);
+        
+        prefs = new Preferences(this);
+        int bgType = prefs.getBgType();
+        if (cropWidth > 0 && cropHeight > 0) {
+            cropRatio = (float) cropWidth / cropHeight;
+        } else {
+            cropRatio = prefs.getCoverRatio();
+            cropWidth = (int) (120 * cropRatio);
+            cropHeight = 120;
+        }
+        
+        findViewById(R.id.btn_close).setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                finish();
+            }
+        });
+        
+        findViewById(R.id.btn_done).setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                saveCroppedCover();
+            }
+        });
+        
+        findViewById(R.id.btn_info).setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                showCropInfoDialog();
+            }
+        });
+        
+        findViewById(R.id.btn_change_bg).setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                Toast.makeText(CropActivity.this, "修改剪裁背景颜色", Toast.LENGTH_SHORT).show();
+            }
+        });
+        
+        zoomContainer = findViewById(R.id.zoom_container);
+        
+        SeekBar seekBarZoom = findViewById(R.id.seekbar_zoom);
+        seekBarZoom.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
+            @Override
+            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
+                if (zoomContainer != null && fromUser) {
+                    float scale = 0.1f + (progress / 100f) * 4.9f;
+                    zoomContainer.setScaleFactor(scale);
+                }
+            }
+            
+            @Override
+            public void onStartTrackingTouch(SeekBar seekBar) {}
+            
+            @Override
+            public void onStopTrackingTouch(SeekBar seekBar) {}
+        });
+        
+        cropCanvasView = findViewById(R.id.crop_canvas_view);
+        
+        cropCanvasView.setBackgroundType(bgType);
+        
+        cropCanvasView.setOnBackgroundColorChangedListener(new CropCanvasView.OnBackgroundColorChangedListener() {
+            @Override
+            public void onBackgroundColorChanged(int color) {
+            }
+        });
+        
+        loadImage();
+    }
+    
+    private void loadImage() {
+        try {
+            if (imagePath != null && new File(imagePath).exists()) {
+                originalBitmap = BitmapFactory.decodeFile(imagePath);
+            } else {
+                Uri imageUri = getIntent().getParcelableExtra(EXTRA_IMAGE_URI);
+                if (imageUri != null) {
+                    originalBitmap = MediaStore.Images.Media.getBitmap(getContentResolver(), imageUri);
+                }
+            }
+            
+            if (originalBitmap != null) {
+                cropCanvasView.setImageBitmap(originalBitmap);
+                cropCanvasView.post(new Runnable() {
+                    @Override
+                    public void run() {
+                        initCrop();
+                    }
+                });
+            } else {
+                Toast.makeText(this, "Failed to load image", Toast.LENGTH_SHORT).show();
+                finish();
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "loadImage error: " + e.getMessage());
+            Toast.makeText(this, "Failed to load image", Toast.LENGTH_SHORT).show();
+            finish();
+        }
+    }
+    
+    private void initCrop() {
+        cropCanvasView.initCanvas(originalBitmap.getWidth(), originalBitmap.getHeight(), cropRatio);
+        
+        int viewW = cropCanvasView.getWidth();
+        int viewH = cropCanvasView.getHeight();
+        if (viewW > 0 && viewH > 0) {
+            cropCanvasView.scaleToView(viewW, viewH);
+        }
+    }
+    
+    private void saveCroppedCover() {
+        if (originalBitmap == null || originalBitmap.isRecycled()) {
+            Toast.makeText(this, "Failed to get image", Toast.LENGTH_SHORT).show();
+            return;
+        }
+        
+        try {
+            Bitmap canvasBitmap = cropCanvasView.getCanvasBitmap();
+            if (canvasBitmap == null || canvasBitmap.isRecycled()) {
+                Toast.makeText(this, "Failed to get canvas bitmap", Toast.LENGTH_SHORT).show();
+                return;
+            }
+            
+            RectF cropRect = cropCanvasView.getCropRect();
+            
+            int bmpX = (int) cropRect.left;
+            int bmpY = (int) cropRect.top;
+            int bmpW = (int) cropRect.width();
+            int bmpH = (int) cropRect.height();
+            
+            bmpX = Math.max(0, Math.min(bmpX, canvasBitmap.getWidth() - 1));
+            bmpY = Math.max(0, Math.min(bmpY, canvasBitmap.getHeight() - 1));
+            bmpW = Math.max(1, Math.min(bmpW, canvasBitmap.getWidth() - bmpX));
+            bmpH = Math.max(1, Math.min(bmpH, canvasBitmap.getHeight() - bmpY));
+            
+            LogUtils.d(TAG, "saveCroppedCover: cropRect=" + cropRect);
+            LogUtils.d(TAG, "saveCroppedCover: crop=(" + bmpX + "," + bmpY + "," + bmpW + "," + bmpH + ")");
+            LogUtils.d(TAG, "saveCroppedCover: canvas size=" + canvasBitmap.getWidth() + "x" + canvasBitmap.getHeight());
+            
+            Bitmap cropped = Bitmap.createBitmap(canvasBitmap, bmpX, bmpY, bmpW, bmpH);
+            canvasBitmap.recycle();
+            
+            LogUtils.d(TAG, "saveCroppedCover: cropped size=" + cropped.getWidth() + "x" + cropped.getHeight());
+            
+            File coverDir = new File(getFilesDir(), "covers");
+            if (!coverDir.exists()) {
+                coverDir.mkdirs();
+            }
+            File coverFile = new File(coverDir, "cover_" + System.currentTimeMillis() + ".png");
+            LogUtils.d(TAG, "saveCroppedCover: cover file=" + coverFile.getAbsolutePath());
+            
+            FileOutputStream fos = new FileOutputStream(coverFile);
+            cropped.compress(Bitmap.CompressFormat.PNG, 100, fos);
+            fos.close();
+            
+            LogUtils.d(TAG, "saveCroppedCover: file exists=" + coverFile.exists() + ", length=" + coverFile.length());
+            
+            cropped.recycle();
+            
+            AlbumCoverDbHelper coverDbHelper = AlbumCoverDbHelper.getInstance(this);
+            coverDbHelper.setCoverWithCrop(albumPath, imagePath, coverFile.getAbsolutePath());
+            LogUtils.d(TAG, "saveCroppedCover: cover saved to db, albumPath=" + albumPath);
+            
+            Intent broadcastIntent = new Intent(Preferences.ACTION_COVER_UPDATED);
+            sendBroadcast(broadcastIntent);
+            
+            Toast.makeText(this, "封面已保存", Toast.LENGTH_SHORT).show();
+            setResult(RESULT_OK);
+            finish();
+        } catch (Exception e) {
+            LogUtils.e(TAG, "saveCroppedCover error: " + e.getMessage());
+            Toast.makeText(this, "Failed to save cover", Toast.LENGTH_SHORT).show();
+        }
+    }
+    
+    private void showCropInfoDialog() {
+        StringBuilder info = new StringBuilder();
+        info.append("=== 画布信息 ===\n");
+        info.append("画布宽度: ").append(cropCanvasView.getCanvasWidth()).append("px\n");
+        info.append("画布高度: ").append(cropCanvasView.getCanvasHeight()).append("px\n");
+        
+        info.append("\n=== 背景类型 ===\n");
+        String[] bgNames = {"灰白相间", "全白", "全黑"};
+        info.append("背景: ").append(bgNames[cropCanvasView.getBackgroundType()]).append("\n");
+        int bgColor = cropCanvasView.getBackgroundColor();
+        info.append("背景颜色: #").append(String.format("%06X", bgColor & 0xFFFFFF)).append("\n");
+        info.append("拾取坐标: ").append(cropCanvasView.getLastPickImageX()).append(",")
+            .append(cropCanvasView.getLastPickImageY()).append("\n");
+        
+        info.append("\n=== 裁剪结果 ===\n");
+        RectF cropRect = cropCanvasView.getCropRect();
+        if (cropRect != null) {
+            info.append("裁剪区域: ").append((int)cropRect.left).append(",")
+                .append((int)cropRect.top).append(",")
+                .append((int)cropRect.right).append(",")
+                .append((int)cropRect.bottom).append("\n");
+            info.append("裁剪宽度: ").append((int)cropRect.width()).append("px\n");
+            info.append("裁剪高度: ").append((int)cropRect.height()).append("px\n");
+        }
+        
+        Bitmap canvasBitmap = cropCanvasView.getCanvasBitmap();
+        final Bitmap[] previewHolder = new Bitmap[1];
+        if (canvasBitmap != null && !canvasBitmap.isRecycled() && cropRect != null) {
+            int bmpX = Math.max(0, (int) cropRect.left);
+            int bmpY = Math.max(0, (int) cropRect.top);
+            int bmpW = Math.min((int) cropRect.width(), canvasBitmap.getWidth() - bmpX);
+            int bmpH = Math.min((int) cropRect.height(), canvasBitmap.getHeight() - bmpY);
+            if (bmpW > 0 && bmpH > 0) {
+                previewHolder[0] = Bitmap.createBitmap(canvasBitmap, bmpX, bmpY, bmpW, bmpH);
+            }
+        }
+        
+        final Bitmap previewBitmap = previewHolder[0];
+        
+        View dialogView = getLayoutInflater().inflate(R.layout.dialog_crop_info, null);
+        TextView infoText = dialogView.findViewById(R.id.info_text);
+        ImageView previewImage = dialogView.findViewById(R.id.preview_image);
+        final LinearLayout previewImageContainer = dialogView.findViewById(R.id.preview_image_container);
+        infoText.setText(info.toString());
+        if (previewBitmap != null) {
+            previewImage.setImageBitmap(previewBitmap);
+        }
+        previewImage.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                int randomColor = 0xFF000000 | new Random().nextInt(0x00FFFFFF);
+                previewImageContainer.setBackgroundColor(randomColor);
+            }
+        });
+        
+        AlertDialog dialog = new AlertDialog.Builder(this)
+            .setTitle("裁剪信息")
+            .setView(dialogView)
+            .setPositiveButton("确定", null)
+            .create();
+        dialog.setOnDismissListener(new DialogInterface.OnDismissListener() {
+            @Override
+            public void onDismiss(DialogInterface dialog) {
+                if (previewBitmap != null && !previewBitmap.isRecycled()) {
+                    previewBitmap.recycle();
+                }
+            }
+        });
+        dialog.show();
+    }
+    
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        if (originalBitmap != null) {
+            originalBitmap.recycle();
+            originalBitmap = null;
+        }
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/CropCanvasView.java b/gallery/src/main/java/cc/winboll/studio/gallery/CropCanvasView.java
new file mode 100644
index 0000000..372e2fe
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/CropCanvasView.java
@@ -0,0 +1,750 @@
+package cc.winboll.studio.gallery;
+
+import android.content.Context;
+import android.graphics.Bitmap;
+import android.graphics.BitmapShader;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Matrix;
+import android.graphics.Paint;
+import android.graphics.RectF;
+import android.graphics.Shader;
+import android.graphics.drawable.Drawable;
+import android.util.AttributeSet;
+import android.view.MotionEvent;
+import android.view.View;
+
+public class CropCanvasView extends View {
+    public interface OnBackgroundColorChangedListener {
+        void onBackgroundColorChanged(int color);
+    }
+    
+    public interface OnColorPickedListener {
+        void onColorPicked(int color);
+    }
+    
+    public interface OnColorPickEndListener {
+        void onColorPickEnd();
+    }
+    
+    private OnBackgroundColorChangedListener backgroundColorChangedListener;
+    private OnColorPickedListener colorPickedListener;
+    private OnColorPickEndListener colorPickEndListener;
+    
+    public void setOnBackgroundColorChangedListener(OnBackgroundColorChangedListener listener) {
+        this.backgroundColorChangedListener = listener;
+    }
+    
+    public void setOnColorPickedListener(OnColorPickedListener listener) {
+        this.colorPickedListener = listener;
+    }
+    
+    public void setOnColorPickEndListener(OnColorPickEndListener listener) {
+        this.colorPickEndListener = listener;
+    }
+    private Paint imagePaint;
+    private Paint borderPaint;
+    private Paint cornerPaint;
+    private RectF cropRect;
+    private int touchArea = 50;
+    
+    private float lastX, lastY;
+    private int activeCorner = -1;
+    private static final int CORNER_TOP_LEFT = 0;
+    private static final int CORNER_TOP_RIGHT = 1;
+    private static final int CORNER_BOTTOM_LEFT = 2;
+    private static final int CORNER_BOTTOM_RIGHT = 3;
+    private static final int CORNER_CENTER = 4;
+    
+    private int imageWidth;
+    private int imageHeight;
+    private float coverRatio = 2.0f;
+    
+    private int extendHeight;
+    private int extendWidth;
+    private int canvasWidth;
+    private int canvasHeight;
+    private float minSize = 50;
+    
+    private RectF imageBounds = new RectF();
+    private RectF canvasBounds = new RectF();
+    private Bitmap originalBitmap;
+    private Bitmap canvasBitmap;
+    private float bitmapScale = 1.0f;
+    private Bitmap displayBitmap;
+    private RectF initialSpanRect;
+    private float initialSpan;
+    private int bgType = 2;
+    private Bitmap tileBitmap;
+    private BitmapShader tileShader;
+    private Paint bgPaint;
+    private int backgroundColor = Color.BLUE;
+    private boolean colorPickMode = false;
+    private int previewColor = 0;
+    private float lastPickX = 0;
+    private float lastPickY = 0;
+    private float pickX, pickY;
+    
+    private float displayScale = 1.0f;
+    private float displayOffsetX = 0f;
+    private float displayOffsetY = 0f;
+    private static final int MAX_DISPLAY_SIZE = 2048;
+    private float containerScale = 1.0f;
+    
+    public CropCanvasView(Context context) {
+        super(context);
+        init();
+    }
+    
+    public CropCanvasView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+    
+    public CropCanvasView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        init();
+    }
+    
+    private void init() {
+        imagePaint = new Paint();
+        imagePaint.setFilterBitmap(true);
+        
+        borderPaint = new Paint();
+        borderPaint.setColor(Color.parseColor("#CCAA00"));
+        borderPaint.setStyle(Paint.Style.STROKE);
+        borderPaint.setStrokeWidth(3);
+        
+        cornerPaint = new Paint();
+        cornerPaint.setColor(Color.WHITE);
+        cornerPaint.setStyle(Paint.Style.FILL);
+        
+        bgType = 2;
+        bgPaint = new Paint();
+        initTileBitmap();
+    }
+    
+    private void initTileBitmap() {
+        if (tileBitmap != null && !tileBitmap.isRecycled()) {
+            tileBitmap.recycle();
+            tileBitmap = null;
+        }
+        tileShader = null;
+        
+        if (bgType == 0) {
+            Drawable drawable = getContext().getDrawable(R.drawable.bg_checkerboard);
+            if (drawable != null) {
+                int w = drawable.getIntrinsicWidth();
+                int h = drawable.getIntrinsicHeight();
+                if (w <= 0) w = 10;
+                if (h <= 0) h = 10;
+                tileBitmap = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB_8888);
+                Canvas c = new Canvas(tileBitmap);
+                drawable.setBounds(0, 0, w, h);
+                drawable.draw(c);
+                tileShader = new BitmapShader(tileBitmap, Shader.TileMode.REPEAT, Shader.TileMode.REPEAT);
+            }
+        }
+    }
+    
+    public void setBackgroundType(int type) {
+        if (bgType != type) {
+            bgType = type;
+            initTileBitmap();
+            invalidate();
+        }
+    }
+    
+    public int getBackgroundType() {
+        return bgType;
+    }
+    
+    private void drawBackground(Canvas canvas) {
+        if (bgType == 0 && tileShader != null) {
+            bgPaint.setShader(tileShader);
+            canvas.drawRect(canvasBounds, bgPaint);
+        } else if (bgType == 1) {
+            bgPaint.setShader(null);
+            bgPaint.setColor(Color.WHITE);
+            canvas.drawRect(canvasBounds, bgPaint);
+        } else {
+            bgPaint.setShader(null);
+            bgPaint.setColor(Color.BLACK);
+            canvas.drawRect(canvasBounds, bgPaint);
+        }
+    }
+    
+    public void setImageBitmap(Bitmap bitmap) {
+        if (displayBitmap != null && displayBitmap != originalBitmap) {
+            displayBitmap.recycle();
+        }
+        this.originalBitmap = bitmap;
+        createDisplayBitmap();
+    }
+    
+    private void createDisplayBitmap() {
+        if (displayBitmap != null && displayBitmap != originalBitmap) {
+            displayBitmap.recycle();
+            displayBitmap = null;
+        }
+        if (originalBitmap == null || originalBitmap.isRecycled()) {
+            return;
+        }
+        int w = originalBitmap.getWidth();
+        int h = originalBitmap.getHeight();
+        float scale = 1.0f;
+        if (w > MAX_DISPLAY_SIZE || h > MAX_DISPLAY_SIZE) {
+            scale = Math.min((float) MAX_DISPLAY_SIZE / w, (float) MAX_DISPLAY_SIZE / h);
+            int newW = (int) (w * scale);
+            int newH = (int) (h * scale);
+            displayBitmap = Bitmap.createScaledBitmap(originalBitmap, newW, newH, true);
+        } else {
+            displayBitmap = originalBitmap;
+        }
+        displayBitmapScale = scale;
+    }
+    
+    private float displayBitmapScale = 1.0f;
+    
+    public Bitmap getOriginalBitmap() {
+        return originalBitmap;
+    }
+    
+    public float getDisplayBitmapScale() {
+        return displayBitmapScale;
+    }
+    
+    public void onContainerScaled() {
+        containerScale = 1.0f;
+        invalidate();
+    }
+    
+    public void setContainerScale(float scale) {
+        if (scale > 0 && scale != containerScale) {
+            containerScale = scale;
+            invalidate();
+        }
+    }
+    
+    public float getContainerScale() {
+        return containerScale;
+    }
+    
+    public Bitmap getCanvasBitmap() {
+        if (canvasWidth <= 0 || canvasHeight <= 0) {
+            return null;
+        }
+        Bitmap canvasBmp = Bitmap.createBitmap(canvasWidth, canvasHeight, Bitmap.Config.ARGB_8888);
+        Canvas canvas = new Canvas(canvasBmp);
+        drawBackground(canvas);
+        if (displayBitmap != null && !displayBitmap.isRecycled()) {
+            if (displayBitmap == originalBitmap) {
+                canvas.drawBitmap(displayBitmap, imageBounds.left, imageBounds.top, imagePaint);
+            } else {
+                float invScale = 1f / displayBitmapScale;
+                canvas.save();
+                canvas.scale(invScale, invScale);
+                canvas.drawBitmap(displayBitmap, imageBounds.left * displayBitmapScale, 
+                                  imageBounds.top * displayBitmapScale, imagePaint);
+                canvas.restore();
+            }
+        }
+        return canvasBmp;
+    }
+    
+    public void initCanvas(int imgWidth, int imgHeight, float ratio) {
+        this.imageWidth = imgWidth;
+        this.imageHeight = imgHeight;
+        this.coverRatio = ratio;
+        
+        float imgRatio = (float) imgWidth / imgHeight;
+        
+        if (coverRatio >= imgRatio) {
+            extendHeight = imgHeight;
+            extendWidth = (int) (imgHeight * coverRatio);
+        } else {
+            extendWidth = imgWidth;
+            extendHeight = (int) (imgWidth / coverRatio);
+        }
+        
+        canvasHeight = Math.max(imageHeight, extendHeight);
+        canvasWidth = Math.max(imageWidth, extendWidth);
+        
+        float left = (canvasWidth - imageWidth) / 2f;
+        float top = (canvasHeight - imageHeight) / 2f;
+        imageBounds.set(left, top, left + imageWidth, top + imageHeight);
+        canvasBounds.set(0, 0, canvasWidth, canvasHeight);
+        
+        cropRect = new RectF(canvasBounds);
+        
+        requestLayout();
+        invalidate();
+    }
+    
+    public void getDisplayMatrix(Matrix matrix) {
+        if (canvasWidth <= 0 || canvasHeight <= 0 || getWidth() <= 0 || getHeight() <= 0) {
+            return;
+        }
+        matrix.reset();
+        
+        float displayScaleX = (float) getWidth() / canvasWidth;
+        float displayScaleY = (float) getHeight() / canvasHeight;
+        displayScale = Math.min(displayScaleX, displayScaleY);
+        
+        displayOffsetX = (getWidth() - canvasWidth * displayScale) / 2f;
+        displayOffsetY = (getHeight() - canvasHeight * displayScale) / 2f;
+        
+        matrix.postTranslate(displayOffsetX, displayOffsetY);
+        matrix.postScale(displayScale, displayScale);
+    }
+    
+    public float screenToImageX(float screenX) {
+        return (screenX - displayOffsetX) / displayScale;
+    }
+    
+    public float screenToImageY(float screenY) {
+        return (screenY - displayOffsetY) / displayScale;
+    }
+    
+    public float imageToScreenX(float imageX) {
+        return imageX * displayScale + displayOffsetX;
+    }
+    
+    public float imageToScreenY(float imageY) {
+        return imageY * displayScale + displayOffsetY;
+    }
+    
+    public int getImageColorAt(float screenX, float screenY) {
+        Bitmap bmp = (displayBitmap != null) ? displayBitmap : originalBitmap;
+        if (bmp == null || bmp.isRecycled()) {
+            return Color.TRANSPARENT;
+        }
+        float imgX = screenToImageX(screenX);
+        float imgY = screenToImageY(screenY);
+        int bmpX = (int) ((imgX - imageBounds.left) * displayBitmapScale);
+        int bmpY = (int) ((imgY - imageBounds.top) * displayBitmapScale);
+        if (bmpX >= 0 && bmpX < bmp.getWidth() && 
+            bmpY >= 0 && bmpY < bmp.getHeight()) {
+            return bmp.getPixel(bmpX, bmpY);
+        }
+        return Color.TRANSPARENT;
+    }
+    
+    public void setBackgroundColor(int color) {
+        this.backgroundColor = color;
+        if (backgroundColorChangedListener != null) {
+            backgroundColorChangedListener.onBackgroundColorChanged(color);
+        }
+        invalidate();
+    }
+    
+    public int getBackgroundColor() {
+        return backgroundColor;
+    }
+    
+    public int getPreviewColor() {
+        return previewColor;
+    }
+    
+    public float getLastPickX() {
+        return lastPickX;
+    }
+    
+    public float getLastPickY() {
+        return lastPickY;
+    }
+    
+    public int getLastPickImageX() {
+        if (originalBitmap == null || originalBitmap.isRecycled()) {
+            return 0;
+        }
+        float imgX = screenToImageX(lastPickX);
+        float imgY = screenToImageY(lastPickY);
+        int bmpX = (int) ((imgX - imageBounds.left) * displayBitmapScale);
+        int bmpY = (int) ((imgY - imageBounds.top) * displayBitmapScale);
+        return Math.max(0, Math.min(bmpX, originalBitmap.getWidth() - 1));
+    }
+    
+    public int getLastPickImageY() {
+        if (originalBitmap == null || originalBitmap.isRecycled()) {
+            return 0;
+        }
+        float imgX = screenToImageX(lastPickX);
+        float imgY = screenToImageY(lastPickY);
+        int bmpX = (int) ((imgX - imageBounds.left) * displayBitmapScale);
+        int bmpY = (int) ((imgY - imageBounds.top) * displayBitmapScale);
+        return Math.max(0, Math.min(bmpY, originalBitmap.getHeight() - 1));
+    }
+    
+    public void setColorPickMode(boolean enable) {
+        this.colorPickMode = enable;
+        if (enable) {
+            pickX = -1;
+            pickY = -1;
+        }
+        invalidate();
+    }
+    
+    public boolean isColorPickMode() {
+        return colorPickMode;
+    }
+    
+    public void scaleToView(int viewWidth, int viewHeight) {
+        if (viewWidth > 0 && viewHeight > 0 && canvasWidth > 0 && canvasHeight > 0) {
+            float scale = Math.max((float) viewWidth / canvasWidth, (float) viewHeight / canvasHeight);
+            int oldCanvasW = canvasWidth;
+            int oldCanvasH = canvasHeight;
+            canvasWidth = (int) (canvasWidth * scale);
+            canvasHeight = (int) (canvasHeight * scale);
+            
+            float left = (canvasWidth - imageWidth) / 2f;
+            float top = (canvasHeight - imageHeight) / 2f;
+            imageBounds.set(left, top, left + imageWidth, top + imageHeight);
+            canvasBounds.set(0, 0, canvasWidth, canvasHeight);
+            
+            if (cropRect != null) {
+                float scaleX = (float) canvasWidth / oldCanvasW;
+                float scaleY = (float) canvasHeight / oldCanvasH;
+                cropRect.left *= scaleX;
+                cropRect.top *= scaleY;
+                cropRect.right *= scaleX;
+                cropRect.bottom *= scaleY;
+            }
+            
+            requestLayout();
+            invalidate();
+        }
+    }
+    
+    public RectF getCropRect() {
+        return new RectF(cropRect);
+    }
+    
+    public int getCanvasWidth() {
+        return canvasWidth;
+    }
+    
+    public int getCanvasHeight() {
+        return canvasHeight;
+    }
+    
+    public RectF getCanvasBounds() {
+        return new RectF(canvasBounds);
+    }
+    
+    public RectF getImageBounds() {
+        return new RectF(imageBounds);
+    }
+    
+    public float getBitmapScale() {
+        return displayScale;
+    }
+    
+    public float getDisplayScale() {
+        return displayScale;
+    }
+    
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        int w = canvasWidth > 0 ? canvasWidth : 0;
+        int h = canvasHeight > 0 ? canvasHeight : 0;
+        setMeasuredDimension(w, h);
+    }
+    
+    @Override
+    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
+        super.onSizeChanged(w, h, oldw, oldh);
+        getDisplayMatrix(new Matrix());
+    }
+    
+    @Override
+    protected void onDraw(Canvas canvas) {
+        super.onDraw(canvas);
+        
+        if (cropRect == null) return;
+        
+        if (displayBitmap != null && !displayBitmap.isRecycled()) {
+            canvas.save();
+            
+            Matrix matrix = new Matrix();
+            getDisplayMatrix(matrix);
+            canvas.concat(matrix);
+            
+            drawBackground(canvas);
+            
+            if (displayBitmap == originalBitmap) {
+                canvas.drawBitmap(displayBitmap, imageBounds.left, imageBounds.top, imagePaint);
+            } else {
+                float invScale = 1f / displayBitmapScale;
+                canvas.save();
+                canvas.scale(invScale, invScale);
+                canvas.drawBitmap(displayBitmap, imageBounds.left * displayBitmapScale, 
+                                  imageBounds.top * displayBitmapScale, imagePaint);
+                canvas.restore();
+            }
+            
+            canvas.restore();
+            
+            if (containerScale != 1.0f) {
+                canvas.save();
+                canvas.scale(containerScale, containerScale);
+                canvas.drawRect(cropRect, borderPaint);
+                float cornerRadius = 12f / containerScale;
+                canvas.drawCircle(cropRect.left, cropRect.top, cornerRadius, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.top, cornerRadius, cornerPaint);
+                canvas.drawCircle(cropRect.left, cropRect.bottom, cornerRadius, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.bottom, cornerRadius, cornerPaint);
+                canvas.restore();
+            } else {
+                canvas.drawRect(cropRect, borderPaint);
+                canvas.drawCircle(cropRect.left, cropRect.top, 12, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.top, 12, cornerPaint);
+                canvas.drawCircle(cropRect.left, cropRect.bottom, 12, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.bottom, 12, cornerPaint);
+            }
+        } else {
+            if (containerScale != 1.0f) {
+                canvas.save();
+                canvas.scale(containerScale, containerScale);
+                canvas.drawRect(cropRect, borderPaint);
+                float cornerRadius = 12f / containerScale;
+                canvas.drawCircle(cropRect.left, cropRect.top, cornerRadius, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.top, cornerRadius, cornerPaint);
+                canvas.drawCircle(cropRect.left, cropRect.bottom, cornerRadius, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.bottom, cornerRadius, cornerPaint);
+                canvas.restore();
+            } else {
+                canvas.drawRect(cropRect, borderPaint);
+                canvas.drawCircle(cropRect.left, cropRect.top, 12, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.top, 12, cornerPaint);
+                canvas.drawCircle(cropRect.left, cropRect.bottom, 12, cornerPaint);
+                canvas.drawCircle(cropRect.right, cropRect.bottom, 12, cornerPaint);
+            }
+        }
+    }
+    
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {
+        if (cropRect == null || canvasBounds.isEmpty()) return super.onTouchEvent(event);
+        
+        if (event.getPointerCount() == 2) {
+            int action = event.getActionMasked();
+            if (action == MotionEvent.ACTION_POINTER_DOWN) {
+                initialSpan = getSpan(event);
+                return true;
+            } else if (action == MotionEvent.ACTION_MOVE) {
+                float span = getSpan(event);
+                if (initialSpan > 0) {
+                    float scale = span / initialSpan;
+                    float centerX = cropRect.centerX();
+                    float centerY = cropRect.centerY();
+                    float newWidth = cropRect.width() * scale;
+                    float newHeight = newWidth / coverRatio;
+                    
+                    newWidth = Math.max(minSize, Math.min(newWidth, canvasBounds.width()));
+                    newHeight = newWidth / coverRatio;
+                    
+                    float newLeft = centerX - newWidth / 2;
+                    float newTop = centerY - newHeight / 2;
+                    float newRight = centerX + newWidth / 2;
+                    float newBottom = centerY + newHeight / 2;
+                    
+                    if (newLeft >= canvasBounds.left && newRight <= canvasBounds.right &&
+                        newTop >= canvasBounds.top && newBottom <= canvasBounds.bottom) {
+                        cropRect.set(newLeft, newTop, newRight, newBottom);
+                    }
+                    
+                    initialSpan = span;
+                    invalidate();
+                }
+                return true;
+            }
+        }
+        
+        float x = event.getX();
+        float y = event.getY();
+        
+        RectF bounds = canvasBounds;
+        if (containerScale != 1.0f) {
+            x = x / containerScale;
+            y = y / containerScale;
+            bounds = new RectF(
+                canvasBounds.left,
+                canvasBounds.top,
+                canvasBounds.right,
+                canvasBounds.bottom
+            );
+        }
+        
+        if (colorPickMode) {
+            if (event.getAction() == MotionEvent.ACTION_DOWN || event.getAction() == MotionEvent.ACTION_MOVE) {
+                if (originalBitmap != null && !originalBitmap.isRecycled()) {
+                    float imgX = screenToImageX(x);
+                    float imgY = screenToImageY(y);
+                    if (imageBounds.contains(imgX, imgY)) {
+                        previewColor = getImageColorAt(x, y);
+                    } else if (canvasBounds.contains(x, y)) {
+                        previewColor = (bgType == 1) ? Color.WHITE : Color.BLACK;
+                    } else {
+                        previewColor = Color.TRANSPARENT;
+                    }
+                    lastPickX = x;
+                    lastPickY = y;
+                    if (backgroundColorChangedListener != null) {
+                        backgroundColorChangedListener.onBackgroundColorChanged(previewColor);
+                    }
+                }
+                return true;
+            }
+            if (event.getAction() == MotionEvent.ACTION_UP) {
+                if (canvasBounds.contains(x, y)) {
+                    int pickedColor;
+                    float imgX = screenToImageX(x);
+                    float imgY = screenToImageY(y);
+                    if (imageBounds.contains(imgX, imgY)) {
+                        int colorAtPoint = getImageColorAt(x, y);
+                        pickedColor = colorAtPoint;
+                        backgroundColor = colorAtPoint;
+                    } else {
+                        pickedColor = (bgType == 1) ? Color.WHITE : Color.BLACK;
+                    }
+                    if (colorPickedListener != null) {
+                        colorPickedListener.onColorPicked(pickedColor);
+                    }
+                }
+                if (colorPickEndListener != null) {
+                    colorPickEndListener.onColorPickEnd();
+                }
+                previewColor = 0;
+                invalidate();
+                return true;
+            }
+            return true;
+        }
+        
+        switch (event.getAction()) {
+            case MotionEvent.ACTION_DOWN:
+                lastX = x;
+                lastY = y;
+                activeCorner = getActiveCorner(x, y);
+                return true;
+                
+            case MotionEvent.ACTION_MOVE:
+                float dx = x - lastX;
+                float dy = y - lastY;
+                
+                if (activeCorner == CORNER_CENTER) {
+                    float newLeft = cropRect.left + dx;
+                    float newTop = cropRect.top + dy;
+                    float newRight = cropRect.right + dx;
+                    float newBottom = cropRect.bottom + dy;
+                    
+                    if (newLeft >= bounds.left && newRight <= bounds.right) {
+                        cropRect.left = newLeft;
+                        cropRect.right = newRight;
+                    }
+                    if (newTop >= bounds.top && newBottom <= bounds.bottom) {
+                        cropRect.top = newTop;
+                        cropRect.bottom = newBottom;
+                    }
+                } else if (activeCorner == CORNER_TOP_LEFT) {
+                    adjustCorner(cropRect.left + dx, cropRect.top + dy, true, true);
+                } else if (activeCorner == CORNER_TOP_RIGHT) {
+                    adjustCorner(cropRect.right + dx, cropRect.top + dy, false, true);
+                } else if (activeCorner == CORNER_BOTTOM_LEFT) {
+                    adjustCorner(cropRect.left + dx, cropRect.bottom + dy, true, false);
+                } else if (activeCorner == CORNER_BOTTOM_RIGHT) {
+                    adjustCorner(cropRect.right + dx, cropRect.bottom + dy, false, false);
+                }
+                
+                lastX = x;
+                lastY = y;
+                invalidate();
+                return true;
+                
+            case MotionEvent.ACTION_UP:
+                activeCorner = -1;
+                return true;
+        }
+        return super.onTouchEvent(event);
+    }
+    
+    private void adjustCorner(float nx, float ny, boolean left, boolean top) {
+        float newWidth;
+        float newLeft = cropRect.left;
+        float newTop = cropRect.top;
+        float newRight = cropRect.right;
+        float newBottom = cropRect.bottom;
+        
+        if (left) {
+            newWidth = cropRect.width() - (nx - cropRect.left);
+            newLeft = Math.max(canvasBounds.left, Math.min(nx, cropRect.right - minSize));
+        } else {
+            newWidth = nx - cropRect.left;
+            newRight = Math.min(canvasBounds.right, Math.max(nx, cropRect.left + minSize));
+            newLeft = cropRect.left;
+        }
+        
+        float newHeight = newWidth / coverRatio;
+        
+        if (top) {
+            newTop = Math.max(canvasBounds.top, Math.min(cropRect.bottom - minSize, cropRect.bottom - newHeight));
+            newBottom = newTop + newHeight;
+        } else {
+            newBottom = Math.min(canvasBounds.bottom, Math.max(cropRect.top + minSize, cropRect.top + newHeight));
+            newTop = newBottom - newHeight;
+        }
+        
+        if (left) {
+            cropRect.left = newLeft;
+            cropRect.right = newLeft + newWidth;
+        } else {
+            cropRect.right = newRight;
+            cropRect.left = newRight - newWidth;
+        }
+        
+        if (top) {
+            cropRect.top = newTop;
+            cropRect.bottom = newTop + newHeight;
+        } else {
+            cropRect.bottom = newBottom;
+            cropRect.top = newBottom - newHeight;
+        }
+    }
+    
+    private int getActiveCorner(float x, float y) {
+        float dx = Math.abs(x - cropRect.left);
+        float dy = Math.abs(y - cropRect.top);
+        float dx2 = Math.abs(x - cropRect.right);
+        float dy2 = Math.abs(y - cropRect.bottom);
+        
+        if (dx <= touchArea && dy <= touchArea) {
+            return CORNER_TOP_LEFT;
+        }
+        if (dx2 <= touchArea && dy <= touchArea) {
+            return CORNER_TOP_RIGHT;
+        }
+        if (dx <= touchArea && dy2 <= touchArea) {
+            return CORNER_BOTTOM_LEFT;
+        }
+        if (dx2 <= touchArea && dy2 <= touchArea) {
+            return CORNER_BOTTOM_RIGHT;
+        }
+        if (x > cropRect.left && x < cropRect.right && y > cropRect.top && y < cropRect.bottom) {
+            return CORNER_CENTER;
+        }
+        return -1;
+    }
+    
+    private float getSpan(MotionEvent event) {
+        float x0 = event.getX(0);
+        float y0 = event.getY(0);
+        float x1 = event.getX(1);
+        float y1 = event.getY(1);
+        return (float) Math.sqrt((x1 - x0) * (x1 - x0) + (y1 - y0) * (y1 - y0));
+    }
+    
+    public int getColorAt(float x, float y) {
+        return getImageColorAt(x, y);
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/CropOverlayView.java b/gallery/src/main/java/cc/winboll/studio/gallery/CropOverlayView.java
new file mode 100644
index 0000000..9d01dc3
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/CropOverlayView.java
@@ -0,0 +1,224 @@
+package cc.winboll.studio.gallery;
+
+import android.content.Context;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Paint;
+import android.graphics.RectF;
+import android.util.AttributeSet;
+import android.view.MotionEvent;
+import android.view.View;
+
+public class CropOverlayView extends View {
+    public interface OnCanvasSizeChangedListener {
+        void onCanvasSizeChanged(RectF canvasBounds);
+    }
+    
+    private OnCanvasSizeChangedListener canvasSizeChangedListener;
+    
+    private Paint borderPaint;
+    private Paint cornerPaint;
+    private RectF cropRect;
+    private int touchArea = 50;
+    
+    private float lastX, lastY;
+    private int activeCorner = -1;
+    private static final int CORNER_TOP_LEFT = 0;
+    private static final int CORNER_TOP_RIGHT = 1;
+    private static final int CORNER_BOTTOM_LEFT = 2;
+    private static final int CORNER_BOTTOM_RIGHT = 3;
+    private static final int CORNER_CENTER = 4;
+    
+    private float targetRatio = 2.0f;
+    private RectF canvasBounds = new RectF();
+    private float minSize = 50;
+    
+    public CropOverlayView(Context context) {
+        super(context);
+        initPaints();
+    }
+    
+    public CropOverlayView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initPaints();
+    }
+    
+    public CropOverlayView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initPaints();
+    }
+    
+    private void initPaints() {
+        borderPaint = new Paint();
+        borderPaint.setColor(Color.parseColor("#CCAA00"));
+        borderPaint.setStyle(Paint.Style.STROKE);
+        borderPaint.setStrokeWidth(3);
+        
+        cornerPaint = new Paint();
+        cornerPaint.setColor(Color.WHITE);
+        cornerPaint.setStyle(Paint.Style.FILL);
+    }
+    
+    public void setTargetRatio(float ratio) {
+        this.targetRatio = ratio;
+    }
+    
+    public float getTargetRatio() {
+        return targetRatio;
+    }
+    
+    public void setOnCanvasSizeChangedListener(OnCanvasSizeChangedListener listener) {
+        this.canvasSizeChangedListener = listener;
+    }
+    
+    public void initCanvas(int canvasW, int canvasH) {
+        canvasBounds.set(0, 0, canvasW, canvasH);
+        
+        cropRect = new RectF(0, 0, canvasW, canvasH);
+        
+        if (canvasSizeChangedListener != null) {
+            canvasSizeChangedListener.onCanvasSizeChanged(new RectF(canvasBounds));
+        }
+        invalidate();
+    }
+    
+    public RectF getCropRect() {
+        return new RectF(cropRect);
+    }
+    
+    public RectF getCanvasBounds() {
+        return new RectF(canvasBounds);
+    }
+    
+    @Override
+    protected void onDraw(Canvas canvas) {
+        super.onDraw(canvas);
+        
+        canvas.drawColor(Color.TRANSPARENT);
+        
+        if (cropRect != null) {
+            canvas.drawRect(cropRect, borderPaint);
+            
+            canvas.drawCircle(cropRect.left, cropRect.top, 12, cornerPaint);
+            canvas.drawCircle(cropRect.right, cropRect.top, 12, cornerPaint);
+            canvas.drawCircle(cropRect.left, cropRect.bottom, 12, cornerPaint);
+            canvas.drawCircle(cropRect.right, cropRect.bottom, 12, cornerPaint);
+        }
+    }
+    
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {
+        if (cropRect == null || canvasBounds.isEmpty()) return false;
+        
+        float x = event.getX();
+        float y = event.getY();
+        
+        switch (event.getAction()) {
+            case MotionEvent.ACTION_DOWN:
+                lastX = x;
+                lastY = y;
+                activeCorner = getActiveCorner(x, y);
+                return true;
+                
+            case MotionEvent.ACTION_MOVE:
+                float dx = x - lastX;
+                float dy = y - lastY;
+                
+                if (activeCorner == CORNER_CENTER) {
+                    float newLeft = cropRect.left + dx;
+                    float newTop = cropRect.top + dy;
+                    float newRight = cropRect.right + dx;
+                    float newBottom = cropRect.bottom + dy;
+                    
+                    if (newLeft >= canvasBounds.left && newRight <= canvasBounds.right) {
+                        cropRect.left = newLeft;
+                        cropRect.right = newRight;
+                    }
+                    if (newTop >= canvasBounds.top && newBottom <= canvasBounds.bottom) {
+                        cropRect.top = newTop;
+                        cropRect.bottom = newBottom;
+                    }
+                } else if (activeCorner == CORNER_TOP_LEFT) {
+                    adjustCorner(cropRect.left + dx, cropRect.top + dy, true, true);
+                } else if (activeCorner == CORNER_TOP_RIGHT) {
+                    adjustCorner(cropRect.right + dx, cropRect.top + dy, false, true);
+                } else if (activeCorner == CORNER_BOTTOM_LEFT) {
+                    adjustCorner(cropRect.left + dx, cropRect.bottom + dy, true, false);
+                } else if (activeCorner == CORNER_BOTTOM_RIGHT) {
+                    adjustCorner(cropRect.right + dx, cropRect.bottom + dy, false, false);
+                }
+                
+                lastX = x;
+                lastY = y;
+                invalidate();
+                return true;
+                
+            case MotionEvent.ACTION_UP:
+                activeCorner = -1;
+                return true;
+        }
+        return super.onTouchEvent(event);
+    }
+    
+    private void adjustCorner(float nx, float ny, boolean left, boolean top) {
+        float newWidth;
+        float newLeft = cropRect.left;
+        float newTop = cropRect.top;
+        float newRight = cropRect.right;
+        float newBottom = cropRect.bottom;
+        
+        if (left) {
+            newWidth = cropRect.width() - (nx - cropRect.left);
+            newLeft = Math.max(canvasBounds.left, Math.min(nx, cropRect.right - minSize));
+        } else {
+            newWidth = nx - cropRect.left;
+            newRight = Math.min(canvasBounds.right, Math.max(nx, cropRect.left + minSize));
+            newLeft = cropRect.left;
+        }
+        
+        float newHeight = newWidth / targetRatio;
+        
+        if (top) {
+            newTop = Math.max(canvasBounds.top, Math.min(cropRect.bottom - minSize, cropRect.bottom - newHeight));
+            newBottom = newTop + newHeight;
+        } else {
+            newBottom = Math.min(canvasBounds.bottom, Math.max(cropRect.top + minSize, cropRect.top + newHeight));
+            newTop = newBottom - newHeight;
+        }
+        
+        if (left) {
+            cropRect.left = newLeft;
+            cropRect.right = newLeft + newWidth;
+        } else {
+            cropRect.right = newRight;
+            cropRect.left = newRight - newWidth;
+        }
+        
+        if (top) {
+            cropRect.top = newTop;
+            cropRect.bottom = newTop + newHeight;
+        } else {
+            cropRect.bottom = newBottom;
+            cropRect.top = newBottom - newHeight;
+        }
+    }
+    
+    private int getActiveCorner(float x, float y) {
+        if (Math.abs(x - cropRect.left) <= touchArea && Math.abs(y - cropRect.top) <= touchArea) {
+            return CORNER_TOP_LEFT;
+        }
+        if (Math.abs(x - cropRect.right) <= touchArea && Math.abs(y - cropRect.top) <= touchArea) {
+            return CORNER_TOP_RIGHT;
+        }
+        if (Math.abs(x - cropRect.left) <= touchArea && Math.abs(y - cropRect.bottom) <= touchArea) {
+            return CORNER_BOTTOM_LEFT;
+        }
+        if (Math.abs(x - cropRect.right) <= touchArea && Math.abs(y - cropRect.bottom) <= touchArea) {
+            return CORNER_BOTTOM_RIGHT;
+        }
+        if (cropRect.contains(x, y)) {
+            return CORNER_CENTER;
+        }
+        return -1;
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/GlobalWinBoLLApplication.java b/gallery/src/main/java/cc/winboll/studio/gallery/GlobalWinBoLLApplication.java
new file mode 100644
index 0000000..a79f82d
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/GlobalWinBoLLApplication.java
@@ -0,0 +1,47 @@
+package cc.winboll.studio.gallery;
+
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.gallery.utils.BackgroundUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/04/24 15:23
+ */
+public class GlobalWinBoLLApplication extends GlobalApplication {
+    
+    public static final String TAG = "GlobalWinBoLLApplication";
+    
+
+@Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "onCreate");
+        setIsDebugging(BuildConfig.DEBUG);
+        //setIsDebugging(false);
+
+        WinBoLLActivityManager.init(this);
+
+        BackgroundUtils.initFromPreferences(this);
+
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+        // 设置 Toast 布局样式
+        //ToastUtils.setView(R.layout.view_toast);
+        //ToastUtils.setStyle(new WhiteToastStyle());
+        //ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
+
+        //CrashHandler.getInstance().registerGlobal(this);
+        //CrashHandler.getInstance().registerPart(this);
+    }
+
+@Override
+    public void onTerminate() {
+        super.onTerminate();
+        LogUtils.d(TAG, "onTerminate");
+        ToastUtils.release();
+    }
+    
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/ImageAdapter.java b/gallery/src/main/java/cc/winboll/studio/gallery/ImageAdapter.java
new file mode 100644
index 0000000..833a307
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/ImageAdapter.java
@@ -0,0 +1,247 @@
+package cc.winboll.studio.gallery;
+
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.net.Uri;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.view.ViewGroup;
+import android.widget.ImageView;
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import com.bumptech.glide.Glide;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class ImageAdapter extends RecyclerView.Adapter<ImageAdapter.ViewHolder> {
+    public static final String TAG = "ImageAdapter";
+    private ArrayList<Uri> imageUrls = new ArrayList<>();
+    private ArrayList<String> imagePaths = new ArrayList<>();
+    private OnImageClickListener listener;
+    private int bgType = 0;
+    private Preferences prefs;
+    private PinnedImageDbHelper pinnedDbHelper;
+    private AlbumCoverDbHelper coverDbHelper;
+    private String albumPath;
+    
+    private int getBgRes() {
+        switch (bgType) {
+            case 0:
+                return R.drawable.bg_checkerboard;
+            case 1:
+                return R.drawable.bg_white;
+            case 2:
+                return R.drawable.bg_black;
+            default:
+                return R.drawable.bg_checkerboard;
+        }
+    }
+
+    public interface OnImageClickListener {
+        void onImageClick(int position, ArrayList<Uri> urls, ArrayList<String> paths);
+    }
+
+    public void setOnImageClickListener(OnImageClickListener listener) {
+        this.listener = listener;
+    }
+
+    public void setData(ArrayList<Uri> urls, ArrayList<String> paths) {
+        this.imageUrls = urls;
+        this.imagePaths = paths;
+        sortPinnedFirst();
+        LogUtils.d(TAG, "setData: " + urls.size() + " images");
+        notifyDataSetChanged();
+    }
+    
+    private void sortPinnedFirst() {
+        if (pinnedDbHelper == null || imagePaths.isEmpty()) {
+            return;
+        }
+        ArrayList<Uri> pinnedUrls = new ArrayList<>();
+        ArrayList<String> pinnedPaths = new ArrayList<>();
+        ArrayList<Uri> unpinnedUrls = new ArrayList<>();
+        ArrayList<String> unpinnedPaths = new ArrayList<>();
+        for (int i = 0; i < imagePaths.size(); i++) {
+            String path = imagePaths.get(i);
+            if (pinnedDbHelper.isPinned(path)) {
+                pinnedUrls.add(imageUrls.get(i));
+                pinnedPaths.add(path);
+            } else {
+                unpinnedUrls.add(imageUrls.get(i));
+                unpinnedPaths.add(path);
+            }
+        }
+        
+        imageUrls.clear();
+        imagePaths.clear();
+        imageUrls.addAll(pinnedUrls);
+        imageUrls.addAll(unpinnedUrls);
+        imagePaths.addAll(pinnedPaths);
+        imagePaths.addAll(unpinnedPaths);
+    }
+    
+    public void setContext(android.content.Context context) {
+        prefs = new Preferences(context);
+        bgType = prefs.getBgType();
+        pinnedDbHelper = PinnedImageDbHelper.getInstance(context);
+        coverDbHelper = AlbumCoverDbHelper.getInstance(context);
+    }
+    
+    public void setAlbumPath(String albumPath) {
+        this.albumPath = albumPath;
+    }
+    
+    public int getCropWidth() {
+        return prefs != null ? prefs.getCoverWidth() : 240;
+    }
+    
+    public int getCropHeight() {
+        return prefs != null ? prefs.getCoverHeight() : 120;
+    }
+    
+    public void refreshBg() {
+        if (prefs != null) {
+            bgType = prefs.getBgType();
+            notifyDataSetChanged();
+        }
+    }
+    
+    public void refreshPinned() {
+        if (pinnedDbHelper == null || imagePaths.isEmpty()) {
+            return;
+        }
+        sortPinnedFirst();
+        notifyDataSetChanged();
+    }
+    
+    private void showContextMenu(final View view, final int position) {
+        final String imagePath = imagePaths.get(position);
+        final Uri imageUri = imageUrls.get(position);
+        final boolean[] isPinned = {pinnedDbHelper != null && pinnedDbHelper.isPinned(imagePath)};
+        final boolean[] isCover = {false};
+        if (coverDbHelper != null && albumPath != null) {
+            String originalPath = coverDbHelper.getOriginalImagePath(albumPath);
+            isCover[0] = originalPath != null && originalPath.equals(imagePath);
+        }
+        
+        android.app.AlertDialog.Builder builder = new android.app.AlertDialog.Builder(view.getContext());
+        builder.setTitle("Image");
+        
+        String[] items;
+        if (isPinned[0]) {
+            if (isCover[0]) {
+                items = new String[]{"取消置顶", "调整封面", "取消封面"};
+            } else {
+                items = new String[]{"取消置顶", "设置为封面"};
+            }
+        } else {
+            if (isCover[0]) {
+                items = new String[]{"置顶", "调整封面", "取消封面"};
+            } else {
+                items = new String[]{"置顶", "设置为封面"};
+            }
+        }
+        
+        builder.setItems(items, new android.content.DialogInterface.OnClickListener() {
+            @Override
+            public void onClick(android.content.DialogInterface dialog, int which) {
+                if (which == 0) {
+                    if (pinnedDbHelper != null) {
+                        if (isPinned[0]) {
+                            pinnedDbHelper.unpinImage(imagePath);
+                        } else {
+                            pinnedDbHelper.pinImage(imagePath);
+                        }
+                        refreshPinned();
+                    }
+                } else if (which == 1) {
+                    if (coverDbHelper != null && albumPath != null) {
+                        Intent cropIntent = new Intent(view.getContext(), CropActivity.class);
+                        cropIntent.putExtra(CropActivity.EXTRA_IMAGE_URI, imageUri);
+                        cropIntent.putExtra(CropActivity.EXTRA_IMAGE_PATH, imagePath);
+                        cropIntent.putExtra(CropActivity.EXTRA_ALBUM_PATH, albumPath);
+                        cropIntent.putExtra(CropActivity.EXTRA_CROP_WIDTH, getCropWidth());
+                        cropIntent.putExtra(CropActivity.EXTRA_CROP_HEIGHT, getCropHeight());
+                        ((AlbumActivity) view.getContext()).startActivityForResult(cropIntent, 100);
+                    }
+                } else if (which == 2) {
+                    if (coverDbHelper != null && albumPath != null && isCover[0]) {
+                        coverDbHelper.deleteCover(albumPath);
+                        notifyDataSetChanged();
+                    }
+                }
+            }
+        });
+        builder.show();
+    }
+    
+    @NonNull
+    @Override
+    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        View view = LayoutInflater.from(parent.getContext())
+            .inflate(R.layout.item_gallery, parent, false);
+        return new ViewHolder(view);
+    }
+
+    @Override
+    public void onBindViewHolder(@NonNull ViewHolder holder, final int position) {
+        holder.imageView.setBackgroundResource(getBgRes());
+        
+        Glide.with(holder.imageView.getContext())
+            .load(imageUrls.get(position))
+            .centerCrop()
+            .into(holder.imageView);
+        
+        final ArrayList<Uri> urls = imageUrls;
+        final ArrayList<String> paths = imagePaths;
+        final String imagePath = imagePaths.get(position);
+        
+        boolean isPinned = pinnedDbHelper != null && pinnedDbHelper.isPinned(imagePath);
+        holder.pinIcon.setVisibility(isPinned ? View.VISIBLE : View.GONE);
+        
+        boolean isCover = false;
+        if (coverDbHelper != null && albumPath != null) {
+            String originalPath = coverDbHelper.getOriginalImagePath(albumPath);
+            isCover = originalPath != null && originalPath.equals(imagePath);
+        }
+        holder.coverIcon.setVisibility(isCover ? View.VISIBLE : View.GONE);
+        
+        holder.itemView.setOnClickListener(new OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                if (listener != null) {
+                    listener.onImageClick(position, urls, paths);
+                }
+            }
+        });
+        
+        holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {
+            @Override
+            public boolean onLongClick(View v) {
+                showContextMenu(holder.itemView, position);
+                return true;
+            }
+        });
+    }
+
+    @Override
+    public int getItemCount() {
+        return imageUrls.size();
+    }
+
+    static class ViewHolder extends RecyclerView.ViewHolder {
+        ImageView imageView;
+        ImageView pinIcon;
+        ImageView coverIcon;
+        ViewHolder(View itemView) {
+            super(itemView);
+            imageView = itemView.findViewById(R.id.image);
+            pinIcon = itemView.findViewById(R.id.pin_icon);
+            coverIcon = itemView.findViewById(R.id.cover_icon);
+        }
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/ImagePagerAdapter.java b/gallery/src/main/java/cc/winboll/studio/gallery/ImagePagerAdapter.java
new file mode 100644
index 0000000..e420f9b
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/ImagePagerAdapter.java
@@ -0,0 +1,57 @@
+package cc.winboll.studio.gallery;
+
+import android.net.Uri;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ImageView;
+import androidx.annotation.NonNull;
+import androidx.viewpager.widget.PagerAdapter;
+import com.bumptech.glide.Glide;
+import com.bumptech.glide.load.engine.DiskCacheStrategy;
+import java.util.ArrayList;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class ImagePagerAdapter extends PagerAdapter {
+    public static final String TAG = "ImagePagerAdapter";
+    private ArrayList<Uri> imageUrls;
+
+    public ImagePagerAdapter(ArrayList<Uri> imageUrls) {
+        this.imageUrls = imageUrls;
+        LogUtils.d(TAG, "ImagePagerAdapter created with " + imageUrls.size() + " images");
+    }
+
+    @Override
+    public int getCount() {
+        return imageUrls.size();
+    }
+
+    @NonNull
+    @Override
+    public Object instantiateItem(@NonNull ViewGroup container, int position) {
+        View view = LayoutInflater.from(container.getContext())
+            .inflate(R.layout.item_image_pager, container, false);
+        view.setBackgroundResource(R.color.black);
+        ImageView imageView = view.findViewById(R.id.image);
+        
+        Glide.with(imageView.getContext())
+            .load(imageUrls.get(position))
+            .diskCacheStrategy(DiskCacheStrategy.NONE)
+            .skipMemoryCache(true)
+            .into(imageView);
+        
+        container.addView(view);
+        return view;
+    }
+
+    @Override
+    public void destroyItem(@NonNull ViewGroup container, int position, @NonNull Object object) {
+        container.removeView((View) object);
+    }
+
+    @Override
+    public boolean isViewFromObject(@NonNull View view, @NonNull Object object) {
+        return view == object;
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/ImageViewerActivity.java b/gallery/src/main/java/cc/winboll/studio/gallery/ImageViewerActivity.java
new file mode 100644
index 0000000..2bb7aac
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/ImageViewerActivity.java
@@ -0,0 +1,397 @@
+package cc.winboll.studio.gallery;
+
+import android.app.Activity;
+import android.app.AlertDialog;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.provider.MediaStore;
+import android.view.GestureDetector;
+import android.view.MotionEvent;
+import android.view.View;
+import android.view.View.OnTouchListener;
+import android.view.WindowManager;
+import android.widget.ImageButton;
+import android.widget.Toast;
+import androidx.viewpager.widget.ViewPager;
+import java.io.File;
+import java.util.ArrayList;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class ImageViewerActivity extends Activity implements ViewPager.OnPageChangeListener {
+    public static final String TAG = "ImageViewerActivity";
+    public static final String EXTRA_IMAGE_URLS = "image_urls";
+    public static final String EXTRA_POSITIONS = "image_positions";
+    public static final String EXTRA_POSITION = "position";
+    
+    private ArrayList<Uri> imageUrls;
+    private ArrayList<String> imagePaths;
+    private int currentPosition;
+    private ViewPager viewPager;
+    private View toolbar;
+    private ImageButton btnBack;
+    private ImageButton btnDelete;
+    private ImageButton btnShare;
+    private ImageButton btnInfo;
+    private ImageButton btnGallery;
+    private GestureDetector gestureDetector;
+    private TrashManager trashManager;
+    private Preferences prefs;
+    
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
+            WindowManager.LayoutParams.FLAG_FULLSCREEN);
+        setContentView(R.layout.activity_image_viewer);
+        LogUtils.d(TAG, "onCreate");
+        
+        imageUrls = getIntent().getParcelableArrayListExtra(EXTRA_IMAGE_URLS);
+        imagePaths = getIntent().getStringArrayListExtra(EXTRA_POSITIONS);
+        currentPosition = getIntent().getIntExtra(EXTRA_POSITION, 0);
+        
+        trashManager = new TrashManager(this);
+        prefs = new Preferences(this);
+        
+        viewPager = findViewById(R.id.view_pager);
+        toolbar = findViewById(R.id.toolbar);
+        btnBack = findViewById(R.id.btn_back);
+        btnDelete = findViewById(R.id.btn_delete);
+        btnShare = findViewById(R.id.btn_share);
+        btnInfo = findViewById(R.id.btn_info);
+        
+        btnGallery = findViewById(R.id.btn_gallery);
+        
+        ImagePagerAdapter adapter = new ImagePagerAdapter(imageUrls);
+        viewPager.setAdapter(adapter);
+        viewPager.setCurrentItem(currentPosition);
+        viewPager.addOnPageChangeListener(this);
+        
+        gestureDetector = new GestureDetector(this, new GestureDetector.SimpleOnGestureListener() {
+            @Override
+            public boolean onSingleTapConfirmed(MotionEvent e) {
+                toggleToolbar();
+                return true;
+            }
+        });
+        
+        viewPager.setOnTouchListener(new OnTouchListener() {
+            @Override
+            public boolean onTouch(View v, MotionEvent event) {
+                return gestureDetector.onTouchEvent(event);
+            }
+        });
+        
+        btnBack.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                finish();
+            }
+        });
+        
+        btnDelete.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                showDeleteDialog();
+            }
+        });
+        
+        btnShare.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                shareCurrentImage();
+            }
+        });
+        
+        btnInfo.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                showImageInfo();
+            }
+        });
+        
+        btnGallery.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                Toast.makeText(ImageViewerActivity.this, "Gallery", Toast.LENGTH_SHORT).show();
+                if (imageUrls != null && currentPosition >= 0 && currentPosition < imageUrls.size()) {
+                    Uri imageUri = imageUrls.get(currentPosition);
+                    Intent intent = new Intent(Intent.ACTION_VIEW);
+                    intent.setDataAndType(imageUri, "image/*");
+                    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+                    startActivity(Intent.createChooser(intent, "打开相册"));
+                }
+            }
+        });
+    }
+    
+    private void toggleToolbar() {
+        if (toolbar.getVisibility() == View.VISIBLE) {
+            toolbar.setVisibility(View.GONE);
+        } else {
+            toolbar.setVisibility(View.VISIBLE);
+        }
+    }
+    
+    private void showDeleteDialog() {
+        new AlertDialog.Builder(this)
+            .setMessage("Delete to trash?")
+            .setPositiveButton("Yes", new android.content.DialogInterface.OnClickListener() {
+                @Override
+                public void onClick(android.content.DialogInterface dialog, int which) {
+                    moveToTrash();
+                }
+            })
+            .setNegativeButton("No", null)
+            .show();
+    }
+    
+    private void moveToTrash() {
+        LogUtils.d(TAG, "moveToTrash");
+        if (currentPosition >= 0 && currentPosition < imageUrls.size()) {
+            String imagePath = "";
+            if (imagePaths != null && currentPosition < imagePaths.size()) {
+                imagePath = imagePaths.get(currentPosition);
+            } else {
+                imagePath = getPathFromUri(imageUrls.get(currentPosition));
+            }
+            
+            Uri imageUri = imageUrls.get(currentPosition);
+            long result = -1;
+            
+            if (!imagePath.isEmpty()) {
+                result = trashManager.addToTrash(imagePath);
+            }
+            
+            if (result > 0) {
+                try {
+                    getContentResolver().delete(imageUri, null, null);
+                } catch (Exception e) {
+                    e.printStackTrace();
+                }
+                android.widget.Toast.makeText(this, "Moved to trash", android.widget.Toast.LENGTH_SHORT).show();
+                LogUtils.i(TAG, "Moved to trash");
+                removeCurrentImage();
+            } else {
+                try {
+                    int deleted = getContentResolver().delete(imageUri, null, null);
+                    android.widget.Toast.makeText(this, "Deleted: " + deleted, android.widget.Toast.LENGTH_SHORT).show();
+                    removeCurrentImage();
+                } catch (Exception e) {
+                    e.printStackTrace();
+                    removeCurrentImage();
+                }
+            }
+        }
+    }
+    
+    private void removeCurrentImage() {
+        imageUrls.remove(currentPosition);
+        if (imagePaths != null) {
+            imagePaths.remove(currentPosition);
+        }
+        
+        if (imageUrls.isEmpty()) {
+            finish();
+        } else {
+            if (currentPosition >= imageUrls.size()) {
+                currentPosition = imageUrls.size() - 1;
+            }
+            viewPager.setAdapter(new ImagePagerAdapter(imageUrls));
+            viewPager.setCurrentItem(currentPosition);
+        }
+    }
+    
+    private String getPathFromUri(Uri uri) {
+        String[] projection = { MediaStore.Images.Media.DATA };
+        android.database.Cursor cursor = getContentResolver().query(uri, projection, null, null, null);
+        if (cursor != null) {
+            try {
+                if (cursor.moveToFirst()) {
+                    int columnIndex = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA);
+                    return cursor.getString(columnIndex);
+                }
+            } finally {
+                cursor.close();
+            }
+        }
+        return uri.getPath();
+    }
+    
+    private void shareCurrentImage() {
+        if (currentPosition >= 0 && currentPosition < imageUrls.size()) {
+            Uri imageUri = imageUrls.get(currentPosition);
+            Intent shareIntent = new Intent(Intent.ACTION_SEND);
+            shareIntent.setType("image/*");
+            shareIntent.putExtra(Intent.EXTRA_STREAM, imageUri);
+            shareIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+            startActivity(Intent.createChooser(shareIntent, "Share Image"));
+        }
+    }
+    
+    private void showImageInfo() {
+        if (currentPosition < 0 || currentPosition >= imageUrls.size()) {
+            return;
+        }
+        
+        String imagePath = "";
+        if (imagePaths != null && currentPosition < imagePaths.size()) {
+            imagePath = imagePaths.get(currentPosition);
+        } else {
+            imagePath = getPathFromUri(imageUrls.get(currentPosition));
+        }
+        
+        File imageFile = new File(imagePath);
+        if (!imageFile.exists()) {
+            imageFile = new File(imagePath);
+        }
+        
+        android.widget.LinearLayout layout = new android.widget.LinearLayout(this);
+        layout.setOrientation(android.widget.LinearLayout.VERTICAL);
+        layout.setPadding(48, 32, 48, 32);
+        
+        android.widget.TextView labelPath = new android.widget.TextView(this);
+        labelPath.setText("Path:");
+        labelPath.setTextColor(getColor(android.R.color.darker_gray));
+        labelPath.setTextSize(14);
+        labelPath.setTypeface(null, android.graphics.Typeface.BOLD);
+        layout.addView(labelPath);
+        
+        android.widget.TextView valuePath = new android.widget.TextView(this);
+        valuePath.setText(imagePath);
+        valuePath.setTextColor(getColor(android.R.color.black));
+        valuePath.setTextSize(14);
+        valuePath.setTextIsSelectable(true);
+        layout.addView(valuePath);
+        
+        if (imageFile.exists()) {
+            long sizeBytes = imageFile.length();
+            String size;
+            if (sizeBytes < 1024) {
+                size = sizeBytes + " B";
+            } else if (sizeBytes < 1024 * 1024) {
+                size = String.format("%.2f KB", sizeBytes / 1024.0);
+            } else {
+                size = String.format("%.2f MB", sizeBytes / (1024.0 * 1024.0));
+            }
+            
+            android.widget.TextView labelSize = new android.widget.TextView(this);
+            labelSize.setText("Size:");
+            labelSize.setTextColor(getColor(android.R.color.darker_gray));
+            labelSize.setTextSize(14);
+            labelSize.setTypeface(null, android.graphics.Typeface.BOLD);
+            layout.addView(labelSize);
+            
+            android.widget.TextView valueSize = new android.widget.TextView(this);
+            valueSize.setText(size);
+            valueSize.setTextColor(getColor(android.R.color.black));
+            valueSize.setTextSize(14);
+            valueSize.setTextIsSelectable(true);
+            layout.addView(valueSize);
+        }
+        
+        try {
+            android.graphics.BitmapFactory.Options options = new android.graphics.BitmapFactory.Options();
+            options.inJustDecodeBounds = true;
+            android.graphics.BitmapFactory.decodeFile(imagePath, options);
+            if (options.outWidth > 0 && options.outHeight > 0) {
+                android.widget.TextView labelPixels = new android.widget.TextView(this);
+                labelPixels.setText("Pixels:");
+                labelPixels.setTextColor(getColor(android.R.color.darker_gray));
+                labelPixels.setTextSize(14);
+                labelPixels.setTypeface(null, android.graphics.Typeface.BOLD);
+                layout.addView(labelPixels);
+                
+                android.widget.TextView valuePixels = new android.widget.TextView(this);
+                valuePixels.setText(options.outWidth + " x " + options.outHeight);
+                valuePixels.setTextColor(getColor(android.R.color.black));
+                valuePixels.setTextSize(14);
+                valuePixels.setTextIsSelectable(true);
+                layout.addView(valuePixels);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "get pixels error: " + e.getMessage());
+        }
+        
+        try {
+            String[] projection = {
+                MediaStore.Images.Media.DATE_ADDED,
+                MediaStore.Images.Media.DATE_MODIFIED,
+                MediaStore.Images.Media.DATE_TAKEN
+            };
+            android.database.Cursor cursor = getContentResolver().query(
+                imageUrls.get(currentPosition), projection, null, null, null);
+            if (cursor != null) {
+                if (cursor.moveToFirst()) {
+                    int dateAddedCol = cursor.getColumnIndex(MediaStore.Images.Media.DATE_ADDED);
+                    int dateTakenCol = cursor.getColumnIndex(MediaStore.Images.Media.DATE_TAKEN);
+                    
+                    java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
+                    
+                    if (dateTakenCol >= 0) {
+                        long dateTaken = cursor.getLong(dateTakenCol);
+                        if (dateTaken > 0) {
+                            android.widget.TextView labelTaken = new android.widget.TextView(this);
+                            labelTaken.setText("Date Taken:");
+                            labelTaken.setTextColor(getColor(android.R.color.darker_gray));
+                            labelTaken.setTextSize(14);
+                            labelTaken.setTypeface(null, android.graphics.Typeface.BOLD);
+                            layout.addView(labelTaken);
+                            
+                            android.widget.TextView valueTaken = new android.widget.TextView(this);
+                            valueTaken.setText(sdf.format(new java.util.Date(dateTaken)));
+                            valueTaken.setTextColor(getColor(android.R.color.black));
+                            valueTaken.setTextSize(14);
+                            valueTaken.setTextIsSelectable(true);
+                            layout.addView(valueTaken);
+                        }
+                    }
+                    if (dateAddedCol >= 0) {
+                        long dateAdded = cursor.getLong(dateAddedCol);
+                        if (dateAdded > 0) {
+                            android.widget.TextView labelAdded = new android.widget.TextView(this);
+                            labelAdded.setText("Date Added:");
+                            labelAdded.setTextColor(getColor(android.R.color.darker_gray));
+                            labelAdded.setTextSize(14);
+                            labelAdded.setTypeface(null, android.graphics.Typeface.BOLD);
+                            layout.addView(labelAdded);
+                            
+                            android.widget.TextView valueAdded = new android.widget.TextView(this);
+                            valueAdded.setText(sdf.format(new java.util.Date(dateAdded * 1000)));
+                            valueAdded.setTextColor(getColor(android.R.color.black));
+                            valueAdded.setTextSize(14);
+                            valueAdded.setTextIsSelectable(true);
+                            layout.addView(valueAdded);
+                        }
+                    }
+                }
+                cursor.close();
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "get date error: " + e.getMessage());
+        }
+        
+        new AlertDialog.Builder(this)
+            .setTitle("Image Info")
+            .setView(layout)
+            .setPositiveButton("OK", null)
+            .show();
+    }
+    
+    @Override
+    public void onPageSelected(int position) {
+        currentPosition = position;
+    }
+    
+    @Override
+    public void onPageScrollStateChanged(int state) {}
+    
+    @Override
+    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {}
+    
+    @Override
+    public void onBackPressed() {
+        finish();
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/MainActivity.java b/gallery/src/main/java/cc/winboll/studio/gallery/MainActivity.java
new file mode 100644
index 0000000..bb1e352
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/MainActivity.java
@@ -0,0 +1,419 @@
+package cc.winboll.studio.gallery;
+
+import android.Manifest;
+import android.content.BroadcastReceiver;
+import android.content.ContentResolver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.pm.PackageManager;
+import android.database.Cursor;
+import android.media.MediaScannerConnection;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Environment;
+import android.provider.MediaStore;
+import android.provider.Settings;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+import androidx.recyclerview.widget.GridLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.gallery.AlbumAdapter.OnAlbumClickListener;
+import cc.winboll.studio.gallery.utils.BackgroundUtils;
+import cc.winboll.studio.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import com.a4455jkjh.colorpicker.ColorPickerDialog;
+import com.google.android.material.floatingactionbutton.FloatingActionButton;
+import java.io.File;
+import java.io.FileFilter;
+import java.io.FilenameFilter;
+import java.util.ArrayList;
+
+public class MainActivity extends AppCompatActivity {
+    public static final String TAG = "MainActivity";
+    private static final int PERMISSION_REQUEST_CODE = 100;
+    private static final int MANAGE_PERMISSION_REQUEST_CODE = 101;
+    private RecyclerView recyclerView;
+    private AlbumAdapter adapter;
+    private Preferences prefs;
+    private FloatingActionButton fabScrollTop;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        LogUtils.d(TAG, "onCreate");
+
+        View content = findViewById(android.R.id.content);
+        if (content != null) {
+            content.setBackground(BackgroundUtils.getInstance().getDrawable());
+        }
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+
+        prefs = new Preferences(this);
+
+        recyclerView = findViewById(R.id.recycler_view);
+        recyclerView.setLayoutManager(new GridLayoutManager(this, 2));
+        adapter = new AlbumAdapter();
+        adapter.setContext(this);
+        recyclerView.setAdapter(adapter);
+
+        fabScrollTop = findViewById(R.id.fab_scroll_top);
+        fabScrollTop.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					recyclerView.scrollToPosition(0);
+				}
+			});
+
+        recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
+				@Override
+				public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
+					super.onScrolled(recyclerView, dx, dy);
+					GridLayoutManager layoutManager = (GridLayoutManager) recyclerView.getLayoutManager();
+					if (layoutManager != null) {
+						int firstVisible = layoutManager.findFirstVisibleItemPosition();
+						if (firstVisible > 0) {
+							fabScrollTop.setVisibility(View.VISIBLE);
+						} else {
+							fabScrollTop.setVisibility(View.GONE);
+						}
+					}
+				}
+			});
+
+        adapter.setOnAlbumClickListener(new OnAlbumClickListener() {
+				@Override
+				public void onAlbumClick(Album album) {
+					Intent intent = new Intent(MainActivity.this, AlbumActivity.class);
+					intent.putExtra(AlbumActivity.EXTRA_ALBUM_PATH, album.getPath());
+					intent.putExtra(AlbumActivity.EXTRA_ALBUM_NAME, album.getName());
+					startActivity(intent);
+				}
+			});
+
+        checkAndRequestPermissions();
+    }
+
+    private void checkAndRequestPermissions() {
+        LogUtils.i(TAG, "checkAndRequestPermissions");
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+            if (!Environment.isExternalStorageManager()) {
+                try {
+                    Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
+                    intent.setData(Uri.parse("package:" + getPackageName()));
+                    startActivityForResult(intent, MANAGE_PERMISSION_REQUEST_CODE);
+                } catch (Exception e) {
+                    Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
+                    startActivityForResult(intent, MANAGE_PERMISSION_REQUEST_CODE);
+                }
+                return;
+            }
+        }
+
+        if (checkPermission()) {
+            loadAlbums();
+        } else {
+            requestPermission();
+        }
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        if (requestCode == MANAGE_PERMISSION_REQUEST_CODE) {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+                if (Environment.isExternalStorageManager()) {
+                    loadAlbums();
+                } else {
+                    Toast.makeText(this, "Permission required", Toast.LENGTH_SHORT).show();
+                }
+            }
+        }
+    }
+
+    private boolean checkPermission() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+            return Environment.isExternalStorageManager();
+        }
+        return ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) 
+            == PackageManager.PERMISSION_GRANTED;
+    }
+
+    private void requestPermission() {
+        ActivityCompat.requestPermissions(this, 
+										  new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 
+										  PERMISSION_REQUEST_CODE);
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, 
+										   @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        if (requestCode == PERMISSION_REQUEST_CODE) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                loadAlbums();
+            } else {
+                Toast.makeText(this, "Permission denied", Toast.LENGTH_SHORT).show();
+            }
+        }
+    }
+
+	private void loadAlbums() {
+        LogUtils.d(TAG, "loadAlbums");
+        String folderPath = prefs.getFolderPath();
+        File baseFolder = new File(folderPath);
+        LogUtils.d(TAG, "baseFolder: " + baseFolder.getAbsolutePath() + ", exists=" + baseFolder.exists());
+
+        if (!baseFolder.exists() || !baseFolder.isDirectory()) {
+            folderPath = Preferences.getDefaultPath();
+            baseFolder = new File(folderPath);
+            LogUtils.d(TAG, "try default: " + baseFolder.getAbsolutePath() + ", exists=" + baseFolder.exists());
+            if (!baseFolder.exists()) {
+                folderPath = Environment.getExternalStorageDirectory() + "/Pictures";
+                baseFolder = new File(folderPath);
+                LogUtils.d(TAG, "try Pictures: " + baseFolder.getAbsolutePath() + ", exists=" + baseFolder.exists());
+            }
+        }
+
+        AlbumCoverDbHelper coverDbHelper = AlbumCoverDbHelper.getInstance(this);
+        ArrayList<Album> albums = new ArrayList<>();
+
+        FileFilter directoryFilter = new FileFilter() {
+            @Override
+            public boolean accept(File file) {
+                return file.isDirectory();
+            }
+        };
+        File[] subfolders = baseFolder.listFiles(directoryFilter);
+        LogUtils.d(TAG, "subfolders: " + (subfolders != null ? subfolders.length : 0));
+        if (subfolders != null) {
+            for (File subfolder : subfolders) {
+                LogUtils.d(TAG, "scanning folder: " + subfolder.getName());
+                String albumPath = subfolder.getAbsolutePath();
+                String coverPath = coverDbHelper.getCover(albumPath);
+                LogUtils.d(TAG, "loadAlbums: album=" + albumPath + ", coverPath=" + coverPath);
+                Uri coverUri = null;
+                if (coverPath != null) {
+                    File coverFile = new File(coverPath);
+                    if (coverFile.exists()) {
+                        coverUri = Uri.fromFile(coverFile);
+                        LogUtils.d(TAG, "loadAlbums: cover from file=" + coverFile.getAbsolutePath());
+                    } else {
+                        coverUri = getUriFromPath(coverPath);
+                        LogUtils.d(TAG, "loadAlbums: cover from media store path=" + coverPath);
+                    }
+                }
+                if (coverUri == null) {
+                    ArrayList<Uri> images = getImagesInFolder(albumPath);
+                    if (!images.isEmpty()) {
+                        coverUri = images.get(0);
+                    }
+                }
+                ArrayList<Uri> allImages = getImagesInFolder(albumPath);
+                if (coverUri != null || !allImages.isEmpty()) {
+                    if (coverUri == null && !allImages.isEmpty()) {
+                        coverUri = allImages.get(0);
+                    }
+                    int imageCount = allImages.size();
+                    albums.add(new Album(subfolder.getName(), albumPath, coverUri, imageCount));
+                    LogUtils.d(TAG, "album added: " + subfolder.getName() + ", " + imageCount + " images");
+                }
+            }
+        }
+
+        if (albums.isEmpty()) {
+            Toast.makeText(this, R.string.no_images_found, Toast.LENGTH_SHORT).show();
+            LogUtils.i(TAG, "No albums found");
+        }
+        adapter.setData(albums);
+        LogUtils.d(TAG, "Loaded " + albums.size() + " albums");
+    }
+
+    private Uri getUriFromPath(String path) {
+        String[] projection = { MediaStore.Images.Media._ID };
+        String selection = MediaStore.Images.Media.DATA + " = ?";
+        String[] selectionArgs = { path };
+        try (Cursor cursor = getContentResolver().query(
+			MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
+			projection, selection, selectionArgs, null)) {
+            if (cursor != null) {
+                if (cursor.moveToFirst()) {
+                    long id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
+                    return Uri.withAppendedPath(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, String.valueOf(id));
+                }
+            }
+        }
+        return null;
+    }
+
+    private ArrayList<Uri> getImagesInFolder(String folderPath) {
+        ArrayList<Uri> imageUrls = new ArrayList<>();
+        ContentResolver contentResolver = getContentResolver();
+        Uri collection = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
+
+        String selection = MediaStore.Images.Media.DATA + " LIKE ?";
+        String[] selectionArgs = new String[]{folderPath + "/%"};
+        String sortOrder = MediaStore.Images.Media.DATE_ADDED + " DESC";
+
+        LogUtils.d(TAG, "getImagesInFolder: " + folderPath);
+
+        try (Cursor cursor = contentResolver.query(collection, null, selection, selectionArgs, sortOrder)) {
+            if (cursor != null) {
+                LogUtils.d(TAG, "cursor count: " + cursor.getCount());
+                int dataColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA);
+                while (cursor.moveToNext()) {
+                    String path = cursor.getString(dataColumn);
+                    if (path != null) {
+                        long id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
+                        Uri contentUri = Uri.withAppendedPath(collection, String.valueOf(id));
+                        LogUtils.d(TAG, "image: id=" + id + ", path=" + path);
+                        imageUrls.add(contentUri);
+                    }
+                }
+            }
+        }
+        LogUtils.d(TAG, "found " + imageUrls.size() + " images");
+        return imageUrls;
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.menu_main, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(@NonNull MenuItem item) {
+        int id = item.getItemId();
+        if (id == R.id.action_mi_gallery) {
+            Toast.makeText(this, "Gallery clicked", Toast.LENGTH_SHORT).show();
+            Intent intent = new Intent(Intent.ACTION_MAIN);
+            intent.addCategory(Intent.CATEGORY_APP_GALLERY);
+            startActivity(intent);
+            return true;
+        } else if (id == R.id.action_change_bg_color) {
+            //Toast.makeText(this, "修改背景颜色", Toast.LENGTH_SHORT).show();
+			if (BackgroundUtils.DrawableType.COLOR == BackgroundUtils.getInstance().getDrawableType()) {
+
+				ColorPickerDialog dlg = new ColorPickerDialog(this, BackgroundUtils.getInstance().getColor());
+				dlg.setOnColorChangedListener(new com.a4455jkjh.colorpicker.view.OnColorChangedListener() {
+
+						@Override
+						public void beforeColorChanged() {
+						}
+
+						@Override
+						public void onColorChanged(int color) {
+							BackgroundUtils.getInstance().initFromColor(MainActivity.this, color);
+							View content = findViewById(android.R.id.content);
+							if (content != null) {
+								content.setBackground(BackgroundUtils.getInstance().getDrawable());
+							}
+						}
+
+						@Override
+						public void afterColorChanged() {
+						}
+					});
+				dlg.show();
+			}
+            return true;
+        } else if (id == R.id.action_settings) {
+            startActivity(new Intent(this, SettingsActivity.class));
+            return true;
+        } else if (id == R.id.action_about) {
+            startActivity(new Intent(this, AboutActivity.class));
+            return true;
+        } else if (id == R.id.action_trash) {
+            startActivity(new Intent(this, TrashActivity.class));
+            return true;
+        } else if (id == R.id.action_debug) {
+            LogActivity.startLogActivity(this);
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    private BroadcastReceiver coverUpdatedReceiver = new BroadcastReceiver() {
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            if (Preferences.ACTION_COVER_UPDATED.equals(intent.getAction())) {
+                loadAlbums();
+            }
+        }
+    };
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        registerReceiver(coverUpdatedReceiver, new IntentFilter(Preferences.ACTION_COVER_UPDATED));
+        if (checkPermission()) {
+            scanMediaStore();
+            loadAlbums();
+        }
+        if (adapter != null) {
+            adapter.refreshBg();
+            adapter.refreshPinned();
+            adapter.refreshCover();
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        unregisterReceiver(coverUpdatedReceiver);
+    }
+
+    private void scanMediaStore() {
+        String folderPath = prefs.getFolderPath();
+        File baseFolder = new File(folderPath);
+        if (baseFolder.exists() && baseFolder.isDirectory()) {
+            File[] subfolders = baseFolder.listFiles(new FileFilter() {
+					@Override
+					public boolean accept(File file) {
+						return file.isDirectory();
+					}
+				});
+            if (subfolders != null) {
+                ArrayList<String> paths = new ArrayList<>();
+                for (File subfolder : subfolders) {
+                    File[] images = subfolder.listFiles(new FilenameFilter() {
+							@Override
+							public boolean accept(File dir, String name) {
+								String lower = name.toLowerCase();
+								return lower.endsWith(".jpg") || lower.endsWith(".jpeg") 
+									|| lower.endsWith(".png") || lower.endsWith(".gif")
+									|| lower.endsWith(".webp") || lower.endsWith(".bmp");
+							}
+						});
+                    if (images != null) {
+                        for (File img : images) {
+                            paths.add(img.getAbsolutePath());
+                        }
+                    }
+                }
+                if (!paths.isEmpty()) {
+                    LogUtils.d(TAG, "scanning " + paths.size() + " files to MediaStore");
+                    String[] pathArray = paths.toArray(new String[0]);
+                    MediaScannerConnection.scanFile(this, pathArray, null, new MediaScannerConnection.OnScanCompletedListener() {
+							@Override
+							public void onScanCompleted(String path, Uri uri) {
+								LogUtils.d(TAG, "scanCompleted: " + path + " -> " + uri);
+							}
+						});
+                }
+            }
+        }
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/PinnedAlbumDbHelper.java b/gallery/src/main/java/cc/winboll/studio/gallery/PinnedAlbumDbHelper.java
new file mode 100644
index 0000000..6dc35e9
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/PinnedAlbumDbHelper.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.gallery;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class PinnedAlbumDbHelper extends SQLiteOpenHelper {
+    public static final String TAG = "PinnedAlbumDbHelper";
+    private static final String DB_NAME = "pinned_album.db";
+    private static final int DB_VERSION = 1;
+    private static final String TABLE_NAME = "pinned_albums";
+    private static final String COLUMN_PATH = "album_path";
+    
+    private static final String SQL_CREATE = "CREATE TABLE " + TABLE_NAME + " (" 
+        + COLUMN_PATH + " TEXT PRIMARY KEY)";
+    
+    private static PinnedAlbumDbHelper dbHelper;
+    
+    public static PinnedAlbumDbHelper getInstance(Context context) {
+        if (dbHelper == null) {
+            dbHelper = new PinnedAlbumDbHelper(context.getApplicationContext());
+        }
+        return dbHelper;
+    }
+    
+    public PinnedAlbumDbHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+    
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        db.execSQL(SQL_CREATE);
+    }
+    
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME);
+        onCreate(db);
+    }
+    
+    public void pinAlbum(String albumPath) {
+        SQLiteDatabase db = getWritableDatabase();
+        ContentValues values = new ContentValues();
+        values.put(COLUMN_PATH, albumPath);
+        db.insertWithOnConflict(TABLE_NAME, null, values, SQLiteDatabase.CONFLICT_IGNORE);
+        LogUtils.d(TAG, "pinAlbum: " + albumPath);
+    }
+    
+    public void unpinAlbum(String albumPath) {
+        SQLiteDatabase db = getWritableDatabase();
+        db.delete(TABLE_NAME, COLUMN_PATH + " = ?", new String[]{albumPath});
+        LogUtils.d(TAG, "unpinAlbum: " + albumPath);
+    }
+    
+    public boolean isPinned(String albumPath) {
+        SQLiteDatabase db = getReadableDatabase();
+        Cursor cursor = db.query(TABLE_NAME, null, COLUMN_PATH + " = ?", 
+            new String[]{albumPath}, null, null, null);
+        boolean pinned = cursor.getCount() > 0;
+        cursor.close();
+        return pinned;
+    }
+    
+    public String[] getPinnedPaths() {
+        SQLiteDatabase db = getReadableDatabase();
+        Cursor cursor = db.query(TABLE_NAME, new String[]{COLUMN_PATH}, null, null, null, null, null);
+        String[] paths = new String[cursor.getCount()];
+        int i = 0;
+        while (cursor.moveToNext()) {
+            paths[i++] = cursor.getString(0);
+        }
+        cursor.close();
+        return paths;
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/PinnedImageDbHelper.java b/gallery/src/main/java/cc/winboll/studio/gallery/PinnedImageDbHelper.java
new file mode 100644
index 0000000..460d6e9
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/PinnedImageDbHelper.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.gallery;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class PinnedImageDbHelper extends SQLiteOpenHelper {
+    public static final String TAG = "PinnedImageDbHelper";
+    private static final String DB_NAME = "pinned_image.db";
+    private static final int DB_VERSION = 1;
+    private static final String TABLE_NAME = "pinned_images";
+    private static final String COLUMN_PATH = "image_path";
+    
+    private static final String SQL_CREATE = "CREATE TABLE " + TABLE_NAME + " (" 
+        + COLUMN_PATH + " TEXT PRIMARY KEY)";
+    
+    private static PinnedImageDbHelper dbHelper;
+    
+    public static PinnedImageDbHelper getInstance(Context context) {
+        if (dbHelper == null) {
+            dbHelper = new PinnedImageDbHelper(context.getApplicationContext());
+        }
+        return dbHelper;
+    }
+    
+    public PinnedImageDbHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+    
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        db.execSQL(SQL_CREATE);
+    }
+    
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME);
+        onCreate(db);
+    }
+    
+    public void pinImage(String imagePath) {
+        SQLiteDatabase db = getWritableDatabase();
+        ContentValues values = new ContentValues();
+        values.put(COLUMN_PATH, imagePath);
+        db.insertWithOnConflict(TABLE_NAME, null, values, SQLiteDatabase.CONFLICT_IGNORE);
+        LogUtils.d(TAG, "pinImage: " + imagePath);
+    }
+    
+    public void unpinImage(String imagePath) {
+        SQLiteDatabase db = getWritableDatabase();
+        db.delete(TABLE_NAME, COLUMN_PATH + " = ?", new String[]{imagePath});
+        LogUtils.d(TAG, "unpinImage: " + imagePath);
+    }
+    
+    public boolean isPinned(String imagePath) {
+        SQLiteDatabase db = getReadableDatabase();
+        Cursor cursor = db.query(TABLE_NAME, null, COLUMN_PATH + " = ?", 
+            new String[]{imagePath}, null, null, null);
+        boolean pinned = cursor.getCount() > 0;
+        cursor.close();
+        return pinned;
+    }
+    
+    public String[] getPinnedPaths() {
+        SQLiteDatabase db = getReadableDatabase();
+        Cursor cursor = db.query(TABLE_NAME, new String[]{COLUMN_PATH}, null, null, null, null, null);
+        String[] paths = new String[cursor.getCount()];
+        int i = 0;
+        while (cursor.moveToNext()) {
+            paths[i++] = cursor.getString(0);
+        }
+        cursor.close();
+        return paths;
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/Preferences.java b/gallery/src/main/java/cc/winboll/studio/gallery/Preferences.java
new file mode 100644
index 0000000..d005cd9
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/Preferences.java
@@ -0,0 +1,93 @@
+package cc.winboll.studio.gallery;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class Preferences {
+    public static final String TAG = "Preferences";
+    private static final String PREF_NAME = "gallery_prefs";
+    private static final String KEY_FOLDER_PATH = "folder_path";
+    private static final String KEY_BG_TYPE = "bg_type";
+    private static final String KEY_ALBUM_SORT_MODE = "album_sort_mode";
+    private static final String KEY_COVER_WIDTH = "cover_width";
+    private static final String KEY_COVER_HEIGHT = "cover_height";
+    private static final String KEY_COVER_RATIO = "cover_ratio";
+
+    public static final String ACTION_COVER_UPDATED = "cc.winboll.studio.gallery.COVER_UPDATED";
+
+    private static final int DEFAULT_BG_TYPE = 0;
+    private static final int DEFAULT_SORT_MODE = 0;
+    private static final int DEFAULT_COVER_WIDTH = 240;
+    private static final int DEFAULT_COVER_HEIGHT = 120;
+    private static final float DEFAULT_COVER_RATIO = 2.0f;
+    private static final String DEFAULT_PATH = "/storage/emulated/0/Pictures/Gallery/owner";
+    
+    public static final int SORT_TIME_DESC = 0;
+    public static final int SORT_TIME_ASC = 1;
+    public static final int SORT_NAME_DESC = 2;
+    public static final int SORT_NAME_ASC = 3;
+    
+    public static String getDefaultPath() {
+        return DEFAULT_PATH;
+    }
+    
+    private final SharedPreferences prefs;
+    
+    public Preferences(Context context) {
+        prefs = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
+    }
+    
+    public String getFolderPath() {
+        String path = prefs.getString(KEY_FOLDER_PATH, DEFAULT_PATH);
+        LogUtils.d(TAG, "getFolderPath: " + path);
+        return path;
+    }
+    
+    public void setFolderPath(String path) {
+        LogUtils.d(TAG, "setFolderPath: " + path);
+        prefs.edit().putString(KEY_FOLDER_PATH, path).apply();
+    }
+    
+    public int getBgType() {
+        return prefs.getInt(KEY_BG_TYPE, DEFAULT_BG_TYPE);
+    }
+    
+    public void setBgType(int type) {
+        LogUtils.d(TAG, "setBgType: " + type);
+        prefs.edit().putInt(KEY_BG_TYPE, type).apply();
+    }
+    
+    public int getAlbumSortMode() {
+        return prefs.getInt(KEY_ALBUM_SORT_MODE, DEFAULT_SORT_MODE);
+    }
+    
+    public void setAlbumSortMode(int mode) {
+        LogUtils.d(TAG, "setAlbumSortMode: " + mode);
+        prefs.edit().putInt(KEY_ALBUM_SORT_MODE, mode).apply();
+    }
+    
+    public int getCoverWidth() {
+        return prefs.getInt(KEY_COVER_WIDTH, DEFAULT_COVER_WIDTH);
+    }
+    
+    public void setCoverWidth(int width) {
+        prefs.edit().putInt(KEY_COVER_WIDTH, width).apply();
+    }
+    
+    public int getCoverHeight() {
+        return prefs.getInt(KEY_COVER_HEIGHT, DEFAULT_COVER_HEIGHT);
+    }
+    
+    public void setCoverHeight(int height) {
+        prefs.edit().putInt(KEY_COVER_HEIGHT, height).apply();
+    }
+    
+    public float getCoverRatio() {
+        return prefs.getFloat(KEY_COVER_RATIO, DEFAULT_COVER_RATIO);
+    }
+    
+    public void setCoverRatio(float ratio) {
+        prefs.edit().putFloat(KEY_COVER_RATIO, ratio).apply();
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/SettingsActivity.java b/gallery/src/main/java/cc/winboll/studio/gallery/SettingsActivity.java
new file mode 100644
index 0000000..c730c73
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/SettingsActivity.java
@@ -0,0 +1,46 @@
+package cc.winboll.studio.gallery;
+
+import android.os.Bundle;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.TextView;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class SettingsActivity extends AppCompatActivity {
+    public static final String TAG = "SettingsActivity";
+    private Preferences prefs;
+    private EditText editFolderPath;
+    private TextView textCurrentPath;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_settings);
+        LogUtils.d(TAG, "onCreate");
+        
+        prefs = new Preferences(this);
+        
+        editFolderPath = findViewById(R.id.edit_folder_path);
+        textCurrentPath = findViewById(R.id.text_current_path);
+        Button btnSave = findViewById(R.id.btn_save);
+        
+        String currentPath = prefs.getFolderPath();
+        editFolderPath.setText(currentPath);
+        textCurrentPath.setText("Current: " + currentPath);
+        
+        btnSave.setOnClickListener(new OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                String newPath = editFolderPath.getText().toString().trim();
+                if (!newPath.isEmpty()) {
+                    prefs.setFolderPath(newPath);
+                    textCurrentPath.setText("Current: " + newPath);
+                }
+                finish();
+            }
+        });
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/TrashActivity.java b/gallery/src/main/java/cc/winboll/studio/gallery/TrashActivity.java
new file mode 100644
index 0000000..ab30395
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/TrashActivity.java
@@ -0,0 +1,193 @@
+package cc.winboll.studio.gallery;
+
+import android.content.ContentResolver;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.database.Cursor;
+import android.net.Uri;
+import android.os.Bundle;
+import android.provider.MediaStore;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+import androidx.recyclerview.widget.GridLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import java.io.File;
+import java.util.ArrayList;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class TrashActivity extends AppCompatActivity {
+    public static final String TAG = "TrashActivity";
+    private static final int PERMISSION_REQUEST_CODE = 102;
+    private RecyclerView recyclerView;
+    private TrashAdapter adapter;
+    private TrashManager trashManager;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        LogUtils.d(TAG, "onCreate");
+        
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        getSupportActionBar().setTitle("Trash");
+        
+        trashManager = new TrashManager(this);
+        
+        recyclerView = findViewById(R.id.recycler_view);
+        recyclerView.setLayoutManager(new GridLayoutManager(this, 3));
+        adapter = new TrashAdapter();
+        recyclerView.setAdapter(adapter);
+        
+        adapter.setOnTrashClickListener(new TrashAdapter.OnTrashClickListener() {
+            @Override
+            public void onRestoreClick(int position) {
+                restoreImage(position);
+            }
+            
+            @Override
+            public void onDeleteClick(int position) {
+                permanentlyDelete(position);
+            }
+        });
+        
+        if (checkPermission()) {
+            loadTrash();
+        } else {
+            requestPermission();
+        }
+    }
+
+    private boolean checkPermission() {
+        return ContextCompat.checkSelfPermission(this, android.Manifest.permission.READ_EXTERNAL_STORAGE) 
+            == PackageManager.PERMISSION_GRANTED;
+    }
+
+    private void requestPermission() {
+        ActivityCompat.requestPermissions(this, 
+            new String[]{android.Manifest.permission.READ_EXTERNAL_STORAGE}, 
+            PERMISSION_REQUEST_CODE);
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, 
+            @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        if (requestCode == PERMISSION_REQUEST_CODE) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                loadTrash();
+            } else {
+                Toast.makeText(this, "Permission denied", Toast.LENGTH_SHORT).show();
+            }
+        }
+    }
+
+    private void loadTrash() {
+        LogUtils.d(TAG, "loadTrash");
+        Cursor cursor = trashManager.getTrashList();
+        ArrayList<TrashItem> items = new ArrayList<TrashItem>();
+        ArrayList<Uri> uris = new ArrayList<Uri>();
+        
+        String trashPath = TrashDbHelper.getTrashPath();
+        File trashDir = new File(trashPath);
+        
+        if (cursor != null && cursor.getCount() > 0) {
+            cursor.moveToFirst();
+            do {
+                try {
+                    long id = cursor.getLong(cursor.getColumnIndexOrThrow("_id"));
+                    String fileName = cursor.getString(cursor.getColumnIndexOrThrow("file_name"));
+                    String originalPath = cursor.getString(cursor.getColumnIndexOrThrow("original_path"));
+                    String originalFolder = cursor.getString(cursor.getColumnIndexOrThrow("original_folder"));
+                    
+                    TrashItem item = new TrashItem();
+                    item.id = id;
+                    item.fileName = fileName;
+                    item.originalPath = originalPath;
+                    item.originalFolder = originalFolder;
+                    
+                    File trashFile = new File(trashDir, fileName);
+                    if (trashFile.exists()) {
+                        items.add(item);
+                        uris.add(Uri.fromFile(trashFile));
+                    }
+                } catch (Exception e) {
+                    e.printStackTrace();
+                }
+            } while (cursor.moveToNext());
+            cursor.close();
+        }
+        
+        adapter.setData(items, uris);
+        
+        if (items.isEmpty()) {
+            Toast.makeText(this, "Trash is empty", Toast.LENGTH_SHORT).show();
+        }
+    }
+
+    private void restoreImage(int position) {
+        LogUtils.d(TAG, "restoreImage: " + position);
+        long id = adapter.getItemId(position);
+        String fileName = adapter.getFileName(position);
+        String originalPath = adapter.getOriginalPath(position);
+        
+        if (trashManager.restore(id, fileName, originalPath)) {
+            Toast.makeText(this, "Image restored", Toast.LENGTH_SHORT).show();
+            LogUtils.i(TAG, "Image restored");
+            loadTrash();
+        } else {
+            Toast.makeText(this, "Restore failed", Toast.LENGTH_SHORT).show();
+        }
+    }
+
+    private void permanentlyDelete(int position) {
+        long id = adapter.getItemId(position);
+        String fileName = adapter.getFileName(position);
+        
+        if (trashManager.deletePermanently(id, fileName)) {
+            Toast.makeText(this, "Image deleted", Toast.LENGTH_SHORT).show();
+            loadTrash();
+        } else {
+            Toast.makeText(this, "Delete failed", Toast.LENGTH_SHORT).show();
+        }
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.menu_trash, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(@NonNull MenuItem item) {
+        if (item.getItemId() == R.id.action_clear_trash) {
+            trashManager.clearTrash();
+            Toast.makeText(this, "Trash cleared", Toast.LENGTH_SHORT).show();
+            loadTrash();
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+    
+    @Override
+    protected void onResume() {
+        super.onResume();
+        if (checkPermission()) {
+            loadTrash();
+        }
+    }
+    
+    public static class TrashItem {
+        public long id;
+        public String fileName;
+        public String originalPath;
+        public String originalFolder;
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/TrashAdapter.java b/gallery/src/main/java/cc/winboll/studio/gallery/TrashAdapter.java
new file mode 100644
index 0000000..49a7cae
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/TrashAdapter.java
@@ -0,0 +1,111 @@
+package cc.winboll.studio.gallery;
+
+import android.net.Uri;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.view.ViewGroup;
+import android.widget.ImageView;
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import com.bumptech.glide.Glide;
+import java.util.ArrayList;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class TrashAdapter extends RecyclerView.Adapter<TrashAdapter.ViewHolder> {
+    public static final String TAG = "TrashAdapter";
+    private ArrayList<TrashActivity.TrashItem> trashItems = new ArrayList<TrashActivity.TrashItem>();
+    private ArrayList<Uri> imageUrls = new ArrayList<Uri>();
+    private OnTrashClickListener listener;
+
+    public interface OnTrashClickListener {
+        void onRestoreClick(int position);
+        void onDeleteClick(int position);
+    }
+
+    public void setOnTrashClickListener(OnTrashClickListener listener) {
+        this.listener = listener;
+    }
+
+    public void setData(ArrayList<TrashActivity.TrashItem> items, ArrayList<Uri> uris) {
+        this.trashItems = items;
+        this.imageUrls = uris;
+        LogUtils.d(TAG, "setData: " + items.size() + " items");
+        notifyDataSetChanged();
+    }
+
+    public long getItemId(int position) {
+        if (position >= 0 && position < trashItems.size()) {
+            return trashItems.get(position).id;
+        }
+        return -1;
+    }
+    
+    public String getFileName(int position) {
+        if (position >= 0 && position < trashItems.size()) {
+            return trashItems.get(position).fileName;
+        }
+        return "";
+    }
+    
+    public String getOriginalPath(int position) {
+        if (position >= 0 && position < trashItems.size()) {
+            return trashItems.get(position).originalPath;
+        }
+        return "";
+    }
+
+    @NonNull
+    @Override
+    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+        View view = LayoutInflater.from(parent.getContext())
+            .inflate(R.layout.item_trash, parent, false);
+        return new ViewHolder(view);
+    }
+
+    @Override
+    public void onBindViewHolder(@NonNull ViewHolder holder, final int position) {
+        if (position < imageUrls.size()) {
+            Glide.with(holder.imageView.getContext())
+                .load(imageUrls.get(position))
+                .centerCrop()
+                .into(holder.imageView);
+        }
+        
+        holder.btnRestore.setOnClickListener(new OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                if (listener != null) {
+                    listener.onRestoreClick(position);
+                }
+            }
+        });
+        
+        holder.btnDelete.setOnClickListener(new OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                if (listener != null) {
+                    listener.onDeleteClick(position);
+                }
+            }
+        });
+    }
+
+    @Override
+    public int getItemCount() {
+        return trashItems.size();
+    }
+
+    static class ViewHolder extends RecyclerView.ViewHolder {
+        ImageView imageView;
+        ImageView btnRestore;
+        ImageView btnDelete;
+        ViewHolder(View itemView) {
+            super(itemView);
+            imageView = itemView.findViewById(R.id.image);
+            btnRestore = itemView.findViewById(R.id.btn_restore);
+            btnDelete = itemView.findViewById(R.id.btn_delete);
+        }
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/TrashDbHelper.java b/gallery/src/main/java/cc/winboll/studio/gallery/TrashDbHelper.java
new file mode 100644
index 0000000..6d5cd11
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/TrashDbHelper.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.gallery;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import android.os.Environment;
+import java.io.File;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class TrashDbHelper extends SQLiteOpenHelper {
+    public static final String TAG = "TrashDbHelper";
+    private static final String DB_NAME = "trash.db";
+    private static final int DB_VERSION = 1;
+    private static final String TABLE_NAME = "trash_items";
+    private static final String COL_ID = "_id";
+    private static final String COL_FILE_NAME = "file_name";
+    private static final String COL_ORIGINAL_PATH = "original_path";
+    private static final String COL_ORIGINAL_FOLDER = "original_folder";
+    private static final String COL_DELETE_TIME = "delete_time";
+    
+    public TrashDbHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+    
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        LogUtils.d(TAG, "onCreate");
+        db.execSQL("CREATE TABLE " + TABLE_NAME + " (" +
+            COL_ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +
+            COL_FILE_NAME + " TEXT, " +
+            COL_ORIGINAL_PATH + " TEXT, " +
+            COL_ORIGINAL_FOLDER + " TEXT, " +
+            COL_DELETE_TIME + " INTEGER)");
+    }
+    
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        LogUtils.i(TAG, "onUpgrade: " + oldVersion + " -> " + newVersion);
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME);
+        onCreate(db);
+    }
+    
+    public long insert(String fileName, String originalPath, String originalFolder) {
+        SQLiteDatabase db = getWritableDatabase();
+        ContentValues values = new ContentValues();
+        values.put(COL_FILE_NAME, fileName);
+        values.put(COL_ORIGINAL_PATH, originalPath);
+        values.put(COL_ORIGINAL_FOLDER, originalFolder);
+        values.put(COL_DELETE_TIME, System.currentTimeMillis());
+        return db.insert(TABLE_NAME, null, values);
+    }
+    
+    public Cursor getAll() {
+        SQLiteDatabase db = getReadableDatabase();
+        return db.query(TABLE_NAME, null, null, null, null, null, COL_DELETE_TIME + " DESC");
+    }
+    
+    public int delete(long id) {
+        SQLiteDatabase db = getWritableDatabase();
+        return db.delete(TABLE_NAME, COL_ID + "=?", new String[]{String.valueOf(id)});
+    }
+    
+    public void clear() {
+        SQLiteDatabase db = getWritableDatabase();
+        db.delete(TABLE_NAME, null, null);
+    }
+    
+    public static String getTrashPath() {
+        File trashDir = new File(Environment.getExternalStorageDirectory(), ".Trash");
+        if (!trashDir.exists()) {
+            trashDir.mkdirs();
+        }
+        return trashDir.getAbsolutePath();
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/TrashManager.java b/gallery/src/main/java/cc/winboll/studio/gallery/TrashManager.java
new file mode 100644
index 0000000..92a527b
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/TrashManager.java
@@ -0,0 +1,158 @@
+package cc.winboll.studio.gallery;
+
+import android.content.ContentResolver;
+import android.content.Context;
+import android.database.Cursor;
+import android.media.MediaScannerConnection;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.MediaStore;
+import java.io.File;
+import java.util.UUID;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class TrashManager {
+    public static final String TAG = "TrashManager";
+    private final Context context;
+    private final TrashDbHelper dbHelper;
+    
+    public TrashManager(Context context) {
+        LogUtils.d(TAG, "TrashManager created");
+        this.context = context;
+        this.dbHelper = new TrashDbHelper(context);
+    }
+    
+    public long addToTrash(String imagePath) {
+        LogUtils.d(TAG, "addToTrash: " + imagePath);
+        File sourceFile = new File(imagePath);
+        if (!sourceFile.exists()) {
+            return -1;
+        }
+        
+        String uniqueId = UUID.randomUUID().toString();
+        String extension = getExtension(imagePath);
+        String newFileName = uniqueId + extension;
+        String trashPath = TrashDbHelper.getTrashPath();
+        File destFile = new File(trashPath, newFileName);
+        
+        if (sourceFile.renameTo(destFile)) {
+            String originalFolder = sourceFile.getParent();
+            long result = dbHelper.insert(newFileName, imagePath, originalFolder);
+            LogUtils.i(TAG, "Added to trash: " + newFileName);
+            return result;
+        }
+        LogUtils.e(TAG, "Failed to move to trash");
+        return -1;
+    }
+    
+    public Cursor getTrashList() {
+        return dbHelper.getAll();
+    }
+    
+    public boolean restore(long id, String fileName, String originalPath) {
+        LogUtils.i(TAG, "restore: " + fileName + " -> " + originalPath);
+        File trashFile = new File(TrashDbHelper.getTrashPath(), fileName);
+        LogUtils.d(TAG, "trashFile exists: " + trashFile.exists() + ", path: " + trashFile.getAbsolutePath());
+        if (!trashFile.exists()) {
+            LogUtils.e(TAG, "trashFile not exists: " + trashFile.getAbsolutePath());
+            return false;
+        }
+        
+        File originalFolder = new File(originalPath).getParentFile();
+        LogUtils.d(TAG, "originalFolder: " + originalFolder + ", exists: " + (originalFolder != null && originalFolder.exists()));
+        if (originalFolder != null && !originalFolder.exists()) {
+            boolean created = originalFolder.mkdirs();
+            LogUtils.d(TAG, "mkdirs result: " + created + ", path: " + originalFolder.getAbsolutePath());
+        }
+        
+        File originalFile = new File(originalPath);
+        String restoreName = originalFile.getName();
+        File restoreFile = new File(originalFolder, restoreName);
+        LogUtils.d(TAG, "restoreFile: " + restoreFile.getAbsolutePath() + ", exists: " + restoreFile.exists());
+        
+        boolean renameResult = trashFile.renameTo(restoreFile);
+        LogUtils.d(TAG, "renameTo result: " + renameResult);
+        
+        if (renameResult) {
+            dbHelper.delete(id);
+            LogUtils.i(TAG, "Restored: " + fileName);
+            scanMedia(restoreFile.getAbsolutePath());
+            return true;
+        }
+        
+        // Try copy + delete if rename failed
+        LogUtils.i(TAG, "renameTo failed, trying copy + delete");
+        try {
+            java.io.InputStream in = new java.io.FileInputStream(trashFile);
+            java.io.OutputStream out = new java.io.FileOutputStream(restoreFile);
+            byte[] buffer = new byte[4096];
+            int len;
+            while ((len = in.read(buffer)) > 0) {
+                out.write(buffer, 0, len);
+            }
+            in.close();
+            out.close();
+            boolean deleted = trashFile.delete();
+            LogUtils.d(TAG, "copy+delete result: " + deleted);
+            if (deleted) {
+                dbHelper.delete(id);
+                LogUtils.i(TAG, "Restored (copy): " + fileName);
+                scanMedia(restoreFile.getAbsolutePath());
+                return true;
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "copy failed: " + e.getMessage());
+        }
+        
+        LogUtils.e(TAG, "Failed to restore: " + fileName);
+        return false;
+    }
+    
+    public boolean deletePermanently(long id, String fileName) {
+        File trashFile = new File(TrashDbHelper.getTrashPath(), fileName);
+        boolean deleted = trashFile.delete();
+        if (deleted) {
+            dbHelper.delete(id);
+        }
+        return deleted;
+    }
+    
+    public void clearTrash() {
+        Cursor cursor = getTrashList();
+        if (cursor != null) {
+            while (cursor.moveToNext()) {
+                try {
+                    int colIndex = cursor.getColumnIndexOrThrow("_id");
+                    if (!cursor.isNull(colIndex)) {
+                        String fileName = cursor.getString(cursor.getColumnIndexOrThrow("file_name"));
+                        File trashFile = new File(TrashDbHelper.getTrashPath(), fileName);
+                        trashFile.delete();
+                    }
+                } catch (Exception e) {
+                    e.printStackTrace();
+                }
+            }
+            cursor.close();
+        }
+        dbHelper.clear();
+    }
+    
+    private String getExtension(String path) {
+        int lastDot = path.lastIndexOf('.');
+        if (lastDot > 0) {
+            return path.substring(lastDot);
+        }
+        return ".jpg";
+    }
+    
+    private void scanMedia(String filePath) {
+        LogUtils.d(TAG, "scanMedia: " + filePath);
+        MediaScannerConnection.scanFile(context, new String[]{filePath}, null, new android.media.MediaScannerConnection.OnScanCompletedListener() {
+            @Override
+            public void onScanCompleted(String path, Uri uri) {
+                LogUtils.d(TAG, "scanCompleted: " + path + " -> " + uri);
+            }
+        });
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/ZoomContainerView.java b/gallery/src/main/java/cc/winboll/studio/gallery/ZoomContainerView.java
new file mode 100644
index 0000000..7fb4bdb
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/ZoomContainerView.java
@@ -0,0 +1,169 @@
+package cc.winboll.studio.gallery;
+
+import android.content.Context;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Paint;
+import android.util.AttributeSet;
+import android.view.GestureDetector;
+import android.view.MotionEvent;
+import android.view.ScaleGestureDetector;
+import android.view.View;
+import android.widget.FrameLayout;
+
+public class ZoomContainerView extends FrameLayout {
+    private float scaleFactor = 1.0f;
+    private float minScale = 0.1f;
+    private float maxScale = 5.0f;
+    private static final float ZOOM_STEP = 0.25f;
+    
+    private ScaleGestureDetector scaleGestureDetector;
+    private GestureDetector gestureDetector;
+    private Paint borderPaint;
+    
+    public ZoomContainerView(Context context) {
+        super(context);
+        init();
+    }
+    
+    public ZoomContainerView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+    
+    public ZoomContainerView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        init();
+    }
+    
+    private void init() {
+        setWillNotDraw(false);
+        setBackgroundColor(Color.YELLOW);
+        
+        borderPaint = new Paint();
+        borderPaint.setColor(Color.parseColor("#333333"));
+        borderPaint.setStyle(Paint.Style.STROKE);
+        borderPaint.setStrokeWidth(2);
+        
+        scaleGestureDetector = new ScaleGestureDetector(getContext(), new ScaleGestureDetector.SimpleOnScaleGestureListener() {
+            @Override
+            public boolean onScale(ScaleGestureDetector detector) {
+                scaleFactor *= detector.getScaleFactor();
+                scaleFactor = Math.max(minScale, Math.min(scaleFactor, maxScale));
+                invalidate();
+                requestLayout();
+                return true;
+            }
+        });
+        
+        gestureDetector = new GestureDetector(getContext(), new GestureDetector.SimpleOnGestureListener() {
+            @Override
+            public boolean onDoubleTap(MotionEvent e) {
+                if (scaleFactor > 1.5f) {
+                    scaleFactor = 1.0f;
+                } else {
+                    scaleFactor = 2.0f;
+                }
+                invalidate();
+                requestLayout();
+                return true;
+            }
+        });
+    }
+    
+    public void zoomIn() {
+        scaleFactor = Math.min(maxScale, scaleFactor + ZOOM_STEP);
+        requestMeasure();
+    }
+    
+    public void zoomOut() {
+        scaleFactor = Math.max(minScale, scaleFactor - ZOOM_STEP);
+        requestMeasure();
+    }
+    
+    private void requestMeasure() {
+        removeCallbacks(measureRunable);
+        post(measureRunable);
+    }
+    
+    private Runnable measureRunable = new Runnable() {
+        @Override
+        public void run() {
+            requestLayout();
+            invalidate();
+        }
+    };
+    
+    public float getScaleFactor() {
+        return scaleFactor;
+    }
+    
+    public void setScaleFactor(float scale) {
+        scaleFactor = Math.max(minScale, Math.min(scale, maxScale));
+        int childCount = getChildCount();
+        if (childCount > 0) {
+            View child = getChildAt(0);
+            if (child instanceof CropCanvasView) {
+                ((CropCanvasView) child).setContainerScale(scaleFactor);
+            }
+        }
+        requestLayout();
+        invalidate();
+    }
+    
+    public void resetZoom() {
+        scaleFactor = 1.0f;
+        invalidate();
+        requestLayout();
+    }
+    
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        int childCount = getChildCount();
+        if (childCount > 0) {
+            View child = getChildAt(0);
+            child.measure(widthMeasureSpec, heightMeasureSpec);
+            int childW = child.getMeasuredWidth();
+            int childH = child.getMeasuredHeight();
+            int scaledW = (int) (childW * scaleFactor);
+            int scaledH = (int) (childH * scaleFactor);
+            int widthSpec = MeasureSpec.makeMeasureSpec(scaledW, MeasureSpec.EXACTLY);
+            int heightSpec = MeasureSpec.makeMeasureSpec(scaledH, MeasureSpec.EXACTLY);
+            child.measure(widthSpec, heightSpec);
+            setMeasuredDimension(scaledW, scaledH);
+        } else {
+            super.onMeasure(widthMeasureSpec, heightMeasureSpec);
+        }
+    }
+    
+    @Override
+    protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
+        int childCount = getChildCount();
+        if (childCount > 0) {
+            View child = getChildAt(0);
+            int childW = child.getMeasuredWidth();
+            int childH = child.getMeasuredHeight();
+            int scaledW = (int) (childW * scaleFactor);
+            int scaledH = (int) (childH * scaleFactor);
+            int parentW = right - left;
+            int parentH = bottom - top;
+            int childLeft = (parentW - scaledW) / 2;
+            int childTop = (parentH - scaledH) / 2;
+            child.layout(childLeft, childTop, childLeft + scaledW, childTop + scaledH);
+        }
+    }
+    
+    @Override
+    protected void onDraw(Canvas canvas) {
+        super.onDraw(canvas);
+    }
+    
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {
+        boolean handled = scaleGestureDetector.onTouchEvent(event);
+        if (!scaleGestureDetector.isInProgress()) {
+            handled = gestureDetector.onTouchEvent(event) || handled;
+        }
+        return handled || super.onTouchEvent(event);
+    }
+}
\ No newline at end of file
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/dialog/ColorPaletteDialog.java b/gallery/src/main/java/cc/winboll/studio/gallery/dialog/ColorPaletteDialog.java
new file mode 100644
index 0000000..ce5e959
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/dialog/ColorPaletteDialog.java
@@ -0,0 +1,44 @@
+package cc.winboll.studio.gallery.dialog;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.os.Bundle;
+import android.view.WindowManager;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import cc.winboll.studio.gallery.R;
+
+/**
+ * 颜色表对话框
+ * 继承于普通对话框类，使用视图文件
+ */
+public class ColorPaletteDialog extends Dialog {
+
+    public ColorPaletteDialog(@NonNull Context context) {
+        super(context, R.style.ColorPaletteDialog);
+    }
+
+    public ColorPaletteDialog(@NonNull Context context, int themeResId) {
+        super(context, themeResId);
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        // super.onCreate(savedInstanceState);
+        setContentView(R.layout.dialog_color_palette);
+        
+        TextView titleText = findViewById(R.id.title_text);
+        
+        WindowManager.LayoutParams params = getWindow().getAttributes();
+        params.width = WindowManager.LayoutParams.MATCH_PARENT;
+        getWindow().setAttributes(params);
+    }
+
+    public void setTitle(String title) {
+        
+    }
+
+    public interface OnColorItemClick {
+        void onColorClick(int color);
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/utils/BackgroundUtils.java b/gallery/src/main/java/cc/winboll/studio/gallery/utils/BackgroundUtils.java
new file mode 100644
index 0000000..f55cef8
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/utils/BackgroundUtils.java
@@ -0,0 +1,129 @@
+package cc.winboll.studio.gallery.utils;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.graphics.Color;
+import android.graphics.drawable.ColorDrawable;
+import android.graphics.drawable.Drawable;
+import androidx.annotation.ColorInt;
+import androidx.annotation.DrawableRes;
+import androidx.core.content.ContextCompat;
+
+public class BackgroundUtils {
+
+    public enum DrawableType {
+        RESOURCE_ID,
+        COLOR
+    }
+
+    private static volatile BackgroundUtils instance;
+
+    private static final String PREF_NAME = "background_prefs";
+    private static final String KEY_TYPE = "bg_type";
+    private static final String KEY_RES_ID = "bg_res_id";
+    private static final String KEY_COLOR = "bg_color";
+
+    private Context context;
+    private Drawable drawable;
+    private DrawableType drawableType;
+    private int resId;
+    private int color;
+
+    private BackgroundUtils() {
+    }
+
+    public static BackgroundUtils getInstance() {
+        if (instance == null) {
+            synchronized (BackgroundUtils.class) {
+                if (instance == null) {
+                    instance = new BackgroundUtils();
+                }
+            }
+        }
+        return instance;
+    }
+
+    public static BackgroundUtils initFromResource(Context context, @DrawableRes int resId) {
+        synchronized (BackgroundUtils.class) {
+            BackgroundUtils utils = getInstance();
+            utils.context = context.getApplicationContext();
+            utils.drawableType = DrawableType.RESOURCE_ID;
+            utils.resId = resId;
+            utils.drawable = ContextCompat.getDrawable(utils.context, resId);
+            utils.saveToPreferences();
+            return utils;
+        }
+    }
+
+    public static BackgroundUtils initFromColor(Context context, @ColorInt int color) {
+        synchronized (BackgroundUtils.class) {
+            BackgroundUtils utils = getInstance();
+            utils.context = context.getApplicationContext();
+            utils.drawableType = DrawableType.COLOR;
+            utils.color = color;
+            utils.drawable = new ColorDrawable(color);
+            utils.saveToPreferences();
+            return utils;
+        }
+    }
+
+    public static BackgroundUtils initFromPreferences(Context context) {
+        synchronized (BackgroundUtils.class) {
+            Context appContext = context.getApplicationContext();
+            SharedPreferences prefs = appContext.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
+            int type = prefs.getInt(KEY_TYPE, -1);
+            if (type == 0) {
+                int resId = prefs.getInt(KEY_RES_ID, 0);
+                if (resId != 0) {
+                    return initFromResource(appContext, resId);
+                }
+            } else if (type == 1) {
+                int color = prefs.getInt(KEY_COLOR, Color.BLACK);
+                return initFromColor(appContext, color);
+            }
+            // 默认情况，initFromColor 内部已经调用了 saveToPreferences()
+            return initFromColor(appContext, 0xFF00FF00);
+        }
+    }
+
+    public Drawable getDrawable() {
+        return drawable;
+    }
+
+    public DrawableType getDrawableType() {
+        return drawableType;
+    }
+
+    public DrawableType getAttributeValueType() {
+        return drawableType;
+    }
+
+    public int getResId() {
+        return resId;
+    }
+
+    public int getColor() {
+        return color;
+    }
+
+    public void saveToPreferences() {
+        if (context == null) return;
+        SharedPreferences prefs = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = prefs.edit();
+        if (drawableType == DrawableType.RESOURCE_ID) {
+            editor.putInt(KEY_TYPE, 0);
+            editor.putInt(KEY_RES_ID, resId);
+            editor.remove(KEY_COLOR);
+        } else {
+            editor.putInt(KEY_TYPE, 1);
+            editor.putInt(KEY_COLOR, color);
+            editor.remove(KEY_RES_ID);
+        }
+        editor.apply();
+    }
+
+    public static void clearPreferences(Context context) {
+        SharedPreferences prefs = context.getApplicationContext().getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
+        prefs.edit().clear().apply();
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/utils/CropBackgroundUtils.java b/gallery/src/main/java/cc/winboll/studio/gallery/utils/CropBackgroundUtils.java
new file mode 100644
index 0000000..fb399f9
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/utils/CropBackgroundUtils.java
@@ -0,0 +1,124 @@
+package cc.winboll.studio.gallery.utils;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.graphics.Color;
+import android.graphics.drawable.ColorDrawable;
+import android.graphics.drawable.Drawable;
+import androidx.annotation.ColorInt;
+import androidx.annotation.DrawableRes;
+import androidx.core.content.ContextCompat;
+
+public class CropBackgroundUtils {
+
+    public enum DrawableType {
+        RESOURCE_ID,
+        COLOR
+    }
+
+    private static volatile CropBackgroundUtils instance;
+
+    private static final String PREF_NAME = "crop_background_prefs";
+    private static final String KEY_TYPE = "crop_bg_type";
+    private static final String KEY_RES_ID = "crop_bg_res_id";
+    private static final String KEY_COLOR = "crop_bg_color";
+
+    private Context context;
+    private Drawable drawable;
+    private DrawableType drawableType;
+    private int resId;
+    private int color;
+
+    private CropBackgroundUtils() {
+    }
+
+    public static CropBackgroundUtils getInstance() {
+        if (instance == null) {
+            synchronized (CropBackgroundUtils.class) {
+                if (instance == null) {
+                    instance = new CropBackgroundUtils();
+                }
+            }
+        }
+        return instance;
+    }
+
+    public static CropBackgroundUtils initFromResource(Context context, @DrawableRes int resId) {
+        synchronized (CropBackgroundUtils.class) {
+            CropBackgroundUtils utils = getInstance();
+            utils.context = context.getApplicationContext();
+            utils.drawableType = DrawableType.RESOURCE_ID;
+            utils.resId = resId;
+            utils.drawable = ContextCompat.getDrawable(utils.context, resId);
+            utils.saveToPreferences();
+            return utils;
+        }
+    }
+
+    public static CropBackgroundUtils initFromColor(Context context, @ColorInt int color) {
+        synchronized (CropBackgroundUtils.class) {
+            CropBackgroundUtils utils = getInstance();
+            utils.context = context.getApplicationContext();
+            utils.drawableType = DrawableType.COLOR;
+            utils.color = color;
+            utils.drawable = new ColorDrawable(color);
+            utils.saveToPreferences();
+            return utils;
+        }
+    }
+
+    public static CropBackgroundUtils initFromPreferences(Context context) {
+        synchronized (CropBackgroundUtils.class) {
+            Context appContext = context.getApplicationContext();
+            SharedPreferences prefs = appContext.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
+            int type = prefs.getInt(KEY_TYPE, -1);
+            if (type == 0) {
+                int resId = prefs.getInt(KEY_RES_ID, 0);
+                if (resId != 0) {
+                    return initFromResource(appContext, resId);
+                }
+            } else if (type == 1) {
+                int color = prefs.getInt(KEY_COLOR, Color.BLACK);
+                return initFromColor(appContext, color);
+            }
+            return initFromColor(appContext, 0xFF00FF00);
+        }
+    }
+
+    public Drawable getDrawable() {
+        return drawable;
+    }
+
+    public DrawableType getDrawableType() {
+        return drawableType;
+    }
+
+    public int getResId() {
+        return resId;
+    }
+
+    public int getColor() {
+        return color;
+    }
+
+    public void saveToPreferences() {
+        if (context == null) return;
+        SharedPreferences prefs = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = prefs.edit();
+        if (drawableType == DrawableType.RESOURCE_ID) {
+            editor.putInt(KEY_TYPE, 0);
+            editor.putInt(KEY_RES_ID, resId);
+            editor.remove(KEY_COLOR);
+        } else {
+            editor.putInt(KEY_TYPE, 1);
+            editor.putInt(KEY_COLOR, color);
+            editor.remove(KEY_RES_ID);
+        }
+        editor.apply();
+    }
+
+    public static void clearPreferences(Context context) {
+        SharedPreferences prefs = context.getApplicationContext().getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
+        prefs.edit().clear().apply();
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/views/BackgroundRadioButton.java b/gallery/src/main/java/cc/winboll/studio/gallery/views/BackgroundRadioButton.java
new file mode 100644
index 0000000..8809e00
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/views/BackgroundRadioButton.java
@@ -0,0 +1,34 @@
+package cc.winboll.studio.gallery.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.RadioButton;
+
+public class BackgroundRadioButton extends RadioButton {
+
+    CustomApplicationBackground mCustomApplicationBackground;
+
+    public BackgroundRadioButton(Context context) {
+        super(context);
+    }
+
+    public BackgroundRadioButton(Context context, AttributeSet attrs) {
+        super(context, attrs);
+    }
+
+    public BackgroundRadioButton(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    public void setupCustomApplicationBackground(Context context, int resId) {
+        mCustomApplicationBackground = new CustomApplicationBackground(context, resId);
+    }
+
+    public void setCustomApplicationBackground(CustomApplicationBackground customApplicationBackground) {
+        mCustomApplicationBackground = customApplicationBackground;
+    }
+
+    public CustomApplicationBackground getCustomApplicationBackground() {
+        return mCustomApplicationBackground;
+    }
+}
diff --git a/gallery/src/main/java/cc/winboll/studio/gallery/views/CustomApplicationBackground.java b/gallery/src/main/java/cc/winboll/studio/gallery/views/CustomApplicationBackground.java
new file mode 100644
index 0000000..729521f
--- /dev/null
+++ b/gallery/src/main/java/cc/winboll/studio/gallery/views/CustomApplicationBackground.java
@@ -0,0 +1,29 @@
+package cc.winboll.studio.gallery.views;
+
+import android.content.Context;
+import android.graphics.drawable.ColorDrawable;
+import android.graphics.drawable.Drawable;
+
+public class CustomApplicationBackground {
+    Drawable mDrawable;
+
+    public CustomApplicationBackground(Drawable drawable) {
+        mDrawable = drawable;
+    }
+
+    public CustomApplicationBackground(int color) {
+        mDrawable = new ColorDrawable(color);
+    }
+
+    public CustomApplicationBackground(Context context, int resId) {
+        mDrawable = context.getDrawable(resId);
+    }
+
+    public Drawable getDrawable() {
+        return mDrawable;
+    }
+
+    public void setDrawable(Drawable drawable) {
+        mDrawable = drawable;
+    }
+}
diff --git a/gallery/src/main/res/drawable-v24/ic_launcher_foreground.xml b/gallery/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 0000000..c7bd21d
--- /dev/null
+++ b/gallery/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1" />
+</vector>
diff --git a/gallery/src/main/res/drawable/bg_black.xml b/gallery/src/main/res/drawable/bg_black.xml
new file mode 100644
index 0000000..e0fb6f9
--- /dev/null
+++ b/gallery/src/main/res/drawable/bg_black.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="#000000"/>
+</shape>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/bg_checkerboard.xml b/gallery/src/main/res/drawable/bg_checkerboard.xml
new file mode 100644
index 0000000..f89e1af
--- /dev/null
+++ b/gallery/src/main/res/drawable/bg_checkerboard.xml
@@ -0,0 +1,30 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="10dp"
+    android:height="10dp"
+    android:viewportWidth="10"
+    android:viewportHeight="10">
+    <path
+        android:fillColor="#808080"
+        android:pathData="M0,0h1v1h-1z M2,0h1v1h-1z M4,0h1v1h-1z M6,0h1v1h-1z M8,0h1v1h-1z
+                             M1,1h1v1h-1z M3,1h1v1h-1z M5,1h1v1h-1z M7,1h1v1h-1z M9,1h1v1h-1z
+                             M0,2h1v1h-1z M2,2h1v1h-1z M4,2h1v1h-1z M6,2h1v1h-1z M8,2h1v1h-1z
+                             M1,3h1v1h-1z M3,3h1v1h-1z M5,3h1v1h-1z M7,3h1v1h-1z M9,3h1v1h-1z
+                             M0,4h1v1h-1z M2,4h1v1h-1z M4,4h1v1h-1z M6,4h1v1h-1z M8,4h1v1h-1z
+                             M1,5h1v1h-1z M3,5h1v1h-1z M5,5h1v1h-1z M7,5h1v1h-1z M9,5h1v1h-1z
+                             M0,6h1v1h-1z M2,6h1v1h-1z M4,6h1v1h-1z M6,6h1v1h-1z M8,6h1v1h-1z
+                             M1,7h1v1h-1z M3,7h1v1h-1z M5,7h1v1h-1z M7,7h1v1h-1z M9,7h1v1h-1z
+                             M0,8h1v1h-1z M2,8h1v1h-1z M4,8h1v1h-1z M6,8h1v1h-1z M8,8h1v1h-1z
+                             M1,9h1v1h-1z M3,9h1v1h-1z M5,9h1v1h-1z M7,9h1v1h-1z M9,9h1v1h-1z"/>
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M1,0h1v1h-1z M3,0h1v1h-1z M5,0h1v1h-1z M7,0h1v1h-1z M9,0h1v1h-1z
+                             M0,1h1v1h-1z M2,1h1v1h-1z M4,1h1v1h-1z M6,1h1v1h-1z M8,1h1v1h-1z
+                             M1,2h1v1h-1z M3,2h1v1h-1z M5,2h1v1h-1z M7,2h1v1h-1z M9,2h1v1h-1z
+                             M0,3h1v1h-1z M2,3h1v1h-1z M4,3h1v1h-1z M6,3h1v1h-1z M8,3h1v1h-1z
+                             M1,4h1v1h-1z M3,4h1v1h-1z M5,4h1v1h-1z M7,4h1v1h-1z M9,4h1v1h-1z
+                             M0,5h1v1h-1z M2,5h1v1h-1z M4,5h1v1h-1z M6,5h1v1h-1z M8,5h1v1h-1z
+                             M1,6h1v1h-1z M3,6h1v1h-1z M5,6h1v1h-1z M7,6h1v1h-1z M9,6h1v1h-1z
+                             M0,7h1v1h-1z M2,7h1v1h-1z M4,7h1v1h-1z M6,7h1v1h-1z M8,7h1v1h-1z
+                             M1,8h1v1h-1z M3,8h1v1h-1z M5,8h1v1h-1z M7,8h1v1h-1z M9,8h1v1h-1z
+                             M0,9h1v1h-1z M2,9h1v1h-1z M4,9h1v1h-1z M6,9h1v1h-1z M8,9h1v1h-1z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/bg_circle_white.xml b/gallery/src/main/res/drawable/bg_circle_white.xml
new file mode 100644
index 0000000..fb0d808
--- /dev/null
+++ b/gallery/src/main/res/drawable/bg_circle_white.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="oval">
+    <solid android:color="#CCFFFFFF"/>
+    <stroke
+        android:width="1dp"
+        android:color="#000000"/>
+</shape>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/bg_color_circle.xml b/gallery/src/main/res/drawable/bg_color_circle.xml
new file mode 100644
index 0000000..847f7a9
--- /dev/null
+++ b/gallery/src/main/res/drawable/bg_color_circle.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="oval">
+    <solid android:color="@android:color/transparent"/>
+    <stroke android:width="2dp" android:color="@android:color/white"/>
+    <size android:width="32dp" android:height="32dp"/>
+</shape>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/bg_color_circle_border.xml b/gallery/src/main/res/drawable/bg_color_circle_border.xml
new file mode 100644
index 0000000..cc52daa
--- /dev/null
+++ b/gallery/src/main/res/drawable/bg_color_circle_border.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="oval">
+    <stroke android:width="2dp" android:color="@android:color/white"/>
+    <size android:width="36dp" android:height="36dp"/>
+</shape>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/bg_dialog.xml b/gallery/src/main/res/drawable/bg_dialog.xml
new file mode 100644
index 0000000..5477c09
--- /dev/null
+++ b/gallery/src/main/res/drawable/bg_dialog.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="@android:color/black"/>
+    <stroke android:width="2dp" android:color="@android:color/white"/>
+</shape>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/bg_white.xml b/gallery/src/main/res/drawable/bg_white.xml
new file mode 100644
index 0000000..0c561be
--- /dev/null
+++ b/gallery/src/main/res/drawable/bg_white.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="#FFFFFF"/>
+</shape>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_arrow_up.xml b/gallery/src/main/res/drawable/ic_arrow_up.xml
new file mode 100644
index 0000000..aa5b4d5
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_arrow_up.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M7.41,15.41L12,10.83l4.59,4.58L18,14l-6,-6 -6,6z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_back.xml b/gallery/src/main/res/drawable/ic_back.xml
new file mode 100644
index 0000000..0cdf891
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_back.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M20,11H7.83l5.59,-5.59L12,4l-8,8 8,8 1.41,-1.41L7.83,13H20v-2z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_bg.xml b/gallery/src/main/res/drawable/ic_bg.xml
new file mode 100644
index 0000000..0580837
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_bg.xml
@@ -0,0 +1,12 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M4,4h7v7h-7z M13,4h7v7h-7z M4,13h7v7h-7z M13,13h7v7h-7z"/>
+    <path
+        android:fillColor="#808080"
+        android:pathData="M11,4h2v7h-2z M4,11h7v2h-7z M13,11h7v2h-7z M11,13h2v7h-2z M13,4h2v7h-2z M4,13h7v2h-7z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_close.xml b/gallery/src/main/res/drawable/ic_close.xml
new file mode 100644
index 0000000..2789d9c
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_close.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M19,6.41L17.59,5 12,10.59 6.41,5 5,6.41 10.59,12 5,17.59 6.41,19 12,13.41 17.59,19 19,17.59 13.41,12z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_color_pick.xml b/gallery/src/main/res/drawable/ic_color_pick.xml
new file mode 100644
index 0000000..538fb37
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_color_pick.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M20.71,5.63l-2.34,-2.34c-0.39,-0.39 -1.02,-0.39 -1.41,0l-3.12,3.12 -1.93,-1.91 -1.41,1.41 1.42,1.42L3,16.25V21h4.75l8.92,-8.92 1.42,1.42 1.41,-1.41 -1.92,-1.92 3.12,-3.12c0.4,-0.4 0.4,-1.03 0.01,-1.42zM6.92,19H5v-1.92l8.06,-8.06 1.92,1.92L6.92,19z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_cover.xml b/gallery/src/main/res/drawable/ic_cover.xml
new file mode 100644
index 0000000..05f5d75
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_cover.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M21,3H3C1.9,3 1,3.9 1,5v14c0,1.1 0.9,2 2,2h18c1.1,0 2,-0.9 2,-2V5C23,3.9 22.1,3 21,3zM21,19H3V5h18V19z"/>
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M9,12l2,2l4,-4l1.5,1.5L11,17l-3,-3z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_delete.xml b/gallery/src/main/res/drawable/ic_delete.xml
new file mode 100644
index 0000000..aa0f7a0
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_delete.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M6,19c0,1.1 0.9,2 2,2h8c1.1,0 2,-0.9 2,-2V7H6v12zM19,4h-3.5l-1,-1h-5l-1,-1H5v2h14V4z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_done.xml b/gallery/src/main/res/drawable/ic_done.xml
new file mode 100644
index 0000000..a7672f7
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_done.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M9,16.17L4.83,12l-1.42,1.41L9,19 21,7l-1.41,-1.41z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_info.xml b/gallery/src/main/res/drawable/ic_info.xml
new file mode 100644
index 0000000..b49a72b
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_info.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M12,2C6.48,2 2,6.48 2,12s4.48,10 10,10 10,-4.48 10,-10S17.52,2 12,2zM13,17h-2v-6h2v6zM13,9h-2L11,7h2v2z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_launcher_background.xml b/gallery/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..d5fccc5
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>
diff --git a/gallery/src/main/res/drawable/ic_mi_gallery.xml b/gallery/src/main/res/drawable/ic_mi_gallery.xml
new file mode 100644
index 0000000..17bc4bd
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_mi_gallery.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#000000"
+        android:pathData="M12,2C6.48,2 2,6.48 2,12s4.48,10 10,10s10,-4.48 10,-10S17.52,2 12,2zM12,20c-4.41,0 -8,-3.59 -8,-8s3.59,-8 8,-8s8,3.59 8,8s-3.59,8 -8,8z"/>
+    <path
+        android:fillColor="#000000"
+        android:pathData="M12,7c-2.76,0 -5,2.24 -5,5s2.24,5 5,5s5,-2.24 5,-5s-2.24,-5 -5,-5zM12,15c-1.66,0 -3,-1.34 -3,-3s1.34,-3 3,-3s3,1.34 3,3s-1.34,3 -3,3z"/>
+    <path
+        android:fillColor="#000000"
+        android:pathData="M8,12l1.5,-2l2,2.5l2.5,-3l2,2.5"/>
+</vector>
diff --git a/gallery/src/main/res/drawable/ic_pin.xml b/gallery/src/main/res/drawable/ic_pin.xml
new file mode 100644
index 0000000..9963da0
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_pin.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M16,12V4H17V2H7V4H8V12L6,14V16H11.5V22H12.5V16H18V14L16,12Z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_restore.xml b/gallery/src/main/res/drawable/ic_restore.xml
new file mode 100644
index 0000000..f607ca2
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_restore.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M13,3c-4.97,0 -9,4.03 -9,9H1l3.89,3.89 0.07,0.14L9,12H6c0,-3.87 3.13,-7 7,-7s7,3.13 7,7 -3.13,7 -7,7c-1.93,0 -3.68,-0.79 -4.94,-2.06l-1.42,1.42C8.27,17.9 10.51,19 13,19c4.97,0 9,-4.03 9,-9s-4.03,-9 -9,-9zM12,8v5l4.28,2.54 0.72,-1.21 -3.5,-2.08V8H12z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_share.xml b/gallery/src/main/res/drawable/ic_share.xml
new file mode 100644
index 0000000..ff756ae
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_share.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M18,16.08c-0.76,0 -1.44,0.3 -1.96,0.77L8.91,12.7c0.05,-0.23 0.09,-0.46 0.09,-0.7s-0.04,-0.47 -0.09,-0.7l7.05,-4.11c0.54,0.5 1.25,0.81 2.04,0.81 1.66,0 3,-1.34 3,-3s-1.34,-3 -3,-3 -3,1.34 -3,3c0,0.24 0.04,0.47 0.09,0.7L8.04,9.81C7.5,9.31 6.79,9 6,9c-1.66,0 -3,1.34 -3,3s1.34,3 3,3c0.79,0 1.5,-0.31 2.04,-0.81l7.12,4.16c-0.05,0.21 -0.08,0.43 -0.08,0.65 0,1.61 1.31,2.92 2.92,2.92s2.92,-1.31 2.92,-2.92 -1.31,-2.92 -2.92,-2.92z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_sort.xml b/gallery/src/main/res/drawable/ic_sort.xml
new file mode 100644
index 0000000..7d37ecc
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_sort.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M3,18h6v-2H3v2zM3,6v2h18V6H3zM3,13h12v-2H3v2z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_view_gallery_outline.xml b/gallery/src/main/res/drawable/ic_view_gallery_outline.xml
new file mode 100644
index 0000000..c4861fb
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_view_gallery_outline.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M1,3V21H23V3H1M21,5V14H3V5H21M11,16V19H8V16H11M3,16H6V19H3V16M13,19V16H16V19H13M18,19V16H21V19H18Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_zoom_in.xml b/gallery/src/main/res/drawable/ic_zoom_in.xml
new file mode 100644
index 0000000..45a16f6
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_zoom_in.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M19,13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/drawable/ic_zoom_out.xml b/gallery/src/main/res/drawable/ic_zoom_out.xml
new file mode 100644
index 0000000..6fdbb4a
--- /dev/null
+++ b/gallery/src/main/res/drawable/ic_zoom_out.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M19,13H5v-2h14v2z"/>
+</vector>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/activity_about.xml b/gallery/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..790b67d
--- /dev/null
+++ b/gallery/src/main/res/layout/activity_about.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:orientation="vertical">
+
+        <com.google.android.material.appbar.AppBarLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+        
+            <androidx.appcompat.widget.Toolbar
+                android:id="@+id/toolbar"
+                android:layout_width="match_parent"
+                android:layout_height="?attr/actionBarSize"
+                app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+        </com.google.android.material.appbar.AppBarLayout>
+
+        <cc.winboll.studio.libappbase.views.AboutView
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:id="@+id/aboutview"/>
+
+    </LinearLayout>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/activity_crop.xml b/gallery/src/main/res/layout/activity_crop.xml
new file mode 100644
index 0000000..39e528e
--- /dev/null
+++ b/gallery/src/main/res/layout/activity_crop.xml
@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="@color/black">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="56dp"
+        android:orientation="horizontal"
+        android:gravity="center_vertical"
+        android:background="@color/colorPrimary"
+        android:paddingHorizontal="16dp">
+
+        <ImageView
+            android:id="@+id/btn_close"
+            android:layout_width="40dp"
+            android:layout_height="40dp"
+            android:padding="5dp"
+            android:src="@drawable/ic_close"
+            android:background="?attr/selectableItemBackgroundBorderless"/>
+
+        <TextView
+            android:id="@+id/textview_window_name"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="封面剪裁"
+            android:textColor="@android:color/white"
+            android:textSize="18sp"
+            android:layout_gravity="center_vertical"
+            android:layout_weight="1"
+            android:gravity="center"
+            android:layout_marginEnd="8dp"/>
+
+        <View
+            android:layout_width="0dp"
+            android:layout_height="0dp"
+            android:layout_weight="1"/>
+
+        <ImageView
+            android:id="@+id/btn_info"
+            android:layout_width="40dp"
+            android:layout_height="40dp"
+            android:padding="5dp"
+            android:src="@drawable/ic_info"
+            android:background="?attr/selectableItemBackgroundBorderless"/>
+
+        <ImageView
+            android:id="@+id/btn_change_bg"
+            android:layout_width="40dp"
+            android:layout_height="40dp"
+            android:padding="5dp"
+            android:src="@drawable/ic_color_pick"
+            android:background="?attr/selectableItemBackgroundBorderless"
+            android:contentDescription="修改剪裁背景颜色"/>
+
+        <ImageView
+            android:id="@+id/btn_done"
+            android:layout_width="40dp"
+            android:layout_height="40dp"
+            android:padding="5dp"
+            android:src="@drawable/ic_done"
+            android:background="?attr/selectableItemBackgroundBorderless"/>
+
+    </LinearLayout>
+
+    <ScrollView
+        android:id="@+id/scroll_view"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:layout_marginTop="56dp"
+        android:layout_marginBottom="56dp"
+        android:fillViewport="true">
+
+        <cc.winboll.studio.gallery.ZoomContainerView
+            android:id="@+id/zoom_container"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:layout_gravity="center">
+
+            <cc.winboll.studio.gallery.CropCanvasView
+                android:id="@+id/crop_canvas_view"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:layout_gravity="center"/>
+
+        </cc.winboll.studio.gallery.ZoomContainerView>
+
+    </ScrollView>
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="56dp"
+        android:layout_gravity="bottom"
+        android:orientation="horizontal"
+        android:gravity="center_vertical"
+        android:background="@color/colorPrimary"
+        android:paddingHorizontal="16dp"
+        android:layout_marginBottom="0dp">
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="缩小"
+            android:textColor="@android:color/white"
+            android:textSize="12sp"/>
+
+        <SeekBar
+            android:id="@+id/seekbar_zoom"
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:layout_weight="1"
+            android:min="0"
+            android:max="100"
+            android:progress="50"
+            android:layout_marginHorizontal="8dp"/>
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="放大"
+            android:textColor="@android:color/white"
+            android:textSize="12sp"/>
+
+    </LinearLayout>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/activity_image_viewer.xml b/gallery/src/main/res/layout/activity_image_viewer.xml
new file mode 100644
index 0000000..daaf21e
--- /dev/null
+++ b/gallery/src/main/res/layout/activity_image_viewer.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:id="@+id/container"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="@color/black"
+    android:clickable="true"
+    android:focusable="true">
+
+    <androidx.viewpager.widget.ViewPager
+        android:id="@+id/view_pager"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:clickable="false"/>
+
+    <LinearLayout
+        android:id="@+id/toolbar"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_gravity="top"
+        android:background="#CC000000"
+        android:orientation="horizontal"
+        android:padding="4dp">
+
+        <ImageButton
+            android:id="@+id/btn_back"
+            android:layout_width="48dp"
+            android:layout_height="48dp"
+            android:background="?attr/selectableItemBackgroundBorderless"
+            android:src="@drawable/ic_back"
+            android:contentDescription="Back"/>
+
+        <View
+            android:layout_width="0dp"
+            android:layout_height="0dp"
+            android:layout_weight="1"/>
+
+        <ImageButton
+            android:id="@+id/btn_gallery"
+            android:layout_width="48dp"
+            android:layout_height="48dp"
+            android:background="?attr/selectableItemBackgroundBorderless"
+            android:src="@drawable/ic_view_gallery_outline"
+            android:contentDescription="Gallery"/>
+
+        <ImageButton
+            android:id="@+id/btn_share"
+            android:layout_width="48dp"
+            android:layout_height="48dp"
+            android:background="?attr/selectableItemBackgroundBorderless"
+            android:src="@drawable/ic_share"
+            android:contentDescription="Share"/>
+
+        <ImageButton
+            android:id="@+id/btn_info"
+            android:layout_width="48dp"
+            android:layout_height="48dp"
+            android:background="?attr/selectableItemBackgroundBorderless"
+            android:src="@drawable/ic_info"
+            android:contentDescription="Info"/>
+
+        <ImageButton
+            android:id="@+id/btn_delete"
+            android:layout_width="48dp"
+            android:layout_height="48dp"
+            android:background="?attr/selectableItemBackgroundBorderless"
+            android:src="@drawable/ic_delete"
+            android:contentDescription="Delete"/>
+
+    </LinearLayout>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/activity_main.xml b/gallery/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..3a1bd64
--- /dev/null
+++ b/gallery/src/main/res/layout/activity_main.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:orientation="vertical">
+
+        <com.google.android.material.appbar.AppBarLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+        
+            <androidx.appcompat.widget.Toolbar
+                android:id="@+id/toolbar"
+                android:layout_width="match_parent"
+                android:layout_height="?attr/actionBarSize"
+                app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+        </com.google.android.material.appbar.AppBarLayout>
+
+        <androidx.recyclerview.widget.RecyclerView
+            android:id="@+id/recycler_view"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:background="@android:color/transparent"/>
+
+    </LinearLayout>
+
+    <com.google.android.material.floatingactionbutton.FloatingActionButton
+        android:id="@+id/fab_scroll_top"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_gravity="bottom|end"
+        android:layout_margin="16dp"
+        android:src="@drawable/ic_arrow_up"
+        android:visibility="gone"
+        app:backgroundTint="@color/colorAccent"
+        app:tint="@color/white"/>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/activity_settings.xml b/gallery/src/main/res/layout/activity_settings.xml
new file mode 100644
index 0000000..24d2676
--- /dev/null
+++ b/gallery/src/main/res/layout/activity_settings.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:padding="16dp">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="@string/folder_path"
+        android:textSize="16sp"
+        android:textStyle="bold"/>
+
+    <EditText
+        android:id="@+id/edit_folder_path"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="8dp"
+        android:hint="@string/enter_folder_path"
+        android:inputType="text"/>
+
+    <TextView
+        android:id="@+id/text_current_path"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="8dp"
+        android:textSize="12sp"
+        android:textColor="#888888"/>
+
+    <Button
+        android:id="@+id/btn_save"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="16dp"
+        android:text="@string/save"/>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/dialog_color_palette.xml b/gallery/src/main/res/layout/dialog_color_palette.xml
new file mode 100644
index 0000000..14ec990
--- /dev/null
+++ b/gallery/src/main/res/layout/dialog_color_palette.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:background="@drawable/bg_dialog"
+    android:padding="16dp">
+
+    <TextView
+        android:id="@+id/title_text"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textSize="16sp"
+        android:textColor="@android:color/white"
+        android:textStyle="bold"/>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/dialog_crop_info.xml b/gallery/src/main/res/layout/dialog_crop_info.xml
new file mode 100644
index 0000000..16b547d
--- /dev/null
+++ b/gallery/src/main/res/layout/dialog_crop_info.xml
@@ -0,0 +1,36 @@
+<?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"
+	android:gravity="center_horizontal">
+
+	<TextView
+		android:id="@+id/info_text"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:textSize="14sp"
+		android:fontFamily="monospace"
+		android:textColor="@android:color/white"/>
+
+	<LinearLayout
+		android:id="@+id/preview_image_container"
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:padding="2dp"
+		android:background="#FFBBD505">
+
+		<ImageView
+			android:id="@+id/preview_image"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:scaleType="fitCenter"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/gallery/src/main/res/layout/item_album.xml b/gallery/src/main/res/layout/item_album.xml
new file mode 100644
index 0000000..4947a7e
--- /dev/null
+++ b/gallery/src/main/res/layout/item_album.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:padding="2dp">
+
+    <ImageView
+        android:id="@+id/album_cover"
+        android:layout_width="match_parent"
+        android:layout_height="120dp"
+        android:layout_margin="2dp"
+        android:scaleType="centerCrop"/>
+
+    <TextView
+        android:id="@+id/album_name"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_gravity="bottom"
+        android:background="#80000000"
+        android:padding="4dp"
+        android:textColor="@color/white"
+        android:textSize="12sp"
+        android:maxLines="1"
+        android:ellipsize="end"/>
+
+    <ImageView
+        android:id="@+id/pin_icon"
+        android:layout_width="24dp"
+        android:layout_height="24dp"
+        android:layout_gravity="bottom|end"
+        android:layout_margin="6dp"
+        android:background="@android:color/transparent"
+        android:padding="3dp"
+        android:src="@drawable/ic_pin"
+        android:visibility="gone"/>
+
+    <TextView
+        android:id="@+id/image_count"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_gravity="top|end"
+        android:background="#80000000"
+        android:padding="4dp"
+        android:textColor="@color/white"
+        android:textSize="10sp"/>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/item_color_icon.xml b/gallery/src/main/res/layout/item_color_icon.xml
new file mode 100644
index 0000000..1595181
--- /dev/null
+++ b/gallery/src/main/res/layout/item_color_icon.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="40dp"
+    android:layout_height="40dp">
+
+    <View
+        android:id="@+id/color_view"
+        android:layout_width="32dp"
+        android:layout_height="32dp"
+        android:layout_gravity="center"
+        android:background="@drawable/bg_color_circle"/>
+
+    <View
+        android:layout_width="36dp"
+        android:layout_height="36dp"
+        android:layout_gravity="center"
+        android:background="@drawable/bg_color_circle_border"/>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/item_gallery.xml b/gallery/src/main/res/layout/item_gallery.xml
new file mode 100644
index 0000000..2449ff1
--- /dev/null
+++ b/gallery/src/main/res/layout/item_gallery.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:padding="2dp">
+
+    <ImageView
+        android:id="@+id/image"
+        android:layout_width="match_parent"
+        android:layout_height="120dp"
+        android:scaleType="centerCrop"
+        android:background="@color/black"/>
+
+<ImageView
+        android:id="@+id/pin_icon"
+        android:layout_width="24dp"
+        android:layout_height="24dp"
+        android:layout_gravity="top|end"
+        android:layout_margin="4dp"
+        android:background="@drawable/bg_circle_white"
+        android:padding="4dp"
+        android:src="@drawable/ic_pin"
+        android:visibility="gone"
+        app:tint="@color/black"
+        xmlns:app="http://schemas.android.com/apk/res-auto"/>
+
+    <ImageView
+        android:id="@+id/cover_icon"
+        android:layout_width="24dp"
+        android:layout_height="24dp"
+        android:layout_gravity="bottom|end"
+        android:layout_margin="4dp"
+        android:background="@drawable/bg_circle_white"
+        android:padding="4dp"
+        android:src="@drawable/ic_cover"
+        android:visibility="gone"
+        app:tint="@color/black"
+        xmlns:app="http://schemas.android.com/apk/res-auto"/>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/item_image_pager.xml b/gallery/src/main/res/layout/item_image_pager.xml
new file mode 100644
index 0000000..6ca5615
--- /dev/null
+++ b/gallery/src/main/res/layout/item_image_pager.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <ImageView
+        android:id="@+id/image"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:scaleType="fitCenter"/>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/layout/item_trash.xml b/gallery/src/main/res/layout/item_trash.xml
new file mode 100644
index 0000000..1a5a89a
--- /dev/null
+++ b/gallery/src/main/res/layout/item_trash.xml
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:padding="2dp">
+
+    <ImageView
+        android:id="@+id/image"
+        android:layout_width="match_parent"
+        android:layout_height="120dp"
+        android:scaleType="centerCrop"
+        android:background="@color/black"/>
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_gravity="bottom"
+        android:background="#80000000"
+        android:orientation="horizontal">
+
+        <ImageView
+            android:id="@+id/btn_restore"
+            android:layout_width="0dp"
+            android:layout_height="36dp"
+            android:layout_weight="1"
+            android:padding="8dp"
+            android:src="@drawable/ic_restore"
+            android:contentDescription="Restore"/>
+
+        <ImageView
+            android:id="@+id/btn_delete"
+            android:layout_width="0dp"
+            android:layout_height="36dp"
+            android:layout_weight="1"
+            android:padding="8dp"
+            android:src="@drawable/ic_delete"
+            android:contentDescription="Delete"/>
+
+    </LinearLayout>
+
+</FrameLayout>
\ No newline at end of file
diff --git a/gallery/src/main/res/menu/menu_album.xml b/gallery/src/main/res/menu/menu_album.xml
new file mode 100644
index 0000000..9fbf668
--- /dev/null
+++ b/gallery/src/main/res/menu/menu_album.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/action_sort"
+        android:icon="@drawable/ic_sort"
+        android:title="排序"
+        app:showAsAction="ifRoom">
+        <menu>
+            <group android:checkableBehavior="single">
+                <item
+                    android:id="@+id/sort_time_desc"
+                    android:title="时间倒序"/>
+                <item
+                    android:id="@+id/sort_time_asc"
+                    android:title="时间正序"/>
+                <item
+                    android:id="@+id/sort_name_desc"
+                    android:title="名称倒序"/>
+                <item
+                    android:id="@+id/sort_name_asc"
+                    android:title="名称正序"/>
+            </group>
+        </menu>
+    </item>
+</menu>
\ No newline at end of file
diff --git a/gallery/src/main/res/menu/menu_crop.xml b/gallery/src/main/res/menu/menu_crop.xml
new file mode 100644
index 0000000..674a000
--- /dev/null
+++ b/gallery/src/main/res/menu/menu_crop.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/action_done"
+        android:title="完成"
+        app:showAsAction="always"/>
+</menu>
\ No newline at end of file
diff --git a/gallery/src/main/res/menu/menu_main.xml b/gallery/src/main/res/menu/menu_main.xml
new file mode 100644
index 0000000..3c96f85
--- /dev/null
+++ b/gallery/src/main/res/menu/menu_main.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    <item
+        android:id="@+id/action_mi_gallery"
+        android:title="@string/mi_gallery"
+        android:icon="@drawable/ic_mi_gallery"
+        app:showAsAction="ifRoom"/>
+    
+    <item
+        android:id="@+id/action_change_bg_color"
+        android:title="修改背景颜色"
+        app:showAsAction="never"/>
+    
+    <item
+        android:id="@+id/action_trash"
+        android:title="@string/trash"
+        app:showAsAction="never"/>
+    
+    <item
+        android:id="@+id/action_settings"
+        android:title="@string/settings"
+        app:showAsAction="never"/>
+    
+    <item
+        android:id="@+id/action_about"
+        android:title="@string/about"
+        app:showAsAction="never"/>
+    
+    <item
+        android:id="@+id/action_debug"
+        android:title="@string/debug_log"
+        app:showAsAction="never"/>
+    
+</menu>
\ No newline at end of file
diff --git a/gallery/src/main/res/menu/menu_trash.xml b/gallery/src/main/res/menu/menu_trash.xml
new file mode 100644
index 0000000..39a2ad3
--- /dev/null
+++ b/gallery/src/main/res/menu/menu_trash.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    <item
+        android:id="@+id/action_trash"
+        android:title="@string/trash"
+        app:showAsAction="never"/>
+    
+    <item
+        android:id="@+id/action_clear_trash"
+        android:title="@string/clear_trash"
+        app:showAsAction="never"/>
+    
+</menu>
\ No newline at end of file
diff --git a/gallery/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/gallery/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/gallery/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/gallery/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/gallery/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/gallery/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/gallery/src/main/res/mipmap-hdpi/ic_launcher.png b/gallery/src/main/res/mipmap-hdpi/ic_launcher.png
new file mode 100644
index 0000000..a2f5908
Binary files /dev/null and b/gallery/src/main/res/mipmap-hdpi/ic_launcher.png differ
diff --git a/gallery/src/main/res/mipmap-hdpi/ic_launcher_round.png b/gallery/src/main/res/mipmap-hdpi/ic_launcher_round.png
new file mode 100644
index 0000000..1b52399
Binary files /dev/null and b/gallery/src/main/res/mipmap-hdpi/ic_launcher_round.png differ
diff --git a/gallery/src/main/res/mipmap-mdpi/ic_launcher.png b/gallery/src/main/res/mipmap-mdpi/ic_launcher.png
new file mode 100644
index 0000000..ff10afd
Binary files /dev/null and b/gallery/src/main/res/mipmap-mdpi/ic_launcher.png differ
diff --git a/gallery/src/main/res/mipmap-mdpi/ic_launcher_round.png b/gallery/src/main/res/mipmap-mdpi/ic_launcher_round.png
new file mode 100644
index 0000000..115a4c7
Binary files /dev/null and b/gallery/src/main/res/mipmap-mdpi/ic_launcher_round.png differ
diff --git a/gallery/src/main/res/mipmap-xhdpi/ic_launcher.png b/gallery/src/main/res/mipmap-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..dcd3cd8
Binary files /dev/null and b/gallery/src/main/res/mipmap-xhdpi/ic_launcher.png differ
diff --git a/gallery/src/main/res/mipmap-xhdpi/ic_launcher_round.png b/gallery/src/main/res/mipmap-xhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..459ca60
Binary files /dev/null and b/gallery/src/main/res/mipmap-xhdpi/ic_launcher_round.png differ
diff --git a/gallery/src/main/res/mipmap-xxhdpi/ic_launcher.png b/gallery/src/main/res/mipmap-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..8ca12fe
Binary files /dev/null and b/gallery/src/main/res/mipmap-xxhdpi/ic_launcher.png differ
diff --git a/gallery/src/main/res/mipmap-xxhdpi/ic_launcher_round.png b/gallery/src/main/res/mipmap-xxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..8e19b41
Binary files /dev/null and b/gallery/src/main/res/mipmap-xxhdpi/ic_launcher_round.png differ
diff --git a/gallery/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/gallery/src/main/res/mipmap-xxxhdpi/ic_launcher.png
new file mode 100644
index 0000000..b824ebd
Binary files /dev/null and b/gallery/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ
diff --git a/gallery/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png b/gallery/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..4c19a13
Binary files /dev/null and b/gallery/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png differ
diff --git a/gallery/src/main/res/values/colors.xml b/gallery/src/main/res/values/colors.xml
new file mode 100644
index 0000000..f91a689
--- /dev/null
+++ b/gallery/src/main/res/values/colors.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#009688</color>
+    <color name="colorPrimaryDark">#00796B</color>
+    <color name="colorAccent">#FF9800</color>
+    <color name="black">#000000</color>
+    <color name="white">#FFFFFF</color>
+</resources>
\ No newline at end of file
diff --git a/gallery/src/main/res/values/strings.xml b/gallery/src/main/res/values/strings.xml
new file mode 100644
index 0000000..9b7cc5e
--- /dev/null
+++ b/gallery/src/main/res/values/strings.xml
@@ -0,0 +1,24 @@
+<resources>
+    <string name="app_name">Gallery</string>
+    <string name="app_description">WinBoLL Album App</string>
+    <string name="refresh">Refresh</string>
+    <string name="settings">Settings</string>
+    <string name="settings_title">Settings</string>
+    <string name="about">About</string>
+    <string name="folder_path">Folder Path</string>
+    <string name="enter_folder_path">Enter folder path</string>
+    <string name="save">Save</string>
+    <string name="cancel">Cancel</string>
+    <string name="no_images_found">No images found</string>
+    <string name="trash">Trash</string>
+    <string name="clear_trash">Clear Trash</string>
+    <string name="delete_confirm">Delete to trash?</string>
+    <string name="restore_confirm">Restore to original folder?</string>
+    <string name="yes">Yes</string>
+    <string name="no">No</string>
+    <string name="debug_log">Debug Log</string>
+    <string name="debug_message">Debug log message</string>
+    <string name="system_gallery">系统相册</string>
+    <string name="mi_gallery">小米相册</string>
+    <string name="reset_gallery">重置</string>
+</resources>
diff --git a/gallery/src/main/res/values/styles.xml b/gallery/src/main/res/values/styles.xml
new file mode 100644
index 0000000..0049172
--- /dev/null
+++ b/gallery/src/main/res/values/styles.xml
@@ -0,0 +1,16 @@
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+    <style name="ColorPaletteDialog" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="android:windowBackground">@android:color/transparent</item>
+        <item name="android:windowIsFloating">false</item>
+    </style>
+
+</resources>
diff --git a/gallery/src/stage/AndroidManifest.xml b/gallery/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/gallery/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/gallery/src/stage/res/values/strings.xml b/gallery/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/gallery/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/gpsrelaysentinel/README.md b/gpsrelaysentinel/README.md
new file mode 100644
index 0000000..5d77c94
--- /dev/null
+++ b/gpsrelaysentinel/README.md
@@ -0,0 +1,239 @@
+# GPSRelaySentinel
+
+---
+
+## 中文文档
+
+### 项目介绍
+
+GPSRelaySentinel 是一款专业的 **GPS 定位中继守护工具**，支持真实系统 GPS 定位监听与模拟 GPS 坐标仿真双模式运行。应用后台常驻前台服务，实时接收系统 GPS 位置数据，内置订阅者步长阈值判断机制，可对多个 GPS 订阅视图进行定点推送管理。
+
+#### 核心功能
+
+- **双模式运行**：支持真实 GPS 工作模式与虚拟仿真模式一键切换
+- **前台常驻服务**：`MainService` 作为前台 Service 持续监听 GPS 定位变化
+- **订阅者管理**：内置 `GpsSubscribeManager` 与 `SubscribeLocationManager`，支持多订阅者步长阈值推送
+- **模拟控制面板**：支持八大方位选择、自定义移动距离，自动计算偏移目标经纬度
+- **实时日志输出**：集成 `LogView` 面板，方便调试定位轨迹与订阅推送状态
+- **崩溃处理**：`App` 类提供全局 CrashHandler 与 CrashActivity 展示崩溃日志
+- **关于页面**：工具栏提供 About 按钮，可查看应用版本与项目信息
+
+#### 技术栈
+
+| 项目 | 版本/说明 |
+|------|-----------|
+| 编程语言 | Java 7（源码） |
+| 编译环境 | Java 11（Gradle 编译） |
+| Gradle 插件 | 7.2.1 |
+| 最低 API | API 26 (Android 8.0) |
+| 目标 API | API 30 (Android 11) |
+| 编译 API | API 30 |
+
+#### 模块结构
+
+本项目采用多模块 Gradle 结构：
+
+| 模块 | 类型 | 说明 |
+|------|------|------|
+| `:gpsrelaysentinel` | application | 主应用模块（MainActivity、MainService、AboutActivity 等） |
+| `:libgpsrelaysentinel` | library | GPS 中继核心类库（GpsSubscribeManager、SubscribeLocationManager 等） |
+
+#### 核心依赖库
+
+**网络相关**
+- OkHttp 4.4.1 / 3.14.9 — HTTP 客户端
+- Gson 2.10.1 — JSON 解析
+
+**终端模拟**
+- Termux: terminal-emulator 0.118.0
+- Termux: terminal-view 0.118.0
+- Termux: termux-shared 0.118.0
+
+**功能组件**
+- ZXing 3.4.1 — 二维码生成与扫描
+- JSch 0.1.55 — SSH/SFTP 客户端
+- Jsoup 1.13.1 — HTML 解析
+- FastJSON 1.2.76 — JSON 处理
+
+**UI 组件**
+- Material Design 1.4.0
+- AndroidX 组件库
+- PullRefreshLayout 1.2.0 — 下拉刷新
+
+#### 编译说明
+
+**调试版编译**
+```bash
+./gradlew assembleBetaDebug
+```
+
+**阶段版编译（发布）**
+```bash
+bash .winboll/bashPublishAPKAddTag.sh gpsrelaysentinel
+```
+
+**版本管理**
+版本信息由 `gpsrelaysentinel/build.properties` 管理：
+- `baseVersion` — 基础版本号
+- `stageCount` — 阶段构建次数
+- `publishVersion` — 发布版本号
+- `buildCount` — 构建次数
+
+#### 权限说明
+
+应用需要以下权限：
+- `ACCESS_FINE_LOCATION` — 精确定位
+- `ACCESS_COARSE_LOCATION` — 大致定位
+- `ACCESS_BACKGROUND_LOCATION` — 后台定位
+- `FOREGROUND_SERVICE` — 前台服务
+
+#### 项目结构
+
+```
+gpsrelaysentinel/
+├── src/main/
+│   ├── java/cc/winboll/studio/gpsrelaysentinel/
+│   │   ├── App.java              # Application 类，初始化与崩溃处理
+│   │   ├── MainActivity.java     # 主控制页面（GPS服务开关、模拟面板、订阅视图）
+│   │   ├── MainService.java      # GPS 定位核心前台服务
+│   │   ├── AboutActivity.java    # 关于页面
+│   │   └── GpsReceiverChildService[1-3].java  # GPS 接收子服务
+│   ├── res/
+│   │   ├── layout/               # 布局文件
+│   │   ├── menu/                 # 菜单文件
+│   │   └── values/               # 资源值文件
+│   ├── libs/                     # 本地库文件
+│   └── AndroidManifest.xml       # 应用清单
+├── build.gradle                  # 模块构建配置
+└── build.properties              # 版本配置文件
+```
+
+#### 参与贡献
+
+1. Fork 本仓库
+2. 新建功能分支 (`git checkout -b feat_xxx`)
+3. 提交代码（作者: ZhanGSKen <ZhanGSKen@QQ.COM>）
+4. 新建 Pull Request
+
+#### 许可证
+
+[待添加许可证信息]
+
+---
+
+## English Documentation
+
+### Project Introduction
+
+GPSRelaySentinel is a professional **GPS relay and guardian tool**, supporting dual modes of real system GPS location monitoring and simulated GPS coordinate simulation. It runs as a foreground persistent background service, receives real-time system GPS location data, and builds-in subscriber step threshold judgment mechanism to manage fixed-point push for multiple GPS subscription views.
+
+#### Core Features
+
+- **Dual Mode Operation**: One-click switch between real GPS working mode and virtual simulation mode
+- **Foreground Persistent Service**: `MainService` as a foreground Service continuously monitors GPS location changes
+- **Subscriber Management**: Built-in `GpsSubscribeManager` and `SubscribeLocationManager`, supporting multi-subscriber step threshold push
+- **Simulation Control Panel**: Supports eight direction selections, custom moving distance, and automatic offset target coordinate calculation
+- **Real-time Log Output**: Integrated `LogView` panel for debugging location tracks and subscription push status
+- **Crash Handling**: `App` class provides global CrashHandler and CrashActivity for crash log display
+- **About Page**: Toolbar provides an About button to view app version and project information
+
+#### Tech Stack
+
+| Item | Version/Description |
+|------|---------------------|
+| Programming Language | Java 7 (source code) |
+| Build Environment | Java 11 (Gradle compilation) |
+| Gradle Plugin | 7.2.1 |
+| Minimum API | API 26 (Android 8.0) |
+| Target API | API 30 (Android 11) |
+| Compile API | API 30 |
+
+#### Module Structure
+
+This project uses a multi-module Gradle structure:
+
+| Module | Type | Description |
+|--------|------|-------------|
+| `:gpsrelaysentinel` | application | Main application module (MainActivity, MainService, AboutActivity, etc.) |
+| `:libgpsrelaysentinel` | library | GPS relay core library (GpsSubscribeManager, SubscribeLocationManager, etc.) |
+
+#### Core Dependencies
+
+**Networking**
+- OkHttp 4.4.1 / 3.14.9 — HTTP client
+- Gson 2.10.1 — JSON parsing
+
+**Terminal Emulation**
+- Termux: terminal-emulator 0.118.0
+- Termux: terminal-view 0.118.0
+- Termux: termux-shared 0.118.0
+
+**Functional Components**
+- ZXing 3.4.1 — QR code generation and scanning
+- JSch 0.1.55 — SSH/SFTP client
+- Jsoup 1.13.1 — HTML parsing
+- FastJSON 1.2.76 — JSON processing
+
+**UI Components**
+- Material Design 1.4.0
+- AndroidX libraries
+- PullRefreshLayout 1.2.0 — Pull-to-refresh
+
+#### Build Instructions
+
+**Debug Build**
+```bash
+./gradlew assembleBetaDebug
+```
+
+**Stage Build (Release)**
+```bash
+bash .winboll/bashPublishAPKAddTag.sh gpsrelaysentinel
+```
+
+**Version Management**
+Version info is managed by `gpsrelaysentinel/build.properties`:
+- `baseVersion` — Base version number
+- `stageCount` — Stage build count
+- `publishVersion` — Release version number
+- `buildCount` — Build count
+
+#### Permissions
+
+The app requires the following permissions:
+- `ACCESS_FINE_LOCATION` — Precise location
+- `ACCESS_COARSE_LOCATION` — Approximate location
+- `ACCESS_BACKGROUND_LOCATION` — Background location
+- `FOREGROUND_SERVICE` — Foreground service
+
+#### Project Structure
+
+```
+gpsrelaysentinel/
+├── src/main/
+│   ├── java/cc/winboll/studio/gpsrelaysentinel/
+│   │   ├── App.java              # Application class, initialization and crash handling
+│   │   ├── MainActivity.java     # Main control page (GPS service switch, simulation panel, subscription views)
+│   │   ├── MainService.java      # GPS location core foreground service
+│   │   ├── AboutActivity.java    # About page
+│   │   └── GpsReceiverChildService[1-3].java  # GPS receiver child services
+│   ├── res/
+│   │   ├── layout/               # Layout files
+│   │   ├── menu/                 # Menu files
+│   │   └── values/               # Resource value files
+│   ├── libs/                     # Local library files
+│   └── AndroidManifest.xml       # App manifest
+├── build.gradle                  # Module build configuration
+└── build.properties              # Version configuration file
+```
+
+#### Contributing
+
+1. Fork this repository
+2. Create a feature branch (`git checkout -b feat_xxx`)
+3. Commit your changes (Author: ZhanGSKen <ZhanGSKen@QQ.COM>)
+4. Create a Pull Request
+
+#### License
+
+[License information to be added]
diff --git a/gpsrelaysentinel/app_update_description.txt b/gpsrelaysentinel/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/gpsrelaysentinel/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/gpsrelaysentinel/build.gradle b/gpsrelaysentinel/build.gradle
new file mode 100644
index 0000000..1106541
--- /dev/null
+++ b/gpsrelaysentinel/build.gradle
@@ -0,0 +1,126 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.gpsrelaysentinel"
+        minSdkVersion 26
+		// 适配MIUI12
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.11"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+	
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['libs'] // 若SO库放在libs目录下
+        }
+    }
+
+    // 确保 Java 7 兼容性
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+}
+
+dependencies {
+	api project(':libgpsrelaysentinel')
+    
+    api 'com.google.code.gson:gson:2.10.1'
+	
+	// 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// OkHttp网络请求
+     implementation 'com.squareup.okhttp3:okhttp:3.14.9'
+     // FastJSON解析
+     implementation 'com.alibaba:fastjson:1.2.76'
+    
+	// AndroidX 类库
+    /*api 'androidx.appcompat:appcompat:1.1.0'
+    //api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'*/
+	
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+
+	implementation "androidx.annotation:annotation:1.3.0"
+    implementation "androidx.core:core:1.6.0"
+    implementation "androidx.drawerlayout:drawerlayout:1.1.1"
+    implementation "androidx.preference:preference:1.1.1"
+    implementation "androidx.viewpager:viewpager:1.0.0"
+    implementation "com.google.android.material:material:1.4.0"
+    implementation "com.google.guava:guava:24.1-jre"
+    /*
+	implementation "io.noties.markwon:core:$markwonVersion"
+    implementation "io.noties.markwon:ext-strikethrough:$markwonVersion"
+    implementation "io.noties.markwon:linkify:$markwonVersion"
+    implementation "io.noties.markwon:recycler:$markwonVersion"
+	*/
+	implementation 'com.termux:terminal-emulator:0.118.0'
+	implementation 'com.termux:terminal-view:0.118.0'
+	implementation 'com.termux:termux-shared:0.118.0'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.9'
+    api 'cc.winboll.studio:libappbase:15.15.21'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.15.7'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.4'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/gpsrelaysentinel/build.properties b/gpsrelaysentinel/build.properties
new file mode 100644
index 0000000..a90d0d0
--- /dev/null
+++ b/gpsrelaysentinel/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Thu May 07 19:19:06 CST 2026
+stageCount=27
+libraryProject=
+baseVersion=15.11
+publishVersion=15.11.26
+buildCount=36
+baseBetaVersion=15.11.27
diff --git a/gpsrelaysentinel/proguard-rules.pro b/gpsrelaysentinel/proguard-rules.pro
new file mode 100644
index 0000000..a18de74
--- /dev/null
+++ b/gpsrelaysentinel/proguard-rules.pro
@@ -0,0 +1,137 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/gpsrelaysentinel/src/beta/AndroidManifest.xml b/gpsrelaysentinel/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/gpsrelaysentinel/src/beta/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/gpsrelaysentinel/src/beta/res/values/strings.xml b/gpsrelaysentinel/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..c9ff784
--- /dev/null
+++ b/gpsrelaysentinel/src/beta/res/values/strings.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">GPSRelaySentinel★</string>
+	<string name="app_description">一款支持真实/模拟定位的GPS中继工具，可后台常驻，实现位置数据转发、调试与仿真，适配开发测试使用。</string>
+
+</resources>
diff --git a/gpsrelaysentinel/src/main/AndroidManifest.xml b/gpsrelaysentinel/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..6662d6d
--- /dev/null
+++ b/gpsrelaysentinel/src/main/AndroidManifest.xml
@@ -0,0 +1,62 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.gpsrelaysentinel">
+
+    <!-- 只能在前台获取精确的位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
+
+    <!-- 只有在前台运行时才能获取大致位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+
+    <!-- 在后台使用位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
+
+    <!-- 运行前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:resizeableActivity="true"
+        android:name=".App">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name=".GlobalApplication$CrashActivity"/>
+
+        <service
+            android:name=".MainService"
+            android:enabled="true"
+            android:exported="false"/>
+
+        <service android:name=".GpsReceiverChildService1"/>
+
+        <service android:name=".GpsReceiverChildService2"/>
+
+        <service android:name=".GpsReceiverChildService3"/>
+
+        <activity android:name=".AboutActivity"/>
+
+    </application>
+
+</manifest>
\ No newline at end of file
diff --git a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/AboutActivity.java b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/AboutActivity.java
new file mode 100644
index 0000000..f275611
--- /dev/null
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/AboutActivity.java
@@ -0,0 +1,58 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.app.Activity;
+import android.os.Bundle;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 15:39
+ */
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+
+public class AboutActivity extends AppCompatActivity {
+
+    public static final String TAG = "AboutActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					finish();
+				}
+			});
+
+        AboutView aboutView = findViewById(R.id.aboutview);
+        aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+    private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "gpsrelaysentinel";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName("GPSRelaySentinel");
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=GPSRelaySentinel");
+        appInfo.setAppAPKName("GPSRelaySentinel");
+        appInfo.setAppAPKFolderName("GPSRelaySentinel");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
diff --git a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/App.java b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/App.java
new file mode 100644
index 0000000..317282e
--- /dev/null
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/App.java
@@ -0,0 +1,340 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.res.Resources;
+import android.graphics.Typeface;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.util.Log;
+import android.view.Gravity;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+import android.widget.HorizontalScrollView;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Arrays;
+import java.util.Date;
+import java.util.LinkedHashMap;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+public class App extends GlobalApplication {
+
+    private static Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+		
+        //CrashHandler.getInstance().registerGlobal(this);
+        //CrashHandler.getInstance().registerPart(this);
+    }
+
+    public static void write(InputStream input, OutputStream output) throws IOException {
+        byte[] buf = new byte[1024 * 8];
+        int len;
+        while ((len = input.read(buf)) != -1) {
+            output.write(buf, 0, len);
+        }
+    }
+
+    public static void write(File file, byte[] data) throws IOException {
+        File parent = file.getParentFile();
+        if (parent != null && !parent.exists()) parent.mkdirs();
+
+        ByteArrayInputStream input = new ByteArrayInputStream(data);
+        FileOutputStream output = new FileOutputStream(file);
+        try {
+            write(input, output);
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static String toString(InputStream input) throws IOException {
+        ByteArrayOutputStream output = new ByteArrayOutputStream();
+        write(input, output);
+        try {
+            return output.toString("UTF-8");
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static void closeIO(Closeable... closeables) {
+        for (Closeable closeable : closeables) {
+            try {
+                if (closeable != null) closeable.close();
+            } catch (IOException ignored) {}
+        }
+    }
+
+    public static class CrashHandler {
+
+        public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+
+        private static CrashHandler sInstance;
+
+        private PartCrashHandler mPartCrashHandler;
+
+        public static CrashHandler getInstance() {
+            if (sInstance == null) {
+                sInstance = new CrashHandler();
+            }
+            return sInstance;
+        }
+
+        public void registerGlobal(Context context) {
+            registerGlobal(context, null);
+        }
+
+        public void registerGlobal(Context context, String crashDir) {
+            Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandlerImpl(context.getApplicationContext(), crashDir));
+        }
+
+        public void unregister() {
+            Thread.setDefaultUncaughtExceptionHandler(DEFAULT_UNCAUGHT_EXCEPTION_HANDLER);
+        }
+
+        public void registerPart(Context context) {
+            unregisterPart(context);
+            mPartCrashHandler = new PartCrashHandler(context.getApplicationContext());
+            MAIN_HANDLER.postAtFrontOfQueue(mPartCrashHandler);
+        }
+
+        public void unregisterPart(Context context) {
+            if (mPartCrashHandler != null) {
+                mPartCrashHandler.isRunning.set(false);
+                mPartCrashHandler = null;
+            }
+        }
+
+        private static class PartCrashHandler implements Runnable {
+
+            private final Context mContext;
+
+            public AtomicBoolean isRunning = new AtomicBoolean(true);
+
+            public PartCrashHandler(Context context) {
+                this.mContext = context;
+            }
+
+            @Override
+            public void run() {
+                while (isRunning.get()) {
+                    try {
+                        Looper.loop();
+                    } catch (final Throwable e) {
+                        e.printStackTrace();
+                        if (isRunning.get()) {
+                            MAIN_HANDLER.post(new Runnable(){
+
+                                    @Override
+                                    public void run() {
+                                        Toast.makeText(mContext, e.toString(), Toast.LENGTH_LONG).show();
+                                    }
+                                });
+                        } else {
+                            if (e instanceof RuntimeException) {
+                                throw (RuntimeException)e;
+                            } else {
+                                throw new RuntimeException(e);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        private static class UncaughtExceptionHandlerImpl implements UncaughtExceptionHandler {
+
+            private static DateFormat DATE_FORMAT = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss");
+
+            private final Context mContext;
+
+            private final File mCrashDir;
+
+            public UncaughtExceptionHandlerImpl(Context context, String crashDir) {
+                this.mContext = context;
+                this.mCrashDir = TextUtils.isEmpty(crashDir) ? new File(mContext.getExternalCacheDir(), "crash") : new File(crashDir);
+            }
+
+            @Override
+            public void uncaughtException(Thread thread, Throwable throwable) {
+                try {
+
+                    String log = buildLog(throwable);
+                    writeLog(log);
+
+                    try {
+                        Intent intent = new Intent(mContext, CrashActivity.class);
+                        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                        intent.putExtra(Intent.EXTRA_TEXT, log);
+                        mContext.startActivity(intent);
+                    } catch (Throwable e) {
+                        e.printStackTrace();
+                        writeLog(e.toString());
+                    }
+
+                    throwable.printStackTrace();
+                    android.os.Process.killProcess(android.os.Process.myPid());
+                    System.exit(0);
+
+                } catch (Throwable e) {
+                    if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+                }
+            }
+
+            private String buildLog(Throwable throwable) {
+                String time = DATE_FORMAT.format(new Date());
+
+                String versionName = "unknown";
+                long versionCode = 0;
+                try {
+                    PackageInfo packageInfo = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0);
+                    versionName = packageInfo.versionName;
+                    versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+                } catch (Throwable ignored) {}
+
+                LinkedHashMap<String, String> head = new LinkedHashMap<String, String>();
+                head.put("Time Of Crash", time);
+                head.put("Device", String.format("%s, %s", Build.MANUFACTURER, Build.MODEL));
+                head.put("Android Version", String.format("%s (%d)", Build.VERSION.RELEASE, Build.VERSION.SDK_INT));
+                head.put("App Version", String.format("%s (%d)", versionName, versionCode));
+                head.put("Kernel", getKernel());
+                head.put("Support Abis", Build.VERSION.SDK_INT >= 21 && Build.SUPPORTED_ABIS != null ? Arrays.toString(Build.SUPPORTED_ABIS): "unknown");
+                head.put("Fingerprint", Build.FINGERPRINT);
+
+                StringBuilder builder = new StringBuilder();
+
+                for (String key : head.keySet()) {
+                    if (builder.length() != 0) builder.append("\n");
+                    builder.append(key);
+                    builder.append(" :    ");
+                    builder.append(head.get(key));
+                }
+
+                builder.append("\n\n");
+                builder.append(Log.getStackTraceString(throwable));
+
+                return builder.toString(); 
+            }
+
+            private void writeLog(String log) {
+                String time = DATE_FORMAT.format(new Date());
+                File file = new File(mCrashDir, "crash_" + time + ".txt");
+                try {
+                    write(file, log.getBytes("UTF-8"));
+                } catch (Throwable e) {
+                    e.printStackTrace();
+                } 
+            }
+
+            private static String getKernel() {
+                try {
+                    return App.toString(new FileInputStream("/proc/version")).trim();
+                } catch (Throwable e) {
+                    return e.getMessage();
+                }
+            }
+        }
+    }
+
+    public static final class CrashActivity extends Activity {
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+
+            setTheme(android.R.style.Theme_DeviceDefault);
+            setTitle("App Crash");
+
+            mLog = getIntent().getStringExtra(Intent.EXTRA_TEXT);
+
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+
+            HorizontalScrollView horizontalScrollView = new HorizontalScrollView(this);
+
+            TextView textView = new TextView(this);
+            int padding = dp2px(16);
+            textView.setPadding(padding, padding, padding, padding);
+            textView.setText(mLog);
+            textView.setTextIsSelectable(true);
+            textView.setTypeface(Typeface.DEFAULT);
+            textView.setLinksClickable(true);
+
+            horizontalScrollView.addView(textView);
+            contentView.addView(horizontalScrollView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+
+            setContentView(contentView);
+        }
+
+        private void restart() {
+            Intent intent = getPackageManager().getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        private static int dp2px(float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(Menu menu) {
+            menu.add(0, android.R.id.copy, 0, android.R.string.copy)
+                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+            return super.onCreateOptionsMenu(menu);
+        }
+
+        @Override
+        public boolean onOptionsItemSelected(MenuItem item) {
+            switch (item.getItemId()) {
+                case android.R.id.copy:
+                    ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+                    return true;
+            }
+            return super.onOptionsItemSelected(item);
+        }
+
+        @Override
+        public void onBackPressed() {
+            restart();
+        }
+    }
+}
diff --git a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService1.java b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService1.java
new file mode 100644
index 0000000..d65cce0
--- /dev/null
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService1.java
@@ -0,0 +1,27 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Intent;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+import cc.winboll.studio.libgpsrelaysentinel.service.GpsSubscribeReceiverService;
+
+public final class GpsReceiverChildService1 extends GpsSubscribeReceiverService {
+
+    public static final String TAG = "GpsReceiverChildService1";
+
+    @Override
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config) {
+        super.onReceiveGpsData(point, config);
+        //当前独立接收日志
+        LogUtils.d(TAG,"独立接收服务1 成功收到GPS消息");
+        LogUtils.d(TAG,"纬度:"+point.getLatitude()+" 经度:"+point.getLongitude());
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        return START_NOT_STICKY;
+    }
+}
+
diff --git a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService2.java b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService2.java
new file mode 100644
index 0000000..d058f92
--- /dev/null
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService2.java
@@ -0,0 +1,26 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Intent;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+import cc.winboll.studio.libgpsrelaysentinel.service.GpsSubscribeReceiverService;
+
+public final class GpsReceiverChildService2 extends GpsSubscribeReceiverService {
+
+    public static final String TAG = "GpsReceiverChildService2";
+
+    @Override
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config) {
+        super.onReceiveGpsData(point, config);
+        LogUtils.d(TAG,"独立接收服务2 成功收到GPS消息");
+        LogUtils.d(TAG,"纬度:"+point.getLatitude()+" 经度:"+point.getLongitude());
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        return START_NOT_STICKY;
+    }
+}
+
diff --git a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService3.java b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService3.java
new file mode 100644
index 0000000..fb04c12
--- /dev/null
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService3.java
@@ -0,0 +1,26 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Intent;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+import cc.winboll.studio.libgpsrelaysentinel.service.GpsSubscribeReceiverService;
+
+public final class GpsReceiverChildService3 extends GpsSubscribeReceiverService {
+
+    public static final String TAG = "GpsReceiverChildService3";
+
+    @Override
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config) {
+        super.onReceiveGpsData(point, config);
+        LogUtils.d(TAG,"独立接收服务3 成功收到GPS消息");
+        LogUtils.d(TAG,"纬度:"+point.getLatitude()+" 经度:"+point.getLongitude());
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        return START_NOT_STICKY;
+    }
+}
+
diff --git a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainActivity.java b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainActivity.java
new file mode 100644
index 0000000..21fc4a0
--- /dev/null
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainActivity.java
@@ -0,0 +1,375 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.AdapterView;
+import android.widget.ArrayAdapter;
+import android.widget.Button;
+import android.widget.CheckBox;
+import android.widget.CompoundButton;
+import android.widget.EditText;
+import android.widget.Spinner;
+import android.widget.Switch;
+import android.widget.TextView;
+import android.view.Menu;
+import android.view.MenuItem;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.gpsrelaysentinel.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * WinBoLL Studio
+ * GPSRelaySentinel 主控制页面
+ * Java7 | API26~30
+ * 新增：模拟模式勾选控制 + 按钮互斥可用状态
+ */
+public final class MainActivity extends AppCompatActivity {
+
+    //原有控件
+    private Toolbar mToolbar;
+    private LogView mLogView;
+    private Switch mSwitchService;
+
+    //新增
+    private CheckBox mCheckBoxSimMode;
+    private Button btnSendLastGps;
+    private Spinner spinDirection;
+    private EditText etSimDistance;
+    private TextView tvTargetPreview;
+    private Button btnSimSend;
+
+    //全局模式标识 供给MainService判断
+    public static boolean IS_GPS_SIM_MODE = false;
+
+    //最后真实GPS坐标
+    public static double lastLat = 30.5928;
+    public static double lastLng = 114.3055;
+
+    //全局模拟坐标 供给MainService使用
+    public static double simLat = 30.5928;
+    public static double simLng = 114.3055;
+
+    //方位对应角度(正北0° 顺时针)
+    private double currentAngle = 0.0D;
+
+    //权限请求常量
+    private static final int REQUEST_LOCATION_PERMISSION = 1;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+        initView();
+        initToolbar();
+        initSwitchEvent();
+        initSimPanelEvent();
+        initSimModeCheck();
+
+        ToastUtils.show("onCreate");
+    }
+
+    /**
+     * 全部控件绑定
+     */
+    private void initView() {
+        //原有
+        mToolbar = findViewById(R.id.toolbar);
+        mLogView = findViewById(R.id.logview);
+        mSwitchService = findViewById(R.id.switch_service);
+
+        //新增
+        mCheckBoxSimMode = findViewById(R.id.checkbox_sim_mode);
+        btnSendLastGps = findViewById(R.id.btn_send_last_gps);
+        spinDirection = findViewById(R.id.spin_direction);
+        etSimDistance = findViewById(R.id.et_sim_distance);
+        tvTargetPreview = findViewById(R.id.tv_target_point_preview);
+        btnSimSend = findViewById(R.id.btn_sim_send_gps);
+
+		//方位下拉 全局灰色文字
+		ArrayAdapter<CharSequence> dirAdapter = ArrayAdapter.createFromResource(
+			this,
+			R.array.direction_list,
+			R.layout.spinner_item_gray
+		);
+		dirAdapter.setDropDownViewResource(R.layout.spinner_item_gray);
+		spinDirection.setAdapter(dirAdapter);
+
+        //初始化开关状态
+        mSwitchService.setChecked(hasLocationPermission());
+        refreshButtonEnableStatus();
+        refreshTargetPreview();
+    }
+
+    //模拟勾选框监听
+    private void initSimModeCheck() {
+        mCheckBoxSimMode.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
+					IS_GPS_SIM_MODE = isChecked;
+					refreshButtonEnableStatus();
+					if (isChecked) {
+						ToastUtils.show("已进入GPS模拟模式");
+					} else {
+						ToastUtils.show("退出模拟模式，使用真实GPS");
+					}
+				}
+			});
+    }
+
+    //刷新按钮互斥可用状态
+    private void refreshButtonEnableStatus() {
+        if (IS_GPS_SIM_MODE) {
+            //模拟模式：真实按钮禁用、模拟按钮可用
+            btnSendLastGps.setEnabled(false);
+            btnSimSend.setEnabled(true);
+        } else {
+            //正常模式：真实可用、模拟禁用
+            btnSendLastGps.setEnabled(true);
+            btnSimSend.setEnabled(false);
+        }
+    }
+
+    /**
+     * 初始化标题栏
+     */
+    private void initToolbar() {
+        setSupportActionBar(mToolbar);
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.menu_main, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (item.getItemId() == R.id.action_about) {
+            startActivity(new Intent(this, AboutActivity.class));
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    /**
+     * GPS服务开关监听
+     */
+    private void initSwitchEvent() {
+        mSwitchService.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
+					if (isChecked) {
+						if (hasLocationPermission()) {
+							startGpsService();
+						} else {
+							requestLocationPermission();
+							mSwitchService.setChecked(false);
+						}
+					} else {
+						stopGpsService();
+					}
+				}
+			});
+    }
+
+    /**
+     * 模拟发送面板 全部事件初始化
+     */
+    private void initSimPanelEvent() {
+        //1.原按钮：发送最后一条真实GPS
+        btnSendLastGps.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					sendLastRealGpsBroadcast();
+				}
+			});
+
+        //2.方位下拉选择 -> 切换角度并刷新预览
+        spinDirection.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
+				@Override
+				public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
+					currentAngle = getDirectionAngle(position);
+					refreshTargetPreview();
+				}
+
+				@Override
+				public void onNothingSelected(AdapterView<?> parent) {}
+			});
+
+        //3.距离输入变化自动预览
+        etSimDistance.setOnFocusChangeListener(new View.OnFocusChangeListener() {
+				@Override
+				public void onFocusChange(View v, boolean hasFocus) {
+					if (!hasFocus) {
+						refreshTargetPreview();
+					}
+				}
+			});
+
+        //4.模拟发送按钮：计算偏移并赋值全局模拟坐标
+        btnSimSend.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					saveSimGpsData();
+					ToastUtils.show("已设置当前模拟GPS坐标");
+				}
+			});
+    }
+
+    /**
+     * 保存模拟坐标到全局静态变量 供给MainService使用
+     */
+    private void saveSimGpsData() {
+        String disText = etSimDistance.getText().toString().trim();
+        double distance = 10D;
+        try {
+            distance = Double.parseDouble(disText);
+        } catch (Exception e) {
+            ToastUtils.show("请输入合法距离");
+            return;
+        }
+        double[] target = calculateOffsetLatLng(lastLat, lastLng, distance, currentAngle);
+        simLat = target[0];
+        simLng = target[1];
+        refreshTargetPreview();
+    }
+
+    /**
+     * 根据下拉position获取对应方位角度
+     */
+    private double getDirectionAngle(int pos) {
+        switch (pos) {
+            case 0: return 0.0D;    //正北
+            case 1: return 180.0D;  //正南
+            case 2: return 90.0D;   //正东
+            case 3: return 270.0D;  //正西
+            case 4: return 45.0D;   //东北
+            case 5: return 315.0D;  //西北
+            case 6: return 135.0D;  //东南
+            case 7: return 225.0D;  //西南
+            default:return 0.0D;
+        }
+    }
+
+    /**
+     * 根据基准坐标+距离+角度 计算偏移经纬度
+     */
+    private double[] calculateOffsetLatLng(double lat, double lng, double distanceMeter, double angle) {
+        double radAngle = Math.toRadians(angle);
+        double radLat = Math.toRadians(lat);
+
+        double meterPerLat = 111320D;
+        double meterPerLng = Math.cos(radLat) * 111320D;
+
+        double offsetLat = (distanceMeter * Math.cos(radAngle)) / meterPerLat;
+        double offsetLng = (distanceMeter * Math.sin(radAngle)) / meterPerLng;
+
+        return new double[]{lat + offsetLat , lng + offsetLng};
+    }
+
+    /**
+     * 刷新目标坐标预览
+     */
+    private void refreshTargetPreview() {
+        String disText = etSimDistance.getText().toString().trim();
+        double distance = 10D;
+        try {
+            distance = Double.parseDouble(disText);
+        } catch (Exception e) {}
+
+        double[] target = calculateOffsetLatLng(lastLat, lastLng, distance, currentAngle);
+        String info = "目标模拟坐标："
+			+ String.format("%.6f", target[0])
+			+ " , "
+			+ String.format("%.6f", target[1]);
+        tvTargetPreview.setText(info);
+    }
+
+    /**
+     * 发送【最后真实GPS】广播
+     */
+    private void sendLastRealGpsBroadcast() {
+        Intent broadcast = new Intent("GPS_DATA_BROADCAST");
+        broadcast.putExtra("isSim", false);
+        broadcast.putExtra("lat", lastLat);
+        broadcast.putExtra("lng", lastLng);
+        sendBroadcast(broadcast);
+        LogUtils.d("GPS_SEND", "发送真实GPS -> lat:" + lastLat + " lng:" + lastLng);
+    }
+
+    //—————— 原有权限 & 服务启停 完全原样保留 ——————
+
+    private boolean hasLocationPermission() {
+        boolean basicPermission = checkSelfPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
+			|| checkSelfPermission(android.Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED;
+
+        if (basicPermission && android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
+            return checkSelfPermission(android.Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;
+        }
+        return basicPermission;
+    }
+
+    private void requestLocationPermission() {
+        String[] permissionArray;
+        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
+            permissionArray = new String[]{
+				android.Manifest.permission.ACCESS_FINE_LOCATION,
+				android.Manifest.permission.ACCESS_COARSE_LOCATION,
+				android.Manifest.permission.ACCESS_BACKGROUND_LOCATION
+            };
+        } else {
+            permissionArray = new String[]{
+				android.Manifest.permission.ACCESS_FINE_LOCATION,
+				android.Manifest.permission.ACCESS_COARSE_LOCATION
+            };
+        }
+        requestPermissions(permissionArray, REQUEST_LOCATION_PERMISSION);
+    }
+
+    private void startGpsService() {
+        Intent serviceIntent = new Intent(MainActivity.this, MainService.class);
+        startForegroundService(serviceIntent);
+        ToastUtils.show("GPS Service started");
+        LogUtils.d(MainService.TAG, "GPS Service started from MainActivity");
+    }
+
+    private void stopGpsService() {
+        getSharedPreferences(MainService.PREF_NAME, Context.MODE_PRIVATE)
+			.edit()
+			.putBoolean(MainService.KEY_SERVICE_ENABLED, false)
+			.apply();
+
+        Intent serviceIntent = new Intent(MainActivity.this, MainService.class);
+        stopService(serviceIntent);
+        ToastUtils.show("GPS Service stopped");
+        LogUtils.d(MainService.TAG, "GPS Service stopped from MainActivity");
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        if (requestCode == REQUEST_LOCATION_PERMISSION) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                mSwitchService.setChecked(true);
+                startGpsService();
+            } else {
+                ToastUtils.show("需要位置权限才能使用GPS服务");
+                mSwitchService.setChecked(false);
+            }
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        mLogView.start();
+    }
+}
+
diff --git a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainService.java b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainService.java
new file mode 100644
index 0000000..cc4f25a
--- /dev/null
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainService.java
@@ -0,0 +1,269 @@
+package cc.winboll.studio.gpsrelaysentinel;
+
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.location.Location;
+import android.location.LocationListener;
+import android.location.LocationManager;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.IBinder;
+
+import androidx.core.app.NotificationCompat;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.manager.GpsSubscribeManager;
+import cc.winboll.studio.libgpsrelaysentinel.manager.SubscribeLocationManager;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+
+import java.util.Map;
+
+/**
+ * WinBoLL Studio
+ * GPS定位核心前台服务
+ * 负责GPS持续监听、订阅者步长判断、基准坐标刷新、前台常驻通知
+ * Java7 | API26~30
+ * 新增：实时同步最新GPS到MainActivity静态坐标
+ */
+public final class MainService extends Service {
+
+    //日志标签
+    public static final String TAG = "MainService";
+
+    //前台通知常量
+    private static final String CHANNEL_ID = "gps_relay_channel";
+    private static final int NOTIFICATION_ID = 1;
+
+    //SP配置常量
+    static final String PREF_NAME = "gps_relay_service_prefs";
+    static final String KEY_SERVICE_ENABLED = "service_enabled";
+
+    //系统定位 & 通知控件
+    private LocationManager mLocationManager;
+    private LocationListener mLocationListener;
+    private NotificationManager mNotificationManager;
+    private NotificationCompat.Builder mNotificationBuilder;
+
+    //运行状态 & 计数
+    private boolean mIsRunning = false;
+    private int mGpsLocationCount = 0;
+
+    //订阅管理器
+    private GpsSubscribeManager mSubscribeManager;
+    private SubscribeLocationManager mLocationRuleManager;
+
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "Service onCreate");
+
+        initManager();
+        initNotificationConfig();
+
+        //上次开启状态则自动重启GPS监听
+        if (checkServiceEnableStatus()) {
+            LogUtils.d(TAG, "历史服务已启用，自动启动GPS监听");
+            startGpsLocationListen();
+        }
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "Service onStartCommand");
+        saveServiceEnableStatus(true);
+        startGpsLocationListen();
+        return START_STICKY;
+    }
+
+    /**
+     * 初始化订阅规则管理器
+     */
+    private void initManager() {
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationRuleManager = SubscribeLocationManager.getInstance();
+    }
+
+    /**
+     * 初始化通知渠道与管理类
+     */
+    private void initNotificationConfig() {
+        mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
+        createSystemNotificationChannel();
+    }
+
+    /**
+     * 读取服务启用状态
+     */
+    private boolean checkServiceEnableStatus() {
+        return getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE)
+			.getBoolean(KEY_SERVICE_ENABLED, false);
+    }
+
+    /**
+     * 保存服务启用状态
+     */
+    private void saveServiceEnableStatus(boolean enabled) {
+        getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE)
+			.edit()
+			.putBoolean(KEY_SERVICE_ENABLED, enabled)
+			.apply();
+        LogUtils.d(TAG, "服务启用状态已设置：" + enabled);
+    }
+
+    /**
+     * 启动GPS定位监听核心逻辑
+     */
+    private void startGpsLocationListen() {
+        if (mIsRunning) {
+            LogUtils.d(TAG, "GPS监听已正在运行，无需重复启动");
+            return;
+        }
+
+        mLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
+        initLocationListener();
+
+        try {
+            if (mLocationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
+                //定位间隔：1000毫秒 / 最小位移1米
+                mLocationManager.requestLocationUpdates(
+					LocationManager.GPS_PROVIDER,
+					1000,
+					1,
+					mLocationListener
+                );
+                mIsRunning = true;
+                startServiceForegroundNotification();
+                LogUtils.d(TAG, "GPS定位监听已成功注册");
+            }
+        } catch (SecurityException e) {
+            LogUtils.e(TAG, "定位权限缺失，监听启动失败：" + e.getMessage());
+        }
+    }
+
+    /**
+     * 初始化定位监听回调
+     */
+    private void initLocationListener() {
+        mLocationListener = new LocationListener() {
+            @Override
+            public void onLocationChanged(Location location) {
+                handleLocationUpdate(location);
+            }
+
+            @Override
+            public void onStatusChanged(String provider, int status, Bundle extras) {
+                LogUtils.d(TAG, "GPS状态变更 -> 提供者：" + provider + " 状态：" + status);
+            }
+
+            @Override
+            public void onProviderEnabled(String provider) {
+                LogUtils.d(TAG, "GPS提供者已启用：" + provider);
+            }
+
+            @Override
+            public void onProviderDisabled(String provider) {
+                LogUtils.d(TAG, "GPS提供者已禁用：" + provider);
+            }
+        };
+    }
+
+    /**
+     * 处理每次定位刷新｜核心：步长判断 + 基准坐标更新
+     * 新增：同步最新坐标到MainActivity静态变量
+     */
+    private void handleLocationUpdate(Location location) {
+        mGpsLocationCount ++;
+        String locationInfo = "纬度：" + location.getLatitude() + " , 经度：" + location.getLongitude();
+        LogUtils.d(TAG, "定位刷新 -> " + locationInfo);
+
+        //========== 新增关键代码：实时同步最新真实GPS坐标 ==========
+        MainActivity.lastLat = location.getLatitude();
+        MainActivity.lastLng = location.getLongitude();
+        //==========================================================
+
+        //更新前台通知文案
+        updateForegroundNotification(locationInfo);
+
+        //遍历全部订阅者进行推送规则判断
+        Map<String, GpsSubscribeMsg> subscribeAllMap = mSubscribeManager.getSubscribeMap();
+        for (Map.Entry<String, GpsSubscribeMsg> entry : subscribeAllMap.entrySet()) {
+            final String subscribeSid = entry.getKey();
+            final GpsSubscribeMsg subscribeConfig = entry.getValue();
+
+            double currentLat = location.getLatitude();
+            double currentLng = location.getLongitude();
+
+            //判断是否满足推送条件(全订阅/步长阈值)
+            boolean allowPush = mLocationRuleManager.isNeedPush(subscribeSid, currentLat, currentLng);
+            if (allowPush) {
+                //推送成功后刷新该订阅者基准定点坐标
+                mLocationRuleManager.updateSubscriberPoint(subscribeSid, currentLat, currentLng);
+            }
+        }
+    }
+
+    /**
+     * 创建系统通知渠道
+     */
+    private void createSystemNotificationChannel() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            NotificationChannel notificationChannel = new NotificationChannel(
+				CHANNEL_ID,
+				"GPS Relay Service",
+				NotificationManager.IMPORTANCE_LOW
+            );
+            notificationChannel.setDescription("GPSRelaySentinel 后台常驻服务通知");
+            mNotificationManager.createNotificationChannel(notificationChannel);
+        }
+    }
+
+    /**
+     * 开启前台常驻通知
+     */
+    private void startServiceForegroundNotification() {
+        mNotificationBuilder = new NotificationCompat.Builder(this, CHANNEL_ID)
+			.setContentTitle("GPS 中继服务")
+			.setContentText("等待GPS定位数据...")
+			.setSmallIcon(android.R.drawable.ic_menu_mylocation)
+			.setOngoing(true);
+
+        Notification notification = mNotificationBuilder.build();
+        startForeground(NOTIFICATION_ID, notification);
+    }
+
+    /**
+     * 动态更新通知内容
+     */
+    private void updateForegroundNotification(String locationText) {
+        if (mNotificationBuilder != null) {
+            mNotificationBuilder.setContentText(locationText + " | 定位次数：" + mGpsLocationCount);
+            mNotificationManager.notify(NOTIFICATION_ID, mNotificationBuilder.build());
+        }
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        //注销定位监听
+        if (mLocationManager != null && mLocationListener != null) {
+            try {
+                mLocationManager.removeUpdates(mLocationListener);
+            } catch (SecurityException e) {
+                LogUtils.e(TAG, "移除定位监听权限异常：" + e.getMessage());
+            }
+        }
+        mIsRunning = false;
+        LogUtils.d(TAG, "MainService 已销毁，GPS监听已停止");
+    }
+}
+
diff --git a/gpsrelaysentinel/src/main/res/drawable-v24/ic_launcher_foreground.xml b/gpsrelaysentinel/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 0000000..c7bd21d
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1" />
+</vector>
diff --git a/gpsrelaysentinel/src/main/res/drawable/border_gray.xml b/gpsrelaysentinel/src/main/res/drawable/border_gray.xml
new file mode 100644
index 0000000..a8c93bd
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/drawable/border_gray.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android">
+    android:shape="rectangle">
+    <!-- 灰色边框 -->
+    <stroke
+        android:width="1dp"
+        android:color="#555555"/>
+    <!-- 内部深色背景 -->
+    <solid android:color="#222222"/>
+    <!-- 轻微圆角 -->
+    <corners android:radius="4dp"/>
+</shape>
+
diff --git a/gpsrelaysentinel/src/main/res/drawable/ic_launcher_background.xml b/gpsrelaysentinel/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..d5fccc5
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>
diff --git a/gpsrelaysentinel/src/main/res/layout/activity_about.xml b/gpsrelaysentinel/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..bfd895f
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/layout/activity_about.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:orientation="vertical">
+
+        <com.google.android.material.appbar.AppBarLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+
+            <androidx.appcompat.widget.Toolbar
+                android:id="@+id/toolbar"
+                android:layout_width="match_parent"
+                android:layout_height="?attr/actionBarSize"
+                app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+        </com.google.android.material.appbar.AppBarLayout>
+
+        <cc.winboll.studio.libappbase.views.AboutView
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:id="@+id/aboutview"/>
+
+    </LinearLayout>
+
+</FrameLayout>
diff --git a/gpsrelaysentinel/src/main/res/layout/activity_main.xml b/gpsrelaysentinel/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..4e9f9bc
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/layout/activity_main.xml
@@ -0,0 +1,198 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical"
+	android:background="#1c1c1c">
+
+	<com.google.android.material.appbar.AppBarLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">
+
+		<androidx.appcompat.widget.Toolbar
+			android:id="@+id/toolbar"
+			android:layout_width="match_parent"
+			android:layout_height="?attr/actionBarSize"
+			app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
+
+	</com.google.android.material.appbar.AppBarLayout>
+
+	<!-- 数据面板容器 -->
+	<LinearLayout
+		android:id="@+id/container_data_panel"
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_horizontal">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="GPSRelaySentinel"
+			android:textColor="#888888"
+			android:padding="6dp"
+			android:background="@drawable/border_gray"
+			android:textAppearance="?android:attr/textAppearanceLarge"/>
+
+		<LinearLayout
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:orientation="horizontal"
+			android:gravity="center_vertical"
+			android:layout_marginTop="8dp"
+			android:spacing="12dp">
+
+			<CheckBox
+				android:id="@+id/checkbox_sim_mode"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="模拟模式"
+				android:textColor="#999999"
+				android:padding="4dp"
+				android:background="@drawable/border_gray"
+				android:textSize="11sp"/>
+
+			<Switch
+				android:id="@+id/switch_service"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="GPS Service"
+				android:textColor="#999999"
+				android:padding="4dp"
+				android:background="@drawable/border_gray"
+				android:checked="false"/>
+
+			<Button
+				android:id="@+id/btn_send_last_gps"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="发送最后GPS"
+				android:textColor="#bbbbbb"
+				android:background="@drawable/border_gray"
+				android:textSize="12sp"/>
+
+		</LinearLayout>
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:layout_marginTop="16dp"
+			android:padding="12dp"
+			android:background="@drawable/border_gray">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="模拟移动GPS发送面板"
+				android:textColor="#999999"
+				android:textSize="12sp"/>
+
+			<LinearLayout
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:orientation="horizontal"
+				android:layout_marginTop="8dp"
+				android:spacing="8dp">
+
+				<Spinner
+					android:id="@+id/spin_direction"
+					android:layout_width="0dp"
+					android:layout_height="wrap_content"
+					android:layout_weight="1"
+					android:background="@drawable/border_gray"/>
+
+				<EditText
+					android:id="@+id/et_sim_distance"
+					android:layout_width="0dp"
+					android:layout_height="wrap_content"
+					android:layout_weight="1"
+					android:hint="移动距离(米)"
+					android:inputType="numberDecimal"
+					android:text="10"
+					android:background="@drawable/border_gray"
+					android:textColor="#aaaaaa"
+					android:textColorHint="#666666"/>
+
+			</LinearLayout>
+
+			<TextView
+				android:id="@+id/tv_target_point_preview"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="目标坐标：等待计算..."
+				android:textColor="#999999"
+				android:background="@drawable/border_gray"
+				android:padding="6dp"
+				android:textSize="11sp"
+				android:layout_marginTop="8dp"/>
+
+			<Button
+				android:id="@+id/btn_sim_send_gps"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="发送模拟移动GPS"
+				android:textColor="#bbbbbb"
+				android:background="@drawable/border_gray"
+				android:layout_marginTop="10dp"/>
+
+		</LinearLayout>
+		
+	</LinearLayout>
+
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<!-- 订阅面板容器 -->
+		<LinearLayout
+			android:id="@+id/container_subscribe_panel"
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center_horizontal"
+			android:padding="12dp">
+
+			<cc.winboll.studio.libgpsrelaysentinel.view.GpsSubscribeControlView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_marginTop="10dp"
+				android:background="@drawable/border_gray"/>
+
+			<cc.winboll.studio.libgpsrelaysentinel.view.GpsSubscribeControlView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_marginTop="10dp"
+				android:background="@drawable/border_gray"/>
+
+			<cc.winboll.studio.libgpsrelaysentinel.view.GpsSubscribeControlView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_marginTop="10dp"
+				android:background="@drawable/border_gray"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="200dp"
+		android:orientation="vertical"
+		android:id="@+id/container_log_show"
+		android:background="@drawable/border_gray">
+
+		<cc.winboll.studio.libappbase.LogView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/logview"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/gpsrelaysentinel/src/main/res/layout/spinner_item_gray.xml b/gpsrelaysentinel/src/main/res/layout/spinner_item_gray.xml
new file mode 100644
index 0000000..82e0eeb
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/layout/spinner_item_gray.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<TextView xmlns:android="http://schemas.android.com/apk/res/android"
+    android:id="@android:id/text1"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:padding="8dp"
+    android:textColor="#999999"
+    android:gravity="center_vertical"/>
+
diff --git a/gpsrelaysentinel/src/main/res/menu/menu_main.xml b/gpsrelaysentinel/src/main/res/menu/menu_main.xml
new file mode 100644
index 0000000..3ee4332
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/menu/menu_main.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+      xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/action_about"
+        android:title="About"
+        android:icon="@android:drawable/ic_menu_info_details"
+        app:showAsAction="ifRoom"/>
+</menu>
diff --git a/gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/gpsrelaysentinel/src/main/res/mipmap-hdpi/ic_launcher.png b/gpsrelaysentinel/src/main/res/mipmap-hdpi/ic_launcher.png
new file mode 100644
index 0000000..a2f5908
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-hdpi/ic_launcher.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-hdpi/ic_launcher_round.png b/gpsrelaysentinel/src/main/res/mipmap-hdpi/ic_launcher_round.png
new file mode 100644
index 0000000..1b52399
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-hdpi/ic_launcher_round.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-mdpi/ic_launcher.png b/gpsrelaysentinel/src/main/res/mipmap-mdpi/ic_launcher.png
new file mode 100644
index 0000000..ff10afd
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-mdpi/ic_launcher.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-mdpi/ic_launcher_round.png b/gpsrelaysentinel/src/main/res/mipmap-mdpi/ic_launcher_round.png
new file mode 100644
index 0000000..115a4c7
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-mdpi/ic_launcher_round.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-xhdpi/ic_launcher.png b/gpsrelaysentinel/src/main/res/mipmap-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..dcd3cd8
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-xhdpi/ic_launcher.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-xhdpi/ic_launcher_round.png b/gpsrelaysentinel/src/main/res/mipmap-xhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..459ca60
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-xhdpi/ic_launcher_round.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-xxhdpi/ic_launcher.png b/gpsrelaysentinel/src/main/res/mipmap-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..8ca12fe
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-xxhdpi/ic_launcher.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-xxhdpi/ic_launcher_round.png b/gpsrelaysentinel/src/main/res/mipmap-xxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..8e19b41
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-xxhdpi/ic_launcher_round.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/gpsrelaysentinel/src/main/res/mipmap-xxxhdpi/ic_launcher.png
new file mode 100644
index 0000000..b824ebd
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ
diff --git a/gpsrelaysentinel/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png b/gpsrelaysentinel/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..4c19a13
Binary files /dev/null and b/gpsrelaysentinel/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png differ
diff --git a/gpsrelaysentinel/src/main/res/values/arrays.xml b/gpsrelaysentinel/src/main/res/values/arrays.xml
new file mode 100644
index 0000000..6d40162
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/values/arrays.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string-array name="direction_list">
+        <item>正北</item>
+        <item>正南</item>
+        <item>正东</item>
+        <item>正西</item>
+        <item>东北</item>
+        <item>西北</item>
+        <item>东南</item>
+        <item>西南</item>
+    </string-array>
+</resources>
+
diff --git a/gpsrelaysentinel/src/main/res/values/colors.xml b/gpsrelaysentinel/src/main/res/values/colors.xml
new file mode 100644
index 0000000..479769a
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/values/colors.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#009688</color>
+    <color name="colorPrimaryDark">#00796B</color>
+    <color name="colorAccent">#FF9800</color>
+</resources>
\ No newline at end of file
diff --git a/gpsrelaysentinel/src/main/res/values/strings.xml b/gpsrelaysentinel/src/main/res/values/strings.xml
new file mode 100644
index 0000000..3d0aaa4
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/values/strings.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+	
+    <string name="app_name">GPSRelaySentinel</string>
+    <string name="app_description">A GPS relay tool supporting real and simulated positioning, running in background for location forwarding, debugging and simulation.</string>
+
+</resources>
diff --git a/gpsrelaysentinel/src/main/res/values/styles.xml b/gpsrelaysentinel/src/main/res/values/styles.xml
new file mode 100644
index 0000000..a70e242
--- /dev/null
+++ b/gpsrelaysentinel/src/main/res/values/styles.xml
@@ -0,0 +1,11 @@
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="MyAppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+</resources>
diff --git a/gpsrelaysentinel/src/stage/AndroidManifest.xml b/gpsrelaysentinel/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/gpsrelaysentinel/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/gpsrelaysentinel/src/stage/res/values/strings.xml b/gpsrelaysentinel/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/gpsrelaysentinel/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/gradle.properties-android-demo b/gradle.properties-android-demo
new file mode 100644
index 0000000..cb39be8
--- /dev/null
+++ b/gradle.properties-android-demo
@@ -0,0 +1,21 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx2048m
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app"s APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=false
+# Automatically convert third-party libraries to use AndroidX
+android.enableJetifier=false
+# 保持与旧版Gradle插件的兼容
+android.disableAutomaticComponentCreation=true
diff --git a/gradle.properties-androidx-demo b/gradle.properties-androidx-demo
new file mode 100644
index 0000000..74b1f76
--- /dev/null
+++ b/gradle.properties-androidx-demo
@@ -0,0 +1,21 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx2048m
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app"s APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=true
+# Automatically convert third-party libraries to use AndroidX
+android.enableJetifier=true
+# 保持与旧版Gradle插件的兼容
+android.disableAutomaticComponentCreation=true
diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 0000000..7454180
Binary files /dev/null and b/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 0000000..3124347
--- /dev/null
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl = https\://services.gradle.org/distributions/gradle-7.5.1-all.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/gradlew b/gradlew
new file mode 100644
index 0000000..744e882
--- /dev/null
+++ b/gradlew
@@ -0,0 +1,185 @@
+#!/usr/bin/env sh
+
+#
+# Copyright 2015 the original author or authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MSYS* | MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=`expr $i + 1`
+    done
+    case $i in
+        0) set -- ;;
+        1) set -- "$args0" ;;
+        2) set -- "$args0" "$args1" ;;
+        3) set -- "$args0" "$args1" "$args2" ;;
+        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=`save "$@"`
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+exec "$JAVACMD" "$@"
diff --git a/libaes/.gitignore b/libaes/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/libaes/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/libaes/build.gradle b/libaes/build.gradle
new file mode 100644
index 0000000..d6c3ad4
--- /dev/null
+++ b/libaes/build.gradle
@@ -0,0 +1,69 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        minSdkVersion 26
+        targetSdkVersion 30
+    }
+	
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+	
+    // 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+}
+
+dependencies {
+    // 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    // 拼音搜索
+    // https://mvnrepository.com/artifact/com.github.open-android/pinyin4j
+    api 'com.github.open-android:pinyin4j:2.5.0'
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+    // 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+    // AndroidX 类库
+    api 'androidx.appcompat:appcompat:1.1.0'
+    //api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+    api 'cc.winboll.studio:libappbase:15.20.9'
+	// 备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.3'
+	
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/libaes/build.properties b/libaes/build.properties
new file mode 100644
index 0000000..8f4366b
--- /dev/null
+++ b/libaes/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Tue May 12 13:11:09 HKT 2026
+stageCount=4
+libraryProject=libaes
+baseVersion=15.20
+publishVersion=15.20.3
+buildCount=0
+baseBetaVersion=15.20.4
diff --git a/libaes/libs/colorpicker-20180319.jar b/libaes/libs/colorpicker-20180319.jar
new file mode 100644
index 0000000..b010a12
Binary files /dev/null and b/libaes/libs/colorpicker-20180319.jar differ
diff --git a/libaes/proguard-rules.pro b/libaes/proguard-rules.pro
new file mode 100644
index 0000000..536058a
--- /dev/null
+++ b/libaes/proguard-rules.pro
@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:/tools/adt-bundle-windows-x86_64-20131030/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
diff --git a/libaes/src/main/AndroidManifest.xml b/libaes/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..d4325dc
--- /dev/null
+++ b/libaes/src/main/AndroidManifest.xml
@@ -0,0 +1,57 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    package="cc.winboll.studio.libaes">
+	
+	<uses-permission android:name="android.permission.CAMERA" />
+	<uses-feature android:name="android.hardware.camera" android:required="true" />
+
+    <application
+        android:networkSecurityConfig="@xml/network_security_config"
+        android:usesCleartextTraffic="true"
+        tools:ignore="GoogleAppIndexingWarning">
+
+        <activity
+            android:name="cc.winboll.studio.libaes.unittests.SecondaryLibraryActivity"
+            android:exported="true"/>
+
+        <activity
+            android:name="cc.winboll.studio.libaes.unittests.TestDrawerFragmentActivity"
+            android:exported="true"/>
+
+        <activity
+            android:name="cc.winboll.studio.libaes.unittests.TestAToolbarActivity"
+            android:exported="true"/>
+
+        <activity
+            android:name="cc.winboll.studio.libaes.unittests.TestASupportToolbarActivity"
+            android:exported="true"/>
+
+        <service
+            android:name="cc.winboll.studio.libaes.winboll.WinBoLLClientService"
+            android:exported="true"/>
+
+        <service
+            android:name="cc.winboll.studio.libaes.winboll.AssistantService"
+            android:exported="true"/>
+
+        <service
+            android:name="cc.winboll.studio.libaes.winboll.WinBoLLMail"
+            android:exported="true"/>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+
+    </application>
+
+</manifest>
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/DrawerMenuDataAdapter.java b/libaes/src/main/java/cc/winboll/studio/libaes/DrawerMenuDataAdapter.java
new file mode 100644
index 0000000..a9e7bf6
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/DrawerMenuDataAdapter.java
@@ -0,0 +1,207 @@
+package cc.winboll.studio.libaes;
+
+import android.content.Context;
+import android.util.SparseArray;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.BaseAdapter;
+import android.widget.ImageView;
+import android.widget.TextView;
+import java.util.ArrayList;
+
+public abstract class DrawerMenuDataAdapter<T> extends BaseAdapter {
+
+    private ArrayList<T> mData;
+    private int mLayoutResource;           //布局id
+
+
+    public DrawerMenuDataAdapter() {
+    }
+
+    public DrawerMenuDataAdapter(ArrayList<T> mData, int mLayoutRes) {
+        this.mData = mData;
+        this.mLayoutResource = mLayoutRes;
+    }
+
+    @Override
+    public int getCount() {
+        return mData != null ? mData.size() : 0;
+    }
+
+    @Override
+    public T getItem(int position) {
+        return mData.get(position);
+    }
+
+    @Override
+    public long getItemId(int position) {
+        return position;
+    }
+
+    @Override
+    public View getView(int position, View convertView, ViewGroup parent) {
+        ViewHolder viewHolder = ViewHolder.bind(parent.getContext(), convertView, parent, mLayoutResource
+                                                , position);
+        bindView(viewHolder, getItem(position));
+        return viewHolder.getItemView();
+    }
+
+    public abstract void bindView(ViewHolder holder, T obj);
+
+    // 添加数据项
+    //
+    public void add(T item) {
+        if (mData == null) {
+            mData = new ArrayList<>();
+        }
+        mData.add(item);
+        notifyDataSetChanged();
+    }
+
+    // 添加数据项在指定位置
+    //
+    public void add(int position, T item) {
+        if (mData == null) {
+            mData = new ArrayList<>();
+        }
+        mData.add(position, item);
+        notifyDataSetChanged();
+    }
+
+    // 删除数据项
+    //
+    public void remove(T item) {
+        if (mData != null) {
+            mData.remove(item);
+        }
+        notifyDataSetChanged();
+    }
+
+    // 删除指定位置数据项
+    //
+    public void remove(int position) {
+        if (mData != null) {
+            mData.remove(position);
+        }
+        notifyDataSetChanged();
+    }
+
+    // 清理所有数据项
+    //
+    public void clear() {
+        if (mData != null) {
+            mData.clear();
+        }
+        notifyDataSetChanged();
+    }
+
+
+    public static class ViewHolder {
+
+        // 存储在 ListView 的 item 中的 View
+        SparseArray<View> mSparseArrayView;
+        // 存放convertView
+        View mViewItem;
+        // 游标
+        int mnPosition;
+        Context mContext;      
+
+        //构造方法
+        //
+        private ViewHolder(Context context, ViewGroup parent, int layoutResource) {
+            mSparseArrayView = new SparseArray<>();
+            this.mContext = context;
+            View convertView = LayoutInflater.from(context).inflate(layoutResource, parent, false);
+            convertView.setTag(this);
+            mViewItem = convertView;
+        }
+
+        //绑定 ViewHolder 与数据项
+        //
+        public static ViewHolder bind(Context context, View convertView, ViewGroup parent,
+                                      int layoutResource, int position) {
+            ViewHolder viewHolder;
+            if (convertView == null) {
+                viewHolder = new ViewHolder(context, parent, layoutResource);
+            } else {
+                viewHolder = (ViewHolder) convertView.getTag();
+                viewHolder.mViewItem = convertView;
+            }
+            viewHolder.mnPosition = position;
+            return viewHolder;
+        }
+
+        @SuppressWarnings("unchecked")
+        public <T extends View> T getView(int id) {
+            T t = (T) mSparseArrayView.get(id);
+            if (t == null) {
+                t = (T) mViewItem.findViewById(id);
+                mSparseArrayView.put(id, t);
+            }
+            return t;
+        }
+
+
+
+        // 获取当前条目
+        //
+        public View getItemView() {
+            return mViewItem;
+        }
+
+
+        // 获取条目位置
+        //
+        public int getItemPosition() {
+            return mnPosition;
+        }
+
+
+        // 设置文字
+        //
+        public ViewHolder setText(int id, CharSequence text) {
+            View view = getView(id);
+            if (view instanceof TextView) {
+                ((TextView) view).setText(text);
+            }
+            return this;
+        }
+
+
+        // 设置图片
+        //
+        public ViewHolder setImageResource(int id, int drawableResource) {
+            View view = getView(id);
+            if (view instanceof ImageView) {
+                ((ImageView) view).setImageResource(drawableResource);
+            } else {
+                view.setBackgroundResource(drawableResource);
+            }
+            return this;
+        }
+
+        // 设置点击监听
+        //
+        public ViewHolder setOnClickListener(int id, View.OnClickListener listener) {
+            getView(id).setOnClickListener(listener);
+            return this;
+        }
+
+        // 设置可见
+        //
+        public ViewHolder setVisibility(int id, int visible) {
+            getView(id).setVisibility(visible);
+            return this;
+        }
+
+        // 设置标签
+        //
+        public ViewHolder setTag(int id, Object obj) {
+            getView(id).setTag(obj);
+            return this;
+        }
+
+    }
+
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/ImagePagerAdapter.java b/libaes/src/main/java/cc/winboll/studio/libaes/ImagePagerAdapter.java
new file mode 100644
index 0000000..488eb8f
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/ImagePagerAdapter.java
@@ -0,0 +1,75 @@
+package cc.winboll.studio.libaes;
+
+import android.view.View;
+import android.view.ViewGroup;
+import androidx.viewpager.widget.PagerAdapter;
+import java.util.List;
+
+public class ImagePagerAdapter extends PagerAdapter {
+
+    /*
+     * 四个必须重写的方法，否则会报错
+     *
+     */
+
+    private List<View> views;
+
+    //构造方法，拿到views
+    public ImagePagerAdapter(List<View> views) {
+        this.views = views;
+    }
+
+    //以下四个是重写的方法
+    // 获取要滑动的控件的数量，在这里我们以滑动的广告栏为例，那么这里就应该是展示的广告图片的ImageView数量
+    @Override
+    public int getCount() {
+        // TODO Auto-generated method stub
+        return this.views.size();
+    }
+
+
+    // 来判断显示的是否是同一张图片，这里我们将两个参数相比较返回即可
+    @Override
+    public boolean isViewFromObject(View arg0, Object arg1) {
+        // TODO Auto-generated method stub
+        return arg0 == arg1;
+    }
+
+
+    /**
+     * position是在viewPager中显示图片的下标
+     * 把对应的图片放到对应的位置就好了
+     * instantiateItem和destroyItem是对应的
+     * 一个是创建item，一个是销毁item
+     *      当要显示的图片可以进行缓存的时候，会调用instantiateItem（）进行显示图片的初始化，
+     *     我们将要显示的ImageView加入到ViewGroup中，然后作为返回值返回即可
+     *
+     *     ViewPager 是扩展于 ViewGroup，container参数是当前的ViewPager对象，
+     *     所有的item都会被加入到ViewPager中，
+     *     position就是 每个item对应的下标
+     */
+    @Override
+    public Object instantiateItem(ViewGroup container, int position) {
+        container.addView(views.get(position));
+        return views.get(position);
+    }
+
+    //如果出现IllegalStateException: The specified child already has a parent. 这样的错误：则可替换为以下的try catch 代码
+    /*try{
+     　　　　if(views.get(position).getParent()==null){
+     　             container.addView(views.get(position));
+     　　　　}else{
+     ((ViewGroup)views.get(position).getParent()).removeView(views.get(position));
+     container.addView(views.get(position));
+     }
+     }catch(Exception e){
+     e.printStackTrace();
+     }*/
+
+    // PagerAdapter只缓存5张要显示的图片，如果滑动的图片超出了缓存的范围，就会调用destroyItem（），将图片销毁
+    @Override
+    public void destroyItem(ViewGroup container, int position, Object object) {
+        container.removeView(views.get(position));
+    }
+}
+
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/activitys/DrawerFragmentActivity.java b/libaes/src/main/java/cc/winboll/studio/libaes/activitys/DrawerFragmentActivity.java
new file mode 100644
index 0000000..97610a3
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/activitys/DrawerFragmentActivity.java
@@ -0,0 +1,394 @@
+package cc.winboll.studio.libaes.activitys;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/13 18:58:54
+ * @Describe 可以加入Fragment的有抽屉的活动窗口抽象类
+ */
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.content.SharedPreferences;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuInflater;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.AdapterView;
+import androidx.appcompat.app.ActionBarDrawerToggle;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import androidx.drawerlayout.widget.DrawerLayout;
+import androidx.fragment.app.Fragment;
+import androidx.fragment.app.FragmentManager;
+import androidx.fragment.app.FragmentTransaction;
+import cc.winboll.studio.libaes.DrawerMenuDataAdapter;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.models.DrawerMenuBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.DevelopUtils;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libaes.views.ADrawerMenuListView;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import com.baoyz.widget.PullRefreshLayout;
+import java.util.ArrayList;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+
+public abstract class DrawerFragmentActivity extends AppCompatActivity implements IWinBoLLActivity, AdapterView.OnItemClickListener {
+
+    public static final String TAG = "DrawerFragmentActivity";
+
+    static final String SHAREDPREFERENCES_NAME = "SHAREDPREFERENCES_NAME";
+    static final String DRAWER_THEME_TYPE = "DRAWER_THEME_TYPE";
+
+    //protected Context mContext;
+    ActivityType mActivityType;
+    ActionBarDrawerToggle mActionBarDrawerToggle;
+    DrawerLayout mDrawerLayout;
+    PullRefreshLayout mPullRefreshLayout;
+    ADrawerMenuListView mADrawerMenuListView;
+    DrawerMenuDataAdapter mDrawerMenuDataAdapter;
+    boolean mIsDrawerOpened = false;
+    boolean mIsDrawerOpening = false;
+    boolean mIsDrawerClosing = false;
+
+    protected Toolbar mToolbar;
+    public enum ActivityType { Main, Secondary }
+    protected volatile AESThemeBean.ThemeType mThemeType;
+    protected ArrayList<DrawerMenuBean> malDrawerMenuItem;
+    abstract protected ActivityType initActivityType();
+    //abstract protected View initContentView(LayoutInflater inflater, ViewGroup rootView);
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        mThemeType = AESThemeBean.getThemeStyleType(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        setTheme(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+        super.onCreate(savedInstanceState);
+        WinBoLLActivityManager.getInstance().add(this);
+        mActivityType = initActivityType();
+        initRootView();
+        LogUtils.d(TAG, "onCreate end.");
+    }
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onDestroy() {
+		WinBoLLActivityManager.getInstance().registeRemove(this);
+        super.onDestroy();
+		// 修复：释放广告资源，避免内存泄漏
+		ADsBannerView adsBannerView = findViewById(R.id.adsbanner);
+		if (adsBannerView != null) {
+			adsBannerView.releaseAdResources();
+		}
+    }
+
+    /*@Override
+	 public Intent getIntent() {
+	 // TODO: Implement this method
+	 return super.getIntent();
+	 }
+
+	 public Context getContext() {
+	 return this.mContext;
+	 }*/
+
+    @Override
+    public MenuInflater getMenuInflater() {
+        // TODO: Implement this method
+        return super.getMenuInflater();
+    }
+
+    /*public void setSubtitle(CharSequence context) {
+	 // TODO: Implement this method
+	 getSupportActionBar().setSubtitle(context);
+	 }*/
+
+    @Override
+    public void recreate() {
+        super.recreate();
+    }
+
+    /*@Override
+	 public boolean moveTaskToBack(boolean nonRoot) {
+	 return super.moveTaskToBack(nonRoot);
+	 }*/
+
+    @Override
+    public void startActivity(Intent intent) {
+        super.startActivity(intent);
+    }
+
+    @Override
+    public void startActivityForResult(Intent intent, int requestCode, Bundle options) {
+        super.startActivityForResult(intent, requestCode, options);
+    }
+
+    /*@Override
+	 public FragmentManager getSupportFragmentManager() {
+	 return super.getSupportFragmentManager();
+	 }
+
+	 public void setSubtitle(int resId) {
+	 // TODO: Implement this method
+	 getSupportActionBar().setSubtitle(resId);
+	 }
+
+	 public void setTitle(CharSequence context) {
+	 // TODO: Implement this method
+	 getSupportActionBar().setTitle(context);
+	 }
+
+	 public void setTitle(int resId) {
+	 // TODO: Implement this method
+	 getSupportActionBar().setTitle(resId);
+	 }*/
+
+    @Override
+    public SharedPreferences getSharedPreferences(String name, int mode) {
+        return super.getSharedPreferences(name, mode);
+    }
+
+    @Override
+    public Context getApplicationContext() {
+        // TODO: Implement this method
+        return super.getApplicationContext();
+    }
+
+    @Override
+    public void onBackPressed() {
+        super.onBackPressed();
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (AESThemeUtil.onAppThemeItemSelected(this, item)) {
+            recreate();
+        } if (DevelopUtils.onDevelopItemSelected(this, item)) {
+			LogUtils.d(TAG, String.format("onOptionsItemSelected item.getItemId() %d ", item.getItemId()));
+		} else {
+			return super.onOptionsItemSelected(item);
+		}
+
+		return true;
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+
+		ADsBannerView adsBannerView = findViewById(R.id.adsbanner);
+		if (adsBannerView != null) {
+			adsBannerView.resumeADs(DrawerFragmentActivity.this);
+		}
+    }
+
+    void initRootView() {
+        setContentView(R.layout.activity_drawerfragment);
+
+        mToolbar = findViewById(R.id.activitydrawerfragmentASupportToolbar1);
+        setSupportActionBar(mToolbar);
+
+        if (mActivityType == ActivityType.Main) {
+            initMainRootView();
+        } else if (mActivityType == ActivityType.Secondary) {
+            initSecondaryRootView();
+        }
+    }
+
+    void initMainRootView() {
+        mDrawerLayout = findViewById(R.id.activitydrawerfragmentDrawerLayout1);
+        mADrawerMenuListView = findViewById(R.id.activitydrawerfragmentDrawerMenuListView1);
+        mPullRefreshLayout = findViewById(R.id.activitydrawerfragmentPullRefreshLayout1);
+
+        mPullRefreshLayout.setOnRefreshListener(new PullRefreshLayout.OnRefreshListener() {
+                @Override
+                public void onRefresh() {
+                    //LogUtils.d(TAG, "onRefresh");
+                    reinitDrawerMenuItemList(malDrawerMenuItem);
+                    mDrawerMenuDataAdapter.notifyDataSetChanged();
+                    mPullRefreshLayout.setRefreshing(false);
+                }
+            });
+
+        malDrawerMenuItem = new ArrayList<DrawerMenuBean>();
+
+        mDrawerMenuDataAdapter = new DrawerMenuDataAdapter<DrawerMenuBean>(malDrawerMenuItem, R.layout.listview_drawermenu) {
+            @Override
+            public void bindView(ViewHolder holder, DrawerMenuBean obj) {
+                holder.setImageResource(R.id.listviewdrawermenuImageView1, obj.getIconId());
+                holder.setText(R.id.listviewdrawermenuTextView1, obj.getIconName());
+            }
+        };
+        mADrawerMenuListView.setAdapter(mDrawerMenuDataAdapter);
+        mADrawerMenuListView.setOnItemClickListener(this);
+
+        mActionBarDrawerToggle = new ActionBarDrawerToggle(this, mDrawerLayout, mToolbar, R.string.lib_name, R.string.lib_name) {
+            @Override
+            public void onDrawerOpened(View drawerView) {//完全打开时触发
+                super.onDrawerOpened(drawerView);
+                mIsDrawerOpened = true;
+                mIsDrawerOpening = false;
+                //Toast.makeText(MainActivity.this,"onDrawerOpened",Toast.LENGTH_SHORT).show();
+            }
+
+            @Override
+            public void onDrawerClosed(View drawerView) {//完全关闭时触发
+                super.onDrawerClosed(drawerView);
+                mIsDrawerOpened = false;
+                mIsDrawerClosing = false;
+                //Toast.makeText(MainActivity.this,"onDrawerClosed",Toast.LENGTH_SHORT).show();
+            }
+
+            /** 
+             * 当抽屉被滑动的时候调用此方法 
+             * slideOffset表示 滑动的幅度（0-1） 
+             */  
+            @Override
+            public void onDrawerSlide(View drawerView, float slideOffset) {
+                super.onDrawerSlide(drawerView, slideOffset);
+            }
+
+            /** 
+             * 当抽屉滑动状态改变的时候被调用 
+             * 状态值是STATE_IDLE（闲置--0）, STATE_DRAGGING（拖拽的--1）, STATE_SETTLING（固定--2）中之一。 
+             *具体状态可以慢慢调试
+             */  
+            @Override
+            public void onDrawerStateChanged(int newState) {
+                super.onDrawerStateChanged(newState);
+            }
+        };
+
+        //设置显示旋转菜单
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        //通过下面这句实现toolbar和Drawer的联动：如果没有这行代码，箭头是不会随着侧滑菜单的开关而变换的（或者没有箭头），
+        // 可以尝试一下，不影响正常侧滑
+        mActionBarDrawerToggle.syncState();
+        mDrawerLayout.setDrawerListener(mActionBarDrawerToggle);
+
+        //去掉侧滑的默认图标（动画箭头图标），也可以选择不去，
+        //不去的话把这一行注释掉或者改成true，然后把toolbar.setNavigationIcon注释掉就行了
+        //mActionBarDrawerToggle.setDrawerIndicatorEnabled(false);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View v) {
+                    if (mIsDrawerOpened || mIsDrawerOpening) {
+                        mIsDrawerClosing = true;
+                        mIsDrawerOpening = false;
+                        mDrawerLayout.closeDrawer(mPullRefreshLayout);
+                        return;
+                    } 
+                    if (!mIsDrawerOpened || mIsDrawerClosing) {
+                        mIsDrawerOpening = true;
+                        mIsDrawerClosing = false;
+                        mDrawerLayout.openDrawer(mPullRefreshLayout);
+                        return;
+                    }
+                }
+            });
+
+        initDrawerMenuItemList(malDrawerMenuItem);
+    }
+
+    void initSecondaryRootView() {
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View v) {
+                    //LogUtils.d(TAG, "onClick " + Integer.toString(v.getId()));
+                    finish();
+                }
+            });
+    }
+
+    public <T extends Fragment> int removeFragment(T fragment) {
+        FragmentManager fragmentManager = getSupportFragmentManager();
+        FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
+        fragmentTransaction.remove(fragment);
+        fragmentTransaction.commit();
+        return fragmentManager.getFragments().size() - 1;
+    }
+
+    public <T extends Fragment> int addFragment(T fragment) {
+        FragmentManager fragmentManager = getSupportFragmentManager();
+        FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
+        fragmentTransaction.add(R.id.activitydrawerfragmentFrameLayout1, fragment);
+        fragmentTransaction.commit();
+        return fragmentManager.getFragments().size() - 1;
+    }
+
+    public <T extends Fragment> void showFragment(T fragment) {
+        FragmentManager fragmentManager = getSupportFragmentManager();
+        FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
+        for (int i = 0; i < fragmentManager.getFragments().size(); i++) {
+            if (fragmentManager.getFragments().get(i).equals(fragment)) {
+                fragmentTransaction.show(fragmentManager.getFragments().get(i));
+            } else {
+                fragmentTransaction.hide(fragmentManager.getFragments().get(i));
+            }
+        }
+        fragmentTransaction.commit();
+    }
+
+    public void showFragment(int nPosition) {
+        FragmentManager fragmentManager = getSupportFragmentManager();
+        FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
+        for (int i = 0; i < fragmentManager.getFragments().size(); i++) {
+            if (i == nPosition) {
+                fragmentTransaction.show(fragmentManager.getFragments().get(i));
+            } else {
+                fragmentTransaction.hide(fragmentManager.getFragments().get(i));
+            }
+        }
+        fragmentTransaction.commit();
+    }
+
+    protected void initDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+
+    }
+
+    protected void reinitDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+
+    }
+
+    public void notifyDrawerMenuDataChanged() {
+        mDrawerMenuDataAdapter.notifyDataSetChanged();
+    }
+
+    @Override
+    public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
+        mDrawerLayout.closeDrawer(mPullRefreshLayout);
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        if (mActivityType == ActivityType.Main) {
+			// 主题菜单
+            AESThemeUtil.inflateMenu(this, menu);
+			// 调试工具菜单
+			if (GlobalApplication.isDebugging()) {
+				DevelopUtils.inflateMenu(this, menu);
+			}
+			// 应用信息菜单
+            getMenuInflater().inflate(R.menu.toolbar_drawerbase, menu);
+        }
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    @Override
+    protected void onActivityResult(int who, int targetFragment, Intent requestCode) {
+        super.onActivityResult(who, targetFragment, requestCode);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/LocalFileSelectDialog.java b/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/LocalFileSelectDialog.java
new file mode 100644
index 0000000..c181865
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/LocalFileSelectDialog.java
@@ -0,0 +1,204 @@
+package cc.winboll.studio.libaes.dialogs;
+
+import android.content.Context;
+import android.content.DialogInterface;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.app.AlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.File;
+import java.lang.reflect.Field;
+import java.text.Collator;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+
+public class LocalFileSelectDialog {
+
+    public static final String TAG = LocalFileSelectDialog.class.getSimpleName();
+
+    File mfCurrentPath = new File("/storage/emulated/0");
+    String mszResultPath = "/storage/emulated/0";
+    OKClickListener mOKClickListener;
+
+    Context mContext;
+
+    public LocalFileSelectDialog(Context context) {
+        mContext = context;
+    }
+
+    public void open() {
+        LogUtils.d(TAG, "call open()");
+        String[] szlist = getChildFileList(mfCurrentPath);
+        if (szlist != null) {
+            showSingleChoiceDialog(szlist, 0);
+        }
+    }
+
+    int yourChoice;
+    protected void showSingleChoiceDialog(final String[] szItems, final int nChoice) {
+        LogUtils.d(TAG, "call showSingleChoiceDialog(...)");
+        yourChoice = nChoice;
+        AlertDialog.Builder builder = new AlertDialog.Builder(mContext);   
+        String sz = mfCurrentPath.getPath();
+
+        builder.setTitle(sz);
+        //builder.setCancelable(false);
+        builder.setSingleChoiceItems(szItems, nChoice, 
+            new DialogInterface.OnClickListener() {
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    yourChoice = which;
+                }
+            });
+        // 确定按钮
+        builder.setPositiveButton("确定",
+            new DialogInterface.OnClickListener() {
+
+                @Override
+                public void onClick(
+                    DialogInterface dialog,
+                    int which) {
+                    mszResultPath = mfCurrentPath.getPath() + File.separator + szItems[yourChoice];
+                    //Toast.makeText(mContext, mszResultPath, Toast.LENGTH_SHORT).show();
+                    mOKClickListener.onOKClick(mszResultPath);
+                }
+            });
+        // 下一层文件按钮
+        builder.setNegativeButton(">>>", new DialogInterface.OnClickListener() {
+                public void onClick(DialogInterface dialog, int which) {
+                    File file = new File(mfCurrentPath.getPath() + File.separator + szItems[yourChoice]);
+                    String[] szlist = getChildFileList(file);
+                    if (szlist != null) {
+                        mfCurrentPath = new File(mfCurrentPath.getPath() + File.separator + szItems[yourChoice]);
+
+                        showSingleChoiceDialog(szlist, 0);
+
+                    } else {
+                        Toast.makeText(mContext, "这是一个最低的目录", Toast.LENGTH_SHORT).show();
+                        String[] szlistOld = getChildFileList(mfCurrentPath);
+                        showSingleChoiceDialog(szlistOld, yourChoice);
+                    }
+
+                }
+            });
+        // 上一层文件按钮
+        builder.setNeutralButton("<<<",
+            new DialogInterface.OnClickListener() {// 添加返回按钮
+
+                @Override
+                public void onClick(
+                    DialogInterface dialog,
+                    int which) {// 响应事件
+
+                    String[] szlist = getChildFileList(mfCurrentPath.getParentFile());
+                    if (szlist != null) {
+                        mfCurrentPath = mfCurrentPath.getParentFile();
+
+                        showSingleChoiceDialog(szlist, 0);
+
+                    } else {
+                        Toast.makeText(mContext, "这是一个最高的目录", Toast.LENGTH_SHORT).show();
+                        String[] szlistOld = getChildFileList(mfCurrentPath);
+                        showSingleChoiceDialog(szlistOld, yourChoice);
+                    }
+
+                }
+            });
+        AlertDialog dialog = builder.create();
+        dialog.show();
+
+        // 反射原理修改对话框元素
+        //
+        //需要在show()方法之后才能修改
+        //修改“确认”、“取消”按钮的字体大小
+        //dialog.getButton(AlertDialog.BUTTON_POSITIVE).setTextSize(16);
+        //dialog.getButton(DialogInterface.BUTTON_NEGATIVE).setTextSize(16);
+        //dialog.getButton(DialogInterface.BUTTON_NEUTRAL).setTextSize(16);
+        try {
+            Field mAlert = AlertDialog.class.getDeclaredField("mAlert");
+            mAlert.setAccessible(true);
+            Object mAlertController = mAlert.get(dialog);
+
+            //通过反射修改title字体大小和颜色
+            Field mTitle = mAlertController.getClass().getDeclaredField("mTitleView");
+            mTitle.setAccessible(true);
+            TextView mTitleView = (TextView) mTitle.get(mAlertController);
+            //mTitleView.setTextSize(16);
+            //mTitleView.setTextColor(Color.RED);
+            mTitleView.setSingleLine(false);
+
+            //通过反射修改message字体大小和颜色
+            //Field mMessage = mAlertController.getClass().getDeclaredField("mMessageView");
+            //mMessage.setAccessible(true);
+            //TextView mMessageView = (TextView) mMessage.get(mAlertController);
+            //mMessageView.setTextSize(16);
+            //mMessageView.setTextColor(Color.GREEN);
+        } catch (IllegalAccessException e) {
+            LogUtils.d(TAG, "IllegalAccessException : " + e.getMessage());
+        } catch (NoSuchFieldException e) {
+            LogUtils.d(TAG, "NoSuchFieldException : " + e.getMessage());
+        }
+    }
+
+    public void setOnOKClickListener(OKClickListener listener) {
+        mOKClickListener = listener;
+    }
+
+    public interface OKClickListener {
+        void onOKClick(String szResultPath);
+    }
+
+    // 读取文件夹子目录
+    //
+    // "/storage/emulated/0"以上
+    // 和没有子目录的f参数返回空列表
+    protected String[] getChildFileList(File file) {
+        ArrayList<String> szlistFiles = new ArrayList<String>();
+        if (!file.getPath().equals("/storage/emulated")) {
+            File[] fileList = file.listFiles();
+            if (fileList != null) {
+                for (File fileItem : fileList) {
+                    if (fileItem.getName().charAt(0) != '.') {
+                        if (fileItem.isDirectory()) {
+                            szlistFiles.add(fileItem.getName());
+                        }
+                    }
+                }
+            }
+        }
+        Collections.sort(szlistFiles, new SortChineseName(true)); 
+
+        if (szlistFiles.size() > 0) {
+            return szlistFiles.toArray(new String[szlistFiles.size()]);
+        } else {
+            return null;
+        }
+    }
+
+    private class SortChineseName implements Comparator<String> {
+        private boolean mIsA2Z = true;
+        public SortChineseName(boolean isA2Z) {
+            mIsA2Z = isA2Z;
+        }
+        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
+        @Override
+        public int compare(String o1, String o2) {
+            if (mIsA2Z) {
+                if (cmp.compare(o1, o2) > 0) {
+                    return 1;
+                } else if (cmp.compare(o1, o2) < 0) {
+                    return -1;
+                }
+            } else {
+                if (cmp.compare(o1, o2) > 0) {
+                    return -1;
+                } else if (cmp.compare(o1, o2) < 0) {
+                    return 1;
+                }
+            }
+            return 0;
+        }
+    }
+
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/StoragePathDialog.java b/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/StoragePathDialog.java
new file mode 100644
index 0000000..2870a0f
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/StoragePathDialog.java
@@ -0,0 +1,57 @@
+package cc.winboll.studio.libaes.dialogs;
+
+import android.app.Dialog;
+import android.view.Gravity;
+import android.view.View;
+import android.view.Window;
+import android.view.WindowManager;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.utils.ScreenUtil;
+
+public class StoragePathDialog extends Dialog {
+
+    public static final String TAG = "StoragePathDialog";
+    View.OnClickListener mOnOKClickListener;
+
+    public StoragePathDialog(android.content.Context context) {
+        super(context);
+
+    }
+
+    public StoragePathDialog(android.content.Context context, int themeResId) {
+        super(context, (themeResId == 0) ? cc.winboll.studio.libaes.R.style.NormalDialogStyle: themeResId);
+        // 加载默认布局
+        View view = View.inflate(context, R.layout.dialog_storagepath, null);
+        setContentView(view);
+        // 添加按键点击监听
+        view.findViewById(R.id.dialogstoragepathButton1).setOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View view) {
+                    if (mOnOKClickListener != null) {
+                        mOnOKClickListener.onClick(view);
+                    }
+                }
+            });
+        // 使得点击对话框外部不消失对话框
+        setCanceledOnTouchOutside(false);
+        // 设置对话框大小
+        ScreenUtil.ScreenSize ss = ScreenUtil.getScreenSize(context);
+        view.setMinimumHeight((int) (ss.getHeightPixels() * 0.23f));
+        Window dialogWindow = getWindow();
+        WindowManager.LayoutParams lp = dialogWindow.getAttributes();
+        lp.width = (int) (ss.getWidthPixels() * 0.75f);
+        lp.height = WindowManager.LayoutParams.WRAP_CONTENT;
+        lp.gravity = Gravity.CENTER;
+        dialogWindow.setAttributes(lp);
+
+    }
+
+    protected StoragePathDialog(android.content.Context context, boolean cancelable, android.content.DialogInterface.OnCancelListener cancelListener) {
+        super(context, cancelable, cancelListener);
+    }
+
+    public void setOnOKClickListener(View.OnClickListener listener) {
+        mOnOKClickListener = listener;
+    }
+
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/YesNoAlertDialog.java b/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/YesNoAlertDialog.java
new file mode 100644
index 0000000..f176daa
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/dialogs/YesNoAlertDialog.java
@@ -0,0 +1,60 @@
+package cc.winboll.studio.libaes.dialogs;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/28 17:40:47
+ * @Date 2024/08/12 14:46:25
+ * @Describe 询问用户确定与否的选择框
+ */
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.DialogInterface;
+
+public class YesNoAlertDialog {
+
+    public static final String TAG = "YesNoAlertDialog";
+
+    public static void show(Context context, String szTitle, String szMessage, final OnDialogResultListener listener) {
+        AlertDialog.Builder alertDialogBuilder = new AlertDialog.Builder(
+            context);
+
+        // set title
+        alertDialogBuilder.setTitle(szTitle);
+
+        // set dialog message
+        alertDialogBuilder
+            .setMessage(szMessage)
+            .setCancelable(true)
+            .setOnCancelListener(new DialogInterface.OnCancelListener(){
+                @Override
+                public void onCancel(DialogInterface dialog) {
+                    listener.onNo();
+                }
+            })
+            .setPositiveButton("YES", new DialogInterface.OnClickListener() {
+                public void onClick(DialogInterface dialog, int id) {
+                    // if this button is clicked, close
+                    // current activity
+                    listener.onYes();
+                }
+            })
+            .setNegativeButton("NO", new DialogInterface.OnClickListener() {
+                public void onClick(DialogInterface dialog, int id) {
+                    // if this button is clicked, just close
+                    // the dialog box and do nothing
+                    dialog.cancel();
+                }
+            });
+
+        // create alert dialog
+        AlertDialog alertDialog = alertDialogBuilder.create();
+
+        // show it
+        alertDialog.show();
+    }
+
+    public interface OnDialogResultListener {
+        abstract void onYes();
+        abstract void onNo();
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/enums/ADsMode.java b/libaes/src/main/java/cc/winboll/studio/libaes/enums/ADsMode.java
new file mode 100644
index 0000000..a43743c
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/enums/ADsMode.java
@@ -0,0 +1,32 @@
+package cc.winboll.studio.libaes.enums;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/26 17:49
+ * @Describe 广告控制模式枚举
+ */
+public enum ADsMode {
+    STANDALONE("单机模式"),  // 单机模式（默认）
+    MIMO_SDK("米盟广告SDK支持模式"),  // 米盟广告SDK模式
+    STORE_QRCODE("云宝物语模式");  // 米盟广告SDK模式
+
+    private final String modeName;
+
+    ADsMode(String modeName) {
+        this.modeName = modeName;
+    }
+
+    public String getModeName() {
+        return modeName;
+    }
+
+    // 根据保存的字符串值解析枚举（SP读取时使用）
+    public static ADsMode fromValue(String value) {
+        if (value == null) return STANDALONE;
+        try {
+            return ADsMode.valueOf(value);
+        } catch (IllegalArgumentException e) {
+            return STANDALONE;
+        }
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/enums/PrivacyAgreeStatus.java b/libaes/src/main/java/cc/winboll/studio/libaes/enums/PrivacyAgreeStatus.java
new file mode 100644
index 0000000..fe9e133
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/enums/PrivacyAgreeStatus.java
@@ -0,0 +1,67 @@
+package cc.winboll.studio.libaes.enums;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 12:35
+ * @Describe 隐私协议签约状态枚举
+ * 对应值：0-拒绝，1-赞同，2-未签约（默认）
+ */
+public enum PrivacyAgreeStatus {
+	REJECTED(0, "拒绝"),      // 0: 拒绝隐私协议
+	AGREED(1, "赞同"),        // 1: 赞同隐私协议
+	UN_SIGNED(2, "未签约");   // 2: 未签约（初始默认状态）
+
+	private final int statusCode;  // 对应存储的int值
+	private final String statusDesc; // 状态描述（可选，便于日志/UI显示）
+
+	// Java 7 枚举构造方法（必须private）
+	private PrivacyAgreeStatus(int statusCode, String statusDesc) {
+		this.statusCode = statusCode;
+		this.statusDesc = statusDesc;
+	}
+
+	/**
+	 * 根据int值获取枚举（SP读取时使用，兼容Java 7）
+	 * @param code 存储的int值（0/1/2）
+	 * @return 对应枚举，默认返回UN_SIGNED（未签约）
+	 */
+	public static PrivacyAgreeStatus fromCode(int code) {
+		// Java 7 不支持switch(String)，用if-else兼容
+		if (code == REJECTED.statusCode) {
+			return REJECTED;
+		} else if (code == AGREED.statusCode) {
+			return AGREED;
+		} else {
+			return UN_SIGNED; // 默认未签约
+		}
+	}
+
+	/**
+	 * 根据SP存储的字符串值获取枚举（兼容原逻辑中String类型存储）
+	 * @param codeStr 存储的字符串值（"0"/"1"/"2"）
+	 * @return 对应枚举，默认返回UN_SIGNED（未签约）
+	 */
+	public static PrivacyAgreeStatus fromString(String codeStr) {
+		if (codeStr == null) {
+			return UN_SIGNED;
+		}
+		try {
+			int code = Integer.parseInt(codeStr);
+			return fromCode(code);
+		} catch (NumberFormatException e) {
+			// 字符串格式异常时，默认返回未签约
+			return UN_SIGNED;
+		}
+	}
+
+	// 获取状态码（用于存储到SP）
+	public int getStatusCode() {
+		return statusCode;
+	}
+
+	// 获取状态描述（用于日志/UI显示，可选）
+	public String getStatusDesc() {
+		return statusDesc;
+	}
+}
+
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/interfaces/IWinBoLLActivity.java b/libaes/src/main/java/cc/winboll/studio/libaes/interfaces/IWinBoLLActivity.java
new file mode 100644
index 0000000..9760d2b
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/interfaces/IWinBoLLActivity.java
@@ -0,0 +1,24 @@
+package cc.winboll.studio.libaes.interfaces;
+
+import android.app.Activity;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/05/10 09:34
+ * @Describe WinBoll 窗口操作接口（规范定义，职责单一）
+ */
+public interface IWinBoLLActivity {
+    String TAG = "IWinBoLLActivity";
+    String ACTION_BIND = IWinBoLLActivity.class.getName() + ".ACTION_BIND";
+
+    /**
+     * 获取当前Activity实例
+     */
+    Activity getActivity();
+
+    /**
+     * 获取Activity唯一标识（建议使用类名+UUID或固定唯一字符串）
+     */
+    String getTag();
+}
+
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/models/AESThemeBean.java b/libaes/src/main/java/cc/winboll/studio/libaes/models/AESThemeBean.java
new file mode 100644
index 0000000..dd4d8d8
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/models/AESThemeBean.java
@@ -0,0 +1,143 @@
+package cc.winboll.studio.libaes.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/14 02:42:57
+ * @Describe 主题元素项目类
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class AESThemeBean extends BaseBean {
+
+    public static final String TAG = "AESThemeBean";
+
+    public enum ThemeType {
+        AES("默认主题"),
+        DEPTH("深奥主题"),
+        SKY("天空主题"),
+        GOLDEN("辉煌主题"),
+		BEARING("智芋主题"),
+        MEMOR("梦箩主题"),
+        TAO("黑白主题");
+
+        private String name;
+
+        // 枚举构造函数
+        ThemeType(String name) {
+            this.name = name;
+        }
+
+        // 将字符串转换为枚举
+        public static ThemeType fromString(String themeTypeStr) {
+            return ThemeType.valueOf(themeTypeStr.toUpperCase()); // 注意这里用了toUpperCase()，确保匹配时不区分大小写
+        }
+
+        // 获取枚举的名称
+        public String getName() {
+            return name;
+        }
+    }
+    
+    // 保存当前主题
+    int currentThemeStyleID = getThemeStyleID(ThemeType.AES);
+    
+    public AESThemeBean() {
+    }
+    
+    public AESThemeBean(int currentThemeStyleID) {
+        this.currentThemeStyleID = currentThemeStyleID;
+    }
+
+    public void setCurrentThemeTypeID(int currentThemeTypeID) {
+        this.currentThemeStyleID = currentThemeTypeID;
+    }
+
+    public int getCurrentThemeTypeID() {
+        return this.currentThemeStyleID;
+    }
+    
+    @Override
+    public String getName() {
+        return AESThemeBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        AESThemeBean bean = this;
+        jsonWriter.name("currentThemeTypeID").value(bean.getCurrentThemeTypeID());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if(super.initObjectsFromJsonReader(jsonReader, name)) { return true; }
+        else{
+            if (name.equals("currentThemeTypeID")) {
+                setCurrentThemeTypeID(jsonReader.nextInt());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if(!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+
+    public static int getThemeStyleID(ThemeType themeType) {
+        int themeStyleID = R.style.AESTheme;
+        if (AESThemeBean.ThemeType.DEPTH == themeType) {
+            themeStyleID = R.style.DepthAESTheme;
+        } else if (AESThemeBean.ThemeType.SKY == themeType) {
+            themeStyleID = R.style.SkyAESTheme;
+        } else if (AESThemeBean.ThemeType.GOLDEN == themeType) {
+            themeStyleID = R.style.GoldenAESTheme;
+        } else if (AESThemeBean.ThemeType.BEARING == themeType) {
+            themeStyleID = R.style.BearingAESTheme;
+        } else if (AESThemeBean.ThemeType.MEMOR == themeType) {
+            themeStyleID = R.style.MemorAESTheme;
+        } else if (AESThemeBean.ThemeType.TAO == themeType) {
+            themeStyleID = R.style.TaoAESTheme;
+        } else if (AESThemeBean.ThemeType.AES == themeType) {
+            themeStyleID = R.style.AESTheme;
+        }
+        //LogUtils.d(TAG, "themeStyleID " + Integer.toString(themeStyleID));
+        return themeStyleID;
+    }
+
+    public static AESThemeBean.ThemeType getThemeStyleType(int nThemeStyleID) {
+        AESThemeBean.ThemeType themeStyle = AESThemeBean.ThemeType.AES;
+        if (R.style.DepthAESTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.DEPTH ;
+        } else if (R.style.SkyAESTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.SKY ;
+        } else if (R.style.GoldenAESTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.GOLDEN ;
+        } else if (R.style.BearingAESTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.BEARING ;
+        } else if (R.style.MemorAESTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.MEMOR ;
+        } else if (R.style.TaoAESTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.TAO ;
+        } else if (R.style.AESTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.AES;
+        }
+        //LogUtils.d(TAG, "themeStyle " + Integer.toString(themeStyle.ordinal()));
+        return themeStyle;
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/models/APPInfo.java b/libaes/src/main/java/cc/winboll/studio/libaes/models/APPInfo.java
new file mode 100644
index 0000000..cf097e0
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/models/APPInfo.java
@@ -0,0 +1,169 @@
+package cc.winboll.studio.libaes.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/01/20 14:19:02
+ * @Describe 应用信息类
+ */
+import cc.winboll.studio.libaes.R;
+import java.io.Serializable;
+
+public class APPInfo implements Serializable {
+
+    public static final String TAG = "APPInfo";
+
+    // 应用名称
+    String appName;
+    // 应用图标
+    int appIcon;
+    // 应用描述
+    String appDescription;
+    // 应用Git仓库地址
+    String appGitName;
+    // 应用Git仓库拥有者
+    String appGitOwner;
+    // 应用Git仓库分支
+    String appGitAPPBranch;
+    // 应用Git仓库子项目文件夹
+    String appGitAPPSubProjectFolder;
+    // 应用主页
+    String appHomePage;
+    // 应用包名称
+    String appAPKName;
+    // 应用包存储文件夹名称
+    String appAPKFolderName;
+    // 是否添加调试工具
+    boolean isAddDebugTools;
+    
+    public APPInfo(String appName, int appIcon, String appDescription, String appGitName, String appGitOwner, String appGitAPPBranch, String appGitAPPSubProjectFolder, String appHomePage, String appAPKName, String appAPKFolderName) {
+        this.appName = appName;
+        this.appIcon = appIcon;
+        this.appDescription = appDescription;
+        this.appGitName = appGitName;
+        this.appGitOwner = appGitOwner;
+        this.appGitAPPBranch = appGitAPPBranch;
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+        this.appHomePage = appHomePage;
+        this.appAPKName = appAPKName;
+        this.appAPKFolderName = appAPKFolderName;
+        this.isAddDebugTools = false;
+    }
+
+    public APPInfo(String appName, int appIcon, String appDescription, String appGitName, String appGitOwner, String appGitAPPBranch, String appGitAPPSubProjectFolder, String appHomePage, String appAPKName, String appAPKFolderName, boolean isAddDebugTools) {
+        this.appName = appName;
+        this.appIcon = appIcon;
+        this.appDescription = appDescription;
+        this.appGitName = appGitName;
+        this.appGitOwner = appGitOwner;
+        this.appGitAPPBranch = appGitAPPBranch;
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+        this.appHomePage = appHomePage;
+        this.appAPKName = appAPKName;
+        this.appAPKFolderName = appAPKFolderName;
+        this.isAddDebugTools = isAddDebugTools;
+    }
+
+    public APPInfo() {
+        String szBranchName = "app";
+        this.appName = "APP";
+        this.appIcon = R.drawable.ic_launcher;
+        this.appDescription = "APP Description";
+        this.appGitName = "APP";
+        this.appGitOwner = "Studio";
+        this.appGitAPPBranch = szBranchName;
+        this.appGitAPPSubProjectFolder = szBranchName;
+        this.appHomePage = "https://www.winboll.cc/studio/details.php?app=APP";
+        this.appAPKName = "APP";
+        this.appAPKFolderName = "APP";
+        this.isAddDebugTools = false;
+    }
+
+    public void setIsAddDebugTools(boolean isAddDebugTools) {
+        this.isAddDebugTools = isAddDebugTools;
+    }
+
+    public boolean isAddDebugTools() {
+        return isAddDebugTools;
+    }
+
+    public void setAppGitOwner(String appGitOwner) {
+        this.appGitOwner = appGitOwner;
+    }
+
+    public String getAppGitOwner() {
+        return appGitOwner;
+    }
+
+    public void setAppGitAPPBranch(String appGitAPPBranch) {
+        this.appGitAPPBranch = appGitAPPBranch;
+    }
+
+    public String getAppGitAPPBranch() {
+        return appGitAPPBranch;
+    }
+
+    public void setAppGitAPPSubProjectFolder(String appGitAPPSubProjectFolder) {
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+    }
+
+    public String getAppGitAPPSubProjectFolder() {
+        return appGitAPPSubProjectFolder;
+    }
+
+    public void setAppIcon(int appIcon) {
+        this.appIcon = appIcon;
+    }
+
+    public int getAppIcon() {
+        return appIcon;
+    }
+
+    public void setAppDescription(String appDescription) {
+        this.appDescription = appDescription;
+    }
+
+    public String getAppDescription() {
+        return appDescription;
+    }
+
+    public void setAppAPKFolderName(String appAPKFolderName) {
+        this.appAPKFolderName = appAPKFolderName;
+    }
+
+    public String getAppAPKFolderName() {
+        return appAPKFolderName;
+    }
+
+    public void setAppName(String appName) {
+        this.appName = appName;
+    }
+
+    public String getAppName() {
+        return appName;
+    }
+
+    public void setAppGitName(String appGitName) {
+        this.appGitName = appGitName;
+    }
+
+    public String getAppGitName() {
+        return appGitName;
+    }
+
+    public void setAppHomePage(String appHomePage) {
+        this.appHomePage = appHomePage;
+    }
+
+    public String getAppHomePage() {
+        return appHomePage;
+    }
+
+    public void setAppAPKName(String appAPKName) {
+        this.appAPKName = appAPKName;
+    }
+
+    public String getAppAPKName() {
+        return appAPKName;
+    }
+}
+
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/models/DrawerMenuBean.java b/libaes/src/main/java/cc/winboll/studio/libaes/models/DrawerMenuBean.java
new file mode 100644
index 0000000..662d4d4
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/models/DrawerMenuBean.java
@@ -0,0 +1,35 @@
+package cc.winboll.studio.libaes.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/14 01:53:34
+ * @Describe 抽屉菜单项目类
+ */
+public class DrawerMenuBean {
+
+    public static final String TAG = "DrawerMenuBean";
+
+    private int iconId;
+    private String iconName;
+
+    public DrawerMenuBean(int iconId, String iconName) {
+        this.iconId = iconId;
+        this.iconName = iconName;
+    }
+
+    public int getIconId() {
+        return iconId;
+    }
+
+    public String getIconName() {
+        return iconName;
+    }
+
+    public void setIconId(int iconId) {
+        this.iconId = iconId;
+    }
+
+    public void setIconName(String iconName) {
+        this.iconName = iconName;
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/models/WinBoLLClientServiceBean.java b/libaes/src/main/java/cc/winboll/studio/libaes/models/WinBoLLClientServiceBean.java
new file mode 100644
index 0000000..dcd112b
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/models/WinBoLLClientServiceBean.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.libaes.models;
+
+/**
+ * @Author ZhanGSKen
+ * @Date 2025/05/03 19:16
+ */
+import android.content.Context;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class WinBoLLClientServiceBean extends BaseBean {
+
+    public static final String TAG = "WinBoLLClientServiceBean";
+    
+    // 服务是否正在使用中
+    boolean isEnable;
+    
+    public WinBoLLClientServiceBean() {
+        this.isEnable = false;
+    }
+
+    public WinBoLLClientServiceBean(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+
+    @Override
+    public String getName() {
+        return WinBoLLClientServiceBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        WinBoLLClientServiceBean bean = this;
+        //jsonWriter.name("logLevel").value(bean.getLogLevel().ordinal());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+//            if (name.equals("logLevel")) {
+//                setLogLevel(LogUtils.LOG_LEVEL.values()[jsonReader.nextInt()]);
+//            } else {
+//                return false;
+//            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+
+    public static WinBoLLClientServiceBean loadWinBoLLClientServiceBean(Context context) {
+        return new WinBoLLClientServiceBean();
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/unittests/SecondaryLibraryActivity.java b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/SecondaryLibraryActivity.java
new file mode 100644
index 0000000..b5b210d
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/SecondaryLibraryActivity.java
@@ -0,0 +1,57 @@
+package cc.winboll.studio.libaes.unittests;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.widget.Toast;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.activitys.DrawerFragmentActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/15 00:58:10
+ * @Describe 第二级窗口
+ */
+public class SecondaryLibraryActivity extends DrawerFragmentActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "SecondaryLibraryActivity";
+
+    SecondaryLibraryFragment mSecondaryLibraryFragment;
+
+    @Override
+    public String getTag() {
+        return null;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        if (mSecondaryLibraryFragment == null) {
+            mSecondaryLibraryFragment = new SecondaryLibraryFragment();
+            addFragment(mSecondaryLibraryFragment);
+        }
+        showFragment(mSecondaryLibraryFragment);
+    }
+
+    @Override
+    public DrawerFragmentActivity.ActivityType initActivityType() {
+        return DrawerFragmentActivity.ActivityType.Secondary;
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.toolbar_secondarylibrary, menu);
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int nItemId = item.getItemId();
+        if (nItemId == R.id.item_test) {
+            Toast.makeText(getApplicationContext(), "item_test", Toast.LENGTH_SHORT).show();
+        }
+        return super.onOptionsItemSelected(item);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/unittests/SecondaryLibraryFragment.java b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/SecondaryLibraryFragment.java
new file mode 100644
index 0000000..c0ddc14
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/SecondaryLibraryFragment.java
@@ -0,0 +1,25 @@
+package cc.winboll.studio.libaes.unittests;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 02:36:34
+ * @Describe SecondaryLibraryFragment
+ */
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import androidx.fragment.app.Fragment;
+import cc.winboll.studio.libaes.R;
+
+public class SecondaryLibraryFragment extends Fragment {
+
+    public static final String TAG = "SecondaryLibraryFragment";
+
+    @Override
+    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+        View view = inflater.inflate(R.layout.fragment_secondarylibrary, container, false);
+
+        return view;
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestAButtonFragment.java b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestAButtonFragment.java
new file mode 100644
index 0000000..ce837aa
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestAButtonFragment.java
@@ -0,0 +1,37 @@
+package cc.winboll.studio.libaes.unittests;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:27:50
+ * @Describe TestAButtonFragment
+ */
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import androidx.fragment.app.Fragment;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.views.AButton;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class TestAButtonFragment extends Fragment {
+
+    public static final String TAG = "TestAButtonFragment";
+
+    @Override
+    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+        View view = inflater.inflate(R.layout.fragment_abutton, container, false);
+        AButton aButton = view.findViewById(R.id.fragmentabuttonAButton1);
+        aButton.setOnClickListener(new View.OnClickListener() {
+
+                @Override
+                public void onClick(View view) {
+                    LogUtils.d(TAG, "onClick");
+                    ToastUtils.show("AButton");
+                }
+
+            });
+        return view;
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestASupportToolbarActivity.java b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestASupportToolbarActivity.java
new file mode 100644
index 0000000..d014654
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestASupportToolbarActivity.java
@@ -0,0 +1,47 @@
+package cc.winboll.studio.libaes.unittests;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:14:00
+ * @Describe TestASupportToolbarActivity
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.views.ASupportToolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class TestASupportToolbarActivity extends AppCompatActivity implements IWinBoLLActivity  {
+
+    public static final String TAG = "TestASupportToolbarActivity";
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+    
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        LogUtils.d(TAG, "onCreate() start");
+        AESThemeUtil.applyAppTheme(this);
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_testasupporttoolbar);
+        LogUtils.d(TAG, "setContentView() done");
+        Toolbar toolbar = findViewById(R.id.activitytestasupporttoolbarASupportToolbar1);
+        LogUtils.d(TAG, "findViewById() done, toolbar=" + toolbar.getClass().getSimpleName());
+        setSupportActionBar(toolbar);
+        LogUtils.d(TAG, "setSupportActionBar() done");
+        getSupportActionBar().setTitle(TAG);
+        LogUtils.d(TAG, "setTitle() done");
+        LogUtils.d(TAG, "onCreate() end");
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestAToolbarActivity.java b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestAToolbarActivity.java
new file mode 100644
index 0000000..bba25fc
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestAToolbarActivity.java
@@ -0,0 +1,28 @@
+package cc.winboll.studio.libaes.unittests;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:16:07
+ * @Describe TestAToolbarActivity
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.widget.Toolbar;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+
+public class TestAToolbarActivity extends Activity {
+
+    public static final String TAG = "TestAToolbarActivity";
+    
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        AESThemeUtil.applyAppTheme(this);
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_testatoolbar);
+        Toolbar toolbar = findViewById(R.id.activitytestatoolbarAToolbar1);
+        setActionBar(toolbar);
+        getActionBar().setTitle(TAG);
+    }
+
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestDrawerFragmentActivity.java b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestDrawerFragmentActivity.java
new file mode 100644
index 0000000..ab4fc2b
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestDrawerFragmentActivity.java
@@ -0,0 +1,124 @@
+package cc.winboll.studio.libaes.unittests;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/30 15:00:51
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.AdapterView;
+import android.widget.Toast;
+import androidx.fragment.app.Fragment;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.activitys.DrawerFragmentActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.DrawerMenuBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.ArrayList;
+
+public class TestDrawerFragmentActivity extends DrawerFragmentActivity implements IWinBoLLActivity {
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return null;
+    }
+
+    public static final String TAG = "TestDrawerFragmentActivity";
+
+    TestFragment1 mTestFragment1;
+    TestFragment2 mTestFragment2;
+
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        mTestFragment1 = new TestFragment1();
+        addFragment(mTestFragment1);
+        mTestFragment2 = new TestFragment2();
+        addFragment(mTestFragment2);
+        showFragment(0);
+    }
+
+    @Override
+    protected DrawerFragmentActivity.ActivityType initActivityType() {
+        return DrawerFragmentActivity.ActivityType.Main;
+    }
+
+    @Override
+    public void initDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+        super.initDrawerMenuItemList(listDrawerMenu);
+        LogUtils.d(TAG, "initDrawerMenuItemList");
+        //listDrawerMenu.clear();
+        // 添加抽屉菜单项
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestFragment1.TAG));
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestFragment2.TAG));
+        notifyDrawerMenuDataChanged();
+    }
+
+    @Override
+    public void reinitDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+        super.reinitDrawerMenuItemList(listDrawerMenu);
+        LogUtils.d(TAG, "reinitDrawerMenuItemList");
+        //listDrawerMenu.clear();
+        // 添加抽屉菜单项
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestFragment1.TAG));
+        listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, TestFragment2.TAG));
+        notifyDrawerMenuDataChanged();
+    }
+
+    @Override
+    public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
+        super.onItemClick(parent, view, position, id);
+        switch (position) {
+            case 0 : {
+                    Toast.makeText(getApplicationContext(), "0", Toast.LENGTH_SHORT).show();
+                    //LogUtils.d(TAG, "MenuItem 1");
+                    showFragment(mTestFragment1);
+                    break;
+                }
+            case 1 : {
+                    //LogUtils.d(TAG, "MenuItem 2");
+                    showFragment(mTestFragment2);
+                    break;
+                }
+
+        }
+    }
+
+    public static class TestFragment1 extends Fragment {
+
+        public static final String TAG = "TestFragment1";
+
+        View mView;
+
+        @Override
+        public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+            mView = inflater.inflate(R.layout.fragment_test1, container, false);
+
+            return mView;
+        }
+
+    }
+
+    public static class TestFragment2 extends Fragment {
+
+        public static final String TAG = "TestFragment2";
+
+        View mView;
+
+        @Override
+        public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+            mView = inflater.inflate(R.layout.fragment_test2, container, false);
+
+            return mView;
+        }
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestViewPageFragment.java b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestViewPageFragment.java
new file mode 100644
index 0000000..1d922fa
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/unittests/TestViewPageFragment.java
@@ -0,0 +1,226 @@
+package cc.winboll.studio.libaes.unittests;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:35:56
+ * @Describe TestViewPageFragment
+ */
+import android.content.Context;
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import androidx.fragment.app.Fragment;
+import androidx.viewpager.widget.ViewPager;
+import cc.winboll.studio.libaes.ImagePagerAdapter;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.util.ArrayList;
+import java.util.List;
+
+public class TestViewPageFragment extends Fragment implements ViewPager.OnPageChangeListener, View.OnClickListener {
+
+    public static final String TAG = "TestViewPageFragment";
+    
+    Context mContext;
+    LogView mLogView;
+
+    private ViewPager viewPager;
+    private List<View> views; //用来存放放进ViewPager里面的布局
+    //实例化存储imageView（导航原点）的集合
+    ImageView[] imageViews;
+    private ImagePagerAdapter adapter;//适配器
+    private LinearLayout linearLayout;//下标所在在LinearLayout布局里
+    private int currentPoint = 0;//当前被选中中页面的下标
+    View mView;
+
+    @Override
+    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+        mView = inflater.inflate(R.layout.fragment_viewpage, container, false);
+        mContext = getActivity();
+        
+        mLogView = mView.findViewById(R.id.logview);
+        mLogView.start();
+
+        //viewPager = findViewById(R.id.activitymainViewPager1);
+        initData();
+        initView();//调用初始化视图方法
+        initPoint();//调用初始化导航原点的方法
+        viewPager.addOnPageChangeListener(this);//滑动事件
+        //viewPager.setAdapter(new MyAdapter());
+
+        // 获取屏幕参数
+        //ScreenUtil.ScreenSize ss = ScreenUtil.getScreenSize(MainActivity.this);
+        //Toast.makeText(getApplication(), Integer.toString(ss.getHeightPixels())+" "+Integer.toString(ss.getWidthPixels()), Toast.LENGTH_SHORT).show();
+
+        return mView;
+    }
+
+    //初始化view，即显示的图片
+    void initView() {
+        adapter = new ImagePagerAdapter(views);
+        viewPager = mView.findViewById(R.id.fragmentviewpageViewPager1);
+        viewPager.setAdapter(adapter);
+        linearLayout = mView.findViewById(R.id.fragmentviewpageLinearLayout1);
+        initPoint();//初始化页面下方的点
+        viewPager.setOnPageChangeListener(this);
+        initAOHPCTCSeekBar();
+        initAOHPCTCSeekBar2();
+    }
+
+    //初始化所要显示的布局
+    void initData() {
+        ViewPager viewPager = mView.findViewById(R.id.fragmentviewpageViewPager1);
+        LayoutInflater inflater = LayoutInflater.from(mContext);
+        View view1 = inflater.inflate(R.layout.viewpage_atickprogressbar, viewPager, false);
+        View view2 = inflater.inflate(R.layout.viewpage_acard, viewPager, false);
+        View view3 = inflater.inflate(R.layout.viewpage_aohpctccard, viewPager, false);
+        View view4 = inflater.inflate(R.layout.viewpage_aohpctcsb, viewPager, false);
+
+        views = new ArrayList<>();
+        views.add(view1);
+        views.add(view2);
+        views.add(view3);
+        views.add(view4);
+    }
+
+    //setTag注释
+    /*
+     //View中的setTag（Onbect）表示给View添加一个格外的数据，以后可以用getTag()将这个数据取出来。来
+     代表这个数据，即实例化
+     Tag是标签的bai意识，这里的tag是object类型。所以通常会使用setTag()设置不同的Object子类对象，
+     然后使用强制转换getTag()获得对象。
+     //可以用在多个Button添加一个监听器，每个Button都设置不同的setTag。
+     这个监听器就通过getTag来分辨是哪个Button 被按下。
+     public class Main extends Activity {
+
+     @Override
+     public void onCreate(Bundle savedInstanceState) {
+     super.onCreate(savedInstanceState);
+     setContentView(R.layout.main);
+     Button button1 = (Button) findViewById(R.id.Button01);
+     Button button2 = (Button) findViewById(R.id.Button02);
+     Button button3 = (Button) findViewById(R.id.Button03);
+     Button button4 = (Button) findViewById(R.id.Button04);
+     MyListener listener = new MyListener();
+     button1.setTag(1);
+     button1.setOnClickListener(listener);
+     button2.setTag(2);
+     button2.setOnClickListener(listener);
+     button3.setTag(3);
+     button3.setOnClickListener(listener);
+     button4.setTag(4);
+     button4.setOnClickListener(listener);
+     }
+
+     public class MyListener implements View.OnClickListener {
+
+     @Override
+     public void onClick(View v) {
+     int tag = (Integer) v.getTag();
+     switch (tag) {
+     case 1:
+     System.out.println(“button1 click”);
+     break;
+     case 2:
+     System.out.println(“button2 click”);
+     break;
+     case 3:
+     System.out.println(“button3 click”);
+     break;
+     case 4:
+     System.out.println(“button4 click”);
+     break;
+     }
+
+     */
+
+    private void initPoint() {
+
+        imageViews = new ImageView[5];//实例化5个图片
+        for (int i = 0; i < linearLayout.getChildCount(); i++) {
+            imageViews[i] = (ImageView) linearLayout.getChildAt(i);
+            imageViews[i].setImageResource(R.drawable.ic_arrow_left_right_bold);
+            imageViews[i].setOnClickListener(this);//点击导航点，即可跳转
+            imageViews[i].setTag(i);//重复利用实例化的对象
+        }
+        currentPoint = 0;//默认第一个坐标
+        imageViews[currentPoint].setImageResource(R.drawable.ic_arrow_up_circle_outline);
+    }
+
+    //OnPageChangeListener接口要实现的三个方法
+    /*    onPageScrollStateChanged(int state)
+     此方法是在状态改变的时候调用，其中state这个参数有三种状态：
+     SCROLL_STATE_DRAGGING（1）表示用户手指“按在屏幕上并且开始拖动”的状态
+     （手指按下但是还没有拖动的时候还不是这个状态，只有按下并且手指开始拖动后log才打出。）
+     SCROLL_STATE_IDLE（0）滑动动画做完的状态。
+     SCROLL_STATE_SETTLING（2）在“手指离开屏幕”的状态。*/
+    @Override
+    public void onPageScrollStateChanged(int state) {
+
+    }
+    /*    onPageScrolled(int position, float positionOffset, int positionOffsetPixels)
+     当页面在滑动的时候会调用此方法，在滑动被停止之前，此方法回一直得到调用。其中三个参数的含义分别为：
+
+     position :当前页面，即你点击滑动的页面（从A滑B，则是A页面的position。
+     positionOffset:当前页面偏移的百分比
+     positionOffsetPixels:当前页面偏移的像素位置*/
+    @Override
+    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
+
+    }
+    /*    onPageSelected(int position)
+     此方法是页面滑动完后得到调用，position是你当前选中的页面的Position（位置编号）
+     (从A滑动到B，就是B的position)*/
+    public void onPageSelected(int position) {
+
+        ImageView preView = imageViews[currentPoint];
+        preView.setImageResource(R.drawable.ic_arrow_left_right_bold);
+        ImageView currView = imageViews[position];
+        currView.setImageResource(R.drawable.ic_arrow_up_circle_outline);
+        currentPoint = position;
+    }
+
+    //小圆点点击事件
+    @Override
+    public void onClick(View v) {
+        // TODO Auto-generated method stub
+        //通过getTag(),可以判断是哪个控件
+        int i = (Integer) v.getTag();
+        viewPager.setCurrentItem(i);//直接跳转到某一个页面的情况
+    }
+
+    void initAOHPCTCSeekBar() {
+        AOHPCTCSeekBar seekbar = views.get(3).findViewById(R.id.fragmentviewpageAOHPCTCSeekBar1);
+        seekbar.setThumb(mContext.getDrawable(R.drawable.ic_launcher));
+        //seekbar.setThumbOffset(200);
+        //seekbar.setThumbOffset(1);
+        seekbar.setBlurRightDP(50);
+        seekbar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+
+                @Override
+                public void onOHPCommit() {
+                    ToastUtils.show("onOHPCommit");
+                }
+            });
+    }
+    
+    void initAOHPCTCSeekBar2() {
+        AOHPCTCSeekBar seekbar = views.get(3).findViewById(R.id.fragmentviewpageAOHPCTCSeekBar2);
+        seekbar.setThumb(mContext.getDrawable(R.drawable.ic_call));
+        //seekbar.setThumbOffset(200);
+        //seekbar.setThumbOffset(1);
+        seekbar.setBlurRightDP(50);
+        seekbar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+
+                @Override
+                public void onOHPCommit() {
+                    ToastUtils.show("onOHPCommit 2");
+                }
+            });
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/AESThemeUtil.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/AESThemeUtil.java
new file mode 100644
index 0000000..b4e7548
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/AESThemeUtil.java
@@ -0,0 +1,211 @@
+package cc.winboll.studio.libaes.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/11/29 22:52:09
+ * @Describe AES 主题工具集
+ */
+import android.app.Activity;
+import android.content.Context;
+import android.view.Menu;
+import android.view.MenuItem;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.activitys.DrawerFragmentActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+
+public class AESThemeUtil {
+
+    public static final String TAG = "AESThemeUtil";
+
+    static final String SHAREDPREFERENCES_NAME = "SHAREDPREFERENCES_NAME";
+    static final String DRAWER_THEME_TYPE = "DRAWER_THEME_TYPE";
+
+    protected volatile AESThemeBean.ThemeType mThemeType;
+
+    public static <T extends Context> int getThemeTypeID(T context) {
+        AESThemeBean bean = AESThemeBean.loadBean(context, AESThemeBean.class);
+        return bean == null ? AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.AES): bean.getCurrentThemeTypeID();
+    }
+
+    public static <T extends Context> void saveThemeStyleID(T context, int nThemeTypeID) {
+        AESThemeBean bean = new AESThemeBean(nThemeTypeID);
+        AESThemeBean.saveBean(context, bean);
+    }
+
+    public static <T extends Activity> void applyAppTheme(T activity) {
+        activity.setTheme(getThemeTypeID(activity));
+    }
+
+    public static <T extends AppCompatActivity> void applyAppCompatTheme(T activity) {
+        activity.setTheme(getThemeTypeID(activity));
+    }
+
+    /*public static <T extends WinBoLLActivity> void applyWinBoLLTheme(T activity) {
+	 activity.setTheme(getThemeTypeID(activity.getApplicationContext()));
+	 }*/
+
+    public static <T extends Activity> void applyAppTheme(Activity activity, AESThemeBean.ThemeType themeType) {
+        activity.setTheme(AESThemeBean.getThemeStyleID(themeType));
+    }
+
+    public static <T extends AppCompatActivity> void applyAppCompatTheme(Activity activity, AESThemeBean.ThemeType themeType) {
+        activity.setTheme(AESThemeBean.getThemeStyleID(themeType));
+    }
+
+    /*public static <T extends WinBoLLActivity> void applyWinBoLLTheme(Activity activity, AESThemeBean.ThemeType themeType) {
+	 activity.setTheme(AESThemeBean.getThemeStyleID(themeType));
+	 }*/
+
+    public static <T extends Activity> void inflateMenu(T activity, Menu menu) {
+        activity.getMenuInflater().inflate(R.menu.toolbar_apptheme, menu);
+    }
+
+    public static <T extends AppCompatActivity> void inflateCompatMenu(T activity, Menu menu) {
+        activity.getMenuInflater().inflate(R.menu.toolbar_apptheme, menu);
+    }
+
+    /*public static <T extends WinBoLLActivity> void inflateWinBoLLMenu(T activity, Menu menu) {
+	 activity.getMenuInflater().inflate(R.menu.toolbar_apptheme, menu);
+	 }*/
+
+    public static <T extends Activity> boolean onAppThemeItemSelected(T activity, MenuItem item) {
+        int nThemeStyleID;
+        if (R.id.item_depththeme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.DEPTH);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_skytheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.SKY);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_goldentheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.GOLDEN);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_bearingtheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.BEARING);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_memortheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.MEMOR);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_taotheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.TAO);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_defaulttheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.AES);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        }
+
+        return false;
+    }
+
+    public static <T extends AppCompatActivity> boolean onAppCompatThemeItemSelected(T activity, MenuItem item) {
+        int nThemeStyleID;
+        if (R.id.item_depththeme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.DEPTH);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_skytheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.SKY);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_goldentheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.GOLDEN);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_bearingtheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.BEARING);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_memortheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.MEMOR);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_taotheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.TAO);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        } else if (R.id.item_defaulttheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.AES);
+            saveThemeStyleID(activity, nThemeStyleID);
+            return true;
+        }
+
+        return false;
+    }
+
+    public static <T extends AppCompatActivity> boolean onWinBoLLThemeItemSelected(T activity, MenuItem item) {
+        int nThemeStyleID;
+        if (R.id.item_depththeme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.DEPTH);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_skytheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.SKY);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_goldentheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.GOLDEN);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_bearingtheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.BEARING);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_memortheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.MEMOR);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_taotheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.TAO);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_defaulttheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.AES);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        }
+
+        return false;
+    }
+
+    public static <T extends DrawerFragmentActivity> boolean onWinBoLLThemeItemSelected(T activity, MenuItem item) {
+        int nThemeStyleID;
+        if (R.id.item_depththeme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.DEPTH);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_skytheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.SKY);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_goldentheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.GOLDEN);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_bearingtheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.BEARING);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_memortheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.MEMOR);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_taotheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.TAO);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        } else if (R.id.item_defaulttheme == item.getItemId()) {
+            nThemeStyleID = AESThemeBean.getThemeStyleID(AESThemeBean.ThemeType.AES);
+            saveThemeStyleID(activity.getApplicationContext(), nThemeStyleID);
+            return true;
+        }
+
+        return false;
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/AppVersionUtils.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/AppVersionUtils.java
new file mode 100644
index 0000000..e4ac66b
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/AppVersionUtils.java
@@ -0,0 +1,162 @@
+package cc.winboll.studio.libaes.utils;
+
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/08/12 14:45:35
+ * @Describe 应用版本工具集
+ */
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class AppVersionUtils {
+
+    public static final String TAG = "AppVersionUtils";
+
+    //
+    // 检查新版本是否成立
+    // szCurrentCode : 当前版本应用包名
+    // szNextCode : 新版本应用包名
+    // 返回 ：情况1：当前版本是发布版
+    //       返回 true (新版本 > 当前版本)
+    //       情况1：当前版本是Beta版
+    //       true 新版本 == 当前版本
+    //
+    public static boolean isHasNewVersion2(String szCurrentName, String szNextName) {
+        LogUtils.d(TAG, String.format("isHasNewVersion2\nszCurrentName : %s\nszNextName : %s", szCurrentName, szNextName));
+        //szCurrentName = "AES_6.2.0-beta0_3234.apk";
+        //szNextName = "AES_6.1.12.apk";
+        //szCurrentName = "AES_6.2.0-beta0_3234.apk";
+        //szNextName = "AES_6.2.0.apk";
+        //szCurrentName = "AES_6.2.0-beta0_3234.apk";
+        //szNextName = "AES_6.2.2.apk";
+        //szCurrentName = "AES_6.2.0-beta0_3234.apk";
+        //szNextName = "AES_6.2.0.apk";
+        //szCurrentName = "AES_6.1.0.apk";
+        //szNextName = "AES_6.2.0.apk";
+        //LogUtils.d(TAG, "szCurrentName : " + szCurrentName);
+        //LogUtils.d(TAG, "szNextName : " + szNextName);
+
+        //boolean isVersionNewer = false;
+        //if(szCurrentName.equals(szNextName)) {
+        //    isVersionNewer = false;
+        //} else {
+        //ToastUtils.show("szCurrent : " + szCurrent + "\nszNext : " + szNext);
+        //int nApk = szNextName.lastIndexOf(".apk");
+        //ToastUtils.show("nApk : " + Integer.toString(nApk));
+        //String szNextNoApkName = szNextName.substring(0, nApk);
+        //ToastUtils.show("szNextNoApkName : " + szNextNoApkName);
+        //String szCurrentNoApkName = szCurrentName.substring(0, szNextNoApkName.length());
+        //ToastUtils.show("szCurrentNoApkName : " + szCurrentNoApkName);
+        //String str1 = "3.4.50";
+        //String str2 = "3.3.60";
+        //String str1 = getCodeInPackageName(szCurrentName);
+        //String str2 = getCodeInPackageName(szNextName);
+        //String str1 = getCodeInPackageName(szNextName);
+        //String str2 = getCodeInPackageName(szCurrentName);
+        //Boolean isVersionNewer2 = checkNewVersion(str1,str2);
+        //ToastUtils.show("isVersionNewer2 : " + Boolean.toString(isVersionNewer2));
+        //ToastUtils.show(checkNewVersion(getCodeInPackageName(szCurrentName), getCodeInPackageName(szNextName)));
+        //return checkNewVersion(getCodeInPackageName(szCurrentName), getCodeInPackageName(szNextName));
+        //}
+        //return isVersionNewer;
+        if (checkNewVersion(getCodeInPackageName(szCurrentName), getCodeInPackageName(szNextName))) {
+            // 比 AES_6.2.0.apk 版本大，如 AES_6.2.1.apk。
+            // 比 AES_6.2.0-beta0_3234.apk 大，如 AES_6.2.1.apk。
+            //LogUtils.d(TAG, "App newer stage version is released. Release name : " + szNextName);
+            return true;
+        } 
+        if (szCurrentName.matches(".*_\\d+\\.\\d+\\.\\d+-beta.*\\.apk")) {
+            String szCurrentReleasePackageName = getReleasePackageName(szCurrentName);
+            //LogUtils.d(TAG, "szCurrentReleasePackageName : " + szCurrentReleasePackageName);
+            if (szCurrentReleasePackageName.equals(szNextName)) {
+                // 与 AES_6.2.0-beta0_3234.apk 版本相同，如 AES_6.2.0.apk。
+                //LogUtils.d(TAG, "App stage version is released. Release name : " + szNextName);
+                return true;
+            }
+        }
+        //LogUtils.d(TAG, "App version is the newest. ");
+        return false;
+    }
+
+    public static boolean isHasNewStageReleaseVersion(String szCurrentName, String szNextName) {
+        LogUtils.d(TAG, String.format("isHasNewStageReleaseVersion\nszCurrentName : %s\nszNextName : %s", szCurrentName, szNextName));
+        //szCurrentName = "AES_6.2.12.apk";
+        //szNextName = "AES_6.3.12.apk";
+        if (checkNewVersion(getCodeInPackageName(szCurrentName), getCodeInPackageName(szNextName))) {
+            // 比 AES_6.2.0.apk 版本大，如 AES_6.2.1.apk。
+            //LogUtils.d(TAG, "App newer stage version is released. Release name : " + szNextName);
+            return true;
+        }
+        return false;
+    }
+
+    //
+    // 检查新版本是否成立
+    // szCurrentCode : 当前版本
+    // szNextCode : 新版本
+    // 返回 ：true 新版本 > 当前版本
+    //
+    public static Boolean checkNewVersion(String szCurrentCode, String szNextCode) {
+        if (szCurrentCode == null || szCurrentCode.equals("") || szNextCode == null || szNextCode.equals("")) {
+            LogUtils.d(TAG, String.format("checkNewVersion unexpected parameters:\nszCurrentCode : %s\nszNextCode : %s", szCurrentCode, szNextCode));
+            return false;
+        }
+        boolean isNew = false;
+        String[] appVersionCurrent = szCurrentCode.split("\\.");
+        String[] appVersionNext = szNextCode.split("\\.");
+        //根据位数最短的判断
+        int lim = appVersionCurrent.length > appVersionNext.length ? appVersionNext.length : appVersionCurrent.length;
+        //根据位数循环判断各个版本
+        for (int i = 0; i < lim; i++) {
+            if (Integer.parseInt(appVersionNext[i]) > Integer.parseInt(appVersionCurrent[i])) {
+                isNew = true;
+                return isNew;
+            } else if (Integer.parseInt(appVersionNext[i]) == Integer.parseInt(appVersionCurrent[i])) {
+                continue ;
+            } else {
+                isNew = false;
+                return isNew;
+            }
+        }
+        return isNew;
+    }
+
+    //
+    // 截取应用包名称版本号信息
+    // 如 ：AppUtils_7.0.4-beta1_0120.apk 版本号为 7.0.4
+    // 如 ：AppUtils_7.0.4.apk 版本号为 7.0.4
+    //
+    public static String getCodeInPackageName(String apkName) {
+        LogUtils.d(TAG, String.format("getCodeInPackageName apkName : %s", apkName));
+        //String apkName = "AppUtils_7.0.0.apk";
+        Pattern pattern = Pattern.compile("\\d+\\.\\d+\\.\\d+");
+        Matcher matcher = pattern.matcher(apkName);
+        if (matcher.find()) {
+            String version = matcher.group();
+            LogUtils.d(TAG, String.format("version is %s", version));
+            return version;
+            //System.out.println("Version number: " + version); // 输出：7.0.0
+        }
+        LogUtils.d(TAG, String.format("No result."));
+        return "";
+    }
+
+    //
+    // 根据Beta版名称生成发布版应用包名称
+    // 如 AppUtils_7.0.4-beta1_0120.apk
+    // 发布版名称就为AppUtils_7.0.4.apk
+    //
+    public static String getReleasePackageName(String szBetaPackageName) {
+        //String szBetaPackageName = "AppUtils_7.0.4-beta1_0120.apk";
+        Pattern pattern = Pattern.compile(".*\\d+\\.\\d+\\.\\d+");
+        Matcher matcher = pattern.matcher(szBetaPackageName);
+        if (matcher.find()) {
+            String szReleasePackageName = matcher.group();
+            return szReleasePackageName + ".apk";
+            //System.out.println("Version number: " + version); // 输出：7.0.0
+        }
+        return "";
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/DevelopUtils.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/DevelopUtils.java
new file mode 100644
index 0000000..377afc3
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/DevelopUtils.java
@@ -0,0 +1,35 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.app.Activity;
+import android.view.Menu;
+import android.view.MenuItem;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libappbase.LogActivity;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/07 13:31
+ * @Describe 应用开发工具类
+ */
+public class DevelopUtils {
+
+    public static final String TAG = "DevelopUtils";
+
+	public static <T extends Activity> void inflateMenu(T activity, Menu menu) {
+        activity.getMenuInflater().inflate(R.menu.toolbar_appdebug, menu);
+    }
+	
+	public static <T extends Activity> boolean onDevelopItemSelected(T activity, MenuItem item) {
+		if (R.id.item_testappcrash == item.getItemId()) {
+            for (int i = Integer.MIN_VALUE; i < Integer.MAX_VALUE; i++) {
+				activity.getString(i);
+            }
+        } else if (R.id.item_log == item.getItemId()) {
+			//ToastUtils.show("Test");
+            LogActivity.startLogActivity(activity);
+        } else {
+			return false;
+		}
+		return true;
+	}
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/MimoUtils.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/MimoUtils.java
new file mode 100644
index 0000000..2c07337
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/MimoUtils.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.content.Context;
+import android.util.DisplayMetrics;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/18 15:23
+ * @Describe 米盟 MimoUtils
+ */
+public final class MimoUtils {
+	public static final String TAG = "Utils";
+
+	public static int dpToPx(Context context, float dp) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (dp * displayMetrics.density + 0.5f);
+	}
+
+	public static int pxToDp(Context context, float px) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (px / displayMetrics.density + 0.5f);
+	}
+
+	public static int pxToSp(Context context, float pxValue) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (pxValue / displayMetrics.scaledDensity + 0.5f);
+	}
+
+	public static int spToPx(Context context, float spValue) {
+		DisplayMetrics displayMetrics = context.getResources().getDisplayMetrics();
+		return (int) (spValue * displayMetrics.scaledDensity + 0.5f);
+	}
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/MyActivityLifecycleCallbacks.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/MyActivityLifecycleCallbacks.java
new file mode 100644
index 0000000..d32928d
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/MyActivityLifecycleCallbacks.java
@@ -0,0 +1,97 @@
+package cc.winboll.studio.libaes.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/25 04:29:19
+ */
+import android.app.Activity;
+import android.app.Application;
+import android.content.Intent;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.LogUtils; 
+
+public class MyActivityLifecycleCallbacks implements Application.ActivityLifecycleCallbacks { 
+
+    public static final String TAG = "MyActivityLifecycleCallbacks";
+
+    public String mInfo = "";
+
+    public MyActivityLifecycleCallbacks() {
+
+    }
+
+    void createActivityeInfo(Activity activity) {
+        StringBuilder sb = new StringBuilder();
+        Intent receivedIntent = activity.getIntent();
+        sb.append("\nCallingActivity : \n");
+        if (activity.getCallingActivity() != null) {
+            sb.append(activity.getCallingActivity().getPackageName());
+        }
+        sb.append("\nReceived Intent Package : \n");
+        sb.append(receivedIntent.getPackage());
+
+        Bundle extras = receivedIntent.getExtras();
+        if (extras != null) {
+            for (String key : extras.keySet()) {
+                sb.append("\nIntentInfo");
+                sb.append("\n键: ");
+                sb.append(key);
+                sb.append(", 值: ");
+                sb.append(extras.get(key));
+                //Log.d("IntentInfo", "键: " + key + ", 值: " + extras.get(key));
+            }
+        }
+        mInfo = sb.toString();
+        //Log.d("IntentInfo", "发送Intent的应用包名: " + senderPackage);
+    }
+
+    public void showActivityeInfo() {
+        //ToastUtils.show("ActivityeInfo : " + mInfo);
+        LogUtils.d(TAG, "ActivityeInfo : " + mInfo);
+    }
+
+    @Override 
+    public void onActivityCreated(Activity activity, Bundle savedInstanceState) { 
+        // 在这里可以做一些初始化相关的操作，例如记录Activity的创建时间等 
+        //System.out.println(activity.getLocalClassName() + " was created"); 
+        LogUtils.d(TAG, activity.getLocalClassName() + " was created");
+        createActivityeInfo(activity);
+    } 
+
+    @Override 
+    public void onActivityStarted(Activity activity) { 
+        //System.out.println(activity.getLocalClassName() + " was started");
+        LogUtils.d(TAG, activity.getLocalClassName() + " was started");
+        //createActivityeInfo(activity);
+    } 
+
+    @Override 
+    public void onActivityResumed(Activity activity) { 
+        //System.out.println(activity.getLocalClassName() + " was resumed");
+        LogUtils.d(TAG, activity.getLocalClassName() + " was resumed");
+        //createActivityeInfo(activity);
+    } 
+
+    @Override 
+    public void onActivityPaused(Activity activity) { 
+        //System.out.println(activity.getLocalClassName() + " was paused");
+        LogUtils.d(TAG, activity.getLocalClassName() + " was paused");
+    } 
+
+    @Override 
+    public void onActivityStopped(Activity activity) { 
+        //System.out.println(activity.getLocalClassName() + " was stopped");
+        LogUtils.d(TAG, activity.getLocalClassName() + " was stopped");
+    } 
+
+    @Override 
+    public void onActivitySaveInstanceState(Activity activity, Bundle outState) { 
+        // 可以在这里添加保存状态的自定义逻辑 
+    } 
+
+    @Override 
+    public void onActivityDestroyed(Activity activity) { 
+        //System.out.println(activity.getLocalClassName() + " was destroyed");
+        LogUtils.d(TAG, activity.getLocalClassName() + " was destroyed");
+    } 
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/PrefUtils.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/PrefUtils.java
new file mode 100644
index 0000000..751a9e5
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/PrefUtils.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/13 06:50
+ * @Describe 应用变量保存工具
+ */
+
+public class PrefUtils {
+
+    public static final String TAG = "PrefUtils";
+
+    //
+    // 保存字符串到SharedPreferences的函数
+    //
+    public static void saveString(Context context, String key, String value) {
+        SharedPreferences sharedPreferences = context.getSharedPreferences("myPrefs", Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = sharedPreferences.edit();
+        editor.putString(key, value);
+        editor.apply();
+    }
+
+    //
+    // 从SharedPreferences读取字符串的函数
+    //
+    public static String getString(Context context, String key, String defaultValue) {
+        SharedPreferences sharedPreferences = context.getSharedPreferences("myPrefs", Context.MODE_PRIVATE);
+        return sharedPreferences.getString(key, defaultValue);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/ScreenUtil.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/ScreenUtil.java
new file mode 100644
index 0000000..20399ea
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/ScreenUtil.java
@@ -0,0 +1,64 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.content.Context;
+import android.util.DisplayMetrics;
+import android.view.WindowManager;
+
+public class ScreenUtil {
+
+    // 分辨率宽度和高度计量类
+    //
+    public static class ScreenSize {
+        int widthPixels;
+        int heightPixels;
+
+        public ScreenSize(int widthPixels, int heightPixels) {
+            this.widthPixels = widthPixels;
+            this.heightPixels = heightPixels;
+        }
+
+        public void setWidthPixels(int widthPixels) {
+            this.widthPixels = widthPixels;
+        }
+
+        public int getWidthPixels() {
+            return widthPixels;
+        }
+
+        public void setHeightPixels(int heightPixels) {
+            this.heightPixels = heightPixels;
+        }
+
+        public int getHeightPixels() {
+            return heightPixels;
+        }
+    }
+
+    // 获取屏幕分辨率宽度和高度
+    //
+    public static ScreenSize getScreenSize(Context mContext) {
+        WindowManager manager = (WindowManager) mContext.getSystemService(Context.WINDOW_SERVICE);
+        DisplayMetrics dm = new DisplayMetrics();
+        manager.getDefaultDisplay().getMetrics(dm);
+        return new ScreenSize(dm.widthPixels, dm.heightPixels);
+    }
+
+    // 获取屏幕宽度
+    //
+    public static int getScreenWidth(Context mContext) {
+        WindowManager manager = (WindowManager) mContext.getSystemService(Context.WINDOW_SERVICE);
+        DisplayMetrics dm = new DisplayMetrics();
+        manager.getDefaultDisplay().getMetrics(dm);
+        return dm.widthPixels;
+    }
+
+    // 获取屏幕高度
+    //
+    public static int getScreenHeight(Context mContext) {
+        WindowManager manager = (WindowManager) mContext.getSystemService(Context.WINDOW_SERVICE);
+        DisplayMetrics dm = new DisplayMetrics();
+        manager.getDefaultDisplay().getMetrics(dm);
+        return dm.heightPixels;
+    }
+
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/WebUtils.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/WebUtils.java
new file mode 100644
index 0000000..94d8502
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/WebUtils.java
@@ -0,0 +1,102 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Handler;
+import android.os.Looper;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/05 15:45
+ * @LastEditTime 2026/01/05 19:30:00 HKT
+ * @Describe 网页工具集（优化：新增合法性校验+浏览器可用性检查+链接格式自动修复）
+ */
+public class WebUtils {
+
+    public static final String TAG = "WebUtils";
+
+    /**
+     * 唤起系统默认浏览器打开指定网站
+     * @param context 上下文对象（建议使用 ApplicationContext 避免内存泄漏）
+     * @param url 目标 URL（支持自动修复格式错误）
+     */
+    public static void openUrlInBrowser(Context context, String url) {
+        // 1. 空指针与合法性校验
+        if (context == null) {
+            LogUtils.e(TAG, "openUrlInBrowser: Context is null");
+            return;
+        }
+        if (url == null || url.trim().isEmpty()) {
+            LogUtils.e(TAG, "openUrlInBrowser: Url is null or empty");
+            showToast(context, "链接不能为空");
+            return;
+        }
+
+        // 2. 链接格式自动修复（核心新增：处理多斜杠、补全协议头）
+        String fixedUrl = fixUrlFormat(url.trim());
+        LogUtils.d(TAG, "openUrlInBrowser: Fixed url from [" + url + "] to [" + fixedUrl + "]");
+
+        // 3. 构建隐式意图
+        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(fixedUrl));
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); // 新任务栈启动
+
+        // 4. 检查浏览器可用性
+        if (intent.resolveActivity(context.getPackageManager()) != null) {
+            try {
+                context.startActivity(intent);
+            } catch (Exception e) {
+                LogUtils.e(TAG, "openUrlInBrowser: Start activity failed", e);
+                showToast(context, "打开浏览器失败，请手动复制链接");
+            }
+        } else {
+            LogUtils.e(TAG, "openUrlInBrowser: No browser app found");
+            showToast(context, "未找到可用的浏览器应用");
+        }
+    }
+
+    /**
+     * 工具方法：修复 URL 格式错误
+     * 1. 补全 http/https 协议头
+     * 2. 处理协议头后的多斜杠问题（如 https://mmec//path → https://mmec/path）
+     * @param originalUrl 原始 URL
+     * @return 修复后的 URL
+     */
+    private static String fixUrlFormat(String originalUrl) {
+        String url = originalUrl;
+
+        // 步骤1：补全协议头（优先 https）
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            url = "https://" + url;
+        }
+
+        // 步骤2：修复协议头后的多斜杠问题
+        // 匹配 https:// 或 http:// 后的任意数量斜杠，替换为单斜杠
+        url = url.replaceAll("(?<=https?://)[/]+", "/");
+
+        return url;
+    }
+
+    /**
+     * 工具方法：显示 Toast 提示（确保在主线程执行）
+     */
+    private static void showToast(final Context context, final String message) {
+        if (context == null || message == null) {
+            return;
+        }
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            Toast.makeText(context.getApplicationContext(), message, Toast.LENGTH_SHORT).show();
+        } else {
+            new Handler(Looper.getMainLooper()).post(new Runnable() {
+					@Override
+					public void run() {
+						Toast.makeText(context.getApplicationContext(), message, Toast.LENGTH_SHORT).show();
+					}
+				});
+        }
+    }
+}
+
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/utils/WinBoLLActivityManager.java b/libaes/src/main/java/cc/winboll/studio/libaes/utils/WinBoLLActivityManager.java
new file mode 100644
index 0000000..cac2157
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/utils/WinBoLLActivityManager.java
@@ -0,0 +1,306 @@
+package cc.winboll.studio.libaes.utils;
+
+import android.app.Activity;
+import android.app.ActivityManager;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Build;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Map;
+import java.util.Objects;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/05/10 10:02
+ * @Describe 应用活动窗口管理器（改进版）
+ * 核心能力：多任务窗口管理、Activity栈维护、任务前台恢复、批量关闭、前后Activity切换
+ * 参考 ：android 类似微信小程序多任务窗口 及 设置 TaskDescription 修改 icon 和 label
+ */
+public class WinBoLLActivityManager {
+
+    public static final String TAG = "WinBoLLActivityManager";
+    public static final String EXTRA_TAG = "EXTRA_TAG";
+
+    public enum WinBoLLUI_TYPE { APPLICATION, SERVICE } // 规范命名 大写开头
+
+    private GlobalApplication mGlobalApplication;
+    private static volatile WinBoLLActivityManager sInstance; // 单例命名规范
+    private final Map<String, IWinBoLLActivity> mActivityListMap; // 私有不可变
+    private static volatile WinBoLLUI_TYPE sWinBoLLUI_TYPE = WinBoLLUI_TYPE.SERVICE;
+
+    // 私有构造 杜绝外部实例化
+    private WinBoLLActivityManager(@NonNull GlobalApplication application) {
+        mGlobalApplication = application;
+        mActivityListMap = new HashMap<>(); // 菱形泛型简化
+    }
+
+    /**
+     * 初始化管理器（必须在Application onCreate中调用）
+     */
+    public static <T extends GlobalApplication> void init(@NonNull T application) {
+        if (sInstance == null) {
+            synchronized (WinBoLLActivityManager.class) {
+                if (sInstance == null) {
+                    sInstance = new WinBoLLActivityManager(application);
+                }
+            }
+        }
+    }
+
+    /**
+     * 获取单例（需先调用init初始化，否则抛异常）
+     */
+    @NonNull
+    public static WinBoLLActivityManager getInstance() {
+        if (sInstance == null) {
+            throw new IllegalStateException("WinBoLLActivityManager 未初始化，请先在Application中调用 init()");
+        }
+        return sInstance;
+    }
+
+    // ===================== 基础配置 =====================
+    public static void setWinBoLLUI_TYPE(@NonNull WinBoLLUI_TYPE winBoLLUI_TYPE) {
+        sWinBoLLUI_TYPE = winBoLLUI_TYPE;
+    }
+
+    @NonNull
+    public static WinBoLLUI_TYPE getWinBoLLUI_TYPE() {
+        return sWinBoLLUI_TYPE;
+    }
+
+    // ===================== Activity 增删查 =====================
+    /**
+     * 把Activity添加到管理中（自动去重）
+     */
+    public <T extends IWinBoLLActivity> void add(@NonNull T activity) {
+        String tag = activity.getTag();
+        if (isActivityActive(tag)) {
+            LogUtils.d(TAG, String.format("Activity[%s] 已处于活跃状态，无需重复添加", tag));
+            return;
+        }
+        mActivityListMap.put(tag, activity);
+        LogUtils.d(TAG, String.format("添加Activity：%s，当前管理数量：%d", tag, mActivityListMap.size()));
+    }
+
+    /**
+     * 判断指定Tag的Activity是否活跃
+     */
+    public boolean isActivityActive(@NonNull String tag) {
+        return mActivityListMap.containsKey(tag) && mActivityListMap.get(tag) != null;
+    }
+
+    /**
+     * 根据Tag获取Activity（空安全）
+     */
+    @Nullable
+    public Activity getActivityByTag(@NonNull String tag) {
+        IWinBoLLActivity winBoLLActivity = mActivityListMap.get(tag);
+        if (winBoLLActivity == null) return null;
+        Activity activity = winBoLLActivity.getActivity();
+        // 过滤已销毁/已结束的Activity
+        if (activity == null || activity.isFinishing() || (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && activity.isDestroyed())) {
+            registeRemove(winBoLLActivity);
+            return null;
+        }
+        return activity;
+    }
+
+    /**
+     * 移除指定Activity（销毁时调用）
+     */
+    public <T extends IWinBoLLActivity> boolean registeRemove(@NonNull T iWinBoLLActivity) {
+        String tag = iWinBoLLActivity.getTag();
+        if (mActivityListMap.containsKey(tag)) {
+            mActivityListMap.remove(tag);
+            LogUtils.d(TAG, String.format("移除Activity：%s，剩余管理数量：%d", tag, mActivityListMap.size()));
+            return true;
+        }
+        return false;
+    }
+
+    // ===================== Activity 启动 =====================
+    /**
+     * 启动WinBoLLActivity（存在则前台恢复，不存在则新建多任务窗口）
+     */
+    public <T extends IWinBoLLActivity> void startWinBoLLActivity(@NonNull Context context, @NonNull Class<T> clazz) {
+        if (!resumeActivity(clazz)) {
+            Intent intent = new Intent(context, clazz);
+            setMultiTaskFlags(intent);
+            context.startActivity(intent);
+        }
+    }
+
+    /**
+     * 带Intent参数启动WinBoLLActivity
+     */
+    public <T extends IWinBoLLActivity> void startWinBoLLActivity(@NonNull Context context, @NonNull Intent intent, @NonNull Class<T> clazz) {
+        if (!resumeActivity(clazz)) {
+            setMultiTaskFlags(intent);
+            context.startActivity(intent);
+        }
+    }
+
+    /**
+     * 启动日志页面（固定多任务模式）
+     */
+    public void startLogActivity(@NonNull Context context) {
+        Intent intent = new Intent(context, LogActivity.class);
+        setMultiTaskFlags(intent);
+        intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT); // 分屏相关
+        context.startActivity(intent);
+    }
+
+    /**
+     * 设置多任务窗口通用Flags
+     */
+    private void setMultiTaskFlags(@NonNull Intent intent) {
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+        intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+    }
+
+    // ===================== Activity 前台恢复 =====================
+    /**
+     * 根据Activity类 恢复前台（反射获取Tag，需保证无参构造）
+     */
+    public <T extends IWinBoLLActivity> boolean resumeActivity(@NonNull Class<T> clazz) {
+        try {
+            T instance = clazz.newInstance();
+            return resumeActivity(instance.getTag());
+        } catch (InstantiationException | IllegalAccessException e) {
+            LogUtils.e(TAG, "恢复Activity失败，类需提供无参构造", e);
+        }
+        return false;
+    }
+
+    /**
+     * 根据Tag 恢复Activity前台
+     */
+    public boolean resumeActivity(@NonNull String tag) {
+        Activity activity = getActivityByTag(tag);
+        return activity != null && resumeActivity(activity);
+    }
+
+    /**
+     * 恢复指定Activity到前台（适配高版本权限）
+     */
+    @SuppressWarnings("deprecation")
+    public boolean resumeActivity(@NonNull Activity activity) {
+        if (activity.isFinishing() || (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && activity.isDestroyed())) {
+            return false;
+        }
+        try {
+            ActivityManager am = (ActivityManager) activity.getSystemService(Context.ACTIVITY_SERVICE);
+            if (am == null) {
+                LogUtils.w(TAG, "获取ActivityManager失败，无法恢复前台");
+                return false;
+            }
+            // Android 11+ 限制，低版本正常使用
+            am.moveTaskToFront(activity.getTaskId(), ActivityManager.MOVE_TASK_NO_USER_ACTION);
+			//ToastUtils.show(String.format("Activity[%s] 已恢复到前台", activity.getClass().getSimpleName()));
+            LogUtils.d(TAG, String.format("Activity[%s] 已恢复到前台", activity.getClass().getSimpleName()));
+            return true;
+        } catch (SecurityException e) {
+			//ToastUtils.show("恢复Activity前台失败，缺少权限或系统限制 ：" + e.getMessage());
+            LogUtils.e(TAG, "恢复Activity前台失败，缺少权限或系统限制", e);
+            //ToastUtils.show("窗口恢复失败，请手动打开");
+            return false;
+        }
+    }
+
+    // ===================== Activity 关闭 =====================
+    /**
+     * 结束所有管理的Activity（按UI类型选择关闭策略）
+     */
+    public void finishAll() {
+        if (mActivityListMap.isEmpty()) {
+            LogUtils.d(TAG, "当前无管理的Activity，无需结束");
+            return;
+        }
+        LogUtils.d(TAG, String.format("开始结束所有Activity，共%d个", mActivityListMap.size()));
+        Iterator<Map.Entry<String, IWinBoLLActivity>> iterator = mActivityListMap.entrySet().iterator();
+        while (iterator.hasNext()) {
+            IWinBoLLActivity winBoLLActivity = iterator.next().getValue();
+            Activity activity = winBoLLActivity.getActivity();
+            if (activity == null) {
+                iterator.remove();
+                continue;
+            }
+            // 安全关闭，避免重复操作
+            if (!activity.isFinishing() && !(Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && activity.isDestroyed())) {
+                if (sWinBoLLUI_TYPE == WinBoLLUI_TYPE.SERVICE) {
+                    activity.finishAndRemoveTask(); // 结束+移除最近任务
+                } else if (sWinBoLLUI_TYPE == WinBoLLUI_TYPE.APPLICATION) {
+                    activity.finish(); // 仅结束页面
+                }
+            }
+            iterator.remove(); // 移除已处理的项
+        }
+        LogUtils.d(TAG, "所有Activity结束完成");
+    }
+
+    /**
+     * 结束指定Activity，自动恢复上一个Activity前台
+     */
+    public <T extends IWinBoLLActivity> void finish(@NonNull T iWinBoLLActivity) {
+        Activity currentActivity = iWinBoLLActivity.getActivity();
+        if (currentActivity == null || currentActivity.isFinishing() || (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 && currentActivity.isDestroyed())) {
+            registeRemove(iWinBoLLActivity);
+            return;
+        }
+
+        // 先获取上一个Activity，再关闭当前
+        Activity preActivity = getPreActivity(iWinBoLLActivity);
+        currentActivity.finish();
+        registeRemove(iWinBoLLActivity); // 关闭后移除管理
+
+        // 恢复上一个Activity前台
+        if (preActivity != null) {
+            resumeActivity(preActivity);
+        }
+    }
+
+    /**
+     * 获取当前Activity的上一个栈内Activity（修复原遍历逻辑错误）
+     */
+    @Nullable
+    private Activity getPreActivity(@NonNull IWinBoLLActivity currentActivity) {
+        String currentTag = currentActivity.getTag();
+        IWinBoLLActivity preWinBoLLActivity = null;
+        for (Map.Entry<String, IWinBoLLActivity> entry : mActivityListMap.entrySet()) {
+            String tag = entry.getKey();
+            if (Objects.equals(tag, currentTag)) {
+                break; // 找到当前Activity，循环终止，pre即为上一个
+            }
+            preWinBoLLActivity = entry.getValue();
+        }
+        return preWinBoLLActivity != null ? preWinBoLLActivity.getActivity() : null;
+    }
+
+    // ===================== 调试辅助 =====================
+    /**
+     * 打印所有管理的Activity信息（调试用）
+     */
+    public void printActivityListInfo() {
+        if (mActivityListMap.isEmpty()) {
+            LogUtils.d(TAG, "当前管理的Activity列表为空");
+            return;
+        }
+        StringBuilder sb = new StringBuilder(String.format("Activity管理列表（总数：%d）\n", mActivityListMap.size()));
+        for (Map.Entry<String, IWinBoLLActivity> entry : mActivityListMap.entrySet()) {
+            sb.append("Tag: ").append(entry.getKey())
+				.append(" | Activity: ").append(entry.getValue().getActivity().getClass().getSimpleName())
+				.append("\n");
+        }
+        LogUtils.d(TAG, sb.toString());
+    }
+}
+
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/AButton.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/AButton.java
new file mode 100644
index 0000000..5c9c111
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/AButton.java
@@ -0,0 +1,28 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:41:22
+ * @Describe AButton
+ */
+import android.content.Context;
+import android.util.AttributeSet;
+import cc.winboll.studio.libaes.R;
+
+public class AButton extends android.widget.Button {
+
+    public static final String TAG = "AButton";
+
+    public AButton(Context context) {
+        super(context);
+    }
+
+    public AButton(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        setBackground(context.getDrawable(R.drawable.btn_style));
+    }
+
+    public AButton(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/ACard.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/ACard.java
new file mode 100644
index 0000000..4f627f8
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/ACard.java
@@ -0,0 +1,45 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:44:27
+ * @Describe ACard
+ */
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.LinearLayout;
+import cc.winboll.studio.libaes.R;
+
+public class ACard extends LinearLayout {
+
+    public static final String TAG = "ACard";
+
+    public ACard(Context context) {
+        super(context);
+    }
+
+    public ACard(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        setPadding(0 + 0 + 2 + 1, 0 + 0 + 2 + 1, 0 + 1 + 3 + 1, 0 + 2 + 3 + 1);
+
+        // 获得TypedArray
+        //TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.AToolbar);
+        // 获得attrs.xml里面的属性值,格式为:名称_属性名,后面是默认值
+        //int colorBackgroud = a.getColor(R.styleable.ACard_backgroudColor, context.getColor(R.color.colorACardBackgroung));
+        //int centerColor = a.getColor(R.styleable.AToolbar_centerColor, context.getColor(R.color.colorAToolbarCenterColor));
+        //int endColor = a.getColor(R.styleable.AToolbar_endColor, context.getColor(R.color.colorAToolbarEndColor));
+        //float tSize = a.getDimension(R.styleable.CustomView_tSize, 35);
+        //p.setColor(tColor);
+        //p.setTextSize(tSize);
+        //Drawable drawable = context.getDrawable(R.drawable.frame_atoolbar);
+
+        setBackground(context.getDrawable(R.drawable.acard_frame_main));
+
+        // 返回一个绑定资源结束的信号给资源
+        //a.recycle();
+    }
+
+    public ACard(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/ADrawerMenuListView.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/ADrawerMenuListView.java
new file mode 100644
index 0000000..2f4e889
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/ADrawerMenuListView.java
@@ -0,0 +1,19 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen
+ * @Date 2023/05/30 11:30:07
+ */
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.ListView;
+
+public class ADrawerMenuListView extends ListView {
+
+    public static final String TAG = "ADrawerMenuListView";
+
+    public ADrawerMenuListView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+    }
+
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/ADsBannerView.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/ADsBannerView.java
new file mode 100644
index 0000000..89eb74f
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/ADsBannerView.java
@@ -0,0 +1,491 @@
+package cc.winboll.studio.libaes.views;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.AttributeSet;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.FrameLayout;
+import android.widget.LinearLayout;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.enums.ADsMode;
+import cc.winboll.studio.libaes.utils.MimoUtils;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import com.miui.zeus.mimo.sdk.ADParams;
+import com.miui.zeus.mimo.sdk.BannerAd;
+import com.miui.zeus.mimo.sdk.MimoCustomController;
+import com.miui.zeus.mimo.sdk.MimoLocation;
+import com.miui.zeus.mimo.sdk.MimoSdk;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/18 14:41
+ * @Describe WinBoLL 横幅广告类
+ */
+public class ADsBannerView extends LinearLayout {
+
+    public static final String TAG = "ADsBannerView";
+
+
+	private String BANNER_POS_ID = "802e356f1726f9ff39c69308bfd6f06a";
+    private String BANNER_POS_ID_WINBOLL_BETA = "d129ee5a263911f981a6dc7a9802e3e7";
+    private String BANNER_POS_ID_WINBOLL = "4ec30efdb32271765b9a4efac902828b";
+
+	/*
+	 private String BANNER_POS_ID = "802e356f1726f9ff39c69308bfd6f06a";
+	 private String BANNER_POS_ID_WINBOLL_BETA = "802e356f1726f9ff39c69308bfd6f06a";
+	 private String BANNER_POS_ID_WINBOLL = "802e356f1726f9ff39c69308bfd6f06a";
+	 */
+
+	Context mContext;
+	View mMianView;
+	SharedPreferences mSharedPreferences;
+	ViewGroup mContainer;
+	BannerAd mBannerAd;
+	List<BannerAd> mAllBanners = new ArrayList<>();
+	// 新增：主线程Handler，确保广告操作在主线程执行
+    private Handler mMainHandler;
+
+    public ADsBannerView(Context context) {
+		super(context);
+		initView(context);
+	}
+
+	public ADsBannerView(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		initView(context);
+	}
+
+	public ADsBannerView(Context context, AttributeSet attrs, int defStyleAttr) {
+		super(context, attrs, defStyleAttr);
+		initView(context);
+	}
+
+	public ADsBannerView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+		super(context, attrs, defStyleAttr, defStyleRes);
+		initView(context);
+	}
+
+	void initView(Context context) {
+		this.mContext = context;
+		initMimoSdk(this.mContext);
+
+		// 初始化主线程Handler（关键：确保广告操作在主线程执行）
+		mMainHandler = new Handler(Looper.getMainLooper());
+
+		this.mMianView = inflate(this.mContext, R.layout.view_adsbanner, null);
+		mContainer = this.mMianView.findViewById(R.id.ads_container);
+		addView(this.mMianView);
+	}
+
+	public void resumeADs(final Activity activity) {
+		// 没有设置米盟广告支持就退出
+		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
+			// 2. 释放之前的广告资源
+			if (mBannerAd != null) {
+				mBannerAd.destroy();
+			}
+			return;
+		}
+
+		// 修复：优化广告请求逻辑（添加生命周期判断 + 主线程执行）
+		if (activity != null && !activity.isFinishing() && !activity.isDestroyed()) {
+			if (ADsControlView.getAdsModeFromStatic(this.mContext) == ADsMode.MIMO_SDK) {
+				LogUtils.i(TAG, "已设置播放米盟广告，正在播放...");
+				mMainHandler.postDelayed(new Runnable() {
+						@Override
+						public void run() {
+							// 再次校验生命周期，避免延迟执行时Activity已销毁
+							if (activity != null && !activity.isFinishing() && !activity.isDestroyed()) {
+								fetchAd(activity);
+							}
+						}
+					}, 1000); // 延迟1秒请求广告，提升页面加载体验
+			}
+		}
+	}
+
+    /**
+     * 释放广告资源（关键：避免内存泄漏和空Context调用）
+     */
+    public void releaseAdResources() {
+		// 没有设置米盟广告支持就退出
+		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
+			return;
+		}
+
+        LogUtils.d(TAG, "releaseAdResources()");
+
+        // 移除Handler回调
+        if (mMainHandler != null) {
+            mMainHandler.removeCallbacksAndMessages(null);
+        }
+
+        // 销毁所有广告实例
+        if (mAllBanners != null && !mAllBanners.isEmpty()) {
+            for (BannerAd ad : mAllBanners) {
+                if (ad != null) {
+                    ad.destroy();
+                }
+            }
+            mAllBanners.clear();
+        }
+        // 置空当前广告引用
+        mBannerAd = null;
+        // 移除广告容器中的视图
+        if (mContainer != null) {
+            mContainer.removeAllViews();
+        }
+    }
+
+    /**
+     * 显示广告（核心修复：传递安全的Context + 生命周期校验）
+     */
+    private void showAd(final Activity activity) {
+		// 没有设置米盟广告支持就退出
+		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
+			return;
+		}
+
+        LogUtils.d(TAG, "showAd()");
+        // 1. 生命周期校验：避免Activity已销毁时操作UI
+        if (activity == null || activity.isFinishing() || activity.isDestroyed()) {
+            LogUtils.e(TAG, "showAd: Activity is finishing or destroyed");
+            return;
+        }
+        // 2. 非空校验：广告实例和容器
+        if (mBannerAd == null || mContainer == null) {
+            LogUtils.e(TAG, "showAd: BannerAd or Container is null");
+            return;
+        }
+        // 3. 创建广告容器（使用ApplicationContext避免内存泄漏）
+        final FrameLayout container = new FrameLayout(activity.getApplicationContext());
+        container.setPadding(0, 0, 0, MimoUtils.dpToPx(activity, 10));
+        mContainer.addView(container, new FrameLayout.LayoutParams(
+							   FrameLayout.LayoutParams.MATCH_PARENT,
+							   FrameLayout.LayoutParams.WRAP_CONTENT
+						   ));
+
+//        if (mIsBiddingWin) {
+//            mBannerAd.setPrice(getPrice());
+//        }
+        // 4. 显示广告：传递ApplicationContext，避免Activity Context失效
+        mBannerAd.showAd(activity, container, new BannerAd.BannerInteractionListener() {
+				@Override
+				public void onAdClick() {
+					LogUtils.d(TAG, "onAdClick");
+				}
+
+				@Override
+				public void onAdShow() {
+					LogUtils.d(TAG, "onAdShow");
+				}
+
+				@Override
+				public void onAdDismiss() {
+					LogUtils.d(TAG, "onAdDismiss");
+					// 修复：移除容器时校验Activity状态
+					if (activity != null && !activity.isFinishing() && !activity.isDestroyed() && mContainer != null) {
+						mContainer.removeView(container);
+					}
+				}
+
+				@Override
+				public void onRenderSuccess() {
+					LogUtils.d(TAG, "onRenderSuccess");
+				}
+
+				@Override
+				public void onRenderFail(int code, String msg) {
+					LogUtils.e(TAG, "onRenderFail errorCode " + code + " errorMsg " + msg);
+					// 修复：渲染失败时移除容器
+					if (activity != null && !activity.isFinishing() && !activity.isDestroyed() && mContainer != null) {
+						mContainer.removeView(container);
+					}
+				}
+			});
+    }
+
+    /**
+     * 请求广告（核心修复：Context安全校验 + 异常捕获 + 资源管理）
+     */
+    private void fetchAd(final Activity activity) {
+		// 没有设置米盟广告支持就退出
+		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
+			return;
+		}
+
+        LogUtils.d(TAG, "fetchAd()");
+        // 1. 双重校验：Activity未销毁 + Context非空
+        if (activity == null || activity.isFinishing() || activity.isDestroyed() || activity.getApplicationContext() == null) {
+            LogUtils.e(TAG, "fetchAd: Invalid Context or Activity state");
+            return;
+        }
+        // 2. 释放之前的广告资源，避免内存泄漏
+        if (mBannerAd != null) {
+            mBannerAd.destroy();
+        }
+        // 3. 初始化广告（使用ApplicationContext，避免Activity Context失效）
+        try {
+            mBannerAd = new BannerAd();
+            mAllBanners.add(mBannerAd);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "fetchAd: Init BannerAd failed", e);
+            return;
+        }
+        // 4. 设置下载监听
+        mBannerAd.setDownLoadListener(new BannerAd.BannerDownloadListener() {
+				@Override
+				public void onDownloadStarted() {
+					LogUtils.d(TAG, "onDownloadStarted");
+				}
+
+				@Override
+				public void onDownloadPaused() {
+					LogUtils.d(TAG, "onDownloadPaused");
+				}
+
+				@Override
+				public void onDownloadFailed(int errorCode) {
+					String msg = "onDownloadFailed, errorCode = " + errorCode;
+					LogUtils.d(TAG, msg);
+					//ToastUtils.show(msg);
+				}
+
+				@Override
+				public void onDownloadFinished() {
+					LogUtils.d(TAG, "onDownloadFinished");
+				}
+
+				@Override
+				public void onDownloadProgressUpdated(int progress) {
+					LogUtils.d(TAG, "onDownloadProgressUpdated " + progress + "%");
+				}
+
+				@Override
+				public void onInstallFailed(int errorCode) {
+					LogUtils.d(TAG, "onInstallFailed, errorCode = " + errorCode);
+				}
+
+				@Override
+				public void onInstallStart() {
+					LogUtils.d(TAG, "onInstallStart");
+				}
+
+				@Override
+				public void onInstallSuccess() {
+					LogUtils.d(TAG, "onInstallSuccess");
+				}
+
+				@Override
+				public void onDownloadCancel() {
+					LogUtils.d(TAG, "onDownloadCancel");
+				}
+			});
+
+        // 5. 构建广告参数并请求
+        String currentAD_ID = getAD_ID();
+        LogUtils.d(TAG, String.format("currentAD_ID = %s", currentAD_ID));
+        ADParams params = new ADParams.Builder().setUpId(currentAD_ID).build();
+        mBannerAd.loadAd(params, new BannerAd.BannerLoadListener() {
+				@Override
+				public void onBannerAdLoadSuccess() {
+					LogUtils.d(TAG, "onBannerAdLoadSuccess()");
+					// 修复：广告加载成功后校验Activity状态
+					if (activity != null && !activity.isFinishing() && !activity.isDestroyed()) {
+						showAd(activity);
+						//ToastUtils.show("showAd()");
+					}
+				}
+
+				@Override
+				public void onAdLoadFailed(int errorCode, String errorMsg) {
+					String msg = "onAdLoadFailed: errorCode = " + errorCode + ", errorMsg = " + errorMsg;
+					LogUtils.d(TAG, msg);
+					removeAllBanners();
+				}
+			});
+    }
+
+	void removeAllBanners() {
+		// 没有设置米盟广告支持就退出
+		if (ADsControlView.getAdsModeFromStatic(this.mContext) != ADsMode.MIMO_SDK) {
+			return;
+		}
+
+		// 修复：加载失败时移除当前广告实例
+		if (mAllBanners.contains(mBannerAd)) {
+			mAllBanners.remove(mBannerAd);
+		}
+		mBannerAd.destroy();
+		mBannerAd = null;
+	}
+
+    /**
+     * 根据当前秒数获取广告ID（原逻辑保留）
+     */
+    private String getAD_ID() {
+        long currentSecond = System.currentTimeMillis() / 1000;
+        return (currentSecond % 2 == 0) ? BANNER_POS_ID :
+			(GlobalApplication.isDebugging() ? BANNER_POS_ID_WINBOLL_BETA : BANNER_POS_ID_WINBOLL);
+    }
+
+    /**
+     * 获取广告价格（原逻辑保留，添加空指针校验）
+     */
+//    private long getPrice() {
+//        if (mBannerAd == null) {
+//            return 0;
+//        }
+//        Map<String, Object> map = mBannerAd.getMediaExtraInfo();
+//        if (map == null || map.isEmpty() || !map.containsKey("price")) {
+//            LogUtils.w(TAG, "getPrice: media extra info is null or no price key");
+//            return 0;
+//        }
+//        Object priceObj = map.get("price");
+//        if (priceObj instanceof Long) {
+//            return (Long) priceObj;
+//        } else if (priceObj instanceof Integer) {
+//            return ((Integer) priceObj).longValue();
+//        } else {
+//            LogUtils.e(TAG, "getPrice: price type is invalid");
+//            return 0;
+//        }
+//    }
+
+    /**
+     * 显示隐私协议弹窗（原逻辑保留，优化Context使用）
+     */
+//    private void showPrivacy() {
+//        // 校验Activity状态，避免弹窗泄露
+//        if (getActivity() == null || getActivity().isFinishing() || getActivity().isDestroyed()) {
+//            return;
+//        }
+//        ADsMode adsMode = ADsControlView.getAdsModeFromStatic(this.mContext);
+//        if (adsMode == ADsMode.STANDALONE) {
+//			ADsControlView.updateAdsModeByStatic(this.mContext, ADsMode.STANDALONE);
+//            LogUtils.i(TAG, "单机模式，广告已处于不可用状态...");
+//            Toast.makeText(getActivity().getApplicationContext(), "单机模式，广告已处于不可用状态...", Toast.LENGTH_SHORT).show();
+//            return;
+//        } else if (adsMode == ADsMode.MIMO_SDK) {
+//			ADsControlView.updateAdsModeByStatic(this.mContext, ADsMode.MIMO_SDK);
+//            LogUtils.i(TAG, "米盟广告SDK支持模式，现在初始化SDK...");
+//            initMimoSdk();
+//            return;
+//        } 
+//		else {
+//			LogUtils.i(TAG, "开始弹出隐私协议...");
+//			AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
+//			builder.setTitle("用户须知");
+//			builder.setMessage("小米广告SDK隐私政策: https://dev.mi.com/distribute/doc/details?pId=1688, 请复制到浏览器查看");
+//			builder.setIcon(R.drawable.ic_launcher);
+//			builder.setCancelable(false); // 点击对话框以外的区域不消失
+//			builder.setPositiveButton("同意", new DialogInterface.OnClickListener() {
+//					@Override
+//					public void onClick(DialogInterface dialog, int which) {
+//						getSharedPreferences().edit()
+//							.putString(PRIVACY_VALUE, String.valueOf(1))
+//							.apply();
+//						initMimoSdk();
+//						dialog.dismiss();
+//					}
+//				});
+//			builder.setNegativeButton("拒绝", new DialogInterface.OnClickListener() {
+//					@Override
+//					public void onClick(DialogInterface dialog, int which) {
+//						getSharedPreferences().edit()
+//							.putString(PRIVACY_VALUE, String.valueOf(0))
+//							.apply();
+//						dialog.dismiss();
+//					}
+//				});
+//			AlertDialog dialog = builder.create();
+//
+//			// 配置弹窗位置（底部全屏）
+//			Window window = dialog.getWindow();
+//			if (window != null) {
+//				window.setGravity(Gravity.BOTTOM);
+//				WindowManager m = getActivity().getWindowManager();
+//				Display d = m.getDefaultDisplay();
+//				WindowManager.LayoutParams p = window.getAttributes();
+//				p.width = d.getWidth();
+//				window.setAttributes(p);
+//			}
+//			dialog.show();
+//		}
+//    }
+
+    /**
+     * 初始化米盟SDK（核心修复：传递ApplicationContext + 异常捕获）
+     */
+    private void initMimoSdk(Context context) {
+        // 1. 安全获取ApplicationContext，避免Activity Context失效
+        Context appContext = context.getApplicationContext();
+        if (appContext == null) {
+            LogUtils.e(TAG, "initMimoSdk: ApplicationContext is null");
+            return;
+        }
+        // 2. 初始化SDK，捕获异常避免崩溃
+        try {
+            MimoSdk.init(appContext, new MimoCustomController() {
+					@Override
+					public boolean isCanUseLocation() {
+						return true;
+					}
+
+					@Override
+					public MimoLocation getMimoLocation() {
+						return null;
+					}
+
+					@Override
+					public boolean isCanUseWifiState() {
+						return true;
+					}
+
+					@Override
+					public boolean alist() {
+						return true;
+					}
+				}, new MimoSdk.InitCallback() {
+					@Override
+					public void success() {
+						LogUtils.d(TAG, "MimoSdk init success");
+					}
+
+					@Override
+					public void fail(int code, String msg) {
+						LogUtils.e(TAG, "MimoSdk init fail, code=" + code + ",msg=" + msg);
+					}
+				});
+            MimoSdk.setDebugOn(true);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "initMimoSdk: init failed", e);
+        }
+    }
+
+
+    /**
+     * 获取SharedPreferences实例（原逻辑保留，添加空指针校验）
+     */
+//    SharedPreferences getSharedPreferences() {
+////        if (mSharedPreferences == null) {
+////            // 修复：使用ApplicationContext获取SharedPreferences，避免Activity Context泄露
+////            Context appContext = getActivity().getApplicationContext();
+////            if (appContext != null) {
+////                mSharedPreferences = appContext.getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
+////            } else {
+////                LogUtils.e(TAG, "getSharedPreferences: ApplicationContext is null");
+////                // 降级方案：若ApplicationContext为空，使用Activity Context（仅作兼容）
+////                mSharedPreferences = getActivity().getSharedPreferences(PRIVACY_FILE, Context.MODE_PRIVATE);
+////            }
+////        }
+//        return mSharedPreferences;
+//    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/ADsControlView.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/ADsControlView.java
new file mode 100644
index 0000000..c24efca
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/ADsControlView.java
@@ -0,0 +1,633 @@
+package cc.winboll.studio.libaes.views;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.drawable.BitmapDrawable;
+import android.graphics.drawable.Drawable;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
+import android.text.Html;
+import android.util.AttributeSet;
+import android.view.Display;
+import android.view.Gravity;
+import android.view.LayoutInflater;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.Button;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.PopupMenu;
+import android.widget.PopupWindow;
+import android.widget.RadioButton;
+import android.widget.RadioGroup;
+import android.widget.RelativeLayout;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.app.AlertDialog;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.enums.ADsMode;
+import cc.winboll.studio.libaes.enums.PrivacyAgreeStatus;
+import cc.winboll.studio.libaes.utils.WebUtils;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import com.miui.zeus.mimo.sdk.MimoCustomController;
+import com.miui.zeus.mimo.sdk.MimoLocation;
+import com.miui.zeus.mimo.sdk.MimoSdk;
+import java.lang.reflect.Field;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/26 17:51
+ * @LastEditTime 2026/01/08 11:00:00 HKT
+ * @Describe 广告模式控制控件（Java 7 兼容，云宝物语模式）
+ * 核心修改：将PopupMenu锚点绑定到view_popmenu_anchor_point控件，菜单精准显示在锚点位置
+ */
+public class ADsControlView extends LinearLayout {
+    public static final String TAG = "ADsControlView";
+
+    // SP存储配置
+    private static final String SP_NAME = "ads_control_config";
+    private static final String KEY_SELECTED_MODE = "selected_ads_mode";
+    ADsMode mADsMode;
+    private static final String PRIVACY_VALUE = "privacy_value";
+    PrivacyAgreeStatus mPrivacyAgreeStatus;
+
+    // Handler消息标识
+    private static final int MSG_UPDATE_MODE = 1001;
+
+    // 控件引用
+    private RadioGroup rgADsMode;
+    private RadioButton rbStandalone;
+    private RadioButton rbMimoSDK;
+    private RadioButton rbStoreQrcode;
+    private RelativeLayout rlWinbollStore;
+    private ImageView ivWinbollStoreQrcode;
+    // 新增：锚点控件引用
+    private TextView viewPopmenuAnchorPoint;
+
+    // 外部监听、SP实例、Handler实例
+    private OnAdsModeSelectedListener listener;
+    private SharedPreferences sharedPreferences;
+    private InternalHandler mHandler;
+    private Context mContext;
+
+    // 静态列表：存储所有已创建的控件实例
+    private static final java.util.List<ADsControlView> sControlViews = new java.util.ArrayList<ADsControlView>();
+
+    // 常量定义
+    private static final String WECHAT_STORE_URL = "https://store.weixin.qq.com/shop/b/XhrPkZgoeHo4zug";
+    private static final int MENU_ITEM_OPEN_STORE = 1001;
+
+    // 构造方法（Java 7 兼容）
+    public ADsControlView(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public ADsControlView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    @SuppressWarnings("deprecation")
+    public ADsControlView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    public void setPrivacyAgreeStatus(PrivacyAgreeStatus privacyAgreeStatus) {
+        this.mPrivacyAgreeStatus = privacyAgreeStatus;
+        sharedPreferences.edit().putString(PRIVACY_VALUE, this.mPrivacyAgreeStatus.name()).apply();
+    }
+
+    public PrivacyAgreeStatus getPrivacyAgreeStatus() {
+        String privacyAgreeStatusStr = sharedPreferences.getString(PRIVACY_VALUE, PrivacyAgreeStatus.UN_SIGNED.name());
+        PrivacyAgreeStatus privacyAgreeStatus = PrivacyAgreeStatus.fromString(privacyAgreeStatusStr);
+        return privacyAgreeStatus;
+    }
+
+    public void setADsMode(ADsMode mADsMode) {
+        this.mADsMode = mADsMode;
+        sharedPreferences.edit().putString(KEY_SELECTED_MODE, this.mADsMode.name()).apply();
+        updateStoreQrcodeLayoutVisibility(mADsMode);
+    }
+
+    public ADsMode getADsMode() {
+        String savedModeStr = sharedPreferences.getString(KEY_SELECTED_MODE, ADsMode.STANDALONE.name());
+        mADsMode = ADsMode.fromValue(savedModeStr);
+        return mADsMode;
+    }
+
+    /**
+     * 初始化视图、SP、Handler
+     */
+    private void initView(final Context context) {
+        this.mContext = context;
+
+        // 加载布局
+        LayoutInflater.from(context).inflate(R.layout.view_adscontrol, this, true);
+
+        // 初始化SP
+        sharedPreferences = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+
+        // 绑定控件
+        rgADsMode = (RadioGroup) findViewById(R.id.rg_ads_mode);
+        rbStandalone = (RadioButton) findViewById(R.id.rb_standalone);
+        rbMimoSDK = (RadioButton) findViewById(R.id.rb_mimo_sdk);
+        rbStoreQrcode = (RadioButton) findViewById(R.id.rb_store_qrcode);
+        rlWinbollStore = (RelativeLayout) findViewById(R.id.rl_winboll_store);
+        ivWinbollStoreQrcode = (ImageView) findViewById(R.id.iv_winboll_store);
+        // 绑定锚点控件
+        viewPopmenuAnchorPoint = (TextView) findViewById(R.id.view_popmenu_anchor_point);
+
+        // 初始化Handler
+        mHandler = new InternalHandler(Looper.getMainLooper());
+
+        // 核心修改：初始化图片的点击和长按事件（锚点改为view_popmenu_anchor_point）
+        initImageViewClickAndLongClick();
+
+        // 注册控件实例
+        registerControlView(this);
+
+        // 从SP读取初始模式
+        setSelectedMode(getADsMode());
+
+        // 单选组选择事件监听
+        rgADsMode.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(RadioGroup group, int checkedId) {
+					if (checkedId == R.id.rb_standalone) {
+						setADsMode(ADsMode.STANDALONE);
+						if (listener != null) listener.onModeSelected(ADsMode.STANDALONE);
+					} else if (checkedId == R.id.rb_mimo_sdk) {
+						handlePrivacyLogic((Activity) context, PrivacyAgreeStatus.UN_SIGNED, new OnPrivacyChangeListener() {
+								@Override
+								public void onAgreePrivacy() {
+									setADsMode(ADsMode.MIMO_SDK);
+									if (listener != null) listener.onModeSelected(ADsMode.MIMO_SDK);
+								}
+
+								@Override
+								public void onDisagreePrivacy() {
+									setADsMode(ADsMode.STANDALONE);
+									setSelectedMode(ADsMode.STANDALONE);
+									if (listener != null) listener.onModeSelected(ADsMode.STANDALONE);
+								}
+							});
+					} else if (checkedId == R.id.rb_store_qrcode) {
+						setADsMode(ADsMode.STORE_QRCODE);
+						if (listener != null) listener.onModeSelected(ADsMode.STORE_QRCODE);
+					}
+				}
+			});
+    }
+
+    /**
+     * 初始化图片的点击和长按事件
+     * 核心：将PopupMenu锚点绑定到view_popmenu_anchor_point控件
+     */
+    private void initImageViewClickAndLongClick() {
+        if (ivWinbollStoreQrcode == null || viewPopmenuAnchorPoint == null) {
+            LogUtils.e(TAG, "initImageViewClickAndLongClick: 控件引用为空");
+            return;
+        }
+
+        // 1. 点击事件：简化为提示信息
+        ivWinbollStoreQrcode.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					ToastUtils.show("长按图片可打开微信小店");
+					LogUtils.d(TAG, "图片点击：提示用户长按打开微信小店");
+				}
+			});
+
+        // 2. 长按事件：锚点改为view_popmenu_anchor_point
+        ivWinbollStoreQrcode.setOnLongClickListener(new OnLongClickListener() {
+				@Override
+				public boolean onLongClick(View v) {
+					// 计算锚点控件的屏幕坐标（用于菜单位置微调）
+					int[] anchorLocation = new int[2];
+					viewPopmenuAnchorPoint.getLocationOnScreen(anchorLocation);
+					final int anchorX = anchorLocation[0];
+					final int anchorY = anchorLocation[1];
+
+					// 创建PopupMenu，锚点绑定到view_popmenu_anchor_point
+					PopupMenu popupMenu = new PopupMenu(mContext, viewPopmenuAnchorPoint);
+					// 设置菜单重力：相对锚点居中显示
+					popupMenu.setGravity(Gravity.CENTER);
+
+					Menu menu = popupMenu.getMenu();
+					menu.add(Menu.NONE, MENU_ITEM_OPEN_STORE, Menu.NONE, "打开微信小店");
+
+					// 设置菜单点击事件
+					popupMenu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
+							@Override
+							public boolean onMenuItemClick(MenuItem item) {
+								if (item.getItemId() == MENU_ITEM_OPEN_STORE) {
+									WebUtils.openUrlInBrowser(mContext, WECHAT_STORE_URL);
+									return true;
+								}
+								return false;
+							}
+						});
+
+					try {
+						// 反射获取PopupWindow，微调菜单位置（可选）
+						Field popupField = PopupMenu.class.getDeclaredField("mPopup");
+						popupField.setAccessible(true);
+						Object popupObject = popupField.get(popupMenu);
+						if (popupObject instanceof PopupWindow) {
+							final PopupWindow popupWindow = (PopupWindow) popupObject;
+							popupWindow.setAnimationStyle(0); // 关闭默认动画
+
+							// 延迟微调菜单位置（确保布局测量完成）
+							new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+									@Override
+									public void run() {
+										int menuX = anchorX + viewPopmenuAnchorPoint.getWidth() / 2 - popupWindow.getWidth() / 2;
+										int menuY = anchorY + viewPopmenuAnchorPoint.getHeight() / 2 - popupWindow.getHeight() / 2;
+										if (!popupWindow.isShowing()) {
+											popupWindow.showAtLocation(viewPopmenuAnchorPoint, Gravity.NO_GRAVITY, menuX, menuY);
+										}
+									}
+								}, 30);
+						}
+					} catch (NoSuchFieldException | IllegalAccessException e) {
+						LogUtils.e(TAG, "反射获取PopupWindow失败", e);
+					}
+
+					// 显示菜单
+					popupMenu.show();
+					LogUtils.d(TAG, "长按图片，菜单锚点为view_popmenu_anchor_point");
+					return true;
+				}
+			});
+
+        // 设置控件可交互标识
+        ivWinbollStoreQrcode.setClickable(true);
+        ivWinbollStoreQrcode.setFocusable(true);
+        ivWinbollStoreQrcode.setLongClickable(true);
+        viewPopmenuAnchorPoint.setClickable(false); // 锚点控件不可点击
+        viewPopmenuAnchorPoint.setLongClickable(false);
+    }
+
+    /**
+     * 从ImageView中提取Bitmap（保留方法，无实际调用）
+     */
+    private Bitmap getBitmapFromImageView(ImageView imageView) {
+        Drawable drawable = imageView.getDrawable();
+        if (drawable instanceof BitmapDrawable) {
+            return ((BitmapDrawable) drawable).getBitmap();
+        }
+        return null;
+    }
+
+    /**
+     * 压缩Bitmap（备用方法，无实际调用）
+     */
+    private Bitmap compressBitmapBySize(Bitmap src, int maxWidth, int maxHeight) {
+        if (src == null) return null;
+        int width = src.getWidth();
+        int height = src.getHeight();
+        float scale = Math.min((float) maxWidth / width, (float) maxHeight / height);
+        int newWidth = (int) (width * scale);
+        int newHeight = (int) (height * scale);
+        return Bitmap.createScaledBitmap(src, newWidth, newHeight, true);
+    }
+
+    /**
+     * 计算Bitmap采样率（备用方法，无实际调用）
+     */
+    private int calculateInSampleSize(BitmapFactory.Options options, int reqWidth, int reqHeight) {
+        final int height = options.outHeight;
+        final int width = options.outWidth;
+        int inSampleSize = 1;
+        if (height > reqHeight || width > reqWidth) {
+            final int halfHeight = height / 2;
+            final int halfWidth = width / 2;
+            while ((halfHeight / inSampleSize) >= reqHeight && (halfWidth / inSampleSize) >= reqWidth) {
+                inSampleSize *= 2;
+            }
+        }
+        return inSampleSize;
+    }
+
+    /**
+     * 从ImageView反射获取资源ID（备用方法，无实际调用）
+     */
+    private int getResIdFromImageView(ImageView imageView) {
+        try {
+            Field field = ImageView.class.getDeclaredField("mSrcResource");
+            field.setAccessible(true);
+            return field.getInt(imageView);
+        } catch (NoSuchFieldException | IllegalAccessException e) {
+            LogUtils.e(TAG, "getResIdFromImageView: 反射失败", e);
+            return 0;
+        }
+    }
+
+    /**
+     * 更新二维码布局显示状态
+     */
+    private void updateStoreQrcodeLayoutVisibility(ADsMode mode) {
+        if (rlWinbollStore == null) return;
+        rlWinbollStore.setVisibility(mode == ADsMode.STORE_QRCODE ? View.VISIBLE : View.GONE);
+    }
+
+    /**
+     * 清理SP中的隐私协议状态
+     */
+    public static void cleanPrivacyStatus(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "cleanPrivacyStatus: Context is null");
+            return;
+        }
+        SharedPreferences sp = getPrivacySharedPreferences(context);
+        sp.edit().remove(PRIVACY_VALUE).apply();
+        LogUtils.i(TAG, "隐私协议状态清理成功");
+        ToastUtils.show("隐私协议状态已清理");
+    }
+
+    /**
+     * 获取隐私协议SP实例
+     */
+    private static SharedPreferences getPrivacySharedPreferences(Context context) {
+        Context appContext = context.getApplicationContext();
+        if (appContext != null) {
+            return appContext.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        }
+        return context.getSharedPreferences(PRIVACY_VALUE, Context.MODE_PRIVATE);
+    }
+
+    /**
+     * 处理隐私协议逻辑
+     */
+    private static void handlePrivacyLogic(final Activity activity, PrivacyAgreeStatus privacyAgreeStatus, final OnPrivacyChangeListener onPrivacyChangeListener) {
+        if (privacyAgreeStatus == PrivacyAgreeStatus.REJECTED) {
+            Toast.makeText(activity.getApplicationContext(), "已拒绝隐私协议，广告已处于不可用状态", Toast.LENGTH_SHORT).show();
+            return;
+        } else if (privacyAgreeStatus == PrivacyAgreeStatus.AGREED) {
+            initMimoSdkStatic(activity.getApplicationContext());
+            return;
+        } else {
+            AlertDialog dialog = createPrivacyDialog(activity, onPrivacyChangeListener);
+            Window window = dialog.getWindow();
+            if (window != null) {
+                window.setGravity(Gravity.BOTTOM);
+                WindowManager m = activity.getWindowManager();
+                Display d = m.getDefaultDisplay();
+                WindowManager.LayoutParams p = window.getAttributes();
+                p.width = d.getWidth();
+                window.setAttributes(p);
+            }
+            dialog.show();
+        }
+    }
+
+    /**
+     * 初始化米盟SDK
+     */
+    private static void initMimoSdkStatic(Context appContext) {
+        if (appContext == null) return;
+        try {
+            MimoSdk.init(appContext, new MimoCustomController() {
+					@Override
+					public boolean isCanUseLocation() {
+						return true;
+					}
+
+					@Override
+					public MimoLocation getMimoLocation() {
+						return null;
+					}
+
+					@Override
+					public boolean isCanUseWifiState() {
+						return true;
+					}
+
+					@Override
+					public boolean alist() {
+						return true;
+					}
+				}, new MimoSdk.InitCallback() {
+					@Override
+					public void success() {
+						LogUtils.d(TAG, "米盟SDK初始化成功");
+					}
+
+					@Override
+					public void fail(int code, String msg) {
+						LogUtils.e(TAG, "米盟SDK初始化失败：" + code + ", " + msg);
+					}
+				});
+            MimoSdk.setDebugOn(true);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "米盟SDK初始化异常", e);
+        }
+    }
+
+    /**
+     * 静态方法：更新SP中的模式
+     */
+    public static void updateAdsModeByStatic(Context context, ADsMode mode) {
+        if (context == null || mode == null) return;
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        sp.edit().putString(KEY_SELECTED_MODE, mode.name()).apply();
+        InternalHandler.sendUpdateModeMessage(mode);
+    }
+
+    /**
+     * 静态方法：读取SP中的模式
+     */
+    public static ADsMode getAdsModeFromStatic(Context context) {
+        if (context == null) return ADsMode.STANDALONE;
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        String savedModeStr = sp.getString(KEY_SELECTED_MODE, ADsMode.STANDALONE.name());
+        return ADsMode.fromValue(savedModeStr);
+    }
+
+    /**
+     * 注册控件实例
+     */
+    private static void registerControlView(ADsControlView view) {
+        synchronized (sControlViews) {
+            if (!sControlViews.contains(view)) {
+                sControlViews.add(view);
+            }
+        }
+    }
+
+    /**
+     * 移除控件实例
+     */
+    private static void unregisterControlView(ADsControlView view) {
+        synchronized (sControlViews) {
+            sControlViews.remove(view);
+        }
+    }
+
+    /**
+     * 设置选中模式
+     */
+    private void setSelectedMode(final ADsMode mode) {
+        final ADsMode mode2 = (mode == null) ? ADsMode.STANDALONE : mode;
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            if (mode2 == ADsMode.STANDALONE) {
+                rbStandalone.setChecked(true);
+            } else if (mode2 == ADsMode.MIMO_SDK) {
+                rbMimoSDK.setChecked(true);
+            } else if (mode2 == ADsMode.STORE_QRCODE) {
+                rbStoreQrcode.setChecked(true);
+            }
+            updateStoreQrcodeLayoutVisibility(mode2);
+        } else {
+            mHandler.post(new Runnable() {
+					@Override
+					public void run() {
+						setSelectedMode(mode2);
+					}
+				});
+        }
+    }
+
+    /**
+     * 获取选中模式
+     */
+    public ADsMode getSelectedMode() {
+        int checkedId = rgADsMode.getCheckedRadioButtonId();
+        if (checkedId == R.id.rb_mimo_sdk) {
+            return ADsMode.MIMO_SDK;
+        } else if (checkedId == R.id.rb_store_qrcode) {
+            return ADsMode.STORE_QRCODE;
+        } else {
+            return ADsMode.STANDALONE;
+        }
+    }
+
+    /**
+     * 设置外部监听
+     */
+    public void setOnAdsModeSelectedListener(OnAdsModeSelectedListener listener) {
+        this.listener = listener;
+    }
+
+    /**
+     * 内部Handler类
+     */
+    private static class InternalHandler extends Handler {
+        static volatile InternalHandler _InternalHandler;
+
+        public InternalHandler(Looper looper) {
+            super(looper);
+            _InternalHandler = this;
+        }
+
+        public static void sendUpdateModeMessage(ADsMode mode) {
+            if (mode == null || _InternalHandler == null) return;
+            Message msg = _InternalHandler.obtainMessage();
+            msg.what = MSG_UPDATE_MODE;
+            msg.obj = mode;
+            _InternalHandler.sendMessage(msg);
+        }
+
+        @Override
+        public void handleMessage(Message msg) {
+            super.handleMessage(msg);
+            if (msg.what == MSG_UPDATE_MODE) {
+                ADsMode mode = (ADsMode) msg.obj;
+                if (mode == null) return;
+                synchronized (sControlViews) {
+                    for (ADsControlView view : sControlViews) {
+                        if (view != null && view.isShown() && view.isAttachedToWindow()) {
+                            view.setSelectedMode(mode);
+                            view.updateStoreQrcodeLayoutVisibility(mode);
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    /**
+     * 生命周期：控件销毁
+     */
+    @Override
+    protected void onDetachedFromWindow() {
+        super.onDetachedFromWindow();
+        if (mHandler != null) {
+            mHandler.removeCallbacksAndMessages(null);
+        }
+        unregisterControlView(this);
+    }
+
+    /**
+     * 外部监听接口
+     */
+    public interface OnAdsModeSelectedListener {
+        void onModeSelected(ADsMode selectedMode);
+    }
+
+    /**
+     * 隐私协议监听接口
+     */
+    public interface OnPrivacyChangeListener {
+        void onAgreePrivacy();
+        void onDisagreePrivacy();
+    }
+
+    /**
+     * 创建隐私协议对话框
+     */
+    private static AlertDialog createPrivacyDialog(final Activity activity, final OnPrivacyChangeListener onPrivacyChangeListener) {
+        View dialogView = LayoutInflater.from(activity).inflate(R.layout.dialog_privacy_agreement, null);
+        AlertDialog.Builder builder = new AlertDialog.Builder(activity);
+        builder.setView(dialogView).setCancelable(false);
+        final AlertDialog dialog = builder.create();
+
+        final TextView tvPrivacyUrl = (TextView) dialogView.findViewById(R.id.tv_privacy_url);
+        Button btnAgree = (Button) dialogView.findViewById(R.id.btn_agree);
+        Button btnDisagree = (Button) dialogView.findViewById(R.id.btn_disagree);
+
+        tvPrivacyUrl.setText(Html.fromHtml("<u>" + tvPrivacyUrl.getText().toString() + "</u>"));
+        tvPrivacyUrl.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					String url = tvPrivacyUrl.getText().toString().trim();
+					ToastUtils.show("隐私协议链接：" + url);
+				}
+			});
+        tvPrivacyUrl.setClickable(true);
+        tvPrivacyUrl.setFocusable(true);
+
+        btnAgree.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					if (onPrivacyChangeListener != null) {
+						onPrivacyChangeListener.onAgreePrivacy();
+					}
+					dialog.dismiss();
+				}
+			});
+
+        btnDisagree.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					if (onPrivacyChangeListener != null) {
+						onPrivacyChangeListener.onDisagreePrivacy();
+					}
+					dialog.dismiss();
+				}
+			});
+
+        return dialog;
+    }
+}
+
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/AOHPCTCSeekBar.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/AOHPCTCSeekBar.java
new file mode 100644
index 0000000..432fbde
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/AOHPCTCSeekBar.java
@@ -0,0 +1,108 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:46:30
+ * @Describe AOneHundredPercantClickToCommitSeekBar
+ */
+import android.content.Context;
+import android.graphics.drawable.Drawable;
+import android.util.AttributeSet;
+import android.view.MotionEvent;
+import android.widget.SeekBar;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class AOHPCTCSeekBar extends SeekBar {
+
+    public static final String TAG = "AOHPCTCSeekBar";
+
+    volatile int thumbWidth = 1;
+    volatile int progressBarWidth = 1;
+    // 设置按钮模糊右边边缘像素
+    volatile int blurRightDP = 1;
+    // 是否从起点拉动的标志
+    volatile boolean isStartSeek = false;
+
+    // 外部接口对象，确定事件提交会调用该对象的方法
+    OnOHPCListener mOnOHPCListener;
+
+
+    public void setBlurRightDP(int blurRight) {
+        this.blurRightDP = blurRight;
+    }
+
+    public void setOnOHPCListener(OnOHPCListener listener) {
+        mOnOHPCListener = listener;
+    }
+
+    public interface OnOHPCListener {
+        abstract void onOHPCommit();
+    } 
+
+    public AOHPCTCSeekBar(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public AOHPCTCSeekBar(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    public AOHPCTCSeekBar(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    void initView(Context context) {
+    }
+
+    @Override
+    public boolean dispatchTouchEvent(MotionEvent event) {
+        if (event.getAction() == MotionEvent.ACTION_DOWN) {
+            if (thumbWidth + blurRightDP > event.getX() && event.getX() > 0) {
+                getParent().requestDisallowInterceptTouchEvent(true);
+                isStartSeek = true;
+            }
+        } else if (event.getAction() == MotionEvent.ACTION_MOVE) {
+            if (isStartSeek) {
+                super.dispatchTouchEvent(event);
+            }
+        } else if (event.getAction() == MotionEvent.ACTION_UP 
+                   || event.getAction() == MotionEvent.ACTION_CANCEL) {
+            getParent().requestDisallowInterceptTouchEvent(false);
+            if (getProgress() == progressBarWidth) {
+                mOnOHPCListener.onOHPCommit();
+            }
+            // 重置控件状态
+            setProgress(0);
+            isStartSeek = false;
+        }
+        return true;
+    }
+
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
+        int width = MeasureSpec.getSize(widthMeasureSpec);
+        //int height = MeasureSpec.getSize(heightMeasureSpec);
+        //LogUtils.d(TAG, String.format("width %d height %d", width, height));
+
+        // 获取SeekBar的图标宽度
+        Drawable thumbDrawable = getThumb();
+        if (thumbDrawable != null) {
+            // 获取图标宽度
+            thumbWidth = thumbDrawable.getIntrinsicWidth();
+        }
+
+        // 获取进度条宽度
+        progressBarWidth = width;
+
+        //LogUtils.d(TAG, String.format("thumbWidth %d progressBarWidth %d", thumbWidth, progressBarWidth));
+
+        // 设置图标位置
+        setThumbOffset(0);
+        // 设置进度条刻度
+        setMax(progressBarWidth);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/AOHPCTSCard.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/AOHPCTSCard.java
new file mode 100644
index 0000000..a7120ea
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/AOHPCTSCard.java
@@ -0,0 +1,43 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:49:23
+ * @Describe AOneHundredPercantClickToStartCard
+ */
+import android.content.Context;
+import android.util.AttributeSet;
+
+public class AOHPCTSCard extends ACard {
+
+    public static final String TAG = "AOHPCTSCard";
+
+    public AOHPCTSCard(Context context) {
+        super(context);
+    }
+
+    public AOHPCTSCard(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        //setPadding(0 + 0 + 2 + 1, 0 + 0 + 2 + 1, 0 + 1 + 3 + 1, 0 + 2 + 3 + 1);
+
+        // 获得TypedArray
+        //TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.AToolbar);
+        // 获得attrs.xml里面的属性值,格式为:名称_属性名,后面是默认值
+        //int colorBackgroud = a.getColor(R.styleable.ACard_backgroudColor, context.getColor(R.color.colorACardBackgroung));
+        //int centerColor = a.getColor(R.styleable.AToolbar_centerColor, context.getColor(R.color.colorAToolbarCenterColor));
+        //int endColor = a.getColor(R.styleable.AToolbar_endColor, context.getColor(R.color.colorAToolbarEndColor));
+        //float tSize = a.getDimension(R.styleable.CustomView_tSize, 35);
+        //p.setColor(tColor);
+        //p.setTextSize(tSize);
+        //Drawable drawable = context.getDrawable(R.drawable.frame_atoolbar);
+
+        //setBackground(context.getDrawable(R.drawable.acard_frame_main));
+
+        // 返回一个绑定资源结束的信号给资源
+        //a.recycle();
+    }
+
+    public AOHPCTSCard(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/ASupportToolbar.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/ASupportToolbar.java
new file mode 100644
index 0000000..0c55384
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/ASupportToolbar.java
@@ -0,0 +1,93 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:54:40
+ * @Describe ASupportToolbar
+ */
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.Color;
+import android.graphics.drawable.GradientDrawable;
+import android.graphics.drawable.LayerDrawable;
+import android.util.AttributeSet;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.R;
+import android.graphics.drawable.Drawable;
+import androidx.core.content.ContextCompat;
+import android.graphics.PorterDuff;
+
+public class ASupportToolbar extends Toolbar {
+
+    public static final String TAG = "ASupportToolbar";
+
+    int mTitleTextColor;
+    int mStartColor;
+    int mCenterColor;
+    int mEndColor;
+    LayerDrawable ld;
+    GradientDrawable[] array = new GradientDrawable[3];
+    //private GradientDrawable gradientDrawable;
+
+    public ASupportToolbar(Context context) {
+        super(context);
+    }
+
+    public ASupportToolbar(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.ASupportToolbar, R.attr.aSupportToolbar, 0);
+        mTitleTextColor = a.getColor(R.styleable.ASupportToolbar_attrASupportToolbarTitleTextColor, Color.GREEN);
+        mStartColor = a.getColor(R.styleable.ASupportToolbar_attrASupportToolbarStartColor, Color.BLUE);
+        mCenterColor = a.getColor(R.styleable.ASupportToolbar_attrASupportToolbarCenterColor, Color.RED);
+        mEndColor = a.getColor(R.styleable.ASupportToolbar_attrASupportToolbarEndColor, Color.YELLOW);
+        // 返回一个绑定资源结束的信号给资源
+        a.recycle();
+        notifyColorChange();
+    }
+
+    void notifyColorChange() {
+        // 工具栏描边
+        int nStroke = 5;
+
+        TypedArray taBorder = getContext().obtainStyledAttributes(new int[]{R.attr.borderCornerRadius});
+        float cornerRadius = taBorder.getDimension(0, 6 * getResources().getDisplayMetrics().density);
+        taBorder.recycle();
+
+        //分别为开始颜色，中间夜色，结束颜色
+        int colors0[] = { mEndColor , mCenterColor,  mStartColor};
+        GradientDrawable gradientDrawable0;
+        array[2] = new GradientDrawable(GradientDrawable.Orientation.TOP_BOTTOM, colors0);
+        gradientDrawable0 = array[2];
+        gradientDrawable0.setShape(GradientDrawable.RECTANGLE);
+        gradientDrawable0.setColors(colors0); //添加颜色组
+        gradientDrawable0.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
+        gradientDrawable0.setCornerRadius(cornerRadius);
+
+        int colors1[] = { mCenterColor , mCenterColor, mCenterColor };
+        GradientDrawable gradientDrawable1;
+        array[1] = new GradientDrawable(GradientDrawable.Orientation.TOP_BOTTOM, colors1);
+        gradientDrawable1 = array[1];
+        gradientDrawable1.setShape(GradientDrawable.RECTANGLE);
+        gradientDrawable1.setColors(colors1); //添加颜色组
+        gradientDrawable1.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
+        gradientDrawable1.setCornerRadius(cornerRadius);
+
+        int colors2[] = {  mEndColor, mCenterColor, mStartColor };
+        GradientDrawable gradientDrawable2;
+        array[0] = new GradientDrawable(GradientDrawable.Orientation.TOP_BOTTOM, colors2);
+        gradientDrawable2 = array[0];
+        gradientDrawable2.setShape(GradientDrawable.RECTANGLE);
+        gradientDrawable2.setColors(colors2); //添加颜色组
+        gradientDrawable2.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
+        gradientDrawable2.setCornerRadius(cornerRadius);
+
+        ld = new LayerDrawable(array); //参数为上面的Drawable数组
+        ld.setLayerInset(2, nStroke * 2, nStroke * 2, getWidth() + nStroke * 2, getHeight() + nStroke * 2); 
+        ld.setLayerInset(1, nStroke, nStroke, getWidth() + nStroke, getHeight() + nStroke); 
+        ld.setLayerInset(0, 0, 0, getWidth(), getHeight()); 
+
+        setBackgroundDrawable(ld);
+        setTitleTextColor(mTitleTextColor);
+        setSubtitleTextColor(mTitleTextColor);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/ATickProgressBar.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/ATickProgressBar.java
new file mode 100644
index 0000000..ddba22b
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/ATickProgressBar.java
@@ -0,0 +1,55 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:56:38
+ * @Describe ATickProgressBar
+ */
+import android.content.Context;
+import android.os.Handler;
+import android.util.AttributeSet;
+import android.widget.ProgressBar;
+
+public class ATickProgressBar extends ProgressBar {
+
+    public static final String TAG = "ATickProgressBar";
+
+    int mnStepDistantce = 100 / 10;
+    int mnProgress = 0;
+
+    public ATickProgressBar(Context context) {
+        super(context);
+
+    }
+
+    public ATickProgressBar(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        setProgress(50);
+    }
+
+    public int stepOnTick(int nStepDistantce) {
+        if (mnProgress < 100) {
+            int nProgressOld = mnProgress;
+            mnProgress += nStepDistantce;
+            new Handler().postDelayed(new Runnable(){
+
+                    @Override
+                    public void run() {
+                        ;
+                    }
+                }, 1000);
+            return nProgressOld;
+        } else {
+            return mnProgress;
+        }
+    }
+
+    /*@Override
+     protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+     super.onMeasure(widthMeasureSpec, heightMeasureSpec);
+     int nWidthSize = MeasureSpec.getSize(widthMeasureSpec);
+     int nHeightSize = MeasureSpec.getSize(heightMeasureSpec);
+
+     setMeasuredDimension(nWidthSize, nHeightSize);
+     }*/
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/AToolbar.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/AToolbar.java
new file mode 100644
index 0000000..dac29ae
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/AToolbar.java
@@ -0,0 +1,96 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/16 01:58:01
+ * @Describe AToolbar
+ */
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.Color;
+import android.graphics.drawable.GradientDrawable;
+import android.graphics.drawable.LayerDrawable;
+import android.util.AttributeSet;
+import android.widget.Toolbar;
+import cc.winboll.studio.libaes.R;
+
+public class AToolbar extends Toolbar {
+
+    public static final String TAG = "AToolbar";
+    
+    int mTitleTextColor;
+    int mStartColor;
+    int mCenterColor;
+    int mEndColor;
+    LayerDrawable ld;
+    GradientDrawable[] array = new GradientDrawable[3];
+
+    public AToolbar(Context context) {
+        super(context);
+    }
+
+    public AToolbar(Context context, AttributeSet attrs) {
+        super(context, attrs);
+
+        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.AToolbar, R.attr.aToolbar, 0);
+        mTitleTextColor = a.getColor(R.styleable.AToolbar_attrAToolbarTitleTextColor, Color.GREEN);
+        mStartColor = a.getColor(R.styleable.AToolbar_attrAToolbarStartColor, Color.BLUE);
+        mCenterColor = a.getColor(R.styleable.AToolbar_attrAToolbarCenterColor, Color.RED);
+        mEndColor = a.getColor(R.styleable.AToolbar_attrAToolbarEndColor, Color.YELLOW);
+        // 返回一个绑定资源结束的信号给资源
+        a.recycle();
+        
+        notifyColorChange();
+    }
+
+    public AToolbar(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    void notifyColorChange() {
+        // 工具栏描边
+        int nStroke = 5;
+
+        TypedArray taBorder = getContext().obtainStyledAttributes(new int[]{R.attr.borderCornerRadius});
+        float cornerRadius = taBorder.getDimension(0, 6 * getResources().getDisplayMetrics().density);
+        taBorder.recycle();
+
+        //分别为开始颜色，中间夜色，结束颜色
+        int colors0[] = { mEndColor , mCenterColor,  mStartColor};
+        GradientDrawable gradientDrawable0;
+        array[2] = new GradientDrawable(GradientDrawable.Orientation.TOP_BOTTOM, colors0);
+        gradientDrawable0 = array[2];
+        gradientDrawable0.setShape(GradientDrawable.RECTANGLE);
+        gradientDrawable0.setColors(colors0); //添加颜色组
+        gradientDrawable0.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
+        gradientDrawable0.setCornerRadius(cornerRadius);
+
+        int colors1[] = { mCenterColor , mCenterColor, mCenterColor };
+        GradientDrawable gradientDrawable1;
+        array[1] = new GradientDrawable(GradientDrawable.Orientation.TOP_BOTTOM, colors1);
+        gradientDrawable1 = array[1];
+        gradientDrawable1.setShape(GradientDrawable.RECTANGLE);
+        gradientDrawable1.setColors(colors1); //添加颜色组
+        gradientDrawable1.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
+        gradientDrawable1.setCornerRadius(cornerRadius);
+
+        int colors2[] = {  mEndColor, mCenterColor, mStartColor };
+        GradientDrawable gradientDrawable2;
+        array[0] = new GradientDrawable(GradientDrawable.Orientation.TOP_BOTTOM, colors2);
+        gradientDrawable2 = array[0];
+        gradientDrawable2.setShape(GradientDrawable.RECTANGLE);
+        gradientDrawable2.setColors(colors2); //添加颜色组
+        gradientDrawable2.setGradientType(GradientDrawable.LINEAR_GRADIENT);//设置线性渐变
+        gradientDrawable2.setCornerRadius(cornerRadius);
+
+
+        ld = new LayerDrawable(array); //参数为上面的Drawable数组
+        ld.setLayerInset(2, nStroke * 2, nStroke * 2, getWidth() + nStroke * 2, getHeight() + nStroke * 2); 
+        ld.setLayerInset(1, nStroke, nStroke, getWidth() + nStroke, getHeight() + nStroke); 
+        ld.setLayerInset(0, 0, 0, getWidth(), getHeight()); 
+
+        setBackgroundDrawable(ld);
+        setTitleTextColor(mTitleTextColor);
+        setSubtitleTextColor(mTitleTextColor);
+    }
+}
diff --git a/libaes/src/main/java/cc/winboll/studio/libaes/views/AboutView.java b/libaes/src/main/java/cc/winboll/studio/libaes/views/AboutView.java
new file mode 100644
index 0000000..9f5ed56
--- /dev/null
+++ b/libaes/src/main/java/cc/winboll/studio/libaes/views/AboutView.java
@@ -0,0 +1,379 @@
+package cc.winboll.studio.libaes.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/24 15:08:52
+ * @Describe WinBoLL应用介绍视图
+ */
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.content.res.TypedArray;
+import android.net.Uri;
+import android.os.Message;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import cc.winboll.studio.libaes.R;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libaes.models.APPInfo;
+import cc.winboll.studio.libaes.utils.AppVersionUtils;
+import cc.winboll.studio.libaes.utils.PrefUtils;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.io.IOException;
+import mehdi.sakout.aboutpage.AboutPage;
+import mehdi.sakout.aboutpage.Element;
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.Credentials;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+public class AboutView extends LinearLayout {
+
+    public static final String TAG = "AboutView";
+
+    public static final int MSG_APPUPDATE_CHECKED = 0;
+
+    static Context _mContext;
+    APPInfo mAPPInfo;
+
+    //WinBoLLServiceStatusView mWinBoLLServiceStatusView;
+    OnRequestDevUserInfoAutofillListener mOnRequestDevUserInfoAutofillListener;
+    String mszAppName = "";
+    String mszAppAPKFolderName = "";
+    String mszAppAPKName = "";
+    String mszAppGitName = "";
+    String mszAppVersionName = "";
+    String mszCurrentAppPackageName = "";
+    boolean mIsAddDebugTools;
+    volatile String mszNewestAppPackageName = "";
+    String mszAppDescription = "";
+    String mszHomePage = "";
+    String mszGitea = "";
+    int mnAppIcon = 0;
+    String mszWinBoLLServerHost;
+    String mszReleaseAPKName;
+    EditText metDevUserName;
+    EditText metDevUserPassword;
+
+    public AboutView(Context context, APPInfo appInfo) {
+        super(context);
+        _mContext = context;
+
+        setAPPInfo(appInfo);
+        initView(context);
+    }
+
+    public AboutView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        _mContext = context;
+
+        initView(context, attrs);
+    }
+
+    public void setAPPInfo(APPInfo appInfo) {
+        mAPPInfo = appInfo;
+    }
+
+    APPInfo createAppInfo(Context context, AttributeSet attrs) {
+        APPInfo appInfo = new APPInfo();
+        TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.AboutView);
+        appInfo.setAppName(typedArray.getString(R.styleable.AboutView_app_name));
+        appInfo.setAppAPKFolderName(typedArray.getString(R.styleable.AboutView_app_apkfoldername));
+        appInfo.setAppAPKName(typedArray.getString(R.styleable.AboutView_app_apkname));
+        appInfo.setAppGitName(typedArray.getString(R.styleable.AboutView_app_gitname));
+        appInfo.setAppGitOwner(typedArray.getString(R.styleable.AboutView_app_gitowner));
+        appInfo.setAppGitAPPBranch(typedArray.getString(R.styleable.AboutView_app_gitappbranch));
+        appInfo.setAppGitAPPSubProjectFolder(typedArray.getString(R.styleable.AboutView_app_gitappsubprojectfolder));
+        appInfo.setAppDescription(typedArray.getString(R.styleable.AboutView_appdescription));
+        appInfo.setAppIcon(typedArray.getResourceId(R.styleable.AboutView_appicon, R.drawable.ic_winboll));
+        appInfo.setIsAddDebugTools(typedArray.getBoolean(R.styleable.AboutView_is_adddebugtools, false));
+        // 返回一个绑定资源结束的信号给资源
+        typedArray.recycle();
+        return appInfo;
+    }
+
+    void initView(Context context) {
+        mszAppName = mAPPInfo.getAppName();
+        mszAppAPKFolderName = mAPPInfo.getAppAPKFolderName();
+        mszAppAPKName = mAPPInfo.getAppAPKName();
+        mszAppGitName = mAPPInfo.getAppGitName();
+        mszAppDescription = mAPPInfo.getAppDescription();
+        mnAppIcon = mAPPInfo.getAppIcon();
+
+        mszWinBoLLServerHost = GlobalApplication.isDebugging() ?  "https://yun-preivew.winboll.cc": "https://yun.winboll.cc";
+
+        try {
+            mszAppVersionName = _mContext.getPackageManager().getPackageInfo(_mContext.getPackageName(), 0).versionName;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        mszCurrentAppPackageName = mszAppAPKName + "_" + mszAppVersionName + ".apk";
+        mszHomePage = mAPPInfo.getAppHomePage();
+        //mszHomePage = mszWinBoLLServerHost + "/studio/details.php?app=" + mszAppAPKFolderName;
+        if (mAPPInfo.getAppGitAPPBranch().equals("")) {
+            mszGitea = "https://gitea.winboll.cc/" + mAPPInfo.getAppGitOwner() + "/" + mszAppGitName;
+        } else {
+            mszGitea = "https://gitea.winboll.cc/" + mAPPInfo.getAppGitOwner() + "/" + mszAppGitName + "/src/branch/" + mAPPInfo.getAppGitAPPBranch() + "/" + mAPPInfo.getAppGitAPPSubProjectFolder();
+        }
+		
+		addView(createAboutPage());
+
+        // 初始化标题栏
+        //setSubtitle(getContext().getString(R.string.text_about));
+
+//        LinearLayout llMain = findViewById(R.id.viewaboutLinearLayout1);
+//        llMain.addView(createAboutPage());
+
+        // 就读取正式版应用包版本号，设置 Release 应用包文件名
+        String szReleaseAppVersionName = "";
+        try {
+            //LogUtils.d(TAG, String.format("mContext.getPackageName() %s", mContext.getPackageName()));
+            String szSubBetaSuffix = subBetaSuffix(_mContext.getPackageName());
+            //LogUtils.d(TAG, String.format("szSubBetaSuffix : %s", szSubBetaSuffix));
+            szReleaseAppVersionName = _mContext.getPackageManager().getPackageInfo(szSubBetaSuffix, 0).versionName;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        mszReleaseAPKName = mszAppAPKName + "_" + szReleaseAppVersionName + ".apk";
+
+    }
+
+    void initView(Context context, AttributeSet attrs) {
+        mAPPInfo = createAppInfo(context, attrs);
+        initView(context);
+    }
+
+    public static String subBetaSuffix(String input) {
+        if (input.endsWith(".beta")) {
+            return input.substring(0, input.length() - ".beta".length());
+        }
+        return input;
+    }
+
+    android.os.Handler mHandler = new android.os.Handler() {
+        @Override
+        public void handleMessage(Message msg) {
+            super.handleMessage(msg);
+            switch (msg.what) {
+                case MSG_APPUPDATE_CHECKED : {
+                        /*//检查当前应用包文件名是否是测试版，如果是就忽略检查
+                         if(mszCurrentAppPackageName.matches(".*_\\d+\\.\\d+\\.\\d+-beta.*\\.apk")) {
+                         ToastUtils.show("APP is the beta Version. Version check ignore.");
+                         return;
+                         }*/
+
+//                        if (!AppVersionUtils.isHasNewStageReleaseVersion(mszReleaseAPKName, mszNewestAppPackageName)) {
+//                            ToastUtils.delayedShow("Current app is the newest.", 5000);
+//                        } 
+                        if (!AppVersionUtils.isHasNewVersion2(mszCurrentAppPackageName, mszNewestAppPackageName)) {
+                            ToastUtils.show("Current app is the newest.");
+                        } else {
+                            String szMsg = "Current app is :\n[ " + mszCurrentAppPackageName
+                                + " ]\nThe last app is :\n[ " + mszNewestAppPackageName
+                                + " ]\nIs download the last app?";
+                            YesNoAlertDialog.show(_mContext, "Application Update Prompt", szMsg, mIsDownlaodUpdateListener);
+                        }
+                        break;
+                    }
+            }
+        }
+    };
+
+    protected View createAboutPage() {
+        // 定义 GitWeb 按钮
+        //
+        Element elementGitWeb = new Element(_mContext.getString(R.string.gitea_home), R.drawable.ic_winboll);
+        elementGitWeb.setOnClickListener(mGitWebOnClickListener);
+        // 定义检查更新按钮
+        //
+        /*Element elementAppUpdate = new Element(_mContext.getString(R.string.app_update), R.drawable.ic_winboll);
+        elementAppUpdate.setOnClickListener(mAppUpdateOnClickListener);
+		*/
+
+        String szAppInfo = "";
+        try {
+            szAppInfo = mszAppName + " "
+                + _mContext.getPackageManager().getPackageInfo(_mContext.getPackageName(), 0).versionName
+                + "\n" + mszAppDescription;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        AboutPage aboutPage = new AboutPage(_mContext);
+        aboutPage.setDescription(szAppInfo)
+            //.isRTL(false)
+            //.setCustomFont(String) // or Typeface
+            .setImage(mnAppIcon)
+            //.addItem(versionElement)
+            //.addItem(adsElement)
+            //.addGroup("Connect with us")
+            .addEmail("WinBoLLStudio<studio@winboll.cc>")
+            .addWebsite(mszHomePage)
+            .addItem(elementGitWeb);
+            //.addItem(elementAppUpdate);
+        //.addFacebook("the.medy")
+        //.addTwitter("medyo80")
+        //.addYoutube("UCdPQtdWIsg7_pi4mrRu46vA")
+        //.addPlayStore("com.ideashower.readitlater.pro")
+        //.addGitHub("medyo")
+        //.addInstagram("medyo80")
+        //.create();
+
+        /*if (mAPPInfo.isAddDebugTools()) {
+            // 定义应用调试按钮
+            //
+            Element elementAppMode;
+            if (GlobalApplication.isDebugging()) {
+                elementAppMode = new Element(_mContext.getString(R.string.app_normal), R.drawable.ic_winboll);
+                elementAppMode.setOnClickListener(mAppNormalOnClickListener);
+            } else {
+                elementAppMode = new Element(_mContext.getString(R.string.app_debug), R.drawable.ic_winboll);
+                elementAppMode.setOnClickListener(mAppDebugOnClickListener);
+            }
+            aboutPage.addItem(elementAppMode);
+        }*/
+
+        return aboutPage.create();
+    }
+
+    View.OnClickListener mAppDebugOnClickListener = new View.OnClickListener(){
+        @Override
+        public void onClick(View view) {
+            //ToastUtils.show("mAppDebugOnClickListener");
+            setApp2DebugMode(_mContext);
+        }
+    };
+
+    View.OnClickListener mAppNormalOnClickListener = new View.OnClickListener(){
+        @Override
+        public void onClick(View view) {
+            //ToastUtils.show("mAppNormalOnClickListener");
+            setApp2NormalMode(_mContext);
+        }
+    };
+
+    public static void setApp2DebugMode(Context context) {
+        Intent intent = context.getPackageManager().getLaunchIntentForPackage(context.getPackageName());
+        if (intent != null) {
+            //intent.setAction(cc.winboll.studio.libapputils.intent.action.DEBUGVIEW);
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            GlobalApplication.setIsDebugging(true);
+            GlobalApplication.saveDebugStatus((GlobalApplication)_mContext.getApplicationContext());
+
+            WinBoLLActivityManager.getInstance().finishAll();
+            context.startActivity(intent);
+        } 
+    }
+
+    public static void setApp2NormalMode(Context context) {
+        Intent intent = context.getPackageManager().getLaunchIntentForPackage(context.getPackageName());
+        if (intent != null) {
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            GlobalApplication.setIsDebugging(false);
+            GlobalApplication.saveDebugStatus((GlobalApplication)_mContext.getApplicationContext());
+
+            WinBoLLActivityManager.getInstance().finishAll();
+            context.startActivity(intent);
+        } 
+    }
+
+    View.OnClickListener mGitWebOnClickListener = new View.OnClickListener(){
+        @Override
+        public void onClick(View view) {
+            Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(mszGitea));
+            _mContext.startActivity(browserIntent);
+        }
+    };
+
+    View.OnClickListener mAppUpdateOnClickListener = new View.OnClickListener(){
+        @Override
+        public void onClick(View view) {
+            ToastUtils.show("Start app update checking.");
+            new Thread(new Runnable() {
+                    @Override
+                    public void run() {
+                        String szUrl = mszWinBoLLServerHost + "/studio/details.php?app=" + mszAppAPKFolderName;
+                        // 构建包含认证信息的请求
+                        String credential = "";
+                        if (GlobalApplication.isDebugging()) {
+                            credential = Credentials.basic(metDevUserName.getText().toString(), metDevUserPassword.getText().toString());
+                            PrefUtils.saveString(_mContext, "metDevUserName", metDevUserName.getText().toString());
+                            PrefUtils.saveString(_mContext, "metDevUserPassword", metDevUserPassword.getText().toString());
+                        } else {
+                            String username = "WinBoLL";
+                            String password = "WinBoLLPowerByZhanGSKen";
+                            credential = Credentials.basic(username, password);
+                        }
+
+                        Request request = new Request.Builder()
+                            .url(szUrl)
+                            .header("Accept", "text/plain") // 设置正确的Content-Type头
+                            .header("Authorization", credential)
+                            .build();
+                        OkHttpClient client = new OkHttpClient();
+                        Call call = client.newCall(request);
+                        call.enqueue(new Callback() {
+                                @Override
+                                public void onFailure(Call call, IOException e) {
+                                    // 处理网络请求失败
+                                    LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                                }
+
+                                @Override
+                                public void onResponse(Call call, Response response) throws IOException {
+                                    if (!response.isSuccessful()) {
+                                        LogUtils.d(TAG, "Unexpected code " + response, Thread.currentThread().getStackTrace());
+                                        return;
+                                    }
+
+                                    try {
+                                        // 读取响应体作为字符串，注意这里可能需要解码
+                                        String text = response.body().string();
+                                        org.jsoup.nodes.Document doc = org.jsoup.Jsoup.parse(text);
+                                        LogUtils.v(TAG, doc.text());
+
+                                        // 使用id选择器找到具有特定id的元素
+                                        org.jsoup.nodes.Element elementWithId = doc.select("#LastRelease").first(); // 获取第一个匹配的元素
+
+                                        // 提取并打印元素的文本内容
+                                        mszNewestAppPackageName = elementWithId.text();
+                                        //ToastUtils.delayedShow(text + "\n" + mszNewestAppPackageName, 5000);
+
+                                        mHandler.sendMessage(mHandler.obtainMessage(MSG_APPUPDATE_CHECKED));
+                                    } catch (Exception e) {
+                                        LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                                    }
+                                }
+                            });
+                    }
+                }).start();
+        }
+    };
+
+    YesNoAlertDialog.OnDialogResultListener mIsDownlaodUpdateListener = new YesNoAlertDialog.OnDialogResultListener() {
+        @Override
+        public void onYes() {
+            String szUrl = mszWinBoLLServerHost + "/studio/download.php?appname=" + mszAppAPKFolderName + "&apkname=" + mszNewestAppPackageName;
+            Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(szUrl));
+            _mContext.startActivity(browserIntent);
+        }
+
+        @Override
+        public void onNo() {
+        }
+    };
+
+    public interface OnRequestDevUserInfoAutofillListener {
+        void requestAutofill(EditText etDevUserName, EditText etDevUserPassword);
+    }
+
+    public void setOnRequestDevUserInfoAutofillListener(OnRequestDevUserInfoAutofillListener l) {
+        mOnRequestDevUserInfoAutofillListener = l;
+    }
+}
diff --git a/libaes/src/main/res/anim/normal_dialog_enter_center.xml b/libaes/src/main/res/anim/normal_dialog_enter_center.xml
new file mode 100644
index 0000000..7a6ac10
--- /dev/null
+++ b/libaes/src/main/res/anim/normal_dialog_enter_center.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shareInterpolator="false">
+    <scale
+        android:interpolator="@android:anim/accelerate_decelerate_interpolator"
+        android:fromXScale="0.1"
+        android:toXScale="1.0"
+        android:fromYScale="0.1"
+        android:toYScale="1.0"
+        android:pivotX="50%"
+        android:pivotY="50%"
+        android:fillAfter="false"
+        android:duration="300" />
+    <set android:interpolator="@android:anim/decelerate_interpolator">
+        <scale
+            android:fromXScale="1.0"
+            android:toXScale="1.0"
+            android:fromYScale="1.0"
+            android:toYScale="1.0"
+            android:pivotX="50%"
+            android:pivotY="50%"
+            android:startOffset="700"
+            android:duration="100"
+            android:fillBefore="false" />
+        <rotate
+            android:fromDegrees="0"
+            android:toDegrees="0"
+            android:toYScale="0.0"
+            android:pivotX="50%"
+            android:pivotY="50%"
+            android:startOffset="700"
+            android:duration="100" />
+    </set>
+</set>
diff --git a/libaes/src/main/res/anim/normal_dialog_enter_corner.xml b/libaes/src/main/res/anim/normal_dialog_enter_corner.xml
new file mode 100644
index 0000000..edfc076
--- /dev/null
+++ b/libaes/src/main/res/anim/normal_dialog_enter_corner.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shareInterpolator="false">
+    <scale
+        android:interpolator="@android:anim/accelerate_decelerate_interpolator"
+        android:fromXScale="0.1"
+        android:toXScale="1.0"
+        android:fromYScale="0.1"
+        android:toYScale="1.0"
+        android:pivotX="@dimen/dialogPivotX"
+        android:pivotY="@dimen/dialogPivotY"
+        android:fillAfter="false"
+        android:duration="500" />
+</set>
diff --git a/libaes/src/main/res/anim/normal_dialog_exit_center.xml b/libaes/src/main/res/anim/normal_dialog_exit_center.xml
new file mode 100644
index 0000000..4d69f65
--- /dev/null
+++ b/libaes/src/main/res/anim/normal_dialog_exit_center.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shareInterpolator="false">
+    <scale
+        android:interpolator="@android:anim/accelerate_decelerate_interpolator"
+        android:fromXScale="1.0"
+        android:toXScale="1.0"
+        android:fromYScale="1.0"
+        android:toYScale="1.0"
+        android:pivotX="50%"
+        android:pivotY="50%"
+        android:fillAfter="false"
+        android:duration="100" />
+    <set android:interpolator="@android:anim/decelerate_interpolator">
+        <scale
+            android:fromXScale="1.0"
+            android:toXScale="0.1"
+            android:fromYScale="1.0"
+            android:toYScale="0.1"
+            android:pivotX="50%"
+            android:pivotY="50%"
+            android:startOffset="700"
+            android:duration="100"
+            android:fillBefore="false" />
+        <rotate
+            android:fromDegrees="0"
+            android:toDegrees="0"
+            android:toYScale="0.0"
+            android:pivotX="50%"
+            android:pivotY="50%"
+            android:startOffset="700"
+            android:duration="100" />
+    </set>
+</set>
diff --git a/libaes/src/main/res/anim/normal_dialog_exit_corner.xml b/libaes/src/main/res/anim/normal_dialog_exit_corner.xml
new file mode 100644
index 0000000..4b9d1fc
--- /dev/null
+++ b/libaes/src/main/res/anim/normal_dialog_exit_corner.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shareInterpolator="false">
+    <scale
+        android:fromXScale="1.0"
+        android:toXScale="0.1"
+        android:fromYScale="1.0"
+        android:toYScale="0.1"
+        android:pivotX="@dimen/dialogPivotX"
+        android:pivotY="@dimen/dialogPivotY"
+        android:duration="500"
+        android:fillBefore="false" />
+</set>
diff --git a/libaes/src/main/res/drawable/acard_frame_main.xml b/libaes/src/main/res/drawable/acard_frame_main.xml
new file mode 100644
index 0000000..ee332b2
--- /dev/null
+++ b/libaes/src/main/res/drawable/acard_frame_main.xml
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 边框阴影部分 --> 
+    <!-- 相对边框的Offset设置(android:left, top, right, bottom) --> 
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:startColor="@color/colorACardShadow"
+                android:centerColor="@color/colorACardShadow"
+                android:endColor="@color/colorACardShadow"/> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item>
+    <!-- 边框部分 -->
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="1dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:startColor="@color/colorACardFrame"
+                android:centerColor="@color/colorACardFrame"
+                android:endColor="@color/colorACardFrame"/> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item>
+    <!-- 背景主体部分 -->
+    <item
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="3dp" 
+        android:bottom="3dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient
+                android:type="linear"
+                android:angle="90"
+                android:startColor="@color/colorACardBackgroung"
+                android:centerColor="@color/colorACardBackgroung"
+                android:endColor="@color/colorACardBackgroung"/> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/libaes/src/main/res/drawable/atoolbar_frame.xml b/libaes/src/main/res/drawable/atoolbar_frame.xml
new file mode 100644
index 0000000..198e122
--- /dev/null
+++ b/libaes/src/main/res/drawable/atoolbar_frame.xml
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 边框阴影部分 --> 
+    <!-- 相对边框的Offset设置(android:left, top, right, bottom) --> 
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:startColor="?attr/attrAToolbarEndColor"
+                android:centerColor="?attr/attrAToolbarCenterColor"
+                android:endColor="?attr/attrAToolbarStartColor"/> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape>
+    </item>
+    <!-- 边框部分 -->
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="4dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:startColor="?attr/attrAToolbarCenterColor"
+                android:centerColor="?attr/attrAToolbarCenterColor"
+                android:endColor="?attr/attrAToolbarCenterColor"/> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item>
+    <!-- 背景主体部分 -->
+    <item
+        android:left="4dp" 
+        android:top="4dp" 
+        android:right="4dp" 
+        android:bottom="6dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient
+                android:type="linear"
+                android:angle="90"
+                android:startColor="?attr/attrAToolbarStartColor"
+                android:centerColor="?attr/attrAToolbarCenterColor"
+                android:endColor="?attr/attrAToolbarEndColor"/> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/libaes/src/main/res/drawable/bg_container_border.xml b/libaes/src/main/res/drawable/bg_container_border.xml
new file mode 100644
index 0000000..09c5bdf
--- /dev/null
+++ b/libaes/src/main/res/drawable/bg_container_border.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@android:color/transparent" />
+    <stroke android:width="1dp" android:color="#FFB0B0B0" />
+    <corners android:radius="?attr/borderCornerRadius" />
+</shape>
diff --git a/libaes/src/main/res/drawable/bg_shadow.xml b/libaes/src/main/res/drawable/bg_shadow.xml
new file mode 100644
index 0000000..0cafd81
--- /dev/null
+++ b/libaes/src/main/res/drawable/bg_shadow.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="@color/colorAccent" 
+                android:startColor="@color/colorAccent" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/libaes/src/main/res/drawable/btn_style.xml b/libaes/src/main/res/drawable/btn_style.xml
new file mode 100644
index 0000000..7c6bb83
--- /dev/null
+++ b/libaes/src/main/res/drawable/btn_style.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <item android:drawable="@drawable/pressed_shape" android:state_pressed="true"></item>
+    <item android:drawable="@drawable/default_shape"></item>
+
+</selector>
\ No newline at end of file
diff --git a/libaes/src/main/res/drawable/default_shape.xml b/libaes/src/main/res/drawable/default_shape.xml
new file mode 100644
index 0000000..8a405ca
--- /dev/null
+++ b/libaes/src/main/res/drawable/default_shape.xml
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle" >
+
+    <!-- 颜色填充方式绘画按钮 -->
+    <!--<solid android:color="?attr/colorPrimaryDark" />-->
+
+    <stroke
+        android:width="2dp"
+        android:color="?attr/colorPrimary" />
+
+    <corners android:radius="15dp" />
+
+    <!-- 颜色线性渐变方式绘画按钮 -->
+    <gradient
+        android:angle="270"
+        android:startColor="?attr/colorAccent"
+        android:centerColor="?attr/colorPrimary"
+        android:endColor="?attr/colorPrimaryDark"/> 
+
+    <padding
+        android:left="5dp"
+        android:top="5dp" 
+        android:right="5dp"
+        android:bottom="5dp" />
+
+</shape>
diff --git a/libaes/src/main/res/drawable/ic_arrow_left_right_bold.xml b/libaes/src/main/res/drawable/ic_arrow_left_right_bold.xml
new file mode 100644
index 0000000..8d6dc41
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_arrow_left_right_bold.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M8,14V18L2,12L8,6V10H16V6L22,12L16,18V14H8Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libaes/src/main/res/drawable/ic_arrow_up_circle_outline.xml b/libaes/src/main/res/drawable/ic_arrow_up_circle_outline.xml
new file mode 100644
index 0000000..38c794a
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_arrow_up_circle_outline.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M13,18H11V10L7.5,13.5L6.08,12.08L12,6.16L17.92,12.08L16.5,13.5L13,10V18M12,2A10,10 0,0 1,22 12A10,10 0,0 1,12 22A10,10 0,0 1,2 12A10,10 0,0 1,12 2M12,4A8,8 0,0 0,4 12A8,8 0,0 0,12 20A8,8 0,0 0,20 12A8,8 0,0 0,12 4Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libaes/src/main/res/drawable/ic_call.xml b/libaes/src/main/res/drawable/ic_call.xml
new file mode 100644
index 0000000..c5802bb
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_call.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M6.62,10.79C8.06,13.62 10.38,15.94 13.21,17.38L15.41,15.18C15.69,14.9 16.08,14.82 16.43,14.93C17.55,15.3 18.75,15.5 20,15.5A1,1 0,0 1,21 16.5V20A1,1 0,0 1,20 21A17,17 0,0 1,3 4A1,1 0,0 1,4 3H7.5A1,1 0,0 1,8.5 4C8.5,5.25 8.7,6.45 9.07,7.57C9.18,7.92 9.1,8.31 8.82,8.59L6.62,10.79Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libaes/src/main/res/drawable/ic_dev_connected.xml b/libaes/src/main/res/drawable/ic_dev_connected.xml
new file mode 100644
index 0000000..1fb2f26
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_dev_connected.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M4,1C2.89,1 2,1.89 2,3V7C2,8.11 2.89,9 4,9H1V11H13V9H10C11.11,9 12,8.11 12,7V3C12,1.89 11.11,1 10,1H4M4,3H10V7H4V3M3,12V14H5V12H3M14,13C12.89,13 12,13.89 12,15V19C12,20.11 12.89,21 14,21H11V23H23V21H20C21.11,21 22,20.11 22,19V15C22,13.89 21.11,13 20,13H14M3,15V17H5V15H3M14,15H20V19H14V15M3,18V20H5V18H3M6,18V20H8V18H6M9,18V20H11V18H9Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libaes/src/main/res/drawable/ic_dev_disconnected.xml b/libaes/src/main/res/drawable/ic_dev_disconnected.xml
new file mode 100644
index 0000000..4267975
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_dev_disconnected.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M4,1C2.89,1 2,1.89 2,3V7C2,8.11 2.89,9 4,9H1V11H13V9H10C11.11,9 12,8.11 12,7V3C12,1.89 11.11,1 10,1H4M4,3H10V7H4V3M14,13C12.89,13 12,13.89 12,15V19C12,20.11 12.89,21 14,21H11V23H23V21H20C21.11,21 22,20.11 22,19V15C22,13.89 21.11,13 20,13H14M3.88,13.46L2.46,14.88L4.59,17L2.46,19.12L3.88,20.54L6,18.41L8.12,20.54L9.54,19.12L7.41,17L9.54,14.88L8.12,13.46L6,15.59L3.88,13.46M14,15H20V19H14V15Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libaes/src/main/res/drawable/ic_email.xml b/libaes/src/main/res/drawable/ic_email.xml
new file mode 100644
index 0000000..d526b26
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_email.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M22,6C22,4.9 21.1,4 20,4H4C2.9,4 2,4.9 2,6V18C2,19.1 2.9,20 4,20H20C21.1,20 22,19.1 22,18V6M20,6L12,11L4,6H20M20,18H4V8L12,13L20,8V18Z"/>
+
+</vector>
diff --git a/libaes/src/main/res/drawable/ic_email_alert.xml b/libaes/src/main/res/drawable/ic_email_alert.xml
new file mode 100644
index 0000000..f3ed613
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_email_alert.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M24,7H22V13H24V7M24,15H22V17H24V15M20,6C20,4.9 19.1,4 18,4H2C0.9,4 0,4.9 0,6V18C0,19.1 0.9,20 2,20H18C19.1,20 20,19.1 20,18V6M18,6L10,11L2,6H18M18,18H2V8L10,13L18,8V18Z"/>
+
+</vector>
diff --git a/libaes/src/main/res/drawable/ic_launcher.xml b/libaes/src/main/res/drawable/ic_launcher.xml
new file mode 100644
index 0000000..f269b7e
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_launcher.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item
+        android:width="256dp"
+        android:height="256dp"
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/winboll_logo">
+    </item>
+</layer-list>
diff --git a/libaes/src/main/res/drawable/ic_launcher_background.xml b/libaes/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..9486190
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="@color/colorPrimary"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/libaes/src/main/res/drawable/ic_launcher_foreground.xml b/libaes/src/main/res/drawable/ic_launcher_foreground.xml
new file mode 100644
index 0000000..872b04e
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_launcher_foreground.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M16.61,15.15C16.15,15.15 15.77,14.78 15.77,14.32S16.15,13.5 16.61,13.5H16.61C17.07,13.5 17.45,13.86 17.45,14.32C17.45,14.78 17.07,15.15 16.61,15.15M7.41,15.15C6.95,15.15 6.57,14.78 6.57,14.32C6.57,13.86 6.95,13.5 7.41,13.5H7.41C7.87,13.5 8.24,13.86 8.24,14.32C8.24,14.78 7.87,15.15 7.41,15.15M16.91,10.14L18.58,7.26C18.67,7.09 18.61,6.88 18.45,6.79C18.28,6.69 18.07,6.75 18,6.92L16.29,9.83C14.95,9.22 13.5,8.9 12,8.91C10.47,8.91 9,9.24 7.73,9.82L6.04,6.91C5.95,6.74 5.74,6.68 5.57,6.78C5.4,6.87 5.35,7.08 5.44,7.25L7.1,10.13C4.25,11.69 2.29,14.58 2,18H22C21.72,14.59 19.77,11.7 16.91,10.14H16.91Z"/>
+</vector>
diff --git a/libaes/src/main/res/drawable/ic_winboll.xml b/libaes/src/main/res/drawable/ic_winboll.xml
new file mode 100644
index 0000000..f269b7e
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_winboll.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item
+        android:width="256dp"
+        android:height="256dp"
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/winboll_logo">
+    </item>
+</layer-list>
diff --git a/libaes/src/main/res/drawable/ic_winboll_store.png b/libaes/src/main/res/drawable/ic_winboll_store.png
new file mode 100644
index 0000000..e8bb856
Binary files /dev/null and b/libaes/src/main/res/drawable/ic_winboll_store.png differ
diff --git a/libaes/src/main/res/drawable/ic_winbollbeta.xml b/libaes/src/main/res/drawable/ic_winbollbeta.xml
new file mode 100644
index 0000000..f4876a0
--- /dev/null
+++ b/libaes/src/main/res/drawable/ic_winbollbeta.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/winboll_logo"/>
+</layer-list>
diff --git a/libaes/src/main/res/drawable/ohpcts_frame.xml b/libaes/src/main/res/drawable/ohpcts_frame.xml
new file mode 100644
index 0000000..77eacff
--- /dev/null
+++ b/libaes/src/main/res/drawable/ohpcts_frame.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 进度条背景色 -->  
+    <item android:id="@android:id/background">
+        <shape> 
+            <gradient 
+                android:angle="270"
+                android:centerY="0.75"
+                android:startColor="@color/colorOHPCTSBackground"
+                android:centerColor="@color/colorOHPCTSBackground"
+                android:endColor="@color/colorOHPCTSBackground"/> 
+            <corners android:radius="?attr/borderCornerRadius"/> 
+        </shape>
+    </item>
+    <!-- 第二进度条 -->
+    <item android:id="@android:id/secondaryProgress"> 
+        <clip>
+            <shape> 
+                <gradient 
+                    android:angle="270" 
+                    android:centerY="0.75"
+                    android:startColor="@color/colorOHPCTSSecondaryProgress"
+                    android:centerColor="@color/colorOHPCTSSecondaryProgress"
+                    android:endColor="@color/colorOHPCTSSecondaryProgress"/> 
+                <corners android:radius="?attr/borderCornerRadius"/> 
+            </shape> 
+        </clip>
+    </item>
+    <!-- 第一进度条 -->
+    <item android:id="@android:id/progress"> 
+        <clip>
+            <shape> 
+                <gradient
+                    android:type="linear"
+                    android:angle="90"
+                    android:startColor="@color/colorOHPCTSProgress"
+                    android:centerColor="@color/colorOHPCTSProgress"
+                    android:endColor="@color/colorOHPCTSProgress"/> 
+                <corners android:radius="?attr/borderCornerRadius"/> 
+            </shape> 
+        </clip>
+    </item> 
+</layer-list>
diff --git a/libaes/src/main/res/drawable/pressed_shape.xml b/libaes/src/main/res/drawable/pressed_shape.xml
new file mode 100644
index 0000000..ed448af
--- /dev/null
+++ b/libaes/src/main/res/drawable/pressed_shape.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle" >
+
+    <!-- 颜色填充方式绘画按钮 -->
+    <solid android:color="?attr/colorPrimaryDark" />
+    <!-- 边框 -->
+    <stroke
+        android:width="2dp"
+        android:color="?attr/colorPrimaryDark" />
+    <!-- 定义成圆角的 -->
+    <corners android:radius="15dp" />
+
+    <!-- 颜色线性渐变方式绘画按钮 -->
+    <!--<gradient
+        android:angle="270"
+        android:startColor="?attr/colorAccent"
+        android:centerColor="?attr/colorPrimary"
+        android:endColor="?attr/colorPrimaryDark"/>
+    -->
+
+</shape>
diff --git a/libaes/src/main/res/drawable/shape_gradient.xml b/libaes/src/main/res/drawable/shape_gradient.xml
new file mode 100644
index 0000000..c164fe9
--- /dev/null
+++ b/libaes/src/main/res/drawable/shape_gradient.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android">
+    <gradient
+        android:angle="180"
+        android:endColor="#FFFFFFFF"
+        android:startColor="#FFFFFFFF"
+        android:type="linear" />
+
+    <corners android:radius="10dp" />
+</shape>
diff --git a/libaes/src/main/res/drawable/toast_frame.xml b/libaes/src/main/res/drawable/toast_frame.xml
new file mode 100644
index 0000000..c4b8f8a
--- /dev/null
+++ b/libaes/src/main/res/drawable/toast_frame.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="#BF4C4C4C" />
+    <!-- 定义成圆角的 -->
+    <corners android:radius="15dp" />
+</shape>
diff --git a/libaes/src/main/res/drawable/view_border.xml b/libaes/src/main/res/drawable/view_border.xml
new file mode 100644
index 0000000..58b374a
--- /dev/null
+++ b/libaes/src/main/res/drawable/view_border.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <stroke
+        android:width="1dp"
+        android:color="#000000" /> <!-- 这里可调整边框宽度和颜色 -->
+    <solid android:color="@android:color/transparent" />
+</shape>
diff --git a/libaes/src/main/res/drawable/winboll_help.xml b/libaes/src/main/res/drawable/winboll_help.xml
new file mode 100644
index 0000000..564175f
--- /dev/null
+++ b/libaes/src/main/res/drawable/winboll_help.xml
@@ -0,0 +1,27 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FF000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+</vector>
diff --git a/libaes/src/main/res/drawable/winboll_logo.xml b/libaes/src/main/res/drawable/winboll_logo.xml
new file mode 100644
index 0000000..ea28987
--- /dev/null
+++ b/libaes/src/main/res/drawable/winboll_logo.xml
@@ -0,0 +1,48 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M103.77 307.45C103.02 293.07 104.03 271.24 129.24 248.85 135.25 243.52 141.74 239.48 147.89 236.44 160.24 230.34 171.23 228.28 174.15 227.92 174.31 227.9 174.44 227.89 174.55 227.88 174.66 227.87 174.75 227.86 174.81 227.86 176.62 227.85 216.5 230.02 234.65 253.79 253.9 278.99 266.43 314.66 221.67 356.93 184.69 391.85 179.97 411.36 180.15 411.08"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M248.17 309.83C247.43 295.45 248.43 273.62 273.64 251.23 279.65 245.9 286.14 241.86 292.29 238.82 304.65 232.72 315.63 230.65 318.55 230.3 318.71 230.28 318.84 230.27 318.95 230.26 319.06 230.25 319.15 230.24 319.21 230.24 321.02 230.22 360.9 232.4 379.06 256.17 398.3 281.37 410.83 317.04 366.08 359.31 329.09 394.23 324.37 413.74 324.55 413.46"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+</vector>
diff --git a/libaes/src/main/res/drawable/winboll_point.xml b/libaes/src/main/res/drawable/winboll_point.xml
new file mode 100644
index 0000000..48028cc
--- /dev/null
+++ b/libaes/src/main/res/drawable/winboll_point.xml
@@ -0,0 +1,20 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+</vector>
diff --git a/libaes/src/main/res/layout/activity_about.xml b/libaes/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..337d98e
--- /dev/null
+++ b/libaes/src/main/res/layout/activity_about.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutviewroot_ll" android:background="@drawable/bg_container_border" />
+
+</LinearLayout>
diff --git a/libaes/src/main/res/layout/activity_drawer.xml b/libaes/src/main/res/layout/activity_drawer.xml
new file mode 100644
index 0000000..9ce0a85
--- /dev/null
+++ b/libaes/src/main/res/layout/activity_drawer.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/activitydrawerASupportToolbar1"/>
+
+	<androidx.drawerlayout.widget.DrawerLayout
+		xmlns:app="http://schemas.android.com/apk/res-auto"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/activitydrawerDrawerLayout1">
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+			<LinearLayout
+				android:layout_width="match_parent"
+				android:layout_height="0dp"
+				android:layout_weight="1.0"
+				android:id="@+id/activitydrawerLinearLayout1" android:background="@drawable/bg_container_border" />
+		</LinearLayout>
+
+        <com.baoyz.widget.PullRefreshLayout
+            android:orientation="vertical"
+            android:layout_width="300dp"
+            android:layout_height="match_parent"
+            android:layout_gravity="start"
+            android:background="?attr/colorAccent"
+            android:choiceMode="singleChoice"
+            android:divider="#FFFFFF"
+            android:dividerHeight="1dp"
+            android:id="@+id/activitydrawerPullRefreshLayout1">
+
+            <cc.winboll.studio.libaes.views.DrawerMenuListView
+                android:layout_width="300dp"
+                android:layout_height="match_parent"
+                android:layout_gravity="start"
+                android:background="?attr/colorAccent"
+                android:choiceMode="singleChoice"
+                android:divider="#FFFFFF"
+                android:dividerHeight="1dp"
+                android:id="@+id/activitydrawerDrawerMenuListView1"/>
+
+        </com.baoyz.widget.PullRefreshLayout>
+
+	</androidx.drawerlayout.widget.DrawerLayout>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/activity_drawerfragment.xml b/libaes/src/main/res/layout/activity_drawerfragment.xml
new file mode 100644
index 0000000..6c314df
--- /dev/null
+++ b/libaes/src/main/res/layout/activity_drawerfragment.xml
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/activitydrawerfragmentASupportToolbar1"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0" android:background="@drawable/bg_container_border">
+
+		<androidx.drawerlayout.widget.DrawerLayout
+			android:layout_width="match_parent"
+			android:layout_height="0dp"
+			android:layout_weight="1.0"
+			android:id="@+id/activitydrawerfragmentDrawerLayout1">
+
+			<FrameLayout
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:id="@+id/activitydrawerfragmentFrameLayout1" android:background="@drawable/bg_container_border" />
+
+			<com.baoyz.widget.PullRefreshLayout
+				android:orientation="vertical"
+				android:layout_width="300dp"
+				android:layout_height="match_parent"
+				android:layout_gravity="start"
+				android:background="?attr/colorAccent"
+				android:choiceMode="singleChoice"
+				android:divider="#FFFFFF"
+				android:dividerHeight="1dp"
+				android:id="@+id/activitydrawerfragmentPullRefreshLayout1">
+
+				<cc.winboll.studio.libaes.views.ADrawerMenuListView
+					android:layout_width="300dp"
+					android:layout_height="match_parent"
+					android:layout_gravity="start"
+					android:background="?attr/colorAccent"
+					android:choiceMode="singleChoice"
+					android:divider="#FFFFFF"
+					android:dividerHeight="1dp"
+					android:id="@+id/activitydrawerfragmentDrawerMenuListView1"/>
+
+			</com.baoyz.widget.PullRefreshLayout>
+
+		</androidx.drawerlayout.widget.DrawerLayout>
+
+		
+	</LinearLayout>
+
+	<cc.winboll.studio.libaes.views.ADsBannerView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/adsbanner"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/activity_secondarylibrary.xml b/libaes/src/main/res/layout/activity_secondarylibrary.xml
new file mode 100644
index 0000000..ac1df89
--- /dev/null
+++ b/libaes/src/main/res/layout/activity_secondarylibrary.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="SecondaryLibraryActivity"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/activity_test_aboutfragment.xml b/libaes/src/main/res/layout/activity_test_aboutfragment.xml
new file mode 100644
index 0000000..3c30c2f
--- /dev/null
+++ b/libaes/src/main/res/layout/activity_test_aboutfragment.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<FrameLayout
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/activitytestaboutfragmentFrameLayout1" android:background="@drawable/bg_container_border" />
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/activity_testasupporttoolbar.xml b/libaes/src/main/res/layout/activity_testasupporttoolbar.xml
new file mode 100644
index 0000000..c8214e7
--- /dev/null
+++ b/libaes/src/main/res/layout/activity_testasupporttoolbar.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/activitytestasupporttoolbarASupportToolbar1"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/activity_testatoolbar.xml b/libaes/src/main/res/layout/activity_testatoolbar.xml
new file mode 100644
index 0000000..d72459c
--- /dev/null
+++ b/libaes/src/main/res/layout/activity_testatoolbar.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.AToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/activitytestatoolbarAToolbar1"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/dialog_privacy_agreement.xml b/libaes/src/main/res/layout/dialog_privacy_agreement.xml
new file mode 100644
index 0000000..438d992
--- /dev/null
+++ b/libaes/src/main/res/layout/dialog_privacy_agreement.xml
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:padding="20dp"
+    android:background="@android:color/white">
+
+    <!-- 标题 -->
+    <TextView
+        android:id="@+id/tv_dialog_title"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="用户须知"
+        android:textSize="18sp"
+        android:textStyle="bold"
+        android:layout_marginBottom="16dp" />
+
+    <!-- 内容（用LinearLayout横向排列文本+链接，替代HTML <a>标签） -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:layout_marginBottom="20dp" android:background="@drawable/bg_container_border">
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="小米广告SDK隐私政策: "
+            android:textSize="14sp" />
+
+        <!-- 可点击链接（用TextView承载，通过代码设置蓝色+下划线） -->
+        <TextView
+            android:id="@+id/tv_privacy_url"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="https://dev.mi.com/distribute/doc/details?pId=1688"
+            android:textSize="14sp"
+            android:textColor="@android:color/holo_blue_light" />
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="，点击链接查看完整政策"
+            android:textSize="14sp" />
+    </LinearLayout>
+
+    <!-- 按钮容器（水平排列） -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:gravity="end" android:background="@drawable/bg_container_border">
+
+        <Button
+            android:id="@+id/btn_disagree"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="拒绝"
+            android:textSize="14sp"
+            android:layout_marginRight="12dp"
+            android:paddingLeft="24dp"
+            android:paddingRight="24dp" />
+
+        <Button
+            android:id="@+id/btn_agree"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="同意"
+            android:textSize="14sp"
+            android:paddingLeft="24dp"
+            android:paddingRight="24dp" />
+    </LinearLayout>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/dialog_storagepath.xml b/libaes/src/main/res/layout/dialog_storagepath.xml
new file mode 100644
index 0000000..9a459c4
--- /dev/null
+++ b/libaes/src/main/res/layout/dialog_storagepath.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Storage Path Dialog"/>
+
+	<EditText
+		android:layout_width="match_parent"
+		android:ems="10"
+		android:layout_height="wrap_content"
+		android:inputType="text"
+        android:autofillHints=""
+        android:hint="text 1"/>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="end" android:background="@drawable/bg_container_border">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Cancel"
+			android:textAllCaps="false"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="OK"
+			android:textAllCaps="false"
+			android:id="@+id/dialogstoragepathButton1"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/fragment_abutton.xml b/libaes/src/main/res/layout/fragment_abutton.xml
new file mode 100644
index 0000000..d608b7d
--- /dev/null
+++ b/libaes/src/main/res/layout/fragment_abutton.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="AButton"/>
+
+	<cc.winboll.studio.libaes.views.AButton
+		android:layout_width="wrap_content"
+		android:layout_height="32dp"
+		android:text="确定"
+		android:id="@+id/fragmentabuttonAButton1"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/fragment_secondarylibrary.xml b/libaes/src/main/res/layout/fragment_secondarylibrary.xml
new file mode 100644
index 0000000..b47f0ae
--- /dev/null
+++ b/libaes/src/main/res/layout/fragment_secondarylibrary.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="#FF0A9FA6">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="SecondaryLibraryFragment"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/fragment_test1.xml b/libaes/src/main/res/layout/fragment_test1.xml
new file mode 100644
index 0000000..112fb47
--- /dev/null
+++ b/libaes/src/main/res/layout/fragment_test1.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="#FF0A9FA6">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="TestFragment1"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/fragment_test2.xml b/libaes/src/main/res/layout/fragment_test2.xml
new file mode 100644
index 0000000..3b0e457
--- /dev/null
+++ b/libaes/src/main/res/layout/fragment_test2.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="#FF0A9FA6">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="TestFragment2"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/fragment_viewpage.xml b/libaes/src/main/res/layout/fragment_viewpage.xml
new file mode 100644
index 0000000..923dfac
--- /dev/null
+++ b/libaes/src/main/res/layout/fragment_viewpage.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:tools="http://schemas.android.com/tools"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:gravity="center_vertical" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="AOHPCTCSeekBar"/>
+
+	<androidx.viewpager.widget.ViewPager
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/fragmentviewpageViewPager1"/>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="60dp"
+		android:orientation="horizontal"
+		android:gravity="center"
+		android:id="@+id/fragmentviewpageLinearLayout1" android:background="@drawable/bg_container_border">
+
+		<ImageView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_margin="5dp"
+			tools:ignore="ContentDescription"/>
+
+		<ImageView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_margin="5dp"
+			tools:ignore="ContentDescription"/>
+
+		<ImageView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_margin="5dp"
+			tools:ignore="ContentDescription"/>
+
+		<ImageView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_margin="5dp"
+			tools:ignore="ContentDescription"/>
+
+	</LinearLayout>
+
+	<cc.winboll.studio.libappbase.LogView
+		android:layout_width="match_parent"
+		android:layout_height="300dp"
+		android:id="@+id/logview"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/listview_drawermenu.xml b/libaes/src/main/res/layout/listview_drawermenu.xml
new file mode 100644
index 0000000..731b20a
--- /dev/null
+++ b/libaes/src/main/res/layout/listview_drawermenu.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="48dp"
+    android:gravity="center_vertical"
+    android:orientation="horizontal" android:background="@drawable/bg_container_border">
+
+    <ImageView
+        android:layout_centerVertical="true"
+        android:layout_width="40dp"
+        android:layout_height="40dp"
+        android:focusable="false"
+        android:id="@+id/listviewdrawermenuImageView1"
+        tools:ignore="ContentDescription"/>
+
+    <TextView
+        android:layout_centerVertical="true"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginStart="10dp"
+        android:layout_toEndOf="@id/listviewdrawermenuImageView1"
+        android:textSize="18sp"
+        android:text="AndroidGoodies"
+        android:id="@+id/listviewdrawermenuTextView1"/>
+
+</RelativeLayout>
diff --git a/libaes/src/main/res/layout/view_adsbanner.xml b/libaes/src/main/res/layout/view_adsbanner.xml
new file mode 100644
index 0000000..db95803
--- /dev/null
+++ b/libaes/src/main/res/layout/view_adsbanner.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:id="@+id/ads_container"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+	<LinearLayout
+		android:id="@+id/ads_container"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="vertical" android:background="@drawable/bg_container_border" />
+
+</LinearLayout>
diff --git a/libaes/src/main/res/layout/view_adscontrol.xml b/libaes/src/main/res/layout/view_adscontrol.xml
new file mode 100644
index 0000000..23a29b3
--- /dev/null
+++ b/libaes/src/main/res/layout/view_adscontrol.xml
@@ -0,0 +1,75 @@
+<?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_container_border">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="应用支持模式设置："
+        android:textSize="16sp"
+        android:layout_marginBottom="12dp"/>
+
+    <RadioGroup
+        android:id="@+id/rg_ads_mode"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical">
+
+        <RadioButton
+            android:id="@+id/rb_standalone"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="无扰单机模式"
+            android:textSize="14sp"
+            android:layout_marginBottom="8dp"/>
+
+        <RadioButton
+            android:id="@+id/rb_mimo_sdk"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="米盟广告模式"
+            android:textSize="14sp"
+            android:layout_marginBottom="8dp"/>
+
+        <RadioButton
+            android:id="@+id/rb_store_qrcode"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="云宝物语模式"
+            android:textSize="14sp"/>
+
+    </RadioGroup>
+
+    <!-- 关键修改：添加layout_marginTop="0dp" 移除顶部间距，设置layout_marginTop为负值可进一步紧贴 -->
+    <RelativeLayout
+        android:id="@+id/rl_winboll_store"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:visibility="gone"
+        android:layout_marginTop="0dp"> <!-- 移除顶部多余间距 -- android:background="@drawable/bg_container_border">
+
+        <ImageView
+            android:id="@+id/iv_winboll_store"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:src="@drawable/ic_winboll_store"
+            android:scaleType="centerInside"
+            android:layout_centerInParent="true"
+            android:adjustViewBounds="true"/> <!-- 让图片自适应尺寸，无多余空白 -->
+
+        <TextView
+            android:id="@+id/view_popmenu_anchor_point"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="Text"
+            android:layout_centerInParent="true"
+            android:visibility="invisible"/>
+
+    </RelativeLayout>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/viewpage_acard.xml b/libaes/src/main/res/layout/viewpage_acard.xml
new file mode 100644
index 0000000..e15effb
--- /dev/null
+++ b/libaes/src/main/res/layout/viewpage_acard.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="ACard"/>
+
+	<cc.winboll.studio.libaes.views.ACard
+		android:layout_width="200dp"
+		android:layout_height="200dp"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/viewpage_aohpctccard.xml b/libaes/src/main/res/layout/viewpage_aohpctccard.xml
new file mode 100644
index 0000000..7ea16e4
--- /dev/null
+++ b/libaes/src/main/res/layout/viewpage_aohpctccard.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="AOHPCTSCard"/>
+
+	<cc.winboll.studio.libaes.views.AOHPCTSCard
+		android:layout_width="100dp"
+		android:layout_height="100dp"/>
+
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/viewpage_aohpctcsb.xml b/libaes/src/main/res/layout/viewpage_aohpctcsb.xml
new file mode 100644
index 0000000..b94e390
--- /dev/null
+++ b/libaes/src/main/res/layout/viewpage_aohpctcsb.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:gravity="center" android:background="@drawable/bg_container_border">
+
+	<TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="AOHPCTCSeekBar"/>
+    
+    <LinearLayout
+        android:orientation="vertical"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:gravity="center" android:background="@drawable/bg_container_border">
+
+        <cc.winboll.studio.libaes.views.AOHPCTCSeekBar
+            android:layout_width="300dp"
+            android:layout_height="wrap_content"
+            android:id="@+id/fragmentviewpageAOHPCTCSeekBar1"
+            android:padding="10dp"/>
+
+        <cc.winboll.studio.libaes.views.AOHPCTCSeekBar
+            android:layout_width="300dp"
+            android:layout_height="wrap_content"
+            android:id="@+id/fragmentviewpageAOHPCTCSeekBar2"
+            android:padding="10dp"/>
+
+    </LinearLayout>
+	
+</LinearLayout>
+
diff --git a/libaes/src/main/res/layout/viewpage_atickprogressbar.xml b/libaes/src/main/res/layout/viewpage_atickprogressbar.xml
new file mode 100644
index 0000000..b84a703
--- /dev/null
+++ b/libaes/src/main/res/layout/viewpage_atickprogressbar.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="ATickProgressBar"/>
+
+	<cc.winboll.studio.libaes.views.ATickProgressBar
+		style="@android:style/Widget.ProgressBar.Horizontal"
+		android:layout_width="200dp"
+		android:layout_height="200dp"/>
+    <ProgressBar
+        android:layout_width="200dp"
+        android:layout_height="200dp"/>
+    
+</LinearLayout>
+
diff --git a/libaes/src/main/res/menu/menu_qrcode_long_click.xml b/libaes/src/main/res/menu/menu_qrcode_long_click.xml
new file mode 100644
index 0000000..6b423fa
--- /dev/null
+++ b/libaes/src/main/res/menu/menu_qrcode_long_click.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/menu_item_visit_store"
+        android:title="访问小店"/>
+</menu>
diff --git a/libaes/src/main/res/menu/toolbar_appdebug.xml b/libaes/src/main/res/menu/toolbar_appdebug.xml
new file mode 100644
index 0000000..54419f2
--- /dev/null
+++ b/libaes/src/main/res/menu/toolbar_appdebug.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <item android:title="Develop">
+        <menu >
+            <item
+                android:id="@+id/item_testappcrash"
+                android:title="TestAppCrash"/>
+			<item
+				android:id="@+id/item_log"
+				android:title="Log"/>
+        </menu>
+    </item>
+</menu>
diff --git a/libaes/src/main/res/menu/toolbar_apptheme.xml b/libaes/src/main/res/menu/toolbar_apptheme.xml
new file mode 100644
index 0000000..f9fca32
--- /dev/null
+++ b/libaes/src/main/res/menu/toolbar_apptheme.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item android:title="@string/text_AppTheme">
+        <menu >
+            <item
+                android:id="@+id/item_defaulttheme"
+                android:title="@string/text_DefaultTheme"/>
+            <item
+                android:id="@+id/item_depththeme"
+                android:title="@string/text_DepthTheme"/>
+            <item
+                android:id="@+id/item_skytheme"
+                android:title="@string/text_SkyTheme"/>
+            <item
+                android:id="@+id/item_goldentheme"
+                android:title="@string/text_GoldenTheme"/>
+            <item
+                android:id="@+id/item_bearingtheme"
+                android:title="@string/text_BearingTheme"/>
+            <item
+                android:id="@+id/item_memortheme"
+                android:title="@string/text_MemorTheme"/>
+            <item
+                android:id="@+id/item_taotheme"
+                android:title="@string/text_TaoTheme"/>
+        </menu>
+    </item>
+</menu>
diff --git a/libaes/src/main/res/menu/toolbar_drawerbase.xml b/libaes/src/main/res/menu/toolbar_drawerbase.xml
new file mode 100644
index 0000000..66df226
--- /dev/null
+++ b/libaes/src/main/res/menu/toolbar_drawerbase.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+  
+</menu>
diff --git a/libaes/src/main/res/menu/toolbar_secondarylibrary.xml b/libaes/src/main/res/menu/toolbar_secondarylibrary.xml
new file mode 100644
index 0000000..72cdd43
--- /dev/null
+++ b/libaes/src/main/res/menu/toolbar_secondarylibrary.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    <item
+        android:id="@+id/item_test"
+        android:title="TestItem"/>
+    
+</menu>
diff --git a/libaes/src/main/res/values-night/colors.xml b/libaes/src/main/res/values-night/colors.xml
new file mode 100644
index 0000000..3935b96
--- /dev/null
+++ b/libaes/src/main/res/values-night/colors.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <color name="colorTextColor">#FFFFFFFF</color>
+    <color name="colorPrimary">#FF03AB4E</color>
+    <color name="colorPrimaryDark">#FF027C39</color>
+    <color name="colorAccent">#FF3DDC84</color>
+    <color name="colorText">#FFFFFB8D</color>
+    <color name="colorToastFrame">#FFA9A9A9</color>
+    <color name="colorToastShadow">#FF000000</color>
+    <color name="colorToastBackgroung">#FFFFFFFF</color>
+    <color name="colorAToolbarStartColor">#FF7D3F12</color>
+    <color name="colorAToolbarCenterColor">#FFCC6E2B</color>
+    <color name="colorAToolbarEndColor">#FFF4B98F</color>
+
+    <color name="colorACardShadow">@color/colorPrimaryDark</color>
+    <color name="colorACardFrame">@color/colorPrimary</color>
+    <color name="colorACardBackgroung">@color/colorAccent</color>
+
+    <color name="colorATickProgressBarBackgroung">@color/colorAccent</color>
+    <color name="colorATickProgressBarProgress">@color/colorPrimary</color>
+
+    <color name="colorOHPCTSBackground">@color/colorAccent</color>
+    <color name="colorOHPCTSSecondaryProgress">@color/colorPrimary</color>
+    <color name="colorOHPCTSProgress">@color/colorPrimaryDark</color>
+
+    <color name="toolbarBackgroundColor">#FF03AB4E</color>
+    <color name="toolbarTextColor">#FFFFFFFF</color>
+    <color name="mainWindowBackgroundColor">#FF2C2C2C</color>
+    <color name="mainWindowTextColor">#FFFFFFFF</color>
+    <color name="debugTextColor">#FFFF0000</color>
+
+</resources>
\ No newline at end of file
diff --git a/libaes/src/main/res/values-night/styles.xml b/libaes/src/main/res/values-night/styles.xml
new file mode 100644
index 0000000..020baff
--- /dev/null
+++ b/libaes/src/main/res/values-night/styles.xml
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <style name="AESTheme" parent="Theme.AppCompat.NoActionBar">
+        <item name="themeDebug">@style/DebugActivityTheme</item>
+        <item name="aboutViewBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="aboutViewTextColor">@color/mainWindowTextColor</item>
+        <item name="aboutViewTitleColor">@color/mainWindowTextColor</item>
+        <item name="aboutViewDividerColor">@color/mainWindowTextColor</item>
+        <item name="dialogBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="dialogTextColor">@color/mainWindowTextColor</item>
+        <item name="toolbarBackgroundColor">@color/toolbarBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+        <item name="textViewBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="textViewTextColor">@color/mainWindowTextColor</item>
+        <item name="editTextBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="editTextTextColor">@color/mainWindowTextColor</item>
+        <item name="scrollViewBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="activityBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="activityTextColor">@color/mainWindowTextColor</item>
+        <item name="mainWindowBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowTextColor">@color/mainWindowTextColor</item>
+        <item name="mainWindowDarkBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowDarkTextColor">@color/mainWindowTextColor</item>
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+
+        <item name="aToolbar">@style/AESAToolbar</item>
+        <item name="aSupportToolbar">@style/AESASupportToolbar</item>
+    </style>
+
+    <style name="DebugActivityTheme" parent="Theme.AppCompat.NoActionBar">
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+        <item name="colorTittle">@color/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">@color/toolbarBackgroundColor</item>
+        <item name="colorText">@color/debugTextColor</item>
+        <item name="colorTextBackgound">@color/mainWindowBackgroundColor</item>
+        <item name="debugTextColor">@color/debugTextColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+    </style>
+
+    <style name="AESAToolbar">
+        <item name="attrAToolbarTitleTextColor">@color/colorTextColor</item>
+        <item name="attrAToolbarStartColor">@color/colorPrimaryDark</item>
+        <item name="attrAToolbarCenterColor">@color/colorPrimary</item>
+        <item name="attrAToolbarEndColor">@color/colorAccent</item>
+    </style>
+
+    <style name="AESASupportToolbar">
+        <item name="attrASupportToolbarTitleTextColor">@color/colorTextColor</item>
+        <item name="attrASupportToolbarStartColor">@color/colorPrimaryDark</item>
+        <item name="attrASupportToolbarCenterColor">@color/colorPrimary</item>
+        <item name="attrASupportToolbarEndColor">@color/colorAccent</item>
+    </style>
+
+    <style name="DepthAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FF0065EC</item>
+        <item name="colorPrimaryDark">#FF004DB4</item>
+        <item name="colorAccent">#FF4A97FF</item>
+    </style>
+
+    <style name="SkyAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FF00A6FF</item>
+        <item name="colorPrimaryDark">#FF007ABB</item>
+        <item name="colorAccent">#FF84D4FF</item>
+    </style>
+
+    <style name="GoldenAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FFF0CA11</item>
+        <item name="colorPrimaryDark">#FFD3AF00</item>
+        <item name="colorAccent">#FFFFE35C</item>
+    </style>
+
+    <style name="BearingAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FF840FFF</item>
+        <item name="colorPrimaryDark">#FF6900D7</item>
+        <item name="colorAccent">#FFBA78FF</item>
+    </style>
+
+    <style name="MemorAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FFFF00F5</item>
+        <item name="colorPrimaryDark">#FFE500DC</item>
+        <item name="colorAccent">#FFFF76FA</item>
+    </style>
+
+    <style name="TaoAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FFACACAC</item>
+        <item name="colorPrimaryDark">#FF898989</item>
+        <item name="colorAccent">#FFD8D8D8</item>
+    </style>
+
+    <style name="NormalDialogStyle" parent="Theme.AppCompat.Dialog">
+        <item name="android:windowBackground">@android:color/transparent</item>
+        <item name="android:windowFrame">@null</item>
+        <item name="android:windowNoTitle">true</item>
+        <item name="android:windowIsFloating">true</item>
+        <item name="android:windowIsTranslucent">false</item>
+        <item name="android:windowContentOverlay">@null</item>
+        <item name="android:windowAnimationStyle">@style/cornerDialogAnim</item>
+        <item name="android:backgroundDimEnabled">true</item>
+    </style>
+
+    <style name="centerDialogAnim" parent="android:Animation">
+        <item name="@android:windowEnterAnimation">@anim/normal_dialog_enter_center</item>
+        <item name="@android:windowExitAnimation">@anim/normal_dialog_exit_center</item>
+    </style>
+
+    <style name="cornerDialogAnim" parent="android:Animation">
+        <item name="@android:windowEnterAnimation">@anim/normal_dialog_enter_corner</item>
+        <item name="@android:windowExitAnimation">@anim/normal_dialog_exit_corner</item>
+    </style>
+
+</resources>
\ No newline at end of file
diff --git a/libaes/src/main/res/values-zh/string.xml b/libaes/src/main/res/values-zh/string.xml
new file mode 100644
index 0000000..2d5fdbc
--- /dev/null
+++ b/libaes/src/main/res/values-zh/string.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libaes</string>
+    <string name="lib_description">云宝APP应用安卓元素类库示例。源码仅供调试参考，请勿直接引用。(WinBoLL APP application Android element class library example. The source is just for demo debug test, Do not quote directly.)</string>
+    <string name="lib_home">https://winboll.cc/aes</string>
+    <string name="text_about">关于</string>
+    <string name="text_AppTheme">应用主题</string>
+    <string name="text_DefaultTheme">默认主题</string>
+    <string name="text_DepthTheme">深奥主题</string>
+    <string name="text_SkyTheme">天空主题</string>
+    <string name="text_GoldenTheme">辉煌主题</string>
+    <string name="text_BearingTheme">智芋主题</string>
+    <string name="text_MemorTheme">梦箩主题</string>
+    <string name="text_TaoTheme">黑白主题</string>
+
+</resources>
diff --git a/libaes/src/main/res/values/attrs.xml b/libaes/src/main/res/values/attrs.xml
new file mode 100644
index 0000000..51786dd
--- /dev/null
+++ b/libaes/src/main/res/values/attrs.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    
+    <attr name="borderCornerRadius" format="dimension" />
+    <attr name="colorTextColor" format="color" />
+    <attr name="colorPrimary" format="color" />
+    <attr name="colorPrimaryDark" format="color" />
+    <attr name="colorAccent" format="color" />
+    
+    <attr name="aToolbar" format="reference"/>
+    <attr name="attrAToolbarTitleTextColor" format="color" />
+    <attr name="attrAToolbarStartColor" format="color" />
+    <attr name="attrAToolbarCenterColor" format="color" />
+    <attr name="attrAToolbarEndColor" format="color" />
+        
+	<declare-styleable name="AboutView">
+        <attr name="app_name" format="string" />
+        <attr name="app_apkfoldername" format="string" />
+        <attr name="app_apkname" format="string" />
+        <attr name="app_gitname" format="string" />
+        <attr name="app_gitowner" format="string" />
+        <attr name="app_gitappbranch" format="string" />
+        <attr name="app_gitappsubprojectfolder" format="string" />
+        <attr name="appdescription" format="string" />
+        <attr name="appicon" format="reference" />
+        <attr name="is_adddebugtools" format="boolean" />
+    </declare-styleable>
+    
+    <declare-styleable name="AToolbar">
+        <attr name="attrAToolbarTitleTextColor"/>
+        <attr name="attrAToolbarStartColor"/>
+        <attr name="attrAToolbarCenterColor"/>
+        <attr name="attrAToolbarEndColor"/>
+    </declare-styleable>
+    
+    <attr name="aSupportToolbar" format="reference"/>
+    <attr name="attrASupportToolbarTitleTextColor" format="color" />
+    <attr name="attrASupportToolbarStartColor" format="color" />
+    <attr name="attrASupportToolbarCenterColor" format="color" />
+    <attr name="attrASupportToolbarEndColor" format="color" />
+	
+    <declare-styleable name="ASupportToolbar">
+        <attr name="attrASupportToolbarTitleTextColor"/>
+        <attr name="attrASupportToolbarStartColor"/>
+        <attr name="attrASupportToolbarCenterColor"/>
+        <attr name="attrASupportToolbarEndColor"/>
+        <attr name="android:background"/>
+    </declare-styleable>
+    
+    <declare-styleable name="AButton">
+        <attr name="attrAButtonTextColor" format="color" />
+        <attr name="attrAButtonPrimary" format="color" />
+        <attr name="attrAButtonPrimaryDark" format="color" />
+        <attr name="attrAButtonAccent" format="color" />
+    </declare-styleable>
+    
+    <attr name="ActionSheetList" format="reference"/>
+    <!--<declare-styleable name="AToolbarStyle">
+		<attr name="attrAToolbarStartColor" format="color" />
+		<attr name="attrAToolbarCenterColor" format="color" />
+		<attr name="attrAToolbarEndColor" format="color" />
+	</declare-styleable>-->
+    <declare-styleable name="ACard">
+        <attr name="attrACardBackgroudColor" format="color" />
+        <attr name="attrACardShadowColor" format="color" />
+        <attr name="attrACardFrameColor" format="color" />
+    </declare-styleable>
+    <declare-styleable name="ATickProgressBar">
+        <attr name="attrATickProgressBarBackgroudColor" format="color" />
+        <attr name="attrATickProgressBarProgressColor" format="color" />
+    </declare-styleable>
+    <declare-styleable name="OneHundredPercantClickToSendProgressBar">
+        <attr name="attrOHPCTSBackgroundColor" format="color" />
+        <attr name="attrOHPCTSSecondaryProgressColor" format="color" />
+        <attr name="attrOHPCTSProgressColor" format="color" />
+    </declare-styleable>
+</resources>
diff --git a/libaes/src/main/res/values/colors.xml b/libaes/src/main/res/values/colors.xml
new file mode 100644
index 0000000..5c0a9cc
--- /dev/null
+++ b/libaes/src/main/res/values/colors.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <color name="colorTextColor">#FF000000</color>
+    <color name="colorPrimary">#FF03AB4E</color>
+    <color name="colorPrimaryDark">#FF027C39</color>
+    <color name="colorAccent">#FF3DDC84</color>
+    <color name="colorText">#FFFFFB8D</color>
+    <color name="colorToastFrame">#FFA9A9A9</color>
+    <color name="colorToastShadow">#FF000000</color>
+    <color name="colorToastBackgroung">#FFFFFFFF</color>
+    <color name="colorAToolbarStartColor">#FF7D3F12</color>
+    <color name="colorAToolbarCenterColor">#FFCC6E2B</color>
+    <color name="colorAToolbarEndColor">#FFF4B98F</color>
+
+    <color name="colorACardShadow">@color/colorPrimaryDark</color>
+    <color name="colorACardFrame">@color/colorPrimary</color>
+    <color name="colorACardBackgroung">@color/colorAccent</color>
+
+    <color name="colorATickProgressBarBackgroung">@color/colorAccent</color>
+    <color name="colorATickProgressBarProgress">@color/colorPrimary</color>
+
+    <color name="colorOHPCTSBackground">@color/colorAccent</color>
+    <color name="colorOHPCTSSecondaryProgress">@color/colorPrimary</color>
+    <color name="colorOHPCTSProgress">@color/colorPrimaryDark</color>
+
+    <color name="toolbarBackgroundColor">#FF03AB4E</color>
+    <color name="toolbarTextColor">#FFFFFFFF</color>
+    <color name="mainWindowBackgroundColor">#FFFFFFFF</color>
+    <color name="mainWindowTextColor">#FF000000</color>
+    <color name="debugTextColor">#FFFF0000</color>
+
+</resources>
\ No newline at end of file
diff --git a/libaes/src/main/res/values/dimens.xml b/libaes/src/main/res/values/dimens.xml
new file mode 100644
index 0000000..859a2ab
--- /dev/null
+++ b/libaes/src/main/res/values/dimens.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!--<item name="top_weight" type="dimen" format="integer">5</item>
+    要在xml中引用上述定义的dimens，可以使用@dimen/text_line_spacing。 
+    要在代码中引用上述定义的dimens，可以使用如下代码。
+    TypedValue outValue = new TypedValue();
+    getResources().getValue(R.dimen.text_line_spacing, outValue, true);
+    float value = outValue.getFloat();
+    注意：不能通过getResources().getDimension(R.dimen.text_line_spacing);方式来引用，如果用这种方式引用上述方法定义的dimens，编译时不会报错，但是运行时会抛出NotFoundException。
+    参考：https://blog.csdn.net/qluojieq/article/details/49591535?app_version=5.15.7&code=app_1562916241&csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%2249591535%22%2C%22source%22%3A%22weixin_38986226%22%7D&uLinkId=usr1mkqgl919blen&utm_source=app
+    -->
+    <item name="dialogPivotX" type="dimen" format="integer">900</item>
+    <item name="dialogPivotY" type="dimen" format="integer">-900</item>
+    <!--<item name="buttonHeight" type="dimen">100px</item>-->
+
+</resources>
diff --git a/libaes/src/main/res/values/strings.xml b/libaes/src/main/res/values/strings.xml
new file mode 100644
index 0000000..a5b7663
--- /dev/null
+++ b/libaes/src/main/res/values/strings.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libaes</string>
+    <string name="lib_description">云宝APP应用安卓元素类库示例。源码仅供调试参考，请勿直接引用。(WinBoLL APP application Android element class library example. The source is just for demo debug test, Do not quote directly.)</string>
+    <string name="lib_home">https://winboll.cc/libaes</string>
+    <string name="text_about">About</string>
+    <string name="text_AppTheme">AppTheme</string>
+    <string name="text_DefaultTheme">DefaultTheme</string>
+    <string name="text_DepthTheme">DepthTheme</string>
+    <string name="text_SkyTheme">SkyTheme</string>
+    <string name="text_GoldenTheme">GoldenTheme</string>
+    <string name="text_BearingTheme">BearingTheme</string>
+    <string name="text_MemorTheme">MemorTheme</string>
+    <string name="text_TaoTheme">TaoTheme</string>
+
+    <string name="app_normal">Click here is switch to Normal APP</string>
+    <string name="app_debug">Click here is switch to APP DEBUG</string>
+	<string name="gitea_home">GITEA HOME</string>
+    <string name="app_update">APP UPDATE</string>
+
+</resources>
diff --git a/libaes/src/main/res/values/styles.xml b/libaes/src/main/res/values/styles.xml
new file mode 100644
index 0000000..8354a03
--- /dev/null
+++ b/libaes/src/main/res/values/styles.xml
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <style name="AESTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="themeDebug">@style/DebugActivityTheme</item>
+        <item name="aboutViewBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="aboutViewTextColor">@color/mainWindowTextColor</item>
+        <item name="aboutViewTitleColor">@color/mainWindowTextColor</item>
+        <item name="aboutViewDividerColor">@color/mainWindowTextColor</item>
+        <item name="dialogBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="dialogTextColor">@color/mainWindowTextColor</item>
+        <item name="toolbarBackgroundColor">@color/toolbarBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+        <item name="textViewBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="textViewTextColor">@color/mainWindowTextColor</item>
+        <item name="editTextBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="editTextTextColor">@color/mainWindowTextColor</item>
+        <item name="scrollViewBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="activityBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="activityTextColor">@color/mainWindowTextColor</item>
+        <item name="mainWindowBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowTextColor">@color/mainWindowTextColor</item>
+        <item name="mainWindowDarkBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowDarkTextColor">@color/mainWindowTextColor</item>
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+
+        <item name="aToolbar">@style/AESAToolbar</item>
+        <item name="aSupportToolbar">@style/AESASupportToolbar</item>
+    </style>
+
+    <style name="DebugActivityTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+        <item name="colorTittle">@color/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">@color/toolbarBackgroundColor</item>
+        <item name="colorText">@color/debugTextColor</item>
+        <item name="colorTextBackgound">@color/mainWindowBackgroundColor</item>
+        <item name="debugTextColor">@color/debugTextColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+    </style>
+
+    <style name="AESAToolbar">
+        <item name="attrAToolbarTitleTextColor">@color/colorTextColor</item>
+        <item name="attrAToolbarStartColor">@color/colorPrimaryDark</item>
+        <item name="attrAToolbarCenterColor">@color/colorPrimary</item>
+        <item name="attrAToolbarEndColor">@color/colorAccent</item>
+    </style>
+
+    <style name="AESASupportToolbar">
+        <item name="attrASupportToolbarTitleTextColor">@color/colorTextColor</item>
+        <item name="attrASupportToolbarStartColor">@color/colorPrimaryDark</item>
+        <item name="attrASupportToolbarCenterColor">@color/colorPrimary</item>
+        <item name="attrASupportToolbarEndColor">@color/colorAccent</item>
+    </style>
+
+    <style name="DepthAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FF0065EC</item>
+        <item name="colorPrimaryDark">#FF004DB4</item>
+        <item name="colorAccent">#FF4A97FF</item>
+    </style>
+
+    <style name="SkyAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FF00A6FF</item>
+        <item name="colorPrimaryDark">#FF007ABB</item>
+        <item name="colorAccent">#FF84D4FF</item>
+    </style>
+
+    <style name="GoldenAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FFF0CA11</item>
+        <item name="colorPrimaryDark">#FFD3AF00</item>
+        <item name="colorAccent">#FFFFE35C</item>
+    </style>
+
+    <style name="BearingAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FF840FFF</item>
+        <item name="colorPrimaryDark">#FF6900D7</item>
+        <item name="colorAccent">#FFBA78FF</item>
+    </style>
+
+    <style name="MemorAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FFFF00F5</item>
+        <item name="colorPrimaryDark">#FFE500DC</item>
+        <item name="colorAccent">#FFFF76FA</item>
+    </style>
+
+    <style name="TaoAESTheme" parent="AESTheme">
+        <item name="colorPrimary">#FFACACAC</item>
+        <item name="colorPrimaryDark">#FF898989</item>
+        <item name="colorAccent">#FFD8D8D8</item>
+    </style>
+
+    <style name="NormalDialogStyle" parent="Theme.AppCompat.Light.Dialog">
+        <item name="android:windowBackground">@android:color/transparent</item>
+        <item name="android:windowFrame">@null</item>
+        <item name="android:windowNoTitle">true</item>
+        <item name="android:windowIsFloating">true</item>
+        <item name="android:windowIsTranslucent">false</item>
+        <item name="android:windowContentOverlay">@null</item>
+        <item name="android:windowAnimationStyle">@style/cornerDialogAnim</item>
+        <item name="android:backgroundDimEnabled">true</item>
+    </style>
+
+    <style name="centerDialogAnim" parent="android:Animation">
+        <item name="@android:windowEnterAnimation">@anim/normal_dialog_enter_center</item>
+        <item name="@android:windowExitAnimation">@anim/normal_dialog_exit_center</item>
+    </style>
+
+    <style name="cornerDialogAnim" parent="android:Animation">
+        <item name="@android:windowEnterAnimation">@anim/normal_dialog_enter_corner</item>
+        <item name="@android:windowExitAnimation">@anim/normal_dialog_exit_corner</item>
+    </style>
+
+</resources>
\ No newline at end of file
diff --git a/libaes/src/main/res/xml/file_provider.xml b/libaes/src/main/res/xml/file_provider.xml
new file mode 100644
index 0000000..3e2adb3
--- /dev/null
+++ b/libaes/src/main/res/xml/file_provider.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths>
+    <external-path path="mimoDownload" name="files_root" />
+    <external-path path="." name="external_storage_root" />
+    <!-- 授权应用缓存目录的访问权限 -->
+    <cache-path
+        name="cache_qrcode"
+        path="./" />
+</paths>
diff --git a/libaes/src/main/res/xml/network_security_config.xml b/libaes/src/main/res/xml/network_security_config.xml
new file mode 100644
index 0000000..ba3f407
--- /dev/null
+++ b/libaes/src/main/res/xml/network_security_config.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <!-- 允许 winboll.cc 及其子域名的明文流量（HTTP） -->
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">winboll.cc</domain>
+    </domain-config>
+	<!-- 米盟 SDK 配置 -->
+    <base-config cleartextTrafficPermitted="true" />
+    <debug-overrides>
+        <trust-anchors>
+            <!-- Trust user added CAs while debuggable only -->
+            <certificates src="system" />
+            <certificates src="user" />
+        </trust-anchors>
+    </debug-overrides>
+</network-security-config>
diff --git a/libappbase/.gitignore b/libappbase/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/libappbase/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/libappbase/build.gradle b/libappbase/build.gradle
new file mode 100644
index 0000000..2e7654e
--- /dev/null
+++ b/libappbase/build.gradle
@@ -0,0 +1,38 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        minSdkVersion 26
+        targetSdkVersion 30
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+     compileOptions {
+         sourceCompatibility JavaVersion.VERSION_1_7
+         targetCompatibility JavaVersion.VERSION_1_7
+     }
+}
+
+dependencies {
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// Gson
+	api 'com.google.code.gson:gson:2.8.9'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+	// 添加JSch依赖（SFTP核心，com.jcraft:jsch:0.1.54）
+	api 'com.jcraft:jsch:0.1.54'
+
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/libappbase/build.properties b/libappbase/build.properties
new file mode 100644
index 0000000..8d3d61f
--- /dev/null
+++ b/libappbase/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Tue May 12 09:16:45 HKT 2026
+stageCount=10
+libraryProject=libappbase
+baseVersion=15.20
+publishVersion=15.20.9
+buildCount=0
+baseBetaVersion=15.20.10
diff --git a/libappbase/proguard-rules.pro b/libappbase/proguard-rules.pro
new file mode 100644
index 0000000..536058a
--- /dev/null
+++ b/libappbase/proguard-rules.pro
@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:/tools/adt-bundle-windows-x86_64-20131030/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
diff --git a/libappbase/src/main/AndroidManifest.xml b/libappbase/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..bbfd3f3
--- /dev/null
+++ b/libappbase/src/main/AndroidManifest.xml
@@ -0,0 +1,59 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.libappbase">
+
+    <!-- 拥有完全的网络访问权限 -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+
+    <!-- 读取您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <!-- 修改或删除您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <!-- MANAGE_EXTERNAL_STORAGE -->
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <application
+        android:requestLegacyExternalStorage="true"
+        android:networkSecurityConfig="@xml/network_security_config">
+
+        <activity
+            android:name=".CrashHandler$CrashActivity"
+            android:label="CrashActivity"
+            android:launchMode="singleInstance"
+            android:process=":CrashActivity"/>
+
+        <activity
+            android:name=".GlobalCrashActivity"
+            android:label="GlobalCrashActivity"
+            android:launchMode="singleInstance"
+            android:process=":GlobalCrashActivity"/>
+
+        <activity
+            android:name=".LogActivity"
+            android:label="LogActivity"
+            android:resizeableActivity="true"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation"
+            android:exported="true"
+            android:launchMode="singleInstance"
+            android:taskAffinity="cc.winboll.studio.libappbase.LogActivity"
+            android:process=":LogActivity">
+
+        </activity>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.NfcRsaLoginActivity"/>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.FTPBackupsActivity"/>
+
+        <activity
+            android:name=".utils.ShareLogActivity"
+            android:label="ShareLogActivity"
+            android:exported="true"
+            android:launchMode="singleTask"
+            android:theme="@android:style/Theme.NoDisplay"/>
+
+    </application>
+
+</manifest>
\ No newline at end of file
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/APPModel.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/APPModel.java
new file mode 100644
index 0000000..d4dc9ca
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/APPModel.java
@@ -0,0 +1,138 @@
+package cc.winboll.studio.libappbase;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:01
+ * @Describe WinBoLL 应用全局数据模型类
+ * 继承自 BaseBean，用于存储和管理应用的核心配置信息（如调试状态），
+ * 支持 JSON 序列化/反序列化，便于数据持久化或跨组件传递
+ */
+public class APPModel extends BaseBean {
+
+    /**
+     * 日志打印标签，用于区分当前类的日志输出
+     */
+    public static final String TAG = "APPModel";
+
+    /**
+     * 应用调试状态标识
+     * true：应用处于调试模式（可输出详细日志、启用调试功能等）
+     * false：应用处于正式模式（关闭调试相关功能，优化性能）
+     */
+    private boolean isDebugging = false; // 修正拼写：原 isDebuging -> isDebugging（符合命名规范）
+
+    /**
+     * 无参构造方法
+     * 初始化调试状态为默认值：false（正式模式）
+     */
+    public APPModel() {
+        this.isDebugging = false;
+    }
+
+    /**
+     * 带参构造方法
+     * 可通过参数指定应用的初始调试状态
+     * @param isDebugging 初始调试状态（true：调试模式；false：正式模式）
+     */
+    public APPModel(boolean isDebugging) {
+        this.isDebugging = isDebugging;
+    }
+
+    /**
+     * 设置应用调试状态
+     * @param isDebugging 目标调试状态（true：开启调试；false：关闭调试）
+     */
+    public void setIsDebugging(boolean isDebugging) {
+        this.isDebugging = isDebugging;
+    }
+
+    /**
+     * 获取当前应用调试状态
+     * @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);
+        // 序列化当前类的调试状态字段：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 {
+        // 先调用父类方法，解析父类中的字段（若 BaseBean 有可解析字段）
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            return true; // 父类已处理该字段，直接返回成功
+        } else {
+            // 解析当前类的字段
+            if (name.equals("isDebuging")) {
+                // 读取 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 中的 '}'）
+        jsonReader.endObject();
+        // 返回解析完成的实例（当前对象）
+        return this;
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/AppCrashSafetyWire.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/AppCrashSafetyWire.java
new file mode 100644
index 0000000..9391189
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/AppCrashSafetyWire.java
@@ -0,0 +1,194 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.ObjectInputStream;
+import java.io.ObjectOutputStream;
+
+/**
+ * 应用崩溃保险丝内部类（单例）
+ * 核心作用：限制短时间内重复崩溃，通过「熔断等级」控制崩溃页面启动策略
+ * 等级范围：MINI（1）~ MAX（2），每次崩溃等级-1，熔断后启动基础版崩溃页面
+ */
+public final class AppCrashSafetyWire {
+	
+	public static final String TAG = "AppCrashSafetyWire";
+	
+	/** 单例实例（volatile 保证多线程可见性） */
+	private static volatile AppCrashSafetyWire _AppCrashSafetyWire;
+
+	/** 当前熔断等级（1：最低防护；2：最高防护；≤0：熔断） */
+	private volatile Integer currentSafetyLevel;
+	/** 最低熔断等级（1，再崩溃则熔断） */
+	private static final int _MINI = 1;
+	/** 最高熔断等级（2，初始状态） */
+	private static final int _MAX = 2;
+
+	/**
+	 * 私有构造方法（单例模式，禁止外部实例化）
+	 * 初始化时加载本地存储的熔断等级
+	 */
+	private AppCrashSafetyWire() {
+		LogUtils.d(TAG, "AppCrashSafetyWire()");
+		currentSafetyLevel = loadCurrentSafetyLevel();
+	}
+
+	/**
+	 * 获取单例实例（双重检查锁定，线程安全）
+	 * @return AppCrashSafetyWire 单例
+	 */
+	public static synchronized AppCrashSafetyWire getInstance() {
+		if (_AppCrashSafetyWire == null) {
+			_AppCrashSafetyWire = new AppCrashSafetyWire();
+		}
+		return _AppCrashSafetyWire;
+	}
+
+	/**
+	 * 设置当前熔断等级（内存中）
+	 * @param currentSafetyLevel 目标等级（1~2）
+	 */
+	public void setCurrentSafetyLevel(int currentSafetyLevel) {
+		this.currentSafetyLevel = currentSafetyLevel;
+	}
+
+	/**
+	 * 获取当前熔断等级（内存中）
+	 * @return 当前等级（1~2 或 null）
+	 */
+	public int getCurrentSafetyLevel() {
+		return currentSafetyLevel;
+	}
+
+	/**
+	 * 保存熔断等级到本地文件（持久化，重启应用生效）
+	 * @param currentSafetyLevel 待保存的等级
+	 */
+	public void saveCurrentSafetyLevel(int currentSafetyLevel) {
+		LogUtils.d(TAG, "saveCurrentSafetyLevel()");
+		this.currentSafetyLevel = currentSafetyLevel;
+		try {
+			// 序列化等级到文件（ObjectOutputStream 写入 int）
+			ObjectOutputStream oos = new ObjectOutputStream(new FileOutputStream(CrashHandler._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());
+		}
+	}
+
+	/**
+	 * 从本地文件加载熔断等级（应用启动时初始化）
+	 * @return 加载的等级（文件不存在则初始化为 MAX（2））
+	 */
+	public int loadCurrentSafetyLevel() {
+		LogUtils.d(TAG, "loadCurrentSafetyLevel()");
+		try {
+			File f = new File(CrashHandler._CrashCountFilePath);
+			if (f.exists()) {
+				// 反序列化从文件读取等级
+				ObjectInputStream ois = new ObjectInputStream(new FileInputStream(CrashHandler._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;
+	}
+
+	/**
+	 * 熔断保险丝（每次崩溃调用，降低防护等级）
+	 * @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;
+	}
+
+	/**
+	 * 检查熔断等级是否在有效范围内（1~2）
+	 * @param safetyLevel 待检查的等级
+	 * @return true：在范围内（防护有效）；false：超出范围（已熔断）
+	 */
+	boolean isSafetyWireWorking(int safetyLevel) {
+		LogUtils.d(TAG, "isSafetyWireOK()");
+		LogUtils.d(TAG, String.format("SafetyLevel %d", safetyLevel));
+
+		if (safetyLevel >= _MINI && safetyLevel <= _MAX) {
+			LogUtils.d(TAG, String.format("In Safety Level"));
+			return true;
+		}
+		LogUtils.d(TAG, String.format("Out of Safety Level"));
+		return false;
+	}
+
+	/**
+	 * 立即恢复熔断等级到最高（2）
+	 * 用于重启应用后重置防护状态
+	 */
+	void resumeToMaximumImmediately() {
+		LogUtils.d(TAG, "resumeToMaximumImmediately() call saveCurrentSafetyLevel(_MAX)");
+		AppCrashSafetyWire.getInstance().saveCurrentSafetyLevel(_MAX);
+	}
+
+	/**
+	 * 关闭防护（设置等级为最低（1））
+	 * 下次崩溃直接熔断
+	 */
+	void off() {
+		LogUtils.d(TAG, "off()");
+		saveCurrentSafetyLevel(_MINI);
+	}
+
+	/**
+	 * 检查当前保险丝是否有效（防护未熔断）
+	 * @return true：有效（等级 1~2）；false：已熔断
+	 */
+	public boolean isAppCrashSafetyWireOK() {
+		LogUtils.d(TAG, "isAppCrashSafetyWireOK()");
+		currentSafetyLevel = loadCurrentSafetyLevel();
+		return isSafetyWireWorking(currentSafetyLevel);
+	}
+
+	/**
+	 * 延迟恢复保险丝到最高等级（500ms 后）
+	 * 核心作用：崩溃页面启动后，若下次即将熔断，提前恢复防护等级，避免持续崩溃
+	 * @param context 上下文（用于获取主线程 Handler）
+	 */
+	void postResumeCrashSafetyWireHandler(final Context context) {
+		// 主线程延迟 500ms 执行（避免页面启动时阻塞）
+		new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "Handler run()");
+					// 检查：若当前等级-1 后超出防护范围（即将熔断），则恢复到最高等级
+					if (!AppCrashSafetyWire.getInstance().isSafetyWireWorking(currentSafetyLevel - 1)) {
+						AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+						LogUtils.d(TAG, "postResumeCrashSafetyWireHandler: 恢复保险丝到最高等级");
+					}
+				}
+			}, 500);
+	}
+}
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/BaseBean.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/BaseBean.java
new file mode 100644
index 0000000..372e6ef
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/BaseBean.java
@@ -0,0 +1,436 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.File;
+import java.io.IOException;
+import java.io.StringReader;
+import java.io.StringWriter;
+import java.util.ArrayList;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:03
+ * @Describe WinBoLL JSON 数据模型基类（抽象类）
+ * 定义 Json Bean 的核心规范：序列化/反序列化、文件持久化、列表处理等通用逻辑，
+ * 子类（如 APPModel）需实现抽象方法，实现自身字段的 JSON 读写
+ * @param <T> 泛型约束，限定子类必须继承自 BaseBean
+ */
+public abstract class BaseBean<T extends BaseBean> {
+
+	/** 日志标签，用于当前基类的日志输出标识 */
+	public static final String TAG = "BaseBean";
+	/** JSON 中存储 Bean 类名的字段键（用于校验 Bean 类型一致性） */
+	static final String BEAN_NAME = "BeanName";
+
+	/**
+	 * 无参构造方法（子类需默认实现，支持反射实例化）
+	 */
+	public BaseBean() {}
+
+	/**
+	 * 抽象方法：获取当前 Bean 的全限定类名
+	 * 子类需实现，用于标识 Bean 类型（序列化/校验时使用）
+	 * @return 类的全限定名（如：cc.winboll.studio.libappbase.APPModel）
+	 */
+	public abstract String getName();
+
+	/**
+	 * 获取单个 Bean 的 JSON 持久化文件路径
+	 * 路径：外部存储/应用私有目录/BaseBean/[类名].json
+	 * @param context 上下文（用于获取应用存储目录）
+	 * @return 单个 Bean 的文件绝对路径
+	 */
+	public String getBeanJsonFilePath(Context context) {
+		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";
+	}
+
+	/**
+	 * 将 Bean 类名写入 JSON（序列化基础字段）
+	 * 子类可重写扩展，添加自身字段的 JSON 写入逻辑
+	 * @param jsonWriter JSON 写入器（用于输出 JSON 数据）
+	 * @throws IOException JSON 写入失败时抛出（如流异常）
+	 */
+	public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+		// 写入 Bean 类名字段（用于反序列化时校验类型）
+		jsonWriter.name(BEAN_NAME).value(getName());
+	}
+
+	/**
+	 * 从 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
+	}
+
+	/**
+	 * 抽象方法：从 JSON 读取器解析并返回 Bean 实例
+	 * 子类需实现，处理自身字段的完整解析逻辑
+	 * @param jsonReader JSON 读取器（用于读取 JSON 数据）
+	 * @return 解析完成的 Bean 实例
+	 * @throws IOException JSON 读取失败时抛出（如流异常）
+	 */
+	abstract public T readBeanFromJsonReader(JsonReader jsonReader) throws IOException;
+
+	/**
+	 * 校验 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 : ";
+
+		try {
+			int sameCount = 0; // 类名匹配的 Bean 数量
+			int totalCount = 0; // 文件中 Bean 总数量
+
+			// 反射创建目标 Bean 实例（用于获取类名）
+			T beanTemp = clazz.newInstance();
+			String targetBeanName = beanTemp.getName();
+			// 读取文件中的 JSON 字符串
+			String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
+			StringReader stringReader = new StringReader(listJson);
+			JsonReader jsonReader = new JsonReader(stringReader);
+
+			jsonReader.beginArray(); // 开始解析 JSON 数组（Bean 列表）
+			while (jsonReader.hasNext()) {
+				totalCount++;
+				jsonReader.beginObject(); // 开始解析单个 Bean 对象
+				while (jsonReader.hasNext()) {
+					String name = jsonReader.nextName();
+					// 只校验 BEAN_NAME 字段，其他字段跳过
+					if (name.equals(BEAN_NAME)) {
+						// 对比当前 Bean 类名与目标类名
+						if (targetBeanName.equals(jsonReader.nextString())) {
+							sameCount++;
+						}
+					} else {
+						jsonReader.skipValue(); // 跳过非目标字段
+					}
+				}
+				jsonReader.endObject(); // 结束单个 Bean 对象解析
+			}
+			jsonReader.endArray(); // 结束 JSON 数组解析
+
+			// 生成校验结果
+			if (sameCount == totalCount) {
+				return ""; // 全部匹配，返回空串
+			} else {
+				// 部分不匹配，返回统计信息
+				sbResult.append("Total : ").append(totalCount)
+					.append(" Diff : ").append(totalCount - sameCount);
+			}
+		} catch (InstantiationException e) {
+			// 反射实例化失败（如无无参构造）
+			sbResult.append(szErrorInfo).append(e);
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		} catch (IllegalAccessException e) {
+			// 反射访问权限异常
+			sbResult.append(szErrorInfo).append(e);
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		} catch (IOException e) {
+			// 文件读取或 JSON 解析异常
+			sbResult.append(szErrorInfo).append(e);
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return sbResult.toString();
+	}
+
+	/**
+	 * 将 JSON 字符串解析为目标 Bean 实例
+	 * 通过反射创建 Bean 实例，调用子类解析逻辑完成初始化
+	 * @param szBean JSON 字符串（单个 Bean 的 JSON 数据）
+	 * @param clazz 目标 Bean 类（用于反射实例化）
+	 * @return 解析成功的 Bean 实例；失败返回 null
+	 * @throws IOException JSON 解析失败时抛出
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> T parseStringToBean(String szBean, Class<T> clazz) throws IOException {
+		StringReader stringReader = new StringReader(szBean);
+		JsonReader jsonReader = new JsonReader(stringReader);
+
+		try {
+			// 反射创建 Bean 实例
+			T beanTemp = clazz.newInstance();
+			// 调用子类解析方法，返回解析后的实例
+			return (T) beanTemp.readBeanFromJsonReader(jsonReader);
+		} catch (InstantiationException | IllegalAccessException e) {
+			// 反射异常日志记录
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return null;
+	}
+
+	/**
+	 * 将 JSON 字符串解析为 Bean 列表
+	 * 清空目标列表，将解析后的 Bean 逐个添加到列表中
+	 * @param szBeanList JSON 字符串（Bean 列表的 JSON 数组）
+	 * @param beanList 目标列表（存储解析后的 Bean）
+	 * @param clazz 目标 Bean 类（用于反射实例化）
+	 * @return true：解析成功；false：解析失败
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> boolean parseStringToBeanList(String szBeanList, ArrayList<T> beanList, Class<T> clazz) {
+		try {
+			// 初始化目标列表（为空则创建，非空则清空）
+			if (beanList == null) {
+				beanList = new ArrayList<T>();
+			} else {
+				beanList.clear();
+			}
+
+			StringReader stringReader = new StringReader(szBeanList);
+			JsonReader jsonReader = new JsonReader(stringReader);
+
+			jsonReader.beginArray(); // 开始解析 JSON 数组
+			while (jsonReader.hasNext()) {
+				// 反射创建 Bean 实例，解析并添加到列表
+				T beanTemp = clazz.newInstance();
+				T bean = (T) beanTemp.readBeanFromJsonReader(jsonReader);
+				if (bean != null) {
+					beanList.add(bean);
+				}
+			}
+			jsonReader.endArray(); // 结束 JSON 数组解析
+			return true;
+		} catch (InstantiationException | IllegalAccessException | IOException e) {
+			// 异常日志记录
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return false;
+	}
+
+	/**
+	 * 重写 toString()，将 Bean 序列化为格式化的 JSON 字符串
+	 * 调用自身序列化逻辑，生成带缩进的 JSON（便于调试）
+	 * @return Bean 的 JSON 字符串；失败返回空串
+	 */
+	@Override
+	public String toString() {
+		StringWriter stringWriter = new StringWriter();
+		JsonWriter jsonWriter = new JsonWriter(stringWriter);
+		jsonWriter.setIndent("  "); // 设置 JSON 缩进（格式化输出）
+
+		try {
+			jsonWriter.beginObject(); // 开始 JSON 对象
+			writeThisToJsonWriter(jsonWriter); // 写入 Bean 字段（子类扩展）
+			jsonWriter.endObject(); // 结束 JSON 对象
+			return stringWriter.toString();
+		} catch (IOException e) {
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return "";
+	}
+
+	/**
+	 * 将 Bean 列表序列化为格式化的 JSON 字符串
+	 * 遍历列表，逐个序列化每个 Bean，生成 JSON 数组
+	 * @param beanList 待序列化的 Bean 列表
+	 * @return 列表的 JSON 字符串；失败返回空串
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> String toStringByBeanList(ArrayList<T> beanList) {
+		try {
+			StringWriter stringWriter = new StringWriter();
+			JsonWriter jsonWriter = new JsonWriter(stringWriter);
+			jsonWriter.setIndent("  "); // 格式化缩进
+
+			jsonWriter.beginArray(); // 开始 JSON 数组
+			for (int i = 0; i < beanList.size(); i++) {
+				jsonWriter.beginObject(); // 单个 Bean 开始
+				beanList.get(i).writeThisToJsonWriter(jsonWriter); // 调用 Bean 自身序列化
+				jsonWriter.endObject(); // 单个 Bean 结束
+			}
+			jsonWriter.endArray(); // 结束 JSON 数组
+			jsonWriter.close();
+			return stringWriter.toString();
+		} catch (IOException e) {
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return "";
+	}
+
+	/**
+	 * 从默认路径（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;
+	}
+
+	/**
+	 * 从指定文件路径加载 Bean 实例
+	 * 检查文件是否存在，存在则读取 JSON 并解析为目标 Bean
+	 * @param szFilePath 目标文件路径（存储 Bean 的 JSON 文件）
+	 * @param clazz 目标 Bean 类（用于反射实例化）
+	 * @return 加载成功的 Bean 实例；失败返回 null
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> T loadBeanFromFile(String szFilePath, Class<T> clazz) {
+		try {
+			File file = new File(szFilePath);
+			if (file.exists()) { // 检查文件是否存在
+				T beanTemp = clazz.newInstance();
+				// 读取文件 JSON 字符串，解析为 Bean
+				String json = UTF8FileUtils.readStringFromFile(szFilePath);
+				return beanTemp.parseStringToBean(json, clazz);
+			}
+		} catch (InstantiationException | IllegalAccessException | IOException e) {
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return null;
+	}
+
+	/**
+	 * 将 Bean 保存到默认路径（getBeanJsonFilePath）的文件中
+	 * 序列化 Bean 为 JSON，写入应用私有目录下的文件
+	 * @param context 上下文（用于获取文件路径）
+	 * @param bean 待保存的 Bean 实例
+	 * @return true：保存成功；false：保存失败
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> boolean saveBean(Context context, T bean) {
+		return saveBeanToFile(bean.getBeanJsonFilePath(context), bean);
+	}
+
+	/**
+	 * 将 Bean 保存到指定文件路径
+	 * 序列化 Bean 为 JSON 字符串，写入目标文件（覆盖原有内容）
+	 * @param szFilePath 目标文件路径（保存 JSON 的文件）
+	 * @param bean 待保存的 Bean 实例
+	 * @return true：保存成功；false：保存失败
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> boolean saveBeanToFile(String szFilePath, T bean) {
+		try {
+			// 序列化 Bean 为 JSON 字符串
+			String json = bean.toString();
+			// 写入文件（UTF-8 编码）
+			UTF8FileUtils.writeStringToFile(szFilePath, json);
+			return true;
+		} catch (IOException e) {
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return false;
+	}
+
+	/**
+	 * 从默认路径（getBeanListJsonFilePath）加载 Bean 列表
+	 * 读取应用私有目录下的列表 JSON 文件，解析并填充到目标列表
+	 * @param context 上下文（用于获取文件路径）
+	 * @param beanListDst 目标列表（存储加载后的 Bean）
+	 * @param clazz 目标 Bean 类（用于反射实例化）
+	 * @return true：加载成功；false：加载失败
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> boolean loadBeanList(Context context, ArrayList<T> beanListDst, Class<T> clazz) {
+		try {
+			// 反射创建 Bean 实例，获取默认列表文件路径
+			T beanTemp = clazz.newInstance();
+			return loadBeanListFromFile(beanTemp.getBeanListJsonFilePath(context), beanListDst, clazz);
+		} catch (InstantiationException | IllegalAccessException e) {
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return false;
+	}
+
+	/**
+	 * 从指定文件路径加载 Bean 列表
+	 * 检查文件是否存在，存在则读取 JSON 数组，解析并填充到目标列表
+	 * @param szFilePath 目标文件路径（存储列表 JSON 的文件）
+	 * @param beanList 目标列表（存储加载后的 Bean）
+	 * @param clazz 目标 Bean 类（用于反射实例化）
+	 * @return true：加载成功；false：加载失败
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> boolean loadBeanListFromFile(String szFilePath, ArrayList<T> beanList, Class<T> clazz) {
+		try {
+			File file = new File(szFilePath);
+			if (file.exists()) { // 检查文件是否存在
+				// 读取文件中的 JSON 字符串（Bean 列表数组）
+				String listJson = UTF8FileUtils.readStringFromFile(szFilePath);
+				// 解析 JSON 字符串为 Bean 列表，填充到目标列表
+				return parseStringToBeanList(listJson, beanList, clazz);
+			}
+		} catch (IOException e) {
+			// 日志记录文件读取或解析异常
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return false;
+	}
+
+	/**
+	 * 将 Bean 列表保存到默认路径（getBeanListJsonFilePath）的文件中
+	 * 序列化列表为 JSON 数组，写入应用私有目录下的文件
+	 * @param context 上下文（用于获取文件路径）
+	 * @param beanList 待保存的 Bean 列表
+	 * @param clazz 目标 Bean 类（用于反射获取保存路径）
+	 * @return true：保存成功；false：保存失败
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> boolean saveBeanList(Context context, ArrayList<T> beanList, Class<T> clazz) {
+		try {
+			// 反射创建 Bean 实例，获取默认列表保存路径
+			T beanTemp = clazz.newInstance();
+			return saveBeanListToFile(beanTemp.getBeanListJsonFilePath(context), beanList);
+		} catch (InstantiationException | IllegalAccessException e) {
+			// 日志记录反射实例化异常
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return false;
+	}
+
+	/**
+	 * 将 Bean 列表保存到指定文件路径
+	 * 序列化列表为 JSON 数组字符串，写入目标文件（覆盖原有内容）
+	 * @param szFilePath 目标文件路径（保存列表 JSON 的文件）
+	 * @param beanList 待保存的 Bean 列表
+	 * @return true：保存成功；false：保存失败
+	 * @param <T> 泛型约束，限定为 BaseBean 子类
+	 */
+	public static <T extends BaseBean> boolean saveBeanListToFile(String szFilePath, ArrayList<T> beanList) {
+		try {
+			// 序列化 Bean 列表为 JSON 字符串（数组格式）
+			String json = toStringByBeanList(beanList);
+			// 将 JSON 字符串写入文件（UTF-8 编码）
+			UTF8FileUtils.writeStringToFile(szFilePath, json);
+			return true;
+		} catch (IOException e) {
+			// 日志记录文件写入或序列化异常
+			LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+		}
+		return false;
+	}
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/CrashHandler.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/CrashHandler.java
new file mode 100644
index 0000000..bfdcf5f
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/CrashHandler.java
@@ -0,0 +1,330 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Activity;
+import android.app.Application;
+import android.content.ActivityNotFoundException;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.res.Resources;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+import android.widget.HorizontalScrollView;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.utils.CrashHandleNotifyUtils;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.ObjectInputStream;
+import java.io.ObjectOutputStream;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+
+/**
+ * 应用全局崩溃处理类（单例逻辑）
+ * 核心功能：捕获应用未捕获异常，记录崩溃日志到文件，启动崩溃报告页面，
+ * 并通过「崩溃保险丝」机制防止重复崩溃，保障基础功能可用
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025/11/11 20:14:00
+ * @EditTime 2026/05/11 15:36:45
+ */
+public final class CrashHandler {
+
+    // ====================== 常量定义 ======================
+    /** 日志标签 */
+    public static final String TAG = "CrashHandler";
+    /** 崩溃报告页面标题 */
+    public static final String TITTLE = "CrashReport";
+    /** Intent 传递崩溃信息键 */
+    public static final String EXTRA_CRASH_LOG = "crashInfo";
+    /** SharedPreferences 存储键 */
+    static final String PREFS = CrashHandler.class.getName() + "PREFS";
+    /** 标记是否发生崩溃键 */
+    static final String PREFS_CRASHHANDLER_ISCRASHHAPPEN = "PREFS_CRASHHANDLER_ISCRASHHAPPEN";
+
+    // ====================== 成员变量 ======================
+    /** 崩溃保险丝状态文件路径 */
+    public static String _CrashCountFilePath;
+    /** 系统默认异常处理器兜底 */
+    public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER
+	= Thread.getDefaultUncaughtExceptionHandler();
+
+    // ====================== 对外初始化方法 ======================
+    /**
+     * 初始化崩溃处理器（默认存储路径）
+     * @param app 全局Application实例
+     */
+    public static void init(final Application app) {
+        _CrashCountFilePath = app.getExternalFilesDir("CrashHandler") + "/IsCrashHandlerCrashHappen.dat";
+        LogUtils.d(TAG, "init _CrashCountFilePath = " + _CrashCountFilePath);
+        init(app, null);
+    }
+
+    /**
+     * 初始化崩溃处理器（自定义日志目录）
+     * @param app 全局Application实例
+     * @param crashDir 自定义崩溃日志目录，传null使用默认
+     */
+    public static void init(final Application app, final String crashDir) {
+        Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandler() {
+				@Override
+				public void uncaughtException(final Thread thread, final Throwable throwable) {
+					try {
+						tryUncaughtException(thread, throwable, crashDir, app);
+					} catch (Throwable e) {
+						LogUtils.e(TAG, "uncaughtException error", e);
+						if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+							DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+						}
+					}
+				}
+			});
+    }
+
+    // ====================== 内部崩溃处理核心 ======================
+    /**
+     * 执行崩溃信息收集、日志写入、跳转崩溃页面
+     */
+    private static void tryUncaughtException(final Thread thread,
+											 final Throwable throwable,
+											 final String crashDir,
+											 final Application app) {
+        // 触发崩溃保险丝
+        AppCrashSafetyWire.getInstance().burnSafetyWire();
+
+        // 格式化时间
+        final String time = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss",
+												 Locale.getDefault()).format(new Date());
+
+        // 创建日志文件
+        File logParent = TextUtils.isEmpty(crashDir)
+			? new File(app.getExternalFilesDir(null), "crash")
+			: new File(crashDir);
+        final File crashFile = new File(logParent, "crash_" + time + ".txt");
+
+        // 获取应用版本信息
+        String versionName = "unknown";
+        long versionCode = 0;
+        try {
+            final PackageInfo packageInfo = app.getPackageManager()
+				.getPackageInfo(app.getPackageName(), 0);
+            versionName = packageInfo.versionName;
+            if (Build.VERSION.SDK_INT >= 28) {
+                versionCode = packageInfo.getLongVersionCode();
+            } else {
+                versionCode = packageInfo.versionCode;
+            }
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "get package info fail");
+        }
+
+        // 抓取异常堆栈
+        String fullStackTrace;
+        StringWriter sw = new StringWriter();
+        PrintWriter pw = new PrintWriter(sw);
+        throwable.printStackTrace(pw);
+        fullStackTrace = sw.toString();
+        pw.close();
+
+        // 拼接崩溃头部信息
+        StringBuilder sb = new StringBuilder();
+        sb.append("************* Crash Head ****************\n");
+        sb.append("Time Of Crash                        : ").append(time).append("\n");
+        sb.append("Device Manufacturer                  : ").append(Build.MANUFACTURER).append("\n");
+        sb.append("Device Model                         : ").append(Build.MODEL).append("\n");
+        sb.append("Android Version                      : ").append(Build.VERSION.RELEASE).append("\n");
+        sb.append("Android SDK                          : ").append(Build.VERSION.SDK_INT).append("\n");
+        sb.append("App VersionName                      : ").append(versionName).append("\n");
+        sb.append("App VersionCode                      : ").append(versionCode).append("\n");
+        sb.append("************* Crash Head ****************\n");
+        sb.append("\n").append(fullStackTrace);
+
+        final String errorLog = sb.toString();
+
+        // 写入日志文件
+        try {
+            writeFile(crashFile, errorLog);
+        } catch (IOException e) {
+            LogUtils.e(TAG, "write crash log file fail");
+        }
+
+        // 跳转崩溃页面
+        gotoCrashActivity(errorLog, app);
+    }
+
+    /**
+     * 写入文本到文件
+     */
+    private static void writeFile(final File file, final String content) throws IOException {
+        final File parentFile = file.getParentFile();
+        if (parentFile != null && !parentFile.exists()) {
+            parentFile.mkdirs();
+        }
+        file.createNewFile();
+        FileOutputStream fos = new FileOutputStream(file);
+        fos.write(content.getBytes());
+        fos.close();
+    }
+
+    /**
+     * 根据保险丝状态跳转对应崩溃页面
+     */
+    private static void gotoCrashActivity(final String errorLog, final Application app) {
+        final Intent intent = new Intent();
+        if (AppCrashSafetyWire.getInstance().isAppCrashSafetyWireOK()) {
+            intent.setClass(app, GlobalCrashActivity.class);
+        } else {
+            intent.setClass(app, CrashActivity.class);
+        }
+        intent.putExtra(EXTRA_CRASH_LOG, errorLog);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
+						| Intent.FLAG_ACTIVITY_CLEAR_TOP
+						| Intent.FLAG_ACTIVITY_CLEAR_TASK);
+
+        try {
+            if (GlobalApplication.isDebugging()) {
+                app.startActivity(intent);
+            } else {
+                CrashHandleNotifyUtils.handleUncaughtException(app, intent, GlobalCrashActivity.class);
+            }
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        } catch (ActivityNotFoundException e) {
+            LogUtils.e(TAG, "CrashActivity not found");
+            if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+                DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(Thread.currentThread(), e);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "start CrashActivity error");
+            if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+                DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(Thread.currentThread(), e);
+            }
+        }
+    }
+
+    // ====================== 内部Activity页面 ======================
+    /**
+     * 基础极简崩溃页面
+     * 保险丝熔断时启动，避免复杂布局二次崩溃
+     */
+    public static final class CrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
+        private static final int MENUITEM_COPY = 0;
+        private static final int MENUITEM_RESTART = 1;
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(final Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+            AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(getApplicationContext());
+            mLog = getIntent().getStringExtra(EXTRA_CRASH_LOG);
+            setTheme(android.R.style.Theme_DeviceDefault_Light_DarkActionBar);
+            initLayout();
+        }
+
+        /**
+         * 动态初始化布局
+         */
+        private void initLayout() {
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+
+            HorizontalScrollView hw = new HorizontalScrollView(this);
+            hw.setBackgroundColor(0xFFF5F5F5);
+
+            TextView message = new TextView(this);
+            final int padding = dp2px(16);
+            message.setPadding(padding, padding, padding, padding);
+            message.setText(mLog);
+            message.setTextColor(0xFF000000);
+            message.setTextIsSelectable(true);
+
+            hw.addView(message);
+            contentView.addView(hw, ViewGroup.LayoutParams.MATCH_PARENT,
+								ViewGroup.LayoutParams.MATCH_PARENT);
+            setContentView(contentView);
+
+            getActionBar().setTitle(TITTLE);
+            getActionBar().setSubtitle(GlobalApplication.class.getSimpleName() + " Error");
+        }
+
+        @Override
+        public void onBackPressed() {
+            restartApp();
+        }
+
+        /**
+         * 重启应用
+         */
+        private void restartApp() {
+            final Intent intent = getPackageManager()
+				.getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
+								| Intent.FLAG_ACTIVITY_CLEAR_TOP
+								| Intent.FLAG_ACTIVITY_CLEAR_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        /**
+         * dp转px
+         */
+        private int dp2px(final float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(final 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;
+        }
+
+        @Override
+        public boolean onMenuItemClick(final 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();
+                    restartApp();
+                    break;
+                default:
+                    break;
+            }
+            return false;
+        }
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalApplication.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalApplication.java
new file mode 100644
index 0000000..378ac59
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalApplication.java
@@ -0,0 +1,224 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Application;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.PackageManager.NameNotFoundException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 19:56
+ * @Describe 全局 Application 类，用于初始化应用核心组件、管理全局状态（如调试模式）
+ * 需在 AndroidManifest.xml 中配置 android:name=".GlobalApplication" 使其生效
+ */
+public class GlobalApplication extends Application {
+
+    /** 日志标签 */
+    public static final String TAG = "GlobalApplication";
+
+    /** 全局 Application 单例实例（volatile 保证多线程可见性，避免指令重排） */
+    private static volatile GlobalApplication sInstance;
+
+    /**
+     * 应用调试模式标记（volatile 保证多线程可见性）
+     * true：调试模式（开启日志、调试功能）；false：正式模式（关闭调试相关功能）
+     */
+    private static volatile boolean isDebugging = false;
+
+    // 新增：WinBoLL 服务器主机地址（volatile 保证多线程可见性）
+    private static volatile String winbollHost = null;
+    // 新增：SP 存储相关常量（私有存储，仅当前应用可访问）
+    private static final String SP_NAME = "WinBoLL_SP_CONFIG";
+    private static final String SP_KEY_WINBOLL_HOST = "winboll_host";
+
+    /**
+     * 获取全局 Application 单例实例（外部可通过此方法获取上下文）
+     * @return GlobalApplication 单例（未初始化时返回 null，需确保配置 AndroidManifest）
+     */
+    public static GlobalApplication getInstance() {
+        return sInstance;
+    }
+
+    /**
+     * 设置应用调试模式
+     * @param debugging 调试模式状态（true/false）
+     */
+    public static void setIsDebugging(boolean debugging) {
+        isDebugging = debugging;
+    }
+
+    /**
+     * 保存调试模式状态到本地文件（持久化存储，重启应用后生效）
+     * @param application 全局 Application 实例（通过 getInstance() 获取更规范）
+     */
+    public static void saveDebugStatus(GlobalApplication application) {
+        if (application == null) {
+            LogUtils.e(TAG, "saveDebugStatus: Application 实例为空，保存失败");
+            return;
+        }
+        // 将调试状态封装为 APPModel 并保存到文件
+        APPModel.saveBeanToFile(
+            getAppModelFilePath(application),
+            new APPModel(isDebugging)
+        );
+    }
+
+    /**
+     * 获取 APPModel 配置文件的存储路径
+     * 路径：应用私有数据目录 / APPModel.json（仅当前应用可访问，安全）
+     * @param application 全局 Application 实例
+     * @return 配置文件绝对路径
+     */
+    private static String getAppModelFilePath(GlobalApplication application) {
+        return application.getDataDir().getPath() + "/APPModel.json";
+    }
+
+    /**
+     * 获取当前应用调试模式状态
+     * @return true：调试模式；false：正式模式
+     */
+    public static boolean isDebugging() {
+        return isDebugging;
+    }
+
+	// 新增：设置 WinBoLL 服务器主机地址（同时保存到 SP 持久化）
+	public static void setWinbollHost(String host) {
+		if (sInstance == null) {
+			LogUtils.e(TAG, "setWinbollHost: 应用未初始化，设置失败");
+			return;
+		}
+		// 检查并补全末尾 /  核心改动
+		if (host != null && !host.isEmpty() && !host.endsWith("/")) {
+			host += "/";
+		}
+		// 更新内存中的字段
+		winbollHost = host;
+		// 保存到 SP 持久化（私有模式，安全）
+		SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+		sp.edit().putString(SP_KEY_WINBOLL_HOST, host).apply();
+		LogUtils.d(TAG, "setWinbollHost: 服务器地址已设置并持久化，host=" + host);
+	}
+
+
+    // 新增：获取 WinBoLL 服务器主机地址（优先内存，内存为空则从 SP 读取）
+    public static String getWinbollHost() {
+        if (winbollHost != null) {
+            // 内存中存在，直接返回（提高效率）
+            return winbollHost;
+        }
+        if (sInstance == null) {
+            LogUtils.e(TAG, "getWinbollHost: 应用未初始化，获取失败");
+            return null;
+        }
+        // 内存中不存在，从 SP 读取并更新到内存
+        SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        winbollHost = sp.getString(SP_KEY_WINBOLL_HOST, "https://console.winboll.cc/");
+        LogUtils.d(TAG, "getWinbollHost: 从 SP 读取服务器地址，host=" + winbollHost);
+        return winbollHost;
+    }
+
+    /**
+     * 应用启动时初始化（仅执行一次）
+     * 初始化核心框架、恢复调试状态、配置全局异常处理等
+     */
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        // 初始化单例实例（确保在所有初始化操作前完成）
+        sInstance = this;
+
+        // 初始化基础组件（日志、崩溃处理、Toast）
+        initCoreComponents();
+        // 恢复/初始化调试模式状态（从本地文件读取，无文件则默认关闭调试）
+        restoreDebugStatus();
+        // 新增：初始化服务器地址（从 SP 读取到内存，提高后续访问效率）
+        initWinbollHost();
+
+        LogUtils.d(TAG, "GlobalApplication 初始化完成，单例实例已创建");
+    }
+
+    /**
+     * 初始化应用核心组件（日志、崩溃处理、Toast 框架）
+     */
+    private void initCoreComponents() {
+        // 初始化日志工具（传入 Application 上下文）
+        LogUtils.init(this);
+        // 初始化全局异常处理器（捕获应用崩溃信息，用于调试或上报）
+        CrashHandler.init(this);
+        // 初始化 Toast 工具（统一 Toast 样式、避免内存泄漏等）
+        ToastUtils.init(this);
+    }
+
+    /**
+     * 恢复调试模式状态（从本地配置文件读取）
+     * 1. 读取本地 APPModel.json 文件
+     * 2. 读取成功：使用保存的调试状态；读取失败（文件不存在）：默认关闭调试并创建配置文件
+     */
+    private void restoreDebugStatus() {
+        // 从文件加载 APPModel 实例（存储调试状态的模型类）
+        APPModel appModel = APPModel.loadBeanFromFile(
+            getAppModelFilePath(this),
+            APPModel.class
+        );
+
+        if (appModel == null) {
+            // 配置文件不存在，默认关闭调试模式并创建文件
+            setIsDebugging(false);
+            saveDebugStatus(this);
+            LogUtils.d(TAG, "调试配置文件不存在，默认关闭调试模式并创建配置文件");
+        } else {
+            // 配置文件存在，使用保存的调试状态
+            setIsDebugging(appModel.isDebugging());
+            LogUtils.d(TAG, "从配置文件恢复调试模式：" + isDebugging);
+        }
+    }
+
+    // 新增：初始化服务器地址（应用启动时从 SP 读取到内存）
+    private void initWinbollHost() {
+        getWinbollHost(); // 触发从 SP 读取并更新内存
+    }
+
+    /**
+     * 获取应用名称（从 AndroidManifest.xml 的 android:label 读取）
+     * @param context 上下文（建议传入 Application 上下文，避免内存泄漏）
+     * @return 应用名称（读取失败返回 null）
+     */
+    public static String getAppName(Context context) {
+        if (context == null) {
+            LogUtils.w(TAG, "getAppName: 上下文为空，返回 null");
+            return null;
+        }
+        PackageManager packageManager = context.getPackageManager();
+        try {
+            // 获取应用信息（包含应用名称、图标等）
+            ApplicationInfo applicationInfo = packageManager.getApplicationInfo(
+                context.getPackageName(),  // 当前应用包名
+                0  // 额外标志（0 表示默认获取基本信息）
+            );
+            // 从应用信息中获取应用名称（支持多语言）
+            String appName = (String) packageManager.getApplicationLabel(applicationInfo);
+            LogUtils.d(TAG, "获取应用名称成功：" + appName);
+            return appName;
+        } catch (NameNotFoundException e) {
+            // 包名不存在（理论上不会发生，捕获异常避免崩溃）
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            //LogUtils.e(TAG, "获取应用名称失败：包名不存在", e);
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    /**
+     * 应用终止时调用（仅用于释放全局资源）
+     */
+    @Override
+    public void onTerminate() {
+        super.onTerminate();
+        // 释放单例引用（可选，避免内存泄漏风险）
+        sInstance = null;
+        LogUtils.d(TAG, "GlobalApplication 终止，单例实例已释放");
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalCrashActivity.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalCrashActivity.java
new file mode 100644
index 0000000..1b185fd
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalCrashActivity.java
@@ -0,0 +1,151 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.utils.CrashHandleNotifyUtils;
+
+/**
+ * 应用异常报告观察活动窗口类
+ * 核心功能：应用发生未捕获崩溃时，由 CrashHandler 启动此页面，展示崩溃日志详情，
+ * 并提供「复制日志」「重启应用」操作入口，便于开发者定位问题和用户恢复应用
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025/11/11 19:58:00
+ * @EditTime 2026/05/11 15:40:12
+ */
+public final class GlobalCrashActivity extends Activity implements MenuItem.OnMenuItemClickListener {
+
+    // ====================== 常量定义 ======================
+    public static final String TAG = "GlobalCrashActivity";
+    /** 菜单标识：复制崩溃日志 */
+    private static final int MENU_ITEM_COPY = 0;
+    /** 菜单标识：重启应用 */
+    private static final int MENU_ITEM_RESTART = 1;
+
+    // ====================== 成员变量 ======================
+    /** 崩溃报告展示自定义视图 */
+    private GlobalCrashReportView mCrashReportView;
+    /** 崩溃日志文本内容 */
+    private String mCrashLog;
+
+    // ====================== 生命周期方法 ======================
+    @Override
+    protected void onCreate(final Bundle savedInstanceState) {
+        LogUtils.d(TAG, "onCreate 方法进入");
+        try {
+            super.onCreate(savedInstanceState);
+            final Context appContext = getApplicationContext();
+            // 初始化崩溃安全防护机制
+            AppCrashSafetyWire.getInstance().postResumeCrashSafetyWireHandler(appContext);
+
+            // 获取传递的崩溃日志
+            mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
+            LogUtils.d(TAG, "获取到崩溃日志，长度：" + (mCrashLog != null ? mCrashLog.length() : 0));
+
+            setContentView(R.layout.activity_globalcrash);
+            mCrashReportView = findViewById(R.id.activityglobalcrashGlobalCrashReportView1);
+            mCrashReportView.setReport(mCrashLog);
+
+            setActionBar(mCrashReportView.getToolbar());
+            if (getActionBar() != null) {
+                getActionBar().setTitle(CrashHandler.TITTLE);
+                getActionBar().setSubtitle(GlobalApplication.getAppName(appContext));
+            }
+        } catch (final Exception e) {
+            LogUtils.e(TAG, "GlobalCrashActivity onCreate 发生异常", e);
+            AppCrashSafetyWire.getInstance().burnSafetyWire();
+
+            mCrashLog = getIntent().getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
+            final Intent intent = new Intent();
+            intent.putExtra(CrashHandler.EXTRA_CRASH_LOG, mCrashLog);
+            CrashHandleNotifyUtils.handleUncaughtException(GlobalApplication.getInstance(), intent, CrashHandler.CrashActivity.class);
+
+            StackTraceElement[] stackElements = Thread.currentThread().getStackTrace();
+            StringBuilder sb = new StringBuilder("GlobalCrashActivity onCreate StackTrace");
+            for (StackTraceElement item : stackElements) {
+                sb.append("\n").append(item.toString());
+            }
+            LogUtils.d(TAG, sb.toString());
+            finish();
+        }
+    }
+
+    @Override
+    public void onBackPressed() {
+        LogUtils.d(TAG, "onBackPressed 触发重启应用");
+        restartApp();
+    }
+
+    // ====================== 菜单相关回调 ======================
+    @Override
+    public boolean onCreateOptionsMenu(final Menu menu) {
+        LogUtils.d(TAG, "onCreateOptionsView 初始化菜单");
+        menu.add(0, MENU_ITEM_COPY, 0, "Copy")
+			.setOnMenuItemClickListener(this)
+			.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+
+        menu.add(0, MENU_ITEM_RESTART, 0, "Restart")
+			.setOnMenuItemClickListener(this)
+			.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+
+        mCrashReportView.updateMenuStyle();
+        return true;
+    }
+
+    @Override
+    public boolean onMenuItemClick(final MenuItem item) {
+        LogUtils.d(TAG, "菜单项被点击，ID：" + item.getItemId());
+        switch (item.getItemId()) {
+            case MENU_ITEM_COPY:
+                copyCrashLogToClipboard();
+                break;
+            case MENU_ITEM_RESTART:
+                AppCrashSafetyWire.getInstance().resumeToMaximumImmediately();
+                restartApp();
+                break;
+            default:
+                break;
+        }
+        return false;
+    }
+
+    // ====================== 内部私有工具方法 ======================
+    /**
+     * 重启当前应用
+     */
+    private void restartApp() {
+        LogUtils.d(TAG, "开始执行应用重启逻辑");
+        final PackageManager packageManager = getPackageManager();
+        final Intent launchIntent = packageManager.getLaunchIntentForPackage(getPackageName());
+
+        if (launchIntent != null) {
+            launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
+								  | Intent.FLAG_ACTIVITY_CLEAR_TOP
+								  | Intent.FLAG_ACTIVITY_CLEAR_TASK);
+            startActivity(launchIntent);
+        }
+        finish();
+        android.os.Process.killProcess(android.os.Process.myPid());
+        System.exit(0);
+    }
+
+    /**
+     * 将崩溃日志复制到系统剪贴板
+     */
+    private void copyCrashLogToClipboard() {
+        LogUtils.d(TAG, "执行复制崩溃日志到剪贴板");
+        final ClipboardManager clipboardManager = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+        final ClipData clipData = ClipData.newPlainText(getPackageName(), mCrashLog);
+        clipboardManager.setPrimaryClip(clipData);
+        Toast.makeText(getApplication(), "The text is copied.", Toast.LENGTH_SHORT).show();
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalCrashReportView.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalCrashReportView.java
new file mode 100644
index 0000000..7ecedcc
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/GlobalCrashReportView.java
@@ -0,0 +1,317 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.Color;
+import android.text.SpannableString;
+import android.text.style.ForegroundColorSpan;
+import android.util.AttributeSet;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+import android.widget.Toolbar;
+import cc.winboll.studio.libappbase.R;
+import android.content.res.Resources;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:21
+ * @Describe 全局崩溃报告视图控件
+ * 用于展示应用崩溃信息，包含顶部工具栏和崩溃日志文本区域，支持自定义配色
+ */
+public class GlobalCrashReportView extends LinearLayout {
+
+	// 日志标签
+	public static final String TAG = "GlobalCrashReportView";
+
+	// 上下文对象
+	private Context mContext;
+	// 顶部工具栏（标题栏）
+	private Toolbar mToolbar;
+	// 标题文字颜色
+	private int mTitleColor;
+	// 标题栏背景颜色
+	private int mTitleBackgroundColor;
+	// 日志文本颜色
+	private int mTextColor;
+	// 日志区域背景颜色
+	private int mTextBackgroundColor;
+	// 崩溃日志显示文本控件
+	private TextView mTvReport;
+
+	/**
+	 * 构造方法：仅上下文
+	 * @param context 上下文
+	 */
+	public GlobalCrashReportView(Context context) {
+		super(context);
+		mContext = context;
+		// 初始化默认配置（无自定义属性）
+		initDefaultConfig();
+	}
+
+	/**
+	 * 构造方法：上下文 + 自定义属性
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合
+	 */
+	public GlobalCrashReportView(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		mContext = context;
+		// 初始化视图（解析自定义属性）
+		initView(attrs);
+	}
+
+	/**
+	 * 构造方法：上下文 + 自定义属性 + 样式属性
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合
+	 * @param defStyleAttr 样式属性
+	 */
+	public GlobalCrashReportView(Context context, AttributeSet attrs, int defStyleAttr) {
+		super(context, attrs, defStyleAttr);
+		mContext = context;
+		// 初始化视图（解析自定义属性）
+		initView(attrs);
+	}
+
+	/**
+	 * 构造方法：上下文 + 自定义属性 + 样式属性 + 样式资源
+	 * @param context 上下文
+	 * @param attrs 自定义属性集合
+	 * @param defStyleAttr 样式属性
+	 * @param defStyleRes 样式资源
+	 */
+	public GlobalCrashReportView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+		super(context, attrs, defStyleAttr, defStyleRes);
+		mContext = context;
+		// 初始化视图（解析自定义属性）
+		initView(attrs);
+	}
+
+	/**
+	 * 设置标题文字颜色
+	 * @param titleColor 颜色值（如 Color.WHITE 或 #FFFFFF）
+	 */
+	public void setTitleColor(int titleColor) {
+		this.mTitleColor = titleColor;
+		// 实时更新工具栏标题颜色
+		if (mToolbar != null) {
+			mToolbar.setTitleTextColor(titleColor);
+			mToolbar.setSubtitleTextColor(titleColor);
+		}
+	}
+
+	/**
+	 * 获取标题文字颜色
+	 * @return 标题文字颜色值
+	 */
+	public int getTitleColor() {
+		return mTitleColor;
+	}
+
+	/**
+	 * 设置标题栏背景颜色
+	 * @param titleBackgroundColor 颜色值（如 Color.BLACK 或 #000000）
+	 */
+	public void setTitleBackgroundColor(int titleBackgroundColor) {
+		this.mTitleBackgroundColor = titleBackgroundColor;
+		// 实时更新工具栏背景颜色
+		if (mToolbar != null) {
+			mToolbar.setBackgroundColor(titleBackgroundColor);
+		}
+	}
+
+	/**
+	 * 获取标题栏背景颜色
+	 * @return 标题栏背景颜色值
+	 */
+	public int getTitleBackgroundColor() {
+		return mTitleBackgroundColor;
+	}
+
+	/**
+	 * 设置日志文本颜色
+	 * @param textColor 颜色值（如 Color.BLACK 或 #000000）
+	 */
+	public void setTextColor(int textColor) {
+		this.mTextColor = textColor;
+		// 实时更新日志文本颜色
+		if (mTvReport != null) {
+			mTvReport.setTextColor(textColor);
+		}
+	}
+
+	/**
+	 * 获取日志文本颜色
+	 * @return 日志文本颜色值
+	 */
+	public int getTextColor() {
+		return mTextColor;
+	}
+
+	/**
+	 * 设置日志区域背景颜色
+	 * @param textBackgroundColor 颜色值（如 Color.WHITE 或 #FFFFFF）
+	 */
+	public void setTextBackgroundColor(int textBackgroundColor) {
+		this.mTextBackgroundColor = textBackgroundColor;
+		// 实时更新日志区域和主布局背景颜色
+		if (mTvReport != null) {
+			mTvReport.setBackgroundColor(textBackgroundColor);
+		}
+		setBackgroundColor(textBackgroundColor);
+	}
+
+	/**
+	 * 获取日志区域背景颜色
+	 * @return 日志区域背景颜色值
+	 */
+	public int getTextBackgroundColor() {
+		return mTextBackgroundColor;
+	}
+
+	/**
+	 * 初始化默认配置（无自定义属性时使用）
+	 */
+	private void initDefaultConfig() {
+		// 设置默认配色（使用 debugTextColor 属性）
+		Resources.Theme theme = mContext.getTheme();
+		mTitleColor = theme.getResources().getColor(android.R.color.holo_green_dark);
+		mTitleBackgroundColor = Color.GRAY;
+		mTextColor = obtainDebugTextColor(theme);
+		mTextBackgroundColor = Color.WHITE;
+		// 加载布局
+		inflateView();
+		// 初始化控件样式
+		initWidgetStyle();
+	}
+
+	private int obtainDebugTextColor(Resources.Theme theme) {
+		int[] attrs = new int[] { cc.winboll.studio.libappbase.R.attr.themeDebug };
+		TypedArray themeTypedArray = theme.obtainStyledAttributes(attrs);
+		int themeResId = themeTypedArray.getResourceId(0, 0);
+		themeTypedArray.recycle();
+		if (themeResId != 0) {
+			int[] debugAttrs = new int[] { cc.winboll.studio.libappbase.R.attr.debugTextColor };
+			TypedArray debugTypedArray = theme.obtainStyledAttributes(themeResId, debugAttrs);
+			int color = debugTypedArray.getColor(0, Color.GRAY);
+			debugTypedArray.recycle();
+			return color;
+		}
+		return Color.GRAY;
+	}
+
+	/**
+	 * 初始化视图（解析自定义属性 + 加载布局 + 设置样式）
+	 * @param attrs 自定义属性集合
+	 */
+	private void initView(AttributeSet attrs) {
+		// 解析自定义属性（关联 attrs.xml 中的 GlobalCrashActivity 样式）
+		TypedArray typedArray = mContext.obtainStyledAttributes(
+			attrs,
+			R.styleable.GlobalCrashActivity,
+			R.attr.themeDebug,
+			0
+		);
+
+		// 读取自定义属性值（无设置时使用默认值）
+		mTitleColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTittle,
+			Color.BLACK
+		);
+		mTitleBackgroundColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTittleBackgound, // 注：原拼写错误（Backgound→Background），保持与 attrs.xml 一致
+			Color.BLACK
+		);
+		mTextColor = obtainDebugTextColor(mContext.getTheme());
+		mTextBackgroundColor = typedArray.getColor(
+			R.styleable.GlobalCrashActivity_colorTextBackgound, // 注：原拼写错误，保持与 attrs.xml 一致
+			Color.WHITE
+		);
+
+		// 回收 TypedArray，避免内存泄漏
+		typedArray.recycle();
+
+		// 加载布局文件
+		inflateView();
+		// 初始化控件样式
+		initWidgetStyle();
+	}
+
+	/**
+	 * 加载布局文件
+	 */
+	private void inflateView() {
+		// 加载自定义布局（R.layout.view_globalcrashreport）
+		inflate(mContext, R.layout.view_globalcrashreport, this);
+		// 绑定控件
+		mToolbar = findViewById(R.id.viewglobalcrashreportToolbar1);
+		mTvReport = findViewById(R.id.viewglobalcrashreportTextView1);
+	}
+
+	/**
+	 * 初始化控件样式（设置配色和基础属性）
+	 */
+	private void initWidgetStyle() {
+		// 配置工具栏样式
+		if (mToolbar != null) {
+			mToolbar.setTitleTextColor(mTitleColor);
+			mToolbar.setSubtitleTextColor(mTitleColor);
+		}
+
+		// 配置日志文本控件样式
+		if (mTvReport != null) {
+			mTvReport.setTextColor(mTextColor);
+			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);
+		}
+	}
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/LogActivity.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogActivity.java
new file mode 100644
index 0000000..8c0e5af
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogActivity.java
@@ -0,0 +1,87 @@
+package cc.winboll.studio.libappbase;
+
+import android.app.Activity;
+import android.app.ActivityOptions;
+import android.content.Context;
+import android.content.Intent;
+import android.graphics.Rect;
+import android.os.Build;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.libappbase.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:29
+ * @Describe 应用日志展示 Activity
+ * 用于单独启动窗口展示应用运行日志，依赖 LogView 控件实现日志加载与显示
+ */
+public class LogActivity extends Activity {
+
+    /** 日志标签，用于当前 Activity 的日志输出标识 */
+    public static final String TAG = "LogActivity";
+
+    /** 日志展示控件（用于加载和显示应用日志） */
+    private LogView mLogView;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        // 设置布局文件（包含 LogView 控件）
+        setContentView(R.layout.activity_log);
+
+        // 绑定布局中的 LogView 控件
+        mLogView = findViewById(R.id.logview);
+        // 启动 LogView 日志加载（如实时刷新日志内容）
+        mLogView.start();
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        // 恢复 Activity 时重新启动 LogView（确保日志持续更新）
+        mLogView.start();
+    }
+
+    /**
+     * 启动日志 Activity 的静态方法（外部调用入口）
+     * 配置 Intent 标志，以多任务/分屏模式启动，避免与主应用任务栈冲突
+     * @param context 上下文（Activity/Fragment），用于启动 Activity
+     */
+    public static void startLogActivity(Context context) {
+        startLogActivity(context, true);
+    }
+
+    /**
+     * 启动日志 Activity 的静态方法重载（外部调用入口）
+     * @param context 上下文（Activity/Fragment），用于启动 Activity
+     * @param newTask 是否在新窗口中启动
+     */
+    public static void startLogActivity(Context context, boolean newTask) {
+        Intent intent = new Intent(context, LogActivity.class);
+        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+        if (newTask) {
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+            context.startActivity(intent);
+        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+            intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
+            intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
+
+            Rect bounds = new Rect();
+            if (context instanceof Activity) {
+                Activity activity = (Activity) context;
+                activity.getWindow().getDecorView().getDisplay().getRectSize(bounds);
+                bounds.set(0, bounds.height() / 2, bounds.width(), bounds.height());
+            }
+            ActivityOptions options = ActivityOptions.makeBasic();
+            options.setLaunchBounds(bounds);
+            context.startActivity(intent, options.toBundle());
+        } else {
+            context.startActivity(intent);
+        }
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtils.java
new file mode 100644
index 0000000..8ac2fe9
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtils.java
@@ -0,0 +1,683 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.util.Log;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import dalvik.system.DexFile;
+
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.OutputStreamWriter;
+import java.lang.reflect.Field;
+import java.lang.reflect.Modifier;
+import java.text.SimpleDateFormat;
+import java.util.ArrayList;
+import java.util.Enumeration;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-05-09 15:46:28
+ * @EditTime 2026-05-11 15:36:12
+ * @Describe 应用日志工具类
+ * 补全多级别日志重载、自动日志文件裁剪、应用内TAG自动扫描管理；
+ * 支持日志本地持久化、异常堆栈格式化、TAG开关配置、线程与集合打印工具；
+ * 完全兼容Java7语法，严格遵循变量final编码规范；
+ * 重要说明：本类内部调试打印必须使用 android.util.Log，禁止使用LogUtils自身方法，
+ * 避免递归嵌套调用、逻辑漩涡与无限循环调用问题。
+ */
+public class LogUtils {
+
+    // ====================== 常量与枚举 ======================
+    public static final String TAG = "LogUtils";
+
+    /**
+     * 日志级别枚举
+     */
+    public static enum LOG_LEVEL {
+        Off,
+        Error,
+        Warn,
+        Info,
+        Debug,
+        Verbose
+		}
+
+    // ====================== 全局静态成员 ======================
+    private static volatile boolean _IsInited = false;
+    private static Context _mContext;
+    private static final SimpleDateFormat mSimpleDateFormat = new SimpleDateFormat("[yyyyMMdd_HHmmss_SSS]", Locale.getDefault());
+    private static File _mfLogCacheDir;
+    private static File _mfLogDataDir;
+    private static File _mfLogCatchFile;
+    private static File _mfLogUtilsBeanFile;
+    private static LogUtilsBean _mLogUtilsBean;
+    public static final Map<String, Boolean> mapTAGList = new HashMap<String, Boolean>();
+
+    // ====================== 初始化入口 ======================
+    public static void init(final Context context) {
+        init(context, LOG_LEVEL.Off);
+    }
+
+    public static void init(final Context context, final LOG_LEVEL logLevel) {
+        Log.d(TAG, "init 执行日志工具初始化");
+        _mContext = context;
+
+        if (GlobalApplication.isDebugging()) {
+            initDebugDir();
+        } else {
+            initReleaseDir();
+        }
+
+        initLogConfigBean();
+        addClassTAGList();
+        loadTAGBeanSettings();
+        checkAndTrimLogFileSize();
+
+        _IsInited = true;
+        Log.d(TAG, "init 日志工具初始化完成");
+    }
+
+    // ====================== 目录初始化 ======================
+    private static void initDebugDir() {
+        final Context appContext = _mContext.getApplicationContext();
+        _mfLogCacheDir = new File(appContext.getExternalCacheDir(), TAG);
+        if (!_mfLogCacheDir.exists()) {
+            _mfLogCacheDir.mkdirs();
+        }
+        _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
+
+        _mfLogDataDir = appContext.getExternalFilesDir(TAG);
+        if (!_mfLogDataDir.exists()) {
+            _mfLogDataDir.mkdirs();
+        }
+        _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
+    }
+
+    private static void initReleaseDir() {
+        final Context appContext = _mContext.getApplicationContext();
+        _mfLogCacheDir = new File(appContext.getCacheDir(), TAG);
+        if (!_mfLogCacheDir.exists()) {
+            _mfLogCacheDir.mkdirs();
+        }
+        _mfLogCatchFile = new File(_mfLogCacheDir, "log.txt");
+
+        _mfLogDataDir = new File(appContext.getFilesDir(), TAG);
+        if (!_mfLogDataDir.exists()) {
+            _mfLogDataDir.mkdirs();
+        }
+        _mfLogUtilsBeanFile = new File(_mfLogDataDir, TAG + ".json");
+    }
+
+    private static void initLogConfigBean() {
+        _mLogUtilsBean = LogUtilsBean.loadBeanFromFile(_mfLogUtilsBeanFile.getPath(), LogUtilsBean.class);
+        if (_mLogUtilsBean == null) {
+            _mLogUtilsBean = new LogUtilsBean();
+            _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
+            Log.d(TAG, "initLogConfigBean 自动创建默认日志配置文件");
+        }
+    }
+
+    // ====================== 日志文件裁剪 ======================
+    private static void checkAndTrimLogFileSize() {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return;
+        }
+
+        final long MAX_FILE_SIZE = 6291456L;
+        final long KEEP_FILE_SIZE = 3145728L;
+        final long fileSize = _mfLogCatchFile.length();
+
+        if (fileSize <= MAX_FILE_SIZE) {
+            return;
+        }
+
+        final long needSkip = fileSize - KEEP_FILE_SIZE;
+        final String lineBreak = System.lineSeparator();
+
+        FileInputStream fis = null;
+        BufferedReader reader = null;
+        FileOutputStream fos = null;
+        BufferedWriter writer = null;
+
+        try {
+            fis = new FileInputStream(_mfLogCatchFile);
+            reader = new BufferedReader(new InputStreamReader(fis));
+            fos = new FileOutputStream(_mfLogCatchFile);
+            writer = new BufferedWriter(new OutputStreamWriter(fos));
+
+            final StringBuilder sb = new StringBuilder();
+            String line;
+            long skippedTotal = 0;
+
+            while ((line = reader.readLine()) != null) {
+                final byte[] lineBytes = line.getBytes();
+                skippedTotal += lineBytes.length + lineBreak.getBytes().length;
+                if (skippedTotal > needSkip) {
+                    sb.append(line).append(lineBreak);
+                }
+            }
+            writer.write(sb.toString());
+            Log.d(TAG, "checkAndTrimLogFileSize 日志文件裁剪完成");
+        } catch (IOException e) {
+            Log.e(TAG, "checkAndTrimLogFileSize 日志文件裁剪失败", e);
+        } finally {
+            try {
+                if (reader != null) {
+                    reader.close();
+                }
+            } catch (IOException e) {}
+            try {
+                if (fis != null) {
+                    fis.close();
+                }
+            } catch (IOException e) {}
+            try {
+                if (writer != null) {
+                    writer.close();
+                }
+            } catch (IOException e) {}
+            try {
+                if (fos != null) {
+                    fos.close();
+                }
+            } catch (IOException e) {}
+        }
+    }
+
+    // ====================== TAG 配置管理 ======================
+    public static Map<String, Boolean> getMapTAGList() {
+        return mapTAGList;
+    }
+
+    private static void loadTAGBeanSettings() {
+        final ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
+        LogUtilsClassTAGBean.loadBeanList(_mContext, list, LogUtilsClassTAGBean.class);
+
+        for (final LogUtilsClassTAGBean beanSetting : list) {
+            final String tag = beanSetting.getTag();
+            if (mapTAGList.containsKey(tag)) {
+                mapTAGList.put(tag, beanSetting.getEnable());
+            }
+        }
+    }
+
+    private static void saveTAGBeanSettings() {
+        final ArrayList<LogUtilsClassTAGBean> list = new ArrayList<LogUtilsClassTAGBean>();
+        for (final Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+            list.add(new LogUtilsClassTAGBean(entry.getKey(), entry.getValue()));
+        }
+        LogUtilsClassTAGBean.saveBeanList(_mContext, list, LogUtilsClassTAGBean.class);
+    }
+
+    private static void addClassTAGList() {
+        try {
+            final String packageNamePrefix = "cc.winboll.studio";
+            final List<String> classNames = new ArrayList<String>();
+            final String apkPath = _mContext.getPackageCodePath();
+
+            final DexFile dexfile = new DexFile(apkPath);
+            Enumeration<String> entries = dexfile.entries();
+
+            while (entries.hasMoreElements()) {
+                final String className = entries.nextElement();
+                if (className.startsWith(packageNamePrefix)) {
+                    classNames.add(className);
+                }
+            }
+
+            for (final String className : classNames) {
+                try {
+                    final Class<?> clazz = Class.forName(className);
+                    final Field[] fields = clazz.getDeclaredFields();
+
+                    for (final Field field : fields) {
+                        if (Modifier.isStatic(field.getModifiers())
+							&& Modifier.isPublic(field.getModifiers())
+							&& field.getType() == String.class
+							&& "TAG".equals(field.getName())) {
+
+                            final String tagValue = (String) field.get(null);
+                            mapTAGList.put(tagValue, false);
+                        }
+                    }
+                } catch (NoClassDefFoundError e) {
+                    Log.w(TAG, "addClassTAGList 解析类TAG失败 NoClassDefFoundError");
+                } catch (ClassNotFoundException e) {
+                    Log.w(TAG, "addClassTAGList 解析类TAG失败 ClassNotFoundException");
+                } catch (IllegalAccessException e) {
+                    Log.w(TAG, "addClassTAGList 解析类TAG失败 IllegalAccessException");
+                }
+            }
+        } catch (IOException e) {
+            Log.e(TAG, "addClassTAGList 扫描Dex异常", e);
+        }
+    }
+
+    public static void setTAGListEnable(final String tag, final boolean isEnable) {
+        final Iterator<Map.Entry<String, Boolean>> iterator = mapTAGList.entrySet().iterator();
+        while (iterator.hasNext()) {
+            final Map.Entry<String, Boolean> entry = iterator.next();
+            if (tag.equals(entry.getKey())) {
+                entry.setValue(isEnable);
+                break;
+            }
+        }
+        saveTAGBeanSettings();
+        Log.d(TAG, "setTAGListEnable 更新TAG开关配置");
+    }
+
+    public static void setALlTAGListEnable(final boolean isEnable) {
+        for (final Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+            entry.setValue(isEnable);
+        }
+        saveTAGBeanSettings();
+        Log.d(TAG, "setALlTAGListEnable 全量设置TAG开关");
+    }
+
+    // ====================== 日志级别控制 ======================
+    public static void setLogLevel(final LOG_LEVEL logLevel) {
+        _mLogUtilsBean.setLogLevel(logLevel);
+        _mLogUtilsBean.saveBeanToFile(_mfLogUtilsBeanFile.getPath(), _mLogUtilsBean);
+    }
+
+    public static LOG_LEVEL getLogLevel() {
+        return _mLogUtilsBean.getLogLevel();
+    }
+
+    private static boolean isLoggable(final String tag, final LOG_LEVEL logLevel) {
+        if (!_IsInited) {
+            return false;
+        }
+        if (mapTAGList.get(tag) == null || !mapTAGList.get(tag)) {
+            return false;
+        }
+        return isInTheLevel(logLevel);
+    }
+
+    private static boolean isInTheLevel(final LOG_LEVEL logLevel) {
+        return _mLogUtilsBean.getLogLevel().ordinal() >= logLevel.ordinal();
+    }
+
+    // ====================== 基础对外方法 ======================
+    public static File getLogCacheDir() {
+        return _mfLogCacheDir;
+    }
+
+    public static boolean isInited() {
+        return _IsInited;
+    }
+
+    // ====================== Error 日志重载（补齐缺失方法） ======================
+    public static void e(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            saveLog(szTAG, LOG_LEVEL.Error, szMessage);
+        }
+    }
+
+    public static void e(final String szTAG, final String szMessage, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    public static void e(final String szTAG, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final String message = "【异常信息】: " + getExceptionInfo(e);
+            saveLog(szTAG, LOG_LEVEL.Error, message);
+        }
+    }
+
+    public static void e(final String szTAG, final String szMessage, final Exception e, final StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            sb.append("\n【堆栈信息】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    /**
+     * 补齐你需要的：LogUtils.e(TAG, "uncaughtException: 崩溃处理异常", e)
+     */
+    public static void e(final String szTAG, final String szMessage, final Throwable e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Error)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getThrowableInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Error, sb.toString());
+        }
+    }
+
+    // ====================== Warn 日志重载 ======================
+    public static void w(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Warn)) {
+            saveLog(szTAG, LOG_LEVEL.Warn, szMessage);
+        }
+    }
+
+    public static void w(final String szTAG, final String szMessage, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Warn)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Warn, sb.toString());
+        }
+    }
+
+    public static void w(final String szTAG, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Warn)) {
+            final String message = "【异常信息】: " + getExceptionInfo(e);
+            saveLog(szTAG, LOG_LEVEL.Warn, message);
+        }
+    }
+
+    // ====================== Info 日志重载 ======================
+    public static void i(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Info)) {
+            saveLog(szTAG, LOG_LEVEL.Info, szMessage);
+        }
+    }
+
+    public static void i(final String szTAG, final String szMessage, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Info)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LOG_LEVEL.Info, sb.toString());
+        }
+    }
+
+    // ====================== Debug 日志重载 ======================
+    public static void d(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            saveLog(szTAG, LOG_LEVEL.Debug, szMessage);
+        }
+    }
+
+    public static void d(final String szTAG, final String szMessage, final StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final StringBuilder sbMessage = new StringBuilder(szMessage);
+            sbMessage.append("\n【调用堆栈】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LOG_LEVEL.Debug, sbMessage.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final String szMessage, final Exception e) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【异常信息】: ").append(getExceptionInfo(e));
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final Exception e, final StackTraceElement[] listStackTrace) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final StringBuilder sbMessage = new StringBuilder();
+            sbMessage.append("【异常信息】: ").append(getExceptionInfo(e));
+            sbMessage.append("\n【调用堆栈】: ").append(getStackTraceInfo(listStackTrace));
+            saveLog(szTAG, LOG_LEVEL.Debug, sbMessage.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final String szMessage, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static void d(final String szTAG, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final String message = "【数据对象】: " + objStr;
+            saveLog(szTAG, LOG_LEVEL.Debug, message);
+        }
+    }
+
+    // ====================== Verbose 日志重载 ======================
+    public static void v(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Verbose)) {
+            saveLog(szTAG, LOG_LEVEL.Verbose, szMessage);
+        }
+    }
+
+    public static void v(final String szTAG, final String szMessage, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Verbose)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【数据对象】: ").append(objStr);
+            saveLog(szTAG, LOG_LEVEL.Verbose, sb.toString());
+        }
+    }
+
+    public static void v(final String szTAG, final Object obj) {
+        if (isLoggable(szTAG, LOG_LEVEL.Verbose)) {
+            final String objStr = obj == null ? "null" : obj.toString();
+            final String message = "【数据对象】: " + objStr;
+            saveLog(szTAG, LOG_LEVEL.Verbose, message);
+        }
+    }
+
+    // ====================== 扩展工具打印 ======================
+    public static void printThreadInfo(final String szTAG, final String szMessage) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug)) {
+            final Thread currentThread = Thread.currentThread();
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【线程信息】: ")
+				.append("线程名=").append(currentThread.getName())
+				.append(", 线程ID=").append(currentThread.getId())
+				.append(", 线程状态=").append(currentThread.getState().name());
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static <K, V> void printMap(final String szTAG, final String szMessage, final Map<K, V> map) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug) && map != null) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【Map 数据】size=").append(map.size());
+            for (final Map.Entry<K, V> entry : map.entrySet()) {
+                final String keyStr = entry.getKey() == null ? "null" : entry.getKey().toString();
+                final String valueStr = entry.getValue() == null ? "null" : entry.getValue().toString();
+                sb.append("\n  ").append(keyStr).append(" = ").append(valueStr);
+            }
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    public static <T> void printList(final String szTAG, final String szMessage, final List<T> list) {
+        if (isLoggable(szTAG, LOG_LEVEL.Debug) && list != null) {
+            final StringBuilder sb = new StringBuilder(szMessage);
+            sb.append("\n【List 数据】size=").append(list.size());
+            for (int i = 0; i < list.size(); i++) {
+                final T item = list.get(i);
+                final String itemStr = item == null ? "null" : item.toString();
+                sb.append("\n  索引").append(i).append(" = ").append(itemStr);
+            }
+            saveLog(szTAG, LOG_LEVEL.Debug, sb.toString());
+        }
+    }
+
+    // ====================== 私有格式化工具 ======================
+    private static String getExceptionInfo(final Exception e) {
+        if (e == null) {
+            return "异常对象为null";
+        }
+        final StringBuilder sb = new StringBuilder();
+        sb.append(e.getClass().getSimpleName()).append(" : ")
+			.append(e.getMessage() == null ? "无异常消息" : e.getMessage());
+
+        final StackTraceElement[] stackTrace = e.getStackTrace();
+        if (stackTrace != null && stackTrace.length > 0) {
+            final int limit = Math.min(stackTrace.length, 5);
+            for (int i = 0; i < limit; i++) {
+                sb.append("\n    ").append(stackTrace[i].toString());
+            }
+        }
+        return sb.toString();
+    }
+
+    private static String getThrowableInfo(final Throwable e) {
+        if (e == null) {
+            return "异常对象为null";
+        }
+        final StringBuilder sb = new StringBuilder();
+        sb.append(e.getClass().getSimpleName()).append(" : ")
+			.append(e.getMessage() == null ? "无异常消息" : e.getMessage());
+
+        final StackTraceElement[] stackTrace = e.getStackTrace();
+        if (stackTrace != null && stackTrace.length > 0) {
+            final int limit = Math.min(stackTrace.length, 5);
+            for (int i = 0; i < limit; i++) {
+                sb.append("\n    ").append(stackTrace[i].toString());
+            }
+        }
+        return sb.toString();
+    }
+
+    private static String getStackTraceInfo(final StackTraceElement[] stackTrace) {
+        if (stackTrace == null || stackTrace.length == 0) {
+            return "堆栈信息为空";
+        }
+        final StringBuilder sb = new StringBuilder();
+        int count = 0;
+        for (final StackTraceElement element : stackTrace) {
+            if (element.getClassName().contains("cc.winboll.studio.libappbase.LogUtils")) {
+                continue;
+            }
+            sb.append("\n    ").append(element.getClassName()).append(".")
+				.append(element.getMethodName()).append("(")
+				.append(element.getFileName()).append(":").append(element.getLineNumber()).append(")");
+            count++;
+            if (count >= 8) {
+                break;
+            }
+        }
+        return sb.toString();
+    }
+
+    // ====================== 日志持久化读写 ======================
+    private static void saveLog(final String szTAG, final LogUtils.LOG_LEVEL logLevel, final String szMessage) {
+        BufferedWriter out = null;
+        try {
+            if (!_mfLogCatchFile.exists()) {
+                final File parentDir = _mfLogCatchFile.getParentFile();
+                if (parentDir != null && !parentDir.exists()) {
+                    parentDir.mkdirs();
+                }
+                _mfLogCatchFile.createNewFile();
+            }
+            out = new BufferedWriter(new OutputStreamWriter(
+										 new FileOutputStream(_mfLogCatchFile, true), "UTF-8"));
+            final String logLine = "[" + logLevel + "]  "
+				+ mSimpleDateFormat.format(System.currentTimeMillis())
+				+ "  [" + szTAG + "]\n"
+				+ szMessage + "\n\n";
+            out.write(logLine);
+            out.flush();
+        } catch (IOException e) {
+            Log.e(TAG, "saveLog 日志写入失败", e);
+        } finally {
+            if (out != null) {
+                try {
+                    out.close();
+                } catch (IOException e) {
+                    Log.e(TAG, "saveLog 流关闭失败", e);
+                }
+            }
+        }
+    }
+
+    public static String loadLog() {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return "日志文件不存在";
+        }
+        final StringBuffer sb = new StringBuffer();
+        BufferedReader in = null;
+        try {
+            in = new BufferedReader(new InputStreamReader(
+										new FileInputStream(_mfLogCatchFile), "UTF-8"));
+            String line;
+            while ((line = in.readLine()) != null) {
+                sb.append(line).append("\n");
+            }
+        } catch (IOException e) {
+            sb.append("日志加载失败");
+            Log.e(TAG, "loadLog 读取日志异常", e);
+        } finally {
+            if (in != null) {
+                try {
+                    in.close();
+                } catch (IOException e) {
+                    Log.e(TAG, "loadLog 读取流关闭异常", e);
+                }
+            }
+        }
+        return sb.toString();
+    }
+
+    public static void cleanLog() {
+        if (_mfLogCatchFile == null) {
+            Log.d(TAG, "cleanLog 日志文件未初始化");
+            return;
+        }
+        BufferedWriter out = null;
+        try {
+            out = new BufferedWriter(new OutputStreamWriter(
+										 new FileOutputStream(_mfLogCatchFile, false), "UTF-8"));
+            out.write("");
+            out.flush();
+            Log.d(TAG, "cleanLog 日志已清空");
+        } catch (IOException e) {
+            Log.e(TAG, "cleanLog 清空日志失败", e);
+        } finally {
+            if (out != null) {
+                try {
+                    out.close();
+                } catch (IOException e) {
+                    Log.e(TAG, "cleanLog 流关闭异常", e);
+                }
+            }
+        }
+    }
+
+    public static boolean checkLogFileSize(final int maxSizeMB) {
+        if (_mfLogCatchFile == null || !_mfLogCatchFile.exists()) {
+            return false;
+        }
+        final long maxSizeByte = 1048576L * maxSizeMB;
+        final long fileSize = _mfLogCatchFile.length();
+        return fileSize > maxSizeByte;
+    }
+
+    public static void showShortToast(final Context context, final String message) {
+        if (context == null || message == null) {
+            return;
+        }
+        if (Thread.currentThread().getId() == android.os.Process.myTid()) {
+            Toast.makeText(context, message, Toast.LENGTH_SHORT).show();
+        } else {
+            final Context uiContext = context;
+            ((android.app.Activity) uiContext).runOnUiThread(new Runnable() {
+					@Override
+					public void run() {
+						Toast.makeText(uiContext, message, Toast.LENGTH_SHORT).show();
+					}
+				});
+        }
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsBean.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsBean.java
new file mode 100644
index 0000000..b8556b9
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsBean.java
@@ -0,0 +1,131 @@
+package cc.winboll.studio.libappbase;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/08/23 15:39:07
+ * @Describe LogUtils 配置数据模型（继承 BaseBean，实现 JSON 序列化/反序列化）
+ * 封装 LogUtils 的核心配置参数（当前仅日志级别），用于配置的持久化存储与读取
+ */
+public class LogUtilsBean extends BaseBean {
+
+    /** 当前类的日志 TAG（用于调试输出） */
+    public static final String TAG = "LogUtilsBean";
+
+    /**
+     * 全局日志级别（默认值：Off，即不输出任何日志）
+     * 关联 LogUtils.LOG_LEVEL 枚举，存储日志输出的级别阈值
+     */
+    private LogUtils.LOG_LEVEL logLevel;
+
+    /**
+     * 无参构造方法（默认初始化日志级别为 Off）
+     * 用于 JSON 反序列化时的实例创建
+     */
+    public LogUtilsBean() {
+        this.logLevel = LogUtils.LOG_LEVEL.Off;
+    }
+
+    /**
+     * 有参构造方法（指定初始日志级别）
+     * @param logLevel 初始日志级别（如 LogUtils.LOG_LEVEL.Debug）
+     */
+    public LogUtilsBean(LogUtils.LOG_LEVEL logLevel) {
+        this.logLevel = logLevel;
+    }
+
+    /**
+     * 设置日志级别（更新配置时使用）
+     * @param logLevel 目标日志级别
+     */
+    public void setLogLevel(LogUtils.LOG_LEVEL logLevel) {
+        this.logLevel = logLevel;
+    }
+
+    /**
+     * 获取当前日志级别（读取配置时使用）
+     * @return 当前配置的日志级别
+     */
+    public LogUtils.LOG_LEVEL getLogLevel() {
+        return logLevel;
+    }
+
+    /**
+     * 重写父类方法：获取当前类的全限定名（用于 BaseBean 反射识别）
+     * @return 类全限定名（如 "cc.winboll.studio.libappbase.LogUtilsBean"）
+     */
+    @Override
+    public String getName() {
+        return LogUtilsBean.class.getName();
+    }
+
+    /**
+     * 重写父类方法：将当前配置对象序列化为 JSON（持久化存储时调用）
+     * 序列化字段：logLevel（存储枚举的 ordinal 值，确保反序列化一致性）
+     * @param jsonWriter JSON 写入器（用于输出 JSON 数据）
+     * @throws IOException JSON 写入异常（如流关闭、格式错误）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        // 调用父类序列化逻辑（若 BaseBean 有公共字段，需优先处理）
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化日志级别：存储枚举的索引值（如 Off=0、Error=1...），比存储名称更高效
+        jsonWriter.name("logLevel").value(this.getLogLevel().ordinal());
+    }
+
+    /**
+     * 重写父类方法：从 JSON 字段初始化当前对象（读取配置时调用）
+     * 解析字段：logLevel（通过索引值恢复 LogUtils.LOG_LEVEL 枚举）
+     * @param jsonReader JSON 读取器（用于读取 JSON 数据）
+     * @param name JSON 字段名（当前解析的字段）
+     * @return true：字段解析成功；false：字段不匹配（需父类处理或跳过）
+     * @throws IOException JSON 读取异常（如字段类型不匹配、流中断）
+     */
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 先让父类处理公共字段，处理成功则直接返回
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            return true;
+        }
+        // 解析当前类专属字段
+        if ("logLevel".equals(name)) {
+            // 通过枚举索引值恢复枚举实例（确保与序列化时的 ordinal 对应）
+            int levelOrdinal = jsonReader.nextInt();
+            this.setLogLevel(LogUtils.LOG_LEVEL.values()[levelOrdinal]);
+        } else {
+            // 字段不匹配，返回 false 表示需要跳过该字段
+            return false;
+        }
+        // 字段解析成功
+        return true;
+    }
+
+    /**
+     * 重写父类方法：从 JSON 读取器完整解析配置对象（入口方法）
+     * 负责 JSON 对象的开始/结束解析，遍历所有字段并调用 initObjectsFromJsonReader 处理
+     * @param jsonReader JSON 读取器（传入待解析的 JSON 流）
+     * @return 解析后的当前 LogUtilsBean 实例（支持链式调用）
+     * @throws IOException JSON 解析异常（如格式错误、字段缺失）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        // 开始解析 JSON 对象（必须与 writeThisToJsonWriter 中的结构对应）
+        jsonReader.beginObject();
+        // 遍历 JSON 中的所有字段
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            // 解析字段，若字段不匹配则跳过该值（避免解析失败）
+            if (!this.initObjectsFromJsonReader(jsonReader, fieldName)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象解析（必须调用，否则会导致流异常）
+        jsonReader.endObject();
+        // 返回当前实例，支持链式调用（如 new LogUtilsBean().readBeanFromJsonReader(reader)）
+        return this;
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsClassTAGBean.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsClassTAGBean.java
new file mode 100644
index 0000000..83ce79e
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogUtilsClassTAGBean.java
@@ -0,0 +1,161 @@
+package cc.winboll.studio.libappbase;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/01/04 14:17:02
+ * @Describe 日志 TAG 过滤配置模型（继承 BaseBean，实现 JSON 序列化/反序列化）
+ * 封装单个日志 TAG 的名称及其启用状态，用于 LogUtils 的 TAG 过滤规则持久化存储与读取
+ */
+public class LogUtilsClassTAGBean extends BaseBean {
+
+    /** 当前类的日志 TAG（用于调试输出） */
+    public static final String TAG = "LogUtilsClassTAGBean";
+
+    /**
+     * 日志 TAG 名称（如 "LogViewThread"、"ToastUtils"）
+     * 与 LogUtils 中扫描的应用内 TAG 一一对应
+     */
+    private String tag;
+
+    /**
+     * TAG 启用状态（控制该 TAG 的日志是否输出）
+     * true：启用（输出该 TAG 的日志）；false：禁用（不输出该 TAG 的日志）
+     */
+    private Boolean enable;
+
+    /**
+     * 无参构造方法（默认初始化：TAG 为当前类 TAG，启用状态为 true）
+     * 用于 JSON 反序列化时的实例创建，或默认配置生成
+     */
+    public LogUtilsClassTAGBean() {
+        this.tag = TAG;       // 默认 TAG 为当前类的 TAG
+        this.enable = true;   // 默认启用该 TAG 的日志输出
+    }
+
+    /**
+     * 有参构造方法（指定 TAG 名称和启用状态）
+     * 用于主动创建 TAG 过滤配置实例
+     * @param tag     日志 TAG 名称
+     * @param enable  TAG 启用状态（true/false）
+     */
+    public LogUtilsClassTAGBean(String tag, Boolean enable) {
+        this.tag = tag;
+        this.enable = enable;
+    }
+
+    /**
+     * 设置日志 TAG 名称
+     * @param tag 目标 TAG 名称
+     */
+    public void setTag(String tag) {
+        this.tag = tag;
+    }
+
+    /**
+     * 获取日志 TAG 名称
+     * @return 当前配置的 TAG 名称
+     */
+    public String getTag() {
+        return tag;
+    }
+
+    /**
+     * 设置 TAG 启用状态
+     * @param enable 目标启用状态（true：启用；false：禁用）
+     */
+    public void setEnable(Boolean enable) {
+        this.enable = enable;
+    }
+
+    /**
+     * 获取 TAG 启用状态
+     * @return 当前 TAG 的启用状态
+     */
+    public Boolean getEnable() {
+        return enable;
+    }
+
+    /**
+     * 重写父类方法：获取当前类的全限定名（用于 BaseBean 反射识别）
+     * @return 类全限定名（如 "cc.winboll.studio.libappbase.LogUtilsClassTAGBean"）
+     */
+    @Override
+    public String getName() {
+        return LogUtilsClassTAGBean.class.getName();
+    }
+
+    /**
+     * 重写父类方法：将当前 TAG 配置对象序列化为 JSON（持久化存储时调用）
+     * 序列化字段：tag（TAG 名称）、enable（启用状态）
+     * @param jsonWriter JSON 写入器（用于输出 JSON 数据）
+     * @throws IOException JSON 写入异常（如流关闭、格式错误）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        // 调用父类序列化逻辑（若 BaseBean 有公共字段，需优先处理）
+        super.writeThisToJsonWriter(jsonWriter);
+        // 序列化 TAG 名称
+        jsonWriter.name("tag").value(this.getTag());
+        // 序列化启用状态
+        jsonWriter.name("enable").value(this.getEnable());
+    }
+
+    /**
+     * 重写父类方法：从 JSON 字段初始化当前对象（读取配置时调用）
+     * 解析字段：tag（TAG 名称）、enable（启用状态）
+     * @param jsonReader JSON 读取器（用于读取 JSON 数据）
+     * @param name       JSON 字段名（当前解析的字段）
+     * @return true：字段解析成功；false：字段不匹配（需父类处理或跳过）
+     * @throws IOException JSON 读取异常（如字段类型不匹配、流中断）
+     */
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        // 先让父类处理公共字段，处理成功则直接返回
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            return true;
+        }
+        // 解析当前类专属字段
+        if ("tag".equals(name)) {
+            // 读取 TAG 名称并设置
+            this.setTag(jsonReader.nextString());
+        } else if ("enable".equals(name)) {
+            // 读取启用状态并设置
+            this.setEnable(jsonReader.nextBoolean());
+        } else {
+            // 字段不匹配，返回 false 表示需要跳过该字段
+            return false;
+        }
+        // 字段解析成功
+        return true;
+    }
+
+    /**
+     * 重写父类方法：从 JSON 读取器完整解析配置对象（入口方法）
+     * 负责 JSON 对象的开始/结束解析，遍历所有字段并调用 initObjectsFromJsonReader 处理
+     * @param jsonReader JSON 读取器（传入待解析的 JSON 流）
+     * @return 解析后的当前 LogUtilsClassTAGBean 实例（支持链式调用）
+     * @throws IOException JSON 解析异常（如格式错误、字段缺失）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        // 开始解析 JSON 对象（必须与 writeThisToJsonWriter 中的结构对应）
+        jsonReader.beginObject();
+        // 遍历 JSON 中的所有字段
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            // 解析字段，若字段不匹配则跳过该值（避免解析失败）
+            if (!this.initObjectsFromJsonReader(jsonReader, fieldName)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象解析（必须调用，否则会导致流异常）
+        jsonReader.endObject();
+        // 返回当前实例，支持链式调用（如 new LogUtilsClassTAGBean().readBeanFromJsonReader(reader)）
+        return this;
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/LogView.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogView.java
new file mode 100644
index 0000000..56f5d38
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogView.java
@@ -0,0 +1,553 @@
+package cc.winboll.studio.libappbase;
+
+/**
+ * @Author ZhanGSKen@QQ.COM
+ * @Date 2024/08/12 14:36:18
+ * @Describe 日志视图类，继承 RelativeLayout 类。
+ */
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.os.Handler;
+import android.os.Message;
+import android.text.Editable;
+import android.text.TextWatcher;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.AdapterView;
+import android.widget.ArrayAdapter;
+import android.widget.BaseAdapter;
+import android.widget.CheckBox;
+import android.widget.EditText;
+import android.widget.HorizontalScrollView;
+import android.widget.RelativeLayout;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.views.HorizontalListView;
+import cc.winboll.studio.libappbase.widget.LogTagSpinner;
+import java.text.Collator;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+
+public class LogView extends RelativeLayout {
+
+    public static final String TAG = "LogView";
+
+    public volatile boolean mIsHandling;
+    public volatile boolean mIsAddNewLog;
+
+    Context mContext;
+    ScrollView mScrollView;
+    TextView mTextView;
+    EditText metTagSearch;
+    CheckBox mSelectableCheckBox;
+    CheckBox mSelectAllTAGCheckBox;
+    TAGListAdapter mTAGListAdapter;
+    LogViewThread mLogViewThread;
+    LogViewHandler mLogViewHandler;
+    LogTagSpinner mLogLevelSpinner;
+    ArrayAdapter<CharSequence> mLogLevelSpinnerAdapter;
+    // 标签列表
+    HorizontalListView mListViewTags;
+
+    public LogView(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public LogView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    public LogView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    public LogView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        initView(context);
+    }
+
+    public void start() {
+        mLogViewThread = new LogViewThread(LogView.this);
+        mLogViewThread.start();
+        // 显示日志
+        showAndScrollLogView();
+    }
+
+    public void scrollLogUp() {
+        mScrollView.post(new Runnable() {
+                @Override
+                public void run() {
+                    mScrollView.fullScroll(ScrollView.FOCUS_DOWN);
+                    // 日志显示结束
+                    mLogViewHandler.setIsHandling(false);
+                    // 检查是否添加了新日志
+                    if (mLogViewHandler.isAddNewLog()) {
+                        // 有新日志添加，先更改新日志标志
+                        mLogViewHandler.setIsAddNewLog(false);
+                        // 再次发送显示日志的显示
+                        Message message = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOGVIEW_UPDATE);
+                        mLogViewHandler.sendMessage(message);
+                    }
+                }
+            });
+    }
+
+    void initView(Context context) {
+        mContext = context;
+        mLogViewHandler = new LogViewHandler();
+        // 加载视图布局
+        addView(inflate(mContext, cc.winboll.studio.libappbase.R.layout.view_log, null));
+        // 初始化日志子控件视图
+        //
+        mScrollView = findViewById(cc.winboll.studio.libappbase.R.id.viewlogScrollViewLog);
+        mTextView = findViewById(cc.winboll.studio.libappbase.R.id.viewlogTextViewLog);
+        metTagSearch = findViewById(cc.winboll.studio.libappbase.R.id.tagsearch_et);
+        // 获取Log Level spinner实例
+        mLogLevelSpinner = findViewById(cc.winboll.studio.libappbase.R.id.viewlogSpinner1);
+
+		metTagSearch.setTextColor(mContext.getResources().getColor(R.color.white));
+        metTagSearch.addTextChangedListener(new TextWatcher() {
+
+                @Override
+                public void afterTextChanged(Editable editable) {
+                }
+
+                @Override
+                public void beforeTextChanged(CharSequence charSequence, int p, int p1, int p2) {
+                }
+
+                @Override
+                public void onTextChanged(CharSequence s, int start, int before, int count) {
+                    LogUtils.d(TAG, s.toString());
+                    if (s.length() > 0) {
+                        scrollToTag(s.toString());
+                    } else {
+                        HorizontalScrollView hsRoot = findViewById(R.id.viewlogHorizontalScrollView1);
+                        hsRoot.smoothScrollTo(0, 0);
+                        mListViewTags.resetScrollToStart();
+                    }
+//                    mListViewTags.postDelayed(new Runnable() {
+//                            @Override
+//                            public void run() {
+//                                mListViewTags.scrollToItem(5);
+//                            }
+//                        }, 100);
+                }
+                // 其他方法留空或按需实现
+            });
+
+
+        (findViewById(cc.winboll.studio.libappbase.R.id.viewlogButtonClean)).setOnClickListener(new View.OnClickListener(){
+
+                @Override
+                public void onClick(View v) {
+                    LogUtils.cleanLog();
+                    LogUtils.d(TAG, "Log is cleaned.");
+                }
+            });
+        (findViewById(cc.winboll.studio.libappbase.R.id.viewlogButtonCopy)).setOnClickListener(new View.OnClickListener(){
+
+                @Override
+                public void onClick(View v) {
+
+                    ClipboardManager cm = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(mContext.getPackageName(), LogUtils.loadLog()));
+                    LogUtils.d(TAG, "Log is copied.");
+                }
+            });
+        mSelectableCheckBox = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBoxSelectable);
+        mSelectableCheckBox.setOnClickListener(new View.OnClickListener(){
+                @Override
+                public void onClick(View v) {
+                    if (mSelectableCheckBox.isChecked()) {
+                        setDescendantFocusability(ViewGroup.FOCUS_BEFORE_DESCENDANTS);
+                    } else {
+                        setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
+                    }
+                }
+            });
+
+        // 设置日志级别列表
+//        ArrayList<String> adapterItems = new ArrayList<>();
+//        for (LogUtils.LOG_LEVEL e : LogUtils.LOG_LEVEL.values()) {
+//            adapterItems.add(e.name());
+//        }
+		String[] mLogLevelSpinnerData = new String[LogUtils.LOG_LEVEL.values().length];
+		for (int i = 0; i < LogUtils.LOG_LEVEL.values().length; i++) {
+			mLogLevelSpinnerData[i] = LogUtils.LOG_LEVEL.values()[i].name();
+		}
+		mLogLevelSpinner.setLogTagData(mLogLevelSpinnerData);
+        // 假设你有一个字符串数组作为选项列表
+        //String[] options = {"Option 1", "Option 2", "Option 3"};
+        // 创建一个ArrayAdapter来绑定数据到spinner
+//        mLogLevelSpinnerAdapter = ArrayAdapter.createFromResource(
+//            context, cc.winboll.studio.libappbase.R.array.enum_loglevel_array, android.R.layout.simple_spinner_item);
+//        mLogLevelSpinnerAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
+
+//        // 设置适配器并将它应用到spinner上
+//        mLogLevelSpinnerAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item); // 设置下拉视图样式
+//        mLogLevelSpinner.setAdapter(mLogLevelSpinnerAdapter);
+        // 为Spinner添加监听器
+        mLogLevelSpinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
+                @Override
+                public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
+                    //String selectedOption = mLogLevelSpinnerAdapter.getItem(position);
+                    // 处理选中的选项...
+                    LogUtils.setLogLevel(LogUtils.LOG_LEVEL.values()[position]);
+                }
+                @Override
+                public void onNothingSelected(AdapterView<?> parent) {
+                    // 如果没有选择，则执行此操作...
+                }
+            });
+        // 获取默认值的索引
+        int defaultValueIndex = LogUtils.getLogLevel().ordinal();
+
+        if (defaultValueIndex != -1) {
+            // 如果找到了默认值，设置默认选项
+            mLogLevelSpinner.setSelection(defaultValueIndex);
+        }
+
+        // 加载标签列表
+        Map<String, Boolean> mapTAGList = LogUtils.getMapTAGList();
+        boolean isAllSelect = true;
+        for (Map.Entry<String, Boolean> entry : mapTAGList.entrySet()) {
+            if (entry.getValue() == false) {
+                isAllSelect = false;
+                break;
+            }
+        }
+        CheckBox cbALLTAG = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBox1);
+        cbALLTAG.setChecked(isAllSelect);
+
+        // 加载标签表
+        mListViewTags = findViewById(cc.winboll.studio.libappbase.R.id.tags_listview);
+        mListViewTags.setVerticalOffset(10);
+        mTAGListAdapter = new TAGListAdapter(mContext, mapTAGList);
+        mListViewTags.setAdapter(mTAGListAdapter);
+
+        // 可以添加点击监听器来处理勾选框状态变化后的逻辑，比如获取当前勾选情况等
+        mTAGListAdapter.notifyDataSetChanged();
+
+        mSelectAllTAGCheckBox = findViewById(cc.winboll.studio.libappbase.R.id.viewlogCheckBox1);
+		ViewGroup.LayoutParams layoutParams2 = mSelectAllTAGCheckBox.getLayoutParams();
+		if (layoutParams2 != null) {
+			layoutParams2.width = ViewGroup.LayoutParams.WRAP_CONTENT;
+			layoutParams2.height = 75;
+		}
+		mSelectAllTAGCheckBox.setLayoutParams(layoutParams2);
+		//mSelectAllTAGCheckBox.setPadding(0,0,0,0);
+		TypedArray ta1 = mContext.obtainStyledAttributes(new int[] { R.attr.toolbarTextColor });
+		int toolbarTextColor1 = ta1.getColor(0, mContext.getResources().getColor(R.color.white));
+		ta1.recycle();
+		mSelectAllTAGCheckBox.setTextColor(toolbarTextColor1);
+        mSelectAllTAGCheckBox.setOnClickListener(new View.OnClickListener(){
+                @Override
+                public void onClick(View v) {
+                    LogUtils.setALlTAGListEnable(mSelectAllTAGCheckBox.isChecked());
+                    //LogUtils.setALlTAGListEnable(false);
+                    //mTAGListAdapter.notifyDataSetChanged();
+                    mTAGListAdapter.reload();
+                    //ToastUtils.show(String.format("onClick\nmSelectAllTAGCheckBox.isChecked() : %s", mSelectAllTAGCheckBox.isChecked()));
+                }
+            });
+
+
+		mLogLevelSpinner.updateTextSize(R.dimen.log_spinner_text_size);
+
+        // 设置滚动时不聚焦日志
+        setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
+    }
+
+    public void updateLogView() {
+        if (mLogViewHandler.isHandling() == true) {
+            // 正在处理日志显示，
+            // 就先设置一个新日志标志位
+            // 以便日志显示完后，再次显示新日志内容
+            mLogViewHandler.setIsAddNewLog(true);
+        } else {
+            //LogUtils.d(TAG, "LogListener showLog(String path)");
+            Message message = mLogViewHandler.obtainMessage(LogViewHandler.MSG_LOGVIEW_UPDATE);
+            mLogViewHandler.sendMessage(message);
+            mLogViewHandler.setIsAddNewLog(false);
+        }
+    }
+
+    void showAndScrollLogView() {
+        mTextView.setText(LogUtils.loadLog());
+        scrollLogUp();
+    }
+
+    public void scrollToTag(final String prefix) {
+        if (mTAGListAdapter == null || prefix == null || prefix.length() == 0) {
+            LogUtils.d(TAG, "参数为空，无法滚动");
+            return;
+        }
+
+        final List<TAGItemModel> itemList = mTAGListAdapter.getItemList();
+
+        mListViewTags.post(new Runnable() {
+                @Override
+                public void run() {
+                    // 查找匹配的标签位置
+                    int targetPosition = -1;
+
+                    for (int i = 0; i < itemList.size(); i++) {
+                        String tag = itemList.get(i).getTag();
+                        if (tag != null && tag.toLowerCase().startsWith(prefix.toLowerCase())) {
+                            targetPosition = i;
+
+                            break;
+                        }
+                    }
+
+                    if (targetPosition != -1) {
+                        // 优化滚动逻辑
+                        //mListViewTags.setSelection(targetPosition);
+                        //mListViewTags.invalidateViews(); // 强制刷新所有可见项
+
+                        // 单独刷新目标视图
+//                        View targetView = mListViewTags.getChildAt(targetPosition);
+//                        if (targetView != null) {
+//                            targetView.requestLayout();
+//                            targetView.requestFocus();
+//                        }
+
+                        final int scrollPosition = targetPosition;
+
+                        // 延迟滚动确保布局完成
+                        mListViewTags.postDelayed(new Runnable() {
+                                @Override
+                                public void run() {
+                                    LogUtils.d(TAG, String.format("scrollPosition %d", scrollPosition));
+                                    mListViewTags.scrollToItem(scrollPosition);
+                                }
+                            }, 100);
+                    } else {
+                        LogUtils.d(TAG, "未找到匹配的标签前缀：" + prefix);
+                    }
+                }
+            });
+    }
+
+
+
+    class LogViewHandler extends Handler {
+
+        final static int MSG_LOGVIEW_UPDATE = 0;
+        volatile boolean isHandling;
+        volatile boolean isAddNewLog;
+
+        public LogViewHandler() {
+            setIsHandling(false);
+            setIsAddNewLog(false);
+        }
+
+        public void setIsHandling(boolean isHandling) {
+            this.isHandling = isHandling;
+        }
+
+        public boolean isHandling() {
+            return isHandling;
+        }
+
+        public void setIsAddNewLog(boolean isAddNewLog) {
+            this.isAddNewLog = isAddNewLog;
+        }
+
+        public boolean isAddNewLog() {
+            return isAddNewLog;
+        }
+
+        public void handleMessage(Message msg) {
+            switch (msg.what) {
+                case MSG_LOGVIEW_UPDATE:{
+                        if (isHandling() == false) {
+                            setIsHandling(true);
+                            showAndScrollLogView();
+                        }
+                        break;
+                    }
+                default:
+                    break;
+            }
+            super.handleMessage(msg);
+        }
+    }
+
+    public class TAGItemModel {
+        private String tag;
+        private boolean isChecked;
+
+        public TAGItemModel(String tag, boolean isChecked) {
+            this.tag = tag;
+            this.isChecked = isChecked;
+        }
+
+        public String getTag() {
+            return tag;
+        }
+
+        public void setTag(String tag) {
+            this.tag = tag;
+        }
+
+        public boolean isChecked() {
+            return isChecked;
+        }
+
+        public void setChecked(boolean checked) {
+            isChecked = checked;
+        }
+
+        // getter/setter...
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) {
+                return true;
+            }
+            if (o == null || getClass() != o.getClass()) {
+                return false;
+            }
+            TAGItemModel that = (TAGItemModel) o;
+            // 手动处理空值比较（Java 6 不支持 Objects.equals）
+            if (tag == null) {
+                return that.tag == null;
+            } else {
+                return tag.equals(that.tag);
+            }
+        }
+
+        @Override
+        public int hashCode() {
+            return tag == null ? 0 : tag.hashCode(); // 手动处理空值
+        }
+    }
+
+
+    public class TAGListAdapter extends BaseAdapter {
+
+        private Context context;
+        private Map<String, Boolean> mapOrigin;
+        private List<TAGItemModel> itemList;
+
+        public TAGListAdapter(Context context, Map<String, Boolean> map) {
+            this.context = context;
+            mapOrigin = map;
+            loadMap(mapOrigin);
+        }
+
+        public List<TAGItemModel> getItemList() {
+            return itemList;
+        }
+
+        @Override
+        public int getCount() {
+            return itemList.size();
+        }
+
+        @Override
+        public Object getItem(int p) {
+            return itemList.get(p);
+        }
+
+        @Override
+        public long getItemId(int p) {
+            return p;
+        }
+
+        void loadMap(Map<String, Boolean> map) {
+            itemList = new ArrayList<TAGItemModel>();
+            for (Map.Entry<String, Boolean> entry : map.entrySet()) {
+                itemList.add(new TAGItemModel(entry.getKey(), entry.getValue()));
+            }
+            // 添加排序功能，按照tag进行升序排序
+            Collections.sort(itemList, new SortMapEntryByKeyString(true));
+            //Collections.sort(itemList, new SortMapEntryByKeyString(false));
+        }
+
+        public void reload() {
+            loadMap(mapOrigin);
+            super.notifyDataSetChanged();
+        }
+
+        @Override
+        public View getView(int position, View convertView, ViewGroup parent) {
+            ViewHolder holder;
+            if (convertView == null) {
+                convertView = LayoutInflater.from(context).inflate(R.layout.item_logtag, parent, false);
+                holder = new ViewHolder();
+                holder.tvText = convertView.findViewById(R.id.viewlogtagTextView1);
+                holder.cbChecked = convertView.findViewById(R.id.viewlogtagCheckBox1);
+                convertView.setTag(holder);
+            } else {
+                holder = (ViewHolder) convertView.getTag();
+            }
+
+            final TAGItemModel item = itemList.get(position);
+            holder.tvText.setText(item.getTag());
+			ViewGroup.LayoutParams layoutParams = holder.tvText.getLayoutParams();
+			if (layoutParams != null) {
+				layoutParams.width = ViewGroup.LayoutParams.WRAP_CONTENT;
+				layoutParams.height = 75;
+			}
+			holder.tvText.setLayoutParams(layoutParams);
+			holder.tvText.setPadding(0,0,0,0);
+			TypedArray ta2 = mContext.obtainStyledAttributes(new int[] { R.attr.toolbarTextColor });
+			int toolbarTextColor2 = ta2.getColor(0, mContext.getResources().getColor(R.color.white));
+			ta2.recycle();
+			holder.tvText.setTextColor(toolbarTextColor2);
+            holder.cbChecked.setChecked(item.isChecked());
+			holder.cbChecked.setLayoutParams(layoutParams);
+			holder.cbChecked.setPadding(0,0,0,0);
+			TypedArray ta3 = mContext.obtainStyledAttributes(new int[] { R.attr.toolbarTextColor });
+			int toolbarTextColor3 = ta3.getColor(0, mContext.getResources().getColor(R.color.white));
+			ta3.recycle();
+			holder.cbChecked.setTextColor(toolbarTextColor3);
+            holder.cbChecked.setOnClickListener(new View.OnClickListener(){
+
+                    @Override
+                    public void onClick(View v) {
+                        LogUtils.setTAGListEnable(item.getTag(), ((CheckBox)v).isChecked());
+                    }
+                });
+
+            return convertView;
+        }
+
+        public class ViewHolder {
+            TextView tvText;
+            CheckBox cbChecked;
+        }
+    }
+
+    class SortMapEntryByKeyString implements Comparator<TAGItemModel> {
+        private boolean mIsDesc = true;
+        // isDesc 是否降序排列
+        public SortMapEntryByKeyString(boolean isDesc) {
+            mIsDesc = isDesc;
+        }
+        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
+        @Override
+        public int compare(TAGItemModel o1, TAGItemModel o2) {
+            if (mIsDesc) {
+                return o1.getTag().compareTo(o2.getTag());
+            } else {
+                return o2.getTag().compareTo(o1.getTag());
+            }
+        }
+    }
+}
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/LogViewThread.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogViewThread.java
new file mode 100644
index 0000000..3941e45
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/LogViewThread.java
@@ -0,0 +1,140 @@
+package cc.winboll.studio.libappbase;
+
+import android.os.FileObserver;
+import java.lang.ref.WeakReference;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/08/12 14:43:50
+ * @Describe 日志视图线程类
+ * 独立线程监听日志文件目录变化（如写入、删除），触发日志视图更新，避免阻塞主线程
+ */
+public class LogViewThread extends Thread {
+
+    /** 日志标签（用于调试输出） */
+    public static final String TAG = "LogViewThread";
+
+    /** 线程退出标志（volatile 保证多线程可见性，控制循环退出） */
+    private volatile boolean isExit = false;
+    /** 日志文件目录监听实例（监听文件写入、删除事件） */
+    private LogListener mLogListener;
+    /** 日志视图弱引用（避免持有 LogView 强引用导致内存泄漏） */
+    private final WeakReference<LogView> mLogViewWeakRef;
+
+    /**
+     * 构造函数
+     * @param logView 日志显示视图实例（需通过弱引用持有，避免内存泄漏）
+     */
+    public LogViewThread(LogView logView) {
+        // 使用弱引用包装 LogView，当视图销毁时可被 GC 回收
+        mLogViewWeakRef = new WeakReference<>(logView);
+    }
+
+    /**
+     * 设置线程退出标志（触发线程停止监听并退出）
+     * @param exit true：退出线程；false：继续运行（默认）
+     */
+    public void setExit(boolean exit) {
+        this.isExit = exit;
+    }
+
+    /**
+     * 获取当前线程退出状态
+     * @return true：已标记退出；false：运行中
+     */
+    public boolean isExit() {
+        return isExit;
+    }
+
+    /**
+     * 线程核心逻辑：初始化文件监听并启动循环，直到收到退出标志
+     */
+    @Override
+    public void run() {
+        // 获取日志缓存目录路径（从 LogUtils 统一获取，确保路径一致性）
+        String logDirPath = LogUtils.getLogCacheDir().getPath();
+        LogUtils.d(TAG, "启动日志文件监听，监听目录：" + logDirPath);
+
+        // 初始化日志文件监听器（监听目标目录的文件事件）
+        mLogListener = new LogListener(logDirPath);
+        // 开始监听文件事件（非阻塞，内部通过 Native 层实现）
+        mLogListener.startWatching();
+
+        // 循环等待退出标志（每 1 秒检查一次，降低 CPU 占用）
+        while (!isExit()) {
+            try {
+                Thread.sleep(1000); // 休眠 1 秒，避免忙等
+            } catch (InterruptedException e) {
+                // 线程被中断时，恢复中断标志并退出循环（避免无限阻塞）
+                Thread.currentThread().interrupt();
+                LogUtils.d(TAG, "日志监听线程被中断，准备退出。" + e);
+                break;
+            }
+        }
+
+        // 收到退出标志，停止监听并释放资源
+        mLogListener.stopWatching();
+        LogUtils.d(TAG, "日志文件监听已停止，线程退出");
+    }
+
+    /**
+     * 日志文件监听内部类（继承 FileObserver，监听目录下文件变化）
+     * 仅关注文件写入完成（CLOSE_WRITE）和文件删除（DELETE）事件
+     */
+    private class LogListener extends FileObserver {
+
+        /**
+         * 构造函数
+         * @param path 监听的目录路径（此处为日志缓存目录）
+         */
+        public LogListener(String path) {
+            // 父类构造：监听指定目录的所有事件（通过位掩码 ALL_EVENTS 指定）
+            super(path);
+        }
+
+        /**
+         * 文件事件回调（运行在系统私有线程，非主线程）
+         * @param event 事件类型（通过位掩码表示，需与 ALL_EVENTS 按位与解析）
+         * @param path 发生事件的文件名（相对监听目录的路径）
+         */
+        @Override
+        public void onEvent(int event, String path) {
+            // 解析事件类型（排除无关事件，只处理目标事件）
+            int eventType = event & FileObserver.ALL_EVENTS;
+
+            switch (eventType) {
+					// 事件：文件写入完成（如日志写入结束并关闭文件）
+                case FileObserver.CLOSE_WRITE:
+                    // 触发日志视图更新（需先判断 LogView 是否未被回收）
+                    updateLogView();
+                    break;
+
+					// 事件：文件被删除（如日志清理操作）
+                case FileObserver.DELETE:
+                    LogUtils.d(TAG, "日志文件被删除，文件名：" + (path != null ? path : "未知"));
+                    // 触发日志视图更新（刷新视图显示空状态）
+                    updateLogView();
+                    break;
+
+                default:
+                    // 忽略其他无关事件（如文件创建、访问等）
+                    break;
+            }
+        }
+
+        /**
+         * 触发日志视图更新（通过弱引用获取 LogView，避免内存泄漏）
+         */
+        private void updateLogView() {
+            // 从弱引用中获取 LogView 实例（若视图已销毁，get() 返回 null）
+            LogView logView = mLogViewWeakRef.get();
+            if (logView != null) {
+                // 调用 LogView 的更新方法（需确保 updateLogView 内部处理主线程切换）
+                logView.updateLogView();
+            } else {
+                LogUtils.w(TAG, "LogView 已被回收，无法更新日志视图");
+            }
+        }
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/ToastUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/ToastUtils.java
new file mode 100644
index 0000000..a69fc37
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/ToastUtils.java
@@ -0,0 +1,268 @@
+package cc.winboll.studio.libappbase;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
+import android.widget.Toast;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:51
+ * @Describe 吐司工具类（单例模式）
+ * 简化 Android 吐司的创建与展示，通过独立线程 + Handler 处理消息，最终切换到主线程显示吐司，避免内存泄漏
+ */
+public class ToastUtils {
+
+    /** 工具类日志 TAG（用于调试输出） */
+    public static final String TAG = "ToastUtils";
+    /** 消息标识：显示短时长吐司 */
+    private static final int MSG_SHOW_SHORT_TOAST = 1001;
+
+    /** 单例实例（volatile 保证多线程下可见性，避免指令重排） */
+    private static volatile ToastUtils sInstance;
+    /** 全局上下文（volatile 保证多线程可见性，避免空指针） */
+    private volatile Context mContext;
+    /** 独立线程的 Handler（volatile 保证可见性） */
+    private volatile Handler mWorkerHandler;
+    /** 主线程 Handler（volatile 保证可见性） */
+    private volatile Handler mMainHandler;
+    /** 消息处理独立线程 */
+    private Thread mWorkerThread;
+    /** 资源释放标记（volatile 避免多线程误操作） */
+    private volatile boolean isReleased = false;
+
+    /**
+     * 私有构造方法（禁止外部直接创建实例，确保单例）
+     * 1. 初始化主线程 Handler；
+     * 2. 创建并启动独立消息处理线程。
+     */
+    private ToastUtils() {
+        initMainHandler(); // 优先初始化主线程 Handler
+        startWorkerThread(); // 启动独立消息处理线程
+    }
+
+    /**
+     * 初始化主线程 Handler
+     */
+    private void initMainHandler() {
+        if (Looper.getMainLooper() == null) {
+            LogUtils.e(TAG, "主线程 Looper 为空，无法初始化 mMainHandler");
+            throw new IllegalStateException("主线程 Looper 未初始化，无法创建 ToastUtils");
+        }
+        mMainHandler = new Handler(Looper.getMainLooper());
+        LogUtils.d(TAG, "主线程 Handler 初始化完成，线程ID：" + Looper.getMainLooper().getThread().getId());
+    }
+
+    /**
+     * 启动独立消息处理线程
+     */
+    private void startWorkerThread() {
+        mWorkerThread = new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "消息处理线程启动，线程ID：" + Thread.currentThread().getId());
+					Looper.prepare();
+
+					mWorkerHandler = new Handler(Looper.myLooper()) {
+						@Override
+						public void handleMessage(Message msg) {
+							super.handleMessage(msg);
+							// 若已释放，直接返回，不处理消息
+							if (isReleased) {
+								LogUtils.w(TAG, "资源已释放，忽略消息处理");
+								return;
+							}
+							LogUtils.d(TAG, "WorkerHandler 接收消息，当前线程ID：" + Thread.currentThread().getId());
+							if (msg.what == MSG_SHOW_SHORT_TOAST && msg.obj != null) {
+								String message = (String) msg.obj;
+								postToMainThreadShowToast(message);
+							}
+						}
+					};
+
+					Looper.loop();
+					LogUtils.d(TAG, "消息处理线程退出");
+				}
+			}, "ToastWorkerThread");
+        mWorkerThread.start();
+    }
+
+    /**
+     * 获取单例实例（双重检查锁定）
+     * @return ToastUtils 单例对象
+     */
+    private static ToastUtils getInstance() {
+        if (sInstance == null) {
+            synchronized (ToastUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new ToastUtils();
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    /**
+     * 初始化工具类（必须在 Application 启动时调用）
+     * @param context 全局上下文（推荐 Application 上下文）
+     */
+    public static void init(Context context) {
+        if (context == null) {
+            throw new IllegalArgumentException("初始化上下文不能为 null！");
+        }
+        ToastUtils instance = getInstance();
+        // 若已释放，重置释放标记
+        if (instance.isReleased) {
+            instance.isReleased = false;
+            instance.startWorkerThread(); // 重新启动线程
+        }
+        instance.mContext = context.getApplicationContext();
+        LogUtils.d(TAG, "ToastUtils 初始化完成，上下文已设置");
+    }
+
+    // ===================================== 新增：isInited() 方法 =====================================
+    /**
+     * 判断 ToastUtils 是否已初始化（供外部调用，如 CrashHandleNotifyUtils 中的复制提示）
+     * @return true：已初始化（可正常显示吐司）；false：未初始化/已释放（无法正常显示）
+     */
+    public static boolean isInited() {
+        ToastUtils instance = getInstance();
+        // 双重校验：1. 未释放 2. 上下文已设置（确保初始化完成）
+        return !instance.isReleased && instance.mContext != null;
+    }
+    // ===================================== 新增结束 =====================================
+
+    /**
+     * 外部接口：显示短时长吐司
+     * @param message 吐司内容
+     */
+    public static void show(String message) {
+        LogUtils.d(TAG, "外部调用 show()，当前线程ID：" + Thread.currentThread().getId());
+        if (message == null || message.isEmpty()) {
+            return;
+        }
+
+        ToastUtils instance = getInstance();
+        // 校验资源是否已释放
+        if (instance.isReleased) {
+            LogUtils.w(TAG, "ToastUtils 已释放，无法显示吐司：" + message);
+            return;
+        }
+        // 校验上下文是否初始化
+        if (instance.mContext == null) {
+            LogUtils.e(TAG, "ToastUtils 未初始化！请先调用 init(Context) 方法");
+            // 不抛出异常，避免崩溃，改为日志提示
+            return;
+        }
+
+        instance.sendToastMessage(message);
+    }
+
+    /**
+     * 发送吐司消息到 WorkerHandler
+     * @param message 吐司内容
+     */
+    private void sendToastMessage(String message) {
+        LogUtils.d(TAG, "发送消息到 WorkerHandler");
+        // 校验 WorkerHandler 是否就绪
+        if (mWorkerHandler == null) {
+            LogUtils.w(TAG, "WorkerHandler 未就绪，直接主线程显示");
+            postToMainThreadShowToast(message);
+            return;
+        }
+        // 发送消息
+        Message msg = mWorkerHandler.obtainMessage(MSG_SHOW_SHORT_TOAST);
+        msg.obj = message;
+        mWorkerHandler.sendMessage(msg);
+    }
+
+    /**
+     * 切换到主线程显示吐司
+     * @param message 吐司内容
+     */
+    private void postToMainThreadShowToast(final String message) {
+        LogUtils.d(TAG, "切换到主线程显示吐司，当前线程ID：" + Thread.currentThread().getId());
+        // 校验资源是否已释放
+        if (isReleased) {
+            LogUtils.w(TAG, "资源已释放，取消显示吐司");
+            return;
+        }
+        // 校验并初始化 mMainHandler
+        if (mMainHandler == null) {
+            LogUtils.e(TAG, "mMainHandler 为空，尝试重新初始化");
+            initMainHandler();
+            if (mMainHandler == null) {
+                LogUtils.e(TAG, "mMainHandler 初始化失败，无法显示吐司：" + message);
+                return;
+            }
+        }
+        // 主线程显示
+        mMainHandler.post(new Runnable() {
+				@Override
+				public void run() {
+					if (isReleased) return; // 释放后取消执行
+					showToastInternal(message);
+				}
+			});
+    }
+
+    /**
+     * 实际显示吐司（主线程）
+     * @param message 吐司内容
+     */
+    private void showToastInternal(String message) {
+        LogUtils.d(TAG, "执行 showToastInternal()");
+        // 最终校验上下文
+        if (mContext == null) {
+            LogUtils.w(TAG, "上下文为空，无法显示吐司：" + message);
+            // 尝试重新获取 Application 上下文（降级策略）
+            Context appContext = GlobalApplication.getInstance();
+            if (appContext != null) {
+                mContext = appContext;
+                Toast.makeText(mContext, message, Toast.LENGTH_SHORT).show();
+                LogUtils.d(TAG, "通过 GlobalApplication 获取上下文，成功显示吐司");
+            }
+            return;
+        }
+        Toast.makeText(mContext, message, Toast.LENGTH_SHORT).show();
+    }
+
+    /**
+     * 释放资源（仅在应用退出时调用）
+     */
+    public static void release() {
+        LogUtils.d(TAG, "开始释放 ToastUtils 资源");
+        ToastUtils instance = getInstance();
+        // 标记为已释放，阻止后续消息处理
+        instance.isReleased = true;
+
+        // 停止 Worker 线程
+        if (instance.mWorkerHandler != null && instance.mWorkerHandler.getLooper() != null) {
+            instance.mWorkerHandler.getLooper().quit();
+            instance.mWorkerHandler = null;
+        }
+
+        // 清理主线程 Handler
+        if (instance.mMainHandler != null) {
+            instance.mMainHandler.removeCallbacksAndMessages(null);
+            instance.mMainHandler = null;
+        }
+
+        // 等待线程退出
+        if (instance.mWorkerThread != null && instance.mWorkerThread.isAlive()) {
+            try {
+                instance.mWorkerThread.join(1000);
+            } catch (InterruptedException e) {
+				LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                Thread.currentThread().interrupt();
+            }
+            instance.mWorkerThread = null;
+        }
+
+        // 清空上下文（避免内存泄漏）
+        instance.mContext = null;
+        LogUtils.d(TAG, "ToastUtils 资源释放完成");
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/UTF8FileUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/UTF8FileUtils.java
new file mode 100644
index 0000000..c7407fb
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/UTF8FileUtils.java
@@ -0,0 +1,86 @@
+package cc.winboll.studio.libappbase;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.OutputStreamWriter;
+import java.nio.charset.StandardCharsets;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/11 20:45
+ * @Describe UTF-8 编码文件操作工具类
+ * 提供字符串与文件的相互转换，强制使用 UTF-8 编码，确保跨平台字符兼容性
+ */
+public class UTF8FileUtils {
+
+    /** 工具类日志 TAG（用于调试输出） */
+    public static final String TAG = "UTF8FileUtils";
+
+    /**
+     * 将字符串写入文件（强制 UTF-8 编码）
+     * 若文件父目录不存在，自动创建；覆盖原有文件内容
+     * @param filePath 文件路径（包含文件名，如 "/sdcard/test.txt"）
+     * @param content 要写入的字符串内容
+     * @throws IOException 写入失败时抛出（如权限不足、路径无效等）
+     */
+    public static void writeStringToFile(String filePath, String content) throws IOException {
+        // 根据路径创建文件对象
+        File file = new File(filePath);
+        // 获取父目录，若不存在则递归创建
+        File parentDir = file.getParentFile();
+        if (parentDir != null && !parentDir.exists()) {
+            parentDir.mkdirs();
+        }
+
+        // 初始化文件输出流（覆盖模式）
+        FileOutputStream outputStream = new FileOutputStream(file);
+        // 包装为 UTF-8 编码的字符输出流
+        OutputStreamWriter writer = new OutputStreamWriter(outputStream, StandardCharsets.UTF_8);
+
+        try {
+            // 写入字符串内容
+            writer.write(content);
+        } finally {
+            // 强制关闭流，避免资源泄漏（即使写入失败也确保流关闭）
+            writer.close();
+        }
+    }
+
+    /**
+     * 从文件读取字符串（强制 UTF-8 编码）
+     * 逐字符读取文件内容，拼接为完整字符串返回
+     * @param filePath 文件路径（包含文件名，如 "/sdcard/test.txt"）
+     * @return 文件内容字符串（空文件返回空字符串）
+     * @throws IOException 读取失败时抛出（如文件不存在、权限不足等）
+     */
+    public static String readStringFromFile(String filePath) throws IOException {
+        // 根据路径创建文件对象
+        File file = new File(filePath);
+        // 初始化文件输入流
+        FileInputStream inputStream = new FileInputStream(file);
+        // 包装为 UTF-8 编码的字符输入流
+        InputStreamReader reader = new InputStreamReader(inputStream, StandardCharsets.UTF_8);
+
+        // 字符串构建器，用于拼接读取的字符
+        StringBuilder content = new StringBuilder();
+        int charCode; // 存储单个字符的 ASCII 码
+
+        try {
+            // 逐字符读取（-1 表示读取到文件末尾）
+            while ((charCode = reader.read()) != -1) {
+                // 将 ASCII 码转换为字符，追加到字符串
+                content.append((char) charCode);
+            }
+        } finally {
+            // 强制关闭流，避免资源泄漏
+            reader.close();
+        }
+
+        // 返回读取的完整字符串
+        return content.toString();
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/activities/NfcRsaLoginActivity.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/activities/NfcRsaLoginActivity.java
new file mode 100644
index 0000000..0c96bfb
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/activities/NfcRsaLoginActivity.java
@@ -0,0 +1,328 @@
+package cc.winboll.studio.libappbase.activities;
+
+import android.app.Activity;
+import android.app.PendingIntent;
+import android.content.Intent;
+import android.nfc.NfcAdapter;
+import android.nfc.Tag;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Button;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.utils.NfcRsaAuthTool;
+
+/**
+ * @Describe NFC RSA登录认证窗口
+ * 核心逻辑：贴近NFC→有密钥显示保存按钮（存应用data区+内存缓存）→无密钥启用初始化按钮（生成私钥写NFC）
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 20:34:00
+ * @LastEditTime 2026/01/12 16:28:00
+ */
+public class NfcRsaLoginActivity extends Activity implements View.OnClickListener {
+    // 常量定义
+    private static final String TAG = "NfcRsaLoginActivity";
+
+    // NFC核心相关属性
+    private NfcAdapter mNfcAdapter;
+    private PendingIntent mNfcPendingIntent;
+
+    // 视图控件相关属性
+    private TextView mTvNfcState;
+    private TextView mTvPrivateKey;
+    private TextView mTvPublicKey;
+    private Button mBtnOptKey; // 复用按钮：有密钥=保存本地，无密钥=初始化密钥
+
+    // 业务相关属性
+    private NfcRsaAuthTool mNfcRsaAuthTool;
+    private boolean isPreparingInit = false;  // 标记是否准备初始化密钥（替代原写入标记）
+    private String mTempPrivateKey;          // 临时存储NFC读取的有效私钥，用于后续保存
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_nfc_rsa_operate);
+        initView();
+        initNfcTool();
+        initNfcConfig();
+        LogUtils.d(TAG, "onCreate: NFC RSA登录窗口初始化完成");
+    }
+
+    /**
+     * 初始化视图控件，绑定点击事件，默认状态配置
+     */
+    private void initView() {
+        mTvNfcState = findViewById(R.id.tv_nfc_state);
+        mTvPrivateKey = findViewById(R.id.tv_private_key);
+        mTvPublicKey = findViewById(R.id.tv_public_key);
+        mBtnOptKey = findViewById(R.id.btn_create_write_key);
+
+        mBtnOptKey.setOnClickListener(this);
+        mBtnOptKey.setEnabled(false);
+        mTvNfcState.setText("正在监听NFC卡片，请贴近设备检测密钥...");
+        mTvPrivateKey.setText("私钥内容：无");
+        mTvPublicKey.setText("公钥内容：无");
+        LogUtils.d(TAG, "initView: 视图控件初始化完成，功能按钮默认禁用");
+    }
+
+    /**
+     * 初始化核心工具类NfcRsaAuthTool，校验NFC基础可用性
+     */
+    private void initNfcTool() {
+        mNfcRsaAuthTool = NfcRsaAuthTool.getInstance(this);
+        LogUtils.d(TAG, "initNfcTool: NfcRsaAuthTool单例获取完成");
+
+        if (!mNfcRsaAuthTool.isNfcAvailable()) {
+            mTvNfcState.setText("❌ 设备不支持NFC或未开启NFC");
+            mBtnOptKey.setEnabled(false);
+            Toast.makeText(this, "请先在设置中开启NFC功能", Toast.LENGTH_LONG).show();
+            LogUtils.w(TAG, "initNfcTool: NFC不可用，设备不支持或未开启");
+        } else {
+            LogUtils.d(TAG, "initNfcTool: NFC基础可用性校验通过");
+        }
+    }
+
+    /**
+     * 初始化NFC前台监听配置，页面打开即生效，适配API30
+     */
+    private void initNfcConfig() {
+        mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
+        mNfcPendingIntent = PendingIntent.getActivity(
+			this,
+			0,
+			new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP),
+			PendingIntent.FLAG_UPDATE_CURRENT
+        );
+        LogUtils.d(TAG, "initNfcConfig: NFC前台监听配置初始化完成，适配API30");
+    }
+
+    /**
+     * 核心分发方法：处理NFC相关意图，区分 密钥检测/密钥初始化 逻辑
+     * @param intent NFC触发的意图对象
+     */
+    private void handleNfcIntent(Intent intent) {
+        if (mNfcRsaAuthTool == null || !mNfcRsaAuthTool.isNfcAvailable()) {
+            LogUtils.w(TAG, "handleNfcIntent: NFC工具类为空或NFC不可用，跳过意图处理");
+            return;
+        }
+
+        String action = intent.getAction();
+        LogUtils.d(TAG, "handleNfcIntent: 收到NFC意图，action=" + action);
+        if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(action)
+			|| NfcAdapter.ACTION_TECH_DISCOVERED.equals(action)
+			|| NfcAdapter.ACTION_TAG_DISCOVERED.equals(action)) {
+            Tag tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
+            if (tag != null) {
+                LogUtils.d(TAG, "handleNfcIntent: 成功提取NFC Tag对象，当前初始化准备状态=" + isPreparingInit);
+                if (isPreparingInit) {
+                    createWriteAndValidateKey(tag); // 准备初始化：生成+写NFC
+                } else {
+                    readAndValidateKey(tag);        // 正常状态：检测NFC密钥
+                }
+            } else {
+                LogUtils.w(TAG, "handleNfcIntent: NFC意图中未提取到有效Tag对象");
+            }
+        }
+    }
+
+    /**
+     * 读取NFC中私钥，执行有效性校验，区分场景更新UI（有有效密钥显保存按钮，无则显初始化按钮）
+     * @param tag NFC卡片Tag对象
+     */
+    private void readAndValidateKey(final Tag tag) {
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "readAndValidateKey: 子线程读取NFC私钥，Tag=" + tag);
+					final String privateKeyStr = mNfcRsaAuthTool.readPrivateKeyFromNfc(tag);
+					runOnUiThread(new Runnable() {
+							@Override
+							public void run() {
+								if (privateKeyStr != null && !privateKeyStr.isEmpty()) {
+									// NFC读取到私钥，校验有效性
+									boolean priValid = mNfcRsaAuthTool.validatePrivateKey(privateKeyStr);
+									String publicKeyStr = mNfcRsaAuthTool.getCachePublicKeyStr();
+									boolean pubValid = mNfcRsaAuthTool.validatePublicKey(privateKeyStr, publicKeyStr);
+
+									LogUtils.d(TAG, "readAndValidateKey: 私钥读取完成，有效性=" + priValid + "，公钥提取有效性=" + pubValid);
+									if (priValid) {
+										mTempPrivateKey = privateKeyStr; // 缓存有效私钥，用于后续保存
+										mTvNfcState.setText("✅ NFC检测到有效密钥，点击按钮保存到本地");
+										mBtnOptKey.setText("保存密钥到应用本地并缓存");
+									} else {
+										mTvNfcState.setText("⚠️ NFC私钥无效，点击按钮重新初始化");
+										mBtnOptKey.setText("初始化RSA密钥写入NFC");
+										mTempPrivateKey = null;
+									}
+									mTvPrivateKey.setText("私钥内容：\n" + privateKeyStr);
+									mTvPublicKey.setText(publicKeyStr != null ? "公钥内容：\n" + publicKeyStr : "公钥内容：提取失败");
+									mBtnOptKey.setEnabled(true);
+									Toast.makeText(NfcRsaLoginActivity.this, priValid ? "检测到有效密钥" : "密钥无效，请初始化", Toast.LENGTH_SHORT).show();
+								} else {
+									// NFC无有效私钥，显示初始化按钮
+									LogUtils.w(TAG, "readAndValidateKey: NFC中未读取到有效私钥");
+									mTvNfcState.setText("❌ NFC无有效RSA私钥，点击按钮初始化");
+									mTvPrivateKey.setText("私钥内容：无");
+									mTvPublicKey.setText("公钥内容：无");
+									mBtnOptKey.setText("初始化RSA密钥写入NFC");
+									mBtnOptKey.setEnabled(true);
+									mTempPrivateKey = null;
+									Toast.makeText(NfcRsaLoginActivity.this, "未检测到有效私钥", Toast.LENGTH_SHORT).show();
+								}
+								isPreparingInit = false; // 重置初始化标记
+								LogUtils.d(TAG, "readAndValidateKey: 私钥检测流程结束，重置初始化准备状态");
+							}
+						});
+				}
+			}).start();
+    }
+
+    /**
+     * 生成RSA私钥、写入NFC、执行密钥有效性校验并更新UI（初始化密钥核心逻辑）
+     * @param tag NFC卡片Tag对象
+     */
+    private void createWriteAndValidateKey(final Tag tag) {
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "createWriteAndValidateKey: 开始创建私钥并写入NFC，Tag=" + tag);
+					// 1. 生成RSA私钥
+					final String privateKeyStr = mNfcRsaAuthTool.generateRsaPrivateKey();
+					if (privateKeyStr == null) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									mTvNfcState.setText("❌ 私钥生成失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "私钥生成失败，请重试", Toast.LENGTH_SHORT).show();
+									isPreparingInit = false;
+									mBtnOptKey.setEnabled(true);
+								}
+							});
+						LogUtils.e(TAG, "createWriteAndValidateKey: RSA私钥生成失败");
+						return;
+					}
+					LogUtils.d(TAG, "createWriteAndValidateKey: RSA私钥生成成功");
+
+					// 2. 写入NFC卡片
+					final boolean writeSuccess = mNfcRsaAuthTool.writePrivateKeyToNfc(tag, privateKeyStr);
+					if (!writeSuccess) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									mTvNfcState.setText("❌ 私钥写入NFC失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "私钥写入失败，请重试", Toast.LENGTH_SHORT).show();
+									isPreparingInit = false;
+									mBtnOptKey.setEnabled(true);
+								}
+							});
+						LogUtils.e(TAG, "createWriteAndValidateKey: 私钥写入NFC失败");
+						return;
+					}
+					LogUtils.d(TAG, "createWriteAndValidateKey: 私钥写入NFC成功");
+
+					// 3. 提取公钥并双重校验有效性
+					final String publicKeyStr = mNfcRsaAuthTool.extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+					final boolean priValid = mNfcRsaAuthTool.validatePrivateKey(privateKeyStr);
+					final boolean pubValid = mNfcRsaAuthTool.validatePublicKey(privateKeyStr, publicKeyStr);
+
+					runOnUiThread(new Runnable() {
+							@Override
+							public void run() {
+								LogUtils.d(TAG, "createWriteAndValidateKey: 密钥校验完成，私钥有效=" + priValid + "，公钥有效=" + pubValid);
+								if (priValid && pubValid) {
+									mTvNfcState.setText("✅ 密钥初始化成功，已写入NFC");
+									mTvPrivateKey.setText("私钥内容：\n" + privateKeyStr);
+									mTvPublicKey.setText(publicKeyStr != null ? "公钥内容：\n" + publicKeyStr : "公钥内容：提取失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "密钥创建写入成功，可贴近NFC保存本地", Toast.LENGTH_LONG).show();
+								} else {
+									mTvNfcState.setText("⚠️ 写入成功，但密钥校验失败");
+									Toast.makeText(NfcRsaLoginActivity.this, "写入成功但密钥无效，请重新操作", Toast.LENGTH_LONG).show();
+								}
+								mBtnOptKey.setText("初始化RSA密钥写入NFC");
+								mBtnOptKey.setEnabled(true);
+								isPreparingInit = false;
+								mTempPrivateKey = null;
+							}
+						});
+				}
+			}).start();
+    }
+
+    /**
+     * 保存有效私钥到应用data区，同时缓存到工具类内存属性
+     */
+    private void saveKeyToLocalAndCache() {
+        LogUtils.d(TAG, "saveKeyToLocalAndCache: 开始执行密钥本地保存+内存缓存");
+        if (mTempPrivateKey == null || mTempPrivateKey.isEmpty()) {
+            Toast.makeText(this, "无有效密钥可保存", Toast.LENGTH_SHORT).show();
+            LogUtils.w(TAG, "saveKeyToLocalAndCache: 临时有效私钥为空，保存失败");
+            return;
+        }
+        boolean saveSuccess = mNfcRsaAuthTool.savePrivateKeyToLocal(mTempPrivateKey);
+        if (saveSuccess) {
+            mTvNfcState.setText("✅ 密钥已保存到应用本地，登录完成");
+            mTvPrivateKey.setText("私钥内容：\n" + mNfcRsaAuthTool.getCachePrivateKeyStr());
+            mTvPublicKey.setText("公钥内容：\n" + mNfcRsaAuthTool.getCachePublicKeyStr());
+            mBtnOptKey.setEnabled(false);
+            Toast.makeText(this, "密钥保存成功，已缓存到内存", Toast.LENGTH_LONG).show();
+            LogUtils.d(TAG, "saveKeyToLocalAndCache: 密钥本地存储+工具类内存缓存成功");
+        } else {
+            Toast.makeText(this, "密钥保存到本地失败", Toast.LENGTH_SHORT).show();
+            LogUtils.e(TAG, "saveKeyToLocalAndCache: 密钥本地保存失败");
+        }
+    }
+
+    @Override
+    public void onClick(View v) {
+        if (v.getId() == R.id.btn_create_write_key) {
+            LogUtils.d(TAG, "onClick: 点击功能按钮，当前按钮文本=" + mBtnOptKey.getText().toString());
+            if (!mNfcRsaAuthTool.isNfcAvailable()) {
+                Toast.makeText(this, "NFC不可用，无法执行操作", Toast.LENGTH_SHORT).show();
+                LogUtils.w(TAG, "onClick: NFC不可用，拒绝按钮操作");
+                return;
+            }
+
+            if (mBtnOptKey.getText().toString().contains("保存")) {
+                // 按钮为保存功能：直接保存本地+缓存
+                saveKeyToLocalAndCache();
+            } else {
+                // 按钮为初始化功能：进入准备状态，等待贴近NFC
+                isPreparingInit = true;
+                mTvNfcState.setText("请贴近NFC卡片，执行密钥写入...");
+                mBtnOptKey.setEnabled(false);
+                Toast.makeText(this, "请贴近NFC卡片完成密钥初始化", Toast.LENGTH_SHORT).show();
+                LogUtils.d(TAG, "onClick: 已进入密钥初始化准备状态，等待NFC贴近");
+            }
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        if (mNfcAdapter != null && mNfcRsaAuthTool.isNfcAvailable()) {
+            mNfcAdapter.enableForegroundDispatch(this, mNfcPendingIntent, null, null);
+            LogUtils.d(TAG, "onResume: NFC前台监听已启用");
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        if (mNfcAdapter != null) {
+            mNfcAdapter.disableForegroundDispatch(this);
+            LogUtils.d(TAG, "onPause: NFC前台监听已禁用");
+        }
+    }
+
+    @Override
+    protected void onNewIntent(Intent intent) {
+        super.onNewIntent(intent);
+        setIntent(intent);
+        LogUtils.d(TAG, "onNewIntent: 收到新NFC意图，分发处理");
+        handleNfcIntent(intent);
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/APPValidationDialog.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/APPValidationDialog.java
new file mode 100644
index 0000000..2e70ea8
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/APPValidationDialog.java
@@ -0,0 +1,186 @@
+package cc.winboll.studio.libappbase.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.graphics.Color;
+import android.os.Bundle;
+import android.widget.EditText;
+import android.widget.TextView;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.utils.APPUtils;
+import cc.winboll.studio.libappbase.utils.ApkSignUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-20 21:20:00
+ * @LastEditTime 2026-01-24 18:45:00
+ * @Describe 签名显示+正版校验对话框：展示应用签名字节位信息，调用网络接口完成正版合法性校验，实时返回校验结果
+ */
+public class APPValidationDialog extends Dialog {
+    // ===================================== 全局常量 =====================================
+    public static final String TAG = "AppValidationDialog";
+    // 签名字节位分组大小
+    private static final int BIT_GROUP_SIZE = 16;
+
+    // ===================================== 控件与上下文属性 =====================================
+    private Context mContext;
+    private EditText etSignFingerprint;
+    private TextView tvAuthResult;
+
+    // ===================================== 业务入参属性 =====================================
+    private String appName;
+    private String versionName;
+    private String clientSign;
+    private String clientHash;
+
+    // ===================================== 构造方法 =====================================
+    public APPValidationDialog(Context context, String appName, String versionName) {
+        super(context, R.style.DialogStyle);
+        this.mContext = context;
+        this.appName = appName;
+        this.versionName = versionName;
+        LogUtils.d(TAG, "AppValidationDialog: 构造方法初始化，入参-> projectName=" + appName + ", versionName=" + versionName);
+    }
+
+    // ===================================== 生命周期方法 =====================================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate: 对话框创建，开始初始化布局与业务逻辑");
+        setContentView(R.layout.dialog_sign_get);
+        setCancelable(true);
+        // 初始化应用签名与哈希
+        initSignAndHash();
+        // 初始化页面控件
+        initView();
+        // 执行签名展示与正版校验
+        doSignShowAndAuthCheck();
+        LogUtils.d(TAG, "onCreate: 对话框初始化流程执行完成");
+    }
+
+    // ===================================== 页面与数据初始化方法 =====================================
+    /**
+     * 初始化页面控件，绑定视图并设置基础属性
+     */
+    private void initView() {
+        LogUtils.d(TAG, "initView: 开始初始化页面控件");
+        etSignFingerprint = findViewById(R.id.et_sign_fingerprint);
+        tvAuthResult = findViewById(R.id.tv_auth_result);
+        // 签名显示框设为只读，方便用户复制
+        etSignFingerprint.setEnabled(false);
+        // 填充签名字节位信息
+        etSignFingerprint.setText(convertSignToBitArrayWithWrap(clientSign));
+        LogUtils.d(TAG, "initView: 控件初始化完成，已填充签名字节位信息");
+    }
+
+    /**
+     * 初始化应用签名与SHA256哈希，调用工具类获取与服务端对齐的参数
+     */
+    private void initSignAndHash() {
+        LogUtils.d(TAG, "initSignAndHash: 开始获取应用签名与SHA256哈希");
+        this.clientSign = ApkSignUtils.getApkSignAlignedWithServer(mContext);
+        this.clientHash = ApkSignUtils.getApkSHA256Hash(mContext);
+        LogUtils.d(TAG, "initSignAndHash: 签名与哈希获取完成-> clientSign=" + clientSign + ", clientHash=" + clientHash);
+    }
+
+    // ===================================== 核心业务方法 =====================================
+    /**
+     * 核心业务：展示签名字节位信息，发起网络正版校验请求
+     */
+    private void doSignShowAndAuthCheck() {
+        LogUtils.d(TAG, "doSignShowAndAuthCheck: 开始执行应用正版合法性校验");
+        // 校验签名与哈希非空，避免空参请求
+        if (clientSign == null || clientHash == null) {
+            String errorMsg = "应用签名或哈希获取失败，无法执行正版校验";
+            LogUtils.e(TAG, "doSignShowAndAuthCheck: " + errorMsg);
+            tvAuthResult.setTextColor(Color.RED);
+            tvAuthResult.setText(errorMsg);
+            ToastUtils.show(errorMsg);
+            return;
+        }
+        // 调用网络校验接口
+        new APPUtils().checkAPKValidation(
+			mContext,
+			appName,
+			versionName,
+			clientSign,
+			clientHash,
+			new APPUtils.CheckResultCallback() {
+				@Override
+				public void onResult(boolean isValid, String message) {
+					LogUtils.d(TAG, "checkAPKValidation: 校验结果返回-> isValid=" + isValid + ", message=" + message);
+					handleAuthResult(isValid, message);
+				}
+			}
+        );
+    }
+
+    /**
+     * 处理正版校验结果，更新UI并提示用户
+     * @param isValid 校验是否通过
+     * @param message 服务端返回提示信息
+     */
+    private void handleAuthResult(boolean isValid, String message) {
+        String showMessage;
+        if (isValid) {
+            showMessage = "< 这是正版的 WinBoLL 应用，请放心使用。 >";
+            tvAuthResult.setTextColor(Color.BLUE);
+            LogUtils.d(TAG, "handleAuthResult: 正版校验通过，" + showMessage + "，服务端信息：" + message);
+        } else {
+            showMessage = "< 您使用的可能不是正版的 WinBoLL 应用。 >";
+            tvAuthResult.setTextColor(Color.RED);
+            LogUtils.e(TAG, "handleAuthResult: 正版校验失败，" + showMessage + "，失败原因：" + message);
+        }
+        // 更新UI并弹提示
+        tvAuthResult.setText(showMessage);
+        ToastUtils.show(showMessage);
+    }
+
+    // ===================================== 工具方法 =====================================
+    /**
+     * 签名字符串转0/1比特数组格式：每2个bit加空格，每16位换行，提升可读性
+     * @param signStr 原始签名字符串
+     * @return 格式化后的比特数字符串，签名字符为空返回空串
+     */
+    private String convertSignToBitArrayWithWrap(String signStr) {
+        LogUtils.d(TAG, "convertSignToBitArrayWithWrap: 开始格式化签名字符串为比特数组");
+        if (signStr == null || signStr.isEmpty()) {
+            LogUtils.w(TAG, "convertSignToBitArrayWithWrap: 原始签名字符串为空，返回空串");
+            return "";
+        }
+        // 字符转8位补零的二进制字符串
+        StringBuilder bitBuilder = new StringBuilder();
+        for (char c : signStr.toCharArray()) {
+            String bit8 = String.format("%8s", Integer.toBinaryString(c)).replace(' ', '0');
+            bitBuilder.append(bit8);
+        }
+        String fullBitStr = bitBuilder.toString();
+        LogUtils.d(TAG, "convertSignToBitArrayWithWrap: 签名转二进制完成，总长度=" + fullBitStr.length() + "bit");
+
+        // 按16位分组，组内每2bit加空格，分组后换行
+        StringBuilder finalBuilder = new StringBuilder();
+        for (int i = 0; i < fullBitStr.length(); i += BIT_GROUP_SIZE) {
+            int end = Math.min(i + BIT_GROUP_SIZE, fullBitStr.length());
+            String group = fullBitStr.substring(i, end);
+            // 组内加空格
+            StringBuilder groupWithSpace = new StringBuilder();
+            for (int j = 0; j < group.length(); j++) {
+                groupWithSpace.append(group.charAt(j));
+                if ((j + 1) % 2 == 0 && j != group.length() - 1) {
+                    groupWithSpace.append(" ");
+                }
+            }
+            finalBuilder.append(groupWithSpace);
+            // 最后一组不换行
+            if (end < fullBitStr.length()) {
+                finalBuilder.append("\n");
+            }
+        }
+        LogUtils.d(TAG, "convertSignToBitArrayWithWrap: 签名比特数组格式化完成");
+        return finalBuilder.toString();
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/DebugHostDialog.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/DebugHostDialog.java
new file mode 100644
index 0000000..1141570
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/dialogs/DebugHostDialog.java
@@ -0,0 +1,99 @@
+package cc.winboll.studio.libappbase.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.os.Bundle;
+import android.text.TextUtils;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/22 20:59
+ * @Describe WinBoLL服务器地址设置对话框（调试模式专用）
+ */
+public class DebugHostDialog extends Dialog implements View.OnClickListener {
+    public static final String TAG = "DebugHostDialog";
+
+    private Context mContext;
+    private EditText etHostInput;
+    private Button btnConfirm;
+    private Button btnCancel;
+
+    // 构造方法（适配默认样式）
+    public DebugHostDialog(Context context) {
+        super(context, R.style.DialogStyle);
+        this.mContext = context;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.dialog_winboll_host); // 绑定XML布局
+        setCancelable(true); // 点击外部可关闭
+        initView();
+        initData();
+        LogUtils.d(TAG, "DebugHostDialog 初始化完成");
+    }
+
+    // 初始化视图
+    private void initView() {
+        etHostInput = findViewById(R.id.et_host_input);
+        btnConfirm = findViewById(R.id.btn_confirm);
+        btnCancel = findViewById(R.id.btn_cancel);
+
+        // 绑定点击事件
+        btnConfirm.setOnClickListener(this);
+        btnCancel.setOnClickListener(this);
+    }
+
+    // 初始化数据（显示当前已保存的地址）
+    private void initData() {
+        String currentHost = GlobalApplication.getWinbollHost();
+        if (!TextUtils.isEmpty(currentHost)) {
+            etHostInput.setText(currentHost);
+            etHostInput.setSelection(currentHost.length()); // 光标定位到末尾
+            LogUtils.d(TAG, "当前已保存的服务器地址：" + currentHost);
+        }
+    }
+
+    @Override
+    public void onClick(View v) {
+        int id = v.getId();
+        if (id == R.id.btn_confirm) {
+            handleConfirm(); // 确认设置
+        } else if (id == R.id.btn_cancel) {
+            dismiss(); // 取消对话框
+        }
+    }
+
+    // 处理确认设置逻辑
+    private void handleConfirm() {
+        String inputHost = etHostInput.getText().toString().trim();
+        if (TextUtils.isEmpty(inputHost)) {
+            ToastUtils.show("服务器地址不能为空");
+            LogUtils.w(TAG, "设置失败：地址为空");
+            return;
+        }
+
+        // 简单校验URL格式（避免明显错误）
+        if (!inputHost.startsWith("http://") && !inputHost.startsWith("https://")) {
+            ToastUtils.show("地址需以http://或https://开头");
+            LogUtils.w(TAG, "设置失败：地址格式错误，input=" + inputHost);
+            return;
+        }
+
+        // 保存地址到SP+内存
+        GlobalApplication.setWinbollHost(inputHost);
+        ToastUtils.show("服务器地址设置成功");
+        LogUtils.d(TAG, "服务器地址设置成功：" + inputHost);
+        dismiss(); // 关闭对话框
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/models/APPInfo.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/models/APPInfo.java
new file mode 100644
index 0000000..df1dea9
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/models/APPInfo.java
@@ -0,0 +1,214 @@
+package cc.winboll.studio.libappbase.models;
+
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.Serializable;
+
+/**
+ * @Describe 应用信息实体类，存储应用核心配置信息，实现序列化接口
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 12:29:00
+ * @LastEditTime 2026/01/12 00:15:00
+ */
+public class APPInfo implements Serializable {
+    // 常量定义区
+    public static final String TAG = "APPInfo";
+
+    // 成员属性区（按功能归类排序，统一私有访问权限，Java7 兼容，注释清晰）
+    private String appName;             // 应用名称
+    private int appIcon;                // 应用图标资源ID
+    private String appDescription;      // 应用描述文案
+    private String appGitName;          // 应用Git仓库名称
+    private String appGitOwner;         // 应用Git仓库拥有者账号
+    private String appGitAPPBranch;     // 应用Git仓库对应分支
+    private String appGitAPPSubProjectFolder;  // 应用Git仓库内子项目文件夹路径
+    private String appHomePage;         // 应用官方主页地址
+    private String appAPKName;          // 应用安装包名称
+    private String appAPKFolderName;    // 应用安装包存储文件夹名称
+    private boolean isAddDebugTools;    // 是否启用应用调试工具功能
+
+    // 构造方法区（按 参数从少到多 排序，逻辑清晰，便于调用选型）
+    /**
+     * 无参构造方法，默认初始化WinBoLL应用基础配置
+     */
+    public APPInfo() {
+        LogUtils.d(TAG, "APPInfo() 无参构造方法调用，执行默认配置初始化");
+        String szBranchName = "winboll";
+        this.appName = "WinBoLL";
+        this.appIcon = R.drawable.ic_winboll;
+        this.appDescription = "Hello, WinBoLl!";
+        this.appGitName = "WinBoLL";
+        this.appGitOwner = "Studio";
+        this.appGitAPPBranch = szBranchName;
+        this.appGitAPPSubProjectFolder = szBranchName;
+        this.appHomePage = "https://www.winboll.cc/apks/index.php?project=WinBoLL";
+        this.appAPKName = "WinBoLL";
+        this.appAPKFolderName = "WinBoLL";
+        this.isAddDebugTools = false;
+        LogUtils.d(TAG, "APPInfo() 无参构造初始化完成，默认应用名称：" + this.appName);
+    }
+
+    /**
+     * 多参构造方法（不含调试工具配置，默认关闭调试功能）
+     * @param appName 应用名称
+     * @param appIcon 应用图标资源ID
+     * @param appDescription 应用描述
+     * @param appGitName Git仓库名称
+     * @param appGitOwner Git仓库拥有者
+     * @param appGitAPPBranch Git仓库分支
+     * @param appGitAPPSubProjectFolder Git子项目文件夹
+     * @param appHomePage 应用主页
+     * @param appAPKName 应用包名
+     * @param appAPKFolderName 应用包存储文件夹名
+     */
+    public APPInfo(String appName, int appIcon, String appDescription, String appGitName, String appGitOwner, 
+                   String appGitAPPBranch, String appGitAPPSubProjectFolder, String appHomePage, 
+                   String appAPKName, String appAPKFolderName) {
+        LogUtils.d(TAG, "APPInfo(多参无调试) 构造调用，入参应用名：" + appName + " | Git仓库名：" + appGitName);
+        this.appName = appName;
+        this.appIcon = appIcon;
+        this.appDescription = appDescription;
+        this.appGitName = appGitName;
+        this.appGitOwner = appGitOwner;
+        this.appGitAPPBranch = appGitAPPBranch;
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+        this.appHomePage = appHomePage;
+        this.appAPKName = appAPKName;
+        this.appAPKFolderName = appAPKFolderName;
+        this.isAddDebugTools = false;
+        LogUtils.d(TAG, "APPInfo(多参无调试) 构造初始化完成");
+    }
+
+    /**
+     * 全参构造方法（包含调试工具配置，支持自定义调试开关）
+     * @param appName 应用名称
+     * @param appIcon 应用图标资源ID
+     * @param appDescription 应用描述
+     * @param appGitName Git仓库名称
+     * @param appGitOwner Git仓库拥有者
+     * @param appGitAPPBranch Git仓库分支
+     * @param appGitAPPSubProjectFolder Git子项目文件夹
+     * @param appHomePage 应用主页
+     * @param appAPKName 应用包名
+     * @param appAPKFolderName 应用包存储文件夹名
+     * @param isAddDebugTools 是否开启调试工具
+     */
+    public APPInfo(String appName, int appIcon, String appDescription, String appGitName, String appGitOwner, 
+                   String appGitAPPBranch, String appGitAPPSubProjectFolder, String appHomePage, 
+                   String appAPKName, String appAPKFolderName, boolean isAddDebugTools) {
+        LogUtils.d(TAG, "APPInfo(全参带调试) 构造调用，入参应用名：" + appName + " | 调试开关：" + isAddDebugTools);
+        this.appName = appName;
+        this.appIcon = appIcon;
+        this.appDescription = appDescription;
+        this.appGitName = appGitName;
+        this.appGitOwner = appGitOwner;
+        this.appGitAPPBranch = appGitAPPBranch;
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+        this.appHomePage = appHomePage;
+        this.appAPKName = appAPKName;
+        this.appAPKFolderName = appAPKFolderName;
+        this.isAddDebugTools = isAddDebugTools;
+        LogUtils.d(TAG, "APPInfo(全参带调试) 构造初始化完成");
+    }
+
+    // Getter/Setter 方法区（严格跟随成员属性定义顺序，易查找维护，仅Setter加调试日志）
+    public String getAppName() {
+        return appName;
+    }
+
+    public void setAppName(String appName) {
+        LogUtils.d(TAG, "setAppName() 调用，传入应用名称：" + appName);
+        this.appName = appName;
+    }
+
+    public int getAppIcon() {
+        return appIcon;
+    }
+
+    public void setAppIcon(int appIcon) {
+        LogUtils.d(TAG, "setAppIcon() 调用，传入图标资源ID：" + appIcon);
+        this.appIcon = appIcon;
+    }
+
+    public String getAppDescription() {
+        return appDescription;
+    }
+
+    public void setAppDescription(String appDescription) {
+        LogUtils.d(TAG, "setAppDescription() 调用，传入描述文案：" + appDescription);
+        this.appDescription = appDescription;
+    }
+
+    public String getAppGitName() {
+        return appGitName;
+    }
+
+    public void setAppGitName(String appGitName) {
+        LogUtils.d(TAG, "setAppGitName() 调用，传入Git仓库名：" + appGitName);
+        this.appGitName = appGitName;
+    }
+
+    public String getAppGitOwner() {
+        return appGitOwner;
+    }
+
+    public void setAppGitOwner(String appGitOwner) {
+        LogUtils.d(TAG, "setAppGitOwner() 调用，传入Git拥有者：" + appGitOwner);
+        this.appGitOwner = appGitOwner;
+    }
+
+    public String getAppGitAPPBranch() {
+        return appGitAPPBranch;
+    }
+
+    public void setAppGitAPPBranch(String appGitAPPBranch) {
+        LogUtils.d(TAG, "setAppGitAPPBranch() 调用，传入Git分支：" + appGitAPPBranch);
+        this.appGitAPPBranch = appGitAPPBranch;
+    }
+
+    public String getAppGitAPPSubProjectFolder() {
+        return appGitAPPSubProjectFolder;
+    }
+
+    public void setAppGitAPPSubProjectFolder(String appGitAPPSubProjectFolder) {
+        LogUtils.d(TAG, "setAppGitAPPSubProjectFolder() 调用，传入Git子项目文件夹：" + appGitAPPSubProjectFolder);
+        this.appGitAPPSubProjectFolder = appGitAPPSubProjectFolder;
+    }
+
+    public String getAppHomePage() {
+        return appHomePage;
+    }
+
+    public void setAppHomePage(String appHomePage) {
+        LogUtils.d(TAG, "setAppHomePage() 调用，传入应用主页地址：" + appHomePage);
+        this.appHomePage = appHomePage;
+    }
+
+    public String getAppAPKName() {
+        return appAPKName;
+    }
+
+    public void setAppAPKName(String appAPKName) {
+        LogUtils.d(TAG, "setAppAPKName() 调用，传入应用包名：" + appAPKName);
+        this.appAPKName = appAPKName;
+    }
+
+    public String getAppAPKFolderName() {
+        return appAPKFolderName;
+    }
+
+    public void setAppAPKFolderName(String appAPKFolderName) {
+        LogUtils.d(TAG, "setAppAPKFolderName() 调用，传入包存储文件夹名：" + appAPKFolderName);
+        this.appAPKFolderName = appAPKFolderName;
+    }
+
+    public boolean isAddDebugTools() {
+        return isAddDebugTools;
+    }
+
+    public void setIsAddDebugTools(boolean isAddDebugTools) {
+        LogUtils.d(TAG, "setIsAddDebugTools() 调用，传入调试开关状态：" + isAddDebugTools);
+        this.isAddDebugTools = isAddDebugTools;
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/models/SFTPAuthModel.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/models/SFTPAuthModel.java
new file mode 100644
index 0000000..38f7da8
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/models/SFTPAuthModel.java
@@ -0,0 +1,101 @@
+package cc.winboll.studio.libappbase.models;
+
+/**
+ * SFTP登录验证信息实体类
+ * 封装SFTP登录所需的所有配置信息：服务端地址、端口、账号密码、秘钥信息、编码
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/30 19:08:00
+ * @LastEditTime 2026/01/31 22:45:00
+ */
+public class SFTPAuthModel {
+    public static final String TAG = "SFTPAuthModel";
+
+    // SFTP服务器地址（必填，如192.168.1.100、sftp.xxx.com）
+    private String ftpServer;
+    // SFTP服务器端口（必填，默认22）
+    private int ftpPort = 22;
+    // SFTP登录用户名（匿名登录传null/空）
+    private String ftpUsername;
+    // SFTP登录密码（匿名登录传null/空）
+    private String ftpPassword;
+    // SFTP登录秘钥路径（秘钥登录时使用，本地绝对路径，如/sdcard/sftp/key.pem，账号密码登录传null/空）
+    private String ftpKeyPath;
+    // SFTP登录秘钥密码（秘钥有密码时填写，无密码传null/空）
+    private String ftpKeyPwd;
+    // SFTP编码（默认UTF-8，解决中文文件名乱码）
+    private String ftpCharset = "UTF-8";
+
+    // 空参构造（JavaBean规范）
+    public SFTPAuthModel() {
+    }
+
+    // 全参构造（快速初始化）
+    public SFTPAuthModel(String ftpServer, int ftpPort, String ftpUsername, String ftpPassword,
+						 String ftpKeyPath, String ftpKeyPwd, String ftpCharset) {
+        this.ftpServer = ftpServer;
+        this.ftpPort = ftpPort;
+        this.ftpUsername = ftpUsername;
+        this.ftpPassword = ftpPassword;
+        this.ftpKeyPath = ftpKeyPath;
+        this.ftpKeyPwd = ftpKeyPwd;
+        this.ftpCharset = ftpCharset;
+    }
+
+    // ==================== Get/Set 方法 ====================
+    public String getFtpServer() {
+        return ftpServer;
+    }
+
+    public void setFtpServer(String ftpServer) {
+        this.ftpServer = ftpServer;
+    }
+
+    public int getFtpPort() {
+        return ftpPort;
+    }
+
+    public void setFtpPort(int ftpPort) {
+        this.ftpPort = ftpPort;
+    }
+
+    public String getFtpUsername() {
+        return ftpUsername;
+    }
+
+    public void setFtpUsername(String ftpUsername) {
+        this.ftpUsername = ftpUsername;
+    }
+
+    public String getFtpPassword() {
+        return ftpPassword;
+    }
+
+    public void setFtpPassword(String ftpPassword) {
+        this.ftpPassword = ftpPassword;
+    }
+
+    public String getFtpKeyPath() {
+        return ftpKeyPath;
+    }
+
+    public void setFtpKeyPath(String ftpKeyPath) {
+        this.ftpKeyPath = ftpKeyPath;
+    }
+
+    public String getFtpKeyPwd() {
+        return ftpKeyPwd;
+    }
+
+    public void setFtpKeyPwd(String ftpKeyPwd) {
+        this.ftpKeyPwd = ftpKeyPwd;
+    }
+
+    public String getFtpCharset() {
+        return ftpCharset;
+    }
+
+    public void setFtpCharset(String ftpCharset) {
+        this.ftpCharset = ftpCharset;
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/models/SignCheckResponse.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/models/SignCheckResponse.java
new file mode 100644
index 0000000..6ad724b
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/models/SignCheckResponse.java
@@ -0,0 +1,39 @@
+package cc.winboll.studio.libappbase.models;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/22 20:37
+ */
+// ==================== JSON响应模型（与后端返回字段完全匹配）====================
+public class SignCheckResponse {
+    private int code;                // 根节点code（后端返回）
+    private String msg;              // 根节点提示信息（后端返回，替换原message）
+    private DataBean data;           // 根节点data对象（后端返回）
+
+    // 内部DataBean：对应后端返回的data字段内容
+    public static class DataBean {
+        private boolean valid;       // 实际是否合法的标识（后端data.valid）
+        private String signature;    // 加密后的签名
+        private String decryptedSign;// 解密后的原始签名
+        private long validTime;      // 时间戳
+    }
+
+    // Getter/Setter（关键：获取data中的valid字段）
+    public boolean isValid() {
+        return data != null && data.valid; // 从data中获取valid值
+    }
+
+    public String getMessage() {
+        return msg; // 对应后端根节点的msg字段
+    }
+
+    // 其他必要的Getter/Setter（用于后续扩展）
+    public int getCode() {
+        return code;
+    }
+
+    public DataBean getData() {
+        return data;
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APKFileUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APKFileUtils.java
new file mode 100644
index 0000000..ae8dcda
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APKFileUtils.java
@@ -0,0 +1,306 @@
+package cc.winboll.studio.libappbase.utils;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+import java.util.Base64;
+import java.util.jar.JarEntry;
+import java.util.jar.JarFile;
+
+/**
+ * APK文件工具类（单例）- 生产级签名+哈希双校验版（修复Too short异常）
+ * 1. 稳定解析CERT.RSA原始字节，与客户端Signature.toByteArray()1:1对齐，解决X509解析异常
+ * 2. 支持SHA256文件哈希字节级唯一校验，签名+哈希双重验证
+ * 3. 入参包含：项目名/版本名/APK名/客户端签名/客户端哈希，适配生产级版本管理
+ * 4. APK路径规范：apks_root/项目名/debug/tag/APK文件（支持调试/正式环境）
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ */
+public class APKFileUtils {
+    // 单例实例
+    private static volatile APKFileUtils sInstance;
+    // 配置项
+    private static final String CONFIG_SECTION = "APP";
+    private static final String KEY_APKS_FOLDER = "apks_folder_path";
+    // 算法常量（与客户端严格对齐）
+    private static final String SIGN_ALGORITHM = "SHA1";    // 签名摘要算法
+    private static final String HASH_ALGORITHM = "SHA-256"; // 文件哈希算法
+    // 签名文件（兼容大小写，适配所有打包工具）
+    private static final String CERT_RSA_UPPER = "META-INF/CERT.RSA";
+    private static final String CERT_RSA_LOWER = "META-INF/cert.rsa";
+    // APK根目录
+    private String apksRootPath;
+
+    private APKFileUtils() {}
+
+    /**
+     * 初始化工具类（需在应用启动时调用）
+     */
+    public static void init() {
+        if (sInstance == null) {
+            synchronized (APKFileUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new APKFileUtils();
+                    //sInstance.loadConfig();
+                }
+            }
+        }
+    }
+
+    /**
+     * 获取单例实例
+     */
+    public static APKFileUtils getInstance() {
+        if (sInstance == null) {
+            LogUtils.e("APKFileUtils", "请先调用init()初始化工具类");
+            throw new IllegalStateException("APKFileUtils未初始化，请先调用init()");
+        }
+        return sInstance;
+    }
+
+    /**
+     * 加载配置文件中的APK根目录
+     */
+//    private void loadConfig() {
+//        try {
+//            apksRootPath = IniConfigUtils.getConfigValue(CONFIG_SECTION, KEY_APKS_FOLDER, "").trim();
+//            if (apksRootPath.isEmpty()) {
+//                LogUtils.e("APKFileUtils", "配置项apks_folder_path为空，初始化失败");
+//                return;
+//            }
+//            File rootDir = new File(apksRootPath);
+//            if (!rootDir.exists() && !rootDir.mkdirs()) {
+//                LogUtils.e("APKFileUtils", "APK根目录创建失败：" + apksRootPath);
+//                apksRootPath = "";
+//                return;
+//            }
+//            LogUtils.i("APKFileUtils", "APK根目录加载成功：" + apksRootPath);
+//        } catch (Exception e) {
+//            LogUtils.e("APKFileUtils", "加载APK根目录配置失败", e);
+//            apksRootPath = "";
+//        }
+//    }
+
+    /**
+     * 对外暴露核心校验方法：签名 + SHA256文件哈希 双校验
+     * 入参包含：项目名/版本名/APK文件名/客户端签名Base64/客户端文件哈希
+     * APK路径规范：apksRootPath/项目名/版本名/APK文件
+     * @param projectName 项目名（非空）
+     * @param versionName 版本名（非空，如15.11.11）
+     * @param apkFileName APK文件名（非空，需以.apk结尾）
+     * @param clientSignBase64 客户端传入的签名Base64（非空）
+     * @param clientFileHash 客户端传入的APK文件SHA256哈希（小写/大写均可，非空）
+     * @return 校验通过返回true，否则false
+     */
+    public static boolean checkAPK(String projectName, String versionName, String apkFileName,
+                                   String clientSignBase64, String clientFileHash) {
+        return getInstance().doCheckAPK(projectName, versionName, apkFileName, clientSignBase64, clientFileHash);
+    }
+
+    /**
+     * 核心校验实现：严格按「哈希先验，签名后验」顺序，哈希不匹配直接返回
+     */
+    private boolean doCheckAPK(String projectName, String versionName, String apkFileName,
+                               String clientSignBase64, String clientFileHash) {
+        // 1. 基础入参非空校验
+        if (isParamEmpty(projectName) || isParamEmpty(versionName) || isParamEmpty(apkFileName)
+            || isParamEmpty(clientSignBase64) || isParamEmpty(clientFileHash)) {
+            LogUtils.w("APKFileUtils", "基础参数不能为空：projectName/versionName/apkFileName/clientSignBase64/clientFileHash");
+            return false;
+        }
+        // 2. APK文件名格式校验
+        if (!apkFileName.endsWith(".apk")) {
+            LogUtils.w("APKFileUtils", "APK文件名格式错误，需以.apk结尾：" + apkFileName);
+            return false;
+        }
+        // 3. APK根目录校验
+        if (isParamEmpty(apksRootPath)) {
+            LogUtils.w("APKFileUtils", "APK根目录未配置，无法进行校验");
+            return false;
+        }
+        // 4. 拼接标准APK路径：根目录/项目名/debug/项目名_版本名.apk（调试环境，可切换tag）
+        String apkFullPath = String.format("%s/%s/debug/%s_%s.apk",
+                                           apksRootPath,
+                                           projectName,
+                                           projectName,
+                                           versionName);
+        //正式环境路径（注释保留，切换时解开即可）
+//        String apkFullPath = String.format("%s/%s/tag/%s_%s.apk",
+//                                           apksRootPath,
+//                                           projectName,
+//                                           projectName,
+//                                           versionName);
+        LogUtils.d("APKFileUtils", String.format("apkFullPath : %s", apkFullPath));
+        File apkFile = new File(apkFullPath);
+        // 5. APK文件存在性校验
+        if (!apkFile.exists() || !apkFile.isFile()) {
+            LogUtils.w("APKFileUtils", "APK文件不存在或非文件类型：" + apkFullPath);
+            return false;
+        }
+
+        try {
+            // ===== 第一步：SHA256文件哈希校验（字节级唯一，优先级最高）=====
+            String serverFileHash = getAPKFileHash(apkFile);
+            if (isParamEmpty(serverFileHash)) {
+                LogUtils.w("APKFileUtils", "解析服务端APK文件哈希失败：" + apkFileName);
+                return false;
+            }
+            boolean isHashMatch = serverFileHash.equalsIgnoreCase(clientFileHash.trim());
+            LogUtils.d("APKFileUtils", "【哈希对比】服务端SHA256：" + serverFileHash);
+            LogUtils.d("APKFileUtils", "【哈希对比】客户端SHA256：" + clientFileHash.trim());
+            if (!isHashMatch) {
+                LogUtils.i("APKFileUtils", "【哈希对比结果】❌ 不匹配（字节级文件不一致）");
+                return false;
+            }
+            LogUtils.i("APKFileUtils", "【哈希对比结果】✅ 匹配（字节级文件完全一致）");
+
+            // ===== 第二步：签名校验（直接读取CERT.RSA原始字节，与客户端严格对齐）=====
+            String serverSignBase64 = getAPKSign(apkFile);
+            if (isParamEmpty(serverSignBase64)) {
+                LogUtils.w("APKFileUtils", "解析服务端APK签名失败：" + apkFileName);
+                return false;
+            }
+            boolean isSignMatch = serverSignBase64.equals(clientSignBase64.trim());
+            LogUtils.d("APKFileUtils", "【签名对比】服务端Base64：" + serverSignBase64);
+            LogUtils.d("APKFileUtils", "【签名对比】客户端Base64：" + clientSignBase64.trim());
+            if (!isSignMatch) {
+                LogUtils.i("APKFileUtils", "【签名对比结果】❌ 不匹配（签名不一致）");
+                return false;
+            }
+            LogUtils.i("APKFileUtils", "【签名对比结果】✅ 匹配（签名完全一致）");
+
+            // 所有校验通过
+            LogUtils.i("APKFileUtils", "APK双校验全部通过：项目名=" + projectName + "，版本名=" + versionName + "，文件名=" + apkFileName);
+            return true;
+        } catch (Exception e) {
+            LogUtils.e("APKFileUtils", "APK双校验异常", e);
+            return false;
+        }
+    }
+
+    /**
+     * 稳定解析APK签名：直接读取CERT.RSA原始字节，SHA1+Base64（与客户端1:1对齐）
+     * 解决X509证书解析的Too short异常，兼容所有APK（普通/加固/自定义打包）
+     * @param apkFile APK文件
+     * @return 签名Base64字符串，失败返回null
+     */
+    private String getAPKSign(File apkFile) {
+        JarFile jarFile = null;
+        InputStream certIs = null;
+        try {
+            jarFile = new JarFile(apkFile);
+            // 先找大写CERT.RSA，找不到再找小写，兼容所有打包工具
+            JarEntry certEntry = jarFile.getJarEntry(CERT_RSA_UPPER);
+            if (certEntry == null) {
+                certEntry = jarFile.getJarEntry(CERT_RSA_LOWER);
+                if (certEntry == null) {
+                    LogUtils.w("APKFileUtils", "APK中未找到签名文件：META-INF/CERT.RSA/cert.rsa");
+                    return null;
+                }
+            }
+            // 核心：直接读取CERT.RSA的原始字节流（不做证书解析，适配PKCS7签名块）
+            certIs = jarFile.getInputStream(certEntry);
+            byte[] sigRawBytes = readStreamToBytes(certIs);
+            if (sigRawBytes == null || sigRawBytes.length == 0) {
+                LogUtils.w("APKFileUtils", "读取CERT.RSA原始字节为空");
+                return null;
+            }
+            // 与客户端完全一致的处理流程：SHA1摘要 → Base64编码（去换行）
+            MessageDigest md = MessageDigest.getInstance(SIGN_ALGORITHM);
+            byte[] signDigest = md.digest(sigRawBytes);
+            String signBase64 = Base64.getEncoder().encodeToString(signDigest)
+				.replaceAll("\\r", "").replaceAll("\\n", "");
+
+            LogUtils.d("APKFileUtils", "APK签名解析成功(Base64)：" + signBase64);
+            return signBase64;
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e("APKFileUtils", "解析签名失败：" + SIGN_ALGORITHM + "算法不存在", e);
+            return null;
+        } catch (Exception e) {
+            LogUtils.e("APKFileUtils", "解析APK签名异常", e);
+            return null;
+        } finally {
+            // 强制关闭流资源，避免内存泄漏
+            try {
+                if (certIs != null) certIs.close();
+                if (jarFile != null) jarFile.close();
+            } catch (IOException e) {
+                LogUtils.e("APKFileUtils", "关闭签名文件流失败", e);
+            }
+        }
+    }
+
+    /**
+     * 解析APK文件的SHA256哈希（字节级唯一，任何字节修改都会改变）
+     * @param apkFile APK文件
+     * @return 小写64位SHA256哈希字符串，失败返回null
+     */
+    private String getAPKFileHash(File apkFile) {
+        FileInputStream fis = null;
+        try {
+            MessageDigest md = MessageDigest.getInstance(HASH_ALGORITHM);
+            fis = new FileInputStream(apkFile);
+            byte[] buffer = new byte[8192]; // 8K缓冲区，提升大APK读取效率
+            int len;
+            while ((len = fis.read(buffer)) != -1) {
+                md.update(buffer, 0, len);
+            }
+            // 哈希字节转小写16进制字符串（64位，官方标准格式）
+            byte[] hashBytes = md.digest();
+            StringBuilder sb = new StringBuilder();
+            for (byte b : hashBytes) {
+                sb.append(String.format("%02x", b));
+            }
+            String fileHash = sb.toString();
+            LogUtils.d("APKFileUtils", "APK文件SHA256哈希解析成功：" + fileHash);
+            return fileHash;
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e("APKFileUtils", "获取文件哈希失败：" + HASH_ALGORITHM + "算法不存在", e);
+            return null;
+        } catch (Exception e) {
+            LogUtils.e("APKFileUtils", "解析APK文件哈希异常", e);
+            return null;
+        } finally {
+            if (fis != null) {
+                try {
+                    fis.close();
+                } catch (IOException e) {
+                    LogUtils.e("APKFileUtils", "关闭APK文件流失败", e);
+                }
+            }
+        }
+    }
+
+    /**
+     * 流转字节数组工具方法：稳定读取任意输入流，无截断/空指针问题
+     */
+    private byte[] readStreamToBytes(InputStream is) throws IOException {
+        if (is == null) {
+            LogUtils.w("APKFileUtils", "readStreamToBytes: 输入流为null");
+            return new byte[0];
+        }
+        ByteArrayOutputStream bos = new ByteArrayOutputStream();
+        byte[] buffer = new byte[4096];
+        int len;
+        while ((len = is.read(buffer)) != -1) {
+            bos.write(buffer, 0, len);
+        }
+        byte[] result = bos.toByteArray();
+        // 按顺序关闭流
+        is.close();
+        bos.close();
+        return result;
+    }
+
+    /**
+     * 工具方法：判断参数是否为空（null/空字符串/全空格）
+     */
+    private boolean isParamEmpty(String param) {
+        return param == null || param.trim().isEmpty();
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APPUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APPUtils.java
new file mode 100644
index 0000000..b815497
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/APPUtils.java
@@ -0,0 +1,199 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.Base64;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.SignCheckResponse;
+
+import com.google.gson.Gson;
+
+import java.io.IOException;
+import java.net.URLEncoder;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-20 19:17:00
+ * @LastEditTime 2026-01-24 17:58:00
+ * @Describe APPUtils 应用合法性校验工具类（OKHTTP网络校验版，兼容Java7）
+ * 对外传入签名/哈希值，拼接调试标识后发起网络校验，主线程返回校验结果
+ */
+public class APPUtils {
+    // ===================================== 全局常量/单例属性 =====================================
+    public static final String TAG = "APPUtils";
+    // 网络校验接口基础地址
+    private static final String CHECK_API_URI = "api/app-signatures-check";
+    // OKHTTP客户端单例（复用连接，避免资源浪费）
+    private static final OkHttpClient sOkHttpClient = new OkHttpClient();
+    // Gson解析单例（全局复用，提高解析效率）
+    private static final Gson sGson = new Gson();
+
+    // ===================================== 对外核心校验方法 =====================================
+    /**
+     * 检查应用合法性（外部传入签名+哈希，拼接调试标识发起网络校验）
+     * @param context      上下文，用于主线程回调
+     * @param projectName  项目名称（服务端区分项目标识）
+     * @param versionName  应用版本名（服务端版本校验）
+     * @param clientSign   外部计算的应用签名字符串（Base64）
+     * @param clientHash   外部计算的APK SHA256哈希字符串（小写16进制）
+     * @param callback     校验结果回调（主线程调用，返回是否合法+提示信息）
+     */
+    public void checkAPKValidation(Context context, String appName, String versionName,
+                                   String clientSign, String clientHash, final CheckResultCallback callback) {
+        // 方法调用+全量入参调试日志
+        LogUtils.d(TAG, "checkAPKValidation: 方法调用，入参-> appName=" + appName
+				   + ", versionName=" + versionName + ", clientSign=" + clientSign + ", clientHash=" + clientHash);
+
+        // 1. 核心入参空值校验（快速失败）
+        if (context == null) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参context为空，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "上下文对象不能为空");
+            return;
+        }
+        if (isStringEmpty(appName)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参projectName为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "项目名称不能为空");
+            return;
+        }
+        if (isStringEmpty(versionName)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参versionName为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "应用版本名不能为空");
+            return;
+        }
+        if (isStringEmpty(clientSign)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参clientSign为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "应用签名字符串不能为空");
+            return;
+        }
+        if (isStringEmpty(clientHash)) {
+            LogUtils.w(TAG, "checkAPKValidation: 入参clientHash为空/空白，直接返回校验失败");
+            callCallbackOnMainThread(callback, false, "APK SHA256哈希字符串不能为空");
+            return;
+        }
+        LogUtils.d(TAG, "checkAPKValidation: 入参校验通过，开始处理网络请求");
+
+        // 2. 动态参数URL编码（避免特殊字符导致请求解析异常）
+        LogUtils.d(TAG, "checkAPKValidation: 开始对动态参数进行UTF-8 URL编码");
+        String encodeProjectName = urlEncode(appName);
+        String encodeVersionName = urlEncode(versionName);
+        String encodeClientSign = urlEncode(clientSign);
+        String encodeClientHash = urlEncode(clientHash);
+        String isDebug = String.valueOf(GlobalApplication.isDebugging());
+        LogUtils.d(TAG, "checkAPKValidation: 参数编码完成，debug标识=" + isDebug);
+
+        // 3. 构建完整网络校验请求URL
+        String requestUrl = String.format("%s?isDebug=%s&projectName=%s&versionName=%s&clientSign=%s&clientHash=%s",
+										  GlobalApplication.getWinbollHost() + CHECK_API_URI,
+										  isDebug,
+										  encodeProjectName,
+										  encodeVersionName,
+										  encodeClientSign,
+										  encodeClientHash);
+        LogUtils.d(TAG, "checkAPKValidation: 构建网络校验请求URL=" + requestUrl);
+
+        // 4. 发起OKHTTP异步GET请求（避免阻塞主线程）
+        LogUtils.d(TAG, "checkAPKValidation: 发起异步网络校验请求");
+        Request request = new Request.Builder().url(requestUrl).build();
+        sOkHttpClient.newCall(request).enqueue(new Callback() {
+				@Override
+				public void onFailure(Call call, IOException e) {
+					String errorMsg = "网络校验请求失败：" + e.getMessage();
+					LogUtils.e(TAG, "checkAPKValidation: " + errorMsg, e);
+					callCallbackOnMainThread(callback, false, errorMsg);
+				}
+
+				@Override
+				public void onResponse(Call call, Response response) throws IOException {
+					if (response.isSuccessful() && response.body() != null) {
+						// 响应成功，解析返回JSON
+						String responseJson = response.body().string();
+						LogUtils.d(TAG, "checkAPKValidation: 网络校验响应成功，JSON=" + responseJson);
+						SignCheckResponse checkResponse = sGson.fromJson(responseJson, SignCheckResponse.class);
+						boolean isValid = checkResponse != null && checkResponse.isValid();
+						String msg = checkResponse != null ? checkResponse.getMessage() : "服务端响应解析失败";
+						LogUtils.d(TAG, "checkAPKValidation: 校验结果解析完成，isValid=" + isValid + ", 提示信息=" + msg);
+						callCallbackOnMainThread(callback, isValid, msg);
+					} else {
+						// 响应失败，返回状态码信息
+						String errorMsg = "网络校验响应失败，服务端状态码=" + response.code();
+						LogUtils.e(TAG, "checkAPKValidation: " + errorMsg);
+						callCallbackOnMainThread(callback, false, errorMsg);
+					}
+				}
+			});
+    }
+
+    // ===================================== 内部工具方法 =====================================
+    /**
+     * 字符串空值/空白校验工具
+     * @param str 待校验字符串
+     * @return true=空/空白，false=非空
+     */
+    private boolean isStringEmpty(String str) {
+        return str == null || str.trim().isEmpty();
+    }
+
+    /**
+     * URL编码工具（Java7适配，UTF-8编码，处理特殊字符）
+     * @param content 待编码内容
+     * @return 编码后的字符串，编码失败返回原内容
+     */
+    private String urlEncode(String content) {
+        try {
+            return URLEncoder.encode(content, "UTF-8");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "urlEncode: 字符串编码失败，content=" + content, e);
+            return content;
+        }
+    }
+
+    /**
+     * 主线程执行回调（统一处理，避免外部线程切换）
+     * @param callback 回调接口
+     * @param isValid  是否合法
+     * @param message   提示信息
+     */
+    private void callCallbackOnMainThread(final CheckResultCallback callback,
+                                          final boolean isValid, final String message) {
+        if (callback == null) {
+            LogUtils.w(TAG, "callCallbackOnMainThread: 回调接口为null，无需执行");
+            return;
+        }
+        // 已在主线程直接执行，否则切换主线程
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            callback.onResult(isValid, message);
+        } else {
+            new Handler(Looper.getMainLooper()).post(new Runnable() {
+					@Override
+					public void run() {
+						callback.onResult(isValid, message);
+					}
+				});
+        }
+    }
+
+    // ===================================== 校验结果回调接口 =====================================
+    /**
+     * 应用合法性校验结果回调接口（主线程调用）
+     */
+    public interface CheckResultCallback {
+        /**
+         * 校验结果回调方法
+         * @param isValid 是否合法（true=校验通过，false=校验失败）
+         * @param message 校验提示信息（失败时返回错误原因，成功时返回服务端提示）
+         */
+        void onResult(boolean isValid, String message);
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/ApkSignUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/ApkSignUtils.java
new file mode 100644
index 0000000..b86aa9e
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/ApkSignUtils.java
@@ -0,0 +1,272 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.Signature;
+import android.util.Base64;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+import java.util.Enumeration;
+import java.util.jar.JarEntry;
+import java.util.jar.JarFile;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-24 10:00:00
+ * @LastEditTime 2026-01-24 22:00:00
+ * @Describe 客户端签名工具类：与服务端APKFileUtils签名/哈希校验逻辑严格对齐，纯Java7实现；兼容MT重签名（遍历META-INF所有RSA文件），增加PackageManager兜底方案
+ */
+public class ApkSignUtils {
+    // ===================================== 全局常量定义 =====================================
+    private static final String TAG = "ApkSignUtils";
+    // 加密算法常量
+    private static final String ALGORITHM_SHA1 = "SHA1";
+    private static final String ALGORITHM_SHA256 = "SHA-256";
+    // 缓冲区大小常量（按业务场景区分）
+    private static final int BUFFER_4K = 4096;
+    private static final int BUFFER_8K = 8192;
+    // 签名文件目录与后缀
+    private static final String META_INF_DIR = "META-INF/";
+    private static final String RSA_SUFFIX_UPPER = ".RSA";
+    private static final String RSA_SUFFIX_LOWER = ".rsa";
+
+    // ===================================== 对外核心方法 =====================================
+    /**
+     * 获取与服务端对齐的签名Base64串（兼容MT重签名）
+     * 优先逻辑：遍历APK内META-INF所有.RSA文件 → 读取第一个有效文件原始字节 → SHA1摘要 → Base64.NO_WRAP
+     * 兜底逻辑：PackageManager获取系统解析的签名 → SHA1摘要 → Base64.NO_WRAP
+     * @param context 上下文，用于获取当前应用APK路径/包信息
+     * @return 签名Base64字符串，任意步骤失败返回null
+     */
+    public static String getApkSignAlignedWithServer(Context context) {
+        LogUtils.d(TAG, "getApkSignAlignedWithServer: 方法调用，开始执行服务端对齐签名计算（兼容MT重签名）");
+        // 入参空值快速校验
+        if (context == null) {
+            LogUtils.w(TAG, "getApkSignAlignedWithServer: 入参context为null，直接返回null");
+            return null;
+        }
+
+        // 方案1：优先读取APK内META-INF目录下所有RSA文件（兼容MT重签名任意命名）
+        String signBase64 = getSignFromApkRsaFile(context);
+        if (signBase64 != null) {
+            LogUtils.d(TAG, "getApkSignAlignedWithServer: 方案1成功（APK内读取RSA文件），返回签名Base64");
+            return signBase64;
+        }
+
+        // 方案2：兜底 - PackageManager获取系统解析的应用签名（避免APK文件读取失败）
+        signBase64 = getSignFromPackageManager(context);
+        if (signBase64 != null) {
+            LogUtils.d(TAG, "getApkSignAlignedWithServer: 方案2成功（PackageManager兜底），返回签名Base64");
+            return signBase64;
+        }
+
+        // 所有方案失败
+        LogUtils.e(TAG, "getApkSignAlignedWithServer: 所有签名获取方案均失败");
+        return null;
+    }
+
+    /**
+     * 获取当前运行APK的SHA256哈希值（兼容重签名APK）
+     * 逻辑：读取APK完整文件字节流 → SHA256摘要 → 转小写64位16进制字符串，服务端同款校验逻辑
+     * @param context 上下文，用于获取当前应用APK的真实安装路径
+     * @return SHA256小写16进制字符串，任意步骤失败返回null
+     */
+    public static String getApkSHA256Hash(Context context) {
+        LogUtils.d(TAG, "getApkSHA256Hash: 方法调用，开始执行APK文件SHA256哈希计算");
+        // 入参空值快速校验
+        if (context == null) {
+            LogUtils.w(TAG, "getApkSHA256Hash: 入参context为null，直接返回null");
+            return null;
+        }
+
+        JarFile jarFile = null;
+        FileInputStream fis = null;
+        try {
+            // 1. 获取当前应用APK真实路径
+            ApplicationInfo appInfo = context.getApplicationContext().getApplicationInfo();
+            String apkPath = appInfo.sourceDir;
+            LogUtils.d(TAG, "getApkSHA256Hash: 成功获取APK路径，path=" + apkPath);
+            if (apkPath == null || apkPath.trim().isEmpty()) {
+                LogUtils.e(TAG, "getApkSHA256Hash: 获取到的APK路径为空，无法读取文件计算哈希");
+                return null;
+            }
+
+            // 2. 读取APK文件并计算SHA256哈希（完善流关闭）
+            File apkFile = new File(apkPath);
+            MessageDigest md = MessageDigest.getInstance(ALGORITHM_SHA256);
+            fis = new FileInputStream(apkFile);
+            byte[] buffer = new byte[BUFFER_8K];
+            int readLen;
+            while ((readLen = fis.read(buffer)) != -1) {
+                md.update(buffer, 0, readLen);
+            }
+            LogUtils.d(TAG, "getApkSHA256Hash: APK文件读取完成，开始转换哈希结果");
+
+            // 3. 哈希字节数组转小写64位16进制字符串
+            byte[] hashBytes = md.digest();
+            StringBuilder sb = new StringBuilder();
+            for (byte b : hashBytes) {
+                sb.append(String.format("%02x", b));
+            }
+            String sha256Hash = sb.toString();
+            LogUtils.d(TAG, "getApkSHA256Hash: APK SHA256哈希计算完成，成功返回结果");
+            return sha256Hash;
+
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "getApkSHA256Hash: 获取SHA-256算法实例失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getApkSHA256Hash: 计算APK SHA256哈希发生未知异常", e);
+        } finally {
+            // 强制关闭流，避免重签名APK解析的流泄漏
+            try {
+                if (fis != null) fis.close();
+                if (jarFile != null) jarFile.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "getApkSHA256Hash: 关闭流资源异常", e);
+            }
+        }
+        return null;
+    }
+
+    // ===================================== 内部核心工具方法（兼容重签名） =====================================
+    /**
+     * 方案1：遍历APK内META-INF所有.RSA/.rsa文件，读取第一个有效文件计算签名
+     * @param context 上下文
+     * @return 签名Base64，失败返回null
+     */
+    private static String getSignFromApkRsaFile(Context context) {
+        JarFile jarFile = null;
+        InputStream is = null;
+        try {
+            // 获取APK路径
+            ApplicationInfo appInfo = context.getApplicationContext().getApplicationInfo();
+            String apkPath = appInfo.sourceDir;
+            if (apkPath == null || apkPath.trim().isEmpty()) {
+                LogUtils.w(TAG, "getSignFromApkRsaFile: APK路径为空，跳过该方案");
+                return null;
+            }
+
+            // 打开APK的JarFile
+            jarFile = new JarFile(apkPath);
+            Enumeration<JarEntry> entries = jarFile.entries();
+            JarEntry targetRsaEntry = null;
+
+            // 遍历所有条目，找到META-INF下第一个.RSA/.rsa文件
+            while (entries.hasMoreElements()) {
+                JarEntry entry = entries.nextElement();
+                String entryName = entry.getName();
+                // 过滤：META-INF目录下 + 以.RSA/.rsa结尾 + 非目录
+                if (entryName.startsWith(META_INF_DIR) && !entry.isDirectory()
+					&& (entryName.endsWith(RSA_SUFFIX_UPPER) || entryName.endsWith(RSA_SUFFIX_LOWER))) {
+                    targetRsaEntry = entry;
+                    LogUtils.d(TAG, "getSignFromApkRsaFile: 找到有效签名文件，name=" + entryName);
+                    break; // 取第一个有效RSA文件即可
+                }
+            }
+
+            // 未找到任何RSA文件
+            if (targetRsaEntry == null) {
+                LogUtils.w(TAG, "getSignFromApkRsaFile: 未在META-INF找到任何.RSA/.rsa签名文件");
+                return null;
+            }
+
+            // 读取RSA文件原始字节
+            is = jarFile.getInputStream(targetRsaEntry);
+            byte[] certRawBytes = readStreamToBytes(is);
+            if (certRawBytes == null || certRawBytes.length == 0) {
+                LogUtils.w(TAG, "getSignFromApkRsaFile: 读取RSA文件字节为空");
+                return null;
+            }
+
+            // 计算SHA1+Base64
+            MessageDigest md = MessageDigest.getInstance(ALGORITHM_SHA1);
+            byte[] signDigest = md.digest(certRawBytes);
+            return Base64.encodeToString(signDigest, Base64.NO_WRAP);
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getSignFromApkRsaFile: 从APK内读取RSA文件失败", e);
+            return null;
+        } finally {
+            // 强制关闭所有流
+            try {
+                if (is != null) is.close();
+                if (jarFile != null) jarFile.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "getSignFromApkRsaFile: 关闭流资源异常", e);
+            }
+        }
+    }
+
+    /**
+     * 方案2：兜底 - 通过PackageManager获取系统解析的应用签名
+     * 避免APK文件读取失败（如权限、解析问题），兼容所有重签名场景
+     * @param context 上下文
+     * @return 签名Base64，失败返回null
+     */
+    private static String getSignFromPackageManager(Context context) {
+        try {
+            // 获取当前应用包信息（包含签名）
+            PackageInfo packageInfo = context.getPackageManager()
+				.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);
+            if (packageInfo == null || packageInfo.signatures == null || packageInfo.signatures.length == 0) {
+                LogUtils.w(TAG, "getSignFromPackageManager: 未获取到应用签名信息");
+                return null;
+            }
+
+            // 取第一个签名（重签名后一般只有一个签名）
+            Signature signature = packageInfo.signatures[0];
+            byte[] signBytes = signature.toByteArray();
+
+            // 计算SHA1+Base64，与服务端逻辑对齐
+            MessageDigest md = MessageDigest.getInstance(ALGORITHM_SHA1);
+            byte[] signDigest = md.digest(signBytes);
+            return Base64.encodeToString(signDigest, Base64.NO_WRAP);
+
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "getSignFromPackageManager: 包名未找到，无法获取签名", e);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "getSignFromPackageManager: 获取SHA1算法实例失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getSignFromPackageManager: PackageManager获取签名失败", e);
+        }
+        return null;
+    }
+
+    /**
+     * 输入流转字节数组，通用工具方法（完善try-finally）
+     * 4K缓冲区，适配小文件读取（如RSA签名文件），保证流资源正常关闭
+     * @param is 待读取的输入流
+     * @return 转换后的字节数组，流为null/读取失败返回空字节数组
+     * @throws IOException 流读取相关异常向上抛出
+     */
+    private static byte[] readStreamToBytes(InputStream is) throws IOException {
+        if (is == null) {
+            LogUtils.w(TAG, "readStreamToBytes: 入参输入流为null，返回空字节数组");
+            return new byte[0];
+        }
+        ByteArrayOutputStream bos = new ByteArrayOutputStream();
+        byte[] buffer = new byte[BUFFER_4K];
+        int readLen;
+        try {
+            while ((readLen = is.read(buffer)) != -1) {
+                bos.write(buffer, 0, readLen);
+            }
+            return bos.toByteArray();
+        } finally {
+            // 强制关闭所有流
+            is.close();
+            bos.close();
+        }
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/BackupUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/BackupUtils.java
new file mode 100644
index 0000000..dcbe80a
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/BackupUtils.java
@@ -0,0 +1,305 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.os.Environment;
+import android.text.TextUtils;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.zip.ZipEntry;
+import java.util.zip.ZipOutputStream;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.SFTPAuthModel;
+
+/**
+ * 文件备份工具类（单例模式）
+ * 区分应用Data目录/应用专属外部文件目录双Map管理备份文件路径
+ * 核心功能：文件添加/移除 + ZIP打包（分data/sdcard目录） + SFTP分步式上传（登录→传输→登出）
+ * 依赖：FTPUtils（单例）、SFTPAuthModel（外部实体类）、Android上下文
+ * 兼容：Java7、Android 6.0+，无第三方依赖（ZIP为原生实现），免动态读写权限
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/30 20:18:00
+ * @LastEditTime 2026/02/01 02:05:00
+ */
+public class BackupUtils {
+    public static final String TAG = "BackupUtils";
+    // ZIP内部分级目录常量（统一维护，便于修改）
+    private static final String ZIP_DIR_DATA = "data/";
+    private static final String ZIP_DIR_SDCARD = "sdcard/";
+
+    // 单例实例（双重校验锁，volatile保证可见性，线程安全）
+    private static volatile BackupUtils sInstance;
+
+    // 双Map分目录管理：key=文件唯一标识，value=对应目录下的相对路径
+    private final Map<String, String> mDataDirFileMap; // 基础根目录：应用私有Data目录(/data/data/[包名]/files)
+    private final Map<String, String> mSdcardFileMap; // 基础根目录：应用专属外部文件目录(/storage/emulated/0/Android/data/[包名]/files)
+
+    // 全局上下文（持有Application上下文，避免Activity内存泄漏）
+    private Context mAppContext;
+    // SFTP认证配置（直接引用外部实体类，无内部封装）
+    private SFTPAuthModel mFtpAuthModel;
+    // SFTP服务器指定上传目录（独立参数传入，标准化后作为成员变量）
+    private String mFtpTargetDir;
+    // 应用专属外部文件目录（SDCard Map的基础根目录，初始化时赋值，避免重复创建）
+    private File mAppExternalFilesDir;
+
+    // 私有构造器：新增双Map入参，空值则使用内部默认初始化，非空则用入参初始化
+    private BackupUtils(Context context, SFTPAuthModel ftpAuthModel, String ftpTargetDir,
+                        Map<String, String> dataDirFileMap, Map<String, String> sdcardFileMap) {
+        this.mAppContext = context.getApplicationContext();
+        this.mFtpAuthModel = ftpAuthModel;
+        // 初始化SDCard Map的基础根目录：应用专属外部文件目录（/storage/emulated/0/Android/data/[包名]/files）
+        this.mAppExternalFilesDir = mAppContext.getExternalFilesDir(null);
+        // 标准化SFTP上传目录：空则默认/，非空则补全结尾斜杠
+        this.mFtpTargetDir = TextUtils.isEmpty(ftpTargetDir) ? "/" : (ftpTargetDir.endsWith("/") ? ftpTargetDir : ftpTargetDir + "/");
+
+        // 核心修改：入参Map非空且非空集合时，使用入参初始化；否则内部new HashMap()
+        this.mDataDirFileMap = (dataDirFileMap != null && !dataDirFileMap.isEmpty()) 
+			? new HashMap<String, String>(dataDirFileMap)
+			: new HashMap<String, String>();
+        this.mSdcardFileMap = (sdcardFileMap != null && !sdcardFileMap.isEmpty())
+			? new HashMap<String, String>(sdcardFileMap)
+			: new HashMap<String, String>();
+
+        LogUtils.d(TAG, "BackupUtils初始化完成 → SFTP服务器：" + ftpAuthModel.getFtpServer() + ":" + ftpAuthModel.getFtpPort() + " | 上传目录：" + mFtpTargetDir);
+        LogUtils.d(TAG, "SDCard Map基础根目录：" + (mAppExternalFilesDir == null ? "获取失败" : mAppExternalFilesDir.getAbsolutePath()));
+        LogUtils.d(TAG, "初始化后DataMap大小：" + mDataDirFileMap.size() + " | SdcardMap大小：" + mSdcardFileMap.size());
+    }
+
+    /**
+     * 单例初始化方法（必须先调用，否则getInstance()会抛异常）
+     * 新增双Map入参，支持外部初始化待备份文件列表
+     * @param context 上下文（推荐传Application，避免内存泄漏）
+     * @param ftpAuthModel 外部SFTP认证实体类（含服务器/账号/端口等）
+     * @param ftpTargetDir SFTP服务器指定上传目录（如/backup，自动补全斜杠）
+     * @param dataDirFileMap 外部传入的Data目录文件Map，null/空则内部默认初始化
+     * @param sdcardFileMap 外部传入的SDCard目录文件Map，null/空则内部默认初始化
+     * @return BackupUtils单例实例
+     */
+    public static BackupUtils getInstance(Context context, SFTPAuthModel ftpAuthModel, String ftpTargetDir,
+                                          Map<String, String> dataDirFileMap, Map<String, String> sdcardFileMap) {
+        if (sInstance == null) {
+            synchronized (BackupUtils.class) {
+                if (sInstance == null) {
+                    // 前置强校验：避免空参数导致后续空指针
+                    if (context == null) {
+                        throw new IllegalArgumentException("初始化失败：Context 不能为空");
+                    }
+                    if (ftpAuthModel == null || TextUtils.isEmpty(ftpAuthModel.getFtpServer())) {
+                        throw new IllegalArgumentException("初始化失败：SFTPAuthModel/ftpServer 不能为空");
+                    }
+                    // 透传新增的双Map入参至构造器
+                    sInstance = new BackupUtils(context, ftpAuthModel, ftpTargetDir, dataDirFileMap, sdcardFileMap);
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    /**
+     * 重载默认初始化方法：兼容原有调用逻辑，无需传入Map，内部默认初始化
+     * 避免修改后影响原有代码调用
+     */
+    public static BackupUtils getInstance(Context context, SFTPAuthModel ftpAuthModel, String ftpTargetDir) {
+        return getInstance(context, ftpAuthModel, ftpTargetDir, null, null);
+    }
+
+    /**
+     * 获取单例实例（需先调用带参getInstance初始化）
+     * @return BackupUtils单例实例
+     */
+    public static BackupUtils getInstance() {
+        if (sInstance == null) {
+            throw new IllegalStateException("BackupUtils未初始化，请先调用getInstance(Context, SFTPAuthModel, String[, Map, Map])");
+        }
+        return sInstance;
+    }
+
+    // ====================================== 以下原有方法均未修改 ======================================
+    public void addDataDirFile(String key, String relativePath) {
+        if (!TextUtils.isEmpty(key) && !TextUtils.isEmpty(relativePath)) {
+            mDataDirFileMap.put(key, relativePath);
+            LogUtils.d(TAG, "添加Data目录文件：" + key + " → " + relativePath);
+        }
+    }
+
+    public void removeDataDirFile(String key) {
+        if (!TextUtils.isEmpty(key) && mDataDirFileMap.containsKey(key)) {
+            mDataDirFileMap.remove(key);
+            LogUtils.d(TAG, "移除Data目录文件：" + key);
+        }
+    }
+
+    public String getDataDirFile(String key) {
+        return mDataDirFileMap.get(key);
+    }
+
+    public Map<String, String> getAllDataDirFiles() {
+        return new HashMap<>(mDataDirFileMap);
+    }
+
+    public void clearDataDirFiles() {
+        mDataDirFileMap.clear();
+        LogUtils.d(TAG, "清空Data目录所有备份文件");
+    }
+
+    public void addSdcardFile(String key, String relativePath) {
+        if (!TextUtils.isEmpty(key) && !TextUtils.isEmpty(relativePath) && mAppExternalFilesDir != null) {
+            mSdcardFileMap.put(key, relativePath);
+            LogUtils.d(TAG, "添加外部文件目录文件：" + key + " → " + relativePath);
+        }
+    }
+
+    public void removeSdcardFile(String key) {
+        if (!TextUtils.isEmpty(key) && mSdcardFileMap.containsKey(key)) {
+            mSdcardFileMap.remove(key);
+            LogUtils.d(TAG, "移除外部文件目录文件：" + key);
+        }
+    }
+
+    public String getSdcardFile(String key) {
+        return mSdcardFileMap.get(key);
+    }
+
+    public Map<String, String> getAllSdcardFiles() {
+        return new HashMap<>(mSdcardFileMap);
+    }
+
+    public void clearSdcardFiles() {
+        mSdcardFileMap.clear();
+        LogUtils.d(TAG, "清空外部文件目录所有备份文件");
+    }
+
+    public boolean packAndUploadByFtp() {
+        if (mDataDirFileMap.isEmpty() && mSdcardFileMap.isEmpty()) {
+            LogUtils.e(TAG, "SFTP上传失败：无待备份文件（DataDir+外部文件目录均为空）");
+            return false;
+        }
+        if (mAppExternalFilesDir == null) {
+            LogUtils.e(TAG, "SFTP上传失败：应用专属外部文件目录获取失败，无法访问文件");
+            return false;
+        }
+
+        String zipFileName = UUID.randomUUID().toString().replace("-", "")
+			+ "-" + System.currentTimeMillis() + ".zip";
+        File tempZipFile = new File(mAppContext.getExternalCacheDir(), zipFileName);
+        String remoteFtpFilePath = mFtpTargetDir + zipFileName;
+
+        FTPUtils ftpUtils = FTPUtils.getInstance();
+        boolean isUploadSuccess = false;
+
+        try {
+            LogUtils.d(TAG, "开始SFTP登录：" + mFtpAuthModel.getFtpServer() + ":" + mFtpAuthModel.getFtpPort());
+            boolean isFtpLogin = ftpUtils.login(mFtpAuthModel);
+            if (!isFtpLogin) {
+                LogUtils.e(TAG, "SFTP上传失败：SFTP登录失败（账号/密码/服务器/端口错误）");
+                return false;
+            }
+            LogUtils.i(TAG, "SFTP登录成功，准备打包文件：" + zipFileName);
+
+            LogUtils.d(TAG, "开始本地ZIP打包（分data/sdcard目录），临时文件路径：" + tempZipFile.getAbsolutePath());
+            boolean isPackSuccess = packFilesToZip(tempZipFile);
+            if (!isPackSuccess || !tempZipFile.exists() || tempZipFile.length() == 0) {
+                LogUtils.e(TAG, "SFTP上传失败：ZIP打包失败（文件不存在/空文件）");
+                return false;
+            }
+            LogUtils.i(TAG, "ZIP打包成功，文件大小：" + tempZipFile.length() / 1024 + "KB");
+
+            LogUtils.d(TAG, "开始SFTP上传：本地→SFTP" + remoteFtpFilePath);
+            isUploadSuccess = ftpUtils.uploadFile(tempZipFile.getAbsolutePath(), remoteFtpFilePath);
+            if (isUploadSuccess) {
+                LogUtils.i(TAG, "SFTP上传全流程成功：" + remoteFtpFilePath);
+            } else {
+                LogUtils.e(TAG, "SFTP上传失败：文件传输到服务器失败（响应码异常/权限不足）");
+            }
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "SFTP上传异常：" + e.getMessage(), e);
+            isUploadSuccess = false;
+        } finally {
+            if (ftpUtils.isConnected()) {
+                ftpUtils.logout();
+            }
+            ftpUtils.disconnect();
+            if (tempZipFile.exists()) {
+                boolean isDelete = tempZipFile.delete();
+                LogUtils.d(TAG, "本地临时ZIP文件删除：" + (isDelete ? "成功" : "失败"));
+            }
+            System.gc();
+        }
+
+        return isUploadSuccess;
+    }
+
+    private boolean packFilesToZip(File zipFile) {
+        ZipOutputStream zos = null;
+        try {
+            zos = new ZipOutputStream(new FileOutputStream(zipFile), Charset.forName("UTF-8"));
+            zos.setLevel(ZipOutputStream.DEFLATED);
+
+            if (!mDataDirFileMap.isEmpty()) {
+                packDirFilesToZip(zos, mDataDirFileMap, mAppContext.getFilesDir(), ZIP_DIR_DATA);
+                LogUtils.d(TAG, "Data目录文件已打包到ZIP→" + ZIP_DIR_DATA + "子目录");
+            }
+            if (!mSdcardFileMap.isEmpty() && mAppExternalFilesDir != null) {
+                packDirFilesToZip(zos, mSdcardFileMap, mAppExternalFilesDir, ZIP_DIR_SDCARD);
+                LogUtils.d(TAG, "应用专属外部文件目录文件已打包到ZIP→" + ZIP_DIR_SDCARD + "子目录");
+            }
+
+            zos.flush();
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "ZIP打包IO异常：" + e.getMessage(), e);
+            return false;
+        } finally {
+            if (zos != null) {
+                try {
+                    zos.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "关闭ZIP流异常：" + e.getMessage(), e);
+                }
+            }
+        }
+    }
+
+    private void packDirFilesToZip(ZipOutputStream zos, Map<String, String> fileMap, File baseDir, String zipSubDir) {
+        for (Map.Entry<String, String> entry : fileMap.entrySet()) {
+            String relativePath = entry.getValue();
+            if (TextUtils.isEmpty(relativePath)) {
+                continue;
+            }
+            File localFile = new File(baseDir, relativePath);
+            if (!localFile.exists() || !localFile.isFile()) {
+                LogUtils.w(TAG, "跳过无效文件：" + localFile.getAbsolutePath());
+                continue;
+            }
+            String zipInnerPath = zipSubDir + relativePath;
+            try {
+                addSingleFileToZip(zos, localFile, zipInnerPath);
+            } catch (IOException e) {
+                LogUtils.e(TAG, "打包单个文件失败：" + zipInnerPath, e);
+            }
+        }
+    }
+
+    private void addSingleFileToZip(ZipOutputStream zos, File localFile, String zipInnerPath) throws IOException {
+        ZipEntry zipEntry = new ZipEntry(zipInnerPath);
+        zos.putNextEntry(zipEntry);
+        FileInputStream fis = new FileInputStream(localFile);
+        byte[] buffer = new byte[4096];
+        int len;
+        while ((len = fis.read(buffer)) != -1) {
+            zos.write(buffer, 0, len);
+        }
+        fis.close();
+        zos.closeEntry();
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/CrashHandleNotifyUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/CrashHandleNotifyUtils.java
new file mode 100644
index 0000000..06f9d73
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/CrashHandleNotifyUtils.java
@@ -0,0 +1,443 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.app.Notification;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.text.TextUtils;
+
+import cc.winboll.studio.libappbase.CrashHandler;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.InputStreamReader;
+
+/**
+ * 应用崩溃处理通知实用工具集（类库兼容版）
+ * 核心功能：作为独立类库使用，发送崩溃通知，点击跳转宿主应用的 GlobalCrashActivity 并传递日志
+ * 适配说明：移除固定包名依赖，通过外部传入宿主包名，支持任意应用集成使用
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025/11/29 21:12:00
+ * @EditTime 2026/05/11 21:55:00
+ */
+public class CrashHandleNotifyUtils {
+
+    // ====================== 常量定义 ======================
+    public static final String TAG = "CrashHandleNotifyUtils";
+    /** 通知渠道ID（Android 8.0+ 必须） */
+    private static final String CRASH_NOTIFY_CHANNEL_ID = "crash_notify_channel";
+    /** 通知渠道名称（用户可见） */
+    private static final String CRASH_NOTIFY_CHANNEL_NAME = "应用崩溃通知";
+    /** 通知ID（唯一） */
+    public static final int CRASH_NOTIFY_ID = 0x001;
+    /** Android 12 对应 API 版本号（31） */
+    private static final int API_LEVEL_ANDROID_12 = 31;
+    /** PendingIntent.FLAG_IMMUTABLE 常量值（API 31+） */
+    private static final int FLAG_IMMUTABLE = 0x00000040;
+    /** 通知摘要最大长度 */
+    private static final int SUMMARY_MAX_LENGTH = 200;
+    /** 分享日志请求码 */
+    private static final int REQUEST_CODE_SHARE_LOG = 0x002;
+    /** 缓存崩溃日志子目录 */
+    private static final String CRASH_LOG_CACHE_SUBDIR = "crashnotify";
+    /** 缓存崩溃日志文件名 */
+    private static final String CRASH_LOG_CACHE_FILENAME = "crash_log.txt";
+
+    // ====================== 静态成员 ======================
+    private static String sHostPackageName = "";
+    private static String sCrashLogCacheFilePath = "";
+
+    // ====================== 正则表达式定义 ======================
+    private static final String REGEX_EXCEPTION_TYPE = "([\\w.]+Exception|[\\w.]+Error)";
+    private static final String REGEX_EXCEPTION_MESSAGE = "(?<=:\\s)(.+?)(?=\\n|\\r|$)";
+    private static final String REGEX_STACK_TRACE = "\\s+at\\s+([\\w.$]+)\\.([\\w<>]+)\\(([^:]+\\.java):(\\d+)\\)";
+    private static final String REGEX_CAUSE = "(?<=Caused by:\\s)" + REGEX_EXCEPTION_TYPE + "\\s*:";
+
+    // ====================== 对外核心方法 ======================
+    /**
+     * 处理未捕获异常（类库入口核心方法）
+     * @param hostApp 宿主Application实例
+     * @param hostPackageName 宿主应用包名
+     * @param errorLog 崩溃日志内容
+     * @param reportCrashActivity 崩溃详情跳转Activity类
+     */
+    public static void handleUncaughtException(final android.app.Application hostApp,
+                                               final String hostPackageName,
+                                               final String errorLog,
+                                               final Class<?> reportCrashActivity) {
+        LogUtils.d(TAG, "handleUncaughtException 进入方法");
+        if (hostApp == null || TextUtils.isEmpty(hostPackageName) || TextUtils.isEmpty(errorLog)) {
+            LogUtils.e(TAG, "handleUncaughtException 参数为空校验不通过");
+            return;
+        }
+        sHostPackageName = hostPackageName;
+        final String hostAppName = getHostAppName(hostApp, hostPackageName);
+        final String crashLogFilePath = saveCrashLogToCache(hostApp, errorLog);
+        if (TextUtils.isEmpty(crashLogFilePath)) {
+            LogUtils.e(TAG, "保存崩溃日志到缓存文件失败");
+            return;
+        }
+        sCrashLogCacheFilePath = crashLogFilePath;
+        final Intent shareIntent = new Intent(hostApp, ShareLogActivity.class);
+        shareIntent.putExtra(ShareLogActivity.EXTRA_CRASH_LOG_FILEPATH, crashLogFilePath);
+        shareIntent.putExtra(ShareLogActivity.EXTRA_CRASH_LOG_SUBJECT, "崩溃日志");
+        shareIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        final PendingIntent sharePendingIntent = createSharePendingIntent(hostApp, shareIntent);
+        sendCrashNotification(hostApp, hostPackageName, hostAppName, errorLog, reportCrashActivity, sharePendingIntent);
+    }
+
+    /**
+     * 重载兼容方法：适配原有CrashHandler调用方式
+     * @param hostApp 宿主Application实例
+     * @param intent 携带崩溃信息Intent
+     * @param reportCrashActivity 崩溃详情Activity
+     */
+    public static void handleUncaughtException(final android.app.Application hostApp,
+                                               final Intent intent,
+                                               final Class<?> reportCrashActivity) {
+        LogUtils.d(TAG, "handleUncaughtException 重载方法进入");
+        String hostPackageName = intent.getStringExtra("EXTRA_HOST_PACKAGE_NAME");
+        if (TextUtils.isEmpty(hostPackageName)) {
+            hostPackageName = hostApp.getPackageName();
+            LogUtils.w(TAG, "未携带宿主包名，默认使用应用自身包名");
+        }
+        final String errorLog = intent.getStringExtra(CrashHandler.EXTRA_CRASH_LOG);
+        handleUncaughtException(hostApp, hostPackageName, errorLog, reportCrashActivity);
+    }
+
+    /**
+     * 资源释放
+     * @param hostContext 宿主上下文
+     */
+    public static void release(final Context hostContext) {
+        LogUtils.d(TAG, "release 执行资源释放");
+        sHostPackageName = "";
+        sCrashLogCacheFilePath = "";
+    }
+
+    // ====================== 内部工具方法 ======================
+    /**
+     * 获取宿主应用名称
+     * @param hostContext 宿主上下文
+     * @param hostPackageName 宿主包名
+     * @return 应用名称，失败返回未知应用
+     */
+    private static String getHostAppName(final Context hostContext, final String hostPackageName) {
+        try {
+            return hostContext.getPackageManager()
+                .getApplicationLabel(hostContext.getPackageManager()
+                                     .getApplicationInfo(hostPackageName, 0)).toString();
+        } catch (Exception e) {
+            LogUtils.e(TAG, "获取宿主应用名称失败", e);
+            return "未知应用";
+        }
+    }
+
+    /**
+     * 保存崩溃日志到缓存文件
+     * @param hostContext 宿主上下文
+     * @param crashLog 崩溃日志内容
+     * @return 缓存文件路径，失败返回空字符串
+     */
+    private static String saveCrashLogToCache(final Context hostContext, final String crashLog) {
+        if (hostContext == null || TextUtils.isEmpty(crashLog)) {
+            return "";
+        }
+        BufferedReader reader = null;
+        FileOutputStream fos = null;
+        try {
+            final File cacheDir = new File(hostContext.getCacheDir(), CRASH_LOG_CACHE_SUBDIR);
+            if (!cacheDir.exists()) {
+                cacheDir.mkdirs();
+            }
+            final File cacheFile = new File(cacheDir, CRASH_LOG_CACHE_FILENAME);
+            if (cacheFile.exists()) {
+                cacheFile.delete();
+            }
+            cacheFile.createNewFile();
+            fos = new FileOutputStream(cacheFile);
+            fos.write(crashLog.getBytes("UTF-8"));
+            fos.flush();
+            LogUtils.d(TAG, "saveCrashLogToCache 保存崩溃日志到缓存: " + cacheFile.getAbsolutePath());
+            return cacheFile.getAbsolutePath();
+        } catch (Exception e) {
+            LogUtils.e(TAG, "saveCrashLogToCache 异常", e);
+            return "";
+        } finally {
+            if (reader != null) {
+                try { reader.close(); } catch (Exception e) {}
+            }
+            if (fos != null) {
+                try { fos.close(); } catch (Exception e) {}
+            }
+        }
+    }
+
+    /**
+     * 读取缓存的崩溃日志文件内容
+     * @param hostContext 宿主上下文
+     * @return 日志内容，失败返回空字符串
+     */
+    private static String readCachedCrashLog(final Context hostContext) {
+        if (hostContext == null || TextUtils.isEmpty(sCrashLogCacheFilePath)) {
+            return "";
+        }
+        BufferedReader reader = null;
+        try {
+            final File cacheFile = new File(sCrashLogCacheFilePath);
+            if (!cacheFile.exists()) {
+                LogUtils.w(TAG, "readCachedCrashLog 缓存文件不存在");
+                return "";
+            }
+            reader = new BufferedReader(new InputStreamReader(new FileInputStream(cacheFile), "UTF-8"));
+            final StringBuilder sb = new StringBuilder();
+            String line;
+            while ((line = reader.readLine()) != null) {
+                sb.append(line).append("\n");
+            }
+            return sb.toString();
+        } catch (Exception e) {
+            LogUtils.e(TAG, "readCachedCrashLog 异常", e);
+            return "";
+        } finally {
+            if (reader != null) {
+                try { reader.close(); } catch (Exception e) {}
+            }
+        }
+    }
+
+    /**
+     * 发送崩溃系统通知
+     * @param hostContext 宿主上下文
+     * @param hostPackageName 宿主包名
+     * @param hostAppName 宿主应用名
+     * @param errorLog 崩溃日志
+     * @param reportCrashActivity 跳转Activity
+     * @param sharePendingIntent 分享日志PendingIntent
+     */
+    private static void sendCrashNotification(final Context hostContext,
+                                              final String hostPackageName,
+                                              final String hostAppName,
+                                              final String errorLog,
+                                              final Class<?> reportCrashActivity,
+                                              final PendingIntent sharePendingIntent) {
+        final NotificationManager notificationManager =
+            (NotificationManager) hostContext.getSystemService(Context.NOTIFICATION_SERVICE);
+        if (notificationManager == null) {
+            LogUtils.e(TAG, "获取NotificationManager失败");
+            return;
+        }
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            createCrashNotifyChannel(hostContext, notificationManager);
+        }
+        final PendingIntent jumpIntent = getGlobalCrashPendingIntent(hostContext,
+                                                                     hostPackageName, errorLog, reportCrashActivity);
+        if (jumpIntent == null) {
+            LogUtils.e(TAG, "构建跳转PendingIntent失败");
+            return;
+        }
+        final Notification notification = buildNotification(hostContext, hostPackageName, hostAppName, errorLog, jumpIntent, sharePendingIntent);
+        notificationManager.notify(CRASH_NOTIFY_ID, notification);
+        LogUtils.d(TAG, "崩溃通知发送成功，宿主包名：" + hostPackageName);
+    }
+
+    /**
+     * 创建分享日志PendingIntent
+     * @param hostContext 宿主上下文
+     * @param shareIntent 分享意图
+     * @return PendingIntent实例
+     */
+    private static PendingIntent createSharePendingIntent(final Context hostContext, final Intent shareIntent) {
+        int flags = PendingIntent.FLAG_UPDATE_CURRENT;
+        if (Build.VERSION.SDK_INT >= API_LEVEL_ANDROID_12) {
+            flags |= FLAG_IMMUTABLE;
+        }
+        return PendingIntent.getActivity(
+            hostContext,
+            REQUEST_CODE_SHARE_LOG,
+            shareIntent,
+            flags
+        );
+    }
+
+    /**
+     * 创建通知渠道（适配Android O及以上）
+     * @param hostContext 宿主上下文
+     * @param notificationManager 通知管理器
+     */
+    private static void createCrashNotifyChannel(final Context hostContext,
+                                                 final NotificationManager notificationManager) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            android.app.NotificationChannel channel = new android.app.NotificationChannel(
+                CRASH_NOTIFY_CHANNEL_ID,
+                CRASH_NOTIFY_CHANNEL_NAME,
+                NotificationManager.IMPORTANCE_DEFAULT
+            );
+            channel.setDescription("应用崩溃通知（由 WinBoLL Studio 类库提供，点击查看详情）");
+            notificationManager.createNotificationChannel(channel);
+            LogUtils.d(TAG, "通知渠道创建完成");
+        }
+    }
+
+    /**
+     * 构建跳转崩溃详情页PendingIntent
+     * @param hostContext 宿主上下文
+     * @param hostPackageName 宿主包名
+     * @param errorLog 崩溃日志
+     * @param reportCrashActivity 目标Activity
+     * @return PendingIntent实例
+     */
+    private static PendingIntent getGlobalCrashPendingIntent(final Context hostContext,
+                                                             final String hostPackageName,
+                                                             final String errorLog,
+                                                             final Class<?> reportCrashActivity) {
+        try {
+            final Intent crashIntent = new Intent(hostContext, reportCrashActivity);
+            crashIntent.setPackage(hostPackageName);
+            crashIntent.putExtra(CrashHandler.EXTRA_CRASH_LOG, errorLog);
+            crashIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+            int flags = PendingIntent.FLAG_UPDATE_CURRENT;
+            if (Build.VERSION.SDK_INT >= API_LEVEL_ANDROID_12) {
+                flags |= FLAG_IMMUTABLE;
+            }
+            return PendingIntent.getActivity(
+                hostContext,
+                CRASH_NOTIFY_ID,
+                crashIntent,
+                flags
+            );
+        } catch (Exception e) {
+            LogUtils.e(TAG, "构建跳转Intent异常", e);
+            return null;
+        }
+    }
+
+    /**
+     * 构建Notification通知实例
+     * @param hostContext 宿主上下文
+     * @param hostPackageName 宿主包名
+     * @param hostAppName 宿主应用名
+     * @param errorLog 崩溃日志
+     * @param jumpIntent 点击跳转意图
+     * @param shareIntent 分享日志意图
+     * @return 构建好的Notification
+     */
+    @SuppressWarnings("deprecation")
+    private static Notification buildNotification(final Context hostContext,
+                                                 final String hostPackageName,
+                                                 final String hostAppName,
+                                                 final String errorLog,
+                                                 final PendingIntent jumpIntent,
+                                                 final PendingIntent shareIntent) {
+        Notification.Builder builder = new Notification.Builder(hostContext);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            builder.setChannelId(CRASH_NOTIFY_CHANNEL_ID);
+        }
+        final String briefInfo = extractBriefInfo(errorLog);
+        final Notification.BigTextStyle bigTextStyle = new Notification.BigTextStyle();
+        bigTextStyle.setBigContentTitle(hostAppName + " 崩溃");
+        bigTextStyle.bigText(briefInfo);
+        bigTextStyle.setSummaryText("点击查看详情");
+        builder.setStyle(bigTextStyle);
+        builder.setSmallIcon(hostContext.getApplicationInfo().icon)
+            .setContentTitle(hostAppName + " 崩溃")
+            .setContentText(briefInfo.split("\n")[0])
+            .setContentIntent(jumpIntent)
+            .setAutoCancel(true)
+            .setWhen(System.currentTimeMillis())
+            .setPriority(Notification.PRIORITY_DEFAULT);
+        if (shareIntent != null) {
+            builder.addAction(android.R.drawable.ic_menu_send, "分享日志", shareIntent);
+        }
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+            return builder.build();
+        } else {
+            return builder.getNotification();
+        }
+    }
+
+    /**
+     * 截取缩略日志文本
+     * @param content 原始日志
+     * @return 缩略文案
+     */
+    private static String getShortContent(final String errorLog) {
+        if (errorLog == null || errorLog.isEmpty()) {
+            return "无崩溃日志";
+        }
+        final String brief = extractBriefInfo(errorLog);
+        final String firstLine = brief.split("\n")[0];
+        if (firstLine.length() > 80) {
+            return firstLine.substring(0, 80) + "...";
+        }
+        return firstLine;
+    }
+
+    /**
+     * 使用正则表达式从崩溃日志中提取简要信息
+     * @param crashLog 完整崩溃日志
+     * @return 简要崩溃信息
+     */
+    private static String extractBriefInfo(final String crashLog) {
+        if (crashLog == null || crashLog.isEmpty()) {
+            return "无崩溃日志";
+        }
+        final StringBuilder brief = new StringBuilder();
+        try {
+            java.util.regex.Pattern exceptionPattern = java.util.regex.Pattern.compile(REGEX_EXCEPTION_TYPE);
+            java.util.regex.Matcher exceptionMatcher = exceptionPattern.matcher(crashLog);
+            if (exceptionMatcher.find()) {
+                brief.append(exceptionMatcher.group(1));
+            }
+            java.util.regex.Pattern messagePattern = java.util.regex.Pattern.compile(REGEX_EXCEPTION_MESSAGE);
+            java.util.regex.Matcher messageMatcher = messagePattern.matcher(crashLog);
+            if (messageMatcher.find()) {
+                String message = messageMatcher.group(1).trim();
+                if (message.length() > 100) {
+                    message = message.substring(0, 100) + "...";
+                }
+                if (brief.length() > 0) {
+                    brief.append(" - ");
+                }
+                brief.append(message);
+            }
+            java.util.regex.Pattern causePattern = java.util.regex.Pattern.compile(REGEX_CAUSE);
+            java.util.regex.Matcher causeMatcher = causePattern.matcher(crashLog);
+            if (causeMatcher.find()) {
+                if (brief.length() > 0) {
+                    brief.append("\n");
+                }
+                brief.append("原因: ").append(causeMatcher.group(1));
+            }
+            java.util.regex.Pattern stackPattern = java.util.regex.Pattern.compile(REGEX_STACK_TRACE);
+            java.util.regex.Matcher stackMatcher = stackPattern.matcher(crashLog);
+            int lineCount = 0;
+            while (stackMatcher.find() && lineCount < 3) {
+                if (brief.length() > 0) {
+                    brief.append("\n");
+                }
+                brief.append("  at ").append(stackMatcher.group(1)).append(".")
+                     .append(stackMatcher.group(2)).append("(")
+                     .append(stackMatcher.group(3)).append(":")
+                     .append(stackMatcher.group(4)).append(")");
+                lineCount++;
+            }
+            if (brief.length() == 0) {
+                brief.append(crashLog.length() > SUMMARY_MAX_LENGTH ? crashLog.substring(0, SUMMARY_MAX_LENGTH) + "..." : crashLog);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "提取崩溃简要信息失败", e);
+            brief.setLength(0);
+            brief.append(crashLog.length() > SUMMARY_MAX_LENGTH ? crashLog.substring(0, SUMMARY_MAX_LENGTH) + "..." : crashLog);
+        }
+        return brief.toString();
+    }
+}
\ No newline at end of file
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/FTPUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/FTPUtils.java
new file mode 100644
index 0000000..7e1ea28
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/FTPUtils.java
@@ -0,0 +1,487 @@
+package cc.winboll.studio.libappbase.utils;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.SFTPAuthModel;
+import com.jcraft.jsch.ChannelSftp;
+import com.jcraft.jsch.JSch;
+import com.jcraft.jsch.JSchException;
+import com.jcraft.jsch.Session;
+import com.jcraft.jsch.SftpATTRS;
+import com.jcraft.jsch.SftpException;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.util.Properties;
+import java.util.Vector;
+
+/**
+ * SFTP/FTP工具类（单例模式）- Java7兼容 · 适配FTPAuthModel实体类
+ * 底层严格基于JSch 0.1.54原生ChannelSftp+SftpException接口实现，替换原commons-net FTP
+ * 核心功能：登录/登出、文件上传/下载、文件夹列举、文件/文件夹存在性判断
+ * 依赖：com.jcraft:jsch:0.1.54
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/30 19:04
+ */
+public class FTPUtils {
+    // 单例实例（双重校验锁 volatile 保证可见性，Java7兼容）
+    private static volatile FTPUtils sInstance;
+    // JSch核心对象：Session（连接会话）、ChannelSftp（SFTP通道）
+    private JSch mJSch;
+    private Session mSession;
+    private ChannelSftp mSftpChannel;
+    // 日志TAG
+    public static final String TAG = "FTPUtils";
+    // SFTP默认端口（FTPAuthModel未设置时使用）
+    private static final int DEFAULT_SFTP_PORT = 22;
+    // 连接超时时间 5s（Java7原生Socket超时）
+    private static final int CONNECT_TIMEOUT = 5000;
+
+    // 私有构造器：禁止外部实例化
+    private FTPUtils() {
+        initSftpClient();
+    }
+
+    /**
+     * 获取单例实例（双重校验锁，线程安全，Java7兼容）
+     * @return FTPUtils 单例
+     */
+    public static FTPUtils getInstance() {
+        if (sInstance == null) {
+            synchronized (FTPUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new FTPUtils();
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    /**
+     * 初始化SFTP客户端（JSch），创建核心原生对象
+     */
+    private void initSftpClient() {
+        if (mJSch == null) {
+            mJSch = new JSch();
+            LogUtils.d(TAG, "SFTP客户端（JSch）初始化完成");
+        }
+        // 重置会话和通道，避免连接残留
+        mSession = null;
+        mSftpChannel = null;
+    }
+
+    /**
+     * 【推荐】SFTP登录（基于FTPAuthModel实体类，完全兼容原有参数）
+     * @param ftpAuthModel 登录配置实体类（不能为空，端口默认22，编码默认UTF-8）
+     * @return 登录成功返回true，失败false
+     */
+    public boolean login(SFTPAuthModel ftpAuthModel) {
+        // 1. 实体类非空校验
+        if (ftpAuthModel == null) {
+            LogUtils.e(TAG, "SFTP登录失败：FTPAuthModel实体类为null");
+            return false;
+        }
+        // 2. 核心参数校验（服务器地址不能为空）
+        if (isParamEmpty(ftpAuthModel.getFtpServer())) {
+            LogUtils.e(TAG, "SFTP登录失败：服务器地址（ftpServer）不能为空");
+            return false;
+        }
+        // 3. 若已连接，先断开
+        if (isConnected()) {
+            logout();
+        }
+        // 4. 重新初始化客户端
+        initSftpClient();
+
+        try {
+            // 获取服务器地址、端口（默认22）、账号、密码
+            String host = ftpAuthModel.getFtpServer();
+            int port = ftpAuthModel.getFtpPort() <= 0 ? DEFAULT_SFTP_PORT : ftpAuthModel.getFtpPort();
+            String username = ftpAuthModel.getFtpUsername();
+            String password = ftpAuthModel.getFtpPassword();
+
+            // SFTP不支持匿名登录，账号密码不能为空（原生接口无匿名登录能力）
+            if (isParamEmpty(username) || isParamEmpty(password)) {
+                LogUtils.e(TAG, "SFTP登录失败：SFTP不支持匿名登录，请配置有效账号密码");
+                return false;
+            }
+
+            // 1. 创建JSch会话（原生接口）
+            mSession = mJSch.getSession(username, host, port);
+            mSession.setPassword(password);
+
+            // 2. 设置会话属性（跳过SSH密钥校验，适配大部分服务器）
+            Properties sessionProps = new Properties();
+            sessionProps.put("StrictHostKeyChecking", "no");
+            sessionProps.put("PreferredAuthentications", "password");
+            mSession.setConfig(sessionProps);
+
+            // 3. 设置会话连接超时（原生接口，底层Socket超时）
+            mSession.setTimeout(CONNECT_TIMEOUT);
+
+            // 4. 建立会话连接（原生接口）
+            mSession.connect();
+            LogUtils.d(TAG, "SFTP会话连接成功：" + host + ":" + port);
+
+            // 5. 打开SFTP通道（类型：sftp，原生接口强转）
+            mSftpChannel = (ChannelSftp) mSession.openChannel("sftp");
+            mSftpChannel.connect();
+
+            // 6. 设置文件名编码（解决中文乱码，ChannelSftp原生接口）
+            String charset = isParamEmpty(ftpAuthModel.getFtpCharset()) ? "UTF-8" : ftpAuthModel.getFtpCharset();
+            mSftpChannel.setFilenameEncoding(charset);
+            LogUtils.d(TAG, "SFTP文件名编码设置成功：" + charset);
+
+            LogUtils.i(TAG, "SFTP登录成功，服务器：" + host + ":" + port + "，用户名：" + username);
+            return true;
+
+        } catch (JSchException e) {
+            LogUtils.e(TAG, "SFTP登录JSch异常：" + e.getMessage(), e);
+            logout();
+            return false;
+        } catch (SftpException e) {
+            // 匹配SftpException原生属性和方法
+            LogUtils.e(TAG, "SFTP通道初始化异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            logout();
+            return false;
+        }
+    }
+
+    /**
+     * 【已废弃】原FTP多参数登录方法，适配JSch后保留，推荐使用login(FTPAuthModel)
+     * @deprecated 请使用基于FTPAuthModel的登录方法
+     */
+    @Deprecated
+    public boolean login(String host, int port, String username, String password) {
+        SFTPAuthModel ftpAuthModel = new SFTPAuthModel();
+        ftpAuthModel.setFtpServer(host);
+        ftpAuthModel.setFtpPort(port <= 0 ? DEFAULT_SFTP_PORT : port);
+        ftpAuthModel.setFtpUsername(username);
+        ftpAuthModel.setFtpPassword(password);
+        return login(ftpAuthModel);
+    }
+
+    /**
+     * SFTP登出并断开连接，释放所有资源（严格调用原生disconnect接口）
+     * @return 登出成功返回true，失败false
+     */
+    public boolean logout() {
+        boolean isSuccess = true;
+        // 关闭SFTP通道（原生接口disconnect，非空判断即可）
+        if (mSftpChannel != null) {
+            try {
+                mSftpChannel.disconnect();
+                LogUtils.d(TAG, "SFTP通道已断开");
+            } catch (Exception e) {
+                LogUtils.e(TAG, "关闭SFTP通道异常：" + e.getMessage(), e);
+                isSuccess = false;
+            }
+        }
+        // 关闭JSch会话（原生接口disconnect，非空判断即可）
+        if (mSession != null) {
+            try {
+                mSession.disconnect();
+                LogUtils.d(TAG, "SFTP会话已断开");
+            } catch (Exception e) {
+                LogUtils.e(TAG, "关闭SFTP会话异常：" + e.getMessage(), e);
+                isSuccess = false;
+            }
+        }
+        // 重置客户端，避免资源残留
+        initSftpClient();
+        if (isSuccess) {
+            LogUtils.i(TAG, "SFTP登出成功");
+        } else {
+            LogUtils.w(TAG, "SFTP登出失败：部分资源未正常释放");
+        }
+        return isSuccess;
+    }
+
+    /**
+     * 强制断开连接（兜底资源释放），同logout方法
+     */
+    public void disconnect() {
+        logout();
+    }
+
+    /**
+     * 判断SFTP是否已连接（会话+通道均调用原生isConnected接口）
+     * @return 已连接返回true，否则false
+     */
+    public boolean isConnected() {
+        return mSession != null && mSession.isConnected()
+			&& mSftpChannel != null && mSftpChannel.isConnected();
+    }
+
+    /**
+     * 上传文件到SFTP指定路径（覆盖式上传，调用ChannelSftp原生put接口，OVERWRITE模式）
+     * @param localFilePath 本地文件绝对路径（如/sdcard/test.apk）
+     * @param remoteFilePath SFTP服务器目标路径（如/ftp/apk/test.apk，需包含文件名）
+     * @return 上传成功返回true，失败false
+     */
+    public boolean uploadFile(String localFilePath, String remoteFilePath) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "文件上传失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(localFilePath) || isParamEmpty(remoteFilePath)) {
+            LogUtils.e(TAG, "文件上传失败：本地/远程路径不能为空");
+            return false;
+        }
+        File localFile = new File(localFilePath);
+        if (!localFile.exists() || !localFile.isFile()) {
+            LogUtils.e(TAG, "文件上传失败：本地文件不存在/非文件，路径：" + localFilePath);
+            return false;
+        }
+
+        InputStream fis = null;
+        try {
+            // 自动创建远程多级目录（基于原生mkdir/stat接口）
+            createRemoteDir(remoteFilePath);
+            // 读取本地文件，上传到SFTP（原生put接口，OVERWRITE覆盖模式）
+            fis = new FileInputStream(localFile);
+            mSftpChannel.put(fis, remoteFilePath, ChannelSftp.OVERWRITE);
+            LogUtils.i(TAG, "文件上传成功：本地" + localFilePath + " → 远程" + remoteFilePath);
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "文件上传IO异常：" + e.getMessage(), e);
+            return false;
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "文件上传SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            return false;
+        } finally {
+            // 关闭流资源，避免内存泄漏
+            closeStream(fis, null);
+        }
+    }
+
+    /**
+     * 从SFTP下载文件到本地指定路径（覆盖式下载，调用ChannelSftp原生get接口）
+     * @param remoteFilePath SFTP服务器文件路径（如/ftp/apk/test.apk）
+     * @param localFilePath 本地目标路径（如/sdcard/test.apk，需包含文件名）
+     * @return 下载成功返回true，失败false
+     */
+    public boolean downloadFile(String remoteFilePath, String localFilePath) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "文件下载失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(remoteFilePath) || isParamEmpty(localFilePath)) {
+            LogUtils.e(TAG, "文件下载失败：远程/本地路径不能为空");
+            return false;
+        }
+        // 校验远程文件是否存在（基于ChannelSftp原生stat接口）
+        if (!isFileExists(remoteFilePath)) {
+            LogUtils.e(TAG, "文件下载失败：远程文件不存在，路径：" + remoteFilePath);
+            return false;
+        }
+
+        OutputStream fos = null;
+        try {
+            // 创建本地多级目录
+            File localFile = new File(localFilePath);
+            File parentDir = localFile.getParentFile();
+            if (!parentDir.exists() && !parentDir.mkdirs()) {
+                LogUtils.e(TAG, "文件下载失败：创建本地目录失败，路径：" + parentDir.getAbsolutePath());
+                return false;
+            }
+            // 从SFTP读取文件，写入本地（原生get接口）
+            fos = new FileOutputStream(localFile);
+            mSftpChannel.get(remoteFilePath, fos);
+            LogUtils.i(TAG, "文件下载成功：远程" + remoteFilePath + " → 本地" + localFilePath);
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "文件下载IO异常：" + e.getMessage(), e);
+            // 删除未下载完成的本地文件
+            new File(localFilePath).delete();
+            return false;
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "文件下载SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            // 删除未下载完成的本地文件
+            new File(localFilePath).delete();
+            return false;
+        } finally {
+            // 关闭流资源，避免内存泄漏
+            closeStream(null, fos);
+        }
+    }
+
+    /**
+     * 列举SFTP指定文件夹下的所有文件/文件夹（返回ChannelSftp原生Vector，过滤.和..）
+     * @param remoteDir SFTP服务器目录路径（如/ftp/apk/，结尾带/或不带均可）
+     * @return 成功返回原生Vector<ChannelSftp.LsEntry>，失败返回空Vector
+     */
+    @SuppressWarnings("rawtypes")
+    public Vector listDir(String remoteDir) {
+        Vector fileList = new Vector();
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "列举目录失败：SFTP未连接服务器");
+            return fileList;
+        }
+        if (isParamEmpty(remoteDir)) {
+            LogUtils.e(TAG, "列举目录失败：远程目录路径不能为空");
+            return fileList;
+        }
+        // 校验目录是否存在（基于ChannelSftp原生stat接口）
+        if (!isDirExists(remoteDir)) {
+            LogUtils.e(TAG, "列举目录失败：远程目录不存在，路径：" + remoteDir);
+            return fileList;
+        }
+
+        try {
+            // 列举目录下所有文件/文件夹（调用ChannelSftp原生ls接口，返回原生Vector）
+            Vector vector = mSftpChannel.ls(remoteDir);
+            if (vector != null && vector.size() > 0) {
+                for (Object obj : vector) {
+                    // 过滤.和..上级目录，仅保留有效文件/目录
+                    ChannelSftp.LsEntry entry = (ChannelSftp.LsEntry) obj;
+                    String fileName = entry.getFilename();
+                    if (!".".equals(fileName) && !"..".equals(fileName)) {
+                        fileList.add(obj);
+                    }
+                }
+            }
+            LogUtils.i(TAG, "列举目录成功：" + remoteDir + "，共" + fileList.size() + "个文件/文件夹");
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "列举目录SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+        }
+        return fileList;
+    }
+
+    /**
+     * 判断SFTP服务器上**文件**是否存在（基于ChannelSftp原生stat接口，匹配SftpException原生异常）
+     * @param remoteFilePath SFTP服务器文件路径（如/ftp/apk/test.apk）
+     * @return 存在且为文件返回true，否则false
+     */
+    public boolean isFileExists(String remoteFilePath) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "判断文件存在性失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(remoteFilePath)) {
+            LogUtils.e(TAG, "判断文件存在性失败：远程文件路径不能为空");
+            return false;
+        }
+
+        try {
+            // 调用ChannelSftp原生stat接口获取属性，不存在会抛出SSH_FX_NO_SUCH_FILE异常
+            SftpATTRS attrs = mSftpChannel.stat(remoteFilePath);
+            // 原生isReg()判断是否为文件
+            return attrs.isReg();
+        } catch (SftpException e) {
+            // 仅匹配原生异常码SSH_FX_NO_SUCH_FILE(2)：文件/目录不存在，不记错误日志
+            if (e.id != ChannelSftp.SSH_FX_NO_SUCH_FILE) {
+                LogUtils.e(TAG, "判断文件存在性SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            }
+            return false;
+        }
+    }
+
+    /**
+     * 判断SFTP服务器上**文件夹**是否存在（基于ChannelSftp原生stat接口，匹配SftpException原生异常）
+     * @param remoteDir SFTP服务器目录路径（如/ftp/apk/，结尾带/或不带均可）
+     * @return 存在且为目录返回true，否则false
+     */
+    public boolean isDirExists(String remoteDir) {
+        // 前置校验
+        if (!isConnected()) {
+            LogUtils.e(TAG, "判断目录存在性失败：SFTP未连接服务器");
+            return false;
+        }
+        if (isParamEmpty(remoteDir)) {
+            LogUtils.e(TAG, "判断目录存在性失败：远程目录路径不能为空");
+            return false;
+        }
+
+        try {
+            // 调用ChannelSftp原生stat接口获取属性，不存在会抛出SSH_FX_NO_SUCH_FILE异常
+            SftpATTRS attrs = mSftpChannel.stat(remoteDir);
+            // 原生isDir()判断是否为目录
+            return attrs.isDir();
+        } catch (SftpException e) {
+            // 仅匹配原生异常码SSH_FX_NO_SUCH_FILE(2)：文件/目录不存在，不记错误日志
+            if (e.id != ChannelSftp.SSH_FX_NO_SUCH_FILE) {
+                LogUtils.e(TAG, "判断目录存在性SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+            }
+            return false;
+        }
+    }
+
+    // ===================================== 内部工具方法（仅调用原生接口） =====================================
+    /**
+     * 递归创建SFTP远程多级目录（基于ChannelSftp原生mkdir/stat接口，不存在则创建）
+     * @param remoteFilePath SFTP远程文件路径/目录路径
+     */
+    private void createRemoteDir(String remoteFilePath) {
+        if (!isConnected()) {
+            LogUtils.e(TAG, "创建远程目录失败：SFTP未连接服务器");
+            return;
+        }
+        try {
+            // 提取目录路径（文件路径→目录路径，目录路径直接使用）
+            String remoteDir = remoteFilePath.lastIndexOf("/") > 0
+				? remoteFilePath.substring(0, remoteFilePath.lastIndexOf("/"))
+				: remoteFilePath;
+            // 按/分割多级目录，递归创建（避免多级目录不存在）
+            String[] dirs = remoteDir.split("/");
+            StringBuilder currentDir = new StringBuilder();
+            for (String dir : dirs) {
+                if (isParamEmpty(dir)) {
+                    continue;
+                }
+                currentDir.append("/").append(dir);
+                String dirPath = currentDir.toString();
+                // 目录不存在则调用ChannelSftp原生mkdir创建
+                if (!isDirExists(dirPath)) {
+                    mSftpChannel.mkdir(dirPath);
+                    LogUtils.d(TAG, "创建SFTP远程目录成功：" + dirPath);
+                }
+            }
+        } catch (SftpException e) {
+            // 严格匹配SftpException原生属性：id、getMessage()、toString()
+            LogUtils.e(TAG, "创建远程目录SFTP异常：id=" + e.id + "，msg=" + e.getMessage() + "，detail=" + e.toString());
+        }
+    }
+
+    /**
+     * 关闭流资源（通用工具方法，Java7原生IO，避免内存泄漏）
+     * @param is 输入流（可为null）
+     * @param os 输出流（可为null）
+     */
+    private void closeStream(InputStream is, OutputStream os) {
+        if (is != null) {
+            try {
+                is.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "关闭输入流异常：" + e.getMessage(), e);
+            }
+        }
+        if (os != null) {
+            try {
+                os.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "关闭输出流异常：" + e.getMessage(), e);
+            }
+        }
+    }
+
+    /**
+     * 判断参数是否为空（null/空字符串/全空格，Java7原生字符串操作）
+     * @param param 待判断参数
+     * @return 为空返回true，否则false
+     */
+    private boolean isParamEmpty(String param) {
+        return param == null || param.trim().isEmpty();
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/NfcRsaAuthTool.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/NfcRsaAuthTool.java
new file mode 100644
index 0000000..655b73f
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/NfcRsaAuthTool.java
@@ -0,0 +1,480 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.nfc.NfcAdapter;
+import android.nfc.Tag;
+import android.nfc.tech.Ndef;
+import android.nfc.tech.NdefFormatable;
+import android.util.Base64;
+import cc.winboll.studio.libappbase.LogUtils;
+
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.security.KeyFactory;
+import java.security.KeyPair;
+import java.security.KeyPairGenerator;
+import java.security.NoSuchAlgorithmException;
+import java.security.PrivateKey;
+import java.security.PublicKey;
+import java.security.spec.PKCS8EncodedKeySpec;
+import java.security.spec.RSAPrivateCrtKeySpec;
+import java.security.spec.RSAPublicKeySpec;
+import java.security.spec.X509EncodedKeySpec;
+import javax.crypto.Cipher;
+
+/**
+ * @Describe NFC RSA认证工具类，单例模式
+ * 核心功能：RSA密钥生成、NFC密钥读写、本地data区密钥存储、密钥有效性校验、内存密钥缓存
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/11 21:00:00
+ * @LastEditTime 2026/01/12 17:46:00
+ */
+public class NfcRsaAuthTool {
+    // 常量配置（集中管理，简洁无冗余）
+    private static final String TAG                  = "NfcRsaAuthTool";
+    private static final String RSA_ALGORITHM        = "RSA";
+    private static final int RSA_KEY_SIZE            = 2048;
+    private static final String NFC_KEY_TAG          = "RSA_AUTH_PRIV_";
+    private static final String CHARSET              = "UTF-8";
+    private static final String LOCAL_KEY_FILE_NAME  = "rsa_auth_private.key";
+    private static final String RSA_TEST_DATA        = "NFC_RSA_AUTH_VALID";
+
+    // 单例实例（线程安全双重校验锁核心）
+    private static volatile NfcRsaAuthTool sInstance;
+
+    // 核心属性（按用途排序，注释清晰）
+    private Context mContext;
+    private NfcAdapter mNfcAdapter;
+    private String mCachePrivateKeyStr;  // 内存缓存Base64私钥字符串
+    private String mCachePublicKeyStr;   // 内存缓存Base64公钥字符串
+
+    // 私有构造器（禁止外部实例化，绑定全局上下文）
+    private NfcRsaAuthTool(Context context) {
+        this.mContext = context.getApplicationContext();
+        this.mNfcAdapter = NfcAdapter.getDefaultAdapter(mContext);
+        LogUtils.d(TAG, "构造初始化完成，已绑定全局上下文");
+    }
+
+    /**
+     * 获取单例实例（线程安全，双重校验锁，适配多线程场景）
+     * @param context 上下文对象
+     * @return 单例工具类实例
+     */
+    public static NfcRsaAuthTool getInstance(Context context) {
+        if (sInstance == null) {
+            synchronized (NfcRsaAuthTool.class) {
+                if (sInstance == null) {
+                    sInstance = new NfcRsaAuthTool(context);
+                    LogUtils.d(TAG, "首次创建单例实例成功");
+                }
+            }
+        }
+        LogUtils.d(TAG, "获取单例实例成功");
+        return sInstance;
+    }
+
+    // ==================== 核心功能1：生成RSA私钥（返回Base64编码字符串，便于存储） ====================
+    public String generateRsaPrivateKey() {
+        LogUtils.d(TAG, "开始生成RSA私钥，密钥长度：" + RSA_KEY_SIZE);
+        try {
+            KeyPairGenerator keyPairGen = KeyPairGenerator.getInstance(RSA_ALGORITHM);
+            keyPairGen.initialize(RSA_KEY_SIZE);
+            KeyPair keyPair = keyPairGen.generateKeyPair();
+            PrivateKey privateKey = keyPair.getPrivate();
+            String privateKeyStr = Base64.encodeToString(privateKey.getEncoded(), Base64.NO_WRAP);
+            LogUtils.d(TAG, "RSA私钥生成成功，已完成Base64编码");
+            return privateKeyStr;
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "RSA私钥生成失败，无对应算法支持", e);
+            return null;
+        }
+    }
+
+    // ==================== 核心功能2：NFC密钥读写（适配NDEF标签，兼容已格式化/未格式化场景） ====================
+    /**
+     * 写入Base64私钥到NFC标签，带专属标识防数据混淆
+     * @param tag NFC标签对象
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 写入成功返回true，失败返回false
+     */
+    public boolean writePrivateKeyToNfc(Tag tag, String privateKeyStr) {
+        LogUtils.d(TAG, "写入NFC私钥，入参校验：Tag=" + tag + "，私钥非空=" + (privateKeyStr != null && !privateKeyStr.isEmpty()));
+        if (tag == null || privateKeyStr == null || privateKeyStr.isEmpty() || mNfcAdapter == null) {
+            LogUtils.w(TAG, "入参无效，写入失败（Tag/NFC适配器为空或私钥为空）");
+            return false;
+        }
+        try {
+            byte[] writeData = (NFC_KEY_TAG + privateKeyStr).getBytes(CHARSET);
+            boolean result = writeNfcData(tag, writeData);
+            LogUtils.d(TAG, "NFC私钥写入结果：" + result);
+            return result;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "NFC私钥写入异常", e);
+            return false;
+        }
+    }
+
+    /**
+     * 从NFC标签读取私钥，自动校验标识并缓存到内存
+     * @param tag NFC标签对象
+     * @return 有效私钥返回Base64字符串，无效返回null
+     */
+    public String readPrivateKeyFromNfc(Tag tag) {
+        LogUtils.d(TAG, "读取NFC私钥，Tag对象：" + tag);
+        if (tag == null || mNfcAdapter == null) {
+            LogUtils.w(TAG, "Tag或NFC适配器为空，读取失败");
+            return null;
+        }
+        try {
+            byte[] nfcData = readNfcData(tag);
+            if (nfcData == null || nfcData.length == 0) {
+                LogUtils.w(TAG, "NFC标签无有效存储数据");
+                return null;
+            }
+            String allDataStr = new String(nfcData, CHARSET);
+            if (!allDataStr.startsWith(NFC_KEY_TAG)) {
+                LogUtils.w(TAG, "NFC数据无专属标识，判定为无效私钥数据");
+                return null;
+            }
+            String privateKeyStr = allDataStr.substring(NFC_KEY_TAG.length());
+            if (!privateKeyStr.isEmpty()) {
+                mCachePrivateKeyStr = privateKeyStr;
+                extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+                LogUtils.d(TAG, "NFC私钥读取成功，已缓存私钥并提取公钥");
+            }
+            return privateKeyStr;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "NFC私钥读取异常", e);
+            return null;
+        }
+    }
+
+    // ==================== 核心功能3：本地data区密钥存储（仅应用可访问，安全存储） ====================
+    /**
+     * 私钥存储到应用内部data区，同步缓存到内存
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 存储成功返回true，失败返回false
+     */
+    public boolean savePrivateKeyToLocal(String privateKeyStr) {
+        LogUtils.d(TAG, "本地存储私钥，私钥非空校验：" + (privateKeyStr != null && !privateKeyStr.isEmpty()));
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "待存储私钥为空，存储失败");
+            return false;
+        }
+        File keyFile = new File(mContext.getFilesDir(), LOCAL_KEY_FILE_NAME);
+        FileOutputStream fos = null;
+        try {
+            fos = new FileOutputStream(keyFile);
+            fos.write(privateKeyStr.getBytes(CHARSET));
+            fos.flush();
+            mCachePrivateKeyStr = privateKeyStr;
+            extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+            LogUtils.d(TAG, "私钥本地存储成功，存储路径：" + keyFile.getAbsolutePath());
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "私钥本地存储失败", e);
+            return false;
+        } finally {
+            if (fos != null) {
+                try {
+                    fos.close();
+                } catch (IOException e) {
+                    LogUtils.w(TAG, "关闭存储输出流异常", e);
+                }
+            }
+        }
+    }
+
+    /**
+     * 从本地data区读取私钥，同步缓存到内存
+     * @return 本地私钥返回Base64字符串，无文件返回null
+     */
+    public String getLocalPrivateKey() {
+        LogUtils.d(TAG, "开始读取本地存储私钥");
+        File keyFile = new File(mContext.getFilesDir(), LOCAL_KEY_FILE_NAME);
+        if (!keyFile.exists()) {
+            LogUtils.w(TAG, "本地私钥文件不存在");
+            return null;
+        }
+        FileInputStream fis = null;
+        ByteArrayOutputStream bos = null;
+        try {
+            fis = new FileInputStream(keyFile);
+            bos = new ByteArrayOutputStream();
+            byte[] buffer = new byte[1024];
+            int len;
+            while ((len = fis.read(buffer)) != -1) {
+                bos.write(buffer, 0, len);
+            }
+            String privateKeyStr = new String(bos.toByteArray(), CHARSET);
+            mCachePrivateKeyStr = privateKeyStr;
+            extractPublicKeyFromPrivateKeyStr(privateKeyStr);
+            LogUtils.d(TAG, "本地私钥读取成功，已同步缓存");
+            return privateKeyStr;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "本地私钥读取失败", e);
+            return null;
+        } finally {
+            try {
+                if (fis != null) fis.close();
+                if (bos != null) bos.close();
+            } catch (IOException e) {
+                LogUtils.w(TAG, "关闭读取流异常", e);
+            }
+        }
+    }
+
+    // ==================== 核心功能4：私钥提取公钥（自动缓存，全局可用） ====================
+    public String extractPublicKeyFromPrivateKeyStr(String privateKeyStr) {
+        LogUtils.d(TAG, "从私钥提取公钥，私钥非空校验：" + (privateKeyStr != null && !privateKeyStr.isEmpty()));
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "待提取私钥为空，提取失败");
+            return null;
+        }
+        try {
+            byte[] priKeyBytes = Base64.decode(privateKeyStr, Base64.NO_WRAP);
+            PKCS8EncodedKeySpec priSpec = new PKCS8EncodedKeySpec(priKeyBytes);
+            KeyFactory keyFactory = KeyFactory.getInstance(RSA_ALGORITHM);
+            PrivateKey privateKey = keyFactory.generatePrivate(priSpec);
+
+            RSAPrivateCrtKeySpec privateCrtSpec = (RSAPrivateCrtKeySpec) keyFactory.getKeySpec(privateKey, RSAPrivateCrtKeySpec.class);
+            RSAPublicKeySpec publicKeySpec = new RSAPublicKeySpec(privateCrtSpec.getModulus(), privateCrtSpec.getPublicExponent());
+            PublicKey publicKey = keyFactory.generatePublic(publicKeySpec);
+
+            String publicKeyStr = Base64.encodeToString(publicKey.getEncoded(), Base64.NO_WRAP);
+            mCachePublicKeyStr = publicKeyStr;
+            LogUtils.d(TAG, "公钥提取成功，已缓存");
+            return publicKeyStr;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "公钥提取失败", e);
+            return null;
+        }
+    }
+
+    // ==================== 核心功能5：密钥有效性校验（私钥自校验，公钥交叉校验） ====================
+    /**
+     * 私钥有效性校验：自加密自解密测试明文
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 有效返回true，无效返回false
+     */
+    public boolean validatePrivateKey(String privateKeyStr) {
+        LogUtils.d(TAG, "开始校验私钥有效性");
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "待校验私钥为空，直接判定无效");
+            return false;
+        }
+        try {
+            byte[] priBytes = Base64.decode(privateKeyStr, Base64.NO_WRAP);
+            PKCS8EncodedKeySpec priSpec = new PKCS8EncodedKeySpec(priBytes);
+            PrivateKey privateKey = KeyFactory.getInstance(RSA_ALGORITHM).generatePrivate(priSpec);
+
+            Cipher cipher = Cipher.getInstance(RSA_ALGORITHM);
+            cipher.init(Cipher.ENCRYPT_MODE, privateKey);
+            byte[] encryptData = cipher.doFinal(RSA_TEST_DATA.getBytes(CHARSET));
+            cipher.init(Cipher.DECRYPT_MODE, privateKey);
+            byte[] decryptData = cipher.doFinal(encryptData);
+
+            boolean valid = RSA_TEST_DATA.equals(new String(decryptData, CHARSET));
+            LogUtils.d(TAG, "私钥有效性校验结果：" + valid);
+            return valid;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "私钥校验异常，判定无效", e);
+            return false;
+        }
+    }
+
+    /**
+     * 公钥有效性校验：私钥加密+公钥解密测试明文
+     * @param privateKeyStr 基准Base64私钥字符串
+     * @param publicKeyStr  待校验Base64公钥字符串
+     * @return 有效返回true，无效返回false
+     */
+    public boolean validatePublicKey(String privateKeyStr, String publicKeyStr) {
+        LogUtils.d(TAG, "开始校验公钥有效性，私钥非空=" + (privateKeyStr != null && !privateKeyStr.isEmpty()) + "，公钥非空=" + (publicKeyStr != null && !publicKeyStr.isEmpty()));
+        if (privateKeyStr == null || publicKeyStr == null || privateKeyStr.isEmpty() || publicKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "私钥或公钥为空，直接判定无效");
+            return false;
+        }
+        try {
+            PrivateKey privateKey = getPrivateKeyFromStr(privateKeyStr);
+            PublicKey publicKey = getPublicKeyFromStr(publicKeyStr);
+            if (privateKey == null || publicKey == null) {
+                LogUtils.w(TAG, "私钥或公钥转对象失败，判定无效");
+                return false;
+            }
+
+            Cipher cipher = Cipher.getInstance(RSA_ALGORITHM);
+            cipher.init(Cipher.ENCRYPT_MODE, privateKey);
+            byte[] encryptData = cipher.doFinal(RSA_TEST_DATA.getBytes(CHARSET));
+
+            cipher.init(Cipher.DECRYPT_MODE, publicKey);
+            byte[] decryptData = cipher.doFinal(encryptData);
+
+            boolean valid = RSA_TEST_DATA.equals(new String(decryptData, CHARSET));
+            LogUtils.d(TAG, "公钥有效性校验结果：" + valid);
+            return valid;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "公钥校验异常，判定无效", e);
+            return false;
+        }
+    }
+
+    // ==================== 内部辅助方法（密钥字符串转对象，仅工具类内部调用） ====================
+    /**
+     * 内部辅助：Base64私钥字符串转PrivateKey对象
+     * @param privateKeyStr Base64编码私钥字符串
+     * @return 转换成功返回对象，失败返回null
+     */
+    private PrivateKey getPrivateKeyFromStr(String privateKeyStr) {
+        LogUtils.d(TAG, "私钥字符串转PrivateKey对象");
+        if (privateKeyStr == null || privateKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "私钥字符串为空，转换失败");
+            return null;
+        }
+        try {
+            byte[] priBytes = Base64.decode(privateKeyStr, Base64.NO_WRAP);
+            PKCS8EncodedKeySpec priSpec = new PKCS8EncodedKeySpec(priBytes);
+            return KeyFactory.getInstance(RSA_ALGORITHM).generatePrivate(priSpec);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "设备不支持RSA算法，私钥转换失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "私钥格式无效，转换失败", e);
+        }
+        return null;
+    }
+
+    /**
+     * 内部辅助：Base64公钥字符串转PublicKey对象
+     * @param publicKeyStr Base64编码公钥字符串
+     * @return 转换成功返回对象，失败返回null
+     */
+    private PublicKey getPublicKeyFromStr(String publicKeyStr) {
+        LogUtils.d(TAG, "公钥字符串转PublicKey对象");
+        if (publicKeyStr == null || publicKeyStr.isEmpty()) {
+            LogUtils.w(TAG, "公钥字符串为空，转换失败");
+            return null;
+        }
+        try {
+            byte[] pubBytes = Base64.decode(publicKeyStr, Base64.NO_WRAP);
+            X509EncodedKeySpec pubSpec = new X509EncodedKeySpec(pubBytes);
+            return KeyFactory.getInstance(RSA_ALGORITHM).generatePublic(pubSpec);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "设备不支持RSA算法，公钥转换失败", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "公钥格式无效，转换失败", e);
+        }
+        return null;
+    }
+
+    // ==================== 内部NFC读写辅助方法（底层交互，对外隐藏） ====================
+    /**
+     * 内部辅助：读取NFC标签原始字节数据
+     */
+    private byte[] readNfcData(Tag tag) {
+        Ndef ndef = Ndef.get(tag);
+        if (ndef != null) {
+            try {
+                ndef.connect();
+                byte[] data = ndef.getNdefMessage().getRecords()[0].getPayload();
+                ndef.close();
+                return data;
+            } catch (Exception e) {
+                LogUtils.e(TAG, "NDEF格式NFC读取异常", e);
+                try { ndef.close(); } catch (IOException ex) { LogUtils.w(TAG, "关闭Ndef连接异常", ex); }
+            }
+        }
+        LogUtils.w(TAG, "NFC标签非NDEF格式，无有效数据");
+        return null;
+    }
+
+    /**
+     * 内部辅助：写入字节数据到NFC标签，兼容两种标签状态
+     */
+    private boolean writeNfcData(Tag tag, byte[] data) {
+        Ndef ndef = Ndef.get(tag);
+        if (ndef != null) return writeToNdef(ndef, data);
+
+        NdefFormatable formatable = NdefFormatable.get(tag);
+        if (formatable != null) return writeToFormatable(formatable, data);
+
+        LogUtils.w(TAG, "NFC标签不支持NDEF格式，写入失败");
+        return false;
+    }
+
+    /**
+     * 内部辅助：写入数据到已格式化NDEF标签
+     */
+    private boolean writeToNdef(Ndef ndef, byte[] data) {
+        try {
+            ndef.connect();
+            ndef.writeNdefMessage(createNdefMessage(data));
+            ndef.close();
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "写入已格式化NFC异常", e);
+            try { ndef.close(); } catch (IOException ex) { LogUtils.w(TAG, "关闭Ndef连接异常", ex); }
+            return false;
+        }
+    }
+
+    /**
+     * 内部辅助：格式化标签并写入数据
+     */
+    private boolean writeToFormatable(NdefFormatable formatable, byte[] data) {
+        try {
+            formatable.connect();
+            formatable.format(createNdefMessage(data));
+            formatable.close();
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "格式化NFC并写入异常", e);
+            try { formatable.close(); } catch (IOException ex) { LogUtils.w(TAG, "关闭NdefFormatable连接异常", ex); }
+            return false;
+        }
+    }
+
+    /**
+     * 内部辅助：创建标准NDEF消息，适配NFC传输规范
+     */
+    private android.nfc.NdefMessage createNdefMessage(byte[] payload) {
+        android.nfc.NdefRecord record = new android.nfc.NdefRecord(
+			android.nfc.NdefRecord.TNF_MIME_MEDIA,
+			"application/octet-stream".getBytes(),
+			new byte[0],
+			payload
+        );
+        return new android.nfc.NdefMessage(new android.nfc.NdefRecord[]{record});
+    }
+
+    // ==================== 对外公共访问方法（获取缓存/状态，简洁易用） ====================
+    public String getCachePrivateKeyStr() {
+        return mCachePrivateKeyStr;
+    }
+
+    public String getCachePublicKeyStr() {
+        return mCachePublicKeyStr;
+    }
+
+    /**
+     * 校验NFC功能是否可用（硬件支持+已开启）
+     * @return 可用返回true，不可用返回false
+     */
+    public boolean isNfcAvailable() {
+        boolean available = mNfcAdapter != null && mNfcAdapter.isEnabled();
+        LogUtils.d(TAG, "NFC当前可用性：" + available);
+        return available;
+    }
+
+    /**
+     * 清空内存中密钥缓存（如退出登录场景使用）
+     */
+    public void clearCache() {
+        mCachePrivateKeyStr = null;
+        mCachePublicKeyStr = null;
+        LogUtils.d(TAG, "内存密钥缓存已清空");
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/ShareLogActivity.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/ShareLogActivity.java
new file mode 100644
index 0000000..a9edd48
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/ShareLogActivity.java
@@ -0,0 +1,91 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import android.util.Log;
+import android.widget.Toast;
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.InputStreamReader;
+
+/**
+ * 分享崩溃日志窗口类
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026/05/11 22:30:00
+ */
+public class ShareLogActivity extends Activity {
+
+    public static final String TAG = "ShareLogActivity";
+    public static final String EXTRA_CRASH_LOG_FILEPATH = "crash_log_filepath";
+    public static final String EXTRA_CRASH_LOG_SUBJECT = "crash_log_subject";
+
+    @Override
+    protected void onCreate(final Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        Log.d(TAG, "onCreate 进入方法");
+
+        final Intent intent = getIntent();
+        if (intent == null) {
+            Log.e(TAG, "onCreate intent 为空");
+            finish();
+            return;
+        }
+
+        final String crashLogFilePath = intent.getStringExtra(EXTRA_CRASH_LOG_FILEPATH);
+        if (crashLogFilePath == null || crashLogFilePath.isEmpty()) {
+            Log.e(TAG, "onCreate crashLogFilePath 为空");
+            Toast.makeText(this, "日志文件路径无效", Toast.LENGTH_SHORT).show();
+            finish();
+            return;
+        }
+
+        final String subject = intent.getStringExtra(EXTRA_CRASH_LOG_SUBJECT);
+        handleShareCrashLog(crashLogFilePath, subject);
+    }
+
+    private void handleShareCrashLog(final String crashLogFilePath, final String subject) {
+        Log.d(TAG, "handleShareCrashLog crashLogFilePath = " + crashLogFilePath);
+
+        final File crashLogFile = new File(crashLogFilePath);
+        if (!crashLogFile.exists()) {
+            Log.e(TAG, "handleShareCrashLog 文件不存在");
+            Toast.makeText(this, "日志文件不存在", Toast.LENGTH_SHORT).show();
+            finish();
+            return;
+        }
+
+        BufferedReader reader = null;
+        try {
+            reader = new BufferedReader(new InputStreamReader(new FileInputStream(crashLogFile), "UTF-8"));
+            final StringBuilder sb = new StringBuilder();
+            String line;
+            while ((line = reader.readLine()) != null) {
+                sb.append(line).append("\n");
+            }
+            final String logContent = sb.toString();
+
+            final Intent shareIntent = new Intent(Intent.ACTION_SEND);
+            shareIntent.setType("text/plain");
+            shareIntent.putExtra(Intent.EXTRA_TEXT, logContent);
+            if (subject != null && !subject.isEmpty()) {
+                shareIntent.putExtra(Intent.EXTRA_SUBJECT, subject);
+            } else {
+                shareIntent.putExtra(Intent.EXTRA_SUBJECT, "崩溃日志");
+            }
+
+            startActivity(Intent.createChooser(shareIntent, "分享日志到"));
+            Log.d(TAG, "handleShareCrashLog 分享成功");
+        } catch (Exception e) {
+            Log.e(TAG, "handleShareCrashLog 异常", e);
+            Toast.makeText(this, "分享失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();
+        } finally {
+            if (reader != null) {
+                try { reader.close(); } catch (Exception e) {}
+            }
+            finish();
+        }
+    }
+}
\ No newline at end of file
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/SignGetUtils.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/SignGetUtils.java
new file mode 100644
index 0000000..9868459
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/utils/SignGetUtils.java
@@ -0,0 +1,71 @@
+package cc.winboll.studio.libappbase.utils;
+
+import android.content.Context;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.Signature;
+import android.util.Base64;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/20 19:50
+ * @Describe 获取应用签名指纹（SHA1+Base64，直接复制用）
+ */
+public class SignGetUtils {
+    private static final String TAG = "SignGetUtils";
+
+    /**
+     * 一键获取当前应用签名指纹（直接调用，看日志复制结果）
+     */
+    public static void getCurrentAppSign(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "context不能为空");
+            return;
+        }
+        try {
+            PackageManager pm = context.getPackageManager();
+            PackageInfo pkgInfo = pm.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);
+            Signature[] signatures = pkgInfo.signatures;
+            if (signatures == null || signatures.length == 0) {
+                LogUtils.e(TAG, "未获取到应用签名");
+                return;
+            }
+            // 和APPUtils校验格式完全一致（SHA1+Base64 NO_WRAP）
+            MessageDigest md = MessageDigest.getInstance("SHA1");
+            md.update(signatures[0].toByteArray());
+            String signBase64 = Base64.encodeToString(md.digest(), Base64.NO_WRAP);
+
+            // 关键日志：复制【】里的内容到APPUtils的TARGET_SIGN_FINGERPRINT
+            LogUtils.d(TAG, "当前应用包名：" + context.getPackageName());
+            LogUtils.d(TAG, "当前应用签名指纹（直接复制）：【" + signBase64 + "】");
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "获取签名失败：包名不存在", e);
+        } catch (NoSuchAlgorithmException e) {
+            LogUtils.e(TAG, "获取签名失败：不支持SHA1", e);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "获取签名失败", e);
+        }
+    }
+	
+	// 新增：直接返回签名字符串，供对话框调用
+//	public static String getSignStr(Context context) {
+//		if (context == null) return null;
+//		try {
+//			PackageManager pm = context.getPackageManager();
+//			PackageInfo pkgInfo = pm.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);
+//			Signature[] signatures = pkgInfo.signatures;
+//			if (signatures == null || signatures.length == 0) return null;
+//
+//			MessageDigest md = MessageDigest.getInstance("SHA1");
+//			md.update(signatures[0].toByteArray());
+//			return Base64.encodeToString(md.digest(), Base64.NO_WRAP);
+//		} catch (Exception e) {
+//			LogUtils.e(TAG, "获取签名字符串失败", e);
+//			return null;
+//		}
+//	}
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/views/AboutView.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/views/AboutView.java
new file mode 100644
index 0000000..8d94b53
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/views/AboutView.java
@@ -0,0 +1,557 @@
+package cc.winboll.studio.libappbase.views;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import android.util.AttributeSet;
+import android.view.Gravity;
+import android.view.View;
+import android.widget.EditText;
+import android.widget.ImageButton;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.libappbase.dialogs.DebugHostDialog;
+import cc.winboll.studio.libappbase.dialogs.APPValidationDialog;
+import cc.winboll.studio.libappbase.models.APPInfo;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026-01-11 12:23:00
+ * @LastEditTime 2026-01-24 20:50:00
+ * @Describe AboutView 原生实现关于页面，无第三方依赖，适配API30；抽象通用功能控件（邮件/网页跳转），支持调试工具入口动态显隐，集成应用正版校验、调试地址配置弹窗
+ */
+public class AboutView extends LinearLayout {
+    // ===================================== 全局常量 =====================================
+    public static final String TAG = "AboutView";
+    public static final int MSG_APPUPDATE_CHECKED = 0;
+
+    // 固定链接/邮件常量
+    private static final String WINBOLL_OFFICIAL_HOME = "https://www.winboll.cc";
+    private static final String EMAIL_TITLE = "联系WinBoLLStudio";
+    private static final String EMAIL_ADDRESS = "studio@winboll.cc";
+    private static final String EMAIL_TYPE = "message/rfc822";
+
+    // 布局尺寸常量（dp）
+    private static final int PADDING_LARGE = 32;
+    private static final int PADDING_MID = 16;
+    private static final int PADDING_SMALL = 8;
+    private static final int ICON_SIZE = 48;
+    private static final int ITEM_ICON_SIZE = 24;
+
+    // 服务器默认地址常量
+    private static final String SERVER_DEBUG_HOST = "https://yun-preivew.winboll.cc";
+    private static final String SERVER_RELEASE_HOST = "https://yun.winboll.cc";
+
+    // ===================================== 核心成员属性 =====================================
+    // 上下文与业务实体
+    private Context mContext;
+    private APPInfo mAPPInfo;
+    private OnRequestDevUserInfoAutofillListener mOnRequestDevUserInfoAutofillListener;
+
+    // 应用基础信息
+    private String mszAppName = "";
+    private String mszAppVersionName = "";
+    private String mszAppDescription = "";
+    private String mszHomePage = "";
+    private String mszGitea = "";
+    private String mszAppGitName = "";
+    private String mszAppAPKName = "";
+    private String mszAppAPKFolderName = "";
+    private String mszCurrentAppPackageName = "";
+    private String mszReleaseAPKName = "";
+    private volatile String mszNewestAppPackageName = "";
+    private String mszWinBoLLServerHost = "";
+    private int mnAppIcon = 0;
+    private boolean mIsAddDebugTools = false;
+
+    // 调试视图
+    private EditText metDevUserName;
+    private EditText metDevUserPassword;
+
+    // ===================================== 页面视图控件 =====================================
+    private DebugSwitchImageView ivAppIcon;
+    private TextView tvAppNameVersion;
+    private TextView tvAppDesc;
+    private LinearLayout llFunctionContainer;
+	private ImageButton ibSebugStepOver;
+    private ImageButton ibSigngetDialog;
+    private ImageButton ibWinBoLLHostDialog;
+
+    // ===================================== 构造方法（按参数从少到多排序） =====================================
+    public AboutView(Context context) {
+        super(context);
+        LogUtils.d(TAG, "AboutView(Context)：代码创建视图，执行默认初始化");
+        this.mContext = context;
+        initDefaultParams();
+        initViewFromXml();
+    }
+
+//    public AboutView(Context context, APPInfo appInfo) {
+//        super(context);
+//        LogUtils.d(TAG, "AboutView(Context,APPInfo)：传入应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+//        this.mContext = context;
+//        this.mAPPInfo = appInfo;
+//        initViewFromXml();
+//        initAll();
+//    }
+
+    public AboutView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        LogUtils.d(TAG, "AboutView(Context,AttributeSet)：XML布局引用，执行默认初始化");
+        this.mContext = context;
+        initDefaultParams();
+        initViewFromXml();
+    }
+
+    public AboutView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        LogUtils.d(TAG, "AboutView(Context,AttributeSet,int)：XML布局+样式配置，defStyleAttr=" + defStyleAttr);
+        this.mContext = context;
+        initDefaultParams();
+        initViewFromXml();
+    }
+
+    // ===================================== 对外公开方法 =====================================
+    /**
+     * 一站式初始化所有关于页逻辑，包含参数、应用信息、页面视图全流程
+     */
+    public void initAll() {
+        LogUtils.d(TAG, "initAll()：开始一站式初始化，APPInfo是否为空=" + (mAPPInfo == null));
+        if (mAPPInfo == null) {
+            LogUtils.w(TAG, "initAll()：初始化终止，APPInfo为null");
+            return;
+        }
+        initDefaultParams();
+        initAPPBaseInfo();
+        initAPPVersionInfo();
+        initServerConfig();
+        initAPPLinkInfo();
+        initReleaseAPKInfo();
+        initAboutPageView();
+        LogUtils.d(TAG, "initAll()：所有初始化流程执行完成");
+    }
+
+    /**
+     * 重置应用信息并重新初始化页面，支持动态更新关于页内容
+     * @param appInfo 新的应用信息实体
+     */
+//    public void setAPPInfoAndInit(APPInfo appInfo) {
+//        LogUtils.d(TAG, "setAPPInfoAndInit()：重置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+//        this.mAPPInfo = appInfo;
+//        if (llFunctionContainer != null) llFunctionContainer.removeAllViews();
+//        initAll();
+//        LogUtils.d(TAG, "setAPPInfoAndInit()：应用信息重置+页面重构完成");
+//    }
+
+    /**
+     * 设置应用信息，兼容旧调用逻辑，设置后自动重构页面
+     * @param appInfo 应用核心信息实体
+     */
+    public void setAPPInfo(APPInfo appInfo) {
+        LogUtils.d(TAG, "setAPPInfo()：设置应用信息，appName=" + (appInfo == null ? "null" : appInfo.getAppName()));
+        this.mAPPInfo = appInfo;
+        if (llFunctionContainer != null) llFunctionContainer.removeAllViews();
+        initAll();
+    }
+
+    /**
+     * 设置调试信息自动填充监听，供调试场景回调使用
+     * @param l 监听回调接口实现
+     */
+    public void setOnRequestDevUserInfoAutofillListener(OnRequestDevUserInfoAutofillListener l) {
+        LogUtils.d(TAG, "setOnRequestDevUserInfoAutofillListener()：设置调试信息填充监听完成");
+        this.mOnRequestDevUserInfoAutofillListener = l;
+    }
+
+    // ===================================== 内部初始化方法 =====================================
+    /**
+     * 初始化默认兜底参数，防止空指针，为后续初始化做基础铺垫
+     */
+    private void initDefaultParams() {
+        LogUtils.d(TAG, "initDefaultParams()：开始初始化默认参数");
+        mszWinBoLLServerHost = GlobalApplication.isDebugging() ? SERVER_DEBUG_HOST : SERVER_RELEASE_HOST;
+        mnAppIcon = (mnAppIcon == 0) ? R.drawable.ic_winboll : mnAppIcon;
+        mIsAddDebugTools = false;
+        LogUtils.d(TAG, "initDefaultParams()：默认参数初始化完成，服务器地址=" + mszWinBoLLServerHost + "，应用图标ID=" + mnAppIcon);
+    }
+
+    /**
+     * 加载XML布局并绑定所有视图控件，初始化按钮点击事件
+     */
+    private void initViewFromXml() {
+		LogUtils.d(TAG, "initViewFromXml()：开始加载布局并绑定控件");
+		View.inflate(mContext, R.layout.layout_about_view, this);
+		// 基础控件绑定
+		ivAppIcon = findViewById(R.id.iv_app_icon);
+		tvAppNameVersion = findViewById(R.id.tv_app_name_version);
+		tvAppDesc = findViewById(R.id.tv_app_desc);
+		llFunctionContainer = findViewById(R.id.ll_function_container);
+		// 功能按钮绑定
+		ibSebugStepOver = findViewById(R.id.ib_debug_step_over);
+		ibSigngetDialog = findViewById(R.id.ib_signgetdialog);
+		ibWinBoLLHostDialog = findViewById(R.id.ib_winbollhostdialog);
+
+		// 调试按钮统一只在调试模式显示
+		ibWinBoLLHostDialog.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
+		//ibSigngetDialog.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
+		ibSebugStepOver.setVisibility(GlobalApplication.isDebugging() ? View.VISIBLE : View.GONE);
+
+		// 绑定按钮点击事件
+		setBtnClickListener();
+		LogUtils.d(TAG, "initViewFromXml()：布局加载+控件绑定+事件初始化完成");
+	}
+
+    /**
+     * 从APPInfo实体读取应用基础核心配置，赋值到本地属性
+     */
+    private void initAPPBaseInfo() {
+        LogUtils.d(TAG, "initAPPBaseInfo()：开始读取APPInfo基础配置");
+        if (mAPPInfo == null) {
+            LogUtils.w(TAG, "initAPPBaseInfo()：跳过执行，APPInfo为null");
+            return;
+        }
+        mszAppName = mAPPInfo.getAppName() == null ? "" : mAPPInfo.getAppName();
+        mszAppAPKFolderName = mAPPInfo.getAppAPKFolderName() == null ? "" : mAPPInfo.getAppAPKFolderName();
+        mszAppAPKName = mAPPInfo.getAppAPKName() == null ? "" : mAPPInfo.getAppAPKName();
+        mszAppGitName = mAPPInfo.getAppGitName() == null ? "" : mAPPInfo.getAppGitName();
+        mszAppDescription = mAPPInfo.getAppDescription() == null ? "" : mAPPInfo.getAppDescription();
+        mnAppIcon = (mAPPInfo.getAppIcon() != 0) ? mAPPInfo.getAppIcon() : mnAppIcon;
+        mIsAddDebugTools = mAPPInfo.isAddDebugTools();
+        LogUtils.d(TAG, "initAPPBaseInfo()：基础配置读取完成，应用名=" + mszAppName + "，调试开关=" + mIsAddDebugTools);
+    }
+
+    /**
+     * 从包管理中获取当前应用版本号，初始化版本相关信息
+     */
+    private void initAPPVersionInfo() {
+        LogUtils.d(TAG, "initAPPVersionInfo()：开始初始化应用版本信息");
+        try {
+            mszAppVersionName = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0).versionName;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "initAPPVersionInfo()：获取版本号失败，默认赋值unknown", e);
+            mszAppVersionName = "unknown";
+        }
+        mszCurrentAppPackageName = String.format("%s_%s.apk", mszAppVersionName, mszAppVersionName);
+        LogUtils.d(TAG, "initAPPVersionInfo()：版本信息初始化完成，版本号=" + mszAppVersionName + "，当前APK名=" + mszCurrentAppPackageName);
+    }
+
+    /**
+     * 初始化服务器相关配置，预留扩展接口
+     */
+    private void initServerConfig() {
+        LogUtils.d(TAG, "initServerConfig()：服务器配置初始化，预留扩展接口");
+    }
+
+    /**
+     * 初始化应用相关链接（主页+Git源码地址），根据分支配置动态拼接Git地址
+     */
+    private void initAPPLinkInfo() {
+        LogUtils.d(TAG, "initAPPLinkInfo()：开始初始化应用链接信息");
+        if (mAPPInfo == null) {
+            LogUtils.w(TAG, "initAPPLinkInfo()：跳过执行，APPInfo为null");
+            return;
+        }
+        mszHomePage = mAPPInfo.getAppHomePage() == null ? "" : mAPPInfo.getAppHomePage();
+        // 拼接Git地址，兼容无分支配置场景
+        if (mAPPInfo.getAppGitAPPBranch() == null || mAPPInfo.getAppGitAPPBranch().trim().isEmpty()) {
+            mszGitea = String.format("https://gitea.winboll.cc/%s/%s", mAPPInfo.getAppGitOwner(), mszAppGitName);
+        } else {
+            mszGitea = String.format("https://gitea.winboll.cc/%s/%s/src/branch/%s/%s",
+									 mAPPInfo.getAppGitOwner(), mszAppGitName,
+									 mAPPInfo.getAppGitAPPBranch(), mAPPInfo.getAppGitAPPSubProjectFolder());
+        }
+        LogUtils.d(TAG, "initAPPLinkInfo()：链接信息初始化完成，应用主页=" + mszHomePage + "，Git地址=" + mszGitea);
+    }
+
+    /**
+     * 初始化正式版APK信息，去除beta后缀适配正式包命名规范
+     */
+    private void initReleaseAPKInfo() {
+        LogUtils.d(TAG, "initReleaseAPKInfo()：开始初始化正式版APK信息");
+        String szReleaseAppVersionName = "unknown";
+        try {
+            String szSubBetaSuffix = subBetaSuffix(mContext.getPackageName());
+            szReleaseAppVersionName = mContext.getPackageManager().getPackageInfo(szSubBetaSuffix, 0).versionName;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "initReleaseAPKInfo()：获取正式版版本号失败", e);
+        }
+        mszReleaseAPKName = String.format("%s_%s.apk", mszAppAPKName, szReleaseAppVersionName);
+        LogUtils.d(TAG, "initReleaseAPKInfo()：正式版APK信息初始化完成，APK名=" + mszReleaseAPKName);
+    }
+
+    /**
+     * 核心视图组装：赋值基础信息到控件，添加通用功能项到容器
+     */
+    private void initAboutPageView() {
+        LogUtils.d(TAG, "initAboutPageView()：开始组装关于页视图");
+        // 赋值基础信息
+        ivAppIcon.setImageResource(mnAppIcon);
+        tvAppNameVersion.setText(String.format("%s %s", mszAppName, mszAppVersionName));
+        if (mszAppDescription.isEmpty()) {
+            tvAppDesc.setVisibility(GONE);
+        } else {
+            tvAppDesc.setVisibility(VISIBLE);
+            tvAppDesc.setText(mszAppDescription);
+        }
+        // 添加通用功能项
+        addFunctionView(new WebJumpFunctionItemView(mContext, "WinBoLL 主页", WINBOLL_OFFICIAL_HOME, R.drawable.ic_winboll));
+        addFunctionView(new EmailFunctionItemView(mContext, "联系邮箱", "WinBoLLStudio<studio@winboll.cc>", R.drawable.ic_winboll));
+        if (!mszHomePage.isEmpty()) {
+            addFunctionView(new WebJumpFunctionItemView(mContext, "应用APK下载地址", mszHomePage, R.drawable.ic_winboll));
+        }
+        if (!mszGitea.isEmpty()) {
+            addFunctionView(new WebJumpFunctionItemView(mContext, "应用Git源码地址", mszGitea, R.drawable.ic_winboll));
+        }
+        LogUtils.d(TAG, "initAboutPageView()：视图组装完成，功能项加载完毕");
+    }
+
+    // ===================================== 内部工具/事件方法 =====================================
+    /**
+     * 绑定功能按钮点击事件，处理正版校验、调试地址配置弹窗唤起
+     */
+    private void setBtnClickListener() {
+        LogUtils.d(TAG, "setBtnClickListener()：开始绑定功能按钮点击事件");
+        // 取消调试状态按钮
+        ibSebugStepOver.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "ibSebugStepOver onClick：取消调试状态按钮已点击");
+					GlobalApplication.setIsDebugging(false);
+					GlobalApplication.saveDebugStatus(GlobalApplication.getInstance());
+					ToastUtils.show("已取消调试状态，重启应用可生效。");
+				}
+			});
+		// 正版校验弹窗
+        ibSigngetDialog.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "ibSigngetDialog onClick：唤起应用正版校验弹窗");
+					new APPValidationDialog(mContext, mszAppName, mszAppVersionName).show();
+				}
+			});
+        // 调试地址配置弹窗
+        ibWinBoLLHostDialog.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "ibWinBoLLHostDialog onClick：唤起调试地址配置弹窗");
+					new DebugHostDialog(mContext).show();
+				}
+			});
+        LogUtils.d(TAG, "setBtnClickListener()：功能按钮点击事件绑定完成");
+    }
+
+    /**
+     * 添加功能项视图到容器，统一设置间距
+     * @param view 功能项视图
+     */
+    private void addFunctionView(View view) {
+        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
+        params.topMargin = 0;
+        llFunctionContainer.addView(view, params);
+    }
+
+    /**
+     * dp转px工具方法，适配不同屏幕密度，保证布局一致性
+     * @param dpValue dp单位尺寸
+     * @return 转换后的px单位尺寸
+     */
+    private int dp2px(int dpValue) {
+        float density = mContext.getResources().getDisplayMetrics().density;
+        return (int) (dpValue * density + 0.5f);
+    }
+
+    /**
+     * 去除包名beta后缀，适配正式版包名规范，静态方法支持外部调用
+     * @param input 原始包名
+     * @return 去除beta后缀后的正式包名
+     */
+    public static String subBetaSuffix(String input) {
+        LogUtils.d(TAG, "subBetaSuffix()：执行包名beta后缀去除，原始包名=" + input);
+        if (input != null && input.endsWith(".beta")) {
+            String result = input.substring(0, input.length() - ".beta".length());
+            LogUtils.d(TAG, "subBetaSuffix()：处理成功，正式包名=" + result);
+            return result;
+        }
+        LogUtils.d(TAG, "subBetaSuffix()：无需处理，包名不含beta后缀");
+        return input == null ? "" : input;
+    }
+
+    // ===================================== 内部抽象通用功能项基类 =====================================
+    /**
+     * 通用功能项基类，统一样式、布局、视图构建，减少冗余代码
+     */
+    private abstract class BaseFunctionItemView extends LinearLayout implements OnClickListener {
+        protected Context mItemContext;
+        protected String mTitle;
+        protected String mContent;
+        protected int mIconRes;
+
+        public BaseFunctionItemView(Context context, String title, String content, int iconRes) {
+            super(context);
+            this.mItemContext = context;
+            this.mTitle = title;
+            this.mContent = content;
+            this.mIconRes = iconRes;
+            initItemLayout();
+            initItemViews();
+            setOnClickListener(this);
+        }
+
+        /**
+         * 统一初始化功能项布局属性
+         */
+        private void initItemLayout() {
+            setOrientation(HORIZONTAL);
+            setGravity(Gravity.CENTER_VERTICAL);
+            setPadding(dp2px(PADDING_MID), dp2px(PADDING_SMALL), dp2px(PADDING_MID), dp2px(PADDING_SMALL));
+            setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT));
+            setClickable(true);
+            setBackground(create_item_background());
+        }
+
+        /**
+         * 创建带1像素边框的背景drawable
+         */
+        private android.graphics.drawable.Drawable create_item_background() {
+            android.graphics.drawable.GradientDrawable drawable = new android.graphics.drawable.GradientDrawable();
+            drawable.setStroke(1, mItemContext.getResources().getColor(R.color.gray_300));
+            drawable.setCornerRadius(4);
+            boolean isNightMode = (mItemContext.getResources().getConfiguration().uiMode & android.content.res.Configuration.UI_MODE_NIGHT_MASK) == android.content.res.Configuration.UI_MODE_NIGHT_YES;
+            drawable.setColor(isNightMode ? mItemContext.getResources().getColor(R.color.gray_800) : mItemContext.getResources().getColor(android.R.color.white));
+            return drawable;
+        }
+
+        /**
+         * 统一构建功能项视图（左侧图标+右侧标题/内容）
+         */
+        private void initItemViews() {
+            // 左侧图标
+            if (mIconRes != 0) {
+                ImageView ivIcon = new ImageView(mItemContext);
+                LayoutParams iconParams = new LayoutParams(dp2px(ITEM_ICON_SIZE), dp2px(ITEM_ICON_SIZE));
+                iconParams.rightMargin = dp2px(PADDING_SMALL);
+                ivIcon.setLayoutParams(iconParams);
+                ivIcon.setImageResource(mIconRes);
+                addView(ivIcon);
+            }
+            // 右侧文本容器
+            LinearLayout llText = new LinearLayout(mItemContext);
+            llText.setOrientation(VERTICAL);
+            llText.setLayoutParams(new LayoutParams(0, LayoutParams.WRAP_CONTENT, 1.0f));
+            addView(llText);
+            // 标题
+            TextView tvTitle = new TextView(mItemContext);
+            tvTitle.setText(mTitle);
+            tvTitle.setTextSize(16);
+            boolean isNightMode = (mItemContext.getResources().getConfiguration().uiMode & android.content.res.Configuration.UI_MODE_NIGHT_MASK) == android.content.res.Configuration.UI_MODE_NIGHT_YES;
+            tvTitle.setTextColor(isNightMode ? mItemContext.getResources().getColor(R.color.gray_500) : mItemContext.getResources().getColor(R.color.gray_900));
+            llText.addView(tvTitle);
+            // 内容
+            TextView tvContent = new TextView(mItemContext);
+            tvContent.setText(mContent);
+            tvContent.setTextSize(14);
+            tvContent.setTextColor(getContentTextColor());
+            tvContent.setPadding(0, dp2px(PADDING_SMALL), 0, 0);
+            llText.addView(tvContent);
+        }
+
+        /**
+         * 子类抽象方法：指定内容文本颜色
+         * @return 颜色值
+         */
+        protected abstract int getContentTextColor();
+    }
+
+    // ===================================== 内部邮件功能项子类 =====================================
+    /**
+     * 邮件类功能控件，实现专属邮件唤起逻辑，双方案兼容（纯邮件客户端/通用邮件应用）
+     */
+    private class EmailFunctionItemView extends BaseFunctionItemView {
+        public EmailFunctionItemView(Context context, String title, String content, int iconRes) {
+            super(context, title, content, iconRes);
+        }
+
+        @Override
+        protected int getContentTextColor() {
+            return mItemContext.getResources().getColor(R.color.blue_normal);
+        }
+
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "EmailFunctionItemView onClick：触发邮件唤起逻辑");
+            // 方案1：纯邮件客户端唤起
+            Intent emailIntent = new Intent(Intent.ACTION_SENDTO);
+            emailIntent.setData(Uri.parse("mailto:" + EMAIL_ADDRESS));
+            emailIntent.putExtra(Intent.EXTRA_SUBJECT, EMAIL_TITLE);
+            emailIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            if (emailIntent.resolveActivity(mItemContext.getPackageManager()) != null) {
+                mItemContext.startActivity(emailIntent);
+                LogUtils.d(TAG, "EmailFunctionItemView：纯邮件客户端唤起成功");
+                return;
+            }
+            // 方案2：通用邮件应用兜底
+            Intent fallbackIntent = new Intent(Intent.ACTION_SEND);
+            fallbackIntent.setType(EMAIL_TYPE);
+            fallbackIntent.putExtra(Intent.EXTRA_EMAIL, new String[]{EMAIL_ADDRESS});
+            fallbackIntent.putExtra(Intent.EXTRA_SUBJECT, EMAIL_TITLE);
+            fallbackIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            if (fallbackIntent.resolveActivity(mItemContext.getPackageManager()) != null) {
+                mItemContext.startActivity(fallbackIntent);
+                LogUtils.d(TAG, "EmailFunctionItemView：通用邮件应用唤起成功");
+            } else {
+                ToastUtils.show("未找到可发送邮件的应用");
+                LogUtils.w(TAG, "EmailFunctionItemView：邮件唤起失败，无可用邮件应用");
+            }
+        }
+    }
+
+    // ===================================== 内部网页跳转功能项子类 =====================================
+    /**
+     * 网页跳转类功能控件，实现专属网页唤起逻辑，包含空地址校验、异常捕获
+     */
+    private class WebJumpFunctionItemView extends BaseFunctionItemView {
+        public WebJumpFunctionItemView(Context context, String title, String content, int iconRes) {
+            super(context, title, content, iconRes);
+        }
+
+        @Override
+        protected int getContentTextColor() {
+            return mItemContext.getResources().getColor(R.color.blue_normal);
+        }
+
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "WebJumpFunctionItemView onClick：触发网页跳转，地址=" + mContent);
+            if (mContent.isEmpty()) {
+                ToastUtils.show("跳转地址为空");
+                LogUtils.w(TAG, "WebJumpFunctionItemView：网页跳转失败，地址为空");
+                return;
+            }
+            try {
+                Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(mContent));
+                browserIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                mItemContext.startActivity(browserIntent);
+                LogUtils.d(TAG, "WebJumpFunctionItemView：网页跳转成功");
+            } catch (Exception e) {
+                LogUtils.e(TAG, "WebJumpFunctionItemView：网页跳转失败", e);
+                ToastUtils.show("链接无法打开");
+            }
+        }
+    }
+
+    // ===================================== 内部回调接口 =====================================
+    /**
+     * 调试信息自动填充回调接口
+     */
+    public interface OnRequestDevUserInfoAutofillListener {
+        void requestAutofill(EditText etDevUserName, EditText etDevUserPassword);
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/views/DebugSwitchImageView.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/views/DebugSwitchImageView.java
new file mode 100644
index 0000000..fa353f1
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/views/DebugSwitchImageView.java
@@ -0,0 +1,61 @@
+package cc.winboll.studio.libappbase.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.ImageView;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/04/06 19:32
+ * @Describe 具有调试模式切换功能的应用Logo控件，连续点击10次弹出提示
+ */
+public class DebugSwitchImageView extends ImageView {
+
+    public static final String TAG = "DebugSwitchImageView";
+
+    // 连续点击计数
+    private int mClickCount = 0;
+    // 目标点击次数
+    private static final int TARGET_CLICK_COUNT = 10;
+
+	public DebugSwitchImageView(Context context) {
+        super(context);
+        init();
+    }
+
+    public DebugSwitchImageView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+
+    public DebugSwitchImageView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        init();
+    }
+
+    public DebugSwitchImageView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        init();
+    }
+
+    private void init() {
+        setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					mClickCount++;
+					if (mClickCount == TARGET_CLICK_COUNT) {
+						// 达到10次，弹出Toast
+						Toast.makeText(getContext(), "连续点击已达到10次，现在开启应用调试功能。", Toast.LENGTH_SHORT).show();
+						GlobalApplication.setIsDebugging(true);
+						GlobalApplication.saveDebugStatus(GlobalApplication.getInstance());
+						// 重置计数，可再次触发
+						mClickCount = 0;
+					}
+				}
+			});
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/views/HorizontalListView.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/views/HorizontalListView.java
new file mode 100644
index 0000000..4e41357
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/views/HorizontalListView.java
@@ -0,0 +1,129 @@
+package cc.winboll.studio.libappbase.views;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/03/12 12:29:01
+ * @Describe 水平布局的 ListView
+ */
+import android.content.Context;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.ListView;
+import android.widget.Scroller;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class HorizontalListView extends ListView {
+    public static final String TAG = "HorizontalListView";
+    private int verticalOffset = 0;
+    private Scroller scroller;
+    private int totalWidth;
+
+    public HorizontalListView(Context context) {
+        super(context);
+        init();
+    }
+
+    public HorizontalListView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+
+    public HorizontalListView(Context context, AttributeSet attrs, int defStyle) {
+        super(context, attrs, defStyle);
+        init();
+    }
+
+    private void init() {
+        scroller = new Scroller(getContext());
+        setHorizontalScrollBarEnabled(true);
+        setVerticalScrollBarEnabled(false);
+    }
+
+    public void setVerticalOffset(int verticalOffset) {
+        this.verticalOffset = verticalOffset;
+    }
+
+    @Override
+    protected void onLayout(boolean changed, int l, int t, int r, int b) {
+        super.onLayout(changed, l, t, r, b);
+        int childCount = getChildCount();
+        int left = getPaddingLeft();
+        int viewHeight = getMeasuredHeight() - getPaddingTop() - getPaddingBottom();
+        totalWidth = left;
+
+        for (int i = 0; i < childCount; i++) {
+            View child = getChildAt(i);
+            int width = child.getMeasuredWidth();
+            int height = child.getMeasuredHeight();
+            child.layout(left, verticalOffset, left + width, verticalOffset + height);
+            left += width;
+        }
+        totalWidth = left + getPaddingRight();
+    }
+
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
+    }
+
+    @Override
+    public void computeScroll() {
+        if (scroller.computeScrollOffset()) {
+            scrollTo(scroller.getCurrX(), scroller.getCurrY());
+            postInvalidate();
+        }
+    }
+
+    public void smoothScrollTo(int x, int y) {
+        int dx = x - getScrollX();
+        int dy = y - getScrollY();
+        scroller.startScroll(getScrollX(), getScrollY(), dx, dy, 300); // 300ms平滑动画
+        invalidate();
+    }
+
+    @Override
+    public int computeHorizontalScrollRange() {
+        return totalWidth;
+    }
+
+    @Override
+    public int computeHorizontalScrollOffset() {
+        return getScrollX();
+    }
+
+    @Override
+    public int computeHorizontalScrollExtent() {
+        return getWidth();
+    }
+
+    public void scrollToItem(int position) {
+        if (position < 0 || position >= getChildCount()) {
+            LogUtils.d(TAG, "无效的position: " + position);
+            return;
+        }
+
+        View targetView = getChildAt(position);
+        int targetLeft = targetView.getLeft();
+        int scrollX = targetLeft - getPaddingLeft();
+
+        // 修正最大滚动范围计算
+        int maxScrollX = totalWidth;
+        scrollX = Math.max(0, Math.min(scrollX, maxScrollX));
+
+        // 强制重新布局和绘制
+        requestLayout();
+        invalidateViews();
+        smoothScrollTo(scrollX, 0);
+        LogUtils.d(TAG, String.format("滚动到position: %d, scrollX: %d computeHorizontalScrollRange() %d", position, scrollX, computeHorizontalScrollRange()));
+    }
+
+    public void resetScrollToStart() {
+        // 强制重新布局和绘制
+        requestLayout();
+        invalidateViews();
+        smoothScrollTo(0, 0);
+    }
+}
+
diff --git a/libappbase/src/main/java/cc/winboll/studio/libappbase/widget/LogTagSpinner.java b/libappbase/src/main/java/cc/winboll/studio/libappbase/widget/LogTagSpinner.java
new file mode 100644
index 0000000..32609ec
--- /dev/null
+++ b/libappbase/src/main/java/cc/winboll/studio/libappbase/widget/LogTagSpinner.java
@@ -0,0 +1,252 @@
+package cc.winboll.studio.libappbase.widget;
+
+import android.content.Context;
+import android.graphics.Color;
+import android.text.TextUtils;
+import android.content.res.TypedArray;
+import android.util.AttributeSet;
+import android.util.TypedValue;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ArrayAdapter;
+import android.widget.Spinner;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/15 13:51
+ * @Describe 纯原生 LogTag 专属 Spinner（无 androidx 依赖）
+ * 核心特性：1. 继承原生 Spinner，适配全 Android 版本；2. dimen 统一配置所有尺寸；3. 文字大小支持 dp 单位；4. 简化外部初始化
+ */
+public class LogTagSpinner extends Spinner {
+	public static final String TAG = "LogTagSpinner";
+
+	Context mContext;
+	// 尺寸缓存（dimen 解析后转 px，避免重复计算）
+	private int mSpinnerWidth;       // 控件自身框度（px）
+	private int mSpinnerHeight;       // 控件自身高度（px）
+	private int mItemWidth;          // 下拉项单个高度（px）
+	private int mItemHeight;          // 下拉项单个高度（px）
+	private float mTextSizePx;        // 文字大小（px，dp 转译后）
+	private int mTextPadding;         // 文字左右内边距（px）
+
+	// 内置适配器（外部无需关心内部实现）
+	private ArrayAdapter<String> mLogTagAdapter;
+
+
+	// -------------------------- 构造方法（原生 Spinner 必重写 3 个）--------------------------
+	public LogTagSpinner(Context context) {
+		super(context);
+		initCoreLogic(context);
+	}
+
+	public LogTagSpinner(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		initCoreLogic(context);
+	}
+
+	public LogTagSpinner(Context context, AttributeSet attrs, int defStyle) {
+		super(context, attrs, defStyle);
+		initCoreLogic(context);
+	}
+
+	// -------------------------- 核心初始化（解析资源 + 配置样式 + 初始化适配器）--------------------------
+	private void initCoreLogic(Context context) {
+		this.mContext = context;
+		// 1. 读取 dimen 资源（dp 转 px，核心适配）
+		parseDimenResources();
+		// 2. 设置 Spinner 自身基础样式（高度、背景）
+		configSelfStyle();
+		// 3. 初始化适配器（统一选中项+下拉项样式）
+		initCustomAdapter();
+	}
+
+
+	/**
+	 * 步骤 1：解析 dimen 资源，所有 dp 单位转为 px（跨设备视觉一致）
+	 */
+	private void parseDimenResources() {
+		Context context = this.mContext;
+		// 控件自身宽度（dp → px）
+		mSpinnerWidth = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_width);
+		// 控件自身高度（dp → px）
+		mSpinnerHeight = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_height);
+		// 下拉项宽度（dp → px）
+		mItemWidth = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_item_width);
+		// 下拉项高度（dp → px）
+		mItemHeight = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_item_height);
+		// 文字大小（dp → px，核心：用 getDimensionPixelSize 确保 dp 精准转译）
+		mTextSizePx = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_text_size);
+		// 文字内边距（dp → px）
+		mTextPadding = context.getResources().getDimensionPixelSize(R.dimen.log_spinner_text_padding);
+
+		LogUtils.d("LogTagSpinner", "dimen 解析完成：高度=" + mSpinnerHeight + "px，文字大小=" + mTextSizePx + "px");
+	}
+
+
+	/**
+	 * 步骤 2：配置 Spinner 自身样式（覆盖布局属性，统一控制）
+	 */
+	private void configSelfStyle() {
+		// 动态设置控件高度（布局中 layout_height 设 wrap_content 即可，这里统一控制）
+		ViewGroup.LayoutParams layoutParams = getLayoutParams();
+		if (layoutParams != null) {
+			layoutParams.width = mSpinnerWidth;
+			layoutParams.height = mSpinnerHeight;
+		} else {
+			// 代码创建控件时，手动初始化布局参数
+			layoutParams = new ViewGroup.LayoutParams(
+				mSpinnerWidth,
+				mSpinnerHeight
+			);
+		}
+		setLayoutParams(layoutParams);
+
+		// 统一背景色（外部可通过 setBackground 手动覆盖）
+		setBackgroundColor(this.mContext.getColor(R.color.btn_gray_normal));
+	}
+
+
+	/**
+	 * 步骤 3：初始化自定义适配器，统一选中项+下拉项样式
+	 */
+	private void initCustomAdapter() {
+		// 用原生系统布局（避免自定义布局，减少依赖），后续重写样式
+		mLogTagAdapter = new ArrayAdapter<String>(this.mContext, android.R.layout.simple_spinner_item) {
+			// 重写：控制「已选中项」的样式（文字大小、高度、内边距）
+			@Override
+			public View getView(int position, View convertView, ViewGroup parent) {
+				TextView itemTv = (TextView) super.getView(position, convertView, parent);
+				setItemUniformStyle(itemTv);
+				return itemTv;
+			}
+
+			// 重写：控制「下拉列表项」的样式（必须重写，否则下拉项样式不生效）
+			@Override
+			public View getDropDownView(int position, View convertView, ViewGroup parent) {
+				TextView itemTv = (TextView) super.getDropDownView(position, convertView, parent);
+				setItemUniformStyle(itemTv);
+				return itemTv;
+			}
+		};
+
+		// 绑定下拉项布局（原生系统布局，确保低版本兼容）
+		mLogTagAdapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
+		// 设置适配器到 Spinner
+		setAdapter(mLogTagAdapter);
+	}
+
+
+	/**
+	 * 通用方法：统一设置列表项（选中项/下拉项）的样式
+	 */
+	private void setItemUniformStyle(TextView itemTv) {
+		if (itemTv == null) return;
+
+		// 1. 文字大小（核心：按 px 赋值，dp 转译后无二次换算，精准适配）
+		itemTv.setTextSize(TypedValue.COMPLEX_UNIT_PX, mTextSizePx);
+		// 2. 列表项高度（固定高度，避免文字多少导致高度不一致）
+		itemTv.setWidth(mItemWidth);
+		itemTv.setHeight(mItemHeight);
+		// 3. 内边距（左右留白，优化排版，避免文字贴边）
+		itemTv.setPadding(mTextPadding, 0, mTextPadding, 0);
+		// 4. 文字对齐（垂直居中+靠左，符合常规 UI 设计）
+		//itemTv.setGravity(View.GRAVITY_CENTER_VERTICAL | View.GRAVITY_START);
+// 5. 文字颜色（使用主题属性 ?attr/toolbarTextColor）
+		TypedArray ta = mContext.obtainStyledAttributes(new int[] { R.attr.toolbarTextColor });
+		int toolbarTextColor = ta.getColor(0, mContext.getResources().getColor(R.color.white));
+		ta.recycle();
+		itemTv.setTextColor(toolbarTextColor);
+		itemTv.setBackgroundColor(this.mContext.getResources().getColor(R.color.btn_gray_normal));
+		// 6. 文字溢出处理（最多 2 行，超出省略，避免长标签换行过多）
+		itemTv.setSingleLine(false);
+		itemTv.setMaxLines(2);
+		itemTv.setEllipsize(TextUtils.TruncateAt.END);
+	}
+
+
+	// -------------------------- 外部调用 API（极简用法，无需关心内部逻辑）--------------------------
+	/**
+	 * 填充日志标签数据（外部核心调用，一行代码搞定）
+	 * @param logTagArray 日志标签数组（如：{"TAG_MAIN", "TAG_NET", "TAG_DB"}）
+	 */
+	public void setLogTagData(String[] logTagArray) {
+		if (mLogTagAdapter == null || logTagArray == null || logTagArray.length == 0) {
+			LogUtils.w("LogTagSpinner", "填充数据失败：适配器为空或数据无效");
+			return;
+		}
+		// 清空旧数据，添加新数据，刷新适配器
+		mLogTagAdapter.clear();
+		mLogTagAdapter.addAll(logTagArray);
+		mLogTagAdapter.notifyDataSetChanged();
+	}
+
+	/**
+	 * 设置默认选中的标签（索引从 0 开始）
+	 * @param defaultIndex 默认选中索引（需在 setLogTagData 之后调用）
+	 */
+	public void setDefaultSelectedTag(int defaultIndex) {
+		if (mLogTagAdapter == null) return;
+		// 索引合法性校验，避免数组越界
+		if (defaultIndex >= 0 && defaultIndex < mLogTagAdapter.getCount()) {
+			setSelection(defaultIndex);
+			LogUtils.d("LogTagSpinner", "默认选中标签：" + mLogTagAdapter.getItem(defaultIndex));
+		} else {
+			LogUtils.w("LogTagSpinner", "默认选中索引无效：" + defaultIndex);
+		}
+	}
+
+	/**
+	 * 获取当前选中的日志标签（外部业务逻辑调用）
+	 * @return 当前选中的标签文字（无选中时返回空字符串）
+	 */
+	public String getCurrentSelectedTag() {
+		Object selectedItem = getSelectedItem();
+		return selectedItem != null ? selectedItem.toString() : "";
+	}
+
+
+	// -------------------------- 优化扩展（可选，提升稳定性）--------------------------
+	/**
+	 * 视图附着到窗口时，确保默认有数据（避免空指针）
+	 */
+	@Override
+	protected void onAttachedToWindow() {
+		super.onAttachedToWindow();
+		if (mLogTagAdapter != null && mLogTagAdapter.getCount() == 0) {
+			setLogTagData(new String[]{"默认标签"});
+		}
+	}
+
+	/**
+	 * 外部扩展：动态修改文字大小（dp 单位）
+	 * @param textSizeDp 目标文字大小（dp）
+	 */
+	public void updateTextSize(int textSizeDp) {
+		mTextSizePx = this.mContext.getResources().getDimensionPixelSize(textSizeDp);
+		// 刷新所有列表项样式
+		if (mLogTagAdapter != null) {
+			mLogTagAdapter.notifyDataSetChanged();
+		}
+	}
+
+	/**
+	 * 外部扩展：动态修改文字颜色
+	 * @param textColorRes 文字颜色资源 ID（如 R.color.red）
+	 */
+	public void updateTextColor(int textColorRes) {
+		int textColor = this.mContext.getResources().getColor(textColorRes);
+		// 刷新选中项颜色
+		TextView selectedTv = (TextView) getSelectedView();
+		if (selectedTv != null) {
+			selectedTv.setTextColor(textColor);
+		}
+		// 刷新下拉项颜色
+		if (mLogTagAdapter != null) {
+			mLogTagAdapter.notifyDataSetChanged();
+		}
+	}
+}
+
diff --git a/libappbase/src/main/res/drawable/bg_border.xml b/libappbase/src/main/res/drawable/bg_border.xml
new file mode 100644
index 0000000..58b374a
--- /dev/null
+++ b/libappbase/src/main/res/drawable/bg_border.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <stroke
+        android:width="1dp"
+        android:color="#000000" /> <!-- 这里可调整边框宽度和颜色 -->
+    <solid android:color="@android:color/transparent" />
+</shape>
diff --git a/libappbase/src/main/res/drawable/bg_border_round.xml b/libappbase/src/main/res/drawable/bg_border_round.xml
new file mode 100644
index 0000000..2036d51
--- /dev/null
+++ b/libappbase/src/main/res/drawable/bg_border_round.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <stroke
+        android:width="1dp"
+        android:color="#000000" /> <!-- 这里可调整边框宽度和颜色 -->
+    <solid android:color="@android:color/transparent" />
+    <corners 
+        android:bottomLeftRadius="6dip" 
+        android:bottomRightRadius="6dip" 
+        android:topLeftRadius="6dip" 
+        android:topRightRadius="6dip" /> 
+</shape>
diff --git a/libappbase/src/main/res/drawable/bg_container_border.xml b/libappbase/src/main/res/drawable/bg_container_border.xml
new file mode 100644
index 0000000..09c5bdf
--- /dev/null
+++ b/libappbase/src/main/res/drawable/bg_container_border.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@android:color/transparent" />
+    <stroke android:width="1dp" android:color="#FFB0B0B0" />
+    <corners android:radius="?attr/borderCornerRadius" />
+</shape>
diff --git a/libappbase/src/main/res/drawable/bg_toolbar_log.xml b/libappbase/src/main/res/drawable/bg_toolbar_log.xml
new file mode 100644
index 0000000..84fda8a
--- /dev/null
+++ b/libappbase/src/main/res/drawable/bg_toolbar_log.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="@color/colorPrimary" 
+                android:startColor="@color/colorPrimary" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="@color/colorPrimary" 
+                android:startColor="@color/colorPrimary" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/libappbase/src/main/res/drawable/btn_gray_bg.xml b/libappbase/src/main/res/drawable/btn_gray_bg.xml
new file mode 100644
index 0000000..fbfb7c8
--- /dev/null
+++ b/libappbase/src/main/res/drawable/btn_gray_bg.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 按钮状态选择器：按优先级匹配（按压 > 禁用 > 默认） -->
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <!-- 状态 1：按压时（手指按住）→ 深灰色 -->
+    <item android:color="@color/btn_gray_pressed" android:state_pressed="true"/>
+
+    <!-- 状态 2：禁用时（setEnabled(false)）→ 浅灰色 -->
+    <item android:color="@color/btn_gray_disabled" android:state_enabled="false"/>
+
+    <!-- 状态 3：默认态（正常可点击）→ 常规灰色 -->
+    <item android:color="@color/btn_gray_normal"/>
+
+</selector>
diff --git a/libappbase/src/main/res/drawable/ic_bug.xml b/libappbase/src/main/res/drawable/ic_bug.xml
new file mode 100644
index 0000000..41a7159
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_bug.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M14,12H10V10H14M14,16H10V14H14M20,8H17.19C16.74,7.22 16.12,6.55 15.37,6.04L17,4.41L15.59,3L13.42,5.17C12.96,5.06 12.5,5 12,5C11.5,5 11.04,5.06 10.59,5.17L8.41,3L7,4.41L8.62,6.04C7.88,6.55 7.26,7.22 6.81,8H4V10H6.09C6.04,10.33 6,10.66 6,11V12H4V14H6V15C6,15.34 6.04,15.67 6.09,16H4V18H6.81C7.85,19.79 9.78,21 12,21C14.22,21 16.15,19.79 17.19,18H20V16H17.91C17.96,15.67 18,15.34 18,15V14H20V12H18V11C18,10.66 17.96,10.33 17.91,10H20V8Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libappbase/src/main/res/drawable/ic_content_copy.xml b/libappbase/src/main/res/drawable/ic_content_copy.xml
new file mode 100644
index 0000000..0a8394f
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_content_copy.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M19,21H8V7H19M19,5H8A2,2 0,0 0,6 7V21A2,2 0,0 0,8 23H19A2,2 0,0 0,21 21V7A2,2 0,0 0,19 5M16,1H4A2,2 0,0 0,2 3V17H4V3H16V1Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libappbase/src/main/res/drawable/ic_debug_step_over.xml b/libappbase/src/main/res/drawable/ic_debug_step_over.xml
new file mode 100644
index 0000000..e7b81e2
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_debug_step_over.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M19,7H16.19C15.74,6.2 15.12,5.5 14.37,5L16,3.41L14.59,2L12.42,4.17C11.96,4.06 11.5,4 11,4S10.05,4.06 9.59,4.17L7.41,2L6,3.41L7.62,5C6.87,5.5 6.26,6.21 5.81,7H3V9H5.09C5.03,9.33 5,9.66 5,10V11H3V13H5V14C5,14.34 5.03,14.67 5.09,15H3V17H5.81C7.26,19.5 10.28,20.61 13,19.65V19C13,18.43 13.09,17.86 13.25,17.31C12.59,17.76 11.8,18 11,18C8.79,18 7,16.21 7,14V10C7,7.79 8.79,6 11,6S15,7.79 15,10V14C15,14.19 15,14.39 14.95,14.58C15.54,14.04 16.24,13.62 17,13.35V13H19V11H17V10C17,9.66 16.97,9.33 16.91,9H19V7M13,9V11H9V9H13M13,13V15H9V13H13M16,16H22V22H16V16Z"/>
+
+</vector>
diff --git a/libappbase/src/main/res/drawable/ic_key.xml b/libappbase/src/main/res/drawable/ic_key.xml
new file mode 100644
index 0000000..4cea6c7
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_key.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M7,14C5.9,14 5,13.1 5,12S5.9,10 7,10 9,10.9 9,12 8.1,14 7,14M12.6,10C11.8,7.7 9.6,6 7,6C3.7,6 1,8.7 1,12S3.7,18 7,18C9.6,18 11.8,16.3 12.6,14H16V18H20V14H23V10H12.6Z"/>
+
+</vector>
\ No newline at end of file
diff --git a/libappbase/src/main/res/drawable/ic_launcher_background.xml b/libappbase/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..9486190
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="@color/colorPrimary"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/libappbase/src/main/res/drawable/ic_winboll.xml b/libappbase/src/main/res/drawable/ic_winboll.xml
new file mode 100644
index 0000000..21f28b1
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_winboll.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item
+        android:width="256dp"
+        android:height="256dp"
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/ic_winboll_logo">
+    </item>
+</layer-list>
diff --git a/libappbase/src/main/res/drawable/ic_winboll_beta.xml b/libappbase/src/main/res/drawable/ic_winboll_beta.xml
new file mode 100644
index 0000000..06fa725
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_winboll_beta.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/ic_winboll_logo"/>
+</layer-list>
diff --git a/libappbase/src/main/res/drawable/ic_winboll_logo.xml b/libappbase/src/main/res/drawable/ic_winboll_logo.xml
new file mode 100644
index 0000000..ea28987
--- /dev/null
+++ b/libappbase/src/main/res/drawable/ic_winboll_logo.xml
@@ -0,0 +1,48 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M103.77 307.45C103.02 293.07 104.03 271.24 129.24 248.85 135.25 243.52 141.74 239.48 147.89 236.44 160.24 230.34 171.23 228.28 174.15 227.92 174.31 227.9 174.44 227.89 174.55 227.88 174.66 227.87 174.75 227.86 174.81 227.86 176.62 227.85 216.5 230.02 234.65 253.79 253.9 278.99 266.43 314.66 221.67 356.93 184.69 391.85 179.97 411.36 180.15 411.08"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M248.17 309.83C247.43 295.45 248.43 273.62 273.64 251.23 279.65 245.9 286.14 241.86 292.29 238.82 304.65 232.72 315.63 230.65 318.55 230.3 318.71 230.28 318.84 230.27 318.95 230.26 319.06 230.25 319.15 230.24 319.21 230.24 321.02 230.22 360.9 232.4 379.06 256.17 398.3 281.37 410.83 317.04 366.08 359.31 329.09 394.23 324.37 413.74 324.55 413.46"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+</vector>
diff --git a/libappbase/src/main/res/drawable/shape_edittext_bg.xml b/libappbase/src/main/res/drawable/shape_edittext_bg.xml
new file mode 100644
index 0000000..d284d6a
--- /dev/null
+++ b/libappbase/src/main/res/drawable/shape_edittext_bg.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:state_focused="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF"/>
+            <stroke android:width="1dp" android:color="#007AFF"/>
+            <corners android:radius="8dp"/>
+        </shape>
+    </item>
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF"/>
+            <stroke android:width="1dp" android:color="#E5E5E5"/>
+            <corners android:radius="8dp"/>
+        </shape>
+    </item>
+</selector>
+
diff --git a/libappbase/src/main/res/layout-night/activity_about.xml b/libappbase/src/main/res/layout-night/activity_about.xml
new file mode 100644
index 0000000..962c60f
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/activity_about.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutviewroot_ll"/>
+</LinearLayout>
diff --git a/libappbase/src/main/res/layout-night/activity_globalcrash.xml b/libappbase/src/main/res/layout-night/activity_globalcrash.xml
new file mode 100644
index 0000000..cf4e1f7
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/activity_globalcrash.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">>
+
+	<cc.winboll.studio.libappbase.GlobalCrashReportView
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/activityglobalcrashGlobalCrashReportView1"/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout-night/activity_log.xml b/libappbase/src/main/res/layout-night/activity_log.xml
new file mode 100644
index 0000000..b49e51a
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/activity_log.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<cc.winboll.studio.libappbase.LogView
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/logview"/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout-night/activity_nfc_rsa_operate.xml b/libappbase/src/main/res/layout-night/activity_nfc_rsa_operate.xml
new file mode 100644
index 0000000..d19cd6e
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/activity_nfc_rsa_operate.xml
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:padding="24dp"
+    android:gravity="center_horizontal"
+    android:background="?attr/activityBackgroundColor">
+
+    <!-- NFC状态提示文本 -->
+    <TextView
+        android:id="@+id/tv_nfc_state"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="正在监听NFC卡片，请贴近设备检测密钥..."
+        android:textSize="17sp"
+        android:textColor="?attr/activityTextColor"
+        android:gravity="center"
+        android:padding="12dp"
+        android:layout_marginBottom="30dp"/>
+
+    <!-- 私钥显示区域 -->
+    <TextView
+        android:id="@+id/tv_private_key"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="私钥内容：无"
+        android:textSize="14sp"
+        android:textColor="?attr/activityTextColor"
+        android:layout_marginBottom="12dp"
+        android:maxLines="5"
+        android:ellipsize="end"/>
+
+    <!-- 公钥显示区域 -->
+    <TextView
+        android:id="@+id/tv_public_key"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="公钥内容：无"
+        android:textSize="14sp"
+        android:textColor="?attr/activityTextColor"
+        android:layout_marginBottom="40dp"
+        android:maxLines="5"
+        android:ellipsize="end"/>
+
+    <!-- 核心功能按钮（复用：保存本地/初始化密钥） -->
+    <Button
+        android:id="@+id/btn_create_write_key"
+        android:layout_width="300dp"
+        android:layout_height="wrap_content"
+        android:text="功能按钮待激活"
+        android:textSize="16sp"
+        android:textColor="?attr/toolbarTextColor"
+        android:backgroundTint="?attr/toolbarBackgroundColor"
+        android:padding="14dp"
+        android:enabled="false"/>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/libappbase/src/main/res/layout-night/dialog_sign_get.xml b/libappbase/src/main/res/layout-night/dialog_sign_get.xml
new file mode 100644
index 0000000..9d6256d
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/dialog_sign_get.xml
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="wrap_content"
+	android:layout_height="wrap_content"
+	android:orientation="vertical"
+	android:padding="16dp"
+	android:gravity="center"
+	android:background="?attr/dialogBackgroundColor">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="应用指纹校验"
+		android:textSize="16sp"
+		android:textColor="?attr/dialogTextColor"
+		android:textStyle="bold"
+		android:layout_marginBottom="12dp"/>
+
+	<ScrollView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content">
+
+		<EditText
+			android:id="@+id/et_sign_fingerprint"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:background="@android:drawable/edit_text"
+			android:textSize="12sp"
+			android:gravity="top"
+			android:hint="签名获取中..."
+			android:singleLine="false"
+			android:scrollHorizontally="false"
+			android:scrollbars="vertical"
+			android:overScrollMode="always"
+			android:typeface="monospace"
+			android:paddingLeft="10dp"
+			android:paddingRight="10dp"/>
+
+	</ScrollView>
+
+	<TextView
+		android:id="@+id/tv_auth_result"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp"
+		android:textSize="11sp"
+		android:gravity="center"
+		android:textColor="?attr/dialogTextColor"/>/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout-night/dialog_winboll_host.xml b/libappbase/src/main/res/layout-night/dialog_winboll_host.xml
new file mode 100644
index 0000000..642b30b
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/dialog_winboll_host.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:padding="16dp"
+    android:background="?attr/dialogBackgroundColor">
+
+    <!-- 标题 -->
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="设置服务器地址"
+        android:textSize="16sp"
+        android:textColor="?attr/dialogTextColor"
+        android:textStyle="bold"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 地址输入框 -->
+    <EditText
+        android:id="@+id/et_host_input"
+        android:layout_width="300dp"
+        android:layout_height="wrap_content"
+        android:hint="请输入服务器地址（如http://localhost:8080）"
+        android:textSize="14sp"
+        android:textColor="?attr/dialogTextColor"
+        android:inputType="textUri"
+        android:padding="8dp"
+        android:background="@android:drawable/edit_text"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 按钮容器 -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:gravity="end">
+
+        <!-- 取消按钮 -->
+        <Button
+            android:id="@+id/btn_cancel"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="取消"
+            android:textSize="14sp"
+            android:textColor="?attr/dialogTextColor"
+            android:layout_marginRight="8dp"/>
+
+        <!-- 确认按钮 -->
+        <Button
+            android:id="@+id/btn_confirm"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="确认"
+            android:textSize="14sp"
+            android:backgroundTint="?attr/toolbarBackgroundColor"
+            android:textColor="?attr/toolbarTextColor"/>
+
+    </LinearLayout>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout-night/item_logtag.xml b/libappbase/src/main/res/layout-night/item_logtag.xml
new file mode 100644
index 0000000..f00bf13
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/item_logtag.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="horizontal"
+	android:layout_width="wrap_content"
+	android:layout_height="match_parent"
+	android:background="@drawable/bg_border_round">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="@dimen/log_button_height"
+		android:textSize="@dimen/log_text_size"
+		android:layout_marginLeft="5dp"
+		android:id="@+id/viewlogtagTextView1"/>
+
+	<CheckBox
+		android:layout_width="wrap_content"
+		android:layout_height="@dimen/log_button_height"
+		android:textSize="@dimen/log_text_size"
+		android:textColor="?attr/toolbarTextColor"
+		android:id="@+id/viewlogtagCheckBox1"/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout-night/layout_about_view.xml b/libappbase/src/main/res/layout-night/layout_about_view.xml
new file mode 100644
index 0000000..a1753ff
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/layout_about_view.xml
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/aboutViewBackgroundColor">
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="vertical"
+		android:gravity="center_horizontal"
+		android:paddingLeft="16dp"
+		android:paddingTop="16dp"
+		android:paddingRight="16dp"
+		android:paddingBottom="16dp">
+
+		<cc.winboll.studio.libappbase.views.DebugSwitchImageView
+			android:id="@+id/iv_app_icon"
+			android:layout_width="48dp"
+			android:layout_height="48dp"
+			android:layout_marginBottom="8dp"
+			android:scaleType="centerCrop"/>
+
+		<TextView
+			android:id="@+id/tv_app_name_version"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="18sp"
+			android:textColor="?attr/aboutViewTitleColor"/>
+
+		<TextView
+			android:id="@+id/tv_app_desc"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="4dp"
+			android:layout_marginBottom="8dp"
+			android:textSize="14sp"
+			android:textColor="?attr/aboutViewTextColor"/>
+
+		<View
+			android:layout_width="match_parent"
+			android:layout_height="1px"
+			android:layout_marginTop="4dp"
+			android:layout_marginBottom="8dp"
+			android:background="?attr/aboutViewDividerColor"/>
+
+		<LinearLayout
+			android:id="@+id/ll_function_container"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"/>
+
+		<LinearLayout
+			android:orientation="horizontal"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center"
+			android:layout_marginTop="8dp"
+			android:spacing="20dp">
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_debug_step_over"
+				android:id="@+id/ib_debug_step_over"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_winboll"
+				android:id="@+id/ib_winbollhostdialog"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_key"
+				android:id="@+id/ib_signgetdialog"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+</ScrollView>
+
diff --git a/libappbase/src/main/res/layout-night/view_globalcrashreport.xml b/libappbase/src/main/res/layout-night/view_globalcrashreport.xml
new file mode 100644
index 0000000..a5f427e
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/view_globalcrashreport.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:theme="?attr/themeDebug"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/colorTextBackgound"
+	android:id="@+id/viewglobalcrashreportLinearLayout1">
+
+    <android.widget.Toolbar
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+		android:background="?attr/colorTittleBackgound"
+		android:titleTextColor="?attr/colorTittle"
+		android:id="@+id/viewglobalcrashreportToolbar1"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:fillViewport="true">
+
+		<HorizontalScrollView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content">
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:padding="16dp"
+				android:textColor="?attr/colorText"
+				android:id="@+id/viewglobalcrashreportTextView1"/>
+
+		</HorizontalScrollView>
+
+	</ScrollView>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout-night/view_log.xml b/libappbase/src/main/res/layout-night/view_log.xml
new file mode 100644
index 0000000..d8459a0
--- /dev/null
+++ b/libappbase/src/main/res/layout-night/view_log.xml
@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:theme="?attr/themeDebug"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/colorTextBackgound">
+
+	<RelativeLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="34dp"
+		android:layout_alignParentTop="true"
+		android:background="?attr/colorTittleBackgound"
+		android:id="@+id/viewlogRelativeLayoutToolbar">
+
+<Button
+			android:layout_width="@dimen/log_button_width"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:text="Clean"
+			android:textColor="?attr/activityTextColor"
+			android:background="?attr/toolbarBackgroundColor"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogButtonClean"
+			android:layout_marginLeft="5dp"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="20dp"
+			android:textSize="@dimen/log_text_size"
+			android:padding="@dimen/log_text_padding"
+			android:text="LV:"
+			android:layout_toRightOf="@+id/viewlogButtonClean"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogTextView1"
+			android:background="?attr/colorTittleBackgound"
+			android:textColor="?attr/toolbarTextColor"/>
+
+		<cc.winboll.studio.libappbase.widget.LogTagSpinner
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_toRightOf="@+id/viewlogTextView1"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogSpinner1"
+			android:padding="@dimen/log_spinner_text_padding"/>
+
+		<CheckBox
+			android:layout_width="@dimen/log_checkbox_width"
+			android:layout_height="@dimen/log_checkbox_height"
+			android:textSize="@dimen/log_text_size"
+			android:layout_toLeftOf="@+id/viewlogButtonCopy"
+			android:layout_centerVertical="true"
+			android:text="Selectable"
+			android:background="?attr/colorTittleBackgound"
+			android:id="@+id/viewlogCheckBoxSelectable"
+			android:padding="@dimen/log_text_padding"
+			android:textColor="?attr/toolbarTextColor"/>
+
+		<Button
+			android:layout_width="@dimen/log_button_width"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:textColor="?attr/activityTextColor"
+			android:background="?attr/toolbarBackgroundColor"
+			android:text="Copy"
+			android:layout_alignParentRight="true"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogButtonCopy"
+			android:layout_marginRight="5dp"/>
+
+	</RelativeLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/log_button_height"
+		android:layout_below="@+id/viewlogRelativeLayoutToolbar"
+		android:id="@+id/viewlogLinearLayout1"
+		android:gravity="center_vertical"
+		android:background="?attr/colorTittleBackgound">
+
+		<CheckBox
+			android:layout_width="wrap_content"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:text="ALL"
+			android:padding="2dp"
+			android:id="@+id/viewlogCheckBox1"
+			android:background="?attr/colorTittleBackgound"
+			android:textColor="?attr/toolbarTextColor"
+			android:layout_marginLeft="5dp"
+			android:layout_marginRight="5dp"/>
+
+		<EditText
+			android:layout_width="50dp"
+			android:ems="10"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:textColor="?attr/colorText"
+			android:background="?attr/colorTittleBackgound"
+			android:singleLine="true"
+			android:id="@+id/tagsearch_et"/>
+
+		<HorizontalScrollView
+			android:layout_width="0dp"
+			android:layout_height="match_parent"
+			android:background="?attr/colorTittleBackgound"
+			android:scrollbars="none"
+			android:padding="2dp"
+			android:layout_weight="1.0"
+			android:id="@+id/viewlogHorizontalScrollView1">
+
+			<cc.winboll.studio.libappbase.views.HorizontalListView
+				android:layout_width="wrap_content"
+				android:layout_height="match_parent"
+				android:id="@+id/tags_listview"/>
+
+		</HorizontalScrollView>
+
+	</LinearLayout>
+
+	<RelativeLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_weight="1.0"
+		android:layout_alignParentBottom="true"
+		android:layout_below="@+id/viewlogLinearLayout1">
+
+		<ScrollView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:background="?attr/colorTextBackgound"
+			android:id="@+id/viewlogScrollViewLog">
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:textSize="@dimen/log_text_size"
+				android:text="Text"
+				android:textColor="?attr/debugTextColor"
+				android:textIsSelectable="true"
+				android:id="@+id/viewlogTextViewLog"/>
+
+		</ScrollView>
+
+	</RelativeLayout>
+
+</RelativeLayout>
\ No newline at end of file
diff --git a/libappbase/src/main/res/layout/activity_about.xml b/libappbase/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..962c60f
--- /dev/null
+++ b/libappbase/src/main/res/layout/activity_about.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="?attr/toolbarBackgroundColor"
+		android:id="@+id/toolbar"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutviewroot_ll"/>
+</LinearLayout>
diff --git a/libappbase/src/main/res/layout/activity_globalcrash.xml b/libappbase/src/main/res/layout/activity_globalcrash.xml
new file mode 100644
index 0000000..ab9120e
--- /dev/null
+++ b/libappbase/src/main/res/layout/activity_globalcrash.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<cc.winboll.studio.libappbase.GlobalCrashReportView
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/activityglobalcrashGlobalCrashReportView1"/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout/activity_log.xml b/libappbase/src/main/res/layout/activity_log.xml
new file mode 100644
index 0000000..b49e51a
--- /dev/null
+++ b/libappbase/src/main/res/layout/activity_log.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/activityBackgroundColor">
+
+	<cc.winboll.studio.libappbase.LogView
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:id="@+id/logview"/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout/activity_nfc_rsa_operate.xml b/libappbase/src/main/res/layout/activity_nfc_rsa_operate.xml
new file mode 100644
index 0000000..d19cd6e
--- /dev/null
+++ b/libappbase/src/main/res/layout/activity_nfc_rsa_operate.xml
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:padding="24dp"
+    android:gravity="center_horizontal"
+    android:background="?attr/activityBackgroundColor">
+
+    <!-- NFC状态提示文本 -->
+    <TextView
+        android:id="@+id/tv_nfc_state"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="正在监听NFC卡片，请贴近设备检测密钥..."
+        android:textSize="17sp"
+        android:textColor="?attr/activityTextColor"
+        android:gravity="center"
+        android:padding="12dp"
+        android:layout_marginBottom="30dp"/>
+
+    <!-- 私钥显示区域 -->
+    <TextView
+        android:id="@+id/tv_private_key"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="私钥内容：无"
+        android:textSize="14sp"
+        android:textColor="?attr/activityTextColor"
+        android:layout_marginBottom="12dp"
+        android:maxLines="5"
+        android:ellipsize="end"/>
+
+    <!-- 公钥显示区域 -->
+    <TextView
+        android:id="@+id/tv_public_key"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="公钥内容：无"
+        android:textSize="14sp"
+        android:textColor="?attr/activityTextColor"
+        android:layout_marginBottom="40dp"
+        android:maxLines="5"
+        android:ellipsize="end"/>
+
+    <!-- 核心功能按钮（复用：保存本地/初始化密钥） -->
+    <Button
+        android:id="@+id/btn_create_write_key"
+        android:layout_width="300dp"
+        android:layout_height="wrap_content"
+        android:text="功能按钮待激活"
+        android:textSize="16sp"
+        android:textColor="?attr/toolbarTextColor"
+        android:backgroundTint="?attr/toolbarBackgroundColor"
+        android:padding="14dp"
+        android:enabled="false"/>
+
+</LinearLayout>
\ No newline at end of file
diff --git a/libappbase/src/main/res/layout/dialog_sign_get.xml b/libappbase/src/main/res/layout/dialog_sign_get.xml
new file mode 100644
index 0000000..9d6256d
--- /dev/null
+++ b/libappbase/src/main/res/layout/dialog_sign_get.xml
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="wrap_content"
+	android:layout_height="wrap_content"
+	android:orientation="vertical"
+	android:padding="16dp"
+	android:gravity="center"
+	android:background="?attr/dialogBackgroundColor">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="应用指纹校验"
+		android:textSize="16sp"
+		android:textColor="?attr/dialogTextColor"
+		android:textStyle="bold"
+		android:layout_marginBottom="12dp"/>
+
+	<ScrollView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content">
+
+		<EditText
+			android:id="@+id/et_sign_fingerprint"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:background="@android:drawable/edit_text"
+			android:textSize="12sp"
+			android:gravity="top"
+			android:hint="签名获取中..."
+			android:singleLine="false"
+			android:scrollHorizontally="false"
+			android:scrollbars="vertical"
+			android:overScrollMode="always"
+			android:typeface="monospace"
+			android:paddingLeft="10dp"
+			android:paddingRight="10dp"/>
+
+	</ScrollView>
+
+	<TextView
+		android:id="@+id/tv_auth_result"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp"
+		android:textSize="11sp"
+		android:gravity="center"
+		android:textColor="?attr/dialogTextColor"/>/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout/dialog_winboll_host.xml b/libappbase/src/main/res/layout/dialog_winboll_host.xml
new file mode 100644
index 0000000..642b30b
--- /dev/null
+++ b/libappbase/src/main/res/layout/dialog_winboll_host.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:padding="16dp"
+    android:background="?attr/dialogBackgroundColor">
+
+    <!-- 标题 -->
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="设置服务器地址"
+        android:textSize="16sp"
+        android:textColor="?attr/dialogTextColor"
+        android:textStyle="bold"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 地址输入框 -->
+    <EditText
+        android:id="@+id/et_host_input"
+        android:layout_width="300dp"
+        android:layout_height="wrap_content"
+        android:hint="请输入服务器地址（如http://localhost:8080）"
+        android:textSize="14sp"
+        android:textColor="?attr/dialogTextColor"
+        android:inputType="textUri"
+        android:padding="8dp"
+        android:background="@android:drawable/edit_text"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 按钮容器 -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:gravity="end">
+
+        <!-- 取消按钮 -->
+        <Button
+            android:id="@+id/btn_cancel"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="取消"
+            android:textSize="14sp"
+            android:textColor="?attr/dialogTextColor"
+            android:layout_marginRight="8dp"/>
+
+        <!-- 确认按钮 -->
+        <Button
+            android:id="@+id/btn_confirm"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="确认"
+            android:textSize="14sp"
+            android:backgroundTint="?attr/toolbarBackgroundColor"
+            android:textColor="?attr/toolbarTextColor"/>
+
+    </LinearLayout>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout/item_logtag.xml b/libappbase/src/main/res/layout/item_logtag.xml
new file mode 100644
index 0000000..f00bf13
--- /dev/null
+++ b/libappbase/src/main/res/layout/item_logtag.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="horizontal"
+	android:layout_width="wrap_content"
+	android:layout_height="match_parent"
+	android:background="@drawable/bg_border_round">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="@dimen/log_button_height"
+		android:textSize="@dimen/log_text_size"
+		android:layout_marginLeft="5dp"
+		android:id="@+id/viewlogtagTextView1"/>
+
+	<CheckBox
+		android:layout_width="wrap_content"
+		android:layout_height="@dimen/log_button_height"
+		android:textSize="@dimen/log_text_size"
+		android:textColor="?attr/toolbarTextColor"
+		android:id="@+id/viewlogtagCheckBox1"/>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout/layout_about_view.xml b/libappbase/src/main/res/layout/layout_about_view.xml
new file mode 100644
index 0000000..a1753ff
--- /dev/null
+++ b/libappbase/src/main/res/layout/layout_about_view.xml
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/aboutViewBackgroundColor">
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="vertical"
+		android:gravity="center_horizontal"
+		android:paddingLeft="16dp"
+		android:paddingTop="16dp"
+		android:paddingRight="16dp"
+		android:paddingBottom="16dp">
+
+		<cc.winboll.studio.libappbase.views.DebugSwitchImageView
+			android:id="@+id/iv_app_icon"
+			android:layout_width="48dp"
+			android:layout_height="48dp"
+			android:layout_marginBottom="8dp"
+			android:scaleType="centerCrop"/>
+
+		<TextView
+			android:id="@+id/tv_app_name_version"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="18sp"
+			android:textColor="?attr/aboutViewTitleColor"/>
+
+		<TextView
+			android:id="@+id/tv_app_desc"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="4dp"
+			android:layout_marginBottom="8dp"
+			android:textSize="14sp"
+			android:textColor="?attr/aboutViewTextColor"/>
+
+		<View
+			android:layout_width="match_parent"
+			android:layout_height="1px"
+			android:layout_marginTop="4dp"
+			android:layout_marginBottom="8dp"
+			android:background="?attr/aboutViewDividerColor"/>
+
+		<LinearLayout
+			android:id="@+id/ll_function_container"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"/>
+
+		<LinearLayout
+			android:orientation="horizontal"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center"
+			android:layout_marginTop="8dp"
+			android:spacing="20dp">
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_debug_step_over"
+				android:id="@+id/ib_debug_step_over"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_winboll"
+				android:id="@+id/ib_winbollhostdialog"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+			<ImageButton
+				android:layout_width="48dp"
+				android:layout_height="48dp"
+				android:src="@drawable/ic_key"
+				android:id="@+id/ib_signgetdialog"
+				android:scaleType="fitCenter"
+				android:adjustViewBounds="true"
+				android:background="@null"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+</ScrollView>
+
diff --git a/libappbase/src/main/res/layout/notification_crash.xml b/libappbase/src/main/res/layout/notification_crash.xml
new file mode 100644
index 0000000..6fbe3e3
--- /dev/null
+++ b/libappbase/src/main/res/layout/notification_crash.xml
@@ -0,0 +1,27 @@
+<?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="12dp">
+
+    <TextView
+        android:id="@+id/notification_title"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textSize="16sp"
+        android:textStyle="bold"
+        android:textColor="#333333"
+        android:singleLine="true"
+        android:ellipsize="end" />
+
+    <TextView
+        android:id="@+id/notification_content"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="8dp"
+        android:textSize="14sp"
+        android:textColor="#666666"
+        android:minHeight="200dp" />
+
+</LinearLayout>
\ No newline at end of file
diff --git a/libappbase/src/main/res/layout/notification_crash_expanded.xml b/libappbase/src/main/res/layout/notification_crash_expanded.xml
new file mode 100644
index 0000000..0a1a118
--- /dev/null
+++ b/libappbase/src/main/res/layout/notification_crash_expanded.xml
@@ -0,0 +1,27 @@
+<?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="12dp">
+
+    <TextView
+        android:id="@+id/notification_title"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textSize="16sp"
+        android:textStyle="bold"
+        android:textColor="#333333"
+        android:singleLine="true"
+        android:ellipsize="end" />
+
+    <TextView
+        android:id="@+id/notification_content"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="8dp"
+        android:textSize="13sp"
+        android:textColor="#666666"
+        android:scrollbars="vertical" />
+
+</LinearLayout>
\ No newline at end of file
diff --git a/libappbase/src/main/res/layout/view_globalcrashreport.xml b/libappbase/src/main/res/layout/view_globalcrashreport.xml
new file mode 100644
index 0000000..a5f427e
--- /dev/null
+++ b/libappbase/src/main/res/layout/view_globalcrashreport.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:theme="?attr/themeDebug"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/colorTextBackgound"
+	android:id="@+id/viewglobalcrashreportLinearLayout1">
+
+    <android.widget.Toolbar
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+		android:background="?attr/colorTittleBackgound"
+		android:titleTextColor="?attr/colorTittle"
+		android:id="@+id/viewglobalcrashreportToolbar1"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:fillViewport="true">
+
+		<HorizontalScrollView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content">
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:padding="16dp"
+				android:textColor="?attr/colorText"
+				android:id="@+id/viewglobalcrashreportTextView1"/>
+
+		</HorizontalScrollView>
+
+	</ScrollView>
+
+</LinearLayout>
+
diff --git a/libappbase/src/main/res/layout/view_log.xml b/libappbase/src/main/res/layout/view_log.xml
new file mode 100644
index 0000000..b728fbd
--- /dev/null
+++ b/libappbase/src/main/res/layout/view_log.xml
@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:theme="?attr/themeDebug"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="?attr/colorTextBackgound">
+
+	<RelativeLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="34dp"
+		android:layout_alignParentTop="true"
+		android:background="?attr/colorTittleBackgound"
+		android:id="@+id/viewlogRelativeLayoutToolbar">
+
+		<Button
+			android:layout_width="@dimen/log_button_width"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:text="Clean"
+			android:textColor="?attr/activityTextColor"
+			android:background="?attr/toolbarBackgroundColor"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogButtonClean"
+			android:layout_marginLeft="5dp"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="20dp"
+			android:textSize="@dimen/log_text_size"
+			android:padding="@dimen/log_text_padding"
+			android:text="LV:"
+			android:layout_toRightOf="@+id/viewlogButtonClean"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogTextView1"
+			android:background="?attr/colorTittleBackgound"
+			android:textColor="?attr/toolbarTextColor"/>
+
+		<cc.winboll.studio.libappbase.widget.LogTagSpinner
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_toRightOf="@+id/viewlogTextView1"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogSpinner1"
+			android:padding="@dimen/log_spinner_text_padding"/>
+
+		<CheckBox
+			android:layout_width="@dimen/log_checkbox_width"
+			android:layout_height="@dimen/log_checkbox_height"
+			android:textSize="@dimen/log_text_size"
+			android:layout_toLeftOf="@+id/viewlogButtonCopy"
+			android:layout_centerVertical="true"
+			android:text="Selectable"
+			android:background="?attr/colorTittleBackgound"
+			android:id="@+id/viewlogCheckBoxSelectable"
+			android:padding="@dimen/log_text_padding"
+			android:textColor="?attr/toolbarTextColor"/>
+
+		<Button
+			android:layout_width="@dimen/log_button_width"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:textColor="?attr/activityTextColor"
+			android:background="?attr/toolbarBackgroundColor"
+			android:text="Copy"
+			android:layout_alignParentRight="true"
+			android:layout_centerVertical="true"
+			android:id="@+id/viewlogButtonCopy"
+			android:layout_marginRight="5dp"/>
+
+	</RelativeLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/log_button_height"
+		android:layout_below="@+id/viewlogRelativeLayoutToolbar"
+		android:id="@+id/viewlogLinearLayout1"
+		android:gravity="center_vertical"
+		android:background="?attr/colorTittleBackgound">
+
+		<CheckBox
+			android:layout_width="wrap_content"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:text="ALL"
+			android:padding="2dp"
+			android:id="@+id/viewlogCheckBox1"
+			android:background="?attr/colorTittleBackgound"
+			android:textColor="?attr/toolbarTextColor"
+			android:layout_marginLeft="5dp"
+			android:layout_marginRight="5dp"/>
+
+		<EditText
+			android:layout_width="50dp"
+			android:ems="10"
+			android:layout_height="@dimen/log_button_height"
+			android:textSize="@dimen/log_text_size"
+			android:textColor="?attr/colorText"
+			android:background="?attr/colorTittleBackgound"
+			android:singleLine="true"
+			android:id="@+id/tagsearch_et"/>
+
+		<HorizontalScrollView
+			android:layout_width="0dp"
+			android:layout_height="match_parent"
+			android:background="?attr/colorTittleBackgound"
+			android:scrollbars="none"
+			android:padding="2dp"
+			android:layout_weight="1.0"
+			android:id="@+id/viewlogHorizontalScrollView1">
+
+			<cc.winboll.studio.libappbase.views.HorizontalListView
+				android:layout_width="wrap_content"
+				android:layout_height="match_parent"
+				android:id="@+id/tags_listview"/>
+
+		</HorizontalScrollView>
+
+	</LinearLayout>
+
+	<RelativeLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_weight="1.0"
+		android:layout_alignParentBottom="true"
+		android:layout_below="@+id/viewlogLinearLayout1">
+
+		<ScrollView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:background="?attr/colorTextBackgound"
+			android:id="@+id/viewlogScrollViewLog">
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:textSize="@dimen/log_text_size"
+				android:text="Text"
+				android:textColor="?attr/debugTextColor"
+				android:textIsSelectable="true"
+				android:id="@+id/viewlogTextViewLog"/>
+
+		</ScrollView>
+
+	</RelativeLayout>
+
+</RelativeLayout>
\ No newline at end of file
diff --git a/libappbase/src/main/res/values-night/attrs.xml b/libappbase/src/main/res/values-night/attrs.xml
new file mode 100644
index 0000000..3cb4ac4
--- /dev/null
+++ b/libappbase/src/main/res/values-night/attrs.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- 全局主题属性 -->
+    <attr name="themeDebug" format="reference"/>
+
+    <!-- GlobalCrashActivity 样式属性 -->
+    <declare-styleable name="GlobalCrashActivity">
+        <attr name="colorTittle" format="color" />
+        <attr name="colorTittleBackgound" format="color" />
+        <attr name="colorText" format="color" />
+        <attr name="colorTextBackgound" format="color" />
+    </declare-styleable>
+
+    <!-- AboutView 样式属性 -->
+    <declare-styleable name="AboutViewStyle">
+        <attr name="aboutViewBackgroundColor" format="color" />
+        <attr name="aboutViewTextColor" format="color" />
+        <attr name="aboutViewTitleColor" format="color" />
+        <attr name="aboutViewDividerColor" format="color" />
+    </declare-styleable>
+
+    
+
+    <!-- DialogStyle 样式属性 -->
+    <declare-styleable name="DialogStyle">
+        <attr name="dialogBackgroundColor" format="color" />
+        <attr name="dialogTextColor" format="color" />
+    </declare-styleable>
+
+    <!-- 窗体/控件通用背景色属性 -->
+    <attr name="toolbarBackgroundColor" format="color"/>
+    <attr name="textViewBackgroundColor" format="color"/>
+    <attr name="editTextBackgroundColor" format="color"/>
+    <attr name="scrollViewBackgroundColor" format="color"/>
+
+    <!-- 窗体/控件通用文字色属性 -->
+    <attr name="toolbarTextColor" format="color"/>
+    <attr name="textViewTextColor" format="color"/>
+    <attr name="editTextTextColor" format="color"/>
+
+    <!-- ActivityStyle 样式属性 -->
+    <attr name="activityBackgroundColor" format="color"/>
+    <attr name="activityTextColor" format="color"/>
+
+    <!-- MainWindowStyle 主窗口样式属性 -->
+    <attr name="mainWindowBackgroundColor" format="color"/>
+    <attr name="mainWindowTextColor" format="color"/>
+
+    <!-- MainWindowDarkStyle 深色模式主窗口样式属性 -->
+    <attr name="mainWindowDarkBackgroundColor" format="color"/>
+    <attr name="mainWindowDarkTextColor" format="color"/>
+
+    <!-- DebugLogStyle 应用调试日志样式属性 -->
+    <attr name="debugTextColor" format="color"/>
+
+</resources>
\ No newline at end of file
diff --git a/libappbase/src/main/res/values-night/colors.xml b/libappbase/src/main/res/values-night/colors.xml
new file mode 100644
index 0000000..4612c3a
--- /dev/null
+++ b/libappbase/src/main/res/values-night/colors.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#FF1E3A5F</color>
+    <color name="colorPrimaryDark">#FF15253D</color>
+    <color name="colorAccent">#FF4DA6FF</color>
+    <color name="colorText">#FFE0E0E0</color>
+	<color name="colorTextBackgound">#FF0D1B2A</color>
+
+	<!-- ============== 基础黑白（必含，适配文字/背景） ============== -->
+	<color name="white">#FFFFFF</color>
+	<color name="black">#000000</color>
+
+	<!-- ============== 基础色系（按钮/强调色常用） ============== -->
+	<color name="blue_light">#4A90E2</color>
+	<color name="blue_normal">#2196F3</color>
+	<color name="blue_dark">#1976D2</color>
+	<color name="green_light">#66BB6A</color>
+	<color name="green_normal">#4CAF50</color>
+	<color name="green_dark">#388E3C</color>
+	<color name="red_light">#EF5350</color>
+	<color name="red_normal">#F44336</color>
+	<color name="red_dark">#D32F2F</color>
+	<color name="yellow_light">#FFF59D</color>
+	<color name="yellow_normal">#FFC107</color>
+	<color name="yellow_dark">#FFA000</color>
+	<color name="orange_normal">#FF9800</color>
+	<color name="purple_normal">#9C27B0</color>
+
+	<!-- ============== 透明色（遮罩/背景叠加） ============== -->
+	<color name="transparent">#00000000</color>
+	<color name="black_transparent_50">#80000000</color>
+
+	<!-- ============== 不透明灰色（常用深浅梯度） ============== -->
+	<color name="gray_100">#1A1A1A</color>
+	<color name="gray_200">#262626</color>
+	<color name="gray_300">#333333</color>
+	<color name="gray_400">#4D4D4D</color>
+	<color name="gray_500">#666666</color>
+	<color name="gray_600">#808080</color>
+	<color name="gray_700">#999999</color>
+	<color name="gray_800">#B3B3B3</color>
+	<color name="gray_900">#CCCCCC</color>
+
+	<!-- ============== 半透明灰色 ============== -->
+	<color name="gray_transparent_30">#4D333333</color>
+	<color name="gray_transparent_50">#80333333</color>
+	<color name="gray_transparent_70">#B3333333</color>
+
+	<color name="gray_light">#333333</color>
+	<color name="gray_mid">#666666</color>
+	<color name="gray_dark">#999999</color>
+	<color name="gray_black">#CCCCCC</color>
+
+	<!-- ============== 遮罩/蒙层 ============== -->
+	<color name="mask_gray">#804D4D4D</color>
+	<color name="bg_overlay_gray">#4D1A1A1A</color>
+
+	<!-- ============== 按钮灰色 ============== -->
+	<color name="btn_gray_normal">#666666</color>
+	<color name="btn_gray_pressed">#4D4D4D</color>
+	<color name="btn_gray_disabled">#333333</color>
+
+	<!-- ============== 主题颜色 ============== -->
+	<color name="mainWindowBackgroundColor">#FF0D1B2A</color>
+	<color name="mainWindowTextColor">#FFE0E0E0</color>
+	<color name="toolbarTextColor">#FFE0E0E0</color>
+	<color name="toolbarBackgroundColor">#FF1E3A5F</color>
+	
+	<color name="debugTextColor">#FF00FF00</color>
+
+</resources>
\ No newline at end of file
diff --git a/libappbase/src/main/res/values-night/styles.xml b/libappbase/src/main/res/values-night/styles.xml
new file mode 100644
index 0000000..b8d576a
--- /dev/null
+++ b/libappbase/src/main/res/values-night/styles.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- APPBaseTheme 深色模式主题 -->
+    <style name="APPBaseTheme" parent="@android:style/Theme.DeviceDefault.NoActionBar">
+        <item name="themeDebug">@style/DebugActivityTheme</item>
+        <item name="aboutViewBackgroundColor">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="aboutViewTextColor">?attr/mainWindowDarkTextColor</item>
+        <item name="aboutViewTitleColor">?attr/mainWindowDarkTextColor</item>
+        <item name="aboutViewDividerColor">?attr/mainWindowTextColor</item>
+        
+        
+        <item name="dialogBackgroundColor">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="dialogTextColor">?attr/mainWindowDarkTextColor</item>
+        <item name="toolbarBackgroundColor">@color/toolbarBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+        <item name="textViewBackgroundColor">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="textViewTextColor">?attr/mainWindowDarkTextColor</item>
+        <item name="editTextBackgroundColor">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="editTextTextColor">?attr/mainWindowDarkTextColor</item>
+        <item name="scrollViewBackgroundColor">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="activityBackgroundColor">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="activityTextColor">?attr/mainWindowDarkTextColor</item>
+        <item name="mainWindowBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowTextColor">@color/mainWindowTextColor</item>
+        <item name="mainWindowDarkBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowDarkTextColor">@color/mainWindowTextColor</item>
+    </style>
+
+    <!-- DebugActivityTheme 深色模式样式 -->
+    <style name="DebugActivityTheme" parent="@android:style/Theme.DeviceDefault.NoActionBar">
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+        <item name="colorTittle">?attr/mainWindowDarkTextColor</item>
+        <item name="colorTittleBackgound">@color/toolbarBackgroundColor</item>
+        <item name="colorText">?attr/debugTextColor</item>
+        <item name="colorTextBackgound">?attr/mainWindowDarkBackgroundColor</item>
+        <item name="debugTextColor">@color/debugTextColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+        
+	</style>
+
+    <!-- DialogStyle 对话框样式 -->
+	<style name="DialogStyle" parent="@android:style/Theme.Dialog">
+		<item name="android:windowBackground">@android:color/transparent</item>
+		<item name="android:windowNoTitle">true</item>
+	</style>
+
+</resources>
\ No newline at end of file
diff --git a/libappbase/src/main/res/values/array.xml b/libappbase/src/main/res/values/array.xml
new file mode 100644
index 0000000..fdb5cac
--- /dev/null
+++ b/libappbase/src/main/res/values/array.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <array name="enum_loglevel_array">
+        <item>Off</item>
+        <item>Error</item>
+        <item>Warn</item>
+        <item>Info</item>
+        <item>Debug</item>
+        <item>Verbose</item>
+    </array>
+</resources>
diff --git a/libappbase/src/main/res/values/attrs.xml b/libappbase/src/main/res/values/attrs.xml
new file mode 100644
index 0000000..b569d4f
--- /dev/null
+++ b/libappbase/src/main/res/values/attrs.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- 全局主题属性 -->
+    <attr name="themeDebug" format="reference"/>
+
+    <!-- AboutView 样式属性 -->
+    <declare-styleable name="AboutView">
+        <attr name="app_name" format="string" />
+        <attr name="app_apkfoldername" format="string" />
+        <attr name="app_apkname" format="string" />
+        <attr name="app_gitname" format="string" />
+        <attr name="app_gitowner" format="string" />
+        <attr name="app_gitappbranch" format="string" />
+        <attr name="app_gitappsubprojectfolder" format="string" />
+        <attr name="appdescription" format="string" />
+        <attr name="appicon" format="reference" />
+        <attr name="is_adddebugtools" format="boolean" />
+    </declare-styleable>
+
+    <!-- AboutViewStyle 样式属性 -->
+    <declare-styleable name="AboutViewStyle">
+        <attr name="aboutViewBackgroundColor" format="color" />
+        <attr name="aboutViewTextColor" format="color" />
+        <attr name="aboutViewTitleColor" format="color" />
+        <attr name="aboutViewDividerColor" format="color" />
+    </declare-styleable>
+
+    
+
+    <!-- DialogStyle 样式属性 -->
+    <declare-styleable name="DialogStyle">
+        <attr name="dialogBackgroundColor" format="color" />
+        <attr name="dialogTextColor" format="color" />
+    </declare-styleable>
+
+    <!-- 窗体/控件通用背景色属性 -->
+    <attr name="toolbarBackgroundColor" format="color"/>
+    <attr name="textViewBackgroundColor" format="color"/>
+    <attr name="editTextBackgroundColor" format="color"/>
+    <attr name="scrollViewBackgroundColor" format="color"/>
+
+    <!-- 窗体/控件通用文字色属性 -->
+    <attr name="toolbarTextColor" format="color"/>
+    <attr name="textViewTextColor" format="color"/>
+    <attr name="editTextTextColor" format="color"/>
+
+    <!-- ActivityStyle 样式属性 -->
+    <attr name="activityBackgroundColor" format="color"/>
+    <attr name="activityTextColor" format="color"/>
+
+    <!-- MainWindowStyle 主窗口样式属性 -->
+    <attr name="mainWindowBackgroundColor" format="color"/>
+    <attr name="mainWindowTextColor" format="color"/>
+
+    <!-- MainWindowDarkStyle 深色模式主窗口样式属性 -->
+    <attr name="mainWindowDarkBackgroundColor" format="color"/>
+    <attr name="mainWindowDarkTextColor" format="color"/>
+
+    <!-- DebugLogStyle 应用调试日志样式属性 -->
+    <attr name="debugTextColor" format="color"/>
+
+</resources>
\ No newline at end of file
diff --git a/libappbase/src/main/res/values/colors.xml b/libappbase/src/main/res/values/colors.xml
new file mode 100644
index 0000000..28712e5
--- /dev/null
+++ b/libappbase/src/main/res/values/colors.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#FF00B322</color>
+    <color name="colorPrimaryDark">#FF008F1A</color>
+    <color name="colorAccent">#FF8DFFA2</color>
+    <color name="colorText">#FF000000</color>
+	<color name="colorTextBackgound">#FFF5F5F5</color>
+
+	<!-- ============== 基础黑白（必含，适配文字/背景） ============== -->
+	<color name="white">#FFFFFF</color>
+	<color name="black">#000000</color>
+
+	<!-- ============== 基础色系（按钮/强调色常用） ============== -->
+	<color name="blue_light">#4A90E2</color>
+	<color name="blue_normal">#2196F3</color>
+	<color name="blue_dark">#1976D2</color>
+	<color name="green_light">#66BB6A</color>
+	<color name="green_normal">#4CAF50</color>
+	<color name="green_dark">#388E3C</color>
+	<color name="red_light">#EF5350</color>
+	<color name="red_normal">#F44336</color>
+	<color name="red_dark">#D32F2F</color>
+	<color name="yellow_light">#FFF59D</color>
+	<color name="yellow_normal">#FFC107</color>
+	<color name="yellow_dark">#FFA000</color>
+	<color name="orange_normal">#FF9800</color>
+	<color name="purple_normal">#9C27B0</color>
+
+	<!-- ============== 透明色（遮罩/背景叠加） ============== -->
+	<color name="transparent">#00000000</color>
+	<color name="black_transparent_50">#80000000</color>
+
+	<!-- ============== 不透明灰色（常用深浅梯度） ============== -->
+	<color name="gray_100">#F5F5F5</color>
+	<color name="gray_200">#EEEEEE</color>
+	<color name="gray_300">#E0E0E0</color>
+	<color name="gray_400">#BDBDBD</color>
+	<color name="gray_500">#9E9E9E</color>
+	<color name="gray_600">#757575</color>
+	<color name="gray_700">#616161</color>
+	<color name="gray_800">#424242</color>
+	<color name="gray_900">#212121</color>
+
+	<!-- ============== 半透明灰色 ============== -->
+	<color name="gray_transparent_30">#4D9E9E9E</color>
+	<color name="gray_transparent_50">#809E9E9E</color>
+	<color name="gray_transparent_70">#B39E9E9E</color>
+
+	<color name="gray_light">#EEE</color>
+	<color name="gray_mid">#999</color>
+	<color name="gray_dark">#666</color>
+	<color name="gray_black">#333</color>
+
+	<!-- ============== 遮罩/蒙层 ============== -->
+	<color name="mask_gray">#809E9E9E</color>
+	<color name="bg_overlay_gray">#4D424242</color>
+
+	<!-- ============== 按钮灰色 ============== -->
+	<color name="btn_gray_normal">#9E9E9E</color>
+	<color name="btn_gray_pressed">#757575</color>
+	<color name="btn_gray_disabled">#E0E0E0</color>
+
+	<!-- ============== 主题颜色 ============== -->
+	<color name="mainWindowBackgroundColor">#FFF5F5F5</color>
+	<color name="mainWindowTextColor">#FF000000</color>
+	<color name="toolbarTextColor">#FF000000</color>
+	<color name="toolbarBackgroundColor">#FF00B322</color>
+	
+	<color name="debugTextColor">#FF808080</color>
+
+</resources>
\ No newline at end of file
diff --git a/libappbase/src/main/res/values/dimens.xml b/libappbase/src/main/res/values/dimens.xml
new file mode 100644
index 0000000..46eef9b
--- /dev/null
+++ b/libappbase/src/main/res/values/dimens.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <dimen name="log_text_size">12dp</dimen>
+	<dimen name="log_text_padding">2dp</dimen>
+
+    <dimen name="log_button_width">65dp</dimen>
+    <dimen name="log_button_height">34dp</dimen>
+
+    <dimen name="log_checkbox_width">100dp</dimen>
+    <dimen name="log_checkbox_height">20dp</dimen>
+	
+	<dimen name="log_spinner_width">60dp</dimen>
+	<dimen name="log_spinner_height">16dp</dimen>
+	<dimen name="log_spinner_item_width">@dimen/log_spinner_width</dimen>
+	<dimen name="log_spinner_item_height">@dimen/log_spinner_height</dimen>
+	<dimen name="log_spinner_text_size">@dimen/log_text_size</dimen>
+	<dimen name="log_spinner_text_padding">@dimen/log_text_padding</dimen>
+
+</resources>
diff --git a/libappbase/src/main/res/values/strings.xml b/libappbase/src/main/res/values/strings.xml
new file mode 100644
index 0000000..c2219d5
--- /dev/null
+++ b/libappbase/src/main/res/values/strings.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libappbase</string>
+    <string name="hello_world">Hello, world!</string>
+	<string name="shared_user_id">cc.winboll.studio</string>
+    <string name="shared_user_label">studio@winboll.cc</string>
+</resources>
diff --git a/libappbase/src/main/res/values/styles.xml b/libappbase/src/main/res/values/styles.xml
new file mode 100644
index 0000000..92d8143
--- /dev/null
+++ b/libappbase/src/main/res/values/styles.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- APPBaseTheme 普通模式主题 -->
+    <style name="APPBaseTheme" parent="@android:style/Theme.DeviceDefault.Light.NoActionBar">
+        <item name="themeDebug">@style/DebugActivityTheme</item>
+        <item name="aboutViewBackgroundColor">?attr/mainWindowBackgroundColor</item>
+        <item name="aboutViewTextColor">?attr/mainWindowTextColor</item>
+        <item name="aboutViewTitleColor">?attr/mainWindowTextColor</item>
+        <item name="aboutViewDividerColor">?attr/mainWindowDarkTextColor</item>
+        
+        
+        <item name="dialogBackgroundColor">?attr/mainWindowBackgroundColor</item>
+        <item name="dialogTextColor">?attr/mainWindowTextColor</item>
+        <item name="toolbarBackgroundColor">@color/toolbarBackgroundColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+        <item name="textViewBackgroundColor">?attr/mainWindowBackgroundColor</item>
+        <item name="textViewTextColor">?attr/mainWindowTextColor</item>
+        <item name="editTextBackgroundColor">?attr/mainWindowBackgroundColor</item>
+        <item name="editTextTextColor">?attr/mainWindowTextColor</item>
+        <item name="scrollViewBackgroundColor">?attr/mainWindowBackgroundColor</item>
+        <item name="activityBackgroundColor">?attr/mainWindowBackgroundColor</item>
+        <item name="activityTextColor">?attr/mainWindowTextColor</item>
+        <item name="mainWindowBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowTextColor">@color/mainWindowTextColor</item>
+        <item name="mainWindowDarkBackgroundColor">@color/mainWindowBackgroundColor</item>
+        <item name="mainWindowDarkTextColor">@color/mainWindowTextColor</item>
+    </style>
+
+    <!-- DebugActivityTheme 普通模式样式 -->
+    <style name="DebugActivityTheme" parent="@android:style/Theme.DeviceDefault.Light.NoActionBar">
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+        <item name="colorTittle">?attr/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">@color/toolbarBackgroundColor</item>
+        <item name="colorText">?attr/debugTextColor</item>
+        <item name="colorTextBackgound">?attr/mainWindowBackgroundColor</item>
+        <item name="debugTextColor">@color/debugTextColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+        
+	</style>
+
+    <!-- DialogStyle 对话框样式 -->
+	<style name="DialogStyle" parent="@android:style/Theme.Dialog">
+		<item name="android:windowBackground">@android:color/transparent</item>
+		<item name="android:windowNoTitle">true</item>
+	</style>
+
+</resources>
\ No newline at end of file
diff --git a/libappbase/src/main/res/xml/network_security_config.xml b/libappbase/src/main/res/xml/network_security_config.xml
new file mode 100644
index 0000000..54f4ef4
--- /dev/null
+++ b/libappbase/src/main/res/xml/network_security_config.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <!-- 原有配置 保留 -->
+        <domain includeSubdomains="true">winboll.cc</domain>
+        <domain includeSubdomains="true">localhost</domain>
+        <domain includeSubdomains="true">127.0.0.1</domain>
+
+        <!-- 精准配置10.8.0.0/24 前20个IP（10.8.0.0~10.8.0.19）-->
+        <domain includeSubdomains="false">10.8.0.0</domain>
+        <domain includeSubdomains="false">10.8.0.1</domain>
+        <domain includeSubdomains="false">10.8.0.2</domain>
+        <domain includeSubdomains="false">10.8.0.3</domain>
+        <domain includeSubdomains="false">10.8.0.4</domain>
+        <domain includeSubdomains="false">10.8.0.5</domain>
+        <domain includeSubdomains="false">10.8.0.6</domain>
+        <domain includeSubdomains="false">10.8.0.7</domain>
+        <domain includeSubdomains="false">10.8.0.8</domain>
+        <domain includeSubdomains="false">10.8.0.9</domain>
+        <domain includeSubdomains="false">10.8.0.10</domain>
+        <domain includeSubdomains="false">10.8.0.11</domain>
+        <domain includeSubdomains="false">10.8.0.12</domain>
+        <domain includeSubdomains="false">10.8.0.13</domain>
+        <domain includeSubdomains="false">10.8.0.14</domain>
+        <domain includeSubdomains="false">10.8.0.15</domain>
+        <domain includeSubdomains="false">10.8.0.16</domain>
+        <domain includeSubdomains="false">10.8.0.17</domain>
+        <domain includeSubdomains="false">10.8.0.18</domain>
+        <domain includeSubdomains="false">10.8.0.19</domain>
+    </domain-config>
+</network-security-config>
+
+
+
+
diff --git a/libdebugtemp/.gitignore b/libdebugtemp/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/libdebugtemp/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/libdebugtemp/build.gradle b/libdebugtemp/build.gradle
new file mode 100644
index 0000000..b11c04e
--- /dev/null
+++ b/libdebugtemp/build.gradle
@@ -0,0 +1,25 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        minSdkVersion 21
+        targetSdkVersion 30
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/libdebugtemp/build.properties b/libdebugtemp/build.properties
new file mode 100644
index 0000000..9805e56
--- /dev/null
+++ b/libdebugtemp/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Fri May 01 17:09:11 HKT 2026
+stageCount=57
+libraryProject=libdebugtemp
+baseVersion=15.0
+publishVersion=15.0.56
+buildCount=0
+baseBetaVersion=15.0.57
diff --git a/libdebugtemp/proguard-rules.pro b/libdebugtemp/proguard-rules.pro
new file mode 100644
index 0000000..536058a
--- /dev/null
+++ b/libdebugtemp/proguard-rules.pro
@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:/tools/adt-bundle-windows-x86_64-20131030/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
diff --git a/libdebugtemp/src/main/AndroidManifest.xml b/libdebugtemp/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..f30d087
--- /dev/null
+++ b/libdebugtemp/src/main/AndroidManifest.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio" >
+
+    <application>
+        <activity
+            android:name=".LibraryActivity"
+            android:label="@string/lib_name" >
+        </activity>
+    </application>
+
+</manifest>
+
diff --git a/libdebugtemp/src/main/java/cc/winboll/studio/LibraryActivity.java b/libdebugtemp/src/main/java/cc/winboll/studio/LibraryActivity.java
new file mode 100644
index 0000000..b4a25a8
--- /dev/null
+++ b/libdebugtemp/src/main/java/cc/winboll/studio/LibraryActivity.java
@@ -0,0 +1,12 @@
+package cc.winboll.studio;
+
+import android.app.Activity;
+import android.os.Bundle;
+
+public class LibraryActivity extends Activity {
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.library);
+    }
+}
diff --git a/libdebugtemp/src/main/res/drawable-hdpi/ic_launcher.png b/libdebugtemp/src/main/res/drawable-hdpi/ic_launcher.png
new file mode 100644
index 0000000..96a442e
Binary files /dev/null and b/libdebugtemp/src/main/res/drawable-hdpi/ic_launcher.png differ
diff --git a/libdebugtemp/src/main/res/drawable-mdpi/ic_launcher.png b/libdebugtemp/src/main/res/drawable-mdpi/ic_launcher.png
new file mode 100644
index 0000000..359047d
Binary files /dev/null and b/libdebugtemp/src/main/res/drawable-mdpi/ic_launcher.png differ
diff --git a/libdebugtemp/src/main/res/drawable-xhdpi/ic_launcher.png b/libdebugtemp/src/main/res/drawable-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..71c6d76
Binary files /dev/null and b/libdebugtemp/src/main/res/drawable-xhdpi/ic_launcher.png differ
diff --git a/libdebugtemp/src/main/res/drawable-xxhdpi/ic_launcher.png b/libdebugtemp/src/main/res/drawable-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..4df1894
Binary files /dev/null and b/libdebugtemp/src/main/res/drawable-xxhdpi/ic_launcher.png differ
diff --git a/libdebugtemp/src/main/res/layout/library.xml b/libdebugtemp/src/main/res/layout/library.xml
new file mode 100644
index 0000000..5f67086
--- /dev/null
+++ b/libdebugtemp/src/main/res/layout/library.xml
@@ -0,0 +1,11 @@
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:gravity="center">
+
+    <TextView
+        android:text="@string/text_libraryactivity"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content" />
+
+</LinearLayout>
diff --git a/libdebugtemp/src/main/res/values-v21/styles.xml b/libdebugtemp/src/main/res/values-v21/styles.xml
new file mode 100644
index 0000000..0948fdc
--- /dev/null
+++ b/libdebugtemp/src/main/res/values-v21/styles.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Material.Light">
+	</style>
+</resources>
\ No newline at end of file
diff --git a/libdebugtemp/src/main/res/values/strings.xml b/libdebugtemp/src/main/res/values/strings.xml
new file mode 100644
index 0000000..7d1f811
--- /dev/null
+++ b/libdebugtemp/src/main/res/values/strings.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libdebugtemp</string>
+    <string name="hello_world">Hello world!</string>
+    <string name="text_libraryactivity">LibraryActivity</string>
+
+</resources>
diff --git a/libdebugtemp/src/main/res/values/styles.xml b/libdebugtemp/src/main/res/values/styles.xml
new file mode 100644
index 0000000..8d78246
--- /dev/null
+++ b/libdebugtemp/src/main/res/values/styles.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Holo.Light">
+	</style>
+</resources>
\ No newline at end of file
diff --git a/libgpsrelaysentinel/.gitignore b/libgpsrelaysentinel/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/libgpsrelaysentinel/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/libgpsrelaysentinel/build.gradle b/libgpsrelaysentinel/build.gradle
new file mode 100644
index 0000000..4a35e97
--- /dev/null
+++ b/libgpsrelaysentinel/build.gradle
@@ -0,0 +1,35 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        minSdkVersion 26
+        targetSdkVersion 30
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+}
+
+dependencies {
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.9'
+    api 'cc.winboll.studio:libappbase:15.15.21'
+	
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/libgpsrelaysentinel/build.properties b/libgpsrelaysentinel/build.properties
new file mode 100644
index 0000000..9805e56
--- /dev/null
+++ b/libgpsrelaysentinel/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Fri May 01 17:09:11 HKT 2026
+stageCount=57
+libraryProject=libdebugtemp
+baseVersion=15.0
+publishVersion=15.0.56
+buildCount=0
+baseBetaVersion=15.0.57
diff --git a/libgpsrelaysentinel/proguard-rules.pro b/libgpsrelaysentinel/proguard-rules.pro
new file mode 100644
index 0000000..536058a
--- /dev/null
+++ b/libgpsrelaysentinel/proguard-rules.pro
@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:/tools/adt-bundle-windows-x86_64-20131030/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
diff --git a/libgpsrelaysentinel/src/main/AndroidManifest.xml b/libgpsrelaysentinel/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..9722560
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/AndroidManifest.xml
@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.libgpsrelaysentinel">
+
+    <application>
+		<service
+			android:name=".service.GpsSubscribeReceiverService"
+			android:exported="true"
+			android:enabled="true">
+			<intent-filter>
+				<action android:name="cc.winboll.studio.libgpsrelaysentinel.action.RECEIVE" />
+			</intent-filter>
+		</service>
+		
+        <receiver android:name=".receiver.GpsSubscribeObserverReceiver">
+
+            <intent-filter>
+
+                <action android:name=".receiver.GpsSubscribeObserverReceiver"/>
+
+            </intent-filter>
+
+        </receiver>
+    </application>
+
+</manifest>
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/GpsSubscribeManager.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/GpsSubscribeManager.java
new file mode 100644
index 0000000..fe028bc
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/GpsSubscribeManager.java
@@ -0,0 +1,75 @@
+package cc.winboll.studio.libgpsrelaysentinel.manager;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:25
+ */
+
+import android.content.Context;
+import android.content.Intent;
+import java.util.HashMap;
+import java.util.Map;
+
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeResult;
+
+public final class GpsSubscribeManager {
+
+    private static GpsSubscribeManager instance;
+    private final Map<String,GpsSubscribeMsg> subscribeMap;
+    private Context appContext;
+
+    private GpsSubscribeManager(){
+        subscribeMap = new HashMap<String, GpsSubscribeMsg>();
+    }
+
+    public static GpsSubscribeManager getInstance(){
+        if(instance == null){
+            instance = new GpsSubscribeManager();
+        }
+        return instance;
+    }
+
+    public void initContext(final Context context){
+        this.appContext = context.getApplicationContext();
+    }
+
+    public void addSubscribe(final GpsSubscribeMsg subscribeMsg){
+        if(subscribeMsg == null){
+            return;
+        }
+        subscribeMap.put(subscribeMsg.getSubscribeUniqueId(),subscribeMsg);
+    }
+
+    public void removeSubscribe(final String sid){
+        if(sid == null){
+            return;
+        }
+        subscribeMap.remove(sid);
+        SubscribeLocationManager.getInstance().removeSubscribe(sid);
+    }
+
+    public boolean isSubscribeExist(final String sid){
+        return subscribeMap.containsKey(sid);
+    }
+
+    public void sendSubscribeResult(final GpsSubscribeResult result){
+        if(appContext == null || result == null){
+            return;
+        }
+        Intent intent = new Intent(GpsSubscribeConst.ACTION_SUBSCRIBE_CALLBACK);
+        intent.putExtra("data",result);
+        appContext.sendBroadcast(intent);
+    }
+
+    public void clearAllSubscribe(){
+        subscribeMap.clear();
+        SubscribeLocationManager.getInstance().clearAll();
+    }
+
+    public Map<String, GpsSubscribeMsg> getSubscribeMap() {
+        return subscribeMap;
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/SubscribeLocationManager.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/SubscribeLocationManager.java
new file mode 100644
index 0000000..962086f
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/SubscribeLocationManager.java
@@ -0,0 +1,128 @@
+package cc.winboll.studio.libgpsrelaysentinel.manager;
+
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public final class SubscribeLocationManager {
+
+    private static SubscribeLocationManager instance;
+
+    //订阅配置
+    private final Map<String,GpsSubscribeMsg> subscribeConfigMap;
+    //基准定点坐标
+    private final Map<String,LocationPoint> subscriberPointMap;
+    //真实推送计数(精准统计)
+    private final Map<String,Integer> subscriberPushCountMap;
+
+    private SubscribeLocationManager(){
+        subscribeConfigMap = new HashMap<String, GpsSubscribeMsg>();
+        subscriberPointMap = new HashMap<String, LocationPoint>();
+        subscriberPushCountMap = new HashMap<String, Integer>();
+    }
+
+    public static SubscribeLocationManager getInstance(){
+        if(instance == null){
+            instance = new SubscribeLocationManager();
+        }
+        return instance;
+    }
+
+    //========= 订阅配置 =========
+    public void putSubscribeConfig(String sid,GpsSubscribeMsg msg){
+        subscribeConfigMap.put(sid,msg);
+    }
+
+    public GpsSubscribeMsg getSubscribeConfig(String sid){
+        return subscribeConfigMap.get(sid);
+    }
+
+    //========= 基准定点坐标 =========
+    public void initSubscriberPoint(String sid,double lat,double lng){
+        subscriberPointMap.put(sid,new LocationPoint(lat,lng,System.currentTimeMillis()));
+    }
+
+    public void updateSubscriberPoint(String sid,double lat,double lng){
+        subscriberPointMap.put(sid,new LocationPoint(lat,lng,System.currentTimeMillis()));
+    }
+
+    public LocationPoint getLastPoint(String sid){
+        return subscriberPointMap.get(sid);
+    }
+
+    //========= 精准推送计数 =========
+    public void addPushCount(String sid){
+        int current = subscriberPushCountMap.get(sid) == null ? 0 : subscriberPushCountMap.get(sid);
+        subscriberPushCountMap.put(sid,current + 1);
+    }
+
+    public int getPushCount(String sid){
+        return subscriberPushCountMap.get(sid) == null ? 0 : subscriberPushCountMap.get(sid);
+    }
+
+    public void clearPushCount(String sid){
+        subscriberPushCountMap.put(sid,0);
+    }
+
+    //========= 步长规则判断 =========
+    public boolean isNeedPush(String sid,double nowLat,double nowLng){
+        GpsSubscribeMsg config = getSubscribeConfig(sid);
+        if(config == null){
+            return false;
+        }
+
+        //全量订阅直接放行
+        if(config.getSubscribeMode() == GpsSubscribeConst.SUB_TYPE_ALL){
+            return true;
+        }
+
+        //无初始定点 → 先建立第一个基准点
+        LocationPoint lastPoint = getLastPoint(sid);
+        if(lastPoint == null){
+            return true;
+        }
+
+        //计算实际移动距离
+        double distance = calculateDistance(
+			lastPoint.getLatitude(),lastPoint.getLongitude(),
+			nowLat,nowLng
+        );
+
+        return distance >= config.getStepDistanceM();
+    }
+
+    //两点经纬度距离计算(米)
+    private double calculateDistance(double lat1,double lng1,double lat2,double lng2){
+        double radLat1 = Math.toRadians(lat1);
+        double radLat2 = Math.toRadians(lat2);
+        double radLng1 = Math.toRadians(lng1);
+        double radLng2 = Math.toRadians(lng2);
+
+        double latDiff = radLat1 - radLat2;
+        double lngDiff = radLng1 - radLng2;
+
+        double value = 2 * Math.asin(Math.sqrt(
+										 Math.pow(Math.sin(latDiff / 2),2)
+										 + Math.cos(radLat1) * Math.cos(radLat2)
+										 * Math.pow(Math.sin(lngDiff / 2),2)
+									 ));
+        return value * 6378137;
+    }
+
+    //========= 移除 & 清空 =========
+    public void removeSubscribe(String sid){
+        subscribeConfigMap.remove(sid);
+        subscriberPointMap.remove(sid);
+        subscriberPushCountMap.remove(sid);
+    }
+
+    public void clearAll(){
+        subscribeConfigMap.clear();
+        subscriberPointMap.clear();
+        subscriberPushCountMap.clear();
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeConst.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeConst.java
new file mode 100644
index 0000000..c5fe6b6
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeConst.java
@@ -0,0 +1,46 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:22
+ * WinBoLL Studio
+ * Java7 | API26-30
+ */
+public final class GpsSubscribeConst {
+	
+	// 新增：GPS定位推送广播
+	public static final String ACTION_GPS_LOCATION = "cc.winboll.studio.ACTION_GPS_LOCATION";
+
+    //订阅运行模式
+    public static final int SUB_TYPE_ALL = 1;
+    public static final int SUB_TYPE_STEP_DISTANCE = 2;
+
+    //原始数据订阅类型
+    public static final int SUBSCRIBE_TYPE_LOCATION = 1;
+    public static final int SUBSCRIBE_TYPE_SATELLITE = 2;
+    public static final int SUBSCRIBE_TYPE_NMEA = 3;
+
+    //订阅返回码
+    public static final int RESULT_SUCCESS = 0;
+    public static final int RESULT_PERMISSION_DENY = 1;
+    public static final int RESULT_PARAM_ERROR = 2;
+    public static final int RESULT_GPS_NOT_AVAILABLE = 3;
+    public static final int RESULT_SYSTEM_LIMIT = 4;
+
+    //GPS设备状态
+    public static final int GPS_STATE_CLOSE = 0;
+    public static final int GPS_STATE_SCANNING = 1;
+    public static final int GPS_STATE_LOCATED = 2;
+    public static final int GPS_STATE_SIGNAL_WEAK = 3;
+
+    //广播Action
+    public static final String ACTION_SUBSCRIBE_REQUEST = "cc.winboll.studio.GPS_SUBSCRIBE_REQUEST";
+    public static final String ACTION_SUBSCRIBE_CALLBACK = "cc.winboll.studio.GPS_SUBSCRIBE_CALLBACK";
+
+    //超时毫秒
+    public static final long SUBSCRIBE_TIME_OUT = 5000;
+
+    //地球半径 距离计算常量
+    public static final double EARTH_RADIUS = 6378137.0;
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeMsg.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeMsg.java
new file mode 100644
index 0000000..b10bea2
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeMsg.java
@@ -0,0 +1,137 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:24
+ */
+import android.os.Bundle;
+import android.os.Parcel;
+import android.os.Parcelable;
+
+public final class GpsSubscribeMsg implements Parcelable {
+
+    private final String subscribePackage;
+    private final int subscribeMode;
+    private final float stepDistanceM;
+
+    private final int subscribeType;
+    private final long updateInterval;
+    private final float minDistance;
+    private final boolean backgroundPush;
+    private final String subscribeUniqueId;
+
+    public GpsSubscribeMsg(String subscribePackage,
+                           int subscribeMode,
+                           float stepDistanceM,
+                           int subscribeType,
+                           long updateInterval,
+                           float minDistance,
+                           boolean backgroundPush,
+                           String subscribeUniqueId) {
+        this.subscribePackage = subscribePackage;
+        this.subscribeMode = subscribeMode;
+        this.stepDistanceM = stepDistanceM;
+        this.subscribeType = subscribeType;
+        this.updateInterval = updateInterval;
+        this.minDistance = minDistance;
+        this.backgroundPush = backgroundPush;
+        this.subscribeUniqueId = subscribeUniqueId;
+    }
+
+    public String getSubscribePackage() {
+        return subscribePackage;
+    }
+
+    public int getSubscribeMode() {
+        return subscribeMode;
+    }
+
+    public float getStepDistanceM() {
+        return stepDistanceM;
+    }
+
+    public int getSubscribeType() {
+        return subscribeType;
+    }
+
+    public long getUpdateInterval() {
+        return updateInterval;
+    }
+
+    public float getMinDistance() {
+        return minDistance;
+    }
+
+    public boolean isBackgroundPush() {
+        return backgroundPush;
+    }
+
+    public String getSubscribeUniqueId() {
+        return subscribeUniqueId;
+    }
+
+    @Override
+    public int describeContents() {
+        return 0;
+    }
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        dest.writeString(subscribePackage);
+        dest.writeInt(subscribeMode);
+        dest.writeFloat(stepDistanceM);
+        dest.writeInt(subscribeType);
+        dest.writeLong(updateInterval);
+        dest.writeFloat(minDistance);
+        dest.writeByte((byte) (backgroundPush ? 1 : 0));
+        dest.writeString(subscribeUniqueId);
+    }
+
+    public static final Creator<GpsSubscribeMsg> CREATOR = new Creator<GpsSubscribeMsg>() {
+        @Override
+        public GpsSubscribeMsg createFromParcel(Parcel in) {
+            return new GpsSubscribeMsg(
+				in.readString(),
+				in.readInt(),
+				in.readFloat(),
+				in.readInt(),
+				in.readLong(),
+				in.readFloat(),
+				in.readByte() == 1,
+				in.readString()
+            );
+        }
+
+        @Override
+        public GpsSubscribeMsg[] newArray(int size) {
+            return new GpsSubscribeMsg[size];
+        }
+    };
+
+    public Bundle convertToBundle() {
+        Bundle bundle = new Bundle();
+        bundle.putString("pkg", subscribePackage);
+        bundle.putInt("subMode",subscribeMode);
+        bundle.putFloat("stepM",stepDistanceM);
+        bundle.putInt("type", subscribeType);
+        bundle.putLong("interval", updateInterval);
+        bundle.putFloat("distance", minDistance);
+        bundle.putBoolean("bgPush", backgroundPush);
+        bundle.putString("sid", subscribeUniqueId);
+        return bundle;
+    }
+
+    public static GpsSubscribeMsg createByBundle(Bundle bundle) {
+        return new GpsSubscribeMsg(
+			bundle.getString("pkg"),
+			bundle.getInt("subMode"),
+			bundle.getFloat("stepM"),
+			bundle.getInt("type"),
+			bundle.getLong("interval"),
+			bundle.getFloat("distance"),
+			bundle.getBoolean("bgPush"),
+			bundle.getString("sid")
+        );
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeResult.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeResult.java
new file mode 100644
index 0000000..74888e5
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/GpsSubscribeResult.java
@@ -0,0 +1,115 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:25
+ */
+
+import android.os.Bundle;
+import android.os.Parcel;
+import android.os.Parcelable;
+
+public final class GpsSubscribeResult implements Parcelable {
+
+    private final String subscribeUniqueId;
+    private final int resultCode;
+    private final String resultDesc;
+    private final int gpsRunningState;
+    private final long realEffectiveInterval;
+    private final long currentTimeStamp;
+
+    public GpsSubscribeResult(String subscribeUniqueId,
+                              int resultCode,
+                              String resultDesc,
+                              int gpsRunningState,
+                              long realEffectiveInterval,
+                              long currentTimeStamp) {
+        this.subscribeUniqueId = subscribeUniqueId;
+        this.resultCode = resultCode;
+        this.resultDesc = resultDesc;
+        this.gpsRunningState = gpsRunningState;
+        this.realEffectiveInterval = realEffectiveInterval;
+        this.currentTimeStamp = currentTimeStamp;
+    }
+
+    public String getSubscribeUniqueId() {
+        return subscribeUniqueId;
+    }
+
+    public int getResultCode() {
+        return resultCode;
+    }
+
+    public String getResultDesc() {
+        return resultDesc;
+    }
+
+    public int getGpsRunningState() {
+        return gpsRunningState;
+    }
+
+    public long getRealEffectiveInterval() {
+        return realEffectiveInterval;
+    }
+
+    public long getCurrentTimeStamp() {
+        return currentTimeStamp;
+    }
+
+    @Override
+    public int describeContents() {
+        return 0;
+    }
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        dest.writeString(subscribeUniqueId);
+        dest.writeInt(resultCode);
+        dest.writeString(resultDesc);
+        dest.writeInt(gpsRunningState);
+        dest.writeLong(realEffectiveInterval);
+        dest.writeLong(currentTimeStamp);
+    }
+
+    public static final Creator<GpsSubscribeResult> CREATOR = new Creator<GpsSubscribeResult>() {
+        @Override
+        public GpsSubscribeResult createFromParcel(Parcel in) {
+            return new GpsSubscribeResult(
+				in.readString(),
+				in.readInt(),
+				in.readString(),
+				in.readInt(),
+				in.readLong(),
+				in.readLong()
+            );
+        }
+
+        @Override
+        public GpsSubscribeResult[] newArray(int size) {
+            return new GpsSubscribeResult[size];
+        }
+    };
+
+    public Bundle convertToBundle() {
+        Bundle bundle = new Bundle();
+        bundle.putString("sid", subscribeUniqueId);
+        bundle.putInt("code", resultCode);
+        bundle.putString("desc", resultDesc);
+        bundle.putInt("gpsState", gpsRunningState);
+        bundle.putLong("realInterval", realEffectiveInterval);
+        bundle.putLong("time", currentTimeStamp);
+        return bundle;
+    }
+
+    public static GpsSubscribeResult createByBundle(Bundle bundle) {
+        return new GpsSubscribeResult(
+			bundle.getString("sid"),
+			bundle.getInt("code"),
+			bundle.getString("desc"),
+			bundle.getInt("gpsState"),
+			bundle.getLong("realInterval"),
+			bundle.getLong("time")
+        );
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/LocationPoint.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/LocationPoint.java
new file mode 100644
index 0000000..8e86485
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/model/LocationPoint.java
@@ -0,0 +1,37 @@
+package cc.winboll.studio.libgpsrelaysentinel.model;
+
+import java.io.Serializable;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:23
+ * 订阅者基准定点坐标
+ * 每次推送成功自动更新
+ */
+public final class LocationPoint implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    private final double latitude;
+    private final double longitude;
+    private final long recordTime;
+
+    public LocationPoint(double latitude, double longitude, long recordTime) {
+        this.latitude = latitude;
+        this.longitude = longitude;
+        this.recordTime = recordTime;
+    }
+
+    public double getLatitude() {
+        return latitude;
+    }
+
+    public double getLongitude() {
+        return longitude;
+    }
+
+    public long getRecordTime() {
+        return recordTime;
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/receiver/GpsSubscribeObserverReceiver.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/receiver/GpsSubscribeObserverReceiver.java
new file mode 100644
index 0000000..31603d3
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/receiver/GpsSubscribeObserverReceiver.java
@@ -0,0 +1,42 @@
+package cc.winboll.studio.libgpsrelaysentinel.receiver;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:27
+ */
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeResult;
+
+public final class GpsSubscribeObserverReceiver extends BroadcastReceiver {
+
+    private OnSubscribeResultListener listener;
+
+    public void setOnSubscribeResultListener(OnSubscribeResultListener listener){
+        this.listener = listener;
+    }
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent.getAction();
+        if(GpsSubscribeConst.ACTION_SUBSCRIBE_CALLBACK.equals(action)){
+            GpsSubscribeResult result = intent.getParcelableExtra("data");
+            if(listener != null && result != null){
+                listener.onResultBack(result);
+            }
+        }
+    }
+
+    public interface OnSubscribeResultListener{
+        void onResultBack(GpsSubscribeResult result);
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/service/GpsSubscribeReceiverService.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/service/GpsSubscribeReceiverService.java
new file mode 100644
index 0000000..0dcfec9
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/service/GpsSubscribeReceiverService.java
@@ -0,0 +1,39 @@
+package cc.winboll.studio.libgpsrelaysentinel.service;
+
+import android.app.Service;
+import android.content.Intent;
+import android.os.IBinder;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+
+/**
+ * 全局消息接收父类服务
+ * 所有应用内接收服务全部继承此类
+ */
+public abstract class GpsSubscribeReceiverService extends Service {
+
+    public static final String TAG_PARENT = "GpsSubscribeReceiverService";
+
+    //当前绑定的视图订阅SID
+    protected String bindViewSid;
+
+    public void bindControlSid(String sid){
+        this.bindViewSid = sid;
+    }
+
+    /**
+     * 统一接收GPS推送入口
+     */
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config){
+        //父类统一日志溯源
+        LogUtils.d(TAG_PARENT,"【消息溯源】接收视图SID：" + bindViewSid);
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/util/TimeCountUtil.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/util/TimeCountUtil.java
new file mode 100644
index 0000000..b078b32
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/util/TimeCountUtil.java
@@ -0,0 +1,51 @@
+package cc.winboll.studio.libgpsrelaysentinel.util;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/05/07 10:26
+ */
+
+import android.os.Handler;
+import android.os.Message;
+
+public final class TimeCountUtil {
+
+    private final Handler mHandler;
+    private long totalTime;
+    private boolean isRunning;
+    public static final int COUNT_FINISH = 1001;
+
+    public TimeCountUtil(final OnCountListener listener) {
+        mHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                if(msg.what == COUNT_FINISH){
+                    isRunning = false;
+                    if(listener != null){
+                        listener.onTimeOut();
+                    }
+                }
+            }
+        };
+    }
+
+    public void start(long time){
+        if(isRunning){
+            return;
+        }
+        totalTime = time;
+        isRunning = true;
+        mHandler.sendEmptyMessageDelayed(COUNT_FINISH,totalTime);
+    }
+
+    public void cancel(){
+        mHandler.removeMessages(COUNT_FINISH);
+        isRunning = false;
+    }
+
+    public interface OnCountListener{
+        void onTimeOut();
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/view/GpsSubscribeControlView.java b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/view/GpsSubscribeControlView.java
new file mode 100644
index 0000000..732e614
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/view/GpsSubscribeControlView.java
@@ -0,0 +1,226 @@
+package cc.winboll.studio.libgpsrelaysentinel.view;
+
+import android.content.Context;
+import android.content.Intent;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.RadioButton;
+import android.widget.RadioGroup;
+import android.widget.Switch;
+import android.widget.TextView;
+
+import cc.winboll.studio.libgpsrelaysentinel.R;
+import cc.winboll.studio.libgpsrelaysentinel.manager.GpsSubscribeManager;
+import cc.winboll.studio.libgpsrelaysentinel.manager.SubscribeLocationManager;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
+import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
+
+import java.util.UUID;
+
+public final class GpsSubscribeControlView extends LinearLayout {
+
+    //常量抽取
+    private static final long REFRESH_INTERVAL = 600;
+
+    private RadioGroup rgSubscribeMode;
+    private RadioButton rbModeAll;
+    private RadioButton rbModeStep;
+    private EditText etStepMeter;
+    private Switch switchSubscribe;
+    private TextView tvSubscribeSid;
+    private TextView tvSubscribeRecord;
+
+    private String currentSubscribeSid;
+    //一对一专属绑定的接收服务
+    private Class<?> mBindReceiverServiceClazz;
+
+    //final管理器 构造器初始化
+    private final GpsSubscribeManager mSubscribeManager;
+    private final SubscribeLocationManager mLocationManager;
+
+    private final Handler mRefreshHandler = new Handler(Looper.getMainLooper());
+
+
+    public GpsSubscribeControlView(Context context) {
+        super(context);
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationManager = SubscribeLocationManager.getInstance();
+        initView(context);
+    }
+
+    public GpsSubscribeControlView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationManager = SubscribeLocationManager.getInstance();
+        initView(context);
+    }
+
+    private void initView(Context context) {
+        LayoutInflater.from(context).inflate(R.layout.view_gps_subscribe_control, this, true);
+
+        rgSubscribeMode = findViewById(R.id.rg_subscribe_mode);
+        rbModeAll = findViewById(R.id.rb_mode_all);
+        rbModeStep = findViewById(R.id.rb_mode_step);
+        etStepMeter = findViewById(R.id.et_step_meter);
+        switchSubscribe = findViewById(R.id.switch_subscribe);
+        tvSubscribeSid = findViewById(R.id.tv_subscribe_sid);
+        tvSubscribeRecord = findViewById(R.id.tv_subscribe_record);
+
+        initDefaultConfig();
+        initModeSwitch();
+        initSubscribeSwitch();
+        startAutoRefreshRecord();
+    }
+
+    private void initDefaultConfig() {
+        currentSubscribeSid = UUID.randomUUID().toString().substring(0, 16);
+        tvSubscribeSid.setText("订阅SID：" + currentSubscribeSid);
+        rbModeAll.setChecked(true);
+        etStepMeter.setText("10");
+    }
+
+    /**
+     * 外部绑定当前视图专属的接收服务Class
+     */
+    public void bindReceiverService(Class<?> serviceClazz){
+        this.mBindReceiverServiceClazz = serviceClazz;
+    }
+
+    private void initModeSwitch() {
+        rgSubscribeMode.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(RadioGroup group, int checkedId) {
+					etStepMeter.setVisibility(checkedId == R.id.rb_mode_step ? VISIBLE : GONE);
+				}
+			});
+    }
+
+    private void initSubscribeSwitch() {
+        switchSubscribe.setOnCheckedChangeListener(new android.widget.CompoundButton.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(android.widget.CompoundButton buttonView, boolean isChecked) {
+					if (isChecked) {
+						startSubscribe();
+					} else {
+						stopSubscribe();
+					}
+				}
+			});
+    }
+
+    private void startSubscribe() {
+        int subMode = GpsSubscribeConst.SUB_TYPE_ALL;
+        float stepVal = 10f;
+
+        if (rbModeStep.isChecked()) {
+            subMode = GpsSubscribeConst.SUB_TYPE_STEP_DISTANCE;
+            try {
+                stepVal = Float.parseFloat(etStepMeter.getText().toString().trim());
+            } catch (Exception ignored) {}
+        }
+
+        GpsSubscribeMsg subscribeMsg = new GpsSubscribeMsg(
+			getContext().getPackageName(),
+			subMode,
+			stepVal,
+			GpsSubscribeConst.SUBSCRIBE_TYPE_LOCATION,
+			1000,
+			1f,
+			true,
+			currentSubscribeSid
+        );
+
+        mSubscribeManager.addSubscribe(subscribeMsg);
+        mLocationManager.putSubscribeConfig(currentSubscribeSid, subscribeMsg);
+        mLocationManager.clearPushCount(currentSubscribeSid);
+
+        //开启订阅自动启动专属接收服务
+        if(mBindReceiverServiceClazz != null){
+            Intent startServiceIntent = new Intent(getContext(), mBindReceiverServiceClazz);
+            getContext().startService(startServiceIntent);
+        }
+    }
+
+    private void stopSubscribe() {
+        mSubscribeManager.removeSubscribe(currentSubscribeSid);
+        mLocationManager.removeSubscribe(currentSubscribeSid);
+        tvSubscribeRecord.setText("状态：未订阅");
+
+        //关闭订阅 同步停止专属接收服务
+        if(mBindReceiverServiceClazz != null){
+            Intent stopServiceIntent = new Intent(getContext(), mBindReceiverServiceClazz);
+            getContext().stopService(stopServiceIntent);
+        }
+    }
+
+    private void startAutoRefreshRecord() {
+        mRefreshHandler.postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					refreshRecordInfo();
+					mRefreshHandler.postDelayed(this, REFRESH_INTERVAL);
+				}
+			}, REFRESH_INTERVAL);
+    }
+
+    private void refreshRecordInfo() {
+        if (!switchSubscribe.isChecked()) {
+            tvSubscribeRecord.setText("状态：空闲未订阅");
+            return;
+        }
+
+        GpsSubscribeMsg config = mLocationManager.getSubscribeConfig(currentSubscribeSid);
+        LocationPoint lastPoint = mLocationManager.getLastPoint(currentSubscribeSid);
+
+        if (config == null) {
+            tvSubscribeRecord.setText("状态：已订阅｜等待管理器加载");
+            return;
+        }
+
+        String modeText = config.getSubscribeMode() == GpsSubscribeConst.SUB_TYPE_ALL
+			? "全量订阅" : "步长订阅";
+
+        int realPushCount = mLocationManager.getPushCount(currentSubscribeSid);
+
+        StringBuilder record = new StringBuilder();
+        record.append("【订阅实时数据表】\n");
+        record.append("订阅模式：").append(modeText).append("\n");
+        record.append("步长阈值：").append(config.getStepDistanceM()).append(" 米\n");
+
+        if(lastPoint != null){
+            record.append("基准定点：").append(lastPoint.getLatitude()).append(" , ").append(lastPoint.getLongitude()).append("\n");
+        }else{
+            record.append("基准定点：等待首次定位建立\n");
+        }
+
+        record.append("真实推送次数：").append(realPushCount).append(" 次");
+
+        tvSubscribeRecord.setText(record);
+    }
+
+    public String getCurrentSid() {
+        return currentSubscribeSid;
+    }
+
+    public boolean isSubscribeOpen() {
+        return switchSubscribe.isChecked();
+    }
+
+    /**
+     * 视图销毁：强制停止订阅 + 停止服务 + 清空刷新任务
+     */
+    @Override
+    protected void onDetachedFromWindow() {
+        if(switchSubscribe.isChecked()){
+            switchSubscribe.setChecked(false);
+        }
+        mRefreshHandler.removeCallbacksAndMessages(null);
+        super.onDetachedFromWindow();
+    }
+}
+
diff --git a/libgpsrelaysentinel/src/main/res/drawable-hdpi/ic_launcher.png b/libgpsrelaysentinel/src/main/res/drawable-hdpi/ic_launcher.png
new file mode 100644
index 0000000..96a442e
Binary files /dev/null and b/libgpsrelaysentinel/src/main/res/drawable-hdpi/ic_launcher.png differ
diff --git a/libgpsrelaysentinel/src/main/res/drawable-mdpi/ic_launcher.png b/libgpsrelaysentinel/src/main/res/drawable-mdpi/ic_launcher.png
new file mode 100644
index 0000000..359047d
Binary files /dev/null and b/libgpsrelaysentinel/src/main/res/drawable-mdpi/ic_launcher.png differ
diff --git a/libgpsrelaysentinel/src/main/res/drawable-xhdpi/ic_launcher.png b/libgpsrelaysentinel/src/main/res/drawable-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..71c6d76
Binary files /dev/null and b/libgpsrelaysentinel/src/main/res/drawable-xhdpi/ic_launcher.png differ
diff --git a/libgpsrelaysentinel/src/main/res/drawable-xxhdpi/ic_launcher.png b/libgpsrelaysentinel/src/main/res/drawable-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..4df1894
Binary files /dev/null and b/libgpsrelaysentinel/src/main/res/drawable-xxhdpi/ic_launcher.png differ
diff --git a/libgpsrelaysentinel/src/main/res/layout/view_gps_subscribe_control.xml b/libgpsrelaysentinel/src/main/res/layout/view_gps_subscribe_control.xml
new file mode 100644
index 0000000..86f3437
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/res/layout/view_gps_subscribe_control.xml
@@ -0,0 +1,83 @@
+<?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="14dp"
+    android:layout_marginVertical="6dp"
+    android:background="#282828"
+    android:clipToPadding="false">
+
+    <!-- SID标识 -->
+    <TextView
+        android:id="@+id/tv_subscribe_sid"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textColor="#999999"
+        android:textSize="11sp"/>
+
+    <!-- 订阅模式选择 -->
+    <RadioGroup
+        android:id="@+id/rg_subscribe_mode"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:layout_marginTop="8dp">
+
+        <RadioButton
+            android:id="@+id/rb_mode_all"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="全量订阅"
+            android:textColor="#FFFFFF"/>
+
+        <RadioButton
+            android:id="@+id/rb_mode_step"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="步长订阅"
+            android:layout_marginStart="18dp"
+            android:textColor="#FFFFFF"/>
+    </RadioGroup>
+
+    <!-- 步长输入 -->
+    <EditText
+        android:id="@+id/et_step_meter"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="移动阈值(米)"
+        android:inputType="numberDecimal"
+        android:text="10"
+        android:visibility="gone"
+        android:textColor="#ffffff"
+        android:textColorHint="#666666"
+        android:layout_marginTop="8dp"/>
+
+    <!-- 订阅开关 -->
+    <Switch
+        android:id="@+id/switch_subscribe"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="开启独立订阅"
+        android:textColor="#EEEEEE"
+        android:layout_marginTop="10dp"/>
+
+    <!-- 分割线 -->
+    <View
+        android:layout_width="match_parent"
+        android:layout_height="1px"
+        android:background="#444444"
+        android:layout_marginTop="12dp"/>
+
+    <!-- 订阅数据记录表【ID完全对应源码 tv_subscribe_record】 -->
+    <TextView
+        android:id="@+id/tv_subscribe_record"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textColor="#88EE88"
+        android:textSize="10sp"
+        android:layout_marginTop="10dp"
+        android:gravity="start"/>
+
+</LinearLayout>
+
diff --git a/libgpsrelaysentinel/src/main/res/values-v21/styles.xml b/libgpsrelaysentinel/src/main/res/values-v21/styles.xml
new file mode 100644
index 0000000..0948fdc
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/res/values-v21/styles.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Material.Light">
+	</style>
+</resources>
\ No newline at end of file
diff --git a/libgpsrelaysentinel/src/main/res/values/strings.xml b/libgpsrelaysentinel/src/main/res/values/strings.xml
new file mode 100644
index 0000000..7d1f811
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/res/values/strings.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libdebugtemp</string>
+    <string name="hello_world">Hello world!</string>
+    <string name="text_libraryactivity">LibraryActivity</string>
+
+</resources>
diff --git a/libgpsrelaysentinel/src/main/res/values/styles.xml b/libgpsrelaysentinel/src/main/res/values/styles.xml
new file mode 100644
index 0000000..8d78246
--- /dev/null
+++ b/libgpsrelaysentinel/src/main/res/values/styles.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Holo.Light">
+	</style>
+</resources>
\ No newline at end of file
diff --git a/libwinboll/.gitignore b/libwinboll/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/libwinboll/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/libwinboll/build.gradle b/libwinboll/build.gradle
new file mode 100644
index 0000000..75e82de
--- /dev/null
+++ b/libwinboll/build.gradle
@@ -0,0 +1,42 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven-publish'
+apply from: '../.winboll/winboll_lib_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+
+    defaultConfig {
+        minSdkVersion 26
+        targetSdkVersion 30
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	// Gson
+	api 'com.google.code.gson:gson:2.8.9'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+	// 添加JSch依赖（SFTP核心，com.jcraft:jsch:0.1.54）
+	api 'com.jcraft:jsch:0.1.54'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.20.3'
+    api 'cc.winboll.studio:libappbase:15.20.9'
+	
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/libwinboll/build.properties b/libwinboll/build.properties
new file mode 100644
index 0000000..cc56cae
--- /dev/null
+++ b/libwinboll/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Wed May 13 13:48:00 CST 2026
+stageCount=2
+libraryProject=libwinboll
+baseVersion=15.20
+publishVersion=15.20.1
+buildCount=2
+baseBetaVersion=15.20.2
diff --git a/libwinboll/proguard-rules.pro b/libwinboll/proguard-rules.pro
new file mode 100644
index 0000000..536058a
--- /dev/null
+++ b/libwinboll/proguard-rules.pro
@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:/tools/adt-bundle-windows-x86_64-20131030/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
diff --git a/libwinboll/src/main/AndroidManifest.xml b/libwinboll/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..2323080
--- /dev/null
+++ b/libwinboll/src/main/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.libwinboll" >
+
+    <application>
+        <activity
+            android:name=".WinBoLLLibraryActivity">
+        </activity>
+    </application>
+
+</manifest>
+
diff --git a/libwinboll/src/main/java/cc/winboll/studio/libwinboll/WinBoLLLibraryActivity.java b/libwinboll/src/main/java/cc/winboll/studio/libwinboll/WinBoLLLibraryActivity.java
new file mode 100644
index 0000000..bb86ae9
--- /dev/null
+++ b/libwinboll/src/main/java/cc/winboll/studio/libwinboll/WinBoLLLibraryActivity.java
@@ -0,0 +1,17 @@
+package cc.winboll.studio.libwinboll;
+
+import android.app.Activity;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class WinBoLLLibraryActivity extends Activity 
+{
+    @Override
+    protected void onCreate(Bundle savedInstanceState)
+    {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_winbolllibrary);
+		
+		ToastUtils.show("WinBoLLLibraryActivity onCreate");
+    }
+}
diff --git a/libwinboll/src/main/res/drawable-hdpi/ic_launcher.png b/libwinboll/src/main/res/drawable-hdpi/ic_launcher.png
new file mode 100644
index 0000000..96a442e
Binary files /dev/null and b/libwinboll/src/main/res/drawable-hdpi/ic_launcher.png differ
diff --git a/libwinboll/src/main/res/drawable-mdpi/ic_launcher.png b/libwinboll/src/main/res/drawable-mdpi/ic_launcher.png
new file mode 100644
index 0000000..359047d
Binary files /dev/null and b/libwinboll/src/main/res/drawable-mdpi/ic_launcher.png differ
diff --git a/libwinboll/src/main/res/drawable-xhdpi/ic_launcher.png b/libwinboll/src/main/res/drawable-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..71c6d76
Binary files /dev/null and b/libwinboll/src/main/res/drawable-xhdpi/ic_launcher.png differ
diff --git a/libwinboll/src/main/res/drawable-xxhdpi/ic_launcher.png b/libwinboll/src/main/res/drawable-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..4df1894
Binary files /dev/null and b/libwinboll/src/main/res/drawable-xxhdpi/ic_launcher.png differ
diff --git a/libwinboll/src/main/res/layout/activity_winbolllibrary.xml b/libwinboll/src/main/res/layout/activity_winbolllibrary.xml
new file mode 100644
index 0000000..97dc11a
--- /dev/null
+++ b/libwinboll/src/main/res/layout/activity_winbolllibrary.xml
@@ -0,0 +1,11 @@
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:gravity="center">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="cc.winboll.studio.libwinboll.WinBoLLLibraryActivity"/>
+
+</LinearLayout>
diff --git a/libwinboll/src/main/res/values-v21/styles.xml b/libwinboll/src/main/res/values-v21/styles.xml
new file mode 100644
index 0000000..0948fdc
--- /dev/null
+++ b/libwinboll/src/main/res/values-v21/styles.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Material.Light">
+	</style>
+</resources>
\ No newline at end of file
diff --git a/libwinboll/src/main/res/values/strings.xml b/libwinboll/src/main/res/values/strings.xml
new file mode 100644
index 0000000..b677aa6
--- /dev/null
+++ b/libwinboll/src/main/res/values/strings.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="lib_name">libwinboll</string>
+    <string name="hello_world">Hello world!</string>
+
+</resources>
diff --git a/libwinboll/src/main/res/values/styles.xml b/libwinboll/src/main/res/values/styles.xml
new file mode 100644
index 0000000..8d78246
--- /dev/null
+++ b/libwinboll/src/main/res/values/styles.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="@android:style/Theme.Holo.Light">
+	</style>
+</resources>
\ No newline at end of file
diff --git a/local.properties-demo b/local.properties-demo
new file mode 100644
index 0000000..1fc1081
--- /dev/null
+++ b/local.properties-demo
@@ -0,0 +1,8 @@
+## This file must *NOT* be checked into Version Control Systems,
+# as it contains information specific to your local configuration.
+#
+# Location of the SDK. This is only used by Gradle.
+# For customization when using a Version Control System, please read the
+# header note.
+#Sat Apr 27 01:35:26 CST 2024
+#sdk.dir=
diff --git a/mymessagemanager/.gitignore b/mymessagemanager/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/mymessagemanager/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/mymessagemanager/README.md b/mymessagemanager/README.md
new file mode 100644
index 0000000..b17ab1d
--- /dev/null
+++ b/mymessagemanager/README.md
@@ -0,0 +1,45 @@
+# MyMessageManager
+
+#### 介绍
+用正则表达式方法自定义短信过滤和语音播报的短信应用。
+
+#### 软件架构
+软件架构说明
+
+
+#### 安装教程
+
+1.  xxxx
+2.  xxxx
+3.  xxxx
+
+#### 使用说明
+
+1.  xxxx
+2.  xxxx
+3.  xxxx
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码：ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
+
+使用GitHub Actions实现Android自动打包apk
+https://blog.csdn.net/ZZL23333/article/details/115798615?app_version=6.0.0&code=app_1562916241&csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22115798615%22%2C%22source%22%3A%22weixin_38986226%22%7D&uLinkId=usr1mkqgl919blen&utm_source=app
+
+Android中assets的使用（用于读取内容）
+https://blog.csdn.net/qq_27664947/article/details/103924058?app_version=6.0.0&code=app_1562916241&csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22103924058%22%2C%22source%22%3A%22weixin_38986226%22%7D&uLinkId=usr1mkqgl919blen&utm_source=app
diff --git a/mymessagemanager/app_update_description.txt b/mymessagemanager/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/mymessagemanager/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/mymessagemanager/build.gradle b/mymessagemanager/build.gradle
new file mode 100644
index 0000000..f7029bf
--- /dev/null
+++ b/mymessagemanager/build.gradle
@@ -0,0 +1,91 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+
+    compileSdkVersion 30
+
+    buildToolsVersion "30.0.3"
+	
+	compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_7
+        targetCompatibility JavaVersion.VERSION_1_7
+    }
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.mymessagemanager"
+        minSdkVersion 26
+        targetSdkVersion 30
+        versionCode 8
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.12" 
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+	
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+}
+
+dependencies {
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //api 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+	
+	api 'io.github.medyo:android-about-page:2.0.0'
+    api 'com.jcraft:jsch:0.1.55'
+    api 'org.jsoup:jsoup:1.13.1'
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+	
+	api 'com.belerweb:pinyin4j:2.5.1'
+    
+    // 权限请求框架：https://github.com/getActivity/XXPermissions
+    api 'com.github.getActivity:XXPermissions:18.63'
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // AndroidX 类库
+    api 'androidx.appcompat:appcompat:1.1.0'
+    api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'
+    api 'com.google.android.material:material:1.0.0'
+	
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.9'
+    api 'cc.winboll.studio:libappbase:15.15.21'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.12.9'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.14.1'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/mymessagemanager/build.properties b/mymessagemanager/build.properties
new file mode 100644
index 0000000..5a90477
--- /dev/null
+++ b/mymessagemanager/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Sat May 09 14:21:58 HKT 2026
+stageCount=12
+libraryProject=
+baseVersion=15.12
+publishVersion=15.12.11
+buildCount=0
+baseBetaVersion=15.12.12
diff --git a/mymessagemanager/proguard-rules.pro b/mymessagemanager/proguard-rules.pro
new file mode 100644
index 0000000..855b18a
--- /dev/null
+++ b/mymessagemanager/proguard-rules.pro
@@ -0,0 +1,143 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+# ============================== 必要补充规则 ==============================
+# OkHttp 4.4.1 补充规则（Java 7 兼容）
+-keep class okhttp3.internal.concurrent.** { *; }
+-keep class okhttp3.internal.connection.** { *; }
+-dontwarn okhttp3.internal.concurrent.TaskRunner
+-dontwarn okhttp3.internal.connection.RealCall
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/mymessagemanager/src/beta/AndroidManifest.xml b/mymessagemanager/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..522ecec
--- /dev/null
+++ b/mymessagemanager/src/beta/AndroidManifest.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="cc.winboll.studio.mymessagemanager.beta.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+        
+    </application>
+
+</manifest>
+
diff --git a/mymessagemanager/src/beta/res/values-zh/strings.xml b/mymessagemanager/src/beta/res/values-zh/strings.xml
new file mode 100644
index 0000000..ffbc3e5
--- /dev/null
+++ b/mymessagemanager/src/beta/res/values-zh/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">我的短信管家 ☆</string>
+    
+</resources>
diff --git a/mymessagemanager/src/beta/res/values/strings.xml b/mymessagemanager/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..085d3ca
--- /dev/null
+++ b/mymessagemanager/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">My Message Manager +</string>
+
+</resources>
diff --git a/mymessagemanager/src/main/AndroidManifest.xml b/mymessagemanager/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..34e6aac
--- /dev/null
+++ b/mymessagemanager/src/main/AndroidManifest.xml
@@ -0,0 +1,227 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.mymessagemanager">
+
+    <!-- 发送短信 -->
+    <uses-permission android:name="android.permission.SEND_SMS"/>
+
+    <!-- 接收讯息（短信） -->
+    <uses-permission android:name="android.permission.RECEIVE_SMS"/>
+
+    <!-- 读取短信 -->
+    <uses-permission android:name="android.permission.READ_SMS"/>
+
+    <!-- WRITE_SMS -->
+    <uses-permission android:name="android.permission.WRITE_SMS"/>
+
+    <!-- 接收讯息（彩信） -->
+    <uses-permission android:name="android.permission.RECEIVE_MMS"/>
+
+    <!-- 开机启动 -->
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+
+    <!-- 运行前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <!-- 读取联系人 -->
+    <uses-permission android:name="android.permission.READ_CONTACTS"/>
+
+    <!-- 读取您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <!-- 修改或删除您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <!-- 接收讯息 (WAP) -->
+    <uses-permission android:name="android.permission.RECEIVE_WAP_PUSH"/>
+
+    <!-- MANAGE_EXTERNAL_STORAGE -->
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <!-- 此应用可显示在其他应用上方 -->
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
+
+    <queries>
+
+        <intent>
+
+            <action android:name="android.intent.action.TTS_SERVICE"/>
+
+        </intent>
+
+    </queries>
+
+    <application
+        android:name=".App"
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:roundIcon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:persistent="true"
+        android:resizeableActivity="true"
+        android:supportsRtl="true"
+        android:requestLegacyExternalStorage="true"
+        android:networkSecurityConfig="@xml/network_security_config">
+
+        <activity android:name=".activitys.SMSActivity"/>
+
+        <activity android:name=".activitys.SMSReceiveRuleActivity">
+
+        </activity>
+
+        <activity
+            android:name=".activitys.SharedJSONReceiveActivity"
+            android:exported="true">
+
+            <intent-filter>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+                <action android:name="android.intent.action.SEND"/>
+
+                <action android:name="android.intent.action.VIEW"/>
+
+                <action android:name="android.intent.action.EDIT"/>
+
+                <data android:mimeType="application/json"/>
+
+                <data android:mimeType="text/x-json"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity android:name=".activitys.TTSPlayRuleActivity"/>
+
+        <activity android:name=".activitys.AboutActivity"/>
+
+        <activity
+            android:name=".activitys.MainActivity"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity
+            android:name=".activitys.ComposeSMSActivity"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.SEND"/>
+
+                <action android:name="android.intent.action.SENDTO"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+                <category android:name="android.intent.category.BROWSABLE"/>
+
+                <data android:scheme="sms"/>
+
+                <data android:scheme="smsto"/>
+
+                <data android:scheme="mms"/>
+
+                <data android:scheme="mmsto"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity android:name=".activitys.AppSettingsActivity"/>
+
+        <service android:name=".services.TTSPlayService"/>
+
+        <service android:name=".services.MainService"/>
+
+        <service android:name=".services.AssistantService"/>
+
+        <service
+            android:name=".services.DefaultSMSManagerService"
+            android:permission="android.permission.SEND_RESPOND_VIA_MESSAGE"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.RESPOND_VIA_MESSAGE"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+                <data android:scheme="sms"/>
+
+                <data android:scheme="smsto"/>
+
+                <data android:scheme="mms"/>
+
+                <data android:scheme="mmsto"/>
+
+            </intent-filter>
+
+        </service>
+
+        <receiver
+            android:name=".receivers.MainReceiver"
+            android:enabled="true"
+            android:exported="false"
+            android:directBootAware="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.BOOT_COMPLETED"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <receiver
+            android:name=".receivers.SMSRecevier"
+            android:exported="true"
+            android:permission="android.permission.BROADCAST_SMS">
+
+            <intent-filter android:priority="1">
+
+                <action android:name="android.provider.Telephony.SMS_DELIVER"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <receiver
+            android:name=".receivers.MmsReceiver"
+            android:exported="true"
+            android:permission="android.permission.BROADCAST_WAP_PUSH">
+
+            <intent-filter>
+
+                <action android:name="android.provider.Telephony.WAP_PUSH_DELIVER"/>
+
+                <data android:mimeType="application/vnd.wap.mms-message"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name="cc.winboll.studio.mymessagemanager.activitys.SMSRecycleActivity"/>
+
+        <activity android:name="cc.winboll.studio.mymessagemanager.activitys.SMSRecycle2Activity"/>
+
+        <activity android:name="cc.winboll.studio.mymessagemanager.unittest.UnitTestActivity"/>
+
+        <activity android:name="cc.winboll.studio.mymessagemanager.activitys.TTSFloatSettingsActivity"/>
+
+    </application>
+
+</manifest>
\ No newline at end of file
diff --git a/mymessagemanager/src/main/assets/GlobalApplication/SMSAcceptRuleBean_List.json b/mymessagemanager/src/main/assets/GlobalApplication/SMSAcceptRuleBean_List.json
new file mode 100644
index 0000000..b7fdefe
--- /dev/null
+++ b/mymessagemanager/src/main/assets/GlobalApplication/SMSAcceptRuleBean_List.json
@@ -0,0 +1,7 @@
+[
+  {
+    "userId": -1,
+    "ruleData": ".*",
+    "isEnable": true
+  }
+]
\ No newline at end of file
diff --git a/mymessagemanager/src/main/assets/GlobalApplication/TTSPlayRuleBean_List.json b/mymessagemanager/src/main/assets/GlobalApplication/TTSPlayRuleBean_List.json
new file mode 100644
index 0000000..8c9f761
--- /dev/null
+++ b/mymessagemanager/src/main/assets/GlobalApplication/TTSPlayRuleBean_List.json
@@ -0,0 +1,38 @@
+[
+  {
+    "userId": 1,
+    "ruleName": "规则1",
+    "demoSMSText": "【短信应用A】验证码123456",
+    "patternText": "^(【.*】)验证码(\\d)(\\d)(\\d)(\\d)(\\d)(\\d)$",
+    "ttdRuleText": "$1验证码是($2)($3)($4)($5)($6)($7)。",
+    "isSimpleView": false,
+    "isEnable": true
+  },
+  {
+    "userId": 1,
+    "ruleName": "规则2",
+    "demoSMSText": "[短信应用A]验证码123456",
+    "patternText": "^(\\[.*\\])验证码(\\d)(\\d)(\\d)(\\d)(\\d)(\\d)$",
+    "ttdRuleText": "$1验证码是($2)($3)($4)($5)($6)($7)。",
+    "isSimpleView": false,
+    "isEnable": true
+  },
+  {
+    "userId": 1,
+    "ruleName": "规则3",
+    "demoSMSText": "【短信应用A】验证码123456",
+    "patternText": ".*(【.+】).*",
+    "ttdRuleText": "短信来自$1。",
+    "isSimpleView": false,
+    "isEnable": true
+  },
+  {
+    "userId": 1,
+    "ruleName": "规则4",
+    "demoSMSText": "[短信应用A]验证码123456",
+    "patternText": ".*(\\[.*\\]).*",
+    "ttdRuleText": "短信来自$1。",
+    "isSimpleView": false,
+    "isEnable": true
+  }
+]
\ No newline at end of file
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/App.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/App.java
new file mode 100644
index 0000000..c741d31
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/App.java
@@ -0,0 +1,52 @@
+package cc.winboll.studio.mymessagemanager;
+
+/**
+ * @Author ZhanGSKen@QQ.COM
+ * @Date 2023/07/24 01:46:59
+ * @Describe 全局应用类
+ */
+import android.view.Gravity;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import java.io.File;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+
+public class App extends GlobalApplication {
+
+    public static final String TAG = "GlobalApplication";
+
+    static String _mszAppExternalFilesDir;
+    static String _mszConfigUtilFileName = "ConfigUtil.json";
+    static String _mszConfigUtilPath;
+    static String _mszSMSReceiveRuleUtilFileName = "SMSReceiveRuleUtil.json";
+    static String _mszSMSReceiveRuleUtilPath;
+
+    public static final int USER_ID = -1;
+    Long mszVersionName = 1L;
+    Long mszDataVersionName = 1L;
+
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+		setIsDebugging(BuildConfig.DEBUG);
+		//setIsDebugging(false);
+
+		// 初始化窗口管理类
+		WinBoLLActivityManager.init(this);
+
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+
+        _mszAppExternalFilesDir = getExternalFilesDir(TAG).toString();
+        _mszConfigUtilPath = _mszAppExternalFilesDir + File.separator + _mszConfigUtilFileName;
+        _mszSMSReceiveRuleUtilPath = _mszAppExternalFilesDir + File.separator + _mszSMSReceiveRuleUtilFileName;
+    }
+
+	@Override
+	public void onTerminate() {
+		super.onTerminate();
+		ToastUtils.release();
+	}
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/AboutActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/AboutActivity.java
new file mode 100644
index 0000000..0c64054
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/AboutActivity.java
@@ -0,0 +1,52 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+
+public class AboutActivity extends AppCompatActivity {
+
+    public static final String TAG = "AboutActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                finish();
+            }
+        });
+
+        AboutView aboutView = findViewById(R.id.aboutview);
+        aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+    private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "mymessagemanager";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName("MyMessageManager");
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=MyMessageManager");
+        appInfo.setAppAPKName("MyMessageManager");
+        appInfo.setAppAPKFolderName("MyMessageManager");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/AppSettingsActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/AppSettingsActivity.java
new file mode 100644
index 0000000..870ce80
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/AppSettingsActivity.java
@@ -0,0 +1,170 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/12 20:03:42
+ * @Describe 应用设置窗口
+ */
+import android.app.Activity;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.provider.Settings;
+import android.view.View;
+import android.widget.EditText;
+import android.widget.RadioButton;
+import android.widget.RadioGroup;
+import android.widget.Switch;
+import android.widget.Toast;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.libaes.views.AToolbar;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.dialogs.CharsetRefuseEditDialog;
+import cc.winboll.studio.mymessagemanager.utils.AppConfigUtil;
+import cc.winboll.studio.mymessagemanager.utils.PermissionUtil;
+
+public class AppSettingsActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "AppSettingsActivity";
+
+	// 讯飞语记官网下载页链接
+	private static final String XUNFEI_YUJI_DOWNLOAD_URL = "https://iflynote.com/h/share-download-app.html";
+
+    AppConfigUtil mAppConfigUtil;
+    AToolbar mAToolbar;
+    AOHPCTCSeekBar mAOHPCTCSeekBar;
+    EditText metTTSPlayDelayTimes;
+    EditText metPhoneMergePrefix;
+    Switch mswMergePrefixPhone;
+    Switch mswSMSRecycleProtectMode;
+    //EditText metProtectModerRefuseChars;
+    EditText metProtectModerReplaceChars;
+	String mszProtectModerRefuseChars = "";
+    RadioGroup mRadioGroupRecycleBin;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_appsettings);
+
+        // 初始化属性
+        mAppConfigUtil = AppConfigUtil.getInstance(this);
+        int nTtsPlayDelayTimes = mAppConfigUtil.mAppConfigBean.getTtsPlayDelayTimes();
+        metTTSPlayDelayTimes = findViewById(R.id.activityappsettingsEditText1);
+        metTTSPlayDelayTimes.setText(Integer.toString(nTtsPlayDelayTimes / 1000));
+
+        // 初始化标题栏
+        mAToolbar = findViewById(R.id.activityappsettingsAToolbar1);
+        mAToolbar.setSubtitle(getString(R.string.activity_name_appsettings));
+        setActionBar(mAToolbar);
+
+        metPhoneMergePrefix = findViewById(R.id.activityappsettingsEditText2);
+        metPhoneMergePrefix.setText(mAppConfigUtil.mAppConfigBean.getCountryCode());
+
+        mswMergePrefixPhone = findViewById(R.id.activityappsettingsSwitch1);
+        mswMergePrefixPhone.setChecked(mAppConfigUtil.mAppConfigBean.isMergeCountryCodePrefix());
+
+        mswSMSRecycleProtectMode = findViewById(R.id.activityappsettingsSwitch3);
+        mswSMSRecycleProtectMode.setChecked(mAppConfigUtil.mAppConfigBean.isSMSRecycleProtectMode());
+
+        //metProtectModerRefuseChars = findViewById(R.id.activityappsettingsEditText3);
+        //metProtectModerRefuseChars.setText(mAppConfigUtil.mAppConfigBean.getProtectModerRefuseChars());
+		mszProtectModerRefuseChars = mAppConfigUtil.mAppConfigBean.getProtectModerRefuseChars();
+
+        metProtectModerReplaceChars = findViewById(R.id.activityappsettingsEditText4);
+        metProtectModerReplaceChars.setText(mAppConfigUtil.mAppConfigBean.getProtectModerReplaceChars());
+
+        mRadioGroupRecycleBin = findViewById(R.id.activityappsettingsRadioGroup1);
+        if (mAppConfigUtil.mAppConfigBean.getRecycleBinClass().equals("SMSRecycle2Activity")) {
+            mRadioGroupRecycleBin.check(R.id.activityappsettingsRadioButton2);
+        } else {
+            mRadioGroupRecycleBin.check(R.id.activityappsettingsRadioButton1);
+        }
+
+        mAOHPCTCSeekBar = findViewById(R.id.activityappsettingsAOHPCTCSeekBar1);
+        mAOHPCTCSeekBar.setThumb(getDrawable(R.drawable.cursor_pointer));
+        mAOHPCTCSeekBar.setThumbOffset(0);
+        mAOHPCTCSeekBar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener(){
+
+                @Override
+                public void onOHPCommit() {
+                    mAppConfigUtil.reLoadConfig();
+                    mAppConfigUtil.mAppConfigBean.setIsSMSRecycleProtectMode(mswSMSRecycleProtectMode.isChecked());
+                    if (mRadioGroupRecycleBin.getCheckedRadioButtonId() == R.id.activityappsettingsRadioButton2) {
+                        mAppConfigUtil.mAppConfigBean.setRecycleBinClass("SMSRecycle2Activity");
+                    } else {
+                        mAppConfigUtil.mAppConfigBean.setRecycleBinClass("SMSRecycleActivity");
+                    }
+                    //mAppConfigUtil.mAppConfigBean.setProtectModerRefuseChars(metProtectModerRefuseChars.getText().toString());
+                    mAppConfigUtil.mAppConfigBean.setProtectModerRefuseChars(mszProtectModerRefuseChars);
+                    mAppConfigUtil.mAppConfigBean.setProtectModerReplaceChars(metProtectModerReplaceChars.getText().toString());
+                    mAppConfigUtil.mAppConfigBean.setCountryCode(metPhoneMergePrefix.getText().toString());
+                    mAppConfigUtil.mAppConfigBean.setIsMergeCountryCodePrefix(mswMergePrefixPhone.isChecked());
+                    int nTtsPlayDelayTimes = 1000 * Integer.parseInt(metTTSPlayDelayTimes.getText().toString());
+                    mAppConfigUtil.mAppConfigBean.setTtsPlayDelayTimes(nTtsPlayDelayTimes);
+                    mAppConfigUtil.saveConfig();
+                    Toast.makeText(getApplication(), "App config data is saved.", Toast.LENGTH_SHORT).show();
+                    //LogUtils.d(TAG, "TTS Play Delay Times is setting to : " + Integer.toString(mAppConfigData.getTtsPlayDelayTimes()));Toast.makeText(getApplication(), "onOHPCommit", Toast.LENGTH_SHORT).show();
+                }
+            });
+    };
+
+    public void onOpenSystemDefaultAppSettings(View view) {
+        Intent intent = new Intent(Settings.ACTION_MANAGE_DEFAULT_APPS_SETTINGS);
+        startActivity(intent);
+    }
+
+    public void onCheckAndGetAppPermission(View view) {
+        //LogUtils.d(TAG, "onCheckAndGetAppPermission");
+        if (PermissionUtil.checkAndGetAppPermission(this)) {
+            Toast.makeText(getApplication(), "应用已获得所需权限。", Toast.LENGTH_SHORT).show();
+        }
+    }
+
+    public void onAddTTSSupport(View view) {
+		try {
+			// 1. 创建Intent，Action为“打开网页”
+			Intent intent = new Intent(Intent.ACTION_VIEW);
+			// 2. 设置要跳转的URL
+			intent.setData(Uri.parse(XUNFEI_YUJI_DOWNLOAD_URL));
+			// 3. 确保Intent可被解析（避免无浏览器时崩溃）
+			if (intent.resolveActivity(getPackageManager()) != null) {
+				startActivity(intent); // 跳转至浏览器打开下载页
+			} else {
+				// 无浏览器时的提示
+				Toast.makeText(this, "未找到浏览器应用，请安装后重试", Toast.LENGTH_SHORT).show();
+			}
+		} catch (Exception e) {
+			e.printStackTrace();
+			Toast.makeText(this, "无法打开下载页面，请稍后再试", Toast.LENGTH_SHORT).show();
+		}
+    }
+
+	public void onCharsetRefuseEditDialog(View view) {
+		CharsetRefuseEditDialog dlg = new CharsetRefuseEditDialog(this, new CharsetRefuseEditDialog.OnTextConfirmListener(){
+				@Override
+				public void onTextConfirmed(String editText) {
+					//ToastUtils.show(editText);
+					mszProtectModerRefuseChars = editText;
+				}
+			}, mszProtectModerRefuseChars);
+		dlg.show();
+	}
+
+	public void onTTSFloatSettingsActivity(View view) {
+		Intent intent = new Intent(this, TTSFloatSettingsActivity.class);
+		startActivity(intent);
+	}
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/ComposeSMSActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/ComposeSMSActivity.java
new file mode 100644
index 0000000..7ca5316
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/ComposeSMSActivity.java
@@ -0,0 +1,368 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/08/30 14:32
+ * @Describe 联系人查询与短信发送窗口
+ */
+import android.content.Intent;
+import android.graphics.drawable.Drawable;
+import android.os.Bundle;
+import android.text.Editable;
+import android.text.TextWatcher;
+import android.view.View;
+import android.widget.AdapterView;
+import android.widget.EditText;
+import android.widget.ListView;
+import android.widget.RelativeLayout;
+import android.widget.SimpleAdapter;
+import android.widget.TextView;
+import android.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.beans.PhoneBean;
+import cc.winboll.studio.mymessagemanager.utils.PhoneUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSUtil;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import android.app.Activity;
+
+public class ComposeSMSActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static String TAG = "ComposeSMSActivity";
+    public static String EXTRA_SMSBODY = "sms_body";
+    private static final String MAP_NAME = "NAME";
+    private static final String MAP_PHONE = "PHONE";
+
+    private String mszSMSBody;
+    private String mszScheme;
+    private String mszPhoneTo;
+    private TextView mtvTOName;
+    private EditText metTONameSearch;
+    private EditText metTO;
+    private EditText metSMSBody;
+    private SimpleAdapter mSimpleAdapter;
+    private List<Map<String, Object>> mAdapterData = new ArrayList<Map<String, Object>>();
+    private ListView mlvContracts;
+    private List<PhoneBean> mListPhoneBeanContracts;
+    private Toolbar mToolbar;
+    private AOHPCTCSeekBar mAOHPCTCSeekBar;
+    private RelativeLayout mrlContracts;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate");
+        setContentView(R.layout.activity_composesms);
+
+        // 初始化Intent数据（增加空判断，避免NullPointerException）
+        Intent intent = getIntent();
+        if (intent != null) {
+            mszSMSBody = intent.getStringExtra(EXTRA_SMSBODY);
+            if (intent.getData() != null) {
+                mszScheme = intent.getData().getScheme();
+                mszPhoneTo = intent.getData().getSchemeSpecificPart();
+            }
+        }
+
+        // 校验启动方式，非smsto则退出
+        if (mszScheme == null || !"smsto".equals(mszScheme)) {
+            ToastUtils.show("不支持的启动方式");
+            finish();
+            return;
+        }
+
+        initView();
+        initAdapter(null); // 初始加载所有联系人
+        setListViewPrePositionByPhone();
+    }
+
+    private void initView() {
+        // 初始化标题栏
+        mToolbar = (Toolbar) findViewById(R.id.activitycomposesmsASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.activity_name_composesms));
+        setActionBar(mToolbar);
+
+        // 初始化联系人姓名显示和搜索栏
+        mtvTOName = (TextView) findViewById(R.id.activitycomposesmsTextView2);
+        mrlContracts = (RelativeLayout) findViewById(R.id.activitycomposesmsRelativeLayout1);
+        metTONameSearch = (EditText) findViewById(R.id.activitycomposesmsEditText2);
+
+        // 姓名搜索框文本变化监听
+        metTONameSearch.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {
+					metTO.setText(""); // 清空号码输入框，避免冲突
+					String input = s == null ? "" : s.toString().trim();
+					if (input.isEmpty()) {
+						initAdapter(null); // 空搜索时显示所有联系人
+					} else {
+						setListViewPrePositionByName(); // 按姓名搜索
+					}
+				}
+
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {
+					// 无操作
+				}
+
+				@Override
+				public void afterTextChanged(Editable s) {
+					// 无操作
+				}
+			});
+
+        // 初始化联系人列表（关键：设置单选模式，确保选中状态生效）
+        mlvContracts = (ListView) findViewById(R.id.activitycomposesmsListView1);
+        mlvContracts.setChoiceMode(ListView.CHOICE_MODE_SINGLE); // 开启单选，与布局中一致
+
+        // 初始化号码输入框（核心：优化文本变化监听逻辑）
+        metTO = (EditText) findViewById(R.id.activitycomposesmsEditText1);
+        if (mszPhoneTo != null) {
+            metTO.setText(mszPhoneTo);
+        }
+        metTO.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {
+					mtvTOName.setText(""); // 清空姓名显示
+					String inputPhone = s == null ? "" : s.toString().trim();
+
+					if (inputPhone.isEmpty()) {
+						// 输入为空时，显示所有联系人
+						initAdapter(null);
+					} else {
+						// 输入非空时，按号码搜索并更新列表（无结果则清空）
+						filterListByPhone(inputPhone);
+					}
+				}
+
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {
+					// 无操作
+				}
+
+				@Override
+				public void afterTextChanged(Editable s) {
+					// 无操作
+				}
+			});
+
+        // 初始化发送控件
+        mAOHPCTCSeekBar = (AOHPCTCSeekBar) findViewById(R.id.viewsmssendpart1AOHPCTCSeekBar1);
+        Drawable thumbDrawable = getResources().getDrawable(R.drawable.ic_message); // Java 7兼容写法
+        mAOHPCTCSeekBar.setThumb(thumbDrawable);
+        mAOHPCTCSeekBar.setThumbOffset(20);
+        mAOHPCTCSeekBar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+				@Override
+				public void onOHPCommit() {
+					sendSMS();
+				}
+			});
+
+        // 初始化短信内容输入框
+        TextView tvAOHPCTCSeekBarMSG = (TextView) findViewById(R.id.viewsmssendpart1TextView1);
+        tvAOHPCTCSeekBarMSG.setText(R.string.msg_100sendmsg);
+        metSMSBody = (EditText) findViewById(R.id.viewsmssendpart1EditText1);
+        if (mszSMSBody != null) {
+            metSMSBody.setText(mszSMSBody);
+        }
+    }
+
+    // 核心优化：根据输入号码筛选列表（无结果则显示空列表，优化选中逻辑）
+    private void filterListByPhone(String inputPhone) {
+        PhoneUtil phoneUtil = new PhoneUtil(this);
+        List<PhoneBean> allContacts = phoneUtil.getPhoneList();
+        List<PhoneBean> matchedContacts = new ArrayList<PhoneBean>();
+
+        // 遍历所有联系人，匹配包含输入号码的联系人
+        for (PhoneBean contact : allContacts) {
+            if (contact.getTelPhone().contains(inputPhone)
+                || phoneUtil.isTheSamePhoneNumber(contact.getTelPhone(), inputPhone)) {
+                matchedContacts.add(contact);
+            }
+        }
+
+        LogUtils.d(TAG, "号码搜索：输入'" + inputPhone + "', 匹配" + matchedContacts.size() + "个结果");
+
+        // 用筛选结果更新列表（无结果则传入空列表）
+        initAdapter(matchedContacts.isEmpty() ? new ArrayList<PhoneBean>() : matchedContacts);
+
+        // 定位并选中匹配项（如果有）
+        if (!matchedContacts.isEmpty()) {
+            boolean isFound = false;
+            for (int i = 0; i < matchedContacts.size(); i++) {
+                PhoneBean item = matchedContacts.get(i);
+                // 精确匹配号码（兼容区域码格式）
+                if (phoneUtil.isTheSamePhoneNumber(item.getTelPhone(), inputPhone)) {
+                    mtvTOName.setText(item.getName());
+                    // 关键：先滚动到目标位置，再设置选中状态
+                    mlvContracts.setSelection(i);
+                    // 主动设置选中（确保样式生效，兼容部分系统）
+                    mlvContracts.setItemChecked(i, true);
+                    LogUtils.d(TAG, String.format("%s 匹配 %s，选中位置：%d", inputPhone, item.getTelPhone(), i));
+                    isFound = true;
+                    break;
+                }
+            }
+            // 若未精确匹配，选中第一个结果
+            /*if (!isFound) {
+                mlvContracts.setSelection(0);
+                mlvContracts.setItemChecked(0, true);
+                mtvTOName.setText(matchedContacts.get(0).getName());
+            }*/
+        } else {
+            mtvTOName.setText(""); // 无结果时清空姓名显示
+        }
+    }
+
+    // 根据姓名搜索联系人
+    private void setListViewPrePositionByName() {
+        String searchName = metTONameSearch.getText().toString().trim();
+        PhoneUtil phoneUtil = new PhoneUtil(this);
+        List<PhoneBean> matchedContacts = phoneUtil.getPhonesByName(searchName);
+        initAdapter(matchedContacts);
+        if (!matchedContacts.isEmpty()) {
+            // 选中第一个结果并设置样式
+            mlvContracts.setSelection(0);
+            mlvContracts.setItemChecked(0, true);
+        }
+    }
+
+    // 初始定位号码对应的联系人
+    private void setListViewPrePositionByPhone() {
+        String inputPhone = metTO.getText().toString().trim();
+        if (inputPhone.isEmpty()) {
+            return;
+        }
+        filterListByPhone(inputPhone); // 复用筛选逻辑
+    }
+
+    // 获取号码匹配的位置（兼容旧逻辑）
+    private int getContractsDataPrePositionByPhone(String szPhone) {
+        if (mListPhoneBeanContracts == null || mListPhoneBeanContracts.isEmpty()) {
+            return 0;
+        }
+        for (int i = 0; i < mListPhoneBeanContracts.size(); i++) {
+            PhoneBean bean = mListPhoneBeanContracts.get(i);
+            if (bean.getTelPhone().compareTo(szPhone) >= 0) {
+                return i;
+            }
+        }
+        return 0;
+    }
+
+    // 获取姓名匹配的位置（兼容旧逻辑）
+    private int getContractsDataPrePositionByName(String szName) {
+        if (mListPhoneBeanContracts == null || mListPhoneBeanContracts.isEmpty()) {
+            return 0;
+        }
+        for (int i = 0; i < mListPhoneBeanContracts.size(); i++) {
+            if (mListPhoneBeanContracts.get(i).getName().startsWith(szName)) {
+                return i;
+            }
+        }
+        return 0;
+    }
+
+	// 初始化或更新列表适配器
+    private void initAdapter(List<PhoneBean> initData) {
+        mAdapterData.clear(); // 清空旧数据
+        final PhoneUtil phoneUtil = new PhoneUtil(this);
+
+        // 确定数据源：传入的筛选数据或所有联系人
+        if (initData != null) {
+            mListPhoneBeanContracts = initData;
+        } else {
+            mListPhoneBeanContracts = phoneUtil.getPhoneList();
+        }
+
+        // 转换数据为SimpleAdapter所需格式
+        if (mListPhoneBeanContracts != null) {
+            for (PhoneBean bean : mListPhoneBeanContracts) {
+                Map<String, Object> map = new HashMap<String, Object>();
+                map.put(MAP_NAME, bean.getName());
+                map.put(MAP_PHONE, bean.getTelPhone());
+                mAdapterData.add(map);
+            }
+        }
+
+        // 初始化或更新适配器
+        if (mSimpleAdapter == null) {
+            mSimpleAdapter = new SimpleAdapter(
+                ComposeSMSActivity.this,
+                mAdapterData,
+                R.layout.listview_contracts,
+                new String[]{MAP_NAME, MAP_PHONE},
+                new int[]{R.id.listviewcontractsTextView1, R.id.listviewcontractsTextView2}
+            );
+            mSimpleAdapter.setDropDownViewResource(R.layout.listview_contracts);
+            mlvContracts.setAdapter(mSimpleAdapter);
+
+            // 列表项点击事件：点击时主动设置选中状态，确保样式突显
+            mlvContracts.setOnItemClickListener(new AdapterView.OnItemClickListener() {
+					@Override
+					public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
+						if (position < mAdapterData.size()) {
+							// 1. 主动设置当前项为选中状态
+							mlvContracts.setItemChecked(position, true);
+							// 2. 更新号码输入框和姓名显示
+							String phone = mAdapterData.get(position).get(MAP_PHONE).toString();
+							metTO.setText(phone);
+							mtvTOName.setText(phoneUtil.getNameByPhone(phone));
+							// 3. 滚动到点击位置（确保可见）
+							mlvContracts.setSelection(position);
+						}
+					}
+				});
+
+            // 列表项选中状态变化监听（可选，增强选中反馈）
+            mlvContracts.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
+					@Override
+					public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
+					}
+
+					@Override
+					public void onNothingSelected(AdapterView<?> parent) {
+						// 未选中时无操作
+					}
+				});
+        } else {
+            // 数据更新时，先取消所有旧选中状态，再通知适配器刷新
+            mlvContracts.clearChoices();
+            mSimpleAdapter.notifyDataSetChanged();
+        }
+    }
+
+    // 发送短信逻辑
+    private void sendSMS() {
+        String phoneTo = metTO.getText().toString().trim();
+        if (phoneTo.isEmpty()) {
+            ToastUtils.show("没有设置接收号码。");
+            return;
+        }
+        String smsBody = metSMSBody.getText().toString().trim();
+        if (smsBody.isEmpty()) {
+            ToastUtils.show("没有消息内容可发送。");
+            return;
+        }
+        if (SMSUtil.sendMessageByInterface2(ComposeSMSActivity.this, phoneTo, smsBody)) {
+            finish();
+        }
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/MainActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/MainActivity.java
new file mode 100644
index 0000000..8f8b73a
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/MainActivity.java
@@ -0,0 +1,346 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+import android.Manifest;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.os.Message;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.ScrollView;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.DevelopUtils;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.App;
+import cc.winboll.studio.mymessagemanager.BuildConfig;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.MainActivity;
+import cc.winboll.studio.mymessagemanager.adapters.PhoneArrayAdapter;
+import cc.winboll.studio.mymessagemanager.services.MainService;
+import cc.winboll.studio.mymessagemanager.unittest.UnitTestActivity;
+import cc.winboll.studio.mymessagemanager.utils.AppConfigUtil;
+import cc.winboll.studio.mymessagemanager.utils.AppGoToSettingsUtil;
+import cc.winboll.studio.mymessagemanager.utils.PermissionUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSUtil;
+import cc.winboll.studio.mymessagemanager.utils.ViewUtil;
+import cc.winboll.studio.mymessagemanager.views.ConfirmSwitchView;
+import cc.winboll.studio.mymessagemanager.views.PhoneListViewForScrollView;
+import com.baoyz.widget.PullRefreshLayout;
+import java.util.ArrayList;
+
+public class MainActivity extends WinBoLLActivity {
+
+    public final static String TAG = "MainActivity";
+
+    public static final int ACTIVITY_RESULT_APP_SETTINGS = -1;
+
+    public final static int MSG_RELOADSMS = 0;
+
+    public static final int PERMISSION_SETTING_FOR_RESULT = 0;
+    public static final int MY_PERMISSIONS_REQUEST = 0;
+
+    static MainActivity _mMainActivity;
+	ADsBannerView mADsBannerView;
+
+    //LogView mLogView;
+    AppConfigUtil mAppConfigUtil;
+    ConfirmSwitchView msvEnableService;
+    ConfirmSwitchView msvOnlyReceiveContacts;
+    ConfirmSwitchView msvEnableTTS;
+    ConfirmSwitchView msvEnableTTSRuleMode;
+    PhoneListViewForScrollView mListViewPhone;
+    Toolbar mToolbar;
+    PhoneArrayAdapter mPhoneArrayAdapter;
+	AppGoToSettingsUtil mAppGoToSettingsUtil;
+    String[] mPermissionList = {Manifest.permission.READ_CONTACTS,
+        Manifest.permission.WRITE_EXTERNAL_STORAGE,
+        Manifest.permission.READ_EXTERNAL_STORAGE, 
+        Manifest.permission.READ_SMS};
+    ArrayList<String> listPerms;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        _mMainActivity = MainActivity.this;
+
+		// 米盟广告栏
+		mADsBannerView = findViewById(R.id.adsbanner);
+
+        mAppConfigUtil = AppConfigUtil.getInstance(this);
+		initView();
+
+        // 调用调试检查函数
+        onOnceAndroidStory(null);
+    }
+
+    //
+    // 这是一个测试函数，
+    // 用于调试读取 string.xml string-array使用。
+    //
+    public void onOnceAndroidStory(View view) {
+        if (BuildConfig.DEBUG) {
+            // 获取strings.xml文件中的tab_names数组
+            String[] tab_names = getResources().getStringArray(R.array.strings_OnceAndroidStory);
+            // 这里R.array.tab_names是你在XML文件中定义的数组资源ID
+            // 例如，在strings.xml中可能这样定义：
+            /*/            <!-- strings.xml -->
+             <resources>
+             <string-array name="tab_names">
+             <item>Tab 1</item>
+             <item>Tab 2</item>
+             <item>Tab 3</item>
+             </string-array>
+             </resources>
+             */
+            // 现在你可以遍历这个数组来访问每个元素
+            for (int i = 0; i < tab_names.length; i++) {
+                // 创建Random实例并传入任意非负种子（这里是1）
+                java.util.Random r = new java.util.Random(1);
+                // 调用nextInt(6)，范围是0到5（包括0和5），加1后得到1到5
+                int randomNum = r.nextInt(6) + 1;
+                System.out.println("Random number between 1 and 5: " + randomNum);
+                LogUtils.d("OnceAndroidStory", tab_names[i]);
+            }
+        }
+    }
+
+    void scrollScrollView() {
+        ScrollView sv = findViewById(R.id.activitymainScrollView1);
+        ViewUtil.scrollScrollView(sv);
+    }
+
+    void genTestData() {
+        for (int i = 0; i < 2; i++) {
+            SMSUtil.saveReceiveSms(this, "13172887736", "调试阶段生成的短信" + Integer.toString(i), "0", -1, "inbox");
+        }
+    }
+
+    //
+    // 初始化视图控件
+    //
+    void initView() {
+        // 设置调试日志
+//        mLogView = findViewById(R.id.logview);
+//        mLogView.start();
+
+        // 设置消息处理函数
+        setOnActivityMessageReceived(mIOnActivityMessageReceived);
+
+        // 设置标题栏
+        mToolbar = findViewById(R.id.activitymainASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.activity_name_main));
+        setSupportActionBar(mToolbar);
+
+        boolean isEnableService = mAppConfigUtil.mAppConfigBean.isEnableService();
+        msvEnableService = findViewById(R.id.activitymainSwitchView1);
+        msvEnableService.setChecked(isEnableService);
+        msvEnableService.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					boolean isEnable = ((ConfirmSwitchView)v).isChecked();
+                    mAppConfigUtil.reLoadConfig();
+					mAppConfigUtil.mAppConfigBean.setIsEnableService(isEnable);
+                    mAppConfigUtil.saveConfig();
+					initService(isEnable);
+				}
+			});
+
+        boolean isOnlyReceiveContacts = mAppConfigUtil.mAppConfigBean.isEnableOnlyReceiveContacts();
+        msvOnlyReceiveContacts = findViewById(R.id.activitymainSwitchView2);
+        msvOnlyReceiveContacts.setChecked(isOnlyReceiveContacts);
+		msvOnlyReceiveContacts.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					boolean isEnable = ((ConfirmSwitchView)v).isChecked();
+                    mAppConfigUtil.reLoadConfig();
+					mAppConfigUtil.mAppConfigBean.setIsEnableOnlyReceiveContacts(isEnable);
+                    mAppConfigUtil.saveConfig();
+				}
+			});
+
+        boolean isEnableTTS = mAppConfigUtil.mAppConfigBean.isEnableTTS();
+        msvEnableTTS = findViewById(R.id.activitymainSwitchView3);
+        msvEnableTTS.setChecked(isEnableTTS);
+		msvEnableTTS.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					boolean isEnable = ((ConfirmSwitchView)v).isChecked();
+                    mAppConfigUtil.reLoadConfig();
+					mAppConfigUtil.mAppConfigBean.setIsEnableTTS(isEnable);
+                    mAppConfigUtil.saveConfig();
+				}
+			});
+
+        boolean isEnableTTSRuleMode = mAppConfigUtil.mAppConfigBean.isEnableTTSRuleMode();
+        msvEnableTTSRuleMode = findViewById(R.id.activitymainSwitchView4);
+        msvEnableTTSRuleMode.setChecked(isEnableTTSRuleMode);
+		msvEnableTTSRuleMode.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					boolean isEnable = ((ConfirmSwitchView)v).isChecked();
+                    mAppConfigUtil.reLoadConfig();
+					mAppConfigUtil.mAppConfigBean.setIsEnableTTSRuleMode(isEnable);
+                    mAppConfigUtil.saveConfig();
+				}
+			});
+
+        initService(isEnableService);
+
+		// 短信发送窗口按钮
+		Button btnSendSMS = findViewById(R.id.activitymainButton1);
+		btnSendSMS.setOnClickListener(new View.OnClickListener() {
+
+				@Override
+				public void onClick(View v) {
+					Uri uri = Uri.parse("smsto:");
+					Intent it = new Intent(Intent.ACTION_SENDTO, uri);
+					it.putExtra("sms_body", "");
+					startActivity(it);
+				}
+			});
+
+		mListViewPhone = (PhoneListViewForScrollView) findViewById(R.id.activitymainListView1);
+        //准备数据
+        mPhoneArrayAdapter = new PhoneArrayAdapter(MainActivity.this);
+
+        final PullRefreshLayout layout = (PullRefreshLayout) findViewById(R.id.activitymainPullRefreshLayout1);
+		//将适配器加载到控件中
+        mListViewPhone.setAdapter(mPhoneArrayAdapter);
+
+        // listen refresh event
+        layout.setOnRefreshListener(new PullRefreshLayout.OnRefreshListener() {
+                @Override
+                public void onRefresh() {
+                    // start refresh
+                    reloadSMS();
+                    layout.setRefreshing(false);
+                }
+            });
+    }
+
+    void initService(boolean isEnableService) {
+        if (isEnableService) {
+            Intent service = new Intent(this, MainService.class);
+            startService(service);
+        } else {
+            Intent service = new Intent(this, MainService.class);
+            stopService(service);
+        }
+    }
+
+    //
+    // 定义应用内消息处理函数
+    //
+    IOnActivityMessageReceived mIOnActivityMessageReceived = new IOnActivityMessageReceived(){
+
+        @Override
+        public void onActivityMessageReceived(Message msg) {
+            switch (msg.arg1) {
+                case MSG_RELOADSMS : {
+                        LogUtils.d(TAG, "MSG_RELOADSMS");
+                        if (PermissionUtil.checkAppPermission(MainActivity.this)) {
+                            mPhoneArrayAdapter.loadData();
+                            mPhoneArrayAdapter.notifyDataSetChanged();
+                        } else {
+                            LogUtils.i(TAG, "遇到应用权限问题，请打开应用设置检查一下应用权限。");
+                        }
+                        break;
+                    }
+            }
+        }
+    };
+
+    @Override
+    public boolean onCreatePanelMenu(int featureId, Menu menu) {
+        return super.onCreatePanelMenu(featureId, menu);
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+		if (mADsBannerView != null) {
+			mADsBannerView.releaseAdResources();
+		}
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        reloadSMS();
+		if (mADsBannerView != null) {
+			mADsBannerView.resumeADs(MainActivity.this);
+		}
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+		getMenuInflater().inflate(R.menu.toolbar_main_first, menu);
+		// 主题菜单
+		AESThemeUtil.inflateMenu(this, menu);
+		// 调试工具菜单
+		if (App.isDebugging()) {
+			DevelopUtils.inflateMenu(this, menu);
+			getMenuInflater().inflate(R.menu.toolbar_main_debug, menu);
+		}
+		getMenuInflater().inflate(R.menu.toolbar_main_last, menu);
+		return true;
+    }
+
+    public static void reloadSMS() {
+        if (_mMainActivity != null) {
+            Message msg = new Message();
+            msg.arg1 = MSG_RELOADSMS;
+            _mMainActivity.sendActivityMessage(msg);
+        }
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+		int nItemId = item.getItemId();
+        int menuItemId = item.getItemId();
+		if (AESThemeUtil.onAppThemeItemSelected(this, item)) {
+            recreate();
+        } if (DevelopUtils.onDevelopItemSelected(this, item)) {
+			LogUtils.d(TAG, String.format("onOptionsItemSelected item.getItemId() %d ", item.getItemId()));
+		} else if (nItemId == R.id.app_ttsrule) {
+			Intent i = new Intent(MainActivity.this, TTSPlayRuleActivity.class);
+			i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+			startActivity(i);
+		} else if (nItemId == R.id.app_smsrule) {
+			Intent i = new Intent(MainActivity.this, SMSReceiveRuleActivity.class);
+			i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+			startActivity(i);
+		} else if (nItemId == R.id.app_appsettings) {
+            Intent i = new Intent(MainActivity.this, AppSettingsActivity.class);
+            i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            startActivity(i);
+		} else if (nItemId ==  R.id.app_unittest) {
+            Intent i = new Intent(MainActivity.this, UnitTestActivity.class);
+            i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+			startActivity(i);
+        } else if (nItemId ==  R.id.app_about) {
+            Intent i = new Intent(MainActivity.this, AboutActivity.class);
+            i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            startActivity(i);
+        } else if (nItemId ==  R.id.app_smsrecycle) {
+            Class<?> recycleClass;
+            if (mAppConfigUtil.mAppConfigBean.getRecycleBinClass().equals("SMSRecycle2Activity")) {
+                recycleClass = SMSRecycle2Activity.class;
+            } else {
+                recycleClass = SMSRecycleActivity.class;
+            }
+            Intent i = new Intent(MainActivity.this, recycleClass);
+            i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            startActivity(i);
+        }
+
+        return super.onOptionsItemSelected(item);
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSActivity.java
new file mode 100644
index 0000000..6bc9542
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSActivity.java
@@ -0,0 +1,281 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.view.View;
+import android.view.ViewTreeObserver;
+import android.widget.AbsListView;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+import android.widget.Toolbar;
+import androidx.localbroadcastmanager.content.LocalBroadcastManager;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.adapters.SMSArrayAdapter;
+import cc.winboll.studio.mymessagemanager.utils.AddressUtils;
+import cc.winboll.studio.mymessagemanager.utils.SMSUtil;
+import cc.winboll.studio.mymessagemanager.utils.ViewUtil;
+import cc.winboll.studio.mymessagemanager.views.BottomPositionFixedScrollView;
+import cc.winboll.studio.mymessagemanager.views.SMSListViewForScrollView;
+import android.app.Activity;
+
+public class SMSActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    public static String TAG = "SMSActivity";
+    public static final String ACTION_NOTIFY_SMS_CHANGED = "cc.winboll.studio.mymessagemanager.activitys.SMSActivity.ACTION_NOTIFY_SMS_CHANGED";
+    public static final String EXTRA_PHONE = "Phone";
+    final static int MSG_SET_FOCUS = 0;
+
+    SMSListViewForScrollView mlvSMS;
+    Toolbar mToolbar;
+    String mszPhoneTo;
+    SMSArrayAdapter mSMSArrayAdapter;
+    BottomPositionFixedScrollView mScrollView1;
+    EditText metSMSBody;
+    SMSActivityBroadcastReceiver mSMSActivityBroadcastReceiver;
+    Handler mSetFocusHandler;
+    private boolean isImeVisible = false;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_sms);
+
+        initView();
+        scrollScrollView();
+        setupImeStatusListener();
+
+        // 新增：监听窗口加载完成，触发mScrollView1滚动到底部
+        setupScrollToBottomAfterWindowLoaded();
+    }
+
+    // 新增：窗口加载完成后让mScrollView1滚动到底部
+    private void setupScrollToBottomAfterWindowLoaded() {
+        final View rootView = findViewById(android.R.id.content);
+        // 监听根布局绘制完成（窗口加载完成的标志）
+        rootView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
+				@Override
+				public void onGlobalLayout() {
+					// 滚动到底部
+					mScrollView1.post(new Runnable() {
+							@Override
+							public void run() {
+								mScrollView1.fullScroll(ScrollView.FOCUS_DOWN);
+							}
+						});
+
+					// 移除监听，避免重复触发
+					if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+						rootView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
+					} else {
+						rootView.getViewTreeObserver().removeGlobalOnLayoutListener(this);
+					}
+				}
+			});
+    }
+
+    private void setupImeStatusListener() {
+        final View rootView = findViewById(android.R.id.content);
+        rootView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
+				@Override
+				public void onGlobalLayout() {
+					int rootViewHeight = rootView.getHeight();
+					int screenHeight = getResources().getDisplayMetrics().heightPixels;
+					int imeThreshold = dp2px(200);
+
+					boolean currentImeVisible = (screenHeight - rootViewHeight) > imeThreshold;
+
+					if (currentImeVisible != isImeVisible) {
+						isImeVisible = currentImeVisible;
+						setupScrollView1Height();
+						if (!isImeVisible) {
+							metSMSBody.clearFocus();
+						}
+					}
+
+					if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+						rootView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
+					} else {
+						rootView.getViewTreeObserver().removeGlobalOnLayoutListener(this);
+					}
+					setupImeStatusListener();
+				}
+			});
+    }
+
+    private int dp2px(int dp) {
+        return (int) (dp * getResources().getDisplayMetrics().density + 0.5f);
+    }
+
+    /*static class MyHandler extends Handler {
+	 WeakReference<SMSActivity> mActivity;
+	 MyHandler(SMSActivity activity) {
+	 mActivity = new WeakReference<SMSActivity>(activity);
+	 }
+	 public void handleMessage(Message msg) {
+	 SMSActivity theActivity = mActivity.get();
+	 switch (msg.what) {
+	 case MSG_SET_FOCUS:
+	 theActivity.metSMSBody.setFocusable(true);
+	 theActivity.metSMSBody.requestFocus();
+	 theActivity.setupScrollView1Height();
+	 break;
+	 default:
+	 break;
+	 }
+	 super.handleMessage(msg);
+	 }
+	 }*/
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LocalBroadcastManager.getInstance(this).unregisterReceiver(mSMSActivityBroadcastReceiver);
+    }
+
+    void initView() {
+        mszPhoneTo = getIntent().getStringExtra(EXTRA_PHONE);
+        if (mszPhoneTo == null || mszPhoneTo.trim().equals("")) {
+            finish();
+        }
+
+        mToolbar = (Toolbar) findViewById(R.id.activitysmsASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.activity_name_smsinphone) + " < Phone : " + AddressUtils.getFormattedAddress(mszPhoneTo) + " >");
+        setActionBar(mToolbar);
+
+        mScrollView1 = (BottomPositionFixedScrollView) findViewById(R.id.activitysmsScrollView1);
+
+        metSMSBody = (EditText) findViewById(R.id.viewsmssendpart1EditText1);
+        metSMSBody.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					setupScrollView1Height();
+				}
+			});
+        metSMSBody.setOnFocusChangeListener(new View.OnFocusChangeListener() {
+				@Override
+				public void onFocusChange(View v, boolean hasFocus) {
+					setupScrollView1Height();
+				}
+			});
+
+        final AOHPCTCSeekBar aOHPCTCSeekBar = (AOHPCTCSeekBar) findViewById(R.id.viewsmssendpart1AOHPCTCSeekBar1);
+        aOHPCTCSeekBar.setThumb(getDrawable(R.drawable.ic_message));
+        aOHPCTCSeekBar.setThumbOffset(20);
+        aOHPCTCSeekBar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+				@Override
+				public void onOHPCommit() {
+					sendSMS();
+				}
+			});
+
+        TextView tvAOHPCTCSeekBarMSG = (TextView) findViewById(R.id.viewsmssendpart1TextView1);
+        tvAOHPCTCSeekBarMSG.setText(R.string.msg_100sendmsg);
+
+        mlvSMS = (SMSListViewForScrollView) findViewById(R.id.activitysmsSMSListViewForScrollView1);
+        mSMSArrayAdapter = new SMSArrayAdapter(SMSActivity.this, mszPhoneTo);
+        mlvSMS.setAdapter(mSMSArrayAdapter);
+
+        mlvSMS.setOnScrollListener(new AbsListView.OnScrollListener() {
+				@Override
+				public void onScrollStateChanged(AbsListView view, int scrollState) {}
+
+				@Override
+				public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
+					if (firstVisibleItem + visibleItemCount == totalItemCount && totalItemCount > 0) {
+						mSMSArrayAdapter.cancelMessageNotification();
+					}
+				}
+			});
+
+        mSMSActivityBroadcastReceiver = new SMSActivityBroadcastReceiver();
+        IntentFilter intentFilter = new IntentFilter(ACTION_NOTIFY_SMS_CHANGED);
+        LocalBroadcastManager.getInstance(this).registerReceiver(mSMSActivityBroadcastReceiver, intentFilter);
+    }
+
+    private void setupScrollView1Height() {
+        mScrollView1.postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					final ScrollView scrollView2 = (ScrollView) findViewById(R.id.activitysmsScrollView2);
+					final BottomPositionFixedScrollView scrollView1 = (BottomPositionFixedScrollView) findViewById(R.id.activitysmsScrollView1);
+					final View includeView = findViewById(R.id.activitysmsinclude1);
+
+					scrollView2.post(new Runnable() {
+							@Override
+							public void run() {
+								int scrollView2Height = scrollView2.getHeight();
+								int includeHeight = includeView.getHeight();
+								int targetHeight = Math.max(scrollView2Height - includeHeight, 0);
+
+								LinearLayout.LayoutParams params = (LinearLayout.LayoutParams) scrollView1.getLayoutParams();
+								params.height = targetHeight;
+								scrollView1.setLayoutParams(params);
+							}
+						});
+				}
+			}, 100);
+    }
+
+    public void updateSMSView() {
+        mSMSArrayAdapter.reLoadSMSList(SMSActivity.this, mszPhoneTo);
+        mSMSArrayAdapter.notifyDataSetChanged();
+    }
+
+    void scrollScrollView() {
+        ViewUtil.scrollScrollView(mScrollView1);
+    }
+
+    void sendSMS() {
+        String szSMSBody = metSMSBody.getText().toString();
+        if (szSMSBody.equals("")) {
+            Toast.makeText(getApplication(), "没有消息内容可发送。", Toast.LENGTH_SHORT).show();
+            return;
+        }
+
+        if (SMSUtil.sendMessageByInterface2(this, mszPhoneTo, szSMSBody)) {
+            metSMSBody.setText("");
+            metSMSBody.clearFocus();
+            new Handler().postDelayed(new Runnable() {
+					@Override
+					public void run() {
+						updateSMSView();
+						ViewUtil.scrollScrollView(mScrollView1);
+					}
+				}, 1000);
+        }
+    }
+
+    class SMSActivityBroadcastReceiver extends BroadcastReceiver {
+        public SMSActivityBroadcastReceiver() {}
+
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            if (ACTION_NOTIFY_SMS_CHANGED.equals(intent.getAction())) {
+                updateSMSView();
+                ViewUtil.scrollScrollView(mScrollView1);
+            } else {
+                throw new IllegalStateException("Unexpected value: " + intent.getAction());
+            }
+        }
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSReceiveRuleActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSReceiveRuleActivity.java
new file mode 100644
index 0000000..e1a2b25
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSReceiveRuleActivity.java
@@ -0,0 +1,244 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 12:50:52
+ * @Describe 短信匹配过滤规则设置窗口
+ */
+import android.app.AlertDialog;
+import android.app.Dialog;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.CheckBox;
+import android.widget.EditText;
+import android.widget.RadioButton;
+import android.widget.Toast;
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.mymessagemanager.App;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.SMSReceiveRuleActivity;
+import cc.winboll.studio.mymessagemanager.adapters.SMSAcceptRuleArrayAdapter;
+import cc.winboll.studio.mymessagemanager.beans.SMSAcceptRuleBean;
+import cc.winboll.studio.mymessagemanager.utils.FileUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSReceiveRuleUtil;
+import com.baoyz.widget.PullRefreshLayout;
+import android.app.Activity;
+
+public class SMSReceiveRuleActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "SMSReceiveRuleActivity";
+
+    Context mContext;
+    RecyclerView mRecyclerView;
+    Toolbar mToolbar;
+    RadioButton mrbAccept;
+    RadioButton mrbRefuse;
+    CheckBox mcbEnable;
+    SMSAcceptRuleBean mSMSAcceptRuleBeanAdd;
+    SMSAcceptRuleArrayAdapter mSMSAcceptRuleArrayAdapter;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_smsacceptrulesetting);
+        mContext = SMSReceiveRuleActivity.this;
+        initSMSAcceptRuleBeanAdd();
+        // 初始化视图
+        initView();
+    }
+
+    //
+    // 初始化视图
+    //
+    public void initView() {
+        // 初始化标题栏
+        mToolbar = findViewById(R.id.activitysmsacceptrulesettingASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.text_smsrule));
+        setSupportActionBar(mToolbar);
+
+        mrbAccept = findViewById(R.id.activitysmsacceptrulesettingRadioButton1);
+        mrbRefuse = findViewById(R.id.activitysmsacceptrulesettingRadioButton2);
+        mcbEnable = findViewById(R.id.activitysmsacceptrulesettingCheckBox1);
+        if (mSMSAcceptRuleBeanAdd.getRuleType() == SMSAcceptRuleBean.RuleType.ACCEPT) {
+            mrbAccept.setChecked(true);
+            mrbRefuse.setChecked(false);
+        }
+        if (mSMSAcceptRuleBeanAdd.getRuleType() == SMSAcceptRuleBean.RuleType.REFUSE) {
+            mrbAccept.setChecked(false);
+            mrbRefuse.setChecked(true);
+        }
+        mcbEnable.setChecked(mSMSAcceptRuleBeanAdd.isEnable());
+
+		Button btnAddSMSAcceptRule = findViewById(R.id.activitysmsacceptrulesettingButton1);
+		btnAddSMSAcceptRule.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					EditText et = findViewById(R.id.activitysmsacceptrulesettingEditText1);
+					String szRule = et.getText().toString().trim();
+					if (szRule.equals("")) {
+						Toast.makeText(getApplication(), "空字符串规则不能添加", Toast.LENGTH_SHORT).show();
+					} else {
+                        mSMSAcceptRuleBeanAdd.setRuleData(et.getText().toString());
+                        mSMSAcceptRuleBeanAdd.setIsEnable(mcbEnable.isChecked());
+                        mSMSAcceptRuleBeanAdd.setRuleType(mrbRefuse.isChecked() ?SMSAcceptRuleBean.RuleType.REFUSE: SMSAcceptRuleBean.RuleType.ACCEPT);
+						mSMSAcceptRuleArrayAdapter.addSMSAcceptRule(mSMSAcceptRuleBeanAdd);
+                        initSMSAcceptRuleBeanAdd();
+						et.setText("");
+						Toast.makeText(getApplication(), "已添加规则 : " + szRule, Toast.LENGTH_SHORT).show();
+					}
+				}
+            });
+
+        // 绑定控件
+        mRecyclerView = findViewById(R.id.activitysmsacceptrulesettingRecyclerView1);
+        RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this);
+        mRecyclerView.setLayoutManager(layoutManager);
+        mSMSAcceptRuleArrayAdapter = new SMSAcceptRuleArrayAdapter(this);
+        mRecyclerView.setAdapter(mSMSAcceptRuleArrayAdapter);
+
+        final PullRefreshLayout pullRefreshLayout = findViewById(R.id.activitysmsacceptrulesettingPullRefreshLayout1);
+        pullRefreshLayout.setOnRefreshListener(new PullRefreshLayout.OnRefreshListener(){
+                @Override
+                public void onRefresh() {
+                    pullRefreshLayout.setRefreshing(false);
+                    mSMSAcceptRuleArrayAdapter.loadConfigData();
+                    mSMSAcceptRuleArrayAdapter.notifyDataSetChanged();
+                }
+            });
+    }
+
+    void initSMSAcceptRuleBeanAdd() {
+        mSMSAcceptRuleBeanAdd = new SMSAcceptRuleBean(App.USER_ID, "", true, SMSAcceptRuleBean.RuleType.REFUSE, true);
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        //return super.onCreateOptionsMenu(menu);
+        getMenuInflater().inflate(R.menu.toolbar_rule, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int nItemId = item.getItemId();
+        if (nItemId == R.id.item_rule_share) {
+            //SMSReceiveRuleUtil smsAcceptRuleConfig = SMSReceiveRuleUtil.getInstance(this, false);
+            SMSAcceptRuleBean beanTemp = new SMSAcceptRuleBean();
+            String szConfigPath = beanTemp.getBeanListJsonFilePath(mContext);
+            FileUtil.shareJSONFile(SMSReceiveRuleActivity.this, szConfigPath);
+        } else if (nItemId == R.id.item_rule_reset) {
+            showResetConfigDialog();
+        } else if (nItemId == R.id.item_rule_clean) {
+            showCleanConfigDialog();
+        } 
+        return true;
+    }
+
+    //
+    // 短信匹配过滤规则数据重置对话框
+    //
+    void showResetConfigDialog() {
+        Dialog alertDialog = new AlertDialog.Builder(this).
+            setTitle("确定重置？").
+            setMessage("您确定重置短信接收规则为默认设置吗？").
+            setIcon(R.drawable.ic_launcher).
+            setPositiveButton("确定", new DialogInterface.OnClickListener() {
+
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    // TODO Auto-generated method stub
+                    SMSReceiveRuleUtil smsAcceptRuleConfig = SMSReceiveRuleUtil.getInstance(getApplicationContext(), false);
+                    smsAcceptRuleConfig.resetConfig();
+                    mSMSAcceptRuleArrayAdapter.notifyDataSetChanged();
+                    Toast.makeText(getApplication(), "Rules Reset", Toast.LENGTH_SHORT).show();
+                }
+            }).
+            setNegativeButton("取消", new DialogInterface.OnClickListener() {
+
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    // TODO Auto-generated method stub
+
+                }
+            }).
+            /*setNeutralButton("查看详情", new DialogInterface.OnClickListener() {
+
+             @Override
+             public void onClick(DialogInterface dialog, int which) {
+             // TODO Auto-generated method stub
+             }
+             }).*/
+            create();
+        alertDialog.show();
+    }
+
+    //
+    // 短信匹配过滤规则数据清空对话框
+    //
+    void showCleanConfigDialog() {
+        Dialog alertDialog = new AlertDialog.Builder(this).
+            setTitle("确定清理").
+            setMessage("您确定清理所有短信接收规则吗？").
+            setIcon(R.drawable.ic_launcher).
+            setPositiveButton("确定", new DialogInterface.OnClickListener() {
+
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    // TODO Auto-generated method stub
+                    SMSReceiveRuleUtil smsAcceptRuleConfig = SMSReceiveRuleUtil.getInstance(getApplicationContext(), false);
+                    smsAcceptRuleConfig.cleanConfig();
+                    mSMSAcceptRuleArrayAdapter.notifyDataSetChanged();
+                    Toast.makeText(getApplication(), "Rules Cleaned.", Toast.LENGTH_SHORT).show();
+                }
+            }).
+            setNegativeButton("取消", new DialogInterface.OnClickListener() {
+
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    // TODO Auto-generated method stub
+
+                }
+            }).
+            /*setNeutralButton("查看详情", new DialogInterface.OnClickListener() {
+             @Override
+             public void onClick(DialogInterface dialog, int which) {
+             // TODO Auto-generated method stub
+             }
+             }).*/
+            create();
+        alertDialog.show();
+    }
+
+    public void onAcceptRuleType(View view) {
+        mrbRefuse.setChecked(false);
+    }
+
+    public void onRefuseRuleType(View view) {
+        mrbAccept.setChecked(false);
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        mSMSAcceptRuleArrayAdapter.loadConfigData();
+        mSMSAcceptRuleArrayAdapter.notifyDataSetChanged();
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSRecycle2Activity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSRecycle2Activity.java
new file mode 100644
index 0000000..ac123d7
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSRecycle2Activity.java
@@ -0,0 +1,120 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+import android.app.Activity;
+import android.content.SharedPreferences;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.adapters.SMSRecycle2Adapter;
+import cc.winboll.studio.mymessagemanager.utils.SMSRecycleUtil;
+import cc.winboll.studio.mymessagemanager.views.ProtectModeTextView;
+import com.baoyz.widget.PullRefreshLayout;
+import java.io.File;
+
+public class SMSRecycle2Activity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "SMSRecycle2Activity";
+    private static final String SP_NAME = "smsrecycle2_config";
+    private static final String KEY_SCALE = "recycle2_scale";
+
+    Toolbar mToolbar;
+    RecyclerView mRecyclerView;
+    SMSRecycle2Adapter mSMSRecycle2Adapter;
+    ProtectModeTextView mSampleProtectModeTextView;
+    SharedPreferences mSP;
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_smsrecycle2);
+        mToolbar = findViewById(R.id.activitysmsrecycle2ASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.activity_name_about));
+        setSupportActionBar(mToolbar);
+
+        mSP = getSharedPreferences(SP_NAME, MODE_PRIVATE);
+
+        mSampleProtectModeTextView = findViewById(R.id.activitysmsrecycle2SampleProtectModeTextView);
+        mSampleProtectModeTextView.setContentTextWithScale(
+            "调节本短信下方刻度滑条，可预览文本打乱效果；同时该进度条数值将作为回收站短信全局默认初始值。\n"
+            + "刻度0 = 保持原文不打乱；\n"
+            + "刻度数值越小，字符分组越细碎，文本打乱混乱程度越大；\n"
+            + "刻度数值越大，字符连串分组越长，文本打乱混乱程度越小。",
+            mSP.getInt(KEY_SCALE, 0));
+
+        mSampleProtectModeTextView.setOnScaleChangedListener(new ProtectModeTextView.OnScaleChangedListener() {
+                @Override
+                public void onScaleChanged(int progress) {
+                    mSP.edit().putInt(KEY_SCALE, progress).apply();
+                    mSMSRecycle2Adapter.setScaleProgress(progress);
+                    mSMSRecycle2Adapter.notifyDataSetChanged();
+                }
+            });
+
+        initView();
+    }
+
+    void initView() {
+        mRecyclerView = findViewById(R.id.activitysmsrecycle2RecyclerView1);
+        RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this);
+        mRecyclerView.setLayoutManager(layoutManager);
+
+        mSMSRecycle2Adapter = new SMSRecycle2Adapter(this, mSP.getInt(KEY_SCALE, 0));
+        mRecyclerView.setAdapter(mSMSRecycle2Adapter);
+
+        final PullRefreshLayout pullRefreshLayout = findViewById(R.id.activitysmsrecycle2PullRefreshLayout1);
+        pullRefreshLayout.setOnRefreshListener(new PullRefreshLayout.OnRefreshListener() {
+                @Override
+                public void onRefresh() {
+                    mSMSRecycle2Adapter.loadSMSRecycleList();
+                    mSMSRecycle2Adapter.notifyDataSetChanged();
+                    pullRefreshLayout.setRefreshing(false);
+                }
+            });
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.toolbar_smsrecycle, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int nItemId = item.getItemId();
+        if (nItemId == R.id.item_cleansmsrecycle) {
+            YesNoAlertDialog.show(this, "回收站清空确认", "是否清空回收站", mDeleteListener);
+        }
+        return true;
+    }
+
+    YesNoAlertDialog.OnDialogResultListener mDeleteListener = new YesNoAlertDialog.OnDialogResultListener() {
+
+        @Override
+        public void onNo() {
+        }
+
+        @Override
+        public void onYes() {
+            File file = new File(SMSRecycleUtil.getSMSRecycleListDataPath(SMSRecycle2Activity.this));
+            file.delete();
+            mSMSRecycle2Adapter.loadSMSRecycleList();
+            mSMSRecycle2Adapter.notifyDataSetChanged();
+        }
+    };
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSRecycleActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSRecycleActivity.java
new file mode 100644
index 0000000..c8ce545
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SMSRecycleActivity.java
@@ -0,0 +1,104 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 16:56:18
+ * @Describe 短信回收站
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.SMSRecycleActivity;
+import cc.winboll.studio.mymessagemanager.adapters.SMSRecycleAdapter;
+import cc.winboll.studio.mymessagemanager.utils.SMSRecycleUtil;
+import com.baoyz.widget.PullRefreshLayout;
+import java.io.File;
+
+public class SMSRecycleActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "SMSRecycleActivity";
+
+    Toolbar mToolbar;
+    RecyclerView mRecyclerView;
+    SMSRecycleAdapter mSMSRecycleAdapter;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_smsrecycle);
+        // 初始化标题栏
+        mToolbar = findViewById(R.id.activitysmsrecycleASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.activity_name_about));
+        setSupportActionBar(mToolbar);
+        initView();
+    }
+
+    void initView() {
+        // 绑定控件
+        mRecyclerView = findViewById(R.id.activitysmsrecycleRecyclerView1);
+        RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this);
+        mRecyclerView.setLayoutManager(layoutManager);
+
+        mSMSRecycleAdapter = new SMSRecycleAdapter(this);
+        mRecyclerView.setAdapter(mSMSRecycleAdapter);
+
+        final PullRefreshLayout pullRefreshLayout = findViewById(R.id.activitysmsrecyclePullRefreshLayout1);
+        pullRefreshLayout.setOnRefreshListener(new PullRefreshLayout.OnRefreshListener() {
+                @Override
+                public void onRefresh() {
+                    mSMSRecycleAdapter.loadSMSRecycleList();
+                    mSMSRecycleAdapter.notifyDataSetChanged();
+                    pullRefreshLayout.setRefreshing(false);
+                }
+            });
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        //return super.onCreateOptionsMenu(menu);
+        getMenuInflater().inflate(R.menu.toolbar_smsrecycle, menu);
+        return true;
+    }
+
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int nItemId = item.getItemId();
+        if (nItemId == R.id.item_cleansmsrecycle) {
+            YesNoAlertDialog.show(this, "回收站清空确认", "是否清空回收站", mDeleteListener);
+        }
+        return true;
+    }
+
+    YesNoAlertDialog.OnDialogResultListener mDeleteListener = new YesNoAlertDialog.OnDialogResultListener() {
+
+        @Override
+        public void onNo() {
+        }
+
+        @Override
+        public void onYes() {
+            File file = new File(SMSRecycleUtil.getSMSRecycleListDataPath(SMSRecycleActivity.this));
+            file.delete();
+            mSMSRecycleAdapter.loadSMSRecycleList();
+            mSMSRecycleAdapter.notifyDataSetChanged();
+        }
+    };
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SharedJSONReceiveActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SharedJSONReceiveActivity.java
new file mode 100644
index 0000000..9f215b9
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/SharedJSONReceiveActivity.java
@@ -0,0 +1,154 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.text.TextUtils;
+import android.widget.TextView;
+import android.widget.Toast;
+import android.widget.Toolbar;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.SMSReceiveRuleActivity;
+import cc.winboll.studio.mymessagemanager.activitys.SharedJSONReceiveActivity;
+import cc.winboll.studio.mymessagemanager.activitys.TTSPlayRuleActivity;
+import cc.winboll.studio.mymessagemanager.beans.SMSAcceptRuleBean;
+import cc.winboll.studio.mymessagemanager.beans.TTSPlayRuleBean;
+import cc.winboll.studio.mymessagemanager.utils.UriUtil;
+import java.util.ArrayList;
+import android.app.Activity;
+
+public class SharedJSONReceiveActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "SharedJSONReceive";
+
+    Toolbar mToolbar;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_sharedjsonreceive);
+
+        StringBuilder sb = new StringBuilder();
+        // 接收分享数据
+        Intent intent = getIntent();
+        String action = intent.getAction();//action
+        String type = intent.getType();//类型
+        //LogUtils.d(TAG, "action is " + action);
+        //LogUtils.d(TAG, "type is " + type);
+        if ((Intent.ACTION_SEND.equals(action) || Intent.ACTION_VIEW.equals(action) || Intent.ACTION_EDIT.equals(action))
+            && type != null && (("application/json".equals(type)) || ("text/x-json".equals(type)))) {
+
+            //取出文件uri
+            Uri uri = intent.getData();
+            if (uri == null) {
+                uri = intent.getParcelableExtra(Intent.EXTRA_STREAM);
+            }
+            //获取文件真实地址
+            String szSrcJSON = UriUtil.getFileFromUri(getApplication(), uri);
+            if (TextUtils.isEmpty(szSrcJSON)) {
+                return;
+            }
+
+            String szCheck = TTSPlayRuleBean.checkIsTheSameBeanListAndFile(szSrcJSON, TTSPlayRuleBean.class);
+            if (szCheck.equals("")) {
+                importTTSPlayRuleBean(szSrcJSON);
+            } else {
+                sb.append("\n语音规则数据检测结果\n");
+                sb.append(szCheck);
+            }
+            //LogUtils.d(TAG, "szCheck is " + szCheck);
+
+            szCheck = SMSAcceptRuleBean.checkIsTheSameBeanListAndFile(szSrcJSON, SMSAcceptRuleBean.class);
+            if (szCheck.equals("")) {
+                importSMSAcceptRuleBean(szSrcJSON);
+            } else {
+                sb.append("\n短信接收规则数据检测结果\n");
+                sb.append(szCheck);
+            }
+            //LogUtils.d(TAG, "szCheck is " + szCheck);
+        } else {
+            sb.append("Not supported action.");
+        }
+
+        mToolbar = findViewById(R.id.activitysharedjsonreceiveASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.activity_name_sharedjsonreceive));
+        setActionBar(mToolbar);
+
+        TextView tvMessage = findViewById(R.id.activitysharedjsonreceiveTextView1);
+        tvMessage.setText(sb.toString());
+    }
+
+    void importSMSAcceptRuleBean(final String szSrcJSON) {
+        ArrayList<SMSAcceptRuleBean> beanList = new ArrayList<SMSAcceptRuleBean>();
+        boolean bCheck = SMSAcceptRuleBean.loadBeanListFromFile(szSrcJSON, beanList, SMSAcceptRuleBean.class);
+        if (bCheck && beanList.size() > 0) {
+            YesNoAlertDialog.show(SharedJSONReceiveActivity.this,
+                                  "短信接收规则共享提示",
+                                  "已收到短信接收规则" + Integer.toString(beanList.size()) + "个，\n是否导入应用？"
+                                  , (new YesNoAlertDialog.OnDialogResultListener(){
+
+                                      @Override
+                                      public void onYes() {
+                                          ArrayList<SMSAcceptRuleBean> beanListShare = new ArrayList<SMSAcceptRuleBean>();
+                                          SMSAcceptRuleBean.loadBeanListFromFile(szSrcJSON, beanListShare, SMSAcceptRuleBean.class);
+                                          ArrayList<SMSAcceptRuleBean> beanListApp = new ArrayList<SMSAcceptRuleBean>();
+                                          SMSAcceptRuleBean.loadBeanList(SharedJSONReceiveActivity.this, beanListApp, SMSAcceptRuleBean.class);
+                                          beanListApp.addAll(0, beanListShare);
+                                          SMSAcceptRuleBean.saveBeanList(SharedJSONReceiveActivity.this, beanListApp, SMSAcceptRuleBean.class);
+                                          Toast.makeText(getApplication(), "已导入" + Integer.toString(beanListShare.size()) + "个数据。", Toast.LENGTH_SHORT).show();
+                                          finish();
+                                          Intent intent = new Intent(SharedJSONReceiveActivity.this, SMSReceiveRuleActivity.class);
+                                          startActivity(intent);
+                                      }
+
+                                      @Override
+                                      public void onNo() {
+                                          finish();
+                                      }
+                                  }));
+        }
+    }
+
+    void importTTSPlayRuleBean(final String szSrcJSON) {
+        ArrayList<TTSPlayRuleBean> beanList = new ArrayList<TTSPlayRuleBean>();
+        boolean bCheck = TTSPlayRuleBean.loadBeanListFromFile(szSrcJSON, beanList, TTSPlayRuleBean.class);
+        if (bCheck && beanList.size() > 0) {
+            YesNoAlertDialog.show(SharedJSONReceiveActivity.this,
+                                  "语音规则共享提示",
+                                  "已收到语音规则" + Integer.toString(beanList.size()) + "个，\n是否导入应用？"
+                                  , (new YesNoAlertDialog.OnDialogResultListener(){
+
+                                      @Override
+                                      public void onYes() {
+                                          ArrayList<TTSPlayRuleBean> beanListShare = new ArrayList<TTSPlayRuleBean>();
+                                          TTSPlayRuleBean.loadBeanListFromFile(szSrcJSON, beanListShare, TTSPlayRuleBean.class);
+                                          ArrayList<TTSPlayRuleBean> beanListApp = new ArrayList<TTSPlayRuleBean>();
+                                          TTSPlayRuleBean.loadBeanList(SharedJSONReceiveActivity.this, beanListApp, TTSPlayRuleBean.class);
+                                          beanListApp.addAll(0, beanListShare);
+                                          TTSPlayRuleBean.saveBeanList(SharedJSONReceiveActivity.this, beanListApp, TTSPlayRuleBean.class);
+                                          Toast.makeText(getApplication(), "已导入" + Integer.toString(beanListShare.size()) + "个数据。", Toast.LENGTH_SHORT).show();
+                                          finish();
+                                          Intent intent = new Intent(SharedJSONReceiveActivity.this, TTSPlayRuleActivity.class);
+                                          startActivity(intent);
+                                      }
+
+                                      @Override
+                                      public void onNo() {
+                                          finish();
+                                      }
+                                  }));
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/TTSFloatSettingsActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/TTSFloatSettingsActivity.java
new file mode 100644
index 0000000..829b6bc
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/TTSFloatSettingsActivity.java
@@ -0,0 +1,23 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+import android.app.Activity;
+import android.os.Bundle;
+import cc.winboll.studio.mymessagemanager.R;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/02/11 03:45
+ * @Describe TTS悬浮窗设置类（使用可拖动自定义控件）
+ */
+public class TTSFloatSettingsActivity extends Activity {
+
+    public static final String TAG = "TTSFloatSettingsActivity";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        // 直接加载包含自定义拖动控件的布局
+        setContentView(R.layout.activity_ttsfloatsettings);
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/TTSPlayRuleActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/TTSPlayRuleActivity.java
new file mode 100644
index 0000000..3423b10
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/TTSPlayRuleActivity.java
@@ -0,0 +1,200 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 12:50:52
+ * @Describe TTS 语音播放规则规则设置窗口
+ */
+import android.os.Bundle;
+import android.os.Message;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.Toast;
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.adapters.TTSRuleBeanRecyclerViewAdapter;
+import cc.winboll.studio.mymessagemanager.beans.TTSPlayRuleBean;
+import cc.winboll.studio.mymessagemanager.utils.FileUtil;
+import cc.winboll.studio.mymessagemanager.utils.TTSPlayRuleUtil;
+import android.app.Activity;
+
+public class TTSPlayRuleActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "TTSPlayRuleActivity";
+
+    public static final int MSG_RELOAD = 0;
+
+	public static final String EXTRA_TTSDEMOTEXT = "EXTRA_TTSDEMOTEXT";
+
+	Toolbar mToolbar;
+    TTSRuleBeanRecyclerViewAdapter mTTSRuleBeanRecyclerViewAdapter;
+	TTSPlayRuleUtil mTTSPlayRuleUtil;
+	TTSPlayRuleBean mTTSRuleBeanCurrent;
+    RecyclerView mRecyclerView;
+    EditText metCurrentDemoSMSText;
+    EditText metPatternText;
+    EditText metCurrentTTSRuleText;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+	@Override
+	protected void onCreate(Bundle savedInstanceState) {
+		super.onCreate(savedInstanceState);
+		setContentView(R.layout.activity_ttsplayrule);
+
+		mTTSPlayRuleUtil = TTSPlayRuleUtil.getInstance(TTSPlayRuleActivity.this);
+
+        initView();
+
+        // 设置窗口消息处理
+        setOnActivityMessageReceived(new IOnActivityMessageReceived(){
+                @Override
+                public void onActivityMessageReceived(Message msg) {
+                    switch (msg.what) {
+                        case MSG_RELOAD : {
+                                //Toast.makeText(getApplication(), "MSG_RELOAD", Toast.LENGTH_SHORT).show();
+                                mTTSRuleBeanRecyclerViewAdapter.reloadConfigData();
+                                break;
+                            }
+                    }
+                }
+            });
+	}
+
+    void initView() {
+        // 初始化标题栏
+        mToolbar = findViewById(R.id.activityttsplayruleASupportToolbar1);
+        mToolbar.setSubtitle(getString(R.string.text_ttsrule));
+        setSupportActionBar(mToolbar);
+
+        metCurrentDemoSMSText = findViewById(R.id.activityttsplayruleEditText1);
+        metPatternText = findViewById(R.id.activityttsplayruleEditText2);
+        metCurrentTTSRuleText = findViewById(R.id.activityttsplayruleEditText3);
+
+		Button btnTestTTSRule = findViewById(R.id.activityttsplayruleButton1);
+		btnTestTTSRule.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					TTSPlayRuleBean ttsRuleBean = new TTSPlayRuleBean();
+                    ttsRuleBean.setDemoSMSText(metCurrentDemoSMSText.getText().toString());
+                    ttsRuleBean.setPatternText(metPatternText.getText().toString());
+                    ttsRuleBean.setTtsRuleText(metCurrentTTSRuleText.getText().toString());
+
+                    String sz = mTTSPlayRuleUtil.testTTSAnalyzeModeReply(ttsRuleBean);
+                    Toast.makeText(getApplication(), sz, Toast.LENGTH_SHORT).show();
+				}
+			});
+
+		Button btnAcceptTTSRule = findViewById(R.id.activityttsplayruleButton2);
+		btnAcceptTTSRule.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					if (mTTSRuleBeanCurrent != null) {
+						mTTSRuleBeanCurrent.setDemoSMSText(metCurrentDemoSMSText.getText().toString());
+                        mTTSRuleBeanCurrent.setPatternText(metPatternText.getText().toString());
+                        mTTSRuleBeanCurrent.setTtsRuleText(metCurrentTTSRuleText.getText().toString());
+                        mTTSRuleBeanRecyclerViewAdapter.saveConfigData();
+					} else {
+                        if (!metCurrentDemoSMSText.getText().toString().equals("")) {
+                            mTTSRuleBeanCurrent = new TTSPlayRuleBean();
+                            mTTSRuleBeanCurrent.setDemoSMSText(metCurrentDemoSMSText.getText().toString());
+                            mTTSRuleBeanCurrent.setPatternText(metPatternText.getText().toString());
+                            mTTSRuleBeanCurrent.setTtsRuleText(metCurrentTTSRuleText.getText().toString());
+                            mTTSRuleBeanRecyclerViewAdapter.addNewTTSRuleBean(mTTSRuleBeanCurrent);
+                            LinearLayoutManager layoutManager = (LinearLayoutManager) mRecyclerView.getLayoutManager();
+                            layoutManager.scrollToPositionWithOffset(0, 0);
+                        }
+                    }
+				}
+			});
+
+		// 绑定控件
+        mRecyclerView = findViewById(R.id.activityttsplayruleRecyclerView1);
+        RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this);
+        mRecyclerView.setLayoutManager(layoutManager);
+
+        mTTSRuleBeanRecyclerViewAdapter = new TTSRuleBeanRecyclerViewAdapter(TTSPlayRuleActivity.this, mOnTTSRuleChangeListener);
+        mRecyclerView.setAdapter(mTTSRuleBeanRecyclerViewAdapter);
+
+		// 处理传入的窗口启动参数
+        //
+        String szNewDemoText = getIntent().getStringExtra(EXTRA_TTSDEMOTEXT);
+        metCurrentDemoSMSText.setText(szNewDemoText);
+	}
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        //return super.onCreateOptionsMenu(menu);
+        getMenuInflater().inflate(R.menu.toolbar_rule, menu);
+        return true;
+    }
+
+    public void onScrollToDemoSMSTextMatchingRule(View view) {
+        int rowIndex = mTTSPlayRuleUtil.speakTTSAnalyzeModeText(metCurrentDemoSMSText.getText().toString());
+
+        LinearLayoutManager layoutManager = (LinearLayoutManager) mRecyclerView.getLayoutManager();
+        layoutManager.scrollToPositionWithOffset(rowIndex, 0);
+        Toast.makeText(getApplication(), "当前文本匹配的规则序号为 " + Integer.toString(rowIndex + 1), Toast.LENGTH_SHORT).show();
+    }
+    
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int nItemId = item.getItemId();
+        if (nItemId == R.id.item_rule_share) {
+            TTSPlayRuleBean bean = new TTSPlayRuleBean();
+            FileUtil.shareJSONFile(this, bean.getBeanListJsonFilePath(TTSPlayRuleActivity.this));
+        } else if (nItemId == R.id.item_rule_reset) {
+            showResetConfigDialog();
+        } else if (nItemId == R.id.item_rule_clean) {
+            showCleanConfigDialog();
+        } 
+
+        return true;
+    }
+
+    //
+    // 规则数据重置对话框
+    //
+    void showResetConfigDialog() {
+        mTTSPlayRuleUtil.resetConfig();
+    }
+
+    //
+    // 规则数据重置对话框
+    //
+    void showCleanConfigDialog() {
+        mTTSPlayRuleUtil.cleanConfig();
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+    }
+
+    //
+    // 规则项选择事件监听类
+    //
+	TTSRuleBeanRecyclerViewAdapter.OnTTSRuleChangeListener mOnTTSRuleChangeListener = new TTSRuleBeanRecyclerViewAdapter.OnTTSRuleChangeListener() {
+		@Override
+		public void onTTSRuleChange(TTSPlayRuleBean bean) {
+			metCurrentDemoSMSText.setText(bean.getDemoSMSText());
+			metPatternText.setText(bean.getPatternText());
+			metCurrentTTSRuleText.setText(bean.getTtsRuleText());
+			mTTSRuleBeanCurrent = bean;
+		}
+	};
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/WinBoLLActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/WinBoLLActivity.java
new file mode 100644
index 0000000..dd65f3b
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/activitys/WinBoLLActivity.java
@@ -0,0 +1,82 @@
+package cc.winboll.studio.mymessagemanager.activitys;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/03/31 01:31:17
+ * @Describe 应用活动窗口基类
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Message;
+import android.view.MenuItem;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.mymessagemanager.enums.ThemeStyleEnum;
+
+public class WinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "WinBoLLActivity";
+
+	IOnActivityMessageReceived mIOnActivityMessageReceived;
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+		// 1. 优先读取SP中保存的主题（必须在setContentView前调用！）
+		ThemeStyleEnum savedTheme = ThemeStyleEnum.getThemeFromSP(this);
+		// 2. 设置主题
+		setTheme(savedTheme.getStyleId());
+        super.onCreate(savedInstanceState);
+    }
+
+	@Override
+	public boolean onOptionsItemSelected(MenuItem item) {
+		int selectedMenuId = item.getItemId();
+		// 1. 根据菜单ID获取对应的主题枚举
+		ThemeStyleEnum selectedTheme = ThemeStyleEnum.getThemeByMenuId(selectedMenuId);
+
+		if (selectedTheme != null) {
+			// 2. 调用枚举自带方法保存主题到SP（替代AESThemeUtil）
+			ThemeStyleEnum.saveThemeToSP(this, selectedTheme);
+			recreate(); // 重建Activity生效主题
+		} else if (selectedMenuId == android.R.id.home) {
+			finish();
+		} else {
+			return super.onOptionsItemSelected(item);
+		}
+		return true;
+	}
+
+	protected interface IOnActivityMessageReceived {
+        void onActivityMessageReceived(Message msg);
+    }
+
+	public void sendActivityMessage(Message msg) {
+        mHandler.sendMessage(msg);
+    }
+
+    protected void setOnActivityMessageReceived(IOnActivityMessageReceived iOnActivityMessageReceived) {
+        mIOnActivityMessageReceived = iOnActivityMessageReceived;
+    }
+
+    Handler mHandler = new Handler(){
+
+        @Override
+        public void handleMessage(Message msg) {
+            super.handleMessage(msg);
+            if (mIOnActivityMessageReceived != null) {
+                mIOnActivityMessageReceived.onActivityMessageReceived(msg);
+            }
+        }
+    };
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/PhoneArrayAdapter.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/PhoneArrayAdapter.java
new file mode 100644
index 0000000..12381bc
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/PhoneArrayAdapter.java
@@ -0,0 +1,115 @@
+package cc.winboll.studio.mymessagemanager.adapters;
+
+import android.content.Context;
+import android.content.Intent;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.view.ViewGroup;
+import android.widget.BaseAdapter;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.SMSActivity;
+import cc.winboll.studio.mymessagemanager.beans.PhoneBean;
+import cc.winboll.studio.mymessagemanager.beans.SMSBean;
+import cc.winboll.studio.mymessagemanager.utils.AddressUtils;
+import cc.winboll.studio.mymessagemanager.utils.PhoneUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSUtil;
+import java.util.ArrayList;
+import java.util.List;
+
+public class PhoneArrayAdapter extends BaseAdapter {
+
+    public final static String TAG = "PhoneArrayAdapter";
+
+    Context mContext;
+    ArrayList<SMSBean> mData;
+    List<PhoneBean> mlistContacts;
+    PhoneUtil mPhoneUtil;
+
+    public PhoneArrayAdapter(Context context) {
+        mContext = context;
+		mData = new ArrayList<SMSBean>();
+    }
+
+    public void loadData() {
+        ArrayList<SMSBean> listTemp = SMSUtil.getAllSMSList(mContext);
+        mData.clear();
+        mData.addAll(listTemp);
+        mPhoneUtil = new PhoneUtil(mContext);
+        mlistContacts = mPhoneUtil.getPhoneList();
+        LogUtils.i(TAG, "SMS List Reload.");
+    }
+
+    @Override
+    public int getCount() {
+        return mData.size();
+    }
+
+    @Override
+    public Object getItem(int p1) {
+        return mData.get(p1);
+    }
+
+    @Override
+    public long getItemId(int p1) {
+        return 0;
+    }
+
+    @Override
+    public View getView(int position, View convertView, ViewGroup parent) {
+		final ViewHolder viewHolder;
+        if (convertView == null) {
+            viewHolder = new ViewHolder();
+            convertView = LayoutInflater.from(mContext).inflate(R.layout.listview_phone, parent, false);
+
+            //分别获取 image view 和 textview 的实例
+			viewHolder.tvAddress = convertView.findViewById(R.id.listviewphoneTextView1);
+			viewHolder.tvName = convertView.findViewById(R.id.listviewphoneTextView2);
+			viewHolder.ll = convertView.findViewById(R.id.listviewphoneLinearLayout1);
+
+            convertView.setTag(viewHolder);
+        } else {
+            viewHolder = (ViewHolder) convertView.getTag();
+        }
+
+		final String szAddress = ((SMSBean)getItem(position)).getAddress();
+
+		viewHolder.tvAddress.setText(AddressUtils.getFormattedAddress(szAddress));
+		viewHolder.tvName.setText(getName(szAddress));
+
+        //Drawable drawableFrame = AppCompatResources.getDrawable(mContext, R.drawable.bg_frame);
+        //viewHolder.ll.setBackground(drawableFrame);
+        viewHolder.ll.setOnClickListener(new OnClickListener() {
+                @Override
+                public void onClick(View arg0) {
+
+                    //Toast.makeText(mContext, tv.getText(), Toast.LENGTH_SHORT).show();
+                    Intent intent = new Intent(mContext, SMSActivity.class);
+                    intent.putExtra(SMSActivity.EXTRA_PHONE, szAddress);
+                    mContext.startActivity(intent);
+                }
+
+            });
+        return convertView;
+
+    }
+
+    String getName(String szAddress) {
+        for (int i = 0; i < mlistContacts.size(); i++) {
+            if (mlistContacts.get(i).getTelPhone().equals(szAddress)) {
+                return mlistContacts.get(i).getName();
+            }
+        }
+        return mContext.getString(R.string.text_notincontacts);
+    }
+
+	class ViewHolder {
+        TextView tvAddress;
+		TextView tvName;
+		LinearLayout ll;
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSAcceptRuleArrayAdapter.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSAcceptRuleArrayAdapter.java
new file mode 100644
index 0000000..99522a1
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSAcceptRuleArrayAdapter.java
@@ -0,0 +1,229 @@
+package cc.winboll.studio.mymessagemanager.adapters;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/20 12:27:34
+ * @Describe 短信过滤规则数据适配器
+ */
+import android.content.Context;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.CheckBox;
+import android.widget.EditText;
+import android.widget.RadioButton;
+import android.widget.TextView;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.beans.SMSAcceptRuleBean;
+import cc.winboll.studio.mymessagemanager.utils.SMSReceiveRuleUtil;
+import java.util.ArrayList;
+
+public class SMSAcceptRuleArrayAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
+
+    public static final String TAG = "SMSAcceptRuleArrayAdapter";
+
+    Context mContext;
+    ArrayList<SMSAcceptRuleBean> mDataList;
+    SMSReceiveRuleUtil mSMSReceiveRuleUtil;
+
+    public SMSAcceptRuleArrayAdapter(Context context) {
+        mContext = context;
+        mSMSReceiveRuleUtil = SMSReceiveRuleUtil.getInstance(mContext, true);
+        loadConfigData();
+    }
+
+    public void addSMSAcceptRule(SMSAcceptRuleBean bean) {
+        mSMSReceiveRuleUtil.addRule(bean);
+        notifyDataSetChanged();
+    }
+
+    public void loadConfigData() {
+        mDataList = mSMSReceiveRuleUtil.loadConfigData();
+        for (int i = 0; i < mDataList.size(); i++) {
+            mDataList.get(i).setIsSimpleView(true);
+            //LogUtils.d(TAG, "loadConfigData isEnable : " + Boolean.toString(mDataList.get(i).isEnable()));
+        }
+    }
+
+    void deleteItem(int position) {
+        mDataList.remove(position);
+        mSMSReceiveRuleUtil.saveConfigData();
+        notifyDataSetChanged();
+    }
+
+    @Override
+    public int getItemViewType(int position) {
+        if (mDataList.get(position).isSimpleView()) {
+            return 0;
+        } else {
+            return 1;
+        }
+    }
+
+    @Override
+    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+        if (viewType == 0) {
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.listview_smsacceptrule_simple, parent, false);
+            return new SimpleViewHolder(view);
+        } else {
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.listview_smsacceptrule, parent, false);
+            return new ComplexViewHolder(view);
+        }
+    }
+
+    @Override
+    public void onBindViewHolder(RecyclerView.ViewHolder holder, final int position) {
+        final SMSAcceptRuleBean item = mDataList.get(position);
+        if (holder.getItemViewType() == 0) {
+            final SimpleViewHolder viewHolder = (SimpleViewHolder) holder;
+            viewHolder.mtvContent.setText(item.getRuleData());
+            viewHolder.mcbEnable.setChecked(item.isEnable());
+            viewHolder.mcbEnable.setOnClickListener(new View.OnClickListener() {
+                    @Override
+                    public void onClick(View p1) {
+                        item.setIsEnable(viewHolder.mcbEnable.isChecked());
+                        item.setIsSimpleView(true);
+                        mSMSReceiveRuleUtil.saveConfigData();
+                        notifyDataSetChanged();
+                    }
+                });
+            viewHolder.mtvRuleType.setText(item.getRuleType().toString());
+            viewHolder.mbtnEdit.setOnClickListener(new View.OnClickListener(){
+                    @Override
+                    public void onClick(View v) {
+                        for (int i = 0; i < mDataList.size(); i++) {
+                            mDataList.get(i).setIsSimpleView(true);
+                        }
+                        item.setIsSimpleView(false);
+                        notifyDataSetChanged();
+                        //ToastUtils.show("setIsSimpleView");
+                    }
+                });
+        } else {
+            final ComplexViewHolder viewHolder = (ComplexViewHolder) holder;
+            if (item != null) {
+                //Drawable drawableFrame = AppCompatResources.getDrawable(mContext, R.drawable.bg_frame);
+                viewHolder.metContent.setText(item.getRuleData());
+                if (item.getRuleType() == SMSAcceptRuleBean.RuleType.ACCEPT) {
+                    viewHolder.mrbAccept.setChecked(true);
+                    viewHolder.mrbRefuse.setChecked(false);
+                }
+                if (item.getRuleType() == SMSAcceptRuleBean.RuleType.REFUSE) {
+                    viewHolder.mrbAccept.setChecked(false);
+                    viewHolder.mrbRefuse.setChecked(true);
+                }
+                viewHolder.mrbAccept.setOnClickListener(new View.OnClickListener(){
+                        @Override
+                        public void onClick(View view) {
+                            viewHolder.mrbRefuse.setChecked(false);
+                            item.setRuleType(SMSAcceptRuleBean.RuleType.ACCEPT);
+                            mSMSReceiveRuleUtil.saveConfigData();
+                            notifyDataSetChanged();
+                        }
+                    });
+                viewHolder.mrbRefuse.setOnClickListener(new View.OnClickListener(){
+                        @Override
+                        public void onClick(View view) {
+                            viewHolder.mrbAccept.setChecked(false);
+                            item.setRuleType(SMSAcceptRuleBean.RuleType.REFUSE);
+                            mSMSReceiveRuleUtil.saveConfigData();
+                            notifyDataSetChanged();
+                        }
+                    });
+                viewHolder.mbtnUp.setOnClickListener(new View.OnClickListener() {
+                        @Override
+                        public void onClick(View p1) {
+                            if (position > 0) {
+                                mDataList.add(position-1, mDataList.get(position));
+                                mDataList.remove(position+1);
+                                mSMSReceiveRuleUtil.saveConfigData();
+                                notifyDataSetChanged();
+                            }
+                        }
+                    });
+                viewHolder.mbtnDown.setOnClickListener(new View.OnClickListener() {
+                        @Override
+                        public void onClick(View p1) {
+                            if (position < mDataList.size() - 1) {
+                                //ToastUtils.show("mbtnDown");
+                                ToastUtils.show("position " + Integer.toString(position));
+                                mDataList.add(position+2, mDataList.get(position));
+                                mDataList.remove(position);
+                                mSMSReceiveRuleUtil.saveConfigData();
+                                notifyDataSetChanged();
+                            }
+                        }
+                    });
+                viewHolder.mbtnOK.setOnClickListener(new View.OnClickListener() {
+                        @Override
+                        public void onClick(View p1) {
+                            item.setRuleData(viewHolder.metContent.getText().toString());
+                            item.setRuleType(viewHolder.mrbAccept.isChecked() ?SMSAcceptRuleBean.RuleType.ACCEPT: SMSAcceptRuleBean.RuleType.REFUSE);
+                            item.setIsEnable(viewHolder.mcbEnable.isChecked());
+                            item.setIsSimpleView(true);
+                            mSMSReceiveRuleUtil.saveConfigData();
+                            notifyDataSetChanged();
+                        }
+                    });
+                viewHolder.mbtnDelete.setOnClickListener(new View.OnClickListener() {
+                        @Override
+                        public void onClick(View p1) {
+                            deleteItem(position);
+                        }
+                    });
+                viewHolder.mcbEnable.setChecked(item.isEnable());
+            }
+        }
+    }
+
+    @Override
+    public int getItemCount() {
+        return mDataList.size();
+    }
+
+    @Override
+    public long getItemId(int posttion) {
+        return 0;
+    }
+
+    private static class SimpleViewHolder extends RecyclerView.ViewHolder {
+        TextView mtvContent;
+        CheckBox mcbEnable;
+        TextView mtvRuleType;
+        Button mbtnEdit;
+
+        SimpleViewHolder(View itemView) {
+            super(itemView);
+            mtvContent = itemView.findViewById(R.id.listviewsmsacceptrulesimpleTextView1);
+            mcbEnable = itemView.findViewById(R.id.listviewsmsacceptrulesimpleCheckBox1);
+            mtvRuleType = itemView.findViewById(R.id.listviewsmsacceptrulesimpleTextView2);
+            mbtnEdit = itemView.findViewById(R.id.listviewsmsacceptrulesimpleButton1);
+        }
+    }
+
+    private static class ComplexViewHolder extends RecyclerView.ViewHolder {
+        EditText metContent;
+        RadioButton mrbAccept;
+        RadioButton mrbRefuse;
+        CheckBox mcbEnable;
+        Button mbtnUp;
+        Button mbtnDown;
+        Button mbtnOK;
+        Button mbtnDelete;
+
+        ComplexViewHolder(View itemView) {
+            super(itemView);
+            metContent = itemView.findViewById(R.id.listviewsmsacceptruleEditText1);
+            mrbAccept = itemView.findViewById(R.id.listviewsmsacceptruleRadioButton1);
+            mrbRefuse = itemView.findViewById(R.id.listviewsmsacceptruleRadioButton2);
+            mcbEnable = itemView.findViewById(R.id.listviewsmsacceptruleCheckBox1);
+            mbtnUp = itemView.findViewById(R.id.listviewsmsacceptruleButton3);
+            mbtnDown = itemView.findViewById(R.id.listviewsmsacceptruleButton4);
+            mbtnOK = itemView.findViewById(R.id.listviewsmsacceptruleButton1);
+            mbtnDelete = itemView.findViewById(R.id.listviewsmsacceptruleButton2);
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSArrayAdapter.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSArrayAdapter.java
new file mode 100644
index 0000000..513a0eb
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSArrayAdapter.java
@@ -0,0 +1,214 @@
+package cc.winboll.studio.mymessagemanager.adapters;
+
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.view.Gravity;
+import android.view.LayoutInflater;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.BaseAdapter;
+import android.widget.LinearLayout;
+import android.widget.PopupMenu;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.TTSPlayRuleActivity;
+import cc.winboll.studio.mymessagemanager.beans.SMSAcceptRuleBean;
+import cc.winboll.studio.mymessagemanager.beans.SMSBean;
+import cc.winboll.studio.mymessagemanager.utils.NotificationHelper;
+import cc.winboll.studio.mymessagemanager.utils.SMSReceiveRuleUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSRecycleUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSUtil;
+import cc.winboll.studio.mymessagemanager.utils.TTSPlayRuleUtil;
+import cc.winboll.studio.mymessagemanager.views.DateAgoTextView;
+import cc.winboll.studio.mymessagemanager.views.SMSView;
+import java.util.ArrayList;
+
+public class SMSArrayAdapter extends BaseAdapter {
+
+    public static String TAG = "SMSArrayAdapter";
+
+    Context mContext;
+    String mszPhone;
+    ArrayList<SMSBean> mData;
+
+    public SMSArrayAdapter(Context context, String szPhone) {
+        mContext = context;
+        mszPhone = szPhone;
+        mData = new ArrayList<SMSBean>();
+        mData = loadSMSList(context, szPhone);
+    }
+
+    ArrayList<SMSBean> loadSMSList(Context context, String szPhone) {
+        ArrayList<SMSBean> data = SMSUtil.getSMSListByPhone(context, szPhone);
+        SMSBean.sortSMSByDateDesc(data, false);
+        mData.clear();
+        mData.addAll(data);
+        return mData;
+    }
+
+    public void cancelMessageNotification() {
+        for (SMSBean bean : mData) {
+            NotificationHelper notificationHelper = new NotificationHelper(mContext);
+            notificationHelper.cancelNotification(bean.getId());
+        }
+    }
+
+    void deleteSMSById(final int position) {
+        YesNoAlertDialog.show(mContext,
+                              "短信删除提示",
+                              "请确认删除动作！"
+                              , (new YesNoAlertDialog.OnDialogResultListener(){
+
+                                  @Override
+                                  public void onYes() {
+                                      SMSRecycleUtil.addSMSRecycleItem(mContext, (SMSBean)getItem(position));
+                                      SMSUtil.deleteSMSById(mContext, ((SMSBean)getItem(position)).getId());
+                                      mData.remove(position);
+                                      notifyDataSetChanged();
+                                      Toast.makeText(mContext, "SMS delete.", Toast.LENGTH_SHORT).show();
+                                  }
+
+                                  @Override
+                                  public void onNo() {
+
+                                  }
+                              }));
+    }
+
+    public void reLoadSMSList(Context context, String szPhone) {
+        mData = loadSMSList(context, szPhone);
+    }
+
+    @Override
+    public int getCount() {
+        return mData.size();
+    }
+
+    @Override
+    public Object getItem(int p1) {
+        return mData.get(p1);
+    }
+
+    @Override
+    public long getItemId(int p1) {
+        return 0;
+    }
+
+    @Override
+    public View getView(final int position, View convertView, ViewGroup parent) {
+        final ViewHolder viewHolder;
+        if (convertView == null) {
+            viewHolder = new ViewHolder();
+            convertView = LayoutInflater.from(mContext).inflate(R.layout.listview_sms, parent, false);
+            viewHolder.mSMSView = convertView.findViewById(R.id.listviewsmsSMSView1);
+
+            viewHolder.mllMain = convertView.findViewById(R.id.listviewsmspart1LinearLayout1);
+            viewHolder.mllContent = convertView.findViewById(R.id.listviewsmspart1LinearLayout2);
+            viewHolder.mvMenu = convertView.findViewById(R.id.listviewsmspart1View1);
+            viewHolder.mtvBody = (TextView) convertView
+                .findViewById(R.id.listviewsmspart1TextView1);
+            viewHolder.mdatvDate = convertView.findViewById(R.id.listviewsmspart1DateAgoTextView1);
+
+            viewHolder.mvLeft = convertView.findViewById(R.id.listviewsmsView1);
+			viewHolder.mvRight = convertView.findViewById(R.id.listviewsmsView2);
+
+            convertView.setTag(viewHolder);
+        } else {
+            viewHolder = (ViewHolder) convertView.getTag();
+        }
+
+        final SMSBean item = (SMSBean) getItem(position);
+        if (item != null) {
+            if (item.getType() == SMSBean.Type.INBOX) {
+				viewHolder.mvLeft.setVisibility(View.GONE);
+				viewHolder.mvRight.setVisibility(View.VISIBLE);
+
+				viewHolder.mSMSView.setSMSType(SMSView.SMSType.INBOX);
+				viewHolder.mllMain.setGravity(Gravity.LEFT);
+			} else {
+				viewHolder.mvLeft.setVisibility(View.VISIBLE);
+				viewHolder.mvRight.setVisibility(View.GONE);
+				viewHolder.mSMSView.setSMSType(SMSView.SMSType.SEND);
+            }
+
+            //Drawable drawableFrame = AppCompatResources.getDrawable(mContext, R.drawable.bg_frame);
+            //viewHolder.mllContent.setBackground(drawableFrame);
+
+            viewHolder.mtvBody.setText(item.getBody());
+            viewHolder.mdatvDate.setDate(item.getDate());
+            //viewHolder.mtvType.setText(" [" + item.getType().name() + "] ");
+
+            viewHolder.mSMSView.setOnLongClickListener(new View.OnLongClickListener() {
+                    @Override
+                    public boolean onLongClick(View p1) {
+                        // 弹出复制菜单
+                        PopupMenu menu = new PopupMenu(mContext, viewHolder.mvMenu);
+                        //加载菜单资源
+                        menu.getMenuInflater().inflate(R.menu.toolbar_item_sms, menu.getMenu());
+                        //设置点击事件的响应
+                        menu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
+                                @Override
+                                public boolean onMenuItemClick(MenuItem menuItem) {
+                                    int nItemId = menuItem.getItemId();
+                                    if (nItemId == R.id.copy) {
+                                        // Gets a handle to the clipboard service.
+                                        ClipboardManager clipboard = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
+                                        // Creates a new text clip to put on the clipboard
+                                        ClipData clip = ClipData.newPlainText("simple text", item.getBody());
+                                        // Set the clipboard's primary clip.
+                                        clipboard.setPrimaryClip(clip);
+                                        Toast.makeText(mContext, "Copy to clipboard.", Toast.LENGTH_SHORT).show();
+                                    } else if (nItemId == R.id.delete) {
+                                        deleteSMSById(position);
+                                    } else if (nItemId == R.id.addttsrule) {
+                                        Intent intent = new Intent(mContext, TTSPlayRuleActivity.class);
+                                        intent.putExtra(TTSPlayRuleActivity.EXTRA_TTSDEMOTEXT, viewHolder.mtvBody.getText().toString());
+                                        mContext.startActivity(intent);
+                                    } else if (nItemId == R.id.testtts) {
+                                        //Toast.makeText(mContext, "Testing TTS.", Toast.LENGTH_SHORT).show();
+                                        TTSPlayRuleUtil ttsPlayRuleUtil = TTSPlayRuleUtil.getInstance(mContext);
+                                        ttsPlayRuleUtil.speakTTSAnalyzeModeText(viewHolder.mtvBody.getText().toString());
+                                    } else if (nItemId == R.id.testreceivetule) {
+                                        //Toast.makeText(mContext, "Testing Receive Rule.", Toast.LENGTH_SHORT).show();
+                                        SMSReceiveRuleUtil smsReceiveRuleUtil = SMSReceiveRuleUtil.getInstance(mContext, true);
+                                        SMSReceiveRuleUtil.MatchResult matchResult = smsReceiveRuleUtil.getReceiveRuleMatchResult(mContext, viewHolder.mtvBody.getText().toString());
+                                        if (matchResult.matchPositionInRules == SMSReceiveRuleUtil.VALID_MATCHRESULT_POSITION
+                                            || matchResult.matchRuleType == SMSAcceptRuleBean.RuleType.REGEXPPIUTILS_ISPPIOK_FALSE) {
+                                            //ToastUtils.show("Test");
+                                            ToastUtils.show("Not Receive Rule is Matched.\nResult is : " + matchResult.matchRuleType);
+                                        } else {
+                                            ToastUtils.show("MatchResult : " + matchResult.matchRuleType + "\nReceiveRule Match Position : " + Integer.toString(matchResult.matchPositionInRules + 1));
+                                        }
+                                    }
+
+                                    return true;
+                                }
+                            });
+                        //一定要调用show()来显示弹出式菜单
+                        menu.show();
+
+                        return true;
+                    }
+                });
+        }
+
+        return convertView;
+    }
+
+    class ViewHolder {
+        SMSView mSMSView;
+        LinearLayout mllMain;
+        LinearLayout mllContent;
+        TextView mtvBody;
+        View mvMenu;
+        DateAgoTextView mdatvDate;
+        View mvLeft;
+		View mvRight;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSRecycle2Adapter.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSRecycle2Adapter.java
new file mode 100644
index 0000000..a5db2d6
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSRecycle2Adapter.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.mymessagemanager.adapters;
+
+import android.content.Context;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.TextView;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.beans.SMSRecycleBean;
+import cc.winboll.studio.mymessagemanager.utils.AddressUtils;
+import cc.winboll.studio.mymessagemanager.utils.SMSRecycleUtil;
+import cc.winboll.studio.mymessagemanager.views.DateAgoTextView;
+import cc.winboll.studio.mymessagemanager.views.ProtectModeTextView;
+import java.util.ArrayList;
+
+public class SMSRecycle2Adapter extends RecyclerView.Adapter<SMSRecycle2Adapter.ViewHolder> {
+
+    public static final String TAG = "SMSRecycle2Adapter";
+
+    Context mContext;
+    ArrayList<SMSRecycleBean> mDataList;
+    String mszSMSRecycleListDataPath;
+    int mScaleProgress;
+
+    public SMSRecycle2Adapter(Context context, int scaleProgress) {
+        mContext = context;
+        mScaleProgress = scaleProgress;
+        mszSMSRecycleListDataPath = SMSRecycleUtil.getSMSRecycleListDataPath(mContext);
+        mDataList = new ArrayList<SMSRecycleBean>();
+        mDataList = loadSMSRecycleList();
+    }
+
+    public void setScaleProgress(int scaleProgress) {
+        mScaleProgress = scaleProgress;
+    }
+
+    public ArrayList<SMSRecycleBean> loadSMSRecycleList() {
+        ArrayList<SMSRecycleBean> list = new ArrayList<SMSRecycleBean>();
+        SMSRecycleBean.loadBeanListFromFile(mszSMSRecycleListDataPath, list, SMSRecycleBean.class);
+        SMSRecycleBean.sortSMSByDeleteDateDesc(list, true);
+        mDataList.clear();
+        mDataList.addAll(list);
+        return mDataList;
+    }
+
+    @Override
+    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.listview_smsrecycle2, parent, false);
+        return new ViewHolder(view);
+    }
+
+    @Override
+    public void onBindViewHolder(ViewHolder holder, int position) {
+        SMSRecycleBean item = mDataList.get(position);
+        holder.mtvAddress.setText(AddressUtils.getFormattedAddress(item.getAddress()));
+        holder.mdatvDeleteDate.setDate(item.getDeleteDate());
+        holder.mProtectModeTextView.setContentTextWithScale(item.getBody(), mScaleProgress);
+    }
+
+    @Override
+    public int getItemCount() {
+        return mDataList.size();
+    }
+
+    static class ViewHolder extends RecyclerView.ViewHolder {
+        TextView mtvAddress;
+        DateAgoTextView mdatvDeleteDate;
+        ProtectModeTextView mProtectModeTextView;
+
+        ViewHolder(View itemView) {
+            super(itemView);
+            mtvAddress = itemView.findViewById(R.id.listviewsmsrecycle2TextViewAddress);
+            mdatvDeleteDate = itemView.findViewById(R.id.listviewsmsrecycle2DateAgoTextViewDelete);
+            mProtectModeTextView = itemView.findViewById(R.id.listviewsmsrecycle2ProtectModeTextView);
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSRecycleAdapter.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSRecycleAdapter.java
new file mode 100644
index 0000000..2c622c5
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/SMSRecycleAdapter.java
@@ -0,0 +1,290 @@
+package cc.winboll.studio.mymessagemanager.adapters;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 17:07:34
+ * @Describe 短信回收站短信数据适配器
+ */
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.view.Gravity;
+import android.view.LayoutInflater;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.LinearLayout;
+import android.widget.PopupMenu;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.TTSPlayRuleActivity;
+import cc.winboll.studio.mymessagemanager.beans.SMSBean;
+import cc.winboll.studio.mymessagemanager.beans.SMSRecycleBean;
+import cc.winboll.studio.mymessagemanager.utils.AddressUtils;
+import cc.winboll.studio.mymessagemanager.utils.AppConfigUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSRecycleUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSUtil;
+import cc.winboll.studio.mymessagemanager.utils.TTSPlayRuleUtil;
+import cc.winboll.studio.mymessagemanager.utils.UserVisionSystemProtectModeUtil;
+import cc.winboll.studio.mymessagemanager.views.DateAgoTextView;
+import cc.winboll.studio.mymessagemanager.views.SMSView;
+import java.util.ArrayList;
+
+public class SMSRecycleAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
+
+    public static final String TAG = "SMSRecycleAdapter";
+
+    Context mContext;
+    ArrayList<SMSRecycleBean> mDataList;
+    String mszSMSRecycleListDataPath;
+    AppConfigUtil mAppConfigUtil;
+
+    public SMSRecycleAdapter(Context context) {
+        mContext = context;
+        mAppConfigUtil = AppConfigUtil.getInstance(mContext);
+        mszSMSRecycleListDataPath = SMSRecycleUtil.getSMSRecycleListDataPath(mContext);
+        mDataList = new ArrayList<SMSRecycleBean>();
+        mDataList = loadSMSRecycleList();
+    }
+
+    public ArrayList<SMSRecycleBean> loadSMSRecycleList() {
+        ArrayList<SMSRecycleBean> list = new ArrayList<SMSRecycleBean>();
+        SMSRecycleBean.loadBeanListFromFile(mszSMSRecycleListDataPath, list, SMSRecycleBean.class);
+        SMSRecycleBean.sortSMSByDeleteDateDesc(list, true);
+        mDataList.clear();
+        mDataList.addAll(list);
+        for (int i = 0; i < mDataList.size(); i++) {
+            mDataList.get(i).setIsSimpleView(true);
+        }
+        //ToastUtils.show("mDataList.size() : " + Integer.toString(mDataList.size()));
+        return mDataList;
+    }
+
+    public void saveSMSRecycleList() {
+        SMSBean.saveBeanListToFile(mszSMSRecycleListDataPath, mDataList);
+    }
+
+    void restoreSMSRecycleItem(final int position) {
+        YesNoAlertDialog.show(mContext,
+                              "短信恢复提示",
+                              "是否恢复该短信！"
+                              , (new YesNoAlertDialog.OnDialogResultListener(){
+
+                                  @Override
+                                  public void onYes() {
+                                      SMSBean item = mDataList.get(position);
+                                      long nResultId = 0;
+                                      //LogUtils.d(TAG, "item.getType() : " + item.getType());
+                                      if (item.getType() == SMSBean.Type.INBOX) {
+                                          nResultId = SMSUtil.saveReceiveSms(mContext, item.getAddress(), item.getBody(),
+                                                                             (item.getReadStatus() == SMSBean.ReadStatus.READ) ?"1": "0",
+                                                                             item.getDate(), "inbox");
+                                      } else if (item.getType() == SMSBean.Type.SENT) {
+                                          nResultId = SMSUtil.saveOldSendedSMS(mContext, item);
+                                      }
+                                      if (nResultId == 0) {
+                                          ToastUtils.show("SMS Restored Failed!\nPlease confirm that the application has the SMS management authority.");
+                                      } else {
+                                          mDataList.remove(position);
+                                          SMSBean.saveBeanListToFile(mszSMSRecycleListDataPath, mDataList);
+                                          notifyDataSetChanged();
+                                          ToastUtils.show("SMS Restored. ID : " + Long.toString(nResultId));
+                                      }
+                                  }
+
+                                  @Override
+                                  public void onNo() {
+
+                                  }
+                              }));
+    }
+
+    void deleteSMSRecycleItem(final int position) {
+        YesNoAlertDialog.show(mContext,
+                              "短信删除提示",
+                              "请确认删除动作！"
+                              , (new YesNoAlertDialog.OnDialogResultListener(){
+
+                                  @Override
+                                  public void onYes() {
+                                      mDataList.remove(position);
+                                      SMSBean.saveBeanListToFile(mszSMSRecycleListDataPath, mDataList);
+                                      notifyDataSetChanged();
+                                      Toast.makeText(mContext, "SMS delete.", Toast.LENGTH_SHORT).show();
+                                  }
+
+                                  @Override
+                                  public void onNo() {
+
+                                  }
+                              }));
+    }
+
+    public void reLoadSMSList(Context context, String szPhone) {
+        mDataList = loadSMSRecycleList();
+    }
+
+    @Override
+    public int getItemViewType(int position) {
+        if (mDataList.get(position).isSimpleView()) {
+            return 0;
+        } else {
+            return 1;
+        }
+    }
+
+    @Override
+    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+        if (viewType == 0) {
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.listview_smsrecycle_simple, parent, false);
+            return new SimpleViewHolder(view);
+        } else {
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.listview_smsrecycle, parent, false);
+            return new ComplexViewHolder(view);
+        }
+    }
+
+    @Override
+    public void onBindViewHolder(RecyclerView.ViewHolder holder, final int position) {
+        final SMSRecycleBean item = mDataList.get(position);
+        if (holder.getItemViewType() == 0) {
+            SimpleViewHolder viewHolder = (SimpleViewHolder) holder;
+            viewHolder.mtvAddress.setText(AddressUtils.getFormattedAddress(item.getAddress()));
+            viewHolder.mbtnViewBody.setOnClickListener(new View.OnClickListener(){
+                    @Override
+                    public void onClick(View v) {
+                        for (int i = 0; i < mDataList.size(); i++) {
+                            mDataList.get(i).setIsSimpleView(true);
+                        }
+                        item.setIsSimpleView(false);
+                        notifyDataSetChanged();
+                        //ToastUtils.show("setIsSimpleView");
+                    }
+                });
+        } else {
+            final ComplexViewHolder viewHolder = (ComplexViewHolder) holder;
+            if (item.getType() == SMSBean.Type.INBOX) {
+                viewHolder.mvLeft.setVisibility(View.GONE);
+                viewHolder.mvRight.setVisibility(View.VISIBLE);
+
+                viewHolder.mSMSView.setSMSType(SMSView.SMSType.INBOX);
+                viewHolder.mllMain.setGravity(Gravity.LEFT);
+            } else {
+                viewHolder.mvLeft.setVisibility(View.VISIBLE);
+                viewHolder.mvRight.setVisibility(View.GONE);
+                viewHolder.mSMSView.setSMSType(SMSView.SMSType.SEND);
+            }
+            viewHolder.mtvAddress.setText(AddressUtils.getFormattedAddress(item.getAddress()));
+            viewHolder.mdatvDeleteDate.setDate(item.getDeleteDate());
+            viewHolder.mdatvDate.setDate(item.getDate());
+            if(mAppConfigUtil.mAppConfigBean.isSMSRecycleProtectMode()) {
+                viewHolder.mtvBody.setText("ProtectMode : " + UserVisionSystemProtectModeUtil.PreviewShuffleSMS(item.getBody(), mAppConfigUtil.mAppConfigBean.getProtectModerRefuseChars(), mAppConfigUtil.mAppConfigBean.getProtectModerReplaceChars()));
+            } else {
+                viewHolder.mtvBody.setText(item.getBody());
+            }
+            /*viewHolder.mTagsAdapter = new TagsAdapter(mContext, item);
+             RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(mContext);
+             viewHolder.mTagsRecyclerView.setLayoutManager(layoutManager);
+             viewHolder.mTagsRecyclerView.setAdapter(viewHolder.mTagsAdapter);
+             // 这个设置可以解决嵌套listvew的内部listview拉动问题。
+             viewHolder.mTagsRecyclerView.setParentScrollView(viewHolder.mScrollView);*/
+            viewHolder.mllMain.setOnLongClickListener(new View.OnLongClickListener() {
+                    @Override
+                    public boolean onLongClick(View p1) {
+                        // 弹出复制菜单
+                        PopupMenu menu = new PopupMenu(mContext, viewHolder.mvMenu);
+                        //加载菜单资源
+                        menu.getMenuInflater().inflate(R.menu.toolbar_item_smsrecycle, menu.getMenu());
+                        menu.getMenuInflater().inflate(R.menu.toolbar_item_sms, menu.getMenu());
+                        //设置点击事件的响应
+                        menu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
+                                @Override
+                                public boolean onMenuItemClick(MenuItem menuItem) {
+                                    int nItemId = menuItem.getItemId();
+                                    if (nItemId == R.id.item_restoresms) {
+                                        restoreSMSRecycleItem(position);
+                                    } else if (nItemId == R.id.copy) {
+                                        // Gets a handle to the clipboard service.
+                                        ClipboardManager clipboard = (ClipboardManager) mContext.getSystemService(Context.CLIPBOARD_SERVICE);
+                                        // Creates a new text clip to put on the clipboard
+                                        ClipData clip = ClipData.newPlainText("simple text", item.getBody());
+                                        // Set the clipboard's primary clip.
+                                        clipboard.setPrimaryClip(clip);
+                                        Toast.makeText(mContext, "Copy to clipboard.", Toast.LENGTH_SHORT).show();
+                                    } else if (nItemId == R.id.delete) {
+                                        deleteSMSRecycleItem(position);
+                                        /*loadSMSRecycleList();
+                                         mDataList.remove(item);
+                                         saveSMSRecycleList();*/
+                                        notifyDataSetChanged();
+                                    } else if (nItemId == R.id.addttsrule) {
+                                        Intent intent = new Intent(mContext, TTSPlayRuleActivity.class);
+                                        intent.putExtra(TTSPlayRuleActivity.EXTRA_TTSDEMOTEXT, viewHolder.mtvBody.getText().toString());
+                                        mContext.startActivity(intent);
+                                    } else if (nItemId == R.id.testtts) {
+                                        //Toast.makeText(mContext, "Testing TTS.", Toast.LENGTH_SHORT).show();
+                                        TTSPlayRuleUtil ttsPlayRuleUtil = TTSPlayRuleUtil.getInstance(mContext);
+                                        ttsPlayRuleUtil.speakTTSAnalyzeModeText(viewHolder.mtvBody.getText().toString());
+                                    }
+
+                                    return true;
+                                }
+                            });
+                        //一定要调用show()来显示弹出式菜单
+                        menu.show();
+
+                        return true;
+                    }
+                });
+        }
+    }
+
+    @Override
+    public int getItemCount() {
+        return mDataList.size();
+    }
+
+    private static class SimpleViewHolder extends RecyclerView.ViewHolder {
+        TextView mtvAddress;
+        Button mbtnViewBody;
+
+        SimpleViewHolder(View itemView) {
+            super(itemView);
+            mtvAddress = itemView.findViewById(R.id.listviewsmsrecyclesimpleTextView1);
+            mbtnViewBody = itemView.findViewById(R.id.listviewsmsrecyclesimpleButton1);
+        }
+    }
+
+    private static class ComplexViewHolder extends RecyclerView.ViewHolder {
+        TextView mtvAddress;
+        DateAgoTextView mdatvDeleteDate;
+        SMSView mSMSView;
+        LinearLayout mllMain;
+        LinearLayout mllContent;
+        TextView mtvBody;
+        View mvMenu;
+        DateAgoTextView mdatvDate;
+        View mvLeft;
+		View mvRight;
+
+        ComplexViewHolder(View itemView) {
+            super(itemView);
+            mtvAddress = itemView.findViewById(R.id.listviewsmsrecycleTextView1);
+            mdatvDeleteDate = itemView.findViewById(R.id.listviewsmsrecycleDateAgoTextView1);
+            mSMSView = itemView.findViewById(R.id.listviewsmsrecycleSMSView1);
+            mllMain = itemView.findViewById(R.id.listviewsmspart1LinearLayout1);
+            mllContent = itemView.findViewById(R.id.listviewsmspart1LinearLayout2);
+            mvMenu = itemView.findViewById(R.id.listviewsmsrecycleView1);
+            mtvBody = itemView.findViewById(R.id.listviewsmspart1TextView1);
+            mdatvDate = itemView.findViewById(R.id.listviewsmspart1DateAgoTextView1);
+            mvLeft = itemView.findViewById(R.id.listviewsmsrecycleView1);
+            mvRight = itemView.findViewById(R.id.listviewsmsrecycleView2);
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/TTSRuleBeanRecyclerViewAdapter.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/TTSRuleBeanRecyclerViewAdapter.java
new file mode 100644
index 0000000..c424a2f
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/adapters/TTSRuleBeanRecyclerViewAdapter.java
@@ -0,0 +1,193 @@
+package cc.winboll.studio.mymessagemanager.adapters;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/18 16:08:20
+ * @Describe TTSRuleBean RecyclerView Adapter
+ */
+import android.content.Context;
+import android.view.LayoutInflater;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.CheckBox;
+import android.widget.LinearLayout;
+import android.widget.PopupMenu;
+import android.widget.TextView;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.TTSPlayRuleActivity;
+import cc.winboll.studio.mymessagemanager.beans.TTSPlayRuleBean;
+import cc.winboll.studio.mymessagemanager.utils.TTSPlayRuleUtil;
+import cc.winboll.studio.mymessagemanager.views.TTSRuleView;
+import java.util.ArrayList;
+
+public class TTSRuleBeanRecyclerViewAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
+
+    public static final String TAG = "TTSRuleBeanRecyclerViewAdapter";
+
+    Context mContext;
+    ArrayList<TTSPlayRuleBean> mDataList;
+    OnTTSRuleChangeListener mOnTTSRuleChangeListener;
+    TTSPlayRuleUtil mTTSPlayRuleUtil;
+
+    public TTSRuleBeanRecyclerViewAdapter(TTSPlayRuleActivity ttsPlayRuleActivity, OnTTSRuleChangeListener onTTSRuleChangeListener) {
+        mContext = ttsPlayRuleActivity;
+        mOnTTSRuleChangeListener = onTTSRuleChangeListener;
+
+        mTTSPlayRuleUtil = TTSPlayRuleUtil.getInstance(ttsPlayRuleActivity);
+        mTTSPlayRuleUtil.initTTSPlayRuleActivity(ttsPlayRuleActivity);
+		mDataList = mTTSPlayRuleUtil.loadConfigData();
+    }
+
+    public void addNewTTSRuleBean(TTSPlayRuleBean bean) {
+        mTTSPlayRuleUtil.addNewTTSRuleBean(bean);
+        //notifyDataSetChanged();
+	}
+
+    public void saveConfigData() {
+        mTTSPlayRuleUtil.saveConfigData();
+        //notifyDataSetChanged();
+	}
+
+    public void reloadConfigData() {
+        mDataList = mTTSPlayRuleUtil.loadConfigData();
+        notifyDataSetChanged();
+    }
+
+    public interface OnTTSRuleChangeListener {
+        abstract void onTTSRuleChange(TTSPlayRuleBean bean);
+	}
+
+    @Override
+    public int getItemViewType(int position) {
+        if (mDataList.get(position).isSimpleView()) {
+            return 0;
+        } else {
+            return 1;
+        }
+    }
+
+    @Override
+    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+        if (viewType == 0) {
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.listview_ttsplayrule_simple, parent, false);
+            return new SimpleViewHolder(view);
+        } else {
+            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.listview_ttsplayrule, parent, false);
+            return new ComplexViewHolder(view);
+        }
+    }
+
+    @Override
+    public void onBindViewHolder(RecyclerView.ViewHolder holder, final int position) {
+        final TTSPlayRuleBean item = mDataList.get(position);
+        if (holder.getItemViewType() == 0) {
+            SimpleViewHolder viewHolder = (SimpleViewHolder) holder;
+            viewHolder.mSortNumber.setText(Integer.toString(position + 1));
+            viewHolder.mtvDemoSMSText.setText(item.getDemoSMSText());
+        } else {
+            final ComplexViewHolder viewHolder = (ComplexViewHolder) holder;
+            viewHolder.mSortNumber.setText(Integer.toString(position + 1));
+            viewHolder.mtvDemoSMSText.setText(item.getDemoSMSText());
+            viewHolder.mTTSRuleView.setOnClickListener(new View.OnClickListener(){
+                    @Override
+                    public void onClick(View v) {
+                        mOnTTSRuleChangeListener.onTTSRuleChange(item);
+                    }
+                });
+            viewHolder.mbtnUp.setOnClickListener(new View.OnClickListener(){
+                    @Override
+                    public void onClick(View v) {
+                        //Toast.makeText(mContext, Integer.toString(position), Toast.LENGTH_SHORT).show();
+                        mTTSPlayRuleUtil.changeBeanPosition(position, true);
+                        //notifyDataSetChanged();
+                    }
+                });
+            viewHolder.mbtnDown.setOnClickListener(new View.OnClickListener(){
+                    @Override
+                    public void onClick(View v) {
+                        //Toast.makeText(mContext, Integer.toString(position), Toast.LENGTH_SHORT).show();
+                        mTTSPlayRuleUtil.changeBeanPosition(position, false);
+                        //notifyDataSetChanged();
+                    }
+                });
+            viewHolder.mchbEnable.setChecked(item.isEnable());
+            viewHolder.mchbEnable.setOnClickListener(new View.OnClickListener(){
+                    @Override
+                    public void onClick(View v) {
+                        mTTSPlayRuleUtil.setBeanEnable(position, ((CheckBox)v).isChecked());
+                        //notifyDataSetChanged();
+                    }
+                });
+            viewHolder.mTTSRuleView.setOnLongClickListener(new View.OnLongClickListener() {
+
+                    @Override
+                    public boolean onLongClick(View p1) {
+                        // 弹出复制菜单
+                        PopupMenu menu = new PopupMenu(mContext, viewHolder.mSortNumber);
+                        //加载菜单资源
+                        menu.getMenuInflater().inflate(R.menu.toolbar_ttsrule, menu.getMenu());
+                        //设置点击事件的响应
+                        menu.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
+                                @Override
+                                public boolean onMenuItemClick(MenuItem menuItem) {
+                                    int nItemId = menuItem.getItemId();
+                                    if (nItemId == R.id.deletettsrule) {
+                                        mTTSPlayRuleUtil.deleteTTSRuleBean(position);
+                                        //notifyDataSetChanged();
+                                    }
+
+                                    return true;
+                                }
+                            });
+                        //一定要调用show()来显示弹出式菜单
+                        menu.show();
+
+                        return true;
+                    }
+                });
+        }
+    }
+
+    @Override
+    public int getItemCount() {
+        return mDataList.size();
+    }
+
+    private static class SimpleViewHolder extends RecyclerView.ViewHolder {
+        TextView mSortNumber;
+        TextView mtvDemoSMSText;
+
+
+        SimpleViewHolder(View itemView) {
+            super(itemView);
+            mSortNumber = itemView.findViewById(R.id.itemttsplayrulesimpleTextView2);
+            mtvDemoSMSText = itemView.findViewById(R.id.itemttsplayrulesimpleTextView1);
+
+        }
+    }
+
+    private static class ComplexViewHolder extends RecyclerView.ViewHolder {
+        TextView mSortNumber;
+        TTSRuleView mTTSRuleView;
+        LinearLayout mllMain;
+        TextView mtvDemoSMSText;
+        Button mbtnUp;
+        Button mbtnDown;
+        CheckBox mchbEnable;
+
+        ComplexViewHolder(View itemView) {
+            super(itemView);
+            mSortNumber = itemView.findViewById(R.id.itemttsplayruleTextView2);
+            mTTSRuleView = itemView.findViewById(R.id.listviewttsplayruleTTSRuleView1);
+            mllMain = itemView.findViewById(R.id.itemttsplayruleLinearLayout1);
+            mtvDemoSMSText = itemView.findViewById(R.id.itemttsplayruleTextView1);
+            mbtnUp = itemView.findViewById(R.id.itemttsplayruleButton1);
+            mbtnDown = itemView.findViewById(R.id.itemttsplayruleButton2);
+            mchbEnable = itemView.findViewById(R.id.itemttsplayruleCheckBox1);
+
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/AppConfigBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/AppConfigBean.java
new file mode 100644
index 0000000..689a888
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/AppConfigBean.java
@@ -0,0 +1,197 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/02 20:07:44
+ * @Describe 应用配置数据类
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class AppConfigBean extends BaseBean {
+
+    public static final String TAG = "AppConfigBean";
+
+    // 当前国家代码(如+8612345678901代码就是86.)
+    String countryCode = "86";
+    // 是否合并的手机号码前缀
+    boolean isMergeCountryCodePrefix = true;
+    // TT语音延时播放毫秒数
+    int ttsPlayDelayTimes = 3000;
+    boolean isEnableService = false;
+    boolean isEnableOnlyReceiveContacts = false;
+    boolean isEnableTTS = false;
+    boolean isEnableTTSRuleMode = false;
+    boolean isSMSRecycleProtectMode = false;
+    // 保护式预览拒绝显示的字符集
+    String protectModerRefuseChars = "设定被和谐的字符";
+    // 保护式预览拒绝显示的字符集的替代字符
+    String protectModerReplaceChars = "当前替代显示字符";
+    // 回收站打开的窗口类名 SMSRecycleActivity / SMSRecycle2Activity
+    String recycleBinClass = "SMSRecycleActivity";
+    //int appThemeID = ThemeUtil.getThemeID(ThemeUtil.BaseTheme.DEFAULT);
+
+    public void setProtectModerRefuseChars(String protectModerRefuseChars) {
+        this.protectModerRefuseChars = protectModerRefuseChars;
+    }
+
+    public String getProtectModerRefuseChars() {
+        return protectModerRefuseChars;
+    }
+
+    public void setProtectModerReplaceChars(String protectModerReplaceChars) {
+        this.protectModerReplaceChars = protectModerReplaceChars;
+    }
+
+    public String getProtectModerReplaceChars() {
+        return protectModerReplaceChars;
+    }
+
+    public void setRecycleBinClass(String recycleBinClass) {
+        this.recycleBinClass = recycleBinClass;
+    }
+
+    public String getRecycleBinClass() {
+        return recycleBinClass;
+    }
+
+    public void setIsSMSRecycleProtectMode(boolean isSMSRecycleProtectMode) {
+        this.isSMSRecycleProtectMode = isSMSRecycleProtectMode;
+    }
+
+    public boolean isSMSRecycleProtectMode() {
+        return isSMSRecycleProtectMode;
+    }
+
+    public void setCountryCode(String countryCode) {
+        this.countryCode = countryCode;
+    }
+
+    public String getCountryCode() {
+        return countryCode;
+    }
+
+    public void setIsMergeCountryCodePrefix(boolean isMergeCountryCodePrefix) {
+        this.isMergeCountryCodePrefix = isMergeCountryCodePrefix;
+    }
+
+    public boolean isMergeCountryCodePrefix() {
+        return isMergeCountryCodePrefix;
+    }
+
+    public void setTtsPlayDelayTimes(int ttsPlayDelayTimes) {
+        this.ttsPlayDelayTimes = ttsPlayDelayTimes;
+    }
+
+    public int getTtsPlayDelayTimes() {
+        return ttsPlayDelayTimes;
+    }
+
+    public void setIsEnableService(boolean isEnableService) {
+        this.isEnableService = isEnableService;
+    }
+
+    public boolean isEnableService() {
+        return isEnableService;
+    }
+
+    public void setIsEnableOnlyReceiveContacts(boolean isEnableOnlyReceiveContacts) {
+        this.isEnableOnlyReceiveContacts = isEnableOnlyReceiveContacts;
+    }
+
+    public boolean isEnableOnlyReceiveContacts() {
+        return isEnableOnlyReceiveContacts;
+    }
+
+    public void setIsEnableTTS(boolean isEnableTTS) {
+        this.isEnableTTS = isEnableTTS;
+    }
+
+    public boolean isEnableTTS() {
+        return isEnableTTS;
+    }
+
+    public void setIsEnableTTSRuleMode(boolean isEnableTTSRuleMode) {
+        this.isEnableTTSRuleMode = isEnableTTSRuleMode;
+    }
+
+    public boolean isEnableTTSRuleMode() {
+        return isEnableTTSRuleMode;
+    }
+
+    /*public void setAppThemeID(int appThemeID) {
+        this.appThemeID = appThemeID;
+    }
+
+    public int getAppThemeID() {
+        return appThemeID;
+    }
+
+    public void setAppTheme(ThemeUtil.BaseTheme baseTheme) {
+        setAppThemeID(ThemeUtil.getThemeID(baseTheme));
+    }*/
+
+    @Override
+    public String getName() {
+        return AppConfigBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        AppConfigBean bean = this;
+        jsonWriter.name("countryCode").value(bean.getCountryCode());
+        jsonWriter.name("isMergeCountryCodePrefix").value(bean.isMergeCountryCodePrefix());
+        jsonWriter.name("ttsPlayDelayTimes").value(bean.getTtsPlayDelayTimes());
+        jsonWriter.name("isEnableService").value(bean.isEnableService());
+        jsonWriter.name("isEnableOnlyReceiveContacts").value(bean.isEnableOnlyReceiveContacts());
+        jsonWriter.name("isEnableTTS").value(bean.isEnableTTS());
+        jsonWriter.name("isEnableTTSRuleMode").value(bean.isEnableTTSRuleMode());
+        jsonWriter.name("isSMSRecycleProtectMode").value(bean.isSMSRecycleProtectMode());
+        jsonWriter.name("protectModerRefuseChars").value(bean.getProtectModerRefuseChars());
+        jsonWriter.name("protectModerReplaceChars").value(bean.getProtectModerReplaceChars());
+        jsonWriter.name("recycleBinClass").value(bean.getRecycleBinClass());
+        //jsonWriter.name("appThemeID").value(bean.getAppThemeID());
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        AppConfigBean bean = new AppConfigBean();
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (name.equals("countryCode")) {
+                bean.setCountryCode(jsonReader.nextString());
+            } else if (name.equals("isMergeCountryCodePrefix")) {
+                bean.setIsMergeCountryCodePrefix(jsonReader.nextBoolean());
+            } else if (name.equals("ttsPlayDelayTimes")) {
+                bean.setTtsPlayDelayTimes(jsonReader.nextInt());
+            } else if (name.equals("isEnableService")) {
+                bean.setIsEnableService(jsonReader.nextBoolean());
+            } else if (name.equals("isEnableOnlyReceiveContacts")) {
+                bean.setIsEnableOnlyReceiveContacts(jsonReader.nextBoolean());
+            } else if (name.equals("isEnableTTS")) {
+                bean.setIsEnableTTS(jsonReader.nextBoolean());
+            } else if (name.equals("isEnableTTSRuleMode")) {
+                bean.setIsEnableTTSRuleMode(jsonReader.nextBoolean());
+            } else if (name.equals("isSMSRecycleProtectMode")) {
+                bean.setIsSMSRecycleProtectMode(jsonReader.nextBoolean());
+            } else if (name.equals("protectModerRefuseChars")) {
+                bean.setProtectModerRefuseChars(jsonReader.nextString());
+            } else if (name.equals("protectModerReplaceChars")) {
+                bean.setProtectModerReplaceChars(jsonReader.nextString());
+            } else if (name.equals("recycleBinClass")) {
+                bean.setRecycleBinClass(jsonReader.nextString());
+            } /*else if (name.equals("appThemeID")) {
+                bean.setAppThemeID(jsonReader.nextInt());
+            }*/ else {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return bean;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/AppConfigBean_V1.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/AppConfigBean_V1.java
new file mode 100644
index 0000000..4c1b789
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/AppConfigBean_V1.java
@@ -0,0 +1,88 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2023/06/30 23:21:27
+ * @Describe 应用配置数据类，V1 旧版。
+ */
+import cc.winboll.studio.mymessagemanager.utils.ThemeUtil;
+
+public class AppConfigBean_V1 {
+
+    // 当前国家代码(如+8612345678901代码就是86.)
+    String countryCode = "86";
+    // 是否合并的手机号码前缀
+    boolean isMergeCountryCodePrefix = true;
+    // TT语音延时播放毫秒数
+    int ttsPlayDelayTimes = 3000;
+    boolean enableService = false;
+    boolean enableOnlyReceiveContacts = false;
+    boolean enableTTS = false;
+    boolean enableTTSRuleMode = false;
+    //int appThemeID = ThemeUtil.getThemeID(ThemeUtil.BaseTheme.DEFAULT);
+
+    public void setCountryCode(String countryCode) {
+        this.countryCode = countryCode;
+    }
+
+    public String getCountryCode() {
+        return countryCode;
+    }
+
+    public void setIsMergeCountryCodePrefix(boolean isMergeCountryCodePrefix) {
+        this.isMergeCountryCodePrefix = isMergeCountryCodePrefix;
+    }
+
+    public boolean isMergeCountryCodePrefix() {
+        return isMergeCountryCodePrefix;
+    }
+
+    public void setTtsPlayDelayTimes(int ttsPlayDelayTimes) {
+        this.ttsPlayDelayTimes = ttsPlayDelayTimes;
+    }
+
+    public int getTtsPlayDelayTimes() {
+        return ttsPlayDelayTimes;
+    }
+
+    public void setEnableService(boolean enableService) {
+        this.enableService = enableService;
+    }
+
+    public boolean isEnableService() {
+        return enableService;
+    }
+
+    public void setEnableOnlyReceiveContacts(boolean enableOnlyReceiveContacts) {
+        this.enableOnlyReceiveContacts = enableOnlyReceiveContacts;
+    }
+
+    public boolean isEnableOnlyReceiveContacts() {
+        return enableOnlyReceiveContacts;
+    }
+
+    public void setEnableTTS(boolean enableTTS) {
+        this.enableTTS = enableTTS;
+    }
+
+    public boolean isEnableTTS() {
+        return enableTTS;
+    }
+
+    public void setEnableTTSRuleMode(boolean enableTTSRuleMode) {
+        this.enableTTSRuleMode = enableTTSRuleMode;
+    }
+
+    public boolean isEnableTTSRuleMode() {
+        return enableTTSRuleMode;
+    }
+
+    /*public void setAppThemeID(int appThemeID) {
+        this.appThemeID = appThemeID;
+    }
+
+    public int getAppThemeID() {
+        return appThemeID;
+    }*/
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/ContractsBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/ContractsBean.java
new file mode 100644
index 0000000..0a1cf81
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/ContractsBean.java
@@ -0,0 +1,29 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+public class ContractsBean {
+
+    private String mszName;
+    private String mszTelPhone;
+
+    public ContractsBean(String szName, String szTelPhone) {
+        this.mszName = szName;
+        this.mszTelPhone = szTelPhone;
+    }
+
+    public void setName(String szName) {
+        this.mszName = szName;
+    }
+
+    public String getName() {
+        return mszName;
+    }
+
+    public void setTelPhone(String szTelPhone) {
+        this.mszTelPhone = szTelPhone;
+    }
+
+    public String getTelPhone() {
+        return mszTelPhone;
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/MessageNotificationBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/MessageNotificationBean.java
new file mode 100644
index 0000000..338e215
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/MessageNotificationBean.java
@@ -0,0 +1,53 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 13:10:44
+ * @Describe 短信通知栏消息结构
+ */
+public class MessageNotificationBean {
+
+    private int messageId;
+    private String mszPhone;
+    private String mszTitle;
+    private String mszContent;
+
+    public MessageNotificationBean(int messageId, String mszPhone, String mszTitle, String mszContent) {
+        this.messageId = messageId;
+        this.mszPhone = mszPhone;
+        this.mszTitle = mszTitle;
+        this.mszContent = mszContent;
+    }
+
+    public void setMessageId(int messageId) {
+        this.messageId = messageId;
+    }
+
+    public int getMessageId() {
+        return messageId;
+    }
+
+    public void setPhone(String szPhone) {
+        this.mszPhone = szPhone;
+    }
+
+    public String getPhone() {
+        return mszPhone;
+    }
+
+    public void setTitle(String szTitle) {
+        this.mszTitle = szTitle;
+    }
+
+    public String getTitle() {
+        return mszTitle;
+    }
+
+    public void setContent(String szContent) {
+        this.mszContent = szContent;
+    }
+
+    public String getContent() {
+        return mszContent;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/PhoneBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/PhoneBean.java
new file mode 100644
index 0000000..b1e92ff
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/PhoneBean.java
@@ -0,0 +1,39 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 13:10:44
+ * @Describe 联系人信息类
+ */
+public class PhoneBean {
+
+    //联系人姓名
+    private String mszName;
+    //电话号码
+    private String mszTelPhone;
+
+    public String getName() {
+        return mszName;
+    }
+
+    public void setName(String szName) {
+        this.mszName = szName;
+    }
+
+    public String getTelPhone() {
+        return mszTelPhone;
+    }
+
+    public void setTelPhone(String szTelPhone) {
+        this.mszTelPhone = szTelPhone;
+    }
+
+    public PhoneBean() {
+    }
+
+    public PhoneBean(String szName, String szTelPhone) {
+        this.mszName = szName;
+        this.mszTelPhone = szTelPhone;
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSAcceptRuleBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSAcceptRuleBean.java
new file mode 100644
index 0000000..377d27c
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSAcceptRuleBean.java
@@ -0,0 +1,121 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/30 10:57:14
+ * @Describe 短信接收规则类
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class SMSAcceptRuleBean extends BaseBean {
+
+    public static final String TAG = "SMSAcceptRuleBean";
+
+    // 规则类型枚举
+    public enum RuleType { ACCEPT, REFUSE, REGEXPPIUTILS_ISPPIOK_FALSE }
+    
+    // 用户ID
+    int userId = -1;
+    // 规则数据
+    String ruleData = "";
+    // 是否启用
+    boolean isEnable = false;
+    // 规则类型
+    RuleType ruleType = RuleType.REFUSE;
+    // 是否简单视图
+    boolean isSimpleView = false;
+
+    public SMSAcceptRuleBean() {}
+
+    public SMSAcceptRuleBean(int userId, String ruleData, boolean isEnable, RuleType ruleType, boolean isSimpleView) {
+        this.userId = userId;
+        this.ruleData = ruleData;
+        this.isEnable = isEnable;
+        this.ruleType = ruleType;
+        this.isSimpleView = isSimpleView;
+    }
+
+    public void setRuleType(RuleType ruleType) {
+        this.ruleType = ruleType;
+    }
+
+    public RuleType getRuleType() {
+        return ruleType;
+    }
+    
+    public void setIsSimpleView(boolean isSimpleView) {
+        this.isSimpleView = isSimpleView;
+    }
+
+    public boolean isSimpleView() {
+        return isSimpleView;
+    }
+
+    public void setUserId(int userID) {
+        this.userId = userID;
+    }
+
+    public int getUserId() {
+        return userId;
+    }
+
+    public void setRuleData(String ruleData) {
+        this.ruleData = ruleData;
+    }
+
+    public String getRuleData() {
+        return ruleData;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    @Override
+    public String getName() {
+        return SMSAcceptRuleBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        SMSAcceptRuleBean bean = this;
+        jsonWriter.name("userId").value(bean.getUserId());
+        jsonWriter.name("ruleData").value(bean.getRuleData());
+        jsonWriter.name("isEnable").value(bean.isEnable());
+        jsonWriter.name("ruleType").value(bean.getRuleType().ordinal());
+        jsonWriter.name("isSimpleView").value(bean.isSimpleView());
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        SMSAcceptRuleBean bean = new SMSAcceptRuleBean();
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (name.equals("userId")) {
+                bean.setUserId(jsonReader.nextInt());
+            } else if (name.equals("ruleData")) {
+                bean.setRuleData(jsonReader.nextString());
+            } else if (name.equals("isEnable")) {
+                bean.setIsEnable(jsonReader.nextBoolean());
+            } else if (name.equals("ruleType")) {
+                bean.setRuleType(RuleType.values()[jsonReader.nextInt()]);
+            } else if (name.equals("isSimpleView")) {
+                bean.setIsSimpleView(jsonReader.nextBoolean());
+            } else {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return bean;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSAcceptRuleBean_V1.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSAcceptRuleBean_V1.java
new file mode 100644
index 0000000..4ac5797
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSAcceptRuleBean_V1.java
@@ -0,0 +1,50 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/30 10:57:14
+ * @Describe 短信接收规则类，V1 旧版。
+ */
+public class SMSAcceptRuleBean_V1 {
+
+    public static final String TAG = "SMSAcceptRuleBean_V1";
+
+    // 用户ID
+    String userID = "";
+    // 规则数据
+    String ruleData = "";
+    // 是否启用
+    boolean enable = false;
+
+    public SMSAcceptRuleBean_V1() {}
+
+    public SMSAcceptRuleBean_V1(String userID, String ruleData, boolean enable) {
+        this.userID = userID;
+        this.ruleData = ruleData;
+        this.enable = enable;
+    }
+
+    public void setUserID(String userID) {
+        this.userID = userID;
+    }
+
+    public String getUserID() {
+        return userID;
+    }
+
+    public void setRuleData(String ruleData) {
+        this.ruleData = ruleData;
+    }
+
+    public String getRuleData() {
+        return ruleData;
+    }
+
+    public void setEnable(boolean enable) {
+        this.enable = enable;
+    }
+
+    public boolean isEnable() {
+        return enable;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSBean.java
new file mode 100644
index 0000000..c76df2f
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSBean.java
@@ -0,0 +1,272 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/30 10:57:14
+ * @Describe 短信信息类
+ 参考资料：
+ https://blog.csdn.net/freeking101/article/details/121575985
+
+ 获取短信只需要得到 ContentResolver 就行了，它的 URI 主要有：
+ content://sms/          所有短信
+ content://sms/inbox     收件箱
+ content://sms/sent      已发送
+ content://sms/draft     草稿
+ content://sms/outbox    发件箱
+ content://sms/failed    发送失败
+ content://sms/queued    待发送列表
+ SMS 数据库中的字段如下：
+ _id        一个自增字段，从1开始
+ thread_id  序号，同一发信人的id相同
+ address    发件人手机号码
+ person     联系人列表里的序号，陌生人为null
+ date       发件日期
+ protocol   协议，分为： 0 SMS_RPOTO, 1 MMS_PROTO
+ read       是否阅读 0未读， 1已读
+ status     状态 -1接收，0 complete, 64 pending, 128 failed
+ type       ALL = 0;INBOX = 1;SENT = 2;DRAFT = 3;OUTBOX = 4;FAILED = 5; QUEUED = 6;
+ body       短信内容
+ service_center 短信服务中心号码编号。如+8613800755500
+ subject        短信的主题
+ reply_path_present TP-Reply-Path
+ locked
+ */
+import android.content.ContentValues;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+import java.text.Collator;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+
+public class SMSBean extends BaseBean {
+
+    //public enum Type { ALL(8), INBOX(0), SENT, DRAFT, OUTBOX, FAILED, QUEUED, TRASH }
+    public enum Type { ALL(0), INBOX(1), SENT(2), DRAFT(3), OUTBOX(4), FAILED(5), QUEUED(6), TRASH(7);
+        static String[] _mlistName = { "所有短信", "接收", "发送", "草稿", "发件箱", "发送失败", "待发送列表", "回收站" };
+        private int value = 0;
+        private Type(int value) {    //必须是private的，否则编译错误
+            this.value = value;
+        }
+    }
+
+    public enum ReadStatus { UNREAD, READ }
+
+    transient private static String _ContentValuesName_address = "address";
+    transient private static String _ContentValuesName_body = "body";
+    transient private static String _ContentValuesName_read = "read";
+    transient private static String _ContentValuesName_date = "date";
+
+    // 短信标识
+    protected int id;
+    // 发件人手机号码
+    protected String mszAddress;
+    // 短信内容
+    protected String mszBody;
+    // 发件日期
+    protected long mnDate;
+    // 短息归类
+    protected Type mType;
+    // 是否阅读
+    protected ReadStatus mReadStatus;
+    // 联系人列表里的序号，陌生人为null
+    protected int mnPerson;
+    
+    public SMSBean() {
+        this.id = -1;
+        this.mszAddress = "";
+        this.mszBody = "";
+        this.mnDate = 0;
+        this.mType = Type.INBOX;
+        this.mReadStatus = ReadStatus.UNREAD;
+        this.mnPerson = 0;
+    }
+    
+    public SMSBean(int id, String mszAddress, String mszBody, long mnDate, Type mType, ReadStatus mReadStatus, int mnPerson) {
+        this.id = id;
+        this.mszAddress = mszAddress;
+        this.mszBody = mszBody;
+        this.mnDate = mnDate;
+        this.mType = mType;
+        this.mReadStatus = mReadStatus;
+        this.mnPerson = mnPerson;
+    }
+
+    public void setId(int id) {
+        this.id = id;
+    }
+
+    public int getId() {
+        return id;
+    }
+
+    public void setAddress(String szAddress) {
+        this.mszAddress = szAddress;
+    }
+
+    public String getAddress() {
+        return mszAddress;
+    }
+
+    public void setBody(String szBody) {
+        this.mszBody = szBody;
+    }
+
+    public String getBody() {
+        return mszBody;
+    }
+
+    public void setDate(long date) {
+        this.mnDate = date;
+    }
+
+    public long getDate() {
+        return mnDate;
+    }
+
+    public void setType(Type type) {
+        this.mType = type;
+    }
+
+    public Type getType() {
+        return mType;
+    }
+
+    public void setReadStatus(ReadStatus readStatus) {
+        this.mReadStatus = readStatus;
+    }
+
+    public ReadStatus getReadStatus() {
+        return mReadStatus;
+    }
+
+    public void setPerson(int person) {
+        this.mnPerson = person;
+    }
+
+    public int getPerson() {
+        return mnPerson;
+    }
+
+    @Override
+    public String getName() {
+        return SMSBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        SMSBean bean = this;
+        jsonWriter.name("id").value(bean.getId());
+        jsonWriter.name("mszAddress").value(bean.getAddress());
+        jsonWriter.name("mszBody").value(bean.getBody());
+        jsonWriter.name("mnDate").value(bean.getDate());
+        jsonWriter.name("mType").value(bean.getType().ordinal());
+        jsonWriter.name("mReadStatus").value(bean.getReadStatus().ordinal());
+        jsonWriter.name("mnPerson").value(bean.getPerson());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if(super.initObjectsFromJsonReader(jsonReader, name)) { return true; }
+        else{
+            if (name.equals("id")) {
+                setId(jsonReader.nextInt());
+            } else if (name.equals("mszAddress")) {
+                setAddress(jsonReader.nextString());
+            } else if (name.equals("mszBody")) {
+                setBody(jsonReader.nextString());
+            } else if (name.equals("mnDate")) {
+                setDate(jsonReader.nextLong());
+            } else if (name.equals("mType")) {
+                setType(Type.values()[jsonReader.nextInt()]);
+            } else if (name.equals("mReadStatus")) {
+                setReadStatus(ReadStatus.values()[jsonReader.nextInt()]);
+            } else if (name.equals("mnPerson")) {
+                setPerson(jsonReader.nextInt());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if(!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+    
+    public static ContentValues createOldSendedSMSContentValues(SMSBean smsBean) {
+        ContentValues result = new ContentValues();
+        result.put(_ContentValuesName_address, smsBean.mszAddress);
+        result.put(_ContentValuesName_body, smsBean.mszBody);
+        result.put(_ContentValuesName_read, smsBean.mReadStatus.toString()); //"0" for have not read sms and "1" for have read sms
+        result.put(_ContentValuesName_date, Long.toString(smsBean.getDate()));
+
+        return result;
+    }
+
+    public static ContentValues createSendedSMSContentValues(SMSBean smsBean) {
+        ContentValues result = new ContentValues();
+        result.put(_ContentValuesName_address, smsBean.mszAddress);
+        result.put(_ContentValuesName_body, smsBean.mszBody);
+        result.put(_ContentValuesName_read, smsBean.mReadStatus.toString()); //"0" for have not read sms and "1" for have read sms
+        result.put(_ContentValuesName_date, Long.toString(System.currentTimeMillis()));
+
+        return result;
+    }
+
+    public static String getTypeName(Type type) {
+        return Type._mlistName[type.ordinal()];
+    }
+
+    @Override
+    public String toString() {
+        String szResult = "\n";
+        szResult += "mszAddress is (" + mszAddress + ")\n";
+        szResult += "mszBody is (" + mszBody + ")\n";
+        szResult += "mnDate is (" + Long.toString(mnDate) + ")\n";
+        szResult += "mType is (" + mType.name() + ")\n";
+        if (mReadStatus != null) {
+            szResult += "mReadStatus is (" + mReadStatus.name() + ")\n";
+        }
+        szResult += "mnPerson is (" + Integer.toString(mnPerson) + ")\n";
+
+
+        return szResult;
+    }
+
+    public static void sortSMSByDateDesc(ArrayList<SMSBean> list, boolean isDesc) {
+        Collections.sort(list, new SortSMSByDateDesc(isDesc));
+
+    }
+
+    private static class SortSMSByDateDesc implements Comparator<SMSBean> {
+        private boolean mIsDesc = true;
+        // isDesc 是否降序排列
+        public SortSMSByDateDesc(boolean isDesc) {
+            mIsDesc = isDesc;
+        }
+        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
+        @Override
+        public int compare(SMSBean o1, SMSBean o2) {
+            boolean b0_1 = (o1.getDate() < o2.getDate());
+            if (mIsDesc) {
+                return b0_1 ?1: -1;
+            } else {
+                return b0_1 ?-1: 1;
+            }
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSRecycleBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSRecycleBean.java
new file mode 100644
index 0000000..aaecccc
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/SMSRecycleBean.java
@@ -0,0 +1,127 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/20 01:51:44
+ * @Describe 回收站短信存储类
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+import java.text.Collator;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+
+public class SMSRecycleBean extends SMSBean {
+
+    public static final String TAG = "SMSRecycleBean";
+
+    // 短信删除日期
+    long deleteDate;
+    // 当前是否是简单视图
+    boolean isSimpleView;
+
+    public void setDeleteDate(long deleteDate) {
+        this.deleteDate = deleteDate;
+    }
+
+    public long getDeleteDate() {
+        return deleteDate;
+    }
+
+    public void setIsSimpleView(boolean isSimpleView) {
+        this.isSimpleView = isSimpleView;
+    }
+
+    public boolean isSimpleView() {
+        return isSimpleView;
+    }
+
+    public SMSRecycleBean() {
+
+    }
+
+    public SMSRecycleBean(SMSBean smsBean, long deleteDate) {
+        super.id = smsBean.getId();
+        super.mszAddress = smsBean.getAddress();
+        super.mszBody = smsBean.getBody();
+        super.mnDate = smsBean.getDate();
+        super.mType = smsBean.getType();
+        super.mReadStatus = smsBean.getReadStatus();
+        super.mnPerson = smsBean.getPerson();
+        this.deleteDate = deleteDate;
+        this.isSimpleView = true;
+    }
+
+    @Override
+    public String getName() {
+        return SMSRecycleBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        SMSRecycleBean bean = this;
+        jsonWriter.name("deleteDate").value(bean.getDeleteDate());
+        jsonWriter.name("isSimpleView").value(bean.isSimpleView());
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        /*SMSRecycleBean bean = new SMSRecycleBean((SMSBean)super.readBeanFromJsonReader(jsonReader), 0);
+         // 只有在读取完成后，才能获取整个JSON字符串
+         String completeJson = jsonReader.toString();
+         JsonReader newJsonReader = new JsonReader(new StringReader(completeJson));
+         newJsonReader.setLenient(true);
+         LogUtils.d(TAG, completeJson);*/
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if(super.initObjectsFromJsonReader(jsonReader, name)) { return true; }
+        else{
+            if (name.equals("deleteDate")) {
+                setDeleteDate(jsonReader.nextLong());
+            } else if (name.equals("isSimpleView")) {
+                setIsSimpleView(jsonReader.nextBoolean());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    public static void sortSMSByDeleteDateDesc(ArrayList<SMSRecycleBean> list, boolean isDesc) {
+        Collections.sort(list, new SortSMSByDeleteDateDesc(isDesc));
+    }
+
+    private static class SortSMSByDeleteDateDesc implements Comparator<SMSRecycleBean> {
+        private boolean mIsDesc = true;
+        // isDesc 是否降序排列
+        public SortSMSByDeleteDateDesc(boolean isDesc) {
+            mIsDesc = isDesc;
+        }
+        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
+        @Override
+        public int compare(SMSRecycleBean o1, SMSRecycleBean o2) {
+            boolean b0_1 = (o1.getDeleteDate() < o2.getDeleteDate());
+            if (mIsDesc) {
+                return b0_1 ?1: -1;
+            } else {
+                return b0_1 ?-1: 1;
+            }
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSPlayRuleBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSPlayRuleBean.java
new file mode 100644
index 0000000..1669a5f
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSPlayRuleBean.java
@@ -0,0 +1,147 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/28 20:22:12
+ * @Describe TTS 语音播放规则类
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class TTSPlayRuleBean extends BaseBean {
+
+    public static final String TAG = "TTSPlayRuleBean";
+
+    // 用户ID
+    int userId = -1;
+    // TTS语音规则名称
+    String ruleName = "";
+    // 短信测试文本
+    String demoSMSText = "";
+    // 短信内容查询正则文本
+    String patternText = "";
+    // TTS语音播报正则文本
+    String ttsRuleText = "";
+    // 是否启用简单视图
+    boolean isSimpleView = false;
+    // 是否启用规则
+    boolean isEnable = false;
+
+    public TTSPlayRuleBean() {}
+
+    public TTSPlayRuleBean(int userId, String ruleName, String demoSMSText, String patternText, String ttsRuleText, boolean isSimpleView, boolean isEnable) {
+        this.userId = userId;
+        this.ruleName = ruleName;
+        this.demoSMSText = demoSMSText;
+        this.patternText = patternText;
+        this.ttsRuleText = ttsRuleText;
+        this.isSimpleView = isSimpleView;
+        this.isEnable = isEnable;
+    }
+
+    public void setUserId(int userId) {
+        this.userId = userId;
+    }
+
+    public int getUserId() {
+        return userId;
+    }
+
+    public void setRuleName(String ruleName) {
+        this.ruleName = ruleName;
+    }
+
+    public String getRuleName() {
+        return ruleName;
+    }
+
+    public void setDemoSMSText(String demoSMSText) {
+        this.demoSMSText = demoSMSText;
+    }
+
+    public String getDemoSMSText() {
+        return demoSMSText;
+    }
+
+    public void setPatternText(String patternText) {
+        this.patternText = patternText;
+    }
+
+    public String getPatternText() {
+        return patternText;
+    }
+
+    public void setTtsRuleText(String ttsRuleText) {
+        this.ttsRuleText = ttsRuleText;
+    }
+
+    public String getTtsRuleText() {
+        return ttsRuleText;
+    }
+
+    public void setIsSimpleView(boolean isSimpleView) {
+        this.isSimpleView = isSimpleView;
+    }
+
+    public boolean isSimpleView() {
+        return isSimpleView;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+    
+
+    @Override
+    public String getName() {
+        return TTSPlayRuleBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        TTSPlayRuleBean bean = this;
+        jsonWriter.name("userId").value(bean.userId);
+        jsonWriter.name("ruleName").value(bean.ruleName);
+        jsonWriter.name("demoSMSText").value(bean.demoSMSText);
+        jsonWriter.name("patternText").value(bean.patternText);
+        jsonWriter.name("ttdRuleText").value(bean.ttsRuleText);
+        jsonWriter.name("isSimpleView").value(bean.isSimpleView);
+        jsonWriter.name("isEnable").value(bean.isEnable);
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        TTSPlayRuleBean bean = new TTSPlayRuleBean();
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (name.equals("userId")) {
+                bean.setUserId(jsonReader.nextInt());
+            } else if (name.equals("ruleName")) {
+                bean.setRuleName(jsonReader.nextString());
+            } else if (name.equals("demoSMSText")) {
+                bean.setDemoSMSText(jsonReader.nextString());
+            } else if (name.equals("patternText")) {
+                bean.setPatternText(jsonReader.nextString());
+            } else if (name.equals("ttdRuleText")) {
+                bean.setTtsRuleText(jsonReader.nextString());
+            } else if (name.equals("isSimpleView")) {
+                bean.setIsSimpleView(jsonReader.nextBoolean());
+            } else if (name.equals("isEnable")) {
+                bean.setIsEnable(jsonReader.nextBoolean());
+            } else {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return bean;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSPlayRuleBean_V1.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSPlayRuleBean_V1.java
new file mode 100644
index 0000000..c6953de
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSPlayRuleBean_V1.java
@@ -0,0 +1,281 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/28 20:22:12
+ * @Describe TTS 语音播放规则类，V1 旧版。
+ */
+import android.content.Context;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.utils.FileUtil;
+import java.io.IOException;
+import java.io.StringReader;
+import java.io.StringWriter;
+import java.util.ArrayList;
+
+public class TTSPlayRuleBean_V1 {
+
+    public static final String TAG = "TTSPlayRuleBean2";
+
+    // 用户ID
+    int userId = -1;
+    // TTS语音规则名称
+	String ruleName = "";
+    // 短信测试文本
+	String demoSMSText = "";
+    // 短信内容查询正则文本
+	String patternText = "";
+    // TTS语音播报正则文本
+	String ttsRuleText = "";
+    // 是否启用简单视图
+    boolean isSimpleView = false;
+    // 是否启用规则
+    boolean isEnable = false;
+
+    public TTSPlayRuleBean_V1(int userId, String ruleName, String demoSMSText, String patternText, String ttsRuleText, boolean isSimpleView, boolean isEnable) {
+        this.userId = userId;
+        this.ruleName = ruleName;
+        this.demoSMSText = demoSMSText;
+        this.patternText = patternText;
+        this.ttsRuleText = ttsRuleText;
+        this.isSimpleView = isSimpleView;
+        this.isEnable = isEnable;
+    }
+
+    public TTSPlayRuleBean_V1() {}
+
+    public void setRuleName(String ruleName) {
+        this.ruleName = ruleName;
+    }
+
+    public String getRuleName() {
+        return ruleName;
+    }
+
+    public void setUserId(int userId) {
+        this.userId = userId;
+    }
+
+    public int getUserId() {
+        return userId;
+    }
+
+    public void setDemoSMSText(String demoSMSText) {
+        this.demoSMSText = demoSMSText;
+    }
+
+    public String getDemoSMSText() {
+        return demoSMSText;
+    }
+
+    public void setPatternText(String patternText) {
+        this.patternText = patternText;
+    }
+
+    public String getPatternText() {
+        return patternText;
+    }
+
+    public void setTtsRuleText(String ttsRuleText) {
+        this.ttsRuleText = ttsRuleText;
+    }
+
+    public String getTtsRuleText() {
+        return ttsRuleText;
+    }
+
+    public void setIsSimpleView(boolean isSimpleView) {
+        this.isSimpleView = isSimpleView;
+    }
+
+    public boolean isSimpleView() {
+        return isSimpleView;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    static String getBeanJsonFilePath(Context context) {
+        return context.getExternalFilesDir(TAG) + "/" + TAG + ".json";
+    }
+
+    static String getBeanListJsonFilePath(Context context) {
+        return context.getExternalFilesDir(TAG) + "/" + TAG + "_List.json";
+    }
+
+    static void writeBean(JsonWriter writer, TTSPlayRuleBean_V1 bean) throws IOException {
+        // 开始 JSON 对象
+        writer.beginObject();
+        // 写入键值对
+        writer.name("userId").value(bean.userId);
+        writer.name("ruleName").value(bean.ruleName);
+        writer.name("demoSMSText").value(bean.demoSMSText);
+        writer.name("patternText").value(bean.patternText);
+        writer.name("ttdRuleText").value(bean.ttsRuleText);
+        writer.name("isSimpleView").value(bean.isSimpleView);
+        writer.name("isEnable").value(bean.isEnable);
+        // 结束 JSON 对象
+        writer.endObject();
+    }
+
+    static TTSPlayRuleBean_V1 parseBean(JsonReader jsonReader) {
+        try {
+            TTSPlayRuleBean_V1 bean = new TTSPlayRuleBean_V1();
+            // 开始 JSON 对象
+            jsonReader.beginObject();
+            // 写入键值对
+            while (jsonReader.hasNext()) {
+                String name = jsonReader.nextName();
+                if (name.equals("ruleName")) {
+                    bean.setRuleName(jsonReader.nextString());
+                } else if (name.equals("userId")) {
+                    bean.setUserId(jsonReader.nextInt());
+                } else if (name.equals("demoSMSText")) {
+                    bean.setDemoSMSText(jsonReader.nextString());
+                } else if (name.equals("patternText")) {
+                    bean.setPatternText(jsonReader.nextString());
+                } else if (name.equals("ttdRuleText")) {
+                    bean.setTtsRuleText(jsonReader.nextString());
+                } else if (name.equals("isSimpleView")) {
+                    bean.setIsSimpleView(jsonReader.nextBoolean());
+                } else if (name.equals("isEnable")) {
+                    bean.setIsEnable(jsonReader.nextBoolean());
+                } else {
+                    jsonReader.skipValue();
+                }
+            }
+            // 结束 JSON 对象
+            jsonReader.endObject();
+            return bean;
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        return null;
+    }
+
+    static ArrayList<TTSPlayRuleBean_V1> parseBeanList(String beanList) {
+        try {
+            StringReader stringReader = new StringReader(beanList);
+            JsonReader jsonReader = new JsonReader(stringReader);
+            ArrayList<TTSPlayRuleBean_V1> list = new ArrayList<TTSPlayRuleBean_V1>();
+            jsonReader.beginArray();
+            while (jsonReader.hasNext()) {
+                TTSPlayRuleBean_V1 bean = parseBean(jsonReader);
+                if (bean != null) {
+                    list.add(bean);
+                }
+            }
+            jsonReader.endArray();
+            return list;
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        return null;
+    }
+
+    @Override
+    public String toString() {
+        // 创建 JsonWriter 对象
+        StringWriter stringWriter = new StringWriter();
+        JsonWriter jsonWriter = new JsonWriter(stringWriter);
+        jsonWriter.setIndent("  ");
+        try {
+            writeBean(jsonWriter, this);
+            return stringWriter.toString();
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        // 获取 JSON 字符串
+        return "";
+    }
+
+    public static String toStringByBeanList(ArrayList<TTSPlayRuleBean_V1> beanList) {
+        try {
+            StringWriter stringWriter = new StringWriter();
+            JsonWriter writer = new JsonWriter(stringWriter);
+            writer.setIndent("  ");
+            writer.beginArray();
+            for (TTSPlayRuleBean_V1 bean : beanList) {
+                writeBean(writer, bean);
+            }
+            writer.endArray();
+            writer.close();
+            return stringWriter.toString();
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        return "";
+    }
+
+    public static TTSPlayRuleBean_V1 parseBean(String szBean) {
+        // 创建 JsonWriter 对象
+        StringReader stringReader = new StringReader(szBean);
+        JsonReader jsonReader = new JsonReader(stringReader);
+        return parseBean(jsonReader);
+    }
+
+    /*public static TTSPlayRuleBean_V1 loadBean(Context context) {
+        return loadBeanFromFile(getBeanJsonFilePath(context));
+    }
+
+    public static TTSPlayRuleBean_V1 loadBeanFromFile(String szFilePath) {
+        TTSPlayRuleBean_V1 bean = null;
+        try {
+            String szJson = FileUtil.readFile(szFilePath);
+            bean = TTSPlayRuleBean_V1.parseBean(szJson);
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        return bean;
+    }
+
+    public static void saveBean(Context context, TTSPlayRuleBean_V1 bean) {
+        saveBeanToFile(getBeanJsonFilePath(context), bean);
+    }
+
+    public static void saveBeanToFile(String szFilePath, TTSPlayRuleBean_V1 bean) {
+        try {
+            String szJson = bean.toString();
+            FileUtil.writeFile(szFilePath, szJson);
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+    }
+
+    public static ArrayList<TTSPlayRuleBean_V1> loadBeanList(Context context) {
+        return loadBeanListFromFile(getBeanListJsonFilePath(context));
+    }*/
+
+    public static ArrayList<TTSPlayRuleBean_V1> loadBeanListFromFile(String szFilePath) {
+        ArrayList<TTSPlayRuleBean_V1> beanList = null;
+        try {
+            String szListJson = FileUtil.readFile(szFilePath);
+            beanList = TTSPlayRuleBean_V1.parseBeanList(szListJson);
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        return beanList;
+    }
+
+    /*public static boolean saveBeanList(Context context, ArrayList<TTSPlayRuleBean_V1> beanList) {
+        return saveBeanListToFile(getBeanListJsonFilePath(context), beanList);
+    }
+
+    public static boolean saveBeanListToFile(String szFilePath, ArrayList<TTSPlayRuleBean_V1> beanList) {
+        try {
+            String szJson = TTSPlayRuleBean_V1.toStringByBeanList(beanList);
+            FileUtil.writeFile(szFilePath, szJson);
+            return true;
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        return false;
+    }*/
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSSpeakTextBean.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSSpeakTextBean.java
new file mode 100644
index 0000000..bd57042
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/beans/TTSSpeakTextBean.java
@@ -0,0 +1,24 @@
+package cc.winboll.studio.mymessagemanager.beans;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/28 20:22:12
+ * @Describe TTS 语音播放文本内容类
+ */
+import java.io.Serializable;
+
+public class TTSSpeakTextBean implements Serializable {
+
+    transient public static final String TAG = "TTSSpeakTextBean";
+
+    // 延迟播放
+    public int mnDelay = 0;
+    // 语音播放内容
+    public String mszSpeakContent = "";
+
+    public TTSSpeakTextBean(int nDelay, String szSpeakContent) {
+        this.mnDelay = nDelay;
+        this.mszSpeakContent = szSpeakContent;
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/dialogs/CharsetRefuseEditDialog.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/dialogs/CharsetRefuseEditDialog.java
new file mode 100644
index 0000000..b0f78f7
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/dialogs/CharsetRefuseEditDialog.java
@@ -0,0 +1,144 @@
+package cc.winboll.studio.mymessagemanager.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.os.Bundle;
+import android.view.Gravity;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.Window;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/13 17:04
+ * @Describe 字符集编辑拒绝对话框
+ * 包含标题、300dp×300dp多行编辑框、确定/取消按钮（确定在右，取消在左）
+ * 支持预制文本初始化、编辑内容回传
+ */
+public class CharsetRefuseEditDialog extends Dialog {
+	public static final String TAG = "CharsetRefuseEditDialog";
+    // 文本回传接口
+	public interface OnTextConfirmListener {
+		void onTextConfirmed(String editText); // 确定按钮点击时回传编辑后的文本
+	}
+
+	private final OnTextConfirmListener mListener; // 外部传入的回传接口
+	private final String mPreText; // 预制文本框的内容
+	private EditText mEditText; // 多行文本编辑框
+
+	/**
+	 * 构造函数
+	 * @param context 上下文
+	 * @param listener 文本回传接口（外部实现）
+	 * @param preText 预制的编辑框初始文本
+	 */
+	public CharsetRefuseEditDialog(Context context, OnTextConfirmListener listener, String preText) {
+		super(context);
+		this.mListener = listener;
+		this.mPreText = preText;
+	}
+
+	@Override
+	protected void onCreate(Bundle savedInstanceState) {
+		super.onCreate(savedInstanceState);
+		// 禁用对话框默认标题，使用自定义标题
+		requestWindowFeature(Window.FEATURE_NO_TITLE);
+		// 初始化对话框布局
+		initView();
+	}
+
+	/**
+	 * 初始化对话框布局（标题+编辑框+按钮）
+	 */
+	private void initView() {
+		// 根布局：垂直线性布局
+		LinearLayout rootLayout = new LinearLayout(getContext());
+		rootLayout.setOrientation(LinearLayout.VERTICAL);
+		rootLayout.setPadding(20, 20, 20, 20);
+		rootLayout.setLayoutParams(new ViewGroup.LayoutParams(
+									   ViewGroup.LayoutParams.WRAP_CONTENT,
+									   ViewGroup.LayoutParams.WRAP_CONTENT
+								   ));
+
+		// 1. 添加标题栏
+		TextView titleTv = new TextView(getContext());
+		titleTv.setText("拒绝显示字符集编辑");
+		titleTv.setTextSize(18);
+		titleTv.setGravity(Gravity.CENTER);
+		titleTv.setPadding(0, 0, 0, 20); // 标题与编辑框间距
+		rootLayout.addView(titleTv);
+
+		// 2. 添加多行编辑框（300dp×300dp）
+		mEditText = new EditText(getContext());
+		// 转换dp为px（适配不同屏幕密度）
+		int dp300 = dp2px(getContext(), 300);
+		LinearLayout.LayoutParams editParams = new LinearLayout.LayoutParams(dp300, dp300);
+		mEditText.setLayoutParams(editParams);
+		mEditText.setLines(5); // 多行显示
+		mEditText.setHint("请输入内容");
+		mEditText.setText(mPreText); // 设置预制文本
+		mEditText.setSelection(mPreText.length()); // 光标定位到文本末尾
+		rootLayout.addView(mEditText);
+
+		// 3. 添加按钮栏（水平布局，确定在右、取消在左）
+		LinearLayout btnLayout = new LinearLayout(getContext());
+		btnLayout.setOrientation(LinearLayout.HORIZONTAL);
+		btnLayout.setGravity(Gravity.RIGHT); // 整体右对齐，实现确定在右、取消在左
+		btnLayout.setLayoutParams(new LinearLayout.LayoutParams(
+									  ViewGroup.LayoutParams.MATCH_PARENT,
+									  ViewGroup.LayoutParams.WRAP_CONTENT
+								  ));
+		btnLayout.setPadding(0, 20, 0, 0); // 按钮栏与编辑框间距
+		rootLayout.addView(btnLayout);
+
+		// 3.1 取消按钮（左侧）
+		TextView cancelBtn = new TextView(getContext());
+		cancelBtn.setText("取消");
+		cancelBtn.setTextSize(16);
+		cancelBtn.setPadding(20, 10, 20, 10);
+		cancelBtn.setOnClickListener(new View.OnClickListener(){
+
+				@Override
+				public void onClick(View view) {
+					dismiss();
+				}
+			}); // 关闭对话框
+		btnLayout.addView(cancelBtn);
+
+		// 3.2 确定按钮（右侧）
+		TextView confirmBtn = new TextView(getContext());
+		confirmBtn.setText("确定");
+		confirmBtn.setTextSize(16);
+		confirmBtn.setPadding(20, 10, 20, 10);
+		confirmBtn.setOnClickListener(new View.OnClickListener(){
+
+				@Override
+				public void onClick(View view) {
+					if (mListener != null) {
+						// 回传编辑后的文本
+						mListener.onTextConfirmed(mEditText.getText().toString().trim());
+					}
+					dismiss(); // 关闭对话框
+				}
+			});
+		btnLayout.addView(confirmBtn);
+
+		// 设置对话框内容布局
+		setContentView(rootLayout);
+	}
+
+	/**
+	 * dp转px工具方法
+	 * @param context 上下文
+	 * @param dpValue dp值
+	 * @return 对应的px值
+	 */
+	private int dp2px(Context context, float dpValue) {
+		final float scale = context.getResources().getDisplayMetrics().density;
+		return (int) (dpValue * scale + 0.5f);
+	}
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/enums/ThemeStyleEnum.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/enums/ThemeStyleEnum.java
new file mode 100644
index 0000000..417174f
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/enums/ThemeStyleEnum.java
@@ -0,0 +1,93 @@
+package cc.winboll.studio.mymessagemanager.enums;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import androidx.annotation.StyleRes;
+import cc.winboll.studio.mymessagemanager.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/09 14:15
+ * @Describe 主题风格枚举类 - 含SharedPreferences存取方法（主题持久化）
+ */
+public enum ThemeStyleEnum {
+	// 主题枚举项（与原逻辑完全对应）
+	DEPTH_THEME(R.id.item_depththeme, R.style.MyDepthAESTheme),
+	SKY_THEME(R.id.item_skytheme, R.style.MySkyAESTheme),
+	GOLDEN_THEME(R.id.item_goldentheme, R.style.MyGoldenAESTheme),
+	MEMOR_THEME(R.id.item_memortheme, R.style.MyMemorAESTheme),
+	TAO_THEME(R.id.item_taotheme, R.style.MyTaoAESTheme),
+	DEFAULT_THEME(R.id.item_defaulttheme, R.style.MyAppTheme);
+
+	// ---------------------- 基础字段（原逻辑保留） ----------------------
+	private final int menuId;
+	@StyleRes
+	private final int styleId;
+
+	ThemeStyleEnum(int menuId, @StyleRes int styleId) {
+		this.menuId = menuId;
+		this.styleId = styleId;
+	}
+
+	public int getMenuId() {
+		return menuId;
+	}
+
+	@StyleRes
+	public int getStyleId() {
+		return styleId;
+	}
+
+	// ---------------------- SharedPreferences 配置（新增） ----------------------
+	// SP文件名：主题配置（建议与枚举类关联，便于查找）
+	private static final String SP_THEME_NAME = "sp_theme_config";
+	// SP存储键：当前选中的主题Style ID
+	private static final String KEY_CURRENT_THEME_STYLE_ID = "current_theme_style_id";
+
+	// ---------------------- 核心方法：保存主题到SP（新增） ----------------------
+	/**
+	 * 保存当前选中的主题Style ID到SharedPreferences
+	 * @param context 上下文（Activity/Application均可）
+	 * @param theme 要保存的主题枚举项（如ThemeStyleEnum.DEFAULT_THEME）
+	 */
+	public static void saveThemeToSP(Context context, ThemeStyleEnum theme) {
+		if (context == null || theme == null) return;
+		// 获取SP实例（私有模式，仅当前App可访问）
+		SharedPreferences sp = context.getSharedPreferences(SP_THEME_NAME, Context.MODE_PRIVATE);
+		// 存入主题对应的Style ID
+		sp.edit().putInt(KEY_CURRENT_THEME_STYLE_ID, theme.getStyleId()).apply();
+	}
+
+	// ---------------------- 核心方法：从SP读取主题（新增） ----------------------
+	/**
+	 * 从SharedPreferences读取保存的主题，无存储时返回默认主题
+	 * @param context 上下文
+	 * @return 保存的主题枚举项（默认返回DEFAULT_THEME）
+	 */
+	public static ThemeStyleEnum getThemeFromSP(Context context) {
+		if (context == null) return DEFAULT_THEME;
+		// 读取SP中保存的Style ID
+		SharedPreferences sp = context.getSharedPreferences(SP_THEME_NAME, Context.MODE_PRIVATE);
+		int savedStyleId = sp.getInt(KEY_CURRENT_THEME_STYLE_ID, DEFAULT_THEME.getStyleId());
+
+		// 根据保存的Style ID匹配对应的枚举项
+		for (ThemeStyleEnum theme : values()) {
+			if (theme.getStyleId() == savedStyleId) {
+				return theme;
+			}
+		}
+		// 无匹配时返回默认主题（防止异常）
+		return DEFAULT_THEME;
+	}
+
+	// ---------------------- 辅助方法：根据菜单ID获取主题（原逻辑保留并优化） ----------------------
+	public static ThemeStyleEnum getThemeByMenuId(int menuId) {
+		for (ThemeStyleEnum theme : values()) {
+			if (theme.getMenuId() == menuId) {
+				return theme;
+			}
+		}
+		return null;
+	}
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/receivers/MainReceiver.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/receivers/MainReceiver.java
new file mode 100644
index 0000000..1ae08e0
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/receivers/MainReceiver.java
@@ -0,0 +1,43 @@
+package cc.winboll.studio.mymessagemanager.receivers;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/28 20:22:12
+ * @Describe 在文件 AndroidManifest.xml 注册监听的广播接收类，
+ *           用于接收系统启动完毕的广播消息。
+ */
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Build;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.services.MainService;
+import cc.winboll.studio.mymessagemanager.utils.AppConfigUtil;
+
+public class MainReceiver extends BroadcastReceiver {
+
+    public static String TAG = "ManagerReceiver";
+
+    static final String ACTION_BOOT_COMPLETED = "android.intent.action.BOOT_COMPLETED";
+
+    AppConfigUtil mConfigUtil;
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String szAction = intent.getAction();
+        if (szAction.equals(ACTION_BOOT_COMPLETED)) {
+            mConfigUtil = AppConfigUtil.getInstance(context);
+            if (mConfigUtil.mAppConfigBean.isEnableService()) {
+                Intent intentService = new Intent(context, MainService.class);
+                if (Build.VERSION.SDK_INT >= 26) {
+                    context.startForegroundService(intentService);
+                } else {
+                    context.startService(intentService);
+                }
+                LogUtils.i(TAG, "System Boot And Start ManagerService Completed!");
+            }
+        }
+
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/receivers/SMSRecevier.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/receivers/SMSRecevier.java
new file mode 100644
index 0000000..fed3ba1
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/receivers/SMSRecevier.java
@@ -0,0 +1,109 @@
+package cc.winboll.studio.mymessagemanager.receivers;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import androidx.localbroadcastmanager.content.LocalBroadcastManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.App;
+import cc.winboll.studio.mymessagemanager.activitys.SMSActivity;
+import cc.winboll.studio.mymessagemanager.beans.SMSBean;
+import cc.winboll.studio.mymessagemanager.utils.AppConfigUtil;
+import cc.winboll.studio.mymessagemanager.utils.PhoneUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSReceiveRuleUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSRecycleUtil;
+import cc.winboll.studio.mymessagemanager.utils.SMSUtil;
+import cc.winboll.studio.mymessagemanager.utils.TTSPlayRuleUtil;
+import cc.winboll.studio.mymessagemanager.utils.NotificationHelper;
+
+public class SMSRecevier extends BroadcastReceiver {
+
+    public static String TAG = "SMSRecevier";
+
+    public static String ACTION_SMS_RECEIVED = "android.provider.Telephony.SMS_RECEIVED";
+
+    public SMSRecevier() {
+        super();
+        //LogUtils.d(TAG, "SMSRecevier()");
+    }
+
+    /*public void init(ManagerService.SMSListener smsListener) {
+     mSMSListener = smsListener;
+     }*/
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+
+        String szAction = intent.getAction();
+        if (szAction.equals(ACTION_SMS_RECEIVED)) {
+            LogUtils.d(TAG, "ACTION_SMS_RECEIVED");
+            String szSmsBody = SMSUtil.getSmsBody(intent);
+            String szSmsAddress = SMSUtil.getSmsAddress(intent);
+            AppConfigUtil configUtil = AppConfigUtil.getInstance(context);
+            boolean isEnableTTS = configUtil.mAppConfigBean.isEnableTTS();
+            boolean isEnableTTSAnalyzeMode = configUtil.mAppConfigBean.isEnableTTSRuleMode();
+
+            if (checkIsSMSOK(context, szSmsBody, szSmsAddress)) {
+                int nResultId = SMSUtil.saveReceiveSms(context, szSmsAddress, szSmsBody, "0", System.currentTimeMillis(), "inbox");
+                if (nResultId >= 0) {
+                    NotificationHelper notificationHelper = new NotificationHelper(context);
+                    notificationHelper.sendSMSReceivedMessage(nResultId, szSmsAddress, szSmsBody);
+                    LocalBroadcastManager.getInstance(context).sendBroadcast(new Intent(SMSActivity.ACTION_NOTIFY_SMS_CHANGED));
+                    LogUtils.d(TAG, "<" + szSmsAddress + "> : ( " + szSmsBody + " ) [SAVED]");
+                    if (isEnableTTS) {
+                        if (isEnableTTSAnalyzeMode) {
+                            TTSPlayRuleUtil ttsPlayRuleUtil = TTSPlayRuleUtil.getInstance(context);
+                            ttsPlayRuleUtil.speakTTSAnalyzeModeText(szSmsBody, configUtil.mAppConfigBean.getTtsPlayDelayTimes());
+                        } else {
+                            TTSPlayRuleUtil.speakText(context, szSmsBody, configUtil.mAppConfigBean.getTtsPlayDelayTimes(), 0);
+                        }
+
+                    }
+                }
+
+                abortBroadcast();
+            } else {
+                SMSBean bean = new SMSBean(-1, szSmsAddress, szSmsBody, System.currentTimeMillis(), SMSBean.Type.INBOX, SMSBean.ReadStatus.UNREAD, 0);
+                SMSRecycleUtil.addSMSRecycleItem(context, bean);
+            }
+        }
+    }
+
+    //
+    // 检查短信是否在接收设定规则内
+    //
+    public static boolean checkIsSMSOK(Context context, String szSmsBody, String szSmsAddress) {
+        PhoneUtil phoneUtil = new PhoneUtil(context);
+        boolean isPhoneInContacts = phoneUtil.isPhoneInContacts(szSmsAddress);
+        LogUtils.d(TAG, String.format("isPhoneInContacts %s", isPhoneInContacts));
+
+        boolean isPhoneByDigit = phoneUtil.isPhoneByDigit(szSmsAddress);
+        LogUtils.d(TAG, String.format("isPhoneByDigit %s", isPhoneByDigit));
+
+        AppConfigUtil configUtil = AppConfigUtil.getInstance(context);
+        boolean isOnlyReceiveContacts = configUtil.mAppConfigBean.isEnableOnlyReceiveContacts();
+        LogUtils.d(TAG, String.format("isOnlyReceiveContacts %s", isOnlyReceiveContacts));
+
+        boolean isInSMSAcceptRule = SMSReceiveRuleUtil.getInstance(context, false).checkIsSMSAcceptInRule(context, szSmsBody);
+        LogUtils.d(TAG, String.format("isInSMSAcceptRule %s", isInSMSAcceptRule));
+
+        // 启用了只接受通讯录，通讯录里有记录
+        if (isOnlyReceiveContacts && isPhoneInContacts) {
+            return true;
+        }
+        // 如果不是数字通讯地址，但是在通讯录内
+        if (!isPhoneByDigit && isPhoneInContacts) {
+            return true;
+        }
+        // 通讯地址是数字，并且在短信接收规则内。
+        if (isPhoneByDigit && isInSMSAcceptRule) {
+            return true;
+        }
+        
+        return false;
+    }
+}
+    
+    
+    
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/AssistantService.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/AssistantService.java
new file mode 100644
index 0000000..c4ef6c8
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/AssistantService.java
@@ -0,0 +1,96 @@
+package cc.winboll.studio.mymessagemanager.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用主要服务组件类守护进程服务组件类
+ */
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.IBinder;
+import cc.winboll.studio.mymessagemanager.utils.AppConfigUtil;
+import cc.winboll.studio.mymessagemanager.utils.ServiceUtil;
+
+public class AssistantService extends Service {
+
+    public final static String TAG = "AssistantService";
+
+    MyServiceConnection mMyServiceConnection;
+    volatile boolean mIsServiceRunning;
+    AppConfigUtil mConfigUtil;
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        mConfigUtil = AppConfigUtil.getInstance(this);
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+        }
+        // 设置运行参数
+        mIsServiceRunning = false;
+        run();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        run();
+        return START_STICKY;
+    }
+
+    @Override
+    public void onDestroy() {
+        mIsServiceRunning = false;
+        super.onDestroy();
+    }
+
+    //
+    // 运行服务内容
+    //
+    void run() {
+        mConfigUtil.reLoadConfig();
+        if (mConfigUtil.mAppConfigBean.isEnableService()) {
+            if (mIsServiceRunning == false) {
+                // 设置运行状态
+                mIsServiceRunning = true;
+                // 唤醒和绑定主进程
+                wakeupAndBindMain();
+            }
+        }
+    }
+
+    //
+    // 唤醒和绑定主进程
+    //
+    void wakeupAndBindMain() {
+        if (ServiceUtil.isServiceAlive(getApplicationContext(), MainService.class.getName()) == false) {
+            startForegroundService(new Intent(AssistantService.this, MainService.class));
+        }
+
+        bindService(new Intent(AssistantService.this, MainService.class), mMyServiceConnection, Context.BIND_IMPORTANT);
+    }
+
+    //
+    // 主进程与守护进程连接时需要用到此类
+    //
+    class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            mConfigUtil.reLoadConfig();
+            if (mConfigUtil.mAppConfigBean.isEnableService()) {
+                wakeupAndBindMain();
+            }
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/DefaultSMSManagerService.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/DefaultSMSManagerService.java
new file mode 100644
index 0000000..db5f207
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/DefaultSMSManagerService.java
@@ -0,0 +1,21 @@
+package cc.winboll.studio.mymessagemanager.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:48:01
+ * @Describe 默认短信应用服务组件类
+ *           注册安卓系统默认短信应用使用。
+ */
+import android.app.Service;
+import android.content.Intent;
+import android.os.IBinder;
+
+public class DefaultSMSManagerService extends Service {
+
+    public static final String TAG = "DefaultSMSManagerService";
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/MainService.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/MainService.java
new file mode 100644
index 0000000..6e2f656
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/MainService.java
@@ -0,0 +1,149 @@
+package cc.winboll.studio.mymessagemanager.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用主要服务组件类
+ */
+import android.app.Notification;
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.ServiceConnection;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.MainActivity;
+import cc.winboll.studio.mymessagemanager.receivers.SMSRecevier;
+import cc.winboll.studio.mymessagemanager.services.MainService;
+import cc.winboll.studio.mymessagemanager.utils.AppConfigUtil;
+import cc.winboll.studio.mymessagemanager.utils.NotificationHelper;
+import cc.winboll.studio.mymessagemanager.utils.ServiceUtil;
+
+public class MainService extends Service {
+
+    public static String TAG = "ManagerService";
+
+    // 前台服务通知工具
+    NotificationHelper mNotificationHelper;
+    Notification notification;
+    AppConfigUtil mConfigUtil;
+    //MyBinder mMyBinder;
+    MyServiceConnection mMyServiceConnection;
+    volatile static boolean _mIsServiceAlive;
+    SMSRecevier mSMSRecevier;
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        //return mMyBinder;
+        return null;
+    }
+
+    @Override
+    public void onCreate() {
+        LogUtils.d(TAG, "onCreate");
+        super.onCreate();
+        _mIsServiceAlive = false;
+        mConfigUtil = AppConfigUtil.getInstance(this);
+
+        //mMyBinder = new MyBinder();
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+        }
+
+        // 运行服务内容
+        run();
+
+    }
+
+    private void run() {
+        //LogUtils.d(TAG, "run");
+        mConfigUtil.reLoadConfig();
+        if (mConfigUtil.mAppConfigBean.isEnableService()) {
+            if (_mIsServiceAlive == false) {
+                // 设置运行状态
+                _mIsServiceAlive = true;
+                //LogUtils.d(TAG, "_mIsServiceAlive set to true.");
+
+                // 唤醒守护进程
+                wakeupAndBindAssistant();
+
+                // 运行其它服务内容
+                IntentFilter localIntentFilter = new IntentFilter(SMSRecevier.ACTION_SMS_RECEIVED);
+                localIntentFilter.setPriority(1);
+                mSMSRecevier = new SMSRecevier();
+                registerReceiver(mSMSRecevier, localIntentFilter);
+
+                // 显示前台通知栏
+                NotificationHelper helper = new NotificationHelper(this);
+                Intent intent = new Intent(this, MainActivity.class);
+                notification = helper.showForegroundNotification(intent, getString(R.string.app_name), getString(R.string.text_aboutservernotification));
+                startForeground(NotificationHelper.FOREGROUND_NOTIFICATION_ID, notification);
+
+                ToastUtils.show("Service is start.");
+                LogUtils.i(TAG, "Service is start.");
+            }
+        }
+    }
+
+    public interface SMSListener {
+        void speakMessage();
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        unregisterReceiver(mSMSRecevier);
+
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        //return super.onStartCommand(intent, flags, startId);
+        run();
+        mConfigUtil.reLoadConfig();
+        return mConfigUtil.mAppConfigBean.isEnableService() ? Service.START_STICKY: super.onStartCommand(intent, flags, startId);
+    }
+
+    /*private class MyBinder extends IMyAidlInterface.Stub {
+     @Override
+     public String getServiceName() {
+     return MainService.class.getSimpleName();
+     }
+     }*/
+
+    // 主进程与守护进程连接时需要用到此类
+    //
+    private class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            //LogUtils.d(TAG, "call onServiceConnected(...)");
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            //LogUtils.d(TAG, "call onServiceConnected(...)");
+            mConfigUtil.reLoadConfig();
+            if (mConfigUtil.mAppConfigBean.isEnableService()) {
+                // 唤醒守护进程
+                wakeupAndBindAssistant();
+            }
+        }
+    }
+
+    // 唤醒和绑定守护进程
+    //
+    void wakeupAndBindAssistant() {
+        if (ServiceUtil.isServiceAlive(getApplicationContext(), AssistantService.class.getName()) == false) {
+            startService(new Intent(MainService.this, AssistantService.class));
+            //LogUtils.d(TAG, "call wakeupAndBindAssistant() : Binding... AssistantService");
+            bindService(new Intent(MainService.this, AssistantService.class), mMyServiceConnection, Context.BIND_IMPORTANT);
+        }
+    }
+
+
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/TTSPlayService.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/TTSPlayService.java
new file mode 100644
index 0000000..c2f9bdd
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/services/TTSPlayService.java
@@ -0,0 +1,42 @@
+package cc.winboll.studio.mymessagemanager.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe TTS 语音播放服务组件类
+ */
+import android.app.Service;
+import android.content.Intent;
+import android.os.IBinder;
+import cc.winboll.studio.mymessagemanager.beans.TTSSpeakTextBean;
+import cc.winboll.studio.mymessagemanager.utils.TextToSpeechUtil;
+import java.util.ArrayList;
+
+public class TTSPlayService extends Service {
+
+    public static final String TAG = "TTSService";
+
+    public static final String EXTRA_SPEAKDATA = "EXTRA_SPEAKDATA";
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        if (intent != null) {
+            ArrayList<TTSSpeakTextBean> listTTSSpeakTextBean = (ArrayList<TTSSpeakTextBean>)intent.getSerializableExtra(EXTRA_SPEAKDATA);
+            if (listTTSSpeakTextBean != null) {
+                
+                TextToSpeechUtil.getInstance(this).speekTTSList(listTTSSpeakTextBean);
+                
+                //Toast.makeText(getApplication(), "onStartCommand", Toast.LENGTH_SHORT).show();
+                //TTSThread ttsThread = new TTSThread(TTSService.this, listTTSSpeakTextBean);
+                //ttsThread.start();
+            }
+        }
+
+        return super.onStartCommand(intent, flags, startId);
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/AddressUtils_Test.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/AddressUtils_Test.java
new file mode 100644
index 0000000..e310a82
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/AddressUtils_Test.java
@@ -0,0 +1,28 @@
+package cc.winboll.studio.mymessagemanager.unittest;
+import android.content.Context;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.utils.AddressUtils;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/03/01 13:07:32
+ * @Describe AddressUtils Test
+ */
+public class AddressUtils_Test {
+
+    public static final String TAG = "AddressUtils_Test";
+
+    public static void main(Context context) {
+        String szSmsBody = "无影无迹";
+        String szSmsAddress = "无名小辈";
+        LogUtils.d(TAG, String.format("szSmsAddress %s\n getFormattedAddress : %s", szSmsAddress, AddressUtils.getFormattedAddress(szSmsAddress)));
+        szSmsAddress = "13172887736";
+        LogUtils.d(TAG, String.format("szSmsAddress %s\n getFormattedAddress : %s", szSmsAddress, AddressUtils.getFormattedAddress(szSmsAddress)));
+        szSmsAddress = "+8613172887736";
+        LogUtils.d(TAG, String.format("szSmsAddress %s\n getFormattedAddress : %s", szSmsAddress, AddressUtils.getFormattedAddress(szSmsAddress)));
+        szSmsAddress = "8613172887736";
+        LogUtils.d(TAG, String.format("szSmsAddress %s\n getFormattedAddress : %s", szSmsAddress, AddressUtils.getFormattedAddress(szSmsAddress)));
+        
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/SMSRecevier_Test.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/SMSRecevier_Test.java
new file mode 100644
index 0000000..0d9257f
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/SMSRecevier_Test.java
@@ -0,0 +1,56 @@
+package cc.winboll.studio.mymessagemanager.unittest;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/02/25 19:02:15
+ * @Describe SMSRecevier 测试类
+ */
+import android.content.Context;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.receivers.SMSRecevier;
+
+public class SMSRecevier_Test {
+
+    public static final String TAG = "SMSRecevier_Test";
+
+    public static void main(Context context) {
+        String szSmsBody = "无影无迹";
+        String szSmsAddress = "无名小辈";
+        test1(context, szSmsBody, szSmsAddress);
+        
+        szSmsBody = "无影无迹";
+        szSmsAddress = "淘宝物流";
+        test1(context, szSmsBody, szSmsAddress);
+        
+        szSmsBody = "无影无迹";
+        szSmsAddress = "1?0";
+        test1(context, szSmsBody, szSmsAddress);
+        
+        szSmsBody = "无影无迹";
+        szSmsAddress = "10000";
+        test1(context, szSmsBody, szSmsAddress);
+        
+        szSmsBody = "【UC】无影无迹";
+        szSmsAddress = "无名小辈";
+        test1(context, szSmsBody, szSmsAddress);
+        
+        szSmsBody = "【UC】无影无迹";
+        szSmsAddress = "10000";
+        test1(context, szSmsBody, szSmsAddress);
+        
+        szSmsBody = "【UC】无影无迹";
+        szSmsAddress = "13172887736";
+        test1(context, szSmsBody, szSmsAddress);
+        
+        szSmsBody = "【UC】无影无迹";
+        szSmsAddress = "+8613172887736";
+        test1(context, szSmsBody, szSmsAddress);
+        
+    }
+    
+    public static void test1(Context context, String szSmsBody, String szSmsAddress) {
+        
+        boolean isSMSOK = SMSRecevier.checkIsSMSOK(context, szSmsBody, szSmsAddress);
+        LogUtils.d(TAG, String.format("szSmsBody : %s\nszSmsAddress : %s\nisSMSOK : %s", szSmsBody, szSmsAddress, isSMSOK));
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/UnitTestActivity.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/UnitTestActivity.java
new file mode 100644
index 0000000..d405dfb
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/unittest/UnitTestActivity.java
@@ -0,0 +1,46 @@
+package cc.winboll.studio.mymessagemanager.unittest;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/02/25 19:00:10
+ * @Describe 应用单元测试窗口
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.views.ProtectModeTextView;
+
+public class UnitTestActivity extends Activity {
+
+    public static final String TAG = "UnitTestActivity";
+
+    LogView mLogView;
+    // 新增自定义控件
+    ProtectModeTextView mProtectModeTv;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_unittest);
+
+        mLogView = findViewById(R.id.logview);
+        mLogView.start();
+
+        // 初始化ProtectModeTextView
+        mProtectModeTv = findViewById(R.id.protect_mode_tv);
+        // 设置测试文本，可自行修改
+        String testText = "abcdefghijklmnopqrstuvwxyz消息管理 隐私保护 文本随机组合 滑动刻度测试1234567890";
+        mProtectModeTv.setContentText(testText);
+    }
+
+    public void onMain(View view) {
+        LogUtils.d(TAG, "SMSRecevier_Test");
+        SMSRecevier_Test.main(this);
+        LogUtils.d(TAG, "AddressUtils_Test");
+        AddressUtils_Test.main(this);
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AddressUtils.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AddressUtils.java
new file mode 100644
index 0000000..fd1566d
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AddressUtils.java
@@ -0,0 +1,20 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/03/01 13:03:16
+ * @Describe 通信录地址工具
+ */
+public class AddressUtils {
+    
+    public static final String TAG = "AddressUtils";
+    
+    public static String getFormattedAddress(String address) {
+        if (address != null && address.matches("[+]?\\d+")) {
+            return address;
+        } else {
+            return "【" + address + "】";
+        }
+    }
+    
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppConfigUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppConfigUtil.java
new file mode 100644
index 0000000..140f6d8
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppConfigUtil.java
@@ -0,0 +1,55 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/02 21:43:52
+ * @Describe 应用配置工具类
+ */
+import android.content.Context;
+import cc.winboll.studio.mymessagemanager.beans.AppConfigBean;
+
+public class AppConfigUtil {
+    
+    public static final String TAG = "AppConfigUtil";
+    
+    static AppConfigUtil _mConfigUtil;
+    Context mContext;
+    public AppConfigBean mAppConfigBean;
+
+    AppConfigUtil(Context context) {
+        mContext = context;
+        mAppConfigBean = AppConfigBean.loadBean(context, AppConfigBean.class);
+        if(mAppConfigBean == null) {
+            mAppConfigBean = new AppConfigBean();
+            AppConfigBean.saveBean(context, mAppConfigBean);
+        }
+    }
+
+    public static AppConfigUtil getInstance(Context context) {
+        if (_mConfigUtil == null) {
+            _mConfigUtil = new AppConfigUtil(context);
+        }
+        return _mConfigUtil;
+    }
+    
+    public void reLoadConfig() {
+        mAppConfigBean = AppConfigBean.loadBean(mContext, AppConfigBean.class);
+    }
+    
+    public void saveConfig() {
+        AppConfigBean.saveBean(mContext, mAppConfigBean);
+    }
+    
+    public String getPhoneReplaceString() {
+        //String phoneNumber = "+86 123 4567 8901"; // 带有国家代码和空格的手机号码
+        //String filteredNumber = phoneNumber.replaceAll("^\\+86|\\s", ""); // 过滤国家代码和空格
+        //LogUtils.d(TAG, filteredNumber);
+
+        String szReplace = "\\s";
+        if (mAppConfigBean.isMergeCountryCodePrefix()) {
+            szReplace = "^\\+" + mAppConfigBean.getCountryCode() + "|\\s";
+        }
+        //LogUtils.d(TAG, "szReplace is : " + szReplace);
+        return szReplace;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppConfigUtil_V1.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppConfigUtil_V1.java
new file mode 100644
index 0000000..3ba2132
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppConfigUtil_V1.java
@@ -0,0 +1,170 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用配置工具类，V1 旧版。
+ */
+import android.util.JsonReader;
+import cc.winboll.studio.mymessagemanager.beans.AppConfigBean_V1;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.util.ArrayList;
+
+public class AppConfigUtil_V1 {
+
+    public final static String TAG = "ConfigUtil";
+
+    static AppConfigUtil_V1 _mConfigUtil;
+    //AppConfigBean_V1 mAppConfigBean_V1;
+
+    AppConfigUtil_V1() {}
+
+    public static AppConfigUtil_V1 getInstance() {
+        if (_mConfigUtil == null) {
+            _mConfigUtil = new AppConfigUtil_V1();
+        }
+        return _mConfigUtil;
+    }
+
+    /*public void setAppTheme(ThemeUtil.BaseTheme baseTheme) {
+        loadConfigData();
+        mAppConfigBean.setAppThemeID(ThemeUtil.getThemeID(baseTheme));
+        saveConfigData();
+    }*/
+
+    //
+    // 加载应用配置数据
+    //
+    /*void loadConfigData() {
+        File fJson = new File(GlobalApplication._mszConfigUtilPath);
+        ArrayList<AppConfigBean> listTemp = null;
+        try {
+            if (fJson.exists()) {
+                listTemp = readJsonStream(new FileInputStream(fJson));
+                if (listTemp != null) {
+                    mAppConfigBean = listTemp.get(0);
+                }
+            } else {
+                mAppConfigBean = new AppConfigBean();
+                saveConfigData();
+            }
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+    }*/
+
+    //
+    // 读取 Json 文件
+    //
+    public ArrayList<AppConfigBean_V1> readJsonStream(InputStream in) throws IOException {
+        JsonReader reader = new JsonReader(new InputStreamReader(in, "UTF-8"));
+        return readJsonArrayList(reader);
+    }
+
+    //
+    // 读取 Json 文件的每一 Json 项
+    //
+    public ArrayList<AppConfigBean_V1> readJsonArrayList(JsonReader reader) throws IOException {
+        ArrayList<AppConfigBean_V1> list = new ArrayList<AppConfigBean_V1>();
+        reader.beginArray();
+        while (reader.hasNext()) {
+            list.add(readBeanItem(reader));
+        }
+        reader.endArray();
+        return list;
+    }
+
+    //
+    // 读取 Json 文件的某一 Json 项
+    //
+    public AppConfigBean_V1 readBeanItem(JsonReader reader) throws IOException {
+        AppConfigBean_V1 bean = new AppConfigBean_V1();
+        int nReaderCount = 0;
+        reader.beginObject();
+        while (reader.hasNext()) {
+            String name = reader.nextName();
+            if (name.equals("countryCode")) {
+                bean.setCountryCode(reader.nextString());
+                nReaderCount++;
+            } else if (name.equals("isMergeCountryCodePrefix")) {
+                bean.setIsMergeCountryCodePrefix(reader.nextBoolean());
+                nReaderCount++;
+            } else if (name.equals("ttsPlayDelayTimes")) {
+                bean.setTtsPlayDelayTimes(reader.nextInt());
+                nReaderCount++;
+            } else if (name.equals("enableService")) {
+                bean.setEnableService(reader.nextBoolean());
+                nReaderCount++;
+            } else if (name.equals("enableOnlyReceiveContacts")) {
+                bean.setEnableOnlyReceiveContacts(reader.nextBoolean());
+                nReaderCount++;
+            } else if (name.equals("enableTTS")) {
+                bean.setEnableTTS(reader.nextBoolean());
+                nReaderCount++;
+            } else if (name.equals("enableTTSRuleMode")) {
+                bean.setEnableTTSRuleMode(reader.nextBoolean());
+                nReaderCount++;
+            } /*else if (name.equals("appThemeID")) {
+                bean.setAppThemeID(reader.nextInt());
+                nReaderCount++;
+            }*/ else {
+                reader.skipValue();
+            }
+        }
+        reader.endObject();
+        return nReaderCount > 0 ? bean : null;
+    }
+
+    //
+    // 写入 Json 文件的某一 Json 项
+    //
+    /*public void writeBeanItem(JsonWriter writer, AppConfigBean bean) throws IOException {
+        writer.beginObject();
+        writer.name("countryCode").value(bean.getCountryCode());
+        writer.name("isMergeCountryCodePrefix").value(bean.isMergeCountryCodePrefix());
+        writer.name("ttsPlayDelayTimes").value(bean.getTtsPlayDelayTimes());
+        writer.name("enableService").value(bean.isEnableService());
+        writer.name("enableOnlyReceiveContacts").value(bean.isEnableOnlyReceiveContacts());
+        writer.name("enableTTS").value(bean.isEnableTTS());
+        writer.name("enableTTSRuleMode").value(bean.isEnableTTSRuleMode());
+        writer.name("appThemeID").value(bean.getAppThemeID());
+        writer.endObject();
+    }
+
+    //
+    // 保存应用配置数据
+    //
+    public void saveConfigData() {
+        try {
+            File fJson = new File(GlobalApplication._mszConfigUtilPath);
+            ArrayList<AppConfigBean> list = new ArrayList<AppConfigBean>();
+            list.add(mAppConfigBean);
+            writeJsonStream(new FileOutputStream(fJson, false), list);
+        } catch (IOException e) {
+            LogUtils.d(TAG, "IOException : " + e.getMessage());
+        }
+    }
+
+    //
+    // 写入 Json 文件
+    //
+    public void writeJsonStream(OutputStream out, ArrayList<AppConfigBean> beanList) throws IOException {
+        JsonWriter writer = new JsonWriter(new OutputStreamWriter(out, "UTF-8"));
+        writer.setIndent("  ");
+        writeJsonArrayList(writer, beanList);
+        writer.close();
+    }
+
+    //
+    // 记录 Json 文件的某一 Json 项
+    //
+    public void writeJsonArrayList(JsonWriter writer, ArrayList<AppConfigBean> beanList) throws IOException {
+        writer.beginArray();
+        for (AppConfigBean bean : beanList) {
+            writeBeanItem(writer, bean);
+        }
+        writer.endArray();
+    }*/
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppGoToSettingsUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppGoToSettingsUtil.java
new file mode 100644
index 0000000..2759063
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/AppGoToSettingsUtil.java
@@ -0,0 +1,270 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/05/31 17:58:27
+ * @Describe 调用应用属性设置页工具类
+ *  来源：https://blog.csdn.net/zhuhai__yizhi/article/details/78737593
+ *  Created by zyy on 2018/3/12.
+ *  直接跳转到权限后返回，可以监控权限授权情况，但是，跳转到应用详情页，无法监测权限情况
+ *  是否要加以区分，若是应用详情页，则跳转回来后，onRestart检测所求权限，如果授权，则收回提示，如果没授权，则继续提示
+ */
+import android.app.Activity;
+import android.content.ComponentName;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.Settings;
+import cc.winboll.studio.mymessagemanager.activitys.MainActivity;
+
+public class AppGoToSettingsUtil {
+
+    public static final String TAG = "AppGoToSettingsUtil";
+    
+    public static final int ACTIVITY_RESULT_APP_SETTINGS = MainActivity.ACTIVITY_RESULT_APP_SETTINGS;
+    
+    /**
+     * Build.MANUFACTURER判断各大手机厂商品牌
+     */
+    private static final String MANUFACTURER_HUAWEI = "Huawei";//华为
+    private static final String MANUFACTURER_MEIZU = "Meizu";//魅族
+    private static final String MANUFACTURER_XIAOMI = "Xiaomi";//小米
+    private static final String MANUFACTURER_SONY = "Sony";//索尼
+    private static final String MANUFACTURER_OPPO = "OPPO";
+    private static final String MANUFACTURER_LG = "LG";
+    private static final String MANUFACTURER_VIVO = "vivo";
+    private static final String MANUFACTURER_SAMSUNG = "samsung";//三星
+    private static final String MANUFACTURER_LETV = "Letv";//乐视
+    private static final String MANUFACTURER_ZTE = "ZTE";//中兴
+    private static final String MANUFACTURER_YULONG = "YuLong";//酷派
+    private static final String MANUFACTURER_LENOVO = "LENOVO";//联想
+
+    public static boolean isAppSettingOpen=false;
+    /**
+     * 跳转到相应品牌手机系统权限设置页，如果跳转不成功，则跳转到应用详情页
+     * 这里需要改造成返回true或者false，应用详情页:true，应用权限页:false
+     * @param activity
+     */
+    public static void GoToSetting(Activity activity) {
+        switch (Build.MANUFACTURER) {
+            case MANUFACTURER_HUAWEI://华为
+                Huawei(activity);
+                break;
+            case MANUFACTURER_MEIZU://魅族
+                Meizu(activity);
+                break;
+            case MANUFACTURER_XIAOMI://小米
+                Xiaomi(activity);
+                break;
+            case MANUFACTURER_SONY://索尼
+                Sony(activity);
+                break;
+            case MANUFACTURER_OPPO://oppo
+                OPPO(activity);
+                break;
+            case MANUFACTURER_LG://lg
+                LG(activity);
+                break;
+            case MANUFACTURER_LETV://乐视
+                Letv(activity);
+                break;
+            default://其他
+                try {//防止应用详情页也找不到，捕获异常后跳转到设置，这里跳转最好是两级，太多用户也会觉得麻烦，还不如不跳
+                    openAppDetailSetting(activity);
+                    //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+                } catch (Exception e) {
+                    SystemConfig(activity);
+                }
+                break;
+        }
+    }
+
+    /**
+     * 华为跳转权限设置页
+     * @param activity
+     */
+    public static void Huawei(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.huawei.systemmanager", "com.huawei.permissionmanager.ui.MainActivity");
+            intent.setComponent(comp);
+            activity.startActivityForResult(intent, ACTIVITY_RESULT_APP_SETTINGS);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 魅族跳转权限设置页，测试时，点击无反应，具体原因不明
+     * @param activity
+     */
+    public static void Meizu(Activity activity) {
+        try {
+            Intent intent = new Intent("com.meizu.safe.security.SHOW_APPSEC");
+            intent.addCategory(Intent.CATEGORY_DEFAULT);
+            intent.putExtra("packageName", activity.getPackageName());
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 小米，功能正常
+     * @param activity
+     */
+    public static void Xiaomi(Activity activity) {
+        try { //MIUI 8 9
+            Intent localIntent = new Intent("miui.intent.action.APP_PERM_EDITOR");
+            localIntent.setClassName("com.miui.securitycenter", "com.miui.permcenter.permissions.PermissionsEditorActivity");
+            localIntent.putExtra("extra_pkgname", activity.getPackageName());
+            activity.startActivityForResult(localIntent, ACTIVITY_RESULT_APP_SETTINGS);
+            isAppSettingOpen = false;
+            //activity.startActivity(localIntent);
+        } catch (Exception e) {
+            try { //MIUI 5/6/7
+                Intent localIntent = new Intent("miui.intent.action.APP_PERM_EDITOR");
+                localIntent.setClassName("com.miui.securitycenter", "com.miui.permcenter.permissions.AppPermissionsEditorActivity");
+                localIntent.putExtra("extra_pkgname", activity.getPackageName());
+                activity.startActivityForResult(localIntent, ACTIVITY_RESULT_APP_SETTINGS);
+                isAppSettingOpen = false;
+                //activity.startActivity(localIntent);
+            } catch (Exception e1) { //否则跳转到应用详情
+                openAppDetailSetting(activity);
+                //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+                //这里有个问题，进入活动后需要再跳一级活动，就检测不到返回结果
+                //activity.startActivity(getAppDetailSettingIntent());
+            }
+        }
+    }
+
+    /**
+     * 索尼，6.0以上的手机非常少，基本没看见
+     * @param activity
+     */
+    public static void Sony(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.sonymobile.cta", "com.sonymobile.cta.SomcCTAMainActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * OPPO
+     * @param activity
+     */
+    public static void OPPO(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.color.safecenter", "com.color.safecenter.permission.PermissionManagerActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * LG经过测试，正常使用
+     * @param activity
+     */
+    public static void LG(Activity activity) {
+        try {
+            Intent intent = new Intent("android.intent.action.MAIN");
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.android.settings", "com.android.settings.Settings$AccessLockSummaryActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 乐视6.0以上很少，基本都可以忽略了，现在乐视手机不多
+     * @param activity
+     */
+    public static void Letv(Activity activity) {
+        try {
+            Intent intent = new Intent();
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.letv.android.letvsafe", "com.letv.android.letvsafe.PermissionAndApps");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+            isAppSettingOpen = false;
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+
+    /**
+     * 只能打开到自带安全软件
+     * @param activity
+     */
+    public static void _360(Activity activity) {
+        try {
+            Intent intent = new Intent("android.intent.action.MAIN");
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.putExtra("packageName", activity.getPackageName());
+            ComponentName comp = new ComponentName("com.qihoo360.mobilesafe", "com.qihoo360.mobilesafe.ui.index.AppEnterActivity");
+            intent.setComponent(comp);
+            activity.startActivity(intent);
+        } catch (Exception e) {
+            openAppDetailSetting(activity);
+            //activity.startActivityForResult(getAppDetailSettingIntent(activity), PERMISSION_SETTING_FOR_RESULT);
+        }
+    }
+    /**
+     * 系统设置界面
+     * @param activity
+     */
+    public static void SystemConfig(Activity activity) {
+        Intent intent = new Intent(Settings.ACTION_SETTINGS);
+        activity.startActivity(intent);
+    }
+    /**
+     * 获取应用详情页面
+     * @return
+     */
+    private static Intent getAppDetailSettingIntent(Activity activity) {
+        Intent localIntent = new Intent();
+        localIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        //if (Build.VERSION.SDK_INT >= 9) {
+        localIntent.setAction("android.settings.APPLICATION_DETAILS_SETTINGS");
+        localIntent.setData(Uri.fromParts("package", activity.getPackageName(), null));
+        /*} else if (Build.VERSION.SDK_INT <= 8) {
+         localIntent.setAction(Intent.ACTION_VIEW);
+         localIntent.setClassName("com.android.settings", "com.android.settings.InstalledAppDetails");
+         localIntent.putExtra("com.android.settings.ApplicationPkgName", activity.getPackageName());
+         }*/
+        return localIntent;
+    }
+    
+    public static void openAppDetailSetting(Activity activity) {
+        activity.startActivityForResult(getAppDetailSettingIntent(activity), ACTIVITY_RESULT_APP_SETTINGS);
+        isAppSettingOpen = true;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/FileUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/FileUtil.java
new file mode 100644
index 0000000..a3fd304
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/FileUtil.java
@@ -0,0 +1,113 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 文件工具类
+ */
+import android.content.Context;
+import android.content.Intent;
+import android.content.res.AssetManager;
+import android.net.Uri;
+import androidx.core.content.FileProvider;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.io.OutputStream;
+import java.io.OutputStreamWriter;
+import java.nio.charset.StandardCharsets;
+
+public class FileUtil {
+
+    public static final String TAG = "FileUtil";
+
+    public static void shareJSONFile(Context context, String szConfigFile) {
+        Uri uri;
+        File file = new File(szConfigFile);
+        uri = FileProvider.getUriForFile(context, context.getPackageName() + ".fileprovider", file);
+        /*if (Build.VERSION.SDK_INT >= 24) {//android 7.0以上
+            uri = FileProvider.getUriForFile(context, context.getPackageName() + ".fileprovider", file);
+        } else {
+            uri = Uri.fromFile(file);
+        }*/
+        Intent shareIntent = new Intent();    
+        shareIntent.setAction(Intent.ACTION_SEND);    
+        shareIntent.putExtra(Intent.EXTRA_STREAM, uri);    
+        shareIntent.setType("application/json");
+
+        shareIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+        /*if (Build.VERSION.SDK_INT >= 24) {
+            shareIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+        }*/
+        
+        // 设置分享的标题    
+        context.startActivity(Intent.createChooser(shareIntent, "SHARE JSON"));  
+    }
+
+    //
+    // 把字符串写入文件，指定 UTF-8 编码
+    //
+    public static void writeFile(String filePath, String content) throws IOException {
+        File file = new File(filePath);
+        FileOutputStream outputStream = new FileOutputStream(file);
+        OutputStreamWriter writer = new OutputStreamWriter(outputStream, StandardCharsets.UTF_8);
+        writer.write(content);
+        writer.close();
+    }
+
+    //
+    // 读取文件到字符串，指定 UTF-8 编码
+    //
+    public static String readFile(String filePath) throws IOException {
+        File file = new File(filePath);
+        FileInputStream inputStream = new FileInputStream(file);
+        InputStreamReader reader = new InputStreamReader(inputStream, StandardCharsets.UTF_8);
+        StringBuilder content = new StringBuilder();
+        int character;
+        while ((character = reader.read()) != -1) {
+            content.append((char) character);
+        }
+        reader.close();
+        return content.toString();
+    }
+    
+    public static void copyAssetsToSD(Context context, String szSrcAssets, String szDstSD) {
+        LogUtils.d(TAG, "copyAssetsToSD [" + szSrcAssets + "] to [" + szDstSD + "]");
+        AssetManager assetManager = context.getAssets();
+        InputStream inputStream = null;
+        OutputStream outputStream = null;
+        try {
+            inputStream = assetManager.open(szSrcAssets);
+            File outputFile = new File(szDstSD);
+            outputStream = new FileOutputStream(outputFile);
+            byte[] buffer = new byte[1024];
+            int length = 0;
+            while ((length = inputStream.read(buffer)) > 0) {
+                outputStream.write(buffer, 0, length);
+            }
+            outputStream.flush();
+            LogUtils.d(TAG, "copyAssetsToSD done.");
+        } catch (IOException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        } finally {
+            if (inputStream != null) {
+                try {
+                    inputStream.close();
+                } catch (IOException e) {
+                    LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+                }
+            }
+            if (outputStream != null) {
+                try {
+                    outputStream.close();
+                } catch (IOException e) {
+                    LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+                }
+            }
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationHelper.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationHelper.java
new file mode 100644
index 0000000..b086dd7
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationHelper.java
@@ -0,0 +1,202 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/04/01 14:10:35
+ * @Describe 应用通知工具类
+ */
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.graphics.BitmapFactory;
+import android.os.Build;
+import android.widget.RemoteViews;
+import androidx.annotation.RequiresApi;
+import androidx.core.app.NotificationCompat;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.SMSActivity;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+public class NotificationHelper {
+    public static final String TAG = "NotificationHelper";
+
+    // 渠道ID和名称
+    private static final String CHANNEL_ID_FOREGROUND = "foreground_channel";
+    private static final String CHANNEL_NAME_FOREGROUND = "Foreground Service";
+    private static final String CHANNEL_ID_TEMPORARY = "temporary_channel";
+    private static final String CHANNEL_NAME_TEMPORARY = "Temporary Notifications";
+
+    // 通知ID
+    public static final int FOREGROUND_NOTIFICATION_ID = 1001;
+    public static final int TEMPORARY_NOTIFICATION_ID = 2001;
+
+    private final Context mContext;
+    private final NotificationManager mNotificationManager;
+
+    // 示例：维护当前使用的渠道ID列表
+    // 键：渠道ID，值：渠道重要性级别
+    Map<String, Integer> activeChannelConfigs = new HashMap<>();
+
+    public NotificationHelper(Context context) {
+        mContext = context;
+        mNotificationManager = context.getSystemService(NotificationManager.class);
+
+        // 初始化配置
+        activeChannelConfigs.put(
+            CHANNEL_ID_FOREGROUND,
+            NotificationManager.IMPORTANCE_HIGH
+        );
+        activeChannelConfigs.put(
+            CHANNEL_ID_TEMPORARY,
+            NotificationManager.IMPORTANCE_DEFAULT
+        );
+
+        createNotificationChannels();
+    }
+
+    @RequiresApi(api = Build.VERSION_CODES.O)
+    private void createNotificationChannels() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            createForegroundChannel();
+            createTemporaryChannel();
+        }
+    }
+
+    @RequiresApi(api = Build.VERSION_CODES.O)
+    private void createForegroundChannel() {
+        NotificationChannel channel = new NotificationChannel(
+            CHANNEL_ID_FOREGROUND,
+            CHANNEL_NAME_FOREGROUND,
+            NotificationManager.IMPORTANCE_LOW
+        );
+        channel.setDescription("Persistent service notifications");
+        channel.setSound(null, null);
+        channel.enableVibration(false);
+        mNotificationManager.createNotificationChannel(channel);
+    }
+
+    @RequiresApi(api = Build.VERSION_CODES.O)
+    private void createTemporaryChannel() {
+        NotificationChannel channel = new NotificationChannel(
+            CHANNEL_ID_TEMPORARY,
+            CHANNEL_NAME_TEMPORARY,
+            NotificationManager.IMPORTANCE_HIGH
+        );
+        channel.setDescription("Temporary alert notifications");
+        channel.setSound(null, null);
+        channel.enableVibration(true);
+        channel.setVibrationPattern(new long[]{100, 200, 300, 400});
+        channel.setBypassDnd(true);
+        mNotificationManager.createNotificationChannel(channel);
+    }
+
+    // 显示常驻通知（通常用于前台服务）
+    public Notification showForegroundNotification(Intent intent, String title, String content) {
+        PendingIntent pendingIntent = createPendingIntent(intent);
+
+        Notification notification = new NotificationCompat.Builder(mContext, CHANNEL_ID_FOREGROUND)
+            .setSmallIcon(R.drawable.ic_launcher)
+            .setLargeIcon(BitmapFactory.decodeResource(mContext.getResources(), R.drawable.ic_launcher))
+            //.setContentTitle(title)
+            .setContentTitle(content)
+            //.setContentText(content)
+            .setContentIntent(pendingIntent)
+            .setPriority(NotificationCompat.PRIORITY_LOW)
+            .setOngoing(true)
+            .build();
+
+        mNotificationManager.notify(FOREGROUND_NOTIFICATION_ID, notification);
+        return notification;
+    }
+
+    // 显示临时通知（自动消失）
+    public void showTemporaryNotification(Intent intent, String title, String content) {
+        showTemporaryNotification(intent, TEMPORARY_NOTIFICATION_ID, title, content);
+    }
+
+    // 显示临时通知（自动消失）
+    public void showTemporaryNotification(Intent intent, int notificationID, String title, String content) {
+        PendingIntent pendingIntent = createPendingIntent(intent);
+
+        Notification notification = new NotificationCompat.Builder(mContext, CHANNEL_ID_TEMPORARY)
+            .setSmallIcon(R.drawable.ic_launcher)
+            .setLargeIcon(BitmapFactory.decodeResource(mContext.getResources(), R.drawable.ic_launcher))
+            .setContentTitle(title)
+            .setContentText(content)
+            .setContentIntent(pendingIntent)
+            .setPriority(NotificationCompat.PRIORITY_HIGH)
+            .setAutoCancel(true)
+            .setVibrate(new long[]{100, 200, 300, 400})
+            .build();
+
+        mNotificationManager.notify(notificationID, notification);
+    }
+
+    // 创建自定义布局通知（可扩展）
+    public void showCustomNotification(Intent intent, RemoteViews contentView, RemoteViews bigContentView) {
+        PendingIntent pendingIntent = createPendingIntent(intent);
+
+        Notification notification = new NotificationCompat.Builder(mContext, CHANNEL_ID_TEMPORARY)
+            .setSmallIcon(R.drawable.ic_launcher)
+            .setContentIntent(pendingIntent)
+            .setContent(contentView)
+            .setCustomBigContentView(bigContentView)
+            .setPriority(NotificationCompat.PRIORITY_HIGH)
+            .setAutoCancel(true)
+            .build();
+
+        mNotificationManager.notify(TEMPORARY_NOTIFICATION_ID + 1, notification);
+    }
+
+    // 取消所有通知
+    public void cancelAllNotifications() {
+        mNotificationManager.cancelAll();
+    }
+
+    // 取消指定通知
+    public void cancelNotification(int notificationID) {
+        mNotificationManager.cancel(notificationID);
+    }
+
+    // 创建PendingIntent（兼容不同API版本）
+    private PendingIntent createPendingIntent(Intent intent) {
+        int flags = PendingIntent.FLAG_UPDATE_CURRENT;
+//        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+//            flags |= PendingIntent.FLAG_IMMUTABLE;
+//        }
+        return PendingIntent.getActivity(
+            mContext,
+            0,
+            intent,
+            flags
+        );
+    }
+
+    public void sendSMSReceivedMessage(int notificationID, String szPhone, String szBody) {
+        Intent intent = new Intent(mContext, SMSActivity.class);
+		intent.putExtra(SMSActivity.EXTRA_PHONE, szPhone);
+        String szTitle = mContext.getString(R.string.text_smsfrom)  + "<" + szPhone + ">";
+        String szContent = "[ " + szBody + " ]";
+        showTemporaryNotification(intent, notificationID, szTitle, szContent);
+    }
+
+    public void cleanOldChannels() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            List<NotificationChannel> allChannels = mNotificationManager.getNotificationChannels();
+            for (NotificationChannel channel : allChannels) {
+                LogUtils.d(TAG, "Clean channel : " + channel.getId());
+                if (!activeChannelConfigs.containsKey(channel.getId())) {
+                    // 安全删除渠道
+                    mNotificationManager.deleteNotificationChannel(channel.getId());
+                    LogUtils.d(TAG, String.format("Deleted Channel %s", channel.getId()));
+                }
+            }
+        }
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationUtil.java
new file mode 100644
index 0000000..0a2deba
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationUtil.java
@@ -0,0 +1,168 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用通知栏工具类
+ */
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.graphics.BitmapFactory;
+import android.graphics.Color;
+import android.media.RingtoneManager;
+import android.widget.RemoteViews;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.MainActivity;
+import cc.winboll.studio.mymessagemanager.activitys.SMSActivity;
+import cc.winboll.studio.mymessagemanager.beans.MessageNotificationBean;
+import cc.winboll.studio.mymessagemanager.services.MainService;
+
+public class NotificationUtil {
+
+    public static final String TAG = "NotificationUtil";
+    public static final int ID_MSG_SERVICE = 10000;
+
+    static final String szSMSChannelID = "1";
+
+    static final String szServiceChannelID = "0";
+
+
+    //static int mNumSendForegroundNotification = 10000;
+    //static int mNumSendSMSNotification = 20000;
+
+    public NotificationManager createServiceNotificationChannel(Context context) {
+        //创建通知渠道ID
+		String channelId = szServiceChannelID;
+		//创建通知渠道名称
+		String channelName = "Service Message";
+		//创建通知渠道重要性
+		int importance = NotificationManager.IMPORTANCE_MIN;
+		NotificationChannel channel = new NotificationChannel(channelId, channelName, importance);
+		channel.setSound(null, null);
+		NotificationManager notificationManager = (NotificationManager) context.getSystemService(
+			Context.NOTIFICATION_SERVICE);
+		notificationManager.createNotificationChannel(channel);
+		return notificationManager;
+    }
+
+    public NotificationManager createSMSNotificationChannel(Context context) {
+        //创建通知渠道ID
+		String channelId = szSMSChannelID;
+		//创建通知渠道名称
+		String channelName = "SMS Message";
+		//创建通知渠道重要性
+		int importance = NotificationManager.IMPORTANCE_HIGH;
+		NotificationChannel channel = new NotificationChannel(channelId, channelName, importance);
+		channel.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_RINGTONE), Notification.AUDIO_ATTRIBUTES_DEFAULT);
+		NotificationManager notificationManager = (NotificationManager) context.getSystemService(
+			Context.NOTIFICATION_SERVICE);
+		notificationManager.createNotificationChannel(channel);
+		return notificationManager;
+    }
+
+    // 创建通知
+    //
+    public void sendForegroundNotification(MainService service, MessageNotificationBean nessageNotificationBean) {
+		//创建Notification，传入Context和channelId
+		Intent intent = new Intent();//这个intent会传给目标,可以使用getIntent来获取
+		intent.setClass(service, MainActivity.class);
+
+		//这里放一个count用来区分每一个通知
+		//intent.putExtra("intent", "intent--->" + count);//这里设置一个数据,带过去
+
+		//参数1:context 上下文对象
+		//参数2:发送者私有的请求码(Private request code for the sender)
+		//参数3:intent 意图对象
+		//参数4:必须为FLAG_ONE_SHOT,FLAG_NO_CREATE,FLAG_CANCEL_CURRENT,FLAG_UPDATE_CURRENT,中的一个
+		PendingIntent mForegroundPendingIntent = PendingIntent.getActivity(service, nessageNotificationBean.getMessageId(), intent, PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT);
+
+		Notification mForegroundNotification = new Notification.Builder(service, szServiceChannelID)
+			.setAutoCancel(true)
+			.setContentTitle(nessageNotificationBean.getTitle())
+			.setContentText(nessageNotificationBean.getContent())
+			.setWhen(System.currentTimeMillis())
+			.setSmallIcon(R.drawable.ic_launcher)
+			//设置红色
+			.setColor(Color.parseColor("#F00606"))
+			.setLargeIcon(BitmapFactory.decodeResource(service.getResources(), R.drawable.ic_launcher))
+			.setContentIntent(mForegroundPendingIntent)
+			.build();
+
+
+		RemoteViews mrvForegroundNotificationView = new RemoteViews(service.getPackageName(), R.layout.remoteview);
+		mrvForegroundNotificationView.setTextViewText(R.id.remoteviewTextView1, nessageNotificationBean.getTitle());
+		mrvForegroundNotificationView.setTextViewText(R.id.remoteviewTextView2, nessageNotificationBean.getContent());
+		mrvForegroundNotificationView.setImageViewResource(R.id.remoteviewImageView1, R.drawable.ic_launcher);
+		mForegroundNotification.contentView = mrvForegroundNotificationView;
+		mForegroundNotification.bigContentView = mrvForegroundNotificationView;
+
+		service.startForeground(nessageNotificationBean.getMessageId(), mForegroundNotification);
+
+    }
+
+    public void sendSMSNotification(Context context, MessageNotificationBean messageNotificationBean) {
+        NotificationManager notificationManager = (NotificationManager) context.getSystemService(
+			Context.NOTIFICATION_SERVICE);
+		/*NotificationManager notificationManager = createSMSNotificationChannel(context);
+		 if (notificationManager == null) {
+		 LogUtils.d(TAG, "createSMSNotificationChannel failed.");
+		 return;
+		 }*/
+
+		//创建Notification，传入Context和channelId
+		Intent intent = new Intent(context, SMSActivity.class);
+		intent.putExtra(SMSActivity.EXTRA_PHONE, messageNotificationBean.getPhone());
+		LogUtils.d(TAG, "sendSMSNotification(...) message.getPhone() is : " + messageNotificationBean.getPhone());
+		//Intent intent = new Intent();//这个intent会传给目标,可以使用getIntent来获取
+		//intent.setClass(context, MainActivity.class);
+		//这里放一个count用来区分每一个通知
+		//intent.putExtra("intent", "intent--->" + count);//这里设置一个数据,带过去
+
+		//参数1:context 上下文对象
+		//参数2:发送者私有的请求码(Private request code for the sender)
+		//参数3:intent 意图对象
+		//参数4:必须为FLAG_ONE_SHOT,FLAG_NO_CREATE,FLAG_CANCEL_CURRENT,FLAG_UPDATE_CURRENT,中的一个
+		PendingIntent mRemindPendingIntent = PendingIntent.getActivity(context, messageNotificationBean.getMessageId(), intent, PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT);
+		Notification mSMSNotification = new Notification.Builder(context, szSMSChannelID)
+			.setAutoCancel(true)
+			.setContentTitle(messageNotificationBean.getTitle())
+			.setContentText(messageNotificationBean.getContent())
+			.setWhen(System.currentTimeMillis())
+			.setSmallIcon(R.drawable.ic_launcher)
+			//设置红色
+			.setColor(Color.parseColor("#F00606"))
+			.setLargeIcon(BitmapFactory.decodeResource(context.getResources(), R.drawable.ic_launcher))
+			.setContentIntent(mRemindPendingIntent)
+			.build();
+
+		RemoteViews mrvSMSNotificationView = new RemoteViews(context.getPackageName(), R.layout.remoteview);
+		mrvSMSNotificationView.setTextViewText(R.id.remoteviewTextView1, messageNotificationBean.getTitle());
+		mrvSMSNotificationView.setTextViewText(R.id.remoteviewTextView2, messageNotificationBean.getContent());
+		mrvSMSNotificationView.setImageViewResource(R.id.remoteviewImageView1, R.drawable.ic_launcher);
+		mSMSNotification.contentView = mrvSMSNotificationView;
+		mSMSNotification.bigContentView = mrvSMSNotificationView;
+		notificationManager.notify(messageNotificationBean.getMessageId(), mSMSNotification);
+        LogUtils.d(TAG, "getMessageId is : " + Integer.toString(messageNotificationBean.getMessageId()));
+
+    }
+
+    public void sendSMSReceivedMessage(Context context, int nMessageId, String szPhone, String szBody) {
+        String szTitle = context.getString(R.string.text_smsfrom)  + "<" + szPhone + ">";
+        String szContent = "[ " + szBody + " ]";
+        sendSMSNotification(context, new MessageNotificationBean(nMessageId, szPhone, szTitle, szContent));
+    }
+
+    public static void cancelNotification(Context context, int notificationId) {
+        // 获取 NotificationManager 实例
+        NotificationManager notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+        // 撤回指定 ID 的通知栏消息
+        notificationManager.cancel(notificationId);
+    }
+}
+
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationUtil_Bck.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationUtil_Bck.java
new file mode 100644
index 0000000..730af52
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/NotificationUtil_Bck.java
@@ -0,0 +1,168 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen@QQ.COM
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用通知栏工具类
+ */
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.graphics.BitmapFactory;
+import android.graphics.Color;
+import android.media.RingtoneManager;
+import android.widget.RemoteViews;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.MainActivity;
+import cc.winboll.studio.mymessagemanager.activitys.SMSActivity;
+import cc.winboll.studio.mymessagemanager.beans.MessageNotificationBean;
+import cc.winboll.studio.mymessagemanager.services.MainService;
+
+public class NotificationUtil_Bck {
+
+    public static final String TAG = "NotificationUtil";
+    public static final int ID_MSG_SERVICE = 10000;
+
+    static final String szSMSChannelID = "1";
+
+    static final String szServiceChannelID = "0";
+
+
+    //static int mNumSendForegroundNotification = 10000;
+    //static int mNumSendSMSNotification = 20000;
+
+    public NotificationManager createServiceNotificationChannel(Context context) {
+        //创建通知渠道ID
+		String channelId = szServiceChannelID;
+		//创建通知渠道名称
+		String channelName = "Service Message";
+		//创建通知渠道重要性
+		int importance = NotificationManager.IMPORTANCE_MIN;
+		NotificationChannel channel = new NotificationChannel(channelId, channelName, importance);
+		channel.setSound(null, null);
+		NotificationManager notificationManager = (NotificationManager) context.getSystemService(
+			Context.NOTIFICATION_SERVICE);
+		notificationManager.createNotificationChannel(channel);
+		return notificationManager;
+    }
+
+    public NotificationManager createSMSNotificationChannel(Context context) {
+        //创建通知渠道ID
+		String channelId = szSMSChannelID;
+		//创建通知渠道名称
+		String channelName = "SMS Message";
+		//创建通知渠道重要性
+		int importance = NotificationManager.IMPORTANCE_HIGH;
+		NotificationChannel channel = new NotificationChannel(channelId, channelName, importance);
+		channel.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_RINGTONE), Notification.AUDIO_ATTRIBUTES_DEFAULT);
+		NotificationManager notificationManager = (NotificationManager) context.getSystemService(
+			Context.NOTIFICATION_SERVICE);
+		notificationManager.createNotificationChannel(channel);
+		return notificationManager;
+    }
+
+    // 创建通知
+    //
+    public void sendForegroundNotification(MainService service, MessageNotificationBean nessageNotificationBean) {
+		//创建Notification，传入Context和channelId
+		Intent intent = new Intent();//这个intent会传给目标,可以使用getIntent来获取
+		intent.setClass(service, MainActivity.class);
+
+		//这里放一个count用来区分每一个通知
+		//intent.putExtra("intent", "intent--->" + count);//这里设置一个数据,带过去
+
+		//参数1:context 上下文对象
+		//参数2:发送者私有的请求码(Private request code for the sender)
+		//参数3:intent 意图对象
+		//参数4:必须为FLAG_ONE_SHOT,FLAG_NO_CREATE,FLAG_CANCEL_CURRENT,FLAG_UPDATE_CURRENT,中的一个
+		PendingIntent mForegroundPendingIntent = PendingIntent.getActivity(service, nessageNotificationBean.getMessageId(), intent, PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT);
+
+		Notification mForegroundNotification = new Notification.Builder(service, szServiceChannelID)
+			.setAutoCancel(true)
+			.setContentTitle(nessageNotificationBean.getTitle())
+			.setContentText(nessageNotificationBean.getContent())
+			.setWhen(System.currentTimeMillis())
+			.setSmallIcon(R.drawable.ic_launcher)
+			//设置红色
+			.setColor(Color.parseColor("#F00606"))
+			.setLargeIcon(BitmapFactory.decodeResource(service.getResources(), R.drawable.ic_launcher))
+			.setContentIntent(mForegroundPendingIntent)
+			.build();
+
+
+		RemoteViews mrvForegroundNotificationView = new RemoteViews(service.getPackageName(), R.layout.remoteview);
+		mrvForegroundNotificationView.setTextViewText(R.id.remoteviewTextView1, nessageNotificationBean.getTitle());
+		mrvForegroundNotificationView.setTextViewText(R.id.remoteviewTextView2, nessageNotificationBean.getContent());
+		mrvForegroundNotificationView.setImageViewResource(R.id.remoteviewImageView1, R.drawable.ic_launcher);
+		mForegroundNotification.contentView = mrvForegroundNotificationView;
+		mForegroundNotification.bigContentView = mrvForegroundNotificationView;
+
+		service.startForeground(nessageNotificationBean.getMessageId(), mForegroundNotification);
+
+    }
+
+    public void sendSMSNotification(Context context, MessageNotificationBean messageNotificationBean) {
+        NotificationManager notificationManager = (NotificationManager) context.getSystemService(
+			Context.NOTIFICATION_SERVICE);
+		/*NotificationManager notificationManager = createSMSNotificationChannel(context);
+		 if (notificationManager == null) {
+		 LogUtils.d(TAG, "createSMSNotificationChannel failed.");
+		 return;
+		 }*/
+
+		//创建Notification，传入Context和channelId
+		Intent intent = new Intent(context, SMSActivity.class);
+		intent.putExtra(SMSActivity.EXTRA_PHONE, messageNotificationBean.getPhone());
+		LogUtils.d(TAG, "sendSMSNotification(...) message.getPhone() is : " + messageNotificationBean.getPhone());
+		//Intent intent = new Intent();//这个intent会传给目标,可以使用getIntent来获取
+		//intent.setClass(context, MainActivity.class);
+		//这里放一个count用来区分每一个通知
+		//intent.putExtra("intent", "intent--->" + count);//这里设置一个数据,带过去
+
+		//参数1:context 上下文对象
+		//参数2:发送者私有的请求码(Private request code for the sender)
+		//参数3:intent 意图对象
+		//参数4:必须为FLAG_ONE_SHOT,FLAG_NO_CREATE,FLAG_CANCEL_CURRENT,FLAG_UPDATE_CURRENT,中的一个
+		PendingIntent mRemindPendingIntent = PendingIntent.getActivity(context, messageNotificationBean.getMessageId(), intent, PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT);
+		Notification mSMSNotification = new Notification.Builder(context, szSMSChannelID)
+			.setAutoCancel(true)
+			.setContentTitle(messageNotificationBean.getTitle())
+			.setContentText(messageNotificationBean.getContent())
+			.setWhen(System.currentTimeMillis())
+			.setSmallIcon(R.drawable.ic_launcher)
+			//设置红色
+			.setColor(Color.parseColor("#F00606"))
+			.setLargeIcon(BitmapFactory.decodeResource(context.getResources(), R.drawable.ic_launcher))
+			.setContentIntent(mRemindPendingIntent)
+			.build();
+
+		RemoteViews mrvSMSNotificationView = new RemoteViews(context.getPackageName(), R.layout.remoteview);
+		mrvSMSNotificationView.setTextViewText(R.id.remoteviewTextView1, messageNotificationBean.getTitle());
+		mrvSMSNotificationView.setTextViewText(R.id.remoteviewTextView2, messageNotificationBean.getContent());
+		mrvSMSNotificationView.setImageViewResource(R.id.remoteviewImageView1, R.drawable.ic_launcher);
+		mSMSNotification.contentView = mrvSMSNotificationView;
+		mSMSNotification.bigContentView = mrvSMSNotificationView;
+		notificationManager.notify(messageNotificationBean.getMessageId(), mSMSNotification);
+        LogUtils.d(TAG, "getMessageId is : " + Integer.toString(messageNotificationBean.getMessageId()));
+
+    }
+
+    public void sendSMSReceivedMessage(Context context, int nMessageId, String szPhone, String szBody) {
+        String szTitle = context.getString(R.string.text_smsfrom)  + "<" + szPhone + ">";
+        String szContent = "[ " + szBody + " ]";
+        sendSMSNotification(context, new MessageNotificationBean(nMessageId, szPhone, szTitle, szContent));
+    }
+
+    public static void cancelNotification(Context context, int notificationId) {
+        // 获取 NotificationManager 实例
+        NotificationManager notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+        // 撤回指定 ID 的通知栏消息
+        notificationManager.cancel(notificationId);
+    }
+}
+
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/PermissionUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/PermissionUtil.java
new file mode 100644
index 0000000..4ab5071
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/PermissionUtil.java
@@ -0,0 +1,204 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/01 13:02:30
+ * @Describe 应用权限申请工具类
+ */
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.net.Uri;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.WinBoLLActivity;
+import com.hjq.permissions.OnPermissionCallback;
+import com.hjq.permissions.Permission;
+import com.hjq.permissions.XXPermissions;
+import java.util.List;
+
+public class PermissionUtil {
+
+    public static final String TAG = "PermissionUtil";
+
+    public static boolean checkAppPermission(Context context) {
+        if (!XXPermissions.isGranted(context, Permission.READ_CONTACTS)) {
+            LogUtils.i(TAG, "Permission.READ_CONTACTS error.");
+            return false;
+        }
+        if (!XXPermissions.isGranted(context, Permission.Group.STORAGE)) {
+            LogUtils.i(TAG, "Permission.Group.STORAGE error.");
+            return false;
+        }
+        if (!XXPermissions.isGranted(context, Permission.READ_SMS)) {
+            LogUtils.i(TAG, "Permission.READ_SMS error.");
+            return false;
+        }
+        if (!XXPermissions.isGranted(context, Permission.RECEIVE_SMS)) {
+            LogUtils.i(TAG, "Permission.RECEIVE_SMS error.");
+            return false;
+        }
+
+        return true;
+    }
+
+    public static boolean checkAndGetAppPermission(Context context) {
+        if (!XXPermissions.isGranted(context, Permission.READ_CONTACTS)) {
+            getAppPermission(context, Permission.READ_CONTACTS);
+            return false;
+        }
+        if (!XXPermissions.isGranted(context, Permission.Group.STORAGE)) {
+            getAppPermissionsList(context, Permission.Group.STORAGE);
+            return false;
+        }
+        if (!XXPermissions.isGranted(context, Permission.READ_SMS)) {
+            getAppPermission(context, Permission.READ_SMS);
+            return false;
+        }
+        if (!XXPermissions.isGranted(context, Permission.RECEIVE_SMS)) {
+            getAppPermission(context, Permission.RECEIVE_SMS);
+            return false;
+        }
+        return true;
+    }
+
+    //
+    // 申请多个权限
+    //
+    static void getAppPermissionsList(final Context context, final String[] szPermissionList) {
+        XXPermissions.with(context)
+            // 申请多个权限
+            .permission(szPermissionList)
+            // 设置权限请求拦截器（局部设置）
+            //.interceptor(new PermissionInterceptor())
+            // 设置不触发错误检测机制（局部设置）
+            //.unchecked()
+            .request(new OnPermissionCallback() {
+
+                @Override
+                public void onGranted(List<String> permissions, boolean allGranted) {
+                    StringBuilder sb = new StringBuilder();
+                    for (String sz : permissions) {
+                        sb.append(sz);
+                    }
+                    if (!allGranted) {
+
+                        showPermissionDialog(context, sb.toString());
+                        LogUtils.d(TAG, "获取部分权限成功，但部分权限未正常授予");
+                        return;
+                    }
+                    checkAndGetAppPermission(context);
+                    LogUtils.d(TAG, "获取权限成功：" + sb.toString());
+                }
+
+                @Override
+                public void onDenied(List<String> permissions, boolean doNotAskAgain) {
+                    StringBuilder sb = new StringBuilder();
+                    for (String sz : permissions) {
+                        sb.append(sz);
+                    }
+                    if (doNotAskAgain) {
+                        LogUtils.d(TAG, "被永久拒绝授权，请手动授予应用权限：" + sb.toString());
+                        // 如果是被永久拒绝就跳转到应用权限系统设置页面
+                        //XXPermissions.startPermissionActivity(context, permissions);
+                        showPermissionDialog(context, sb.toString());
+
+                    } else {
+                        LogUtils.d(TAG, "获取应用权限失败：" + sb.toString());
+                    }
+                }
+            });
+    }
+
+    //
+    // 申请单个权限
+    //
+    static void getAppPermission(final Context context, final String szPermission) {
+        XXPermissions.with(context)
+            // 申请单个权限
+            .permission(szPermission)
+            // 设置权限请求拦截器（局部设置）
+            //.interceptor(new PermissionInterceptor())
+            // 设置不触发错误检测机制（局部设置）
+            //.unchecked()
+            .request(new OnPermissionCallback() {
+
+                @Override
+                public void onGranted(List<String> permissions, boolean allGranted) {
+                    StringBuilder sb = new StringBuilder();
+                    for (String sz : permissions) {
+                        sb.append(sz);
+                    }
+                    if (!allGranted) {
+                        showPermissionDialog(context, sb.toString());
+                        LogUtils.d(TAG, "获取部分权限成功，但部分权限未正常授予");
+                        return;
+                    }
+                    checkAndGetAppPermission(context);
+                    LogUtils.d(TAG, "获取权限成功：" + sb.toString());
+                }
+
+                @Override
+                public void onDenied(List<String> permissions, boolean doNotAskAgain) {
+                    StringBuilder sb = new StringBuilder();
+                    for (String sz : permissions) {
+                        sb.append(sz);
+                    }
+                    if (doNotAskAgain) {
+                        LogUtils.d(TAG, "被永久拒绝授权，请手动授予应用权限");
+                        // 如果是被永久拒绝就跳转到应用权限系统设置页面
+                        //XXPermissions.startPermissionActivity(context, permissions);
+                        showPermissionDialog(context, sb.toString());
+
+                    } else {
+                        LogUtils.d(TAG, "获取应用权限失败：" + sb.toString());
+                    }
+                }
+            });
+    }
+
+
+    //
+    // 打开应用属性设置页
+    //
+    static void openSettingIntent(Context context) {
+        Intent intent = new Intent("android.settings.APPLICATION_DETAILS_SETTINGS");
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        intent.setData(Uri.parse("package:" + context.getPackageName()));
+        context.startActivity(intent);
+    }
+
+    static void showPermissionDialog(final Context context, String szPermissionMessage) {
+        AlertDialog.Builder alertDialogBuilder = new AlertDialog.Builder(context);
+        // set title
+        alertDialogBuilder.setTitle(context.getString(R.string.app_permission_require_info));
+
+        // set dialog message
+        alertDialogBuilder
+            .setMessage(szPermissionMessage)
+            .setCancelable(false)
+            .setPositiveButton("Open Permission Dialog", new DialogInterface.OnClickListener() {
+                public void onClick(DialogInterface dialog, int id) {
+                    // if this button is clicked, close
+                    // current activity
+                    //MainActivity.this.finish();
+                    AppGoToSettingsUtil appGoToSettingsUtil = new AppGoToSettingsUtil();
+                    appGoToSettingsUtil.GoToSetting((WinBoLLActivity)context);
+                }
+            })
+            .setNegativeButton("Exit", new DialogInterface.OnClickListener() {
+                public void onClick(DialogInterface dialog, int id) {
+                    // if this button is clicked, just close
+                    // the dialog box and do nothing
+                    dialog.cancel();
+                }
+            });
+
+        // create alert dialog
+        AlertDialog alertDialog = alertDialogBuilder.create();
+
+        // show it
+        alertDialog.show();
+	}
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/PhoneUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/PhoneUtil.java
new file mode 100644
index 0000000..a3b36b5
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/PhoneUtil.java
@@ -0,0 +1,239 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/08/30 14:32
+ * @Describe 手机联系人工具类
+ */
+import android.content.ContentResolver;
+import android.content.Context;
+import android.database.Cursor;
+import android.net.Uri;
+import android.provider.ContactsContract;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.beans.PhoneBean;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import net.sourceforge.pinyin4j.PinyinHelper;
+import net.sourceforge.pinyin4j.format.HanyuPinyinCaseType;
+import net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;
+import net.sourceforge.pinyin4j.format.HanyuPinyinToneType;
+import net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;
+
+public class PhoneUtil {
+
+    public static String TAG = "PhoneUtil";
+
+    // 号码
+    public final static String NUMBER = ContactsContract.CommonDataKinds.Phone.NUMBER;
+    // 联系人姓名
+    public final static String DISPLAY_NAME = ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME;
+
+    // 上下文对象
+    Context mContext;
+    // 联系人提供者的Uri
+    Uri mUriPhoneContent = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
+
+    public PhoneUtil(Context context) {
+        mContext = context;
+    }
+
+    // 读取所有联系人
+    public List<PhoneBean> getPhoneList() {
+        List<PhoneBean> listPhoneBean = new ArrayList<>();
+        ContentResolver cr = mContext.getContentResolver();
+        Cursor cursor = cr.query(mUriPhoneContent, new String[]{NUMBER, DISPLAY_NAME}, null, null, null);
+        if (cursor != null) {
+            while (cursor.moveToNext()) {
+                // 去除号码中的空格
+                String phone = cursor.getString(0).replaceAll("\\s", "");
+                String name = cursor.getString(1);
+                PhoneBean phoneBean = new PhoneBean(name, phone);
+                listPhoneBean.add(phoneBean);
+            }
+            cursor.close();
+        }
+
+        // 按电话号码排序
+        Collections.sort(listPhoneBean, new Comparator<PhoneBean>() {
+				@Override
+				public int compare(PhoneBean o1, PhoneBean o2) {
+					return o1.getTelPhone().compareTo(o2.getTelPhone());
+				}
+			});
+
+        return listPhoneBean;
+    }
+
+    /**
+     * 根据联系人名称查询号码（兼容拼音查询）
+     * @param keyword 搜索关键词（支持汉字、拼音、拼音首字母）
+     * @return 匹配的联系人列表（包含姓名和号码）
+     */
+    public List<PhoneBean> getPhonesByName(String keyword) {
+        List<PhoneBean> result = new ArrayList<>();
+        if (keyword == null || keyword.trim().isEmpty()) {
+            return result; // 关键词为空，返回空列表
+        }
+
+        // 获取所有联系人
+        List<PhoneBean> allContacts = getPhoneList();
+        // 统一转为小写，忽略大小写
+        String keywordLower = keyword.trim().toLowerCase();
+
+        for (PhoneBean contact : allContacts) {
+            String name = contact.getName();
+            if (name == null || name.isEmpty()) {
+                continue;
+            }
+
+            // 1. 直接匹配姓名（包含关键词）
+            if (name.toLowerCase().contains(keywordLower)) {
+                result.add(contact);
+                continue;
+            }
+
+            // 2. 匹配姓名的全拼（包含关键词）
+            String namePinyin = getPinyin(name).toLowerCase();
+            if (namePinyin.contains(keywordLower)) {
+                result.add(contact);
+                continue;
+            }
+
+            // 3. 匹配姓名的拼音首字母（包含关键词）
+            String namePinyinFirstLetter = getPinyinFirstLetter(name).toLowerCase();
+            if (namePinyinFirstLetter.contains(keywordLower)) {
+                result.add(contact);
+                continue;
+            }
+        }
+
+        return result;
+    }
+
+    /**
+     * 将汉字转为全拼（不带声调，小写）
+     * 例如："张三" → "zhangsan"
+     */
+    private String getPinyin(String chinese) {
+        StringBuilder pinyin = new StringBuilder();
+        HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
+        format.setCaseType(HanyuPinyinCaseType.LOWERCASE); // 小写
+        format.setToneType(HanyuPinyinToneType.WITHOUT_TONE); // 不带声调
+
+        char[] chars = chinese.toCharArray();
+        for (char c : chars) {
+            // 如果是汉字，转换为拼音；否则直接拼接（如字母、数字、符号）
+            if (Character.toString(c).matches("[\\u4e00-\\u9fa5]")) {
+                try {
+                    String[] pinyinArray = PinyinHelper.toHanyuPinyinStringArray(c, format);
+                    if (pinyinArray != null && pinyinArray.length > 0) {
+                        pinyin.append(pinyinArray[0]); // 取第一个拼音（多音字默认取第一个）
+                    }
+                } catch (BadHanyuPinyinOutputFormatCombination e) {
+                    LogUtils.e(TAG, "拼音转换失败：" + e.getMessage());
+                }
+            } else {
+                pinyin.append(c);
+            }
+        }
+        return pinyin.toString();
+    }
+
+    /**
+     * 将汉字转为拼音首字母（小写）
+     * 例如："张三" → "zs"
+     */
+    private String getPinyinFirstLetter(String chinese) {
+        StringBuilder firstLetters = new StringBuilder();
+        HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
+        format.setCaseType(HanyuPinyinCaseType.LOWERCASE);
+        format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
+
+        char[] chars = chinese.toCharArray();
+        for (char c : chars) {
+            if (Character.toString(c).matches("[\\u4e00-\\u9fa5]")) {
+                try {
+                    String[] pinyinArray = PinyinHelper.toHanyuPinyinStringArray(c, format);
+                    if (pinyinArray != null && pinyinArray.length > 0) {
+                        // 取拼音首字母（如"zhang" → "z"）
+                        firstLetters.append(pinyinArray[0].charAt(0));
+                    }
+                } catch (BadHanyuPinyinOutputFormatCombination e) {
+                    LogUtils.e(TAG, "拼音首字母转换失败：" + e.getMessage());
+                }
+            } else {
+                // 非汉字直接拼接首字符（如"李3" → "l3"）
+                firstLetters.append(c);
+            }
+        }
+        return firstLetters.toString();
+    }
+
+    public boolean isPhoneInContacts(String szPhone) {
+        List<PhoneBean> listPhoneDto = getPhoneList();
+        LogUtils.d(TAG, String.format("isPhoneInContacts(...) listPhoneDto.size() %d", listPhoneDto.size()));
+        for (int i = 0; i < listPhoneDto.size(); i++) {
+            if (isTheSamePhoneNumber(listPhoneDto.get(i).getTelPhone(), szPhone)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    public String getNameByPhone(String szPhone) {
+        if (szPhone == null || szPhone.equals("")) {
+            return "";
+        }
+
+        List<PhoneBean> listPhoneDto = getPhoneList();
+        LogUtils.d(TAG, String.format("getNameByPhone(...) listPhoneDto.size() %d", listPhoneDto.size()));
+        for (int i = 0; i < listPhoneDto.size(); i++) {
+            if (isTheSamePhoneNumber(listPhoneDto.get(i).getTelPhone(), szPhone)) {
+                return listPhoneDto.get(i).getName();
+            }
+        }
+        return "";
+    }
+
+    public boolean isTheSamePhoneNumber(String szNum1, String szNum2) {
+        if (szNum1.equals(szNum2)) {
+            LogUtils.d(TAG, "szNum1.equals(szNum2)");
+            return true;
+        }
+
+        if (UnitAreaUtils.getInstance(mContext).isCurrentUnitAreaNumber(szNum1)) {
+            if (szNum1.equals(UnitAreaUtils.getInstance(mContext).genCurrentUnitAreaNumber(szNum2))) {
+                LogUtils.d(TAG, "szNum1.equals(UnitAreaUtils.genCurrentUnitAreaNumber(szNum2))");
+                return true;
+            }
+        }
+
+        if (UnitAreaUtils.getInstance(mContext).isCurrentUnitAreaNumber(szNum2)) {
+            if (szNum2.equals(UnitAreaUtils.getInstance(mContext).genCurrentUnitAreaNumber(szNum1))) {
+                LogUtils.d(TAG, "szNum2.equals(UnitAreaUtils.genCurrentUnitAreaNumber(szNum1))");
+                return true;
+            }
+        }
+
+        LogUtils.d(TAG, "isTheSamePhoneNumber(...) return false;");
+        return false;
+    }
+
+    // 检验电话号码是否是数字
+    public static boolean isPhoneByDigit(String szPhone) {
+        if (!RegexPPiUtils.isPPiOK(szPhone)) {
+            return false;
+        }
+        String regex = "[+]?\\d+";
+        Pattern pattern = Pattern.compile(regex);
+        Matcher matcher = pattern.matcher(szPhone);
+        LogUtils.d(TAG, String.format("matcher.matches() : %s", matcher.matches()));
+        return matcher.matches();
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/RegexPPiUtils.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/RegexPPiUtils.java
new file mode 100644
index 0000000..111579d
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/RegexPPiUtils.java
@@ -0,0 +1,32 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/09 11:10
+ * @Describe  .* 前置预防针
+ * regex pointer preventive injection
+ * 简称 RegexPPi
+ */
+public class RegexPPiUtils {
+
+	public static final String TAG = "RegexPPiUtils";
+
+	//
+	// 检验文本是否满足适合正则表达式模式计算
+	//
+	public static boolean isPPiOK(String text) {
+		//String text = "这里是一些任意的文本内容";
+		String regex = ".*";
+		Pattern pattern = Pattern.compile(regex);
+		Matcher matcher = pattern.matcher(text);
+		/*if (matcher.matches()) {
+		 System.out.println("文本满足该正则表达式模式");
+		 } else {
+		 System.out.println("文本不满足该正则表达式模式");
+		 }*/
+		return matcher.matches();
+	}
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSReceiveRuleUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSReceiveRuleUtil.java
new file mode 100644
index 0000000..58801a1
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSReceiveRuleUtil.java
@@ -0,0 +1,303 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2023/07/01 05:59:25
+ * @Describe 短信接收过滤规则工具类
+ */
+import android.content.Context;
+import android.util.JsonReader;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.beans.SMSAcceptRuleBean;
+import cc.winboll.studio.mymessagemanager.beans.SMSAcceptRuleBean_V1;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.text.Collator;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+
+public class SMSReceiveRuleUtil {
+
+    public static final String TAG = "SMSReceiveRuleUtil";
+
+    public static final int VALID_MATCHRESULT_POSITION = -1;
+
+
+    // 单例模式的实例变量
+    static SMSReceiveRuleUtil _mInstance;
+    // 类实例运行的上下文环境
+    Context mContext;
+    // 当前实例的配置操作数据
+    ArrayList<SMSAcceptRuleBean> mDataList;
+
+    //
+    // ReceiveRule 规则数组匹配结果数据类
+    //
+    public class MatchResult {
+        // 当前匹配规则的运算结果
+        public SMSAcceptRuleBean.RuleType matchRuleType;
+        // 在规则数组中匹配的位置
+        public int matchPositionInRules;
+        
+        MatchResult() {
+            matchRuleType = SMSAcceptRuleBean.RuleType.ACCEPT;
+            // 在规则数组中匹配的位置
+            matchPositionInRules = VALID_MATCHRESULT_POSITION;
+        }
+    }
+
+    //
+    // 私有的隐藏的实例构造函数
+    //
+    private SMSReceiveRuleUtil(Context context) {
+        // 保存当前类实例的运行环境
+        mContext = context;
+        //mszConfigPath = context.getExternalFilesDir(TAG) + File.separator + mszConfigFileName;
+        // 从存储设备加载应用数据
+        mDataList = new ArrayList<SMSAcceptRuleBean>();
+        loadConfigData();
+    }
+
+    //
+    // 为了解决各个窗口数据同步问题，
+    // 设置数据重加载开关
+    // @isReload : 每次取数据实例都从存储设备读取数据
+    //
+    public static SMSReceiveRuleUtil getInstance(Context context, boolean isReload) {
+        if (_mInstance == null) {
+            _mInstance = new SMSReceiveRuleUtil(context);
+        } else if (isReload) {
+            _mInstance = new SMSReceiveRuleUtil(context);
+        }
+
+        return _mInstance;
+    }
+
+    //
+    // 从存储设备读取数据，添加默认配置，并保存到存储设备。
+    //
+    public void resetConfig() {
+        String szAssetsFilePath = "GlobalApplication/SMSAcceptRuleBean_List.json";
+        SMSAcceptRuleBean beanTemp = new SMSAcceptRuleBean();
+        String szConfigFilePath = beanTemp.getBeanListJsonFilePath(mContext);
+        /*File fConfigFilePath = new File(szConfigFilePath);
+         if(fConfigFilePath.exists()) {
+         fConfigFilePath.delete();
+         }*/
+        FileUtil.copyAssetsToSD(mContext, szAssetsFilePath, szConfigFilePath);
+        loadConfigData();
+    }
+
+    public void cleanConfig() {
+        mDataList.clear();
+        saveConfigData();
+    }
+
+    //
+    // Rule数据排序
+    // @isDesc : 是否降序排列
+    //
+    public static <T extends SMSAcceptRuleBean> void sortListByRuleData(List<T> list, boolean isDesc) {
+        Collections.sort(list, new SortListByRuleData(isDesc));
+    }
+
+    //
+    // Rule数据排序比较类定义
+    //
+    static class SortListByRuleData implements Comparator<SMSAcceptRuleBean> {
+        private boolean mIsDesc = true;
+        // isDesc 是否降序排列
+        public SortListByRuleData(boolean isDesc) {
+            mIsDesc = isDesc;
+        }
+        Collator cmp = Collator.getInstance(java.util.Locale.CHINA);
+        @Override
+        public int compare(SMSAcceptRuleBean o1, SMSAcceptRuleBean o2) {
+            int b0_1 = cmp.compare(o1.getRuleData(), o2.getRuleData());
+            if (mIsDesc) {
+                return b0_1 > 0 ? -1 : 1;
+            } else {
+                return b0_1 > 0 ? 1 : -1;
+            }
+        }
+    }
+
+    //
+    // 添加Rule数据现
+    // @szRule : Rule数据内容
+    // @isEnable ： Rule数据启用开关项
+    // @@ 返回 ：Rule数据添加结果
+    //
+    public boolean addRule(SMSAcceptRuleBean bean) {
+        loadConfigData();
+        mDataList.add(bean);
+        saveConfigData();
+        return true;
+    }
+
+    //
+    // 校验短信是否在规则表里
+    //
+    public boolean checkIsSMSAcceptInRule(Context context, String szSMS) {
+        /*ArrayList<SMSAcceptRuleBean> configData = loadConfigData();
+         for (int i = 0; i < configData.size(); i++) {
+         SMSAcceptRuleBean bean = configData.get(i);
+         if (bean.isEnable()) {
+         String regex = bean.getRuleData();
+         if (szSMS.matches(regex)) {
+         if (bean.getRuleType() == SMSAcceptRuleBean.RuleType.REFUSE) {
+         return false;
+         } else if (bean.getRuleType() == SMSAcceptRuleBean.RuleType.ACCEPT) {
+         return true;
+         }
+         }
+         }
+
+         }*/
+        MatchResult matchResult = getReceiveRuleMatchResult(context, szSMS);
+        return matchResult.matchRuleType == SMSAcceptRuleBean.RuleType.ACCEPT;
+    }
+
+    //
+    // 校验短信是否在规则表里
+    //
+    public MatchResult getReceiveRuleMatchResult(Context context, String szSMS) {
+        
+        MatchResult matchResult = new MatchResult();
+        matchResult.matchRuleType = !RegexPPiUtils.isPPiOK(szSMS)? SMSAcceptRuleBean.RuleType.REGEXPPIUTILS_ISPPIOK_FALSE : matchResult.matchRuleType;
+        //LogUtils.d(TAG, "RegexPPiUtils.isPPiOK(szSMS) " + Boolean.toString(RegexPPiUtils.isPPiOK(szSMS)));
+        
+        ArrayList<SMSAcceptRuleBean> configData = loadConfigData();
+        for (int i = 0; i < configData.size(); i++) {
+            SMSAcceptRuleBean bean = configData.get(i);
+            if (bean.isEnable()) {
+                String regex = bean.getRuleData();
+                if (szSMS.matches(regex)) {
+                    matchResult.matchRuleType = bean.getRuleType();
+                    matchResult.matchPositionInRules = i;
+                    LogUtils.d(TAG, "matchPositionInRules " + Integer.toString(i));
+                    return matchResult;
+                }
+            }
+
+        }
+        return matchResult;
+    }
+
+    //
+    // 加载应用配置数据
+    //
+    public ArrayList<SMSAcceptRuleBean> loadConfigData() {
+        ArrayList<SMSAcceptRuleBean> list = new ArrayList<SMSAcceptRuleBean>();
+        SMSAcceptRuleBean.loadBeanList(mContext, list, SMSAcceptRuleBean.class);
+//        for (int i = 0; i < list.size(); i++) {
+//            LogUtils.d(TAG, "loadConfigData isEnable : " + Boolean.toString(list.get(i).isEnable()));
+//        }
+        mDataList.clear();
+        mDataList.addAll(list);
+        return mDataList;
+    }
+
+    /*ArrayList<SMSAcceptRuleBean_V1> loadDataFromPath(String szPath) {
+     File fJson = new File(szPath);
+     ArrayList<SMSAcceptRuleBean_V1> listTemp = null;
+     try {
+     listTemp = readJsonStream(new FileInputStream(fJson));
+     } catch (IOException e) {
+     LogUtils.d(TAG, "IOException : " + e.getMessage());
+     }
+     if (listTemp == null) {
+     listTemp = new ArrayList<SMSAcceptRuleBean_V1>();
+     }
+     return listTemp;
+     }*/
+
+    //
+    // 读取 Json 文件
+    //
+    public ArrayList<SMSAcceptRuleBean_V1> readJsonStream_V1(InputStream in) throws IOException {
+        JsonReader reader = new JsonReader(new InputStreamReader(in, "UTF-8"));
+        return readJsonArrayList_V1(reader);
+    }
+
+    //
+    // 读取 Json 文件的每一 Json 项
+    //
+    public ArrayList<SMSAcceptRuleBean_V1> readJsonArrayList_V1(JsonReader reader) throws IOException {
+        ArrayList<SMSAcceptRuleBean_V1> list = new ArrayList<SMSAcceptRuleBean_V1>();
+        reader.beginArray();
+        while (reader.hasNext()) {
+            list.add(readBeanItem_V1(reader));
+        }
+        reader.endArray();
+        return list;
+    }
+
+    //
+    // 读取 Json 文件的某一 Json 项
+    //
+    public SMSAcceptRuleBean_V1 readBeanItem_V1(JsonReader reader) throws IOException {
+        SMSAcceptRuleBean_V1 bean = new SMSAcceptRuleBean_V1();
+        int nReaderCount = 0;
+        reader.beginObject();
+        while (reader.hasNext()) {
+            String name = reader.nextName();
+            if (name.equals("userID")) {
+                bean.setUserID(reader.nextString());
+                nReaderCount++;
+            } else if (name.equals("ruleData")) {
+                bean.setRuleData(reader.nextString());
+                nReaderCount++;
+            } else if (name.equals("enable")) {
+                bean.setEnable(reader.nextBoolean());
+                nReaderCount++;
+            } else {
+                reader.skipValue();
+            }
+        }
+        reader.endObject();
+        return nReaderCount > 0 ? bean : null;
+    }
+
+    //
+    // 写入 Json 文件的某一 Json 项
+    //
+    /*public void writeBeanItem(JsonWriter writer, SMSAcceptRuleBean_V1 bean) throws IOException {
+     writer.beginObject();
+     writer.name("userID").value(bean.getUserID());
+     writer.name("ruleData").value(bean.getRuleData());
+     writer.name("enable").value(bean.isEnable());
+     writer.endObject();
+     }*/
+
+    //
+    // 保存应用配置数据
+    //
+    public void saveConfigData() {
+        SMSAcceptRuleBean.saveBeanList(mContext, mDataList, SMSAcceptRuleBean.class);
+    }
+
+    /*//
+     // 写入 Json 文件
+     //
+     public void writeJsonStream(OutputStream out, ArrayList<SMSAcceptRuleBean_V1> beanList) throws IOException {
+     JsonWriter writer = new JsonWriter(new OutputStreamWriter(out, "UTF-8"));
+     writer.setIndent("  ");
+     writeJsonArrayList(writer, beanList);
+     writer.close();
+     }
+
+     //
+     // 记录 Json 文件的某一 Json 项
+     //
+     public void writeJsonArrayList(JsonWriter writer, ArrayList<SMSAcceptRuleBean_V1> beanList) throws IOException {
+     writer.beginArray();
+     for (SMSAcceptRuleBean_V1 bean : beanList) {
+     writeBeanItem(writer, bean);
+     }
+     writer.endArray();
+     }*/
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSRecycleUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSRecycleUtil.java
new file mode 100644
index 0000000..466084b
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSRecycleUtil.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 19:29:59
+ * @Describe 短信回收站工具类
+ */
+import android.content.Context;
+import cc.winboll.studio.mymessagemanager.App;
+import cc.winboll.studio.mymessagemanager.beans.SMSBean;
+import cc.winboll.studio.mymessagemanager.beans.SMSRecycleBean;
+import java.util.ArrayList;
+
+public class SMSRecycleUtil {
+    
+    public static final String TAG = "SMSRecycleUtil";
+    
+    public static String getSMSRecycleListDataPath(Context context) {
+        if(cc.winboll.studio.mymessagemanager.BuildConfig.DEBUG) {
+            return context.getExternalFilesDir(TAG) + "/mSMSRecycleList.json";
+        } else {
+            return context.getDataDir() + "/home/" + TAG + "/mSMSRecycleList.json";
+        }
+    }
+    
+    public static void addSMSRecycleItem(Context context, SMSBean bean) {
+        ArrayList<SMSRecycleBean> list = new ArrayList<SMSRecycleBean>();
+        SMSRecycleBean.loadBeanListFromFile(getSMSRecycleListDataPath(context), list, SMSRecycleBean.class);
+        SMSRecycleBean smsRecycleBean = new SMSRecycleBean(bean, System.currentTimeMillis());
+        list.add(smsRecycleBean);
+        SMSRecycleBean.saveBeanListToFile(getSMSRecycleListDataPath(context), list);
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSUtil.java
new file mode 100644
index 0000000..2ead9a3
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/SMSUtil.java
@@ -0,0 +1,387 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用短信管理工具类
+ */
+import android.app.PendingIntent;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.Intent;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteException;
+import android.net.Uri;
+import android.os.Bundle;
+import android.provider.Telephony;
+import android.telephony.gsm.SmsManager;
+import android.telephony.gsm.SmsMessage;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.mymessagemanager.beans.SMSBean;
+import java.util.ArrayList;
+
+public class SMSUtil {
+
+    public static String TAG = "SMSUtil";
+    public static String SENT_SMS_ACTION = SMSUtil.class.getName() + ".SENT_SMS_ACTION";
+    public static String DELIVERED_SMS_ACTION = SMSUtil.class.getName() + ".SENT_SMS_ACTION";
+
+    final static String SMS_URI_ALL = "content://sms/"; // 所有短信
+    final static String SMS_URI_INBOX = "content://sms/inbox"; // 收件箱
+    final static String SMS_URI_SEND = "content://sms/sent"; // 已发送
+    final static String SMS_URI_DRAFT = "content://sms/draft"; // 草稿
+    final static String SMS_URI_OUTBOX = "content://sms/outbox"; // 发件箱
+    final static String SMS_URI_FAILED = "content://sms/failed"; // 发送失败
+    final static String SMS_URI_QUEUED = "content://sms/queued"; // 待发送列表
+
+    //
+    // 获得短信内容
+    //
+    public static String getSmsBody(Intent intent) {
+
+        String tempString = "";
+        Bundle bundle = intent.getExtras();
+        Object messages[] = (Object[]) bundle.get("pdus");
+        SmsMessage[] smsMessage = new SmsMessage[messages.length];
+        for (int n = 0; n < messages.length; n++) {
+            smsMessage[n] = SmsMessage.createFromPdu((byte[]) messages[n]);
+            // 短信有可能因为使用了回车而导致分为多条，所以要加起来接受
+            tempString += smsMessage[n].getDisplayMessageBody();
+        }
+        return tempString;
+
+    }
+
+    public static int deleteSMSById(Context context, int nDeleteId) {
+        //LogUtils.d(TAG, "nDeleteId is " + Integer.toString(nDeleteId));
+        int nResult = 0;
+        //int nTotal = 0;
+        //Uri uri = Uri.parse(SMS_URI_ALL);
+        //String[] projection = new String[] { "_id", "address", "person",
+        //    "body", "date", "type", };
+        /*Cursor cursor = context.getContentResolver().query(uri, projection,
+         "_id = ? ",
+         new String[] {Integer.toString(nDeleteId)},
+         "");*/
+        nResult = context.getContentResolver().delete(Uri.parse("content://sms/" + Integer.toString(nDeleteId)), null, null);
+        /*if (cursor.moveToFirst()) {
+         do {
+         //nTotal++;
+         //int nSMSId = cursor.getInt(0);
+         //String szType = (SMSBean.Type.values()[cursor.getInt(5)]).toString();
+         //LogUtils.d(TAG, "nSMSId is : " + Integer.toString(nSMSId));
+         //LogUtils.d(TAG, "szType is : " + szType);
+         //if (nSMSId == nDeleteId) {
+         //LogUtils.d(TAG, "nSMSId == nDeleteId");
+         //int threadId = cursor.getInt(cursor.getColumnIndex("_id"));
+         //nResult = context.getContentResolver().delete(Uri.parse("content://sms/" + nSMSId), null, null);
+         //LogUtils.d(TAG, "getContentResolver delete");
+         //}
+         } while (cursor.moveToNext());
+         }*/
+
+        /*if (!cursor.isClosed()) {
+         cursor.close();
+         cursor = null;
+         }*/
+
+        //LogUtils.d(TAG, "nTotal is : " + Integer.toString(nTotal));
+        //LogUtils.d(TAG, "nResult is : " + Integer.toString(nResult));
+        return nResult;
+    }
+
+    public static ArrayList<SMSBean> getAllSMSList(Context context) {
+        ArrayList<SMSBean> returnList = new ArrayList<SMSBean>();
+        try {
+            String szReplaceString = AppConfigUtil.getInstance(context).getPhoneReplaceString();
+
+            Uri uri = Uri.parse(SMS_URI_ALL);
+            String[] projection = new String[] { "_id", "address", "person",
+                "body", "date", "type", };
+            Cursor cur = context.getContentResolver().query(uri, projection,
+                                                            "",
+                                                            null,
+                                                            "");
+            // 获取短信中最新的未读短信
+            // Cursor cur = getContentResolver().query(uri, projection,
+            // "read = ?", new String[]{"0"}, "date desc");
+            if (cur.moveToFirst()) {
+                do {
+                    SMSBean smsBean = new SMSBean();
+                    smsBean.setId(cur.getInt(0));
+                    smsBean.setAddress(cur.getString(1).replaceAll(szReplaceString, ""));
+                    smsBean.setPerson(cur.getInt(2));
+                    smsBean.setBody(cur.getString(3));
+                    smsBean.setDate(cur.getLong(4));
+                    smsBean.setType(SMSBean.Type.values()[cur.getInt(5)]);
+                    returnList.add(smsBean);
+                } while (cur.moveToNext());
+
+                // 按时间降序排列
+                SMSBean.sortSMSByDateDesc(returnList, true);
+
+                // 去除重复 mszAddress 的数据;
+                for (int i = returnList.size() - 1; i > -1; i--) {
+                    String szCheckAddress =returnList.get(i).getAddress();
+					if (szCheckAddress != null) {
+						for (int j = i - 1; j > -1; j--) {
+							if ((returnList.get(j).getAddress() != null)
+								&& (szCheckAddress.equals(returnList.get(j).getAddress()))) {
+								returnList.remove(i);
+								break;
+							}
+						}
+					}
+
+                }
+
+                if (!cur.isClosed()) {
+                    cur.close();
+                    cur = null;
+                }
+            }
+        } catch (SQLiteException e) {
+            LogUtils.d(TAG, e.getMessage(), Thread.currentThread().getStackTrace());
+        }
+        return returnList;
+    }
+
+    public static ArrayList<SMSBean> getSMSListByPhone(Context context, String szPhone) {
+        ArrayList<SMSBean> returnList = new ArrayList<SMSBean>();
+        try {
+
+
+            Uri uri = Uri.parse(SMS_URI_ALL);
+            String[] projection = new String[] { "_id", "address", "person",
+                "body", "date", "type", };
+            Cursor cursor;
+            AppConfigUtil configUtil = AppConfigUtil.getInstance(context);
+            String szPhoneCountryCodePrefix = "\\s";
+            if (configUtil.mAppConfigBean.isMergeCountryCodePrefix()) {
+                szPhoneCountryCodePrefix = "+" + configUtil.mAppConfigBean.getCountryCode() + szPhone;
+                cursor = context.getContentResolver().query(uri, projection,
+                                                            "address = ? or address = ? ",
+                                                            new String[] {szPhone, szPhoneCountryCodePrefix},
+                                                            "");
+            } else {
+                cursor = context.getContentResolver().query(uri, projection,
+                                                            "address = ? ",
+                                                            new String[] {szPhone},
+                                                            "");
+            }
+            // 获取短信中最新的未读短信
+            // Cursor cur = getContentResolver().query(uri, projection,
+            // "read = ?", new String[]{"0"}, "date desc");
+            if (cursor.moveToFirst()) {
+                do {
+                    /*int nSMSId = cursor.getInt(0);
+                     String szType = (SMSBean.Type.values()[cursor.getInt(5)]).toString();
+                     LogUtils.d(TAG, "nSMSId is : " + Integer.toString(nSMSId));
+                     LogUtils.d(TAG, "szType is : " + szType);
+                     */
+
+                    SMSBean smsBean = new SMSBean();
+                    smsBean.setId(cursor.getInt(0));
+                    smsBean.setAddress(cursor.getString(1));
+                    smsBean.setPerson(cursor.getInt(2));
+                    smsBean.setBody(cursor.getString(3));
+                    smsBean.setDate(cursor.getLong(4));
+                    smsBean.setType(SMSBean.Type.values()[cursor.getInt(5)]);
+                    /*long nDateDefault = Date.parse("2022/01/01");
+                     if (smsBean.mnDate < nDateDefault) {
+                     LogUtils.d(TAG, "smsBean >>> " + smsBean.toString());
+                     smsBean.mnDate = nDateDefault;
+                     }*/
+
+                    returnList.add(smsBean);
+                } while (cursor.moveToNext());
+
+                if (!cursor.isClosed()) {
+                    cursor.close();
+                    cursor = null;
+                }
+            }
+        } catch (SQLiteException e) {
+            LogUtils.d("SQLiteException : ", e.getMessage());
+        }
+        return returnList;
+    }
+
+
+    //
+    // 获得短信地址
+    //
+    public static String getSmsAddress(Intent intent) {
+
+        Bundle bundle = intent.getExtras();
+        Object messages[] = (Object[]) bundle.get("pdus");
+        return SmsMessage.createFromPdu((byte[]) messages[0])
+            .getDisplayOriginatingAddress();
+    }
+
+    public static int saveReceiveSms(Context context, String phoneNumber, String message, String readState, long time, String folderName) {
+        int nResultId = -1;
+        try {
+            ContentValues values = new ContentValues();
+            values.put("address", phoneNumber);
+            values.put("body", message);
+            values.put("read", readState); //"0" for have not read sms and "1" for have read sms
+            values.put("date", Long.toString(time));
+            //if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+			Uri uri = Telephony.Sms.Sent.CONTENT_URI;
+			if (folderName.equals("inbox")) {
+				uri = Telephony.Sms.Inbox.CONTENT_URI;
+			}
+		    // 插入数据
+            Uri uriReturn = context.getContentResolver().insert(uri, values);
+            // 读取插入记录的 id
+            nResultId = (int)ContentUris.parseId(uriReturn);
+            /*} else {
+			 // folderName  could be inbox or sent
+			 context.getContentResolver().insert(Uri.parse("content://sms/" + folderName), values);
+			 }*/
+            //ToastUtils.show("saveReceiveSms done.");
+        } catch (Exception e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        return nResultId;
+    }
+
+    public static long saveSendedSMS(Context context, String phoneNumber, String message) {
+        SMSBean smsBean = new SMSBean();
+        smsBean.setAddress(phoneNumber);
+        smsBean.setBody(message);
+        smsBean.setReadStatus(SMSBean.ReadStatus.UNREAD);
+        smsBean.setDate(System.currentTimeMillis());
+
+        return saveSendedSMS(context, smsBean);
+    }
+
+
+    public static long saveOldSendedSMS(Context context, SMSBean smsBean) {
+        long nResultId = 0;
+        try {
+            ContentValues values = SMSBean.createOldSendedSMSContentValues(smsBean);
+            LogUtils.d(TAG, "ContentValues created.");
+            //if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            Uri uri = Telephony.Sms.Sent.CONTENT_URI;
+            Uri uriReturn = context.getContentResolver().insert(uri, values);
+            LogUtils.d(TAG, "inserted");
+            // 读取插入记录的 id
+            nResultId = ContentUris.parseId(uriReturn);
+            /*} else {
+             // folderName  could be inbox or sent
+             context.getContentResolver().insert(Uri.parse(SMS_URI_SEND), values);
+             }*/
+            LogUtils.d(TAG, "nResultId : " + Long.toString(nResultId));
+        } catch (Exception e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        return nResultId;
+    }
+
+    public static long saveSendedSMS(Context context, SMSBean smsBean) {
+        long nResultId = 0;
+        try {
+            ContentValues values = SMSBean.createSendedSMSContentValues(smsBean);
+
+            //if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+			Uri uri = Telephony.Sms.Sent.CONTENT_URI;
+			Uri uriReturn = context.getContentResolver().insert(uri, values);
+            // 读取插入记录的 id
+            nResultId = ContentUris.parseId(uriReturn);
+            /*} else {
+			 // folderName  could be inbox or sent
+			 context.getContentResolver().insert(Uri.parse(SMS_URI_SEND), values);
+			 }*/
+            //LogUtils.d(TAG, "nResultId : " + Integer.toString(nResultId));
+        } catch (Exception e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        return nResultId;
+    }
+
+    // 发送短文本短信
+    // phoneNumber：接收号码
+    // message：发送内容
+    //
+    /*public static boolean sendSMS(Context context, String phoneNumber, String message) {
+     //Getting intent and PendingIntent instance
+     PendingIntent pi = PendingIntent.
+     getBroadcast(context, 0, new Intent(), PendingIntent.FLAG_IMMUTABLE);
+     //Get the SmsManager instance and call the sendTextMessage method to send message
+     SmsManager sms=SmsManager.getDefault();
+     sms.sendTextMessage(phoneNumber, null, message, pi, null);
+     if (SMSUtil.saveSendedSMS(context, phoneNumber, message) != 0) {
+     Toast.makeText(context, "TO : <" + phoneNumber + "> Sended.", Toast.LENGTH_SHORT).show();
+     return true;
+     }
+     return false;
+     }*/
+
+    //
+    // 发送长文本短信，第一种方法发送短信，是将短信分割成多条短信，分别发给接收方。
+    // phoneNumber：接收号码
+    // message：发送内容
+    //
+    /*public static boolean sendMessageByInterface(Context context, String phoneNumber, String message) {
+     SmsManager smsManager = SmsManager.getDefault();
+     //String message = "这是一条很长的短信，需要分割";
+     //int maxLength = SmsManager.getMaxMessageLength(); // 获取最大长度
+     int maxLength = 70;
+     //int remainingChars = maxLength;
+     List<String> messages = new ArrayList<>();
+     for (int i = 0; i < message.length(); i += maxLength) {
+     if (i + maxLength >= message.length()) { // 如果到达结尾
+     messages.add(message.substring(i));
+     break;
+     } else {
+     messages.add(message.substring(i, i + maxLength));
+     }
+     }
+
+     for (String msg : messages) {
+     smsManager.sendTextMessage(phoneNumber, null, msg, null, null);
+     }
+     ToastUtils.show("TO : <" + phoneNumber + "> Sended.");
+     if (SMSUtil.saveSendedSMS(context, phoneNumber, message) != 0) {
+     return true;
+     }
+     return false;
+     }*/
+
+    //
+    // 发送长文本短信，第二种方法是将短信内容一次性发给接收方。在接收方的短信列表中，显示的是一条短信，但是实际上还是按多条短信计费。
+    // phoneNumber：接收号码
+    // message：发送内容
+    //
+    public static boolean sendMessageByInterface2(Context context, String phoneNumber, String message) {
+        SmsManager sms = SmsManager.getDefault();
+
+        Intent sentIntent = new Intent(SENT_SMS_ACTION);
+        PendingIntent sentPI = PendingIntent.getBroadcast(context, 0, sentIntent, 0);
+
+        Intent deliverIntent = new Intent(DELIVERED_SMS_ACTION);
+        PendingIntent deliverPI = PendingIntent.getBroadcast(context, 0, deliverIntent, 0);
+
+        if (message.length() > 70) {  
+            ArrayList<String> msgs = sms.divideMessage(message);  
+            ArrayList<PendingIntent> sentIntents =  new ArrayList<PendingIntent>();
+            for (int i = 0;i < msgs.size();i++) {  
+                sentIntents.add(sentPI);  
+            }  
+            sms.sendMultipartTextMessage(phoneNumber, null, msgs, sentIntents, null);
+            LogUtils.d(TAG, "Long SMS TO : <" + phoneNumber + "> Sended.");
+        } else {  
+            sms.sendTextMessage(phoneNumber, null, message, sentPI, deliverPI);
+            LogUtils.d(TAG, "SMS TO : <" + phoneNumber + "> Sended.");
+        }
+        if (SMSUtil.saveSendedSMS(context, phoneNumber, message) != 0) {
+            ToastUtils.show("SMS TO : <" + phoneNumber + "> Sended.");
+            return true;
+        }
+        return false;
+	}
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ServiceUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ServiceUtil.java
new file mode 100644
index 0000000..3bc83b0
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ServiceUtil.java
@@ -0,0 +1,34 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用服务组件工具类
+ */
+import android.app.ActivityManager;
+import android.content.Context;
+import java.util.List;
+
+public class ServiceUtil {
+    public final static String TAG = "ServiceUtil";
+
+    public static boolean isServiceAlive(Context context, String szServiceName) {
+        // 获取Activity管理者对象
+        ActivityManager manager = (ActivityManager) context
+            .getSystemService(Context.ACTIVITY_SERVICE);
+        // 获取正在运行的服务（此处设置最多取1000个）
+        List<ActivityManager.RunningServiceInfo> runningServices = manager
+            .getRunningServices(1000);
+        if (runningServices.size() <= 0) {
+            return false;
+        }
+        // 遍历，若存在名字和传入的serviceName的一致则说明存在
+        for (ActivityManager.RunningServiceInfo runningServiceInfo : runningServices) {
+            if (runningServiceInfo.service.getClassName().equals(szServiceName)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/TTSPlayRuleUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/TTSPlayRuleUtil.java
new file mode 100644
index 0000000..e4d27b3
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/TTSPlayRuleUtil.java
@@ -0,0 +1,430 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe TTS 语音播放工具类
+ */
+import android.content.Context;
+import android.content.Intent;
+import android.os.Message;
+import android.util.JsonReader;
+import android.widget.Toast;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.activitys.TTSPlayRuleActivity;
+import cc.winboll.studio.mymessagemanager.beans.TTSPlayRuleBean;
+import cc.winboll.studio.mymessagemanager.beans.TTSPlayRuleBean_V1;
+import cc.winboll.studio.mymessagemanager.beans.TTSSpeakTextBean;
+import cc.winboll.studio.mymessagemanager.services.TTSPlayService;
+import cc.winboll.studio.mymessagemanager.utils.FileUtil;
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.util.ArrayList;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class TTSPlayRuleUtil {
+    public static final String TAG = "TTSPlayRuleUtil";
+
+    TTSPlayRuleActivity mTTSPlayRuleActivity;
+    static TTSPlayRuleUtil _mTTSPlayRuleUtil;
+	Context mContext;
+	ArrayList<TTSPlayRuleBean> mConfigData;
+    public static String mszConfigFileName = TAG + ".json";
+    String mszConfigPath_V1 = null;
+
+    TTSPlayRuleUtil(Context context) {
+        mContext = context;
+		mszConfigPath_V1 = context.getExternalFilesDir(TAG) + File.separator + mszConfigFileName;
+		mConfigData = new ArrayList<TTSPlayRuleBean>();
+		mConfigData = loadConfigData();
+    }
+
+    public static TTSPlayRuleUtil getInstance(Context context) {
+        if (_mTTSPlayRuleUtil == null) {
+            _mTTSPlayRuleUtil = new TTSPlayRuleUtil(context);
+        }
+        return _mTTSPlayRuleUtil;
+    }
+
+    public void initTTSPlayRuleActivity(TTSPlayRuleActivity activity) {
+        mTTSPlayRuleActivity = activity;
+    }
+
+    //
+    // 用 TTS 播放语音
+    // @szSpeak : 语音内容
+    // @nRepeat : 重复次数
+    //
+    public static void speakText(Context context, String szSpeak, int nRepeat) {
+        speakText(context, szSpeak, 0, nRepeat);
+    }
+
+
+    //
+    // 用 TTS 播放语音
+    // @szSpeak : 语音内容
+    // @nTtsPlayDelayTimes : 延迟初始播放时间毫秒数
+    // @nRepeat : 重复次数
+    //
+    public static void speakText(Context context, String szSpeak, int nTtsPlayDelayTimes, int nRepeat) {
+        // 初始化语音数据
+        ArrayList<TTSSpeakTextBean> ttsData = new ArrayList<TTSSpeakTextBean>();
+        ttsData.add(new TTSSpeakTextBean(nTtsPlayDelayTimes, szSpeak));
+        for (int i = 0; i < nRepeat - 1; i++) {
+            ttsData.add(new TTSSpeakTextBean(3000, szSpeak));
+        }
+        // 调用TTS语音服务
+        Intent intent = new Intent(context, TTSPlayService.class);
+        intent.putExtra(TTSPlayService.EXTRA_SPEAKDATA, ttsData);
+        context.startService(intent);
+    }
+
+	//
+    // 短信解析模式播放短信的 TTS 语音
+    // @context : 上下文
+    // @szSMS : 要解析的短信
+    //
+    public int speakTTSAnalyzeModeText(String szSMS) {
+		return speakTTSAnalyzeModeText(szSMS, 0);
+	}
+
+    //
+    // 短信解析模式播放短信的 TTS 语音
+    // @context : 上下文
+    // @szSMS : 要解析的短信
+    // @nTtsPlayDelayTimes : 延迟初始播放时间毫秒数
+    //
+    public int speakTTSAnalyzeModeText(String szSMS, int nTtsPlayDelayTimes) {
+        // 初始化语音数据
+        ArrayList<TTSSpeakTextBean> ttsData = new ArrayList<TTSSpeakTextBean>();
+        int reault = addTTSAnalyzeModeReply(szSMS, ttsData, nTtsPlayDelayTimes);
+
+        // 调用TTS语音服务
+        Intent intent = new Intent(mContext, TTSPlayService.class);
+        intent.putExtra(TTSPlayService.EXTRA_SPEAKDATA, ttsData);
+        mContext.startService(intent);
+
+        return reault;
+	}
+
+	public void deleteTTSRuleBean(int position) {
+		mConfigData.remove(position);
+        saveConfigData();
+	}
+
+    //
+    // 添加语音回复数据
+    // @context : 上下文
+    // @szSMS : 提供校验的短信
+    // @ttsData : 语音数据规则表
+    // @nTtsPlayDelayTimes : 延迟初始播放时间毫秒数
+    //
+    int addTTSAnalyzeModeReply(String szSMS, ArrayList<TTSSpeakTextBean> ttsData, int nTtsPlayDelayTimes) {
+        for (int i = 0; i < mConfigData.size(); i++) {
+			if (mConfigData.get(i).isEnable()) {
+				String szResult = getRewriteRegExpResult(szSMS, mConfigData.get(i).getPatternText(), mConfigData.get(i).getTtsRuleText());
+				if (!szResult.equals("")) {
+					ttsData.add(new TTSSpeakTextBean(nTtsPlayDelayTimes, szResult));
+					return i;
+				}
+			}
+        }
+        return -1;
+    }
+
+    //
+    // 添加语音回复数据
+    // @context : 上下文
+    // @szSMS : 提供校验的短信
+    // @ttsData : 语音数据规则表
+    //
+    void addTTSAnalyzeModeReply(String szSMS, ArrayList<TTSSpeakTextBean> ttsData) {
+        addTTSAnalyzeModeReply(szSMS, ttsData, 0);
+    }
+
+    //
+    // 测试语音回复数据
+    // @context : 上下文
+    // @szSMS : 示例短信
+    // @ttsData : 语音数据规则
+    //
+    public String testTTSAnalyzeModeReply(TTSPlayRuleBean bean) {
+
+        String szResult = getRewriteRegExpResult(bean.getDemoSMSText(), bean.getPatternText(), bean.getTtsRuleText());
+		if (szResult.equals("")) {
+			szResult += "\nDemoSMSText : " + bean.getDemoSMSText();
+			szResult += "\nPatternText : " + bean.getPatternText();
+			szResult += "\nTTSRuleText : " + bean.getTtsRuleText();
+		} else {
+			// 初始化语音数据
+			ArrayList<TTSSpeakTextBean> ttsData = new ArrayList<TTSSpeakTextBean>();
+			ttsData.add(new TTSSpeakTextBean(0, szResult));
+
+			// 调用TTS语音服务
+			Intent intent = new Intent(mContext, TTSPlayService.class);
+			intent.putExtra(TTSPlayService.EXTRA_SPEAKDATA, ttsData);
+			mContext.startService(intent);
+		}
+		return szResult;
+    }
+
+    //
+    // 正则替换函数
+    // @szMatchText : 操作字符串
+    // @szPattern : 查找模板
+    // @szRewrite : 替换模板
+    //
+    String getRewriteRegExpResult(String szMatchText, String szPattern, String szRewrite) {
+        String szReturn = "";
+		if (!szPattern.equals("") && !szRewrite.equals("")) {
+			try {
+				Pattern pattern = Pattern.compile(szPattern, Pattern.MULTILINE);
+				Matcher matcher = pattern.matcher(szMatchText);
+                LogUtils.d(TAG, "szMatchText : " + szMatchText);
+				while (matcher.find()) {
+					szReturn += matcher.replaceAll(szRewrite);
+				}
+			} catch (java.lang.IndexOutOfBoundsException ex) {
+				LogUtils.d(TAG, "getRewriteRegExpResult(...) IndexOutOfBoundsException : " + ex.getMessage());
+			}
+		}
+
+        return szReturn;
+    }
+
+	public void addNewTTSRuleBean(TTSPlayRuleBean bean) {
+		mConfigData.add(0, bean);
+		saveConfigData();
+	}
+
+	public void changeBeanPosition(int currentPosition, boolean isUp) {
+		if (isUp && currentPosition > 0) {
+			//LogUtils.d(TAG, "Up");
+			mConfigData.add(currentPosition - 1, mConfigData.get(currentPosition));
+			mConfigData.remove(currentPosition + 1);
+            saveConfigData();
+			return;
+		}
+
+		if (!isUp && currentPosition < mConfigData.size() - 1) {
+			//LogUtils.d(TAG, "Down");
+			mConfigData.add(currentPosition + 2, mConfigData.get(currentPosition));
+			mConfigData.remove(currentPosition);
+            saveConfigData();
+			return;
+		}
+	}
+
+	public void setBeanEnable(int position, boolean isEnable) {
+		mConfigData.get(position).setIsEnable(isEnable);
+		saveConfigData();
+	}
+
+    /*public String getConfigPath() {
+     return mszConfigPath_V1;
+     }*/
+
+    //
+    // 从指定路径的文件读取数据，添加并保存到现有的数据文件。
+    // @szPath : 要读取的文件指定的路径
+    // @@ 返回 ：添加的数据条数
+    //
+    /*public int importConfig(String szPath) {
+     ArrayList<TTSPlayRuleBean> listBeanImport = loadDataFromPath(szPath);
+     // 添加更新表到现有操作表
+     if (mConfigData == null) {
+     mConfigData = new ArrayList<TTSPlayRuleBean>();
+     }
+     ArrayList<TTSPlayRuleBean> configData = loadConfigData();
+     configData.addAll(listBeanImport);
+     // 保存操作表数据
+     saveConfigData(configData);
+     return listBeanImport.size();
+     }*/
+
+    /*ArrayList<TTSPlayRuleBean> loadDataFromPath(String szPath) {
+     File fJson = new File(szPath);
+     ArrayList<TTSPlayRuleBean> listTemp = null;
+     try {
+     listTemp = readJsonStream(new FileInputStream(fJson));
+     } catch (IOException e) {
+     LogUtils.d(TAG, "IOException : " + e.getMessage());
+     }
+     if (listTemp == null) {
+     listTemp = new ArrayList<TTSPlayRuleBean>();
+     }
+     return listTemp;
+     }*/
+
+    //
+    // 加载 TTS 配置数据
+    //
+    public ArrayList<TTSPlayRuleBean> loadConfigData() {
+        TTSPlayRuleBean.loadBeanList(mContext, mConfigData, TTSPlayRuleBean.class);
+        return mConfigData;
+    }
+
+    //
+    // 保存 TTS 配置数据
+    //
+    public void saveConfigData() {
+        // 设定只能在规则编辑窗口改变规则
+        if (mTTSPlayRuleActivity == null) {
+            LogUtils.i(TAG, "Please edit rules in TTSPlayRuleActivity.");
+            return;
+        }
+
+        YesNoAlertDialog.show(mTTSPlayRuleActivity, mContext.getString(R.string.text_ttsrule), "是否更新语音规则？", new YesNoAlertDialog.OnDialogResultListener(){
+                @Override
+                public void onYes() {
+                    TTSPlayRuleBean.saveBeanList(mContext, mConfigData, TTSPlayRuleBean.class);
+                    Toast.makeText(mTTSPlayRuleActivity, "语音数据已更改。", Toast.LENGTH_SHORT).show();
+                    
+                    Message message = new Message();
+                    message.what = TTSPlayRuleActivity.MSG_RELOAD;
+                    mTTSPlayRuleActivity.sendActivityMessage(message);
+                }
+
+                @Override
+                public void onNo() {
+                    Message message = new Message();
+                    message.what = TTSPlayRuleActivity.MSG_RELOAD;
+                    mTTSPlayRuleActivity.sendActivityMessage(message);
+                }
+            });
+    }
+
+    //
+    // 清空 TTS 配置数据
+    //
+    public void cleanConfig() {
+        YesNoAlertDialog.show(mTTSPlayRuleActivity, "确定清理", "您确定清理所有语音规则吗？", new YesNoAlertDialog.OnDialogResultListener(){
+                @Override
+                public void onYes() {
+                    mConfigData.clear();
+                    TTSPlayRuleBean.saveBeanList(mContext, mConfigData, TTSPlayRuleBean.class);
+                    Toast.makeText(mTTSPlayRuleActivity, "语音数据已更改。", Toast.LENGTH_SHORT).show();
+                    
+                    Message message = new Message();
+                    message.what = TTSPlayRuleActivity.MSG_RELOAD;
+                    mTTSPlayRuleActivity.sendActivityMessage(message);
+                }
+                @Override
+                public void onNo() {
+                }
+            });
+	}
+
+    //
+    // 重置默认 TTS 配置数据
+    //
+    public void resetConfig() {
+        YesNoAlertDialog.show(mTTSPlayRuleActivity, "确定重置", "您确定重置语音规则为默认设置吗？", new YesNoAlertDialog.OnDialogResultListener(){
+                @Override
+                public void onYes() {
+                    String szAssetsFilePath = "GlobalApplication/TTSPlayRuleBean_List.json";
+                    TTSPlayRuleBean beanTemp = new TTSPlayRuleBean();
+                    String szConfigFilePath = beanTemp.getBeanListJsonFilePath(mContext);
+                    FileUtil.copyAssetsToSD(mContext, szAssetsFilePath, szConfigFilePath);
+                    Toast.makeText(mTTSPlayRuleActivity, "语音数据已更改。", Toast.LENGTH_SHORT).show();
+                    
+                    loadConfigData();
+                    Message message = new Message();
+                    message.what = TTSPlayRuleActivity.MSG_RELOAD;
+                    mTTSPlayRuleActivity.sendActivityMessage(message);
+                }
+                @Override
+                public void onNo() {
+                }
+            });
+	}
+
+    //
+    // 读取 Json 文件
+    //
+    public ArrayList<TTSPlayRuleBean_V1> readJsonStream(InputStream in) throws IOException {
+        JsonReader reader = new JsonReader(new InputStreamReader(in, "UTF-8"));
+        return readJsonArrayList(reader);
+    }
+
+    //
+    // 读取 Json 文件的每一 Json 项
+    //
+    public ArrayList<TTSPlayRuleBean_V1> readJsonArrayList(JsonReader reader) throws IOException {
+        ArrayList<TTSPlayRuleBean_V1> list = new ArrayList<TTSPlayRuleBean_V1>();
+        reader.beginArray();
+        while (reader.hasNext()) {
+            list.add(readBeanItem(reader));
+        }
+        reader.endArray();
+        return list;
+    }
+
+    //
+    // 读取 Json 文件的某一 Json 项
+    //
+    public TTSPlayRuleBean_V1 readBeanItem(JsonReader reader) throws IOException {
+        TTSPlayRuleBean_V1 bean = new TTSPlayRuleBean_V1();
+        int nReaderCount = 0;
+        reader.beginObject();
+        while (reader.hasNext()) {
+            String name = reader.nextName();
+            if (name.equals("DemoSMSText")) {
+                bean.setDemoSMSText(reader.nextString());
+                nReaderCount++;
+            } else if (name.equals("PatternText")) {
+                bean.setPatternText(reader.nextString());
+                nReaderCount++;
+            } else if (name.equals("TTSRuleText")) {
+                bean.setTtsRuleText(reader.nextString());
+                nReaderCount++;
+            } else if (name.equals("Enable")) {
+                bean.setIsEnable(reader.nextBoolean());
+                nReaderCount++;
+            } else {
+                reader.skipValue();
+            }
+        }
+        reader.endObject();
+        return nReaderCount > 0 ? bean : null;
+    }
+
+    //
+    // 写入 Json 文件的某一 Json 项
+    //
+    /*public void writeBeanItem(JsonWriter writer, TTSPlayRuleBean bean) throws IOException {
+     writer.beginObject();
+     writer.name("Name").value(bean.getRuleName());
+     writer.name("DemoSMSText").value(bean.getDemoSMSText());
+     writer.name("PatternText").value(bean.getPatternText());
+     writer.name("TTSRuleText").value(bean.getTtsRuleText());
+     writer.name("Enable").value(bean.isEnable());
+     writer.endObject();
+     }*/
+
+    //
+    // 写入 Json 文件
+    //
+    /*public void writeJsonStream(OutputStream out, ArrayList<TTSPlayRuleBean> beanList) throws IOException {
+     JsonWriter writer = new JsonWriter(new OutputStreamWriter(out, "UTF-8"));
+     writer.setIndent("  ");
+     writeJsonArrayList(writer, beanList);
+     writer.close();
+     }
+
+     //
+     // 记录 Json 文件的某一 Json 项
+     //
+     public void writeJsonArrayList(JsonWriter writer, ArrayList<TTSPlayRuleBean> beanList) throws IOException {
+     writer.beginArray();
+     for (TTSPlayRuleBean bean : beanList) {
+     writeBeanItem(writer, bean);
+     }
+     writer.endArray();
+     }*/
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/TextToSpeechUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/TextToSpeechUtil.java
new file mode 100644
index 0000000..3ef3272
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/TextToSpeechUtil.java
@@ -0,0 +1,158 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+import android.content.Context;
+import android.graphics.PixelFormat;
+import android.os.Build;
+import android.speech.tts.TextToSpeech;
+import android.speech.tts.UtteranceProgressListener;
+import android.view.Gravity;
+import android.view.View;
+import android.view.WindowManager;
+import android.widget.LinearLayout;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.R;
+import cc.winboll.studio.mymessagemanager.beans.TTSSpeakTextBean;
+import cc.winboll.studio.mymessagemanager.views.DraggableView;
+import java.util.ArrayList;
+
+public class TextToSpeechUtil {
+
+    public static final String TAG = "TextToSpeechUtil";
+    public static final String UNIQUE_ID = "UNIQUE_ID";
+    static TextToSpeechUtil _mTextToSpeechUtil;
+
+    View mView;
+    WindowManager mWindowManager;
+    TextToSpeech mTextToSpeech;
+    Context mContext;
+    volatile boolean isExist = false;
+
+    TextToSpeechUtil(Context context) {
+        mContext = context;
+        mWindowManager = (WindowManager) mContext.getSystemService(mContext.WINDOW_SERVICE);
+    }
+
+    public static TextToSpeechUtil getInstance(Context context) {
+        if (_mTextToSpeechUtil == null) {
+            _mTextToSpeechUtil = new TextToSpeechUtil(context);
+        }
+        return _mTextToSpeechUtil;
+    }
+
+    public void speekTTSList(final ArrayList<TTSSpeakTextBean> listTTSSpeakTextBean) {
+        isExist = false;
+
+        if (mTextToSpeech == null) {
+            mTextToSpeech = new TextToSpeech(mContext, new TextToSpeech.OnInitListener() {
+					@Override
+					public void onInit(int i) {
+						if (i == TextToSpeech.SUCCESS) {
+							speekTTSList(listTTSSpeakTextBean);
+						} else {
+							LogUtils.d(TAG, "TTS init failed : " + Integer.toString(i) + ". The app [https://play.google.com/store/apps/details?id=com.google.android.tts] maybe fix this TTS probrem. ");
+						}
+					}
+				});
+            mTextToSpeech.setOnUtteranceProgressListener(mUtteranceProgressListener);
+        } else {
+            if (mTextToSpeech != null && listTTSSpeakTextBean != null && listTTSSpeakTextBean.size() > 0) {
+                if (mWindowManager != null && mView != null) {
+                    try {
+                        mWindowManager.removeView(mView);
+                        mView = null;
+                    } catch (Exception e) {
+                        LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                    }
+                }
+
+                initWindow(); // 已同步尺寸和位置
+
+                int nDelay = listTTSSpeakTextBean.get(0).mnDelay;
+                try {
+                    Thread.sleep(nDelay);
+                } catch (InterruptedException e) {
+                    LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                }
+
+                for (int speakPosition = 0; speakPosition < listTTSSpeakTextBean.size() && !isExist; speakPosition++) {
+                    String szSpeakContent = listTTSSpeakTextBean.get(speakPosition).mszSpeakContent;
+                    isExist = (listTTSSpeakTextBean.size() - 2 < speakPosition);
+                    if (speakPosition == 0) {
+                        mTextToSpeech.speak(szSpeakContent, TextToSpeech.QUEUE_FLUSH, null, UNIQUE_ID);
+                    } else {
+                        mTextToSpeech.speak(szSpeakContent, TextToSpeech.QUEUE_ADD, null, UNIQUE_ID);
+                    }
+                }
+            }
+        }
+    }
+
+    UtteranceProgressListener mUtteranceProgressListener = new UtteranceProgressListener() {
+        @Override
+        public void onStart(String utteranceId) {
+            LogUtils.d(TAG, "播放开始");
+        }
+
+        @Override
+        public void onDone(String utteranceId) {
+            LogUtils.d(TAG, "播放结束");
+            if (isExist && mWindowManager != null && mView != null) {
+                LogUtils.d(TAG, "关闭悬浮窗");
+                mWindowManager.removeView(mView);
+            }
+        }
+
+        @Override
+        public void onError(String utteranceId) {
+            LogUtils.d(TAG, "播放出错");
+        }
+    };
+
+    private void initWindow() {
+        WindowManager.LayoutParams params = new WindowManager.LayoutParams();
+
+        // 窗口类型适配
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            params.type = WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY;
+        } else {
+            params.type = WindowManager.LayoutParams.TYPE_PHONE;
+        }
+
+        // 基础配置
+        params.alpha = 0.9f;
+        params.format = PixelFormat.RGBA_8888;
+        params.flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE 
+			| WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL;
+        params.gravity = Gravity.LEFT | Gravity.TOP; // 与保存的左上角坐标匹配
+
+        // 核心修改1：同步DraggableView保存的尺寸（宽高完全一致）
+        int[] savedSize = DraggableView.getLastViewSize(mContext);
+        params.width = savedSize[0]; // 同步宽度
+        params.height = savedSize[1]; // 同步高度
+
+        // 核心修改2：同步DraggableView保存的位置
+        int[] savedPosition = DraggableView.getLastPosition(mContext);
+        params.x = savedPosition[0]; // 同步X坐标
+        params.y = savedPosition[1]; // 同步Y坐标
+
+        // 加载布局（view_tts_back.xml与DraggableView一致，确保样式统一）
+        mView = View.inflate(mContext, R.layout.view_tts_back, null);
+        LinearLayout llMain = mView.findViewById(R.id.viewttsbackLinearLayout1);
+        llMain.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View view) {
+					isExist = true;
+					if (mTextToSpeech != null) {
+						mTextToSpeech.stop();
+					}
+					if (mWindowManager != null && mView != null) {
+						mWindowManager.removeView(mView);
+						mView = null;
+					}
+				}
+			});
+
+        mWindowManager.addView(mView, params);
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ThemeUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ThemeUtil.java
new file mode 100644
index 0000000..10c6ac7
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ThemeUtil.java
@@ -0,0 +1,47 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用主题工具类
+ */
+import cc.winboll.studio.mymessagemanager.R;
+
+public class ThemeUtil {
+/*
+    public static final String SZ_THEME_TYPE = "SZ_THEME_TYPE";
+    public static final String THEME_PREFERENCES = "THEME_PREFERENCES";
+
+    public enum BaseTheme { DEFAULT(0), SKY(1), GOLDEN(2);
+        static String[] _mlistName = { "默认主题", "天空主题", "辉煌主题" };
+        private int value;
+        private BaseTheme(int value) {
+            this.value = value;
+        }
+    }
+
+    public static int getThemeID(BaseTheme baseTheme) {
+        int themeId;
+        if (baseTheme == BaseTheme.DEFAULT) {
+            themeId = R.style.AppTheme_Default;
+        } else  if (baseTheme == BaseTheme.SKY) {
+            themeId = R.style.AppTheme_Sky;
+        } else  if (baseTheme == BaseTheme.GOLDEN) {
+            themeId = R.style.AppTheme_Golden;
+        } else {
+            themeId = R.style.AppTheme_Default;
+        }
+        return themeId;
+    }
+
+    public static BaseTheme getTheme(int nThemeID) {
+        if (nThemeID == R.style.AppTheme_Sky) {
+            return BaseTheme.SKY;
+        } else  if (nThemeID ==  R.style.AppTheme_Golden) {
+            return BaseTheme.GOLDEN;
+        } else {
+            return BaseTheme.DEFAULT;
+        }
+    }
+    */
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UnitAreaUtils.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UnitAreaUtils.java
new file mode 100644
index 0000000..8d531b8
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UnitAreaUtils.java
@@ -0,0 +1,53 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen@AliYun.Com
+ * @Date 2025/04/14 15:55:36
+ * @Describe 电话号码区域管理辅助类
+ */
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.mymessagemanager.beans.AppConfigBean;
+import android.content.Context;
+
+public class UnitAreaUtils {
+
+    public static final String TAG = "UnitAreaUtils";
+
+    static UnitAreaUtils _UnitAreaUtils;
+    Context mContext;
+
+    UnitAreaUtils(Context context) {
+        mContext = context;
+    }
+
+    public static UnitAreaUtils getInstance(Context context) {
+        if (_UnitAreaUtils == null) {
+            _UnitAreaUtils = new UnitAreaUtils(context);
+        }
+        return _UnitAreaUtils;
+    }
+
+    public boolean isCurrentUnitAreaNumber(String szPhoneNumer) {
+        String szUnitArea = getUnitArea();
+		try {
+			String szPhoneNumerUnitArea = szPhoneNumer.substring(1, 3);
+			LogUtils.d(TAG, String.format("szPhoneNumerUnitArea %s", szPhoneNumerUnitArea));
+			return szPhoneNumerUnitArea.equals(szUnitArea);
+		} catch (StringIndexOutOfBoundsException e) {
+			LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+		}
+        return false;
+    }
+
+    public String genCurrentUnitAreaNumber(String szPhoneNumer) {
+        String szUnitArea = getUnitArea();
+        LogUtils.d(TAG, String.format("szUnitArea %s", szUnitArea));
+        return "+" + szUnitArea + szPhoneNumer;
+    }
+
+    String getUnitArea() {
+        String szUnitArea = AppConfigUtil.getInstance(mContext).mAppConfigBean.getCountryCode();
+        LogUtils.d(TAG, String.format("szUnitArea %s", szUnitArea));
+        return szUnitArea;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UriUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UriUtil.java
new file mode 100644
index 0000000..c22e06a
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UriUtil.java
@@ -0,0 +1,131 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe Uri 资源管理工具类
+ */
+import android.content.ContentResolver;
+import android.content.Context;
+import android.database.Cursor;
+import android.net.Uri;
+import android.provider.MediaStore;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+
+public class UriUtil {
+
+    public static final String TAG = "UriUtil";
+
+    //
+    // 获取真实路径
+    //
+    // @param context
+    //
+    public static String getFileFromUri(Context context, Uri uri) {
+        if (uri == null) {
+            return null;
+        }
+        switch (uri.getScheme()) {
+            case ContentResolver.SCHEME_CONTENT:
+                //Android7.0之后的uri content:// URI
+                return getFilePathFromContentUri(context, uri);
+            case ContentResolver.SCHEME_FILE:
+            default:
+                //Android7.0之前的uri file://
+                return new File(uri.getPath()).getAbsolutePath();
+        }
+    }
+
+    //
+    // 从uri获取path
+    //
+    // @param uri content://media/external/file/109009
+    //            <p>
+    //            FileProvider适配
+    //            content://com.tencent.mobileqq.fileprovider/external_files/storage/emulated/0/Tencent/QQfile_recv/
+    //            content://com.tencent.mm.external.fileprovider/external/tencent/MicroMsg/Download/
+    //
+    private static String getFilePathFromContentUri(Context context, Uri uri) {
+        if (null == uri) return null;
+        String data = null;
+
+        String[] filePathColumn = {MediaStore.MediaColumns.DATA, MediaStore.MediaColumns.DISPLAY_NAME};
+        Cursor cursor = context.getContentResolver().query(uri, filePathColumn, null, null, null);
+        if (null != cursor) {
+            if (cursor.moveToFirst()) {
+                int index = cursor.getColumnIndex(MediaStore.MediaColumns.DATA);
+                if (index > -1) {
+                    data = cursor.getString(index);
+                } else {
+                    int nameIndex = cursor.getColumnIndex(MediaStore.MediaColumns.DISPLAY_NAME);
+                    String fileName = cursor.getString(nameIndex);
+                    data = getPathFromInputStreamUri(context, uri, fileName);
+                }
+            }
+            cursor.close();
+        }
+        return data;
+    }
+
+    //
+    // 用流拷贝文件一份到自己APP私有目录下
+    //
+    // @param context
+    // @param uri
+    // @param fileName
+    //
+    private static String getPathFromInputStreamUri(Context context, Uri uri, String fileName) {
+        InputStream inputStream = null;
+        String filePath = null;
+
+        if (uri.getAuthority() != null) {
+            try {
+                inputStream = context.getContentResolver().openInputStream(uri);
+                File file = createTemporalFileFrom(context, inputStream, fileName);
+                filePath = file.getPath();
+
+            } catch (Exception e) {
+            } finally {
+                try {
+                    if (inputStream != null) {
+                        inputStream.close();
+                    }
+                } catch (Exception e) {
+                }
+            }
+        }
+
+        return filePath;
+    }
+
+    private static File createTemporalFileFrom(Context context, InputStream inputStream, String fileName)
+    throws IOException {
+        File targetFile = null;
+        if (inputStream != null) {
+            int read;
+            byte[] buffer = new byte[8 * 1024];
+            //自己定义拷贝文件路径
+            targetFile = new File(context.getExternalCacheDir(), fileName);
+            if (targetFile.exists()) {
+                targetFile.delete();
+            }
+            OutputStream outputStream = new FileOutputStream(targetFile);
+
+            while ((read = inputStream.read(buffer)) != -1) {
+                outputStream.write(buffer, 0, read);
+            }
+            outputStream.flush();
+
+            try {
+                outputStream.close();
+            } catch (IOException e) {
+                e.printStackTrace();
+            }
+        }
+        return targetFile;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UserVisionSystemProtectModeUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UserVisionSystemProtectModeUtil.java
new file mode 100644
index 0000000..e91ea2f
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/UserVisionSystemProtectModeUtil.java
@@ -0,0 +1,53 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/24 16:20:13
+ * @Describe 用户视觉系统保护模式工具集
+ */
+import java.util.Random;
+
+public class UserVisionSystemProtectModeUtil {
+
+    public static final String TAG = "UserVisionSystemProtectModeUtil";
+
+    public static final String PreviewShuffleSMS(String szSMSText, String szRefuseChars, String szReplaceChars) {
+        String szPreview;
+        // 将字符串转换为字符数组
+        char[] charArray = szSMSText.toCharArray();
+        // 打乱字符数组
+        shuffleArray(charArray);
+        // 构建新的字符串并打印
+        szPreview = new String(charArray);
+        szPreview = useProtectedCharsRule(szPreview, szRefuseChars, szReplaceChars);
+        return szPreview;
+    }
+
+    //
+    // 打乱字符数组的方法
+    //
+    // @param array 要被打乱的字符数组
+    //
+    public static void shuffleArray(char[] array) {
+        // 创建随机数生成器
+        Random random = new Random();
+        for (int i = array.length - 1; i > 0; i--) {
+            // 生成一个随机索引j，范围在0到i之间（包括i）
+            int j = random.nextInt(i + 1);
+
+            // 交换array[i]和array[j]的位置
+            char temp = array[i];
+            array[i] = array[j];
+            array[j] = temp;
+        }
+    }
+
+    public static String useProtectedCharsRule(String szContent, String szRefuseChars, String szReplaceChars) {
+        // 正则表达式模式 (寻找 szProtectChars 其中一个字符)
+        String pattern = "[" + szRefuseChars + "]"; 
+
+        // 替换模式后的字符串
+        String szProtectedContent = szContent.replaceAll(pattern, szReplaceChars);
+        return szProtectedContent;
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ViewUtil.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ViewUtil.java
new file mode 100644
index 0000000..72f8d00
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/utils/ViewUtil.java
@@ -0,0 +1,20 @@
+package cc.winboll.studio.mymessagemanager.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe Uri 视图元素工具类
+ */
+import android.widget.ScrollView;
+
+public class ViewUtil {
+
+    public static void scrollScrollView(final ScrollView scrollView) {
+        scrollView.post(new Runnable() {
+                @Override
+                public void run() {
+                    scrollView.fullScroll(ScrollView.FOCUS_DOWN);
+                }
+            });
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/BottomPositionFixedScrollView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/BottomPositionFixedScrollView.java
new file mode 100644
index 0000000..56ae783
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/BottomPositionFixedScrollView.java
@@ -0,0 +1,125 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/08/23 00:39
+ * @Describe 多级拉动响应自定义控件
+ */
+import android.content.Context;
+import android.util.AttributeSet;
+import android.view.ViewTreeObserver;
+import android.widget.ScrollView;
+
+public class BottomPositionFixedScrollView extends ScrollView {
+	public static final String TAG = "BottomPositionFixedScrollView";
+	// 记录底部对应的内容绝对位置（即底部位置在内容中的y坐标，该位置需始终保持在视图底部）
+	private int mBottomContentY = 0;
+	// 标记是否是首次布局（避免初始加载误触发）
+	private boolean isFirstLayout = true;
+
+	public BottomPositionFixedScrollView(Context context) {
+		super(context);
+		init();
+	}
+
+	public BottomPositionFixedScrollView(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		init();
+	}
+
+	public BottomPositionFixedScrollView(Context context, AttributeSet attrs, int defStyle) {
+		super(context, attrs, defStyle);
+		init();
+	}
+
+	private void init() {
+		// 监听布局变化（高度改变时触发）
+		getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
+				@Override
+				public void onGlobalLayout() {
+					if (isFirstLayout) {
+						isFirstLayout = false;
+						return;
+					}
+					// 布局变化后，恢复底部位置
+					restoreBottomPosition();
+				}
+			});
+	}
+
+	/**
+	 * 重写滚动事件，记录“底部对应的内容绝对位置”
+	 * （即当前视图底部边缘对应的内容y坐标，该坐标需始终保持在视图底部）
+	 */
+	@Override
+	protected void onScrollChanged(int l, int t, int oldl, int oldt) {
+		super.onScrollChanged(l, t, oldl, oldt);
+		if (getChildCount() == 0) {
+			mBottomContentY = 0;
+			return;
+		}
+
+		// 内容总高度
+		int contentHeight = getChildAt(0).getMeasuredHeight();
+		// 视图可视高度（自身高度）
+		int scrollViewHeight = getMeasuredHeight();
+		// 当前视图底部边缘对应的内容y坐标 = 顶部滚动距离(t) + 可视高度
+		// （该坐标就是“底部内容的绝对位置”，需始终保持在视图底部）
+		mBottomContentY = t + scrollViewHeight;
+
+		// 避免超过内容总高度（比如内容不足一屏时，底部最多到内容底部）
+		if (mBottomContentY > contentHeight) {
+			mBottomContentY = contentHeight;
+		}
+	}
+
+	/**
+	 * 恢复底部位置：让原记录的“底部内容绝对位置”仍保持在视图底部
+	 */
+	private void restoreBottomPosition() {
+		if (getChildCount() == 0) {
+			return;
+		}
+
+		// 新的内容总高度
+		int newContentHeight = getChildAt(0).getMeasuredHeight();
+		// 新的视图可视高度
+		int newScrollViewHeight = getMeasuredHeight();
+
+		// 目标：让原mBottomContentY（底部内容绝对位置）仍位于视图底部
+		// 此时需要的顶部滚动距离 = mBottomContentY - 新的可视高度
+		int targetScrollY = mBottomContentY - newScrollViewHeight;
+
+		// 边界修正：
+		// 1. 不能小于0（避免滚动到负数位置）
+		// 2. 不能大于“最大可滚动距离”（内容高度 - 可视高度，避免超出内容范围）
+		int maxScrollY = Math.max(newContentHeight - newScrollViewHeight, 0);
+		targetScrollY = Math.max(targetScrollY, 0);
+		targetScrollY = Math.min(targetScrollY, maxScrollY);
+
+		// 滚动到目标位置，保持底部内容位置不变
+		smoothScrollTo(0, targetScrollY);
+	}
+
+	/**
+	 * 外部手动设置底部内容绝对位置（可选）
+	 */
+	public void setBottomContentY(int bottomContentY) {
+		if (getChildCount() == 0) {
+			mBottomContentY = bottomContentY;
+			return;
+		}
+		// 限制不超过内容总高度
+		int contentHeight = getChildAt(0).getMeasuredHeight();
+		mBottomContentY = Math.min(bottomContentY, contentHeight);
+		restoreBottomPosition();
+	}
+
+	/**
+	 * 获取当前底部内容绝对位置（可选）
+	 */
+	public int getBottomContentY() {
+		return mBottomContentY;
+	}
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/ConfirmSwitchView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/ConfirmSwitchView.java
new file mode 100644
index 0000000..fc7c19a
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/ConfirmSwitchView.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2023/07/25 13:37:55
+ */
+import android.content.Context;
+import android.content.res.ColorStateList;
+import android.content.res.TypedArray;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.Switch;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class ConfirmSwitchView extends Switch {
+
+    public static final String TAG = "SwitchView";
+
+    Context mContext;
+
+    public ConfirmSwitchView(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public ConfirmSwitchView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    public ConfirmSwitchView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    public ConfirmSwitchView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        initView(context);
+    }
+
+	void initView(Context context) {
+		mContext = context;
+		TypedArray a = context.obtainStyledAttributes(new int[]{android.R.attr.textColorPrimary});
+		ColorStateList csl = a.getColorStateList(0);
+		if (csl != null) setTextColor(csl);
+		a.recycle();
+	}
+
+    @Override
+    public void setOnClickListener(final View.OnClickListener l) {
+        super.setOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View v) {
+                    final boolean isChecked = isChecked();
+                    StringBuilder sbMessage = new StringBuilder("请确定[");
+                    sbMessage.append(isChecked ?"开启": "关闭");
+                    sbMessage.append("]操作。");
+                    // 在这里添加您的点击事件响应逻辑
+                    YesNoAlertDialog.show(mContext, getText().toString(), sbMessage.toString(), new YesNoAlertDialog.OnDialogResultListener(){
+                            @Override
+                            public void onYes() {
+                                LogUtils.d(TAG, "onYes");
+                                setChecked(isChecked);
+                            }
+                            @Override
+                            public void onNo() {
+                                LogUtils.d(TAG, "onNo");
+                                setChecked(!isChecked);
+                            }
+                        });
+                    //Toast.makeText(getContext(), "Switch clicked", Toast.LENGTH_SHORT).show();
+                    // 确保调用了父类的onClick()方法
+                    l.onClick(v);
+                }
+            });
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/DateAgoTextView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/DateAgoTextView.java
new file mode 100644
index 0000000..e813885
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/DateAgoTextView.java
@@ -0,0 +1,32 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import androidx.appcompat.widget.AppCompatTextView;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+
+public class DateAgoTextView extends AppCompatTextView {
+    long mnDate;
+
+    public DateAgoTextView(Context context) {
+        super(context);
+    }
+
+    public DateAgoTextView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+    }
+
+    public DateAgoTextView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    public void setDate(long nDate) {
+        SimpleDateFormat dateFormat = new SimpleDateFormat(
+            "yyyy-MM-dd HH:mm:ss", Locale.getDefault());
+        Date d = new Date(nDate);
+
+        setText(dateFormat.format(d));
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/DraggableView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/DraggableView.java
new file mode 100644
index 0000000..61d87bf
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/DraggableView.java
@@ -0,0 +1,190 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.os.Build;
+import android.util.AttributeSet;
+import android.util.DisplayMetrics;
+import android.view.LayoutInflater;
+import android.view.MotionEvent;
+import android.view.ViewTreeObserver;
+import android.widget.FrameLayout;
+import cc.winboll.studio.mymessagemanager.R;
+
+public class DraggableView extends FrameLayout {
+    // SP配置常量（新增尺寸保存键）
+    private static final String SP_NAME = "TTS_FLOAT_DRAG_CONFIG";
+    private static final String KEY_LEFT = "drag_view_left";
+    private static final String KEY_TOP = "drag_view_top";
+    private static final String KEY_WIDTH = "drag_view_width"; // 新增：保存布局宽度
+    private static final String KEY_HEIGHT = "drag_view_height"; // 新增：保存布局高度
+
+    // 位置/尺寸变量
+    private int viewLeft;
+    private int viewTop;
+    private int viewWidth;
+    private int viewHeight;
+    private int screenWidth;
+    private int screenHeight;
+    // 拖动相关
+    private float downX;
+    private float downY;
+    private boolean isDragging = false;
+
+    // 构造方法
+    public DraggableView(Context context) {
+        super(context);
+        init();
+    }
+
+    public DraggableView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        init();
+    }
+
+    public DraggableView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        init();
+    }
+
+    private void init() {
+        LayoutInflater.from(getContext()).inflate(R.layout.view_tts_back, this, true);
+        DisplayMetrics metrics = getContext().getResources().getDisplayMetrics();
+        screenWidth = metrics.widthPixels;
+        screenHeight = metrics.heightPixels;
+
+        getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
+				@Override
+				public void onGlobalLayout() {
+					ViewTreeObserver currentVto = getViewTreeObserver();
+					if (currentVto.isAlive()) {
+						if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+							currentVto.removeOnGlobalLayoutListener(this);
+						} else {
+							currentVto.removeGlobalOnLayoutListener(this);
+						}
+					}
+					// 获取布局实际宽高
+					viewWidth = getMeasuredWidth();
+					viewHeight = getMeasuredHeight();
+					// 保存尺寸到SP（新增）
+					saveViewSize();
+					// 初始化位置
+					initPosition();
+					updateViewPosition();
+				}
+			});
+    }
+
+    // 初始化位置（不变）
+    private void initPosition() {
+        SharedPreferences sp = getContext().getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        int defaultLeft = screenWidth - viewWidth;
+        int defaultTop = screenHeight - viewHeight;
+        viewLeft = sp.getInt(KEY_LEFT, defaultLeft);
+        viewTop = sp.getInt(KEY_TOP, defaultTop);
+        checkBoundary();
+    }
+
+    // 新增：保存布局尺寸到SP
+    private void saveViewSize() {
+        if (viewWidth > 0 && viewHeight > 0) {
+            SharedPreferences sp = getContext().getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+            sp.edit()
+				.putInt(KEY_WIDTH, viewWidth)
+				.putInt(KEY_HEIGHT, viewHeight)
+				.apply();
+        }
+    }
+
+    // 新增：公共静态方法 - 查询最后保存的布局尺寸
+    public static int[] getLastViewSize(Context context) {
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        // 默认尺寸：120x120像素（与view_tts_back.xml示例尺寸一致，避免无值时异常）
+        int defaultWidth = dp2px(context, 120);
+        int defaultHeight = dp2px(context, 120);
+        // 从SP读取尺寸（无值则用默认）
+        int width = sp.getInt(KEY_WIDTH, defaultWidth);
+        int height = sp.getInt(KEY_HEIGHT, defaultHeight);
+        return new int[]{width, height};
+    }
+
+    // 新增：dp转px工具方法（确保默认尺寸适配不同屏幕）
+    private static int dp2px(Context context, float dpValue) {
+        final float scale = context.getResources().getDisplayMetrics().density;
+        return (int) (dpValue * scale + 0.5f);
+    }
+
+    // 原有方法（checkBoundary、updateViewPosition、savePosition、onTouchEvent、getLastPosition）保持不变
+    private void checkBoundary() {
+        viewLeft = Math.max(0, viewLeft);
+        viewTop = Math.max(0, viewTop);
+        viewLeft = Math.min(screenWidth - viewWidth, viewLeft);
+        viewTop = Math.min(screenHeight - viewHeight, viewTop);
+    }
+
+    private void updateViewPosition() {
+        LayoutParams params = (LayoutParams) getLayoutParams();
+        if (params != null) {
+            params.leftMargin = viewLeft;
+            params.topMargin = viewTop;
+            setLayoutParams(params);
+        }
+    }
+
+    private void savePosition() {
+        SharedPreferences sp = getContext().getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        sp.edit()
+			.putInt(KEY_LEFT, viewLeft)
+			.putInt(KEY_TOP, viewTop)
+			.apply();
+    }
+
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {
+        if (viewWidth == 0 || viewHeight == 0) return super.onTouchEvent(event);
+
+        float rawX = event.getRawX();
+        float rawY = event.getRawY();
+
+        switch (event.getAction()) {
+            case MotionEvent.ACTION_DOWN:
+                isDragging = true;
+                downX = rawX - viewLeft;
+                downY = rawY - viewTop;
+                break;
+
+            case MotionEvent.ACTION_MOVE:
+                if (isDragging) {
+                    viewLeft = (int) (rawX - downX);
+                    viewTop = (int) (rawY - downY);
+                    checkBoundary();
+                    updateViewPosition();
+                }
+                break;
+
+            case MotionEvent.ACTION_UP:
+                if (isDragging) {
+                    isDragging = false;
+                    savePosition();
+                }
+                break;
+        }
+        return true;
+    }
+
+    public static int[] getLastPosition(Context context) {
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        DisplayMetrics metrics = context.getResources().getDisplayMetrics();
+        int screenWidth = metrics.widthPixels;
+        int screenHeight = metrics.heightPixels;
+
+        int defaultLeft = 0;
+        int defaultTop = 0;
+
+        int left = sp.getInt(KEY_LEFT, defaultLeft);
+        int top = sp.getInt(KEY_TOP, defaultTop);
+        return new int[]{left, top};
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/PhoneListViewForScrollView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/PhoneListViewForScrollView.java
new file mode 100644
index 0000000..b7d5b43
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/PhoneListViewForScrollView.java
@@ -0,0 +1,65 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.ListView;
+
+public class PhoneListViewForScrollView extends ListView {
+
+    public PhoneListViewForScrollView(Context context) {
+        super(context);
+    }
+
+    public PhoneListViewForScrollView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+    }
+
+    public PhoneListViewForScrollView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    /**
+     * 重写onMeasure方法，重新计算高度，达到使ListView适应ScrollView的效果
+     *
+     * @param widthMeasureSpec  宽度测量规则
+     * @param heightMeasureSpec 高度测量规则
+     */
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        /*
+         // 子控件TextView不换行显示
+         ListAdapter listAdapter = this.getAdapter();  
+         if (listAdapter == null) { 
+         return; 
+         }
+         int maxWidth = 0;
+         for (int i = 0; i < listAdapter.getCount(); i++) { 
+         View listItem = listAdapter.getView(i, null, this);
+         View cb = listItem.findViewById(R.id.listviewfiledataCheckBox1);
+         View iv = listItem.findViewById(R.id.listviewfiledataImageView1);
+         View tv = listItem.findViewById(R.id.listviewfiledataTextView1);
+
+         cb.measure(0,0);
+         iv.measure(0,0);
+         tv.measure(0,0);
+
+         //listItem.measure(0, 0);
+         //int width = listItem.getMeasuredWidth();
+         int width = cb.getMeasuredWidth() + iv.getMeasuredWidth()+ tv.getMeasuredWidth();
+         if(width>maxWidth) maxWidth = width;
+         }
+         int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+         int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(maxWidth, MeasureSpec.AT_MOST);
+         super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
+         */
+
+        // 子控件TextView换行显示
+        //Integer.MAX_VALUE:表示int类型能够表示的最大值，值为2的31次方-1
+        //>>2:右移N位相当于除以2的N的幂
+        //MeasureSpec.AT_MOST：子布局可以根据自己的大小选择任意大小的模式
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        //int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(widthMeasureSpec, MeasureSpec.AT_MOST);
+
+        super.onMeasure(widthMeasureSpec, newHeightMeasureSpec);
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/ProtectModeTextView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/ProtectModeTextView.java
new file mode 100644
index 0000000..6e40ad8
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/ProtectModeTextView.java
@@ -0,0 +1,155 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.widget.LinearLayout;
+import android.widget.SeekBar;
+import android.widget.TextView;
+import cc.winboll.studio.mymessagemanager.R;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Random;
+
+/**
+ * 保护模式自定义控件
+ * 最终规则：
+ * 1. 刻度范围 0~12
+ * 2. 刻度值 = 每一组截取【相邻字符个数】
+ * 3. 从头到尾按固定长度切块分组
+ * 4. 所有分组收集后随机打乱再拼接输出
+ * 5. 刻度0 = 不打乱，显示原文
+ * 6. 按原生字符计算（包含空格、标点）
+ */
+public class ProtectModeTextView extends LinearLayout {
+
+    public interface OnScaleChangedListener {
+        void onScaleChanged(int progress);
+    }
+
+    private TextView tvContent;
+    private SeekBar seekBarScale;
+    private String originText;
+    private List<Character> charAllList;
+    private final Random random = new Random();
+    private OnScaleChangedListener mOnScaleChangedListener;
+
+    public ProtectModeTextView(Context context) {
+        super(context);
+        initView(context);
+    }
+
+    public ProtectModeTextView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView(context);
+    }
+
+    public ProtectModeTextView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initView(context);
+    }
+
+    private void initView(Context context) {
+        LayoutInflater.from(context).inflate(R.layout.layout_protect_mode_textview, this, true);
+        tvContent = findViewById(R.id.tv_content);
+        seekBarScale = findViewById(R.id.seek_bar_scale);
+
+        // 刻度 0 ~ 12
+        seekBarScale.setMax(12);
+        seekBarScale.setProgress(0);
+
+        charAllList = new ArrayList<>();
+
+        seekBarScale.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
+				@Override
+				public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
+					handleTextLogic(progress);
+					if (fromUser && mOnScaleChangedListener != null) {
+						mOnScaleChangedListener.onScaleChanged(progress);
+					}
+				}
+
+				@Override
+				public void onStartTrackingTouch(SeekBar seekBar) {}
+				@Override
+				public void onStopTrackingTouch(SeekBar seekBar) {}
+			});
+    }
+
+    public void setOnScaleChangedListener(OnScaleChangedListener listener) {
+        mOnScaleChangedListener = listener;
+    }
+
+    public void setContentTextWithScale(String text, int scaleProgress) {
+        this.originText = text;
+        convertToCharList(text);
+        seekBarScale.setProgress(scaleProgress);
+        handleTextLogic(scaleProgress);
+    }
+
+    public void setContentText(String text) {
+        this.originText = text;
+        convertToCharList(text);
+        handleTextLogic(seekBarScale.getProgress());
+    }
+
+    private void convertToCharList(String text) {
+        charAllList.clear();
+        if (text == null || text.isEmpty()) {
+            return;
+        }
+        char[] chars = text.toCharArray();
+        for (char c : chars) {
+            charAllList.add(c);
+        }
+    }
+
+    private void handleTextLogic(int groupSize) {
+        if (charAllList.isEmpty()) {
+            tvContent.setText(originText);
+            return;
+        }
+
+        // 刻度0 原样不打乱
+        if (groupSize <= 0) {
+            tvContent.setText(originText);
+            return;
+        }
+
+        List<String> groupList = new ArrayList<>();
+        int totalLen = charAllList.size();
+
+        // 从头到尾 按 groupSize 个相邻字符切块
+        int index = 0;
+        while (index < totalLen) {
+            StringBuilder sb = new StringBuilder();
+            // 每一组取 groupSize 个相邻字符
+            for (int i = 0; i < groupSize && index < totalLen; i++) {
+                sb.append(charAllList.get(index));
+                index++;
+            }
+            groupList.add(sb.toString());
+        }
+
+        // 所有分组随机打乱
+        Collections.shuffle(groupList, random);
+
+        // 拼接输出
+        StringBuilder result = new StringBuilder();
+        for (String item : groupList) {
+            result.append(item);
+        }
+
+        tvContent.setText(result.toString());
+    }
+
+    public String getOriginText() {
+        return originText;
+    }
+
+    public void resetSeekBar() {
+        seekBarScale.setProgress(0);
+    }
+}
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSAcceptRuleListViewForScrollView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSAcceptRuleListViewForScrollView.java
new file mode 100644
index 0000000..d60d8f6
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSAcceptRuleListViewForScrollView.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.ListView;
+
+public class SMSAcceptRuleListViewForScrollView extends ListView {
+
+    public SMSAcceptRuleListViewForScrollView(Context context) {
+        super(context);
+    }
+
+    public SMSAcceptRuleListViewForScrollView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+    }
+
+    public SMSAcceptRuleListViewForScrollView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    /**
+     * 重写onMeasure方法，重新计算高度，达到使ListView适应ScrollView的效果
+     *
+     * @param widthMeasureSpec  宽度测量规则
+     * @param heightMeasureSpec 高度测量规则
+     */
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        super.onMeasure(widthMeasureSpec, newHeightMeasureSpec);
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSListViewForScrollView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSListViewForScrollView.java
new file mode 100644
index 0000000..296882e
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSListViewForScrollView.java
@@ -0,0 +1,73 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.ListView;
+
+public class SMSListViewForScrollView extends ListView {
+    static int nMaxWidth = 0;
+
+    public SMSListViewForScrollView(Context context) {
+        super(context);
+    }
+
+    public SMSListViewForScrollView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+
+    }
+
+    public SMSListViewForScrollView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    /**
+     * 重写onMeasure方法，重新计算高度，达到使ListView适应ScrollView的效果
+     *
+     * @param widthMeasureSpec  宽度测量规则
+     * @param heightMeasureSpec 高度测量规则
+     */
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+
+        /*
+         // 子控件TextView不换行显示
+         ListAdapter listAdapter = this.getAdapter();  
+         if (listAdapter == null) { 
+         return; 
+         }
+         int maxWidth = 0;
+         for (int i = 0; i < listAdapter.getCount(); i++) { 
+         View listItem = listAdapter.getView(i, null, this);
+         View cb = listItem.findViewById(R.id.listviewfiledataCheckBox1);
+         View iv = listItem.findViewById(R.id.listviewfiledataImageView1);
+         View tv = listItem.findViewById(R.id.listviewfiledataTextView1);
+
+         cb.measure(0,0);
+         iv.measure(0,0);
+         tv.measure(0,0);
+
+         //listItem.measure(0, 0);
+         //int width = listItem.getMeasuredWidth();
+         int width = cb.getMeasuredWidth() + iv.getMeasuredWidth()+ tv.getMeasuredWidth();
+         if(width>maxWidth) maxWidth = width;
+         }
+         int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+         int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(maxWidth, MeasureSpec.AT_MOST);
+         super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
+         */
+
+        // 子控件TextView换行显示
+        //Integer.MAX_VALUE:表示int类型能够表示的最大值，值为2的31次方-1
+        //>>2:右移N位相当于除以2的N的幂
+        //MeasureSpec.AT_MOST：子布局可以根据自己的大小选择任意大小的模式
+
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+
+        //int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(widthMeasureSpec, MeasureSpec.AT_MOST);
+
+        //int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(heightMeasureSpec, MeasureSpec.AT_MOST);
+
+        super.onMeasure(widthMeasureSpec, newHeightMeasureSpec);
+    }
+
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSView.java
new file mode 100644
index 0000000..9ce0bbe
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/SMSView.java
@@ -0,0 +1,78 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.Canvas;
+import android.util.AttributeSet;
+import androidx.cardview.widget.CardView;
+import cc.winboll.studio.mymessagemanager.R;
+
+public class SMSView extends CardView {
+
+    public static final String TAG = "SMSView";
+
+    Context mContext;
+    int colorInbox;
+    int colorSend;
+    int colorItem;
+    public enum SMSType { INBOX, SEND }
+    SMSType mSMSType = SMSType.INBOX;
+
+    public void setSMSType(SMSType smsType) {
+        this.mSMSType = smsType;
+        updateViewBackgroundColor();
+    }
+
+    public SMSType getCardType() {
+        return mSMSType;
+    }
+
+    void updateViewBackgroundColor() {
+        if (mSMSType == SMSType.INBOX) {
+            setCardBackgroundColor(colorInbox);
+        } else if (mSMSType == SMSType.SEND) {
+            setCardBackgroundColor(colorSend);
+        }
+    }
+
+    public SMSView(Context context) {
+        super(context);
+        mContext = context;
+    }
+
+    public SMSView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        mContext = context;
+
+        TypedArray a = mContext.obtainStyledAttributes(attrs, R.styleable.SMSView, 0, 0);
+        String szSMSType = a.getString(R.styleable.SMSView_attrSMSType);
+        if((szSMSType == null)||szSMSType.equals("")) {
+            mSMSType = SMSType.SEND;
+        } else {
+            mSMSType = SMSType.valueOf(szSMSType);
+        }
+        colorInbox = a.getColor(R.styleable.SMSView_attrSMSViewInboxColor, 0);
+        colorSend = a.getColor(R.styleable.SMSView_attrSMSViewSendColor, 0);
+        a.recycle();
+    }
+
+    public SMSView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        mContext = context;
+    }
+
+    @Override
+    protected void onDraw(Canvas canvas) {
+        super.onDraw(canvas);
+    }
+
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        // 子控件TextView换行显示
+        //Integer.MAX_VALUE:表示int类型能够表示的最大值，值为2的31次方-1
+        //>>2:右移N位相当于除以2的N的幂
+        //MeasureSpec.AT_MOST：子布局可以根据自己的大小选择任意大小的模式
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        super.onMeasure(widthMeasureSpec, newHeightMeasureSpec);
+    }
+}
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/TTSRuleListViewForScrollView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/TTSRuleListViewForScrollView.java
new file mode 100644
index 0000000..be676cb
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/TTSRuleListViewForScrollView.java
@@ -0,0 +1,82 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.ListView;
+
+public class TTSRuleListViewForScrollView extends ListView {
+    static int nMaxWidth = 0;
+
+    public TTSRuleListViewForScrollView(Context context) {
+        super(context);
+    }
+
+    public TTSRuleListViewForScrollView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+
+    }
+
+    public TTSRuleListViewForScrollView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    @Override
+    public void setSelection(int position) {
+        super.setSelection(position);
+    }
+
+    /**
+     * 重写onMeasure方法，重新计算高度，达到使ListView适应ScrollView的效果
+     *
+     * @param widthMeasureSpec  宽度测量规则
+     * @param heightMeasureSpec 高度测量规则
+     */
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+
+        /*
+         // 子控件TextView不换行显示
+         ListAdapter listAdapter = this.getAdapter();  
+         if (listAdapter == null) { 
+         return; 
+         }
+         int maxWidth = 0;
+         for (int i = 0; i < listAdapter.getCount(); i++) { 
+         View listItem = listAdapter.getView(i, null, this);
+         View cb = listItem.findViewById(R.id.listviewfiledataCheckBox1);
+         View iv = listItem.findViewById(R.id.listviewfiledataImageView1);
+         View tv = listItem.findViewById(R.id.listviewfiledataTextView1);
+
+         cb.measure(0,0);
+         iv.measure(0,0);
+         tv.measure(0,0);
+
+         //listItem.measure(0, 0);
+         //int width = listItem.getMeasuredWidth();
+         int width = cb.getMeasuredWidth() + iv.getMeasuredWidth()+ tv.getMeasuredWidth();
+         if(width>maxWidth) maxWidth = width;
+         }
+         int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+         int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(maxWidth, MeasureSpec.AT_MOST);
+         super.onMeasure(newWidthMeasureSpec, newHeightMeasureSpec);
+         */
+
+        // 子控件TextView换行显示
+        //Integer.MAX_VALUE:表示int类型能够表示的最大值，值为2的31次方-1
+        //>>2:右移N位相当于除以2的N的幂
+        //MeasureSpec.AT_MOST：子布局可以根据自己的大小选择任意大小的模式
+
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+
+        //int newWidthMeasureSpec = MeasureSpec.makeMeasureSpec(widthMeasureSpec, MeasureSpec.AT_MOST);
+
+        //int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(heightMeasureSpec, MeasureSpec.AT_MOST);
+
+        super.onMeasure(widthMeasureSpec, newHeightMeasureSpec);
+    }
+
+}
+    
+    
+    
+
diff --git a/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/TTSRuleView.java b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/TTSRuleView.java
new file mode 100644
index 0000000..73ed2a3
--- /dev/null
+++ b/mymessagemanager/src/main/java/cc/winboll/studio/mymessagemanager/views/TTSRuleView.java
@@ -0,0 +1,48 @@
+package cc.winboll.studio.mymessagemanager.views;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2023/07/24 15:08:31
+ * @Describe TTS语音规则视图
+ */
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.util.AttributeSet;
+import androidx.cardview.widget.CardView;
+import cc.winboll.studio.mymessagemanager.R;
+
+public class TTSRuleView extends CardView {
+    
+    public static final String TAG = "TTSRuleView";
+    
+    Context mContext;
+
+    public TTSRuleView(Context context) {
+        super(context);
+        mContext = context;
+    }
+
+    public TTSRuleView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        mContext = context;
+        TypedArray a = mContext.obtainStyledAttributes(attrs, R.styleable.TTSRuleView, 0, 0);
+        int colorBackground = a.getColor(R.styleable.TTSRuleView_attrTTSRuleViewBackgroundColor, 0);
+        a.recycle();
+        setCardBackgroundColor(colorBackground);
+    }
+
+    public TTSRuleView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        mContext = context;
+    }
+
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        //Integer.MAX_VALUE:表示int类型能够表示的最大值，值为2的31次方-1
+        //>>2:右移N位相当于除以2的N的幂
+        //MeasureSpec.AT_MOST：子布局可以根据自己的大小选择任意大小的模式
+        int newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(Integer.MAX_VALUE >> 2, MeasureSpec.AT_MOST);
+        super.onMeasure(widthMeasureSpec, newHeightMeasureSpec);
+    }
+    
+}
diff --git a/mymessagemanager/src/main/res/anim/slow_fade_in.xml b/mymessagemanager/src/main/res/anim/slow_fade_in.xml
new file mode 100644
index 0000000..fa73170
--- /dev/null
+++ b/mymessagemanager/src/main/res/anim/slow_fade_in.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<set xmlns:android="http://schemas.android.com/apk/res/android">
+    <alpha
+        android:fromAlpha="0.0"
+        android:toAlpha="1.0"
+        android:duration="5000" /> <!-- 持续2秒 -->
+</set>
diff --git a/mymessagemanager/src/main/res/drawable-night/bg_frame.xml b/mymessagemanager/src/main/res/drawable-night/bg_frame.xml
new file mode 100644
index 0000000..bf2fe54
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable-night/bg_frame.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#00000000" 
+                android:startColor="#1AFFFFFF" /> 
+            <stroke 
+                android:width="1dp" 
+                android:color="#FF666666" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/mymessagemanager/src/main/res/drawable/bg_container_border.xml b/mymessagemanager/src/main/res/drawable/bg_container_border.xml
new file mode 100644
index 0000000..09c5bdf
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/bg_container_border.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@android:color/transparent" />
+    <stroke android:width="1dp" android:color="#FFB0B0B0" />
+    <corners android:radius="?attr/borderCornerRadius" />
+</shape>
diff --git a/mymessagemanager/src/main/res/drawable/bg_frame.xml b/mymessagemanager/src/main/res/drawable/bg_frame.xml
new file mode 100644
index 0000000..2f208a6
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/bg_frame.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0FFFFFFF" 
+                android:startColor="#FFFFFFFF" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/mymessagemanager/src/main/res/drawable/bg_frame_black.xml b/mymessagemanager/src/main/res/drawable/bg_frame_black.xml
new file mode 100644
index 0000000..d28eb1b
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/bg_frame_black.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#AF000000" 
+                android:startColor="#AF000000" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/mymessagemanager/src/main/res/drawable/bg_frame_white.xml b/mymessagemanager/src/main/res/drawable/bg_frame_white.xml
new file mode 100644
index 0000000..4b78840
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/bg_frame_white.xml
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0FFFFFFF" 
+                android:startColor="#0FFFFFFF" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#CFFFFFFF" 
+                android:startColor="#CFFFFFFF" /> 
+            <corners android:radius="?attr/borderCornerRadius" />
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/mymessagemanager/src/main/res/drawable/cursor_pointer.xml b/mymessagemanager/src/main/res/drawable/cursor_pointer.xml
new file mode 100644
index 0000000..e828063
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/cursor_pointer.xml
@@ -0,0 +1,20 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="48dp"
+    android:height="48dp"
+    android:viewportWidth="48"
+    android:viewportHeight="48">
+    <path
+        android:fillColor="#00FFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M24.17 5.23C34.61 5.23 43.16 13.78 43.16 24.22 43.16 34.66 34.61 43.2 24.17 43.2 13.73 43.2 5.18 34.66 5.18 24.22 5.18 13.78 13.73 5.23 24.17 5.23"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M25.8 20.4C25.8 20.4 26.6 20.6 26.6 20.6 26.6 20.6 31.92 23.77 31.92 23.77 32.81 24.12 33.39 25.17 33.32 26.3 33.32 26.3 33.32 26.5 33.32 26.5 33.32 26.5 33.32 26.7 33.32 26.7 33.32 26.7 32.17 36.04 32.17 36.04 32.09 36.69 31.85 37.3 31.41 37.73 31.01 38.19 30.49 38.42 29.94 38.42 29.94 38.42 21.18 38.42 21.18 38.42 20.55 38.42 19.98 38.14 19.56 37.61 19.56 37.61 11.93 28.5 11.93 28.5 11.93 28.5 13.07 26.97 13.07 26.97 13.38 26.59 13.86 26.38 14.32 26.41 14.32 26.41 14.69 26.41 14.69 26.41 14.69 26.41 19.75 27.74 19.75 27.74 19.75 27.74 19.75 11.72 19.75 11.72 19.75 10.03 20.89 8.66 22.3 8.66 23.7 8.66 24.85 10.03 24.85 11.72 24.85 11.72 24.85 20.4 24.85 20.4 24.85 20.4 25.8 20.4 25.8 20.4 25.8 20.4 25.8 20.4 25.8 20.4"/>
+</vector>
diff --git a/mymessagemanager/src/main/res/drawable/ic_launcher.xml b/mymessagemanager/src/main/res/drawable/ic_launcher.xml
new file mode 100644
index 0000000..d4d1eaf
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/ic_launcher.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="15dp" 
+        android:top="15dp" 
+        android:right="15dp" 
+        android:bottom="15dp"
+        android:drawable="@drawable/ic_launcher_foreground"/>
+</layer-list>
diff --git a/mymessagemanager/src/main/res/drawable/ic_launcher_background.xml b/mymessagemanager/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..a4f78de
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#3DDC84"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/mymessagemanager/src/main/res/drawable/ic_launcher_background_golden.xml b/mymessagemanager/src/main/res/drawable/ic_launcher_background_golden.xml
new file mode 100644
index 0000000..804236c
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/ic_launcher_background_golden.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#FFDCD93D"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/mymessagemanager/src/main/res/drawable/ic_launcher_background_sky.xml b/mymessagemanager/src/main/res/drawable/ic_launcher_background_sky.xml
new file mode 100644
index 0000000..1ff84d4
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/ic_launcher_background_sky.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#FF3DC9DC"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/mymessagemanager/src/main/res/drawable/ic_launcher_foreground.xml b/mymessagemanager/src/main/res/drawable/ic_launcher_foreground.xml
new file mode 100644
index 0000000..872b04e
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/ic_launcher_foreground.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M16.61,15.15C16.15,15.15 15.77,14.78 15.77,14.32S16.15,13.5 16.61,13.5H16.61C17.07,13.5 17.45,13.86 17.45,14.32C17.45,14.78 17.07,15.15 16.61,15.15M7.41,15.15C6.95,15.15 6.57,14.78 6.57,14.32C6.57,13.86 6.95,13.5 7.41,13.5H7.41C7.87,13.5 8.24,13.86 8.24,14.32C8.24,14.78 7.87,15.15 7.41,15.15M16.91,10.14L18.58,7.26C18.67,7.09 18.61,6.88 18.45,6.79C18.28,6.69 18.07,6.75 18,6.92L16.29,9.83C14.95,9.22 13.5,8.9 12,8.91C10.47,8.91 9,9.24 7.73,9.82L6.04,6.91C5.95,6.74 5.74,6.68 5.57,6.78C5.4,6.87 5.35,7.08 5.44,7.25L7.1,10.13C4.25,11.69 2.29,14.58 2,18H22C21.72,14.59 19.77,11.7 16.91,10.14H16.91Z"/>
+</vector>
diff --git a/mymessagemanager/src/main/res/drawable/ic_message.xml b/mymessagemanager/src/main/res/drawable/ic_message.xml
new file mode 100644
index 0000000..70f1497
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/ic_message.xml
@@ -0,0 +1,20 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="48dp"
+    android:height="48dp"
+    android:viewportWidth="48"
+    android:viewportHeight="48">
+    <path
+        android:fillColor="#00FFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M13.46 15.9C13.46 15.9 40.54 15.9 35.12 15.9 40.54 15.9 40.54 15.9 40.54 19.5 40.54 19.5 40.54 33.87 40.54 33.87 40.54 37.46 40.54 37.46 35.12 37.46 35.12 37.46 13.46 37.46 13.46 37.46 8.05 37.46 8.05 37.46 8.05 33.87 8.05 33.87 8.05 19.5 8.05 19.5 8.05 15.9 8.05 15.9 13.46 15.9"/>
+    <path
+        android:fillColor="#00FFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M8.86 16.79C11.42 20.07 15.03 25.47 24.19 25.57 33.46 25.67 37.88 18.2 39.86 16.42"/>
+</vector>
diff --git a/mymessagemanager/src/main/res/drawable/listview_item_selector.xml b/mymessagemanager/src/main/res/drawable/listview_item_selector.xml
new file mode 100644
index 0000000..8fcab31
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/listview_item_selector.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 选中状态：深灰色背景（可根据需求调整颜色） -->
+    <item android:state_selected="true" android:drawable="@color/list_item_selected"/>
+    <!-- 按压状态：浅灰色背景 -->
+    <item android:state_pressed="true" android:drawable="@color/list_item_pressed"/>
+    <!-- 默认状态：透明背景 -->
+    <item android:drawable="@android:color/transparent"/>
+</selector>
diff --git a/mymessagemanager/src/main/res/drawable/shape_gradient.xml b/mymessagemanager/src/main/res/drawable/shape_gradient.xml
new file mode 100644
index 0000000..c164fe9
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/shape_gradient.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android">
+    <gradient
+        android:angle="180"
+        android:endColor="#FFFFFFFF"
+        android:startColor="#FFFFFFFF"
+        android:type="linear" />
+
+    <corners android:radius="10dp" />
+</shape>
diff --git a/mymessagemanager/src/main/res/drawable/speaker.xml b/mymessagemanager/src/main/res/drawable/speaker.xml
new file mode 100644
index 0000000..53e00c1
--- /dev/null
+++ b/mymessagemanager/src/main/res/drawable/speaker.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M14,3.23V5.29C16.89,6.15 19,8.83 19,12C19,15.17 16.89,17.84 14,18.7V20.77C18,19.86 21,16.28 21,12C21,7.72 18,4.14 14,3.23M16.5,12C16.5,10.23 15.5,8.71 14,7.97V16C15.5,15.29 16.5,13.76 16.5,12M3,9V15H7L12,20V4L7,9H3Z"/>
+
+</vector>
diff --git a/mymessagemanager/src/main/res/layout/activity_about.xml b/mymessagemanager/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..2638726
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_about.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:orientation="vertical">
+
+		<cc.winboll.studio.libaes.views.ASupportToolbar
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:id="@+id/toolbar"/>
+
+		<cc.winboll.studio.libappbase.views.AboutView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/aboutview"/>
+
+	</LinearLayout>
+
+</FrameLayout>
diff --git a/mymessagemanager/src/main/res/layout/activity_appsettings.xml b/mymessagemanager/src/main/res/layout/activity_appsettings.xml
new file mode 100644
index 0000000..93f929b
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_appsettings.xml
@@ -0,0 +1,422 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.AToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activityappsettingsAToolbar1"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:padding="4dp" android:background="@drawable/bg_container_border">
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:spacing="12dp" android:background="@drawable/bg_container_border">
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:background="@drawable/bg_frame"
+				android:padding="12dp"
+				android:layout_marginBottom="8dp">
+
+				<TextView
+					android:textAppearance="?android:attr/textAppearanceLarge"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="用户视觉系统保护模式设置："
+					android:paddingLeft="5dp"
+					android:layout_marginBottom="8dp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#999999"
+					android:layout_marginBottom="8dp"/>
+
+				<cc.winboll.studio.mymessagemanager.views.ConfirmSwitchView
+					android:layout_width="match_parent"
+					android:layout_height="48dp"
+					android:text="回收站短信保护式预览开关："
+					android:paddingLeft="5dp"
+					android:textSize="13sp"
+					android:id="@+id/activityappsettingsSwitch3"
+					android:gravity="center_vertical"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#BBBBBB"
+					android:layout_marginVertical="8dp"/>
+
+				<LinearLayout
+					android:orientation="horizontal"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:gravity="center_vertical"
+					android:layout_marginLeft="5dp" android:background="@drawable/bg_container_border">
+
+					<TextView
+						android:layout_width="0dp"
+						android:layout_height="wrap_content"
+						android:text="拒绝显示的字符集:"
+						android:layout_weight="1.0"
+						android:textSize="12sp"/>
+
+					<Button
+						android:layout_width="wrap_content"
+						android:layout_height="40dp"
+						android:text="点击编辑"
+						android:onClick="onCharsetRefuseEditDialog"
+						android:paddingHorizontal="16dp"
+						android:textSize="13sp"/>
+
+				</LinearLayout>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#BBBBBB"
+					android:layout_marginVertical="8dp"/>
+
+				<LinearLayout
+					android:orientation="horizontal"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:gravity="center_vertical"
+					android:layout_marginLeft="5dp"
+					android:layout_marginRight="5dp" android:background="@drawable/bg_container_border">
+
+					<TextView
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content"
+						android:text="替代字符:"
+						android:textSize="12sp"
+						android:layout_marginRight="8dp"/>
+
+					<EditText
+						android:layout_width="0dp"
+						android:ems="10"
+						android:layout_height="40dp"
+						android:id="@+id/activityappsettingsEditText4"
+						android:layout_weight="1.0"
+						android:paddingHorizontal="8dp"
+						android:background="@android:drawable/edit_text"
+						android:textSize="13sp"/>
+
+				</LinearLayout>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:background="@drawable/bg_frame"
+				android:padding="12dp"
+				android:layout_marginBottom="8dp">
+
+				<TextView
+					android:textAppearance="?android:attr/textAppearanceLarge"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="回收站模式设置："
+					android:paddingLeft="5dp"
+					android:layout_marginBottom="8dp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#999999"
+					android:layout_marginBottom="8dp"/>
+
+				<RadioGroup
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:id="@+id/activityappsettingsRadioGroup1"
+					android:paddingLeft="5dp">
+
+					<RadioButton
+						android:layout_width="match_parent"
+						android:layout_height="48dp"
+						android:text="简洁模式（SMSRecycleActivity）"
+						android:id="@+id/activityappsettingsRadioButton1"
+						android:gravity="center_vertical"
+						android:textSize="14sp"
+						android:textColor="?android:attr/textColorPrimary"/>
+
+					<RadioButton
+						android:layout_width="match_parent"
+						android:layout_height="48dp"
+						android:text="自由模式（SMSRecycle2Activity）"
+						android:id="@+id/activityappsettingsRadioButton2"
+						android:gravity="center_vertical"
+						android:textSize="14sp"
+						android:textColor="?android:attr/textColorPrimary"/>
+
+				</RadioGroup>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:background="@drawable/bg_frame"
+				android:padding="12dp"
+				android:layout_marginBottom="8dp">
+
+				<TextView
+					android:textAppearance="?android:attr/textAppearanceLarge"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="短信号码国家代码合并设置："
+					android:paddingLeft="5dp"
+					android:layout_marginBottom="8dp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#999999"
+					android:layout_marginBottom="8dp"/>
+
+				<TextView
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="如+8612345678901与12345678901合并为12345678901."
+					android:textSize="12sp"
+					android:paddingLeft="5dp"
+					android:layout_marginBottom="10dp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#BBBBBB"
+					android:layout_marginBottom="8dp"/>
+
+				<LinearLayout
+					android:orientation="horizontal"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:gravity="center_vertical"
+					android:layout_marginLeft="5dp" android:background="@drawable/bg_container_border">
+
+					<TextView
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content"
+						android:text="当前国家代码为：+"
+						android:textSize="12sp"
+						android:layout_weight="1.0"/>
+
+					<EditText
+						android:layout_width="80dp"
+						android:ems="10"
+						android:layout_height="40dp"
+						android:inputType="number"
+						android:id="@+id/activityappsettingsEditText2"
+						android:paddingHorizontal="8dp"
+						android:background="@android:drawable/edit_text"
+						android:layout_marginHorizontal="8dp"
+						android:textSize="13sp"/>
+
+					<cc.winboll.studio.mymessagemanager.views.ConfirmSwitchView
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content"
+						android:id="@+id/activityappsettingsSwitch1"/>
+
+				</LinearLayout>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:background="@drawable/bg_frame"
+				android:padding="12dp"
+				android:layout_marginBottom="8dp">
+
+				<TextView
+					android:textAppearance="?android:attr/textAppearanceLarge"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="TTS 语音设置："
+					android:paddingLeft="5dp"
+					android:layout_marginBottom="8dp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#999999"
+					android:layout_marginBottom="8dp"/>
+
+				<LinearLayout
+					android:orientation="horizontal"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:gravity="center_vertical"
+					android:layout_marginLeft="5dp"
+					android:layout_marginRight="5dp" android:background="@drawable/bg_container_border">
+
+					<TextView
+						android:layout_width="0dp"
+						android:layout_height="wrap_content"
+						android:text="@string/text_ttsplaydelaytimes"
+						android:layout_weight="1.0"
+						android:textSize="12sp"
+						android:paddingLeft="5dp"/>
+
+					<EditText
+						android:layout_width="50dp"
+						android:inputType="number"
+						android:layout_height="40dp"
+						android:ems="10"
+						android:id="@+id/activityappsettingsEditText1"
+						android:paddingHorizontal="8dp"
+						android:background="@android:drawable/edit_text"
+						android:gravity="center"
+						android:textSize="13sp"/>
+
+				</LinearLayout>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#BBBBBB"
+					android:layout_marginVertical="8dp"/>
+
+				<LinearLayout
+					android:orientation="horizontal"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:gravity="right"
+					android:layout_marginTop="10dp" android:background="@drawable/bg_container_border">
+
+					<Button
+						android:layout_width="wrap_content"
+						android:layout_height="40dp"
+						android:text="设置TTS悬浮窗口位置"
+						android:onClick="onTTSFloatSettingsActivity"
+						android:paddingHorizontal="16dp"
+						android:textSize="13sp"/>
+
+				</LinearLayout>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:background="@drawable/bg_frame"
+				android:padding="12dp"
+				android:layout_marginBottom="8dp"
+				android:gravity="right">
+
+				<TextView
+					android:textAppearance="?android:attr/textAppearanceLarge"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:text="应用权限设置 ："
+					android:paddingLeft="5dp"
+					android:layout_marginBottom="8dp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#999999"
+					android:layout_marginBottom="8dp"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="40dp"
+					android:text="打开系统默认应用设置"
+					android:onClick="onOpenSystemDefaultAppSettings"
+					android:paddingHorizontal="16dp"
+					android:textSize="13sp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#BBBBBB"
+					android:layout_marginVertical="8dp"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="40dp"
+					android:text="检查应用权限"
+					android:onClick="onCheckAndGetAppPermission"
+					android:paddingHorizontal="16dp"
+					android:textSize="13sp"/>
+
+				<View
+					android:layout_width="match_parent"
+					android:layout_height="2dp"
+					android:background="#BBBBBB"
+					android:layout_marginVertical="8dp"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="40dp"
+					android:text="安装TTS语音支持"
+					android:onClick="onAddTTSSupport"
+					android:paddingHorizontal="16dp"
+					android:textSize="13sp"/>
+
+			</LinearLayout>
+
+			<cc.winboll.studio.libaes.views.ADsControlView
+				android:id="@+id/ads_control_view"
+				android:background="@drawable/bg_frame"
+				android:padding="10dp"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_marginBottom="8dp"/>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="@drawable/bg_frame"
+		android:padding="10dp"
+		android:layout_marginTop="8dp">
+
+		<cc.winboll.studio.libaes.views.AOHPCTCSeekBar
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:id="@+id/activityappsettingsAOHPCTCSeekBar1"
+			android:layout_marginBottom="8dp"/>
+
+		<View
+			android:layout_width="match_parent"
+			android:layout_height="2dp"
+			android:background="#BBBBBB"
+			android:layout_marginBottom="8dp"/>
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center"
+			android:textSize="15sp"
+			android:id="@+id/activityappsettingsTextView1"
+			android:text="@string/msg_100applysettings"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_composesms.xml b/mymessagemanager/src/main/res/layout/activity_composesms.xml
new file mode 100644
index 0000000..3f269f6
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_composesms.xml
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+    <cc.winboll.studio.libaes.views.AToolbar
+        android:layout_width="match_parent"
+        android:layout_height="@dimen/toolbar_height"
+        android:id="@+id/activitycomposesmsASupportToolbar1"/>
+
+    <LinearLayout
+        android:orientation="horizontal"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:background="@drawable/bg_frame">
+
+        <RelativeLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:id="@+id/activitycomposesmsRelativeLayout1" android:background="@drawable/bg_container_border">
+
+            <LinearLayout
+                android:orientation="horizontal"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:id="@+id/activitycomposesmsLinearLayout1"
+                android:gravity="center_vertical"
+                android:layout_alignParentRight="true"
+                android:layout_marginRight="10dp"
+                android:layout_marginLeft="10dp"
+                android:layout_alignParentLeft="true" android:background="@drawable/bg_container_border">
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="(拼音搜索):"/>
+
+                <EditText
+                    android:layout_width="80dp"
+                    android:ems="10"
+                    android:layout_height="wrap_content"
+                    android:id="@+id/activitycomposesmsEditText2"/>
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_alignParentTop="true"
+                    android:layout_toRightOf="@id/activitycomposesmsEditText2"
+                    android:id="@+id/activitycomposesmsTextView2"
+                    android:layout_weight="1.0"/>
+
+            </LinearLayout>
+
+            <LinearLayout
+                android:orientation="horizontal"
+                android:layout_below="@id/activitycomposesmsLinearLayout1"
+                android:layout_alignParentRight="true"
+                android:layout_marginRight="10dp"
+                android:layout_marginLeft="10dp"
+                android:layout_alignParentLeft="true"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:gravity="center_vertical" android:background="@drawable/bg_container_border">
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="(SMS TO) :"
+                    android:id="@+id/activitycomposesmsTextView1"/>
+
+                <EditText
+                    android:layout_width="wrap_content"
+                    android:inputType="phone"
+                    android:layout_height="wrap_content"
+                    android:ems="10"
+                    android:id="@+id/activitycomposesmsEditText1"/>
+
+            </LinearLayout>
+
+        </RelativeLayout>
+
+    </LinearLayout>
+
+    <RelativeLayout
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:padding="10dp"
+        android:layout_weight="1.0" android:background="@drawable/bg_container_border">
+
+        <!-- 关键修改：添加 listSelector 属性，关联选中样式 -->
+        <ListView
+            android:layout_alignParentTop="true"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_above="@+id/activitycomposesmsinclude1"
+            android:id="@+id/activitycomposesmsListView1"
+            android:listSelector="@drawable/listview_item_selector"
+            android:choiceMode="singleChoice"/> <!-- 开启单选模式，确保选中状态唯一 -->
+
+        <include
+            layout="@layout/view_smssend"
+            android:layout_alignParentBottom="true"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:id="@+id/activitycomposesmsinclude1"/>
+
+    </RelativeLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_main.xml b/mymessagemanager/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..75bf771
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_main.xml
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activitymainASupportToolbar1"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+		<cc.winboll.studio.mymessagemanager.views.ConfirmSwitchView
+			android:layout_width="match_parent"
+			android:layout_height="60dp"
+			android:padding="10dp"
+			android:text="@string/text_mainservice"
+			android:id="@+id/activitymainSwitchView1"/>
+
+		<cc.winboll.studio.mymessagemanager.views.ConfirmSwitchView
+			android:layout_width="match_parent"
+			android:layout_height="60dp"
+			android:padding="10dp"
+			android:text="@string/text_norulesreceivecontacts"
+			android:id="@+id/activitymainSwitchView2"/>
+
+		<cc.winboll.studio.mymessagemanager.views.ConfirmSwitchView
+			android:layout_width="match_parent"
+			android:layout_height="60dp"
+			android:padding="10dp"
+			android:text="@string/text_usingtts"
+			android:id="@+id/activitymainSwitchView3"/>
+
+		<cc.winboll.studio.mymessagemanager.views.ConfirmSwitchView
+			android:layout_width="match_parent"
+			android:layout_height="60dp"
+			android:padding="10dp"
+			android:text="@string/text_usingttsrule"
+			android:id="@+id/activitymainSwitchView4"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:id="@+id/activitymainButton1"
+			android:text="@string/text_sendsms"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0" android:background="@drawable/bg_container_border">
+
+		<com.baoyz.widget.PullRefreshLayout
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/activitymainPullRefreshLayout1">
+
+			<ScrollView
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:id="@+id/activitymainScrollView1" android:background="@drawable/bg_container_border">
+
+				<cc.winboll.studio.mymessagemanager.views.PhoneListViewForScrollView
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:id="@+id/activitymainListView1"/>
+
+			</ScrollView>
+
+		</com.baoyz.widget.PullRefreshLayout>
+
+	</LinearLayout>
+
+	<cc.winboll.studio.libaes.views.ADsBannerView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/adsbanner"/>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_sharedjsonreceive.xml b/mymessagemanager/src/main/res/layout/activity_sharedjsonreceive.xml
new file mode 100644
index 0000000..501df04
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_sharedjsonreceive.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.AToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activitysharedjsonreceiveASupportToolbar1"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0" android:background="@drawable/bg_container_border">
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:id="@+id/activitysharedjsonreceiveTextView1"
+			android:padding="10dp"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_sms.xml b/mymessagemanager/src/main/res/layout/activity_sms.xml
new file mode 100644
index 0000000..1049e58
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_sms.xml
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.AToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activitysmsASupportToolbar1"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/activitysmsScrollView2" android:background="@drawable/bg_container_border">
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/activitysmsLinearLayout1" android:background="@drawable/bg_container_border">
+
+			<cc.winboll.studio.mymessagemanager.views.BottomPositionFixedScrollView
+				android:layout_width="match_parent"
+				android:layout_height="520dp"
+				android:isScrollContainer="false"
+				android:id="@+id/activitysmsScrollView1">
+
+				<cc.winboll.studio.mymessagemanager.views.SMSListViewForScrollView
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:id="@+id/activitysmsSMSListViewForScrollView1"/>
+
+			</cc.winboll.studio.mymessagemanager.views.BottomPositionFixedScrollView>
+
+			<include
+				layout="@layout/view_smssend"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:id="@+id/activitysmsinclude1"/>
+			
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_smsacceptrulesetting.xml b/mymessagemanager/src/main/res/layout/activity_smsacceptrulesetting.xml
new file mode 100644
index 0000000..9c8c228
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_smsacceptrulesetting.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activitysmsacceptrulesettingASupportToolbar1"/>
+
+	<com.baoyz.widget.PullRefreshLayout
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/activitysmsacceptrulesettingPullRefreshLayout1">
+
+		<androidx.recyclerview.widget.RecyclerView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:isScrollContainer="true"
+			app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
+			app:reverseLayout="false"
+			android:id="@+id/activitysmsacceptrulesettingRecyclerView1"/>
+
+	</com.baoyz.widget.PullRefreshLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical"
+		android:background="@drawable/bg_frame"
+		android:padding="10dp">
+
+		<EditText
+			android:layout_width="0dp"
+			android:ems="10"
+			android:layout_height="wrap_content"
+			android:layout_weight="1.0"
+			android:singleLine="true"
+			android:id="@+id/activitysmsacceptrulesettingEditText1"/>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+			<RadioButton
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Accept"
+				android:id="@+id/activitysmsacceptrulesettingRadioButton1"
+				android:onClick="onAcceptRuleType"
+				android:textColor="?android:attr/textColorPrimary"/>
+
+			<RadioButton
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Refuse"
+				android:id="@+id/activitysmsacceptrulesettingRadioButton2"
+				android:onClick="onRefuseRuleType"
+				android:textColor="?android:attr/textColorPrimary"/>
+
+			<CheckBox
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Enable"
+				android:id="@+id/activitysmsacceptrulesettingCheckBox1"
+				android:textColor="?android:attr/textColorPrimary"/>
+
+			<Button
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="+"
+				android:id="@+id/activitysmsacceptrulesettingButton1"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_smsrecycle.xml b/mymessagemanager/src/main/res/layout/activity_smsrecycle.xml
new file mode 100644
index 0000000..0f35153
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_smsrecycle.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activitysmsrecycleASupportToolbar1"/>
+
+	<com.baoyz.widget.PullRefreshLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/activitysmsrecyclePullRefreshLayout1">
+
+        <androidx.recyclerview.widget.RecyclerView
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:isScrollContainer="true"
+            app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
+            app:reverseLayout="false"
+            android:id="@+id/activitysmsrecycleRecyclerView1"/>
+
+	</com.baoyz.widget.PullRefreshLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_smsrecycle2.xml b/mymessagemanager/src/main/res/layout/activity_smsrecycle2.xml
new file mode 100644
index 0000000..df39118
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_smsrecycle2.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activitysmsrecycle2ASupportToolbar1"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="@drawable/bg_frame"
+		android:padding="8dp"
+		android:layout_margin="4dp">
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="刻度值调节示例（对所有列表项生效）："
+			android:textSize="12sp"
+			android:paddingLeft="4dp"
+			android:paddingBottom="4dp"/>
+
+		<cc.winboll.studio.mymessagemanager.views.ProtectModeTextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:id="@+id/activitysmsrecycle2SampleProtectModeTextView"/>
+
+	</LinearLayout>
+
+	<com.baoyz.widget.PullRefreshLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/activitysmsrecycle2PullRefreshLayout1">
+
+		<androidx.recyclerview.widget.RecyclerView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:isScrollContainer="true"
+			app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
+			app:reverseLayout="false"
+			android:id="@+id/activitysmsrecycle2RecyclerView1"/>
+
+	</com.baoyz.widget.PullRefreshLayout>
+
+</LinearLayout>
diff --git a/mymessagemanager/src/main/res/layout/activity_ttsfloatsettings.xml b/mymessagemanager/src/main/res/layout/activity_ttsfloatsettings.xml
new file mode 100644
index 0000000..567b5ec
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_ttsfloatsettings.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="#FFC1C1C1">
+
+	<cc.winboll.studio.mymessagemanager.views.DraggableView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"/>
+
+</FrameLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_ttsplayrule.xml b/mymessagemanager/src/main/res/layout/activity_ttsplayrule.xml
new file mode 100644
index 0000000..7a10022
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_ttsplayrule.xml
@@ -0,0 +1,164 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/activityttsplayruleASupportToolbar1"/>
+
+	<RelativeLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0" android:background="@drawable/bg_container_border">
+
+		<androidx.recyclerview.widget.RecyclerView
+			android:layout_above="@+id/activityttsplayruleLinearLayout2"
+			android:layout_alignParentTop="true"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:isScrollContainer="false"
+			app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
+			app:reverseLayout="false"
+			android:id="@+id/activityttsplayruleRecyclerView1"/>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="234dp"
+			android:id="@+id/activityttsplayruleLinearLayout1" android:background="@drawable/bg_container_border" />
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:layout_below="@+id/activityttsplayruleLinearLayout1"
+			android:background="@drawable/bg_frame"
+			android:id="@+id/activityttsplayruleLinearLayout2"
+			android:layout_alignParentBottom="true"
+			android:padding="10dp">
+
+			<ScrollView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+				<LinearLayout
+					android:orientation="vertical"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+					<LinearLayout
+						android:orientation="vertical"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:layout_gravity="center_horizontal" android:background="@drawable/bg_container_border">
+
+						<RelativeLayout
+							android:layout_width="match_parent"
+							android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+							<TextView
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="测试文本："
+								android:id="@+id/activityttsplayruleTextView1"
+								android:layout_centerVertical="true"/>
+
+							<Button
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="✈"
+								android:layout_toRightOf="@id/activityttsplayruleTextView1"
+								android:layout_centerVertical="true"
+								android:onClick="onScrollToDemoSMSTextMatchingRule"/>
+
+						</RelativeLayout>
+
+						<EditText
+							android:layout_width="match_parent"
+							android:inputType="textMultiLine"
+							android:layout_height="wrap_content"
+							android:ems="10"
+							android:id="@+id/activityttsplayruleEditText1"/>
+
+					</LinearLayout>
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:layout_gravity="center_horizontal" android:background="@drawable/bg_container_border">
+
+						<TextView
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="搜索字串："/>
+
+						<EditText
+							android:layout_width="0dp"
+							android:inputType="textMultiLine"
+							android:layout_height="wrap_content"
+							android:ems="10"
+							android:id="@+id/activityttsplayruleEditText2"
+							android:layout_weight="1.0"/>
+
+					</LinearLayout>
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:layout_gravity="center_horizontal" android:background="@drawable/bg_container_border">
+
+						<TextView
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="语音字串："/>
+
+						<EditText
+							android:layout_width="0dp"
+							android:inputType="textMultiLine"
+							android:layout_height="wrap_content"
+							android:ems="10"
+							android:id="@+id/activityttsplayruleEditText3"
+							android:layout_weight="1.0"/>
+
+					</LinearLayout>
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:gravity="center" android:background="@drawable/bg_container_border">
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							style="?android:attr/buttonStyle"
+							android:text="♬"
+							android:id="@+id/activityttsplayruleButton1"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							style="?android:attr/buttonStyle"
+							android:text="√"
+							android:id="@+id/activityttsplayruleButton2"/>
+
+					</LinearLayout>
+
+				</LinearLayout>
+
+			</ScrollView>
+
+		</LinearLayout>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/activity_unittest.xml b/mymessagemanager/src/main/res/layout/activity_unittest.xml
new file mode 100644
index 0000000..0e27922
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/activity_unittest.xml
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+    <ScrollView
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+        <LinearLayout
+            android:orientation="vertical"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:padding="10dp" android:background="@drawable/bg_container_border">
+
+            <!-- 新增：自定义ProtectModeTextView -->
+            <cc.winboll.studio.mymessagemanager.views.ProtectModeTextView
+                android:id="@+id/protect_mode_tv"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginBottom="15dp"/>
+
+            <LinearLayout
+                android:orientation="horizontal"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:gravity="right" android:background="@drawable/bg_container_border">
+
+                <Button
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="Test Main"
+                    android:onClick="onMain"
+                    android:textAllCaps="false"/>
+
+            </LinearLayout>
+
+        </LinearLayout>
+
+    </ScrollView>
+
+    <cc.winboll.studio.libappbase.LogView
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1.0"
+        android:id="@+id/logview"/>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/item_ttsplayrule.xml b/mymessagemanager/src/main/res/layout/item_ttsplayrule.xml
new file mode 100644
index 0000000..0543820
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/item_ttsplayrule.xml
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:padding="10dp"
+		android:layout_marginBottom="10dp"
+		android:gravity="center_vertical"
+		android:id="@+id/itemttsplayruleLinearLayout1" android:background="@drawable/bg_container_border">
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Text"
+				android:id="@+id/itemttsplayruleTextView2"/>
+
+			<CheckBox
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:background="#FFFFFFFF"
+				android:id="@+id/itemttsplayruleCheckBox1"/>
+
+		</LinearLayout>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+			<Button
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="△"
+				android:id="@+id/itemttsplayruleButton1"/>
+
+			<Button
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="▽"
+				android:id="@+id/itemttsplayruleButton2"/>
+
+		</LinearLayout>
+
+		<TextView
+			android:layout_width="0dp"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:layout_weight="1.0"
+			android:id="@+id/itemttsplayruleTextView1"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/item_ttsplayrule_simple.xml b/mymessagemanager/src/main/res/layout/item_ttsplayrule_simple.xml
new file mode 100644
index 0000000..8d38ded
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/item_ttsplayrule_simple.xml
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:padding="10dp"
+		android:layout_marginBottom="10dp"
+		android:gravity="center_vertical"
+		android:id="@+id/itemttsplayrulesimpleLinearLayout1" android:background="@drawable/bg_container_border">
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Text"
+				android:id="@+id/itemttsplayrulesimpleTextView2"/>
+
+			<CheckBox
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:background="#FFFFFFFF"
+				android:id="@+id/itemttsplayrulesimpleCheckBox1"/>
+
+		</LinearLayout>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+			<Button
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="△"
+				android:id="@+id/itemttsplayrulesimpleButton1"/>
+
+			<Button
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="▽"
+				android:id="@+id/itemttsplayrulesimpleButton2"/>
+
+		</LinearLayout>
+
+		<TextView
+			android:layout_width="0dp"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:layout_weight="1.0"
+			android:id="@+id/itemttsplayrulesimpleTextView1"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/layout_protect_mode_textview.xml b/mymessagemanager/src/main/res/layout/layout_protect_mode_textview.xml
new file mode 100644
index 0000000..0af0422
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/layout_protect_mode_textview.xml
@@ -0,0 +1,22 @@
+<?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_container_border">
+
+    <TextView
+        android:id="@+id/tv_content"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textSize="16sp"
+        android:gravity="center"/>
+
+    <SeekBar
+		android:id="@+id/seek_bar_scale"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp"/>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_contracts.xml b/mymessagemanager/src/main/res/layout/listview_contracts.xml
new file mode 100644
index 0000000..954a70f
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_contracts.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Text"
+		android:id="@+id/listviewcontractsTextView1"/>
+    
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Text"
+        android:id="@+id/listviewcontractsTextView2"/>
+    
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_phone.xml b/mymessagemanager/src/main/res/layout/listview_phone.xml
new file mode 100644
index 0000000..c8471bc
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_phone.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:padding="10dp"
+	android:id="@+id/listviewphoneLinearLayout1"
+	android:background="@drawable/bg_frame">
+
+	<TextView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/listviewphoneTextView2"/>
+
+	<TextView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/listviewphoneTextView1"/>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_sms.xml b/mymessagemanager/src/main/res/layout/listview_sms.xml
new file mode 100644
index 0000000..870f51e
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_sms.xml
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+	<View
+		android:layout_width="32dp"
+		android:layout_height="wrap_content"
+		android:id="@+id/listviewsmsView1"/>
+
+	<cc.winboll.studio.mymessagemanager.views.SMSView
+		xmlns:app="http://schemas.android.com/apk/res-auto"
+		android:layout_width="0dp"
+		android:layout_height="wrap_content"
+		app:cardCornerRadius="?attr/borderCornerRadius"
+		app:cardElevation="5dp"
+		app:cardUseCompatPadding="true"
+		android:elevation="5dp"
+		android:translationZ="5dp"
+		android:clickable="true"
+		android:foreground="?android:attr/selectableItemBackground"
+		app:cardBackgroundColor="?attr/colorAccent"
+		android:layout_weight="1.0"
+		android:id="@+id/listviewsmsSMSView1">
+
+		<include layout="@layout/listview_sms_part1"/>
+
+	</cc.winboll.studio.mymessagemanager.views.SMSView>
+
+	<View
+		android:layout_width="32dp"
+		android:layout_height="wrap_content"
+		android:id="@+id/listviewsmsView2"/>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_sms_part1.xml b/mymessagemanager/src/main/res/layout/listview_sms_part1.xml
new file mode 100644
index 0000000..afef768
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_sms_part1.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:padding="10dp"
+		android:layout_marginBottom="10dp"
+		android:gravity="right"
+		android:id="@+id/listviewsmspart1LinearLayout1" android:background="@drawable/bg_container_border">
+
+		<cc.winboll.studio.mymessagemanager.views.DateAgoTextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:paddingLeft="10dp"
+			android:paddingRight="10dp"
+			android:id="@+id/listviewsmspart1DateAgoTextView1"/>
+
+		<LinearLayout
+			android:orientation="horizontal"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:background="@drawable/bg_frame"
+			android:gravity="center_vertical"
+			android:id="@+id/listviewsmspart1LinearLayout2">
+
+			<View
+				android:layout_width="0dp"
+				android:layout_height="0dp"
+				android:id="@+id/listviewsmspart1View1"
+				android:layout_centerInParent="true"/>
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:text="Text"
+				android:layout_marginRight="10dp"
+				android:layout_margin="10dp"
+				android:id="@+id/listviewsmspart1TextView1"
+				android:layout_alignParentTop="true"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_smsacceptrule.xml b/mymessagemanager/src/main/res/layout/listview_smsacceptrule.xml
new file mode 100644
index 0000000..db124a2
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_smsacceptrule.xml
@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:paddingLeft="10dp"
+	android:paddingRight="10dp"
+	android:background="@drawable/bg_frame">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical" android:background="@drawable/bg_container_border">
+
+		<EditText
+			android:layout_width="0dp"
+			android:ems="10"
+			android:layout_height="wrap_content"
+			android:id="@+id/listviewsmsacceptruleEditText1"
+			android:singleLine="true"
+			android:gravity="center_vertical"
+			android:paddingTop="10dp"
+			android:paddingBottom="10dp"
+			android:layout_weight="1.0"/>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+			<RadioButton
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Accept"
+				android:id="@+id/listviewsmsacceptruleRadioButton1"
+				android:textColor="?android:attr/textColorPrimary"/>
+
+			<RadioButton
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Refuse"
+				android:id="@+id/listviewsmsacceptruleRadioButton2"
+				android:textColor="?android:attr/textColorPrimary"/>
+
+			<CheckBox
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:id="@+id/listviewsmsacceptruleCheckBox1"
+				android:text="Enable"
+				android:textColor="?android:attr/textColorPrimary"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="end" android:background="@drawable/bg_container_border">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:id="@+id/listviewsmsacceptruleButton2"
+			android:text="×"
+			android:layout_marginEnd="20dp"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="▲"
+			android:id="@+id/listviewsmsacceptruleButton3"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="▼"
+			android:id="@+id/listviewsmsacceptruleButton4"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:id="@+id/listviewsmsacceptruleButton1"
+			android:text="√"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_smsacceptrule_simple.xml b/mymessagemanager/src/main/res/layout/listview_smsacceptrule_simple.xml
new file mode 100644
index 0000000..417e6cf
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_smsacceptrule_simple.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:paddingLeft="10dp"
+	android:paddingRight="10dp"
+	android:background="@drawable/bg_frame"
+	android:gravity="center_vertical">
+
+	<TextView
+		android:layout_width="0dp"
+		android:layout_height="wrap_content"
+		android:layout_weight="1.0"
+		android:text="Text"
+		android:gravity="center_vertical"
+		android:paddingTop="10dp"
+		android:paddingBottom="10dp"
+		android:id="@+id/listviewsmsacceptrulesimpleTextView1"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="Text"
+            android:layout_marginLeft="5dp"
+            android:id="@+id/listviewsmsacceptrulesimpleTextView2"/>
+        
+		<CheckBox
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Enable"
+			android:id="@+id/listviewsmsacceptrulesimpleCheckBox1"
+			android:enabled="false"
+			android:textColor="?android:attr/textColorPrimary"/>
+
+	</LinearLayout>
+
+	<Button
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="☰"
+		android:id="@+id/listviewsmsacceptrulesimpleButton1"/>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_smsrecycle.xml b/mymessagemanager/src/main/res/layout/listview_smsrecycle.xml
new file mode 100644
index 0000000..f3bcf0b
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_smsrecycle.xml
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:background="@drawable/bg_frame"
+	android:padding="10dp">
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_centerVertical="true" android:background="@drawable/bg_container_border">
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:id="@+id/listviewsmsrecycleTextView1"
+			android:padding="10dp"/>
+
+		<LinearLayout
+			android:orientation="horizontal"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:gravity="center_vertical" android:background="@drawable/bg_container_border">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="@string/text_smsdeletetime"/>
+
+			<cc.winboll.studio.mymessagemanager.views.DateAgoTextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Text"
+				android:paddingLeft="10dp"
+				android:paddingRight="10dp"
+				android:id="@+id/listviewsmsrecycleDateAgoTextView1"/>
+
+		</LinearLayout>
+
+		<LinearLayout
+			android:orientation="horizontal"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+			<View
+				android:layout_width="32dp"
+				android:layout_height="wrap_content"
+				android:id="@+id/listviewsmsrecycleView1"/>
+
+			<cc.winboll.studio.mymessagemanager.views.SMSView
+				xmlns:app="http://schemas.android.com/apk/res-auto"
+				android:layout_width="0dp"
+				android:layout_height="wrap_content"
+				app:cardCornerRadius="?attr/borderCornerRadius"
+				app:cardElevation="5dp"
+				app:cardUseCompatPadding="true"
+				android:elevation="5dp"
+				android:translationZ="5dp"
+				android:clickable="true"
+				android:foreground="?android:attr/selectableItemBackground"
+				app:cardBackgroundColor="@color/colorAccent"
+				android:layout_weight="1.0"
+				android:id="@+id/listviewsmsrecycleSMSView1">
+
+				<include
+					layout="@layout/listview_sms_part1"/>
+
+			</cc.winboll.studio.mymessagemanager.views.SMSView>
+
+			<View
+				android:layout_width="32dp"
+				android:layout_height="wrap_content"
+				android:id="@+id/listviewsmsrecycleView2"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+
+</RelativeLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_smsrecycle2.xml b/mymessagemanager/src/main/res/layout/listview_smsrecycle2.xml
new file mode 100644
index 0000000..54fd844
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_smsrecycle2.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:background="@drawable/bg_frame"
+	android:padding="10dp">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:id="@+id/listviewsmsrecycle2TextViewAddress"
+		android:padding="5dp"
+		android:textSize="16sp"/>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical"
+		android:padding="5dp" android:background="@drawable/bg_container_border">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="@string/text_smsdeletetime"/>
+
+		<cc.winboll.studio.mymessagemanager.views.DateAgoTextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:paddingLeft="10dp"
+			android:paddingRight="10dp"
+			android:id="@+id/listviewsmsrecycle2DateAgoTextViewDelete"/>
+
+	</LinearLayout>
+
+	<cc.winboll.studio.mymessagemanager.views.ProtectModeTextView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/listviewsmsrecycle2ProtectModeTextView"/>
+
+</LinearLayout>
diff --git a/mymessagemanager/src/main/res/layout/listview_smsrecycle_simple.xml b/mymessagemanager/src/main/res/layout/listview_smsrecycle_simple.xml
new file mode 100644
index 0000000..984c48f
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_smsrecycle_simple.xml
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:background="@drawable/bg_frame"
+	android:padding="10dp">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical"
+		android:padding="10dp" android:background="@drawable/bg_container_border">
+
+		<TextView
+			android:layout_width="0dp"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:id="@+id/listviewsmsrecyclesimpleTextView1"
+			android:layout_weight="1.0"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="☰"
+			android:id="@+id/listviewsmsrecyclesimpleButton1"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_ttsplayrule.xml b/mymessagemanager/src/main/res/layout/listview_ttsplayrule.xml
new file mode 100644
index 0000000..506fe50
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_ttsplayrule.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+	<cc.winboll.studio.mymessagemanager.views.TTSRuleView
+		xmlns:app="http://schemas.android.com/apk/res-auto"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		app:cardCornerRadius="?attr/borderCornerRadius"
+		app:cardElevation="5dp"
+		app:cardUseCompatPadding="true"
+		android:elevation="5dp"
+		android:translationZ="5dp"
+		android:clickable="true"
+		android:foreground="?android:attr/selectableItemBackground"
+		app:cardBackgroundColor="@color/colorAccent"
+		android:id="@+id/listviewttsplayruleTTSRuleView1">
+
+		<include
+			layout="@layout/item_ttsplayrule"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"/>
+
+	</cc.winboll.studio.mymessagemanager.views.TTSRuleView>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/listview_ttsplayrule_simple.xml b/mymessagemanager/src/main/res/layout/listview_ttsplayrule_simple.xml
new file mode 100644
index 0000000..97450ea
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/listview_ttsplayrule_simple.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<cc.winboll.studio.mymessagemanager.views.TTSRuleView
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_gravity="center"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    app:cardCornerRadius="?attr/borderCornerRadius"
+    app:cardElevation="5dp"
+    app:cardUseCompatPadding="true"
+    android:elevation="5dp"
+    android:translationZ="5dp"
+    android:clickable="true"
+    android:foreground="?android:attr/selectableItemBackground"
+    app:cardBackgroundColor="@color/colorAccent"
+    android:id="@+id/listviewttsplayruleTTSRuleView1">
+
+    <include
+        layout="@layout/item_ttsplayrule_simple"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"/>
+    
+
+</cc.winboll.studio.mymessagemanager.views.TTSRuleView>
+
diff --git a/mymessagemanager/src/main/res/layout/remoteview.xml b/mymessagemanager/src/main/res/layout/remoteview.xml
new file mode 100644
index 0000000..593b401
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/remoteview.xml
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:id="@+id/remoteviewLinearLayout1" android:background="@drawable/bg_container_border">
+
+	<ImageView
+		android:layout_width="60dp"
+		android:layout_height="60dp"
+		android:id="@+id/remoteviewImageView1"
+		android:layout_gravity="center_vertical"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical" android:background="@drawable/bg_container_border">
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:textSize="16sp"
+			android:id="@+id/remoteviewTextView1"
+			android:textStyle="bold"/>
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:textSize="14sp"
+			android:id="@+id/remoteviewTextView2"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/toast_custom_view.xml b/mymessagemanager/src/main/res/layout/toast_custom_view.xml
new file mode 100644
index 0000000..e43b760
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/toast_custom_view.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="wrap_content"
+	android:layout_height="wrap_content"
+	android:background="@drawable/shape_gradient"
+	android:gravity="center"
+	android:orientation="vertical"
+	android:padding="10dp">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="@string/app_name"
+		android:textStyle="bold"/>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content" android:background="@drawable/bg_container_border">
+
+		<ImageView
+			android:layout_width="40dp"
+			android:layout_height="40dp"
+			android:src="@drawable/ic_launcher"/>
+
+		<TextView
+			android:id="@android:id/message"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+		android:layout_margin="10dp"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/toolbar_sendsms.xml b/mymessagemanager/src/main/res/layout/toolbar_sendsms.xml
new file mode 100644
index 0000000..531b8fc
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/toolbar_sendsms.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent" android:background="@drawable/bg_container_border">
+
+	<EditText
+		android:layout_width="wrap_content"
+		android:inputType="phone"
+		android:layout_height="wrap_content"
+		android:ems="10"/>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/view_smssend.xml b/mymessagemanager/src/main/res/layout/view_smssend.xml
new file mode 100644
index 0000000..18920d7
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/view_smssend.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<cc.winboll.studio.mymessagemanager.views.SMSView
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:padding="2dp"
+	app:cardCornerRadius="?attr/borderCornerRadius"
+	app:cardElevation="5dp"
+	app:cardUseCompatPadding="true"
+	android:elevation="5dp"
+	android:translationZ="5dp"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+    app:attrSMSType="SEND">
+
+	<include layout="@layout/view_smssend_part1" />
+
+</cc.winboll.studio.mymessagemanager.views.SMSView>
diff --git a/mymessagemanager/src/main/res/layout/view_smssend_part1.xml b/mymessagemanager/src/main/res/layout/view_smssend_part1.xml
new file mode 100644
index 0000000..8bee679
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/view_smssend_part1.xml
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:padding="6dp" android:background="@drawable/bg_container_border">
+
+	<TextView
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center"
+		android:textSize="20sp"
+		android:id="@+id/viewsmssendpart1TextView1"/>
+	
+	<cc.winboll.studio.libaes.views.AOHPCTCSeekBar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/viewsmssendpart1AOHPCTCSeekBar1"/>
+
+	<EditText
+        android:scrollbars="vertical"
+        android:maxHeight="150dp"
+		android:layout_width="match_parent"
+		android:inputType="textMultiLine"
+		android:layout_height="wrap_content"
+		android:padding="10dp"
+		android:id="@+id/viewsmssendpart1EditText1"
+		android:background="@drawable/bg_frame"/>
+
+	
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/layout/view_tts_back.xml b/mymessagemanager/src/main/res/layout/view_tts_back.xml
new file mode 100644
index 0000000..00cdde4
--- /dev/null
+++ b/mymessagemanager/src/main/res/layout/view_tts_back.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="@drawable/bg_frame_white"
+	android:layout_gravity="center_vertical|center_horizontal"
+	android:id="@+id/viewttsbackLinearLayout1">
+
+	<LinearLayout
+		xmlns:app="http://schemas.android.com/apk/res-auto"
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:padding="10dp"
+		android:gravity="center_horizontal" android:background="@drawable/bg_container_border">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="@string/app_name"
+		android:textStyle="bold"
+			android:textAppearance="?android:attr/textAppearanceLarge"/>
+
+		<ImageView
+			android:layout_width="50dp"
+			android:layout_height="50dp"
+			android:textAllCaps="false"
+			android:background="@drawable/speaker"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Click To Stop TTS Play"
+		android:textAppearance="?android:attr/textAppearanceSmall"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/mymessagemanager/src/main/res/menu/toolbar_about.xml b/mymessagemanager/src/main/res/menu/toolbar_about.xml
new file mode 100644
index 0000000..a5662ee
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_about.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_item_sms.xml b/mymessagemanager/src/main/res/menu/toolbar_item_sms.xml
new file mode 100644
index 0000000..b186290
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_item_sms.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    
+    <item
+        android:id="@+id/copy"
+        android:title="Copy"/>
+    
+    <item
+        android:id="@+id/delete"
+        android:title="Delete"/>
+	
+	<item
+        android:id="@+id/addttsrule"
+        android:title="Add TTS Rule"/>
+ 
+    <item
+        android:id="@+id/testtts"
+        android:title="Test TTS"/>
+
+    <item
+        android:id="@+id/testreceivetule"
+        android:title="Test Receive Rule"/>
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_item_smsrecycle.xml b/mymessagemanager/src/main/res/menu/toolbar_item_smsrecycle.xml
new file mode 100644
index 0000000..6f73933
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_item_smsrecycle.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    <item
+        android:id="@+id/item_restoresms"
+        android:title="@string/text_restoresms"/>
+    
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_main_debug.xml b/mymessagemanager/src/main/res/menu/toolbar_main_debug.xml
new file mode 100644
index 0000000..fe63e44
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_main_debug.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+	<item android:title="APP Debug">
+		<menu>
+			<item
+				android:id="@+id/app_unittest"
+				android:title="@string/app_unittest"/>
+		</menu>
+    </item>
+
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_main_first.xml b/mymessagemanager/src/main/res/menu/toolbar_main_first.xml
new file mode 100644
index 0000000..84b6807
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_main_first.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    <!--<item android:title="@string/app_theme">
+        <menu>-->
+            <!-- 定义一组单选按钮 -->
+            <!-- checkableBehavior的可选值由三个：single设置为单选，all为多选，none为普通选项 -->
+    <!--        <group android:checkableBehavior="single">
+                <item android:id="@+id/app_defaulttheme" android:title="@string/app_defaulttheme"/>
+                <item android:id="@+id/app_skytheme" android:title="@string/app_skytheme"/>
+                <item android:id="@+id/app_goldentheme" android:title="@string/app_goldentheme"/>
+            </group>
+        </menu>
+    </item>-->
+    <item
+        android:id="@+id/app_ttsrule"
+        android:title="@string/text_ttsrule"/>
+    <item
+        android:id="@+id/app_smsrule"
+        android:title="@string/text_smsrule"/>
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_main_last.xml b/mymessagemanager/src/main/res/menu/toolbar_main_last.xml
new file mode 100644
index 0000000..536d15f
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_main_last.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/app_appsettings"
+        android:title="@string/text_appsettings"/>
+    <item
+        android:id="@+id/app_about"
+        android:title="@string/app_about"/>
+    <item
+        android:id="@+id/app_smsrecycle"
+        android:title="@string/app_smsrecycle"/>
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_rule.xml b/mymessagemanager/src/main/res/menu/toolbar_rule.xml
new file mode 100644
index 0000000..736fbc2
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_rule.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    
+    <item
+        android:id="@+id/item_rule_share"
+        android:title="@string/text_item_rule_share"/>
+
+    <item
+        android:id="@+id/item_rule_reset"
+        android:title="@string/text_item_rule_reset"/>
+    
+    <item
+        android:id="@+id/item_rule_clean"
+        android:title="@string/text_item_rule_clean"/>
+    
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_smsacceptrulebean.xml b/mymessagemanager/src/main/res/menu/toolbar_smsacceptrulebean.xml
new file mode 100644
index 0000000..db92aa3
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_smsacceptrulebean.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    
+    <item
+        android:id="@+id/item_SMSAcceptRuleBean_Edit"
+        android:title="Edit"/>
+    <item
+        android:id="@+id/item_SMSAcceptRuleBean_Delete"
+        android:title="Delete"/>
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_smsrecycle.xml b/mymessagemanager/src/main/res/menu/toolbar_smsrecycle.xml
new file mode 100644
index 0000000..c3503f8
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_smsrecycle.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    <item
+        android:id="@+id/item_cleansmsrecycle"
+        android:title="@string/text_cleansmsrecycle"/>
+    
+</menu>
diff --git a/mymessagemanager/src/main/res/menu/toolbar_ttsrule.xml b/mymessagemanager/src/main/res/menu/toolbar_ttsrule.xml
new file mode 100644
index 0000000..ea4ac1d
--- /dev/null
+++ b/mymessagemanager/src/main/res/menu/toolbar_ttsrule.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+
+	<item
+        android:id="@+id/deletettsrule"
+        android:title="Delete TTS Rule"/>
+    
+</menu>
diff --git a/mymessagemanager/src/main/res/values-night/colors.xml b/mymessagemanager/src/main/res/values-night/colors.xml
new file mode 100644
index 0000000..4cb8e93
--- /dev/null
+++ b/mymessagemanager/src/main/res/values-night/colors.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <color name="text_color_primary_default">#FF999999</color>
+    <color name="text_color_primary_depth">#FF999999</color>
+    <color name="text_color_primary_sky">#FF999999</color>
+    <color name="text_color_primary_golden">#FF999999</color>
+    <color name="text_color_primary_memor">#FF999999</color>
+    <color name="text_color_primary_tao">#FF999999</color>
+    <color name="window_background">#FF000000</color>
+
+</resources>
diff --git a/mymessagemanager/src/main/res/values-night/styles.xml b/mymessagemanager/src/main/res/values-night/styles.xml
new file mode 100644
index 0000000..75d157e
--- /dev/null
+++ b/mymessagemanager/src/main/res/values-night/styles.xml
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <style name="MyAppTheme" parent="AESTheme">
+        <item name="borderCornerRadius">6dp</item>
+        <item name="android:windowBackground">@color/window_background</item>
+        <item name="android:textColorPrimary">@color/text_color_primary_default</item>
+        <item name="textColorPrimary">@color/text_color_primary_default</item>
+        <item name="android:textColor">@color/text_color_primary_default</item>
+        <item name="colorTextColor">@color/text_color_primary_default</item>
+	</style>
+
+    <style name="MyDepthAESTheme" parent="DepthAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_depth</item>
+		<item name="textColorPrimary">@color/text_color_primary_depth</item>
+		<item name="android:textColor">@color/text_color_primary_depth</item>
+		<item name="colorTextColor">@color/text_color_primary_depth</item>
+    </style>
+
+    <style name="MySkyAESTheme" parent="SkyAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_sky</item>
+		<item name="textColorPrimary">@color/text_color_primary_sky</item>
+		<item name="android:textColor">@color/text_color_primary_sky</item>
+		<item name="colorTextColor">@color/text_color_primary_sky</item>
+    </style>
+
+    <style name="MyGoldenAESTheme" parent="GoldenAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_golden</item>
+		<item name="textColorPrimary">@color/text_color_primary_golden</item>
+		<item name="android:textColor">@color/text_color_primary_golden</item>
+		<item name="colorTextColor">@color/text_color_primary_golden</item>
+    </style>
+
+    <style name="MyMemorAESTheme" parent="MemorAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_memor</item>
+		<item name="textColorPrimary">@color/text_color_primary_memor</item>
+		<item name="android:textColor">@color/text_color_primary_memor</item>
+		<item name="colorTextColor">@color/text_color_primary_memor</item>
+    </style>
+
+    <style name="MyTaoAESTheme" parent="TaoAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_tao</item>
+		<item name="textColorPrimary">@color/text_color_primary_tao</item>
+		<item name="android:textColor">@color/text_color_primary_tao</item>
+		<item name="colorTextColor">@color/text_color_primary_tao</item>
+    </style>
+
+</resources>
diff --git a/mymessagemanager/src/main/res/values-zh/strings.xml b/mymessagemanager/src/main/res/values-zh/strings.xml
new file mode 100644
index 0000000..c6778ec
--- /dev/null
+++ b/mymessagemanager/src/main/res/values-zh/strings.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">我的短信管家</string>
+    <string name="app_description">用正则表达式方法自定义短信过滤和语音播报的短信应用。</string>
+    <string name="app_log">应用日志</string>
+    <string name="app_theme">应用主题</string>
+    <string name="app_defaulttheme">默认主题</string>
+    <string name="app_skytheme">蓝色天空主题</string>
+    <string name="app_goldentheme">辉煌历程主题</string>
+    <string name="app_developoptions">开发选项</string>
+    <string name="app_default_app_settings">默认应用设置</string>
+    <string name="app_unittest">单元测试</string>
+    <string name="app_crashtest">应用异常崩溃处理测试</string>
+    <string name="app_about">关于应用</string>
+    <string name="app_smsrecycle">短信回收站</string>
+    <string name="app_permission_require_info">应用权限申请提示</string>
+    <string name="app_website">https://winboll.cc/studio/details.php?app=MyMessageManager</string>
+    <string name="activity_name_main">短信管理中心</string>
+    <string name="activity_name_sharedjsonreceive">JSON 文件处理</string>
+    <string name="activity_name_composesms">发送短信</string>
+    <string name="activity_name_smsinphone">短信列表</string>
+    <string name="activity_name_log">应用日志</string>
+    <string name="activity_name_about">关于应用</string>
+    <string name="activity_name_appsettings">应用设置</string>
+    <string name="text_smsdeletetime">删除时间：</string>
+    <string name="text_smsfrom">来自：</string>
+    <string name="text_aboutservernotification">这是短信服务运行时的提示窗口，您可以在应用设置的通知消息设置中设置为隐藏本类通知。</string>
+    <string name="text_ttsrule">TTS语音播报规则</string>
+    <string name="text_smsrule">短信接收规则</string>
+    <string name="text_item_rule_share">分享设置</string>
+    <string name="text_item_rule_reset">重置设置</string>
+    <string name="text_item_rule_clean">清理设置</string>
+    <string name="text_sendsms">发送短信</string>
+    <string name="text_mainservice">短信服务管理总开关</string>
+    <string name="text_norulesreceivecontacts">无限制接收联系人短信</string>
+    <string name="text_usingtts">使用TTS语音播报</string>
+    <string name="text_usingttsrule">使用TTS语音自定义规则</string>
+    <string name="text_iamhere">短信管理服务已启动。</string>
+    <string name="text_havearest">短信管理服务已关闭。</string>
+    <string name="text_notincontacts">(未在联系人列表)</string>
+    <string name="text_appsettings">应用设置</string>
+    <string name="text_ttsplaydelaytimes">TTS播放延迟时间（秒）：</string>
+    <string name="msg_newsms">接收到新的消息。</string>
+    <string name="msg_100sendmsg">&gt;&gt;&gt;拉动到100%可发信息&gt;&gt;&gt;</string>
+    <string name="msg_100applysettings">&gt;&gt;&gt;拉动到100%可应用设置&gt;&gt;&gt;</string>
+</resources>
diff --git a/mymessagemanager/src/main/res/values/attrs.xml b/mymessagemanager/src/main/res/values/attrs.xml
new file mode 100644
index 0000000..7ec833d
--- /dev/null
+++ b/mymessagemanager/src/main/res/values/attrs.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!--<attr name="appTheme" format="reference"/>-->
+    <attr name="borderCornerRadius" format="dimension" />
+    <attr name="textColorPrimary" format="color" />
+	<declare-styleable name="SMSView">
+        <attr name="attrSMSType" format="string"/>
+        <attr name="attrSMSViewSendColor" format="color" />
+        <attr name="attrSMSViewInboxColor" format="color" />
+    </declare-styleable>
+    <declare-styleable name="TTSRuleView">
+        <attr name="attrTTSRuleViewBackgroundColor" format="color" />
+    </declare-styleable>
+</resources>
diff --git a/mymessagemanager/src/main/res/values/colors.xml b/mymessagemanager/src/main/res/values/colors.xml
new file mode 100644
index 0000000..845b15f
--- /dev/null
+++ b/mymessagemanager/src/main/res/values/colors.xml
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <color name="white">#FFFFFFFF</color>
+
+    <color name="text_color_primary_default">#FF212121</color>
+    <color name="text_color_primary_depth">#FF1A237E</color>
+    <color name="text_color_primary_sky">#FF01579B</color>
+    <color name="text_color_primary_golden">#FF3E2723</color>
+    <color name="text_color_primary_memor">#FF4A148C</color>
+    <color name="text_color_primary_tao">#FF424242</color>
+    <color name="window_background">#FFFFFFFF</color>
+	
+    <color name="colorSMSSendColor">#FFDCDA3D</color>
+    <color name="colorSMSInboxColor">#FF3DDC84</color>
+    <color name="colorTTSRuleViewBackgroundColor">#FFDCDA3D</color>
+
+    <color name="colorSMSSendColorDepth">#FFA28BFF</color>
+    <color name="colorSMSInboxColorDepth">#FF8BAEFF</color>
+    <color name="colorTTSRuleViewBackgroundColorDepth">#FFA28BFF</color>
+
+    <color name="colorSMSSendColorSky">#FFFFEB8C</color>
+    <color name="colorSMSInboxColorSky">#FF8CD9FF</color>
+    <color name="colorTTSRuleViewBackgroundColorSky">#FFFFEB8C</color>
+
+    <color name="colorSMSSendColorGolden">#FF78BDFF</color>
+    <color name="colorSMSInboxColorGolden">#FFFFED78</color>
+    <color name="colorTTSRuleViewBackgroundColorGolden">#FF78BDFF</color>
+
+    <color name="colorSMSSendColorMemor">#FF5AEB53</color>
+    <color name="colorSMSInboxColorMemor">#FFE653EB</color>
+    <color name="colorTTSRuleViewBackgroundColorMemor">#FF5AEB53</color>
+
+    <color name="colorSMSSendColorTao">#FFB4B4B4</color>
+    <color name="colorSMSInboxColorTao">#FFD9D9D9</color>
+    <color name="colorTTSRuleViewBackgroundColorTao">#FFB4B4B4</color>
+
+    <!-- 列表项选中颜色（深灰） -->
+    <color name="list_item_selected">#FF696969</color>
+    <!-- 列表项按压颜色（浅灰） -->
+    <color name="list_item_pressed">#FFE0E0E0</color>
+</resources>
diff --git a/mymessagemanager/src/main/res/values/dimens.xml b/mymessagemanager/src/main/res/values/dimens.xml
new file mode 100644
index 0000000..03c8154
--- /dev/null
+++ b/mymessagemanager/src/main/res/values/dimens.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <dimen name="toolbar_height">60dp</dimen>
+</resources>
diff --git a/mymessagemanager/src/main/res/values/strings.xml b/mymessagemanager/src/main/res/values/strings.xml
new file mode 100644
index 0000000..b8b478d
--- /dev/null
+++ b/mymessagemanager/src/main/res/values/strings.xml
@@ -0,0 +1,52 @@
+<resources>
+    <string name="app_name">My Message Manager</string>
+    <string name="app_projectname">MyMessageManager</string>
+	<string name="app_description">The SMS application of the custom SMS voice broadcast with the regular expression method.Play with regular expressions.</string>
+    <string name="app_log">Application Log</string>
+    <string name="app_theme">App Theme</string>
+    <string name="app_defaulttheme">Default Theme</string>
+    <string name="app_skytheme">Sky Theme</string>
+    <string name="app_goldentheme">Golden Theme</string>
+    <string name="app_developoptions">Develop Options</string>
+    <string name="app_default_app_settings">Default App Settings</string>
+    <string name="app_unittest">Unit Test</string>
+    <string name="app_crashtest">Crash Test</string>
+    <string name="app_about">About APP</string>
+    <string name="app_smsrecycle">SMS Recycle</string>
+	<string name="app_permission_require_info">APP Permission Require Info</string>
+    <string name="app_website">https://winboll.cc/studio/details.php?app=MyMessageManager</string>
+    <string name="activity_name_main">SMS Management Center</string>
+    <string name="activity_name_sharedjsonreceive">Shared JSON Handling</string>
+    <string name="activity_name_composesms">Message Sender</string>
+    <string name="activity_name_smsinphone">Messages</string>
+	<string name="activity_name_log">Application Log</string>
+	<string name="activity_name_about">About APP</string>
+	<string name="activity_name_appsettings">Settings</string>
+    <string name="text_smsdeletetime">DeleteDate:</string>
+    <string name="text_restoresms">Restore SMS</string>
+    <string name="text_cleansmsrecycle">Clean SMS Recycle</string>
+    <string name="text_smsfrom">From:</string>
+    <string name="text_ttsrule">TTS Play Rule</string>
+    <string name="text_smsrule">SMS Receive Rule</string>
+    <string name="text_aboutservernotification">This is the prompt window when the SMS service runs, which you can set to hide this class notification in the notification message settings.</string>
+    <string name="text_item_rule_share">Share Setting</string>
+    <string name="text_item_rule_reset">Reset Setting</string>
+    <string name="text_item_rule_clean">Clean Setting</string>
+    <string name="text_sendsms">Send SMS</string>
+    <string name="text_mainservice">Main Service</string>
+    <string name="text_norulesreceivecontacts">No rules Receive Contacts</string>
+    <string name="text_usingtts">Using TTS</string>
+    <string name="text_usingttsrule">Using TTS Rule</string>
+    <string name="text_iamhere">The main service is start.</string>
+    <string name="text_havearest">The main service is stoped.</string>
+    <string name="text_notincontacts">(Not In Contacts)</string>
+    <string name="text_appsettings">Settings</string>
+    <string name="text_ttsplaydelaytimes">TTS Play delay times(second) : </string>
+    <string name="msg_newsms">Received new message.</string>
+    <string name="msg_100sendmsg">&gt;&gt;&gt;Seek 100% To Send Message.&gt;&gt;&gt;</string>
+    <string name="msg_100applysettings">&gt;&gt;&gt;Seek 100% To Apply settings.&gt;&gt;&gt;</string>
+    <string-array name="strings_OnceAndroidStory">
+        <item>"I am here!"</item>
+        <item>"I think, I am here!"</item>
+    </string-array>
+</resources>
diff --git a/mymessagemanager/src/main/res/values/styles.xml b/mymessagemanager/src/main/res/values/styles.xml
new file mode 100644
index 0000000..07653e7
--- /dev/null
+++ b/mymessagemanager/src/main/res/values/styles.xml
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+	<style name="MyAppTheme" parent="AESTheme">
+        <item name="borderCornerRadius">6dp</item>
+        <item name="android:textSize">20sp</item>
+        <item name="android:windowBackground">@color/window_background</item>
+        <item name="android:textColorPrimary">@color/text_color_primary_default</item>
+        <item name="textColorPrimary">@color/text_color_primary_default</item>
+        <item name="android:textColor">@color/text_color_primary_default</item>
+        <item name="colorTextColor">@color/text_color_primary_default</item>
+        <item name="attrSMSViewSendColor">@color/colorSMSSendColor</item>
+        <item name="attrSMSViewInboxColor">@color/colorSMSInboxColor</item>
+        <item name="attrTTSRuleViewBackgroundColor">@color/colorTTSRuleViewBackgroundColor</item>
+	</style>
+
+
+    <style name="MyDepthAESTheme" parent="DepthAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:textSize">20sp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_depth</item>
+		<item name="textColorPrimary">@color/text_color_primary_depth</item>
+		<item name="android:textColor">@color/text_color_primary_depth</item>
+		<item name="colorTextColor">@color/text_color_primary_depth</item>
+		<item name="attrSMSViewSendColor">@color/colorSMSSendColorDepth</item>
+		<item name="attrSMSViewInboxColor">@color/colorSMSInboxColorDepth</item>
+		<item name="attrTTSRuleViewBackgroundColor">@color/colorTTSRuleViewBackgroundColorDepth</item>
+    </style>
+
+    <style name="MySkyAESTheme" parent="SkyAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:textSize">20sp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_sky</item>
+		<item name="textColorPrimary">@color/text_color_primary_sky</item>
+		<item name="android:textColor">@color/text_color_primary_sky</item>
+		<item name="colorTextColor">@color/text_color_primary_sky</item>
+		<item name="attrSMSViewSendColor">@color/colorSMSSendColorSky</item>
+		<item name="attrSMSViewInboxColor">@color/colorSMSInboxColorSky</item>
+		<item name="attrTTSRuleViewBackgroundColor">@color/colorTTSRuleViewBackgroundColorSky</item>
+    </style>
+
+    <style name="MyGoldenAESTheme" parent="GoldenAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:textSize">20sp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_golden</item>
+		<item name="textColorPrimary">@color/text_color_primary_golden</item>
+		<item name="android:textColor">@color/text_color_primary_golden</item>
+		<item name="colorTextColor">@color/text_color_primary_golden</item>
+		<item name="attrSMSViewSendColor">@color/colorSMSSendColorGolden</item>
+		<item name="attrSMSViewInboxColor">@color/colorSMSInboxColorGolden</item>
+		<item name="attrTTSRuleViewBackgroundColor">@color/colorTTSRuleViewBackgroundColorGolden</item>
+    </style>
+
+    <style name="MyMemorAESTheme" parent="MemorAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:textSize">20sp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_memor</item>
+		<item name="textColorPrimary">@color/text_color_primary_memor</item>
+		<item name="android:textColor">@color/text_color_primary_memor</item>
+		<item name="colorTextColor">@color/text_color_primary_memor</item>
+		<item name="attrSMSViewSendColor">@color/colorSMSSendColorMemor</item>
+		<item name="attrSMSViewInboxColor">@color/colorSMSInboxColorMemor</item>
+		<item name="attrTTSRuleViewBackgroundColor">@color/colorTTSRuleViewBackgroundColorMemor</item>
+    </style>
+
+    <style name="MyTaoAESTheme" parent="TaoAESTheme">
+		<item name="borderCornerRadius">6dp</item>
+		<item name="android:textSize">20sp</item>
+		<item name="android:windowBackground">@color/window_background</item>
+		<item name="android:textColorPrimary">@color/text_color_primary_tao</item>
+		<item name="textColorPrimary">@color/text_color_primary_tao</item>
+		<item name="android:textColor">@color/text_color_primary_tao</item>
+		<item name="colorTextColor">@color/text_color_primary_tao</item>
+		<item name="attrSMSViewSendColor">@color/colorSMSSendColorTao</item>
+		<item name="attrSMSViewInboxColor">@color/colorSMSInboxColorTao</item>
+		<item name="attrTTSRuleViewBackgroundColor">@color/colorTTSRuleViewBackgroundColorTao</item>
+    </style>
+
+</resources>
diff --git a/mymessagemanager/src/main/res/xml/file_provider.xml b/mymessagemanager/src/main/res/xml/file_provider.xml
new file mode 100644
index 0000000..a53d7e6
--- /dev/null
+++ b/mymessagemanager/src/main/res/xml/file_provider.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths>
+    <external-path
+        name="external_storage_root"
+        path="." />
+    <files-path
+        name="files-path"
+        path="." />
+    <cache-path
+        name="cache-path"
+        path="." />
+    <!--/storage/emulated/0/Android/data/...-->
+    <external-files-path
+        name="external_file_path"
+        path="." />
+    <!--代表app 外部存储区域根目录下的文件 Context.getExternalCacheDir目录下的目录-->
+    <external-cache-path
+        name="external_cache_path"
+        path="." />
+    <!--配置root-path。这样子可以读取到sd卡和一些应用分身的目录，否则微信分身保存的图片，就会导致 java.lang.IllegalArgumentException: Failed to find configured root that contains /storage/emulated/999/tencent/MicroMsg/WeiXin/export1544062754693.jpg，在小米6的手机上微信分身有这个crash，华为没有
+    -->
+    <root-path
+        name="root-path"
+        path="" />
+</paths>
diff --git a/mymessagemanager/src/main/res/xml/network_security_config.xml b/mymessagemanager/src/main/res/xml/network_security_config.xml
new file mode 100644
index 0000000..ee39aa4
--- /dev/null
+++ b/mymessagemanager/src/main/res/xml/network_security_config.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">winboll.cc</domain>
+    </domain-config>
+</network-security-config>
diff --git a/mymessagemanager/src/stage/AndroidManifest.xml b/mymessagemanager/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..7b53259
--- /dev/null
+++ b/mymessagemanager/src/stage/AndroidManifest.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="cc.winboll.studio.mymessagemanager.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+    </application>
+
+</manifest>
+
diff --git a/mymessagemanager/src/stage/res/values/strings.xml b/mymessagemanager/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/mymessagemanager/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/positions/.gitignore b/positions/.gitignore
new file mode 100644
index 0000000..42afabf
--- /dev/null
+++ b/positions/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/positions/README.md b/positions/README.md
new file mode 100644
index 0000000..3ee5c5f
--- /dev/null
+++ b/positions/README.md
@@ -0,0 +1,35 @@
+# Positions
+
+#### 介绍
+安卓位置应用，有关于地理位置的相关应用。
+PS:使用感言~~~『記低用唔到』。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh positions
+
+#### 使用说明
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/positions/app_update_description.txt b/positions/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/positions/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/positions/build.gradle b/positions/build.gradle
new file mode 100644
index 0000000..857f72e
--- /dev/null
+++ b/positions/build.gradle
@@ -0,0 +1,92 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	
+	// 关键：改为你已安装的 SDK 32（≥ targetSdkVersion 30，兼容已安装环境）
+    compileSdkVersion 32
+
+    // 直接使用已安装的构建工具 33.0.3（无需修改）
+    buildToolsVersion "33.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.positions"
+        minSdkVersion 23
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.12"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+	
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+}
+
+dependencies {
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //api 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+	
+	// 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'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+    // 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+    // AndroidX 类库
+    api 'androidx.appcompat:appcompat:1.1.0'
+    api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'
+    
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.9'
+    api 'cc.winboll.studio:libappbase:15.15.21'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.12.9'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.14.1'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/positions/build.properties b/positions/build.properties
new file mode 100644
index 0000000..815c1a4
--- /dev/null
+++ b/positions/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Mon May 04 11:31:30 HKT 2026
+stageCount=22
+libraryProject=
+baseVersion=15.12
+publishVersion=15.12.21
+buildCount=0
+baseBetaVersion=15.12.22
diff --git a/positions/proguard-rules.pro b/positions/proguard-rules.pro
new file mode 100644
index 0000000..855b18a
--- /dev/null
+++ b/positions/proguard-rules.pro
@@ -0,0 +1,143 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+# ============================== 必要补充规则 ==============================
+# OkHttp 4.4.1 补充规则（Java 7 兼容）
+-keep class okhttp3.internal.concurrent.** { *; }
+-keep class okhttp3.internal.connection.** { *; }
+-dontwarn okhttp3.internal.concurrent.TaskRunner
+-dontwarn okhttp3.internal.connection.RealCall
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/positions/src/beta/AndroidManifest.xml b/positions/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..d783f52
--- /dev/null
+++ b/positions/src/beta/AndroidManifest.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application
+		tools:replace="android:icon"
+        android:icon="@drawable/ic_launcher_beta">
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/positions/src/beta/res/values-zh/strings.xml b/positions/src/beta/res/values-zh/strings.xml
new file mode 100644
index 0000000..394a306
--- /dev/null
+++ b/positions/src/beta/res/values-zh/strings.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">悟空笔记#</string>
+    <string name="appplus_name">时空任务#</string>
+</resources>
diff --git a/positions/src/beta/res/values/strings.xml b/positions/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..5984bfd
--- /dev/null
+++ b/positions/src/beta/res/values/strings.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">Positions</string>
+    <string name="appplus_name">PositionsPlus+</string>
+
+</resources>
diff --git a/positions/src/beta/res/xml/file_provider.xml b/positions/src/beta/res/xml/file_provider.xml
new file mode 100644
index 0000000..802e4cc
--- /dev/null
+++ b/positions/src/beta/res/xml/file_provider.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths xmlns:android="http://schemas.android.com/apk/res/android">
+    <external-files-path
+        name="BaseBean"
+        path="BaseBean/" />
+</paths>
diff --git a/positions/src/beta/res/xml/shortcutsmain.xml b/positions/src/beta/res/xml/shortcutsmain.xml
new file mode 100644
index 0000000..08d8f99
--- /dev/null
+++ b/positions/src/beta/res/xml/shortcutsmain.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="open_appplus"
+        android:enabled="true"
+        android:icon="@mipmap/ic_launcher"
+        android:shortcutShortLabel="@string/open_appplus"
+        android:shortcutLongLabel="@string/open_appplus"
+        android:shortcutDisabledMessage="@string/appplus_open_disabled">
+        <intent
+            android:action="cc.winboll.studio.positions.App.ACTION_OPEN_APPPLUS"
+            android:targetPackage="cc.winboll.studio.positions.beta"
+            android:targetClass="cc.winboll.studio.positions.activities.ShortcutActionActivity"
+            android:data="open_appplus" />
+
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/positions/src/beta/res/xml/shortcutsplus.xml b/positions/src/beta/res/xml/shortcutsplus.xml
new file mode 100644
index 0000000..78616e4
--- /dev/null
+++ b/positions/src/beta/res/xml/shortcutsplus.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="close_appplus"
+        android:enabled="true"
+        android:icon="@mipmap/ic_launcher"
+        android:shortcutShortLabel="@string/close_appplus"
+        android:shortcutLongLabel="@string/close_appplus"
+        android:shortcutDisabledMessage="@string/appplus_close_disabled">
+        <intent
+            android:action="cc.winboll.studio.positions.App.ACTION_CLOSE_APPPLUS"
+            android:targetPackage="cc.winboll.studio.positions.beta"
+            android:targetClass="cc.winboll.studio.positions.activities.ShortcutActionActivity"
+            android:data="close_appplus" />
+
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/positions/src/main/AndroidManifest.xml b/positions/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..2c8e99c
--- /dev/null
+++ b/positions/src/main/AndroidManifest.xml
@@ -0,0 +1,164 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    package="cc.winboll.studio.positions">
+
+    <!-- 只有在前台运行时才能获取大致位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+
+    <!-- 在后台使用位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
+
+    <!-- 运行前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <!-- 运行“location”类型的前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION"/>
+
+    <!-- 拥有完全的网络访问权限 -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+
+    <!-- 安装快捷方式 -->
+    <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>
+
+    <!-- 读取您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <!-- 修改或删除您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <!-- 只能在前台获取精确的位置信息 -->
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
+
+    <uses-feature
+        android:name="android.hardware.location.gps"
+        android:required="false"/>
+
+    <application
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:resizeableActivity="true"
+        android:name=".App">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true">
+
+            <intent-filter>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+                <action android:name="android.intent.action.SEND"/>
+
+                <action android:name="android.intent.action.VIEW"/>
+
+                <action android:name="android.intent.action.EDIT"/>
+
+                <data android:mimeType="application/json"/>
+
+                <data android:mimeType="text/x-json"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity-alias
+            android:name=".MainActivityWukong"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmain"/>
+
+        </activity-alias>
+
+        <activity-alias
+            android:name=".MainActivityLaojun"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/appplus_name"
+            android:icon="@drawable/ic_positions_plus"
+            android:enabled="false">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsplus"/>
+
+        </activity-alias>
+
+        <activity android:name="cc.winboll.studio.positions.activities.LocationActivity"/>
+
+        <activity android:name="cc.winboll.studio.positions.activities.ShortcutActionActivity"/>
+
+        <service
+            android:name=".services.MainService"
+            android:exported="false"/>
+
+        <service
+            android:name=".services.AssistantService"
+            android:exported="false"/>
+
+        <service
+            android:name=".services.DistanceRefreshService"
+            android:exported="false"/>
+
+        <receiver android:name="cc.winboll.studio.positions.receivers.MotionStatusReceiver">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.positions.receivers.MotionStatusReceiver"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <meta-data
+            android:name="com.google.android.gms.version"
+            android:value="@integer/google_play_services_version"/>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+
+        <activity android:name="cc.winboll.studio.positions.activities.SettingsActivity"/>
+
+        <activity android:name="cc.winboll.studio.positions.activities.AboutActivity"/>
+
+    </application>
+
+</manifest>
\ No newline at end of file
diff --git a/positions/src/main/java/cc/winboll/studio/positions/App.java b/positions/src/main/java/cc/winboll/studio/positions/App.java
new file mode 100644
index 0000000..ded1168
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/App.java
@@ -0,0 +1,496 @@
+package cc.winboll.studio.positions;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.SharedPreferences;
+import android.content.pm.PackageInfo;
+import android.content.res.Resources;
+import android.graphics.Typeface;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+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.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.positions.services.MainService;
+
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Arrays;
+import java.util.Date;
+import java.util.LinkedHashMap;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+/**
+ * 全局Application应用入口类
+ * 功能概括：
+ * 1. 全局初始化管理、工具类框架初始化
+ * 2. 应用全局空转状态统一管理
+ * 3. IO读写通用工具封装
+ * 4. 全局崩溃捕获、崩溃日志本地保存、崩溃弹窗页面
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026/05/03 12:23:00
+ * @EditTime   2026/05/03 15:02:47
+ */
+public class App extends GlobalApplication {
+
+    //===================== 全局静态常量与变量 =====================
+    public static final String TAG = "App";
+    private static Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
+    private static App sInstance;
+
+    private static final String SP_NAME = "app_idle_config";
+    private static final String SP_KEY_IDLE_RUNNING = "is_idle_running";
+
+    // 应用全局空转状态标记
+    private static boolean isAppIdleRunning = false;
+
+    //===================== 空转状态对外方法 =====================
+    /**
+     * 获取当前应用空转运行状态
+     * @return 是否处于空转状态
+     */
+    public static boolean isAppIdleRunning() {
+        if (isAppIdleRunning) {
+            LogUtils.d(TAG, "isAppIdleRunning -> 当前应用处于空转运行状态");
+        }
+        return isAppIdleRunning;
+    }
+
+    /**
+     * 设置应用空转运行状态
+     * @param idleRunning 空转开关状态
+     */
+    public static void setAppIdleRunning(boolean idleRunning) {
+        LogUtils.d(TAG, "setAppIdleRunning -> 传入参数 idleRunning = " + idleRunning);
+        if (isDebugging()) {
+            isAppIdleRunning = idleRunning;
+            saveIdleRunningToSp(idleRunning);
+            LogUtils.i(TAG, "setAppIdleRunning -> 调试模式，空转状态设置生效并持久化");
+            
+            // 重启MainService服务以同步新的空转状态（stopService对未运行服务无效，故无需判断状态）
+            if (sInstance != null) {
+                LogUtils.i(TAG, "setAppIdleRunning -> 重启MainService服务以同步空转状态");
+                Intent serviceIntent = new Intent(sInstance, MainService.class);
+                sInstance.stopService(serviceIntent);
+                sInstance.startService(serviceIntent);
+            }
+        } else {
+            LogUtils.i(TAG, "setAppIdleRunning -> 非调试模式，空转设置无效");
+            LogUtils.i(TAG, "Non-debug state, app idle setting is meaningless.");
+        }
+    }
+
+    /**
+     * 从SharedPreferences加载空转状态
+     */
+    private static void loadIdleRunningFromSp() {
+        try {
+            if (sInstance != null) {
+                SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+                isAppIdleRunning = sp.getBoolean(SP_KEY_IDLE_RUNNING, false);
+                LogUtils.i(TAG, "loadIdleRunningFromSp -> 从SP加载空转状态：" + isAppIdleRunning);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "loadIdleRunningFromSp -> 加载空转状态失败：" + e.getMessage());
+            isAppIdleRunning = false;
+        }
+    }
+
+    /**
+     * 保存空转状态到SharedPreferences
+     * @param idleRunning 空转状态
+     */
+    private static void saveIdleRunningToSp(boolean idleRunning) {
+        try {
+            if (sInstance != null) {
+                SharedPreferences sp = sInstance.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+                sp.edit().putBoolean(SP_KEY_IDLE_RUNNING, idleRunning).apply();
+                LogUtils.i(TAG, "saveIdleRunningToSp -> 空转状态已保存：" + idleRunning);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "saveIdleRunningToSp -> 保存空转状态失败：" + e.getMessage());
+        }
+    }
+
+    //===================== 应用生命周期 =====================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        sInstance = this;
+        LogUtils.i(TAG, "onCreate -> 全局Application初始化开始");
+
+        setIsDebugging(BuildConfig.DEBUG);
+        WinBoLLActivityManager.init(this);
+        ToastUtils.init(this);
+
+        loadIdleRunningFromSp();
+
+        LogUtils.i(TAG, "onCreate -> 全局组件初始化全部完成");
+    }
+
+    //===================== IO通用工具方法 =====================
+    /**
+     * 流式读写输入输出流
+     * @param input 输入流
+     * @param output 输出流
+     * @throws IOException IO读写异常
+     */
+    public static void write(InputStream input, OutputStream output) throws IOException {
+        byte[] buf = new byte[1024 * 8];
+        int len;
+        while ((len = input.read(buf)) != -1) {
+            output.write(buf, 0, len);
+        }
+    }
+
+    /**
+     * 将字节数组写入指定文件
+     * @param file 目标文件
+     * @param data 字节数据
+     * @throws IOException IO读写异常
+     */
+    public static void write(File file, byte[] data) throws IOException {
+        File parent = file.getParentFile();
+        if (parent != null && !parent.exists()) {
+            parent.mkdirs();
+        }
+
+        ByteArrayInputStream input = new ByteArrayInputStream(data);
+        FileOutputStream output = new FileOutputStream(file);
+        try {
+            write(input, output);
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    /**
+     * 输入流转为UTF-8字符串
+     * @param input 输入流
+     * @return 转换后的文本
+     * @throws IOException IO读写异常
+     */
+    public static String toString(InputStream input) throws IOException {
+        ByteArrayOutputStream output = new ByteArrayOutputStream();
+        write(input, output);
+        try {
+            return output.toString("UTF-8");
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    /**
+     * 批量关闭IO流
+     * @param closeables 可关闭对象
+     */
+    public static void closeIO(Closeable... closeables) {
+        for (Closeable closeable : closeables) {
+            try {
+                if (closeable != null) {
+                    closeable.close();
+                }
+            } catch (IOException ignored) {
+
+            }
+        }
+    }
+
+    //===================== 全局崩溃捕获管理类 =====================
+    public static class CrashHandler {
+
+        public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+        private static CrashHandler sInstance;
+        private PartCrashHandler mPartCrashHandler;
+
+        public static CrashHandler getInstance() {
+            if (sInstance == null) {
+                sInstance = new CrashHandler();
+            }
+            return sInstance;
+        }
+
+        /**
+         * 注册全局崩溃捕获
+         */
+        public void registerGlobal(Context context) {
+            registerGlobal(context, null);
+        }
+
+        /**
+         * 注册全局崩溃并自定义崩溃日志保存目录
+         * @param crashDir 崩溃日志路径
+         */
+        public void registerGlobal(Context context, String crashDir) {
+            LogUtils.d(TAG, "CrashHandler -> 注册全局异常捕获器");
+            Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandlerImpl(context.getApplicationContext(), crashDir));
+        }
+
+        /**
+         * 解除全局崩溃捕获
+         */
+        public void unregister() {
+            LogUtils.d(TAG, "CrashHandler -> 解除全局异常捕获");
+            Thread.setDefaultUncaughtExceptionHandler(DEFAULT_UNCAUGHT_EXCEPTION_HANDLER);
+        }
+
+        /**
+         * 注册局部前台异常捕获
+         */
+        public void registerPart(Context context) {
+            unregisterPart(context);
+            mPartCrashHandler = new PartCrashHandler(context.getApplicationContext());
+            MAIN_HANDLER.postAtFrontOfQueue(mPartCrashHandler);
+            LogUtils.d(TAG, "CrashHandler -> 局部异常监听已注册");
+        }
+
+        /**
+         * 解除局部异常捕获
+         */
+        public void unregisterPart(Context context) {
+            if (mPartCrashHandler != null) {
+                mPartCrashHandler.isRunning.set(false);
+                mPartCrashHandler = null;
+                LogUtils.d(TAG, "CrashHandler -> 局部异常监听已销毁");
+            }
+        }
+
+        /**
+         * 局部前台Looper异常捕获
+         */
+        private static class PartCrashHandler implements Runnable {
+            private final Context mContext;
+            public AtomicBoolean isRunning = new AtomicBoolean(true);
+
+            public PartCrashHandler(Context context) {
+                this.mContext = context;
+            }
+
+            @Override
+            public void run() {
+                while (isRunning.get()) {
+                    try {
+                        Looper.loop();
+                    } catch (final Throwable e) {
+                        if (isRunning.get()) {
+                            MAIN_HANDLER.post(new Runnable() {
+									@Override
+									public void run() {
+										Toast.makeText(mContext, e.toString(), Toast.LENGTH_LONG).show();
+									}
+								});
+                        } else {
+                            if (e instanceof RuntimeException) {
+                                throw (RuntimeException) e;
+                            } else {
+                                throw new RuntimeException(e);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        /**
+         * 全局未捕获异常处理实现
+         */
+        private static class UncaughtExceptionHandlerImpl implements UncaughtExceptionHandler {
+            private static DateFormat DATE_FORMAT = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss");
+            private final Context mContext;
+            private final File mCrashDir;
+
+            public UncaughtExceptionHandlerImpl(Context context, String crashDir) {
+                this.mContext = context;
+                this.mCrashDir = TextUtils.isEmpty(crashDir) ? new File(mContext.getExternalCacheDir(), "crash") : new File(crashDir);
+            }
+
+            @Override
+            public void uncaughtException(Thread thread, Throwable throwable) {
+                try {
+                    String log = buildLog(throwable);
+                    writeLog(log);
+
+                    Intent intent = new Intent(mContext, CrashActivity.class);
+                    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                    intent.putExtra(Intent.EXTRA_TEXT, log);
+                    mContext.startActivity(intent);
+
+                    android.os.Process.killProcess(android.os.Process.myPid());
+                    System.exit(0);
+                } catch (Throwable e) {
+                    if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) {
+                        DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+                    }
+                }
+            }
+
+            /**
+             * 组装崩溃详细日志信息
+             */
+            private String buildLog(Throwable throwable) {
+                String time = DATE_FORMAT.format(new Date());
+                String versionName = "unknown";
+                long versionCode = 0;
+
+                try {
+                    PackageInfo packageInfo = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0);
+                    versionName = packageInfo.versionName;
+                    versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+                } catch (Throwable ignored) {
+
+                }
+
+                LinkedHashMap<String, String> head = new LinkedHashMap<String, String>();
+                head.put("Time Of Crash", time);
+                head.put("Device", String.format("%s, %s", Build.MANUFACTURER, Build.MODEL));
+                head.put("Android Version", String.format("%s (%d)", Build.VERSION.RELEASE, Build.VERSION.SDK_INT));
+                head.put("App Version", String.format("%s (%d)", versionName, versionCode));
+                head.put("Kernel", getKernel());
+                head.put("Support Abis", Build.VERSION.SDK_INT >= 21 && Build.SUPPORTED_ABIS != null ? Arrays.toString(Build.SUPPORTED_ABIS) : "unknown");
+                head.put("Fingerprint", Build.FINGERPRINT);
+
+                StringBuilder builder = new StringBuilder();
+                for (String key : head.keySet()) {
+                    if (builder.length() != 0) {
+                        builder.append("\n");
+                    }
+                    builder.append(key);
+                    builder.append(" :    ");
+                    builder.append(head.get(key));
+                }
+                builder.append("\n\n");
+                builder.append(throwable.toString());
+
+                return builder.toString();
+            }
+
+            /**
+             * 写入崩溃日志到本地文件
+             */
+            private void writeLog(String log) {
+                String time = DATE_FORMAT.format(new Date());
+                File file = new File(mCrashDir, "crash_" + time + ".txt");
+                try {
+                    write(file, log.getBytes("UTF-8"));
+                    LogUtils.d(TAG, "崩溃日志已保存至本地文件");
+                } catch (Throwable e) {
+                    LogUtils.e(TAG, "崩溃日志写入失败");
+                }
+            }
+
+            /**
+             * 获取系统内核版本信息
+             */
+            private static String getKernel() {
+                try {
+                    return App.toString(new FileInputStream("/proc/version")).trim();
+                } catch (Throwable e) {
+                    return e.getMessage();
+                }
+            }
+        }
+    }
+
+    //===================== 崩溃展示页面 =====================
+    public static final class CrashActivity extends Activity {
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+            LogUtils.i(TAG, "CrashActivity -> 崩溃展示页面已启动");
+
+            setTheme(android.R.style.Theme_DeviceDefault);
+            setTitle("App Crash");
+            mLog = getIntent().getStringExtra(Intent.EXTRA_TEXT);
+
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+            HorizontalScrollView horizontalScrollView = new HorizontalScrollView(this);
+
+            TextView textView = new TextView(this);
+            int padding = dp2px(16);
+            textView.setPadding(padding, padding, padding, padding);
+            textView.setText(mLog);
+            textView.setTextIsSelectable(true);
+            textView.setTypeface(Typeface.DEFAULT);
+            textView.setLinksClickable(true);
+
+            horizontalScrollView.addView(textView);
+            contentView.addView(horizontalScrollView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+            setContentView(contentView);
+        }
+
+        /**
+         * 重启当前应用
+         */
+        private void restart() {
+            Intent intent = getPackageManager().getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        /**
+         * dp转px通用方法
+         */
+        private static int dp2px(float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(Menu menu) {
+            menu.add(0, android.R.id.copy, 0, android.R.string.copy)
+				.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+            return super.onCreateOptionsMenu(menu);
+        }
+
+        @Override
+        public boolean onOptionsItemSelected(MenuItem item) {
+            if (item.getItemId() == android.R.id.copy) {
+                ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+                cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+                LogUtils.d(TAG, "CrashActivity -> 崩溃日志已复制到剪贴板");
+                return true;
+            }
+            return super.onOptionsItemSelected(item);
+        }
+
+        @Override
+        public void onBackPressed() {
+            restart();
+        }
+    }
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/MainActivity.java b/positions/src/main/java/cc/winboll/studio/positions/MainActivity.java
new file mode 100644
index 0000000..1b26d54
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/MainActivity.java
@@ -0,0 +1,403 @@
+package cc.winboll.studio.positions;
+
+import android.Manifest;
+import android.app.Activity;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.content.res.TypedArray;
+import android.graphics.Color;
+import android.os.Build;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.CompoundButton;
+import android.widget.LinearLayout;
+import android.widget.ScrollView;
+import android.widget.Switch;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import androidx.annotation.NonNull;
+import androidx.appcompat.widget.Toolbar;
+import androidx.core.content.ContextCompat;
+
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.DevelopUtils;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.positions.activities.AboutActivity;
+import cc.winboll.studio.positions.activities.LocationActivity;
+import cc.winboll.studio.positions.activities.SettingsActivity;
+import cc.winboll.studio.positions.activities.WinBoLLActivity;
+import cc.winboll.studio.positions.handlers.AppIdleRunningModeHandler;
+import cc.winboll.studio.positions.utils.AppConfigsUtil;
+import cc.winboll.studio.positions.utils.ServiceUtil;
+import cc.winboll.studio.positions.services.IdleGpsService;
+import cc.winboll.studio.positions.services.MainService;
+import cc.winboll.studio.positions.R;
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Handler;
+import android.os.Handler;
+import android.os.Looper;
+import android.content.Intent;
+import android.os.Handler;
+
+/**
+ * 主页面控制器
+ * 功能简述：
+ * 1. 位置服务启停开关控制
+ * 2. 页面菜单跳转与主题管理
+ * 3. 应用空转状态接收与日志实时输出展示
+ * 4. 全局权限申请与权限结果回调处理
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026/05/03 12:23:00
+ * @EditTime   2026/05/03 15:42:15
+ */
+public class MainActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    // ===================== 常量定义 =====================
+    public static final String TAG = "MainActivity";
+    private static final int REQUEST_LOCATION_PERMISSIONS = 1001;
+    private static final int REQUEST_BACKGROUND_LOCATION_PERMISSION = 1002;
+
+    // ===================== UI控件声明 =====================
+    private Toolbar mToolbar;
+    private Switch mServiceSwitch;
+    private Button mManagePositionsButton;
+    private ADsBannerView mADsBannerView;
+    private TextView mTvIdleLog;
+    private ScrollView mScrollIdleLog;
+
+    // ===================== 业务标记与回调 =====================
+    private boolean isServiceBound = false;
+    private OnAppIdleRunningListener mIdleRunningListener;
+
+    /**
+     * 应用空转状态回调内部接口
+     */
+    public interface OnAppIdleRunningListener {
+        void onIdleStatusChange(boolean isRunning);
+        void onIdleLogReceive(String log);
+    }
+
+    // ===================== 回调绑定方法 =====================
+    public void setOnAppIdleRunningListener(OnAppIdleRunningListener listener) {
+        this.mIdleRunningListener = listener;
+        LogUtils.i(TAG, "setOnAppIdleRunningListener -> 空转监听绑定完成");
+    }
+
+    public OnAppIdleRunningListener getOnAppIdleRunningListener() {
+        return mIdleRunningListener;
+    }
+
+    // ===================== 生命周期重写 =====================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        LogUtils.i(TAG, "onCreate -> MainActivity页面创建完成");
+
+        initToolbar();
+        initViews();
+        setLLMainBackgroundColor();
+
+        if (!checkLocationPermissions()) {
+            LogUtils.d(TAG, "onCreate -> 定位权限未授予，发起权限申请");
+            requestLocationPermissions();
+        }
+
+        mADsBannerView = findViewById(R.id.adsbanner);
+        initAppIdleHandler();
+        refreshIdleLogLayout();
+
+        // 根据调试模式控制日志区域的显示
+        if (App.isDebugging()) {
+            mScrollIdleLog.setVisibility(View.VISIBLE);
+            LogUtils.d(TAG, "onCreate -> 调试模式，显示日志区域");
+        } else {
+            mScrollIdleLog.setVisibility(View.GONE);
+            LogUtils.d(TAG, "onCreate -> 非调试模式，隐藏日志区域");
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume -> 页面恢复可见");
+        if (App.isAppIdleRunning()) {
+            IdleGpsService.getInstance().start();
+        }
+        if (mADsBannerView != null) {
+            mADsBannerView.resumeADs(MainActivity.this);
+        }
+        // 重新加载菜单以根据当前调试状态刷新
+        invalidateOptionsMenu();
+        LogUtils.d(TAG, "onResume -> 重新加载菜单完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.i(TAG, "onDestroy -> MainActivity页面销毁释放资源");
+        if (mADsBannerView != null) {
+            mADsBannerView.releaseAdResources();
+        }
+        mIdleRunningListener = null;
+    }
+
+    // ===================== 初始化相关方法 =====================
+    private void initToolbar() {
+        mToolbar = (Toolbar) findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        if (getSupportActionBar() != null) {
+            getSupportActionBar().setTitle(getString(R.string.app_name));
+        }
+        LogUtils.d(TAG, "initToolbar -> 顶部工具栏初始化完毕");
+    }
+
+    private void initViews() {
+        mTvIdleLog = (TextView) findViewById(R.id.tv_idle_log);
+        mScrollIdleLog = (ScrollView) findViewById(R.id.scroll_idle_log);
+        mServiceSwitch = (Switch) findViewById(R.id.switch_service_control);
+        mManagePositionsButton = (Button) findViewById(R.id.btn_manage_positions);
+
+        boolean serviceEnable = AppConfigsUtil.getInstance(this).isEnableMainService(true);
+        mServiceSwitch.setChecked(serviceEnable);
+        mManagePositionsButton.setEnabled(serviceEnable);
+
+        mServiceSwitch.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
+				@Override
+				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
+                    //切换开关时先校验权限，无权限直接强制关闭开关
+					if(isChecked && !checkLocationPermissions()){
+                        mServiceSwitch.setChecked(false);
+                        Toast.makeText(MainActivity.this,"未获取定位权限，无法开启GPS服务",Toast.LENGTH_SHORT).show();
+                        return;
+                    }
+
+					LogUtils.d(TAG, "onCheckedChanged -> 服务开关状态变更，isChecked = " + isChecked);
+					if (isChecked) {
+						ServiceUtil.startAutoService(MainActivity.this);
+					} else {
+						ServiceUtil.stopAutoService(MainActivity.this);
+					}
+					mManagePositionsButton.setEnabled(isChecked);
+                    refreshManageButtonState();
+				}
+			});
+        LogUtils.i(TAG, "initViews -> 全部UI控件初始化绑定完成");
+    }
+
+    private void initAppIdleHandler() {
+        AppIdleRunningModeHandler.init(MainActivity.this);
+        setOnAppIdleRunningListener(new OnAppIdleRunningListener() {
+				@Override
+				public void onIdleStatusChange(boolean isRunning) {
+					refreshIdleLogLayout();
+					appendIdleLog("IdleRunning Status : " + isRunning);
+				}
+
+				@Override
+				public void onIdleLogReceive(String log) {
+					appendIdleLog(log);
+				}
+			});
+        LogUtils.i(TAG, "initAppIdleHandler -> 空转处理器初始化与监听绑定完成");
+    }
+
+    private void setLLMainBackgroundColor() {
+        TypedArray typedArray = getTheme().obtainStyledAttributes(new int[]{android.R.attr.colorAccent});
+        int colorAccent = typedArray.getColor(0, Color.GRAY);
+        typedArray.recycle();
+        LinearLayout llmain = findViewById(R.id.llmain);
+        llmain.setBackgroundColor(colorAccent);
+    }
+
+    // ===================== 空转日志输出工具 =====================
+    private void appendIdleLog(final String logText) {
+        runOnUiThread(new Runnable() {
+				@Override
+				public void run() {
+					String allLog = mTvIdleLog.getText().toString();
+					mTvIdleLog.setText(allLog + logText + "\n");
+					mScrollIdleLog.post(new Runnable() {
+							@Override
+							public void run() {
+								mScrollIdleLog.fullScroll(ScrollView.FOCUS_DOWN);
+							}
+						});
+				}
+			});
+    }
+
+    private void refreshIdleLogLayout() {
+        runOnUiThread(new Runnable() {
+				@Override
+				public void run() {
+					if (App.isAppIdleRunning()) {
+						mScrollIdleLog.setBackgroundResource(R.drawable.shape_log_border);
+					} else {
+                        //关闭空转时：检测权限，无权限强制关闭GPS开关
+                        if(!checkLocationPermissions()){
+                            mServiceSwitch.setChecked(false);
+                            ServiceUtil.stopAutoService(MainActivity.this);
+                        }
+						mTvIdleLog.setText("");
+						mScrollIdleLog.setBackgroundColor(Color.TRANSPARENT);
+						LogUtils.d(TAG, "refreshIdleLogLayout -> 非空转状态：日志清空、边框已移除");
+					}
+                    refreshToolbarSubTitle();
+                    refreshManageButtonState();
+				}
+			});
+    }
+
+    private void refreshToolbarSubTitle() {
+        if(getSupportActionBar() == null){
+            return;
+        }
+        if(App.isAppIdleRunning()){
+            getSupportActionBar().setSubtitle("当前处于空转运行状态");
+        }else{
+            getSupportActionBar().setSubtitle("");
+        }
+    }
+
+    /**
+     * 空转状态专属：按钮强制可点击 + 文字追加提示
+     */
+    private void refreshManageButtonState() {
+        runOnUiThread(new Runnable() {
+				@Override
+				public void run() {
+					if (App.isAppIdleRunning()) {
+						mManagePositionsButton.setText("位置与任务管理【当前空转中】");
+						mManagePositionsButton.setEnabled(true);
+					} else {
+						mManagePositionsButton.setText("位置与任务管理");
+						boolean serviceEnable = AppConfigsUtil.getInstance(MainActivity.this).isEnableMainService(true);
+						mManagePositionsButton.setEnabled(serviceEnable);
+					}
+				}
+			});
+    }
+
+    // ===================== 权限处理相关 =====================
+    private boolean checkLocationPermissions() {
+        int foregroundPerm = checkSelfPermission(Manifest.permission.ACCESS_FINE_LOCATION);
+        boolean hasForegroundPerm = (foregroundPerm == PackageManager.PERMISSION_GRANTED);
+        boolean hasBackgroundPerm = true;
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            int backgroundPerm = checkSelfPermission(Manifest.permission.ACCESS_BACKGROUND_LOCATION);
+            hasBackgroundPerm = (backgroundPerm == PackageManager.PERMISSION_GRANTED);
+        }
+        return hasForegroundPerm && hasBackgroundPerm;
+    }
+
+    private void requestLocationPermissions() {
+        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
+			!= PackageManager.PERMISSION_GRANTED) {
+            String[] foregroundPermissions = new String[]{Manifest.permission.ACCESS_FINE_LOCATION};
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+                requestPermissions(foregroundPermissions, REQUEST_LOCATION_PERMISSIONS);
+            }
+        } else {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_BACKGROUND_LOCATION)
+					!= PackageManager.PERMISSION_GRANTED) {
+                    requestPermissions(new String[]{Manifest.permission.ACCESS_BACKGROUND_LOCATION},
+									   REQUEST_BACKGROUND_LOCATION_PERMISSION);
+                }
+            }
+        }
+    }
+
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        LogUtils.d(TAG, "onRequestPermissionsResult -> 权限回调 requestCode = " + requestCode);
+
+        if (requestCode == REQUEST_LOCATION_PERMISSIONS) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                requestLocationPermissions();
+            } else {
+                Toast.makeText(this, "需要前台定位权限才能使用该功能", Toast.LENGTH_SHORT).show();
+                //权限被拒绝，强制关闭开关
+                mServiceSwitch.setChecked(false);
+                ServiceUtil.stopAutoService(MainActivity.this);
+                mManagePositionsButton.setEnabled(false);
+            }
+        } else if (requestCode == REQUEST_BACKGROUND_LOCATION_PERMISSION) {
+            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                Toast.makeText(this, "已获得后台定位权限", Toast.LENGTH_SHORT).show();
+            } else {
+                Toast.makeText(this, "拒绝后台权限将无法在后台持续定位", Toast.LENGTH_SHORT).show();
+            }
+        }
+    }
+
+    // ===================== 菜单与页面跳转 =====================
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        AESThemeUtil.inflateMenu(this, menu);
+        if (App.isDebugging()) {
+            DevelopUtils.inflateMenu(this, menu);
+            getMenuInflater().inflate(R.menu.toolbar_main_idle, menu);
+        }
+        getMenuInflater().inflate(R.menu.toolbar_main, menu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        int menuItemId = item.getItemId();
+        LogUtils.d(TAG, "onOptionsItemSelected -> 点击菜单ID = " + menuItemId);
+
+        if (AESThemeUtil.onAppThemeItemSelected(this, item)) {
+            recreate();
+        } else if (DevelopUtils.onDevelopItemSelected(this, item)) {
+            LogUtils.d(TAG, "onOptionsItemSelected -> 进入开发工具菜单");
+        } else if (menuItemId == R.id.item_idle_switch) {
+            boolean idleNow = App.isAppIdleRunning();
+            boolean idleNew = !idleNow;
+            App.setAppIdleRunning(idleNew);
+            AppIdleRunningModeHandler.sendIdleSwitch(idleNew);
+            AppIdleRunningModeHandler.sendIdleLog("菜单手动切换空转状态：" + idleNew);
+            LogUtils.d(TAG, "onOptionsItemSelected -> 空转状态已切换，当前：" + idleNew);
+            refreshIdleLogLayout();
+        } else if (menuItemId == R.id.item_settings) {
+            Intent intent = new Intent();
+            intent.setClass(this, SettingsActivity.class);
+            startActivity(intent);
+        } else if (menuItemId == R.id.item_about) {
+            Intent intent = new Intent();
+            intent.setClass(this, AboutActivity.class);
+            startActivity(intent);
+        } else {
+            return super.onOptionsItemSelected(item);
+        }
+        return true;
+    }
+
+    public void onPositions(View view) {
+        LogUtils.d(TAG, "onPositions -> 跳转位置任务管理页面");
+        startActivity(new Intent(MainActivity.this, LocationActivity.class));
+    }
+
+    // ===================== 接口实现 =====================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/activities/AboutActivity.java b/positions/src/main/java/cc/winboll/studio/positions/activities/AboutActivity.java
new file mode 100644
index 0000000..ef47cce
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/activities/AboutActivity.java
@@ -0,0 +1,81 @@
+package cc.winboll.studio.positions.activities;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+import cc.winboll.studio.positions.R;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/13 11:25
+ * @Describe 应用介绍窗口
+ */
+public class AboutActivity extends WinBoLLActivity {
+
+    public static final String TAG = "AboutActivity";
+	private Toolbar mToolbar;
+	@Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+	
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+		// 设置工具栏
+        initToolbar();
+
+		AboutView aboutView = findViewById(R.id.aboutview);
+		aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+	
+	private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+	private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "positions";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName(getString(R.string.app_name));
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("Positions");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=Positions");
+        appInfo.setAppAPKName("Positions");
+        appInfo.setAppAPKFolderName("Positions");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/activities/LocationActivity.java b/positions/src/main/java/cc/winboll/studio/positions/activities/LocationActivity.java
new file mode 100644
index 0000000..412f826
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/activities/LocationActivity.java
@@ -0,0 +1,487 @@
+package cc.winboll.studio.positions.activities;
+
+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.view.inputmethod.InputMethodManager;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.positions.App;
+import cc.winboll.studio.positions.MainActivity;
+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.services.IdleGpsService;
+import cc.winboll.studio.positions.services.MainService;
+
+import java.text.SimpleDateFormat;
+import java.util.ArrayList;
+import java.util.Date;
+import java.util.Locale;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025/09/29 18:22:00
+ * @EditTime 2026/05/03 16:36:54
+ * @Describe 位置列表页面，适配MainService GPS接口、规范服务交互、完善生命周期资源释放，新增应用空转状态副标题提示
+ */
+public class LocationActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // 常量
+    public static final String TAG = "LocationActivity";
+
+    // 成员属性有序排版
+    private Toolbar mToolbar;
+    private RecyclerView mRvPosition;
+    private PositionAdapter mPositionAdapter;
+
+    private MainService mMainService;
+    private final AtomicBoolean isServiceBound = new AtomicBoolean(false);
+    private final AtomicBoolean isAdapterInited = new AtomicBoolean(false);
+
+    private MainService.GpsUpdateListener mGpsUpdateListener;
+    private PositionModel mCurrentGpsPos;
+    private final ArrayList<PositionModel> mLocalPosCache = new ArrayList<PositionModel>();
+
+    // 服务连接回调
+    private final ServiceConnection mServiceConnection = new ServiceConnection() {
+        @Override
+        public void onServiceConnected(final ComponentName name, final IBinder service) {
+            LogUtils.d(TAG, "onServiceConnected invoke");
+            if (!(service instanceof MainService.LocalBinder)) {
+                LogUtils.e(TAG, "服务绑定失败：Binder类型不匹配");
+                isServiceBound.set(false);
+                return;
+            }
+
+            try {
+                final MainService.LocalBinder binder = (MainService.LocalBinder) service;
+                mMainService = binder.getService();
+                isServiceBound.set(true);
+                LogUtils.d(TAG, "MainService bind success");
+
+                syncDataFromMainService();
+                registerGpsListener();
+                initPositionAdapter();
+            } catch (final Exception e) {
+                LogUtils.e(TAG, "服务绑定异常：" + e.getMessage());
+                isServiceBound.set(false);
+                mMainService = null;
+                showToast("服务初始化失败，无法加载数据");
+            }
+        }
+
+        @Override
+        public void onServiceDisconnected(final ComponentName name) {
+            LogUtils.w(TAG, "MainService 服务断开");
+            mMainService = null;
+            isServiceBound.set(false);
+            isAdapterInited.set(false);
+        }
+    };
+
+    // 接口方法实现
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    /**
+     * 刷新空转状态副标题
+     */
+    private void refreshIdleStatusTitle() {
+        LogUtils.d(TAG, "refreshIdleStatusTitle invoke");
+        if (mToolbar == null) {
+            LogUtils.w(TAG, "Toolbar为空，跳过刷新");
+            return;
+        }
+        final boolean idleStatus = App.isAppIdleRunning();
+        if (idleStatus) {
+            mToolbar.setSubtitle("当前状态：应用正在空转运行");
+            LogUtils.d(TAG, "检测应用空转状态为 : " + idleStatus);
+        } else {
+            mToolbar.setSubtitle(getTag());
+        }
+    }
+
+    /**
+     * 初始化页面控件
+     */
+    private void initView() {
+        LogUtils.d(TAG, "initView invoke");
+        mRvPosition = findViewById(R.id.rv_position_list);
+        final LinearLayoutManager layoutManager = new LinearLayoutManager(this);
+        layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
+        mRvPosition.setLayoutManager(layoutManager);
+        mLocalPosCache.clear();
+    }
+
+    /**
+     * 绑定后台服务
+     */
+    private void bindMainService() {
+        LogUtils.d(TAG, "bindMainService invoke");
+        if (isServiceBound.get()) {
+            LogUtils.w(TAG, "服务已绑定，无需重复执行");
+            return;
+        }
+        final Intent serviceIntent = new Intent(this, MainService.class);
+        final boolean bindSuccess = bindService(serviceIntent, mServiceConnection, BIND_AUTO_CREATE);
+        if (!bindSuccess) {
+            LogUtils.e(TAG, "发起服务绑定请求失败");
+            showToast("服务绑定失败，无法加载位置数据");
+        }
+    }
+
+    /**
+     * 同步服务数据至本地缓存
+     */
+    private void syncDataFromMainService() {
+        LogUtils.d(TAG, "syncDataFromMainService invoke");
+        if (!isServiceBound.get() || mMainService == null) {
+            LogUtils.w(TAG, "服务未就绪，使用本地缓存");
+            return;
+        }
+        try {
+            final ArrayList<PositionModel> servicePosList = mMainService.getPositionList();
+            synchronized (mLocalPosCache) {
+                mLocalPosCache.clear();
+                if (servicePosList != null && !servicePosList.isEmpty()) {
+                    mLocalPosCache.addAll(servicePosList);
+                }
+            }
+            LogUtils.d(TAG, "同步完成，缓存数量 : " + mLocalPosCache.size());
+        } catch (final Exception e) {
+            LogUtils.e(TAG, "数据同步异常 : " + e.getMessage());
+        }
+    }
+
+    /**
+     * 初始化列表适配器
+     */
+    private void initPositionAdapter() {
+        LogUtils.d(TAG, "initPositionAdapter invoke");
+        if (isAdapterInited.get() || !isServiceBound.get()
+			|| mMainService == null || mRvPosition == null) {
+            LogUtils.w(TAG, "适配器初始化条件不满足，跳过");
+            return;
+        }
+
+        try {
+            mPositionAdapter = new PositionAdapter(this, mLocalPosCache, mMainService);
+            mPositionAdapter.setOnDeleteClickListener(new PositionAdapter.OnDeleteClickListener() {
+					@Override
+					public void onDeleteClick(final int position) {
+						LogUtils.d(TAG, "onDeleteClick position = " + position);
+						YesNoAlertDialog.show(LocationActivity.this, "删除位置提示",
+                            "是否删除此项锚点位置？", new YesNoAlertDialog.OnDialogResultListener() {
+                                @Override
+                                public void onNo() {
+
+                                }
+
+                                @Override
+                                public void onYes() {
+                                    if (position < 0 || position >= mLocalPosCache.size()) {
+                                        LogUtils.w(TAG, "删除索引参数非法");
+                                        return;
+                                    }
+                                    final PositionModel deletePos = mLocalPosCache.get(position);
+                                    if (deletePos != null && !deletePos.getPositionId().isEmpty()) {
+                                        mMainService.removePosition(deletePos.getPositionId());
+                                        synchronized (mLocalPosCache) {
+                                            mLocalPosCache.remove(position);
+                                        }
+                                        mPositionAdapter.notifyItemRemoved(position);
+                                        showToast("删除位置成功：" + deletePos.getMemo());
+                                    }
+                                }
+                            });
+					}
+				});
+
+            mPositionAdapter.setOnSavePositionClickListener(new PositionAdapter.OnSavePositionClickListener() {
+					@Override
+					public void onSavePositionClick(final int position, final PositionModel updatedPos) {
+						LogUtils.d(TAG, "onSavePositionClick position = " + position);
+						if (position < 0 || position >= mLocalPosCache.size() || updatedPos == null) {
+							LogUtils.w(TAG, "保存参数非法");
+							showToast("服务未就绪，保存失败");
+							return;
+						}
+						mMainService.updatePosition(updatedPos);
+						synchronized (mLocalPosCache) {
+							mLocalPosCache.set(position, updatedPos);
+						}
+						mPositionAdapter.notifyItemChanged(position);
+						showToast("保存位置成功：" + updatedPos.getMemo());
+					}
+				});
+
+            mRvPosition.setAdapter(mPositionAdapter);
+            isAdapterInited.set(true);
+            LogUtils.d(TAG, "适配器初始化完成");
+        } catch (final Exception e) {
+            LogUtils.e(TAG, "适配器初始化异常 : " + e.getMessage());
+            isAdapterInited.set(false);
+            mPositionAdapter = null;
+            showToast("位置列表初始化失败，请重试");
+        }
+    }
+
+    /**
+     * 通用Toast弹窗
+     */
+    private void showToast(final String content) {
+        if (isFinishing() || isDestroyed()) {
+            LogUtils.w(TAG, "页面已销毁，取消Toast");
+            return;
+        }
+        Toast.makeText(this, content, Toast.LENGTH_SHORT).show();
+    }
+
+    /**
+     * 新增位置按钮事件
+     */
+    public void addNewPosition(final View view) {
+        LogUtils.d(TAG, "addNewPosition invoke");
+        final InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
+        if (imm != null && getCurrentFocus() != null) {
+            imm.hideSoftInputFromWindow(getCurrentFocus().getWindowToken(), 0);
+        }
+
+        if (!isServiceBound.get() || mMainService == null) {
+            LogUtils.w(TAG, "服务未绑定，无法新增");
+            showToast("服务未就绪，无法新增位置");
+            return;
+        }
+
+        final PositionModel newPos = new PositionModel();
+        newPos.setPositionId(PositionModel.genPositionId());
+        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);
+
+        mMainService.addPosition(newPos);
+        synchronized (mLocalPosCache) {
+            mLocalPosCache.add(newPos);
+        }
+        LogUtils.d(TAG, "新增位置成功，ID : " + newPos.getPositionId());
+
+        if (isAdapterInited.get() && mPositionAdapter != null) {
+            mPositionAdapter.notifyItemInserted(mLocalPosCache.size() - 1);
+        }
+        showToast("新增位置成功（已启用GPS距离计算）");
+    }
+
+    /**
+     * 初始化GPS监听实例
+     */
+    private void initGpsUpdateListener() {
+        LogUtils.d(TAG, "initGpsUpdateListener invoke");
+        mGpsUpdateListener = new MainService.GpsUpdateListener() {
+            @Override
+            public void onGpsPositionUpdated(final PositionModel currentGpsPos) {
+                if (currentGpsPos == null || isFinishing() || isDestroyed()) {
+                    return;
+                }
+                mCurrentGpsPos = currentGpsPos;
+                LogUtils.d(TAG, "GPS更新 -> 纬度:" + currentGpsPos.getLatitude() + " 经度:" + currentGpsPos.getLongitude());
+
+                final TextView tvLat = (TextView) findViewById(R.id.tv_latitude);
+                final TextView tvLon = (TextView) findViewById(R.id.tv_longitude);
+                final TextView tvTime = (TextView) findViewById(R.id.tv_timenow);
+
+                tvLat.setText(String.format("当前纬度：%f", currentGpsPos.getLatitude()));
+                tvLon.setText(String.format("当前经度：%f", currentGpsPos.getLongitude()));
+
+                final long currentTime = System.currentTimeMillis();
+                final SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm", Locale.getDefault());
+                final String timeStr = sdf.format(new Date(currentTime));
+                tvTime.setText("现在时间：" + timeStr);
+            }
+
+            @Override
+            public void onGpsStatusChanged(final 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监听源（根据空转状态自动切换）
+     */
+    private void refreshGpsListener() {
+        LogUtils.d(TAG, "refreshGpsListener invoke");
+        // 统一注销旧监听（防止重复注册）
+        IdleGpsService.getInstance().unregisterGpsUpdateListener(mGpsUpdateListener);
+        if (mMainService != null) {
+            try { mMainService.unregisterGpsUpdateListener(mGpsUpdateListener); } catch (Exception e) {}
+        }
+        // 重新注册正确的监听
+        registerGpsListener();
+    }
+
+    /**
+     * 注册GPS监听
+     */
+    private void registerGpsListener() {
+        LogUtils.d(TAG, "registerGpsListener invoke");
+        if (isFinishing() || isDestroyed() || mGpsUpdateListener == null) {
+            return;
+        }
+        try {
+            if (App.isAppIdleRunning()) {
+                IdleGpsService.getInstance().registerGpsUpdateListener(mGpsUpdateListener);
+                LogUtils.d(TAG, "空转GPS监听注册成功");
+            } else {
+                if (mMainService != null) {
+                    mMainService.registerGpsUpdateListener(mGpsUpdateListener);
+                    LogUtils.d(TAG, "系统GPS监听注册成功");
+                }
+            }
+        } catch (final Exception e) {
+            LogUtils.e(TAG, "GPS注册异常 : " + e.getMessage());
+        }
+    }
+
+    /**
+     * 反注册GPS监听
+     */
+    private void unregisterGpsListener() {
+        LogUtils.d(TAG, "unregisterGpsListener invoke");
+        if (mGpsUpdateListener == null) {
+            return;
+        }
+        try {
+            // 尝试从空转服务注销
+            IdleGpsService.getInstance().unregisterGpsUpdateListener(mGpsUpdateListener);
+        } catch (Exception e) {
+            // ignore
+        }
+        try {
+            // 尝试从主服务注销
+            if (mMainService != null) {
+                mMainService.unregisterGpsUpdateListener(mGpsUpdateListener);
+            }
+        } catch (final Exception e) {
+            LogUtils.e(TAG, "GPS反注册异常 : " + e.getMessage());
+        }
+    }
+
+    // 生命周期方法
+    @Override
+    protected void onCreate(final Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate invoke");
+        setContentView(R.layout.activity_location);
+
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(final View v) {
+					LogUtils.d(TAG, "点击返回导航按钮");
+					final Intent intent = new Intent(LocationActivity.this, MainActivity.class);
+					startActivity(intent);
+					finish();
+				}
+			});
+
+        refreshIdleStatusTitle();
+        initView();
+        initGpsUpdateListener();
+        bindMainService();
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume invoke");
+        refreshIdleStatusTitle();
+        refreshGpsListener(); // 根据当前空转状态刷新GPS源
+
+        if (isServiceBound.get() && mMainService != null && !isAdapterInited.get()) {
+            syncDataFromMainService();
+            initPositionAdapter();
+        } else if (isServiceBound.get() && mMainService != null && mPositionAdapter != null) {
+            syncDataFromMainService();
+            mPositionAdapter.notifyDataSetChanged();
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        LogUtils.d(TAG, "onPause invoke");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy invoke，开始释放资源");
+
+        unregisterGpsListener();
+
+        if (mPositionAdapter != null) {
+            mPositionAdapter.release();
+            mPositionAdapter = null;
+            LogUtils.d(TAG, "Adapter资源释放完成");
+        }
+
+        if (isServiceBound.get()) {
+            try {
+                unbindService(mServiceConnection);
+                LogUtils.d(TAG, "服务解绑完成");
+            } catch (final IllegalArgumentException e) {
+                LogUtils.e(TAG, "解绑异常：服务已提前解绑");
+            }
+            isServiceBound.set(false);
+            mMainService = null;
+        }
+
+        synchronized (mLocalPosCache) {
+            mLocalPosCache.clear();
+        }
+        mCurrentGpsPos = null;
+        mGpsUpdateListener = null;
+        isAdapterInited.set(false);
+        LogUtils.d(TAG, "全部资源释放完毕");
+    }
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/activities/SettingsActivity.java b/positions/src/main/java/cc/winboll/studio/positions/activities/SettingsActivity.java
new file mode 100644
index 0000000..9b432f1
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/activities/SettingsActivity.java
@@ -0,0 +1,51 @@
+package cc.winboll.studio.positions.activities;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.positions.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/07 23:29
+ * @Describe 应用设置活动窗口
+ */
+public class SettingsActivity extends WinBoLLActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "SettingsActivity";
+
+	private Toolbar mToolbar;
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_settings);
+
+		mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+		mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+		getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【导航栏】点击返回");
+					finish();
+				}
+			});
+    }
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/activities/WinBoLLActivity.java b/positions/src/main/java/cc/winboll/studio/positions/activities/WinBoLLActivity.java
new file mode 100644
index 0000000..fba149f
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/activities/WinBoLLActivity.java
@@ -0,0 +1,80 @@
+package cc.winboll.studio.positions.activities;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/29 00:11
+ * @Describe WinBoLL 窗口基础类
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.MenuItem;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class WinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+
+    public static final String TAG = "WinBoLLActivity";
+
+	protected volatile AESThemeBean.ThemeType mThemeType;
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        mThemeType = getThemeType();
+        setThemeStyle();
+        super.onCreate(savedInstanceState);
+    }
+
+	AESThemeBean.ThemeType getThemeType() {
+        return AESThemeBean.getThemeStyleType(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+    }
+
+    void setThemeStyle() {
+        setTheme(AESThemeUtil.getThemeTypeID(getApplicationContext()));
+    }
+
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, String.format("onResume %s", getTag()));
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        /*if (item.getItemId() == R.id.item_log) {
+		 WinBoLLActivityManager.getInstance().startLogActivity(this);
+		 return true;
+		 } else if (item.getItemId() == R.id.item_home) {
+		 startActivity(new Intent(this, MainActivity.class));
+		 return true;
+		 }*/
+        // 在switch语句中处理每个ID，并在处理完后返回true，未处理的情况返回false。
+        return super.onOptionsItemSelected(item);
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        WinBoLLActivityManager.getInstance().add(this);
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        WinBoLLActivityManager.getInstance().registeRemove(this);
+    }
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/adapters/PositionAdapter.java b/positions/src/main/java/cc/winboll/studio/positions/adapters/PositionAdapter.java
new file mode 100644
index 0000000..1f98eac
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/adapters/PositionAdapter.java
@@ -0,0 +1,639 @@
+package cc.winboll.studio.positions.adapters;
+
+/**
+ * @Describe 位置数据适配器（修复视图复用资源加载，支持滚动后重新绑定数据，Java 7语法适配）
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025-09-29 20:25:00
+ * @EditTime 2026-03-31 23:14:55
+ */
+
+import android.content.Context;
+import android.text.TextUtils;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.inputmethod.InputMethodManager;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.RadioGroup;
+import android.widget.TextView;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.positions.R;
+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.views.PositionTaskListView;
+import java.lang.ref.WeakReference;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.concurrent.ConcurrentHashMap;
+
+public class PositionAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder>
+implements MainService.TaskUpdateListener {
+
+    public static final String TAG = "PositionAdapter";
+
+    // 视图类型常量
+    private static final int VIEW_TYPE_SIMPLE = 0;
+    private static final int VIEW_TYPE_EDIT = 1;
+
+    // 默认配置常量
+    private static final String DEFAULT_MEMO = "无备注";
+    private static final String DEFAULT_TASK_DESC = "新任务";
+    private static final int DEFAULT_TASK_DISTANCE = 50;
+    private static final String DISTANCE_FORMAT = "实时距离：%.1f 米";
+    private static final String DISTANCE_DISABLED = "实时距离：未启用";
+    private static final String DISTANCE_ERROR = "实时距离：计算失败";
+
+    // 核心成员变量
+    private final Context mContext;
+    private final ArrayList<PositionModel> mCachedPositionList;
+    private final WeakReference<MainService> mMainServiceRef;
+    private final ConcurrentHashMap<String, PositionTaskListView> mSimpleTaskViewMap;
+    private final ConcurrentHashMap<String, PositionTaskListView> mEditTaskViewMap;
+    private final ConcurrentHashMap<String, TextView> mPosDistanceViewMap;
+
+    // 回调接口
+    public interface OnDeleteClickListener {
+        void onDeleteClick(int position);
+    }
+
+    public interface OnSavePositionClickListener {
+        void onSavePositionClick(int position, PositionModel updatedPos);
+    }
+
+    private OnDeleteClickListener mOnDeleteListener;
+    private OnSavePositionClickListener mOnSavePosListener;
+
+    // =========================================================================
+    // 构造函数
+    // =========================================================================
+    public PositionAdapter(Context context, ArrayList<PositionModel> cachedPositionList, MainService mainService) {
+        LogUtils.d(TAG, "PositionAdapter 构造函数开始，context=" + context
+				   + "，cachedPositionList=" + (cachedPositionList != null ? cachedPositionList.size() : 0)
+				   + "，mainService=" + mainService);
+
+        this.mContext = context;
+        this.mCachedPositionList = (cachedPositionList != null) ? cachedPositionList : new ArrayList<PositionModel>();
+        this.mMainServiceRef = new WeakReference<MainService>(mainService);
+        this.mSimpleTaskViewMap = new ConcurrentHashMap<String, PositionTaskListView>();
+        this.mEditTaskViewMap = new ConcurrentHashMap<String, PositionTaskListView>();
+        this.mPosDistanceViewMap = new ConcurrentHashMap<String, TextView>();
+
+        if (mainService != null) {
+            mainService.registerTaskUpdateListener(this);
+            LogUtils.d(TAG, "已注册 MainService 任务监听");
+        } else {
+            LogUtils.w(TAG, "构造函数：MainService 为空，无法初始化任务视图");
+        }
+
+        LogUtils.d(TAG, "PositionAdapter 初始化完成，位置数量=" + mCachedPositionList.size());
+    }
+
+    // =========================================================================
+    // RecyclerView 核心方法
+    // =========================================================================
+    @Override
+    public int getItemViewType(int position) {
+        PositionModel posModel = getPositionByIndex(position);
+        return (posModel != null && posModel.isSimpleView()) ? VIEW_TYPE_SIMPLE : VIEW_TYPE_EDIT;
+    }
+
+    @Override
+    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+        LogUtils.d(TAG, "onCreateViewHolder viewType=" + viewType);
+        LayoutInflater inflater = LayoutInflater.from(mContext);
+        if (viewType == VIEW_TYPE_SIMPLE) {
+            View simpleView = inflater.inflate(R.layout.item_position_simple, parent, false);
+            return new SimpleViewHolder(simpleView);
+        } else {
+            View editView = inflater.inflate(R.layout.item_position_edit, parent, false);
+            return new EditViewHolder(editView);
+        }
+    }
+
+    @Override
+    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
+        LogUtils.d(TAG, "onBindViewHolder position=" + position);
+        PositionModel posModel = getPositionByIndex(position);
+        if (posModel == null) {
+            LogUtils.w(TAG, "onBindViewHolder：位置模型为空，索引=" + position);
+            return;
+        }
+        final String posId = posModel.getPositionId();
+        MainService mainService = mMainServiceRef.get();
+
+        if (holder instanceof SimpleViewHolder) {
+            LogUtils.d(TAG, "绑定 SimpleViewHolder，posId=" + posId);
+            SimpleViewHolder simpleHolder = (SimpleViewHolder) holder;
+            bindSimplePositionData(simpleHolder, posModel);
+            initAndBindSimpleTaskView(simpleHolder.ptlvSimpleTasks, posId, mainService);
+            mSimpleTaskViewMap.put(posId, simpleHolder.ptlvSimpleTasks);
+            mPosDistanceViewMap.put(posId, simpleHolder.tvSimpleDistance);
+
+        } else if (holder instanceof EditViewHolder) {
+            LogUtils.d(TAG, "绑定 EditViewHolder，posId=" + posId);
+            EditViewHolder editHolder = (EditViewHolder) holder;
+            bindEditPositionData(editHolder, posModel, position);
+            initAndBindEditTaskView(editHolder.ptlvEditTasks, posId, mainService, editHolder.btnAddTask);
+            mEditTaskViewMap.put(posId, editHolder.ptlvEditTasks);
+            mPosDistanceViewMap.put(posId, editHolder.tvEditDistance);
+        }
+    }
+
+    @Override
+    public void onViewDetachedFromWindow(RecyclerView.ViewHolder holder) {
+        super.onViewDetachedFromWindow(holder);
+        PositionModel posModel = getPositionByIndex(holder.getAdapterPosition());
+        if (posModel == null || TextUtils.isEmpty(posModel.getPositionId())) {
+            return;
+        }
+        String posId = posModel.getPositionId();
+
+        if (mPosDistanceViewMap.containsKey(posId)) {
+            TextView distanceView = mPosDistanceViewMap.get(posId);
+            if (distanceView == null || !distanceView.isAttachedToWindow()) {
+                mPosDistanceViewMap.remove(posId);
+                LogUtils.d(TAG, "视图脱离：移除无效距离控件缓存 posId=" + posId);
+            }
+        }
+
+        if (holder instanceof SimpleViewHolder && mSimpleTaskViewMap.containsKey(posId)) {
+            PositionTaskListView taskView = mSimpleTaskViewMap.get(posId);
+            if (taskView == null || !taskView.isAttachedToWindow()) {
+                mSimpleTaskViewMap.remove(posId);
+                LogUtils.d(TAG, "视图脱离：移除无效简单任务视图缓存 posId=" + posId);
+            }
+        }
+
+        if (holder instanceof EditViewHolder && mEditTaskViewMap.containsKey(posId)) {
+            PositionTaskListView taskView = mEditTaskViewMap.get(posId);
+            if (taskView == null || !taskView.isAttachedToWindow()) {
+                mEditTaskViewMap.remove(posId);
+                LogUtils.d(TAG, "视图脱离：移除无效编辑任务视图缓存 posId=" + posId);
+            }
+        }
+    }
+
+    @Override
+    public int getItemCount() {
+        return mCachedPositionList.size();
+    }
+
+    // =========================================================================
+    // 位置数据绑定
+    // =========================================================================
+    private void bindSimplePositionData(SimpleViewHolder holder, final PositionModel posModel) {
+        LogUtils.d(TAG, "bindSimplePositionData posId=" + posModel.getPositionId());
+        holder.tvSimpleLon.setText(String.format("经度：%.6f", posModel.getLongitude()));
+        holder.tvSimpleLat.setText(String.format("纬度：%.6f", posModel.getLatitude()));
+
+        String memo = posModel.getMemo();
+        holder.tvSimpleMemo.setText("备注：" + (TextUtils.isEmpty(memo) ? DEFAULT_MEMO : memo));
+        updateDistanceDisplay(holder.tvSimpleDistance, posModel);
+
+        holder.itemView.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					posModel.setIsSimpleView(false);
+					notifyItemChanged(getPositionIndexById(posModel.getPositionId()));
+					LogUtils.d(TAG, "简单视图点击：切换编辑模式 posId=" + posModel.getPositionId());
+				}
+			});
+    }
+
+    private void bindEditPositionData(final EditViewHolder holder, final PositionModel posModel, final int position) {
+        LogUtils.d(TAG, "bindEditPositionData posId=" + posModel.getPositionId() + " position=" + position);
+        final String posId = posModel.getPositionId();
+
+        holder.tvEditLon.setText(String.format("经度：%.6f", posModel.getLongitude()));
+        holder.tvEditLat.setText(String.format("纬度：%.6f", posModel.getLatitude()));
+
+        String memo = posModel.getMemo();
+        if (!TextUtils.isEmpty(memo)) {
+            holder.etEditMemo.setText(memo);
+            holder.etEditMemo.setSelection(memo.length());
+        } else {
+            holder.etEditMemo.setText("");
+        }
+
+        updateDistanceDisplay(holder.tvEditDistance, posModel);
+
+        holder.rgDistanceSwitch.check(posModel.isEnableRealPositionDistance()
+									  ? R.id.rb_distance_enable
+									  : R.id.rb_distance_disable);
+
+        holder.btnCancel.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					posModel.setIsSimpleView(true);
+					notifyItemChanged(position);
+					hideSoftKeyboard(v);
+					LogUtils.d(TAG, "取消编辑：切换简单视图 posId=" + posId);
+				}
+			});
+
+        holder.btnDelete.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					if (mOnDeleteListener != null) {
+						mOnDeleteListener.onDeleteClick(position);
+					}
+					hideSoftKeyboard(v);
+					LogUtils.d(TAG, "触发删除位置 posId=" + posId);
+				}
+			});
+
+        holder.btnSave.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					String newMemo = holder.etEditMemo.getText().toString().trim();
+					boolean isDistanceEnable = (holder.rgDistanceSwitch.getCheckedRadioButtonId() == R.id.rb_distance_enable);
+
+					PositionModel updatedPos = new PositionModel();
+					updatedPos.setPositionId(posId);
+					updatedPos.setLongitude(posModel.getLongitude());
+					updatedPos.setLatitude(posModel.getLatitude());
+					updatedPos.setMemo(newMemo);
+					updatedPos.setIsEnableRealPositionDistance(isDistanceEnable);
+					updatedPos.setIsSimpleView(true);
+
+					if (mOnSavePosListener != null) {
+						mOnSavePosListener.onSavePositionClick(position, updatedPos);
+					}
+
+					posModel.setMemo(newMemo);
+					posModel.setIsEnableRealPositionDistance(isDistanceEnable);
+					posModel.setIsSimpleView(true);
+					notifyItemChanged(position);
+					hideSoftKeyboard(v);
+
+					LogUtils.d(TAG, "保存位置 posId=" + posId + " 新备注=" + newMemo + " 距离启用=" + isDistanceEnable);
+				}
+			});
+    }
+
+    // =========================================================================
+    // PositionTaskListView 集成
+    // =========================================================================
+    private void initAndBindSimpleTaskView(PositionTaskListView taskView, String posId, MainService mainService) {
+        LogUtils.d(TAG, "initAndBindSimpleTaskView posId=" + posId);
+        if (taskView == null || TextUtils.isEmpty(posId) || mainService == null) {
+            LogUtils.w(TAG, "初始化简单任务视图失败：参数无效");
+            return;
+        }
+        taskView.init(mainService, posId);
+        taskView.setViewStatus(PositionTaskListView.VIEW_MODE_SIMPLE);
+        taskView.syncTasksFromMainService();
+
+        taskView.setOnTaskUpdatedListener(new PositionTaskListView.OnTaskUpdatedListener() {
+				@Override
+				public void onTaskUpdated(String positionId, ArrayList updatedTasks) {
+					LogUtils.d(TAG, "简单模式任务更新 posId=" + positionId + " 任务数=" + updatedTasks.size());
+				}
+			});
+    }
+
+    private void initAndBindEditTaskView(final PositionTaskListView taskView, final String posId,
+                                         MainService mainService, Button btnAddTask) {
+        LogUtils.d(TAG, "initAndBindEditTaskView posId=" + posId);
+        if (taskView == null || TextUtils.isEmpty(posId) || mainService == null || btnAddTask == null) {
+            LogUtils.w(TAG, "初始化编辑任务视图失败：参数无效");
+            return;
+        }
+        taskView.init(mainService, posId);
+        taskView.setViewStatus(PositionTaskListView.VIEW_MODE_EDIT);
+        taskView.syncTasksFromMainService();
+
+        btnAddTask.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					PositionTaskModel newTask = new PositionTaskModel();
+					newTask.setTaskId(PositionTaskModel.genTaskId());
+					newTask.setPositionId(posId);
+					newTask.setTaskDescription(DEFAULT_TASK_DESC);
+					newTask.setDiscussDistance(DEFAULT_TASK_DISTANCE);
+					newTask.setIsEnable(true);
+					newTask.setIsBingo(false);
+
+					taskView.addNewTask(newTask);
+					hideSoftKeyboard(v);
+					LogUtils.d(TAG, "新增任务 posId=" + posId + " taskId=" + newTask.getTaskId());
+				}
+			});
+
+        taskView.setOnTaskUpdatedListener(new PositionTaskListView.OnTaskUpdatedListener() {
+				@Override
+				public void onTaskUpdated(String positionId, ArrayList updatedTasks) {
+					LogUtils.d(TAG, "编辑模式任务更新 posId=" + positionId + " 任务数=" + updatedTasks.size());
+				}
+			});
+    }
+
+    // =========================================================================
+    // 工具方法
+    // =========================================================================
+    private void updateDistanceDisplay(TextView distanceView, PositionModel posModel) {
+        if (distanceView == null || posModel == null) {
+            LogUtils.w(TAG, "updateDistanceDisplay：参数为空");
+            return;
+        }
+        if (!posModel.isEnableRealPositionDistance()) {
+            distanceView.setText(DISTANCE_DISABLED);
+            distanceView.setTextColor(mContext.getResources().getColor(R.color.gray));
+            return;
+        }
+        double distance = posModel.getRealPositionDistance();
+        if (distance < 0) {
+            distanceView.setText(DISTANCE_ERROR);
+            distanceView.setTextColor(mContext.getResources().getColor(R.color.red));
+            return;
+        }
+        distanceView.setText(String.format(DISTANCE_FORMAT, distance));
+        if (distance <= 100) {
+            distanceView.setTextColor(mContext.getResources().getColor(R.color.green));
+        } else if (distance <= 500) {
+            distanceView.setTextColor(mContext.getResources().getColor(R.color.yellow));
+        } else {
+            distanceView.setTextColor(mContext.getResources().getColor(R.color.red));
+        }
+    }
+
+    private PositionModel getPositionByIndex(int index) {
+        if (mCachedPositionList == null || index < 0 || index >= mCachedPositionList.size()) {
+            LogUtils.w(TAG, "getPositionByIndex：无效索引 index=" + index);
+            return null;
+        }
+        return mCachedPositionList.get(index);
+    }
+
+    private int getPositionIndexById(String positionId) {
+        if (TextUtils.isEmpty(positionId) || mCachedPositionList == null || mCachedPositionList.isEmpty()) {
+            LogUtils.w(TAG, "getPositionIndexById：参数无效");
+            return -1;
+        }
+        for (int i = 0; i < mCachedPositionList.size(); i++) {
+            PositionModel pos = mCachedPositionList.get(i);
+            if (positionId.equals(pos.getPositionId())) {
+                return i;
+            }
+        }
+        LogUtils.w(TAG, "未找到位置ID=" + positionId);
+        return -1;
+    }
+
+    public void updateSinglePositionDistance(String positionId) {
+        LogUtils.d(TAG, "updateSinglePositionDistance posId=" + positionId);
+        if (TextUtils.isEmpty(positionId) || mPosDistanceViewMap.isEmpty()) {
+            return;
+        }
+        MainService mainService = getMainServiceWithRetry(2);
+        if (mainService == null) {
+            LogUtils.e(TAG, "无法获取 MainService");
+            return;
+        }
+        PositionModel latestPos = null;
+        try {
+            ArrayList servicePosList = mainService.getPositionList();
+            if (servicePosList != null && !servicePosList.isEmpty()) {
+                Iterator iter = servicePosList.iterator();
+                while (iter.hasNext()) {
+                    PositionModel pos = (PositionModel) iter.next();
+                    if (positionId.equals(pos.getPositionId())) {
+                        latestPos = pos;
+                        break;
+                    }
+                }
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "获取位置数据异常", e);
+            return;
+        }
+        if (latestPos == null) {
+            LogUtils.w(TAG, "未找到位置 posId=" + positionId);
+            return;
+        }
+        final TextView distanceView = mPosDistanceViewMap.get(positionId);
+        if (distanceView != null && distanceView.isAttachedToWindow()) {
+            final PositionModel finalLatestPos = latestPos;
+            distanceView.post(new Runnable() {
+					@Override
+					public void run() {
+						updateDistanceDisplay(distanceView, finalLatestPos);
+					}
+				});
+        } else {
+            mPosDistanceViewMap.remove(positionId);
+        }
+    }
+
+    public void updateAllPositionData(ArrayList<PositionModel> newPosList) {
+        LogUtils.d(TAG, "updateAllPositionData 新数据数量=" + (newPosList != null ? newPosList.size() : 0));
+        if (newPosList == null) {
+            return;
+        }
+        ArrayList<PositionModel> validPosList = new ArrayList<PositionModel>();
+        for (PositionModel pos : newPosList) {
+            if (TextUtils.isEmpty(pos.getPositionId())
+				|| pos.getLongitude() < -180 || pos.getLongitude() > 180
+				|| pos.getLatitude() < -90 || pos.getLatitude() > 90) {
+                continue;
+            }
+            validPosList.add(pos);
+        }
+        ConcurrentHashMap<String, PositionModel> uniquePosMap = new ConcurrentHashMap<String, PositionModel>();
+        for (PositionModel pos : validPosList) {
+            uniquePosMap.put(pos.getPositionId(), pos);
+        }
+        ArrayList uniquePosList = new ArrayList(uniquePosMap.values());
+
+        mCachedPositionList.clear();
+        mCachedPositionList.addAll(uniquePosList);
+        mPosDistanceViewMap.clear();
+        mSimpleTaskViewMap.clear();
+        mEditTaskViewMap.clear();
+        notifyDataSetChanged();
+
+        LogUtils.d(TAG, "全量更新完成，有效数量=" + uniquePosList.size());
+    }
+
+    private void hideSoftKeyboard(View view) {
+        if (mContext == null || view == null) {
+            return;
+        }
+        InputMethodManager imm = (InputMethodManager) mContext.getSystemService(Context.INPUT_METHOD_SERVICE);
+        if (imm != null) {
+            imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
+        }
+    }
+
+    private MainService getMainServiceWithRetry(int retryCount) {
+        MainService mainService = mMainServiceRef.get();
+        if (mainService != null) {
+            return mainService;
+        }
+        for (int i = 0; i < retryCount; i++) {
+            try {
+                Thread.sleep(100);
+                mainService = mMainServiceRef.get();
+                if (mainService != null) {
+                    LogUtils.d(TAG, "重试获取 MainService 成功，第" + (i + 1) + "次");
+                    return mainService;
+                }
+            } catch (InterruptedException e) {
+                LogUtils.e(TAG, "重试被中断", e);
+                Thread.currentThread().interrupt();
+                break;
+            }
+        }
+        LogUtils.e(TAG, "重试" + retryCount + "次仍未获取到 MainService");
+        return null;
+    }
+
+    // =========================================================================
+    // 任务更新监听
+    // =========================================================================
+    @Override
+    public void onTaskUpdated() {
+        LogUtils.d(TAG, "onTaskUpdated：收到服务任务更新");
+        if (!mSimpleTaskViewMap.isEmpty()) {
+            Iterator<ConcurrentHashMap.Entry<String, PositionTaskListView>> iter = mSimpleTaskViewMap.entrySet().iterator();
+            while (iter.hasNext()) {
+                ConcurrentHashMap.Entry<String, PositionTaskListView> entry = iter.next();
+                PositionTaskListView taskView = entry.getValue();
+                if (taskView != null && taskView.isAttachedToWindow()) {
+                    taskView.syncTasksFromMainService();
+                } else {
+                    iter.remove();
+                }
+            }
+        }
+        if (!mEditTaskViewMap.isEmpty()) {
+            Iterator<ConcurrentHashMap.Entry<String, PositionTaskListView>> iter = mEditTaskViewMap.entrySet().iterator();
+            while (iter.hasNext()) {
+                ConcurrentHashMap.Entry<String, PositionTaskListView> entry = iter.next();
+                PositionTaskListView taskView = entry.getValue();
+                if (taskView != null && taskView.isAttachedToWindow()) {
+                    taskView.syncTasksFromMainService();
+                } else {
+                    iter.remove();
+                }
+            }
+        }
+    }
+
+    // =========================================================================
+    // 外部回调设置
+    // =========================================================================
+    public void setOnDeleteClickListener(OnDeleteClickListener listener) {
+        LogUtils.d(TAG, "setOnDeleteClickListener listener=" + listener);
+        this.mOnDeleteListener = listener;
+    }
+
+    public void setOnSavePositionClickListener(OnSavePositionClickListener listener) {
+        LogUtils.d(TAG, "setOnSavePositionClickListener listener=" + listener);
+        this.mOnSavePosListener = listener;
+    }
+
+    // =========================================================================
+    // 资源释放
+    // =========================================================================
+    public void release() {
+        LogUtils.d(TAG, "release：开始释放 Adapter 资源");
+        MainService mainService = mMainServiceRef.get();
+        if (mainService != null) {
+            mainService.unregisterTaskUpdateListener(this);
+            LogUtils.d(TAG, "已反注册任务监听");
+        }
+
+        if (!mSimpleTaskViewMap.isEmpty()) {
+            Iterator<ConcurrentHashMap.Entry<String, PositionTaskListView>> iter = mSimpleTaskViewMap.entrySet().iterator();
+            while (iter.hasNext()) {
+                PositionTaskListView taskView = iter.next().getValue();
+                if (taskView != null) {
+                    taskView.clearData();
+                    taskView.setOnTaskUpdatedListener(null);
+                }
+                iter.remove();
+            }
+        }
+
+        if (!mEditTaskViewMap.isEmpty()) {
+            Iterator<ConcurrentHashMap.Entry<String, PositionTaskListView>> iter = mEditTaskViewMap.entrySet().iterator();
+            while (iter.hasNext()) {
+                PositionTaskListView taskView = iter.next().getValue();
+                if (taskView != null) {
+                    taskView.clearData();
+                    taskView.setOnTaskUpdatedListener(null);
+                }
+                iter.remove();
+            }
+        }
+
+        mPosDistanceViewMap.clear();
+        if (mCachedPositionList != null) {
+            mCachedPositionList.clear();
+        }
+        mOnDeleteListener = null;
+        mOnSavePosListener = null;
+
+        LogUtils.d(TAG, "release：资源释放完成");
+    }
+
+    // =========================================================================
+    // ViewHolder
+    // =========================================================================
+    public static class SimpleViewHolder extends RecyclerView.ViewHolder {
+        TextView tvSimpleLon;
+        TextView tvSimpleLat;
+        TextView tvSimpleMemo;
+        TextView tvSimpleDistance;
+        PositionTaskListView ptlvSimpleTasks;
+
+        public SimpleViewHolder(View itemView) {
+            super(itemView);
+            tvSimpleLon = (TextView) itemView.findViewById(R.id.tv_simple_longitude);
+            tvSimpleLat = (TextView) itemView.findViewById(R.id.tv_simple_latitude);
+            tvSimpleMemo = (TextView) itemView.findViewById(R.id.tv_simple_memo);
+            tvSimpleDistance = (TextView) itemView.findViewById(R.id.tv_simple_distance);
+            ptlvSimpleTasks = (PositionTaskListView) itemView.findViewById(R.id.ptlv_simple_tasks);
+        }
+    }
+
+    public static class EditViewHolder extends RecyclerView.ViewHolder {
+        TextView tvEditLon;
+        TextView tvEditLat;
+        EditText etEditMemo;
+        TextView tvEditDistance;
+        RadioGroup rgDistanceSwitch;
+        Button btnCancel;
+        Button btnDelete;
+        Button btnSave;
+        Button btnAddTask;
+        TextView tvTaskCount;
+        PositionTaskListView ptlvEditTasks;
+
+        public EditViewHolder(View itemView) {
+            super(itemView);
+            tvEditLon = (TextView) itemView.findViewById(R.id.tv_edit_longitude);
+            tvEditLat = (TextView) itemView.findViewById(R.id.tv_edit_latitude);
+            etEditMemo = (EditText) itemView.findViewById(R.id.et_edit_memo);
+            tvEditDistance = (TextView) itemView.findViewById(R.id.tv_edit_distance);
+            rgDistanceSwitch = (RadioGroup) itemView.findViewById(R.id.rg_distance_switch);
+            btnCancel = (Button) itemView.findViewById(R.id.btn_edit_cancel);
+            btnDelete = (Button) itemView.findViewById(R.id.btn_edit_delete);
+            btnSave = (Button) itemView.findViewById(R.id.btn_edit_save);
+            btnAddTask = (Button) itemView.findViewById(R.id.btn_add_task);
+            tvTaskCount = (TextView) itemView.findViewById(R.id.tv_task_count);
+            ptlvEditTasks = (PositionTaskListView) itemView.findViewById(R.id.ptlv_edit_tasks);
+        }
+    }
+
+    // =========================================================================
+    // 方法说明类（保留不动）
+    // =========================================================================
+    public static class PositionTaskListViewRequiredMethods {
+    }
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/handlers/AppIdleRunningModeHandler.java b/positions/src/main/java/cc/winboll/studio/positions/handlers/AppIdleRunningModeHandler.java
new file mode 100644
index 0000000..c00a7a3
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/handlers/AppIdleRunningModeHandler.java
@@ -0,0 +1,143 @@
+package cc.winboll.studio.positions.handlers;
+
+import android.os.Handler;
+import android.os.Looper;
+import android.os.Message;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.positions.App;
+import cc.winboll.studio.positions.MainActivity;
+
+/**
+ * 应用空转事务处理器
+ * 作用：接收空转开关消息、空转日志消息，回调MainActivity内部接口实现UI联动
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026/05/03 12:23:00
+ * @EditTime   2026/05/03 14:42:18
+ */
+public class AppIdleRunningModeHandler extends Handler {
+
+    //===================== 常量标识 =====================
+    public static final String TAG = "AppIdleRunningModeHandler";
+    public static final int MSG_IDLE_MODE_SWITCH = 1001;
+    public static final int MSG_IDLE_LOG_PRINT  = 1002;
+
+    //===================== 成员变量 =====================
+    private static AppIdleRunningModeHandler mHandler;
+    private MainActivity mMainActivity;
+
+    //===================== 静态初始化 =====================
+    static {
+        mHandler = new AppIdleRunningModeHandler();
+        LogUtils.d(TAG, "静态代码块：默认主线程Looper完成初始化");
+    }
+
+    //===================== 构造方法 =====================
+    /**
+     * 私有无参构造，禁止外部直接实例化
+     */
+    private AppIdleRunningModeHandler() {
+        super(Looper.getMainLooper());
+    }
+
+    /**
+     * 带MainActivity绑定构造
+     * @param activity 主页面实例
+     */
+    public AppIdleRunningModeHandler(MainActivity activity) {
+        super(Looper.getMainLooper());
+        this.mMainActivity = activity;
+        LogUtils.d(TAG, "构造方法：完成MainActivity绑定初始化");
+    }
+
+    //===================== 对外初始化与获取 =====================
+    /**
+     * 全局静态初始化、重新绑定MainActivity
+     * @param activity 主页面实例
+     */
+    public static void init(MainActivity activity) {
+        if (mHandler == null) {
+            mHandler = new AppIdleRunningModeHandler(activity);
+        } else {
+            mHandler.mMainActivity = activity;
+        }
+        LogUtils.i(TAG, "init -> AppIdleRunningModeHandler初始化绑定成功");
+    }
+
+    /**
+     * 获取当前绑定的MainActivity实例
+     * @return 已绑定的Activity
+     */
+    public MainActivity getBindMainActivity() {
+        return mMainActivity;
+    }
+
+    //===================== 对外静态发送方法 =====================
+    /**
+     * 发送空转开关控制消息
+     * @param isOpen 是否开启空转状态
+     */
+    public static void sendIdleSwitch(boolean isOpen) {
+        if (!App.isAppIdleRunning()) {
+            LogUtils.d(TAG, "sendIdleSwitch -> 当前非空转状态，函数执行无效");
+            return;
+        }
+        LogUtils.d(TAG, "sendIdleSwitch -> 发送空转开关信号，参数isOpen = " + isOpen);
+
+        Message message = Message.obtain();
+        message.what = MSG_IDLE_MODE_SWITCH;
+        message.obj = isOpen;
+        mHandler.sendMessage(message);
+    }
+
+    /**
+     * 发送空转日志打印消息
+     * @param logText 待输出的日志内容
+     */
+    public static void sendIdleLog(String logText) {
+        if (!App.isAppIdleRunning()) {
+            LogUtils.d(TAG, "sendIdleLog -> 当前非空转状态，函数执行无效");
+            return;
+        }
+        LogUtils.d(TAG, "sendIdleLog -> 发送空转日志消息");
+
+        Message message = Message.obtain();
+        message.what = MSG_IDLE_LOG_PRINT;
+        message.obj = logText;
+        mHandler.sendMessage(message);
+    }
+
+    //===================== 消息接收处理 =====================
+    @Override
+    public void handleMessage(Message msg) {
+        super.handleMessage(msg);
+
+        // 全局状态校验
+        if (!App.isAppIdleRunning()) {
+            return;
+        }
+        // 空指针安全防护
+        if (mMainActivity == null || mMainActivity.getOnAppIdleRunningListener() == null) {
+            LogUtils.d(TAG, "handleMessage -> Activity或监听接口为空，终止回调");
+            return;
+        }
+
+        switch (msg.what) {
+            case MSG_IDLE_MODE_SWITCH:
+                boolean idleState = (boolean) msg.obj;
+                App.setAppIdleRunning(idleState);
+                LogUtils.i(TAG, "handleMessage -> 空转状态已变更：" + idleState);
+                // 回调主页面接口
+                mMainActivity.getOnAppIdleRunningListener().onIdleStatusChange(idleState);
+                break;
+
+            case MSG_IDLE_LOG_PRINT:
+                String logContent = (String) msg.obj;
+                LogUtils.i(TAG, logContent);
+                // 回调主页面日志接收接口
+                mMainActivity.getOnAppIdleRunningListener().onIdleLogReceive(logContent);
+                break;
+        }
+    }
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/models/AppConfigsModel.java b/positions/src/main/java/cc/winboll/studio/positions/models/AppConfigsModel.java
new file mode 100644
index 0000000..feb0aa0
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/models/AppConfigsModel.java
@@ -0,0 +1,75 @@
+package cc.winboll.studio.positions.models;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/10/01 04:50
+ * @Describe AppConfigsModel
+ */
+ import cc.winboll.studio.libappbase.BaseBean;
+import android.util.JsonWriter;
+import android.util.JsonReader;
+import java.io.IOException;
+
+public class AppConfigsModel extends BaseBean {
+    
+    public static final String TAG = "AppConfigsModel";
+	
+	boolean isEnableMainService;
+
+	public AppConfigsModel(boolean isEnableMainService) {
+		this.isEnableMainService = isEnableMainService;
+	}
+	
+	public AppConfigsModel() {
+		this.isEnableMainService = false;
+	}
+
+	public void setIsEnableMainService(boolean isEnableMainService) {
+		this.isEnableMainService = isEnableMainService;
+	}
+
+	public boolean isEnableMainService() {
+		return isEnableMainService;
+	}
+    
+    @Override
+	public String getName() {
+		return AppConfigsModel.class.getName();
+	}
+
+	// JSON序列化（保存位置数据）
+	@Override
+	public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+		super.writeThisToJsonWriter(jsonWriter);
+		jsonWriter.name("isEnableDistanceRefreshService").value(isEnableMainService());
+	}
+
+	// JSON反序列化（加载位置数据，校验字段）
+	@Override
+	public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+		if (super.initObjectsFromJsonReader(jsonReader, name)) { 
+			return true; 
+		} else {
+			if (name.equals("isEnableDistanceRefreshService")) {
+				setIsEnableMainService(jsonReader.nextBoolean());
+			} else {
+				return false;
+			}
+		}
+		return true;
+	}
+
+	// 从JSON读取位置数据
+	@Override
+	public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+		jsonReader.beginObject();
+		while (jsonReader.hasNext()) {
+			String name = jsonReader.nextName();
+			if (!initObjectsFromJsonReader(jsonReader, name)) {
+				jsonReader.skipValue(); // 跳过未知字段
+			}
+		}
+		jsonReader.endObject();
+		return this;
+	}
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/models/PositionModel.java b/positions/src/main/java/cc/winboll/studio/positions/models/PositionModel.java
new file mode 100644
index 0000000..7c7c9ca
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/models/PositionModel.java
@@ -0,0 +1,219 @@
+package cc.winboll.studio.positions.models;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/29 18:57
+ * @Describe 位置数据模型
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+import java.util.UUID;
+
+public class PositionModel extends BaseBean {
+
+    public static final String TAG = "PositionModel";
+	// 位置唯一标识符（与任务的positionId绑定）
+	String positionId;
+	// 经度（范围：-180~180）
+	double longitude;
+	// 纬度（范围：-90~90）
+	double latitude;
+	// 位置备注（空值时显示“无备注”）
+	String memo;
+	// 定位点与指定点实时距离长度
+	double realPositionDistance;
+	// 是否启用实时距离计算
+	boolean isEnableRealPositionDistance;
+	// 是否显示简单视图（true=简单视图，false=编辑视图）
+	boolean isSimpleView = true;
+
+	// 带参构造（强制初始化位置ID和经纬度）
+	public PositionModel(String positionId, double longitude, double latitude, String memo, boolean isEnableRealPositionDistance) {
+		this.positionId = (positionId == null || positionId.trim().isEmpty()) ? genPositionId() : positionId;
+		this.longitude = Math.max(-180, Math.min(180, longitude)); // 经度范围限制
+		this.latitude = Math.max(-90, Math.min(90, latitude)); // 纬度范围限制
+		this.memo = (memo == null || memo.trim().isEmpty()) ? "无备注" : memo;
+		this.isEnableRealPositionDistance = isEnableRealPositionDistance;
+	}
+
+	// 无参构造（默认值初始化，避免空指针）
+	public PositionModel() {
+		this.positionId = genPositionId();
+		this.longitude = 0.0;
+		this.latitude = 0.0;
+		this.memo = "无备注";
+		this.isEnableRealPositionDistance = false;
+	}
+
+	public void setRealPositionDistance(double realPositionDistance) {
+		this.realPositionDistance = realPositionDistance;
+	}
+
+	public double getRealPositionDistance() {
+		return realPositionDistance;
+	}
+
+	// ---------------------- Getter/Setter（确保字段有效性） ----------------------
+	public void setPositionId(String positionId) {
+		this.positionId = (positionId == null || positionId.trim().isEmpty()) ? genPositionId() : positionId;
+	}
+
+	public String getPositionId() {
+		return positionId;
+	}
+
+	public void setIsEnableRealPositionDistance(boolean isEnableRealPositionDistance) {
+		this.isEnableRealPositionDistance = isEnableRealPositionDistance;
+	}
+
+	public boolean isEnableRealPositionDistance() {
+		return isEnableRealPositionDistance;
+	}
+
+	public void setIsSimpleView(boolean isSimpleView) {
+		this.isSimpleView = isSimpleView;
+	}
+
+	public boolean isSimpleView() {
+		return isSimpleView;
+	}
+
+	public void setMemo(String memo) {
+		this.memo = (memo == null || memo.trim().isEmpty()) ? "无备注" : memo;
+	}
+
+	public String getMemo() {
+		return memo;
+	}
+
+	public void setLongitude(double longitude) {
+		this.longitude = Math.max(-180, Math.min(180, longitude)); // 限制经度范围
+	}
+
+	public double getLongitude() {
+		return longitude;
+	}
+
+	public void setLatitude(double latitude) {
+		this.latitude = Math.max(-90, Math.min(90, latitude)); // 限制纬度范围
+	}
+
+	public double getLatitude() {
+		return latitude;
+	}
+
+	// ---------------------- 父类方法重写 ----------------------
+	@Override
+	public String getName() {
+		return PositionModel.class.getName();
+	}
+
+	// 生成唯一位置ID（与任务ID格式一致，确保关联匹配）
+	public static String genPositionId() {
+        UUID uniqueUuid = UUID.randomUUID();
+        return uniqueUuid.toString(); // 36位标准UUID（含横杠，确保与任务ID格式统一）
+    }
+
+	// JSON序列化（保存位置数据）
+	@Override
+	public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+		super.writeThisToJsonWriter(jsonWriter);
+		jsonWriter.name("positionId").value(getPositionId());
+		jsonWriter.name("longitude").value(getLongitude());
+		jsonWriter.name("latitude").value(getLatitude());
+		jsonWriter.name("memo").value(getMemo());
+		jsonWriter.name("isEnableRealPositionDistance").value(isEnableRealPositionDistance());
+	}
+
+	// JSON反序列化（加载位置数据，校验字段）
+	@Override
+	public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+		if (super.initObjectsFromJsonReader(jsonReader, name)) { 
+			return true; 
+		} else {
+			if (name.equals("positionId")) {
+				setPositionId(jsonReader.nextString());
+			} else if (name.equals("longitude")) {
+				setLongitude(jsonReader.nextDouble());
+			} else if (name.equals("latitude")) {
+				setLatitude(jsonReader.nextDouble());
+			} else if (name.equals("memo")) {
+				setMemo(jsonReader.nextString());
+			} else if (name.equals("isEnableRealPositionDistance")) {
+				setIsEnableRealPositionDistance(jsonReader.nextBoolean());
+			} else {
+				return false;
+			}
+		}
+		return true;
+	}
+
+	// 从JSON读取位置数据
+	@Override
+	public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+		jsonReader.beginObject();
+		while (jsonReader.hasNext()) {
+			String name = jsonReader.nextName();
+			if (!initObjectsFromJsonReader(jsonReader, name)) {
+				jsonReader.skipValue(); // 跳过未知字段
+			}
+		}
+		jsonReader.endObject();
+		return this;
+	}
+
+	// ---------------------- 核心工具方法：计算两点距离（Haversine公式，确保精度） ----------------------
+	/**
+	 * 计算两个位置之间的直线距离（地球表面最短距离）
+	 * @param position1 第一个位置（非null）
+	 * @param position2 第二个位置（非null）
+	 * @param isKilometer 是否返回千米单位：true→千米，false→米
+	 * @return 距离（保留1位小数，符合显示需求）
+	 * @throws IllegalArgumentException 位置为null或经纬度无效时抛出
+	 */
+	public static double calculatePositionDistance(PositionModel position1, PositionModel position2, boolean isKilometer) {
+		// 1. 校验参数有效性（避免计算异常）
+		if (position1 == null || position2 == null) {
+			throw new IllegalArgumentException("位置对象不能为null");
+		}
+		double lon1 = position1.getLongitude();
+		double lat1 = position1.getLatitude();
+		double lon2 = position2.getLongitude();
+		double lat2 = position2.getLatitude();
+		// 经纬度范围二次校验（确保有效）
+		if (lat1 < -90 || lat1 > 90 || lat2 < -90 || lat2 > 90 
+			|| lon1 < -180 || lon1 > 180 || lon2 < -180 || lon2 > 180) {
+			throw new IllegalArgumentException("经纬度值无效（纬度：-90~90，经度：-180~180）");
+		}
+
+		// 2. Haversine公式计算（地球半径取6371km，行业标准）
+		final double EARTH_RADIUS_KM = 6371;
+		double radLat1 = Math.toRadians(lat1); // 角度转弧度
+		double radLat2 = Math.toRadians(lat2);
+		double radLon1 = Math.toRadians(lon1);
+		double radLon2 = Math.toRadians(lon2);
+
+		double deltaLat = radLat2 - radLat1; // 纬度差
+		double deltaLon = radLon2 - radLon1; // 经度差
+
+		// 核心公式
+		double a = Math.pow(Math.sin(deltaLat / 2), 2) 
+			+ Math.cos(radLat1) * Math.cos(radLat2) 
+			* Math.pow(Math.sin(deltaLon / 2), 2);
+		double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+		double distanceKm = EARTH_RADIUS_KM * c; // 距离（千米）
+
+		// 3. 单位转换+精度处理（保留1位小数，符合显示需求）
+		double distance;
+		if (isKilometer) {
+			distance = Math.round(distanceKm * 10.0) / 10.0; // 千米→1位小数
+		} else {
+			distance = Math.round(distanceKm * 1000 * 10.0) / 10.0; // 米→1位小数
+		}
+
+		return distance;
+	}
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/models/PositionTaskModel.java b/positions/src/main/java/cc/winboll/studio/positions/models/PositionTaskModel.java
new file mode 100644
index 0000000..1e9dd47
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/models/PositionTaskModel.java
@@ -0,0 +1,207 @@
+package cc.winboll.studio.positions.models;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/30 02:48
+ * @Describe 位置任务数据模型
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+import java.util.UUID;
+
+public class PositionTaskModel extends BaseBean {
+    
+    public static final String TAG = "PositionTaskModel";
+    // 任务标识符（唯一）
+	String taskId;
+	// 绑定的位置标识符（与PositionModel的positionId一一对应）
+	String positionId;
+	// 任务描述
+	String taskDescription;
+	// 任务距离条件：是否大于设定距离
+	boolean isGreaterThan;
+	// 任务距离条件：是否小于设定距离（与isGreaterThan互斥）
+	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) {
+		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;
+	}
+	
+	// 无参构造（初始化默认值，positionId需后续设置）
+	public PositionTaskModel() {
+		this.taskId = genTaskId();
+		this.positionId = "";
+		this.taskDescription = "新任务";
+		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;
+	}
+
+	public boolean isBingo() {
+		return isBingo;
+	}
+
+	// ---------------------- Getter/Setter（确保positionId不为空，距离有效） ----------------------
+	public void setTaskId(String taskId) {
+		this.taskId = (taskId == null || taskId.trim().isEmpty()) ? genTaskId() : taskId;
+	}
+
+	public String getTaskId() {
+		return taskId;
+	}
+
+	public void setPositionId(String positionId) {
+		this.positionId = (positionId == null || positionId.trim().isEmpty()) ? "" : positionId; // 空值防护
+	}
+
+	public String getPositionId() {
+		return positionId;
+	}
+
+	public void setTaskDescription(String taskDescription) {
+		this.taskDescription = (taskDescription == null || taskDescription.trim().isEmpty()) ? "新任务" : taskDescription;
+	}
+
+	public String getTaskDescription() {
+		return taskDescription;
+	}
+
+	// 修复：确保isGreaterThan和isLessThan互斥
+	public void setIsGreaterThan(boolean isGreaterThan) {
+		this.isGreaterThan = isGreaterThan;
+		this.isLessThan = !isGreaterThan; // 关键：小于 = 非大于
+	}
+
+	public boolean isGreaterThan() {
+		return isGreaterThan;
+	}
+
+	// 修复：确保isLessThan和isGreaterThan互斥
+	public void setIsLessThan(boolean isLessThan) {
+		this.isLessThan = isLessThan;
+		this.isGreaterThan = !isLessThan; // 关键：大于 = 非小于
+	}
+
+	public boolean isLessThan() {
+		return isLessThan;
+	}
+
+	public void setDiscussDistance(int discussDistance) {
+		this.discussDistance = Math.max(discussDistance, 1); // 距离最小1米，避免0或负数
+	}
+
+	public int getDiscussDistance() {
+		return discussDistance;
+	}
+
+	public void setIsEnable(boolean isEnable) {
+		this.isEnable = isEnable;
+	}
+
+	public boolean isEnable() {
+		return isEnable;
+	}
+
+	// ---------------------- 父类方法重写 ----------------------
+	@Override
+	public String getName() {
+		return PositionTaskModel.class.getName();
+	}
+	
+	// 生成唯一任务ID（与PositionModel保持一致格式）
+	public static String genTaskId() {
+        UUID uniqueUuid = UUID.randomUUID();
+        return uniqueUuid.toString(); // 36位标准UUID（含横杠，确保唯一）
+    }
+
+	// JSON序列化（保存任务数据，包含所有字段）
+	@Override
+	public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+		super.writeThisToJsonWriter(jsonWriter);
+		jsonWriter.name("taskId").value(getTaskId());
+		jsonWriter.name("positionId").value(getPositionId());
+		jsonWriter.name("taskDescription").value(getTaskDescription());
+		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());
+	}
+
+	// JSON反序列化（加载任务数据，校验字段有效性）
+	@Override
+	public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+		if (super.initObjectsFromJsonReader(jsonReader, name)) { 
+			return true; 
+		} else {
+			if (name.equals("taskId")) {
+				setTaskId(jsonReader.nextString());
+			} else if (name.equals("positionId")) {
+				setPositionId(jsonReader.nextString());
+			} else if (name.equals("taskDescription")) {
+				setTaskDescription(jsonReader.nextString());
+			} else if (name.equals("isGreaterThan")) {
+				setIsGreaterThan(jsonReader.nextBoolean());
+			} else if (name.equals("isLessThan")) {
+				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 {
+				return false;
+			}
+		}
+		return true;
+	}
+
+	// 从JSON读取任务数据（确保反序列化完整）
+	@Override
+	public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+		jsonReader.beginObject();
+		while (jsonReader.hasNext()) {
+			String name = jsonReader.nextName();
+			if (!initObjectsFromJsonReader(jsonReader, name)) {
+				jsonReader.skipValue(); // 跳过未知字段，避免崩溃
+			}
+		}
+		jsonReader.endObject();
+		return this;
+	}
+    
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/services/AssistantService.java b/positions/src/main/java/cc/winboll/studio/positions/services/AssistantService.java
new file mode 100644
index 0000000..14317e1
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/services/AssistantService.java
@@ -0,0 +1,101 @@
+package cc.winboll.studio.positions.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用主要服务组件类守护进程服务组件类
+ */
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.IBinder;
+import cc.winboll.studio.positions.services.MainService;
+import cc.winboll.studio.positions.utils.AppConfigsUtil;
+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;
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        mAppConfigsUtil = AppConfigsUtil.getInstance(this);
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+        }
+        // 设置运行参数
+        mIsServiceRunning = false;
+        if (mAppConfigsUtil.isEnableMainService(true)) {
+			run();
+		}
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+		if (mAppConfigsUtil.isEnableMainService(true)) {
+			run();
+		}
+
+        return  mAppConfigsUtil.isEnableMainService(true) ? Service.START_STICKY : super.onStartCommand(intent, flags, startId);
+    }
+
+    @Override
+    public void onDestroy() {
+        mIsServiceRunning = false;
+        super.onDestroy();
+    }
+
+    //
+    // 运行服务内容
+    //
+    void run() {
+        if (mAppConfigsUtil.isEnableMainService(true)) {
+            if (mIsServiceRunning == false) {
+                // 设置运行状态
+                mIsServiceRunning = true;
+                // 唤醒和绑定主进程
+                wakeupAndBindMain();
+            }
+        }
+    }
+
+    //
+    // 唤醒和绑定主进程
+    //
+    void wakeupAndBindMain() {
+        if (ServiceUtil.isServiceAlive(getApplicationContext(), MainService.class.getName()) == false) {
+            startForegroundService(new Intent(AssistantService.this, MainService.class));
+        }
+
+        bindService(new Intent(AssistantService.this, MainService.class), mMyServiceConnection, Context.BIND_IMPORTANT);
+    }
+
+    //
+    // 主进程与守护进程连接时需要用到此类
+    //
+    class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            if (mAppConfigsUtil.isEnableMainService(true)) {
+                wakeupAndBindMain();
+            }
+        }
+    }
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/services/DistanceRefreshService.java b/positions/src/main/java/cc/winboll/studio/positions/services/DistanceRefreshService.java
new file mode 100644
index 0000000..0e48a34
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/services/DistanceRefreshService.java
@@ -0,0 +1,433 @@
+//package cc.winboll.studio.positions.services;
+//
+///**
+// * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+// * @Date 2025/09/30 19:53
+// * @Describe 位置距离服务：管理数据+定时计算距离+适配Adapter（Java 7 兼容）+ GPS信号加载
+// */
+//import android.app.Service;
+//import android.content.Context;
+//import android.content.Intent;
+//import android.content.pm.PackageManager;
+//import android.location.Location;
+//import android.location.LocationListener;
+//import android.location.LocationManager;
+//import android.os.Binder;
+//import android.os.Build;
+//import android.os.Bundle;
+//import android.os.IBinder;
+//import android.os.Looper;
+//import android.widget.Toast;
+//import cc.winboll.studio.libappbase.LogUtils;
+//import cc.winboll.studio.positions.adapters.PositionAdapter;
+//import cc.winboll.studio.positions.models.AppConfigsModel;
+//import cc.winboll.studio.positions.models.PositionModel;
+//import cc.winboll.studio.positions.models.PositionTaskModel;
+//import cc.winboll.studio.positions.utils.NotificationUtil;
+//import java.util.ArrayList;
+//import java.util.HashSet;
+//import java.util.Iterator;
+//import java.util.Set;
+//import java.util.concurrent.Executors;
+//import java.util.concurrent.ScheduledExecutorService;
+//import java.util.concurrent.TimeUnit;
+//
+///**
+// * 核心职责：
+// * 1. 实现 PositionAdapter.DistanceServiceInterface 接口，解耦Adapter与服务
+// * 2. 单例式管理位置/任务数据，提供安全增删改查接口
+// * 3. 后台单线程定时计算可见位置距离，主线程回调更新UI
+// * 4. 内置GPS信号加载（通过LocationManager实时获取位置，解决“等待GPS信号”问题）
+// * 5. 服务启动时启动前台通知（保活后台GPS功能，符合系统规范）
+// * 6. 严格Java 7语法：无Lambda/Stream，显式迭代器/匿名内部类
+// */
+//public class DistanceRefreshService extends Service {
+//    public static final String TAG = "DistanceRefreshService";
+//	
+//	
+//    // 服务状态与配置
+//    private boolean isServiceRunning = false;
+//    
+//    private static final int REFRESH_INTERVAL = 3; // 距离刷新间隔（秒）
+//    // 前台通知相关：记录是否已启动前台服务（避免重复调用startForeground）
+//    private boolean isForegroundServiceStarted = false;
+//
+//   
+//    
+//    // 服务绑定与UI回调
+//    private final IBinder mBinder = new DistanceBinder();
+//
+//    
+//
+//
+//    /**
+//     * 在主线程显示Toast（避免子线程无法显示Toast的问题）
+//     */
+//    private void showToastOnMainThread(final String message) {
+//        if (Looper.myLooper() == Looper.getMainLooper()) {
+//            Toast.makeText(this, message, Toast.LENGTH_SHORT).show();
+//        } else {
+//            new android.os.Handler(Looper.getMainLooper()).post(new Runnable() {
+//					@Override
+//					public void run() {
+//						Toast.makeText(DistanceRefreshService.this, message, Toast.LENGTH_SHORT).show();
+//					}
+//				});
+//        }
+//    }
+//
+//    // ---------------------- Binder 内部类（供外部绑定服务） ----------------------
+//    public class DistanceBinder extends Binder {
+//        /**
+//         * 外部绑定后获取服务实例（安全暴露服务引用）
+//         */
+//        public DistanceRefreshService getService() {
+//            return DistanceRefreshService.this;
+//        }
+//    }
+//
+//    
+//
+//    @Override
+//    public void onCreate() {
+//        super.onCreate();
+//		
+//        // 初始化GPS管理器（提前获取系统服务，避免启动时延迟）
+//        mLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
+//        LogUtils.d(TAG, "服务 onCreate：初始化完成，等待启动命令");
+//        run();
+//    }
+//
+//    @Override
+//    public int onStartCommand(Intent intent, int flags, int startId) {
+//        run();
+//        AppConfigsModel bean = AppConfigsModel.loadBean(DistanceRefreshService.this, AppConfigsModel.class);
+//        boolean isEnableService = (bean == null) ? false : bean.isEnableMainService();
+//        // 服务启用时返回START_STICKY（被杀死后尝试重启），禁用时返回默认值
+//        return isEnableService ? Service.START_STICKY : super.onStartCommand(intent, flags, startId);
+//    }
+//
+//    public void run() {
+//        // 仅服务未运行时启动（避免重复启动）
+//        if (!isServiceRunning) {
+//            isServiceRunning = true;
+//			
+//			
+//			
+//            startDistanceRefreshTask(); // 启动定时距离计算
+//            startForegroundNotification(); // 启动前台通知
+//            
+//            LogUtils.d(TAG, "服务 onStartCommand：启动成功，刷新间隔=" + REFRESH_INTERVAL + "秒，前台通知+GPS已启动");
+//        } else {
+//            LogUtils.w(TAG, "服务 onStartCommand：已在运行，无需重复启动（前台通知：" + (isForegroundServiceStarted ? "已启动" : "未启动") + " | GPS：" + (isGpsEnabled ? "已开启" : "未开启") + "）");
+//            // 异常场景恢复：补全未启动的组件
+//            if (!isForegroundServiceStarted) {
+//                startForegroundNotification();
+//                LogUtils.d(TAG, "服务 run：前台通知未启动，已恢复");
+//            }
+//            if (isServiceRunning && !isGpsEnabled) {
+//                startGpsLocation();
+//                LogUtils.d(TAG, "服务 run：GPS未启动，已恢复");
+//            }
+//        }
+//    }
+//
+//    @Override
+//    public IBinder onBind(Intent intent) {
+//		return null; // 按你的业务逻辑返回，无绑定需求则保留null
+//        //LogUtils.d(TAG, "服务 onBind：外部绑定成功（运行状态：" + (isServiceRunning ? "是" : "否") + " | GPS状态：" + (isGpsEnabled ? "可用" : "不可用") + "）");
+//        //return mBinder; // 返回Binder实例，供外部获取服务
+//    }
+//
+//    /*@Override
+//	 public boolean onUnbind(Intent intent) {
+//	 LogUtils.d(TAG, "服务 onUnbind：外部解绑，清理回调与可见位置");
+//	 // 解绑后清理资源，避免内存泄漏
+//	 mDistanceReceiver = null;
+//	 mVisiblePositionIds.clear();
+//	 // 解绑时不停止GPS（服务仍在后台运行，需持续获取位置）
+//	 return super.onUnbind(intent);
+//	 }*/
+//
+//    @Override
+//    public void onDestroy() {
+//        super.onDestroy();
+//		
+//        LogUtils.d(TAG, "服务 onDestroy：销毁完成，资源已释放（GPS+前台通知+线程池）");
+//    }
+//
+//    // ---------------------- 前台服务通知管理（与GPS状态联动优化） ----------------------
+//    /**
+//     * 启动前台服务通知（调用NotificationUtils创建通知，确保仅启动一次）
+//     */
+//    private void startForegroundNotification() {
+//        // 1. 校验：避免重复调用startForeground（系统不允许重复启动）
+//        if (isForegroundServiceStarted) {
+//            LogUtils.w(TAG, "startForegroundNotification：前台通知已启动，无需重复执行");
+//            return;
+//        }
+//
+//        try {
+//// 2. 初始化通知状态文本（根据GPS初始状态动态显示，避免固定“等待”）
+//			String initialStatus;
+//			if (isGpsPermissionGranted && isGpsEnabled) {
+//				initialStatus = "GPS已就绪，正在获取位置（刷新间隔" + REFRESH_INTERVAL + "秒）";
+//			} else if (!isGpsPermissionGranted) {
+//				initialStatus = "缺少定位权限，无法获取GPS位置";
+//			} else {
+//				initialStatus = "GPS未开启，请在设置中打开";
+//			}
+//
+//
+//// 5. 标记前台服务已启动
+//			isForegroundServiceStarted = true;
+//			LogUtils.d(TAG, "startForegroundNotification：前台服务通知启动成功，初始状态：" + initialStatus);
+//
+//		} catch (Exception e) {
+//// 捕获异常（如上下文失效、通知渠道未创建）
+//			isForegroundServiceStarted = false;
+//			LogUtils.d(TAG, "startForegroundNotification：前台通知启动失败" + e);
+//		}
+//	}
+//
+//
+//
+//	/**
+//
+//	 - 主线程回调Adapter更新UI（避免跨线程操作UI异常）
+//	 */
+//	/*private void notifyDistanceUpdateToUI(final String positionId) {
+//	 if (Looper.myLooper() == Looper.getMainLooper()) {
+//	 if (mDistanceReceiver != null) {
+//	 mDistanceReceiver.onDistanceUpdate(positionId);
+//	 }
+//	 } else {
+//	 new android.os.Handler(Looper.getMainLooper()).post(new Runnable() {
+//	 @Override
+//	 public void run() {
+//	 if (mDistanceReceiver != null) {
+//	 mDistanceReceiver.onDistanceUpdate(positionId);
+//	 }
+//	 }
+//	 });
+//	 }
+//	 }*/
+//
+//
+//
+//
+//
+//// ---------------------- 实现 PositionAdapter.DistanceServiceInterface 接口 ----------------------
+//
+//	public ArrayList getPositionList() {
+//		if (!isServiceRunning) {
+//			LogUtils.w(TAG, "getPositionList：服务未运行，返回空列表");
+//			return new ArrayList();
+//		}
+//		return new ArrayList(mPositionList);
+//	}
+//
+//
+//	public ArrayList getPositionTasksList() {
+//		if (!isServiceRunning) {
+//			LogUtils.w(TAG, "getPositionTasksList：服务未运行，返回空列表");
+//			return new ArrayList();
+//		}
+//		return new ArrayList(mTaskList);
+//	}
+//
+//	
+//	
+//
+//	/*public void setOnDistanceUpdateReceiver(PositionAdapter.OnDistanceUpdateReceiver receiver) {
+//		this.mDistanceReceiver = receiver;
+//		LogUtils.d(TAG, "setOnDistanceUpdateReceiver：回调接收器已设置（" + (receiver != null ? "有效" : "无效") + "）");
+//	}*/
+//
+//	public void addVisibleDistanceView(String positionId) {
+//		if (!isServiceRunning || positionId == null) {
+//			LogUtils.w(TAG, "addVisibleDistanceView：服务未运行/位置ID无效，添加失败");
+//			return;
+//		}
+//		if (mVisiblePositionIds.add(positionId)) {
+//			LogUtils.d(TAG, "addVisibleDistanceView：添加成功（位置ID=" + positionId + "，当前可见数=" + mVisiblePositionIds.size() + "）");
+//// 新增：添加可见位置后，立即更新通知（显示最新可见数量）
+//			if (isForegroundServiceStarted && mCurrentGpsPosition != null) {
+//				syncGpsStatusToNotification();
+//			}
+//		}
+//	}
+//
+//	public void removeVisibleDistanceView(String positionId) {
+//		if (positionId == null) {
+//			LogUtils.w(TAG, "removeVisibleDistanceView：位置ID为空，移除失败");
+//			return;
+//		}
+//		if (mVisiblePositionIds.remove(positionId)) {
+//			int remainingCount = mVisiblePositionIds.size();
+//			LogUtils.d(TAG, "removeVisibleDistanceView：移除成功（位置ID=" + positionId + "，当前可见数=" + remainingCount + "）");
+//// 新增：移除可见位置后，更新通知（同步数量变化）
+//			if (isForegroundServiceStarted && mCurrentGpsPosition != null) {
+//				syncGpsStatusToNotification();
+//			}
+//		}
+//	}
+//
+//	public void clearVisibleDistanceViews() {
+//		mVisiblePositionIds.clear();
+//		LogUtils.d(TAG, "clearVisibleDistanceViews：所有可见位置已清空");
+//// 新增：清空可见位置后，更新通知（提示计算暂停）
+//		if (isForegroundServiceStarted) {
+//			updateNotificationGpsStatus("无可见位置，距离计算暂停");
+//		}
+//	}
+//
+//// ---------------------- 数据管理接口（修复原有语法错误+优化逻辑） ----------------------
+//	/**
+//
+//	 - 获取服务运行状态
+//	 */
+//	public boolean isServiceRunning() {
+//		return isServiceRunning;
+//	}
+//
+//	/**
+//
+//	 - 添加位置（修复迭代器泛型缺失问题）
+//	 */
+//	public void addPosition(PositionModel position) {
+//		if (!isServiceRunning || position == null || position.getPositionId() == null) {
+//			LogUtils.w(TAG, "addPosition：服务未运行/数据无效，添加失败");
+//			return;
+//		}// 修复：显式声明PositionModel泛型，避免类型转换警告
+//		boolean isDuplicate = false;
+//		Iterator posIter = mPositionList.iterator();
+//		while (posIter.hasNext()) {
+//			PositionModel existingPos = (PositionModel)posIter.next();
+//			if (position.getPositionId().equals(existingPos.getPositionId())) {
+//				isDuplicate = true;
+//				break;
+//			}
+//		}if (!isDuplicate) {
+//			mPositionList.add(position);
+//			LogUtils.d(TAG, "addPosition：添加成功（位置ID=" + position.getPositionId() + "，总数=" + mPositionList.size() + "）");
+//		} else {
+//			LogUtils.w(TAG, "addPosition：位置ID=" + position.getPositionId() + "已存在，添加失败");
+//		}
+//	}
+//
+//	/**
+//
+//	 - 删除位置（修复任务删除时的类型转换错误）
+//	 */
+//	public void removePosition(String positionId) {
+//		if (!isServiceRunning || positionId == null) {
+//			LogUtils.w(TAG, "removePosition：服务未运行/位置ID无效，删除失败");
+//			return;
+//		}// 1. 删除位置
+//		boolean isRemoved = false;
+//		Iterator posIter = mPositionList.iterator();
+//		while (posIter.hasNext()) {
+//			PositionModel pos = (PositionModel)posIter.next();
+//			if (positionId.equals(pos.getPositionId())) {
+//				posIter.remove();
+//				isRemoved = true;
+//				break;
+//			}
+//		}if (isRemoved) {
+//// 修复：任务列表迭代时用PositionTaskModel泛型（原错误用PositionModel导致转换失败）
+//			Iterator taskIter = mTaskList.iterator();
+//			while (taskIter.hasNext()) {
+//				PositionTaskModel task = (PositionTaskModel)taskIter.next();
+//				if (positionId.equals(task.getPositionId())) {
+//					taskIter.remove();
+//				}
+//			}// 3. 移除可见位置
+//			mVisiblePositionIds.remove(positionId);
+//			LogUtils.d(TAG, "removePosition：删除成功（位置ID=" + positionId + "，剩余位置数=" + mPositionList.size() + "，剩余任务数=" + mTaskList.size() + "）");
+//		} else {
+//			LogUtils.w(TAG, "removePosition：位置ID=" + positionId + "不存在，删除失败");
+//		}
+//	}
+//
+//	/**
+//
+//	 - 更新位置信息（修复代码格式+迭代器泛型）
+//	 */
+//	public void updatePosition(PositionModel updatedPosition) {
+//		if (!isServiceRunning || updatedPosition == null || updatedPosition.getPositionId() == null) {
+//			LogUtils.w(TAG, "updatePosition：服务未运行/数据无效，更新失败");
+//			return;
+//		}boolean isUpdated = false;
+//		Iterator posIter = mPositionList.iterator();
+//		while (posIter.hasNext()) {
+//			PositionModel pos = (PositionModel)posIter.next();
+//			if (updatedPosition.getPositionId().equals(pos.getPositionId())) {
+//				pos.setMemo(updatedPosition.getMemo());
+//				pos.setIsEnableRealPositionDistance(updatedPosition.isEnableRealPositionDistance());
+//				if (!updatedPosition.isEnableRealPositionDistance()) {
+//					pos.setRealPositionDistance(-1);
+//					//notifyDistanceUpdateToUI(pos.getPositionId());
+//				}
+//				isUpdated = true;
+//				break;
+//			}
+//		}if (isUpdated) {
+//			LogUtils.d(TAG, "updatePosition：更新成功（位置ID=" + updatedPosition.getPositionId() + "）");
+//		} else {
+//			LogUtils.w(TAG, "updatePosition：位置ID=" + updatedPosition.getPositionId() + "不存在，更新失败");
+//		}
+//	}
+//
+//	/**
+//
+//	 - 同步任务列表（修复泛型缺失+代码格式）
+//	 */
+//	public void syncAllPositionTasks(ArrayList tasks) {
+//		if (!isServiceRunning || tasks == null) {
+//			LogUtils.w(TAG, "syncAllPositionTasks：服务未运行/任务列表为空，同步失败");
+//			return;
+//		}// 1. 清空旧任务
+//		mTaskList.clear();
+//// 2. 添加新任务（修复泛型+去重逻辑）
+//		Set taskIdSet = new HashSet();
+//		Iterator taskIter = tasks.iterator();
+//		while (taskIter.hasNext()) {
+//			PositionTaskModel task = (PositionTaskModel)taskIter.next();
+//			if (task != null && task.getTaskId() != null && !taskIdSet.contains(task.getTaskId())) {
+//				taskIdSet.add(task.getTaskId());
+//				mTaskList.add(task);
+//			}
+//		}LogUtils.d(TAG, "syncAllPositionTasks：同步成功（接收任务数=" + tasks.size() + "，去重后=" + mTaskList.size() + "）");
+//	}
+//
+//
+//
+//
+//// ---------------------- 补充：修复LocationProvider引用缺失问题（避免编译错误） ----------------------
+//// 注：原代码中onStatusChanged使用LocationProvider枚举，需补充静态导入或显式声明
+//// 此处通过内部静态类定义，解决系统API引用问题（兼容Java 7语法）
+//	private static class LocationProvider {
+//		public static final int AVAILABLE = 2;
+//		public static final int OUT_OF_SERVICE = 0;
+//		public static final int TEMPORARILY_UNAVAILABLE = 1;
+//	}
+//
+//// ---------------------- 补充：Context引用工具（避免服务销毁后Context失效） ----------------------
+//	/*private Context getSafeContext() {
+//	 // 服务未销毁时返回自身Context，已销毁时返回应用Context（避免内存泄漏）
+//	 if (isDestroyed()) {
+//	 return getApplicationContext();
+//	 }
+//	 return this;
+//	 }*/
+//
+//// 注：isDestroyed()为API 17+方法，若需兼容更低版本，可添加版本判断
+//	/*private boolean isDestroyed() {
+//	 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
+//	 return super.isDestroyed();
+//	 }
+//	 // 低版本通过状态标记间接判断（服务销毁时会置为false）
+//	 return !isServiceRunning && !isForegroundServiceStarted;
+//	 }*/
+//}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/services/IdleGpsService.java b/positions/src/main/java/cc/winboll/studio/positions/services/IdleGpsService.java
new file mode 100644
index 0000000..7c75003
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/services/IdleGpsService.java
@@ -0,0 +1,182 @@
+package cc.winboll.studio.positions.services;
+
+import android.os.Handler;
+import android.os.Looper;
+
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.positions.handlers.AppIdleRunningModeHandler;
+import cc.winboll.studio.positions.models.PositionModel;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 空转GPS模拟服务
+ * 在应用空转模式下，模拟系统GPS服务向客户端发送坐标数据
+ */
+public class IdleGpsService {
+
+    private static final long MOCK_INTERVAL_MS = 5000; // 模拟坐标更新间隔（5秒）
+    private static final long BEARING_INTERVAL_MS = 1000; // 角动量递增间隔（1秒）
+    private static final double EARTH_RADIUS_M = 6371000; // 地球平均半径（米）
+    private static final double ANCHOR_LAT = 39.9042; // 固定锚点纬度（北京）
+    private static final double ANCHOR_LON = 116.4074; // 固定锚点经度（北京）
+    private static final double CIRCLE_RADIUS_M = 50; // 移动轨迹半径（米）
+
+    private static IdleGpsService instance;
+    private final List<MainService.GpsUpdateListener> listeners = new ArrayList<>();
+    private final Handler handler;
+    private final Runnable updateRunnable;
+    private final Runnable bearingRunnable;
+    private final PositionModel mockPosition;
+    private boolean isRunning;
+    private int currentBearing = 1; // 当前角动量度数（1-360）
+
+    private IdleGpsService() {
+        handler = new Handler(Looper.getMainLooper());
+        mockPosition = new PositionModel();
+        mockPosition.setPositionId("mock_idle_pos");
+        mockPosition.setMemo("空转模拟坐标");
+
+        updateRunnable = new Runnable() {
+            @Override
+            public void run() {
+                if (isRunning) {
+                    calculatePosition();
+                    notifyListeners(mockPosition);
+                    AppIdleRunningModeHandler.sendIdleLog("模拟GPS数据更新 -> 纬度:" + mockPosition.getLatitude() + ", 经度:" + mockPosition.getLongitude() + ", 角度:" + currentBearing + "°");
+                    handler.postDelayed(this, MOCK_INTERVAL_MS);
+                }
+            }
+        };
+
+        bearingRunnable = new Runnable() {
+            @Override
+            public void run() {
+                if (isRunning) {
+                    currentBearing++;
+                    if (currentBearing > 360) {
+                        currentBearing = 1;
+                    }
+                    handler.postDelayed(this, BEARING_INTERVAL_MS);
+                }
+            }
+        };
+    }
+
+    private void calculatePosition() {
+        double bearingRad = Math.toRadians(currentBearing);
+        double angularDistance = CIRCLE_RADIUS_M / EARTH_RADIUS_M;
+
+        double anchorLatRad = Math.toRadians(ANCHOR_LAT);
+        double anchorLonRad = Math.toRadians(ANCHOR_LON);
+
+        double newLatRad = Math.asin(
+            Math.sin(anchorLatRad) * Math.cos(angularDistance) +
+            Math.cos(anchorLatRad) * Math.sin(angularDistance) * Math.cos(bearingRad)
+        );
+
+        double newLonRad = anchorLonRad + Math.atan2(
+            Math.sin(bearingRad) * Math.sin(angularDistance) * Math.cos(anchorLatRad),
+            Math.cos(angularDistance) - Math.sin(anchorLatRad) * Math.sin(newLatRad)
+        );
+
+        mockPosition.setLatitude(Math.toDegrees(newLatRad));
+        mockPosition.setLongitude(Math.toDegrees(newLonRad));
+    }
+
+    public static IdleGpsService getInstance() {
+        if (instance == null) {
+            instance = new IdleGpsService();
+        }
+        return instance;
+    }
+
+    /**
+     * 启动空转模拟服务
+     */
+    public void start() {
+        if (isRunning) return;
+        isRunning = true;
+        currentBearing = 1;
+        AppIdleRunningModeHandler.sendIdleLog("空转GPS服务已启动");
+        notifyStatusChange("空转GPS服务已启动");
+        ToastUtils.show("空转GPS服务已启动");
+        handler.post(updateRunnable);
+        handler.post(bearingRunnable);
+    }
+
+    /**
+     * 停止空转模拟服务
+     */
+    public void stop() {
+        if (!isRunning) return;
+        isRunning = false;
+        handler.removeCallbacks(updateRunnable);
+        handler.removeCallbacks(bearingRunnable);
+        notifyStatusChange("空转GPS服务已停止");
+        AppIdleRunningModeHandler.sendIdleLog("空转GPS服务已停止");
+    }
+
+    /**
+     * 注册GPS监听
+     */
+    public void registerGpsUpdateListener(MainService.GpsUpdateListener listener) {
+        synchronized (listeners) {
+            if (!listeners.contains(listener)) {
+                listeners.add(listener);
+            }
+        }
+        if (!isRunning) {
+            start();
+        }
+    }
+
+    /**
+     * 注销GPS监听
+     */
+    public void unregisterGpsUpdateListener(MainService.GpsUpdateListener listener) {
+        synchronized (listeners) {
+            listeners.remove(listener);
+        }
+        if (listeners.isEmpty() && isRunning) {
+            stopMockUpdate();
+        }
+    }
+
+    private void startMockUpdate() {
+        if (isRunning) return;
+        isRunning = true;
+        currentBearing = 1;
+        notifyStatusChange("空转GPS服务已启动");
+        handler.post(updateRunnable);
+        handler.post(bearingRunnable);
+    }
+
+    private void stopMockUpdate() {
+        isRunning = false;
+        handler.removeCallbacks(updateRunnable);
+        handler.removeCallbacks(bearingRunnable);
+        notifyStatusChange("空转GPS服务已停止");
+    }
+
+    private void notifyListeners(PositionModel pos) {
+        synchronized (listeners) {
+            for (MainService.GpsUpdateListener listener : listeners) {
+                listener.onGpsPositionUpdated(pos);
+            }
+        }
+    }
+
+    private void notifyStatusChange(String status) {
+        synchronized (listeners) {
+            for (MainService.GpsUpdateListener listener : listeners) {
+                listener.onGpsStatusChanged(status);
+            }
+        }
+    }
+
+    public boolean isRunning() {
+        return isRunning;
+    }
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/services/MainService.java b/positions/src/main/java/cc/winboll/studio/positions/services/MainService.java
new file mode 100644
index 0000000..517cfcf
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/services/MainService.java
@@ -0,0 +1,1133 @@
+package cc.winboll.studio.positions.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用主要服务组件类
+ */
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.content.pm.PackageManager;
+import android.location.Location;
+import android.location.LocationListener;
+import android.location.LocationManager;
+import android.location.LocationProvider;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.IBinder;
+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.App;
+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 java.lang.ref.WeakReference;
+import java.util.ArrayList;
+import java.util.HashSet;
+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);
+        void onGpsStatusChanged(String status);
+    }
+
+    // 空转GPS监听实例（用于注册到IdleGpsService）
+    private final GpsUpdateListener mIdleGpsListener = new GpsUpdateListener() {
+        @Override
+        public void onGpsPositionUpdated(PositionModel currentGpsPos) {
+            handleGpsPositionUpdate(currentGpsPos);
+        }
+
+        @Override
+        public void onGpsStatusChanged(String status) {
+            handleGpsStatusChange(status);
+        }
+    };
+
+    // 中央处理：GPS 位置更新
+    private void handleGpsPositionUpdate(PositionModel pos) {
+        if (pos == null) return;
+        syncCurrentGpsPosition(pos);
+        DistanceCalculatorUtil.getInstance(MainService.this).checkAllTaskTriggerCondition(pos);
+        String src = App.isAppIdleRunning() ? " (空转)" : "";
+        LogUtils.d(TAG, "GPS位置更新：纬度=" + pos.getLatitude() + "，经度=" + pos.getLongitude() + src);
+    }
+
+    // 中央处理：GPS 状态变化
+    private void handleGpsStatusChange(String status) {
+        LogUtils.d(TAG, "GPS状态变化：" + status);
+        notifyAllGpsStatusListeners(status);
+        updateNotificationGpsStatus(status);
+    }
+
+    // 任务更新监听接口（Java 7 风格，供Adapter监听任务变化）
+    public interface TaskUpdateListener {
+        void onTaskUpdated();
+    }
+
+    // 监听管理（弱引用+线程安全集合，适配Java 7，避免内存泄漏+并发异常）
+    private final Set<WeakReference<GpsUpdateListener>> mGpsListeners = new HashSet<WeakReference<GpsUpdateListener>>();
+    private final Set<WeakReference<TaskUpdateListener>> mTaskListeners = new HashSet<WeakReference<TaskUpdateListener>>();
+    private final Object mListenerLock = new Object(); // 监听操作锁，保证线程安全
+
+    // 原有核心变量（Java 7 显式初始化，无Java 8+语法）
+	private LocalBinder mLocalBinder; //持有 LocalBinder 实例（用于暴露服务）
+    private LocationManager mLocationManager;
+    private LocationListener mGpsLocationListener;
+    private static final long GPS_UPDATE_INTERVAL = 2000; // GPS更新间隔：2秒
+    private static final float GPS_UPDATE_DISTANCE = 1;   // GPS更新距离阈值：1米
+    private boolean isGpsEnabled = false;                 // GPS是否启用标记
+    private boolean isGpsPermissionGranted = false;       // 定位权限是否授予标记
+
+    // 数据存储集合（Java 7 基础集合，避免Stream/forEach等Java 8+特性）
+    private final ArrayList<PositionModel> mPositionList = new ArrayList<PositionModel>();   // 位置数据列表
+    private final ArrayList<PositionTaskModel> mAllTasks = new ArrayList<PositionTaskModel>();// 任务数据列表
+    private static PositionModel _mCurrentGpsPosition; // 当前GPS定位数据
+    private boolean isListeningToIdleGps = false; // 当前是否监听空转GPS
+
+    // 服务相关变量（Java 7 显式声明，保持原逻辑）
+    MyServiceConnection mMyServiceConnection;
+    volatile static boolean _mIsServiceRunning; // 服务运行状态（volatile保证可见性）
+    AppConfigsUtil mAppConfigsUtil;
+    private ScheduledExecutorService distanceExecutor = Executors.newSingleThreadScheduledExecutor(); // 单线程池处理距离计算
+    private final Set<String> mVisiblePositionIds = new HashSet<String>(); // 可见位置ID集合
+
+    // 单例+应用上下文（Java 7 静态变量，保证服务实例唯一+上下文安全）
+    private static volatile MainService sInstance;
+    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）
+    // =========================================================================
+    /**
+     * 新增任务（Adapter调用，通过MainService统一管理任务，保证数据一致性）
+     * @param newTask 待新增的任务模型
+     */
+    public void addTask(PositionTaskModel newTask) {
+        // 参数校验（Java 7 基础判断，无Optional等Java 8+特性）
+        if (newTask == null || TextUtils.isEmpty(newTask.getPositionId())) {
+            LogUtils.w(TAG, "addPositionTask：任务为空或未绑定位置ID，新增失败");
+            return;
+        }
+
+        // 任务去重（Java 7 迭代器遍历，避免增强for循环删除/新增导致的并发异常）
+        boolean isDuplicate = false;
+        Iterator<PositionTaskModel> taskIter = mAllTasks.iterator();
+        while (taskIter.hasNext()) {
+            PositionTaskModel task = taskIter.next();
+            if (newTask.getTaskId().equals(task.getTaskId())) {
+                isDuplicate = true;
+                break;
+            }
+        }
+        if (isDuplicate) {
+            LogUtils.w(TAG, "addPositionTask：任务ID已存在（" + newTask.getTaskId() + "），新增失败");
+            return;
+        }
+
+        // 新增任务+持久化+通知刷新（全Java 7 语法）
+        mAllTasks.add(newTask);
+        saveAllTasks();
+        notifyTaskUpdated(); // 通知所有监听者（如Adapter）任务已更新
+        LogUtils.d(TAG, "addPositionTask：成功（位置ID=" + newTask.getPositionId() + "，任务ID=" + newTask.getTaskId() + "）");
+    }
+
+    /**
+     * 获取指定位置的所有任务（Adapter显示任务数量用，数据来源唯一）
+     * @param positionId 位置ID
+     * @return 该位置绑定的所有任务（返回新列表，避免外部修改原数据）
+     */
+    public ArrayList<PositionTaskModel> getTasksByPositionId(String positionId) {
+        ArrayList<PositionTaskModel> posTasks = new ArrayList<PositionTaskModel>();
+        if (TextUtils.isEmpty(positionId) || mAllTasks.isEmpty()) {
+            return posTasks;
+        }
+
+        // 筛选任务（Java 7 迭代器遍历，安全筛选）
+        Iterator<PositionTaskModel> taskIter = mAllTasks.iterator();
+        while (taskIter.hasNext()) {
+            PositionTaskModel task = taskIter.next();
+            if (positionId.equals(task.getPositionId())) {
+                posTasks.add(task);
+            }
+        }
+        return posTasks;
+    }
+
+    /**
+     * 获取所有任务（Adapter全量刷新用，返回拷贝避免原数据被外部修改）
+     * @return 所有任务的拷贝列表
+     */
+    public ArrayList<PositionTaskModel> getAllTasks() {
+        return mAllTasks; // 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(final String taskId) {
+        if (TextUtils.isEmpty(taskId) || mAllTasks.isEmpty()) {
+            LogUtils.w(TAG, "deletePositionTask：任务ID为空或列表为空，删除失败");
+            return;
+        }
+
+		// 迭代器删除（Java 7 唯一安全删除集合元素的方式）
+		Iterator<PositionTaskModel> taskIter = mAllTasks.iterator();
+		while (taskIter.hasNext()) {
+			PositionTaskModel task = taskIter.next();
+			if (taskId.equals(task.getTaskId())) {
+				taskIter.remove(); // 迭代器安全删除，无ConcurrentModificationException
+				saveAllTasks();
+				notifyTaskUpdated();
+				LogUtils.d(TAG, "deletePositionTask：成功（任务ID=" + taskId + "）");
+				break;
+			}
+		}
+    }
+
+    /**
+     * 注册任务更新监听（Java 7 弱引用管理，避免内存泄漏）
+     * @param listener 任务更新监听者（如Adapter）
+     */
+    public void registerTaskUpdateListener(TaskUpdateListener listener) {
+        if (listener == null) {
+            LogUtils.w(TAG, "registerTaskUpdateListener：监听者为空，跳过");
+            return;
+        }
+        synchronized (mListenerLock) { // 加锁保证多线程注册安全
+            mTaskListeners.add(new WeakReference<TaskUpdateListener>(listener));
+        }
+    }
+
+    /**
+     * 反注册任务更新监听（Java 7 迭代器清理，避免内存泄漏）
+     * @param listener 待反注册的监听者
+     */
+    public void unregisterTaskUpdateListener(TaskUpdateListener listener) {
+        if (listener == null) {
+            LogUtils.w(TAG, "unregisterTaskUpdateListener：监听者为空，跳过");
+            return;
+        }
+        synchronized (mListenerLock) {
+            Iterator<WeakReference<TaskUpdateListener>> iter = mTaskListeners.iterator();
+            while (iter.hasNext()) {
+                WeakReference<TaskUpdateListener> ref = iter.next();
+                // 清理目标监听者或已被回收的弱引用
+                if (ref.get() == listener || ref.get() == null) {
+                    iter.remove();
+                }
+            }
+        }
+    }
+
+    /**
+     * 通知所有任务监听者更新（Java 7 匿名内部类实现主线程回调，无Lambda）
+     */
+    private void notifyTaskUpdated() {
+        synchronized (mListenerLock) {
+            Iterator<WeakReference<TaskUpdateListener>> iter = mTaskListeners.iterator();
+            while (iter.hasNext()) {
+                final WeakReference<TaskUpdateListener> ref = iter.next();
+                if (ref.get() != null) {
+                    // 判断是否在主线程，不在则切换（Java 7 匿名Runnable，无Lambda）
+                    if (Looper.myLooper() == Looper.getMainLooper()) {
+                        ref.get().onTaskUpdated();
+                    } else {
+                        new Handler(Looper.getMainLooper()).post(new Runnable() {
+								@Override
+								public void run() {
+									ref.get().onTaskUpdated();
+								}
+							});
+                    }
+                } else {
+                    iter.remove(); // 清理已回收的弱引用，避免内存泄漏
+                }
+            }
+        }
+    }
+
+
+    // =========================================================================
+    // 原有基础方法（Java 7 语法调整：移除所有Lambda/方法引用，用匿名内部类替代）
+    // =========================================================================
+    /**
+     * 获取服务单例（Java 7 静态同步方法，保证线程安全）
+     * @param context 上下文
+     * @return MainService实例（未绑定成功时返回null）
+     */
+    public static synchronized MainService getInstance(Context context) {
+        if (sInstance == null) {
+			if (AppConfigsUtil.getInstance(context).isEnableMainService(true)) {
+				Intent intent = new Intent(context.getApplicationContext(), MainService.class);
+				context.getApplicationContext().startService(intent);
+			}
+            return null;
+        }
+        if (sAppContext == null) {
+            sAppContext = sInstance.getApplicationContext();
+        }
+        return sInstance;
+    }
+
+    /**
+     * 服务绑定回调（Java 7 基础实现，无默认方法等Java 8+特性）
+     */
+    @Override
+	public IBinder onBind(Intent intent) {
+		// 返回 LocalBinder，使Activity能通过Binder获取MainService实例
+		return mLocalBinder;
+	}
+
+    /**
+     * 服务创建回调（初始化单例、上下文、配置、服务连接等）
+     */
+    @Override
+    public void onCreate() {
+        LogUtils.d(TAG, "onCreate");
+        super.onCreate();
+        sInstance = this;
+        sAppContext = getApplicationContext();
+
+		// 初始化 LocalBinder（关键：将MainService实例传入Binder）
+		mLocalBinder = new LocalBinder(this); 
+
+        _mIsServiceRunning = false;
+        mAppConfigsUtil = AppConfigsUtil.getInstance(this);
+
+        // 初始化服务连接（Java 7 显式判断，无Optional）
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+        }
+
+		if (mAppConfigsUtil.isEnableMainService(true)) {
+            if (App.isAppIdleRunning()) {
+                IdleGpsService.getInstance().start();
+            }
+			run(); // 启动服务核心逻辑
+		}
+    }
+
+    /**
+     * 服务核心逻辑（启动前台服务、初始化GPS、加载数据等）
+     * 【关键修改】新增定时器初始化，每1分钟调用任务校验
+     */
+    public void run() {
+        if (mAppConfigsUtil.isEnableMainService(true)) {
+            if (!_mIsServiceRunning) {
+                _mIsServiceRunning = true;
+                wakeupAndBindAssistant(); // 唤醒并绑定辅助服务
+
+                // 启动前台服务（Java 7 显式调用，无方法引用）
+                String initialStatus = "[ Positions ] is in Service.";
+                if (App.isAppIdleRunning()) {
+                    initialStatus += " [IDLE RUNNING]";
+                }
+                NotificationUtil.createForegroundServiceNotification(this, initialStatus);
+                startForeground(NotificationUtil.FOREGROUND_SERVICE_NOTIFICATION_ID,
+								NotificationUtil.createForegroundServiceNotification(this, initialStatus));
+
+                // 初始化GPS相关（Java 7 基础API调用）
+                mLocationManager = (LocationManager) sInstance.getApplicationContext().getSystemService(Context.LOCATION_SERVICE);
+                initGpsLocationListener();
+                startGpsLocation();
+
+                // 加载本地数据（Java 7 静态方法调用，无方法引用）
+                PositionModel.loadBeanList(MainService.this, mPositionList, PositionModel.class);
+                PositionTaskModel.loadBeanList(MainService.this, mAllTasks, PositionTaskModel.class);
+
+				// 提示与日志（Java 7 基础调用）
+                ToastUtils.show(initialStatus);
+                LogUtils.i(TAG, initialStatus);
+
+                // ---------------------- 关键新增：启动任务校验定时器 ----------------------
+				//checkAllTaskTriggerCondition();
+				initTaskCheckTimer();
+            }
+        }
+    }
+
+    /**
+     * 获取服务运行状态
+     * @return true=运行中，false=未运行
+     */
+    public boolean isServiceRunning() {
+        return _mIsServiceRunning;
+    }
+
+    /**
+     * 服务销毁回调（清理资源、停止GPS、清空数据、反注册监听等）
+     * 【关键修改】新增定时器销毁，避免内存泄漏
+     */
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        sInstance = null;
+
+        // 清理资源（Java 7 顺序调用，无Stream等特性）
+        stopGpsLocation();
+        clearAllData();
+        stopForeground(true);
+
+        // 清理所有监听者（Java 7 加锁+清空，避免内存泄漏）
+        synchronized (mListenerLock) {
+            mGpsListeners.clear();
+            mTaskListeners.clear();
+        }
+
+        // ---------------------- 关键新增：销毁任务校验定时器 ----------------------
+        destroyTaskCheckTimer();
+        // 销毁距离计算线程池（原有逻辑，补充确保线程安全）
+        if (distanceExecutor != null && !distanceExecutor.isShutdown()) {
+            distanceExecutor.shutdown();
+        }
+
+        // 重置状态变量
+        _mIsServiceRunning = false;
+        isGpsEnabled = false;
+        mLocationManager = null;
+    }
+
+
+    // =========================================================================
+    // 位置操作方法（Java 7 语法，全迭代器/基础循环，无Java 8+特性）
+    // =========================================================================
+    /**
+     * 获取所有位置数据（返回原列表，供外部读取）
+     * @return 位置列表
+     */
+    public ArrayList<PositionModel> getPositionList() {
+        return mPositionList;
+    }
+
+    /**
+     * 获取当前GPS位置
+     * @return 当前GPS定位模型（未获取时返回null）
+     */
+    public PositionModel getCurrentGpsPosition() {
+        return _mCurrentGpsPosition;
+    }
+
+    /**
+     * 删除指定位置（Java 7 迭代器安全删除）
+     * @param targetPosId 待删除位置的ID
+     */
+    public void removePosition(String targetPosId) {
+        if (TextUtils.isEmpty(targetPosId) || mPositionList.isEmpty()) {
+            LogUtils.w(TAG, "removePosition：参数无效");
+            return;
+        }
+        // 迭代器遍历删除（Java 7 安全方式）
+        Iterator<PositionModel> iter = mPositionList.iterator();
+        while (iter.hasNext()) {
+            PositionModel pos = iter.next();
+            if (targetPosId.equals(pos.getPositionId())) {
+                iter.remove();
+                savePositionList();
+                break;
+            }
+        }
+    }
+
+    /**
+     * 更新位置数据（Java 7 基础for循环，无Stream筛选）
+     * @param updatedPos 更新后的位置模型
+     */
+    public void updatePosition(PositionModel updatedPos) {
+        if (updatedPos == null || TextUtils.isEmpty(updatedPos.getPositionId()) || mPositionList.isEmpty()) {
+            LogUtils.w(TAG, "updatePosition：参数无效");
+            return;
+        }
+        // 基础for循环查找并更新（Java 7 标准写法）
+        for (int i = 0; i < mPositionList.size(); i++) {
+            PositionModel oldPos = mPositionList.get(i);
+            if (updatedPos.getPositionId().equals(oldPos.getPositionId())) {
+                mPositionList.set(i, updatedPos);
+                savePositionList();
+                break;
+            }
+        }
+    }
+
+    /**
+     * 同步所有位置任务（全量替换，用于批量更新）
+     * @param newTaskList 新的任务列表
+     */
+    public void syncAllPositionTasks(ArrayList<PositionTaskModel> newTaskList) {
+        if (newTaskList == null) {
+            LogUtils.w(TAG, "syncAllPositionTasks：新列表为空");
+            return;
+        }
+        // 全量替换+持久化+通知（Java 7 基础集合操作）
+        mAllTasks.clear();
+        mAllTasks.addAll(newTaskList);
+        saveAllTasks();
+        notifyTaskUpdated();
+    }
+
+    /**
+     * 新增位置（Java 7 增强for循环去重，无Stream）
+     * @param newPos 待新增的位置模型
+     */
+    public void addPosition(PositionModel newPos) {
+        if (newPos == null) {
+            LogUtils.w(TAG, "addPosition：位置为空");
+            return;
+        }
+        // 位置去重（Java 7 增强for循环，无Stream.filter）
+        boolean isDuplicate = false;
+        for (PositionModel pos : mPositionList) {
+            if (newPos.getPositionId().equals(pos.getPositionId())) {
+                isDuplicate = true;
+                break;
+            }
+        }
+        if (!isDuplicate) {
+            mPositionList.add(newPos);
+            savePositionList();
+        }
+    }
+
+    /**
+     * 持久化位置数据（Java 7 静态方法调用，保持原逻辑）
+     */
+    void savePositionList() {
+        LogUtils.d(TAG, String.format("savePositionList : size=%d", mPositionList.size()));
+        PositionModel.saveBeanList(MainService.this, mPositionList, PositionModel.class);
+    }
+
+    /**
+     * 持久化任务数据（Java 7 静态方法调用，保持原逻辑）
+     */
+    public void saveAllTasks() {
+        LogUtils.d(TAG, String.format("saveTaskList : size=%d", mAllTasks.size()));
+        PositionTaskModel.saveBeanList(MainService.this, mAllTasks, PositionTaskModel.class);
+    }
+
+    /**
+     * 清空所有数据（位置+任务+GPS缓存，Java 7 集合clear方法）
+     */
+    public void clearAllData() {
+        mPositionList.clear();
+        mAllTasks.clear();
+        _mCurrentGpsPosition = null;
+        LogUtils.d(TAG, "clearAllData：已清空所有数据");
+    }
+
+    /**
+     * 同步当前GPS位置（更新缓存+通知监听者+同步通知栏，全Java 7 语法）
+     * @param position 最新GPS位置模型
+     */
+    public void syncCurrentGpsPosition(PositionModel position) {
+        if (position == null) {
+            LogUtils.w(TAG, "syncCurrentGpsPosition：位置为空");
+            return;
+        }
+        this._mCurrentGpsPosition = position;
+        LogUtils.d(TAG, "syncCurrentGpsPosition：成功（纬度=" + position.getLatitude() + "，经度=" + position.getLongitude() + "）");
+        notifyAllGpsListeners(position);
+
+        // 服务运行中才同步通知栏状态
+        if (_mIsServiceRunning) {
+            syncGpsStatusToNotification();
+        }
+    }
+
+    /**
+     * 同步GPS状态到前台通知（Java 7 匿名Runnable切换主线程，无Lambda）
+     */
+    private void syncGpsStatusToNotification() {
+        if (!_mIsServiceRunning || _mCurrentGpsPosition == null) {
+            return;
+        }
+        // 根据空转状态决定通知前缀（区分空转GPS与真实GPS）
+        String prefix = App.isAppIdleRunning() ? "空转GPS" : "GPS位置";
+        // 格式化通知内容（Java 7 String.format，使用%.15f显示全部GPS精度）
+        String gpsStatus = String.format(
+			"%s：北纬%.15f° 东经%.15f° | 可见位置：%d个",
+			prefix,
+			_mCurrentGpsPosition.getLatitude(),
+			_mCurrentGpsPosition.getLongitude(),
+			mVisiblePositionIds.size()
+        );
+        if (App.isAppIdleRunning()) {
+            gpsStatus += " [IDLE RUNNING]";
+        }
+        final String finalGpsStatus = gpsStatus;
+        // 主线程判断+切换（Java 7 匿名内部类）
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            NotificationUtil.updateForegroundServiceStatus(this, finalGpsStatus);
+        } else {
+            new Handler(Looper.getMainLooper()).post(new Runnable() {
+					@Override
+					public void run() {
+						NotificationUtil.updateForegroundServiceStatus(MainService.this, finalGpsStatus);
+					}
+				});
+        }
+    }
+
+
+
+
+    // =========================================================================
+    // 服务生命周期+辅助服务相关（Java 7 语法，无Lambda/方法引用）
+    // =========================================================================
+    /**
+     * 服务启动命令（每次startService调用时触发，重启服务核心逻辑）
+     */
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+		boolean isSettingToEnable = false;
+		if (intent != null) {
+			isSettingToEnable = intent.getBooleanExtra(EXTRA_IS_SETTING_TO_ENABLE, false);
+			if (isSettingToEnable) {
+                if (App.isAppIdleRunning()) {
+                    IdleGpsService.getInstance().start();
+                }
+				run(); // 重启服务核心逻辑（保证服务启动后进入运行状态）
+			}
+		}
+
+        // 如果被设置为自启动就返回START_STICKY：服务被异常杀死后，系统会尝试重启（原逻辑保留）
+		// 否则就启动默认参数
+        return isSettingToEnable ? Service.START_STICKY : super.onStartCommand(intent, flags, startId);
+    }
+
+    /**
+     * 服务连接内部类（Java 7 静态内部类，避免持有外部类强引用导致内存泄漏）
+     */
+    private class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            // 原逻辑保留（空实现，如需绑定辅助服务可补充具体逻辑）
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            // 辅助服务断开时，重新唤醒绑定（原逻辑保留）
+            if (mAppConfigsUtil.isEnableMainService(true)) {
+                wakeupAndBindAssistant();
+            }
+        }
+    }
+
+    /**
+	 * 唤醒并绑定辅助服务（检查服务状态，未存活则启动+绑定）
+     */
+    void wakeupAndBindAssistant() {
+        // 检查辅助服务是否存活（Java 7 静态方法调用，无方法引用）
+        if (!ServiceUtil.isServiceAlive(getApplicationContext(), AssistantService.class.getName())) {
+            // 启动+绑定辅助服务（Java 7 显式Intent，无Lambda）
+            startService(new Intent(MainService.this, AssistantService.class));
+            bindService(new Intent(MainService.this, AssistantService.class), mMyServiceConnection, Context.BIND_IMPORTANT);
+        }
+    }
+
+
+    // =========================================================================
+    // GPS相关核心方法（Java 7 语法，匿名内部类实现LocationListener，无Lambda）
+    // =========================================================================
+    /**
+     * 构造函数（Java 7 显式初始化线程池+GPS监听器，无默认构造函数简化）
+     */
+    public MainService() {
+        distanceExecutor = Executors.newSingleThreadScheduledExecutor();
+        initGpsLocationListener();
+    }
+
+    /**
+     * 初始化GPS监听器（Java 7 匿名内部类实现LocationListener，无Lambda）
+     */
+    private void initGpsLocationListener() {
+        LogUtils.d(TAG, "initGpsLocationListener");
+        mGpsLocationListener = new LocationListener() {
+            @Override
+            public void onLocationChanged(Location location) {
+                if (location != null) {
+                    // 封装GPS位置为PositionModel（Java 7 显式setter调用）
+                    PositionModel gpsPos = new PositionModel();
+                    gpsPos.setLatitude(location.getLatitude());
+                    gpsPos.setLongitude(location.getLongitude());
+                    gpsPos.setPositionId("CURRENT_GPS_POS");
+                    gpsPos.setMemo("实时GPS位置");
+
+                    // 调用中央处理方法
+                    handleGpsPositionUpdate(gpsPos);
+                }
+            }
+
+            @Override
+            public void onStatusChanged(String provider, int status, Bundle extras) {
+                // 仅处理GPS_PROVIDER状态变化（Java 7 基础判断）
+                if (provider.equals(LocationManager.GPS_PROVIDER)) {
+                    String statusDesc = "";
+                    // 状态枚举判断（Java 7 switch，无增强switch）
+                    switch (status) {
+                        case LocationProvider.AVAILABLE:
+                            statusDesc = "GPS状态：已就绪（可用）";
+                            break;
+                        case LocationProvider.OUT_OF_SERVICE:
+                            statusDesc = "GPS状态：无服务（信号弱）";
+                            break;
+                        case LocationProvider.TEMPORARILY_UNAVAILABLE:
+                            statusDesc = "GPS状态：临时不可用（遮挡）";
+                            break;
+                    }
+                    handleGpsStatusChange(statusDesc);
+                }
+            }
+
+            @Override
+            public void onProviderEnabled(String provider) {
+                // GPS启用时更新状态+通知+重启定位（Java 7 基础逻辑）
+                if (provider.equals(LocationManager.GPS_PROVIDER)) {
+                    isGpsEnabled = true;
+                    handleGpsStatusChange("GPS已开启（用户手动打开）");
+                    startGpsLocation();
+                }
+            }
+
+            @Override
+            public void onProviderDisabled(String provider) {
+                // GPS禁用时清空状态+通知+提示（Java 7 基础逻辑）
+                if (provider.equals(LocationManager.GPS_PROVIDER)) {
+                    isGpsEnabled = false;
+                    _mCurrentGpsPosition = null;
+                    handleGpsStatusChange("GPS已关闭（用户手动关闭）");
+                    ToastUtils.show("GPS已关闭，无法获取位置，请在设置中开启");
+                }
+            }
+        };
+    }
+
+    /**
+     * 检查GPS就绪状态（权限+启用状态，Java 7 基础权限判断，无Stream）
+     * @return true=GPS就绪，false=未就绪
+     */
+    private boolean checkGpsReady() {
+        // 检查定位权限（Java 7 基础权限API，无权限请求框架依赖）
+        isGpsPermissionGranted = checkSelfPermission(android.Manifest.permission.ACCESS_FINE_LOCATION)
+			== PackageManager.PERMISSION_GRANTED;
+
+        // 初始化LocationManager（Java 7 显式判断，无Optional）
+        if (mLocationManager == null) {
+			mLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
+        }
+        // 检查GPS是否启用（系统LocationManager API，Java 7 兼容）
+        isGpsEnabled = mLocationManager.isProviderEnabled(LocationManager.GPS_PROVIDER);
+
+        // 权限未授予：提示+日志+通知
+        if (!isGpsPermissionGranted) {
+            String tip = "GPS准备失败：缺少精确定位权限";
+            LogUtils.e(TAG, tip);
+            notifyAllGpsStatusListeners(tip);
+            updateNotificationGpsStatus("缺少定位权限，无法获取GPS");
+            ToastUtils.show("请授予定位权限，否则无法获取GPS位置");
+            return false;
+        }
+        // GPS未启用：提示+日志+通知
+        if (!isGpsEnabled) {
+            String tip = "GPS准备失败：系统GPS未开启";
+            LogUtils.e(TAG, tip);
+            notifyAllGpsStatusListeners(tip);
+            updateNotificationGpsStatus("GPS未开启，请在设置中打开");
+            ToastUtils.show("GPS已关闭，请在设置中开启以获取位置");
+            return false;
+        }
+
+        LogUtils.d(TAG, "GPS准备就绪：权限已获取，GPS已开启");
+        return true;
+    }
+
+    /**
+     * 启动GPS定位（Java 7 异常处理，无try-with-resources，显式捕获SecurityException）
+     * 【关键修改】根据应用空转状态切换数据源（IdleGpsService 或 系统GPS）
+     */
+    private void startGpsLocation() {
+        // 检查空转状态：如果处于空转，使用 IdleGpsService
+        if (App.isAppIdleRunning()) {
+            if (isListeningToIdleGps) return; // 已在监听空转GPS，无需重复注册
+            stopGpsLocation(); // 停止系统GPS监听（如果正在运行）
+            IdleGpsService.getInstance().registerGpsUpdateListener(mIdleGpsListener);
+            isListeningToIdleGps = true;
+            LogUtils.d(TAG, "启动GPS定位：使用空转模拟数据");
+            handleGpsStatusChange("空转GPS监听中...");
+            return;
+        }
+
+        // 系统GPS逻辑
+        if (isListeningToIdleGps) {
+            // 之前是空转，现在切换到系统GPS
+            IdleGpsService.getInstance().unregisterGpsUpdateListener(mIdleGpsListener);
+            isListeningToIdleGps = false;
+        }
+
+        if (!checkGpsReady()) {
+            return;
+        }
+
+        try {
+            // 注册GPS位置更新（Java 7 标准LocationManager API，指定Looper为主线程）
+            mLocationManager.requestLocationUpdates(
+				LocationManager.GPS_PROVIDER,
+				GPS_UPDATE_INTERVAL,
+				GPS_UPDATE_DISTANCE,
+				mGpsLocationListener,
+				Looper.getMainLooper()
+            );
+
+            // 获取最后已知GPS位置（缓存位置，避免首次定位等待）
+            Location lastKnownLocation = mLocationManager.getLastKnownLocation(LocationManager.GPS_PROVIDER);
+            if (lastKnownLocation != null) {
+                PositionModel lastGpsPos = new PositionModel();
+                lastGpsPos.setLatitude(lastKnownLocation.getLatitude());
+                lastGpsPos.setLongitude(lastKnownLocation.getLongitude());
+                lastGpsPos.setPositionId("CURRENT_GPS_POS");
+                handleGpsPositionUpdate(lastGpsPos);
+                LogUtils.d(TAG, "已获取缓存GPS位置：纬度=" + lastKnownLocation.getLatitude());
+            } else {
+                String tip = "无缓存GPS位置，等待实时定位...";
+                handleGpsStatusChange(tip);
+                updateNotificationGpsStatus("GPS搜索中（请移至开阔地带）");
+            }
+
+        } catch (SecurityException e) {
+            // 定位权限异常（Java 7 显式捕获，无Lambda异常处理）
+            String error = "启动GPS失败（权限异常）：" + e.getMessage();
+            LogUtils.e(TAG, error);
+            handleGpsStatusChange(error);
+            isGpsPermissionGranted = false;
+            updateNotificationGpsStatus("定位权限异常，无法获取GPS");
+        } catch (Exception e) {
+            // 其他异常（如LocationManager为空、系统服务异常等）
+            String error = "启动GPS失败：" + e.getMessage();
+            LogUtils.e(TAG, error);
+            handleGpsStatusChange(error);
+            updateNotificationGpsStatus("GPS启动失败，尝试重试...");
+        }
+    }
+
+    /**
+     * 停止GPS定位（Java 7 异常处理，移除监听器避免内存泄漏）
+     * 【关键修改】根据当前监听源停止对应的服务
+     */
+    private void stopGpsLocation() {
+        if (isListeningToIdleGps) {
+            IdleGpsService.getInstance().unregisterGpsUpdateListener(mIdleGpsListener);
+            isListeningToIdleGps = false;
+            LogUtils.d(TAG, "停止GPS定位：已注销空转GPS监听");
+        } else {
+            // 校验参数：避免空指针+权限未授予时调用
+            if (mLocationManager != null && mGpsLocationListener != null && isGpsPermissionGranted) {
+                try {
+                    mLocationManager.removeUpdates(mGpsLocationListener);
+                    String tip = "GPS定位已停止（移除监听器）";
+                    LogUtils.d(TAG, tip);
+                    handleGpsStatusChange(tip);
+                } catch (Exception e) {
+                    String error = "停止GPS失败：" + e.getMessage();
+                    LogUtils.e(TAG, error);
+                    handleGpsStatusChange(error);
+                }
+            }
+        }
+    }
+
+    /**
+     * 发送任务触发通知（更新前台通知+显示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) {
+        if (_mIsServiceRunning) {
+            String text = statusText;
+            if (App.isAppIdleRunning()) {
+                text += " [IDLE RUNNING]";
+            }
+            final String finalText = text;
+            // 判断当前线程是否为主线程，避免UI操作在子线程
+            if (Looper.myLooper() == Looper.getMainLooper()) {
+                NotificationUtil.updateForegroundServiceStatus(this, finalText);
+            } else {
+                new Handler(Looper.getMainLooper()).post(new Runnable() {
+						@Override
+						public void run() {
+							NotificationUtil.updateForegroundServiceStatus(MainService.this, finalText);
+						}
+					});
+            }
+        }
+    }
+
+
+    // =========================================================================
+    // GPS监听通知相关方法（Java 7 迭代器遍历弱引用集合，避免内存泄漏）
+    // =========================================================================
+    /**
+     * 通知所有GPS监听者位置更新（Java 7 迭代器+弱引用管理，无Stream）
+     * @param currentGpsPos 当前最新GPS位置
+     */
+    public void notifyAllGpsListeners(PositionModel currentGpsPos) {
+        if (currentGpsPos == null || mGpsListeners.isEmpty()) {
+            return;
+        }
+        synchronized (mListenerLock) {
+            Iterator<WeakReference<GpsUpdateListener>> iter = mGpsListeners.iterator();
+            while (iter.hasNext()) {
+                WeakReference<GpsUpdateListener> ref = iter.next();
+                GpsUpdateListener listener = ref.get();
+                if (listener != null) {
+                    notifySingleListener(listener, currentGpsPos);
+                } else {
+                    iter.remove(); // 清理已被GC回收的监听者，避免内存泄漏
+                }
+            }
+        }
+    }
+
+    /**
+     * 通知单个GPS监听者位置更新（主线程安全，Java 7 匿名Runnable）
+     * @param listener 单个监听者
+     * @param currentGpsPos 当前GPS位置
+     */
+    private void notifySingleListener(final GpsUpdateListener listener, final PositionModel currentGpsPos) {
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            listener.onGpsPositionUpdated(currentGpsPos);
+        } else {
+            new Handler(Looper.getMainLooper()).post(new Runnable() {
+					@Override
+					public void run() {
+						listener.onGpsPositionUpdated(currentGpsPos);
+					}
+				});
+        }
+    }
+
+    /**
+     * 通知所有GPS监听者状态变化（如GPS开启/关闭、信号弱等，Java 7 迭代器）
+     * @param status GPS状态描述文本
+     */
+    private void notifyAllGpsStatusListeners(final String status) {
+        if (status == null || mGpsListeners.isEmpty()) {
+            return;
+        }
+        synchronized (mListenerLock) {
+            Iterator<WeakReference<GpsUpdateListener>> iter = mGpsListeners.iterator();
+            while (iter.hasNext()) {
+                WeakReference<GpsUpdateListener> ref = iter.next();
+                final GpsUpdateListener listener = ref.get();
+                if (listener != null) {
+                    // 主线程切换，避免监听者在子线程处理UI
+                    if (Looper.myLooper() == Looper.getMainLooper()) {
+                        listener.onGpsStatusChanged(status);
+                    } else {
+                        new Handler(Looper.getMainLooper()).post(new Runnable() {
+								@Override
+								public void run() {
+									listener.onGpsStatusChanged(status);
+								}
+							});
+                    }
+                } else {
+                    iter.remove(); // 清理无效弱引用
+                }
+            }
+        }
+    }
+
+    /**
+     * 注册GPS更新监听（Java 7 弱引用添加，避免监听者内存泄漏）
+     * @param listener GPS更新监听者（如Activity/Adapter）
+     */
+    public void registerGpsUpdateListener(GpsUpdateListener listener) {
+        if (listener == null) {
+            LogUtils.w(TAG, "registerGpsUpdateListener：监听者为空");
+            return;
+        }
+        synchronized (mListenerLock) {
+            mGpsListeners.add(new WeakReference<GpsUpdateListener>(listener));
+            LogUtils.d(TAG, "GPS监听注册成功，当前数量：" + mGpsListeners.size());
+            // 注册后立即推送当前GPS位置（避免监听者错过初始数据）
+            if (_mCurrentGpsPosition != null) {
+                notifySingleListener(listener, _mCurrentGpsPosition);
+            }
+        }
+    }
+
+    /**
+     * 反注册GPS更新监听（Java 7 迭代器清理，避免内存泄漏）
+     * @param listener 待反注册的GPS监听者
+     */
+    public void unregisterGpsUpdateListener(GpsUpdateListener listener) {
+        if (listener == null) {
+            LogUtils.w(TAG, "unregisterGpsUpdateListener：监听者为空");
+            return;
+        }
+        synchronized (mListenerLock) {
+            Iterator<WeakReference<GpsUpdateListener>> iter = mGpsListeners.iterator();
+            while (iter.hasNext()) {
+                WeakReference<GpsUpdateListener> ref = iter.next();
+                // 匹配目标监听者或已回收的弱引用，直接移除
+                if (ref.get() == listener || ref.get() == null) {
+                    iter.remove();
+                    LogUtils.d(TAG, "GPS监听反注册成功，当前数量：" + mGpsListeners.size());
+                    break;
+                }
+            }
+        }
+    }
+
+	// 补全 LocalBinder 定义（与 LocationActivity 中的 LocalBinder 保持一致）
+	// 注意：若 LocationActivity 已定义 LocalBinder，此处可删除；建议统一在 MainService 中定义，避免重复
+	public class LocalBinder extends android.os.Binder {
+		private MainService mService;
+
+		public LocalBinder(MainService service) {
+			this.mService = service;
+		}
+
+		public MainService getService() {
+			return mService;
+		}
+	}
+
+}
+
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/utils/AppConfigsUtil.java b/positions/src/main/java/cc/winboll/studio/positions/utils/AppConfigsUtil.java
new file mode 100644
index 0000000..3110de7
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/utils/AppConfigsUtil.java
@@ -0,0 +1,68 @@
+package cc.winboll.studio.positions.utils;
+import android.content.Context;
+import cc.winboll.studio.positions.models.AppConfigsModel;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/10/01 12:15
+ * @Describe AppConfigsUtils
+ */
+public class AppConfigsUtil {
+
+    public static final String TAG = "AppConfigsUtils";
+
+    // 1. 私有静态成员变量（volatile 防止指令重排，确保实例初始化完全）
+    private static volatile AppConfigsUtil sInstance;
+	Context mContext;
+	AppConfigsModel mAppConfigsModel;
+
+    // 2. 私有构造方法（禁止外部 new 实例）
+    private AppConfigsUtil(Context context) {
+        // 可选：防止通过反射创建实例（增强单例安全性）
+        if (sInstance != null) {
+            throw new RuntimeException("禁止通过反射创建单例实例");
+        }
+		mContext = context;
+		loadConfigs();
+    }
+
+    // 3. 公开静态方法（双重校验锁，获取唯一实例）
+    public static AppConfigsUtil getInstance(Context context) {
+        // 第一次校验：无锁，快速判断实例是否存在（提升性能）
+        if (sInstance == null) {
+            // 加锁：确保同一时间只有一个线程进入初始化逻辑
+            synchronized (AppConfigsUtil.class) {
+                // 第二次校验：防止多线程并发时重复创建实例（线程安全）
+                if (sInstance == null) {
+                    sInstance = new AppConfigsUtil(context);
+                }
+            }
+        }
+        return sInstance;
+    }
+
+	public void loadConfigs() {
+		mAppConfigsModel = AppConfigsModel.loadBean(mContext, AppConfigsModel.class);
+	}
+
+	public void saveConfigs() {
+		AppConfigsModel.saveBean(mContext, mAppConfigsModel);
+	}
+
+	public boolean isEnableMainService(boolean isReloadConfigs) {
+		if (isReloadConfigs) {
+			loadConfigs();
+		}
+
+		return (mAppConfigsModel == null) ?false: mAppConfigsModel.isEnableMainService();
+	}
+
+	public void setIsEnableMainService(boolean isEnableMainService) {
+		if(mAppConfigsModel == null) {
+			mAppConfigsModel = new AppConfigsModel();
+		}
+		mAppConfigsModel.setIsEnableMainService(isEnableMainService);
+		saveConfigs();
+	}
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/utils/DensityUtils.java b/positions/src/main/java/cc/winboll/studio/positions/utils/DensityUtils.java
new file mode 100644
index 0000000..828d376
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/utils/DensityUtils.java
@@ -0,0 +1,45 @@
+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;
+	}
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/utils/DistanceCalculatorUtil.java b/positions/src/main/java/cc/winboll/studio/positions/utils/DistanceCalculatorUtil.java
new file mode 100644
index 0000000..25c65da
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/utils/DistanceCalculatorUtil.java
@@ -0,0 +1,246 @@
+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);
+    }
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/utils/NotificationUtil.java b/positions/src/main/java/cc/winboll/studio/positions/utils/NotificationUtil.java
new file mode 100644
index 0000000..4cc459d
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/utils/NotificationUtil.java
@@ -0,0 +1,193 @@
+package cc.winboll.studio.positions.utils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/30 16:09
+ * @Describe NotificationUtils（适配API 30，修复系统默认铃声获取，任务通知循环响铃）
+ */
+import android.app.Notification;
+import android.app.NotificationChannel;
+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;
+
+/**
+ * 通知栏工具类：
+ * 1. 任务通知：铃声循环播放（适配API 30），修复系统默认铃声获取方式
+ * 2. 前台服务通知：低打扰（无声无震动），符合API 30规范
+ */
+public class NotificationUtil {
+    public static final String TAG = "NotificationUtils";
+    // 任务通知常量（独立渠道，确保循环铃声配置不冲突）
+    private static final String TASK_NOTIFICATION_CHANNEL_ID = "task_notification_channel_01";
+    private static final String TASK_NOTIFICATION_CHANNEL_NAME = "任务通知（循环铃声）";
+    // 前台服务通知常量（独立渠道，低打扰）
+    private static final String FOREGROUND_SERVICE_CHANNEL_ID = "foreground_location_service_channel_02";
+    private static final String FOREGROUND_SERVICE_CHANNEL_NAME = "位置服务";
+    public static final int FOREGROUND_SERVICE_NOTIFICATION_ID = 10086; // 固定前台服务通知ID
+
+    // ---------------------- 核心：任务通知（循环响铃+修复系统默认铃声） ----------------------
+    private static int getNotificationId(String taskId) {
+        return taskId.hashCode() & 0xFFFFFF; // 确保通知ID唯一且非负
+    }
+
+    public static void show(Context context, String taskId, String positionId, String taskDescription) {
+        if (context == null || taskId == null || positionId == null) {
+            return;
+        }
+
+        NotificationManager notificationManager = 
+            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+        if (notificationManager == null) {
+            return;
+        }
+
+        // 1. 初始化通知渠道（配置循环铃声参数，使用修复后的铃声获取方式）
+        createNotificationChannel(notificationManager);
+
+        // 2. 点击跳转Intent（携带任务/位置参数，适配API 30页面栈）
+        Intent jumpIntent = new Intent(context, LocationActivity.class);
+        jumpIntent.putExtra("EXTRA_POSITION_ID", positionId);
+        jumpIntent.putExtra("EXTRA_TASK_ID", taskId);
+        jumpIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
+
+        // 3. PendingIntent（API 30强制加IMMUTABLE，避免安全异常）
+        PendingIntent pendingIntent = PendingIntent.getActivity(
+            context,
+            getNotificationId(taskId),
+            jumpIntent,
+            PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT
+        );
+
+        // 4. 构建通知（核心：循环响铃+修复的系统默认铃声）
+        NotificationCompat.Builder builder = new NotificationCompat.Builder(context, TASK_NOTIFICATION_CHANNEL_ID)
+            .setSmallIcon(R.mipmap.ic_launcher) // API 30强制要求，否则通知不显示
+            .setContentTitle("任务提醒")
+            .setContentText(taskDescription)
+            .setContentIntent(pendingIntent)
+            .setAutoCancel(true) // 点击后取消通知，停止循环响铃
+            .setPriority(NotificationCompat.PRIORITY_DEFAULT) // 确保铃声能正常播放（API 30规则）
+            //.setVibrationPattern(new long[]{0, 300, 200, 300}) // 震动与铃声同步循环
+            .setOnlyAlertOnce(false); // 重复通知也触发循环提醒
+
+        // 关键修复：用RingtoneManager获取系统默认通知铃声（替代废弃的NotificationManager.getDefaultUri）
+        Uri defaultNotificationRingtone = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);
+        if (defaultNotificationRingtone != null) {
+            builder.setSound(defaultNotificationRingtone); // 设置系统默认铃声
+        } else {
+            builder.setDefaults(NotificationCompat.DEFAULT_SOUND); // 极端情况：铃声Uri为空时，用默认提醒音兜底
+        }
+
+        // 5. 循环响铃核心：设置FLAG_INSISTENT（通知未取消则持续循环）
+        Notification notification = builder.build();
+        notification.flags |= Notification.FLAG_INSISTENT;
+
+        // 6. 显示通知（触发循环响铃）
+        notificationManager.notify(getNotificationId(taskId), notification);
+    }
+
+    // ---------------------- 核心：创建通知渠道（修复铃声配置，适配API 30） ----------------------
+    private static void createNotificationChannel(NotificationManager notificationManager) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            // 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保持一致，确保铃声统一）
+            Uri channelDefaultRingtone = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);
+            taskChannel.setSound(channelDefaultRingtone, null); // 绑定系统默认铃声到渠道
+
+            // 2. 前台服务渠道（低打扰，无声无震动）
+            NotificationChannel foregroundChannel = new NotificationChannel(
+                FOREGROUND_SERVICE_CHANNEL_ID,
+                FOREGROUND_SERVICE_CHANNEL_NAME,
+                NotificationManager.IMPORTANCE_LOW
+            );
+            foregroundChannel.setDescription("位置服务运行中，无声音/震动提醒");
+            foregroundChannel.enableVibration(false);
+            foregroundChannel.setSound(null, null); // 明确关闭铃声
+            foregroundChannel.setShowBadge(false);
+
+            // 注册渠道（API 30覆盖旧配置，确保修复后的铃声生效）
+            notificationManager.createNotificationChannel(taskChannel);
+            notificationManager.createNotificationChannel(foregroundChannel);
+        }
+    }
+
+    // ---------------------- 原有功能：取消任务通知（停止循环响铃） ----------------------
+    public static void cancel(Context context, String taskId) {
+        if (context == null || taskId == null) {
+            return;
+        }
+        NotificationManager notificationManager = 
+            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+        if (notificationManager != null) {
+            notificationManager.cancel(getNotificationId(taskId)); // 取消后循环铃声自动停止
+        }
+    }
+
+    // ---------------------- 前台服务通知（适配API 30，无声无震动） ----------------------
+    public static Notification createForegroundServiceNotification(Context context, String serviceStatus) {
+        if (context == null) {
+            throw new IllegalArgumentException("Context cannot be null for foreground service notification");
+        }
+
+        // 确保前台服务渠道已创建（低打扰配置）
+        NotificationManager notificationManager = 
+            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
+        if (notificationManager != null) {
+            createNotificationChannel(notificationManager);
+        }
+
+        // 点击跳转Intent
+        Intent jumpIntent = new Intent(context, LocationActivity.class);
+        jumpIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
+
+        // PendingIntent（API 30必加IMMUTABLE）
+        PendingIntent pendingIntent = PendingIntent.getActivity(
+            context,
+            FOREGROUND_SERVICE_NOTIFICATION_ID,
+            jumpIntent,
+            PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT
+        );
+
+        // 构建前台服务通知（无声无震动，符合低打扰）
+        return new NotificationCompat.Builder(context, FOREGROUND_SERVICE_CHANNEL_ID)
+            .setSmallIcon(R.mipmap.ic_launcher)
+            .setContentTitle("位置服务运行中")
+            .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);
+        }
+    }
+}
+
diff --git a/positions/src/main/java/cc/winboll/studio/positions/utils/ServiceUtil.java b/positions/src/main/java/cc/winboll/studio/positions/utils/ServiceUtil.java
new file mode 100644
index 0000000..a9fa86f
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/utils/ServiceUtil.java
@@ -0,0 +1,69 @@
+package cc.winboll.studio.positions.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/19 14:30:57
+ * @Describe 应用服务组件工具类
+ */
+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 {
+    public final static String TAG = "ServiceUtil";
+
+    public static boolean isServiceAlive(Context context, String szServiceName) {
+        // 获取Activity管理者对象
+        ActivityManager manager = (ActivityManager) context
+            .getSystemService(Context.ACTIVITY_SERVICE);
+        // 获取正在运行的服务（此处设置最多取1000个）
+        List<ActivityManager.RunningServiceInfo> runningServices = manager
+            .getRunningServices(1000);
+        if (runningServices.size() <= 0) {
+            return false;
+        }
+        // 遍历，若存在名字和传入的serviceName的一致则说明存在
+        for (ActivityManager.RunningServiceInfo runningServiceInfo : runningServices) {
+            if (runningServiceInfo.service.getClassName().equals(szServiceName)) {
+                return true;
+            }
+        }
+
+        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");
+	}
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/views/DateTimePickerPopup.java b/positions/src/main/java/cc/winboll/studio/positions/views/DateTimePickerPopup.java
new file mode 100644
index 0000000..692bad8
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/views/DateTimePickerPopup.java
@@ -0,0 +1,254 @@
+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));
+    }
+}
diff --git a/positions/src/main/java/cc/winboll/studio/positions/views/PositionTaskListView.java b/positions/src/main/java/cc/winboll/studio/positions/views/PositionTaskListView.java
new file mode 100644
index 0000000..e597ebe
--- /dev/null
+++ b/positions/src/main/java/cc/winboll/studio/positions/views/PositionTaskListView.java
@@ -0,0 +1,624 @@
+package cc.winboll.studio.positions.views;
+
+/**
+ * @Describe 位置任务列表视图（适配MainService唯一数据源+同步任务状态+支持简单/编辑模式）
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2025-09-30 08:09:00
+ * @EditTime 2026-03-31 19:00:00
+ */
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.CompoundButton;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.RadioGroup;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+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;
+
+    private static final String TAG = "PositionTaskListView";
+
+    // 核心成员变量
+    private String mBindPositionId;
+    private MainService mMainService;
+    private int mCurrentViewMode;
+    private TaskListAdapter mTaskAdapter;
+    private RecyclerView mRvTasks;
+
+    // 任务修改回调接口
+    public interface OnTaskUpdatedListener {
+        void onTaskUpdated(String positionId, ArrayList<PositionTaskModel> updatedTasks);
+    }
+
+    private OnTaskUpdatedListener mOnTaskUpdatedListener;
+
+    // ---------------------- 构造函数 ----------------------
+    public PositionTaskListView(Context context) {
+        super(context);
+        LogUtils.d(TAG, "PositionTaskListView 构造函数 1 参数: context=" + context);
+        initView(context);
+    }
+
+    public PositionTaskListView(Context context, @Nullable AttributeSet attrs) {
+        super(context, attrs);
+        LogUtils.d(TAG, "PositionTaskListView 构造函数 2 参数: context=" + context + ", attrs=" + attrs);
+        initView(context);
+    }
+
+    public PositionTaskListView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        LogUtils.d(TAG, "PositionTaskListView 构造函数 3 参数: context=" + context + ", attrs=" + attrs + ", defStyleAttr=" + defStyleAttr);
+        initView(context);
+    }
+
+    // ---------------------- 初始化视图 ----------------------
+    private void initView(Context context) {
+        LogUtils.d(TAG, "initView 开始执行 参数: context=" + context);
+        setOrientation(VERTICAL);
+        LayoutInflater.from(context).inflate(R.layout.view_position_task_list, this, true);
+
+        mRvTasks = (RecyclerView) findViewById(R.id.rv_position_tasks);
+        mRvTasks.setLayoutManager(new LinearLayoutManager(context));
+
+        mTaskAdapter = new TaskListAdapter(new ArrayList<PositionTaskModel>());
+        mRvTasks.setAdapter(mTaskAdapter);
+
+        mCurrentViewMode = VIEW_MODE_SIMPLE;
+        LogUtils.d(TAG, "initView 执行完成，视图初始化完毕");
+    }
+
+    // ---------------------- 对外API ----------------------
+    public void init(MainService mainService, String positionId) {
+        LogUtils.d(TAG, "init 开始执行 参数: mainService=" + mainService + ", positionId=" + positionId);
+        if (mainService == null) {
+            LogUtils.e(TAG, "init 失败：MainService 为空");
+            showToast("任务列表初始化失败：服务未就绪");
+            return;
+        }
+        if (positionId == null || positionId.trim().isEmpty()) {
+            LogUtils.e(TAG, "init 失败：positionId 为空");
+            showToast("任务列表初始化失败：未关联位置");
+            return;
+        }
+
+        mMainService = mainService;
+        mBindPositionId = positionId;
+        LogUtils.d(TAG, "init 绑定成功：positionId=" + positionId);
+
+        syncTasksFromMainService();
+        LogUtils.d(TAG, "init 执行完成");
+    }
+
+    public void syncTasksFromMainService() {
+        LogUtils.d(TAG, "syncTasksFromMainService 开始执行");
+        if (mMainService == null || mBindPositionId == null || mBindPositionId.trim().isEmpty()) {
+            LogUtils.w(TAG, "syncTasksFromMainService 失败：服务或位置ID无效");
+            return;
+        }
+
+        try {
+            ArrayList<PositionTaskModel> allServiceTasks = mMainService.getAllTasks();
+            LogUtils.d(TAG, "syncTasksFromMainService 从服务获取任务总数: " + (allServiceTasks == null ? 0 : allServiceTasks.size()));
+
+            ArrayList<PositionTaskModel> currentPosTasks = new ArrayList<>();
+            if (allServiceTasks != null && !allServiceTasks.isEmpty()) {
+                for (PositionTaskModel task : allServiceTasks) {
+                    if (isTaskMatchedWithPosition(task)) {
+                        currentPosTasks.add(task);
+                    }
+                }
+            }
+            LogUtils.d(TAG, "syncTasksFromMainService 筛选后当前位置任务数: " + currentPosTasks.size());
+
+            mTaskAdapter.updateData(currentPosTasks);
+            LogUtils.d(TAG, "syncTasksFromMainService 执行完成，Adapter已刷新");
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "syncTasksFromMainService 异常: " + e.getMessage(), e);
+            showToast("任务同步失败，请重试");
+        }
+    }
+
+    public void setViewStatus(int viewMode) {
+        LogUtils.d(TAG, "setViewStatus 参数: viewMode=" + viewMode);
+        if (viewMode != VIEW_MODE_SIMPLE && viewMode != VIEW_MODE_EDIT) {
+            LogUtils.w(TAG, "setViewStatus 无效模式");
+            return;
+        }
+        mCurrentViewMode = viewMode;
+        mTaskAdapter.notifyDataSetChanged();
+        LogUtils.d(TAG, "setViewStatus 切换完成: " + (viewMode == VIEW_MODE_SIMPLE ? "简单模式" : "编辑模式"));
+    }
+
+    public void setOnTaskUpdatedListener(OnTaskUpdatedListener listener) {
+        LogUtils.d(TAG, "setOnTaskUpdatedListener 参数: listener=" + listener);
+        mOnTaskUpdatedListener = listener;
+    }
+
+    public ArrayList<PositionTaskModel> getCurrentPosTasks() {
+        LogUtils.d(TAG, "getCurrentPosTasks 被调用");
+        return new ArrayList<>(mTaskAdapter.getAdapterData());
+    }
+
+    public void clearData() {
+        LogUtils.d(TAG, "clearData 开始执行");
+        mTaskAdapter.updateData(new ArrayList<PositionTaskModel>());
+        mMainService = null;
+        mBindPositionId = null;
+        mCurrentViewMode = VIEW_MODE_SIMPLE;
+        LogUtils.d(TAG, "clearData 执行完成，数据已清空");
+    }
+
+    public void triggerTaskSync() {
+        LogUtils.d(TAG, "triggerTaskSync 主动触发同步");
+        syncTasksFromMainService();
+        if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
+            mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, getCurrentPosTasks());
+        }
+    }
+
+    // ---------------------- 内部工具 ----------------------
+    private boolean isTaskMatchedWithPosition(PositionTaskModel task) {
+        if (task == null || mBindPositionId == null) {
+            return false;
+        }
+        return mBindPositionId.equals(task.getPositionId());
+    }
+
+    private void showToast(String content) {
+        if (getContext() == null) return;
+        Toast.makeText(getContext(), content, Toast.LENGTH_SHORT).show();
+    }
+
+    private String genSelectedTimeText(long timeMillis) {
+        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm", Locale.getDefault());
+        return sdf.format(new Date(timeMillis));
+    }
+
+    // ---------------------- 外部新增任务 ----------------------
+    public void addNewTask(PositionTaskModel newTask) {
+        LogUtils.d(TAG, "addNewTask 参数: newTask=" + newTask);
+        if (mMainService == null) {
+            LogUtils.e(TAG, "addNewTask 失败：MainService为空");
+            showToast("新增任务失败：服务未就绪");
+            return;
+        }
+        if (newTask == null) {
+            LogUtils.e(TAG, "addNewTask 失败：任务为空");
+            showToast("新增任务失败：任务数据为空");
+            return;
+        }
+        if (mBindPositionId == null || mBindPositionId.trim().isEmpty()) {
+            LogUtils.e(TAG, "addNewTask 失败：未绑定位置");
+            showToast("新增任务失败：未关联位置");
+            return;
+        }
+
+        try {
+            newTask.setPositionId(mBindPositionId);
+            mMainService.addTask(newTask);
+            LogUtils.d(TAG, "addNewTask 服务添加成功 taskId=" + newTask.getTaskId());
+
+            syncTasksFromMainService();
+            if (mOnTaskUpdatedListener != null) {
+                mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, getCurrentPosTasks());
+            }
+            showToast("新增任务成功");
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "addNewTask 异常: " + e.getMessage(), e);
+            showToast("新增失败，请重试");
+            syncTasksFromMainService();
+        }
+    }
+
+    // ---------------------- Adapter ----------------------
+    private class TaskListAdapter extends RecyclerView.Adapter<TaskListAdapter.TaskViewHolder> {
+
+        private List<PositionTaskModel> mAdapterData;
+
+        public TaskListAdapter(List<PositionTaskModel> data) {
+            LogUtils.d(TAG, "TaskListAdapter 构造 参数 data.size=" + data.size());
+            mAdapterData = new ArrayList<>(data);
+        }
+
+        public void updateData(List<PositionTaskModel> newData) {
+            LogUtils.d(TAG, "updateData 参数 newData.size=" + (newData == null ? 0 : newData.size()));
+            if (newData == null) {
+                mAdapterData.clear();
+            } else {
+                mAdapterData = new ArrayList<>(newData);
+            }
+            notifyDataSetChanged();
+        }
+
+        public List<PositionTaskModel> getAdapterData() {
+            return new ArrayList<>(mAdapterData);
+        }
+
+        @Override
+        public int getItemCount() {
+            return mAdapterData.isEmpty() ? 1 : mAdapterData.size();
+        }
+
+        @Override
+        public int getItemViewType(int position) {
+            if (mAdapterData.isEmpty()) {
+                return 0;
+            } else {
+                return mCurrentViewMode;
+            }
+        }
+
+        @NonNull
+        @Override
+        public TaskViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+            Context context = parent.getContext();
+            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) {
+                View simpleView = inflater.inflate(R.layout.item_position_task_simple, parent, false);
+                return new SimpleTaskViewHolder(simpleView);
+            } else {
+                View editView = inflater.inflate(R.layout.item_task_content, parent, false);
+                return new TaskContentViewHolder(editView);
+            }
+        }
+
+        @Override
+        public void onBindViewHolder(@NonNull TaskViewHolder holder, int position) {
+            if (holder instanceof EmptyViewHolder) {
+                EmptyViewHolder emptyHolder = (EmptyViewHolder) holder;
+                TextView tv = emptyHolder.itemView.findViewById(R.id.tv_task_empty_tip);
+                tv.setText(mCurrentViewMode == VIEW_MODE_EDIT
+						   ? "暂无任务，点击\"添加新任务\"创建"
+						   : "暂无启用的任务");
+                return;
+            }
+
+            if (position >= mAdapterData.size()) {
+                LogUtils.w(TAG, "onBindViewHolder 越界 position=" + position);
+                return;
+            }
+
+            final PositionTaskModel task = mAdapterData.get(position);
+            if (task == null) {
+                LogUtils.w(TAG, "onBindViewHolder task为空 position=" + position);
+                return;
+            }
+
+            if (holder instanceof SimpleTaskViewHolder) {
+                SimpleTaskViewHolder h = (SimpleTaskViewHolder) holder;
+                String desc = task.getTaskDescription() == null ? "未设置描述" : task.getTaskDescription();
+                h.tvSimpleTaskDesc.setText(String.format("任务：%s", desc));
+                h.tvStartTime.setText(genSelectedTimeText(task.getStartTime()));
+                String cond = task.isGreaterThan() ? "大于(◎)" : "小于(•)";
+                h.tvSimpleDistanceCond.setText(String.format("条件：距离 %s %d 米", cond, task.getDiscussDistance()));
+                h.tvSimpleIsEnable.setText(task.isEnable() ? "状态：已启用" : "状态：已禁用");
+                h.tvSimpleIsEnable.setTextColor(task.isEnable()
+												? getContext().getResources().getColor(R.color.colorEnableGreen)
+												: getContext().getResources().getColor(R.color.colorGrayText));
+                h.vBingoDot.setVisibility(task.isBingo() ? View.VISIBLE : View.GONE);
+
+            } else if (holder instanceof TaskContentViewHolder) {
+                TaskContentViewHolder h = (TaskContentViewHolder) holder;
+                bindEditModeTask(h, task, position);
+            }
+        }
+
+        private void bindEditModeTask(final TaskContentViewHolder holder, final PositionTaskModel task, final int position) {
+            LogUtils.d(TAG, "bindEditModeTask position=" + position + " taskId=" + task.getTaskId());
+
+            String desc = task.getTaskDescription() == null ? "未设置描述" : task.getTaskDescription();
+            holder.tvTaskDesc.setText(String.format("任务：%s", desc));
+            String cond = task.isGreaterThan() ? "大于(◎)" : "小于(•)";
+            holder.tvTaskDistance.setText(String.format("条件：%s %d 米", cond, task.getDiscussDistance()));
+            holder.tvStartTime.setText(genSelectedTimeText(task.getStartTime()));
+
+            holder.cbTaskEnable.setOnCheckedChangeListener(null);
+            holder.cbTaskEnable.setChecked(task.isEnable());
+            holder.cbTaskEnable.setEnabled(mCurrentViewMode == VIEW_MODE_EDIT);
+
+            holder.btnEditTask.setVisibility(View.VISIBLE);
+            holder.btnDeleteTask.setVisibility(View.VISIBLE);
+
+            holder.btnDeleteTask.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						YesNoAlertDialog.show(getContext(), "删除任务提示", "是否删除此项位置任务？", new YesNoAlertDialog.OnDialogResultListener(){
+								@Override
+								public void onNo() {
+								}
+
+								@Override
+								public void onYes() {
+									LogUtils.d(TAG, "删除按钮点击 position=" + position + " taskId=" + task.getTaskId());
+									if (mMainService == null) {
+										showToast("删除失败：服务未就绪");
+										LogUtils.e(TAG, "删除失败：MainService为空");
+										return;
+									}
+									try {
+										mMainService.deleteTask(task.getTaskId());
+										LogUtils.d(TAG, "服务删除任务成功 taskId=" + task.getTaskId());
+										notifyItemRemoved(position);
+										notifyItemRangeChanged(position, mAdapterData.size());
+
+										if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
+											mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<>(mAdapterData));
+										}
+										showToast("任务已删除");
+
+									} catch (Exception e) {
+										LogUtils.e(TAG, "删除异常: " + e.getMessage(), e);
+										showToast("删除失败，请重试");
+										syncTasksFromMainService();
+									}
+								}
+
+							});
+					}
+				});
+
+            holder.btnEditTask.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						LogUtils.d(TAG, "编辑按钮点击 position=" + position + " taskId=" + task.getTaskId());
+						if (mMainService == null) {
+							showToast("编辑失败：服务未就绪");
+							LogUtils.e(TAG, "编辑失败：MainService为空");
+							return;
+						}
+						showEditTaskDialog(task, position);
+					}
+				});
+
+            holder.cbTaskEnable.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
+					@Override
+					public void onCheckedChanged(CompoundButton buttonView, final boolean isChecked) {
+						LogUtils.d(TAG, "开关状态变更 taskId=" + task.getTaskId() + " isChecked=" + isChecked);
+						if (mMainService == null) {
+							showToast("状态修改失败：服务未就绪");
+							buttonView.setChecked(!isChecked);
+							return;
+						}
+						try {
+							task.setIsEnable(isChecked);
+							mMainService.updateTaskStatus(task);
+							mRvTasks.post(new Runnable() {
+									@Override
+									public void run() {
+										notifyItemChanged(position);
+										if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
+											mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<>(mAdapterData));
+										}
+									}
+								});
+						} catch (Exception e) {
+							LogUtils.e(TAG, "开关变更异常: " + e.getMessage(), e);
+							buttonView.setChecked(!isChecked);
+							task.setIsEnable(!isChecked);
+							syncTasksFromMainService();
+						}
+					}
+				});
+        }
+
+        private void showEditTaskDialog(final PositionTaskModel task, final int position) {
+            LogUtils.d(TAG, "showEditTaskDialog position=" + position + " taskId=" + task.getTaskId());
+            final Context context = getContext();
+            if (context == null) {
+                LogUtils.w(TAG, "showEditTaskDialog 上下文为空");
+                return;
+            }
+
+            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 Button btnSelectTime = dialogView.findViewById(R.id.btn_select_time);
+            final TextView tvSelectedTime = dialogView.findViewById(R.id.tv_selected_time);
+
+            tvSelectedTime.setText(genSelectedTimeText(task.getStartTime()));
+
+            Calendar initCal = Calendar.getInstance();
+            initCal.setTimeInMillis(task.getStartTime());
+            int y = initCal.get(Calendar.YEAR);
+            int M = initCal.get(Calendar.MONTH) + 1;
+            int d = initCal.get(Calendar.DAY_OF_MONTH);
+            int h = initCal.get(Calendar.HOUR_OF_DAY);
+            int m = initCal.get(Calendar.MINUTE);
+
+            final DateTimePickerPopup dateTimePopup = new DateTimePickerPopup.Builder(context)
+				.setDateTimeRange(2020, 2030, 1, 12, 1, 31, 0, 23, 0, 59)
+				.setDefaultDateTime(y, M, d, h, m)
+				.setOnDateTimeSelectedListener(new DateTimePickerPopup.OnDateTimeSelectedListener() {
+					@Override
+					public void onDateTimeSelected(int year, int month, int day, int hour, int minute) {
+						Calendar cal = Calendar.getInstance();
+						cal.set(year, month - 1, day, hour, minute, 0);
+						cal.set(Calendar.MILLISECOND, 0);
+						long time = cal.getTimeInMillis();
+						tvSelectedTime.setText(genSelectedTimeText(time));
+						task.setStartTime(time);
+					}
+
+					@Override
+					public void onCancel() {}
+				})
+				.build();
+
+            btnSelectTime.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(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()));
+
+            final android.app.AlertDialog dialog = new android.app.AlertDialog.Builder(context)
+				.setView(dialogView)
+				.setCancelable(false)
+				.create();
+            dialog.show();
+
+            final OnDateSetListener listener = new OnDateSetListener() {
+                @Override
+                public void onDateSet(TimePickerDialog timePickerDialog, long p) {}
+            };
+
+            btnCancel.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						dialog.dismiss();
+					}
+				});
+
+            btnSave.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						String newDesc = etEditDesc.getText().toString().trim();
+						String distStr = etEditDistance.getText().toString().trim();
+
+						if (distStr.isEmpty()) {
+							showToast("请输入有效距离");
+							etEditDistance.requestFocus();
+							return;
+						}
+
+						int newDist;
+						try {
+							newDist = Integer.parseInt(distStr);
+							if (newDist < 1) {
+								showToast("距离不能小于1米");
+								etEditDistance.requestFocus();
+								return;
+							}
+						} catch (NumberFormatException e) {
+							showToast("距离请输入数字");
+							etEditDistance.requestFocus();
+							return;
+						}
+
+						task.setTaskDescription(newDesc);
+						task.setDiscussDistance(newDist);
+						boolean isGreater = rgDistanceCondition.getCheckedRadioButtonId() == R.id.rb_greater_than;
+						task.setIsGreaterThan(isGreater);
+						task.setPositionId(mBindPositionId);
+
+						try {
+							mMainService.updateTask(task);
+							LogUtils.d(TAG, "保存修改成功 taskId=" + task.getTaskId());
+							mAdapterData.set(position, task);
+							mRvTasks.post(new Runnable() {
+									@Override
+									public void run() {
+										notifyItemChanged(position);
+										if (mOnTaskUpdatedListener != null && mBindPositionId != null) {
+											mOnTaskUpdatedListener.onTaskUpdated(mBindPositionId, new ArrayList<>(mAdapterData));
+										}
+									}
+								});
+							dialog.dismiss();
+							showToast("任务已更新");
+						} catch (Exception e) {
+							LogUtils.e(TAG, "保存异常: " + e.getMessage(), e);
+							showToast("保存失败，请重试");
+							syncTasksFromMainService();
+						}
+					}
+				});
+        }
+
+        // ---------------------- ViewHolder ----------------------
+        public abstract class TaskViewHolder extends RecyclerView.ViewHolder {
+            public TaskViewHolder(@NonNull View itemView) {
+                super(itemView);
+            }
+        }
+
+        public class EmptyViewHolder extends TaskViewHolder {
+            public EmptyViewHolder(@NonNull View itemView) {
+                super(itemView);
+            }
+        }
+
+        public class SimpleTaskViewHolder extends TaskViewHolder {
+            TextView tvSimpleTaskDesc;
+            TextView tvSimpleDistanceCond;
+            TextView tvStartTime;
+            TextView tvSimpleIsEnable;
+            View vBingoDot;
+
+            public SimpleTaskViewHolder(@NonNull View itemView) {
+                super(itemView);
+                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);
+            }
+        }
+
+        public class TaskContentViewHolder extends TaskViewHolder {
+            TextView tvTaskDesc;
+            TextView tvTaskDistance;
+            TextView tvStartTime;
+            CompoundButton cbTaskEnable;
+            Button btnEditTask;
+            Button btnDeleteTask;
+
+            public TaskContentViewHolder(@NonNull View itemView) {
+                super(itemView);
+                tvTaskDesc = itemView.findViewById(R.id.tv_task_desc);
+                tvTaskDistance = itemView.findViewById(R.id.tv_task_distance);
+                tvStartTime = itemView.findViewById(R.id.tv_starttime);
+                cbTaskEnable = itemView.findViewById(R.id.cb_task_enable);
+                btnEditTask = itemView.findViewById(R.id.btn_edit_task);
+                btnDeleteTask = itemView.findViewById(R.id.btn_delete_task);
+            }
+        }
+    }
+}
+
diff --git a/positions/src/main/res/anim/popup_date_time_picker_in.xml b/positions/src/main/res/anim/popup_date_time_picker_in.xml
new file mode 100644
index 0000000..3998a38
--- /dev/null
+++ b/positions/src/main/res/anim/popup_date_time_picker_in.xml
@@ -0,0 +1,12 @@
+<?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>
diff --git a/positions/src/main/res/anim/popup_date_time_picker_out.xml b/positions/src/main/res/anim/popup_date_time_picker_out.xml
new file mode 100644
index 0000000..0619581
--- /dev/null
+++ b/positions/src/main/res/anim/popup_date_time_picker_out.xml
@@ -0,0 +1,12 @@
+<?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>
diff --git a/positions/src/main/res/drawable-v24/ic_launcher_foreground.xml b/positions/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 0000000..c7bd21d
--- /dev/null
+++ b/positions/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:aapt="http://schemas.android.com/aapt"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0" />
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0" />
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1" />
+</vector>
diff --git a/positions/src/main/res/drawable/activity_background.png b/positions/src/main/res/drawable/activity_background.png
new file mode 100644
index 0000000..9f40005
Binary files /dev/null and b/positions/src/main/res/drawable/activity_background.png differ
diff --git a/positions/src/main/res/drawable/bg_bingo_dot.xml b/positions/src/main/res/drawable/bg_bingo_dot.xml
new file mode 100644
index 0000000..248bd1b
--- /dev/null
+++ b/positions/src/main/res/drawable/bg_bingo_dot.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="oval">  <!-- 形状：圆形 -->
+    <solid android:color="#FF4444"/>  <!-- 填充色：亮红色（可调整色值） -->
+    <stroke
+        android:width="1dp"
+        android:color="#FFFFFF"/>
+</shape>
diff --git a/positions/src/main/res/drawable/bg_dialog_round.xml b/positions/src/main/res/drawable/bg_dialog_round.xml
new file mode 100644
index 0000000..1cacbaa
--- /dev/null
+++ b/positions/src/main/res/drawable/bg_dialog_round.xml
@@ -0,0 +1,13 @@
+<?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>
+
diff --git a/positions/src/main/res/drawable/bg_task_item.xml b/positions/src/main/res/drawable/bg_task_item.xml
new file mode 100644
index 0000000..d8a68b8
--- /dev/null
+++ b/positions/src/main/res/drawable/bg_task_item.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+
+    <solid android:color="@color/white" />
+
+    <corners android:radius="4dp" />
+
+    <stroke
+        android:width="1dp"
+        android:color="@color/gray" />
+
+    <padding
+        android:left="8dp"
+        android:top="8dp"
+        android:right="8dp"
+        android:bottom="8dp" />
+
+</shape>
+
diff --git a/positions/src/main/res/drawable/btn_cancel_bg.xml b/positions/src/main/res/drawable/btn_cancel_bg.xml
new file mode 100644
index 0000000..74ca496
--- /dev/null
+++ b/positions/src/main/res/drawable/btn_cancel_bg.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 按压状态（加深灰色） -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#666666"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+    <!-- 默认状态（浅灰色） -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#999999"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+</selector>
+
diff --git a/positions/src/main/res/drawable/btn_confirm_bg.xml b/positions/src/main/res/drawable/btn_confirm_bg.xml
new file mode 100644
index 0000000..9524b33
--- /dev/null
+++ b/positions/src/main/res/drawable/btn_confirm_bg.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 按压状态（加深蓝色） -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#303F9F"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+    <!-- 默认状态（标准蓝色） -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#3F51B5"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+</selector>
+
diff --git a/positions/src/main/res/drawable/btn_delete_bg.xml b/positions/src/main/res/drawable/btn_delete_bg.xml
new file mode 100644
index 0000000..c7f8623
--- /dev/null
+++ b/positions/src/main/res/drawable/btn_delete_bg.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#D32F2F"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#F44336"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+</selector>
+
diff --git a/positions/src/main/res/drawable/btn_dialog_cancel.xml b/positions/src/main/res/drawable/btn_dialog_cancel.xml
new file mode 100644
index 0000000..3c04c0f
--- /dev/null
+++ b/positions/src/main/res/drawable/btn_dialog_cancel.xml
@@ -0,0 +1,13 @@
+<?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>
+
diff --git a/positions/src/main/res/drawable/btn_dialog_confirm.xml b/positions/src/main/res/drawable/btn_dialog_confirm.xml
new file mode 100644
index 0000000..fa1e750
--- /dev/null
+++ b/positions/src/main/res/drawable/btn_dialog_confirm.xml
@@ -0,0 +1,9 @@
+<?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>
+
diff --git a/positions/src/main/res/drawable/btn_selector.xml b/positions/src/main/res/drawable/btn_selector.xml
new file mode 100644
index 0000000..e1be0a5
--- /dev/null
+++ b/positions/src/main/res/drawable/btn_selector.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 禁用状态：仅此处自定义（灰化样式） -->
+    <item android:state_enabled="false">
+        <shape android:shape="rectangle">
+            <solid android:color="#E0E0E0" /> <!-- 禁用背景灰（浅灰，贴近系统禁用色） -->
+            <stroke android:width="1px" android:color="#CCCCCC" /> <!-- 禁用边框灰 -->
+            <corners android:radius="2dp" /> <!-- 匹配系统按钮圆角弧度 -->
+        </shape>
+    </item>
+    <!-- 启用状态：直接复用系统默认按钮样式（与普通按钮完全一致） -->
+    <item android:state_enabled="true" android:drawable="@android:drawable/btn_default" />
+</selector>
+
diff --git a/positions/src/main/res/drawable/btn_text_selector.xml b/positions/src/main/res/drawable/btn_text_selector.xml
new file mode 100644
index 0000000..47d9836
--- /dev/null
+++ b/positions/src/main/res/drawable/btn_text_selector.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 禁用状态：文字灰（系统默认禁用文字色） -->
+    <item android:state_enabled="false" android:color="#9E9E9E" />
+    <!-- 启用状态：复用系统默认按钮文字色（与普通按钮一致） -->
+    <item android:state_enabled="true" android:color="@android:color/black" />
+</selector>
+
diff --git a/positions/src/main/res/drawable/circle_button_bg.xml b/positions/src/main/res/drawable/circle_button_bg.xml
new file mode 100644
index 0000000..5ed6038
--- /dev/null
+++ b/positions/src/main/res/drawable/circle_button_bg.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 圆形按钮背景：默认青色，按压时深色 -->
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <!-- 按钮按压状态（深色，增强交互反馈） -->
+    <item android:state_pressed="true">
+        <shape android:shape="oval"> <!-- oval=圆形 -->
+            <solid android:color="#0F9D58"/> <!-- 按压时颜色：深青色（接近Google绿，美观且醒目） -->
+            <stroke android:width="1dp" android:color="#0F9D58"/> <!-- 边框颜色与背景一致，避免白边 -->
+        </shape>
+    </item>
+
+    <!-- 按钮默认状态（青色） -->
+    <item>
+        <shape android:shape="oval">
+            <solid android:color="#14C38E"/> <!-- 默认颜色：亮青色（视觉舒适，符合悬浮按钮风格） -->
+            <stroke android:width="1dp" android:color="#14C38E"/>
+        </shape>
+    </item>
+
+</selector>
diff --git a/positions/src/main/res/drawable/edittext_bg.xml b/positions/src/main/res/drawable/edittext_bg.xml
new file mode 100644
index 0000000..85b3d28
--- /dev/null
+++ b/positions/src/main/res/drawable/edittext_bg.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:state_focused="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF"/>
+            <stroke android:width="1.5dp" android:color="#4A90E2"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF"/>
+            <stroke android:width="1dp" android:color="#DDDDDD"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+</selector>
+
diff --git a/positions/src/main/res/drawable/ic_launcher.xml b/positions/src/main/res/drawable/ic_launcher.xml
new file mode 100644
index 0000000..1fd5efd
--- /dev/null
+++ b/positions/src/main/res/drawable/ic_launcher.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+	<item 
+        android:left="15dp" 
+        android:top="15dp" 
+        android:right="15dp" 
+        android:bottom="15dp"
+        android:drawable="@drawable/ic_positions"/>
+</layer-list>
diff --git a/positions/src/main/res/drawable/ic_launcher_background.xml b/positions/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..d5fccc5
--- /dev/null
+++ b/positions/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>
diff --git a/positions/src/main/res/drawable/ic_launcher_beta.xml b/positions/src/main/res/drawable/ic_launcher_beta.xml
new file mode 100644
index 0000000..bc3dca6
--- /dev/null
+++ b/positions/src/main/res/drawable/ic_launcher_beta.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="15dp" 
+        android:top="15dp" 
+        android:right="15dp" 
+        android:bottom="15dp"
+        android:drawable="@drawable/ic_positions"/>
+</layer-list>
diff --git a/positions/src/main/res/drawable/ic_positions.png b/positions/src/main/res/drawable/ic_positions.png
new file mode 100644
index 0000000..68ea75b
Binary files /dev/null and b/positions/src/main/res/drawable/ic_positions.png differ
diff --git a/positions/src/main/res/drawable/ic_positions_plus.png b/positions/src/main/res/drawable/ic_positions_plus.png
new file mode 100644
index 0000000..4155d06
Binary files /dev/null and b/positions/src/main/res/drawable/ic_positions_plus.png differ
diff --git a/positions/src/main/res/drawable/item_bg_edit.xml b/positions/src/main/res/drawable/item_bg_edit.xml
new file mode 100644
index 0000000..589db77
--- /dev/null
+++ b/positions/src/main/res/drawable/item_bg_edit.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- res/drawable/item_bg_edit.xml -->
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 状态1：按压时（编辑项被点击，反馈明确） -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#E0E6ED" /> <!-- 按压底色：比默认深一点的灰蓝色，反馈清晰 -->
+            <corners android:radius="8dp" />  <!-- 保持圆角统一 -->
+            <stroke
+                android:width="1.5dp"
+                android:color="#A0B4C8" />    <!-- 按压时边框加深，增强视觉焦点 -->
+        </shape>
+    </item>
+
+    <!-- 状态2：默认状态（未按压，区分简单视图） -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#EEEEEE" /> <!-- 默认底色：比简单视图深，明确编辑模式 -->
+            <corners android:radius="8dp" />  <!-- 与简单视图一致的圆角，UI不割裂 -->
+            <stroke
+                android:width="1.5dp"
+                android:color="#D0D8E0" />    <!-- 淡蓝色边框，暗示“可编辑” -->
+        </shape>
+    </item>
+</selector>
+
diff --git a/positions/src/main/res/drawable/item_bg_simple.xml b/positions/src/main/res/drawable/item_bg_simple.xml
new file mode 100644
index 0000000..1617054
--- /dev/null
+++ b/positions/src/main/res/drawable/item_bg_simple.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- res/drawable/item_bg_simple.xml -->
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 状态1：按压时的背景（深一点的灰色，明确反馈点击动作） -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#E8E8E8" /> <!-- 按压底色（比默认深一点） -->
+            <corners android:radius="8dp" />  <!-- 保持和默认状态一致的圆角 -->
+            <stroke
+                android:width="1dp"
+                android:color="#E0E0E0" />
+        </shape>
+    </item>
+
+    <!-- 状态2：默认状态（未按压时的背景，和基础版一致） -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#F5F5F5" /> <!-- 默认浅灰底色 -->
+            <corners android:radius="8dp" />  <!-- 8dp圆角 -->
+            <stroke
+                android:width="1dp"
+                android:color="#E0E0E0" />    <!-- 细灰边框 -->
+        </shape>
+    </item>
+</selector>
+
diff --git a/positions/src/main/res/drawable/item_position_bg.xml b/positions/src/main/res/drawable/item_position_bg.xml
new file mode 100644
index 0000000..a6dba44
--- /dev/null
+++ b/positions/src/main/res/drawable/item_position_bg.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#F5F5F5"/>
+            <stroke android:width="1dp" android:color="#DDDDDD"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF"/>
+            <stroke android:width="1dp" android:color="#DDDDDD"/>
+            <corners android:radius="4dp"/>
+        </shape>
+    </item>
+</selector>
+
diff --git a/positions/src/main/res/drawable/shape_2px_border.xml b/positions/src/main/res/drawable/shape_2px_border.xml
new file mode 100644
index 0000000..1ca8e82
--- /dev/null
+++ b/positions/src/main/res/drawable/shape_2px_border.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle"> <!-- 矩形形状（匹配 LinearLayout ） -->
+
+    <!-- 1px 边框（关键：stroke 标签控制边框） -->
+    <stroke
+        android:width="2px"
+        android:color="?attr/colorAccent" /> <!-- 边框颜色（替换为你的颜色，如 #CCCCCC） -->
+
+    <!-- 可选：设置 LinearLayout 背景色（若需要） -->
+    <solid android:color="#00000000" /> <!-- 内部填充色，默认透明可删除 -->
+
+    <!-- 可选：设置圆角（不需要圆角可删除） -->
+    <corners android:radius="0dp" />
+</shape>
diff --git a/positions/src/main/res/drawable/shape_log_border.xml b/positions/src/main/res/drawable/shape_log_border.xml
new file mode 100644
index 0000000..6b965ca
--- /dev/null
+++ b/positions/src/main/res/drawable/shape_log_border.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android">
+    <solid android:color="#00000000"/>
+    <stroke
+        android:width="5px"
+        android:color="#888888"/>
+    <corners android:radius="6dp"/>
+</shape>
+
diff --git a/positions/src/main/res/layout/activity_about.xml b/positions/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..278c5be
--- /dev/null
+++ b/positions/src/main/res/layout/activity_about.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>
diff --git a/positions/src/main/res/layout/activity_location.xml b/positions/src/main/res/layout/activity_location.xml
new file mode 100644
index 0000000..bcfc91b
--- /dev/null
+++ b/positions/src/main/res/layout/activity_location.xml
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"/>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:padding="20dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:id="@+id/layout_location_info"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_centerHorizontal="true"
+			android:layout_marginTop="30dp"
+			android:orientation="vertical"
+			android:gravity="left">
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:layout_gravity="center"
+				android:gravity="center">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="实时位置信息"
+					android:textSize="22sp"
+					android:textStyle="bold"/>
+
+			</LinearLayout>
+
+			<TextView
+				android:id="@+id/tv_timenow"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="现在时间：等待更新..."
+				android:textSize="18sp"
+				android:layout_marginTop="10dp"/>
+
+			<TextView
+				android:id="@+id/tv_longitude"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="当前经度：等待更新..."
+				android:textSize="18sp"
+				android:layout_marginTop="10dp"/>
+
+			<TextView
+				android:id="@+id/tv_latitude"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="当前纬度：等待更新..."
+				android:textSize="18sp"
+				android:layout_marginTop="10dp"/>
+
+
+		</LinearLayout>
+
+		<androidx.recyclerview.widget.RecyclerView
+			android:id="@+id/rv_position_list"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:layout_below="@id/layout_location_info"
+			android:layout_above="@id/fab_p_button"
+			android:layout_marginTop="20dp"
+			android:paddingBottom="10dp"/>
+
+		<Button
+			android:id="@+id/fab_p_button"
+			android:layout_width="60dp"
+			android:layout_height="60dp"
+			android:layout_alignParentBottom="true"
+			android:layout_alignParentRight="true"
+			android:layout_margin="20dp"
+			android:background="@drawable/circle_button_bg"
+			android:text="P"
+			android:textColor="@android:color/white"
+			android:textSize="24sp"
+			android:elevation="6dp"
+			android:padding="0dp"
+			android:onClick="addNewPosition"/>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/activity_main.xml b/positions/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..88437c8
--- /dev/null
+++ b/positions/src/main/res/layout/activity_main.xml
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:id="@+id/llmain">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"/>
+
+	<LinearLayout
+		xmlns:app="http://schemas.android.com/apk/res-auto"
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:background="#00000000"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:background="@drawable/activity_background"
+			android:layout_margin="0dp">
+
+			<LinearLayout
+				android:layout_width="match_parent"
+				android:layout_height="0dp"
+				android:orientation="vertical"
+				android:layout_weight="1.0">
+
+				<Switch
+					android:id="@+id/switch_service_control"
+					android:text="GPS服务开关"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:layout_marginTop="100dp"
+					android:layout_marginLeft="50dp"
+					android:layout_marginRight="50dp"
+					android:background="@drawable/shape_2px_border"
+					android:paddingLeft="10dp"/>
+
+				<Button
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:layout_marginTop="10dp"
+					android:layout_marginLeft="50dp"
+					android:layout_marginRight="50dp"
+					android:onClick="onPositions"
+					android:text="位置与任务管理"
+					android:id="@+id/btn_manage_positions"
+					android:background="@drawable/btn_selector"
+					android:textColor="@drawable/btn_text_selector"
+					android:padding="12dp"/>
+
+				<ScrollView
+					android:id="@+id/scroll_idle_log"
+					android:layout_width="match_parent"
+					android:layout_height="0dp"
+					android:layout_marginTop="10dp"
+					android:layout_marginLeft="50dp"
+					android:layout_marginRight="50dp"
+					android:layout_weight="1.0"
+					android:background="@drawable/shape_log_border"
+					android:padding="8dp"
+					android:layout_marginBottom="80dp">
+
+					<TextView
+						android:id="@+id/tv_idle_log"
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content"
+						android:textIsSelectable="true"
+						android:textColor="#FF000000"/>
+
+				</ScrollView>
+
+			</LinearLayout>
+
+			<cc.winboll.studio.libaes.views.ADsBannerView
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:id="@+id/adsbanner"
+				android:layout_alignParentBottom="true"/>
+
+		</LinearLayout>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/activity_settings.xml b/positions/src/main/res/layout/activity_settings.xml
new file mode 100644
index 0000000..e01cf89
--- /dev/null
+++ b/positions/src/main/res/layout/activity_settings.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"/>
+
+	<cc.winboll.studio.libaes.views.ADsControlView
+		android:id="@+id/ads_control_view"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"/>
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/dialog_date_time_picker.xml b/positions/src/main/res/layout/dialog_date_time_picker.xml
new file mode 100644
index 0000000..1929dc6
--- /dev/null
+++ b/positions/src/main/res/layout/dialog_date_time_picker.xml
@@ -0,0 +1,74 @@
+<?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>
+
diff --git a/positions/src/main/res/layout/dialog_edit_position.xml b/positions/src/main/res/layout/dialog_edit_position.xml
new file mode 100644
index 0000000..c9245e5
--- /dev/null
+++ b/positions/src/main/res/layout/dialog_edit_position.xml
@@ -0,0 +1,41 @@
+<?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">
+
+    <!-- 1. 经度显示（灰色小字体，不可编辑） -->
+    <TextView
+        android:id="@+id/tv_edit_longitude"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textSize="14sp"
+        android:textColor="#666666"
+        android:layout_marginBottom="8dp"/>
+
+    <!-- 2. 纬度显示（灰色小字体，不可编辑） -->
+    <TextView
+        android:id="@+id/tv_edit_latitude"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textSize="14sp"
+        android:textColor="#666666"
+        android:layout_marginBottom="16dp"/>
+
+    <!-- 3. 备注输入框（可编辑，带提示文字，适配多行输入） -->
+    <EditText
+        android:id="@+id/et_edit_memo"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="请输入位置备注（如：公司/家/学校）"
+        android:textSize="16sp"
+        android:inputType="textMultiLine"
+        android:minLines="3"
+        android:maxLines="5"
+        android:padding="10dp"
+        android:background="@drawable/edittext_bg"/> <!-- 输入框背景（带边框，区分普通文本） -->
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/dialog_edit_task.xml b/positions/src/main/res/layout/dialog_edit_task.xml
new file mode 100644
index 0000000..5ebd3ed
--- /dev/null
+++ b/positions/src/main/res/layout/dialog_edit_task.xml
@@ -0,0 +1,121 @@
+<?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="@color/white">
+
+	<EditText
+		android:id="@+id/et_edit_task_desc"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:hint="输入任务描述"
+		android:maxLines="1"
+		android:textSize="14sp"
+		android:lines="3"
+		android:inputType="textMultiLine"/>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp"
+		android:gravity="center_vertical">
+
+		<RadioGroup
+			android:id="@+id/rg_distance_condition"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:orientation="horizontal"
+			android:layout_marginRight="10dp">
+
+			<RadioButton
+				android:id="@+id/rb_greater_than"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="大于(◎)"
+				android:textColor="@color/black"
+				android:textSize="14sp"/>
+
+			<RadioButton
+				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="0dp"
+			android:layout_weight="1.0"
+			android:layout_height="wrap_content"
+			android:hint="输入距离（米）"
+			android:inputType="number"
+			android:maxLines="1"
+			android:textSize="14sp"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="米"
+			android:layout_marginRight="10dp"/>
+
+	</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>
+
diff --git a/positions/src/main/res/layout/item_position_edit.xml b/positions/src/main/res/layout/item_position_edit.xml
new file mode 100644
index 0000000..f1d8980
--- /dev/null
+++ b/positions/src/main/res/layout/item_position_edit.xml
@@ -0,0 +1,178 @@
+<?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="12dp"
+	android:background="@drawable/item_bg_edit">
+
+	<TextView
+		android:id="@+id/tv_edit_longitude"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:textSize="14sp"
+		android:textColor="#999999"/>
+
+	<TextView
+		android:id="@+id/tv_edit_latitude"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:textSize="14sp"
+		android:textColor="#999999"
+		android:layout_marginTop="4dp"/>
+
+	<EditText
+		android:id="@+id/et_edit_memo"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:hint="请输入位置备注"
+		android:textSize="14sp"
+		android:padding="8dp"
+		android:layout_marginTop="8dp"
+		android:background="@drawable/edittext_bg"/>
+
+	<LinearLayout
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:orientation="vertical"
+		android:layout_marginTop="10dp">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:textSize="14sp"
+			android:textColor="#333333"
+			android:id="@+id/tv_edit_distance"/>
+
+		<RadioGroup
+			android:id="@+id/rg_distance_switch"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:orientation="horizontal"
+			android:layout_marginLeft="8dp">
+
+			<RadioButton
+				android:id="@+id/rb_distance_disable"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="禁用"
+				android:textSize="14sp"
+				android:checked="true"/>
+
+			<RadioButton
+				android:id="@+id/rb_distance_enable"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="启用"
+				android:textSize="14sp"
+				android:layout_marginLeft="15dp"/>
+
+		</RadioGroup>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:orientation="horizontal"
+		android:layout_marginTop="12dp">
+
+		<Button
+			android:id="@+id/btn_edit_delete"
+			android:layout_width="wrap_content"
+			android:layout_height="32dp"
+			android:background="@drawable/btn_delete_bg"
+			android:text="删除位置"
+			android:textColor="@android:color/white"
+			android:textSize="13sp"
+			android:paddingStart="15dp"
+			android:paddingEnd="15dp"/>
+
+		<View
+			android:layout_width="10dp"
+			android:layout_height="match_parent"/>
+
+		<Button
+			android:id="@+id/btn_edit_cancel"
+			android:layout_width="wrap_content"
+			android:layout_height="32dp"
+			android:background="@drawable/btn_cancel_bg"
+			android:text="取消"
+			android:textColor="@android:color/white"
+			android:textSize="13sp"
+			android:paddingStart="15dp"
+			android:paddingEnd="15dp"/>
+
+		<View
+			android:layout_width="10dp"
+			android:layout_height="match_parent"/>
+
+		<Button
+			android:id="@+id/btn_edit_save"
+			android:layout_width="wrap_content"
+			android:layout_height="32dp"
+			android:background="@drawable/btn_confirm_bg"
+			android:text="确定"
+			android:textColor="@android:color/white"
+			android:textSize="13sp"
+			android:paddingStart="15dp"
+			android:paddingEnd="15dp"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="vertical"
+		android:layout_marginTop="16dp">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="30dp"
+			android:orientation="horizontal">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="match_parent"
+				android:gravity="center_vertical"
+				android:text="关联任务（可编辑）："
+				android:textSize="14sp"
+				android:textColor="#333333"/>
+
+			<TextView
+				android:id="@+id/tv_task_count"
+				android:layout_width="wrap_content"
+				android:layout_height="match_parent"
+				android:gravity="center_vertical"
+				android:textSize="14sp"
+				android:textColor="#333333"/>
+			
+			<View
+				android:layout_width="0dp"
+				android:layout_height="match_parent"
+				android:layout_weight="1"/>
+
+			<Button
+				android:id="@+id/btn_add_task"
+				android:layout_width="wrap_content"
+				android:layout_height="match_parent"
+				android:background="@drawable/btn_confirm_bg"
+				android:text="添加新任务"
+				android:textColor="@android:color/white"
+				android:textSize="12sp"
+				android:paddingStart="12dp"
+				android:paddingEnd="12dp"/>
+
+		</LinearLayout>
+
+		<cc.winboll.studio.positions.views.PositionTaskListView
+			android:id="@+id/ptlv_edit_tasks"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:layout_marginTop="6dp"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/item_position_empty.xml b/positions/src/main/res/layout/item_position_empty.xml
new file mode 100644
index 0000000..37ab0e4
--- /dev/null
+++ b/positions/src/main/res/layout/item_position_empty.xml
@@ -0,0 +1,16 @@
+<?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="100dp"
+    android:gravity="center"
+    android:orientation="vertical">
+
+    <TextView
+        android:id="@+id/tv_empty_tip"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textColor="@color/colorGrayText"
+        android:textSize="16sp" />
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/item_position_simple.xml b/positions/src/main/res/layout/item_position_simple.xml
new file mode 100644
index 0000000..ec4e69f
--- /dev/null
+++ b/positions/src/main/res/layout/item_position_simple.xml
@@ -0,0 +1,55 @@
+<?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="12dp"
+    android:background="@drawable/item_bg_simple">
+    <TextView
+        android:id="@+id/tv_simple_longitude"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textSize="14sp"
+        android:textColor="#333333"/>
+
+    <TextView
+        android:id="@+id/tv_simple_latitude"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textSize="14sp"
+        android:textColor="#333333"
+        android:layout_marginTop="4dp"/>
+
+    <TextView
+        android:id="@+id/tv_simple_memo"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textSize="14sp"
+        android:textColor="#666666"
+        android:layout_marginTop="4dp"/>
+
+    <TextView
+        android:id="@+id/tv_simple_distance"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textSize="14sp"
+        android:textColor="#2E8B57"
+        android:layout_marginTop="6dp"/>
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="关联任务（已启用）："
+        android:textSize="14sp"
+        android:textColor="#333333"
+        android:layout_marginTop="8dp"
+        android:layout_marginBottom="4dp"/>
+
+    <cc.winboll.studio.positions.views.PositionTaskListView
+        android:id="@+id/ptlv_simple_tasks"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="4dp"/>
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/item_position_task_edit.xml b/positions/src/main/res/layout/item_position_task_edit.xml
new file mode 100644
index 0000000..e32fc88
--- /dev/null
+++ b/positions/src/main/res/layout/item_position_task_edit.xml
@@ -0,0 +1,184 @@
+<?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="12dp"
+    android:background="@drawable/item_bg_edit"
+    android:layout_marginBottom="8dp">
+
+    <!-- 1. 不可编辑字段（仅显示，灰色文字） -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:layout_marginBottom="10dp">
+
+        <TextView
+            android:id="@+id/tv_edit_task_id"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:textSize="12sp"
+            android:textColor="#999999"
+            android:text="任务ID："/>
+
+        <TextView
+            android:id="@+id/tv_edit_position_id"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:textSize="12sp"
+            android:textColor="#999999"
+            android:layout_marginTop="2dp"
+            android:text="位置ID："/>
+    </LinearLayout>
+
+    <!-- 2. 任务描述（可编辑） -->
+    <EditText
+        android:id="@+id/et_edit_task_desc"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="请输入任务描述（如：到达后提醒打卡）"
+        android:textSize="14sp"
+        android:padding="8dp"
+        android:background="@drawable/edittext_bg"
+        android:layout_marginBottom="10dp"/>
+
+    <!-- 3. 距离条件（单选组：大于/小于） -->
+    <LinearLayout
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:layout_marginBottom="10dp">
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="距离条件："
+            android:textSize="14sp"
+            android:textColor="#333333"
+            android:layout_marginRight="10dp"/>
+
+        <RadioGroup
+            android:id="@+id/rg_edit_distance_cond"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:orientation="horizontal">
+
+            <RadioButton
+                android:id="@+id/rb_edit_greater"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="大于"
+                android:textSize="14sp"
+                android:layout_marginRight="15dp"/>
+
+            <RadioButton
+                android:id="@+id/rb_edit_less"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="小于"
+                android:textSize="14sp"/>
+        </RadioGroup>
+    </LinearLayout>
+
+    <!-- 4. 商议距离（可编辑，仅整数） -->
+    <EditText
+        android:id="@+id/et_edit_discuss_dist"
+        android:layout_width="120dp"
+        android:layout_height="wrap_content"
+        android:hint="请输入距离（米）"
+        android:textSize="14sp"
+        android:inputType="number"
+        android:padding="8dp"
+        android:background="@drawable/edittext_bg"
+        android:layout_marginBottom="10dp"/>
+	
+    <!-- 5. 启用状态（单选组：是/否） -->
+    <LinearLayout
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:layout_marginBottom="12dp">
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="启用任务："
+            android:textSize="14sp"
+            android:textColor="#333333"
+            android:layout_marginRight="10dp"/>
+
+        <RadioGroup
+            android:id="@+id/rg_edit_is_enable"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:orientation="horizontal">
+
+            <RadioButton
+                android:id="@+id/rb_edit_enable_yes"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="是"
+                android:textSize="14sp"
+                android:layout_marginRight="15dp"/>
+
+            <RadioButton
+                android:id="@+id/rb_edit_enable_no"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="否"
+                android:textSize="14sp"/>
+        </RadioGroup>
+    </LinearLayout>
+
+    <!-- 6. 功能按钮（删除-红 / 取消-灰 / 确定-蓝） -->
+    <LinearLayout
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal"
+        android:gravity="center_vertical">
+
+        <Button
+            android:id="@+id/btn_edit_delete"
+            android:layout_width="wrap_content"
+            android:layout_height="32dp"
+            android:background="@drawable/btn_delete_bg"
+            android:text="删除"
+            android:textColor="@android:color/white"
+            android:textSize="13sp"
+            android:paddingStart="15dp"
+            android:paddingEnd="15dp"/>
+
+        <View
+            android:layout_width="10dp"
+            android:layout_height="match_parent"/>
+
+        <Button
+            android:id="@+id/btn_edit_cancel"
+            android:layout_width="wrap_content"
+            android:layout_height="32dp"
+            android:background="@drawable/btn_cancel_bg"
+            android:text="取消"
+            android:textColor="@android:color/white"
+            android:textSize="13sp"
+            android:paddingStart="15dp"
+            android:paddingEnd="15dp"/>
+
+        <View
+            android:layout_width="10dp"
+            android:layout_height="match_parent"/>
+
+        <Button
+            android:id="@+id/btn_edit_confirm"
+            android:layout_width="wrap_content"
+            android:layout_height="32dp"
+            android:background="@drawable/btn_confirm_bg"
+            android:text="确定"
+            android:textColor="@android:color/white"
+            android:textSize="13sp"
+            android:paddingStart="15dp"
+            android:paddingEnd="15dp"/>
+    </LinearLayout>
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/item_position_task_simple.xml b/positions/src/main/res/layout/item_position_task_simple.xml
new file mode 100644
index 0000000..39da247
--- /dev/null
+++ b/positions/src/main/res/layout/item_position_task_simple.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:orientation="vertical"
+	android:padding="12dp"
+	android:background="@drawable/item_bg_simple"
+	android:layout_marginBottom="8dp">
+
+	<View
+		android:id="@+id/v_bingo_dot"
+		android:layout_width="12dp"
+		android:layout_height="12dp"
+		android:layout_alignParentRight="true"
+		android:layout_alignParentTop="true"
+		android:layout_marginRight="2dp"
+		android:layout_marginTop="2dp"
+		android:background="@drawable/bg_bingo_dot"
+		android:visibility="gone"/>
+
+	<TextView
+		android:id="@+id/tv_simple_task_desc"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:textSize="16sp"
+		android:textColor="#333333"
+		android:text="任务：无描述"/>
+
+	<TextView
+		android:id="@+id/tv_simple_distance_cond"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:textSize="14sp"
+		android:textColor="#666666"
+		android:layout_marginTop="6dp"
+		android:layout_below="@id/tv_simple_task_desc"
+		android:text="条件：距离 &gt; 0 米"/>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_marginTop="6dp"
+		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="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>
+
diff --git a/positions/src/main/res/layout/item_task_content.xml b/positions/src/main/res/layout/item_task_content.xml
new file mode 100644
index 0000000..5d38556
--- /dev/null
+++ b/positions/src/main/res/layout/item_task_content.xml
@@ -0,0 +1,110 @@
+<?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="horizontal"
+	android:gravity="center_vertical"
+	android:padding="8dp"
+	android:background="@drawable/bg_task_item"
+	android:layout_marginVertical="4dp">
+
+	<CheckBox
+		android:id="@+id/cb_task_enable"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:layout_marginRight="12dp"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="0dp"
+		android:layout_height="wrap_content"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:orientation="horizontal">
+
+			<TextView
+				android:id="@+id/tv_task_desc"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="任务描述"
+				android:textSize="16sp"
+				android:textColor="@color/black"/>
+
+		</LinearLayout>
+
+		<LinearLayout
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:orientation="horizontal">
+
+			<TextView
+				android:id="@+id/tv_task_distance"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="条件：大于 100 米"
+				android:textSize="12sp"
+				android:textColor="@color/gray_dark"
+				android:layout_marginTop="2dp"/>
+
+		</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>
+
diff --git a/positions/src/main/res/layout/item_task_empty.xml b/positions/src/main/res/layout/item_task_empty.xml
new file mode 100644
index 0000000..a676c6a
--- /dev/null
+++ b/positions/src/main/res/layout/item_task_empty.xml
@@ -0,0 +1,18 @@
+<?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="80dp"
+    android:gravity="center"
+    android:orientation="vertical"
+    android:background="@color/background_light">
+
+    <TextView
+        android:id="@+id/tv_task_empty_tip"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="暂无任务"
+        android:textColor="@color/gray"
+        android:textSize="14sp" />
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/layout/view_position_task_list.xml b/positions/src/main/res/layout/view_position_task_list.xml
new file mode 100644
index 0000000..7cac325
--- /dev/null
+++ b/positions/src/main/res/layout/view_position_task_list.xml
@@ -0,0 +1,16 @@
+<?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="8dp">
+
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/rv_position_tasks"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:background="@color/white"
+        android:paddingVertical="4dp" />
+
+</LinearLayout>
+
diff --git a/positions/src/main/res/menu/menu_item_edit.xml b/positions/src/main/res/menu/menu_item_edit.xml
new file mode 100644
index 0000000..b37482b
--- /dev/null
+++ b/positions/src/main/res/menu/menu_item_edit.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 编辑菜单：点击后切换到编辑视图 -->
+    <item
+        android:id="@+id/menu_edit"
+        android:title="编辑"
+        android:orderInCategory="100"
+        android:showAsAction="never"/> <!-- 仅在菜单中显示，不显示在按钮栏 -->
+</menu>
diff --git a/positions/src/main/res/menu/toolbar_main.xml b/positions/src/main/res/menu/toolbar_main.xml
new file mode 100644
index 0000000..6d8d000
--- /dev/null
+++ b/positions/src/main/res/menu/toolbar_main.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <item
+        android:id="@+id/item_settings"
+        android:title="Settings"/>
+	
+    <item
+        android:id="@+id/item_about"
+        android:title="@string/item_about"/>
+
+</menu>
+
diff --git a/positions/src/main/res/menu/toolbar_main_idle.xml b/positions/src/main/res/menu/toolbar_main_idle.xml
new file mode 100644
index 0000000..91f4172
--- /dev/null
+++ b/positions/src/main/res/menu/toolbar_main_idle.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <item
+        android:id="@+id/item_idle_switch"
+        android:title="空转状态切换"/>
+
+</menu>
diff --git a/positions/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/positions/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/positions/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/positions/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/positions/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
new file mode 100644
index 0000000..eca70cf
--- /dev/null
+++ b/positions/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
\ No newline at end of file
diff --git a/positions/src/main/res/mipmap-hdpi/ic_launcher.png b/positions/src/main/res/mipmap-hdpi/ic_launcher.png
new file mode 100644
index 0000000..a2f5908
Binary files /dev/null and b/positions/src/main/res/mipmap-hdpi/ic_launcher.png differ
diff --git a/positions/src/main/res/mipmap-hdpi/ic_launcher_round.png b/positions/src/main/res/mipmap-hdpi/ic_launcher_round.png
new file mode 100644
index 0000000..1b52399
Binary files /dev/null and b/positions/src/main/res/mipmap-hdpi/ic_launcher_round.png differ
diff --git a/positions/src/main/res/mipmap-mdpi/ic_launcher.png b/positions/src/main/res/mipmap-mdpi/ic_launcher.png
new file mode 100644
index 0000000..ff10afd
Binary files /dev/null and b/positions/src/main/res/mipmap-mdpi/ic_launcher.png differ
diff --git a/positions/src/main/res/mipmap-mdpi/ic_launcher_round.png b/positions/src/main/res/mipmap-mdpi/ic_launcher_round.png
new file mode 100644
index 0000000..115a4c7
Binary files /dev/null and b/positions/src/main/res/mipmap-mdpi/ic_launcher_round.png differ
diff --git a/positions/src/main/res/mipmap-xhdpi/ic_launcher.png b/positions/src/main/res/mipmap-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..dcd3cd8
Binary files /dev/null and b/positions/src/main/res/mipmap-xhdpi/ic_launcher.png differ
diff --git a/positions/src/main/res/mipmap-xhdpi/ic_launcher_round.png b/positions/src/main/res/mipmap-xhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..459ca60
Binary files /dev/null and b/positions/src/main/res/mipmap-xhdpi/ic_launcher_round.png differ
diff --git a/positions/src/main/res/mipmap-xxhdpi/ic_launcher.png b/positions/src/main/res/mipmap-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..8ca12fe
Binary files /dev/null and b/positions/src/main/res/mipmap-xxhdpi/ic_launcher.png differ
diff --git a/positions/src/main/res/mipmap-xxhdpi/ic_launcher_round.png b/positions/src/main/res/mipmap-xxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..8e19b41
Binary files /dev/null and b/positions/src/main/res/mipmap-xxhdpi/ic_launcher_round.png differ
diff --git a/positions/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/positions/src/main/res/mipmap-xxxhdpi/ic_launcher.png
new file mode 100644
index 0000000..b824ebd
Binary files /dev/null and b/positions/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ
diff --git a/positions/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png b/positions/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png
new file mode 100644
index 0000000..4c19a13
Binary files /dev/null and b/positions/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png differ
diff --git a/positions/src/main/res/values-zh/strings.xml b/positions/src/main/res/values-zh/strings.xml
new file mode 100644
index 0000000..bd262f3
--- /dev/null
+++ b/positions/src/main/res/values-zh/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">悟空笔记</string>
+    <string name="app_description">安卓位置应用，有关于地理位置的相关应用。</string>
+    <string name="item_about">关于</string>
+</resources>
diff --git a/positions/src/main/res/values/colors.xml b/positions/src/main/res/values/colors.xml
new file mode 100644
index 0000000..1aa1655
--- /dev/null
+++ b/positions/src/main/res/values/colors.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#009688</color>
+    <color name="colorPrimaryDark">#00796B</color>
+    <color name="colorAccent">#FF9800</color>
+	<!-- 1. colorEnableGreen：简单视图“已启用”状态文字颜色（柔和绿色，不刺眼） -->
+    <color name="colorEnableGreen">#2E8B57</color> <!-- 海绿色：比纯绿柔和，适合文字提示 -->
+
+    <!-- 2. colorGrayText：编辑视图“不可编辑字段”文字颜色（浅灰色，暗示“不可修改”） -->
+    <color name="colorGrayText">#999999</color> <!-- 中浅灰：既不模糊，又能和可编辑文字区分开 -->
+
+    <!-- （可选补充）适配之前的背景资源颜色（避免后续新增资源报错，提前定义） -->
+    <color name="colorItemSimpleBg">#F5F5F5</color> <!-- item_bg_simple 底色 -->
+    <color name="colorItemEditBg">#EEEEEE</color>   <!-- item_bg_edit 底色 -->
+    <color name="colorItemBorder">#E0E0E0</color>   <!-- 列表项边框颜色 -->
+	<color name="colorRed">#F44336</color> <!-- 标准 Material 红色，可自定义RGB值 -->
+
+	<!-- 基础颜色：解决@color/gray未定义问题 -->
+	<color name="gray">#9E9E9E</color> <!-- 浅灰色（用于提示文本、次要信息） -->
+	<color name="gray_dark">#616161</color> <!-- 深灰色（备用，避免后续扩展缺失） -->
+
+	<!-- 其他已用颜色：确保布局中所有颜色引用都有定义 -->
+	<color name="white">#FFFFFF</color> <!-- 白色（任务列表背景、弹窗背景） -->
+	<color name="black">#000000</color> <!-- 黑色（任务描述文本） -->
+	<color name="blue">#2196F3</color> <!-- 蓝色（编辑/保存按钮背景） -->
+	<color name="red">#F44336</color> <!-- 红色（删除按钮背景） -->
+	<color name="background_light">#F5F5F5</color> <!-- 浅灰背景（备用，提升页面质感） -->
+
+	<!-- 扩展颜色（避免后续新增功能时再次缺失） -->
+	<color name="green">#2E8B57</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>
diff --git a/positions/src/main/res/values/dimens.xml b/positions/src/main/res/values/dimens.xml
new file mode 100644
index 0000000..7c56ea2
--- /dev/null
+++ b/positions/src/main/res/values/dimens.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <dimen name="toolbar_height">60dp</dimen>
+    <dimen name="text_content_size">18dp</dimen>
+    <dimen name="text_title_size">24dp</dimen>
+    <dimen name="text_subtitle_size">16dp</dimen>
+</resources>
diff --git a/positions/src/main/res/values/strings.xml b/positions/src/main/res/values/strings.xml
new file mode 100644
index 0000000..8fc136f
--- /dev/null
+++ b/positions/src/main/res/values/strings.xml
@@ -0,0 +1,11 @@
+<resources>
+    <string name="app_name">Positions</string>
+    <string name="app_description">Android location-based apps, including those related to geolocation.</string>
+	<string name="appplus_name">PositionsPlus</string>
+    <string name="item_about">About</string>
+	<string name="open_appplus">Open APP Plus</string>
+	<string name="close_appplus">Close APP Plus</string>
+	<string name="appplus_open_disabled">APP Plus Open Disable</string>
+	<string name="appplus_close_disabled">APP Plus Close Disable</string>
+</resources>
+
diff --git a/positions/src/main/res/values/styles.xml b/positions/src/main/res/values/styles.xml
new file mode 100644
index 0000000..ef130d8
--- /dev/null
+++ b/positions/src/main/res/values/styles.xml
@@ -0,0 +1,25 @@
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="MyAppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <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>
+
+
+    <!-- 设置Toolbar标题字体的大小 -->
+    <style name="Toolbar.TitleText" parent="@android:style/TextAppearance.DeviceDefault.Widget.ActionBar.Title">
+        <item name="android:textSize">@dimen/text_title_size</item>
+    </style>
+    <style name="Toolbar.SubTitleText" parent="@android:style/TextAppearance.DeviceDefault.Widget.ActionBar.Title">
+        <item name="android:textSize">@dimen/text_subtitle_size</item>
+    </style>
+	
+</resources>
diff --git a/positions/src/main/res/xml/file_provider.xml b/positions/src/main/res/xml/file_provider.xml
new file mode 100644
index 0000000..802e4cc
--- /dev/null
+++ b/positions/src/main/res/xml/file_provider.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths xmlns:android="http://schemas.android.com/apk/res/android">
+    <external-files-path
+        name="BaseBean"
+        path="BaseBean/" />
+</paths>
diff --git a/positions/src/main/res/xml/shortcutsmain.xml b/positions/src/main/res/xml/shortcutsmain.xml
new file mode 100644
index 0000000..5c0c0b4
--- /dev/null
+++ b/positions/src/main/res/xml/shortcutsmain.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="open_appplus"
+        android:enabled="true"
+        android:icon="@mipmap/ic_launcher"
+        android:shortcutShortLabel="@string/open_appplus"
+        android:shortcutLongLabel="@string/open_appplus"
+        android:shortcutDisabledMessage="@string/appplus_open_disabled">
+        <intent
+            android:action="cc.winboll.studio.positions.App.ACTION_OPEN_APPPLUS"
+            android:targetPackage="cc.winboll.studio.positions"
+            android:targetClass="cc.winboll.studio.positions.activities.ShortcutActionActivity"
+            android:data="open_appplus" />
+
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/positions/src/main/res/xml/shortcutsplus.xml b/positions/src/main/res/xml/shortcutsplus.xml
new file mode 100644
index 0000000..a38aa91
--- /dev/null
+++ b/positions/src/main/res/xml/shortcutsplus.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="close_appplus"
+        android:enabled="true"
+        android:icon="@mipmap/ic_launcher"
+        android:shortcutShortLabel="@string/close_appplus"
+        android:shortcutLongLabel="@string/close_appplus"
+        android:shortcutDisabledMessage="@string/appplus_close_disabled">
+        <intent
+            android:action="cc.winboll.studio.positions.App.ACTION_CLOSE_APPPLUS"
+            android:targetPackage="cc.winboll.studio.positions"
+            android:targetClass="cc.winboll.studio.positions.activities.ShortcutActionActivity"
+            android:data="close_appplus" />
+
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/positions/src/stage/AndroidManifest.xml b/positions/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/positions/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/positions/src/stage/res/values/strings.xml b/positions/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/positions/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/powerbell/.gitignore b/powerbell/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/powerbell/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/powerbell/README.md b/powerbell/README.md
new file mode 100644
index 0000000..4280ca1
--- /dev/null
+++ b/powerbell/README.md
@@ -0,0 +1,112 @@
+# PowerBell
+
+#### 介绍
+一个接收手机电量信息的应用，当电量值达到设定范围时会提醒用户。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：gradle assembleStageRelease
+
+#### 使用说明
+
+在安卓系统中需要设置两个权限允许。
+1.自启动权限允许。
+2.省电策略-无限制权限允许。
+3.设置背景图片需要读写手机存储权限。
+4.要在锁屏充电的时候提醒，还需要设置允许锁屏通知权限。
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@qq.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
+
+AndroidManifest.xml详解
+https://www.jianshu.com/p/3b5b89d4e154
+
+CrashHandler自定义异常处理
+https://www.jianshu.com/p/9a3d800a429a
+
+Android用Intent启动Activity的方法
+https://blog.csdn.net/huangxiaohu_coder/article/details/7105457
+
+Android开发：最详细的 Toolbar 开发实践总结
+https://www.jianshu.com/p/79604c3ddcae
+
+Using the App Toolbar
+https://guides.codepath.com/android/using-the-app-toolbar
+
+Android的onCreateOptionsMenu()创建菜单Menu详解
+https://www.cnblogs.com/spring87/p/4312538.html
+
+Android通知栏-Notification（通知消息）
+https://blog.csdn.net/qq_35507234/article/details/90676587
+
+android之PendingIntent的使用
+https://blog.csdn.net/qq_16628781/article/details/51548324
+
+change seekbar color android” Code Answer
+https://www.codegrepper.com/code-examples/whatever/change+seekbar+color+android
+
+如何选择开源项目许可证
+https://www.zhihu.com/question/28292322
+
+Android最简单的自定义布局Notification
+https://blog.csdn.net/acesheep_911/article/details/81458784?utm_medium=distribute.wap_relevant.none-task-blog-2~default~baidujs_title~default-0.wap_blog_relevant_default&spm=1001.2101.3001.4242.1&utm_relevant_index=3
+
+Android中通知栏Notification详解以及自定义Notification
+https://blog.csdn.net/daitu_liang/article/details/50246803
+
+Android 图像系列: 将本地图片加载到Drawable
+https://blog.csdn.net/qzone123222/article/details/7930035
+
+android 从相册选择,Android开发从相册中选取照片
+https://blog.csdn.net/weixin_42146086/article/details/117570917
+
+Android 任务栈简介
+https://blog.csdn.net/qq_34368586/article/details/107653912
+
+Android用Intent启动Activity的方法
+https://blog.csdn.net/huangxiaohu_coder/article/details/7105457
+
+Android中使用dimen定义尺寸
+https://blog.csdn.net/yuzhiboyi/article/details/7696174
+
+declare-styleable：自定义控件的属性
+https://blog.csdn.net/congqingbin/article/details/7869730
+
+安卓自定义滑动解锁控件
+https://blog.csdn.net/lp506954774/article/details/72677018
+
+Android 添加菜单和返回按钮
+https://blog.csdn.net/my_tiantian/article/details/77822173
+
+Android Button的基本使用
+https://www.cnblogs.com/yishaochu/p/5783605.html
+
+Android应用中实现系统“分享”接口
+https://blog.csdn.net/lowprofile_coding/article/details/37656255
+
+Android 关于mimeType的使用
+https://blog.csdn.net/dorytmx/article/details/80972248
+
+使用GitHub Actions实现Android自动打包apk
+https://blog.csdn.net/ZZL23333/article/details/115798615?app_version=6.0.0&code=app_1562916241&csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22115798615%22%2C%22source%22%3A%22weixin_38986226%22%7D&uLinkId=usr1mkqgl919blen&utm_source=app
diff --git a/powerbell/app_update_description.txt b/powerbell/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/powerbell/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/powerbell/build.gradle b/powerbell/build.gradle
new file mode 100644
index 0000000..df9c894
--- /dev/null
+++ b/powerbell/build.gradle
@@ -0,0 +1,92 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+    // 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.powerbell"
+        minSdkVersion 21
+        targetSdkVersion 30
+        versionCode 7
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.15" 
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+}
+
+dependencies {
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //api 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.google.code.gson:gson:2.8.5'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+	
+	// uCrop 核心依赖（最新稳定版）
+    implementation 'com.github.yalantis:ucrop:2.2.8'
+    // 兼容AndroidX（若项目用AndroidX，必须添加）
+    //implementation 'androidx.appcompat:appcompat:1.6.1'
+    implementation 'androidx.exifinterface:exifinterface:1.3.6'
+
+	 // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+    
+    // AndroidX 类库
+    api 'androidx.appcompat:appcompat:1.1.0'
+    api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'
+    
+	// WinBoLL库 nexus.winboll.cc 地址
+	api 'cc.winboll.studio:libaes:15.15.2'
+    api 'cc.winboll.studio:libappbase:15.15.11'
+	
+	// WinBoLL备用库 jitpack.io 地址
+	//api 'com.github.ZhanGSKen:AES:aes-v15.15.2'
+	//api 'com.github.ZhanGSKen:APPBase:appbase-v15.15.4'
+	
+    //api fileTree(dir: 'libs', include: ['*.aar'])
+    api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/powerbell/build.properties b/powerbell/build.properties
new file mode 100644
index 0000000..bf6afbd
--- /dev/null
+++ b/powerbell/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Wed Mar 11 04:24:14 HKT 2026
+stageCount=17
+libraryProject=
+baseVersion=15.15
+publishVersion=15.15.16
+buildCount=0
+baseBetaVersion=15.15.17
diff --git a/powerbell/build_copyright_pdf.sh b/powerbell/build_copyright_pdf.sh
new file mode 100644
index 0000000..3c3125b
--- /dev/null
+++ b/powerbell/build_copyright_pdf.sh
@@ -0,0 +1,279 @@
+#!/bin/bash
+# PowerBell软著版本号快速修改+生成脚本
+# 无需手动改主脚本，输入版本号直接运行
+
+# 颜色输出函数
+red_echo() { echo -e "\033[31m$1\033[0m"; }
+green_echo() { echo -e "\033[32m$1\033[0m"; }
+blue_echo() { echo -e "\033[34m$1\033[0m"; }
+
+# 1. 提示用户输入新版本号
+blue_echo "==== 请输入软著版本号（格式示例：V15、V15.0.1） ===="
+read -p "输入版本号：" NEW_VERSION
+
+# 校验版本号格式（避免特殊符号）
+if [[ ! $NEW_VERSION =~ ^V[0-9]+(\.[0-9]+)*$ ]]; then
+    red_echo "错误：版本号格式无效！请遵循「V+数字」格式（如V15、V15.0.1），不含特殊符号"
+    exit 1
+fi
+
+# 2. 定义固定配置（仅需修改这里的著作权人，其他无需动）
+SOFTWARE_NAME="PowerBell"
+COPYRIGHT_OWNER="张绍建陆丰东海镇云宝软件开发工作室"
+LINES_PER_PAGE=55
+
+# 3. 生成主脚本（自动替换新版本号）
+blue_echo -e "\n==== 生成${NEW_VERSION}版本主脚本 ===="
+cat > build_copyright_pdf_temp.sh << EOF
+#!/bin/bash
+# PowerBell软著PDF生成脚本（版本：$NEW_VERSION）
+red_echo() { echo -e "\033[31m\$1\033[0m"; }
+green_echo() { echo -e "\033[32m\$1\033[0m"; }
+blue_echo() { echo -e "\033[34m\$1\033[0m"; }
+
+# 配置项（已自动替换为${NEW_VERSION}）
+SOFTWARE_NAME="$SOFTWARE_NAME"
+SOFTWARE_VERSION="$NEW_VERSION"
+COPYRIGHT_OWNER="$COPYRIGHT_OWNER"
+LINES_PER_PAGE=$LINES_PER_PAGE
+
+# 步骤1：检查依赖
+blue_echo "==== 1/7 检查并安装依赖 ===="
+sudo apt update > /dev/null 2>&1
+REQUIRED_PKGS=("python3" "wkhtmltopdf" "fonts-wqy-microhei" "pdftk" "poppler-utils")
+for pkg in "\${REQUIRED_PKGS[@]}"; do
+    if ! dpkg -s "\$pkg" > /dev/null 2>&1; then
+        green_echo "安装依赖：\$pkg"
+        sudo apt install -y "\$pkg" > /dev/null 2>&1
+    fi
+done
+
+# 步骤2：生成纯文本源码
+blue_echo -e "\n==== 2/7 生成纯文本核心源码 ===="
+cat > generate_source.py << GEN_EOF
+import os
+PROJECT_PATH = "./"
+OUTPUT_TXT = "PowerBell_Core_Source.txt"
+INCLUDE_EXT = [".java", ".kt"]
+EXCLUDE_DIRS = ["build", "libs", "test", "androidTest", ".git", ".idea", "gradle", "unittest"]
+MIN_LINE_COUNT = 3
+SOFTWARE_NAME = "$SOFTWARE_NAME"
+SOFTWARE_VERSION = "$NEW_VERSION"
+COPYRIGHT_OWNER = "$COPYRIGHT_OWNER"
+
+def clean_text(text):
+    return ''.join(c for c in text if c.isprintable() or c in "\\n\\r\\t")
+
+def generate_source_txt():
+    valid_files = []
+    main_dir = os.path.join(PROJECT_PATH, "src", "main")
+    if not os.path.exists(main_dir):
+        print("Error: src/main directory not found!")
+        return
+    for root, dirs, files in os.walk(main_dir):
+        dirs[:] = [d for d in dirs if d not in EXCLUDE_DIRS]
+        for file in files:
+            if os.path.splitext(file)[1] in INCLUDE_EXT:
+                file_path = os.path.join(root, file)
+                try:
+                    with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
+                        lines = f.readlines()
+                        code_lines = [l for l in lines if l.strip() and not l.strip().startswith("//")]
+                        if len(code_lines) >= MIN_LINE_COUNT:
+                            valid_files.append(file_path)
+                except:
+                    continue
+    valid_files.sort(key=lambda x: os.path.getsize(x), reverse=True)
+    with open(OUTPUT_TXT, "w", encoding="utf-8-sig") as f:
+        f.write(f"\{SOFTWARE_NAME} \{SOFTWARE_VERSION} 核心源码 - 著作权人：\{COPYRIGHT_OWNER}\\n\\n")
+        for idx, file_path in enumerate(valid_files, 1):
+            f.write(f"\\n{'='*60}\\n")
+            f.write(f"文件 \{idx}：\{file_path.replace(PROJECT_PATH, '')}\\n")
+            f.write(f"{'='*60}\\n\\n")
+            try:
+                try:
+                    with open(file_path, "r", encoding="utf-8") as src_f:
+                        content = clean_text(src_f.read())
+                except UnicodeDecodeError:
+                    with open(file_path, "r", encoding="gbk") as src_f:
+                        content = clean_text(src_f.read())
+                f.write(content)
+                f.write("\\n\\n")
+            except Exception as e:
+                f.write(f"文件读取失败：\{str(e)}\\n\\n")
+                continue
+    print(f"有效源码文件数：\{len(valid_files)}")
+    print(f"纯文本文件路径：\{os.path.abspath(OUTPUT_TXT)}")
+
+if __name__ == "__main__":
+    generate_source_txt()
+GEN_EOF
+
+python3 generate_source.py
+if [ ! -f "PowerBell_Core_Source.txt" ]; then
+    red_echo "纯文本源码生成失败！"
+    exit 1
+fi
+
+# 步骤3：生成带版本号页眉的HTML
+blue_echo -e "\n==== 3/7 生成带${NEW_VERSION}页眉的HTML ===="
+cat > txt2html.py << TXT_EOF
+import os
+TXT_FILE = "PowerBell_Core_Source.txt"
+HTML_FILE = "PowerBell_Source.html"
+SOFTWARE_NAME = "$SOFTWARE_NAME"
+SOFTWARE_VERSION = "$NEW_VERSION"
+COPYRIGHT_OWNER = "$COPYRIGHT_OWNER"
+LINES_PER_PAGE = $LINES_PER_PAGE
+
+CSS_STYLE = """
+<style>
+@page {{
+    size: A4;
+    margin: 10mm 5mm;
+    @top-center {{
+        content: "{} {} - 源代码（著作权人：{}）";
+        font-family: 'WenQuanYi Micro Hei', monospace;
+        font-size: 9pt;
+        font-weight: bold;
+    }}
+    @bottom-center {{
+        content: "页码 " counter(page) " / " counter(pages);
+        font-family: 'WenQuanYi Micro Hei', monospace;
+        font-size: 9pt;
+    }}
+}}
+body {{ 
+    font-family: 'WenQuanYi Micro Hei', monospace; 
+    font-size: 9pt;
+    line-height: 1.1;
+    margin: 0;
+    padding: 5mm 0 0 0;
+    counter-reset: code-line;
+}}
+.file-header {{ 
+    background: #f0f0f0; 
+    padding: 3px; 
+    margin: 6px 0; 
+    font-weight: bold; 
+    font-size: 10pt;
+}}
+.code-block {{ 
+    white-space: pre; 
+    margin-left: 8px; 
+    line-height: 1.1;
+    counter-increment: code-line;
+}}
+.code-block:before {{
+    content: counter(code-line) " ";
+    color: #888;
+    display: inline-block;
+    width: 30px;
+    text-align: right;
+    margin-right: 5px;
+}}
+.page-break {{ page-break-after: always; counter-reset: code-line; }}
+</style>
+""".format(SOFTWARE_NAME, SOFTWARE_VERSION, COPYRIGHT_OWNER)
+
+def txt_to_html():
+    with open(TXT_FILE, "r", encoding="utf-8") as f:
+        content = f.read()
+    html_content = "<!DOCTYPE html><html><head><meta charset='utf-8'>" + CSS_STYLE + "</head><body>"
+    content_lines = content.split("\\n")[2:]
+    content_clean = "\\n".join(content_lines)
+    blocks = content_clean.split("====")
+    
+    line_count = 0
+    for block in blocks:
+        if not block.strip():
+            continue
+        if "文件 " in block and ":" in block:
+            file_header = block.split("\\n")[0].strip() if "\\n" in block else block.strip()
+            html_content += f"<div class='file-header'>\{file_header}</div>"
+            code_part = block.split("\\n")[1:] if "\\n" in block else []
+            block = "\\n".join(code_part)
+        code_lines = block.split("\\n")
+        for line in code_lines:
+            if line.strip() or line_count > 0:
+                line_count += 1
+                html_content += f"<div class='code-block'>\{line}</div>"
+                if line_count >= LINES_PER_PAGE:
+                    html_content += "<div class='page-break'></div>"
+                    line_count = 0
+    html_content += "</body></html>"
+    with open(HTML_FILE, "w", encoding="utf-8") as f:
+        f.write(html_content)
+    print(f"HTML文件路径：\{os.path.abspath(HTML_FILE)}")
+
+if __name__ == "__main__":
+    txt_to_html()
+TXT_EOF
+
+python3 txt2html.py
+if [ ! -f "PowerBell_Source.html" ]; then
+    red_echo "HTML文件生成失败！"
+    exit 1
+fi
+
+# 步骤4：生成完整PDF
+blue_echo -e "\n==== 4/7 生成完整PDF（版本：${NEW_VERSION}） ===="
+wkhtmltopdf --page-size A4 \
+            --margin-top 15mm --margin-bottom 15mm --margin-left 5mm --margin-right 5mm \
+            --encoding utf-8 \
+            --no-images --disable-javascript \
+            --enable-local-file-access \
+            --no-stop-slow-scripts \
+            PowerBell_Source.html PowerBell_soft_full.pdf
+
+if [ ! -f "PowerBell_soft_full.pdf" ]; then
+    red_echo "完整PDF生成失败！"
+    exit 1
+fi
+
+# 步骤5：截取60页
+blue_echo -e "\n==== 5/7 截取前30+后30页 ===="
+TOTAL_PAGES=\$(pdfinfo PowerBell_soft_full.pdf | grep "Pages" | awk '{print \$2}')
+green_echo "源码完整PDF总页数：\$TOTAL_PAGES 页"
+
+if [ "\$TOTAL_PAGES" -le 60 ]; then
+    cp PowerBell_soft_full.pdf PowerBell_软著源码_${NEW_VERSION}_60页.pdf
+    green_echo "源码不足60页，直接使用完整PDF"
+else
+    pdftk PowerBell_soft_full.pdf cat 1-30 output PowerBell_前30页.pdf
+    START_PAGE=\$((TOTAL_PAGES - 29))
+    pdftk PowerBell_soft_full.pdf cat \$START_PAGE-\$TOTAL_PAGES output PowerBell_后30页.pdf
+    pdftk PowerBell_前30页.pdf PowerBell_后30页.pdf cat output PowerBell_软著源码_${NEW_VERSION}_60页.pdf
+    rm -f PowerBell_前30页.pdf PowerBell_后30页.pdf
+    green_echo "源码超过60页，已截取前30页+后30页合并为60页"
+fi
+
+# 步骤6：验证规范
+blue_echo -e "\n==== 6/7 验证${NEW_VERSION}版本PDF规范 ===="
+FINAL_PAGES=\$(pdfinfo PowerBell_软著源码_${NEW_VERSION}_60页.pdf | grep "Pages" | awk '{print \$2}')
+green_echo "最终PDF页数：\$FINAL_PAGES 页"
+green_echo "每页代码行数：\$LINES_PER_PAGE 行（≥50行）"
+green_echo "页眉信息：$SOFTWARE_NAME $NEW_VERSION - 源代码（著作权人：$COPYRIGHT_OWNER）"
+
+# 步骤7：清理临时文件
+blue_echo -e "\n==== 7/7 清理临时文件 ===="
+rm -f generate_source.py txt2html.py PowerBell_Core_Source.txt PowerBell_Source.html PowerBell_soft_full.pdf
+green_echo "临时文件清理完成！"
+
+# 输出结果
+green_echo -e "\n====================================="
+green_echo "✅ $SOFTWARE_NAME $NEW_VERSION 软著PDF生成成功！🎉"
+green_echo "📄 最终文件：\$(pwd)/PowerBell_软著源码_${NEW_VERSION}_60页.pdf"
+green_echo "💡 可直接提交软著登记，无需手动修改！"
+green_echo "====================================="
+EOF
+
+# 4. 赋予执行权限并运行
+chmod +x build_copyright_pdf_temp.sh
+blue_echo -e "\n==== 开始生成${NEW_VERSION}版本PDF ===="
+./build_copyright_pdf_temp.sh
+
+# 5. 删除临时主脚本（可选，保留则注释此行）
+rm -f build_copyright_pdf_temp.sh
+
+green_echo -e "\n==== 操作完成！${NEW_VERSION}版本PDF已生成 ===="
diff --git a/powerbell/proguard-rules.pro b/powerbell/proguard-rules.pro
new file mode 100644
index 0000000..855b18a
--- /dev/null
+++ b/powerbell/proguard-rules.pro
@@ -0,0 +1,143 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+# ============================== 必要补充规则 ==============================
+# OkHttp 4.4.1 补充规则（Java 7 兼容）
+-keep class okhttp3.internal.concurrent.** { *; }
+-keep class okhttp3.internal.connection.** { *; }
+-dontwarn okhttp3.internal.concurrent.TaskRunner
+-dontwarn okhttp3.internal.connection.RealCall
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/powerbell/src/beta/AndroidManifest.xml b/powerbell/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..43d1ccf
--- /dev/null
+++ b/powerbell/src/beta/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <application
+        tools:replace="android:icon"
+        android:icon="@drawable/ic_launcher_beta">
+
+    </application>
+
+</manifest>
+
diff --git a/powerbell/src/beta/res/values-zh/string.xml b/powerbell/src/beta/res/values-zh/string.xml
new file mode 100644
index 0000000..633b11b
--- /dev/null
+++ b/powerbell/src/beta/res/values-zh/string.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name_cn1">能源钟★</string>
+    <string name="app_name_cn2">泡额呗额☆</string>
+
+</resources>
diff --git a/powerbell/src/beta/res/values/strings.xml b/powerbell/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..45ddac5
--- /dev/null
+++ b/powerbell/src/beta/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">PowerBell+</string>
+
+</resources>
diff --git a/powerbell/src/beta/res/xml/shortcutsmaincn1.xml b/powerbell/src/beta/res/xml/shortcutsmaincn1.xml
new file mode 100644
index 0000000..d2297b8
--- /dev/null
+++ b/powerbell/src/beta/res/xml/shortcutsmaincn1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+	        android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/powerbell/src/beta/res/xml/shortcutsmaincn2.xml b/powerbell/src/beta/res/xml/shortcutsmaincn2.xml
new file mode 100644
index 0000000..1bf9db1
--- /dev/null
+++ b/powerbell/src/beta/res/xml/shortcutsmaincn2.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+	        android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+</shortcuts>
diff --git a/powerbell/src/beta/res/xml/shortcutsmainen1.xml b/powerbell/src/beta/res/xml/shortcutsmainen1.xml
new file mode 100644
index 0000000..d56a42e
--- /dev/null
+++ b/powerbell/src/beta/res/xml/shortcutsmainen1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<!--<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+	        android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.powerbell.beta"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/powerbell/src/main/AndroidManifest.xml b/powerbell/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..62581a7
--- /dev/null
+++ b/powerbell/src/main/AndroidManifest.xml
@@ -0,0 +1,332 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    package="cc.winboll.studio.powerbell">
+
+    <!-- 此应用可显示在其他应用上方 -->
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
+
+    <!-- 运行前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+
+    <!-- 运行“specialUse”类型的前台服务 -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE"/>
+
+    <!-- 开机启动 -->
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+
+    <!-- 显示通知 -->
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+
+    <!-- PACKAGE_USAGE_STATS -->
+    <uses-permission android:name="android.permission.PACKAGE_USAGE_STATS"/>
+
+    <!-- BATTERY_STATS -->
+    <uses-permission android:name="android.permission.BATTERY_STATS"/>
+
+    <!-- 计算应用存储空间 -->
+    <uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
+
+    <!-- 请求忽略电池优化 -->
+    <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
+
+    <!-- 读取您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <!-- 修改或删除您共享存储空间中的内容 -->
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <!-- MANAGE_EXTERNAL_STORAGE -->
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <!-- 拍摄照片和视频 -->
+    <uses-permission android:name="android.permission.CAMERA"/>
+
+    <uses-permission
+        android:name="android.permission.ACCESS_PACKAGE_USAGE_STATS"
+        tools:ignore="ProtectedPermissions"/>
+
+    <uses-permission
+        android:name="android.permission.QUERY_ALL_PACKAGES"
+        tools:ignore="QueryAllPackagesPermission"/>
+
+    <uses-permission android:name="android.permission.BATTERY_STATS"/>
+
+    <uses-permission android:name="android.permission.GET_PACKAGE_SIZE"/>
+
+    <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
+
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+
+    <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"/>
+
+    <uses-permission android:name="android.permission.CAMERA"/>
+
+    <uses-feature
+        android:name="android.hardware.camera"
+        android:required="false"/>
+
+    <uses-feature
+        android:name="android.hardware.camera.autofocus"
+        android:required="false"/>
+
+    <queries>
+
+        <package android:name="com.miui.securitycenter"/>
+
+    </queries>
+
+    <application
+        android:name=".App"
+        android:process=":main"
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/AppTheme_Default"
+        android:persistent="true"
+        android:resizeableActivity="true"
+        android:requestLegacyExternalStorage="true"
+        android:usesCleartextTraffic="true"
+        android:supportsRtl="true"
+        tools:ignore="GoogleAppIndexingWarning,UnusedAttribute">
+
+        <activity
+            android:process=":main"
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:launchMode="singleTask"/>
+
+        <activity-alias
+            android:name=".MainActivityEN1"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmainen1"/>
+
+        </activity-alias>
+
+        <activity-alias
+            android:name=".MainActivityCN1"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name_cn1"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="false">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmaincn1"/>
+
+        </activity-alias>
+
+        <activity-alias
+            android:name=".MainActivityCN2"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name_cn2"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="false">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmaincn2"/>
+
+        </activity-alias>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.CrashActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.ClearRecordActivity"
+            android:parentActivityName="cc.winboll.studio.powerbell.MainActivity"
+            android:launchMode="singleTask"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.BackgroundSettingsActivity"
+            android:parentActivityName="cc.winboll.studio.powerbell.MainActivity"
+            android:exported="true"
+            android:launchMode="singleTask">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.SEND"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+                <data android:mimeType="image/jpeg"/>
+
+                <data android:mimeType="image/jpg"/>
+
+                <data android:mimeType="image/png"/>
+
+                <data android:mimeType="image/webp"/>
+
+                <data android:mimeType="image/*"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.BatteryReporterActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.PixelPickerActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.BatteryReportActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".unittest.MainUnitTestActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.ShortcutActionActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name=".activities.SettingsActivity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name="cc.winboll.studio.powerbell.unittest.MainUnitTest2Activity"
+            android:exported="false"/>
+
+        <activity
+            android:process=":main"
+            android:name="com.yalantis.ucrop.UCropActivity"
+            android:theme="@style/Theme.AppCompat.Light.NoActionBar"
+            android:exported="true"/>
+
+        <receiver
+            android:process=":main"
+            android:name=".receivers.MainReceiver"
+            android:enabled="true"
+            android:exported="true"
+            android:directBootAware="true">
+
+            <intent-filter android:priority="1000">
+
+                <action android:name="android.intent.action.BOOT_COMPLETED"/>
+
+                <action android:name="android.intent.action.POWER_CONNECTED"/>
+
+                <action android:name="android.intent.action.USER_PRESENT"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <service
+            android:name=".services.ControlCenterService"
+            android:priority="1000"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":main"
+            android:stopWithTask="false"
+            android:foregroundServiceType="dataSync">
+
+            <property
+                android:name="android.app.PROPERTY_SPECIAL_USE_FOREGROUND_SERVICE"
+                android:value="后台核心功能运行、持续保活"/>
+
+        </service>
+
+        <service
+            android:name=".services.AssistantService"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":assistant"
+            android:stopWithTask="false"
+            android:foregroundServiceType="dataSync">
+
+            <property
+                android:name="android.app.PROPERTY_SPECIAL_USE_FOREGROUND_SERVICE"
+                android:value="辅助核心功能运行"/>
+
+        </service>
+
+        <service
+            android:name=".services.TTSPlayService"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":main"
+            android:stopWithTask="false"/>
+
+        <service
+            android:name=".services.ThoughtfulService"
+            android:enabled="true"
+            android:exported="false"
+            android:process=":main"
+            android:stopWithTask="false"/>
+
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true"
+            android:process=":main">
+
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_provider"/>
+
+        </provider>
+
+        <meta-data
+            android:name="android.max_aspect"
+            android:value="4.0"/>
+
+        <activity android:name="cc.winboll.studio.powerbell.activities.AboutActivity"/>
+
+    </application>
+
+</manifest>
\ No newline at end of file
diff --git a/powerbell/src/main/assets/images/blank100x100.png b/powerbell/src/main/assets/images/blank100x100.png
new file mode 100644
index 0000000..84e1003
Binary files /dev/null and b/powerbell/src/main/assets/images/blank100x100.png differ
diff --git a/powerbell/src/main/assets/unittest/unittest-miku.png b/powerbell/src/main/assets/unittest/unittest-miku.png
new file mode 100644
index 0000000..ac4f4dc
Binary files /dev/null and b/powerbell/src/main/assets/unittest/unittest-miku.png differ
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/App.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/App.java
new file mode 100644
index 0000000..b11d3ce
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/App.java
@@ -0,0 +1,320 @@
+package cc.winboll.studio.powerbell;
+
+import android.content.Context;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.models.NotificationMessage;
+import cc.winboll.studio.powerbell.receivers.GlobalApplicationReceiver;
+import cc.winboll.studio.powerbell.utils.AppCacheUtils;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.BitmapCacheUtils;
+import cc.winboll.studio.powerbell.utils.NotificationManagerUtils;
+import cc.winboll.studio.powerbell.views.MemoryCachedBackgroundView;
+
+/**
+ * 应用全局入口类
+ * 适配：Java7 语法规范 | Android API30 系统版本
+ * 核心策略：极致强制缓存 - 无论内存紧张程度，永不自动清理任何缓存（Bitmap/视图控件/路径记录）
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025-12-29 15:30:00
+ * @LastModified 2026-01-02 19:01:00
+ */
+public class App extends GlobalApplication {
+
+    // ====================================== 常量区 - 置顶排序 (按功能归类) ======================================
+    // 基础日志TAG
+    private static final String TAG = "App";
+    // 缓存保护专用TAG
+    private static final String CACHE_PROTECT_TAG = "FORCE_CACHE_PROTECT";
+    // 电池无效值常量（修复拼写错误：INVALID_BATTERY_VALUE）
+    private static final int INVALID_BATTERY_VALUE = -1;
+
+    // 组件跳转常量
+    public static final String COMPONENT_EN1 = "cc.winboll.studio.powerbell.MainActivityEN1";
+    public static final String COMPONENT_CN1 = "cc.winboll.studio.powerbell.MainActivityCN1";
+    public static final String COMPONENT_CN2 = "cc.winboll.studio.powerbell.MainActivityCN2";
+
+    // 动作跳转常量
+    public static final String ACTION_SWITCHTO_EN1 = "cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1";
+    public static final String ACTION_SWITCHTO_CN1 = "cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1";
+    public static final String ACTION_SWITCHTO_CN2 = "cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2";
+
+    // ====================================== 静态属性区 - 全局单例/状态 (按核心程度排序) ======================================
+    // 应用单例
+    private static App sApp;
+
+    // 配置与缓存工具 (全局单例)
+    public static AppConfigUtils sAppConfigUtils;
+    private static AppCacheUtils sAppCacheUtils;
+
+    // 资源与视图缓存 (强制驻留，极致缓存核心)
+    public static BackgroundSourceUtils sBackgroundSourceUtils;
+    public static BitmapCacheUtils sBitmapCacheUtils;
+    private static MemoryCachedBackgroundView sMemoryCachedBackgroundView;
+
+    // 系统状态 (电池电量)
+    public static volatile int sQuantityOfElectricity = INVALID_BATTERY_VALUE;
+
+    // 系统工具 (通知管理器)
+    private static NotificationManagerUtils sNotificationManagerUtils;
+
+    // ====================================== 成员属性区 - 非静态成员 (广播接收器) ======================================
+    private GlobalApplicationReceiver mGlobalReceiver;
+
+    // ====================================== 公共静态方法 - 单例/工具获取 (对外入口) ======================================
+    /**
+     * 获取应用全局单例实例
+     * @return 应用单例App实例
+     */
+    public static App getInstance() {
+        LogUtils.d(TAG, "【getInstance】应用单例获取方法调用 | 当前实例：" + sApp);
+        return sApp;
+    }
+
+    /**
+     * 获取配置工具类单例实例
+     * @param context 上下文对象
+     * @return 配置工具类AppConfigUtils实例
+     */
+    public static AppConfigUtils getAppConfigUtils(Context context) {
+        String contextClass = context != null ? context.getClass().getSimpleName() : "null";
+        LogUtils.d(TAG, "【getAppConfigUtils】配置工具获取方法调用 | 入参Context类型：" + contextClass);
+
+        if (sAppConfigUtils == null) {
+            sAppConfigUtils = AppConfigUtils.getInstance(context);
+            LogUtils.d(TAG, "【getAppConfigUtils】配置工具实例为空，已初始化新实例");
+        }
+        return sAppConfigUtils;
+    }
+
+    /**
+     * 获取缓存工具类单例实例
+     * @param context 上下文对象
+     * @return 缓存工具类AppCacheUtils实例
+     */
+    public static AppCacheUtils getAppCacheUtils(Context context) {
+        String contextClass = context != null ? context.getClass().getSimpleName() : "null";
+        LogUtils.d(TAG, "【getAppCacheUtils】缓存工具获取方法调用 | 入参Context类型：" + contextClass);
+
+        if (sAppCacheUtils == null) {
+            sAppCacheUtils = AppCacheUtils.getInstance(context);
+            LogUtils.d(TAG, "【getAppCacheUtils】缓存工具实例为空，已初始化新实例");
+        }
+        return sAppCacheUtils;
+    }
+
+    // ====================================== 公共成员方法 - 业务逻辑 (实例方法) ======================================
+    /**
+     * 清除电池历史数据
+     */
+    public void clearBatteryHistory() {
+        LogUtils.d(TAG, "【clearBatteryHistory】清除电池历史数据方法调用");
+        if (sAppCacheUtils != null) {
+            sAppCacheUtils.clearBatteryHistory();
+            LogUtils.d(TAG, "【clearBatteryHistory】电池历史数据清除成功");
+        } else {
+            LogUtils.w(TAG, "【clearBatteryHistory】电池历史数据清除失败 | 缓存工具实例sAppCacheUtils为空");
+        }
+    }
+
+    /**
+     * 获取视图缓存实例
+     * @return 视图缓存MemoryCachedBackgroundView实例
+     */
+    public MemoryCachedBackgroundView getMemoryCachedBackgroundView() {
+        LogUtils.d(TAG, "【getMemoryCachedBackgroundView】视图缓存获取方法调用 | 当前实例：" + sMemoryCachedBackgroundView);
+        return sMemoryCachedBackgroundView;
+    }
+
+    // ====================================== 公共静态方法 - 业务逻辑 (全局工具方法) ======================================
+    /**
+     * 手动清理所有缓存（仅主动调用生效，符合极致缓存策略）
+     */
+    public static void manualClearAllCache() {
+        LogUtils.w(CACHE_PROTECT_TAG, "【manualClearAllCache】手动清理缓存方法调用 | 仅主动触发生效");
+
+        // 清理Bitmap缓存
+        if (sBitmapCacheUtils != null) {
+            sBitmapCacheUtils.clearAllCache();
+            LogUtils.d(CACHE_PROTECT_TAG, "【manualClearAllCache】Bitmap缓存已清理");
+        }
+
+        // 仅置空视图缓存引用，不销毁实例（极致缓存策略）
+        if (sMemoryCachedBackgroundView != null) {
+            LogUtils.d(CACHE_PROTECT_TAG, "【manualClearAllCache】视图缓存引用已置空 | 实例保留");
+            sMemoryCachedBackgroundView = null;
+        }
+
+        LogUtils.w(CACHE_PROTECT_TAG, "【manualClearAllCache】手动清理缓存操作完成");
+    }
+
+    /**
+     * 发送通知消息（仅调试模式下生效）
+     * @param title 通知标题
+     * @param content 通知内容
+     */
+    public static void notifyMessage(String title, String content) {
+        LogUtils.d(TAG, "【notifyMessage】发送通知消息方法调用 | 标题：" + title + " | 内容：" + content);
+
+        boolean canSend = isDebugging() && sApp != null && sNotificationManagerUtils != null;
+        if (canSend) {
+            NotificationMessage message = new NotificationMessage(title, content, "");
+            sNotificationManagerUtils.showMessageNotification(sApp, message);
+            LogUtils.d(TAG, "【notifyMessage】通知消息发送成功");
+        } else {
+            LogUtils.d(TAG, "【notifyMessage】通知消息发送失败 | 条件不满足：调试模式=" + isDebugging() + " | 应用实例=" + (sApp != null) + " | 通知工具=" + (sNotificationManagerUtils != null));
+        }
+    }
+
+    // ====================================== 生命周期方法 - 应用全局生命周期 (重写父类方法) ======================================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "【onCreate】应用启动生命周期方法调用 | 开始初始化应用...");
+
+        // 初始化应用单例与调试模式
+        sApp = this;
+        setIsDebugging(BuildConfig.DEBUG);
+        LogUtils.d(TAG, "【onCreate】应用单例已初始化 | 调试模式：" + BuildConfig.DEBUG);
+
+        // 初始化核心组件
+        initBaseTools();
+        initUtils();
+        initReceiver();
+
+        LogUtils.d(TAG, "【onCreate】应用初始化完成 | 极致强制缓存策略已激活");
+    }
+
+    @Override
+    public void onTerminate() {
+        super.onTerminate();
+        LogUtils.d(TAG, "【onTerminate】应用终止生命周期方法调用 | 开始释放非缓存资源...");
+
+        // 释放非缓存资源
+        ToastUtils.release();
+        releaseNotificationManager();
+        releaseReceiver();
+
+        // 核心策略：不清理任何缓存
+        LogUtils.w(CACHE_PROTECT_TAG, "【onTerminate】极致缓存策略生效 | 所有缓存将保留在内存中");
+        LogUtils.d(TAG, "【onTerminate】非缓存资源释放完成");
+    }
+
+    @Override
+    public void onTrimMemory(int level) {
+        super.onTrimMemory(level);
+        LogUtils.w(CACHE_PROTECT_TAG, "【onTrimMemory】系统内存修剪回调 | 内存等级：" + level + " | 忽略修剪，缓存强制保护");
+        logDetailedCacheStatus();
+    }
+
+    @Override
+    public void onLowMemory() {
+        super.onLowMemory();
+        LogUtils.w(CACHE_PROTECT_TAG, "【onLowMemory】系统低内存回调 | 极致缓存策略生效 | 不执行任何缓存清理操作");
+        logDetailedCacheStatus();
+    }
+
+    // ====================================== 私有初始化方法 - 组件初始化 (按依赖顺序排序) ======================================
+    /**
+     * 初始化基础工具类（Activity管理、Toast、通知管理器）
+     */
+    private void initBaseTools() {
+        LogUtils.d(TAG, "【initBaseTools】基础工具类初始化开始...");
+        WinBoLLActivityManager.init(this);
+        ToastUtils.init(this);
+        sNotificationManagerUtils = new NotificationManagerUtils(this);
+        LogUtils.d(TAG, "【initBaseTools】基础工具类初始化完成");
+    }
+
+    /**
+     * 初始化核心工具与缓存（极致强制驻留，缓存核心）
+     */
+    private void initUtils() {
+        LogUtils.d(TAG, "【initUtils】核心工具与缓存初始化开始 | 极致缓存策略激活");
+
+        // 1. 配置与基础缓存工具初始化
+        sAppConfigUtils = getAppConfigUtils(this);
+        sAppCacheUtils = getAppCacheUtils(this);
+
+        // 2. 资源与Bitmap缓存工具初始化（永久驻留）
+        sBackgroundSourceUtils = BackgroundSourceUtils.getInstance(this);
+        sBackgroundSourceUtils.loadSettings();
+        sBitmapCacheUtils = BitmapCacheUtils.getInstance();
+        LogUtils.d(TAG, "【initUtils】资源与Bitmap缓存工具初始化完成 | 永久驻留内存");
+
+        // 3. 视图缓存初始化（永久驻留，无实例则创建）
+        sMemoryCachedBackgroundView = MemoryCachedBackgroundView.getLastInstance(this);
+        if (sMemoryCachedBackgroundView == null) {
+            sMemoryCachedBackgroundView = MemoryCachedBackgroundView.getInstance(this, sBackgroundSourceUtils.getCurrentBackgroundBean(), true);
+            LogUtils.d(TAG, "【initUtils】视图缓存无现有实例，已创建新实例");
+        }
+        LogUtils.d(TAG, "【initUtils】视图缓存初始化完成 | 永久驻留内存");
+    }
+
+    /**
+     * 注册全局广播接收器
+     */
+    private void initReceiver() {
+        LogUtils.d(TAG, "【initReceiver】全局广播接收器注册开始...");
+        mGlobalReceiver = new GlobalApplicationReceiver(this);
+        mGlobalReceiver.registerAction();
+        LogUtils.d(TAG, "【initReceiver】全局广播接收器注册完成");
+    }
+
+    // ====================================== 私有释放方法 - 资源释放 (按创建逆序排序) ======================================
+    /**
+     * 释放全局广播接收器
+     */
+    private void releaseReceiver() {
+        LogUtils.d(TAG, "【releaseReceiver】全局广播接收器释放开始...");
+        if (mGlobalReceiver != null) {
+            mGlobalReceiver.unregisterAction();
+            mGlobalReceiver = null;
+            LogUtils.d(TAG, "【releaseReceiver】全局广播接收器释放完成");
+        }
+    }
+
+    /**
+     * 释放通知管理器资源
+     */
+    private void releaseNotificationManager() {
+        LogUtils.d(TAG, "【releaseNotificationManager】通知管理器资源释放开始...");
+        if (sNotificationManagerUtils != null) {
+            sNotificationManagerUtils.release();
+            sNotificationManagerUtils = null;
+            LogUtils.d(TAG, "【releaseNotificationManager】通知管理器资源释放完成");
+        }
+    }
+
+    // ====================================== 私有辅助方法 - 日志/工具 (辅助功能) ======================================
+    /**
+     * 记录当前缓存详细状态（用于调试监控，极致缓存策略监控）
+     */
+    private void logDetailedCacheStatus() {
+        LogUtils.d(TAG, "【logDetailedCacheStatus】缓存状态监控日志开始...");
+
+        // Bitmap缓存状态
+        if (sBitmapCacheUtils != null) {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】BitmapCache - 有效");
+            try {
+                LogUtils.d(CACHE_PROTECT_TAG, "【缓存详情】Bitmap缓存数量：" + sBitmapCacheUtils.getCacheCount());
+            } catch (Exception e) {
+                LogUtils.e(CACHE_PROTECT_TAG, "【缓存详情】获取Bitmap缓存数量失败", e);
+            }
+        } else {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】BitmapCache - 未初始化");
+        }
+
+        // 视图缓存状态
+        if (sMemoryCachedBackgroundView != null) {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】ViewCache - 有效");
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存详情】视图实例数量：" + MemoryCachedBackgroundView.getInstanceCount());
+        } else {
+            LogUtils.d(CACHE_PROTECT_TAG, "【缓存状态】ViewCache - 引用已置空（实例可能保留）");
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/MainActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/MainActivity.java
new file mode 100644
index 0000000..b482573
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/MainActivity.java
@@ -0,0 +1,637 @@
+package cc.winboll.studio.powerbell;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.graphics.drawable.Drawable;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Message;
+import android.view.KeyEvent;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewStub;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.models.APPInfo;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.DevelopUtils;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libaes.views.ADsBannerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.activities.AboutActivity;
+import cc.winboll.studio.powerbell.activities.BackgroundSettingsActivity;
+import cc.winboll.studio.powerbell.activities.BatteryReportActivity;
+import cc.winboll.studio.powerbell.activities.ClearRecordActivity;
+import cc.winboll.studio.powerbell.activities.SettingsActivity;
+import cc.winboll.studio.powerbell.activities.WinBoLLActivity;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.models.BatteryStyle;
+import cc.winboll.studio.powerbell.models.ControlCenterServiceBean;
+import cc.winboll.studio.powerbell.services.ControlCenterService;
+import cc.winboll.studio.powerbell.unittest.MainUnitTest2Activity;
+import cc.winboll.studio.powerbell.unittest.MainUnitTestActivity;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.ImageUtils;
+import cc.winboll.studio.powerbell.utils.PermissionUtils;
+import cc.winboll.studio.powerbell.utils.ServiceUtils;
+import cc.winboll.studio.powerbell.views.BatteryStyleView;
+import cc.winboll.studio.powerbell.views.MainContentView;
+
+/**
+ * 应用核心主活动
+ * 功能：管理电池监控、背景设置、服务启停、权限申请等核心功能
+ * 适配：Java7 | API30 | 内存泄漏防护 | UI与服务状态实时同步
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class MainActivity extends WinBoLLActivity implements MainContentView.OnViewActionListener {
+
+    // ======================== 静态常量区（抽离魔法值，按功能分类）========================
+    public static final String TAG = "MainActivity";
+    private static final int REQUEST_BACKGROUND_SETTINGS_ACTIVITY = 1001;
+    public static final String EXTRA_ISRELOAD_BACKGROUNDVIEW = "EXTRA_ISRELOAD_BACKGROUNDVIEW";
+    public static final String EXTRA_ISRELOAD_ACCENTCOLOR = "EXTRA_ISRELOAD_ACCENTCOLOR";
+    private static final long DELAY_LOAD_NON_CRITICAL = 500L;
+
+    // Handler 消息常量
+    public static final int MSG_RELOAD_APPCONFIG = 0;
+    public static final int MSG_CURRENTVALUEBATTERY = 1;
+    public static final int MSG_LOAD_BACKGROUND = 2;
+    private static final int MSG_UPDATE_SERVICE_SWITCH = 3;
+	private static final int MSG_UPDATE_BATTERYDRAWABLE = 4;
+
+    // ======================== 静态成员区（全局共享，管控生命周期）========================
+    private static MainActivity sMainActivity;
+    private static Handler sGlobalHandler;
+
+    // ======================== 工具类实例区（单例化，避免重复初始化）========================
+    private PermissionUtils mPermissionUtils;
+    private AppConfigUtils mAppConfigUtils;
+    private BackgroundSourceUtils mBgSourceUtils;
+
+    // ======================== 应用核心实例区 =========================
+    private App mApplication;
+    private MainContentView mMainContentView;
+    private ControlCenterServiceBean mServiceControlBean;
+
+    // ======================== 基础视图组件区 =========================
+    private Toolbar mToolbar;
+    private ViewStub mAdsViewStub;
+    private ADsBannerView mADsBannerView;
+    private Drawable mFrameDrawable;
+    private Menu mMenu;
+
+    // ======================== 生命周期方法区（按系统调用顺序排列）========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate() 调用 | savedInstanceState: " + savedInstanceState);
+
+        initGlobalHandler();
+        setContentView(R.layout.activity_main);
+        initPermissionUtils();
+        initMainContentView();
+        initCriticalView();
+        initCoreUtilsAsync();
+        loadNonCriticalViewDelayed();
+
+        // 处理首次启动参数
+        handleReloadBackgroundParam(getIntent());
+    }
+
+    @Override
+    protected void onNewIntent(Intent intent) {
+        super.onNewIntent(intent);
+        LogUtils.d(TAG, "onNewIntent() 调用 | intent: " + intent);
+        // 关键：更新Activity持有的Intent，确保后续获取最新值
+        setIntent(intent);
+        // 统一处理刷新背景参数
+        handleReloadBackgroundParam(intent);
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        LogUtils.d(TAG, "onPostCreate() 调用 | savedInstanceState: " + savedInstanceState);
+        mPermissionUtils.startPermissionRequest(this);
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "onResume() 调用");
+
+        if (mADsBannerView != null) {
+            mADsBannerView.resumeADs(this);
+            LogUtils.d(TAG, "onResume: 广告视图已恢复");
+        }
+    }
+
+    @Override
+    protected void onPause() {
+        super.onPause();
+        LogUtils.d(TAG, "onPause() 调用");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy() 调用");
+
+        // 释放广告资源
+        if (mADsBannerView != null) {
+            mADsBannerView.releaseAdResources();
+            mADsBannerView = null;
+            LogUtils.d(TAG, "onDestroy: 广告资源已释放");
+        }
+        // 释放核心视图
+        if (mMainContentView != null) {
+            mMainContentView.releaseResources();
+            mMainContentView = null;
+            LogUtils.d(TAG, "onDestroy: 核心视图资源已释放");
+        }
+        // 销毁Handler防止内存泄漏
+        if (sGlobalHandler != null) {
+            sGlobalHandler.removeCallbacksAndMessages(null);
+            sGlobalHandler = null;
+            LogUtils.d(TAG, "onDestroy: 全局Handler已销毁");
+        }
+        // 释放Drawable
+        if (mFrameDrawable != null) {
+            mFrameDrawable.setCallback(null);
+            mFrameDrawable = null;
+            LogUtils.d(TAG, "onDestroy: 框架Drawable已释放");
+        }
+        // 置空所有引用，消除内存泄漏风险
+        sMainActivity = null;
+        mPermissionUtils = null;
+        mAppConfigUtils = null;
+        mBgSourceUtils = null;
+        mServiceControlBean = null;
+        mMenu = null;
+        mApplication = null;
+        mToolbar = null;
+        mAdsViewStub = null;
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        LogUtils.d(TAG, "onActivityResult() 调用 | requestCode: " + requestCode + " | resultCode: " + resultCode + " | data: " + data);
+        mPermissionUtils.handlePermissionRequest(this, requestCode, resultCode, data);
+
+        if (requestCode == REQUEST_BACKGROUND_SETTINGS_ACTIVITY && sGlobalHandler != null) {
+            sGlobalHandler.sendEmptyMessage(MSG_LOAD_BACKGROUND);
+            LogUtils.d(TAG, "onActivityResult: 发送背景加载消息");
+        }
+    }
+
+    // ======================== 菜单与导航方法区 ========================
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        LogUtils.d(TAG, "onCreateOptionsMenu() 调用 | menu: " + menu);
+        mMenu = menu;
+        AESThemeUtil.inflateMenu(this, menu);
+
+        // 调试模式加载测试菜单
+        if (App.isDebugging()) {
+            DevelopUtils.inflateMenu(this, menu);
+            getMenuInflater().inflate(R.menu.toolbar_unittest, mMenu);
+            LogUtils.d(TAG, "onCreateOptionsMenu: 已加载测试菜单");
+        }
+        getMenuInflater().inflate(R.menu.toolbar_main, mMenu);
+        return true;
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        LogUtils.d(TAG, "onOptionsItemSelected() 调用 | itemId: " + item.getItemId());
+        // 主题切换处理
+        if (AESThemeUtil.onAppThemeItemSelected(this, item)) {
+            recreate();
+			Intent mainIntent = new Intent(MainActivity.this, MainActivity.class);
+			mainIntent.putExtra(MainActivity.EXTRA_ISRELOAD_BACKGROUNDVIEW, true);
+			mainIntent.putExtra(MainActivity.EXTRA_ISRELOAD_ACCENTCOLOR, true);
+			startActivity(mainIntent);
+            return true;
+        }
+        // 开发者功能处理
+        if (DevelopUtils.onDevelopItemSelected(this, item)) {
+            return true;
+        }
+        // 菜单点击事件分发
+        switch (item.getItemId()) {
+            case R.id.action_settings:
+                startActivity(new Intent(this, SettingsActivity.class));
+                break;
+            case R.id.action_battery_report:
+                startActivity(new Intent(this, BatteryReportActivity.class));
+                break;
+            case R.id.action_clearrecord:
+                startActivity(new Intent(this, ClearRecordActivity.class));
+                break;
+            case R.id.action_changepicture:
+                startActivityForResult(new Intent(this, BackgroundSettingsActivity.class), REQUEST_BACKGROUND_SETTINGS_ACTIVITY);
+                break;
+            case R.id.action_unittestactivity:
+                startActivity(new Intent(this, MainUnitTestActivity.class));
+                break;
+            case R.id.action_unittest2activity:
+                startActivity(new Intent(this, MainUnitTest2Activity.class));
+                break;
+            case R.id.action_about:
+                startAboutActivity();
+                break;
+            default:
+                return super.onOptionsItemSelected(item);
+        }
+        return true;
+    }
+
+    @Override
+    public void setupToolbar() {
+        super.setupToolbar();
+        LogUtils.d(TAG, "setupToolbar() 调用");
+        if (getSupportActionBar() != null) {
+            getSupportActionBar().setDisplayHomeAsUpEnabled(false);
+            LogUtils.d(TAG, "setupToolbar: 已隐藏返回按钮");
+        }
+    }
+
+    @Override
+    public void onBackPressed() {
+        LogUtils.d(TAG, "onBackPressed() 调用");
+        moveTaskToBack(true);
+        LogUtils.d(TAG, "onBackPressed: 应用已退至后台");
+    }
+
+    @Override
+    public boolean dispatchKeyEvent(KeyEvent event) {
+        LogUtils.d(TAG, "dispatchKeyEvent() 调用 | event: " + event);
+        return super.dispatchKeyEvent(event);
+    }
+
+    // ======================== 核心初始化方法区 ========================
+    private void initPermissionUtils() {
+        LogUtils.d(TAG, "initPermissionUtils() 调用");
+        mPermissionUtils = PermissionUtils.getInstance();
+        LogUtils.d(TAG, "initPermissionUtils: 权限工具类已初始化");
+    }
+
+    private void initGlobalHandler() {
+        LogUtils.d(TAG, "initGlobalHandler() 调用");
+        if (sGlobalHandler == null) {
+            sGlobalHandler = new Handler() {
+                @Override
+                public void handleMessage(Message msg) {
+                    // Activity已销毁则跳过消息处理
+                    if (sMainActivity == null || sMainActivity.isFinishing() || sMainActivity.isDestroyed()) {
+                        LogUtils.w(TAG, "handleMessage: Activity已销毁，跳过消息 | what: " + msg.what);
+                        return;
+                    }
+                    LogUtils.d(TAG, "handleMessage() 调用 | what: " + msg.what);
+
+                    switch (msg.what) {
+                        case MSG_RELOAD_APPCONFIG:
+                            sMainActivity.updateViewData();
+                            break;
+                        case MSG_CURRENTVALUEBATTERY:
+                            if (sMainActivity.mMainContentView != null) {
+                                sMainActivity.mMainContentView.updateCurrentBattery(msg.arg1);
+                                LogUtils.d(TAG, "handleMessage: 更新当前电量 | value: " + msg.arg1);
+                            }
+                            break;
+                        case MSG_LOAD_BACKGROUND:
+                            sMainActivity.reloadBackground();
+                            break;
+                        case MSG_UPDATE_SERVICE_SWITCH:
+                            sMainActivity.updateServiceSwitchUI();
+                            break;
+						case MSG_UPDATE_BATTERYDRAWABLE:
+                            sMainActivity.updateBatteryDrawable();
+                            break;
+                    }
+                }
+            };
+            LogUtils.d(TAG, "initGlobalHandler: 全局Handler已创建");
+        } else {
+            LogUtils.d(TAG, "initGlobalHandler: 全局Handler已存在，无需重复创建");
+        }
+    }
+
+    private void initMainContentView() {
+        LogUtils.d(TAG, "initMainContentView() 调用");
+        View rootView = findViewById(android.R.id.content);
+        mMainContentView = new MainContentView(this, rootView, this);
+        LogUtils.d(TAG, "initMainContentView: 核心内容视图已初始化");
+    }
+
+    private void initCriticalView() {
+        LogUtils.d(TAG, "initCriticalView() 调用");
+        sMainActivity = this;
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        if (mToolbar != null) {
+            mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+            LogUtils.d(TAG, "initCriticalView: 工具栏已设置标题样式");
+        }
+        mAdsViewStub = findViewById(R.id.stub_ads_banner);
+        LogUtils.d(TAG, "initCriticalView: 广告ViewStub已获取");
+    }
+
+    private void initCoreUtilsAsync() {
+        LogUtils.d(TAG, "initCoreUtilsAsync() 调用");
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					LogUtils.d(TAG, "initCoreUtilsAsync: 异步线程启动 | threadId: " + Thread.currentThread().getId());
+					mApplication = (App) getApplication();
+					mAppConfigUtils = AppConfigUtils.getInstance(getApplicationContext());
+					mBgSourceUtils = BackgroundSourceUtils.getInstance(getActivity());
+
+					// 初始化服务控制配置
+					mServiceControlBean = ControlCenterServiceBean.loadBean(getApplicationContext(), ControlCenterServiceBean.class);
+					if (mServiceControlBean == null) {
+						mServiceControlBean = new ControlCenterServiceBean(false);
+						ControlCenterServiceBean.saveBean(getApplicationContext(), mServiceControlBean);
+						LogUtils.d(TAG, "initCoreUtilsAsync: 服务配置不存在，已创建默认配置");
+					}
+
+					// 根据配置启停服务
+					final boolean isServiceEnable = mServiceControlBean.isEnableService();
+					final boolean isServiceAlive = ServiceUtils.isServiceAlive(getApplicationContext(), ControlCenterService.class.getName());
+					LogUtils.d(TAG, "initCoreUtilsAsync: 服务配置状态 | isServiceEnable: " + isServiceEnable + " | isServiceAlive: " + isServiceAlive);
+
+					if (isServiceEnable && !isServiceAlive) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									ControlCenterService.startControlCenterService(getApplicationContext());
+									LogUtils.d(TAG, "initCoreUtilsAsync: 服务已启动");
+								}
+							});
+					} else if (!isServiceEnable && isServiceAlive) {
+						runOnUiThread(new Runnable() {
+								@Override
+								public void run() {
+									ControlCenterService.stopControlCenterService(getApplicationContext());
+									LogUtils.d(TAG, "initCoreUtilsAsync: 服务已停止");
+								}
+							});
+					}
+
+					// 主线程更新UI
+					runOnUiThread(new Runnable() {
+							@Override
+							public void run() {
+								if (isFinishing() || isDestroyed()) {
+									LogUtils.w(TAG, "initCoreUtilsAsync: Activity已销毁，跳过UI更新");
+									return;
+								}
+								// 适配API30，兼容低版本Drawable加载
+								if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+									mFrameDrawable = getResources().getDrawable(R.drawable.bg_frame, getTheme());
+								} else {
+									mFrameDrawable = getResources().getDrawable(R.drawable.bg_frame);
+								}
+								updateViewData();
+								sGlobalHandler.sendEmptyMessage(MSG_LOAD_BACKGROUND);
+								sGlobalHandler.sendEmptyMessage(MSG_UPDATE_SERVICE_SWITCH);
+								LogUtils.d(TAG, "initCoreUtilsAsync: UI更新消息已发送");
+							}
+						});
+				}
+			}).start();
+    }
+
+    private void loadNonCriticalViewDelayed() {
+        LogUtils.d(TAG, "loadNonCriticalViewDelayed() 调用 | 延迟时长: " + DELAY_LOAD_NON_CRITICAL + "ms");
+        new Handler().postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					if (isFinishing() || isDestroyed()) {
+						LogUtils.w(TAG, "loadNonCriticalViewDelayed: Activity已销毁，跳过广告加载");
+						return;
+					}
+					loadAdsView();
+				}
+			}, DELAY_LOAD_NON_CRITICAL);
+    }
+
+    // ======================== 视图操作方法区 ========================
+    private void handleReloadBackgroundParam(Intent intent) {
+        LogUtils.d(TAG, "handleReloadBackgroundParam() 调用 | intent: " + intent);
+        if (intent == null) {
+            LogUtils.d(TAG, "handleReloadBackgroundParam: Intent 为空");
+            return;
+        }
+
+		boolean isReloadAccentColor = intent.getBooleanExtra(EXTRA_ISRELOAD_ACCENTCOLOR, false);
+        if (isReloadAccentColor) {
+			App.sBackgroundSourceUtils.getCurrentBackgroundBean().setPixelColor(ImageUtils.getColorAccent(this));
+			App.sBackgroundSourceUtils.saveSettings();
+        }
+
+        boolean isReloadBackgroundView = intent.getBooleanExtra(EXTRA_ISRELOAD_BACKGROUNDVIEW, false);
+        if (isReloadBackgroundView) {
+            LogUtils.d(TAG, "handleReloadBackgroundParam: 接收到刷新背景视图指令");
+            reloadBackgroundView();
+        }
+    }
+
+    private void reloadBackgroundView() {
+        LogUtils.d(TAG, "reloadBackgroundView() 调用");
+        mMainContentView.reloadBackgroundView();
+    }
+
+    private void loadAdsView() {
+        LogUtils.d(TAG, "loadAdsView() 调用");
+        if (mAdsViewStub == null) {
+            LogUtils.e(TAG, "loadAdsView: 广告ViewStub为空，加载失败");
+            return;
+        }
+        if (mADsBannerView == null) {
+            View adsView = mAdsViewStub.inflate();
+            mADsBannerView = adsView.findViewById(R.id.adsbanner);
+            LogUtils.d(TAG, "loadAdsView: 广告视图已加载");
+        } else {
+            LogUtils.d(TAG, "loadAdsView: 广告视图已存在，无需重复加载");
+        }
+    }
+
+    private void updateViewData() {
+        LogUtils.d(TAG, "updateViewData() 调用");
+        if (mMainContentView == null || mFrameDrawable == null) {
+            LogUtils.e(TAG, "updateViewData: 核心视图或框架背景为空，更新失败");
+            return;
+        }
+        mMainContentView.updateViewData(mFrameDrawable);
+        LogUtils.d(TAG, "updateViewData: 视图数据已更新");
+    }
+
+	void updateBatteryDrawable() {
+		BatteryStyle batteryStyle = BatteryStyleView.getSavedBatteryStyle(this);
+		mMainContentView.updateBatteryDrawable(batteryStyle);
+	}
+
+	public static void sendUpdateBatteryDrawableMessage() {
+		if (sGlobalHandler != null) {
+			sGlobalHandler.sendEmptyMessage(MSG_UPDATE_BATTERYDRAWABLE);
+		}
+	}
+
+    private void reloadBackground() {
+        LogUtils.d(TAG, "reloadBackground() 调用");
+        if (mMainContentView == null || mBgSourceUtils == null) {
+            LogUtils.e(TAG, "reloadBackground: 核心视图或背景工具类为空，加载失败");
+            return;
+        }
+        BackgroundBean currentBgBean = mBgSourceUtils.getCurrentBackgroundBean();
+        if (currentBgBean != null) {
+            mMainContentView.backgroundView.loadByBackgroundBean(currentBgBean, true);
+            LogUtils.d(TAG, "reloadBackground: 已加载自定义背景");
+        } else {
+            mMainContentView.backgroundView.setBackgroundResource(R.drawable.default_background);
+            LogUtils.d(TAG, "reloadBackground: 已加载默认背景");
+        }
+    }
+
+    private void updateServiceSwitchUI() {
+        LogUtils.d(TAG, "updateServiceSwitchUI() 调用");
+        if (mMainContentView == null || mServiceControlBean == null) {
+            LogUtils.e(TAG, "updateServiceSwitchUI: 核心视图或服务配置为空，更新失败");
+            return;
+        }
+        boolean configEnabled = mServiceControlBean.isEnableService();
+        mMainContentView.setServiceSwitchEnabled(false);
+        mMainContentView.setServiceSwitchChecked(configEnabled);
+        mMainContentView.setServiceSwitchEnabled(true);
+        LogUtils.d(TAG, "updateServiceSwitchUI: 服务开关已更新 | 状态: " + configEnabled);
+    }
+
+    // ======================== 服务与线程管理方法区 ========================
+    private void toggleServiceEnableState(boolean isEnable) {
+        LogUtils.d(TAG, "toggleServiceEnableState() 调用 | 目标状态: " + isEnable);
+        if (mServiceControlBean == null) {
+            LogUtils.e(TAG, "toggleServiceEnableState: 服务配置为空，切换失败");
+            return;
+        }
+        mServiceControlBean.setIsEnableService(isEnable);
+        ControlCenterServiceBean.saveBean(getApplicationContext(), mServiceControlBean);
+        LogUtils.d(TAG, "toggleServiceEnableState: 服务配置已保存");
+
+        // UI开关联动服务启停
+        if (isEnable) {
+            if (!ServiceUtils.isServiceAlive(getApplicationContext(), ControlCenterService.class.getName())) {
+                ControlCenterService.startControlCenterService(getApplicationContext());
+                LogUtils.d(TAG, "toggleServiceEnableState: 服务已启动");
+            }
+        } else {
+            ControlCenterService.stopControlCenterService(getApplicationContext());
+            LogUtils.d(TAG, "toggleServiceEnableState: 服务已停止");
+        }
+
+        sGlobalHandler.sendEmptyMessage(MSG_UPDATE_SERVICE_SWITCH);
+    }
+
+    // ======================== 页面跳转方法区 ========================
+    private void startAboutActivity() {
+        LogUtils.d(TAG, "startAboutActivity() 调用");
+        Intent aboutIntent = new Intent(getApplicationContext(), AboutActivity.class);
+        APPInfo appInfo = genDefaultAppInfo();
+        WinBoLLActivityManager.getInstance().startWinBoLLActivity(getApplicationContext(), aboutIntent, AboutActivity.class);
+        LogUtils.d(TAG, "startAboutActivity: 关于页面已启动");
+    }
+
+    // ======================== 消息发送方法区 ========================
+    private void notifyServiceAppConfigChange() {
+        LogUtils.d(TAG, "notifyServiceAppConfigChange() 调用");
+        ControlCenterService.sendAppConfigStatusUpdateMessage(this);
+        reloadAppConfig();
+        LogUtils.d(TAG, "notifyServiceAppConfigChange: 服务配置已通知更新");
+    }
+
+    public static void reloadAppConfig() {
+        LogUtils.d(TAG, "reloadAppConfig() 调用");
+        if (sGlobalHandler != null) {
+            sGlobalHandler.sendEmptyMessage(MSG_RELOAD_APPCONFIG);
+            LogUtils.d(TAG, "reloadAppConfig: 配置重载消息已发送");
+        } else {
+            LogUtils.w(TAG, "reloadAppConfig: 全局Handler为空，消息发送失败");
+        }
+    }
+
+    public static void sendCurrentBatteryValueMessage(int value) {
+        LogUtils.d(TAG, "sendCurrentBatteryValueMessage() 调用 | 电量: " + value);
+        if (sGlobalHandler != null) {
+            Message msg = sGlobalHandler.obtainMessage(MSG_CURRENTVALUEBATTERY);
+            msg.arg1 = value;
+            sGlobalHandler.sendMessage(msg);
+            LogUtils.d(TAG, "sendCurrentBatteryValueMessage: 电量消息已发送");
+        } else {
+            LogUtils.w(TAG, "sendCurrentBatteryValueMessage: 全局Handler为空，消息发送失败");
+        }
+    }
+
+    // ======================== 辅助工具方法区 ========================
+    private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "powerbell";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName(getString(R.string.app_name));
+        appInfo.setAppIcon(R.drawable.ic_launcher);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=PowerBell");
+        appInfo.setAppAPKName("PowerBell");
+        appInfo.setAppAPKFolderName("PowerBell");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+
+    // ======================== MainContentView 事件回调区 ========================
+    @Override
+    public void onChargeReminderSwitchChanged(boolean isChecked) {
+        LogUtils.d(TAG, "onChargeReminderSwitchChanged() 调用 | isChecked: " + isChecked);
+        notifyServiceAppConfigChange();
+    }
+
+    @Override
+    public void onUsageReminderSwitchChanged(boolean isChecked) {
+        LogUtils.d(TAG, "onUsageReminderSwitchChanged() 调用 | isChecked: " + isChecked);
+        notifyServiceAppConfigChange();
+    }
+
+    @Override
+    public void onServiceSwitchChanged(boolean isChecked) {
+        LogUtils.d(TAG, "onServiceSwitchChanged() 调用 | isChecked: " + isChecked);
+        toggleServiceEnableState(isChecked);
+    }
+
+    @Override
+    public void onChargeReminderProgressChanged(int progress) {
+        LogUtils.d(TAG, "onChargeReminderProgressChanged() 调用 | progress: " + progress);
+        notifyServiceAppConfigChange();
+    }
+
+    @Override
+    public void onUsageReminderProgressChanged(int progress) {
+        LogUtils.d(TAG, "onUsageReminderProgressChanged() 调用 | progress: " + progress);
+        notifyServiceAppConfigChange();
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/AboutActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/AboutActivity.java
new file mode 100644
index 0000000..21e1fa6
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/AboutActivity.java
@@ -0,0 +1,81 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+import cc.winboll.studio.powerbell.R;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/13 11:25
+ * @Describe 应用介绍窗口
+ */
+public class AboutActivity extends WinBoLLActivity {
+
+    public static final String TAG = "AboutActivity";
+	private Toolbar mToolbar;
+	@Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+	
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+		// 设置工具栏
+        initToolbar();
+
+		AboutView aboutView = findViewById(R.id.aboutview);
+		aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+	
+	private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+	private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "powerbell";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName(getString(R.string.app_name));
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getString(R.string.app_description));
+        appInfo.setAppGitName("PowerBell");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=PowerBell");
+        appInfo.setAppAPKName("PowerBell");
+        appInfo.setAppAPKFolderName("PowerBell");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BackgroundSettingsActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BackgroundSettingsActivity.java
new file mode 100644
index 0000000..8c10b6b
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BackgroundSettingsActivity.java
@@ -0,0 +1,994 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.Manifest;
+import android.app.Activity;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.graphics.Bitmap;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.provider.MediaStore;
+import android.provider.Settings;
+import android.text.TextUtils;
+import android.view.View;
+import android.view.ViewTreeObserver;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.widget.Toolbar;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+import androidx.core.content.FileProvider;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.dialogs.BackgroundPicturePreviewDialog;
+import cc.winboll.studio.powerbell.dialogs.ColorPaletteDialog;
+import cc.winboll.studio.powerbell.dialogs.NetworkBackgroundDialog;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.BitmapCacheUtils;
+import cc.winboll.studio.powerbell.utils.FileUtils;
+import cc.winboll.studio.powerbell.utils.ImageCropUtils;
+import cc.winboll.studio.powerbell.utils.ImageUtils;
+import cc.winboll.studio.powerbell.utils.UriUtils;
+import cc.winboll.studio.powerbell.views.BackgroundView;
+import java.io.File;
+
+/**
+ * 背景设置页面（支持图片选择、拍照、裁剪、像素拾取、调色板等功能）
+ * 核心：基于强制缓存策略，支持预览与设置提交分离，保留操作状态
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class BackgroundSettingsActivity extends WinBoLLActivity {
+    // ====================== 常量定义（按功能分类排序）======================
+    public static final String TAG = "BackgroundSettingsActivity";
+
+    // 系统版本常量
+    private static final int SDK_VERSION_TIRAMISU = 33;
+
+    // 请求码（按功能分组，从小到大排序）
+    public static final int REQUEST_SELECT_PICTURE = 0;
+    public static final int REQUEST_TAKE_PHOTO = 1;
+    public static final int REQUEST_CROP_IMAGE = 2;
+    private static final int REQUEST_PIXELPICKER = 1001;
+    private static final int REQUEST_CAMERA_PERMISSION = 1004;
+
+    // Bitmap解析常量
+    private static final int BITMAP_MAX_SIZE = 2048;
+    private static final int BITMAP_MAX_SAMPLE_SIZE = 16;
+
+    // ====================== 成员变量（按依赖优先级+功能分类）======================
+    // 工具类实例
+    private BackgroundSourceUtils mBgSourceUtils;
+    private BitmapCacheUtils mBitmapCache;
+
+    // 视图组件
+    private Toolbar mToolbar;
+    private BackgroundView mBackgroundView;
+
+    // 状态标记（volatile保证多线程可见性）
+    private volatile boolean isCommitSettings = false;
+    private volatile boolean isPreviewBackgroundChanged = false;
+
+    // ====================== 生命周期方法（按执行顺序排列）======================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate() 开始初始化");
+        setContentView(R.layout.activity_background_settings);
+
+        // 初始化核心组件
+        initCoreComponents();
+        // 初始化Toolbar与点击事件
+        initToolbar();
+        initClickListeners();
+        LogUtils.d(TAG, "onCreate() 视图与事件绑定完成");
+
+        // 处理分享意图或初始化预览
+        handleIntentOrPreview();
+        // 初始化预览环境并刷新
+        initPreviewEnvironment();
+
+        LogUtils.d(TAG, "onCreate() 初始化完成");
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        LogUtils.d(TAG, "onPostCreate() 执行双重刷新预览");
+
+        // 监听视图布局完成事件
+        mBackgroundView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
+				@Override
+				public void onGlobalLayout() {
+					// 移除监听，避免重复回调
+					if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+						mBackgroundView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
+					} else {
+						mBackgroundView.getViewTreeObserver().removeGlobalOnLayoutListener(this);
+					}
+
+					// 此时已获取真实宽高
+					int width = mBackgroundView.getWidth();
+					int height = mBackgroundView.getHeight();
+					LogUtils.d(TAG, String.format("onPostCreate() 获取视图尺寸 | width=%d | height=%d", width, height));
+					if (width > 0 && height > 0) {
+						AppConfigUtils appConfigUtils = AppConfigUtils.getInstance(BackgroundSettingsActivity.this);
+						appConfigUtils.loadAppConfig();
+						appConfigUtils.mAppConfigBean.setDefaultFrameWidth(width);
+						appConfigUtils.mAppConfigBean.setDefaultFrameHeight(height);
+						appConfigUtils.saveAppConfig();
+						LogUtils.d(TAG, "onPostCreate() 保存默认相框尺寸成功");
+						doubleRefreshPreview();
+					}
+				}
+			});
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        LogUtils.d(TAG, String.format("onActivityResult() | requestCode=%d | resultCode=%d | data=%s",
+									  requestCode, resultCode, data != null ? data.toString() : "null"));
+
+        try {
+            if (resultCode != RESULT_OK) {
+                LogUtils.d(TAG, String.format("onActivityResult() 操作取消 | requestCode=%d", requestCode));
+                handleOperationCancelOrFail();
+                return;
+            }
+            handleActivityResult(requestCode, data);
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("onActivityResult() 异常 | requestCode=%d | 异常信息=%s",
+										  requestCode, e.getMessage()));
+            ToastUtils.show("操作失败");
+        }
+    }
+
+    @Override
+    public void finish() {
+        LogUtils.d(TAG, String.format("finish() | isCommitSettings=%b | isPreviewBackgroundChanged=%b",
+									  isCommitSettings, isPreviewBackgroundChanged));
+        if (isCommitSettings) {
+            super.finish();
+        } else {
+            handleFinishConfirmation();
+        }
+    }
+
+    // ====================== 权限回调方法（单独分类）======================
+    @Override
+    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
+        LogUtils.d(TAG, String.format("onRequestPermissionsResult() | requestCode=%d | 权限数量=%d | 结果数量=%d",
+									  requestCode, permissions.length, grantResults.length));
+        if (requestCode == REQUEST_CAMERA_PERMISSION) {
+            handleCameraPermissionResult(grantResults);
+        }
+    }
+
+    // ====================== 界面初始化方法（Toolbar + 点击事件）======================
+    private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+    private void initClickListeners() {
+        LogUtils.d(TAG, "initClickListeners() 开始绑定按钮点击事件");
+        // 绑定所有按钮点击事件
+        bindClickListener(R.id.activitybackgroundsettingsAButton1, onOriginNullClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton2, onReceivedPictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton3, onTakePhotoClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton4, onSelectPictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton5, onNetworkBackgroundDialog);
+        bindClickListener(R.id.activitybackgroundsettingsAButton6, onCropPictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton7, onCropFreePictureClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton8, onPixelPickerClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton9, onColorPaletteClickListener);
+        bindClickListener(R.id.activitybackgroundsettingsAButton10, onCleanPixelClickListener);
+        LogUtils.d(TAG, "initClickListeners() 按钮点击事件绑定完成");
+    }
+
+    // 通用按钮绑定工具方法
+    private void bindClickListener(int resId, View.OnClickListener listener) {
+        LogUtils.d(TAG, String.format("bindClickListener() | resId=%d", resId));
+        View view = findViewById(resId);
+        if (view != null) {
+            view.setOnClickListener(listener);
+            LogUtils.d(TAG, String.format("bindClickListener() | resId=%d 绑定成功", resId));
+        } else {
+            LogUtils.e(TAG, String.format("bindClickListener() | 未找到视图：%d", resId));
+        }
+    }
+
+    // ====================== 按钮点击事件（按功能分类）======================
+    private View.OnClickListener onOriginNullClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onOriginNullClickListener() | 取消背景图片");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onOriginNullClickListener() | 预览Bean为空");
+                return;
+            }
+            previewBean.setIsUseBackgroundFile(false);
+            mBgSourceUtils.saveSettings();
+            doubleRefreshPreview();
+            isPreviewBackgroundChanged = true;
+        }
+    };
+
+    private View.OnClickListener onSelectPictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onSelectPictureClickListener() | 选择图片");
+            launchImageSelector();
+        }
+    };
+
+    private View.OnClickListener onNetworkBackgroundDialog = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onNetworkBackgroundDialog() | 打开网络背景对话框");
+            NetworkBackgroundDialog networkBackgroundDialog = new NetworkBackgroundDialog(BackgroundSettingsActivity.this, new NetworkBackgroundDialog.OnDialogClickListener() {
+					@Override
+					public void onConfirm(String szConfirmFilePath) {
+						LogUtils.d(TAG, String.format("网络背景确认 onConfirm() | 文件路径=%s", szConfirmFilePath));
+						// 拷贝文件到预览数据并启动裁剪
+						if (putUriFileToPreviewSource(new File(szConfirmFilePath))) {
+							startImageCrop(false);
+						}
+					}
+
+					@Override
+					public void onCancel() {
+						LogUtils.d(TAG, "网络背景取消 onCancel()");
+					}
+				});
+            networkBackgroundDialog.show();
+        }
+    };
+
+    private View.OnClickListener onCropPictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onCropPictureClickListener() | 固定比例裁剪");
+            startImageCrop(false);
+        }
+    };
+
+    private View.OnClickListener onCropFreePictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onCropFreePictureClickListener() | 自由裁剪");
+            startImageCrop(true);
+        }
+    };
+
+    private View.OnClickListener onTakePhotoClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onTakePhotoClickListener() | 拍照");
+            // 动态申请相机权限
+            if (ContextCompat.checkSelfPermission(BackgroundSettingsActivity.this, Manifest.permission.CAMERA)
+				!= PackageManager.PERMISSION_GRANTED) {
+                LogUtils.d(TAG, "拍照准备 | 相机权限未授予，发起申请");
+                ActivityCompat.requestPermissions(
+					BackgroundSettingsActivity.this,
+					new String[]{Manifest.permission.CAMERA},
+					REQUEST_CAMERA_PERMISSION);
+                return;
+            }
+            handleTakePhoto();
+        }
+    };
+
+    private View.OnClickListener onReceivedPictureClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onReceivedPictureClickListener() | 恢复收到的图片");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onReceivedPictureClickListener() | 预览Bean为空");
+                return;
+            }
+            previewBean.setIsUseBackgroundFile(true);
+            mBgSourceUtils.saveSettings();
+            doubleRefreshPreview();
+            isPreviewBackgroundChanged = true;
+        }
+    };
+
+    private View.OnClickListener onPixelPickerClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onPixelPickerClickListener() | 像素拾取");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onPixelPickerClickListener() | 预览Bean为空");
+                ToastUtils.show("无有效图片可拾取像素");
+                return;
+            }
+            String targetImagePath = previewBean.getBackgroundFilePath();
+            File targetFile = new File(targetImagePath);
+            if (targetFile == null || !targetFile.exists() || targetFile.length() <= 0) {
+                ToastUtils.show("无有效图片可拾取像素");
+                LogUtils.e(TAG, String.format("像素拾取失败 | 文件无效：%s", targetImagePath));
+                return;
+            }
+            Intent intent = new Intent(getApplicationContext(), PixelPickerActivity.class);
+            intent.putExtra("imagePath", targetImagePath);
+            startActivityForResult(intent, REQUEST_PIXELPICKER);
+            LogUtils.d(TAG, String.format("像素拾取启动 | 路径：%s", targetImagePath));
+        }
+    };
+
+    private View.OnClickListener onCleanPixelClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onCleanPixelClickListener() | 清空像素颜色");
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onCleanPixelClickListener() | 预览Bean为空");
+                return;
+            }
+            int oldColor = previewBean.getPixelColor();
+            previewBean.setPixelColor(ImageUtils.getColorAccent(BackgroundSettingsActivity.this));
+            mBgSourceUtils.saveSettings();
+            doubleRefreshPreview();
+            isPreviewBackgroundChanged = true;
+            ToastUtils.show("像素颜色已清空");
+            LogUtils.d(TAG, String.format("像素清空 | 旧颜色：#%08X", oldColor));
+        }
+    };
+
+    private View.OnClickListener onColorPaletteClickListener = new View.OnClickListener() {
+        @Override
+        public void onClick(View v) {
+            LogUtils.d(TAG, "onColorPaletteClickListener() | 调色板按钮");
+            final BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            if (previewBean == null) {
+                LogUtils.e(TAG, "onColorPaletteClickListener() | 预览Bean为空");
+                return;
+            }
+            int initialColor = previewBean.getPixelColor();
+            LogUtils.d(TAG, String.format("调色板 | 初始颜色：#%08X", initialColor));
+            ColorPaletteDialog dialog = new ColorPaletteDialog(BackgroundSettingsActivity.this, initialColor, new ColorPaletteDialog.OnColorSelectedListener() {
+					@Override
+					public void onColorSelected(int color) {
+						previewBean.setPixelColor(color);
+						mBgSourceUtils.saveSettings();
+						doubleRefreshPreview();
+						isPreviewBackgroundChanged = true;
+						LogUtils.d(TAG, String.format("颜色选择 | 选中颜色：#%08X", color));
+					}
+				});
+            dialog.show();
+            LogUtils.d(TAG, "调色板 | 对话框已显示");
+        }
+    };
+
+    // ====================== 工具方法（通用工具 + 视图工具）======================
+    /**
+     * 生成 FileProvider Uri，适配 Android 7.0+
+     * @param file 目标文件
+     * @return 适配后的Uri，失败返回null
+     */
+    public Uri getFileProviderUri(File file) {
+        LogUtils.d(TAG, String.format("getFileProviderUri() | 文件路径：%s", (file != null ? file.getAbsolutePath() : "null")));
+        if (file == null) {
+            LogUtils.e(TAG, "getFileProviderUri() | 文件为空");
+            return null;
+        }
+        try {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                String FILE_PROVIDER_AUTHORITY = getPackageName() + ".fileprovider";
+                return FileProvider.getUriForFile(this, FILE_PROVIDER_AUTHORITY, file);
+            } else {
+                return Uri.fromFile(file);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("getFileProviderUri() | 生成Uri失败：%s", e.getMessage()));
+            return null;
+        }
+    }
+
+    /**
+     * 校验 Bitmap 是否有效（未被回收且不为空）
+     * @param bitmap 目标Bitmap
+     * @return 有效返回true，否则false
+     */
+    private boolean isBitmapValid(Bitmap bitmap) {
+        boolean isValid = bitmap != null && !bitmap.isRecycled();
+        LogUtils.d(TAG, String.format("isBitmapValid() | Bitmap有效性校验：%b", isValid));
+        return isValid;
+    }
+
+    /**
+     * 双重刷新预览，确保背景加载最新数据
+     */
+    private void doubleRefreshPreview() {
+        LogUtils.d(TAG, "doubleRefreshPreview() 开始双重刷新预览");
+        if (mBgSourceUtils == null || mBackgroundView == null || isFinishing()) {
+            LogUtils.w(TAG, "双重刷新 跳过：对象为空或Activity已结束");
+            return;
+        }
+
+        // 第一重刷新
+        try {
+            mBgSourceUtils.loadSettings();
+            BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+            mBackgroundView.loadByBackgroundBean(previewBean, true);
+            LogUtils.d(TAG, "双重刷新 第一重完成");
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("双重刷新 第一重异常：%s", e.getMessage()));
+            return;
+        }
+
+        // 第二重刷新（延迟执行）
+        new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					if (mBackgroundView != null && !isFinishing() && mBgSourceUtils != null) {
+						try {
+							mBgSourceUtils.loadSettings();
+							BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+							mBackgroundView.loadByBackgroundBean(previewBean, true);
+							LogUtils.d(TAG, "双重刷新 第二重完成");
+						} catch (Exception e) {
+							LogUtils.e(TAG, String.format("双重刷新 第二重异常：%s", e.getMessage()));
+						}
+					}
+				}
+			}, 200);
+    }
+
+    // ====================== 业务逻辑方法（按功能分类）======================
+    /**
+     * 初始化核心组件（工具类+视图）
+     */
+    private void initCoreComponents() {
+        LogUtils.d(TAG, "initCoreComponents() 开始初始化");
+        // 初始化视图
+        mBackgroundView = findViewById(R.id.background_view);
+        if (mBackgroundView == null) {
+            LogUtils.e(TAG, "initCoreComponents() | BackgroundView未找到");
+        }
+        // 初始化工具类
+        mBgSourceUtils = BackgroundSourceUtils.getInstance(this);
+        mBgSourceUtils.loadSettings();
+        mBitmapCache = BitmapCacheUtils.getInstance();
+        LogUtils.d(TAG, "initCoreComponents() 视图与工具类加载完成");
+    }
+
+    /**
+     * 处理意图或初始化预览
+     */
+    private void handleIntentOrPreview() {
+        LogUtils.d(TAG, "handleIntentOrPreview() 开始处理");
+        if (handleShareIntent()) {
+            ToastUtils.show("已接收分享图片");
+            LogUtils.d(TAG, "handleIntentOrPreview() | 处理分享意图成功");
+        } else {
+            mBgSourceUtils.setCurrentSourceToPreview();
+            LogUtils.d(TAG, "handleIntentOrPreview() | 加载当前背景配置");
+        }
+    }
+
+    /**
+     * 初始化预览环境
+     */
+    private void initPreviewEnvironment() {
+        LogUtils.d(TAG, "initPreviewEnvironment() 开始初始化");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        mBgSourceUtils.createAndUpdatePreviewEnvironmentForCropping(previewBean);
+        doubleRefreshPreview();
+        LogUtils.d(TAG, "initPreviewEnvironment() 初始化完成");
+    }
+
+    /**
+     * 处理分享意图
+     * @return 处理成功返回true，否则false
+     */
+    private boolean handleShareIntent() {
+        LogUtils.d(TAG, "handleShareIntent() 开始处理");
+        Intent intent = getIntent();
+        if (intent != null) {
+            String action = intent.getAction();
+            String type = intent.getType();
+            LogUtils.d(TAG, String.format("分享处理 | action：%s，type：%s", action, type));
+            if (Intent.ACTION_SEND.equals(action) && type != null && isImageType(type)) {
+                showSharePreviewDialog();
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * 显示分享图片预览对话框
+     */
+    private void showSharePreviewDialog() {
+        LogUtils.d(TAG, "showSharePreviewDialog() 开始显示");
+        BackgroundPicturePreviewDialog dlg = new BackgroundPicturePreviewDialog(this, new BackgroundPicturePreviewDialog.IOnRecivedPictureListener() {
+				@Override
+				public void onAcceptRecivedPicture(Uri uriRecivedPicture) {
+					LogUtils.d(TAG, String.format("分享确认 | Uri：%s", uriRecivedPicture.toString()));
+					if (putUriFileToPreviewSource(uriRecivedPicture)) {
+						startImageCrop(false);
+					}
+				}
+			});
+        dlg.show();
+        LogUtils.d(TAG, "分享处理 | 显示图片预览对话框");
+    }
+
+    /**
+     * 判断是否为图片类型
+     * @param mimeType MIME类型
+     * @return 是图片返回true，否则false
+     */
+    private boolean isImageType(String mimeType) {
+        if (mimeType == null) {
+            return false;
+        }
+        String lowerMimeType = mimeType.toLowerCase();
+        LogUtils.d(TAG, String.format("isImageType() | mimeType: %s, lowerMimeType: %s", mimeType, lowerMimeType));
+        return lowerMimeType.startsWith("image/");
+    }
+
+    /**
+     * 启动图片选择器
+     */
+    private void launchImageSelector() {
+        LogUtils.d(TAG, "launchImageSelector() 启动图片选择器");
+        Intent[] intents = createImageSelectorIntents();
+        Intent validIntent = findValidIntent(intents);
+
+        if (validIntent != null) {
+            launchImageChooser(validIntent);
+        } else {
+            showNoGalleryDialog();
+        }
+    }
+
+    /**
+     * 创建图片选择器意图数组
+     * @return 意图数组
+     */
+    private Intent[] createImageSelectorIntents() {
+        LogUtils.d(TAG, "createImageSelectorIntents() 开始创建");
+        Intent[] intents = new Intent[3];
+        // ACTION_GET_CONTENT
+        Intent getContentIntent = new Intent(Intent.ACTION_GET_CONTENT);
+        getContentIntent.setType("image/*");
+        getContentIntent.addCategory(Intent.CATEGORY_OPENABLE);
+        getContentIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+        intents[0] = getContentIntent;
+
+        // ACTION_PICK
+        Intent pickIntent = new Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
+        pickIntent.setType("image/*");
+        pickIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
+        intents[1] = pickIntent;
+
+        // ACTION_OPEN_DOCUMENT（API19+）
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            Intent openDocIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
+            openDocIntent.setType("image/*");
+            openDocIntent.addCategory(Intent.CATEGORY_OPENABLE);
+            openDocIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
+            intents[2] = openDocIntent;
+        }
+        LogUtils.d(TAG, "createImageSelectorIntents() 意图数组创建完成");
+        return intents;
+    }
+
+    /**
+     * 查找有效的意图
+     * @param intents 意图数组
+     * @return 有效意图，无则返回null
+     */
+    private Intent findValidIntent(Intent[] intents) {
+        LogUtils.d(TAG, "findValidIntent() 开始查找");
+        for (Intent intent : intents) {
+            if (intent != null && intent.resolveActivity(getPackageManager()) != null) {
+                LogUtils.d(TAG, "findValidIntent() | 找到有效意图");
+                return intent;
+            }
+        }
+        LogUtils.d(TAG, "findValidIntent() | 无有效意图");
+        return null;
+    }
+
+    /**
+     * 启动图片选择器
+     * @param validIntent 有效意图
+     */
+    private void launchImageChooser(Intent validIntent) {
+        LogUtils.d(TAG, "launchImageChooser() 启动选择器");
+        Intent chooser = Intent.createChooser(validIntent, "选择图片");
+        chooser.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
+        startActivityForResult(chooser, REQUEST_SELECT_PICTURE);
+        LogUtils.d(TAG, "launchImageChooser() | 启动图片选择");
+    }
+
+    /**
+     * 显示无相册应用提示对话框
+     */
+    private void showNoGalleryDialog() {
+        LogUtils.d(TAG, "showNoGalleryDialog() | 无相册应用");
+        runOnUiThread(new Runnable() {
+				@Override
+				public void run() {
+					ToastUtils.show("未找到相册应用，请安装后重试");
+					new AlertDialog.Builder(BackgroundSettingsActivity.this)
+                        .setTitle("无图片选择应用")
+                        .setMessage("需要安装相册应用才能选择图片")
+                        .setPositiveButton("确定", new DialogInterface.OnClickListener() {
+                            @Override
+                            public void onClick(DialogInterface dialog, int which) {
+                                launchGalleryMarket();
+                            }
+                        })
+                        .setNegativeButton("取消", null)
+                        .show();
+				}
+			});
+    }
+
+    /**
+     * 启动应用商店下载相册
+     */
+    private void launchGalleryMarket() {
+        LogUtils.d(TAG, "launchGalleryMarket() 启动应用商店");
+        Intent marketIntent = new Intent(Intent.ACTION_VIEW);
+        marketIntent.setData(Uri.parse("market://details?id=com.android.gallery3d"));
+        if (marketIntent.resolveActivity(getPackageManager()) != null) {
+            startActivity(marketIntent);
+            LogUtils.d(TAG, "launchGalleryMarket() | 启动成功");
+        } else {
+            ToastUtils.show("无法打开应用商店");
+            LogUtils.e(TAG, "launchGalleryMarket() | 启动失败");
+        }
+    }
+
+    /**
+     * 处理操作取消或失败
+     */
+    private void handleOperationCancelOrFail() {
+        LogUtils.d(TAG, "handleOperationCancelOrFail() 操作取消或失败");
+        mBgSourceUtils.setCurrentSourceToPreview();
+        ToastUtils.show("操作取消或失败");
+        doubleRefreshPreview();
+    }
+
+    /**
+     * 处理拍照逻辑（权限通过后执行）
+     */
+    void handleTakePhoto() {
+        LogUtils.d(TAG, "handleTakePhoto() 开始处理拍照");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "handleTakePhoto() | 预览Bean为空");
+            ToastUtils.show("拍照文件创建失败");
+            return;
+        }
+
+        File takePhotoFile = new File(previewBean.getBackgroundFilePath());
+        if (!takePhotoFile.exists()) {
+            ToastUtils.show("拍照文件创建失败");
+            LogUtils.e(TAG, String.format("handleTakePhoto() | 文件不存在：%s", takePhotoFile.getAbsolutePath()));
+            return;
+        }
+
+        Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
+        try {
+            Uri photoUri = getFileProviderUri(takePhotoFile);
+            if (photoUri == null) {
+                throw new Exception("生成FileProvider Uri失败");
+            }
+            takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri);
+            startActivityForResult(takePictureIntent, REQUEST_TAKE_PHOTO);
+            LogUtils.d(TAG, String.format("handleTakePhoto() | Uri：%s", photoUri.toString()));
+        } catch (Exception e) {
+            String errMsg = "拍照启动异常：" + e.getMessage();
+            ToastUtils.show(errMsg.substring(0, 20));
+            LogUtils.e(TAG, String.format("handleTakePhoto() | %s", e.getMessage()));
+        }
+    }
+
+    /**
+     * 处理ActivityResult分发
+     * @param requestCode 请求码
+     * @param data 回调数据
+     */
+    private void handleActivityResult(int requestCode, Intent data) {
+        LogUtils.d(TAG, String.format("handleActivityResult() | 处理请求码：%d", requestCode));
+        switch (requestCode) {
+            case REQUEST_SELECT_PICTURE:
+                handleSelectPictureResult(data);
+                break;
+            case REQUEST_TAKE_PHOTO:
+                handleTakePhotoResult(data);
+                break;
+            case REQUEST_CROP_IMAGE:
+                handleCropImageResult(data);
+                break;
+            case REQUEST_PIXELPICKER:
+                handlePixelPickerResult();
+                break;
+            default:
+                LogUtils.d(TAG, String.format("handleActivityResult() | 未知requestCode：%d", requestCode));
+                break;
+        }
+    }
+
+    /**
+     * 处理拍照结果
+     * @param data 回调数据
+     */
+    private void handleTakePhotoResult(Intent data) {
+        LogUtils.d(TAG, "handleTakePhotoResult() 处理拍照结果");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "handleTakePhotoResult() | 预览Bean为空");
+            return;
+        }
+
+        previewBean.setIsUseBackgroundFile(true);
+        previewBean.setIsUseBackgroundScaledCompressFile(false);
+        mBgSourceUtils.saveSettings();
+        doubleRefreshPreview();
+
+        startImageCrop(false);
+        LogUtils.d(TAG, "handleTakePhotoResult() | 已启动裁剪");
+    }
+
+    /**
+     * 处理选图结果
+     * @param data 回调数据
+     */
+    private void handleSelectPictureResult(Intent data) {
+        LogUtils.d(TAG, "handleSelectPictureResult() 处理选图结果");
+        Uri selectedImage = data.getData();
+        if (selectedImage == null) {
+            ToastUtils.show("图片Uri为空");
+            LogUtils.e(TAG, "handleSelectPictureResult() | Uri为空");
+            return;
+        }
+        LogUtils.d(TAG, String.format("handleSelectPictureResult() | 系统返回Uri : %s", selectedImage.toString()));
+
+        // 申请持久化权限（API33+）
+        if (Build.VERSION.SDK_INT >= SDK_VERSION_TIRAMISU) {
+            getContentResolver().takePersistableUriPermission(
+				selectedImage,
+				Intent.FLAG_GRANT_READ_URI_PERMISSION);
+            LogUtils.d(TAG, "handleSelectPictureResult() | 已添加持久化权限");
+        }
+
+        // 同步文件并启动裁剪
+        if (putUriFileToPreviewSource(selectedImage)) {
+            LogUtils.d(TAG, "handleSelectPictureResult() | 路径绑定完成");
+            startImageCrop(false);
+        } else {
+            ToastUtils.show("图片同步失败");
+            LogUtils.e(TAG, "handleSelectPictureResult() | 文件复制失败");
+        }
+    }
+
+    /**
+     * 将 Uri 文件同步到预览 Bean
+     * @param srcUriFile 源Uri
+     * @return 同步成功返回true，否则false
+     */
+    private boolean putUriFileToPreviewSource(Uri srcUriFile) {
+        LogUtils.d(TAG, String.format("putUriFileToPreviewSource() | 源Uri：%s", srcUriFile.toString()));
+        String filePath = UriUtils.getFilePathFromUri(this, srcUriFile);
+        if (TextUtils.isEmpty(filePath)) {
+            LogUtils.e(TAG, "putUriFileToPreviewSource() | Uri解析路径为空");
+            return false;
+        }
+        File srcFile = new File(filePath);
+        return putUriFileToPreviewSource(srcFile);
+    }
+
+    /**
+     * 将 File 同步到预览 Bean
+     * @param srcFile 源文件
+     * @return 同步成功返回true，否则false
+     */
+    private boolean putUriFileToPreviewSource(File srcFile) {
+        LogUtils.d(TAG, String.format("putUriFileToPreviewSource() | 源文件：%s", srcFile.getAbsolutePath()));
+        mBgSourceUtils.loadSettings();
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        File dstFile = new File(previewBean.getBackgroundFilePath());
+        LogUtils.d(TAG, String.format("putUriFileToPreviewSource() | 目标文件：%s", dstFile.getAbsolutePath()));
+        if (FileUtils.copyFile(srcFile, dstFile)) {
+            LogUtils.d(TAG, "putUriFileToPreviewSource() | 文件拷贝成功");
+            return true;
+        }
+        LogUtils.d(TAG, "putUriFileToPreviewSource() | 文件无法拷贝");
+        return false;
+    }
+
+    /**
+     * 处理裁剪结果
+     * @param data 回调数据
+     */
+    private void handleCropImageResult(Intent data) {
+        LogUtils.d(TAG, "handleCropImageResult() 处理裁剪结果");
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "handleCropImageResult() | 预览Bean为空");
+            handleOperationCancelOrFail();
+            return;
+        }
+
+        File cropTempFile = new File(previewBean.getBackgroundScaledCompressFilePath());
+        boolean isFileExist = cropTempFile.exists();
+        boolean isFileReadable = isFileExist ? cropTempFile.canRead() : false;
+        long fileSize = isFileExist ? cropTempFile.length() : 0;
+        boolean isCropSuccess = isFileExist && isFileReadable && fileSize > 100;
+
+        if (isCropSuccess) {
+            handleCropSuccess(previewBean, fileSize);
+        } else {
+            handleCropFailure(isFileExist, isFileReadable, fileSize);
+        }
+    }
+
+    /**
+     * 处理裁剪成功
+     * @param previewBean 预览Bean
+     * @param fileSize 文件大小
+     */
+    private void handleCropSuccess(BackgroundBean previewBean, long fileSize) {
+        LogUtils.d(TAG, String.format("handleCropSuccess() | 裁剪成功，文件大小：%d", fileSize));
+        isPreviewBackgroundChanged = true;
+        previewBean.setIsUseBackgroundFile(true);
+        previewBean.setIsUseBackgroundScaledCompressFile(true);
+        mBgSourceUtils.saveSettings();
+        doubleRefreshPreview();
+    }
+
+    /**
+     * 处理裁剪失败
+     * @param isFileExist 文件是否存在
+     * @param isFileReadable 文件是否可读
+     * @param fileSize 文件大小
+     */
+    private void handleCropFailure(boolean isFileExist, boolean isFileReadable, long fileSize) {
+        LogUtils.e(TAG, String.format("handleCropFailure() | 裁剪失败，文件状态：存在=%b，可读=%b，大小=%d",
+									  isFileExist, isFileReadable, fileSize));
+        handleOperationCancelOrFail();
+    }
+
+    /**
+     * 处理像素拾取结果
+     */
+    private void handlePixelPickerResult() {
+        LogUtils.d(TAG, "handlePixelPickerResult() 处理像素拾取结果");
+        doubleRefreshPreview();
+        isPreviewBackgroundChanged = true;
+    }
+
+    /**
+     * 处理相机权限申请结果
+     * @param grantResults 权限结果数组
+     */
+    private void handleCameraPermissionResult(int[] grantResults) {
+        LogUtils.d(TAG, "handleCameraPermissionResult() 处理相机权限结果");
+        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+            LogUtils.d(TAG, "handleCameraPermissionResult() | 相机权限授予成功");
+            handleTakePhoto();
+        } else {
+            LogUtils.d(TAG, "handleCameraPermissionResult() | 相机权限授予失败");
+            ToastUtils.show("相机权限被拒绝，无法拍照");
+            // 引导用户到设置页面开启权限（用户选择不再询问时）
+            if (!ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CAMERA)) {
+                launchAppSettings();
+            }
+        }
+    }
+
+    /**
+     * 启动应用设置页面
+     */
+    private void launchAppSettings() {
+        LogUtils.d(TAG, "launchAppSettings() 启动应用设置页面");
+        Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+        Uri uri = Uri.fromParts("package", getPackageName(), null);
+        intent.setData(uri);
+        startActivity(intent);
+        ToastUtils.show("请在设置中开启相机权限");
+    }
+
+    /**
+     * 处理Finish确认对话框
+     */
+    private void handleFinishConfirmation() {
+        LogUtils.d(TAG, "handleFinishConfirmation() 处理Finish确认");
+        if (isPreviewBackgroundChanged) {
+            YesNoAlertDialog.show(this, "背景更换问题", "是否确定背景图片设置？", new YesNoAlertDialog.OnDialogResultListener() {
+					@Override
+					public void onYes() {
+						mBgSourceUtils.commitPreviewSourceToCurrent();
+						isCommitSettings = true;
+						finish();
+						Intent mainIntent = new Intent(BackgroundSettingsActivity.this, MainActivity.class);
+						mainIntent.putExtra(MainActivity.EXTRA_ISRELOAD_BACKGROUNDVIEW, true);
+						startActivity(mainIntent);
+						LogUtils.d(TAG, "handleFinishConfirmation() | 确认设置，启动MainActivity并刷新背景");
+					}
+
+					@Override
+					public void onNo() {
+						isCommitSettings = true;
+						finish();
+						LogUtils.d(TAG, "handleFinishConfirmation() | 取消设置，关闭页面");
+					}
+				});
+        } else {
+            isCommitSettings = true;
+            finish();
+        }
+    }
+
+    /**
+     * 启动图片裁剪
+     * @param isFreeCrop 是否自由裁剪
+     */
+    private void startImageCrop(boolean isFreeCrop) {
+        LogUtils.d(TAG, String.format("startImageCrop() | 是否自由裁剪：%b", isFreeCrop));
+        BackgroundBean previewBean = mBgSourceUtils.getPreviewBackgroundBean();
+        if (previewBean == null) {
+            LogUtils.e(TAG, "startImageCrop() | 预览Bean为空");
+            ToastUtils.show("裁剪失败：无有效图片");
+            return;
+        }
+        int width = isFreeCrop ? 0 : mBackgroundView.getWidth();
+        int height = isFreeCrop ? 0 : mBackgroundView.getHeight();
+        ImageCropUtils.startImageCrop(BackgroundSettingsActivity.this,
+									  previewBean,
+									  width,
+									  height,
+									  isFreeCrop,
+									  REQUEST_CROP_IMAGE);
+        LogUtils.d(TAG, String.format("startImageCrop() | 目标尺寸：%dx%d", width, height));
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BatteryReportActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BatteryReportActivity.java
new file mode 100644
index 0000000..dd38fe0
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/BatteryReportActivity.java
@@ -0,0 +1,598 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageManager;
+import android.os.Build;
+import android.os.Bundle;
+import android.provider.Settings;
+import android.text.Editable;
+import android.text.TextWatcher;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.EditText;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.widget.Toolbar;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 电池报告页面，统计应用24小时运行时长与电池消耗情况
+ * 支持应用搜索、累计耗电计算、电池广播监听，适配 API30
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class BatteryReportActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量（按功能分类） =========================
+    public static final String TAG = "BatteryReportActivity";
+    private static final long ONE_DAY_MS = 24 * 3600 * 1000;   // 24小时毫秒数
+    private static final long ONE_MINUTE_MS = 60 * 1000;       // 1分钟毫秒数
+
+    // ======================== 成员变量（按依赖优先级+功能分类） =========================
+    // UI组件
+    private Toolbar mToolbar;
+    private RecyclerView rvBatteryReport;
+    private EditText etSearch;
+
+    // 数据与适配器
+    private BatteryReportAdapter adapter;
+    private List<AppBatteryModel> dataList = new ArrayList<>();
+    private List<AppBatteryModel> filteredList = new ArrayList<>();
+
+    // 电池相关
+    private BroadcastReceiver batteryReceiver;
+    private int batteryCapacity = 5400;                        // 电池容量（mAh）
+    private float lastBatteryPercent = 100.0f;                 // 上次电池百分比
+    private long lastCheckTime = System.currentTimeMillis();   // 上次检查时间戳
+
+    // 缓存相关
+    private Map<String, Long> appRunTimeCache = new HashMap<>();
+    private Map<String, String> packageToAppNameCache = new HashMap<>();
+    private PackageManager mPackageManager;
+
+    // ======================== 接口实现方法 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期方法（按执行顺序排列） =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_battery_report);
+        LogUtils.d(TAG, "【onCreate】BatteryReportActivity 初始化开始");
+
+        // 初始化UI组件
+        initView();
+        // 初始化PackageManager
+        mPackageManager = getPackageManager();
+        LogUtils.d(TAG, "【onCreate】基础组件初始化完成");
+
+        // 权限检查（Java7 传统条件判断）
+        if (!hasUsageStatsPermission(this)) {
+            Toast.makeText(this, "请进入设置-应用-权限-特殊访问权限-使用情况访问权限，开启本应用的权限", Toast.LENGTH_LONG).show();
+            startActivity(new Intent(Settings.ACTION_USAGE_ACCESS_SETTINGS));
+            LogUtils.w(TAG, "【onCreate】缺少使用情况访问权限，引导用户开启");
+            return;
+        }
+
+        // 初始化数据流程：加载应用→缓存名称→获取运行时长→计算初始累计耗电
+        loadAllAppPackage();
+        preCacheAllAppNames();
+        appRunTimeCache = getAppRunTime();
+        updateAppRunTimeToModel();
+        calculateInitial24hTotalConsumption();
+        filteredList.addAll(dataList);
+        LogUtils.d(TAG, "【onCreate】数据初始化完成，原始数据量：" + dataList.size());
+
+        // 初始化适配器
+        adapter = new BatteryReportAdapter(this, filteredList, mPackageManager, packageToAppNameCache);
+        rvBatteryReport.setAdapter(adapter);
+        LogUtils.d(TAG, "【onCreate】适配器初始化完成，过滤后数据量：" + filteredList.size());
+
+        // 绑定搜索监听 + 注册电池广播
+        bindSearchListener();
+        registerBatteryReceiver();
+
+        LogUtils.d(TAG, "【onCreate】BatteryReportActivity 初始化完成");
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // Java7 显式非空判断
+        if (batteryReceiver != null) {
+            unregisterReceiver(batteryReceiver);
+            LogUtils.d(TAG, "【onDestroy】电池广播已注销");
+        }
+        LogUtils.d(TAG, "【onDestroy】BatteryReportActivity 销毁完成");
+    }
+
+    // ======================== UI初始化方法 =========================
+    private void initView() {
+        // 初始化Toolbar
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【导航栏】点击返回");
+					finish();
+				}
+			});
+
+        // 初始化RecyclerView与搜索框
+        etSearch = (EditText) findViewById(R.id.et_search);
+        rvBatteryReport = (RecyclerView) findViewById(R.id.rv_battery_report);
+        rvBatteryReport.setLayoutManager(new LinearLayoutManager(this));
+        LogUtils.d(TAG, "【initView】UI组件初始化完成");
+    }
+
+    // ======================== 搜索监听绑定方法 =========================
+    private void bindSearchListener() {
+        etSearch.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {
+					String keyword = s.toString().trim();
+					LogUtils.d(TAG, "【bindSearchListener】搜索关键词变化：" + keyword);
+					filterAppsByPackageAndName(keyword);
+				}
+
+				@Override
+				public void afterTextChanged(Editable s) {}
+			});
+        LogUtils.d(TAG, "【bindSearchListener】搜索监听绑定完成");
+    }
+
+    // ======================== 电池广播注册方法 =========================
+    private void registerBatteryReceiver() {
+        batteryReceiver = new BroadcastReceiver() {
+            @Override
+            public void onReceive(Context context, Intent intent) {
+                int level = intent.getIntExtra("level", 100);
+                int scale = intent.getIntExtra("scale", 100);
+                float currentPercent = (float) level / scale * 100;
+                LogUtils.d(TAG, "【电池广播】电池百分比变化：" + lastBatteryPercent + " -> " + currentPercent);
+
+                if (currentPercent < lastBatteryPercent) {
+                    float dropPercent = lastBatteryPercent - currentPercent;
+                    long duration = System.currentTimeMillis() - lastCheckTime;
+                    LogUtils.d(TAG, "【电池广播】电池消耗：" + dropPercent + "%，时长：" + formatRunTime(duration));
+
+                    // 更新运行时长并计算耗电
+                    appRunTimeCache = getAppRunTime();
+                    updateAppRunTimeToModel();
+                    calculateSingleConsumptionAndAccumulate(dropPercent, appRunTimeCache);
+                }
+
+                // 刷新记录
+                lastBatteryPercent = currentPercent;
+                lastCheckTime = System.currentTimeMillis();
+            }
+        };
+        registerReceiver(batteryReceiver, new IntentFilter(Intent.ACTION_BATTERY_CHANGED));
+        LogUtils.d(TAG, "【registerBatteryReceiver】电池广播注册完成");
+    }
+
+    // ======================== 权限检查方法 =========================
+    /**
+     * 检查是否拥有使用情况访问权限
+     * @param context 上下文
+     * @return 拥有权限返回true，否则返回false
+     */
+    private boolean hasUsageStatsPermission(Context context) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
+            LogUtils.w(TAG, "【hasUsageStatsPermission】系统版本低于LOLLIPOP，不支持使用情况访问权限");
+            return false;
+        }
+
+        android.app.usage.UsageStatsManager manager =
+			(android.app.usage.UsageStatsManager) context.getSystemService(Context.USAGE_STATS_SERVICE);
+        if (manager == null) {
+            LogUtils.e(TAG, "【hasUsageStatsPermission】获取UsageStatsManager失败");
+            return false;
+        }
+
+        long endTime = System.currentTimeMillis();
+        long startTime = endTime - ONE_MINUTE_MS;
+        List<android.app.usage.UsageStats> statsList = manager.queryUsageStats(
+			android.app.usage.UsageStatsManager.INTERVAL_DAILY, startTime, endTime);
+
+        boolean hasPermission = statsList != null && !statsList.isEmpty();
+        LogUtils.d(TAG, "【hasUsageStatsPermission】使用情况访问权限检查结果：" + hasPermission);
+        return hasPermission;
+    }
+
+    // ======================== 数据加载与缓存方法 =========================
+    /**
+     * 加载所有应用包名，初始化数据模型
+     */
+    private void loadAllAppPackage() {
+        List<ApplicationInfo> appList = mPackageManager.getInstalledApplications(PackageManager.GET_META_DATA);
+        dataList.clear();
+        LogUtils.d(TAG, "【loadAllAppPackage】开始加载应用包名列表，共找到" + appList.size() + "个应用");
+
+        for (ApplicationInfo appInfo : appList) {
+            String packageName = appInfo.packageName;
+            dataList.add(new AppBatteryModel(packageName, 0.0f, 0.0f, 0));
+        }
+        LogUtils.d(TAG, "【loadAllAppPackage】应用包名列表加载完成，共添加" + dataList.size() + "个包名");
+    }
+
+    /**
+     * 预缓存所有应用名称，减少PackageManager重复调用
+     */
+    private void preCacheAllAppNames() {
+        packageToAppNameCache.clear();
+        LogUtils.d(TAG, "【preCacheAllAppNames】开始预缓存包名-应用名称映射");
+
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            String appName = getAppNameByPackage(packageName);
+            packageToAppNameCache.put(packageName, appName);
+        }
+        LogUtils.d(TAG, "【preCacheAllAppNames】预缓存完成，共缓存" + packageToAppNameCache.size() + "个应用名称");
+    }
+
+    /**
+     * 通过包名获取应用名称，带异常处理
+     * @param packageName 应用包名
+     * @return 应用名称，获取失败返回包名
+     */
+    private String getAppNameByPackage(String packageName) {
+        LogUtils.v(TAG, "【getAppNameByPackage】查询包名：" + packageName);
+        try {
+            ApplicationInfo appInfo = mPackageManager.getApplicationInfo(packageName, 0);
+            return mPackageManager.getApplicationLabel(appInfo).toString();
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "【getAppNameByPackage】包名" + packageName + "对应的应用未找到：" + e.getMessage());
+            return packageName;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【getAppNameByPackage】查询应用名称失败（包名：" + packageName + "）：" + e.getMessage());
+            return packageName;
+        }
+    }
+
+    /**
+     * 更新运行时长到数据模型
+     */
+    private void updateAppRunTimeToModel() {
+        int updateCount = 0;
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long runTime = appRunTimeCache.containsKey(packageName) ? appRunTimeCache.get(packageName) : 0L;
+            model.setRunTime(runTime);
+            if (runTime > 0) {
+                updateCount++;
+            }
+        }
+        LogUtils.d(TAG, "【updateAppRunTimeToModel】更新完成，数据量：" + dataList.size() + "，更新运行时长应用数：" + updateCount);
+    }
+
+    /**
+     * 获取应用24小时运行时长
+     * @return 应用包名-运行时长（ms）映射
+     */
+    private Map<String, Long> getAppRunTime() {
+        Map<String, Long> runTimeMap = new HashMap<>();
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            try {
+                android.app.usage.UsageStatsManager manager =
+					(android.app.usage.UsageStatsManager) getSystemService(Context.USAGE_STATS_SERVICE);
+                long endTime = System.currentTimeMillis();
+                long startTime = endTime - ONE_DAY_MS; // 近24小时
+                List<android.app.usage.UsageStats> statsList = manager.queryUsageStats(
+					android.app.usage.UsageStatsManager.INTERVAL_DAILY, startTime, endTime);
+
+                for (android.app.usage.UsageStats stats : statsList) {
+                    long runTimeMs = stats.getTotalTimeInForeground();
+                    String packageName = stats.getPackageName();
+                    runTimeMap.put(packageName, runTimeMs);
+                    LogUtils.v(TAG, "【getAppRunTime】包名" + packageName + "24小时运行时长：" + formatRunTime(runTimeMs));
+                    if (packageName.equals("aidepro.top")) {
+                        LogUtils.d(TAG, "【getAppRunTime】特殊查询包名" + packageName + "有结果");
+                    }
+                }
+            } catch (Exception e) {
+                LogUtils.e(TAG, "【getAppRunTime】获取应用运行时长失败：" + e.getMessage());
+            }
+        }
+        LogUtils.d(TAG, "【getAppRunTime】应用运行时长列表数量：" + runTimeMap.size());
+        return runTimeMap;
+    }
+
+    // ======================== 核心计算方法 =========================
+    /**
+     * 初始化时计算24小时累计耗电（赋值给totalConsumption）
+     * 逻辑：基于24小时运行时长占比，分配当前电池容量的理论24小时消耗
+     */
+    private void calculateInitial24hTotalConsumption() {
+        long total24hRunTime = 0;
+        // 1. 计算24小时内所有应用总运行时长
+        for (Map.Entry<String, Long> entry : appRunTimeCache.entrySet()) {
+            total24hRunTime += entry.getValue();
+        }
+        LogUtils.d(TAG, "【calculateInitial24hTotalConsumption】24小时内所有应用总运行时长：" + formatRunTime(total24hRunTime));
+
+        // 2. 按运行时长占比分配24小时累计耗电
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long app24hRunTime = appRunTimeCache.getOrDefault(packageName, 0L);
+
+            float ratio = (total24hRunTime > 0) ? (float) app24hRunTime / total24hRunTime : 0;
+            float initialTotalConsumption = batteryCapacity * ratio;
+            model.setTotalConsumption(initialTotalConsumption);
+            LogUtils.v(TAG, "【calculateInitial24hTotalConsumption】应用包" + packageName + "24小时累计耗电初始化：" + initialTotalConsumption + " mAh");
+        }
+        LogUtils.d(TAG, "【calculateInitial24hTotalConsumption】24小时累计耗电初始化完成");
+    }
+
+    /**
+     * 计算单次耗电（赋值给consumption）+ 累加至累计耗电
+     * @param dropPercent 电池下降百分比
+     * @param runTimeMap  应用运行时长映射
+     */
+    private void calculateSingleConsumptionAndAccumulate(float dropPercent, Map<String, Long> runTimeMap) {
+        LogUtils.d(TAG, "【calculateSingleConsumptionAndAccumulate】开始计算，电池下降百分比：" + dropPercent);
+        long totalSingleRunTime = 0;
+        // 1. 计算本次电池下降期间的总运行时长
+        for (Map.Entry<String, Long> entry : runTimeMap.entrySet()) {
+            totalSingleRunTime += entry.getValue();
+        }
+        LogUtils.d(TAG, "【calculateSingleConsumptionAndAccumulate】本次电池下降总运行时长：" + formatRunTime(totalSingleRunTime));
+
+        // 2. 遍历计算每个应用的单次耗电并累加
+        for (AppBatteryModel model : dataList) {
+            String packageName = model.getPackageName();
+            Long appSingleRunTime = runTimeMap.getOrDefault(packageName, 0L);
+
+            float ratio = (totalSingleRunTime > 0) ? (float) appSingleRunTime / totalSingleRunTime : 0;
+            float singleConsumption = batteryCapacity * dropPercent / 100 * ratio;
+            model.setConsumption(singleConsumption);
+
+            // 累加至累计耗电
+            float newTotalConsumption = model.getTotalConsumption() + singleConsumption;
+            model.setTotalConsumption(newTotalConsumption);
+            model.setRunTime(appSingleRunTime);
+
+            LogUtils.v(TAG, String.format("【calculateSingleConsumptionAndAccumulate】应用包%s：单次耗电%.1f mAh，累计耗电%.1f mAh",
+										  packageName, singleConsumption, newTotalConsumption));
+        }
+
+        // 3. 按累计耗电降序排序
+        Collections.sort(dataList, new Comparator<AppBatteryModel>() {
+				@Override
+				public int compare(AppBatteryModel m1, AppBatteryModel m2) {
+					return Float.compare(m2.getTotalConsumption(), m1.getTotalConsumption());
+				}
+			});
+
+        // 4. 重新过滤并刷新列表
+        filterAppsByPackageAndName(etSearch.getText().toString().trim());
+        LogUtils.d(TAG, "【calculateSingleConsumptionAndAccumulate】单次耗电计算与累加完成，列表已刷新");
+    }
+
+    /**
+     * 双维度过滤（包名+应用名）
+     * @param keyword 搜索关键词
+     */
+    private void filterAppsByPackageAndName(String keyword) {
+        filteredList.clear();
+        if (keyword == null || keyword.isEmpty()) {
+            filteredList.addAll(dataList);
+            LogUtils.d(TAG, "【filterAppsByPackageAndName】搜索关键词为空，显示全部应用，数量：" + filteredList.size());
+        } else {
+            String lowerKeyword = keyword.toLowerCase();
+            for (AppBatteryModel model : dataList) {
+                String packageName = model.getPackageName();
+                String packageNameLower = packageName.toLowerCase();
+                String appName = packageToAppNameCache.get(packageName);
+                String appNameLower = appName.toLowerCase();
+
+                boolean isMatched = packageNameLower.contains(lowerKeyword) || appNameLower.contains(lowerKeyword);
+                if (isMatched) {
+                    filteredList.add(model);
+                }
+            }
+            LogUtils.d(TAG, "【filterAppsByPackageAndName】搜索关键词：" + keyword + "，匹配应用数量：" + filteredList.size());
+        }
+        adapter.notifyDataSetChanged();
+    }
+
+    // ======================== 工具方法 =========================
+    /**
+     * 格式化运行时长
+     * @param runTimeMs 运行时长（ms）
+     * @return 格式化后的运行时长字符串
+     */
+    private String formatRunTime(long runTimeMs) {
+        if (runTimeMs <= 0) {
+            return "0秒";
+        }
+        long seconds = runTimeMs / 1000;
+        long hours = seconds / 3600;
+        long minutes = (seconds % 3600) / 60;
+        seconds = seconds % 60;
+
+        if (hours > 0) {
+            return String.format("%d时%d分%d秒", hours, minutes, seconds);
+        } else if (minutes > 0) {
+            return String.format("%d分%d秒", minutes, seconds);
+        } else {
+            return String.format("%d秒", seconds);
+        }
+    }
+
+    // ======================== 内部类：数据模型 =========================
+    /**
+     * 应用电池数据模型
+     * - consumption：单次耗电（两次电池广播间的消耗）
+     * - totalConsumption：累计耗电（24小时初始化值+后续单次累加）
+     * - runTime：运行时长（ms）
+     */
+    public static class AppBatteryModel {
+        private String packageName;    // 应用包名（核心标识）
+        private float consumption;     // 单次耗电（mAh）
+        private float totalConsumption;// 累计耗电（mAh）
+        private long runTime;          // 运行时长（ms）
+
+        // Java7 显式构造
+        public AppBatteryModel(String packageName, float consumption, float totalConsumption, long runTime) {
+            this.packageName = packageName;
+            this.consumption = consumption;
+            this.totalConsumption = totalConsumption;
+            this.runTime = runTime;
+        }
+
+        // Getter/Setter
+        public String getPackageName() {
+            return packageName;
+        }
+
+        public float getConsumption() {
+            return consumption;
+        }
+
+        public void setConsumption(float consumption) {
+            this.consumption = consumption;
+        }
+
+        public float getTotalConsumption() {
+            return totalConsumption;
+        }
+
+        public void setTotalConsumption(float totalConsumption) {
+            this.totalConsumption = totalConsumption;
+        }
+
+        public long getRunTime() {
+            return runTime;
+        }
+
+        public void setRunTime(long runTime) {
+            this.runTime = runTime;
+        }
+    }
+
+    // ======================== 内部类：RecyclerView适配器 =========================
+    /**
+     * 电池报告列表适配器，显示应用名称、累计耗电、运行时长
+     */
+    public static class BatteryReportAdapter extends RecyclerView.Adapter<BatteryReportAdapter.ViewHolder> {
+        private Context mContext;
+        private List<AppBatteryModel> mDataList;
+        private PackageManager mPm;
+        private Map<String, String> mPackageToNameCache;
+
+        // Java7 显式构造
+        public BatteryReportAdapter(Context context, List<AppBatteryModel> dataList,
+                                    PackageManager pm, Map<String, String> packageToNameCache) {
+            this.mContext = context;
+            this.mDataList = dataList;
+            this.mPm = pm;
+            this.mPackageToNameCache = packageToNameCache;
+            LogUtils.d(TAG, "【BatteryReportAdapter】适配器构造完成，数据量：" + dataList.size());
+        }
+
+        @Override
+        public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+            View itemView = LayoutInflater.from(mContext)
+				.inflate(android.R.layout.simple_list_item_2, parent, false);
+            return new ViewHolder(itemView);
+        }
+
+        @Override
+        public void onBindViewHolder(ViewHolder holder, int position) {
+            // Java7 显式非空判断
+            if (mDataList == null || mDataList.isEmpty() || position >= mDataList.size()) {
+                holder.tvAppName.setText("未知应用");
+                holder.tvConsumption.setText("累计耗电：0.0 mAh | 运行时长：0秒");
+                LogUtils.w(TAG, "【onBindViewHolder】数据异常，位置：" + position);
+                return;
+            }
+
+            AppBatteryModel model = mDataList.get(position);
+            String packageName = model.getPackageName();
+            String appName = "";
+
+            // 优先从缓存获取应用名
+            if (mPackageToNameCache != null && mPackageToNameCache.containsKey(packageName)) {
+                appName = mPackageToNameCache.get(packageName);
+            } else {
+                // 缓存无数据时兜底查询
+                try {
+                    ApplicationInfo appInfo = mPm.getApplicationInfo(packageName, 0);
+                    appName = mPm.getApplicationLabel(appInfo).toString();
+                    if (mPackageToNameCache != null) {
+                        mPackageToNameCache.put(packageName, appName);
+                    }
+                } catch (PackageManager.NameNotFoundException e) {
+                    appName = packageName;
+                    LogUtils.e("BatteryReportAdapter", "【onBindViewHolder】包名" + packageName + "对应的应用未找到：" + e.getMessage());
+                } catch (Exception e) {
+                    appName = packageName;
+                    LogUtils.e("BatteryReportAdapter", "【onBindViewHolder】查询应用名称失败（包名：" + packageName + "）：" + e.getMessage());
+                }
+            }
+
+            // 显示逻辑：应用名称 + 累计耗电 + 运行时长
+            holder.tvAppName.setText(appName);
+            String runTimeStr = ((BatteryReportActivity) mContext).formatRunTime(model.getRunTime());
+            String totalConsumptionText = String.format("累计耗电：%.1f mAh | 运行时长：%s",
+														model.getTotalConsumption(), runTimeStr);
+            holder.tvConsumption.setText(totalConsumptionText);
+
+            // 显示优化
+            holder.tvAppName.setTextColor(mContext.getResources().getColor(android.R.color.black));
+            holder.tvConsumption.setTextColor(mContext.getResources().getColor(android.R.color.darker_gray));
+            holder.tvAppName.setTextSize(16);
+            holder.tvConsumption.setTextSize(14);
+        }
+
+        @Override
+        public int getItemCount() {
+            return mDataList == null ? 0 : mDataList.size();
+        }
+
+        /**
+         * ViewHolder：绑定系统布局控件
+         */
+        public static class ViewHolder extends RecyclerView.ViewHolder {
+            TextView tvAppName;     // 应用名称
+            TextView tvConsumption; // 累计耗电 + 运行时长
+
+            public ViewHolder(View itemView) {
+                super(itemView);
+                tvAppName = (TextView) itemView.findViewById(android.R.id.text1);
+                tvConsumption = (TextView) itemView.findViewById(android.R.id.text2);
+            }
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ClearRecordActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ClearRecordActivity.java
new file mode 100644
index 0000000..a942d55
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ClearRecordActivity.java
@@ -0,0 +1,166 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.Switch;
+import android.widget.TextView;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.AOHPCTCSeekBar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BatteryInfoBean;
+import cc.winboll.studio.powerbell.receivers.ControlCenterServiceReceiver;
+import cc.winboll.studio.powerbell.utils.AppCacheUtils;
+import cc.winboll.studio.powerbell.utils.StringUtils;
+import java.util.ArrayList;
+
+/**
+ * 电池记录清理页面，支持滑动清理记录、切换记录显示格式
+ * 适配 API30，基于 Java7 开发
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class ClearRecordActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量（按功能分类） =========================
+    public static final String TAG = "ClearRecordActivity";
+    private static final String TOAST_MSG_CLEAR_SUCCESS = "The APP battery record is cleaned.";
+
+    // ======================== 成员变量（按依赖优先级+功能分类） =========================
+    // UI组件
+    private Toolbar mToolbar;
+    private TextView mtvRecordText;
+    private TextView tvAOHPCTCSeekBarMSG;
+    private AOHPCTCSeekBar aOHPCTCSeekBar;
+
+    // 应用与配置
+    private App mApplication;
+    private boolean mIsShowRecordWithEnter = false; // 记录是否带换行显示
+
+    // ======================== 接口实现方法 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期方法（按执行顺序排列） =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_clearrecord);
+        LogUtils.d(TAG, "【onCreate】ClearRecordActivity 初始化开始");
+
+        // 初始化应用实例
+        mApplication = (App) getApplication();
+        LogUtils.d(TAG, "【onCreate】应用实例初始化完成");
+
+        // 初始化核心逻辑
+        initView();
+        initSeekBar();
+        initRecordText();
+
+        LogUtils.d(TAG, "【onCreate】ClearRecordActivity 初始化完成");
+    }
+
+    // ======================== UI初始化方法 =========================
+    /**
+     * 初始化Toolbar与显示文本组件
+     */
+    private void initView() {
+        // 初始化Toolbar
+        mToolbar = (Toolbar) findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【导航栏】点击返回按钮，关闭当前页面");
+					finish();
+				}
+			});
+
+        // 初始化显示文本组件
+        tvAOHPCTCSeekBarMSG = (TextView) findViewById(R.id.activityclearrecordTextView1);
+        mtvRecordText = (TextView) findViewById(R.id.activityclearrecordTextView2);
+        tvAOHPCTCSeekBarMSG.setText(R.string.msg_AOHPCTCSeekBar_ClearRecord);
+
+        LogUtils.d(TAG, "【initView】UI组件初始化完成");
+    }
+
+    /**
+     * 初始化滑动清理控件，设置回调监听
+     */
+    private void initSeekBar() {
+        aOHPCTCSeekBar = (AOHPCTCSeekBar) findViewById(R.id.activityclearrecordAOHPCTCSeekBar1);
+        aOHPCTCSeekBar.setThumb(getDrawable(R.drawable.cursor_pointer));
+        aOHPCTCSeekBar.setThumbOffset(0);
+        aOHPCTCSeekBar.setOnOHPCListener(new AOHPCTCSeekBar.OnOHPCListener() {
+				@Override
+				public void onOHPCommit() {
+					LogUtils.d(TAG, "【onOHPCommit】滑动清理触发，开始执行记录清理逻辑");
+					// 清理电池历史记录
+					mApplication.clearBatteryHistory();
+					// 发送广播更新前台通知
+					sendBroadcast(new Intent(ControlCenterServiceReceiver.ACTION_UPDATE_FOREGROUND_NOTIFICATION));
+					// 刷新记录显示
+					initRecordText();
+					// 提示清理成功
+					ToastUtils.show(TOAST_MSG_CLEAR_SUCCESS);
+					LogUtils.d(TAG, "【onOHPCommit】电池记录清理完成，已发送前台通知更新广播");
+				}
+			});
+
+        LogUtils.d(TAG, "【initSeekBar】滑动清理控件初始化完成，回调监听已绑定");
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 初始化记录显示文本，根据配置切换带换行/不带换行格式
+     */
+    void initRecordText() {
+        ArrayList<BatteryInfoBean> listBatteryInfo = AppCacheUtils.getInstance(this).getArrayListBatteryInfo();
+        String szRecordText;
+
+        // 判空处理：避免空列表导致异常
+        if (listBatteryInfo == null || listBatteryInfo.isEmpty()) {
+            szRecordText = getString(R.string.msg_no_battery_record);
+            LogUtils.d(TAG, "【initRecordText】无电池记录数据，显示空记录提示文本");
+        } else {
+            // 根据配置切换显示格式
+            if (mIsShowRecordWithEnter) {
+                szRecordText = StringUtils.formatPCMListStringWithEnter(listBatteryInfo);
+                LogUtils.d(TAG, String.format("【initRecordText】使用带换行格式显示记录，记录数量：%d", listBatteryInfo.size()));
+            } else {
+                szRecordText = StringUtils.formatPCMListString(listBatteryInfo);
+                LogUtils.d(TAG, String.format("【initRecordText】使用无换行格式显示记录，记录数量：%d", listBatteryInfo.size()));
+            }
+        }
+
+        mtvRecordText.setText(szRecordText);
+        LogUtils.d(TAG, "【initRecordText】记录显示文本刷新完成");
+    }
+
+    // ======================== 事件回调方法 =========================
+    /**
+     * 切换记录显示格式（带换行/不带换行）
+     * @param view 触发事件的Switch控件
+     */
+    public void onShowRecordWithEnter(View view) {
+        Switch swShowRecordWithEnter = (Switch) view;
+        mIsShowRecordWithEnter = swShowRecordWithEnter.isChecked();
+        LogUtils.d(TAG, String.format("【onShowRecordWithEnter】记录显示格式切换，带换行显示：%b", mIsShowRecordWithEnter));
+        // 刷新记录显示
+        initRecordText();
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/PixelPickerActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/PixelPickerActivity.java
new file mode 100644
index 0000000..f5fcd5d
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/PixelPickerActivity.java
@@ -0,0 +1,346 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.app.Dialog;
+import android.content.Intent;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.Color;
+import android.os.Bundle;
+import android.view.MenuItem;
+import android.view.MotionEvent;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import android.widget.ImageView;
+import android.widget.RelativeLayout;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.views.AToolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+
+/**
+ * 像素拾取页面，支持加载图片并拾取指定位置像素颜色，同步至背景配置
+ * 适配 API30，基于 Java7 开发
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/22 14:15
+ */
+public class PixelPickerActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "PixelPickerActivity";
+    public static final String EXTRA_IMAGE_PATH = "imagePath"; // 图片路径传递键
+    // 提示文本常量
+    private static final String MSG_IMAGE_LOADED = "图片已加载，点击获取像素值";
+    private static final String MSG_NO_IMAGE_PATH = "未找到图片路径";
+    private static final String MSG_IMAGE_LOAD_FAILED = "图片加载失败";
+    private static final String MSG_FILE_NOT_EXIST = "图片文件不存在";
+    private static final String MSG_FILE_NOT_FOUND = "图片文件未找到";
+    private static final String MSG_PIXEL_OUT_OF_RANGE = "像素坐标超出范围";
+    private static final String MSG_TOUCH_OUT_OF_IMAGE = "点击位置超出图片显示范围";
+    private static final String MSG_PIXEL_CALC_FAILED = "计算像素位置失败";
+    private static final String MSG_PIXEL_RECORDED = "已记录像素值";
+
+    // ======================== 成员变量 =========================
+    // UI组件
+    private Toolbar mToolbar;
+    private ImageView imageView;
+    private TextView infoText;
+    private ViewGroup imageContainer;
+    private RelativeLayout mainLayout;
+    // 图片与像素数据
+    private Bitmap originalBitmap; // 原始图片Bitmap（用于像素拾取）
+
+    // ======================== 接口实现方法 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_pixelpicker);
+        LogUtils.d(TAG, "【onCreate】PixelPickerActivity 初始化开始");
+
+        // 初始化UI组件
+        initView();
+        // 初始化工具栏
+        initToolbar();
+        // 加载传递的图片
+        loadImageFromIntent();
+        // 绑定图片触摸事件
+        bindImageTouchListener();
+
+        LogUtils.d(TAG, "【onCreate】PixelPickerActivity 初始化完成");
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        LogUtils.d(TAG, "【onResume】PixelPickerActivity 恢复显示");
+        // 同步背景颜色
+        setBackgroundColor();
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // 回收Bitmap资源，避免内存泄漏
+        if (originalBitmap != null && !originalBitmap.isRecycled()) {
+            originalBitmap.recycle();
+            originalBitmap = null;
+            LogUtils.d(TAG, "【onDestroy】原始图片Bitmap资源已回收");
+        }
+        LogUtils.d(TAG, "【onDestroy】PixelPickerActivity 销毁完成");
+    }
+
+    // ======================== UI初始化方法 =========================
+    /**
+     * 初始化所有UI组件
+     */
+    private void initView() {
+        imageView = findViewById(R.id.imageView);
+        infoText = findViewById(R.id.infoText);
+        imageContainer = findViewById(R.id.imageContainer);
+        mainLayout = findViewById(R.id.activitypixelpickerRelativeLayout1);
+
+        LogUtils.d(TAG, "【initView】UI组件初始化完成");
+    }
+
+    /**
+     * 初始化工具栏，设置导航与标题
+     */
+    private void initToolbar() {
+		LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 从Intent中获取图片路径并加载图片
+     */
+    private void loadImageFromIntent() {
+        String imagePath = getIntent().getStringExtra(EXTRA_IMAGE_PATH);
+        LogUtils.d(TAG, "【loadImageFromIntent】获取到图片路径：" + imagePath);
+
+        if (imagePath != null) {
+            loadImage(imagePath);
+        } else {
+            infoText.setText(MSG_NO_IMAGE_PATH);
+            LogUtils.w(TAG, "【loadImageFromIntent】未获取到图片路径");
+        }
+    }
+
+    /**
+     * 加载指定路径的图片
+     * @param imagePath 图片文件路径
+     */
+    private void loadImage(String imagePath) {
+        try {
+            File file = new File(imagePath);
+            if (file.exists()) {
+                // 解码图片（加载原图）
+                BitmapFactory.Options options = new BitmapFactory.Options();
+                options.inSampleSize = 1;
+                originalBitmap = BitmapFactory.decodeStream(new FileInputStream(file), null, options);
+
+                if (originalBitmap != null) {
+                    imageView.setImageBitmap(originalBitmap);
+                    infoText.setText(MSG_IMAGE_LOADED);
+                    LogUtils.d(TAG, "【loadImage】图片加载成功，尺寸：" + originalBitmap.getWidth() + "x" + originalBitmap.getHeight());
+                } else {
+                    infoText.setText(MSG_IMAGE_LOAD_FAILED);
+                    LogUtils.e(TAG, "【loadImage】图片解码失败");
+                }
+            } else {
+                infoText.setText(MSG_FILE_NOT_EXIST);
+                LogUtils.w(TAG, "【loadImage】图片文件不存在：" + imagePath);
+            }
+        } catch (FileNotFoundException e) {
+            e.printStackTrace();
+            infoText.setText(MSG_FILE_NOT_FOUND);
+            LogUtils.e(TAG, "【loadImage】图片文件未找到：" + e.getMessage());
+        }
+    }
+
+    /**
+     * 显示像素颜色信息对话框
+     * @param pixelColor 拾取的像素颜色（ARGB）
+     * @param x 像素X坐标
+     * @param y 像素Y坐标
+     */
+    private void showPixelDialog(final int pixelColor, int x, int y) {
+        final Dialog dialog = new Dialog(this);
+        dialog.setContentView(R.layout.dialog_pixel);
+        dialog.setCancelable(true);
+
+        // 设置颜色预览与信息展示
+        TextView colorView = dialog.findViewById(R.id.pixelColorView);
+        TextView infoTextView = dialog.findViewById(R.id.colorInfoText);
+        colorView.setBackgroundColor(pixelColor);
+
+        String colorInfo = String.format(
+			"RGB: (%d, %d, %d)\n" +
+			"ARGB: #%08X\n" +
+			"实际像素位置: (%d, %d)",
+			Color.red(pixelColor),
+			Color.green(pixelColor),
+			Color.blue(pixelColor),
+			pixelColor,
+			x, y);
+        infoTextView.setText(colorInfo);
+        LogUtils.d(TAG, "【showPixelDialog】显示像素信息：" + colorInfo);
+
+        // 确定按钮点击事件
+        Button confirmButton = dialog.findViewById(R.id.confirmButton);
+        confirmButton.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					dialog.dismiss();
+					// 保存像素颜色到背景配置
+					savePixelColor(pixelColor);
+					Toast.makeText(PixelPickerActivity.this, MSG_PIXEL_RECORDED, Toast.LENGTH_SHORT).show();
+					// 同步背景颜色
+					setBackgroundColor();
+				}
+			});
+
+        dialog.show();
+        LogUtils.d(TAG, "【showPixelDialog】像素对话框已显示");
+    }
+
+    /**
+     * 保存拾取的像素颜色到背景配置
+     * @param pixelColor 拾取的像素颜色（ARGB）
+     */
+    private void savePixelColor(int pixelColor) {
+        BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(this);
+        BackgroundBean bean = utils.getPreviewBackgroundBean();
+        bean.setPixelColor(pixelColor);
+        utils.saveSettings();
+        LogUtils.d(TAG, "【savePixelColor】像素颜色已保存：#" + Integer.toHexString(pixelColor));
+    }
+
+    /**
+     * 同步背景颜色为拾取的像素颜色
+     */
+    void setBackgroundColor() {
+        BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(this);
+        BackgroundBean bean = utils.getPreviewBackgroundBean();
+        int pixelColor = bean.getPixelColor();
+        mainLayout.setBackgroundColor(pixelColor);
+        LogUtils.d(TAG, "【setBackgroundColor】背景颜色已同步：#" + Integer.toHexString(pixelColor));
+    }
+
+    // ======================== 事件回调方法 =========================
+    /**
+     * 绑定图片容器的触摸事件，处理像素拾取逻辑
+     */
+    private void bindImageTouchListener() {
+        imageContainer.setOnTouchListener(new View.OnTouchListener() {
+				@Override
+				public boolean onTouch(View v, MotionEvent event) {
+					if (event.getAction() == MotionEvent.ACTION_DOWN && originalBitmap != null) {
+						float touchX = event.getX();
+						float touchY = event.getY();
+						LogUtils.v(TAG, "【onTouch】触摸坐标：(" + touchX + ", " + touchY + ")");
+
+						try {
+							// 获取图片在窗口中的位置与尺寸
+							int[] imageLocation = new int[2];
+							imageView.getLocationInWindow(imageLocation);
+							int imageWidth = imageView.getWidth();
+							int imageHeight = imageView.getHeight();
+							LogUtils.v(TAG, "【onTouch】图片显示尺寸：" + imageWidth + "x" + imageHeight + "，位置：(" + imageLocation[0] + ", " + imageLocation[1] + ")");
+
+							// 计算缩放比例
+							float scaleX = (float) originalBitmap.getWidth() / imageWidth;
+							float scaleY = (float) originalBitmap.getHeight() / imageHeight;
+							LogUtils.v(TAG, "【onTouch】图片缩放比例：X=" + scaleX + "，Y=" + scaleY);
+
+							// 调整触摸坐标到图片显示区域坐标系
+							float adjustedX = touchX - imageLocation[0];
+							float adjustedY = touchY - imageLocation[1];
+							LogUtils.v(TAG, "【onTouch】调整后触摸坐标：(" + adjustedX + ", " + adjustedY + ")");
+
+							// 检查是否在图片显示范围内
+							if (adjustedX >= 0 && adjustedX <= imageWidth && adjustedY >= 0 && adjustedY <= imageHeight) {
+								// 计算原始图片的像素坐标
+								int pixelX = (int) (adjustedX * scaleX);
+								int pixelY = (int) (adjustedY * scaleY);
+								LogUtils.v(TAG, "【onTouch】计算后像素坐标：(" + pixelX + ", " + pixelY + ")");
+
+								// 检查像素坐标是否在原始图片范围内
+								if (pixelX >= 0 && pixelX < originalBitmap.getWidth() && pixelY >= 0 && pixelY < originalBitmap.getHeight()) {
+									int pixelColor = originalBitmap.getPixel(pixelX, pixelY);
+									showPixelDialog(pixelColor, pixelX, pixelY);
+								} else {
+									Toast.makeText(PixelPickerActivity.this, MSG_PIXEL_OUT_OF_RANGE, Toast.LENGTH_SHORT).show();
+									LogUtils.w(TAG, "【onTouch】像素坐标超出原始图片范围");
+								}
+							} else {
+								Toast.makeText(PixelPickerActivity.this, MSG_TOUCH_OUT_OF_IMAGE, Toast.LENGTH_SHORT).show();
+								LogUtils.w(TAG, "【onTouch】触摸位置超出图片显示范围");
+							}
+						} catch (Exception e) {
+							e.printStackTrace();
+							Toast.makeText(PixelPickerActivity.this, MSG_PIXEL_CALC_FAILED, Toast.LENGTH_SHORT).show();
+							LogUtils.e(TAG, "【onTouch】计算像素位置失败：" + e.getMessage());
+						}
+					}
+					return true;
+				}
+			});
+        LogUtils.d(TAG, "【bindImageTouchListener】图片触摸事件已绑定");
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (item.getItemId() == android.R.id.home) {
+            LogUtils.d(TAG, "【onOptionsItemSelected】点击返回菜单");
+            Intent intent = new Intent(this, BackgroundSettingsActivity.class);
+            startActivity(intent);
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    @Override
+    public void onBackPressed() {
+        super.onBackPressed();
+        setResult(RESULT_OK);
+        finish();
+        LogUtils.d(TAG, "【onBackPressed】返回键触发，页面关闭");
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/SettingsActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/SettingsActivity.java
new file mode 100644
index 0000000..fca94e6
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/SettingsActivity.java
@@ -0,0 +1,286 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Bundle;
+import android.provider.Settings;
+import android.view.View;
+import android.view.WindowManager;
+import android.widget.CheckBox;
+import android.widget.Toast;
+import androidx.appcompat.app.AlertDialog;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.ThoughtfulServiceBean;
+import java.lang.reflect.Field;
+
+/**
+ * 应用设置窗口，提供应用配置项的统一入口
+ * 适配 API30，基于 Java7 开发
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025年11月27日14时26分00秒
+ * @LastEditTime 2026-02-28
+ * @Describe 应用设置窗口（主开关联动子开关启用/禁用，主开关关闭则子开关禁用并取消勾选）
+ */
+public class SettingsActivity extends WinBoLLActivity implements IWinBoLLActivity {
+    // ======================== 静态常量区 =========================
+    public static final String TAG = "SettingsActivity";
+    private static final int REQUEST_READ_MEDIA_IMAGES = 1001;
+
+    // ======================== 成员属性区 =========================
+    private Toolbar mToolbar;
+    private CheckBox cbUsePowerTts;      // 用电TTS（主开关）
+    private CheckBox cbChargeTts;        // 充电TTS（主开关）
+    private CheckBox cbUseageTtsBattary; // 用电TTS带电量提醒（子开关）
+    private CheckBox cbChargeTtsBattary; // 充电TTS带电量提醒（子开关）
+    private CheckBox cbTtsWhenNotifyBattery; // 👉 新增：通知电量时同时播放TTS
+
+    // ======================== 接口实现区 =========================
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    // ======================== 生命周期区 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_settings);
+        LogUtils.d(TAG, "onCreate: 应用设置页面初始化开始");
+
+        initToolbar();
+        initTtsCheckBoxes();
+        initTtsCheckBoxStatus();
+
+        LogUtils.d(TAG, "onCreate: 应用设置页面初始化完成");
+    }
+
+    // ======================== UI初始化区 =========================
+    /**
+     * 初始化顶部工具栏
+     */
+    private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar: 工具栏初始化开始");
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        mToolbar.setTitleTextAppearance(this, R.style.Toolbar_TitleText);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "initToolbar-navigationOnClick: 点击导航返回按钮");
+					finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar: 工具栏初始化完成");
+    }
+
+    /**
+     * 绑定TTS相关复选框控件
+     */
+    private void initTtsCheckBoxes() {
+        LogUtils.d(TAG, "initTtsCheckBoxes: TTS复选框绑定开始");
+        cbUsePowerTts = findViewById(R.id.activitysettingsCheckBox1);
+        cbChargeTts = findViewById(R.id.activitysettingsCheckBox2);
+        cbUseageTtsBattary = findViewById(R.id.activitysettingsCheckBox3);
+        cbChargeTtsBattary = findViewById(R.id.activitysettingsCheckBox4);
+        cbTtsWhenNotifyBattery = findViewById(R.id.activitysettingsCheckBox5); // 👉 新增绑定
+        LogUtils.d(TAG, "initTtsCheckBoxes: TTS复选框绑定完成");
+    }
+
+    /**
+     * 初始化TTS复选框初始状态
+     */
+    private void initTtsCheckBoxStatus() {
+        LogUtils.d(TAG, "initTtsCheckBoxStatus: TTS复选框状态初始化开始");
+        ThoughtfulServiceBean bean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+        if (bean == null) {
+            LogUtils.d(TAG, "initTtsCheckBoxStatus: 未读取到配置Bean，创建新实例");
+            bean = new ThoughtfulServiceBean();
+        }
+
+        boolean useMainOpen = bean.isEnableUsePowerTts();
+        boolean chargeMainOpen = bean.isEnableChargeTts();
+        cbUsePowerTts.setChecked(useMainOpen);
+        cbChargeTts.setChecked(chargeMainOpen);
+        cbUseageTtsBattary.setChecked(bean.isEnableUseageTtsWithBattary());
+        cbChargeTtsBattary.setChecked(bean.isEnableChargeTtsWithBattary());
+        cbTtsWhenNotifyBattery.setChecked(bean.isEnableTtsWhenNotifyBattery()); // 👉 新增赋值
+        cbUseageTtsBattary.setEnabled(useMainOpen);
+        cbChargeTtsBattary.setEnabled(chargeMainOpen);
+
+        LogUtils.d(TAG, "initTtsCheckBoxStatus: 主开关状态-用电TTS：" + useMainOpen + " 充电TTS：" + chargeMainOpen);
+        LogUtils.d(TAG, "initTtsCheckBoxStatus: TTS复选框状态初始化完成");
+    }
+
+    // ======================== 事件响应区 =========================
+    /**
+     * 悬浮窗权限检查入口
+     */
+    public void onCheckTTSDrawOverlaysPermission(View view) {
+        LogUtils.d(TAG, "onCheckTTSDrawOverlaysPermission: 触发悬浮窗权限检查");
+        canDrawOverlays();
+    }
+
+    /**
+     * 用电TTS主开关点击事件
+     */
+    public void onEnableUsePowerTts(View view) {
+        boolean isChecked = cbUsePowerTts.isChecked();
+        LogUtils.d(TAG, "onEnableUsePowerTts: 用电TTS主开关点击，切换后状态=" + isChecked);
+        // 主开关联动子开关
+        cbUseageTtsBattary.setEnabled(isChecked);
+        // 保存配置
+        ThoughtfulServiceBean bean = getThoughtfulServiceBean();
+        bean.setIsEnableUsePowerTts(isChecked);
+        ThoughtfulServiceBean.saveBean(this, bean);
+        LogUtils.d(TAG, "onEnableUsePowerTts: 用电TTS状态保存完成");
+    }
+
+    /**
+     * 充电TTS主开关点击事件
+     */
+    public void onEnableChargeTts(View view) {
+        boolean isChecked = cbChargeTts.isChecked();
+        LogUtils.d(TAG, "onEnableChargeTts: 充电TTS主开关点击，切换后状态=" + isChecked);
+        // 主开关联动子开关
+        cbChargeTtsBattary.setEnabled(isChecked);
+        // 保存配置
+        ThoughtfulServiceBean bean = getThoughtfulServiceBean();
+        bean.setIsEnableChargeTts(isChecked);
+        ThoughtfulServiceBean.saveBean(this, bean);
+        LogUtils.d(TAG, "onEnableChargeTts: 充电TTS状态保存完成");
+    }
+
+    /**
+     * 用电TTS带电量提醒子开关点击事件
+     */
+    public void onEnableUseageTtsWithBattary(View view) {
+        boolean isChecked = cbUseageTtsBattary.isChecked();
+        LogUtils.d(TAG, "onEnableUseageTtsWithBattary: 用电TTS电量提醒开关点击，切换后状态=" + isChecked);
+        ThoughtfulServiceBean bean = getThoughtfulServiceBean();
+        bean.setIsEnableUseageTtsWithBattary(isChecked);
+        ThoughtfulServiceBean.saveBean(this, bean);
+        LogUtils.d(TAG, "onEnableUseageTtsWithBattary: 用电TTS电量提醒状态保存完成");
+    }
+
+    /**
+     * 充电TTS带电量提醒子开关点击事件
+     */
+    public void onEnableChargeTtsWithBattary(View view) {
+        boolean isChecked = cbChargeTtsBattary.isChecked();
+        LogUtils.d(TAG, "onEnableChargeTtsWithBattary: 充电TTS电量提醒开关点击，切换后状态=" + isChecked);
+        ThoughtfulServiceBean bean = getThoughtfulServiceBean();
+        bean.setIsEnableChargeTtsWithBattary(isChecked);
+        ThoughtfulServiceBean.saveBean(this, bean);
+        LogUtils.d(TAG, "onEnableChargeTtsWithBattary: 充电TTS电量提醒状态保存完成");
+    }
+
+    /**
+     * 👉 新增：允许通知电量消息时同时播放TTS语音
+     */
+    public void onEnableTtsWhenNotifyBattery(View view) {
+        boolean isChecked = cbTtsWhenNotifyBattery.isChecked();
+        LogUtils.d(TAG, "onEnableTtsWhenNotifyBattery: 通知电量时播TTS开关状态=" + isChecked);
+        ThoughtfulServiceBean bean = getThoughtfulServiceBean();
+        bean.setIsEnableTtsWhenNotifyBattery(isChecked);
+        ThoughtfulServiceBean.saveBean(this, bean);
+        LogUtils.d(TAG, "onEnableTtsWhenNotifyBattery: 保存完成");
+    }
+
+    // ======================== 工具方法区 =========================
+    /**
+     * 获取配置Bean实例，避免重复代码
+     */
+    private ThoughtfulServiceBean getThoughtfulServiceBean() {
+        LogUtils.d(TAG, "getThoughtfulServiceBean: 获取配置Bean");
+        ThoughtfulServiceBean bean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+        if (bean == null) {
+            LogUtils.d(TAG, "getThoughtfulServiceBean: 配置Bean为空，创建新实例");
+            bean = new ThoughtfulServiceBean();
+        }
+        return bean;
+    }
+
+    /**
+     * 悬浮窗权限检查与请求
+     */
+    void canDrawOverlays() {
+        LogUtils.d(TAG, "canDrawOverlays: 悬浮窗权限检查开始");
+        if (Build.VERSION.SDK_INT >= 23 && !Settings.canDrawOverlays(this)) {
+            LogUtils.d(TAG, "canDrawOverlays: 未开启悬浮窗权限，发起请求");
+            showDrawOverlayRequestDialog();
+        } else {
+            LogUtils.d(TAG, "canDrawOverlays: 悬浮窗权限已开启");
+            ToastUtils.show("悬浮窗权限已开启");
+        }
+    }
+
+    /**
+     * 显示悬浮窗权限请求对话框
+     */
+    private void showDrawOverlayRequestDialog() {
+        LogUtils.d(TAG, "showDrawOverlayRequestDialog: 显示悬浮窗权限请求弹窗");
+        AlertDialog dialog = new AlertDialog.Builder(this)
+			.setTitle("权限请求")
+			.setMessage("为保证通话监听功能正常，需开启悬浮窗权限")
+			.setPositiveButton("去设置", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					LogUtils.d(TAG, "showDrawOverlayRequestDialog-去设置: 点击跳转权限页面");
+					dialog.dismiss();
+					jumpToDrawOverlaySettings();
+				}
+			})
+			.setNegativeButton("稍后", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					LogUtils.d(TAG, "showDrawOverlayRequestDialog-稍后: 点击取消请求");
+					dialog.dismiss();
+				}
+			})
+			.create();
+
+        if (dialog.getWindow() != null) {
+            dialog.getWindow().setFlags(
+				WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
+				WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE);
+        }
+        dialog.show();
+    }
+
+    /**
+     * 跳转悬浮窗权限设置页面（反射适配低版本）
+     */
+    private void jumpToDrawOverlaySettings() {
+        LogUtils.d(TAG, "jumpToDrawOverlaySettings: 跳转悬浮窗权限设置页面");
+        try {
+            Class<?> settingsClazz = Settings.class;
+            Field actionField = settingsClazz.getDeclaredField("ACTION_MANAGE_OVERLAY_PERMISSION");
+            String action = (String) actionField.get(null);
+
+            Intent intent = new Intent(action);
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            intent.setData(Uri.parse("package:" + getPackageName()));
+            startActivity(intent);
+            LogUtils.d(TAG, "jumpToDrawOverlaySettings: 跳转权限页面意图已发送");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "jumpToDrawOverlaySettings: 跳转权限设置失败", e);
+            Toast.makeText(this, "请手动在设置中开启悬浮窗权限", Toast.LENGTH_LONG).show();
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ShortcutActionActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ShortcutActionActivity.java
new file mode 100644
index 0000000..e6e2fc4
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/ShortcutActionActivity.java
@@ -0,0 +1,75 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.utils.APPPlusUtils;
+
+/**
+ * 应用快捷方式活动类，处理应用图标快捷菜单的切换请求
+ * 适配 API30，基于 Java7 开发
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/15 13:45
+ * @Describe 应用快捷方式活动类
+ */
+public class ShortcutActionActivity extends Activity {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "ShortcutActionActivity";
+    // 快捷指令常量
+    private static final String ACTION_SWITCH_TO_EN1 = "switchto_en1";
+    private static final String ACTION_SWITCH_TO_CN1 = "switchto_cn1";
+    private static final String ACTION_SWITCH_TO_CN2 = "switchto_cn2";
+
+    // ======================== 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "【onCreate】ShortcutActionActivity 启动，开始处理快捷方式请求");
+
+        // 处理应用图标快捷菜单的切换请求
+        handleSwitchRequest();
+
+        LogUtils.d(TAG, "【onCreate】快捷方式请求处理完成，关闭活动");
+        finish();
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 处理应用图标快捷菜单的请求，根据意图数据切换应用启动组件
+     */
+    private void handleSwitchRequest() {
+        Intent intent = getIntent();
+        if (intent == null) {
+            LogUtils.w(TAG, "【handleSwitchRequest】意图为空，无法处理快捷方式请求");
+            return;
+        }
+
+        String dataString = intent.getDataString();
+        LogUtils.d(TAG, "【handleSwitchRequest】获取到快捷指令：" + dataString);
+
+        // 匹配快捷指令并切换组件
+        if (ACTION_SWITCH_TO_EN1.equals(dataString)) {
+            APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_EN1);
+            String toastMsg = "切换至" + getString(R.string.app_name) + "图标";
+            ToastUtils.show(toastMsg);
+            LogUtils.d(TAG, "【handleSwitchRequest】已切换至EN1组件：" + App.COMPONENT_EN1);
+        } else if (ACTION_SWITCH_TO_CN1.equals(dataString)) {
+            APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN1);
+            String toastMsg = "切换至" + getString(R.string.app_name_cn1) + "图标";
+            ToastUtils.show(toastMsg);
+            LogUtils.d(TAG, "【handleSwitchRequest】已切换至CN1组件：" + App.COMPONENT_CN1);
+        } else if (ACTION_SWITCH_TO_CN2.equals(dataString)) {
+            APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN2);
+            String toastMsg = "切换至" + getString(R.string.app_name_cn2) + "图标";
+            ToastUtils.show(toastMsg);
+            LogUtils.d(TAG, "【handleSwitchRequest】已切换至CN2组件：" + App.COMPONENT_CN2);
+        } else {
+            LogUtils.w(TAG, "【handleSwitchRequest】未匹配到有效快捷指令：" + dataString);
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/WinBoLLActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/WinBoLLActivity.java
new file mode 100644
index 0000000..ffbd227
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/activities/WinBoLLActivity.java
@@ -0,0 +1,215 @@
+package cc.winboll.studio.powerbell.activities;
+
+import android.annotation.SuppressLint;
+import android.app.Activity;
+import android.graphics.Color;
+import android.os.Bundle;
+import android.util.TypedValue;
+import android.view.Gravity;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.FrameLayout;
+import android.widget.TextView;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.BuildConfig;
+import cc.winboll.studio.powerbell.R;
+
+/** 
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/19 20:35
+ * @Describe 应用窗口基类，提供主题设置、Activity 管理、工具栏配置、全屏切换、版本标签显示等通用功能
+ * 适配 API30，基于 Java7 开发，所有子类需继承此类实现统一窗口行为
+ */
+public abstract class WinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "WinBoLLActivity";
+    private static final String VERSION_TAG_TEXT = "MIMO SDK V%s"; // 版本标签文本格式
+    private static final float VERSION_TAG_TEXT_SIZE = 10f; // 版本标签字体大小（sp）
+
+    // ======================== 成员变量 =========================
+    protected volatile AESThemeBean.ThemeType mThemeType; // 当前主题类型
+    protected TextView mTagView; // 版本标签显示控件
+
+    // ======================== 接口实现 & 抽象方法 =========================
+    @Override
+    public abstract Activity getActivity();
+
+    @Override
+    public abstract String getTag();
+
+    // ======================== 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        LogUtils.d(TAG, String.format("【%s-onCreate】窗口基类初始化开始", getTag()));
+        // 初始化主题
+        mThemeType = getThemeType();
+        setThemeStyle();
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, String.format("【%s-onCreate】窗口基类初始化完成，当前主题：%s", getTag(), mThemeType));
+    }
+
+    @Override
+    protected void onStart() {
+        super.onStart();
+        LogUtils.d(TAG, String.format("【%s-onStart】添加版本标签到页面", getTag()));
+        // 添加版本标签
+        addVersionNameToContentView();
+    }
+
+    @Override
+    protected void onPostCreate(Bundle savedInstanceState) {
+        super.onPostCreate(savedInstanceState);
+        // 注册到Activity管理器
+        WinBoLLActivityManager.getInstance().add(this);
+        LogUtils.d(TAG, String.format("【%s-onPostCreate】已注册到Activity管理器", getTag()));
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // 从Activity管理器移除
+        WinBoLLActivityManager.getInstance().registeRemove(this);
+        LogUtils.d(TAG, String.format("【%s-onDestroy】已从Activity管理器移除", getTag()));
+    }
+
+    // ======================== 主题相关方法 =========================
+    /**
+     * 获取当前主题类型
+     * @return 主题类型枚举
+     */
+    AESThemeBean.ThemeType getThemeType() {
+        int themeId = AESThemeUtil.getThemeTypeID(getApplicationContext());
+        AESThemeBean.ThemeType themeType = AESThemeBean.getThemeStyleType(themeId);
+        LogUtils.d(TAG, String.format("【%s-getThemeType】获取主题类型，ID：%d，类型：%s", getTag(), themeId, themeType));
+        return themeType;
+    }
+
+    /**
+     * 设置主题样式
+     */
+    void setThemeStyle() {
+        int themeId = AESThemeUtil.getThemeTypeID(getApplicationContext());
+        setTheme(themeId);
+        LogUtils.d(TAG, String.format("【%s-setThemeStyle】应用主题样式，ID：%d", getTag(), themeId));
+    }
+
+    // ======================== UI 配置方法 =========================
+    /**
+     * 添加版本标签到页面底部
+     */
+    protected void addVersionNameToContentView() {
+        if (!isTagViewVisible()) {
+            LogUtils.d(TAG, String.format("【%s-addVersionNameToContentView】版本标签不可见，跳过添加", getTag()));
+            return;
+        }
+
+        if (mTagView == null) {
+            mTagView = new TextView(this);
+            // 配置版本标签样式
+            mTagView.setTextColor(Color.GRAY);
+            mTagView.setTextSize(TypedValue.COMPLEX_UNIT_SP, VERSION_TAG_TEXT_SIZE);
+            mTagView.setText(String.format(VERSION_TAG_TEXT, BuildConfig.VERSION_NAME));
+            // 配置布局参数
+            FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(
+				ViewGroup.LayoutParams.WRAP_CONTENT,
+				ViewGroup.LayoutParams.WRAP_CONTENT);
+            params.gravity = Gravity.BOTTOM | Gravity.CENTER_HORIZONTAL;
+            // 添加到根布局
+            FrameLayout frameLayout = findViewById(android.R.id.content);
+            if (frameLayout != null) {
+                frameLayout.addView(mTagView, params);
+                LogUtils.d(TAG, String.format("【%s-addVersionNameToContentView】版本标签添加完成，版本：%s", getTag(), BuildConfig.VERSION_NAME));
+            } else {
+                LogUtils.w(TAG, String.format("【%s-addVersionNameToContentView】根布局为空，无法添加版本标签", getTag()));
+            }
+        }
+    }
+
+    /**
+     * 配置工具栏，显示返回按钮
+     */
+    public void setupToolbar() {
+        Toolbar mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar != null) {
+            setSupportActionBar(mToolbar);
+            if (getSupportActionBar() != null) {
+                getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+                LogUtils.d(TAG, String.format("【%s-setupToolbar】工具栏配置完成，已显示返回按钮", getTag()));
+            } else {
+                LogUtils.w(TAG, String.format("【%s-setupToolbar】ActionBar为空，无法显示返回按钮", getTag()));
+            }
+        } else {
+            LogUtils.w(TAG, String.format("【%s-setupToolbar】未找到工具栏控件（ID：toolbar）", getTag()));
+        }
+    }
+
+    /**
+     * 版本标签是否可见
+     * @return 默认为true，子类可重写修改
+     */
+    protected boolean isTagViewVisible() {
+        return true;
+    }
+
+    // ======================== 菜单 & 返回键处理 =========================
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (item.getItemId() == android.R.id.home) {
+            LogUtils.d(TAG, String.format("【%s-onOptionsItemSelected】点击返回菜单", getTag()));
+            return true;
+        }
+        return super.onOptionsItemSelected(item);
+    }
+
+    @Override
+    public void onBackPressed() {
+        super.onBackPressed();
+        LogUtils.d(TAG, String.format("【%s-onBackPressed】触发返回键", getTag()));
+    }
+
+    // ======================== 工具方法 =========================
+    /**
+     * 切换至全屏模式，隐藏状态栏与导航栏
+     * @param activity 目标Activity
+     */
+    public void changeFullScreen(Activity activity) {
+        if (activity == null) {
+            LogUtils.w(TAG, String.format("【%s-changeFullScreen】目标Activity为空，无法切换全屏", getTag()));
+            return;
+        }
+
+        Window window = activity.getWindow();
+        if (window == null) {
+            LogUtils.w(TAG, String.format("【%s-changeFullScreen】窗口为空，无法切换全屏", getTag()));
+            return;
+        }
+
+        View decorView = window.getDecorView();
+        if (decorView == null) {
+            LogUtils.w(TAG, String.format("【%s-changeFullScreen】DecorView为空，无法切换全屏", getTag()));
+            return;
+        }
+
+        // 配置全屏标志位
+        int flag = decorView.getSystemUiVisibility();
+        flag |= View.SYSTEM_UI_FLAG_FULLSCREEN;
+        flag |= View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
+        flag |= View.SYSTEM_UI_FLAG_HIDE_NAVIGATION;
+        flag |= View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION;
+        flag |= View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;
+        decorView.setSystemUiVisibility(flag);
+        // 配置窗口标志位
+        window.setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN);
+        LogUtils.d(TAG, String.format("【%s-changeFullScreen】已切换至全屏模式", getTag()));
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/adapters/BatteryAdapter.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/adapters/BatteryAdapter.java
new file mode 100644
index 0000000..c87d328
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/adapters/BatteryAdapter.java
@@ -0,0 +1,107 @@
+package cc.winboll.studio.powerbell.adapters;
+
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.TextView;
+import androidx.recyclerview.widget.RecyclerView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BatteryData;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 电池报告数据适配器，用于RecyclerView展示电池电量、充放电时间数据
+ * 适配 API30，基于 Java7 开发
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/22 14:38:55
+ * @Describe 电池报告数据适配器
+ */
+public class BatteryAdapter extends RecyclerView.Adapter<BatteryAdapter.ViewHolder> {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "BatteryAdapter";
+    private static final String FORMAT_BATTERY_LEVEL = "%d%%"; // 电量显示格式
+    private static final String PREFIX_DISCHARGE_TIME = "使用时间: "; // 放电时间前缀
+    private static final String PREFIX_CHARGE_TIME = "充电时间: "; // 充电时间前缀
+
+    // ======================== 成员变量 =========================
+    private List<BatteryData> dataList = new ArrayList<>(); // 电池数据列表
+
+    // ======================== 构造方法 =========================
+    public BatteryAdapter() {
+        LogUtils.d(TAG, "【BatteryAdapter】适配器初始化，初始数据列表为空");
+    }
+
+    // ======================== 数据操作方法 =========================
+    /**
+     * 更新适配器数据并刷新列表
+     * @param newData 新的电池数据列表
+     */
+    public void updateData(List<BatteryData> newData) {
+        LogUtils.d(TAG, "【updateData】开始更新数据，新数据列表是否为空：" + (newData == null));
+        // 判空处理，避免空指针
+        if (newData != null) {
+            dataList = newData;
+            LogUtils.d(TAG, "【updateData】数据更新完成，当前数据量：" + dataList.size());
+        } else {
+            dataList.clear();
+            LogUtils.w(TAG, "【updateData】新数据列表为空，已清空本地数据");
+        }
+        notifyDataSetChanged();
+        LogUtils.d(TAG, "【updateData】已通知列表刷新");
+    }
+
+    // ======================== RecyclerView 重写方法 =========================
+    @Override
+    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
+        LogUtils.d(TAG, "【onCreateViewHolder】创建ViewHolder，父容器：" + parent.getContext().getClass().getSimpleName());
+        View view = LayoutInflater.from(parent.getContext())
+			.inflate(R.layout.item_battery_report, parent, false);
+        ViewHolder viewHolder = new ViewHolder(view);
+        LogUtils.d(TAG, "【onCreateViewHolder】ViewHolder创建完成");
+        return viewHolder;
+    }
+
+    @Override
+    public void onBindViewHolder(ViewHolder holder, int position) {
+        LogUtils.d(TAG, "【onBindViewHolder】绑定ViewHolder，位置：" + position);
+        // 判空与越界校验
+        if (dataList == null || dataList.isEmpty() || position >= dataList.size()) {
+            LogUtils.w(TAG, "【onBindViewHolder】数据异常，无法绑定视图，位置：" + position);
+            return;
+        }
+
+        BatteryData item = dataList.get(position);
+        // 绑定数据到视图
+        holder.tvLevel.setText(String.format(FORMAT_BATTERY_LEVEL, item.getCurrentLevel()));
+        holder.tvDischargeTime.setText(PREFIX_DISCHARGE_TIME + item.getDischargeTime());
+        holder.tvChargeTime.setText(PREFIX_CHARGE_TIME + item.getChargeTime());
+
+        LogUtils.d(TAG, "【onBindViewHolder】视图绑定完成，位置：" + position + "，电量：" + item.getCurrentLevel() + "%");
+    }
+
+    @Override
+    public int getItemCount() {
+        int count = dataList.size();
+        LogUtils.d(TAG, "【getItemCount】获取条目数量：" + count);
+        return count;
+    }
+
+    // ======================== ViewHolder 内部类 =========================
+    static class ViewHolder extends RecyclerView.ViewHolder {
+        TextView tvLevel; // 电量显示
+        TextView tvDischargeTime; // 放电时间显示
+        TextView tvChargeTime; // 充电时间显示
+
+        ViewHolder(View itemView) {
+            super(itemView);
+            // 初始化视图控件
+            tvLevel = itemView.findViewById(R.id.tvLevel);
+            tvDischargeTime = itemView.findViewById(R.id.tvDischargeTime);
+            tvChargeTime = itemView.findViewById(R.id.tvChargeTime);
+            LogUtils.d(TAG, "【ViewHolder】控件初始化完成");
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/BackgroundPicturePreviewDialog.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/BackgroundPicturePreviewDialog.java
new file mode 100644
index 0000000..00bb178
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/BackgroundPicturePreviewDialog.java
@@ -0,0 +1,153 @@
+package cc.winboll.studio.powerbell.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.text.TextUtils;
+import android.view.View;
+import android.widget.Button;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.activities.BackgroundSettingsActivity;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.UriUtils;
+import cc.winboll.studio.powerbell.views.BackgroundView;
+
+/**
+ * 背景图片的接收分享文件后的预览对话框
+ * 适配 API30，基于 Java7 开发，支持分享图片的Uri解析、预览与确认选择
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/04/25 16:27:53
+ * @Describe 背景图片的接收分享文件后的预览对话框
+ */
+public class BackgroundPicturePreviewDialog extends Dialog {
+    // ======================== 静态常量 =========================
+    public static final String TAG = "BackgroundPicturePreviewDialog";
+    private static final String TOAST_MSG_EMPTY_FILE = "接收到的文件为空。"; // 空文件提示文本
+
+    // ======================== 成员变量 =========================
+    private Context mContext; // 上下文对象
+    private IOnRecivedPictureListener mIOnRecivedPictureListener; // 图片接收监听
+    private Uri mUriRecivedPicture; // 接收的图片Uri
+    // 控件对象
+    private BackgroundView mBackgroundView; // 背景预览视图
+    private Button dialogbackgroundpicturepreviewButton1; // 取消按钮
+    private Button dialogbackgroundpicturepreviewButton2; // 确认按钮
+
+    // ======================== 接口定义 =========================
+    /**
+     * 图片接收监听接口，用于通知确认选择的图片Uri
+     */
+    public interface IOnRecivedPictureListener {
+        void onAcceptRecivedPicture(Uri uriRecivedPicture);
+    }
+
+    // ======================== 构造方法 =========================
+    public BackgroundPicturePreviewDialog(Context context, IOnRecivedPictureListener iOnRecivedPictureListener) {
+        super(context);
+        LogUtils.d(TAG, "【BackgroundPicturePreviewDialog】对话框初始化开始");
+        // 初始化成员变量
+        mContext = context;
+        mIOnRecivedPictureListener = iOnRecivedPictureListener;
+
+        // 设置布局与控件
+        setContentView(R.layout.dialog_backgroundpicturepreview);
+        initViews();
+        bindButtonClickEvents();
+
+        // 预览接收的图片
+        previewRecivedPicture();
+        LogUtils.d(TAG, "【BackgroundPicturePreviewDialog】对话框初始化完成");
+    }
+
+    // ======================== 视图初始化方法 =========================
+    /**
+     * 初始化对话框内所有控件
+     */
+    private void initViews() {
+        mBackgroundView = findViewById(R.id.backgroundview);
+        dialogbackgroundpicturepreviewButton1 = findViewById(R.id.dialogbackgroundpicturepreviewButton1);
+        dialogbackgroundpicturepreviewButton2 = findViewById(R.id.dialogbackgroundpicturepreviewButton2);
+        LogUtils.d(TAG, "【initViews】对话框控件初始化完成");
+    }
+
+    // ======================== 事件绑定方法 =========================
+    /**
+     * 绑定按钮点击事件
+     */
+    private void bindButtonClickEvents() {
+        // 取消按钮：跳转到主页面并关闭对话框
+        dialogbackgroundpicturepreviewButton1.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View view) {
+					LogUtils.d(TAG, "【onClick】点击取消按钮，跳转到主页面");
+					Intent intent = new Intent(mContext, MainActivity.class);
+					mContext.startActivity(intent);
+					dismiss();
+					LogUtils.d(TAG, "【onClick】对话框已关闭");
+				}
+			});
+
+        // 确认按钮：通知监听并关闭对话框
+        dialogbackgroundpicturepreviewButton2.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "【onClick】点击确认按钮，通知接收图片");
+					if (mIOnRecivedPictureListener != null && mUriRecivedPicture != null) {
+						mIOnRecivedPictureListener.onAcceptRecivedPicture(mUriRecivedPicture);
+						LogUtils.d(TAG, "【onClick】已通知监听，图片Uri：" + mUriRecivedPicture);
+					} else {
+						LogUtils.w(TAG, "【onClick】监听为空或图片Uri无效，无法通知");
+					}
+					dismiss();
+					LogUtils.d(TAG, "【onClick】对话框已关闭");
+				}
+			});
+        LogUtils.d(TAG, "【bindButtonClickEvents】按钮点击事件绑定完成");
+    }
+
+    // ======================== 业务逻辑方法 =========================
+    /**
+     * 预览接收的分享图片
+     */
+    private void previewRecivedPicture() {
+        LogUtils.d(TAG, "【previewRecivedPicture】开始预览接收的图片");
+        // 校验上下文类型
+        if (!(mContext instanceof BackgroundSettingsActivity)) {
+            LogUtils.e(TAG, "【previewRecivedPicture】上下文不是BackgroundSettingsActivity，无法获取图片Uri");
+            Toast.makeText(mContext, TOAST_MSG_EMPTY_FILE, Toast.LENGTH_SHORT).show();
+            dismiss();
+            return;
+        }
+
+        BackgroundSettingsActivity activity = (BackgroundSettingsActivity) mContext;
+        // 从Intent中获取图片Uri（优先getData，其次EXTRA_STREAM）
+        mUriRecivedPicture = activity.getIntent().getData();
+        if (mUriRecivedPicture == null) {
+            mUriRecivedPicture = activity.getIntent().getParcelableExtra(Intent.EXTRA_STREAM);
+            LogUtils.d(TAG, "【previewRecivedPicture】从EXTRA_STREAM获取Uri：" + mUriRecivedPicture);
+        } else {
+            LogUtils.d(TAG, "【previewRecivedPicture】从getData获取Uri：" + mUriRecivedPicture);
+        }
+
+        // 解析Uri为文件路径
+        String szSrcImage = UriUtils.getFilePathFromUri(mContext, mUriRecivedPicture);
+		//App.notifyMessage(TAG, "szSrcImage : " + szSrcImage);
+        if (TextUtils.isEmpty(szSrcImage)) {
+            LogUtils.w(TAG, "【previewRecivedPicture】解析的文件路径为空");
+            Toast.makeText(mContext, TOAST_MSG_EMPTY_FILE, Toast.LENGTH_SHORT).show();
+            dismiss();
+            return;
+        }
+
+        // 加载图片到预览视图
+		int nCurrentPixelColor = BackgroundSourceUtils.getInstance(mContext).getCurrentBackgroundBean().getPixelColor();
+        mBackgroundView.loadImage(nCurrentPixelColor, szSrcImage, true);
+        LogUtils.d(TAG, "【previewRecivedPicture】图片预览完成，文件路径：" + szSrcImage);
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/ColorPaletteDialog.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/ColorPaletteDialog.java
new file mode 100644
index 0000000..1371a4f
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/ColorPaletteDialog.java
@@ -0,0 +1,733 @@
+package cc.winboll.studio.powerbell.dialogs;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.graphics.Color;
+import android.graphics.drawable.GradientDrawable;
+import android.os.Bundle;
+import android.text.Editable;
+import android.text.TextUtils;
+import android.text.TextWatcher;
+import android.view.Gravity;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.EditText;
+import android.widget.HorizontalScrollView;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.SeekBar;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import com.a4455jkjh.colorpicker.ColorPickerDialog;
+import com.a4455jkjh.colorpicker.view.OnColorChangedListener;
+
+/**
+ * 调色板对话框（支持颜色拾取、RGB输入、透明度/亮度调节，兼容 API29-30+ 小米机型）
+ * 适配 API30，基于 Java7 开发，返回 0xAARRGGBB 格式颜色（含透明度）
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/16 11:47
+ * @Describe 调色板对话框（支持颜色拾取、RGB输入、透明度/亮度调节，兼容 API29-30+ 小米机型）
+ */
+public class ColorPaletteDialog extends Dialog implements View.OnClickListener, SeekBar.OnSeekBarChangeListener {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    public static final String TAG = "ColorPaletteDialog";
+    private static final int MAX_RGB_VALUE = 255;      // RGB分量最大值（0-255）
+    private static final int DEFAULT_BRIGHTNESS = 100; // 默认亮度百分比（100%，无调节）
+    private static final int BRIGHTNESS_STEP = 5;     // 亮度调节步长（每次±5%，精准流畅）
+    private static final int MIN_BRIGHTNESS = 10;     // 亮度最小值（10%，避免全黑看不见）
+    private static final int MAX_BRIGHTNESS = 200;    // 亮度最大值（200%，避免过曝失真）
+    private static final int MAX_ALPHA_PERCENT = 100; // 透明度最大值（100%=不透明）
+    private static final int MIN_ALPHA_PERCENT = 0;   // 透明度最小值（0%=完全透明）
+    private static final String FORMAT_COLOR_HEX = "#%08X"; // 颜色值格式化（AARRGGBB）
+    private static final String FORMAT_PERCENT = "%d%%"; // 百分比格式化（X%）
+
+    // ====================== 回调接口（紧跟常量，逻辑关联） ======================
+    public interface OnColorSelectedListener {
+        void onColorSelected(int color); // 返回0xAARRGGBB格式颜色（含透明度）
+    }
+
+    // ====================== 成员变量（按优先级排序：核心数据→控件引用） ======================
+    // 核心数据：原始基准值（用户输入/选择颜色时更新）+ 实时调节值（亮度/透明度变化时更新）
+    private OnColorSelectedListener mListener; // 颜色选择回调（非空校验）
+    private int mInitialColor;                 // 初始颜色（传入的默认颜色）
+    private int mCurrentColor;                 // 当前最终颜色（含亮度+透明度调节）
+    private int mCurrentBrightnessPercent;     // 当前亮度百分比（10%-200%）
+    // 透明度：百分比（0-100%，用户直观操作）+ 原始/实时值（0-255，颜色计算用）
+    private int mOriginalAlphaPercent;         // 原始透明度百分比（基准值，用户输入/选色时更新）
+    private int mCurrentAlphaPercent;          // 实时透明度百分比（调节进度条时更新）
+    private int mOriginalAlpha;                // 原始透明度（0-255，基准值）
+    private int mCurrentAlpha;                 // 实时透明度（0-255，计算用）
+    // RGB：原始基准值+实时调节值
+    private int mOriginalR;                    // 原始R分量（基准值，用户输入/选色时更新）
+    private int mOriginalG;                    // 原始G分量（基准值，用户输入/选色时更新）
+    private int mOriginalB;                    // 原始B分量（基准值，用户输入/选色时更新）
+    private int mCurrentR;                     // 实时R分量（亮度调节后，同步输入框显示）
+    private int mCurrentG;                     // 实时G分量（亮度调节后，同步输入框显示）
+    private int mCurrentB;                     // 实时B分量（亮度调节后，同步输入框显示）
+    // 并发控制标记：是否是应用程序自身在更新颜色（避免循环回调/重复触发）
+    private static volatile boolean isAppSelfUpdatingColor = false;
+
+    // 控件引用
+    private ImageView ivColorPicker;   // 颜色预览拾取框
+    private ImageView ivColorScaler;   // 颜色渐变拾取框
+    private EditText etR;              // R分量输入框（显示实时调节值）
+    private EditText etG;              // G分量输入框（显示实时调节值）
+    private EditText etB;              // B分量输入框（显示实时调节值）
+    private EditText etColorValue;     // 颜色值输入框（#AARRGGBB，显示最终值）
+    private SeekBar sbAlpha;           // 透明度调节进度条（0-100%）
+    private TextView tvAlphaValue;     // 透明度数值显示（X%）
+    private TextView tvBrightnessMinus;// 亮度减少按钮（-）
+    private TextView tvBrightnessValue;// 亮度数值显示（X%，直观易懂）
+    private TextView tvBrightnessPlus; // 亮度增加按钮（+）
+    private TextView tvConfirm;        // 确认按钮
+    private TextView tvCancel;         // 取消按钮
+
+    // ====================== 构造方法（初始化核心数据，严格校验） ======================
+    public ColorPaletteDialog(Context context, int initialColor, OnColorSelectedListener listener) {
+        super(context, R.style.CustomDialogStyle);
+        this.mInitialColor = initialColor;
+        this.mListener = listener;
+
+        // 1. 强制回调非空，避免后续空指针（容错）
+        if (mListener == null) {
+            throw new IllegalArgumentException("OnColorSelectedListener can not be null!");
+        }
+
+        // 2. 解析初始颜色：原始基准值 = 实时值（初始无调节）
+        this.mOriginalAlpha = Color.alpha(initialColor);
+        this.mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+        this.mCurrentAlpha = mOriginalAlpha;
+        this.mCurrentAlphaPercent = mOriginalAlphaPercent;
+
+        this.mOriginalR = Color.red(initialColor);
+        this.mOriginalG = Color.green(initialColor);
+        this.mOriginalB = Color.blue(initialColor);
+        this.mCurrentR = mOriginalR;
+        this.mCurrentG = mOriginalG;
+        this.mCurrentB = mOriginalB;
+
+        // 3. 初始化当前状态（默认亮度100%，当前颜色=初始颜色）
+        this.mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+        this.mCurrentColor = initialColor;
+
+        LogUtils.d(TAG, String.format("init dialog success | 初始颜色：%s | 原始RGB：%d,%d,%d | 原始透明度：%s | 初始亮度：%s",
+									  String.format(FORMAT_COLOR_HEX, initialColor),
+									  mOriginalR, mOriginalG, mOriginalB,
+									  String.format(FORMAT_PERCENT, mOriginalAlphaPercent),
+									  String.format(FORMAT_PERCENT, mCurrentBrightnessPercent)));
+    }
+
+    // ====================== 生命周期方法（按执行顺序排列，逻辑清晰） ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        requestWindowFeature(Window.FEATURE_NO_TITLE); // 隐藏标题栏
+        View view = LayoutInflater.from(getContext()).inflate(R.layout.dialog_color_palette, null);
+        setContentView(view);
+
+        // 初始化流程：控件绑定→数据赋值→监听设置→尺寸适配（小米机型优先适配）
+        initViewBind(view);
+        initData();
+        initListener();
+        adjustDialogSize();
+        LogUtils.d(TAG, "dialog create complete | 适配小米API29-30机型");
+    }
+
+    @Override
+    public void dismiss() {
+        super.dismiss();
+        // 释放资源，避免内存泄漏（回调引用置空）
+        mListener = null;
+        LogUtils.d(TAG, "dialog dismiss | 释放资源完成");
+    }
+
+    // ====================== 初始化核心方法（职责单一，便于维护） ======================
+    /**
+     * 控件绑定
+     */
+    private void initViewBind(View view) {
+        ivColorPicker = view.findViewById(R.id.iv_color_picker);
+        ivColorScaler = view.findViewById(R.id.iv_color_scaler);
+        etR = view.findViewById(R.id.et_r);
+        etG = view.findViewById(R.id.et_g);
+        etB = view.findViewById(R.id.et_b);
+        etColorValue = view.findViewById(R.id.et_color_value);
+        sbAlpha = view.findViewById(R.id.sb_alpha);
+        tvAlphaValue = view.findViewById(R.id.tv_alpha_value);
+        tvBrightnessMinus = view.findViewById(R.id.tv_brightness_minus);
+        tvBrightnessValue = view.findViewById(R.id.tv_brightness_value);
+        tvBrightnessPlus = view.findViewById(R.id.tv_brightness_plus);
+        tvConfirm = view.findViewById(R.id.tv_confirm);
+        tvCancel = view.findViewById(R.id.tv_cancel);
+
+        // 控件非空校验（小米低版本容错，绑定失败直接关闭对话框）
+        if (ivColorPicker == null || ivColorScaler == null || etR == null || etG == null || etB == null || etColorValue == null
+			|| sbAlpha == null || tvAlphaValue == null
+			|| tvBrightnessMinus == null || tvBrightnessValue == null || tvBrightnessPlus == null
+			|| tvConfirm == null || tvCancel == null) {
+            LogUtils.e(TAG, "view bind failed | 请检查布局ID是否正确！");
+            dismiss();
+            return;
+        }
+        LogUtils.d(TAG, "view bind complete | 所有控件绑定成功");
+    }
+
+    /**
+     * 数据初始化（无监听状态下赋值，避免循环回调）
+     */
+    private void initData() {
+        // 1. 颜色预览（显示当前最终颜色，初始=原始颜色）
+        ivColorPicker.setBackgroundColor(mCurrentColor);
+
+        // 2. RGB输入框（显示「实时分量」，初始=原始值）
+        etR.setText(String.valueOf(mCurrentR));
+        etG.setText(String.valueOf(mCurrentG));
+        etB.setText(String.valueOf(mCurrentB));
+
+        // 3. 颜色值输入框（显示当前最终颜色，格式#AARRGGBB）
+        etColorValue.setText(String.format(FORMAT_COLOR_HEX, mCurrentColor));
+
+        // 4. 透明度控件（进度条+文本，初始=原始透明度）
+        sbAlpha.setProgress(mCurrentAlphaPercent);
+        tvAlphaValue.setText(String.format(FORMAT_PERCENT, mCurrentAlphaPercent));
+
+        // 5. 亮度控件（显示默认100%，初始化按钮状态）
+        tvBrightnessValue.setText(String.format(FORMAT_PERCENT, mCurrentBrightnessPercent));
+        updateBrightnessBtnStatus(); // 禁用边界值按钮
+
+        LogUtils.d(TAG, String.format("init data complete | 原始透明度：%s",
+									  String.format(FORMAT_PERCENT, mOriginalAlphaPercent)));
+    }
+
+    /**
+     * 监听初始化
+     */
+    private void initListener() {
+        // 点击监听（按钮+颜色拾取框）
+        ivColorPicker.setOnClickListener(this);
+        ivColorScaler.setOnClickListener(this);
+        tvConfirm.setOnClickListener(this);
+        tvCancel.setOnClickListener(this);
+        tvBrightnessMinus.setOnClickListener(this);
+        tvBrightnessPlus.setOnClickListener(this);
+        // 透明度进度条监听
+        sbAlpha.setOnSeekBarChangeListener(this);
+        // 输入框监听（RGB+颜色值，避免循环同步）
+        initTextWatcherListener();
+        LogUtils.d(TAG, "all listener init complete | 监听绑定成功");
+    }
+
+    /**
+     * 对话框尺寸适配（小米全面屏+软键盘优化，避免输入框被遮挡）
+     */
+    private void adjustDialogSize() {
+        Window window = getWindow();
+        if (window != null) {
+            WindowManager.LayoutParams lp = window.getAttributes();
+            // 宽度占屏幕80%，高度自适应（适配不同屏幕尺寸）
+            lp.width = (int) (getContext().getResources().getDisplayMetrics().widthPixels * 0.8);
+            lp.height = WindowManager.LayoutParams.WRAP_CONTENT;
+            // 软键盘适配：小米虚拟导航栏兼容
+            window.setAttributes(lp);
+            window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_PAN
+									| WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN);
+            LogUtils.d(TAG, "dialog size adjust complete | 适配全面屏+软键盘");
+        }
+    }
+
+    // ====================== 监听子方法（细分类型，逻辑清晰） ======================
+    /**
+     * 输入框文本监听（RGB+颜色值，传入触发ID避免循环同步）
+     */
+    private void initTextWatcherListener() {
+        // RGB输入框监听（复用方法，减少冗余）
+        setEditTextWatcher(etR, R.id.et_r);
+        setEditTextWatcher(etG, R.id.et_g);
+        setEditTextWatcher(etB, R.id.et_b);
+
+        // 颜色值输入框监听（支持#RRGGBB/#AARRGGBB格式）
+        etColorValue.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {}
+
+				@Override
+				public void afterTextChanged(Editable s) {
+					// 关键：判断非应用自身更新，才执行解析（避免循环回调）
+					if (!isAppSelfUpdatingColor) {
+						parseColorFromStr(s.toString().trim(), R.id.et_color_value);
+					}
+				}
+			});
+    }
+
+    // ====================== 透明度进度条监听实现 ======================
+    @Override
+    public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
+        // 仅处理用户手动拖动进度条（避免应用自身更新时触发）
+        if (fromUser && !isAppSelfUpdatingColor) {
+            updateAlphaBySeekBar(progress);
+        }
+    }
+
+    @Override
+    public void onStartTrackingTouch(SeekBar seekBar) {}
+
+    @Override
+    public void onStopTrackingTouch(SeekBar seekBar) {}
+
+    /**
+     * 拖动透明度进度条更新颜色
+     */
+    private synchronized void updateAlphaBySeekBar(int alphaPercent) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true; // 标记为应用自身更新
+            try {
+                // 更新实时透明度（百分比+0-255值）
+                mCurrentAlphaPercent = alphaPercent;
+                mCurrentAlpha = percent2Alpha(alphaPercent);
+                // 重新计算最终颜色（基于当前亮度+新透明度）
+                calculateBrightnessAndUpdate();
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("update alpha by seekbar | 透明度：%s",
+											  String.format(FORMAT_PERCENT, mCurrentAlphaPercent)));
+            } finally {
+                isAppSelfUpdatingColor = false; // 释放标记
+            }
+        }
+    }
+
+    // ====================== 颜色核心逻辑 ======================
+    /**
+     * 核心计算：基于原始RGB+当前亮度+当前透明度，计算实时RGB+最终颜色
+     */
+    private void calculateBrightnessAndUpdate() {
+        // 亮度百分比转调节系数（10%→0.1，100%→1.0，200%→2.0）
+        float brightnessFactor = mCurrentBrightnessPercent / 100.0f;
+
+        // RGB三个分量同时调节（基于原始基准值，避免叠加失真），限制0-255
+        mCurrentR = Math.min(Math.max(Math.round(mOriginalR * brightnessFactor), 0), MAX_RGB_VALUE);
+        mCurrentG = Math.min(Math.max(Math.round(mOriginalG * brightnessFactor), 0), MAX_RGB_VALUE);
+        mCurrentB = Math.min(Math.max(Math.round(mOriginalB * brightnessFactor), 0), MAX_RGB_VALUE);
+
+        // 拼接「实时透明度」+「实时RGB」，得到最终颜色（0xAARRGGBB）
+        mCurrentColor = Color.argb(mCurrentAlpha, mCurrentR, mCurrentG, mCurrentB);
+    }
+
+    /**
+     * 亮度减少（每次减5%，最低10%）
+     */
+    private void decreaseBrightness() {
+        changeBrightness(false);
+    }
+
+    /**
+     * 亮度增加（每次加5%，最高200%）
+     */
+    private void increaseBrightness() {
+        changeBrightness(true);
+    }
+
+    /**
+     * 亮度调节核心方法（统一逻辑，加并发控制）
+     */
+    private synchronized void changeBrightness(boolean isIncrease) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true;
+            try {
+                if (isIncrease) {
+                    if (mCurrentBrightnessPercent >= MAX_BRIGHTNESS) return;
+                    mCurrentBrightnessPercent += BRIGHTNESS_STEP;
+                } else {
+                    if (mCurrentBrightnessPercent <= MIN_BRIGHTNESS) return;
+                    mCurrentBrightnessPercent -= BRIGHTNESS_STEP;
+                }
+                // 计算亮度调节后的实时RGB+最终颜色
+                calculateBrightnessAndUpdate();
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("%s brightness | 亮度：%s | 实时RGB：%d,%d,%d",
+											  isIncrease ? "increase" : "decrease",
+											  String.format(FORMAT_PERCENT, mCurrentBrightnessPercent),
+											  mCurrentR, mCurrentG, mCurrentB));
+            } finally {
+                isAppSelfUpdatingColor = false;
+            }
+        }
+    }
+
+    /**
+     * 解析颜色字符串（支持#RRGGBB/#AARRGGBB，更新原始基准值+实时值）
+     */
+    private void parseColorFromStr(String colorStr, int triggerViewId) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true;
+            try {
+                if (TextUtils.isEmpty(colorStr)) return;
+
+                // 补全#前缀（兼容用户输入习惯）
+                if (!colorStr.startsWith("#")) {
+                    colorStr = "#" + colorStr;
+                }
+
+                // 格式校验（仅支持6位RRGGBB/8位AARRGGBB）
+                if (colorStr.length() != 7 && colorStr.length() != 9) {
+                    LogUtils.e(TAG, String.format("parse color failed | 格式错误（需#RRGGBB/#AARRGGBB），输入：%s", colorStr));
+                    return;
+                }
+
+                // 解析颜色
+                int parsedColor = Color.parseColor(colorStr);
+
+                // 更新原始基准值与实时值
+                mOriginalAlpha = Color.alpha(parsedColor);
+                mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+                mOriginalR = Color.red(parsedColor);
+                mOriginalG = Color.green(parsedColor);
+                mOriginalB = Color.blue(parsedColor);
+                mCurrentAlpha = mOriginalAlpha;
+                mCurrentAlphaPercent = mOriginalAlphaPercent;
+                mCurrentR = mOriginalR;
+                mCurrentG = mOriginalG;
+                mCurrentB = mOriginalB;
+                mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+                mCurrentColor = parsedColor;
+
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("parse color success | 解析颜色：%s | 透明度：%s | 重置亮度：%s",
+											  String.format(FORMAT_COLOR_HEX, parsedColor),
+											  String.format(FORMAT_PERCENT, mCurrentAlphaPercent),
+											  String.format(FORMAT_PERCENT, DEFAULT_BRIGHTNESS)));
+            } catch (IllegalArgumentException e) {
+                LogUtils.e(TAG, String.format("parse color failed | 非法颜色格式，输入：%s", colorStr), e);
+            } finally {
+                isAppSelfUpdatingColor = false;
+            }
+        }
+    }
+
+    /**
+     * 通过RGB输入框更新颜色（用户输入后，更新原始基准值+实时值，重置亮度为100%）
+     */
+    private synchronized void updateColorByRGB(int triggerViewId) {
+        if (!isAppSelfUpdatingColor) {
+            isAppSelfUpdatingColor = true;
+            try {
+                // 解析用户输入的RGB值（限制0-255，非法输入设为0）
+                int inputR = parseInputValue(etR.getText().toString());
+                int inputG = parseInputValue(etG.getText().toString());
+                int inputB = parseInputValue(etB.getText().toString());
+
+                // 更新原始基准值与实时值
+                mOriginalR = inputR;
+                mOriginalG = inputG;
+                mOriginalB = inputB;
+                mCurrentR = inputR;
+                mCurrentG = inputG;
+                mCurrentB = inputB;
+                mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+                mCurrentColor = Color.argb(mCurrentAlpha, mCurrentR, mCurrentG, mCurrentB);
+
+                // 同步所有控件
+                updateAllViews();
+                LogUtils.d(TAG, String.format("update color by RGB | 新原始RGB：%d,%d,%d | 透明度：%s | 重置亮度：%s",
+											  mOriginalR, mOriginalG, mOriginalB,
+											  String.format(FORMAT_PERCENT, mCurrentAlphaPercent),
+											  String.format(FORMAT_PERCENT, DEFAULT_BRIGHTNESS)));
+            } catch (Exception e) {
+                LogUtils.e(TAG, "update color by RGB failed", e);
+            } finally {
+                isAppSelfUpdatingColor = false;
+            }
+        }
+    }
+
+    /**
+     * 核心同步：更新所有控件显示
+     */
+    private void updateAllViews() {
+        // 1. 同步颜色预览
+        ivColorPicker.setBackgroundColor(mCurrentColor);
+
+        // 2. 同步RGB输入框
+        etR.setText(String.valueOf(mCurrentR));
+        etG.setText(String.valueOf(mCurrentG));
+        etB.setText(String.valueOf(mCurrentB));
+
+        // 3. 同步颜色值输入框
+        etColorValue.setText(String.format(FORMAT_COLOR_HEX, mCurrentColor));
+
+        // 4. 同步透明度控件
+        sbAlpha.setProgress(mCurrentAlphaPercent);
+        tvAlphaValue.setText(String.format(FORMAT_PERCENT, mCurrentAlphaPercent));
+
+        // 5. 同步亮度控件
+        tvBrightnessValue.setText(String.format(FORMAT_PERCENT, mCurrentBrightnessPercent));
+        updateBrightnessBtnStatus();
+
+        LogUtils.d(TAG, String.format("sync all views complete | 最终颜色：%s | 实时RGB：%d,%d,%d | 透明度：%s | 亮度：%s",
+									  String.format(FORMAT_COLOR_HEX, mCurrentColor),
+									  mCurrentR, mCurrentG, mCurrentB,
+									  String.format(FORMAT_PERCENT, mCurrentAlphaPercent),
+									  String.format(FORMAT_PERCENT, mCurrentBrightnessPercent)));
+    }
+
+    /**
+     * 更新亮度按钮状态（边界值禁用，提升交互体验）
+     */
+    private void updateBrightnessBtnStatus() {
+        boolean canMinus = mCurrentBrightnessPercent > MIN_BRIGHTNESS;
+        boolean canPlus = mCurrentBrightnessPercent < MAX_BRIGHTNESS;
+
+        tvBrightnessMinus.setEnabled(canMinus);
+        tvBrightnessPlus.setEnabled(canPlus);
+        tvBrightnessMinus.setTextColor(canMinus ? Color.BLACK : Color.parseColor("#CCCCCC"));
+        tvBrightnessPlus.setTextColor(canPlus ? Color.BLACK : Color.parseColor("#CCCCCC"));
+    }
+
+    // ====================== 工具方法 ======================
+    /**
+     * 透明度：0-255 → 0-100%
+     */
+    private int alpha2Percent(int alpha) {
+        return Math.round((float) alpha / MAX_RGB_VALUE * MAX_ALPHA_PERCENT);
+    }
+
+    /**
+     * 透明度：0-100% → 0-255
+     */
+    private int percent2Alpha(int percent) {
+        return Math.round((float) percent / MAX_ALPHA_PERCENT * MAX_RGB_VALUE);
+    }
+
+    /**
+     * 解析输入值（限制0-255，非法输入返回0）
+     */
+    private int parseInputValue(String input) {
+        if (TextUtils.isEmpty(input)) return 0;
+        try {
+            int value = Integer.parseInt(input);
+            return Math.min(Math.max(value, 0), MAX_RGB_VALUE);
+        } catch (NumberFormatException e) {
+            LogUtils.e(TAG, String.format("parse input failed | 非法数字，输入：%s", input), e);
+            return 0;
+        }
+    }
+
+    /**
+     * RGB输入框监听复用
+     */
+    private void setEditTextWatcher(EditText editText, final int viewId) {
+        editText.addTextChangedListener(new TextWatcher() {
+				@Override
+				public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+				@Override
+				public void onTextChanged(CharSequence s, int start, int before, int count) {}
+
+				@Override
+				public void afterTextChanged(Editable s) {
+					if (!isAppSelfUpdatingColor) {
+						updateColorByRGB(viewId);
+					}
+				}
+			});
+    }
+
+    /**
+     * dp转px（适配小米不同分辨率）
+     */
+    private int dp2px(float dp) {
+        return (int) (dp * getContext().getResources().getDisplayMetrics().density + 0.5f);
+    }
+
+    /**
+     * 显示系统颜色选择器（兼容API29-30，无高版本依赖，小米机型适配）
+     */
+    private void showSystemColorPicker() {
+        LogUtils.d(TAG, "show system color picker | 兼容小米API29-30，支持横向滚动");
+        final android.app.AlertDialog.Builder builder = new android.app.AlertDialog.Builder(getContext());
+        builder.setTitle("选择基础颜色");
+
+        // 50种常用颜色：按彩虹光谱顺序排列
+        final int[] systemColors = {
+			0xFFCC0000, 0xFFFF0000, 0xFFFF6666, 0xFFFF1493, 0xFF8B0000, 0xFFFF4500,
+			0xFFCC6600, 0xFFFF8800, 0xFFFFAA33, 0xFFFFBB00, 0xFFF5A623,
+			0xFFCCCC00, 0xFFFFFF00, 0xFFFFEE99, 0xFFFFFACD, 0xFFFFD700,
+			0xFF006600, 0xFF00FF00, 0xFF99FF99, 0xFF66CC66, 0xFF98FB98, 0xFF00FF99, 0xFF003300,
+			0xFF006666, 0xFF00FFFF, 0xFF99FFFF, 0xFF00CCCC, 0xFF40E0D0,
+			0xFF0000CC, 0xFF00008B, 0xFF0000FF, 0xFF6666FF, 0xFF87CEEB, 0xFF0066FF, 0xFF0099FF, 0xFF4B0082,
+			0xFF660099, 0xFF8800FF, 0xFFAA99FF, 0xFF9370DB, 0xFFCBC3E3, 0xFF8A2BE2,
+			0xFFFF00FF, 0xFFFF99CC, 0xFFFFCCDD, 0xFFFFB6C1, 0xFFFFA5A5,
+			0xFF8B4513, 0xFFA0522D, 0xFFD2B48C, 0xFFCD853F,
+			0xFF333333, 0xFF666666, 0xFF888888, 0xFFAAAAAA, 0xFFCCCCCC, 0xFFE6E6E6,
+			0xFF000000, 0xFFFFFFFF, 0xFFFFFAFA
+        };
+
+        // 1. 第一级：水平滚动容器
+        HorizontalScrollView horizontalScrollView = new HorizontalScrollView(getContext());
+        horizontalScrollView.setHorizontalScrollBarEnabled(true);
+        horizontalScrollView.setScrollBarStyle(View.SCROLLBARS_INSIDE_OVERLAY);
+        horizontalScrollView.setPadding(dp2px(5), dp2px(5), dp2px(5), dp2px(5));
+
+        // 2. 第二级：颜色排列容器（横向）
+        LinearLayout colorLayout = new LinearLayout(getContext());
+        colorLayout.setOrientation(LinearLayout.HORIZONTAL);
+        colorLayout.setGravity(Gravity.CENTER_VERTICAL);
+        colorLayout.setPadding(dp2px(10), dp2px(10), dp2px(10), dp2px(10));
+
+        // 3. 循环添加颜色按钮（内置圆形效果）
+        for (int i = 0; i < systemColors.length; i++) {
+            final int color = systemColors[i];
+            ImageView colorBtn = new ImageView(getContext());
+            LinearLayout.LayoutParams lp = new LinearLayout.LayoutParams(dp2px(40), dp2px(40));
+            if (i != systemColors.length - 1) {
+                lp.setMargins(0, 0, dp2px(10), 0); // 按钮间距
+            }
+            colorBtn.setLayoutParams(lp);
+
+            // 内置圆形背景（白色边框+圆形形状）
+            GradientDrawable circleBg = new GradientDrawable();
+            circleBg.setShape(GradientDrawable.OVAL);
+            circleBg.setColor(color);
+            circleBg.setStroke(dp2px(2), Color.WHITE);
+            colorBtn.setBackground(circleBg);
+
+            colorBtn.setClickable(true);
+            colorBtn.setFocusable(true);
+
+            // 点击事件
+            colorBtn.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						if (!isAppSelfUpdatingColor) {
+							isAppSelfUpdatingColor = true;
+							try {
+								mOriginalAlpha = Color.alpha(color);
+								mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+								mOriginalR = Color.red(color);
+								mOriginalG = Color.green(color);
+								mOriginalB = Color.blue(color);
+								mCurrentAlpha = mOriginalAlpha;
+								mCurrentAlphaPercent = mOriginalAlphaPercent;
+								mCurrentR = mOriginalR;
+								mCurrentG = mOriginalG;
+								mCurrentB = mOriginalB;
+								mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+								mCurrentColor = color;
+								updateAllViews();
+								builder.create().dismiss();
+								LogUtils.d(TAG, String.format("select system color | 选择颜色：%s | 透明度：%s",
+															  String.format(FORMAT_COLOR_HEX, color),
+															  String.format(FORMAT_PERCENT, mCurrentAlphaPercent)));
+							} finally {
+								isAppSelfUpdatingColor = false;
+							}
+						}
+					}
+				});
+            colorLayout.addView(colorBtn);
+        }
+
+        // 层级嵌套
+        horizontalScrollView.addView(colorLayout);
+        builder.setView(horizontalScrollView).setNegativeButton("关闭", null).show();
+    }
+
+    // ====================== 点击事件实现 ======================
+    @Override
+    public void onClick(View v) {
+        int id = v.getId();
+        // 所有点击事件均加并发判断
+        if (!isAppSelfUpdatingColor) {
+            if (id == R.id.iv_color_picker) {
+                showSystemColorPicker();
+            } else if (id == R.id.iv_color_scaler) {
+                openColorScalerDialog(mCurrentColor);
+            } else if (id == R.id.tv_confirm) {
+                mListener.onColorSelected(mCurrentColor);
+                LogUtils.d(TAG, String.format("confirm color | 回调颜色：%s",
+											  String.format(FORMAT_COLOR_HEX, mCurrentColor)));
+                dismiss();
+            } else if (id == R.id.tv_cancel) {
+                dismiss();
+                LogUtils.d(TAG, "cancel color | 取消选择，关闭对话框");
+            } else if (id == R.id.tv_brightness_minus) {
+                decreaseBrightness();
+            } else if (id == R.id.tv_brightness_plus) {
+                increaseBrightness();
+            }
+        }
+    }
+
+    /**
+     * 打开颜色渐变选择器
+     */
+    void openColorScalerDialog(int nColor) {
+        LogUtils.d(TAG, String.format("openColorScalerDialog | 初始颜色：%s",
+									  String.format(FORMAT_COLOR_HEX, nColor)));
+        final ColorScalerDialog dlg = new ColorScalerDialog(getContext(), nColor);
+        dlg.setOnColorChangedListener(new OnColorChangedListener() {
+				@Override
+				public void beforeColorChanged() {}
+
+				@Override
+				public void onColorChanged(int color) {
+					dlg.currentColorScalerDialogColor = color;
+				}
+
+				@Override
+				public void afterColorChanged() {}
+			});
+        dlg.show();
+    }
+
+    // ====================== 内部类 ======================
+    class ColorScalerDialog extends ColorPickerDialog {
+        public int currentColorScalerDialogColor = 0;
+
+        public ColorScalerDialog(Context context, int p) {
+            super(context, p);
+            this.currentColorScalerDialogColor = p;
+        }
+
+        @Override
+        public void dismiss() {
+            super.dismiss();
+            int color = currentColorScalerDialogColor;
+            ToastUtils.show(String.format("选择颜色：%s", String.format(FORMAT_COLOR_HEX, color)));
+            if (!isAppSelfUpdatingColor) {
+                isAppSelfUpdatingColor = true;
+                try {
+                    mOriginalAlpha = Color.alpha(color);
+                    mOriginalAlphaPercent = alpha2Percent(mOriginalAlpha);
+                    mOriginalR = Color.red(color);
+                    mOriginalG = Color.green(color);
+                    mOriginalB = Color.blue(color);
+                    mCurrentAlpha = mOriginalAlpha;
+                    mCurrentAlphaPercent = mOriginalAlphaPercent;
+                    mCurrentR = mOriginalR;
+                    mCurrentG = mOriginalG;
+                    mCurrentB = mOriginalB;
+                    mCurrentBrightnessPercent = DEFAULT_BRIGHTNESS;
+                    mCurrentColor = color;
+                    updateAllViews();
+                    LogUtils.d(TAG, String.format("select scaler color | 选择颜色：%s | 透明度：%s",
+												  String.format(FORMAT_COLOR_HEX, color),
+												  String.format(FORMAT_PERCENT, mCurrentAlphaPercent)));
+                } finally {
+                    isAppSelfUpdatingColor = false;
+                }
+            }
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/NetworkBackgroundDialog.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/NetworkBackgroundDialog.java
new file mode 100644
index 0000000..b90fd56
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/dialogs/NetworkBackgroundDialog.java
@@ -0,0 +1,340 @@
+package cc.winboll.studio.powerbell.dialogs;
+
+import android.content.Context;
+import android.content.DialogInterface;
+import android.os.Handler;
+import android.os.Message;
+import android.text.TextUtils;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.appcompat.app.AlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.ImageDownloader;
+import cc.winboll.studio.powerbell.views.BackgroundView;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/19 20:11
+ * @Describe 网络背景使用提示对话框
+ * 继承 AndroidX AlertDialog，绑定自定义布局 dialog_networkbackground.xml
+ * 适配 API30，基于 Java7 开发，支持网络图片下载、预览与回调
+ */
+public class NetworkBackgroundDialog extends AlertDialog {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    public static final String TAG = "NetworkBackgroundDialog";
+    private static final int MSG_IMAGE_LOAD_SUCCESS = 1001; // 图片加载成功消息标识
+    private static final int MSG_IMAGE_LOAD_FAILED = 1002; // 图片加载失败消息标识
+
+    // ====================== 回调接口（紧跟常量，逻辑关联） ======================
+    /**
+     * 按钮点击回调接口（Java7 接口实现）
+     */
+    public interface OnDialogClickListener {
+        void onConfirm(String szConfirmFilePath); // 确认按钮点击，返回图片路径
+        void onCancel();                          // 取消按钮点击
+    }
+
+    // ====================== 成员变量（按优先级排序：核心数据→控件引用） ======================
+    // 核心数据
+    private OnDialogClickListener listener;       // 按钮点击回调
+    private Context mContext;                     // 上下文对象
+    private Handler mUiHandler;                   // 主线程 Handler，用于接收子线程消息更新 UI
+    private String mPreviewFilePath;              // 预览图片文件路径
+    private String mPreviewFileUrl;               // 预览图片网络 URL
+    private String mDownloadSavedPath;            // 下载图片保存路径
+    // 控件引用
+    private TextView tvTitle;                     // 对话框标题
+    private TextView tvContent;                   // 对话框内容
+    private Button btnCancel;                     // 取消按钮
+    private Button btnConfirm;                    // 确认按钮
+    private Button btnPreview;                    // 预览按钮
+    private EditText etURL;                       // URL 输入框
+    private BackgroundView mBackgroundView;       // 背景预览视图
+
+    // ====================== 构造方法（Java7 显式构造，按参数重载排序） ======================
+    /**
+     * 基础构造（仅传入 Context）
+     * @param context 上下文
+     */
+    public NetworkBackgroundDialog(@NonNull Context context) {
+        super(context);
+        LogUtils.d(TAG, "NetworkBackgroundDialog: 基础构造初始化");
+        initHandler();
+        initView();
+        setDismissListener();
+    }
+
+    /**
+     * 带回调的构造（便于外部处理点击事件）
+     * @param context 上下文
+     * @param listener 按钮点击回调
+     */
+    public NetworkBackgroundDialog(@NonNull Context context, OnDialogClickListener listener) {
+        super(context);
+        this.listener = listener;
+        LogUtils.d(TAG, "NetworkBackgroundDialog: 带回调构造初始化");
+        initHandler();
+        initView();
+        setDismissListener();
+    }
+
+    // ====================== 生命周期相关方法（对话框消失监听、Handler 初始化） ======================
+    /**
+     * 初始化主线程 Handler，用于接收子线程消息并更新 UI
+     */
+    private void initHandler() {
+        mUiHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                // 对话框已消失时，不再处理 UI 消息
+                if (!isShowing()) {
+                    LogUtils.d(TAG, "handleMessage: 对话框已消失，忽略消息");
+                    return;
+                }
+                switch (msg.what) {
+                    case MSG_IMAGE_LOAD_SUCCESS:
+                        // 图片加载成功，获取文件路径并设置背景
+                        mDownloadSavedPath = (String) msg.obj;
+                        LogUtils.d(TAG, String.format("handleMessage: 图片加载成功，保存路径：%s", mDownloadSavedPath));
+						int nCurrentPixelColor = BackgroundSourceUtils.getInstance(mContext).getCurrentBackgroundBean().getPixelColor();
+						
+                        mBackgroundView.loadImage(nCurrentPixelColor, mDownloadSavedPath, true);
+                        break;
+                    case MSG_IMAGE_LOAD_FAILED:
+                        // 图片加载失败，设置默认背景
+                        LogUtils.e(TAG, "handleMessage: 图片加载失败");
+                        mBackgroundView.setBackgroundResource(R.drawable.ic_launcher);
+                        ToastUtils.show("图片预览失败，请检查链接");
+                        break;
+                    default:
+                        break;
+                }
+            }
+        };
+        LogUtils.d(TAG, "initHandler: 主线程 Handler 初始化完成");
+    }
+
+    /**
+     * 设置对话框消失监听：移除 Handler 消息，避免内存泄漏
+     */
+    private void setDismissListener() {
+        this.setOnDismissListener(new OnDismissListener() {
+				@Override
+				public void onDismiss(DialogInterface dialog) {
+					// 对话框消失时，移除所有未处理的消息和回调
+					if (mUiHandler != null) {
+						mUiHandler.removeCallbacksAndMessages(null);
+						LogUtils.d(TAG, "onDismiss: Handler 消息已清理");
+					}
+					LogUtils.d(TAG, "onDismiss: 对话框已消失");
+				}
+			});
+        LogUtils.d(TAG, "setDismissListener: 对话框消失监听已设置");
+    }
+
+    // ====================== 初始化方法（布局、控件、点击事件） ======================
+    /**
+     * 初始化布局和控件
+     */
+    private void initView() {
+        mContext = this.getContext();
+        // 加载自定义布局
+        View dialogView = LayoutInflater.from(getContext()).inflate(R.layout.dialog_networkbackground, null);
+        // 设置对话框内容视图
+        setView(dialogView);
+
+        // 绑定控件
+        tvTitle = (TextView) dialogView.findViewById(R.id.tv_dialog_title);
+        tvContent = (TextView) dialogView.findViewById(R.id.tv_dialog_content);
+        btnCancel = (Button) dialogView.findViewById(R.id.btn_cancel);
+        btnConfirm = (Button) dialogView.findViewById(R.id.btn_confirm);
+        btnPreview = (Button) dialogView.findViewById(R.id.btn_preview);
+        etURL = (EditText) dialogView.findViewById(R.id.et_url);
+        mBackgroundView = (BackgroundView) dialogView.findViewById(R.id.bv_background_preview);
+
+        // 控件非空校验
+        if (tvTitle == null || tvContent == null || btnCancel == null || btnConfirm == null || btnPreview == null
+			|| etURL == null || mBackgroundView == null) {
+            LogUtils.e(TAG, "initView: 控件绑定失败，请检查布局ID是否正确");
+            dismiss();
+            return;
+        }
+
+        // 加载初始图片
+        mBackgroundView.setBackgroundResource(R.drawable.blank100x100);
+        // 设置按钮点击事件
+        setButtonClickListeners();
+
+        LogUtils.d(TAG, "initView: 布局和控件初始化完成");
+    }
+
+    /**
+     * 设置按钮点击监听
+     */
+    private void setButtonClickListeners() {
+        // 取消按钮：关闭对话框 + 回调外部
+        btnCancel.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "onClick: 取消按钮点击");
+					BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(mContext);
+					utils.setCurrentSourceToPreview();
+
+					dismiss(); // 关闭对话框
+					if (listener != null) {
+						listener.onCancel();
+						LogUtils.d(TAG, "onClick: 取消回调已执行");
+					}
+				}
+			});
+
+        // 确认按钮：关闭对话框 + 回调外部
+        btnConfirm.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "onClick: 确认按钮点击");
+					dismiss(); // 关闭对话框
+					if (TextUtils.isEmpty(mDownloadSavedPath)) {
+						ToastUtils.show("未下载图片。");
+						LogUtils.w(TAG, "onClick: 确认失败，未下载图片");
+						return;
+					}
+					if (listener != null) {
+						listener.onConfirm(mDownloadSavedPath);
+						LogUtils.d(TAG, String.format("onClick: 确认回调已执行，图片路径：%s", mDownloadSavedPath));
+					}
+				}
+			});
+
+        // 图片预览按钮：预览输入框地址图片
+        btnPreview.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "onClick: 预览按钮点击");
+					downloadImageToAlbumAndPreview();
+				}
+			});
+
+        LogUtils.d(TAG, "setButtonClickListeners: 按钮点击监听已设置");
+    }
+
+    // ====================== 业务逻辑方法（图片下载、预览） ======================
+    /**
+     * 下载网络图片并预览
+     */
+    void downloadImageToAlbumAndPreview() {
+        mPreviewFileUrl = etURL.getText().toString().trim();
+        if (TextUtils.isEmpty(mPreviewFileUrl)) {
+            ToastUtils.show("请输入图片URL");
+            LogUtils.w(TAG, "downloadImageToAlbumAndPreview: 图片URL为空");
+            return;
+        }
+
+        LogUtils.d(TAG, String.format("downloadImageToAlbumAndPreview: 开始下载图片，URL：%s", mPreviewFileUrl));
+        ImageDownloader.getInstance(mContext).downloadImage(mPreviewFileUrl, new ImageDownloader.DownloadCallback() {
+				@Override
+				public void onSuccess(String savePath) {
+					LogUtils.d(TAG, String.format("onSuccess: 图片下载成功，保存路径：%s", savePath));
+					// 发送消息到主线程，携带图片路径
+					Message successMsg = mUiHandler.obtainMessage(MSG_IMAGE_LOAD_SUCCESS, savePath);
+					mUiHandler.sendMessage(successMsg);
+				}
+
+				@Override
+				public void onFailure(String errorMsg) {
+					LogUtils.e(TAG, String.format("onFailure: 图片下载失败，错误信息：%s", errorMsg));
+					ToastUtils.show("下载失败：" + errorMsg);
+					// 发送图片加载失败消息
+					Message failMsg = mUiHandler.obtainMessage(MSG_IMAGE_LOAD_FAILED);
+					mUiHandler.sendMessage(failMsg);
+				}
+			});
+    }
+
+    /**
+     * 根据文件路径设置 BackgroundView 背景（主线程调用）
+     * @param previewFilePath 图片文件路径
+     */
+    private void previewBackground(String previewFilePath) {
+        if (TextUtils.isEmpty(previewFilePath)) {
+            LogUtils.w(TAG, "previewBackground: 预览文件路径为空");
+            return;
+        }
+
+        FileInputStream fis = null;
+        try {
+            File imageFile = new File(previewFilePath);
+            if (!imageFile.exists()) {
+                ToastUtils.show("图片文件不存在：" + previewFilePath);
+                LogUtils.e(TAG, String.format("previewBackground: 图片文件不存在，路径：%s", previewFilePath));
+                mBackgroundView.setBackgroundResource(R.drawable.ic_launcher);
+                return;
+            }
+
+            // 预览背景
+            mPreviewFilePath = previewFilePath;
+            BackgroundSourceUtils utils = BackgroundSourceUtils.getInstance(mContext);
+            utils.saveFileToPreviewBean(new File(mPreviewFilePath), mPreviewFileUrl);
+            mBackgroundView.loadByBackgroundBean(utils.getPreviewBackgroundBean());
+
+            LogUtils.d(TAG, String.format("previewBackground: 图片预览成功，路径：%s", previewFilePath));
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("previewBackground: 图片预览失败，错误信息：%s", e.getMessage()), e);
+            mBackgroundView.setBackgroundResource(R.drawable.ic_launcher);
+        } finally {
+            // Java7 手动关闭流，避免资源泄漏
+            if (fis != null) {
+                try {
+                    fis.close();
+                    LogUtils.d(TAG, "previewBackground: 文件输入流已关闭");
+                } catch (IOException e) {
+                    LogUtils.e(TAG, String.format("previewBackground: 关闭文件输入流失败，错误信息：%s", e.getMessage()), e);
+                }
+            }
+        }
+    }
+
+    // ====================== 对外提供方法（灵活适配不同场景） ======================
+    /**
+     * 对外提供方法：修改对话框标题
+     * @param title 标题文本
+     */
+    public void setTitle(String title) {
+        if (tvTitle != null && !TextUtils.isEmpty(title)) {
+            tvTitle.setText(title);
+            LogUtils.d(TAG, String.format("setTitle: 对话框标题已修改为：%s", title));
+        }
+    }
+
+    /**
+     * 对外提供方法：修改对话框内容
+     * @param content 内容文本
+     */
+    public void setContent(String content) {
+        if (tvContent != null && !TextUtils.isEmpty(content)) {
+            tvContent.setText(content);
+            LogUtils.d(TAG, String.format("setContent: 对话框内容已修改为：%s", content));
+        }
+    }
+
+    /**
+     * 对外提供方法：设置按钮点击回调（替代带参构造）
+     * @param listener 按钮点击回调
+     */
+    public void setOnDialogClickListener(OnDialogClickListener listener) {
+        this.listener = listener;
+        LogUtils.d(TAG, "setOnDialogClickListener: 按钮点击回调已设置");
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/handlers/ControlCenterServiceHandler.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/handlers/ControlCenterServiceHandler.java
new file mode 100644
index 0000000..eb349d4
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/handlers/ControlCenterServiceHandler.java
@@ -0,0 +1,122 @@
+package cc.winboll.studio.powerbell.handlers;
+
+import android.os.Handler;
+import android.os.Message;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.models.NotificationMessage;
+import cc.winboll.studio.powerbell.models.ThoughtfulServiceBean;
+import cc.winboll.studio.powerbell.services.ControlCenterService;
+import cc.winboll.studio.powerbell.threads.TTSRemindThread;
+import java.lang.ref.WeakReference;
+
+/**
+ * 服务通信Handler
+ * 功能：处理电量提醒消息，构建并发送标准化通知
+ * 特性：弱引用防泄漏、参数严格校验、通知格式统一
+ * 适配：Java7 | API30 | 小米手机
+ */
+public class ControlCenterServiceHandler extends Handler {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "ControlCenterServiceHandler";
+    public static final int MSG_REMIND_TEXT = 1001; // 电量提醒消息标识
+
+    // 提醒类型常量
+    private static final String REMIND_TYPE_CHARGE = "+";
+    private static final String REMIND_TYPE_USAGE = "-";
+
+    // 电量范围常量
+    private static final int BATTERY_LEVEL_MIN = 0;
+    private static final int BATTERY_LEVEL_MAX = 100;
+
+    // 通知文案常量（抽离魔法值，便于统一修改）
+    private static final String CHARGE_REMIND_TITLE = "充电提醒";
+    private static final String USAGE_REMIND_TITLE = "耗电提醒";
+    private static final String CHARGE_REMIND_CONTENT_FORMAT = "(+)电量已达额定值。当前电量%d%%，%s。";
+    private static final String USAGE_REMIND_CONTENT_FORMAT = "(-)电量低于指定值。当前电量%d%%，%s。";
+    private static final String CHARGE_STATE_CHARGING = "充电中";
+    private static final String CHARGE_STATE_NOT_CHARGING = "未充电";
+
+    // ================================== 成员变量区（弱引用防泄漏，final保证不可变）=================================
+    private final WeakReference<ControlCenterService> mwrControlCenterService;
+
+    // ================================== 构造方法（强制传入服务，初始化弱引用）=================================
+    public ControlCenterServiceHandler(ControlCenterService service) {
+        LogUtils.d(TAG, "构造方法执行 | service=" + (service != null ? service.getClass().getSimpleName() : "null"));
+        this.mwrControlCenterService = new WeakReference<>(service);
+    }
+
+    // ================================== 核心消息处理（重写handleMessage，解析多参数消息）=================================
+    @Override
+    public void handleMessage(Message msg) {
+        super.handleMessage(msg);
+        // 解析消息参数：obj=提醒类型(+/-)，arg1=当前电量，arg2=充电状态(1=充电/0=未充电)
+        String remindType = (msg.obj != null) ? (String) msg.obj : "";
+        int currentBattery = msg.arg1;
+        boolean isCharging = msg.arg2 == 1;
+
+        LogUtils.d(TAG, "handleMessage: 接收消息 | what=" + msg.what + " | type=" + remindType + " | battery=" + currentBattery + " | isCharging=" + isCharging);
+
+        // 弱引用获取服务，避免内存泄漏
+        ControlCenterService service = mwrControlCenterService.get();
+        if (service == null) {
+            LogUtils.e(TAG, "handleMessage: 服务实例已被GC回收，终止消息处理");
+            return;
+        }
+
+        // 按消息类型分发处理
+        switch (msg.what) {
+            case MSG_REMIND_TEXT:
+                handleRemindMessage(service, remindType, currentBattery, isCharging);
+                break;
+            default:
+                LogUtils.w(TAG, "handleMessage: 未知消息类型，忽略处理 | what=" + msg.what);
+                break;
+        }
+    }
+
+    // ================================== 业务辅助方法（构建通知并发送，全链路参数校验）=================================
+    /**
+     * 处理电量提醒消息，构建带电量+充电状态的通知并发送
+     * @param service         控制中心服务实例（已校验非空）
+     * @param remindType      提醒类型（+充电/-耗电）
+     * @param currentBattery  当前电量（0-100）
+     * @param isCharging      充电状态
+     */
+    private void handleRemindMessage(ControlCenterService service, String remindType, int currentBattery, boolean isCharging) {
+        LogUtils.d(TAG, "handleRemindMessage: 开始处理提醒消息 | type=" + remindType + " | battery=" + currentBattery + " | isCharging=" + isCharging);
+
+        // 1. 前置校验：通知工具类+参数有效性
+        if (service.getNotificationManager() == null) {
+            LogUtils.e(TAG, "handleRemindMessage: 通知管理工具类未初始化，无法发送提醒");
+            return;
+        }
+        if (!REMIND_TYPE_CHARGE.equals(remindType) && !REMIND_TYPE_USAGE.equals(remindType)) {
+            LogUtils.w(TAG, "handleRemindMessage: 提醒类型无效，忽略 | type=" + remindType + " | 允许值：" + REMIND_TYPE_CHARGE + "/" + REMIND_TYPE_USAGE);
+            return;
+        }
+        if (currentBattery < BATTERY_LEVEL_MIN || currentBattery > BATTERY_LEVEL_MAX) {
+            LogUtils.w(TAG, "handleRemindMessage: 电量值超出范围，忽略 | battery=" + currentBattery + " | 允许范围：" + BATTERY_LEVEL_MIN + "-" + BATTERY_LEVEL_MAX);
+            return;
+        }
+
+        // 2. 构建通知模型，使用统一格式
+        NotificationMessage remindMsg = new NotificationMessage();
+        String chargeStateDesc = isCharging ? CHARGE_STATE_CHARGING : CHARGE_STATE_NOT_CHARGING;
+        if (REMIND_TYPE_CHARGE.equals(remindType)) {
+            remindMsg.setTitle(CHARGE_REMIND_TITLE);
+            remindMsg.setContent(String.format(CHARGE_REMIND_CONTENT_FORMAT, currentBattery, chargeStateDesc));
+            remindMsg.setRemindMSG("charge_remind");
+        } else {
+            remindMsg.setTitle(USAGE_REMIND_TITLE);
+            remindMsg.setContent(String.format(USAGE_REMIND_CONTENT_FORMAT, currentBattery, chargeStateDesc));
+            remindMsg.setRemindMSG("usage_remind");
+        }
+        LogUtils.d(TAG, "handleRemindMessage: 通知模型构建完成 | title=" + remindMsg.getTitle() + " | content=" + remindMsg.getContent());
+
+        // 3. 调用通知工具类发送提醒
+        LogUtils.d(TAG, "handleRemindMessage: 调用通知工具类发送提醒 | remindMSG=" + remindMsg.getRemindMSG());
+        service.getNotificationManager().showRemindNotification(service, remindMsg);
+        LogUtils.d(TAG, "handleRemindMessage: 提醒通知发送流程执行完毕");
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/AppConfigBean.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/AppConfigBean.java
new file mode 100644
index 0000000..0b26a0e
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/AppConfigBean.java
@@ -0,0 +1,274 @@
+package cc.winboll.studio.powerbell.models;
+
+import android.os.Parcel;
+import android.os.Parcelable;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+import java.io.Serializable;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/04/29 17:24:53
+ * @Describe 应用运行参数类
+ * 适配 API30，支持 Serializable 持久化、Parcelable Intent 传递、JSON 序列化/反序列化
+ * 包含耗电提醒、充电提醒、电量检测、铃声提醒、相框尺寸等核心配置
+ */
+public class AppConfigBean extends BaseBean implements Serializable, Parcelable {
+    // ====================== 静态常量区（首屏可见，统一管理） ======================
+    // 序列化版本号（Serializable 必备，避免反序列化失败）
+    private static final long serialVersionUID = 1L;
+    // 日志标签（全局统一）
+    transient public static final String TAG = "AppConfigBean";
+    // 字段校验常量（统一阈值，避免硬编码）
+    private static final int MIN_INTERVAL = 500;        // 最小检测间隔（ms）
+    private static final int MIN_REMIND_INTERVAL = 1000;// 最小提醒间隔（ms）
+    private static final int BATTERY_MIN = 0;           // 电量最小值
+    private static final int BATTERY_MAX = 100;         // 电量最大值
+    private static final int INVALID_BATTERY = -1;      // 无效电量标识
+    private static final int DEFAULT_FRAME_WIDTH = 500; // 默认相框宽度（px）
+    private static final int DEFAULT_FRAME_HEIGHT = 500;// 默认相框高度（px）
+
+    // ====================== 成员变量区（按功能分类：提醒配置→电量状态→检测配置→相框配置） ======================
+    // 耗电提醒配置
+    boolean isEnableUsageReminder = false; // 耗电提醒开关
+    int usageReminderValue = 45;           // 耗电提醒阈值（0-100）
+    // 充电提醒配置
+    boolean isEnableChargeReminder = false;// 充电提醒开关
+    int chargeReminderValue = 100;         // 充电提醒阈值（0-100）
+    // 铃声提醒配置
+    int reminderIntervalTime = 5000;       // 铃声提醒间隔（ms）
+    // 电量状态
+    boolean isCharging = false;            // 是否充电
+    // 电量检测配置
+    int batteryDetectInterval = 2000;      // 电量检测间隔（ms，适配 RemindThread）
+    // 相框配置
+    int defaultFrameWidth = DEFAULT_FRAME_WIDTH;  // 默认相框宽度（px）
+    int defaultFrameHeight = DEFAULT_FRAME_HEIGHT;// 默认相框高度（px）
+
+    // ====================== 构造方法（初始化默认配置，强化默认值校验） ======================
+    public AppConfigBean() {
+        setChargeReminderValue(100);
+        setEnableChargeReminder(false);
+        setUsageReminderValue(10);
+        setEnableUsageReminder(false);
+        setReminderIntervalTime(5000);
+        setBatteryDetectInterval(1000);
+        setDefaultFrameWidth(DEFAULT_FRAME_WIDTH);
+        setDefaultFrameHeight(DEFAULT_FRAME_HEIGHT);
+        LogUtils.d(TAG, "AppConfigBean() 构造器执行 | 默认配置初始化完成");
+    }
+
+    // ====================== 核心业务方法（Setter/Getter，按字段功能分类，补充调试日志） ======================
+    // --------------- 充电状态相关 ---------------
+    public void setIsCharging(boolean isCharging) {
+        this.isCharging = isCharging;
+        LogUtils.d(TAG, String.format("setIsCharging() 执行 | 充电状态=%b", isCharging));
+    }
+
+    public boolean isCharging() {
+        return isCharging;
+    }
+
+    // --------------- 耗电提醒配置相关 ---------------
+    public void setEnableUsageReminder(boolean isEnableUsageReminder) {
+        this.isEnableUsageReminder = isEnableUsageReminder;
+        LogUtils.d(TAG, String.format("setEnableUsageReminder() 执行 | 耗电提醒开关=%b", isEnableUsageReminder));
+    }
+
+    public boolean isEnableUsageReminder() {
+        return isEnableUsageReminder;
+    }
+
+    public void setUsageReminderValue(int usageReminderValue) {
+        this.usageReminderValue = Math.min(Math.max(usageReminderValue, BATTERY_MIN), BATTERY_MAX);
+        LogUtils.d(TAG, String.format("setUsageReminderValue() 执行 | 最终阈值=%d | 输入值=%d", this.usageReminderValue, usageReminderValue));
+    }
+
+    public int getUsageReminderValue() {
+        return usageReminderValue;
+    }
+
+    // --------------- 充电提醒配置相关 ---------------
+    public void setEnableChargeReminder(boolean isEnableChargeReminder) {
+        this.isEnableChargeReminder = isEnableChargeReminder;
+        LogUtils.d(TAG, String.format("setEnableChargeReminder() 执行 | 充电提醒开关=%b", isEnableChargeReminder));
+    }
+
+    public boolean isEnableChargeReminder() {
+        return isEnableChargeReminder;
+    }
+
+    public void setChargeReminderValue(int chargeReminderValue) {
+        this.chargeReminderValue = Math.min(Math.max(chargeReminderValue, BATTERY_MIN), BATTERY_MAX);
+        LogUtils.d(TAG, String.format("setChargeReminderValue() 执行 | 最终阈值=%d | 输入值=%d", this.chargeReminderValue, chargeReminderValue));
+    }
+
+    public int getChargeReminderValue() {
+        return chargeReminderValue;
+    }
+
+    // --------------- 铃声提醒配置相关 ---------------
+    public void setReminderIntervalTime(int reminderIntervalTime) {
+        this.reminderIntervalTime = Math.max(reminderIntervalTime, MIN_REMIND_INTERVAL);
+        LogUtils.d(TAG, String.format("setReminderIntervalTime() 执行 | 最终间隔=%dms | 输入值=%dms", this.reminderIntervalTime, reminderIntervalTime));
+    }
+
+    public int getReminderIntervalTime() {
+        return reminderIntervalTime;
+    }
+
+    // --------------- 电量检测配置相关 ---------------
+    public void setBatteryDetectInterval(int batteryDetectInterval) {
+        this.batteryDetectInterval = Math.max(batteryDetectInterval, MIN_INTERVAL);
+        LogUtils.d(TAG, String.format("setBatteryDetectInterval() 执行 | 最终间隔=%dms | 输入值=%dms", this.batteryDetectInterval, batteryDetectInterval));
+    }
+
+    public int getBatteryDetectInterval() {
+        return batteryDetectInterval;
+    }
+
+    // --------------- 相框配置相关 ---------------
+    public void setDefaultFrameWidth(int defaultFrameWidth) {
+        this.defaultFrameWidth = defaultFrameWidth;
+        LogUtils.d(TAG, String.format("setDefaultFrameWidth() 执行 | 最终宽度=%dpx | 输入值=%dpx", this.defaultFrameWidth, defaultFrameWidth));
+    }
+
+    public int getDefaultFrameWidth() {
+        return defaultFrameWidth;
+    }
+
+    public void setDefaultFrameHeight(int defaultFrameHeight) {
+        this.defaultFrameHeight = defaultFrameHeight;
+        LogUtils.d(TAG, String.format("setDefaultFrameHeight() 执行 | 最终高度=%dpx | 输入值=%dpx", this.defaultFrameHeight, defaultFrameHeight));
+    }
+
+    public int getDefaultFrameHeight() {
+        return defaultFrameHeight;
+    }
+
+    // ====================== 父类重写方法（JSON 序列化/反序列化，兼容旧配置） ======================
+    @Override
+    public String getName() {
+        return AppConfigBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        LogUtils.d(TAG, "writeThisToJsonWriter() 执行 | 开始JSON序列化");
+
+        // 原有字段序列化
+        jsonWriter.name("isEnableUsageReminder").value(isEnableUsageReminder());
+        jsonWriter.name("usageReminderValue").value(getUsageReminderValue());
+        jsonWriter.name("isEnableChargeReminder").value(isEnableChargeReminder());
+        jsonWriter.name("chargeReminderValue").value(getChargeReminderValue());
+        jsonWriter.name("reminderIntervalTime").value(getReminderIntervalTime());
+        jsonWriter.name("isCharging").value(isCharging());
+        // 新增字段序列化（检测配置）
+        jsonWriter.name("batteryDetectInterval").value(getBatteryDetectInterval());
+        // 新增字段序列化（相框配置）
+        jsonWriter.name("defaultFrameWidth").value(getDefaultFrameWidth());
+        jsonWriter.name("defaultFrameHeight").value(getDefaultFrameHeight());
+
+        LogUtils.d(TAG, "writeThisToJsonWriter() 完成 | JSON序列化成功");
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        LogUtils.d(TAG, "readBeanFromJsonReader() 执行 | 开始JSON反序列化");
+        AppConfigBean bean = new AppConfigBean();
+        jsonReader.beginObject();
+
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            // 兼容拼写错误字段（isEnableUsegeReminder → isEnableUsageReminder）
+            if (name.equals("isEnableUsageReminder") || name.equals("isEnableUsegeReminder")) {
+                bean.setEnableUsageReminder(jsonReader.nextBoolean());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%b", name, bean.isEnableUsageReminder()));
+            } else if (name.equals("usageReminderValue") || name.equals("usegeReminderValue")) {
+                bean.setUsageReminderValue(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getUsageReminderValue()));
+            } else if (name.equals("isEnableChargeReminder")) {
+                bean.setEnableChargeReminder(jsonReader.nextBoolean());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%b", name, bean.isEnableChargeReminder()));
+            } else if (name.equals("chargeReminderValue")) {
+                bean.setChargeReminderValue(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getChargeReminderValue()));
+            } else if (name.equals("reminderIntervalTime")) {
+                bean.setReminderIntervalTime(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getReminderIntervalTime()));
+            } else if (name.equals("isCharging")) {
+                bean.setIsCharging(jsonReader.nextBoolean());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%b", name, bean.isCharging()));
+            } else if (name.equals("batteryDetectInterval")) {
+                bean.setBatteryDetectInterval(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getBatteryDetectInterval()));
+            } else if (name.equals("defaultFrameWidth")) {
+                bean.setDefaultFrameWidth(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getDefaultFrameWidth()));
+            } else if (name.equals("defaultFrameHeight")) {
+                bean.setDefaultFrameHeight(jsonReader.nextInt());
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader() 读取字段 | %s=%d", name, bean.getDefaultFrameHeight()));
+            } else {
+                jsonReader.skipValue();
+                LogUtils.w(TAG, String.format("readBeanFromJsonReader() 跳过未知字段 | %s", name));
+            }
+        }
+
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader() 完成 | JSON反序列化成功");
+        return bean;
+    }
+
+    // ====================== Parcelable 接口实现（API30 Intent 传递必备） ======================
+    @Override
+    public int describeContents() {
+        return 0; // 无特殊内容描述，固定返回0
+    }
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        LogUtils.d(TAG, "writeToParcel() 执行 | 开始Parcel序列化");
+        // 按成员变量顺序写入，boolean 转 byte 存储
+        dest.writeByte((byte) (isEnableUsageReminder ? 1 : 0));
+        dest.writeInt(usageReminderValue);
+        dest.writeByte((byte) (isEnableChargeReminder ? 1 : 0));
+        dest.writeInt(chargeReminderValue);
+        dest.writeInt(reminderIntervalTime);
+        dest.writeByte((byte) (isCharging ? 1 : 0));
+        dest.writeInt(batteryDetectInterval);
+        dest.writeInt(defaultFrameWidth);
+        dest.writeInt(defaultFrameHeight);
+        LogUtils.d(TAG, "writeToParcel() 完成 | Parcel序列化成功");
+    }
+
+    // 反序列化 Creator（必须 public static final 修饰，Java7 适配）
+    public static final Parcelable.Creator<AppConfigBean> CREATOR = new Parcelable.Creator<AppConfigBean>() {
+        @Override
+        public AppConfigBean createFromParcel(Parcel source) {
+            LogUtils.d(TAG, "createFromParcel() 执行 | 开始Parcel反序列化");
+            AppConfigBean bean = new AppConfigBean();
+            // 按 writeToParcel 顺序读取
+            bean.isEnableUsageReminder = source.readByte() != 0;
+            bean.usageReminderValue = source.readInt();
+            bean.isEnableChargeReminder = source.readByte() != 0;
+            bean.chargeReminderValue = source.readInt();
+            bean.reminderIntervalTime = source.readInt();
+            bean.isCharging = source.readByte() != 0;
+            bean.batteryDetectInterval = source.readInt();
+            bean.defaultFrameWidth = source.readInt();
+            bean.defaultFrameHeight = source.readInt();
+            LogUtils.d(TAG, "createFromParcel() 完成 | Parcel反序列化成功");
+            return bean;
+        }
+
+        @Override
+        public AppConfigBean[] newArray(int size) {
+            return new AppConfigBean[size];
+        }
+    };
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BackgroundBean.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BackgroundBean.java
new file mode 100644
index 0000000..1b056c2
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BackgroundBean.java
@@ -0,0 +1,296 @@
+package cc.winboll.studio.powerbell.models;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+import java.io.Serializable;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/18 11:52:28
+ * @Describe 应用背景图片数据类
+ * 适配 API30，支持 Serializable 持久化、JSON 序列化/反序列化
+ * 存储正式/预览背景配置，包含原图、压缩图、裁剪比例、像素颜色等核心字段
+ */
+public class BackgroundBean extends BaseBean implements Serializable {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    // 日志标签（全局统一，替换 Log 为 LogUtils）
+    public static final String TAG = "BackgroundBean";
+    // 兼容旧字段常量（统一管理，避免硬编码）
+    private static final String OLD_FIELD_USE_SCALED_COMPRESS = "isUseScaledCompress";
+    // 字段默认值常量（统一管理，避免魔法值）
+    private static final int DEFAULT_DIMENSION = 100; // 默认宽高
+    private static final int MIN_DIMENSION = 1;       // 最小宽高
+
+    // ====================== 成员变量（按功能分类：原图配置→压缩图配置→控制字段→裁剪配置→像素颜色） ======================
+    // 原图配置
+    private String backgroundFileName = "";          // 背景图片文件名
+    private String backgroundFilePath = "";          // 背景图片完整路径
+    private String backgroundFileInfo = "";          // 图片信息（Uri、网络地址等）
+    // 压缩图配置
+    private String backgroundScaledCompressFileName = ""; // 压缩后背景图片文件名
+    private String backgroundScaledCompressFilePath = ""; // 压缩后背景图片完整路径
+    // 控制字段
+    private boolean isUseBackgroundFile = false;             // 是否启用背景图片
+    private boolean isUseBackgroundScaledCompressFile = false; // 是否启用压缩背景图（重命名：原isUseScaledCompress）
+    // 裁剪配置
+    private int backgroundWidth = DEFAULT_DIMENSION;  // 背景图宽度
+    private int backgroundHeight = DEFAULT_DIMENSION; // 背景图高度
+    // 像素颜色
+    private int pixelColor = 0xFFFFFFFF;                       // 拾取的像素颜色（纯色背景用）
+
+    // ====================== 构造方法（无参构造，JSON反序列化必备） ======================
+    /**
+     * 无参构造器（必须，JSON反序列化时需默认构造器）
+     */
+    public BackgroundBean() {
+        LogUtils.d(TAG, "BackgroundBean: 无参构造初始化完成");
+    }
+
+    // ====================== Getter/Setter 方法（按功能分类，补充调试日志，强化校验） ======================
+    // --------------- 原图配置相关 ---------------
+    public String getBackgroundFileName() {
+        return backgroundFileName;
+    }
+
+    public void setBackgroundFileName(String backgroundFileName) {
+        this.backgroundFileName = backgroundFileName == null ? "" : backgroundFileName;
+        LogUtils.d(TAG, String.format("setBackgroundFileName: 背景文件名设置为 %s", this.backgroundFileName));
+    }
+
+    public String getBackgroundFilePath() {
+        return backgroundFilePath;
+    }
+
+    public void setBackgroundFilePath(String backgroundFilePath) {
+        this.backgroundFilePath = backgroundFilePath == null ? "" : backgroundFilePath;
+        LogUtils.d(TAG, String.format("setBackgroundFilePath: 背景文件路径设置为 %s", this.backgroundFilePath));
+    }
+
+    public String getBackgroundFileInfo() {
+        return backgroundFileInfo;
+    }
+
+    public void setBackgroundFileInfo(String backgroundFileInfo) {
+        this.backgroundFileInfo = backgroundFileInfo == null ? "" : backgroundFileInfo;
+        LogUtils.d(TAG, String.format("setBackgroundFileInfo: 背景文件信息设置为 %s", this.backgroundFileInfo));
+    }
+
+    // --------------- 控制字段相关 ---------------
+    public boolean isUseBackgroundFile() {
+        return isUseBackgroundFile;
+    }
+
+    public void setIsUseBackgroundFile(boolean isUseBackgroundFile) {
+        this.isUseBackgroundFile = isUseBackgroundFile;
+        LogUtils.d(TAG, String.format("setIsUseBackgroundFile: 是否启用背景图设置为 %b", isUseBackgroundFile));
+    }
+
+    // --------------- 压缩图配置相关 ---------------
+    public String getBackgroundScaledCompressFileName() {
+        return backgroundScaledCompressFileName;
+    }
+
+    public void setBackgroundScaledCompressFileName(String backgroundScaledCompressFileName) {
+        this.backgroundScaledCompressFileName = backgroundScaledCompressFileName == null ? "" : backgroundScaledCompressFileName;
+        LogUtils.d(TAG, String.format("setBackgroundScaledCompressFileName: 压缩背景文件名设置为 %s", this.backgroundScaledCompressFileName));
+    }
+
+    public String getBackgroundScaledCompressFilePath() {
+        return backgroundScaledCompressFilePath;
+    }
+
+    public void setBackgroundScaledCompressFilePath(String backgroundScaledCompressFilePath) {
+        this.backgroundScaledCompressFilePath = backgroundScaledCompressFilePath == null ? "" : backgroundScaledCompressFilePath;
+        LogUtils.d(TAG, String.format("setBackgroundScaledCompressFilePath: 压缩背景文件路径设置为 %s", this.backgroundScaledCompressFilePath));
+    }
+
+    /**
+     * 重命名：原isUseScaledCompress → 新isUseBackgroundScaledCompressFile（Getter/Setter同步修改）
+     * 语义：明确表示“是否启用背景压缩图文件”，避免与其他压缩逻辑混淆
+     */
+    public boolean isUseBackgroundScaledCompressFile() {
+        return isUseBackgroundScaledCompressFile;
+    }
+
+    public void setIsUseBackgroundScaledCompressFile(boolean isUseBackgroundScaledCompressFile) {
+        this.isUseBackgroundScaledCompressFile = isUseBackgroundScaledCompressFile;
+        LogUtils.d(TAG, String.format("setIsUseBackgroundScaledCompressFile: 是否启用压缩背景图设置为 %b", isUseBackgroundScaledCompressFile));
+    }
+
+    // --------------- 裁剪配置相关 ---------------
+    public int getBackgroundWidth() {
+        return backgroundWidth;
+    }
+
+    public void setBackgroundWidth(int backgroundWidth) {
+        this.backgroundWidth = backgroundWidth < MIN_DIMENSION ? DEFAULT_DIMENSION : backgroundWidth;
+        LogUtils.d(TAG, String.format("setBackgroundWidth: 背景宽度设置为 %d（输入值：%d）", this.backgroundWidth, backgroundWidth));
+    }
+
+    public int getBackgroundHeight() {
+        return backgroundHeight;
+    }
+
+    public void setBackgroundHeight(int backgroundHeight) {
+        this.backgroundHeight = backgroundHeight < MIN_DIMENSION ? DEFAULT_DIMENSION : backgroundHeight;
+        LogUtils.d(TAG, String.format("setBackgroundHeight: 背景高度设置为 %d（输入值：%d）", this.backgroundHeight, backgroundHeight));
+    }
+
+    // --------------- 像素颜色相关 ---------------
+    public int getPixelColor() {
+        return pixelColor;
+    }
+
+    public void setPixelColor(int pixelColor) {
+        this.pixelColor = pixelColor;
+        LogUtils.d(TAG, String.format("setPixelColor: 像素颜色设置为 0x%08X", pixelColor));
+    }
+
+    // ====================== 序列化/反序列化方法（适配重命名字段，兼容旧版本，补充调试日志） ======================
+    @Override
+    public String getName() {
+        String className = BackgroundBean.class.getName();
+        LogUtils.d(TAG, String.format("getName: 类名标识为 %s", className));
+        return className;
+    }
+
+    /**
+     * 序列化：同步重命名字段（原isUseScaledCompress → 新isUseBackgroundScaledCompressFile）
+     * 确保新字段能正常持久化，同时兼容旧版本JSON（保留旧字段写入，避免旧版本读取异常）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        BackgroundBean bean = this;
+        // 原图配置序列化
+        jsonWriter.name("backgroundFileName").value(bean.getBackgroundFileName());
+        jsonWriter.name("backgroundFilePath").value(bean.getBackgroundFilePath());
+        jsonWriter.name("backgroundFileInfo").value(bean.getBackgroundFileInfo());
+        // 控制字段序列化
+        jsonWriter.name("isUseBackgroundFile").value(bean.isUseBackgroundFile());
+        // 压缩图配置序列化
+        jsonWriter.name("backgroundScaledCompressFileName").value(bean.getBackgroundScaledCompressFileName());
+        jsonWriter.name("backgroundScaledCompressFilePath").value(bean.getBackgroundScaledCompressFilePath());
+        // 关键：新字段序列化（核心）
+        jsonWriter.name("isUseBackgroundScaledCompressFile").value(bean.isUseBackgroundScaledCompressFile());
+        // 兼容旧版本：保留旧字段名写入（避免旧版本Bean读取时缺失字段）
+        jsonWriter.name(OLD_FIELD_USE_SCALED_COMPRESS).value(bean.isUseBackgroundScaledCompressFile());
+        // 裁剪配置与像素颜色序列化
+        jsonWriter.name("backgroundWidth").value(bean.getBackgroundWidth());
+        jsonWriter.name("backgroundHeight").value(bean.getBackgroundHeight());
+        jsonWriter.name("pixelColor").value(bean.getPixelColor());
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON 序列化完成，已兼容旧字段");
+    }
+
+    /**
+     * 反序列化：同步处理重命名字段（兼容旧版本JSON，新旧字段都能读取）
+     * 逻辑：优先读取新字段，若新字段不存在则读取旧字段（确保升级后旧配置仍有效）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        BackgroundBean bean = new BackgroundBean();
+        jsonReader.beginObject();
+        // 临时变量：存储旧字段值（用于兼容）
+        boolean tempUseScaledCompress = false;
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            switch (name) {
+                case "backgroundFileName":
+                    bean.setBackgroundFileName(jsonReader.nextString());
+                    break;
+                case "backgroundFilePath":
+                    bean.setBackgroundFilePath(jsonReader.nextString());
+                    break;
+                case "backgroundFileInfo":
+                    bean.setBackgroundFileInfo(jsonReader.nextString());
+                    break;
+                case "isUseBackgroundFile":
+                    bean.setIsUseBackgroundFile(jsonReader.nextBoolean());
+                    break;
+                case "backgroundScaledCompressFileName":
+                    bean.setBackgroundScaledCompressFileName(jsonReader.nextString());
+                    break;
+                case "backgroundScaledCompressFilePath":
+                    bean.setBackgroundScaledCompressFilePath(jsonReader.nextString());
+                    break;
+                case "isUseBackgroundScaledCompressFile":
+                    // 关键：读取新字段（优先）
+                    bean.setIsUseBackgroundScaledCompressFile(jsonReader.nextBoolean());
+                    LogUtils.d(TAG, "readBeanFromJsonReader: 读取新字段 isUseBackgroundScaledCompressFile 完成");
+                    break;
+                case OLD_FIELD_USE_SCALED_COMPRESS:
+                    // 兼容旧版本：读取旧字段（若新字段未读取，则用旧字段值）
+                    tempUseScaledCompress = jsonReader.nextBoolean();
+                    LogUtils.d(TAG, "readBeanFromJsonReader: 读取旧字段 isUseScaledCompress 完成");
+                    break;
+                case "backgroundWidth":
+                    bean.setBackgroundWidth(jsonReader.nextInt());
+                    break;
+                case "backgroundHeight":
+                    bean.setBackgroundHeight(jsonReader.nextInt());
+                    break;
+                case "pixelColor":
+                    bean.setPixelColor(jsonReader.nextInt());
+                    break;
+                default:
+                    jsonReader.skipValue();
+                    LogUtils.w(TAG, String.format("readBeanFromJsonReader: 跳过未知字段 %s", name));
+                    break;
+            }
+        }
+        jsonReader.endObject();
+        // 兼容逻辑：若新字段未被赋值（旧版本JSON无此字段），则用旧字段值填充
+        if (!bean.isUseBackgroundScaledCompressFile()) {
+            bean.setIsUseBackgroundScaledCompressFile(tempUseScaledCompress);
+            LogUtils.d(TAG, "readBeanFromJsonReader: 旧字段值已填充到新字段");
+        }
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON 反序列化完成");
+        return bean;
+    }
+
+    // ====================== 辅助方法（重置配置、配置校验，补充调试日志） ======================
+    /**
+     * 重置背景配置（适配“取消背景”功能，同步重置重命名字段）
+     */
+    public void resetBackgroundConfig() {
+        this.backgroundFileName = "";
+        this.backgroundFilePath = "";
+        this.backgroundScaledCompressFileName = "";
+        this.backgroundScaledCompressFilePath = "";
+        this.backgroundFileInfo = "";
+        this.isUseBackgroundFile = false;
+        this.isUseBackgroundScaledCompressFile = false;
+        this.backgroundWidth = DEFAULT_DIMENSION;
+        this.backgroundHeight = DEFAULT_DIMENSION;
+        LogUtils.d(TAG, "resetBackgroundConfig: 背景配置已重置为默认值");
+    }
+
+    /**
+     * 检查背景配置是否有效（适配BackgroundSettingsActivity的预览/保存校验）
+     * 同步使用重命名字段判断压缩图是否启用
+     * @return true-配置有效（可显示背景图），false-配置无效
+     */
+    public boolean isBackgroundConfigValid() {
+        // 启用背景图时，需确保：原图路径/文件名 或 压缩图路径/文件名 非空
+        if (!isUseBackgroundFile) {
+            LogUtils.d(TAG, "isBackgroundConfigValid: 未启用背景图，配置无效");
+            return false;
+        }
+        // 原图校验：路径非空 或 文件名非空
+        boolean isOriginalValid = !backgroundFilePath.isEmpty() || !backgroundFileName.isEmpty();
+        // 压缩图校验：启用压缩图时，路径/文件名需非空
+        boolean isCompressValid = true;
+        if (isUseBackgroundScaledCompressFile()) {
+            isCompressValid = !backgroundScaledCompressFilePath.isEmpty() || !backgroundScaledCompressFileName.isEmpty();
+        }
+        // 逻辑：启用压缩图则需压缩图有效；不启用压缩图则需原图有效
+        boolean isValid = isUseBackgroundScaledCompressFile() ? isCompressValid : isOriginalValid;
+        LogUtils.d(TAG, String.format("isBackgroundConfigValid: 背景配置有效性为 %b（启用压缩图：%b，原图有效：%b，压缩图有效：%b）",
+									  isValid, isUseBackgroundScaledCompressFile(), isOriginalValid, isCompressValid));
+        return isValid;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryData.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryData.java
new file mode 100644
index 0000000..1cbd448
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryData.java
@@ -0,0 +1,82 @@
+package cc.winboll.studio.powerbell.models;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/22 14:30:51
+ * @Describe 电池报告数据模型
+ * 适配 API30，存储当前电量、放电时间、充电时间核心数据
+ * 支持参数校验与调试日志输出
+ */
+public class BatteryData {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    public static final String TAG = "BatteryData";
+    // 字段校验常量（避免硬编码，统一管理）
+    private static final int BATTERY_MIN = 0;
+    private static final int BATTERY_MAX = 100;
+    private static final String EMPTY_TIME = "00:00:00";
+
+    // ====================== 成员变量（按功能分类：电量→时间） ======================
+    private int currentLevel;     // 当前电池电量（0-100）
+    private String dischargeTime; // 放电时间
+    private String chargeTime;    // 充电时间
+
+    // ====================== 构造方法（按参数重载排序，补充校验与日志） ======================
+    /**
+     * 无参构造器（适配 JSON 反序列化、反射实例化场景）
+     */
+    public BatteryData() {
+        this.currentLevel = BATTERY_MIN;
+        this.dischargeTime = EMPTY_TIME;
+        this.chargeTime = EMPTY_TIME;
+        LogUtils.d(TAG, "BatteryData: 无参构造初始化完成，默认值已设置");
+    }
+
+    /**
+     * 带参构造器（核心构造，初始化所有字段）
+     * @param currentLevel 当前电量（0-100）
+     * @param dischargeTime 放电时间
+     * @param chargeTime 充电时间
+     */
+    public BatteryData(int currentLevel, String dischargeTime, String chargeTime) {
+        // 电量范围校验（0-100，异常值置为0）
+        this.currentLevel = currentLevel >= BATTERY_MIN && currentLevel <= BATTERY_MAX 
+			? currentLevel : BATTERY_MIN;
+        // 时间字段防 null（空值置为默认空时间）
+        this.dischargeTime = dischargeTime == null ? EMPTY_TIME : dischargeTime;
+        this.chargeTime = chargeTime == null ? EMPTY_TIME : chargeTime;
+
+        // 调试日志：输出入参与最终赋值结果
+        LogUtils.d(TAG, String.format("BatteryData: 带参构造初始化完成 | 当前电量：%d（输入：%d）| 放电时间：%s（输入：%s）| 充电时间：%s（输入：%s）",
+									  this.currentLevel, currentLevel,
+									  this.dischargeTime, dischargeTime,
+									  this.chargeTime, chargeTime));
+    }
+
+    // ====================== Getter 方法（按成员变量顺序排列，补充日志可选） ======================
+    /**
+     * 获取当前电池电量
+     * @return 当前电量（0-100）
+     */
+    public int getCurrentLevel() {
+        return currentLevel;
+    }
+
+    /**
+     * 获取放电时间
+     * @return 放电时间
+     */
+    public String getDischargeTime() {
+        return dischargeTime;
+    }
+
+    /**
+     * 获取充电时间
+     * @return 充电时间
+     */
+    public String getChargeTime() {
+        return chargeTime;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryInfoBean.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryInfoBean.java
new file mode 100644
index 0000000..0c2b17c
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryInfoBean.java
@@ -0,0 +1,130 @@
+package cc.winboll.studio.powerbell.models;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+import java.io.Serializable;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Describe 电池信息数据模型
+ * 适配 API30，存储电量时间戳与电量值，支持 JSON 序列化/反序列化
+ * 修复字段拼写错误，补充数据校验与调试日志
+ */
+public class BatteryInfoBean extends BaseBean implements Serializable {
+    // ====================== 静态常量（首屏可见，统一管理） ======================
+    public static final String TAG = "BatteryInfoBean";
+    // 字段校验常量（避免硬编码，统一管理）
+    private static final int BATTERY_MIN = 0;
+    private static final int BATTERY_MAX = 100;
+    private static final long DEFAULT_TIMESTAMP = 0L;
+    private static final int DEFAULT_BATTERY_VALUE = 0;
+
+    // ====================== 成员变量（修复拼写错误：battetyValue → batteryValue） ======================
+    private long timeStamp;    // 记录电量的时间戳
+    private int batteryValue;  // 电量值（0-100）
+
+    // ====================== 构造方法（按参数重载排序，补充校验与日志） ======================
+    /**
+     * 无参构造器（JSON 反序列化、反射实例化必备）
+     */
+    public BatteryInfoBean() {
+        this.timeStamp = DEFAULT_TIMESTAMP;
+        this.batteryValue = DEFAULT_BATTERY_VALUE;
+        LogUtils.d(TAG, "BatteryInfoBean: 无参构造初始化完成，默认时间戳：" + timeStamp + "，默认电量：" + batteryValue);
+    }
+
+    /**
+     * 带参构造器（核心构造，初始化所有字段）
+     * @param timeStamp 电量记录时间戳
+     * @param batteryValue 电量值（0-100）
+     */
+    public BatteryInfoBean(long timeStamp, int batteryValue) {
+        this.timeStamp = timeStamp;
+        // 电量范围校验（0-100，异常值置为默认值）
+        this.batteryValue = batteryValue >= BATTERY_MIN && batteryValue <= BATTERY_MAX
+			? batteryValue : DEFAULT_BATTERY_VALUE;
+        LogUtils.d(TAG, String.format("BatteryInfoBean: 带参构造初始化完成 | 时间戳：%d | 电量：%d（输入：%d）",
+									  this.timeStamp, this.batteryValue, batteryValue));
+    }
+
+    // ====================== Setter/Getter 方法（按成员变量顺序排列，修复拼写错误，补充日志） ======================
+    /**
+     * 设置电量记录时间戳
+     * @param timeStamp 时间戳
+     */
+    public void setTimeStamp(long timeStamp) {
+        this.timeStamp = timeStamp;
+        LogUtils.d(TAG, "setTimeStamp: 时间戳设置为 " + timeStamp);
+    }
+
+    public long getTimeStamp() {
+        return timeStamp;
+    }
+
+    /**
+     * 设置电量值（修复拼写错误：battetyValue → batteryValue）
+     * @param batteryValue 电量值（0-100）
+     */
+    public void setBatteryValue(int batteryValue) {
+        this.batteryValue = batteryValue >= BATTERY_MIN && batteryValue <= BATTERY_MAX
+			? batteryValue : DEFAULT_BATTERY_VALUE;
+        LogUtils.d(TAG, String.format("setBatteryValue: 电量设置为 %d（输入：%d）",
+									  this.batteryValue, batteryValue));
+    }
+
+    public int getBatteryValue() {
+        return batteryValue;
+    }
+
+    // ====================== JSON 序列化/反序列化方法（修复字段拼写错误，补充调试日志） ======================
+    @Override
+    public String getName() {
+        String className = BatteryInfoBean.class.getName();
+        LogUtils.d(TAG, "getName: 类名标识为 " + className);
+        return className;
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        BatteryInfoBean bean = this;
+        jsonWriter.name("timeStamp").value(bean.getTimeStamp());
+        // 修复 JSON 字段名拼写错误：battetyValue → batteryValue
+        jsonWriter.name("batteryValue").value(bean.getBatteryValue());
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON 序列化完成 | 时间戳：" + bean.getTimeStamp() + "，电量：" + bean.getBatteryValue());
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        BatteryInfoBean bean = new BatteryInfoBean();
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            switch (name) {
+                case "timeStamp":
+                    bean.setTimeStamp(jsonReader.nextLong());
+                    break;
+                case "batteryValue":
+                    bean.setBatteryValue(jsonReader.nextInt());
+                    break;
+					// 兼容旧字段名（battetyValue），避免旧配置解析失败
+                case "battetyValue":
+                    int oldBatteryValue = jsonReader.nextInt();
+                    bean.setBatteryValue(oldBatteryValue);
+                    LogUtils.w(TAG, "readBeanFromJsonReader: 读取旧字段 battetyValue，已兼容为 batteryValue，值：" + oldBatteryValue);
+                    break;
+                default:
+                    jsonReader.skipValue();
+                    LogUtils.w(TAG, "readBeanFromJsonReader: 跳过未知字段 " + name);
+                    break;
+            }
+        }
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON 反序列化完成 | 时间戳：" + bean.getTimeStamp() + "，电量：" + bean.getBatteryValue());
+        return bean;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryStyle.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryStyle.java
new file mode 100644
index 0000000..e0a7617
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/BatteryStyle.java
@@ -0,0 +1,12 @@
+package cc.winboll.studio.powerbell.models;
+
+/**
+ * 电池绘制样式枚举 (单选选项)
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public enum BatteryStyle {
+    ENERGY_STYLE,  // 能量样式
+    ZEBRA_STYLE,   // 条纹样式
+	POINT_STYLE    // 点阵样式
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/ControlCenterServiceBean.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/ControlCenterServiceBean.java
new file mode 100644
index 0000000..a499079
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/ControlCenterServiceBean.java
@@ -0,0 +1,131 @@
+package cc.winboll.studio.powerbell.models;
+
+import android.os.Parcel;
+import android.os.Parcelable;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import java.io.IOException;
+import java.io.Serializable;
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/17 15:55
+ * @Describe 服务控制参数模型
+ * 适配 API30，管理服务启用状态，支持 Serializable 持久化、Parcelable 组件传递、JSON 序列化解析
+ */
+public class ControlCenterServiceBean extends BaseBean implements Parcelable, Serializable {
+    // ====================== 静态常量（置顶统一管理，避免魔法值） ======================
+    //private static final long serialVersionUID = 1L; // Serializable 必备，保障反序列化兼容
+    private static final String TAG = "ControlCenterServiceBean";
+    private static final String JSON_FIELD_IS_ENABLE_SERVICE = "isEnableService"; // JSON 字段常量，避免硬编码
+
+    // ====================== 核心成员变量（私有封装，规范命名） ======================
+    private boolean isEnableService = false; // 服务启用状态：true=启用，false=禁用
+
+    // ====================== Parcelable 静态创建器（必须 public static final，适配 API30 组件传递） ======================
+    public static final Parcelable.Creator<ControlCenterServiceBean> CREATOR = new Parcelable.Creator<ControlCenterServiceBean>() {
+        @Override
+        public ControlCenterServiceBean createFromParcel(Parcel source) {
+            boolean isEnable = source.readByte() != 0;
+            ControlCenterServiceBean bean = new ControlCenterServiceBean(isEnable);
+            LogUtils.d(TAG, String.format("createFromParcel: 反序列化完成，isEnableService=%b", isEnable));
+            return bean;
+        }
+
+        @Override
+        public ControlCenterServiceBean[] newArray(int size) {
+            LogUtils.d(TAG, String.format("newArray: 创建数组，长度=%d", size));
+            return new ControlCenterServiceBean[size];
+        }
+    };
+
+    // ====================== 构造方法（无参+有参，满足不同初始化场景） ======================
+    /**
+     * 无参构造（JSON解析、反射创建必备）
+     */
+    public ControlCenterServiceBean() {
+        this.isEnableService = false;
+        LogUtils.d(TAG, "无参构造：初始化服务状态为禁用（false）");
+    }
+
+    /**
+     * 有参构造（指定服务启用状态）
+     * @param isEnableService 服务启用状态
+     */
+    public ControlCenterServiceBean(boolean isEnableService) {
+        this.isEnableService = isEnableService;
+        LogUtils.d(TAG, String.format("有参构造：初始化服务状态，isEnableService=%b", isEnableService));
+    }
+
+    // ====================== Getter/Setter 方法（封装成员变量，控制访问） ======================
+    public boolean isEnableService() {
+        LogUtils.d(TAG, String.format("isEnableService: 当前状态=%b", isEnableService));
+        return isEnableService;
+    }
+
+    public void setIsEnableService(boolean isEnableService) {
+        LogUtils.d(TAG, String.format("setIsEnableService: 旧状态=%b，新状态=%b", this.isEnableService, isEnableService));
+        this.isEnableService = isEnableService;
+    }
+
+    // ====================== 父类 BaseBean 方法重写（核心业务逻辑：JSON 序列化/反序列化） ======================
+    @Override
+    public String getName() {
+        String className = ControlCenterServiceBean.class.getName();
+        LogUtils.d(TAG, String.format("getName: 返回类名=%s", className));
+        return className;
+    }
+
+    /**
+     * 序列化对象到 JSON（适配数据持久化/网络传输）
+     */
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name(JSON_FIELD_IS_ENABLE_SERVICE).value(this.isEnableService);
+        LogUtils.d(TAG, String.format("writeThisToJsonWriter: 序列化完成，%s=%b", JSON_FIELD_IS_ENABLE_SERVICE, this.isEnableService));
+    }
+
+    /**
+     * 从 JSON 反序列化创建对象（适配数据恢复）
+     */
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        ControlCenterServiceBean bean = new ControlCenterServiceBean();
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            if (JSON_FIELD_IS_ENABLE_SERVICE.equals(fieldName)) {
+                boolean isEnable = jsonReader.nextBoolean();
+                bean.setIsEnableService(isEnable);
+                LogUtils.d(TAG, String.format("readBeanFromJsonReader: 读取字段，%s=%b", fieldName, isEnable));
+            } else {
+                jsonReader.skipValue();
+                LogUtils.w(TAG, String.format("readBeanFromJsonReader: 跳过未知字段=%s", fieldName));
+            }
+        }
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader: 反序列化完成");
+        return bean;
+    }
+
+    // ====================== Parcelable 接口方法实现（适配 Intent 组件间传递，Java7 适配） ======================
+    @Override
+    public int describeContents() {
+        LogUtils.d(TAG, "describeContents: 返回内容描述符=0");
+        return 0; // 无特殊内容（如文件描述符），返回0即可（API30 标准实现）
+    }
+
+    /**
+     * 序列化对象到 Parcel（Intent 传递必备，Java7 适配：用 byte 存储 boolean）
+     */
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        byte flag = (byte) (this.isEnableService ? 1 : 0);
+        dest.writeByte(flag);
+        LogUtils.d(TAG, String.format("writeToParcel: 序列化完成，isEnableService=%b（存储为byte=%d）", this.isEnableService, flag));
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/NotificationMessage.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/NotificationMessage.java
new file mode 100644
index 0000000..fcd8436
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/NotificationMessage.java
@@ -0,0 +1,75 @@
+package cc.winboll.studio.powerbell.models;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * 通知数据模型
+ * 适配 API30，统一存储通知标题、内容、标识信息，支持各组件数据传递
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Describe 通知数据模型：统一存储通知标题、内容等信息，适配各组件数据传递
+ */
+public class NotificationMessage {
+    // ====================== 静态常量（统一管理） ======================
+    private static final String TAG = "NotificationMessage";
+    private static final String EMPTY_STRING = "";
+
+    // ====================== 核心成员变量（按业务逻辑排序） ======================
+    private String title;       // 通知标题
+    private String content;     // 通知内容
+    private String remindMSG;   // 通知标识（区分服务运行/充电/耗电）
+
+    // ====================== 构造方法（无参+全参，满足不同初始化场景） ======================
+    /**
+     * 无参构造器（反射实例化、JSON反序列化必备）
+     */
+    public NotificationMessage() {
+        this.title = EMPTY_STRING;
+        this.content = EMPTY_STRING;
+        this.remindMSG = EMPTY_STRING;
+        LogUtils.d(TAG, "无参构造：初始化通知数据模型，默认值为空字符串");
+    }
+
+    /**
+     * 全参构造器（直接传参创建实例，简化调用）
+     * @param title 通知标题
+     * @param content 通知内容
+     * @param remindMSG 通知标识
+     */
+    public NotificationMessage(String title, String content, String remindMSG) {
+        this.title = title == null ? EMPTY_STRING : title;
+        this.content = content == null ? EMPTY_STRING : content;
+        this.remindMSG = remindMSG == null ? EMPTY_STRING : remindMSG;
+        LogUtils.d(TAG, String.format("全参构造：初始化完成 | 标题：%s | 内容：%s | 标识：%s",
+									  this.title, this.content, this.remindMSG));
+    }
+
+    // ====================== Setter 方法（补充空值防护与调试日志） ======================
+    public void setTitle(String title) {
+        this.title = title == null ? EMPTY_STRING : title;
+        LogUtils.d(TAG, String.format("setTitle：通知标题设置为「%s」", this.title));
+    }
+
+    public void setContent(String content) {
+        this.content = content == null ? EMPTY_STRING : content;
+        LogUtils.d(TAG, String.format("setContent：通知内容设置为「%s」", this.content));
+    }
+
+    public void setRemindMSG(String remindMSG) {
+        this.remindMSG = remindMSG == null ? EMPTY_STRING : remindMSG;
+        LogUtils.d(TAG, String.format("setRemindMSG：通知标识设置为「%s」", this.remindMSG));
+    }
+
+    // ====================== Getter 方法（按成员变量顺序排列） ======================
+    public String getTitle() {
+        return title;
+    }
+
+    public String getContent() {
+        return content;
+    }
+
+    public String getRemindMSG() {
+        return remindMSG;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/TTSSpeakTextBean.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/TTSSpeakTextBean.java
new file mode 100644
index 0000000..d9370fc
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/TTSSpeakTextBean.java
@@ -0,0 +1,47 @@
+package cc.winboll.studio.powerbell.models;
+
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.Serializable;
+
+/**
+ * TTS 语音播放文本内容实体类
+ * 适配：Java7 语法规范 | Android API30 系统版本
+ * 特性：实现序列化接口，支持跨页面/进程传递，属性默认值初始化
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/29 19:13
+ */
+public class TTSSpeakTextBean implements Serializable {
+
+    // ====================================== 常量区 - 置顶排序 ======================================
+    /** 日志TAG 瞬态修饰，不参与序列化，减少序列化体积 */
+    transient public static final String TAG = "TTSSpeakTextBean";
+
+    // ====================================== 成员属性区 - 业务属性排序 ======================================
+    /** 延迟播放时长 单位：毫秒，默认值0：无延迟播放 */
+    public int mnDelay = 0;
+    /** TTS语音播放文本内容，默认值空字符串：防止空指针 */
+    public String mszSpeakContent = "";
+
+    // ====================================== 构造方法区 - 无参+有参 完整实现 ======================================
+    /**
+     * 无参构造方法
+     * Java7序列化规范必备 + 兼容反射实例化场景
+     */
+    public TTSSpeakTextBean() {
+        LogUtils.d(TAG, "【无参构造】TTSSpeakTextBean 实例化，使用默认值 | 延迟:" + mnDelay + " | 文本:" + mszSpeakContent);
+    }
+
+    /**
+     * 有参构造方法【主构造】
+     * @param nDelay 延迟播放时长(ms)
+     * @param szSpeakContent 语音播放文本内容
+     */
+    public TTSSpeakTextBean(int nDelay, String szSpeakContent) {
+        LogUtils.d(TAG, "【有参构造】TTSSpeakTextBean 实例化，入参 | 延迟:" + nDelay + " | 文本:" + szSpeakContent);
+        this.mnDelay = nDelay;
+        this.mszSpeakContent = szSpeakContent;
+        LogUtils.d(TAG, "【有参构造】赋值完成 | 最终延迟:" + this.mnDelay + " | 最终文本:" + this.mszSpeakContent);
+    }
+
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/models/ThoughtfulServiceBean.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/ThoughtfulServiceBean.java
new file mode 100644
index 0000000..0531a34
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/models/ThoughtfulServiceBean.java
@@ -0,0 +1,196 @@
+package cc.winboll.studio.powerbell.models;
+
+import android.os.Parcel;
+import android.os.Parcelable;
+import android.util.JsonReader;
+import android.util.JsonWriter;
+
+import java.io.IOException;
+import java.io.Serializable;
+
+import cc.winboll.studio.libappbase.BaseBean;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/29 20:59
+ * @Describe 贴心服务配置实体类 (适配API30 / Java7)
+ */
+public class ThoughtfulServiceBean extends BaseBean implements Parcelable, Serializable {
+
+    // ====================== 常量区 - 置顶统一管理 ======================
+    public static final String TAG = ThoughtfulServiceBean.class.getSimpleName();
+    private static final long serialVersionUID = 1L; // Serializable 序列化兼容必备
+    // JSON序列化字段常量 杜绝硬编码
+    public static final String JSON_FIELD_IS_ENABLE_CHARGE_TTS = "isEnableChargeTts";
+    public static final String JSON_FIELD_IS_ENABLE_USE_POWER_TTS = "isEnableUsePowerTts";
+    public static final String JSON_FIELD_IS_ENABLE_USAGE_TTS_WITH_BATTERY = "isEnableUseageTtsWithBattary";
+    public static final String JSON_FIELD_IS_ENABLE_CHARGE_TTS_WITH_BATTERY = "isEnableChargeTtsWithBattary";
+    // 👉 新增：通知电量消息时同时播放TTS
+    public static final String JSON_FIELD_IS_ENABLE_TTS_WHEN_NOTIFY_BATTERY = "isEnableTtsWhenNotifyBattery";
+
+    // ====================== 核心成员变量 - 私有封装 ======================
+    private boolean isEnableChargeTts = false;                  // 是否启用 充电TTS贴心语音服务
+    private boolean isEnableUsePowerTts = false;                // 是否启用 用电TTS贴心语音服务
+    private boolean isEnableUseageTtsWithBattary = false;       // 用电TTS加入电量提醒
+    private boolean isEnableChargeTtsWithBattary = false;        // 充电TTS加入电量提醒
+    private boolean isEnableTtsWhenNotifyBattery = false;        // 👉 允许通知电量消息时同时播放TTS语音
+
+    // ====================== Parcelable 静态创建器 ======================
+    public static final Creator<ThoughtfulServiceBean> CREATOR = new Creator<ThoughtfulServiceBean>() {
+        @Override
+        public ThoughtfulServiceBean createFromParcel(Parcel source) {
+            return new ThoughtfulServiceBean(source);
+        }
+
+        @Override
+        public ThoughtfulServiceBean[] newArray(int size) {
+            LogUtils.d(TAG, "newArray: 初始化数组，size = " + size);
+            return new ThoughtfulServiceBean[size];
+        }
+    };
+
+    // ====================== 构造方法区 ======================
+    public ThoughtfulServiceBean() {
+        LogUtils.d(TAG, "ThoughtfulServiceBean: 无参构造，初始化默认禁用所有TTS服务");
+    }
+
+    public ThoughtfulServiceBean(boolean isEnableChargeTts, boolean isEnableUsePowerTts,
+                                 boolean isEnableUseageTtsWithBattary, boolean isEnableChargeTtsWithBattary,
+                                 boolean isEnableTtsWhenNotifyBattery) {
+        this.isEnableChargeTts = isEnableChargeTts;
+        this.isEnableUsePowerTts = isEnableUsePowerTts;
+        this.isEnableUseageTtsWithBattary = isEnableUseageTtsWithBattary;
+        this.isEnableChargeTtsWithBattary = isEnableChargeTtsWithBattary;
+        this.isEnableTtsWhenNotifyBattery = isEnableTtsWhenNotifyBattery;
+        LogUtils.d(TAG, "ThoughtfulServiceBean: 全参构造 | 充电TTS=" + isEnableChargeTts + " | 用电TTS=" + isEnableUsePowerTts
+				   + " | 用电TTS加电量=" + isEnableUseageTtsWithBattary + " | 充电TTS加电量=" + isEnableChargeTtsWithBattary
+				   + " | 通知电量时播TTS=" + isEnableTtsWhenNotifyBattery);
+    }
+
+    private ThoughtfulServiceBean(Parcel in) {
+        this.isEnableChargeTts = in.readByte() != 0;
+        this.isEnableUsePowerTts = in.readByte() != 0;
+        this.isEnableUseageTtsWithBattary = in.readByte() != 0;
+        this.isEnableChargeTtsWithBattary = in.readByte() != 0;
+        this.isEnableTtsWhenNotifyBattery = in.readByte() != 0; // 👉 新增反序列化
+        LogUtils.d(TAG, "ThoughtfulServiceBean: Parcel构造解析完成");
+    }
+
+    // ====================== Getter/Setter 方法区 ======================
+    public boolean isEnableChargeTts() {
+        return isEnableChargeTts;
+    }
+
+    public void setIsEnableChargeTts(boolean isEnableChargeTts) {
+        LogUtils.d(TAG, "setIsEnableChargeTts: 旧值=" + this.isEnableChargeTts + " ｜ 新值=" + isEnableChargeTts);
+        this.isEnableChargeTts = isEnableChargeTts;
+    }
+
+    public boolean isEnableUsePowerTts() {
+        return isEnableUsePowerTts;
+    }
+
+    public void setIsEnableUsePowerTts(boolean isEnableUsePowerTts) {
+        LogUtils.d(TAG, "setIsEnableUsePowerTts: 旧值=" + this.isEnableUsePowerTts + " ｜ 新值=" + isEnableUsePowerTts);
+        this.isEnableUsePowerTts = isEnableUsePowerTts;
+    }
+
+    public boolean isEnableUseageTtsWithBattary() {
+        return isEnableUseageTtsWithBattary;
+    }
+
+    public void setIsEnableUseageTtsWithBattary(boolean isEnableUseageTtsWithBattary) {
+        LogUtils.d(TAG, "setIsEnableUseageTtsWithBattary: 旧值=" + this.isEnableUseageTtsWithBattary + " ｜ 新值=" + isEnableUseageTtsWithBattary);
+        this.isEnableUseageTtsWithBattary = isEnableUseageTtsWithBattary;
+    }
+
+    public boolean isEnableChargeTtsWithBattary() {
+        return isEnableChargeTtsWithBattary;
+    }
+
+    public void setIsEnableChargeTtsWithBattary(boolean isEnableChargeTtsWithBattary) {
+        LogUtils.d(TAG, "setIsEnableChargeTtsWithBattary: 旧值=" + this.isEnableChargeTtsWithBattary + " ｜ 新值=" + isEnableChargeTtsWithBattary);
+        this.isEnableChargeTtsWithBattary = isEnableChargeTtsWithBattary;
+    }
+
+    // 👉 新增：通知电量时播放TTS
+    public boolean isEnableTtsWhenNotifyBattery() {
+        return isEnableTtsWhenNotifyBattery;
+    }
+
+    public void setIsEnableTtsWhenNotifyBattery(boolean isEnableTtsWhenNotifyBattery) {
+        LogUtils.d(TAG, "setIsEnableTtsWhenNotifyBattery: 旧值=" + this.isEnableTtsWhenNotifyBattery + " ｜ 新值=" + isEnableTtsWhenNotifyBattery);
+        this.isEnableTtsWhenNotifyBattery = isEnableTtsWhenNotifyBattery;
+    }
+
+    // ====================== 重写父类 BaseBean 核心方法 ======================
+    @Override
+    public String getName() {
+        String className = ThoughtfulServiceBean.class.getName();
+        LogUtils.d(TAG, "getName: 返回当前实体类名 = " + className);
+        return className;
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name(JSON_FIELD_IS_ENABLE_CHARGE_TTS).value(this.isEnableChargeTts);
+        jsonWriter.name(JSON_FIELD_IS_ENABLE_USE_POWER_TTS).value(this.isEnableUsePowerTts);
+        jsonWriter.name(JSON_FIELD_IS_ENABLE_USAGE_TTS_WITH_BATTERY).value(this.isEnableUseageTtsWithBattary);
+        jsonWriter.name(JSON_FIELD_IS_ENABLE_CHARGE_TTS_WITH_BATTERY).value(this.isEnableChargeTtsWithBattary);
+        jsonWriter.name(JSON_FIELD_IS_ENABLE_TTS_WHEN_NOTIFY_BATTERY).value(this.isEnableTtsWhenNotifyBattery); // 👉 新增JSON写入
+        LogUtils.d(TAG, "writeThisToJsonWriter: JSON序列化完成，所有TTS服务状态已写入");
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        ThoughtfulServiceBean bean = new ThoughtfulServiceBean();
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String fieldName = jsonReader.nextName();
+            switch (fieldName) {
+                case JSON_FIELD_IS_ENABLE_CHARGE_TTS:
+                    bean.setIsEnableChargeTts(jsonReader.nextBoolean());
+                    break;
+                case JSON_FIELD_IS_ENABLE_USE_POWER_TTS:
+                    bean.setIsEnableUsePowerTts(jsonReader.nextBoolean());
+                    break;
+                case JSON_FIELD_IS_ENABLE_USAGE_TTS_WITH_BATTERY:
+                    bean.setIsEnableUseageTtsWithBattary(jsonReader.nextBoolean());
+                    break;
+                case JSON_FIELD_IS_ENABLE_CHARGE_TTS_WITH_BATTERY:
+                    bean.setIsEnableChargeTtsWithBattary(jsonReader.nextBoolean());
+                    break;
+                case JSON_FIELD_IS_ENABLE_TTS_WHEN_NOTIFY_BATTERY:
+                    bean.setIsEnableTtsWhenNotifyBattery(jsonReader.nextBoolean()); // 👉 新增JSON读取
+                    break;
+                default:
+                    jsonReader.skipValue();
+                    LogUtils.w(TAG, "readBeanFromJsonReader: 跳过未知JSON字段 = " + fieldName);
+                    break;
+            }
+        }
+        jsonReader.endObject();
+        LogUtils.d(TAG, "readBeanFromJsonReader: JSON反序列化完成，生成实体对象");
+        return bean;
+    }
+
+    // ====================== Parcelable 接口方法 ======================
+    @Override
+    public int describeContents() {
+        return 0;
+    }
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+        dest.writeByte((byte) (isEnableChargeTts ? 1 : 0));
+        dest.writeByte((byte) (isEnableUsePowerTts ? 1 : 0));
+        dest.writeByte((byte) (isEnableUseageTtsWithBattary ? 1 : 0));
+        dest.writeByte((byte) (isEnableChargeTtsWithBattary ? 1 : 0));
+        dest.writeByte((byte) (isEnableTtsWhenNotifyBattery ? 1 : 0)); // 👉 新增Parcel写入
+        LogUtils.d(TAG, "writeToParcel: Parcel序列化完成，所有TTS服务状态已写入");
+    }
+
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/ControlCenterServiceReceiver.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/ControlCenterServiceReceiver.java
new file mode 100644
index 0000000..4fa10d8
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/ControlCenterServiceReceiver.java
@@ -0,0 +1,227 @@
+package cc.winboll.studio.powerbell.receivers;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.models.AppConfigBean;
+import cc.winboll.studio.powerbell.models.NotificationMessage;
+import cc.winboll.studio.powerbell.services.ControlCenterService;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BatteryUtils;
+import cc.winboll.studio.powerbell.utils.NotificationManagerUtils;
+import java.lang.ref.WeakReference;
+import cc.winboll.studio.powerbell.services.ThoughtfulService;
+
+/**
+ * 控制中心广播接收器
+ * 功能：监听电池状态变化、前台通知更新、配置变更指令
+ * 适配：Java7 | API30 | 内存泄漏防护 | 多线程状态同步
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/19 20:23
+ * @Describe 统一处理系统与应用内广播，同步电池状态与配置，保障多线程数据一致性
+ */
+public class ControlCenterServiceReceiver extends BroadcastReceiver {
+    // ====================== 静态常量区 ======================
+    public static final String TAG = "ControlCenterServiceReceiver";
+
+    public static final String ACTION_UPDATE_FOREGROUND_NOTIFICATION = "cc.winboll.studio.powerbell.action.ACTION_UPDATE_FOREGROUND_NOTIFICATION";
+    public static final String ACTION_APPCONFIG_CHANGED = "cc.winboll.studio.powerbell.action.ACTION_APPCONFIG_CHANGED";
+    public static final String EXTRA_APP_CONFIG_BEAN = "extra_app_config_bean";
+
+    private static final int BROADCAST_PRIORITY = IntentFilter.SYSTEM_HIGH_PRIORITY - 10;
+    private static final int BATTERY_LEVEL_MIN = 0;
+    private static final int BATTERY_LEVEL_MAX = 100;
+    private static final int INVALID_BATTERY = -1;
+
+    // ====================== 静态状态（防抖动 + 防重复播报） ======================
+    private static volatile int sLastBatteryLevel = INVALID_BATTERY;
+    private static volatile boolean sIsCharging = false;
+
+    // 【新增】防重复触发：3秒内只允许一次播报（关键修复）
+    private static final long MIN_TRIGGER_INTERVAL = 3000;
+    private static long sLastTriggerTime = 0;
+
+    // ====================== 成员变量 ======================
+    private WeakReference<ControlCenterService> mwrControlCenterService;
+    private boolean isRegistered = false;
+
+    // ====================== 构造 ======================
+    public ControlCenterServiceReceiver(ControlCenterService service) {
+        LogUtils.d(TAG, String.format("ControlCenterServiceReceiver() 构造 | 服务：%s",
+									  service != null ? service.getClass().getSimpleName() : "null"));
+        this.mwrControlCenterService = new WeakReference<>(service);
+    }
+
+    // ====================== 广播入口 ======================
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent != null ? intent.getAction() : "null";
+        LogUtils.d(TAG, String.format("onReceive() | Action=%s", action));
+
+        if (context == null || intent == null || action == null) {
+            LogUtils.e(TAG, "onReceive() 终止：参数无效");
+            return;
+        }
+
+        ControlCenterService service = mwrControlCenterService != null ? mwrControlCenterService.get() : null;
+        if (service == null || service.isDestroyed()) {
+            LogUtils.e(TAG, "onReceive() 终止：服务已销毁");
+            unregisterAction(context);
+            return;
+        }
+
+        switch (action) {
+            case Intent.ACTION_BATTERY_CHANGED:
+                handleBatteryStateChanged(service, intent);
+                break;
+            case ACTION_UPDATE_FOREGROUND_NOTIFICATION:
+                handleUpdateForegroundNotification(service);
+                break;
+            case ACTION_APPCONFIG_CHANGED:
+                handleNotifyAppConfigUpdate(service);
+                break;
+            default:
+                LogUtils.w(TAG, "未知Action：" + action);
+        }
+    }
+
+    // ====================== 电池状态（核心修复区） ======================
+    private void handleBatteryStateChanged(ControlCenterService service, Intent intent) {
+        LogUtils.d(TAG, "handleBatteryStateChanged() 解析电池状态");
+        try {
+            boolean currentCharging = BatteryUtils.isCharging(intent);
+            int currentBatteryLevel = BatteryUtils.getCurrentBatteryLevel(intent);
+            currentBatteryLevel = Math.min(Math.max(currentBatteryLevel, BATTERY_LEVEL_MIN), BATTERY_LEVEL_MAX);
+
+            LogUtils.d(TAG, String.format("当前：充电=%b | 电量=%d%%", currentCharging, currentBatteryLevel));
+
+            // ================ 【关键修复1】状态没变直接跳过 ================
+            if (currentCharging == sIsCharging && currentBatteryLevel == sLastBatteryLevel) {
+                LogUtils.d(TAG, "状态无变化，跳过");
+                return;
+            }
+
+            // ================ 【关键修复2】只有 真正插拔充电 才播报 ================
+            boolean isRealPlugSwitch = (currentCharging != sIsCharging);
+            boolean isBatteryValid = (sLastBatteryLevel != INVALID_BATTERY);
+
+            // ================ 【关键修复3】防抖动：3秒内不重复触发 ================
+            long now = System.currentTimeMillis();
+            boolean canTrigger = (now - sLastTriggerTime >= MIN_TRIGGER_INTERVAL);
+
+            if (isRealPlugSwitch && isBatteryValid && canTrigger) {
+                LogUtils.d(TAG, "检测到充电状态切换 → 执行TTS提醒");
+
+                // 更新触发时间
+                sLastTriggerTime = now;
+
+                // 执行播报
+                if (currentCharging) {
+                    ThoughtfulService.startServiceWithType(service, ThoughtfulService.ServiceType.CHARGE_STATE);
+                } else {
+                    ThoughtfulService.startServiceWithType(service, ThoughtfulService.ServiceType.DISCHARGE_STATE);
+                }
+            }
+
+            // 更新缓存
+            sIsCharging = currentCharging;
+            sLastBatteryLevel = currentBatteryLevel;
+
+            // 同步配置
+            handleNotifyAppConfigUpdate(service);
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "handleBatteryStateChanged 异常", e);
+        }
+    }
+
+    // ====================== 配置同步 ======================
+    private void handleNotifyAppConfigUpdate(ControlCenterService service) {
+        LogUtils.d(TAG, "handleNotifyAppConfigUpdate() 同步配置");
+        try {
+            AppConfigBean latestConfig = AppConfigUtils.getInstance(service).loadAppConfig();
+            if (latestConfig == null) {
+                LogUtils.e(TAG, "配置为空，终止");
+                return;
+            }
+
+            App.sQuantityOfElectricity = sLastBatteryLevel;
+            latestConfig.setIsCharging(sIsCharging);
+            service.notifyAppConfigUpdate(latestConfig);
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "handleNotifyAppConfigUpdate 异常", e);
+        }
+    }
+
+    // ====================== 通知更新 ======================
+    private void handleUpdateForegroundNotification(ControlCenterService service) {
+        LogUtils.d(TAG, "handleUpdateForegroundNotification() 更新通知");
+        try {
+            NotificationManagerUtils notifyUtils = service.getNotificationManager();
+            NotificationMessage notifyMsg = service.getForegroundNotifyMsg();
+
+            if (notifyUtils == null || notifyMsg == null) {
+                LogUtils.e(TAG, "通知工具或消息为空");
+                return;
+            }
+            notifyUtils.updateForegroundServiceNotify(notifyMsg);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "更新通知异常", e);
+        }
+    }
+
+    // ====================== 注册/注销 ======================
+    public void registerAction(Context context) {
+        if (context == null || isRegistered) return;
+        try {
+            IntentFilter filter = new IntentFilter();
+            filter.addAction(Intent.ACTION_BATTERY_CHANGED);
+            filter.addAction(ACTION_UPDATE_FOREGROUND_NOTIFICATION);
+            filter.addAction(ACTION_APPCONFIG_CHANGED);
+            filter.setPriority(BROADCAST_PRIORITY);
+            context.registerReceiver(this, filter);
+            isRegistered = true;
+            LogUtils.d(TAG, "广播注册完成");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "注册异常", e);
+        }
+    }
+
+    public void unregisterAction(Context context) {
+        if (context == null || !isRegistered) return;
+        try {
+            context.unregisterReceiver(this);
+            isRegistered = false;
+            LogUtils.d(TAG, "广播已注销");
+        } catch (Exception e) {
+            LogUtils.w(TAG, "注销异常", e);
+        }
+    }
+
+    // ====================== 释放 ======================
+    public void release() {
+        LogUtils.d(TAG, "release() 释放资源");
+        if (mwrControlCenterService != null) {
+            mwrControlCenterService.clear();
+            mwrControlCenterService = null;
+        }
+        // 重置静态状态
+        sLastBatteryLevel = INVALID_BATTERY;
+        sIsCharging = false;
+        sLastTriggerTime = 0; // 【新增】重置防抖时间
+    }
+
+    // ====================== Getter ======================
+    public static int getLastBatteryLevel() {
+        return sLastBatteryLevel;
+    }
+
+    public static boolean isLastCharging() {
+        return sIsCharging;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/GlobalApplicationReceiver.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/GlobalApplicationReceiver.java
new file mode 100644
index 0000000..7197476
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/GlobalApplicationReceiver.java
@@ -0,0 +1,180 @@
+package cc.winboll.studio.powerbell.receivers;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.BatteryUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/19 20:13
+ * @Describe 全局应用广播接收器
+ * 功能：监听系统电池状态变化，同步状态到配置工具类，通知页面更新
+ * 适配：Java7 | API30 | 内存泄漏防护
+ */
+public class GlobalApplicationReceiver extends BroadcastReceiver {
+    // ====================== 静态常量区（置顶归类，消除魔法值） ======================
+    public static final String TAG = "GlobalApplicationReceiver";
+    private static final int BATTERY_LEVEL_MIN = 0;
+    private static final int BATTERY_LEVEL_MAX = 100;
+
+    // ====================== 静态状态标记（volatile保证多线程可见性） ======================
+    private static volatile int sLastBatteryLevel = -1;   // 历史电量（0-100）
+    private static volatile boolean sLastIsCharging = false;  // 历史充电状态
+
+    // ====================== 成员变量区（按功能分层，移除冗余的mCurrentReceiver） ======================
+    private App mGlobalApplication;
+    private AppConfigUtils mAppConfigUtils;
+
+    // ====================== 构造方法（强化参数校验，初始化核心依赖） ======================
+    public GlobalApplicationReceiver(App globalApplication) {
+        LogUtils.d(TAG, String.format("构造接收器 | App实例：%s", globalApplication));
+        if (globalApplication == null) {
+            LogUtils.e(TAG, "构造失败：App实例为空");
+            throw new IllegalArgumentException("App cannot be null");
+        }
+        this.mGlobalApplication = globalApplication;
+        this.mAppConfigUtils = App.getAppConfigUtils(mGlobalApplication);
+        LogUtils.d(TAG, String.format("构造完成 | AppConfigUtils：%s", mAppConfigUtils));
+    }
+
+    // ====================== 广播核心接收逻辑（入口方法，过滤电池状态广播） ======================
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent != null ? intent.getAction() : "null";
+        LogUtils.d(TAG, String.format("onReceive: 接收广播 | 上下文：%s | Action：%s", context, action));
+
+        // 基础参数校验
+        if (context == null || intent == null || action == null) {
+            LogUtils.e(TAG, "onReceive: 参数无效，终止处理");
+            return;
+        }
+
+        // 仅处理电池状态变化广播
+        if (Intent.ACTION_BATTERY_CHANGED.equals(action)) {
+            handleBatteryStateChanged(context, intent);
+        }
+
+        LogUtils.d(TAG, "onReceive: 广播处理完成");
+    }
+
+    // ====================== 业务逻辑方法（处理电池状态变化，同步配置+通知页面） ======================
+    /**
+     * 处理电池状态变化广播
+     * @param context 上下文
+     * @param intent  电池状态广播意图
+     */
+    private void handleBatteryStateChanged(Context context, Intent intent) {
+        LogUtils.d(TAG, "handleBatteryStateChanged: 解析电池状态");
+        try {
+            // 1. 解析当前电池状态（复用工具类，二次校验电量范围）
+            boolean currentIsCharging = BatteryUtils.isCharging(intent);
+            int currentBatteryLevel = BatteryUtils.getCurrentBatteryLevel(intent);
+            currentBatteryLevel = Math.min(Math.max(currentBatteryLevel, BATTERY_LEVEL_MIN), BATTERY_LEVEL_MAX);
+            LogUtils.d(TAG, String.format("handleBatteryStateChanged: 当前状态 | 充电=%b | 电量=%d%%", currentIsCharging, currentBatteryLevel));
+
+            // 2. 状态无变化则跳过，减少无效运算
+            if (currentIsCharging == sLastIsCharging && currentBatteryLevel == sLastBatteryLevel) {
+                LogUtils.d(TAG, "handleBatteryStateChanged: 状态无变化，跳过处理");
+                return;
+            }
+
+            // 3. 同步最新状态到配置工具类
+            if (mAppConfigUtils != null) {
+                if (currentIsCharging != sLastIsCharging) {
+                    mAppConfigUtils.setCharging(currentIsCharging);
+                    LogUtils.d(TAG, String.format("handleBatteryStateChanged: 同步充电状态 | %b", currentIsCharging));
+                }
+                if (currentBatteryLevel != sLastBatteryLevel) {
+                    mAppConfigUtils.setCurrentBatteryValue(currentBatteryLevel);
+                    LogUtils.d(TAG, String.format("handleBatteryStateChanged: 同步电量 | %d%%", currentBatteryLevel));
+                }
+            } else {
+                LogUtils.e(TAG, "handleBatteryStateChanged: AppConfigUtils为空，同步失败");
+            }
+
+            // 4. 执行状态变化后的业务逻辑
+            // 记录电量变化时间
+            if (App.getAppCacheUtils(context) != null) {
+                App.getAppCacheUtils(context).addChangingTime(currentBatteryLevel);
+                LogUtils.d(TAG, "handleBatteryStateChanged: 记录电量变化时间");
+            }
+            // 通知MainActivity更新电量
+            MainActivity.sendCurrentBatteryValueMessage(currentBatteryLevel);
+            LogUtils.d(TAG, String.format("handleBatteryStateChanged: 发送电量更新消息到MainActivity | %d%%", currentBatteryLevel));
+
+            // 5. 更新历史状态缓存
+            sLastIsCharging = currentIsCharging;
+            sLastBatteryLevel = currentBatteryLevel;
+            LogUtils.d(TAG, "handleBatteryStateChanged: 更新历史状态完成");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "handleBatteryStateChanged: 处理失败", e);
+        }
+    }
+
+    // ====================== 广播注册/注销（强化容错，避免重复操作） ======================
+    /**
+     * 注册广播接收器
+     */
+    public void registerAction() {
+        LogUtils.d(TAG, "registerAction: 注册广播");
+        if (mGlobalApplication == null) {
+            LogUtils.e(TAG, "注册失败：App实例为空");
+            return;
+        }
+
+        try {
+            // 先注销再注册，避免重复注册异常
+            unregisterAction();
+            IntentFilter filter = new IntentFilter();
+            filter.addAction(Intent.ACTION_BATTERY_CHANGED);
+            mGlobalApplication.registerReceiver(this, filter);
+            LogUtils.d(TAG, "registerAction: 广播注册成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "registerAction: 注册失败", e);
+        }
+    }
+
+    /**
+     * 注销广播接收器
+     */
+    public void unregisterAction() {
+        LogUtils.d(TAG, "unregisterAction: 注销广播");
+        if (mGlobalApplication == null) {
+            LogUtils.e(TAG, "注销失败：App实例为空");
+            return;
+        }
+
+        try {
+            mGlobalApplication.unregisterReceiver(this);
+            LogUtils.d(TAG, "unregisterAction: 广播注销成功");
+        } catch (IllegalArgumentException e) {
+            LogUtils.w(TAG, "unregisterAction: 广播未注册，跳过注销");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "unregisterAction: 注销失败", e);
+        }
+    }
+
+    // ====================== 资源释放方法（主动释放，彻底避免内存泄漏） ======================
+    /**
+     * 释放接收器资源，供App销毁时调用
+     */
+    public void release() {
+        LogUtils.d(TAG, "release: 释放接收器资源");
+        // 注销广播
+        unregisterAction();
+        // 置空引用，帮助GC回收
+        mGlobalApplication = null;
+        mAppConfigUtils = null;
+        // 重置静态状态缓存
+        sLastBatteryLevel = -1;
+        sLastIsCharging = false;
+        LogUtils.d(TAG, "release: 资源释放完成");
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/MainReceiver.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/MainReceiver.java
new file mode 100644
index 0000000..968c979
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/receivers/MainReceiver.java
@@ -0,0 +1,92 @@
+package cc.winboll.studio.powerbell.receivers;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Build;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.services.ControlCenterService;
+import cc.winboll.studio.powerbell.utils.ServiceUtils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/06 15:01:39
+ * @Describe 应用核心广播接收器
+ * 功能：监听开机完成广播，实现服务开机自启
+ * 适配：Java7 | API30 | 服务启动兼容性处理
+ */
+public class MainReceiver extends BroadcastReceiver {
+    // ====================== 静态常量区（置顶归类，消除魔法值） ======================
+    public static final String TAG = "MainReceiver";
+    // 系统广播Action常量
+    private static final String ACTION_BOOT_COMPLETED = "android.intent.action.BOOT_COMPLETED";
+    // API版本常量（适配前台服务启动要求）
+    private static final int API_LEVEL_26 = 26;
+
+    // ====================== 静态状态标记（volatile保证多线程可见性） ======================
+    // 历史电量值，用于校验电量变化（暂未使用，保留扩展能力）
+    private static volatile int sLastBatteryLevel = -1;
+
+    // ====================== 广播核心接收逻辑（入口方法，分Action处理） ======================
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        // 基础参数校验
+        if (context == null || intent == null) {
+            LogUtils.e(TAG, "onReceive: 上下文或意图为空，终止处理");
+            return;
+        }
+
+        String action = intent.getAction();
+        LogUtils.d(TAG, String.format("onReceive: 接收广播 | Action：%s", action));
+
+        // 仅处理开机完成广播
+        if (ACTION_BOOT_COMPLETED.equals(action)) {
+            handleBootCompleted(context);
+        } else {
+            LogUtils.w(TAG, String.format("onReceive: 忽略未知Action：%s", action));
+        }
+    }
+
+    // ====================== 业务处理方法（处理开机完成广播，实现服务自启） ======================
+    /**
+     * 处理开机完成广播，自动启动控制中心服务
+     * @param context 上下文
+     */
+    private void handleBootCompleted(Context context) {
+        LogUtils.d(TAG, "handleBootCompleted: 开始处理开机完成广播");
+        try {
+            // 1. 校验服务启用状态
+            boolean isServiceEnabled = App.getAppConfigUtils(context).isServiceEnabled();
+            LogUtils.d(TAG, String.format("handleBootCompleted: 服务启用状态：%b", isServiceEnabled));
+            if (!isServiceEnabled) {
+                LogUtils.d(TAG, "handleBootCompleted: 服务未启用，跳过自启");
+                return;
+            }
+
+            // 2. 校验服务是否已运行
+            String serviceClassName = ControlCenterService.class.getName();
+            boolean isServiceAlive = ServiceUtils.isServiceAlive(context.getApplicationContext(), serviceClassName);
+            LogUtils.d(TAG, String.format("handleBootCompleted: 服务运行状态：%b", isServiceAlive));
+            if (isServiceAlive) {
+                LogUtils.d(TAG, "handleBootCompleted: 服务已运行，无需重复启动");
+                return;
+            }
+
+            // 3. 按API版本启动服务（适配前台服务要求）
+            Intent serviceIntent = new Intent(context, ControlCenterService.class);
+            if (Build.VERSION.SDK_INT >= API_LEVEL_26) {
+                context.startForegroundService(serviceIntent);
+                LogUtils.d(TAG, "handleBootCompleted: 启动前台服务（API >= 26）");
+            } else {
+                context.startService(serviceIntent);
+                LogUtils.d(TAG, "handleBootCompleted: 启动普通服务（API < 26）");
+            }
+
+            LogUtils.d(TAG, "handleBootCompleted: 服务自启处理完成");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "handleBootCompleted: 服务自启失败", e);
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/services/AssistantService.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/AssistantService.java
new file mode 100644
index 0000000..9c90f2f
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/AssistantService.java
@@ -0,0 +1,189 @@
+package cc.winboll.studio.powerbell.services;
+
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.Build;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.ServiceUtils;
+
+/**
+ * 电池提醒核心服务进程守护类
+ * 功能：监听主服务 {@link ControlCenterService} 存活状态，异常断开时自动重启并绑定
+ * 适配：Java7 | API30 | 前台服务启动规则 | 服务绑定稳定性保障
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Describe 守护服务：保障ControlCenterService持续运行
+ */
+public class AssistantService extends Service {
+    // ====================== 静态常量区（置顶归类，消除魔法值） ======================
+    private static final String TAG = "AssistantService";
+    // 服务返回策略常量
+    private static final int SERVICE_RETURN_STICKY = START_STICKY;
+    // 服务绑定标记常量
+    private static final int BIND_FLAG = Context.BIND_IMPORTANT;
+    // API版本常量（适配前台服务启动要求）
+    private static final int API_LEVEL_26 = Build.VERSION_CODES.O;
+
+    // ====================== 成员变量区（按功能分层，volatile保证多线程可见性） ======================
+    private AppConfigUtils mAppConfigUtils;
+    private MyServiceConnection mMyServiceConnection;
+    private volatile boolean mIsThreadAlive;
+
+    // ====================== 内部类（服务连接状态监听，前置定义便于引用） ======================
+    /**
+     * 服务连接状态监听器
+     * 主服务连接成功时记录状态，断开时自动重连
+     */
+    private class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            String className = name != null ? name.getClassName() : "null";
+            LogUtils.d(TAG, String.format("onServiceConnected: 主服务连接成功 | 组件名=%s | Binder=%s", className, service));
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            String className = name != null ? name.getClassName() : "null";
+            LogUtils.d(TAG, String.format("onServiceDisconnected: 主服务连接断开 | 组件名=%s", className));
+            // 主服务断开且配置启用时，重新唤醒绑定
+            if (mAppConfigUtils != null && mAppConfigUtils.isServiceEnabled()) {
+                LogUtils.d(TAG, "onServiceDisconnected: 配置启用，尝试重新唤醒并绑定主服务");
+                wakeupAndBindMain();
+            }
+        }
+    }
+
+    // ====================== 服务生命周期方法（按执行顺序排列：onCreate→onStartCommand→onBind→onDestroy） ======================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, String.format("onCreate: 守护服务启动 | 进程ID=%d", android.os.Process.myPid()));
+
+        // 初始化配置工具类，添加空指针防护
+        mAppConfigUtils = App.getAppConfigUtils(this);
+        if (mAppConfigUtils == null) {
+            LogUtils.e(TAG, "onCreate: AppConfigUtils初始化失败，守护服务无法工作");
+            stopSelf();
+            return;
+        }
+
+        // 初始化服务连接对象
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+            LogUtils.d(TAG, "onCreate: ServiceConnection初始化完成");
+        }
+
+        // 初始化运行状态，执行核心守护逻辑
+        mIsThreadAlive = false;
+        run();
+        LogUtils.d(TAG, String.format("onCreate: 守护服务初始化完成 | 服务启用状态=%b", mAppConfigUtils.isServiceEnabled()));
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, String.format("onStartCommand: 守护服务触发重启 | flags=%d | startId=%d", flags, startId));
+        // 配置工具类为空时，直接返回非粘性策略
+        if (mAppConfigUtils == null) {
+            LogUtils.e(TAG, "onStartCommand: AppConfigUtils未初始化，终止服务");
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+
+        run();
+        int returnFlag = mAppConfigUtils.isServiceEnabled() ? SERVICE_RETURN_STICKY : super.onStartCommand(intent, flags, startId);
+        LogUtils.d(TAG, String.format("onStartCommand: 处理完成 | 返回策略=%s", returnFlag == SERVICE_RETURN_STICKY ? "START_STICKY" : "DEFAULT"));
+        return returnFlag;
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.d(TAG, String.format("onBind: 服务绑定请求 | intent=%s", intent));
+        return null;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy: 守护服务销毁流程启动");
+
+        // 重置运行状态，终止守护逻辑
+        mIsThreadAlive = false;
+
+        // 解绑主服务，添加异常捕获防止重复解绑崩溃
+        unbindMainService();
+
+        // 置空工具类引用，帮助GC回收
+        mAppConfigUtils = null;
+        LogUtils.d(TAG, "onDestroy: 守护服务销毁完成");
+    }
+
+    // ====================== 核心业务逻辑（守护主服务存活） ======================
+    /**
+     * 执行守护逻辑：检查主服务状态，按需唤醒并绑定
+     * 前置条件：mAppConfigUtils 必须初始化完成
+     */
+    private void run() {
+        boolean isServiceEnabled = mAppConfigUtils.isServiceEnabled();
+        LogUtils.d(TAG, String.format("run: 执行守护逻辑 | 配置启用=%b | 线程存活=%b", isServiceEnabled, mIsThreadAlive));
+        if (isServiceEnabled) {
+            if (!mIsThreadAlive) {
+                mIsThreadAlive = true;
+                wakeupAndBindMain();
+            }
+        } else {
+            LogUtils.d(TAG, "run: 服务未启用，跳过守护逻辑");
+            // 服务未启用时，重置线程状态
+            mIsThreadAlive = false;
+        }
+    }
+
+    /**
+     * 唤醒主服务并建立绑定，确保主服务持续运行
+     * 适配 API26+ 前台服务启动规则，避免系统限制导致启动失败
+     */
+    private void wakeupAndBindMain() {
+        // 检查主服务存活状态
+        String mainServiceName = ControlCenterService.class.getName();
+        boolean isMainServiceAlive = ServiceUtils.isServiceAlive(getApplicationContext(), mainServiceName);
+        LogUtils.d(TAG, String.format("wakeupAndBindMain: 主服务存活状态=%b", isMainServiceAlive));
+
+        // 主服务未存活时，按需启动（区分API版本）
+        if (!isMainServiceAlive) {
+            Intent mainServiceIntent = new Intent(AssistantService.this, ControlCenterService.class);
+            if (Build.VERSION.SDK_INT >= API_LEVEL_26) {
+                startForegroundService(mainServiceIntent);
+                LogUtils.d(TAG, "wakeupAndBindMain: API26+ 以前台服务方式启动主服务");
+            } else {
+                startService(mainServiceIntent);
+                LogUtils.d(TAG, "wakeupAndBindMain: 以普通服务方式启动主服务");
+            }
+        }
+
+        // 绑定主服务，监听连接状态，添加结果日志
+        Intent bindIntent = new Intent(AssistantService.this, ControlCenterService.class);
+        boolean bindResult = bindService(bindIntent, mMyServiceConnection, BIND_FLAG);
+        LogUtils.d(TAG, String.format("wakeupAndBindMain: 绑定主服务结果=%b | 绑定标记=BIND_IMPORTANT", bindResult));
+    }
+
+    // ====================== 辅助工具方法（拆分独立逻辑，提高可维护性） ======================
+    /**
+     * 解绑主服务，包含异常捕获与状态日志
+     */
+    private void unbindMainService() {
+        if (mMyServiceConnection != null) {
+            try {
+                unbindService(mMyServiceConnection);
+                LogUtils.d(TAG, "unbindMainService: 已成功解绑ControlCenterService");
+            } catch (IllegalArgumentException e) {
+                LogUtils.w(TAG, String.format("unbindMainService: 解绑服务失败，服务未绑定 | %s", e.getMessage()));
+            }
+            mMyServiceConnection = null;
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/services/ControlCenterService.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/ControlCenterService.java
new file mode 100644
index 0000000..f97904d
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/ControlCenterService.java
@@ -0,0 +1,506 @@
+package cc.winboll.studio.powerbell.services;
+
+import android.app.ActivityManager;
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.os.IBinder;
+import android.os.PowerManager;
+import android.provider.Settings;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.handlers.ControlCenterServiceHandler;
+import cc.winboll.studio.powerbell.models.AppConfigBean;
+import cc.winboll.studio.powerbell.models.ControlCenterServiceBean;
+import cc.winboll.studio.powerbell.models.NotificationMessage;
+import cc.winboll.studio.powerbell.receivers.ControlCenterServiceReceiver;
+import cc.winboll.studio.powerbell.threads.RemindThread;
+import cc.winboll.studio.powerbell.utils.NotificationManagerUtils;
+import java.util.List;
+
+/**
+ * 电池提醒核心服务
+ * 功能：管理前台服务生命周期、控制提醒线程启停、处理配置更新
+ * 适配：Java7 | API30 | 前台服务超时防护 | 电池优化忽略引导
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Describe 核心服务：实现电池监测、提醒控制与前台服务保活
+ */
+public class ControlCenterService extends Service {
+    // ====================== 静态常量区（置顶归类，消除魔法值） ======================
+    public static final String TAG = "ControlCenterService";
+    // 线程与服务常量
+    private static final long THREAD_STOP_TIMEOUT = 1000L;
+    private static final int SERVICE_RETURN_STICKY = START_STICKY;
+    private static final int RUNNING_SERVICE_LIST_LIMIT = 100;
+    // 默认配置常量
+    private static final int DEFAULT_CHARGE_REMINDER_VALUE = 80;
+    private static final int DEFAULT_USAGE_REMINDER_VALUE = 20;
+    private static final int DEFAULT_BATTERY_DETECT_INTERVAL = 1000;
+    // API版本常量
+    private static final int API_LEVEL_26 = Build.VERSION_CODES.O;
+    private static final int API_LEVEL_30 = Build.VERSION_CODES.R;
+    private static final int API_LEVEL_23 = Build.VERSION_CODES.M;
+
+    // ====================== 静态状态标记（volatile保证多线程可见性） ======================
+    private static volatile boolean isServiceRunning = false;
+    private static volatile boolean mIsDestroyed = true;
+
+    // ====================== 成员变量区（按功能分层：配置→核心组件→通知相关） ======================
+    // 服务控制配置
+    private ControlCenterServiceBean mServiceControlBean;
+    private AppConfigBean mCurrentConfigBean;
+    // 业务核心组件
+    private ControlCenterServiceHandler mServiceHandler;
+    private ControlCenterServiceReceiver mControlCenterServiceReceiver;
+    // 通知相关
+    private NotificationManagerUtils mNotificationManager;
+    private NotificationMessage mForegroundNotifyMsg;
+
+    // ====================== 服务生命周期方法（按执行顺序：onCreate→onStartCommand→onBind→onDestroy） ======================
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, String.format("onCreate() 执行 | 线程=%s | 进程ID=%d", Thread.currentThread().getName(), android.os.Process.myPid()));
+        runCoreServiceLogic();
+        boolean serviceEnabled = mServiceControlBean != null && mServiceControlBean.isEnableService();
+        LogUtils.d(TAG, String.format("onCreate() 完成 | 前台状态=%b | 服务启用=%b", isServiceRunning, serviceEnabled));
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        String action = intent != null ? intent.getAction() : "null";
+        LogUtils.d(TAG, String.format("onStartCommand() 执行 | startId=%d | action=%s", startId, action));
+        loadLatestServiceControlConfig();
+        runCoreServiceLogic();
+
+        int returnFlag = (mServiceControlBean != null && mServiceControlBean.isEnableService())
+			? SERVICE_RETURN_STICKY
+			: super.onStartCommand(intent, flags, startId);
+        LogUtils.d(TAG, String.format("onStartCommand() 完成 | 返回策略=%s", returnFlag == SERVICE_RETURN_STICKY ? "START_STICKY" : "DEFAULT"));
+        return returnFlag;
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.d(TAG, String.format("onBind() 执行 | intent=%s", intent));
+        return null;
+    }
+
+    @Override
+    public void onDestroy() {
+        LogUtils.d(TAG, "onDestroy() 执行：服务销毁流程启动");
+        super.onDestroy();
+
+        // 资源释放顺序：前台服务 → 线程 → 广播接收器 → Handler → 通知 → 引用（避免内存泄漏）
+        stopForegroundService();
+        RemindThread.stopRemindThread();
+        releaseBroadcastReceiver();
+        destroyHandler();
+        releaseNotificationResource();
+        clearAllReferences();
+
+        // 状态重置
+        mCurrentConfigBean = null;
+        mForegroundNotifyMsg = null;
+        mServiceHandler = null;
+        isServiceRunning = false;
+        mIsDestroyed = true;
+
+        LogUtils.d(TAG, "onDestroy() 完成：服务销毁完成");
+    }
+
+    // ====================== 核心业务逻辑（独立抽取，统一调用） ======================
+    /**
+     * 服务核心运行逻辑，在onCreate/onStartCommand复用
+     * 避免重复初始化，保证前台服务优先启动
+     */
+    private synchronized void runCoreServiceLogic() {
+        LogUtils.d(TAG, "runCoreServiceLogic() 执行");
+        loadLatestServiceControlConfig();
+
+        boolean serviceEnabled = mServiceControlBean != null && mServiceControlBean.isEnableService();
+        LogUtils.d(TAG, String.format("runCoreServiceLogic() | 服务启用=%b | 已运行=%b | 已销毁=%b", serviceEnabled, isServiceRunning, mIsDestroyed));
+
+        if (serviceEnabled && !isServiceRunning) {
+            isServiceRunning = true;
+            mIsDestroyed = false;
+
+            if (initForegroundNotificationImmediately()) {
+                loadDefaultConfig();
+                initServiceBusinessLogic();
+                LogUtils.d(TAG, "runCoreServiceLogic() | 核心组件初始化成功");
+            } else {
+                LogUtils.e(TAG, "runCoreServiceLogic() | 前台通知初始化失败，终止业务");
+                stopForegroundService();
+                isServiceRunning = false;
+            }
+        } else {
+            LogUtils.d(TAG, "runCoreServiceLogic() | 无需执行核心逻辑");
+        }
+    }
+
+    // ====================== 前台通知管理（优先执行，防止API26+前台服务5秒超时） ======================
+    /**
+     * 立即初始化前台通知，防止API26+前台服务超时异常
+     * @return true=成功 false=失败
+     */
+    private boolean initForegroundNotificationImmediately() {
+        LogUtils.d(TAG, "initForegroundNotificationImmediately() 执行");
+        try {
+            if (mNotificationManager == null) {
+                mNotificationManager = new NotificationManagerUtils(this);
+                LogUtils.d(TAG, "initForegroundNotificationImmediately() | 通知工具类初始化完成");
+            }
+
+            if (mForegroundNotifyMsg == null) {
+                mForegroundNotifyMsg = new NotificationMessage();
+                mForegroundNotifyMsg.setTitle("电池监测服务");
+                mForegroundNotifyMsg.setContent("后台运行中");
+                mForegroundNotifyMsg.setRemindMSG("service_running");
+                LogUtils.d(TAG, "initForegroundNotificationImmediately() | 通知消息构建完成");
+            }
+
+            mNotificationManager.startForegroundServiceNotify(this, mForegroundNotifyMsg);
+            ToastUtils.show("电池监测服务已启动");
+            LogUtils.d(TAG, String.format("initForegroundNotificationImmediately() | 前台通知发送成功 | ID=%d", NotificationManagerUtils.NOTIFY_ID_FOREGROUND_SERVICE));
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "initForegroundNotificationImmediately() | 通知初始化异常", e);
+            return false;
+        }
+    }
+
+    /**
+     * 停止前台服务并取消通知
+     */
+    private void stopForegroundService() {
+        LogUtils.d(TAG, "stopForegroundService() 执行");
+        try {
+            stopForeground(true);
+            LogUtils.d(TAG, "stopForegroundService() | 前台服务已停止，通知已取消");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "stopForegroundService() | 停止异常", e);
+        }
+    }
+
+    // ====================== 配置管理（本地持久化+内存同步） ======================
+    /**
+     * 加载本地最新服务控制配置
+     */
+    private void loadLatestServiceControlConfig() {
+        LogUtils.d(TAG, "loadLatestServiceControlConfig() 执行");
+        ControlCenterServiceBean latestBean = ControlCenterServiceBean.loadBean(this, ControlCenterServiceBean.class);
+        if (latestBean != null) {
+            mServiceControlBean = latestBean;
+            LogUtils.d(TAG, String.format("loadLatestServiceControlConfig() | 配置读取成功 | 启用=%b", mServiceControlBean.isEnableService()));
+        } else {
+            LogUtils.w(TAG, "loadLatestServiceControlConfig() | 本地无配置，沿用内存配置");
+        }
+    }
+
+    /**
+     * 加载默认业务配置（首次启动兜底）
+     */
+    private void loadDefaultConfig() {
+        LogUtils.d(TAG, "loadDefaultConfig() 执行");
+        if (mCurrentConfigBean == null) {
+            mCurrentConfigBean = new AppConfigBean();
+            mCurrentConfigBean.setEnableChargeReminder(true);
+            mCurrentConfigBean.setChargeReminderValue(DEFAULT_CHARGE_REMINDER_VALUE);
+            mCurrentConfigBean.setEnableUsageReminder(true);
+            mCurrentConfigBean.setUsageReminderValue(DEFAULT_USAGE_REMINDER_VALUE);
+            mCurrentConfigBean.setBatteryDetectInterval(DEFAULT_BATTERY_DETECT_INTERVAL);
+            LogUtils.d(TAG, String.format("loadDefaultConfig() | 默认配置加载完成 | 充电阈值=%d | 耗电阈值=%d | 检测间隔=%dms",
+										  DEFAULT_CHARGE_REMINDER_VALUE, DEFAULT_USAGE_REMINDER_VALUE, DEFAULT_BATTERY_DETECT_INTERVAL));
+        } else {
+            LogUtils.d(TAG, "loadDefaultConfig() | 内存已有配置，无需加载");
+        }
+    }
+
+    // ====================== 业务组件初始化与销毁（Handler/广播/线程等） ======================
+    /**
+     * 初始化Handler等核心业务组件
+     */
+    private void initServiceBusinessLogic() {
+        LogUtils.d(TAG, "initServiceBusinessLogic() 执行");
+        // 初始化Handler
+        if (mServiceHandler == null) {
+            mServiceHandler = new ControlCenterServiceHandler(this);
+            LogUtils.d(TAG, "initServiceBusinessLogic() | Handler初始化完成");
+        } else {
+            LogUtils.d(TAG, "initServiceBusinessLogic() | Handler已存在");
+        }
+        // 初始化广播接收器
+        if (mControlCenterServiceReceiver == null) {
+            mControlCenterServiceReceiver = new ControlCenterServiceReceiver(this);
+            mControlCenterServiceReceiver.registerAction(this);
+            LogUtils.d(TAG, "initServiceBusinessLogic() | 广播接收器初始化并注册完成");
+        } else {
+            LogUtils.d(TAG, "initServiceBusinessLogic() | 广播接收器已存在");
+        }
+    }
+
+    /**
+     * 释放广播接收器资源
+     */
+    private void releaseBroadcastReceiver() {
+        LogUtils.d(TAG, "releaseBroadcastReceiver() 执行");
+        if (mControlCenterServiceReceiver != null) {
+            mControlCenterServiceReceiver.release();
+            mControlCenterServiceReceiver = null;
+            LogUtils.d(TAG, "releaseBroadcastReceiver() | 广播接收器已释放");
+        } else {
+            LogUtils.w(TAG, "releaseBroadcastReceiver() | 广播接收器实例为空");
+        }
+    }
+
+    /**
+     * 销毁Handler，移除所有消息和回调，防止内存泄漏
+     */
+    private void destroyHandler() {
+        LogUtils.d(TAG, "destroyHandler() 执行");
+        if (mServiceHandler != null) {
+            mServiceHandler.removeCallbacksAndMessages(null);
+            mServiceHandler = null;
+            LogUtils.d(TAG, "destroyHandler() | Handler已销毁");
+        } else {
+            LogUtils.w(TAG, "destroyHandler() | Handler实例为空");
+        }
+    }
+
+    /**
+     * 释放通知工具类资源
+     */
+    private void releaseNotificationResource() {
+        LogUtils.d(TAG, "releaseNotificationResource() 执行");
+        if (mNotificationManager != null) {
+            mNotificationManager.release();
+            mNotificationManager = null;
+            LogUtils.d(TAG, "releaseNotificationResource() | 通知资源已释放");
+        } else {
+            LogUtils.w(TAG, "releaseNotificationResource() | 通知工具类实例为空");
+        }
+    }
+
+    /**
+     * 置空所有引用，防止内存泄漏
+     */
+    private void clearAllReferences() {
+        LogUtils.d(TAG, "clearAllReferences() 执行");
+        mForegroundNotifyMsg = null;
+        mServiceControlBean = null;
+        LogUtils.d(TAG, "clearAllReferences() | 引用清理完成");
+    }
+
+    // ====================== 外部调用接口（静态方法，提供服务启停/配置更新入口） ======================
+    /**
+     * 外部启动服务的统一入口
+     * @param context 上下文
+     */
+    public static void startControlCenterService(Context context) {
+        LogUtils.d(TAG, String.format("startControlCenterService() 执行 | context=%s", context));
+        if (context == null) {
+            LogUtils.e(TAG, "startControlCenterService() | Context为空，启动失败");
+            return;
+        }
+
+        // 保存启用配置
+        ControlCenterServiceBean controlBean = new ControlCenterServiceBean(true);
+        ControlCenterServiceBean.saveBean(context, controlBean);
+        LogUtils.d(TAG, "startControlCenterService() | 服务启用配置已保存");
+
+        // 启动服务（区分API版本）
+        Intent intent = new Intent(context, ControlCenterService.class);
+        if (Build.VERSION.SDK_INT >= API_LEVEL_26) {
+            context.startForegroundService(intent);
+            LogUtils.d(TAG, "startControlCenterService() | 以前台服务方式启动（API26+）");
+        } else {
+            context.startService(intent);
+            LogUtils.d(TAG, "startControlCenterService() | 以普通服务方式启动（API26-）");
+        }
+    }
+
+    /**
+     * 外部停止服务的统一入口
+     * @param context 上下文
+     */
+    public static void stopControlCenterService(Context context) {
+        LogUtils.d(TAG, String.format("stopControlCenterService() 执行 | context=%s", context));
+        if (context == null) {
+            LogUtils.e(TAG, "stopControlCenterService() | Context为空，停止失败");
+            return;
+        }
+
+        // 保存停用配置
+        ControlCenterServiceBean controlBean = new ControlCenterServiceBean(false);
+        ControlCenterServiceBean.saveBean(context, controlBean);
+        LogUtils.d(TAG, "stopControlCenterService() | 服务停用配置已保存");
+
+        // 停止服务
+        Intent intent = new Intent(context, ControlCenterService.class);
+        context.stopService(intent);
+        LogUtils.d(TAG, "stopControlCenterService() | 停止指令已发送");
+    }
+
+    /**
+     * 外部更新配置并触发线程重启
+     * @param context 上下文
+     */
+    public static void sendAppConfigStatusUpdateMessage(Context context) {
+        LogUtils.d(TAG, String.format("sendAppConfigStatusUpdateMessage() 执行 | context=%s", context));
+        if (context == null) {
+            LogUtils.e(TAG, "sendAppConfigStatusUpdateMessage() | 参数为空，更新失败");
+            return;
+        }
+
+        Intent intent = new Intent(ControlCenterServiceReceiver.ACTION_APPCONFIG_CHANGED);
+        intent.setPackage(context.getPackageName());
+        context.sendBroadcast(intent);
+        LogUtils.d(TAG, String.format("sendAppConfigStatusUpdateMessage() | 配置更新广播发送 | action=%s", ControlCenterServiceReceiver.ACTION_APPCONFIG_CHANGED));
+    }
+
+    /**
+     * 检查并引导用户开启忽略电池优化（API23+）
+     * @param context 上下文
+     */
+    public static void checkIgnoreBatteryOptimization(Context context) {
+        LogUtils.d(TAG, String.format("checkIgnoreBatteryOptimization() 执行 | context=%s", context));
+        if (context == null || Build.VERSION.SDK_INT < API_LEVEL_23) {
+            LogUtils.w(TAG, "checkIgnoreBatteryOptimization() | 无需检查（Context为空或API<23）");
+            return;
+        }
+
+        PowerManager powerManager = (PowerManager) context.getSystemService(Context.POWER_SERVICE);
+        if (powerManager == null) {
+            LogUtils.e(TAG, "checkIgnoreBatteryOptimization() | PowerManager获取失败");
+            return;
+        }
+
+        String packageName = context.getPackageName();
+        boolean isIgnored = powerManager.isIgnoringBatteryOptimizations(packageName);
+        LogUtils.d(TAG, String.format("checkIgnoreBatteryOptimization() | 已忽略电池优化=%b", isIgnored));
+
+        if (!isIgnored) {
+            Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
+            intent.setData(Uri.parse("package:" + packageName));
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+            context.startActivity(intent);
+            LogUtils.d(TAG, String.format("checkIgnoreBatteryOptimization() | 已跳转至系统设置页 | package=%s", packageName));
+        }
+    }
+
+    /**
+     * 检查服务是否运行（适配API30+）
+     * @param context      上下文
+     * @param serviceClass 服务类
+     * @return true=运行中 false=未运行
+     */
+    private static boolean isServiceRunning(Context context, Class<?> serviceClass) {
+        LogUtils.d(TAG, String.format("isServiceRunning() 执行 | context=%s | service=%s", context, serviceClass != null ? serviceClass.getName() : "null"));
+        if (context == null || serviceClass == null) {
+            LogUtils.e(TAG, "isServiceRunning() | 参数为空");
+            return false;
+        }
+
+        ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
+        if (am == null) {
+            LogUtils.e(TAG, "isServiceRunning() | ActivityManager获取失败");
+            return false;
+        }
+
+        boolean isRunning = false;
+        String packageName = context.getPackageName();
+        String serviceClassName = serviceClass.getName();
+
+        if (Build.VERSION.SDK_INT >= API_LEVEL_30) {
+            // API30+ 禁止获取其他应用服务，通过进程状态判断
+            List<ActivityManager.RunningAppProcessInfo> processes = am.getRunningAppProcesses();
+            if (processes != null) {
+                for (ActivityManager.RunningAppProcessInfo process : processes) {
+                    if (packageName.equals(process.processName) &&
+						(process.importance == ActivityManager.RunningAppProcessInfo.IMPORTANCE_FOREGROUND_SERVICE ||
+						process.importance == ActivityManager.RunningAppProcessInfo.IMPORTANCE_FOREGROUND)) {
+                        isRunning = true;
+                        break;
+                    }
+                }
+            }
+            LogUtils.d(TAG, String.format("isServiceRunning() | API30+ 判断结果=%b", isRunning));
+        } else {
+            // API30- 通过服务列表判断
+            List<ActivityManager.RunningServiceInfo> services = am.getRunningServices(RUNNING_SERVICE_LIST_LIMIT);
+            if (services != null) {
+                for (ActivityManager.RunningServiceInfo info : services) {
+                    if (serviceClassName.equals(info.service.getClassName())) {
+                        isRunning = true;
+                        break;
+                    }
+                }
+            }
+            LogUtils.d(TAG, String.format("isServiceRunning() | API30- 判断结果=%b", isRunning));
+        }
+
+        // 兜底判断：配置启用状态
+        if (!isRunning) {
+            isRunning = isServiceStarted(context, serviceClass);
+            LogUtils.d(TAG, String.format("isServiceRunning() | 兜底判断结果=%b", isRunning));
+        }
+        return isRunning;
+    }
+
+    /**
+     * 兜底判断服务是否已启动（通过配置文件）
+     */
+    private static boolean isServiceStarted(Context context, Class<?> serviceClass) {
+        LogUtils.d(TAG, "isServiceStarted() 执行");
+        try {
+            ControlCenterServiceBean controlBean = ControlCenterServiceBean.loadBean(context, ControlCenterServiceBean.class);
+            return controlBean != null && controlBean.isEnableService();
+        } catch (Exception e) {
+            LogUtils.e(TAG, "isServiceStarted() | 兜底判断异常", e);
+            return false;
+        }
+    }
+
+    // ====================== 业务方法（配置更新/电池状态回调） ======================
+    /**
+     * 接收外部配置更新，同步到提醒线程
+     * @param latestConfig 最新配置
+     */
+    public void notifyAppConfigUpdate(AppConfigBean latestConfig) {
+        int chargeThreshold = latestConfig != null ? latestConfig.getChargeReminderValue() : -1;
+        int usageThreshold = latestConfig != null ? latestConfig.getUsageReminderValue() : -1;
+        LogUtils.d(TAG, String.format("notifyAppConfigUpdate() 执行 | 充电阈值=%d | 耗电阈值=%d", chargeThreshold, usageThreshold));
+        if (latestConfig != null && mServiceHandler != null) {
+            mCurrentConfigBean = latestConfig;
+            RemindThread.startRemindThreadWithAppConfig(this, mServiceHandler, latestConfig);
+            LogUtils.d(TAG, "notifyAppConfigUpdate() | 配置已同步到提醒线程");
+        } else {
+            LogUtils.e(TAG, String.format("notifyAppConfigUpdate() | 参数为空，同步失败 | latestConfig=%s | mServiceHandler=%s", latestConfig, mServiceHandler));
+        }
+    }
+
+    // ====================== Getter 方法（按需开放，避免冗余Setter） ======================
+    public ControlCenterServiceBean getServiceControlBean() {
+        return mServiceControlBean;
+    }
+
+    public NotificationManagerUtils getNotificationManager() {
+        return mNotificationManager;
+    }
+
+    public NotificationMessage getForegroundNotifyMsg() {
+        return mForegroundNotifyMsg;
+    }
+
+    public AppConfigBean getCurrentConfigBean() {
+        return mCurrentConfigBean;
+    }
+
+    public boolean isDestroyed() {
+        return mIsDestroyed;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/services/TTSPlayService.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/TTSPlayService.java
new file mode 100644
index 0000000..55c09d8
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/TTSPlayService.java
@@ -0,0 +1,83 @@
+package cc.winboll.studio.powerbell.services;
+
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.models.TTSSpeakTextBean;
+import cc.winboll.studio.powerbell.utils.TextToSpeechUtils;
+import java.util.ArrayList;
+
+/**
+ * TTS 语音播放后台服务组件
+ * 适配：Java7 语法规范 | Android API30 系统版本
+ * 功能：后台承载TTS语音播放，解耦页面生命周期，避免页面销毁中断播放
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/29 19:12
+ */
+public class TTSPlayService extends Service {
+
+    // ====================================== 常量区 - 静态全局常量 置顶排序 ======================================
+    public static final String TAG = "TTSPlayService";
+    public static final String EXTRA_SPEAKDATA = "EXTRA_SPEAKDATA";
+
+    // ====================================== 对外公开静态快捷调用方法【新增核心】======================================
+    /**
+     * 公开静态方法：一键启动TTS播放服务，播放指定文本内容
+     * @param context 上下文对象
+     * @param speakText 需要播放的语音文本内容
+     */
+    public static void startPlayTTS(Context context, String speakText) {
+        LogUtils.d(TAG, "【startPlayTTS】静态快捷调用方法 | 入参Context=" + context + " | 播放文本=" + speakText);
+        if (context != null && speakText != null && !speakText.isEmpty()) {
+            // 初始化播放数据集合
+            ArrayList<TTSSpeakTextBean> ttsBeanList = new ArrayList<>();
+            // 添加播放文本，延迟时间为0：无延迟立即播放
+            ttsBeanList.add(new TTSSpeakTextBean(0, speakText));
+            LogUtils.d(TAG, "【startPlayTTS】封装播放数据完成，创建启动服务意图");
+
+            // 创建意图并封装序列化参数
+            Intent intent = new Intent(context, TTSPlayService.class);
+            intent.putExtra(EXTRA_SPEAKDATA, ttsBeanList);
+
+            // 启动当前服务
+            context.startService(intent);
+            LogUtils.d(TAG, "【startPlayTTS】已调用startService，TTS播放服务启动成功");
+        } else {
+            LogUtils.d(TAG, "【startPlayTTS】上下文为空 或 播放文本为空/空字符串，跳过启动服务");
+        }
+    }
+
+    // ====================================== 生命周期方法 - 绑定服务 (无绑定逻辑) ======================================
+    @Override
+    public IBinder onBind(Intent intent) {
+        LogUtils.d(TAG, "【onBind】服务绑定方法调用，入参Intent：" + intent);
+        return null;
+    }
+
+    // ====================================== 生命周期方法 - 启动服务【核心方法】 ======================================
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "【onStartCommand】服务启动方法调用 | 入参Intent：" + intent + " | flags：" + flags + " | startId：" + startId);
+        // 解析播放数据并执行播放
+        if (intent != null) {
+            LogUtils.d(TAG, "【onStartCommand】Intent不为空，开始解析序列化播放数据");
+            ArrayList<TTSSpeakTextBean> listTTSSpeakTextBean = (ArrayList<TTSSpeakTextBean>) intent.getSerializableExtra(EXTRA_SPEAKDATA);
+            if (listTTSSpeakTextBean != null && listTTSSpeakTextBean.size() > 0) {
+                LogUtils.d(TAG, "【onStartCommand】解析播放数据成功，队列长度：" + listTTSSpeakTextBean.size() + "，调用TTS播放工具类");
+                TextToSpeechUtils.getInstance(this).speekTTSList(listTTSSpeakTextBean);
+            } else {
+                LogUtils.d(TAG, "【onStartCommand】播放数据为空/长度0，跳过语音播放逻辑");
+            }
+        } else {
+            LogUtils.d(TAG, "【onStartCommand】Intent为空，无播放数据可解析");
+        }
+        // 返回默认值，保持原服务启动策略不变
+        int result = super.onStartCommand(intent, flags, startId);
+        LogUtils.d(TAG, "【onStartCommand】方法执行完成，返回值：" + result);
+        return result;
+    }
+
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/services/ThoughtfulService.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/ThoughtfulService.java
new file mode 100644
index 0000000..4a3343d
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/services/ThoughtfulService.java
@@ -0,0 +1,221 @@
+package cc.winboll.studio.powerbell.services;
+
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.models.AppConfigBean;
+import cc.winboll.studio.powerbell.models.ThoughtfulServiceBean;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+
+/**
+ * 智能电池服务(充电/放电状态处理)
+ * 适配：Java7 语法规范 | Android API30 系统版本
+ * 功能：接收充电/放电状态指令，根据不同状态执行对应业务任务
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/29 19:29
+ */
+public class ThoughtfulService extends Service {
+
+    // ====================================== 常量区 ======================================
+    public static final String TAG = "ThoughtfulService";
+    public static final String EXTRA_SERVICE_TYPE = "EXTRA_SERVICE_TYPE";
+
+    // 防止重复播报的标志（静态，全局唯一）
+    private static boolean sIsPlaying = false;
+
+    // ====================================== 枚举 ======================================
+    public enum ServiceType {
+        CHARGE_STATE,
+        DISCHARGE_STATE
+		}
+
+    // ====================================== 外部启动入口（加固） ======================================
+    public static void startServiceWithType(Context context, ServiceType serviceType) {
+        LogUtils.d(TAG, "【startServiceWithType】调用 | type=" + (serviceType == null ? "null" : serviceType.name()));
+
+        if (context == null || serviceType == null) {
+            LogUtils.d(TAG, "【startServiceWithType】空参数，直接返回");
+            return;
+        }
+
+        // 1. 预先读取配置，不满足直接不启动服务（最关键拦截）
+        ThoughtfulServiceBean ttsBean = ThoughtfulServiceBean.loadBean(context, ThoughtfulServiceBean.class);
+        if (ttsBean == null) {
+            ttsBean = new ThoughtfulServiceBean();
+        }
+
+        // 充电TTS未开 → 不启动
+        if (serviceType == ServiceType.CHARGE_STATE && !ttsBean.isEnableChargeTts()) {
+            LogUtils.d(TAG, "【startServiceWithType】充电TTS未启用，不启动服务");
+            return;
+        }
+
+        // 用电TTS未开 → 不启动
+        if (serviceType == ServiceType.DISCHARGE_STATE && !ttsBean.isEnableUsePowerTts()) {
+            LogUtils.d(TAG, "【startServiceWithType】用电TTS未启用，不启动服务");
+            return;
+        }
+
+        // 2. 防止重复启动导致叠加播报
+        if (sIsPlaying) {
+            LogUtils.d(TAG, "【startServiceWithType】已有播报任务，跳过本次启动");
+            return;
+        }
+
+        // 3. 真正启动
+        Intent intent = new Intent(context, ThoughtfulService.class);
+        intent.putExtra(EXTRA_SERVICE_TYPE, serviceType);
+        context.startService(intent);
+        LogUtils.d(TAG, "【startServiceWithType】服务启动成功");
+    }
+
+    // ====================================== 生命周期 ======================================
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "【onStartCommand】进入");
+
+        if (intent == null) {
+            LogUtils.d(TAG, "【onStartCommand】intent = null，停止");
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+
+        // 再次防止重复播报（双重保险）
+        if (sIsPlaying) {
+            LogUtils.d(TAG, "【onStartCommand】已有播报，直接停止服务");
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+
+        // 解析类型
+        ServiceType type = (ServiceType) intent.getSerializableExtra(EXTRA_SERVICE_TYPE);
+        if (type == null) {
+            LogUtils.d(TAG, "【onStartCommand】type = null，停止");
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+
+        // 二次校验开关（防止外部绕过 startServiceWithType 直接启动）
+        ThoughtfulServiceBean ttsBean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+        if (ttsBean == null) ttsBean = new ThoughtfulServiceBean();
+
+        boolean allowPlay = false;
+        if (type == ServiceType.CHARGE_STATE && ttsBean.isEnableChargeTts()) {
+            allowPlay = true;
+        }
+        if (type == ServiceType.DISCHARGE_STATE && ttsBean.isEnableUsePowerTts()) {
+            allowPlay = true;
+        }
+
+        if (!allowPlay) {
+            LogUtils.d(TAG, "【onStartCommand】TTS开关已关闭，不执行播报");
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+
+        // 执行任务
+        if (type == ServiceType.CHARGE_STATE) {
+            executeChargeStateTask();
+        } else if (type == ServiceType.DISCHARGE_STATE) {
+            executeDischargeStateTask();
+        }
+
+        return START_NOT_STICKY; // 重要：执行完自动销毁，不保留服务
+    }
+
+    // ====================================== 充电任务 ======================================
+    private void executeChargeStateTask() {
+        LogUtils.d(TAG, "【executeChargeStateTask】执行充电任务");
+
+        sIsPlaying = true; // 锁定播报
+
+        try {
+            AppConfigBean config = AppConfigUtils.getInstance(this).loadAppConfig();
+            if (config == null) {
+                LogUtils.e(TAG, "配置为空，停止");
+                return;
+            }
+
+            ThoughtfulServiceBean ttsBean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+            if (ttsBean == null) ttsBean = new ThoughtfulServiceBean();
+
+            // 主提醒开关未开 → 直接不播
+            if (!config.isEnableChargeReminder()) {
+                LogUtils.d(TAG, "充电提醒总开关关闭，不播报");
+                return;
+            }
+
+            int limit = config.getChargeReminderValue();
+            int battery = App.sQuantityOfElectricity;
+
+            // 电量无效值 → 不拼接电量
+            String batteryStr = "";
+            if (battery >= 0 && battery <= 100 && ttsBean.isEnableChargeTtsWithBattary()) {
+                batteryStr = String.format("当前电量百分之%d。", battery);
+            }
+
+            String text = batteryStr + String.format("限量充电提醒已启用，限值百分之%d。", limit);
+            TTSPlayService.startPlayTTS(this, text);
+            LogUtils.d(TAG, "充电TTS已下发：" + text);
+
+        } finally {
+            sIsPlaying = false; // 释放锁
+            stopSelf();
+        }
+    }
+
+    // ====================================== 放电任务 ======================================
+    private void executeDischargeStateTask() {
+        LogUtils.d(TAG, "【executeDischargeStateTask】执行放电任务");
+
+        sIsPlaying = true;
+
+        try {
+            AppConfigBean config = AppConfigUtils.getInstance(this).loadAppConfig();
+            if (config == null) {
+                LogUtils.e(TAG, "配置为空，停止");
+                return;
+            }
+
+            ThoughtfulServiceBean ttsBean = ThoughtfulServiceBean.loadBean(this, ThoughtfulServiceBean.class);
+            if (ttsBean == null) ttsBean = new ThoughtfulServiceBean();
+
+            // 主提醒开关未开 → 不播
+            if (!config.isEnableUsageReminder()) {
+                LogUtils.d(TAG, "低电提醒总开关关闭，不播报");
+                return;
+            }
+
+            int limit = config.getUsageReminderValue();
+            int battery = App.sQuantityOfElectricity;
+
+            String batteryStr = "";
+            if (battery >= 0 && battery <= 100 && ttsBean.isEnableUseageTtsWithBattary()) {
+                batteryStr = String.format("当前电量百分之%d。", battery);
+            }
+
+            String text = batteryStr + String.format("低电量提醒已启用，限值百分之%d。", limit);
+            TTSPlayService.startPlayTTS(this, text);
+            LogUtils.d(TAG, "放电TTS已下发：" + text);
+
+        } finally {
+            sIsPlaying = false;
+            stopSelf();
+        }
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "【onDestroy】服务已销毁");
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/threads/RemindThread.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/threads/RemindThread.java
new file mode 100644
index 0000000..07a448a
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/threads/RemindThread.java
@@ -0,0 +1,358 @@
+package cc.winboll.studio.powerbell.threads;
+
+import android.content.Context;
+import android.os.Message;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.handlers.ControlCenterServiceHandler;
+import cc.winboll.studio.powerbell.models.AppConfigBean;
+import java.lang.ref.WeakReference;
+import java.util.ArrayList;
+
+/**
+ * 电量通知提醒线程（多实例列表管理）
+ * 功能：管理充电/耗电提醒逻辑，触发条件时向Handler发送提醒消息
+ * 适配：Java7 | API30 | 内存泄漏防护 | 多线程状态同步
+ * 对外接口：{@link #startRemindThreadWithAppConfig(Context, ControlCenterServiceHandler, AppConfigBean)}、
+ * {@link #startRemindThreadWithBatteryInfo(Context, ControlCenterServiceHandler, boolean, int)}、{@link #stopRemindThread()}
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Describe 电量通知提醒线程
+ */
+public class RemindThread extends Thread {
+    // ====================== 静态常量区（置顶归类，消除魔法值） ======================
+    public static final String TAG = "RemindThread";
+
+    // 时间常量 (ms)
+    private static final int MIN_SLEEP_TIME = 2000;
+    private static final long THREAD_JOIN_TIMEOUT = 1000L;
+
+    // 状态常量
+    private static final int BATTERY_LEVEL_MIN = 0;
+    private static final int BATTERY_LEVEL_MAX = 100;
+
+    // 提醒类型常量
+    private static final String REMIND_TYPE_CHARGE = "+";
+    private static final String REMIND_TYPE_USAGE = "-";
+
+    // ====================== 静态成员（多实例列表管理） ======================
+    private static volatile ArrayList<RemindThread> sRemindThreadList;
+
+    // ====================== 成员变量区（按功能分层，volatile保证多线程可见性） ======================
+    // 并发安全锁（保护线程状态变更）
+    private final Object mRemindLock = new Object();
+
+    // 弱引用依赖（防内存泄漏，ApplicationContext 避免 Activity 引用）
+    private Context mContext;
+    private WeakReference<ControlCenterServiceHandler> mwrControlCenterServiceHandler;
+
+    // 线程状态标记（volatile 确保多线程可见）
+    private volatile boolean isReminding;
+    public volatile boolean isExist;
+
+    // 业务配置参数（volatile 确保配置变更实时生效）
+    private volatile boolean isEnableChargeReminder;
+    private volatile boolean isEnableUsageReminder;
+    private volatile long sleepTime;
+    private volatile int chargeReminderValue;
+    private volatile int usageReminderValue;
+    private volatile boolean isCharging;
+
+    // ====================== 私有构造器（禁止外部实例化） ======================
+    private RemindThread(Context context, ControlCenterServiceHandler handler) {
+        LogUtils.d(TAG, String.format("RemindThread() 构造器调用 | context=%s | handler=%s", context, handler));
+        this.mContext = context.getApplicationContext();
+        this.mwrControlCenterServiceHandler = new WeakReference<>(handler);
+        resetThreadStateInternal();
+        LogUtils.d(TAG, String.format("RemindThread() 构造完成 | threadId=%d | 初始状态重置成功", getId()));
+    }
+
+    // ====================== 对外公开静态接口（多实例列表管理） ======================
+    /**
+     * 启动提醒线程，同步最新配置
+     * 逻辑：停止所有旧线程 → 创建新线程 → 加入列表管理
+     * @param context  上下文（非空）
+     * @param handler  服务处理器（非空）
+     * @param config   应用配置Bean（非空）
+     * @return true: 启动成功；false: 入参非法
+     */
+    public static boolean startRemindThreadWithAppConfig(Context context, ControlCenterServiceHandler handler, AppConfigBean config) {
+        LogUtils.d(TAG, String.format("startRemindThreadWithAppConfig() 调用 | context=%s | handler=%s | config=%s", context, handler, config));
+
+        // 入参严格校验
+        if (context == null || handler == null || config == null) {
+            LogUtils.e(TAG, String.format("启动失败：入参为空 | context=%s | handler=%s | config=%s", context, handler, config));
+            return false;
+        }
+
+        // 初始化线程列表（双重校验锁）
+        if (sRemindThreadList == null) {
+            synchronized (RemindThread.class) {
+                if (sRemindThreadList == null) {
+                    sRemindThreadList = new ArrayList<RemindThread>();
+                    LogUtils.d(TAG, "线程列表初始化完成");
+                }
+            }
+        }
+
+        // 停止所有旧线程
+        stopAllOldThreadsInternal();
+
+        // 创建并启动新线程
+        RemindThread newRemindThread = new RemindThread(context, handler);
+        newRemindThread.setAppConfigBean(config);
+        newRemindThread.isExist = false;
+        newRemindThread.start();
+        sRemindThreadList.add(newRemindThread);
+        LogUtils.d(TAG, String.format("新线程启动成功 | threadId=%d | 列表大小=%d", newRemindThread.getId(), sRemindThreadList.size()));
+        return true;
+    }
+
+    /**
+     * 安全停止所有线程，清空列表
+     */
+    public static void stopRemindThread() {
+        int listSize = sRemindThreadList != null ? sRemindThreadList.size() : 0;
+        LogUtils.d(TAG, String.format("stopRemindThread() 调用 | 列表存在=%b | 列表大小=%d", sRemindThreadList != null, listSize));
+        if (sRemindThreadList == null || sRemindThreadList.isEmpty()) {
+            LogUtils.w(TAG, "停止失败：线程列表为空");
+            return;
+        }
+
+        // 标记所有线程退出
+        for (RemindThread remindThread : sRemindThreadList) {
+            remindThread.isExist = true;
+            LogUtils.d(TAG, String.format("标记线程退出 | threadId=%d", remindThread.getId()));
+        }
+        // 清空列表
+        sRemindThreadList.clear();
+        LogUtils.d(TAG, "所有线程已标记退出，列表已清空");
+    }
+
+    // ====================== 私有静态辅助方法（多实例管理） ======================
+    /**
+     * 停止所有旧线程并清空列表
+     */
+    private static void stopAllOldThreadsInternal() {
+        if (sRemindThreadList == null || sRemindThreadList.isEmpty()) {
+            return;
+        }
+
+        // 标记所有旧线程退出
+        for (RemindThread remindThread : sRemindThreadList) {
+            remindThread.isExist = true;
+            LogUtils.d(TAG, String.format("标记旧线程退出 | threadId=%d", remindThread.getId()));
+        }
+        // 清空旧线程列表
+        sRemindThreadList.clear();
+        LogUtils.d(TAG, "旧线程已全部标记退出，列表已清空");
+    }
+
+    // ====================== 线程核心运行逻辑 ======================
+    @Override
+    public void run() {
+        LogUtils.d(TAG, String.format("run() 执行 | threadId=%d | 状态=%s", getId(), getState()));
+
+        // 初始化提醒状态（加锁保护，避免多线程竞争）
+        synchronized (mRemindLock) {
+            if (isReminding) {
+                LogUtils.w(TAG, String.format("线程已在提醒状态，退出运行 | threadId=%d", getId()));
+                return;
+            }
+            isReminding = true;
+        }
+
+        // 核心电量检测循环
+        LogUtils.d(TAG, String.format("进入电量检测循环 | 休眠时间=%dms | threadId=%d", sleepTime, getId()));
+        while (!isExist) {
+            try {
+                // 快速退出判断
+                if (isExist) break;
+
+                // 电量有效性校验（非0-100视为无效），退出电量提醒线程
+                if (App.sQuantityOfElectricity < BATTERY_LEVEL_MIN || App.sQuantityOfElectricity > BATTERY_LEVEL_MAX) {
+                    LogUtils.w(TAG, String.format("电量无效，退出电量提醒线程 | 当前电量=%d | threadId=%d", App.sQuantityOfElectricity, getId()));
+                    break;
+                }
+
+                // 充电/耗电提醒触发逻辑
+                boolean chargeRemindTrigger = isCharging && isEnableChargeReminder && App.sQuantityOfElectricity >= chargeReminderValue;
+                boolean usageRemindTrigger = !isCharging && isEnableUsageReminder && App.sQuantityOfElectricity <= usageReminderValue;
+
+                if (chargeRemindTrigger) {
+                    LogUtils.d(TAG, String.format("触发充电提醒 | 当前电量=%d ≥ 阈值=%d | threadId=%d", App.sQuantityOfElectricity, chargeReminderValue, getId()));
+                    sendNotificationMessageInternal(REMIND_TYPE_CHARGE, App.sQuantityOfElectricity, isCharging);
+                } else if (usageRemindTrigger) {
+                    LogUtils.d(TAG, String.format("触发耗电提醒 | 当前电量=%d ≤ 阈值=%d | threadId=%d", App.sQuantityOfElectricity, usageReminderValue, getId()));
+                    sendNotificationMessageInternal(REMIND_TYPE_USAGE, App.sQuantityOfElectricity, isCharging);
+                } else {
+                    LogUtils.d(TAG, String.format("未有合适类型提醒，退出提醒线程 | threadId=%d", getId()));
+                    break;
+                }
+				
+				// 启动电量通知 TTS 语音提醒线程
+				TTSRemindThread.start(this.mContext, App.sQuantityOfElectricity, isCharging);
+
+                // 安全休眠，保留中断标记
+                safeSleepInternal(sleepTime);
+
+            } catch (Exception e) {
+                LogUtils.e(TAG, String.format("循环运行异常，退出电量提醒线程 | 当前电量=%d | threadId=%d", App.sQuantityOfElectricity, getId()), e);
+                break;
+            }
+        }
+
+        // 循环退出，清理状态
+        cleanThreadStateInternal();
+        LogUtils.d(TAG, String.format("run() 结束 | threadId=%d", getId()));
+    }
+
+    // ====================== 内部业务辅助方法 ======================
+    /**
+     * 发送提醒消息到Handler（弱引用避免内存泄漏）
+     * @param type        提醒类型：+充电/-耗电
+     * @param battery     当前电量
+     * @param isCharging  充电状态
+     */
+    private void sendNotificationMessageInternal(String type, int battery, boolean isCharging) {
+        LogUtils.d(TAG, String.format("sendNotificationMessageInternal() 调用 | 类型=%s | 电量=%d | isCharging=%b | threadId=%d", type, battery, isCharging, getId()));
+        // 前置状态校验
+        if (isExist || !isReminding) {
+            LogUtils.d(TAG, String.format("消息发送跳过：线程已退出或提醒关闭 | threadId=%d", getId()));
+            return;
+        }
+
+        // 获取弱引用的Handler（校验有效性）
+        ControlCenterServiceHandler handler = mwrControlCenterServiceHandler.get();
+        if (handler == null) {
+            LogUtils.w(TAG, String.format("消息发送失败：Handler已被回收 | threadId=%d", getId()));
+            return;
+        }
+
+        // 构建并发送消息
+        Message message = Message.obtain(handler, ControlCenterServiceHandler.MSG_REMIND_TEXT);
+        message.obj = type;
+        message.arg1 = battery;
+        message.arg2 = isCharging ? 1 : 0;
+
+        try {
+            handler.sendMessage(message);
+            LogUtils.d(TAG, String.format("提醒消息发送成功 | 类型=%s | 电量=%d | threadId=%d", type, battery, getId()));
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("消息发送异常 | threadId=%d", getId()), e);
+            // 异常时回收Message，避免内存泄漏
+            if (message != null) {
+                message.recycle();
+            }
+        }
+    }
+
+    /**
+     * 安全休眠，响应线程中断
+     * @param millis 休眠时长(ms)
+     */
+    private void safeSleepInternal(long millis) {
+        LogUtils.d(TAG, String.format("safeSleepInternal() 调用 | 休眠时长=%dms | threadId=%d", millis, getId()));
+        try {
+            Thread.sleep(millis);
+        } catch (InterruptedException e) {
+            Thread.currentThread().interrupt();
+            LogUtils.w(TAG, String.format("休眠被中断，线程准备退出 | threadId=%d", getId()));
+        }
+    }
+
+    /**
+     * 重置线程初始状态（构造器专用）
+     */
+    private void resetThreadStateInternal() {
+        LogUtils.d(TAG, String.format("resetThreadStateInternal() 调用 | threadId=%d", getId()));
+        // 状态标记初始化
+        isExist = false;
+        isReminding = false;
+        // 配置参数初始化
+        isEnableChargeReminder = false;
+        isEnableUsageReminder = false;
+        sleepTime = MIN_SLEEP_TIME;
+        chargeReminderValue = -1;
+        usageReminderValue = -1;
+        isCharging = false;
+        LogUtils.d(TAG, String.format("线程初始状态重置完成 | threadId=%d", getId()));
+    }
+
+    /**
+     * 清理线程运行状态（循环退出时调用）
+     */
+    private void cleanThreadStateInternal() {
+        LogUtils.d(TAG, String.format("cleanThreadStateInternal() 调用 | threadId=%d", getId()));
+		TTSRemindThread.stopTTS();
+        isReminding = false;
+        isExist = true;
+        // 中断当前线程（如果存活）
+        if (isAlive()) {
+            interrupt();
+            LogUtils.d(TAG, String.format("线程已中断 | threadId=%d", getId()));
+        }
+        LogUtils.d(TAG, String.format("线程运行状态清理完成 | threadId=%d", getId()));
+    }
+
+    /**
+     * 同步应用配置，校验参数有效性
+     * @param config 应用配置Bean
+     */
+    public void setAppConfigBean(AppConfigBean config) {
+        LogUtils.d(TAG, String.format("setAppConfigBean() 调用 | config=%s | threadId=%d", config, getId()));
+        if (config == null) {
+            LogUtils.e(TAG, String.format("配置同步失败：配置Bean为空 | threadId=%d", getId()));
+            return;
+        }
+
+        // 配置参数同步 + 范围校验（确保参数合法）
+        isEnableChargeReminder = config.isEnableChargeReminder();
+        isEnableUsageReminder = config.isEnableUsageReminder();
+        chargeReminderValue = Math.min(Math.max(config.getChargeReminderValue(), BATTERY_LEVEL_MIN), BATTERY_LEVEL_MAX);
+        usageReminderValue = Math.min(Math.max(config.getUsageReminderValue(), BATTERY_LEVEL_MIN), BATTERY_LEVEL_MAX);
+        sleepTime = Math.max(config.getBatteryDetectInterval(), MIN_SLEEP_TIME);
+//        sQuantityOfElectricity = (config.getCurrentBatteryValue() >= BATTERY_LEVEL_MIN && config.getCurrentBatteryValue() <= BATTERY_LEVEL_MAX)
+//            ? config.getCurrentBatteryValue() : INVALID_BATTERY_VALUE;
+        isCharging = config.isCharging();
+
+        LogUtils.d(TAG, String.format("配置同步完成 | 休眠时间=%dms | 充电提醒=%b | 耗电提醒=%b | 当前电量=%d | 充电阈值=%d | 耗电阈值=%d | threadId=%d",
+									  sleepTime, isEnableChargeReminder, isEnableUsageReminder, App.sQuantityOfElectricity, chargeReminderValue, usageReminderValue, getId()));
+    }
+
+    /**
+     * 判断线程是否处于运行状态
+     * @return true: 运行中；false: 已停止
+     */
+    private boolean isRunning() {
+        boolean running = !isExist && isAlive();
+        LogUtils.d(TAG, String.format("isRunning() 调用 | 运行中=%b | 退出标记=%b | 存活=%b | threadId=%d", running, isExist, isAlive(), getId()));
+        return running;
+    }
+
+    // ====================== Getter/Setter（按需开放） ======================
+    public void setIsExist(boolean isExist) {
+        LogUtils.d(TAG, String.format("setIsExist() 调用 | isExist=%b | threadId=%d", isExist, getId()));
+        this.isExist = isExist;
+    }
+
+    public boolean isExist() {
+        return isExist;
+    }
+
+    // ====================== 调试辅助方法 ======================
+    @Override
+    public String toString() {
+        return "RemindThread{" +
+            "threadId=" + getId() +
+            ", threadName='" + getName() + '\'' +
+            ", isRunning=" + isRunning() +
+            ", isReminding=" + isReminding +
+            ", chargeThreshold=" + chargeReminderValue +
+            ", usageThreshold=" + usageReminderValue +
+            ", currentBattery=" + App.sQuantityOfElectricity +
+            ", isCharging=" + isCharging +
+            ", sleepTime=" + sleepTime + "ms" +
+            '}';
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/threads/TTSRemindThread.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/threads/TTSRemindThread.java
new file mode 100644
index 0000000..714e0bb
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/threads/TTSRemindThread.java
@@ -0,0 +1,122 @@
+package cc.winboll.studio.powerbell.threads;
+
+import android.content.Context;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.models.ThoughtfulServiceBean;
+import cc.winboll.studio.powerbell.services.TTSPlayService;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/02/28 20:41
+ * @Describe TTS 语音通知线程（单例 + 继承 Thread）
+ */
+public class TTSRemindThread extends Thread {
+
+    public static final String TAG = "TTSRemindThread";
+
+    // 单例实例
+    private static TTSRemindThread sInstance;
+
+    // 运行标志
+    private volatile boolean mIsRunning = false;
+	private volatile int mBattery;
+	private volatile boolean mIsCharging;
+
+    private Context mContext;
+
+    /**
+     * 私有构造，单例禁用外部 new
+     */
+    private TTSRemindThread(Context context) {
+        this.mContext = context.getApplicationContext();
+    }
+
+    /**
+     * 获取单例（DCL 双重校验）
+     */
+    public static TTSRemindThread getInstance(Context context) {
+        if (sInstance == null) {
+            synchronized (TTSRemindThread.class) {
+                if (sInstance == null) {
+                    sInstance = new TTSRemindThread(context);
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    /**
+     * 对外静态启动入口
+     */
+    public static void start(Context context, int battery, boolean isCharging) {
+        TTSRemindThread instance = getInstance(context);
+		instance.mBattery = battery;
+		instance.mIsCharging = isCharging;
+        if (!instance.mIsRunning) {
+            LogUtils.d(TAG, "start() TTS 提醒线程启动");
+            instance.mIsRunning = true;
+            instance.start(); // 启动线程
+        }
+    }
+
+    /**
+     * 对外静态停止入口
+     */
+    public static void stopTTS() {
+        if (sInstance != null) {
+            LogUtils.d(TAG, "stopTTS() TTS 提醒线程停止");
+            sInstance.mIsRunning = false;
+			sInstance = null;
+        }
+    }
+
+    /**
+     * 线程主逻辑
+     */
+    @Override
+    public void run() {
+        super.run();
+        LogUtils.d(TAG, "run() TTS 线程已开始循环");
+
+        while (mIsRunning) {
+            try {
+                // ======================
+                // 在这里写你的循环 TTS 逻辑
+                // ======================
+
+				// TTS 语音通知模块
+				// 读取 TTS 语音通知配置
+				ThoughtfulServiceBean ttsBean = ThoughtfulServiceBean.loadBean(mContext, ThoughtfulServiceBean.class);
+				if (ttsBean == null) {
+					ttsBean = new ThoughtfulServiceBean();
+				}
+				if (ttsBean.isEnableTtsWhenNotifyBattery()) {
+					//ToastUtils.show("Test");
+					// 启动
+					//ToastUtils.show(String.format("mIsCharging %s, mBattery %d", mIsCharging, mBattery));
+					String text = mIsCharging ?"充电": "用电";
+					text += String.format("已达预定值，现在电量为百分之%d", mBattery);
+					TTSPlayService.startPlayTTS(mContext, text);
+				}
+
+                // 防止死循环疯狂跑，加一点休眠
+                sleep(6000);
+            } catch (InterruptedException e) {
+                LogUtils.e(TAG, "TTS 线程被中断", e);
+                break;
+            }
+        }
+
+        mIsRunning = false;
+        LogUtils.d(TAG, "run() TTS 线程已退出");
+    }
+
+    /**
+     * 是否正在运行
+     */
+    public boolean isRunning() {
+        return mIsRunning;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/MainUnitTest2Activity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/MainUnitTest2Activity.java
new file mode 100644
index 0000000..27e68aa
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/MainUnitTest2Activity.java
@@ -0,0 +1,285 @@
+package cc.winboll.studio.powerbell.unittest;
+
+import android.content.Intent;
+import android.os.Bundle;
+import android.os.Environment;
+import android.os.Handler;
+import android.os.Looper;
+import android.view.View;
+import android.widget.Button;
+import android.widget.LinearLayout;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.utils.FileUtils;
+import cc.winboll.studio.powerbell.utils.ImageCropUtils;
+import cc.winboll.studio.powerbell.utils.ImageUtils;
+import cc.winboll.studio.powerbell.views.MemoryCachedBackgroundView;
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStream;
+
+/**
+ * 单元测试页面2（内存缓存背景视图专用）
+ * 功能：测试MemoryCachedBackgroundView加载、图片裁剪、双重刷新预览等功能
+ * 适配：Java7 | API30 | 私有目录文件操作 | 无Uri冲突 | 内存缓存视图
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Describe 单元测试页2：验证带内存缓存的背景视图相关逻辑
+ */
+public class MainUnitTest2Activity extends AppCompatActivity {
+    // ====================== 静态常量区（置顶归类，消除魔法值） ======================
+    public static final String TAG = "MainUnitTest2Activity";
+    public static final int REQUEST_CROP_IMAGE = 0;
+    private static final String ASSETS_TEST_IMAGE_PATH = "unittest/unittest-miku.png";
+    private static final long FILE_MIN_SIZE = 100L;
+    private static final long DOUBLE_REFRESH_DELAY = 200L;
+
+    // ====================== 成员变量区（按功能分层，移除所有Uri相关） ======================
+    private MemoryCachedBackgroundView mMemoryCachedBackgroundView;
+    private LinearLayout mllBackgroundView;
+    private String mAppPrivateDirPath;
+    private File mPrivateTestImageFile;
+    private File mPrivateCropImageFile;
+    private BackgroundBean mPreviewBackgroundBean;
+
+    // ====================== 生命周期方法（按执行顺序：onCreate→onActivityResult） ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "=== 页面 onCreate 启动 ===");
+
+        initBaseParams();
+        initViewAndEvent();
+        copyAssetsTestImageToPrivateDir();
+        initBackgroundBean();
+        doubleRefreshPreview();
+
+        ToastUtils.show("单元测试页面2启动完成");
+        LogUtils.d(TAG, "=== 页面 onCreate 初始化结束 ===");
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        LogUtils.d(TAG, String.format("=== onActivityResult 回调 | requestCode=%d | resultCode=%d ===", requestCode, resultCode));
+        if (requestCode == REQUEST_CROP_IMAGE) {
+            handleCropResult(resultCode);
+        }
+    }
+
+    // ====================== 初始化相关方法（基础参数→视图→背景Bean） ======================
+    /**
+     * 初始化基础参数：私有目录、测试文件
+     */
+    private void initBaseParams() {
+        LogUtils.d(TAG, "initBaseParams：初始化基础参数");
+        // 初始化私有目录（无需权限，无UID冲突）
+        mAppPrivateDirPath = getExternalFilesDir(Environment.DIRECTORY_PICTURES).getAbsolutePath() + "/PowerBellTest/";
+        File privateDir = new File(mAppPrivateDirPath);
+        if (!privateDir.exists()) {
+            boolean isDirCreated = privateDir.mkdirs();
+            LogUtils.d(TAG, String.format("initBaseParams：创建私有目录 | 路径=%s | 结果=%b", mAppPrivateDirPath, isDirCreated));
+        }
+
+        // 初始化测试文件与裁剪文件（无Uri）
+        File refFile = new File(ASSETS_TEST_IMAGE_PATH);
+        String uniqueTestName = FileUtils.createUniqueFileName(refFile) + ".png";
+        String uniqueCropName = uniqueTestName.replace(".png", "_crop.png");
+        mPrivateTestImageFile = new File(mAppPrivateDirPath, uniqueTestName);
+        mPrivateCropImageFile = new File(mAppPrivateDirPath, uniqueCropName);
+
+        LogUtils.d(TAG, String.format("initBaseParams：测试图路径=%s", mPrivateTestImageFile.getAbsolutePath()));
+        LogUtils.d(TAG, String.format("initBaseParams：裁剪图路径=%s", mPrivateCropImageFile.getAbsolutePath()));
+    }
+
+    /**
+     * 初始化布局与控件事件（含单例视图创建）
+     */
+    private void initViewAndEvent() {
+        LogUtils.d(TAG, "initViewAndEvent：初始化布局与控件事件");
+        setContentView(R.layout.activity_mainunittest2);
+        mllBackgroundView = (LinearLayout) findViewById(R.id.ll_backgroundview);
+
+        // 创建MemoryCachedBackgroundView单例并添加到布局
+		int nCurrentPixelColor = BackgroundSourceUtils.getInstance(this).getCurrentBackgroundBean().getPixelColor();
+        mMemoryCachedBackgroundView = MemoryCachedBackgroundView.getLastInstance(this);
+        mllBackgroundView.addView(mMemoryCachedBackgroundView);
+        LogUtils.d(TAG, "initViewAndEvent：内存缓存背景视图实例创建并添加完成");
+
+        // 跳转主页面按钮
+        Button btnMain = (Button) findViewById(R.id.btn_main_activity);
+        btnMain.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "initViewAndEvent：点击按钮→跳转主页面");
+					startActivity(new Intent(MainUnitTest2Activity.this, MainActivity.class));
+				}
+			});
+
+        // 裁剪按钮（直接用File路径启动，无Uri）
+        Button btnCrop = (Button) findViewById(R.id.btn_test_cropimage);
+        btnCrop.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "initViewAndEvent：点击按钮→启动裁剪（File路径版）");
+					ToastUtils.show("准备启动图片裁剪");
+
+					if (isFileValid(mPrivateTestImageFile)) {
+						startCropTestByFile();
+					} else {
+						ToastUtils.show("测试图片未准备好，重新拷贝");
+						copyAssetsTestImageToPrivateDir();
+					}
+				}
+			});
+    }
+
+    /**
+     * 初始化背景Bean
+     */
+    private void initBackgroundBean() {
+        LogUtils.d(TAG, "initBackgroundBean：初始化背景Bean");
+        mPreviewBackgroundBean = new BackgroundBean();
+		mPreviewBackgroundBean.setPixelColor(ImageUtils.getColorAccent(this));
+        mPreviewBackgroundBean.setBackgroundFileName(mPrivateTestImageFile.getName());
+        mPreviewBackgroundBean.setBackgroundFilePath(mPrivateTestImageFile.getAbsolutePath());
+        mPreviewBackgroundBean.setBackgroundScaledCompressFileName(mPrivateCropImageFile.getName());
+        mPreviewBackgroundBean.setBackgroundScaledCompressFilePath(mPrivateCropImageFile.getAbsolutePath());
+        mPreviewBackgroundBean.setIsUseBackgroundFile(true);
+        LogUtils.d(TAG, "initBackgroundBean：背景Bean初始化完成");
+    }
+
+    // ====================== 核心业务方法（文件拷贝→裁剪→结果处理→预览刷新） ======================
+    /**
+     * 从assets拷贝图片到私有目录
+     */
+    private void copyAssetsTestImageToPrivateDir() {
+        LogUtils.d(TAG, "copyAssetsTestImageToPrivateDir：开始拷贝assets图片到私有目录");
+        if (isFileValid(mPrivateTestImageFile)) {
+            LogUtils.d(TAG, "copyAssetsTestImageToPrivateDir：图片已存在，无需拷贝");
+            return;
+        }
+
+        InputStream inputStream = null;
+        try {
+            inputStream = getAssets().open(ASSETS_TEST_IMAGE_PATH);
+            FileUtils.copyStreamToFile(inputStream, mPrivateTestImageFile);
+            LogUtils.d(TAG, String.format("copyAssetsTestImageToPrivateDir：图片拷贝成功 | 大小=%d字节", mPrivateTestImageFile.length()));
+        } catch (IOException e) {
+            LogUtils.e(TAG, String.format("copyAssetsTestImageToPrivateDir：图片拷贝失败 | %s", e.getMessage()), e);
+            ToastUtils.show("图片准备失败");
+        } finally {
+            if (inputStream != null) {
+                try {
+                    inputStream.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, String.format("copyAssetsTestImageToPrivateDir：关闭流失败 | %s", e.getMessage()));
+                }
+            }
+        }
+    }
+
+    /**
+     * 直接用File启动裁剪（关键：调用ImageCropUtils的File重载方法）
+     */
+    private void startCropTestByFile() {
+        LogUtils.d(TAG, String.format("startCropTestByFile：启动裁剪 | 原图=%s", mPrivateTestImageFile.getAbsolutePath()));
+
+        // 确保输出目录存在
+        File cropParent = mPrivateCropImageFile.getParentFile();
+        if (!cropParent.exists()) {
+            boolean isDirCreated = cropParent.mkdirs();
+            LogUtils.d(TAG, String.format("startCropTestByFile：创建裁剪目录 | 路径=%s | 结果=%b", cropParent.getAbsolutePath(), isDirCreated));
+        }
+
+        // 调用ImageCropUtils的File参数方法（核心：绕开Uri）
+        ImageCropUtils.startImageCrop(
+			this,
+			mPrivateTestImageFile,
+			mPrivateCropImageFile,
+			0,
+			0,
+			true,
+			REQUEST_CROP_IMAGE
+        );
+
+        LogUtils.d(TAG, String.format("startCropTestByFile：裁剪请求已发送 | 输出路径=%s", mPrivateCropImageFile.getAbsolutePath()));
+        ToastUtils.show("已启动图片裁剪");
+    }
+
+    /**
+     * 处理裁剪结果（直接校验输出File）
+     * @param resultCode 裁剪结果码
+     */
+    private void handleCropResult(int resultCode) {
+        LogUtils.d(TAG, String.format("handleCropResult：裁剪回调处理 | resultCode=%d", resultCode));
+        if (resultCode == RESULT_OK) {
+            if (isFileValid(mPrivateCropImageFile)) {
+				int nCurrentPixelColor = BackgroundSourceUtils.getInstance(this).getCurrentBackgroundBean().getPixelColor();
+                mMemoryCachedBackgroundView.loadImage(nCurrentPixelColor, mPrivateCropImageFile.getAbsolutePath(), true);
+                LogUtils.d(TAG, String.format("handleCropResult：裁剪成功 | 加载裁剪图=%s", mPrivateCropImageFile.getAbsolutePath()));
+                ToastUtils.show("裁剪成功");
+                mPreviewBackgroundBean.setIsUseBackgroundScaledCompressFile(true);
+                doubleRefreshPreview();
+            } else {
+                LogUtils.e(TAG, "handleCropResult：裁剪成功但输出文件无效");
+                ToastUtils.show("裁剪失败：输出文件无效");
+            }
+        } else if (resultCode == RESULT_CANCELED) {
+            LogUtils.d(TAG, "handleCropResult：裁剪取消");
+            ToastUtils.show("裁剪已取消");
+        } else {
+            LogUtils.e(TAG, String.format("handleCropResult：裁剪失败 | resultCode异常=%d", resultCode));
+            ToastUtils.show("裁剪失败");
+        }
+    }
+
+    /**
+     * 双重刷新预览，确保背景加载最新数据
+     */
+    private void doubleRefreshPreview() {
+        LogUtils.d(TAG, "doubleRefreshPreview：执行双重刷新预览");
+        // 第一重刷新
+        try {
+            mMemoryCachedBackgroundView.loadByBackgroundBean(mPreviewBackgroundBean, true);
+            //mMemoryCachedBackgroundView.setBackgroundColor(mPreviewBackgroundBean.getPixelColor());
+            LogUtils.d(TAG, "doubleRefreshPreview：【双重刷新】第一重完成");
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("doubleRefreshPreview：【双重刷新】第一重异常 | %s", e.getMessage()));
+            return;
+        }
+
+        // 第二重刷新（延迟执行）
+        new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					if (mMemoryCachedBackgroundView != null && !isFinishing()) {
+						try {
+							mMemoryCachedBackgroundView.loadByBackgroundBean(mPreviewBackgroundBean, true);
+							//mMemoryCachedBackgroundView.setBackgroundColor(mPreviewBackgroundBean.getPixelColor());
+							LogUtils.d(TAG, "doubleRefreshPreview：【双重刷新】第二重完成");
+						} catch (Exception e) {
+							LogUtils.e(TAG, String.format("doubleRefreshPreview：【双重刷新】第二重异常 | %s", e.getMessage()));
+						}
+					}
+				}
+			}, DOUBLE_REFRESH_DELAY);
+    }
+
+    // ====================== 工具辅助方法（文件校验） ======================
+    /**
+     * 校验文件是否有效（存在且大小达标）
+     * @param file 待校验文件
+     * @return true=有效 false=无效
+     */
+    private boolean isFileValid(File file) {
+        boolean isValid = file != null && file.exists() && file.length() > FILE_MIN_SIZE;
+        LogUtils.d(TAG, String.format("isFileValid：文件校验 | 路径=%s | 结果=%b", file != null ? file.getAbsolutePath() : "null", isValid));
+        return isValid;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/MainUnitTestActivity.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/MainUnitTestActivity.java
new file mode 100644
index 0000000..c66817f
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/unittest/MainUnitTestActivity.java
@@ -0,0 +1,275 @@
+package cc.winboll.studio.powerbell.unittest;
+
+import android.content.Intent;
+import android.os.Bundle;
+import android.os.Environment;
+import android.os.Handler;
+import android.os.Looper;
+import android.view.View;
+import android.widget.Button;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.FileUtils;
+import cc.winboll.studio.powerbell.utils.ImageCropUtils;
+import cc.winboll.studio.powerbell.utils.ImageUtils;
+import cc.winboll.studio.powerbell.views.BackgroundView;
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStream;
+
+/**
+ * 单元测试页面
+ * 功能：测试背景图加载、图片裁剪、双重刷新预览等功能
+ * 适配：Java7 | API30 | 私有目录文件操作 | 无Uri冲突
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Describe 单元测试页：验证图片处理与背景预览相关逻辑
+ */
+public class MainUnitTestActivity extends AppCompatActivity {
+    // ====================== 静态常量区（置顶归类，消除魔法值） ======================
+    public static final String TAG = "MainUnitTestActivity";
+    public static final int REQUEST_CROP_IMAGE = 0;
+    private static final String ASSETS_TEST_IMAGE_PATH = "unittest/unittest-miku.png";
+    private static final long FILE_MIN_SIZE = 100L;
+    private static final long DOUBLE_REFRESH_DELAY = 200L;
+
+    // ====================== 成员变量区（按功能分层，移除所有Uri相关） ======================
+    private BackgroundView mBackgroundView;
+    private String mAppPrivateDirPath;
+    private File mPrivateTestImageFile; // 仅用File，不用Uri
+    private File mPrivateCropImageFile;
+    private BackgroundBean mPreviewBackgroundBean;
+
+    // ====================== 生命周期方法（按执行顺序：onCreate→onActivityResult） ======================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "=== 页面 onCreate 启动 ===");
+
+        initBaseParams();
+        initViewAndEvent();
+        copyAssetsTestImageToPrivateDir();
+        initBackgroundBean();
+        doubleRefreshPreview();
+
+        ToastUtils.show("单元测试页面启动完成");
+        LogUtils.d(TAG, "=== 页面 onCreate 初始化结束 ===");
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        LogUtils.d(TAG, String.format("=== onActivityResult 回调 | requestCode=%d | resultCode=%d ===", requestCode, resultCode));
+        if (requestCode == REQUEST_CROP_IMAGE) {
+            handleCropResult(resultCode);
+        }
+    }
+
+    // ====================== 初始化相关方法（基础参数→视图→背景Bean） ======================
+    /**
+     * 初始化基础参数：私有目录、测试文件
+     */
+    private void initBaseParams() {
+        LogUtils.d(TAG, "initBaseParams：初始化基础参数");
+        // 初始化私有目录（无需权限，无UID冲突）
+        mAppPrivateDirPath = getExternalFilesDir(Environment.DIRECTORY_PICTURES).getAbsolutePath() + "/PowerBellTest/";
+        File privateDir = new File(mAppPrivateDirPath);
+        if (!privateDir.exists()) {
+            boolean isDirCreated = privateDir.mkdirs();
+            LogUtils.d(TAG, String.format("initBaseParams：创建私有目录 | 路径=%s | 结果=%b", mAppPrivateDirPath, isDirCreated));
+        }
+
+        // 初始化测试文件与裁剪文件（无Uri）
+        File refFile = new File(ASSETS_TEST_IMAGE_PATH);
+        String uniqueTestName = FileUtils.createUniqueFileName(refFile) + ".png";
+        String uniqueCropName = uniqueTestName.replace(".png", "_crop.png");
+        mPrivateTestImageFile = new File(mAppPrivateDirPath, uniqueTestName);
+        mPrivateCropImageFile = new File(mAppPrivateDirPath, uniqueCropName);
+
+        LogUtils.d(TAG, String.format("initBaseParams：测试图路径=%s", mPrivateTestImageFile.getAbsolutePath()));
+        LogUtils.d(TAG, String.format("initBaseParams：裁剪图路径=%s", mPrivateCropImageFile.getAbsolutePath()));
+    }
+
+    /**
+     * 初始化布局与控件事件
+     */
+    private void initViewAndEvent() {
+        LogUtils.d(TAG, "initViewAndEvent：初始化布局与控件事件");
+        setContentView(R.layout.activity_mainunittest);
+        mBackgroundView = (BackgroundView) findViewById(R.id.backgroundview);
+
+        // 跳转主页面按钮
+        Button btnMain = (Button) findViewById(R.id.btn_main_activity);
+        btnMain.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "initViewAndEvent：点击按钮→跳转主页面");
+					startActivity(new Intent(MainUnitTestActivity.this, MainActivity.class));
+				}
+			});
+
+        // 裁剪按钮（直接用File路径启动，无Uri）
+        Button btnCrop = (Button) findViewById(R.id.btn_test_cropimage);
+        btnCrop.setOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "initViewAndEvent：点击按钮→启动裁剪（File路径版）");
+					ToastUtils.show("准备启动图片裁剪");
+
+					if (isFileValid(mPrivateTestImageFile)) {
+						startCropTestByFile();
+					} else {
+						ToastUtils.show("测试图片未准备好，重新拷贝");
+						copyAssetsTestImageToPrivateDir();
+					}
+				}
+			});
+    }
+
+    /**
+     * 初始化背景Bean
+     */
+    private void initBackgroundBean() {
+        LogUtils.d(TAG, "initBackgroundBean：初始化背景Bean");
+        mPreviewBackgroundBean = new BackgroundBean();
+		mPreviewBackgroundBean.setPixelColor(ImageUtils.getColorAccent(this));
+        mPreviewBackgroundBean.setBackgroundFileName(mPrivateTestImageFile.getName());
+        mPreviewBackgroundBean.setBackgroundFilePath(mPrivateTestImageFile.getAbsolutePath());
+        mPreviewBackgroundBean.setBackgroundScaledCompressFileName(mPrivateCropImageFile.getName());
+        mPreviewBackgroundBean.setBackgroundScaledCompressFilePath(mPrivateCropImageFile.getAbsolutePath());
+        mPreviewBackgroundBean.setIsUseBackgroundFile(true);
+        LogUtils.d(TAG, "initBackgroundBean：背景Bean初始化完成");
+    }
+
+    // ====================== 核心业务方法（文件拷贝→裁剪→结果处理→预览刷新） ======================
+    /**
+     * 从assets拷贝图片到私有目录
+     */
+    private void copyAssetsTestImageToPrivateDir() {
+        LogUtils.d(TAG, "copyAssetsTestImageToPrivateDir：开始拷贝assets图片到私有目录");
+        if (isFileValid(mPrivateTestImageFile)) {
+            LogUtils.d(TAG, "copyAssetsTestImageToPrivateDir：图片已存在，无需拷贝");
+            return;
+        }
+
+        InputStream inputStream = null;
+        try {
+            inputStream = getAssets().open(ASSETS_TEST_IMAGE_PATH);
+            FileUtils.copyStreamToFile(inputStream, mPrivateTestImageFile);
+            LogUtils.d(TAG, String.format("copyAssetsTestImageToPrivateDir：图片拷贝成功 | 大小=%d字节", mPrivateTestImageFile.length()));
+        } catch (IOException e) {
+            LogUtils.e(TAG, String.format("copyAssetsTestImageToPrivateDir：图片拷贝失败 | %s", e.getMessage()), e);
+            ToastUtils.show("图片准备失败");
+        } finally {
+            if (inputStream != null) {
+                try {
+                    inputStream.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, String.format("copyAssetsTestImageToPrivateDir：关闭流失败 | %s", e.getMessage()));
+                }
+            }
+        }
+    }
+
+    /**
+     * 直接用File启动裁剪（关键：调用ImageCropUtils的File重载方法）
+     */
+    private void startCropTestByFile() {
+        LogUtils.d(TAG, String.format("startCropTestByFile：启动裁剪 | 原图=%s", mPrivateTestImageFile.getAbsolutePath()));
+
+        // 确保输出目录存在
+        File cropParent = mPrivateCropImageFile.getParentFile();
+        if (!cropParent.exists()) {
+            boolean isDirCreated = cropParent.mkdirs();
+            LogUtils.d(TAG, String.format("startCropTestByFile：创建裁剪目录 | 路径=%s | 结果=%b", cropParent.getAbsolutePath(), isDirCreated));
+        }
+
+        // 调用ImageCropUtils的File参数方法（核心：绕开Uri）
+        ImageCropUtils.startImageCrop(
+			this,
+			mPrivateTestImageFile, // 原图File
+			mPrivateCropImageFile, // 输出File
+			0,
+			0,
+			true,
+			REQUEST_CROP_IMAGE
+        );
+
+        LogUtils.d(TAG, String.format("startCropTestByFile：裁剪请求已发送 | 输出路径=%s", mPrivateCropImageFile.getAbsolutePath()));
+        ToastUtils.show("已启动图片裁剪");
+    }
+
+    /**
+     * 处理裁剪结果（直接校验输出File）
+     * @param resultCode 裁剪结果码
+     */
+    private void handleCropResult(int resultCode) {
+//        LogUtils.d(TAG, String.format("handleCropResult：裁剪回调处理 | resultCode=%d", resultCode));
+//        if (resultCode == RESULT_OK) {
+//            if (isFileValid(mPrivateCropImageFile)) {
+//                mBackgroundView.loadImage(mPrivateCropImageFile.getAbsolutePath());
+//                LogUtils.d(TAG, String.format("handleCropResult：裁剪成功 | 加载裁剪图=%s", mPrivateCropImageFile.getAbsolutePath()));
+//                ToastUtils.show("裁剪成功");
+//                mPreviewBackgroundBean.setIsUseBackgroundScaledCompressFile(true);
+//                doubleRefreshPreview();
+//            } else {
+//                LogUtils.e(TAG, "handleCropResult：裁剪成功但输出文件无效");
+//                ToastUtils.show("裁剪失败：输出文件无效");
+//            }
+//        } else if (resultCode == RESULT_CANCELED) {
+//            LogUtils.d(TAG, "handleCropResult：裁剪取消");
+//            ToastUtils.show("裁剪已取消");
+//        } else {
+//            LogUtils.e(TAG, String.format("handleCropResult：裁剪失败 | resultCode异常=%d", resultCode));
+//            ToastUtils.show("裁剪失败");
+//        }
+    }
+
+    /**
+     * 双重刷新预览，确保背景加载最新数据
+     */
+    private void doubleRefreshPreview() {
+        LogUtils.d(TAG, "doubleRefreshPreview：执行双重刷新预览");
+        // 第一重刷新
+        try {
+            mBackgroundView.loadByBackgroundBean(mPreviewBackgroundBean, true);
+            mBackgroundView.setBackgroundColor(mPreviewBackgroundBean.getPixelColor());
+            LogUtils.d(TAG, "doubleRefreshPreview：【双重刷新】第一重完成");
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("doubleRefreshPreview：【双重刷新】第一重异常 | %s", e.getMessage()));
+            return;
+        }
+
+        // 第二重刷新（延迟执行）
+        new Handler(Looper.getMainLooper()).postDelayed(new Runnable() {
+				@Override
+				public void run() {
+					if (mBackgroundView != null && !isFinishing()) {
+						try {
+							mBackgroundView.loadByBackgroundBean(mPreviewBackgroundBean, true);
+							mBackgroundView.setBackgroundColor(mPreviewBackgroundBean.getPixelColor());
+							LogUtils.d(TAG, "doubleRefreshPreview：【双重刷新】第二重完成");
+						} catch (Exception e) {
+							LogUtils.e(TAG, String.format("doubleRefreshPreview：【双重刷新】第二重异常 | %s", e.getMessage()));
+						}
+					}
+				}
+			}, DOUBLE_REFRESH_DELAY);
+    }
+
+    // ====================== 工具辅助方法（文件校验） ======================
+    /**
+     * 校验文件是否有效（存在且大小达标）
+     * @param file 待校验文件
+     * @return true=有效 false=无效
+     */
+    private boolean isFileValid(File file) {
+        boolean isValid = file != null && file.exists() && file.length() > FILE_MIN_SIZE;
+        LogUtils.d(TAG, String.format("isFileValid：文件校验 | 路径=%s | 结果=%b", file != null ? file.getAbsolutePath() : "null", isValid));
+        return isValid;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/APPPlusUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/APPPlusUtils.java
new file mode 100644
index 0000000..181e3d8
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/APPPlusUtils.java
@@ -0,0 +1,203 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Build;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.R;
+
+/**
+ * 应用图标切换工具类（启用组件时创建对应快捷方式）
+ * 适配：Java7 | API30 | 高低版本快捷方式创建兼容
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Describe 应用启动器组件切换与桌面快捷方式创建工具，支持多组件管理与版本兼容
+ */
+public class APPPlusUtils {
+    // ======================== 静态常量区（魔法值与标签管理）========================
+    public static final String TAG = "APPPlusUtils";
+    private static final int SHORTCUT_ICON_DEFAULT = R.drawable.ic_launcher; // 默认快捷方式图标
+    private static final String ACTION_INSTALL_SHORTCUT = "com.android.launcher.action.INSTALL_SHORTCUT"; // 旧版快捷方式广播Action
+
+    // ======================== 公共业务方法区（对外核心接口）========================
+    /**
+     * 切换应用启动器组件（禁用其他组件，启用目标组件）
+     * @param context 上下文
+     * @param componentName 目标组件完整类名
+     * @return 切换是否成功
+     */
+    public static boolean switchAppLauncherToComponent(Context context, String componentName) {
+        LogUtils.d(TAG, String.format("switchAppLauncherToComponent调用 | 传入组件名=%s", componentName));
+
+        // 参数校验
+        if (context == null) {
+            LogUtils.e(TAG, "switchAppLauncherToComponent失败：上下文为空");
+            return false;
+        }
+        if (componentName == null || componentName.isEmpty()) {
+            LogUtils.e(TAG, "switchAppLauncherToComponent失败：组件名为空");
+            return false;
+        }
+
+        PackageManager pm = context.getPackageManager();
+        ComponentName targetComponent = new ComponentName(context, componentName);
+        ComponentName en1Component = new ComponentName(context, App.COMPONENT_EN1);
+        ComponentName cn1Component = new ComponentName(context, App.COMPONENT_CN1);
+        ComponentName cn2Component = new ComponentName(context, App.COMPONENT_CN2);
+
+        try {
+            // 禁用所有其他启动器组件
+            disableComponent(pm, en1Component);
+            disableComponent(pm, cn1Component);
+            disableComponent(pm, cn2Component);
+            // 启用目标组件
+            enableComponent(pm, targetComponent);
+
+            LogUtils.d(TAG, String.format("switchAppLauncherToComponent成功 | 目标组件=%s", componentName));
+            Toast.makeText(context, context.getString(R.string.app_name) + "图标切换成功", Toast.LENGTH_SHORT).show();
+            return true;
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("switchAppLauncherToComponent失败 | 异常信息=%s", e.getMessage()), e);
+            Toast.makeText(context, context.getString(R.string.app_name) + "图标切换失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
+            return false;
+        }
+    }
+
+    // ======================== 私有辅助方法区（组件状态控制）========================
+    /**
+     * 启用组件（带状态检查，避免重复操作）
+     * @param pm 包管理器
+     * @param component 目标组件
+     */
+    private static void enableComponent(PackageManager pm, ComponentName component) {
+        int currentState = pm.getComponentEnabledSetting(component);
+        String componentName = component.getClassName();
+
+        if (currentState != PackageManager.COMPONENT_ENABLED_STATE_ENABLED) {
+            pm.setComponentEnabledSetting(
+				component,
+				PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
+				PackageManager.DONT_KILL_APP | PackageManager.SYNCHRONOUS
+            );
+            LogUtils.d(TAG, String.format("enableComponent成功 | 组件=%s", componentName));
+        } else {
+            LogUtils.d(TAG, String.format("enableComponent无需操作 | 组件已启用=%s", componentName));
+        }
+    }
+
+    /**
+     * 禁用组件（带状态检查，避免重复操作）
+     * @param pm 包管理器
+     * @param component 目标组件
+     */
+    private static void disableComponent(PackageManager pm, ComponentName component) {
+        int currentState = pm.getComponentEnabledSetting(component);
+        String componentName = component.getClassName();
+
+        if (currentState != PackageManager.COMPONENT_ENABLED_STATE_DISABLED) {
+            pm.setComponentEnabledSetting(
+				component,
+				PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
+				PackageManager.DONT_KILL_APP | PackageManager.SYNCHRONOUS
+            );
+            LogUtils.d(TAG, String.format("disableComponent成功 | 组件=%s", componentName));
+        } else {
+            LogUtils.d(TAG, String.format("disableComponent无需操作 | 组件已禁用=%s", componentName));
+        }
+    }
+
+    // ======================== 私有辅助方法区（快捷方式创建）========================
+    /**
+     * 创建指定组件的桌面快捷方式（自动去重，兼容 Android 8.0+）
+     * @param context 上下文
+     * @param component 目标组件
+     * @param name 快捷方式名称
+     * @param iconRes 快捷方式图标资源ID
+     * @return 是否创建成功
+     */
+    private static boolean createComponentShortcut(Context context, ComponentName component, String name, int iconRes) {
+        // 参数校验
+        String componentName = component != null ? component.getClassName() : "null";
+        LogUtils.d(TAG, String.format("createComponentShortcut调用 | 组件=%s | 名称=%s", componentName, name));
+
+        if (context == null || component == null || name == null || name.isEmpty()) {
+            LogUtils.e(TAG, "createComponentShortcut失败：上下文、组件或名称为空");
+            return false;
+        }
+
+        // 图标资源默认值补全
+        int finalIconRes = iconRes != 0 ? iconRes : SHORTCUT_ICON_DEFAULT;
+
+        // Android 8.0+（API 26+）：使用 ShortcutManager（系统推荐）
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            try {
+                android.content.pm.ShortcutManager shortcutManager = context.getSystemService(android.content.pm.ShortcutManager.class);
+                if (shortcutManager == null || !shortcutManager.isRequestPinShortcutSupported()) {
+                    LogUtils.w(TAG, "createComponentShortcut：系统不支持创建快捷方式");
+                    return false;
+                }
+
+                // 检查是否已存在该组件的快捷方式（去重）
+                for (android.content.pm.ShortcutInfo info : shortcutManager.getPinnedShortcuts()) {
+                    if (component.getClassName().equals(info.getIntent().getComponent().getClassName())) {
+                        LogUtils.d(TAG, String.format("createComponentShortcut：快捷方式已存在=%s", componentName));
+                        return true;
+                    }
+                }
+
+                // 构建启动目标组件的意图
+                Intent launchIntent = new Intent(Intent.ACTION_MAIN)
+					.setComponent(component)
+					.addCategory(Intent.CATEGORY_LAUNCHER)
+					.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+                // 构建快捷方式信息
+                android.content.pm.ShortcutInfo shortcutInfo = new android.content.pm.ShortcutInfo.Builder(context, component.getClassName())
+					.setShortLabel(name)
+					.setLongLabel(name)
+					.setIcon(android.graphics.drawable.Icon.createWithResource(context, finalIconRes))
+					.setIntent(launchIntent)
+					.build();
+
+                // 请求创建快捷方式（需用户确认）
+                shortcutManager.requestPinShortcut(shortcutInfo, null);
+                LogUtils.d(TAG, "createComponentShortcut：Android O+ 快捷方式创建请求已发送");
+                return true;
+
+            } catch (Exception e) {
+                LogUtils.e(TAG, String.format("createComponentShortcut失败 | Android O+ 异常=%s", e.getMessage()), e);
+                return false;
+            }
+        } else {
+            // Android 8.0 以下：使用广播（兼容旧机型）
+            try {
+                // 构建启动目标组件的意图
+                Intent launchIntent = new Intent(Intent.ACTION_MAIN)
+					.setComponent(component)
+					.addCategory(Intent.CATEGORY_LAUNCHER)
+					.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+                // 构建创建快捷方式的广播意图
+                Intent installIntent = new Intent(ACTION_INSTALL_SHORTCUT);
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, launchIntent);
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
+									   Intent.ShortcutIconResource.fromContext(context, finalIconRes));
+                installIntent.putExtra("duplicate", false); // 禁止重复创建
+
+                context.sendBroadcast(installIntent);
+                LogUtils.d(TAG, "createComponentShortcut：Android O- 快捷方式创建广播已发送");
+                return true;
+
+            } catch (Exception e) {
+                LogUtils.e(TAG, String.format("createComponentShortcut失败 | Android O- 异常=%s", e.getMessage()), e);
+                return false;
+            }
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AppCacheUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AppCacheUtils.java
new file mode 100644
index 0000000..8cb769d
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AppCacheUtils.java
@@ -0,0 +1,143 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.models.BatteryInfoBean;
+import java.util.ArrayList;
+
+/**
+ * 应用缓存工具类（适配Android API 30，基于Java 7编写）
+ * 负责电池信息的缓存、持久化与管理
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Describe 电池信息缓存工具：实现电量变化记录、持久化存储与缓存限制
+ */
+public class AppCacheUtils {
+    // ===================== 静态常量区（置顶归类，消除魔法值） =====================
+    public static final String TAG = "AppCacheUtils";
+    private static final int MAX_BATTERY_RECORD_COUNT = 180; // 电池记录最大条数限制
+
+    // ===================== 静态成员区（单例相关） =====================
+    private static AppCacheUtils sInstance;
+
+    // ===================== 成员变量区（按功能分层） =====================
+    private Context mContext; // ApplicationContext，避免内存泄漏
+    private ArrayList<BatteryInfoBean> mBatteryInfoList; // 电池信息缓存列表
+
+    // ===================== 单例方法区（线程安全） =====================
+    /**
+     * 获取单例实例
+     * @param context 上下文（内部会转换为ApplicationContext）
+     * @return 唯一AppCacheUtils实例
+     */
+    public static synchronized AppCacheUtils getInstance(Context context) {
+        String contextType = context != null ? context.getClass().getSimpleName() : "null";
+        LogUtils.d(TAG, String.format("getInstance调用 | 传入Context类型=%s", contextType));
+
+        if (sInstance == null) {
+            if (context == null) {
+                LogUtils.e(TAG, "getInstance失败：传入Context为null");
+                throw new IllegalArgumentException("Context cannot be null");
+            }
+            sInstance = new AppCacheUtils(context.getApplicationContext());
+            LogUtils.d(TAG, "getInstance：单例实例初始化完成");
+        }
+        return sInstance;
+    }
+
+    // ===================== 私有构造方法区（禁止外部实例化） =====================
+    /**
+     * 私有构造方法，初始化缓存列表并加载持久化数据
+     * @param context ApplicationContext
+     */
+    private AppCacheUtils(Context context) {
+        LogUtils.d(TAG, "AppCacheUtils构造方法调用");
+        mContext = context;
+        mBatteryInfoList = new ArrayList<BatteryInfoBean>();
+        loadAppCacheData();
+        LogUtils.d(TAG, String.format("AppCacheUtils构造完成 | 初始电池信息数量=%d", mBatteryInfoList.size()));
+    }
+
+    // ===================== 公共业务方法区（对外暴露接口） =====================
+    /**
+     * 添加电池电量变化记录（仅当电量变化时添加）
+     * @param batteryValue 电池电量值
+     */
+    public void addChangingTime(int batteryValue) {
+        LogUtils.d(TAG, String.format("addChangingTime调用 | 传入电量值=%d", batteryValue));
+
+        if (mBatteryInfoList.isEmpty()) {
+            addChangingTimeToList(batteryValue);
+            LogUtils.d(TAG, "addChangingTime：缓存列表为空，直接添加记录");
+            return;
+        }
+
+        // 对比最后一条记录的电量值，避免重复添加
+        int lastBatteryValue = mBatteryInfoList.get(mBatteryInfoList.size() - 1).getBatteryValue();
+        if (lastBatteryValue != batteryValue) {
+            addChangingTimeToList(batteryValue);
+            LogUtils.d(TAG, String.format("addChangingTime：电量变化，添加新记录 | 原电量=%d | 新电量=%d", lastBatteryValue, batteryValue));
+        } else {
+            LogUtils.d(TAG, "addChangingTime：电量未变化，跳过添加");
+        }
+    }
+
+    /**
+     * 获取电池信息缓存列表
+     * @return 完整的电池信息列表
+     */
+    public ArrayList<BatteryInfoBean> getArrayListBatteryInfo() {
+        LogUtils.d(TAG, String.format("getArrayListBatteryInfo调用 | 当前缓存数量=%d", mBatteryInfoList.size()));
+        loadAppCacheData();
+        return mBatteryInfoList;
+    }
+
+    /**
+     * 清除所有电池历史记录
+     */
+    public void clearBatteryHistory() {
+        LogUtils.d(TAG, String.format("clearBatteryHistory调用 | 清除前缓存数量=%d", mBatteryInfoList.size()));
+        mBatteryInfoList.clear();
+        saveAppCacheData();
+        LogUtils.d(TAG, "clearBatteryHistory完成 | 缓存已清空");
+    }
+
+    // ===================== 私有辅助方法区（内部业务逻辑） =====================
+    /**
+     * 内部方法：添加电量记录到列表并持久化
+     * @param batteryValue 电池电量值
+     */
+    private void addChangingTimeToList(int batteryValue) {
+        LogUtils.d(TAG, String.format("addChangingTimeToList调用 | 传入电量值=%d", batteryValue));
+
+        // 限制列表最大长度，避免内存溢出
+        if (mBatteryInfoList.size() >= MAX_BATTERY_RECORD_COUNT) {
+            mBatteryInfoList.remove(0);
+            LogUtils.d(TAG, String.format("addChangingTimeToList：列表超过%d条，移除最旧记录", MAX_BATTERY_RECORD_COUNT));
+        }
+
+        BatteryInfoBean batteryInfo = new BatteryInfoBean(System.currentTimeMillis(), batteryValue);
+        mBatteryInfoList.add(batteryInfo);
+        LogUtils.d(TAG, String.format("addChangingTimeToList：添加新记录 | 电量=%d | 时间戳=%d", batteryInfo.getBatteryValue(), batteryInfo.getTimeStamp()));
+        saveAppCacheData();
+    }
+
+    /**
+     * 从文件加载缓存数据
+     */
+    private void loadAppCacheData() {
+        LogUtils.d(TAG, "loadAppCacheData调用 | 开始加载持久化数据");
+        mBatteryInfoList.clear();
+        BatteryInfoBean.loadBeanList(mContext, mBatteryInfoList, BatteryInfoBean.class);
+        LogUtils.d(TAG, String.format("loadAppCacheData完成 | 加载数据数量=%d", mBatteryInfoList.size()));
+    }
+
+    /**
+     * 保存缓存数据到文件
+     */
+    private void saveAppCacheData() {
+        LogUtils.d(TAG, String.format("saveAppCacheData调用 | 保存数据数量=%d", mBatteryInfoList.size()));
+        BatteryInfoBean.saveBeanList(mContext, mBatteryInfoList, BatteryInfoBean.class);
+        LogUtils.d(TAG, "saveAppCacheData完成 | 数据已持久化");
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AppConfigUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AppConfigUtils.java
new file mode 100644
index 0000000..6081bbb
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AppConfigUtils.java
@@ -0,0 +1,358 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.models.AppConfigBean;
+import cc.winboll.studio.powerbell.models.ControlCenterServiceBean;
+import cc.winboll.studio.powerbell.threads.RemindThread;
+
+/**
+ * 应用配置工具类：管理应用核心配置（服务开关、电池提醒阈值、背景设置等）
+ * 适配：Java7 | API30 | 小米手机，单例模式，线程安全，配置持久化
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Describe 应用配置全量管理工具，支持配置持久化、自动校准、线程安全访问
+ */
+public class AppConfigUtils {
+    // ======================== 静态常量区（魔法值统一管理）========================
+    public static final String TAG = "AppConfigUtils";
+    public static final String BACKGROUND_DIR = "Background"; // 背景图片存储目录
+    private static final int MIN_REMINDER_VALUE = 0;         // 提醒阈值最小值
+    private static final int MAX_REMINDER_VALUE = 100;       // 提醒阈值最大值
+    private static final int MIN_INTERVAL_TIME = 1000;       // 最小提醒间隔（ms）
+    private static final int MIN_DETECT_INTERVAL = 500;      // 最小电量检测间隔（ms）
+
+    // ======================== 静态成员区（单例实例）========================
+    private static volatile AppConfigUtils sInstance; // 单例实例（volatile保障双重校验锁有效性）
+
+    // ======================== 成员变量区（按依赖优先级排序，final/volatile保障线程安全）========================
+    private final Context mContext;          // 应用上下文（ApplicationContext，避免内存泄漏）
+    private final App mApplication;          // 应用Application实例（final保障不可变）
+    public volatile AppConfigBean mAppConfigBean;              // 应用配置Bean（持久化核心，volatile保障线程安全）
+    private volatile boolean mIsServiceEnabled = false;        // 服务开关缓存状态（减少Bean读取次数）
+
+    // ======================== 单例相关方法区（双重校验锁+构造方法）========================
+    /**
+     * 双重校验锁单例获取方法，线程安全
+     * @param context 上下文（不可为null）
+     * @return 单例实例
+     */
+    public static AppConfigUtils getInstance(Context context) {
+        String contextType = context != null ? context.getClass().getSimpleName() : "null";
+        LogUtils.d(TAG, String.format("getInstance() 调用 | 传入Context类型=%s", contextType));
+
+        if (context == null) {
+            LogUtils.e(TAG, "getInstance() 失败：Context不能为空");
+            throw new IllegalArgumentException("Context cannot be null");
+        }
+
+        if (sInstance == null) {
+            synchronized (AppConfigUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new AppConfigUtils(context);
+                    LogUtils.d(TAG, "getInstance()：单例实例创建成功");
+                }
+            }
+        }
+
+        LogUtils.d(TAG, "getInstance()：单例实例获取成功");
+        return sInstance;
+    }
+
+    /**
+     * 私有构造方法，禁止外部实例化
+     * @param context 上下文（内部转换为ApplicationContext）
+     */
+    private AppConfigUtils(Context context) {
+        LogUtils.d(TAG, "AppConfigUtils() 构造方法调用");
+        this.mContext = context.getApplicationContext();
+        this.mApplication = (App) context.getApplicationContext();
+        mAppConfigBean = new AppConfigBean();
+        loadAppConfig(); // 加载持久化配置
+        LogUtils.d(TAG, "AppConfigUtils() 构造完成，配置初始化成功");
+    }
+
+    // ======================== 核心配置持久化方法区（加载+保存）========================
+    /**
+     * 加载应用配置（初始化/重载通用入口）
+     * @return 加载后的应用配置Bean
+     */
+    public AppConfigBean loadAppConfig() {
+        LogUtils.d(TAG, "loadAppConfig() 调用 | 开始加载应用配置");
+        AppConfigBean savedAppBean = (AppConfigBean) AppConfigBean.loadBean(mContext, AppConfigBean.class);
+
+        if (savedAppBean != null) {
+            mAppConfigBean = savedAppBean;
+            LogUtils.d(TAG, String.format("loadAppConfig() 成功 | 充电阈值=%d%% | 耗电阈值=%d%%",
+                                          mAppConfigBean.getChargeReminderValue(), mAppConfigBean.getUsageReminderValue()));
+        } else {
+            mAppConfigBean = new AppConfigBean();
+            AppConfigBean.saveBean(mContext, mAppConfigBean);
+            LogUtils.d(TAG, "loadAppConfig()：无已保存配置，使用默认值并持久化");
+        }
+
+        return mAppConfigBean;
+    }
+
+    /**
+     * 保存应用配置（内部核心方法，直接持久化）
+     */
+    public void saveAppConfig() {
+        AppConfigBean.saveBean(mContext, mAppConfigBean);
+        LogUtils.d(TAG, "saveAppConfig()：应用配置保存成功");
+    }
+
+    // ======================== 充电提醒配置方法区（开关+阈值）========================
+    /**
+     * 设置充电提醒开关状态
+     * @param isEnabled 目标状态（true=开启，false=关闭）
+     */
+    public void setChargeReminderEnabled(final boolean isEnabled) {
+        LogUtils.d(TAG, String.format("setChargeReminderEnabled() 调用 | 传入状态=%b", isEnabled));
+
+        if (isEnabled == mAppConfigBean.isEnableChargeReminder()) {
+            LogUtils.d(TAG, "setChargeReminderEnabled()：充电提醒状态无变化，无需操作");
+            return;
+        }
+
+        mAppConfigBean.setEnableChargeReminder(isEnabled);
+        saveAppConfig();
+        LogUtils.d(TAG, String.format("setChargeReminderEnabled() 成功 | 充电提醒状态=%s", isEnabled ? "开启" : "关闭"));
+    }
+
+    /**
+     * 获取充电提醒开关状态
+     * @return 充电提醒状态（true=开启，false=关闭）
+     */
+    public boolean isChargeReminderEnabled() {
+        boolean isEnabled = mAppConfigBean.isEnableChargeReminder();
+        LogUtils.d(TAG, String.format("isChargeReminderEnabled()：获取充电提醒状态=%s", isEnabled ? "开启" : "关闭"));
+        return isEnabled;
+    }
+
+    /**
+     * 设置充电提醒阈值（自动校准0-100）
+     * @param value 目标阈值
+     */
+    public void setChargeReminderValue(final int value) {
+        LogUtils.d(TAG, String.format("setChargeReminderValue() 调用 | 传入阈值=%d", value));
+        final int calibratedValue = Math.min(Math.max(value, MIN_REMINDER_VALUE), MAX_REMINDER_VALUE);
+
+        if (calibratedValue == mAppConfigBean.getChargeReminderValue()) {
+            LogUtils.d(TAG, "setChargeReminderValue()：充电提醒阈值无变化，无需操作");
+            return;
+        }
+
+        mAppConfigBean.setChargeReminderValue(calibratedValue);
+        saveAppConfig();
+        LogUtils.d(TAG, String.format("setChargeReminderValue() 成功 | 充电提醒阈值=%d%%", calibratedValue));
+    }
+
+    /**
+     * 获取充电提醒阈值
+     * @return 充电提醒阈值（0-100）
+     */
+    public int getChargeReminderValue() {
+        int value = mAppConfigBean.getChargeReminderValue();
+        LogUtils.d(TAG, String.format("getChargeReminderValue()：获取充电提醒阈值=%d%%", value));
+        return value;
+    }
+
+    // ======================== 耗电提醒配置方法区（开关+阈值）========================
+    /**
+     * 设置耗电提醒开关状态
+     * @param isEnabled 目标状态（true=开启，false=关闭）
+     */
+    public void setUsageReminderEnabled(final boolean isEnabled) {
+        LogUtils.d(TAG, String.format("setUsageReminderEnabled() 调用 | 传入状态=%b", isEnabled));
+
+        if (isEnabled == mAppConfigBean.isEnableUsageReminder()) {
+            LogUtils.d(TAG, "setUsageReminderEnabled()：耗电提醒状态无变化，无需操作");
+            return;
+        }
+
+        mAppConfigBean.setEnableUsageReminder(isEnabled);
+        saveAppConfig();
+        LogUtils.d(TAG, String.format("setUsageReminderEnabled() 成功 | 耗电提醒状态=%s", isEnabled ? "开启" : "关闭"));
+    }
+
+    /**
+     * 获取耗电提醒开关状态
+     * @return 耗电提醒状态（true=开启，false=关闭）
+     */
+    public boolean isUsageReminderEnabled() {
+        boolean isEnabled = mAppConfigBean.isEnableUsageReminder();
+        LogUtils.d(TAG, String.format("isUsageReminderEnabled()：获取耗电提醒状态=%s", isEnabled ? "开启" : "关闭"));
+        return isEnabled;
+    }
+
+    /**
+     * 设置耗电提醒阈值（自动校准0-100）
+     * @param value 目标阈值
+     */
+    public void setUsageReminderValue(final int value) {
+        LogUtils.d(TAG, String.format("setUsageReminderValue() 调用 | 传入阈值=%d", value));
+        final int calibratedValue = Math.min(Math.max(value, MIN_REMINDER_VALUE), MAX_REMINDER_VALUE);
+
+        if (calibratedValue == mAppConfigBean.getUsageReminderValue()) {
+            LogUtils.d(TAG, "setUsageReminderValue()：耗电提醒阈值无变化，无需操作");
+            return;
+        }
+
+        mAppConfigBean.setUsageReminderValue(calibratedValue);
+        saveAppConfig();
+        LogUtils.d(TAG, String.format("setUsageReminderValue() 成功 | 耗电提醒阈值=%d%%", calibratedValue));
+    }
+
+    /**
+     * 获取耗电提醒阈值
+     * @return 耗电提醒阈值（0-100）
+     */
+    public int getUsageReminderValue() {
+        int value = mAppConfigBean.getUsageReminderValue();
+        LogUtils.d(TAG, String.format("getUsageReminderValue()：获取耗电提醒阈值=%d%%", value));
+        return value;
+    }
+
+    // ======================== 实时电池状态配置方法区（内存缓存，不持久化）========================
+    /**
+     * 设置当前充电状态（仅内存缓存）
+     * @param isCharging 充电状态（true=充电中，false=未充电）
+     */
+    public void setCharging(boolean isCharging) {
+        LogUtils.d(TAG, String.format("setCharging() 调用 | 传入状态=%b", isCharging));
+
+        if (isCharging == mAppConfigBean.isCharging()) {
+            LogUtils.d(TAG, "setCharging()：充电状态无变化，无需操作");
+            return;
+        }
+
+        mAppConfigBean.setIsCharging(isCharging);
+        LogUtils.d(TAG, String.format("setCharging() 成功 | 充电状态=%s", isCharging ? "充电中" : "未充电"));
+    }
+
+    /**
+     * 获取当前充电状态
+     * @return 充电状态（true=充电中，false=未充电）
+     */
+    public boolean isCharging() {
+        boolean isCharging = mAppConfigBean.isCharging();
+        LogUtils.d(TAG, String.format("isCharging()：获取充电状态=%s", isCharging ? "充电中" : "未充电"));
+        return isCharging;
+    }
+
+    /**
+     * 设置当前电池电量（仅内存缓存，自动校准0-100）
+     * @param value 当前电量
+     */
+    public void setCurrentBatteryValue(int value) {
+        LogUtils.d(TAG, String.format("setCurrentBatteryValue() 调用 | 传入电量=%d", value));
+        int calibratedValue = Math.min(Math.max(value, MIN_REMINDER_VALUE), MAX_REMINDER_VALUE);
+
+        if (calibratedValue == App.sQuantityOfElectricity) {
+            LogUtils.d(TAG, "setCurrentBatteryValue()：电池电量无变化，无需操作");
+            return;
+        }
+
+        App.sQuantityOfElectricity = calibratedValue;
+        LogUtils.d(TAG, String.format("setCurrentBatteryValue() 成功 | 电池电量=%d%%", calibratedValue));
+    }
+
+    /**
+     * 获取当前电池电量
+     * @return 当前电池电量（0-100）
+     */
+    public int getCurrentBatteryValue() {
+        int value = App.sQuantityOfElectricity;
+        LogUtils.d(TAG, String.format("getCurrentBatteryValue()：获取电池电量=%d%%", value));
+        return value;
+    }
+
+    // ======================== 间隔配置方法区（持久化）========================
+    /**
+     * 设置提醒间隔时间（自动校准最小1000ms）
+     * @param interval 目标间隔（单位：ms）
+     */
+    public void setReminderIntervalTime(final int interval) {
+        LogUtils.d(TAG, String.format("setReminderIntervalTime() 调用 | 传入间隔=%dms", interval));
+        final int calibratedInterval = Math.max(interval, MIN_INTERVAL_TIME);
+
+        if (calibratedInterval == mAppConfigBean.getReminderIntervalTime()) {
+            LogUtils.d(TAG, "setReminderIntervalTime()：提醒间隔无变化，无需操作");
+            return;
+        }
+
+        mAppConfigBean.setReminderIntervalTime(calibratedInterval);
+        saveAppConfig();
+        LogUtils.d(TAG, String.format("setReminderIntervalTime() 成功 | 提醒间隔=%dms", calibratedInterval));
+    }
+
+    /**
+     * 获取提醒间隔时间
+     * @return 提醒间隔（单位：ms）
+     */
+    public int getReminderIntervalTime() {
+        int interval = mAppConfigBean.getReminderIntervalTime();
+        LogUtils.d(TAG, String.format("getReminderIntervalTime()：获取提醒间隔=%dms", interval));
+        return interval;
+    }
+
+    /**
+     * 设置电量检测间隔（自动校准最小500ms）
+     * @param interval 目标间隔（单位：ms）
+     */
+    public void setBatteryDetectInterval(final int interval) {
+        LogUtils.d(TAG, String.format("setBatteryDetectInterval() 调用 | 传入间隔=%dms", interval));
+        final int calibratedInterval = Math.max(interval, MIN_DETECT_INTERVAL);
+
+        if (calibratedInterval == mAppConfigBean.getBatteryDetectInterval()) {
+            LogUtils.d(TAG, "setBatteryDetectInterval()：检测间隔无变化，无需操作");
+            return;
+        }
+
+        mAppConfigBean.setBatteryDetectInterval(calibratedInterval);
+        saveAppConfig();
+        LogUtils.d(TAG, String.format("setBatteryDetectInterval() 成功 | 电量检测间隔=%dms", calibratedInterval));
+    }
+
+    /**
+     * 获取电量检测间隔
+     * @return 电量检测间隔（单位：ms）
+     */
+    public int getBatteryDetectInterval() {
+        int interval = mAppConfigBean.getBatteryDetectInterval();
+        LogUtils.d(TAG, String.format("getBatteryDetectInterval()：获取电量检测间隔=%dms", interval));
+        return interval;
+    }
+
+    // ======================== 服务开关配置方法区（独立Bean）========================
+    /**
+     * 获取服务开关状态
+     * @return 服务开关状态（true=开启，false=关闭）
+     */
+    public boolean isServiceEnabled() {
+        LogUtils.d(TAG, "isServiceEnabled() 调用 | 开始获取服务开关状态");
+        ControlCenterServiceBean savedServiceBean = (ControlCenterServiceBean) ControlCenterServiceBean.loadBean(mContext, ControlCenterServiceBean.class);
+
+        if (savedServiceBean != null) {
+            boolean isEnabled = savedServiceBean.isEnableService();
+            LogUtils.d(TAG, String.format("isServiceEnabled()：服务开关状态=%b", isEnabled));
+            return isEnabled;
+        } else {
+            ControlCenterServiceBean.saveBean(mContext, new ControlCenterServiceBean(false));
+            LogUtils.d(TAG, "isServiceEnabled()：无已保存服务配置，默认关闭并持久化");
+            return false;
+        }
+    }
+
+    /**
+     * 设置服务开关状态
+     * @param isServiceEnabled 目标状态（true=开启，false=关闭）
+     */
+    public void setIsServiceEnabled(boolean isServiceEnabled) {
+        LogUtils.d(TAG, String.format("setIsServiceEnabled() 调用 | 传入状态=%b", isServiceEnabled));
+        ControlCenterServiceBean.saveBean(mContext, new ControlCenterServiceBean(isServiceEnabled));
+        LogUtils.d(TAG, String.format("setIsServiceEnabled() 成功 | 服务开关状态=%b", isServiceEnabled));
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AssetsCopyUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AssetsCopyUtils.java
new file mode 100644
index 0000000..bc479e4
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/AssetsCopyUtils.java
@@ -0,0 +1,144 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/11 09:14
+ * @Describe Assets 目录拷贝工具类
+ * 支持将 assets/images/ 下所有文件、子目录拷贝到指定路径
+ * 适配：Java7 | API30 | 递归拷贝 | 覆盖写入
+ */
+public class AssetsCopyUtils {
+    // ======================== 静态常量区 ========================
+    public static final String TAG = "AssetsCopyUtils";
+    private static final int BUFFER_SIZE = 1024 * 8; // 8KB 缓冲区，平衡性能与内存占用
+
+    // ======================== 公共快捷方法区（对外入口） ========================
+    /**
+     * 拷贝 assets/images/ 目录到指定目标目录
+     * @param context      上下文
+     * @param targetDirPath 目标目录完整路径（如 /sdcard/PowerBell/assets_images）
+     * @return 拷贝是否成功
+     */
+    public static boolean copyAssetsImagesToDir(Context context, String targetDirPath) {
+        LogUtils.d(TAG, "copyAssetsImagesToDir() 调用，目标路径：" + targetDirPath);
+        // 拷贝 assets/images 根目录
+        boolean result = copyAssetsDirToDir(context, "images", targetDirPath);
+        LogUtils.d(TAG, "copyAssetsImagesToDir() 执行完成，结果：" + result);
+        return result;
+    }
+
+    // ======================== 公共核心方法区（递归拷贝目录） ========================
+    /**
+     * 递归拷贝 assets 下指定目录到目标目录
+     * @param context      上下文
+     * @param assetsDir    assets 下的源目录（如 "images"、"images/subdir"）
+     * @param targetDirPath 目标目录完整路径
+     * @return 拷贝是否成功
+     */
+    public static boolean copyAssetsDirToDir(Context context, String assetsDir, String targetDirPath) {
+        LogUtils.d(TAG, "copyAssetsDirToDir() 调用，源目录：" + assetsDir + "，目标路径：" + targetDirPath);
+        if (context == null) {
+            LogUtils.e(TAG, "copyAssetsDirToDir() 拷贝失败：上下文为空");
+            return false;
+        }
+
+        File targetDir = new File(targetDirPath);
+        // 创建目标目录（含多级父目录）
+        if (!targetDir.exists() && !targetDir.mkdirs()) {
+            LogUtils.e(TAG, "copyAssetsDirToDir() 创建目标目录失败：" + targetDirPath);
+            return false;
+        }
+
+        try {
+            // 获取 assets 目录下的文件/子目录列表
+            String[] fileList = context.getAssets().list(assetsDir);
+            if (fileList == null || fileList.length == 0) {
+                LogUtils.d(TAG, "copyAssetsDirToDir() assets 目录为空：" + assetsDir);
+                return true;
+            }
+
+            for (String fileName : fileList) {
+                String assetsFilePath = assetsDir + File.separator + fileName;
+                String targetFilePath = targetDirPath + File.separator + fileName;
+
+                // 判断当前项是文件还是子目录
+                String[] subFileList = context.getAssets().list(assetsFilePath);
+                if (subFileList != null && subFileList.length > 0) {
+                    // 是子目录，递归拷贝
+                    if (!copyAssetsDirToDir(context, assetsFilePath, targetFilePath)) {
+                        LogUtils.e(TAG, "copyAssetsDirToDir() 递归拷贝子目录失败：" + assetsFilePath);
+                        return false;
+                    }
+                } else {
+                    // 是文件，直接拷贝
+                    if (!copyAssetsFileToDir(context, assetsFilePath, targetFilePath)) {
+                        LogUtils.e(TAG, "copyAssetsDirToDir() 拷贝文件失败：" + assetsFilePath);
+                        return false;
+                    }
+                }
+            }
+            LogUtils.d(TAG, "copyAssetsDirToDir() assets 目录拷贝完成：" + assetsDir + " -> " + targetDirPath);
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "copyAssetsDirToDir() 拷贝 assets 目录异常：" + e.getMessage(), e);
+            return false;
+        }
+    }
+
+    // ======================== 私有辅助方法区（单个文件拷贝） ========================
+    /**
+     * 拷贝 assets 下单个文件到指定路径
+     * @param context       上下文
+     * @param assetsFilePath assets 下的文件路径（如 "images/cloud.png"）
+     * @param targetFilePath 目标文件完整路径
+     * @return 拷贝是否成功
+     */
+    public static boolean copyAssetsFileToDir(Context context, String assetsFilePath, String targetFilePath) {
+        LogUtils.d(TAG, "copyAssetsFileToDir() 调用，源文件：" + assetsFilePath + "，目标文件：" + targetFilePath);
+        InputStream inputStream = null;
+        OutputStream outputStream = null;
+        try {
+            inputStream = context.getAssets().open(assetsFilePath);
+            File targetFile = new File(targetFilePath);
+
+            // 覆盖已存在的文件
+            if (targetFile.exists() && !targetFile.delete()) {
+                LogUtils.w(TAG, "copyAssetsFileToDir() 覆盖目标文件失败，跳过：" + targetFilePath);
+                return true;
+            }
+
+            outputStream = new FileOutputStream(targetFile);
+            byte[] buffer = new byte[BUFFER_SIZE];
+            int length;
+            while ((length = inputStream.read(buffer)) != -1) {
+                outputStream.write(buffer, 0, length);
+            }
+            LogUtils.d(TAG, "copyAssetsFileToDir() 文件拷贝成功：" + assetsFilePath + " -> " + targetFilePath);
+            return true;
+        } catch (IOException e) {
+            LogUtils.e(TAG, "copyAssetsFileToDir() 拷贝文件失败：" + assetsFilePath + "，异常：" + e.getMessage(), e);
+            return false;
+        } finally {
+            // 关闭流
+            try {
+                if (inputStream != null) {
+                    inputStream.close();
+                }
+                if (outputStream != null) {
+                    outputStream.close();
+                }
+            } catch (IOException e) {
+                LogUtils.e(TAG, "copyAssetsFileToDir() 关闭流异常：" + e.getMessage(), e);
+            }
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BackgroundSourceUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BackgroundSourceUtils.java
new file mode 100644
index 0000000..93b03d9
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BackgroundSourceUtils.java
@@ -0,0 +1,805 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.graphics.Bitmap;
+import android.media.ExifInterface;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Environment;
+import android.text.TextUtils;
+import androidx.core.content.FileProvider;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.BuildConfig;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import java.io.BufferedOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.util.UUID;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/07/18 12:07:20
+ * @Describe 背景图片工具集（精简版：复用FileUtils，聚焦业务逻辑）
+ */
+public class BackgroundSourceUtils {
+
+    // ====================== 常量定义（按功能分类置顶）======================
+    public static final String TAG = "BackgroundSourceUtils";
+    // FileProvider 授权常量
+    public static final String FILE_PROVIDER_AUTHORITY = BuildConfig.APPLICATION_ID + ".fileprovider";
+    // 目录名称常量
+    private static final String CROP_CACHE_DIR_NAME = "cache";
+    private static final String SOURCE_DIR_NAME = "BackgroundSource";
+    private static final String COMPRESS_DIR_NAME = "BackgroundCompress";
+    private static final String MODEL_DIR_NAME = "ModelDir";
+    // 文件名称常量
+    private static final String CURRENT_BEAN_FILE_NAME = "currentBackgroundBean.json";
+    private static final String PREVIEW_BEAN_FILE_NAME = "previewBackgroundBean.json";
+    private static final String BLANK_ASSET_PATH = "images/blank100x100.png";
+    // 图片操作基础目录
+    private static final String PICTURE_BASE_DIR = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES) + File.separator + "PowerBell";
+    // 压缩常量
+    private static final int BITMAP_COMPRESS_QUALITY = 80;
+    private static final Bitmap.CompressFormat COMPRESS_FORMAT = Bitmap.CompressFormat.JPEG;
+
+    // ====================== 成员变量（按依赖优先级+功能分类）======================
+    // 单例实例
+    private static volatile BackgroundSourceUtils sInstance;
+    // 上下文（应用级，避免内存泄漏）
+    private Context mContext;
+    // 配置文件对象
+    private File currentBackgroundBeanFile;
+    private File previewBackgroundBeanFile;
+    // Bean实例
+    private BackgroundBean currentBackgroundBean;
+    private BackgroundBean previewBackgroundBean;
+    // 目录对象
+    private File fPictureBaseDir;
+    private File fCropCacheDir;
+    private File fBackgroundSourceDir;
+    private File fBackgroundCompressDir;
+    private File fUtilsDir;
+    private File fModelDir;
+    // 裁剪文件对象
+    private File mCropSourceFile;
+    private File mCropResultFile;
+
+    // ====================== 单例方法（双重校验锁）======================
+    private BackgroundSourceUtils(Context context) {
+        if (sInstance != null) {
+            throw new RuntimeException("BackgroundSourceUtils 是单例类，禁止重复创建！");
+        }
+        this.mContext = context.getApplicationContext();
+        LogUtils.d(TAG, "【单例初始化】开始初始化必要资源");
+        initNecessaryDirs();
+        initAllFiles();
+        loadSettings();
+        LogUtils.d(TAG, "【单例初始化】资源初始化完成");
+    }
+
+    public static BackgroundSourceUtils getInstance(Context context) {
+        if (sInstance == null) {
+            synchronized (BackgroundSourceUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new BackgroundSourceUtils(context);
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    // ====================== 生命周期方法（初始化→加载→保存）======================
+    /**
+     * 统一初始化所有必要目录
+     */
+    private void initNecessaryDirs() {
+        LogUtils.d(TAG, "【目录初始化】开始创建所有必要目录");
+        initPictureDirs();
+        initJsonDirs();
+        LogUtils.d(TAG, "【目录初始化】所有必要目录创建完成");
+    }
+
+    /**
+     * 初始化图片操作目录
+     */
+    private void initPictureDirs() {
+        fPictureBaseDir = new File(PICTURE_BASE_DIR);
+        fBackgroundSourceDir = new File(fPictureBaseDir, SOURCE_DIR_NAME);
+        fCropCacheDir = new File(fPictureBaseDir, CROP_CACHE_DIR_NAME);
+        fBackgroundCompressDir = new File(fPictureBaseDir, COMPRESS_DIR_NAME);
+
+        createDirWithPermission(fPictureBaseDir, "图片基础目录");
+        createDirWithPermission(fBackgroundSourceDir, "图片存储目录");
+        createDirWithPermission(fCropCacheDir, "裁剪缓存目录");
+        createDirWithPermission(fBackgroundCompressDir, "压缩图存储目录");
+
+        validatePictureDirs();
+    }
+
+    /**
+     * 初始化JSON配置目录
+     */
+    private void initJsonDirs() {
+        fUtilsDir = mContext.getExternalFilesDir(TAG);
+        if (fUtilsDir == null) {
+            LogUtils.e(TAG, "应用外置存储不可用，切换到应用内部缓存目录");
+            fUtilsDir = mContext.getDataDir();
+        }
+        fModelDir = new File(fUtilsDir, MODEL_DIR_NAME);
+        createDirWithPermission(fModelDir, "JSON配置目录");
+
+        currentBackgroundBeanFile = new File(fModelDir, CURRENT_BEAN_FILE_NAME);
+        previewBackgroundBeanFile = new File(fModelDir, PREVIEW_BEAN_FILE_NAME);
+        LogUtils.d(TAG, "【配置文件初始化】当前Bean文件：" + currentBackgroundBeanFile.getAbsolutePath());
+        LogUtils.d(TAG, "【配置文件初始化】预览Bean文件：" + previewBackgroundBeanFile.getAbsolutePath());
+    }
+
+    /**
+     * 初始化所有文件
+     */
+    private void initAllFiles() {
+        clearCropTempFiles();
+        LogUtils.d(TAG, "【文件初始化】裁剪临时文件已清理");
+    }
+
+    /**
+     * 加载背景配置
+     */
+    public void loadSettings() {
+        LogUtils.d(TAG, "【配置加载】开始加载背景配置");
+        // 加载当前Bean
+        currentBackgroundBean = BackgroundBean.loadBeanFromFile(currentBackgroundBeanFile.getAbsolutePath(), BackgroundBean.class);
+        if (currentBackgroundBean == null) {
+            currentBackgroundBean = new BackgroundBean();
+			currentBackgroundBean.setPixelColor(ImageUtils.getColorAccent(mContext));
+            BackgroundBean.saveBeanToFile(currentBackgroundBeanFile.getAbsolutePath(), currentBackgroundBean);
+            LogUtils.d(TAG, "【配置加载】正式背景Bean不存在，已创建新实例");
+        }
+        // 加载预览Bean
+        previewBackgroundBean = BackgroundBean.loadBeanFromFile(previewBackgroundBeanFile.getAbsolutePath(), BackgroundBean.class);
+        if (previewBackgroundBean == null) {
+            previewBackgroundBean = new BackgroundBean();
+			previewBackgroundBean.setPixelColor(ImageUtils.getColorAccent(mContext));
+            BackgroundBean.saveBeanToFile(previewBackgroundBeanFile.getAbsolutePath(), previewBackgroundBean);
+            LogUtils.d(TAG, "【配置加载】预览背景Bean不存在，已创建新实例");
+        }
+        LogUtils.d(TAG, "【配置加载】背景配置加载完成");
+    }
+
+    /**
+     * 保存配置
+     */
+    public void saveSettings() {
+        LogUtils.d(TAG, "【配置保存】开始保存背景配置");
+        if (currentBackgroundBean == null || previewBackgroundBean == null) {
+            LogUtils.e(TAG, "【配置保存】失败：current/preview Bean存在空值");
+            return;
+        }
+        BackgroundBean.saveBeanToFile(currentBackgroundBeanFile.getAbsolutePath(), currentBackgroundBean);
+        BackgroundBean.saveBeanToFile(previewBackgroundBeanFile.getAbsolutePath(), previewBackgroundBean);
+        LogUtils.d(TAG, "【配置保存】两份背景配置保存成功");
+    }
+
+    // ====================== 工具方法（目录操作→文件操作→Uri转换→图片处理）======================
+    /**
+     * 创建目录并校验
+     */
+    private void createDirWithPermission(File dir, String dirDesc) {
+        if (dir == null) {
+            LogUtils.e(TAG, dirDesc + "创建失败：目录对象为null");
+            return;
+        }
+        if (!dir.exists()) {
+            LogUtils.d(TAG, dirDesc + "不存在，开始创建：" + dir.getAbsolutePath());
+            dir.mkdirs();
+        }
+        if (!dir.exists()) {
+            LogUtils.e(TAG, dirDesc + "创建失败：mkdirs返回false");
+        }
+    }
+
+    /**
+     * 校验图片目录是否就绪
+     */
+    private void validatePictureDirs() {
+        boolean allReady = fPictureBaseDir.exists() && fBackgroundSourceDir.exists()
+			&& fCropCacheDir.exists() && fBackgroundCompressDir.exists();
+        if (allReady) {
+            LogUtils.d(TAG, "【目录校验】所有图片目录均已就绪");
+        } else {
+            LogUtils.e(TAG, "【目录校验】部分图片目录未就绪，可能影响后续功能");
+        }
+    }
+
+    /**
+     * 清理单个旧文件
+     */
+    private void clearOldFile(File file, String fileDesc) {
+        if (file == null) {
+            return;
+        }
+        if (file.exists()) {
+            boolean isDeleted = file.delete();
+            LogUtils.d(TAG, fileDesc + (isDeleted ? "已删除" : "删除失败") + "：" + file.getAbsolutePath());
+        }
+    }
+
+    /**
+     * 生成新的裁剪文件名称
+     */
+    String genNewCropFileName() {
+        String fileName = UUID.randomUUID().toString() + System.currentTimeMillis();
+        LogUtils.d(TAG, "【文件命名】生成新裁剪文件名：" + fileName);
+        return fileName;
+    }
+
+    /**
+     * 将File转为ContentUri
+     */
+    public Uri getFileProviderUri(File file) {
+        LogUtils.d(TAG, "【Uri转换】开始生成FileProvider Uri，文件路径：" + (file != null ? file.getAbsolutePath() : "null"));
+        if (file == null || !file.exists()) {
+            LogUtils.e(TAG, "【Uri转换】失败：文件为空或不存在");
+            return null;
+        }
+        try {
+            Uri contentUri;
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                contentUri = FileProvider.getUriForFile(mContext, FILE_PROVIDER_AUTHORITY, file);
+                LogUtils.d(TAG, "【Uri转换】7.0+ 生成ContentUri：" + contentUri.toString());
+            } else {
+                contentUri = Uri.fromFile(file);
+                LogUtils.d(TAG, "【Uri转换】7.0以下 生成FileUri：" + contentUri.toString());
+            }
+            return contentUri;
+        } catch (IllegalArgumentException e) {
+            LogUtils.e(TAG, "【Uri转换】失败：" + e.getMessage(), e);
+            return null;
+        }
+    }
+
+    /**
+     * 检查背景是否为空并创建空白背景Bean
+     */
+    public boolean checkEmptyBackgroundAndCreateBlankBackgroundBean(BackgroundBean checkBackgroundBean) {
+        LogUtils.d(TAG, "【空白背景检查】开始检查背景Bean");
+        if (checkBackgroundBean == null) {
+            LogUtils.e(TAG, "【空白背景检查】失败：检查Bean为空");
+            return false;
+        }
+        File fCheckBackgroundFile = new File(checkBackgroundBean.getBackgroundFilePath());
+        if (fCheckBackgroundFile.exists()) {
+            LogUtils.d(TAG, "【空白背景检查】背景Bean文件存在，无需创建空白背景");
+            return false;
+        }
+        LogUtils.d(TAG, "【空白背景检查】背景Bean文件不存在，开始创建空白背景");
+        return createBlankBackgroundBean(checkBackgroundBean.getPixelColor());
+    }
+
+    /**
+     * 获取目录类型描述
+     */
+    public String getDirTypeDesc(File dir) {
+        if (dir == null) {
+            return "未知目录（null）";
+        }
+        String dirPath = dir.getAbsolutePath();
+        String publicPicturePath = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES).getAbsolutePath();
+        String externalFilesPath = mContext.getExternalFilesDir(null) != null ? mContext.getExternalFilesDir(null).getAbsolutePath() : "";
+        String cachePath = mContext.getCacheDir().getAbsolutePath();
+
+        if (!TextUtils.isEmpty(publicPicturePath)) {
+            if (dirPath.contains(publicPicturePath + File.separator + "PowerBell" + File.separator + COMPRESS_DIR_NAME)) {
+                return "系统公共图片目录（/Pictures/PowerBell/BackgroundCompress，压缩图统一存储目录）";
+            } else if (dirPath.contains(publicPicturePath + File.separator + "PowerBell")) {
+                return "系统公共图片目录（/Pictures/PowerBell，图片存储/裁剪目录）";
+            }
+        } else if (!TextUtils.isEmpty(externalFilesPath) && dirPath.contains(externalFilesPath)) {
+            return "应用私有外部目录（getExternalFilesDir()，JSON配置目录）";
+        } else if (dirPath.contains(cachePath)) {
+            return "应用内部缓存目录（getCacheDir()，兜底目录）";
+        } else {
+            return "外部存储目录（非应用私有，权限受限）";
+        }
+        return "未知目录";
+    }
+
+    /**
+     * 获取图片旋转角度
+     */
+    public int getImageRotateAngle(String imagePath) {
+        LogUtils.d(TAG, "【图片旋转角度】开始获取图片旋转角度，路径：" + imagePath);
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "【图片旋转角度】失败：图片路径为空");
+            return 0;
+        }
+        File imageFile = new File(imagePath);
+        if (!imageFile.exists() || !imageFile.isFile() || imageFile.length() <= 0) {
+            LogUtils.e(TAG, "【图片旋转角度】失败：图片文件无效：" + imagePath);
+            return 0;
+        }
+
+        InputStream inputStream = null;
+        try {
+            inputStream = new FileInputStream(imageFile);
+            ExifInterface exifInterface = new ExifInterface(inputStream);
+            int orientation = exifInterface.getAttributeInt(ExifInterface.TAG_ORIENTATION, ExifInterface.ORIENTATION_NORMAL);
+            switch (orientation) {
+                case ExifInterface.ORIENTATION_ROTATE_90:
+                    LogUtils.d(TAG, "【图片旋转角度】90度");
+                    return 90;
+                case ExifInterface.ORIENTATION_ROTATE_180:
+                    LogUtils.d(TAG, "【图片旋转角度】180度");
+                    return 180;
+                case ExifInterface.ORIENTATION_ROTATE_270:
+                    LogUtils.d(TAG, "【图片旋转角度】270度");
+                    return 270;
+                default:
+                    LogUtils.d(TAG, "【图片旋转角度】0度（正常）");
+                    return 0;
+            }
+        } catch (IOException e) {
+            LogUtils.w(TAG, "【图片旋转角度】读取EXIF异常：" + e.getMessage());
+            return 0;
+        } finally {
+            if (inputStream != null) {
+                try {
+                    inputStream.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "【图片旋转角度】流关闭失败：" + e.getMessage());
+                }
+            }
+        }
+    }
+
+    // ====================== 核心业务方法（按功能分类）======================
+    /**
+     * 创建空白背景Bean
+     */
+    public boolean createBlankBackgroundBean(int nBackgroundPixelColor) {
+        LogUtils.d(TAG, "【空白背景创建】开始创建空白背景，像素颜色：" + String.format("#%08X", nBackgroundPixelColor));
+        String newCropFileName = genNewCropFileName();
+        String fileSuffix = "png";
+        mCropSourceFile = new File(fCropCacheDir, newCropFileName + "." + fileSuffix);
+        mCropResultFile = new File(fCropCacheDir, "SelectCompress_" + newCropFileName + "." + fileSuffix);
+
+        // 复制空白图片资源
+        AssetsCopyUtils.copyAssetsFileToDir(mContext, BLANK_ASSET_PATH, mCropSourceFile.getAbsolutePath());
+        LogUtils.d(TAG, "【空白背景创建】空白图片已复制到：" + mCropSourceFile.getAbsolutePath());
+
+        // 创建结果文件
+        try {
+            mCropResultFile.createNewFile();
+            LogUtils.d(TAG, "【空白背景创建】结果文件已创建：" + mCropResultFile.getAbsolutePath());
+        } catch (IOException e) {
+            LogUtils.e(TAG, "【空白背景创建】结果文件创建失败：" + e.getMessage());
+            return false;
+        }
+
+        // 更新预览Bean
+        loadSettings();
+        previewBackgroundBean.setPixelColor(nBackgroundPixelColor);
+        previewBackgroundBean.setIsUseBackgroundFile(true);
+        previewBackgroundBean.setIsUseBackgroundScaledCompressFile(false);
+        previewBackgroundBean.setBackgroundFileName(mCropSourceFile.getName());
+        previewBackgroundBean.setBackgroundFilePath(mCropSourceFile.getAbsolutePath());
+        previewBackgroundBean.setBackgroundScaledCompressFileName(mCropResultFile.getName());
+        previewBackgroundBean.setBackgroundScaledCompressFilePath(mCropResultFile.getAbsolutePath());
+        saveSettings();
+
+        LogUtils.d(TAG, "【空白背景创建】空白背景创建成功并更新配置");
+        return true;
+    }
+
+    /**
+     * 创建并更新预览剪裁环境
+     */
+    public boolean createAndUpdatePreviewEnvironmentForCropping(BackgroundBean oldPreviewBackgroundBean) {
+        LogUtils.d(TAG, "【预览剪裁环境】开始初始化预览剪裁环境");
+        if (oldPreviewBackgroundBean == null) {
+            LogUtils.e(TAG, "【预览剪裁环境】失败：旧预览Bean为空");
+            return false;
+        }
+
+        InputStream is = null;
+        FileOutputStream fos = null;
+        try {
+            clearCropTempFiles();
+            // 检查并创建空白背景
+            if (checkEmptyBackgroundAndCreateBlankBackgroundBean(oldPreviewBackgroundBean)) {
+                LogUtils.d(TAG, "【预览剪裁环境】空白背景创建成功，直接返回");
+                return true;
+            }
+
+            // 获取Uri和文件后缀
+            Uri uri = UriUtils.getUriForFile(mContext, oldPreviewBackgroundBean.getBackgroundFilePath());
+            LogUtils.d(TAG, "【预览剪裁环境】原Uri：" + uri);
+            String fileSuffix = UriUtils.getSuffixFromUri(mContext, uri);
+            LogUtils.d(TAG, "【预览剪裁环境】文件后缀：" + fileSuffix);
+
+            // 初始化裁剪文件
+            String newCropFileName = genNewCropFileName();
+            mCropSourceFile = new File(fCropCacheDir, newCropFileName + "." + fileSuffix);
+            mCropResultFile = new File(fCropCacheDir, "SelectCompress_" + newCropFileName + ".png");
+            LogUtils.d(TAG, "【预览剪裁环境】裁剪数据源：" + mCropSourceFile.getAbsolutePath());
+            LogUtils.d(TAG, "【预览剪裁环境】裁剪结果文件：" + mCropResultFile.getAbsolutePath());
+
+            // 复制压缩文件
+            if (FileUtils.isFileExists(oldPreviewBackgroundBean.getBackgroundScaledCompressFilePath())) {
+                FileUtils.copyFile(new File(oldPreviewBackgroundBean.getBackgroundScaledCompressFilePath()), mCropResultFile);
+                LogUtils.d(TAG, "【预览剪裁环境】已复制旧压缩文件");
+            } else {
+                mCropResultFile.createNewFile();
+                LogUtils.d(TAG, "【预览剪裁环境】旧压缩文件不存在，已创建新文件");
+            }
+
+            // 复制源文件
+            if (FileUtils.isFileExists(oldPreviewBackgroundBean.getBackgroundFilePath())) {
+                FileUtils.copyFile(new File(oldPreviewBackgroundBean.getBackgroundFilePath()), mCropSourceFile);
+                LogUtils.d(TAG, "【预览剪裁环境】已复制旧源文件");
+            } else {
+                mCropSourceFile.createNewFile();
+                is = mContext.getContentResolver().openInputStream(uri);
+                if (is == null) {
+                    LogUtils.e(TAG, "【预览剪裁环境】ContentResolver打开Uri失败：" + uri.toString());
+                    return false;
+                }
+                fos = new FileOutputStream(mCropSourceFile);
+                byte[] buffer = new byte[1024 * 8];
+                int readLen;
+                while ((readLen = is.read(buffer)) != -1) {
+                    fos.write(buffer, 0, readLen);
+                }
+                fos.flush();
+                try {
+                    fos.getFD().sync();
+                } catch (IOException e) {
+                    LogUtils.w(TAG, "【预览剪裁环境】文件同步到磁盘失败，flush兜底：" + e.getMessage());
+                    fos.flush();
+                }
+                LogUtils.d(TAG, "【预览剪裁环境】已从Uri读取并写入源文件");
+            }
+
+            // 更新预览Bean
+            loadSettings();
+            previewBackgroundBean.setBackgroundFileName(mCropSourceFile.getName());
+            previewBackgroundBean.setBackgroundFilePath(mCropSourceFile.getAbsolutePath());
+            previewBackgroundBean.setBackgroundScaledCompressFileName(mCropResultFile.getName());
+            previewBackgroundBean.setBackgroundScaledCompressFilePath(mCropResultFile.getAbsolutePath());
+            saveSettings();
+
+            LogUtils.d(TAG, "【预览剪裁环境】预览剪裁环境初始化成功");
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【预览剪裁环境】初始化异常：" + e.getMessage(), e);
+            clearCropTempFiles();
+            return false;
+        } finally {
+            if (is != null) {
+                try {
+                    is.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "【预览剪裁环境】输入流关闭失败：" + e.getMessage());
+                }
+            }
+            if (fos != null) {
+                try {
+                    fos.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "【预览剪裁环境】输出流关闭失败：" + e.getMessage());
+                }
+            }
+        }
+    }
+
+    /**
+     * 保存裁剪结果图到预览Bean
+     */
+    public BackgroundBean saveFileToPreviewBean(File sourceFile, String fileInfo) {
+        LogUtils.d(TAG, "【裁剪结果保存】开始保存裁剪结果到预览Bean，源文件路径：" + (sourceFile != null ? sourceFile.getAbsolutePath() : "null"));
+        if (sourceFile == null || !sourceFile.exists() || sourceFile.length() <= 0) {
+            LogUtils.e(TAG, "【裁剪结果保存】失败：源文件无效");
+            return previewBackgroundBean;
+        }
+
+        // 检查是否为原图目录
+        String originalImageDir = mContext.getExternalFilesDir(Environment.DIRECTORY_PICTURES).getAbsolutePath();
+        if (sourceFile.getAbsolutePath().contains(originalImageDir)) {
+            LogUtils.w(TAG, "【裁剪结果保存】禁止复制原图，跳过保存");
+            return previewBackgroundBean;
+        }
+
+        // 确保目录存在
+        if (!fBackgroundSourceDir.exists() && !fBackgroundSourceDir.mkdirs()) {
+            LogUtils.e(TAG, "【裁剪结果保存】失败：BackgroundSource目录创建失败");
+            return previewBackgroundBean;
+        }
+
+        // 生成唯一文件名并复制
+        String uniqueFileName = "bg_" + System.currentTimeMillis() + "_" + sourceFile.getName();
+        File targetFile = new File(fBackgroundSourceDir, uniqueFileName);
+        if (FileUtils.copyFile(sourceFile, targetFile)) {
+            LogUtils.d(TAG, "【裁剪结果保存】裁剪结果图保存成功：" + targetFile.getAbsolutePath());
+            // 更新预览Bean
+            previewBackgroundBean.setBackgroundFileName(uniqueFileName);
+            previewBackgroundBean.setBackgroundFilePath(targetFile.getAbsolutePath());
+            previewBackgroundBean.setBackgroundFileInfo(fileInfo);
+            previewBackgroundBean.setIsUseBackgroundFile(true);
+            saveSettings();
+        } else {
+            LogUtils.e(TAG, "【裁剪结果保存】失败：裁剪结果图复制失败");
+        }
+        return previewBackgroundBean;
+    }
+
+    /**
+     * 提交预览背景到正式背景
+     */
+    public void commitPreviewSourceToCurrent() {
+        LogUtils.d(TAG, "【背景提交】开始深拷贝预览Bean到正式Bean");
+        // 深拷贝Bean属性
+        currentBackgroundBean = new BackgroundBean();
+		currentBackgroundBean.setPixelColor(ImageUtils.getColorAccent(mContext));
+        copyBackgroundBeanProperties(previewBackgroundBean, currentBackgroundBean);
+
+        // 复制文件
+        String previewFileName = previewBackgroundBean.getBackgroundFileName();
+        String previewCropFileName = previewBackgroundBean.getBackgroundScaledCompressFileName();
+        File previewFile = new File(previewBackgroundBean.getBackgroundFilePath());
+        File previewCropFile = new File(previewBackgroundBean.getBackgroundScaledCompressFilePath());
+        File currentFile = new File(fBackgroundSourceDir, previewFileName);
+        File currentCropFile = new File(fBackgroundCompressDir, previewCropFileName);
+        FileUtils.copyFile(previewFile, currentFile);
+        FileUtils.copyFile(previewCropFile, currentCropFile);
+
+        // 更新文件路径
+        currentBackgroundBean.setBackgroundFilePath(currentFile.getAbsolutePath());
+        currentBackgroundBean.setBackgroundScaledCompressFilePath(currentCropFile.getAbsolutePath());
+
+        saveSettings();
+        LogUtils.d(TAG, "【背景提交】预览背景提交到正式背景成功，两份实例完全独立");
+        ToastUtils.show("背景图片应用成功");
+    }
+
+    /**
+     * 将正式背景同步到预览背景
+     */
+    public void setCurrentSourceToPreview() {
+        LogUtils.d(TAG, "【背景同步】开始深拷贝正式Bean到预览Bean");
+        // 深拷贝Bean属性
+        previewBackgroundBean = new BackgroundBean();
+		previewBackgroundBean.setPixelColor(ImageUtils.getColorAccent(mContext));
+        copyBackgroundBeanProperties(currentBackgroundBean, previewBackgroundBean);
+
+        saveSettings();
+        LogUtils.d(TAG, "【背景同步】正式背景同步到预览背景成功");
+    }
+
+    /**
+     * 清理裁剪临时文件
+     */
+    void clearCropTempFiles() {
+        LogUtils.d(TAG, "【裁剪文件清理】开始清理裁剪临时文件");
+        File[] files = fCropCacheDir.listFiles();
+        if (files == null) {
+            LogUtils.d(TAG, "【裁剪文件清理】裁剪缓存目录为空，无需清理");
+            return;
+        }
+        for (File file : files) {
+            clearOldFile(file, "旧裁剪缓存文件");
+        }
+        mCropSourceFile = null;
+        mCropResultFile = null;
+        LogUtils.d(TAG, "【裁剪文件清理】裁剪临时文件清理完成");
+    }
+
+    /**
+     * 复制文件
+     */
+    public boolean copyFile(File source, File target) {
+        LogUtils.d(TAG, "【文件复制】开始复制文件，源文件：" + (source != null ? source.getAbsolutePath() : "null") + " 目标：" + (target != null ? target.getAbsolutePath() : "null"));
+        if (source == null || TextUtils.isEmpty(source.getPath()) || (source.exists() && source.length() <= 0)) {
+            if (target == null) {
+                LogUtils.e(TAG, "【文件复制】失败：目标对象为null");
+                return false;
+            }
+            File targetDir = target.isFile() ? target.getParentFile() : target;
+            createDirWithPermission(targetDir, "空源文件场景-目录创建");
+            LogUtils.d(TAG, "【文件复制】空源文件场景，目录创建完成");
+            return true;
+        }
+        boolean isSuccess = FileUtils.copyFile(source, target);
+        LogUtils.d(TAG, "【文件复制】" + (isSuccess ? "成功" : "失败"));
+        return isSuccess;
+    }
+
+    /**
+     * 迁移旧压缩图路径到新目录
+     */
+    private void migrateCompressPathToNewDir(BackgroundBean bean, boolean isCurrentBean) {
+        LogUtils.d(TAG, "【路径迁移】开始迁移" + (isCurrentBean ? "正式" : "预览") + "Bean压缩路径");
+        if (bean == null) {
+            LogUtils.e(TAG, "【路径迁移】失败：Bean为空");
+            return;
+        }
+        String oldCompressPath = bean.getBackgroundScaledCompressFilePath();
+        String beanType = isCurrentBean ? "正式Bean" : "预览Bean";
+
+        if (TextUtils.isEmpty(oldCompressPath) || oldCompressPath.contains(fBackgroundCompressDir.getAbsolutePath())) {
+            LogUtils.d(TAG, "【路径迁移】" + beanType + "无需迁移：旧路径为空或已在目标目录");
+            return;
+        }
+
+        File oldCompressFile = new File(oldCompressPath);
+        if (!oldCompressFile.exists() || !oldCompressFile.isFile() || oldCompressFile.length() <= 0) {
+            LogUtils.w(TAG, "【路径迁移】" + beanType + "旧压缩文件无效，无需迁移：" + oldCompressPath);
+            String compressFileName = bean.getBackgroundScaledCompressFileName();
+            if (!TextUtils.isEmpty(compressFileName)) {
+                File newCompressFile = new File(fBackgroundCompressDir, compressFileName);
+                bean.setBackgroundScaledCompressFilePath(newCompressFile.getAbsolutePath());
+                saveSettings();
+                LogUtils.d(TAG, "【路径迁移】" + beanType + "压缩路径已重置到目标目录");
+            }
+            return;
+        }
+
+        String compressFileName = bean.getBackgroundScaledCompressFileName();
+        if (TextUtils.isEmpty(compressFileName)) {
+            compressFileName = "ScaledCompress_" + System.currentTimeMillis() + ".jpg";
+        }
+        File newCompressFile = new File(fBackgroundCompressDir, compressFileName);
+
+        boolean copySuccess = FileUtils.copyFile(oldCompressFile, newCompressFile);
+        if (copySuccess) {
+            bean.setBackgroundScaledCompressFilePath(newCompressFile.getAbsolutePath());
+            saveSettings();
+            clearOldFile(oldCompressFile, beanType + "旧压缩文件（迁移后清理）");
+            LogUtils.d(TAG, "【路径迁移】" + beanType + "压缩路径迁移成功：" + oldCompressPath + " → " + newCompressFile.getAbsolutePath());
+        } else {
+            LogUtils.e(TAG, "【路径迁移】" + beanType + "压缩文件复制失败，迁移终止");
+        }
+    }
+
+    /**
+     * 压缩图片并保存（默认路径）
+     */
+    public void compressQualityToRecivedPicture(Bitmap bitmap) {
+        LogUtils.d(TAG, "【图片压缩】使用默认路径压缩图片");
+        String defaultCompressPath = getPreviewBackgroundScaledCompressFilePath();
+        compressQualityToRecivedPicture(bitmap, defaultCompressPath);
+    }
+
+    /**
+     * 压缩图片并保存（指定路径）
+     */
+    public void compressQualityToRecivedPicture(Bitmap bitmap, String targetCompressPath) {
+        LogUtils.d(TAG, "【图片压缩】指定路径压缩图片，目标路径：" + targetCompressPath);
+        if (bitmap == null || bitmap.isRecycled()) {
+            ToastUtils.show("压缩失败：图片为空");
+            LogUtils.e(TAG, "【图片压缩】失败：Bitmap为空或已回收");
+            return;
+        }
+        if (TextUtils.isEmpty(targetCompressPath)) {
+            ToastUtils.show("压缩失败：目标路径为空");
+            LogUtils.e(TAG, "【图片压缩】失败：目标路径为空");
+            return;
+        }
+
+        OutputStream outStream = null;
+        FileOutputStream fos = null;
+        try {
+            LogUtils.d(TAG, "【图片压缩】Bitmap原始大小：" + bitmap.getByteCount() / 1024 + "KB");
+            File targetCompressFile = new File(targetCompressPath);
+            if (targetCompressFile.exists()) {
+                targetCompressFile.delete();
+                LogUtils.d(TAG, "【图片压缩】已删除旧压缩文件");
+            }
+            targetCompressFile.createNewFile();
+
+            fos = new FileOutputStream(targetCompressFile);
+            outStream = new BufferedOutputStream(fos);
+            boolean compressSuccess = bitmap.compress(COMPRESS_FORMAT, BITMAP_COMPRESS_QUALITY, outStream);
+            outStream.flush();
+            try {
+                fos.getFD().sync();
+                LogUtils.d(TAG, "【图片压缩】图片已强制同步到磁盘");
+            } catch (IOException e) {
+                LogUtils.w(TAG, "【图片压缩】sync失败，flush兜底：" + e.getMessage());
+                outStream.flush();
+            }
+
+            LogUtils.d(TAG, "【图片压缩】" + (compressSuccess ? "成功" : "失败") + "，大小：" + targetCompressFile.length() / 1024 + "KB");
+            ToastUtils.show(compressSuccess ? "图片压缩成功" : "图片压缩失败");
+        } catch (IOException e) {
+            LogUtils.e(TAG, "【图片压缩】IO异常：" + e.getMessage(), e);
+            ToastUtils.show("图片压缩失败");
+        } finally {
+            if (outStream != null) {
+                try {
+                    outStream.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "【图片压缩】BufferedOutputStream关闭失败：" + e.getMessage());
+                }
+            }
+            if (fos != null) {
+                try {
+                    fos.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "【图片压缩】FileOutputStream关闭失败：" + e.getMessage());
+                }
+            }
+            if (bitmap != null && !bitmap.isRecycled()) {
+                bitmap.recycle();
+                LogUtils.d(TAG, "【图片压缩】Bitmap已回收");
+            }
+        }
+    }
+
+    // ====================== 辅助方法（属性拷贝）======================
+    /**
+     * 拷贝BackgroundBean属性（深拷贝）
+     */
+    private void copyBackgroundBeanProperties(BackgroundBean source, BackgroundBean target) {
+        target.setBackgroundFileName(source.getBackgroundFileName());
+        target.setBackgroundFilePath(source.getBackgroundFilePath());
+        target.setBackgroundFileInfo(source.getBackgroundFileInfo());
+        target.setIsUseBackgroundFile(source.isUseBackgroundFile());
+        target.setBackgroundScaledCompressFileName(source.getBackgroundScaledCompressFileName());
+        target.setBackgroundScaledCompressFilePath(source.getBackgroundScaledCompressFilePath());
+        target.setIsUseBackgroundScaledCompressFile(source.isUseBackgroundScaledCompressFile());
+        target.setBackgroundWidth(source.getBackgroundWidth());
+        target.setBackgroundHeight(source.getBackgroundHeight());
+        target.setPixelColor(source.getPixelColor());
+    }
+
+    // ====================== 对外提供的getter方法 ======================
+    public BackgroundBean getCurrentBackgroundBean() {
+        return currentBackgroundBean;
+    }
+
+    public BackgroundBean getPreviewBackgroundBean() {
+        return previewBackgroundBean;
+    }
+
+    public String getPreviewBackgroundScaledCompressFilePath() {
+        String compressFileName = previewBackgroundBean.getBackgroundScaledCompressFileName();
+        if (TextUtils.isEmpty(compressFileName)) {
+            LogUtils.e(TAG, "【路径获取】预览压缩背景文件名为空");
+            return "";
+        }
+        File file = new File(fBackgroundCompressDir, compressFileName);
+        return file.getAbsolutePath();
+    }
+
+    public String getCurrentBackgroundScaledCompressFilePath() {
+        String compressFileName = currentBackgroundBean.getBackgroundScaledCompressFileName();
+        if (TextUtils.isEmpty(compressFileName)) {
+            LogUtils.e(TAG, "【路径获取】正式压缩背景文件名为空");
+            return "";
+        }
+        File file = new File(fBackgroundCompressDir, compressFileName);
+        return file.getAbsolutePath();
+    }
+
+    public String getBackgroundSourceDirPath() {
+        return fBackgroundSourceDir.getAbsolutePath();
+    }
+
+    public String getBackgroundCompressDirPath() {
+        return fBackgroundCompressDir.getAbsolutePath();
+    }
+
+    public String getCropCacheDir() {
+        return fCropCacheDir.getAbsolutePath();
+    }
+
+    public String getFileProviderAuthority() {
+        return FILE_PROVIDER_AUTHORITY;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BatteryUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BatteryUtils.java
new file mode 100644
index 0000000..c55c3e8
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BatteryUtils.java
@@ -0,0 +1,82 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Intent;
+import android.os.BatteryManager;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2024/07/18 04:32:46
+ * @Describe 电池状态工具类
+ * 功能：解析电池广播Intent，获取充电状态、当前电量
+ * 适配：Java7 | API30 | 小米手机
+ */
+public class BatteryUtils {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "BatteryUtils";
+
+    // 电池电量计算常量
+    private static final int BATTERY_SCALE_DEFAULT = 100; // 电量刻度默认值
+    private static final int BATTERY_LEVEL_MIN = 0;       // 电量百分比最小值
+    private static final int BATTERY_LEVEL_MAX = 100;     // 电量百分比最大值
+    private static final int EXTRA_STATUS_DEFAULT = -1;   // 电池状态默认值
+
+    // ================================== 工具方法（静态方法，无状态设计）=================================
+    /**
+     * 判断当前是否处于充电状态
+     * @param intent 电池状态广播Intent（非空）
+     * @return true=充电中/已充满，false=未充电
+     */
+    public static boolean isCharging(Intent intent) {
+        LogUtils.d(TAG, "【isCharging】调用开始");
+        // 入参非空校验
+        if (intent == null) {
+            LogUtils.e(TAG, "【isCharging】入参异常：intent为空，返回false");
+            return false;
+        }
+
+        // 解析电池状态
+        int status = intent.getIntExtra(BatteryManager.EXTRA_STATUS, EXTRA_STATUS_DEFAULT);
+        LogUtils.d(TAG, "【isCharging】解析电池状态：status=" + status);
+
+        // 判断充电状态（充电中/已充满均视为充电状态）
+        boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING 
+			|| status == BatteryManager.BATTERY_STATUS_FULL;
+        LogUtils.d(TAG, "【isCharging】调用结束 | 充电状态=" + isCharging);
+        return isCharging;
+    }
+
+    /**
+     * 获取当前电池电量百分比（0-100）
+     * @param intent 电池状态广播Intent（非空）
+     * @return 电量百分比，异常返回0
+     */
+    public static int getCurrentBatteryLevel(Intent intent) {
+        LogUtils.d(TAG, "【getCurrentBatteryLevel】调用开始");
+        // 入参非空校验
+        if (intent == null) {
+            LogUtils.e(TAG, "【getCurrentBatteryLevel】入参异常：intent为空，返回0");
+            return BATTERY_LEVEL_MIN;
+        }
+
+        // 解析电量原始值与刻度值
+        int level = intent.getIntExtra(BatteryManager.EXTRA_LEVEL, BATTERY_LEVEL_MIN);
+        int scale = intent.getIntExtra(BatteryManager.EXTRA_SCALE, BATTERY_SCALE_DEFAULT);
+        LogUtils.d(TAG, "【getCurrentBatteryLevel】解析原始数据 | level=" + level + " | scale=" + scale);
+
+        // 计算并校验电量百分比，避免除以0或数值越界
+        int batteryLevel;
+        if (scale <= 0) {
+            LogUtils.w(TAG, "【getCurrentBatteryLevel】刻度值无效（scale=" + scale + "），直接使用level值");
+            batteryLevel = level;
+        } else {
+            batteryLevel = level * BATTERY_SCALE_DEFAULT / scale;
+        }
+
+        // 确保电量值在0-100范围内
+        batteryLevel = Math.max(BATTERY_LEVEL_MIN, Math.min(batteryLevel, BATTERY_LEVEL_MAX));
+        LogUtils.d(TAG, "【getCurrentBatteryLevel】调用结束 | 电量百分比=" + batteryLevel + "%");
+        return batteryLevel;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BitmapCacheUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BitmapCacheUtils.java
new file mode 100644
index 0000000..b7b2ac5
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/BitmapCacheUtils.java
@@ -0,0 +1,491 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.content.res.Configuration;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.os.Build;
+import android.text.TextUtils;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import java.io.File;
+import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.ConcurrentHashMap;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/11 01:57
+ * @Describe 单例 Bitmap 缓存工具类（Java 7 兼容）- 极致强制缓存版（无图片压缩）
+ * 功能：内存缓存 Bitmap，支持路径关联缓存、全局获取、缓存清空、SP 持久化最后缓存路径、构造时预加载
+ * 特点：1. 单例模式  2. 硬引用唯一缓存（极致强制保持，任何情况不自动回收）  3. 路径-Bitmap 映射  4. 线程安全
+ *       5. SP 持久化最后缓存路径  6. 构造时预加载  7. 引用计数防误回收  8. 无图片压缩，保留原始品质
+ * 核心策略：无论内存如何紧张，强制保持已缓存的Bitmap，保留图片原始品质，永不自动清理
+ */
+public class BitmapCacheUtils {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "BitmapCacheUtils";
+
+    // SP 相关常量
+    private static final String SP_NAME = "BitmapCacheSP";
+    private static final String SP_KEY_LAST_CACHE_PATH = "last_cache_image_path";
+
+    // Bitmap 解码常量
+    private static final int BITMAP_SAMPLE_SIZE_ORIGINAL = 1; // 无压缩采样率
+    private static final Bitmap.Config BITMAP_CONFIG_DEFAULT = Bitmap.Config.ARGB_8888; // 全彩品质配置
+
+    // ================================== 成员变量（按功能分类，volatile 保证多线程可见性）=================================
+    // 单例实例
+    private static volatile BitmapCacheUtils sInstance;
+    // 路径-Bitmap 硬引用缓存（极致强制保持，永不自动回收）
+    private final Map<String, Bitmap> mHardCacheMap;
+    // 路径-引用计数 映射（仅统计，不影响缓存生命周期）
+    private final Map<String, Integer> mRefCountMap;
+    // SP 实例（用于持久化最后缓存路径）
+    private final SharedPreferences mSp;
+
+    // ================================== 单例方法（双重校验锁，线程安全）=================================
+    /**
+     * 私有构造器（单例模式）
+     */
+    private BitmapCacheUtils() {
+        LogUtils.d(TAG, "【BitmapCacheUtils】单例构造开始");
+		//App.notifyMessage(TAG, "【BitmapCacheUtils】单例构造开始");
+        // 使用 ConcurrentHashMap 保证线程安全，避免手动同步
+        mHardCacheMap = new ConcurrentHashMap<>();
+        mRefCountMap = new ConcurrentHashMap<>();
+        // 初始化 SP（使用 App 全局上下文，避免内存泄漏）
+        mSp = App.getInstance().getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        // 构造时自动预加载 SP 中保存的最后一次缓存路径的图片
+        preloadLastCachedBitmap();
+        // 注册内存状态监听（仅记录日志，不清理缓存）
+        registerMemoryStatusListener();
+        LogUtils.d(TAG, "【BitmapCacheUtils】单例构造完成，极致强制缓存策略已启用");
+    }
+
+    /**
+     * 获取单例实例（双重校验锁，线程安全）
+     */
+    public static BitmapCacheUtils getInstance() {
+        if (sInstance == null) {
+            synchronized (BitmapCacheUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new BitmapCacheUtils();
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    // ================================== 对外监控接口（App 类调用专用）=================================
+    /**
+     * 获取当前缓存的 Bitmap 数量
+     * @return 缓存的 Bitmap 数量
+     */
+    public int getCacheCount() {
+        int count = mHardCacheMap.size();
+        LogUtils.d(TAG, "【getCacheCount】当前缓存 Bitmap 数量 - " + count);
+        return count;
+    }
+
+    /**
+     * 获取当前缓存的所有图片路径集合
+     * @return 路径集合
+     */
+    public Set<String> getCachedPaths() {
+        Set<String> paths = mHardCacheMap.keySet();
+        LogUtils.d(TAG, "【getCachedPaths】当前缓存路径数量 - " + paths.size());
+        return paths;
+    }
+
+    /**
+     * 估算当前缓存的总内存占用（单位：字节）
+     * @return 总内存占用
+     */
+    public long getTotalCacheSize() {
+        long totalSize = 0;
+        for (Bitmap bitmap : mHardCacheMap.values()) {
+            if (isBitmapValid(bitmap)) {
+                if (Build.VERSION.SDK_INT >= 12) {
+                    totalSize += bitmap.getByteCount();
+                } else {
+                    totalSize += bitmap.getRowBytes() * bitmap.getHeight();
+                }
+            }
+        }
+        LogUtils.d(TAG, "【getTotalCacheSize】当前缓存总内存占用 - " + totalSize + " 字节");
+        return totalSize;
+    }
+
+    // ================================== 对外核心接口：缓存操作（无压缩）=================================
+    /**
+     * 直接缓存已解码的 Bitmap（适配 BackgroundView 改进需求）
+     * @param imagePath 图片绝对路径
+     * @param bitmap 已解码的有效 Bitmap
+     * @return 缓存后的 Bitmap / null（参数无效）
+     */
+    public Bitmap cacheBitmap(String imagePath, Bitmap bitmap) {
+        LogUtils.d(TAG, "【cacheBitmap】调用开始（直接缓存已解码 Bitmap）| 路径=" + imagePath);
+        // 入参非空校验
+        if (TextUtils.isEmpty(imagePath) || !isBitmapValid(bitmap)) {
+            LogUtils.e(TAG, "【cacheBitmap】入参异常：路径为空或 Bitmap 无效");
+            return null;
+        }
+
+        // 极致强制：直接存入硬引用缓存，覆盖旧值（若存在）
+        mHardCacheMap.put(imagePath, bitmap);
+        // 初始化引用计数为1（若不存在）
+        mRefCountMap.putIfAbsent(imagePath, 1);
+        // 持久化当前路径到 SP
+        saveLastCachePathToSp(imagePath);
+        LogUtils.d(TAG, "【cacheBitmap】调用成功（直接缓存已解码 Bitmap）| 路径=" + imagePath);
+        return bitmap;
+    }
+
+    /**
+     * 根据图片路径缓存 Bitmap 到内存，并持久化路径到 SP
+     * @param imagePath 图片绝对路径
+     * @return 缓存成功的 Bitmap / null（路径无效/文件不存在/解码失败）
+     */
+    public Bitmap cacheBitmap(String imagePath) {
+        LogUtils.d(TAG, "【cacheBitmap】调用开始（路径缓存）| 路径=" + imagePath);
+        // 入参非空校验
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "【cacheBitmap】入参异常：图片路径为空");
+            return null;
+        }
+
+        // 文件有效性校验
+        File imageFile = new File(imagePath);
+        if (!imageFile.exists() || !imageFile.isFile() || imageFile.length() <= 0) {
+            LogUtils.e(TAG, "【cacheBitmap】文件无效：不存在/非文件/空文件 | 路径=" + imagePath);
+            return null;
+        }
+
+        // 已缓存则直接返回，避免重复加载
+        Bitmap hardCacheBitmap = mHardCacheMap.get(imagePath);
+        if (isBitmapValid(hardCacheBitmap)) {
+            LogUtils.d(TAG, "【cacheBitmap】硬引用缓存命中，引用计数+1 | 路径=" + imagePath);
+            // 引用计数+1
+            increaseRefCount(imagePath);
+            // 持久化当前路径到 SP
+            saveLastCachePathToSp(imagePath);
+            LogUtils.d(TAG, "【cacheBitmap】调用成功（缓存命中）| 路径=" + imagePath);
+            return hardCacheBitmap;
+        }
+
+        // 无压缩解码 Bitmap（保留原始品质）
+        Bitmap bitmap = decodeOriginalBitmap(imagePath);
+        if (bitmap != null) {
+            // 极致强制：存入硬引用缓存，永不自动回收
+            mHardCacheMap.put(imagePath, bitmap);
+            // 初始化引用计数为1
+            mRefCountMap.put(imagePath, 1);
+            // 持久化当前路径到 SP
+            saveLastCachePathToSp(imagePath);
+            LogUtils.d(TAG, "【cacheBitmap】调用成功（新缓存）| 路径=" + imagePath);
+        } else {
+            LogUtils.e(TAG, "【cacheBitmap】调用失败：图片解码失败 | 路径=" + imagePath);
+        }
+        return bitmap;
+    }
+
+    /**
+     * 根据路径获取缓存的 Bitmap
+     * @param imagePath 图片绝对路径
+     * @return 缓存的有效 Bitmap / null（未缓存/已回收）
+     */
+    public Bitmap getCachedBitmap(String imagePath) {
+        LogUtils.d(TAG, "【getCachedBitmap】调用开始 | 路径=" + imagePath);
+        // 入参非空校验
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "【getCachedBitmap】入参异常：图片路径为空");
+            return null;
+        }
+
+        // 仅从硬引用缓存获取，无任何 fallback
+        Bitmap hardCacheBitmap = mHardCacheMap.get(imagePath);
+        if (isBitmapValid(hardCacheBitmap)) {
+            LogUtils.d(TAG, "【getCachedBitmap】调用成功（缓存命中）| 路径=" + imagePath);
+            return hardCacheBitmap;
+        }
+
+        // 缓存未命中或 Bitmap 已失效（极致强制策略下，理论上不会出现已回收情况）
+        LogUtils.w(TAG, "【getCachedBitmap】调用失败：缓存未命中或 Bitmap 已失效 | 路径=" + imagePath);
+        return null;
+    }
+
+    // ================================== 对外接口：引用计数管理（仅统计，不影响缓存）=================================
+    /**
+     * 增加指定路径 Bitmap 的引用计数
+     * @param imagePath 图片绝对路径
+     */
+    public void increaseRefCount(String imagePath) {
+        LogUtils.d(TAG, "【increaseRefCount】调用开始 | 路径=" + imagePath);
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "【increaseRefCount】入参异常：图片路径为空");
+            return;
+        }
+        synchronized (mRefCountMap) {
+            Integer count = mRefCountMap.get(imagePath);
+            if (count == null) {
+                mRefCountMap.put(imagePath, 1);
+            } else {
+                mRefCountMap.put(imagePath, count + 1);
+            }
+            int newCount = mRefCountMap.get(imagePath);
+            LogUtils.d(TAG, "【increaseRefCount】调用成功 | 路径=" + imagePath + " | 引用计数=" + newCount);
+        }
+    }
+
+    /**
+     * 减少指定路径 Bitmap 的引用计数，计数为0时仅标记不回收（极致强制缓存策略）
+     * @param imagePath 图片绝对路径
+     */
+    public void decreaseRefCount(String imagePath) {
+        LogUtils.d(TAG, "【decreaseRefCount】调用开始 | 路径=" + imagePath);
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "【decreaseRefCount】入参异常：图片路径为空");
+            return;
+        }
+        synchronized (mRefCountMap) {
+            Integer count = mRefCountMap.get(imagePath);
+            if (count == null || count <= 0) {
+                LogUtils.w(TAG, "【decreaseRefCount】引用计数无效：路径=" + imagePath);
+                return;
+            }
+
+            int newCount = count - 1;
+            if (newCount <= 0) {
+                // 极致强制缓存策略：引用计数为0时仅移除计数，绝对不回收 Bitmap
+                mRefCountMap.remove(imagePath);
+                LogUtils.d(TAG, "【decreaseRefCount】调用成功 | 路径=" + imagePath + " | 引用计数为0，极致强制保持 Bitmap");
+            } else {
+                mRefCountMap.put(imagePath, newCount);
+                LogUtils.d(TAG, "【decreaseRefCount】调用成功 | 路径=" + imagePath + " | 引用计数=" + newCount);
+            }
+        }
+    }
+
+    // ================================== 对外接口：缓存清理（仅手动调用，永不自动执行）=================================
+    /**
+     * 清空所有 Bitmap 缓存（仅手动调用时执行，任何情况不自动执行）
+     */
+    public void clearAllCache() {
+        LogUtils.w(TAG, "【clearAllCache】调用开始（极致强制缓存策略下，需谨慎使用）");
+
+        // 清空硬引用缓存并回收 Bitmap
+        for (Bitmap bitmap : mHardCacheMap.values()) {
+            if (isBitmapValid(bitmap)) {
+                bitmap.recycle();
+            }
+        }
+        mHardCacheMap.clear();
+
+        // 清空引用计数
+        mRefCountMap.clear();
+
+        // 清空 SP 中保存的最后缓存路径
+        clearLastCachePathInSp();
+
+        LogUtils.d(TAG, "【clearAllCache】调用成功：所有 Bitmap 缓存已清空");
+    }
+
+    /**
+     * 移除指定路径的 Bitmap 缓存（仅手动调用时执行，任何情况不自动执行）
+     * @param imagePath 图片绝对路径
+     */
+    public void removeCachedBitmap(String imagePath) {
+        LogUtils.d(TAG, "【removeCachedBitmap】调用开始 | 路径=" + imagePath);
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "【removeCachedBitmap】入参异常：图片路径为空");
+            return;
+        }
+
+        synchronized (mRefCountMap) {
+            // 手动移除时才回收 Bitmap
+            Bitmap hardBitmap = mHardCacheMap.remove(imagePath);
+            if (isBitmapValid(hardBitmap)) {
+                hardBitmap.recycle();
+                LogUtils.d(TAG, "【removeCachedBitmap】手动回收硬引用缓存 | 路径=" + imagePath);
+            }
+            mRefCountMap.remove(imagePath);
+
+            // 若移除的是最后缓存的路径，清空 SP
+            String lastPath = getLastCachePathFromSp();
+            if (imagePath.equals(lastPath)) {
+                clearLastCachePathInSp();
+                LogUtils.d(TAG, "【removeCachedBitmap】移除最后缓存路径，已清空 SP");
+            }
+        }
+        LogUtils.d(TAG, "【removeCachedBitmap】调用成功 | 路径=" + imagePath);
+    }
+
+    // ================================== 内部工具方法（无压缩解码 + Bitmap 有效性判断）=================================
+    /**
+     * 无压缩解码 Bitmap（保留原始品质）
+     * @param imagePath 图片绝对路径
+     * @return 解码后的 Bitmap / null（文件无效/解码失败）
+     */
+    private Bitmap decodeOriginalBitmap(String imagePath) {
+        LogUtils.d(TAG, "【decodeOriginalBitmap】调用开始 | 路径=" + imagePath);
+        // 前置校验：确保文件有效
+        File imageFile = new File(imagePath);
+        if (!imageFile.exists() || !imageFile.isFile() || imageFile.length() <= 0) {
+            LogUtils.e(TAG, "【decodeOriginalBitmap】文件无效，跳过解码 | 路径=" + imagePath);
+            return null;
+        }
+
+        BitmapFactory.Options options = new BitmapFactory.Options();
+        // 仅获取尺寸用于日志记录，不参与解码逻辑
+        options.inJustDecodeBounds = true;
+        BitmapFactory.decodeFile(imagePath, options);
+
+        // 校验尺寸是否有效
+        if (options.outWidth <= 0 || options.outHeight <= 0) {
+            LogUtils.e(TAG, "【decodeOriginalBitmap】图片尺寸无效 | 路径=" + imagePath);
+            return null;
+        }
+
+        LogUtils.d(TAG, "【decodeOriginalBitmap】图片原始尺寸 | 宽=" + options.outWidth + " | 高=" + options.outHeight);
+
+        // 无压缩解码配置
+        options.inJustDecodeBounds = false;
+        options.inSampleSize = BITMAP_SAMPLE_SIZE_ORIGINAL; // 不缩放，采样率为1
+        options.inPreferredConfig = BITMAP_CONFIG_DEFAULT; // 保留全彩品质
+        options.inPurgeable = false; // 关闭可清除标志，极致强制保持内存
+        options.inInputShareable = false;
+        options.inDither = true; // 开启抖动，保证色彩还原
+        options.inScaled = false; // 关闭自动缩放，保留原始尺寸
+
+        try {
+            Bitmap bitmap = BitmapFactory.decodeFile(imagePath, options);
+            LogUtils.d(TAG, "【decodeOriginalBitmap】解码" + (bitmap != null ? "成功" : "失败") + " | 路径=" + imagePath);
+            return bitmap;
+        } catch (OutOfMemoryError e) {
+            LogUtils.e(TAG, "【decodeOriginalBitmap】OOM 异常（无压缩，图片尺寸过大）| 路径=" + imagePath);
+            // 极致强制缓存策略：OOM 时仅放弃当前解码，绝对不清理已缓存的 Bitmap
+            return null;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【decodeOriginalBitmap】解码异常 | 路径=" + imagePath, e);
+            return null;
+        }
+    }
+
+    /**
+     * 判断 Bitmap 是否有效（非空且未被回收）
+     */
+    private boolean isBitmapValid(Bitmap bitmap) {
+        boolean isValid = bitmap != null && !bitmap.isRecycled();
+        if (!isValid) {
+            LogUtils.w(TAG, "【isBitmapValid】Bitmap 无效：空或已回收");
+        }
+        return isValid;
+    }
+
+    // ================================== 内部工具方法：SP 持久化相关 ==================================
+    /**
+     * 从 SP 中获取最后一次缓存的图片路径
+     * @return 最后缓存的路径 / null（未保存）
+     */
+    private String getLastCachePathFromSp() {
+        String path = mSp.getString(SP_KEY_LAST_CACHE_PATH, null);
+        LogUtils.d(TAG, "【getLastCachePathFromSp】获取最后缓存路径 | 路径=" + path);
+        return path;
+    }
+
+    /**
+     * 将当前缓存路径持久化到 SP
+     * @param imagePath 图片绝对路径
+     */
+    private void saveLastCachePathToSp(String imagePath) {
+        LogUtils.d(TAG, "【saveLastCachePathToSp】调用开始 | 路径=" + imagePath);
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "【saveLastCachePathToSp】入参异常：图片路径为空");
+            return;
+        }
+        mSp.edit().putString(SP_KEY_LAST_CACHE_PATH, imagePath).commit(); // Java 7 兼容，使用 commit 而非 apply
+        LogUtils.d(TAG, "【saveLastCachePathToSp】调用成功 | 路径=" + imagePath);
+    }
+
+    /**
+     * 清空 SP 中保存的最后缓存路径
+     */
+    private void clearLastCachePathInSp() {
+        mSp.edit().remove(SP_KEY_LAST_CACHE_PATH).commit();
+        LogUtils.d(TAG, "【clearLastCachePathInSp】调用成功：SP 中最后缓存路径已清空");
+    }
+
+    // ================================== 内部工具方法：预加载相关 ==================================
+    /**
+     * 构造时预加载 SP 中保存的最后一次缓存路径的图片
+     */
+    private void preloadLastCachedBitmap() {
+        LogUtils.d(TAG, "【preloadLastCachedBitmap】调用开始");
+        String lastPath = getLastCachePathFromSp();
+        if (TextUtils.isEmpty(lastPath)) {
+            LogUtils.d(TAG, "【preloadLastCachedBitmap】SP 中无保存的缓存路径，跳过预加载");
+            return;
+        }
+        // 调用 cacheBitmap 预加载（内部已做文件校验和缓存判断）
+        Bitmap bitmap = cacheBitmap(lastPath);
+        if (bitmap != null) {
+            LogUtils.d(TAG, "【preloadLastCachedBitmap】预加载成功 | 路径=" + lastPath);
+        } else {
+            LogUtils.w(TAG, "【preloadLastCachedBitmap】预加载失败，清空无效路径 | 路径=" + lastPath);
+            // 预加载失败，清空 SP 中无效路径
+            clearLastCachePathInSp();
+        }
+    }
+
+    // ================================== 内部工具方法：内存状态监听（仅记录日志）=================================
+    /**
+     * 注册内存状态监听（仅记录日志，不清理缓存，极致强制缓存策略）
+     */
+    private void registerMemoryStatusListener() {
+        LogUtils.d(TAG, "【registerMemoryStatusListener】调用开始");
+        if (Build.VERSION.SDK_INT >= 14) {
+            App.getInstance().registerComponentCallbacks(new MemoryStatusCallback());
+            LogUtils.d(TAG, "【registerMemoryStatusListener】内存状态监听已注册（仅记录日志，不清理缓存）");
+        } else {
+            LogUtils.w(TAG, "【registerMemoryStatusListener】API 版本低于14，不支持内存状态监听");
+        }
+    }
+
+    /**
+     * 记录当前缓存状态（用于内存紧张时的调试）
+     */
+    private void logCurrentCacheStatus() {
+        LogUtils.d(TAG, "【logCurrentCacheStatus】缓存数量 - " + getCacheCount() + "，总内存占用 - " + getTotalCacheSize() + " 字节");
+        LogUtils.d(TAG, "【logCurrentCacheStatus】缓存路径 - " + getCachedPaths().toString());
+    }
+
+    // ================================== 内部类：内存状态回调（仅记录日志）=================================
+    /**
+     * 内存状态回调（仅记录日志，不清理缓存，极致强制缓存策略）
+     */
+    private class MemoryStatusCallback implements android.content.ComponentCallbacks2 {
+        @Override
+        public void onTrimMemory(int level) {
+            // 极致强制缓存策略：内存紧张时仅记录日志，不清理任何缓存
+            LogUtils.w(TAG, "【onTrimMemory】内存紧张级别 - " + level + "，极致强制保持所有 Bitmap 缓存（无压缩）");
+            // 记录当前缓存状态
+            logCurrentCacheStatus();
+        }
+
+        @Override
+        public void onLowMemory() {
+            // 极致强制缓存策略：低内存时仅记录日志，不清理任何缓存
+            LogUtils.w(TAG, "【onLowMemory】系统低内存，极致强制保持所有 Bitmap 缓存（无压缩）");
+            // 记录当前缓存状态
+            logCurrentCacheStatus();
+        }
+
+        @Override
+        public void onConfigurationChanged(Configuration newConfig) {
+            // 配置变化时无需处理
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/DateUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/DateUtils.java
new file mode 100644
index 0000000..3ba9cac
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/DateUtils.java
@@ -0,0 +1,37 @@
+package cc.winboll.studio.powerbell.utils;
+
+import java.text.SimpleDateFormat;
+import java.util.Locale;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/24
+ * @Describe 日期时间工具类（Java 7 兼容 | API 30 适配）
+ * 功能：提供当前时间的格式化字符串获取功能
+ */
+public class DateUtils {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "DateUtils";
+    private static final String DATE_FORMAT_PATTERN = "yyyyMMdd_HHmmssSSS"; // 修正年份格式为小写yyyy，毫秒为SSS
+    private static final Locale DEFAULT_LOCALE = Locale.getDefault();
+
+    // ================================== 工具方法（静态方法，无状态设计）=================================
+    /**
+     * 获取当前时间的格式化字符串
+     * 格式：yyyyMMdd_HHmmssSSS（年-月-日_时-分-秒-毫秒）
+     * @return 格式化后的当前时间字符串
+     */
+    public static String getDateNowString() {
+        LogUtils.d(TAG, "【getDateNowString】调用开始");
+        // 初始化日期格式化工具（Java 7 兼容，使用小写yyyy避免周基年问题）
+        SimpleDateFormat sdf = new SimpleDateFormat(DATE_FORMAT_PATTERN, DEFAULT_LOCALE);
+        // 读取当前时间戳
+        long currentTime = System.currentTimeMillis();
+        // 格式化时间
+        String formattedTime = sdf.format(currentTime);
+        LogUtils.d(TAG, "【getDateNowString】调用成功 | 格式化时间=" + formattedTime);
+        return formattedTime;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/DrawableToFileUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/DrawableToFileUtils.java
new file mode 100644
index 0000000..aa9b695
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/DrawableToFileUtils.java
@@ -0,0 +1,125 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/08 21:11
+ * @Describe 把 R.drawable 中的图片保存为 File 对象的工具类
+ * 适配 PowerBell 项目：支持指定保存路径、自动创建目录、处理PNG图片压缩
+ */
+public class DrawableToFileUtils {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "DrawableToFileUtils";
+    private static final String IMAGE_FORMAT_PNG = ".png"; // 目标图片格式
+    private static final Bitmap.CompressFormat COMPRESS_FORMAT = Bitmap.CompressFormat.PNG; // 压缩格式
+    private static final int COMPRESS_QUALITY = 100; // PNG无损压缩质量
+    private static final long MIN_FILE_SIZE = 100; // 有效文件最小字节数
+
+    // ================================== 核心工具方法（基础版：指定文件路径）=================================
+    /**
+     * 核心方法：将 R.drawable 图片保存为 File 对象
+     * @param context 上下文（用于获取 Resources）
+     * @param drawableResId 图片资源ID（如 R.drawable.ic_test_png）
+     * @param filePath 保存的文件路径（可带/不带.png后缀）
+     * @return 保存成功返回 File 对象，失败返回 null
+     */
+    public static File saveDrawableToFile(Context context, int drawableResId, String filePath) {
+        LogUtils.d(TAG, "【saveDrawableToFile】调用开始 | 资源ID=" + drawableResId + " | 目标路径=" + filePath);
+        // 1. 校验核心参数（避免空指针/无效参数）
+        if (context == null) {
+            LogUtils.e(TAG, "【saveDrawableToFile】参数异常：context为空");
+            return null;
+        }
+        if (drawableResId == 0) {
+            LogUtils.e(TAG, "【saveDrawableToFile】参数异常：drawableResId为0");
+            return null;
+        }
+        if (filePath == null || filePath.isEmpty()) {
+            LogUtils.e(TAG, "【saveDrawableToFile】参数异常：filePath为空");
+            return null;
+        }
+
+        // 2. 格式化文件路径（强制添加.png后缀）
+        String targetFilePath = filePath.endsWith(IMAGE_FORMAT_PNG) ? filePath : filePath + IMAGE_FORMAT_PNG;
+        if (!filePath.equals(targetFilePath)) {
+            LogUtils.d(TAG, "【saveDrawableToFile】格式适配：自动添加.png后缀 | 最终路径=" + targetFilePath);
+        }
+
+        // 3. 构建目标File对象并创建父目录
+        File targetFile = new File(targetFilePath);
+        File parentDir = targetFile.getParentFile();
+        if (parentDir != null && !parentDir.exists()) {
+            boolean isDirCreated = parentDir.mkdirs();
+            if (!isDirCreated) {
+                LogUtils.e(TAG, "【saveDrawableToFile】目录创建失败：" + parentDir.getAbsolutePath());
+                return null;
+            }
+            LogUtils.d(TAG, "【saveDrawableToFile】目录创建成功：" + parentDir.getAbsolutePath());
+        }
+        LogUtils.d(TAG, "【saveDrawableToFile】目标文件路径：" + targetFile.getAbsolutePath());
+
+        // 4. 读取drawable资源为Bitmap
+        Bitmap bitmap = null;
+        try {
+            bitmap = BitmapFactory.decodeResource(context.getResources(), drawableResId);
+            if (bitmap == null) {
+                LogUtils.e(TAG, "【saveDrawableToFile】读取失败：无法解析drawable资源（资源ID=" + drawableResId + "）");
+                return null;
+            }
+            LogUtils.d(TAG, "【saveDrawableToFile】读取成功：Bitmap尺寸=" + bitmap.getWidth() + "x" + bitmap.getHeight());
+
+            // 5. 将Bitmap写入File（PNG无损保存）
+            FileOutputStream fos = new FileOutputStream(targetFile);
+            boolean isSaved = bitmap.compress(COMPRESS_FORMAT, COMPRESS_QUALITY, fos);
+            fos.flush();
+            fos.close();
+
+            // 6. 校验保存结果
+            if (isSaved && targetFile.exists() && targetFile.length() > MIN_FILE_SIZE) {
+                LogUtils.d(TAG, "【saveDrawableToFile】保存成功：" + targetFile.getAbsolutePath());
+                return targetFile;
+            } else {
+                LogUtils.e(TAG, "【saveDrawableToFile】保存失败：文件无效（存在=" + targetFile.exists() + " | 大小=" + targetFile.length() + "字节）");
+                // 清理无效文件
+                if (targetFile.exists()) {
+                    targetFile.delete();
+                    LogUtils.d(TAG, "【saveDrawableToFile】清理无效文件：" + targetFile.getAbsolutePath());
+                }
+                return null;
+            }
+        } catch (IOException e) {
+            LogUtils.e(TAG, "【saveDrawableToFile】保存异常：" + e.getMessage());
+            return null;
+        } finally {
+            // 回收Bitmap资源（避免内存溢出）
+            if (bitmap != null && !bitmap.isRecycled()) {
+                bitmap.recycle();
+                LogUtils.d(TAG, "【saveDrawableToFile】资源回收：Bitmap已回收");
+            }
+        }
+    }
+
+    // ================================== 重载工具方法（扩展版：指定目录+文件名）=================================
+    /**
+     * 重载方法：自定义保存路径（灵活适配不同场景）
+     * @param context 上下文
+     * @param drawableResId 图片资源ID
+     * @param saveDirPath 自定义保存目录路径（如 "/storage/emulated/0/PowerBell/custom/"）
+     * @param fileName 保存的文件名（可带/不带.png后缀）
+     * @return 保存成功返回File对象，失败返回null
+     */
+    public static File saveDrawableToFile(Context context, int drawableResId, String saveDirPath, String fileName) {
+        LogUtils.d(TAG, "【saveDrawableToFile】重载方法调用开始 | 资源ID=" + drawableResId + " | 目录=" + saveDirPath + " | 文件名=" + fileName);
+        // 构建完整文件路径
+        File targetFile = new File(saveDirPath, fileName);
+        return saveDrawableToFile(context, drawableResId, targetFile.getAbsolutePath());
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/FileUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/FileUtils.java
new file mode 100644
index 0000000..ea1b0c1
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/FileUtils.java
@@ -0,0 +1,366 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.drawable.BitmapDrawable;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.BufferedInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.nio.channels.FileChannel;
+import java.util.UUID;
+
+/**
+ * 文件操作工具类
+ * 功能：文件读写、复制、图片转换、文件名处理等常用文件操作
+ * 适配：Java 7 + Android API 30
+ * 注意：调用文件操作前需确保已获取存储权限（Android 6.0+ 需动态申请）
+ */
+public class FileUtils {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "FileUtils";
+    /** 读取文件默认缓冲区大小（10KB） */
+    private static final int BUFFER_SIZE = 10240;
+    /** 最大读取文件大小（1GB），防止OOM */
+    private static final long MAX_READ_FILE_SIZE = 1024 * 1024 * 1024;
+    /** 最大文件后缀长度（避免异常文件名） */
+    private static final int MAX_SUFFIX_LENGTH = 5;
+    /** 缓冲区大小（流复制专用） */
+    private static final int STREAM_BUFFER_SIZE = 1024;
+
+    // ================================== 文件读取相关（字符串 + 字节数组）=================================
+    /**
+     * 读取文件内容并转为字符串
+     * @param filePath 文件绝对路径（非空）
+     * @return 文件内容字符串
+     * @throws IOException 异常：文件不存在、文件过大、读取失败等
+     */
+    public static String readFileAsString(String filePath) throws IOException {
+        LogUtils.d(TAG, "【readFileAsString】调用开始 | 文件路径=" + filePath);
+        // 1. 校验文件合法性
+        File file = new File(filePath);
+        if (!file.exists()) {
+            LogUtils.e(TAG, "【readFileAsString】文件不存在：" + filePath);
+            throw new FileNotFoundException("文件不存在：" + filePath);
+        }
+        if (file.length() > MAX_READ_FILE_SIZE) {
+            LogUtils.e(TAG, "【readFileAsString】文件过大（超过1GB）：" + filePath);
+            throw new IOException("文件过大（超过1GB），禁止读取：" + filePath);
+        }
+
+        // 2. 读取文件内容（使用StringBuilder高效拼接）
+        StringBuilder sb = new StringBuilder((int) file.length());
+        FileInputStream fis = null;
+        try {
+            fis = new FileInputStream(file);
+            byte[] buffer = new byte[BUFFER_SIZE];
+            int readLen;
+            while ((readLen = fis.read(buffer)) > 0) {
+                sb.append(new String(buffer, 0, readLen));
+            }
+        } finally {
+            if (fis != null) {
+                fis.close();
+            }
+        }
+        LogUtils.d(TAG, "【readFileAsString】读取成功 | 文件大小=" + file.length() + "字节");
+        return sb.toString();
+    }
+
+    /**
+     * 读取文件内容并转为byte数组（适用于二进制文件：图片、音频等）
+     * @param filePath 文件绝对路径（非空）
+     * @return 文件内容byte数组
+     * @throws IOException 异常：文件不存在、读取失败等
+     */
+    public static byte[] readFileByBytes(String filePath) throws IOException {
+        LogUtils.d(TAG, "【readFileByBytes】调用开始 | 文件路径=" + filePath);
+        // 1. 校验文件合法性
+        File file = new File(filePath);
+        if (!file.exists()) {
+            LogUtils.e(TAG, "【readFileByBytes】文件不存在：" + filePath);
+            throw new FileNotFoundException("文件不存在：" + filePath);
+        }
+
+        // 2. 缓冲流读取（高效，减少IO次数）
+        ByteArrayOutputStream bos = null;
+        BufferedInputStream bis = null;
+        try {
+            bos = new ByteArrayOutputStream((int) file.length());
+            bis = new BufferedInputStream(new FileInputStream(file));
+            byte[] buffer = new byte[BUFFER_SIZE];
+            int readLen;
+            while ((readLen = bis.read(buffer)) != -1) {
+                bos.write(buffer, 0, readLen);
+            }
+            bos.flush();
+            LogUtils.d(TAG, "【readFileByBytes】读取成功 | 文件大小=" + file.length() + "字节");
+            return bos.toByteArray();
+        } finally {
+            if (bis != null) {
+                bis.close();
+            }
+            if (bos != null) {
+                bos.close();
+            }
+        }
+    }
+
+    // ================================== 文件复制相关（FileChannel + 简化版 + 流复制）=================================
+    /**
+     * 基于FileChannel复制文件（高效，适用于大文件复制）
+     * @param source 源文件（非空，必须存在）
+     * @param dest 目标文件（非空，父目录会自动创建）
+     * @throws IOException 异常：源文件不存在、复制失败等
+     */
+    public static void copyFileUsingFileChannels(File source, File dest) throws IOException {
+        LogUtils.d(TAG, "【copyFileUsingFileChannels】调用开始 | 源文件=" + source.getAbsolutePath() + " | 目标文件=" + dest.getAbsolutePath());
+        // 1. 校验源文件合法性
+        if (!source.exists() || !source.isFile()) {
+            LogUtils.e(TAG, "【copyFileUsingFileChannels】源文件无效：" + source.getAbsolutePath());
+            throw new FileNotFoundException("源文件不存在或不是文件：" + source.getAbsolutePath());
+        }
+
+        // 2. 创建目标文件父目录
+        if (!dest.getParentFile().exists()) {
+            dest.getParentFile().mkdirs();
+            LogUtils.d(TAG, "【copyFileUsingFileChannels】创建父目录：" + dest.getParentFile().getAbsolutePath());
+        }
+
+        // 3. 通道复制（手动关闭流，兼容Java 7）
+        FileChannel inputChannel = null;
+        FileChannel outputChannel = null;
+        try {
+            inputChannel = new FileInputStream(source).getChannel();
+            outputChannel = new FileOutputStream(dest).getChannel();
+            outputChannel.transferFrom(inputChannel, 0, inputChannel.size());
+            LogUtils.d(TAG, "【copyFileUsingFileChannels】复制成功");
+        } finally {
+            if (inputChannel != null) {
+                inputChannel.close();
+            }
+            if (outputChannel != null) {
+                outputChannel.close();
+            }
+        }
+    }
+
+    /**
+     * 简化版文件复制（基于传统IO，兼容全版本，适用于中小文件）
+     * @param oldFile 源文件（非空，必须存在）
+     * @param newFile 目标文件（非空，父目录会自动创建）
+     * @return 复制结果：true-成功，false-失败
+     */
+    public static boolean copyFile(File oldFile, File newFile) {
+        LogUtils.d(TAG, "【copyFile】调用开始 | 源文件=" + (oldFile != null ? oldFile.getAbsolutePath() : "null") + " | 目标文件=" + (newFile != null ? newFile.getAbsolutePath() : "null"));
+        // 1. 校验源文件合法性
+        if (oldFile == null || !oldFile.exists() || !oldFile.isFile()) {
+            LogUtils.e(TAG, "【copyFile】源文件无效");
+            return false;
+        }
+
+        // 2. 创建目标文件父目录
+        if (!newFile.getParentFile().exists()) {
+            newFile.getParentFile().mkdirs();
+            LogUtils.d(TAG, "【copyFile】创建父目录：" + newFile.getParentFile().getAbsolutePath());
+        }
+
+        // 3. 复制文件（覆盖已有目标文件）
+        if (newFile.exists()) {
+            newFile.delete();
+            LogUtils.d(TAG, "【copyFile】删除已有目标文件：" + newFile.getAbsolutePath());
+        }
+
+        try {
+            copyFileUsingFileChannels(oldFile, newFile);
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【copyFile】复制失败：" + e.getMessage(), e);
+            return false;
+        }
+    }
+
+    /**
+     * 复制输入流到文件（兼容Uri解析失败场景）
+     * @param inputStream 输入流（非空）
+     * @param file 目标文件（非空）
+     * @throws IOException 异常：流关闭失败、目录创建失败等
+     */
+    public static void copyStreamToFile(InputStream inputStream, File file) throws IOException {
+        LogUtils.d(TAG, "【copyStreamToFile】调用开始 | 目标文件=" + file.getAbsolutePath());
+        // 1. 校验参数合法性
+        if (inputStream == null || file == null) {
+            LogUtils.e(TAG, "【copyStreamToFile】参数为空：InputStream=" + (inputStream == null) + " | File=" + (file == null));
+            throw new IllegalArgumentException("InputStream或File不能为空");
+        }
+
+        // 2. 创建目标文件父目录
+        File parentDir = file.getParentFile();
+        if (!parentDir.exists() && !parentDir.mkdirs()) {
+            LogUtils.e(TAG, "【copyStreamToFile】无法创建父目录：" + parentDir.getAbsolutePath());
+            throw new IOException("无法创建父目录：" + parentDir.getAbsolutePath());
+        }
+
+        // 3. 流复制（手动关闭流，兼容Java 7）
+        OutputStream outputStream = null;
+        try {
+            outputStream = new FileOutputStream(file);
+            byte[] buffer = new byte[STREAM_BUFFER_SIZE];
+            int length;
+            while ((length = inputStream.read(buffer)) != -1) {
+                outputStream.write(buffer, 0, length);
+            }
+            outputStream.flush();
+            LogUtils.d(TAG, "【copyStreamToFile】复制成功");
+        } finally {
+            try {
+                inputStream.close();
+            } catch (IOException e) {
+                LogUtils.e(TAG, "【copyStreamToFile】关闭输入流失败：" + e.getMessage());
+            }
+            if (outputStream != null) {
+                outputStream.close();
+            }
+        }
+    }
+
+    // ================================== 图片文件相关（BitmapDrawable 获取）=================================
+    /**
+     * 从文件路径获取BitmapDrawable（适用于Android图片显示）
+     * @param path 图片文件绝对路径（非空）
+     * @return BitmapDrawable 图片对象（文件不存在/读取失败返回null）
+     * @throws IOException 异常：文件读取IO错误
+     */
+    public static BitmapDrawable getImageDrawable(String path) throws IOException {
+        LogUtils.d(TAG, "【getImageDrawable】调用开始 | 图片路径=" + path);
+        // 1. 校验文件合法性
+        File file = new File(path);
+        if (!file.exists() || !file.isFile()) {
+            LogUtils.e(TAG, "【getImageDrawable】图片文件无效：" + path);
+            return null;
+        }
+
+        // 2. 读取文件并转为BitmapDrawable（缓冲流读取，减少内存占用）
+        InputStream is = null;
+        ByteArrayOutputStream bos = null;
+        try {
+            is = new FileInputStream(file);
+            bos = new ByteArrayOutputStream();
+            byte[] buffer = new byte[BUFFER_SIZE];
+            int readLen;
+            while ((readLen = is.read(buffer)) != -1) {
+                bos.write(buffer, 0, readLen);
+            }
+            byte[] imageBytes = bos.toByteArray();
+            Bitmap bitmap = BitmapFactory.decodeByteArray(imageBytes, 0, imageBytes.length);
+            LogUtils.d(TAG, "【getImageDrawable】转换成功 | 图片尺寸=" + bitmap.getWidth() + "x" + bitmap.getHeight());
+            return new BitmapDrawable(bitmap);
+        } finally {
+            if (is != null) {
+                is.close();
+            }
+            if (bos != null) {
+                bos.close();
+            }
+        }
+    }
+
+    // ================================== 文件名处理相关（后缀截取 + 唯一文件名）=================================
+    /**
+     * 截取文件后缀名（兼容多 "." 场景，如"image.2025.png" → ".png"）
+     * @param file 目标文件（可为null）
+     * @return 文件后缀名：带点（如".jpg"），无后缀/文件无效返回空字符串
+     */
+    public static String getFileSuffixWithMultiDot(File file) {
+        LogUtils.d(TAG, "【getFileSuffixWithMultiDot】调用开始 | 文件=" + (file != null ? file.getAbsolutePath() : "null"));
+        // 1. 校验文件合法性
+        if (file == null || !file.isFile()) {
+            LogUtils.d(TAG, "【getFileSuffixWithMultiDot】文件无效，返回空后缀");
+            return "";
+        }
+
+        // 2. 提取文件名并查找最后一个 "."
+        String fileName = file.getName();
+        int lastDotIndex = fileName.lastIndexOf(".");
+
+        // 3. 校验后缀合法性（排除无后缀、以点结尾、后缀过长的异常文件）
+        if (lastDotIndex == -1 || lastDotIndex == fileName.length() - 1 || (fileName.length() - lastDotIndex) > MAX_SUFFIX_LENGTH) {
+            LogUtils.d(TAG, "【getFileSuffixWithMultiDot】无有效后缀 | 文件名=" + fileName);
+            return "";
+        }
+
+        // 4. 返回小写后缀（统一格式，避免大小写不一致问题）
+        String suffix = fileName.substring(lastDotIndex).toLowerCase();
+        LogUtils.d(TAG, "【getFileSuffixWithMultiDot】获取成功 | 后缀=" + suffix);
+        return suffix;
+    }
+
+    /**
+     * 获取文件后缀（不带点，忽略大小写，适配空文件名/无后缀场景）
+     * @param file 目标文件
+     * @return 后缀字符串（无后缀返回空字符串，非空统一小写）
+     */
+    public static String getFileSuffix(File file) {
+        LogUtils.d(TAG, "【getFileSuffix】调用开始 | 文件=" + (file != null ? file.getAbsolutePath() : "null"));
+        if (file == null || file.getName().isEmpty()) {
+            LogUtils.d(TAG, "【getFileSuffix】文件无效，返回空后缀");
+            return "";
+        }
+        String fileName = file.getName();
+        int lastDotIndex = fileName.lastIndexOf(".");
+        // 无后缀（没有点，或点在开头/结尾）
+        if (lastDotIndex == -1 || lastDotIndex == 0 || lastDotIndex == fileName.length() - 1) {
+            LogUtils.d(TAG, "【getFileSuffix】无有效后缀 | 文件名=" + fileName);
+            return "";
+        }
+        // 截取后缀并转小写（统一格式，避免 PNG/png 差异）
+        String suffix = fileName.substring(lastDotIndex + 1).toLowerCase();
+        LogUtils.d(TAG, "【getFileSuffix】获取成功 | 后缀=" + suffix);
+        return suffix;
+    }
+
+    /**
+     * 生成唯一文件名（优化版：唯一、合法、简洁）
+     * 生成规则：UUID(去掉"-") + "_" + 时间戳 + 原文件后缀
+     * @param refFile 参考文件（用于提取后缀名，可为null）
+     * @return 唯一文件名（如"a1b2c3d4e5f6_1730000000000.jpg"，无后缀则不带点）
+     */
+    public static String createUniqueFileName(File refFile) {
+        LogUtils.d(TAG, "【createUniqueFileName】调用开始 | 参考文件=" + (refFile != null ? refFile.getAbsolutePath() : "null"));
+        // 1. 获取参考文件的后缀名（自动容错null/无效文件）
+        String suffix = getFileSuffixWithMultiDot(refFile);
+        // 2. 生成唯一标识（UUID确保全局唯一，时间戳进一步降低重复概率）
+        String uniqueId = UUID.randomUUID().toString().replace("-", "");
+        long timeStamp = System.currentTimeMillis();
+        // 3. 拼接文件名（分场景处理，避免多余点）
+        String fileName;
+        if (suffix.isEmpty()) {
+            fileName = String.format("%s_%d", uniqueId, timeStamp);
+        } else {
+            fileName = String.format("%s_%d%s", uniqueId, timeStamp, suffix);
+        }
+        LogUtils.d(TAG, "【createUniqueFileName】生成成功 | 文件名=" + fileName);
+        return fileName;
+    }
+
+    // ================================== 工具辅助方法（文件存在性判断）=================================
+    /**
+     * 判断文件是否存在
+     * @param path 文件绝对路径
+     * @return true-存在，false-不存在
+     */
+    public static boolean isFileExists(String path) {
+        LogUtils.d(TAG, "【isFileExists】调用开始 | 文件路径=" + path);
+        File file = new File(path);
+        boolean exists = file.exists();
+        LogUtils.d(TAG, "【isFileExists】判断结果 | 路径=" + path + " | 存在=" + exists);
+        return exists;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageCropUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageCropUtils.java
new file mode 100644
index 0000000..5d101a8
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageCropUtils.java
@@ -0,0 +1,387 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.graphics.Bitmap;
+import android.net.Uri;
+import android.os.Build;
+import android.widget.Toast;
+import androidx.core.content.FileProvider;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import com.yalantis.ucrop.UCrop;
+import java.io.File;
+import java.util.regex.Pattern;
+
+/**
+ * 图片裁剪工具类（集成 uCrop 2.2.8 终极兼容版，强制输出 PNG 格式，全程保留透明通道，支持 Uri/File/BackgroundBean 多传参）
+ * 适配：Java 7 + Android API 30
+ * 核心策略：强制 PNG 输出，保留透明通道，统一裁剪配置
+ */
+public class ImageCropUtils {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "ImageCropUtils";
+    // FileProvider 授权（与 AndroidManifest 配置一致）
+    private static final String FILE_PROVIDER_SUFFIX = ".fileprovider";
+    // 强制输出格式：固定为 PNG（保留透明通道）
+    private static final String FORCE_OUTPUT_SUFFIX = "png";
+    private static final Bitmap.CompressFormat FORCE_COMPRESS_FORMAT = Bitmap.CompressFormat.PNG;
+    // 图片后缀正则（用于强制替换）
+    private static final Pattern IMAGE_SUFFIX_PATTERN = Pattern.compile("\\.(jpg|jpeg|png|bmp|gif)$", Pattern.CASE_INSENSITIVE);
+
+    // ================================== 核心裁剪方法（重载：Uri/File/BackgroundBean）=================================
+    /**
+     * 【Uri 传参版】启动 uCrop 裁剪 - 强制输出 PNG，保留透明通道
+     * @param activity 上下文
+     * @param inputUri 输入图片 Uri（本应用 FileProvider Uri，非空）
+     * @param outputUri 输出图片 Uri（本应用 FileProvider Uri，非空）
+     * @param aspectX 固定比例 X（自由裁剪传 0）
+     * @param aspectY 固定比例 Y（自由裁剪传 0）
+     * @param isFreeCrop 是否自由裁剪
+     * @param requestCode 裁剪请求码
+     */
+    public static void startImageCrop(Activity activity,
+                                      Uri inputUri,
+                                      Uri outputUri,
+                                      int aspectX,
+                                      int aspectY,
+                                      boolean isFreeCrop,
+                                      int requestCode) {
+        LogUtils.d(TAG, "【startImageCrop】调用开始（Uri 版）| 请求码=" + requestCode);
+        // 1. 输入参数校验
+        if (activity == null || activity.isFinishing()) {
+            LogUtils.e(TAG, "【startImageCrop】参数异常：Activity 无效或已销毁");
+            return;
+        }
+        if (inputUri == null || outputUri == null) {
+            LogUtils.e(TAG, "【startImageCrop】参数异常：输入/输出 Uri 为空");
+            showToast(activity, "图片 Uri 无效，无法裁剪");
+            return;
+        }
+        if (!isValidUri(activity, inputUri)) {
+            LogUtils.e(TAG, "【startImageCrop】参数异常：输入 Uri 无效 " + inputUri);
+            showToast(activity, "原图 Uri 无效，无法裁剪");
+            return;
+        }
+
+        // 2. 核心：强制修正输出为 PNG（忽略原图格式，统一转 PNG）
+        File outputFile = uriToFile(activity, outputUri);
+        if (outputFile == null) {
+            LogUtils.e(TAG, "【startImageCrop】转换异常：输出 Uri 转 File 失败 " + outputUri);
+            showToast(activity, "裁剪输出路径无效");
+            return;
+        }
+        outputFile = correctFileSuffix(outputFile, FORCE_OUTPUT_SUFFIX); // 强制 .png 后缀
+        outputUri = getFileProviderUri(activity, outputFile); // 重新生成 PNG 对应的 Uri
+        LogUtils.d(TAG, "【startImageCrop】格式修正：强制输出 PNG " + outputFile.getAbsolutePath());
+
+        // 3. 初始化 uCrop + 强制 PNG 配置（保留透明核心）
+        UCrop uCrop = UCrop.of(inputUri, outputUri);
+        //uCrop.withAspectRatio(aspectX, aspectY);
+        UCrop.Options options = initCropOptions(activity, isFreeCrop, aspectX, aspectY);
+
+        // 4. 启动裁剪
+        uCrop.withOptions(options);
+        uCrop.start(activity, requestCode);
+        LogUtils.d(TAG, "【startImageCrop】启动成功（Uri 版）| 输出路径=" + outputFile.getAbsolutePath());
+    }
+
+    /**
+     * 【File 传参版】启动 uCrop 裁剪 - 强制输出 PNG，保留透明通道
+     * @param activity 上下文
+     * @param inputFile 输入图片文件（任意格式）
+     * @param outputFile 输出图片文件（最终强制转为 PNG）
+     * @param aspectX 固定比例 X（自由裁剪传 0）
+     * @param aspectY 固定比例 Y（自由裁剪传 0）
+     * @param isFreeCrop 是否自由裁剪
+     * @param requestCode 裁剪请求码
+     */
+    public static void startImageCrop(Activity activity,
+                                      File inputFile,
+                                      File outputFile,
+                                      int aspectX,
+                                      int aspectY,
+                                      boolean isFreeCrop,
+                                      int requestCode) {
+        LogUtils.d(TAG, "【startImageCrop】调用开始（File 版）| 请求码=" + requestCode);
+        // 1. 输入参数校验
+        if (activity == null || activity.isFinishing()) {
+            LogUtils.e(TAG, "【startImageCrop】参数异常：Activity 无效或已销毁");
+            return;
+        }
+        if (inputFile == null || !inputFile.exists() || inputFile.length() <= 100) {
+            LogUtils.e(TAG, "【startImageCrop】参数异常：输入图片文件无效 " + (inputFile != null ? inputFile.getAbsolutePath() : "null"));
+            showToast(activity, "无有效图片可裁剪");
+            return;
+        }
+        if (outputFile == null) {
+            LogUtils.e(TAG, "【startImageCrop】参数异常：输出文件路径为空");
+            showToast(activity, "裁剪输出路径无效");
+            return;
+        }
+
+        // 2. 核心：强制修正输出为 PNG（忽略原图格式）
+        Uri inputUri = getFileProviderUri(activity, inputFile);
+        outputFile = correctFileSuffix(outputFile, FORCE_OUTPUT_SUFFIX); // 强制 .png 后缀
+        Uri outputUri = getFileProviderUri(activity, outputFile);
+        LogUtils.d(TAG, "【startImageCrop】格式修正：强制输出 PNG " + outputFile.getAbsolutePath());
+
+        // 3. 初始化 uCrop + 强制 PNG 配置
+        UCrop uCrop = UCrop.of(inputUri, outputUri);
+        //uCrop.withAspectRatio(aspectX, aspectY);
+        UCrop.Options options = initCropOptions(activity, isFreeCrop, aspectX, aspectY);
+
+        // 4. 启动裁剪
+        uCrop.withOptions(options);
+        uCrop.start(activity, requestCode);
+        LogUtils.d(TAG, "【startImageCrop】启动成功（File 版）| 输出路径=" + outputFile.getAbsolutePath());
+    }
+
+    /**
+     * 【BackgroundBean 传参版】启动 uCrop 裁剪 - 强制输出 PNG，保留透明通道
+     * @param activity 上下文
+     * @param cropBean 背景图片 Bean
+     * @param aspectX 固定比例 X
+     * @param aspectY 固定比例 Y
+     * @param isFreeCrop 是否自由裁剪
+     * @param requestCode 裁剪请求码
+     */
+    public static void startImageCrop(Activity activity,
+                                      BackgroundBean cropBean,
+                                      int aspectX,
+                                      int aspectY,
+                                      boolean isFreeCrop,
+                                      int requestCode) {
+        LogUtils.d(TAG, "【startImageCrop】调用开始（BackgroundBean 版）| 请求码=" + requestCode);
+        if (cropBean == null) {
+            LogUtils.e(TAG, "【startImageCrop】参数异常：BackgroundBean 为空");
+            showToast(activity, "裁剪参数无效");
+            return;
+        }
+        File inputFile = new File(cropBean.getBackgroundFilePath());
+        File outputFile = new File(cropBean.getBackgroundScaledCompressFilePath());
+        startImageCrop(activity, inputFile, outputFile, aspectX, aspectY, isFreeCrop, requestCode);
+        LogUtils.d(TAG, "【startImageCrop】启动成功（BackgroundBean 版）| 输入路径=" + inputFile.getAbsolutePath());
+    }
+
+    // ================================== 裁剪结果处理（优化日志，增强容错）=================================
+    /**
+     * 处理裁剪结果
+     * @param requestCode 当前请求码
+     * @param resultCode 结果码
+     * @param data 结果数据
+     * @param cropRequestCode 裁剪请求码
+     * @return 裁剪成功返回输出路径，失败返回 null
+     */
+    public static String handleCropResult(int requestCode, int resultCode, Intent data, int cropRequestCode) {
+        LogUtils.d(TAG, "【handleCropResult】调用开始 | 请求码=" + requestCode + " | 裁剪请求码=" + cropRequestCode);
+        if (requestCode != cropRequestCode) {
+            LogUtils.d(TAG, "【handleCropResult】请求码不匹配，忽略结果");
+            return null;
+        }
+
+        if (resultCode == Activity.RESULT_OK && data != null) {
+            Uri outputUri = UCrop.getOutput(data);
+            if (outputUri != null) {
+                String outputPath = uriToPath(outputUri);
+                LogUtils.d(TAG, "【handleCropResult】裁剪成功 | 输出路径=" + outputPath);
+                return outputPath;
+            } else {
+                LogUtils.e(TAG, "【handleCropResult】裁剪失败：输出 Uri 为空");
+            }
+        } else if (resultCode == UCrop.RESULT_ERROR) {
+            Throwable error = UCrop.getError(data);
+            LogUtils.e(TAG, "【handleCropResult】裁剪异常：" + (error != null ? error.getMessage() : "未知错误。"));
+        } else {
+            LogUtils.d(TAG, "【handleCropResult】裁剪取消：用户手动取消");
+        }
+        return null;
+    }
+
+    // ================================== 私有辅助方法（参数校验 + 格式转换 + 配置初始化）=================================
+    /**
+     * 校验 Uri 有效性（确保是图片类型）
+     */
+    private static boolean isValidUri(Activity activity, Uri uri) {
+        try {
+            String type = activity.getContentResolver().getType(uri);
+            boolean isValid = type != null && type.startsWith("image/");
+            LogUtils.d(TAG, "【isValidUri】Uri 校验结果 | " + uri + " | 有效=" + isValid);
+            return isValid;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【isValidUri】Uri 校验失败 " + uri, e);
+            return false;
+        }
+    }
+
+    /**
+     * Uri 转 File（适配 FileProvider Uri 和普通 Uri）
+     */
+    private static File uriToFile(Activity activity, Uri uri) {
+        if (uri == null) {
+            LogUtils.e(TAG, "【uriToFile】参数异常：Uri 为空");
+            return null;
+        }
+        try {
+            if (uri.getScheme().equals("file")) {
+                File file = new File(uri.getPath());
+                LogUtils.d(TAG, "【uriToFile】转换成功（普通 Uri）| " + uri + " → " + file.getAbsolutePath());
+                return file;
+            }
+            String filePath = uri.getPath();
+            if (filePath == null) {
+                LogUtils.e(TAG, "【uriToFile】转换失败：Uri 路径为空 " + uri);
+                return null;
+            }
+            // 适配 FileProvider 路径
+            if (filePath.contains("/external_files/")) {
+                filePath = filePath.replace("/external_files/", activity.getExternalFilesDir("").getAbsolutePath() + "/");
+            } else if (filePath.contains("/cache/")) {
+                filePath = filePath.replace("/cache/", activity.getCacheDir().getAbsolutePath() + "/");
+            }
+            File file = new File(filePath);
+            LogUtils.d(TAG, "【uriToFile】转换成功（FileProvider Uri）| " + uri + " → " + file.getAbsolutePath());
+            return file;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【uriToFile】转换失败 " + uri, e);
+            return null;
+        }
+    }
+
+    /**
+     * Uri 提取文件路径
+     */
+    private static String uriToPath(Uri uri) {
+        if (uri == null) {
+            LogUtils.e(TAG, "【uriToPath】参数异常：Uri 为空");
+            return null;
+        }
+        try {
+            if (uri.getScheme().equals("file")) {
+                String path = uri.getPath();
+                LogUtils.d(TAG, "【uriToPath】提取成功（普通 Uri）| " + uri + " → " + path);
+                return path;
+            }
+            String path = uri.getPath();
+            if (path == null) {
+                LogUtils.e(TAG, "【uriToPath】提取失败：Uri 路径为空 " + uri);
+                return null;
+            }
+            // 适配多种 FileProvider 前缀
+            String[] prefixes = {"/external/", "/external_files/", "/cache/", "/files/"};
+            for (String prefix : prefixes) {
+                if (path.contains(prefix)) {
+                    path = path.substring(path.indexOf(prefix) + prefix.length());
+                    String externalRoot = android.os.Environment.getExternalStorageDirectory().getAbsolutePath();
+                    path = externalRoot + "/" + path;
+                    LogUtils.d(TAG, "【uriToPath】提取成功（FileProvider Uri）| " + uri + " → " + path);
+                    return path;
+                }
+            }
+            LogUtils.d(TAG, "【uriToPath】提取成功（默认路径）| " + uri + " → " + path);
+            return path;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【uriToPath】提取失败 " + uri, e);
+            return null;
+        }
+    }
+
+    /**
+     * 统一初始化裁剪配置（强制 PNG 专属配置，保留透明核心）
+     */
+    private static UCrop.Options initCropOptions(Activity activity, boolean isFreeCrop, int aspectX, int aspectY) {
+        LogUtils.d(TAG, "【initCropOptions】初始化裁剪配置 | 自由裁剪=" + isFreeCrop);
+        UCrop.Options options = new UCrop.Options();
+
+        // 裁剪模式配置（自由裁剪/固定比例）
+        options.setFreeStyleCropEnabled(isFreeCrop);
+		options.withAspectRatio(aspectX, aspectY);
+		
+        // 核心：强制 PNG 保留透明（固定配置，无需判断原图格式）
+        options.setCompressionFormat(FORCE_COMPRESS_FORMAT); // 强制 PNG 压缩
+        options.setCompressionQuality(100); // PNG 100% 质量，不损失透明
+        options.setDimmedLayerColor(activity.getResources().getColor(android.R.color.transparent)); // 遮罩透明（关键）
+        options.setCropFrameColor(activity.getResources().getColor(R.color.colorPrimary)); // 裁剪框主题色
+        options.setCropGridColor(activity.getResources().getColor(R.color.colorAccent)); // 网格线主题色
+
+        // 通用 UI 配置（保持原有风格）
+		
+        //options.setHideBottomControls(true); // 隐藏底部控制栏
+        options.setToolbarTitle("图片裁剪");
+        options.setToolbarColor(activity.getResources().getColor(R.color.colorPrimary));
+        options.setToolbarWidgetColor(activity.getResources().getColor(android.R.color.white));
+        options.setStatusBarColor(activity.getResources().getColor(R.color.colorPrimaryDark));
+
+        LogUtils.d(TAG, "【initCropOptions】配置完成：强制 PNG 输出，保留透明通道");
+        return options;
+    }
+
+    /**
+     * 修正文件后缀（强制转为指定后缀，覆盖原有任何图片后缀）
+     */
+    private static File correctFileSuffix(File originFile, String targetSuffix) {
+        String originName = originFile.getName();
+        // 强制替换所有图片后缀为 targetSuffix
+        String newName = IMAGE_SUFFIX_PATTERN.matcher(originName).replaceAll("") + "." + targetSuffix;
+        File newFile = new File(originFile.getParent(), newName);
+        LogUtils.d(TAG, "【correctFileSuffix】后缀修正 | " + originFile.getName() + " → " + newFile.getName());
+        return newFile;
+    }
+
+    /**
+     * 生成 FileProvider Uri（适配 Android 7.0+）
+     */
+    private static Uri getFileProviderUri(Activity activity, File file) {
+        try {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                String authority = activity.getPackageName() + FILE_PROVIDER_SUFFIX;
+                Uri uri = FileProvider.getUriForFile(activity, authority, file);
+                LogUtils.d(TAG, "【getFileProviderUri】生成成功（Android 7.0+）| " + file.getAbsolutePath() + " → " + uri);
+                return uri;
+            } else {
+                Uri uri = Uri.fromFile(file);
+                LogUtils.d(TAG, "【getFileProviderUri】生成成功（Android 7.0-）| " + file.getAbsolutePath() + " → " + uri);
+                return uri;
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【getFileProviderUri】生成失败 " + file.getAbsolutePath(), e);
+            return null;
+        }
+    }
+
+    /**
+     * 显示 Toast（避免崩溃）
+     */
+    private static void showToast(Activity activity, String msg) {
+        if (activity != null && !activity.isFinishing()) {
+            Toast.makeText(activity, msg, Toast.LENGTH_SHORT).show();
+            LogUtils.d(TAG, "【showToast】显示提示：" + msg);
+        } else {
+            LogUtils.e(TAG, "【showToast】无法显示提示：Activity 无效");
+        }
+    }
+
+    // ================================== 公有辅助方法（供外部调用）=================================
+    /**
+     * 公有方法：生成 FileProvider Uri
+     */
+    public static Uri getFileProviderUriPublic(Activity activity, File file) {
+        return getFileProviderUri(activity, file);
+    }
+
+    /**
+     * 公有方法：Uri 转 File
+     */
+    public static File getFileFromUriPublic(Activity activity, Uri uri) {
+        return uriToFile(activity, uri);
+    }
+
+    /**
+     * 公有方法：Uri 提取路径
+     */
+    public static String getPathFromUriPublic(Uri uri) {
+        return uriToPath(uri);
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageDownloader.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageDownloader.java
new file mode 100644
index 0000000..82d27a0
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageDownloader.java
@@ -0,0 +1,349 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.text.TextUtils;
+import cc.winboll.studio.libappbase.LogUtils;
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.util.UUID;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * 图片下载工具类（单例模式）
+ * 功能：下载网络图片到缓存目录、清理过期文件、获取最新下载文件
+ * 适配：Java 7 + Android API 30
+ * 核心策略：OkHttp 全局复用、7天文件过期清理、UUID 唯一文件名、内置缓存目录（无需权限）
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/19 20:52
+ */
+public class ImageDownloader {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "ImageDownloader";
+    // 缓存目录子文件夹名称
+    private static final String CACHE_DIR_NAME = "networkdownload";
+    // 过期时间：7天（单位：毫秒）
+    private static final long EXPIRE_TIME = 7 * 24 * 3600 * 1000;
+    // OkHttp 超时配置
+    private static final int CONNECT_TIMEOUT = 10;
+    private static final int READ_WRITE_TIMEOUT = 15;
+    // 文件后缀最大长度
+    private static final int MAX_EXTENSION_LENGTH = 5;
+    // 默认文件后缀
+    private static final String DEFAULT_EXTENSION = ".jpg";
+    // 缓冲区大小
+    private static final int BUFFER_SIZE = 1024;
+
+    // ================================== 成员变量（单例核心 + 全局资源）=================================
+    // 单例实例
+    private static ImageDownloader sInstance;
+    // OkHttp 客户端（全局复用，提升性能）
+    private OkHttpClient mOkHttpClient;
+    // 缓存目录：/data/data/应用包名/cache/networkdownload
+    private File mCacheDir;
+
+    // ================================== 单例方法（线程安全 + 应用上下文）=================================
+    /**
+     * 单例获取方法（线程安全）
+     * @param context 上下文（建议使用 Application 上下文避免内存泄漏）
+     * @return 单例实例
+     */
+    public static synchronized ImageDownloader getInstance(Context context) {
+        LogUtils.d(TAG, "【getInstance】单例获取方法调用");
+        if (sInstance == null) {
+            // 使用 Application 上下文，防止 Activity 销毁导致的内存泄漏
+            sInstance = new ImageDownloader(context.getApplicationContext());
+            LogUtils.d(TAG, "【getInstance】单例实例首次创建");
+        }
+        return sInstance;
+    }
+
+    // ================================== 构造方法（私有 + 初始化逻辑）=================================
+    /**
+     * 私有构造（单例模式禁止外部实例化）
+     * @param context 应用上下文
+     */
+    private ImageDownloader(Context context) {
+        LogUtils.d(TAG, "【ImageDownloader】构造方法调用，开始初始化");
+        // 初始化 OkHttp 客户端（设置超时时间）
+        initOkHttpClient();
+        // 初始化缓存目录：networkdownload
+        initCacheDir(context);
+        // 初始化时清理过期文件
+        clearExpiredFiles();
+        LogUtils.d(TAG, "【ImageDownloader】初始化完成");
+    }
+
+    // ================================== 核心初始化方法（OkHttp + 缓存目录）=================================
+    /**
+     * 初始化 OkHttp 客户端（全局复用）
+     */
+    private void initOkHttpClient() {
+        LogUtils.d(TAG, "【initOkHttpClient】开始初始化 OkHttp 客户端");
+        mOkHttpClient = new OkHttpClient.Builder()
+			.connectTimeout(CONNECT_TIMEOUT, TimeUnit.SECONDS)
+			.readTimeout(READ_WRITE_TIMEOUT, TimeUnit.SECONDS)
+			.writeTimeout(READ_WRITE_TIMEOUT, TimeUnit.SECONDS)
+			.build();
+        LogUtils.d(TAG, "【initOkHttpClient】OkHttp 客户端初始化完成");
+    }
+
+    /**
+     * 初始化缓存目录：若不存在则创建
+     * @param context 应用上下文
+     */
+    private void initCacheDir(Context context) {
+        LogUtils.d(TAG, "【initCacheDir】开始初始化缓存目录");
+        // 获取应用内置缓存目录（无需权限）
+        File cacheRoot = context.getCacheDir();
+        mCacheDir = new File(cacheRoot, CACHE_DIR_NAME);
+
+        // 若目录不存在则创建（包括父目录）
+        if (!mCacheDir.exists()) {
+            boolean isCreated = mCacheDir.mkdirs();
+            if (isCreated) {
+                LogUtils.d(TAG, "【initCacheDir】缓存目录创建成功：" + mCacheDir.getAbsolutePath());
+            } else {
+                LogUtils.e(TAG, "【initCacheDir】缓存目录创建失败");
+            }
+        } else {
+            LogUtils.d(TAG, "【initCacheDir】缓存目录已存在：" + mCacheDir.getAbsolutePath());
+        }
+    }
+
+    // ================================== 核心业务方法（下载 + 清理 + 获取最新文件）=================================
+    /**
+     * 下载网络图片到缓存目录
+     * @param imageUrl 图片网络链接
+     * @param callback 下载结果回调（成功/失败）
+     */
+    public void downloadImage(final String imageUrl, final DownloadCallback callback) {
+        LogUtils.d(TAG, "【downloadImage】下载方法调用 | 图片链接=" + imageUrl);
+        // 1. 校验参数
+        if (TextUtils.isEmpty(imageUrl)) {
+            String errorMsg = "图片链接为空";
+            LogUtils.e(TAG, "【downloadImage】参数校验失败：" + errorMsg);
+            if (callback != null) {
+                callback.onFailure(errorMsg);
+            }
+            return;
+        }
+
+        if (mCacheDir == null || !mCacheDir.exists()) {
+            String errorMsg = "缓存目录不存在";
+            LogUtils.e(TAG, "【downloadImage】参数校验失败：" + errorMsg);
+            if (callback != null) {
+                callback.onFailure(errorMsg);
+            }
+            return;
+        }
+
+        // 2. 构建 OkHttp 请求
+        Request request = new Request.Builder()
+			.url(imageUrl)
+			.build();
+
+        // 3. 异步下载（避免阻塞主线程）
+        mOkHttpClient.newCall(request).enqueue(new Callback() {
+				@Override
+				public void onFailure(Call call, IOException e) {
+					String errorMsg = "下载失败：" + e.getMessage();
+					LogUtils.e(TAG, "【downloadImage】OkHttp 下载失败", e);
+					if (callback != null) {
+						callback.onFailure(errorMsg);
+					}
+				}
+
+				@Override
+				public void onResponse(Call call, Response response) throws IOException {
+					// 3.1 响应状态校验
+					if (!response.isSuccessful()) {
+						String errorMsg = "响应失败：" + response.code();
+						LogUtils.e(TAG, "【downloadImage】响应失败，状态码：" + response.code());
+						if (callback != null) {
+							callback.onFailure(errorMsg);
+						}
+						// 关闭响应体
+						if (response.body() != null) {
+							response.body().close();
+						}
+						return;
+					}
+
+					// 3.2 响应成功，写入文件
+					InputStream inputStream = null;
+					FileOutputStream outputStream = null;
+					try {
+						inputStream = response.body().byteStream();
+						// 生成 UUID 唯一文件名（保留原文件后缀）
+						String fileExtension = getFileExtension(imageUrl);
+						String fileName = UUID.randomUUID().toString() + fileExtension;
+						File imageFile = new File(mCacheDir, fileName);
+
+						// 写入文件
+						outputStream = new FileOutputStream(imageFile);
+						byte[] buffer = new byte[BUFFER_SIZE];
+						int len;
+						while ((len = inputStream.read(buffer)) != -1) {
+							outputStream.write(buffer, 0, len);
+						}
+						outputStream.flush();
+
+						// 下载成功，回调主线程并返回文件路径
+						String filePath = imageFile.getAbsolutePath();
+						LogUtils.d(TAG, "【downloadImage】图片下载成功：" + filePath);
+						if (callback != null) {
+							callback.onSuccess(filePath);
+						}
+
+					} catch (IOException e) {
+						String errorMsg = "文件写入失败：" + e.getMessage();
+						LogUtils.e(TAG, "【downloadImage】文件写入失败", e);
+						if (callback != null) {
+							callback.onFailure(errorMsg);
+						}
+					} finally {
+						// 关闭流（Java7 手动关闭，避免资源泄漏）
+						if (inputStream != null) {
+							try {
+								inputStream.close();
+							} catch (IOException e) {
+								LogUtils.e(TAG, "【downloadImage】输入流关闭失败", e);
+							}
+						}
+						if (outputStream != null) {
+							try {
+								outputStream.close();
+							} catch (IOException e) {
+								LogUtils.e(TAG, "【downloadImage】输出流关闭失败", e);
+							}
+						}
+						// 关闭响应体
+						if (response.body() != null) {
+							response.body().close();
+						}
+					}
+				}
+			});
+    }
+
+    /**
+     * 清理过期文件（最后修改时间超过 EXPIRE_TIME 的文件）
+     */
+    private void clearExpiredFiles() {
+        LogUtils.d(TAG, "【clearExpiredFiles】开始清理过期文件");
+        if (mCacheDir == null || !mCacheDir.exists()) {
+            LogUtils.d(TAG, "【clearExpiredFiles】缓存目录不存在，无需清理");
+            return;
+        }
+
+        File[] files = mCacheDir.listFiles();
+        if (files == null || files.length == 0) {
+            LogUtils.d(TAG, "【clearExpiredFiles】缓存目录无文件，无需清理");
+            return;
+        }
+
+        long currentTime = System.currentTimeMillis();
+        int deleteCount = 0;
+
+        // 遍历所有文件，删除过期文件
+        for (File file : files) {
+            long lastModifyTime = file.lastModified();
+            if (currentTime - lastModifyTime > EXPIRE_TIME) {
+                if (file.delete()) {
+                    deleteCount++;
+                    LogUtils.d(TAG, "【clearExpiredFiles】删除过期文件：" + file.getName());
+                } else {
+                    LogUtils.e(TAG, "【clearExpiredFiles】删除过期文件失败：" + file.getName());
+                }
+            }
+        }
+
+        LogUtils.d(TAG, "【clearExpiredFiles】过期文件清理完成，共删除 " + deleteCount + " 个文件");
+    }
+
+    /**
+     * 获取 networkdownload 目录中最后下载的文件（按修改时间排序）
+     * @return 最后下载的文件路径（null 表示无文件）
+     */
+    public String getLastDownloadedFile() {
+        LogUtils.d(TAG, "【getLastDownloadedFile】获取最新下载文件");
+        if (mCacheDir == null || !mCacheDir.exists()) {
+            LogUtils.e(TAG, "【getLastDownloadedFile】缓存目录不存在");
+            return null;
+        }
+
+        File[] files = mCacheDir.listFiles();
+        if (files == null || files.length == 0) {
+            LogUtils.d(TAG, "【getLastDownloadedFile】缓存目录无文件");
+            return null;
+        }
+
+        // 按最后修改时间降序排序，取第一个即为最新文件
+        File lastFile = files[0];
+        for (File file : files) {
+            if (file.lastModified() > lastFile.lastModified()) {
+                lastFile = file;
+            }
+        }
+
+        String filePath = lastFile.getAbsolutePath();
+        LogUtils.d(TAG, "【getLastDownloadedFile】最后下载的文件：" + filePath);
+        return filePath;
+    }
+
+    // ================================== 辅助工具方法（文件后缀提取）=================================
+    /**
+     * 工具方法：从图片链接中提取文件后缀（如 .png、.jpg）
+     * @param imageUrl 图片链接
+     * @return 文件后缀（含点号，若无法提取则返回 .jpg）
+     */
+    private String getFileExtension(String imageUrl) {
+        LogUtils.d(TAG, "【getFileExtension】提取文件后缀 | 图片链接=" + imageUrl);
+        if (TextUtils.isEmpty(imageUrl)) {
+            LogUtils.d(TAG, "【getFileExtension】图片链接为空，返回默认后缀：" + DEFAULT_EXTENSION);
+            return DEFAULT_EXTENSION;
+        }
+
+        int lastDotIndex = imageUrl.lastIndexOf(".");
+        int lastSlashIndex = imageUrl.lastIndexOf("/");
+        // 确保后缀在最后一个斜杠之后，且长度合理（1-5 个字符）
+        if (lastDotIndex > lastSlashIndex && lastDotIndex < imageUrl.length() - 1) {
+            String extension = imageUrl.substring(lastDotIndex);
+            if (extension.length() <= MAX_EXTENSION_LENGTH) {
+                extension = extension.toLowerCase(); // 统一转为小写
+                LogUtils.d(TAG, "【getFileExtension】提取后缀成功：" + extension);
+                return extension;
+            }
+        }
+
+        // 无法提取后缀时，默认使用 .jpg
+        LogUtils.d(TAG, "【getFileExtension】无法提取有效后缀，返回默认后缀：" + DEFAULT_EXTENSION);
+        return DEFAULT_EXTENSION;
+    }
+
+    // ================================== 下载结果回调接口（Java7 接口实现）=================================
+    /**
+     * 下载结果回调接口
+     */
+    public interface DownloadCallback {
+        /**
+         * 下载成功
+         * @param filePath 图片保存路径
+         */
+        void onSuccess(String filePath);
+
+        /**
+         * 下载失败
+         * @param errorMsg 失败原因
+         */
+        void onFailure(String errorMsg);
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageUtils.java
new file mode 100644
index 0000000..b3f9e40
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ImageUtils.java
@@ -0,0 +1,250 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Matrix;
+import android.graphics.Paint;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.OutputStream;
+
+/**
+ * 图片处理工具类（质量压缩专用）
+ * 功能：1. 图片JPEG质量压缩（覆盖源文件）；2. 获取主题colorAccent颜色；3. 位图纯色背景合成
+ * 适配：Java 7 + Android API 30
+ * 核心逻辑：
+ * - 压缩：Bitmap.compress + FileChannel 高效文件复制
+ * - 主题颜色：TypedArray 解析主题属性
+ * - 位图合成：Canvas 绘制（支持透明通道）
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class ImageUtils {
+
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = "ImageUtils";
+    private static final Bitmap.CompressFormat COMPRESS_FORMAT = Bitmap.CompressFormat.JPEG;
+    private static final int MIN_COMPRESS_QUALITY = 0;
+    private static final int MAX_COMPRESS_QUALITY = 100;
+    private static final int[] COLOR_ACCENT_ATTR = new int[]{R.attr.colorAccent}; // colorAccent属性数组
+    private static final int DEFAULT_COLOR = Color.parseColor("#FFFFFFFF"); // 默认返回颜色
+
+    // ================================== 主题颜色获取方法 =================================
+    /**
+     * 从当前应用主题中获取 colorAccent 颜色值
+     * @param context 上下文，用于获取主题与资源
+     * @return 解析到的 colorAccent 颜色值，解析失败返回默认白色#FFFFFFFF
+     */
+    public static int getColorAccent(Context context) {
+        // 方法调用日志
+        LogUtils.d(TAG, "【getColorAccent】方法调用");
+        // 参数校验
+        if (context == null) {
+            LogUtils.e(TAG, "【getColorAccent】参数异常：Context为空");
+            return DEFAULT_COLOR;
+        }
+
+        TypedArray typedArray = null;
+        try {
+            // 从主题解析属性
+            typedArray = context.obtainStyledAttributes(COLOR_ACCENT_ATTR);
+            int colorAccent = typedArray.getColor(0, DEFAULT_COLOR);
+            LogUtils.d(TAG, String.format("【getColorAccent】解析成功 | colorAccent=0x%08X", colorAccent));
+            return colorAccent;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【getColorAccent】解析失败，返回默认颜色", e);
+            return DEFAULT_COLOR;
+        } finally {
+            // 回收资源
+            if (typedArray != null) {
+                typedArray.recycle();
+                LogUtils.d(TAG, "【getColorAccent】TypedArray资源已回收");
+            }
+        }
+    }
+
+    // ================================== 位图合成方法 =================================
+    /**
+     * 在纯色背景上绘制前景位图，实现FIT_CENTER居中效果
+     * @param bgColor 背景颜色
+     * @param originalFrameW 目标画布宽度
+     * @param originalFrameH 目标画布高度
+     * @param fgBitmap 前景位图
+     * @return 合成后的位图，失败返回null
+     */
+    public static Bitmap drawBitmapOnSolidBackground(final int bgColor, int originalFrameW, int originalFrameH, Bitmap fgBitmap) {
+        // 方法调用及入参日志
+        LogUtils.d(TAG, String.format("【drawBitmapOnSolidBackground】方法调用 | 背景色=0x%08X | 目标尺寸=%dx%d | 前景位图=%s",
+									  bgColor, originalFrameW, originalFrameH,
+									  (fgBitmap != null ? fgBitmap.getWidth() + "x" + fgBitmap.getHeight() : "null")));
+
+        // 1. 严格参数校验
+        if (fgBitmap == null || fgBitmap.isRecycled()) {
+            LogUtils.e(TAG, "【drawBitmapOnSolidBackground】参数异常：前景Bitmap为空或已回收");
+            return null;
+        }
+        if (fgBitmap.getWidth() <= 0 || fgBitmap.getHeight() <= 0) {
+            LogUtils.e(TAG, "【drawBitmapOnSolidBackground】参数异常：前景Bitmap尺寸无效");
+            return null;
+        }
+        if (originalFrameW <= 0 || originalFrameH <= 0) {
+            LogUtils.e(TAG, "【drawBitmapOnSolidBackground】参数异常：原画框尺寸无效（宽高必须大于0）");
+            return null;
+        }
+
+        // 2. 强制画布尺寸为目标尺寸
+        int canvasW = originalFrameW;
+        int canvasH = originalFrameH;
+        LogUtils.d(TAG, String.format("【drawBitmapOnSolidBackground】画布尺寸已确定：%dx%d", canvasW, canvasH));
+
+        // 3. 创建结果位图（ARGB_8888支持透明通道）
+        Bitmap resultBitmap = Bitmap.createBitmap(canvasW, canvasH, Bitmap.Config.ARGB_8888);
+        if (resultBitmap == null) {
+            LogUtils.e(TAG, "【drawBitmapOnSolidBackground】创建结果Bitmap失败");
+            return null;
+        }
+
+        // 4. 画布绘制
+        Canvas canvas = new Canvas(resultBitmap);
+        try {
+            // 4.1 绘制纯色背景
+            Paint bgPaint = new Paint();
+            bgPaint.setColor(bgColor);
+            bgPaint.setStyle(Paint.Style.FILL);
+            canvas.drawRect(0, 0, canvasW, canvasH, bgPaint);
+
+            // 4.2 计算前景 FIT_CENTER 变换参数（等比缩放至完全放入画布，居中显示）
+            float fgWidth = fgBitmap.getWidth();
+            float fgHeight = fgBitmap.getHeight();
+            float scaleX = (float) canvasW / fgWidth;
+            float scaleY = (float) canvasH / fgHeight;
+            float scale = Math.min(scaleX, scaleY); // 取最小比例，保证完全放入画布
+
+            // 4.3 计算缩放后前景尺寸
+            float scaledW = fgWidth * scale;
+            float scaledH = fgHeight * scale;
+
+            // 4.4 计算居中位置（缩放后居中，无裁剪）
+            float translateX = (canvasW - scaledW) / 2f;
+            float translateY = (canvasH - scaledH) / 2f;
+
+            // 4.5 构建变换矩阵（缩放+平移，实现 FIT_CENTER 效果）
+            Matrix matrix = new Matrix();
+            matrix.postScale(scale, scale); // 等比缩放
+            matrix.postTranslate(translateX, translateY); // 居中平移
+
+            // 4.6 绘制前景（保留透明通道，抗锯齿）
+            Paint fgPaint = new Paint();
+            fgPaint.setAntiAlias(true);
+            fgPaint.setDither(true);
+            canvas.drawBitmap(fgBitmap, matrix, fgPaint);
+
+            LogUtils.d(TAG, String.format("【drawBitmapOnSolidBackground】合成成功 | 缩放比例=%.2f | 居中位置=(%.1f,%.1f) | 效果=FIT_CENTER",
+										  scale, translateX, translateY));
+            return resultBitmap;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "【drawBitmapOnSolidBackground】合成失败", e);
+            if (resultBitmap != null && !resultBitmap.isRecycled()) {
+                resultBitmap.recycle();
+            }
+            return null;
+        }
+    }
+
+    // ================================== 核心压缩方法 =================================
+    /**
+     * 图片质量压缩（JPEG格式），压缩后覆盖源文件
+     * @param context 上下文（备用）
+     * @param srcImagePath 源图片文件路径（非空，文件需存在）
+     * @param dstImagePath 压缩后临时保存路径（非空）
+     * @param compressQuality 压缩质量（0-100，数值越小压缩率越高）
+     */
+    public static void bitmapCompress(Context context, String srcImagePath, String dstImagePath, int compressQuality) {
+        // 方法调用及入参日志
+        LogUtils.d(TAG, String.format("【bitmapCompress】方法调用 | 源路径=%s | 临时路径=%s | 压缩质量=%d",
+									  srcImagePath, dstImagePath, compressQuality));
+
+        // 1. 前置参数校验
+        if (srcImagePath == null || srcImagePath.isEmpty()) {
+            LogUtils.e(TAG, "【bitmapCompress】参数异常：源文件路径为空");
+            return;
+        }
+        if (dstImagePath == null || dstImagePath.isEmpty()) {
+            LogUtils.e(TAG, "【bitmapCompress】参数异常：临时文件路径为空");
+            return;
+        }
+        if (compressQuality < MIN_COMPRESS_QUALITY || compressQuality > MAX_COMPRESS_QUALITY) {
+            LogUtils.e(TAG, String.format("【bitmapCompress】参数异常：压缩质量超出范围（0-100），当前值=%d", compressQuality));
+            return;
+        }
+
+        File srcFile = new File(srcImagePath);
+        if (!srcFile.exists() || !srcFile.isFile()) {
+            LogUtils.e(TAG, "【bitmapCompress】源文件无效：不存在或不是文件 " + srcImagePath);
+            return;
+        }
+
+        Bitmap compressBitmap = null;
+        OutputStream outputStream = null;
+        try {
+            // 2. 读取源图片为Bitmap
+            compressBitmap = BitmapFactory.decodeFile(srcImagePath);
+            if (compressBitmap == null) {
+                LogUtils.e(TAG, "【bitmapCompress】Bitmap解码失败：无法读取源图片 " + srcImagePath);
+                return;
+            }
+            LogUtils.d(TAG, String.format("【bitmapCompress】Bitmap解码成功 | 尺寸=%dx%d",
+										  compressBitmap.getWidth(), compressBitmap.getHeight()));
+
+            // 3. 创建临时压缩文件目录
+            File dstFile = new File(dstImagePath);
+            File dstParentDir = dstFile.getParentFile();
+            if (dstParentDir != null && !dstParentDir.exists()) {
+                boolean isDirCreated = dstParentDir.mkdirs();
+                LogUtils.d(TAG, String.format("【bitmapCompress】临时目录创建%s：%s",
+											  isDirCreated ? "成功" : "失败", dstParentDir.getAbsolutePath()));
+            }
+
+            // 4. 写入压缩数据
+            outputStream = new FileOutputStream(dstFile);
+            boolean isCompressSuccess = compressBitmap.compress(COMPRESS_FORMAT, compressQuality, outputStream);
+            if (!isCompressSuccess) {
+                LogUtils.e(TAG, "【bitmapCompress】压缩失败：Bitmap.compress 执行失败");
+                return;
+            }
+            LogUtils.d(TAG, "【bitmapCompress】压缩成功：临时文件已生成 " + dstFile.getAbsolutePath());
+
+            // 5. 复制压缩文件覆盖源文件
+            FileUtils.copyFileUsingFileChannels(dstFile, srcFile);
+            LogUtils.d(TAG, String.format("【bitmapCompress】%d%%压缩结束：已覆盖源文件 %s",
+										  compressQuality, srcImagePath));
+
+        } catch (FileNotFoundException e) {
+            LogUtils.e(TAG, "【bitmapCompress】文件未找到异常", e);
+        } catch (IOException e) {
+            LogUtils.e(TAG, "【bitmapCompress】IO异常", e);
+        } finally {
+            // 6. 关闭输出流
+            if (outputStream != null) {
+                try {
+                    outputStream.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "【bitmapCompress】输出流关闭失败", e);
+                }
+            }
+            // 7. 回收Bitmap
+            if (compressBitmap != null && !compressBitmap.isRecycled()) {
+                compressBitmap.recycle();
+                LogUtils.d(TAG, "【bitmapCompress】Bitmap资源已回收");
+            }
+        }
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/NotificationManagerUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/NotificationManagerUtils.java
new file mode 100644
index 0000000..5e9289a
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/NotificationManagerUtils.java
@@ -0,0 +1,529 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.media.RingtoneManager;
+import android.os.Build;
+import android.provider.Settings;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.NotificationMessage;
+
+/**
+ * 通知工具类：统一管理前台服务/电池提醒/应用配置信息通知
+ * 适配：API19-30 | Java7 | 小米手机
+ * 特性：前台服务无铃声、提醒通知系统默认铃声、配置通知系统默认铃声无振动、API分级适配、内存泄漏防护
+ */
+public class NotificationManagerUtils {
+    // ================================== 静态常量（置顶统一管理，杜绝魔法值）=================================
+    public static final String TAG = "NotificationManagerUtils";
+    // 通知渠道ID（API26+ 必需，区分通知类型）
+    public static final String CHANNEL_ID_FOREGROUND = "cc.winboll.studio.powerbell.channel.foreground";
+    public static final String CHANNEL_ID_REMIND = "cc.winboll.studio.powerbell.channel.remind";
+    public static final String CHANNEL_ID_CONFIG = "cc.winboll.studio.powerbell.channel.config"; // 新增：应用配置信息渠道
+    // 通知ID（唯一标识，避免重复）
+    public static final int NOTIFY_ID_FOREGROUND_SERVICE = 1001;
+    public static final int NOTIFY_ID_REMIND = 1002;
+    public static final int NOTIFY_ID_CONFIG = 1003; // 新增：应用配置信息通知ID
+    // 低版本兼容：默认通知图标（API<21 避免显示异常）
+    private static final int NOTIFICATION_DEFAULT_ICON = R.drawable.ic_launcher;
+    // 通知内容兜底常量
+    private static final String FOREGROUND_NOTIFY_TITLE_DEFAULT = "电池服务运行中";
+    private static final String FOREGROUND_NOTIFY_CONTENT_DEFAULT = "后台监测电池状态";
+    private static final String REMIND_NOTIFY_TITLE_DEFAULT = "电池状态提醒";
+    private static final String REMIND_NOTIFY_CONTENT_DEFAULT = "电池状态异常，请及时处理";
+    private static final String CONFIG_NOTIFY_TITLE_DEFAULT = "应用配置更新"; // 新增：配置通知默认标题
+    private static final String CONFIG_NOTIFY_CONTENT_DEFAULT = "配置信息已更新，生效中"; // 新增：配置通知默认内容
+    // PendingIntent请求码
+    private static final int PENDING_INTENT_REQUEST_CODE_FOREGROUND = 0;
+    private static final int PENDING_INTENT_REQUEST_CODE_REMIND = 1;
+    private static final int PENDING_INTENT_REQUEST_CODE_CONFIG = 2; // 新增：配置通知请求码
+	private static int snMessageNotificationID = 10000;
+
+    // ================================== 成员变量（私有封装，按依赖优先级排序）=================================
+    // 核心上下文（应用级，避免内存泄漏）
+    private Context mContext;
+    // 系统通知服务（核心依赖）
+    private NotificationManager mNotificationManager;
+    // 前台服务通知实例（单独持有，便于更新/取消）
+    private Notification mForegroundServiceNotify;
+
+    // ================================== 构造方法（初始化核心资源，前置校验）=================================
+    public NotificationManagerUtils(Context context) {
+        LogUtils.d(TAG, "NotificationManagerUtils() 构造 | context=" + context);
+        // 前置校验：Context非空
+        if (context == null) {
+            LogUtils.e(TAG, "NotificationManagerUtils() 构造失败：context is null");
+            return;
+        }
+        // 初始化核心资源
+        this.mContext = context.getApplicationContext();
+        this.mNotificationManager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
+        LogUtils.d(TAG, "NotificationManagerUtils() 核心资源初始化完成 | mContext=" + mContext + " | mNotificationManager=" + mNotificationManager);
+        // 初始化通知渠道（API26+ 必需）
+        initNotificationChannels();
+        LogUtils.d(TAG, "NotificationManagerUtils() 构造完成");
+    }
+
+    // ================================== 核心初始化方法（通知渠道，API分级适配）=================================
+    /**
+     * 初始化通知渠道：前台服务渠道（无铃声+无振动）、提醒渠道（系统默认铃声+无振动）、配置信息渠道（系统默认铃声+无振动）
+     */
+    private void initNotificationChannels() {
+        LogUtils.d(TAG, "initNotificationChannels() 执行通知渠道初始化");
+        // API<26 无渠道机制，直接返回
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
+            LogUtils.d(TAG, "initNotificationChannels() API<26，无需创建渠道");
+            return;
+        }
+        // 通知服务为空，避免空指针
+        if (mNotificationManager == null) {
+            LogUtils.e(TAG, "initNotificationChannels() 失败：NotificationManager is null");
+            return;
+        }
+
+        // 1. 前台服务渠道（低优先级，后台保活无打扰）
+        NotificationChannel foregroundChannel = new NotificationChannel(
+			CHANNEL_ID_FOREGROUND,
+			"电池服务保活",
+			NotificationManager.IMPORTANCE_LOW
+        );
+        foregroundChannel.setDescription("电池监测服务后台运行，无声音、无振动");
+        foregroundChannel.enableLights(false);
+        foregroundChannel.enableVibration(false);
+        foregroundChannel.setSound(null, null); // 强制无铃声
+        foregroundChannel.setShowBadge(false);
+        foregroundChannel.setLockscreenVisibility(Notification.VISIBILITY_SECRET);
+        LogUtils.d(TAG, "initNotificationChannels() 前台服务渠道配置完成");
+
+        // 2. 电池提醒渠道（中优先级，系统默认铃声，无振动）
+        NotificationChannel remindChannel = new NotificationChannel(
+			CHANNEL_ID_REMIND,
+			"电池状态提醒",
+			NotificationManager.IMPORTANCE_DEFAULT
+        );
+        remindChannel.setDescription("电池满电/低电量提醒，系统默认铃声，无振动");
+        remindChannel.enableLights(true);
+        remindChannel.enableVibration(false);
+        remindChannel.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION), Notification.AUDIO_ATTRIBUTES_DEFAULT);
+        remindChannel.setShowBadge(false);
+        remindChannel.setLockscreenVisibility(Notification.VISIBILITY_PUBLIC);
+        LogUtils.d(TAG, "initNotificationChannels() 电池提醒渠道配置完成");
+
+        // 3. 应用配置信息渠道（方案1修复：默认优先级，系统默认铃声，无振动）
+        NotificationChannel configChannel = new NotificationChannel(
+			CHANNEL_ID_CONFIG,
+			"应用配置信息",
+			NotificationManager.IMPORTANCE_DEFAULT
+        );
+        configChannel.setDescription("应用配置更新、参数变更等提示，系统默认铃声、无振动");
+        configChannel.enableLights(true);
+        configChannel.enableVibration(false);
+        configChannel.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION), Notification.AUDIO_ATTRIBUTES_DEFAULT);
+        configChannel.setShowBadge(false);
+        configChannel.setLockscreenVisibility(Notification.VISIBILITY_PUBLIC);
+        LogUtils.d(TAG, "initNotificationChannels() 应用配置信息渠道配置完成");
+
+        // 注册渠道到系统
+        mNotificationManager.createNotificationChannel(foregroundChannel);
+        mNotificationManager.createNotificationChannel(remindChannel);
+        mNotificationManager.createNotificationChannel(configChannel); // 注册新增渠道
+        LogUtils.d(TAG, "initNotificationChannels() 成功：创建前台服务+电池提醒+应用配置信息渠道");
+    }
+
+    // ================================== 对外核心方法（前台服务通知：启动/更新/取消）=================================
+    /**
+     * 启动前台服务通知（API30适配，无铃声）
+     */
+    public void startForegroundServiceNotify(Service service, NotificationMessage message) {
+        LogUtils.d(TAG, "startForegroundServiceNotify() 执行 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE + " | service=" + service + " | message=" + message);
+        // 前置校验：参数非空
+        if (service == null || message == null || mNotificationManager == null) {
+            LogUtils.e(TAG, "startForegroundServiceNotify() 失败：param is null | service=" + service + " | message=" + message + " | mNotificationManager=" + mNotificationManager);
+            return;
+        }
+
+        // 构建前台通知
+        mForegroundServiceNotify = buildForegroundNotification(message);
+        if (mForegroundServiceNotify == null) {
+            LogUtils.e(TAG, "startForegroundServiceNotify() 失败：构建通知为空");
+            return;
+        }
+
+        // 启动前台服务（API30无FOREGROUND_SERVICE_TYPE限制，全版本通用）
+        try {
+            service.startForeground(NOTIFY_ID_FOREGROUND_SERVICE, mForegroundServiceNotify);
+            LogUtils.d(TAG, "startForegroundServiceNotify() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "startForegroundServiceNotify() 异常", e);
+        }
+    }
+
+    /**
+     * 更新前台服务通知内容（复用通知ID，保持无铃声）
+     */
+    public void updateForegroundServiceNotify(NotificationMessage message) {
+        LogUtils.d(TAG, "updateForegroundServiceNotify() 执行 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE + " | message=" + message);
+        if (message == null || mNotificationManager == null) {
+            LogUtils.e(TAG, "updateForegroundServiceNotify() 失败：param is null | message=" + message + " | mNotificationManager=" + mNotificationManager);
+            return;
+        }
+
+        mForegroundServiceNotify = buildForegroundNotification(message);
+        if (mForegroundServiceNotify == null) {
+            LogUtils.e(TAG, "updateForegroundServiceNotify() 失败：构建通知为空");
+            return;
+        }
+
+        try {
+            mNotificationManager.notify(NOTIFY_ID_FOREGROUND_SERVICE, mForegroundServiceNotify);
+            LogUtils.d(TAG, "updateForegroundServiceNotify() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "updateForegroundServiceNotify() 异常", e);
+        }
+    }
+
+    /**
+     * 取消前台服务通知（Service销毁时调用）
+     */
+    public void cancelForegroundServiceNotify() {
+        LogUtils.d(TAG, "cancelForegroundServiceNotify() 执行 | notifyId=" + NOTIFY_ID_FOREGROUND_SERVICE);
+        cancelNotification(NOTIFY_ID_FOREGROUND_SERVICE);
+        mForegroundServiceNotify = null; // 置空释放
+        LogUtils.d(TAG, "cancelForegroundServiceNotify() 成功");
+    }
+
+    // ================================== 对外核心方法（电池提醒通知：发送）=================================
+    /**
+     * 发送电池提醒通知（系统默认铃声，无振动）
+     */
+    public void showRemindNotification(Context context, NotificationMessage message) {
+        LogUtils.d(TAG, "showRemindNotification() 执行 | notifyId=" + NOTIFY_ID_REMIND + " | context=" + context + " | message=" + message);
+        if (context == null || message == null || mNotificationManager == null) {
+            LogUtils.e(TAG, "showRemindNotification() 失败：param is null | context=" + context + " | message=" + message + " | mNotificationManager=" + mNotificationManager);
+            return;
+        }
+
+        Notification remindNotify = buildRemindNotification(context, message);
+        if (remindNotify == null) {
+            LogUtils.e(TAG, "showRemindNotification() 失败：构建通知为空");
+            return;
+        }
+
+        try {
+            mNotificationManager.notify(NOTIFY_ID_REMIND, remindNotify);
+            LogUtils.d(TAG, "showRemindNotification() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "showRemindNotification() 异常", e);
+        }
+    }
+
+	public synchronized void showMessageNotification(Context context, NotificationMessage message) {
+		snMessageNotificationID++;
+        LogUtils.d(TAG, "showMessageNotification() 执行 | notifyId=" + snMessageNotificationID + " | context=" + context + " | message=" + message);
+        if (context == null || message == null || mNotificationManager == null) {
+            LogUtils.e(TAG, "showMessageNotification() 失败：param is null | context=" + context + " | message=" + message + " | mNotificationManager=" + mNotificationManager);
+            return;
+        }
+
+        Notification configNotify = buildConfigNotification(context, message);
+        if (configNotify == null) {
+            LogUtils.e(TAG, "showMessageNotification() 失败：构建通知为空");
+            return;
+        }
+
+        try {
+            mNotificationManager.notify(snMessageNotificationID, configNotify);
+            LogUtils.d(TAG, "showMessageNotification() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "showMessageNotification() 异常", e);
+        }
+    }
+
+    // ================================== 对外核心方法（应用配置信息通知：发送）=================================
+    /**
+     * 发送应用配置信息通知（方案1修复：系统默认铃声，无振动）
+     */
+    public void showConfigNotification(Context context, NotificationMessage message) {
+        LogUtils.d(TAG, "showConfigNotification() 执行 | notifyId=" + NOTIFY_ID_CONFIG + " | context=" + context + " | message=" + message);
+        if (context == null || message == null || mNotificationManager == null) {
+            LogUtils.e(TAG, "showConfigNotification() 失败：param is null | context=" + context + " | message=" + message + " | mNotificationManager=" + mNotificationManager);
+            return;
+        }
+
+        Notification configNotify = buildConfigNotification(context, message);
+        if (configNotify == null) {
+            LogUtils.e(TAG, "showConfigNotification() 失败：构建通知为空");
+            return;
+        }
+
+        try {
+            mNotificationManager.notify(NOTIFY_ID_CONFIG, configNotify);
+            LogUtils.d(TAG, "showConfigNotification() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "showConfigNotification() 异常", e);
+        }
+    }
+
+    // ================================== 对外工具方法（通知取消：单个/全部）=================================
+    /**
+     * 取消指定ID的通知
+     */
+    public void cancelNotification(int notifyId) {
+        LogUtils.d(TAG, "cancelNotification() 执行 | notifyId=" + notifyId);
+        if (mNotificationManager == null) {
+            LogUtils.e(TAG, "cancelNotification() 失败：NotificationManager is null");
+            return;
+        }
+        try {
+            mNotificationManager.cancel(notifyId);
+            LogUtils.d(TAG, "cancelNotification() 成功 | notifyId=" + notifyId);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "cancelNotification() 异常 | notifyId=" + notifyId, e);
+        }
+    }
+
+    /**
+     * 取消所有通知（兜底场景使用）
+     */
+    public void cancelAllNotifications() {
+        LogUtils.d(TAG, "cancelAllNotifications() 执行");
+        if (mNotificationManager == null) {
+            LogUtils.e(TAG, "cancelAllNotifications() 失败：NotificationManager is null");
+            return;
+        }
+        try {
+            mNotificationManager.cancelAll();
+            LogUtils.d(TAG, "cancelAllNotifications() 成功");
+        } catch (Exception e) {
+            LogUtils.e(TAG, "cancelAllNotifications() 异常", e);
+        }
+    }
+
+    // ================================== 内部辅助方法（通知构建：前台服务通知）=================================
+    /**
+     * 构建前台服务通知（全版本无铃声+无振动）
+     */
+    private Notification buildForegroundNotification(NotificationMessage message) {
+        LogUtils.d(TAG, "buildForegroundNotification() 执行 | message=" + message);
+        if (message == null || mContext == null) {
+            LogUtils.e(TAG, "buildForegroundNotification() 失败：param is null | message=" + message + " | mContext=" + mContext);
+            return null;
+        }
+
+        // 内容兜底
+        String title = message.getTitle() != null && !message.getTitle().isEmpty() ? message.getTitle() : FOREGROUND_NOTIFY_TITLE_DEFAULT;
+        String content = message.getContent() != null && !message.getContent().isEmpty() ? message.getContent() : FOREGROUND_NOTIFY_CONTENT_DEFAULT;
+        LogUtils.d(TAG, "buildForegroundNotification() 内容兜底完成 | title=" + title + " | content=" + content);
+
+        Notification.Builder builder;
+        // API分级构建
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            // API26+：绑定前台渠道（渠道已配置无铃声）
+            builder = new Notification.Builder(mContext, CHANNEL_ID_FOREGROUND);
+            LogUtils.d(TAG, "buildForegroundNotification() 使用API26+渠道构建");
+        } else {
+            // API<26：直接构建，手动禁用铃声振动
+            builder = new Notification.Builder(mContext);
+            builder.setSound(null);
+            builder.setVibrate(new long[]{0});
+            builder.setDefaults(0);
+            LogUtils.d(TAG, "buildForegroundNotification() 使用API<26手动配置");
+        }
+
+        // 通用配置
+        builder.setSmallIcon(NOTIFICATION_DEFAULT_ICON)
+			.setContentTitle(title)
+			.setContentText(content)
+			.setAutoCancel(false)
+			.setOngoing(true) // 不可手动关闭
+			.setWhen(System.currentTimeMillis())
+			.setContentIntent(createJumpPendingIntent(mContext, PENDING_INTENT_REQUEST_CODE_FOREGROUND));
+
+        // API21+ 新增大图标+主题色
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            builder.setLargeIcon(getAppIcon(mContext))
+				.setColor(mContext.getResources().getColor(R.color.colorPrimary))
+				.setPriority(Notification.PRIORITY_LOW);
+            LogUtils.d(TAG, "buildForegroundNotification() 补充API21+配置");
+        }
+
+        Notification notification = builder.build();
+        LogUtils.d(TAG, "buildForegroundNotification() 成功构建前台通知");
+        return notification;
+    }
+
+    // ================================== 内部辅助方法（通知构建：电池提醒通知）=================================
+    /**
+     * 构建电池提醒通知（全版本系统默认铃声+无振动）
+     */
+    private Notification buildRemindNotification(Context context, NotificationMessage message) {
+        LogUtils.d(TAG, "buildRemindNotification() 执行 | context=" + context + " | message=" + message);
+        if (context == null || message == null) {
+            LogUtils.e(TAG, "buildRemindNotification() 失败：param is null | context=" + context + " | message=" + message);
+            return null;
+        }
+
+        // 内容兜底
+        String title = message.getTitle() != null && !message.getTitle().isEmpty() ? message.getTitle() : REMIND_NOTIFY_TITLE_DEFAULT;
+        String content = message.getContent() != null && !message.getContent().isEmpty() ? message.getContent() : REMIND_NOTIFY_CONTENT_DEFAULT;
+        LogUtils.d(TAG, "buildRemindNotification() 内容兜底完成 | title=" + title + " | content=" + content);
+
+        Notification.Builder builder;
+        // API分级构建
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            // API26+：绑定提醒渠道（渠道已配置默认铃声）
+            builder = new Notification.Builder(context, CHANNEL_ID_REMIND);
+            LogUtils.d(TAG, "buildRemindNotification() 使用API26+渠道构建");
+        } else {
+            // API<26：手动配置默认铃声，关闭振动
+            builder = new Notification.Builder(context);
+            builder.setSound(Settings.System.DEFAULT_NOTIFICATION_URI) // 显式默认铃声
+				.setVibrate(new long[]{0})
+				.setDefaults(Notification.DEFAULT_LIGHTS | Notification.DEFAULT_SOUND);
+            LogUtils.d(TAG, "buildRemindNotification() 使用API<26手动配置");
+        }
+
+        // 通用配置
+        builder.setSmallIcon(NOTIFICATION_DEFAULT_ICON)
+			.setContentTitle(title)
+			.setContentText(content)
+			.setSound(RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION), Notification.AUDIO_ATTRIBUTES_DEFAULT)
+			.setAutoCancel(true) // 点击关闭
+			.setOngoing(false)
+			.setWhen(System.currentTimeMillis())
+			.setContentIntent(createJumpPendingIntent(context, PENDING_INTENT_REQUEST_CODE_REMIND));
+
+        // API21+ 新增大图标+主题色
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            builder.setLargeIcon(getAppIcon(context))
+				.setColor(context.getResources().getColor(R.color.colorPrimary))
+				.setPriority(Notification.PRIORITY_DEFAULT);
+            LogUtils.d(TAG, "buildRemindNotification() 补充API21+配置");
+        }
+
+        Notification notification = builder.build();
+        LogUtils.d(TAG, "buildRemindNotification() 成功构建提醒通知");
+        return notification;
+    }
+
+    // ================================== 内部辅助方法（通知构建：应用配置信息通知）=================================
+    /**
+     * 构建应用配置信息通知（方案1修复：全版本系统默认铃声+无振动）
+     */
+    private Notification buildConfigNotification(Context context, NotificationMessage message) {
+        LogUtils.d(TAG, "buildConfigNotification() 执行 | context=" + context + " | message=" + message);
+        if (context == null || message == null) {
+            LogUtils.e(TAG, "buildConfigNotification() 失败：param is null | context=" + context + " | message=" + message);
+            return null;
+        }
+
+        // 内容兜底
+        String title = message.getTitle() != null && !message.getTitle().isEmpty() ? message.getTitle() : CONFIG_NOTIFY_TITLE_DEFAULT;
+        String content = message.getContent() != null && !message.getContent().isEmpty() ? message.getContent() : CONFIG_NOTIFY_CONTENT_DEFAULT;
+        LogUtils.d(TAG, "buildConfigNotification() 内容兜底完成 | title=" + title + " | content=" + content);
+
+        Notification.Builder builder;
+        // API分级构建
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            // API26+：绑定配置渠道（渠道已配置默认铃声）
+            builder = new Notification.Builder(context, CHANNEL_ID_CONFIG);
+            LogUtils.d(TAG, "buildConfigNotification() 使用API26+渠道构建");
+        } else {
+            // API<26：手动配置默认铃声，关闭振动（方案1修复：保留铃声配置，删除冗余DEFAULT_SOUND）
+            builder = new Notification.Builder(context);
+            builder.setSound(Settings.System.DEFAULT_NOTIFICATION_URI);
+            builder.setVibrate(new long[]{0});
+            builder.setDefaults(Notification.DEFAULT_LIGHTS);
+            LogUtils.d(TAG, "buildConfigNotification() 使用API<26手动配置");
+        }
+
+        // 通用配置
+        builder.setSmallIcon(NOTIFICATION_DEFAULT_ICON)
+			.setContentTitle(title)
+			.setContentText(content)
+			.setAutoCancel(true) // 点击关闭
+			.setOngoing(false)
+			.setWhen(System.currentTimeMillis())
+			.setContentIntent(createJumpPendingIntent(context, PENDING_INTENT_REQUEST_CODE_CONFIG));
+
+        // API21+ 新增大图标+主题色
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            builder.setLargeIcon(getAppIcon(context))
+				.setColor(context.getResources().getColor(R.color.colorPrimary))
+				.setPriority(Notification.PRIORITY_DEFAULT);
+            LogUtils.d(TAG, "buildConfigNotification() 补充API21+配置");
+        }
+
+        Notification notification = builder.build();
+        LogUtils.d(TAG, "buildConfigNotification() 成功构建配置信息通知");
+        return notification;
+    }
+
+    // ================================== 内部辅助方法（创建跳转PendingIntent，API30安全适配）=================================
+    /**
+     * 创建跳转MainActivity的PendingIntent，API23+ 添加IMMUTABLE标记（避免安全异常）
+     */
+    private PendingIntent createJumpPendingIntent(Context context, int requestCode) {
+        LogUtils.d(TAG, "createJumpPendingIntent() 执行 | requestCode=" + requestCode + " | context=" + context);
+        Intent intent = new Intent(context, MainActivity.class);
+        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+        LogUtils.d(TAG, "createJumpPendingIntent() 跳转Intent配置完成");
+
+        // API23+ 必需添加IMMUTABLE，适配API30安全规范
+        int flags = PendingIntent.FLAG_UPDATE_CURRENT;
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+            flags |= PendingIntent.FLAG_IMMUTABLE;
+            LogUtils.d(TAG, "createJumpPendingIntent() 添加FLAG_IMMUTABLE标记（API23+）");
+        }
+
+        PendingIntent pendingIntent = PendingIntent.getActivity(context, requestCode, intent, flags);
+        LogUtils.d(TAG, "createJumpPendingIntent() 成功 | requestCode=" + requestCode);
+        return pendingIntent;
+    }
+
+    // ================================== 内部辅助方法（获取APP图标，异常兜底）=================================
+    /**
+     * 获取APP图标，失败返回默认图标
+     */
+    private Bitmap getAppIcon(Context context) {
+        LogUtils.d(TAG, "getAppIcon() 执行 | context=" + context);
+        try {
+            PackageInfo pkgInfo = context.getPackageManager().getPackageInfo(context.getPackageName(), 0);
+            Bitmap appIcon = BitmapFactory.decodeResource(context.getResources(), pkgInfo.applicationInfo.icon);
+            LogUtils.d(TAG, "getAppIcon() 成功：获取应用图标");
+            return appIcon;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.e(TAG, "getAppIcon() 异常：获取应用图标失败，使用默认图标", e);
+            return BitmapFactory.decodeResource(context.getResources(), NOTIFICATION_DEFAULT_ICON);
+        }
+    }
+
+    // ================================== 资源释放方法（避免内存泄漏）=================================
+    /**
+     * 释放资源，销毁时调用
+     */
+    public void release() {
+        LogUtils.d(TAG, "release() 执行资源释放");
+        cancelForegroundServiceNotify();
+        mNotificationManager = null;
+        mContext = null;
+        LogUtils.d(TAG, "release() 成功：所有资源已释放");
+    }
+
+    // ================================== 对外 getter 方法（仅前台通知实例，只读）=================================
+    public Notification getForegroundServiceNotify() {
+        return mForegroundServiceNotify;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/PermissionUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/PermissionUtils.java
new file mode 100644
index 0000000..ac17719
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/PermissionUtils.java
@@ -0,0 +1,350 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.app.Activity;
+import android.app.AlertDialog;
+import android.content.ComponentName;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Environment;
+import android.os.PowerManager;
+import android.provider.Settings;
+import androidx.core.app.ActivityCompat;
+import androidx.core.content.ContextCompat;
+import cc.winboll.studio.libaes.dialogs.YesNoAlertDialog;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/14 03:05
+ * @Describe 权限申请工具类（Java7兼容版）
+ * 适配 小米手机+API29-30，整合自启动、电池优化、全文件管理权限，专注后台保活核心权限
+ */
+public class PermissionUtils {
+    // ====================== 常量定义（首屏可见，统一管理，避免冲突）======================
+    // 日志标签
+    public static final String TAG = "PermissionUtils";
+    // 权限请求码（按场景分段，避免重复）
+    public static final int REQUEST_IGNORE_BATTERY_OPTIMIZATION = 1000; // 电池优化权限
+    public static final int REQUEST_AUTO_START = 1001;                   // 自启动权限（小米专属）
+    public static final int REQUEST_ALL_FILE_MANAGE = 1002;              // 全文件管理权限（API30+）
+    // SDK版本常量（适配API29-30，替代系统枚举，Java7兼容）
+    private static final int SDK_VERSION_Q = 29;                         // Android 10（API29）
+    private static final int SDK_VERSION_R = 30;                         // Android 11（API30）
+    // 小米自启动权限页面配置（专属跳转路径，精准适配）
+    private static final String XIAOMI_AUTO_START_PACKAGE = "com.miui.securitycenter";
+    private static final String XIAOMI_AUTO_START_CLASS = "com.miui.permcenter.autostart.AutoStartManagementActivity";
+
+    // ====================== 单例模式（Java7标准双重校验锁，线程安全+懒加载）======================
+    private static volatile PermissionUtils sInstance;
+
+    private PermissionUtils() {}
+
+    public static PermissionUtils getInstance() {
+        if (sInstance == null) {
+            synchronized (PermissionUtils.class) {
+                if (sInstance == null) {
+                    sInstance = new PermissionUtils();
+                    LogUtils.d(TAG, "初始化：PermissionUtils 单例创建成功");
+                }
+            }
+        }
+        return sInstance;
+    }
+
+    // ====================== 核心权限1：全文件管理权限（API29-30适配，通用所有机型）======================
+    /**
+     * 检查全文件管理权限（适配API30+ MANAGE_EXTERNAL_STORAGE，兼容API29-旧权限）
+     * @param activity 上下文Activity（不可为null）
+     * @return true=权限已授予，false=权限未授予
+     */
+    public boolean checkAllFileManagePermission(Activity activity) {
+        LogUtils.d(TAG, "全文件权限-检查：开始校验，系统版本=" + Build.VERSION.SDK_INT);
+        if (activity == null) {
+            LogUtils.e(TAG, "全文件权限-检查：失败，Activity为空");
+            return false;
+        }
+
+        // API30+：校验 MANAGE_EXTERNAL_STORAGE 特殊权限
+        if (Build.VERSION.SDK_INT >= SDK_VERSION_R) {
+            boolean hasManagePerm = Environment.isExternalStorageManager();
+            LogUtils.d(TAG, "全文件权限-检查：API30+，MANAGE_EXTERNAL_STORAGE权限=" + (hasManagePerm ? "已授予" : "未授予"));
+            return hasManagePerm;
+        } else if (Build.VERSION.SDK_INT == SDK_VERSION_Q) {
+            LogUtils.d(TAG, "全文件权限-检查：API29，无需申请，默认支持文件管理");
+            return true;
+        } else {
+            boolean hasWritePerm = ContextCompat.checkSelfPermission(activity,
+																	 android.Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
+            LogUtils.d(TAG, "全文件权限-检查：API29以下，WRITE_EXTERNAL_STORAGE权限=" + (hasWritePerm ? "已授予" : "未授予"));
+            return hasWritePerm;
+        }
+    }
+
+    /**
+     * 申请全文件管理权限（适配API30+特殊权限流程，兼容API29-旧权限申请）
+     * @param activity 申请权限的Activity（不可为null）
+     */
+    public void requestAllFileManagePermission(Activity activity) {
+        LogUtils.d(TAG, "全文件权限-申请：开始处理，系统版本=" + Build.VERSION.SDK_INT);
+        if (activity == null || activity.isFinishing()) {
+            LogUtils.e(TAG, "全文件权限-申请：失败，Activity无效/已销毁");
+            return;
+        }
+
+        // 先检查权限，已授予直接返回
+        if (checkAllFileManagePermission(activity)) {
+            LogUtils.d(TAG, "全文件权限-申请：已拥有权限，无需发起");
+            return;
+        }
+
+        // API30+：跳转系统特殊权限申请页（用户手动授权）
+        if (Build.VERSION.SDK_INT >= SDK_VERSION_R) {
+            try {
+                Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
+                intent.setData(Uri.parse("package:" + activity.getPackageName()));
+                activity.startActivityForResult(intent, REQUEST_ALL_FILE_MANAGE);
+                LogUtils.d(TAG, "全文件权限-申请：API30+，跳转特殊权限申请页");
+            } catch (Exception e) {
+                // 备用跳转：系统设置首页，引导手动操作
+                Intent intent = new Intent(Settings.ACTION_SETTINGS);
+                activity.startActivityForResult(intent, REQUEST_ALL_FILE_MANAGE);
+                LogUtils.w(TAG, "全文件权限-申请：跳转失败，引导手动开启");
+                showAllFileManageTipsDialog(activity);
+            }
+        } else {
+            ActivityCompat.requestPermissions(activity,
+											  new String[]{android.Manifest.permission.WRITE_EXTERNAL_STORAGE},
+											  REQUEST_ALL_FILE_MANAGE);
+            LogUtils.d(TAG, "全文件权限-申请：API29以下，发起WRITE_EXTERNAL_STORAGE权限申请");
+        }
+    }
+
+    // ====================== 核心权限2：自启动权限（小米专属，API29-30适配）======================
+    /**
+     * 检查自启动权限（仅小米机型需要，非小米直接返回无需申请）
+     * @param activity 上下文Activity（不可为null）
+     * @return true=小米机型（需手动开启）；false=非小米机型（无需申请）
+     */
+//    public boolean checkAutoStartPermission(Activity activity) {
+//        LogUtils.d(TAG, "自启动权限-检查：开始，设备品牌=" + Build.BRAND);
+//        if (activity == null) {
+//            LogUtils.e(TAG, "自启动权限-检查：失败，Activity为空");
+//            return false;
+//        }
+//
+//        boolean isXiaomi = Build.BRAND.toLowerCase().contains("xiaomi");
+//        LogUtils.d(TAG, "自启动权限-检查：结果=" + (isXiaomi ? "小米机型（需开启）" : "非小米机型（无需申请）"));
+//        return isXiaomi;
+//    }
+
+    /**
+     * 请求自启动权限（小米专属，多方案跳转，适配API29-30机型差异）
+     * @param activity 申请权限的Activity（不可为null）
+     */
+    public void requestAutoStartPermission(Activity activity) {
+        LogUtils.d(TAG, "自启动权限-申请：开始处理");
+        if (activity == null || activity.isFinishing()) {
+            LogUtils.e(TAG, "自启动权限-申请：失败，Activity无效/已销毁");
+            return;
+        }
+
+        // 非小米机型，直接返回
+//        if (!checkAutoStartPermission(activity)) {
+//            LogUtils.d(TAG, "自启动权限-申请：非小米机型，无需处理");
+//            return;
+//        }
+
+        // API30+ 小米：优先精准跳转自启动管理页
+        if (Build.VERSION.SDK_INT >= SDK_VERSION_R) {
+            try {
+                // 方案1：组件名精准跳转（成功率最高）
+                Intent intent = new Intent();
+                intent.setComponent(new ComponentName(XIAOMI_AUTO_START_PACKAGE, XIAOMI_AUTO_START_CLASS));
+                activity.startActivityForResult(intent, REQUEST_AUTO_START);
+                LogUtils.d(TAG, "自启动权限-申请：API30+，组件名跳转自启动管理页");
+            } catch (Exception e1) {
+                try {
+                    // 方案2：Action备用跳转（兼容机型差异）
+                    Intent intent = new Intent("miui.intent.action.OP_AUTO_START");
+                    intent.setClassName(XIAOMI_AUTO_START_PACKAGE, XIAOMI_AUTO_START_CLASS);
+                    activity.startActivityForResult(intent, REQUEST_AUTO_START);
+                    LogUtils.d(TAG, "自启动权限-申请：API30+，Action跳转自启动管理页");
+                } catch (Exception e2) {
+                    // 方案3：终极备用，跳转系统设置+提示
+                    Intent intent = new Intent(Settings.ACTION_SETTINGS);
+                    activity.startActivityForResult(intent, REQUEST_AUTO_START);
+                    LogUtils.w(TAG, "自启动权限-申请：跳转失败，引导手动操作");
+                    showAutoStartTipsDialog(activity);
+                }
+            }
+            return;
+        }
+
+        // API29 小米：低版本兼容跳转
+        try {
+            Intent intent = new Intent(XIAOMI_AUTO_START_CLASS);
+            intent.setPackage(XIAOMI_AUTO_START_PACKAGE);
+            activity.startActivityForResult(intent, REQUEST_AUTO_START);
+            LogUtils.d(TAG, "自启动权限-申请：API29，低版本跳转自启动管理页");
+        } catch (Exception e) {
+            Intent intent = new Intent(Settings.ACTION_SETTINGS);
+            activity.startActivityForResult(intent, REQUEST_AUTO_START);
+            showAutoStartTipsDialog(activity);
+        }
+    }
+
+    // ====================== 核心权限3：电池优化权限（通用所有机型，API29-30适配）======================
+    /**
+     * 检查忽略电池优化权限（精准判断，API23+有效，低版本视为已拥有）
+     * @param activity 上下文Activity（不可为null）
+     * @return true=已忽略优化；false=未忽略（需申请）
+     */
+    public boolean checkIgnoreBatteryOptimizationPermission(Activity activity) {
+        LogUtils.d(TAG, "电池优化权限-检查：开始，系统版本=" + Build.VERSION.SDK_INT);
+        if (activity == null) {
+            LogUtils.e(TAG, "电池优化权限-检查：失败，Activity为空");
+            return false;
+        }
+
+        // API23以下无此权限，视为已拥有
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+            LogUtils.d(TAG, "电池优化权限-检查：API23以下，无需校验，视为已拥有");
+            return true;
+        }
+
+        // API23+ 精准校验权限状态
+        PowerManager powerManager = (PowerManager) activity.getSystemService(Activity.POWER_SERVICE);
+        if (powerManager == null) {
+            LogUtils.e(TAG, "电池优化权限-检查：获取PowerManager失败，校验异常");
+            return false;
+        }
+        boolean isIgnored = powerManager.isIgnoringBatteryOptimizations(activity.getPackageName());
+        LogUtils.d(TAG, "电池优化权限-检查：结果=" + (isIgnored ? "已忽略优化" : "未忽略（需申请）"));
+        return isIgnored;
+    }
+
+    /**
+     * 请求忽略电池优化权限（多方案跳转，适配API29-30，自动判断是否需要申请）
+     * @param activity 申请权限的Activity（不可为null）
+     */
+    public void requestIgnoreBatteryOptimizationPermission(Activity activity) {
+        LogUtils.d(TAG, "电池优化权限-申请：开始处理");
+        if (activity == null || activity.isFinishing()) {
+            LogUtils.e(TAG, "电池优化权限-申请：失败，Activity无效/已销毁");
+            return;
+        }
+
+        // 已拥有权限，直接返回
+        if (checkIgnoreBatteryOptimizationPermission(activity)) {
+            LogUtils.d(TAG, "电池优化权限-申请：已拥有权限，无需发起");
+            return;
+        }
+
+        try {
+            // 方案1：直接跳转一键授权页（优先使用，用户操作简单）
+            Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
+            intent.setData(Uri.parse("package:" + activity.getPackageName()));
+            activity.startActivityForResult(intent, REQUEST_IGNORE_BATTERY_OPTIMIZATION);
+            LogUtils.d(TAG, "电池优化权限-申请：跳转一键授权页");
+        } catch (Exception e) {
+            // 方案2：备用跳转优化管理页+提示
+            Intent intent = new Intent(Settings.ACTION_BATTERY_SAVER_SETTINGS);
+            activity.startActivityForResult(intent, REQUEST_IGNORE_BATTERY_OPTIMIZATION);
+            LogUtils.w(TAG, "电池优化权限-申请：跳转失败，引导手动操作");
+            showBatteryOptTipsDialog(activity);
+        }
+    }
+
+    // ====================== 辅助方法：手动开启提示弹窗（适配跳转失败场景）======================
+    /**
+     * 全文件管理权限手动开启提示弹窗
+     */
+    private void showAllFileManageTipsDialog(final Activity activity) {
+        new AlertDialog.Builder(activity)
+			.setTitle("全文件管理权限申请提示")
+			.setMessage("请手动开启全文件管理权限，否则文件操作功能异常：\n1. 进入设置 → 应用 → 本应用 → 权限\n2. 找到「文件管理」/「存储」权限，开启「允许管理所有文件」")
+			.setPositiveButton("知道了", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+				}
+			})
+			.setCancelable(false)
+			.show();
+        LogUtils.d(TAG, "全文件权限：显示手动开启提示弹窗");
+    }
+
+    /**
+     * 自启动权限手动开启提示弹窗（小米专属）
+     */
+    private void showAutoStartTipsDialog(final Activity activity) {
+        new AlertDialog.Builder(activity)
+			.setTitle("自启动权限申请提示")
+			.setMessage("请手动开启自启动权限，否则应用后台保活异常：\n1. 进入小米安全中心 → 应用管理 → 自启动管理\n2. 找到本应用，开启「允许自启动」开关")
+			.setPositiveButton("知道了", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+				}
+			})
+			.setCancelable(false)
+			.show();
+        LogUtils.d(TAG, "自启动权限：显示手动开启提示弹窗");
+    }
+
+    /**
+     * 电池优化权限手动开启提示弹窗
+     */
+    private void showBatteryOptTipsDialog(final Activity activity) {
+        new AlertDialog.Builder(activity)
+			.setTitle("电池优化权限申请提示")
+			.setMessage("请手动忽略电池优化，否则应用后台运行被限制：\n1. 进入设置 → 电池 → 电池优化\n2. 找到本应用，选择「不优化」选项")
+			.setPositiveButton("知道了", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+				}
+			})
+			.setCancelable(false)
+			.show();
+        LogUtils.d(TAG, "电池优化权限：显示手动开启提示弹窗");
+    }
+
+	public void startPermissionRequest(final Activity activity) {
+		// 电池优化权限（通用所有机型）
+		if (!checkIgnoreBatteryOptimizationPermission(activity)) {
+			YesNoAlertDialog.show(activity, activity.getString(R.string.app_name) + "权限申请提示：", "本应用要正常使用，需要申请电池优化与自启动权限。是否进入权限设置步骤？", new YesNoAlertDialog.OnDialogResultListener(){
+					@Override
+					public void onNo() {
+						ToastUtils.show(activity.getString(R.string.app_name) + "应用可能无法正常使用。");
+					}
+					@Override
+					public void onYes() {
+						requestIgnoreBatteryOptimizationPermission(activity);
+					}
+				});
+		}
+    }
+
+	public void handlePermissionRequest(final Activity activity, int requestCode, int resultCode, Intent data) {
+        if (requestCode == PermissionUtils.REQUEST_IGNORE_BATTERY_OPTIMIZATION) {
+			// 自启动权限（小米专属）
+			// 小米机型，发起自启动权限申请
+			requestAutoStartPermission(activity);
+		} else if (requestCode == PermissionUtils.REQUEST_AUTO_START) {
+			// 自启动权限（小米专属）
+			if (App.isDebugging() && !checkAllFileManagePermission(activity)) {
+				// 小米机型，发起自启动权限申请
+				requestAllFileManagePermission(activity);
+			}
+		}
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ServiceUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ServiceUtils.java
new file mode 100644
index 0000000..55133a3
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/ServiceUtils.java
@@ -0,0 +1,70 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.app.ActivityManager;
+import android.content.Context;
+import android.text.TextUtils;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.util.List;
+
+/**
+ * 服务状态工具类
+ * 功能：判断指定服务是否处于运行状态
+ * 适配：Java 7 + Android API 30
+ * 注意：Android 8.0+ 对后台服务限制严格，此方法仅适用于前台服务或兼容场景
+ */
+public class ServiceUtils {
+    // ================================== 静态常量区（置顶归类）=================================
+    public static final String TAG = ServiceUtils.class.getSimpleName();
+    // 最大查询服务数量
+    private static final int MAX_RUNNING_SERVICES = 1000;
+
+    // ================================== 核心工具方法（判断服务是否运行）=================================
+    /**
+     * 判断指定服务是否处于运行状态
+     * @param context 上下文（建议使用 Application 上下文避免内存泄漏）
+     * @param serviceName 服务完整类名（如：com.example.app.service.DemoService）
+     * @return true-服务运行中，false-服务未运行或查询失败
+     */
+    public static boolean isServiceAlive(Context context, String serviceName) {
+        LogUtils.d(TAG, "【isServiceAlive】调用开始 | 服务名称=" + serviceName);
+        // 1. 前置参数校验
+        if (context == null) {
+            LogUtils.e(TAG, "【isServiceAlive】参数异常：Context 为空");
+            return false;
+        }
+        if (TextUtils.isEmpty(serviceName)) {
+            LogUtils.e(TAG, "【isServiceAlive】参数异常：服务名称为空");
+            return false;
+        }
+
+        // 2. 获取 ActivityManager
+        ActivityManager activityManager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
+        if (activityManager == null) {
+            LogUtils.e(TAG, "【isServiceAlive】获取 ActivityManager 失败");
+            return false;
+        }
+
+        // 3. 查询正在运行的服务
+        List<ActivityManager.RunningServiceInfo> runningServices = activityManager.getRunningServices(MAX_RUNNING_SERVICES);
+        if (runningServices == null || runningServices.size() <= 0) {
+            LogUtils.d(TAG, "【isServiceAlive】正在运行的服务列表为空");
+            return false;
+        }
+
+        // 4. 遍历服务列表，匹配目标服务
+        for (ActivityManager.RunningServiceInfo serviceInfo : runningServices) {
+            if (serviceInfo.service == null) {
+                continue;
+            }
+            String className = serviceInfo.service.getClassName();
+            if (serviceName.equals(className)) {
+                LogUtils.d(TAG, "【isServiceAlive】服务运行中 | 匹配成功：" + serviceName);
+                return true;
+            }
+        }
+
+        LogUtils.d(TAG, "【isServiceAlive】服务未运行 | 未匹配到：" + serviceName);
+        return false;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/StringUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/StringUtils.java
new file mode 100644
index 0000000..8940be5
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/StringUtils.java
@@ -0,0 +1,151 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.text.TextUtils;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.models.BatteryInfoBean;
+import java.util.ArrayList;
+import java.util.Locale;
+
+/**
+ * 字符串格式化工具类
+ * 功能：电量使用时间列表格式化、时间跨度计算
+ * 适配：Java 7 + Android API 30
+ * 核心逻辑：将电池信息列表转换为指定格式字符串，计算时间戳之间的跨度并格式化
+ */
+public class StringUtils {
+    // ================================== 静态常量区（置顶归类，消除魔法值）=================================
+    public static final String TAG = StringUtils.class.getSimpleName();
+    // 时间跨度单位符号
+    private static final String UNIT_DAY = "☀";
+    private static final String UNIT_HOUR = "★";
+    private static final String UNIT_MINUTE = "✰";
+    private static final String UNIT_SECOND_DEFAULT = "☆}";
+    // 时间计算常量
+    private static final long MILLIS_PER_DAY = 24 * 60 * 60 * 1000L;
+    private static final long MILLIS_PER_HOUR = 60 * 60 * 1000L;
+    private static final long MILLIS_PER_MINUTE = 60 * 1000L;
+    private static final long MILLIS_PER_SECOND = 1000L;
+    // 空字符串常量（替代 TextUtils.EMPTY，保证 Java 7 兼容）
+    private static final String EMPTY_STRING = "";
+
+    // ================================== 核心格式化方法（电量列表格式化）=================================
+    /**
+     * 格式化电量使用时间列表为单行字符串
+     * @param batteryInfoList 电池信息列表（非空）
+     * @return 格式化后的单行字符串，格式："电量% 时间跨度 电量% 时间跨度 ..."
+     */
+    public static String formatPCMListString(ArrayList<BatteryInfoBean> batteryInfoList) {
+        LogUtils.d(TAG, "【formatPCMListString】调用开始 | 列表大小=" + (batteryInfoList != null ? batteryInfoList.size() : null));
+        // 1. 参数校验
+        if (batteryInfoList == null || batteryInfoList.size() < 2) {
+            LogUtils.e(TAG, "【formatPCMListString】参数异常：列表为空或长度不足2");
+            return EMPTY_STRING;
+        }
+
+        String result = EMPTY_STRING;
+        // 2. 遍历列表，拼接字符串（倒序拼接）
+        for (int i = 0; i < batteryInfoList.size() - 1; i++) {
+            BatteryInfoBean currentBean = batteryInfoList.get(i);
+            BatteryInfoBean nextBean = batteryInfoList.get(i + 1);
+            // 空指针防护
+            if (currentBean == null || nextBean == null) {
+                LogUtils.w(TAG, "【formatPCMListString】列表项为空，跳过当前索引：" + i);
+                continue;
+            }
+            // 获取电量和时间跨度
+            int batteryValue = currentBean.getBatteryValue();
+            String timeSpan = getTimespanDifference(currentBean.getTimeStamp(), nextBean.getTimeStamp());
+            // 倒序拼接
+            result = batteryValue + "% " + timeSpan + " " + result;
+            LogUtils.d(TAG, "【formatPCMListString】循环拼接 | 索引=" + i + " | 电量=" + batteryValue + "% | 时间跨度=" + timeSpan);
+        }
+
+        LogUtils.d(TAG, "【formatPCMListString】格式化完成 | 结果长度=" + result.length());
+        return result;
+    }
+
+    /**
+     * 格式化电量使用时间列表为带换行的字符串
+     * @param batteryInfoList 电池信息列表（非空）
+     * @return 格式化后的带换行字符串，每行一个电量和时间跨度
+     */
+    public static String formatPCMListStringWithEnter(ArrayList<BatteryInfoBean> batteryInfoList) {
+        LogUtils.d(TAG, "【formatPCMListStringWithEnter】调用开始 | 列表大小=" + (batteryInfoList != null ? batteryInfoList.size() : null));
+        // 1. 参数校验
+        if (batteryInfoList == null || batteryInfoList.size() < 2) {
+            LogUtils.e(TAG, "【formatPCMListStringWithEnter】参数异常：列表为空或长度不足2");
+            return EMPTY_STRING;
+        }
+
+        String result = EMPTY_STRING;
+        // 2. 遍历列表，拼接字符串（倒序拼接，带换行）
+        for (int i = 0; i < batteryInfoList.size() - 1; i++) {
+            BatteryInfoBean currentBean = batteryInfoList.get(i);
+            BatteryInfoBean nextBean = batteryInfoList.get(i + 1);
+            // 空指针防护
+            if (currentBean == null || nextBean == null) {
+                LogUtils.w(TAG, "【formatPCMListStringWithEnter】列表项为空，跳过当前索引：" + i);
+                continue;
+            }
+            // 获取电量和时间跨度
+            int batteryValue = currentBean.getBatteryValue();
+            String timeSpan = getTimespanDifference(currentBean.getTimeStamp(), nextBean.getTimeStamp());
+            // 倒序拼接（带换行）
+            result = "\n" + batteryValue + "%\n        " + timeSpan + " " + result;
+            LogUtils.d(TAG, "【formatPCMListStringWithEnter】循环拼接 | 索引=" + i + " | 电量=" + batteryValue + "% | 时间跨度=" + timeSpan);
+        }
+
+        LogUtils.d(TAG, "【formatPCMListStringWithEnter】格式化完成 | 结果长度=" + result.length());
+        return result;
+    }
+
+    // ================================== 时间跨度计算方法（核心工具方法）=================================
+    /**
+     * 计算两个时间戳之间的跨度并格式化为指定字符串
+     * @param start 开始时间戳（毫秒）
+     * @param end 结束时间戳（毫秒）
+     * @return 格式化的时间跨度字符串，格式：{天☀时★分✰秒} 或 {☆}（当时间差为0时）
+     */
+    public static String getTimespanDifference(long start, long end) {
+        LogUtils.d(TAG, "【getTimespanDifference】调用开始 | 开始时间戳=" + start + " | 结束时间戳=" + end);
+        long between = end - start;
+        LogUtils.d(TAG, "【getTimespanDifference】时间差（毫秒）=" + between);
+
+        // 计算天、时、分、秒
+        long day = between / MILLIS_PER_DAY;
+        long hour = (between % MILLIS_PER_DAY) / MILLIS_PER_HOUR;
+        long min = (between % MILLIS_PER_HOUR) / MILLIS_PER_MINUTE;
+        long sec = (between % MILLIS_PER_MINUTE) / MILLIS_PER_SECOND;
+
+        // 拼接结果字符串
+        StringBuilder result = new StringBuilder("{");
+        boolean hasHigherUnit = false;
+
+        // 拼接天
+        if (day > 0) {
+            result.append(String.format(Locale.getDefault(), "%d%s", day, UNIT_DAY));
+            hasHigherUnit = true;
+        }
+        // 拼接时（当天>0或后续有单位时）
+        if (hour > 0 || hasHigherUnit) {
+            result.append(String.format(Locale.getDefault(), "%d%s", hour, UNIT_HOUR));
+            hasHigherUnit = true;
+        }
+        // 拼接分（当时>0或后续有单位时）
+        if (min > 0 || hasHigherUnit) {
+            result.append(String.format(Locale.getDefault(), "%d%s", min, UNIT_MINUTE));
+            hasHigherUnit = true;
+        }
+        // 拼接秒或默认值
+        if (hasHigherUnit) {
+            result.append(String.format(Locale.getDefault(), "%d}", sec));
+        } else {
+            result.append(UNIT_SECOND_DEFAULT);
+        }
+
+        String timeSpan = result.toString();
+        LogUtils.d(TAG, "【getTimespanDifference】计算完成 | 时间跨度=" + timeSpan);
+        return timeSpan;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/TextToSpeechUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/TextToSpeechUtils.java
new file mode 100644
index 0000000..54757eb
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/TextToSpeechUtils.java
@@ -0,0 +1,251 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.Context;
+import android.graphics.PixelFormat;
+import android.os.Build;
+import android.speech.tts.TextToSpeech;
+import android.speech.tts.UtteranceProgressListener;
+import android.view.Gravity;
+import android.view.View;
+import android.view.WindowManager;
+import android.widget.LinearLayout;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.TTSSpeakTextBean;
+import java.util.ArrayList;
+
+/**
+ * TTS语音播放工具类 (单例实现)
+ * 适配：Java7 语法规范 | Android API36 系统版本【修复崩溃】
+ * 功能：队列播放语音文本 + 播放悬浮窗展示 + 点击悬浮窗停止播放/关闭悬浮窗
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/12/29 19:03
+ */
+public class TextToSpeechUtils {
+
+    // ====================================== 常量区 - 静态全局常量 (置顶) ======================================
+    public static final String TAG = "TextToSpeechUtils";
+    public static final String UNIQUE_ID = "UNIQUE_ID";
+
+    // ====================================== 单例实例 - 静态私有 (饿汉式优化) ======================================
+    private static volatile TextToSpeechUtils sTextToSpeechUtils;
+
+    // ====================================== 成员属性区 - 私有成员变量 (按功能归类 有序排列) ======================================
+    private Context mContext;
+    private WindowManager mWindowManager;
+    private TextToSpeech mTextToSpeech;
+    private View mView;
+    private volatile boolean isExist = false;
+    private UtteranceProgressListener mUtteranceProgressListener;
+
+    // ====================================== 构造方法 - 私有私有化 (单例模式) ======================================
+    private TextToSpeechUtils(Context context) {
+        LogUtils.d(TAG, "【构造方法】初始化TextToSpeechUtil实例");
+        this.mContext = context.getApplicationContext();
+        this.mWindowManager = (WindowManager) mContext.getSystemService(Context.WINDOW_SERVICE);
+        this.initUtteranceProgressListener();
+        LogUtils.d(TAG, "【构造方法】初始化完成，获取WindowManager实例："+mWindowManager);
+    }
+
+    // ====================================== 对外暴露方法 - 单例获取入口 (线程安全) ======================================
+    public static synchronized TextToSpeechUtils getInstance(Context context) {
+        LogUtils.d(TAG, "【getInstance】获取单例实例，入参Context：" + context);
+        if (sTextToSpeechUtils == null) {
+            LogUtils.d(TAG, "【getInstance】实例为空，创建新的TextToSpeechUtil对象");
+            sTextToSpeechUtils = new TextToSpeechUtils(context);
+        }
+        return sTextToSpeechUtils;
+    }
+
+    // ====================================== 核心对外业务方法 - 播放TTS语音队列 【主入口】 ======================================
+    public void speekTTSList(final ArrayList<TTSSpeakTextBean> listTTSSpeakTextBean) {
+        LogUtils.d(TAG, "【speekTTSList】播放语音队列调用，入参队列长度：" + (listTTSSpeakTextBean == null ? 0 : listTTSSpeakTextBean.size()));
+        // 重置播放退出标志位
+        isExist = false;
+        LogUtils.d(TAG, "【speekTTSList】重置播放退出标志位 isExist = " + isExist);
+
+        // TTS实例为空 → 初始化TTS后重放
+        if (mTextToSpeech == null) {
+            LogUtils.d(TAG, "【speekTTSList】TextToSpeech实例为空，开始初始化TTS");
+            mTextToSpeech = new TextToSpeech(mContext, new TextToSpeech.OnInitListener() {
+					@Override
+					public void onInit(int initStatus) {
+						LogUtils.d(TAG, "【onInit】TTS初始化回调，初始化状态码：" + initStatus);
+						if (initStatus == TextToSpeech.SUCCESS) {
+							LogUtils.d(TAG, "【onInit】TTS初始化成功，重新调用语音播放方法");
+							speekTTSList(listTTSSpeakTextBean);
+						} else {
+							LogUtils.d(TAG, "【onInit】TTS init failed : " + initStatus + ". The app [https://play.google.com/store/apps/details?id=com.google.android.tts] maybe fix this TTS probrem. ");
+						}
+					}
+				});
+            mTextToSpeech.setOnUtteranceProgressListener(mUtteranceProgressListener);
+            LogUtils.d(TAG, "【speekTTSList】已为TTS绑定播放进度监听器");
+        } else {
+            // TTS实例就绪 → 执行播放逻辑
+            if (listTTSSpeakTextBean != null && listTTSSpeakTextBean.size() > 0) {
+                LogUtils.d(TAG, "【speekTTSList】TTS实例就绪，语音队列数据有效，开始播放逻辑处理");
+                // 清理过期的悬浮窗 - 防止内存泄漏/重复添加
+                clearFloatWindow();
+
+                // ========== 修复1：添加悬浮窗权限检查，有权限才初始化悬浮窗，无权限则只播语音不崩溃 ==========
+                if (checkOverlayPermission()) {
+                    initWindow();
+                    LogUtils.d(TAG, "【speekTTSList】悬浮窗初始化并显示完成");
+                } else {
+                    LogUtils.d(TAG, "【speekTTSList】悬浮窗权限未授予，跳过悬浮窗显示，仅播放语音");
+                }
+
+                // 获取第一条语音的延迟时间并休眠
+                int nDelay = listTTSSpeakTextBean.get(0).mnDelay;
+                LogUtils.d(TAG, "【speekTTSList】获取播放延迟时间：" + nDelay + "ms，开始休眠等待");
+                try {
+                    Thread.sleep(nDelay);
+                } catch (InterruptedException e) {
+                    LogUtils.d(TAG, "【speekTTSList】休眠等待被中断", e);
+                }
+                LogUtils.d(TAG, "【speekTTSList】休眠等待完成，开始循环播放语音队列");
+
+                // 循环播放语音队列
+                for (int speakPosition = 0; speakPosition < listTTSSpeakTextBean.size() && !isExist; speakPosition++) {
+                    String szSpeakContent = listTTSSpeakTextBean.get(speakPosition).mszSpeakContent;
+                    isExist = (listTTSSpeakTextBean.size() - 2 < speakPosition);
+                    LogUtils.d(TAG, "【speekTTSList】播放索引：" + speakPosition + " | 播放文本：" + szSpeakContent + " | 当前退出标记位：" + isExist);
+
+                    // 第一条语音清空队列播放，后续语音追加播放
+                    if (speakPosition == 0) {
+                        mTextToSpeech.speak(szSpeakContent, TextToSpeech.QUEUE_FLUSH, null, UNIQUE_ID);
+                        LogUtils.d(TAG, "【speekTTSList】执行清空队列播放 → QUEUE_FLUSH");
+                    } else {
+                        mTextToSpeech.speak(szSpeakContent, TextToSpeech.QUEUE_ADD, null, UNIQUE_ID);
+                        LogUtils.d(TAG, "【speekTTSList】执行追加队列播放 → QUEUE_ADD");
+                    }
+                }
+                LogUtils.d(TAG, "【speekTTSList】语音队列循环播放逻辑执行完毕");
+            } else {
+                LogUtils.d(TAG, "【speekTTSList】语音队列为空/长度0，跳过播放逻辑");
+            }
+        }
+    }
+
+    // ====================================== 私有工具方法 - 初始化播放监听器 ======================================
+    private void initUtteranceProgressListener() {
+        LogUtils.d(TAG, "【initUtteranceProgressListener】初始化TTS播放进度监听器");
+        mUtteranceProgressListener = new UtteranceProgressListener() {
+            @Override
+            public void onStart(String utteranceId) {
+                LogUtils.d(TAG, "【onStart】TTS语音播放开始，唯一标识ID：" + utteranceId);
+            }
+
+            @Override
+            public void onDone(String utteranceId) {
+                LogUtils.d(TAG, "【onDone】TTS语音播放结束，唯一标识ID：" + utteranceId + " | 退出标志位：" + isExist);
+                // 播放完成 关闭悬浮窗
+                if (isExist && mWindowManager != null && mView != null) {
+                    LogUtils.d(TAG, "【onDone】满足关闭条件，执行悬浮窗移除操作");
+                    clearFloatWindow();
+                }
+            }
+
+            @Override
+            public void onError(String utteranceId) {
+                LogUtils.d(TAG, "【onError】TTS语音播放出错，唯一标识ID：" + utteranceId);
+            }
+        };
+    }
+
+    // ====================================== 私有核心方法 - 初始化并添加悬浮窗 【核心修复 根治崩溃】 ======================================
+    private void initWindow() {
+        LogUtils.d(TAG, "【initWindow】开始初始化播放悬浮窗");
+        // 创建Window布局参数
+        WindowManager.LayoutParams params = new WindowManager.LayoutParams();
+        // ========== 修复2 重中之重：Android 12(API31)+ 彻底废弃TYPE_PHONE，统一用TYPE_APPLICATION_OVERLAY 适配API36 ==========
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            params.type = WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY;
+            LogUtils.d(TAG, "【initWindow】系统版本>=API26，悬浮窗类型：TYPE_APPLICATION_OVERLAY");
+        } else {
+            // 仅低版本用TYPE_PHONE，高版本不再走这里
+            params.type = WindowManager.LayoutParams.TYPE_PHONE;
+            LogUtils.d(TAG, "【initWindow】系统版本<API26，悬浮窗类型：TYPE_PHONE");
+        }
+        // 悬浮窗样式配置
+        params.alpha = 0.9f;
+        params.gravity = Gravity.RIGHT | Gravity.BOTTOM;
+        params.x = 20;
+        params.y = 20;
+        params.format = PixelFormat.RGBA_8888;
+        params.width = WindowManager.LayoutParams.WRAP_CONTENT;
+        params.height = WindowManager.LayoutParams.WRAP_CONTENT;
+        // 核心Flag：无焦点+不阻塞触摸事件穿透
+        params.flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
+			| WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL;
+
+        // 加载悬浮窗布局
+        mView = View.inflate(mContext, R.layout.view_tts_back, null);
+        LinearLayout llMain = mView.findViewById(R.id.viewttsbackLinearLayout1);
+        llMain.setOnClickListener(new View.OnClickListener(){
+				@Override
+				public void onClick(View view) {
+					LogUtils.d(TAG, "【onClick】悬浮窗被点击，执行停止播放+关闭悬浮窗");
+					isExist = true;
+					if (mTextToSpeech != null) {
+						mTextToSpeech.stop();
+						LogUtils.d(TAG, "【onClick】已调用TTS.stop()停止播放");
+					}
+					clearFloatWindow();
+				}
+			});
+        // ========== 修复3：添加异常捕获+重复添加判断，防止addView时报错导致整个TTS播放崩溃 ==========
+        try {
+            if (mWindowManager != null && mView != null && mView.getWindowToken() == null) {
+                mWindowManager.addView(mView, params);
+                LogUtils.d(TAG, "【initWindow】悬浮窗添加到Window成功，布局加载完成");
+            }
+        } catch (Exception e) {
+            LogUtils.d(TAG, "【initWindow】悬浮窗添加异常(权限/系统限制)，不影响语音播放：", e);
+            mView = null;
+        }
+    }
+
+    // ====================================== 私有工具方法 - 清理悬浮窗 (通用封装) 【优化修复】 ======================================
+    private void clearFloatWindow() {
+        LogUtils.d(TAG, "【clearFloatWindow】执行悬浮窗清理操作");
+        if (mWindowManager != null && mView != null) {
+            try {
+                mWindowManager.removeView(mView);
+                LogUtils.d(TAG, "【clearFloatWindow】悬浮窗移除成功");
+            } catch (Exception e) {
+                LogUtils.d(TAG, "【clearFloatWindow】悬浮窗移除异常", e);
+            } finally {
+                mView = null;
+            }
+        } else {
+            LogUtils.d(TAG, "【clearFloatWindow】无需清理，WindowManager或View为空");
+        }
+    }
+
+    // ====================================== ✅ 新增：悬浮窗权限检查【必须】Android6.0+ 强制校验 防止崩溃 ✅ ======================================
+    private boolean checkOverlayPermission() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+            boolean hasPermission = android.provider.Settings.canDrawOverlays(mContext);
+            LogUtils.d(TAG, "【checkOverlayPermission】Android6.0+ 悬浮窗权限校验结果：" + hasPermission);
+            return hasPermission;
+        } else {
+            // 低版本默认有权限
+            return true;
+        }
+    }
+
+    // ====================================== ✅ 新增：释放资源方法【根治内存泄漏】建议在Service/Activity销毁时调用 ✅ ======================================
+    public void release() {
+        LogUtils.d(TAG, "【release】释放TTS资源和悬浮窗");
+        clearFloatWindow();
+        if (mTextToSpeech != null) {
+            mTextToSpeech.stop();
+            mTextToSpeech.shutdown();
+            mTextToSpeech = null;
+        }
+        sTextToSpeechUtils = null;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/UriUtils.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/UriUtils.java
new file mode 100644
index 0000000..8d83187
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/utils/UriUtils.java
@@ -0,0 +1,481 @@
+package cc.winboll.studio.powerbell.utils;
+
+import android.content.ContentResolver;
+import android.content.Context;
+import android.database.Cursor;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Environment;
+import android.provider.MediaStore;
+import androidx.core.content.FileProvider;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Uri 工具类（Java7兼容，适配API29-30+小米机型，FileProvider安全适配）
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2024/06/28
+ */
+public class UriUtils {
+    // ====================== 常量定义（顶部统一管理）======================
+    public static final String TAG = "UriUtils";
+    // FileProvider 授权后缀（与Manifest配置保持一致）
+    private static final String FILE_PROVIDER_SUFFIX = ".fileprovider";
+    // 应用公共图片目录（API29+ 适配，替代废弃API）
+    private static final String APP_PUBLIC_PIC_DIR = "PowerBell/";
+    // MIME类型与文件后缀映射表（覆盖常见格式，小米机型精准匹配）
+    private static final Map<String, String> MIME_SUFFIX_MAP = new HashMap<String, String>() {{
+			// 图片格式（重点，含透明格式）
+			put("image/png", "png");
+			put("image/jpeg", "jpg");
+			put("image/jpg", "jpg");
+			put("image/gif", "gif");
+			put("image/bmp", "bmp");
+			put("image/webp", "webp");
+			// 音视频格式
+			put("video/mp4", "mp4");
+			put("video/avi", "avi");
+			put("video/mkv", "mkv");
+			put("audio/mp3", "mp3");
+			put("audio/wav", "wav");
+			// 文档格式
+			put("application/pdf", "pdf");
+			put("application/msword", "doc");
+			put("application/vnd.openxmlformats-officedocument.wordprocessingml.document", "docx");
+			put("application/vnd.ms-excel", "xls");
+			put("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "xlsx");
+		}};
+
+    // ====================== 新增核心方法：Uri 转文件后缀 ======================
+    /**
+     * 【静态公共方法】根据 Uri 获取文件真实后缀（优先MIME类型匹配，适配所有Uri场景+小米机型）
+     * @param context 上下文（非空，用于获取ContentResolver）
+     * @param uri 待解析 Uri（支持 content:// / file:// 双Scheme）
+     * @return 小写文件后缀（如 png/jpg/mp4，无匹配返回空字符串）
+     */
+    public static String getSuffixFromUri(Context context, Uri uri) {
+        LogUtils.d(TAG, "=== getSuffixFromUri 调用 start，Uri：" + (uri != null ? uri.toString() : "null") + " ===");
+        // 1. 基础参数校验
+        if (context == null) {
+            LogUtils.e(TAG, "getSuffixFromUri：Context 为空，获取失败");
+            return "";
+        }
+        if (uri == null) {
+            LogUtils.e(TAG, "getSuffixFromUri：Uri 为空，获取失败");
+            return "";
+        }
+
+        String suffix = "";
+        String scheme = uri.getScheme();
+        // 2. 按 Uri Scheme 分类处理（优先精准匹配，再降级截取）
+        if (ContentResolver.SCHEME_CONTENT.equals(scheme)) {
+            // 场景1：content:// Uri（优先通过MIME类型获取，最精准）
+            suffix = getSuffixFromContentUri(context, uri);
+            LogUtils.d(TAG, "getSuffixFromUri：content:// Uri，MIME匹配后缀：" + suffix);
+        } else if (ContentResolver.SCHEME_FILE.equals(scheme)) {
+            // 场景2：file:// Uri（直接解析文件名截取后缀）
+            String filePath = new File(uri.getPath()).getAbsolutePath();
+            suffix = getSuffixFromFilePath(filePath);
+            LogUtils.d(TAG, "getSuffixFromUri：file:// Uri，路径截取后缀：" + suffix);
+        } else {
+            // 场景3：未知Scheme（尝试解析Uri路径截取，兜底）
+            String uriPath = uri.getPath();
+            suffix = uriPath != null ? getSuffixFromFilePath(uriPath) : "";
+            LogUtils.w(TAG, "getSuffixFromUri：未知Scheme=" + scheme + "，兜底截取后缀：" + suffix);
+        }
+
+        // 3. 最终结果处理（统一小写，去空）
+        suffix = suffix != null ? suffix.trim().toLowerCase() : "";
+        LogUtils.d(TAG, "=== getSuffixFromUri 调用 end，最终后缀：" + suffix + " ===");
+        return suffix;
+    }
+
+    // ====================== 公有核心方法（对外提供能力，按功能排序）======================
+    /**
+     * Uri 转真实文件路径（核心方法，适配 content:// / file:// 双 Scheme）
+     * @param context 上下文（非空）
+     * @param uri 待转换 Uri（非空）
+     * @return 真实文件绝对路径（转换失败返回 null）
+     */
+    public static String getFilePathFromUri(Context context, Uri uri) {
+        LogUtils.d(TAG, "=== getFilePathFromUri 调用 start ===");
+        if (context == null) {
+            LogUtils.e(TAG, "getFilePathFromUri：Context 为空，转换失败");
+            return null;
+        }
+        if (uri == null) {
+            LogUtils.e(TAG, "getFilePathFromUri：Uri 为空，转换失败");
+            return null;
+        }
+
+        String scheme = uri.getScheme();
+        String filePath = null;
+        // 按 Uri Scheme 分类处理
+        if (ContentResolver.SCHEME_CONTENT.equals(scheme)) {
+            LogUtils.d(TAG, "getFilePathFromUri：Scheme=content，执行ContentUri转换");
+            filePath = getFilePathFromContentUri(context, uri);
+        } else if (ContentResolver.SCHEME_FILE.equals(scheme)) {
+            LogUtils.d(TAG, "getFilePathFromUri：Scheme=file，直接转换路径");
+            filePath = new File(uri.getPath()).getAbsolutePath();
+        } else {
+            LogUtils.w(TAG, "getFilePathFromUri：未知Scheme=" + scheme + "，转换失败");
+        }
+
+        LogUtils.d(TAG, "=== getFilePathFromUri 调用 end，结果：" + filePath + " ===");
+        return filePath;
+    }
+
+    /**
+     * 文件路径转 Uri（核心方法，适配 Android7.0+ FileProvider，API29-30兼容）
+     * @param context 上下文（非空）
+     * @param filePath 真实文件路径（非空）
+     * @return 安全 Uri（转换失败返回 null）
+     */
+    public static Uri getUriForFile(Context context, String filePath) {
+        LogUtils.d(TAG, "=== getUriForFile（路径版）调用 start ===");
+        // 1. 基础参数校验
+        if (context == null) {
+            LogUtils.e(TAG, "getUriForFile：Context 为空，转换失败");
+            return null;
+        }
+        if (filePath == null || filePath.isEmpty()) {
+            LogUtils.e(TAG, "getUriForFile：文件路径为空，转换失败");
+            return null;
+        }
+
+        // 2. File 对象初始化与校验
+        File file = new File(filePath);
+        LogUtils.d(TAG, "getUriForFile：文件路径=" + file.getAbsolutePath() + "，是否存在=" + file.exists());
+        if (!file.exists() || file.isDirectory()) {
+            LogUtils.e(TAG, "getUriForFile：文件不存在或为目录，转换失败");
+            return null;
+        }
+
+        // 3. 合法路径校验（适配小米机型，避免FileProvider配置外路径）
+        if (!isPathInValidDir(context, file)) {
+            LogUtils.w(TAG, "getUriForFile：路径不在安全配置目录内，小米机型可能出现权限异常");
+        }
+
+        // 4. 调用重载方法生成 Uri
+        Uri uri = getUriForFile(context, file);
+        LogUtils.d(TAG, "=== getUriForFile（路径版）调用 end，结果：" + (uri != null ? uri.toString() : "null") + " ===");
+        return uri;
+    }
+
+    /**
+     * File 对象转 Uri（重载方法，直接接收File，内部安全适配）
+     * @param context 上下文（非空）
+     * @param file 待转换 File 对象（非空）
+     * @return 安全 Uri（转换失败返回 null）
+     */
+    public static Uri getUriForFile(Context context, File file) {
+        LogUtils.d(TAG, "=== getUriForFile（File版）调用 start ===");
+        // 1. 基础参数校验
+        if (context == null) {
+            LogUtils.e(TAG, "getUriForFile：Context 为空，转换失败");
+            return null;
+        }
+        if (file == null) {
+            LogUtils.e(TAG, "getUriForFile：File 对象为空，转换失败");
+            return null;
+        }
+        LogUtils.d(TAG, "getUriForFile：文件路径=" + file.getAbsolutePath() + "，是否存在=" + file.exists());
+        if (!file.exists() || file.isDirectory()) {
+            LogUtils.e(TAG, "getUriForFile：文件不存在或为目录，转换失败");
+            return null;
+        }
+
+        // 2. 按系统版本生成 Uri（API24+ 强制 FileProvider，适配小米机型）
+        Uri uri = null;
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+            LogUtils.d(TAG, "getUriForFile：Android7.0+，使用FileProvider生成Uri");
+            String authority = context.getPackageName() + FILE_PROVIDER_SUFFIX;
+            LogUtils.d(TAG, "getUriForFile：FileProvider Authority=" + authority);
+            try {
+                uri = FileProvider.getUriForFile(context, authority, file);
+                LogUtils.d(TAG, "getUriForFile：Content Uri生成成功=" + uri.toString());
+            } catch (IllegalArgumentException e) {
+                LogUtils.e(TAG, "getUriForFile：FileProvider生成失败（小米机型常见原因：路径未配置/Authority不匹配）", e);
+            }
+        } else {
+            LogUtils.d(TAG, "getUriForFile：Android7.0以下，使用Uri.fromFile生成");
+            uri = Uri.fromFile(file);
+            LogUtils.d(TAG, "getUriForFile：File Uri生成成功=" + uri.toString());
+        }
+
+        LogUtils.d(TAG, "=== getUriForFile（File版）调用 end ===");
+        return uri;
+    }
+
+    // ====================== 私有辅助方法（内部逻辑封装，不对外暴露）======================
+    /**
+     * ContentUri 转真实路径（适配 content:// 格式，处理小米机型特殊Uri）
+     * @param context 上下文
+     * @param uri ContentUri（如：content://media/external/file/xxx）
+     * @return 真实文件路径（失败返回 null）
+     */
+    private static String getFilePathFromContentUri(Context context, Uri uri) {
+        LogUtils.d(TAG, "getFilePathFromContentUri：Uri=" + uri.toString());
+        String filePath = null;
+        Cursor cursor = null;
+        // Java7 语法：try-catch-finally 手动关闭Cursor，避免内存泄漏
+        try {
+            // 查询字段：优先 DATA 字段，失败则通过文件名+流拷贝获取
+            String[] queryColumns = {MediaStore.MediaColumns.DATA, MediaStore.MediaColumns.DISPLAY_NAME};
+            cursor = context.getContentResolver().query(uri, queryColumns, null, null, null);
+            if (cursor != null && cursor.moveToFirst()) {
+                // 优先读取 DATA 字段（直接获取路径）
+                int dataIndex = cursor.getColumnIndex(MediaStore.MediaColumns.DATA);
+                if (dataIndex != -1) {
+                    filePath = cursor.getString(dataIndex);
+                    LogUtils.d(TAG, "getFilePathFromContentUri：从DATA字段获取路径=" + filePath);
+                } else {
+                    // DATA 字段为空，通过流拷贝到私有目录获取路径（小米机型特殊场景适配）
+                    int nameIndex = cursor.getColumnIndex(MediaStore.MediaColumns.DISPLAY_NAME);
+                    String fileName = cursor.getString(nameIndex);
+                    LogUtils.d(TAG, "getFilePathFromContentUri：DATA字段为空，通过流拷贝获取，文件名=" + fileName);
+                    filePath = getPathFromInputStreamUri(context, uri, fileName);
+                }
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getFilePathFromContentUri：查询失败", e);
+        } finally {
+            // 强制关闭Cursor，避免资源泄漏（Java7 必须手动处理）
+            if (cursor != null) {
+                try {
+                    cursor.close();
+                } catch (Exception e) {
+                    LogUtils.e(TAG, "getFilePathFromContentUri：关闭Cursor失败", e);
+                }
+            }
+        }
+        return filePath;
+    }
+
+    /**
+     * 流拷贝获取路径（适配无 DATA 字段的 ContentUri，小米机型特殊Uri兼容）
+     * 将目标文件拷贝到应用私有缓存目录，返回拷贝后的路径
+     * @param context 上下文
+     * @param uri ContentUri
+     * @param fileName 文件名
+     * @return 拷贝后的文件路径（失败返回 null）
+     */
+    private static String getPathFromInputStreamUri(Context context, Uri uri, String fileName) {
+        LogUtils.d(TAG, "getPathFromInputStreamUri：开始流拷贝，文件名=" + fileName);
+        InputStream inputStream = null;
+        OutputStream outputStream = null;
+        File targetFile = null;
+        try {
+            // 1. 打开输入流（读取Uri对应文件）
+            inputStream = context.getContentResolver().openInputStream(uri);
+            if (inputStream == null) {
+                LogUtils.e(TAG, "getPathFromInputStreamUri：输入流打开失败");
+                return null;
+            }
+
+            // 2. 创建目标文件（应用私有缓存目录，无权限限制）
+            targetFile = new File(context.getExternalCacheDir(), fileName);
+            // 若文件已存在，先删除（避免覆盖导致格式异常）
+            if (targetFile.exists()) {
+                boolean deleteSuccess = targetFile.delete();
+                LogUtils.d(TAG, "getPathFromInputStreamUri：删除已存在文件，结果=" + deleteSuccess);
+            }
+
+            // 3. 流拷贝（Java7 手动处理流，避免 try-with-resources）
+            outputStream = new FileOutputStream(targetFile);
+            byte[] buffer = new byte[8 * 1024]; // 8KB 缓冲区，平衡效率与内存
+            int readLength;
+            while ((readLength = inputStream.read(buffer)) != -1) {
+                outputStream.write(buffer, 0, readLength);
+            }
+            outputStream.flush();
+            LogUtils.d(TAG, "getPathFromInputStreamUri：流拷贝成功，路径=" + targetFile.getAbsolutePath());
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getPathFromInputStreamUri：流拷贝失败", e);
+            // 拷贝失败，删除临时文件
+            if (targetFile != null && targetFile.exists()) {
+                targetFile.delete();
+            }
+            targetFile = null;
+        } finally {
+            // 强制关闭流，避免资源泄漏（Java7 必须手动关闭）
+            try {
+                if (outputStream != null) {
+                    outputStream.close();
+                }
+            } catch (IOException e) {
+                LogUtils.e(TAG, "getPathFromInputStreamUri：关闭输出流失败", e);
+            }
+            try {
+                if (inputStream != null) {
+                    inputStream.close();
+                }
+            } catch (IOException e) {
+                LogUtils.e(TAG, "getPathFromInputStreamUri：关闭输入流失败", e);
+            }
+        }
+        return targetFile != null ? targetFile.getAbsolutePath() : null;
+    }
+
+    /**
+     * 校验路径是否在安全目录内（适配API29-30+小米机型，避免FileProvider权限异常）
+     * 仅允许：应用私有目录、缓存目录、应用专属公共目录
+     * @param context 上下文
+     * @param file 待校验文件
+     * @return true=安全路径，false=非安全路径
+     */
+    private static boolean isPathInValidDir(Context context, File file) {
+        String absolutePath = file.getAbsolutePath();
+        // 1. 应用外部私有目录（API29+ 推荐，无权限限制）
+        String externalPrivateDir = context.getExternalFilesDir(null) != null 
+			? context.getExternalFilesDir(null).getAbsolutePath() 
+			: "";
+        // 2. 应用内部私有目录（无权限限制）
+        String internalPrivateDir = context.getFilesDir().getAbsolutePath();
+        // 3. 应用缓存目录（无权限限制）
+        String cacheDir = context.getCacheDir().getAbsolutePath();
+        // 4. 应用专属公共目录（API29+ 适配，替代废弃的 getExternalStoragePublicDirectory）
+        String appPublicDir = Environment.getExternalStorageDirectory().getAbsolutePath() 
+			+ File.separator + Environment.DIRECTORY_PICTURES 
+			+ File.separator + APP_PUBLIC_PIC_DIR;
+
+        // 校验路径是否在安全目录内（小米机型必须严格校验，否则FileProvider会抛异常）
+        boolean isInValidDir = absolutePath.startsWith(externalPrivateDir)
+			|| absolutePath.startsWith(internalPrivateDir)
+			|| absolutePath.startsWith(cacheDir)
+			|| absolutePath.startsWith(appPublicDir);
+
+        LogUtils.d(TAG, "isPathInValidDir：外部私有目录=" + externalPrivateDir 
+				   + "，公共目录=" + appPublicDir 
+				   + "，校验结果=" + isInValidDir);
+        return isInValidDir;
+    }
+
+    /**
+     * 流拷贝创建临时文件（内部辅助，封装拷贝逻辑）
+     * @param context 上下文
+     * @param inputStream 输入流
+     * @param fileName 文件名
+     * @return 临时文件（失败返回 null）
+     * @throws IOException 流操作异常
+     */
+    private static File createTemporalFileFrom(Context context, InputStream inputStream, String fileName) throws IOException {
+        File targetFile = null;
+        if (inputStream != null) {
+            byte[] buffer = new byte[8 * 1024];
+            int readLength;
+            targetFile = new File(context.getExternalCacheDir(), fileName);
+            if (targetFile.exists()) {
+                targetFile.delete();
+            }
+            OutputStream outputStream = new FileOutputStream(targetFile);
+            while ((readLength = inputStream.read(buffer)) != -1) {
+                outputStream.write(buffer, 0, readLength);
+            }
+            outputStream.flush();
+            outputStream.close();
+        }
+        return targetFile;
+    }
+
+    /**
+     * 辅助：ContentUri 通过 MIME 类型获取后缀（精准匹配，不受文件名伪造影响）
+     * @param context 上下文
+     * @param uri ContentUri
+     * @return 匹配的后缀（无匹配返回空字符串）
+     */
+    private static String getSuffixFromContentUri(Context context, Uri uri) {
+        String mime = null;
+        try {
+            // 通过 ContentResolver 获取 Uri 对应的 MIME 类型（系统级匹配，最精准）
+            mime = context.getContentResolver().getType(uri);
+            LogUtils.d(TAG, "getSuffixFromContentUri：获取MIME类型=" + mime);
+            if (mime == null || mime.isEmpty()) {
+                // MIME 为空，尝试解析文件名兜底
+                String fileName = getFileNameFromContentUri(context, uri);
+                return getSuffixFromFilePath(fileName);
+            }
+            // MIME 类型匹配后缀（优先完全匹配，再模糊匹配）
+            if (MIME_SUFFIX_MAP.containsKey(mime)) {
+                return MIME_SUFFIX_MAP.get(mime);
+            }
+            // 模糊匹配（如 image/* 匹配通用图片后缀，默认png）
+            if (mime.startsWith("image/")) {
+                return "png";
+            } else if (mime.startsWith("video/")) {
+                return "mp4";
+            } else if (mime.startsWith("audio/")) {
+                return "mp3";
+            } else if (mime.startsWith("application/")) {
+                return "pdf";
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getSuffixFromContentUri：MIME解析失败，mime=" + mime, e);
+        }
+        // 所有方式失败，解析Uri路径兜底
+        return getSuffixFromFilePath(uri.getPath());
+    }
+
+    /**
+     * 辅助：从 ContentUri 获取文件名（MIME 解析失败时兜底）
+     * @param context 上下文
+     * @param uri ContentUri
+     * @return 文件名（失败返回空字符串）
+     */
+    private static String getFileNameFromContentUri(Context context, Uri uri) {
+        Cursor cursor = null;
+        try {
+            String[] queryColumns = {MediaStore.MediaColumns.DISPLAY_NAME};
+            cursor = context.getContentResolver().query(uri, queryColumns, null, null, null);
+            if (cursor != null && cursor.moveToFirst()) {
+                int nameIndex = cursor.getColumnIndex(MediaStore.MediaColumns.DISPLAY_NAME);
+                return cursor.getString(nameIndex);
+            }
+        } catch (Exception e) {
+            LogUtils.e(TAG, "getFileNameFromContentUri：查询失败", e);
+        } finally {
+            if (cursor != null) {
+                try {
+                    cursor.close();
+                } catch (Exception e) {
+                    LogUtils.e(TAG, "getFileNameFromContentUri：关闭Cursor失败", e);
+                }
+            }
+        }
+        return "";
+    }
+
+    /**
+     * 辅助：从文件路径/文件名截取后缀（兜底方案，处理各种路径格式）
+     * @param path 文件路径/文件名
+     * @return 截取的后缀（无后缀返回空字符串）
+     */
+    private static String getSuffixFromFilePath(String path) {
+        if (path == null || path.isEmpty()) {
+            return "";
+        }
+        // 处理路径中的分隔符（兼容 Windows/Android 路径格式）
+        path = path.replace("\\", "/");
+        // 取最后一个 "/" 后的文件名（避免路径包含 "." 导致误判）
+        int lastSepIndex = path.lastIndexOf("/");
+        if (lastSepIndex != -1 && lastSepIndex < path.length() - 1) {
+            path = path.substring(lastSepIndex + 1);
+        }
+        // 截取最后一个 "." 后的后缀（过滤无后缀/点开头/点结尾场景）
+        int lastDotIndex = path.lastIndexOf(".");
+        if (lastDotIndex == -1 || lastDotIndex == 0 || lastDotIndex == path.length() - 1) {
+            return "";
+        }
+        // 过滤后缀中的非法字符（仅保留字母/数字，避免特殊字符干扰）
+        String suffix = path.substring(lastDotIndex + 1).replaceAll("[^a-zA-Z0-9]", "");
+        // 限制后缀长度（1-5位，避免超长伪造后缀）
+        return suffix.length() >= 1 && suffix.length() <= 5 ? suffix : "";
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BackgroundView.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BackgroundView.java
new file mode 100644
index 0000000..2bb8f24
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BackgroundView.java
@@ -0,0 +1,343 @@
+package cc.winboll.studio.powerbell.views;
+
+import android.content.Context;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.Canvas;
+import android.graphics.drawable.BitmapDrawable;
+import android.graphics.drawable.Drawable;
+import android.text.TextUtils;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.RelativeLayout;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+import cc.winboll.studio.powerbell.utils.ImageUtils;
+import java.io.File;
+
+/**
+ * 基于Java7的BackgroundView（LinearLayout+ImageView，保持原图比例居中平铺）
+ * 核心：ImageView保持原图比例，在LinearLayout中居中平铺，无拉伸、无裁剪、无压缩
+ * 改进：强制保持缓存策略，无论内存是否紧张，不自动清理任何缓存，保留图片原始品质
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class BackgroundView extends RelativeLayout {
+    // ====================================== 静态常量区（首屏可见，统一管理） ======================================
+    public static final String TAG = "BackgroundView";
+    // Bitmap 配置常量（原始品质）
+    private static final Bitmap.Config BITMAP_CONFIG = Bitmap.Config.ARGB_8888;
+    private static final int BITMAP_SAMPLE_SIZE = 1; // 不缩放采样率
+
+    // ====================================== 成员变量区（按功能分类：上下文→视图→缓存→图片属性） ======================================
+    // 上下文
+    private Context mContext;
+    // 视图组件
+    private LinearLayout mLlContainer;    // 主容器LinearLayout
+    private ImageView mIvBackground;      // 图片显示控件
+    // 缓存相关
+    private String mCurrentCachedPath = "";// 当前缓存图片路径
+    // 图片属性
+    private float mImageAspectRatio = 1.0f;// 原图宽高比（宽/高）
+    private int mBgColor = 0xFFFFFFFF;    // 当前图片背景色
+
+    // ====================================== 构造器（Java7兼容，按参数重载顺序排列） ======================================
+    public BackgroundView(Context context) {
+        super(context);
+        LogUtils.d(TAG, String.format("【构造器1】启动 | context=%s", context.getClass().getSimpleName()));
+        this.mContext = context;
+        initView();
+    }
+
+    public BackgroundView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        LogUtils.d(TAG, String.format("【构造器2】启动 | context=%s", context.getClass().getSimpleName()));
+        this.mContext = context;
+        initView();
+    }
+
+    public BackgroundView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        LogUtils.d(TAG, String.format("【构造器3】启动 | context=%s", context.getClass().getSimpleName()));
+        this.mContext = context;
+        initView();
+    }
+
+    // ====================================== 初始化方法（按执行顺序：主视图→子容器→图片控件→默认背景） ======================================
+    private void initView() {
+        LogUtils.d(TAG, "【initView】启动");
+        // 1. 配置当前控件：全屏+透明
+        setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
+        // 2. 初始化主容器LinearLayout
+        initLinearLayout();
+        // 3. 初始化ImageView
+        initImageView();
+        // 4. 初始设置透明背景
+        setDefaultEmptyBackground();
+        LogUtils.d(TAG, "【initView】完成");
+    }
+
+    private void initLinearLayout() {
+        LogUtils.d(TAG, "【initLinearLayout】启动");
+        mLlContainer = new LinearLayout(mContext);
+        LinearLayout.LayoutParams llParams = new LinearLayout.LayoutParams(
+			LinearLayout.LayoutParams.MATCH_PARENT,
+			LinearLayout.LayoutParams.MATCH_PARENT
+        );
+        mLlContainer.setLayoutParams(llParams);
+        mLlContainer.setOrientation(LinearLayout.VERTICAL);
+        mLlContainer.setGravity(android.view.Gravity.CENTER);
+        this.addView(mLlContainer);
+        LogUtils.d(TAG, "【initLinearLayout】完成");
+    }
+
+    private void initImageView() {
+        LogUtils.d(TAG, "【initImageView】启动");
+        mIvBackground = new ImageView(mContext);
+        LinearLayout.LayoutParams ivParams = new LinearLayout.LayoutParams(
+			LinearLayout.LayoutParams.WRAP_CONTENT,
+			LinearLayout.LayoutParams.WRAP_CONTENT
+        );
+        mIvBackground.setLayoutParams(ivParams);
+        mIvBackground.setScaleType(ImageView.ScaleType.FIT_CENTER);
+        mLlContainer.addView(mIvBackground);
+        LogUtils.d(TAG, "【initImageView】完成");
+    }
+
+    // ====================================== 对外公开方法（按功能分类：Bean加载→图片加载） ======================================
+    public void loadByBackgroundBean(BackgroundBean bean) {
+        loadByBackgroundBean(bean, false);
+    }
+
+    public void loadByBackgroundBean(BackgroundBean bean, boolean isRefresh) {
+        LogUtils.d(TAG, String.format("【loadByBackgroundBean】启动 | isRefresh=%b | bean=%s", isRefresh, bean));
+        // 参数校验
+        if (bean == null) {
+            LogUtils.e(TAG, "【loadByBackgroundBean】异常：BackgroundBean为空");
+            setDefaultEmptyBackground();
+            return;
+        }
+
+        // 设置图片背景色
+        mBgColor = bean.getPixelColor();
+        LogUtils.d(TAG, String.format("【loadByBackgroundBean】背景色设置为 0x%08X", mBgColor));
+
+        // 判断是否使用背景文件
+        if (!bean.isUseBackgroundFile()) {
+            LogUtils.d(TAG, "【loadByBackgroundBean】不使用背景文件，设置透明背景");
+            setDefaultEmptyBackground();
+            return;
+        }
+
+        // 获取目标路径
+        String targetPath = bean.isUseBackgroundScaledCompressFile()
+			? bean.getBackgroundScaledCompressFilePath()
+			: bean.getBackgroundFilePath();
+        LogUtils.d(TAG, String.format("【loadByBackgroundBean】目标路径=%s | 使用压缩文件=%b",
+									  targetPath, bean.isUseBackgroundScaledCompressFile()));
+
+        // 校验文件是否存在
+        File targetFile = new File(targetPath);
+        if (!targetFile.exists() || !targetFile.isFile()) {
+            LogUtils.e(TAG, String.format("【loadByBackgroundBean】异常：图片文件不存在 | path=%s", targetPath));
+            setDefaultEmptyBackground();
+            return;
+        }
+
+        loadImage(mBgColor, targetPath, isRefresh);
+    }
+
+    public void loadImage(int bgColor, String imagePath, boolean isRefresh) {
+        LogUtils.d(TAG, String.format("【loadImage】启动 | bgColor=0x%08X | imagePath=%s | isRefresh=%b",
+									  bgColor, imagePath, isRefresh));
+        // 隐藏ImageView防止闪烁
+        mIvBackground.setVisibility(View.GONE);
+
+        // 刷新逻辑：重新解码原始品质图片并更新缓存
+        if (isRefresh) {
+            LogUtils.d(TAG, "【loadImage】执行刷新逻辑：重新解码原始品质图片");
+            File imageFile = new File(imagePath);
+            Bitmap newBitmap = decodeOriginalBitmap(imageFile);
+            LogUtils.d(TAG, String.format("【loadImage】原始图片解码完成 | newBitmap=%s",
+										  newBitmap != null ? newBitmap.getWidth() + "x" + newBitmap.getHeight() : "null"));
+
+            // 合成纯色背景图片（使用配置文件中默认相框尺寸）
+            Bitmap combinedBitmap = ImageUtils.drawBitmapOnSolidBackground(
+				bgColor,
+				App.sAppConfigUtils.mAppConfigBean.getDefaultFrameWidth(),
+				App.sAppConfigUtils.mAppConfigBean.getDefaultFrameHeight(),
+				newBitmap
+            );
+
+            if (combinedBitmap == null) {
+                LogUtils.e(TAG, "【loadImage】纯色背景合成失败，使用原始Bitmap");
+                combinedBitmap = newBitmap;
+            } else {
+                LogUtils.d(TAG, String.format("【loadImage】纯色背景合成成功 | combinedBitmap=%dx%d",
+											  combinedBitmap.getWidth(), combinedBitmap.getHeight()));
+                // 回收原始Bitmap（避免重复缓存）
+                if (newBitmap != null && !newBitmap.isRecycled() && newBitmap != combinedBitmap) {
+                    newBitmap.recycle();
+                    LogUtils.d(TAG, "【loadImage】原始Bitmap已回收");
+                }
+            }
+
+            // 更新缓存
+            if (combinedBitmap != null) {
+                App.sBitmapCacheUtils.cacheBitmap(imagePath, combinedBitmap);
+                App.sBitmapCacheUtils.increaseRefCount(imagePath);
+                mCurrentCachedPath = imagePath;
+                LogUtils.d(TAG, String.format("【loadImage】刷新缓存成功 | path=%s", imagePath));
+            } else {
+                LogUtils.e(TAG, String.format("【loadImage】刷新解码失败 | path=%s", imagePath));
+            }
+        }
+
+        // 加载缓存图片
+        Bitmap cachedBitmap = App.sBitmapCacheUtils.getCachedBitmap(imagePath);
+        LogUtils.d(TAG, String.format("【loadImage】加载缓存图片 | cachedBitmap=%s",
+									  cachedBitmap != null ? cachedBitmap.getWidth() + "x" + cachedBitmap.getHeight() : "null"));
+        mIvBackground.setImageBitmap(cachedBitmap);
+        mIvBackground.setScaleType(ImageView.ScaleType.FIT_CENTER);
+        mIvBackground.setVisibility(View.VISIBLE);
+        LogUtils.d(TAG, "【loadImage】完成");
+    }
+
+    // ====================================== 内部工具方法（按功能分类：Bitmap校验→比例计算→解码→背景设置） ======================================
+    /**
+     * 工具方法：判断Bitmap是否有效（非空且未被回收）
+     */
+    private boolean isBitmapValid(Bitmap bitmap) {
+        boolean valid = bitmap != null && !bitmap.isRecycled();
+        if (!valid) {
+            LogUtils.w(TAG, "【isBitmapValid】无效：Bitmap为空或已回收");
+        }
+        return valid;
+    }
+
+    /**
+     * 计算图片宽高比
+     */
+    private boolean calculateImageAspectRatio(File file) {
+        LogUtils.d(TAG, String.format("【calculateImageAspectRatio】启动 | file=%s", file.getAbsolutePath()));
+        try {
+            BitmapFactory.Options options = new BitmapFactory.Options();
+            options.inJustDecodeBounds = true;
+            BitmapFactory.decodeFile(file.getAbsolutePath(), options);
+
+            // 尺寸校验
+            int width = options.outWidth;
+            int height = options.outHeight;
+            if (width <= 0 || height <= 0) {
+                LogUtils.e(TAG, String.format("【calculateImageAspectRatio】无效尺寸 | width=%d | height=%d", width, height));
+                return false;
+            }
+
+            // 计算比例
+            mImageAspectRatio = (float) width / height;
+            LogUtils.d(TAG, String.format("【calculateImageAspectRatio】完成 | 比例=%.2f", mImageAspectRatio));
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("【calculateImageAspectRatio】失败：%s", e.getMessage()));
+            return false;
+        }
+    }
+
+    /**
+     * 移除压缩逻辑：解码原始品质图片（无缩放、无色彩损失）
+     */
+    private Bitmap decodeOriginalBitmap(File file) {
+        LogUtils.d(TAG, String.format("【decodeOriginalBitmap】启动 | file=%s", file.getAbsolutePath()));
+        try {
+            BitmapFactory.Options options = new BitmapFactory.Options();
+            // 核心配置：原始品质
+            options.inSampleSize = BITMAP_SAMPLE_SIZE;
+            options.inPreferredConfig = BITMAP_CONFIG;
+            options.inPurgeable = false;
+            options.inInputShareable = false;
+            options.inDither = true;
+            options.inScaled = false;
+
+            // 解码图片
+            Bitmap bitmap = BitmapFactory.decodeFile(file.getAbsolutePath(), options);
+            if (bitmap != null) {
+                LogUtils.d(TAG, String.format("【decodeOriginalBitmap】成功 | width=%d | height=%d", bitmap.getWidth(), bitmap.getHeight()));
+            } else {
+                LogUtils.e(TAG, "【decodeOriginalBitmap】失败：返回null");
+            }
+            return bitmap;
+        } catch (Exception e) {
+            LogUtils.e(TAG, String.format("【decodeOriginalBitmap】异常：%s", e.getMessage()));
+            return null;
+        }
+    }
+
+    /**
+     * 设置默认透明背景，仅减少引用计数，不删除缓存
+     */
+    private void setDefaultEmptyBackground() {
+        LogUtils.d(TAG, "【setDefaultEmptyBackground】启动");
+        // 清空ImageView
+        mIvBackground.setImageDrawable(null);
+        mImageAspectRatio = 1.0f;
+
+        // 减少引用计数，不删除缓存
+        if (!TextUtils.isEmpty(mCurrentCachedPath)) {
+            LogUtils.d(TAG, String.format("【setDefaultEmptyBackground】减少引用计数 | path=%s", mCurrentCachedPath));
+            App.sBitmapCacheUtils.decreaseRefCount(mCurrentCachedPath);
+            mCurrentCachedPath = "";
+        }
+        LogUtils.d(TAG, "【setDefaultEmptyBackground】完成");
+    }
+
+    // ====================================== 重写生命周期方法（按执行顺序：绘制→尺寸变化→窗口分离） ======================================
+    /**
+     * 重写：绘制前强制校验Bitmap有效性，防止已回收Bitmap崩溃
+     */
+    @Override
+    protected void onDraw(Canvas canvas) {
+        Drawable drawable = mIvBackground.getDrawable();
+        if (drawable instanceof BitmapDrawable) {
+            BitmapDrawable bitmapDrawable = (BitmapDrawable) drawable;
+            Bitmap bitmap = bitmapDrawable.getBitmap();
+            if (!isBitmapValid(bitmap)) {
+                LogUtils.e(TAG, "【onDraw】检测到已回收Bitmap，清空绘制");
+                mIvBackground.setImageDrawable(null);
+                return;
+            }
+        }
+        super.onDraw(canvas);
+    }
+
+    /**
+     * 重写：恢复尺寸调整逻辑，确保View尺寸变化时正确显示（无压缩）
+     */
+    @Override
+    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
+        super.onSizeChanged(w, h, oldw, oldh);
+        LogUtils.d(TAG, String.format("【onSizeChanged】尺寸变化 | newW=%d | newH=%d | oldW=%d | oldH=%d", w, h, oldw, oldh));
+    }
+
+    /**
+     * 重写：View从窗口移除时仅减少引用计数，不删除全局缓存（强制保持策略）
+     */
+    @Override
+    protected void onDetachedFromWindow() {
+        super.onDetachedFromWindow();
+        LogUtils.d(TAG, "【onDetachedFromWindow】启动");
+        // 清空ImageView的Drawable，释放本地引用
+        mIvBackground.setImageDrawable(null);
+
+        // 减少引用计数，不删除全局缓存
+        if (!TextUtils.isEmpty(mCurrentCachedPath)) {
+            LogUtils.d(TAG, String.format("【onDetachedFromWindow】减少引用计数 | path=%s", mCurrentCachedPath));
+            App.sBitmapCacheUtils.decreaseRefCount(mCurrentCachedPath);
+            mCurrentCachedPath = "";
+        }
+        LogUtils.d(TAG, "【onDetachedFromWindow】完成");
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BatteryDrawable.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BatteryDrawable.java
new file mode 100644
index 0000000..2a5e4f3
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BatteryDrawable.java
@@ -0,0 +1,298 @@
+package cc.winboll.studio.powerbell.views;
+
+import android.graphics.Canvas;
+import android.graphics.ColorFilter;
+import android.graphics.Paint;
+import android.graphics.PixelFormat;
+import android.graphics.Rect;
+import android.graphics.drawable.Drawable;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.models.BatteryStyle;
+
+/**
+ * 电池电量Drawable：适配API30，兼容小米机型，支持能量/条纹两种绘制风格切换
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/17 12:55
+ */
+public class BatteryDrawable extends Drawable {
+    // ====================================== 静态常量区（按功能归类，消除魔法值） ======================================
+    public static final String TAG = "BatteryDrawable";
+    // 小米机型绘制偏移校准（适配MIUI渲染特性，避免绘制错位）
+    private static final int MIUI_DRAW_OFFSET = 1;
+    // 默认电量透明度（兼顾显示效果与API30渲染性能）
+    private static final int DEFAULT_BATTERY_ALPHA = 210;
+    // 电量范围常量
+    private static final int BATTERY_MIN = 0;
+    private static final int BATTERY_MAX = 100;
+    // 条纹风格拆分数量
+    private static final int STRIPE_COUNT = 100;
+
+    // ====================================== 成员变量区（final优先，按功能归类） ======================================
+    // 绘制画笔（final修饰，避免重复创建，提升性能）
+    private final Paint mBatteryPaint;
+    // 业务控制变量
+    private int mBatteryValue = -1; // 当前电量（0-100，-1=未初始化）
+    private BatteryStyle mBatteryStyle = BatteryStyle.ENERGY_STYLE; // 绘制风格（true=能量，false=条纹）
+
+    // ====================================== 构造方法（重载适配，优先暴露常用构造） ======================================
+    /**
+     * 构造方法（默认能量风格，常用场景）
+     * @param batteryColor 电量显示颜色
+     */
+    public BatteryDrawable(int batteryColor) {
+        LogUtils.d(TAG, "【BatteryDrawable】构造器1调用 | 能量风格 | 颜色=" + Integer.toHexString(batteryColor));
+        mBatteryPaint = new Paint();
+        initPaintConfig(batteryColor);
+    }
+
+    /**
+     * 构造方法（支持指定绘制风格，扩展场景）
+     * @param batteryColor 电量显示颜色
+     * @param isEnergyStyle 是否启用能量风格
+     */
+    public BatteryDrawable(int batteryColor, BatteryStyle batteryStyle) {
+        mBatteryPaint = new Paint();
+        mBatteryStyle = batteryStyle;
+        initPaintConfig(batteryColor);
+    }
+
+	public void setIsEnergyStyle(BatteryStyle batteryStyle) {
+		this.mBatteryStyle = batteryStyle;
+	}
+
+    // ====================================== 私有初始化方法（封装复用，隐藏内部逻辑） ======================================
+    /**
+     * 初始化画笔配置（适配API30渲染特性，优化小米机型兼容性）
+     * @param color 电量显示颜色
+     */
+    private void initPaintConfig(int color) {
+        LogUtils.d(TAG, "【initPaintConfig】画笔配置开始 | 颜色=" + Integer.toHexString(color));
+        mBatteryPaint.setColor(color);
+        mBatteryPaint.setAlpha(DEFAULT_BATTERY_ALPHA);
+        mBatteryPaint.setAntiAlias(true); // 抗锯齿，解决小米低分辨率锯齿问题
+        mBatteryPaint.setStyle(Paint.Style.FILL); // 固定填充模式，避免混乱
+        mBatteryPaint.setDither(false); // 禁用抖动，提升API30颜色显示一致性
+        LogUtils.d(TAG, "【initPaintConfig】画笔配置完成");
+    }
+
+    // ====================================== 核心绘制方法（Drawable抽象方法，优先级最高） ======================================
+    @Override
+    public void draw(Canvas canvas) {
+		// 未初始化/异常电量，直接跳过，避免无效绘制
+        if (mBatteryValue < 0) {
+            LogUtils.w(TAG, "【draw】电量未初始化，跳过绘制");
+            return;
+        }
+        // 强制校准电量范围（0-100），防止异常值导致绘制错误
+        int validBattery = Math.max(BATTERY_MIN, Math.min(mBatteryValue, BATTERY_MAX));
+        LogUtils.d(TAG, "【draw】电量校准完成 | 有效电量=" + validBattery);
+
+        Rect drawBounds = getBounds();
+        // 绘制边界空指针防护
+        if (drawBounds == null) {
+            LogUtils.e(TAG, "【draw】绘制边界为空，跳过绘制");
+            return;
+        }
+        int drawHeight = drawBounds.height();
+
+        // 小米机型绘制偏移校准（解决MIUI系统渲染偏移问题）
+        int offset = MIUI_DRAW_OFFSET;
+        int left = drawBounds.left + offset;
+        int right = drawBounds.right - offset;
+        LogUtils.d(TAG, "【draw】绘制参数校准 | 左边界=" + left + " | 右边界=" + right + " | 高度=" + drawHeight);
+
+        // 按风格执行绘制
+        if (mBatteryStyle == BatteryStyle.ENERGY_STYLE) {
+            drawEnergyStyle(canvas, validBattery, left, right, drawHeight);
+        } else if (mBatteryStyle == BatteryStyle.ZEBRA_STYLE) {
+            drawZebraStyle(canvas, validBattery, left, right, drawHeight);
+        } else if (mBatteryStyle == BatteryStyle.POINT_STYLE) {
+            drawPointStyle(canvas, validBattery, left, right, drawHeight);
+        }
+        LogUtils.d(TAG, "【draw】绘制完成");
+    }
+
+    // ====================================== 绘制风格实现（私有封装，按风格拆分） ======================================
+    /**
+     * 能量风格绘制（整块填充，高效简洁，默认风格）
+     * @param canvas 绘制画布
+     * @param battery 有效电量（0-100）
+     * @param left 左边界
+     * @param right 右边界
+     * @param height 绘制高度
+     */
+    private void drawEnergyStyle(Canvas canvas, int battery, int left, int right, int height) {
+        LogUtils.d(TAG, "【drawEnergyStyle】能量风格绘制开始 | 电量=" + battery);
+//        int top = height - (height * battery / BATTERY_MAX); // 计算电量对应顶部坐标
+//        canvas.drawRect(new Rect(left, top, right, height), mBatteryPaint);
+//        LogUtils.d(TAG, "【drawEnergyStyle】能量风格绘制完成 | 顶部坐标=" + top);
+		int nWidth = getBounds().width();
+        int nHeight = getBounds().height();
+        int mnDx = nHeight / 203;
+
+        // 绘制耗电电量提醒值电量
+        // 能量绘图风格
+        int nTop;
+        int nLeft    = 0;
+        int nBottom;
+        int nRight  = nWidth;
+
+        //for (int i = 0; i < mnValue; i ++) {
+        nBottom = nHeight;
+        nTop = nHeight - (nHeight * mBatteryValue / 100);
+        canvas.drawRect(new Rect(nLeft, nTop, nRight, nBottom), mBatteryPaint);
+
+    }
+
+    /**
+     * 条纹风格绘制（分段条纹，扩展风格）
+     * @param canvas 绘制画布
+     * @param battery 有效电量（0-100）
+     * @param left 左边界
+     * @param right 右边界
+     * @param height 绘制高度
+     */
+    private void drawZebraStyle(Canvas canvas, int battery, int left, int right, int height) {
+        LogUtils.d(TAG, "【drawStripeStyle】条纹风格绘制开始 | 电量=" + battery);
+//        int stripeHeight = height / STRIPE_COUNT; // 单条条纹高度（均匀拆分）
+//        // 从底部向上绘制对应电量条纹
+//        for (int i = 0; i < battery; i++) {
+//            int bottom = height - (stripeHeight * i);
+//            int top = bottom - stripeHeight;
+//            canvas.drawRect(new Rect(left, top, right, bottom), mBatteryPaint);
+//        }
+
+		int nWidth = getBounds().width();
+        int nHeight = getBounds().height();
+        int mnDx = nHeight / 203;
+
+
+		// 意兴阑珊绘图风格
+		int nTop;
+		int nLeft    = 0;
+		int nBottom;
+		int nRight  = nWidth;
+
+		for (int i = 0; i < mBatteryValue; i ++) {
+			nBottom = (nHeight * (100 - i) / 100) - mnDx;
+			nTop = nBottom + mnDx;
+			canvas.drawRect(new Rect(nLeft, nTop, nRight, nBottom), mBatteryPaint);
+		}
+        LogUtils.d(TAG, "【drawStripeStyle】条纹风格绘制完成 | 条纹数量=" + battery);
+    }
+
+
+    /**
+     * 点阵风格绘制
+     * @param canvas 绘制画布
+     * @param battery 有效电量（0-100）
+     * @param left 左边界
+     * @param right 右边界
+     * @param height 绘制高度
+     */
+    private void drawPointStyle(Canvas canvas, int battery, int left, int right, int height) {
+        LogUtils.d(TAG, "【drawStripeStyle】条纹风格绘制开始 | 电量=" + battery);
+
+		int nWidth = getBounds().width();
+        int nHeight = getBounds().height();
+        int mnDx = nHeight / 203;
+
+
+		// 意兴阑珊绘图风格
+		int nTop;
+		int nLeft    = 0;
+		int nBottom;
+		int nRight  = nWidth;
+
+		int nLineWidth = nRight - nLeft;
+		int radius_horizontal = (nLineWidth / 10) / 2;
+		int radius_vertical = mnDx/2;
+		int radius = Math.min(radius_horizontal, radius_vertical);
+
+		for (int i = 0; i < mBatteryValue; i ++) {
+			nBottom = (nHeight * (100 - i) / 100) - mnDx;
+			nTop = nBottom + mnDx;
+			//canvas.drawRect(new Rect(nLeft, nTop, nRight, nBottom), mBatteryPaint);
+
+			for (int j = 0; j < 10; j++) {
+				// cx, cy 圆心坐标；radius 半径；paint 画笔
+				int cx = radius_horizontal + radius_horizontal * j * 2;
+				int cy = nTop + radius_vertical;
+				canvas.drawCircle(cx, cy, radius, mBatteryPaint);
+			}
+		}
+        LogUtils.d(TAG, "【drawStripeStyle】条纹风格绘制完成 | 条纹数量=" + battery);
+    }
+
+    // ====================================== 对外暴露方法（业务控制入口，按功能排序） ======================================
+    /**
+     * 设置当前电量（外部核心调用入口）
+     * @param value 电量值（0-100）
+     */
+    public void setBatteryValue(int value) {
+        LogUtils.d(TAG, "【setBatteryValue】电量更新 | 旧值=" + mBatteryValue + " | 新值=" + value);
+        mBatteryValue = value;
+        invalidateSelf(); // 触发重绘，确保UI实时更新
+        LogUtils.d(TAG, "【setBatteryValue】已触发重绘");
+    }
+
+    /**
+     * 切换绘制风格
+     * @param isEnergyStyle true=能量风格，false=条纹风格
+     */
+    public void setDrawStyle(BatteryStyle batteryStyle) {
+        mBatteryStyle = batteryStyle;
+        invalidateSelf();
+        LogUtils.d(TAG, "【switchDrawStyle】已触发重绘");
+    }
+
+    /**
+     * 更新电量显示颜色
+     * @param color 新颜色值
+     */
+    public void updateBatteryColor(int color) {
+        String oldColor = Integer.toHexString(mBatteryPaint.getColor());
+        String newColor = Integer.toHexString(color);
+        LogUtils.d(TAG, "【updateBatteryColor】颜色更新 | 旧颜色=" + oldColor + " | 新颜色=" + newColor);
+        mBatteryPaint.setColor(color);
+        invalidateSelf();
+        LogUtils.d(TAG, "【updateBatteryColor】已触发重绘");
+    }
+
+    // ====================================== Getter方法（按需暴露，简洁无冗余） ======================================
+    /**
+     * 获取当前电量
+     * @return 电量值（0-100，-1=未初始化）
+     */
+    public int getBatteryValue() {
+        return mBatteryValue;
+    }
+
+
+
+    public BatteryStyle getEnergyStyle() {
+        return mBatteryStyle;
+    }
+
+    // ====================================== Drawable抽象方法（必须实现，精简逻辑） ======================================
+    @Override
+    public void setAlpha(int alpha) {
+        LogUtils.d(TAG, "【setAlpha】透明度更新 | 旧值=" + mBatteryPaint.getAlpha() + " | 新值=" + alpha);
+        mBatteryPaint.setAlpha(alpha);
+        invalidateSelf();
+    }
+
+    @Override
+    public void setColorFilter(ColorFilter colorFilter) {
+        LogUtils.d(TAG, "【setColorFilter】设置颜色过滤 | filter=" + colorFilter);
+        mBatteryPaint.setColorFilter(colorFilter);
+        invalidateSelf();
+    }
+
+    @Override
+    public int getOpacity() {
+        // 固定返回半透明，适配API30透明度渲染机制，兼容小米机型
+        return PixelFormat.TRANSLUCENT;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BatteryStyleView.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BatteryStyleView.java
new file mode 100644
index 0000000..9cd6a7c
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/BatteryStyleView.java
@@ -0,0 +1,285 @@
+package cc.winboll.studio.powerbell.views;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.content.res.TypedArray;
+import android.graphics.Color;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.widget.LinearLayout;
+import android.widget.RadioButton;
+import android.widget.RadioGroup;
+import android.widget.RelativeLayout;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.MainActivity;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BatteryStyle;
+
+/**
+ * 电池样式单选视图，水平展示所有BatteryStyle枚举选项
+ * 每个选项 = RadioButton单选按钮 + BatteryDrawable预览控件
+ * 适配API30、Java7规范，联动BatteryDrawable绘制样式
+ * 包含：SP持久化存储 + 公共静态方法读取SP枚举值 + 彻底修复点击不回调+单选失效
+ * 默认选中：BatteryStyle.ENERGY_STYLE
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class BatteryStyleView extends LinearLayout implements RadioGroup.OnCheckedChangeListener {
+    // ====================== 常量区 ======================
+    public static final String TAG = "BatteryStyleView";
+    private static final int DEFAULT_BATTERY_COLOR = Color.parseColor("#FF4CAF50");
+    private static final int DEFAULT_CHECKED_STYLE_INDEX = 1; // ✅ 修改默认选中下标 1 = ENERGY_STYLE
+    public static final String SP_NAME = "sp_battery_style_config";
+    public static final String SP_KEY_BATTERY_STYLE = "key_selected_battery_style";
+
+    // ====================== 控件变量 ======================
+    private RadioGroup rgBatteryStyle;
+    private RadioButton rbZebraStyle;
+    private RadioButton rbEnergyStyle;
+    private RadioButton rbPointStyle; // ✅ 新增：圆点样式单选按钮
+    private RelativeLayout rlZebraPreview;
+    private RelativeLayout rlEnergyPreview;
+    private RelativeLayout rlPointPreview; // ✅ 新增：圆点样式预览布局
+    private BatteryDrawable mZebraDrawable;
+    private BatteryDrawable mEnergyDrawable;
+    private BatteryDrawable mPointDrawable; // ✅ 新增：圆点样式Drawable实例
+
+    // ====================== 业务变量 ======================
+    private BatteryStyle mCurrentStyle = BatteryStyle.ENERGY_STYLE; // ✅ 修改默认样式为 能量样式
+    private OnBatteryStyleSelectedListener mStyleSelectedListener;
+    private int mBatteryColor = DEFAULT_BATTERY_COLOR;
+    private int mBatteryValue = 100;
+    private SharedPreferences mSp;
+
+    // ====================== 构造方法 ======================
+    public BatteryStyleView(Context context) {
+        super(context);
+        initSP(context);
+        initView(context, null);
+    }
+
+    public BatteryStyleView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initSP(context);
+        initAttrs(context, attrs);
+        initView(context, attrs);
+    }
+
+    public BatteryStyleView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        initSP(context);
+        initAttrs(context, attrs);
+        initView(context, attrs);
+    }
+
+    // ====================== 初始化SP持久化 ======================
+    private void initSP(Context context) {
+        mSp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        LogUtils.d(TAG, "【initSP】SharedPreferences初始化完成，文件名称 = " + SP_NAME);
+    }
+
+    // ====================== 初始化方法 ======================
+    private void initAttrs(Context context, AttributeSet attrs) {
+        if (attrs == null) return;
+        TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.BatteryStyleView);
+        mBatteryColor = typedArray.getColor(R.styleable.BatteryStyleView_batteryPreviewColor, DEFAULT_BATTERY_COLOR);
+        mBatteryValue = typedArray.getInt(R.styleable.BatteryStyleView_previewBatteryValue, 100);
+        int styleIndex = typedArray.getInt(R.styleable.BatteryStyleView_defaultSelectedStyle, DEFAULT_CHECKED_STYLE_INDEX);
+        mCurrentStyle = getStyleFromSP() == null ? (styleIndex == 0 ? BatteryStyle.ENERGY_STYLE : styleIndex ==1 ? BatteryStyle.ZEBRA_STYLE : BatteryStyle.POINT_STYLE) : getStyleFromSP();
+        typedArray.recycle();
+        LogUtils.d(TAG, "【initAttrs】解析属性完成 电量颜色=" + Integer.toHexString(mBatteryColor) + " 预览电量=" + mBatteryValue + " 默认样式=" + mCurrentStyle.name());
+    }
+
+    private void initView(Context context, AttributeSet attrs) {
+        LayoutInflater.from(context).inflate(R.layout.view_battery_style, this, true);
+        rgBatteryStyle = findViewById(R.id.rg_battery_style);
+        rbZebraStyle = findViewById(R.id.rb_zebra_style);
+        rbEnergyStyle = findViewById(R.id.rb_energy_style);
+        rbPointStyle = findViewById(R.id.rb_point_style); // ✅ 新增：绑定圆点样式单选按钮
+        rlZebraPreview = findViewById(R.id.rl_zebra_preview);
+        rlEnergyPreview = findViewById(R.id.rl_energy_preview);
+        rlPointPreview = findViewById(R.id.rl_point_preview); // ✅ 新增：绑定圆点样式预览布局
+
+        initPreviewDrawable();
+        rgBatteryStyle.setOnCheckedChangeListener(this);
+        addRadioBtnClickLister();
+        setDefaultChecked();
+        LogUtils.d(TAG, "【initView】视图初始化完成");
+    }
+
+    private void initPreviewDrawable() {
+        mZebraDrawable = new BatteryDrawable(mBatteryColor, BatteryStyle.ZEBRA_STYLE);
+        mZebraDrawable.setBatteryValue(mBatteryValue);
+        rlZebraPreview.setBackground(mZebraDrawable);
+
+        mEnergyDrawable = new BatteryDrawable(mBatteryColor, BatteryStyle.ENERGY_STYLE);
+        mEnergyDrawable.setBatteryValue(mBatteryValue);
+        rlEnergyPreview.setBackground(mEnergyDrawable);
+
+        // ✅ 新增：初始化圆点样式Drawable + 绑定预览布局 + 设置电量值
+        mPointDrawable = new BatteryDrawable(mBatteryColor, BatteryStyle.POINT_STYLE);
+        mPointDrawable.setBatteryValue(mBatteryValue);
+        rlPointPreview.setBackground(mPointDrawable);
+
+        LogUtils.d(TAG, "【initPreviewDrawable】Drawable预览初始化完成");
+    }
+
+    private void setDefaultChecked() {
+        // ✅ 新增：圆点样式的默认选中判断
+        if (mCurrentStyle == BatteryStyle.ZEBRA_STYLE) {
+            rbZebraStyle.setChecked(true);
+        } else if (mCurrentStyle == BatteryStyle.POINT_STYLE) {
+            rbPointStyle.setChecked(true);
+        } else {
+            rbEnergyStyle.setChecked(true);
+        }
+        LogUtils.d(TAG, "【setDefaultChecked】默认选中样式 = " + mCurrentStyle.name());
+    }
+
+    private void addRadioBtnClickLister() {
+        rbZebraStyle.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					rbZebraStyle.setChecked(true);
+					rbEnergyStyle.setChecked(false);
+                    rbPointStyle.setChecked(false); // ✅ 新增：取消圆点样式选中
+					handleStyleSelect(BatteryStyle.ZEBRA_STYLE);
+				}
+			});
+
+        rbEnergyStyle.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					rbEnergyStyle.setChecked(true);
+					rbZebraStyle.setChecked(false);
+                    rbPointStyle.setChecked(false); // ✅ 新增：取消圆点样式选中
+					handleStyleSelect(BatteryStyle.ENERGY_STYLE);
+				}
+			});
+
+        // ✅ 新增：圆点样式单选按钮点击事件
+        rbPointStyle.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					rbPointStyle.setChecked(true);
+					rbZebraStyle.setChecked(false);
+					rbEnergyStyle.setChecked(false);
+					handleStyleSelect(BatteryStyle.POINT_STYLE);
+				}
+			});
+    }
+
+    // ====================== RadioGroup 选中回调 (点击必触发) ======================
+    @Override
+    public void onCheckedChanged(RadioGroup group, int checkedId) {
+        ToastUtils.show("onCheckedChanged");
+        if (checkedId == R.id.rb_zebra_style) {
+            handleStyleSelect(BatteryStyle.ZEBRA_STYLE);
+        } else if (checkedId == R.id.rb_energy_style) {
+            handleStyleSelect(BatteryStyle.ENERGY_STYLE);
+        } else if (checkedId == R.id.rb_point_style) { // ✅ 新增：圆点样式选中回调
+            handleStyleSelect(BatteryStyle.POINT_STYLE);
+        }
+    }
+
+    private void handleStyleSelect(BatteryStyle style) {
+        mCurrentStyle = style;
+        saveStyle2SP(mCurrentStyle);
+		MainActivity.sendUpdateBatteryDrawableMessage();
+        LogUtils.d(TAG, "【handleStyleSelect】选中样式 → " + mCurrentStyle.name() + "，已存入SP");
+        if (mStyleSelectedListener != null) {
+            mStyleSelectedListener.onStyleSelected(mCurrentStyle);
+        }
+    }
+
+    // ====================== SP持久化 存储+读取 封装方法 ======================
+    private void saveStyle2SP(BatteryStyle style) {
+        mSp.edit().putString(SP_KEY_BATTERY_STYLE, style.name()).commit();
+    }
+
+    private BatteryStyle getStyleFromSP() {
+        String styleStr = mSp.getString(SP_KEY_BATTERY_STYLE, null);
+        if (styleStr == null) return null;
+        try {
+            return BatteryStyle.valueOf(styleStr);
+        } catch (IllegalArgumentException e) {
+            LogUtils.e(TAG, "【getStyleFromSP】SP读取样式异常 = " + e.getMessage());
+            return null;
+        }
+    }
+
+    // ====================== 公共静态方法 读取SP存储的枚举值 ======================
+    public static BatteryStyle getSavedBatteryStyle(Context context) {
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        String styleStr = sp.getString(SP_KEY_BATTERY_STYLE, null);
+        if (styleStr == null) {
+            LogUtils.w(TAG, "【getSavedBatteryStyle】SP无存储值，返回默认样式 ENERGY_STYLE");
+            return BatteryStyle.ENERGY_STYLE; // ✅ 静态方法默认值同步修改为能量样式
+        }
+        try {
+            BatteryStyle style = BatteryStyle.valueOf(styleStr);
+            LogUtils.d(TAG, "【getSavedBatteryStyle】SP读取成功 → " + style.name());
+            return style;
+        } catch (IllegalArgumentException e) {
+            LogUtils.e(TAG, "【getSavedBatteryStyle】SP读取异常 = " + e.getMessage() + "，返回默认样式 ENERGY_STYLE");
+            return BatteryStyle.ENERGY_STYLE; // ✅ 异常兜底值同步修改为能量样式
+        }
+    }
+
+    public static BatteryStyle getSavedBatteryStyle(Context context, BatteryStyle defaultStyle) {
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        String styleStr = sp.getString(SP_KEY_BATTERY_STYLE, null);
+        if (styleStr == null) {
+            LogUtils.w(TAG, "【getSavedBatteryStyle】SP无存储值，返回自定义默认样式 → " + defaultStyle.name());
+            return defaultStyle;
+        }
+        try {
+            BatteryStyle style = BatteryStyle.valueOf(styleStr);
+            LogUtils.d(TAG, "【getSavedBatteryStyle】SP读取成功 → " + style.name());
+            return style;
+        } catch (IllegalArgumentException e) {
+            LogUtils.e(TAG, "【getSavedBatteryStyle】SP读取异常 = " + e.getMessage() + "，返回自定义默认样式 → " + defaultStyle.name());
+            return defaultStyle;
+        }
+    }
+
+    // ====================== 对外暴露方法 ======================
+    public void setSelectedStyle(BatteryStyle style) {
+        mCurrentStyle = style;
+        // ✅ 新增：圆点样式的手动选中赋值
+        rbZebraStyle.setChecked(style == BatteryStyle.ZEBRA_STYLE);
+        rbEnergyStyle.setChecked(style == BatteryStyle.ENERGY_STYLE);
+        rbPointStyle.setChecked(style == BatteryStyle.POINT_STYLE);
+        saveStyle2SP(style);
+        LogUtils.d(TAG, "【setSelectedStyle】手动设置选中样式 → " + style.name() + "，已存入SP");
+    }
+
+    public BatteryStyle getCurrentStyle() {
+        return mCurrentStyle;
+    }
+
+    public void setPreviewBatteryValue(int batteryValue) {
+        this.mBatteryValue = batteryValue;
+        mZebraDrawable.setBatteryValue(batteryValue);
+        mEnergyDrawable.setBatteryValue(batteryValue);
+        mPointDrawable.setBatteryValue(batteryValue); // ✅ 新增：圆点样式同步电量值
+    }
+
+    public void setPreviewBatteryColor(int color) {
+        this.mBatteryColor = color;
+        mZebraDrawable.updateBatteryColor(color);
+        mEnergyDrawable.updateBatteryColor(color);
+        mPointDrawable.updateBatteryColor(color); // ✅ 新增：圆点样式同步颜色值
+    }
+
+    public void setOnBatteryStyleSelectedListener(OnBatteryStyleSelectedListener listener) {
+        this.mStyleSelectedListener = listener;
+    }
+
+    // ====================== 选中回调接口 ======================
+    public interface OnBatteryStyleSelectedListener {
+        void onStyleSelected(BatteryStyle batteryStyle);
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/views/MainContentView.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/MainContentView.java
new file mode 100644
index 0000000..e09e315
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/MainContentView.java
@@ -0,0 +1,902 @@
+package cc.winboll.studio.powerbell.views;
+
+import android.app.Activity;
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.graphics.drawable.Drawable;
+import android.os.Build;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.CheckBox;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.RelativeLayout;
+import android.widget.Switch;
+import android.widget.TextView;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.R;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.models.BatteryStyle;
+import cc.winboll.studio.powerbell.models.ControlCenterServiceBean;
+import cc.winboll.studio.powerbell.services.ControlCenterService;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+
+/**
+ * 主页面核心视图封装类：统一管理视图绑定、数据更新、事件监听，解耦 Activity 逻辑
+ * 适配：Java7 | API30 | 小米手机，优化性能与资源回收，杜绝内存泄漏，配置变更确认对话框
+ * 新增：拖动进度条时实时预览 sbUsageReminder 与 sbChargeReminder 比值
+ * 修复：updateBatteryDrawable() 电池样式切换后重绘失效问题
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/17 13:14
+ */
+public class MainContentView {
+    // ====================================== 静态常量区（唯一标识，变更类型分类） ======================================
+    public static final String TAG = "MainContentView";
+    // 变更类型常量（区分不同控件，精准处理逻辑）
+    private static final int CHANGE_TYPE_CHARGE_SWITCH = 1;
+    private static final int CHANGE_TYPE_USAGE_SWITCH = 2;
+    private static final int CHANGE_TYPE_SERVICE_SWITCH = 3;
+    private static final int CHANGE_TYPE_CHARGE_SEEKBAR = 4;
+    private static final int CHANGE_TYPE_USAGE_SEEKBAR = 5;
+    // 电量范围常量
+    private static final int BATTERY_MIN = 0;
+    private static final int BATTERY_MAX = 100;
+
+    // ====================================== 内部缓存类（解耦，避免冗余） ======================================
+    /**
+     * 临时配置数据实体（缓存变更信息，取消时恢复）
+     */
+    private static class TempConfigData {
+        int changeType;
+        boolean originalBooleanValue;
+        int originalIntValue;
+        boolean newBooleanValue;
+        int newIntValue;
+
+        // 构造方法（开关类型）
+        TempConfigData(int changeType, boolean originalValue, boolean newValue) {
+            this.changeType = changeType;
+            this.originalBooleanValue = originalValue;
+            this.newBooleanValue = newValue;
+        }
+
+        // 构造方法（进度条类型）
+        TempConfigData(int changeType, int originalValue, int newValue) {
+            this.changeType = changeType;
+            this.originalIntValue = originalValue;
+            this.newIntValue = newValue;
+        }
+    }
+
+    // ====================================== 事件回调接口（解耦视图与业务，提升扩展性） ======================================
+    public interface OnViewActionListener {
+        void onChargeReminderSwitchChanged(boolean isChecked);
+        void onUsageReminderSwitchChanged(boolean isChecked);
+        void onServiceSwitchChanged(boolean isChecked);
+        void onChargeReminderProgressChanged(int progress);
+        void onUsageReminderProgressChanged(int progress);
+    }
+
+    // ====================================== 成员变量区（按功能分类，final优先，避免混乱） ======================================
+    // 外部依赖实例（生命周期关联，优先声明）
+    private Context mContext;
+    private AppConfigUtils mAppConfigUtils;
+    private OnViewActionListener mActionListener;
+
+    // 视图控件（按「布局→开关→文本→进度条→图标」功能归类，public控件标注用途）
+    // 基础布局控件
+    public RelativeLayout mainLayout;
+    public MemoryCachedBackgroundView backgroundView;
+    private LinearLayout mllBackgroundView;
+	private volatile BatteryStyle mBatteryStyle = BatteryStyle.ENERGY_STYLE;
+
+    // 容器布局控件
+    public LinearLayout llLeftSeekBar;
+    public LinearLayout llRightSeekBar;
+    // 开关控件
+    public CheckBox cbEnableChargeReminder;
+    public CheckBox cbEnableUsageReminder;
+    public Switch swEnableService;
+    // 文本显示控件
+    public TextView tvTips;
+    public TextView tvChargeReminderValue;
+    public TextView tvUsageReminderValue;
+    public TextView tvCurrentBatteryValue;
+    // 进度条控件（使用自定义 VerticalSeekBar）
+    public VerticalSeekBar sbChargeReminder;
+    public VerticalSeekBar sbUsageReminder;
+    // 图标显示控件
+    public ImageView ivCurrentBattery;
+    public ImageView ivChargeReminderBattery;
+    public ImageView ivUsageReminderBattery;
+
+    // 进度缓存（用于实时计算比值，避免频繁调用 getProgress()）
+    private int mCurrentChargeProgress;
+    private int mCurrentUsageProgress;
+
+    // 内部复用资源（避免重复创建，优化性能）
+    private BatteryDrawable mCurrentBatteryDrawable;
+    private BatteryDrawable mChargeReminderBatteryDrawable;
+    private BatteryDrawable mUsageReminderBatteryDrawable;
+
+    // 配置变更确认对话框（单例复用，避免重复创建）
+    private AlertDialog mConfigConfirmDialog;
+    private AlertDialog.Builder mDialogBuilder;
+    // 临时存储变更数据（对话框确认前缓存，取消时恢复）
+    private TempConfigData mTempConfigData;
+    // 对话框状态锁（避免快速点击重复弹窗）
+    private boolean isDialogShowing = false;
+
+    // ====================================== 构造方法（初始化入口，逻辑闭环） ======================================
+    public MainContentView(Context context, View rootView, OnViewActionListener actionListener) {
+        LogUtils.d(TAG, "【MainContentView】构造器调用 | context=" + context + " | rootView=" + rootView + " | actionListener=" + actionListener);
+        // 初始化外部依赖
+        this.mContext = context;
+        this.mActionListener = actionListener;
+        this.mAppConfigUtils = AppConfigUtils.getInstance(context.getApplicationContext());
+		mBatteryStyle = BatteryStyleView.getSavedBatteryStyle(context);
+
+        // 执行核心初始化流程（按顺序执行，避免依赖空指针）
+        bindViews(rootView);
+        initBatteryDrawables();
+        initConfirmDialog();
+        bindViewListeners();
+
+        LogUtils.d(TAG, "【MainContentView】初始化完成");
+    }
+
+    // ====================================== 私有初始化方法（封装内部逻辑，仅暴露入口） ======================================
+    /**
+     * 绑定视图控件（显式强转适配 Java7，适配 API30 视图加载机制）
+     * @param rootView 根视图
+     */
+    private void bindViews(View rootView) {
+        LogUtils.d(TAG, "【bindViews】视图绑定开始 | rootView=" + rootView);
+        // 基础布局绑定
+        mainLayout = (RelativeLayout) rootView.findViewById(R.id.activitymainRelativeLayout1);
+        mllBackgroundView = (LinearLayout) rootView.findViewById(R.id.ll_backgroundview);
+
+		backgroundView = App.getInstance().getMemoryCachedBackgroundView();
+		if (backgroundView == null) {
+			App.sBackgroundSourceUtils.loadSettings();
+			BackgroundBean backgroundBean = App.sBackgroundSourceUtils.getCurrentBackgroundBean();
+			backgroundView = App.getInstance().getMemoryCachedBackgroundView().getInstance(mContext, backgroundBean, true);
+		}
+        if (backgroundView.getParent() != null) {
+            ((ViewGroup) backgroundView.getParent()).removeView(backgroundView);
+            LogUtils.d(TAG, "【bindViews】移除背景视图旧父容器");
+        }
+        mllBackgroundView.addView(backgroundView);
+
+		// 容器布局绑定
+        llLeftSeekBar = (LinearLayout) rootView.findViewById(R.id.fragmentmainviewLinearLayout1);
+        llRightSeekBar = (LinearLayout) rootView.findViewById(R.id.fragmentmainviewLinearLayout2);
+        // 开关控件绑定
+        cbEnableChargeReminder = (CheckBox) rootView.findViewById(R.id.fragmentmainviewCheckBox1);
+        cbEnableUsageReminder = (CheckBox) rootView.findViewById(R.id.fragmentmainviewCheckBox2);
+        swEnableService = (Switch) rootView.findViewById(R.id.fragmentandroidviewSwitch1);
+        // 文本控件绑定
+        tvTips = (TextView) rootView.findViewById(R.id.fragmentandroidviewTextView1);
+        tvChargeReminderValue = (TextView) rootView.findViewById(R.id.fragmentandroidviewTextView2);
+        tvUsageReminderValue = (TextView) rootView.findViewById(R.id.fragmentandroidviewTextView3);
+        tvCurrentBatteryValue = (TextView) rootView.findViewById(R.id.fragmentandroidviewTextView4);
+        // 进度条控件绑定（自定义 VerticalSeekBar）
+        sbChargeReminder = (VerticalSeekBar) rootView.findViewById(R.id.fragmentandroidviewVerticalSeekBar1);
+        sbUsageReminder = (VerticalSeekBar) rootView.findViewById(R.id.fragmentandroidviewVerticalSeekBar2);
+        // 图标控件绑定
+        ivCurrentBattery = (ImageView) rootView.findViewById(R.id.fragmentandroidviewImageView1);
+        ivChargeReminderBattery = (ImageView) rootView.findViewById(R.id.fragmentandroidviewImageView3);
+        ivUsageReminderBattery = (ImageView) rootView.findViewById(R.id.fragmentandroidviewImageView2);
+
+        // 初始化进度缓存（从配置读取初始值）
+        mCurrentChargeProgress = mAppConfigUtils.getChargeReminderValue();
+        mCurrentUsageProgress = mAppConfigUtils.getUsageReminderValue();
+        LogUtils.d(TAG, "【bindViews】进度缓存初始化 | charge=" + mCurrentChargeProgress + " | usage=" + mCurrentUsageProgress);
+
+        // 关键视图绑定校验（仅保留核心控件错误日志，精简冗余）
+        if (mainLayout == null) LogUtils.e(TAG, "【bindViews】mainLayout 绑定失败");
+        if (backgroundView == null) LogUtils.e(TAG, "【bindViews】backgroundView 绑定失败");
+        LogUtils.d(TAG, "【bindViews】视图绑定完成");
+    }
+
+	public void reloadBackgroundView() {
+		if (backgroundView != null) {
+			App.sBackgroundSourceUtils.loadSettings();
+			BackgroundBean backgroundBean = App.sBackgroundSourceUtils.getCurrentBackgroundBean();
+			backgroundView.loadByBackgroundBean(backgroundBean, true);
+		}
+	}
+
+    /**
+     * 初始化电池 Drawable（集成 BatteryDrawable，默认能量风格，适配小米机型渲染）
+     */
+    private void initBatteryDrawables() {
+        LogUtils.d(TAG, "【initBatteryDrawables】电池Drawable初始化开始 | style="+mBatteryStyle.name());
+        // 当前电量 Drawable（颜色从资源读取，适配 API30 主题）
+        int colorCurrent = getResourceColor(R.color.colorCurrent);
+        mCurrentBatteryDrawable = new BatteryDrawable(colorCurrent);
+		mCurrentBatteryDrawable.setDrawStyle(mBatteryStyle);
+        // 充电提醒 Drawable
+        int colorCharge = getResourceColor(R.color.colorCharge);
+        mChargeReminderBatteryDrawable = new BatteryDrawable(colorCharge);
+		mChargeReminderBatteryDrawable.setDrawStyle(mBatteryStyle);
+		// 耗电提醒 Drawable
+        int colorUsage = getResourceColor(R.color.colorUsege);
+        mUsageReminderBatteryDrawable = new BatteryDrawable(colorUsage);
+        mUsageReminderBatteryDrawable.setDrawStyle(mBatteryStyle);
+		LogUtils.d(TAG, "【initBatteryDrawables】电池Drawable初始化完成");
+    }
+
+	/**
+	 * ✅ 核心修复：电池样式切换+强制重绘刷新 完整版
+	 * 修复点1：重新创建Drawable后，重新给ImageView赋值Drawable
+	 * 修复点2：重置所有Drawable的电量值，保证样式切换后数值不变
+	 * 修复点3：调用ImageView.invalidate()强制触发重绘（API30必加）
+	 * 修复点4：Drawable.invalidateSelf() 双保险刷新绘制内容
+	 * @param batteryStyle 切换后的电池样式
+	 */
+	public void updateBatteryDrawable(BatteryStyle batteryStyle) {
+		if(batteryStyle == null || batteryStyle == mBatteryStyle){
+			LogUtils.d(TAG, "【updateBatteryDrawable】样式无变化，跳过刷新");
+			return;
+		}
+		// 1. 更新样式标记
+		mBatteryStyle = batteryStyle;
+		// 2. 重新初始化Drawable并设置新样式
+		initBatteryDrawables();
+		// 3. 重置所有Drawable的电量值 → 保证样式切换后数值不变
+		mCurrentBatteryDrawable.setBatteryValue(mAppConfigUtils.getCurrentBatteryValue());
+		mChargeReminderBatteryDrawable.setBatteryValue(mCurrentChargeProgress);
+		mUsageReminderBatteryDrawable.setBatteryValue(mCurrentUsageProgress);
+		// 4. 重新给ImageView赋值Drawable → 核心修复：之前缺失这一步
+		if(ivCurrentBattery != null) ivCurrentBattery.setImageDrawable(mCurrentBatteryDrawable);
+		if(ivChargeReminderBattery != null) ivChargeReminderBattery.setImageDrawable(mChargeReminderBatteryDrawable);
+		if(ivUsageReminderBattery != null) ivUsageReminderBattery.setImageDrawable(mUsageReminderBatteryDrawable);
+		// 5. Drawable自身刷新 → 双保险
+		mCurrentBatteryDrawable.invalidateSelf();
+		mChargeReminderBatteryDrawable.invalidateSelf();
+		mUsageReminderBatteryDrawable.invalidateSelf();
+		// 6. ✅ API30关键修复：ImageView强制重绘，解决绘制缓存不刷新问题
+		if(ivCurrentBattery != null) ivCurrentBattery.invalidate();
+		if(ivChargeReminderBattery != null) ivChargeReminderBattery.invalidate();
+		if(ivUsageReminderBattery != null) ivUsageReminderBattery.invalidate();
+
+		LogUtils.d(TAG, "【updateBatteryDrawable】样式切换完成："+mBatteryStyle.name() + " | 重绘触发成功");
+		ToastUtils.show("电池样式已切换为："+mBatteryStyle.name());
+	}
+
+    /**
+     * 初始化配置变更确认对话框（核心优化：保存 Builder 实例，解决消息不生效问题）
+     */
+    private void initConfirmDialog() {
+        LogUtils.d(TAG, "【initConfirmDialog】对话框初始化开始");
+        if (mContext == null) {
+            LogUtils.e(TAG, "【initConfirmDialog】Context 为空，初始化失败");
+            return;
+        }
+
+        // 1. 初始化 Builder（核心：后续通过 Builder 更新消息）
+        mDialogBuilder = new AlertDialog.Builder(mContext);
+        mDialogBuilder.setTitle("配置变更确认");
+        mDialogBuilder.setMessage("是否确认修改当前配置？");
+
+        // 确定按钮：保存配置+回调+更新视图
+        mDialogBuilder.setPositiveButton("确定", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					confirmConfigChange();
+					dialog.dismiss();
+				}
+			});
+
+        // 取消按钮：恢复原始配置（补充物理取消按钮，提升用户体验）
+        mDialogBuilder.setNegativeButton("取消", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					cancelConfigChange();
+					dialog.dismiss();
+				}
+			});
+
+        // 对话框外部点击监听：关闭对话框+恢复原始配置
+        mDialogBuilder.setOnCancelListener(new DialogInterface.OnCancelListener() {
+				@Override
+				public void onCancel(DialogInterface dialog) {
+					cancelConfigChange();
+					dialog.dismiss();
+				}
+			});
+
+        // 2. 初始化对话框实例（设置可取消，支持外部点击关闭）
+        mConfigConfirmDialog = mDialogBuilder.create();
+        mConfigConfirmDialog.setCancelable(true);
+        mConfigConfirmDialog.setCanceledOnTouchOutside(true);
+        LogUtils.d(TAG, "【initConfirmDialog】对话框初始化完成");
+    }
+
+    /**
+     * 绑定视图事件监听（Java7 显式实现接口，适配 API30 事件分发，修复进度条弹窗失效）
+     */
+    private void bindViewListeners() {
+        LogUtils.d(TAG, "【bindViewListeners】事件监听绑定开始");
+        // 依赖校验，避免空指针
+        if (mAppConfigUtils == null || mActionListener == null || mDialogBuilder == null) {
+            LogUtils.e(TAG, "【bindViewListeners】依赖实例为空，跳过监听绑定");
+            return;
+        }
+
+        // 充电提醒进度条监听（使用 VerticalSeekBar 专属接口，确保弹窗100%触发）
+        if (sbChargeReminder != null) {
+            // 原有：触摸抬起/取消监听（用于配置确认）
+            sbChargeReminder.setOnVerticalSeekBarTouchListener(new VerticalSeekBar.OnVerticalSeekBarTouchListener() {
+					@Override
+					public void onTouchUp(VerticalSeekBar seekBar, int progress) {
+						int originalValue = mAppConfigUtils.getChargeReminderValue();
+						// 进度无变化，不处理
+						if (originalValue == progress) {
+							LogUtils.d(TAG, "【bindViewListeners】ChargeReminderSeekBar: 进度无变化，跳过");
+							return;
+						}
+						// 缓存变更数据，显示确认对话框
+						mTempConfigData = new TempConfigData(CHANGE_TYPE_CHARGE_SEEKBAR, originalValue, progress);
+						updateDialogMessageByChangeType();
+						showConfigConfirmDialog();
+						LogUtils.d(TAG, "【bindViewListeners】ChargeReminderSeekBar触摸抬起 | 原始值=" + originalValue + " | 新进度=" + progress);
+					}
+
+					@Override
+					public void onTouchCancel(VerticalSeekBar seekBar, int progress) {
+						// 触摸取消，回滚视图进度（UI 与配置保持一致）
+						int originalValue = mAppConfigUtils.getChargeReminderValue();
+						if (tvChargeReminderValue != null && mChargeReminderBatteryDrawable != null && ivChargeReminderBattery != null) {
+							mChargeReminderBatteryDrawable.setBatteryValue(originalValue);
+							ivChargeReminderBattery.setImageDrawable(mChargeReminderBatteryDrawable);
+							tvChargeReminderValue.setText(originalValue + "%");
+						}
+						seekBar.setProgress(originalValue);
+						// 恢复进度缓存
+						mCurrentChargeProgress = originalValue;
+						LogUtils.d(TAG, "【bindViewListeners】ChargeReminderSeekBar触摸取消 | 进度回滚至=" + originalValue);
+					}
+				});
+
+            // 新增：实时进度变化监听（用于比值预览）
+            sbChargeReminder.setOnVerticalSeekBarChangeListener(new VerticalSeekBar.OnVerticalSeekBarChangeListener() {
+					@Override
+					public void onProgressChanged(VerticalSeekBar seekBar, int progress, boolean fromUser) {
+						if (fromUser) {
+							mCurrentChargeProgress = progress;
+							// 同步更新进度文本和电池图标（保持UI一致性）
+							if (tvChargeReminderValue != null && mChargeReminderBatteryDrawable != null && ivChargeReminderBattery != null) {
+								mChargeReminderBatteryDrawable.setBatteryValue(progress);
+								ivChargeReminderBattery.setImageDrawable(mChargeReminderBatteryDrawable);
+								tvChargeReminderValue.setText(progress + "%");
+							}
+							LogUtils.d(TAG, "【bindViewListeners】ChargeReminderSeekBar实时更新 | 进度=" + progress);
+						}
+					}
+
+					@Override
+					public void onStartTrackingTouch(VerticalSeekBar seekBar) {}
+
+					@Override
+					public void onStopTrackingTouch(VerticalSeekBar seekBar) {}
+				});
+            LogUtils.d(TAG, "【bindViewListeners】充电提醒进度条专属监听绑定完成");
+        }
+
+        // 充电提醒开关监听
+        if (cbEnableChargeReminder != null) {
+            cbEnableChargeReminder.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						boolean originalValue = mAppConfigUtils.isChargeReminderEnabled();
+						boolean newValue = cbEnableChargeReminder.isChecked();
+						// 状态无变化，不处理
+						if (originalValue == newValue) return;
+						// 缓存变更数据，显示确认对话框
+						mTempConfigData = new TempConfigData(CHANGE_TYPE_CHARGE_SWITCH, originalValue, newValue);
+						updateDialogMessageByChangeType();
+						showConfigConfirmDialog();
+						LogUtils.d(TAG, "【bindViewListeners】cbEnableChargeReminder点击 | 原始值=" + originalValue + " | 变更后=" + newValue);
+					}
+				});
+            LogUtils.d(TAG, "【bindViewListeners】充电提醒开关监听绑定完成");
+        }
+
+        // 耗电提醒进度条监听（使用 VerticalSeekBar 专属接口，确保弹窗100%触发）
+        if (sbUsageReminder != null) {
+            // 原有：触摸抬起/取消监听（用于配置确认）
+            sbUsageReminder.setOnVerticalSeekBarTouchListener(new VerticalSeekBar.OnVerticalSeekBarTouchListener() {
+					@Override
+					public void onTouchUp(VerticalSeekBar seekBar, int progress) {
+						int originalValue = mAppConfigUtils.getUsageReminderValue();
+						// 进度无变化，不处理
+						if (originalValue == progress) {
+							LogUtils.d(TAG, "【bindViewListeners】UsageReminderSeekBar: 进度无变化，跳过");
+							return;
+						}
+						// 缓存变更数据，显示确认对话框
+						mTempConfigData = new TempConfigData(CHANGE_TYPE_USAGE_SEEKBAR, originalValue, progress);
+						updateDialogMessageByChangeType();
+						showConfigConfirmDialog();
+						LogUtils.d(TAG, "【bindViewListeners】UsageReminderSeekBar触摸抬起 | 原始值=" + originalValue + " | 新进度=" + progress);
+					}
+
+					@Override
+					public void onTouchCancel(VerticalSeekBar seekBar, int progress) {
+						// 触摸取消，回滚视图进度（UI 与配置保持一致）
+						int originalValue = mAppConfigUtils.getUsageReminderValue();
+						if (tvUsageReminderValue != null && mUsageReminderBatteryDrawable != null && ivUsageReminderBattery != null) {
+							mUsageReminderBatteryDrawable.setBatteryValue(originalValue);
+							ivUsageReminderBattery.setImageDrawable(mUsageReminderBatteryDrawable);
+							tvUsageReminderValue.setText(originalValue + "%");
+						}
+						seekBar.setProgress(originalValue);
+						// 恢复进度缓存
+						mCurrentUsageProgress = originalValue;
+						LogUtils.d(TAG, "【bindViewListeners】UsageReminderSeekBar触摸取消 | 进度回滚至=" + originalValue);
+					}
+				});
+
+            // 新增：实时进度变化监听（用于比值预览）
+            sbUsageReminder.setOnVerticalSeekBarChangeListener(new VerticalSeekBar.OnVerticalSeekBarChangeListener() {
+					@Override
+					public void onProgressChanged(VerticalSeekBar seekBar, int progress, boolean fromUser) {
+						if (fromUser) {
+							mCurrentUsageProgress = progress;
+							// 同步更新进度文本和电池图标（保持UI一致性）
+							if (tvUsageReminderValue != null && mUsageReminderBatteryDrawable != null && ivUsageReminderBattery != null) {
+								mUsageReminderBatteryDrawable.setBatteryValue(progress);
+								ivUsageReminderBattery.setImageDrawable(mUsageReminderBatteryDrawable);
+								tvUsageReminderValue.setText(progress + "%");
+							}
+							LogUtils.d(TAG, "【bindViewListeners】UsageReminderSeekBar实时更新 | 进度=" + progress);
+						}
+					}
+
+					@Override
+					public void onStartTrackingTouch(VerticalSeekBar seekBar) {}
+
+					@Override
+					public void onStopTrackingTouch(VerticalSeekBar seekBar) {}
+				});
+            LogUtils.d(TAG, "【bindViewListeners】耗电提醒进度条专属监听绑定完成");
+        }
+
+        // 耗电提醒开关监听
+        if (cbEnableUsageReminder != null) {
+            cbEnableUsageReminder.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						boolean originalValue = mAppConfigUtils.isUsageReminderEnabled();
+						boolean newValue = cbEnableUsageReminder.isChecked();
+						// 状态无变化，不处理
+						if (originalValue == newValue) return;
+						// 缓存变更数据，显示确认对话框
+						mTempConfigData = new TempConfigData(CHANGE_TYPE_USAGE_SWITCH, originalValue, newValue);
+						updateDialogMessageByChangeType();
+						showConfigConfirmDialog();
+						LogUtils.d(TAG, "【bindViewListeners】cbEnableUsageReminder点击 | 原始值=" + originalValue + " | 变更后=" + newValue);
+					}
+				});
+            LogUtils.d(TAG, "【bindViewListeners】耗电提醒开关监听绑定完成");
+        }
+
+        // 服务总开关监听（核心优化：逻辑与其他控件完全对齐）
+        if (swEnableService != null) {
+            swEnableService.setOnClickListener(new View.OnClickListener() {
+					@Override
+					public void onClick(View v) {
+						// 从服务控制Bean读取原始状态，确保与实际一致
+						boolean originalValue = getServiceEnableState();
+						boolean newValue = ((Switch) v).isChecked();
+						// 状态无变化，不处理
+						if (originalValue == newValue) return;
+						// 缓存变更数据
+						mTempConfigData = new TempConfigData(CHANGE_TYPE_SERVICE_SWITCH, originalValue, newValue);
+						// 更新差异化提示语
+						updateDialogMessageByChangeType();
+						// 显示确认对话框
+						showConfigConfirmDialog();
+						LogUtils.d(TAG, "【bindViewListeners】swEnableService点击 | 原始值=" + originalValue + " | 变更后=" + newValue);
+					}
+				});
+            LogUtils.d(TAG, "【bindViewListeners】服务总开关监听绑定完成");
+        }
+
+        LogUtils.d(TAG, "【bindViewListeners】所有事件监听绑定完成");
+    }
+
+    // ====================================== 对外暴露核心方法（业务入口，精简参数，明确职责） ======================================
+    /**
+     * 更新所有视图数据（从配置读取数据，统一刷新 UI，适配 API30 视图更新规范）
+     * @param frameDrawable 进度条背景 Drawable（外部传入，适配主题切换）
+     */
+    public void updateViewData(Drawable frameDrawable) {
+        LogUtils.d(TAG, "【updateViewData】视图数据更新开始 | frameDrawable=" + frameDrawable);
+        if (mAppConfigUtils == null) {
+            LogUtils.e(TAG, "【updateViewData】AppConfigUtils 为空，跳过更新");
+            return;
+        }
+
+        // 一次读取所有配置参数，减少工具类调用，提升性能
+        int chargeVal = mAppConfigUtils.getChargeReminderValue();
+        int usageVal = mAppConfigUtils.getUsageReminderValue();
+        int currentVal = mAppConfigUtils.getCurrentBatteryValue();
+        boolean chargeEnable = mAppConfigUtils.isChargeReminderEnabled();
+        boolean usageEnable = mAppConfigUtils.isUsageReminderEnabled();
+        // 从服务控制Bean读取状态，确保UI与实际一致
+        boolean serviceEnable = getServiceEnableState();
+        // 更新进度缓存
+        mCurrentChargeProgress = chargeVal;
+        mCurrentUsageProgress = usageVal;
+        LogUtils.d(TAG, "【updateViewData】配置数据读取完成 | charge=" + chargeVal + " | usage=" + usageVal + " | current=" + currentVal + " | serviceEnable=" + serviceEnable);
+
+        // 进度条背景更新
+        if (frameDrawable != null) {
+            if (llLeftSeekBar != null) llLeftSeekBar.setBackground(frameDrawable);
+            if (llRightSeekBar != null) llRightSeekBar.setBackground(frameDrawable);
+            LogUtils.d(TAG, "【updateViewData】进度条背景更新完成");
+        }
+
+        // 当前电量更新（联动 BatteryDrawable，实时刷新图标）
+        if (ivCurrentBattery != null && mCurrentBatteryDrawable != null) {
+            mCurrentBatteryDrawable.setBatteryValue(currentVal);
+            ivCurrentBattery.setImageDrawable(mCurrentBatteryDrawable);
+        }
+        if (tvCurrentBatteryValue != null) {
+            tvCurrentBatteryValue.setTextColor(getResourceColor(R.color.colorCurrent));
+            tvCurrentBatteryValue.setText(currentVal + "%");
+        }
+        LogUtils.d(TAG, "【updateViewData】当前电量更新完成");
+
+        // 充电提醒视图更新
+        if (ivChargeReminderBattery != null && mChargeReminderBatteryDrawable != null) {
+            mChargeReminderBatteryDrawable.setBatteryValue(chargeVal);
+            ivChargeReminderBattery.setImageDrawable(mChargeReminderBatteryDrawable);
+        }
+        if (tvChargeReminderValue != null) {
+            tvChargeReminderValue.setTextColor(getResourceColor(R.color.colorCharge));
+            tvChargeReminderValue.setText(chargeVal + "%");
+        }
+        if (sbChargeReminder != null) sbChargeReminder.setProgress(chargeVal);
+        if (cbEnableChargeReminder != null) cbEnableChargeReminder.setChecked(chargeEnable);
+        LogUtils.d(TAG, "【updateViewData】充电提醒视图更新完成");
+
+        // 耗电提醒视图更新
+        if (ivUsageReminderBattery != null && mUsageReminderBatteryDrawable != null) {
+            mUsageReminderBatteryDrawable.setBatteryValue(usageVal);
+            ivUsageReminderBattery.setImageDrawable(mUsageReminderBatteryDrawable);
+        }
+        if (tvUsageReminderValue != null) {
+            tvUsageReminderValue.setTextColor(getResourceColor(R.color.colorUsege));
+            tvUsageReminderValue.setText(usageVal + "%");
+        }
+        if (sbUsageReminder != null) sbUsageReminder.setProgress(usageVal);
+        if (cbEnableUsageReminder != null) cbEnableUsageReminder.setChecked(usageEnable);
+        LogUtils.d(TAG, "【updateViewData】耗电提醒视图更新完成");
+
+        // 服务开关+提示文本更新（确保状态准确）
+        if (swEnableService != null) {
+            swEnableService.setChecked(serviceEnable);
+            swEnableService.setText(mContext.getString(R.string.txt_aboveswitch));
+        }
+        if (tvTips != null) tvTips.setText(mContext.getString(R.string.txt_aboveswitchtips));
+        LogUtils.d(TAG, "【updateViewData】服务开关与提示文本更新完成");
+
+        LogUtils.d(TAG, "【updateViewData】所有视图数据更新完成");
+    }
+
+    /**
+     * 实时更新当前电量（单独抽离，适配电池实时监控场景，优化 API30 UI 响应速度）
+     * @param value 电量值（自动校准 0-100，避免异常值）
+     */
+    public void updateCurrentBattery(int value) {
+        LogUtils.d(TAG, "【updateCurrentBattery】当前电量更新开始 | 原始值=" + value);
+        // 核心依赖校验
+        if (tvCurrentBatteryValue == null || mCurrentBatteryDrawable == null || ivCurrentBattery == null) {
+            LogUtils.e(TAG, "【updateCurrentBattery】视图/Drawable 为空，跳过更新");
+            return;
+        }
+
+        // 校准电量范围（强制 0-100，防止 API30 视图显示异常）
+        int validValue = Math.max(BATTERY_MIN, Math.min(value, BATTERY_MAX));
+        // 联动 BatteryDrawable 更新图标，同步文本显示
+        mCurrentBatteryDrawable.setBatteryValue(validValue);
+        ivCurrentBattery.setImageDrawable(mCurrentBatteryDrawable);
+        tvCurrentBatteryValue.setText(validValue + "%");
+
+        LogUtils.d(TAG, "【updateCurrentBattery】更新完成 | 校准后值=" + validValue);
+    }
+
+    /**
+     * 释放资源（主动回收，适配 API30 资源管控机制，优化小米手机内存占用）
+     */
+    public void releaseResources() {
+        LogUtils.d(TAG, "【releaseResources】资源释放开始");
+        // 释放对话框资源（安全销毁，避免内存泄漏）
+        if (mConfigConfirmDialog != null) {
+            if (mConfigConfirmDialog.isShowing()) {
+                mConfigConfirmDialog.dismiss();
+            }
+            mConfigConfirmDialog.setOnDismissListener(null);
+            mConfigConfirmDialog.setOnCancelListener(null);
+            mConfigConfirmDialog = null;
+        }
+        // 释放 Builder
+        mDialogBuilder = null;
+        // 释放临时数据
+        mTempConfigData = null;
+
+        // 释放 BatteryDrawable 资源（重点回收绘制资源，避免 OOM）
+        mCurrentBatteryDrawable = null;
+        mChargeReminderBatteryDrawable = null;
+        mUsageReminderBatteryDrawable = null;
+
+        // 置空视图实例（断开视图引用，辅助 GC 回收）
+        mainLayout = null;
+        backgroundView = null;
+        mllBackgroundView = null;
+        llLeftSeekBar = null;
+        llRightSeekBar = null;
+        cbEnableChargeReminder = null;
+        cbEnableUsageReminder = null;
+        swEnableService = null;
+        tvTips = null;
+        tvChargeReminderValue = null;
+        tvUsageReminderValue = null;
+        tvCurrentBatteryValue = null;
+        sbChargeReminder = null;
+        sbUsageReminder = null;
+        ivCurrentBattery = null;
+        ivChargeReminderBattery = null;
+        ivUsageReminderBattery = null;
+
+        // 置空外部依赖（断开生命周期关联，杜绝内存泄漏）
+        mContext = null;
+        mAppConfigUtils = null;
+        mActionListener = null;
+
+        LogUtils.d(TAG, "【releaseResources】所有资源释放完成");
+    }
+
+    /**
+     * 设置服务开关启用状态（外部调用，同步 UI 与服务状态，适配 Activity 视图刷新）
+     * @param enabled 服务启用状态
+     */
+    public void setServiceSwitchChecked(boolean enabled) {
+        LogUtils.d(TAG, "【setServiceSwitchChecked】服务开关状态设置 | enabled=" + enabled);
+        if (swEnableService != null) {
+            swEnableService.setChecked(enabled);
+        }
+    }
+
+    /**
+     * 设置服务开关点击状态（外部调用，避免更新 UI 时触发重复回调）
+     * @param enabled 是否允许点击
+     */
+    public void setServiceSwitchEnabled(boolean enabled) {
+        LogUtils.d(TAG, "【setServiceSwitchEnabled】服务开关点击状态设置 | enabled=" + enabled);
+        if (swEnableService != null) {
+            swEnableService.setEnabled(enabled);
+        }
+    }
+
+    // ====================================== 内部核心逻辑方法（对话框相关，封装确认/取消逻辑） ======================================
+    /**
+     * 显示配置变更确认对话框（确保 Activity 处于前台，避免异常，防止重复弹窗）
+     */
+    private void showConfigConfirmDialog() {
+        LogUtils.d(TAG, "【showConfigConfirmDialog】对话框显示开始 | isDialogShowing=" + isDialogShowing);
+        // 对话框状态锁：正在显示则跳过，避免重复触发
+        if (isDialogShowing) {
+            LogUtils.d(TAG, "【showConfigConfirmDialog】对话框已显示，跳过重复调用");
+            return;
+        }
+        // 基础校验：对话框/上下文/Builder 为空
+        if (mDialogBuilder == null || mContext == null) {
+            LogUtils.e(TAG, "【showConfigConfirmDialog】对话框Builder/上下文异常，无法显示");
+            if (mTempConfigData != null) cancelConfigChange();
+            return;
+        }
+        // Activity 状态校验：避免销毁后弹窗崩溃（适配 API30）
+        Activity activity = (Activity) mContext;
+        if (activity.isFinishing() || activity.isDestroyed()) {
+            LogUtils.e(TAG, "【showConfigConfirmDialog】Activity 已销毁，无法显示对话框");
+            if (mTempConfigData != null) cancelConfigChange();
+            return;
+        }
+        // 重新构建对话框（核心：确保最新消息生效）
+        mConfigConfirmDialog = mDialogBuilder.create();
+        // 显示对话框，设置状态锁+关闭监听
+        mConfigConfirmDialog.show();
+        isDialogShowing = true;
+        // 对话框关闭时解锁
+        mConfigConfirmDialog.setOnDismissListener(new DialogInterface.OnDismissListener() {
+				@Override
+				public void onDismiss(DialogInterface dialog) {
+					isDialogShowing = false;
+					mConfigConfirmDialog.setOnDismissListener(null);
+				}
+			});
+        LogUtils.d(TAG, "【showConfigConfirmDialog】确认对话框显示成功");
+    }
+
+    /**
+     * 确认配置变更（保存数据+回调监听+更新视图）
+     */
+    private void confirmConfigChange() {
+        LogUtils.d(TAG, "【confirmConfigChange】配置确认开始 | mTempConfigData=" + mTempConfigData);
+        if (mTempConfigData == null || mAppConfigUtils == null || mActionListener == null) {
+            LogUtils.e(TAG, "【confirmConfigChange】依赖数据为空，确认失败");
+            return;
+        }
+
+        switch (mTempConfigData.changeType) {
+				// 充电提醒开关
+            case CHANGE_TYPE_CHARGE_SWITCH:
+                mAppConfigUtils.setChargeReminderEnabled(mTempConfigData.newBooleanValue);
+                mActionListener.onChargeReminderSwitchChanged(mTempConfigData.newBooleanValue);
+                LogUtils.d(TAG, "【confirmConfigChange】充电提醒开关确认 | 值=" + mTempConfigData.newBooleanValue);
+                break;
+				// 耗电提醒开关
+            case CHANGE_TYPE_USAGE_SWITCH:
+                mAppConfigUtils.setUsageReminderEnabled(mTempConfigData.newBooleanValue);
+                mActionListener.onUsageReminderSwitchChanged(mTempConfigData.newBooleanValue);
+                LogUtils.d(TAG, "【confirmConfigChange】耗电提醒开关确认 | 值=" + mTempConfigData.newBooleanValue);
+                break;
+				// 服务总开关（核心：持久化配置+触发 Activity 回调）
+            case CHANGE_TYPE_SERVICE_SWITCH:
+                // 1. 设置服务启停
+                if (mTempConfigData.newBooleanValue) {
+                    ControlCenterService.startControlCenterService(mContext);
+                } else {
+                    ControlCenterService.stopControlCenterService(mContext);
+                }
+                // 2. 强制触发 Activity 回调，执行服务启停逻辑
+                mActionListener.onServiceSwitchChanged(mTempConfigData.newBooleanValue);
+                LogUtils.d(TAG, "【confirmConfigChange】服务开关确认 | 值=" + mTempConfigData.newBooleanValue + "，已持久化配置");
+                break;
+				// 充电提醒进度条
+            case CHANGE_TYPE_CHARGE_SEEKBAR:
+                mAppConfigUtils.setChargeReminderValue(mTempConfigData.newIntValue);
+                mActionListener.onChargeReminderProgressChanged(mTempConfigData.newIntValue);
+                LogUtils.d(TAG, "【confirmConfigChange】充电提醒进度确认 | 值=" + mTempConfigData.newIntValue);
+                break;
+				// 耗电提醒进度条
+            case CHANGE_TYPE_USAGE_SEEKBAR:
+                mAppConfigUtils.setUsageReminderValue(mTempConfigData.newIntValue);
+                mActionListener.onUsageReminderProgressChanged(mTempConfigData.newIntValue);
+                LogUtils.d(TAG, "【confirmConfigChange】耗电提醒进度确认 | 值=" + mTempConfigData.newIntValue);
+                break;
+            default:
+                LogUtils.w(TAG, "【confirmConfigChange】未知变更类型，跳过");
+                break;
+        }
+
+        // 确认完成，清空临时数据
+        mTempConfigData = null;
+        LogUtils.d(TAG, "【confirmConfigChange】配置确认完成");
+    }
+
+    /**
+     * 取消配置变更（恢复原始值+刷新视图，确保 UI 与配置一致）
+     */
+    private void cancelConfigChange() {
+        LogUtils.d(TAG, "【cancelConfigChange】配置取消开始 | mTempConfigData=" + mTempConfigData);
+        if (mTempConfigData == null || mAppConfigUtils == null) {
+            LogUtils.e(TAG, "【cancelConfigChange】依赖数据为空，取消失败");
+            return;
+        }
+
+        switch (mTempConfigData.changeType) {
+            case CHANGE_TYPE_CHARGE_SWITCH:
+                if (cbEnableChargeReminder != null) {
+                    cbEnableChargeReminder.setChecked(mTempConfigData.originalBooleanValue);
+                }
+                LogUtils.d(TAG, "【cancelConfigChange】充电提醒开关取消 | 恢复值=" + mTempConfigData.originalBooleanValue);
+                break;
+            case CHANGE_TYPE_USAGE_SWITCH:
+                if (cbEnableUsageReminder != null) {
+                    cbEnableUsageReminder.setChecked(mTempConfigData.originalBooleanValue);
+                }
+                LogUtils.d(TAG, "【cancelConfigChange】耗电提醒开关取消 | 恢复值=" + mTempConfigData.originalBooleanValue);
+                break;
+            case CHANGE_TYPE_SERVICE_SWITCH:
+                if (swEnableService != null) {
+                    swEnableService.setChecked(mTempConfigData.originalBooleanValue);
+                }
+                LogUtils.d(TAG, "【cancelConfigChange】服务开关取消 | 恢复值=" + mTempConfigData.originalBooleanValue);
+                break;
+            case CHANGE_TYPE_CHARGE_SEEKBAR:
+                if (sbChargeReminder != null) {
+                    sbChargeReminder.setProgress(mTempConfigData.originalIntValue);
+                }
+                if (tvChargeReminderValue != null && mChargeReminderBatteryDrawable != null && ivChargeReminderBattery != null) {
+                    mChargeReminderBatteryDrawable.setBatteryValue(mTempConfigData.originalIntValue);
+                    ivChargeReminderBattery.setImageDrawable(mChargeReminderBatteryDrawable);
+                    tvChargeReminderValue.setText(mTempConfigData.originalIntValue + "%");
+                }
+                LogUtils.d(TAG, "【cancelConfigChange】充电提醒进度取消 | 恢复值=" + mTempConfigData.originalIntValue);
+                break;
+            case CHANGE_TYPE_USAGE_SEEKBAR:
+                if (sbUsageReminder != null) {
+                    sbUsageReminder.setProgress(mTempConfigData.originalIntValue);
+                }
+                if (tvUsageReminderValue != null && mUsageReminderBatteryDrawable != null && ivUsageReminderBattery != null) {
+                    mUsageReminderBatteryDrawable.setBatteryValue(mTempConfigData.originalIntValue);
+                    ivUsageReminderBattery.setImageDrawable(mUsageReminderBatteryDrawable);
+                    tvUsageReminderValue.setText(mTempConfigData.originalIntValue + "%");
+                }
+                LogUtils.d(TAG, "【cancelConfigChange】耗电提醒进度取消 | 恢复值=" + mTempConfigData.originalIntValue);
+                break;
+            default:
+                LogUtils.w(TAG, "【cancelConfigChange】未知变更类型，跳过");
+                break;
+        }
+
+        // 取消完成，清空临时数据
+        mTempConfigData = null;
+        LogUtils.d(TAG, "【cancelConfigChange】配置取消完成");
+    }
+
+    /**
+     * 根据变更类型更新对话框提示语（核心优化：通过 Builder 更新，确保生效）
+     */
+    private void updateDialogMessageByChangeType() {
+        LogUtils.d(TAG, "【updateDialogMessageByChangeType】对话框消息更新开始 | mTempConfigData=" + mTempConfigData);
+        if (mDialogBuilder == null || mTempConfigData == null) return;
+        String message;
+        if (mTempConfigData.changeType == CHANGE_TYPE_SERVICE_SWITCH) {
+            // 服务开关差异化提示语
+            message = mTempConfigData.newBooleanValue ?
+				"启用服务后，将后台持续监控电池状态，是否确认？" :
+				"禁用服务后，电池监控功能将停止，是否确认？";
+        } else {
+            // 普通配置默认提示语
+            message = "是否确认修改当前配置？";
+        }
+        // 通过 Builder 设置消息，确保弹窗显示最新内容
+        mDialogBuilder.setMessage(message);
+        LogUtils.d(TAG, "【updateDialogMessageByChangeType】对话框消息更新完成 | message=" + message);
+    }
+
+    // ====================================== 内部工具方法（封装重复逻辑，提升复用性） ======================================
+    /**
+     * 获取资源颜色（适配 API30 主题颜色读取机制，兼容低版本，优化小米机型颜色显示，防御空指针）
+     * @param colorResId 颜色资源 ID
+     * @return 校准后的颜色值
+     */
+    private int getResourceColor(int colorResId) {
+        LogUtils.d(TAG, "【getResourceColor】资源颜色获取 | colorResId=" + colorResId);
+        // 空指针防御：Context 为空返回默认黑色
+        if (mContext == null) {
+            LogUtils.e(TAG, "【getResourceColor】Context 为空，返回默认黑色");
+            return 0xFF000000;
+        }
+        // 适配 API30 主题颜色读取
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+            return mContext.getResources().getColor(colorResId, mContext.getTheme());
+        } else {
+            return mContext.getResources().getColor(colorResId);
+        }
+    }
+
+    /**
+     * 获取服务启用状态（统一从服务控制Bean读取，确保全链路状态一致）
+     * @return 服务启用状态（true=启用，false=禁用）
+     */
+    private boolean getServiceEnableState() {
+        LogUtils.d(TAG, "【getServiceEnableState】服务状态获取开始");
+        ControlCenterServiceBean serviceBean = ControlCenterServiceBean.loadBean(mContext, ControlCenterServiceBean.class);
+        // 本地无配置时，默认禁用服务（与服务初始化逻辑对齐）
+        boolean state = serviceBean != null && serviceBean.isEnableService();
+        LogUtils.d(TAG, "【getServiceEnableState】服务启用状态获取完成 | state=" + state);
+        return state;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/views/MemoryCachedBackgroundView.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/MemoryCachedBackgroundView.java
new file mode 100644
index 0000000..5027b2c
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/MemoryCachedBackgroundView.java
@@ -0,0 +1,221 @@
+package cc.winboll.studio.powerbell.views;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.text.TextUtils;
+import android.util.AttributeSet;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.powerbell.models.BackgroundBean;
+import cc.winboll.studio.powerbell.utils.BackgroundSourceUtils;
+import cc.winboll.studio.powerbell.App;
+import cc.winboll.studio.powerbell.utils.AppConfigUtils;
+
+/**
+ * 单实例缓存版背景视图控件（基于Java7）- 强制缓存版
+ * 核心：通过静态属性保存当前缓存路径和实例，支持强制重载图片
+ * 新增：SP持久化最后加载路径、获取最后加载实例功能
+ * 强制缓存策略：无论内存是否紧张，不自动清理任何缓存实例和路径记录
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ */
+public class MemoryCachedBackgroundView extends BackgroundView {
+    // ====================================== 静态常量区（TAG + SP相关常量） ======================================
+    public static final String TAG = "MemoryCachedBackgroundView";
+    // SP相关常量（持久化最后加载路径）
+    private static final String SP_NAME = "MemoryCachedBackgroundView_SP";
+    private static final String KEY_LAST_LOAD_IMAGE_PATH = "last_load_image_path";
+
+    // ====================================== 静态属性区（强制缓存核心：保存实例、路径、实例计数） ======================================
+    // 静态属性：保存当前缓存的路径和实例（强制保持，不自动销毁）
+    private static String sCachedImagePath;
+    private static MemoryCachedBackgroundView sCachedView;
+    // 新增：记录所有创建过的实例数量（用于强制缓存监控）
+    private static int sInstanceCount = 0;
+
+    // ====================================== 构造器（继承并兼容父类，私有构造防止外部实例化） ======================================
+    private MemoryCachedBackgroundView(Context context) {
+        super(context);
+        sInstanceCount++;
+        LogUtils.d(TAG, String.format("构造器1启动 | 创建实例，当前实例总数=%d", sInstanceCount));
+    }
+
+    private MemoryCachedBackgroundView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        sInstanceCount++;
+        LogUtils.d(TAG, String.format("构造器2启动 | 创建实例，当前实例总数=%d", sInstanceCount));
+    }
+
+    private MemoryCachedBackgroundView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        sInstanceCount++;
+        LogUtils.d(TAG, String.format("构造器3启动 | 创建实例，当前实例总数=%d", sInstanceCount));
+    }
+
+    // ====================================== 核心静态方法：获取/创建缓存实例（强制缓存版） ======================================
+    /**
+     * 从缓存获取或创建MemoryCachedBackgroundView实例（强制保持旧实例）
+     * @param context 上下文
+     * @param imagePath 图片绝对路径（作为缓存标识）
+     * @param isReload 是否强制重新加载图片（路径匹配时仍刷新）
+     * @return 缓存/新创建的MemoryCachedBackgroundView实例
+     */
+    public static MemoryCachedBackgroundView getInstance(Context context, BackgroundBean bean,  boolean isReload) {
+        LogUtils.d(TAG, String.format("getInstance 调用 | BackgroundBean=%s | 是否重载=%b", bean.toString(), isReload));
+		//App.notifyMessage(TAG, String.format("getInstance 调用 | BackgroundBean=%s | 是否重载=%b", bean.toString(), isReload));
+        sCachedView = new MemoryCachedBackgroundView(context);
+		sCachedView.loadByBackgroundBean(bean, isReload);
+		saveLastLoadImagePath(context, getBackgroundBeanImagePath(bean));
+        LogUtils.d(TAG, String.format("getInstance: 已更新当前缓存实例，旧实例路径=%s（强制保持）", getBackgroundBeanImagePath(bean)));
+		//App.notifyMessage(TAG, String.format("getInstance: 已更新当前缓存实例，旧实例路径=%s（强制保持）", getBackgroundBeanImagePath(bean)));
+        return sCachedView;
+    }
+
+	static String getBackgroundBeanImagePath(BackgroundBean bean) {
+		if (bean.isUseBackgroundFile()) {
+			if (bean.isUseBackgroundScaledCompressFile()) {
+				return bean.getBackgroundScaledCompressFilePath();
+			}
+			return bean.getBackgroundFilePath();
+		}
+		return "";
+	}
+
+    // ====================================== 新增功能：获取最后加载的实例（强制缓存版） ======================================
+    /**
+     * 获取最后一次loadImage的路径对应的实例（强制保持所有实例）
+     * 无实例则创建并加载图片，同时更新静态缓存
+     * @param context 上下文
+     * @return 最后加载路径对应的实例
+     */
+    public static MemoryCachedBackgroundView getLastInstance(Context context) {
+        LogUtils.d(TAG, "getLastInstance 调用");
+		//App.notifyMessage(TAG, "getLastInstance 调用");
+        // 1. 从SP获取最后加载的路径（强制保持，不自动删除）
+        sCachedImagePath = getLastLoadImagePath(context);
+		String lastPath = getBackgroundBeanImagePath(App.sBackgroundSourceUtils.getCurrentBackgroundBean());
+		//App.notifyMessage(TAG, String.format("sCachedImagePath : %s", sCachedImagePath));
+        //App.notifyMessage(TAG, String.format("lastPath : %s", lastPath));
+        if (lastPath.equals(sCachedImagePath) && sCachedView != null) {
+            LogUtils.d(TAG, String.format("getLastInstance: 使用最后路径缓存实例 | 路径=%s", lastPath));
+			//App.notifyMessage(TAG, String.format("getLastInstance: 使用最后路径缓存实例 | 路径=%s", lastPath));
+            return sCachedView;
+        }
+		//App.notifyMessage(TAG, "getLastInstance 返回 null");
+        return null;
+    }
+
+    // ====================================== 工具方法：SP持久化最后加载路径（强制保持版） ======================================
+    /**
+     * 保存最后一次loadImage的路径到SP（强制保持，不自动删除）
+     * @param context 上下文
+     * @param imagePath 图片路径
+     */
+    private static void saveLastLoadImagePath(Context context, String imagePath) {
+        if (TextUtils.isEmpty(imagePath) || context == null) {
+            LogUtils.w(TAG, "saveLastLoadImagePath: 路径或上下文为空，跳过保存");
+            return;
+        }
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        sp.edit().putString(KEY_LAST_LOAD_IMAGE_PATH, imagePath).apply();
+        LogUtils.d(TAG, String.format("saveLastLoadImagePath: 已保存最后路径（强制保持） | 路径=%s", imagePath));
+    }
+
+    /**
+     * 从SP获取最后一次loadImage的路径（强制保持，不自动删除）
+     * @param context 上下文
+     * @return 最后加载的图片路径，空则返回null
+     */
+    public static String getLastLoadImagePath(Context context) {
+        if (context == null) {
+            LogUtils.e(TAG, "getLastLoadImagePath: 上下文为空，返回null");
+            return null;
+        }
+        SharedPreferences sp = context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE);
+        String lastPath = sp.getString(KEY_LAST_LOAD_IMAGE_PATH, null);
+        LogUtils.d(TAG, String.format("getLastLoadImagePath: 获取最后路径（强制保持） | 路径=%s", lastPath));
+        return lastPath;
+    }
+
+    // ====================================== 工具方法：缓存管理（强制缓存版 - 仅日志，不清理） ======================================
+    /**
+     * 清除当前缓存实例和路径（强制缓存策略：仅日志，不实际清理）
+     */
+    public static void clearCache() {
+        LogUtils.w(TAG, String.format("clearCache 调用（强制缓存策略：不实际清理缓存） | 当前缓存路径=%s", sCachedImagePath));
+        LogUtils.d(TAG, "clearCache: 强制缓存策略生效，未清除任何实例和路径");
+    }
+
+    /**
+     * 清除指定路径的缓存（强制缓存策略：仅日志，不实际清理）
+     * @param imagePath 图片路径
+     */
+    public static void removeCache(String imagePath) {
+        LogUtils.w(TAG, String.format("removeCache 调用（强制缓存策略：不实际清理缓存） | 图片路径=%s", imagePath));
+        if (TextUtils.isEmpty(imagePath)) {
+            LogUtils.e(TAG, "removeCache: 图片路径为空，清除失败");
+            return;
+        }
+        LogUtils.d(TAG, "removeCache: 强制缓存策略生效，未清除任何实例和路径");
+    }
+
+    /**
+     * 清除所有缓存（强制缓存策略：仅日志，不实际清理）
+     */
+    public static void clearAllCache() {
+        LogUtils.w(TAG, "clearAllCache 调用（强制缓存策略：不实际清理缓存）");
+        LogUtils.d(TAG, "clearAllCache: 强制缓存策略生效，未清除任何实例、路径和SP记录");
+    }
+
+    /**
+     * 判断是否存在缓存实例
+     * @return 存在返回true，否则返回false
+     */
+    public static boolean hasCache() {
+        boolean hasCache = sCachedView != null && !TextUtils.isEmpty(sCachedImagePath);
+        LogUtils.d(TAG, String.format("hasCache 调用 | 缓存存在状态=%b", hasCache));
+        return hasCache;
+    }
+
+    /**
+     * 清除SP中最后加载的路径记录（强制缓存策略：仅日志，不实际清理）
+     * @param context 上下文
+     */
+    public static void clearLastLoadImagePath(Context context) {
+        LogUtils.w(TAG, "clearLastLoadImagePath 调用（强制缓存策略：不实际清理SP记录）");
+        LogUtils.d(TAG, "clearLastLoadImagePath: 强制缓存策略生效，未清除SP中最后路径记录");
+    }
+
+    // ====================================== 辅助方法：从缓存获取上下文 ======================================
+    /**
+     * 从缓存实例中获取上下文（用于无外部上下文时的SP操作）
+     * @return 上下文实例，无则返回null
+     */
+//    private static Context getContextFromCache() {
+//        Context context = sCachedView != null ? sCachedView.getContext() : null;
+//        LogUtils.d(TAG, String.format("getContextFromCache 调用 | 从缓存获取上下文=%s", context));
+//        return context;
+//    }
+
+    // ====================================== 重写父类方法：增强日志+SP持久化（强制保持版） ======================================
+    @Override
+    public void loadByBackgroundBean(BackgroundBean bean) {
+        LogUtils.d(TAG, String.format("loadByBackgroundBean 调用 | BackgroundBean=%s", (bean == null ? "null" : bean.toString())));
+        super.loadByBackgroundBean(bean);
+    }
+
+    @Override
+    public void loadByBackgroundBean(BackgroundBean bean, boolean isRefresh) {
+        LogUtils.d(TAG, String.format("loadByBackgroundBean 调用 | BackgroundBean=%s | 是否刷新=%b", (bean == null ? "null" : bean.toString()), isRefresh));
+        super.loadByBackgroundBean(bean, isRefresh);
+    }
+
+    // ====================================== 新增：强制缓存监控方法 ======================================
+    /**
+     * 获取当前所有创建过的实例总数（用于监控强制缓存状态）
+     * @return 实例总数
+     */
+    public static int getInstanceCount() {
+        LogUtils.d(TAG, String.format("getInstanceCount 调用 | 当前实例总数=%d", sInstanceCount));
+        return sInstanceCount;
+    }
+}
+
diff --git a/powerbell/src/main/java/cc/winboll/studio/powerbell/views/VerticalSeekBar.java b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/VerticalSeekBar.java
new file mode 100644
index 0000000..fcedfcb
--- /dev/null
+++ b/powerbell/src/main/java/cc/winboll/studio/powerbell/views/VerticalSeekBar.java
@@ -0,0 +1,238 @@
+package cc.winboll.studio.powerbell.views;
+
+import android.content.Context;
+import android.graphics.Canvas;
+import android.util.AttributeSet;
+import android.view.MotionEvent;
+import android.widget.SeekBar;
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * 垂直进度条控件，适配 API30，支持逆时针旋转（0在下，100在上）
+ * 修复滑块同步+弹窗触发bug，新增实时进度变化监听接口，支持拖动时实时回调进度
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/17 14:11
+ */
+public class VerticalSeekBar extends SeekBar {
+    // ======================== 静态常量 =========================
+    private static final String TAG = VerticalSeekBar.class.getSimpleName();
+
+    // ======================== 接口定义（前置，便于外部调用）========================
+    /**
+     * 垂直进度条触摸事件回调接口，解决原生 OnSeekBarChangeListener 回调失效问题
+     * 直接在触摸抬起时回调，确保配置变更对话框100%触发
+     */
+    public interface OnVerticalSeekBarTouchListener {
+        /**
+         * 触摸抬起时回调（滑块停止滑动，触发弹窗的核心时机）
+         * @param seekBar 当前垂直进度条实例
+         * @param progress 最终滑动进度（0~100）
+         */
+        void onTouchUp(VerticalSeekBar seekBar, int progress);
+
+        /**
+         * 触摸取消时回调（可选，用于异常场景进度回滚）
+         * @param seekBar 当前垂直进度条实例
+         * @param progress 取消时的进度
+         */
+        void onTouchCancel(VerticalSeekBar seekBar, int progress);
+    }
+
+    /**
+     * 垂直进度条实时进度变化监听接口
+     * 支持拖动过程中实时回调进度，用于比值预览等实时UI更新场景
+     */
+    public interface OnVerticalSeekBarChangeListener {
+        /**
+         * 进度变化时回调
+         * @param seekBar 当前垂直进度条实例
+         * @param progress 当前进度（0~100）
+         * @param fromUser 是否是用户触摸导致的进度变化
+         */
+        void onProgressChanged(VerticalSeekBar seekBar, int progress, boolean fromUser);
+
+        /**
+         * 开始触摸进度条时回调
+         * @param seekBar 当前垂直进度条实例
+         */
+        void onStartTrackingTouch(VerticalSeekBar seekBar);
+
+        /**
+         * 停止触摸进度条时回调
+         * @param seekBar 当前垂直进度条实例
+         */
+        void onStopTrackingTouch(VerticalSeekBar seekBar);
+    }
+
+    // ======================== 成员变量 =========================
+    // 核心状态：当前进度缓存，修复滑块同步问题（volatile 保证多线程可见性）
+    private volatile int mProgress = -1;
+    // 监听接口：触摸事件回调（原有，用于弹窗触发）
+    private OnVerticalSeekBarTouchListener mTouchListener;
+    // 监听接口：实时进度变化回调（新增，用于比值计算）
+    private OnVerticalSeekBarChangeListener mProgressChangeListener;
+
+    // ======================== 构造方法 =========================
+    public VerticalSeekBar(Context context) {
+        super(context);
+        initView();
+        LogUtils.d(TAG, "【构造器1】VerticalSeekBar 初始化完成");
+    }
+
+    public VerticalSeekBar(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        initView();
+        LogUtils.d(TAG, "【构造器2】VerticalSeekBar 初始化完成");
+    }
+
+    public VerticalSeekBar(Context context, AttributeSet attrs, int defStyle) {
+        super(context, attrs, defStyle);
+        initView();
+        LogUtils.d(TAG, "【构造器3】VerticalSeekBar 初始化完成");
+    }
+
+    // ======================== 初始化方法 =========================
+    private void initView() {
+        // 移除水平默认阴影，优化垂直显示效果，减少 API30 不必要的绘制开销
+        setBackgroundDrawable(null);
+        LogUtils.d(TAG, "【initView】移除默认背景阴影，完成视图初始化");
+    }
+
+    // ======================== 对外设置方法（监听接口绑定）========================
+    /**
+     * 设置触摸事件监听器（给外部调用，如 MainContentView 绑定）
+     * @param listener 触摸事件回调实例
+     */
+    public void setOnVerticalSeekBarTouchListener(OnVerticalSeekBarTouchListener listener) {
+        this.mTouchListener = listener;
+        LogUtils.d(TAG, "【setOnVerticalSeekBarTouchListener】触摸监听器绑定完成");
+    }
+
+    /**
+     * 设置实时进度变化监听器（给外部调用，如 MainContentView 绑定）
+     * @param listener 实时进度变化回调实例
+     */
+    public void setOnVerticalSeekBarChangeListener(OnVerticalSeekBarChangeListener listener) {
+        this.mProgressChangeListener = listener;
+        LogUtils.d(TAG, "【setOnVerticalSeekBarChangeListener】实时进度监听器绑定完成");
+    }
+
+    // ======================== 重写系统方法（测量/布局/绘制）========================
+    @Override
+    protected synchronized void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        super.onMeasure(heightMeasureSpec, widthMeasureSpec);
+        setMeasuredDimension(getMeasuredHeight(), getMeasuredWidth());
+        LogUtils.v(TAG, "【onMeasure】垂直测量完成，宽=" + getMeasuredHeight() + "，高=" + getMeasuredWidth());
+    }
+
+    @Override
+    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
+        super.onSizeChanged(h, w, oldh, oldw);
+        LogUtils.v(TAG, "【onSizeChanged】尺寸变化，新宽=" + h + "，新高=" + w);
+    }
+
+    @Override
+    protected void onDraw(Canvas canvas) {
+        // 逆时针旋转90度，平移画布避免绘制偏移（0在下，100在上）
+        canvas.rotate(-90);
+        canvas.translate(-getHeight(), 0);
+        super.onDraw(canvas);
+        LogUtils.v(TAG, "【onDraw】完成垂直绘制，旋转角度=-90°");
+    }
+
+    // ======================== 重写进度设置方法（修复滑块同步+新增实时回调）========================
+    /**
+     * 重写进度设置，调用尺寸变化方法强制刷新，解决 setProgress 滑块不跟随问题
+     * 新增：支持外部调用 setProgress 时触发实时进度回调
+     */
+    @Override
+    public synchronized void setProgress(int progress) {
+        super.setProgress(progress);
+        // 强制触发尺寸变化，同步刷新滑块位置（核心bug修复逻辑）
+        onSizeChanged(getWidth(), getHeight(), 0, 0);
+        mProgress = progress;
+        LogUtils.d(TAG, "【setProgress】进度设置为" + progress + "，滑块同步刷新");
+        // 触发实时进度监听（外部调用 setProgress 时 fromUser 为 false）
+        if (mProgressChangeListener != null) {
+            mProgressChangeListener.onProgressChanged(this, progress, false);
+            LogUtils.v(TAG, "【setProgress】触发实时进度回调，fromUser=false");
+        }
+    }
+
+    // ======================== 重写触摸事件（优化事件透传+实时进度回调）========================
+    @Override
+    public boolean onTouchEvent(MotionEvent event) {
+        // 先调用父类方法，保留原生监听器兼容性，同时强制透传事件
+        super.onTouchEvent(event);
+        boolean handled = true; // 强制消费事件，避免事件被拦截导致回调丢失
+        boolean fromUser = true; // 标记是否是用户触摸导致的进度变化
+        int action = event.getAction();
+
+        switch (action) {
+            case MotionEvent.ACTION_DOWN:
+                LogUtils.d(TAG, "【onTouchEvent】触摸按下，Y坐标=" + event.getY());
+                // 触发实时进度监听：开始触摸
+                if (mProgressChangeListener != null) {
+                    mProgressChangeListener.onStartTrackingTouch(this);
+                    LogUtils.v(TAG, "【onTouchEvent】触发开始触摸回调");
+                }
+                break;
+
+            case MotionEvent.ACTION_MOVE:
+                calculateProgress(event.getY());
+                setProgress(mProgress);
+                LogUtils.v(TAG, "【onTouchEvent】触摸滑动，进度更新为" + mProgress);
+                // 触发实时进度监听：进度变化
+                if (mProgressChangeListener != null) {
+                    mProgressChangeListener.onProgressChanged(this, mProgress, fromUser);
+                }
+                break;
+
+            case MotionEvent.ACTION_UP:
+                calculateProgress(event.getY());
+                setProgress(mProgress);
+                LogUtils.d(TAG, "【onTouchEvent】触摸抬起，进度=" + mProgress + "，触发弹窗回调");
+                // 触发实时进度监听：进度变化+停止触摸
+                if (mProgressChangeListener != null) {
+                    mProgressChangeListener.onProgressChanged(this, mProgress, fromUser);
+                    mProgressChangeListener.onStopTrackingTouch(this);
+                    LogUtils.v(TAG, "【onTouchEvent】触发停止触摸回调");
+                }
+                // 核心：调用原有触摸接口，通知外部触发配置变更对话框
+                if (mTouchListener != null) {
+                    mTouchListener.onTouchUp(this, mProgress);
+                    LogUtils.v(TAG, "【onTouchEvent】触发触摸抬起回调");
+                }
+                break;
+
+            case MotionEvent.ACTION_CANCEL:
+                int currentProgress = getProgress();
+                LogUtils.d(TAG, "【onTouchEvent】触摸取消，当前进度=" + currentProgress);
+                // 触发实时进度监听：停止触摸
+                if (mProgressChangeListener != null) {
+                    mProgressChangeListener.onStopTrackingTouch(this);
+                }
+                // 可选：触摸取消时回调，外部可做进度回滚处理
+                if (mTouchListener != null) {
+                    mTouchListener.onTouchCancel(this, currentProgress);
+                    LogUtils.v(TAG, "【onTouchEvent】触发触摸取消回调");
+                }
+                break;
+        }
+        return handled;
+    }
+
+    // ======================== 内部工具方法 =========================
+    /**
+     * 计算垂直进度，校准范围 0~100，避免异常值
+     * @param touchY 触摸点Y坐标
+     */
+    private void calculateProgress(float touchY) {
+        // 核心进度计算公式（逆时针旋转适配）
+        mProgress = getMax() - (int) (getMax() * touchY / getHeight());
+        // 校准进度范围，防止超出 0~100（兼容 API30 进度边界校验）
+        mProgress = Math.max(0, Math.min(mProgress, getMax()));
+        LogUtils.v(TAG, "【calculateProgress】触摸Y=" + touchY + "，计算进度=" + mProgress + "，校准后=" + mProgress);
+    }
+}
+
diff --git a/powerbell/src/main/res/drawable/bg_frame.xml b/powerbell/src/main/res/drawable/bg_frame.xml
new file mode 100644
index 0000000..75b2b94
--- /dev/null
+++ b/powerbell/src/main/res/drawable/bg_frame.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0FFFFFFF" 
+                android:startColor="#FFFFFFFF" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/powerbell/src/main/res/drawable/bg_frame_white.xml b/powerbell/src/main/res/drawable/bg_frame_white.xml
new file mode 100644
index 0000000..002ffe1
--- /dev/null
+++ b/powerbell/src/main/res/drawable/bg_frame_white.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0FFFFFFF" 
+                android:startColor="#0FFFFFFF" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#CFFFFFFF" 
+                android:startColor="#CFFFFFFF" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/powerbell/src/main/res/drawable/blank100x100.png b/powerbell/src/main/res/drawable/blank100x100.png
new file mode 100644
index 0000000..84e1003
Binary files /dev/null and b/powerbell/src/main/res/drawable/blank100x100.png differ
diff --git a/powerbell/src/main/res/drawable/btn_bg_gray.xml b/powerbell/src/main/res/drawable/btn_bg_gray.xml
new file mode 100644
index 0000000..ba883b9
--- /dev/null
+++ b/powerbell/src/main/res/drawable/btn_bg_gray.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="@android:color/darker_gray" />
+    <corners android:radius="6dp" />
+</shape>
+
diff --git a/powerbell/src/main/res/drawable/btn_bg_primary.xml b/powerbell/src/main/res/drawable/btn_bg_primary.xml
new file mode 100644
index 0000000..6f78e61
--- /dev/null
+++ b/powerbell/src/main/res/drawable/btn_bg_primary.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="@android:color/holo_blue_light" />
+    <corners android:radius="6dp" />
+</shape>
+
diff --git a/powerbell/src/main/res/drawable/btn_brightness_bg.xml b/powerbell/src/main/res/drawable/btn_brightness_bg.xml
new file mode 100644
index 0000000..3d52279
--- /dev/null
+++ b/powerbell/src/main/res/drawable/btn_brightness_bg.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 按压状态：浅灰色背景 -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#E0E0E0" /> <!-- 按压深色 -->
+            <corners android:radius="8dp" /> <!-- 圆角适配小米UI风格 -->
+            <stroke android:width="1dp" android:color="#CCCCCC" /> <!-- 边框 -->
+        </shape>
+    </item>
+    <!-- 正常状态：白色背景 -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#FFFFFF" /> <!-- 正常白色 -->
+            <corners android:radius="8dp" />
+            <stroke android:width="1dp" android:color="#CCCCCC" />
+        </shape>
+    </item>
+</selector>
+
diff --git a/powerbell/src/main/res/drawable/btn_cancel_bg.xml b/powerbell/src/main/res/drawable/btn_cancel_bg.xml
new file mode 100644
index 0000000..14e0bac
--- /dev/null
+++ b/powerbell/src/main/res/drawable/btn_cancel_bg.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 按压状态：深灰色背景 -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#D0D0D0" />
+            <corners android:radius="8dp" /> <!-- 与亮度按钮圆角一致，统一风格 -->
+        </shape>
+    </item>
+    <!-- 正常状态：浅灰色背景 -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#F0F0F0" />
+            <corners android:radius="8dp" />
+        </shape>
+    </item>
+</selector>
+
diff --git a/powerbell/src/main/res/drawable/btn_common.xml b/powerbell/src/main/res/drawable/btn_common.xml
new file mode 100644
index 0000000..7ccb64d
--- /dev/null
+++ b/powerbell/src/main/res/drawable/btn_common.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 按压状态：深灰色 -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#CCCCCC" /> <!-- 按压时颜色 -->
+            <corners android:radius="8dp" /> <!-- 圆角（可按需调整） -->
+            <stroke android:width="1dp" android:color="#EEEEEE" /> <!-- 边框（可选，不加可删除） -->
+        </shape>
+    </item>
+    <!-- 正常状态：浅灰色 -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#F5F5F5" /> <!-- 正常时颜色 -->
+            <corners android:radius="8dp" /> <!-- 圆角（和按压状态一致） -->
+            <stroke android:width="1dp" android:color="#EEEEEE" /> <!-- 边框（可选） -->
+        </shape>
+    </item>
+</selector>
+
diff --git a/powerbell/src/main/res/drawable/btn_confirm_bg.xml b/powerbell/src/main/res/drawable/btn_confirm_bg.xml
new file mode 100644
index 0000000..e4a7a4d
--- /dev/null
+++ b/powerbell/src/main/res/drawable/btn_confirm_bg.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 按压状态：加深深色背景 -->
+    <item android:state_pressed="true">
+        <shape android:shape="rectangle">
+            <solid android:color="#2D7CFF" /> <!-- 按压深蓝 -->
+            <corners android:radius="8dp" />
+        </shape>
+    </item>
+    <!-- 正常状态：主色背景（可改为项目主题色） -->
+    <item>
+        <shape android:shape="rectangle">
+            <solid android:color="#4096FF" /> <!-- 正常浅蓝，适配小米系统UI -->
+            <corners android:radius="8dp" />
+        </shape>
+    </item>
+</selector>
+
diff --git a/powerbell/src/main/res/drawable/charge.png b/powerbell/src/main/res/drawable/charge.png
new file mode 100644
index 0000000..39020eb
Binary files /dev/null and b/powerbell/src/main/res/drawable/charge.png differ
diff --git a/powerbell/src/main/res/drawable/color_scale_logo.png b/powerbell/src/main/res/drawable/color_scale_logo.png
new file mode 100644
index 0000000..70123fb
Binary files /dev/null and b/powerbell/src/main/res/drawable/color_scale_logo.png differ
diff --git a/powerbell/src/main/res/drawable/cursor_pointer.xml b/powerbell/src/main/res/drawable/cursor_pointer.xml
new file mode 100644
index 0000000..e828063
--- /dev/null
+++ b/powerbell/src/main/res/drawable/cursor_pointer.xml
@@ -0,0 +1,20 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="48dp"
+    android:height="48dp"
+    android:viewportWidth="48"
+    android:viewportHeight="48">
+    <path
+        android:fillColor="#00FFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M24.17 5.23C34.61 5.23 43.16 13.78 43.16 24.22 43.16 34.66 34.61 43.2 24.17 43.2 13.73 43.2 5.18 34.66 5.18 24.22 5.18 13.78 13.73 5.23 24.17 5.23"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M25.8 20.4C25.8 20.4 26.6 20.6 26.6 20.6 26.6 20.6 31.92 23.77 31.92 23.77 32.81 24.12 33.39 25.17 33.32 26.3 33.32 26.3 33.32 26.5 33.32 26.5 33.32 26.5 33.32 26.7 33.32 26.7 33.32 26.7 32.17 36.04 32.17 36.04 32.09 36.69 31.85 37.3 31.41 37.73 31.01 38.19 30.49 38.42 29.94 38.42 29.94 38.42 21.18 38.42 21.18 38.42 20.55 38.42 19.98 38.14 19.56 37.61 19.56 37.61 11.93 28.5 11.93 28.5 11.93 28.5 13.07 26.97 13.07 26.97 13.38 26.59 13.86 26.38 14.32 26.41 14.32 26.41 14.69 26.41 14.69 26.41 14.69 26.41 19.75 27.74 19.75 27.74 19.75 27.74 19.75 11.72 19.75 11.72 19.75 10.03 20.89 8.66 22.3 8.66 23.7 8.66 24.85 10.03 24.85 11.72 24.85 11.72 24.85 20.4 24.85 20.4 24.85 20.4 25.8 20.4 25.8 20.4 25.8 20.4 25.8 20.4 25.8 20.4"/>
+</vector>
diff --git a/powerbell/src/main/res/drawable/default_background.xml b/powerbell/src/main/res/drawable/default_background.xml
new file mode 100644
index 0000000..f021b2e
--- /dev/null
+++ b/powerbell/src/main/res/drawable/default_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#FF009DCB"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/powerbell/src/main/res/drawable/dialog_bg_radius.xml b/powerbell/src/main/res/drawable/dialog_bg_radius.xml
new file mode 100644
index 0000000..773dcd8
--- /dev/null
+++ b/powerbell/src/main/res/drawable/dialog_bg_radius.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <!-- 背景色：白色 -->
+    <solid android:color="@android:color/white" />
+    <!-- 圆角：12dp（适配小米机型圆角无锯齿） -->
+    <corners android:radius="12dp" />
+    <!-- 边框：浅灰色细边框（避免弹窗边缘模糊） -->
+    <stroke
+        android:width="1dp"
+        android:color="@android:color/darker_gray" />
+    <!-- 内边距：轻微留白，避免内容贴边 -->
+    <padding
+        android:bottom="5dp"
+        android:top="5dp" />
+</shape>
+
diff --git a/powerbell/src/main/res/drawable/divider_line.xml b/powerbell/src/main/res/drawable/divider_line.xml
new file mode 100644
index 0000000..f9365df
--- /dev/null
+++ b/powerbell/src/main/res/drawable/divider_line.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="line">
+    <stroke
+        android:width="1dp"
+        android:color="#E0E0E0"/>
+</shape>
diff --git a/powerbell/src/main/res/drawable/edittext_bg.xml b/powerbell/src/main/res/drawable/edittext_bg.xml
new file mode 100644
index 0000000..8b48b87
--- /dev/null
+++ b/powerbell/src/main/res/drawable/edittext_bg.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="@android:color/white" />
+    <corners android:radius="6dp" />
+    <stroke
+        android:width="1dp"
+        android:color="@android:color/darker_gray" />
+</shape>
+
diff --git a/powerbell/src/main/res/drawable/ic_launcher.xml b/powerbell/src/main/res/drawable/ic_launcher.xml
new file mode 100644
index 0000000..737188b
--- /dev/null
+++ b/powerbell/src/main/res/drawable/ic_launcher.xml
@@ -0,0 +1,27 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#FF009600"
+        android:strokeColor="#00009D00"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M62.77 11.19C62.67 11.19 62.58 11.19 62.48 11.19 52.61 11.19 39.45 11.19 29.58 11.19 27.65 11.18 27.99 12.03 27.99 14.19 27.99 14.87 27.99 15.78 27.99 16.46 27.99 17.08 27.59 18.51 28.23 18.5 38.1 18.29 51.26 18.5 61.13 18.5 61.4 18.5 62.76 18.7 62.77 17.81 62.8 15.94 62.77 13.44 62.77 11.57 62.77 11.47 62.77 11.35 62.77 11.29 62.77 11.22 62.77 11.2 62.77 11.19M72.1 99.32C72.11 75.14 72.38 42.9 72.1 18.72 72.1 18.07 69.2 18.5 67.63 18.5 53.53 18.5 34.73 18.5 20.63 18.5 20.33 18.5 18.6 18.19 18.66 18.87 19.09 24.3 18.66 31.58 18.66 37.03 18.66 54.74 18.66 78.36 18.66 96.07 18.66 97.05 17.82 99.13 18.81 99.32 20.19 99.59 22.1 99.32 23.51 99.32 37.97 99.32 57.24 99.32 71.69 99.32 71.79 99.32 71.91 99.32 71.98 99.32 72.05 99.32 72.08 99.32 72.1 99.32"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M95.69 46.15C95.69 46.06 95.69 45.96 95.68 45.87 95.62 42.18 93.47 32.14 79.53 27.34 78.29 26.91 75.48 25.94 70.99 25.58 57.33 24.5 41.98 31.96 40.58 44.42 40.29 47.08 40.58 50.91 43.06 54.84 43.67 55.81 42.82 56.28 41.94 58.72 40.03 64.07 45.17 66.64 54.03 67.28 60.63 67.77 64.55 67.28 71.29 66.69 73.45 66.5 76.23 66.12 79.77 64.87 86.98 62.33 95.34 56.16 95.68 46.7 95.68 46.6 95.68 46.51 95.68 46.42 95.69 46.33 95.69 46.24 95.69 46.15"/>
+    <path
+        android:fillColor="#00FFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="2.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M241.47 177.43C241.47 177.43 241.47 177.43 241.47 177.43 241.47 177.43 241.47 177.43 241.47 177.43"/>
+</vector>
diff --git a/powerbell/src/main/res/drawable/ic_launcher_background.xml b/powerbell/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..f021b2e
--- /dev/null
+++ b/powerbell/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="#FF009DCB"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeWidth="0.8"
+        android:strokeColor="#33FFFFFF" />
+</vector>
diff --git a/powerbell/src/main/res/drawable/ic_launcher_beta.xml b/powerbell/src/main/res/drawable/ic_launcher_beta.xml
new file mode 100644
index 0000000..08f0a9f
--- /dev/null
+++ b/powerbell/src/main/res/drawable/ic_launcher_beta.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/ic_launcher"/>
+</layer-list>
diff --git a/powerbell/src/main/res/drawable/seekbar_progress.xml b/powerbell/src/main/res/drawable/seekbar_progress.xml
new file mode 100644
index 0000000..4e27cf9
--- /dev/null
+++ b/powerbell/src/main/res/drawable/seekbar_progress.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 进度条未完成部分：浅灰色 -->
+    <item android:id="@android:id/background">
+        <shape android:shape="rectangle">
+            <solid android:color="@android:color/darker_gray" />
+            <corners android:radius="10dp" />
+        </shape>
+    </item>
+    <!-- 进度条已完成部分：系统蓝色（无需额外定义颜色） -->
+    <item android:id="@android:id/progress">
+        <clip>
+            <shape android:shape="rectangle">
+                <solid android:color="@android:color/holo_blue_light" />
+                <corners android:radius="10dp" />
+            </shape>
+        </clip>
+    </item>
+</layer-list>
+
diff --git a/powerbell/src/main/res/drawable/seekbar_thumb.xml b/powerbell/src/main/res/drawable/seekbar_thumb.xml
new file mode 100644
index 0000000..fb9e7b5
--- /dev/null
+++ b/powerbell/src/main/res/drawable/seekbar_thumb.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="oval">
+    <!-- 滑块颜色：系统蓝色 -->
+    <solid android:color="@android:color/holo_blue_light" />
+    <!-- 滑块大小：20dp（适配小米机型触摸区域） -->
+    <size
+        android:width="20dp"
+        android:height="20dp" />
+    <!-- 白色边框：区分滑块与进度条 -->
+    <stroke
+        android:width="2dp"
+        android:color="@android:color/white" />
+</shape>
+
diff --git a/powerbell/src/main/res/drawable/speaker.xml b/powerbell/src/main/res/drawable/speaker.xml
new file mode 100644
index 0000000..53e00c1
--- /dev/null
+++ b/powerbell/src/main/res/drawable/speaker.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M14,3.23V5.29C16.89,6.15 19,8.83 19,12C19,15.17 16.89,17.84 14,18.7V20.77C18,19.86 21,16.28 21,12C21,7.72 18,4.14 14,3.23M16.5,12C16.5,10.23 15.5,8.71 14,7.97V16C15.5,15.29 16.5,13.76 16.5,12M3,9V15H7L12,20V4L7,9H3Z"/>
+
+</vector>
diff --git a/powerbell/src/main/res/drawable/usege.png b/powerbell/src/main/res/drawable/usege.png
new file mode 100644
index 0000000..591894d
Binary files /dev/null and b/powerbell/src/main/res/drawable/usege.png differ
diff --git a/powerbell/src/main/res/drawable/xiaobai.png b/powerbell/src/main/res/drawable/xiaobai.png
new file mode 100644
index 0000000..1b053a2
Binary files /dev/null and b/powerbell/src/main/res/drawable/xiaobai.png differ
diff --git a/powerbell/src/main/res/layout/activity_about.xml b/powerbell/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..3f84f0a
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_about.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"
+		style="@style/DefaultAToolbar"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_background_settings.xml b/powerbell/src/main/res/layout/activity_background_settings.xml
new file mode 100644
index 0000000..74d18c9
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_background_settings.xml
@@ -0,0 +1,143 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"
+		style="@style/DefaultAToolbar"/>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<cc.winboll.studio.powerbell.views.BackgroundView
+			xmlns:app="http://schemas.android.com/apk/res-auto"
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/background_view">
+
+		</cc.winboll.studio.powerbell.views.BackgroundView>
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="400dp">
+
+			<RelativeLayout
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content">
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="160dp"
+					android:layout_height="36dp"
+					android:text="Origin BG"
+					android:layout_alignParentLeft="true"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton1"/>
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="160dp"
+					android:layout_height="36dp"
+					android:text="Received BG"
+					android:layout_alignParentRight="true"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton2"/>
+
+			</RelativeLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right">
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="◎"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton3"/>
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="☑"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton4"/>
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="♾"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton5"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right">
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="[+]"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton6"/>
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="[+~]"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton7"/>
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="[◐]"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton8"/>
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="[©]"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:onClick="onColorPaletteDialog"
+					android:id="@+id/activitybackgroundsettingsAButton9"/>
+
+				<cc.winboll.studio.libaes.views.AButton
+					android:layout_width="50dp"
+					android:layout_height="36dp"
+					android:text="[○]"
+					android:layout_gravity="center_vertical"
+					android:layout_margin="5dp"
+					android:id="@+id/activitybackgroundsettingsAButton10"/>
+
+			</LinearLayout>
+
+		</LinearLayout>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_battery_report.xml b/powerbell/src/main/res/layout/activity_battery_report.xml
new file mode 100644
index 0000000..cd13abd
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_battery_report.xml
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout 
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:background="@android:color/white">
+	
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"
+		style="@style/DefaultAToolbar"/>
+
+    <!-- 搜索框：提示文本改为“搜索应用名称或包名” -->
+    <EditText
+        android:id="@+id/et_search"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_margin="8dp"
+        android:padding="12dp"
+        android:hint="搜索应用名称或包名"
+        android:background="@android:drawable/btn_default_small"
+        android:inputType="text"
+        android:textSize="16sp"/>
+
+    <!-- 应用列表 -->
+    <androidx.recyclerview.widget.RecyclerView
+        android:id="@+id/rv_battery_report"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1"
+        android:layout_marginLeft="8dp"
+        android:layout_marginRight="8dp"/>
+
+</LinearLayout>
diff --git a/powerbell/src/main/res/layout/activity_clearrecord.xml b/powerbell/src/main/res/layout/activity_clearrecord.xml
new file mode 100644
index 0000000..1e8522d
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_clearrecord.xml
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"
+		style="@style/DefaultAToolbar"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:padding="30dp">
+
+		<cc.winboll.studio.libaes.views.AOHPCTCSeekBar
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:id="@+id/activityclearrecordAOHPCTCSeekBar1"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_horizontal">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:id="@+id/activityclearrecordTextView1"
+			android:textAppearance="?android:attr/textAppearanceSmall"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_marginTop="10dp"
+		android:layout_weight="1.0"
+		android:background="@drawable/bg_frame">
+
+		<LinearLayout
+			android:orientation="horizontal"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="center_horizontal">
+
+			<TextView
+				android:layout_width="0dp"
+				android:layout_height="wrap_content"
+				android:text="Record Text"
+				android:textStyle="bold"
+				android:gravity="center_horizontal"
+				android:layout_weight="1.0"
+				android:layout_marginLeft="10dp"
+				android:background="#FFD5D5D5"/>
+
+			<Switch
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="&lt;↲&gt;"
+				android:id="@+id/activityclearrecordSwitch1"
+				android:onClick="onShowRecordWithEnter"
+				android:layout_marginLeft="10dp"
+				android:layout_marginRight="10dp"/>
+
+		</LinearLayout>
+
+		<ScrollView
+			android:layout_width="match_parent"
+			android:layout_height="0dp"
+			android:layout_weight="1.0"
+			android:padding="10dp">
+
+			<TextView
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:textSize="@dimen/text_content_size"
+				android:id="@+id/activityclearrecordTextView2"/>
+
+		</ScrollView>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_main.xml b/powerbell/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..de40e2f
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_main.xml
@@ -0,0 +1,249 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"
+		style="@style/DefaultAToolbar"/>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<RelativeLayout
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/activitymainRelativeLayout1">
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:id="@+id/ll_backgroundview">
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="match_parent">
+
+				<LinearLayout
+					android:orientation="vertical"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:id="@+id/fragmentmainviewLinearLayout3"
+					android:layout_marginLeft="10dp"
+					android:layout_marginRight="10dp"
+					android:layout_marginTop="10dp">
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:gravity="center_vertical"
+						android:background="@drawable/bg_frame">
+
+						<Switch
+							android:layout_width="0dp"
+							android:layout_height="wrap_content"
+							android:id="@+id/fragmentandroidviewSwitch1"
+							android:padding="10dp"
+							android:layout_weight="1.0"
+							android:textSize="@dimen/text_title_size"/>
+
+					</LinearLayout>
+
+				</LinearLayout>
+
+				<LinearLayout
+					android:orientation="vertical"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:layout_weight="1.0"
+					android:layout_marginLeft="10dp"
+					android:layout_marginRight="10dp">
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_width="match_parent"
+						android:layout_height="match_parent"
+						android:layout_weight="1.0">
+
+						<LinearLayout
+							android:orientation="vertical"
+							android:layout_width="50dp"
+							android:layout_height="match_parent"
+							android:layout_marginTop="20dp"
+							android:layout_marginBottom="20dp"
+							android:id="@+id/fragmentmainviewLinearLayout1">
+
+							<ImageView
+								android:layout_width="36dp"
+								android:layout_height="36dp"
+								android:background="@drawable/usege"
+								android:layout_gravity="center_horizontal"
+								android:layout_marginTop="10dp"/>
+
+							<CheckBox
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:layout_gravity="center_horizontal"
+								android:layout_marginTop="10dp"
+								android:id="@+id/fragmentmainviewCheckBox2"/>
+
+							<cc.winboll.studio.powerbell.views.VerticalSeekBar
+								android:layout_width="match_parent"
+								android:layout_height="wrap_content"
+								android:id="@+id/fragmentandroidviewVerticalSeekBar2"
+								android:progressTint="@color/colorUsege"
+								android:progressBackgroundTint="@color/colorUsege"
+								android:layout_weight="1.0"
+								android:layout_margin="10dp"/>
+
+						</LinearLayout>
+
+						<LinearLayout
+							android:orientation="vertical"
+							android:layout_width="0dp"
+							android:layout_height="match_parent"
+							android:layout_weight="1.0">
+
+							<TextView
+								android:layout_width="match_parent"
+								android:layout_height="wrap_content"
+								android:text="100%"
+								android:textSize="@dimen/text_title_size"
+								android:layout_gravity="center_horizontal"
+								android:id="@+id/fragmentandroidviewTextView3"
+								android:gravity="center_horizontal"/>
+
+							<ImageView
+								android:layout_width="match_parent"
+								android:layout_height="0dp"
+								android:id="@+id/fragmentandroidviewImageView2"
+								android:layout_weight="1.0"/>
+
+						</LinearLayout>
+
+						<LinearLayout
+							android:orientation="vertical"
+							android:layout_width="0dp"
+							android:layout_height="match_parent"
+							android:layout_weight="1.0">
+
+							<TextView
+								android:layout_width="match_parent"
+								android:layout_height="wrap_content"
+								android:text="100%"
+								android:textSize="@dimen/text_title_size"
+								android:layout_gravity="center_horizontal"
+								android:gravity="center_horizontal"
+								android:id="@+id/fragmentandroidviewTextView4"/>
+
+							<ImageView
+								android:layout_width="match_parent"
+								android:layout_height="0dp"
+								android:id="@+id/fragmentandroidviewImageView1"
+								android:layout_weight="1.0"/>
+
+						</LinearLayout>
+
+						<LinearLayout
+							android:orientation="vertical"
+							android:layout_width="0dp"
+							android:layout_height="match_parent"
+							android:layout_weight="1.0">
+
+							<TextView
+								android:layout_width="match_parent"
+								android:layout_height="wrap_content"
+								android:text="100%"
+								android:textSize="@dimen/text_title_size"
+								android:layout_gravity="center_horizontal"
+								android:id="@+id/fragmentandroidviewTextView2"
+								android:gravity="center_horizontal"/>
+
+							<ImageView
+								android:layout_width="match_parent"
+								android:layout_height="0dp"
+								android:id="@+id/fragmentandroidviewImageView3"
+								android:layout_weight="1.0"/>
+
+						</LinearLayout>
+
+						<LinearLayout
+							android:orientation="vertical"
+							android:layout_width="50dp"
+							android:layout_height="match_parent"
+							android:layout_marginBottom="20dp"
+							android:layout_marginTop="20dp"
+							android:id="@+id/fragmentmainviewLinearLayout2">
+
+							<ImageView
+								android:layout_width="36dp"
+								android:layout_height="36dp"
+								android:background="@drawable/charge"
+								android:layout_gravity="center_horizontal"
+								android:layout_marginTop="10dp"/>
+
+							<CheckBox
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:layout_gravity="center_horizontal"
+								android:layout_marginTop="10dp"
+								android:id="@+id/fragmentmainviewCheckBox1"/>
+
+							<cc.winboll.studio.powerbell.views.VerticalSeekBar
+								android:layout_width="match_parent"
+								android:layout_height="wrap_content"
+								android:id="@+id/fragmentandroidviewVerticalSeekBar1"
+								android:progressTint="@color/colorCharge"
+								android:progressBackgroundTint="@color/colorCharge"
+								android:layout_weight="1.0"
+								android:layout_margin="10dp"/>
+
+						</LinearLayout>
+
+					</LinearLayout>
+
+				</LinearLayout>
+
+				<LinearLayout
+					android:layout_height="wrap_content"
+					android:layout_width="match_parent">
+
+					<TextView
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:text="Tips"
+						android:textSize="@dimen/text_content_size"
+						android:id="@+id/fragmentandroidviewTextView1"
+						android:background="@drawable/bg_frame"
+						android:padding="10dp"/>
+
+				</LinearLayout>
+
+			</LinearLayout>
+
+			<ViewStub
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:id="@+id/stub_ads_banner"
+				android:layout_alignParentBottom="true"
+				android:layout="@layout/view_ads_banner"/>
+
+		</RelativeLayout>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_mainunittest.xml b/powerbell/src/main/res/layout/activity_mainunittest.xml
new file mode 100644
index 0000000..583ef92
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_mainunittest.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+	
+	<RelativeLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:background="#FF0C6BBF">
+
+		<cc.winboll.studio.powerbell.views.BackgroundView
+			xmlns:app="http://schemas.android.com/apk/res-auto"
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/backgroundview"/>
+
+		<HorizontalScrollView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:background="#AF4FDA4E">
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content">
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="Main"
+					android:id="@+id/btn_main_activity"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="TestCropImage"
+					android:id="@+id/btn_test_cropimage"/>
+
+			</LinearLayout>
+
+		</HorizontalScrollView>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_mainunittest2.xml b/powerbell/src/main/res/layout/activity_mainunittest2.xml
new file mode 100644
index 0000000..04433e4
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_mainunittest2.xml
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<RelativeLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:background="#FF0C6BBF">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/ll_backgroundview">
+		</LinearLayout>
+
+		<HorizontalScrollView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:background="#AF4FDA4E">
+
+			<LinearLayout
+				android:orientation="horizontal"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content">
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="Main"
+					android:id="@+id/btn_main_activity"/>
+
+				<Button
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="TestCropImage"
+					android:id="@+id/btn_test_cropimage"/>
+
+			</LinearLayout>
+
+		</HorizontalScrollView>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_pixelpicker.xml b/powerbell/src/main/res/layout/activity_pixelpicker.xml
new file mode 100644
index 0000000..9cb6031
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_pixelpicker.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"
+		style="@style/DefaultAToolbar"/>
+
+	<RelativeLayout
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<RelativeLayout
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:background="#FFEE2121"
+			android:id="@+id/activitypixelpickerRelativeLayout1"/>
+
+		<FrameLayout
+			android:id="@+id/imageContainer"
+			android:layout_width="match_parent"
+			android:layout_height="match_parent">
+
+			<ImageView
+				android:id="@+id/imageView"
+				android:layout_width="match_parent"
+				android:layout_height="match_parent"
+				android:src="@drawable/ic_launcher"/>
+
+		</FrameLayout>
+
+		<TextView
+			android:id="@+id/infoText"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:layout_alignParentBottom="true"
+			android:layout_centerHorizontal="true"
+			android:padding="10dp"
+			android:background="#80000000"
+			android:textColor="#FFFFFF"
+			android:text="点击图片获取像素值"/>
+
+	</RelativeLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_settings.xml b/powerbell/src/main/res/layout/activity_settings.xml
new file mode 100644
index 0000000..029bdac
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_settings.xml
@@ -0,0 +1,204 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="@dimen/toolbar_height"
+		android:id="@+id/toolbar"
+		android:gravity="center_vertical"
+		style="@style/DefaultAToolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			android:orientation="vertical"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content">
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:gravity="right">
+
+				<LinearLayout
+					android:orientation="vertical"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"
+					android:background="@drawable/bg_frame"
+					android:padding="10dp">
+
+					<TextView
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content"
+						android:text="TTS语音服务设置："
+						android:paddingLeft="10dp"/>
+
+					<TextView
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content"
+						android:text="&lt;仅限在切换充电状态时，发送的TTS语音提醒。用于提醒用户当前的服务设置状态。&gt;"
+						android:textSize="12sp"
+						android:paddingLeft="10dp"
+						android:paddingRight="10dp"/>
+
+					<LinearLayout
+						android:orientation="vertical"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content">
+
+						<CheckBox
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="用电提醒启用时的TTS贴心服务"
+							android:onClick="onEnableUsePowerTts"
+							android:id="@+id/activitysettingsCheckBox1"/>
+
+						<LinearLayout
+							android:orientation="horizontal"
+							android:layout_width="match_parent"
+							android:layout_height="wrap_content"
+							android:gravity="center_vertical">
+
+							<TextView
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="("
+								android:layout_marginLeft="10dp"/>
+
+							<CheckBox
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="用电TTS加入电量提醒"
+								android:onClick="onEnableUseageTtsWithBattary"
+								android:id="@+id/activitysettingsCheckBox3"/>
+
+							<TextView
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text=")"
+								android:layout_marginLeft="20dp"/>
+
+						</LinearLayout>
+
+						<CheckBox
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="充电提醒启用时的TTS贴心服务"
+							android:onClick="onEnableChargeTts"
+							android:id="@+id/activitysettingsCheckBox2"/>
+
+						<LinearLayout
+							android:orientation="horizontal"
+							android:layout_width="match_parent"
+							android:layout_height="wrap_content"
+							android:gravity="center_vertical">
+
+							<TextView
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="("
+								android:layout_marginLeft="10dp"/>
+
+							<CheckBox
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="充电TTS加入电量提醒"
+								android:onClick="onEnableChargeTtsWithBattary"
+								android:id="@+id/activitysettingsCheckBox4"/>
+
+							<TextView
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text=")"
+								android:layout_marginLeft="20dp"/>
+
+						</LinearLayout>
+
+						<!-- 👉 你要的新选项：允许通知电量消息时同时播放TTS语音 -->
+						<CheckBox
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="允许通知电量消息时同时播放TTS语音"
+							android:onClick="onEnableTtsWhenNotifyBattery"
+							android:id="@+id/activitysettingsCheckBox5"/>
+
+					</LinearLayout>
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:gravity="right">
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="检查TTS语音悬浮窗权限"
+							android:padding="10dp"
+							android:onClick="onCheckTTSDrawOverlaysPermission"
+							android:layout_marginRight="10dp"/>
+
+					</LinearLayout>
+
+				</LinearLayout>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:layout_width="match_parent"
+				android:layout_height="300dp"
+				android:orientation="vertical"
+				android:background="@drawable/bg_frame"
+				android:padding="10dp">
+
+				<LinearLayout
+					android:orientation="horizontal"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content">
+
+					<TextView
+						android:layout_width="wrap_content"
+						android:layout_height="wrap_content"
+						android:text="电量图表绘制风格设置："
+						android:paddingLeft="10dp"/>
+
+				</LinearLayout>
+
+				<cc.winboll.studio.powerbell.views.BatteryStyleView
+					android:id="@+id/battery_style_view"
+					android:layout_width="match_parent"
+					android:layout_height="1200dp"
+					app:batteryPreviewColor="@color/colorPrimary"
+					app:previewBatteryValue="100"
+					app:defaultSelectedStyle="zebra_style"/>
+
+			</LinearLayout>
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="wrap_content"
+				android:background="@drawable/bg_frame">
+
+				<cc.winboll.studio.libaes.views.ADsControlView
+					android:id="@+id/ads_control_view"
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content"/>
+
+			</LinearLayout>
+
+		</LinearLayout>
+
+	</ScrollView>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/activity_unbelievable.xml b/powerbell/src/main/res/layout/activity_unbelievable.xml
new file mode 100644
index 0000000..648e807
--- /dev/null
+++ b/powerbell/src/main/res/layout/activity_unbelievable.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="match_parent">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:id="@+id/activityunbelievableTextView1"
+			android:padding="10dp"
+			android:textIsSelectable="true"/>
+
+	</ScrollView>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/custom_notification.xml b/powerbell/src/main/res/layout/custom_notification.xml
new file mode 100644
index 0000000..53ddf4b
--- /dev/null
+++ b/powerbell/src/main/res/layout/custom_notification.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:id="@+id/ll_notification">
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/custom_notification_expanded.xml b/powerbell/src/main/res/layout/custom_notification_expanded.xml
new file mode 100644
index 0000000..b93059b
--- /dev/null
+++ b/powerbell/src/main/res/layout/custom_notification_expanded.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:id="@+id/ll_notification">
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="Text"
+		android:id="@+id/info_tv"/>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/dialog_backgroundpicturepreview.xml b/powerbell/src/main/res/layout/dialog_backgroundpicturepreview.xml
new file mode 100644
index 0000000..a255164
--- /dev/null
+++ b/powerbell/src/main/res/layout/dialog_backgroundpicturepreview.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="300dp"
+	android:layout_height="wrap_content">
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="300dp"
+		android:layout_height="wrap_content"
+		android:background="#FF1FD3CE">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="是否使用下列图片作为应用背景图？"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="300dp"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical|center_horizontal">
+
+		<cc.winboll.studio.powerbell.views.BackgroundView
+			android:orientation="vertical"
+			android:layout_width="200dp"
+			android:layout_height="200dp"
+			android:id="@+id/backgroundview"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="300dp"
+		android:layout_height="wrap_content"
+		android:gravity="right">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Cancel"
+			android:id="@+id/dialogbackgroundpicturepreviewButton1"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="OK"
+			android:id="@+id/dialogbackgroundpicturepreviewButton2"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/dialog_color_palette.xml b/powerbell/src/main/res/layout/dialog_color_palette.xml
new file mode 100644
index 0000000..581ce8c
--- /dev/null
+++ b/powerbell/src/main/res/layout/dialog_color_palette.xml
@@ -0,0 +1,198 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:orientation="vertical"
+	android:padding="20dp"
+	android:background="#FFFFFFFF">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_horizontal">
+
+		<ImageView
+			android:id="@+id/iv_color_picker"
+			android:layout_width="100dp"
+			android:layout_height="100dp"
+			android:background="#FF0000"
+			android:clickable="true"
+			android:focusable="true"/>
+
+		<ImageView
+			android:id="@+id/iv_color_scaler"
+			android:layout_width="100dp"
+			android:layout_height="100dp"
+			android:clickable="true"
+			android:focusable="true"
+			android:src="@drawable/color_scale_logo"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="horizontal"
+		android:gravity="center_vertical"
+		android:layout_marginBottom="15dp">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="RGB："
+			android:textSize="16sp"/>
+
+		<EditText
+			android:id="@+id/et_r"
+			android:layout_width="60dp"
+			android:layout_height="40dp"
+			android:layout_marginLeft="10dp"
+			android:hint="R"
+			android:inputType="number"
+			android:gravity="center"
+			android:maxLength="3"/>
+
+		<EditText
+			android:id="@+id/et_g"
+			android:layout_width="60dp"
+			android:layout_height="40dp"
+			android:layout_marginLeft="10dp"
+			android:hint="G"
+			android:inputType="number"
+			android:gravity="center"
+			android:maxLength="3"/>
+
+		<EditText
+			android:id="@+id/et_b"
+			android:layout_width="60dp"
+			android:layout_height="40dp"
+			android:layout_marginLeft="10dp"
+			android:hint="B"
+			android:inputType="number"
+			android:gravity="center"
+			android:maxLength="3"/>
+
+	</LinearLayout>
+
+	<EditText
+		android:id="@+id/et_color_value"
+		android:layout_width="match_parent"
+		android:layout_height="40dp"
+		android:hint="#AARRGGBB"
+		android:inputType="text"
+		android:gravity="center"
+		android:maxLength="9"
+		android:layout_marginBottom="15dp"/>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="vertical"
+		android:layout_marginBottom="15dp">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="horizontal"
+			android:gravity="center_vertical"
+			android:layout_marginBottom="5dp">
+
+			<TextView
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="透明度："
+				android:textSize="16sp"/>
+
+			<TextView
+				android:id="@+id/tv_alpha_value"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="100%"
+				android:textSize="16sp"
+				android:layout_marginLeft="10dp"/>
+
+		</LinearLayout>
+
+		<SeekBar
+			android:id="@+id/sb_alpha"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:max="100"
+			android:progress="100"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="horizontal"
+		android:gravity="center_horizontal"
+		android:layout_marginBottom="20dp">
+
+		<TextView
+			android:id="@+id/tv_brightness_minus"
+			android:layout_width="40dp"
+			android:layout_height="40dp"
+			android:text="-"
+			android:textSize="20sp"
+			android:gravity="center"
+			android:background="@drawable/btn_common"
+			android:clickable="true"
+			android:focusable="true"/>
+
+		<TextView
+			android:id="@+id/tv_brightness_value"
+			android:layout_width="80dp"
+			android:layout_height="40dp"
+			android:text="100%"
+			android:textSize="16sp"
+			android:gravity="center"/>
+
+		<TextView
+			android:id="@+id/tv_brightness_plus"
+			android:layout_width="40dp"
+			android:layout_height="40dp"
+			android:text="+"
+			android:textSize="20sp"
+			android:gravity="center"
+			android:background="@drawable/btn_common"
+			android:clickable="true"
+			android:focusable="true"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:orientation="horizontal"
+		android:gravity="center_horizontal">
+
+		<TextView
+			android:id="@+id/tv_cancel"
+			android:layout_width="100dp"
+			android:layout_height="45dp"
+			android:text="取消"
+			android:textSize="16sp"
+			android:gravity="center"
+			android:background="@drawable/btn_common"
+			android:clickable="true"
+			android:focusable="true"
+			android:layout_marginRight="20dp"/>
+
+		<TextView
+			android:id="@+id/tv_confirm"
+			android:layout_width="100dp"
+			android:layout_height="45dp"
+			android:text="确认"
+			android:textSize="16sp"
+			android:gravity="center"
+			android:background="@drawable/btn_common"
+			android:clickable="true"
+			android:focusable="true"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/dialog_networkbackground.xml b/powerbell/src/main/res/layout/dialog_networkbackground.xml
new file mode 100644
index 0000000..2b5cf40
--- /dev/null
+++ b/powerbell/src/main/res/layout/dialog_networkbackground.xml
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:layout_margin="16dp"
+	android:orientation="vertical"
+	android:background="@android:color/white"
+	android:padding="20dp"
+	android:radius="12dp">
+
+	<TextView
+		android:id="@+id/tv_dialog_title"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="网络图片资源下载"
+		android:textSize="18sp"
+		android:textColor="@android:color/black"
+		android:textStyle="bold"/>
+
+	<TextView
+		android:id="@+id/tv_dialog_content"
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp"
+		android:text="请输入网络图片地址："
+		android:textSize="15sp"
+		android:textColor="@android:color/darker_gray"/>
+	
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="12dp">
+
+		<EditText
+			android:layout_width="0dp"
+			android:ems="10"
+			android:layout_height="wrap_content"
+			android:layout_weight="1.0"
+			android:id="@+id/et_url"
+			android:singleLine="true"/>
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="↻"
+			android:id="@+id/btn_preview"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="100dp"
+		android:layout_marginTop="12dp"
+		android:layout_gravity="center_vertical">
+
+		<cc.winboll.studio.powerbell.views.BackgroundView
+			android:layout_width="100dp"
+			android:layout_height="100dp"
+			android:id="@+id/bv_background_preview"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_marginTop="20dp"
+		android:orientation="horizontal"
+		android:gravity="end">
+
+		<Button
+			android:id="@+id/btn_cancel"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="关闭返回"
+			android:textSize="14sp"
+			android:background="@android:drawable/btn_default_small"
+			android:layout_marginRight="8dp"/>
+
+		<Button
+			android:id="@+id/btn_confirm"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="使用图片"
+			android:textSize="14sp"
+			android:background="@android:drawable/btn_default_small"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/dialog_pixel.xml b/powerbell/src/main/res/layout/dialog_pixel.xml
new file mode 100644
index 0000000..182ee4a
--- /dev/null
+++ b/powerbell/src/main/res/layout/dialog_pixel.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="240dp"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:padding="16dp">
+
+    <TextView
+        android:id="@+id/pixelColorView"
+        android:layout_width="200dp"
+        android:layout_height="200dp"
+        android:layout_gravity="center_horizontal" />
+
+    <TextView
+        android:id="@+id/colorInfoText"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_gravity="center_horizontal"
+        android:layout_marginTop="8dp"
+        android:textColor="#333333"
+        android:textSize="14sp" />
+
+    <Button
+        android:id="@+id/confirmButton"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="16dp"
+        android:background="@android:color/holo_blue_light"
+        android:text="确定"
+        android:textColor="@android:color/white" />
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/item_battery_report.xml b/powerbell/src/main/res/layout/item_battery_report.xml
new file mode 100644
index 0000000..048d3a8
--- /dev/null
+++ b/powerbell/src/main/res/layout/item_battery_report.xml
@@ -0,0 +1,34 @@
+<?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="horizontal"
+    android:padding="12dp"
+    android:gravity="center_vertical"
+    android:background="@android:color/white">
+
+    <TextView
+        android:id="@+id/tvLevel"
+        android:layout_width="80dp"
+        android:layout_height="wrap_content"
+        android:textSize="18sp"
+        android:fontFamily="sans-serif-medium"/>
+
+    <TextView
+        android:id="@+id/tvDischargeTime"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_weight="1"
+        android:textSize="16sp"
+        android:paddingStart="16dp"/>
+
+    <TextView
+        android:id="@+id/tvChargeTime"
+        android:layout_width="0dp"
+        android:layout_height="wrap_content"
+        android:layout_weight="1"
+        android:textSize="16sp"
+        android:paddingStart="16dp"/>
+
+</LinearLayout>
diff --git a/powerbell/src/main/res/layout/layout_color_grid.xml b/powerbell/src/main/res/layout/layout_color_grid.xml
new file mode 100644
index 0000000..6c0f8fd
--- /dev/null
+++ b/powerbell/src/main/res/layout/layout_color_grid.xml
@@ -0,0 +1,9 @@
+<?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="horizontal"
+    android:gravity="center"
+    android:padding="10dp">
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/view_ads_banner.xml b/powerbell/src/main/res/layout/view_ads_banner.xml
new file mode 100644
index 0000000..7822296
--- /dev/null
+++ b/powerbell/src/main/res/layout/view_ads_banner.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 广告视图独立布局（供ViewStub延迟加载） -->
+<cc.winboll.studio.libaes.views.ADsBannerView
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:id="@+id/adsbanner"/>
diff --git a/powerbell/src/main/res/layout/view_background.xml b/powerbell/src/main/res/layout/view_background.xml
new file mode 100644
index 0000000..eb462eb
--- /dev/null
+++ b/powerbell/src/main/res/layout/view_background.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:id="@+id/bg_main">
+
+	<ImageView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:id="@+id/bg_imageview"/>
+
+</RelativeLayout>
+
diff --git a/powerbell/src/main/res/layout/view_battery_style.xml b/powerbell/src/main/res/layout/view_battery_style.xml
new file mode 100644
index 0000000..8b36cdb
--- /dev/null
+++ b/powerbell/src/main/res/layout/view_battery_style.xml
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RadioGroup
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:id="@+id/rg_battery_style"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="horizontal"
+	android:gravity="center_vertical"
+	android:padding="8dp"
+	android:spacing="16dp">
+
+	<LinearLayout
+		android:layout_width="0dp"
+		android:layout_height="match_parent"
+		android:layout_weight="1"
+		android:orientation="vertical"
+		android:gravity="center_horizontal"
+		android:padding="4dp">
+
+		<RadioButton
+			android:id="@+id/rb_energy_style"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="@string/energy_style"
+			android:textSize="14sp"
+			android:buttonTint="@color/colorPrimary"
+			android:textColor="@color/colorPrimary"/>
+
+		<RelativeLayout
+			android:id="@+id/rl_energy_preview"
+			android:layout_width="match_parent"
+			android:layout_height="0dp"
+			android:background="#F5F5F5"
+			android:padding="1dp"
+			android:layout_weight="1.0"/>
+
+	</LinearLayout>
+	
+	<LinearLayout
+		android:layout_width="0dp"
+		android:layout_height="match_parent"
+		android:layout_weight="1"
+		android:orientation="vertical"
+		android:gravity="center_horizontal"
+		android:padding="4dp">
+
+		<RadioButton
+			android:id="@+id/rb_zebra_style"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="@string/zebra_style"
+			android:textSize="14sp"
+			android:buttonTint="@color/colorPrimary"
+			android:textColor="@color/colorPrimary"/>
+
+		<RelativeLayout
+			android:id="@+id/rl_zebra_preview"
+			android:layout_width="match_parent"
+			android:layout_height="0dp"
+			android:background="#F5F5F5"
+			android:padding="1dp"
+			android:layout_weight="1.0"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:layout_width="0dp"
+		android:layout_height="match_parent"
+		android:layout_weight="1"
+		android:orientation="vertical"
+		android:gravity="center_horizontal"
+		android:padding="4dp">
+
+		<RadioButton
+			android:id="@+id/rb_point_style"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="@string/point_style"
+			android:textSize="14sp"
+			android:buttonTint="@color/colorPrimary"
+			android:textColor="@color/colorPrimary"/>
+
+		<RelativeLayout
+			android:id="@+id/rl_point_preview"
+			android:layout_width="match_parent"
+			android:layout_height="0dp"
+			android:background="#F5F5F5"
+			android:padding="1dp"
+			android:layout_weight="1.0"/>
+
+	</LinearLayout>
+	
+</RadioGroup>
+
diff --git a/powerbell/src/main/res/layout/view_remindnotification.xml b/powerbell/src/main/res/layout/view_remindnotification.xml
new file mode 100644
index 0000000..2774fcb
--- /dev/null
+++ b/powerbell/src/main/res/layout/view_remindnotification.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:id="@+id/remoteviewLinearLayout1">
+
+	<ImageView
+		android:layout_width="60dp"
+		android:layout_height="60dp"
+		android:id="@+id/remoteviewImageView1"
+		android:layout_gravity="center_vertical"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical">
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Title"
+			android:textSize="@dimen/text_title_size"
+			android:textStyle="bold"
+			android:id="@+id/viewremindnotificationTextView1"/>
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:textSize="14sp"
+			android:textColor="@color/colorUsege"
+			android:background="@color/colorUsege"
+			android:id="@+id/remoteviewUsege"/>
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:textSize="14sp"
+			android:id="@+id/remoteviewCharge"
+			android:textColor="@color/colorCharge"
+			android:background="@color/colorCharge"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/view_servicenotification.xml b/powerbell/src/main/res/layout/view_servicenotification.xml
new file mode 100644
index 0000000..b000a23
--- /dev/null
+++ b/powerbell/src/main/res/layout/view_servicenotification.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="wrap_content"
+	android:id="@+id/remoteviewLinearLayout1">
+
+	<ImageView
+		android:layout_width="60dp"
+		android:layout_height="60dp"
+		android:id="@+id/remoteviewImageView1"
+		android:layout_gravity="center_vertical"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="center_vertical">
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:textSize="@dimen/text_title_size"
+			android:id="@+id/remoteviewTextView1"
+			android:textStyle="bold"/>
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:textSize="@dimen/text_content_size"
+			android:id="@+id/remoteviewTextView3"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/layout/view_tts_back.xml b/powerbell/src/main/res/layout/view_tts_back.xml
new file mode 100644
index 0000000..5020d77
--- /dev/null
+++ b/powerbell/src/main/res/layout/view_tts_back.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="horizontal"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="@drawable/bg_frame_white"
+	android:layout_gravity="center_vertical|center_horizontal"
+	android:id="@+id/viewttsbackLinearLayout1">
+
+	<LinearLayout
+		xmlns:app="http://schemas.android.com/apk/res-auto"
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:padding="10dp"
+		android:gravity="center_horizontal">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="@string/app_name"
+			android:textColor="#FF000000"
+			android:textStyle="bold"
+			android:textAppearance="?android:attr/textAppearanceLarge"/>
+
+		<ImageView
+			android:layout_width="50dp"
+			android:layout_height="50dp"
+			android:textAllCaps="false"
+			android:background="@drawable/speaker"/>
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Click To Stop TTS Play"
+			android:textAppearance="?android:attr/textAppearanceSmall"
+			android:textColor="#FF000000"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/powerbell/src/main/res/menu/toolbar_main.xml b/powerbell/src/main/res/menu/toolbar_main.xml
new file mode 100644
index 0000000..ed2174d
--- /dev/null
+++ b/powerbell/src/main/res/menu/toolbar_main.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    <item
+        android:id="@+id/action_battery_report"
+        android:title="@string/item_battery_report"/>
+    <item
+        android:id="@+id/action_clearrecord"
+        android:title="@string/item_clearrecord"/>
+    <item
+        android:id="@+id/action_changepicture"
+        android:title="@string/item_changepicture"/>
+    <item
+        android:id="@+id/action_settings"
+        android:title="@string/item_settings"/>
+    <item
+        android:id="@+id/action_about"
+        android:title="@string/item_about"/>
+</menu>
diff --git a/powerbell/src/main/res/menu/toolbar_unittest.xml b/powerbell/src/main/res/menu/toolbar_unittest.xml
new file mode 100644
index 0000000..45e394e
--- /dev/null
+++ b/powerbell/src/main/res/menu/toolbar_unittest.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <item
+        android:id="@+id/action_unittestactivity"
+        android:title="MainUnitTestActivity"/>
+
+    <item
+        android:id="@+id/action_unittest2activity"
+        android:title="MainUnitTest2Activity"/>
+
+</menu>
diff --git a/powerbell/src/main/res/values-zh/strings.xml b/powerbell/src/main/res/values-zh/strings.xml
new file mode 100644
index 0000000..6c1132f
--- /dev/null
+++ b/powerbell/src/main/res/values-zh/strings.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name_cn1">能源钟</string>
+    <string name="app_name_cn2">泡额呗额</string>
+    <string name="app_description">一个接收手机电量信息的应用，当电量值达到设定范围时会提醒用户。</string>
+    <string name="about_crashed">本应用崩溃了，作者水平有限，敬请谅解！</string>
+    <string name="item_main">主窗口</string>
+    <string name="item_about">关于</string>
+    <string name="item_settings">应用设置</string>
+    <string name="item_battery_report">应用耗电记录</string>
+    <string name="item_mainunittestactivity">开发调试窗口</string>
+    <string name="item_clearrecord">清理电量记录</string>
+    <string name="item_changepicture">更换背景图片</string>
+    <string name="item_devoloperoptionsview">开发调试窗口</string>
+    <string name="item_logview">日志窗口</string>
+    <string name="item_sourceview">源码窗口</string>
+    <string name="txt_aboveswitch">消息总开关</string>
+    <string name="txt_aboveswitchtips">当电量低于左边（放电状态）或高于右边（充电状态），就会发送一个提醒铃声。</string>
+    <string name="texthint_CustomSlideToCleanRecord">Slide Right To Clean Up APP Record.</string>
+    <string name="subtitle_activity_clearrecord">清理记录</string>
+    <string name="subtitle_activity_backgroundpicture">更换背景图片</string>
+    <string name="subtitle_activity_pixelpicker">背景像素拾取</string>
+    <string name="subtitle_activity_about">关于应用</string>
+	<string name="msg_AOHPCTCSeekBar_ClearRecord">&gt;&gt;&gt;向右滑动100%可以清理电量记录。&gt;&gt;&gt;</string>
+	<string name="msg_no_battery_record">无电池记录数据</string>
+</resources>
diff --git a/powerbell/src/main/res/values/attrs.xml b/powerbell/src/main/res/values/attrs.xml
new file mode 100644
index 0000000..a4c52b6
--- /dev/null
+++ b/powerbell/src/main/res/values/attrs.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- BatteryStyleView 自定义属性 -->
+    <declare-styleable name="BatteryStyleView">
+        <attr name="batteryPreviewColor" format="color"/>
+        <attr name="previewBatteryValue" format="integer"/>
+        <attr name="defaultSelectedStyle" format="integer">
+            <enum name="zebra_style" value="0"/>
+            <enum name="energy_style" value="1"/>
+        </attr>
+    </declare-styleable>
+</resources>
diff --git a/powerbell/src/main/res/values/colors.xml b/powerbell/src/main/res/values/colors.xml
new file mode 100644
index 0000000..f08fbe8
--- /dev/null
+++ b/powerbell/src/main/res/values/colors.xml
@@ -0,0 +1,130 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!--
+    <color name="colorPrimary">@color/colorShui</color>
+    <color name="colorPrimaryDark">@color/colorXinling</color>
+    <color name="colorAccent">@color/colorShui</color>
+    -->
+    <!-- 地球超人主题配置方案 -->
+    <!--
+    我们的大地神盖亚已经无法忍受世界的环境污染恐怕会毁了地球，
+    她把五个拥有巨大魔力的戒指给了五大洲的五个特殊中学生：
+    非洲的夸美，拥有土地的威力;
+    北美的辉乐，拥有火的威力;
+    苏联的琳卡，拥有风的威力;
+    亚洲的姬伊，拥有水的威力;
+    南美的玛狄，拥有心灵的威力。
+    五个中学生的威力联合起来，就能唤来最伟大的地球超人! 
+    地球超人!力量是你们的!
+    引用：(360百科) https://m.baike.so.com/doc/2093525-2214593.html
+    -->
+    <color name="colorTudi">#FF05CF00</color>
+    <color name="colorHuo">#FFC61414</color>
+    <color name="colorFeng">#FFDEDEDE</color>
+    <color name="colorShui">#FF009ADE</color>
+    <color name="colorShuiDark">#FF0072A4</color>
+    <color name="colorShuiAccent">#FF33C1FF</color>
+    <color name="colorXinling">#FFFCC500</color>
+    <!--<color name="colorPrimary">@color/colorShuiDark</color>
+    <color name="colorPrimaryDark">@color/colorFeng</color>
+    <color name="colorAccent">@color/colorShui</color>
+	-->
+    <color name="colorYellow">#FFBEBE48</color>
+    <color name="colorRed">#FFC85C5C</color>
+    <color name="colorBlue">#FF2677C7</color>
+    <color name="colorBlack">#FF000000</color>
+	<color name="colorText">@color/colorBlack</color>
+    <!-- 调试配置
+    <color name="colorYellow">#FF630066</color>
+    <color name="colorRed">#FF23244D</color>
+    <color name="colorBlue">#FF00E2F7</color>
+    <color name="colorBlack">#FF54FF00</color>
+    -->
+    <!-- 明色配置 
+    <color name="colorYellow">#FFFFBD00</color>
+    <color name="colorRed">#FFE00000</color>
+    <color name="colorBlue">#FF000DE5</color>
+    <color name="colorBlack">#FF000000</color>
+    -->
+    <!-- 原色配置 -->
+    <!--<color name="colorYellow">#FFFFFF00</color>
+    <color name="colorRed">#FFFF0000</color>
+    <color name="colorBlue">#FF000FFF</color>
+    <color name="colorBlack">#FF000000</color>
+	-->
+    <color name="colorPrimary">@color/colorShui</color>
+    <color name="colorPrimaryDark">@color/colorShuiDark</color>
+    <color name="colorAccent">@color/colorShuiAccent</color>
+    <color name="colorUsege">@color/colorRed</color>
+    <color name="colorCurrent">@color/colorBlue</color>
+    <color name="colorCharge">@color/colorYellow</color>
+
+    <!--CustomSlideToUnlockView控件配置-->
+    <color name="colorCustomSlideToUnlockViewWhite">#FFFFFFFF</color>
+
+	<!-- ============== 基础黑白（必含，适配文字/背景） ============== -->
+	<color name="white">#FFFFFF</color>          <!-- 纯白色（文字/背景） -->
+	<color name="black">#000000</color>          <!-- 近黑色（重要文字） -->
+
+	<!-- ============== 基础色系（按钮/强调色常用） ============== -->
+	<!-- 蓝色系（常用：确认/链接/主题色） -->
+	<color name="blue_light">#4A90E2</color>     <!-- 浅蓝（次要按钮） -->
+	<color name="blue_normal">#2196F3</color>    <!-- 标准蓝（主题/确认按钮） -->
+	<color name="blue_dark">#1976D2</color>      <!-- 深蓝（按压态/重要强调） -->
+	<!-- 绿色系（常用：成功/完成/安全提示） -->
+	<color name="green_light">#66BB6A</color>    <!-- 浅绿（次要成功态） -->
+	<color name="green_normal">#4CAF50</color>   <!-- 标准绿（成功按钮/提示） -->
+	<color name="green_dark">#388E3C</color>     <!-- 深绿（按压态/重要成功） -->
+	<!-- 红色系（常用：错误/警告/删除按钮） -->
+	<color name="red_light">#EF5350</color>      <!-- 浅红（次要错误提示） -->
+	<color name="red_normal">#F44336</color>     <!-- 标准红（删除/错误按钮） -->
+	<color name="red_dark">#D32F2F</color>       <!-- 深红（按压态/重要错误） -->
+	<!-- 黄色系（常用：警告/提醒/高亮） -->
+	<color name="yellow_light">#FFF59D</color>   <!-- 浅黄（次要提醒） -->
+	<color name="yellow_normal">#FFC107</color>  <!-- 标准黄（警告提示/高亮） -->
+	<color name="yellow_dark">#FFA000</color>    <!-- 深黄（重要警告） -->
+	<!-- 橙色系（常用：提醒/进度/活力色） -->
+	<color name="orange_normal">#FF9800</color>  <!-- 标准橙（提醒按钮/进度） -->
+	<!-- 紫色系（常用：特殊强调/个性按钮） -->
+	<color name="purple_normal">#9C27B0</color>  <!-- 标准紫（特殊功能按钮） -->
+
+	<!-- ============== 透明色（遮罩/背景叠加） ============== -->
+	<color name="transparent">#00000000</color>  <!-- 全透明 -->
+	<color name="black_transparent_50">#80000000</color> <!-- 50%透明黑（遮罩） -->
+
+
+
+	<!-- 1. 不透明灰色（常用深浅梯度，直接用） -->
+	<color name="gray_100">#F5F5F5</color> <!-- 极浅灰（接近白色，背景用） -->
+	<color name="gray_200">#EEEEEE</color> <!-- 浅灰（卡片/分割线背景） -->
+	<color name="gray_300">#E0E0E0</color> <!-- 中浅灰（边框/次要背景） -->
+	<color name="gray_400">#BDBDBD</color> <!-- 中灰（次要文字/图标） -->
+	<color name="gray_500">#9E9E9E</color> <!-- 标准中灰（常用辅助文字） -->
+	<color name="gray_600">#757575</color> <!-- 中深灰（常规辅助文字） -->
+	<color name="gray_700">#616161</color> <!-- 深灰（重要辅助文字） -->
+	<color name="gray_800">#424242</color> <!-- 极深灰（接近黑色，标题副文本） -->
+	<color name="gray_900">#212121</color> <!-- 近黑色（特殊场景用） -->
+
+	<!-- 2. 半透明灰色（带透明度，遮罩/蒙层用） -->
+	<color name="gray_transparent_30">#4D9E9E9E</color> <!-- 30%透明中灰（A=4D） -->
+	<color name="gray_transparent_50">#809E9E9E</color> <!-- 50%透明中灰（A=80） -->
+	<color name="gray_transparent_70">#B39E9E9E</color> <!-- 70%透明中灰（A=B3） -->
+
+	<color name="gray_light">#EEE</color>  <!-- 等价 #EEEEEE（浅灰） -->
+	<color name="gray_mid">#999</color>    <!-- 等价 #999999（中灰） -->
+	<color name="gray_dark">#666</color>   <!-- 等价 #666666（深灰） -->
+	<color name="gray_black">#333</color>  <!-- 等价 #333333（极深灰） -->
+
+	<!-- 50% 透明中灰（弹窗遮罩常用） -->
+	<color name="mask_gray">#809E9E9E</color>
+	<!-- 30% 透明深灰（背景叠加） -->
+	<color name="bg_overlay_gray">#4D424242</color>
+
+	<!-- 1. 常规灰色（按钮默认态，常用中灰） -->
+	<color name="btn_gray_normal">#9E9E9E</color>
+	<!-- 2. 按压深色（按钮点击态，加深一级，提升交互感） -->
+	<color name="btn_gray_pressed">#757575</color>
+	<!-- 3. 禁用灰色（按钮不可点击态，浅灰） -->
+	<color name="btn_gray_disabled">#E0E0E0</color>
+
+</resources>
diff --git a/powerbell/src/main/res/values/dimens.xml b/powerbell/src/main/res/values/dimens.xml
new file mode 100644
index 0000000..da4cd45
--- /dev/null
+++ b/powerbell/src/main/res/values/dimens.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <dimen name="toolbar_height">60dp</dimen>
+    <dimen name="slide_width">76dp</dimen>
+    <dimen name="text_content_size">18dp</dimen>
+    <dimen name="text_title_size">24dp</dimen>
+    <dimen name="text_subtitle_size">16dp</dimen>
+</resources>
diff --git a/powerbell/src/main/res/values/strings.xml b/powerbell/src/main/res/values/strings.xml
new file mode 100644
index 0000000..81c33f6
--- /dev/null
+++ b/powerbell/src/main/res/values/strings.xml
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">PowerBell</string>
+    <string name="app_name_cn1">能源钟</string>
+    <string name="app_name_cn2">泡额呗额</string>
+    <string name="app_projectname">PowerBell</string>
+    <string name="app_description">A mobile app that receives battery level information from a phone and alerts the user when the battery level reaches a predefined range.</string>
+    <string name="about_crashed">This application has crashed, the author level is limited, please understand!</string>
+    <string name="switchto_en1">PowerBell</string>
+    <string name="switchto_cn1">能源钟</string>
+    <string name="switchto_cn2">泡额呗额</string>
+    <string name="en1_switch_disabled">PowerBell X</string>
+    <string name="cn1_switch_disabled">能源钟 X</string>
+    <string name="cn2_switch_disabled">泡额呗额 X</string>
+    <string name="item_mainview">Main View</string>
+    <string name="item_about">About</string>
+    <string name="item_settings">Settings</string>
+    <string name="item_battery_report">Battery Report</string>
+    <string name="item_clearrecord">Clear Record</string>
+    <string name="item_changepicture">Change Picture</string>
+    <string name="item_devoloperoptionsview">Developer View</string>
+    <string name="item_logview">Log View</string>
+    <string name="item_mainunittestactivity">Debug Activity</string>
+    <string name="item_cleanlog">Clean Log</string>
+    <string name="item_sourceview">Source View</string>
+    <string name="txt_aboveswitch">Message master switch</string>
+    <string name="txt_aboveswitchtips">Send a remind ringtone, when power is lower than left (usage state) or higher than right (charged state).</string>
+    <string name="texthint_CustomSlideToCleanRecord">Slide Right To Clean Up APP Record.</string>
+    <string name="subtitle_activity_clearrecord">Clean Record</string>
+    <string name="subtitle_activity_backgroundpicture">Background Picture</string>
+    <string name="subtitle_activity_pixelpicker">Pixel Picker</string>
+    <string name="subtitle_activity_about">About The APP</string>
+    <string name="msg_AOHPCTCSeekBar_ClearRecord">&gt;&gt;&gt;Seek 100% Right Is Clean Record.&gt;&gt;&gt;</string>
+	<string name="msg_no_battery_record">No Battery Record</string>
+    <string name="zebra_style">Zebra Style</string>
+    <string name="energy_style">Energy Style</string>
+	<string name="point_style">Point Style</string>
+	
+	<!-- 权限申请相关字符串（统一管理，避免硬编码） -->
+	<string name="permission_title">权限申请</string>
+	<string name="permission_denied_title">权限被拒绝</string>
+	<string name="permission_grant_success">权限获取成功，请重新操作</string>
+	<string name="permission_storage_rationale">需要存储权限才能选择/拍照/裁剪图片，请授予权限</string>
+	<string name="permission_storage_setting_guide">存储权限已被拒绝且勾选“不再询问”，请前往设置页开启权限</string>
+	<string name="confirm">确定</string>
+	<string name="cancel">取消</string>
+	<string name="go_to_setting">去设置</string>
+	
+</resources>
diff --git a/powerbell/src/main/res/values/styles.xml b/powerbell/src/main/res/values/styles.xml
new file mode 100644
index 0000000..4e1d231
--- /dev/null
+++ b/powerbell/src/main/res/values/styles.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme_Base" parent="AESTheme">
+        <!-- Customize your theme here. -->
+    </style>
+    <style name="AppTheme_Default" parent="AESTheme">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+        <item name="android:textSize">@dimen/text_content_size</item>
+    </style>
+
+    <style name="DefaultAToolbar">
+        <item name="attrAToolbarTitleTextColor">#FF000000</item>
+        <item name="attrAToolbarStartColor">@color/colorShuiDark</item>
+        <item name="attrAToolbarCenterColor">@color/colorShui</item>
+        <item name="attrAToolbarEndColor">@color/colorShuiAccent</item>
+    </style>
+    
+    <!-- 设置Toolbar标题字体的大小 -->
+    <style name="Toolbar.TitleText" parent="@android:style/TextAppearance.DeviceDefault.Widget.ActionBar.Title">
+        <item name="android:textSize">@dimen/text_title_size</item>
+    </style>
+    <style name="Toolbar.SubTitleText" parent="@android:style/TextAppearance.DeviceDefault.Widget.ActionBar.Title">
+        <item name="android:textSize">@dimen/text_subtitle_size</item>
+    </style>
+   
+	<!-- 自定义调色板对话框样式 -->
+	<style name="CustomDialogStyle" parent="@android:style/Theme.Dialog">
+		<!-- 去除标题栏 -->
+		<item name="android:windowNoTitle">true</item>
+		<!-- 背景透明（避免小米机型弹窗周围黑边） -->
+		<item name="android:windowBackground">@android:color/transparent</item>
+		<!-- 禁止弹窗全屏 -->
+		<item name="android:windowFullscreen">false</item>
+		<!-- 小米机型适配：弹窗大小自适应 -->
+		<item name="android:windowContentOverlay">@null</item>
+		<!-- 禁止触摸外部关闭（可选，避免误触） -->
+		<item name="android:windowCloseOnTouchOutside">false</item>
+	</style>
+
+</resources>
diff --git a/powerbell/src/main/res/xml/file_provider.xml b/powerbell/src/main/res/xml/file_provider.xml
new file mode 100644
index 0000000..fb2fba7
--- /dev/null
+++ b/powerbell/src/main/res/xml/file_provider.xml
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <!-- ====================================== 兼容适配：其他必要目录（可选）====================================== -->
+    <!-- 应用内部缓存目录（适配少数依赖缓存的场景，如图片缓存）
+	路径：/data/user/0/${applicationId}/cache/
+	关联代码：getCacheDir() -->
+    <cache-path
+        name="cache_path"
+        path="." />
+	
+    <!-- ====================================== 核心适配：应用私有外部目录（必选）====================================== -->
+    <!-- 1. 裁剪临时文件目录（对应BackgroundSettingsActivity中onCreate的CropTemp目录）
+	路径：/storage/emulated/0/Android/data/${applicationId}/files/Pictures/CropTemp/
+	关联代码：_mSourceCropTempFile = new File(cropTempDir, _mSourceCropTempFileName) -->
+    <external-files-path
+        name="app_private_pictures"
+        path="Pictures/" /> <!-- 仅保留1次，覆盖Pictures下所有子目录（含CropTemp） -->
+
+    <!-- 2. 背景图片目录（对应BackgroundSourceUtils的背景存储目录）
+	路径：/storage/emulated/0/Android/data/${applicationId}/files/BackgroundPictureUtils/BackgroundSource/
+	关联代码：mfBackgroundDir = new File(mBackgroundSourceUtils.getBackgroundSourceDirPath()) -->
+    <external-files-path
+        name="background_source"
+        path="BackgroundPictureUtils/BackgroundSource/" />
+
+    <!-- 应用私有外部存储目录（适配BackgroundSourceUtils的目录） -->
+    <external-files-path
+        name="external_file_path"
+        path="BackgroundSourceUtils/" /> <!-- 对应fUtilsDir（BackgroundSourceUtils根目录） -->
+
+    <!-- 应用外部缓存目录（适配Android11+ 外部缓存场景，如第三方SDK依赖）
+	路径：/storage/emulated/0/Android/data/${applicationId}/cache/
+	关联代码：getExternalCacheDir() -->
+    <external-cache-path
+        name="external_cache_path"
+        path="." />
+
+    <!-- 3. 应用临时目录（对应App.getTempDirPath()，适配拍照临时文件）
+	路径：/storage/emulated/0/Android/data/${applicationId}/files/temp/
+	关联代码：mfPictureDir = new File(App.getTempDirPath())、mfTakePhoto = new File(mfPictureDir, "TakePhoto.jpg") -->
+    <external-files-path
+        name="app_temp"
+        path="temp/" />
+
+	<!-- 通用应用外部文件目录（适配分享/下载等通用场景，覆盖files下所有目录）
+	路径：/storage/emulated/0/Android/data/${applicationId}/files/
+	关联代码：getExternalFilesDir(null) -->
+    <external-files-path
+        name="external_file_path"
+        path="." />
+
+	<!-- 【核心添加】4. 应用内目录（getFilesDir()，对应别名 app_internal_files） -->
+	<!-- 用于映射 /data/user/0/包名/files/ 路径，解决裁剪临时文件路径匹配问题 -->
+	<files-path
+		name="app_internal_files"
+		path="." /> <!-- path="." 表示映射整个应用内目录 -->
+	<!-- 关键新增：系统公共图片目录 /Pictures/PowerBell（图片存储/裁剪目录） -->
+	<external-path
+		name="public_pictures_powerbell"
+		path="Pictures/PowerBell/" /> <!-- 路径：/storage/emulated/0/Pictures/PowerBell/ -->
+	<!-- 兜底：应用内部缓存目录 -->
+	<cache-path
+		name="cache_path"
+		path="BackgroundSourceUtils/" />
+</paths>
diff --git a/powerbell/src/main/res/xml/shortcutsmaincn1.xml b/powerbell/src/main/res/xml/shortcutsmaincn1.xml
new file mode 100644
index 0000000..c06e057
--- /dev/null
+++ b/powerbell/src/main/res/xml/shortcutsmaincn1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/powerbell/src/main/res/xml/shortcutsmaincn2.xml b/powerbell/src/main/res/xml/shortcutsmaincn2.xml
new file mode 100644
index 0000000..b0633cd
--- /dev/null
+++ b/powerbell/src/main/res/xml/shortcutsmaincn2.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+</shortcuts>
diff --git a/powerbell/src/main/res/xml/shortcutsmainen1.xml b/powerbell/src/main/res/xml/shortcutsmainen1.xml
new file mode 100644
index 0000000..7d04b71
--- /dev/null
+++ b/powerbell/src/main/res/xml/shortcutsmainen1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<!--<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.powerbell.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.powerbell"
+            android:targetClass="cc.winboll.studio.powerbell.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/powerbell/src/stage/AndroidManifest.xml b/powerbell/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..76f080d
--- /dev/null
+++ b/powerbell/src/stage/AndroidManifest.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+    </application>
+
+</manifest>
+
diff --git a/powerbell/src/stage/res/values/strings.xml b/powerbell/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/powerbell/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>
diff --git a/settings.gradle-demo b/settings.gradle-demo
new file mode 100644
index 0000000..73a9840
--- /dev/null
+++ b/settings.gradle-demo
@@ -0,0 +1,98 @@
+// AutoInstaller 项目编译设置
+//include ':autoinstaller'
+//rootProject.name = "autoinstaller"
+
+// MJ 项目编译设置
+//include ':mj'
+//rootProject.name = "mj"
+
+// PowerBell 项目编译设置
+//include ':powerbell'
+//rootProject.name = "powerbell"
+
+// APPBase 项目编译设置
+//include ':appbase'
+//include ':libappbase'
+//rootProject.name = "appbase"
+
+// APPUtils 项目编译设置
+//include ':apputils'
+//include ':libapputils'
+//rootProject.name = "apputils"
+
+// JC 项目编译设置
+//include ':jc'
+//include ':libjc'
+//rootProject.name = "jc"
+
+// AES 项目编译设置
+//include ':aes'
+//include ':libaes'
+//rootProject.name = "aes"
+
+// Contacts 项目编译设置
+//include ':contacts'
+//rootProject.name = "contacts"
+
+// MyMessageManager 项目编译设置
+//include ':mymessagemanager'
+//rootProject.name = "mymessagemanager"
+
+// TimeStamp 项目编译设置
+//include ':timestamp'
+//rootProject.name = "timestamp"
+
+// AndroidDemo 项目编译设置
+//include ':androiddemo'
+//rootProject.name = "androiddemo"
+
+// AndroidXDemo 项目编译设置
+//include ':androidxdemo'
+//rootProject.name = "androidxdemo"
+
+// Ollama 项目编译设置
+//include ':ollama'
+//rootProject.name = "ollama"
+
+// NumTable 项目编译设置
+//include ':numtable'
+//rootProject.name = "numtable"
+
+// MidiPlayer 项目编译设置
+//include ':midiplayer'
+//rootProject.name = "midiplayer"
+
+// WebPageSources 项目编译设置
+//include ':webpagesources'
+//rootProject.name = "webpagesources"
+
+// Positions 项目编译设置
+//include ':positions'
+//rootProject.name = "positions"
+
+// WinBoLL 项目编译设置
+//include ':winboll'
+//include ':libwinboll'
+//rootProject.name = "winboll"
+
+// RegExpUtils 项目编译设置
+//include ':regexputils'
+//rootProject.name = "regexputils"
+
+// GPSRelaySentinel 项目编译设置
+//include ':gpsrelaysentinel'
+//include ':libgpsrelaysentinel'
+//rootProject.name = "gpsrelaysentinel"
+
+// Gallery 项目编译设置
+//include ':gallery'
+//rootProject.name = "gallery"
+
+// DebugTemp 项目编译设置
+//include ':debugtemp'
+//include ':libdebugtemp'
+//rootProject.name = "debugtemp"
+
+// AutoNFC 项目编译设置
+//include ':autonfc'
+//rootProject.name = "autonfc"
diff --git a/winboll.properties-demo b/winboll.properties-demo
new file mode 100644
index 0000000..43a4285
--- /dev/null
+++ b/winboll.properties-demo
@@ -0,0 +1,18 @@
+## WinBoLL Nexus Settings
+## These properties is setting for publishing
+## library project to WinBoLL Nexus Maven Repository.
+##
+
+## WinBoLL Extra APK file Output Path
+#APKOutputPath=/sdcard/WinBoLLStudio/APKs
+#APKOutputPath=/sdcard/WinBoLLStudio/APKs2
+
+## WinBoLL Extra APK file Output Path
+#ExtraAPKOutputPath=/sdcard/AppProjects/app.apk
+#ExtraAPKOutputPath=/sdcard/AppProjects/app2.apk
+
+## WinBoLL Nexus UserName
+#Nexus.name=nexustestuser1
+
+## WinBoLL Nexus Password
+#Nexus.password=nexustestuserpassword
diff --git a/winboll/README.md b/winboll/README.md
new file mode 100644
index 0000000..7d41393
--- /dev/null
+++ b/winboll/README.md
@@ -0,0 +1,37 @@
+# WinBoLL
+
+#### 介绍
+WinBoLL 网站浏览器。
+
+#### 软件架构
+适配安卓应用 [AIDE Pro] 的 Gradle 编译结构。
+也适配安卓应用 [AndroidIDE] 的 Gradle 编译结构。
+
+
+#### Gradle 编译说明
+调试版编译命令 ：gradle assembleBetaDebug
+阶段版编译命令 ：bash .winboll/bashPublishAPKAddTag.sh winboll
+
+#### 使用说明
+3. Termux应用配置：
+- 已安装Termux（包名 com.termux ）；
+- 执行  echo "allow-external-apps = true" > ~/.termux/termux.properties
+
+#### 参与贡献
+
+1.  Fork 本仓库
+2.  新建 Feat_xxx 分支
+3.  提交代码 : ZhanGSKen(ZhanGSKen<zhangsken@188.com>)
+4.  新建 Pull Request
+
+
+#### 特技
+
+1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
+2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
+3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
+4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
+5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
+6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
+
+#### 参考文档
diff --git a/winboll/app_update_description.txt b/winboll/app_update_description.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/winboll/app_update_description.txt
@@ -0,0 +1 @@
+
diff --git a/winboll/build.gradle b/winboll/build.gradle
new file mode 100644
index 0000000..f1ca517
--- /dev/null
+++ b/winboll/build.gradle
@@ -0,0 +1,108 @@
+apply plugin: 'com.android.application'
+apply from: '../.winboll/winboll_app_build.gradle'
+apply from: '../.winboll/winboll_lint_build.gradle'
+
+def genVersionName(def versionName){
+    // 检查编译标志位配置
+    assert (winbollBuildProps['stageCount'] != null)
+    assert (winbollBuildProps['baseVersion'] != null)
+    // 保存基础版本号
+    winbollBuildProps.setProperty("baseVersion", "${versionName}");
+    //保存编译标志配置
+    FileOutputStream fos = new FileOutputStream(winbollBuildPropsFile)
+    winbollBuildProps.store(fos, "${winbollBuildPropsDesc}");
+    fos.close();
+    
+    // 返回编译版本号
+    return "${versionName}." + winbollBuildProps['stageCount']
+}
+
+android {
+	// 适配MIUI12
+	compileSdkVersion 30
+    buildToolsVersion "30.0.3"
+	
+    defaultConfig {
+        applicationId "cc.winboll.studio.winboll"
+        minSdkVersion 26
+		// 适配MIUI12
+        targetSdkVersion 30
+        versionCode 1
+        // versionName 更新后需要手动设置 
+        // .winboll/winbollBuildProps.properties 文件的 stageCount=0
+        // Gradle编译环境下合起来的 versionName 就是 "${versionName}.0"
+        versionName "15.20"
+        if(true) {
+            versionName = genVersionName("${versionName}")
+        }
+    }
+
+	// 米盟 SDK
+    packagingOptions {
+         doNotStrip "*/*/libmimo_1011.so"
+    }
+	
+    sourceSets {
+        main {
+            jniLibs.srcDirs = ['libs'] // 若SO库放在libs目录下
+        }
+    }
+}
+
+dependencies {
+	api project(':libwinboll')
+    api 'com.google.code.gson:gson:2.10.1'
+	
+	// 下拉控件
+    api 'com.baoyz.pullrefreshlayout:library:1.2.0'
+    
+    // SSH
+    api 'com.jcraft:jsch:0.1.55'
+    // Html 解析
+    api 'org.jsoup:jsoup:1.13.1'
+    // 二维码类库
+    api 'com.google.zxing:core:3.4.1'
+    api 'com.journeyapps:zxing-android-embedded:3.6.0'
+    // 应用介绍页类库
+    api 'io.github.medyo:android-about-page:2.0.0'
+	// 网络连接类库
+    api 'com.squareup.okhttp3:okhttp:4.4.1'
+     // FastJSON解析
+     implementation 'com.alibaba:fastjson:1.2.76'
+    
+	// AndroidX 类库
+    /*api 'androidx.appcompat:appcompat:1.1.0'
+    //api 'com.google.android.material:material:1.4.0'
+    //api 'androidx.viewpager:viewpager:1.0.0'
+    //api 'androidx.vectordrawable:vectordrawable:1.1.0'
+    //api 'androidx.vectordrawable:vectordrawable-animated:1.1.0'
+    //api 'androidx.fragment:fragment:1.1.0'*/
+	
+	
+	// 米盟
+	api 'com.miui.zeus:mimo-ad-sdk:5.3.+'//请使用最新版sdk
+     //注意：以下5个库必须要引入
+    //implementation 'androidx.appcompat:appcompat:1.4.1'
+    api 'androidx.recyclerview:recyclerview:1.0.0'
+    api 'com.github.bumptech.glide:glide:4.9.0'
+    //annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
+
+	implementation "androidx.annotation:annotation:1.3.0"
+    implementation "androidx.core:core:1.6.0"
+    implementation "androidx.drawerlayout:drawerlayout:1.1.1"
+    implementation "androidx.preference:preference:1.1.1"
+    implementation "androidx.viewpager:viewpager:1.0.0"
+    implementation "com.google.android.material:material:1.4.0"
+    implementation "com.google.guava:guava:24.1-jre"
+    /*
+	implementation "io.noties.markwon:core:$markwonVersion"
+    implementation "io.noties.markwon:ext-strikethrough:$markwonVersion"
+    implementation "io.noties.markwon:linkify:$markwonVersion"
+    implementation "io.noties.markwon:recycler:$markwonVersion"
+	*/
+	implementation 'com.termux:terminal-emulator:0.118.0'
+	implementation 'com.termux:terminal-view:0.118.0'
+	implementation 'com.termux:termux-shared:0.118.0'
+	
+	api fileTree(dir: 'libs', include: ['*.jar'])
+}
diff --git a/winboll/build.properties b/winboll/build.properties
new file mode 100644
index 0000000..cc56cae
--- /dev/null
+++ b/winboll/build.properties
@@ -0,0 +1,8 @@
+#Created by .winboll/winboll_app_build.gradle
+#Wed May 13 13:48:00 CST 2026
+stageCount=2
+libraryProject=libwinboll
+baseVersion=15.20
+publishVersion=15.20.1
+buildCount=2
+baseBetaVersion=15.20.2
diff --git a/winboll/libs/libWeWorkSpecSDK.so b/winboll/libs/libWeWorkSpecSDK.so
new file mode 100644
index 0000000..d9f592b
Binary files /dev/null and b/winboll/libs/libWeWorkSpecSDK.so differ
diff --git a/winboll/proguard-rules.pro b/winboll/proguard-rules.pro
new file mode 100644
index 0000000..a18de74
--- /dev/null
+++ b/winboll/proguard-rules.pro
@@ -0,0 +1,137 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in C:\tools\adt-bundle-windows-x86_64-20131030\sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# ============================== 基础通用规则 ==============================
+# 保留系统组件
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+
+# 保留 WinBoLL 核心包及子类（合并简化规则）
+-keep class cc.winboll.studio.** { *; }
+-keepclassmembers class cc.winboll.studio.** { *; }
+
+# 保留所有类中的 public static final String TAG 字段（便于日志定位）
+-keepclassmembers class * {
+    public static final java.lang.String TAG;
+}
+
+# 保留序列化类（避免Parcelable/Gson解析异常）
+-keep class * implements android.os.Parcelable {
+    public static final android.os.Parcelable$Creator *;
+}
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private static final java.io.ObjectStreamField[] serialPersistentFields;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+# 保留 R 文件（避免资源ID混淆）
+-keepclassmembers class **.R$* {
+    public static <fields>;
+}
+
+# 保留 native 方法（避免JNI调用失败）
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+# 保留注解和泛型（避免反射/序列化异常）
+-keepattributes *Annotation*
+-keepattributes Signature
+
+# 屏蔽 Java 8+ 警告（适配 Java 7 语法）
+-dontwarn java.lang.invoke.*
+-dontwarn android.support.v8.renderscript.*
+-dontwarn java.util.function.**
+
+# ============================== 第三方框架专项规则 ==============================
+# OkHttp 4.4.1（米盟广告请求依赖，完善Lambda兼容）
+-keep class okhttp3.** { *; }
+-keep interface okhttp3.** { *; }
+-keep class okhttp3.internal.** { *; }
+-keep class okio.** { *; }
+-dontwarn okhttp3.internal.platform.**
+-dontwarn okio.**
+
+# Glide 4.9.0（米盟广告图片加载依赖）
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep public class * extends com.bumptech.glide.module.AppGlideModule
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$ImageType {
+    **[] $VALUES;
+    public *;
+}
+-keepclassmembers class * implements com.bumptech.glide.module.AppGlideModule {
+    <init>();
+}
+-dontwarn com.bumptech.glide.**
+
+# Gson 2.8.5（米盟广告数据序列化依赖）
+-keep class com.google.gson.** { *; }
+-keep interface com.google.gson.** { *; }
+-keepclassmembers class * {
+    @com.google.gson.annotations.SerializedName <fields>;
+}
+
+# 米盟 SDK（核心广告组件，完整保留避免加载失败）
+-keep class com.miui.zeus.** { *; }
+-keep interface com.miui.zeus.** { *; }
+# 保留米盟日志字段（便于广告加载失败排查）
+-keepclassmembers class com.miui.zeus.mimo.sdk.** {
+    public static final java.lang.String TAG;
+}
+
+# RecyclerView 1.0.0（米盟广告布局渲染依赖）
+-keep class androidx.recyclerview.** { *; }
+-keep interface androidx.recyclerview.** { *; }
+-keepclassmembers class androidx.recyclerview.widget.RecyclerView$Adapter {
+    public *;
+}
+
+# 其他第三方框架（按引入依赖保留，无则可删除）
+# XXPermissions 18.63
+-keep class com.hjq.permissions.** { *; }
+-keep interface com.hjq.permissions.** { *; }
+
+# ZXing 二维码（核心解析组件）
+-keep class com.google.zxing.** { *; }
+-keep class com.journeyapps.zxing.** { *; }
+
+# Jsoup HTML解析
+-keep class org.jsoup.** { *; }
+
+# Pinyin4j 拼音搜索
+-keep class net.sourceforge.pinyin4j.** { *; }
+
+# JSch SSH组件
+-keep class com.jcraft.jsch.** { *; }
+
+# AndroidX 基础组件
+-keep class androidx.appcompat.** { *; }
+-keep interface androidx.appcompat.** { *; }
+
+# ============================== 优化与调试配置 ==============================
+# 优化级别（平衡混淆效果与性能）
+-optimizationpasses 5
+-optimizations !code/simplification/arithmetic,!code/simplification/cast,!field/*,!class/merging/*
+
+# 调试辅助（保留行号便于崩溃定位）
+-verbose
+-dontpreverify
+-dontusemixedcaseclassnames
+-keepattributes SourceFile,LineNumberTable
+
diff --git a/winboll/src/beta/AndroidManifest.xml b/winboll/src/beta/AndroidManifest.xml
new file mode 100644
index 0000000..be35225
--- /dev/null
+++ b/winboll/src/beta/AndroidManifest.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application
+        tools:replace="android:icon"
+        android:icon="@drawable/ic_launcher_beta">
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/winboll/src/beta/java/cc/winboll/studio/winboll/activities/OllamaWindowActivity.java b/winboll/src/beta/java/cc/winboll/studio/winboll/activities/OllamaWindowActivity.java
new file mode 100644
index 0000000..07b804d
--- /dev/null
+++ b/winboll/src/beta/java/cc/winboll/studio/winboll/activities/OllamaWindowActivity.java
@@ -0,0 +1,32 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+
+import cc.winboll.studio.winboll.R;
+
+/**
+ * Ollama 模型对话窗口
+ */
+public class OllamaWindowActivity extends AppCompatActivity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_ollama_window);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        getSupportActionBar().setTitle("Ollama 窗口");
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.menu_ollama_window, menu);
+        return true;
+    }
+}
diff --git a/winboll/src/beta/res/layout/activity_ollama_window.xml b/winboll/src/beta/res/layout/activity_ollama_window.xml
new file mode 100644
index 0000000..86f97cd
--- /dev/null
+++ b/winboll/src/beta/res/layout/activity_ollama_window.xml
@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="#1E1E1E"
+    android:orientation="vertical">
+
+    <com.google.android.material.appbar.AppBarLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content">
+
+        <androidx.appcompat.widget.Toolbar
+            android:id="@+id/toolbar"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:background="#333333"
+            android:elevation="4dp"
+            android:theme="@style/ThemeOverlay.MaterialComponents.ActionBar" />
+
+    </com.google.android.material.appbar.AppBarLayout>
+
+    <androidx.core.widget.NestedScrollView
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:layout_marginTop="56dp"
+        android:layout_marginBottom="48dp">
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            android:padding="16dp">
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="Ollama 模型对话"
+                android:textColor="#FFFFFF"
+                android:textSize="18sp"
+                android:textStyle="bold" />
+
+            <LinearLayout
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="16dp"
+                android:orientation="vertical">
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="系统提示："
+                    android:textColor="#B0B0B0" />
+
+                <EditText
+                    android:id="@+id/etSystemPrompt"
+                    android:layout_width="match_parent"
+                    android:layout_height="100dp"
+                    android:background="#2D2D2D"
+                    android:hint="请输入系统提示"
+                    android:textColor="#FFFFFF"
+                    android:textColorHint="#666666"
+                    android:gravity="top|start"
+                    android:inputType="textMultiLine" />
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="16dp"
+                    android:text="模型名称："
+                    android:textColor="#B0B0B0" />
+
+                <EditText
+                    android:id="@+id/etModelName"
+                    android:layout_width="match_parent"
+                    android:layout_height="48dp"
+                    android:background="#2D2D2D"
+                    android:hint="llama3"
+                    android:text="llama3"
+                    android:textColor="#FFFFFF"
+                    android:textColorHint="#666666"
+                    android:singleLine="true" />
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="8dp"
+                    android:text="系统消息："
+                    android:textColor="#B0B0B0" />
+
+                <EditText
+                    android:id="@+id/etUserMessage"
+                    android:layout_width="match_parent"
+                    android:layout_height="120dp"
+                    android:background="#2D2D2D"
+                    android:ems="10"
+                    android:gravity="top|start"
+                    android:hint="输入你要发送的消息..."
+                    android:inputType="textMultiLine" />
+
+                <EditText
+                    android:id="@+id/etAssistantMessage"
+                    android:layout_width="match_parent"
+                    android:layout_height="120dp"
+                    android:background="#2D2D2D"
+                    android:gravity="top|start"
+                    android:hint="模型响应将显示在这里..."
+                    android:inputType="textMultiLine" />
+
+            </LinearLayout>
+
+            <LinearLayout
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="16dp"
+                android:orientation="horizontal">
+
+                <Button
+                    android:id="@+id/btnSend"
+                    android:layout_width="0dp"
+                    android:layout_height="wrap_content"
+                    android:layout_weight="3"
+                    android:text="发送"
+                    android:textColor="#FFFFFF" />
+
+                <Button
+                    android:id="@+id/btnStop"
+                    android:layout_width="0dp"
+                    android:layout_height="wrap_content"
+                    android:layout_marginStart="8dp"
+                    android:layout_weight="1"
+                    android:text="停止"
+                    android:textColor="#FF5252" />
+
+            </LinearLayout>
+
+        </LinearLayout>
+
+    </androidx.core.widget.NestedScrollView>
+
+</LinearLayout>
diff --git a/winboll/src/beta/res/menu/menu_ollama_window.xml b/winboll/src/beta/res/menu/menu_ollama_window.xml
new file mode 100644
index 0000000..160ab23
--- /dev/null
+++ b/winboll/src/beta/res/menu/menu_ollama_window.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto">
+
+    <item
+        android:id="@+id/menu_config"
+        android:title="配置"
+        android:orderInCategory="100"
+        app:showAsAction="always" />
+
+</menu>
diff --git a/winboll/src/beta/res/values-zh/strings.xml b/winboll/src/beta/res/values-zh/strings.xml
new file mode 100644
index 0000000..045e125
--- /dev/null
+++ b/winboll/src/beta/res/values-zh/strings.xml
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+</resources>
diff --git a/winboll/src/beta/res/values/strings.xml b/winboll/src/beta/res/values/strings.xml
new file mode 100644
index 0000000..42cbd7a
--- /dev/null
+++ b/winboll/src/beta/res/values/strings.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">WinBoLL+</string>
+    <string name="app_name_cn1">筋斗云★</string>
+    <string name="app_name_cn2">金抖云☆</string>
+
+</resources>
diff --git a/winboll/src/beta/res/xml/shortcutsmaincn1.xml b/winboll/src/beta/res/xml/shortcutsmaincn1.xml
new file mode 100644
index 0000000..6b6dc9a
--- /dev/null
+++ b/winboll/src/beta/res/xml/shortcutsmaincn1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.winboll.beta"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+	android:shortcutId="switchto_cn1"
+	android:enabled="true"
+	android:icon="@drawable/ic_launcher"
+	android:shortcutShortLabel="@string/switchto_cn1"
+	android:shortcutLongLabel="@string/switchto_cn1"
+	android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+	<intent
+	android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN1"
+	android:targetPackage="cc.winboll.studio.winboll.beta"
+	android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+	android:data="switchto_cn1" />
+	<categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.winboll.beta"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/winboll/src/beta/res/xml/shortcutsmaincn2.xml b/winboll/src/beta/res/xml/shortcutsmaincn2.xml
new file mode 100644
index 0000000..2dbb833
--- /dev/null
+++ b/winboll/src/beta/res/xml/shortcutsmaincn2.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.winboll.beta"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.winboll.beta"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+	android:shortcutId="switchto_cn2"
+	android:enabled="true"
+	android:icon="@drawable/ic_launcher"
+	android:shortcutShortLabel="@string/switchto_cn2"
+	android:shortcutLongLabel="@string/switchto_cn2"
+	android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+	<intent
+	android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN2"
+	android:targetPackage="cc.winboll.studio.winboll.beta"
+	android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+	android:data="switchto_cn2" />
+	<categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+</shortcuts>
diff --git a/winboll/src/beta/res/xml/shortcutsmainen1.xml b/winboll/src/beta/res/xml/shortcutsmainen1.xml
new file mode 100644
index 0000000..4684c41
--- /dev/null
+++ b/winboll/src/beta/res/xml/shortcutsmainen1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<!--<shortcut
+	android:shortcutId="switchto_en1"
+	android:enabled="true"
+	android:icon="@drawable/ic_launcher"
+	android:shortcutShortLabel="@string/switchto_en1"
+	android:shortcutLongLabel="@string/switchto_en1"
+	android:shortcutDisabledMessage="@string/en1_switch_disabled">
+	<intent
+	android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_EN1"
+	android:targetPackage="cc.winboll.studio.winboll.beta"
+	android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+	android:data="switchto_en1" />
+	<categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.winboll.beta"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.winboll.beta"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/winboll/src/main/AndroidManifest.xml b/winboll/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..a949d1a
--- /dev/null
+++ b/winboll/src/main/AndroidManifest.xml
@@ -0,0 +1,339 @@
+<?xml version='1.0' encoding='utf-8'?>
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    package="cc.winboll.studio.winboll"
+    android:sharedUserId="com.termux">
+
+    <!-- 拥有完全的网络访问权限 -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+
+    <!-- 发送持久广播 -->
+    <uses-permission android:name="android.permission.BROADCAST_STICKY"/>
+
+    <!-- 对正在运行的应用重新排序 -->
+    <uses-permission android:name="android.permission.REORDER_TASKS"/>
+
+    <!-- 计算应用存储空间 -->
+    <uses-permission
+        android:name="android.permission.GET_PACKAGE_SIZE"/>
+
+    <uses-permission
+        android:name="android.permission.QUERY_ALL_PACKAGES"
+        tools:ignore="QueryAllPackagesPermission"/>
+
+    <application
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:roundIcon="@drawable/ic_launcher"
+        android:label="@string/app_name"
+        android:theme="@style/MyAppTheme"
+        android:resizeableActivity="true"
+        android:name=".App"
+        android:usesCleartextTraffic="true"
+        android:networkSecurityConfig="@xml/network_security_config">
+
+        <activity
+            android:name=".MainActivity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:launchMode="singleTask">
+
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+                <category android:name="android.intent.category.BROWSABLE"/>
+                <data android:scheme="http"/>
+                <data android:scheme="https"/>
+            </intent-filter>
+
+        </activity>
+
+        <activity android:name=".activities.ShortcutActionActivity"/>
+
+        <activity-alias
+            android:name=".MainActivityEN1"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name"
+            android:icon="@drawable/ic_launcher"
+            android:enabled="true">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmainen1"/>
+
+        </activity-alias>
+
+        <activity-alias
+            android:name=".MainActivityCN1"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name_cn1"
+            android:icon="@drawable/ic_winboll_jindouyun1"
+            android:enabled="false">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmaincn1"/>
+
+        </activity-alias>
+
+        <activity-alias
+            android:name=".MainActivityCN2"
+            android:targetActivity=".MainActivity"
+            android:exported="true"
+            android:label="@string/app_name_cn2"
+            android:icon="@drawable/ic_winboll_jindouyun2"
+            android:enabled="false">
+
+            <intent-filter>
+
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.app.shortcuts"
+                android:resource="@xml/shortcutsmaincn2"/>
+
+        </activity-alias>
+
+        <activity
+            android:name=".activities.WinBoLLUnitTestActivity"
+            android:label="@string/app_name"
+            android:exported="true"
+            android:resizeableActivity="true"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
+
+            <intent-filter>
+
+                <action android:name="android.service.quicksettings.action.QS_TILE_PREFERENCES"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity
+            android:name=".activities.NewActivity"
+            android:label="NewActivity"
+            android:exported="true"
+            android:resizeableActivity="true"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation"/>
+
+        <activity
+            android:name=".activities.New2Activity"
+            android:label="New2Activity"
+            android:exported="true"
+            android:resizeableActivity="true"
+            android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation"/>
+
+        <service
+            android:name=".MyTileService"
+            android:exported="true"
+            android:label="@string/tileservice_name"
+            android:icon="@drawable/ic_launcher"
+            android:permission="android.permission.BIND_QUICK_SETTINGS_TILE">
+
+            <intent-filter>
+
+                <action android:name="android.service.quicksettings.action.QS_TILE"/>
+
+            </intent-filter>
+
+        </service>
+
+        <service
+            android:name=".services.MainService"
+            android:exported="true"/>
+
+        <service
+            android:name="cc.winboll.studio.appbase.services.TestDemoBindService"
+            android:exported="true"/>
+
+        <service
+            android:name="cc.winboll.studio.appbase.services.TestDemoService"
+            android:exported="true"/>
+
+        <service android:name=".services.AssistantService"/>
+
+        <receiver
+            android:name="cc.winboll.studio.appbase.receivers.MainReceiver"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.appbase.receivers.MainReceiver"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <receiver
+            android:name=".widgets.APPNewsWidget"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.appbase.widgets.APPNewsWidget.ACTION_WAKEUP_SERVICE"/>
+
+                <action android:name="cc.winboll.studio.appbase.widgets.APPNewsWidget.ACTION_RELOAD_REPORT"/>
+
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/widget_provider_info_sos"/>
+
+        </receiver>
+
+        <receiver
+            android:name=".receivers.APPNewsWidgetClickListener"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.appbase.receivers.APPNewsWidgetClickListener.ACTION_PRE"/>
+
+                <action android:name="cc.winboll.studio.appbase.receivers.APPNewsWidgetClickListener.ACTION_NEXT"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <service
+            android:name=".SimpleOperateSignalCenterService"
+            android:exported="true">
+
+        </service>
+
+        <service
+            android:name=".services.TestService"
+            android:exported="true"/>
+
+        <receiver
+            android:name=".receiver.MyBroadcastReceiver"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.libappbase.action.SOS"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <receiver
+            android:name=".widgets.StatusWidget"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
+
+                <action android:name="cc.winboll.studio.libappbase.widgets.StatusWidget.ACTION_STATUS_UPDATE"/>
+
+            </intent-filter>
+
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/widget_provider_info_status"/>
+
+        </receiver>
+
+        <receiver
+            android:name=".widgets.StatusWidgetClickListener"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.libappbase.widgets.StatusWidgetClickListener.ACTION_IVAPP"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <service android:name="cc.winboll.studio.libappbase.sos.SOSCenter"/>
+
+        <receiver
+            android:name="cc.winboll.studio.libappbase.sos.SOSCenterServiceReceiver"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.libappbase.sos.SOSCenterServiceReceiver"/>
+
+            </intent-filter>
+
+        </receiver>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.YunActivity"/>
+
+        <activity android:name="cc.winboll.studio.libappbase.activities.LogonActivity"/>
+
+        <activity android:name="cc.winboll.studio.winboll.activities.AboutActivity"/>
+
+        <activity android:name="cc.winboll.studio.winboll.activities.SettingsActivity"/>
+
+        <activity android:name="cc.winboll.studio.winboll.unittest.TestWeWorkSpecSDK"/>
+
+        <activity android:name="cc.winboll.studio.winboll.activities.WXPayActivity"/>
+
+        <activity android:name="cc.winboll.studio.winboll.activities.PatternLockActivity"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.winboll.activities.PatternLockActivity.ACTION_OPEN_PATTERN"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity android:name="cc.winboll.studio.winboll.unittest.TermuxEnvTestActivity"/>
+
+        <activity
+            android:name=".termux.NfcTermuxBridgeActivity"
+            android:exported="true">
+
+            <intent-filter>
+
+                <action android:name="cc.winboll.studio.winboll.termux.NfcTermuxBridgeActivity.ACTION_BUILD"/>
+
+                <category android:name="android.intent.category.DEFAULT"/>
+
+            </intent-filter>
+
+        </activity>
+
+        <activity android:name="cc.winboll.studio.winboll.applications.MyTermuxActivity"
+            android:label="@string/my_termux_activity"
+            android:exported="true"/>
+
+    </application>
+
+</manifest>
\ No newline at end of file
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/App.java b/winboll/src/main/java/cc/winboll/studio/winboll/App.java
new file mode 100644
index 0000000..9bfaab0
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/App.java
@@ -0,0 +1,366 @@
+package cc.winboll.studio.winboll;
+
+import android.app.Activity;
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageInfo;
+import android.content.res.Resources;
+import android.graphics.Typeface;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.text.TextUtils;
+import android.util.Log;
+import android.view.Gravity;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.ViewGroup;
+import android.widget.HorizontalScrollView;
+import android.widget.ScrollView;
+import android.widget.TextView;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.ToastUtils;
+import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.Closeable;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.Thread.UncaughtExceptionHandler;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+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 {
+	
+	public static final String TAG = "App";
+	
+	public static final String COMPONENT_EN1 = "cc.winboll.studio.winboll.MainActivityEN1";
+	public static final String COMPONENT_CN1 = "cc.winboll.studio.winboll.MainActivityCN1";
+	public static final String COMPONENT_CN2 = "cc.winboll.studio.winboll.MainActivityCN2";
+	public static final String ACTION_SWITCHTO_EN1 = "cc.winboll.studio.winboll.App.ACTION_SWITCHTO_EN1";
+	public static final String ACTION_SWITCHTO_CN1 = "cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN1";
+	public static final String ACTION_SWITCHTO_CN2 = "cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN2";
+	
+    private static Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
+	
+    @Override
+    public void onCreate() {
+        super.onCreate();
+		setIsDebugging(BuildConfig.DEBUG);
+		//setIsDebugging(false);
+		
+		WinBoLLActivityManager.init(this);
+        
+        // 初始化 Toast 框架
+        ToastUtils.init(this);
+        // 设置 Toast 布局样式
+        //ToastUtils.setView(R.layout.view_toast);
+        //ToastUtils.setStyle(new WhiteToastStyle());
+        //ToastUtils.setGravity(Gravity.BOTTOM, 0, 200);
+        
+        //CrashHandler.getInstance().registerGlobal(this);
+        //CrashHandler.getInstance().registerPart(this);
+    }
+
+	@Override
+	public void onTerminate() {
+		super.onTerminate();
+		ToastUtils.release();
+	}
+	
+	
+
+    public static void write(InputStream input, OutputStream output) throws IOException {
+        byte[] buf = new byte[1024 * 8];
+        int len;
+        while ((len = input.read(buf)) != -1) {
+            output.write(buf, 0, len);
+        }
+    }
+
+    public static void write(File file, byte[] data) throws IOException {
+        File parent = file.getParentFile();
+        if (parent != null && !parent.exists()) parent.mkdirs();
+
+        ByteArrayInputStream input = new ByteArrayInputStream(data);
+        FileOutputStream output = new FileOutputStream(file);
+        try {
+            write(input, output);
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static String toString(InputStream input) throws IOException {
+        ByteArrayOutputStream output = new ByteArrayOutputStream();
+        write(input, output);
+        try {
+            return output.toString("UTF-8");
+        } finally {
+            closeIO(input, output);
+        }
+    }
+
+    public static void closeIO(Closeable... closeables) {
+        for (Closeable closeable : closeables) {
+            try {
+                if (closeable != null) closeable.close();
+            } catch (IOException ignored) {}
+        }
+    }
+
+    public static class CrashHandler {
+
+        public static final UncaughtExceptionHandler DEFAULT_UNCAUGHT_EXCEPTION_HANDLER = Thread.getDefaultUncaughtExceptionHandler();
+
+        private static CrashHandler sInstance;
+
+        private PartCrashHandler mPartCrashHandler;
+
+        public static CrashHandler getInstance() {
+            if (sInstance == null) {
+                sInstance = new CrashHandler();
+            }
+            return sInstance;
+        }
+
+        public void registerGlobal(Context context) {
+            registerGlobal(context, null);
+        }
+
+        public void registerGlobal(Context context, String crashDir) {
+            Thread.setDefaultUncaughtExceptionHandler(new UncaughtExceptionHandlerImpl(context.getApplicationContext(), crashDir));
+        }
+
+        public void unregister() {
+            Thread.setDefaultUncaughtExceptionHandler(DEFAULT_UNCAUGHT_EXCEPTION_HANDLER);
+        }
+
+        public void registerPart(Context context) {
+            unregisterPart(context);
+            mPartCrashHandler = new PartCrashHandler(context.getApplicationContext());
+            MAIN_HANDLER.postAtFrontOfQueue(mPartCrashHandler);
+        }
+
+        public void unregisterPart(Context context) {
+            if (mPartCrashHandler != null) {
+                mPartCrashHandler.isRunning.set(false);
+                mPartCrashHandler = null;
+            }
+        }
+
+        private static class PartCrashHandler implements Runnable {
+
+            private final Context mContext;
+
+            public AtomicBoolean isRunning = new AtomicBoolean(true);
+
+            public PartCrashHandler(Context context) {
+                this.mContext = context;
+            }
+
+            @Override
+            public void run() {
+                while (isRunning.get()) {
+                    try {
+                        Looper.loop();
+                    } catch (final Throwable e) {
+                        e.printStackTrace();
+                        if (isRunning.get()) {
+                            MAIN_HANDLER.post(new Runnable(){
+
+                                    @Override
+                                    public void run() {
+                                        Toast.makeText(mContext, e.toString(), Toast.LENGTH_LONG).show();
+                                    }
+                                });
+                        } else {
+                            if (e instanceof RuntimeException) {
+                                throw (RuntimeException)e;
+                            } else {
+                                throw new RuntimeException(e);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        private static class UncaughtExceptionHandlerImpl implements UncaughtExceptionHandler {
+
+            private static DateFormat DATE_FORMAT = new SimpleDateFormat("yyyy_MM_dd-HH_mm_ss");
+
+            private final Context mContext;
+
+            private final File mCrashDir;
+
+            public UncaughtExceptionHandlerImpl(Context context, String crashDir) {
+                this.mContext = context;
+                this.mCrashDir = TextUtils.isEmpty(crashDir) ? new File(mContext.getExternalCacheDir(), "crash") : new File(crashDir);
+            }
+
+            @Override
+            public void uncaughtException(Thread thread, Throwable throwable) {
+                try {
+
+                    String log = buildLog(throwable);
+                    writeLog(log);
+
+                    try {
+                        Intent intent = new Intent(mContext, CrashActivity.class);
+                        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                        intent.putExtra(Intent.EXTRA_TEXT, log);
+                        mContext.startActivity(intent);
+                    } catch (Throwable e) {
+                        e.printStackTrace();
+                        writeLog(e.toString());
+                    }
+
+                    throwable.printStackTrace();
+                    android.os.Process.killProcess(android.os.Process.myPid());
+                    System.exit(0);
+
+                } catch (Throwable e) {
+                    if (DEFAULT_UNCAUGHT_EXCEPTION_HANDLER != null) DEFAULT_UNCAUGHT_EXCEPTION_HANDLER.uncaughtException(thread, throwable);
+                }
+            }
+
+            private String buildLog(Throwable throwable) {
+                String time = DATE_FORMAT.format(new Date());
+
+                String versionName = "unknown";
+                long versionCode = 0;
+                try {
+                    PackageInfo packageInfo = mContext.getPackageManager().getPackageInfo(mContext.getPackageName(), 0);
+                    versionName = packageInfo.versionName;
+                    versionCode = Build.VERSION.SDK_INT >= 28 ? packageInfo.getLongVersionCode() : packageInfo.versionCode;
+                } catch (Throwable ignored) {}
+
+                LinkedHashMap<String, String> head = new LinkedHashMap<String, String>();
+                head.put("Time Of Crash", time);
+                head.put("Device", String.format("%s, %s", Build.MANUFACTURER, Build.MODEL));
+                head.put("Android Version", String.format("%s (%d)", Build.VERSION.RELEASE, Build.VERSION.SDK_INT));
+                head.put("App Version", String.format("%s (%d)", versionName, versionCode));
+                head.put("Kernel", getKernel());
+                head.put("Support Abis", Build.VERSION.SDK_INT >= 21 && Build.SUPPORTED_ABIS != null ? Arrays.toString(Build.SUPPORTED_ABIS): "unknown");
+                head.put("Fingerprint", Build.FINGERPRINT);
+
+                StringBuilder builder = new StringBuilder();
+
+                for (String key : head.keySet()) {
+                    if (builder.length() != 0) builder.append("\n");
+                    builder.append(key);
+                    builder.append(" :    ");
+                    builder.append(head.get(key));
+                }
+
+                builder.append("\n\n");
+                builder.append(Log.getStackTraceString(throwable));
+
+                return builder.toString(); 
+            }
+
+            private void writeLog(String log) {
+                String time = DATE_FORMAT.format(new Date());
+                File file = new File(mCrashDir, "crash_" + time + ".txt");
+                try {
+                    write(file, log.getBytes("UTF-8"));
+                } catch (Throwable e) {
+                    e.printStackTrace();
+                } 
+            }
+
+            private static String getKernel() {
+                try {
+                    return App.toString(new FileInputStream("/proc/version")).trim();
+                } catch (Throwable e) {
+                    return e.getMessage();
+                }
+            }
+        }
+    }
+
+    public static final class CrashActivity extends Activity {
+
+        private String mLog;
+
+        @Override
+        protected void onCreate(Bundle savedInstanceState) {
+            super.onCreate(savedInstanceState);
+
+            setTheme(android.R.style.Theme_DeviceDefault);
+            setTitle("App Crash");
+
+            mLog = getIntent().getStringExtra(Intent.EXTRA_TEXT);
+
+            ScrollView contentView = new ScrollView(this);
+            contentView.setFillViewport(true);
+
+            HorizontalScrollView horizontalScrollView = new HorizontalScrollView(this);
+
+            TextView textView = new TextView(this);
+            int padding = dp2px(16);
+            textView.setPadding(padding, padding, padding, padding);
+            textView.setText(mLog);
+            textView.setTextIsSelectable(true);
+            textView.setTypeface(Typeface.DEFAULT);
+            textView.setLinksClickable(true);
+
+            horizontalScrollView.addView(textView);
+            contentView.addView(horizontalScrollView, ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
+
+            setContentView(contentView);
+        }
+
+        private void restart() {
+            Intent intent = getPackageManager().getLaunchIntentForPackage(getPackageName());
+            if (intent != null) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                startActivity(intent);
+            }
+            finish();
+            android.os.Process.killProcess(android.os.Process.myPid());
+            System.exit(0);
+        }
+
+        private static int dp2px(float dpValue) {
+            final float scale = Resources.getSystem().getDisplayMetrics().density;
+            return (int) (dpValue * scale + 0.5f);
+        }
+
+        @Override
+        public boolean onCreateOptionsMenu(Menu menu) {
+            menu.add(0, android.R.id.copy, 0, android.R.string.copy)
+                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
+            return super.onCreateOptionsMenu(menu);
+        }
+
+        @Override
+        public boolean onOptionsItemSelected(MenuItem item) {
+            switch (item.getItemId()) {
+                case android.R.id.copy:
+                    ClipboardManager cm = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
+                    cm.setPrimaryClip(ClipData.newPlainText(getPackageName(), mLog));
+                    return true;
+            }
+            return super.onOptionsItemSelected(item);
+        }
+
+        @Override
+        public void onBackPressed() {
+            restart();
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/AssistantService.java b/winboll/src/main/java/cc/winboll/studio/winboll/AssistantService.java
new file mode 100644
index 0000000..fb23c79
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/AssistantService.java
@@ -0,0 +1,97 @@
+package cc.winboll.studio.winboll;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/28 19:12:12
+ * @Describe 应用主要服务组件类守护进程服务组件类
+ */
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.IBinder;
+import cc.winboll.studio.libaes.models.WinBoLLClientServiceBean;
+import cc.winboll.studio.winboll.WinBoLLClientService;
+import cc.winboll.studio.winboll.utils.ServiceUtils;
+
+public class AssistantService extends Service {
+
+    public final static String TAG = "AssistantService";
+
+    WinBoLLClientServiceBean mWinBoLLServiceBean;
+    MyServiceConnection mMyServiceConnection;
+    volatile boolean mIsServiceRunning;
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return null;
+    }
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        mWinBoLLServiceBean = WinBoLLClientServiceBean.loadWinBoLLClientServiceBean(this);
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+        }
+        // 设置运行参数
+        mIsServiceRunning = false;
+        run();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        run();
+        return START_STICKY;
+    }
+
+    @Override
+    public void onDestroy() {
+        mIsServiceRunning = false;
+        super.onDestroy();
+    }
+
+    //
+    // 运行服务内容
+    //
+    void run() {
+        mWinBoLLServiceBean = WinBoLLClientServiceBean.loadWinBoLLClientServiceBean(this);
+        if (mWinBoLLServiceBean.isEnable()) {
+            if (mIsServiceRunning == false) {
+                // 设置运行状态
+                mIsServiceRunning = true;
+                // 唤醒和绑定主进程
+                wakeupAndBindMain();
+            }
+        }
+    }
+
+    //
+    // 唤醒和绑定主进程
+    //
+    void wakeupAndBindMain() {
+        if (ServiceUtils.isServiceAlive(getApplicationContext(), WinBoLLClientService.class.getName()) == false) {
+            startForegroundService(new Intent(AssistantService.this, WinBoLLClientService.class));
+        }
+
+        bindService(new Intent(AssistantService.this, WinBoLLClientService.class), mMyServiceConnection, Context.BIND_IMPORTANT);
+    }
+
+    //
+    // 主进程与守护进程连接时需要用到此类
+    //
+    class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            mWinBoLLServiceBean = WinBoLLClientServiceBean.loadWinBoLLClientServiceBean(AssistantService.this);
+            if (mWinBoLLServiceBean.isEnable()) {
+                wakeupAndBindMain();
+            }
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/EWUIStatusIconDrawable.java b/winboll/src/main/java/cc/winboll/studio/winboll/EWUIStatusIconDrawable.java
new file mode 100644
index 0000000..20a70d8
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/EWUIStatusIconDrawable.java
@@ -0,0 +1,35 @@
+package cc.winboll.studio.winboll;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/28 19:11:27
+ * @Describe WinBoLL UI 状态图标枚举
+ */
+import cc.winboll.studio.libaes.R;
+
+public enum EWUIStatusIconDrawable {
+    NORMAL(0),
+    NEWS(1)
+    ;
+
+    static final String TAG = "WUIStatusIconDrawable";
+
+    static String[] _mlistCNName = { "正常", "新的消息" };
+
+    private int value = 0;
+    private EWUIStatusIconDrawable(int value) {    //必须是private的，否则编译错误
+        this.value = value;
+    }
+
+    public static int getIconDrawableId(EWUIStatusIconDrawable drawableId) {
+        int res;
+        switch(drawableId){
+            case NEWS :
+                res = R.drawable.ic_winbollbeta;
+                break;
+            default :
+                res = R.drawable.ic_winboll;
+        }
+        return res;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/MainActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/MainActivity.java
new file mode 100644
index 0000000..3ffc723
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/MainActivity.java
@@ -0,0 +1,221 @@
+package cc.winboll.studio.winboll;
+
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Message;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.AdapterView;
+import cc.winboll.studio.libaes.activitys.DrawerFragmentActivity;
+import cc.winboll.studio.libaes.models.DrawerMenuBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.activities.AboutActivity;
+import cc.winboll.studio.winboll.activities.SettingsActivity;
+import cc.winboll.studio.winboll.applications.MyTermuxActivity;
+import cc.winboll.studio.winboll.fragments.BrowserFragment;
+import cc.winboll.studio.winboll.unittest.TermuxEnvTestActivity;
+import java.util.ArrayList;
+
+public class MainActivity extends DrawerFragmentActivity {
+
+
+    public static final String TAG = "MainActivity";
+
+    BrowserFragment mBrowserFragment;
+
+    // ------------------- 新增：Handler 消息定义（接收URL历史更新消息） -------------------
+    // 消息标识：URL加载历史更新（刷新抽屉菜单的历史列表）
+    public static final int MSG_URLLOADHISTORY_UPDATE = 1002;
+    // 自定义Handler（接收应用内消息，如BrowserFragment发送的历史更新消息）
+    private static Handler _mMainHandler;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        setTheme(cc.winboll.studio.winboll.theme.WinBoLLThemeUtil.getThemeTypeID(this));
+        super.onCreate(savedInstanceState);
+        initMainHandler();
+        if (mBrowserFragment == null) {
+            String externalUrl = extractExternalUrl(getIntent());
+            if (externalUrl != null) {
+                mBrowserFragment = BrowserFragment.newInstance(externalUrl);
+            } else {
+                mBrowserFragment = BrowserFragment.newInstance();
+            }
+            addFragment(mBrowserFragment);
+        }
+        showFragment(mBrowserFragment);
+    }
+
+//    @Override
+//    protected void onNewIntent(Intent intent) {
+//        super.onNewIntent(intent);
+//        String externalUrl = extractExternalUrl(intent);
+//        if (externalUrl != null && mBrowserFragment != null && mBrowserFragment.getBrowserHandler() != null) {
+//            Message msg = Message.obtain();
+//            msg.what = BrowserFragment.MSG_OPEN_URL;
+//            msg.obj = externalUrl;
+//            mBrowserFragment.getBrowserHandler().sendMessage(msg);
+//        }
+//    }
+
+    private String extractExternalUrl(Intent intent) {
+        if (intent != null && Intent.ACTION_VIEW.equals(intent.getAction())) {
+            Uri uri = intent.getData();
+            if (uri != null) {
+                return uri.toString();
+            }
+        }
+        return null;
+    }
+
+	public static void sendMessage(Message msg) {
+		_mMainHandler.sendMessage(msg);
+	}
+
+    /**
+     * 初始化Handler（接收MSG_URLLOADHISTORY_UPDATE消息，刷新抽屉历史菜单）
+     */
+    private void initMainHandler() {
+		// 清理旧数据
+		if (_mMainHandler != null) {
+            _mMainHandler.removeCallbacksAndMessages(null);
+            _mMainHandler = null;
+        }
+
+        // Java 7 匿名内部类实现Handler（主线程创建，安全更新UI/抽屉菜单）
+        _mMainHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                switch (msg.what) {
+                    case MSG_URLLOADHISTORY_UPDATE:
+                        // 处理URL历史更新消息：刷新抽屉菜单的历史列表
+                        LogUtils.d(TAG, "收到URL历史更新消息，刷新抽屉菜单");
+                        refreshUrlHistoryDrawerMenu();
+                        break;
+                    default:
+                        break;
+                }
+            }
+        };
+    }
+
+    @Override
+    public void initDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+        super.initDrawerMenuItemList(listDrawerMenu);
+        //LogUtils.d(TAG, "initDrawerMenuItemList");
+        // 加载URL历史菜单（初始化时加载）
+        refreshUrlHistoryDrawerMenu();
+        notifyDrawerMenuDataChanged();
+    }
+
+    @Override
+    public void reinitDrawerMenuItemList(ArrayList<DrawerMenuBean> listDrawerMenu) {
+        super.reinitDrawerMenuItemList(listDrawerMenu);
+        //LogUtils.d(TAG, "reinitDrawerMenuItemList");
+        // 重新加载URL历史菜单（菜单重置时加载）
+        refreshUrlHistoryDrawerMenu();
+        notifyDrawerMenuDataChanged();
+    }
+
+	void loadUrlLoadHistotyMenu(ArrayList<DrawerMenuBean> listDrawerMenu) {
+		listDrawerMenu.clear();
+		if (BrowserFragment._mUrlLoadHistory != null) {
+			for (String url : BrowserFragment._mUrlLoadHistory) {
+				listDrawerMenu.add(new DrawerMenuBean(R.drawable.ic_launcher, url));
+			}
+		}
+	}
+
+    // ------------------- 新增：刷新URL历史抽屉菜单（提取独立方法，复用） -------------------
+    private void refreshUrlHistoryDrawerMenu() {
+        // 获取抽屉菜单列表，重新加载历史数据并刷新
+        ArrayList<DrawerMenuBean> drawerMenuList = super.malDrawerMenuItem; // 假设父类提供获取菜单列表的方法
+        if (drawerMenuList != null) {
+            loadUrlLoadHistotyMenu(drawerMenuList); // 重新加载更新后的历史数据
+            notifyDrawerMenuDataChanged(); // 通知抽屉菜单刷新UI
+        }
+    }
+
+    @Override
+    public DrawerFragmentActivity.ActivityType initActivityType() {
+        return DrawerFragmentActivity.ActivityType.Main;
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        getMenuInflater().inflate(R.menu.toolbar_main, menu);
+		if (App.isDebugging()) {
+			getMenuInflater().inflate(R.menu.toolbar_test, menu);
+		}
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    @Override
+    public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
+        super.onItemClick(parent, view, position, id);
+		if (mBrowserFragment != null && mBrowserFragment.getBrowserHandler() != null) {
+			Message msg = Message.obtain();
+			msg.what = BrowserFragment.MSG_HISTORY_POSITION;
+			msg.obj = position;
+			mBrowserFragment.getBrowserHandler().sendMessage(msg);
+        }
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+        if (AESThemeUtil.onWinBoLLThemeItemSelected(this, item)) {
+            recreate();
+        } else {
+            int nItemId = item.getItemId();
+            if (nItemId == R.id.item_home) {
+                if (mBrowserFragment != null && mBrowserFragment.getBrowserHandler() != null) {
+                    Message msg = Message.obtain();
+                    msg.what = BrowserFragment.MSG_HOMEPAGE;
+                    mBrowserFragment.getBrowserHandler().sendMessage(msg);
+                }
+            } else if (nItemId == R.id.item_settings) {
+                WinBoLLActivityManager.getInstance().startWinBoLLActivity(getApplicationContext(), SettingsActivity.class);
+            } else if (nItemId == R.id.item_about) {
+                Intent intent = new Intent(getApplicationContext(), AboutActivity.class);
+                WinBoLLActivityManager.getInstance().startWinBoLLActivity(getApplicationContext(), intent, AboutActivity.class);
+            } else if (nItemId == R.id.item_mytermux) {
+                Intent intent = new Intent(getApplicationContext(), MyTermuxActivity.class);
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+                startActivity(intent);
+            } else if (nItemId == R.id.item_termux_env_test) {
+                Intent intent = new Intent(getApplicationContext(), TermuxEnvTestActivity.class);
+                WinBoLLActivityManager.getInstance().startWinBoLLActivity(getApplicationContext(), intent, AboutActivity.class);
+            } else if (nItemId == R.id.item_library_activity) {
+                Intent intent = new Intent(getApplicationContext(), cc.winboll.studio.libwinboll.WinBoLLLibraryActivity.class);
+                WinBoLLActivityManager.getInstance().startWinBoLLActivity(getApplicationContext(), intent, AboutActivity.class);
+            } else {
+                return super.onOptionsItemSelected(item);
+            }
+        }
+        return true;
+    }
+
+    // ------------------- 新增：对外提供Handler（供其他组件发送消息，如BrowserFragment） -------------------
+    public Handler getMainHandler() {
+        return _mMainHandler;
+    }
+
+    // ------------------- 新增：生命周期管理（防止Handler内存泄漏） -------------------
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // 清除Handler所有消息和回调，避免内存泄漏
+        if (_mMainHandler != null) {
+            _mMainHandler.removeCallbacksAndMessages(null);
+            _mMainHandler = null;
+        }
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/MyTileService.java b/winboll/src/main/java/cc/winboll/studio/winboll/MyTileService.java
new file mode 100644
index 0000000..f17f234
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/MyTileService.java
@@ -0,0 +1,80 @@
+package cc.winboll.studio.winboll;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/13 19:30:10
+ */
+import android.content.Context;
+import cc.winboll.studio.winboll.R;
+import android.service.quicksettings.Tile;
+import android.service.quicksettings.TileService;
+import cc.winboll.studio.winboll.models.MainServiceBean;
+import cc.winboll.studio.winboll.services.MainService;
+
+public class MyTileService extends TileService {
+    public static final String TAG = "MyTileService";
+
+    volatile static MyTileService _MyTileService;
+
+    @Override
+    public void onStartListening() {
+        super.onStartListening();
+        _MyTileService = this;
+        Tile tile = getQsTile();
+        MainServiceBean bean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        if (bean != null && bean.isEnable()) {
+            //MainService.startMainService(context);
+            tile.setState(Tile.STATE_ACTIVE);
+            tile.setIcon(android.graphics.drawable.Icon.createWithResource(this, R.drawable.ic_cloud));
+        } else {
+            //MainService.stopMainService(context);
+            tile.setState(Tile.STATE_INACTIVE);
+            tile.setIcon(android.graphics.drawable.Icon.createWithResource(this, R.drawable.ic_cloud_outline));
+        }
+        tile.updateTile();
+//        Tile tile = getQsTile();
+//        tile.setState(Tile.STATE_INACTIVE);
+//        tile.setLabel(getString(R.string.tileservice_name));
+//        tile.setIcon(android.graphics.drawable.Icon.createWithResource(this, R.drawable.ic_cloud_outline));
+//        tile.updateTile();
+
+    }
+
+    @Override
+    public void onClick() {
+        super.onClick();
+        Tile tile = getQsTile();
+        MainServiceBean bean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        if (bean == null) {
+            bean = new MainServiceBean();
+        }
+
+        if (tile.getState() == Tile.STATE_ACTIVE) {
+            bean.setIsEnable(false);
+            MainServiceBean.saveBean(this, bean);
+            MainService.stopMainService(this);
+        } else if (tile.getState() == Tile.STATE_INACTIVE) {
+            bean.setIsEnable(true);
+            MainServiceBean.saveBean(this, bean);
+            MainService.startMainService(this);
+        }
+        updateServiceIconStatus(this);
+    }
+
+    public static void updateServiceIconStatus(Context context) {
+        if (_MyTileService == null) {
+            return;
+        }
+
+        Tile tile = _MyTileService.getQsTile();
+        MainServiceBean bean = MainServiceBean.loadBean(context, MainServiceBean.class);
+        if (bean != null && bean.isEnable()) {
+            tile.setState(Tile.STATE_ACTIVE);
+            tile.setIcon(android.graphics.drawable.Icon.createWithResource(context, R.drawable.ic_cloud));
+        } else {
+            tile.setState(Tile.STATE_INACTIVE);
+            tile.setIcon(android.graphics.drawable.Icon.createWithResource(context, R.drawable.ic_cloud_outline));
+        }
+        tile.updateTile();
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLL.java b/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLL.java
new file mode 100644
index 0000000..cbdff70
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLL.java
@@ -0,0 +1,40 @@
+package cc.winboll.studio.winboll;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/05/10 10:13
+ * @Describe WinBoLL 系列应用通用管理类
+ */
+import android.content.Context;
+import android.content.Intent;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.models.WinBoLLModel;
+
+public class WinBoLL {
+
+    public static final String TAG = "WinBoLL";
+
+    public static final String ACTION_BIND = WinBoLL.class.getName() + ".ACTION_BIND";
+    public static final String EXTRA_WINBOLLMODEL = "EXTRA_WINBOLLMODEL";
+
+    public static void bindToAPPBase(Context context, String appMainService) {
+        LogUtils.d(TAG, "bindToAPPBase(...)");
+        String toPackage = "cc.winboll.studio.appbase";
+        startBind(context, toPackage, appMainService);
+    }
+
+    public static void bindToAPPBaseBeta(Context context, String appMainService) {
+        LogUtils.d(TAG, "bindToAPPBaseBeta(...)");
+        String toPackage = "cc.winboll.studio.appbase.beta";
+        startBind(context, toPackage, appMainService);
+    }
+
+    static void startBind(Context context, String toPackage, String appMainService) {
+        Intent intent = new Intent(ACTION_BIND);
+        intent.putExtra(EXTRA_WINBOLLMODEL, (new WinBoLLModel(toPackage, appMainService)).toString());
+        intent.setPackage(toPackage);
+        LogUtils.d(TAG, String.format("ACTION_BIND :\nTo Package : %s\nAPP Main Service : %s", toPackage, appMainService));
+        context.sendBroadcast(intent);
+    }
+
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLLClientService.java b/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLLClientService.java
new file mode 100644
index 0000000..c9d29de
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLLClientService.java
@@ -0,0 +1,21 @@
+package cc.winboll.studio.winboll;
+
+import android.app.Service;
+import android.content.Intent;
+import android.os.IBinder;
+
+/**
+ * @Author ZhanGSKen
+ * @Date 2025/05/03 19:28
+ */
+public class WinBoLLClientService extends Service {
+    
+    public static final String TAG = "WinBoLLClientService";
+    
+    @Override
+    public IBinder onBind(Intent intent) {
+        
+        return null;
+    }
+    
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLLServiceStatusView.java b/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLLServiceStatusView.java
new file mode 100644
index 0000000..e939b7e
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/WinBoLLServiceStatusView.java
@@ -0,0 +1,38 @@
+package cc.winboll.studio.winboll;
+import android.content.Context;
+import android.util.AttributeSet;
+import android.widget.LinearLayout;
+
+/**
+ * @Author ZhanGSKen
+ * @Date 2025/05/03 19:14
+ */
+public class WinBoLLServiceStatusView extends LinearLayout {
+    
+    public static final String TAG = "WinBoLLServiceStatusView";
+    
+    public WinBoLLServiceStatusView(Context context) {
+        super(context);
+    }
+
+    public WinBoLLServiceStatusView(Context context, AttributeSet attrs) {
+        super(context, attrs);
+    }
+
+    public WinBoLLServiceStatusView(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+    }
+
+    public WinBoLLServiceStatusView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+    }
+    
+    
+    void setServerHost(String szWinBoLLServerHost) {
+        
+    }
+    
+    void setAuthInfo(String szDevUserName, String szDevUserPassword) {
+        
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/WxPayConfig.java b/winboll/src/main/java/cc/winboll/studio/winboll/WxPayConfig.java
new file mode 100644
index 0000000..69c7493
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/WxPayConfig.java
@@ -0,0 +1,28 @@
+package cc.winboll.studio.winboll;
+
+/**
+ * 微信支付配置类
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/07
+ */
+public class WxPayConfig {
+    // ========== 核心修改点：替换为你的服务端地址 ==========
+    // 服务端IP/域名 + 端口（Docker部署的服务端，需确保安卓端可访问）
+    public static final String BASE_URL = "https://wxpay.winboll.cc";
+
+    // 统一下单接口路径（对应服务端的测试接口）
+    public static final String CREATE_ORDER_URL = BASE_URL + "/pay/createOrder";
+
+    // 订单查询接口路径
+    public static final String QUERY_ORDER_URL = BASE_URL + "/pay/queryOrder";
+
+    // ========== 固定支付配置 ==========
+    public static final String ORDER_BODY = "定额测试支付"; // 商品描述
+    public static final int TOTAL_FEE = 1; // 固定金额：1分（沙箱环境推荐）
+    public static final String TRADE_TYPE = "NATIVE"; // 支付类型：二维码
+
+    // ========== 轮询配置 ==========
+    public static final long POLL_INTERVAL = 10000; // 轮询间隔：10秒
+    public static final long POLL_TIMEOUT = 45000; // 轮询超时：45秒
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/AboutActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/AboutActivity.java
new file mode 100644
index 0000000..d7ef2e6
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/AboutActivity.java
@@ -0,0 +1,86 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.models.APPInfo;
+import cc.winboll.studio.libappbase.views.AboutView;
+import cc.winboll.studio.winboll.MainActivity;
+import cc.winboll.studio.winboll.R;
+import android.app.Activity;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/13 11:54
+ * @Describe 应用介绍窗口
+ */
+public class AboutActivity extends BaseWinBoLLActivity {
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+
+    public static final String TAG = "AboutActivity";
+	
+	private Toolbar mToolbar;
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_about);
+
+		// 设置工具栏
+        initToolbar();
+
+		AboutView aboutView = getActivity().findViewById(R.id.aboutview);
+		aboutView.setAPPInfo(genDefaultAppInfo());
+    }
+
+	private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化");
+        mToolbar = (Toolbar) findViewById(R.id.toolbar);
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() | Toolbar未找到");
+            return;
+        }
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        ((AppCompatActivity)getActivity()).getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "导航栏 点击返回按钮");
+					getActivity().finish();
+				}
+			});
+        LogUtils.d(TAG, "initToolbar() 配置完成");
+    }
+
+	private APPInfo genDefaultAppInfo() {
+        LogUtils.d(TAG, "genDefaultAppInfo() 调用");
+        String branchName = "winboll";
+        APPInfo appInfo = new APPInfo();
+        appInfo.setAppName(getActivity().getString(R.string.app_name));
+        appInfo.setAppIcon(R.drawable.ic_winboll);
+        appInfo.setAppDescription(getActivity().getString(R.string.app_description));
+        appInfo.setAppGitName("WinBoLL");
+        appInfo.setAppGitOwner("Studio");
+        appInfo.setAppGitAPPBranch(branchName);
+        appInfo.setAppGitAPPSubProjectFolder(branchName);
+        appInfo.setAppHomePage("https://www.winboll.cc/apks/index.php?project=WinBoLL");
+        appInfo.setAppAPKName("WinBoLL");
+        appInfo.setAppAPKFolderName("WinBoLL");
+        LogUtils.d(TAG, "genDefaultAppInfo: 应用信息已生成");
+        return appInfo;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/BaseWinBoLLActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/BaseWinBoLLActivity.java
new file mode 100644
index 0000000..7dedd62
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/BaseWinBoLLActivity.java
@@ -0,0 +1,51 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.app.Activity;
+import android.os.Bundle;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.winboll.theme.WinBoLLThemeUtil;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/13 16:33
+ * BaseWinBollActivity 【继承AppCompatActivity，保留核心能力，不额外暴露方法】
+ * 继承链路：BaseWinBoLLActivity → AppCompatActivity → FragmentActivity，AppCompat能力天然继承可用
+ */
+public abstract class BaseWinBoLLActivity extends AppCompatActivity implements IWinBoLLActivity {
+    public static final String TAG = "BaseWinBoLLActivity";
+
+    protected volatile AESThemeBean.ThemeType mThemeType;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        mThemeType = getThemeType();
+        setThemeStyle();
+        super.onCreate(savedInstanceState);
+        WinBoLLActivityManager.getInstance().add(this);
+        //ToastUtils.show(getTag() + ": onCreate");
+    }
+
+    AESThemeBean.ThemeType getThemeType() {
+        return WinBoLLThemeUtil.getThemeStyleType(WinBoLLThemeUtil.getThemeTypeID(getApplicationContext()));
+    }
+
+    void setThemeStyle() {
+        setTheme(WinBoLLThemeUtil.getThemeTypeID(getApplicationContext()));
+    }
+
+    @Override
+    protected void onDestroy() {
+        WinBoLLActivityManager.getInstance().registeRemove(this);
+        super.onDestroy();
+    }
+
+    // 子类必须实现getTag()，确保唯一标识
+    @Override
+    public abstract String getTag();
+
+    public abstract Activity  getActivity();
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/LogonActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/LogonActivity.java
new file mode 100644
index 0000000..7097711
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/LogonActivity.java
@@ -0,0 +1,150 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.RadioButton;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.BuildConfig;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.models.UserInfoModel;
+import cc.winboll.studio.winboll.utils.RSAUtils;
+import cc.winboll.studio.winboll.utils.YunUtils;
+import java.security.KeyPair;
+import java.security.PrivateKey;
+import java.security.PublicKey;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/04 13:29
+ * @Describe 用户登录框
+ */
+public class LogonActivity extends Activity implements IWinBoLLActivity {
+
+    public static final String TAG = "LogonActivity";
+
+    public static final String DEBUG_HOST = "http://10.8.0.250:456";
+    public static final String YUN_HOST = "https://yun.winboll.cc";
+    
+    
+    String mHost = "";
+    RadioButton mrbYunHost;
+    RadioButton mrbDebugHost;
+    LogView mLogView;
+    
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_logon);
+        mLogView = findViewById(R.id.logview);
+        mLogView.start();
+
+        mHost = BuildConfig.DEBUG ? DEBUG_HOST: YUN_HOST;
+        if (BuildConfig.DEBUG) {
+            mrbYunHost = findViewById(R.id.rb_yunhost);
+            mrbDebugHost = findViewById(R.id.rb_debughost);
+            mrbYunHost.setChecked(!BuildConfig.DEBUG);
+            mrbDebugHost.setChecked(BuildConfig.DEBUG);
+        } else {
+            findViewById(R.id.ll_hostbar).setVisibility(View.GONE);
+        }
+    }
+    
+    public void onSwitchHost(View view) {
+        if (view.getId() == R.id.rb_yunhost) {
+            mrbDebugHost.setChecked(false);
+            mHost = YUN_HOST;
+        } else if (view.getId() == R.id.rb_debughost) {
+            mrbYunHost.setChecked(false);
+            mHost = DEBUG_HOST;
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        mLogView.start();
+    }
+
+    public void onTestLogin(View view) {
+        LogUtils.d(TAG, "onTestLogin");
+        final YunUtils yunUtils = YunUtils.getInstance(this);
+        
+        UserInfoModel userInfoModel = new UserInfoModel();
+        userInfoModel.setUsername("jian");
+        userInfoModel.setPassword("kkiio");
+        userInfoModel.setToken("aaa111");
+        yunUtils.login(mHost, userInfoModel);
+    }
+
+    public void onTestRSA(View view) {
+        LogUtils.d(TAG, "onTestRSA");
+        RSAUtils utils = RSAUtils.getInstance(this);
+        
+        try {
+            // 测试 1：首次生成密钥对
+            LogUtils.d(TAG, "==== 首次生成密钥对 ====");
+            if (utils.keysExist()) {
+                LogUtils.d(TAG, "密钥对已生成");
+            } else {
+                utils.generateAndSaveKeys();
+                LogUtils.d(TAG, "密钥对生成成功。");
+            }
+
+            // 测试 2：获取密钥对（自动读取已生成的文件）
+            KeyPair keyPair = utils.getOrGenerateKeys();
+            PublicKey publicKey = keyPair.getPublic();
+            PrivateKey privateKey = keyPair.getPrivate();
+
+            // 打印密钥信息
+            LogUtils.d(TAG, "\n==== 密钥信息 ====");
+            LogUtils.d(TAG, "公钥算法：" + publicKey.getAlgorithm());
+            LogUtils.d(TAG, "公钥编码长度：" + publicKey.getEncoded().length + "字节");
+            LogUtils.d(TAG, "私钥算法：" + privateKey.getAlgorithm());
+            LogUtils.d(TAG, "私钥编码长度：" + privateKey.getEncoded().length + "字节");
+
+            // 测试 3：重复调用时检查是否复用文件
+            LogUtils.d(TAG, "\n==== 二次调用 ====");
+            KeyPair reusedPair = utils.getOrGenerateKeys();
+            LogUtils.d(TAG, "是否为同一公钥：" + (publicKey.equals(reusedPair.getPublic()))); // true（单例引用）
+            LogUtils.d(TAG, "操作完成");
+
+            String testMessage = "Hello, RSA Encryption!";
+
+            // 1. 获取或生成密钥对
+            PublicKey publicKeyReused = reusedPair.getPublic();
+            PrivateKey privateKeyReused = reusedPair.getPrivate();
+
+            // 2. 公钥加密
+            byte[] encryptedData = utils.encryptWithPublicKey(testMessage, publicKeyReused);
+            LogUtils.d(TAG, "加密后数据（字节长度）：" + encryptedData.length);
+
+            // 3. 私钥解密
+            String decryptedMessage = utils.decryptWithPrivateKey(encryptedData, privateKeyReused);
+            LogUtils.d(TAG, "解密结果: " + decryptedMessage);
+            
+            // 4. 验证解密是否成功
+            if (testMessage.equals(decryptedMessage)) {
+                LogUtils.d(TAG, "加密解密测试通过！");
+            } else {
+                LogUtils.d(TAG, "测试失败：内容不一致");
+            }
+        } catch (Exception e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+    }
+    
+
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/New2Activity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/New2Activity.java
new file mode 100644
index 0000000..561cf64
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/New2Activity.java
@@ -0,0 +1,59 @@
+package cc.winboll.studio.winboll.activities;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/25 11:46:40
+ * @Describe 测试窗口2
+ */
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.winboll.R;
+import android.app.Activity;
+
+public class New2Activity extends BaseWinBoLLActivity {
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+
+    public static final String TAG = "New2Activity";
+
+    Toolbar mToolbar;
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    //LogView mLogView;
+	
+	
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_new2);
+
+//        mLogView = findViewById(R.id.logview);
+//        mLogView.start();
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        
+    }
+
+
+    public void onCloseThisActivity(View view) {
+        //WinBoLLActivityManager.getInstance().finish(this);
+    }
+
+    public void onCloseAllActivity(View view) {
+        //WinBoLLActivityManager.getInstance().finishAll();
+    }
+
+    public void onNewActivity(View view) {
+        //WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, NewActivity.class);
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/NewActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/NewActivity.java
new file mode 100644
index 0000000..e3b6530
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/NewActivity.java
@@ -0,0 +1,56 @@
+package cc.winboll.studio.winboll.activities;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/03/25 05:04:22
+ * @Describe
+ */
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.winboll.R;
+import android.app.Activity;
+
+public class NewActivity extends BaseWinBoLLActivity {
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+
+    public static final String TAG = "NewActivity";
+
+    Toolbar mToolbar;
+    //LogView mLogView;
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_new);
+//        mLogView = findViewById(R.id.logview);
+//        mLogView.start();
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+        
+    }
+
+
+    public void onCloseThisActivity(View view) {
+        WinBoLLActivityManager.getInstance().finish(this);
+    }
+
+    public void onCloseAllActivity(View view) {
+        WinBoLLActivityManager.getInstance().finishAll();
+    }
+
+    public void onNew2Activity(View view) {
+       // WinBoLLActivityManager.getInstance().startWinBoLLActivity(App.getInstance(), New2Activity.class);
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/PatternLockActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/PatternLockActivity.java
new file mode 100644
index 0000000..6581c20
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/PatternLockActivity.java
@@ -0,0 +1,308 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Paint;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.view.MotionEvent;
+import android.widget.FrameLayout;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.winboll.R;
+
+public class PatternLockActivity extends BaseWinBoLLActivity {
+
+    public static final String TAG = "PatternLockActivity";
+
+    private static final int DOT_RADIUS = 8;
+    private static final int PATTERN_ERROR_DURATION = 1500;
+
+    private static final String PREFS_NAME = "pattern_lock_prefs";
+    static final String KEY_LOCK_PATTERN = "lock_pattern";
+    static final String KEY_ERROR_STATE = "error_state";
+    private static final String KEY_ERROR_REPEAT_PATTERN = "error_repeat_pattern";
+
+    private boolean mIsInErrorState;
+    private boolean mNeedRestart;
+    private Handler mHandler;
+
+    private FrameLayout mContainer;
+    private PatternView mPatternView;
+
+    public PatternLockActivity() {
+        mHandler = new Handler(Looper.getMainLooper());
+    }
+
+    PatternLockActivity(Context context) {
+        mHandler = new Handler(Looper.getMainLooper());
+    }
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        AESThemeUtil.applyAppTheme(this);
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_pattern_lock);
+
+        Toolbar toolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(toolbar);
+        getSupportActionBar().setSubtitle(TAG);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        toolbar.setNavigationOnClickListener(new android.view.View.OnClickListener() {
+            @Override
+            public void onClick(android.view.View v) {
+                finish();
+            }
+        });
+
+        mContainer = findViewById(R.id.container);
+        mPatternView = new PatternView(this);
+        mContainer.addView(mPatternView);
+        mPatternView.invalidate();
+        
+        mNeedRestart = false;
+        boolean isEnoughPoints = savedInstanceIsEnoughPoints();
+
+        if (savedInstanceState != null) {
+            mIsInErrorState = savedInstanceState.getBoolean(KEY_ERROR_STATE, false);
+            mNeedRestart = savedInstanceState.getBoolean(KEY_ERROR_REPEAT_PATTERN, false);
+        }
+
+        if (mIsInErrorState) {
+            mPatternView.invalidate();
+        }
+    }
+
+    boolean savedInstanceIsEnoughPoints() {
+        int count = 0;
+        if (mPatternView != null) {
+            for (int i = 0; i < 9; i++) {
+                if (mPatternView.mDotState[i] == 1) {
+                    count++;
+                }
+            }
+        }
+        return count >= 4 || count == 0;
+    }
+
+    @Override
+    protected void onSaveInstanceState(Bundle outState) {
+        if (mIsInErrorState) {
+            outState.putBoolean(KEY_ERROR_STATE, mIsInErrorState);
+        }
+        if (mNeedRestart) {
+            outState.putBoolean(KEY_ERROR_REPEAT_PATTERN, mNeedRestart);
+        }
+        super.onSaveInstanceState(outState);
+    }
+
+    private void showErrorState() {
+        mIsInErrorState = true;
+        invalidatePattern();
+        mHandler.postDelayed(new Runnable() {
+            @Override
+            public void run() {
+                mIsInErrorState = false;
+                SharedPreferences prefs = getSharedPreferences(PREFS_NAME, MODE_PRIVATE);
+                prefs.edit().putBoolean(KEY_ERROR_STATE, false).apply();
+                invalidatePattern();
+                if (mPatternView != null) mPatternView.invalidate();
+            }
+        }, PATTERN_ERROR_DURATION);
+    }
+
+    private void clearErrorState() {
+        mIsInErrorState = false;
+        SharedPreferences prefs = getSharedPreferences(PREFS_NAME, MODE_PRIVATE);
+        prefs.edit().putBoolean(KEY_ERROR_STATE, false).apply();
+        invalidatePattern();
+        if (mPatternView != null) mPatternView.invalidate();
+    }
+
+    private void showErrorToast() {
+        android.widget.Toast.makeText(this, "图案点数不足，请重新绘制", 
+            android.widget.Toast.LENGTH_SHORT).show();
+        mNeedRestart = true;
+    }
+
+    private void showSuccessDialog() {
+        android.app.AlertDialog alertDialog = new android.app.AlertDialog.Builder(this)
+            .setTitle("设置成功")
+            .setMessage("图案密码已设置成功")
+            .setPositiveButton("确定", new android.content.DialogInterface.OnClickListener() {
+                @Override
+                public void onClick(android.content.DialogInterface dialog, int which) {
+                    finish();
+                }
+            })
+            .setCancelable(false)
+            .create();
+        alertDialog.show();
+    }
+
+    void finishWithRestart() {
+        finish();
+    }
+
+    private void invalidatePattern() {
+        if (mPatternView != null) {
+            mPatternView.invalidate();
+        }
+    }
+
+    class PatternView extends FrameLayout {
+        int mPatternSize = 0;
+        int MAX_DOT_COUNT = 9;
+        int[] mDotX = new int[MAX_DOT_COUNT];
+        int[] mDotY = new int[MAX_DOT_COUNT];
+        int[] mDotState = new int[MAX_DOT_COUNT];
+        Bitmap mDotBitmap;
+        Paint mPaintConnector;
+        Paint mPaintErrorBackground;
+        int mDotCount = 0;
+
+        PatternView(Context context) {
+            super(context);
+            setBackgroundColor(Color.WHITE);
+            for (int i = 0; i < MAX_DOT_COUNT; i++) {
+                mDotX[i] = -1;
+                mDotY[i] = -1;
+                mDotState[i] = 0;
+            }
+        }
+
+        @Override
+        protected void onSizeChanged(int w, int h, int oldw, int oldh) {
+            super.onSizeChanged(w, h, oldw, oldh);
+            if (w == 0 || h == 0) return;
+            mPatternSize = w > h ? h : w;
+            int grid = 3;
+            int cell = mPatternSize / grid;
+
+            for (int i = 0; i < MAX_DOT_COUNT; i++) {
+                mDotX[i] = (i % grid) * cell + cell / 2 - cell / 24;
+                mDotY[i] = (i / grid) * cell + cell / 2 - cell / 24;
+                mDotState[i] = 0;
+            }
+
+            if (mDotBitmap == null) {
+                mDotBitmap = BitmapFactory.decodeResource(getResources(), R.drawable.dot_darkgreen_dark);
+            }
+            if (mPaintConnector == null) {
+                mPaintConnector = new Paint(Paint.FILTER_BITMAP_FLAG);
+                mPaintConnector.setColor(-0xFF006400);
+            }
+            if (mPaintErrorBackground == null) {
+                mPaintErrorBackground = new Paint(Paint.ANTI_ALIAS_FLAG);
+                mPaintErrorBackground.setColor(Color.RED);
+            }
+        }
+
+        @Override
+        public boolean onTouchEvent(MotionEvent event) {
+            if (mDotCount > 0) return false;
+
+            switch (event.getActionMasked()) {
+                case MotionEvent.ACTION_DOWN:
+                    invalidate();
+                    return true;
+                case MotionEvent.ACTION_MOVE:
+                    float x = event.getX();
+                    float y = event.getY();
+
+                    for (int i = 0; i < MAX_DOT_COUNT; i++) {
+                        int dx = (int) Math.abs(x - mDotX[i]);
+                        int dy = (int) Math.abs(y - mDotY[i]);
+                        if (dx <= DOT_RADIUS && dy <= DOT_RADIUS && mDotState[i] == 0) {
+                            mDotState[i] = 1;
+                            mDotCount++;
+                        }
+                    }
+
+                    for (int i = 0; i < mDotCount - 1; i++) {
+                        int a = -1, b = -1;
+                        for (int k = 0; k < MAX_DOT_COUNT; k++) {
+                            if (mDotState[k] == 1) {
+                                if (a < 0) a = k;
+                                else b = k;
+                            }
+                        }
+                        if (a >= 0 && b >= 0) {
+                            a = Math.min(a, b);
+                            b = Math.max(a, b);
+                        }
+                        if (mDotState[a] == 1 && mDotState[b] == 1) {
+                            int dx = mDotX[b] - mDotX[a];
+                            int dy = mDotY[b] - mDotY[a];
+                            if ((Math.abs(dx) <= 1 && Math.abs(dy) <= 1) ||
+                                (Math.abs(dx) <= 2 && Math.abs(dy) <= 1)) {
+                                if (mDotState[b] == 1) {
+                                    for (int k = a + 1; k < b; k++) {
+                                        if (mDotState[k] == 0) {
+                                            mDotState[k] = 1;
+                                        }
+                                    }
+                                    mDotCount += (b - a - 1);
+                                }
+                            }
+                        }
+                    }
+                    invalidate();
+                    return true;
+                case MotionEvent.ACTION_UP:
+                case MotionEvent.ACTION_CANCEL:
+                    if (mDotCount < 4) {
+                        showErrorState();
+                        showErrorToast();
+                    }
+                    break;
+            }
+            return true;
+        }
+
+        @Override
+        public void onDraw(Canvas canvas) {
+            if (mPatternSize == 0) return;
+
+            int activeCount = 0;
+            for (int i = 0; i < MAX_DOT_COUNT; i++) {
+                if (mDotState[i] == 1) activeCount++;
+            }
+
+            if (activeCount == 0) {
+                mPaintErrorBackground.setAlpha(50);
+            } else {
+                mPaintErrorBackground.setAlpha(mIsInErrorState ? 80 : 60);
+            }
+
+            canvas.clipRect(0, 0, mPatternSize * 80 / 100, mPatternSize * 80 / 100);
+
+            canvas.drawRect(0, 0, mPatternSize, mPatternSize, mPaintErrorBackground);
+
+            if (mDotBitmap != null) {
+                for (int i = 0; i < MAX_DOT_COUNT; i++) {
+                    if (mDotState[i] == 1) {
+                        canvas.drawBitmap(mDotBitmap, mDotX[i], mDotY[i], mPaintConnector);
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/SettingsActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/SettingsActivity.java
new file mode 100644
index 0000000..c7d877d
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/SettingsActivity.java
@@ -0,0 +1,50 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.os.Bundle;
+import android.view.View;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+import cc.winboll.studio.winboll.R;
+import android.app.Activity;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/12/05 18:48
+ * @Describe Settings Activity
+ */
+public class SettingsActivity extends BaseWinBoLLActivity {
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+
+    public static final String TAG = "SettingsActivity";
+
+	@Override
+	public String getTag() {
+		return TAG;
+	}
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        AESThemeUtil.applyAppTheme(this);
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_settings);
+		
+		// 设置工具栏
+        Toolbar toolbar = findViewById(R.id.toolbar);
+		setSupportActionBar(toolbar);
+        getSupportActionBar().setSubtitle(TAG);
+        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+        toolbar.setNavigationOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View v) {
+                    finish(); // 点击导航栏返回按钮，触发 finish()
+                }
+            });
+
+    }
+
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/ShortcutActionActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/ShortcutActionActivity.java
new file mode 100644
index 0000000..8ebd744
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/ShortcutActionActivity.java
@@ -0,0 +1,50 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.os.Bundle;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.winboll.App;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.utils.APPPlusUtils;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 09:00
+ * @Describe 应用快捷方式活动类
+ */
+public class ShortcutActionActivity extends Activity {
+
+    public static final String TAG = "ShortcutActionActivity";
+
+	@Override
+	protected void onCreate(Bundle savedInstanceState) {
+		super.onCreate(savedInstanceState);
+		// 处理应用级别的切换请求
+        handleSwitchRequest();
+		finish();
+	}
+
+	/**
+     * 处理应用图标快捷菜单的请求
+     */
+    private void handleSwitchRequest() {
+		//ToastUtils.show("handleSwitchRequest");
+        Intent intent = getIntent();
+        if (intent != null && "switchto_en1".equals(intent.getDataString())) {
+			APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_EN1);
+            ToastUtils.show("切换至" + getString(R.string.app_name) + "图标");
+			//moveTaskToBack(true);
+        }
+		if (intent != null && "switchto_cn1".equals(intent.getDataString())) {
+			APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN1);
+            ToastUtils.show("切换至" + getString(R.string.app_name_cn1) + "图标");
+			//moveTaskToBack(true);
+        }
+		if (intent != null && "switchto_cn2".equals(intent.getDataString())) {
+			APPPlusUtils.switchAppLauncherToComponent(this, App.COMPONENT_CN2);
+            ToastUtils.show("切换至" + getString(R.string.app_name_cn2) + "图标");
+			//moveTaskToBack(true);
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/WinBoLLUnitTestActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/WinBoLLUnitTestActivity.java
new file mode 100644
index 0000000..177c5a0
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/WinBoLLUnitTestActivity.java
@@ -0,0 +1,172 @@
+package cc.winboll.studio.winboll.activities;
+
+import android.app.Activity;
+import android.content.ComponentName;
+import android.content.Intent;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.CheckBox;
+import cc.winboll.studio.libaes.utils.WinBoLLActivityManager;
+import cc.winboll.studio.libappbase.CrashHandler;
+import cc.winboll.studio.libappbase.GlobalApplication;
+import cc.winboll.studio.libappbase.GlobalCrashActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.winboll.App;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.services.MainService;
+import cc.winboll.studio.winboll.services.TestDemoBindService;
+import cc.winboll.studio.winboll.services.TestDemoService;
+import cc.winboll.studio.winboll.sos.SOS;
+import cc.winboll.studio.winboll.widgets.StatusWidget;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+
+public class WinBoLLUnitTestActivity extends AppCompatActivity {
+
+    public static final String TAG = "MainActivity";
+
+    Toolbar mToolbar;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        ToastUtils.show("onCreate");
+        setContentView(R.layout.activity_winbollunittest);
+
+        mToolbar = findViewById(R.id.toolbar);
+        setSupportActionBar(mToolbar);
+
+        CheckBox cbIsDebugMode = findViewById(R.id.activitymainCheckBox1);
+        cbIsDebugMode.setChecked(GlobalApplication.isDebugging());
+    }
+
+    @Override
+    public boolean onCreateOptionsMenu(Menu menu) {
+        //getMenuInflater().inflate(R.menu.toolbar_main, menu);
+        return super.onCreateOptionsMenu(menu);
+    }
+
+    @Override
+    public boolean onOptionsItemSelected(MenuItem item) {
+//        if(item.getItemId() == R.id.item_yun) {
+//            WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, cc.winboll.studio.winboll.activities.YunActivity.class);
+//        } else if(item.getItemId() == R.id.item_logon) {
+//            WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, cc.winboll.studio.winboll.activities.LogonActivity.class);
+//        }
+        // 在switch语句中处理每个ID，并在处理完后返回true，未处理的情况返回false。
+        return super.onOptionsItemSelected(item);
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        Intent intentAPPWidget = new Intent(this, StatusWidget.class);
+        intentAPPWidget.setAction(StatusWidget.ACTION_STATUS_UPDATE);
+        sendBroadcast(intentAPPWidget);
+    }
+
+	public void onSwitchDebugMode(View view) {
+        boolean isDebuging = ((CheckBox)view).isChecked();
+        GlobalApplication.setIsDebugging(isDebuging);
+        GlobalApplication.saveDebugStatus((App.getInstance()));
+    }
+
+    public void onPreviewGlobalCrashActivity(View view) {
+        Intent intent = new Intent(this, GlobalCrashActivity.class);
+        intent.putExtra(CrashHandler.EXTRA_CRASH_LOG, "Demo log...");
+        startActivity(intent);
+    }
+
+    public void onStartCenter(View view) {
+        MainService.startMainService(this);
+    }
+
+    public void onStopCenter(View view) {
+        MainService.stopMainService(this);
+    }
+
+    public void onTestStopMainServiceWithoutSettingEnable(View view) {
+        LogUtils.d(TAG, "onTestStopMainServiceWithoutSettingEnable");
+        stopService(new Intent(this, MainService.class));
+    }
+
+    public void onTestUseComponentStartService(View view) {
+        LogUtils.d(TAG, "onTestUseComponentStartService");
+
+        // 目标服务的包名和类名
+        String packageName = this.getPackageName();
+        String serviceClassName = TestDemoService.class.getName();
+
+        // 构建Intent
+        Intent intentService = new Intent();
+        intentService.setComponent(new ComponentName(packageName, serviceClassName));
+
+        startService(intentService);
+    }
+
+    public void onTestDemoServiceSOS(View view) {
+        Intent intent = new Intent(this, TestDemoService.class);
+        stopService(intent);
+        if (App.isDebugging()) {
+            SOS.sosToAppBaseBeta(this, TestDemoService.class.getName());
+        } else {
+            SOS.sosToAppBase(this, TestDemoService.class.getName());
+        }
+    }
+
+    public void onSartTestDemoService(View view) {
+        Intent intent = new Intent(this, TestDemoService.class);
+        intent.setAction(TestDemoService.ACTION_ENABLE);
+        startService(intent);
+
+    }
+
+    public void onStopTestDemoService(View view) {
+        Intent intent = new Intent(this, TestDemoService.class);
+        intent.setAction(TestDemoService.ACTION_DISABLE);
+        startService(intent);
+
+        Intent intentStop = new Intent(this, TestDemoService.class);
+        stopService(intentStop);
+    }
+
+    public void onStopTestDemoServiceNoSettings(View view) {
+        Intent intent = new Intent(this, TestDemoService.class);
+        stopService(intent);
+    }
+
+    public void onSartTestDemoBindService(View view) {
+        Intent intent = new Intent(this, TestDemoBindService.class);
+        intent.setAction(TestDemoBindService.ACTION_ENABLE);
+        startService(intent);
+
+    }
+
+    public void onStopTestDemoBindService(View view) {
+        Intent intent = new Intent(this, TestDemoBindService.class);
+        intent.setAction(TestDemoBindService.ACTION_DISABLE);
+        startService(intent);
+
+        Intent intentStop = new Intent(this, TestDemoBindService.class);
+        stopService(intentStop);
+    }
+
+    public void onStopTestDemoBindServiceNoSettings(View view) {
+        Intent intent = new Intent(this, TestDemoBindService.class);
+        stopService(intent);
+    }
+
+    public void onTestOpenNewActivity(View view) {
+        WinBoLLActivityManager.getInstance().startWinBoLLActivity(this, NewActivity.class);
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+    }
+
+
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/activities/YunActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/activities/YunActivity.java
new file mode 100644
index 0000000..8ab5fb6
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/activities/YunActivity.java
@@ -0,0 +1,126 @@
+package cc.winboll.studio.winboll.activities;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/04 11:06
+ * @Describe 云宝云
+ */
+import android.app.Activity;
+import android.os.Bundle;
+import android.view.View;
+import android.widget.RadioButton;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.BuildConfig;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.LogView;
+import cc.winboll.studio.winboll.R;
+import java.io.IOException;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+public class YunActivity extends Activity implements IWinBoLLActivity {
+
+    public static final String TAG = "YunActivity";
+
+    public static final String DEBUG_HOST = "http://10.8.0.250:456";
+    public static final String YUN_HOST = "https://yun.winboll.cc";
+
+    String mHost = "";
+    RadioButton mrbYunHost;
+    RadioButton mrbDebugHost;
+    LogView mLogView;
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_yun);
+        mLogView = findViewById(R.id.logview);
+        mLogView.start();
+
+        mHost = BuildConfig.DEBUG ? DEBUG_HOST: YUN_HOST;
+        if (BuildConfig.DEBUG) {
+            mrbYunHost = findViewById(R.id.rb_yunhost);
+            mrbDebugHost = findViewById(R.id.rb_debughost);
+            mrbYunHost.setChecked(!BuildConfig.DEBUG);
+            mrbDebugHost.setChecked(BuildConfig.DEBUG);
+        } else {
+            findViewById(R.id.ll_hostbar).setVisibility(View.GONE);
+        }
+    }
+
+    public void onSwitchHost(View view) {
+        if (view.getId() == R.id.rb_yunhost) {
+            mrbDebugHost.setChecked(false);
+            mHost = YUN_HOST;
+        } else if (view.getId() == R.id.rb_debughost) {
+            mrbYunHost.setChecked(false);
+            mHost = DEBUG_HOST;
+        }
+    }
+
+    @Override
+    protected void onResume() {
+        super.onResume();
+        mLogView.start();
+    }
+
+    public void onTestYun(View view) {
+        LogUtils.d(TAG, "onTestYun");
+        (new Thread(new Runnable(){
+                @Override
+                public void run() {
+                    testYun();
+                }
+            })).start();
+    }
+
+    void testYun() {
+        OkHttpClient client = new OkHttpClient();
+        Request request = new Request.Builder()
+            .url(mHost + "/backups/")
+            .build();
+
+        Response response = null;
+        try {
+            response = client.newCall(request).execute();
+            if (response.isSuccessful()) {
+                String responseBody = "";
+                if (response.body() != null) {
+                    responseBody = response.body().string();
+                }
+
+                // 正则匹配：任意主机名 -> Test OK（主机名部分匹配非空字符）
+                boolean isMatch = responseBody.matches(".+? -> Test OK");
+
+                if (isMatch) {
+                    LogUtils.d(TAG, responseBody);
+                } else {
+                    LogUtils.d(TAG, "响应内容不匹配，内容：" + responseBody);
+                }
+            } else {
+                LogUtils.d(TAG, "请求失败，状态码：" + response.code());
+            }
+        } catch (IOException e) {
+            LogUtils.d(TAG, "读取响应体失败：" + e.getMessage());
+        } catch (Exception e) {
+            LogUtils.d(TAG, "异常：" + e.getMessage());
+            e.printStackTrace(); // Java 7 需显式打印堆栈
+        } finally {
+            // 手动关闭 Response（Java 7 不支持 try-with-resources）
+            if (response != null && response.body() != null) {
+                response.body().close();
+            }
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/applications/MyTermuxActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/applications/MyTermuxActivity.java
new file mode 100644
index 0000000..6bd2b29
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/applications/MyTermuxActivity.java
@@ -0,0 +1,237 @@
+package cc.winboll.studio.winboll.applications;
+
+import android.app.AlertDialog;
+import android.content.DialogInterface;
+import android.os.Bundle;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.AdapterView;
+import android.widget.BaseAdapter;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.LinearLayout;
+import android.widget.ListView;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.models.TermuxButtonManager;
+import cc.winboll.studio.winboll.models.TermuxButtonModel;
+import cc.winboll.studio.winboll.termux.TermuxCommandExecutor;
+import java.util.ArrayList;
+
+public class MyTermuxActivity extends AppCompatActivity {
+
+    public static final String TAG = "MyTermuxActivity";
+
+    private Toolbar mToolbar;
+    private ListView mListView;
+    private Button mBtnAdd;
+    private ButtonAdapter mAdapter;
+    private ArrayList<TermuxButtonModel> mButtonList;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_my_termux);
+
+        initToolbar();
+        initListView();
+        initAddButton();
+        refreshList();
+    }
+
+    private void initToolbar() {
+        mToolbar = findViewById(R.id.toolbar);
+        if (mToolbar != null) {
+            setSupportActionBar(mToolbar);
+            getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+            mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View v) {
+                    finish();
+                }
+            });
+        }
+    }
+
+    private void initListView() {
+        mListView = findViewById(R.id.list_termux_buttons);
+        mButtonList = new ArrayList<TermuxButtonModel>();
+        mAdapter = new ButtonAdapter();
+        mListView.setAdapter(mAdapter);
+
+        mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
+            @Override
+            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
+                TermuxButtonModel model = mButtonList.get(position);
+                TermuxCommandExecutor.openTermuxBash(MyTermuxActivity.this,
+                    model.getExeCommand(), model.getWorkDir());
+            }
+        });
+
+        mListView.setOnItemLongClickListener(new AdapterView.OnItemLongClickListener() {
+            @Override
+            public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) {
+                showContextMenu(position);
+                return true;
+            }
+        });
+    }
+
+    private void initAddButton() {
+        mBtnAdd = findViewById(R.id.btn_add_termux_button);
+        mBtnAdd.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                showButtonDialog(-1, null);
+            }
+        });
+    }
+
+    private void refreshList() {
+        mButtonList.clear();
+        ArrayList<TermuxButtonModel> loaded = TermuxButtonManager.loadButtons(this);
+        if (loaded != null) {
+            mButtonList.addAll(loaded);
+        }
+        mAdapter.notifyDataSetChanged();
+    }
+
+    private void showContextMenu(final int position) {
+        final TermuxButtonModel model = mButtonList.get(position);
+        String[] items = new String[]{
+            getString(R.string.menu_execute),
+            getString(R.string.menu_edit),
+            getString(R.string.menu_delete),
+            getString(R.string.menu_cancel)
+        };
+        new AlertDialog.Builder(this)
+            .setTitle(model.getButtonName())
+            .setItems(items, new DialogInterface.OnClickListener() {
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    if (which == 0) {
+                        TermuxCommandExecutor.openTermuxBash(MyTermuxActivity.this,
+                            model.getExeCommand(), model.getWorkDir());
+                    } else if (which == 1) {
+                        showButtonDialog(position, model);
+                    } else if (which == 2) {
+                        showDeleteConfirmDialog(position);
+                    }
+                }
+            })
+            .show();
+    }
+
+    private void showDeleteConfirmDialog(final int position) {
+        new AlertDialog.Builder(this)
+            .setTitle(getString(R.string.dialog_delete_title))
+            .setMessage(getString(R.string.dialog_delete_message) + mButtonList.get(position).getButtonName())
+            .setPositiveButton(getString(R.string.dialog_confirm), new DialogInterface.OnClickListener() {
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    TermuxButtonManager.deleteButton(MyTermuxActivity.this, mButtonList, position);
+                    refreshList();
+                    Toast.makeText(MyTermuxActivity.this, R.string.toast_deleted, Toast.LENGTH_SHORT).show();
+                }
+            })
+            .setNegativeButton(getString(R.string.dialog_cancel), null)
+            .show();
+    }
+
+    private void showButtonDialog(final int index, final TermuxButtonModel model) {
+        final boolean isEdit = (model != null);
+
+        LinearLayout layout = new LinearLayout(this);
+        layout.setOrientation(LinearLayout.VERTICAL);
+        layout.setPadding(40, 20, 40, 20);
+
+        final EditText etName = new EditText(this);
+        etName.setHint(R.string.hint_button_name);
+        if (model != null) {
+            etName.setText(model.getButtonName());
+        }
+        layout.addView(etName);
+
+        final EditText etCommand = new EditText(this);
+        etCommand.setHint(R.string.hint_exe_command);
+        if (model != null) {
+            etCommand.setText(model.getExeCommand());
+        }
+        layout.addView(etCommand);
+
+        final EditText etWorkDir = new EditText(this);
+        etWorkDir.setHint(R.string.hint_work_dir);
+        if (model != null) {
+            etWorkDir.setText(model.getWorkDir());
+        }
+        layout.addView(etWorkDir);
+
+        int titleResId = isEdit ? R.string.dialog_edit_title : R.string.dialog_add_title;
+        new AlertDialog.Builder(this)
+            .setTitle(titleResId)
+            .setView(layout)
+            .setPositiveButton(getString(R.string.dialog_save), new DialogInterface.OnClickListener() {
+                @Override
+                public void onClick(DialogInterface dialog, int which) {
+                    String name = etName.getText().toString().trim();
+                    String command = etCommand.getText().toString().trim();
+                    String workDir = etWorkDir.getText().toString().trim();
+                    if (name.isEmpty() || command.isEmpty()) {
+                        Toast.makeText(MyTermuxActivity.this, R.string.toast_fields_required, Toast.LENGTH_SHORT).show();
+                        return;
+                    }
+                    TermuxButtonModel newModel = new TermuxButtonModel();
+                    newModel.setButtonName(name);
+                    newModel.setExeCommand(command);
+                    newModel.setWorkDir(workDir);
+                    if (isEdit) {
+                        TermuxButtonManager.updateButton(MyTermuxActivity.this, mButtonList, index, newModel);
+                    } else {
+                        TermuxButtonManager.addButton(MyTermuxActivity.this, mButtonList, newModel);
+                    }
+                    refreshList();
+                }
+            })
+            .setNegativeButton(getString(R.string.dialog_cancel), null)
+            .show();
+    }
+
+    private class ButtonAdapter extends BaseAdapter {
+        @Override
+        public int getCount() {
+            return mButtonList.size();
+        }
+
+        @Override
+        public Object getItem(int position) {
+            return mButtonList.get(position);
+        }
+
+        @Override
+        public long getItemId(int position) {
+            return position;
+        }
+
+        @Override
+        public View getView(int position, View convertView, ViewGroup parent) {
+            TextView tv;
+            if (convertView == null) {
+                tv = new TextView(MyTermuxActivity.this);
+                tv.setPadding(30, 20, 30, 20);
+                tv.setTextSize(16);
+                tv.setMinHeight(80);
+            } else {
+                tv = (TextView) convertView;
+            }
+
+            TermuxButtonModel model = mButtonList.get(position);
+            tv.setText(model.getButtonName() + "\n" + model.getExeCommand());
+            tv.setTextColor(getResources().getColor(android.R.color.white));
+            return tv;
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/fragments/BrowserFragment.java b/winboll/src/main/java/cc/winboll/studio/winboll/fragments/BrowserFragment.java
new file mode 100644
index 0000000..aa7b4ca
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/fragments/BrowserFragment.java
@@ -0,0 +1,350 @@
+package cc.winboll.studio.winboll.fragments;
+
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Message;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.inputmethod.InputMethodManager;
+import android.widget.Button;
+import android.widget.EditText;
+import android.widget.ProgressBar;
+import android.widget.TextView;
+import android.widget.Toast;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.fragment.app.Fragment;
+import cc.winboll.studio.winboll.MainActivity;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.views.WinBoLLView;
+import java.util.ArrayList;
+import android.app.Activity;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 11:09
+ * @Describe 浏览器Fragment（Java 7 语法完整版，新增Handler消息接收）
+ * 适配Java 7特性，支持接收应用内消息（如MSG_HOMEPAGE跳转首页）
+ */
+public class BrowserFragment extends Fragment implements View.OnClickListener, WinBoLLView.OnPageStatusListener {
+
+    // 控件声明（Java 7 成员变量显式声明）
+    private EditText mEtUrl;
+    private Button mBtnLoad;
+    private Button mBtnRefresh;
+    private Button mBtnStop;
+    private Button mBtnForward;
+    private Button mBtnBack;
+    private ProgressBar mProgressBar;
+    private WinBoLLView mWinBoLLView;
+	public static ArrayList<String> _mUrlLoadHistory = new ArrayList<String>();
+
+    // ------------------- 新增：Handler 消息定义（应用内通信） -------------------
+    // 消息标识：跳转首页（winboll.cc）
+    public static final int MSG_HOMEPAGE = 1001;
+	// 跳转到历史记录位置
+    public static final int MSG_HISTORY_POSITION = 1002;
+	// 打开外部应用传入的 URL
+	public static final int MSG_OPEN_URL = 1003;
+    // 自定义Handler（接收应用内其他页面发送的消息）
+    private Handler mBrowserHandler;
+
+    // 单例创建方法（Java 7 显式工厂模式）
+    public static BrowserFragment newInstance() {
+        return new BrowserFragment();
+    }
+
+    // 创建带初始URL的实例（供外部应用调用时使用）
+    public static BrowserFragment newInstance(String initialUrl) {
+        BrowserFragment fragment = new BrowserFragment();
+        Bundle args = new Bundle();
+        args.putString("initial_url", initialUrl);
+        fragment.setArguments(args);
+        return fragment;
+    }
+
+    @Nullable
+    @Override
+    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
+        // 加载布局（Java 7 显式强转，无菱形语法）
+        View view = inflater.inflate(R.layout.fragment_browser, container, false);
+		// 清理旧历史记录
+		_mUrlLoadHistory.clear();
+
+        // 初始化控件
+        initViews(view);
+        // 绑定事件
+        initEvents();
+        // 初始化WinBoLLView
+        initWinBoLLView();
+        // ------------------- 新增：初始化Handler（关键） -------------------
+        initHandler();
+        return view;
+    }
+
+    /**
+     * 初始化控件（Java 7 显式绑定，无Stream简化）
+     */
+    private void initViews(View view) {
+        mEtUrl = (EditText) view.findViewById(R.id.et_url);
+        mBtnLoad = (Button) view.findViewById(R.id.btn_load);
+        mBtnRefresh = (Button) view.findViewById(R.id.btn_refresh);
+        mBtnStop = (Button) view.findViewById(R.id.btn_stop);
+        mBtnForward = (Button) view.findViewById(R.id.btn_forward);
+        mBtnBack = (Button) view.findViewById(R.id.btn_back);
+        mProgressBar = (ProgressBar) view.findViewById(R.id.progress_bar);
+        mWinBoLLView = (WinBoLLView) view.findViewById(R.id.winboll_webview);
+    }
+
+    /**
+     * 绑定点击事件（Java 7 匿名内部类，无Lambda）
+     */
+    private void initEvents() {
+        // 功能按钮点击事件
+        mBtnLoad.setOnClickListener(this);
+        mBtnRefresh.setOnClickListener(this);
+        mBtnStop.setOnClickListener(this);
+        mBtnForward.setOnClickListener(this);
+        mBtnBack.setOnClickListener(this);
+
+        // 输入框软键盘“前往”按钮事件（Java 7 匿名内部类实现）
+        mEtUrl.setOnEditorActionListener(new TextView.OnEditorActionListener() {
+				@Override
+				public boolean onEditorAction(TextView v, int actionId, android.view.KeyEvent event) {
+					// 处理软键盘“前往”点击
+					loadUrlFromInput();
+					return true;
+				}
+			});
+    }
+
+    /**
+     * 初始化WinBoLLView（Java 7 显式调用，无方法引用）
+     */
+    private void initWinBoLLView() {
+        // 绑定进度条
+        mWinBoLLView.setProgressBar(mProgressBar);
+        // 设置页面状态监听（this 实现 OnPageStatusListener）
+        mWinBoLLView.setOnPageStatusListener(this);
+
+        // 检查是否有外部传入的初始 URL
+        String initialUrl = null;
+        if (getArguments() != null) {
+            initialUrl = getArguments().getString("initial_url");
+        }
+
+        if (initialUrl != null && !initialUrl.isEmpty()) {
+            // 使用外部传入的 URL
+            mWinBoLLView.loadUrlSafe(initialUrl);
+            mEtUrl.setText(initialUrl);
+        } else {
+            // 预加载默认页面（winboll.cc 首页）
+            String defaultUrl = "https://www.winboll.cc";
+            mWinBoLLView.loadUrlSafe(defaultUrl);
+            mEtUrl.setText(defaultUrl);
+        }
+    }
+
+    // ------------------- 新增：初始化Handler（接收应用内消息） -------------------
+    private void initHandler() {
+        // Java 7 匿名内部类实现Handler（主线程中创建，用于更新UI）
+        mBrowserHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                // 根据消息标识处理不同逻辑
+                switch (msg.what) {
+                    case MSG_HOMEPAGE:
+                        // 处理“跳转首页”消息：加载winboll.cc
+                        String homeUrl = "https://www.winboll.cc";
+                        mWinBoLLView.loadUrlSafe(homeUrl);
+                        mEtUrl.setText(homeUrl);
+                        showToast("已跳转至首页");
+                        break;
+					case MSG_HISTORY_POSITION:
+						int position = (int)msg.obj;
+						if(-1 < position && position < _mUrlLoadHistory.size()) {
+							// 处理“跳转首页”消息：加载winboll.cc
+							String historyUrl = _mUrlLoadHistory.get(position);
+							mWinBoLLView.loadUrlSafe(historyUrl);
+							mEtUrl.setText(historyUrl);
+							//showToast("已跳转至" + historyUrl);
+						}
+                        break;
+                    case MSG_OPEN_URL:
+                        String openUrl = (String) msg.obj;
+                        if (openUrl != null && !openUrl.isEmpty()) {
+                            mWinBoLLView.loadUrlSafe(openUrl);
+                            mEtUrl.setText(openUrl);
+                        }
+                        break;
+                    default:
+                        break;
+                }
+            }
+        };
+    }
+
+    /**
+     * 点击事件处理（Java 7 switch-case 语句，无增强switch）
+     */
+    @Override
+    public void onClick(View v) {
+        int id = v.getId();
+        if (id == R.id.btn_load) {
+            // 加载输入框中的URL
+            loadUrlFromInput();
+        } else if (id == R.id.btn_refresh) {
+            // 刷新当前页面
+            mWinBoLLView.refreshPage();
+        } else if (id == R.id.btn_stop) {
+            // 停止页面加载
+            mWinBoLLView.stopPageLoad();
+        } else if (id == R.id.btn_forward) {
+            // 前进（无历史则提示）
+            if (!mWinBoLLView.goForwardSafe()) {
+                showToast("无前进历史");
+            }
+        } else if (id == R.id.btn_back) {
+            // 后退（无历史则提示）
+            if (!mWinBoLLView.goBackSafe()) {
+                showToast("无后退历史");
+            }
+        }
+    }
+
+    /**
+     * 从输入框获取URL并加载（Java 7 显式空值校验）
+     */
+    private void loadUrlFromInput() {
+        // 空值校验（Java 7 显式判断，无Objects.requireNonNull）
+        if (mEtUrl == null) {
+            showToast("控件初始化失败");
+            return;
+        }
+        String url = mEtUrl.getText().toString().trim();
+        // 调用WinBoLLView安全加载方法
+        mWinBoLLView.loadUrlSafe(url);
+        // 隐藏软键盘
+        hideSoftKeyboard();
+    }
+
+    /**
+     * 隐藏软键盘（Java 7 显式获取系统服务，无Lambda简化）
+     */
+    private void hideSoftKeyboard() {
+        if (getActivity() == null) {
+            return;
+        }
+        // 获取InputMethodManager（Java 7 显式强转）
+        InputMethodManager imm = (InputMethodManager) getActivity().getSystemService(android.content.Context.INPUT_METHOD_SERVICE);
+        if (imm != null && getActivity().getCurrentFocus() != null) {
+            imm.hideSoftInputFromWindow(getActivity().getCurrentFocus().getWindowToken(), 0);
+        }
+    }
+
+    /**
+     * 显示Toast提示（Java 7 简化封装，避免重复代码）
+     */
+    private void showToast(String msg) {
+        if (getActivity() == null || msg == null) {
+            return;
+        }
+        // Java 7 显式创建Toast，无Toast.makeText简化链式调用
+        Toast toast = Toast.makeText(getActivity(), msg, Toast.LENGTH_SHORT);
+        toast.show();
+    }
+
+    // ------------------- WinBoLLView.OnPageStatusListener 实现（Java 7 显式重写） -------------------
+    @Override
+    public void onPageStarted(String url) {
+        // 页面开始加载：更新输入框URL（Java 7 显式非空判断）
+        if (mEtUrl != null && url != null) {
+            mEtUrl.setText(url);
+        }
+    }
+
+    @Override
+    public void onPageFinished(String url) {
+        // 页面加载完成：更新输入框URL
+        if (mEtUrl != null && url != null) {
+            mEtUrl.setText(url);
+			addUrlToHistory(url);
+        }
+    }
+
+    @Override
+    public void onPageError(String errorMsg) {
+        // 页面加载错误：显示错误提示
+        showToast("加载失败：" + errorMsg);
+    }
+
+    // ------------------- 新增：对外提供Handler（供其他页面获取并发送消息） -------------------
+    public Handler getBrowserHandler() {
+        return mBrowserHandler;
+    }
+
+    // ------------------- 生命周期管理（防止内存泄漏，Java 7 显式重写） -------------------
+    @Override
+    public void onDestroyView() {
+        super.onDestroyView();
+        // 销毁WinBoLLView（释放资源，避免内存泄漏）
+        if (mWinBoLLView != null) {
+            mWinBoLLView.destroyWebView();
+            mWinBoLLView = null;
+        }
+        // ------------------- 新增：移除Handler消息（关键，防止内存泄漏） -------------------
+        if (mBrowserHandler != null) {
+            mBrowserHandler.removeCallbacksAndMessages(null); // 清除所有消息和回调
+            mBrowserHandler = null;
+        }
+        // 置空控件（帮助GC回收）
+        mEtUrl = null;
+        mBtnLoad = null;
+        mBtnRefresh = null;
+        mBtnStop = null;
+        mBtnForward = null;
+        mBtnBack = null;
+        mProgressBar = null;
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        // 彻底释放资源
+        if (mWinBoLLView != null) {
+            mWinBoLLView.destroyWebView();
+            mWinBoLLView = null;
+        }
+        // 再次清除Handler（双重保险）
+        if (mBrowserHandler != null) {
+            mBrowserHandler.removeCallbacksAndMessages(null);
+            mBrowserHandler = null;
+        }
+    }
+
+	// 在 BrowserFragment 中添加以下代码（Java 7 语法）
+	/**
+	 * 发送URL历史更新消息给MainActivity（当历史列表变化时调用）
+	 */
+	private void sendUrlHistoryUpdateMsg() {
+		Message msg = Message.obtain();
+	    msg.what = MainActivity.MSG_URLLOADHISTORY_UPDATE;
+		MainActivity.sendMessage(msg);
+	}
+
+	// 调用时机示例（在BrowserFragment加载URL并更新历史列表后调用）
+	// 假设BrowserFragment中有添加URL到历史的方法：
+	private void addUrlToHistory(String url) {
+		if (_mUrlLoadHistory == null) {
+			_mUrlLoadHistory = new ArrayList<String>();
+		}
+		if (!_mUrlLoadHistory.contains(url)) {
+			_mUrlLoadHistory.add(0, url);
+			// 关键：添加历史后发送更新消息，通知MainActivity刷新抽屉菜单
+			sendUrlHistoryUpdateMsg();
+		}
+	}
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/fragments/MainFragment.java b/winboll/src/main/java/cc/winboll/studio/winboll/fragments/MainFragment.java
new file mode 100644
index 0000000..4610993
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/fragments/MainFragment.java
@@ -0,0 +1,35 @@
+package cc.winboll.studio.winboll.fragments;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/09/29 13:15
+ * @Describe MainFragment
+ */
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Switch;
+import androidx.fragment.app.Fragment;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.winboll.R;
+
+
+public class MainFragment extends Fragment {
+    
+    public static final String TAG = "MainFragment";
+    
+    @Override
+    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+        View view = inflater.inflate(R.layout.fragment_main, container, false);
+        Switch swEnablePosition = view.findViewById(R.id.fragmentmainSwitch1);
+        swEnablePosition.setOnClickListener(new View.OnClickListener() {
+                @Override
+                public void onClick(View view) {
+                    ToastUtils.show("Position");
+                }
+            });
+        return view;
+    }
+    
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/handlers/MainServiceHandler.java b/winboll/src/main/java/cc/winboll/studio/winboll/handlers/MainServiceHandler.java
new file mode 100644
index 0000000..effeb43
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/handlers/MainServiceHandler.java
@@ -0,0 +1,38 @@
+package cc.winboll.studio.winboll.handlers;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/14 03:51:40
+ */
+import android.os.Handler;
+import android.os.Message;
+import java.lang.ref.WeakReference;
+import cc.winboll.studio.winboll.services.MainService;
+
+public class MainServiceHandler extends Handler {
+    public static final String TAG = "MainServiceHandler";
+
+    public static final int MSG_REMINDTHREAD = 0;
+
+    WeakReference<MainService> serviceWeakReference;
+    public MainServiceHandler(MainService service) {
+        serviceWeakReference = new WeakReference<MainService>(service);
+    }
+
+    @Override
+    public void handleMessage(Message msg) {
+        switch (msg.what) {
+            case MSG_REMINDTHREAD: // 处理下载完成消息，更新UI
+                {
+                    // 显示提醒消息
+                    //
+                    //LogUtils.d(TAG, "显示提醒消息");
+                    MainService mainService = serviceWeakReference.get();
+                    if (mainService != null) {
+                        mainService.appenMessage((String)msg.obj);
+                    }
+                    break;
+                }
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/MainServiceBean.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/MainServiceBean.java
new file mode 100644
index 0000000..98b64a1
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/MainServiceBean.java
@@ -0,0 +1,67 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/13 07:06:13
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class MainServiceBean extends BaseBean {
+
+    public static final String TAG = "MainServiceBean";
+
+    boolean isEnable;
+
+    public MainServiceBean() {
+        this.isEnable = false;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    @Override
+    public String getName() {
+        return MainServiceBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("isEnable").value(isEnable());
+
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("isEnable")) {
+                setIsEnable(jsonReader.nextBoolean());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/NfcTermuxCmd.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/NfcTermuxCmd.java
new file mode 100644
index 0000000..c0ea16d
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/NfcTermuxCmd.java
@@ -0,0 +1,14 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/03/15 08:46
+ */
+public class NfcTermuxCmd {
+    public String script;       // 要执行的预制脚本名（如 auth.sh）
+    public String[] args;       // 脚本参数
+    public String workDir;      // 工作目录
+    public boolean background;  // 是否后台执行
+    public String resultDir;    // 结果输出目录（可为 null）
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/ResponseData.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/ResponseData.java
new file mode 100644
index 0000000..ed78bdc
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/ResponseData.java
@@ -0,0 +1,53 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/05 11:26
+ */
+
+public class ResponseData {
+    
+    public static final String STATUS_SUCCESS = "success";
+    public static final String STATUS_ERROR = "error";
+    
+    private String status;
+    private String message;
+    private UserInfoModel data;
+    
+    public ResponseData() {
+        this.status = "";
+        this.message = "";
+        this.data = new UserInfoModel();
+    }
+    
+    public ResponseData(String status, String message, UserInfoModel data) {
+        this.status = status;
+        this.message = message;
+        this.data = data;
+    }
+
+    public void setStatus(String status) {
+        this.status = status;
+    }
+
+    public String getStatus() {
+        return status;
+    }
+
+    public void setMessage(String message) {
+        this.message = message;
+    }
+
+    public String getMessage() {
+        return message;
+    }
+
+    public void setData(UserInfoModel data) {
+        this.data = data;
+    }
+
+    public UserInfoModel getData() {
+        return data;
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/TermuxButtonManager.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/TermuxButtonManager.java
new file mode 100644
index 0000000..456a2a2
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/TermuxButtonManager.java
@@ -0,0 +1,37 @@
+package cc.winboll.studio.winboll.models;
+
+import android.content.Context;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.util.ArrayList;
+
+public class TermuxButtonManager {
+
+    public static ArrayList<TermuxButtonModel> loadButtons(Context context) {
+        ArrayList<TermuxButtonModel> list = new ArrayList<TermuxButtonModel>();
+        BaseBean.loadBeanList(context, list, TermuxButtonModel.class);
+        return list;
+    }
+
+    public static boolean saveButtons(Context context, ArrayList<TermuxButtonModel> list) {
+        return BaseBean.saveBeanList(context, list, TermuxButtonModel.class);
+    }
+
+    public static void addButton(Context context, ArrayList<TermuxButtonModel> list, TermuxButtonModel button) {
+        list.add(button);
+        saveButtons(context, list);
+    }
+
+    public static void updateButton(Context context, ArrayList<TermuxButtonModel> list, int index, TermuxButtonModel button) {
+        if (index >= 0 && index < list.size()) {
+            list.set(index, button);
+            saveButtons(context, list);
+        }
+    }
+
+    public static void deleteButton(Context context, ArrayList<TermuxButtonModel> list, int index) {
+        if (index >= 0 && index < list.size()) {
+            list.remove(index);
+            saveButtons(context, list);
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/TermuxButtonModel.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/TermuxButtonModel.java
new file mode 100644
index 0000000..80a40a4
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/TermuxButtonModel.java
@@ -0,0 +1,142 @@
+package cc.winboll.studio.winboll.models;
+
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/04/30 10:47
+ */
+public class TermuxButtonModel extends BaseBean {
+
+    public static final String TAG = "TermuxButtonModel";
+
+    String buttonName;
+    String exeCommand;
+    String workDir;
+
+    // 已修改：isCommit 改为规范过去式命名 isCommitted
+    boolean isCommitted;
+    String commitTitle;
+    String commitInfo;
+
+    public TermuxButtonModel() {
+        this.buttonName = "";
+        this.exeCommand = "";
+        this.workDir = "";
+        // 默认初始化
+        this.isCommitted = false;
+        this.commitTitle = "";
+        this.commitInfo = "";
+    }
+
+    public void setButtonName(String buttonName) {
+        this.buttonName = buttonName;
+    }
+
+    public String getButtonName() {
+        return buttonName;
+    }
+
+    public void setExeCommand(String exeCommand) {
+        this.exeCommand = exeCommand;
+    }
+
+    public String getExeCommand() {
+        return exeCommand;
+    }
+
+    public void setWorkDir(String workDir) {
+        this.workDir = workDir;
+    }
+
+    public String getWorkDir() {
+        return workDir;
+    }
+
+    // ========== 已修改 对应 isCommitted 完整 Get & Set ==========
+    public boolean isCommitted() {
+        return isCommitted;
+    }
+
+    public void setCommitted(boolean committed) {
+        isCommitted = committed;
+    }
+
+    public String getCommitTitle() {
+        return commitTitle;
+    }
+
+    public void setCommitTitle(String commitTitle) {
+        this.commitTitle = commitTitle;
+    }
+
+    public String getCommitInfo() {
+        return commitInfo;
+    }
+
+    public void setCommitInfo(String commitInfo) {
+        this.commitInfo = commitInfo;
+    }
+
+    @Override
+    public String getName() {
+        return TermuxButtonModel.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("buttonName").value(getButtonName());
+        jsonWriter.name("exeCommand").value(getExeCommand());
+        jsonWriter.name("workDir").value(getWorkDir());
+
+        // JSON写入同步修改
+        jsonWriter.name("isCommitted").value(isCommitted());
+        jsonWriter.name("commitTitle").value(getCommitTitle());
+        jsonWriter.name("commitInfo").value(getCommitInfo());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) {
+            return true;
+        } else {
+            if (name.equals("buttonName")) {
+                setButtonName(jsonReader.nextString());
+            } else if (name.equals("exeCommand")) {
+                setExeCommand(jsonReader.nextString());
+            } else if (name.equals("workDir")) {
+                setWorkDir(jsonReader.nextString());
+            }
+            // JSON解析字段同步修改
+            else if (name.equals("isCommitted")) {
+                setCommitted(jsonReader.nextBoolean());
+            } else if (name.equals("commitTitle")) {
+                setCommitTitle(jsonReader.nextString());
+            } else if (name.equals("commitInfo")) {
+                setCommitInfo(jsonReader.nextString());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        jsonReader.endObject();
+        return this;
+    }
+
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/TestDemoBindServiceBean.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/TestDemoBindServiceBean.java
new file mode 100644
index 0000000..ab68051
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/TestDemoBindServiceBean.java
@@ -0,0 +1,67 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/07 12:47:22
+ * @Describe TestServiceBean
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class TestDemoBindServiceBean extends BaseBean {
+
+    public static final String TAG = "TestServiceBean";
+
+    boolean isEnable;
+
+    public TestDemoBindServiceBean() {
+        this.isEnable = false;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    @Override
+    public String getName() {
+        return TestDemoBindServiceBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("isEnable").value(isEnable());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("isEnable")) {
+                setIsEnable(jsonReader.nextBoolean());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/TestDemoServiceBean.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/TestDemoServiceBean.java
new file mode 100644
index 0000000..5899eca
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/TestDemoServiceBean.java
@@ -0,0 +1,68 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/07 12:49:21
+ * @Describe TestDemoServiceBean
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class TestDemoServiceBean extends BaseBean {
+
+    public static final String TAG = "TestDemoServiceBean";
+
+    boolean isEnable;
+
+    public TestDemoServiceBean() {
+        this.isEnable = false;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    @Override
+    public String getName() {
+        return TestDemoServiceBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("isEnable").value(isEnable());
+
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("isEnable")) {
+                setIsEnable(jsonReader.nextBoolean());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/UserInfoModel.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/UserInfoModel.java
new file mode 100644
index 0000000..52c4e4c
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/UserInfoModel.java
@@ -0,0 +1,92 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/04 19:14
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class UserInfoModel extends BaseBean {
+
+    public static final String TAG = "UserInfoModel";
+
+    String username;
+    String password;
+    String token;
+
+    public UserInfoModel() {
+        this.username = "";
+        this.password = "";
+        this.token = "";
+    }
+
+    public void setUsername(String username) {
+        this.username = username;
+    }
+
+    public String getUsername() {
+        return username;
+    }
+
+    public void setPassword(String password) {
+        this.password = password;
+    }
+
+    public String getPassword() {
+        return password;
+    }
+
+    public void setToken(String token) {
+        this.token = token;
+    }
+
+    public String getToken() {
+        return token;
+    }
+
+    @Override
+    public String getName() {
+        return UserInfoModel.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("username").value(getUsername());
+        jsonWriter.name("password").value(getPassword());
+        jsonWriter.name("token").value(getToken());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("username")) {
+                setUsername(jsonReader.nextString());
+            } else if (name.equals("password")) {
+                setPassword(jsonReader.nextString());
+            } else if (name.equals("token")) {
+                setToken(jsonReader.nextString());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/WinBoLLModel.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/WinBoLLModel.java
new file mode 100644
index 0000000..6b5d65d
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/WinBoLLModel.java
@@ -0,0 +1,92 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/05/10 10:16
+ * @Describe WinBoLLModel
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+import cc.winboll.studio.libappbase.APPModel;
+
+public class WinBoLLModel extends BaseBean {
+    
+    public static final String TAG = "WinBoLLModel";
+    
+    String appPackageName;
+    String appMainServiveName;
+
+    public WinBoLLModel() {
+        this.appPackageName = "";
+        this.appMainServiveName = "";
+    }
+
+    public WinBoLLModel(boolean isDebuging, String appPackageName, String appMainServiveName) {
+        this.appPackageName = appPackageName;
+        this.appMainServiveName = appMainServiveName;
+    }
+
+    public WinBoLLModel(String appPackageName, String appMainServiveName) {
+        this.appPackageName = appPackageName;
+        this.appMainServiveName = appMainServiveName;
+    }
+
+    public void setAppPackageName(String appPackageName) {
+        this.appPackageName = appPackageName;
+    }
+
+    public String getAppPackageName() {
+        return appPackageName;
+    }
+
+    public void setAppMainServiveName(String appMainServiveName) {
+        this.appMainServiveName = appMainServiveName;
+    }
+
+    public String getAppMainServiveName() {
+        return appMainServiveName;
+    }
+
+    @Override
+    public String getName() {
+        return APPModel.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("appPackageName").value(getAppPackageName());
+        jsonWriter.name("appMainServiveName").value(getAppMainServiveName());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("appPackageName")) {
+                setAppPackageName(jsonReader.nextString());
+            } else if (name.equals("appMainServiveName")) {
+                setAppMainServiveName(jsonReader.nextString());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
+    
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/models/WinBoLLNewsBean.java b/winboll/src/main/java/cc/winboll/studio/winboll/models/WinBoLLNewsBean.java
new file mode 100644
index 0000000..e749196
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/models/WinBoLLNewsBean.java
@@ -0,0 +1,71 @@
+package cc.winboll.studio.winboll.models;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/05/10 09:36
+ * @Describe WinBoLL 应用消息数据模型
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class WinBoLLNewsBean extends BaseBean {
+    
+    public static final String TAG = "WinBoLLNewsBean";
+    
+    String message;
+    
+    public WinBoLLNewsBean() {
+        this.message = "";
+    }
+
+    public WinBoLLNewsBean(String message) {
+        this.message = message;
+    }
+
+    public void setMessage(String message) {
+        this.message = message;
+    }
+
+    public String getMessage() {
+        return message;
+    }
+
+    @Override
+    public String getName() {
+        return WinBoLLNewsBean.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("message").value(getMessage());
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("message")) {
+                setMessage(jsonReader.nextString());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/receivers/APPNewsWidgetClickListener.java b/winboll/src/main/java/cc/winboll/studio/winboll/receivers/APPNewsWidgetClickListener.java
new file mode 100644
index 0000000..4e3681d
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/receivers/APPNewsWidgetClickListener.java
@@ -0,0 +1,36 @@
+package cc.winboll.studio.winboll.receivers;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/24 07:11:44
+ */
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.widgets.APPNewsWidget;
+
+public class APPNewsWidgetClickListener extends BroadcastReceiver {
+
+    public static final String TAG = "APPNewsWidgetClickListener";
+    public static final String ACTION_PRE = APPNewsWidgetClickListener.class.getName() + ".ACTION_PRE";
+    public static final String ACTION_NEXT = APPNewsWidgetClickListener.class.getName() + ".ACTION_NEXT";
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent.getAction();
+        if (action == null) {
+            LogUtils.d(TAG, String.format("action %s", action));
+            return;
+        }
+        if (action.equals(ACTION_PRE)) {
+            LogUtils.d(TAG, "ACTION_PRE");
+            APPNewsWidget.prePage(context);
+        } else if (action.equals(ACTION_NEXT)) {
+            LogUtils.d(TAG, "ACTION_NEXT");
+            APPNewsWidget.nextPage(context);
+        } else {
+            LogUtils.d(TAG, String.format("action %s", action));
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/receivers/MainReceiver.java b/winboll/src/main/java/cc/winboll/studio/winboll/receivers/MainReceiver.java
new file mode 100644
index 0000000..a0b9edb
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/receivers/MainReceiver.java
@@ -0,0 +1,117 @@
+package cc.winboll.studio.winboll.receivers;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/13 06:58:04
+ * @Describe 主要广播接收器
+ */
+import android.content.BroadcastReceiver;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.winboll.WinBoLL;
+import cc.winboll.studio.winboll.models.WinBoLLModel;
+import cc.winboll.studio.winboll.models.WinBoLLNewsBean;
+import cc.winboll.studio.winboll.services.MainService;
+import cc.winboll.studio.winboll.sos.SOS;
+import cc.winboll.studio.winboll.sos.SOSObject;
+import cc.winboll.studio.winboll.widgets.APPNewsWidget;
+import java.io.IOException;
+import java.lang.ref.WeakReference;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+public class MainReceiver extends BroadcastReceiver {
+
+    public static final String TAG = "MainReceiver";
+
+    public static final String ACTION_BOOT_COMPLETED = "android.intent.action.BOOT_COMPLETED";
+
+    WeakReference<MainService> mwrService;
+
+    public MainReceiver(MainService service) {
+        mwrService = new WeakReference<MainService>(service);
+    }
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String szAction = intent.getAction();
+        if (szAction.equals(ACTION_BOOT_COMPLETED)) {
+            ToastUtils.show("ACTION_BOOT_COMPLETED");
+        } else if (szAction.equals(IWinBoLLActivity.ACTION_BIND)) {
+            LogUtils.d(TAG, "ACTION_BIND");
+            LogUtils.d(TAG, String.format("context.getPackageName() %s", context.getPackageName()));
+            LogUtils.d(TAG, String.format("intent.getAction() %s", intent.getAction()));
+            String szWinBoLLModel = intent.getStringExtra(WinBoLL.EXTRA_WINBOLLMODEL);
+            LogUtils.d(TAG, String.format("szAPPModel %s", szWinBoLLModel));
+            if (szWinBoLLModel != null && !szWinBoLLModel.equals("")) {
+                try {
+                    WinBoLLModel bean = WinBoLLModel.parseStringToBean(szWinBoLLModel, WinBoLLModel.class);
+                    if (bean != null) {
+                        String szAppPackageName = bean.getAppPackageName();
+                        LogUtils.d(TAG, String.format("szAppPackageName %s", szAppPackageName));
+                        String szAppMainServiveName = bean.getAppMainServiveName();
+                        LogUtils.d(TAG, String.format("szAppMainServiveName %s", szAppMainServiveName));
+                        mwrService.get().bindWinBoLLModelConnection(bean);
+                    }
+                } catch (IOException e) {
+                    LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                }
+            }
+        } else if (intent.getAction().equals(SOS.ACTION_SOS)) {
+            LogUtils.d(TAG, "ACTION_SOS");
+//            String sos = intent.getStringExtra(SOS.EXTRA_OBJECT);
+//            LogUtils.d(TAG, String.format("SOS %s", sos));
+//            if (sos != null && !sos.equals("")) {
+//                SOSObject bean = SOS.parseSOSObject(sos);
+//                if (bean != null) {
+//                    String szObjectPackageName = bean.getObjectPackageName();
+//                    LogUtils.d(TAG, String.format("szObjectPackageName %s", szObjectPackageName));
+//                    String szObjectServiveName = bean.getObjectServiveName();
+//                    LogUtils.d(TAG, String.format("szObjectServiveName %s", szObjectServiveName));
+//
+//                    Intent intentService = new Intent();
+//                    intentService.setComponent(new ComponentName(szObjectPackageName, szObjectServiveName));
+//                    context.startService(intentService);
+//
+//                    String appName = AppUtils.getAppNameByPackageName(context, szObjectPackageName);
+//                    LogUtils.d(TAG, String.format("appName %s", appName));
+//                    WinBoLLNewsBean appWinBoLLNewsBean = new WinBoLLNewsBean(appName);
+//                    SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss");
+//                    String currentTime = sdf.format(new Date());
+//                    StringBuilder sbLine = new StringBuilder();
+//                    sbLine.append("[");
+//                    sbLine.append(currentTime);
+//                    sbLine.append("] Power to ");
+//                    sbLine.append(appName);
+//                    appWinBoLLNewsBean.setMessage(sbLine.toString());
+//
+//                    APPNewsWidget.addWinBoLLNewsBean(context, appWinBoLLNewsBean);
+//
+//                    Intent intentWidget = new Intent(context, APPNewsWidget.class);
+//                    intentWidget.setAction(APPNewsWidget.ACTION_RELOAD_REPORT);
+//                    context.sendBroadcast(intentWidget);
+//                }
+//
+//
+//            }
+        } else {
+            ToastUtils.show(szAction);
+        }
+    }
+
+    // 注册 Receiver
+    //
+    public void registerAction(MainService service) {
+        IntentFilter filter=new IntentFilter();
+        filter.addAction(ACTION_BOOT_COMPLETED);
+        filter.addAction(SOS.ACTION_SOS);
+        filter.addAction(WinBoLL.ACTION_BIND);
+        //filter.addAction(Intent.ACTION_BATTERY_CHANGED);
+        service.registerReceiver(this, filter);
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/receivers/MyBroadcastReceiver.java b/winboll/src/main/java/cc/winboll/studio/winboll/receivers/MyBroadcastReceiver.java
new file mode 100644
index 0000000..974ddfd
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/receivers/MyBroadcastReceiver.java
@@ -0,0 +1,29 @@
+package cc.winboll.studio.winboll.receivers;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/13 21:19:09
+ * @Describe MyBroadcastReceiver
+ */
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.R;
+
+public class MyBroadcastReceiver extends BroadcastReceiver {
+    
+    public static final String TAG = "MyBroadcastReceiver";
+    
+    @Override
+    public void onReceive(Context context, Intent intent) {
+//        if (context.getString(R.string.action_sos).equals(intent.getAction())) {
+//            String message = intent.getStringExtra("message");
+//            String sosPackage = intent.getStringExtra("sosPackage");
+//            
+//            // 处理接收到的广播消息
+//            LogUtils.d(TAG, String.format("MyBroadcastReceiver action %s \n%s\n%s", intent.getAction(), sosPackage, message));
+//        }
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/services/AssistantService.java b/winboll/src/main/java/cc/winboll/studio/winboll/services/AssistantService.java
new file mode 100644
index 0000000..2fd6076
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/services/AssistantService.java
@@ -0,0 +1,136 @@
+package cc.winboll.studio.winboll.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/14 03:38:31
+ * @Describe 守护进程服务
+ */
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+import android.os.Binder;
+import cc.winboll.studio.winboll.models.MainServiceBean;
+
+public class AssistantService extends Service {
+
+    public static final String TAG = "AssistantService";
+
+    MainServiceBean mMainServiceBean;
+    MyServiceConnection mMyServiceConnection;
+    MainService mMainService;
+    boolean isBound = false;
+    volatile boolean isThreadAlive = false;
+
+    public synchronized void setIsThreadAlive(boolean isThreadAlive) {
+        LogUtils.d(TAG, "setIsThreadAlive(...)");
+        LogUtils.d(TAG, String.format("isThreadAlive %s", isThreadAlive));
+        this.isThreadAlive = isThreadAlive;
+    }
+
+    public boolean isThreadAlive() {
+        return isThreadAlive;
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return new MyBinder();
+    }
+
+    @Override
+    public void onCreate() {
+        LogUtils.d(TAG, "onCreate");
+        super.onCreate();
+
+        //mMyBinder = new MyBinder();
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+        }
+        // 设置运行参数
+        setIsThreadAlive(false);
+        assistantService();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "call onStartCommand(...)");
+        assistantService();
+        return START_STICKY;
+    }
+
+    @Override
+    public void onDestroy() {
+        //LogUtils.d(TAG, "onDestroy");
+        setIsThreadAlive(false);
+        // 解除绑定
+        if (isBound) {
+            unbindService(mMyServiceConnection);
+            isBound = false;
+        }
+        super.onDestroy();
+    }
+
+    // 运行服务内容
+    //
+    void assistantService() {
+        LogUtils.d(TAG, "assistantService()");
+        mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        LogUtils.d(TAG, String.format("mMainServiceBean.isEnable() %s", mMainServiceBean.isEnable()));
+        if (mMainServiceBean.isEnable()) {
+            LogUtils.d(TAG, String.format("mIsThreadAlive %s", isThreadAlive()));
+            if (isThreadAlive() == false) {
+                // 设置运行状态
+                setIsThreadAlive(true);
+                // 唤醒和绑定主进程
+                wakeupAndBindMain();
+            }
+        }
+    }
+
+    // 唤醒和绑定主进程
+    //
+    void wakeupAndBindMain() {
+        LogUtils.d(TAG, "wakeupAndBindMain()");
+        // 绑定服务的Intent
+        Intent intent = new Intent(this, MainService.class);
+        startService(new Intent(this, MainService.class));
+        bindService(intent, mMyServiceConnection, Context.BIND_IMPORTANT);
+    
+//        startService(new Intent(this, MainService.class));
+//        bindService(new Intent(AssistantService.this, MainService.class), mMyServiceConnection, Context.BIND_IMPORTANT);
+    }
+
+    // 主进程与守护进程连接时需要用到此类
+    //
+    class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            LogUtils.d(TAG, "onServiceConnected(...)");
+            MainService.MyBinder binder = (MainService.MyBinder) service;
+            mMainService = binder.getService();
+            isBound = true;
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            LogUtils.d(TAG, "onServiceDisconnected(...)");
+            mMainServiceBean = MainServiceBean.loadBean(AssistantService.this, MainServiceBean.class);
+            if (mMainServiceBean.isEnable()) {
+                wakeupAndBindMain();
+            }
+            isBound = false;
+            mMainService = null;
+        }
+    }
+    
+    // 用于返回服务实例的Binder
+    public class MyBinder extends Binder {
+        AssistantService getService() {
+            LogUtils.d(TAG, "AssistantService MyBinder getService()");
+            return AssistantService.this;
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/services/MainService.java b/winboll/src/main/java/cc/winboll/studio/winboll/services/MainService.java
new file mode 100644
index 0000000..d287377
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/services/MainService.java
@@ -0,0 +1,316 @@
+package cc.winboll.studio.winboll.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/13 06:56:41
+ * @Describe 拨号主服务
+ * 参考:
+ * 进程保活-双进程守护的正确姿势
+ * https://blog.csdn.net/sinat_35159441/article/details/75267380
+ * Android Service之onStartCommand方法研究
+ * https://blog.csdn.net/cyp331203/article/details/38920491
+ */
+import android.app.Service;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.Binder;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.MyTileService;
+import cc.winboll.studio.winboll.handlers.MainServiceHandler;
+import cc.winboll.studio.winboll.models.MainServiceBean;
+import cc.winboll.studio.winboll.models.WinBoLLModel;
+import cc.winboll.studio.winboll.receivers.MainReceiver;
+import cc.winboll.studio.winboll.services.AssistantService;
+import cc.winboll.studio.winboll.threads.MainServiceThread;
+import cc.winboll.studio.winboll.widgets.APPNewsWidget;
+import java.util.ArrayList;
+
+public class MainService extends Service {
+
+    public static final String TAG = "MainService";
+
+    public static final int MSG_UPDATE_STATUS = 0;
+
+    static MainService _mControlCenterService;
+
+    volatile boolean isServiceRunning;
+
+    MainServiceBean mMainServiceBean;
+    MainServiceThread mMainServiceThread;
+    MainServiceHandler mMainServiceHandler;
+    MyServiceConnection mMyServiceConnection;
+    AssistantService mAssistantService;
+    boolean isBound = false;
+    MainReceiver mMainReceiver;
+    ArrayList<APPConnection> mAPPModelConnectionList;
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return new MyBinder();
+    }
+
+    public MainServiceThread getRemindThread() {
+        return mMainServiceThread;
+    }
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "onCreate()");
+        mAPPModelConnectionList = new ArrayList<APPConnection>();
+
+        _mControlCenterService = MainService.this;
+        isServiceRunning = false;
+        mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+
+        if (mMyServiceConnection == null) {
+            mMyServiceConnection = new MyServiceConnection();
+        }
+        mMainServiceHandler = new MainServiceHandler(this);
+
+        // 运行服务内容
+        mainService();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand(...)");
+        // 运行服务内容
+        mainService();
+        return (mMainServiceBean.isEnable()) ? START_STICKY : super.onStartCommand(intent, flags, startId);
+    }
+
+    // 运行服务内容
+    //
+    void mainService() {
+        LogUtils.d(TAG, "mainService()");
+        mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        if (mMainServiceBean.isEnable() && isServiceRunning == false) {
+            LogUtils.d(TAG, "mainService() start running");
+            isServiceRunning = true;
+            // 唤醒守护进程
+            wakeupAndBindAssistant();
+
+            if (mMainReceiver == null) {
+                // 注册广播接收器
+                mMainReceiver = new MainReceiver(this);
+                mMainReceiver.registerAction(this);
+            }
+
+            // 启动小部件
+            Intent intentTimeWidget = new Intent(this, APPNewsWidget.class);
+            intentTimeWidget.setAction(APPNewsWidget.ACTION_RELOAD_REPORT);
+            this.sendBroadcast(intentTimeWidget);
+
+            startMainServiceThread();
+
+            MyTileService.updateServiceIconStatus(this);
+
+            LogUtils.i(TAG, "Main Service Is Start.");
+        }
+    }
+
+    // 唤醒和绑定守护进程
+    //
+    void wakeupAndBindAssistant() {
+        LogUtils.d(TAG, "wakeupAndBindAssistant()");
+
+        Intent intent = new Intent(this, AssistantService.class);
+        startService(intent);
+        // 绑定服务的Intent
+        bindService(intent, mMyServiceConnection, Context.BIND_IMPORTANT);
+    }
+
+    // 开启提醒铃声线程
+    //
+    public void startMainServiceThread() {
+        LogUtils.d(TAG, "startMainServiceThread");
+        if (mMainServiceThread == null) {
+            mMainServiceThread = new MainServiceThread(this, mMainServiceHandler);
+            LogUtils.d(TAG, "new MainServiceThread");
+        } else {
+            if (mMainServiceThread.isExist() == true) {
+                mMainServiceThread = new MainServiceThread(this, mMainServiceHandler);
+                LogUtils.d(TAG, "renew MainServiceThread");
+            } else {
+                // 提醒进程正在进行中就更新状态后退出
+                LogUtils.d(TAG, "A mMainServiceThread running.");
+                return;
+            }
+        }
+        mMainServiceThread.start();
+    }
+
+    public void stopRemindThread() {
+        if (mMainServiceThread != null) {
+            mMainServiceThread.setIsExist(true);
+            mMainServiceThread = null;
+        }
+    }
+
+    @Override
+    public void onDestroy() {
+        //LogUtils.d(TAG, "onDestroy");
+        mMainServiceBean = MainServiceBean.loadBean(this, MainServiceBean.class);
+        if (mMainServiceBean.isEnable() == false) {
+            // 设置运行状态
+            isServiceRunning = false;// 解除绑定
+            if (isBound) {
+                unbindService(mMyServiceConnection);
+                isBound = false;
+            }
+            // 停止守护进程
+            Intent intent = new Intent(this, AssistantService.class);
+            stopService(intent);
+            // 停止Receiver
+            if (mMainReceiver != null) {
+                unregisterReceiver(mMainReceiver);
+                mMainReceiver = null;
+            }
+            // 停止前台通知栏
+            stopForeground(true);
+            // 停止消息提醒进程
+            stopRemindThread();
+
+            MyTileService.updateServiceIconStatus(this);
+
+            super.onDestroy();
+            //LogUtils.d(TAG, "onDestroy done");
+        }
+    }
+
+    public void bindWinBoLLModelConnection(WinBoLLModel bean) {
+        LogUtils.d(TAG, "bindAPPModelConnection(...)");
+        // 清理旧的绑定链接
+        for (int i = mAPPModelConnectionList.size() - 1; i > -1; i--) {
+            APPConnection item = mAPPModelConnectionList.get(i);
+            if (item.isBindToAPP(bean)) {
+                LogUtils.d(TAG, "Bind Servive exist.");
+                unbindService(item);
+                mAPPModelConnectionList.remove(i);
+            }
+        }
+
+        // 绑定服务
+        APPConnection appConnection = new APPConnection();
+        Intent intentService = new Intent();
+        intentService.setComponent(new ComponentName(bean.getAppPackageName(), bean.getAppMainServiveName()));
+        bindService(intentService, appConnection, Context.BIND_IMPORTANT);
+        mAPPModelConnectionList.add(appConnection);
+        
+        Intent intentWidget = new Intent(this, APPNewsWidget.class);
+        intentWidget.setAction(APPNewsWidget.ACTION_WAKEUP_SERVICE);
+        WinBoLLModel appSOSBean = new WinBoLLModel(bean.getAppPackageName(), bean.getAppMainServiveName());
+        intentWidget.putExtra("APPSOSBean", appSOSBean.toString());
+        sendBroadcast(intentWidget);
+    }
+
+    public class APPConnection implements ServiceConnection {
+
+        ComponentName mComponentName;
+
+        boolean isBindToAPP(WinBoLLModel bean) {
+            return mComponentName != null
+                && mComponentName.getClassName().equals(bean.getAppMainServiveName())
+                && mComponentName.getPackageName().equals(bean.getAppPackageName());
+        }
+
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            LogUtils.d(TAG, "onServiceConnected(...)");
+            mComponentName = name;
+            LogUtils.d(TAG, String.format("onServiceConnected : \ngetClassName %s\ngetPackageName %s", name.getClassName(), name.getPackageName()));
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            LogUtils.d(TAG, "onServiceDisconnected(...)");
+            LogUtils.d(TAG, String.format("onServiceDisconnected : \ngetClassName %s\ngetPackageName %s", name.getClassName(), name.getPackageName()));
+
+            // 尝试无参数启动一下服务
+            String appPackage = mComponentName.getPackageName();
+            LogUtils.d(TAG, String.format("appPackage %s", appPackage));
+            String appMainServiceClassName = mComponentName.getClassName();
+            LogUtils.d(TAG, String.format("appMainServiceClassName %s", appMainServiceClassName));
+
+            Intent intentService = new Intent();
+            intentService.setComponent(new ComponentName(appPackage, appMainServiceClassName));
+            startService(intentService);
+        }
+
+    }
+
+    // 主进程与守护进程连接时需要用到此类
+    //
+    private class MyServiceConnection implements ServiceConnection {
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder service) {
+            LogUtils.d(TAG, "onServiceConnected(...)");
+            AssistantService.MyBinder binder = (AssistantService.MyBinder) service;
+            mAssistantService = binder.getService();
+            isBound = true;
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            LogUtils.d(TAG, "onServiceDisconnected(...)");
+
+            if (mMainServiceBean.isEnable()) {
+                // 唤醒守护进程
+                wakeupAndBindAssistant();
+            }
+            isBound = false;
+            mAssistantService = null;
+        }
+
+    }
+
+
+    // 用于返回服务实例的Binder
+    public class MyBinder extends Binder {
+        MainService getService() {
+            LogUtils.d(TAG, "MainService MyBinder getService()");
+            return MainService.this;
+        }
+    }
+
+//    //
+//    // 启动服务
+//    //
+//    public static void startControlCenterService(Context context) {
+//        Intent intent = new Intent(context, MainService.class);
+//        context.startForegroundService(intent);
+//    }
+//
+//    //
+//    // 停止服务
+//    //
+//    public static void stopControlCenterService(Context context) {
+//        Intent intent = new Intent(context, MainService.class);
+//        context.stopService(intent);
+//    }
+
+    public void appenMessage(String message) {
+        LogUtils.d(TAG, String.format("Message : %s", message));
+    }
+
+    public static void stopMainService(Context context) {
+        LogUtils.d(TAG, "stopMainService");
+        MainServiceBean bean = new MainServiceBean();
+        bean.setIsEnable(false);
+        MainServiceBean.saveBean(context, bean);
+        context.stopService(new Intent(context, MainService.class));
+    }
+
+    public static void startMainService(Context context) {
+        LogUtils.d(TAG, "startMainService");
+        MainServiceBean bean = new MainServiceBean();
+        bean.setIsEnable(true);
+        MainServiceBean.saveBean(context, bean);
+        context.startService(new Intent(context, MainService.class));
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/services/TestDemoBindService.java b/winboll/src/main/java/cc/winboll/studio/winboll/services/TestDemoBindService.java
new file mode 100644
index 0000000..8896879
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/services/TestDemoBindService.java
@@ -0,0 +1,179 @@
+package cc.winboll.studio.winboll.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/07 12:45:49
+ * @Describe 启动时申请绑定到APPBase主服务的服务示例
+ */
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Binder;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.App;
+import cc.winboll.studio.winboll.WinBoLL;
+import cc.winboll.studio.winboll.models.TestDemoBindServiceBean;
+import cc.winboll.studio.winboll.services.TestDemoBindService;
+import cc.winboll.studio.winboll.sos.SOS;
+
+public class TestDemoBindService extends Service {
+
+    public static final String TAG = "TestDemoBindService";
+
+    public static final String ACTION_ENABLE = TestDemoBindService.class.getName() + ".ACTION_ENABLE";
+    public static final String ACTION_DISABLE = TestDemoBindService.class.getName() + ".ACTION_DISABLE";
+
+    volatile static TestThread _TestThread;
+
+    volatile static boolean _IsRunning;
+
+    public synchronized static void setIsRunning(boolean isRunning) {
+        _IsRunning = isRunning;
+    }
+
+    public static boolean isRunning() {
+        return _IsRunning;
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return new MyBinder();
+    }
+
+    public class MyBinder extends Binder {
+        public TestDemoBindService getService() {
+            return TestDemoBindService.this;
+        }
+    }
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "onCreate()");
+
+        run();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand(...)");
+        TestDemoBindServiceBean bean = TestDemoBindServiceBean.loadBean(this, TestDemoBindServiceBean.class);
+        if (bean == null) {
+            bean = new TestDemoBindServiceBean();
+        }
+
+        if (intent.getAction() != null) {
+            if (intent.getAction().equals(ACTION_ENABLE)) {
+                bean.setIsEnable(true);
+                LogUtils.d(TAG, "setIsEnable(true);");
+                TestDemoBindServiceBean.saveBean(this, bean);
+            } else if (intent.getAction().equals(ACTION_DISABLE)) {
+                bean.setIsEnable(false);
+                LogUtils.d(TAG, "setIsEnable(false);");
+                TestDemoBindServiceBean.saveBean(this, bean);
+            }
+        }
+
+        run();
+
+        return (bean.isEnable()) ? START_STICKY : super.onStartCommand(intent, flags, startId);
+        //return super.onStartCommand(intent, flags, startId);
+    }
+
+    void run() {
+        LogUtils.d(TAG, "run()");
+        TestDemoBindServiceBean bean = TestDemoBindServiceBean.loadBean(this, TestDemoBindServiceBean.class);
+        if (bean == null) {
+            bean = new TestDemoBindServiceBean();
+            TestDemoBindServiceBean.saveBean(this, bean);
+        }
+        if (bean.isEnable()) {
+            LogUtils.d(TAG, "run() bean.isEnable()");
+            TestThread.getInstance(this).start();
+            LogUtils.d(TAG, "_TestThread.start()");
+        }
+    }
+
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy()");
+        TestDemoBindServiceBean bean = TestDemoBindServiceBean.loadBean(this, TestDemoBindServiceBean.class);
+        if (bean == null) {
+            bean = new TestDemoBindServiceBean();
+        }
+
+        TestThread.getInstance(this).setIsExit(true);
+        
+        // 预防 APPBase 应用重启绑定失效。
+        // 所以退出时检查本服务是否配置启用，如果启用就发送一个 SOS 信号。
+        // 这样 APPBase 就会用组件方式启动本服务。
+        if (bean.isEnable()) {
+            if (App.isDebugging()) {
+                SOS.sosToAppBaseBeta(this, TestDemoBindService.class.getName());
+            } else {
+                SOS.sosToAppBase(this, TestDemoBindService.class.getName());
+            }
+        }
+
+        _IsRunning = false;
+    }
+
+    static class TestThread extends Thread {
+
+        volatile static TestThread _TestThread;
+        Context mContext;
+        volatile boolean isStarted = false;
+        volatile boolean isExit = false;
+
+        TestThread(Context context) {
+            super();
+            mContext = context;
+        }
+
+        public static synchronized TestThread getInstance(Context context) {
+            if (_TestThread != null) {
+                _TestThread.setIsExit(true);
+            }
+            _TestThread = new TestThread(context);
+
+            return _TestThread;
+        }
+
+        public synchronized void setIsExit(boolean isExit) {
+            this.isExit = isExit;
+        }
+
+        public boolean isExit() {
+            return isExit;
+        }
+
+        @Override
+        public void run() {
+            if (isStarted == false) {
+                isStarted = true;
+                super.run();
+                LogUtils.d(TAG, "run() start");
+                if (App.isDebugging()) {
+                    WinBoLL.bindToAPPBaseBeta(mContext, TestDemoBindService.class.getName());
+                } else {
+                    WinBoLL.bindToAPPBase(mContext, TestDemoBindService.class.getName());
+                }
+
+                while (!isExit()) {
+                    LogUtils.d(TAG, "run()");
+
+                    try {
+                        Thread.sleep(1000);
+                    } catch (InterruptedException e) {
+                        LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                    }
+                }
+
+                LogUtils.d(TAG, "run() exit");
+            }
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/services/TestDemoService.java b/winboll/src/main/java/cc/winboll/studio/winboll/services/TestDemoService.java
new file mode 100644
index 0000000..7364b9b
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/services/TestDemoService.java
@@ -0,0 +1,156 @@
+package cc.winboll.studio.winboll.services;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/07 12:39:24
+ * @Describe 普通服务示例
+ */
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Binder;
+import android.os.IBinder;
+import cc.winboll.studio.winboll.models.TestDemoServiceBean;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.models.TestDemoServiceBean;
+
+public class TestDemoService extends Service {
+
+    public static final String TAG = "TestDemoService";
+
+    public static final String ACTION_ENABLE = TestDemoService.class.getName() + ".ACTION_ENABLE";
+    public static final String ACTION_DISABLE = TestDemoService.class.getName() + ".ACTION_DISABLE";
+
+    volatile static TestThread _TestThread;
+
+    volatile static boolean _IsRunning;
+
+    public synchronized static void setIsRunning(boolean isRunning) {
+        _IsRunning = isRunning;
+    }
+
+    public static boolean isRunning() {
+        return _IsRunning;
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return new MyBinder();
+    }
+
+    public class MyBinder extends Binder {
+        public TestDemoService getService() {
+            return TestDemoService.this;
+        }
+    }
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "onCreate()");
+
+
+        run();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand(...)");
+        TestDemoServiceBean bean = TestDemoServiceBean.loadBean(this, TestDemoServiceBean.class);
+        if (bean == null) {
+            bean = new TestDemoServiceBean();
+        }
+
+        if (intent.getAction() != null) {
+            if (intent.getAction().equals(ACTION_ENABLE)) {
+                bean.setIsEnable(true);
+                LogUtils.d(TAG, "setIsEnable(true);");
+                TestDemoServiceBean.saveBean(this, bean);
+            } else if (intent.getAction().equals(ACTION_DISABLE)) {
+                bean.setIsEnable(false);
+                LogUtils.d(TAG, "setIsEnable(false);");
+                TestDemoServiceBean.saveBean(this, bean);
+            }
+        }
+
+        run();
+
+        return (bean.isEnable()) ? START_STICKY : super.onStartCommand(intent, flags, startId);
+        //return super.onStartCommand(intent, flags, startId);
+    }
+
+    void run() {
+        LogUtils.d(TAG, "run()");
+        TestDemoServiceBean bean = TestDemoServiceBean.loadBean(this, TestDemoServiceBean.class);
+        if (bean == null) {
+            bean = new TestDemoServiceBean();
+            TestDemoServiceBean.saveBean(this, bean);
+        }
+        if (bean.isEnable()) {
+            LogUtils.d(TAG, "run() bean.isEnable()");
+            TestThread.getInstance(this).start();
+            LogUtils.d(TAG, "_TestThread.start()");
+        }
+    }
+
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy()");
+        TestThread.getInstance(this).setIsExit(true);
+
+        _IsRunning = false;
+    }
+
+    static class TestThread extends Thread {
+
+        volatile static TestThread _TestThread;
+        Context mContext;
+        volatile boolean isStarted = false;
+        volatile boolean isExit = false;
+
+        TestThread(Context context) {
+            super();
+            mContext = context;
+        }
+
+        public static synchronized TestThread getInstance(Context context) {
+            if (_TestThread != null) {
+                _TestThread.setIsExit(true);
+            }
+            _TestThread = new TestThread(context);
+
+            return _TestThread;
+        }
+
+        public synchronized void setIsExit(boolean isExit) {
+            this.isExit = isExit;
+        }
+
+        public boolean isExit() {
+            return isExit;
+        }
+
+        @Override
+        public void run() {
+            if (isStarted == false) {
+                isStarted = true;
+                super.run();
+                LogUtils.d(TAG, "run() start");
+
+                while (!isExit()) {
+                    LogUtils.d(TAG, "run()");
+
+                    try {
+                        Thread.sleep(1000);
+                    } catch (InterruptedException e) {
+                        LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                    }
+                }
+
+                LogUtils.d(TAG, "run() exit");
+            }
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOS.java b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOS.java
new file mode 100644
index 0000000..c45d8eb
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOS.java
@@ -0,0 +1,59 @@
+package cc.winboll.studio.winboll.sos;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/02 09:36:29
+ * @Describe WinBoLL 应用 SOS 机理保护类
+ */
+import android.content.Context;
+import android.content.Intent;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.IOException;
+
+public class SOS {
+
+    public static final String TAG = "SOS";
+
+    public static final String ACTION_SOS = SOS.class.getName() + ".ACTION_SOS";
+    public static final String EXTRA_OBJECT = "EXTRA_OBJECT";
+
+    public static void sosToAppBase(Context context, String sosService) {
+        LogUtils.d(TAG, "sosToAppBase()");
+        String szToPackage = "cc.winboll.studio.appbase";
+        sos(context, szToPackage, sosService);
+
+    }
+
+    public static void sosToAppBaseBeta(Context context, String sosService) {
+        LogUtils.d(TAG, "sosToAppBaseBeta()");
+        String szToPackage = "cc.winboll.studio.appbase.beta";
+        sos(context, szToPackage, sosService);
+
+    }
+
+    static void sos(Context context, String szToPackage, String sosService) {
+        LogUtils.d(TAG, "sos(...)");
+        Intent intent = new Intent(ACTION_SOS);
+        intent.putExtra(EXTRA_OBJECT, genSOSObject(context.getPackageName(), sosService));
+        intent.setPackage(szToPackage);
+        LogUtils.d(TAG, String.format("ACTION_SOS :\nTo Package : %sSOS Service : %s\n", szToPackage, sosService));
+        context.sendBroadcast(intent);
+    }
+
+    public static SOSObject parseSOSObject(String szSOSObject) {
+        try {
+            return SOSObject.parseStringToBean(szSOSObject, SOSObject.class);
+        } catch (IOException e) {
+            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+        }
+        return null;
+    }
+
+    public static String sosObjectToString(SOSObject object) {
+        return object.toString();
+    }
+
+    public static String genSOSObject(String objectPackageName, String objectServiveName) {
+        return (new SOSObject(objectPackageName, objectServiveName)).toString();
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterService.java b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterService.java
new file mode 100644
index 0000000..039d8e6
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterService.java
@@ -0,0 +1,182 @@
+package cc.winboll.studio.winboll.sos;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/27 14:00:21
+ * @Describe Simple Operate Signal Service Center.
+ *           简单操作信号服务中心
+ */
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.IBinder;
+import android.os.IInterface;
+import android.os.Parcel;
+import android.os.RemoteException;
+import java.io.FileDescriptor;
+import android.app.Service;
+import android.content.Intent;
+import android.os.IBinder;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class SOSCenterService extends Service {
+
+    public static final String TAG = "SOSCenterService";
+    
+    private final IBinder binder =(IBinder)new SOSBinder();
+
+    SOSCenterServiceModel mSOSCenterServiceModel;
+    static MainThread _MainThread;
+    public static synchronized MainThread getMainThreadInstance() {
+        if (_MainThread == null) {
+            _MainThread = new MainThread();
+        }
+        return _MainThread;
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return binder;
+    }
+
+    public class SOSBinder implements IBinder {
+
+        @Override
+        public void dump(FileDescriptor fileDescriptor, String[] string) throws RemoteException {
+        }
+
+        @Override
+        public void dumpAsync(FileDescriptor fileDescriptor, String[] string) throws RemoteException {
+        }
+
+        @Override
+        public String getInterfaceDescriptor() throws RemoteException {
+            return null;
+        }
+
+        @Override
+        public boolean isBinderAlive() {
+            return false;
+        }
+
+        @Override
+        public void linkToDeath(IBinder.DeathRecipient deathRecipient, int p) throws RemoteException {
+        }
+
+        @Override
+        public boolean pingBinder() {
+            return false;
+        }
+
+        @Override
+        public IInterface queryLocalInterface(String string) {
+            return null;
+        }
+
+        @Override
+        public boolean transact(int p, Parcel parcel, Parcel parcel1, int p1) throws RemoteException {
+            return false;
+        }
+
+        @Override
+        public boolean unlinkToDeath(IBinder.DeathRecipient deathRecipient, int p) {
+            return false;
+        }
+
+        public static final String TAG = "SOSBinder";
+        SOSCenterService getService() {
+            return SOSCenterService.this;
+        }
+    }
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LogUtils.d(TAG, "onCreate");
+        mSOSCenterServiceModel = SOSCenterServiceModel.loadBean(this, SOSCenterServiceModel.class);
+        if(mSOSCenterServiceModel == null) {
+            mSOSCenterServiceModel = new SOSCenterServiceModel();
+            SOSCenterServiceModel.saveBean(this, mSOSCenterServiceModel);
+        }
+        runMainThread();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        LogUtils.d(TAG, "onStartCommand");
+
+        runMainThread();
+
+        return mSOSCenterServiceModel.isEnable() ? Service.START_STICKY: super.onStartCommand(intent, flags, startId);
+    }
+
+    void runMainThread() {
+        mSOSCenterServiceModel = mSOSCenterServiceModel.loadBean(this, SOSCenterServiceModel.class);
+        if (mSOSCenterServiceModel.isEnable()
+            && _MainThread == null) {
+            getMainThreadInstance().start();
+        }
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy");
+        mSOSCenterServiceModel = SOSCenterServiceModel.loadBean(this, SOSCenterServiceModel.class);
+        if (mSOSCenterServiceModel.isEnable()) {
+            LogUtils.d(TAG, "mSOSCenterServiceModel.isEnable()");
+//            ISOSAPP iSOSAPP = (ISOSAPP)getApplication();
+//            iSOSAPP.helpISOSService(getISOSServiceIntentWhichAskForHelp());
+        } 
+        if (_MainThread != null) {
+            _MainThread.isExist = true;
+            _MainThread = null;
+        }
+    }
+
+    public static void stopISOSService(Context context) {
+        LogUtils.d(TAG, "stopISOSService");
+        SOSCenterServiceModel bean = new SOSCenterServiceModel();
+        bean.setIsEnable(false);
+        SOSCenterServiceModel.saveBean(context, bean);
+        context.stopService(new Intent(context, SOSCenterServiceModel.class));
+    }
+
+    public static void startISOSService(Context context) {
+        LogUtils.d(TAG, "startISOSService");
+        SOSCenterServiceModel bean = new SOSCenterServiceModel();
+        bean.setIsEnable(true);
+        SOSCenterServiceModel.saveBean(context, bean);
+        context.startService(new Intent(context, SOSCenterServiceModel.class));
+    }
+
+    public String getMessage() {
+        return "Hello from SOSCenterServiceModel";
+    }
+
+    static class MainThread extends Thread {
+        volatile boolean isExist = false;
+
+        public void setIsExist(boolean isExist) {
+            this.isExist = isExist;
+        }
+
+        public boolean isExist() {
+            return isExist;
+        }
+
+        @Override
+        public void run() {
+            super.run();
+            while (!isExist) {
+                LogUtils.d(TAG, "run");
+                try {
+                    sleep(1000);
+                } catch (InterruptedException e) {
+                    LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                }
+            }
+        }
+
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterServiceModel.java b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterServiceModel.java
new file mode 100644
index 0000000..3f226ae
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterServiceModel.java
@@ -0,0 +1,69 @@
+package cc.winboll.studio.winboll.sos;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/03/02 09:49:45
+ * @Describe SOSCenterServiceModel
+ *           Simple Operate Signal Service Model.
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class SOSCenterServiceModel extends BaseBean {
+
+    public static final String TAG = "SOSCenterServiceModel";
+
+    boolean isEnable;
+
+    public SOSCenterServiceModel() {
+        this.isEnable = false;
+    }
+
+    public void setIsEnable(boolean isEnable) {
+        this.isEnable = isEnable;
+    }
+
+    public boolean isEnable() {
+        return isEnable;
+    }
+
+    @Override
+    public String getName() {
+        return SOSCenterServiceModel.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("isEnable").value(isEnable());
+
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("isEnable")) {
+                setIsEnable(jsonReader.nextBoolean());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterServiceReceiver.java b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterServiceReceiver.java
new file mode 100644
index 0000000..14dd36a
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSCenterServiceReceiver.java
@@ -0,0 +1,29 @@
+package cc.winboll.studio.winboll.sos;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/27 14:04:35
+ * @Describe SOSCenterServiceReceiver
+ */
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import cc.winboll.studio.libappbase.LogUtils;
+
+public class SOSCenterServiceReceiver extends BroadcastReceiver {
+
+    public static final String TAG = "SOSCenterServiceReceiver";
+
+    public static final String ACTION_SOS = SOSCenterServiceReceiver.class.getName() + ".ACTION_SOS";
+    
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent.getAction();
+        if (action.equals(ACTION_SOS)) {
+            // 处理接收到的广播消息
+            LogUtils.d(TAG, String.format("Action %s \n%s\n%s", action));
+        } else {
+            LogUtils.d(TAG, String.format("%s", action));
+        }
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSObject.java b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSObject.java
new file mode 100644
index 0000000..ec07b38
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/sos/SOSObject.java
@@ -0,0 +1,86 @@
+package cc.winboll.studio.winboll.sos;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/27 14:12:05
+ * @Describe SOSBean
+ */
+import android.util.JsonReader;
+import android.util.JsonWriter;
+import cc.winboll.studio.libappbase.BaseBean;
+import java.io.IOException;
+
+public class SOSObject extends BaseBean {
+
+    public static final String TAG = "SOSObject";
+
+    String objectPackageName;
+    String objectServiveName;
+
+    public SOSObject() {
+        this.objectPackageName = "";
+        this.objectServiveName = "";
+    }
+
+    public SOSObject(String objectPackageName, String objectServiveName) {
+        this.objectPackageName = objectPackageName;
+        this.objectServiveName = objectServiveName;
+    }
+
+    public void setObjectPackageName(String objectPackageName) {
+        this.objectPackageName = objectPackageName;
+    }
+
+    public String getObjectPackageName() {
+        return objectPackageName;
+    }
+
+    public void setObjectServiveName(String objectServiveName) {
+        this.objectServiveName = objectServiveName;
+    }
+
+    public String getObjectServiveName() {
+        return objectServiveName;
+    }
+
+    @Override
+    public String getName() {
+        return SOSObject.class.getName();
+    }
+
+    @Override
+    public void writeThisToJsonWriter(JsonWriter jsonWriter) throws IOException {
+        super.writeThisToJsonWriter(jsonWriter);
+        jsonWriter.name("objectPackageName").value(getObjectPackageName());
+        jsonWriter.name("objectServiveName").value(getObjectServiveName());
+
+    }
+
+    @Override
+    public boolean initObjectsFromJsonReader(JsonReader jsonReader, String name) throws IOException {
+        if (super.initObjectsFromJsonReader(jsonReader, name)) { return true; } else {
+            if (name.equals("objectPackageName")) {
+                setObjectPackageName(jsonReader.nextString());
+            } else if (name.equals("objectServiveName")) {
+                setObjectServiveName(jsonReader.nextString());
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public BaseBean readBeanFromJsonReader(JsonReader jsonReader) throws IOException {
+        jsonReader.beginObject();
+        while (jsonReader.hasNext()) {
+            String name = jsonReader.nextName();
+            if (!initObjectsFromJsonReader(jsonReader, name)) {
+                jsonReader.skipValue();
+            }
+        }
+        // 结束 JSON 对象
+        jsonReader.endObject();
+        return this;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/termux/NfcTermuxBridgeActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/termux/NfcTermuxBridgeActivity.java
new file mode 100644
index 0000000..38544f6
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/termux/NfcTermuxBridgeActivity.java
@@ -0,0 +1,241 @@
+/*
+ * 源码说明与描述：
+ * NFC 与 Termux 桥接活动，用于接收外部应用（包调用）传递的 JSON 指令并执行 Termux 脚本命令。
+ * 支持 ACTION_BUILD（后台执行）与 ACTION_BUILD_VIEW（终端窗口唤起）两种动作。
+ *
+ * 作者：豆包&ZhanGSKen<zhangsken@qq.com>
+ * 创建时间：2025-03-15 14:00:00
+ * 最后编辑时间：2026-03-16 10:00:00
+ */
+package cc.winboll.studio.winboll.termux;
+
+import android.app.Activity;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.winboll.models.NfcTermuxCmd;
+import com.google.gson.Gson;
+
+public class NfcTermuxBridgeActivity extends Activity {
+
+    // ========================= 常量与静态属性 =========================
+    public static final String TAG = "NfcTermuxBridgeActivity";
+
+    // 外部应用调用时使用的 Action 常量
+    public static final String ACTION_BUILD = "cc.winboll.studio.winboll.termux.NfcTermuxBridgeActivity.ACTION_BUILD";
+
+    private static final Gson GSON = new Gson();
+
+    // ========================= 生命周期方法 =========================
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate() 调用，savedInstanceState: " + (savedInstanceState != null ? "非空" : "空"));
+        dispatchIntent(getIntent());
+    }
+
+    @Override
+    protected void onNewIntent(Intent intent) {
+        super.onNewIntent(intent);
+        LogUtils.d(TAG, "onNewIntent() 调用，intent: " + (intent != null ? intent.toString() : "null"));
+        if (intent != null) {
+            LogUtils.d(TAG, "onNewIntent() action: " + intent.getAction());
+            LogUtils.d(TAG, "onNewIntent() data: " + intent.getDataString());
+            LogUtils.d(TAG, "onNewIntent() extras: " + intent.getExtras());
+            LogUtils.d(TAG, "onNewIntent() flags: " + intent.getFlags());
+            LogUtils.d(TAG, "onNewIntent() component: " + intent.getComponent());
+        } else {
+            LogUtils.w(TAG, "onNewIntent() intent is null");
+        }
+        dispatchIntent(intent);
+    }
+
+    // ========================= 统一 Intent 分发（合并去重） =========================
+    /**
+     * 统一分发 Intent，根据 Action 路由到不同业务逻辑
+     * @param intent 外部传入的 Intent
+     */
+    private void dispatchIntent(Intent intent) {
+        LogUtils.d(TAG, "dispatchIntent() 分发 intent");
+        if (intent == null) {
+            LogUtils.w(TAG, "dispatchIntent() intent is null");
+            return;
+        }
+
+        String action = intent.getAction();
+        if (ACTION_BUILD.equals(action)) {
+			ToastUtils.show("ACTION_BUILD 命中");
+            onOpenTermuxProjectBuild(intent);
+        } else {
+            LogUtils.w(TAG, "dispatchIntent() 未知 Action: " + action);
+            finish();
+        }
+    }
+
+    // ========================= 核心业务方法 =========================
+    /**
+     * 处理 ACTION_BUILD 动作：后台执行 NFC 指令
+     */
+//    private void handleNfcIntent(Intent intent) {
+//        LogUtils.d(TAG, "handleNfcIntent() 调用");
+//        if (intent == null) {
+//            LogUtils.w(TAG, "handleNfcIntent() intent 为空");
+//            return;
+//        }
+//
+//        try {
+//            String json = intent.getStringExtra(Intent.EXTRA_TEXT);
+//            LogUtils.d(TAG, "handleNfcIntent() json: " + json);
+//
+//            if (json == null || json.isEmpty()) {
+//                LogUtils.e(TAG, "handleNfcIntent() 指令为空");
+//                showToast("指令为空");
+//                finish();
+//                return;
+//            }
+//
+//            NfcTermuxCmd cmd = GSON.fromJson(json, NfcTermuxCmd.class);
+//            LogUtils.d(TAG, "handleNfcIntent() cmd: " + cmd);
+//
+//            if (cmd.script == null || cmd.script.isEmpty()) {
+//                LogUtils.e(TAG, "handleNfcIntent() script 为空");
+//                showToast("script 不能为空");
+//                finish();
+//                return;
+//            }
+//
+//            //String scriptPath = "/data/data/com.termux/files/home/TermuxWorkSpaces/BashShells/AutoNFC/" + cmd.script;
+//            String scriptPath = "/data/data/com.termux/files/home/TermuxWorkSpaces/BashShells/AutoNFC/" + "BuildWinBoLLProject.sh";
+//            LogUtils.d(TAG, "handleNfcIntent() 脚本路径: " + scriptPath);
+//
+//            boolean success = TermuxCommandExecutor.executeCommand(
+//                this, scriptPath, cmd.args, cmd.workDir, cmd.background, cmd.resultDir
+//            );
+//            LogUtils.d(TAG, "handleNfcIntent() 执行结果: " + success);
+//
+//            if (success) {
+//                showToast("指令已发送: " + cmd.script);
+//                LogUtils.i(TAG, "执行成功: " + scriptPath);
+//            } else {
+//                showToast("指令发送失败");
+//                LogUtils.e(TAG, "执行失败");
+//            }
+//
+//        } catch (Exception e) {
+//            LogUtils.e(TAG, "handleNfcIntent() 异常: " + e.getMessage(), e);
+//            showToast("解析失败");
+//        } finally {
+//            finish();
+//        }
+//    }
+
+    /**
+     * 处理 ACTION_BUILD_VIEW 动作：唤起 Termux 窗口执行命令
+     */
+    public void onOpenTermuxProjectBuild(Intent intent) {
+        LogUtils.d(TAG, "onOpenTermuxProjectBuildView() 调用");
+        if (intent == null) {
+            LogUtils.w(TAG, "onOpenTermuxProjectBuildView() intent 为空");
+            return;
+        }
+
+        try {
+            String json = intent.getStringExtra(Intent.EXTRA_TEXT);
+            LogUtils.d(TAG, "onOpenTermuxProjectBuildView() json: " + json);
+
+            if (json == null || json.isEmpty()) {
+                LogUtils.e(TAG, "onOpenTermuxProjectBuildView() 指令为空");
+                showToast("指令为空");
+                finish();
+                return;
+            }
+
+            NfcTermuxCmd cmd = GSON.fromJson(json, NfcTermuxCmd.class);
+            LogUtils.d(TAG, "onOpenTermuxProjectBuildView() cmd: " + cmd);
+
+            if (cmd.script == null || cmd.script.isEmpty()) {
+                LogUtils.e(TAG, "onOpenTermuxProjectBuildView() script 为空");
+                showToast("script 不能为空");
+                finish();
+                return;
+            }
+
+            StringBuilder targetCmd = new StringBuilder();
+            String nfcScriptFolder = "/data/data/com.termux/files/home/TermuxWorkSpaces/BashShells/AutoNFC/";
+            targetCmd.append("cd " + nfcScriptFolder + " && ");
+            //targetCmd.append("stdbuf -o0 -e0 -i0 bash ").append(cmd.script).append(" ");
+            targetCmd.append("stdbuf -o0 -e0 -i0 bash ").append("BuildWinBoLLProject.sh").append(" ");
+            if (cmd.args != null) {
+                for (String arg : cmd.args) {
+                    targetCmd.append(arg).append(" ");
+                }
+            }
+
+            LogUtils.d(TAG, "onOpenTermuxProjectBuildView() 命令: " + targetCmd);
+            boolean cmdSuccess = TermuxCommandExecutor.executeTerminalCommand(this, targetCmd.toString());
+            LogUtils.d(TAG, "onOpenTermuxProjectBuildView() 执行结果: " + cmdSuccess);
+
+            if (cmdSuccess) {
+                showToast("指令已发送: " + cmd.script);
+            } else {
+                showToast("指令发送失败");
+            }
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "onOpenTermuxProjectBuildView() 异常: " + e.getMessage(), e);
+            showToast("解析失败");
+        } finally {
+            finish();
+        }
+    }
+
+    // ========================= 公共静态测试方法 =========================
+    /**
+     * 内部测试方法：发送 ACTION_BUILD 指令
+     */
+    public static void testCommand(Context context) {
+        LogUtils.d(TAG, "testCommand()");
+        try {
+            String testJson = "{\"script\":\"BuildWinBoLLProject.sh\",\"args\":[\"DebugTemp\"],\"workDir\":null,\"background\":true,\"resultDir\":null}";
+            Intent intent = new Intent(context, NfcTermuxBridgeActivity.class);
+            intent.setAction(ACTION_BUILD); // 指定 Action
+            intent.putExtra(Intent.EXTRA_TEXT, testJson);
+            context.startActivity(intent);
+        } catch (Exception e) {
+            LogUtils.e(TAG, "testCommand() 失败: " + e.getMessage());
+        }
+    }
+
+    /**
+     * 内部测试方法：发送 ACTION_BUILD_VIEW 指令
+     */
+//    public static void testViewCommand(Context context) {
+//        LogUtils.d(TAG, "testViewCommand()");
+//        try {
+//            String testJson = "{\"script\":\"BuildWinBoLLProjectView.sh\",\"args\":[\"DebugTemp\"],\"workDir\":null,\"background\":true,\"resultDir\":null}";
+//            Intent intent = new Intent(context, NfcTermuxBridgeActivity.class);
+//            intent.setAction(ACTION_BUILD_VIEW); // 指定 Action
+//            intent.putExtra(Intent.EXTRA_TEXT, testJson);
+//            context.startActivity(intent);
+//        } catch (Exception e) {
+//            LogUtils.e(TAG, "testViewCommand() 失败: " + e.getMessage());
+//        }
+//    }
+
+    // ========================= 工具方法 =========================
+    /**
+     * 统一显示 Toast，确保在主线程调用
+     */
+    private void showToast(final String message) {
+        runOnUiThread(new Runnable() {
+				@Override
+				public void run() {
+					Toast.makeText(NfcTermuxBridgeActivity.this, message, Toast.LENGTH_SHORT).show();
+				}
+			});
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/termux/TermuxCommandExecutor.java b/winboll/src/main/java/cc/winboll/studio/winboll/termux/TermuxCommandExecutor.java
new file mode 100644
index 0000000..5410ec2
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/termux/TermuxCommandExecutor.java
@@ -0,0 +1,222 @@
+package cc.winboll.studio.winboll.termux;
+
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Build;
+import cc.winboll.studio.libappbase.LogUtils; // 替换 Log 为 LogUtils（与 Activity 一致）
+import com.termux.shared.termux.TermuxConstants;
+import com.termux.shared.shell.command.ExecutionCommand.Runner;
+
+/**
+ * Termux 命令调用工具类（基于 RunCommandService 原型封装）
+ * 用于向 Termux 发送命令执行请求，兼容 Termux RUN_COMMAND Intent 规范
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/19 16:30:00
+ * @LastEditTime 2026/01/20 10:15:00
+ */
+public class TermuxCommandExecutor {
+    private static final String TAG = "TermuxCommandExecutor";
+    // 核心修复：Termux 官方包名（无 .app 后缀）
+    private static final String TERMUX_PACKAGE_NAME = "com.termux";
+    // Termux RunCommandService 完整类名（包名+类名）
+    private static final String TERMUX_RUN_CMD_SERVICE_CLASS = "com.termux.app.RunCommandService";
+    private static final String TERMUX_RUN_CMD_ACTION = TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.ACTION_RUN_COMMAND;
+	private static final String TERMUX_HOME_PATH = "/data/data/com.termux/files/home";
+
+    /**
+     * 执行 Termux 命令（核心方法）
+     * @param context 上下文（如 Activity、Service）
+     * @param command 要执行的命令路径（如 "/bin/ls"、"/data/data/com.termux/files/usr/bin/bash"）
+     * @param args 命令参数（如 ["-l", "/data/data/com.termux/files/home"]）
+     * @param workDir 工作目录（可为 null，默认 Termux 主目录）
+     * @param isBackground 是否后台执行（true=后台，false=终端会话执行）
+     * @param resultDir 命令结果输出目录（可为 null，不输出到文件）
+     * @return 是否成功发送命令请求
+     */
+    public static boolean executeCommand(Context context, String command, String[] args, String workDir, boolean isBackground, String resultDir) {
+        // 1. 校验上下文和命令合法性
+        if (context == null || command == null || command.isEmpty()) {
+            LogUtils.e(TAG, "执行命令失败：上下文或命令为空");
+            return false;
+        }
+
+        // 2. 校验 Termux 是否安装（新增：提前校验，避免白跑流程）
+        if (!isTermuxInstalled(context)) {
+            LogUtils.e(TAG, "执行命令失败：Termux 未安装");
+            return false;
+        }
+
+        // 3. 创建 Intent 并设置目标 Service
+        Intent intent = new Intent(TERMUX_RUN_CMD_ACTION);
+        intent.setClassName(TERMUX_PACKAGE_NAME, TERMUX_RUN_CMD_SERVICE_CLASS); // 用正确包名
+        intent.setPackage(TERMUX_PACKAGE_NAME); // 明确包名，避免歧义
+
+        // 4. 设置核心命令参数（遵循 Termux RunCommandService 规范）
+        intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_COMMAND_PATH, command);
+        if (args != null && args.length > 0) {
+            intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_ARGUMENTS, args);
+            LogUtils.d(TAG, "命令参数：" + String.join(",", args));
+        }
+        if (workDir != null && !workDir.isEmpty()) {
+            intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_WORKDIR, workDir);
+            LogUtils.d(TAG, "工作目录：" + workDir);
+        }
+
+        // 5. 设置执行模式（后台/终端会话）
+        intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_BACKGROUND, isBackground);
+        String runner = isBackground ? Runner.APP_SHELL.getName() : Runner.TERMINAL_SESSION.getName();
+        intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_RUNNER, runner);
+        LogUtils.d(TAG, "执行模式：" + (isBackground ? "后台" : "终端会话") + "，Runner：" + runner);
+
+        // 6. 设置命令结果输出（可选，输出到文件）
+        if (resultDir != null && !resultDir.isEmpty()) {
+            intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_RESULT_DIRECTORY, resultDir);
+            intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_RESULT_SINGLE_FILE, true);
+            intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_RESULT_FILE_BASENAME, "authcenter_cmd_result");
+            LogUtils.d(TAG, "结果输出目录：" + resultDir);
+        }
+
+        // 7. 允许替换参数中的逗号替代字符
+        intent.putExtra(TermuxConstants.TERMUX_APP.RUN_COMMAND_SERVICE.EXTRA_REPLACE_COMMA_ALTERNATIVE_CHARS_IN_ARGUMENTS, true);
+
+        // 8. 发送请求（区分 Android O 及以上的前台服务）
+        try {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+                context.startForegroundService(intent);
+                LogUtils.d(TAG, "Android O+ 启动前台服务发送命令");
+            } else {
+                context.startService(intent);
+                LogUtils.d(TAG, "启动普通服务发送命令");
+            }
+            LogUtils.i(TAG, "命令发送成功：command=" + command);
+            return true;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "命令发送失败：" + e.getMessage(), e);
+            return false;
+        }
+    }
+
+    /**
+     * 简化方法：执行 Termux 终端命令（默认工作目录，终端会话执行）
+     * @param context 上下文
+     * @param command 命令（如 "ls -l /home"、"echo 'hello termux'"）
+     * @return 是否成功发送
+     */
+    public static boolean executeTerminalCommand(Context context, String command) {
+        LogUtils.d(TAG, "调用 executeTerminalCommand，命令：" + command);
+        if (command == null || command.isEmpty()) {
+            LogUtils.e(TAG, "命令为空，执行失败");
+            return false;
+        }
+        // 通过 bash 执行任意终端命令
+        String[] args = {"-c", command};
+        return executeCommand(
+            context,
+            "/data/data/com.termux/files/usr/bin/bash", // Termux 默认 bash 路径（正确）
+            args,
+            TERMUX_HOME_PATH, // 默认工作目录
+            false, // 终端会话执行（可见）
+            null // 不输出到文件
+        );
+    }
+
+    /**
+     * 简化方法：后台执行 Termux 命令（无输出文件）
+     * @param context 上下文
+     * @param command 命令路径
+     * @param args 命令参数
+     * @return 是否成功发送
+     */
+    public static boolean executeBackgroundCommand(Context context, String command, String[] args) {
+        LogUtils.d(TAG, "调用 executeBackgroundCommand，command=" + command);
+        return executeCommand(
+            context,
+            command,
+            args,
+            null,
+            true, // 后台执行
+            null
+        );
+    }
+
+    /**
+     * 校验 Termux 是否安装（修复核心错误）
+     * @param context 上下文
+     * @return Termux 是否已安装
+     */
+    public static boolean isTermuxInstalled(Context context) {
+        LogUtils.d(TAG, "校验 Termux 是否安装，包名：" + TERMUX_PACKAGE_NAME);
+        if (context == null) {
+            LogUtils.e(TAG, "校验失败：上下文为空");
+            return false;
+        }
+        try {
+            // 用正确的 Termux 包名查询（com.termux）
+            context.getPackageManager().getPackageInfo(TERMUX_PACKAGE_NAME, PackageManager.GET_ACTIVITIES);
+            LogUtils.d(TAG, "Termux 已安装");
+            return true;
+        } catch (PackageManager.NameNotFoundException e) {
+            LogUtils.w(TAG, "Termux 未安装：" + e.getMessage());
+            return false;
+        } catch (Exception e) {
+            LogUtils.e(TAG, "校验 Termux 安装状态异常：" + e.getMessage(), e);
+            return false;
+        }
+    }
+
+    /**
+     * 校验 Termux 是否允许外部应用调用
+     * @return 校验提示信息
+     */
+    public static String checkTermuxExternalAppPermission() {
+        String tip = "请确保 Termux 已开启「允许外部应用调用」权限：\n1. 打开 Termux 输入：termux-setup-storage\n2. 编辑配置文件：echo \"allow-external-apps = true\" > ~/.termux/termux.properties\n3. 重启 Termux 生效";
+        LogUtils.d(TAG, "外部应用调用权限提示：" + tip);
+        return tip;
+    }
+
+	public static boolean openTermuxBash(Context context, String command) {
+		return openTermuxBash(context, command, "~");
+	}
+
+	public static boolean openTermuxBash(Context context, String command, String workDir) {
+        LogUtils.d(TAG, "openTermuxBash() 按钮点击，执行Gradle命令（实时输出）");
+
+        // 1. 校验Termux是否安装
+        if (!TermuxCommandExecutor.isTermuxInstalled(context)) {
+            LogUtils.e(TAG, "openTermuxBash() 错误：未安装Termux应用");
+            return false;
+        }
+
+        // 2. 定义核心路径（确保路径与Termux中一致）
+		String projectPath = TERMUX_HOME_PATH;
+		if (workDir.startsWith("~") || workDir.startsWith(".")) {
+			projectPath = TERMUX_HOME_PATH + "/" + workDir.substring(1);
+		}
+
+        // 3. 构造命令（核心：用stdbuf禁用缓冲，实现实时输出）
+        String targetCmd = "";
+        // 步骤1：进入项目目录（不存在则创建）
+        targetCmd += "cd " + projectPath + " && ";
+        // 步骤2：加载环境变量
+        targetCmd += "source ~/.bashrc && ";
+        // 步骤3：显式配置PATH
+        targetCmd += "export PATH=/data/data/com.termux/files/usr/bin:$PATH && ";
+        // 步骤4：用stdbuf禁用stdout/stderr缓冲（关键！），执行Gradle命令
+        // -o0：stdout无缓冲；-e0：stderr无缓冲；-i0：stdin无缓冲
+        //targetCmd += "stdbuf -o0 -e0 -i0 " + gradleFullPath + " task --all | grep assemble && ";
+        //targetCmd += "stdbuf -o0 -e0 -i0 " + gradleFullPath + " -Pandroid.aapt2FromMavenOverride=/data/data/com.termux/files/home/android-sdk/build-tools/34.0.4/aapt2 assembleBetaDebug && ";
+        targetCmd += "stdbuf -o0 -e0 -i0 bash && ";
+        // 步骤5：执行成功提示
+        targetCmd += "echo '\n✅ 命令执行完成！' && echo '\n📌 当前目录：" + projectPath + "' && read -p '按回车键关闭终端...'";
+
+
+        // 4. 执行命令（终端会话模式，唤起Termux窗口）
+        boolean cmdSuccess = TermuxCommandExecutor.executeTerminalCommand(context, targetCmd);
+        if (!cmdSuccess) {
+            return true;
+        }
+		return false;
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/theme/WinBoLLThemeBean.java b/winboll/src/main/java/cc/winboll/studio/winboll/theme/WinBoLLThemeBean.java
new file mode 100644
index 0000000..1d748d7
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/theme/WinBoLLThemeBean.java
@@ -0,0 +1,49 @@
+package cc.winboll.studio.winboll.theme;
+
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.winboll.R;
+
+public class WinBoLLThemeBean {
+
+    public static final String TAG = "WinBoLLThemeBean";
+
+    public static int getDefaultThemeStyleID() {
+        return R.style.MyAppTheme;
+    }
+
+    public static int getThemeStyleID(AESThemeBean.ThemeType themeType) {
+        int themeStyleID = getDefaultThemeStyleID();
+        if (AESThemeBean.ThemeType.DEPTH == themeType) {
+            themeStyleID = R.style.MyDepthAppTheme;
+        } else if (AESThemeBean.ThemeType.SKY == themeType) {
+            themeStyleID = R.style.MySkyAppTheme;
+        } else if (AESThemeBean.ThemeType.GOLDEN == themeType) {
+            themeStyleID = R.style.MyGoldenAppTheme;
+        } else if (AESThemeBean.ThemeType.BEARING == themeType) {
+            themeStyleID = R.style.MyBearingAppTheme;
+        } else if (AESThemeBean.ThemeType.MEMOR == themeType) {
+            themeStyleID = R.style.MyMemorAppTheme;
+        } else if (AESThemeBean.ThemeType.TAO == themeType) {
+            themeStyleID = R.style.MyTaoAppTheme;
+        }
+        return themeStyleID;
+    }
+
+    public static AESThemeBean.ThemeType getThemeStyleType(int nThemeStyleID) {
+        AESThemeBean.ThemeType themeStyle = AESThemeBean.ThemeType.AES;
+        if (R.style.MyDepthAppTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.DEPTH;
+        } else if (R.style.MySkyAppTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.SKY;
+        } else if (R.style.MyGoldenAppTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.GOLDEN;
+        } else if (R.style.MyBearingAppTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.BEARING;
+        } else if (R.style.MyMemorAppTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.MEMOR;
+        } else if (R.style.MyTaoAppTheme == nThemeStyleID) {
+            themeStyle = AESThemeBean.ThemeType.TAO;
+        }
+        return themeStyle;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/theme/WinBoLLThemeUtil.java b/winboll/src/main/java/cc/winboll/studio/winboll/theme/WinBoLLThemeUtil.java
new file mode 100644
index 0000000..1e6640d
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/theme/WinBoLLThemeUtil.java
@@ -0,0 +1,36 @@
+package cc.winboll.studio.winboll.theme;
+
+import android.content.Context;
+import cc.winboll.studio.libaes.models.AESThemeBean;
+import cc.winboll.studio.libaes.utils.AESThemeUtil;
+
+public class WinBoLLThemeUtil {
+
+    public static final String TAG = "WinBoLLThemeUtil";
+
+    public static int getThemeTypeID(Context context) {
+        AESThemeBean bean = AESThemeBean.loadBean(context, AESThemeBean.class);
+        int themeTypeID;
+        if (bean == null) {
+            themeTypeID = WinBoLLThemeBean.getDefaultThemeStyleID();
+        } else {
+            int aesStyleID = bean.getCurrentThemeTypeID();
+            AESThemeBean.ThemeType themeType = WinBoLLThemeBean.getThemeStyleType(aesStyleID);
+            themeTypeID = WinBoLLThemeBean.getThemeStyleID(themeType);
+        }
+        return themeTypeID;
+    }
+
+    public static void saveThemeStyleID(Context context, int nThemeTypeID) {
+        AESThemeBean bean = new AESThemeBean(nThemeTypeID);
+        AESThemeBean.saveBean(context, bean);
+    }
+
+    public static AESThemeBean.ThemeType getThemeStyleType(int nThemeStyleID) {
+        return WinBoLLThemeBean.getThemeStyleType(nThemeStyleID);
+    }
+
+    public static int getThemeStyleID(AESThemeBean.ThemeType themeType) {
+        return WinBoLLThemeBean.getThemeStyleID(themeType);
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/threads/MainServiceThread.java b/winboll/src/main/java/cc/winboll/studio/winboll/threads/MainServiceThread.java
new file mode 100644
index 0000000..80ecc3f
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/threads/MainServiceThread.java
@@ -0,0 +1,54 @@
+package cc.winboll.studio.winboll.threads;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/14 03:46:44
+ */
+import android.content.Context;
+import cc.winboll.studio.winboll.handlers.MainServiceHandler;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.lang.ref.WeakReference;
+
+public class MainServiceThread extends Thread {
+
+    public static final String TAG = "MainServiceThread";
+
+    Context mContext;
+
+    // 控制线程是否退出的标志
+    volatile boolean isExist = false;
+
+    // 服务Handler, 用于线程发送消息使用
+    WeakReference<MainServiceHandler> mwrMainServiceHandler;
+
+    public void setIsExist(boolean isExist) {
+        this.isExist = isExist;
+    }
+
+    public boolean isExist() {
+        return isExist;
+    }
+
+    public MainServiceThread(Context context, MainServiceHandler handler) {
+        mContext = context;
+        mwrMainServiceHandler = new WeakReference<MainServiceHandler>(handler);
+    }
+
+    @Override
+    public void run() {
+        LogUtils.d(TAG, "run()");
+
+        while (!isExist()) {
+            //ToastUtils.show("run()");
+            //LogUtils.d(TAG, "run()");
+
+            try {
+                Thread.sleep(1000);
+            } catch (InterruptedException e) {
+                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+            }
+        }
+        LogUtils.d(TAG, "run() exit.");
+    }
+
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/unittest/TermuxEnvTestActivity.java b/winboll/src/main/java/cc/winboll/studio/winboll/unittest/TermuxEnvTestActivity.java
new file mode 100644
index 0000000..4b07046
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/unittest/TermuxEnvTestActivity.java
@@ -0,0 +1,454 @@
+package cc.winboll.studio.winboll.unittest;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Looper;
+import android.view.View;
+import android.widget.TextView;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.appcompat.widget.Toolbar;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.activities.BaseWinBoLLActivity;
+import cc.winboll.studio.winboll.termux.NfcTermuxBridgeActivity;
+import cc.winboll.studio.winboll.termux.TermuxCommandExecutor;
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.nio.charset.StandardCharsets;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/19 11:11:00
+ * @LastEditTime 2026/01/21 17:45:00
+ * @Describe Termux环境测试工具（跨包+sharedUserId模式）
+ * 适配不同应用包名（当前包：cc.winboll.studio.winboll.beta / Termux包：com.termux）
+ * 支持Termux目录读取、Gradle命令实时输出执行（唤起窗口），基于sharedUserId实现跨包权限适配
+ */
+public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
+
+	@Override
+	public Activity getActivity() {
+		return this;
+	}
+
+    // 常量属性（置顶排列）
+    public static final String TAG = "TermuxEnvTestActivity";
+    private static final String TERMUX_HOME_PATH = "/data/data/com.termux/files/home/TermuxWorkSpaces";
+    private static final String CMD_RESULT_FILE = TERMUX_HOME_PATH + "/CMD_RESULT_FILE.log";
+
+    // 成员属性（常量后排列）
+    private Toolbar mToolbar;
+    private TextView tvMessage;
+    private Handler mainHandler;
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LogUtils.d(TAG, "onCreate() 调用，初始化Activity");
+        setContentView(R.layout.activity_termux_env_test);
+        initView();
+        initToolbar();
+        initTermuxDirectory();
+        LogUtils.d(TAG, "onCreate() 执行完成");
+    }
+
+    /**
+     * 初始化视图组件
+     */
+    private void initView() {
+        LogUtils.d(TAG, "initView() 开始初始化视图");
+        tvMessage = (TextView) findViewById(R.id.tv_message);
+        mainHandler = new Handler(Looper.getMainLooper());
+
+        // 初始化提示信息
+        StringBuilder initMsg = new StringBuilder();
+        initMsg.append("Termux 测试工具（跨包+sharedUserId模式）\n");
+        initMsg.append("-------------------------\n");
+        initMsg.append("当前应用包名：");
+        initMsg.append(getPackageName());
+        initMsg.append("\n");
+        initMsg.append("Termux应用包名：com.termux\n");
+        initMsg.append("sharedUserId：com.termux（需一致）\n");
+        initMsg.append("支持功能：目录读取、Gradle命令实时输出（唤起Termux窗口）\n");
+        initMsg.append("-------------------------\n");
+        tvMessage.setText(initMsg.toString());
+
+        LogUtils.d(TAG, "initView() 初始化完成，tvMessage初始值：" + initMsg.toString().trim());
+    }
+
+    /**
+     * 初始化Toolbar组件
+     */
+    private void initToolbar() {
+        LogUtils.d(TAG, "initToolbar() 开始初始化Toolbar");
+        mToolbar = (Toolbar) findViewById(R.id.toolbar);
+
+        if (mToolbar == null) {
+            LogUtils.e(TAG, "initToolbar() 错误：未找到Toolbar组件");
+            return;
+        }
+
+        setSupportActionBar(mToolbar);
+        mToolbar.setSubtitle(getTag());
+        ((AppCompatActivity) getActivity()).getSupportActionBar().setDisplayHomeAsUpEnabled(true);
+
+        mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
+				@Override
+				public void onClick(View v) {
+					LogUtils.d(TAG, "initToolbar() 导航栏返回按钮点击");
+					getActivity().finish();
+				}
+			});
+
+        LogUtils.d(TAG, "initToolbar() 初始化完成");
+    }
+
+    /**
+     * 初始化Termux目标目录（跨包+sharedUserId模式）
+     */
+    private void initTermuxDirectory() {
+        LogUtils.d(TAG, "initTermuxDirectory() 开始初始化Termux目录，路径：" + TERMUX_HOME_PATH);
+        File termuxDir = new File(TERMUX_HOME_PATH);
+
+        if (termuxDir.exists()) {
+            LogUtils.d(TAG, "initTermuxDirectory() Termux目录已存在，无需创建");
+            return;
+        }
+
+        tvMessage.append("正在创建Termux目标目录...\n");
+        boolean createSuccess = termuxDir.mkdirs();
+        if (createSuccess) {
+            LogUtils.d(TAG, "initTermuxDirectory() Termux目录创建成功：" + TERMUX_HOME_PATH);
+            tvMessage.append("Termux目录创建成功：");
+            tvMessage.append(TERMUX_HOME_PATH);
+            tvMessage.append("\n");
+        } else {
+            LogUtils.e(TAG, "initTermuxDirectory() 错误：Termux目录创建失败");
+            tvMessage.append("警告：Termux目录创建失败！\n");
+            tvMessage.append("请检查：\n");
+            tvMessage.append("1.AndroidManifest.xml中sharedUserId是否为com.termux\n");
+            tvMessage.append("2.设备是否已root（部分机型需root才能跨包写私有目录）\n");
+        }
+    }
+
+    /**
+     * 测试读取Termux目录（按钮点击事件）
+     */
+    public void onTestTermuxEnv(View view) {
+        LogUtils.d(TAG, "onTestTermuxEnv() 按钮点击，开始读取Termux目录");
+        tvMessage.append("\n【测试：读取Termux目录】\n");
+
+        String fileListStr = readTermuxHomeFileList();
+        tvMessage.append(fileListStr);
+        tvMessage.append("\n-------------------------\n");
+
+        LogUtils.d(TAG, "onTestTermuxEnv() 执行完成，读取结果长度：" + fileListStr.length() + "字符");
+    }
+
+    /**
+     * 测试执行Gradle命令（实时输出版，唤起Termux窗口）
+     */
+    public void onTestTermuxGradleBuildCMD(View view) {
+        LogUtils.d(TAG, "onTestTermuxCMD() 按钮点击，执行Gradle命令（实时输出）");
+        tvMessage.append("\n【测试：执行Gradle命令（实时输出）】\n");
+
+        // 1. 校验Termux是否安装
+        if (!TermuxCommandExecutor.isTermuxInstalled(this)) {
+            LogUtils.e(TAG, "onTestTermuxCMD() 错误：未安装Termux应用");
+            tvMessage.append("错误：未安装Termux应用（包名：com.termux）\n");
+            return;
+        }
+
+        // 2. 定义核心路径（确保路径与Termux中一致）
+        String gradleFullPath = "/data/data/com.termux/files/home/gradle/gradle-7.5.1/bin/gradle";
+        String projectPath = TERMUX_HOME_PATH + "/Sources/DebugTemp"; // 项目目录
+
+        // 3. 构造命令（核心：用stdbuf禁用缓冲，实现实时输出）
+        String targetCmd = "";
+        // 步骤1：进入项目目录（不存在则创建）
+        //targetCmd += "cd " + projectPath + " || (mkdir -p " + projectPath + " && cd " + projectPath + ") && ";
+        targetCmd += "cd " + projectPath + " && ";
+		// 步骤2：加载环境变量
+        targetCmd += "source ~/.bashrc && ";
+        // 步骤3：显式配置PATH
+        targetCmd += "export PATH=/data/data/com.termux/files/usr/bin:/data/data/com.termux/files/home/gradle/gradle-7.5.1/bin:$PATH && ";
+        // 步骤4：用stdbuf禁用stdout/stderr缓冲（关键！），执行Gradle命令
+        // -o0：stdout无缓冲；-e0：stderr无缓冲；-i0：stdin无缓冲
+        //targetCmd += "stdbuf -o0 -e0 -i0 " + gradleFullPath + " task --all | grep assemble && ";
+        targetCmd += "stdbuf -o0 -e0 -i0 " + gradleFullPath + " -Pandroid.aapt2FromMavenOverride=/data/data/com.termux/files/home/android-sdk/build-tools/34.0.4/aapt2 assembleBetaDebug && ";
+        // 步骤5：执行成功提示
+        targetCmd += "echo '\n✅ 命令执行完成！' && echo '\n📌 项目目录：" + projectPath + "' && read -p '按回车键关闭终端...'";
+
+        LogUtils.d(TAG, "onTestTermuxCMD() 执行命令：" + targetCmd);
+
+        // 4. 执行命令（终端会话模式，唤起Termux窗口）
+        boolean cmdSuccess = TermuxCommandExecutor.executeTerminalCommand(this, targetCmd);
+        if (!cmdSuccess) {
+            LogUtils.e(TAG, "onTestTermuxCMD() 错误：命令发送失败");
+            tvMessage.append("命令发送失败！\n");
+            tvMessage.append("可能原因：\n");
+            tvMessage.append("1.Termux未开启外部应用调用权限（执行termux-setup-storage后配置）\n");
+            tvMessage.append("2.sharedUserId配置不一致\n");
+            tvMessage.append("3.Termux未安装stdbuf（执行pkg install coreutils）\n");
+            return;
+        }
+
+        // 5. 应用内提示（说明实时输出特性）
+        tvMessage.append("已唤起Termux窗口，执行说明：\n");
+        tvMessage.append("1. 自动创建/进入项目目录：");
+        tvMessage.append(projectPath);
+        tvMessage.append("\n");
+        tvMessage.append("2. 禁用输出缓冲（stdbuf），实现Gradle实时输出\n");
+        tvMessage.append("3. 筛选assemble相关任务（grep assemble）\n");
+        tvMessage.append("⚙️ Gradle路径：");
+        tvMessage.append(gradleFullPath);
+        tvMessage.append("\n");
+        tvMessage.append("💡 若未实时输出，请在Termux中执行：pkg install coreutils（安装stdbuf）\n");
+        tvMessage.append("-------------------------\n");
+    }
+
+	public void onTestWinBoLLProjectBuild(View view) {
+		ToastUtils.show("onTestWinBoLLProjectBuild");
+		NfcTermuxBridgeActivity.testCommand(this);
+	}
+	
+//	public void onTestWinBoLLProjectBuildView(View view) {
+//		ToastUtils.show("onTestWinBoLLProjectBuildView");
+//		NfcTermuxBridgeActivity.testViewCommand(this);
+//	}
+
+	public void onOpenTermuxBash(View view) {
+        LogUtils.d(TAG, "onTestTermuxCMD() 按钮点击，执行Gradle命令（实时输出）");
+        tvMessage.append("\n【测试：执行Gradle命令（实时输出）】\n");
+
+        // 1. 校验Termux是否安装
+        if (!TermuxCommandExecutor.isTermuxInstalled(this)) {
+            LogUtils.e(TAG, "onTestTermuxCMD() 错误：未安装Termux应用");
+            tvMessage.append("错误：未安装Termux应用（包名：com.termux）\n");
+            return;
+        }
+
+        // 2. 定义核心路径（确保路径与Termux中一致）
+        String gradleFullPath = "/data/data/com.termux/files/home/gradle/gradle-7.5.1/bin/gradle";
+        String projectPath = TERMUX_HOME_PATH + "/"; // 项目目录
+
+        // 3. 构造命令（核心：用stdbuf禁用缓冲，实现实时输出）
+        String targetCmd = "";
+        // 步骤1：进入项目目录（不存在则创建）
+        targetCmd += "cd " + projectPath + " && ";
+        // 步骤2：加载环境变量
+        targetCmd += "source ~/.bashrc && ";
+        // 步骤3：显式配置PATH
+        targetCmd += "export PATH=/data/data/com.termux/files/usr/bin:/data/data/com.termux/files/home/gradle/gradle-7.5.1/bin:$PATH && ";
+        // 步骤4：用stdbuf禁用stdout/stderr缓冲（关键！），执行Gradle命令
+        // -o0：stdout无缓冲；-e0：stderr无缓冲；-i0：stdin无缓冲
+        //targetCmd += "stdbuf -o0 -e0 -i0 " + gradleFullPath + " task --all | grep assemble && ";
+        //targetCmd += "stdbuf -o0 -e0 -i0 " + gradleFullPath + " -Pandroid.aapt2FromMavenOverride=/data/data/com.termux/files/home/android-sdk/build-tools/34.0.4/aapt2 assembleBetaDebug && ";
+        targetCmd += "stdbuf -o0 -e0 -i0 bash && ";
+        // 步骤5：执行成功提示
+        targetCmd += "echo '\n✅ 命令执行完成！' && echo '\n📌 项目目录：" + projectPath + "' && read -p '按回车键关闭终端...'";
+
+        LogUtils.d(TAG, "onTestTermuxCMD() 执行命令：" + targetCmd);
+
+        // 4. 执行命令（终端会话模式，唤起Termux窗口）
+        boolean cmdSuccess = TermuxCommandExecutor.executeTerminalCommand(this, targetCmd);
+        if (!cmdSuccess) {
+            LogUtils.e(TAG, "onTestTermuxCMD() 错误：命令发送失败");
+            tvMessage.append("命令发送失败！\n");
+            tvMessage.append("可能原因：\n");
+            tvMessage.append("1.Termux未开启外部应用调用权限（执行termux-setup-storage后配置）\n");
+            tvMessage.append("2.sharedUserId配置不一致\n");
+            tvMessage.append("3.Termux未安装stdbuf（执行pkg install coreutils）\n");
+            return;
+        }
+
+        // 5. 应用内提示（说明实时输出特性）
+        tvMessage.append("已唤起Termux窗口，执行说明：\n");
+        tvMessage.append("1. 自动创建/进入项目目录：");
+        tvMessage.append(projectPath);
+        tvMessage.append("\n");
+        tvMessage.append("2. 禁用输出缓冲（stdbuf），实现Gradle实时输出\n");
+        tvMessage.append("3. 筛选assemble相关任务（grep assemble）\n");
+        tvMessage.append("⚙️ Gradle路径：");
+        tvMessage.append(gradleFullPath);
+        tvMessage.append("\n");
+        tvMessage.append("💡 若未实时输出，请在Termux中执行：pkg install coreutils（安装stdbuf）\n");
+        tvMessage.append("-------------------------\n");
+    }
+
+    /**
+     * 跨包读取Termux命令结果文件（保留原功能，兼容其他场景）
+     */
+    private String readCmdResultDirectly() {
+        LogUtils.d(TAG, "readCmdResultDirectly() 开始读取命令结果，文件路径：" + CMD_RESULT_FILE);
+        File resultFile = new File(CMD_RESULT_FILE);
+
+        // 校验文件存在性
+        if (!resultFile.exists()) {
+            LogUtils.e(TAG, "readCmdResultDirectly() 错误：结果文件不存在");
+            return "错误：结果文件不存在\n可能原因：\n1.命令执行失败\n2.延迟时间不足\n3.跨包写权限被拒绝（需root）";
+        }
+
+        // 校验文件可读性
+        if (!resultFile.canRead()) {
+            LogUtils.e(TAG, "readCmdResultDirectly() 错误：无结果文件读取权限");
+            return "错误：无结果文件读取权限（sharedUserId配置错误或未root）";
+        }
+
+        // 读取文件内容
+        StringBuilder result = new StringBuilder();
+        BufferedReader br = null;
+        try {
+            br = new BufferedReader(new InputStreamReader(new FileInputStream(resultFile), StandardCharsets.UTF_8));
+            String line;
+            while ((line = br.readLine()) != null) {
+                result.append(line);
+                result.append("\n");
+            }
+            LogUtils.d(TAG, "readCmdResultDirectly() 文件读取完成，结果长度：" + result.length() + "字符");
+        } catch (IOException e) {
+            LogUtils.e(TAG, "readCmdResultDirectly() 错误：文件读取异常", e);
+            return "错误：读取文件异常 → " + e.getMessage();
+        } finally {
+            if (br != null) {
+                try {
+                    br.close();
+                    LogUtils.d(TAG, "readCmdResultDirectly() BufferedReader资源已关闭");
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "readCmdResultDirectly() 错误：BufferedReader关闭异常", e);
+                }
+            }
+        }
+
+        String resultStr = result.toString().trim();
+        return resultStr.isEmpty() ? "命令执行成功，但无输出" : resultStr;
+    }
+
+    /**
+     * 删除命令结果临时文件（保留原功能）
+     */
+    private void deleteCmdResultFile() {
+        LogUtils.d(TAG, "deleteCmdResultFile() 开始删除临时文件，路径：" + CMD_RESULT_FILE);
+        File resultFile = new File(CMD_RESULT_FILE);
+
+        if (!resultFile.exists()) {
+            LogUtils.d(TAG, "deleteCmdResultFile() 临时文件不存在，无需删除");
+            return;
+        }
+
+        if (resultFile.canWrite()) {
+            boolean deleteSuccess = resultFile.delete();
+            if (deleteSuccess) {
+                LogUtils.d(TAG, "deleteCmdResultFile() 临时文件删除成功");
+            } else {
+                LogUtils.w(TAG, "deleteCmdResultFile() 警告：临时文件删除失败");
+                tvMessage.append("警告：临时结果文件删除失败\n");
+            }
+        } else {
+            LogUtils.w(TAG, "deleteCmdResultFile() 警告：无临时文件删除权限");
+        }
+    }
+
+    /**
+     * 跨包读取Termux目录文件列表（保留原功能）
+     */
+    private String readTermuxHomeFileList() {
+        LogUtils.d(TAG, "readTermuxHomeFileList() 开始读取目录，路径：" + TERMUX_HOME_PATH);
+        File termuxHomeDir = new File(TERMUX_HOME_PATH);
+        StringBuilder result = new StringBuilder();
+
+        // 基础校验
+        if (!termuxHomeDir.exists()) {
+            LogUtils.e(TAG, "readTermuxHomeFileList() 错误：目录不存在");
+            return "错误：Termux目录不存在 → " + TERMUX_HOME_PATH;
+        }
+        if (!termuxHomeDir.isDirectory()) {
+            LogUtils.e(TAG, "readTermuxHomeFileList() 错误：指定路径不是目录");
+            return "错误：指定路径不是目录 → " + TERMUX_HOME_PATH;
+        }
+        if (!termuxHomeDir.canRead()) {
+            LogUtils.e(TAG, "readTermuxHomeFileList() 错误：无目录读取权限");
+            return "错误：无目录读取权限（需满足：1.sharedUserId=com.termux 2.设备root）";
+        }
+
+        // 获取文件列表
+        File[] files = termuxHomeDir.listFiles();
+        if (files == null || files.length == 0) {
+            LogUtils.d(TAG, "readTermuxHomeFileList() 目录为空");
+            return "Termux目录为空 → " + TERMUX_HOME_PATH;
+        }
+
+        // 拼接结果字符串
+        result.append("Termux主目录：");
+        result.append(TERMUX_HOME_PATH);
+        result.append("\n");
+        result.append("文件/子目录总数：");
+        result.append(files.length);
+        result.append("\n");
+        result.append("目录权限：");
+        result.append("读：");
+        result.append(termuxHomeDir.canRead());
+        result.append(" | 写：");
+        result.append(termuxHomeDir.canWrite());
+        result.append("\n");
+        result.append("-------------------------\n");
+
+        for (File file : files) {
+            String fileType = file.isDirectory() ? "[目录]" : "[文件]";
+            String fileName = file.getName();
+            String filePath = file.getAbsolutePath();
+            String fileSize = file.isFile() ? " | 大小：" + formatFileSize(file.length()) : "";
+            String filePerm = " | 权限：r:" + file.canRead() + "/w:" + file.canWrite();
+
+            result.append(fileType);
+            result.append("  ");
+            result.append(fileName);
+            result.append(fileSize);
+            result.append(filePerm);
+            result.append(" → ");
+            result.append(filePath);
+            result.append("\n");
+        }
+
+        LogUtils.d(TAG, "readTermuxHomeFileList() 读取完成，结果长度：" + result.length() + "字符");
+        return result.toString().trim();
+    }
+    /**
+     * 格式化文件大小（B→KB→MB）
+     */
+    private String formatFileSize(long length) {
+        LogUtils.d(TAG, "formatFileSize() 调用，文件长度：" + length + "B");
+        String sizeStr;
+        if (length < 1024) {
+            sizeStr = length + "B";
+        } else if (length < 1024 * 1024) {
+            sizeStr = String.format("%.1fKB", length / 1024.0);
+        } else {
+            sizeStr = String.format("%.1fMB", length / (1024.0 * 1024));
+        }
+        LogUtils.d(TAG, "formatFileSize() 格式化结果：" + sizeStr);
+        return sizeStr;
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        LogUtils.d(TAG, "onDestroy() 调用，清理资源");
+        deleteCmdResultFile();
+        if (mainHandler != null) {
+            mainHandler.removeCallbacksAndMessages(null);
+            LogUtils.d(TAG, "onDestroy() Handler资源已释放");
+        }
+        LogUtils.d(TAG, "onDestroy() 执行完成");
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/unittest/TestWeWorkSpecSDK.java b/winboll/src/main/java/cc/winboll/studio/winboll/unittest/TestWeWorkSpecSDK.java
new file mode 100644
index 0000000..08aa2a1
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/unittest/TestWeWorkSpecSDK.java
@@ -0,0 +1,311 @@
+package cc.winboll.studio.winboll.unittest;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.Message;
+import android.view.View;
+import android.widget.Button;
+import android.widget.Toast;
+import androidx.appcompat.app.AppCompatActivity;
+import cc.winboll.studio.libaes.interfaces.IWinBoLLActivity;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.R;
+
+/**
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/03 10:52
+ * @Describe 企业微信SDK接口测试（基础调试版）
+ * 包含：SDK初始化、基础接口调用、日志输出、主线程回调处理
+ */
+public class TestWeWorkSpecSDK extends AppCompatActivity implements IWinBoLLActivity, View.OnClickListener {
+
+    public static final String TAG = "TestWeWorkSpecSDK";
+
+    // ------------------- 企业微信SDK配置常量（需替换为实际项目参数） -------------------
+    // 企业微信 CorpID（从企业微信管理后台获取）
+    private static final String CORP_ID = "wwb37c73f34c722852";
+    // 应用 AgentID（从企业微信应用管理后台获取）
+    private static final String AGENT_ID = "your_agent_id_here";
+    // 应用 Secret（从企业微信应用管理后台获取，注意保密）
+    private static final String APP_SECRET = "your_app_secret_here";
+
+    // ------------------- Handler消息标识（主线程处理SDK回调） -------------------
+    private static final int MSG_SDK_INIT_SUCCESS = 1001;
+    private static final int MSG_SDK_INIT_FAILED = 1002;
+    private static final int MSG_GET_CORP_INFO_SUCCESS = 1003;
+    private static final int MSG_GET_CORP_INFO_FAILED = 1004;
+
+    // ------------------- 控件声明 -------------------
+    private Button mBtnInitSDK;
+    private Button mBtnGetCorpInfo;
+    private Button mBtnCheckAuth;
+
+    // ------------------- 主线程Handler（处理SDK异步回调） -------------------
+    private Handler mWeWorkHandler;
+
+
+    @Override
+    public Activity getActivity() {
+        return this;
+    }
+
+    @Override
+    public String getTag() {
+        return TAG;
+    }
+	
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_test_weworkspecsdk);
+
+        // 初始化控件
+        initViews();
+        // 绑定点击事件
+        initEvents();
+        // 初始化Handler（主线程处理回调，更新UI）
+        initHandler();
+        // 初始化SDK（可选：启动时自动初始化，或点击按钮初始化）
+        // initWeWorkSDK();
+    }
+
+    /**
+     * 初始化控件（Java 7 显式绑定）
+     */
+    private void initViews() {
+        mBtnInitSDK = (Button) findViewById(R.id.btn_init_sdk);
+        mBtnGetCorpInfo = (Button) findViewById(R.id.btn_get_corp_info);
+        mBtnCheckAuth = (Button) findViewById(R.id.btn_check_auth);
+    }
+
+    /**
+     * 绑定点击事件（Java 7 匿名内部类）
+     */
+    private void initEvents() {
+        mBtnInitSDK.setOnClickListener(this);
+        mBtnGetCorpInfo.setOnClickListener(this);
+        mBtnCheckAuth.setOnClickListener(this);
+    }
+
+    /**
+     * 初始化主线程Handler（处理SDK异步回调，安全更新UI）
+     */
+    private void initHandler() {
+        mWeWorkHandler = new Handler() {
+            @Override
+            public void handleMessage(Message msg) {
+                super.handleMessage(msg);
+                switch (msg.what) {
+                    case MSG_SDK_INIT_SUCCESS:
+                        showToast("企业微信SDK初始化成功");
+                        LogUtils.d(TAG, "SDK初始化成功");
+                        break;
+                    case MSG_SDK_INIT_FAILED:
+                        String initError = (String) msg.obj;
+                        showToast("SDK初始化失败：" + initError);
+                        LogUtils.e(TAG, "SDK初始化失败：" + initError);
+                        break;
+                    case MSG_GET_CORP_INFO_SUCCESS:
+                        String corpInfo = (String) msg.obj;
+                        showToast("获取企业信息成功");
+                        LogUtils.d(TAG, "企业信息：" + corpInfo);
+                        break;
+                    case MSG_GET_CORP_INFO_FAILED:
+                        String corpError = (String) msg.obj;
+                        showToast("获取企业信息失败：" + corpError);
+                        LogUtils.e(TAG, "获取企业信息失败：" + corpError);
+                        break;
+                    default:
+                        break;
+                }
+            }
+        };
+    }
+
+    // ------------------- 企业微信SDK核心接口调用 -------------------
+
+    /**
+     * 初始化企业微信SDK（异步操作，通过Handler回调结果）
+     */
+    private void initWeWorkSDK() {
+        showToast("开始初始化企业微信SDK...");
+        // 模拟SDK异步初始化（实际项目中替换为企业微信SDK的真实初始化接口）
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					try {
+						// 真实SDK初始化逻辑示例：
+						// WeWorkSDK.init(TestWeWorkSpecSDK.this, CORP_ID, AGENT_ID, new WeWorkSDKCallback() {
+						//     @Override
+						//     public void onSuccess() {
+						//         mWeWorkHandler.sendEmptyMessage(MSG_SDK_INIT_SUCCESS);
+						//     }
+						//
+						//     @Override
+						//     public void onFailure(String errorMsg) {
+						//         Message msg = Message.obtain();
+						//         msg.what = MSG_SDK_INIT_FAILED;
+						//         msg.obj = errorMsg;
+						//         mWeWorkHandler.sendMessage(msg);
+						//     }
+						// });
+
+						// 调试模拟：休眠1秒，模拟异步初始化
+						Thread.sleep(1000);
+						// 模拟初始化成功（如需测试失败，替换为发送MSG_SDK_INIT_FAILED）
+						mWeWorkHandler.sendEmptyMessage(MSG_SDK_INIT_SUCCESS);
+						// 模拟初始化失败
+						// Message msg = Message.obtain();
+						// msg.what = MSG_SDK_INIT_FAILED;
+						// msg.obj = "CorpID或AgentID错误";
+						// mWeWorkHandler.sendMessage(msg);
+					} catch (InterruptedException e) {
+						e.printStackTrace();
+						Message msg = Message.obtain();
+						msg.what = MSG_SDK_INIT_FAILED;
+						msg.obj = "线程中断：" + e.getMessage();
+						mWeWorkHandler.sendMessage(msg);
+					}
+				}
+			}).start();
+    }
+
+    /**
+     * 获取企业基本信息（异步操作，需先初始化SDK）
+     */
+    private void getCorpInfo() {
+        if (!isSDKInitialized()) {
+            showToast("请先初始化SDK");
+            return;
+        }
+        showToast("开始获取企业信息...");
+        // 模拟SDK异步获取企业信息（实际项目中替换为真实接口）
+        new Thread(new Runnable() {
+				@Override
+				public void run() {
+					try {
+						// 真实SDK接口示例：
+						// WeWorkSDK.getCorpInfo(APP_SECRET, new CorpInfoCallback() {
+						//     @Override
+						//     public void onSuccess(CorpInfo info) {
+						//         Message msg = Message.obtain();
+						//         msg.what = MSG_GET_CORP_INFO_SUCCESS;
+						//         msg.obj = "企业名称：" + info.getCorpName() + "，企业ID：" + info.getCorpId();
+						//         mWeWorkHandler.sendMessage(msg);
+						//     }
+						//
+						//     @Override
+						//     public void onFailure(String errorMsg) {
+						//         Message msg = Message.obtain();
+						//         msg.what = MSG_GET_CORP_INFO_FAILED;
+						//         msg.obj = errorMsg;
+						//         mWeWorkHandler.sendMessage(msg);
+						//     }
+						// });
+
+						// 调试模拟：休眠1秒，模拟异步获取
+						Thread.sleep(1000);
+						// 模拟获取成功
+						Message successMsg = Message.obtain();
+						successMsg.what = MSG_GET_CORP_INFO_SUCCESS;
+						successMsg.obj = "企业名称：WinBoLL Studio，企业ID：" + CORP_ID;
+						mWeWorkHandler.sendMessage(successMsg);
+						// 模拟获取失败
+						// Message failMsg = Message.obtain();
+						// failMsg.what = MSG_GET_CORP_INFO_FAILED;
+						// failMsg.obj = "AppSecret错误或权限不足";
+						// mWeWorkHandler.sendMessage(failMsg);
+					} catch (InterruptedException e) {
+						e.printStackTrace();
+						Message msg = Message.obtain();
+						msg.what = MSG_GET_CORP_INFO_FAILED;
+						msg.obj = "线程中断：" + e.getMessage();
+						mWeWorkHandler.sendMessage(msg);
+					}
+				}
+			}).start();
+    }
+
+    /**
+     * 检查当前用户是否已授权（同步操作，示例）
+     */
+    private void checkAuthStatus() {
+        if (!isSDKInitialized()) {
+            showToast("请先初始化SDK");
+            return;
+        }
+        // 真实SDK接口示例：
+        // boolean isAuthorized = WeWorkSDK.isAuthorized();
+        // 调试模拟：默认返回true
+        boolean isAuthorized = true;
+
+        if (isAuthorized) {
+            showToast("用户已授权");
+            LogUtils.d(TAG, "当前用户已授权企业微信应用");
+        } else {
+            showToast("用户未授权，请先授权");
+            LogUtils.d(TAG, "当前用户未授权企业微信应用");
+            // 真实项目中可调用授权接口：
+            // WeWorkSDK.requestAuth(TestWeWorkSpecSDK.this, new AuthCallback() {
+            //     @Override
+            //     public void onSuccess(String code) {
+            //         showToast("授权成功，code：" + code);
+            //     }
+            //
+            //     @Override
+            //     public void onFailure(String errorMsg) {
+            //         showToast("授权失败：" + errorMsg);
+            //     }
+            // });
+        }
+    }
+
+    // ------------------- 工具方法 -------------------
+
+    /**
+     * 检查SDK是否已初始化（模拟方法，实际项目中替换为SDK的真实状态检查）
+     */
+    private boolean isSDKInitialized() {
+        // 真实SDK可通过静态方法检查状态：
+        // return WeWorkSDK.isInitialized();
+        // 调试模拟：假设Handler不为空即表示已初始化
+        return mWeWorkHandler != null;
+    }
+
+    /**
+     * 显示Toast提示（Java 7 简化封装）
+     */
+    private void showToast(String msg) {
+        Toast.makeText(this, msg, Toast.LENGTH_SHORT).show();
+    }
+
+    // ------------------- 点击事件处理 -------------------
+
+    @Override
+    public void onClick(View v) {
+        int id = v.getId();
+        if (id == R.id.btn_init_sdk) {
+            initWeWorkSDK();
+        } else if (id == R.id.btn_get_corp_info) {
+            getCorpInfo();
+        } else if (id == R.id.btn_check_auth) {
+            checkAuthStatus();
+        }
+    }
+
+    // ------------------- 生命周期管理 -------------------
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // 释放Handler资源，避免内存泄漏
+        if (mWeWorkHandler != null) {
+            mWeWorkHandler.removeCallbacksAndMessages(null);
+            mWeWorkHandler = null;
+        }
+        // 真实SDK需调用销毁方法：
+        // WeWorkSDK.destroy();
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/APPPlusUtils.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/APPPlusUtils.java
new file mode 100644
index 0000000..2004f93
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/APPPlusUtils.java
@@ -0,0 +1,163 @@
+package cc.winboll.studio.winboll.utils;
+
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.os.Build;
+import android.widget.Toast;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.App;
+import cc.winboll.studio.winboll.R;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 08:56
+ * @Describe APPPlusUtils
+ */
+public class APPPlusUtils {
+    public static final String TAG = "APPPlusUtils";
+
+    // 快捷方式配置（名称+图标，需与实际资源匹配）
+//    private static final String PLUS_SHORTCUT_NAME = "位置服务-Laojun";
+//    private static final int PLUS_SHORTCUT_ICON = R.mipmap.ic_launcher; // Laojun 图标资源
+
+    /**
+     * 添加Plus组件与图标
+     */
+    public static boolean switchAppLauncherToComponent(Context context, String componentName) {
+        if (context == null) {
+            LogUtils.d(TAG, "切换失败：上下文为空");
+            Toast.makeText(context, context.getString(R.string.app_name) + "图标切换失败", Toast.LENGTH_SHORT).show();
+            return false;
+        }
+
+        PackageManager pm = context.getPackageManager();
+
+        ComponentName plusComponentSwitchTo = new ComponentName(context, componentName);
+        ComponentName plusComponentEN1 = new ComponentName(context, App.COMPONENT_EN1);
+        ComponentName plusComponentCN1 = new ComponentName(context, App.COMPONENT_CN1);
+        ComponentName plusComponentCN2 = new ComponentName(context, App.COMPONENT_CN2);
+
+        try {
+			disableComponent(pm, plusComponentEN1);
+			disableComponent(pm, plusComponentCN1);
+			disableComponent(pm, plusComponentCN2);
+            enableComponent(pm, plusComponentSwitchTo);
+
+            return true;
+
+        } catch (Exception e) {
+            LogUtils.e(TAG, "图标切换失败：" + e.getMessage());
+            Toast.makeText(context, context.getString(R.string.app_name) + "图标切换失败" + e.getMessage(), Toast.LENGTH_SHORT).show();
+            return false;
+        }
+    }
+
+    /**
+     * 创建指定组件的桌面快捷方式（自动去重，兼容 Android 8.0+）
+     * @param component 目标组件（如 LAOJUN_ACTIVITY）
+     * @param name 快捷方式名称
+     * @param iconRes 快捷方式图标资源ID
+     * @return 是否创建成功
+     */
+    private static boolean createComponentShortcut(Context context, ComponentName component, String name, int iconRes) {
+        if (context == null || component == null || name == null || iconRes == 0) {
+            LogUtils.d(TAG, "快捷方式创建失败：参数为空");
+            return false;
+        }
+
+        // Android 8.0+（API 26+）：使用 ShortcutManager（系统推荐）
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            try {
+                PackageManager pm = context.getPackageManager();
+                android.content.pm.ShortcutManager shortcutManager = context.getSystemService(android.content.pm.ShortcutManager.class);
+                if (shortcutManager == null || !shortcutManager.isRequestPinShortcutSupported()) {
+                    LogUtils.d(TAG, "系统不支持创建快捷方式");
+                    return false;
+                }
+
+                // 检查是否已存在该组件的快捷方式（去重）
+                for (android.content.pm.ShortcutInfo info : shortcutManager.getPinnedShortcuts()) {
+                    if (component.getClassName().equals(info.getIntent().getComponent().getClassName())) {
+                        LogUtils.d(TAG, "快捷方式已存在：" + component.getClassName());
+                        return true;
+                    }
+                }
+
+                // 构建启动目标组件的意图
+                Intent launchIntent = new Intent(Intent.ACTION_MAIN)
+					.setComponent(component)
+					.addCategory(Intent.CATEGORY_LAUNCHER)
+					.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+                // 构建快捷方式信息
+                android.content.pm.ShortcutInfo shortcutInfo = new android.content.pm.ShortcutInfo.Builder(context, component.getClassName())
+					.setShortLabel(name)
+					.setLongLabel(name)
+					.setIcon(android.graphics.drawable.Icon.createWithResource(context, iconRes))
+					.setIntent(launchIntent)
+					.build();
+
+                // 请求创建快捷方式（需用户确认）
+                shortcutManager.requestPinShortcut(shortcutInfo, null);
+                return true;
+
+            } catch (Exception e) {
+                LogUtils.d(TAG, "Android O+ 快捷方式创建失败：" + e.getMessage());
+                return false;
+            }
+        } else {
+            // Android 8.0 以下：使用广播（兼容旧机型）
+            try {
+                // 构建启动目标组件的意图
+                Intent launchIntent = new Intent(Intent.ACTION_MAIN)
+					.setComponent(component)
+					.addCategory(Intent.CATEGORY_LAUNCHER)
+					.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
+
+                // 构建创建快捷方式的广播意图
+                Intent installIntent = new Intent("com.android.launcher.action.INSTALL_SHORTCUT");
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, launchIntent);
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_NAME, name);
+                installIntent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE,
+									   Intent.ShortcutIconResource.fromContext(context, iconRes));
+                installIntent.putExtra("duplicate", false); // 禁止重复创建
+
+                context.sendBroadcast(installIntent);
+                return true;
+
+            } catch (Exception e) {
+                LogUtils.d(TAG, "Android O- 快捷方式创建失败：" + e.getMessage());
+                return false;
+            }
+        }
+    }
+
+    /**
+     * 启用组件（带状态检查，避免重复操作）
+     */
+    private static void enableComponent(PackageManager pm, ComponentName component) {
+        if (pm.getComponentEnabledSetting(component) != PackageManager.COMPONENT_ENABLED_STATE_ENABLED) {
+            pm.setComponentEnabledSetting(
+				component,
+				PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
+				PackageManager.DONT_KILL_APP | PackageManager.SYNCHRONOUS
+            );
+        }
+    }
+
+    /**
+     * 禁用组件（带状态检查，避免重复操作）
+     */
+    private static void disableComponent(PackageManager pm, ComponentName component) {
+        if (pm.getComponentEnabledSetting(component) != PackageManager.COMPONENT_ENABLED_STATE_DISABLED) {
+            pm.setComponentEnabledSetting(
+				component,
+				PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
+				PackageManager.DONT_KILL_APP | PackageManager.SYNCHRONOUS
+            );
+        }
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/OkHttpUtil.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/OkHttpUtil.java
new file mode 100644
index 0000000..4e23dcb
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/OkHttpUtil.java
@@ -0,0 +1,83 @@
+package cc.winboll.studio.winboll.utils;
+
+import android.os.Handler;
+import android.os.Looper;
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.Response;
+
+import java.io.IOException;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * OkHttp网络请求工具类
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/07
+ */
+public class OkHttpUtil {
+
+    private static OkHttpClient sOkHttpClient;
+    private static Handler sMainHandler = new Handler(Looper.getMainLooper());
+
+    static {
+        sOkHttpClient = new OkHttpClient.Builder()
+			.connectTimeout(10, TimeUnit.SECONDS)
+			.readTimeout(10, TimeUnit.SECONDS)
+			.writeTimeout(10, TimeUnit.SECONDS)
+			.build();
+    }
+
+    /**
+     * GET请求
+     * @param url 请求地址
+     * @param callback 回调
+     */
+    public static void get(String url, final OnResultCallback callback) {
+        Request request = new Request.Builder()
+			.url(url)
+			.get()
+			.build();
+
+        sOkHttpClient.newCall(request).enqueue(new Callback() {
+				@Override
+				public void onFailure(Call call, final IOException e) {
+					sMainHandler.post(new Runnable() {
+							@Override
+							public void run() {
+								if (callback != null) {
+									callback.onFailure(e.getMessage());
+								}
+							}
+						});
+				}
+
+				@Override
+				public void onResponse(Call call, final Response response) throws IOException {
+					final String result = response.body().string();
+					sMainHandler.post(new Runnable() {
+							@Override
+							public void run() {
+								if (callback != null) {
+									if (response.isSuccessful()) {
+										callback.onSuccess(result);
+									} else {
+										callback.onFailure("请求失败：" + response.code());
+									}
+								}
+							}
+						});
+				}
+			});
+    }
+
+    /**
+     * 回调接口
+     */
+    public interface OnResultCallback {
+        void onSuccess(String result);
+        void onFailure(String errorMsg);
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/RSAUtils.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/RSAUtils.java
new file mode 100644
index 0000000..5258e2b
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/RSAUtils.java
@@ -0,0 +1,222 @@
+package cc.winboll.studio.winboll.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/04 13:36
+ * @Describe RSA加密工具
+ */
+import android.content.Context;
+import android.util.Base64;
+import cc.winboll.studio.libappbase.LogUtils;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.security.KeyFactory;
+import java.security.KeyPair;
+import java.security.KeyPairGenerator;
+import java.security.NoSuchAlgorithmException;
+import java.security.PrivateKey;
+import java.security.PublicKey;
+import java.security.spec.InvalidKeySpecException;
+import java.security.spec.PKCS8EncodedKeySpec;
+import java.security.spec.X509EncodedKeySpec;
+import java.util.Objects;
+import javax.crypto.Cipher;
+
+public class RSAUtils {
+    private static final String TAG = "RSAUtils";
+    private static final int KEY_SIZE = 2048;
+    private static final String KEY_ALGORITHM = "RSA";
+    private static final String PUBLIC_KEY_FILE = "public.key";
+    private static final String PRIVATE_KEY_FILE = "private.key";
+    private static final String CIPHER_ALGORITHM = KEY_ALGORITHM + "/ECB/PKCS1Padding"; // 保留原加密方式
+
+    private final String keyPath;
+    private static volatile RSAUtils INSTANCE;
+
+    /**
+     * 构造方法：初始化密钥存储路径（内部存储）
+     */
+    private RSAUtils(Context context) {
+        keyPath = context.getFilesDir() + File.separator + "keys" + File.separator; // 修正路径格式
+    }
+
+    /**
+     * 获取单例实例
+     */
+    public static synchronized RSAUtils getInstance(Context context) {
+        if (INSTANCE == null) {
+            INSTANCE = new RSAUtils(context);
+        }
+        return INSTANCE;
+    }
+
+    /**
+     * 检查密钥文件是否存在
+     */
+    public boolean keysExist() {
+        File publicKeyFile = new File(keyPath + PUBLIC_KEY_FILE);
+        File privateKeyFile = new File(keyPath + PRIVATE_KEY_FILE);
+        return publicKeyFile.exists() && privateKeyFile.exists();
+    }
+
+    /**
+     * 生成密钥对并保存到文件
+     */
+    public void generateAndSaveKeys() throws Exception {
+        LogUtils.d(TAG, "开始生成 RSA 密钥对（2048位）");
+        KeyPairGenerator generator = KeyPairGenerator.getInstance(KEY_ALGORITHM);
+        generator.initialize(KEY_SIZE);
+        KeyPair keyPair = generator.generateKeyPair();
+
+        saveKey(PUBLIC_KEY_FILE, keyPair.getPublic().getEncoded());
+        saveKey(PRIVATE_KEY_FILE, keyPair.getPrivate().getEncoded());
+        LogUtils.d(TAG, "密钥对生成并保存成功");
+    }
+
+    /**
+     * 获取或生成密钥对（线程安全）
+     */
+    public KeyPair getOrGenerateKeys() throws Exception {
+        if (!keysExist()) {
+            synchronized (RSAUtils.class) { // 双重检查锁，避免多线程重复生成
+                if (!keysExist()) {
+                    generateAndSaveKeys();
+                }
+            }
+        }
+        return readKeysFromFile();
+    }
+
+    /**
+     * 从文件读取密钥对
+     */
+    private KeyPair readKeysFromFile() throws Exception {
+        LogUtils.d(TAG, "读取密钥对文件");
+        try {
+            byte[] publicKeyBytes = readFileToBytes(keyPath + PUBLIC_KEY_FILE);
+            byte[] privateKeyBytes = readFileToBytes(keyPath + PRIVATE_KEY_FILE);
+
+            X509EncodedKeySpec publicSpec = new X509EncodedKeySpec(publicKeyBytes);
+            PKCS8EncodedKeySpec privateSpec = new PKCS8EncodedKeySpec(privateKeyBytes);
+
+            KeyFactory factory = KeyFactory.getInstance(KEY_ALGORITHM);
+            PublicKey publicKey = factory.generatePublic(publicSpec);
+            PrivateKey privateKey = factory.generatePrivate(privateSpec);
+
+            return new KeyPair(publicKey, privateKey);
+        } catch (IOException | NoSuchAlgorithmException | InvalidKeySpecException e) {
+            LogUtils.e(TAG, "密钥文件读取失败：" + e.getMessage());
+            throw new Exception("密钥文件损坏或格式错误", e);
+        }
+    }
+
+    /**
+     * 保存密钥到文件（通用方法）
+     */
+    private void saveKey(String fileName, byte[] keyBytes) throws IOException {
+        Objects.requireNonNull(keyBytes, "密钥字节数据不可为空");
+        File dir = new File(keyPath);
+        if (!dir.exists() && !dir.mkdirs()) {
+            throw new IOException("创建密钥目录失败：" + keyPath);
+        }
+
+        FileOutputStream fos = null;
+        try {
+            fos = new FileOutputStream(keyPath + fileName);
+            fos.write(keyBytes);
+        } finally {
+            if (fos != null) {
+                try {
+                    fos.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "关闭文件流失败：" + e.getMessage());
+                }
+            }
+        }
+    }
+
+    /**
+     * 读取文件为字节数组（Java 7 兼容）
+     */
+    private byte[] readFileToBytes(String filePath) throws IOException {
+        File file = new File(filePath);
+        if (!file.exists() || file.isDirectory()) {
+            throw new IOException("文件不存在或为目录：" + filePath);
+        }
+
+        FileInputStream fis = null;
+        try {
+            fis = new FileInputStream(file);
+            byte[] data = new byte[(int) file.length()];
+            int bytesRead = fis.read(data);
+            if (bytesRead != data.length) {
+                throw new IOException("文件读取不完整");
+            }
+            return data;
+        } finally {
+            if (fis != null) {
+                try {
+                    fis.close();
+                } catch (IOException e) {
+                    LogUtils.e(TAG, "关闭文件流失败：" + e.getMessage());
+                }
+            }
+        }
+    }
+
+    /**
+     * 公钥加密（带参数校验）
+     */
+    public byte[] encryptWithPublicKey(String plainText, PublicKey publicKey) throws Exception {
+        Objects.requireNonNull(plainText, "明文不可为空");
+        Objects.requireNonNull(publicKey, "公钥不可为空");
+
+        Cipher cipher = Cipher.getInstance(CIPHER_ALGORITHM);
+        cipher.init(Cipher.ENCRYPT_MODE, publicKey);
+
+        // 检查数据长度是否超过 RSA 限制（2048位密钥最大明文为 214字节，PKCS1Padding）
+        int maxPlainTextSize = cipher.getBlockSize() - 11; // PKCS1Padding 固定填充长度
+        if (plainText.getBytes("UTF-8").length > maxPlainTextSize) {
+            throw new IllegalArgumentException("明文过长，最大支持 " + maxPlainTextSize + " 字节");
+        }
+
+        return cipher.doFinal(plainText.getBytes("UTF-8"));
+    }
+
+    /**
+     * 私钥解密（带参数校验）
+     */
+    public String decryptWithPrivateKey(byte[] encryptedData, PrivateKey privateKey) throws Exception {
+        Objects.requireNonNull(encryptedData, "密文不可为空");
+        Objects.requireNonNull(privateKey, "私钥不可为空");
+
+        Cipher cipher = Cipher.getInstance(CIPHER_ALGORITHM);
+        cipher.init(Cipher.DECRYPT_MODE, privateKey);
+        byte[] decryptedBytes = cipher.doFinal(encryptedData);
+        return new String(decryptedBytes, "UTF-8");
+    }
+    /**
+     * 将 HTTP 传输的 Base64 字符串还原为加密字节数组（Java 7 兼容）
+     * @param httpString Base64 字符串（非 null）
+     * @return 加密字节数组
+     * @throws IllegalArgumentException 解码失败时抛出
+     */
+    public byte[] httpStringToEncryptBytes(String httpString) {
+        Objects.requireNonNull(httpString, "HTTP 字符串不可为空");
+
+        // 计算缺失的填充符数量（Java 7 不支持 repeat()，手动拼接）
+        int pad = httpString.length() % 4;
+        StringBuilder paddedString = new StringBuilder(httpString);
+        if (pad != 0) {
+            for (int i = 0; i < pad; i++) {
+                paddedString.append('='); // 补全 '='
+            }
+        }
+
+        // 使用 Base64 解码（Android 原生 Base64 类兼容 Java 7）
+        return Base64.decode(paddedString.toString(), Base64.URL_SAFE);
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/ServiceUtils.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/ServiceUtils.java
new file mode 100644
index 0000000..74c8065
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/ServiceUtils.java
@@ -0,0 +1,35 @@
+package cc.winboll.studio.winboll.utils;
+
+import android.app.ActivityManager;
+import android.content.Context;
+import java.util.List;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 10:25
+ * @Describe ServiceUtils
+ */
+public class ServiceUtils {
+
+    public static final String TAG = ServiceUtils.class.getSimpleName();
+
+    public static boolean isServiceAlive(Context context, String szServiceName) {
+        // 获取Activity管理者对象
+        ActivityManager manager = (ActivityManager) context
+            .getSystemService(Context.ACTIVITY_SERVICE);
+        // 获取正在运行的服务（此处设置最多取1000个）
+        List<ActivityManager.RunningServiceInfo> runningServices = manager
+            .getRunningServices(1000);
+        if (runningServices.size() <= 0) {
+            return false;
+        }
+        // 遍历，若存在名字和传入的serviceName的一致则说明存在
+        for (ActivityManager.RunningServiceInfo runningServiceInfo : runningServices) {
+            if (runningServiceInfo.service.getClassName().equals(szServiceName)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/SpecUtil.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/SpecUtil.java
new file mode 100644
index 0000000..279f286
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/SpecUtil.java
@@ -0,0 +1,26 @@
+package cc.winboll.studio.winboll.utils;
+
+import cc.winboll.studio.libappbase.LogUtils;
+
+/**
+ * 日志工具类（适配项目规范）
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/07
+ */
+public class SpecUtil {
+
+    private static final boolean isDebug = true;
+
+    public static void WWSpecLogInfo(String tag, String msg) {
+        if (isDebug) {
+            LogUtils.i(tag, msg);
+        }
+    }
+
+    public static void WWSpecLogError(String tag, String msg) {
+        if (isDebug) {
+            LogUtils.e(tag, msg);
+        }
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/TermuxUtils.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/TermuxUtils.java
new file mode 100644
index 0000000..959169a
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/TermuxUtils.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.winboll.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@188.com>
+ * @Date 2025/06/08 09:05
+ * @Describe Termux 应用操作工具集
+ */
+import android.content.Intent;
+
+public abstract class TermuxUtils {
+
+    public static final String TAG = "TermuxUtils";
+
+    private void runTermuxCommand(String command) {
+        // 1. 创建 Intent，指定 Termux 的 RunCommandService
+        /*Intent intent = new Intent("com.termux.RUN_COMMAND");
+        intent.setPackage("com.termux"); // Termux 应用的包名
+
+        // 2. 传递命令参数（必填）
+        //intent.putExtra("command", command); 
+        intent.putExtra("cd ~/WinBoLL&&echo 'WinBoLL cmd exec at (data", command); 
+
+        // 3. 可选：设置工作目录（默认为 Termux 的 home 目录）
+        intent.putExtra("dir", "/data/data/com.termux/files/home/WinBoLL"); 
+
+        // 4. 发送 Intent（需处理可能的安全异常或 ActivityNotFoundException）
+        try {
+            getApplicationContext().startService(intent);
+        } catch (Exception e) {
+            e.printStackTrace();
+        }*/
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/WxPayApi.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/WxPayApi.java
new file mode 100644
index 0000000..dd0b508
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/WxPayApi.java
@@ -0,0 +1,100 @@
+package cc.winboll.studio.winboll.utils;
+
+import cc.winboll.studio.winboll.WxPayConfig;
+import com.alibaba.fastjson.JSONObject;
+
+/**
+ * 微信支付服务端接口封装
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/07
+ */
+public class WxPayApi {
+
+    /**
+     * 统一下单（生成二维码）
+     * @param callback 回调
+     */
+    public static void createOrder(final OnCreateOrderCallback callback) {
+        // 拼接请求参数（服务端测试接口需支持GET传参，若为POST需修改为表单/JSON）
+        String url = WxPayConfig.CREATE_ORDER_URL +
+			"?body=" + WxPayConfig.ORDER_BODY +
+			"&totalFee=" + WxPayConfig.TOTAL_FEE +
+			"&tradeType=" + WxPayConfig.TRADE_TYPE;
+
+        OkHttpUtil.get(url, new OkHttpUtil.OnResultCallback() {
+				@Override
+				public void onSuccess(String result) {
+					try {
+						JSONObject jsonObject = JSONObject.parseObject(result);
+						String outTradeNo = jsonObject.getString("out_trade_no");
+						String codeUrl = jsonObject.getString("code_url");
+						if (callback != null) {
+							callback.onSuccess(outTradeNo, codeUrl);
+						}
+					} catch (Exception e) {
+						if (callback != null) {
+							callback.onFailure("解析统一下单结果失败：" + e.getMessage());
+						}
+					}
+				}
+
+				@Override
+				public void onFailure(String errorMsg) {
+					if (callback != null) {
+						callback.onFailure("统一下单请求失败：" + errorMsg);
+					}
+				}
+			});
+    }
+
+    /**
+     * 订单查询
+     * @param outTradeNo 商户订单号
+     * @param callback 回调
+     */
+    public static void queryOrder(String outTradeNo, final OnQueryOrderCallback callback) {
+        String url = WxPayConfig.QUERY_ORDER_URL + "?outTradeNo=" + outTradeNo;
+
+        OkHttpUtil.get(url, new OkHttpUtil.OnResultCallback() {
+				@Override
+				public void onSuccess(String result) {
+					try {
+						JSONObject jsonObject = JSONObject.parseObject(result);
+						String tradeState = jsonObject.getString("trade_state");
+						boolean isSuccess = "SUCCESS".equals(tradeState);
+						if (callback != null) {
+							callback.onSuccess(isSuccess, tradeState);
+						}
+					} catch (Exception e) {
+						if (callback != null) {
+							callback.onFailure("解析订单查询结果失败：" + e.getMessage());
+						}
+					}
+				}
+
+				@Override
+				public void onFailure(String errorMsg) {
+					if (callback != null) {
+						callback.onFailure("订单查询请求失败：" + errorMsg);
+					}
+				}
+			});
+    }
+
+    /**
+     * 统一下单回调接口
+     */
+    public interface OnCreateOrderCallback {
+        void onSuccess(String outTradeNo, String codeUrl);
+        void onFailure(String errorMsg);
+    }
+
+    /**
+     * 订单查询回调接口
+     */
+    public interface OnQueryOrderCallback {
+        void onSuccess(boolean isPaySuccess, String tradeState);
+        void onFailure(String errorMsg);
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/YunUtils.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/YunUtils.java
new file mode 100644
index 0000000..9c67b01
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/YunUtils.java
@@ -0,0 +1,282 @@
+package cc.winboll.studio.winboll.utils;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/06/04 17:21
+ * @Describe 应用登录与接口工具
+ */
+import android.content.Context;
+import android.os.Handler;
+import android.os.Looper;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.models.ResponseData;
+import cc.winboll.studio.winboll.models.UserInfoModel;
+import com.google.gson.Gson;
+import java.io.File;
+import java.io.IOException;
+import java.io.UnsupportedEncodingException;
+import java.net.URLDecoder;
+import java.nio.charset.StandardCharsets;
+import java.security.KeyPair;
+import java.security.PrivateKey;
+import java.security.PublicKey;
+import java.util.concurrent.TimeUnit;
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.MediaType;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.RequestBody;
+import okhttp3.Response;
+
+public class YunUtils {
+    public static final String TAG = "YunUtils";
+    // 私有静态实例，类加载时创建
+    private static volatile YunUtils INSTANCE;
+    Context mContext;
+    UserInfoModel mUserInfoModel;
+    String token = "";
+    String mDataFolderPath = "";
+    String mUserInfoModelPath = "";
+
+    private static final int CONNECT_TIMEOUT = 15; // 连接超时时间（秒）
+    private static final int READ_TIMEOUT = 20;    // 读取超时时间（秒）
+    private static volatile YunUtils instance;
+    private OkHttpClient okHttpClient;
+    private Handler mainHandler; // 主线程 Handler
+
+    // 私有构造方法，防止外部实例化
+    private YunUtils(Context context) {
+        LogUtils.d(TAG, "YunUtils");
+        mContext = context;
+        mDataFolderPath = mContext.getExternalFilesDir(TAG).toString();
+        File fTest = new File(mDataFolderPath);
+        if (!fTest.exists()) {
+            fTest.mkdirs();
+        }
+        mUserInfoModelPath = mDataFolderPath + File.separator + "UserInfoModel.rsajson";
+
+        okHttpClient = new OkHttpClient.Builder()
+            .connectTimeout(CONNECT_TIMEOUT, TimeUnit.SECONDS)
+            .readTimeout(READ_TIMEOUT, TimeUnit.SECONDS)
+            .build();
+        mainHandler = new Handler(Looper.getMainLooper()); // 获取主线程 Looper
+    }
+
+    // 公共静态方法，返回唯一实例
+    public static synchronized YunUtils getInstance(Context context) {
+        LogUtils.d(TAG, "getInstance");
+        if (INSTANCE == null) {
+            INSTANCE = new YunUtils(context);
+        }
+        return INSTANCE;
+    }
+
+    public void checkLoginStatus() {
+        String token = getLocalToken();
+        LogUtils.d(TAG, String.format("checkLoginStatus token is %s", token));
+    }
+
+    String getLocalToken() {
+        UserInfoModel userInfoModel = loadUserInfoModel();
+        return (userInfoModel == null) ?"": userInfoModel.getToken();
+    }
+
+    public void login(String host, UserInfoModel userInfoModel) {
+        LogUtils.d(TAG, "login");
+
+        // 发送 POST 请求
+        String apiUrl = host + "/login/index.php";
+        // 序列化对象为JSON
+        Gson gson = new Gson();
+        String jsonData = gson.toJson(userInfoModel); // 自动生成标准JSON
+        //String jsonData = userInfoModel.toString();
+        LogUtils.d(TAG, "要发送的数据 : " + jsonData);
+
+        sendPostRequest(apiUrl, jsonData, new OnResponseListener() {
+                // 成功回调（主线程）
+                @Override
+                public void onSuccess(String responseBody) {
+                    LogUtils.d(TAG, "onSuccess");
+                    LogUtils.d(TAG, String.format("responseBody %s", responseBody));
+                    Gson gson = new Gson();
+                    ResponseData result = gson.fromJson(responseBody, ResponseData.class); // 转为 Result 实例
+                    if(result.getStatus().equals(ResponseData.STATUS_SUCCESS)) {
+                        
+                            UserInfoModel userInfoModel = result.getData();
+                            if (userInfoModel != null) {
+                                LogUtils.d(TAG, "收到网站 UserInfoModel");
+                                String token = userInfoModel.getToken();
+                                saveLocalToken(token);
+                                checkLoginStatus();
+                            }
+                       
+                    } else if(result.getStatus().equals(ResponseData.STATUS_ERROR)) {
+                        try {
+                            String decodedMessage = URLDecoder.decode(result.getMessage(), "UTF-8");
+                            LogUtils.d(TAG, "服务器返回信息: " + decodedMessage);
+                        } catch (UnsupportedEncodingException e) {
+                            LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+                        }
+                    }
+                }
+
+                // 失败回调（主线程）
+                @Override
+                public void onFailure(String errorMsg) {
+                    LogUtils.d(TAG, errorMsg);
+                    // 处理错误
+                }
+            });
+    }
+
+    public void saveLocalToken(String token) {
+        UserInfoModel userInfoModel = new UserInfoModel();
+        userInfoModel.setToken(token);
+        saveUserInfoModel(userInfoModel);
+    }
+
+    UserInfoModel loadUserInfoModel() {
+//        LogUtils.d(TAG, "loadUserInfoModel");
+//        if (new File(mUserInfoModelPath).exists()) {
+//            try {
+//                // 加载加密后的模型数据
+//                byte[] encryptedData = FileUtils.readByteArrayFromFile(mUserInfoModelPath);
+//                // 加载 RSA 工具
+//                RSAUtils utils = RSAUtils.getInstance(mContext);
+//                KeyPair keyPair = utils.getOrGenerateKeys();
+//                //PublicKey publicKey = keyPair.getPublic();
+//                PrivateKey privateKey = keyPair.getPrivate();
+//                // 私钥解密模型数据
+//                String szInfo = utils.decryptWithPrivateKey(encryptedData, keyPair.getPrivate());
+//                LogUtils.d(TAG, String.format("szInfo %s", szInfo));
+//                mUserInfoModel = UserInfoModel.parseStringToBean(szInfo, UserInfoModel.class);
+//                if (mUserInfoModel == null) {
+//                    LogUtils.d(TAG, "模型数据解析为空数据。");
+//                }
+//                LogUtils.d(TAG, "UserInfoModel 解密加载结束。");
+//            } catch (Exception e) {
+//                LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+//            }
+//        } else {
+//            LogUtils.d(TAG, "云服务登录信息不存在。");
+//            mUserInfoModel = null;
+//        }
+//        return mUserInfoModel;
+		return null;
+    }
+
+    void saveUserInfoModel(UserInfoModel userInfoModel) {
+//        LogUtils.d(TAG, "saveUserInfoModel");
+//        try {
+//            String szInfo = userInfoModel.toString();
+//            LogUtils.d(TAG, "原始数据: " + szInfo);
+//
+//            RSAUtils utils = RSAUtils.getInstance(mContext);
+//            KeyPair keyPair = utils.getOrGenerateKeys();
+//            PublicKey publicKey = keyPair.getPublic();
+//
+//            // 公钥加密（传入字节数组，避免中间字符串转换）
+//            byte[] encryptedData = utils.encryptWithPublicKey(szInfo, publicKey);
+//
+//            // 保存加密字节数组到文件（直接操作字节，无需转字符串）
+//            FileUtils.writeByteArrayToFile(encryptedData, mUserInfoModelPath);
+//            LogUtils.d(TAG, "加密数据已保存");
+//
+//            // 测试解密（仅调试用）
+//            String szInfo2 = utils.decryptWithPrivateKey(encryptedData, keyPair.getPrivate());
+//            LogUtils.d(TAG, "解密结果: " + szInfo2);
+//
+//            mUserInfoModel = UserInfoModel.parseStringToBean(szInfo2, UserInfoModel.class);
+//            if (mUserInfoModel == null) {
+//                LogUtils.d(TAG, "模型解析失败");
+//            }
+//        } catch (Exception e) {
+//            LogUtils.d(TAG, "加密/解密失败: " + e.getMessage());
+//        }
+    }
+
+    // 发送 POST 请求（JSON 数据）
+    public void sendPostRequest(String url, String data, OnResponseListener listener) {
+        RequestBody requestBody = RequestBody.create(
+            MediaType.parse("application/json; charset=utf-8"), // 关键头信息
+            data.getBytes(StandardCharsets.UTF_8)
+        );
+
+        Request request = new Request.Builder()
+            .url(url)
+            .post(requestBody)
+            .addHeader("Content-Type", "application/json") // 显式添加头
+            .build();
+
+        executeRequest(request, listener);
+    }
+
+    // 发送 GET 请求
+    public void sendGetRequest(String url, OnResponseListener listener) {
+        Request request = new Request.Builder()
+            .url(url)
+            .get()
+            .build();
+        executeRequest(request, listener);
+    }
+
+    // 执行请求（子线程处理）
+    private void executeRequest(final Request request, final OnResponseListener listener) {
+        okHttpClient.newCall(request).enqueue(new Callback() {
+                // 响应成功（子线程）
+                @Override
+                public void onResponse(Call call, Response response) throws IOException {
+                    try {
+                        if (!response.isSuccessful()) {
+                            postFailure(listener, "响应码错误：" + response.code());
+                            return;
+                        }
+                        String responseBody = response.body().string();
+                        postSuccess(listener, responseBody);
+                    } catch (Exception e) {
+                        postFailure(listener, "解析失败：" + e.getMessage());
+                    }
+                }
+
+                // 响应失败（子线程）
+                @Override
+                public void onFailure(Call call, IOException e) {
+                    postFailure(listener, "网络失败：" + e.getMessage());
+                }
+
+                // 主线程回调（使用 Handler）
+                private void postSuccess(final OnResponseListener listener, final String msg) {
+                    mainHandler.post(new Runnable() {
+                            @Override
+                            public void run() {
+                                listener.onSuccess(msg);
+                            }
+                        });
+                }
+
+                private void postFailure(final OnResponseListener listener, final String msg) {
+                    mainHandler.post(new Runnable() {
+                            @Override
+                            public void run() {
+                                listener.onFailure(msg);
+                            }
+                        });
+                }
+            });
+    }
+
+    public interface OnResponseListener {
+        /**
+         * 成功响应（主线程回调）
+         * @param responseBody 响应体字符串
+         */
+        void onSuccess(String responseBody);
+
+        /**
+         * 失败回调（包含错误信息）
+         * @param errorMsg 错误描述
+         */
+        void onFailure(String errorMsg);
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/utils/ZXingUtils.java b/winboll/src/main/java/cc/winboll/studio/winboll/utils/ZXingUtils.java
new file mode 100644
index 0000000..389298d
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/utils/ZXingUtils.java
@@ -0,0 +1,75 @@
+package cc.winboll.studio.winboll.utils;
+
+import android.graphics.Bitmap;
+import com.google.zxing.BarcodeFormat;
+import com.google.zxing.EncodeHintType;
+import com.google.zxing.WriterException;
+import com.google.zxing.common.BitMatrix;
+import com.google.zxing.qrcode.QRCodeWriter;
+import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;
+import com.journeyapps.barcodescanner.BarcodeEncoder;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * ZXing二维码生成工具类
+ * 依赖：com.google.zxing:core:3.4.1 + com.journeyapps:zxing-android-embedded:3.6.0
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2026/01/07
+ */
+public class ZXingUtils {
+
+    /**
+     * 生成二维码Bitmap（核心方法，使用journeyapps工具类）
+     * @param content 内容（如微信支付的code_url）
+     * @param width 二维码宽度（px）
+     * @param height 二维码高度（px）
+     * @return 二维码Bitmap，失败返回null
+     */
+    public static Bitmap createQRCodeBitmap(String content, int width, int height) {
+        // 1. 入参合法性校验
+        if (content == null || content.trim().isEmpty()) {
+            return null;
+        }
+        if (width <= 0 || height <= 0) {
+            return null;
+        }
+
+        // 2. 配置二维码参数
+        Map<EncodeHintType, Object> hints = new HashMap<>();
+        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8"); // 字符编码
+        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H); // 高容错级别（H级可容忍30%遮挡）
+        hints.put(EncodeHintType.MARGIN, 1); // 边距（值越小，二维码越紧凑，建议1-4）
+
+        try {
+            // 3. 生成BitMatrix（二维码矩阵）
+            QRCodeWriter qrCodeWriter = new QRCodeWriter();
+            BitMatrix bitMatrix = qrCodeWriter.encode(
+				content,
+				BarcodeFormat.QR_CODE,
+				width,
+				height,
+				hints
+            );
+
+            // 4. 转换BitMatrix为Bitmap（关键：使用journeyapps的BarcodeEncoder）
+            BarcodeEncoder barcodeEncoder = new BarcodeEncoder();
+            return barcodeEncoder.createBitmap(bitMatrix);
+
+        } catch (WriterException e) {
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    /**
+     * 重载方法：生成正方形二维码（宽度=高度）
+     * @param content 内容
+     * @param size 二维码边长（px）
+     * @return 二维码Bitmap
+     */
+    public static Bitmap createQRCodeBitmap(String content, int size) {
+        return createQRCodeBitmap(content, size, size);
+    }
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/views/TermuxButton.java b/winboll/src/main/java/cc/winboll/studio/winboll/views/TermuxButton.java
new file mode 100644
index 0000000..719ffd1
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/views/TermuxButton.java
@@ -0,0 +1,264 @@
+package cc.winboll.studio.winboll.views;
+
+import android.app.AlertDialog;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.util.AttributeSet;
+import android.view.View;
+import android.widget.Button;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.models.TermuxButtonModel;
+
+/**
+ * 自定义Termux功能按钮控件
+ * 绑定TermuxButtonModel实体数据，拦截点击事件做确认弹窗逻辑判断
+ * isCommitted为true直接执行点击事件，为false弹出确认对话框二次确认
+ * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
+ * @CreateTime 2026/04/30 10:57:00
+ * @EditTime 2026/04/30 13:52:15
+ */
+public class TermuxButton extends Button {
+
+    public static final String TAG = "TermuxButton";
+
+    /** 绑定按钮对应数据实体 */
+    private TermuxButtonModel buttonModel;
+    /** 保存外部设置的原始点击监听 */
+    private OnClickListener originClickListener;
+
+    //==================== 构造方法 ====================
+    /**
+     * 代码动态创建控件构造
+     * @param context 上下文
+     */
+    public TermuxButton(Context context) {
+        super(context);
+        LogUtils.d(TAG, "TermuxButton 无参构造执行，上下文：" + context);
+        initView(null, null);
+    }
+
+    /**
+     * XML布局引用控件基础构造
+     * @param context 上下文
+     * @param attrs XML属性集
+     */
+    public TermuxButton(Context context, AttributeSet attrs) {
+        super(context, attrs);
+        LogUtils.d(TAG, "TermuxButton XML构造执行");
+        initView(attrs, null);
+    }
+
+    /**
+     * XML布局带自定义属性构造
+     * @param context 上下文
+     * @param attrs XML属性集
+     * @param defStyleAttr 默认样式属性
+     */
+    public TermuxButton(Context context, AttributeSet attrs, int defStyleAttr) {
+        super(context, attrs, defStyleAttr);
+        LogUtils.d(TAG, "TermuxButton 带样式属性构造执行");
+        initView(attrs, null);
+    }
+
+    /**
+     * 高版本Android完整全参构造
+     * @param context 上下文
+     * @param attrs XML属性集
+     * @param defStyleAttr 默认样式属性
+     * @param defStyleRes 默认样式资源
+     */
+    public TermuxButton(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
+        super(context, attrs, defStyleAttr, defStyleRes);
+        LogUtils.d(TAG, "TermuxButton 全参构造执行");
+        initView(attrs, null);
+    }
+
+    /**
+     * 直接传入Model初始化控件构造
+     * @param context 上下文
+     * @param model 按钮数据实体
+     */
+    public TermuxButton(Context context, TermuxButtonModel model) {
+        super(context);
+        LogUtils.d(TAG, "TermuxButton Model入参构造执行");
+        initView(null, model);
+    }
+
+    //==================== 核心初始化 ====================
+    /**
+     * 控件统一初始化方法
+     * @param attrs XML属性集合
+     * @param model 绑定数据实体
+     */
+    private void initView(AttributeSet attrs, TermuxButtonModel model) {
+        this.buttonModel = model;
+
+        // 按钮基础默认配置
+        setClickable(true);
+        setFocusable(true);
+
+        // 解析XML布局自定义属性
+        if (attrs != null) {
+            parseXmlCustomAttr(attrs);
+        }
+
+        // 同步Model内按钮名称到控件展示文本
+        refreshButtonText();
+        // 绑定自定义拦截点击事件
+        setCustomClickEvent();
+    }
+
+    /**
+     * 解析XML布局属性，读取原生android:text与自定义属性赋值到Model
+     * @param attrs XML属性集
+     */
+    private void parseXmlCustomAttr(AttributeSet attrs) {
+        if (buttonModel == null) {
+            buttonModel = new TermuxButtonModel();
+            LogUtils.d(TAG, "自动初始化空的TermuxButtonModel实体");
+        }
+
+        // 读取原生android:text作为按钮名称
+        String androidText = attrs.getAttributeValue("http://schemas.android.com/apk/res/android", "text");
+        // 读取自定义扩展属性
+        String exeCommand = attrs.getAttributeValue("http://schemas.android.com/apk/res-auto", "exeCommand");
+        String workDir = attrs.getAttributeValue("http://schemas.android.com/apk/res-auto", "workDir");
+        String isCommittedStr = attrs.getAttributeValue("http://schemas.android.com/apk/res-auto", "isCommitted");
+        String commitTitle = attrs.getAttributeValue("http://schemas.android.com/apk/res-auto", "commitTitle");
+        String commitInfo = attrs.getAttributeValue("http://schemas.android.com/apk/res-auto", "commitInfo");
+
+        // 属性赋值绑定
+        if (androidText != null) {
+            buttonModel.setButtonName(androidText);
+        }
+        if (exeCommand != null) {
+            buttonModel.setExeCommand(exeCommand);
+        }
+        if (workDir != null) {
+            buttonModel.setWorkDir(workDir);
+        }
+        if (isCommittedStr != null) {
+            buttonModel.setCommitted(Boolean.parseBoolean(isCommittedStr));
+        }
+        if (commitTitle != null) {
+            buttonModel.setCommitTitle(commitTitle);
+        }
+        if (commitInfo != null) {
+            buttonModel.setCommitInfo(commitInfo);
+        }
+
+        LogUtils.d(TAG, "XML属性解析完成，按钮名称：" + androidText);
+    }
+
+    /**
+     * 同步Model中buttonName，更新按钮展示文字
+     */
+    private void refreshButtonText() {
+        if (buttonModel != null) {
+            setText(buttonModel.getButtonName());
+        }
+    }
+
+    //==================== 点击事件相关 ====================
+    /**
+     * 重写点击监听设置，保存外部原始点击事件
+     * @param l 外部传入点击监听
+     */
+    @Override
+    public void setOnClickListener(OnClickListener l) {
+        this.originClickListener = l;
+        LogUtils.d(TAG, "保存外部原始按钮点击监听");
+    }
+
+    /**
+     * 自定义拦截按钮点击逻辑
+     * isCommitted=true 直接执行原始点击事件
+     * isCommitted=false 弹出确认二次弹窗
+     */
+    private void setCustomClickEvent() {
+        super.setOnClickListener(new OnClickListener() {
+				@Override
+				public void onClick(View view) {
+					if (buttonModel == null) {
+						LogUtils.d(TAG, "无绑定Model，直接执行原始点击事件");
+						if (originClickListener != null) {
+							originClickListener.onClick(view);
+						}
+						return;
+					}
+
+					boolean commitState = buttonModel.isCommitted();
+					LogUtils.d(TAG, "按钮点击触发，isCommitted状态：" + commitState);
+					if (commitState) {
+						// 无需确认，直接执行原有点击任务
+						if (originClickListener != null) {
+							originClickListener.onClick(view);
+						}
+					} else {
+						// 需要二次确认，弹出提示对话框
+						showCommitDialog();
+					}
+				}
+			});
+    }
+
+    /**
+     * 弹出操作确认对话框
+     * 标题：commitTitle  内容：commitInfo
+     * 取消：关闭弹窗无操作  确定：执行原始点击事件
+     */
+    private void showCommitDialog() {
+        Context context = getContext();
+        String dialogTitle = buttonModel.getCommitTitle();
+        String dialogMsg = buttonModel.getCommitInfo();
+
+        // 空值默认兜底处理
+        if (dialogTitle == null || "".equals(dialogTitle)) {
+            dialogTitle = "温馨提示";
+        }
+        if (dialogMsg == null || "".equals(dialogMsg)) {
+            dialogMsg = "确定要执行该操作吗？";
+        }
+
+        LogUtils.d(TAG, "弹出确认对话框，标题：" + dialogTitle);
+        new AlertDialog.Builder(context)
+			.setTitle(dialogTitle)
+			.setMessage(dialogMsg)
+			.setNegativeButton("取消", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+					LogUtils.d(TAG, "对话框点击取消，终止操作");
+				}
+			})
+			.setPositiveButton("确定", new DialogInterface.OnClickListener() {
+				@Override
+				public void onClick(DialogInterface dialog, int which) {
+					dialog.dismiss();
+					LogUtils.d(TAG, "对话框点击确定，继续执行操作");
+					if (originClickListener != null) {
+						originClickListener.onClick(TermuxButton.this);
+					}
+				}
+			})
+			.setCancelable(false)
+			.show();
+    }
+
+    //==================== Getter & Setter ====================
+    public TermuxButtonModel getButtonModel() {
+        return buttonModel;
+    }
+
+    /**
+     * 设置绑定按钮数据实体，自动刷新按钮展示文字
+     * @param buttonModel 数据实体类
+     */
+    public void setButtonModel(TermuxButtonModel buttonModel) {
+        this.buttonModel = buttonModel;
+        LogUtils.d(TAG, "外部设置ButtonModel，自动刷新按钮文本");
+        refreshButtonText();
+    }
+
+}
+
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/views/WinBoLLView.java b/winboll/src/main/java/cc/winboll/studio/winboll/views/WinBoLLView.java
new file mode 100644
index 0000000..d4dc6f5
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/views/WinBoLLView.java
@@ -0,0 +1,232 @@
+package cc.winboll.studio.winboll.views;
+
+import android.content.Context;
+import android.util.AttributeSet;
+import android.webkit.WebChromeClient;
+import android.webkit.WebResourceError;
+import android.webkit.WebResourceRequest;
+import android.webkit.WebSettings;
+import android.webkit.WebView;
+import android.webkit.WebViewClient;
+import android.widget.ProgressBar;
+
+/**
+ * @Author ZhanGSKen&豆包大模型<zhangsken@qq.com>
+ * @Date 2025/11/27 11:05
+ * @Describe 自定义WebView控件（WinBoLLView）
+ * 集成进度监听、页面加载控制、安全配置等核心能力
+ */
+public class WinBoLLView extends WebView {
+	public static final String TAG = "WinBoLLView";
+
+	private ProgressBar mProgressBar; // 页面加载进度条（可选，增强用户体验）
+	private OnPageStatusListener mStatusListener; // 页面状态监听回调
+	private boolean mIsLoading = false; // 自定义加载状态标记（替代系统isLoading()）
+
+	// 构造方法（兼容代码创建和XML布局引用）
+	public WinBoLLView(Context context) {
+		super(context);
+		initWebViewSettings();
+		initWebViewClient();
+	}
+
+	public WinBoLLView(Context context, AttributeSet attrs) {
+		super(context, attrs);
+		initWebViewSettings();
+		initWebViewClient();
+	}
+
+	public WinBoLLView(Context context, AttributeSet attrs, int defStyleAttr) {
+		super(context, attrs, defStyleAttr);
+		initWebViewSettings();
+		initWebViewClient();
+	}
+
+	/**
+	 * 初始化WebView基础配置（安全+性能+兼容性）
+	 */
+	private void initWebViewSettings() {
+		WebSettings settings = getSettings();
+
+		// 基础功能配置
+		settings.setJavaScriptEnabled(true); // 启用JS（根据需求决定是否开启）
+		settings.setSupportZoom(true); // 支持缩放
+		settings.setBuiltInZoomControls(true); // 显示缩放控件
+		settings.setDisplayZoomControls(false); // 隐藏系统缩放控件（优化UI）
+		settings.setLoadWithOverviewMode(true); // 自适应屏幕
+		settings.setUseWideViewPort(true); // 支持宽视角
+
+		// 缓存配置（提升加载速度）
+		settings.setCacheMode(WebSettings.LOAD_DEFAULT);
+		settings.setDomStorageEnabled(true); // 启用DOM存储
+		settings.setDatabaseEnabled(true); // 启用数据库存储
+
+		// 安全配置（防止XSS和恶意跳转）
+		settings.setJavaScriptCanOpenWindowsAutomatically(false); // 禁止JS自动打开窗口
+		setBackgroundColor(0x00000000); // 透明背景（避免白屏闪烁）
+
+		// 适配HTTPS和HTTP混合内容（Android 5.0+）
+		if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP) {
+			settings.setMixedContentMode(WebSettings.MIXED_CONTENT_COMPATIBILITY_MODE);
+		}
+	}
+
+	/**
+	 * 初始化WebViewClient和ChromeClient（控制页面加载和进度）
+	 */
+	private void initWebViewClient() {
+		// 控制页面跳转（不打开系统浏览器）
+		setWebViewClient(new WebViewClient() {
+				@Override
+				public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
+					// 拦截URL加载，使用当前WebView打开
+					view.loadUrl(request.getUrl().toString());
+					return true;
+				}
+
+				@Override
+				public void onPageStarted(WebView view, String url, android.graphics.Bitmap favicon) {
+					super.onPageStarted(view, url, favicon);
+					// 页面开始加载：更新自定义加载状态标记
+					mIsLoading = true;
+					// 更新进度条+回调状态
+					if (mProgressBar != null) mProgressBar.setVisibility(VISIBLE);
+					if (mStatusListener != null) mStatusListener.onPageStarted(url);
+				}
+
+				@Override
+				public void onPageFinished(WebView view, String url) {
+					super.onPageFinished(view, url);
+					// 页面加载完成：更新自定义加载状态标记
+					mIsLoading = false;
+					// 隐藏进度条+回调状态
+					if (mProgressBar != null) mProgressBar.setVisibility(GONE);
+					if (mStatusListener != null) mStatusListener.onPageFinished(url);
+				}
+
+				@Override
+				public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
+					super.onReceivedError(view, request, error);
+					// 页面加载错误：更新自定义加载状态标记
+					mIsLoading = false;
+					// 回调错误信息
+					if (mStatusListener != null) {
+						String errorMsg = error.getDescription().toString();
+						mStatusListener.onPageError(errorMsg);
+					}
+				}
+			});
+
+		// 监听页面加载进度
+		setWebChromeClient(new WebChromeClient() {
+				@Override
+				public void onProgressChanged(WebView view, int newProgress) {
+					super.onProgressChanged(view, newProgress);
+					// 更新进度条进度
+					if (mProgressBar != null) mProgressBar.setProgress(newProgress);
+				}
+			});
+	}
+
+	// ------------------- 对外暴露的控制方法（供Fragment调用） -------------------
+	/**
+	 * 加载URL（增加空值校验+优先HTTPS协议）
+	 */
+	public void loadUrlSafe(String url) {
+		if (url == null || url.trim().isEmpty()) {
+			if (mStatusListener != null) mStatusListener.onPageError("URL不能为空");
+			return;
+		}
+		// 协议补全：优先HTTPS，兼容HTTP（解决ERR_CLEARTEXT_NOT_PERMITTED）
+		if (!url.startsWith("http://") && !url.startsWith("https://")) {
+			url = "https://" + url; // 改为优先HTTPS，而非HTTP
+		}
+		super.loadUrl(url);
+	}
+	
+	/**
+	 * 刷新当前页面（使用自定义mIsLoading判断加载状态）
+	 */
+	public void refreshPage() {
+		if (mIsLoading) { // 替换原isLoading()，使用自定义标记
+			stopLoading(); // 若正在加载，先停止再刷新
+		}
+		reload();
+	}
+
+	/**
+	 * 停止页面加载（使用自定义mIsLoading判断加载状态）
+	 */
+	public void stopPageLoad() {
+		if (mIsLoading) { // 替换原isLoading()，使用自定义标记
+			stopLoading();
+			mIsLoading = false; // 停止后更新状态标记
+		}
+	}
+
+	/**
+	 * 前进（判断是否有前进历史）
+	 */
+	public boolean goForwardSafe() {
+		if (canGoForward()) {
+			goForward();
+			return true;
+		}
+		return false;
+	}
+
+	/**
+	 * 后退（判断是否有后退历史）
+	 */
+	public boolean goBackSafe() {
+		if (canGoBack()) {
+			goBack();
+			return true;
+		}
+		return false;
+	}
+
+	// ------------------- 辅助功能：进度条和状态监听 -------------------
+	/**
+	 * 设置进度条（绑定Fragment中的进度条控件）
+	 */
+	public void setProgressBar(ProgressBar progressBar) {
+		this.mProgressBar = progressBar;
+		if (mProgressBar != null) {
+			mProgressBar.setMax(100);
+			mProgressBar.setVisibility(GONE);
+		}
+	}
+
+	/**
+	 * 设置页面状态监听（供Fragment接收加载状态）
+	 */
+	public void setOnPageStatusListener(OnPageStatusListener listener) {
+		this.mStatusListener = listener;
+	}
+
+	/**
+	 * 页面状态监听接口
+	 */
+	public interface OnPageStatusListener {
+		void onPageStarted(String url); // 页面开始加载
+		void onPageFinished(String url); // 页面加载完成
+		void onPageError(String errorMsg); // 页面加载错误
+	}
+
+	// ------------------- 资源释放（防止内存泄漏） -------------------
+	/**
+	 * 销毁WebView（必须在Fragment销毁时调用）
+	 */
+	public void destroyWebView() {
+		// 停止加载并清空历史
+		stopLoading();
+		mIsLoading = false; // 销毁时重置加载状态
+		clearHistory();
+		// 移除所有WebViewClient（避免内存泄漏）
+		setWebViewClient(null);
+		setWebChromeClient(null);
+		// 销毁WebView
+		destroy();
+	}
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/widgets/APPNewsWidget.java b/winboll/src/main/java/cc/winboll/studio/winboll/widgets/APPNewsWidget.java
new file mode 100644
index 0000000..4796898
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/widgets/APPNewsWidget.java
@@ -0,0 +1,185 @@
+package cc.winboll.studio.winboll.widgets;
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/15 14:41:25
+ * @Describe TimeWidget
+ */
+import android.app.PendingIntent;
+import android.appwidget.AppWidgetManager;
+import android.appwidget.AppWidgetProvider;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.widget.RemoteViews;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.winboll.WinBoLL;
+import cc.winboll.studio.winboll.models.WinBoLLModel;
+import cc.winboll.studio.winboll.models.WinBoLLNewsBean;
+import cc.winboll.studio.winboll.receivers.APPNewsWidgetClickListener;
+import java.io.IOException;
+import java.text.SimpleDateFormat;
+import java.util.ArrayList;
+import java.util.Date;
+
+public class APPNewsWidget extends AppWidgetProvider {
+
+    public static final String TAG = "APPNewsWidget";
+    
+    public static final String ACTION_WAKEUP_SERVICE = APPNewsWidget.class.getName() + ".ACTION_WAKEUP_SERVICE";
+    public static final String ACTION_RELOAD_REPORT = APPNewsWidget.class.getName() + ".ACTION_RELOAD_REPORT";
+
+
+    volatile static ArrayList<WinBoLLNewsBean> _WinBoLLNewsBeanList;
+    final static int _MAX_PAGES = 10;
+    final static int _OnePageLinesCount = 5;
+    volatile static int _CurrentPageIndex = 0;
+
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        initWinBoLLNewsBeanList(context);
+        for (int appWidgetId : appWidgetIds) {
+            updateAppWidget(context, appWidgetManager, appWidgetId);
+        }
+    }
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        super.onReceive(context, intent);
+        initWinBoLLNewsBeanList(context);
+        if (intent.getAction().equals(ACTION_RELOAD_REPORT)) {
+            LogUtils.d(TAG, "ACTION_RELOAD_REPORT");
+            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
+            int[] appWidgetIds = appWidgetManager.getAppWidgetIds(new ComponentName(context, APPNewsWidget.class));
+            for (int appWidgetId : appWidgetIds) {
+                updateAppWidget(context, appWidgetManager, appWidgetId);
+            }
+        }else if (intent.getAction().equals(ACTION_WAKEUP_SERVICE)) {
+//            LogUtils.d(TAG, "ACTION_WAKEUP_SERVICE");
+//            String szWinBoLLModel = intent.getStringExtra(WinBoLL.EXTRA_WINBOLLMODEL);
+//            LogUtils.d(TAG, String.format("szWinBoLLModel %s", szWinBoLLModel));
+//            if (szWinBoLLModel != null && !szWinBoLLModel.equals("")) {
+//                try {
+//                    WinBoLLModel bean = WinBoLLModel.parseStringToBean(szWinBoLLModel, WinBoLLModel.class);
+//                    if (bean != null) {
+//                        String szAppPackageName = bean.getAppPackageName();
+//                        LogUtils.d(TAG, String.format("szAppPackageName %s", szAppPackageName));
+//                        String szAppMainServiveName = bean.getAppMainServiveName();
+//                        LogUtils.d(TAG, String.format("szAppMainServiveName %s", szAppMainServiveName));
+//
+//                        
+//                        String appName = AppUtils.getAppNameByPackageName(context, szAppPackageName);
+//                        LogUtils.d(TAG, String.format("appName %s", appName));
+//                        WinBoLLNewsBean winBollNewsBean = new WinBoLLNewsBean(appName);
+//                        SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss");
+//                        String currentTime = sdf.format(new Date());
+//                        StringBuilder sbLine = new StringBuilder();
+//                        sbLine.append("[");
+//                        sbLine.append(currentTime);
+//                        sbLine.append("] Wake up ");
+//                        sbLine.append(appName);
+//                        winBollNewsBean.setMessage(sbLine.toString());
+//                        
+//                        addWinBoLLNewsBean(context, winBollNewsBean);
+//
+//                        AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
+//                        int[] appWidgetIds = appWidgetManager.getAppWidgetIds(new ComponentName(context, APPNewsWidget.class));
+//                        for (int appWidgetId : appWidgetIds) {
+//                            updateAppWidget(context, appWidgetManager, appWidgetId);
+//                        }
+//                    }
+//                } catch (IOException e) {
+//                    LogUtils.d(TAG, e, Thread.currentThread().getStackTrace());
+//                }
+//            }
+        }
+    }
+
+    //
+    // 加入新报告信息
+    //
+    public synchronized static void addWinBoLLNewsBean(Context context, WinBoLLNewsBean bean) {
+        initWinBoLLNewsBeanList(context);
+        _WinBoLLNewsBeanList.add(0, bean);
+        // 控制记录总数
+        while (_WinBoLLNewsBeanList.size() > _MAX_PAGES * _OnePageLinesCount) {
+            _WinBoLLNewsBeanList.remove(_WinBoLLNewsBeanList.size() - 1);
+        }
+        WinBoLLNewsBean.saveBeanList(context, _WinBoLLNewsBeanList, WinBoLLNewsBean.class);
+    }
+
+    synchronized static void initWinBoLLNewsBeanList(Context context) {
+        if (_WinBoLLNewsBeanList == null) {
+            _WinBoLLNewsBeanList = new ArrayList<WinBoLLNewsBean>();
+            WinBoLLNewsBean.loadBeanList(context, _WinBoLLNewsBeanList, WinBoLLNewsBean.class);
+        }
+        if (_WinBoLLNewsBeanList == null) {
+            _WinBoLLNewsBeanList = new ArrayList<WinBoLLNewsBean>();
+            WinBoLLNewsBean.saveBeanList(context, _WinBoLLNewsBeanList, WinBoLLNewsBean.class);
+        }
+    }
+
+    private void updateAppWidget(Context context, AppWidgetManager appWidgetManager, int appWidgetId) {
+        LogUtils.d(TAG, "updateAppWidget(...)");
+
+        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_news);
+        //设置按钮点击事件
+        Intent intentPre = new Intent(context, APPNewsWidgetClickListener.class);
+        intentPre.setAction(APPNewsWidgetClickListener.ACTION_PRE);
+        PendingIntent pendingIntentPre = PendingIntent.getBroadcast(context, 0, intentPre, PendingIntent.FLAG_UPDATE_CURRENT);
+        views.setOnClickPendingIntent(R.id.widget_button_pre, pendingIntentPre);
+        Intent intentNext = new Intent(context, APPNewsWidgetClickListener.class);
+        intentNext.setAction(APPNewsWidgetClickListener.ACTION_NEXT);
+        PendingIntent pendingIntentNext = PendingIntent.getBroadcast(context, 0, intentNext, PendingIntent.FLAG_UPDATE_CURRENT);
+        views.setOnClickPendingIntent(R.id.widget_button_next, pendingIntentNext);
+
+        views.setTextViewText(R.id.tv_msg, getPageInfo());
+        views.setTextViewText(R.id.tv_news, getMessage());
+        appWidgetManager.updateAppWidget(appWidgetId, views);
+    }
+
+    public static String getMessage() {
+        ArrayList<String> msgTemp = new ArrayList<String>();
+        if (_WinBoLLNewsBeanList != null) {
+            int start = _OnePageLinesCount * _CurrentPageIndex;
+            start = _WinBoLLNewsBeanList.size() > start ? start : _WinBoLLNewsBeanList.size() - 1;
+            for (int i = start, j = 0; i < _WinBoLLNewsBeanList.size() && j < _OnePageLinesCount && start > -1; i++, j++) {
+                msgTemp.add(_WinBoLLNewsBeanList.get(i).getMessage());
+            }
+            String message = String.join("\n", msgTemp);
+            return message;
+        }
+        return "";
+    }
+
+    public static void prePage(Context context) {
+        if (_WinBoLLNewsBeanList != null) {
+            if (_CurrentPageIndex > 0) {
+                _CurrentPageIndex = _CurrentPageIndex - 1;
+            }
+            Intent intentWidget = new Intent(context, APPNewsWidget.class);
+            intentWidget.setAction(APPNewsWidget.ACTION_RELOAD_REPORT);
+            context.sendBroadcast(intentWidget);
+        }
+    }
+
+    public static void nextPage(Context context) {
+        if (_WinBoLLNewsBeanList != null) {
+            if ((_CurrentPageIndex + 1) * _OnePageLinesCount < _WinBoLLNewsBeanList.size()) {
+                _CurrentPageIndex = _CurrentPageIndex + 1;
+            }
+            Intent intentWidget = new Intent(context, APPNewsWidget.class);
+            intentWidget.setAction(APPNewsWidget.ACTION_RELOAD_REPORT);
+            context.sendBroadcast(intentWidget);
+        }
+    }
+
+    String getPageInfo() {
+        if (_WinBoLLNewsBeanList == null) {
+            return "0/0";
+        }
+        int leftCount = _WinBoLLNewsBeanList.size() % _OnePageLinesCount;
+        int currentPageCount = _WinBoLLNewsBeanList.size() / _OnePageLinesCount + (leftCount == 0 ?0: 1);
+        return String.format("%d/%d", _CurrentPageIndex + 1, currentPageCount);
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/widgets/StatusWidget.java b/winboll/src/main/java/cc/winboll/studio/winboll/widgets/StatusWidget.java
new file mode 100644
index 0000000..454a78b
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/widgets/StatusWidget.java
@@ -0,0 +1,59 @@
+package cc.winboll.studio.winboll.widgets;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/17 20:32:12
+ */
+import android.app.PendingIntent;
+import android.appwidget.AppWidgetManager;
+import android.appwidget.AppWidgetProvider;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.widget.RemoteViews;
+import cc.winboll.studio.winboll.R;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class StatusWidget extends AppWidgetProvider {
+
+    public static final String TAG = "StatusWidget";
+
+    public static final String ACTION_STATUS_UPDATE = "cc.winboll.studio.libappbase.widgets.APPWidget.ACTION_STATUS_UPDATE";
+
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        for (int appWidgetId : appWidgetIds) {
+            updateAppWidget(context, appWidgetManager, appWidgetId);
+        }
+    }
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        super.onReceive(context, intent);
+        if (intent.getAction().equals(ACTION_STATUS_UPDATE)) {
+            ToastUtils.show("Test");
+            AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
+            int[] appWidgetIds = appWidgetManager.getAppWidgetIds(new ComponentName(context, StatusWidget.class));
+            for (int appWidgetId : appWidgetIds) {
+                updateAppWidget(context, appWidgetManager, appWidgetId);
+            }
+        }
+    }
+
+    private void updateAppWidget(Context context, AppWidgetManager appWidgetManager, int appWidgetId) {
+        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_status);
+        //设置按钮点击事件
+        Intent intentAppButton = new Intent(context, StatusWidgetClickListener.class);
+        intentAppButton.setAction(StatusWidgetClickListener.ACTION_IVAPP);
+        PendingIntent pendingIntentAppButton = PendingIntent.getBroadcast(context, 0, intentAppButton, PendingIntent.FLAG_UPDATE_CURRENT);
+        views.setOnClickPendingIntent(R.id.ivapp, pendingIntentAppButton);
+
+//        boolean isActive = ServiceUtils.isServiceRunning(context, TestService.class.getName());
+//        if (isActive) {
+//            views.setImageViewResource(R.id.ivapp, cc.winboll.studio.libappbase.R.drawable.ic_launcher);
+//        } else {
+//            views.setImageViewResource(R.id.ivapp, cc.winboll.studio.libappbase.R.drawable.ic_launcher_disable);
+//        }
+        appWidgetManager.updateAppWidget(appWidgetId, views);
+    }
+}
diff --git a/winboll/src/main/java/cc/winboll/studio/winboll/widgets/StatusWidgetClickListener.java b/winboll/src/main/java/cc/winboll/studio/winboll/widgets/StatusWidgetClickListener.java
new file mode 100644
index 0000000..ae182ce
--- /dev/null
+++ b/winboll/src/main/java/cc/winboll/studio/winboll/widgets/StatusWidgetClickListener.java
@@ -0,0 +1,33 @@
+package cc.winboll.studio.winboll.widgets;
+
+/**
+ * @Author ZhanGSKen<zhangsken@qq.com>
+ * @Date 2025/02/17 20:33:53
+ * @Describe APPWidgetClickListener
+ */
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import cc.winboll.studio.libappbase.LogUtils;
+import cc.winboll.studio.libappbase.ToastUtils;
+
+public class StatusWidgetClickListener extends BroadcastReceiver {
+    
+    public static final String TAG = "APPWidgetClickListener";
+
+    public static final String ACTION_IVAPP = "cc.winboll.studio.libappbase.widgets.StatusWidgetClickListener.ACTION_IVAPP";
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        String action = intent.getAction();
+        if (action == null) {
+            LogUtils.d(TAG, String.format("action %s", action));
+            return;
+        }
+        if (action.equals(ACTION_IVAPP)) {
+            ToastUtils.show("ACTION_LAUNCHER");
+        } else {
+            LogUtils.d(TAG, String.format("action %s", action));
+        }
+    }
+}
diff --git a/winboll/src/main/res/drawable/bg_browser_top.xml b/winboll/src/main/res/drawable/bg_browser_top.xml
new file mode 100644
index 0000000..4762398
--- /dev/null
+++ b/winboll/src/main/res/drawable/bg_browser_top.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="@android:color/white"/>
+    <corners android:radius="8dp"/>
+    <stroke android:color="@android:color/darker_gray" android:width="1dp"/>
+</shape>
diff --git a/winboll/src/main/res/drawable/bg_container_border.xml b/winboll/src/main/res/drawable/bg_container_border.xml
new file mode 100644
index 0000000..09c5bdf
--- /dev/null
+++ b/winboll/src/main/res/drawable/bg_container_border.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@android:color/transparent" />
+    <stroke android:width="1dp" android:color="#FFB0B0B0" />
+    <corners android:radius="?attr/borderCornerRadius" />
+</shape>
diff --git a/winboll/src/main/res/drawable/bg_edittext.xml b/winboll/src/main/res/drawable/bg_edittext.xml
new file mode 100644
index 0000000..5bf8014
--- /dev/null
+++ b/winboll/src/main/res/drawable/bg_edittext.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <solid android:color="@android:color/white"/>
+    <corners android:radius="24dp"/>
+    <stroke android:color="@android:color/darker_gray" android:width="1dp"/>
+</shape>
diff --git a/winboll/src/main/res/drawable/bg_shadow.xml b/winboll/src/main/res/drawable/bg_shadow.xml
new file mode 100644
index 0000000..6d3d898
--- /dev/null
+++ b/winboll/src/main/res/drawable/bg_shadow.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?> 
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
+    <!-- 阴影部分 --> 
+    <!-- 个人觉得更形象的表达：top代表下边的阴影高度，left代表右边的阴影宽度。其实也就是相对应的offset，solid中的颜色是阴影的颜色，也可以设置角度等等 --> 
+    <item 
+        android:left="2dp" 
+        android:top="2dp" 
+        android:right="2dp" 
+        android:bottom="2dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="#0F000000" 
+                android:startColor="#0F000000" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+    <!-- 背景部分 --> 
+    <!-- 形象的表达：bottom代表背景部分在上边缘超出阴影的高度，right代表背景部分在左边超出阴影的宽度（相对应的offset） --> 
+    <item 
+        android:left="3dp" 
+        android:top="3dp" 
+        android:right="3dp" 
+        android:bottom="5dp"> 
+        <shape android:shape="rectangle" > 
+            <gradient 
+                android:angle="270" 
+                android:endColor="@color/colorAccent" 
+                android:startColor="@color/colorAccent" /> 
+            <corners 
+                android:bottomLeftRadius="6dip" 
+                android:bottomRightRadius="6dip" 
+                android:topLeftRadius="6dip" 
+                android:topRightRadius="6dip" /> 
+        </shape> 
+    </item> 
+</layer-list>
diff --git a/winboll/src/main/res/drawable/dot_background.xml b/winboll/src/main/res/drawable/dot_background.xml
new file mode 100644
index 0000000..f9fc6fc
--- /dev/null
+++ b/winboll/src/main/res/drawable/dot_background.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="ring"
+    android:innerRadiusRatio="3"
+    android:thicknessRatio="8"
+    android:useLevel="false">
+    <solid android:color="#00000000"/>
+</shape>
diff --git a/winboll/src/main/res/drawable/dot_darkgreen_dark.xml b/winboll/src/main/res/drawable/dot_darkgreen_dark.xml
new file mode 100644
index 0000000..25f65b4
--- /dev/null
+++ b/winboll/src/main/res/drawable/dot_darkgreen_dark.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<inset xmlns:android="http://schemas.android.com/apk/res/android"
+    android:insetLeft="2dp"
+    android:insetTop="2dp"
+    android:insetRight="2dp"
+    android:insetBottom="2dp">
+    <shape android:shape="ring"
+        android:innerRadiusRatio="2"
+        android:thicknessRatio="2.5"
+        android:useLevel="false">
+        <solid android:color="#006400"/>
+        <stroke android:width="1dp" android:color="#006400"/>
+    </shape>
+</inset>
diff --git a/winboll/src/main/res/drawable/ic_cloud.xml b/winboll/src/main/res/drawable/ic_cloud.xml
new file mode 100644
index 0000000..c116648
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_cloud.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M6.5,20Q4.22,20 2.61,18.43 1,16.85 1,14.58 1,12.63 2.17,11.1 3.35,9.57 5.25,9.15 5.88,6.85 7.75,5.43 9.63,4 12,4 14.93,4 16.96,6.04 19,8.07 19,11 20.73,11.2 21.86,12.5 23,13.78 23,15.5 23,17.38 21.69,18.69 20.38,20 18.5,20Z"/>
+
+</vector>
diff --git a/winboll/src/main/res/drawable/ic_cloud_outline.xml b/winboll/src/main/res/drawable/ic_cloud_outline.xml
new file mode 100644
index 0000000..a8ed00c
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_cloud_outline.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportHeight="24"
+    android:viewportWidth="24">
+    <path
+        android:fillColor="#ff000000"
+        android:pathData="M6.5,20Q4.22,20 2.61,18.43 1,16.85 1,14.58 1,12.63 2.17,11.1 3.35,9.57 5.25,9.15 5.88,6.85 7.75,5.43 9.63,4 12,4 14.93,4 16.96,6.04 19,8.07 19,11 20.73,11.2 21.86,12.5 23,13.78 23,15.5 23,17.38 21.69,18.69 20.38,20 18.5,20M6.5,18H18.5Q19.55,18 20.27,17.27 21,16.55 21,15.5 21,14.45 20.27,13.73 19.55,13 18.5,13H17V11Q17,8.93 15.54,7.46 14.08,6 12,6 9.93,6 8.46,7.46 7,8.93 7,11H6.5Q5.05,11 4.03,12.03 3,13.05 3,14.5 3,15.95 4.03,17 5.05,18 6.5,18M12,12Z"/>
+
+</vector>
diff --git a/winboll/src/main/res/drawable/ic_launcher.xml b/winboll/src/main/res/drawable/ic_launcher.xml
new file mode 100644
index 0000000..21f28b1
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_launcher.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true">
+    <item
+        android:width="256dp"
+        android:height="256dp"
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/ic_winboll_logo">
+    </item>
+</layer-list>
diff --git a/winboll/src/main/res/drawable/ic_launcher_background.xml b/winboll/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 0000000..d5fccc5
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8" />
+</vector>
diff --git a/winboll/src/main/res/drawable/ic_launcher_beta.xml b/winboll/src/main/res/drawable/ic_launcher_beta.xml
new file mode 100644
index 0000000..3dd7f33
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_launcher_beta.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
+    android:clickable="true"
+    android:layout_width="48dp"
+    android:layout_height="48dp">
+    <item android:drawable="@drawable/ic_launcher_background"/> 
+    <item 
+        android:left="0dp" 
+        android:top="0dp" 
+        android:right="0dp" 
+        android:bottom="0dp"
+        android:drawable="@drawable/ic_launcher"/>
+</layer-list>
diff --git a/winboll/src/main/res/drawable/ic_winboll_help.xml b/winboll/src/main/res/drawable/ic_winboll_help.xml
new file mode 100644
index 0000000..564175f
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_winboll_help.xml
@@ -0,0 +1,27 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FF000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+</vector>
diff --git a/winboll/src/main/res/drawable/ic_winboll_jindouyun1.png b/winboll/src/main/res/drawable/ic_winboll_jindouyun1.png
new file mode 100644
index 0000000..6b4c005
Binary files /dev/null and b/winboll/src/main/res/drawable/ic_winboll_jindouyun1.png differ
diff --git a/winboll/src/main/res/drawable/ic_winboll_jindouyun2.png b/winboll/src/main/res/drawable/ic_winboll_jindouyun2.png
new file mode 100644
index 0000000..6f4efa0
Binary files /dev/null and b/winboll/src/main/res/drawable/ic_winboll_jindouyun2.png differ
diff --git a/winboll/src/main/res/drawable/ic_winboll_log.xml b/winboll/src/main/res/drawable/ic_winboll_log.xml
new file mode 100644
index 0000000..011f2b2
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_winboll_log.xml
@@ -0,0 +1,41 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M151.49 130.96C151.49 130.96 348.53 130.96 348.53 130.96 348.53 130.96 348.53 393.46 348.53 393.46 348.53 393.46 151.49 393.46 151.49 393.46 151.49 393.46 151.49 130.96 151.49 130.96"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M186.28 207.75C186.28 207.75 304.95 207.75 304.95 207.75 304.95 207.75 304.95 205.97 304.95 205.97 304.95 205.97 186.28 205.97 186.28 205.97 186.28 205.97 186.28 207.75 186.28 207.75"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M186.28 263.52C186.28 263.52 304.95 263.52 304.95 263.52 304.95 263.52 304.95 264.41 304.95 264.41 304.95 264.41 186.28 264.41 186.28 264.41 186.28 264.41 186.28 263.52 186.28 263.52"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M186.28 323.62C186.28 323.62 304.95 323.62 304.95 323.62 304.95 323.62 304.95 320.62 304.95 320.62 304.95 320.62 186.28 320.62 186.28 320.62 186.28 320.62 186.28 323.62 186.28 323.62"/>
+</vector>
diff --git a/winboll/src/main/res/drawable/ic_winboll_logo.xml b/winboll/src/main/res/drawable/ic_winboll_logo.xml
new file mode 100644
index 0000000..ea28987
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_winboll_logo.xml
@@ -0,0 +1,48 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FF000000"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M103.77 307.45C103.02 293.07 104.03 271.24 129.24 248.85 135.25 243.52 141.74 239.48 147.89 236.44 160.24 230.34 171.23 228.28 174.15 227.92 174.31 227.9 174.44 227.89 174.55 227.88 174.66 227.87 174.75 227.86 174.81 227.86 176.62 227.85 216.5 230.02 234.65 253.79 253.9 278.99 266.43 314.66 221.67 356.93 184.69 391.85 179.97 411.36 180.15 411.08"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M248.17 309.83C247.43 295.45 248.43 273.62 273.64 251.23 279.65 245.9 286.14 241.86 292.29 238.82 304.65 232.72 315.63 230.65 318.55 230.3 318.71 230.28 318.84 230.27 318.95 230.26 319.06 230.25 319.15 230.24 319.21 230.24 321.02 230.22 360.9 232.4 379.06 256.17 398.3 281.37 410.83 317.04 366.08 359.31 329.09 394.23 324.37 413.74 324.55 413.46"/>
+    <path
+        android:fillColor="#00000000"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="30.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M182.16 214.09C181.42 199.71 182.42 177.87 207.64 155.49 213.64 150.16 220.13 146.12 226.28 143.08 238.64 136.97 249.62 134.91 252.55 134.56 252.7 134.54 252.83 134.53 252.94 134.52 253.05 134.51 253.14 134.5 253.2 134.5 255.01 134.48 294.9 136.66 313.05 160.43 332.29 185.63 344.82 221.3 300.07 263.56 263.08 298.49 258.36 318 258.54 317.72"/>
+</vector>
diff --git a/winboll/src/main/res/drawable/ic_winboll_point.xml b/winboll/src/main/res/drawable/ic_winboll_point.xml
new file mode 100644
index 0000000..48028cc
--- /dev/null
+++ b/winboll/src/main/res/drawable/ic_winboll_point.xml
@@ -0,0 +1,20 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="512dp"
+    android:height="512dp"
+    android:viewportWidth="512"
+    android:viewportHeight="512">
+    <path
+        android:fillColor="#FF1E9B54"
+        android:strokeColor="#FFF8E733"
+        android:strokeWidth="20.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M254.63 35.45C374.95 35.45 473.38 133.89 473.38 254.2 473.38 374.51 374.95 472.95 254.63 472.95 134.32 472.95 35.88 374.51 35.88 254.2 35.88 133.89 134.32 35.45 254.63 35.45"/>
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:strokeColor="#FFFFFFFF"
+        android:strokeWidth="1.0"
+        android:strokeLineCap="round"
+        android:strokeMiterLimit="10"
+        android:pathData="M257.28 361.25C266.56 361.25 274.14 368.84 274.14 378.11 274.14 387.39 266.56 394.98 257.28 394.98 248.01 394.98 240.42 387.39 240.42 378.11 240.42 368.84 248.01 361.25 257.28 361.25"/>
+</vector>
diff --git a/winboll/src/main/res/drawable/progress_bar_style.xml b/winboll/src/main/res/drawable/progress_bar_style.xml
new file mode 100644
index 0000000..7e8f8a3
--- /dev/null
+++ b/winboll/src/main/res/drawable/progress_bar_style.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:id="@android:id/background" android:drawable="@android:color/darker_gray"/>
+    <item android:id="@android:id/progress">
+        <clip android:drawable="@android:color/holo_blue_light"/>
+    </item>
+</layer-list>
+
diff --git a/winboll/src/main/res/drawable/shape_gradient.xml b/winboll/src/main/res/drawable/shape_gradient.xml
new file mode 100644
index 0000000..c164fe9
--- /dev/null
+++ b/winboll/src/main/res/drawable/shape_gradient.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android">
+    <gradient
+        android:angle="180"
+        android:endColor="#FFFFFFFF"
+        android:startColor="#FFFFFFFF"
+        android:type="linear" />
+
+    <corners android:radius="10dp" />
+</shape>
diff --git a/winboll/src/main/res/drawable/view_border.xml b/winboll/src/main/res/drawable/view_border.xml
new file mode 100644
index 0000000..58b374a
--- /dev/null
+++ b/winboll/src/main/res/drawable/view_border.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <stroke
+        android:width="1dp"
+        android:color="#000000" /> <!-- 这里可调整边框宽度和颜色 -->
+    <solid android:color="@android:color/transparent" />
+</shape>
diff --git a/winboll/src/main/res/layout/activity_about.xml b/winboll/src/main/res/layout/activity_about.xml
new file mode 100644
index 0000000..b38ba39
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_about.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+	<cc.winboll.studio.libappbase.views.AboutView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:id="@+id/aboutview"/>
+
+</LinearLayout>
diff --git a/winboll/src/main/res/layout/activity_logon.xml b/winboll/src/main/res/layout/activity_logon.xml
new file mode 100644
index 0000000..2a2c2d1
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_logon.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+    <LinearLayout
+        android:orientation="horizontal"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_gravity="right"
+        android:gravity="right"
+        android:padding="10dp"
+        android:id="@+id/ll_hostbar">
+
+        <RadioButton
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="10.8.0.250:456"
+            android:id="@+id/rb_debughost"
+            android:onClick="onSwitchHost"/>
+
+        <RadioButton
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="yun.winboll.cc"
+            android:id="@+id/rb_yunhost"
+            android:onClick="onSwitchHost"/>
+
+	</LinearLayout>
+    
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="right">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Test RSA"
+            android:onClick="onTestRSA"/>
+
+        <Button
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="Test Login"
+            android:onClick="onTestLogin"/>
+        
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<cc.winboll.studio.libappbase.LogView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/logview"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_main.xml b/winboll/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..60d6fd3
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_main.xml
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical">
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:gravity="center_vertical|center_horizontal">
+
+		<TextView
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Hello, WinBoLL!"
+			android:textAppearance="?android:attr/textAppearanceLarge"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<cc.winboll.studio.libappbase.LogView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/logview"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_my_termux.xml b/winboll/src/main/res/layout/activity_my_termux.xml
new file mode 100644
index 0000000..f7417f5
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_my_termux.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<androidx.appcompat.widget.Toolbar
+		android:id="@+id/toolbar"
+		android:layout_width="match_parent"
+		android:layout_height="?attr/actionBarSize"
+		android:background="?attr/colorPrimary"
+		app:title="@string/app_name"
+		app:subtitle="@string/my_termux_activity"
+		app:titleTextColor="@android:color/white"
+		app:subtitleTextColor="@android:color/white"/>
+
+	<ListView
+		android:id="@+id/list_termux_buttons"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0"
+		android:divider="@android:color/darker_gray"
+		android:dividerHeight="1dp"/>
+
+	<Button
+		android:id="@+id/btn_add_termux_button"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:text="@string/add_termux_button"
+		android:textSize="16sp"
+		android:padding="12dp"/>
+
+</LinearLayout>
diff --git a/winboll/src/main/res/layout/activity_new.xml b/winboll/src/main/res/layout/activity_new.xml
new file mode 100644
index 0000000..23a1122
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_new.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+    <androidx.appcompat.widget.Toolbar
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+    
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="NewActivity"/>
+
+    <Button
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="CloseThisActivity"
+        android:textAllCaps="false"
+        android:onClick="onCloseThisActivity"/>
+
+    <Button
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="CloseAllActivity"
+        android:textAllCaps="false"
+        android:onClick="onCloseAllActivity"/>
+
+    <Button
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="New2Activity"
+        android:textAllCaps="false"
+        android:onClick="onNew2Activity"/>
+
+    
+    
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_new2.xml b/winboll/src/main/res/layout/activity_new2.xml
new file mode 100644
index 0000000..8d9b4e5
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_new2.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+    <androidx.appcompat.widget.Toolbar
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+	<TextView
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="New2Activity"/>
+
+	<Button
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="CloseThisActivity"
+		android:textAllCaps="false"
+		android:onClick="onCloseThisActivity"/>
+
+	<Button
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="CloseAllActivity"
+		android:textAllCaps="false"
+		android:onClick="onCloseAllActivity"/>
+
+	<Button
+		android:layout_width="wrap_content"
+		android:layout_height="wrap_content"
+		android:text="NewActivity"
+		android:textAllCaps="false"
+		android:onClick="onNewActivity"/>
+
+	
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_ollama_window.xml b/winboll/src/main/res/layout/activity_ollama_window.xml
new file mode 100644
index 0000000..0d6c7ed
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_ollama_window.xml
@@ -0,0 +1,206 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="#1E1E1E">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:orientation="vertical">
+
+        <androidx.core.widget.NestedScrollView
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:layout_marginTop="48dp"
+            android:layout_marginBottom="48dp">
+
+            <LinearLayout
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:orientation="vertical"
+                android:padding="16dp">
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="Ollama 模型对话"
+                    android:textColor="#FFFFFF"
+                    android:textSize="18sp"
+                    android:textStyle="bold" />
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="16dp"
+                    android:orientation="vertical">
+
+                    <TextView
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:text="系统提示："
+                        android:textColor="#B0B0B0" />
+
+                    <EditText
+                        android:id="@+id/etSystemPrompt"
+                        android:layout_width="match_parent"
+                        android:layout_height="100dp"
+                        android:background="#2D2D2D"
+                        android:hint="请输入系统提示"
+                        android:textColor="#FFFFFF"
+                        android:textColorHint="#666666"
+                        android:gravity="top|start"
+                        android:inputType="textMultiLine" />
+
+                </LinearLayout>
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="16dp"
+                    android:text="模型名称："
+                    android:textColor="#B0B0B0" />
+
+                <EditText
+                    android:id="@+id/etModelName"
+                    android:layout_width="match_parent"
+                    android:layout_height="48dp"
+                    android:background="#2D2D2D"
+                    android:hint="llama3"
+                    android:text="llama3"
+                    android:textColor="#FFFFFF"
+                    android:textColorHint="#666666"
+                    android:singleLine="true" />
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="16dp"
+                    android:text="温度设置："
+                    android:textColor="#B0B0B0" />
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="horizontal"
+                    android:weightSum="2">
+
+                    <EditText
+                        android:id="@+id/etTemperature"
+                        android:layout_width="0dp"
+                        android:layout_height="48dp"
+                        android:layout_weight="1"
+                        android:background="#2D2D2D"
+                        android:hint="0.7"
+                        android:textColor="#FFFFFF"
+                        android:textColorHint="#666666"
+                        android:digits="0123456789.,-"
+                        android:singleLine="true" />
+
+                    <EditText
+                        android:id="@+id/etMaxTokens"
+                        android:layout_width="0dp"
+                        android:layout_height="48dp"
+                        android:layout_weight="1"
+                        android:background="#2D2D2D"
+                        android:hint="4096"
+                        android:textColor="#FFFFFF"
+                        android:textColorHint="#666666"
+                        android:digits="0123456789."
+                        android:singleLine="true" />
+
+                </LinearLayout>
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="16dp"
+                    android:text="系统消息："
+                    android:textColor="#B0B0B0" />
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:orientation="vertical">
+
+                    <TextView
+                        android:layout_width="wrap_content"
+                        android:layout_height="wrap_content"
+                        android:layout_marginBottom="8dp"
+                        android:text="用户消息："
+                        android:textColor="#B0B0B0" />
+
+                    <EditText
+                        android:id="@+id/etUserMessage"
+                        android:layout_width="match_parent"
+                        android:layout_height="120dp"
+                        android:background="#2D2D2D"
+                        android:ems="10"
+                        android:gravity="top|start"
+                        android:hint="输入你要发送的消息..."
+                        android:inputType="textMultiLine" />
+
+                </LinearLayout>
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="16dp"
+                    android:text="响应消息："
+                    android:textColor="#B0B0B0" />
+
+                <LinearLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content">
+
+                    <EditText
+                        android:id="@+id/etAssistantMessage"
+                        android:layout_width="0dp"
+                        android:layout_height="120dp"
+                        android:layout_weight="3"
+                        android:background="#2D2D2D"
+                        android:gravity="top|start"
+                        android:hint="模型响应将显示在这里..."
+                        android:inputType="textMultiLine" />
+
+                    <Button
+                        android:id="@+id/btnClear"
+                        android:layout_width="0dp"
+                        android:layout_height="wrap_content"
+                        android:layout_weight="1"
+                        android:layout_marginStart="8dp"
+                        android:text="清空"
+                        android:textColor="#FFFFFF" />
+
+                </LinearLayout>
+
+            </LinearLayout>
+
+        </androidx.core.widget.NestedScrollView>
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginBottom="48dp"
+            android:gravity="center">
+
+            <Button
+                android:id="@+id/btnSend"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="发送"
+                android:textSize="18sp" />
+
+            <Button
+                android:id="@+id/btnStop"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:layout_marginStart="16dp"
+                android:text="停止"
+                android:textSize="18sp" />
+
+        </LinearLayout>
+
+    </LinearLayout>
+
+</FrameLayout>
diff --git a/winboll/src/main/res/layout/activity_pattern_lock.xml b/winboll/src/main/res/layout/activity_pattern_lock.xml
new file mode 100644
index 0000000..2298d46
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_pattern_lock.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:background="@android:color/black">
+
+	<androidx.appcompat.widget.Toolbar
+		android:id="@+id/toolbar"
+		android:layout_width="match_parent"
+		android:layout_height="?attr/actionBarSize"
+		android:background="?attr/colorPrimary"
+		android:gravity="center"
+		app:titleTextColor="@android:color/white"
+		app:subtitleTextColor="@android:color/white"/>
+
+	<FrameLayout
+		android:id="@+id/container"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:background="#FFFFFF"/>
+
+</LinearLayout>
diff --git a/winboll/src/main/res/layout/activity_settings.xml b/winboll/src/main/res/layout/activity_settings.xml
new file mode 100644
index 0000000..b0da872
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_settings.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+    <cc.winboll.studio.libaes.views.ADsControlView
+		android:id="@+id/ads_control_view"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content" />
+	
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_termux_env_test.xml b/winboll/src/main/res/layout/activity_termux_env_test.xml
new file mode 100644
index 0000000..0ca36f3
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_termux_env_test.xml
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<cc.winboll.studio.libaes.views.ASupportToolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="right">
+
+		<Button
+			android:textAllCaps="false"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Open Termux Bash"
+			android:onClick="onOpenTermuxBash"/>
+
+		<Button
+			android:textAllCaps="false"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Test Termux Gradle Build CMD"
+			android:onClick="onTestTermuxGradleBuildCMD"/>
+
+		<Button
+			android:textAllCaps="false"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Test Termux Env"
+			android:onClick="onTestTermuxEnv"/>
+
+		<Button
+			android:textAllCaps="false"
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="Test WinBoLL Project Build"
+			android:onClick="onTestWinBoLLProjectBuild"/>
+
+	</LinearLayout>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<TextView
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Text"
+			android:id="@+id/tv_message"
+			android:textIsSelectable="true"/>
+
+	</ScrollView>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_test_weworkspecsdk.xml b/winboll/src/main/res/layout/activity_test_weworkspecsdk.xml
new file mode 100644
index 0000000..b1448e8
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_test_weworkspecsdk.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:padding="20dp"
+    android:gravity="center_horizontal">
+
+    <Button
+        android:id="@+id/btn_init_sdk"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="初始化企业微信SDK"
+        android:layout_marginBottom="10dp"/>
+
+    <Button
+        android:id="@+id/btn_get_corp_info"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="获取企业基本信息"
+        android:layout_marginBottom="10dp"/>
+
+    <Button
+        android:id="@+id/btn_check_auth"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="检查用户授权状态"/>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_winbollunittest.xml b/winboll/src/main/res/layout/activity_winbollunittest.xml
new file mode 100644
index 0000000..135b845
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_winbollunittest.xml
@@ -0,0 +1,215 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<android.widget.Toolbar
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:id="@+id/toolbar"/>
+
+	<ScrollView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<LinearLayout
+			xmlns:app="http://schemas.android.com/apk/res-auto"
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:orientation="vertical"
+			android:gravity="center">
+
+			<LinearLayout
+				android:orientation="vertical"
+				android:layout_width="match_parent"
+				android:layout_height="0dp"
+				android:layout_weight="1.0"
+				android:gravity="center_horizontal">
+
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="Android 11（内部代号 Red Velvet Cake）是谷歌于2020年9月8日正式发布的移动端操作系统，核心升级聚焦隐私安全强化、通话与通知体验优化、5G与折叠屏适配三大方向，为用户和开发者提供更安全、灵活的使用与开发环境。\n\n一、核心升级：隐私安全（最关键变化）\n\nAndroid 11进一步收紧应用权限管控，从“被动授权”转向“主动保护用户数据”，核心变化包括：\n\n- 一次性权限：首次申请定位、麦克风、相机等敏感权限时，新增“仅本次允许”选项，应用退出后权限自动失效，避免长期授权泄露数据。\n- 后台位置权限限制：应用需先获得“前台定位权限”，才能申请“后台定位”，且用户可单独关闭后台定位（此前需完全关闭定位权限），减少后台偷跑定位的情况。\n- 存储权限细分：将原“存储”权限拆分为“媒体文件”和“所有文件”，普通应用仅能访问媒体文件，需访问其他文件（如文档）时需单独申请“所有文件访问权限”，降低存储数据泄露风险。\n\n二、体验优化：通知与通话\n\n- 通知分类管理：通知栏新增“对话”“提醒”“无声”三大分类，微信、短信等实时对话会单独归为“对话”分类，支持置顶、标记未读，重要信息更易查找。\n- 通话与通知优先级优化：来电、闹钟等重要提醒会以“浮动窗口”形式显示（非全屏遮挡），不打断当前操作（如看视频、玩游戏），用户可快速选择接听/挂断。\n- 通知历史记录：新增“通知历史”功能，可查看过去24小时内被清除的通知，避免误删重要信息。\n\n三、开发者与硬件适配\n\n- 5G网络优化：新增5G网络状态API，支持应用识别“5G高速”“5G低延迟”等场景，例如视频App可自动切换高清画质，游戏App可优化网络传输策略。\n- 折叠屏适配：提供“折叠状态监听”“多窗口模式增强”等API，帮助开发者适配折叠屏设备，避免屏幕折叠/展开时界面错乱。\n- Scoped Storage（分区存储）强制启用：要求应用适配“分区存储”机制（Android 10为可选），应用默认只能访问自身专属目录和公共媒体目录，无法随意读写手机存储，提升系统安全性。\n\n四、其他实用功能\n\n- 电源菜单集成控制：长按电源键时，可直接显示智能家居控制（如灯光、空调），无需单独打开智能家居App。\n- 无线调试：支持通过Wi-Fi连接电脑进行ADB调试，无需USB线，方便开发者测试设备。\n- 屏幕录制升级：系统自带屏幕录制功能支持录制声音（包括麦克风声音），并可选择是否显示触控操作。\n\n综上，Android 11的核心定位是“安全与体验的精细化升级”，通过隐私权限的层层收紧保护用户数据，同时针对5G、折叠屏等新硬件做了前瞻性适配，是Android系统向“更安全、更智能”迭代的重要版本。"/>
+				<TextView
+					android:layout_width="wrap_content"
+					android:layout_height="wrap_content"
+					android:text="Edit TimeStamp: 20250915_180359_071"/>
+                
+                    
+				<HorizontalScrollView
+					android:layout_width="match_parent"
+					android:layout_height="wrap_content">
+
+					<LinearLayout
+						android:orientation="horizontal"
+						android:layout_height="wrap_content"
+						android:gravity="right|center_vertical"
+						android:layout_width="wrap_content">
+
+						<CheckBox
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="Debug Mode"
+							android:layout_weight="1.0"
+							android:onClick="onSwitchDebugMode"
+							android:id="@+id/activitymainCheckBox1"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="Test Application CrashReport"
+							android:textAllCaps="false"
+							android:onClick="onTestApplicationCrashReport"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="PreviewGlobalCrashActivity"
+							android:textAllCaps="false"
+							android:onClick="onPreviewGlobalCrashActivity"/>
+
+					</LinearLayout>
+
+				</HorizontalScrollView>
+
+				<ScrollView
+					android:layout_width="match_parent"
+					android:layout_height="400dp">
+
+					<LinearLayout
+						android:orientation="vertical"
+						android:layout_width="match_parent"
+						android:layout_height="wrap_content"
+						android:gravity="right">
+
+						<LinearLayout
+							android:orientation="horizontal"
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content">
+
+							<Button
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="StartCenter"
+								android:textAllCaps="false"
+								android:onClick="onStartCenter"/>
+
+							<Button
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content"
+								android:text="StopCenter"
+								android:textAllCaps="false"
+								android:onClick="onStopCenter"/>
+
+						</LinearLayout>
+
+						<HorizontalScrollView
+							android:layout_width="match_parent"
+							android:layout_height="wrap_content">
+
+							<LinearLayout
+								android:orientation="horizontal"
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content">
+
+								<Button
+									android:layout_width="wrap_content"
+									android:layout_height="wrap_content"
+									android:text="SartTestDemoService"
+									android:textAllCaps="false"
+									android:onClick="onSartTestDemoService"/>
+
+								<Button
+									android:layout_width="wrap_content"
+									android:layout_height="wrap_content"
+									android:text="StopTestDemoService"
+									android:textAllCaps="false"
+									android:onClick="onStopTestDemoService"/>
+
+								<Button
+									android:layout_width="wrap_content"
+									android:layout_height="wrap_content"
+									android:text="StopTestDemoServiceNoSettings"
+									android:textAllCaps="false"
+									android:onClick="onStopTestDemoServiceNoSettings"/>
+
+							</LinearLayout>
+
+						</HorizontalScrollView>
+
+						<HorizontalScrollView
+							android:layout_width="match_parent"
+							android:layout_height="wrap_content">
+
+							<LinearLayout
+								android:orientation="horizontal"
+								android:layout_width="wrap_content"
+								android:layout_height="wrap_content">
+
+								<Button
+									android:layout_width="wrap_content"
+									android:layout_height="wrap_content"
+									android:text="SartTestDemoBindService"
+									android:textAllCaps="false"
+									android:onClick="onSartTestDemoBindService"/>
+
+								<Button
+									android:layout_width="wrap_content"
+									android:layout_height="wrap_content"
+									android:text="StopTestDemoBindService"
+									android:textAllCaps="false"
+									android:onClick="onStopTestDemoBindService"/>
+
+								<Button
+									android:layout_width="wrap_content"
+									android:layout_height="wrap_content"
+									android:text="StopTestDemoBindServiceNoSettings"
+									android:textAllCaps="false"
+									android:onClick="onStopTestDemoBindServiceNoSettings"/>
+
+							</LinearLayout>
+
+						</HorizontalScrollView>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="TestStopMainServiceWithoutSettingEnable"
+							android:textAllCaps="false"
+							android:onClick="onTestStopMainServiceWithoutSettingEnable"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="TestUseComponentStartService"
+							android:textAllCaps="false"
+							android:onClick="onTestUseComponentStartService"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="TestDemoServiceSOS"
+							android:textAllCaps="false"
+							android:onClick="onTestDemoServiceSOS"/>
+
+						<Button
+							android:layout_width="wrap_content"
+							android:layout_height="wrap_content"
+							android:text="TestOpenNewActivity"
+							android:textAllCaps="false"
+							android:onClick="onTestOpenNewActivity"/>
+
+					</LinearLayout>
+
+				</ScrollView>
+
+			</LinearLayout>
+
+		</LinearLayout>
+
+	</ScrollView>
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_wxpay.xml b/winboll/src/main/res/layout/activity_wxpay.xml
new file mode 100644
index 0000000..bfd2596
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_wxpay.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:gravity="center_horizontal"
+    android:padding="20dp">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="定额支付测试（0.01元）"
+        android:textSize="20sp"/>
+
+    <ImageView
+        android:id="@+id/iv_qrcode"
+        android:layout_width="250dp"
+        android:layout_height="250dp"
+        android:scaleType="fitXY"/>
+
+    <TextView
+        android:id="@+id/tv_order_no"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="商户订单号："
+        android:textSize="16sp"/>
+
+    <TextView
+        android:id="@+id/tv_pay_status"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="支付状态：未支付"
+        android:textSize="16sp"
+        android:textColor="@android:color/black"/>
+
+    <Button
+        android:id="@+id/btn_create_order"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="生成支付二维码"/>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/activity_yun.xml b/winboll/src/main/res/layout/activity_yun.xml
new file mode 100644
index 0000000..ac73fab
--- /dev/null
+++ b/winboll/src/main/res/layout/activity_yun.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_gravity="right"
+		android:gravity="right"
+		android:padding="10dp"
+		android:id="@+id/ll_hostbar">
+
+		<RadioButton
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="10.8.0.250:456"
+			android:id="@+id/rb_debughost"
+			android:onClick="onSwitchHost"/>
+
+		<RadioButton
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="yun.winboll.cc"
+			android:id="@+id/rb_yunhost"
+			android:onClick="onSwitchHost"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:layout_gravity="right"
+		android:gravity="right">
+
+		<Button
+			android:layout_width="wrap_content"
+			android:layout_height="wrap_content"
+			android:text="TestYun"
+			android:onClick="onTestYun"/>
+
+	</LinearLayout>
+
+	<LinearLayout
+		android:orientation="vertical"
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:layout_weight="1.0">
+
+		<cc.winboll.studio.libappbase.LogView
+			android:layout_width="match_parent"
+			android:layout_height="match_parent"
+			android:id="@+id/logview"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/dialog_ollama_config.xml b/winboll/src/main/res/layout/dialog_ollama_config.xml
new file mode 100644
index 0000000..cdbef06
--- /dev/null
+++ b/winboll/src/main/res/layout/dialog_ollama_config.xml
@@ -0,0 +1,269 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="#1E1E1E"
+    android:fillViewport="true">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:padding="24dp">
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:text="Ollama 配置"
+            android:textColor="#FFFFFF"
+            android:textSize="20sp"
+            android:textStyle="bold"
+            android:layout_gravity="center_horizontal"
+            android:layout_marginBottom="12dp" />
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical">
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="API 地址"
+                android:textColor="#B0B0B0"
+                android:textSize="14sp"
+                android:layout_marginBottom="4dp" />
+
+            <EditText
+                android:id="@+id/etBaseUrl"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:hint="http://localhost:11434"
+                android:text="http://localhost:11434"
+                android:textColor="#FFFFFF"
+                android:textColorHint="#666666"
+                android:inputType="textUri"
+                android:singleLine="true"
+                android:background="#2D2D2D"
+                android:padding="12dp"
+                android:layout_marginBottom="12dp"
+                android:minHeight="48dp" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="模型名称"
+                android:textColor="#B0B0B0"
+                android:textSize="14sp"
+                android:layout_marginBottom="4dp" />
+
+            <EditText
+                android:id="@+id/etModelName"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:hint="模型名称 (如：llama3)"
+                android:text="llama3"
+                android:textColor="#FFFFFF"
+                android:textColorHint="#666666"
+                android:inputType="textCapCharacters"
+                android:singleLine="true"
+                android:background="#2D2D2D"
+                android:padding="12dp"
+                android:layout_marginBottom="12dp"
+                android:minHeight="48dp" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="温度设置"
+                android:textColor="#B0B0B0"
+                android:textSize="14sp"
+                android:layout_marginBottom="4dp" />
+
+            <EditText
+                android:id="@+id/etTemperature"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:hint="0.7"
+                android:text="0.7"
+                android:textColor="#FFFFFF"
+                android:textColorHint="#666666"
+                android:inputType="text"
+                android:singleLine="true"
+                android:background="#2D2D2D"
+                android:padding="12dp"
+                android:layout_marginBottom="12dp"
+                android:minHeight="48dp"
+                android:digits="0123456789.,-" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="最大 token 数"
+                android:textColor="#B0B0B0"
+                android:textSize="14sp"
+                android:layout_marginBottom="4dp" />
+
+            <EditText
+                android:id="@+id/etMaxTokens"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:hint="4096"
+                android:text="4096"
+                android:textColor="#FFFFFF"
+                android:textColorHint="#666666"
+                android:inputType="text"
+                android:singleLine="true"
+                android:background="#2D2D2D"
+                android:padding="12dp"
+                android:layout_marginBottom="12dp"
+                android:minHeight="48dp" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="系统提示"
+                android:textColor="#B0B0B0"
+                android:textSize="14sp"
+                android:layout_marginBottom="4dp" />
+
+            <EditText
+                android:id="@+id/etSystemPrompt"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:hint="你是 WinBoLL Ollama API 客户端..."
+                android:text="你是 WinBoLL Ollama API 客户端。用户将向你提问，请给予有用的、详细的回答。"
+                android:textColor="#FFFFFF"
+                android:textColorHint="#666666"
+                android:inputType="textMultiLine"
+                android:gravity="top|start"
+                android:background="#2D2D2D"
+                android:padding="12dp"
+                android:layout_marginBottom="12dp"
+                android:minHeight="100dp"
+                android:maxLines="4" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="API 版本"
+                android:textColor="#B0B0B0"
+                android:textSize="14sp"
+                android:layout_marginBottom="4dp" />
+
+            <EditText
+                android:id="@+id/etApiVersion"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:hint="v1"
+                android:text="v1"
+                android:textColor="#FFFFFF"
+                android:textColorHint="#666666"
+                android:inputType="textCapCharacters"
+                android:singleLine="true"
+                android:background="#2D2D2D"
+                android:padding="12dp"
+                android:layout_marginBottom="12dp"
+                android:minHeight="48dp" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="调试模式"
+                android:textColor="#B0B0B0"
+                android:textSize="14sp"
+                android:layout_marginBottom="4dp" />
+
+            <EditText
+                android:id="@+id/etDebugMode"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:hint="false"
+                android:text="false"
+                android:textColor="#FFFFFF"
+                android:textColorHint="#666666"
+                android:inputType="text"
+                android:singleLine="true"
+                android:background="#2D2D2D"
+                android:padding="12dp"
+                android:layout_marginBottom="12dp"
+                android:minHeight="48dp" />
+
+            <LinearLayout
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:layout_gravity="center"
+                android:gravity="center"
+                android:orientation="horizontal">
+
+                <Space
+                    android:layout_width="0dp"
+                    android:layout_height="wrap_content"
+                    android:layout_weight="0.5" />
+
+                <Button
+                    android:id="@+id/btnSaveConfig"
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="保存配置"
+                    android:textColor="#FFFFFF"
+                    android:textSize="14sp"
+                    android:paddingStart="40dp"
+                    android:paddingEnd="40dp"
+                    android:layout_marginEnd="8dp"
+                    android:backgroundTint="#4A90E2" />
+
+                <Button
+                    android:id="@+id/btnLoadConfig"
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="加载配置"
+                    android:textColor="#4A90E2"
+                    android:textSize="14sp"
+                    android:paddingStart="40dp"
+                    android:paddingEnd="40dp"
+                    android:layout_marginEnd="8dp"
+                    style="@style/Widget.MaterialComponents.Button.OutlinedButton" />
+
+                <Button
+                    android:id="@+id/btnReset"
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="重置"
+                    android:textColor="#B0B0B0"
+                    android:textSize="14sp"
+                    android:paddingStart="40dp"
+                    android:paddingEnd="40dp"
+                    style="@style/Widget.MaterialComponents.Button.TextButton" />
+
+                <Space
+                    android:layout_width="0dp"
+                    android:layout_height="wrap_content"
+                    android:layout_weight="0.5" />
+
+            </LinearLayout>
+
+            <TextView
+                android:id="@+id/tvStatus"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text=""
+                android:textColor="#00CC00"
+                android:textSize="12sp"
+                android:layout_gravity="center"
+                android:layout_marginTop="8dp" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="保存后，配置将对所有会话生效"
+                android:textColor="#666666"
+                android:textSize="12sp"
+                android:layout_marginTop="8dp" />
+
+        </LinearLayout>
+
+    </LinearLayout>
+
+</ScrollView>
diff --git a/winboll/src/main/res/layout/fragment_browser.xml b/winboll/src/main/res/layout/fragment_browser.xml
new file mode 100644
index 0000000..04f0e27
--- /dev/null
+++ b/winboll/src/main/res/layout/fragment_browser.xml
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical">
+
+    <!-- 顶部地址栏区域（水平布局：输入框+功能按钮） -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_margin="8dp"
+        android:orientation="horizontal"
+        android:gravity="center_vertical"
+        android:background="@drawable/bg_browser_top"
+        android:padding="4dp">
+
+        <!-- 地址输入框 -->
+        <EditText
+            android:id="@+id/et_url"
+            android:layout_width="0dp"
+            android:layout_height="48dp"
+            android:layout_weight="1"
+            android:hint="请输入URL或搜索内容"
+            android:paddingHorizontal="12dp"
+            android:background="@drawable/bg_edittext"
+            android:singleLine="true"
+            android:imeOptions="actionGo"
+            android:inputType="textUri" /> <!-- 提示输入URL格式 -->
+
+        <!-- 功能按钮区域（水平排列：加载、刷新、停止、前进、后退） -->
+        <LinearLayout
+            android:layout_width="wrap_content"
+            android:layout_height="match_parent"
+            android:orientation="horizontal"
+            android:gravity="center_vertical"
+            android:paddingHorizontal="4dp">
+
+            <Button
+                android:id="@+id/btn_load"
+                android:layout_width="40dp"
+                android:layout_height="40dp"
+                android:text="加载"
+                android:textSize="12sp"
+                android:layout_marginHorizontal="2dp"/>
+
+            <Button
+                android:id="@+id/btn_refresh"
+                android:layout_width="40dp"
+                android:layout_height="40dp"
+                android:text="刷新"
+                android:textSize="12sp"
+                android:layout_marginHorizontal="2dp"/>
+
+            <Button
+                android:id="@+id/btn_stop"
+                android:layout_width="40dp"
+                android:layout_height="40dp"
+                android:text="停止"
+                android:textSize="12sp"
+                android:layout_marginHorizontal="2dp"/>
+
+            <Button
+                android:id="@+id/btn_forward"
+                android:layout_width="40dp"
+                android:layout_height="40dp"
+                android:text="前进"
+                android:textSize="12sp"
+                android:layout_marginHorizontal="2dp"/>
+
+            <Button
+                android:id="@+id/btn_back"
+                android:layout_width="40dp"
+                android:layout_height="40dp"
+                android:text="后退"
+                android:textSize="12sp"
+                android:layout_marginHorizontal="2dp"/>
+        </LinearLayout>
+    </LinearLayout>
+
+    <!-- 页面加载进度条（位于地址栏下方，WebView上方） -->
+    <ProgressBar
+        android:id="@+id/progress_bar"
+        android:layout_width="match_parent"
+        android:layout_height="2dp"
+        android:progressDrawable="@drawable/progress_bar_style"
+        android:visibility="gone"/>
+
+    <!-- 自定义WebView（WinBoLLView） -->
+    <cc.winboll.studio.winboll.views.WinBoLLView
+        android:id="@+id/winboll_webview"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1"/>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/fragment_main.xml b/winboll/src/main/res/layout/fragment_main.xml
new file mode 100644
index 0000000..4beaf90
--- /dev/null
+++ b/winboll/src/main/res/layout/fragment_main.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content">
+
+		<Switch
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:text="Position Service"
+			android:padding="10dp"
+			android:id="@+id/fragmentmainSwitch1"/>
+
+	</LinearLayout>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/view_toolbar.xml b/winboll/src/main/res/layout/view_toolbar.xml
new file mode 100644
index 0000000..955f81e
--- /dev/null
+++ b/winboll/src/main/res/layout/view_toolbar.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+
+    <ImageView
+        android:id="@+id/toolbar_icon"
+        android:layout_width="48dp"
+        android:layout_height="48dp"
+        android:src="@drawable/ic_launcher"
+        android:layout_alignParentStart="true"
+        android:layout_centerVertical="true"
+        android:layout_marginStart="6dp"
+        android:contentDescription="@string/toolbar_icon_description" />
+
+    <TextView
+        android:id="@+id/toolbar_title"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:textColor="#ffffff"
+        android:textSize="18sp"
+        android:layout_centerVertical="true"
+        android:layout_toEndOf="@id/toolbar_icon"
+        android:layout_marginStart="16dp" />
+
+</RelativeLayout>
+    
diff --git a/winboll/src/main/res/layout/widget_news.xml b/winboll/src/main/res/layout/widget_news.xml
new file mode 100644
index 0000000..e85e3d2
--- /dev/null
+++ b/winboll/src/main/res/layout/widget_news.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	android:orientation="vertical"
+	android:background="#FFFFFFFF">
+
+	<LinearLayout
+		android:orientation="horizontal"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:gravity="right|center_vertical">
+
+		<TextView
+			android:layout_width="0dp"
+			android:layout_height="wrap_content"
+			android:id="@+id/tv_title"
+			android:layout_weight="1.0"
+			android:text="WinBoLLNews"
+			android:textStyle="bold"
+			android:textSize="16sp"/>
+
+		<Button
+			android:layout_width="48dp"
+			android:layout_height="48dp"
+			android:text="⇦"
+			android:id="@+id/widget_button_pre"/>
+
+		<Button
+			android:layout_width="48dp"
+			android:layout_height="48dp"
+			android:text="⇨"
+			android:id="@+id/widget_button_next"/>
+
+	</LinearLayout>
+
+    <TextView
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:id="@+id/tv_msg"/>
+    
+	<TextView
+		android:layout_width="match_parent"
+		android:layout_height="0dp"
+		android:id="@+id/tv_news"
+		android:layout_weight="1.0"/>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/layout/widget_status.xml b/winboll/src/main/res/layout/widget_status.xml
new file mode 100644
index 0000000..b115a06
--- /dev/null
+++ b/winboll/src/main/res/layout/widget_status.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	android:orientation="vertical"
+	android:layout_width="40dp"
+	android:layout_height="40dp">
+
+	<ImageView
+		android:layout_width="40dp"
+		android:layout_height="40dp"
+		android:id="@+id/ivapp"/>
+
+</LinearLayout>
+
diff --git a/winboll/src/main/res/menu/menu_main.xml b/winboll/src/main/res/menu/menu_main.xml
new file mode 100644
index 0000000..351f5c1
--- /dev/null
+++ b/winboll/src/main/res/menu/menu_main.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+    <item
+        android:id="@+id/menu_ollama"
+        android:title="Ollama 窗口" />
+</menu>
diff --git a/winboll/src/main/res/menu/toolbar_main.xml b/winboll/src/main/res/menu/toolbar_main.xml
new file mode 100644
index 0000000..05c1c77
--- /dev/null
+++ b/winboll/src/main/res/menu/toolbar_main.xml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    <item
+        android:id="@+id/item_home"
+        android:title="HOME"/>
+	<item
+        android:id="@+id/item_mytermux"
+        android:title="MyTermuxActivity"/>
+	<item
+        android:id="@+id/item_settings"
+        android:title="Settings"/>
+	<item
+        android:id="@+id/item_about"
+        android:title="About"/>
+</menu>
diff --git a/winboll/src/main/res/menu/toolbar_test.xml b/winboll/src/main/res/menu/toolbar_test.xml
new file mode 100644
index 0000000..ccd0574
--- /dev/null
+++ b/winboll/src/main/res/menu/toolbar_test.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<menu xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto">
+    
+    <item android:title="UnitTest">
+        <menu >
+			<item
+				android:id="@+id/item_termux_env_test"
+				android:title="TermuxEnvTestActivity"/>
+			<item
+				android:id="@+id/item_library_activity"
+				android:title="WinBoLLLibraryActivity"/>
+        </menu>
+    </item>
+</menu>
diff --git a/winboll/src/main/res/values-zh/strings.xml b/winboll/src/main/res/values-zh/strings.xml
new file mode 100644
index 0000000..045e125
--- /dev/null
+++ b/winboll/src/main/res/values-zh/strings.xml
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+</resources>
diff --git a/winboll/src/main/res/values/attrs.xml b/winboll/src/main/res/values/attrs.xml
new file mode 100644
index 0000000..75540a4
--- /dev/null
+++ b/winboll/src/main/res/values/attrs.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <declare-styleable name="CustomToolbar">
+        <attr name="toolbarTitle" format="string" />
+        <attr name="toolbarTitleColor" format="color" />
+        <attr name="toolbarBackgroundColor" format="color" />
+    </declare-styleable>
+
+	<declare-styleable name="TermuxButton">
+		<attr name="exeCommand" format="string" />
+		<attr name="workDir" format="string" />
+		<attr name="isCommitted" format="boolean" />
+		<attr name="commitTitle" format="string" />
+		<attr name="commitInfo" format="string" />
+	</declare-styleable>
+</resources>
+
diff --git a/winboll/src/main/res/values/colors.xml b/winboll/src/main/res/values/colors.xml
new file mode 100644
index 0000000..c31ed9d
--- /dev/null
+++ b/winboll/src/main/res/values/colors.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#009688</color>
+    <color name="colorPrimaryDark">#00796B</color>
+    <color name="colorAccent">#FF9800</color>
+    <color name="pattern_lock_black">#000000</color>
+
+    <color name="mainWindowBackgroundColor">#FFF5F5F5</color>
+    <color name="mainWindowTextColor">#FF000000</color>
+    <color name="toolbarTextColor">#FF000000</color>
+    <color name="toolbarBackgroundColor">#FF00B322</color>
+    <color name="debugTextColor">#FF808080</color>
+</resources>
\ No newline at end of file
diff --git a/winboll/src/main/res/values/dimens.xml b/winboll/src/main/res/values/dimens.xml
new file mode 100644
index 0000000..9781ee2
--- /dev/null
+++ b/winboll/src/main/res/values/dimens.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+	<!--
+    <dimen name="toolbar_height">60dp</dimen>
+    <dimen name="slide_width">76dp</dimen>
+    <dimen name="text_content_size">18dp</dimen>
+    <dimen name="text_title_size">24dp</dimen>
+    <dimen name="text_subtitle_size">16dp</dimen>
+	-->
+</resources>
diff --git a/winboll/src/main/res/values/strings.xml b/winboll/src/main/res/values/strings.xml
new file mode 100644
index 0000000..02aac87
--- /dev/null
+++ b/winboll/src/main/res/values/strings.xml
@@ -0,0 +1,33 @@
+<resources>
+    <string name="app_name">WinBoLL</string>
+    <string name="app_description">WinBoLL 网站浏览器。</string>
+	<string name="app_name_cn1">筋斗云</string>
+	<string name="app_name_cn2">金抖云</string>
+    <string name="switchto_en1">WinBoLL</string>
+    <string name="switchto_cn1">筋斗云</string>
+    <string name="switchto_cn2">金抖云</string>
+    <string name="en1_switch_disabled">WinBoLL X</string>
+    <string name="cn1_switch_disabled">筋斗云 X</string>
+    <string name="cn2_switch_disabled">金抖云 X</string>
+    <string name="tileservice_name">WinBoLL</string>
+    <string name="toolbar_icon_description">WinBoLL APP</string>
+    <string name="my_termux_activity">MyTermuxActivity</string>
+    <string name="pattern_lock_title">图案密码设置</string>
+    <string name="add_termux_button">+ 添加Termux按钮</string>
+    <string name="menu_execute">执行</string>
+    <string name="menu_edit">编辑</string>
+    <string name="menu_delete">删除</string>
+    <string name="menu_cancel">取消</string>
+    <string name="dialog_delete_title">确认删除</string>
+    <string name="dialog_delete_message">确定要删除</string>
+    <string name="dialog_add_title">添加Termux按钮</string>
+    <string name="dialog_edit_title">编辑Termux按钮</string>
+    <string name="dialog_save">保存</string>
+    <string name="dialog_confirm">确定</string>
+    <string name="dialog_cancel">取消</string>
+    <string name="hint_button_name">按钮名称</string>
+    <string name="hint_exe_command">执行命令</string>
+    <string name="hint_work_dir">工作目录（默认 ~）</string>
+    <string name="toast_deleted">已删除</string>
+    <string name="toast_fields_required">按钮名称和执行命令不能为空</string>
+</resources>
diff --git a/winboll/src/main/res/values/styles.xml b/winboll/src/main/res/values/styles.xml
new file mode 100644
index 0000000..fcf0822
--- /dev/null
+++ b/winboll/src/main/res/values/styles.xml
@@ -0,0 +1,57 @@
+<resources>
+    <style name="MyAppTheme" parent="AESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+        <item name="aToolbar">@style/MyAESAToolbar</item>
+        <item name="aSupportToolbar">@style/MyAESASupportToolbar</item>
+    </style>
+
+    <style name="MyDepthAppTheme" parent="DepthAESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+        <item name="aToolbar">@style/MyAESAToolbar</item>
+        <item name="aSupportToolbar">@style/MyAESASupportToolbar</item>
+    </style>
+
+    <style name="MySkyAppTheme" parent="SkyAESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+        <item name="aToolbar">@style/MyAESAToolbar</item>
+        <item name="aSupportToolbar">@style/MyAESASupportToolbar</item>
+    </style>
+
+    <style name="MyGoldenAppTheme" parent="GoldenAESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+        <item name="aToolbar">@style/MyAESAToolbar</item>
+        <item name="aSupportToolbar">@style/MyAESASupportToolbar</item>
+    </style>
+
+    <style name="MyBearingAppTheme" parent="BearingAESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+        <item name="aToolbar">@style/MyAESAToolbar</item>
+        <item name="aSupportToolbar">@style/MyAESASupportToolbar</item>
+    </style>
+
+    <style name="MyMemorAppTheme" parent="MemorAESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+        <item name="aToolbar">@style/MyAESAToolbar</item>
+        <item name="aSupportToolbar">@style/MyAESASupportToolbar</item>
+    </style>
+
+    <style name="MyTaoAppTheme" parent="TaoAESTheme">
+        <item name="themeDebug">@style/MyDebugActivityTheme</item>
+        <item name="aToolbar">@style/MyAESAToolbar</item>
+        <item name="aSupportToolbar">@style/MyAESASupportToolbar</item>
+    </style>
+
+    <style name="MyAESAToolbar" parent="AESAToolbar" />
+
+    <style name="MyAESASupportToolbar" parent="AESASupportToolbar" />
+
+    <style name="MyDebugActivityTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="android:statusBarColor">@color/toolbarBackgroundColor</item>
+        <item name="colorTittle">@color/mainWindowTextColor</item>
+        <item name="colorTittleBackgound">@color/toolbarBackgroundColor</item>
+        <item name="colorText">@color/debugTextColor</item>
+        <item name="colorTextBackgound">@color/mainWindowBackgroundColor</item>
+        <item name="debugTextColor">@color/debugTextColor</item>
+        <item name="toolbarTextColor">@color/toolbarTextColor</item>
+    </style>
+</resources>
diff --git a/winboll/src/main/res/xml/network_security_config.xml b/winboll/src/main/res/xml/network_security_config.xml
new file mode 100644
index 0000000..e19d7b8
--- /dev/null
+++ b/winboll/src/main/res/xml/network_security_config.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <!-- 允许特定域名的HTTP明文请求（如winboll.com） -->
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">winboll.cc</domain> <!-- 你的目标域名 -->
+        <domain includeSubdomains="true">www.winboll.cc</domain> <!-- 其他需要兼容的域名 -->
+    </domain-config>
+    <!-- 全局允许HTTP明文请求（支持网站HTTP协议访问） -->
+    <base-config cleartextTrafficPermitted="true">
+        <trust-anchors>
+            <certificates src="system" />
+        </trust-anchors>
+    </base-config>
+    <!-- 允许特定域名的明文请求（仅本地127.0.0.1） -->
+    <domain-config cleartextTrafficPermitted="true">
+        <domain includeSubdomains="true">127.0.0.1</domain>
+        <domain includeSubdomains="true">localhost</domain>
+    </domain-config>
+</network-security-config>
+
+
diff --git a/winboll/src/main/res/xml/shortcutsmaincn1.xml b/winboll/src/main/res/xml/shortcutsmaincn1.xml
new file mode 100644
index 0000000..3196673
--- /dev/null
+++ b/winboll/src/main/res/xml/shortcutsmaincn1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.winboll"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+	android:shortcutId="switchto_cn1"
+	android:enabled="true"
+	android:icon="@drawable/ic_launcher"
+	android:shortcutShortLabel="@string/switchto_cn1"
+	android:shortcutLongLabel="@string/switchto_cn1"
+	android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+	<intent
+	android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN1"
+	android:targetPackage="cc.winboll.studio.winboll"
+	android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+	android:data="switchto_cn1" />
+	<categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.winboll"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/winboll/src/main/res/xml/shortcutsmaincn2.xml b/winboll/src/main/res/xml/shortcutsmaincn2.xml
new file mode 100644
index 0000000..331ab2e
--- /dev/null
+++ b/winboll/src/main/res/xml/shortcutsmaincn2.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_EN1"
+            android:targetPackage="cc.winboll.studio.winboll"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.winboll"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<!--<shortcut
+	android:shortcutId="switchto_cn2"
+	android:enabled="true"
+	android:icon="@drawable/ic_launcher"
+	android:shortcutShortLabel="@string/switchto_cn2"
+	android:shortcutLongLabel="@string/switchto_cn2"
+	android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+	<intent
+	android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN2"
+	android:targetPackage="cc.winboll.studio.winboll"
+	android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+	android:data="switchto_cn2" />
+	<categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+</shortcuts>
diff --git a/winboll/src/main/res/xml/shortcutsmainen1.xml b/winboll/src/main/res/xml/shortcutsmainen1.xml
new file mode 100644
index 0000000..57bef47
--- /dev/null
+++ b/winboll/src/main/res/xml/shortcutsmainen1.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 切换启动入口的快捷菜单 -->
+	<!--<shortcut
+        android:shortcutId="switchto_en1"
+        android:enabled="true"
+	    android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_en1"
+        android:shortcutLongLabel="@string/switchto_en1"
+        android:shortcutDisabledMessage="@string/en1_switch_disabled">
+        <intent
+	android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_EN1"
+	android:targetPackage="cc.winboll.studio.winboll"
+	android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_en1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>-->
+	<shortcut
+        android:shortcutId="switchto_cn1"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn1"
+        android:shortcutLongLabel="@string/switchto_cn1"
+        android:shortcutDisabledMessage="@string/cn1_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN1"
+            android:targetPackage="cc.winboll.studio.winboll"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn1" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+	<shortcut
+        android:shortcutId="switchto_cn2"
+        android:enabled="true"
+        android:icon="@drawable/ic_launcher"
+        android:shortcutShortLabel="@string/switchto_cn2"
+        android:shortcutLongLabel="@string/switchto_cn2"
+        android:shortcutDisabledMessage="@string/cn2_switch_disabled">
+        <intent
+            android:action="cc.winboll.studio.winboll.App.ACTION_SWITCHTO_CN2"
+            android:targetPackage="cc.winboll.studio.winboll"
+            android:targetClass="cc.winboll.studio.winboll.activities.ShortcutActionActivity"
+            android:data="switchto_cn2" />
+        <categories android:name="android.shortcut.conversation" />
+    </shortcut>
+</shortcuts>
diff --git a/winboll/src/main/res/xml/widget_provider_info_sos.xml b/winboll/src/main/res/xml/widget_provider_info_sos.xml
new file mode 100644
index 0000000..e03bd34
--- /dev/null
+++ b/winboll/src/main/res/xml/widget_provider_info_sos.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+    android:minWidth="200dp"
+    android:minHeight="100dp"
+    android:updatePeriodMillis="1000"
+    android:initialLayout="@layout/widget_news">
+</appwidget-provider>
diff --git a/winboll/src/main/res/xml/widget_provider_info_status.xml b/winboll/src/main/res/xml/widget_provider_info_status.xml
new file mode 100644
index 0000000..5e19984
--- /dev/null
+++ b/winboll/src/main/res/xml/widget_provider_info_status.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+    android:minWidth="40dp"
+    android:minHeight="40dp"
+    android:updatePeriodMillis="1000"
+    android:initialLayout="@layout/widget_status"
+    android:resizeMode="none">
+</appwidget-provider>
diff --git a/winboll/src/stage/AndroidManifest.xml b/winboll/src/stage/AndroidManifest.xml
new file mode 100644
index 0000000..ee78d9f
--- /dev/null
+++ b/winboll/src/stage/AndroidManifest.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools" >
+
+    <application>
+
+        <!-- Put flavor specific code here -->
+
+    </application>
+
+</manifest>
+
diff --git a/winboll/src/stage/res/values/strings.xml b/winboll/src/stage/res/values/strings.xml
new file mode 100644
index 0000000..ace0c41
--- /dev/null
+++ b/winboll/src/stage/res/values/strings.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Put flavor specific strings here -->
+
+</resources>