electron-ohos-hotreload 1.0.0

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "electron-ohos-hotreload",
+  "version": "1.0.0",
+  "description": "Hot-reload CLI for Electron on HarmonyOS — push JS/TS changes to device without rebuilding HAP",
+  "bin": {
+    "eohr": "./bin/eohr.js"
+  },
+  "main": "bin/eohr.js",
+  "scripts": {
+    "start": "node bin/eohr.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "dependencies": {
+    "esbuild": "^0.21.0"
+  },
+  "keywords": [
+    "electron",
+    "harmonyos",
+    "ohos",
+    "hot-reload",
+    "hot",
+    "reload",
+    "hvigor"
+  ],
+  "author": "zhangqingnan",
+  "license": "BSD-2-Clause",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "homepage": "",
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "docs/"
+  ]
+}

package/src/commands/clean.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * eohr clean — 恢复工程 + 清空设备
+ *
+ * 1. 删除 hot-reload-agent.js（工程文件）
+ * 2. 把 package.json 的 main 改回原始入口（从 .eohr.config.json 的 entry 读取）
+ * 3. 删除 .eohr.config.json
+ * 4. 清空设备 override 目录和状态文件
+ *
+ * 跑完后工程恢复到 eohr init 之前的状态，开发者重建 HAP 即可。
+ */
+var fs = require("fs");
+var path = require("path");
+var Config = require("../core/Config");
+var HdcBridge = require("../core/HdcBridge");
+var utils = require("../utils");
+var c = utils.c;
+
+function run(opts) {
+  opts = opts || {};
+  var config = Config.load(opts);
+  var dash = new (require("../core/Dashboard"))();
+
+  dash.info("开始恢复工程");
+
+  var appDir = config.appDir;
+  var agentJs = path.join(appDir, "hot-reload-agent.js");
+  var packageJsonPath = path.join(appDir, "package.json");
+  var configPath = path.join(config.hapRoot, Config.CONFIG_FILE);
+
+  var restored = [];
+
+  // 1. 删除 hot-reload-agent.js
+  if (fs.existsSync(agentJs)) {
+    fs.unlinkSync(agentJs);
+    restored.push("hot-reload-agent.js 已删除");
+  }
+
+  // 2. 把 package.json 的 main 改回原始入口
+  if (fs.existsSync(packageJsonPath)) {
+    var pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+    if (pkg.main === "hot-reload-agent.js") {
+      // 从 config.entry 推导原始文件名
+      var origMain = "main.js";
+      if (config.entry) {
+        origMain = path.basename(config.entry);
+      }
+      pkg.main = origMain;
+      fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2));
+      restored.push('package.json main → "' + origMain + '"');
+    }
+  }
+
+  // 3. 删除 .eohr.config.json
+  if (fs.existsSync(configPath)) {
+    fs.unlinkSync(configPath);
+    restored.push(".eohr.config.json 已删除");
+  }
+
+  // 输出恢复结果
+  if (restored.length > 0) {
+    restored.forEach(function (msg) {
+      console.log(c.green + "  [ok]" + c.reset + " " + msg);
+    });
+  } else {
+    dash.info("工程已是原始状态，无需恢复");
+  }
+
+  // 4. 清空设备 override 目录和状态文件
+  var hdc = new HdcBridge(config.bundleName);
+  console.log(c.dim + "  清空设备..." + c.reset);
+
+  hdc.shell("rm -rf " + config.physicalOverrideDir + "/*").then(function () {
+    return hdc.shell("rm -f " + config.physicalResultDir + "/hot-status.json " +
+                     config.physicalResultDir + "/hot-harness.log");
+  }).then(function () {
+    console.log(c.green + "  [ok]" + c.reset + " 设备已清空");
+    console.log();
+    console.log(c.bold + c.green + "  ✓ clean 完成" + c.reset);
+    console.log();
+    console.log(c.dim + "  工程已恢复到 eohr init 之前的状态。" + c.reset);
+    console.log(c.dim + "  请重建 HAP 让恢复生效:" + c.reset);
+    console.log(c.gray + "  hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon" + c.reset);
+    console.log(c.gray + '  hdc install <hap>' + c.reset);
+  }).catch(function (err) {
+    // 设备可能未连接，工程恢复已完成
+    console.log(c.yellow + "  [warn]" + c.reset + " 设备清理失败 (" + err.message + ")");
+    console.log();
+    console.log(c.bold + c.green + "  ✓ 工程已恢复" + c.reset);
+    console.log();
+    console.log(c.dim + "  请重建 HAP 让恢复生效:" + c.reset);
+    console.log(c.gray + "  hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon" + c.reset);
+    console.log(c.gray + '  hdc install <hap>' + c.reset);
+  });
+}
+
+module.exports = run;

package/src/commands/init.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * eohr init — 一次性初始化
+ *
+ * 只做两件事:
+ *   1. 在 app 目录新增 hot-reload-agent.js（不修改任何已有文件）
+ *   2. 修改 package.json 的 main 字段为 "hot-reload-agent.js"
+ *
+ * 开发者的 main.js 和其他文件完全不动。
+ */
+var fs = require("fs");
+var path = require("path");
+var Config = require("../core/Config");
+var utils = require("../utils");
+var c = utils.c;
+
+function run(opts) {
+  opts = opts || {};
+  var config = Config.load(opts);
+  var dash = new (require("../core/Dashboard"))();
+
+  dash.banner(config);
+
+  if (!config.bundleName) {
+    dash.error("无法探测 bundleName，请确保在 ohos_hap 工程根目录运行，或通过 --bundle-name 指定");
+    process.exit(1);
+  }
+
+  if (!config.appDir || !fs.existsSync(config.appDir)) {
+    dash.error("无法探测 app 目录 (resfile/resources/app/)，请通过 --app-dir 指定");
+    process.exit(1);
+  }
+
+  var agentJs = path.join(config.appDir, "hot-reload-agent.js");
+  var packageJsonPath = path.join(config.appDir, "package.json");
+
+  var tplDir = path.join(__dirname, "..", "..", "templates");
+  var tplAgent = path.join(tplDir, "hot-reload-agent.js");
+
+  // 1. 新增 hot-reload-agent.js（如果已存在则覆盖）
+  var agentContent = fs.readFileSync(tplAgent, "utf8");
+  fs.writeFileSync(agentJs, utils.stripBOM(agentContent));
+  dash.info("已新增 hot-reload-agent.js");
+
+  // 2. 修改 package.json 的 main 字段
+  if (!fs.existsSync(packageJsonPath)) {
+    dash.error("package.json 不存在: " + packageJsonPath);
+    process.exit(1);
+  }
+
+  var pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+  var origMain = pkg.main;
+
+  if (origMain === "hot-reload-agent.js") {
+    dash.info("package.json 已配置，跳过");
+  } else {
+    // 备份原始 main 值到 .eohr.config.json 的 entry 字段（转为相对 hapRoot 的路径）
+    if (origMain) {
+      var origMainAbs = path.isAbsolute(origMain) ? origMain : path.join(config.appDir, origMain);
+      config.entry = path.relative(config.hapRoot, origMainAbs).replace(/\\/g, "/");
+    }
+    pkg.main = "hot-reload-agent.js";
+    fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2));
+    dash.info("package.json main: \"" + origMain + "\" → \"hot-reload-agent.js\"");
+  }
+
+  // 3. 保存配置
+  var configPath = Config.save(config);
+  dash.info("已生成 " + path.basename(configPath));
+
+  // 4. 提示
+  console.log();
+  console.log(c.bold + c.green + "  ✓ init 完成" + c.reset);
+  console.log();
+  console.log(c.dim + "  改动清单:" + c.reset);
+  console.log("  " + c.green + "+" + c.reset + " hot-reload-agent.js  (新增)");
+  console.log("  " + c.yellow + "~" + c.reset + " package.json       (main → hot-reload-agent.js)");
+  console.log("  " + c.gray + "main.js             (未改动)" + c.reset);
+  console.log();
+  console.log(c.dim + "  下一步:" + c.reset);
+  console.log("  1. 重建 HAP 并安装 (仅此一次):");
+  console.log(c.gray + "     hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon" + c.reset);
+  console.log(c.gray + '     hdc install <hap-path>' + c.reset);
+  console.log();
+  console.log("  2. 启动热加载:");
+  console.log(c.gray + "     eohr watch" + c.reset);
+  console.log();
+
+  return config;
+}
+
+module.exports = run;

package/src/commands/log.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * eohr log — 查看设备运行日志
+ */
+var Config = require("../core/Config");
+var HdcBridge = require("../core/HdcBridge");
+var utils = require("../utils");
+var c = utils.c;
+
+function run(opts) {
+  opts = opts || {};
+  var config = Config.load(opts);
+  var hdc = new HdcBridge(config.bundleName);
+
+  var lines = opts._args && opts._args[0] ? parseInt(opts._args[0]) : 50;
+
+  console.log(c.cyan + "  [log]" + c.reset + " 最近 " + lines + " 行");
+  console.log(c.dim + "  ──────────────────────────────────────" + c.reset);
+
+  hdc.shell("tail -n " + lines + " " + config.physicalResultDir + "/hot-harness.log 2>/dev/null").then(function (content) {
+    if (!content || content.trim() === "") {
+      console.log(c.gray + "  (无日志文件)" + c.reset);
+    } else {
+      content.split("\n").forEach(function (line) {
+        console.log("  " + line);
+      });
+    }
+    console.log();
+  }).catch(function (err) {
+    console.error(c.red + "  [error]" + c.reset + " " + err.message);
+    process.exit(1);
+  });
+}
+
+module.exports = run;

package/src/commands/push.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * eohr push — 单次打包并推送 entry.js 到设备
+ *
+ * 用法:
+ *   eohr push              # 打包入口文件 + 推送 entry.js + 触发重载
+ *   eohr push --file <f>   # 推送单个文件到 override 目录
+ *   eohr push --no-trigger # 推送但不触发重载
+ */
+var fs = require("fs");
+var path = require("path");
+var os = require("os");
+var Config = require("../core/Config");
+var HdcBridge = require("../core/HdcBridge");
+var Bundler = require("../core/Bundler");
+var utils = require("../utils");
+var c = utils.c;
+
+function run(opts) {
+  opts = opts || {};
+  var config = Config.load(opts);
+  var hdc = new HdcBridge(config.bundleName);
+
+  console.log(c.cyan + "  [push]" + c.reset + " bundleName=" + config.bundleName);
+
+  // 单文件推送模式
+  if (opts.file) {
+    var localFile = path.resolve(opts.file);
+    var remoteName = opts.remoteName || path.basename(localFile);
+
+    if (!fs.existsSync(localFile)) {
+      console.error(c.red + "  [error]" + c.reset + " 文件不存在: " + localFile);
+      process.exit(1);
+    }
+
+    var content = fs.readFileSync(localFile);
+    var debommed = utils.stripBOM(content);
+    var tmpFile = path.join(os.tmpdir(), "eohr-" + remoteName);
+    fs.writeFileSync(tmpFile, debommed);
+
+    return hdc.mkdir(config.physicalOverrideDir).then(function () {
+      return hdc.pushOverride(tmpFile, remoteName, config);
+    }).then(function () {
+      console.log(c.green + "  [ok]" + c.reset + " " + remoteName + " pushed");
+      if (!opts.noTrigger) {
+        return hdc.touch(config.physicalOverrideDir + "/.reload-trigger").then(function () {
+          console.log(c.yellow + "  [reload]" + c.reset + " triggered");
+        });
+      }
+    }).catch(function (err) {
+      console.error(c.red + "  [error]" + c.reset + " " + err.message);
+      process.exit(1);
+    });
+  }
+
+  // 默认: 打包入口文件并推送
+  var bundler = new Bundler(config);
+
+  console.log(c.blue + "  [bundle]" + c.reset + " esbuild...");
+  console.log(c.dim + "  entry: " + config.entry + c.reset);
+  var start = Date.now();
+
+  return bundler.bundle().then(function (result) {
+    console.log(c.green + "  [ok]" + c.reset + " bundled (" + utils.fmtMs(Date.now() - start) + ")");
+
+    var tmpFile = path.join(os.tmpdir(), "eohr-entry.js");
+    fs.writeFileSync(tmpFile, result.code);
+
+    console.log(c.blue + "  [send]" + c.reset + " hdc file send...");
+    return hdc.mkdir(config.physicalOverrideDir).then(function () {
+      return hdc.pushOverride(tmpFile, "entry.js", config);
+    }).then(function () {
+      console.log(c.green + "  [ok]" + c.reset + " entry.js pushed");
+
+      var cfgJson = JSON.stringify({
+        strategy: config.strategy,
+        softTimeout: config.softTimeout,
+      });
+      var cfgTmp = path.join(os.tmpdir(), "eohr-hot-config.json");
+      fs.writeFileSync(cfgTmp, cfgJson);
+      return hdc.pushOverride(cfgTmp, "hot-config.json", config);
+    }).then(function () {
+      if (!opts.noTrigger) {
+        if (config.strategy === "hard") {
+          console.log(c.dim + "  重启应用..." + c.reset);
+          return hdc.forceStop().then(function () {
+            return hdc.startAbility();
+          }).then(function () {
+            console.log(c.yellow + "  [reload]" + c.reset + " app restarted");
+          });
+        } else {
+          return hdc.touch(config.physicalOverrideDir + "/.reload-trigger").then(function () {
+            console.log(c.yellow + "  [reload]" + c.reset + " triggered");
+          });
+        }
+      }
+    });
+  }).catch(function (err) {
+    console.error(c.red + "  [error]" + c.reset + " " + err.message);
+    process.exit(1);
+  });
+}
+
+module.exports = run;

package/src/commands/setup.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * eohr setup — 自动配置快捷命令
+ *
+ * 自动检测当前终端类型（PowerShell / cmd / bash / zsh），
+ * 在对应配置文件中写入快捷命令，重启终端后 `eohr` 即可直接使用。
+ */
+var fs = require("fs");
+var path = require("path");
+var os = require("os");
+var utils = require("../utils");
+var c = utils.c;
+
+function run(opts) {
+  opts = opts || {};
+  var binPath = path.resolve(__dirname, "..", "..", "bin", "eohr.js");
+  var platform = os.platform();
+  var isWin = platform === "win32";
+  var isMac = platform === "darwin";
+
+  var dash = new (require("../core/Dashboard"))();
+
+  // 检测当前 shell 类型
+  var shell = detectShell();
+  dash.info("当前终端: " + shell);
+  dash.info("平台: " + (isWin ? "Windows" : isMac ? "macOS" : "Linux"));
+  dash.info("eohr 路径: " + binPath);
+
+  var success = false;
+  var instructions = [];
+
+  if (isWin) {
+    // Windows: 同时配置 PowerShell 和 cmd
+    success = setupPowerShell(binPath, dash) | setupCmd(binPath, dash);
+  } else {
+    // macOS / Linux: 配置 bash/zsh
+    success = setupUnix(binPath, dash, isMac);
+  }
+
+  if (success) {
+    console.log();
+    console.log(c.bold + c.green + "  ✓ setup 完成" + c.reset);
+    console.log();
+    console.log(c.dim + "  请重新打开终端，然后运行:" + c.reset);
+    console.log(c.gray + "  eohr --version" + c.reset);
+    console.log();
+  }
+}
+
+/** 检测当前 shell */
+function detectShell() {
+  var term = process.env.TERM || "";
+  var shell = process.env.SHELL || "";
+  var comspec = process.env.COMSPEC || "";
+
+  // PowerShell
+  if (process.env.PSModulePath !== undefined) {
+    return "PowerShell";
+  }
+  // cmd
+  if (comspec.toLowerCase().indexOf("cmd.exe") >= 0) {
+    return "cmd";
+  }
+  // zsh
+  if (shell.indexOf("zsh") >= 0) {
+    return "zsh";
+  }
+  // bash
+  if (shell.indexOf("bash") >= 0) {
+    return "bash";
+  }
+  return shell || "unknown";
+}
+
+/** 配置 PowerShell */
+function setupPowerShell(binPath, dash) {
+  var profileDir = path.join(os.homedir(), "Documents", "WindowsPowerShell");
+  var profilePath = path.join(profileDir, "Microsoft.PowerShell_profile.ps1");
+
+  try {
+    if (!fs.existsSync(profileDir)) {
+      fs.mkdirSync(profileDir, { recursive: true });
+    }
+    if (!fs.existsSync(profilePath)) {
+      fs.writeFileSync(profilePath, "");
+    }
+
+    var content = fs.readFileSync(profilePath, "utf8");
+    var line = 'function eohr { node "' + binPath + '" @args }';
+
+    if (content.indexOf("function eohr") >= 0) {
+      dash.info("PowerShell: 已配置，跳过");
+    } else {
+      var newContent = content.trimEnd() + "\n" + line + "\n";
+      fs.writeFileSync(profilePath, newContent);
+      dash.info("PowerShell: 已写入 " + profilePath);
+    }
+
+    // 设置执行策略，允许当前用户运行本地脚本
+    try {
+      require("child_process").execSync(
+        'powershell -Command "Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force"',
+        { windowsHide: true, timeout: 10000 }
+      );
+      dash.info("PowerShell: 执行策略已设置为 RemoteSigned");
+    } catch (e) {
+      console.log(c.yellow + "  [warn]" + c.reset + " 无法自动设置执行策略，请手动运行:");
+      console.log(c.gray + "  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser" + c.reset);
+    }
+
+    return true;
+  } catch (e) {
+    dash.error("PowerShell 配置失败: " + e.message);
+    console.log(c.gray + "  手动添加: 在 $PROFILE 中加入:" + c.reset);
+    console.log(c.gray + '  function eohr { node "' + binPath + '" @args }' + c.reset);
+    return false;
+  }
+}
+
+/** 配置 cmd (创建 eohr.bat) */
+function setupCmd(binPath, dash) {
+  var batPath = path.join(os.homedir(), "eohr.bat");
+  var content = '@node "' + binPath + '" %*\r\n';
+
+  try {
+    fs.writeFileSync(batPath, content);
+    dash.info("cmd: 已创建 " + batPath);
+
+    // 自动把用户目录加入用户 PATH
+    var pathEnv = process.env.PATH || "";
+    var homeInPath = pathEnv.split(path.delimiter).some(function (p) {
+      return p.toLowerCase() === os.homedir().toLowerCase();
+    });
+
+    if (!homeInPath) {
+      try {
+        var userPath = require("child_process").execSync(
+          'powershell -Command "[System.Environment]::GetEnvironmentVariable(\'PATH\', \'User\')"',
+          { encoding: "utf8" }
+        ).trim();
+        if (userPath.toLowerCase().indexOf(os.homedir().toLowerCase()) < 0) {
+          require("child_process").execSync(
+            'powershell -Command "[System.Environment]::SetEnvironmentVariable(\'PATH\', \'' +
+              os.homedir() + ";\" + [System.Environment]::GetEnvironmentVariable('PATH', 'User'), 'User\")",
+            { windowsHide: true }
+          );
+          dash.info("cmd: 已将用户目录加入 PATH");
+        }
+      } catch (e) {
+        console.log(c.yellow + "  [warn]" + c.reset + " 无法自动加入 PATH，请手动将 " + os.homedir() + " 加入系统 PATH");
+      }
+    }
+
+    return true;
+  } catch (e) {
+    dash.error("cmd 配置失败: " + e.message);
+    return false;
+  }
+}
+
+/** 配置 macOS / Linux */
+function setupUnix(binPath, dash, isMac) {
+  var home = os.homedir();
+  var candidates = isMac
+    ? [path.join(home, ".zshrc"), path.join(home, ".bash_profile")]
+    : [path.join(home, ".bashrc"), path.join(home, ".bash_profile")];
+
+  var line = 'alias eohr="node ' + binPath + '"';
+
+  for (var i = 0; i < candidates.length; i++) {
+    var rcPath = candidates[i];
+    try {
+      if (!fs.existsSync(rcPath)) {
+        fs.writeFileSync(rcPath, "");
+      }
+      var content = fs.readFileSync(rcPath, "utf8");
+
+      if (content.indexOf("alias eohr=") >= 0) {
+        dash.info(path.basename(rcPath) + ": 已配置，跳过");
+        return true;
+      }
+
+      var newContent = content.trimEnd() + "\n" + line + "\n";
+      fs.writeFileSync(rcPath, newContent);
+      dash.info("已写入 " + rcPath);
+      return true;
+    } catch (e) {
+      // 尝试下一个
+    }
+  }
+
+  console.log(c.gray + "  手动添加: 在你的 shell 配置文件中加入:" + c.reset);
+  console.log(c.gray + "  " + line + c.reset);
+  return false;
+}
+
+module.exports = run;

package/src/commands/status.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * eohr status — 查询设备侧 agent 状态
+ */
+var Config = require("../core/Config");
+var HdcBridge = require("../core/HdcBridge");
+var utils = require("../utils");
+var c = utils.c;
+
+function run(opts) {
+  opts = opts || {};
+  var config = Config.load(opts);
+  var hdc = new HdcBridge(config.bundleName);
+
+  console.log(c.cyan + "  [status]" + c.reset + " bundleName=" + config.bundleName);
+  console.log(c.dim + "  ──────────────────────────────────────" + c.reset);
+
+  hdc.isDeviceConnected().then(function (connected) {
+    console.log("  Device:    " + (connected ? c.green + "connected" + c.reset : c.red + "disconnected" + c.reset));
+    if (!connected) {
+      console.log(c.red + "  设备未连接" + c.reset);
+      process.exit(1);
+    }
+
+    return hdc.readResult("hot-status.json", config);
+  }).then(function (statusContent) {
+    if (statusContent) {
+      try {
+        var status = JSON.parse(statusContent.trim());
+        console.log("  Status:    " + status.status);
+        console.log("  PID:       " + (status.pid || "?"));
+        console.log("  Strategy:  " + (status.strategy || "?"));
+        if (status.error) {
+          console.log(c.red + "  Error:     " + status.error + c.reset);
+        }
+      } catch (e) {
+        console.log(c.gray + "  Status:    (无法解析)" + c.reset);
+      }
+    } else {
+      console.log(c.gray + "  Status:    (无状态文件，agent 可能未启动)" + c.reset);
+    }
+
+    return hdc.shell("ls -la " + config.physicalOverrideDir + "/entry.js 2>/dev/null");
+  }).then(function (lsResult) {
+    if (lsResult) {
+      console.log("  Entry.js:  " + c.green + "exists" + c.reset);
+    } else {
+      console.log("  Entry.js:  " + c.gray + "not found" + c.reset);
+    }
+    console.log();
+  }).catch(function (err) {
+    console.error(c.red + "  [error]" + c.reset + " " + err.message);
+    process.exit(1);
+  });
+}
+
+module.exports = run;

package/src/commands/strategy.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * eohr strategy — 切换重载策略
+ *
+ * 用法:
+ *   eohr strategy soft        # 仅软重载 (require.cache 失效)
+ *   eohr strategy hard        # 仅硬重载 (app.quit + restart, 默认)
+ *   eohr strategy hard-first  # 软重载优先, 失败回退硬重载
+ */
+var fs = require("fs");
+var path = require("path");
+var os = require("os");
+var Config = require("../core/Config");
+var HdcBridge = require("../core/HdcBridge");
+var utils = require("../utils");
+var c = utils.c;
+
+function run(opts) {
+  opts = opts || {};
+  var config = Config.load(opts);
+  var strategy = opts._args && opts._args[0];
+
+  if (!strategy) {
+    console.log(c.cyan + "  [strategy]" + c.reset + " 当前: " + config.strategy);
+    console.log();
+    console.log("  可选值:");
+    console.log("    soft        仅软重载 (require.cache 失效, ~1-3s)");
+    console.log("    hard        仅硬重载 (app.quit + restart, ~15s, 默认)");
+    console.log("    hard-first  软重载优先, 失败回退硬重载");
+    return;
+  }
+
+  var valid = ["soft", "hard", "hard-first"];
+  if (valid.indexOf(strategy) < 0) {
+    console.error(c.red + "  [error]" + c.reset + " 无效策略: " + strategy);
+    console.error("  可选: " + valid.join(", "));
+    process.exit(1);
+  }
+
+  config.strategy = strategy;
+  Config.save(config);
+
+  var hdc = new HdcBridge(config.bundleName);
+  var cfgJson = JSON.stringify({
+    strategy: config.strategy,
+    softTimeout: config.softTimeout,
+  });
+
+  var tmpFile = path.join(os.tmpdir(), "eohr-hot-config.json");
+  fs.writeFileSync(tmpFile, cfgJson);
+
+  hdc.mkdir(config.physicalOverrideDir).then(function () {
+    return hdc.pushOverride(tmpFile, "hot-config.json", config);
+  }).then(function () {
+    console.log(c.green + "  [ok]" + c.reset + " 策略已切换: " + c.bold + strategy + c.reset);
+    console.log(c.dim + "  配置已推送到设备，下次重载生效" + c.reset);
+  }).catch(function (err) {
+    console.log(c.yellow + "  [warn]" + c.reset + " 设备推送失败 (" + err.message + ")");
+    console.log(c.dim + "  本地配置已更新，下次 eohr watch 时生效" + c.reset);
+  });
+}
+
+module.exports = run;