electron-ohos-hotreload 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,63 @@
+# electron-ohos-hotreload
+
+Hot-reload CLI for Electron on HarmonyOS — push JS/TS changes to device without rebuilding HAP.
+
+## Install
+
+```bash
+npm install -g electron-ohos-hotreload
+```
+
+## Quick Start
+
+```bash
+# 1. 进入你的 ohos_hap 工程目录
+cd <你的路径>/ohos_hap
+
+# 2. 初始化（一次性）
+eohr init
+
+# 3. 重建 HAP 并安装到设备（仅此一次）
+hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon
+hdc install <hap文件>
+
+# 4. 启动热加载
+eohr watch
+```
+
+然后正常写代码，改完保存，切到终端按 `Ctrl+Shift+X`，十几秒设备上就生效了。
+
+## What eohr init does
+
+- **新增** `hot-reload-agent.js`（工具自己的文件）
+- **改一行** `package.json`（`main` 字段指向 agent）
+- **不碰** `main.js`，你的代码原封不动
+
+用完了执行 `eohr clean` 自动还原，不留痕迹。
+
+## Commands
+
+| 命令 | 说明 |
+|------|------|
+| `eohr init` | 一次性初始化 |
+| `eohr watch` | 启动热加载（按 Ctrl+Shift+X 推送） |
+| `eohr watch --auto` | 保存即自动推送 |
+| `eohr push` | 单次推送 |
+| `eohr status` | 查询设备状态 |
+| `eohr strategy` | 查看/切换策略 |
+| `eohr log` | 查看设备日志 |
+| `eohr clean` | 恢复工程 + 清空设备 |
+
+## Reload Strategy
+
+默认 `hard`（杀进程重启），完全干净无副作用。业界标准做法。
+
+## Docs
+
+- [快速上手](docs/quick-start.md)
+- [用户使用手册](docs/user-manual.md)
+- [设计手册](docs/design-manual.md)
+
+## License
+
+BSD-2-Clause

package/bin/eohr.js

@@ -17,7 +17,7 @@
  */
 var path = require("path");
 
-var VERSION = "1.0.0";
+var VERSION = "1.0.2";
 
 function parseArgs(argv) {
   var args = argv.slice(2);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "electron-ohos-hotreload",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Hot-reload CLI for Electron on HarmonyOS — push JS/TS changes to device without rebuilding HAP",
   "bin": {
-    "eohr": "./bin/eohr.js"
+    "eohr": "bin/eohr.js"
   },
   "main": "bin/eohr.js",
   "scripts": {
@@ -35,6 +35,8 @@
     "bin/",
     "src/",
     "templates/",
-    "docs/"
+    "docs/quick-start.md",
+    "docs/user-manual.md",
+    "README.md"
   ]
 }

package/docs/design-manual.md

@@ -1,445 +0,0 @@
-# Electron OHOS Hot-Reload 设计手册
-
-> **版本**: 1.4.0
-> **日期**: 2026-09-09
-> **工具名称**: `eohr` (Electron OHOS Hot-Reload)
-
----
-
-## 1. 背景与目�?
-### 1.1 问题
-
-在鸿蒙版 Electron 工程中，开发者的 JS/TS 代码打包�?HAP 内的 `resfile/resources/app/` 目录中。每次修改代码都需要重�?HAP、卸载重装、重启应用，单次迭代 3~4 分钟�?
-### 1.2 目标
-
-让开发者修改自己的 Electron 应用代码后，**无需重建 HAP**�?~15 秒内完成推�?�?重载�?
-### 1.3 设计原则
-
-- **不碰开发者文�?* �?`eohr init` 不修改开发者的 `main.js` 或任何业务文件，只新增一个文�?+ �?`package.json` 一�?- **零侵�?* �?不修�?ETS / 原生�?- **可恢�?* �?`eohr clean` 一条命令恢复工程到 init 之前的状态，不留痕迹
-- **生产安全** �?�?override �?agent 直接加载开发者的 `main.js`，行为与未安�?eohr 完全一�?
-### 1.4 约束
-
-| 约束 | 影响 |
-|------|------|
-| resfile 只读 | HAP 内的文件不能运行时修改，但可从可写目�?override |
-| 沙箱可写 `/data/storage/el2/base/files/` | override 目录放这�?|
-| 物理路径 `hdc shell cat` | 状�?日志读取走物理路�?|
-| ETS 编译�?HAP | ETS 改动必须全量构建 |
-| Electron 启动�?`package.json` �?`main` 字段 | 通过�?`main` 字段注入 agent |
-| BOM 问题 | 推送前自动�?BOM |
-| node_modules 符号链接 | esbuild 打包为单文件规避 |
-
----
-
-## 2. 架构
-
-### 2.1 系统拓扑
-
-```
-┌───────────────────────────────────────────────────────────────────�?�? 开发机 (Windows)                                                  �?�?                                                                   �?�? ┌──────────�? ┌───────────�? ┌──────────�? ┌──────────�?        �?�? │FileWatcher│─▶│ Bundler   │─▶│stripBOM  │─▶│HdcBridge �?        �?�? │fs.watch   �? │esbuild    �? �? hash    �? │file send �?        �?�? �? 轮询兜底  �? │开发者代�? �? �? diff    �? �? touch   �?        �?�? └──────────�? └───────────�? └──────────�? └────┬─────�?        �?�?                                                   �?              �?�? ┌────────────────────────────────────────────�?  �?              �?�? �? eohr CLI                                   �?  �?              �?�? �? init / watch / push / status / strategy    �?  �?              �?�? �? clean / log                                �?  �?              �?�? └────────────────────────────────────────────�?  �?              �?�?                                                   �?              �?�? ┌────────────────────────────────────────────�?  �?              �?�? �? Dashboard (终端彩色输出)                    �?  �?              �?�? �? 文件变更 / 打包 / 推�?/ 重载状�?           �?  �?              �?�? └────────────────────────────────────────────�?  �?              �?�?                                                   �?              �?�? ┌────────────────────────────────────────────�?  �?              �?�? �? 键盘交互 (手动模式)                         �?  �?              �?�? �? Ctrl+Shift+X 触发推�?(可配�?              �?  �?              �?�? �? q / Ctrl+C 退�?                            �?  �?              �?�? └────────────────────────────────────────────�?  �?              �?└────────────────────────────────────────────────────┼───────────────�?                       �?hdc                         �?┌───────────────────────▼────────────────────────────▼───────────────�?�? 设备 (HarmonyOS)                                                  �?�?                                                                   �?�? ┌──────────────────────────────────────────────────────────�?    �?�? �? Electron 进程 (libelectron.so @ UIAbility)                �?    �?�? �?                                                           �?    �?�? �? resfile/resources/app/ (只读, �?HAP 发布):               �?    �?�? �? ├── package.json        �?main: "hot-reload-agent.js"    �?    �?�? �? ├── main.js             �?开发者原始代�?(未改�?          �?    �?�? �? └── hot-reload-agent.js �?设备�?agent (eohr init 新增)    �?    �?�? �?                                                           �?    �?�? �? /data/storage/el2/base/files/hot/ (可写 override):        �?    �?�? �? ├── entry.js             �?esbuild 打包产物 (开发者代�?   �?    �?�? �? ├── hot-config.json      �?运行时配�?                    �?    �?�? �? └── .reload-trigger      �?touch 触发重载                  �?    �?�? �?                                                           �?    �?�? �? ┌──────────────────────────────────────────────────�?    �?    �?�? �? �?hot-reload-agent.js 运行�?                        �?    �?    �?�? �? �? ├─ app.whenReady() �?加载 entry.js (有则�?        �?    �?    �?�? �? �? �?                 �?否则 require('./main.js')     �?    �?    �?�? �? �? ├─ fs.watch override 目录                         �?    �?    �?�? �? �? ├─ setInterval 轮询兜底 (2s)                       �?    �?    �?�? �? �? ├─ soft: require.cache 失效 + 重新 require         �?    �?    �?�? �? �? └─ hard: app.quit() �?系统重启 Ability             �?    �?    �?�? �? └──────────────────────────────────────────────────�?    �?    �?�? └──────────────────────────────────────────────────────────�?    �?�?                                                                   �?�? /data/storage/el2/base/files/ (状�? 可写):                       �?�? ├── hot-status.json     �?agent 状�?                             �?�? └── hot-harness.log     �?运行日志                                �?└────────────────────────────────────────────────────────────────────�?```
-
-### 2.2 模块划分
-
-```
-electron-ohos-hotreload/
-├── bin/
-�?  └── eohr.js                     CLI 入口，参数解�?+ 命令分发
-├── src/
-�?  ├── utils.js                    共享工具 (BOM/JSON5/hash/ANSI)
-�?  ├── core/
-�?  �?  ├── Config.js               配置管理 (自动探测 + .eohr.config.json)
-�?  �?  ├── HdcBridge.js            hdc 命令封装 (查找/执行/文件传输)
-�?  �?  ├── Bundler.js              esbuild 打包�?�?  �?  ├── FileWatcher.js          文件监听 (fs.watch + 轮询兜底)
-�?  �?  ├── StatusPoller.js         设备状态轮�?�?  �?  └── Dashboard.js            终端输出面板
-�?  └── commands/
-�?      ├── setup.js                eohr setup �?自动配置快捷命令
-�?      ├── init.js                 eohr init  �?新增 agent + �?package.json
-�?      ├── watch.js                eohr watch �?热加载循�?+ 键盘交互
-�?      ├── push.js                 eohr push  �?单次打包推�?�?      ├── status.js               eohr status �?查询设备状�?�?      ├── strategy.js             eohr strategy �?切换重载策略
-�?      ├── clean.js                eohr clean  �?恢复工程 + 清空设备
-�?      └── log.js                  eohr log   �?查看设备日志
-├── templates/
-�?  └── hot-reload-agent.js         设备�?agent 模板
-├── docs/
-�?  ├── design-manual.md            设计手册
-�?  └── user-manual.md              用户使用手册
-└── package.json
-```
-
----
-
-## 3. 核心设计
-
-### 3.1 注入方式（不碰开发者文件）
-
-Electron 启动时读 `package.json` �?`main` 字段决定加载哪个 JS 文件。`eohr init` 只做两件事：
-
-```
-eohr init 做的�?
-  1. 新增 hot-reload-agent.js �?app 目录（不修改任何已有文件�?  2. 修改 package.json �?main 字段: "main.js" �?"hot-reload-agent.js"
-```
-
-改动清单:
-
-| 文件 | 操作 | 说明 |
-|------|------|------|
-| `hot-reload-agent.js` | **新增** | 设备�?agent |
-| `package.json` | **改一�?* | `main` 字段指向 agent |
-| `main.js` | **不碰** | 开发者的原始代码，原封不�?|
-
-Electron 启动时加�?`hot-reload-agent.js`，agent 接管后决定加载谁�?
-### 3.2 设备�?Agent
-
-**文件**: `templates/hot-reload-agent.js`
-
-#### 加载优先�?
-```
-Electron 启动 �?package.json main �?hot-reload-agent.js
-  �?  ├─ 1) /data/storage/el2/base/files/hot/entry.js   (override, hdc 推送的开发者代�?
-  �?    └─ 开发模�? 加载 esbuild 打包的最新代�?  �?  └─ 2) ./main.js                                     (开发者的原始入口)
-        └─ 生产模式 / 首次运行: 加载开发者的原始代码
-```
-
-- �?`entry.js` �?加载推送的代码（热加载模式�?- 没有 `entry.js` �?加载开发者的 `main.js`（生产模式，与未安装 eohr 时行为完全一致）
-
-#### 生命周期
-
-```
-app.whenReady()
-  ├─ loadConfig()               读取 hot-config.json
-  ├─ writeStatus("agent-ready")
-  ├─ loadEntry()                首次加载开发者代�?  �?  ├─ entry.js 存在 �?require(entry.js)
-  �?  └─ 不存�?�?require('./main.js')
-  ├─ 成功 �?writeStatus("loaded")
-  �? 失败 �?writeStatus("init-fail")
-  └─ startWatch()
-      ├─ fs.watch(OVERRIDE_DIR)     通道 1
-      └─ setInterval(2000)          通道 2: 轮询兜底
-```
-
-#### 重载策略
-
-| 策略 | 机制 | 耗时 | 适用 |
-|------|------|------|------|
-| **hard** | `app.quit()` �?系统重启 Ability | ~15s | 默认，推�?|
-| **soft** | `require.cache` 失效 + 重新 `require` | 1~3s | 无副作用的纯逻辑模块 |
-| **hard-first** | �?soft，失�?500ms 后回退 hard | 1~3s / 15s | 按需 |
-
-hard �?Electron 主进程热加载的业界标准做法。`electron-reload`、`electronmon` 等工具均采用杀进程重启方式，因为主进程的窗口、IPC、定时器等副作用无法通过清缓存完全回收�?
-**soft 重载**:
-```
-softReload()
-  ├─ currentModule.cleanup()     (如有)
-  ├─ 失效 require.cache (OVERRIDE_DIR 下的条目 + DEV_MAIN)
-  ├─ loadEntry()                 重新加载开发者代�?  ├─ 成功 �?writeStatus("soft-ok")
-  └─ 失败 �?writeStatus("soft-fail") �?返回 false
-```
-
-**hard-first 调度**:
-```
-reload()
-  ├─ reloadInProgress = true     防重�?  ├─ loadConfig()
-  ├─ soft �?softReload()
-  ├─ hard �?hardReload()
-  ├─ hard-first:
-  �?  ├─ ok = softReload()
-  �?  ├─ ok �?完成
-  �?  └─ !ok �?setTimeout(hardReload, 500)
-  └─ reloadInProgress = false
-```
-
-#### 双通道文件监听
-
-- **通道 1**: `fs.watch(OVERRIDE_DIR)` �?监听 `.reload-trigger` �?`entry.js` 变更
-- **通道 2**: `setInterval(2000)` 轮询 `.reload-trigger` �?mtime �?兜底（某�?OHOS 路径 fs.watch 不可靠）
-- 两个通道都有 `reloadInProgress` 防重�?
-#### 状态上�?
-`hot-status.json`:
-
-| status | 含义 |
-|--------|------|
-| `agent-ready` | Agent 启动完成 |
-| `waiting` | 等待首次 entry.js 推�?|
-| `loaded` | 首次加载成功 |
-| `soft-reloading` | 软重载进行中 |
-| `soft-ok` | 软重载成�?|
-| `soft-fail` | 软重载失�?|
-| `hard-reloading` | 硬重载进行中 |
-| `init-fail` | 首次加载失败 |
-
-### 3.3 主机�?Bundler
-
-**文件**: `src/core/Bundler.js`
-
-�?esbuild 将开发者的入口文件打包成自包含�?`entry.js`�?
-```
-bundle()
-  ├─ 解析入口文件 (config.entry, �?"web_engine/.../app/main.js")
-  ├─ esbuild.build()
-  �?  ├─ entryPoints: [入口文件]
-  �?  ├─ bundle: true              内联解析所有依�?  �?  ├─ platform: "node"
-  �?  ├─ format: "cjs"
-  �?  ├─ external: ["electron", ...nodeBuiltins]  运行时提�?  �?  ├─ sourcemap: "inline"
-  �?  └─ write: false
-  ├─ stripBOM(output)
-  └─ simpleHash(code) �?{ code, hash, changed }
-```
-
-**关键设计**:
-- `electron` 标记 external �?运行时由 Electron 提供
-- Node.js 内置模块 (fs/path/...) 标记 external �?运行时提�?- 项目 `node_modules` 中的依赖打进 bundle �?设备端无需 node_modules
-- `sourcemap: "inline"` �?便于调试
-- `hash` diff �?内容未变时跳过推�?
-### 3.4 主机�?FileWatcher
-
-**文件**: `src/core/FileWatcher.js`
-
-| 平台 | 主通道 | 兜底 |
-|------|--------|------|
-| Windows | `fs.watch({ recursive: true })` | 轮询 (2s) |
-| Linux/macOS | 递归 `fs.watch` | 轮询 (2s) |
-
-- 500ms 防抖合并多文件变�?- 只监�?`.ts` / `.js` 文件
-- 排除 `node_modules` / `.git` / `dist` / `entry.js`
-
-**手动模式 vs auto 模式**:
-
-FileWatcher 始终监听文件变化，区别在收到变化后的行为�?
-| 模式 | FileWatcher 回调行为 |
-|------|---------------------|
-| 手动 (默认) | 文件名加�?`pendingChanges` 数组，终端显�?`[pending]`，等用户按触发键才推�?|
-| auto (`--auto`) | 直接调用 `doReloadCycle()` 打包推�?|
-
-### 3.5 主机侧触发键
-
-**文件**: `src/commands/watch.js` 中的 `parseTriggerKey()` + `startKeyboardInput()`
-
-手动模式下，开发者在终端按配置的组合键触发推�?重载�?
-**默认**: `Ctrl+Shift+X`，可�?`.eohr.config.json` �?`triggerKey` 字段配置�?
-**实现**:
-- `process.stdin.setRawMode(true)` 进入 raw 模式捕获原始按键
-- `parseTriggerKey()` 把配置字符串（如 `"ctrl+shift+x"`）解析为匹配函数
-- raw 模式�?Ctrl+字母 的编码是 `\x01`~`\x1a`，终端不区分 Shift 所�?Ctrl+Shift+X 匹配 `\x18`
-- �?`q` �?`Ctrl+C` 退�?
-**支持的格�?*:
-
-| 配置�?| 按键 |
-|--------|------|
-| `"ctrl+shift+x"` | Ctrl+Shift+X（默认） |
-| `"ctrl+r"` | Ctrl+R |
-| `"ctrl+alt+t"` | Ctrl+Alt+T |
-| `"f5"` | F5 功能�?|
-| `"space"` | 空格�?|
-| `"enter"` | 回车�?|
-
-### 3.6 主机�?HdcBridge
-
-**文件**: `src/core/HdcBridge.js`
-
-**hdc 查找**: `DEVECO_SDK_HOME` �?常见路径 �?PATH
-
-**沙箱路径 vs 物理路径**:
-
-| 类型 | 格式 | hdc 可读 |
-|------|------|---------|
-| 沙箱 | `/data/storage/el2/base/files/` | �?(进程退出后) |
-| 物理 | `/data/app/el2/100/base/<bundle>/files/` | �?|
-
-- `hdc file send` �?物理路径
-- `hdc shell cat` �?物理路径
-- Agent 运行时写 �?沙箱路径（同一物理位置�?
-### 3.7 主机�?StatusPoller
-
-**文件**: `src/core/StatusPoller.js`
-
-每秒通过 `hdc cat` 读取 `hot-status.json`，状态变化时触发回调�?
-### 3.8 主机�?Config
-
-**文件**: `src/core/Config.js`
-
-**合并优先�?*: CLI 参数 > `.eohr.config.json` > 自动探测 > 默认�?
-**自动探测**:
-
-| 配置 | 来源 |
-|------|------|
-| `hapRoot` | 向上�?`build-profile.json5` |
-| `bundleName` | `AppScope/app.json5` �?`app.bundleName` |
-| `appDir` | `web_engine/.../resfile/resources/app/` |
-| `entry` | `appDir/main.ts` �?`src/main.ts` �?默认 |
-
----
-
-## 4. 数据�?
-### 4.1 热加载迭代循环（手动模式�?
-```
-开发者保存代码文�?(�?main.js)
-  �?  �?FileWatcher 检测变�?(fs.watch 或轮�?
-  �?  �? (手动模式: 不立即推�?
-pendingChanges.push(file)
-终端显示 [pending] main.js (�?Ctrl+Shift+X 推�?
-  �?  �? 开发者按 Ctrl+Shift+X
-清空 pendingChanges
-  �?  �?Bundler.bundle()
-  ├─ esbuild 打包开发者入口文�?�?entry.js
-  ├─ stripBOM
-  └─ simpleHash �?changed?
-      ├─ unchanged �?跳过
-      └─ changed �?继续
-          �?HdcBridge.pushOverride(entry.js)
-  �? hdc file send �?物理路径
-  �?HdcBridge.touch(.reload-trigger)
-  �? hdc shell touch
-  �?设备�?Agent 检测到触发 (fs.watch 或轮�?
-  �?  �?Agent.reload()
-  ├─ soft: require.cache 失效 �?loadEntry() �?require(entry.js)
-  ├─ hard: app.quit() �?系统重启
-  └─ hard-first: soft �?失败回退 hard
-      �?      �?开发者代码在设备上重新执�?  �?  �?Agent.writeStatus("soft-ok" / "soft-fail")
-  �?  �?主机�?StatusPoller 轮询 (1s)
-  └─ Dashboard.statusUpdate() �?终端显示
-```
-
-### 4.2 auto 模式
-
-与手动模式唯一区别：FileWatcher 回调中跳�?`pendingChanges`，直接调�?`doReloadCycle()`。保存即推送，无需按键�?
----
-
-## 5. 容错设计
-
-### 5.1 生产安全
-
-- �?`entry.js` �?agent 加载开发者的 `main.js`，行为与未安�?eohr 完全一�?- `hot-config.json` 不存�?�?使用默认配置
-- `eohr init` 不修改开发者的 `main.js`
-
-### 5.2 可恢�?
-`eohr clean` 一条命令恢复工程：
-1. 删除 `hot-reload-agent.js`
-2. `package.json` �?`main` 改回原始�?3. 删除 `.eohr.config.json`
-4. 清空设备 override 目录和状态文�?
-### 5.3 BOM 处理
-
-`utils.stripBOM()` 在打�?推送时自动去除 UTF-8 BOM�?
-### 5.4 防重�?
-Agent �?`reloadInProgress` 标志防止 fs.watch + 轮询同时触发�?
-### 5.5 hash diff
-
-内容未变时跳过推送，避免无意义重载�?
-### 5.6 soft 失败兜底
-
-`hard-first` 策略�?soft 重载失败�?500ms 自动回退 hard�?
----
-
-## 6. 配置
-
-### 6.1 .eohr.config.json
-
-```json
-{
-  "bundleName": "com.huawei.ohos_electron",
-  "hapRoot": "<工作区路�?/ohos_hap",
-  "appDir": "<工作区路�?/ohos_hap/web_engine/src/main/resources/resfile/resources/app",
-  "entry": "web_engine/src/main/resources/resfile/resources/app/main.js",
-  "strategy": "hard",
-  "triggerKey": "ctrl+shift+x",
-  "watch": [
-    "web_engine/src/main/resources/resfile/resources/app/**/*.ts",
-    "web_engine/src/main/resources/resfile/resources/app/**/*.js",
-    "src/**/*.ts",
-    "src/**/*.js"
-  ],
-  "ignore": ["node_modules/**", "dist/**", ".git/**"],
-  "userId": 100,
-  "softTimeout": 5000,
-  "pollInterval": 2000
-}
-```
-
-| 字段 | 说明 | 默认�?|
-|------|------|--------|
-| `entry` | 开发者入口文�?| 自动探测 |
-| `strategy` | 重载策略 | `hard` |
-| `triggerKey` | 触发键（手动模式�?| `ctrl+shift+x` |
-| `watch` | 监听的文�?glob | 自动探测（含 app 目录 + src 目录�?|
-| `ignore` | 忽略的文�?glob | `["node_modules/**", "dist/**", ".git/**"]` |
-| `userId` | OHOS 用户 ID | `100` |
-| `softTimeout` | soft 重载超时 (ms) | `5000` |
-| `pollInterval` | 文件轮询间隔 (ms) | `2000` |
-
-### 6.2 hot-config.json (设备�?
-
-```json
-{
-  "strategy": "hard",
-  "softTimeout": 5000
-}
-```
-
-通过 `eohr strategy` / `eohr push` / `eohr watch` 时自动推送到设备�?
----
-
-## 7. 关键路径
-
-| 路径 | 说明 | 可写�?|
-|------|------|--------|
-| `resfile/resources/app/package.json` | main 指向 agent | 只读 |
-| `resfile/resources/app/main.js` | 开发者原始代�?| 只读 |
-| `resfile/resources/app/hot-reload-agent.js` | 设备�?agent | 只读 |
-| `/data/storage/el2/base/files/hot/` | override 目录 (沙箱) | 可写 |
-| `/data/app/el2/100/base/<bundle>/files/hot/` | override 目录 (物理) | 可写 |
-| `/data/storage/el2/base/files/hot-status.json` | Agent 状�?| 可写 |
-| `/data/storage/el2/base/files/hot-harness.log` | 运行日志 | 可写 |
-
----
-
-## 8. 性能模型
-
-| 阶段 | soft | hard |
-|------|------|------|
-| 文件检�?| <100ms / �?s | 同左 |
-| 防抖 (auto 模式) | 500ms | 500ms |
-| esbuild 打包 | 20~700ms | 同左 |
-| hdc file send | 1~2s | 1~2s |
-| touch trigger | <500ms | <500ms |
-| 设备检测触�?| <100ms / �?s | 同左 |
-| require.cache 失效 | <10ms | �?|
-| require(entry.js) | 500ms~2s | �?|
-| app.quit + 重启 | �?| 5~10s |
-| **总计** | **~3s** | **~15s** |
-
-手动模式下额外等待开发者按触发键的时间，不计入迭代耗时�?
----
-
-## 9. 恢复方式
-
-`eohr clean` 自动完成�?
-```
-eohr clean
-  ├─ 删除 hot-reload-agent.js
-  ├─ package.json main �?"main.js" (�?.eohr.config.json �?entry 推导)
-  ├─ 删除 .eohr.config.json
-  └─ 清空设备 override 目录 + 状态文�?```
-
-跑完后重�?HAP 即可。工程恢复到 `eohr init` 之前的状态，开发者的 `main.js` 从头到尾没被动过�?
----
-
-## 10. 文件清单
-
-| 文件 | 行数 | 职责 |
-|------|------|------|
-| `bin/eohr.js` | 116 | CLI 入口，参数解�?+ 命令分发 |
-| `src/utils.js` | 93 | 共享工具 (BOM/JSON5/hash/ANSI) |
-| `src/core/Config.js` | 159 | 配置管理，自动探�?|
-| `src/core/HdcBridge.js` | 133 | hdc 封装，三级查�?|
-| `src/core/Bundler.js` | 72 | esbuild 打包，external 策略 |
-| `src/core/FileWatcher.js` | 170 | fs.watch + 轮询兜底，防�?|
-| `src/core/StatusPoller.js` | 59 | 状态轮询，事件回调 |
-| `src/core/Dashboard.js` | 108 | 终端彩色输出 |
-| `src/commands/setup.js` | 155 | 自动配置快捷命令 (跨平�? |
-| `src/commands/init.js` | 76 | 新增 agent + �?package.json |
-| `src/commands/watch.js` | 248 | 热加载循�?+ 键盘交互 + 触发�?|
-| `src/commands/push.js` | 78 | 单次打包推�?|
-| `src/commands/status.js` | 50 | 设备状态查�?|
-| `src/commands/strategy.js` | 55 | 策略切换 |
-| `src/commands/clean.js` | 80 | 恢复工程 + 清空设备 |
-| `src/commands/log.js` | 30 | 查看设备日志 |
-| `templates/hot-reload-agent.js` | 157 | 设备�?agent |