react-native-idosdk 1.0.4 → 1.0.6

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+本文档记录 `react-native-idosdk` 的版本变更。从 `1.0.6` 开始维护。
+
+## [1.0.6] - 2026-07-13
+
+### 变更
+
+- Android 原生模块包名调整为 `com.getui.reactnativeido`。
+- Android 依赖由随包 JAR 迁移至个推 Maven 仓库，使用 `gsido 1.4.14.0` 与 `gtc 3.3.3.0`。
+- 调整 Android Manifest 合并规则，保留应用侧配置的 `GETUI_APPID`、`GT_INSTALL_CHANNEL` 和 `GTSDK_VERSION`。
+- AndroidDemo 改为直接引用当前插件工程，并补充 `GT_INSTALL_CHANNEL` 配置，便于联调 `1.0.6`。
+- 更新 React Native、Android、iOS 和 HarmonyOS 集成文档，移除旧推送插件的配置和 API 说明。
+
+### 兼容性
+
+- Android 最低 `minSdkVersion` 为 `23`。
+- iOS 最低部署版本为 `12.0`。

package/README.md

@@ -1,104 +1,92 @@
-
 # react-native-idosdk
-* idosdk 是个推官方开发的 IDOSDK React Native 插件，使用该插件可以方便快速地集成推送功能。
-
-
-# 环境
-
-1. React Native Version 
-   "react": "18.3.1"
-   "react-native": "0.75.4"
-2. 当前react-native-idosdk版本 1.0.4
 
+个推 IDOSDK 的 React Native 插件，用于接入运营统计、事件采集和用户画像能力。
 
-# 1.安装
+当前版本：`1.0.6`。
 
-### 1.1 使用 npm 自动安装
+## 安装
 
-在您的项目根目录下执行
+在 React Native 项目根目录执行：
 
-````js
-step1:添加npm包依赖
- npm install react-native-idosdk@latest --save 
+```sh
+npm install react-native-idosdk@1.0.6 --save
+```
 
+React Native 0.60 及以上项目会自动链接原生模块。iOS 项目还需要安装 Pods：
 
-step2:iOS, pod项目, 链接iOS原生代码
+```sh
 npx pod-install
+```
 
+Android 示例工程使用 React `19.0.0` 和 React Native `0.79.1`。请按项目所用 React Native 版本完成原生环境配置。
 
-step2: 链接 (非Autolinking项目, 和iOS非pod项目)
-react-native link
-````
+## 配置
 
-### 1.2 完整代码示例
- 
- *[AndroidDemo](example/AndroidDemo)
- *[iOSDemo](example/iOSDemo)
+应用 AppID 请在[个推开发者中心](https://dev.getui.com)创建应用后获取。
 
-# 2. 配置
+### Android
 
-* appId 需要去 [个推官网](https://dev.getui.com) 注册后，在后台配置获取。
+在 `android/app/src/main/AndroidManifest.xml` 的 `<application>` 节点内配置 AppID 和安装渠道：
 
+```xml
+<meta-data android:name="GETUI_APPID" android:value="你的 AppID" />
+<meta-data android:name="GT_INSTALL_CHANNEL" android:value="" />
+```
 
-## 2.1 Android
-* AndroidManifest.xml中添加配置
-````xml
-   <manifest>
-    <application>
-           <meta-data android:name="GETUI_APPID" android:value="你的appid"/>
-           <meta-data android:name="GT_INSTALL_CHANNEL" android:value=""/>
-      </application>
-   </manifest>
-````
-* 如果开启混淆
-````proguard
-  -keep class com.getui.gs.** { *; }
-  -keep class com.getui.gtc.** {*;}
-````
- 
-## 2.2 IOS
- 
+插件已声明 IDOSDK 所需的原生依赖、权限和组件。无需添加 `react-native-getui`、`PUSH_APPKEY` 或 `PUSH_APPSECRET` 等旧推送插件配置。详细说明见[Android 集成文档](document/android.md)。
 
-### 2.2.2 使用CocoaPods安装 
+### iOS
 
-如果是原生应用集成react-native
+使用 Autolinking 时只需执行 `npx pod-install`。旧项目如未启用 Autolinking，可在目标 target 的 `Podfile` 中加入：
 
-如果你的 React Native 是通过 Cocoapods 来集成的则使用下面两个步骤来集成 
-
-1. 在Podfile中添加如下代码（需要写在对应的 target 里）：
-
-````
+```ruby
 pod 'IdoSdkRN', :path => '../node_modules/react-native-idosdk'
+```
 
-````
-
-2. 终端执行如下命令：
-
-````
-pod install
+然后执行 `pod install`。IDOSDK 不需要在 `AppDelegate` 中注册推送、DeviceToken 或 VoIP；初始化请在 JavaScript 中调用 `startSdk`。详细说明见[iOS 集成文档](document/iOS.md)。
 
-````
+### HarmonyOS
 
-**注意:** 
+HarmonyOS 当前需要手动 Link，完整流程见[鸿蒙文档](react-native-harmony-ido/README.md)。
 
-*  使用 pod 就不要使用 react-native link 了，不然会有冲突。
+## JavaScript 使用
 
-* 在 iOS 工程中如果找不到头文件可能要在 TARGETS-> BUILD SETTINGS -> Search Paths -> Header Search Paths 添加如下如路径
+在调用其他接口前先配置可选项并初始化 SDK。`gtcid` 在初始化完成前可能为空，可在业务侧稍后再次读取。
 
-  ```
-  $(SRCROOT)/../node_modules/react-native-getui/ios/RCTGetuiModule
-  ```
+```ts
+import GetuiIdo from 'react-native-idosdk';
 
+const appId = '你的 AppID';
+const channel = 'rn';
 
-### 2.4 API调用与订阅消息
+GetuiIdo.setDebugEnable(__DEV__);
+GetuiIdo.setSessionTime(30_000);
+GetuiIdo.setMinAppActiveDuration(60_000);
+GetuiIdo.setMaxAppActiveDuration(3_600_000);
 
-查看示例
+GetuiIdo.startSdk(appId, channel);
 
-android 与 ios 有部分API不同, 查看插件的index.js 或 index.d.ts中API的注释
+GetuiIdo.version((version) => {
+  console.log('IDOSDK version:', version);
+});
 
+GetuiIdo.gtcid((id) => {
+  console.log('gtcid:', id);
+});
 
+GetuiIdo.trackCountEvent('purchase', { sku: 'example', amount: 1 }, '');
+GetuiIdo.setProfile({ memberLevel: 'gold' }, '');
+```
 
+时间类配置的单位均为毫秒。支持的接口包括：
 
-## 3.iOS注意事项 
+- 初始化与查询：`startSdk`、`gtcid`、`version`、`setDebugEnable`
+- 会话与上传：`setSessionTime`、`setMinAppActiveDuration`、`setMaxAppActiveDuration`、`setEventUploadInterval`、`setEventForceUploadSize`、`setProfileUploadInterval`、`setProfileForceUploadSize`
+- 用户与事件：`setUserId`、`registerEventProperties`、`trackCustomKeyValueEventBegin`、`trackCustomKeyValueEventEnd`、`trackCountEvent`、`setProfile`
+- 平台差异：`setApplicationGroupIdentifier` 仅 iOS 生效；`setSyncGenerateGtcid` 和 `registerEventProperties` 暂未在 HarmonyOS 插件中提供。
 
+## 示例工程
 
+- [AndroidDemo](example/AndroidDemo)
+- [iOSDemo](example/iOSDemo)
+- [OhosDemo](example/OhosDemo)

package/android/build.gradle

@@ -7,7 +7,7 @@ def safeExtGet(prop, fallback) {
 android {
     compileSdkVersion safeExtGet('compileSdkVersion', 34)
 
-    namespace 'com.getui.reactnativegetui'
+    namespace 'com.getui.reactnativeido'
 
     defaultConfig {
         minSdkVersion safeExtGet('minSdkVersion', 23)
@@ -17,10 +17,15 @@ android {
     }
 }
 
-repositories {
-    maven {
-        url "https://mvn.getui.com/nexus/content/repositories/releases/"
+rootProject.allprojects {
+    repositories {
+        maven {
+            url "https://mvn.getui.com/nexus/content/repositories/releases/"
+        }
     }
+}
+
+repositories {
     maven { url 'https://maven.aliyun.com/repository/google' }
     maven { url 'https://maven.aliyun.com/repository/public' }
     mavenLocal()
@@ -42,16 +47,8 @@ repositories {
 }
 
 dependencies {
-    implementation fileTree(dir: "libs", include: ["*.jar"])
     implementation "com.facebook.react:react-native:+"  // From node_modules
-
-
-//    implementation 'com.getui.opt:hwp:3.1.2'   // 华为
-//    implementation 'com.getui.opt:xmp:3.3.3'   // 小米
-//    implementation 'com.assist-v3:oppo:3.5.0'  // oppo
-//    implementation 'com.assist-v3:vivo:3.2.0'  // vivo
-//    implementation 'com.getui.opt:mzp:3.2.4'   // 魅族
-//    implementation 'com.getui.opt:ups:3.0.3'   // ups，ups目前支持坚果，索尼，海信手机
-//    implementation 'com.getui.opt:honor:3.6.0' // 荣耀
+    implementation 'com.getui:gsido:1.4.14.0'
+    implementation 'com.getui:gtc:3.3.3.0'
 
 }

package/android/src/main/AndroidManifest.xml

@@ -1,14 +1,22 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
     >
 
-    <uses-sdk
-        android:minSdkVersion="14"
-        android:targetSdkVersion="30" />
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />
 
     <application>
+        <meta-data
+            android:name="GETUI_APPID"
+            tools:node="remove" />
+        <meta-data
+            android:name="GT_INSTALL_CHANNEL"
+            tools:node="remove" />
+        <meta-data
+            android:name="GTSDK_VERSION"
+            tools:node="remove" />
+
         <service
             android:name="com.getui.gtc.GtcService"
             android:exported="false" >

package/android/src/main/java/com/getui/{reactnativegetui → reactnativeido}/GetuiIdoModule.java

@@ -1,4 +1,4 @@
-package com.getui.reactnativegetui;
+package com.getui.reactnativeido;
 
 import android.content.Context;
 import com.facebook.react.bridge.Arguments;
@@ -43,9 +43,13 @@ public class GetuiIdoModule extends ReactContextBaseJavaModule {
     @ReactMethod
     public void startSdk(String appid, String channel) {
         // 设置AppId
-        if (!TextUtils.isEmpty(appid)){
+        if (!TextUtils.isEmpty(appid)) {
             GsConfig.setAppId(appid);
         }
+        // 设置安装渠道
+        if (!TextUtils.isEmpty(channel)) {
+            GsConfig.setInstallChannel(channel);
+        }
         // 预初始化
         GsManager.getInstance().preInit(mContext);
         // 初始化并注册gtcid
@@ -234,4 +238,4 @@ public class GetuiIdoModule extends ReactContextBaseJavaModule {
                 .emit(eventName, params);
     }
 
-}
+}

package/android/src/main/java/com/getui/{reactnativegetui → reactnativeido}/GetuiIdoPackage.java

@@ -1,4 +1,4 @@
-package com.getui.reactnativegetui;
+package com.getui.reactnativeido;
 
 import com.facebook.react.ReactPackage;
 import com.facebook.react.bridge.JavaScriptModule;

package/android/src/main/java/com/getui/{reactnativegetui → reactnativeido}/GetuiLogger.java

@@ -1,4 +1,4 @@
-package com.getui.reactnativegetui;
+package com.getui.reactnativeido;
 
 import android.util.Log;
 

package/docs/superpowers/plans/2026-07-13-android-getui-maven-dependencies.md

@@ -0,0 +1,323 @@
+# Android 个推 Maven 依赖迁移实施计划
+
+> **面向执行代理：** 必须使用 `superpowers:subagent-driven-development`（推荐）或 `superpowers:executing-plans`，逐项执行本计划。所有步骤使用复选框跟踪状态。
+
+**目标：** 将 RN Android 插件的个推本地 JAR 替换为 `gsido:1.4.14.0` 和 `gtc:3.3.3.0` Maven 依赖，并保留通过 `startSdk(appid, channel)` 运行时配置 SDK 的能力。
+
+**架构：** Maven AAR 负责提供用户运营 SDK、GTC 核心类和默认 Manifest 权限及组件；RN Bridge 继续负责在初始化前写入 App ID 与渠道。插件将个推仓库加入根项目的所有项目，并在 Manifest 合并时移除 AAR 的静态 App ID 与渠道元数据，使宿主应用无需为了运行时初始化而额外声明占位符。
+
+**技术栈：** Gradle 8.13、Android Gradle Plugin、React Native 0.79.1、Java、个推 `gsido:1.4.14.0`、个推 `gtc:3.3.3.0`
+
+## 全局约束
+
+- 只修改 Android RN 插件，不改 iOS 和 HarmonyOS 依赖。
+- 必须删除 `android/libs/gs-1.4.12.0.jar` 和 `android/libs/gtc-3.2.18.0.jar`，避免重复类。
+- 必须保留 `gsido` AAR 默认声明的全部权限和 `android:usesCleartextTraffic="true"`。
+- JavaScript API 和 `startSdk(String appid, String channel)` 签名保持不变。
+- 不覆盖或提交仓库中现有的包名迁移、示例应用及其他无关改动。
+- `android/build.gradle` 和新的 `GetuiIdoModule.java` 已包含用户改动，实施阶段
+  不自动提交生产文件，避免把不同工作混入同一提交。
+
+## 文件结构
+
+- 修改 `android/build.gradle`：向根项目注入个推仓库、声明 Maven 依赖并移除本地 JAR `fileTree`。
+- 删除 `android/libs/gs-1.4.12.0.jar`：移除旧用户运营 SDK。
+- 删除 `android/libs/gtc-3.2.18.0.jar`：移除旧 GTC 核心 SDK。
+- 修改 `android/src/main/AndroidManifest.xml`：移除 AAR 的静态 App ID 和渠道元数据。
+- 修改 `android/src/main/java/com/getui/reactnativeido/GetuiIdoModule.java`：在 SDK 预初始化前应用非空渠道参数。
+- 不新增业务源文件或测试框架。
+
+---
+
+### 任务 1：迁移 Gradle 依赖并配置宿主仓库
+
+**文件：**
+
+- 修改：`android/build.gradle:12-17`
+- 修改：`android/build.gradle:44-47`
+- 修改：`android/src/main/AndroidManifest.xml`
+- 删除：`android/libs/gs-1.4.12.0.jar`
+- 删除：`android/libs/gtc-3.2.18.0.jar`
+
+**接口：**
+
+- 输入：个推 Releases Maven 仓库 `https://mvn.getui.com/nexus/content/repositories/releases/`
+- 输出：插件 `debugCompileClasspath` 和 `debugRuntimeClasspath` 中的 `com.getui:gsido:1.4.14.0`、`com.getui:gtc:3.3.3.0`
+
+- [ ] **步骤 1：运行迁移前依赖断言，确认测试失败**
+
+运行：
+
+```bash
+cd /Users/yangsihao/Downloads/AndroidStudioProjects/plugins/rn/ido/react-native-idosdk
+test ! -f android/libs/gs-1.4.12.0.jar \
+  && test ! -f android/libs/gtc-3.2.18.0.jar \
+  && ! rg -n 'implementation fileTree' android/build.gradle \
+  && rg -n "implementation 'com.getui:gsido:1.4.14.0'" android/build.gradle \
+  && rg -n "implementation 'com.getui:gtc:3.3.3.0'" android/build.gradle
+```
+
+预期：命令返回非零状态，因为旧 JAR 和 `fileTree` 仍存在，两个 Maven 依赖尚未声明。
+
+- [ ] **步骤 2：将个推仓库添加到根项目**
+
+在 `android/build.gradle` 中添加：
+
+```gradle
+rootProject.allprojects {
+    repositories {
+        maven {
+            url "https://mvn.getui.com/nexus/content/repositories/releases/"
+        }
+    }
+}
+```
+
+- [ ] **步骤 3：移除 AAR 的静态配置元数据**
+
+在插件 Manifest 中声明 `tools` 命名空间，并在 `<application>` 内添加：
+
+```xml
+<meta-data
+    android:name="GETUI_APPID"
+    tools:node="remove" />
+<meta-data
+    android:name="GT_INSTALL_CHANNEL"
+    tools:node="remove" />
+```
+
+- [ ] **步骤 4：替换本地 JAR 依赖**
+
+将 `android/build.gradle` 的依赖块开头修改为：
+
+```gradle
+dependencies {
+    implementation "com.facebook.react:react-native:+"  // From node_modules
+    implementation 'com.getui:gsido:1.4.14.0'
+    implementation 'com.getui:gtc:3.3.3.0'
+```
+
+删除以下声明：
+
+```gradle
+implementation fileTree(dir: "libs", include: ["*.jar"])
+```
+
+- [ ] **步骤 5：删除旧 JAR 文件**
+
+运行：
+
+```bash
+rm android/libs/gs-1.4.12.0.jar android/libs/gtc-3.2.18.0.jar
+```
+
+预期：`android/libs` 中不再存在 `.jar` 文件。
+
+- [ ] **步骤 6：重新运行依赖断言，确认测试通过**
+
+运行：
+
+```bash
+test ! -f android/libs/gs-1.4.12.0.jar \
+  && test ! -f android/libs/gtc-3.2.18.0.jar \
+  && ! rg -n 'implementation fileTree' android/build.gradle \
+  && rg -n "implementation 'com.getui:gsido:1.4.14.0'" android/build.gradle \
+  && rg -n "implementation 'com.getui:gtc:3.3.3.0'" android/build.gradle \
+  && rg -n 'rootProject\.allprojects' android/build.gradle \
+  && rg -n 'tools:node="remove"' android/src/main/AndroidManifest.xml
+```
+
+预期：命令返回零状态，并打印两个 Maven 坐标、根项目仓库声明和元数据移除规则。
+
+- [ ] **步骤 7：验证插件依赖解析**
+
+运行：
+
+```bash
+cd example/AndroidDemo/android
+./gradlew :react-native-idosdk:dependencies --configuration debugRuntimeClasspath
+```
+
+预期：`BUILD SUCCESSFUL`，依赖树包含：
+
+```text
+com.getui:gsido:1.4.14.0
+com.getui:gtc:3.3.3.0
+```
+
+- [ ] **步骤 8：检查任务 1 的限定差异**
+
+运行：
+
+```bash
+git diff --check -- android/build.gradle \
+  android/libs/gs-1.4.12.0.jar \
+  android/libs/gtc-3.2.18.0.jar
+git diff -- android/build.gradle
+git diff --stat -- android/libs/gs-1.4.12.0.jar \
+  android/libs/gtc-3.2.18.0.jar
+```
+
+预期：差异检查无空白错误；Gradle 差异包含已有 namespace 调整以及本任务的
+占位符和依赖修改；两个 JAR 显示为删除。本步骤不创建提交。
+
+### 任务 2：在运行时初始化中应用安装渠道
+
+**文件：**
+
+- 修改：`android/src/main/java/com/getui/reactnativeido/GetuiIdoModule.java:44-54`
+
+**接口：**
+
+- 输入：`startSdk(String appid, String channel)` 的 `channel` 参数
+- 输出：在 `GsManager.preInit(Context)` 之前调用 `GsConfig.setInstallChannel(String)`
+
+- [ ] **步骤 1：运行渠道配置断言，确认测试失败**
+
+运行：
+
+```bash
+cd /Users/yangsihao/Downloads/AndroidStudioProjects/plugins/rn/ido/react-native-idosdk
+rg -n 'GsConfig\.setInstallChannel\(channel\)' \
+  android/src/main/java/com/getui/reactnativeido/GetuiIdoModule.java
+```
+
+预期：命令返回非零状态，因为当前实现没有应用 `channel`。
+
+- [ ] **步骤 2：实现非空渠道配置**
+
+将 `startSdk` 修改为：
+
+```java
+@ReactMethod
+public void startSdk(String appid, String channel) {
+    // 设置AppId
+    if (!TextUtils.isEmpty(appid)) {
+        GsConfig.setAppId(appid);
+    }
+    // 设置安装渠道
+    if (!TextUtils.isEmpty(channel)) {
+        GsConfig.setInstallChannel(channel);
+    }
+    // 预初始化
+    GsManager.getInstance().preInit(mContext);
+    // 初始化并注册gtcid
+    GsManager.getInstance().init(mContext);
+    Toast.makeText(mContext, "GsManager init ", Toast.LENGTH_SHORT).show();
+}
+```
+
+- [ ] **步骤 3：重新运行渠道配置断言，确认测试通过**
+
+运行：
+
+```bash
+rg -n 'GsConfig\.setInstallChannel\(channel\)' \
+  android/src/main/java/com/getui/reactnativeido/GetuiIdoModule.java
+```
+
+预期：命令返回零状态，只匹配 `startSdk` 中的渠道设置调用。
+
+- [ ] **步骤 4：编译 RN Android 插件**
+
+运行：
+
+```bash
+cd example/AndroidDemo/android
+./gradlew :react-native-idosdk:compileDebugJavaWithJavac
+```
+
+预期：`BUILD SUCCESSFUL`，不存在 `GsManager`、`GsConfig` 或
+`IGtcIdCallback` 的缺失类或缺失方法错误。
+
+- [ ] **步骤 5：检查任务 2 的限定差异**
+
+运行：
+
+```bash
+git diff --check -- \
+  android/src/main/java/com/getui/reactnativeido/GetuiIdoModule.java
+git diff -- \
+  android/src/main/java/com/getui/reactnativeido/GetuiIdoModule.java
+```
+
+预期：未暂存差异只包含 `startSdk` 的渠道配置修改。本步骤不创建提交，也不改变
+该新文件原有的暂存状态。
+
+### 任务 3：验证 Manifest、依赖图和示例应用构建
+
+**文件：**
+
+- 验证：`example/AndroidDemo/android/app/build/intermediates/merged_manifests/debug/processDebugManifest/AndroidManifest.xml`
+- 不修改生产文件；如果构建发现与本次迁移直接相关的问题，回到任务 1 或任务 2 修正并重新执行验证。
+
+**接口：**
+
+- 输入：任务 1 的 Maven 依赖与占位符、任务 2 的运行时配置
+- 输出：可编译的 RN Android 插件和可构建的 Android Demo Debug APK
+
+- [ ] **步骤 1：验证 Manifest 合并**
+
+运行：
+
+```bash
+cd /Users/yangsihao/Downloads/AndroidStudioProjects/plugins/rn/ido/react-native-idosdk/example/AndroidDemo/android
+./gradlew :app:processDebugMainManifest
+```
+
+预期：`BUILD SUCCESSFUL`，宿主 App 能从个推仓库解析两个 AAR，且不存在
+`GETUI_APPID` 或 `GT_INSTALL_CHANNEL` 的元数据值冲突。
+
+- [ ] **步骤 2：检查合并后的 SDK 权限与组件**
+
+运行：
+
+```bash
+MERGED_MANIFEST=$(find app/build/intermediates -path '*debug*' \
+  -name AndroidManifest.xml -print | head -n 1)
+rg -n 'READ_PHONE_STATE|ACCESS_FINE_LOCATION|BLUETOOTH|GtcService|GtcProvider|usesCleartextTraffic' \
+  "$MERGED_MANIFEST"
+```
+
+预期：输出包含 `gsido` 默认敏感权限、`GtcService`、`GtcProvider` 和
+`android:usesCleartextTraffic="true"`。
+
+- [ ] **步骤 3：确认最终运行时依赖版本**
+
+运行：
+
+```bash
+./gradlew :app:dependencyInsight \
+  --configuration debugRuntimeClasspath \
+  --dependency com.getui:gsido
+./gradlew :app:dependencyInsight \
+  --configuration debugRuntimeClasspath \
+  --dependency com.getui:gtc
+```
+
+预期：两个命令均为 `BUILD SUCCESSFUL`，最终选择版本分别为
+`1.4.14.0` 和 `3.3.3.0`，没有其他版本替换记录。
+
+- [ ] **步骤 4：构建 Android Demo Debug APK**
+
+运行：
+
+```bash
+./gradlew :app:assembleDebug
+```
+
+预期：`BUILD SUCCESSFUL`，生成
+`example/AndroidDemo/android/app/build/outputs/apk/debug/app-debug.apk`。
+
+- [ ] **步骤 5：检查最终差异**
+
+运行：
+
+```bash
+cd /Users/yangsihao/Downloads/AndroidStudioProjects/plugins/rn/ido/react-native-idosdk
+git diff --check
+git status --short
+```
+
+预期：`git diff --check` 无输出；`git status --short` 同时显示任务开始前已有的
+用户改动和本次 Maven 迁移改动。生产文件保持未提交，供用户与现有工作一起复核。