docs: 重构 gpsrelaysentinel/README.md 中英文双语文档

- 中文文档新增核心功能清单（双模式运行、前台服务、订阅者管理、模拟面板、日志输出、崩溃处理、关于页面） - 技术栈改用表格展示，模块说明更新为实际编译模块（:gpsrelaysentinel 与 :libgpsrelaysentinel） - 核心依赖库分类更清晰（网络、终端模拟、功能组件、UI 组件） - 项目结构树精确到具体 Java 源文件及其功能说明 - 权限说明改为具体 Android 权限声明 - 新增完整英文版本文档（Project Introduction、Core Features、Tech Stack、Module Structure、Core Dependencies、Build Instructions、Permissions、Project Structure、Contributing、License） - 删除失效的参考文档链接
feat: MainActivity工具栏添加About按钮跳转AboutActivity窗口
2026-05-07 16:25:40 +08:00 · 2026-05-07 16:17:37 +08:00 · 2026-05-07 15:57:54 +08:00 · 2026-05-07 15:20:33 +08:00 · 2026-05-07 15:18:38 +08:00 · 2026-05-07 15:10:09 +08:00
23 changed files with 1371 additions and 578 deletions
--- a/gpsrelaysentinel/README.md
+++ b/gpsrelaysentinel/README.md
@@ -1,117 +1,239 @@
 # GPSRelaySentinel

-## 介绍
+---

-GPSRelaySentinel 是一款基于安卓平台的综合工具应用，集成 Termux 终端模拟器、二维码扫描、网络请求等功能。
+## 中文文档

-## 技术栈
+### 项目介绍

- **编程语言**: Java 7（源码）
- **编译环境**: Java 11（Gradle 编译）
- **Gradle 插件**: 7.2.1
- **安卓 API**:
-  - 最低支持: API 26 (Android 8.0)
-  - 目标版本: API 30 (Android 11)
-  - 编译版本: API 30
+GPSRelaySentinel 是一款专业的 **GPS 定位中继守护工具**，支持真实系统 GPS 定位监听与模拟 GPS 坐标仿真双模式运行。应用后台常驻前台服务，实时接收系统 GPS 位置数据，内置订阅者步长阈值判断机制，可对多个 GPS 订阅视图进行定点推送管理。

-## 软件架构
+#### 核心功能

-适配以下安卓开发环境的 Gradle 编译结构：
- AIDE Pro
- AndroidIDE
+- **双模式运行**：支持真实 GPS 工作模式与虚拟仿真模式一键切换
+- **前台常驻服务**：`MainService` 作为前台 Service 持续监听 GPS 定位变化
+- **订阅者管理**：内置 `GpsSubscribeManager` 与 `SubscribeLocationManager`，支持多订阅者步长阈值推送
+- **模拟控制面板**：支持八大方位选择、自定义移动距离，自动计算偏移目标经纬度
+- **实时日志输出**：集成 `LogView` 面板，方便调试定位轨迹与订阅推送状态
+- **崩溃处理**：`App` 类提供全局 CrashHandler 与 CrashActivity 展示崩溃日志
+- **关于页面**：工具栏提供 About 按钮，可查看应用版本与项目信息

-## 模块说明
+#### 技术栈

-本项目采用多模块结构：
- `gpsrelaysentinel` - 主应用模块
- `libappbase` - 基础库模块（提供 OkHttp、Gson、JSch 等基础能力）
- `libaes` - AES 加密库模块（提供权限请求、二维码、拼音搜索等扩展功能）
+| 项目 | 版本/说明 |
+|------|-----------|
+| 编程语言 | Java 7（源码） |
+| 编译环境 | Java 11（Gradle 编译） |
+| Gradle 插件 | 7.2.1 |
+| 最低 API | API 26 (Android 8.0) |
+| 目标 API | API 30 (Android 11) |
+| 编译 API | API 30 |

-## 核心依赖库
+#### 模块结构

-### 网络相关
- OkHttp 4.4.1 / 3.14.9 - HTTP 客户端
- Gson 2.10.1 - JSON 解析
+本项目采用多模块 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 处理
+**功能组件**
+- ZXing 3.4.1 — 二维码生成与扫描
+- JSch 0.1.55 — SSH/SFTP 客户端
+- Jsoup 1.13.1 — HTML 解析
+- FastJSON 1.2.76 — JSON 处理

-### UI 组件
+**UI 组件**
 - Material Design 1.4.0
 - AndroidX 组件库
- PullRefreshLayout 1.2.0 - 下拉刷新
+- PullRefreshLayout 1.2.0 — 下拉刷新

-## Gradle 编译说明
+#### 编译说明

-### 调试版编译
+**调试版编译**
 ```bash
-gradle assembleDebug
+./gradlew assembleBetaDebug
 ```

-### 阶段版编译（发布）
+**阶段版编译（发布）**
 ```bash
 bash .winboll/bashPublishAPKAddTag.sh gpsrelaysentinel
 ```

-### 版本管理
+**版本管理**
 版本信息由 `gpsrelaysentinel/build.properties` 管理：
- `baseVersion` - 基础版本号
- `stageCount` - 阶段构建次数
- `publishVersion` - 发布版本号
- `buildCount` - 构建次数
+- `baseVersion` — 基础版本号
+- `stageCount` — 阶段构建次数
+- `publishVersion` — 发布版本号
+- `buildCount` — 构建次数

-## 使用说明
-
-### Termux 应用配置
-
-1. 安装 Termux 应用（包名: `com.termux`）
-2. 配置允许外部应用访问：
-   ```bash
-   echo "allow-external-apps = true" > ~/.termux/termux.properties
-   ```
-
-### 权限说明
+#### 权限说明

 应用需要以下权限：
- 网络访问权限
- 存储读写权限
- 相机权限（二维码扫描）
- 位置权限（GPS 相关功能）
+- `ACCESS_FINE_LOCATION` — 精确定位
+- `ACCESS_COARSE_LOCATION` — 大致定位
+- `ACCESS_BACKGROUND_LOCATION` — 后台定位
+- `FOREGROUND_SERVICE` — 前台服务

-## 项目结构
+#### 项目结构

 ```
 gpsrelaysentinel/
 ├── src/main/
-│   ├── java/          # Java 源码（Java 7 语法）
-│   ├── res/           # 资源文件
-│   ├── libs/          # 本地库文件（含 JNI 库）
-│   └── AndroidManifest.xml
-├── build.gradle       # 模块构建配置
-└── build.properties   # 版本配置文件
+│   ├── 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@188.com>）
+3. 提交代码（作者: ZhanGSKen <ZhanGSKen@QQ.COM>）
 4. 新建 Pull Request

-## 许可证
+#### 许可证

 [待添加许可证信息]

-## 参考文档
+---

- [Android Developer Documentation](https://developer.android.com/)
- [Termux Wiki](https://wiki.termux.com/)
- [Gradle User Manual](https://docs.gradle.org/)
+## 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]
--- a/gpsrelaysentinel/build.gradle
+++ b/gpsrelaysentinel/build.gradle
@@ -115,8 +115,8 @@ dependencies {
 	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'
+	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'
--- a/gpsrelaysentinel/build.properties
+++ b/gpsrelaysentinel/build.properties
@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Thu May 07 10:59:47 CST 2026
+#Thu May 07 15:04:39 CST 2026
 stageCount=27
 libraryProject=
 baseVersion=15.11
 publishVersion=15.11.26
-buildCount=31
+buildCount=33
 baseBetaVersion=15.11.27
--- a/gpsrelaysentinel/src/beta/res/values/strings.xml
+++ b/gpsrelaysentinel/src/beta/res/values/strings.xml
@@ -2,5 +2,6 @@
 <resources>

    <string name="app_name">GPSRelaySentinel★</string>
+	<string name="app_description">一款支持真实/模拟定位的GPS中继工具，可后台常驻，实现位置数据转发、调试与仿真，适配开发测试使用。</string>

 </resources>
--- a/gpsrelaysentinel/src/main/AndroidManifest.xml
+++ b/gpsrelaysentinel/src/main/AndroidManifest.xml
@@ -3,10 +3,17 @@
    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" />
+    <!-- 只能在前台获取精确的位置信息 -->
+    <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"
@@ -37,10 +44,19 @@

        <activity android:name=".GlobalApplication$CrashActivity"/>

-        <service android:name=".MainService"
+        <service
+            android:name=".MainService"
            android:enabled="true"
-            android:exported="false" />
+            android:exported="false"/>
+
+        <service android:name=".GpsReceiverChildService1"/>
+
+        <service android:name=".GpsReceiverChildService2"/>
+
+        <service android:name=".GpsReceiverChildService3"/>
+
+        <activity android:name=".AboutActivity"/>

    </application>

-</manifest>
+</manifest>
--- a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/AboutActivity.java
+++ 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;
+    }
+}
--- a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService1.java
+++ 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;
+    }
+}
+
--- a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService2.java
+++ 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;
+    }
+}
+
--- a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/GpsReceiverChildService3.java
+++ 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;
+    }
+}
+
--- a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainActivity.java
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainActivity.java
@@ -5,18 +5,60 @@ 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;

-public class MainActivity extends AppCompatActivity {
+/**
+ * WinBoLL Studio
+ * GPSRelaySentinel 主控制页面
+ * Java7 | API26~30
+ * 新增：模拟模式勾选控制 + 按钮互斥可用状态
+ */
+public final class MainActivity extends AppCompatActivity {

-    LogView mLogView;
-    Switch mSwitchService;
+    //原有控件
+    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
@@ -24,78 +66,288 @@ public class MainActivity extends AppCompatActivity {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

-        Toolbar toolbar=(Toolbar)findViewById(R.id.toolbar);
-        setSupportActionBar(toolbar);
-
-        mLogView = findViewById(R.id.logview);
-        mSwitchService = findViewById(R.id.switch_service);
-
-        // 根据当前权限状态初始化switch
-        mSwitchService.setChecked(hasLocationPermission());
-
-        mSwitchService.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
-            @Override
-            public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
-                if (isChecked) {
-                    // 打开时检查权限
-                    if (hasLocationPermission()) {
-                        startService();
-                    } else {
-                        // 没有权限，申请权限
-                        requestLocationPermission();
-                        // 暂时不打开switch，等权限申请结果
-                        mSwitchService.setChecked(false);
-                    }
-                } else {
-                    stopService();
-                }
-            }
-        });
+        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 hasBasic = checkSelfPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
-            || checkSelfPermission(android.Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED;
-        if (hasBasic && android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
+        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 hasBasic;
+        return basicPermission;
    }

    private void requestLocationPermission() {
+        String[] permissionArray;
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
-            String[] permissions = new String[] {
-                android.Manifest.permission.ACCESS_FINE_LOCATION,
-                android.Manifest.permission.ACCESS_COARSE_LOCATION,
-                android.Manifest.permission.ACCESS_BACKGROUND_LOCATION
+            permissionArray = new String[]{
+				android.Manifest.permission.ACCESS_FINE_LOCATION,
+				android.Manifest.permission.ACCESS_COARSE_LOCATION,
+				android.Manifest.permission.ACCESS_BACKGROUND_LOCATION
            };
-            requestPermissions(permissions, REQUEST_LOCATION_PERMISSION);
        } else {
-            String[] permissions = new String[] {
-                android.Manifest.permission.ACCESS_FINE_LOCATION,
-                android.Manifest.permission.ACCESS_COARSE_LOCATION
+            permissionArray = new String[]{
+				android.Manifest.permission.ACCESS_FINE_LOCATION,
+				android.Manifest.permission.ACCESS_COARSE_LOCATION
            };
-            requestPermissions(permissions, REQUEST_LOCATION_PERMISSION);
        }
+        requestPermissions(permissionArray, REQUEST_LOCATION_PERMISSION);
    }

-    private void startService() {
-        Intent intent = new Intent(MainActivity.this, MainService.class);
-        startForegroundService(intent);
+    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 stopService() {
-        // 先设置SP标记为不启用
-        MainActivity.this.getSharedPreferences(MainService.PREF_NAME, Context.MODE_PRIVATE)
-            .edit()
-            .putBoolean(MainService.KEY_SERVICE_ENABLED, false)
-            .apply();
-        Intent intent = new Intent(MainActivity.this, MainService.class);
-        stopService(intent);
+    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");
    }
@@ -105,9 +357,8 @@ public class MainActivity extends AppCompatActivity {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_LOCATION_PERMISSION) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
-                // 权限申请成功，启动服务
                mSwitchService.setChecked(true);
-                startService();
+                startGpsService();
            } else {
                ToastUtils.show("需要位置权限才能使用GPS服务");
                mSwitchService.setChecked(false);
@@ -120,8 +371,5 @@ public class MainActivity extends AppCompatActivity {
        super.onResume();
        mLogView.start();
    }
-
-//    public void onLibraryActivity(View view) {
-//		startActivity(new Intent(this, LibraryActivity.class));
-//    }
 }
+
--- a/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainService.java
+++ b/gpsrelaysentinel/src/main/java/cc/winboll/studio/gpsrelaysentinel/MainService.java
@@ -12,154 +12,236 @@ 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;

-public class MainService extends Service {
+/**
+ * WinBoLL Studio
+ * GPS定位核心前台服务
+ * 负责GPS持续监听、订阅者步长判断、基准坐标刷新、前台常驻通知
+ * Java7 | API26~30
+ * 新增：实时同步最新GPS到MainActivity静态坐标
+ */
+public final class MainService extends Service {

+    //日志标签
    public static final String TAG = "MainService";
-    private LocationManager mLocationManager;
-    private LocationListener mLocationListener;
-    private boolean mIsRunning = false;
-    private NotificationManager mNotificationManager;
-    private NotificationCompat.Builder mNotificationBuilder;
+
+    //前台通知常量
    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 int mGpsCount = 0;
+
+    //系统定位 & 通知控件
+    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");
-        mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
-        createNotificationChannel();
-        if (isServiceEnabled()) {
-            LogUtils.d(TAG, "Service was enabled, starting GPS updates");
-            run();
+
+        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");
-        setServiceEnabled(true);
-        run();
+        saveServiceEnableStatus(true);
+        startGpsLocationListen();
        return START_STICKY;
    }

-    private boolean isServiceEnabled() {
-        return getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE).getBoolean(KEY_SERVICE_ENABLED, false);
+    /**
+     * 初始化订阅规则管理器
+     */
+    private void initManager() {
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationRuleManager = SubscribeLocationManager.getInstance();
    }

-    private void setServiceEnabled(boolean enabled) {
-        getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE).edit().putBoolean(KEY_SERVICE_ENABLED, enabled).apply();
-        LogUtils.d(TAG, "Service enabled set to: " + enabled);
+    /**
+     * 初始化通知渠道与管理类
+     */
+    private void initNotificationConfig() {
+        mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
+        createSystemNotificationChannel();
    }

-    private void run() {
+    /**
+     * 读取服务启用状态
+     */
+    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 updates already running");
+            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) {
-                mGpsCount++;
-                String gpsInfo = "Lat: " + location.getLatitude() + ", Lng: " + location.getLongitude();
-                LogUtils.d(TAG, "Location changed: " + gpsInfo);
-                updateNotification(gpsInfo);
-				
-				//管理器初始化
-				GpsSubscribeManager subscribeManager = GpsSubscribeManager.getInstance();
-				SubscribeLocationManager locationManager = SubscribeLocationManager.getInstance();
-
-				//遍历所有订阅者做距离判断+定点更新
-				Map<String, GpsSubscribeMsg> subscribeMap = subscribeManager.getSubscribeMap();
-				for (Map.Entry<String, GpsSubscribeMsg> entry : subscribeMap.entrySet()) {
-					String sid = entry.getKey();
-					GpsSubscribeMsg subscribeMsg = entry.getValue();
-
-					double nowLat = location.getLatitude();
-					double nowLng = location.getLongitude();
-
-					//判断是否满足推送
-					boolean canPush = locationManager.isNeedPush(sid, nowLat, nowLng);
-					if (canPush) {
-						//执行发送GPS广播
-						//sendGpsBroadcast(...);
-
-						//推送成功立刻刷新订阅者基准坐标
-						locationManager.updateSubscriberPoint(sid, nowLat, nowLng);
-					}
-				}
-				
+                handleLocationUpdate(location);
            }

            @Override
            public void onStatusChanged(String provider, int status, Bundle extras) {
-                LogUtils.d(TAG, "Status changed: " + provider + ", status: " + status);
+                LogUtils.d(TAG, "GPS状态变更 -> 提供者：" + provider + " 状态：" + status);
            }

            @Override
            public void onProviderEnabled(String provider) {
-                LogUtils.d(TAG, "Provider enabled: " + provider);
+                LogUtils.d(TAG, "GPS提供者已启用：" + provider);
            }

            @Override
            public void onProviderDisabled(String provider) {
-                LogUtils.d(TAG, "Provider disabled: " + provider);
+                LogUtils.d(TAG, "GPS提供者已禁用：" + provider);
            }
        };
+    }

-        try {
-            if (mLocationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
-                mLocationManager.requestLocationUpdates(
-                    LocationManager.GPS_PROVIDER,
-                    1000,
-                    1,
-                    mLocationListener
-                );
-                LogUtils.d(TAG, "GPS location updates requested");
-                mIsRunning = true;
-                startForegroundNotification();
+    /**
+     * 处理每次定位刷新｜核心：步长判断 + 基准坐标更新
+     * 新增：同步最新坐标到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);
            }
-        } catch (SecurityException e) {
-            LogUtils.e(TAG, "Permission denied: " + e.getMessage());
        }
    }

-    private void createNotificationChannel() {
+    /**
+     * 创建系统通知渠道
+     */
+    private void createSystemNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-            NotificationChannel channel = new NotificationChannel(
-                CHANNEL_ID,
-                "GPS Relay Service",
-                NotificationManager.IMPORTANCE_LOW
+            NotificationChannel notificationChannel = new NotificationChannel(
+				CHANNEL_ID,
+				"GPS Relay Service",
+				NotificationManager.IMPORTANCE_LOW
            );
-            channel.setDescription("GPS Relay Sentinel service channel");
-            mNotificationManager.createNotificationChannel(channel);
+            notificationChannel.setDescription("GPSRelaySentinel 后台常驻服务通知");
+            mNotificationManager.createNotificationChannel(notificationChannel);
        }
    }

-    private void startForegroundNotification() {
+    /**
+     * 开启前台常驻通知
+     */
+    private void startServiceForegroundNotification() {
        mNotificationBuilder = new NotificationCompat.Builder(this, CHANNEL_ID)
-            .setContentTitle("GPS Relay Service")
-            .setContentText("Waiting for GPS data...")
-            .setSmallIcon(android.R.drawable.ic_menu_mylocation)
-            .setOngoing(true);
+			.setContentTitle("GPS 中继服务")
+			.setContentText("等待GPS定位数据...")
+			.setSmallIcon(android.R.drawable.ic_menu_mylocation)
+			.setOngoing(true);
+
        Notification notification = mNotificationBuilder.build();
        startForeground(NOTIFICATION_ID, notification);
    }

-    private void updateNotification(String gpsInfo) {
+    /**
+     * 动态更新通知内容
+     */
+    private void updateForegroundNotification(String locationText) {
        if (mNotificationBuilder != null) {
-            mNotificationBuilder.setContentText(gpsInfo + " | Count: " + mGpsCount);
+            mNotificationBuilder.setContentText(locationText + " | 定位次数：" + mGpsLocationCount);
            mNotificationManager.notify(NOTIFICATION_ID, mNotificationBuilder.build());
        }
    }
@@ -172,14 +254,16 @@ public class MainService extends Service {
    @Override
    public void onDestroy() {
        super.onDestroy();
+        //注销定位监听
        if (mLocationManager != null && mLocationListener != null) {
            try {
                mLocationManager.removeUpdates(mLocationListener);
            } catch (SecurityException e) {
-                LogUtils.e(TAG, "Permission denied when removing updates: " + e.getMessage());
+                LogUtils.e(TAG, "移除定位监听权限异常：" + e.getMessage());
            }
        }
        mIsRunning = false;
-        LogUtils.d(TAG, "Service onDestroy");
+        LogUtils.d(TAG, "MainService 已销毁，GPS监听已停止");
    }
 }
+
--- a/gpsrelaysentinel/src/main/res/drawable/border_gray.xml
+++ 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>
+
--- a/gpsrelaysentinel/src/main/res/layout/activity_about.xml
+++ 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>
--- a/gpsrelaysentinel/src/main/res/layout/activity_main.xml
+++ b/gpsrelaysentinel/src/main/res/layout/activity_main.xml
@@ -4,7 +4,8 @@
 	xmlns:app="http://schemas.android.com/apk/res-auto"
 	android:layout_width="match_parent"
 	android:layout_height="match_parent"
-	android:orientation="vertical">
+	android:orientation="vertical"
+	android:background="#1c1c1c">

 	<com.google.android.material.appbar.AppBarLayout
 		android:layout_width="match_parent"
@@ -19,40 +20,172 @@

 	</com.google.android.material.appbar.AppBarLayout>

-	<ScrollView
+	<!-- 数据面板容器 -->
+	<LinearLayout
+		android:id="@+id/container_data_panel"
+		android:orientation="vertical"
 		android:layout_width="match_parent"
-		android:layout_height="0dp"
-		android:layout_weight="1.0">
+		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:orientation="vertical"
-			android:layout_width="match_parent"
+			android:layout_width="wrap_content"
 			android:layout_height="wrap_content"
-			android:gravity="center_vertical|center_horizontal"
-			android:id="@+id/ll_main">
+			android:orientation="horizontal"
+			android:gravity="center_vertical"
+			android:layout_marginTop="8dp"
+			android:spacing="12dp">

-			<TextView
+			<CheckBox
+				android:id="@+id/checkbox_sim_mode"
 				android:layout_width="wrap_content"
 				android:layout_height="wrap_content"
-				android:text="GPSRelaySentinel"
-				android:textAppearance="?android:attr/textAppearanceLarge"/>
+				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:orientation="vertical"
 		android:layout_width="match_parent"
-		android:layout_height="0dp"
-		android:layout_weight="1.0">
+		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"
--- a/gpsrelaysentinel/src/main/res/layout/spinner_item_gray.xml
+++ 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"/>
+
--- a/gpsrelaysentinel/src/main/res/menu/menu_main.xml
+++ 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>
--- a/gpsrelaysentinel/src/main/res/values/arrays.xml
+++ 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>
+
--- a/gpsrelaysentinel/src/main/res/values/strings.xml
+++ b/gpsrelaysentinel/src/main/res/values/strings.xml
@@ -1,4 +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>
--- a/libgpsrelaysentinel/build.gradle
+++ b/libgpsrelaysentinel/build.gradle
@@ -9,7 +9,7 @@ android {
    buildToolsVersion "30.0.3"

    defaultConfig {
-        minSdkVersion 21
+        minSdkVersion 26
        targetSdkVersion 30
    }
    buildTypes {
@@ -18,8 +18,18 @@ android {
            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'])
 }
--- a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/SubscribeLocationManager.java
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/manager/SubscribeLocationManager.java
@@ -1,10 +1,5 @@
 package cc.winboll.studio.libgpsrelaysentinel.manager;

-/**
- * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
- * @Date 2026/05/07 10:26
- */
-
 import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
 import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
 import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;
@@ -15,12 +10,18 @@ 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(){
@@ -30,48 +31,70 @@ public final class SubscribeLocationManager {
        return instance;
    }

-    public void putSubscribeConfig(final String sid,final GpsSubscribeMsg msg){
+    //========= 订阅配置 =========
+    public void putSubscribeConfig(String sid,GpsSubscribeMsg msg){
        subscribeConfigMap.put(sid,msg);
    }

-    public void initSubscriberPoint(final String sid,double lat,double lng){
-        subscriberPointMap.put(sid,new LocationPoint(lat,lng,System.currentTimeMillis()));
-    }
-
-    public void updateSubscriberPoint(final String sid,double lat,double lng){
-        subscriberPointMap.put(sid,new LocationPoint(lat,lng,System.currentTimeMillis()));
-    }
-
-    public LocationPoint getLastPoint(final String sid){
-        return subscriberPointMap.get(sid);
-    }
-
-    public GpsSubscribeMsg getSubscribeConfig(final String sid){
+    public GpsSubscribeMsg getSubscribeConfig(String sid){
        return subscribeConfigMap.get(sid);
    }

-    public boolean isNeedPush(final String sid,double nowLat,double nowLng){
+    //========= 基准定点坐标 =========
+    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);
@@ -81,23 +104,25 @@ public final class SubscribeLocationManager {
        double latDiff = radLat1 - radLat2;
        double lngDiff = radLng1 - radLng2;

-        double result = 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)
-									  ));
-        result = result * GpsSubscribeConst.EARTH_RADIUS;
-        return result;
+        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(final String sid){
+    //========= 移除 & 清空 =========
+    public void removeSubscribe(String sid){
        subscribeConfigMap.remove(sid);
        subscriberPointMap.remove(sid);
+        subscriberPushCountMap.remove(sid);
    }

    public void clearAll(){
        subscribeConfigMap.clear();
        subscriberPointMap.clear();
+        subscriberPushCountMap.clear();
    }
 }

--- a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/service/GpsSubscribeReceiverService.java
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/service/GpsSubscribeReceiverService.java
@@ -4,136 +4,36 @@ import android.app.Service;
 import android.content.Intent;
 import android.os.IBinder;

-/**
- * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
- * @Date 2026/05/07 10:46
- */
-
-	import android.app.Service;
-	import android.content.Context;
-	import android.content.Intent;
-	import android.os.Binder;
-		import android.os.IBinder;
-		import android.os.RemoteException;
-
-	import java.util.List;
-import java.util.concurrent.CopyOnWriteArrayList;
-
-import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
+import cc.winboll.studio.libappbase.LogUtils;
 import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
-import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeResult;
 import cc.winboll.studio.libgpsrelaysentinel.model.LocationPoint;

 /**
- * 对外消息接收服务：外部App可bind或start
- * 收到GPS消息后，通过本地广播回调给外部App
+ * 全局消息接收父类服务
+ * 所有应用内接收服务全部继承此类
 */
-public final class GpsSubscribeReceiverService extends Service {
+public abstract class GpsSubscribeReceiverService extends Service {

-    // 外部回调监听
-    public interface GpsMessageListener {
-        void onGpsLocation(LocationPoint point, GpsSubscribeMsg config);
-        void onSubscribeResult(GpsSubscribeResult result);
+    public static final String TAG_PARENT = "GpsSubscribeReceiverService";
+
+    //当前绑定的视图订阅SID
+    protected String bindViewSid;
+
+    public void bindControlSid(String sid){
+        this.bindViewSid = sid;
    }

-    private final List<GpsMessageListener> listeners = new CopyOnWriteArrayList<GpsMessageListener>();
-    private final IBinder localBinder = new LocalBinder();
-
-    @Override
-    public void onCreate() {
-        super.onCreate();
+    /**
+     * 统一接收GPS推送入口
+     */
+    public void onReceiveGpsData(LocationPoint point, GpsSubscribeMsg config){
+        //父类统一日志溯源
+        LogUtils.d(TAG_PARENT,"【消息溯源】接收视图SID：" + bindViewSid);
    }

-    // 外部App绑定服务
    @Override
    public IBinder onBind(Intent intent) {
-        return localBinder;
-    }
-
-    // 外部App startService 入口：接收订阅请求
-    @Override
-    public int onStartCommand(Intent intent, int flags, int startId) {
-        if (intent != null && intent.getParcelableExtra("req") != null) {
-            GpsSubscribeMsg msg = intent.getParcelableExtra("req");
-            handleSubscribeRequest(msg);
-        }
-        return START_STICKY;
-    }
-
-    // 处理订阅请求：发送给管理器，并回执
-    private void handleSubscribeRequest(final GpsSubscribeMsg msg) {
-        // 加入订阅管理
-        cc.winboll.studio.libgpsrelaysentinel.manager.GpsSubscribeManager
-                .getInstance().addSubscribe(msg);
-        cc.winboll.studio.libgpsrelaysentinel.manager.SubscribeLocationManager
-                .getInstance().putSubscribeConfig(msg.getSubscribeUniqueId(), msg);
-
-        // 回执成功
-        GpsSubscribeResult result = new GpsSubscribeResult(
-                msg.getSubscribeUniqueId(),
-                GpsSubscribeConst.RESULT_SUCCESS,
-                "subscribe ok",
-                GpsSubscribeConst.GPS_STATE_LOCATED,
-                1000,
-                System.currentTimeMillis()
-        );
-        sendSubscribeResultBroadcast(result);
-        notifySubscribeResult(result);
-    }
-
-    // 供内部（GPS服务）调用：推送定位消息
-    public void pushLocation(final LocationPoint point, final GpsSubscribeMsg config) {
-        sendLocationBroadcast(point, config);
-        notifyGpsLocation(point, config);
-    }
-
-    // ---------- 广播回调（跨进程/外部App接收） ----------
-    private void sendLocationBroadcast(final LocationPoint point, final GpsSubscribeMsg config) {
-        Intent intent = new Intent(GpsSubscribeConst.ACTION_GPS_LOCATION);
-        intent.putExtra("point", point);
-        intent.putExtra("config", config);
-        sendBroadcast(intent);
-    }
-
-    private void sendSubscribeResultBroadcast(final GpsSubscribeResult result) {
-        Intent intent = new Intent(GpsSubscribeConst.ACTION_SUBSCRIBE_CALLBACK);
-        intent.putExtra("data", result);
-        sendBroadcast(intent);
-    }
-
-    // ---------- 本地Binder（同进程直接回调） ----------
-    public class LocalBinder extends Binder {
-        public GpsSubscribeReceiverService getService() {
-            return GpsSubscribeReceiverService.this;
-        }
-    }
-
-    public void addListener(final GpsMessageListener l) {
-        if (l != null && !listeners.contains(l)) {
-            listeners.add(l);
-        }
-    }
-
-    public void removeListener(final GpsMessageListener l) {
-        listeners.remove(l);
-    }
-
-    private void notifyGpsLocation(final LocationPoint point, final GpsSubscribeMsg config) {
-        for (GpsMessageListener l : listeners) {
-            l.onGpsLocation(point, config);
-        }
-    }
-
-    private void notifySubscribeResult(final GpsSubscribeResult result) {
-        for (GpsMessageListener l : listeners) {
-            l.onSubscribeResult(result);
-        }
-    }
-
-    @Override
-    public void onDestroy() {
-        listeners.clear();
-        super.onDestroy();
+        return null;
    }
 }

--- a/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/view/GpsSubscribeControlView.java
+++ b/libgpsrelaysentinel/src/main/java/cc/winboll/studio/libgpsrelaysentinel/view/GpsSubscribeControlView.java
@@ -1,174 +1,226 @@
 package cc.winboll.studio.libgpsrelaysentinel.view;

-/**
- * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
- * @Date 2026/05/07 10:27
- */
-
 import android.content.Context;
 import android.content.Intent;
-import android.content.IntentFilter;
+import android.os.Handler;
+import android.os.Looper;
 import android.util.AttributeSet;
-import android.view.View;
-import android.widget.CompoundButton;
+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;

-import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeConst;
-import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeMsg;
-import cc.winboll.studio.libgpsrelaysentinel.model.GpsSubscribeResult;
-import cc.winboll.studio.libgpsrelaysentinel.receiver.GpsSubscribeObserverReceiver;
-import cc.winboll.studio.libgpsrelaysentinel.util.TimeCountUtil;
-
 public final class GpsSubscribeControlView extends LinearLayout {

-    private RadioGroup rgSubMode;
-    private RadioButton rbAll;
-    private RadioButton rbStep;
-    private LinearLayout layoutStepSetting;
+    //常量抽取
+    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 Switch mSwitchSubscribe;
-    private TextView mTvCountTip;
-
-    private TimeCountUtil mTimeCountUtil;
-    private GpsSubscribeObserverReceiver mResultReceiver;
    private String currentSubscribeSid;
-    private boolean isSubscribeSuccess;
+    //一对一专属绑定的接收服务
+    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);
-        initView();
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationManager = SubscribeLocationManager.getInstance();
+        initView(context);
    }

    public GpsSubscribeControlView(Context context, AttributeSet attrs) {
        super(context, attrs);
-        initView();
+        mSubscribeManager = GpsSubscribeManager.getInstance();
+        mLocationManager = SubscribeLocationManager.getInstance();
+        initView(context);
    }

-    private void initView(){
-        setOrientation(VERTICAL);
-        inflate(getContext(),R.layout.view_gps_subscribe_control,this);
+    private void initView(Context context) {
+        LayoutInflater.from(context).inflate(R.layout.view_gps_subscribe_control, this, true);

-        rgSubMode = findViewById(R.id.rg_sub_mode);
-        rbAll = findViewById(R.id.rb_all);
-        rbStep = findViewById(R.id.rb_step);
-        layoutStepSetting = findViewById(R.id.layout_step_setting);
+        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);

-        mSwitchSubscribe = findViewById(R.id.switch_subscribe);
-        mTvCountTip = findViewById(R.id.tv_count_tip);
-
+        initDefaultConfig();
        initModeSwitch();
-        initCountUtil();
-        initReceiver();
-        initSwitchEvent();
+        initSubscribeSwitch();
+        startAutoRefreshRecord();
    }

-    private void initModeSwitch(){
-        rgSubMode.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() {
+    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) {
-					layoutStepSetting.setVisibility(checkedId == R.id.rb_step ? View.VISIBLE : View.GONE);
+					etStepMeter.setVisibility(checkedId == R.id.rb_mode_step ? VISIBLE : GONE);
 				}
 			});
    }

-    private void initCountUtil(){
-        mTimeCountUtil = new TimeCountUtil(new TimeCountUtil.OnCountListener() {
+    private void initSubscribeSwitch() {
+        switchSubscribe.setOnCheckedChangeListener(new android.widget.CompoundButton.OnCheckedChangeListener() {
 				@Override
-				public void onTimeOut() {
-					if(!isSubscribeSuccess){
-						mSwitchSubscribe.setChecked(false);
-						mTvCountTip.setText("订阅超时，已自动关闭");
-					}
-				}
-			});
-    }
-
-    private void initReceiver(){
-        mResultReceiver = new GpsSubscribeObserverReceiver();
-        mResultReceiver.setOnSubscribeResultListener(new GpsSubscribeObserverReceiver.OnSubscribeResultListener() {
-				@Override
-				public void onResultBack(GpsSubscribeResult result) {
-					if(currentSubscribeSid.equals(result.getSubscribeUniqueId())){
-						isSubscribeSuccess = true;
-						mTimeCountUtil.cancel();
-						mTvCountTip.setText("订阅已生效，通讯正常");
-					}
-				}
-			});
-        IntentFilter filter = new IntentFilter();
-        filter.addAction(GpsSubscribeConst.ACTION_SUBSCRIBE_CALLBACK);
-        getContext().registerReceiver(mResultReceiver,filter);
-    }
-
-    private void initSwitchEvent(){
-        mSwitchSubscribe.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
-				@Override
-				public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
-					if(isChecked){
+				public void onCheckedChanged(android.widget.CompoundButton buttonView, boolean isChecked) {
+					if (isChecked) {
 						startSubscribe();
-					}else{
+					} else {
 						stopSubscribe();
 					}
 				}
 			});
    }

-    private void startSubscribe(){
-        isSubscribeSuccess = false;
-        currentSubscribeSid = UUID.randomUUID().toString();
-        mTvCountTip.setText("等待订阅返回中...");
-
+    private void startSubscribe() {
        int subMode = GpsSubscribeConst.SUB_TYPE_ALL;
-        float stepMeter = 10.0f;
+        float stepVal = 10f;

-        if(rbStep.isChecked()){
+        if (rbModeStep.isChecked()) {
            subMode = GpsSubscribeConst.SUB_TYPE_STEP_DISTANCE;
-            try{
-                stepMeter = Float.parseFloat(etStepMeter.getText().toString().trim());
-            }catch (Exception e){
-                stepMeter = 10.0f;
-            }
+            try {
+                stepVal = Float.parseFloat(etStepMeter.getText().toString().trim());
+            } catch (Exception ignored) {}
        }

-        GpsSubscribeMsg msg = new GpsSubscribeMsg(
+        GpsSubscribeMsg subscribeMsg = new GpsSubscribeMsg(
 			getContext().getPackageName(),
 			subMode,
-			stepMeter,
+			stepVal,
 			GpsSubscribeConst.SUBSCRIBE_TYPE_LOCATION,
 			1000,
-			1.0f,
+			1f,
 			true,
 			currentSubscribeSid
        );

-        Intent intent = new Intent(GpsSubscribeConst.ACTION_SUBSCRIBE_REQUEST);
-        intent.putExtra("req",msg);
-        getContext().sendBroadcast(intent);
+        mSubscribeManager.addSubscribe(subscribeMsg);
+        mLocationManager.putSubscribeConfig(currentSubscribeSid, subscribeMsg);
+        mLocationManager.clearPushCount(currentSubscribeSid);

-        mTimeCountUtil.start(GpsSubscribeConst.SUBSCRIBE_TIME_OUT);
-    }
-
-    private void stopSubscribe(){
-        mTimeCountUtil.cancel();
-        isSubscribeSuccess = false;
-        mTvCountTip.setText("订阅已关闭");
-    }
-
-    public void release(){
-        mTimeCountUtil.cancel();
-        if(mResultReceiver != null){
-            getContext().unregisterReceiver(mResultReceiver);
+        //开启订阅自动启动专属接收服务
+        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();
+    }
 }

--- a/libgpsrelaysentinel/src/main/res/layout/view_gps_subscribe_control.xml
+++ b/libgpsrelaysentinel/src/main/res/layout/view_gps_subscribe_control.xml
@@ -3,97 +3,81 @@
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
-    android:padding="16dp">
-
-    <LinearLayout
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:orientation="horizontal"
-        android:gravity="center_vertical">
-
-        <TextView
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="订阅模式："
-            android:textSize="14sp"/>
-
-        <RadioGroup
-            android:id="@+id/rg_sub_mode"
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:orientation="horizontal">
-
-            <RadioButton
-                android:id="@+id/rb_all"
-                android:layout_width="wrap_content"
-                android:layout_height="wrap_content"
-                android:text="全消息订阅"
-                android:checked="true"/>
-
-            <RadioButton
-                android:id="@+id/rb_step"
-                android:layout_width="wrap_content"
-                android:layout_height="wrap_content"
-                android:text="步长订阅"/>
-        </RadioGroup>
-    </LinearLayout>
-
-    <LinearLayout
-        android:id="@+id/layout_step_setting"
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:orientation="horizontal"
-        android:layout_marginTop="10dp"
-        android:gravity="center_vertical"
-        android:visibility="gone">
-
-        <TextView
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="移动步长阈值(米)："
-            android:textSize="14sp"/>
-
-        <EditText
-            android:id="@+id/et_step_meter"
-            android:layout_width="80dp"
-            android:layout_height="wrap_content"
-            android:inputType="numberDecimal"
-            android:text="10"
-            android:gravity="center"/>
-    </LinearLayout>
-
-    <LinearLayout
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:orientation="horizontal"
-        android:gravity="center_vertical"
-        android:layout_marginTop="12dp">
-
-        <TextView
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"
-            android:text="GPS订阅总开关"
-            android:textSize="14sp"/>
-
-        <View
-            android:layout_width="0dp"
-            android:layout_height="1dp"
-            android:layout_weight="1"/>
-
-        <Switch
-            android:id="@+id/switch_subscribe"
-            android:layout_width="wrap_content"
-            android:layout_height="wrap_content"/>
-    </LinearLayout>
+    android:padding="14dp"
+    android:layout_marginVertical="6dp"
+    android:background="#282828"
+    android:clipToPadding="false">

+    <!-- SID标识 -->
    <TextView
-        android:id="@+id/tv_count_tip"
+        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:layout_marginTop="8dp"
-        android:text="未订阅"
-        android:textSize="12sp"
-        android:textColor="#666666"/>
+        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>
Author	SHA1	Message	Date
LaizyBoy	a3855b4375	docs: 重构 gpsrelaysentinel/README.md 中英文双语文档 - 中文文档新增核心功能清单（双模式运行、前台服务、订阅者管理、模拟面板、日志输出、崩溃处理、关于页面） - 技术栈改用表格展示，模块说明更新为实际编译模块（:gpsrelaysentinel 与 :libgpsrelaysentinel） - 核心依赖库分类更清晰（网络、终端模拟、功能组件、UI 组件） - 项目结构树精确到具体 Java 源文件及其功能说明 - 权限说明改为具体 Android 权限声明 - 新增完整英文版本文档（Project Introduction、Core Features、Tech Stack、Module Structure、Core Dependencies、Build Instructions、Permissions、Project Structure、Contributing、License） - 删除失效的参考文档链接	2026-05-07 16:25:40 +08:00
LaizyBoy	d5100a8aa4	feat: MainActivity工具栏添加About按钮跳转AboutActivity窗口 - 新增菜单资源文件 res/menu/menu_main.xml - MainActivity 添加 onCreateOptionsMenu() 加载菜单 - MainActivity 添加 onOptionsItemSelected() 处理 About 按钮点击事件 - 点击 About 按钮后通过 Intent 启动 AboutActivity	2026-05-07 16:17:37 +08:00
ZhanGSKen	e17929c09b	添加应用介绍窗口编译资源。	2026-05-07 15:57:54 +08:00
LaizyBoy	332c7ee21c	双剑合璧。 Merge remote-tracking branch 'origin/gpsrelaysentinel' into gpsrelaysentinel	2026-05-07 15:20:33 +08:00
LaizyBoy	20cb50ff29	feat(gpsrelaysentinel): 模拟GPS发送面板与订阅系统重构 [主应用] - MainActivity: 新增模拟移动GPS发送面板(方向/距离/目标坐标预览/静态坐标同步) - MainService: 代码模块化重构，方法拆分，实时同步最新GPS到MainActivity - 新增3个子服务 GpsReceiverChildService1/2/3 - activity_main.xml: 深色主题改版，新增模拟面板、订阅面板容器、日志容器 - 新增资源: border_gray.xml、spinner_item_gray.xml、arrays.xml(8方向) [类库] - SubscribeLocationManager: 新增精准推送计数统计，公开配置查询方法 - GpsSubscribeReceiverService: 改为抽象父类，统一 onReceiveGpsData 入口 - GpsSubscribeControlView: 移除广播/倒计时，改用Manager直调+Handler自动刷新 - view_gps_subscribe_control.xml: 深色主题，新增SID标识与订阅数据记录表	2026-05-07 15:18:38 +08:00
LaizyBoy	498372c914	fix(libgpsrelaysentinel): 对齐 minSdk 与 Java 编译配置 - minSdkVersion 21 -> 26，与 gpsrelaysentinel 主模块及 API 26~30 要求一致 - 新增 compileOptions 设置 Java 7 编译，与项目 Java 语法规范统一	2026-05-07 15:10:09 +08:00
ZhanGSKen	e147d46921	添加示例服务类注册	2026-05-07 14:41:12 +08:00
ZhanGSKen	42d135068c	改进应用主窗口与调试接口UI	2026-05-07 14:39:49 +08:00
ZhanGSKen	ceeacb5022	改进应用主要服务启动类	2026-05-07 14:38:56 +08:00
ZhanGSKen	e24c9bdce3	改进GPS订阅服务发送框架	2026-05-07 14:37:07 +08:00
ZhanGSKen	9c16685c1f	添加应用GPS订阅示例服务类	2026-05-07 14:35:58 +08:00
ZhanGSKen	6ffcbbc4f4	添加模拟方位下拉列表项的视图资源	2026-05-07 14:34:33 +08:00
ZhanGSKen	3c39225087	添加灰色边框资源，用于辅助深色视图渲染。	2026-05-07 14:32:58 +08:00
ZhanGSKen	39b4761e49	添加定向方位数组	2026-05-07 14:30:50 +08:00
ZhanGSKen	534ec28637	更新Maven库基础类库	2026-05-07 14:08:54 +08:00