@deveco-codegenie/mcp-win32-x64 0.1.8-fix2 → 0.1.8-fix4

package/README.md

@@ -12,12 +12,14 @@
 - [主要功能](#主要功能)
   - [ArkTS 代码检查](#1-arkts-代码检查-check_ets_files)
   - [构建 HAP/HSP/HAR](#2-构建-haphsphar-build_project)
-  - [启动应用](#3-启动应用-start_app仅-windows--macos)
-  - [UI 树获取](#4-ui-树获取-get_app_ui_treewindows--macos)
-  - [UI 操作](#5-ui-操作-perform_ui_actionwindows--macos)
-  - [UI 自动化校验](#6-ui-自动化校验-verify_ui--get_ui_verification_log--save_ui_screenshot仅-windows--macos)
-  - [HiLog 日志采集](#7-hilog-日志采集windows--macos)
-  - [HarmonyOS 知识库搜索](#8-harmonyos-知识库搜索-harmonyos_knowledge_searchwindows--macos)
+  - [启动应用](#3-启动应用-start_app-仅-windows--macos)
+  - [UI 树获取](#4-ui-树获取-get_app_ui_tree-windows--macos)
+  - [UI 操作](#5-ui-操作-perform_ui_action-windows--macos)
+  - [HiLog 日志采集](#6-hilog-日志采集-windows--macos)
+  - [HarmonyOS 知识库搜索](#7-harmonyos-知识库搜索-harmonyos_knowledge_search-windows--macos)
+  - [UI 自动化校验](#8-ui-自动化校验-verify_ui-仅-windows--macos)
+  - [项目同步](#9-项目同步-project_sync)
+  - [初始化工程路径](#10-初始化工程路径-init_project_path)
 - [平台支持](#平台支持)
 
 ---
@@ -84,7 +86,7 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 ## 主要功能
 
-### 1. ArkTS 代码检查（`check_ets_files`）
+### 1. ArkTS 代码检查 check_ets_files
 
 对指定的 `.ets` / `.ts` 文件执行静态诊断，返回语法错误、类型错误等诊断信息。
 
@@ -94,13 +96,13 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 | 参数 | 类型 | 说明 |
 |------|------|------|
-| `files` | `string[]` | 待检查的 ETS 文件路径列表 |
+| `files` | `string[]` | 待检查 ETS 文件路径列表 |
 
 **实现原理：** 服务内嵌 arkts-lang-server JS 脚本，通过 Node.js 启动 LSP 代理进程，以 LSP 协议与 ArkTS 语言服务通信，收集诊断结果后返回。
 
 ---
 
-### 2. 构建 HAP/HSP/HAR（`build_project`）
+### 2. 构建 HAP/HSP/HAR build_project
 
 调用 Hvigor 构建系统对 HarmonyOS 项目进行编译打包。
 
@@ -128,7 +130,7 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 ---
 
-### 3. 启动应用（`start_app`）（仅 Windows / macOS）
+### 3. 启动应用 start_app (仅 Windows / macOS)
 
 在连接的真机或模拟器上安装并启动 HarmonyOS 应用。
 
@@ -147,7 +149,7 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 ---
 
-### 4. UI 树获取（`get_app_ui_tree`）（Windows / macOS）
+### 4. UI 树获取 get_app_ui_tree (Windows / macOS)
 
 抓取设备当前界面的 UI 树信息，保存为 JSON 文件。
 
@@ -163,7 +165,7 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 ---
 
-### 5. UI 操作（`perform_ui_action`）（Windows / macOS）
+### 5. UI 操作 perform_ui_action (Windows / macOS)
 
 对设备屏幕执行模拟操作。
 
@@ -181,7 +183,7 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 ---
 
-### 6. HiLog 日志采集（Windows / macOS）
+### 6. HiLog 日志采集 (Windows / macOS)
 
 从真机或模拟器实时采集 HiLog 系统日志（或崩溃日志）。
 
@@ -196,11 +198,10 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 | `domain` | 日志领域（如 `0xD002800`） |
 | `bundleName` | 应用包名（自动获取 PID 过滤） |
 | `keyword` | 关键字正则过滤（与 `tag` 互斥） |
-| `logSize` | 日志缓冲区大小，范围 64K–16M，默认 4M |
 
 ---
 
-### 7. HarmonyOS 知识库搜索（`harmonyos_knowledge_search`）（Windows / macOS）
+### 7. HarmonyOS 知识库搜索 harmonyos_knowledge_search (Windows / macOS)
 
 调用云端知识库，搜索 HarmonyOS 开发文档。
 
@@ -217,7 +218,7 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 ---
 
-### 8. UI 自动化校验（`verify_ui` / `get_ui_verification_log` / `save_ui_screenshot`）（仅 Windows / macOS）
+### 8. UI 自动化校验 verify_ui (仅 Windows / macOS)
 
 > **注意**：此功能属于额外工具组，需设置环境变量 `ADDITIONAL_TOOL_GROUPS=ui_integration_test` 才能开启。
 
@@ -301,6 +302,36 @@ $env:DEVECO_PATH = "C:\Program Files\Huawei\DevEco Studio"
 
 ---
 
+### 9. 项目同步 project_sync
+
+执行项目同步。包含 ohpm install 依赖安装和 hvigor 工程同步。通常在项目初始化或修改依赖配置后使用。
+
+**工具名称：** `project_sync`
+
+**参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `product` | `string` | 否 | 指定的 Product 名称。如果不传，默认为 'default'。 |
+| `skip_ohpm_install` | `boolean` | 否 | 是否跳过 ohpm install。若环境中已安装依赖或遇到文件锁冲突,可设为 true。 |
+| `log_path` | `string` | 否 | sync 日志保存路径：若指定，则将所有的同步日志保存到该路径下。 |
+
+---
+
+### 10. 初始化工程路径 init_project_path
+
+当依赖工程路径的工具（如 ArkTS 代码检查、构建、sync等）因未配置工程路径而执行失败时，调用此工具来初始化或更新工程根目录路径。
+
+**工具名称：** `init_project_path`
+
+**参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `project_path` | `string` | 是 | 工程根目录的绝对路径 |
+
+---
+
 **最佳实践：**
 
 在 AI 助手中配置好 MCP 后，建议在测试过程中加入以下指引，让 AI 自动串联完整开发测试流程：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deveco-codegenie/mcp-win32-x64",
-  "version": "0.1.8-fix2",
+  "version": "0.1.8-fix4",
   "description": "@deveco-codegenie/mcp win32 binary",
   "os": [
     "win32"