栏目字体与分段调整

README.md

@@ -1,175 +1,103 @@
-## OriginMaster
+# WinBoLL 源生态计划项目说明书
-【OriginMaster】WinBoLL 源生态计划。正如话，我需要一个 Point, 去撬动成个地球。
-WinBoLL系列项目各个项目源码合并推送方向：
-WinBoLL=>APPBase=>OriginMaster
-WinBoLL=>AES=>OriginMaster
-WinBoLL=>PowerBell=>OriginMaster
-WinBoLL=>Positions=>OriginMaster
-仓库规划概述：
-☆ WinBoLL,APPBase,AES,PowerBell与Positions都是开发库。
-☆ OriginMaster 是分支汇总存档库。
-☆ OriginMaster 不适宜作为开发库克隆使用，不是应用开发基础库，而是汇总资料库。
-☆ WinBoLL 库可以作为应用开发的基础继承模板。
 
-########
+## 一、项目概述
-## ☁ ☁ ☁ WinBoLL APP ☁ ☁ ☁ ☁ ☁ ☁   ☁ ☁   ☁  ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁ ☁ ☁ 
-# ☁    ☁ WinBoLL Studio Android 应用开源项目。☁ ☁   ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁ ☁  ☁ ☁ 
-# ☁ ☁ ☁ WinBoLL 网站地址 https://www.winboll.cc/ ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
-# ☁ ☁ ☁ WinBoLL 源码地址 <https://gitea.winboll.cc/Studio/WinBoLL.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁
-# ☁ ☁ ☁ GitHub 源码地址 <https://github.com/ZhanGSKen/WinBoLL.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
-# ☁ ☁ ☁ 码云 源码地址 <https://gitee.com/zhangsken/winboll.git> ☁ ☁ ☁ ☁  ☁ ☁ ☁ ☁
-# ☁ ☁ ☁ 在 jitpack.io 托管的 APPBase 类库源码<https://github.com/ZhanGSKen/APPBase.git> ☁ ☁ ☁ ☁  
-# ☁ ☁ ☁ 在 jitpack.io 托管的 AES 类库源码<https://github.com/ZhanGSKen/AES.git> ☁ ☁ ☁ ☁  
-## WinBoLL 提问
-同样是 /sdcard 目录，在开发 Android 应用时，
-能否实现手机编译与电脑编译的源码同步。
-☁因而 WinBoLL 项目组诞生了。
 
-## WinBoLL 项目组研发计划
+### 1. 核心定位
-致力于把 WinBoLL-APP 应用在手机端 Android 项目开发。
+WinBoLL 手机源码计划，旨在通过核心项目 WinBoLL 构建手机端与服务器端的 Android 项目的开发源码生态。实现手机与服务器的源码的联合开发。
-也在探索 https://gitea.winboll.cc/<WinBoLL 项目组>/APP.git 应用于 WinBoLL-APP APK 分发。
-更想进阶 https://github.com/<WinBoLL 项目组>/APP.git 应用于 WinBoLL-APP Beta APK 分发。
 
-## WinBoLL-APP 汗下...
+### 2. 仓库架构
-#### ☁应用何置如此呢。且观用户云云。
+#### **仓库类型：功能说明**
+☆ 基础项目分支 WinBoLL：手机端安卓应用开发基础模板。
+☆ 应用项目分支 APPBase、AES、PowerBell、Positions**：安卓应用单一管理系列项目。
+☆ 源码汇总管理 OriginMaster**：各类分支源码合并存档，不适宜作为开发库使用。
 
-#### ☁ 正当下 ☁ ###
+### 3. 源码合并管理推送路线图
-#### ☁ 且容傻家叙说 ☁ WinBoLL-APP 应用场景
+⚠️ **注意**：仅仅展示不同应用模块源码的综合管理路线。分支合并操作时，必须具备 Git 管理经验。
-### ☁ WinBoLL 设备资源概述
-#### ☁ 1. Raid Disk.
-概述：这是一个矩阵存储类设备。
-优点：该设备具有数据容错存储功能，
-     数据存储具有特长持久性。
-缺点：设备使用能源消耗比较高，
-     设备存取速度一般。
-     
-#### ☁ 2. Data Disk.
-概述：这是一个普通硬盘存储设备
-优点：该设备独立于操作系统，
-     数据持久性一般，
-     存取能源消耗小于 Raid Disk。
-缺点：数据存储速度一般，存储能源消耗一般。
 
-#### ☁ 3. SSD Disk.
+★ WinBoLL → APPBase → OriginMaster
-概述：这是一个 SSD 硬盘存储设备。
+★ WinBoLL → AES → OriginMaster
-优点：存取速度快于 Data Disk 与 Raid Disk，
+★ WinBoLL → PowerBell → OriginMaster
-     存取能源消耗小于 Data Disk 与 Raid Disk。
+★ WinBoLL → Positions → OriginMaster
-缺点：数据持久性一般，
-     设备位于操作系统内部文件系统。
-     数据持久性与操作系统挂钩。
-     
-#### ☁ 4. WinBoLL 用户资源概述。
-1> /home/<用户名> 位于 WinBoLL 操作系统目录下。
-2> /rdisk/<用户名> 挂载用户 Raid Disk.
-3> /data/<用户名> 挂载用户 Data Disk.
-4> /sdcard/<用户名> 挂载用户 SSD Disk.
 
-#### ☁ 5. WinBoLL-APP 用户资源概述。
+## 二、WinBoLL 项目核心信息
-1> /sdcard 挂载用户手机 SD 存储/storage/emulated/0
 
-### ☁ 稍稍歇 ☁ ###
+### 1. 项目简介
-### ☁ 急急停 ☁ WinBoLL 应用前置条件
+☆ WinBoLL 项目是为手机端开发Android 项目的需求而设计的项目。
-☁ WinBoLL 主机建立 1Panel MySQL 应用。
-☁ WinBoLL 主机建立 1Panel Gitea 应用。
-☁ WinBoLL 主机设置 WinBoLL 应用为非登录状态。
-☁ WinBoLL 主机建立 WinBoLL 账户与 WinBoLL 用户组。
-☁ WinBoLL 账户 User ID 为： J。
-☁ WinBoLL 用户组 Group ID 为： Studio。
-☁ WinBoLL 主机 WinBoLL 1Panel Gitea 建立 WinBoLL 工作组。
-☁ WinBoLL 主机 WinBoLL 1Panel Gitea 用户项目 APK 编译输出目录为 /sdcard/WinBoLLStudio/<用户名>/APKs/
-☁ WinBoLL 项目配置文件示例为 "<WinBoLL 项目根目录>/.winboll/winboll.properties-demo"(WinBoLL 项目已设置)
-☁ WinBoLL 项目配置文件为 "<WinBoLL 项目根目录>/.winboll/winboll.properties"
-☁ WinBoLL 项目配置文件设定为源码提交时忽略。(WinBoLL 项目已设置)
-☁ Gradle 项目配置文件示例为 "<WinBoLL 项目根目录>/.winboll/local.properties-demo"(WinBoLL 项目已设置)
-☁ Gradle 项目配置文件为 "<WinBoLL 项目根目录>/local.properties"(WinBoLL 项目已设置)
-☁ Gradle 项目配置文件设定为源码提交时忽略。(WinBoLL 项目已设置)
 
-### ☁ 登高处 ☁ WinBoLL 应用需求规划
+### 2. 官方资源
-☁ WinBoLL 主机建立 WinBoLL 客户端用户数据库为 MySQL winbollclient 数据库。
+#### ☆ 官方网站**：https://www.winboll.cc/
-☁ WinBoLL 主机设置 WinBoLL 客户端用户信息存储在 winbollclient 数据库中。
+#### ☆ 源码地址：
-☁ MySQL winbollclient 数据库中
+★ Gitea：https://gitea.winboll.cc/Studio/WinBoLL.git
-   WinBoLL 客户端用户信息设定为：
+★ GitHub：https://github.com/ZhanGSKen/WinBoLL.git
-   <用户名, 验证密码, 验证邮箱, 验证手机, 唯一存储令牌Token, 备用验证邮箱>。
+★ 码云：https://gitee.com/zhangsken/winboll.git
-☁ WinBoLL 项目源码仓库托管在 WinBoLL 1Panel Gitea 目录 /opt/1panel/apps/gitea/gitea/data/git/repositories/studio/app.git中。
-☁ WinBoLL 主机提供 WinBoLL 1Panel Gitea 应用的 WinBoLL 项目源码仓库存取功能。（Gitea 应用已提供）
-☁ WinBoLL 主机提供 WinBoLL Gitea 项目仓库存档功能。（Gitea 应用已提供）
-☁ 提供 WinBoLL 客户端用户登录功能。（Gitea 应用已提供）
 
-### ☁ 看远方 ☁ ###
+## 三、应用编译环境检查问题
-### ☁ 心忧虑 ☁ WinBoLL-APP 应用前置需求
+### 核心判断条件：
-☁ WinBoLL-APP WinBoLL 项目根目录设定为手机的 /sdcard/WinBoLLStudio/Sources 目录。（需要用户手动建立文件夹）
+☆ WinBoLL 项目以文件夹 `"/sdcard/WinBoLLStudio/APKs"` 是否存在为判断环境编译输出条件，因为编译输出的APK文件需要一个可供保存的环境。
-☁ WinBoLL-APP 具有手机 /sdcard/WinBoLL 目录的存储权限。（需要手机操作系统授权）
-☁ WinBoLL-APP WinBoLL 项目仓库源码存储路径为 /sdcard/WinBoLLStudio/Sources/APP.git（需要用户手动建立文件夹）
-☁ WinBoLL-APP 项目 APK 编译输出目录为 /sdcard/WinBoLLStudio/APKs/
-☁ WinBoLL-APP 应用签名验证可定制化。（WinBoLL 项目已提供）
-☁ WinBoLL-APP 与系列衍生 APP 应用共享 cc.winboll.studio 命名空间资源。（WinBoLL 项目已提供）
-☁ WinBoLL-APP 用户客户端信息存储在命名空间为 WinBoLL APP MySQLLite 应用的 winbollappclient 数据库中。
-☁ WinBoLL-APP MySQLLite 应用的 winbollappclient 数据库中， 
-   WinBoLL 用户客户端信息设定为：
-   <用户名, 唯一存储令牌Token>。
 
-### ☁ 云游四方 ☁ ###
+☆ 文件夹"/sdcard/WinBoLLStudio/APKs" 目录条件设置方法：
-### ☁ 呔！ ☁ WinBoLL-APP 应用需求规划
+***Linux 服务器端方面***：建立 `/sdcard/WinBoLLStudio/APKs` 目录即可。
-☁ 如要使用 WinBoLL Android 项目的 Gradle 编译功能，则需要设置以下两个文件夹。
+***手机开发端方面***：建立 `"/sdcard/WinBoLLStudio/APKs"` 目录(即 `"/storage/emulated/0/WinBoLLStudio/APKs"` 目录) 即可。
-☁ 1. 则需要建立数据存储目录 /sdcard/WinBoLLStudio/APKs。
-   WinBoLL 项目源码编译出来的安装包会拷贝一份到 /sdcard/WinBoLLStudio/APKs 目录下。 
-☁ 2. 则需要建立数据存储目录 /sdcard/AppProjects。
-   WinBoLL 项目源码编译出来的安装包会拷贝一份并命名 "app.apk" 的安装文件为到 /sdcard/AppProjects 目录下。 
 
+## 四、前置条件
 
-### ☁ 吁！ ☁ WinBoLL-APP 共享计划前景
+### 1. WinBoLL APP 开发环境配置介绍
-☁ WinBoLL-APP 将会实现 https://winboll.cc/api 访问功能。
+####  WinBoLL APK 编译输出内容包括：
-☁ WinBoLL-APP 将会实现手机端 Android 应用的开发与管理功能。
+☆ "/sdcard/WinBoLLStudio/APKs"` 目录内的所有应用分支的 APK 文件。
+☆ "/sdcard/AppProjects/app.apk"文件。
+#### WinBoLL APK 源码命名空间规范
+☆ WinBoLL 项目使用 "cc.winboll.studio" 作为源码命名空间。在此命名空间下进行源码定义。
 
-## ☁ WinBoLL ☁ WinBoLL 主机忧虑
+## 五、核心需求规划
-☁ WinBoLL 将会提供 gitea.winboll.cc 域名用户注册登录功能。
-☁ WinBoLL 将会提供 WinBoLL-APP 及其衍生应用的 Gitea 仓库管理服务。
-☁ WinBoLL 将会提供 winboll.cc 域名 WinBoLL 项目组注册登录功能。
 
-# 本项目要实际运用需要注意以下几个步骤：
+### 1. WinBoLL 应用安全验证需求
-# 在项目根目录下：
+#### ☆ 支持访问 https://console.winboll.cc/ 服务器以校验应用包签名与版本。
-## ★. 项目模块编译环境设置(必须)，settings.gradle-demo 要复制为 settings.gradle，并取消相应项目模块的注释。
-## ★. 项目模块编译环境设置(必须) 在根目录拷贝 gradle.properties-androidx-demo 或者 gradle.properties-android-demo 文件为 gradle.properties。
-## ★. 项目 Android SDK 编译环境设置(可选)，local.properties-demo 要复制为 local.properties，并按需要设置 Android SDK 目录。
-## ★. 应用签名密钥 keystore 设置问题。一般调试编译只需用【Termux】cd 进 GenKeyStore 目录执行 $ bash gen_debug_keystore.sh 命令即可完成设置。
-## ☆. 应用 WiBoLL 签名密钥配置问题<非必须考虑>。设置时需要 clone 【keystore】模块源码并拷贝模块目录的 appkey.jks 与 appkey.keystore 到项目根目录即可。
-## ☆. 类库型模块编译环境设置(可选)，winboll.properties-demo 要复制为 winboll.properties，并按需要设置 WinBoLL Maven 库登录用户信息， 和 APK 文件额外输出路径。
 
+### 2. 手机端源码开发管理需求
+#### ☆ 支持切换不同 WinBoLL 分支，以开发不同安卓应用。
 
-# ☆类库型项目编译方法
+## 六、编译与使用指南
-## 先编译类库对应的模块测试项目
-### 修改模块测试项目的 build.properties 文件
-设置属性 libraryProject=<类库项目模块文件夹名称>
-### 再编译测试项目
-$ bash .winboll/bashPublishAPKAddTag.sh <应用项目模块文件夹名称>
-#### 测试项目编译后，编译器会复制一份 APK 到 路径："/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/" 文件夹。
-#### 若是 winboll.properties 文件的 [ExtraAPKOutputPath] 属性设置了路径。编译器也会复制一份 APK 到这个路径。
-### 最后编译类库项目
-$ bash .winboll/bashPublishLIBAddTag.sh <类库项目模块文件夹名称>
-#### 类库模块编译命令执行后，编译器会发布到 WinBoLL Nexus Maven 库：Maven 库地址可以参阅根项目目录配置 build.gradle 文件。
-             
-# ☆应用型项目编译方法
-## 直接调用以下命令编译应用型项目
-$ bash .winboll/bashPublishAPKAddTag.sh <应用项目模块文件夹名称>
-#### 应用模块编译命令执行后，编译器会复制一份 APK 到
-#### 测试项目编译后，编译器会复制一份 APK 到 路径："/sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/" 文件夹。
-#### 若是 winboll.properties 文件的 [ExtraAPKOutputPath] 属性设置了路径。编译器也会复制一份 APK 到这个路径。
 
-## ☆应用调试编译方法
+### 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` 文件到项目根目录即可。
 
-### Beta调试使用：
+## 七、应用编译命令介绍
-$ bash gradlew assembleBetaDebug
 
-### Stage调试使用：
+### （1）类库型模块配置要点
-$ bash gradlew assembleStageDebug
+#### 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 库。
 
-### 若是 winboll.properties 文件的 [ExtraAPKOutputPath] 属性设置了路径。编译器也会复制一份 APK 到这个路径。
+### （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）手机端应用调试命令介绍
-## statge 渠道
+#### ☆ Beta 渠道调试命令
-V<应用开发环境编号><应用功能变更号><应用调试阶段号>
+$bash gradlew assembleBetaDebug
-如：APPBase_15.7.0
+
-## beta 渠道
+#### ☆ Stage 渠道调试命令
-V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)>
+$bash gradlew assembleStageDebug
-如：APPBase_15.9.6-beta8_5413
+
+### （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 ）

winboll/build.gradle

@@ -109,7 +109,7 @@ dependencies {
 	
 	// WinBoLL库 nexus.winboll.cc 地址
 	api 'cc.winboll.studio:libaes:15.15.2'
-    api 'cc.winboll.studio:libappbase:15.15.7'
+    api 'cc.winboll.studio:libappbase:15.15.11'
 	
 	// WinBoLL备用库 jitpack.io 地址
 	//api 'com.github.ZhanGSKen:AES:aes-v15.15.7'

winboll/build.properties

@@ -1,8 +1,8 @@
 #Created by .winboll/winboll_app_build.gradle
-#Fri Jan 23 06:00:53 HKT 2026
+#Mon Mar 16 19:52:21 GMT 2026
-stageCount=12
+stageCount=26
 libraryProject=
 baseVersion=15.11
-publishVersion=15.11.11
+publishVersion=15.11.25
-buildCount=0
+buildCount=29
-baseBetaVersion=15.11.12
+baseBetaVersion=15.11.26

winboll/src/main/AndroidManifest.xml

@@ -18,7 +18,7 @@
 		tools:ignore="QueryAllPackagesPermission" />
 	<!-- 可选：兼容低版本系统 -->
 	<uses-permission android:name="android.permission.GET_PACKAGE_SIZE" />
-		
+
     <application
         android:allowBackup="true"
         android:icon="@drawable/ic_launcher"
@@ -291,6 +291,18 @@
 
         <activity android:name="cc.winboll.studio.winboll.unittest.TermuxEnvTestActivity"/>
 
+		<activity
+			android:name=".termux.NfcTermuxBridgeActivity"
+			android:exported="true"> <!-- 必须设置为 true，允许外部应用调用 -->
+
+			<!-- 接收 ACTION_BUILD 意图 -->
+			<intent-filter>
+				<action android:name="cc.winboll.studio.winboll.termux.NfcTermuxBridgeActivity.ACTION_BUILD" />
+				<category android:name="android.intent.category.DEFAULT" />
+			</intent-filter>
+
+		</activity>
+
     </application>
 
 </manifest>

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

@@ -122,7 +122,7 @@ public class MainActivity extends DrawerFragmentActivity {
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
         getMenuInflater().inflate(R.menu.toolbar_main, menu);
-		if (!App.isDebugging()) {
+		if (App.isDebugging()) {
 			getMenuInflater().inflate(R.menu.toolbar_test, menu);
 		}
         return super.onCreateOptionsMenu(menu);

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）
+}
+

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();
+				}
+			});
+    }
+}
+

winboll/src/main/java/cc/winboll/studio/winboll/unittest/TermuxEnvTestActivity.java

@@ -1,5 +1,6 @@
 package cc.winboll.studio.winboll.unittest;
 
+import android.app.Activity;
 import android.os.Bundle;
 import android.os.Handler;
 import android.os.Looper;
@@ -7,11 +8,11 @@ import android.view.View;
 import android.widget.TextView;
 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.winboll.MainActivity;
+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;
@@ -19,7 +20,6 @@ import java.io.FileInputStream;
 import java.io.IOException;
 import java.io.InputStreamReader;
 import java.nio.charset.StandardCharsets;
-import android.app.Activity;
 
 /**
  * @Author 豆包&ZhanGSKen<zhangsken@qq.com>
@@ -38,8 +38,8 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
 
     // 常量属性（置顶排列）
     public static final String TAG = "TermuxEnvTestActivity";
-    private static final String TERMUX_HOME_PATH = "/sdcard/WinBoLLStudio";
+    private static final String TERMUX_HOME_PATH = "/data/data/com.termux/files/home/TermuxWorkSpaces";
-    private static final String CMD_RESULT_FILE = TERMUX_HOME_PATH + "/.authcenter_cmd_result.tmp";
+    private static final String CMD_RESULT_FILE = TERMUX_HOME_PATH + "/CMD_RESULT_FILE.log";
 
     // 成员属性（常量后排列）
     private Toolbar mToolbar;
@@ -103,12 +103,12 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
         ((AppCompatActivity) getActivity()).getSupportActionBar().setDisplayHomeAsUpEnabled(true);
 
         mToolbar.setNavigationOnClickListener(new View.OnClickListener() {
-            @Override
+				@Override
-            public void onClick(View v) {
+				public void onClick(View v) {
-                LogUtils.d(TAG, "initToolbar() 导航栏返回按钮点击");
+					LogUtils.d(TAG, "initToolbar() 导航栏返回按钮点击");
-                getActivity().finish();
+					getActivity().finish();
-            }
+				}
-        });
+			});
 
         LogUtils.d(TAG, "initToolbar() 初始化完成");
     }
@@ -158,7 +158,7 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
     /**
      * 测试执行Gradle命令（实时输出版，唤起Termux窗口）
      */
-    public void onTestTermuxCMD(View view) {
+    public void onTestTermuxGradleBuildCMD(View view) {
         LogUtils.d(TAG, "onTestTermuxCMD() 按钮点击，执行Gradle命令（实时输出）");
         tvMessage.append("\n【测试：执行Gradle命令（实时输出）】\n");
 
@@ -171,7 +171,7 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
 
         // 2. 定义核心路径（确保路径与Termux中一致）
         String gradleFullPath = "/data/data/com.termux/files/home/gradle/gradle-7.5.1/bin/gradle";
-        String projectPath = TERMUX_HOME_PATH + "/Sources/WinBoLL"; // 项目目录
+        String projectPath = TERMUX_HOME_PATH + "/Sources/DebugTemp"; // 项目目录
 
         // 3. 构造命令（核心：用stdbuf禁用缓冲，实现实时输出）
         String targetCmd = "";
@@ -216,7 +216,17 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
         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");
@@ -230,7 +240,7 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
 
         // 2. 定义核心路径（确保路径与Termux中一致）
         String gradleFullPath = "/data/data/com.termux/files/home/gradle/gradle-7.5.1/bin/gradle";
-        String projectPath = TERMUX_HOME_PATH + "/Sources/WinBoLL"; // 项目目录
+        String projectPath = TERMUX_HOME_PATH + "/"; // 项目目录
 
         // 3. 构造命令（核心：用stdbuf禁用缓冲，实现实时输出）
         String targetCmd = "";
@@ -275,7 +285,7 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
         tvMessage.append("💡 若未实时输出，请在Termux中执行：pkg install coreutils（安装stdbuf）\n");
         tvMessage.append("-------------------------\n");
     }
-	
+
     /**
      * 跨包读取Termux命令结果文件（保留原功能，兼容其他场景）
      */
@@ -399,7 +409,7 @@ public class TermuxEnvTestActivity extends BaseWinBoLLActivity {
             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);

winboll/src/main/res/layout/activity_termux_env_test.xml

@@ -16,25 +16,35 @@
 		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="OpenTermuxBash"
+			android:text="Open Termux Bash"
 			android:onClick="onOpenTermuxBash"/>
 
 		<Button
+			android:textAllCaps="false"
 			android:layout_width="wrap_content"
 			android:layout_height="wrap_content"
-			android:text="TestTermuxCMD"
+			android:text="Test Termux Gradle Build CMD"
-			android:onClick="onTestTermuxCMD"/>
+			android:onClick="onTestTermuxGradleBuildCMD"/>
 
 		<Button
+			android:textAllCaps="false"
 			android:layout_width="wrap_content"
 			android:layout_height="wrap_content"
-			android:text="TestTermuxEnv"
+			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