electron-ohos-hotreload 1.0.2 → 1.0.4

package/README.md

@@ -4,10 +4,30 @@ Hot-reload CLI for Electron on HarmonyOS — push JS/TS changes to device withou
 
 ## Install
 
+**方式一：全局安装（推荐）**
+
 ```bash
 npm install -g electron-ohos-hotreload
+eohr --version    # 验证安装成功
 ```
 
+全局安装后 `eohr` 命令直接可用，无需其他配置。
+
+**方式二：本地安装（无法全局安装时）**
+
+从 [npmjs.com](https://www.npmjs.com/package/electron-ohos-hotreload) 下载 tgz 包，或从源码仓库克隆，放到你电脑上任意目录。
+
+```bash
+# 进入工具目录
+cd <你存放的路径>/electron-ohos-hotreload
+npm install
+
+# 配置快捷命令（自动检测终端类型，配置后 eohr 全局可用）
+node bin/eohr.js setup
+```
+
+重新打开终端后 `eohr` 命令可用。
+
 ## Quick Start
 
 ```bash
@@ -17,9 +37,11 @@ cd <你的路径>/ohos_hap
 # 2. 初始化（一次性）
 eohr init
 
+```bash
 # 3. 重建 HAP 并安装到设备（仅此一次）
+# 用 DevEco Studio 构建签名 HAP（推荐），或命令行：
 hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon
-hdc install <hap文件>
+hdc install electron/build/default/outputs/default/electron-default-signed.hap
 
 # 4. 启动热加载
 eohr watch
@@ -47,6 +69,7 @@ eohr watch
 | `eohr strategy` | 查看/切换策略 |
 | `eohr log` | 查看设备日志 |
 | `eohr clean` | 恢复工程 + 清空设备 |
+| `eohr setup` | 配置快捷命令（仅本地安装需要） |
 
 ## Reload Strategy
 
@@ -56,7 +79,8 @@ eohr watch
 
 - [快速上手](docs/quick-start.md)
 - [用户使用手册](docs/user-manual.md)
-- [设计手册](docs/design-manual.md)
+
+> 以上链接在 GitHub 等代码托管平台可点击查看。npm 仓库页面不支持链接跳转，请安装后查看本地 `node_modules/electron-ohos-hotreload/docs/` 目录，或运行 `eohr --help`。
 
 ## License
 

package/bin/eohr.js

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

package/docs/quick-start.md

@@ -6,16 +6,34 @@
 
 ## 怎么用
 
-### 第一次（只做一次）
+### 安装工具
+
+**方式一：全局安装（推荐）**
+
+```bash
+npm install -g electron-ohos-hotreload
+eohr --version    # 验证安装成功
+```
+
+**方式二：本地安装（无法全局安装时）**
+
+从 [npmjs.com](https://www.npmjs.com/package/electron-ohos-hotreload) 下载 tgz 包，或从源码仓库克隆，放到你电脑上任意目录。
 
 ```bash
-# 1. 安装工具
-cd <eohr路径>/electron-ohos-hotreload
+cd <你存放的路径>/electron-ohos-hotreload
 npm install
-node bin/eohr.js setup    # 自动配置快捷命令
+node bin/eohr.js setup    # 配置快捷命令，配置后重新打开终端
+```
+
+安装完成后执行 `eohr --version` 验证。
+
+### 第一次初始化（只做一次）
 
-# 2. 重新打开终端，初始化工程
+```bash
+# 1. 进入你的 ohos_hap 工程目录
 cd <你的路径>/ohos_hap
+
+# 2. 初始化工程
 eohr init
 ```
 
@@ -26,8 +44,10 @@ eohr init
 你的 `main.js` 不碰，原封不动。用完了执行 `eohr clean` 这两个改动自动还原。
 
 ```bash
+# 3. 重建 HAP 并安装到设备
+# 用 DevEco Studio 构建签名 HAP（推荐），或命令行：
 hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon
-hdc install <hap文件>
+hdc install electron/build/default/outputs/default/electron-default-signed.hap
 ```
 
 ### 日常开发（每次都用这个）
@@ -36,7 +56,7 @@ hdc install <hap文件>
 eohr watch
 ```
 
-然后正常写代码。改完保存，切到终端按 `Ctrl+Shift+X`，1~15 秒设备上就生效了。
+然后正常写代码。改完保存，切到终端按 `Ctrl+Shift+X`，十几秒设备上就生效了。
 
 ## 效果
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electron-ohos-hotreload",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Hot-reload CLI for Electron on HarmonyOS — push JS/TS changes to device without rebuilding HAP",
   "bin": {
     "eohr": "bin/eohr.js"