@flun/node-mobile-app 4.0.3 → 4.0.5

package/CHANGELOG.md

@@ -1,23 +1,13 @@
 # 变更日志
-## [4.0.3] - 2026-10-21 08:28
+## [4.0.4] - 2026-10-21 12:10
+### 优化
+- 进一步优化 .md 文件;
 
-### 修复
-- **`[3/11]` 提示中清理目标重复**:`depsChanged` 与 `appInfoChanged` 同时为真时,`targets` 数组会推入两次 `Gradle 缓存`,提示显示为"清理 依赖缓存、Gradle 缓存、Gradle 缓存";现用 `[...new Set(targets)]` 去重,提示与清理目标一致;
-- **删除依赖快照误用 `removeDir`**:`.deps-snapshot.json` 是文件,原代码调用 `removeDir` 删除;该函数名与实现均针对目录,当前靠 `fs.rmSync` 的兼容性正常工作,但语义错位,一旦 `removeDir` 实现收紧(如增加 `isDirectory` 判断)会静默失效,导致快照残留、`[5/11]` 误判"依赖与环境未变化";现改用 `fs.rmSync(path, { force: true })` 直接删除文件;
-
-## [4.0.2] - 2026-10-20 15:56
+## [4.0.4] - 2026-10-21 10:02
+### 优化
+- 优化了大量文件细节
 
+## [4.0.3] - 2026-10-21 08:28
 ### 修复
-- **CLI 或插件版本变化时跳过依赖重装,产物沿用旧优化规则**:`[3/11]` 检测到 CLI 版本、插件版本、ABI、libnode、模板文件变化时,原逻辑只清 Gradle 构建目录与插件 CMake 缓存,不清 `nodejs-assets` 与 `.deps-snapshot.json`;`[5/11]` 读到的仍是旧快照,判定"依赖与环境未变化",跳过安装与优化;结果是新版本代码配旧规则产物,原生模块的编译源文件、中间产物、异平台 prebuilds 可能残留;现拆分为 `clearGradleCaches` 与 `clearDepsCaches`,前者清 Gradle 与插件构建目录,后者清 `nodejs-assets` 与依赖快照;版本类变化同时清两者,触发重装、重编、重优化;
-- **`[3/11]` 提示与实际清理范围不符**:原提示"清理全部缓存"实际只清 Gradle 构建目录;`depsChanged` / `appInfoChanged` 分支提示"清理 nodejs-assets 缓存 + app/build",但 `nodejs-assets` 从未被清理;现提示按实际清理目标拼接--版本类变化为"清理 Gradle 缓存、CMake 缓存与依赖缓存",依赖变化为"清理依赖缓存、Gradle 缓存",仅应用信息变化为"清理 Gradle 缓存";
-
-## [4.0.1] - 2026-10-20 14:48
-
-### 紧急修复
-- **4.0.0 在全新安装时原生模块产物错误,应用无法正常加载**:4.0.0 发布时依赖 `@flun/nodejs-mobile-react-native` 的版本被锁定为 2.0.8,而 2.0.8 缺少配合编译前移的 Gradle 改动;结果 `DeleteIncorrectPrebuilds` 删除前移阶段已编译的 `.node`、`DetectCorrectPrebuilds` 用 prebuild 覆盖已编译结果、`BuildNpmModules` 重复编译,APK 内原生模块缺失或不匹配,应用启动后加载失败;现依赖 `@flun/nodejs-mobile-react-native@^2.1.0`,该版本在标记文件存在时保留 `build/Release/*.node`、跳过 prebuild 替换、跳过重复编译;
-
-### 升级注意事项
-- **已装 4.0.0 必须升级**:4.0.0 的锁文件已固定 `nodejs-mobile-react-native@2.0.8`,直接使用会构建失败或运行异常;请安装 4.0.1,或手动执行 `npm update @flun/nodejs-mobile-react-native` 升至 2.1.0;
-
-### 更新
-- 同步更新了一些依赖包;
+- **`[3/11]` 提示中清理目标重复**:`depsChanged` 与 `appInfoChanged` 同时为真时,`targets` 数组会推入两次 `Gradle 缓存`,提示显示为"清理 依赖缓存、Gradle 缓存、Gradle 缓存";现用 `[...new Set(targets)]` 去重,提示与清理目标一致;
+- **删除依赖快照误用 `removeDir`**:`.deps-snapshot.json` 是文件,原代码调用 `removeDir` 删除;该函数名与实现均针对目录,当前靠 `fs.rmSync` 的兼容性正常工作,但语义错位,一旦 `removeDir` 实现收紧(如增加 `isDirectory` 判断)会静默失效,导致快照残留、`[5/11]` 误判"依赖与环境未变化";现改用 `fs.rmSync(path, { force: true })` 直接删除文件;

package/bin/cli.js

@@ -8,16 +8,16 @@ const HELP = `
 @flun/node-mobile-app
 
 指令:
-  node-mobile-app test              编译并安装到设备（Android，需连 USB，走 Metro 热更新）
+  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             打 debug APK（Android,离线可用）
+  node-mobile-app build --release   打 release APK（Android,默认 debug keystore 签名,可安装）
   node-mobile-app build --ios       打 IPA（仅 macOS）
   node-mobile-app clean             清理构建缓存（不限平台）
 
 选项:
   --device <id>   指定设备（仅 test）
-  --arch <abi>    指定 ABI，逗号分隔（仅 build，Android）
+  --arch <abi>    指定 ABI,逗号分隔（仅 build,Android）
   --debug         显示详细日志（所有指令通用）
 `,
 
@@ -48,4 +48,4 @@ const HELP = `
     }
   };
 
-main();
+main();

package/mobileAppConfig.js

@@ -1,24 +1,24 @@
 /**
  * @flun/node-mobile-app 配置文件
- * 放置在用户 Node.js 项目根目录，CLI 会自动读取
- * 如不提供此文件，CLI 使用默认配置
+ * 放置在用户 Node.js 项目根目录,CLI 会自动读取
+ * 如不提供此文件,CLI 使用默认配置
  * 所有路径相对于用户项目根目录
  *
  * ===== 常用命令 =====
- *   npx node-mobile-app test            编译并安装到设备（需连 USB，走 Metro 热更新）
+ *   npx node-mobile-app test            编译并安装到设备（需连 USB,走 Metro 热更新）
  *   npx node-mobile-app test --ios      iOS 版（仅 macOS）
  *   npx node-mobile-app build           打 debug APK（离线可用）
- *   npx node-mobile-app build --release 打 release APK（默认 debug keystore 签名，可安装；上架需配 android.signing）
+ *   npx node-mobile-app build --release 打 release APK（默认 debug keystore 签名,可安装；上架需配 android.signing）
  *   npx node-mobile-app build --ios     打 IPA（仅 macOS）
  *   npx node-mobile-app clean           清理构建缓存
  *
  *   任意命令加 --debug 可显示详细日志（优化各阶段明细、各命令完整输出）
  *
  * ===== 服务地址说明 =====
- *   CLI 会自动识别 server.js 实际监听的协议和端口（拦截 listen 调用），
- *   App 使用该地址加载页面，无需在此配置。
- *   若 5 秒内未能识别，App 显示启动失败并可在页面展开详情查看原因。
- *   动态端口（listen(0)）会自动获取系统分配的真实端口。
+ *   CLI 会自动识别 server.js 实际监听的协议和端口（拦截 listen 调用）,
+ *   App 使用该地址加载页面,无需在此配置;
+ *   若 5 秒内未能识别,App 显示启动失败并可在页面展开详情查看原因;
+ *   动态端口（listen(0)）会自动获取系统分配的真实端口;
  */
 export default {
   // ===== 必填 =====
@@ -39,7 +39,7 @@ export default {
     enableDomStorage: true,           // 是否启用 DOM Storage(localStorage 等)
     allowFileAccess: true,            // 是否允许访问本地文件
     mixedContentMode: 'always',       // 混合内容模式:never / always / compatibility
-    // WebView 背景色，支持三种写法：
+    // WebView 背景色,支持三种写法：
     //   '#ffffff' / 'white'              固定色
     //   'system'                         跟随系统（内部用默认浅/深色）
     //   { light: '#fff', dark: '#1a1a1a' }  按系统主题切换
@@ -49,8 +49,8 @@ export default {
     //   - 用 HTTPS + 真证书(如 Let's Encrypt)：与本开关无关
     //   - 用 HTTPS + 自签证书 + 已装进设备信任库：与本开关无关
     //   - 用 HTTPS + 自签证书 + 未装设备(本地测试最常见)：必须设为 true
-    // ⚠️ 开启后仅对 127.0.0.1 / localhost 放行不受信任的 HTTPS 证书，其他域名仍严格校验
-    //    用于本地自签证书测试，生产环境建议关闭
+    // ⚠️ 开启后仅对 127.0.0.1 / localhost 放行不受信任的 HTTPS 证书,其他域名仍严格校验
+    //    用于本地自签证书测试,生产环境建议关闭
     allowSelfSignedCert: false,
   },
 
@@ -73,7 +73,7 @@ export default {
     ],
     // 签名配置（可选）
     //
-    // 不配置也能打 release：模板默认用 debug keystore 签名（可安装、可本地测试，不可上架）。
+    // 不配置也能打 release：模板默认用 debug keystore 签名（可安装、可本地测试,不可上架）;
     // 需要上架时再配置下面任一种：
     //
     // 方式一：Android SDK 自带 debug keystore（本地测试常用）
@@ -83,7 +83,7 @@ export default {
     //   keyAlias:       'androiddebugkey'
     //   keyPassword:    'android'
     //
-    // 取消下方整块注释即视为「启用签名」，此时 4 项均为必填（缺项会在构建前报错）
+    // 取消下方整块注释即视为「启用签名」,此时 4 项均为必填（缺项会在构建前报错）
     signing: {
       // keystore:      './build/release.keystore', // 必填：keystore 路径（相对用户项目根）
       // storePassword: '',                         // 必填：keystore 密码
@@ -97,7 +97,7 @@ export default {
   ios: {
     deploymentTarget: '15.1',         // 最低 iOS 版本(RN 0.87 要求 15.1+)
     icon: './build/icon.png',         // 应用图标(建议 1024x1024 PNG)
-    // 签名配置（仅 macOS，发布时必填）：
+    // 签名配置（仅 macOS,发布时必填）：
     //   teamId              Apple Developer Team ID
     //   provisioningProfile 描述文件路径（写入 exportOptions.plist）
     //   certificate         P12 证书路径（导入临时 keychain 供 xcodebuild 签名用）
@@ -118,17 +118,17 @@ export default {
 
   // ===== node_modules 优化 =====
   // 构建时合并 JS + 清空已复制到项目根的资源 + 清平台二进制 + 清开发文件,加速启动
-  // 默认开启。若构建或运行异常,可按下述方式关闭或排除问题包
+  // 默认开启;若构建或运行异常,可按下述方式关闭或排除问题包
   optimize: {
     enabled: true,                     // 是否启用（默认 true）
     // exclude: ['包名'],              // 排除优化时异常或不想优化的包（默认空）
   },
 
   // ===== 扩展点 =====
-  // 不重置的模板文件（路径相对于 node-mobile-app-build/，如 'android/app/src/main/AndroidManifest.xml'）
+  // 不重置的模板文件（路径相对于 node-mobile-app-build/,如 'android/app/src/main/AndroidManifest.xml'）
   keepFiles: [],
-  // 额外 RN 原生依赖包名数组（用于 autolink 识别，含原生模块的包必须在此声明）
-  // 安装命令用 --save-dev，这些是开发依赖，不会进移动端 Node 环境
+  // 额外 RN 原生依赖包名数组（用于 autolink 识别,含原生模块的包必须在此声明）
+  // 安装命令用 --save-dev,这些是开发依赖,不会进移动端 Node 环境
   // 示例: npm install --save-dev react-native-camera
   //       extraRnDependencies: ['react-native-camera']
   // 未安装的包会在 test/build 时中断并提示安装命令

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flun/node-mobile-app",
-  "version": "4.0.3",
+  "version": "4.0.5",
   "description": "将 Node.js 项目一键打包为 Android / iOS 移动应用,运行时由 @flun/nodejs-mobile-react-native 提供,无需修改你的 Node 代码;",
   "author": "flun <open@flun.top>",
   "keywords": [

package/scripts/copy-files.js

@@ -19,7 +19,7 @@ const copyFile = () => {
         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} 文件，正在创建...`);
+        console.log(`⚠️ 在项目根目录未找到 ${fileName} 文件,正在创建...`);
 
         fs.copyFileSync(sourceFile, targetFile);     // 复制源文件到项目根目录
         console.log(`✓ 已创建 ${fileName} 示例文件:${targetFile}`);

package/src/commands/build.js

@@ -112,4 +112,4 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
     await markVerified(buildDir);
   }
 
-export { runBuild };
+export { runBuild };

package/src/commands/test.js

@@ -14,7 +14,9 @@ import { generateMainJs, generateRuntime } from '../generate.js';
 import { checkAndResetCache } from '../fingerprint.js';
 import { patchAppConfig, patchAndroidConfig, patchSigning, patchIcon, patchIosConfig, patchIosIcon } from '../patcher.js';
 import { ensureMac, checkIosTools, podInstall } from '../platform-ios.js';
-import { run, runSilent, runStream, findAdb, ensureDir, findHermesc, ensureInstallable, writeInstallState, spawnCmdAsync } from '../utils.js';
+import {
+  run, runSilent, runStream, findAdb, ensureDir, findHermesc, ensureInstallable, writeInstallState, spawnCmdAsync
+} from '../utils.js';
 import chalk from 'chalk';
 
 const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..'),
@@ -95,14 +97,15 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
         fs.copyFileSync(hbcPath, bundlePath), fs.unlinkSync(hbcPath);
         console.log(chalk.green('    ✓ 已替换为 Hermes 字节码'));
       }
-      else console.warn(chalk.yellow('  ⚠️  未找到 hermesc，跳过字节码编译（离线启动会较慢）'));
+      else console.warn(chalk.yellow('  ⚠️  未找到 hermesc,跳过字节码编译（离线启动会较慢）'));
 
-      const mergedAsset = path.join(buildDir, 'android', 'app', 'build', 'intermediates', 'assets', 'debug', 'mergeDebugAssets', 'index.android.bundle');
+      const mergedAsset = path.join(buildDir, 'android', 'app', 'build', 'intermediates', 'assets', 'debug',
+        'mergeDebugAssets', 'index.android.bundle');
       if (fs.existsSync(mergedAsset)) {
         const h = f => createHash('sha256').update(fs.readFileSync(f)).digest('hex');
         if (h(bundlePath) !== h(mergedAsset)) {
           fs.rmSync(path.dirname(mergedAsset), { recursive: true, force: true });
-          console.log(chalk.gray('  bundle 已变化，清理 mergeDebugAssets 缓存'));
+          console.log(chalk.gray('  bundle 已变化,清理 mergeDebugAssets 缓存'));
         }
       }
       console.log(chalk.cyan(`\n[9/${total}] 配置 adb 端口转发`));
@@ -120,25 +123,28 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
       });
       if (!await metroReady()) {
         console.log(chalk.gray('  启动 Metro...'));
-        const metroLog = fs.openSync(path.join(buildDir, '.metro.log'), 'a');
-        const metro = spawnCmdAsync('npx', ['react-native', 'start'], {
-          cwd: buildDir, detached: true, stdio: ['ignore', metroLog, metroLog]
-        });
+        const metroLog = fs.openSync(path.join(buildDir, '.metro.log'), 'a'),
+          metro = spawnCmdAsync('npx', ['react-native', 'start'], {
+            cwd: buildDir, detached: true, stdio: ['ignore', metroLog, metroLog]
+          });
         metro.unref();
         let ready = false;
         for (let i = 0; i < 60; i++) {
           await new Promise(r => setTimeout(r, 500));
-          if (await metroReady()) { ready = true; console.log(chalk.green('    ✓ Metro 已就绪（后台常驻，支持热更新）')); break; }
+          if (await metroReady()) { ready = true, console.log(chalk.green('    ✓ Metro 已就绪（后台常驻,支持热更新）')); break; }
         }
-        if (!ready) console.log(chalk.yellow('  ⚠️  Metro 30 秒内未就绪，详见 .metro.log；app 将回落到本地 bundle'));
+        if (!ready) console.log(chalk.yellow('  ⚠️  Metro 30 秒内未就绪,详见 .metro.log；app 将回落到本地 bundle'));
       }
       console.log(chalk.cyan(`\n[10/${total}] 编译 Debug 包`));
       const gradlew = process.platform === 'win32' ? 'gradlew.bat' : './gradlew';
-      if (process.env.OPTIMIZE_DEBUG) {
-        await runStream(gradlew, ['assembleDebug'], { cwd: path.join(buildDir, 'android'), env: { ...process.env, NODE_MOBILE_MODE: 'test' } });
-      } else {
+      if (process.env.OPTIMIZE_DEBUG) await runStream(gradlew, ['assembleDebug'], {
+        cwd: path.join(buildDir, 'android'), env: { ...process.env, NODE_MOBILE_MODE: 'test' }
+      });
+      else {
         console.log(chalk.gray('  编译中...'));
-        run(gradlew, ['assembleDebug'], { cwd: path.join(buildDir, 'android'), env: { ...process.env, NODE_MOBILE_MODE: 'test' }, quiet: true });
+        run(gradlew, ['assembleDebug'], {
+          cwd: path.join(buildDir, 'android'), env: { ...process.env, NODE_MOBILE_MODE: 'test' }, quiet: true
+        });
         console.log(chalk.green('    ✓ 编译完成'));
       }
 
@@ -157,4 +163,4 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
     }
   };
 
-export { runTest };
+export { runTest };

package/src/config.js

@@ -75,7 +75,7 @@ const DEFAULT_CONFIG = {
         return merge(DEFAULT_CONFIG, mod.default || mod);
       }
     }
-    console.log(chalk.yellow('未找到 mobileAppConfig.js，使用默认配置'));
+    console.log(chalk.yellow('未找到 mobileAppConfig.js,使用默认配置'));
     return DEFAULT_CONFIG;
   },
   validateConfig = (config, userProjectDir) => {
@@ -84,22 +84,19 @@ const DEFAULT_CONFIG = {
 
     const pkg = path.join(userProjectDir, 'package.json');
     if (!fs.existsSync(pkg)) errors.push('用户项目缺少 package.json');
-    // 极简防呆：至少 2 段、每段非空、只含 [a-zA-Z0-9_-]，不允许首尾点或连续点
-    // 具体平台是否合法交给 Gradle / Xcode 报错（Android 不允许 -，iOS 允许）
-    if (
-      typeof config.appId !== 'string' ||
-      !/^[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/.test(config.appId)
-    )
-      errors.push('appId 格式不合法（需反向域名格式，如 com.example.app）: ' + config.appId);
+    // 极简防呆：至少 2 段、每段非空、只含 [a-zA-Z0-9_-],不允许首尾点或连续点
+    // 具体平台是否合法交给 Gradle / Xcode 报错（Android 不允许 -,iOS 允许）
+    if (typeof config.appId !== 'string' || !/^[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/.test(config.appId))
+      errors.push('appId 格式不合法（需反向域名格式,如 com.example.app）: ' + config.appId);
     if (!Number.isInteger(config.versionCode) || config.versionCode < 1) errors.push('versionCode 必须是正整数');
     if (!config.android.abiFilters?.length) errors.push('android.abiFilters 不能为空');
     if (errors.length) {
-      errors.forEach((e) => console.error(chalk.red('  - ' + e)));
+      errors.forEach(e => console.error(chalk.red('  - ' + e)));
       throw new Error('配置校验失败');
     }
     console.log(chalk.green('    ✓ 配置校验通过'));
   },
-  resolveSdkPath = (config) => {
+  resolveSdkPath = config => {
     if (config.android && config.android.sdkPath) return config.android.sdkPath;
     for (const env of ['ANDROID_HOME', 'ANDROID_SDK_ROOT']) {
       const base = process.env[env];
@@ -113,4 +110,4 @@ const DEFAULT_CONFIG = {
     return null;
   };
 
-export { DEFAULT_CONFIG, loadConfig, validateConfig, resolveSdkPath };
+export { DEFAULT_CONFIG, loadConfig, validateConfig, resolveSdkPath };

package/src/copy.js

@@ -61,7 +61,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
    * 把 buildDir/package.json 的依赖版本同步为主包 dependencies 的版本
    * - 依赖名单来自 buildDir/package.json（模板声明需要哪些依赖）
    * - 版本号来自 pkgRoot/package.json 的 dependencies（单一数据源）
-   * - 若主包缺少某个依赖，抛错中断（避免模板占位值被真正使用）
+   * - 若主包缺少某个依赖,抛错中断（避免模板占位值被真正使用）
    */
   syncTemplateDependencies = (pkgRoot, buildDir) => {
     const buildPkgPath = path.join(buildDir, 'package.json');
@@ -74,7 +74,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
     const mainDeps = mainPkg.dependencies || {}, missing = [];
     let depsUpdated = 0, needWrite = false;
 
-    // 移除仅用于模板占位说明的 _comment 字段，避免带进最终 build 工程
+    // 移除仅用于模板占位说明的 _comment 字段,避免带进最终 build 工程
     if ('_comment' in buildPkg) delete buildPkg._comment, needWrite = true;
     for (const name of Object.keys(buildPkg.dependencies)) {
       const v = mainDeps[name];
@@ -91,27 +91,25 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
       throw new Error(
         'template/package.json 声明的以下依赖在主包 dependencies 中不存在：\n' +
         '       ' + missing.join(', ') + '\n' +
-        '     请在 @flun/node-mobile-app 的 package.json 中补上对应声明（版本号随意，\n' +
-        '     但必须存在，以便 syncTemplateDependencies 覆盖模板里的占位值）。'
+        '     请在 @flun/node-mobile-app 的 package.json 中补上对应声明（版本号随意,\n' +
+        '     但必须存在,以便 syncTemplateDependencies 覆盖模板里的占位值）。'
       );
     }
   },
   /**
-   * 把主包 node_modules 里被 npm 嵌套（未提升到用户根）的依赖，按需链接到用户根 node_modules 下，
+   * 把主包 node_modules 里被 npm 嵌套（未提升到用户根）的依赖,按需链接到用户根 node_modules 下,
    * 让 RN CLI / Metro 从用户根也能解析到它们。
-   * - 判据：从用户根视角解析不到，才建链接；能解析则跳过；
-   * - 范围：遍历主包 node_modules 顶层全部条目（含 @scope/ 下每个子项），不列举任何包名；
-   * - 落点：只在用户根 node_modules 缺失条目时建 symlink，不覆盖已有内容、不碰 package.json / package-lock.json；
-   * - 建链接失败：中断报错，不静默。
+   * - 判据：从用户根视角解析不到,才建链接；能解析则跳过；
+   * - 范围：遍历主包 node_modules 顶层全部条目（含 @scope/ 下每个子项）,不列举任何包名；
+   * - 落点：只在用户根 node_modules 缺失条目时建 symlink,不覆盖已有内容、不碰 package.json / package-lock.json；
+   * - 建链接失败：中断报错,不静默。
    */
   linkNestedDeps = (pkgRoot, buildDir) => {
     const pkgNm = path.join(pkgRoot, 'node_modules');
     if (!fs.existsSync(pkgNm)) return;
 
-    const userProjectDir = path.dirname(buildDir),
-      userNm = path.join(userProjectDir, 'node_modules'),
-      req = createRequire(path.join(userProjectDir, 'index.js')),
-      candidates = [];
+    const userProjectDir = path.dirname(buildDir), userNm = path.join(userProjectDir, 'node_modules'),
+      req = createRequire(path.join(userProjectDir, 'index.js')), candidates = [];
     for (const entry of fs.readdirSync(pkgNm, { withFileTypes: true })) {
       if (!entry.isDirectory() || entry.name.startsWith('.')) continue;
       if (entry.name.startsWith('@')) {
@@ -123,7 +121,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
 
     let linked = 0;
     for (const name of candidates) {
-      try { req.resolve(name); continue; } catch { /* 解析不到，进入兜底 */ }
+      try { req.resolve(name); continue; } catch { /* 解析不到,进入兜底 */ }
       const src = path.join(pkgNm, name);
       if (!fs.existsSync(src)) continue;
       const realSrc = fs.realpathSync(src), dst = path.join(userNm, name);
@@ -132,8 +130,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
       if (occupied) continue;
       ensureDir(path.dirname(dst));
       try {
-        fs.symlinkSync(realSrc, dst, 'junction');
-        linked++;
+        fs.symlinkSync(realSrc, dst, 'junction'), linked++;
       } catch (err) {
         throw new Error(
           '建立兜底链接失败：' + dst + ' -> ' + realSrc + '\n' +
@@ -146,9 +143,9 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
   },
   /**
    * 把 CLI 包里的 template/ 逐文件覆盖到 build 目录
-   * - 只覆盖模板里存在的文件，不删除 buildDir 里已有的其他内容（保留 Gradle 增量缓存）
+   * - 只覆盖模板里存在的文件,不删除 buildDir 里已有的其他内容（保留 Gradle 增量缓存）
    * - 模板文件被改写时自动同步；新增文件自动添加
-   * - 若模板里删除了文件，旧副本残留由 CLI 版本指纹触发全量重建处理
+   * - 若模板里删除了文件,旧副本残留由 CLI 版本指纹触发全量重建处理
    */
   copyTemplate = (pkgRoot, buildDir, config) => {
     ensureDir(buildDir);
@@ -166,7 +163,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
   },
   /**
    * 复制用户 Node 项目到 <buildDir>/nodejs-assets/nodejs-project
-   * 复制后重写 package.json：只保留 dependencies，剔除 devDependencies；用 config 的 allowScripts
+   * 复制后重写 package.json：只保留 dependencies,剔除 devDependencies；用 config 的 allowScripts
    */
   copyUserProject = (userProjectDir, buildDir, config) => {
     const targetDir = path.join(buildDir, 'nodejs-assets', 'nodejs-project');
@@ -177,7 +174,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
       'mobileAppConfig.js', 'mobileAppConfig.mjs', 'mobileAppConfig.cjs'
     ];
 
-    // 增量复制：内容变化的文件才覆盖，保留 node_modules 和其他未变文件
+    // 增量复制：内容变化的文件才覆盖,保留 node_modules 和其他未变文件
     copyDirIncremental(userProjectDir, targetDir, exclude);
     // 黑名单式过滤：只删 devDependencies 和 allowScripts,其余字段原样保留
     const userPkgPath = path.join(userProjectDir, 'package.json');
@@ -198,7 +195,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
    */
   writeLocalProperties = (buildDir, config) => {
     const sdkPath = resolveSdkPath(config);
-    if (!sdkPath) return console.warn(chalk.yellow('  ⚠️  未找到 Android SDK，请在 mobileAppConfig.js 里配置 android.sdkPath'));
+    if (!sdkPath) return console.warn(chalk.yellow('  ⚠️  未找到 Android SDK,请在 mobileAppConfig.js 里配置 android.sdkPath'));
 
     const localProps = path.join(buildDir, 'android', 'local.properties'),
       escaped = sdkPath.replace(/\\/g, '\\\\').replace(/:/g, '\\:');
@@ -243,12 +240,12 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
    * 按 config.android.abiFilters 修改 buildDir 里的 app/build.gradle：
    *   - defaultConfig.ndk.abiFilters
    *   - gradle.properties 的 reactNativeArchitectures
-   * 插件 build.gradle 读的是 project(":app").android.defaultConfig.ndk.abiFilters，
-   * 所以必须改这里，改插件自身的 abiFilters 无效。
+   * 插件 build.gradle 读的是 project(":app").android.defaultConfig.ndk.abiFilters,
+   * 所以必须改这里,改插件自身的 abiFilters 无效。
    */
   patchAndroidAbi = (buildDir, config) => {
     const file = path.join(buildDir, 'android', 'app', 'build.gradle');
-    if (!fs.existsSync(file)) return console.warn(chalk.yellow('  ⚠️  未找到 app/build.gradle，跳过 ABI patch'));
+    if (!fs.existsSync(file)) return console.warn(chalk.yellow('  ⚠️  未找到 app/build.gradle,跳过 ABI patch'));
 
     const abiList = (config.android.abiFilters || []).map((x) => `"${x}"`).join(', ');
     let c = fs.readFileSync(file, 'utf-8');
@@ -256,7 +253,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
 
     // defaultConfig 里的 ndk { abiFilters ... }
     c = c.replace(/(defaultConfig\s*\{[\s\S]*?ndk\s*\{\s*abiFilters\s+)("[^"]*"(?:\s*,\s*"[^"]*")*)/, `$1${abiList}`);
-    // 兜底：没有 ndk {} 块时，插到 defaultConfig 里
+    // 兜底：没有 ndk {} 块时,插到 defaultConfig 里
     if (!/ndk\s*\{\s*abiFilters/.test(c))
       c = c.replace(/(defaultConfig\s*\{)/, `$1\n        ndk {\n            abiFilters ${abiList}\n        }`);
     // 不 patch splits.abi.include：AGP 禁止它和 ndk.abiFilters 同时存在
@@ -289,8 +286,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
     for (const name of extras) {
       const pkgJson = path.join(userProjectDir, 'node_modules', name, 'package.json');
       if (!fs.existsSync(pkgJson)) {
-        missing.push(name);
-        continue;
+        missing.push(name); continue;
       }
       try {
         const v = JSON.parse(fs.readFileSync(pkgJson, 'utf-8')).version;
@@ -317,4 +313,4 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
 export {
   getBuildDir, copyTemplate, copyUserProject, writeLocalProperties, ensureUserEntry, ensureUserConfig, patchAndroidAbi,
   patchExtraRnDependencies
-};
+};

package/src/fingerprint.js

@@ -35,7 +35,7 @@ const FINGERPRINT_FILE = '.build-fingerprint.json',
         for (const e of entries) {
           if (e.name === 'node_modules' || e.name === '.git') continue;
           const full = path.join(d, e.name), rel = path.relative(templateDir, full).replace(/\\/g, '/');
-          if (e.isDirectory()) { h.update('D:' + rel + '|'); walk(full); }
+          if (e.isDirectory()) h.update('D:' + rel + '|'), walk(full);
           else if (e.isFile()) {
             h.update('F:' + rel + '|');
             try { h.update(fs.readFileSync(full)); } catch { h.update('err'); }
@@ -108,7 +108,7 @@ const FINGERPRINT_FILE = '.build-fingerprint.json',
       if (templateChanged) reasons.push('模板文件');
       if (depsChanged) reasons.push('用户依赖');
       if (appInfoChanged) reasons.push('应用信息');
-      console.log(chalk.yellow('  ⚠️  检测到变化（' + reasons.join('、') + '），清理 Gradle 缓存、CMake 缓存与依赖缓存'));
+      console.log(chalk.yellow('  ⚠️  检测到变化（' + reasons.join('、') + '）,清理 Gradle 缓存、CMake 缓存与依赖缓存'));
       clearGradleCaches(buildDir, userProjectDir);
       removeDir(path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native', 'android', '.cxx'));
       clearDepsCaches(buildDir);
@@ -117,13 +117,13 @@ const FINGERPRINT_FILE = '.build-fingerprint.json',
       const reasons = [], targets = [];
       if (depsChanged) reasons.push('用户依赖'), targets.push('依赖缓存', 'Gradle 缓存');
       if (appInfoChanged) reasons.push('应用信息'), targets.push('Gradle 缓存');
-      console.log(chalk.yellow('  ⚠️  检测到变化（' + reasons.join('、') + '），清理 ' + [...new Set(targets)].join('、')));
+      console.log(chalk.yellow('  ⚠️  检测到变化（' + reasons.join('、') + '）,清理 ' + [...new Set(targets)].join('、')));
       clearGradleCaches(buildDir, userProjectDir);
       if (depsChanged) clearDepsCaches(buildDir);
     }
-    else console.log(chalk.gray('    ✓ 缓存有效，跳过清理'));
+    else console.log(chalk.gray('    ✓ 缓存有效,跳过清理'));
 
     writeFp(fpFile, newFp);
   };
 
-export { computeFingerprint, checkAndResetCache };
+export { computeFingerprint, checkAndResetCache };

package/src/generate.js

@@ -4,7 +4,7 @@ import { writeIfChanged } from './utils.js';
 import chalk from 'chalk';
 
 /**
- * 生成 main.js（桥接代码，用户不需要手写）
+ * 生成 main.js（桥接代码,用户不需要手写）
  *
  * 上报机制（通过 rn-bridge channel 发消息给 App.tsx）：
  *   - 'Node started on <URL>'  server.js 成功调用 listen
@@ -14,9 +14,8 @@ const generateMainJs = (targetDir, config, moduleType) => {
   const entry = config.serverPath.startsWith('./') ? config.serverPath : './' + config.serverPath,
     entryLabel = config.serverPath, hb = config.advanced.heartbeatInterval,
     body = `(async () => {
-    const rn_bridge = require('rn-bridge');
-    const net = require('net'), https = require('https'), USER_ENTRY = ${JSON.stringify(entry)},
-     ENTRY_LABEL = ${JSON.stringify(entryLabel)}, START_TIMEOUT_MS = 5000;
+    const rn_bridge = require('rn-bridge'), net = require('net'), https = require('https'),
+    USER_ENTRY = ${JSON.stringify(entry)}, ENTRY_LABEL = ${JSON.stringify(entryLabel)}, START_TIMEOUT_MS = 5000;
 
     let resolved = false;
     function emitUrl(url) {
@@ -44,7 +43,7 @@ const generateMainJs = (targetDir, config, moduleType) => {
       emitFailure('未处理的 Promise rejection', String(reason));
     });
 
-    // 拦截 net.Server.prototype.listen，捕获协议和真实端口
+    // 拦截 net.Server.prototype.listen,捕获协议和真实端口
     const origListen = net.Server.prototype.listen;
     net.Server.prototype.listen = function (...args) {
       const server = this;
@@ -77,9 +76,7 @@ const generateMainJs = (targetDir, config, moduleType) => {
 
     ${config.advanced.keepAlive === false ? '// keepAlive: false — 不发送心跳' : "setInterval(() => rn_bridge.channel.send('heartbeat'), " + hb + ");"}
 
-    rn_bridge.channel.on('message', (msg) => {
-      rn_bridge.channel.send('Echo: ' + msg);
-    });
+    rn_bridge.channel.on('message', msg => rn_bridge.channel.send('Echo: ' + msg));
     })();`,
     header = moduleType === 'module'
       ? `import { createRequire } from 'module';\nconst require = createRequire(import.meta.url);\n\n` : '',
@@ -97,9 +94,9 @@ const generateMainJs = (targetDir, config, moduleType) => {
         mixedContentMode: config.webview.mixedContentMode,
         backgroundColor: config.webview.backgroundColor
       },
-    }, content = `// 自动生成，请勿手改\nexport default ${JSON.stringify(data, null, 2)} as const;\n`,
+    }, content = `// 自动生成,请勿手改\nexport default ${JSON.stringify(data, null, 2)} as const;\n`,
       changed = writeIfChanged(path.join(buildDir, 'mobileApp.runtime.ts'), content);
     console.log(chalk.green(changed ? '    ✓ 已生成 mobileApp.runtime.ts' : '    ✓ mobileApp.runtime.ts 无变化'));
   };
 
-export { generateMainJs, generateRuntime }
+export { generateMainJs, generateRuntime }