@flun/node-mobile-app 2.1.1 → 3.0.0

package/Android /346/236/204/345/273/272/346/214/207/345/215/227.md"

@@ -307,7 +307,7 @@ Remove-Item -Recurse -Force D:\你的项目\node-mobile-app-build
 Remove-Item -Recurse -Force D:\你的项目\node_modules\@flun\nodejs-mobile-react-native\android\.cxx
 Remove-Item -Recurse -Force D:\你的项目\node_modules\@flun\nodejs-mobile-react-native\android\build
 
-# 或删指纹文件（下次跑 = 首次构建）
+# 或删指纹文件（下次跑 = 全新构建）
 Remove-Item -Force D:\你的项目\node-mobile-app-build\.build-fingerprint.json
 ```
 

package/CHANGELOG.md

@@ -1,37 +1,39 @@
 # 变更日志
 
-## [2.1.1] - 2026-09-29 13:55
-### 优化
-- 优化了 'README.md' 文档;
-
-## [2.1.0] - 2026-09-29 10:39
-### 变更
-
-- **ESLint 插件换代**：`@babel/eslint-parser`、`eslint-plugin-react`、`eslint-plugin-react-native` 三个包的最新版均不支持 ESLint 10（分别止步于 9.0.0 / 9.7 / 9），导致安装 `eslint@10` 时被额外拉入一份 `eslint@9.39.5`（npm 的 peer 兼容回退），并触发 npm 的 deprecated 警告。现替换为：
-
-  | 原                                                   | 新                                                  |
-  | ---------------------------------------------------- | --------------------------------------------------- |
-  | `@babel/eslint-parser`                               | `@typescript-eslint/parser`（已支持 ESLint 10）     |
-  | `eslint-plugin-react` + `eslint-plugin-react-native` | `@eslint-react/eslint-plugin`（原生支持 ESLint 10） |
-
-  生成的 `eslint.config.js` 随之更新。`eslint-plugin-react-hooks` 保留（其 7.1.x 已支持 ESLint 10）。
-
-  > **注意**：lint 规则集与原先不同，升级后对同一份代码可能报出不同的检查结果。这只影响静态检查，不影响构建产物与运行。
+## [3.0.0] - 2026-10-13 21:19
+### 新增
+- **node_modules 优化系统（默认开启）**：构建时自动执行六阶段优化，大幅减少打包文件数、加速启动。不改变项目源码，对任意 Node.js 项目通用；
+  - **阶段 1 合并 JS**：按包入口 bundle，多个 JS 文件合并为单文件（`bundled/` 目录下的 `.cjs` / `.mjs`）；CJS 保持 CJS、ESM 保持 ESM；
+  - **阶段 2 清空资源**：扫描各包 `postinstall` 引用的目录/文件，保留目录结构、清空内容；被 import/require 的保留不删；
+  - **阶段 3 清平台二进制**：按目标平台 + `abiFilters` 逐文件判定，删除非本机二进制（三层识别：目录名、文件后缀、文件头魔数）；
+  - **阶段 4 清开发文件**：删除 `.md` / `.map` / `.d.ts` / `.h` / `.c` 等非运行文件；**原生模块包（含 `binding.gyp`）内的编译必需文件保留**，确保原生编译通过；
+  - **阶段 5 清中间产物**；**阶段 6 清不参与运行的文件和空目录**；
+- **优化缓存（快照 + 指纹）**：`.deps-snapshot.json` 记录依赖、目标平台、架构、运行时 Node 主版本、优化代码指纹、上次构建是否完成；
+  - 构建时自动判断并执行三种动作：**重装依赖并优化** / **仅优化** / **跳过**，日志说明当次动作与原因；
+  - 运行时 Node 主版本从 `libnode/include/node/node_version.h` 读取（读不到则报错退出）；
+- **模板指纹**：`template/` 目录内容纳入缓存指纹，模板改动自动触发重编；
+- **`--debug` 调试开关**：`npx node-mobile-app build --debug` / `test --debug` 显示优化各阶段明细与各命令完整输出；
+- **优化逃生舱口**（`mobileAppConfig.js`）：`optimize: { enabled: false }` 整体关闭优化；`optimize: { exclude: ['包名'] }` 精确排除特定包；
+- **构建进度提示**：默认模式在打包阶段显示「打包进行中...」，避免长时间无输出被误认为卡死；`--debug` 下输出已完整，无需此提示；
 
 ### 修复
+- **`bundled` 目录在 APK 中丢失（重要）**：aapt2 默认过滤 `<dir>_*`，原产物目录名以下划线开头，被打包时整体丢弃，应用启动报 `Node assets copy failed`；产物目录改用 `bundled`，绕开该过滤；
+- **scripts 引用保护过宽**：原逻辑保护 `package.json` `scripts` 引用的所有 js（含 test / lint），但移动端无安装期、这些脚本永不执行；移除该保护，测试脚本等被正常清理；
+- **`run` 输出策略**：`run` 默认实时输出（inherit）；新增 `quiet` 参数——捕获输出、成功静默、失败才打印，用于 `gradlew` / `xcodebuild` 等命令；
+- **`clean` 清理不完整**：原只清 `node-mobile-app-build` 与插件 `.cxx`，现补上插件 `android/build`，确保清环境彻底；
+
+### 升级注意事项
+- **3.0.0 起 node_modules 优化默认开启**，无需配置即享优化收益；
+- **升级后首次构建**会重装依赖并执行优化，比平时慢；后续构建命中缓存后无额外开销；
+- 若**构建或运行异常**，按以下顺序排查：
+  1. 在 `mobileAppConfig.js` 中设置 `optimize: { enabled: false }` 关闭优化，验证是否为优化引起；
+  2. 若确认是某个包合并后异常，用 `optimize: { exclude: ['包名'] }` 排除优化时异常或不想优化的包；
+  3. 若需彻底重来，删除 `node-mobile-app-build` 目录后重新构建。
+
+## [2.1.2] - 2026-09-29 19:53
+### 更改
+- 加固了拷贝文件的一些逻辑;
 
-- **`DEP0190` 弃用警告**：`src/utils.js` 中的 `run` / `runQuiet` / `runSilent` 原先统一用 `spawnSync(bin, args, { shell: true })`。Node 20+ 对「参数数组 + shell」这种组合会提示参数未转义（`DEP0190`），每次执行 CLI 都会在输出末尾出现该警告。现改为：
-  - Windows：把命令与参数拼成单个字符串（参数按需加引号）后交给 shell——`.cmd` / `.bat` 仍能执行，且不再触发警告；
-  - 其它平台：不使用 shell，参数交由 Node 转义。
-## [2.0.8] - 2026-09-28 22:17
-### 修复
-
-- **中文路径构建失败**：三处联动修复。
-  - **AGP 拒绝非 ASCII 路径**：`template/android/gradle.properties` 增加 `android.overridePathCheck=true`，允许中文路径构建。
-  - **`gradle.properties` 中文乱码**：该文件按 ISO-8859-1 读取，非 ASCII 字符（如路径中的「桌面」）会被读成乱码，导致 keystore 找不到。`patcher.js` 现在把写入的非 ASCII 字符转成 `\uXXXX` 转义（Java Properties 规范）。
-  - 影响范围：项目路径含中文（或其它非 ASCII 字符）时，release 构建曾失败于 `Your project path contains non-ASCII characters` 与 `Keystore file ... not found`。
-- **签名配置缺项时报错含糊**：`android.signing.keystore` 已配置、但密码 / 别名 / 别名密码为空时，原先会一路跑到 Gradle 才报 `keystore password was incorrect`，容易误导排查方向。现在 `patcher.js` 在构建前即校验四项，缺项时抛出明确错误，并提示「仅本地测试可注释掉整个 signing 块」。
-
-### 变更
-
-- **`mobileAppConfig.js` 模板**：`signing` 块内每项标注「必填」，并说明「取消整块注释即视为启用签名」。
+## [2.1.1] - 2026-09-29 13:55
+### 优化
+- 优化了 'README.md' 文档;

package/README.md

@@ -17,6 +17,7 @@
 - **增量构建**：文件指纹判断缓存,无变化时 10 秒级重跑
 - **跨平台**：Android（Windows / macOS / Linux）+ iOS（仅 macOS）
 - **离线可用**：`build` 打出的 APK / IPA 内置 JS,无需连电脑也能跑
+- **node_modules 优化（默认开启）**：构建时自动合并 JS、清平台二进制、清开发文件等，大幅减少打包文件数与体积、加速启动；无需配置
 
 ---
 
@@ -53,6 +54,7 @@
 │   ├── fingerprint.js            # 缓存指纹（判断是否需要清理构建缓存）
 │   ├── generate.js               # 生成 main.js（桥接）+ mobileApp.runtime.ts（运行时配置）
 │   ├── install.js                # 依赖安装 + 插件 abiFilters patch + WebView SSL patch
+│   ├── optimize-node-modules.js  # node_modules 优化（六阶段：合并 JS / 清资源 / 清平台二进制 / 清开发文件 / 清中间产物 / 清冗余）
 │   ├── patcher.js                # 应用信息 / Android / iOS 配置 patch
 │   ├── platform-ios.js           # iOS 构建（pod install / xcodebuild archive / export）
 │   ├── utils.js                  # 通用工具（文件操作 / 进程调用 / adb / hermesc 定位）
@@ -166,12 +168,13 @@ npx node-mobile-app build --release
 
 ### 常用选项
 
-| 选项            | 用途                                    |
-| --------------- | --------------------------------------- |
-| `--ios`         | 目标平台为 iOS（默认 Android）          |
-| `--release`     | 打 release 包（仅 `build`）             |
-| `--device <id>` | 指定设备（`test`）                      |
-| `--arch <abi>`  | 指定 ABI,逗号分隔（`build`,仅 Android） |
+| 选项            | 用途                                           |
+| --------------- | --------------------------------------------- |
+| `--ios`         | 目标平台为 iOS（默认 Android）                 |
+| `--release`     | 打 release 包（仅 `build`）                    |
+| `--device <id>` | 指定设备（`test`）                             |
+| `--arch <abi>`  | 指定 ABI,逗号分隔（`build`,仅 Android）        |
+| `--debug`       | 显示详细日志（优化各阶段明细、各命令完整输出） |
 
 ### 安装 APK 到手机
 
@@ -336,6 +339,32 @@ signing: {
 
 ---
 
+### node_modules 优化
+
+构建时自动优化 `node_modules`（默认开启，无需配置），减少打包文件数与体积、加速启动。
+
+| 字段      | 类型       | 默认   | 说明                                                          |
+| --------- | ---------- | ------ | ------------------------------------------------------------- |
+| `enabled` | `boolean`  | `true` | 是否启用优化                                                  |
+| `exclude` | `string[]` | `[]`   | 排除优化时异常或不想优化的包（写 `package.json` 的 `name`）   |
+
+**六阶段流程**：
+
+1. **合并 JS**：按包入口 bundle，多个 JS 文件合并为单文件（`bundled/` 目录）；
+2. **清空资源**：扫描各包 `postinstall` 引用的目录/文件，保留目录结构、清空内容；被 import/require 的保留；
+3. **清平台二进制**：按目标平台 + `abiFilters` 逐文件判定，删除非本机二进制；
+4. **清开发文件**：删除 `.md` / `.map` / `.d.ts` / `.h` / `.c` 等非运行文件；**原生模块包（含 `binding.gyp`）内的编译必需文件保留**；
+5. **清中间产物**；
+6. **清不参与运行的文件和空目录**。
+
+**缓存**：快照记录在 `node-mobile-app-build/.deps-snapshot.json`，构建时自动判断「重装并优化 / 仅优化 / 跳过」；改动模板或依赖会自动触发重编。
+
+**异常排查**：
+
+- `optimize: { enabled: false }` 整体关闭优化；
+- `optimize: { exclude: ['包名'] }` 排除优化时异常或不想优化的包；
+- 加 `--debug` 查看优化各阶段明细。
+
 ## 服务地址说明
 
 CLI **自动识别 `server.js` 实际监听的协议和端口**——拦截 `net.Server.prototype.listen`,从 `server.address()` 取真实端口,从 `Server` 类型判断 `http` / `https`;
@@ -503,4 +532,4 @@ RN 0.87 的 API 若变动,`AppDelegate.swift` 里的 fallback 可能不生效—
 
 ## 许可
 
-ISC
+ISC

package/bin/cli.js

@@ -6,18 +6,18 @@ import { runClean } from '../src/commands/clean.js';
 const HELP = `
 @flun/node-mobile-app
 
-用法:
-  node-mobile-app test              编译并安装到设备（开发调试）
-  node-mobile-app test --ios        同上，iOS（仅 macOS）
-  node-mobile-app build             打 APK
+指令:
+  node-mobile-app test              编译并安装到设备（Android，需连 USB，走 Metro 热更新）
+  node-mobile-app test --ios        iOS 版（仅 macOS）
+  node-mobile-app build             打 debug APK（Android，离线可用）
+  node-mobile-app build --release   打 release APK（Android，默认 debug keystore 签名，可安装）
   node-mobile-app build --ios       打 IPA（仅 macOS）
-  node-mobile-app clean             清理构建缓存
+  node-mobile-app clean             清理构建缓存（不限平台）
 
 选项:
-  --ios                目标平台为 iOS（默认 Android，仅 macOS 可执行）
-  --release            打 release 包（build）
-  --device <id>        指定设备（test）
-  --arch <abi>         指定 ABI，逗号分隔（build，仅 Android）
+  --device <id>   指定设备（仅 test）
+  --arch <abi>    指定 ABI，逗号分隔（仅 build，Android）
+  --debug         显示详细日志（所有指令通用）
 `,
 
   parseFlags = args => {
@@ -34,6 +34,7 @@ const HELP = `
 
   main = async () => {
     const [cmd, ...rest] = process.argv.slice(2), flags = parseFlags(rest);
+    if (flags.debug) process.env.OPTIMIZE_DEBUG = '1';
     try {
       if (cmd === 'test') await runTest(flags);
       else if (cmd === 'build') await runBuild(flags);
@@ -46,4 +47,4 @@ const HELP = `
     }
   };
 
-main();
+main();

package/mobileAppConfig.js

@@ -12,6 +12,8 @@
  *   npx node-mobile-app build --ios     打 IPA（仅 macOS）
  *   npx node-mobile-app clean           清理构建缓存
  *
+ *   任意命令加 --debug 可显示详细日志（优化各阶段明细、各命令完整输出）
+ *
  * ===== 服务地址说明 =====
  *   CLI 会自动识别 server.js 实际监听的协议和端口（拦截 listen 调用），
  *   App 使用该地址加载页面，无需在此配置。
@@ -114,6 +116,14 @@ export default {
     heartbeatInterval: 5000,          // 心跳间隔(毫秒)
   },
 
+  // ===== node_modules 优化 =====
+  // 构建时合并 JS + 清空已复制到项目根的资源 + 清平台二进制 + 清开发文件,加速启动
+  // 默认开启。若构建或运行异常,可按下述方式关闭或排除问题包
+  optimize: {
+    enabled: true,                     // 是否启用（默认 true）
+    // exclude: ['包名'],              // 排除优化时异常或不想优化的包（默认空）
+  },
+
   // ===== 扩展点 =====
   // 不重置的模板文件（路径相对于 node-mobile-app-build/，如 'android/app/src/main/AndroidManifest.xml'）
   keepFiles: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flun/node-mobile-app",
-  "version": "2.1.1",
+  "version": "3.0.0",
   "description": "将 Node.js 项目一键打包为 Android / iOS 移动应用,运行时由 @flun/nodejs-mobile-react-native 提供,无需修改你的 Node 代码;",
   "author": "flun <open@flun.top>",
   "keywords": [
@@ -41,32 +41,34 @@
   },
   "dependencies": {
     "@babel/core": "^8.0.6",
+    "@eslint-react/eslint-plugin": "^5.21.3",
+    "@eslint/js": "^10.0.1",
+    "@flun/nodejs-mobile-react-native": "^2.0.8",
+    "@react-native/babel-preset": "^0.87.1",
     "@react-native-community/cli": "^20.2.0",
     "@react-native-community/cli-platform-android": "^20.2.0",
     "@react-native-community/cli-platform-ios": "^20.2.0",
-    "@react-native/babel-preset": "^0.87.1",
     "@react-native/metro-config": "^0.87.1",
-    "jimp": "^1.6.1",
-    "react": "^19.3.0",
-    "react-native": "^0.87.1",
-    "react-native-webview": "^14.0.1",
     "@types/react": "^19.3.0",
-    "prettier": "^3.9.8",
-    "eslint": "^10.11.0",
-    "@eslint/js": "^10.0.1",
     "@typescript-eslint/eslint-plugin": "^8.71.0",
     "@typescript-eslint/parser": "^8.71.0",
+    "esbuild": "^0.28.2",
+    "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-eslint-comments": "^3.2.0",
     "eslint-plugin-react-hooks": "^7.1.1",
-    "@eslint-react/eslint-plugin": "^5.21.3",
-    "@flun/nodejs-mobile-react-native": "^2.0.6"
+    "jimp": "^1.6.1",
+    "prettier": "^3.9.8",
+    "react": "^19.3.0",
+    "react-native": "^0.87.1",
+    "react-native-webview": "^14.0.1"
   },
   "allowScripts": {
     "node": true,
     "@flun/nodejs-mobile-react-native": true,
-    "unrs-resolver": true,
-    "@parcel/watcher": true
+    "@parcel/watcher": true,
+    "esbuild": true,
+    "unrs-resolver": true
   },
   "homepage": "https://github.com/OpenFlun/node-mobile-app#readme",
   "repository": {

package/scripts/copy-files.js

@@ -2,34 +2,33 @@ import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
-// 要复制的文件位置和文件目标位置
+// 要复制的文件位置、目标目录和目标文件路径
 const __filename = fileURLToPath(import.meta.url), __dirname = path.dirname(__filename),
-    initCwd = process.env.INIT_CWD, fileName = 'mobileAppConfig.js', targetDir = initCwd ? path.resolve(initCwd) : '',
-    // 要拷贝的文件和目标文件路径
-    sourceFile = path.join(__dirname, '..', fileName), targetFile = path.join(targetDir, fileName),
-    /**
-     * 复制文件到项目根目录
-     * >查看定义:@see {@link copyFile}
-     * @returns {boolean} - 复制是否成功
-     */
-    copyFile = () => {
-        console.log(`🔍 检查 ${fileName} 文件...`), console.log(`📁 项目根目录:${targetDir}`);
-        try {
-            // 无 INIT_CWD（非用户项目安装场景）|| 目标目录不是 Node 项目 || 包自身的 npm install（开发调试）→ 跳过
-            if (!targetDir) return true;
-            if (!fs.existsSync(path.join(targetDir, 'package.json'))) return true;
-            if (targetDir === path.resolve(__dirname, '..')) return true;
-            if (fs.existsSync(targetFile)) return true; // 目标文件已存在 → 直接返回
-            console.log(`⚠️ 在项目根目录未找到 ${fileName} 文件，正在创建...`);
+    fileName = 'mobileAppConfig.js', sourceFile = path.join(__dirname, '..', fileName),
+    targetDir = path.resolve(process.env.INIT_CWD || process.cwd()), targetFile = path.join(targetDir, fileName);
 
-            fs.copyFileSync(sourceFile, targetFile);     // 复制源文件到项目根目录
-            console.log(`✓ 已创建 ${fileName} 示例文件:${targetFile}`);
-            return true;
-        } catch (error) {
-            console.error(`✗ 创建 ${fileName} 文件失败:`, error.message);
-            return false;
-        }
+/**
+ * 复制文件到项目根目录
+ * >查看定义:@see {@link copyFile}
+ * @returns {boolean} - 复制是否成功
+ */
+const copyFile = () => {
+    console.log(`🔍 检查 ${fileName} 文件...`), console.log(`📁 项目根目录:${targetDir}`);
+    try {
+        // 目标目录不是 Node 项目 || 包自身的 npm install（开发调试）→ 跳过
+        if (!fs.existsSync(path.join(targetDir, 'package.json'))) return true;
+        if (targetDir === path.resolve(__dirname, '..')) return true;
+        if (fs.existsSync(targetFile)) return true; // 目标文件已存在 → 直接返回
+        console.log(`⚠️ 在项目根目录未找到 ${fileName} 文件，正在创建...`);
+
+        fs.copyFileSync(sourceFile, targetFile);     // 复制源文件到项目根目录
+        console.log(`✓ 已创建 ${fileName} 示例文件:${targetFile}`);
+        return true;
+    } catch (error) {
+        console.error(`✗ 创建 ${fileName} 文件失败:`, error.message);
+        return false;
     }
+};
 
 // 执行脚本并导出函数
 if (process.argv[1] === __filename) copyFile();

package/src/commands/build.js

@@ -7,6 +7,7 @@ import {
   patchExtraRnDependencies
 } from '../copy.js';
 import { installUserDeps, patchNodejsMobilePlugin, patchWebViewSsl } from '../install.js';
+import { markVerified } from '../optimize-node-modules.js';
 import { generateMainJs, generateRuntime } from '../generate.js';
 import { checkAndResetCache } from '../fingerprint.js';
 import {
@@ -17,18 +18,18 @@ import { run, ensureDir, sanitizeFileName } from '../utils.js';
 
 const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..'),
   runBuild = async (flags) => {
-    const userProjectDir = process.cwd(), release = !!flags.release, isIos = !!flags.ios;
+    const userProjectDir = process.cwd(), release = !!flags.release, isIos = !!flags.ios, total = isIos ? 8 : 7;
+
     console.log(`\n=== node-mobile-app build (${isIos ? 'iOS' : 'Android'}, ${release ? 'release' : 'debug'}) ===\n`);
     console.log('用户项目:', userProjectDir);
-
     if (isIos) ensureMac(), checkIosTools();
-    console.log('\n[0/7] 检查用户配置与入口文件'), ensureUserConfig(userProjectDir, PKG_ROOT);
+    console.log(`\n[1/${total}] 检查用户配置与入口文件`), ensureUserConfig(userProjectDir, PKG_ROOT);
 
     const config = await loadConfig(userProjectDir);
     ensureUserEntry(userProjectDir, config, PKG_ROOT), validateConfig(config, userProjectDir);
 
     const buildDir = getBuildDir(userProjectDir);
-    console.log('\n[1/7] 重置 RN 工程模板');
+    console.log(`\n[2/${total}] 重置 RN 工程模板`);
     copyTemplate(PKG_ROOT, buildDir, config);
     patchAndroidAbi(buildDir, config);
     patchExtraRnDependencies(buildDir, userProjectDir, config);
@@ -39,15 +40,16 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
     patchIosConfig(buildDir, userProjectDir, config);
     await patchIosIcon(buildDir, userProjectDir, config);
 
-    console.log('\n[2/7] 检查缓存指纹'), checkAndResetCache(buildDir, userProjectDir, config, PKG_ROOT);
-    console.log('\n[3/7] 复制用户项目');
+    console.log(`\n[3/${total}] 检查缓存指纹`), checkAndResetCache(buildDir, userProjectDir, config, PKG_ROOT);
+    console.log(`\n[4/${total}] 复制用户项目`);
     const { moduleType, targetDir } = copyUserProject(userProjectDir, buildDir, config);
-    console.log('\n[4/7] 安装依赖'), installUserDeps(targetDir, userProjectDir, config);
+    console.log(`\n[5/${total}] 安装依赖`);
+    await installUserDeps(targetDir, userProjectDir, config, buildDir, isIos ? 'ios' : 'android');
     patchNodejsMobilePlugin(userProjectDir, config);
     patchWebViewSsl(userProjectDir, config);
     writeLocalProperties(buildDir, config);
 
-    console.log('\n[5/7] 生成桥接文件');
+    console.log(`\n[6/${total}] 生成桥接文件`);
     generateMainJs(targetDir, config, moduleType), generateRuntime(buildDir, config);
 
     const appName = resolveAppName(userProjectDir, config), safeName = sanitizeFileName(appName),
@@ -55,8 +57,8 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
     ensureDir(outDir);
 
     if (isIos) {
-      console.log('\n[6/7] pod install'), podInstall(path.join(buildDir, 'ios'));
-      console.log('\n[7/7] xcodebuild archive + export'), xcodebuildArchive(buildDir, config, release, userProjectDir);
+      console.log(`\n[7/${total}] pod install`), podInstall(path.join(buildDir, 'ios'));
+      console.log(`\n[8/${total}] xcodebuild archive + export`), xcodebuildArchive(buildDir, config, release, userProjectDir);
 
       const ipaPath = xcodebuildExport(buildDir, config, release, outDir, userProjectDir),
         dstName = `${safeName}-${config.versionName}-${release ? 'release' : 'debug'}.ipa`, dst = path.join(outDir, dstName);
@@ -64,10 +66,12 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
 
       const mb = (fs.statSync(dst).size / 1024 / 1024).toFixed(1);
       console.log(`  ${dst}  (${mb} MB)`);
+      await markVerified(buildDir);
       return;
     }
 
-    console.log('\n[6/7] 打包 APK');
+    console.log(`\n[7/${total}] 打包 APK`);
+    if (!process.env.OPTIMIZE_DEBUG) console.log('  打包进行中...');
     const assetsDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'assets'),
       resDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'res');
 
@@ -79,13 +83,13 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
       '--entry-file', 'index.js',
       '--bundle-output', path.join(assetsDir, 'index.android.bundle'),
       '--assets-dest', resDir,
-    ], { cwd: buildDir });
+    ], { cwd: buildDir, quiet: true });
 
     const task = release ? 'assembleRelease' : 'assembleDebug', gradleArgs = [task];
     if (flags.arch) gradleArgs.push(`-PreactNativeArchitectures=${flags.arch}`);
 
     const gradlew = process.platform === 'win32' ? 'gradlew.bat' : './gradlew';
-    run(gradlew, gradleArgs, { cwd: path.join(buildDir, 'android') });
+    run(gradlew, gradleArgs, { cwd: path.join(buildDir, 'android'), quiet: true });
 
     const apkDir = path.join(buildDir, 'android', 'app', 'build', 'outputs', 'apk', release ? 'release' : 'debug');
     console.log('\n✅ 打包完成');
@@ -104,6 +108,7 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
       }
     }
     else console.log('  ⚠️  未找到 APK 输出目录:', apkDir);
+    await markVerified(buildDir);
   }
 
-export { runBuild };
+export { runBuild };

package/src/commands/clean.js

@@ -8,8 +8,12 @@ const runClean = async () => {
     targets = [
       { label: '构建目录', path: buildDir },
       {
-        label: '插件 CMake 缓存', path: path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native', 'android',
-          '.cxx')
+        label: '插件构建缓存', path: path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native',
+          'android', 'build')
+      },
+      {
+        label: '插件 CMake 缓存', path: path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native',
+          'android', '.cxx')
       },
     ];
 

package/src/commands/test.js

@@ -7,6 +7,7 @@ import {
   patchExtraRnDependencies
 } from '../copy.js';
 import { installUserDeps, patchNodejsMobilePlugin, patchWebViewSsl } from '../install.js';
+import { markVerified } from '../optimize-node-modules.js';
 import { generateMainJs, generateRuntime } from '../generate.js';
 import { checkAndResetCache } from '../fingerprint.js';
 import { patchAppConfig, patchAndroidConfig, patchSigning, patchIcon, patchIosConfig, patchIosIcon } from '../patcher.js';
@@ -15,42 +16,40 @@ import { run, runSilent, findAdb, ensureDir, findHermesc } from '../utils.js';
 
 const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..'),
   runTest = async flags => {
-    const userProjectDir = process.cwd(), isIos = !!flags.ios;
-    console.log(`\n=== node-mobile-app test (${isIos ? 'iOS' : 'Android'}) ===\n`), console.log('用户项目:', userProjectDir);
+    const userProjectDir = process.cwd(), isIos = !!flags.ios, total = isIos ? 9 : 10;
 
+    console.log(`\n=== node-mobile-app test (${isIos ? 'iOS' : 'Android'}) ===\n`);
+    console.log('用户项目:', userProjectDir);
     if (isIos) ensureMac(), checkIosTools();
-    console.log('\n[0/9] 检查用户配置与入口文件'), ensureUserConfig(userProjectDir, PKG_ROOT);
+    console.log(`\n[1/${total}] 检查用户配置与入口文件`), ensureUserConfig(userProjectDir, PKG_ROOT);
 
     const config = await loadConfig(userProjectDir);
     ensureUserEntry(userProjectDir, config, PKG_ROOT), validateConfig(config, userProjectDir);
 
     const buildDir = getBuildDir(userProjectDir);
-    console.log('\n[1/9] 重置 RN 工程模板');
-    copyTemplate(PKG_ROOT, buildDir, config);
-    patchAndroidAbi(buildDir, config);
+    console.log(`\n[2/${total}] 重置 RN 工程模板`);
+    copyTemplate(PKG_ROOT, buildDir, config), patchAndroidAbi(buildDir, config);
     patchExtraRnDependencies(buildDir, userProjectDir, config);
     patchAppConfig(buildDir, userProjectDir, config);
-    patchAndroidConfig(buildDir, config);
-    patchSigning(buildDir, userProjectDir, config);
+    patchAndroidConfig(buildDir, config), patchSigning(buildDir, userProjectDir, config);
     await patchIcon(buildDir, userProjectDir, config);
     patchIosConfig(buildDir, userProjectDir, config);
     await patchIosIcon(buildDir, userProjectDir, config);
 
-    console.log('\n[2/9] 检查缓存指纹'), checkAndResetCache(buildDir, userProjectDir, config, PKG_ROOT);
-    console.log('\n[3/9] 复制用户项目');
+    console.log(`\n[3/${total}] 检查缓存指纹`), checkAndResetCache(buildDir, userProjectDir, config, PKG_ROOT);
+    console.log(`\n[4/${total}] 复制用户项目`);
     const { moduleType, targetDir } = copyUserProject(userProjectDir, buildDir, config);
 
-    console.log('\n[4/9] 安装依赖'), installUserDeps(targetDir, userProjectDir, config);
+    console.log(`\n[5/${total}] 安装依赖`), await installUserDeps(targetDir, userProjectDir, config, buildDir, isIos ? 'ios' : 'android');
     patchNodejsMobilePlugin(userProjectDir, config);
-    patchWebViewSsl(userProjectDir, config);
-    writeLocalProperties(buildDir, config);
+    patchWebViewSsl(userProjectDir, config), writeLocalProperties(buildDir, config);
 
-    console.log('\n[5/9] 生成桥接文件');
+    console.log(`\n[6/${total}] 生成桥接文件`);
     generateMainJs(targetDir, config, moduleType), generateRuntime(buildDir, config);
 
     if (isIos) {
-      console.log('\n[6/9] pod install'), podInstall(path.join(buildDir, 'ios'));
-      console.log('\n[7/9] 生成 JS bundle + Hermes 字节码（由 Xcode Run Script 自动）');
+      console.log(`\n[7/${total}] pod install`), podInstall(path.join(buildDir, 'ios'));
+      console.log(`\n[8/${total}] 生成 JS bundle + Hermes 字节码（由 Xcode Run Script 自动）`);
       const bundlePath = path.join(buildDir, 'ios', 'main.jsbundle');
       runSilent('npx', [
         'react-native', 'bundle',
@@ -61,14 +60,15 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
       ], { cwd: buildDir });
       console.log('  ✓ bundle 已生成');
 
-      console.log('\n[8/9] 编译并安装到模拟器/设备');
+      console.log(`\n[9/${total}] 编译并安装到模拟器/设备`);
       const args = ['react-native', 'run-ios'];
       if (flags.device) args.push('--device', flags.device);
       // FORCE_BUNDLING=1：即使 Debug+模拟器也把 main.jsbundle 打进 App
-      const env = { ...process.env, FORCE_BUNDLING: '1' };
-      run('npx', args, { cwd: buildDir, env });
+      const env = { ...process.env, FORCE_BUNDLING: '1', NODE_MOBILE_MODE: 'test' };
+      run('npx', args, { cwd: buildDir, env, inherit: true });
+      await markVerified(buildDir);
     } else {
-      console.log('\n[6/9] 生成 JS bundle（离线可用）');
+      console.log(`\n[7/${total}] 生成 JS bundle（离线可用）`);
       const assetsDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'assets'),
         resDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'res');
       ensureDir(assetsDir);
@@ -84,7 +84,7 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
       ], { cwd: buildDir });
       console.log('  ✓ bundle 已生成');
 
-      console.log('\n[7/9] 编译 Hermes 字节码（加速离线启动）');
+      console.log(`\n[8/${total}] 编译 Hermes 字节码（加速离线启动）`);
       const hermesc = findHermesc(userProjectDir);
       if (hermesc) {
         const hbcPath = bundlePath + '.hbc';
@@ -94,14 +94,15 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
       }
       else console.warn('  ⚠️  未找到 hermesc，跳过字节码编译（离线启动会较慢）');
 
-      console.log('\n[8/9] 配置 adb 端口转发');
+      console.log(`\n[9/${total}] 配置 adb 端口转发`);
       const adb = findAdb(config);
-      console.log('  adb:', adb), run(adb, ['reverse', 'tcp:8081', 'tcp:8081']);
+      console.log('  adb:', adb), run(adb, ['reverse', 'tcp:8081', 'tcp:8081'], { quiet: true });
 
-      console.log('\n[9/9] 编译并安装到设备');
+      console.log(`\n[10/${total}] 编译并安装到设备`);
       const args = ['react-native', 'run-android'];
       if (flags.device) args.push('--deviceId', flags.device);
-      run('npx', args, { cwd: buildDir });
+      run('npx', args, { cwd: buildDir, inherit: true, env: { ...process.env, NODE_MOBILE_MODE: 'test' } });
+      await markVerified(buildDir);
     }
   };
 

package/src/config.js

@@ -29,7 +29,8 @@ const DEFAULT_CONFIG = {
     abiFilters: ['arm64-v8a'],
     icon: './build/icon.png',
     usesCleartextTraffic: true,
-    permissions: [],
    signing: {},
+    permissions: [],
+    signing: {},
   },
   ios: {
     deploymentTarget: '15.1',
@@ -48,6 +49,10 @@ const DEFAULT_CONFIG = {
     '*.log', '*.md', '*.tgz', '*.bak', '.backup*', 'dist/', 'out/', 'build/', 'tests/',
     'node-mobile-app-build/', 'nodejs-assets/',
   ],
+  optimize: {
+    enabled: true,
+    exclude: [],
+  },
   allowScripts: {
     'node': true,
   }