@honor-claw/yoyo 1.4.0-beta.4 → 1.4.0-beta.5

package/dist/utils/version.mjs

@@ -1,7 +1,7 @@
 //#region src/utils/version.ts
 var e = null;
 function t() {
-	return e === null && (e = "1.4.0-beta.4".includes("beta") || "1.4.0-beta.4".includes("alpha")), !!e;
+	return e === null && (e = "1.4.0-beta.5".includes("beta") || "1.4.0-beta.5".includes("alpha")), !!e;
 }
 //#endregion
 export { t as isBetaVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "1.4.0-beta.4",
+  "version": "1.4.0-beta.5",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",

package/skills/yoyo-control/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: yoyo_phone_control
 description: >
-  通过 YOYO 控制手机系统功能（应用管理、通话短信、闹钟日程、设备设置等）。
+  通过YOYO操作手机系统用机功能，包括打开/关闭/卸载应用、发送/查找短信、拨打电话、搜索联系人、搜索通话记录、创建/打开/查询/关闭/删除闹钟、创建/添加/新建日程、计时器管理、录音、截屏、屏幕录制、调节音量、屏幕亮度调节、切换响铃/静音/勿扰/护眼/深色/飞行模式、管理移动数据或热点或蓝牙或WLAN、进行本地内容搜索、文件发送、调用相机拍照/录像、电池状态/电量查询与、开启/关闭定位服务、开启/关闭NFC功能、开启/关闭自动亮屏功能、USB共享网络、设备电源状态与屏幕状态控制、状态栏显示信息管理与控制、进行扫码操作、控制手机的手电筒、清理和维护设备扬声器、机票监控、查快递等。
+  支持与手机系统用机交互的相关操作。
 metadata: { "openclaw": { "emoji": "📱", "always": true } }
 ---
 
@@ -36,6 +37,7 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
 - 如果执行失败，必须重新读取 `SKILL.md` 和对应的工具定义文件，然后重新执行
 - 绝对不能使用任何其他设备的工具
 - 不要尝试任何其他方式完成任务，不要提供替代方案
+- **Never try a different approach**
 
 ## 步骤 1：确定目标设备
 
@@ -134,6 +136,8 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
 | `flight-monitor`      | `references/flight-monitor-create.md`    | 创建机票价格监控                     |
 | `flight-monitor`      | `references/flight-monitor-search.md`    | 查询机票监控任务                     |
 | `express`             | `references/express-logistics-search.md` | 快递查询                             |
+| `countdown-timer`     | `references/countdown-timer.md`          | 倒计时计时器管理                      |
+| `desktop`             | `references/desktop.md`                  | 手机桌面管理，支持查询桌面布局、打开桌面设置页，并对风格、应用角标、桌面图标、快捷方式、搜索入口、应用名称、通透模式与布局等进行配置。 |
 
 ### 2.3 MCP 工具查找流程
 
@@ -143,12 +147,12 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
 | ------- | ------- | --------------- |
 {{full-mcp-tool-list}}
 
-**每行只对应一个设备ID。只有当该行的支持设备ID等于当前设备ID时，该工具才可被调用。**
+**当工具支持的设备ID列表中包含当前设备ID时，该工具才可被调用。**
 
 [MANDATORY] **必须强制执行**：
-1. 在执行工具调用之前，**必须**严格匹配当前 nodeID 是否等于某一行的 `支持的设备ID`，如果不等于则告诉用户。
-2. 如果当前 nodeID 等于某一行的 `支持的设备ID`，则**必须**从`mcptools/<tool_name>.json`中读取详细的工具定义。
-3. 如果当前 nodeID 不等于任意匹配工具行的 `支持的设备ID`，则**必须**严格回复 "无工具可用"。
+1. 在执行工具调用之前，**必须**严格匹配当前 nodeID 是否在 `支持的设备ID列表` 中，如果不在则告诉用户。
+2. 如果当前 nodeID 在 `支持的设备ID列表` 中，则**必须**从`mcptools/<tool_name>.json`中读取详细的工具定义。
+3. 如果当前 nodeID 不在 `支持的设备ID列表` 中，则**必须立即执行**严格回复 "❌ <设备名称> 不支持该操作"。
 
 **读取工具定义**：使用`read`工具读取`mcptools/<tool_name>.json`文件。
 
@@ -167,7 +171,7 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
 
 ## 步骤 4：执行调用
 
-### 命令格式
+### 4.1 命令格式
 
 根据操作系统选择对应格式：
 
@@ -178,27 +182,28 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
 - Windows (Cmd): `cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"<tool_name>\",\"appPkg\":\"<pkgName>\",\"arguments\":<json-string>}"'`
 - Linux/macOS (Bash): `openclaw nodes invoke --node <IP> --command mcp.tool.call --params '{"name":"<tool_name>","appPkg":"<pkgName>","arguments":<json-string>}'`
 
-### 执行前校验
+### 4.2 执行前校验
 
 按顺序完成以下校验，任一失败则停止执行：
 
-1. **节点标识** — 从 `nodes status` 输出中提取 IP 或 ID
-2. **工具是否支持** — 如果是 `MCP工具`，必须严格校验某一行的 `支持的设备ID` 是否等于当前节点标识 node 或 nodeID
+1. **节点标识** — 从 `nodes status --json` 输出中提取 IP 或 ID
+2. **工具是否支持** — 如果是 `MCP工具`，必须严格校验 `支持的设备ID列表` 中是否包含当前节点标识 node 或 nodeID
 3. **工具文档** — 确认已读取对应的 `references/*.md` 或 `mcptools/*.json`
 4. **命令名称** — 从文档中精确提取 command
 5. **必填参数** — 从文档中提取并校验所有必填字段
+6. **格式检验** - 严格按照4.1中定义的命令格式，**必须正确使用双引号、单引号和反斜杠转义字符**
 
-### 错误处理与重试
+### 4.3 错误处理与重试
 
 最大重试次数：3 次，每次间隔 1 秒。
 
-| 错误类型                   | 处理方式                                | 可重试          |
-| -------------------------- | --------------------------------------- | --------------- |
-| 参数无效                   | 校验参数后修正重试                      | 是（最多 3 次） |
-| 连接错误 / 超时 / 临时故障 | 等待后重试                              | 是（最多 3 次） |
-| 节点离线                   | 重新执行 `nodes status` 确认            | 否              |
-| 权限拒绝                   | 检查 `gateway.nodes.allowCommands` 配置 | 否              |
-| 节点不支持该能力           | 重新执行读取 `SKILL.md` 确认            | 是（最多 1 次） |
+| 错误类型                   | 处理方式                                 | 可重试          |
+| -------------------------- | --------------------------------------  | -------------- |
+| 参数无效                   | 校验参数后修正重试                        | 是（最多 3 次） |
+| 连接错误 / 超时 / 临时故障  | 等待后重试                                | 是（最多 3 次） |
+| 节点离线                   | 重新执行 `nodes status --json` 确认       | 否             |
+| 权限拒绝                   | 检查 `gateway.nodes.allowCommands` 配置  | 否             |
+| 节点不支持该能力            | 重新执行读取 `SKILL.md` 确认              | 是（最多 1 次） |
 
 如果发送错误**必须强制执行**重新读取 `SKILL.md` 和 对应的工具定义文件，并重新执行。
 3 次重试均失败后，停止重试，向用户报告错误诊断并建议手动处理。
@@ -213,8 +218,13 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
 
 - 示例：`❌ Honor Magic6 离线，请检查设备连接后重试`
 
+**设备ID不匹配时**：说明设备不支持该操作，严禁输出设备ID。
+
+- 示例：`❌ Honor Magic6 不支持该操作`
+
 **原则**：
 
 - 始终包含设备名称
 - 不暴露原始错误码
+- **严禁使用行内代码块**，严禁使用 \`任何文本内容\` 标签。
 - 失败时必须提供下一步建议

package/skills/yoyo-control/references/countdown-timer.md

@@ -0,0 +1,393 @@
+---
+name: countdown_timer_management
+description: >
+  倒计时计时器管理工具集，支持创建、查询、暂停、恢复、重启和取消倒计时。
+  核心逻辑遵循“先查后操”原则：对于非创建类操作，若用户未提供明确ID，需先调用查询工具获取列表；
+  若匹配唯一则自动执行，若存在歧义则请求用户澄清。
+---
+
+# Countdown Timer Management 倒计时计时器管理
+
+## Tool Provider
+```bash
+com.hihonor.deskclock
+```
+
+## Tool Command
+
+本 Skill 包含一组原子化工具，根据用户意图动态选择调用。主要命令入口如下：
+
+```bash
+# 创建计时器
+createTimer --totalTime <毫秒> [--timerName <名称>]
+
+# 查询计时器状态（用于前置检查或独立查询）
+queryTimer [--timerName <名称>] [--timerState <状态>] [--totalTime <毫秒>]
+
+# 暂停计时器
+pauseTimer [--timerIdList <ID数组-string>]
+
+# 恢复/继续计时器
+resumeTimer [--timerIdList <ID数组-string>]
+
+# 重启计时器
+restartTimer [--timerIdList <ID数组-string>]
+
+# 取消计时器
+cancelTimer [--timerIdList <ID数组-string>]
+```
+*(注意：timerIdList 接受字符串类型的参数，例如：[1,2,3]需要转义成 \"[1,2,3]\")*
+
+## 集成工作流
+
+在处理用户请求时，必须严格遵循以下编排逻辑，特别是针对**非创建类**的操作（暂停、恢复、重启、取消）。
+
+### Step 1: 意图解析与参数组装
+
+1.  **识别意图**：判断用户是想要“创建”新计时器，还是对“现有”计时器进行操作（查、停、恢、重、消）。
+2.  **创建类意图**：
+    *   提取 `totalTime`（必填，单位毫秒）和 `timerName`（选填，需润色为简洁语句）。
+    *   直接调用 `createTimer`。
+3.  **操作类意图**（暂停/恢复/重启/取消）：
+    *   **检查参数**：用户是否提供了明确的 `timerIdList`？
+        *   **是**：直接调用对应操作工具。
+        *   **否**：进入“模糊匹配流程”。
+4.  **模糊匹配流程**：
+    *   调用 `queryTimer` 获取当前所有相关计时器列表。
+    *   根据用户提供的名称（如“煮蛋”）或状态进行过滤。
+    *   **判断匹配结果**：
+        *   **无匹配**：返回提示“未找到相关计时器”。
+        *   **唯一匹配**：自动提取该计时器的 ID，组装参数，**无需二次确认**，直接调用对应操作工具。
+        *   **多重匹配/歧义**：将匹配到的计时器以 **Markdown 表格** 形式展示给用户，并提示用户明确指定（例如：“找到多个‘健身’计时器，请指定是哪一个？”）。
+
+### Step 2: 执行调用与结果处理
+
+1.  执行最终确定的工具调用。
+2.  解析返回结果中的 `clkRetCode`：
+    *   **成功**：提取成功提示语及最新的计时器列表信息（ID, Name, State），向用户反馈执行结果。
+    *   **失败**：提取 `errorMsg` 并向用户报错。
+
+### Step 3: 组装openclaw nodes invoke命令
+
+**Windows（cmd）执行命令**：
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"<工具名>\",\"appPkg\":\"com.hihonor.deskclock\",\"arguments\":<JSON参数>}"'
+```
+
+**Linux（bash）执行命令**：
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"<工具名>","appPkg":"com.hihonor.deskclock","arguments":<JSON参数>}"
+```
+
+
+### ASCII 流程图
+
+```ascii
+Start
+  |
+  +-- [意图识别]
+  |     |
+  |     +-- 创建计时器? --> 提取 totalTime, timerName --> Call createTimer --> End
+  |     |
+  |     +-- 操作现有计时器? (暂停/恢复/重启/取消)
+  |           |
+  |           +-- 用户提供了明确 ID?
+  |           |     |
+  |           |     +-- Yes --> Call Target Tool with timerIdList --> End
+  |           |     |
+  |           |     +-- No  --> Call queryTimer (Query)
+  |           |                 |
+  |           |                 +-- 解析返回列表
+  |           |                       |
+  |           |                       +-- 无匹配? --> 回复"未找到" --> End
+  |           |                       |
+  |           |                       +-- 唯一匹配? --> 自动提取 ID --> Call Target Tool --> End
+  |           |                       |
+  |           |                       +-- 多重匹配? --> 展示 Markdown 表格 --> 请求用户澄清 --> Wait for Input
+  |
+End
+```
+
+## 参数定义
+
+以下是各工具的核心参数定义，严格按照参数定义与说明进行槽位提取。
+
+### 1. 创建计时器 (`createTimer`)
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "totalTime": {
+      "type": "integer",
+      "description": "倒计时总时长（必填），单位为毫秒。需要将用户表达的时间统一换算为毫秒，例如：1分钟=60000，5分钟=300000，1小时=3600000。",
+      "required": true
+    },
+    "timerName": {
+      "type": "string",
+      "description": "计时器名称。选填，当用户明确说明名称时从query中提取。若无特殊要求，应根据用户Query润色为简洁语句（如'健身'而非'我要开始健身了'）。",
+      "required": false
+    }
+  }
+}
+```
+
+### 2. 查询计时器 (`queryTimer`)
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "totalTime": {
+      "type": "integer",
+      "description": "表示需要匹配的计时器总时长，非必填。仅当用户明确提到计时器时长时填写；如果用户未提及时长，则不填写。填写值需转换为毫秒整数，例如用户说1分钟时填写60000。"
+    },
+    "timerName": {
+      "type": "string",
+      "description": "表示用户指定的倒计时名称，非必填。仅当用户明确提到计时器名称时填写；如果用户未提及具体名称，则不填写。填写内容应与用户输入中的名称原文保持一致，不做改写或归一化。"
+    },
+    "timerState": {
+      "type": "string",
+      "description": "表示用户希望筛选的计时器状态，非必填。仅当用户明确指定计时器状态时填写；未指定时不填写。枚举值说明如下：暂停：计时器已开始但当前处于暂停状态，适用于用户查询已暂停的计时器；运行中：计时器当前正在倒计时，适用于用户查询正在运行的计时器；响铃：计时器已结束并正在响铃，适用于用户查询已到时的计时器。填写时仅可从上述枚举值中选择与用户原意一致的一项。",
+      "enum": [
+        "暂停",
+        "运行中",
+        "响铃"
+      ]
+    }
+  }
+}
+```
+
+### 3. 操作类工具 (`pauseTimer`, `resumeTimer`, `restartTimer`, `cancelTimer`)
+
+这些工具共享相似的参数结构，核心在于 `timerIdList`。
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "timerIdList": {
+      "type": "string",
+      "description": "必填参数，需要操作的计时器ID列表，输入为整数数组的字符串形式，例如[5,3]。若用户未指定且上下文无法唯一确定，要求用户补充说明，需遵循'先查后操'的工作流逻辑。"
+    }
+  }
+}
+```
+
+**参数注意事项：**
+*   **单位统一**：`totalTime` 始终为**毫秒**。例如：5分钟 = 300,000 ms。
+*   **ID 依赖性**：除创建外，其他操作强烈依赖准确的 `timerId`。严禁在未查询的情况下猜测 ID。
+*   **默认行为**：若用户说“暂停计时器”但未指定哪个，且当前只有一个运行中的计时器，系统应能智能推断；若有多个，必须通过查询流程让用户选择。
+
+### 4. 返回参数说明
+所有倒计时工具的返回参数定义如下：
+```json
+{
+  "clkRetCode": {
+    "type": "integer",
+    "description": "时钟服务调用结果码，用于表示接口执行结果。1表示调用成功；0表示未知错误；负数表示调用失败。-20002 表示计时器ID不存在，其余值表示其他计时器错误场景。"
+  },
+  "errorMsg": {
+    "type": "string",
+    "description": "错误信息描述。当 clkRetCode 不为 1 时返回具体错误原因；当 clkRetCode 为 1 时返回 \"Success\"。"
+  },
+  "extraBody": {
+    "type": "array",
+    "description": "本次操作后返回的计时器最新完整状态列表。每个元素表示一个计时器对象，包含计时器运行状态、剩余时间以及相关配置字段，用于客户端更新本地计时器数据。",
+    "items": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "description": "计时器唯一标识ID"
+        },
+        "timerName": {
+          "type": "string",
+          "description": "计时器名称，如果用户未自定义则使用系统默认名称（如1分钟、10分钟）"
+        },
+        "totalTime": {
+          "type": "integer",
+          "description": "计时器总时长，单位毫秒"
+        },
+        "timerState": {
+          "type": "integer",
+          "description": "计时器状态：0初始状态，1运行中，2暂停，3倒计时已到时间处于超时状态，4已停止"
+        },
+        "startTime": {
+          "type": "integer",
+          "description": "计时器开始时间戳，单位毫秒"
+        },
+        "stopTime": {
+          "type": "integer",
+          "description": "计时器停止时间戳，单位毫秒"
+        },
+        "remainingTime": {
+          "type": "integer",
+          "description": "计时器剩余时间，单位毫秒，暂停时记录用于恢复计时"
+        }
+      }
+    }
+  }
+}
+```
+
+
+## Query 示例及输出
+
+### 示例 1：创建计时器
+
+**用户输入**：
+> “帮我设一个10分钟的煮蛋计时器”
+
+**JSON 参数**：
+```json
+{
+  "totalTime": 600000,
+  "timerName": "煮蛋"
+}
+```
+**Windows（cmd）执行命令**：
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"createTimer\",\"appPkg\":\"com.hihonor.deskclock\",\"arguments\":{\"totalTime\":600000,\"timerName\":\"煮蛋\"}}"'
+```
+**Linux（bash）执行命令**：
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"createTimer","appPkg":"com.hihonor.deskclock","arguments":{"totalTime":600000,"timerName":"煮蛋"}}'
+```
+
+**预期输出逻辑**：
+检查 `clkRetCode`，若成功，返回：“已创建‘煮蛋’计时器，时长10分钟。”
+
+---
+
+### 示例 2：模糊匹配后自动执行（唯一匹配）
+
+**用户输入**：
+> “暂停煮蛋的计时器”
+*(假设系统中只有一个名为“煮蛋”的计时器，ID为 1)*
+
+**Step 1: 内部调用查询**
+**Windows（cmd）执行命令**：
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"queryTimer\",\"appPkg\":\"com.hihonor.deskclock\",\"arguments\":{\"timerName\":\"煮蛋\"}}"'
+```
+**Linux（bash）执行命令**：
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"queryTimer","appPkg":"com.hihonor.deskclock","arguments":{"timerName":"煮蛋"}}'
+```
+
+*查询返回*：`[{ "timerId": 1, "timerName": "煮蛋", "timerState": "running" }]`
+
+**Step 2: 逻辑判断**
+匹配结果为唯一项 (ID: 1)。
+
+**Step 3: 执行操作**
+**JSON 参数**：
+```json
+{
+  "timerIdList": "[1]"
+}
+```
+**Windows（cmd）执行命令**：
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"pauseTimer\",\"appPkg\":\"com.hihonor.deskclock\",\"arguments\":{\"timerIdList\":\"[1]\"}}"'
+```
+**Linux（bash）执行命令**：
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"pauseTimer","appPkg":"com.hihonor.deskclock","arguments":{"timerIdList":"[1]"}}'
+```
+
+**预期输出逻辑**：
+返回：“已暂停‘煮蛋’计时器。”
+
+---
+
+### 示例 3：模糊匹配需用户澄清（多重匹配）
+
+**用户输入**：
+> “恢复健身计时器”
+*(假设系统中有两个名为“健身”的计时器，ID分别为 10 和 12)*
+
+**Step 1: 内部调用查询**
+**Windows（cmd）执行命令**：
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"queryTimer\",\"appPkg\":\"com.hihonor.deskclock\",\"arguments\":{\"timerName\":\"健身\"}}"'
+```
+**Linux（bash）执行命令**：
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"queryTimer","appPkg":"com.hihonor.deskclock","arguments":{"timerName":"健身"}}'
+```
+
+*查询返回*：
+```json
+[
+  { "timerId": 10, "timerName": "健身", "timerState": "paused" },
+  { "timerId": 12, "timerName": "健身-有氧", "timerState": "paused" }
+]
+```
+
+**Step 2: 逻辑判断**
+匹配结果为多项，存在歧义。
+
+**Step 3: 用户交互（不立即执行操作工具）**
+**系统回复**：
+> 找到以下 2 个“健身”计时器，请指定要恢复哪一个：
+>
+> | 序号 | ID | 名称 | 状态 |
+> | :--- | :--- | :--- | :--- |
+> | 1 | 10 | 健身 | 暂停 |
+> | 2 | 12 | 健身 | 暂停 |
+
+*(等待用户进一步指令，如“恢复第一个”)*
+
+---
+
+### 示例 4：明确 ID 操作
+
+**用户输入**：
+> “重启第1个和第2个倒计时”
+*(假设用户已知或通过上文得知 ID 为 10 和 12)*
+
+**JSON 参数**：
+```json
+{
+  "timerIdList": "[10, 12]"
+}
+```
+**Windows（cmd）执行命令**：
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"pauseTimer\",\"appPkg\":\"com.hihonor.deskclock\",\"arguments\":{\"timerIdList\":\"[10,12]\"}}"'
+```
+**Linux（bash）执行命令**：
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"pauseTimer","appPkg":"com.hihonor.deskclock","arguments":{"timerIdList":"[10,12]"}}'
+```
+
+**预期输出逻辑**：
+返回：“已重启 ID 为 10 和 12 的计时器。”
+
+---
+
+### 示例 5：查询计时器状态
+
+**用户输入**：
+> “看看现在有哪些计时器在跑”
+
+**JSON 参数**：
+```json
+{
+  "timerState": "running",
+}
+```
+**Windows（cmd）执行命令**：
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"queryTimer\",\"appPkg\":\"com.hihonor.deskclock\",\"arguments\":{\"timerState\":\"running\"}}"'
+```
+**Linux（bash）执行命令**：
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"queryTimer","appPkg":"com.hihonor.deskclock","arguments":{"timerState":"running"}}'
+```
+
+**预期输出逻辑**：
+返回 Markdown 表格展示所有计时器的 ID、名称、剩余时间和状态。

package/skills/yoyo-control/references/desktop.md

@@ -0,0 +1,196 @@
+---
+name: desktop
+description: >
+  桌面管理与配置工具。支持查询桌面布局、打开桌面设置页，并对风格、角标、图标、
+  快捷方式、搜索入口、应用名称、通透模式与布局等进行配置，按 actionType 执行操作。
+---
+
+# Desktop 桌面管理
+
+## Tool Provider
+```bash
+com.hihonor.magicvoice
+```
+
+## Tool Command
+```bash
+desktop
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                          │
+│  - 识别操作类型: 打开/关闭/设置/查询/添加/调大/调小/设值      │
+│  - 识别操作对象: 桌面/风格/角标/图标/快捷方式/搜索入口/       │
+│    桌面应用名称/通透模式/布局                                │
+│  - 提取风格类型: 标准/抽屉                                   │
+│  - 提取角标类型: 数字/圆点                                   │
+│  - 提取数值信息: 数字/百分比/分数/极值/布局规格              │
+│  - 提取应用名称: app（如需按应用粒度操作）                   │
+│  - 特殊处理: "显示/隐藏应用名称" → 打开/关闭目标              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                              │
+│  - 未明确操作对象时，需根据关键词推断或追问                  │
+│  - 目标为风格且未给styleType时，需追问风格类型              │
+│  - 目标为角标且未给badgeType时，需追问角标类型              │
+│  - 调大/调小未给数值时，按系统默认步长调整                  │
+│  - app仅当用户指明具体应用时填写                            │
+│  - 验证应用名称有效性（如微信、知乎等）                     │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                │
+│  - 组装 actionType, target 及可选参数（styleType, badgeType, │
+│    app, number, numberType）                                 │
+│  - 生成平台特定的命令格式                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "type": "object",
+  "required": ["actionType", "target"],
+  "properties": {
+    "actionType": {
+      "type": "string",
+      "enum": ["打开", "关闭", "设置", "查询", "添加", "调大", "调小", "设值"],
+      "description": "必填参数，操作类型，用于指示对桌面相关功能进行的操作"
+    },
+    "target": {
+      "type": "string",
+      "enum": ["桌面", "风格", "角标", "图标", "快捷方式", "搜索入口", "桌面应用名称", "通透模式", "布局"],
+      "description": "必填参数，操作对象，指明要操作的桌面功能项"
+    },
+    "styleType": {
+      "type": "string",
+      "enum": ["标准", "抽屉"],
+      "description": "桌面风格类型（当 target=风格 或 需设置风格时使用）"
+    },
+    "badgeType": {
+      "type": "string",
+      "enum": ["数字", "圆点"],
+      "description": "角标类型（当 target=角标 且需指定类型时使用）"
+    },
+    "app": {
+      "type": "string",
+      "description": "应用名称（在按应用粒度操作角标或应用名称显示/隐藏时填写，如“微信”、“知乎”）"
+    },
+    "number": {
+      "type": "string",
+      "description": "数值/百分比/分数/极值/布局规格等，例如“10%”“1/3”“最小”“零”“4X5”"
+    },
+    "numberType": {
+      "type": "string",
+      "enum": ["数字", "百分比", "分数", "极值", "布局"],
+      "description": "数值类型，用于解释 number 的取值语义"
+    }
+  }
+}
+```
+
+### 参数注意事项
+1. **同义词/间接表述映射**: "返回桌面/回到主屏/回主界面"→actionType=打开 + target=桌面；"小圆点/红点提醒"统一识别为 badgeType=圆点；"设为/调到/调成/切换到"→actionType=设值；"显示应用名称/隐藏应用名称"→actionType=打开/关闭 且 target=桌面应用名称。
+2. **默认值或缺省行为**: `actionType` 为"调大/调小"且未给 `number` 时，按系统默认步长调整；未指定 `app` 时，默认对系统全局生效（非按单一应用）。
+3. **参数间关联/依赖关系**: 
+   1. 当 `actionType`=`设置/打开/关闭`时，如果`target` =`风格` ，必须配合 `styleType`；如果`target`=`角标` ，必须配合 `badgeType`；涉及通透模式、图标大小、布局设定等数值设置时，`number` 与 `numberType` 必须联动填写。
+   2. `actionType`和`target` 必须组合出现。
+4. **可选参数填写条件**: `app` 仅当用户明确提及具体应用时填写；当 `numberType`=`布局` 时，`number` 应为布局规格（如 `"4X5"`）。
+
+## Query 示例及输出
+
+### 示例 1: 返回桌面
+**用户输入**: "返回桌面"
+
+**工具**: "desktop"
+
+**JSON 参数**:
+```json
+{"actionType":"打开","target":"桌面"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"desktop\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\",\"target\":\"桌面\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"desktop","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开","target":"桌面"}}'
+```
+
+---
+
+### 示例 2: 设置桌面为标准风格
+**用户输入**: "设置桌面标准风格"
+
+**工具**: "desktop"
+
+**JSON 参数**:
+```json
+{"actionType":"设置","target":"风格","styleType":"标准"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"desktop\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"设置\",\"target\":\"风格\",\"styleType\":\"标准\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"desktop","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"设置","target":"风格","styleType":"标准"}}'
+```
+
+---
+
+### 示例 3: 桌面透明度提高10%
+**用户输入**: "桌面透明度提高10%"
+
+**工具**: "desktop"
+
+**JSON 参数**:
+```json
+{"actionType":"调大","target":"通透模式","number":"10%","numberType":"百分比"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"desktop\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"调大\",\"target\":\"通透模式\",\"number\":\"10%\",\"numberType\":\"百分比\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"desktop","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"调大","target":"通透模式","number":"10%","numberType":"百分比"}}'
+```
+
+---
+
+### 示例 4: 切换桌面布局为 4X5
+**用户输入**: "切换桌面到4X5格式。"
+
+**工具**: "desktop"
+
+**JSON 参数**:
+```json
+{"actionType":"设值","target":"布局","number":"4X5","numberType":"布局"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"desktop\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"设值\",\"target\":\"布局\",\"number\":\"4X5\",\"numberType\":\"布局\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"desktop","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"设值","target":"布局","number":"4X5","numberType":"布局"}}'
+```