hmdev-cli 1.0.2 → 1.0.4

package/README.md

@@ -100,6 +100,20 @@ hmdev-cli build --project ./MyApp && hmdev-cli deploy --start --bundle com.examp
 hmdev-cli connect 192.168.1.100:41015 && hmdev-cli deploy --start --bundle com.example.app
 ```
 
+## AI 技能 (Skill)
+
+hmdev-cli 提供配套的 AI 技能，让 Claude 等 AI 助手直接学会使用该工具：
+
+```bash
+# 技能文件位于项目 hmdev-cli-skill/ 目录
+hmdev-cli-skill/
+├── SKILL.md       # 技能描述与使用指南
+├── scripts/       # 预留：自动化脚本
+└── references/    # 预留：参考文档
+```
+
+AI 加载该技能后，能自动完成文档查询、构建、部署等操作。
+
 ## 命令参考
 
 | 命令 | 说明 |
@@ -140,13 +154,11 @@ npm install -g hmdev-cli
 ## 开发
 
 ```bash
-git clone https://github.com/Johnson1662/huawei-docs-mcp.git
-cd huawei-docs-mcp
+git clone https://github.com/Johnson1662/hmdev-cli.git
+cd hmdev-cli
 
-# 安装依赖（自动创建 venv）
 npm install
 
-# 本地测试
 node bin/hmdev-cli.js index
 node bin/hmdev-cli.js search ArkUI
 node bin/hmdev-cli.js build --project /path/to/harmonyos-project

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hmdev-cli",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "HarmonyOS 开发 CLI 工具 — 文档查询、项目构建、设备部署",
   "keywords": [
     "harmonyos",
@@ -11,15 +11,15 @@
     "hdc",
     "huawei"
   ],
-  "homepage": "https://github.com/Johnson1662/huawei-docs-mcp#readme",
+  "homepage": "https://github.com/Johnson1662/hmdev-cli#readme",
   "bugs": {
-    "url": "https://github.com/Johnson1662/huawei-docs-mcp/issues"
+    "url": "https://github.com/Johnson1662/hmdev-cli/issues"
   },
   "license": "MIT",
   "author": "Johnson1662",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Johnson1662/huawei-docs-mcp.git"
+    "url": "git+https://github.com/Johnson1662/hmdev-cli.git"
   },
   "bin": {
     "hmdev-cli": "bin/hmdev-cli.js"

package/python/builder.py

@@ -193,6 +193,10 @@ class HDCTool:
             )
         return subprocess.run([self._hdc_path] + args, capture_output=True, text=True, timeout=timeout)
 
+    @staticmethod
+    def succeeded(result: subprocess.CompletedProcess) -> bool:
+        return result.returncode == 0 and "[Fail]" not in result.stdout and "[Fail]" not in result.stderr
+
     def list_devices(self) -> list[dict]:
         result = self._run(["list", "targets"])
         devices = []
@@ -221,5 +225,5 @@ class HDCTool:
         args.extend(["shell", "aa", "start", "-a", ability, "-b", bundle])
         return self._run(args, timeout=30)
 
-    def connect_wireless(self, ip_port: str, timeout: int = 10) -> subprocess.CompletedProcess:
+    def connect_wireless(self, ip_port: str, timeout: int = 30) -> subprocess.CompletedProcess:
         return self._run(["tconn", ip_port], timeout=timeout)

package/python/cli.py

@@ -16,6 +16,8 @@ Usage:
 import asyncio
 import json
 import re
+import shutil
+import subprocess
 import subprocess
 import time
 from argparse import ArgumentParser, RawDescriptionHelpFormatter, SUPPRESS
@@ -477,7 +479,7 @@ async def cmd_deploy(args):
     if args.tconn:
         print(f"[hmdev] 无线连接: {args.tconn}")
         tr = hdc.connect_wireless(args.tconn)
-        if tr.returncode != 0:
+        if not HDCTool.succeeded(tr):
             print(f"[hmdev] ❌ 无线连接失败: {tr.stderr.strip()}")
             return
         print(f"[hmdev] ✅ 无线连接成功")
@@ -493,7 +495,7 @@ async def cmd_deploy(args):
 
     print(f"[hmdev] 正在安装: {hap_path}")
     ir = hdc.install_hap(hap_path, device_id)
-    if ir.returncode != 0:
+    if not HDCTool.succeeded(ir):
         err = ir.stderr.strip() or ir.stdout.strip()
         print(f"[hmdev] ❌ 安装失败: {err}")
         return
@@ -507,7 +509,7 @@ async def cmd_deploy(args):
         else:
             print(f"[hmdev] 正在启动: {bundle}")
             sr = hdc.start_app(bundle, args.ability, device_id)
-            if sr.returncode != 0:
+            if not HDCTool.succeeded(sr):
                 print(f"[hmdev] ❌ 启动失败: {sr.stderr.strip()}")
             else:
                 print(f"[hmdev] ✅ 应用已启动")
@@ -668,6 +670,20 @@ async def cmd_config(args):
         print()
 
 
+async def cmd_update(args):
+    npm = shutil.which("npm") or shutil.which("npm.cmd")
+    if not npm:
+        print("[hmdev] ❌ 未找到 npm。请确保 Node.js 已安装。")
+        return
+    print("[hmdev] 正在更新 hmdev-cli ...")
+    result = subprocess.run([npm, "update", "-g", "hmdev-cli"], capture_output=True, text=True)
+    if result.returncode == 0:
+        print("[hmdev] ✅ 更新成功")
+    else:
+        err = result.stderr.strip() or result.stdout.strip()
+        print(f"[hmdev] ❌ 更新失败: {err}")
+
+
 # ── CLI Registration ──────────────────────────────────────────────────────────
 
 CLI_COMMANDS = {
@@ -682,6 +698,7 @@ CLI_COMMANDS = {
     "run": cmd_run,
     "connect": cmd_connect,
     "config": cmd_config,
+    "update": cmd_update,
 }
 
 
@@ -765,6 +782,10 @@ def build_cli_parser():
     p.add_argument("--reset", metavar="KEY", help="重置配置项")
     p.add_argument("--json", action="store_true", dest="json", help=SUPPRESS)
 
+    # update
+    p = sub.add_parser("update", help="更新 hmdev-cli 到最新版本 (npm update -g)")
+    p.add_argument("--json", action="store_true", dest="json", help=SUPPRESS)
+
     return parser